dsh-zcode-bridge
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| zcode_doctorA | Run read-only checks for Bridge prerequisites, ZCode runtime/provider configuration, execution mode, task storage, and Desktop task-index availability. It does not start a ZCode session. App-server model availability and real permission approval are reported as unverified until a task runs. |
| zcode_model_catalogA | Read models and reasoning levels for this workspace. The Bridge caches the catalog for 24 hours, refreshes when provider settings change or the cache expires, and re-reads provider config before retrying a failed refresh. A cache response has current_model=null; use provider_id/model_id from models in zcode_task.model. |
| zcode_default_modelA | Read the provider, model, and optional reasoning level used when zcode_task has no model override. |
| zcode_set_default_modelA | Persist a default provider/model selection for future tasks that omit zcode_task.model. Use IDs from zcode_model_catalog or the configured ZCode provider/model rules; the app-server validates the selection when a task starts. An optional reasoning_level applies to the configured default model; a per-task model selection can still override it. |
| zcode_clear_default_modelA | Remove the Bridge default model so future tasks without zcode_task.model use the ZCode session default. |
| zcode_taskA | Create a bounded coding task for the local ZCode subordinate agent. workspace is the master agent project root and determines the ZCode Desktop project identity. The master agent decides whether to create a worktree; if it does, pass its existing absolute directory as optional worktree_path. The Bridge never creates, selects, or removes a worktree. Without worktree_path, ZCode runs directly in workspace. Optional model selects a ZCode provider_id/model_id for this session without changing the project default. Returns a TaskReceipt; the task runs asynchronously in a detached worker. Results describe Bridge/ZCode execution only: status 'completed' means the invocation and report normalization finished, NOT that the master agent accepted the work. The master agent must independently review the workspace diff and checks before deciding PASS. |
| zcode_statusA | Read the execution status record for one task. This is execution status only and never contains a PASS/FAIL code-review judgment. Results describe Bridge/ZCode execution only: status 'completed' means the invocation and report normalization finished, NOT that the master agent accepted the work. The master agent must independently review the workspace diff and checks before deciding PASS. |
| zcode_eventsA | Read persisted progress events for a task. Set view to summary to merge adjacent model text chunks; raw is the default. next_seq advances across all scanned events, including merged chunks. Immediately after submission, report the project path, effective execution path (and worktree path when supplied), and queued/running state from the first events. Keep polling until turn_started or startup failure; before longer monitoring, report the ZCode session, runtime-reported selected model, runtime-reported reasoning level when present, and execution mode. Set after_seq to the last next_seq returned and wait_ms up to 25000. Hidden reasoning is excluded. interaction_requested events include bounded tool/request details needed for a deliberate permission or input decision. |
| zcode_interaction_replyA | Reply to a pending ZCode permission or user-input request surfaced by zcode_events. For permission requests, use allow only when the user explicitly authorized the requested action; otherwise deny or ask the user. Do not infer permission from task instructions, worktree use, or ZCode mode. For user-input requests, answer only from known facts or the user's explicit direction. This tool does not approve the task result. |
| zcode_resultA | Read the persisted TaskResult for a finished task. Returns TASK_NOT_FINISHED before a terminal state. 'completed' is not a master-accepted PASS: files_changed, tests, and decisions are normalized claims from the subordinate report and must be verified independently. Results describe Bridge/ZCode execution only: status 'completed' means the invocation and report normalization finished, NOT that the master agent accepted the work. The master agent must independently review the workspace diff and checks before deciding PASS. |
| zcode_continueA | Continue a finished task with master feedback: reuses the task ID and workspace, increments the attempt, and preserves prior evidence. Allowed from completed, failed, or waiting_for_master. A decision flagged by ZCode is never auto-approved; the master agent must provide the follow-up instruction. Results describe Bridge/ZCode execution only: status 'completed' means the invocation and report normalization finished, NOT that the master agent accepted the work. The master agent must independently review the workspace diff and checks before deciding PASS. |
| zcode_cancelA | Cancel a queued or running task. Running cancellation returns only after the worker process tree termination is confirmed. Results describe Bridge/ZCode execution only: status 'completed' means the invocation and report normalization finished, NOT that the master agent accepted the work. The master agent must independently review the workspace diff and checks before deciding PASS. |
| zcode_progress_probeA | Temporary read-only experiment. Sends three MCP progress notifications over three seconds to test whether the host displays server progress while this tool runs. Does not start or modify a ZCode task. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 13 tools
Each tool targets a distinct bridge concern: task lifecycle, model defaults, diagnostics/catalog, and permission/input replies. zcode_status, zcode_events, and zcode_result are separated by execution status, progress stream, and final normalized result, so misselection is unlikely.
All names use the same zcode_ snake_case prefix with predictable noun/verb phrases. Even where verbs are implicit, such as zcode_default_model or zcode_task, the convention is internally consistent.
Thirteen tools fit the bridge scope: a full task lifecycle, model configuration, diagnostics, and interaction handling. The temporary progress probe is extra but not excessive.
Core lifecycle and configuration are covered, including create, monitor, continue, cancel, result, and permission replies. Minor gaps exist for task enumeration/history and explicit artifact/diff retrieval, though the latter is intentionally left to the master agent.