actoviq-agent-sdk 0.4.16 → 0.4.18

package/CHANGELOG.md

@@ -6,6 +6,41 @@ The format is based on Keep a Changelog, with automated updates from GitHub Rele
 
 ## Unreleased
 
+## v0.4.17 - 2026-08-14
+
+### Fixes
+
+- Keep empty SDK, TUI, and GUI sessions as non-resumable drafts until the first user turn
+- Centralize managed plugin assembly in the SDK runtime and reduce Computer Use/Playwright prompt schemas
+- Apply selected model context windows consistently across all compaction paths
+- Share the context-window selector between the SDK and GUI
+
+**Full Changelog**: https://github.com/DeconBear/hadamard/compare/v0.4.16...v0.4.17
+
+## v0.4.16 - 2026-08-13
+
+### Features
+
+- Add Android companion, Device Link runtime, resumable artifacts, and self-hosted relay transports
+- Rebuild the project document workspace and share workbench tools across TUI and GUI
+- Add Hadamard CodeAct execution and trusted Skill MCP bundles
+- Prefer Claude Code when reused skill names conflict across runtimes
+
+### Fixes
+
+- Keep Device Link inbox commits and remote session cache consistent
+- Isolate GUI conversation switches from in-flight chat runs
+- Unify long-running sessions across TUI and GUI
+- Launch Windows GUI without a terminal window
+- Prevent project toolbar overlap in windowed layouts
+
+### Refactors
+
+- Extract TUI/GUI controllers and conversation runtime ports behind SOLID boundaries
+- Make CodeAct mode-driven and remove legacy design compatibility
+
+**Full Changelog**: https://github.com/DeconBear/hadamard/compare/v0.4.15...v0.4.16
+
 ## v0.4.15 - 2026-08-10
 
 ### Fixes

package/dist/src/cli/hadamard-tui.js

@@ -1,14 +1,5 @@
 #!/usr/bin/env node
-/**
- * Hadamard TUI entry point.
- *
- * Usage: hadamard [work-dir] [--config <path>] [--permission-mode <mode>] [--model <model>]
- *
- * Runtime defaults: default Hadamard settings loading,
- * createHadamardCoreTools({ cwd }), bypassPermissions, and
- * uncapped tool iterations.
- */
-import { runHadamardTui } from '../tui/hadamardTui.js';
+import { printWelcomeSplash } from '../tui/tuiWelcomeBanner.js';
 import { readPackageVersion } from './version.js';
 const PERMISSION_MODES = new Set(['default', 'acceptEdits', 'plan', 'bypassPermissions', 'auto']);
 function parseArgs(argv) {
@@ -79,6 +70,8 @@ if (!process.stdin.isTTY || !process.stdout.isTTY) {
     process.stderr.write('Hadamard TUI requires an interactive terminal (TTY).\n');
     process.exit(1);
 }
+printWelcomeSplash({ version: readPackageVersion(import.meta.url) });
+const { runHadamardTui } = await import('../tui/hadamardTuiController.js');
 runHadamardTui(args).catch((error) => {
     process.stderr.write(`Fatal: ${error.stack ?? error.message}\n`);
     process.exit(1);

package/dist/src/cli/hadamard-tui.js.map

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

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,CA2BR;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,13 +29,10 @@ 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 [
-        'Use the available ordinary JSON tools when they materially advance the task.',
-        'Observe each tool result before choosing the next action, and finish with a direct answer when the task is complete.',
-    ].join('\n');
+    return '';
 }
 export function filterToolsForExecutionPolicy(tools, policy) {
     const ordinaryNames = new Set(policy.ordinaryTools);
@@ -41,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;QACL,8EAA8E;QAC9E,sHAAsH;KACvH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,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"}