subharness 0.0.4 → 0.0.7

package/dist/sdk/connected.js

@@ -0,0 +1,232 @@
+import { AgentError } from '../errors.js';
+import { connect as connectCoordinator } from '../runtime/client.js';
+import { resolveStateDirectory } from '../runtime/state.js';
+import { CoordinatorTransport } from '../runtime/transport.js';
+import { delivery, observeOptions, validateCwd, validatePrompt, watchOptions } from './execution-options.js';
+export async function connect(options) {
+    const selected = connectOptions(options);
+    const directory = resolveStateDirectory(selected.stateDirectory);
+    const endpoint = await connectCoordinator(selected.start ?? true, { directory, capability: 'sdk-v1' });
+    return new ConnectedClient(new CoordinatorTransport(endpoint), directory);
+}
+class ConnectedClient {
+    transport;
+    directory;
+    open = true;
+    agents = {
+        list: async (options) => {
+            this.assertOpen();
+            exact(options, ['cwd'], 'Agent list options');
+            const selectedEnv = selectedEnvironment(undefined, this.directory);
+            const selectedCwd = options.cwd;
+            const cwd = await validateCwd(selectedCwd);
+            this.assertOpen();
+            return this.transport.one({ command: 'sdk-agent-list', cwd, env: selectedEnv });
+        },
+        check: async (options) => {
+            this.assertOpen();
+            const selected = await connectedOptions(options, this.directory);
+            this.assertOpen();
+            await this.transport.one({ command: 'sdk-agent-check', ...selected });
+        },
+    };
+    sessions = {
+        create: async (options) => {
+            this.assertOpen();
+            const selected = await connectedOptions(options, this.directory);
+            this.assertOpen();
+            const response = await this.transport.one({ command: 'sdk-session-create', ...selected });
+            return new ConnectedSession(this, response.sessionId);
+        },
+        list: async (options) => {
+            this.assertOpen();
+            const selected = pageOptions(options);
+            return this.transport.one({ command: 'sdk-session-list', ...selected });
+        },
+        get: async (id) => {
+            this.assertOpen();
+            const selected = idValue(id, 'Session ID');
+            await this.transport.one({ command: 'sdk-session-get', id: selected });
+            return new ConnectedSession(this, selected);
+        },
+    };
+    tasks = {
+        list: async (options) => {
+            this.assertOpen();
+            const selected = taskPageOptions(options);
+            return this.transport.one({ command: 'sdk-task-list', ...selected });
+        },
+        get: async (id) => {
+            this.assertOpen();
+            const selected = idValue(id, 'Task ID');
+            const snapshot = await this.transport.one({ command: 'sdk-task-get', id: selected });
+            return new ConnectedTask(this, selected, snapshot.sessionId);
+        },
+    };
+    approvals = { respond: async (requestId, response) => {
+            this.assertOpen();
+            await this.transport.one({ command: 'sdk-approval-respond', id: idValue(requestId, 'Approval ID'), response });
+        } };
+    constructor(transport, directory) {
+        this.transport = transport;
+        this.directory = directory;
+    }
+    async disconnect() { if (!this.open)
+        return; this.open = false; this.transport.disconnect(); }
+    assertOpen() {
+        if (!this.open)
+            throw new AgentError('COORDINATOR_UNAVAILABLE', 'The coordinator client is disconnected.');
+    }
+}
+class ConnectedSession {
+    client;
+    id;
+    constructor(client, id) {
+        this.client = client;
+        this.id = id;
+    }
+    async prompt(text, options) {
+        this.client.assertOpen();
+        validatePrompt(text);
+        const requestedDelivery = delivery(options);
+        const receipt = await this.client.transport.one({
+            command: 'sdk-session-prompt', id: this.id, prompt: text, delivery: requestedDelivery,
+        });
+        return { task: new ConnectedTask(this.client, receipt.taskId, receipt.sessionId), requestedDelivery,
+            effectiveDelivery: receipt.delivery ?? requestedDelivery,
+            ...(receipt.paused ? { paused: true, blockedByTaskId: receipt.blockedByTaskId } : {}) };
+    }
+    async snapshot() {
+        this.client.assertOpen();
+        return this.client.transport.one({ command: 'sdk-session-get', id: this.id });
+    }
+    async close() {
+        this.client.assertOpen();
+        await this.client.transport.one({ command: 'sdk-session-close', id: this.id });
+    }
+}
+class ConnectedTask {
+    client;
+    id;
+    sessionId;
+    resultPromise;
+    constructor(client, id, sessionId) {
+        this.client = client;
+        this.id = id;
+        this.sessionId = sessionId;
+    }
+    get result() {
+        if (!this.resultPromise) {
+            try {
+                this.client.assertOpen();
+                this.resultPromise = this.client.transport.one({ command: 'sdk-task-result', id: this.id });
+            }
+            catch (error) {
+                this.resultPromise = Promise.reject(error);
+            }
+            void this.resultPromise.catch(() => undefined);
+        }
+        return this.resultPromise;
+    }
+    async snapshot() {
+        this.client.assertOpen();
+        return this.client.transport.one({ command: 'sdk-task-snapshot', id: this.id });
+    }
+    async inspect() {
+        this.client.assertOpen();
+        return this.client.transport.one({ command: 'sdk-task-inspect', id: this.id });
+    }
+    watch(options) {
+        this.client.assertOpen();
+        const selected = watchOptions(options);
+        return this.client.transport.stream({ command: 'sdk-task-watch', id: this.id }, selected.signal);
+    }
+    responses(options) {
+        this.client.assertOpen();
+        const selected = observeOptions(options);
+        return this.client.transport.stream({ command: 'sdk-task-responses', id: this.id, ...(selected.after === undefined ? {} : { after: selected.after }) }, selected.signal);
+    }
+    async cancel() {
+        this.client.assertOpen();
+        return this.client.transport.one({ command: 'sdk-task-cancel', id: this.id });
+    }
+}
+function connectOptions(value) {
+    if (value === undefined)
+        return {};
+    exact(value, ['start', 'stateDirectory'], 'Connect options');
+    if (value.start !== undefined && typeof value.start !== 'boolean')
+        invalid('Connect start must be a boolean.');
+    if (value.stateDirectory !== undefined && typeof value.stateDirectory !== 'string')
+        invalid('Connect state directory must be a string.');
+    return value;
+}
+async function connectedOptions(value, directory) {
+    exact(value, ['agent', 'cwd', 'env'], 'Connected session options');
+    const agent = cloneAgent(value.agent);
+    const selectedCwd = value.cwd;
+    const env = selectedEnvironment(value.env, directory);
+    const cwd = await validateCwd(selectedCwd);
+    return { agent, cwd, env };
+}
+function cloneAgent(value) {
+    if (typeof value === 'string')
+        return value;
+    if (!value || typeof value !== 'object')
+        invalid('Connected agent must be an ID or harness configuration.');
+    try {
+        return structuredClone(value);
+    }
+    catch {
+        return invalid('Connected harness configuration must contain serializable values.');
+    }
+}
+function selectedEnvironment(source, directory) {
+    const selected = source ?? process.env;
+    if (!selected || typeof selected !== 'object' || Array.isArray(selected))
+        invalid('Connected environment must be an object.');
+    // Callers may intentionally replace the environment without NODE_ENV even when frameworks augment ProcessEnv.
+    const env = {};
+    for (const key of Reflect.ownKeys(selected)) {
+        if (typeof key !== 'string')
+            invalid('Connected environment keys must be strings.');
+        const value = selected[key];
+        if (value !== undefined && typeof value !== 'string')
+            invalid('Connected environment values must be strings or undefined.');
+        if (value !== undefined)
+            env[key] = value;
+    }
+    delete env.AGENT_PARENT_TOKEN;
+    delete env.AGENT_CLI_PATH;
+    env.AGENT_STATE_DIR = directory;
+    return env;
+}
+function pageOptions(value) {
+    if (value === undefined)
+        return {};
+    exact(value, ['limit', 'cursor'], 'Page options');
+    if (value.limit !== undefined && (!Number.isSafeInteger(value.limit) || value.limit <= 0))
+        invalid('Page limit must be a positive integer.');
+    if (value.cursor !== undefined && typeof value.cursor !== 'string')
+        invalid('Page cursor must be a string.');
+    return value;
+}
+function taskPageOptions(value) {
+    if (value === undefined)
+        return {};
+    exact(value, ['limit', 'cursor', 'sessionId'], 'Task page options');
+    const page = pageOptions({ ...(value.limit === undefined ? {} : { limit: value.limit }), ...(value.cursor === undefined ? {} : { cursor: value.cursor }) });
+    return { ...page, ...(value.sessionId === undefined ? {} : { sessionId: idValue(value.sessionId, 'Session ID') }) };
+}
+function exact(value, fields, label) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)
+        || Reflect.ownKeys(value).some(key => typeof key !== 'string' || !fields.includes(key)))
+        invalid(`${label} must contain only supported fields.`);
+}
+function idValue(value, label) {
+    if (typeof value !== 'string' || !value)
+        invalid(`${label} must be a nonempty string.`);
+    return value;
+}
+function invalid(message) { throw new AgentError('INVALID_ARGUMENT', message); }
+//# sourceMappingURL=connected.js.map

