actoviq-agent-sdk 0.4.17 → 0.4.19

package/CHANGELOG.md

@@ -6,6 +6,15 @@ The format is based on Keep a Changelog, with automated updates from GitHub Rele
 
 ## Unreleased
 
+## v0.4.18 - 2026-08-16
+
+### Features
+
+- Rename the Bridge tab to Configuration, move it above Agents, and manage local runtime discovery and login checks there
+- Redesign the Devices tab with card headers, status pills, permission scope chips, and clearer pairing and paired-device sections
+
+**Full Changelog**: https://github.com/DeconBear/hadamard/compare/v0.4.17...v0.4.18
+
 ## v0.4.17 - 2026-08-14
 
 ### Fixes

package/dist/src/codeact/codeActArtifacts.d.ts

@@ -8,4 +8,22 @@ export declare class CodeActArtifactRecorder {
         mediaType: string;
     }): Promise<CodeActArtifactReference>;
 }
+/**
+ * Spill oversized cell output to a session-scoped artifact and replace the
+ * model-facing streams with a bounded head/tail preview plus the locator
+ * (dsh spill-policy shape). Best-effort: a write failure keeps the inline
+ * content unchanged and never turns the cell result into an error.
+ */
+export declare function spillOversizedCellOutput(options: {
+    artifacts: CodeActArtifactRecorder;
+    workDir: string;
+    sessionId: string;
+    executionId: string;
+    maxChars: number;
+    result: {
+        stdout: string;
+        stderr: string;
+        artifacts: CodeActArtifactReference[];
+    };
+}): Promise<void>;
 //# sourceMappingURL=codeActArtifacts.d.ts.map

