@pi-oxide/pi-host-web 0.7.0 → 0.9.0

package/dist/sdk/bindings/host-agent.d.ts

@@ -0,0 +1,16 @@
+import { PersistData, AgentEvent as RawAgentEvent, AgentMessage as WasmAgentMessage } from '../../../pi_host_web.js';
+import { AgentConfig } from '../types';
+export declare class HostAgent {
+    /** @internal */
+    readonly handle: number;
+    readonly sessionId: string | undefined;
+    constructor(handle: number, sessionId?: string);
+    getSessionId(): string | undefined;
+    steer(message: WasmAgentMessage): {
+        events: RawAgentEvent[];
+    };
+    getPersistData(): PersistData;
+    destroy(): void;
+}
+export declare function createHostAgentInstance(config: AgentConfig, sessionState?: PersistData): Promise<HostAgent>;
+//# sourceMappingURL=host-agent.d.ts.map

package/dist/sdk/bindings/host-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-agent.d.ts","sourceRoot":"","sources":["../../../sdk/bindings/host-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAKN,KAAK,WAAW,EAChB,KAAK,UAAU,IAAI,aAAa,EAEhC,KAAK,YAAY,IAAI,gBAAgB,EACrC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/C,qBAAa,SAAS;IACrB,gBAAgB;IAChB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE3B,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAK9C,YAAY,IAAI,MAAM,GAAG,SAAS;IAIlC,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG;QAAE,MAAM,EAAE,aAAa,EAAE,CAAA;KAAE;IAK7D,cAAc,IAAI,WAAW;IAK7B,OAAO;CAGP;AAED,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAoBjH"}

package/dist/sdk/bindings/index.d.ts

@@ -0,0 +1,7 @@
+export { ensureInit, HostError, setLogLevel, toolResult, unwrap, } from './init';
+export { HostAgent, createHostAgentInstance } from './host-agent';
+export { runTurnWithHostAgent } from './turn-loop';
+export { buildToolCallPreparations, toolErrorFromUnknown } from './tool-preparation';
+export { processStepMarkers } from './markers';
+export type { AgentRunConfig, ArtifactStore, LlmStream, TurnResult } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/bindings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../sdk/bindings/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,MAAM,GACN,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,SAAS,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/sdk/bindings/index.js

@@ -0,0 +1,14 @@
+import { H as o, b as a, d as t, i as e, j as n, p as l, r as u, q as p, u as i, v as H, w as g } from "../../index-C8phwA2v.js";
+export {
+  o as HostAgent,
+  a as HostError,
+  t as buildToolCallPreparations,
+  e as createHostAgentInstance,
+  n as ensureInit,
+  l as processStepMarkers,
+  u as runTurnWithHostAgent,
+  p as setLogLevel,
+  i as toolErrorFromUnknown,
+  H as toolResult,
+  g as unwrap
+};

package/dist/sdk/bindings/init.d.ts

@@ -0,0 +1,30 @@
+import { LogLevel } from '../types';
+/** Ensure the WASM module is loaded. Safe to call multiple times. */
+export declare function ensureInit(): Promise<void>;
+/** Set the log level for both JS SDK and WASM core. */
+export declare function setLogLevel(level: LogLevel): void;
+export declare class HostError extends Error {
+    code: string;
+    constructor(code: string, message: string);
+}
+export declare function unwrap(result: {
+    ok: boolean;
+    data?: unknown;
+    error?: {
+        code: string;
+        message: string;
+    };
+}): unknown;
+/** Build a successful tool result payload. */
+export declare function toolResult(text: string, opts?: {
+    terminate?: boolean;
+    details?: Record<string, unknown>;
+}): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    terminate?: boolean;
+    details?: Record<string, unknown>;
+};
+//# sourceMappingURL=init.d.ts.map

package/dist/sdk/bindings/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../sdk/bindings/init.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAI5C,qEAAqE;AACrE,wBAAsB,UAAU,kBAU/B;AAED,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,QAO1C;AAED,qBAAa,SAAU,SAAQ,KAAK;IACnC,IAAI,EAAE,MAAM,CAAC;gBACD,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAKzC;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE;IAC9B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C,GAAG,OAAO,CAKV;AAED,8CAA8C;AAC9C,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAO;aAEnG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;gBAClC,OAAO;cACT,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EAWlC"}

package/dist/sdk/bindings/markers.d.ts

@@ -0,0 +1,9 @@
+import { HostAgent } from './host-agent';
+import { AgentRunConfig } from './types';
+export declare function processStepMarkers(step: {
+    markers?: Array<{
+        type: string;
+        entry_ids?: string[];
+    }>;
+}, hostAgent: HostAgent, config: AgentRunConfig): Promise<void>;
+//# sourceMappingURL=markers.d.ts.map