package/dist/sdk/connected.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connected.js","sourceRoot":"","sources":["../../src/sdk/connected.ts"],"names":[],"mappings":"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","sourcesContent":["import { AgentError } from '../errors.js';\nimport { connect as connectCoordinator } from '../runtime/client.js';\nimport { resolveStateDirectory } from '../runtime/state.js';\nimport { CoordinatorTransport } from '../runtime/transport.js';\nimport { delivery, observeOptions, validateCwd, validatePrompt, watchOptions } from './execution-options.js';\nimport type {\n  ApprovalResponse, Delivery, Page, PageOptions, PromptReceipt, SessionHandle, SessionSnapshot,\n  TaskDetails, TaskHandle, TaskResult, TaskSnapshot,\n} from './execution-types.js';\nimport type { AgentSummary, Client, ConnectedSessionOptions, ConnectOptions } from './connected-types.js';\n\nexport async function connect(options?:ConnectOptions):Promise<Client> {\n  const selected=connectOptions(options);\n  const directory=resolveStateDirectory(selected.stateDirectory);\n  const endpoint=await connectCoordinator(selected.start ?? true,{directory,capability:'sdk-v1'});\n  return new ConnectedClient(new CoordinatorTransport(endpoint),directory);\n}\n\nclass ConnectedClient implements Client {\n  private open=true;\n  readonly agents={\n    list:async(options:{readonly cwd:string}):Promise<{readonly items:readonly AgentSummary[]}>=>{\n      this.assertOpen(); exact(options,['cwd'],'Agent list options');\n      const selectedEnv=selectedEnvironment(undefined,this.directory);\n      const selectedCwd=options.cwd;\n      const cwd=await validateCwd(selectedCwd);\n      this.assertOpen();\n      return this.transport.one({command:'sdk-agent-list',cwd,env:selectedEnv});\n    },\n    check:async(options:ConnectedSessionOptions):Promise<void>=>{\n      this.assertOpen(); const selected=await connectedOptions(options,this.directory);\n      this.assertOpen();\n      await this.transport.one({command:'sdk-agent-check',...selected});\n    },\n  };\n  readonly sessions={\n    create:async(options:ConnectedSessionOptions):Promise<SessionHandle>=>{\n      this.assertOpen(); const selected=await connectedOptions(options,this.directory); this.assertOpen();\n      const response=await this.transport.one<{sessionId:string}>({command:'sdk-session-create',...selected});\n      return new ConnectedSession(this,response.sessionId);\n    },\n    list:async(options?:PageOptions)=>{\n      this.assertOpen(); const selected=pageOptions(options);\n      return this.transport.one<Page<import('./execution-types.js').SessionSummary>>({command:'sdk-session-list',...selected});\n    },\n    get:async(id:string):Promise<SessionHandle>=>{\n      this.assertOpen(); const selected=idValue(id,'Session ID');\n      await this.transport.one<SessionSnapshot>({command:'sdk-session-get',id:selected});\n      return new ConnectedSession(this,selected);\n    },\n  };\n  readonly tasks={\n    list:async(options?:PageOptions&{readonly sessionId?:string})=>{\n      this.assertOpen(); const selected=taskPageOptions(options);\n      return this.transport.one<Page<import('./execution-types.js').TaskSummary>>({command:'sdk-task-list',...selected});\n    },\n    get:async(id:string):Promise<TaskHandle>=>{\n      this.assertOpen(); const selected=idValue(id,'Task ID');\n      const snapshot=await this.transport.one<TaskSnapshot>({command:'sdk-task-get',id:selected});\n      return new ConnectedTask(this,selected,snapshot.sessionId);\n    },\n  };\n  readonly approvals={respond:async(requestId:string,response:ApprovalResponse):Promise<void>=>{\n    this.assertOpen();\n    await this.transport.one({command:'sdk-approval-respond',id:idValue(requestId,'Approval ID'),response});\n  }};\n  constructor(readonly transport:CoordinatorTransport,private readonly directory:string) {}\n  async disconnect():Promise<void> { if (!this.open) return; this.open=false; this.transport.disconnect(); }\n  assertOpen():void {\n    if (!this.open) throw new AgentError('COORDINATOR_UNAVAILABLE','The coordinator client is disconnected.');\n  }\n}\n\nclass ConnectedSession implements SessionHandle {\n  constructor(private readonly client:ConnectedClient,readonly id:string) {}\n  async prompt(text:string,options?:{readonly delivery?:Delivery}):Promise<PromptReceipt> {\n    this.client.assertOpen(); validatePrompt(text); const requestedDelivery=delivery(options);\n    const receipt=await this.client.transport.one<{taskId:string;sessionId:string;delivery?:Delivery;paused?:true;blockedByTaskId?:string}>({\n      command:'sdk-session-prompt',id:this.id,prompt:text,delivery:requestedDelivery,\n    });\n    return {task:new ConnectedTask(this.client,receipt.taskId,receipt.sessionId),requestedDelivery,\n      effectiveDelivery:receipt.delivery ?? requestedDelivery,\n      ...(receipt.paused ? {paused:true as const,blockedByTaskId:receipt.blockedByTaskId!} : {})};\n  }\n  async snapshot():Promise<SessionSnapshot> {\n    this.client.assertOpen(); return this.client.transport.one({command:'sdk-session-get',id:this.id});\n  }\n  async close():Promise<void> {\n    this.client.assertOpen(); await this.client.transport.one({command:'sdk-session-close',id:this.id});\n  }\n}\n\nclass ConnectedTask implements TaskHandle {\n  private resultPromise?:Promise<TaskResult>;\n  constructor(private readonly client:ConnectedClient,readonly id:string,readonly sessionId:string) {}\n  get result():Promise<TaskResult> {\n    if (!this.resultPromise) {\n      try {\n        this.client.assertOpen();\n        this.resultPromise=this.client.transport.one({command:'sdk-task-result',id:this.id});\n      } catch (error) { this.resultPromise=Promise.reject(error); }\n      void this.resultPromise.catch(()=>undefined);\n    }\n    return this.resultPromise;\n  }\n  async snapshot():Promise<TaskSnapshot> {\n    this.client.assertOpen(); return this.client.transport.one({command:'sdk-task-snapshot',id:this.id});\n  }\n  async inspect():Promise<TaskDetails> {\n    this.client.assertOpen(); return this.client.transport.one({command:'sdk-task-inspect',id:this.id});\n  }\n  watch(options?:{readonly signal?:AbortSignal}):AsyncIterable<TaskSnapshot> {\n    this.client.assertOpen(); const selected=watchOptions(options);\n    return this.client.transport.stream({command:'sdk-task-watch',id:this.id},selected.signal);\n  }\n  responses(options?:{readonly after?:string;readonly signal?:AbortSignal}) {\n    this.client.assertOpen(); const selected=observeOptions(options);\n    return this.client.transport.stream<import('./execution-types.js').CompleteResponse>(\n      {command:'sdk-task-responses',id:this.id,...(selected.after === undefined ? {} : {after:selected.after})},selected.signal);\n  }\n  async cancel():Promise<TaskSnapshot> {\n    this.client.assertOpen(); return this.client.transport.one({command:'sdk-task-cancel',id:this.id});\n  }\n}\n\nfunction connectOptions(value:ConnectOptions|undefined):ConnectOptions {\n  if (value === undefined) return {};\n  exact(value,['start','stateDirectory'],'Connect options');\n  if (value.start !== undefined && typeof value.start !== 'boolean') invalid('Connect start must be a boolean.');\n  if (value.stateDirectory !== undefined && typeof value.stateDirectory !== 'string') invalid('Connect state directory must be a string.');\n  return value;\n}\nasync function connectedOptions(value:ConnectedSessionOptions,directory:string) {\n  exact(value,['agent','cwd','env'],'Connected session options');\n  const agent=cloneAgent(value.agent);\n  const selectedCwd=value.cwd;\n  const env=selectedEnvironment(value.env,directory);\n  const cwd=await validateCwd(selectedCwd);\n  return {agent,cwd,env};\n}\nfunction cloneAgent(value:ConnectedSessionOptions['agent']):ConnectedSessionOptions['agent'] {\n  if (typeof value === 'string') return value;\n  if (!value || typeof value !== 'object') invalid('Connected agent must be an ID or harness configuration.');\n  try { return structuredClone(value); }\n  catch { return invalid('Connected harness configuration must contain serializable values.'); }\n}\nfunction selectedEnvironment(source:Readonly<Record<string,string|undefined>>|undefined,directory:string):NodeJS.ProcessEnv {\n  const selected=source ?? process.env;\n  if (!selected || typeof selected !== 'object' || Array.isArray(selected)) invalid('Connected environment must be an object.');\n  // Callers may intentionally replace the environment without NODE_ENV even when frameworks augment ProcessEnv.\n  const env={} as NodeJS.ProcessEnv;\n  for (const key of Reflect.ownKeys(selected)) {\n    if (typeof key !== 'string') invalid('Connected environment keys must be strings.');\n    const value=selected[key];\n    if (value !== undefined && typeof value !== 'string') invalid('Connected environment values must be strings or undefined.');\n    if (value !== undefined) env[key]=value;\n  }\n  delete env.AGENT_PARENT_TOKEN; delete env.AGENT_CLI_PATH;\n  env.AGENT_STATE_DIR=directory;\n  return env;\n}\nfunction pageOptions(value:PageOptions|undefined):PageOptions {\n  if (value === undefined) return {};\n  exact(value,['limit','cursor'],'Page options');\n  if (value.limit !== undefined && (!Number.isSafeInteger(value.limit) || value.limit <= 0)) invalid('Page limit must be a positive integer.');\n  if (value.cursor !== undefined && typeof value.cursor !== 'string') invalid('Page cursor must be a string.');\n  return value;\n}\nfunction taskPageOptions(value:(PageOptions&{readonly sessionId?:string})|undefined) {\n  if (value === undefined) return {};\n  exact(value,['limit','cursor','sessionId'],'Task page options');\n  const page=pageOptions({...(value.limit === undefined ? {} : {limit:value.limit}),...(value.cursor === undefined ? {} : {cursor:value.cursor})});\n  return {...page,...(value.sessionId === undefined ? {} : {sessionId:idValue(value.sessionId,'Session ID')})};\n}\nfunction exact(value:unknown,fields:readonly string[],label:string):asserts value is Record<string,any> {\n  if (!value || typeof value !== 'object' || Array.isArray(value)\n    || Reflect.ownKeys(value).some(key=>typeof key !== 'string' || !fields.includes(key))) invalid(`${label} must contain only supported fields.`);\n}\nfunction idValue(value:unknown,label:string):string {\n  if (typeof value !== 'string' || !value) invalid(`${label} must be a nonempty string.`); return value;\n}\nfunction invalid(message:string):never { throw new AgentError('INVALID_ARGUMENT',message); }\n\nexport type { AgentSummary, Client, ConnectedSessionOptions, ConnectOptions } from './connected-types.js';\n"]}

package/dist/sdk/definitions.d.ts

@@ -1,6 +1,9 @@
-import type { AgentDefinition, ClaudeCodeConfig, ClaudeCodeOptions, CodexConfig, CodexOptions, FxConfig, FxOptions } from "./types.js";
+import type { AgentDefinition, ClaudeCodeConfig, ClaudeCodeOptions, CodexConfig, CodexOptions, FxConfig, FxOptions, OpencodeConfig, OpencodeOptions, CopilotConfig, CopilotOptions, CursorConfig, CursorOptions } from "./types.js";
 export declare function codex(options: CodexOptions): CodexConfig;
 export declare function claudeCode(options: ClaudeCodeOptions): ClaudeCodeConfig;
 export declare function fx(options: FxOptions): FxConfig;
+export declare function opencode(options: OpencodeOptions): OpencodeConfig;
+export declare function copilot(options: CopilotOptions): CopilotConfig;
+export declare function cursor(options: CursorOptions): CursorConfig;
 export declare function agent(definition: AgentDefinition): AgentDefinition;
 export declare function validateAgent(value: unknown, ancestors?: Set<unknown>): asserts value is AgentDefinition;

package/dist/sdk/definitions.js

@@ -4,10 +4,12 @@ import { validateTool } from "./tools.js";
 function validateHarness(value, configured = false, expectedKind) {
     object(value);
     const candidate = configured ? value.kind : expectedKind;
-    if (candidate !== "codex" && candidate !== "claudeCode" && candidate !== "fx")
+    if (!["codex", "claudeCode", "fx", "opencode", "copilot", "cursor"].includes(candidate))
         invalid("Unsupported harness kind.");
     const kind = candidate;
-    const fields = ["model", "effort"];
+    const fields = ["model"];
+    if (kind === "codex" || kind === "claudeCode" || kind === "fx")
+        fields.push("effort");
     if (kind === "codex" || kind === "claudeCode")
         fields.push("fast");
     fields.push(...permissionOptionFields(kind));
@@ -45,6 +47,18 @@ export function fx(options) {
     validateHarness(options, false, "fx");
     return Object.freeze({ ...options, kind: "fx" });
 }
+export function opencode(options) {
+    validateHarness(options, false, "opencode");
+    return Object.freeze({ ...options, kind: "opencode" });
+}
+export function copilot(options) {
+    validateHarness(options, false, "copilot");
+    return Object.freeze({ ...options, kind: "copilot" });
+}
+export function cursor(options) {
+    validateHarness(options, false, "cursor");
+    return Object.freeze({ ...options, kind: "cursor" });
+}
 export function agent(definition) {
     validateAgent(definition);
     return Object.freeze({

package/dist/sdk/definitions.js.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/sdk/definitions.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,SAAS,eAAe,CAAC,KAAc,EAAE,UAAU,GAAG,KAAK,EAAE,YAAoC;IAC/F,MAAM,CAAC,KAAK,CAAC,CAAC;IACd,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC;IACzD,IAAI,SAAS,KAAK,OAAO,IAAI,SAAS,KAAK,YAAY,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACpH,MAAM,IAAI,GAA0B,SAAS,CAAC;IAC9C,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACnC,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,YAAY;QAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnE,MAAM,CAAC,IAAI,CAAC,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACzD,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;QAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjE,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACpG,IAAI,UAAU,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;QAAE,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAClF,0BAA0B,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAe;IAC3C,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAgB,CAAC,EAAE,CAAC;QAClG,OAAO,CAAC,yDAAyD,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,OAAqB;IACzC,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACzC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAA0B;IACnD,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;IAC9C,oBAAoB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,OAAO;QACV,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3F,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpG,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK;KAC5B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,EAAE,CAAC,OAAkB;IACnC,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,UAA2B;IAC/C,aAAa,CAAC,UAAU,CAAC,CAAC;IAC1B,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,UAAU;QACb,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjG,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,UAAU,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,UAAU,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3F,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,SAAS,GAAG,IAAI,GAAG,EAAW;IAC1E,MAAM,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;IACxF,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,2DAA2D,CAAC,CAAC;IAC/F,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjF,IAAI,CAAC,SAAS,CAAC,MAAM;QAAE,OAAO,CAAC,mCAAmC,CAAC,CAAC;IACpE,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAC/D,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACxB,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5D,SAAS,CAAC,IAAI,CAAC,CAAC;YAChB,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["import type {\n  AgentDefinition,\n  ClaudeCodeConfig,\n  ClaudeCodeOptions,\n  CodexConfig,\n  CodexOptions,\n  FxConfig,\n  FxOptions,\n  HarnessConfig,\n} from \"./types.js\";\nimport { invalid, nonempty, object, validName } from \"./validation.js\";\nimport { permissionOptionFields, validateHarnessPermissions } from \"./permission-validation.js\";\nimport { validateTool } from \"./tools.js\";\n\nfunction validateHarness(value: unknown, configured = false, expectedKind?: HarnessConfig[\"kind\"]): void {\n  object(value);\n  const candidate = configured ? value.kind : expectedKind;\n  if (candidate !== \"codex\" && candidate !== \"claudeCode\" && candidate !== \"fx\") invalid(\"Unsupported harness kind.\");\n  const kind: HarnessConfig[\"kind\"] = candidate;\n  const fields = [\"model\", \"effort\"];\n  if (kind === \"codex\" || kind === \"claudeCode\") fields.push(\"fast\");\n  fields.push(...permissionOptionFields(kind));\n  object(value, configured ? [\"kind\", ...fields] : fields);\n  nonempty(value.model, \"Model\");\n  if (value.effort !== undefined) nonempty(value.effort, \"Effort\");\n  if (value.fast !== undefined && typeof value.fast !== \"boolean\") invalid(\"fast must be a boolean.\");\n  if (configured && value.kind === \"claudeCode\") validateClaudeEffort(value.effort);\n  validateHarnessPermissions(kind, value);\n}\n\nfunction validateClaudeEffort(effort: unknown): void {\n  if (effort !== undefined && ![\"low\", \"medium\", \"high\", \"xhigh\", \"max\"].includes(effort as string)) {\n    invalid(\"Claude effort must be low, medium, high, xhigh, or max.\");\n  }\n}\n\nexport function codex(options: CodexOptions): CodexConfig {\n  validateHarness(options, false, \"codex\");\n  return Object.freeze({ ...options, kind: \"codex\", fast: options.fast ?? false });\n}\n\nexport function claudeCode(options: ClaudeCodeOptions): ClaudeCodeConfig {\n  validateHarness(options, false, \"claudeCode\");\n  validateClaudeEffort(options.effort);\n  return Object.freeze({\n    ...options,\n    ...(options.allowedTools ? { allowedTools: Object.freeze([...options.allowedTools]) } : {}),\n    ...(options.disallowedTools ? { disallowedTools: Object.freeze([...options.disallowedTools]) } : {}),\n    kind: \"claudeCode\",\n    fast: options.fast ?? false,\n  });\n}\n\nexport function fx(options: FxOptions): FxConfig {\n  validateHarness(options, false, \"fx\");\n  return Object.freeze({ ...options, kind: \"fx\" });\n}\n\nexport function agent(definition: AgentDefinition): AgentDefinition {\n  validateAgent(definition);\n  return Object.freeze({\n    ...definition,\n    ...(Array.isArray(definition.harness) ? { harness: Object.freeze([...definition.harness]) } : {}),\n    ...(definition.tools ? { tools: Object.freeze({ ...definition.tools }) } : {}),\n    ...(definition.subagents ? { subagents: Object.freeze({ ...definition.subagents }) } : {}),\n  });\n}\n\nexport function validateAgent(value: unknown, ancestors = new Set<unknown>()): asserts value is AgentDefinition {\n  object(value, [\"name\", \"description\", \"instructions\", \"harness\", \"tools\", \"subagents\"]);\n  if (ancestors.has(value)) invalid(\"Subagent definitions cannot contain recursive references.\");\n  validName(value.name);\n  nonempty(value.description, \"Description\");\n  nonempty(value.instructions, \"Instructions\");\n  const harnesses = Array.isArray(value.harness) ? value.harness : [value.harness];\n  if (!harnesses.length) invalid(\"At least one harness is required.\");\n  harnesses.forEach((harness) => validateHarness(harness, true));\n  if (value.tools !== undefined) {\n    object(value.tools);\n    Object.keys(value.tools).forEach(validName);\n    Object.values(value.tools).forEach(validateTool);\n  }\n  if (value.subagents !== undefined) {\n    object(value.subagents);\n    const next = new Set(ancestors).add(value);\n    for (const [name, child] of Object.entries(value.subagents)) {\n      validName(name);\n      validateAgent(child, next);\n    }\n  }\n}\n"]}
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/sdk/definitions.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,SAAS,eAAe,CAAC,KAAc,EAAE,UAAU,GAAG,KAAK,EAAE,YAAoC;IAC/F,MAAM,CAAC,KAAK,CAAC,CAAC;IACd,MAAM,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC;IACzD,IAAI,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,SAAmB,CAAC;QAAE,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACxI,MAAM,IAAI,GAAG,SAAkC,CAAC;IAChD,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC;IACzB,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,IAAI;QAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtF,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,YAAY;QAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnE,MAAM,CAAC,IAAI,CAAC,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACzD,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;QAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjE,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACpG,IAAI,UAAU,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;QAAE,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAClF,0BAA0B,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAe;IAC3C,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,MAAgB,CAAC,EAAE,CAAC;QAClG,OAAO,CAAC,yDAAyD,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,OAAqB;IACzC,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACzC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK,EAAE,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAA0B;IACnD,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;IAC9C,oBAAoB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,OAAO;QACV,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3F,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpG,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK;KAC5B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,EAAE,CAAC,OAAkB;IACnC,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IACtC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAwB;IAC/C,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAC5C,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,OAAuB;IAC7C,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IAC3C,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,OAAsB;IAC3C,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,UAA2B;IAC/C,aAAa,CAAC,UAAU,CAAC,CAAC;IAC1B,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,UAAU;QACb,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjG,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,UAAU,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,UAAU,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC3F,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,SAAS,GAAG,IAAI,GAAG,EAAW;IAC1E,MAAM,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;IACxF,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,2DAA2D,CAAC,CAAC;IAC/F,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACjF,IAAI,CAAC,SAAS,CAAC,MAAM;QAAE,OAAO,CAAC,mCAAmC,CAAC,CAAC;IACpE,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAC/D,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACxB,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5D,SAAS,CAAC,IAAI,CAAC,CAAC;YAChB,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["import type {\n  AgentDefinition,\n  ClaudeCodeConfig,\n  ClaudeCodeOptions,\n  CodexConfig,\n  CodexOptions,\n  FxConfig,\n  FxOptions,\n  HarnessConfig,\n  OpencodeConfig,\n  OpencodeOptions,\n  CopilotConfig,\n  CopilotOptions,\n  CursorConfig,\n  CursorOptions,\n} from \"./types.js\";\nimport { invalid, nonempty, object, validName } from \"./validation.js\";\nimport { permissionOptionFields, validateHarnessPermissions } from \"./permission-validation.js\";\nimport { validateTool } from \"./tools.js\";\n\nfunction validateHarness(value: unknown, configured = false, expectedKind?: HarnessConfig[\"kind\"]): void {\n  object(value);\n  const candidate = configured ? value.kind : expectedKind;\n  if (![\"codex\", \"claudeCode\", \"fx\", \"opencode\", \"copilot\", \"cursor\"].includes(candidate as string)) invalid(\"Unsupported harness kind.\");\n  const kind = candidate as HarnessConfig[\"kind\"];\n  const fields = [\"model\"];\n  if (kind === \"codex\" || kind === \"claudeCode\" || kind === \"fx\") fields.push(\"effort\");\n  if (kind === \"codex\" || kind === \"claudeCode\") fields.push(\"fast\");\n  fields.push(...permissionOptionFields(kind));\n  object(value, configured ? [\"kind\", ...fields] : fields);\n  nonempty(value.model, \"Model\");\n  if (value.effort !== undefined) nonempty(value.effort, \"Effort\");\n  if (value.fast !== undefined && typeof value.fast !== \"boolean\") invalid(\"fast must be a boolean.\");\n  if (configured && value.kind === \"claudeCode\") validateClaudeEffort(value.effort);\n  validateHarnessPermissions(kind, value);\n}\n\nfunction validateClaudeEffort(effort: unknown): void {\n  if (effort !== undefined && ![\"low\", \"medium\", \"high\", \"xhigh\", \"max\"].includes(effort as string)) {\n    invalid(\"Claude effort must be low, medium, high, xhigh, or max.\");\n  }\n}\n\nexport function codex(options: CodexOptions): CodexConfig {\n  validateHarness(options, false, \"codex\");\n  return Object.freeze({ ...options, kind: \"codex\", fast: options.fast ?? false });\n}\n\nexport function claudeCode(options: ClaudeCodeOptions): ClaudeCodeConfig {\n  validateHarness(options, false, \"claudeCode\");\n  validateClaudeEffort(options.effort);\n  return Object.freeze({\n    ...options,\n    ...(options.allowedTools ? { allowedTools: Object.freeze([...options.allowedTools]) } : {}),\n    ...(options.disallowedTools ? { disallowedTools: Object.freeze([...options.disallowedTools]) } : {}),\n    kind: \"claudeCode\",\n    fast: options.fast ?? false,\n  });\n}\n\nexport function fx(options: FxOptions): FxConfig {\n  validateHarness(options, false, \"fx\");\n  return Object.freeze({ ...options, kind: \"fx\" });\n}\n\nexport function opencode(options: OpencodeOptions): OpencodeConfig {\n  validateHarness(options, false, \"opencode\");\n  return Object.freeze({ ...options, kind: \"opencode\" });\n}\n\nexport function copilot(options: CopilotOptions): CopilotConfig {\n  validateHarness(options, false, \"copilot\");\n  return Object.freeze({ ...options, kind: \"copilot\" });\n}\n\nexport function cursor(options: CursorOptions): CursorConfig {\n  validateHarness(options, false, \"cursor\");\n  return Object.freeze({ ...options, kind: \"cursor\" });\n}\n\nexport function agent(definition: AgentDefinition): AgentDefinition {\n  validateAgent(definition);\n  return Object.freeze({\n    ...definition,\n    ...(Array.isArray(definition.harness) ? { harness: Object.freeze([...definition.harness]) } : {}),\n    ...(definition.tools ? { tools: Object.freeze({ ...definition.tools }) } : {}),\n    ...(definition.subagents ? { subagents: Object.freeze({ ...definition.subagents }) } : {}),\n  });\n}\n\nexport function validateAgent(value: unknown, ancestors = new Set<unknown>()): asserts value is AgentDefinition {\n  object(value, [\"name\", \"description\", \"instructions\", \"harness\", \"tools\", \"subagents\"]);\n  if (ancestors.has(value)) invalid(\"Subagent definitions cannot contain recursive references.\");\n  validName(value.name);\n  nonempty(value.description, \"Description\");\n  nonempty(value.instructions, \"Instructions\");\n  const harnesses = Array.isArray(value.harness) ? value.harness : [value.harness];\n  if (!harnesses.length) invalid(\"At least one harness is required.\");\n  harnesses.forEach((harness) => validateHarness(harness, true));\n  if (value.tools !== undefined) {\n    object(value.tools);\n    Object.keys(value.tools).forEach(validName);\n    Object.values(value.tools).forEach(validateTool);\n  }\n  if (value.subagents !== undefined) {\n    object(value.subagents);\n    const next = new Set(ancestors).add(value);\n    for (const [name, child] of Object.entries(value.subagents)) {\n      validName(name);\n      validateAgent(child, next);\n    }\n  }\n}\n"]}

package/dist/sdk/execution-definition.d.ts

@@ -0,0 +1,3 @@
+import type { AgentDefinition } from "./types.js";
+export declare const hostedToolNames: readonly ["agent_run", "agent_send", "agent_wait", "agent_status", "agent_queue", "agent_cancel", "agent_respond"];
+export declare function captureDefinition(value: unknown): AgentDefinition;

package/dist/sdk/execution-definition.js

@@ -0,0 +1,59 @@
+import { AgentError } from "../errors.js";
+import { validateAgent } from "./definitions.js";
+export const hostedToolNames = [
+    "agent_run",
+    "agent_send",
+    "agent_wait",
+    "agent_status",
+    "agent_queue",
+    "agent_cancel",
+    "agent_respond",
+];
+const reserved = new Set(hostedToolNames);
+export function captureDefinition(value) {
+    validateAgent(value);
+    rejectHostedToolCollisions(value);
+    return cloneDefinition(value);
+}
+function rejectHostedToolCollisions(definition) {
+    for (const name of Object.keys(definition.tools ?? {})) {
+        if (reserved.has(name)) {
+            throw new AgentError("INVALID_DEFINITION", `Tool name ${name} is reserved for SDK hosted delegation.`);
+        }
+    }
+    for (const child of Object.values(definition.subagents ?? {}))
+        rejectHostedToolCollisions(child);
+}
+function cloneDefinition(definition) {
+    const harness = Array.isArray(definition.harness)
+        ? definition.harness.map(cloneHarness)
+        : cloneHarness(definition.harness);
+    const tools = definition.tools
+        ? Object.fromEntries(Object.entries(definition.tools).map(([name, declared]) => [name, {
+                description: declared.description,
+                inputSchema: declared.inputSchema,
+                execute: declared.execute,
+            }]))
+        : undefined;
+    const subagents = definition.subagents
+        ? Object.fromEntries(Object.entries(definition.subagents).map(([name, child]) => [name, cloneDefinition(child)]))
+        : undefined;
+    return {
+        name: definition.name,
+        description: definition.description,
+        instructions: definition.instructions,
+        harness,
+        ...(tools ? { tools } : {}),
+        ...(subagents ? { subagents } : {}),
+    };
+}
+function cloneHarness(harness) {
+    if (harness.kind !== "claudeCode")
+        return { ...harness };
+    return {
+        ...harness,
+        ...(harness.allowedTools ? { allowedTools: [...harness.allowedTools] } : {}),
+        ...(harness.disallowedTools ? { disallowedTools: [...harness.disallowedTools] } : {}),
+    };
+}
+//# sourceMappingURL=execution-definition.js.map

package/dist/sdk/execution-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-definition.js","sourceRoot":"","sources":["../../src/sdk/execution-definition.ts"],"names":[],"mappings":"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","sourcesContent":["import { AgentError } from \"../errors.js\";\nimport { validateAgent } from \"./definitions.js\";\nimport type { AgentDefinition, HarnessConfig } from \"./types.js\";\n\nexport const hostedToolNames = [\n  \"agent_run\",\n  \"agent_send\",\n  \"agent_wait\",\n  \"agent_status\",\n  \"agent_queue\",\n  \"agent_cancel\",\n  \"agent_respond\",\n] as const;\n\nconst reserved = new Set<string>(hostedToolNames);\n\nexport function captureDefinition(value: unknown): AgentDefinition {\n  validateAgent(value);\n  rejectHostedToolCollisions(value);\n  return cloneDefinition(value);\n}\n\nfunction rejectHostedToolCollisions(definition: AgentDefinition): void {\n  for (const name of Object.keys(definition.tools ?? {})) {\n    if (reserved.has(name)) {\n      throw new AgentError(\"INVALID_DEFINITION\", `Tool name ${name} is reserved for SDK hosted delegation.`);\n    }\n  }\n  for (const child of Object.values(definition.subagents ?? {})) rejectHostedToolCollisions(child);\n}\n\nfunction cloneDefinition(definition: AgentDefinition): AgentDefinition {\n  const harness = Array.isArray(definition.harness)\n    ? definition.harness.map(cloneHarness)\n    : cloneHarness(definition.harness as HarnessConfig);\n  const tools = definition.tools\n    ? Object.fromEntries(Object.entries(definition.tools).map(([name, declared]) => [name, {\n      description: declared.description,\n      inputSchema: declared.inputSchema,\n      execute: declared.execute,\n    }]))\n    : undefined;\n  const subagents = definition.subagents\n    ? Object.fromEntries(Object.entries(definition.subagents).map(([name, child]) => [name, cloneDefinition(child)]))\n    : undefined;\n  return {\n    name: definition.name,\n    description: definition.description,\n    instructions: definition.instructions,\n    harness,\n    ...(tools ? { tools } : {}),\n    ...(subagents ? { subagents } : {}),\n  };\n}\n\nfunction cloneHarness(harness: HarnessConfig): HarnessConfig {\n  if (harness.kind !== \"claudeCode\") return { ...harness };\n  return {\n    ...harness,\n    ...(harness.allowedTools ? { allowedTools: [...harness.allowedTools] } : {}),\n    ...(harness.disallowedTools ? { disallowedTools: [...harness.disallowedTools] } : {}),\n  };\n}\n"]}

package/dist/sdk/execution-driver.d.ts

@@ -0,0 +1,6 @@
+import type { AdapterOptions, NativeSession } from "../adapters/types.js";
+import type { AccessConfig } from "../config/access.js";
+import type { Coordinator } from "../runtime/coordinator.js";
+import type { DriverFactory } from "../runtime/types.js";
+export type NativeOpener = (options: AdapterOptions) => Promise<NativeSession>;
+export declare function executionDriver(coordinator: Coordinator, access: AccessConfig, open?: NativeOpener): DriverFactory;

package/dist/sdk/execution-driver.js

@@ -0,0 +1,86 @@
+import { AgentError } from "../errors.js";
+import { HostedDelegation } from "./hosted.js";
+export function executionDriver(coordinator, access, open) {
+    return async (input) => {
+        if (!("kind" in input.reference) || input.reference.kind !== "inline") {
+            throw new AgentError("INVALID_DEFINITION", "The application runner requires an inline agent definition.");
+        }
+        const hosted = new HostedDelegation(coordinator, input, input.reference.definition);
+        const definition = hosted.prepare();
+        let selectedHarness;
+        let native;
+        try {
+            const { selectNative } = await import("../runtime/select-native.js");
+            native = await selectNative(definition, input.cwd, input.env, access, open, kind => { selectedHarness = kind; }, input.onApproval, { origin: "sdk" });
+        }
+        catch (error) {
+            throw safeDriverError(error, "HARNESS_FAILED", "Native session startup failed.");
+        }
+        return wrapNative(native, hosted, selectedHarness);
+    };
+}
+function wrapNative(native, hosted, selectedHarness) {
+    return {
+        selectedHarness,
+        async turn(prompt) {
+            hosted.beginTurn();
+            try {
+                return await native.turn(prompt);
+            }
+            catch (error) {
+                throw safeDriverError(error, "HARNESS_FAILED", "Native execution failed.");
+            }
+            finally {
+                await hosted.finishTurn();
+            }
+        },
+        async steer(prompt) {
+            try {
+                await native.steer(prompt);
+            }
+            catch (error) {
+                throw safeDriverError(error, "HARNESS_FAILED", "Native steering failed.");
+            }
+        },
+        async interrupt() {
+            hosted.stopManagedWaits();
+            try {
+                await native.interrupt();
+            }
+            catch (error) {
+                throw safeDriverError(error, "CANCEL_FAILED", "Native interruption could not be confirmed.");
+            }
+            finally {
+                await hosted.drain();
+            }
+        },
+        async resume() {
+            hosted.beginTurn();
+            try {
+                return await native.resume();
+            }
+            catch (error) {
+                throw safeDriverError(error, "HARNESS_FAILED", "Native recovery failed.");
+            }
+            finally {
+                await hosted.finishTurn();
+            }
+        },
+        async close() {
+            hosted.stopManagedWaits();
+            try {
+                await native.close();
+            }
+            catch (error) {
+                throw safeDriverError(error, "HARNESS_FAILED", "Native session cleanup could not be confirmed.");
+            }
+            finally {
+                await hosted.drain();
+            }
+        },
+    };
+}
+function safeDriverError(error, code, message) {
+    return error instanceof AgentError ? error : new AgentError(code, message);
+}
+//# sourceMappingURL=execution-driver.js.map

package/dist/sdk/execution-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-driver.js","sourceRoot":"","sources":["../../src/sdk/execution-driver.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AdapterOptions, NativeSession } from \"../adapters/types.js\";\nimport type { AccessConfig } from \"../config/access.js\";\nimport { AgentError } from \"../errors.js\";\nimport type { Coordinator } from \"../runtime/coordinator.js\";\nimport type { DriverFactory, ManagedNativeSession } from \"../runtime/types.js\";\nimport type { HarnessKind } from \"./types.js\";\nimport { HostedDelegation } from \"./hosted.js\";\n\nexport type NativeOpener = (options: AdapterOptions) => Promise<NativeSession>;\n\nexport function executionDriver(\n  coordinator: Coordinator,\n  access: AccessConfig,\n  open?: NativeOpener,\n): DriverFactory {\n  return async input => {\n    if (!(\"kind\" in input.reference) || input.reference.kind !== \"inline\") {\n      throw new AgentError(\"INVALID_DEFINITION\", \"The application runner requires an inline agent definition.\");\n    }\n    const hosted = new HostedDelegation(coordinator, input, input.reference.definition);\n    const definition = hosted.prepare();\n    let selectedHarness: HarnessKind | undefined;\n    let native: NativeSession;\n    try {\n      const { selectNative } = await import(\"../runtime/select-native.js\");\n      native = await selectNative(\n        definition,\n        input.cwd,\n        input.env,\n        access,\n        open,\n        kind => { selectedHarness = kind; },\n        input.onApproval,\n        { origin: \"sdk\" },\n      );\n    } catch (error) {\n      throw safeDriverError(error, \"HARNESS_FAILED\", \"Native session startup failed.\");\n    }\n    return wrapNative(native, hosted, selectedHarness!);\n  };\n}\n\nfunction wrapNative(native: NativeSession, hosted: HostedDelegation, selectedHarness: HarnessKind): ManagedNativeSession {\n  return {\n    selectedHarness,\n    async turn(prompt) {\n      hosted.beginTurn();\n      try { return await native.turn(prompt); }\n      catch (error) { throw safeDriverError(error, \"HARNESS_FAILED\", \"Native execution failed.\"); }\n      finally { await hosted.finishTurn(); }\n    },\n    async steer(prompt) {\n      try { await native.steer(prompt); }\n      catch (error) { throw safeDriverError(error, \"HARNESS_FAILED\", \"Native steering failed.\"); }\n    },\n    async interrupt() {\n      hosted.stopManagedWaits();\n      try { await native.interrupt(); }\n      catch (error) { throw safeDriverError(error, \"CANCEL_FAILED\", \"Native interruption could not be confirmed.\"); }\n      finally { await hosted.drain(); }\n    },\n    async resume() {\n      hosted.beginTurn();\n      try { return await native.resume(); }\n      catch (error) { throw safeDriverError(error, \"HARNESS_FAILED\", \"Native recovery failed.\"); }\n      finally { await hosted.finishTurn(); }\n    },\n    async close() {\n      hosted.stopManagedWaits();\n      try { await native.close(); }\n      catch (error) { throw safeDriverError(error, \"HARNESS_FAILED\", \"Native session cleanup could not be confirmed.\"); }\n      finally { await hosted.drain(); }\n    },\n  };\n}\n\nfunction safeDriverError(error: unknown, code: string, message: string): AgentError {\n  return error instanceof AgentError ? error : new AgentError(code, message);\n}\n"]}

