@pi-oxide/pi-host-web 0.4.0 → 0.5.0

package/package.json

@@ -5,64 +5,20 @@
     "Irving Ou <irving@pi-oxide.dev>"
   ],
   "description": "WASM host for pi-core. Browser FileSystem Access API, fetch(), JS event loop.",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/pi-oxide/pi-oxide"
+    "url": "git+https://github.com/pi-oxide/pi-oxide.git"
   },
   "files": [
     "pi_host_web_bg.wasm",
     "pi_host_web.js",
-    "pi_host_web.d.ts",
-    "sdk/index.js",
-    "sdk/index.d.ts",
-    "sdk/agent.ts",
-    "sdk/artifacts.ts",
-    "sdk/context.ts",
-    "sdk/errors.ts",
-    "sdk/events.ts",
-    "sdk/index.ts",
-    "sdk/init.ts",
-    "sdk/internal/engine.ts",
-    "sdk/internal/events.ts",
-    "sdk/internal/providers/anthropic.ts",
-    "sdk/internal/providers/openai.ts",
-    "sdk/internal/providers/types.ts",
-    "sdk/internal/stores/indexedDb.ts",
-    "sdk/internal/stores/persistence.ts",
-    "sdk/internal/tools/artifact.ts",
-    "sdk/internal/tools/browser.ts",
-    "sdk/internal/tools/browserRuntime.ts",
-    "sdk/internal/tools/liveRuntime.ts",
-    "sdk/internal/tools/registry.ts",
-    "sdk/internal/tools/service.ts",
-    "sdk/model.ts",
-    "sdk/react/index.ts",
-    "sdk/react/useAgent.ts",
-    "sdk/snapshot.ts",
-    "sdk/stores.ts",
-    "sdk/tools.ts",
-    "sdk/types.ts"
+    "pi_host_web.d.ts"
   ],
   "main": "pi_host_web.js",
   "types": "pi_host_web.d.ts",
   "sideEffects": [
     "./snippets/*"
-  ],
-  "exports": {
-    ".": {
-      "import": "./sdk/index.ts",
-      "types": "./sdk/index.ts"
-    },
-    "./raw": {
-      "import": "./pi_host_web.js",
-      "types": "./pi_host_web.d.ts"
-    },
-    "./react": {
-      "import": "./sdk/react/index.ts",
-      "types": "./sdk/react/index.ts"
-    },
-    "./package.json": "./package.json"
-  }
+  ]
 }

package/pi_host_web.d.ts

@@ -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);
 