package/dist/sdk/bindings/markers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markers.d.ts","sourceRoot":"","sources":["../../../sdk/bindings/markers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,wBAAsB,kBAAkB,CACvC,IAAI,EAAE;IAAE,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAA;CAAE,EACjE,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,cAAc,GACpB,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/sdk/bindings/tool-preparation.d.ts

@@ -0,0 +1,12 @@
+import { ToolCall, ToolCallPreparation, ToolError } from '../../../pi_host_web.js';
+import { Logger } from '../types';
+import { AgentRunConfig } from './types';
+export declare function toolErrorFromUnknown(e: unknown): ToolError;
+interface ToolCallPrepResult {
+    items: ToolCallPreparation[];
+    hadError: boolean;
+    errorMessage?: string;
+}
+export declare function buildToolCallPreparations(calls: ToolCall[], hooks: AgentRunConfig["prepareToolCalls"], logger: Logger): Promise<ToolCallPrepResult>;
+export {};
+//# sourceMappingURL=tool-preparation.d.ts.map

package/dist/sdk/bindings/tool-preparation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-preparation.d.ts","sourceRoot":"","sources":["../../../sdk/bindings/tool-preparation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAsBjD,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,GAAG,SAAS,CAQ1D;AAED,UAAU,kBAAkB;IAC3B,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,yBAAyB,CAC9C,KAAK,EAAE,QAAQ,EAAE,EACjB,KAAK,EAAE,cAAc,CAAC,kBAAkB,CAAC,EACzC,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC,kBAAkB,CAAC,CA2C7B"}

package/dist/sdk/bindings/turn-loop.d.ts

@@ -0,0 +1,5 @@
+import { AgentMessage as WasmAgentMessage } from '../../../pi_host_web.js';
+import { HostAgent } from './host-agent';
+import { AgentRunConfig, TurnResult } from './types';
+export declare function runTurnWithHostAgent(hostAgent: HostAgent, message: WasmAgentMessage, config: AgentRunConfig): Promise<TurnResult>;
+//# sourceMappingURL=turn-loop.d.ts.map

package/dist/sdk/bindings/turn-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turn-loop.d.ts","sourceRoot":"","sources":["../../../sdk/bindings/turn-loop.ts"],"names":[],"mappings":"AAAA,OAAO,EAWN,KAAK,YAAY,IAAI,gBAAgB,EACrC,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7D,wBAAsB,oBAAoB,CACzC,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,cAAc,GACpB,OAAO,CAAC,UAAU,CAAC,CA4LrB"}

package/dist/sdk/bindings/types.d.ts

