agentenkit 0.3.0 → 0.5.0

package/dist/ports/sandbox.d.ts

@@ -0,0 +1,159 @@
+import type { AgentRunState } from '../core/state.js';
+/** The sandbox port: a place apart from the app where an agent's commands run
+ *  and its files live. A container, a hosted machine, or a folder on this
+ *  machine in development.
+ *
+ *  The shape and names follow ComputeSDK's Sandbox, so an adapter over it is
+ *  thin, with three additions: `readFileBytes` (charts and images need it),
+ *  `setTimeout` (how an idle sandbox ends by itself) and `SandboxInfo.workdir`.
+ *  The Go runtime has the same port (ports/sandbox.go). */
+/** How long a command may run when the caller does not say. */
+export declare const DEFAULT_COMMAND_TIMEOUT_MS = 120000;
+/** The most output kept from one command, per stream. Past it the rest is
+ *  dropped and the result says `truncated: true`, so a command that prints
+ *  without end cannot fill the app's memory. */
+export declare const MAX_COMMAND_OUTPUT_BYTES: number;
+/** The exit code of a command stopped at its time limit, as `timeout(1)`
+ *  gives it. */
+export declare const TIMED_OUT_EXIT_CODE = 124;
+/** What the sandbox may reach on the network. `none` is the default. */
+export type SandboxNetwork = 'none' | 'all' | {
+    allow: string[];
+};
+export interface CreateSandboxOptions {
+    /** How long the sandbox lives unless `setTimeout` pushes it back. It then
+     *  shuts itself down, even when the app that made it is gone. */
+    timeoutMs: number;
+    /** What the sandbox is for. Adapters keep it as labels or metadata where
+     *  the provider has them, and a multi-tenant adapter can read `state` to
+     *  pick a template or key per tenant (§2.10). */
+    metadata: {
+        threadId: string;
+        runId?: string;
+        state?: AgentRunState;
+    };
+    /** Environment variables every command sees. */
+    envs?: Record<string, string>;
+    /** A provider template (E2B) or image (Docker). Adapters have their own
+     *  default. */
+    template?: string;
+    image?: string;
+    network?: SandboxNetwork;
+    resources?: {
+        cpu?: number;
+        memoryMiB?: number;
+        diskMiB?: number;
+    };
+    /** Provider-only settings, passed through as they are. */
+    extra?: Record<string, unknown>;
+}
+/** Makes sandboxes and finds them again. One per app, passed to
+ *  `setupAgentCore({ tools: { sandbox } })`. */
+export interface SandboxProvider {
+    /** The adapter's name: 'docker', 'e2b', 'local'. */
+    readonly name: string;
+    create(options: CreateSandboxOptions): Promise<Sandbox>;
+    /** Finds a sandbox made earlier, by this process or another. Throws
+     *  SandboxGoneError when it no longer exists. */
+    connect(sandboxId: string): Promise<Sandbox>;
+}
+export interface RunCommandOptions {
+    /** Where the command runs. A relative path is taken from the sandbox's
+     *  work folder, which is also the default. */
+    cwd?: string;
+    env?: Record<string, string>;
+    /** Stops the command after this long: the result then has `timedOut: true`
+     *  and exit code 124, with the output it printed so far. Default 120 s. */
+    timeoutMs?: number;
+    /** Starts the command and returns at once, leaving it running (a dev
+     *  server, say). Its output is not kept. */
+    background?: boolean;
+    /** Output as it comes, decoded as UTF-8. */
+    onStdout?: (chunk: string) => void;
+    onStderr?: (chunk: string) => void;
+    /** Stops the command and rejects with the signal's reason. */
+    signal?: AbortSignal;
+}
+export interface CommandResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    durationMs: number;
+    /** True when the command was stopped at its time limit. */
+    timedOut?: boolean;
+    /** True when output past MAX_COMMAND_OUTPUT_BYTES was dropped. */
+    truncated?: boolean;
+}
+export interface FileEntry {
+    name: string;
+    type: 'file' | 'directory';
+    size?: number;
+}
+/** The sandbox's files. A relative path is taken from the work folder. */
+export interface SandboxFileSystem {
+    /** Throws SandboxFileNotFoundError when there is no such file. */
+    readFile(path: string): Promise<string>;
+    /** Not in ComputeSDK: charts and images are bytes. */
+    readFileBytes(path: string): Promise<Uint8Array>;
+    /** Makes the parent folders it needs, and replaces a file already there. */
+    writeFile(path: string, content: string | Uint8Array): Promise<void>;
+    /** The folder's entries, sorted by name. Throws SandboxFileNotFoundError
+     *  when there is no such folder. */
+    readdir(path: string): Promise<FileEntry[]>;
+    /** Makes the folder and its parents; fine when it is there already. */
+    mkdir(path: string): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    /** Removes a file, or a folder with everything in it; fine when it is not
+     *  there. */
+    remove(path: string): Promise<void>;
+}
+export interface SandboxInfo {
+    id: string;
+    provider: string;
+    status: 'running' | 'stopped' | 'error';
+    createdAt: Date;
+    /** When it will shut itself down, when the provider says. */
+    expiresAt?: Date;
+    /** The folder commands start in and relative paths are taken from. */
+    workdir: string;
+    metadata?: Record<string, string>;
+}
+export interface Sandbox {
+    readonly sandboxId: string;
+    readonly provider: string;
+    readonly filesystem: SandboxFileSystem;
+    runCommand(command: string, options?: RunCommandOptions): Promise<CommandResult>;
+    /** A URL for a port the sandbox serves on. Throws SandboxUnsupportedError
+     *  where the adapter cannot give one. */
+    getUrl(options: {
+        port: number;
+        protocol?: 'http' | 'https';
+    }): Promise<string>;
+    getInfo(): Promise<SandboxInfo>;
+    /** Not in ComputeSDK: the sandbox now shuts itself down `timeoutMs` from
+     *  now. The runtime calls it as a thread uses its sandbox, so one left idle
+     *  ends by itself. Throws SandboxUnsupportedError where the provider
+     *  cannot change it. */
+    setTimeout(timeoutMs: number): Promise<void>;
+    /** Ends the sandbox and its files. Fine when it is already gone. */
+    destroy(): Promise<void>;
+}
+/** The sandbox no longer exists: it timed out, was destroyed, or its
+ *  provider lost it. */
+export declare class SandboxGoneError extends Error {
+    readonly sandboxId: string;
+    readonly name = "SandboxGoneError";
+    constructor(sandboxId: string, why?: string);
+}
+/** There is no file or folder at this path. */
+export declare class SandboxFileNotFoundError extends Error {
+    readonly path: string;
+    readonly name = "SandboxFileNotFoundError";
+    constructor(path: string);
+}
+/** The adapter cannot do this. */
+export declare class SandboxUnsupportedError extends Error {
+    readonly name = "SandboxUnsupportedError";
+    constructor(provider: string, what: string);
+}
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/ports/sandbox.d.ts.map

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