package/dist/sdk/execution-observation.d.ts

@@ -0,0 +1,3 @@
+import type { Coordinator } from "../runtime/coordinator.js";
+import type { TaskObservation } from "../runtime/snapshots.js";
+export declare function observeTask(coordinator: Coordinator, taskId: string, after?: string, readerToken?: string, signal?: AbortSignal): Promise<TaskObservation>;

package/dist/sdk/execution-observation.js

@@ -0,0 +1,35 @@
+import { AgentError } from "../errors.js";
+export async function observeTask(coordinator, taskId, after, readerToken, signal) {
+    if (signal?.aborted)
+        throw new AgentError("OBSERVATION_CLOSED", "The observer disconnected.");
+    if (after === "")
+        throw new AgentError("UNKNOWN_RESPONSE", "The response does not belong to this task.");
+    const record = await coordinator.observe(taskId, after, readerToken, signal);
+    if (record.type === "response") {
+        return structuredClone({
+            type: "response",
+            taskId: record.taskId,
+            sessionId: record.sessionId,
+            response: { responseId: record.responseId, text: record.text, state: record.state },
+        });
+    }
+    if (record.type === "approval_required") {
+        return structuredClone({
+            type: "approval_required",
+            taskId: record.taskId,
+            sessionId: record.sessionId,
+            state: record.state,
+            requests: record.requests ?? [],
+        });
+    }
+    const snapshot = coordinator.snapshot(taskId);
+    return structuredClone({
+        type: "terminal",
+        taskId: record.taskId,
+        sessionId: record.sessionId,
+        state: record.state,
+        ...(record.error ? { error: record.error } : {}),
+        stopUnconfirmed: snapshot.stopUnconfirmed,
+    });
+}
+//# sourceMappingURL=execution-observation.js.map