@@ -0,0 +1,60 @@
+import { AgentEvent as RawAgentEvent, LlmChunk, LlmContext, LlmResult, PersistData, ToolCall, ToolDefinition, AgentMessage as WasmAgentMessage } from '../../../pi_host_web.js';
+import { Logger } from '../types';
+export interface ArtifactStore {
+    save(sessionId: string, artifactId: string, content: string): Promise<void>;
+    load(sessionId: string, artifactId: string): Promise<string | null>;
+    search(sessionId: string, query: string): Promise<Array<{
+        id: string;
+        snippet: string;
+        match_count: number;
+    }>>;
+}
+export interface AgentRunConfig {
+    llm: {
+        call(context: LlmContext, signal?: AbortSignal): Promise<LlmStream> | LlmStream;
+        summarize?(messages: WasmAgentMessage[], signal?: AbortSignal): Promise<string>;
+    };
+    tools: Record<string, (call: ToolCall) => Promise<import('../../pi_host_web.js').ToolResult> | import('../../pi_host_web.js').ToolResult>;
+    llmTools?: ToolDefinition[];
+    onEvent?: (event: RawAgentEvent) => void;
+    onMarkers?: (markers: Array<{
+        type: string;
+        entry_ids?: string[];
+    }>) => void;
+    signal?: AbortSignal;
+    onPersist?: (data: PersistData) => Promise<void>;
+    artifactStore?: ArtifactStore;
+    logger?: Logger;
+    prepareToolCalls?: {
+        transform?: (call: ToolCall) => {
+            type: "none";
+        } | {
+            type: "rewrite_args";
+            arguments: unknown;
+        } | Promise<{
+            type: "none";
+        } | {
+            type: "rewrite_args";
+            arguments: unknown;
+        }>;
+        permission?: (call: ToolCall) => {
+            type: "allow";
+        } | {
+            type: "block";
+            reason: string;
+        } | Promise<{
+            type: "allow";
+        } | {
+            type: "block";
+            reason: string;
+        }>;
+    };
+}
+export interface LlmStream {
+    chunks: AsyncIterable<LlmChunk>;
+    result: Promise<LlmResult>;
+}
+export interface TurnResult {
+    aborted: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sdk/bindings/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../sdk/bindings/types.ts"],"names":[],"mappings":"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"}

package/dist/sdk/init.d.ts

@@ -1,30 +1,2 @@
-import { LogLevel } from './types';
-/** Ensure the WASM module is loaded. Safe to call multiple times. */
-export declare function ensureInit(): Promise<void>;
-/** Set the log level for both JS SDK and WASM core. */
-export declare function setLogLevel(level: LogLevel): void;
-export declare class HostError extends Error {
-    code: string;
-    constructor(code: string, message: string);
-}
-export declare function unwrap(result: {
-    ok: boolean;
-    data?: unknown;
-    error?: {
-        code: string;
-        message: string;
-    };
-}): unknown;
-/** Build a successful tool result payload. */
-export declare function toolResult(text: string, opts?: {
-    terminate?: boolean;
-    details?: Record<string, unknown>;
-}): {
-    content: Array<{
-        type: "text";
-        text: string;
-    }>;
-    terminate?: boolean;
-    details?: Record<string, unknown>;
-};
+export { ensureInit, HostError, setLogLevel, toolResult, unwrap, } from './bindings/init';
 //# sourceMappingURL=init.d.ts.map

package/dist/sdk/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../sdk/init.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAI3C,qEAAqE;AACrE,wBAAsB,UAAU,kBAU/B;AAED,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,QAO1C;AAED,qBAAa,SAAU,SAAQ,KAAK;IACnC,IAAI,EAAE,MAAM,CAAC;gBACD,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAKzC;AAED,wBAAgB,MAAM,CAAC,MAAM,EAAE;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAAG,OAAO,CAKlH;AAED,8CAA8C;AAC9C,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAO;aAEnG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;gBAClC,OAAO;cACT,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;EAWlC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../sdk/init.ts"],"names":[],"mappings":"AACA,OAAO,EACN,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,MAAM,GACN,MAAM,oBAAoB,CAAC"}

package/dist/sdk/internal/engine.d.ts

@@ -1,91 +1,4 @@
-import { LlmChunk, LlmContext, LlmResult, PersistData, AgentEvent as RawAgentEvent, ToolCall, ToolDefinition, ToolResult, AgentMessage as WasmAgentMessage } from '../../../pi_host_web.js';
-import { AgentConfig, AgentInput, AgentRunOptions, AgentRunResult, AgentStatus, Logger } from '../types';
-export interface ArtifactStore {
-    save(sessionId: string, artifactId: string, content: string): Promise<void>;
-    load(sessionId: string, artifactId: string): Promise<string | null>;
-    search(sessionId: string, query: string): Promise<Array<{
-        id: string;
-        snippet: string;
-        match_count: number;
-    }>>;
-}
-export interface AgentRunConfig {
-    llm: {
-        call(context: LlmContext, signal?: AbortSignal): Promise<LlmStream> | LlmStream;
-        summarize?(messages: WasmAgentMessage[], signal?: AbortSignal): Promise<string>;
-    };
-    tools: Record<string, (call: ToolCall) => Promise<ToolResult> | ToolResult>;
-    llmTools?: ToolDefinition[];
-    onEvent?: (event: RawAgentEvent) => void;
-    onMarkers?: (markers: Array<{
-        type: string;
-        entry_ids?: string[];
-    }>) => void;
-    signal?: AbortSignal;
-    onPersist?: (data: PersistData) => Promise<void>;
-    artifactStore?: ArtifactStore;
-    logger?: Logger;
-    prepareToolCalls?: {
-        transform?: (call: ToolCall) => {
-            type: "none";
-        } | {
-            type: "rewrite_args";
-            arguments: unknown;
-        } | Promise<{
-            type: "none";
-        } | {
-            type: "rewrite_args";
-            arguments: unknown;
-        }>;
-        permission?: (call: ToolCall) => {
-            type: "allow";
-        } | {
-            type: "block";
-            reason: string;
-        } | Promise<{
-            type: "allow";
-        } | {
-            type: "block";
-            reason: string;
-        }>;
-    };
-}
-export interface LlmStream {
-    chunks: AsyncIterable<LlmChunk>;
-    result: Promise<LlmResult>;
-}
-export interface TurnResult {
-    aborted: boolean;
-}
-export declare class HostAgent {
-    /** @internal */
-    readonly handle: number;
-    readonly sessionId: string | undefined;
-    constructor(handle: number, sessionId?: string);
-    getSessionId(): string | undefined;
-    steer(message: WasmAgentMessage): {
-        events: RawAgentEvent[];
-    };
-    getPersistData(): PersistData;
-    destroy(): void;
-}
-export declare function createHostAgentInstance(config: AgentConfig, sessionState?: PersistData): Promise<HostAgent>;
-export declare function runTurnWithHostAgent(hostAgent: HostAgent, message: WasmAgentMessage, config: AgentRunConfig): Promise<TurnResult>;
-export declare function createEngineAgent(config: AgentConfig, _callbacks: {
-    onEvent: (event: {
-        type: string;
-        payload: unknown;
-    }) => void;
-    onStatus: (status: AgentStatus) => void;
-}): Promise<HostAgent>;
-export declare function destroyEngineAgent(hostAgent: HostAgent): void;
-export declare function runAgentTurn(hostAgent: HostAgent, config: AgentConfig, input: string | AgentInput, options: AgentRunOptions | undefined, signal: AbortSignal, callbacks: {
-    onEvent: (event: {
-        type: string;
-        payload: unknown;
-    }) => void;
-    onStatus: (status: AgentStatus) => void;
-}): Promise<AgentRunResult>;
-export declare function steerAgent(hostAgent: HostAgent, input: string | AgentInput): Promise<void>;
-export declare function resetAgentState(hostAgent: HostAgent): Promise<void>;
+/** @deprecated Import from `../orchestration/agent-engine.ts` instead. */
+export { createEngineAgent, createHostAgentInstance, destroyEngineAgent, HostAgent, resetAgentState, runAgentTurn, runTurnWithHostAgent, steerAgent, } from '../orchestration/agent-engine';
+export type { AgentRunConfig, LlmStream, TurnResult } from '../bindings/types';
 //# sourceMappingURL=engine.d.ts.map

package/dist/sdk/internal/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../sdk/internal/engine.ts"],"names":[],"mappings":"AAIA,OAAO,EAiBN,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,UAAU,IAAI,aAAa,EAGhC,KAAK,QAAQ,EAEb,KAAK,cAAc,EAEnB,KAAK,UAAU,EACf,KAAK,YAAY,IAAI,gBAAgB,EACrC,MAAM,sBAAsB,CAAC;AAI9B,OAAO,KAAK,EACX,WAAW,EACX,UAAU,EAEV,eAAe,EACf,cAAc,EACd,WAAW,EACX,MAAM,EAGN,MAAM,aAAa,CAAC;AASrB,MAAM,WAAW,aAAa;IAC7B,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACpE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;CAC/G;AAED,MAAM,WAAW,cAAc;IAC9B,GAAG,EAAE;QACJ,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;QAChF,SAAS,CAAC,CAAC,QAAQ,EAAE,gBAAgB,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;KAChF,CAAC;IACF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC,CAAC;IAC5E,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACzC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,KAAK,IAAI,CAAC;IAC7E,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE;QAClB,SAAS,CAAC,EAAE,CACX,IAAI,EAAE,QAAQ,KAEZ;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,GAChB;YAAE,IAAI,EAAE,cAAc,CAAC;YAAC,SAAS,EAAE,OAAO,CAAA;SAAE,GAC5C,OAAO,CAAC;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,GAAG;YAAE,IAAI,EAAE,cAAc,CAAC;YAAC,SAAS,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QAC5E,UAAU,CAAC,EAAE,CACZ,IAAI,EAAE,QAAQ,KAEZ;YAAE,IAAI,EAAE,OAAO,CAAA;SAAE,GACjB;YAAE,IAAI,EAAE,OAAO,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,GACjC,OAAO,CAAC;YAAE,IAAI,EAAE,OAAO,CAAA;SAAE,GAAG;YAAE,IAAI,EAAE,OAAO,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAClE,CAAC;CACF;AAED,MAAM,WAAW,SAAS;IACzB,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IAC1B,OAAO,EAAE,OAAO,CAAC;CACjB;AA8BD,qBAAa,SAAS;IACrB,gBAAgB;IAChB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE3B,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;IAK9C,YAAY,IAAI,MAAM,GAAG,SAAS;IAIlC,KAAK,CAAC,OAAO,EAAE,gBAAgB,GAAG;QAAE,MAAM,EAAE,aAAa,EAAE,CAAA;KAAE;IAK7D,cAAc,IAAI,WAAW;IAK7B,OAAO;CAGP;AAMD,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAoBjH;AAED,wBAAsB,oBAAoB,CACzC,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,cAAc,GACpB,OAAO,CAAC,UAAU,CAAC,CAqLrB;AAMD,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE;IACX,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7D,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;CACxC,GACC,OAAO,CAAC,SAAS,CAAC,CAoBpB;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAE7D;AAED,wBAAsB,YAAY,CACjC,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,GAAG,UAAU,EAC1B,OAAO,EAAE,eAAe,GAAG,SAAS,EACpC,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE;IACV,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7D,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;CACxC,GACC,OAAO,CAAC,cAAc,CAAC,CAuHzB;AAED,wBAAsB,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAQhG;AAED,wBAAsB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAGzE"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../sdk/internal/engine.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,OAAO,EACN,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,EAClB,SAAS,EACT,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,UAAU,GACV,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/sdk/orchestration/agent-engine.d.ts

@@ -0,0 +1,24 @@
+import { HostAgent } from '../bindings/host-agent';
+import { AgentConfig, AgentInput, AgentRunOptions, AgentRunResult, AgentStatus } from '../types';
+export type { HostAgent } from '../bindings/host-agent';
+export type { AgentRunConfig, LlmStream, TurnResult } from '../bindings/types';
+export { createHostAgentInstance } from '../bindings/host-agent';
+export { runTurnWithHostAgent } from '../bindings/turn-loop';
+export declare function createEngineAgent(config: AgentConfig, _callbacks: {
+    onEvent: (event: {
+        type: string;
+        payload: unknown;
+    }) => void;
+    onStatus: (status: AgentStatus) => void;
+}): Promise<HostAgent>;
+export declare function destroyEngineAgent(hostAgent: HostAgent): void;
+export declare function runAgentTurn(hostAgent: HostAgent, config: AgentConfig, input: string | AgentInput, options: AgentRunOptions | undefined, signal: AbortSignal, callbacks: {
+    onEvent: (event: {
+        type: string;
+        payload: unknown;
+    }) => void;
+    onStatus: (status: AgentStatus) => void;
+}): Promise<AgentRunResult>;
+export declare function steerAgent(hostAgent: HostAgent, input: string | AgentInput): Promise<void>;
+export declare function resetAgentState(hostAgent: HostAgent): Promise<void>;
+//# sourceMappingURL=agent-engine.d.ts.map

package/dist/sdk/orchestration/agent-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-engine.d.ts","sourceRoot":"","sources":["../../../sdk/orchestration/agent-engine.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2B,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAK/E,OAAO,KAAK,EACX,WAAW,EACX,UAAU,EACV,eAAe,EACf,cAAc,EACd,WAAW,EACX,MAAM,aAAa,CAAC;AAarB,YAAY,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,wBAAsB,iBAAiB,CACtC,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE;IACX,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7D,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;CACxC,GACC,OAAO,CAAC,SAAS,CAAC,CAkBpB;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAE7D;AAED,wBAAsB,YAAY,CACjC,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,GAAG,UAAU,EAC1B,OAAO,EAAE,eAAe,GAAG,SAAS,EACpC,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE;IACV,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7D,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;CACxC,GACC,OAAO,CAAC,cAAc,CAAC,CAgHzB;AAED,wBAAsB,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAOhG;AAED,wBAAsB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzE"}

package/dist/sdk/orchestration/config-builders.d.ts

@@ -0,0 +1,13 @@
+import { ContextProjectionBudget, Model, AgentMessage as WasmAgentMessage } from '../../../pi_host_web.js';
+import { AgentConfig, AgentInput, AgentMessage, AgentModel, AgentTools } from '../types';
+import { ArtifactStore } from '../bindings/types';
+export declare function normalizeTools(tools: AgentTools | AgentTools[] | undefined): AgentTools[];
+export declare function buildContextBudget(context?: import('../types.ts').AgentContextPolicy): ContextProjectionBudget;
+export declare function buildModelOptions(model: AgentModel): Model;
+export declare function buildArtifactStore(config: AgentConfig): ArtifactStore | undefined;
+export declare function mergeMetadata(input: string | AgentInput, runMetadata?: Record<string, unknown>): Record<string, unknown> | undefined;
+export declare function buildUserMessage(input: string | AgentInput): WasmAgentMessage;
+export declare function convertWasmMessagesToAgentMessages(messages: WasmAgentMessage[]): AgentMessage[];
+declare function stableMessageId(msg: WasmAgentMessage): string;
+export { stableMessageId };
+//# sourceMappingURL=config-builders.d.ts.map

package/dist/sdk/orchestration/config-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-builders.d.ts","sourceRoot":"","sources":["../../../sdk/orchestration/config-builders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,uBAAuB,EAAE,KAAK,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEtH,OAAO,KAAK,EAEX,WAAW,EACX,UAAU,EACV,YAAY,EACZ,UAAU,EACV,UAAU,EAEV,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,EAAE,GAAG,SAAS,GAAG,UAAU,EAAE,CAIzF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,OAAO,aAAa,EAAE,kBAAkB,GAAG,uBAAuB,CAO9G;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,CAiB1D;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa,GAAG,SAAS,CAsCjF;AAED,wBAAgB,aAAa,CAC5B,KAAK,EAAE,MAAM,GAAG,UAAU,EAC1B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAIrC;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,gBAAgB,CAwB7E;AAED,wBAAgB,kCAAkC,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,YAAY,EAAE,CAa/F;AAED,iBAAS,eAAe,CAAC,GAAG,EAAE,gBAAgB,GAAG,MAAM,CAUtD;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/sdk/orchestration/model-adapter.d.ts

@@ -0,0 +1,10 @@
+import { AgentMessage as WasmAgentMessage } from '../../../pi_host_web.js';
+import { AgentModel, ModelEvent, ModelResponse, TokenUsage } from '../types';
+import { LlmStream } from '../bindings/types';
+export declare function toWasmStopReason(reason: ModelResponse["stopReason"]): "end_turn" | "tool_use" | "max_tokens" | "error";
+export declare function modelStreamToLlmStream(stream: AsyncIterable<ModelEvent>, signal: AbortSignal, runState: {
+    usage?: TokenUsage;
+}): LlmStream;
+export declare function modelResponseToLlmStream(response: ModelResponse, signal: AbortSignal): LlmStream;
+export declare function defaultSummarizer(model: AgentModel, messages: WasmAgentMessage[], signal?: AbortSignal): Promise<string>;
+//# sourceMappingURL=model-adapter.d.ts.map

package/dist/sdk/orchestration/model-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-adapter.d.ts","sourceRoot":"","sources":["../../../sdk/orchestration/model-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgC,YAAY,IAAI,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC3G,OAAO,KAAK,EAAqB,UAAU,EAAE,UAAU,EAAgB,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEtH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAiBtD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,OAAO,CAWtH;AAED,wBAAgB,sBAAsB,CACrC,MAAM,EAAE,aAAa,CAAC,UAAU,CAAC,EACjC,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE;IAAE,KAAK,CAAC,EAAE,UAAU,CAAA;CAAE,GAC9B,SAAS,CAyHX;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,CA+DhG;AAED,wBAAsB,iBAAiB,CACtC,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,MAAM,CAAC,CAcjB"}

package/package.json

@@ -5,7 +5,7 @@
     "Irving Ou <irving@pi-oxide.dev>"
   ],
   "description": "WASM host for pi-core. Browser FileSystem Access API, fetch(), JS event loop.",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -18,12 +18,31 @@
     "pi_host_web.d.ts",
     "README.md",
     "LICENSE",
