@byok-sdk/client 0.2.0 → 0.3.0

package/dist/types.d.ts

@@ -19,6 +19,12 @@ export interface RuntimeDetectResult {
 export interface RuntimeCapabilities {
     steer: boolean;
     resume: boolean;
+    /**
+     * Whether this adapter can project task-scoped, locally configured MCP
+     * servers into the runtime without accepting executable definitions from
+     * the remote task. Omission is fail-closed and means unsupported.
+     */
+    mcpToolsets?: boolean;
     /**
      * Whether this adapter can genuinely pause a running session on
      * `needs_approval` and resume it from an out-of-band decision — i.e.
@@ -36,6 +42,15 @@ export interface RuntimeCapabilities {
     /** Subset of {@link PermissionPolicy}'s `mode` values this adapter can express without widening. */
     permissionModes: string[];
 }
+/** One local stdio MCP server definition. Remote task payloads can never supply this shape. */
+export interface McpStdioServerConfig {
+    command: string;
+    args?: readonly string[];
+}
+/** A logical group of local MCP servers selectable by a wire-level toolset id. */
+export interface McpToolsetConfig {
+    mcpServers: Readonly<Record<string, McpStdioServerConfig>>;
+}
 /**
  * M4 Phase 3: the out-of-band approval channel `TaskRunner` (`daemon/
  * task-runner.ts`) hands to an adapter's `start()` via `TaskContext
@@ -80,6 +95,12 @@ export interface TaskContext {
     workspaceDir: string;
     policy: PermissionPolicy;
     env: NodeJS.ProcessEnv;
+    /**
+     * MCP servers resolved from this device's local registry for this task.
+     * The wire carries only logical toolset ids; command/args never originate
+     * from the SaaS task and are never copied into the task instruction.
+     */
+    mcpServers?: Readonly<Record<string, McpStdioServerConfig>>;
     /** Prepared local checkpoint repository metadata; absent for legacy plain workspaces. */
     gitWorkspace?: {
         workspaceId: string;
@@ -136,6 +157,14 @@ export interface Session {
  */
 export interface RuntimeAdapter {
     id: string;
+    /**
+     * Explicit opt-in to the authoritative `task.offer.dispatchSelection`
+     * contract. A custom adapter using a built-in runtime id must set this only
+     * when it validates and pins the exact lane/provider/model semantics; the
+     * daemon will otherwise withhold the connection-level capability so a
+     * server rejects the offer before sending it.
+     */
+    readonly supportsDispatchSelection?: true;
     detect(): Promise<RuntimeDetectResult>;
     capabilities(): RuntimeCapabilities;
     start(task: TaskOfferPayload, ctx: TaskContext): Promise<Session>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byok-sdk/client",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "BYOK SDK client daemon: runs on the end user's machine, pairs with a SaaS server, and drives a local coding-agent runtime",
   "type": "module",
   "license": "MIT",
@@ -46,13 +46,13 @@
   "dependencies": {
     "@earendil-works/pi-coding-agent": "0.84.1",
     "ws": "^8.21.1",
-    "@byok-sdk/core": "0.2.0",
-    "@byok-sdk/protocol": "0.2.0"
+    "@byok-sdk/core": "0.3.0",
+    "@byok-sdk/protocol": "0.3.0"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1",
     "@hono/node-server": "^2.0.10",
-    "@byok-sdk/server": "0.2.0"
+    "@byok-sdk/server": "0.3.0"
   },
   "scripts": {
     "build": "tsup && tsc -p tsconfig.build.json && node scripts/check-adapters-entry.mjs",