package/dist/src/codeact/codeActArtifacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codeActArtifacts.d.ts","sourceRoot":"","sources":["../../../src/codeact/codeActArtifacts.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAEpF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,qBAAa,uBAAuB;IAC5B,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC;IAsBzE,eAAe,CACnB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAC1D,OAAO,CAAC,wBAAwB,CAAC;CAsBrC"}
+{"version":3,"file":"codeActArtifacts.d.ts","sourceRoot":"","sources":["../../../src/codeact/codeActArtifacts.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAEpF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,qBAAa,uBAAuB;IAC5B,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC;IAsBzE,eAAe,CACnB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAC1D,OAAO,CAAC,wBAAwB,CAAC;CAsBrC;AAUD;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,EAAE;IACtD,SAAS,EAAE,uBAAuB,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,wBAAwB,EAAE,CAAA;KAAE,CAAC;CACnF,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BhB"}

package/dist/src/codeact/codeActArtifacts.js

@@ -44,4 +44,37 @@ function isAlreadyExists(error) {
 function safeSegment(value) {
     return value.replace(/[^A-Za-z0-9_.-]+/g, '_').slice(0, 100) || 'artifact';
 }
+/**
+ * Spill oversized cell output to a session-scoped artifact and replace the
+ * model-facing streams with a bounded head/tail preview plus the locator
+ * (dsh spill-policy shape). Best-effort: a write failure keeps the inline
+ * content unchanged and never turns the cell result into an error.
+ */
+export async function spillOversizedCellOutput(options) {
+    const combined = options.result.stderr
+        ? options.result.stdout + '\n--- stderr ---\n' + options.result.stderr
+        : options.result.stdout;
+    if (combined.length <= options.maxChars)
+        return;
+    const artifact = await options.artifacts.putHostArtifact(options.workDir, options.sessionId, {
+        name: 'cell-output-' + safeSegment(options.executionId) + '.txt',
+        content: combined,
+        mediaType: 'text/plain',
+    }).catch(() => undefined);
+    if (!artifact)
+        return;
+    // Reserve the notice bytes INSIDE the budget so preview + locator never
+    // exceed maxChars (dsh spill-policy reservation rule).
+    const notice = 'Full cell output stored at: ' + artifact.path + ' (read it with the Read tool when you need the omitted middle).';
+    const budget = Math.max(0, options.maxChars - notice.length - 2);
+    const headChars = Math.floor(budget / 2);
+    const tailChars = Math.max(0, budget - headChars);
+    const omitted = Math.max(0, combined.length - headChars - tailChars);
+    const preview = combined.slice(0, headChars)
+        + (omitted > 0 ? '\n...[omitted ' + omitted + ' chars]...\n' : '\n')
+        + combined.slice(-tailChars);
+    options.result.stdout = preview + '\n' + notice;
+    options.result.stderr = '';
+    options.result.artifacts.push(artifact);
+}
 //# sourceMappingURL=codeActArtifacts.js.map

package/dist/src/codeact/codeActArtifacts.js.map

@@ -1 +1 @@
-{"version":3,"file":"codeActArtifacts.js","sourceRoot":"","sources":["../../../src/codeact/codeActArtifacts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"codeActArtifacts.js","sourceRoot":"","sources":["../../../src/codeact/codeActArtifacts.ts"],"names":[],"mappings":"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"}

package/dist/src/codeact/codeActPolicy.d.ts

@@ -6,4 +6,9 @@ export declare class CodeActConfigurationError extends HadamardSdkError {
 export declare function resolveCodeActSettings(input: CodeActSettings): ResolvedCodeActSettings;
 export declare function buildCodeActEnvironment(allowlist: readonly string[], source?: NodeJS.ProcessEnv): Record<string, string>;
 export declare function assertCodeActBackend(settings: ResolvedCodeActSettings, adapter: CodeActKernelAdapter): Promise<CodeActBackendStatus>;
+/**
+ * Assert the worker-thread PTC backend: it is containment, not a security
+ * boundary, so enforce mode (which requires strong isolation) refuses it.
+ */
+export declare function assertWorkerThreadPtcBackend(settings: ResolvedCodeActSettings): void;
 //# sourceMappingURL=codeActPolicy.d.ts.map

package/dist/src/codeact/codeActPolicy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codeActPolicy.d.ts","sourceRoot":"","sources":["../../../src/codeact/codeActPolicy.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAOpB,qBAAa,yBAA0B,SAAQ,gBAAgB;gBACjD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,6BAA6B,GAAG,wBAAwB;CAGjH;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,eAAe,GAAG,uBAAuB,CActF;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,MAAM,GAAE,MAAM,CAAC,UAAwB,GACtC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYxB;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,uBAAuB,EACjC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,oBAAoB,CAAC,CAe/B"}
+{"version":3,"file":"codeActPolicy.d.ts","sourceRoot":"","sources":["../../../src/codeact/codeActPolicy.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAOpB,qBAAa,yBAA0B,SAAQ,gBAAgB;gBACjD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,6BAA6B,GAAG,wBAAwB;CAGjH;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,eAAe,GAAG,uBAAuB,CAsBtF;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,MAAM,GAAE,MAAM,CAAC,UAAwB,GACtC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYxB;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,uBAAuB,EACjC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,oBAAoB,CAAC,CAe/B;AAgBD;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI,CAUpF"}

package/dist/src/codeact/codeActPolicy.js

@@ -13,15 +13,18 @@ export function resolveCodeActSettings(input) {
     return {
         enabled: input.enabled,
         backend: input.backend ?? 'process',
+        ptcBackend: input.ptcBackend ?? input.backend ?? 'process',
         securityMode: input.securityMode ?? 'trusted',
         pythonCommand: input.pythonCommand?.trim() || (process.platform === 'win32' ? 'python' : 'python3'),
         idleTimeoutMs: clampInteger(input.idleTimeoutMs, 60_000, 1_000, 3_600_000),
         executionTimeoutMs: clampInteger(input.executionTimeoutMs, 120_000, 100, 3_600_000),
         maxOutputChars: clampInteger(input.maxOutputChars, 80_000, 1_000, 10_000_000),
+        maxOutputBytes: clampInteger(input.maxOutputBytes, (input.maxOutputChars ?? 80_000) * 4, 1_000, 40_000_000),
         environmentAllowlist: uniqueStrings(input.environmentAllowlist ?? []),
         containerImage: input.containerImage?.trim() || 'python:3.12-alpine',
         containerMemoryMb: clampInteger(input.containerMemoryMb, 512, 64, 32_768),
         containerCpuLimit: clampNumber(input.containerCpuLimit, 1, 0.1, 64),
+        maxParallelSubCalls: clampInteger(input.maxParallelSubCalls, 10, 1, 32),
     };
 }
 export function buildCodeActEnvironment(allowlist, source = process.env) {
@@ -65,4 +68,16 @@ function clampNumber(value, fallback, min, max) {
         return fallback;
     return Math.min(max, Math.max(min, value));
 }
+/**
+ * Assert the worker-thread PTC backend: it is containment, not a security
+ * boundary, so enforce mode (which requires strong isolation) refuses it.
+ */
+export function assertWorkerThreadPtcBackend(settings) {
+    if (!settings.enabled) {
+        throw new CodeActConfigurationError('CodeAct is disabled for this project.', 'CODEACT_DISABLED');
+    }
+    if (settings.securityMode === 'enforce') {
+        throw new CodeActConfigurationError('CodeAct enforce mode requires a strong-isolation container backend; the worker-thread backend is containment only.', 'CODEACT_UNSAFE_BACKEND');
+    }
+}
 //# sourceMappingURL=codeActPolicy.js.map

package/dist/src/codeact/codeActPolicy.js.map

@@ -1 +1 @@
-{"version":3,"file":"codeActPolicy.js","sourceRoot":"","sources":["../../../src/codeact/codeActPolicy.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"codeActPolicy.js","sourceRoot":"","sources":["../../../src/codeact/codeActPolicy.ts"],"names":[],"mappings":"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"}

package/dist/src/codeact/codeActPrompt.d.ts

@@ -2,7 +2,9 @@ import type { AgentExecutionPolicy } from '../runtime/agentExecutionPolicy.js';
 import type { AgentToolDefinition } from '../types.js';
 export interface AgentModePromptCapabilities {
     hostCapabilities?: readonly string[];
+    /** Rendered typed host-tool stubs (CodeAct SDK section) for codeact/hybrid modes. */
+    hostSdk?: string;
 }
-export declare function buildAgentModePrompt(policy: AgentExecutionPolicy, capabilities?: AgentModePromptCapabilities): string;
+export declare function buildAgentModePrompt(policy: AgentExecutionPolicy, capabilities?: AgentModePromptCapabilities, presentation?: 'native' | 'ptc' | 'both'): string;
 export declare function filterToolsForExecutionPolicy(tools: readonly AgentToolDefinition[], policy: AgentExecutionPolicy): AgentToolDefinition[];
 //# sourceMappingURL=codeActPrompt.d.ts.map

package/dist/src/codeact/codeActPrompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codeActPrompt.d.ts","sourceRoot":"","sources":["../../../src/codeact/codeActPrompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGvD,MAAM,WAAW,2BAA2B;IAC1C,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,oBAAoB,EAC5B,YAAY,GAAE,2BAAgC,GAC7C,MAAM,CAwBR;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,MAAM,EAAE,oBAAoB,GAC3B,mBAAmB,EAAE,CAOvB"}
+{"version":3,"file":"codeActPrompt.d.ts","sourceRoot":"","sources":["../../../src/codeact/codeActPrompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGvD,MAAM,WAAW,2BAA2B;IAC1C,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,oBAAoB,EAC5B,YAAY,GAAE,2BAAgC,EAC9C,YAAY,GAAE,QAAQ,GAAG,KAAK,GAAG,MAAiB,GACjD,MAAM,CAiCR;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,MAAM,EAAE,oBAAoB,GAC3B,mBAAmB,EAAE,CAOvB"}

package/dist/src/codeact/codeActPrompt.js

@@ -1,5 +1,5 @@
 import { CODE_CELL_TOOL_NAME } from './codeCellTool.js';
-export function buildAgentModePrompt(policy, capabilities = {}) {
+export function buildAgentModePrompt(policy, capabilities = {}, presentation = 'native') {
     if (policy.turnPolicy === 'single') {
         if (policy.actionSpace === 'none') {
             return 'Answer this node once and finish directly. No tools are available.';
@@ -10,8 +10,18 @@ export function buildAgentModePrompt(policy, capabilities = {}) {
             'After that result, produce the final answer immediately. Do not start another tool call.',
         ].join('\n');
     }
+    // Under the ptc presentation the wire carries only run_code, so
+    // code-cell/hybrid guidance would name tools the model cannot call and
+    // duplicate the SDK the presentation instructions already carry.
+    if (presentation === 'ptc')
+        return '';
+    // Under 'both' the presentation instructions own the SDK section; keep
+    // the mode guidance but drop the duplicate host SDK.
+    const effective = presentation === 'both'
+        ? { ...capabilities, hostSdk: undefined }
+        : capabilities;
     if (policy.actionSpace === 'code-cell') {
-        return codeCellInstructions(capabilities);
+        return codeCellInstructions(effective);
     }
     if (policy.actionSpace === 'hybrid') {
         return [
@@ -19,7 +29,7 @@ export function buildAgentModePrompt(policy, capabilities = {}) {
             'Use ordinary JSON tools for deterministic metadata, permission-sensitive filesystem actions, external services, and one-step host operations.',
             'Use CodeCell for loops, data transformations, mathematical work, experiments, and multi-step computation.',
             'Prefer ordinary structured calls before CodeCell when both would mutate the same state in one action group.',
-            codeCellInstructions(capabilities),
+            codeCellInstructions(effective),
         ].join('\n\n');
     }
     return '';
@@ -38,11 +48,15 @@ function codeCellInstructions(capabilities) {
     const host = capabilities.hostCapabilities?.length
         ? `Allowed host RPC capabilities: ${capabilities.hostCapabilities.join(', ')}.`
         : 'Host RPC capabilities are explicit and may be unavailable; never assume direct access to provider credentials.';
+    const sdk = capabilities.hostSdk?.trim()
+        ? `Typed host-tool surface reachable from CodeCell code (signatures are authoritative for parameter names):\n${capabilities.hostSdk}`
+        : '';
     return [
         'Use CodeCell with language="python" and executable Python source.',
         'The namespace persists for this session until a restart, crash, interrupt, or idle cleanup changes the generation.',
         'Inspect stdout, stderr, the structured final-expression result, artifact references, and stateLost after every cell.',
         host,
+        ...(sdk ? [sdk] : []),
         'Keep cells auditable and bounded. Finish only when the requested observable result is verified.',
     ].join('\n');
 }

package/dist/src/codeact/codeActPrompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"codeActPrompt.js","sourceRoot":"","sources":["../../../src/codeact/codeActPrompt.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAMxD,MAAM,UAAU,oBAAoB,CAClC,MAA4B,EAC5B,eAA4C,EAAE;IAE9C,IAAI,MAAM,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,IAAI,MAAM,CAAC,WAAW,KAAK,MAAM,EAAE,CAAC;YAClC,OAAO,oEAAoE,CAAC;QAC9E,CAAC;QACD,OAAO;YACL,qCAAqC;YACrC,2CAA2C,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG;YACrE,0FAA0F;SAC3F,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;QACvC,OAAO,oBAAoB,CAAC,YAAY,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO;YACL,6BAA6B;YAC7B,+IAA+I;YAC/I,2GAA2G;YAC3G,6GAA6G;YAC7G,oBAAoB,CAAC,YAAY,CAAC;SACnC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,KAAqC,EACrC,MAA4B;IAE5B,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC;IACzE,IAAI,MAAM,CAAC,WAAW,KAAK,MAAM;QAAE,OAAO,EAAE,CAAC;IAC7C,IAAI,MAAM,CAAC,WAAW,KAAK,WAAW;QAAE,OAAO,QAAQ,CAAC;IACxD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,mBAAmB,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACzG,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACjF,CAAC;AAED,SAAS,oBAAoB,CAAC,YAAyC;IACrE,MAAM,IAAI,GAAG,YAAY,CAAC,gBAAgB,EAAE,MAAM;QAChD,CAAC,CAAC,kCAAkC,YAAY,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAC/E,CAAC,CAAC,gHAAgH,CAAC;IACrH,OAAO;QACL,mEAAmE;QACnE,oHAAoH;QACpH,sHAAsH;QACtH,IAAI;QACJ,iGAAiG;KAClG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}
+{"version":3,"file":"codeActPrompt.js","sourceRoot":"","sources":["../../../src/codeact/codeActPrompt.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAQxD,MAAM,UAAU,oBAAoB,CAClC,MAA4B,EAC5B,eAA4C,EAAE,EAC9C,eAA0C,QAAQ;IAElD,IAAI,MAAM,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,IAAI,MAAM,CAAC,WAAW,KAAK,MAAM,EAAE,CAAC;YAClC,OAAO,oEAAoE,CAAC;QAC9E,CAAC;QACD,OAAO;YACL,qCAAqC;YACrC,2CAA2C,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG;YACrE,0FAA0F;SAC3F,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IACD,gEAAgE;IAChE,uEAAuE;IACvE,iEAAiE;IACjE,IAAI,YAAY,KAAK,KAAK;QAAE,OAAO,EAAE,CAAC;IACtC,uEAAuE;IACvE,qDAAqD;IACrD,MAAM,SAAS,GAAG,YAAY,KAAK,MAAM;QACvC,CAAC,CAAC,EAAE,GAAG,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE;QACzC,CAAC,CAAC,YAAY,CAAC;IACjB,IAAI,MAAM,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;QACvC,OAAO,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO;YACL,6BAA6B;YAC7B,+IAA+I;YAC/I,2GAA2G;YAC3G,6GAA6G;YAC7G,oBAAoB,CAAC,SAAS,CAAC;SAChC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,KAAqC,EACrC,MAA4B;IAE5B,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,mBAAmB,CAAC,CAAC;IACzE,IAAI,MAAM,CAAC,WAAW,KAAK,MAAM;QAAE,OAAO,EAAE,CAAC;IAC7C,IAAI,MAAM,CAAC,WAAW,KAAK,WAAW;QAAE,OAAO,QAAQ,CAAC;IACxD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,mBAAmB,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACzG,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACjF,CAAC;AAED,SAAS,oBAAoB,CAAC,YAAyC;IACrE,MAAM,IAAI,GAAG,YAAY,CAAC,gBAAgB,EAAE,MAAM;QAChD,CAAC,CAAC,kCAAkC,YAAY,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QAC/E,CAAC,CAAC,gHAAgH,CAAC;IACrH,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE;QACtC,CAAC,CAAC,6GAA6G,YAAY,CAAC,OAAO,EAAE;QACrI,CAAC,CAAC,EAAE,CAAC;IACP,OAAO;QACL,mEAAmE;QACnE,oHAAoH;QACpH,sHAAsH;QACtH,IAAI;QACJ,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrB,iGAAiG;KAClG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/src/codeact/codeActSdk.d.ts

@@ -0,0 +1,22 @@
+import type { AgentToolDefinition } from '../types.js';
+/** Fixed HadamardHost methods the kernel already implements directly. */
+export declare const RESERVED_HOST_METHODS: ReadonlySet<string>;
+/** Default SDK section size cap before folding kicks in. */
+export declare const DEFAULT_MAX_SDK_CHARS = 24000;
+export interface CodeActSdkRenderOptions {
+    /** Fold docstrings (then truncate the tool list) beyond this size. */
+    maxChars?: number;
+}
+/** Deterministic sanitization shared by the renderer and the kernel tool map. */
+export declare function sanitizeCodeActName(name: string): string;
+/**
+ * Render the typed host-tool stubs for the given tools (CodeCell itself is
+ * excluded). Stable byte-for-byte output for a stable tool set: tools are
+ * sorted by name and schema fields render in declaration order.
+ */
+export declare function renderCodeActHostSdk(tools: readonly AgentToolDefinition[], options?: CodeActSdkRenderOptions): string;
+/** Build the collision-safe typed-method dispatch map used by the kernel. */
+export declare function buildCodeActToolNameMap(tools: readonly AgentToolDefinition[]): Record<string, string>;
+/** Render one JSON Schema node as a Python type annotation (bounded depth). */
+export declare function jsonSchemaToPythonType(schema: unknown, depth?: number): string;
+//# sourceMappingURL=codeActSdk.d.ts.map

package/dist/src/codeact/codeActSdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codeActSdk.d.ts","sourceRoot":"","sources":["../../../src/codeact/codeActSdk.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAsBvD,yEAAyE;AACzE,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAEpD,CAAC;AAIH,4DAA4D;AAC5D,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAI5C,MAAM,WAAW,uBAAuB;IACtC,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKxD;AAgBD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,OAAO,GAAE,uBAA4B,GACpC,MAAM,CA6HR;AA2DD,6EAA6E;AAC7E,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,SAAS,mBAAmB,EAAE,GACpC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUxB;AA4CD,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,MAAM,CAoCzE"}

package/dist/src/codeact/codeActSdk.js

@@ -0,0 +1,353 @@
+import { z } from 'zod';
+/**
+ * CodeAct typed host-tool SDK generation: projects host tool schemas into
+ * Python stub text the model programs against inside CodeCell code (the dsh
+ * tools:sdk equivalent for the Python kernel). One source of truth is the
+ * tool definition (inputSchema + outputSchema), so a stub can never drift
+ * from the dispatch surface.
+ *
+ * @module src/codeact/codeActSdk
+ */
+const PYTHON_IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
+const PYTHON_KEYWORDS = new Set([
+    'False', 'None', 'True', 'and', 'as', 'assert', 'async', 'await', 'break',
+    'class', 'continue', 'def', 'del', 'elif', 'else', 'except', 'finally',
+    'for', 'from', 'global', 'if', 'import', 'in', 'is', 'lambda', 'nonlocal',
+    'not', 'or', 'pass', 'raise', 'return', 'try', 'while', 'with', 'yield',
+    'match', 'case', 'type',
+]);
+/** Fixed HadamardHost methods the kernel already implements directly. */
+export const RESERVED_HOST_METHODS = new Set([
+    'call', 'tool', 'tool_schema', 'artifact', 'read', 'write', 'search',
+]);
+/** Nesting cap: beyond this a schema node degrades to a broad type. */
+const MAX_RENDER_DEPTH = 4;
+/** Default SDK section size cap before folding kicks in. */
+export const DEFAULT_MAX_SDK_CHARS = 24_000;
+/** Docstring cap per tool. */
+const MAX_DOC_CHARS = 280;
+/** Deterministic sanitization shared by the renderer and the kernel tool map. */
+export function sanitizeCodeActName(name) {
+    let out = name.replace(/[^A-Za-z0-9_]+/g, '_');
+    if (!/^[A-Za-z_]/.test(out))
+        out = `_${out}`;
+    if (PYTHON_KEYWORDS.has(out))
+        out = `${out}_`;
+    return /^_*$/.test(out) ? 'tool' : out;
+}
+/**
+ * Render the typed host-tool stubs for the given tools (CodeCell itself is
+ * excluded). Stable byte-for-byte output for a stable tool set: tools are
+ * sorted by name and schema fields render in declaration order.
+ */
+export function renderCodeActHostSdk(tools, options = {}) {
+    const maxChars = options.maxChars ?? DEFAULT_MAX_SDK_CHARS;
+    const stubs = [];
+    const reservedNotes = [];
+    const sortedTools = [...tools].sort((left, right) => left.name.localeCompare(right.name));
+    const sanitizedCounts = countDynamicMethodNames(sortedTools);
+    const visibleTools = sortedTools.filter((tool) => tool.name !== 'CodeCell' && tool.name !== 'run_code');
+    const untypedCount = visibleTools.filter((tool) => !tool.outputSchema).length;
+    for (const tool of sortedTools) {
+        if (tool.name === 'CodeCell' || tool.name === 'run_code')
+            continue;
+        const fixedMethodName = FIXED_HELPER_METHODS[tool.name];
+        if (fixedMethodName) {
+            stubs.push({
+                methodName: fixedMethodName,
+                realName: tool.name,
+                signature: renderToolSignature(tool, fixedMethodName),
+                doc: `${collapseDoc(tool.description)} Host tool: ${tool.name}.`,
+                purpose: oneLinePurpose(tool.description),
+            });
+            continue;
+        }
+        const methodName = sanitizeCodeActName(tool.name);
+        if (RESERVED_HOST_METHODS.has(methodName)) {
+            reservedNotes.push({
+                realName: tool.name,
+                note: `# Host tool "${tool.name}" collides with the reserved ${methodName} helper; call hadamard.tool("${tool.name}", {...}) with: ${describeSchema(tool.inputJsonSchema)}.`,
+                purpose: oneLinePurpose(tool.description),
+            });
+            continue;
+        }
+        if ((sanitizedCounts.get(methodName) ?? 0) > 1) {
+            reservedNotes.push({
+                realName: tool.name,
+                note: `# Host tool "${tool.name}" and another host tool share the sanitized Python name ${methodName}; call hadamard.tool("${tool.name}", {...}) with: ${describeSchema(tool.inputJsonSchema)}.`,
+                purpose: oneLinePurpose(tool.description),
+            });
+            continue;
+        }
+        const { omitted } = renderParams(tool.inputJsonSchema);
+        const docParts = [collapseDoc(tool.description), `Host tool: ${tool.name}.`];
+        if (methodName !== tool.name)
+            docParts.push(`Called as hadamard.${methodName}.`);
+        if (omitted.length > 0) {
+            docParts.push(`Not keyword-accessible (invalid Python identifiers): ${omitted.join(', ')}.`);
+        }
+        stubs.push({
+            methodName,
+            realName: tool.name,
+            signature: renderToolSignature(tool, methodName),
+            doc: docParts.join(' '),
+            purpose: oneLinePurpose(tool.description),
+        });
+    }
+    const header = [
+        '# Typed host-tool stubs reachable from CodeCell code through the global',
+        '# `hadamard` object. Signatures are authoritative for parameter names; every',
+        '# method dispatches the matching host tool, and `hadamard.tool("<name>", {...})` stays',
+        '# available for tools without a typed stub.',
+        '# A failed host call raises HadamardToolError with a `tool_name` attribute;',
+        '# catch it to branch on which tool failed.',
+        '# Any tool schema is queryable on demand with hadamard.tool_schema("<ToolName>").',
+        ...(untypedCount > 0
+            ? [`# Degraded typing: ${untypedCount} of ${visibleTools.length} visible tool(s) declare no output schema, so their results are untyped (Any) — treat them as opaque and degrade accordingly.`]
+            : []),
+    ].join('\n');
+    let body = renderStubClass(stubs, reservedNotes, true);
+    if (body.length > maxChars) {
+        body = renderStubClass(stubs, reservedNotes, false);
+    }
+    if (body.length > maxChars) {
+        const truncated = [];
+        let size = 0;
+        for (const stub of stubs) {
+            const line = `    def ${stub.signature}: ...  # ${stub.realName}`;
+            if (size + line.length + 1 > maxChars - 400)
+                break;
+            truncated.push(line);
+            size += line.length + 1;
+        }
+        const omittedIndex = [
+            ...stubs.slice(truncated.length).map(stub => ({ name: stub.realName, purpose: stub.purpose })),
+            ...reservedNotes.map(note => ({ name: note.realName, purpose: note.purpose })),
+        ];
+        const lines = [
+            'class HadamardHost:',
+            '    """Host-tool bridge (truncated typed surface)."""',
+            ...truncated,
+        ];
+        const noteLines = [
+            `    # ${omittedIndex.length} further host tool(s) omitted for prompt budget; the index below keeps every remaining tool discoverable.`,
+            '    # Query any tool schema on demand with hadamard.tool_schema("<ToolName>").',
+        ];
+        const budget = Math.max(0, maxChars - lines.join('\n').length - noteLines.join('\n').length - 2);
+        const indexLines = [];
+        let used = 0;
+        for (const entry of omittedIndex) {
+            const line = `    # ${entry.name} — ${entry.purpose}`;
+            if (used + line.length + 1 > budget)
+                break;
+            indexLines.push(line);
+            used += line.length + 1;
+        }
+        const rest = omittedIndex.slice(indexLines.length).map(entry => entry.name);
+        if (rest.length > 0) {
+            // Discovery floor: every remaining name stays visible in a compact
+            // budget-exempt index (names are short; the cap protects against
+            // doc/schema blowup, which is the actual prompt-flooding risk).
+            const prefix = '    # Compact name index: ';
+            let current = prefix;
+            for (const name of rest) {
+                const piece = (current === prefix ? '' : ', ') + name;
+                if (current.length + piece.length > 96) {
+                    indexLines.push(current);
+                    current = `    # ${name}`;
+                }
+                else {
+                    current += piece;
+                }
+            }
+            indexLines.push(current);
+            indexLines.push('    # (schema on demand: hadamard.tool_schema("<name>"))');
+        }
+        body = [...lines, ...noteLines, ...indexLines].join('\n');
+    }
+    if (body.length === 0)
+        return '';
+    return `${header}\n${body}`;
+}
+function renderStubClass(stubs, reservedNotes, withDocs) {
+    const lines = [
+        'class HadamardHost:',
+        '    """Host-tool bridge (typed surface)."""',
+    ];
+    if (!withDocs) {
+        lines.push('    # Docstrings folded for prompt budget; parameter names remain authoritative.');
+    }
+    for (const stub of stubs) {
+        if (withDocs) {
+            lines.push('');
+            lines.push(`    def ${stub.signature}:`);
+            lines.push(`        """${stub.doc}"""`);
+            lines.push('        ...');
+        }
+        else {
+            lines.push(`    def ${stub.signature}: ...`);
+        }
+    }
+    for (const note of reservedNotes) {
+        lines.push('');
+        lines.push(`    ${note.note}`);
+    }
+    return lines.join('\n');
+}
+/** Fixed kernel helpers whose behavior is wired in the kernel program itself. */
+const FIXED_HELPER_METHODS = {
+    Read: 'read',
+    Write: 'write',
+    Grep: 'search',
+};
+function renderToolSignature(tool, methodName) {
+    const { params } = renderParams(tool.inputJsonSchema);
+    const returnType = tool.outputSchema
+        ? jsonSchemaToPythonType(z.toJSONSchema(tool.outputSchema))
+        : 'Any';
+    return params.length > 0
+        ? `${methodName}(self, ${params.join(', ')}) -> ${returnType}`
+        : `${methodName}(self) -> ${returnType}`;
+}
+function countDynamicMethodNames(tools) {
+    const counts = new Map();
+    for (const tool of tools) {
+        if (tool.name === 'CodeCell' || FIXED_HELPER_METHODS[tool.name])
+            continue;
+        const methodName = sanitizeCodeActName(tool.name);
+        if (RESERVED_HOST_METHODS.has(methodName))
+            continue;
+        counts.set(methodName, (counts.get(methodName) ?? 0) + 1);
+    }
+    return counts;
+}
+/** Build the collision-safe typed-method dispatch map used by the kernel. */
+export function buildCodeActToolNameMap(tools) {
+    const counts = countDynamicMethodNames(tools);
+    const result = {};
+    for (const tool of [...tools].sort((left, right) => left.name.localeCompare(right.name))) {
+        if (tool.name === 'CodeCell' || FIXED_HELPER_METHODS[tool.name])
+            continue;
+        const methodName = sanitizeCodeActName(tool.name);
+        if (RESERVED_HOST_METHODS.has(methodName) || counts.get(methodName) !== 1)
+            continue;
+        result[methodName] = tool.name;
+    }
+    return result;
+}
+function collapseDoc(description) {
+    const collapsed = description.replace(/\s+/g, ' ').trim().replace(/"""/g, "''\"");
+    return collapsed.length > MAX_DOC_CHARS ? `${collapsed.slice(0, MAX_DOC_CHARS - 3)}...` : collapsed;
+}
+/** Compact one-line purpose for the truncated-discovery index. */
+function oneLinePurpose(description) {
+    const collapsed = description.replace(/\s+/g, ' ').trim();
+    return collapsed.length > 90 ? `${collapsed.slice(0, 87)}...` : collapsed;
+}
+function describeSchema(schema) {
+    const record = isRecord(schema) ? schema : {};
+    const properties = isRecord(record.properties) ? record.properties : {};
+    const parts = [];
+    for (const [key, value] of Object.entries(properties)) {
+        parts.push(`${key}: ${jsonSchemaToPythonType(value)}`);
+    }
+    return parts.length > 0 ? parts.join(', ') : jsonSchemaToPythonType(schema);
+}
+function renderParams(schema) {
+    if (!isRecord(schema))
+        return { params: [], omitted: [] };
+    const properties = isRecord(schema.properties) ? schema.properties : {};
+    const required = new Set(Array.isArray(schema.required) ? schema.required.filter((key) => typeof key === 'string') : []);
+    const params = [];
+    const omitted = [];
+    for (const [key, value] of Object.entries(properties)) {
+        if (!PYTHON_IDENTIFIER.test(key)) {
+            omitted.push(key);
+            continue;
+        }
+        const type = jsonSchemaToPythonType(value);
+        if (required.has(key)) {
+            params.push(`${key}: ${type}`);
+        }
+        else {
+            params.push(`${key}: ${type} | None = None`);
+        }
+    }
+    return { params, omitted };
+}
+/** Render one JSON Schema node as a Python type annotation (bounded depth). */
+export function jsonSchemaToPythonType(schema, depth = 0) {
+    if (!isRecord(schema) || depth > MAX_RENDER_DEPTH)
+        return 'Any';
+    if (schema.const !== undefined)
+        return renderLiteral(schema.const);
+    if (Array.isArray(schema.enum) && schema.enum.length > 0) {
+        return renderLiteralUnion(schema.enum);
+    }
+    if (Array.isArray(schema.anyOf) && schema.anyOf.length > 0) {
+        return renderSchemaUnion(schema.anyOf, depth);
+    }
+    if (Array.isArray(schema.oneOf) && schema.oneOf.length > 0) {
+        return renderSchemaUnion(schema.oneOf, depth);
+    }
+    if (Array.isArray(schema.type)) {
+        return renderSchemaUnion(schema.type.map((entry) => ({ type: entry })), depth);
+    }
+    switch (schema.type) {
+        case 'string': return 'str';
+        case 'integer': return 'int';
+        case 'number': return 'float';
+        case 'boolean': return 'bool';
+        case 'null': return 'None';
+        case 'array': {
+            const items = jsonSchemaToPythonType(schema.items, depth + 1);
+            return `list[${items}]`;
+        }
+        case 'object': {
+            if (depth >= MAX_RENDER_DEPTH)
+                return 'dict[str, Any]';
+            const properties = isRecord(schema.properties) ? schema.properties : {};
+            if (Object.keys(properties).length === 0)
+                return 'dict[str, Any]';
+            // Nested objects stay bounded: dict with an item type when homogeneous.
+            const itemTypes = new Set(Object.values(properties).map((entry) => jsonSchemaToPythonType(entry, depth + 1)));
+            if (itemTypes.size === 1)
+                return `dict[str, ${[...itemTypes][0]}]`;
+            return 'dict[str, Any]';
+        }
+        default: return 'Any';
+    }
+}
+function renderSchemaUnion(members, depth) {
+    const types = new Set();
+    for (const member of members.slice(0, 5)) {
+        types.add(jsonSchemaToPythonType(member, depth + 1));
+    }
+    if (members.length > 5)
+        types.add('Any');
+    return types.size === 1 ? [...types][0] : [...types].join(' | ');
+}
+function renderLiteralUnion(values) {
+    const literals = new Set();
+    for (const value of values.slice(0, 6)) {
+        literals.add(renderLiteral(value));
+    }
+    if (values.length > 6)
+        literals.add('Any');
+    return literals.size === 1 ? [...literals][0] : [...literals].join(' | ');
+}
+function renderLiteral(value) {
+    if (value === null)
+        return 'None';
+    if (typeof value === 'string')
+        return `Literal['${value.replace(/\\/g, '\\\\').replace(/'/g, "\\'")}']`;
+    if (typeof value === 'number')
+        return `Literal[${value}]`;
+    if (typeof value === 'boolean')
+        return `Literal[${value ? 'True' : 'False'}]`;
+    return 'Any';
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=codeActSdk.js.map