+    "dist/bindings.d.ts",
+    "dist/index-C8phwA2v.js",
+    "dist/index-CAp51VNq.js",
+    "dist/index-Is-rTdaY.js",
     "dist/index.d.ts",
     "dist/index.js",
     "dist/sdk/agent.d.ts",
     "dist/sdk/agent.d.ts.map",
     "dist/sdk/artifacts.d.ts",
     "dist/sdk/artifacts.d.ts.map",
+    "dist/sdk/bindings/host-agent.d.ts",
+    "dist/sdk/bindings/host-agent.d.ts.map",
+    "dist/sdk/bindings/index.d.ts",
+    "dist/sdk/bindings/index.d.ts.map",
+    "dist/sdk/bindings/index.js",
+    "dist/sdk/bindings/init.d.ts",
+    "dist/sdk/bindings/init.d.ts.map",
+    "dist/sdk/bindings/markers.d.ts",
+    "dist/sdk/bindings/markers.d.ts.map",
+    "dist/sdk/bindings/tool-preparation.d.ts",
+    "dist/sdk/bindings/tool-preparation.d.ts.map",
+    "dist/sdk/bindings/turn-loop.d.ts",
+    "dist/sdk/bindings/turn-loop.d.ts.map",
+    "dist/sdk/bindings/types.d.ts",
+    "dist/sdk/bindings/types.d.ts.map",
     "dist/sdk/context.d.ts",
     "dist/sdk/context.d.ts.map",
     "dist/sdk/errors.d.ts",