package/dist/sdk/execution-observation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-observation.js","sourceRoot":"","sources":["../../src/sdk/execution-observation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI1C,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,WAAwB,EACxB,MAAc,EACd,KAAc,EACd,WAAoB,EACpB,MAAoB;IAEpB,IAAI,MAAM,EAAE,OAAO;QAAE,MAAM,IAAI,UAAU,CAAC,oBAAoB,EAAE,4BAA4B,CAAC,CAAC;IAC9F,IAAI,KAAK,KAAK,EAAE;QAAE,MAAM,IAAI,UAAU,CAAC,kBAAkB,EAAE,4CAA4C,CAAC,CAAC;IACzG,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;IAC7E,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC/B,OAAO,eAAe,CAAC;YACrB,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,QAAQ,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,UAAW,EAAE,IAAI,EAAE,MAAM,CAAC,IAAK,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE;SACtF,CAAC,CAAC;IACL,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;QACxC,OAAO,eAAe,CAAC;YACrB,IAAI,EAAE,mBAAmB;YACzB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;SAChC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9C,OAAO,eAAe,CAAC;QACrB,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,eAAe,EAAE,QAAQ,CAAC,eAAe;KAC1C,CAAoB,CAAC;AACxB,CAAC","sourcesContent":["import { AgentError } from \"../errors.js\";\nimport type { Coordinator } from \"../runtime/coordinator.js\";\nimport type { TaskObservation } from \"../runtime/snapshots.js\";\n\nexport async function observeTask(\n  coordinator: Coordinator,\n  taskId: string,\n  after?: string,\n  readerToken?: string,\n  signal?: AbortSignal,\n): Promise<TaskObservation> {\n  if (signal?.aborted) throw new AgentError(\"OBSERVATION_CLOSED\", \"The observer disconnected.\");\n  if (after === \"\") throw new AgentError(\"UNKNOWN_RESPONSE\", \"The response does not belong to this task.\");\n  const record = await coordinator.observe(taskId, after, readerToken, signal);\n  if (record.type === \"response\") {\n    return structuredClone({\n      type: \"response\",\n      taskId: record.taskId,\n      sessionId: record.sessionId,\n      response: { responseId: record.responseId!, text: record.text!, state: record.state },\n    });\n  }\n  if (record.type === \"approval_required\") {\n    return structuredClone({\n      type: \"approval_required\",\n      taskId: record.taskId,\n      sessionId: record.sessionId,\n      state: record.state,\n      requests: record.requests ?? [],\n    });\n  }\n  const snapshot = coordinator.snapshot(taskId);\n  return structuredClone({\n    type: \"terminal\",\n    taskId: record.taskId,\n    sessionId: record.sessionId,\n    state: record.state,\n    ...(record.error ? { error: record.error } : {}),\n    stopUnconfirmed: snapshot.stopUnconfirmed,\n  }) as TaskObservation;\n}\n"]}

package/dist/sdk/execution-options.d.ts

@@ -0,0 +1,17 @@
+import { type AccessConfig } from "../config/access.js";
+import type { Delivery, RunnerOptions } from "./execution-types.js";
+export declare function runnerConfiguration(options: RunnerOptions | undefined): {
+    env: NodeJS.ProcessEnv;
+    access: AccessConfig;
+};
+export declare function validatePrompt(prompt: unknown): asserts prompt is string;
+export declare function validateCwd(cwd: unknown): Promise<string>;
+export declare function runCwd(options: unknown): unknown;
+export declare function delivery(options: unknown): Delivery;
+export declare function observeOptions(options: unknown): {
+    after?: string;
+    signal?: AbortSignal;
+};
+export declare function watchOptions(options: unknown): {
+    signal?: AbortSignal;
+};