machine-bridge-mcp 0.8.2 → 0.9.0

package/src/local/runtime.mjs

@@ -14,6 +14,7 @@ import { classifyOperationalError } from "./log.mjs";
 import { ManagedJobManager } from "./managed-jobs.mjs";
 import { generateRegisteredSshKey } from "./resource-operations.mjs";
 import { expandHome } from "./state.mjs";
+import { AgentContextManager } from "./agent-context.mjs";
 
 export const MAX_WRITE_BYTES = 5 * 1024 * 1024;
 const MAX_WS_MESSAGE_BYTES = 8 * 1024 * 1024;
@@ -27,6 +28,11 @@ const SLOW_TOOL_CALL_MS = 30_000;
 const RUNTIME_TOOL_HANDLERS = Object.freeze({
   server_info: (runtime) => runtime.runtimeInfo(),
   project_overview: (runtime, _args, context) => runtime.projectOverview(context),
+  agent_context: (runtime, args, context) => runtime.agentContextManager.agentContext(args, context),
+  list_local_skills: (runtime, args, context) => runtime.agentContextManager.listLocalSkills(args, context),
+  load_local_skill: (runtime, args, context) => runtime.agentContextManager.loadLocalSkill(args, context),
+  list_local_commands: (runtime, args, context) => runtime.agentContextManager.listLocalCommands(args, context),
+  run_local_command: (runtime, args, context) => runtime.runLocalCommand(args, context),
   list_roots: (runtime) => runtime.listRoots(),
   list_dir: (runtime, args, context) => runtime.listDir(args.path || ".", context),
   list_files: (runtime, args, context) => runtime.listFiles(args.path || ".", clampInt(args.max_files, 1000, 1, 10000), context),
@@ -101,6 +107,13 @@ export class LocalRuntime {
       displayPath: (value) => this.displayPath(value),
       throwIfCancelled: (context) => this.throwIfCancelled(context),
     });
+    this.agentContextManager = new AgentContextManager({
+      workspace: this.workspace,
+      policy: this.policy,
+      displayPath: (value) => this.displayPath(value),
+      resolveExistingPath: (value) => this.resolveExistingPath(value),
+      throwIfCancelled: (context) => this.throwIfCancelled(context),
+    });
     this.relay = createRelayConnection(this, {
       workerUrl: remoteWorkerUrl,
       secret: remoteSecret,
@@ -733,6 +746,25 @@ export class LocalRuntime {
     return this.runProcess(argv[0], argv.slice(1), clampInt(args.timeout_seconds, 120, 1, 600) * 1000, false, 512 * 1024, context, cwd);
   }
 
+  async runLocalCommand(args, context = {}) {
+    if (this.policy.execMode !== "direct" && this.policy.execMode !== "shell") throw new Error("run_local_command is disabled by daemon policy");
+    const command = await this.agentContextManager.resolveLocalCommand(args, context);
+    const argv = validateArgv(command.argv);
+    const cwd = await this.resolveExistingPath(command.cwd);
+    if (!(await stat(cwd)).isDirectory()) throw new Error("registered command cwd is not a directory");
+    const requestedTimeout = args.timeout_seconds === undefined
+      ? command.timeoutSeconds
+      : clampInt(args.timeout_seconds, command.timeoutSeconds, 1, 600);
+    const timeoutSeconds = Math.min(requestedTimeout, command.timeoutSeconds);
+    const result = await this.runProcess(argv[0], argv.slice(1), timeoutSeconds * 1000, false, 512 * 1024, context, cwd);
+    return {
+      name: command.name,
+      cwd: this.displayPath(cwd),
+      timeout_seconds: timeoutSeconds,
+      ...result,
+    };
+  }
+
   async execCommand(command, timeoutSeconds, context = {}) {
     if (this.policy.execMode !== "shell") throw new Error("exec_command requires shell execution mode");
     if (!command || typeof command !== "string") throw new Error("command is required");

package/src/shared/server-metadata.json

@@ -8,6 +8,7 @@
   ],
   "instructions": [
     "You are connected to a local workspace through machine-bridge-mcp.",
+    "For substantive workspace tasks, call agent_context for the relevant target path before editing or executing. Apply returned instruction files in precedence order, load only relevant local skills, and prefer registered local commands for repeatable workflows.",
     "Remote mode uses a Cloudflare relay; stdio mode runs on the local machine. File and command operations execute on the user's local runtime, not in the Worker.",
     "Filesystem scope and path display follow the active local policy; the default full profile is unrestricted.",
     "Filename sensitivity is not classified by this server; the MCP host, connector gateway, local OS, or endpoint-security software may enforce additional independent rules.",

package/src/shared/tool-catalog.json

@@ -31,6 +31,178 @@
       "additionalProperties": false
     }
   },
+  {
+    "name": "agent_context",
+    "title": "Load agent context",
+    "description": "Discover Codex-compatible global and root-to-target instruction precedence, progressively disclosed local skills, and registered commands for a target path.",
+    "availability": "always",
+    "annotations": {
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    },
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "path": {
+          "type": "string",
+          "default": ".",
+          "maxLength": 32768
+        },
+        "include_instruction_content": {
+          "type": "boolean",
+          "default": true
+        },
+        "max_skills": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 500,
+          "default": 100
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "list_local_skills",
+    "title": "List local skills",
+    "description": "Search bounded SKILL.md or skill.md bundles from Codex-compatible and explicitly configured skill roots without executing them.",
+    "availability": "always",
+    "annotations": {
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    },
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "path": {
+          "type": "string",
+          "default": ".",
+          "maxLength": 32768
+        },
+        "query": {
+          "type": "string",
+          "default": "",
+          "maxLength": 1000
+        },
+        "max_results": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 500,
+          "default": 100
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "load_local_skill",
+    "title": "Load local skill",
+    "description": "Load one discovered local skill entrypoint and a bounded relative file inventory. Loading returns instructions and never executes skill files implicitly.",
+    "availability": "always",
+    "annotations": {
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    },
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "skill": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 32768
+        },
+        "path": {
+          "type": "string",
+          "default": ".",
+          "maxLength": 32768
+        },
+        "max_files": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 500,
+          "default": 200
+        }
+      },
+      "required": [
+        "skill"
+      ],
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "list_local_commands",
+    "title": "List registered local commands",
+    "description": "List commands registered by hierarchical .machine-bridge/agent.json manifests for the selected target path.",
+    "availability": "always",
+    "annotations": {
+      "readOnlyHint": true,
+      "destructiveHint": false,
+      "idempotentHint": true,
+      "openWorldHint": false
+    },
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "path": {
+          "type": "string",
+          "default": ".",
+          "maxLength": 32768
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  {
+    "name": "run_local_command",
+    "title": "Run registered local command",
+    "description": "Execute a named command registered in .machine-bridge/agent.json as a direct argv process without shell parsing. Manifest timeout and argument policy remain authoritative.",
+    "availability": "direct-exec",
+    "annotations": {
+      "readOnlyHint": false,
+      "destructiveHint": true,
+      "idempotentHint": false,
+      "openWorldHint": true
+    },
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 64
+        },
+        "path": {
+          "type": "string",
+          "default": ".",
+          "maxLength": 32768
+        },
+        "args": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "maxLength": 65536
+          },
+          "maxItems": 64,
+          "default": []
+        },
+        "timeout_seconds": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 600
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "additionalProperties": false
+    }
+  },
   {
     "name": "list_roots",
     "title": "List workspace roots",

package/src/worker/index.ts

@@ -3,7 +3,7 @@ import toolCatalog from "../shared/tool-catalog.json";
 import serverMetadata from "../shared/server-metadata.json";
 
 const SERVER_NAME = String(serverMetadata.name);
-const SERVER_VERSION = "0.8.2";
+const SERVER_VERSION = "0.9.0";
 const MCP_PROTOCOL_VERSION = String(serverMetadata.protocolVersion);
 const MCP_SUPPORTED_PROTOCOL_VERSIONS = serverMetadata.supportedProtocolVersions.map((value) => String(value));
 const JSONRPC_VERSION = "2.0";