@@ -66,6 +85,12 @@
     "dist/sdk/internal/util/types.d.ts.map",
     "dist/sdk/model.d.ts",
     "dist/sdk/model.d.ts.map",
+    "dist/sdk/orchestration/agent-engine.d.ts",
+    "dist/sdk/orchestration/agent-engine.d.ts.map",
+    "dist/sdk/orchestration/config-builders.d.ts",
+    "dist/sdk/orchestration/config-builders.d.ts.map",
+    "dist/sdk/orchestration/model-adapter.d.ts",
+    "dist/sdk/orchestration/model-adapter.d.ts.map",
     "dist/sdk/snapshot.d.ts",
     "dist/sdk/snapshot.d.ts.map",
     "dist/sdk/stores.d.ts",
@@ -85,6 +110,10 @@
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
     },
+    "./bindings": {
+      "import": "./dist/sdk/bindings/index.js",
+      "types": "./dist/sdk/bindings/index.d.ts"
+    },
     "./raw": {
       "import": "./pi_host_web.js",
       "types": "./pi_host_web.d.ts"

package/pi_host_web.d.ts

@@ -113,7 +113,7 @@ export interface LlmContext {
 export interface LlmError {
     code: string;
     message: string;
-    details?: Value;
+    details?: unknown;
 }
 
 export interface Model {
@@ -144,8 +144,8 @@ export interface ModelCost {
 }
 
 export interface PersistData {
-    T?: Value;
-    A?: Value;
+    T?: unknown[];
+    A?: Record<string, unknown>;
     turn_number?: number;
     host_artifacts?: [string, string][];
     budget?: ContextProjectionBudget;
@@ -176,6 +176,12 @@ export interface ToolCall {
     arguments: ToolArguments;
 }
 
+export interface ToolCallPreparation {
+    tool_call_id: ToolCallId;
+    transform: ToolCallTransform;
+    permission: ToolCallPermission;
+}
+
 export interface ToolDefinition {
     name: ToolName;
     label: string;
@@ -231,7 +237,7 @@ export interface UserMessage {
     timestamp: number;
 }
 
-export type AgentEvent = { type: "agent_start" } | { type: "agent_end" } | { type: "turn_start" } | { type: "turn_end"; message: AgentMessage; tool_results: ToolResultMessage[] } | { type: "message_start"; message: AgentMessage } | { type: "message_update"; message: AgentMessage; delta: ContentDelta } | { type: "message_end"; message: AgentMessage } | { type: "tool_execution_start"; tool_call_id: ToolCallId; tool_name: ToolName; args?: ToolArguments } | { type: "tool_execution_update"; tool_call_id: ToolCallId; stream: ToolOutputStream; chunk: string; sequence: number; timestamp: number } | { type: "tool_execution_end"; tool_call_id: ToolCallId; result: ToolResult; is_error: boolean } | { type: "tool_execution_cancelled"; tool_call_id: ToolCallId; reason: CancelReason } | { type: "queue_update"; steer: AgentMessage[]; follow_up: AgentMessage[] } | { type: "save_point"; had_pending_writes: boolean } | { type: "settled" };
+export type AgentEvent = { type: "agent_start" } | { type: "agent_end" } | { type: "turn_start" } | { type: "turn_end"; message: AgentMessage; tool_results: ToolResultMessage[] } | { type: "message_start"; message: AgentMessage } | { type: "message_update"; message: AgentMessage; delta: ContentDelta } | { type: "message_end"; message: AgentMessage } | { type: "tool_execution_start"; tool_call_id: ToolCallId; tool_name: ToolName; args?: ToolArguments } | { type: "tool_execution_update"; tool_call_id: ToolCallId; stream: ToolOutputStream; chunk: string; sequence: number; timestamp: number } | { type: "tool_execution_end"; tool_call_id: ToolCallId; tool_name: ToolName; result: ToolResult; args?: ToolArguments; is_error: boolean } | { type: "tool_execution_cancelled"; tool_call_id: ToolCallId; reason: CancelReason } | { type: "queue_update"; steer: AgentMessage[]; follow_up: AgentMessage[] } | { type: "save_point"; had_pending_writes: boolean } | { type: "settled" };
 
 export type AgentMessage = ({ role: "user" } & UserMessage) | ({ role: "assistant" } & AssistantMessage) | ({ role: "tool_result" } & ToolResultMessage);
 
@@ -243,15 +249,15 @@ export type ChangeMarkerDto = { type: "compaction_applied" } | { type: "new_arti
 
 export type Content = ({ type: "text" } & TextContent) | ({ type: "image" } & ImageContent) | ({ type: "tool_call" } & ToolCall);
 
-export type ContentDelta = { kind: "text_start" } | { kind: "text_delta"; text: string } | { kind: "text_end" } | { kind: "thinking_start" } | { kind: "thinking_delta"; text: string } | { kind: "thinking_end" } | { kind: "tool_call_start"; tool_call: ToolCall } | { kind: "tool_call_delta"; tool_call_id: ToolCallId; delta: Value } | { kind: "tool_call_end"; tool_call_id: ToolCallId };
+export type ContentDelta = { kind: "text_start" } | { kind: "text_delta"; text: string } | { kind: "text_end" } | { kind: "thinking_start" } | { kind: "thinking_delta"; text: string } | { kind: "thinking_end" } | { kind: "tool_call_start"; tool_call: ToolCall } | { kind: "tool_call_delta"; tool_call_id: ToolCallId; delta: Record<string, unknown> } | { kind: "tool_call_end"; tool_call_id: ToolCallId };
 
 export type ExecutionMode = "parallel" | "sequential";
 
-export type HostDirective = { type: "stream_llm"; context: LlmContext } | { type: "execute_tools"; calls: ToolCall[] } | { type: "cancel_tools"; tool_call_ids: ToolCallId[]; reason: CancelReason } | { type: "persist" } | { type: "summarize"; context: LlmContext } | { type: "finished" } | { type: "wait_for_input"; mode: WaitMode };
+export type HostDirective = { type: "stream_llm"; context: LlmContext } | { type: "prepare_tool_calls"; calls: ToolCall[] } | { type: "execute_tools"; calls: ToolCall[] } | { type: "cancel_tools"; tool_call_ids: ToolCallId[]; reason: CancelReason } | { type: "persist" } | { type: "summarize"; context: LlmContext } | { type: "finished" } | { type: "wait_for_input"; mode: WaitMode };
 
-export type JsonSchema = Value;
+export type JsonSchema = Record<string, unknown>;
 
-export type LlmChunk = ({ kind: "start" } & {} & AssistantMessage) | { kind: "text_delta"; text: string } | { kind: "thinking_delta"; text: string } | { kind: "tool_call_delta"; tool_call_id: ToolCallId; delta: Value } | { kind: "done" } | { kind: "error"; message: string };
+export type LlmChunk = ({ kind: "start" } & {} & AssistantMessage) | { kind: "text_delta"; text: string } | { kind: "thinking_delta"; text: string } | { kind: "tool_call_delta"; tool_call_id: ToolCallId; delta: Record<string, unknown> } | { kind: "done" } | { kind: "error"; message: string };
 
 export type LlmResult = { Ok: AssistantMessage } | { Err: { error: LlmError; aborted: boolean } };
 
@@ -271,11 +277,15 @@ export type StopReason = "end_turn" | "max_tokens" | "tool_use" | "aborted" | "e
 
 export type ThinkingLevel = "off" | "minimal" | "low" | "medium" | "high" | "xhigh";
 
-export type ToolArguments = Value;
+export type ToolArguments = unknown;
 
 export type ToolCallId = string;
 
-export type ToolDetails = Value;
+export type ToolCallPermission = { type: "allow" } | { type: "block"; reason: string };
+
+export type ToolCallTransform = { type: "none" } | { type: "rewrite_args"; arguments: ToolArguments };
+
+export type ToolDetails = Record<string, unknown>;
 
 export type ToolName = string;
 
@@ -312,6 +322,8 @@ export function hostFeedLlmChunk(handle: number, chunk: LlmChunk): TurnResultRes
 
 export function hostLlmDone(handle: number, result: LlmResult): TurnResultResult;
 
+export function hostPrepareToolCalls(handle: number, preparations_json: string): TurnResultResult;
+
 export function hostReadArtifact(handle: number, artifact_id: string): string;
 
 export function hostReset(handle: number): EmptyResult;
@@ -349,7 +361,6 @@ export interface InitOutput {
     readonly hostSearchArtifacts: (a: number, b: number, c: number) => [number, number, number];
     readonly restoreHostState: (a: any) => any;
     readonly restoreHostStateFromJson: (a: number, b: number) => any;
-    readonly setLogLevel: (a: number, b: number) => void;
     readonly createHostAgent: (a: any, b: any) => any;
     readonly destroyHostAgent: (a: number) => any;
     readonly getHostAgentPersistData: (a: number) => any;
@@ -358,6 +369,7 @@ export interface InitOutput {
     readonly hostContinueTurn: (a: number) => any;
     readonly hostFeedLlmChunk: (a: number, b: any) => any;
     readonly hostLlmDone: (a: number, b: any) => any;
+    readonly hostPrepareToolCalls: (a: number, b: number, c: number) => any;
     readonly hostReset: (a: number) => any;
     readonly hostSteer: (a: number, b: any) => any;
     readonly hostToolCancelled: (a: number, b: number, c: number, d: any) => any;
@@ -365,6 +377,7 @@ export interface InitOutput {
     readonly hostToolFailed: (a: number, b: any, c: any) => any;
     readonly restoreHostAgent: (a: any, b: any) => any;
     readonly startTurn: (a: number, b: any) => any;
+    readonly setLogLevel: (a: number, b: number) => void;
     readonly __wbindgen_malloc: (a: number, b: number) => number;
     readonly __wbindgen_realloc: (a: number, b: number, c: number, d: number) => number;
     readonly __wbindgen_free: (a: number, b: number, c: number) => void;

package/pi_host_web.js

@@ -128,6 +128,18 @@ export function hostLlmDone(handle, result) {
     return ret;
 }
 
+/**
+ * @param {number} handle
+ * @param {string} preparations_json
+ * @returns {TurnResultResult}
+ */
+export function hostPrepareToolCalls(handle, preparations_json) {
+    const ptr0 = passStringToWasm0(preparations_json, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.hostPrepareToolCalls(handle, ptr0, len0);
+    return ret;
+}
+
 /**
  * @param {number} handle
  * @param {string} artifact_id