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

package/package.json

@@ -5,18 +5,45 @@
     "Irving Ou <irving@pi-oxide.dev>"
   ],
   "description": "WASM host for pi-core. Browser FileSystem Access API, fetch(), JS event loop.",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/pi-oxide/pi-oxide.git"
+    "url": "https://github.com/pi-oxide/pi-oxide"
   },
   "files": [
     "pi_host_web_bg.wasm",
     "pi_host_web.js",
     "pi_host_web.d.ts",
     "sdk/index.js",
-    "sdk/index.d.ts"
+    "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"
   ],
   "main": "pi_host_web.js",
   "types": "pi_host_web.d.ts",
@@ -25,13 +52,17 @@
   ],
   "exports": {
     ".": {
-      "import": "./sdk/index.js",
-      "types": "./sdk/index.d.ts"
+      "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

@@ -10,30 +10,20 @@ export interface AgentOptions {
     system_prompt: string;
     model: Model;
     thinking_level?: ThinkingLevel;
-    tools?: ToolDefinition[];
     steering_mode?: QueueMode;
     follow_up_mode?: QueueMode;
-    tool_execution_mode?: ToolExecutionMode;
+    tool_execution_mode?: ExecutionMode;
     session_id?: SessionId;
-    messages?: AgentMessage[];
-    session_state?: SessionState | null;
 }
 
-export interface AgentState {
-    system_prompt: string;
-    model: Model;
-    thinking_level: ThinkingLevel;
-    tools: ToolDefinition[];
-    messages: AgentMessage[];
-    is_streaming: boolean;
-    streaming_message?: AgentMessage;
-    pending_tool_calls: string[];
-    error_message?: string;
+export interface ArtifactSearchResult {
+    id: string;
+    snippet: string;
+    match_count: number;
 }
 
-export interface ApiUsageSnapshot {
-    estimated_tokens: number;
-    actual_input_tokens: number;
+export interface ArtifactSearchResults {
+    results: ArtifactSearchResult[];
 }
 
 export interface AssistantMessage {
@@ -47,49 +37,30 @@ export interface AssistantMessage {
     usage: TokenUsage;
 }
 
-export interface BranchSummary {
-    summary: string;
-    details?: JsonSchema;
-}
-
 export interface ContextProjectionBudget {
-    max_tool_result_chars: number;
-    max_context_tokens: number;
-    default_preview_chars: number;
+    max_tool_result_chars?: number;
+    max_context_tokens?: number;
     microcompact_after_turns?: number;
     compaction_threshold?: number;
 }
 
-export interface ContextProjectionReport {
-    estimated_tokens: number;
-    replacements: ContextReplacement[];
-    dropped_messages: number;
-    needs_compaction?: boolean;
-    cache_breakpoints?: number[];
-}
-
-export interface ContextProjectionState {
-    replacements: Record<string, ContextReplacement>;
-    last_api_usage?: ApiUsageSnapshot | null;
-    turns_since_compaction?: number;
+export interface CreateHostAgentOutput {
+    handle: number;
 }
 
-export interface ContextReplacement {
-    tool_call_id: string;
-    tool_name: string;
-    artifact_id: string;
-    original_chars: number;
-    preview_chars: number;
-    strategy: ContextStrategy;
+export interface CreateHostAgentResult {
+    ok: boolean;
+    data?: CreateHostAgentOutput;
+    error?: ErrorDto;
 }
 
-export interface CreateAgentOutput {
+export interface CreateHostStateOutput {
     handle: number;
 }
 
-export interface CreateAgentResult {
+export interface CreateHostStateResult {
     ok: boolean;
-    data?: CreateAgentOutput;
+    data?: CreateHostStateOutput;
     error?: ErrorDto;
 }
 
@@ -118,13 +89,13 @@ export interface EstimateTokensResult {
     error?: ErrorDto;
 }
 
-export interface EventsOutput {
-    events: AgentEvent[];
+export interface HostStatePersistDataOutput {
+    state: PersistData;
 }
 
-export interface EventsResult {
+export interface HostStatePersistDataResult {
     ok: boolean;
-    data?: EventsOutput;
+    data?: HostStatePersistDataOutput;
     error?: ErrorDto;
 }
 
@@ -172,87 +143,19 @@ export interface ModelCost {
     cache_write: number;
 }
 
-export interface MoveToOutput {
-    summary_entry_id: string | null;
-}
-
-export interface MoveToResult {
-    ok: boolean;
-    data?: MoveToOutput;
-    error?: ErrorDto;
-}
-
-export interface ProjectionInput {
-    system_prompt: string;
-    messages: AgentMessage[];
-    budget: ContextProjectionBudget;
-    state: ContextProjectionState;
-}
-
-export interface ProjectionOutput {
-    projected_messages: AgentMessage[];
-    updated_state: ContextProjectionState;
-    report: ContextProjectionReport;
-}
-
-export interface ProjectionResult {
-    ok: boolean;
-    data?: ProjectionOutput;
-    error?: ErrorDto;
-}
-
-export interface SessionBranchOutput {
-    entries: SessionEntry[];
-}
-
-export interface SessionBranchResult {
-    ok: boolean;
-    data?: SessionBranchOutput;
-    error?: ErrorDto;
-}
-
-export interface SessionEntry {
-    id: string;
-    parent_id?: string;
-    kind: EntryKind;
-    timestamp: number;
-}
-
-export interface SessionState {
-    entries: SessionEntry[];
-    leaf_id: string;
-    name?: string;
+export interface PersistData {
+    T?: Value;
+    A?: Value;
+    turn_number?: number;
+    host_artifacts?: [string, string][];
+    budget?: ContextProjectionBudget;
+    system_prompt?: string;
+    compaction_prompt?: string;
 }
 
-export interface SessionStateOutput {
-    state: SessionState;
-}
-
-export interface SessionStateResult {
-    ok: boolean;
-    data?: SessionStateOutput;
-    error?: ErrorDto;
-}
-
-export interface StateOutput {
-    state: AgentState;
-}
-
-export interface StateResult {
-    ok: boolean;
-    data?: StateOutput;
-    error?: ErrorDto;
-}
-
-export interface StepOutput {
-    events: AgentEvent[];
-    actions: AgentAction[];
-}
-
-export interface StepResult {
-    ok: boolean;
-    data?: StepOutput;
-    error?: ErrorDto;
+export interface StartTurnInput {
+    prompt: AgentMessage;
+    tools?: ToolDefinition[];
 }
 
 export interface TextContent {
@@ -279,6 +182,7 @@ export interface ToolDefinition {
     description: string;
     parameters: JsonSchema;
     execution_mode?: ExecutionMode;
+    tool_run_mode?: ToolRunMode;
 }
 
 export interface ToolError {
@@ -301,15 +205,6 @@ export interface ToolResult {
     terminate?: boolean;
 }
 
-export interface ToolResultContext {
-    content_kind: ContentKind;
-    strategy: ContextStrategy;
-    original_chars: number;
-    truncated_by_tool: boolean;
-    path?: string;
-    exit_code?: number;
-}
-
 export interface ToolResultMessage {
     tool_call_id: ToolCallId;
     tool_name: ToolName;
@@ -319,14 +214,24 @@ export interface ToolResultMessage {
     timestamp: number;
 }
 
+export interface TurnResultOutput {
+    events: AgentEvent[];
+    directives: HostDirective[];
+    markers?: ChangeMarkerDto[];
+}
+
+export interface TurnResultResult {
+    ok: boolean;
+    data?: TurnResultOutput;
+    error?: ErrorDto;
+}
+
 export interface UserMessage {
     content: Content[];
     timestamp: number;
 }
 
-export type AgentAction = { type: "stream_llm"; context: LlmContext; session_id?: SessionId } | { type: "execute_tools"; calls: ToolCall[] } | { type: "cancel_tools"; tool_call_ids: ToolCallId[]; reason: CancelReason } | { type: "wait_for_input"; mode: WaitMode } | { type: "finished"; messages: AgentMessage[] };
-
-export type AgentEvent = { type: "agent_start" } | { type: "agent_end"; messages: AgentMessage[] } | { 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; 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 AgentMessage = ({ role: "user" } & UserMessage) | ({ role: "assistant" } & AssistantMessage) | ({ role: "tool_result" } & ToolResultMessage);
 
@@ -334,18 +239,16 @@ export type ApiName = string;
 
 export type CancelReason = { type: "user_requested" } | { type: "timeout" } | { type: "agent_aborted" } | { type: "dependency_failed"; cause_tool_call_id: ToolCallId };
 
+export type ChangeMarkerDto = { type: "compaction_applied" } | { type: "new_artifacts"; entry_ids: string[] };
+
 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 ContentKind = "file_read" | "command_output" | "diff" | "search_results" | "directory_listing" | "generic_text";
-
-export type ContextStrategy = { type: "keep_full" } | { type: "head"; max_chars: number } | { type: "tail"; max_chars: number } | { type: "head_tail"; head_chars: number; tail_chars: number } | { type: "drop_if_old" } | { type: "microcompacted" };
-
-export type EntryKind = ({ type: "message" } & {} & AgentMessage) | { type: "compaction"; summary: string; first_kept_entry_id: string; tokens_before: number; details?: JsonSchema } | { type: "branch_summary"; summary: string; details?: JsonSchema } | { type: "model_change"; provider: string; model_id: string } | ({ type: "thinking_level_change" } & ThinkingLevel) | { type: "custom"; custom_type: string; data?: JsonSchema };
-
 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 JsonSchema = Value;
 
 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 };
@@ -358,10 +261,6 @@ export type ModelName = string;
 
 export type ModelProvider = "open_ai" | "anthropic" | "google" | "ollama" | "custom";
 
-export type Phase = "idle" | "streaming" | "wait_for_input";
-
-export type PromptRequest = AgentMessage | { text: string };
-
 export type ProviderName = string;
 
 export type QueueMode = "one_at_a_time" | "all";
@@ -378,96 +277,98 @@ export type ToolCallId = string;
 
 export type ToolDetails = Value;
 
-export type ToolDonePayload = { error: ToolError } | { result: ToolResult } | ToolResult;
-
-export type ToolExecutionMode = "parallel" | "sequential";
-
 export type ToolName = string;
 
 export type ToolOutputStream = "stdout" | "stderr" | "status";
 
+export type ToolRunMode = "immediate" | "deferred";
+
 export type WaitMode = "steering" | "follow_up" | "any";
 
 
-export function appendSessionEntry(handle: number, entry: SessionEntry): EmptyResult;
+export function createHostAgent(options: AgentOptions, budget: ContextProjectionBudget): CreateHostAgentResult;
+
+export function createHostState(_budget: ContextProjectionBudget): CreateHostStateResult;
 
-export function createAgent(options: AgentOptions): CreateAgentResult;
+export function destroyHostAgent(handle: number): EmptyResult;
 
-export function destroyAgent(handle: number): EmptyResult;
+export function destroyHostState(handle: number): EmptyResult;
 
 export function estimateTokens(input: EstimateTokensInput): EstimateTokensResult;
 
 export function estimateTokensForText(text: string): EstimateTokensResult;
 
-export function fallbackStrategy(tool_name: string): ContextStrategy;
+export function getHostAgentPersistData(handle: number): HostStatePersistDataResult;
 
-export function feedLlmChunk(handle: number, chunk: LlmChunk): EventsResult;
+export function getHostStatePersistData(handle: number): HostStatePersistDataResult;
 
-export function followUp(handle: number, message: AgentMessage): EmptyResult;
+export function hostAbort(handle: number): TurnResultResult;
 
-export function getSessionBranch(handle: number): SessionBranchResult;
+export function hostAcceptCompaction(handle: number, summary: string, _compacted_entry_ids: string[]): TurnResultResult;
 
-export function getSessionState(handle: number): SessionStateResult;
+export function hostContinueTurn(handle: number): TurnResultResult;
 
-export function moveTo(handle: number, target_id: string, summary?: BranchSummary | null): MoveToResult;
+export function hostFeedLlmChunk(handle: number, chunk: LlmChunk): TurnResultResult;
 
-export function onLlmDone(handle: number, result: LlmResult): StepResult;
+export function hostLlmDone(handle: number, result: LlmResult): TurnResultResult;
 
-export function onToolCancelled(handle: number, tool_call_id: string, reason: CancelReason): StepResult;
+export function hostReadArtifact(handle: number, artifact_id: string): string;
 
-export function onToolDone(handle: number, tool_call_id: string, payload: ToolDonePayload): StepResult;
+export function hostReset(handle: number): EmptyResult;
 
-export function onToolStarted(handle: number, tool_call_id: string): EventsResult;
+export function hostSearchArtifacts(handle: number, query: string): ArtifactSearchResults;
 
-export function onToolUpdate(handle: number, update: ToolExecutionUpdate): EventsResult;
+export function hostSteer(handle: number, message: AgentMessage): TurnResultResult;
 
-export function projectContext(input: ProjectionInput): ProjectionResult;
+export function hostToolCancelled(handle: number, tool_call_id: string, reason: CancelReason): TurnResultResult;
 
-export function prompt(handle: number, prompt: PromptRequest): StepResult;
+export function hostToolDone(handle: number, id: ToolCallId, result: ToolResult): TurnResultResult;
 
-export function reset(handle: number): EmptyResult;
+export function restoreHostAgent(options: AgentOptions, data: PersistData): CreateHostAgentResult;
 
-export function setLogLevel(level: string): void;
+export function restoreHostState(data: PersistData): CreateHostStateResult;
 
-export function setSessionState(handle: number, state: SessionState): EmptyResult;
+export function restoreHostStateFromJson(json: string): CreateHostStateResult;
 
-export function state(handle: number): StateResult;
+export function setLogLevel(level: string): void;
 
-export function steer(handle: number, message: AgentMessage): EventsResult;
+export function startTurn(handle: number, input: StartTurnInput): TurnResultResult;
 
 export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
 
 export interface InitOutput {
     readonly memory: WebAssembly.Memory;
-    readonly appendSessionEntry: (a: number, b: any) => any;
-    readonly createAgent: (a: any) => any;
-    readonly destroyAgent: (a: number) => any;
+    readonly createHostState: (a: any) => any;
+    readonly destroyHostState: (a: number) => any;
     readonly estimateTokens: (a: any) => any;
     readonly estimateTokensForText: (a: number, b: number) => any;
-    readonly fallbackStrategy: (a: number, b: number) => any;
-    readonly feedLlmChunk: (a: number, b: any) => any;
-    readonly followUp: (a: number, b: any) => any;
-    readonly getSessionBranch: (a: number) => any;
-    readonly getSessionState: (a: number) => any;
-    readonly moveTo: (a: number, b: number, c: number, d: number) => any;
-    readonly onLlmDone: (a: number, b: any) => any;
-    readonly onToolCancelled: (a: number, b: number, c: number, d: any) => any;
-    readonly onToolDone: (a: number, b: number, c: number, d: any) => any;
-    readonly onToolStarted: (a: number, b: number, c: number) => any;
-    readonly onToolUpdate: (a: number, b: any) => any;
-    readonly projectContext: (a: any) => any;
-    readonly prompt: (a: number, b: any) => any;
-    readonly reset: (a: 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 createHostAgent: (a: any, b: any) => any;
+    readonly destroyHostAgent: (a: number) => any;
+    readonly getHostAgentPersistData: (a: number) => any;
+    readonly hostAbort: (a: number) => any;
+    readonly hostAcceptCompaction: (a: number, b: number, c: number, d: number, e: number) => any;
+    readonly hostContinueTurn: (a: number) => any;
+    readonly hostFeedLlmChunk: (a: number, b: any) => any;
+    readonly hostLlmDone: (a: number, b: any) => 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 restoreHostAgent: (a: any, b: any) => any;
+    readonly startTurn: (a: number, b: any) => any;
     readonly setLogLevel: (a: number, b: number) => void;
-    readonly setSessionState: (a: number, b: any) => any;
-    readonly state: (a: number) => any;
-    readonly steer: (a: number, b: any) => any;
     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;
     readonly __wbindgen_exn_store: (a: number) => void;
     readonly __externref_table_alloc: () => number;
     readonly __wbindgen_externrefs: WebAssembly.Table;
+    readonly __externref_table_dealloc: (a: number) => void;
     readonly __wbindgen_start: () => void;
 }