@pi-oxide/pi-host-web 0.5.0 → 0.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/bindings.d.ts +2 -0
- package/dist/index-CAp51VNq.js +867 -0
- package/dist/index-Is-rTdaY.js +867 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.js +1706 -0
- package/dist/sdk/agent.d.ts +21 -0
- package/dist/sdk/agent.d.ts.map +1 -0
- package/dist/sdk/artifacts.d.ts +29 -0
- package/dist/sdk/artifacts.d.ts.map +1 -0
- package/dist/sdk/bindings/host-agent.d.ts +16 -0
- package/dist/sdk/bindings/host-agent.d.ts.map +1 -0
- package/dist/sdk/bindings/index.d.ts +7 -0
- package/dist/sdk/bindings/index.d.ts.map +1 -0
- package/dist/sdk/bindings/index.js +14 -0
- package/dist/sdk/bindings/init.d.ts +30 -0
- package/dist/sdk/bindings/init.d.ts.map +1 -0
- package/dist/sdk/bindings/markers.d.ts +9 -0
- package/dist/sdk/bindings/markers.d.ts.map +1 -0
- package/dist/sdk/bindings/tool-preparation.d.ts +12 -0
- package/dist/sdk/bindings/tool-preparation.d.ts.map +1 -0
- package/dist/sdk/bindings/turn-loop.d.ts +5 -0
- package/dist/sdk/bindings/turn-loop.d.ts.map +1 -0
- package/dist/sdk/bindings/types.d.ts +60 -0
- package/dist/sdk/bindings/types.d.ts.map +1 -0
- package/dist/sdk/context.d.ts +2 -0
- package/dist/sdk/context.d.ts.map +1 -0
- package/dist/sdk/errors.d.ts +8 -0
- package/dist/sdk/errors.d.ts.map +1 -0
- package/dist/sdk/events.d.ts +9 -0
- package/dist/sdk/events.d.ts.map +1 -0
- package/dist/sdk/index.d.ts +16 -0
- package/dist/sdk/index.d.ts.map +1 -0
- package/dist/sdk/init.d.ts +2 -0
- package/dist/sdk/init.d.ts.map +1 -0
- package/dist/sdk/internal/engine.d.ts +4 -0
- package/dist/sdk/internal/engine.d.ts.map +1 -0
- package/dist/sdk/internal/events.d.ts +30 -0
- package/dist/sdk/internal/events.d.ts.map +1 -0
- package/dist/sdk/internal/logger.d.ts +51 -0
- package/dist/sdk/internal/logger.d.ts.map +1 -0
- package/dist/sdk/internal/providers/anthropic.d.ts +75 -0
- package/dist/sdk/internal/providers/anthropic.d.ts.map +1 -0
- package/dist/sdk/internal/providers/openai.d.ts +13 -0
- package/dist/sdk/internal/providers/openai.d.ts.map +1 -0
- package/dist/sdk/internal/providers/types.d.ts +57 -0
- package/dist/sdk/internal/providers/types.d.ts.map +1 -0
- package/dist/sdk/internal/stores/indexedDb.d.ts +3 -0
- package/dist/sdk/internal/stores/indexedDb.d.ts.map +1 -0
- package/dist/sdk/internal/stores/persistence.d.ts +13 -0
- package/dist/sdk/internal/stores/persistence.d.ts.map +1 -0
- package/dist/sdk/internal/tools/artifact.d.ts +3 -0
- package/dist/sdk/internal/tools/artifact.d.ts.map +1 -0
- package/dist/sdk/internal/tools/browser.d.ts +19 -0
- package/dist/sdk/internal/tools/browser.d.ts.map +1 -0
- package/dist/sdk/internal/tools/browserRuntime.d.ts +47 -0
- package/dist/sdk/internal/tools/browserRuntime.d.ts.map +1 -0
- package/dist/sdk/internal/tools/liveRuntime.d.ts +12 -0
- package/dist/sdk/internal/tools/liveRuntime.d.ts.map +1 -0
- package/dist/sdk/internal/tools/registry.d.ts +17 -0
- package/dist/sdk/internal/tools/registry.d.ts.map +1 -0
- package/dist/sdk/internal/tools/service.d.ts +15 -0
- package/dist/sdk/internal/tools/service.d.ts.map +1 -0
- package/dist/sdk/internal/util/types.d.ts +6 -0
- package/dist/sdk/internal/util/types.d.ts.map +1 -0
- package/dist/sdk/model.d.ts +16 -0
- package/dist/sdk/model.d.ts.map +1 -0
- package/dist/sdk/orchestration/agent-engine.d.ts +24 -0
- package/dist/sdk/orchestration/agent-engine.d.ts.map +1 -0
- package/dist/sdk/orchestration/config-builders.d.ts +13 -0
- package/dist/sdk/orchestration/config-builders.d.ts.map +1 -0
- package/dist/sdk/orchestration/model-adapter.d.ts +10 -0
- package/dist/sdk/orchestration/model-adapter.d.ts.map +1 -0
- package/dist/sdk/snapshot.d.ts +7 -0
- package/dist/sdk/snapshot.d.ts.map +1 -0
- package/dist/sdk/stores.d.ts +22 -0
- package/dist/sdk/stores.d.ts.map +1 -0
- package/dist/sdk/tools.d.ts +32 -0
- package/dist/sdk/tools.d.ts.map +1 -0
- package/dist/sdk/types.d.ts +200 -0
- package/dist/sdk/types.d.ts.map +1 -0
- package/package.json +107 -5
- package/pi_host_web.d.ts +4 -17
- package/pi_host_web.js +1 -13
- package/pi_host_web_bg.wasm +0 -0
- package/pi_host_web_bg.wasm.d.ts +36 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../../../../sdk/internal/tools/artifact.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAuB,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGtE,wBAAgB,aAAa,IAAI,UAAU,CAiB1C"}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import { ToolCall, ToolDefinition, ToolResult } from '../../../../pi_host_web.js';
|
|
2
|
+
import { AgentTools } from '../../types';
|
|
3
|
+
import { BrowserRuntime } from './browserRuntime';
|
|
4
|
+
/** All browser-native tools for the browser host. */
|
|
5
|
+
export declare const BROWSER_TOOLS: ToolDefinition[];
|
|
6
|
+
/** Wrap a handler so that thrown errors are normalized to ToolResult. */
|
|
7
|
+
export declare function wrapToolHandler(handler: (call: ToolCall) => ToolResult | Promise<ToolResult>): (call: ToolCall) => Promise<ToolResult>;
|
|
8
|
+
/**
|
|
9
|
+
* Execute a browser tool call against a BrowserRuntime.
|
|
10
|
+
*
|
|
11
|
+
* Returns a ToolResult suitable for hostToolDone.
|
|
12
|
+
*/
|
|
13
|
+
export declare function executeBrowserTool(call: ToolCall, runtime: BrowserRuntime): ToolResult;
|
|
14
|
+
/**
|
|
15
|
+
* Create an AgentTools pack for browser-native tools.
|
|
16
|
+
* Auto-injects LiveBrowserRuntime in browser environments.
|
|
17
|
+
*/
|
|
18
|
+
export declare function browserTools(runtime?: BrowserRuntime): AgentTools;
|
|
19
|
+
//# sourceMappingURL=browser.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../../../sdk/internal/tools/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGpF,OAAO,KAAK,EAAuB,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,EAA+C,cAAc,EAAE,MAAM,qBAAqB,CAAC;AA6IvG,qDAAqD;AACrD,eAAO,MAAM,aAAa,EAAE,cAAc,EAOzC,CAAC;AA0BF,yEAAyE;AACzE,wBAAgB,eAAe,CAC9B,OAAO,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,GAC3D,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,UAAU,CAAC,CAWzC;AA4DD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,GAAG,UAAU,CAsGtF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAiCjE"}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Browser runtime adapter interface and types.
|
|
3
|
+
*
|
|
4
|
+
* Defines the contract between browser tools and the actual browser environment.
|
|
5
|
+
* Tests use FakeBrowserRuntime; real browser uses a LiveBrowserRuntime backed
|
|
6
|
+
* by window/document later.
|
|
7
|
+
*
|
|
8
|
+
* Host-owned — no browser APIs in pi-core.
|
|
9
|
+
*/
|
|
10
|
+
export interface BrowserPageSnapshot {
|
|
11
|
+
url: string;
|
|
12
|
+
title: string;
|
|
13
|
+
readyState: "loading" | "interactive" | "complete";
|
|
14
|
+
focusedElement: BrowserElementSnapshot | null;
|
|
15
|
+
}
|
|
16
|
+
export interface BrowserElementSnapshot {
|
|
17
|
+
tag: string;
|
|
18
|
+
text: string;
|
|
19
|
+
attributes: Record<string, string>;
|
|
20
|
+
visible: boolean;
|
|
21
|
+
selector: string;
|
|
22
|
+
}
|
|
23
|
+
export interface BrowserConsoleEntry {
|
|
24
|
+
level: "log" | "warn" | "error" | "info";
|
|
25
|
+
args: string[];
|
|
26
|
+
timestamp: number;
|
|
27
|
+
}
|
|
28
|
+
export type BrowserToolResult = {
|
|
29
|
+
ok: true;
|
|
30
|
+
data?: unknown;
|
|
31
|
+
} | {
|
|
32
|
+
ok: false;
|
|
33
|
+
error: {
|
|
34
|
+
code: string;
|
|
35
|
+
message: string;
|
|
36
|
+
};
|
|
37
|
+
};
|
|
38
|
+
export interface BrowserRuntime {
|
|
39
|
+
getPage(): BrowserPageSnapshot;
|
|
40
|
+
evalJs(source: string): unknown;
|
|
41
|
+
querySelector(selector: string): BrowserElementSnapshot | null;
|
|
42
|
+
querySelectorAll(selector: string): BrowserElementSnapshot[];
|
|
43
|
+
click(selector: string): BrowserToolResult;
|
|
44
|
+
type(selector: string, text: string): BrowserToolResult;
|
|
45
|
+
getConsole(): BrowserConsoleEntry[];
|
|
46
|
+
}
|
|
47
|
+
//# sourceMappingURL=browserRuntime.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"browserRuntime.d.ts","sourceRoot":"","sources":["../../../../sdk/internal/tools/browserRuntime.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,mBAAmB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;IACnD,cAAc,EAAE,sBAAsB,GAAG,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,sBAAsB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IACnC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IACzC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,iBAAiB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAIvH,MAAM,WAAW,cAAc;IAC9B,OAAO,IAAI,mBAAmB,CAAC;IAC/B,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAAC;IAC/D,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB,EAAE,CAAC;IAC7D,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAAC;IAC3C,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC;IACxD,UAAU,IAAI,mBAAmB,EAAE,CAAC;CACpC"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { BrowserConsoleEntry, BrowserElementSnapshot, BrowserPageSnapshot, BrowserRuntime, BrowserToolResult } from './browserRuntime';
|
|
2
|
+
export declare class LiveBrowserRuntime implements BrowserRuntime {
|
|
3
|
+
private logger;
|
|
4
|
+
getPage(): BrowserPageSnapshot;
|
|
5
|
+
evalJs(source: string): unknown;
|
|
6
|
+
querySelector(selector: string): BrowserElementSnapshot | null;
|
|
7
|
+
querySelectorAll(selector: string): BrowserElementSnapshot[];
|
|
8
|
+
click(selector: string): BrowserToolResult;
|
|
9
|
+
type(selector: string, text: string): BrowserToolResult;
|
|
10
|
+
getConsole(): BrowserConsoleEntry[];
|
|
11
|
+
}
|
|
12
|
+
//# sourceMappingURL=liveRuntime.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"liveRuntime.d.ts","sourceRoot":"","sources":["../../../../sdk/internal/tools/liveRuntime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACX,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,MAAM,qBAAqB,CAAC;AAuD7B,qBAAa,kBAAmB,YAAW,cAAc;IACxD,OAAO,CAAC,MAAM,CAAgC;IAE9C,OAAO,IAAI,mBAAmB;IAY9B,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAK/B,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI;IAM9D,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,sBAAsB,EAAE;IAM5D,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB;IAiB1C,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,iBAAiB;IA4BvD,UAAU,IAAI,mBAAmB,EAAE;CAKnC"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
import { ToolCall, ToolDefinition, ToolResult } from '../../../../pi_host_web.js';
|
|
2
|
+
import { AgentTools } from '../../types';
|
|
3
|
+
import { ArtifactStore } from '../engine';
|
|
4
|
+
export type ToolMap = Record<string, (call: ToolCall) => Promise<ToolResult> | ToolResult>;
|
|
5
|
+
export declare class ToolRegistryBuilder {
|
|
6
|
+
/**
|
|
7
|
+
* Build a WASM ToolMap from AgentTools packs.
|
|
8
|
+
* Artifact tools are wired with the store at build time.
|
|
9
|
+
*/
|
|
10
|
+
build(tools: AgentTools[], artifactStore?: ArtifactStore, sessionId?: string): ToolMap;
|
|
11
|
+
/**
|
|
12
|
+
* Convert AgentToolDefinition[] to WASM ToolDefinition[] for the LLM.
|
|
13
|
+
* Uses zod-to-json-schema for Zod schemas; passes plain objects through.
|
|
14
|
+
*/
|
|
15
|
+
getLlmTools(tools: AgentTools[]): ToolDefinition[];
|
|
16
|
+
}
|
|
17
|
+
//# sourceMappingURL=registry.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../sdk/internal/tools/registry.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAIpF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC,CAAC;AAE3F,qBAAa,mBAAmB;IAC/B;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,aAAa,CAAC,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO;IAuEtF;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,cAAc,EAAE;CAiClD"}
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { ToolCall, ToolDefinition, ToolResult } from '../../../../pi_host_web.js';
|
|
2
|
+
import { ArtifactStore } from '../engine';
|
|
3
|
+
import { BROWSER_TOOLS } from './browser';
|
|
4
|
+
import { BrowserRuntime } from './browserRuntime';
|
|
5
|
+
/** All artifact tools exposed by the host. */
|
|
6
|
+
export declare const ARTIFACT_TOOLS: ToolDefinition[];
|
|
7
|
+
export type ToolMap = Record<string, (call: ToolCall) => Promise<ToolResult> | ToolResult>;
|
|
8
|
+
export declare function createToolRegistry(runtime: BrowserRuntime): ToolMap;
|
|
9
|
+
/**
|
|
10
|
+
* Create artifact tool handlers that read from the agent store.
|
|
11
|
+
* No host handles required — operates on AgentStore directly.
|
|
12
|
+
*/
|
|
13
|
+
export declare function createArtifactToolRegistry(_getHandle: () => number, artifactStore?: ArtifactStore, getSessionId?: () => string | undefined): ToolMap;
|
|
14
|
+
export { BROWSER_TOOLS };
|
|
15
|
+
//# sourceMappingURL=service.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../sdk/internal/tools/service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEpF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,aAAa,EAAuC,MAAM,cAAc,CAAC;AAClF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAuD1D,8CAA8C;AAC9C,eAAO,MAAM,cAAc,EAAE,cAAc,EAAqC,CAAC;AAMjF,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAAC,CAAC;AAE3F,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAInE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACzC,UAAU,EAAE,MAAM,MAAM,EACxB,aAAa,CAAC,EAAE,aAAa,EAC7B,YAAY,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,GACrC,OAAO,CAyDT;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
/** Type-safe runtime helpers for narrowing `unknown` values. */
|
|
2
|
+
export declare function isRecord(value: unknown): value is Record<string, unknown>;
|
|
3
|
+
export declare function getString(value: unknown, key: string): string | undefined;
|
|
4
|
+
export declare function getNumber(value: unknown, key: string): number | undefined;
|
|
5
|
+
export declare function getBoolean(value: unknown, key: string): boolean | undefined;
|
|
6
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../sdk/internal/util/types.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAEhE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMzE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMzE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAM3E"}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { AgentModel } from './types';
|
|
2
|
+
export type { AgentModel } from './types';
|
|
3
|
+
/**
|
|
4
|
+
* Create a custom AgentModel from a user-provided generate function.
|
|
5
|
+
* Useful for wrapping arbitrary LLM providers or mocking in tests.
|
|
6
|
+
*/
|
|
7
|
+
export declare function defineModel(config: {
|
|
8
|
+
id?: string;
|
|
9
|
+
contextWindow?: number;
|
|
10
|
+
maxTokens?: number;
|
|
11
|
+
capabilities?: AgentModel["capabilities"];
|
|
12
|
+
generate: AgentModel["generate"];
|
|
13
|
+
generateStream?: AgentModel["generateStream"];
|
|
14
|
+
summarize?: AgentModel["summarize"];
|
|
15
|
+
}): AgentModel;
|
|
16
|
+
//# sourceMappingURL=model.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../sdk/model.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE;IACnC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;IAC1C,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IACjC,cAAc,CAAC,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC;IAC9C,SAAS,CAAC,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;CACpC,GAAG,UAAU,CAeb"}
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import { HostAgent } from '../bindings/host-agent';
|
|
2
|
+
import { AgentConfig, AgentInput, AgentRunOptions, AgentRunResult, AgentStatus } from '../types';
|
|
3
|
+
export type { HostAgent } from '../bindings/host-agent';
|
|
4
|
+
export type { AgentRunConfig, LlmStream, TurnResult } from '../bindings/types';
|
|
5
|
+
export { createHostAgentInstance } from '../bindings/host-agent';
|
|
6
|
+
export { runTurnWithHostAgent } from '../bindings/turn-loop';
|
|
7
|
+
export declare function createEngineAgent(config: AgentConfig, _callbacks: {
|
|
8
|
+
onEvent: (event: {
|
|
9
|
+
type: string;
|
|
10
|
+
payload: unknown;
|
|
11
|
+
}) => void;
|
|
12
|
+
onStatus: (status: AgentStatus) => void;
|
|
13
|
+
}): Promise<HostAgent>;
|
|
14
|
+
export declare function destroyEngineAgent(hostAgent: HostAgent): void;
|
|
15
|
+
export declare function runAgentTurn(hostAgent: HostAgent, config: AgentConfig, input: string | AgentInput, options: AgentRunOptions | undefined, signal: AbortSignal, callbacks: {
|
|
16
|
+
onEvent: (event: {
|
|
17
|
+
type: string;
|
|
18
|
+
payload: unknown;
|
|
19
|
+
}) => void;
|
|
20
|
+
onStatus: (status: AgentStatus) => void;
|
|
21
|
+
}): Promise<AgentRunResult>;
|
|
22
|
+
export declare function steerAgent(hostAgent: HostAgent, input: string | AgentInput): Promise<void>;
|
|
23
|
+
export declare function resetAgentState(hostAgent: HostAgent): Promise<void>;
|
|
24
|
+
//# sourceMappingURL=agent-engine.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
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"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { ContextProjectionBudget, Model, AgentMessage as WasmAgentMessage } from '../../../pi_host_web.js';
|
|
2
|
+
import { AgentConfig, AgentInput, AgentMessage, AgentModel, AgentTools } from '../types';
|
|
3
|
+
import { ArtifactStore } from '../bindings/types';
|
|
4
|
+
export declare function normalizeTools(tools: AgentTools | AgentTools[] | undefined): AgentTools[];
|
|
5
|
+
export declare function buildContextBudget(context?: import('../types.ts').AgentContextPolicy): ContextProjectionBudget;
|
|
6
|
+
export declare function buildModelOptions(model: AgentModel): Model;
|
|
7
|
+
export declare function buildArtifactStore(config: AgentConfig): ArtifactStore | undefined;
|
|
8
|
+
export declare function mergeMetadata(input: string | AgentInput, runMetadata?: Record<string, unknown>): Record<string, unknown> | undefined;
|
|
9
|
+
export declare function buildUserMessage(input: string | AgentInput): WasmAgentMessage;
|
|
10
|
+
export declare function convertWasmMessagesToAgentMessages(messages: WasmAgentMessage[]): AgentMessage[];
|
|
11
|
+
declare function stableMessageId(msg: WasmAgentMessage): string;
|
|
12
|
+
export { stableMessageId };
|
|
13
|
+
//# sourceMappingURL=config-builders.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
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"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import { AgentMessage as WasmAgentMessage } from '../../../pi_host_web.js';
|
|
2
|
+
import { AgentModel, ModelEvent, ModelResponse, TokenUsage } from '../types';
|
|
3
|
+
import { LlmStream } from '../bindings/types';
|
|
4
|
+
export declare function toWasmStopReason(reason: ModelResponse["stopReason"]): "end_turn" | "tool_use" | "max_tokens" | "error";
|
|
5
|
+
export declare function modelStreamToLlmStream(stream: AsyncIterable<ModelEvent>, signal: AbortSignal, runState: {
|
|
6
|
+
usage?: TokenUsage;
|
|
7
|
+
}): LlmStream;
|
|
8
|
+
export declare function modelResponseToLlmStream(response: ModelResponse, signal: AbortSignal): LlmStream;
|
|
9
|
+
export declare function defaultSummarizer(model: AgentModel, messages: WasmAgentMessage[], signal?: AbortSignal): Promise<string>;
|
|
10
|
+
//# sourceMappingURL=model-adapter.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../sdk/snapshot.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD,qBAAa,kBAAkB;IAC9B,OAAO,CAAC,MAAM,CAAyB;IAEvC,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa;IAOvC,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,GAAG,IAAI;CAUpD"}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { AgentStore } from './types';
|
|
2
|
+
export type { AgentSnapshot, AgentStore } from './types';
|
|
3
|
+
/**
|
|
4
|
+
* Store backed by IndexedDB. Durable across page reloads.
|
|
5
|
+
*/
|
|
6
|
+
export declare function indexedDbStore(): AgentStore;
|
|
7
|
+
/**
|
|
8
|
+
* In-memory store. Session data is lost when the page reloads.
|
|
9
|
+
*/
|
|
10
|
+
export declare function memoryStore(): AgentStore;
|
|
11
|
+
/**
|
|
12
|
+
* Store backed by localStorage. Simple but limited by storage quotas.
|
|
13
|
+
*/
|
|
14
|
+
export declare function localStorageStore(): AgentStore;
|
|
15
|
+
/**
|
|
16
|
+
* Store backed by an HTTP API.
|
|
17
|
+
* Expects endpoints at `${baseUrl}/sessions/${sessionId}`.
|
|
18
|
+
*/
|
|
19
|
+
export declare function httpStore(config: {
|
|
20
|
+
baseUrl: string;
|
|
21
|
+
}): AgentStore;
|
|
22
|
+
//# sourceMappingURL=stores.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"stores.d.ts","sourceRoot":"","sources":["../../sdk/stores.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAiB,UAAU,EAAE,MAAM,YAAY,CAAC;AAE5D,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE5D;;GAEG;AACH,wBAAgB,cAAc,IAAI,UAAU,CAE3C;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,UAAU,CAYxC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,CAY9C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,CAkBjE"}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import { AgentToolDefinition, AgentTools } from './types';
|
|
2
|
+
/** Structural interface for Zod-compatible schemas without exporting Zod types. */
|
|
3
|
+
export interface ToolInputSchema<Input> {
|
|
4
|
+
parse(data: unknown): Input;
|
|
5
|
+
safeParse(data: unknown): {
|
|
6
|
+
success: true;
|
|
7
|
+
data: Input;
|
|
8
|
+
} | {
|
|
9
|
+
success: false;
|
|
10
|
+
error: unknown;
|
|
11
|
+
};
|
|
12
|
+
_def: {
|
|
13
|
+
typeName?: string;
|
|
14
|
+
};
|
|
15
|
+
}
|
|
16
|
+
export interface ToolConfig<Input, Output> {
|
|
17
|
+
description: string;
|
|
18
|
+
input: ToolInputSchema<Input>;
|
|
19
|
+
run: (input: Input) => Promise<Output> | Output;
|
|
20
|
+
details?: (output: Output) => Record<string, unknown>;
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Declare a single tool definition with a Zod schema for input validation.
|
|
24
|
+
* The `name` is filled in by `defineTools()`.
|
|
25
|
+
*/
|
|
26
|
+
export declare function tool<Input, Output>(config: ToolConfig<Input, Output>): AgentToolDefinition;
|
|
27
|
+
/**
|
|
28
|
+
* Build a mergeable AgentTools pack from a record of tool definitions.
|
|
29
|
+
* Multiple packs can be composed as an array in AgentConfig.tools.
|
|
30
|
+
*/
|
|
31
|
+
export declare function defineTools(tools: Record<string, AgentToolDefinition>): AgentTools;
|
|
32
|
+
//# sourceMappingURL=tools.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../sdk/tools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAElE,mFAAmF;AACnF,MAAM,WAAW,eAAe,CAAC,KAAK;IACrC,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC;IAC5B,SAAS,CAAC,IAAI,EAAE,OAAO,GACpB;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,KAAK,CAAA;KAAE,GAC9B;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;IACtC,IAAI,EAAE;QACL,QAAQ,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACF;AAED,MAAM,WAAW,UAAU,CAAC,KAAK,EAAE,MAAM;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;IAC9B,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IAChD,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtD;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,mBAAmB,CAQ1F;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,UAAU,CAalF"}
|
|
@@ -0,0 +1,200 @@
|
|
|
1
|
+
import { AgentArtifact, AgentArtifactRef, ArtifactPolicy, ArtifactSearchQuery, ArtifactSearchResult } from './artifacts';
|
|
2
|
+
export type { AgentArtifact, AgentArtifactRef, ArtifactPolicy, ArtifactSearchQuery, ArtifactSearchResult, } from './artifacts';
|
|
3
|
+
export type LogLevel = "trace" | "debug" | "info" | "warn" | "error";
|
|
4
|
+
export interface Logger {
|
|
5
|
+
trace(message: string, context?: Record<string, unknown>): void;
|
|
6
|
+
debug(message: string, context?: Record<string, unknown>): void;
|
|
7
|
+
info(message: string, context?: Record<string, unknown>): void;
|
|
8
|
+
warn(message: string, context?: Record<string, unknown>): void;
|
|
9
|
+
error(message: string, context?: Record<string, unknown>): void;
|
|
10
|
+
}
|
|
11
|
+
export interface AgentConfig {
|
|
12
|
+
sessionId: string;
|
|
13
|
+
model: AgentModel;
|
|
14
|
+
tools?: AgentTools | AgentTools[];
|
|
15
|
+
store?: AgentStore;
|
|
16
|
+
instructions?: string;
|
|
17
|
+
context?: AgentContextPolicy;
|
|
18
|
+
artifacts?: ArtifactPolicy;
|
|
19
|
+
telemetry?: AgentTelemetry;
|
|
20
|
+
logger?: Logger;
|
|
21
|
+
logLevel?: LogLevel;
|
|
22
|
+
prepareToolCalls?: {
|
|
23
|
+
transform?: (call: AgentToolCall) => {
|
|
24
|
+
type: "none";
|
|
25
|
+
} | {
|
|
26
|
+
type: "rewrite_args";
|
|
27
|
+
arguments: unknown;
|
|
28
|
+
} | Promise<{
|
|
29
|
+
type: "none";
|
|
30
|
+
} | {
|
|
31
|
+
type: "rewrite_args";
|
|
32
|
+
arguments: unknown;
|
|
33
|
+
}>;
|
|
34
|
+
permission?: (call: AgentToolCall) => {
|
|
35
|
+
type: "allow";
|
|
36
|
+
} | {
|
|
37
|
+
type: "block";
|
|
38
|
+
reason: string;
|
|
39
|
+
} | Promise<{
|
|
40
|
+
type: "allow";
|
|
41
|
+
} | {
|
|
42
|
+
type: "block";
|
|
43
|
+
reason: string;
|
|
44
|
+
}>;
|
|
45
|
+
};
|
|
46
|
+
}
|
|
47
|
+
export type AgentInput = string | {
|
|
48
|
+
text: string;
|
|
49
|
+
attachments?: AgentAttachment[];
|
|
50
|
+
metadata?: Record<string, unknown>;
|
|
51
|
+
};
|
|
52
|
+
export interface AgentAttachment {
|
|
53
|
+
type: string;
|
|
54
|
+
content: string | Uint8Array;
|
|
55
|
+
mimeType?: string;
|
|
56
|
+
}
|
|
57
|
+
export interface AgentRunOptions {
|
|
58
|
+
signal?: AbortSignal;
|
|
59
|
+
metadata?: Record<string, unknown>;
|
|
60
|
+
}
|
|
61
|
+
export interface AgentRunResult {
|
|
62
|
+
status: "completed" | "aborted" | "failed";
|
|
63
|
+
message?: AgentMessage;
|
|
64
|
+
text: string;
|
|
65
|
+
toolCalls: AgentToolRun[];
|
|
66
|
+
artifacts: AgentArtifactRef[];
|
|
67
|
+
usage?: TokenUsage;
|
|
68
|
+
error?: AgentError;
|
|
69
|
+
}
|
|
70
|
+
export type AgentEventName = "messageStart" | "text" | "messageEnd" | "toolStart" | "toolUpdate" | "toolEnd" | "artifact" | "status" | "done" | "error" | "debug";
|
|
71
|
+
export type AgentEventHandler<E extends AgentEventName> = E extends "messageStart" ? (message: AgentMessage) => void : E extends "text" ? (delta: string) => void : E extends "messageEnd" ? (message: AgentMessage) => void : E extends "toolStart" ? (tool: AgentToolRun) => void : E extends "toolUpdate" ? (tool: AgentToolRun) => void : E extends "toolEnd" ? (tool: AgentToolRun) => void : E extends "artifact" ? (artifact: AgentArtifactRef) => void : E extends "status" ? (status: AgentStatus) => void : E extends "done" ? (result: AgentRunResult) => void : E extends "error" ? (error: AgentError) => void : E extends "debug" ? (event: unknown) => void : never;
|
|
72
|
+
export interface AgentMessage {
|
|
73
|
+
id: string;
|
|
74
|
+
role: "user" | "assistant" | "tool_result";
|
|
75
|
+
content: AgentContentBlock[];
|
|
76
|
+
timestamp?: number;
|
|
77
|
+
tool_call_id?: string;
|
|
78
|
+
}
|
|
79
|
+
export type AgentContentBlock = {
|
|
80
|
+
type: "text";
|
|
81
|
+
text: string;
|
|
82
|
+
} | {
|
|
83
|
+
type: "tool_call";
|
|
84
|
+
id: string;
|
|
85
|
+
name: string;
|
|
86
|
+
arguments: unknown;
|
|
87
|
+
} | {
|
|
88
|
+
type: "image";
|
|
89
|
+
mimeType: string;
|
|
90
|
+
data: string;
|
|
91
|
+
} | {
|
|
92
|
+
type: "file";
|
|
93
|
+
mimeType: string;
|
|
94
|
+
data: string;
|
|
95
|
+
};
|
|
96
|
+
export interface AgentToolRun {
|
|
97
|
+
id: string;
|
|
98
|
+
name: string;
|
|
99
|
+
title?: string;
|
|
100
|
+
input: unknown;
|
|
101
|
+
output?: unknown;
|
|
102
|
+
status: "running" | "completed" | "failed" | "cancelled";
|
|
103
|
+
startedAt: number;
|
|
104
|
+
endedAt?: number;
|
|
105
|
+
error?: AgentError;
|
|
106
|
+
}
|
|
107
|
+
export type AgentToolCall = {
|
|
108
|
+
id: string;
|
|
109
|
+
name: string;
|
|
110
|
+
arguments: unknown;
|
|
111
|
+
};
|
|
112
|
+
export interface AgentStatus {
|
|
113
|
+
state: "idle" | "loading" | "thinking" | "calling_model" | "running_tool" | "saving" | "completed" | "aborted" | "failed";
|
|
114
|
+
message?: string;
|
|
115
|
+
}
|
|
116
|
+
export interface AgentModel {
|
|
117
|
+
id?: string;
|
|
118
|
+
contextWindow?: number;
|
|
119
|
+
maxTokens?: number;
|
|
120
|
+
capabilities?: {
|
|
121
|
+
vision?: boolean;
|
|
122
|
+
jsonMode?: boolean;
|
|
123
|
+
functionCalling?: boolean;
|
|
124
|
+
streaming?: boolean;
|
|
125
|
+
};
|
|
126
|
+
generate(request: ModelRequest): Promise<ModelResponse>;
|
|
127
|
+
generateStream?(request: ModelRequest, signal?: AbortSignal): AsyncIterable<ModelEvent>;
|
|
128
|
+
summarize?(messages: AgentMessage[], signal?: AbortSignal): Promise<string>;
|
|
129
|
+
}
|
|
130
|
+
export interface ModelRequest {
|
|
131
|
+
instructions: string;
|
|
132
|
+
messages: AgentMessage[];
|
|
133
|
+
tools: AgentToolDefinition[];
|
|
134
|
+
signal?: AbortSignal;
|
|
135
|
+
metadata?: Record<string, unknown>;
|
|
136
|
+
}
|
|
137
|
+
export interface ModelResponse {
|
|
138
|
+
content: AgentContentBlock[];
|
|
139
|
+
stopReason: "end" | "tool_call" | "length" | "error";
|
|
140
|
+
usage?: TokenUsage;
|
|
141
|
+
model?: string;
|
|
142
|
+
raw?: unknown;
|
|
143
|
+
}
|
|
144
|
+
export interface ModelEvent {
|
|
145
|
+
type: "start" | "text_delta" | "tool_call_delta" | "done";
|
|
146
|
+
payload: unknown;
|
|
147
|
+
}
|
|
148
|
+
export interface AgentTools {
|
|
149
|
+
definitions: AgentToolDefinition[];
|
|
150
|
+
getHandler(name: string): ((input: unknown) => Promise<unknown> | unknown) | null;
|
|
151
|
+
}
|
|
152
|
+
export interface AgentToolDefinition {
|
|
153
|
+
name: string;
|
|
154
|
+
description: string;
|
|
155
|
+
inputSchema: unknown;
|
|
156
|
+
run: (input: unknown) => Promise<unknown> | unknown;
|
|
157
|
+
details?: (output: unknown) => Record<string, unknown>;
|
|
158
|
+
}
|
|
159
|
+
export interface AgentStore {
|
|
160
|
+
loadSession(sessionId: string): Promise<AgentSnapshot | null>;
|
|
161
|
+
saveSession(sessionId: string, snapshot: AgentSnapshot): Promise<void>;
|
|
162
|
+
saveArtifact?(sessionId: string, artifact: AgentArtifact): Promise<void>;
|
|
163
|
+
loadArtifact?(sessionId: string, artifactId: string): Promise<AgentArtifact | null>;
|
|
164
|
+
searchArtifacts?(sessionId: string, query: ArtifactSearchQuery): Promise<ArtifactSearchResult[]>;
|
|
165
|
+
}
|
|
166
|
+
export interface AgentSnapshot {
|
|
167
|
+
version: number;
|
|
168
|
+
data: unknown;
|
|
169
|
+
}
|
|
170
|
+
export interface AgentContextPolicy {
|
|
171
|
+
maxTokens?: number;
|
|
172
|
+
toolResultLimit?: number;
|
|
173
|
+
summarize?: boolean | AgentSummarizer;
|
|
174
|
+
}
|
|
175
|
+
export interface AgentSummarizer {
|
|
176
|
+
summarize(messages: AgentMessage[]): Promise<string>;
|
|
177
|
+
}
|
|
178
|
+
export interface AgentTelemetry {
|
|
179
|
+
onEvent?(event: {
|
|
180
|
+
type: string;
|
|
181
|
+
payload: unknown;
|
|
182
|
+
}): void;
|
|
183
|
+
onMetric?(name: string, value: number, metadata?: Record<string, unknown>): void;
|
|
184
|
+
}
|
|
185
|
+
export interface AgentError {
|
|
186
|
+
code: "model_auth_failed" | "model_rate_limited" | "model_unavailable" | "tool_input_invalid" | "tool_failed" | "tool_duplicate" | "store_load_failed" | "store_save_failed" | "store_artifact_unsupported" | "snapshot_invalid" | "aborted" | "internal_error" | "agent_disposed" | "agent_busy" | "agent_not_initialized";
|
|
187
|
+
message: string;
|
|
188
|
+
cause?: unknown;
|
|
189
|
+
recoverable: boolean;
|
|
190
|
+
metadata?: Record<string, unknown>;
|
|
191
|
+
}
|
|
192
|
+
export interface TokenUsage {
|
|
193
|
+
input: number;
|
|
194
|
+
output: number;
|
|
195
|
+
cache_read: number;
|
|
196
|
+
cache_write: number;
|
|
197
|
+
total_tokens: number;
|
|
198
|
+
}
|
|
199
|
+
export type Unsubscribe = () => void;
|
|
200
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../sdk/types.ts"],"names":[],"mappings":"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"}
|