package/dist/ports/sandbox.js

@@ -0,0 +1,44 @@
+/** The sandbox port: a place apart from the app where an agent's commands run
+ *  and its files live. A container, a hosted machine, or a folder on this
+ *  machine in development.
+ *
+ *  The shape and names follow ComputeSDK's Sandbox, so an adapter over it is
+ *  thin, with three additions: `readFileBytes` (charts and images need it),
+ *  `setTimeout` (how an idle sandbox ends by itself) and `SandboxInfo.workdir`.
+ *  The Go runtime has the same port (ports/sandbox.go). */
+/** How long a command may run when the caller does not say. */
+export const DEFAULT_COMMAND_TIMEOUT_MS = 120_000;
+/** The most output kept from one command, per stream. Past it the rest is
+ *  dropped and the result says `truncated: true`, so a command that prints
+ *  without end cannot fill the app's memory. */
+export const MAX_COMMAND_OUTPUT_BYTES = 4 * 1024 * 1024;
+/** The exit code of a command stopped at its time limit, as `timeout(1)`
+ *  gives it. */
+export const TIMED_OUT_EXIT_CODE = 124;
+/** The sandbox no longer exists: it timed out, was destroyed, or its
+ *  provider lost it. */
+export class SandboxGoneError extends Error {
+    sandboxId;
+    name = 'SandboxGoneError';
+    constructor(sandboxId, why) {
+        super(`sandbox ${sandboxId} is gone${why ? `: ${why}` : ''}`);
+        this.sandboxId = sandboxId;
+    }
+}
+/** There is no file or folder at this path. */
+export class SandboxFileNotFoundError extends Error {
+    path;
+    name = 'SandboxFileNotFoundError';
+    constructor(path) {
+        super(`sandbox: no such file or folder: ${path}`);
+        this.path = path;
+    }
+}
+/** The adapter cannot do this. */
+export class SandboxUnsupportedError extends Error {
+    name = 'SandboxUnsupportedError';
+    constructor(provider, what) {
+        super(`${provider}: ${what} is not supported`);
+    }
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/ports/sandbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.js","sourceRoot":"","sources":["../../src/ports/sandbox.ts"],"names":[],"mappings":"AAEA;;;;;;;2DAO2D;AAE3D,+DAA+D;AAC/D,MAAM,CAAC,MAAM,0BAA0B,GAAG,OAAO,CAAC;AAElD;;gDAEgD;AAChD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAExD;gBACgB;AAChB,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAwHvC;wBACwB;AACxB,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAEpB;IADH,IAAI,GAAG,kBAAkB,CAAC;IAC5C,YAAqB,SAAiB,EAAE,GAAY;QAClD,KAAK,CAAC,WAAW,SAAS,WAAW,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAD3C,cAAS,GAAT,SAAS,CAAQ;IAEtC,CAAC;CACF;AAED,+CAA+C;AAC/C,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IAE5B;IADH,IAAI,GAAG,0BAA0B,CAAC;IACpD,YAAqB,IAAY;QAC/B,KAAK,CAAC,oCAAoC,IAAI,EAAE,CAAC,CAAC;QAD/B,SAAI,GAAJ,IAAI,CAAQ;IAEjC,CAAC;CACF;AAED,kCAAkC;AAClC,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAC9B,IAAI,GAAG,yBAAyB,CAAC;IACnD,YAAY,QAAgB,EAAE,IAAY;QACxC,KAAK,CAAC,GAAG,QAAQ,KAAK,IAAI,mBAAmB,CAAC,CAAC;IACjD,CAAC;CACF"}

package/dist/ports/storage.d.ts

@@ -1,5 +1,5 @@
 import type { StorageContext } from '../core/state.js';
-import type { AgentEvent, ExecutionState, MessageDTO, NewMessage, NewUsage, UsageFilter, UsageTotals, ThreadDTO } from '../core/types.js';
+import type { AgentEvent, ExecutionState, MessageDTO, NewMessage, NewThreadEvent, ThreadEventFilter, NewUsage, UsageFilter, UsageTotals, ThreadDTO, ThreadTransition } from '../core/types.js';
 /** Persistence port for a caller's OWN data (§3.2): threads, messages, events,
  *  usage. DTOs cross the boundary; ORM/entity types never leak into core.
  *  Implement it once for MongoDB, MySQL, DynamoDB — or use the shipped
@@ -29,6 +29,11 @@ export interface Storage {
          *  Backs HITL reclamation + double-dispatch protection (§2.5, §2.8).
          *  Must be atomic — a single conditional UPDATE or equivalent. */
         claimState(threadId: string, from: ExecutionState, to: ExecutionState, ctx: StorageContext): Promise<boolean>;
+        /** The compare-and-set every run state change goes through: true iff THIS
+         *  caller moved the thread (see ThreadTransition). The adapter keeps the
+         *  thread's current run beside its state. Atomic, like `claimState`: one
+         *  conditional UPDATE or equivalent. */
+        transition(threadId: string, t: ThreadTransition, ctx: StorageContext): Promise<boolean>;
     };
     messages: {
         append(threadId: string, message: NewMessage, ctx: StorageContext): Promise<MessageDTO>;
@@ -51,16 +56,32 @@ export interface Storage {
          *  provider accepts. `run()` enforces that; adapters just delete. */
         deleteFrom(threadId: string, messageId: string, ctx: StorageContext): Promise<number>;
     };
+    /** The thread record: the few events that must outlive a run — parks and
+     *  their answers, refusals, budget stops, compaction, each segment's start
+     *  and end, and an app's own events published durable. A run's live
+     *  events go to its run stream, never here, so this grows with runs, not
+     *  with tokens. */
     events: {
-        append(threadId: string, event: AgentEvent, ctx: StorageContext): Promise<void>;
-        /** All events after the cursor, ascending by seq — SSE replay (§2.2) */
+        /** Store an entry and mint its seq: the thread's next, one higher than
+         *  any it holds. Two appends on one thread never get the same seq. */
+        append(threadId: string, event: NewThreadEvent, ctx: StorageContext): Promise<AgentEvent>;
+        /** Entries by filter, ascending by seq. */
+        list(threadId: string, filter: ThreadEventFilter, ctx: StorageContext): Promise<AgentEvent[]>;
+        /** All events after the cursor, ascending by seq. */
         listSince(threadId: string, sinceSeq: number, ctx: StorageContext): Promise<AgentEvent[]>;
         /** Most recent event of a type — the HITL pending check (§2.5) */
         latest(threadId: string, type: string, ctx: StorageContext): Promise<AgentEvent | null>;
         /** Every event of a type, ascending by seq. The open-approval set (§2.7)
-         *  is derived from these; scanning `listSince` instead would drag every
-         *  CHUNK on the thread through memory. */
+         *  is derived from these. */
         listByType(threadId: string, type: string, ctx: StorageContext): Promise<AgentEvent[]>;
+        /** Optional: one batch of `runtime.pruneEvents`. Deletes up to `limit`
+         *  entries of these types, on every thread, and says how many of each
+         *  went. With `dryRun` it deletes nothing and counts every entry of
+         *  these types instead. */
+        prune?(types: string[], opts: {
+            limit: number;
+            dryRun?: boolean;
+        }): Promise<Record<string, number>>;
     };
     /** One row per model call (§4).
      *

package/dist/ports/storage.d.ts.map

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

package/dist/ports/streams.d.ts

@@ -0,0 +1,60 @@
+import type { StreamEnd, StreamEvent, StreamItem } from '../core/stream-events.js';
+export type { StreamEnd, StreamEvent, StreamItem } from '../core/stream-events.js';
+/** Who a stream belongs to. */
+export interface StreamMeta {
+    threadId: string;
+    runId: string;
+}
+/** A stream as it stands now. */
+export interface StreamSnapshot {
+    meta: StreamMeta;
+    items: StreamItem[];
+    /** The end item when the stream is closed; it is also the last of `items`. */
+    end: StreamEnd | null;
+}
+/** The stream does not exist: never opened, past its grace window, or
+ *  deleted. A reader takes a fresh snapshot of the thread instead. */
+export declare class StreamGoneError extends Error {
+    readonly streamId: string;
+    constructor(streamId: string);
+}
+/** An append to a stream that is already closed. */
+export declare class StreamClosedError extends Error {
+    readonly streamId: string;
+    constructor(streamId: string);
+}
+/** Short-lived logs, one per run segment. Delivery lives here, not state:
+ *  a stream is closed when its segment ends and deleted after a grace
+ *  window. What must outlive the run is in the messages and the thread
+ *  record.
+ *
+ *  Every adapter keeps these rules:
+ *  - Offsets are opaque strings. Only the store compares them; a client
+ *    echoes the last one back and nothing else.
+ *  - Offsets strictly increase within a stream. One writer per stream: the
+ *    run lock already makes sure of that.
+ *  - `close` writes the end as the last item, so a reader that sees it
+ *    stops, and one that comes late still gets it.
+ *  - A missed wake-up only delays a reader, never drops an event. */
+export interface RunStreams {
+    /** Open a stream. Opening one that exists is a no-op. `ttlMs` deletes it
+     *  even if it is never closed. */
+    open(streamId: string, meta: StreamMeta, ttlMs: number): Promise<void>;
+    /** Append in order; one offset per event. Throws StreamClosedError once
+     *  closed and StreamGoneError when the stream does not exist. */
+    append(streamId: string, events: StreamEvent[]): Promise<string[]>;
+    /** The items after `after` (null: from the start), then live ones as they
+     *  come. Ends after the end item, or when the signal aborts. Throws
+     *  StreamGoneError when the stream does not exist, or goes while read. */
+    read(streamId: string, after: string | null, signal?: AbortSignal): AsyncIterable<StreamItem>;
+    /** The items after `after` now, without waiting. Null when the stream does
+     *  not exist. */
+    snapshot(streamId: string, after?: string | null): Promise<StreamSnapshot | null>;
+    /** Write the end item and start the grace window: the stream is deleted
+     *  `graceMs` later. Closing a closed stream is a no-op; closing one that
+     *  does not exist throws StreamGoneError. */
+    close(streamId: string, end: StreamEnd, graceMs: number): Promise<void>;
+    /** Remove a stream now (thread delete). A missing one is a no-op. */
+    delete(streamId: string): Promise<void>;
+}
+//# sourceMappingURL=streams.d.ts.map

package/dist/ports/streams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streams.d.ts","sourceRoot":"","sources":["../../src/ports/streams.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEnF,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEnF,+BAA+B;AAC/B,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,iCAAiC;AACjC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,8EAA8E;IAC9E,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;CACvB;AAED;sEACsE;AACtE,qBAAa,eAAgB,SAAQ,KAAK;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM;gBAAhB,QAAQ,EAAE,MAAM;CAItC;AAED,oDAAoD;AACpD,qBAAa,iBAAkB,SAAQ,KAAK;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM;gBAAhB,QAAQ,EAAE,MAAM;CAItC;AAED;;;;;;;;;;;;qEAYqE;AACrE,MAAM,WAAW,UAAU;IACzB;sCACkC;IAClC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE;qEACiE;IACjE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACnE;;8EAE0E;IAC1E,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IAC9F;qBACiB;IACjB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAClF;;iDAE6C;IAC7C,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,qEAAqE;IACrE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC"}

package/dist/ports/streams.js

@@ -0,0 +1,20 @@
+/** The stream does not exist: never opened, past its grace window, or
+ *  deleted. A reader takes a fresh snapshot of the thread instead. */
+export class StreamGoneError extends Error {
+    streamId;
+    constructor(streamId) {
+        super(`run stream ${streamId} is gone`);
+        this.streamId = streamId;
+        this.name = 'StreamGoneError';
+    }
+}
+/** An append to a stream that is already closed. */
+export class StreamClosedError extends Error {
+    streamId;
+    constructor(streamId) {
+        super(`run stream ${streamId} is closed`);
+        this.streamId = streamId;
+        this.name = 'StreamClosedError';
+    }
+}
+//# sourceMappingURL=streams.js.map

package/dist/ports/streams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streams.js","sourceRoot":"","sources":["../../src/ports/streams.ts"],"names":[],"mappings":"AAkBA;sEACsE;AACtE,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACnB;IAArB,YAAqB,QAAgB;QACnC,KAAK,CAAC,cAAc,QAAQ,UAAU,CAAC,CAAC;QADrB,aAAQ,GAAR,QAAQ,CAAQ;QAEnC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,oDAAoD;AACpD,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACrB;IAArB,YAAqB,QAAgB;QACnC,KAAK,CAAC,cAAc,QAAQ,YAAY,CAAC,CAAC;QADvB,aAAQ,GAAR,QAAQ,CAAQ;QAEnC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF"}

package/dist/ports/tools.d.ts

@@ -0,0 +1,60 @@
+/** The ports behind the built-in tools. Each tool has one name and one input
+ *  shape in every runtime; what does the work is an adapter you plug in here,
+ *  like storage or the queue. */
+/** How far back a search may look. */
+export type SearchRecency = 'day' | 'week' | 'month' | 'year';
+export interface SearchOptions {
+    /** 1 to 10. */
+    maxResults: number;
+    /** Only results from these domains (and their subdomains). */
+    allowedDomains?: string[];
+    /** Never results from these domains (and their subdomains). */
+    blockedDomains?: string[];
+    recency?: SearchRecency;
+    signal?: AbortSignal;
+}
+export interface SearchHit {
+    title: string;
+    url: string;
+    /** A short piece of the page that matched: what the model reads to decide
+     *  whether to open it. */
+    snippet: string;
+    /** ISO date, when the engine knows it. */
+    publishedAt?: string;
+}
+/** A web search engine: Brave, Jina, Tavily… */
+export interface Search {
+    /** The adapter's name, as usage rows and prices know it: 'brave'. */
+    readonly name: string;
+    search(query: string, options: SearchOptions): Promise<SearchHit[]>;
+}
+export interface FetchOptions {
+    /** Stop reading the page after this many bytes. */
+    maxBytes: number;
+    format: 'markdown' | 'text';
+    signal?: AbortSignal;
+}
+export interface FetchedPage {
+    /** Where the page ended up, after redirects. */
+    url: string;
+    title: string;
+    content: string;
+    /** True when the page was cut at `maxBytes`. */
+    truncated: boolean;
+}
+/** Reads one web page as clean text: our PageReader, Jina Reader… */
+export interface Fetcher {
+    readonly name: string;
+    fetch(url: string, options: FetchOptions): Promise<FetchedPage>;
+}
+import type { SandboxProvider } from './sandbox.js';
+/** The adapters the built-in tools use. A tool whose port is missing cannot
+ *  be asked for: `builtinTools` throws at startup rather than a run failing
+ *  later. */
+export interface BuiltinToolPorts {
+    search?: Search;
+    fetcher?: Fetcher;
+    /** Where commands run and files live: one sandbox per thread. */
+    sandbox?: SandboxProvider;
+}
+//# sourceMappingURL=tools.d.ts.map

package/dist/ports/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/ports/tools.ts"],"names":[],"mappings":"AAAA;;iCAEiC;AAEjC,sCAAsC;AACtC,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC5B,eAAe;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ;8BAC0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,gDAAgD;AAChD,MAAM,WAAW,MAAM;IACrB,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;CACrE;AAED,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,qEAAqE;AACrE,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACjE;AAED,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD;;aAEa;AACb,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B"}

package/dist/ports/tools.js

@@ -0,0 +1,5 @@
+/** The ports behind the built-in tools. Each tool has one name and one input
+ *  shape in every runtime; what does the work is an adapter you plug in here,
+ *  like storage or the queue. */
+export {};
+//# sourceMappingURL=tools.js.map

package/dist/ports/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/ports/tools.ts"],"names":[],"mappings":"AAAA;;iCAEiC"}

package/dist/pricing.d.ts

@@ -25,11 +25,40 @@ export type PriceTable = Record<string, ModelPrice>;
  *  registry key without its '@variant' suffix. */
 export declare function lookupPrice(prices: PriceTable, model?: string | null, modelId?: string | null): ModelPrice | undefined;
 /** A price-list pricer (§4).
+ *
+ *  A cache rate that is missing (or 0) is taken as not given: those tokens
+ *  are priced at `inputPerMillion`, and a warning is logged once per model.
+ *  Cache tokens are never free, and a price list that forgot them must not
+ *  bill them at 0.
  *
  *  A model the table does not know is not priced. Its row is stored with no
  *  cost and `UsageTotals.unpriced` counts it, so a missing price shows up as
  *  a gap in the bill rather than as a silent zero. */
 export declare function table(prices: PriceTable, currency?: string): Pricer;
+/** What a paid tool service costs, in currency units: per use (a search, a
+ *  page), per second of sandbox time (bash, code_execution), or both. */
+export interface ToolPrice {
+    perUse?: number;
+    perSecond?: number;
+}
+/** Tool prices, keyed by adapter name ('brave', 'jina-search') or by tool
+ *  name ('web_search'). The adapter wins: the same tool costs what the
+ *  service behind it charges. */
+export type ToolPriceTable = Record<string, ToolPrice>;
+/** Prices the built-in tools' usage rows (`kind: 'tool'`, `model:
+ *  'tool:<name>'`), per use. Every other row is left to the next pricer, so
+ *  chain it with the model table:
+ *
+ *  ```ts
+ *  pricer: pricing.chain(pricing.table(modelPrices), pricing.tools({ brave: { perUse: 0.005 } }))
+ *  ```
+ *
+ *  Sandbox tools are priced by the sandbox adapter's name and the seconds
+ *  their commands ran: `{ e2b: { perSecond: 0.000028 } }`.
+ *
+ *  A tool's own model calls (reading a page with a question) carry the
+ *  model's key, so the model table prices them. */
+export declare function tools(prices: ToolPriceTable, currency?: string): Pricer;
 /** Pulls a cost out of what the provider attached to the finish: a gateway
  *  receipt, a billing header, whatever your provider sends. Return null when
  *  this call carried no receipt, and the next pricer in a chain gets its

package/dist/pricing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../src/pricing.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,kEAAkE;AAClE,eAAO,MAAM,GAAG,QAAQ,CAAC;AAEzB;;;oBAGoB;AACpB,MAAM,WAAW,UAAU;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;kBAGc;IACd,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;uEAGuE;AACvE,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAEpD;kDACkD;AAClD,wBAAgB,WAAW,CACzB,MAAM,EAAE,UAAU,EAClB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACtB,UAAU,GAAG,SAAS,CAKxB;AAED;;;;sDAIsD;AACtD,wBAAgB,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,GAAE,MAAY,GAAG,MAAM,CAiBxE;AAED;;;YAGY;AACZ,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,GAAG,IAAI,CAAC;AAE7E;;;;yBAIyB;AACzB,wBAAgB,OAAO,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,GAAE,MAAY,GAAG,MAAM,CAU3E;AAED;;;;;;;;;;0BAU0B;AAC1B,wBAAgB,KAAK,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,CAiBnE;AAED;kEACkE;AAClE,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAY,GAAG,MAAM,CAEpE;AAED,sEAAsE;AACtE,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,KAAG,MAAwC,CAAC;AAEjF,2EAA2E;AAC3E,eAAO,MAAM,MAAM,GAAI,GAAG,MAAM,KAAG,MAAuB,CAAC;AAE3D;qBACqB;AACrB,eAAO,MAAM,MAAM,GAAI,GAAG,MAAM,EAAE,WAAU,MAAY,KAAG,MACpB,CAAC"}
+{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../src/pricing.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAEjD,kEAAkE;AAClE,eAAO,MAAM,GAAG,QAAQ,CAAC;AAEzB;;;oBAGoB;AACpB,MAAM,WAAW,UAAU;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;kBAGc;IACd,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;uEAGuE;AACvE,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAEpD;kDACkD;AAClD,wBAAgB,WAAW,CACzB,MAAM,EAAE,UAAU,EAClB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GACtB,UAAU,GAAG,SAAS,CAMxB;AAWD;;;;;;;;;sDASsD;AACtD,wBAAgB,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,GAAE,MAAY,GAAG,MAAM,CA2BxE;AAED;yEACyE;AACzE,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;iCAEiC;AACjC,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAEvD;;;;;;;;;;;;mDAYmD;AACnD,wBAAgB,KAAK,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,GAAE,MAAY,GAAG,MAAM,CAa5E;AAED;;;YAGY;AACZ,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,GAAG,IAAI,CAAC;AAE7E;;;;yBAIyB;AACzB,wBAAgB,OAAO,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,GAAE,MAAY,GAAG,MAAM,CAW3E;AAED;;;;;;;;;;0BAU0B;AAC1B,wBAAgB,KAAK,CAAC,GAAG,OAAO,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,CAiBnE;AAED;kEACkE;AAClE,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAY,GAAG,MAAM,CAEpE;AAED,sEAAsE;AACtE,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,KAAG,MAAwC,CAAC;AAEjF,2EAA2E;AAC3E,eAAO,MAAM,MAAM,GAAI,GAAG,MAAM,KAAG,MAAuB,CAAC;AAE3D;qBACqB;AACrB,eAAO,MAAM,MAAM,GAAI,GAAG,MAAM,EAAE,WAAU,MAAY,KAAG,MACpB,CAAC"}

package/dist/pricing.js

@@ -3,14 +3,27 @@ export const USD = 'USD';
 /** Find a model's price, trying the registry key, the wire id, then the
  *  registry key without its '@variant' suffix. */
 export function lookupPrice(prices, model, modelId) {
-    if (model && prices[model])
-        return prices[model];
-    if (modelId && prices[modelId])
-        return prices[modelId];
+    // Own keys only: a model named 'constructor' or 'toString' must not find
+    // something off the object's prototype.
+    const own = (k) => (k && Object.hasOwn(prices, k) ? prices[k] : undefined);
     const base = model?.split('@')[0];
-    return base && base !== model ? prices[base] : undefined;
+    return own(model) ?? own(modelId) ?? (base !== model ? own(base) : undefined);
+}
+/** Warned once per model and rate, so a price list missing a cache rate says
+ *  so without filling the log. */
+const warned = new Set();
+function warnOnce(key, msg, model) {
+    if (warned.has(key))
+        return;
+    warned.add(key);
+    console.warn(msg, { model });
 }
 /** A price-list pricer (§4).
+ *
+ *  A cache rate that is missing (or 0) is taken as not given: those tokens
+ *  are priced at `inputPerMillion`, and a warning is logged once per model.
+ *  Cache tokens are never free, and a price list that forgot them must not
+ *  bill them at 0.
  *
  *  A model the table does not know is not priced. Its row is stored with no
  *  cost and `UsageTotals.unpriced` counts it, so a missing price shows up as
@@ -24,15 +37,54 @@ export function table(prices, currency = USD) {
             // tokens / 1_000_000 × pricePerMillion is the cost in currency units,
             // and micros is that × 1_000_000. The two cancel: tokens ×
             // pricePerMillion IS the micro-unit cost, with no scaling in between.
+            let cacheRead = p.cacheReadPerMillion ?? 0;
+            let cacheWrite = p.cacheWritePerMillion ?? 0;
+            if (!cacheRead && u.cacheReadInputTokens > 0) {
+                cacheRead = p.inputPerMillion ?? 0;
+                warnOnce(`${u.model}\u0000read`, 'price table has no cache read rate; cache reads priced as input', u.model);
+            }
+            if (!cacheWrite && u.cacheWriteInputTokens > 0) {
+                cacheWrite = p.inputPerMillion ?? 0;
+                warnOnce(`${u.model}\u0000write`, 'price table has no cache write rate; cache writes priced as input', u.model);
+            }
             const micros = u.inputTokens * (p.inputPerMillion ?? 0) +
-                u.cacheReadInputTokens * (p.cacheReadPerMillion ?? 0) +
-                u.cacheWriteInputTokens * (p.cacheWritePerMillion ?? 0) +
+                u.cacheReadInputTokens * cacheRead +
+                u.cacheWriteInputTokens * cacheWrite +
                 u.outputTokens * (p.outputPerMillion ?? 0) +
                 u.reasoningTokens * (p.reasoningPerMillion ?? 0);
             return { micros: Math.round(micros), currency, source: 'table' };
         },
     };
 }
+/** Prices the built-in tools' usage rows (`kind: 'tool'`, `model:
+ *  'tool:<name>'`), per use. Every other row is left to the next pricer, so
+ *  chain it with the model table:
+ *
+ *  ```ts
+ *  pricer: pricing.chain(pricing.table(modelPrices), pricing.tools({ brave: { perUse: 0.005 } }))
+ *  ```
+ *
+ *  Sandbox tools are priced by the sandbox adapter's name and the seconds
+ *  their commands ran: `{ e2b: { perSecond: 0.000028 } }`.
+ *
+ *  A tool's own model calls (reading a page with a question) carry the
+ *  model's key, so the model table prices them. */
+export function tools(prices, currency = USD) {
+    return {
+        price(u) {
+            if (u.kind !== 'tool' || !u.model?.startsWith('tool:'))
+                return null;
+            const p = (u.modelId ? prices[u.modelId] : undefined) ?? prices[u.model.slice('tool:'.length)];
+            if (!p)
+                return null;
+            const meta = u.providerMetadata;
+            const uses = typeof meta?.uses === 'number' && meta.uses > 0 ? meta.uses : 1;
+            const secs = typeof meta?.seconds === 'number' && meta.seconds > 0 ? meta.seconds : 0;
+            const amount = (p.perUse ?? 0) * uses + (p.perSecond ?? 0) * secs;
+            return { micros: Math.round(amount * 1_000_000), currency, source: 'table' };
+        },
+    };
+}
 /** Price a call from the number the provider already computed.
  *
  *  This is the most accurate pricer there is: no price list to keep in step
@@ -44,9 +96,11 @@ export function receipt(read, currency = USD) {
             if (!u.providerMetadata)
                 return null;
             const micros = read(u.providerMetadata);
-            return micros === null || micros === undefined
-                ? null
-                : { micros, currency, source: 'receipt' };
+            // No receipt, or one that makes no sense (not a number, negative, not
+            // finite): not believed, and the call is left for the next pricer.
+            if (typeof micros !== 'number' || !Number.isFinite(micros) || micros < 0)
+                return null;
+            return { micros: Math.round(micros), currency, source: 'receipt' };
         },
     };
 }

package/dist/pricing.js.map

@@ -1 +1 @@
-{"version":3,"file":"pricing.js","sourceRoot":"","sources":["../src/pricing.ts"],"names":[],"mappings":"AAgBA,kEAAkE;AAClE,MAAM,CAAC,MAAM,GAAG,GAAG,KAAK,CAAC;AAwBzB;kDACkD;AAClD,MAAM,UAAU,WAAW,CACzB,MAAkB,EAClB,KAAqB,EACrB,OAAuB;IAEvB,IAAI,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACjD,IAAI,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAClC,OAAO,IAAI,IAAI,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3D,CAAC;AAED;;;;sDAIsD;AACtD,MAAM,UAAU,KAAK,CAAC,MAAkB,EAAE,WAAmB,GAAG;IAC9D,OAAO;QACL,KAAK,CAAC,CAAW;YACf,MAAM,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;YAClD,IAAI,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YACpB,sEAAsE;YACtE,2DAA2D;YAC3D,sEAAsE;YACtE,MAAM,MAAM,GACV,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC;gBACxC,CAAC,CAAC,oBAAoB,GAAG,CAAC,CAAC,CAAC,mBAAmB,IAAI,CAAC,CAAC;gBACrD,CAAC,CAAC,qBAAqB,GAAG,CAAC,CAAC,CAAC,oBAAoB,IAAI,CAAC,CAAC;gBACvD,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC,gBAAgB,IAAI,CAAC,CAAC;gBAC1C,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC,mBAAmB,IAAI,CAAC,CAAC,CAAC;YACnD,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QACnE,CAAC;KACF,CAAC;AACJ,CAAC;AAQD;;;;yBAIyB;AACzB,MAAM,UAAU,OAAO,CAAC,IAAmB,EAAE,WAAmB,GAAG;IACjE,OAAO;QACL,KAAK,CAAC,CAAW;YACf,IAAI,CAAC,CAAC,CAAC,gBAAgB;gBAAE,OAAO,IAAI,CAAC;YACrC,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC;YACxC,OAAO,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS;gBAC5C,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC9C,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;0BAU0B;AAC1B,MAAM,UAAU,KAAK,CAAC,GAAG,OAAkC;IACzD,OAAO;QACL,KAAK,CAAC,KAAK,CAAC,CAAW;YACrB,IAAI,UAAmB,CAAC;YACxB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,IAAI,CAAC,CAAC;oBAAE,SAAS;gBACjB,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBAC9B,IAAI,IAAI;wBAAE,OAAO,IAAI,CAAC;gBACxB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,UAAU,KAAK,GAAG,CAAC;gBACrB,CAAC;YACH,CAAC;YACD,IAAI,UAAU,KAAK,SAAS;gBAAE,MAAM,UAAU,CAAC;YAC/C,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC;AAED;kEACkE;AAClE,MAAM,UAAU,KAAK,CAAC,MAAc,EAAE,WAAmB,GAAG;IAC1D,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;AAClE,CAAC;AAED,sEAAsE;AACtE,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AAEjF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,GAAG,SAAS,CAAC;AAE3D;qBACqB;AACrB,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAS,EAAE,WAAmB,GAAG,EAAU,EAAE,CAClE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"pricing.js","sourceRoot":"","sources":["../src/pricing.ts"],"names":[],"mappings":"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"}