@amodalai/react 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Amodal Labs, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/chat.d.ts

@@ -0,0 +1,19 @@
+import { ConfirmationInfo, ToolCallInfo } from './types';
+import { UseAmodalChatOptions } from './hooks/useAmodalChat';
+export interface AmodalChatProps extends UseAmodalChatOptions {
+    /** Placeholder text for the input bar. */
+    placeholder?: string;
+    /** Custom renderer for text content blocks. */
+    renderText?: (text: string) => React.ReactNode;
+    /** Custom renderer for tool call blocks. */
+    renderToolCall?: (call: ToolCallInfo) => React.ReactNode;
+    /** Custom renderer for confirmation blocks. */
+    renderConfirmation?: (confirmation: ConfirmationInfo, onApprove: () => void, onDeny: () => void) => React.ReactNode;
+    /** CSS class name for the root element. */
+    className?: string;
+}
+/**
+ * Full chat component — message list, input bar, renders confirmations inline.
+ */
+export declare function AmodalChat({ placeholder, renderText, renderToolCall, renderConfirmation, className, ...hookOptions }: AmodalChatProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=chat.d.ts.map

package/dist/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../src/chat.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAIlE,MAAM,WAAW,eAAgB,SAAQ,oBAAoB;IAC3D,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;IAC/C,4CAA4C;IAC5C,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,KAAK,CAAC,SAAS,CAAC;IACzD,+CAA+C;IAC/C,kBAAkB,CAAC,EAAE,CAAC,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,KAAK,KAAK,CAAC,SAAS,CAAC;IACpH,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EACzB,WAAiC,EACjC,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,SAAS,EACT,GAAG,WAAW,EACf,EAAE,eAAe,2CAuHjB"}

package/dist/client/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export { parseSSELine, streamSSE, streamSSEGet } from './sse-client';
+export type { StreamSSEOptions } from './sse-client';
+export { RuntimeClient } from './runtime-client';
+export type { RuntimeClientOptions } from './runtime-client';
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACrE,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/client/runtime-client.d.ts

@@ -0,0 +1,58 @@
+import { SSEEvent, TaskStatus, StoreDefinitionInfo, StoreListResult, StoreDocumentResult } from '../types';
+export interface RuntimeClientOptions {
+    runtimeUrl: string;
+    tenantId: string;
+    getToken?: () => string | Promise<string> | null | undefined;
+}
+/**
+ * Client for the Amodal runtime's repo routes.
+ * Targets POST /chat, POST /task, GET /task/:id, GET /task/:id/stream.
+ */
+export declare class RuntimeClient {
+    private readonly runtimeUrl;
+    private readonly tenantId;
+    private readonly getToken?;
+    constructor(options: RuntimeClientOptions);
+    private authHeaders;
+    /**
+     * Stream a chat message via POST /chat.
+     */
+    chatStream(message: string, options?: {
+        sessionId?: string;
+        context?: Record<string, unknown>;
+        signal?: AbortSignal;
+    }): AsyncGenerator<SSEEvent>;
+    /**
+     * Start a fire-and-forget task via POST /task.
+     */
+    startTask(prompt: string, tenantToken?: string): Promise<{
+        task_id: string;
+    }>;
+    /**
+     * Get task status via GET /task/:id.
+     */
+    getTaskStatus(taskId: string): Promise<TaskStatus>;
+    /**
+     * Stream task events via GET /task/:id/stream.
+     */
+    streamTask(taskId: string, signal?: AbortSignal): AsyncGenerator<SSEEvent>;
+    /**
+     * List all store definitions with document counts.
+     */
+    getStores(signal?: AbortSignal): Promise<StoreDefinitionInfo[]>;
+    /**
+     * List documents from a store with optional filtering.
+     */
+    getStoreDocuments(storeName: string, options?: {
+        filter?: Record<string, unknown>;
+        sort?: string;
+        limit?: number;
+        offset?: number;
+        signal?: AbortSignal;
+    }): Promise<StoreListResult>;
+    /**
+     * Get a single document by key, optionally with version history.
+     */
+    getStoreDocument(storeName: string, key: string, signal?: AbortSignal): Promise<StoreDocumentResult>;
+}
+//# sourceMappingURL=runtime-client.d.ts.map

package/dist/client/runtime-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-client.d.ts","sourceRoot":"","sources":["../../src/client/runtime-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,mBAAmB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAGhH,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;CAC9D;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAoD;gBAElE,OAAO,EAAE,oBAAoB;YAM3B,WAAW;IAWzB;;OAEG;IACI,UAAU,CACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,GACA,cAAc,CAAC,QAAQ,CAAC;IAqB3B;;OAEG;IACG,SAAS,CACb,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IA0B/B;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAiBxD;;OAEG;IACI,UAAU,CACf,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,cAAc,CAAC,QAAQ,CAAC;IAW3B;;OAEG;IACG,SAAS,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAcrE;;OAEG;IACG,iBAAiB,CACrB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,GACA,OAAO,CAAC,eAAe,CAAC;IA4B3B;;OAEG;IACG,gBAAgB,CACpB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,mBAAmB,CAAC;CAehC"}

package/dist/client/sse-client.d.ts

@@ -0,0 +1,20 @@
+import { SSEEvent } from '../types';
+/**
+ * Parse a single SSE data line into a typed event.
+ * Returns null for non-data lines or empty data.
+ */
+export declare function parseSSELine(line: string): SSEEvent | null;
+export interface StreamSSEOptions {
+    signal?: AbortSignal;
+    headers?: Record<string, string>;
+}
+/**
+ * Streams SSE events from a POST endpoint.
+ * Uses fetch + ReadableStream (not EventSource, which only supports GET).
+ */
+export declare function streamSSE(url: string, body: Record<string, unknown>, options?: StreamSSEOptions): AsyncGenerator<SSEEvent>;
+/**
+ * Streams SSE events from a GET endpoint (e.g., task streaming).
+ */
+export declare function streamSSEGet(url: string, options?: StreamSSEOptions): AsyncGenerator<SSEEvent>;
+//# sourceMappingURL=sse-client.d.ts.map

package/dist/client/sse-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-client.d.ts","sourceRoot":"","sources":["../../src/client/sse-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAM1D;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAuB,SAAS,CAC9B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,gBAAgB,GACzB,cAAc,CAAC,QAAQ,CAAC,CAkB1B;AAED;;GAEG;AACH,wBAAuB,YAAY,CACjC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,gBAAgB,GACzB,cAAc,CAAC,QAAQ,CAAC,CAY1B"}

package/dist/client.js

@@ -0,0 +1,181 @@
+var m = Object.defineProperty;
+var S = (s, e, t) => e in s ? m(s, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : s[e] = t;
+var d = (s, e, t) => S(s, typeof e != "symbol" ? e + "" : e, t);
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+function l(s) {
+  if (!s.startsWith("data: ")) return null;
+  const e = s.slice(6).trim();
+  return e.length === 0 ? null : JSON.parse(e);
+}
+async function* g(s, e, t) {
+  const a = {
+    "Content-Type": "application/json",
+    ...t == null ? void 0 : t.headers
+  }, r = await fetch(s, {
+    method: "POST",
+    headers: a,
+    body: JSON.stringify(e),
+    signal: t == null ? void 0 : t.signal
+  });
+  if (!r.ok)
+    throw new Error(`SSE request failed: ${String(r.status)} ${r.statusText}`);
+  yield* f(r);
+}
+async function* y(s, e) {
+  const t = await fetch(s, {
+    method: "GET",
+    headers: e == null ? void 0 : e.headers,
+    signal: e == null ? void 0 : e.signal
+  });
+  if (!t.ok)
+    throw new Error(`SSE request failed: ${String(t.status)} ${t.statusText}`);
+  yield* f(t);
+}
+async function* f(s) {
+  const e = s.body;
+  if (!e)
+    throw new Error("Response body is null");
+  const t = e.getReader(), a = new TextDecoder();
+  let r = "";
+  try {
+    for (; ; ) {
+      const { done: n, value: i } = await t.read();
+      if (n) break;
+      r += a.decode(i, { stream: !0 });
+      const c = r.split(`
+`);
+      r = c.pop() ?? "";
+      for (const w of c) {
+        const h = w.trim();
+        if (h.length === 0) continue;
+        const u = l(h);
+        u && (yield u);
+      }
+    }
+    if (r.trim().length > 0) {
+      const n = l(r.trim());
+      n && (yield n);
+    }
+  } finally {
+    t.releaseLock();
+  }
+}
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+class $ {
+  constructor(e) {
+    d(this, "runtimeUrl");
+    d(this, "tenantId");
+    d(this, "getToken");
+    this.runtimeUrl = e.runtimeUrl.replace(/\/$/, ""), this.tenantId = e.tenantId, this.getToken = e.getToken;
+  }
+  async authHeaders() {
+    const e = {};
+    if (this.getToken) {
+      const t = await this.getToken();
+      t && (e.Authorization = `Bearer ${t}`);
+    }
+    return e;
+  }
+  /**
+   * Stream a chat message via POST /chat.
+   */
+  async *chatStream(e, t) {
+    const a = `${this.runtimeUrl}/chat`, r = {
+      message: e,
+      tenant_id: this.tenantId
+    };
+    t != null && t.sessionId && (r.session_id = t.sessionId), t != null && t.context && (r.context = t.context);
+    const n = await this.authHeaders();
+    yield* g(a, r, {
+      signal: t == null ? void 0 : t.signal,
+      headers: n
+    });
+  }
+  /**
+   * Start a fire-and-forget task via POST /task.
+   */
+  async startTask(e, t) {
+    const a = `${this.runtimeUrl}/task`, r = await this.authHeaders(), n = {
+      prompt: e,
+      tenant_id: this.tenantId
+    };
+    t && (n.tenant_token = t);
+    const i = await fetch(a, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", ...r },
+      body: JSON.stringify(n)
+    });
+    if (!i.ok)
+      throw new Error(`Start task failed: ${String(i.status)} ${i.statusText}`);
+    return await i.json();
+  }
+  /**
+   * Get task status via GET /task/:id.
+   */
+  async getTaskStatus(e) {
+    const t = `${this.runtimeUrl}/task/${e}`, a = await this.authHeaders(), r = await fetch(t, {
+      method: "GET",
+      headers: a
+    });
+    if (!r.ok)
+      throw new Error(`Get task status failed: ${String(r.status)} ${r.statusText}`);
+    return await r.json();
+  }
+  /**
+   * Stream task events via GET /task/:id/stream.
+   */
+  async *streamTask(e, t) {
+    const a = `${this.runtimeUrl}/task/${e}/stream`, r = await this.authHeaders();
+    yield* y(a, { signal: t, headers: r });
+  }
+  // ---------------------------------------------------------------------------
+  // Store API
+  // ---------------------------------------------------------------------------
+  /**
+   * List all store definitions with document counts.
+   */
+  async getStores(e) {
+    const t = `${this.runtimeUrl}/api/stores`, a = await this.authHeaders(), r = await fetch(t, { headers: a, signal: e });
+    if (!r.ok)
+      throw new Error(`Failed to fetch stores: ${String(r.status)}`);
+    return (await r.json()).stores;
+  }
+  /**
+   * List documents from a store with optional filtering.
+   */
+  async getStoreDocuments(e, t) {
+    const a = new URLSearchParams();
+    t != null && t.filter && a.set("filter", JSON.stringify(t.filter)), t != null && t.sort && a.set("sort", t.sort), (t == null ? void 0 : t.limit) !== void 0 && a.set("limit", String(t.limit)), (t == null ? void 0 : t.offset) !== void 0 && a.set("offset", String(t.offset));
+    const r = a.toString(), n = `${this.runtimeUrl}/api/stores/${e}${r ? `?${r}` : ""}`, i = await this.authHeaders(), c = await fetch(n, { headers: i, signal: t == null ? void 0 : t.signal });
+    if (!c.ok)
+      throw new Error(`Failed to fetch store documents: ${String(c.status)}`);
+    return await c.json();
+  }
+  /**
+   * Get a single document by key, optionally with version history.
+   */
+  async getStoreDocument(e, t, a) {
+    const r = `${this.runtimeUrl}/api/stores/${e}/${encodeURIComponent(t)}`, n = await this.authHeaders(), i = await fetch(r, { headers: n, signal: a });
+    if (!i.ok) {
+      if (i.status === 404)
+        return { document: null, history: [] };
+      throw new Error(`Failed to fetch store document: ${String(i.status)}`);
+    }
+    return await i.json();
+  }
+}
+export {
+  $ as RuntimeClient,
+  l as parseSSELine,
+  g as streamSSE,
+  y as streamSSEGet
+};
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sources":["../src/client/sse-client.ts","../src/client/runtime-client.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2025 Amodal Labs, Inc.\n * SPDX-License-Identifier: MIT\n */\n\nimport type { SSEEvent } from '../types';\n\n/**\n * Parse a single SSE data line into a typed event.\n * Returns null for non-data lines or empty data.\n */\nexport function parseSSELine(line: string): SSEEvent | null {\n  if (!line.startsWith('data: ')) return null;\n  const json = line.slice(6).trim();\n  if (json.length === 0) return null;\n  // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- SSE event from server\n  return JSON.parse(json) as SSEEvent;\n}\n\nexport interface StreamSSEOptions {\n  signal?: AbortSignal;\n  headers?: Record<string, string>;\n}\n\n/**\n * Streams SSE events from a POST endpoint.\n * Uses fetch + ReadableStream (not EventSource, which only supports GET).\n */\nexport async function* streamSSE(\n  url: string,\n  body: Record<string, unknown>,\n  options?: StreamSSEOptions,\n): AsyncGenerator<SSEEvent> {\n  const headers: Record<string, string> = {\n    'Content-Type': 'application/json',\n    ...options?.headers,\n  };\n\n  const response = await fetch(url, {\n    method: 'POST',\n    headers,\n    body: JSON.stringify(body),\n    signal: options?.signal,\n  });\n\n  if (!response.ok) {\n    throw new Error(`SSE request failed: ${String(response.status)} ${response.statusText}`);\n  }\n\n  yield* readSSEStream(response);\n}\n\n/**\n * Streams SSE events from a GET endpoint (e.g., task streaming).\n */\nexport async function* streamSSEGet(\n  url: string,\n  options?: StreamSSEOptions,\n): AsyncGenerator<SSEEvent> {\n  const response = await fetch(url, {\n    method: 'GET',\n    headers: options?.headers,\n    signal: options?.signal,\n  });\n\n  if (!response.ok) {\n    throw new Error(`SSE request failed: ${String(response.status)} ${response.statusText}`);\n  }\n\n  yield* readSSEStream(response);\n}\n\n/**\n * Reads SSE events from a Response body stream.\n */\nasync function* readSSEStream(response: Response): AsyncGenerator<SSEEvent> {\n  const body = response.body;\n  if (!body) {\n    throw new Error('Response body is null');\n  }\n\n  const reader = body.getReader();\n  const decoder = new TextDecoder();\n  let buffer = '';\n\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) break;\n\n      buffer += decoder.decode(value, { stream: true });\n\n      const lines = buffer.split('\\n');\n      buffer = lines.pop() ?? '';\n\n      for (const line of lines) {\n        const trimmed = line.trim();\n        if (trimmed.length === 0) continue;\n        const event = parseSSELine(trimmed);\n        if (event) {\n          yield event;\n        }\n      }\n    }\n\n    // Process any remaining buffer\n    if (buffer.trim().length > 0) {\n      const event = parseSSELine(buffer.trim());\n      if (event) {\n        yield event;\n      }\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n","/**\n * @license\n * Copyright 2025 Amodal Labs, Inc.\n * SPDX-License-Identifier: MIT\n */\n\nimport type { SSEEvent, TaskStatus, StoreDefinitionInfo, StoreListResult, StoreDocumentResult } from '../types';\nimport { streamSSE, streamSSEGet } from './sse-client';\n\nexport interface RuntimeClientOptions {\n  runtimeUrl: string;\n  tenantId: string;\n  getToken?: () => string | Promise<string> | null | undefined;\n}\n\n/**\n * Client for the Amodal runtime's repo routes.\n * Targets POST /chat, POST /task, GET /task/:id, GET /task/:id/stream.\n */\nexport class RuntimeClient {\n  private readonly runtimeUrl: string;\n  private readonly tenantId: string;\n  private readonly getToken?: () => string | Promise<string> | null | undefined;\n\n  constructor(options: RuntimeClientOptions) {\n    this.runtimeUrl = options.runtimeUrl.replace(/\\/$/, '');\n    this.tenantId = options.tenantId;\n    this.getToken = options.getToken;\n  }\n\n  private async authHeaders(): Promise<Record<string, string>> {\n    const headers: Record<string, string> = {};\n    if (this.getToken) {\n      const token = await this.getToken();\n      if (token) {\n        headers['Authorization'] = `Bearer ${token}`;\n      }\n    }\n    return headers;\n  }\n\n  /**\n   * Stream a chat message via POST /chat.\n   */\n  async *chatStream(\n    message: string,\n    options?: {\n      sessionId?: string;\n      context?: Record<string, unknown>;\n      signal?: AbortSignal;\n    },\n  ): AsyncGenerator<SSEEvent> {\n    const url = `${this.runtimeUrl}/chat`;\n    const body: Record<string, unknown> = {\n      message,\n      tenant_id: this.tenantId,\n    };\n    if (options?.sessionId) {\n      body['session_id'] = options.sessionId;\n    }\n    if (options?.context) {\n      body['context'] = options.context;\n    }\n\n    const headers = await this.authHeaders();\n\n    yield* streamSSE(url, body, {\n      signal: options?.signal,\n      headers,\n    });\n  }\n\n  /**\n   * Start a fire-and-forget task via POST /task.\n   */\n  async startTask(\n    prompt: string,\n    tenantToken?: string,\n  ): Promise<{ task_id: string }> {\n    const url = `${this.runtimeUrl}/task`;\n    const headers = await this.authHeaders();\n\n    const body: Record<string, unknown> = {\n      prompt,\n      tenant_id: this.tenantId,\n    };\n    if (tenantToken) {\n      body['tenant_token'] = tenantToken;\n    }\n\n    const response = await fetch(url, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json', ...headers },\n      body: JSON.stringify(body),\n    });\n\n    if (!response.ok) {\n      throw new Error(`Start task failed: ${String(response.status)} ${response.statusText}`);\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Server response\n    return (await response.json()) as { task_id: string };\n  }\n\n  /**\n   * Get task status via GET /task/:id.\n   */\n  async getTaskStatus(taskId: string): Promise<TaskStatus> {\n    const url = `${this.runtimeUrl}/task/${taskId}`;\n    const headers = await this.authHeaders();\n\n    const response = await fetch(url, {\n      method: 'GET',\n      headers,\n    });\n\n    if (!response.ok) {\n      throw new Error(`Get task status failed: ${String(response.status)} ${response.statusText}`);\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Server response\n    return (await response.json()) as TaskStatus;\n  }\n\n  /**\n   * Stream task events via GET /task/:id/stream.\n   */\n  async *streamTask(\n    taskId: string,\n    signal?: AbortSignal,\n  ): AsyncGenerator<SSEEvent> {\n    const url = `${this.runtimeUrl}/task/${taskId}/stream`;\n    const headers = await this.authHeaders();\n\n    yield* streamSSEGet(url, { signal, headers });\n  }\n\n  // ---------------------------------------------------------------------------\n  // Store API\n  // ---------------------------------------------------------------------------\n\n  /**\n   * List all store definitions with document counts.\n   */\n  async getStores(signal?: AbortSignal): Promise<StoreDefinitionInfo[]> {\n    const url = `${this.runtimeUrl}/api/stores`;\n    const headers = await this.authHeaders();\n\n    const response = await fetch(url, { headers, signal });\n    if (!response.ok) {\n      throw new Error(`Failed to fetch stores: ${String(response.status)}`);\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Server response\n    const body = (await response.json()) as { stores: StoreDefinitionInfo[] };\n    return body.stores;\n  }\n\n  /**\n   * List documents from a store with optional filtering.\n   */\n  async getStoreDocuments(\n    storeName: string,\n    options?: {\n      filter?: Record<string, unknown>;\n      sort?: string;\n      limit?: number;\n      offset?: number;\n      signal?: AbortSignal;\n    },\n  ): Promise<StoreListResult> {\n    const params = new URLSearchParams();\n    if (options?.filter) {\n      params.set('filter', JSON.stringify(options.filter));\n    }\n    if (options?.sort) {\n      params.set('sort', options.sort);\n    }\n    if (options?.limit !== undefined) {\n      params.set('limit', String(options.limit));\n    }\n    if (options?.offset !== undefined) {\n      params.set('offset', String(options.offset));\n    }\n\n    const qs = params.toString();\n    const url = `${this.runtimeUrl}/api/stores/${storeName}${qs ? `?${qs}` : ''}`;\n    const headers = await this.authHeaders();\n\n    const response = await fetch(url, { headers, signal: options?.signal });\n    if (!response.ok) {\n      throw new Error(`Failed to fetch store documents: ${String(response.status)}`);\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Server response\n    return (await response.json()) as StoreListResult;\n  }\n\n  /**\n   * Get a single document by key, optionally with version history.\n   */\n  async getStoreDocument(\n    storeName: string,\n    key: string,\n    signal?: AbortSignal,\n  ): Promise<StoreDocumentResult> {\n    const url = `${this.runtimeUrl}/api/stores/${storeName}/${encodeURIComponent(key)}`;\n    const headers = await this.authHeaders();\n\n    const response = await fetch(url, { headers, signal });\n    if (!response.ok) {\n      if (response.status === 404) {\n        return { document: null, history: [] };\n      }\n      throw new Error(`Failed to fetch store document: ${String(response.status)}`);\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- Server response\n    return (await response.json()) as StoreDocumentResult;\n  }\n}\n"],"names":["parseSSELine","line","json","streamSSE","url","body","options","headers","response","readSSEStream","streamSSEGet","reader","decoder","buffer","done","value","lines","trimmed","event","RuntimeClient","__publicField","token","message","prompt","tenantToken","taskId","signal","storeName","params","qs","key"],"mappings":"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"}

package/dist/components/AmodalAction.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export interface AmodalActionProps {
+    /** The prompt to send when the action is triggered. */
+    prompt: string;
+    /** Label for the trigger button. */
+    label?: string;
+    /** Additional context sent with the chat message. */
+    context?: Record<string, unknown>;
+    /** Called when the action completes. */
+    onComplete?: (text: string) => void;
+    /** Called on error. */
+    onError?: (error: string) => void;
+}
+/**
+ * One-shot action: triggers a chat stream with a prompt, shows confirmation inline.
+ */
+export declare function AmodalAction({ prompt, label, context, onComplete, onError }: AmodalActionProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=AmodalAction.d.ts.map

package/dist/components/AmodalAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AmodalAction.d.ts","sourceRoot":"","sources":["../../src/components/AmodalAction.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,wCAAwC;IACxC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,uBAAuB;IACvB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,iBAAiB,2CAuF9F"}

package/dist/components/ConfirmCard.d.ts

@@ -0,0 +1,11 @@
+import { ConfirmationInfo } from '../types';
+export interface ConfirmCardProps {
+    confirmation: ConfirmationInfo;
+    onApprove: () => void;
+    onDeny: () => void;
+}
+/**
+ * Simple confirmation card: shows endpoint + method + reason, approve/deny buttons.
+ */
+export declare function ConfirmCard({ confirmation, onApprove, onDeny }: ConfirmCardProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ConfirmCard.d.ts.map

package/dist/components/ConfirmCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfirmCard.d.ts","sourceRoot":"","sources":["../../src/components/ConfirmCard.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,gBAAgB,CAAC;IAC/B,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,gBAAgB,2CAkChF"}

package/dist/components/ReviewCard.d.ts

@@ -0,0 +1,11 @@
+import { ConfirmationInfo } from '../types';
+export interface ReviewCardProps {
+    confirmation: ConfirmationInfo;
+    onApprove: () => void;
+    onDeny: () => void;
+}
+/**
+ * Structured review card: all params, reason, escalation badge, approve/deny.
+ */
+export declare function ReviewCard({ confirmation, onApprove, onDeny }: ReviewCardProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ReviewCard.d.ts.map

package/dist/components/ReviewCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReviewCard.d.ts","sourceRoot":"","sources":["../../src/components/ReviewCard.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,gBAAgB,CAAC;IAC/B,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,eAAe,2CAoD9E"}

package/dist/hooks/useAmodalBrief.d.ts

@@ -0,0 +1,20 @@
+import { BriefResult } from '../types';
+export interface UseAmodalBriefOptions {
+    /** The prompt to send for the brief. */
+    prompt: string;
+    /** Additional context sent with the request. */
+    context?: Record<string, unknown>;
+    /** If true, the brief is fetched automatically on mount. Defaults to true. */
+    autoFetch?: boolean;
+}
+export interface UseAmodalBriefReturn {
+    brief: BriefResult | null;
+    isLoading: boolean;
+    error: string | null;
+    refresh: () => void;
+}
+/**
+ * Sends a chat with a brief prompt, collects the full response.
+ */
+export declare function useAmodalBrief(options: UseAmodalBriefOptions): UseAmodalBriefReturn;
+//# sourceMappingURL=useAmodalBrief.d.ts.map

package/dist/hooks/useAmodalBrief.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAmodalBrief.d.ts","sourceRoot":"","sources":["../../src/hooks/useAmodalBrief.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,UAAU,CAAC;AAG1D,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,8EAA8E;IAC9E,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,oBAAoB,CAoFnF"}

package/dist/hooks/useAmodalChat.d.ts

@@ -0,0 +1,27 @@
+import { ChatState, ChatAction, ChatMessage, ToolCallInfo, ConfirmationInfo } from '../types';
+export declare function chatReducer(state: ChatState, action: ChatAction): ChatState;
+export interface UseAmodalChatOptions {
+    /** Additional context sent with each chat message. */
+    context?: Record<string, unknown>;
+    /** Called when the SSE stream ends. */
+    onStreamEnd?: () => void;
+    /** Called when a session ID is received from the server. */
+    onSessionCreated?: (sessionId: string) => void;
+    /** Called on each tool call result. */
+    onToolCall?: (call: ToolCallInfo) => void;
+    /** Called when a confirmation is required. */
+    onConfirmation?: (confirmation: ConfirmationInfo) => void;
+}
+export interface UseAmodalChatReturn {
+    messages: ChatMessage[];
+    send: (text: string) => void;
+    stop: () => void;
+    isStreaming: boolean;
+    activeToolCalls: ToolCallInfo[];
+    sessionId: string | null;
+    error: string | null;
+    reset: () => void;
+    respondToConfirmation: (correlationId: string, approved: boolean) => void;
+}
+export declare function useAmodalChat(options?: UseAmodalChatOptions): UseAmodalChatReturn;
+//# sourceMappingURL=useAmodalChat.d.ts.map

package/dist/hooks/useAmodalChat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAmodalChat.d.ts","sourceRoot":"","sources":["../../src/hooks/useAmodalChat.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,WAAW,EAEX,YAAY,EAEZ,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAkBlB,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,SAAS,CA2L3E;AAED,MAAM,WAAW,oBAAoB;IACnC,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,uCAAuC;IACvC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;IAC1C,8CAA8C;IAC9C,cAAc,CAAC,EAAE,CAAC,YAAY,EAAE,gBAAgB,KAAK,IAAI,CAAC;CAC3D;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,EAAE,YAAY,EAAE,CAAC;IAChC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,qBAAqB,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;CAC3E;AAED,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,mBAAmB,CA6LjF"}

package/dist/hooks/useAmodalInsight.d.ts

@@ -0,0 +1,23 @@
+import { InsightResult } from '../types';
+export interface UseAmodalInsightOptions {
+    /** The insight prompt to send. */
+    prompt: string;
+    /** Additional context for the insight. */
+    context?: Record<string, unknown>;
+    /** If true, fetched automatically on mount. Defaults to true. */
+    autoFetch?: boolean;
+}
+export interface UseAmodalInsightReturn {
+    status: InsightResult['status'];
+    summary: string;
+    details: string;
+    isLoading: boolean;
+    error: string | null;
+    refresh: () => void;
+}
+/**
+ * Sends a chat with an insight prompt, collects a structured response.
+ * Splits the response at the first double newline into summary and details.
+ */
+export declare function useAmodalInsight(options: UseAmodalInsightOptions): UseAmodalInsightReturn;
+//# sourceMappingURL=useAmodalInsight.d.ts.map

package/dist/hooks/useAmodalInsight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAmodalInsight.d.ts","sourceRoot":"","sources":["../../src/hooks/useAmodalInsight.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAG9C,MAAM,WAAW,uBAAuB;IACtC,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,iEAAiE;IACjE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CA6EzF"}

package/dist/hooks/useAmodalQuery.d.ts

@@ -0,0 +1,17 @@
+import { QueryResult } from '../types';
+export interface UseAmodalQueryOptions {
+    /** The query prompt. */
+    prompt: string;
+    /** Additional context. */
+    context?: Record<string, unknown>;
+    /** If true, fetched automatically on mount. Defaults to true. */
+    autoFetch?: boolean;
+}
+export type UseAmodalQueryReturn = QueryResult<string> & {
+    refetch: () => void;
+};
+/**
+ * Non-streaming query. Collects the full response text.
+ */
+export declare function useAmodalQuery(options: UseAmodalQueryOptions): UseAmodalQueryReturn;
+//# sourceMappingURL=useAmodalQuery.d.ts.map

package/dist/hooks/useAmodalQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAmodalQuery.d.ts","sourceRoot":"","sources":["../../src/hooks/useAmodalQuery.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAG5C,MAAM,WAAW,qBAAqB;IACpC,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,iEAAiE;IACjE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG;IACvD,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,oBAAoB,CAiEnF"}

package/dist/hooks/useAmodalTask.d.ts

@@ -0,0 +1,21 @@
+import { SSEEvent, TaskStatusValue } from '../types';
+export interface UseAmodalTaskOptions {
+    /** The task ID to stream. */
+    taskId: string;
+    /** If true, starts streaming automatically on mount. Defaults to true. */
+    autoStream?: boolean;
+}
+export interface UseAmodalTaskReturn {
+    status: TaskStatusValue | 'idle';
+    progress: string;
+    result: string;
+    events: SSEEvent[];
+    error: string | null;
+    start: () => void;
+    stop: () => void;
+}
+/**
+ * Streams GET /task/:id/stream events.
+ */
+export declare function useAmodalTask(options: UseAmodalTaskOptions): UseAmodalTaskReturn;
+//# sourceMappingURL=useAmodalTask.d.ts.map

package/dist/hooks/useAmodalTask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAmodalTask.d.ts","sourceRoot":"","sources":["../../src/hooks/useAmodalTask.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG1D,MAAM,WAAW,oBAAoB;IACnC,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,eAAe,GAAG,MAAM,CAAC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CAoGhF"}

package/dist/hooks/useNavigate.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Navigation function type.
+ * In the runtime app, this is backed by React Router's navigate.
+ * In standalone/embedded usage, the host app provides the implementation.
+ */
+export type NavigateFn = (pageName: string, params?: Record<string, string>) => void;
+/**
+ * Context for providing a navigate function.
+ * The runtime app sets this with React Router's navigate.
+ * Standalone users can provide their own via NavigateProvider.
+ */
+export declare const NavigateContext: import('react').Context<NavigateFn | null>;
+/**
+ * Navigate between pages in the runtime app.
+ *
+ * In the runtime app, navigates to the page route.
+ * In standalone/embedded usage, calls the host-provided navigate function.
+ * If no NavigateProvider is present, returns a no-op.
+ *
+ * @example
+ * ```tsx
+ * const navigate = useNavigate();
+ * navigate('incident-detail', { correlationId: '123' });
+ * ```
+ */
+export declare function useNavigate(): NavigateFn;
+//# sourceMappingURL=useNavigate.d.ts.map

package/dist/hooks/useNavigate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNavigate.d.ts","sourceRoot":"","sources":["../../src/hooks/useNavigate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;AAErF;;;;GAIG;AACH,eAAO,MAAM,eAAe,4CAAyC,CAAC;AAEtE;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,IAAI,UAAU,CAQxC"}

package/dist/hooks/useSkillAction.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export interface UseSkillActionOptions {
+    /** Store names this skill writes to (for context in the prompt). */
+    stores?: string[];
+    /** Whether to include a confirmation hint in the prompt. */
+    confirm?: boolean;
+}
+export interface UseSkillActionReturn {
+    /** Execute the skill with the given parameters. */
+    execute: (params?: Record<string, unknown>) => void;
+    /** Whether the skill is currently running. */
+    loading: boolean;
+    /** The text result from the skill execution. */
+    result: string | null;
+    /** Error message if execution failed. */
+    error: string | null;
+}
+/**
+ * Invoke a skill via the chat agent.
+ *
+ * Under the hood, this sends a structured chat message asking the agent
+ * to run the skill, then collects the text response.
+ *
+ * @example
+ * ```tsx
+ * const investigate = useSkillAction('deep-investigator', {
+ *   stores: ['active-alerts', 'incident-correlations'],
+ * });
+ *
+ * <button onClick={() => investigate.execute({ correlationId: '123' })}>
+ *   Investigate
+ * </button>
+ * ```
+ */
+export declare function useSkillAction(skillName: string, options?: UseSkillActionOptions): UseSkillActionReturn;
+//# sourceMappingURL=useSkillAction.d.ts.map