@@ -247,7 +253,7 @@ export type ContentDelta = { kind: "text_start" } | { kind: "text_delta"; text:
 
 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;
 
@@ -275,6 +281,10 @@ export type ToolArguments = Value;
 
 export type ToolCallId = string;
 
+export type ToolCallPermission = { type: "allow" } | { type: "block"; reason: string };
+
+export type ToolCallTransform = { type: "none" } | { type: "rewrite_args"; arguments: ToolArguments };
+
 export type ToolDetails = Value;
 
 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;
@@ -324,6 +336,8 @@ export function hostToolCancelled(handle: number, tool_call_id: string, reason:
 
 export function hostToolDone(handle: number, id: ToolCallId, result: ToolResult): TurnResultResult;
 
+export function hostToolFailed(handle: number, id: ToolCallId, error: ToolError): TurnResultResult;
+
 export function restoreHostAgent(options: AgentOptions, data: PersistData): CreateHostAgentResult;
 
 export function restoreHostState(data: PersistData): CreateHostStateResult;
@@ -343,10 +357,11 @@ export interface InitOutput {
     readonly estimateTokens: (a: any) => any;
     readonly estimateTokensForText: (a: number, b: number) => any;
     readonly getHostStatePersistData: (a: number) => any;
-    readonly hostReadArtifact: (a: number, b: number, c: number) => [number, number, number, number];
-    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 hostReadArtifact: (a: number, b: number, c: number) => [number, number, number, number];
+    readonly hostSearchArtifacts: (a: number, b: number, c: number) => [number, number, number];
     readonly createHostAgent: (a: any, b: any) => any;
     readonly destroyHostAgent: (a: number) => any;
     readonly getHostAgentPersistData: (a: number) => any;
@@ -355,13 +370,14 @@ 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;
     readonly hostToolDone: (a: number, b: any, c: any) => any;
+    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
@@ -212,6 +224,17 @@ export function hostToolDone(handle, id, result) {
     return ret;
 }
 
+/**
+ * @param {number} handle
+ * @param {ToolCallId} id
+ * @param {ToolError} error
+ * @returns {TurnResultResult}
+ */
+export function hostToolFailed(handle, id, error) {
+    const ret = wasm.hostToolFailed(handle, id, error);
+    return ret;
+}
+
 /**
  * @param {AgentOptions} options
  * @param {PersistData} data
@@ -662,4 +685,4 @@ async function __wbg_init(module_or_path) {
     return __wbg_finalize_init(instance, module);
 }
 
-export { initSync, __wbg_init as default };
+export { __wbg_init as default, initSync };

package/sdk/agent.ts

@@ -1,274 +0,0 @@
-// Public Agent class — the primary SDK surface.
-// Thin facade over the internal engine. No WASM imports here.
-
-import { EventEmitter } from "./events.ts";
-import type {
-  AgentConfig,
-  AgentInput,
-  AgentRunOptions,
-  AgentRunResult,
-  AgentEventName,
-  AgentEventHandler,
-  AgentStatus,
-  Unsubscribe,
-  AgentError,
-} from "./types.ts";
-import { createAgentError } from "./errors.ts";
-import type { HostAgent } from "./internal/engine.ts";
-import {
-  runAgentTurn,
-  resetAgentState,
-  steerAgent,
-  createEngineAgent,
-  destroyEngineAgent,
-} from "./internal/engine.ts";
-
-export class Agent {
-  private config: AgentConfig;
-  private emitter: EventEmitter;
-  private status: AgentStatus = { state: "idle" };
-  private currentRun: Promise<AgentRunResult> | null = null;
-  private currentAbortController: AbortController | null = null;
-  private disposed = false;
-  private engineAgent: HostAgent | null = null;
-
-  constructor(config: AgentConfig) {
-    this.config = config;
-    this.emitter = new EventEmitter();
-  }
-
-  on<E extends AgentEventName>(
-    event: E,
-    handler: AgentEventHandler<E>,
-  ): Unsubscribe {
-    if (this.disposed) {
-      return () => {};
-    }
-    return this.emitter.on(event, handler);
-  }
-
-  async run(
-    input: string | AgentInput,
-    options?: AgentRunOptions,
-  ): Promise<AgentRunResult> {
-    if (this.disposed) {
-      const error = createAgentError(
-        "agent_disposed",
-        "Agent has been disposed",
-        { recoverable: false },
-      );
-      const result: AgentRunResult = {
-        status: "failed",
-        text: "",
-        toolCalls: [],
-        artifacts: [],
-        error,
-      };
-      this.emitter.emit("error", error);
-      this.emitter.emit("status", { state: "failed", message: error.message });
-      this.emitter.emit("done", result);
-      return result;
-    }
-
-    if (this.currentRun) {
-      const error = createAgentError(
-        "agent_busy",
-        "Agent is already running a turn",
-        { recoverable: true },
-      );
-      const result: AgentRunResult = {
-        status: "failed",
-        text: "",
-        toolCalls: [],
-        artifacts: [],
-        error,
-      };
-      this.emitter.emit("error", error);
-      this.emitter.emit("status", { state: "failed", message: error.message });
-      this.emitter.emit("done", result);
-      return result;
-    }
-
-    const abortController = new AbortController();
-    this.currentAbortController = abortController;
-
-    // Merge external signal if provided
-    if (options?.signal) {
-      if (options.signal.aborted) {
-        abortController.abort(options.signal.reason);
-      } else {
-        options.signal.addEventListener(
-          "abort",
-          () => {
-            abortController.abort(options.signal!.reason);
-          },
-          { once: true },
-        );
-      }
-    }
-
-    const runPromise = this._doRun(input, options, abortController.signal);
-    this.currentRun = runPromise;
-
-    try {
-      const result = await runPromise;
-      this.emitter.emit("done", result);
-      return result;
-    } catch (e) {
-      // Safety net: convert any unexpected throw to a failed result
-      const error = createAgentError(
-        "internal_error",
-        e instanceof Error ? e.message : String(e),
-        { cause: e, recoverable: false },
-      );
-      const failedResult: AgentRunResult = {
-        status: "failed",
-        text: "",
-        toolCalls: [],
-        artifacts: [],
-        error,
-      };
-      this.emitter.emit("error", error);
-      this.emitter.emit("status", { state: "failed", message: error.message });
-      this.emitter.emit("done", failedResult);
-      return failedResult;
-    } finally {
-      this.currentRun = null;
-      this.currentAbortController = null;
-    }
-  }
-
-  private async _doRun(
-    input: string | AgentInput,
-    options: AgentRunOptions | undefined,
-    signal: AbortSignal,
-  ): Promise<AgentRunResult> {
-    // Lazy initialization on first run
-    if (!this.engineAgent) {
-      this.engineAgent = await createEngineAgent(this.config, {
-        onEvent: (event) => this.emitter.emit(event.type as AgentEventName, event.payload),
-        onStatus: (status) => {
-          this.status = status;
-          this.emitter.emit("status", status);
-        },
-      });
-    }
-
-    try {
-      return await runAgentTurn(
-        this.engineAgent,
-        this.config,
-        input,
-        options,
-        signal,
-        {
-          onEvent: (event) =>
-            this.emitter.emit(event.type as AgentEventName, event.payload),
-          onStatus: (status) => {
-            this.status = status;
-            this.emitter.emit("status", status);
-          },
-        },
-      );
-    } catch (e) {
-      const isAbort =
-        signal.aborted ||
-        (e instanceof Error && e.name === "AbortError") ||
-        (e instanceof Error && e.message.includes("user_aborted"));
-
-      if (isAbort) {
-        const abortedResult: AgentRunResult = {
-          status: "aborted",
-          text: "",
-          toolCalls: [],
-          artifacts: [],
-        };
-        this.emitter.emit("status", {
-          state: "aborted",
-          message: "Stopped by user",
-        });
-        return abortedResult;
-      }
-
-      const code =
-        e instanceof Error && "code" in e && typeof (e as { code: unknown }).code === "string"
-          ? ((e as { code: string }).code as AgentError["code"])
-          : "internal_error";
-      const error = createAgentError(
-        code,
-        e instanceof Error ? e.message : String(e),
-        { cause: e, recoverable: false },
-      );
-      const failedResult: AgentRunResult = {
-        status: "failed",
-        text: "",
-        toolCalls: [],
-        artifacts: [],
-        error,
-      };
-      this.emitter.emit("error", error);
-      this.emitter.emit("status", { state: "failed", message: error.message });
-      return failedResult;
-    }
-  }
-
-  stop(reason?: string): void {
-    if (this.disposed || !this.currentAbortController) return;
-    this.currentAbortController.abort(reason ?? "user-requested");
-  }
-
-  async steer(input: string | AgentInput): Promise<void> {
-    if (this.disposed) {
-      throw createAgentError(
-        "agent_disposed",
-        "Agent has been disposed",
-        { recoverable: false },
-      );
-    }
-    if (!this.engineAgent) {
-      throw createAgentError(
-        "agent_not_initialized",
-        "Agent has not been run yet",
-        { recoverable: true },
-      );
-    }
-    return steerAgent(this.engineAgent, input);
-  }
-
-  async reset(): Promise<void> {
-    if (this.disposed) {
-      throw createAgentError(
-        "agent_disposed",
-        "Agent has been disposed",
-        { recoverable: false },
-      );
-    }
-    if (this.engineAgent) {
-      await resetAgentState(this.engineAgent);
-      this.engineAgent = null;
-    }
-    this.currentRun = null;
-    this.currentAbortController = null;
-    this.status = { state: "idle" };
-    this.emitter.emit("status", this.status);
-  }
-
-  dispose(): void {
-    if (this.disposed) return;
-    this.disposed = true;
-    if (this.currentAbortController) {
-      this.currentAbortController.abort("disposed");
-      this.currentAbortController = null;
-    }
-    if (this.engineAgent) {
-      destroyEngineAgent(this.engineAgent);
-      this.engineAgent = null;
-    }
-    this.emitter.clear();
-    this.currentRun = null;
-  }
-
-  getStatus(): AgentStatus {
-    return this.status;
-  }
-}

package/sdk/artifacts.ts

@@ -1,35 +0,0 @@
-// Artifact types for the pi-oxide SDK.
-// These are public objects, not leaked host internals.
-
-export interface AgentArtifact {
-  id: string;
-  kind: "text" | "json" | "binary";
-  content: string | Uint8Array | unknown;
-  mimeType?: string;
-  title?: string;
-  metadata?: Record<string, unknown>;
-  createdAt: number;
-}
-
-export interface AgentArtifactRef {
-  id: string;
-  kind: AgentArtifact["kind"];
-  title?: string;
-  mimeType?: string;
-}
-
-export interface ArtifactPolicy {
-  mode: "inline" | "external";
-}
-
-export interface ArtifactSearchQuery {
-  text: string;
-  limit?: number;
-}
-
-export interface ArtifactSearchResult {
-  artifact: AgentArtifactRef;
-  snippet?: string;
-  score?: number;
-  matchCount?: number;
-}

package/sdk/context.ts

@@ -1,4 +0,0 @@
-// Context policy types for the pi-oxide SDK.
-// Re-exported from types.ts for a cleaner public API surface.
-
-export type { AgentContextPolicy, AgentSummarizer } from "./types.ts";

package/sdk/errors.ts

@@ -1,24 +0,0 @@
-// AgentError interface and factory.
-// AgentError is an interface, NOT a class — it is a plain object.
-
-import type { AgentError } from "./types.ts";
-
-export type { AgentError } from "./types.ts";
-
-export function createAgentError(
-  code: AgentError["code"],
-  message: string,
-  options?: {
-    cause?: unknown;
-    recoverable?: boolean;
-    metadata?: Record<string, unknown>;
-  },
-): AgentError {
-  return {
-    code,
-    message,
-    cause: options?.cause,
-    recoverable: options?.recoverable ?? false,
-    metadata: options?.metadata,
-  };
-}

package/sdk/events.ts

@@ -1,52 +0,0 @@
-// Lightweight, type-safe EventEmitter (not Node's).
-// Maps event names to typed handlers using the SDK's AgentEventName union.
-
-import type { AgentEventName, AgentEventHandler } from "./types.ts";
-
-type AnyHandler = (payload: unknown) => void;
-
-export class EventEmitter {
-  private handlers: Partial<Record<AgentEventName, Set<AnyHandler>>> = {};
-
-  on<E extends AgentEventName>(
-    event: E,
-    handler: AgentEventHandler<E>,
-  ): () => void {
-    const set = (this.handlers[event] ??= new Set()) as Set<AnyHandler>;
-    set.add(handler as AnyHandler);
-
-    return () => {
-      set.delete(handler as AnyHandler);
-      if (set.size === 0) {
-        delete this.handlers[event];
-      }
-    };
-  }
-
-  off<E extends AgentEventName>(
-    event: E,
-    handler: AgentEventHandler<E>,
-  ): void {
-    const set = this.handlers[event];
-    if (!set) return;
-    set.delete(handler as AnyHandler);
-    if (set.size === 0) {
-      delete this.handlers[event];
-    }
-  }
-
-  emit<E extends AgentEventName>(
-    event: E,
-    payload: Parameters<AgentEventHandler<E>>[0],
-  ): void {
-    const set = this.handlers[event];
-    if (!set) return;
-    for (const handler of set) {
-      handler(payload);
-    }
-  }
-
-  clear(): void {
-    this.handlers = {};
-  }
-}

package/sdk/index.d.ts

@@ -1,29 +0,0 @@
-/**
- * High-level JS SDK for @pi-oxide/pi-host-web.
- *
- * Re-exports all raw types so consumers never need to import from ./raw.
- */
-
-export * from "../pi_host_web";
-
-export declare function ensureInit(): Promise<void>;
-
-export declare function toolResult(
-	text: string,
-	opts?: { terminate?: boolean; details?: object },
-): {
-	content: Array<{ type: "text"; text: string }>;
-	terminate?: boolean;
-	details?: object;
-};
-
-export declare class HostError extends Error {
-	code: string;
-	constructor(code: string, message: string);
-}
-
-export declare function unwrap<T>(result: {
-	ok: boolean;
-	data?: T;
-	error?: { code: string; message: string };
-}): T;