@avow-finance/sdk 0.0.0-stage → 0.2.0

package/dist/session/ollama.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.js","sourceRoot":"","sources":["../../src/session/ollama.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,aAAa,GAEd,MAAM,eAAe,CAAA;AAEtB;;;GAGG;AAEH,uCAAuC;AACvC,MAAM,CAAC,MAAM,UAAU,GAAG,wBAAwB,CAAA;AAElD,sFAAsF;AACtF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,UAAU,EAAE,aAAa,EAAE,UAAU,CAAU,CAAA;AAEtF,oGAAoG;AACpG,MAAM,cAAc,GAAG,MAAM,CAAA;AAE7B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAI,GAAG,UAAU,EACjB,OAAO,GAAiB,KAAK;IAE7B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,IAAI,WAAW,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QACzF,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,IAAI,CAAA;QAC7B,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAsC,CAAA;QACzE,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACzF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,kGAAkG;AAClG,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAa,EACb,IAAI,GAAG,UAAU,EACjB,OAAO,GAAiB,KAAK;IAE7B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,IAAI,WAAW,EAAE;YACjD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC;YAC/B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;SAClC,CAAC,CAAA;QACF,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,IAAI,CAAA;QAC7B,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA+B,CAAA;QAClE,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC;YACrC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;YACrE,CAAC,CAAC,IAAI,CAAA;IACV,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,sFAAsF;AACtF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE,CACrD,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;AAazD,yCAAyC;AACzC,SAAS,UAAU,CAAC,MAAc,EAAE,KAA0B;IAC5D,MAAM,GAAG,GAAoB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;IAClE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;aACnE,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACnC,GAAG,CAAC,IAAI,CAAC;gBACP,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,IAAI,CAAC,IAAI;gBAClB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;oBACvB,CAAC,CAAC;wBACE,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;4BACjC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,KAAK,EAAE;yBAC/C,CAAC,CAAC;qBACJ;oBACH,CAAC,CAAC,EAAE,CAAC;aACR,CAAC,CAAA;QACJ,CAAC;;YAAM,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;IACrF,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAYD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAK7B;IACC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,UAAU,CAAA;IACvC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAA;IACtC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAA;IACzB,OAAO;QACL,IAAI,EAAE,OAAO;QACb,KAAK;QACL,IAAI,EAAE,GAAG,KAAK,4CAA4C;QAC1D,OAAO,EAAE,cAAc;QACvB,KAAK,CAAC,KAAK,CAAC,OAAqB;YAC/B,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;YACjC,IAAI,QAAkB,CAAA;YACtB,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,IAAI,WAAW,EAAE;oBAC3C,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;oBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,KAAK;wBACL,QAAQ,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC;wBACnD,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;4BAC/B,IAAI,EAAE,UAAU;4BAChB,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE;yBACjF,CAAC,CAAC;wBACH,MAAM,EAAE,IAAI;wBACZ,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBAC3C,OAAO,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE;qBACrC,CAAC;oBACF,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACtD,CAAC,CAAA;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;oBAAE,MAAM,KAAK,CAAA;gBACxC,MAAM,IAAI,aAAa,CACrB,6BAA6B,IAAI,4DAA4D,EAC7F,IAAI,EACJ,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAA;YACH,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;gBAClD,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBAC5B,MAAM,IAAI,aAAa,CACrB,uBAAuB,KAAK,8BAA8B,KAAK,GAAG,EAClE,KAAK,CACN,CAAA;gBACH,CAAC;gBACD,MAAM,IAAI,aAAa,CACrB,mBAAmB,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAC5E,QAAQ,CAAC,MAAM,IAAI,GAAG,CACvB,CAAA;YACH,CAAC;YACD,IAAI,IAAI,GAAG,EAAE,CAAA;YACb,MAAM,KAAK,GAAoB,EAAE,CAAA;YACjC,IAAI,YAAY,GAAkB,IAAI,CAAA;YACtC,IAAI,IAAI,GAAiB,IAAI,CAAA;YAC7B,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;YACjC,IAAI,QAAQ,GAAG,EAAE,CAAA;YACjB,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE;gBAC5B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;oBAAE,OAAM;gBACxB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAU,CAAA;gBACvC,IAAI,KAAK,CAAC,KAAK;oBAAE,MAAM,IAAI,aAAa,CAAC,WAAW,KAAK,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,CAAA;gBACzE,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,CAAA;gBAC1C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,UAAU,IAAI,EAAE,CAAA;gBAC7C,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;oBACzD,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,CAAA;gBAC5C,CAAC;gBACD,IAAI,KAAK,EAAE,CAAC;oBACV,IAAI,IAAI,KAAK,CAAA;oBACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBACvB,CAAC;gBACD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;oBACtB,KAAK,CAAC,IAAI,CAAC;wBACT,EAAE,EAAE,QAAQ,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE;wBAC9B,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI;wBACrB,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,SAAS;qBAC5B,CAAC,CAAA;gBACJ,CAAC;gBACD,IAAI,KAAK,CAAC,IAAI;oBAAE,IAAI,GAAG,KAAK,CAAA;YAC9B,CAAC,CAAA;YACD,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,QAAQ,CAAC,IAA4C,EAAE,CAAC;gBAChF,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;gBACnD,IAAI,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;gBACpC,OAAO,OAAO,IAAI,CAAC,EAAE,CAAC;oBACpB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAA;oBAChC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAA;oBACtC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;gBAClC,CAAC;YACH,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,CAAA;YACd,MAAM,QAAQ,GAAG,IAAoB,CAAA;YACrC,OAAO;gBACL,IAAI;gBACJ,KAAK;gBACL,MAAM,EAAE,IAAI;gBACZ,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK;gBACxF,MAAM,EAAE;oBACN,YAAY;oBACZ,MAAM,EAAE,QAAQ,EAAE,UAAU,IAAI,IAAI;oBACpC,YAAY,EACV,QAAQ,EAAE,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,GAAG,SAAS;oBACnF,OAAO,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO;iBACrC;aACF,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/session/provider.d.ts

@@ -0,0 +1,79 @@
+import type { ToolSpec } from './tools.js';
+/**
+ * One interface for every model the session can talk to. The session keeps the conversation in
+ * this neutral shape and each provider maps it to its own wire form, so the tool layer, the
+ * executor and the eval never depend on which model is speaking.
+ */
+/** The providers the session knows, as `--provider` names them. */
+export declare const PROVIDER_KINDS: readonly ['local', 'anthropic', 'scripted'];
+export type ProviderKind = (typeof PROVIDER_KINDS)[number];
+/** A tool call a model asked for, with the id its provider pairs the result by. */
+export interface ModelToolCall {
+    id: string;
+    name: string;
+    /** The model's input as its provider parsed it. It's untrusted until the tool layer reads it. */
+    input: unknown;
+}
+/** One turn of the conversation, as the session replays it to the provider. */
+export type ChatTurn = {
+    role: 'user';
+    text: string;
+} | {
+    role: 'assistant';
+    text: string;
+    calls: readonly ModelToolCall[];
+    /** What the provider needs to replay the turn exactly, such as Anthropic's content blocks. */
+    native: unknown;
+} | {
+    role: 'tool';
+    call: ModelToolCall;
+    content: string;
+    ok: boolean;
+};
+/** What one model turn gave back. */
+export interface ModelReply {
+    text: string;
+    calls: ModelToolCall[];
+    native: unknown;
+    /** Whether the model ended its turn, asked for tools, or ran out of room. */
+    stop: 'end' | 'tools' | 'length';
+    /** Timings for the eval's speed report, when the provider measures them. */
+    timing: ReplyTiming | null;
+}
+export interface ReplyTiming {
+    /** Milliseconds from the request to the first piece of the reply. */
+    firstTokenMs: number | null;
+    /** Tokens the model generated, and the milliseconds it spent generating them. */
+    tokens: number | null;
+    generatingMs: number | null;
+    totalMs: number;
+}
+export interface ReplyRequest {
+    system: string;
+    turns: readonly ChatTurn[];
+    tools: readonly ToolSpec[];
+    /** Each piece of the model's words as it arrives, for the terminal to draw. */
+    onText: (piece: string) => void;
+    signal?: AbortSignal;
+}
+export interface ModelProvider {
+    readonly kind: ProviderKind;
+    /** The model's id, which names every line it speaks. */
+    readonly model: string;
+    /** The line the session shows before the first call: the model, where it runs and who pays. */
+    readonly line: string;
+    /** Whether the conversation leaves this machine, and for whom. */
+    readonly reaches: 'this machine' | 'Anthropic';
+    reply(request: ReplyRequest): Promise<ModelReply>;
+}
+/** A provider that failed, with what the developer can do about it. */
+export declare class ProviderError extends Error {
+    /** Whether asking again later can work, as after a rate limit or a model still loading. */
+    readonly retryable: boolean;
+    constructor(message: string, 
+    /** Whether asking again later can work, as after a rate limit or a model still loading. */
+    retryable: boolean, options?: {
+        cause?: unknown;
+    });
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/session/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/session/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE1C;;;;GAIG;AAEH,mEAAmE;AACnE,eAAO,MAAM,cAAc,YAAI,OAAO,EAAE,WAAW,EAAE,UAAU,CAAU,CAAA;AACzE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAA;AAE1D,mFAAmF;AACnF,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,iGAAiG;IACjG,KAAK,EAAE,OAAO,CAAA;CACf;AAED,+EAA+E;AAC/E,MAAM,MAAM,QAAQ,GAChB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IACE,IAAI,EAAE,WAAW,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,SAAS,aAAa,EAAE,CAAA;IAC/B,8FAA8F;IAC9F,MAAM,EAAE,OAAO,CAAA;CAChB,GACD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAA;CAAE,CAAA;AAEvE,qCAAqC;AACrC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,aAAa,EAAE,CAAA;IACtB,MAAM,EAAE,OAAO,CAAA;IACf,6EAA6E;IAC7E,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAA;IAChC,4EAA4E;IAC5E,MAAM,EAAE,WAAW,GAAG,IAAI,CAAA;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,qEAAqE;IACrE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,iFAAiF;IACjF,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAA;IAC1B,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAA;IAC1B,+EAA+E;IAC/E,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,+FAA+F;IAC/F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,WAAW,CAAA;IAC9C,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;CAClD;AAED,uEAAuE;AACvE,qBAAa,aAAc,SAAQ,KAAK;IAGpC,2FAA2F;IAC3F,QAAQ,CAAC,SAAS,EAAE,OAAO;IAH7B,YACE,OAAO,EAAE,MAAM;IACf,2FAA2F;IAClF,SAAS,EAAE,OAAO,EAC3B,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAI9B;CACF"}

package/dist/session/provider.js

@@ -0,0 +1,19 @@
+/**
+ * One interface for every model the session can talk to. The session keeps the conversation in
+ * this neutral shape and each provider maps it to its own wire form, so the tool layer, the
+ * executor and the eval never depend on which model is speaking.
+ */
+/** The providers the session knows, as `--provider` names them. */
+export const PROVIDER_KINDS = ['local', 'anthropic', 'scripted'];
+/** A provider that failed, with what the developer can do about it. */
+export class ProviderError extends Error {
+    retryable;
+    constructor(message, 
+    /** Whether asking again later can work, as after a rate limit or a model still loading. */
+    retryable, options) {
+        super(message, options);
+        this.retryable = retryable;
+        this.name = 'ProviderError';
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/session/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/session/provider.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,mEAAmE;AACnE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,CAAU,CAAA;AA+DzE,uEAAuE;AACvE,MAAM,OAAO,aAAc,SAAQ,KAAK;IAI3B,SAAS;IAHpB,YACE,OAAe;IACf,2FAA2F;IAClF,SAAkB,EAC3B,OAA6B;QAE7B,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;yBAHd,SAAS;QAIlB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAA;IAC7B,CAAC;CACF"}

package/dist/session/scripted.d.ts

@@ -0,0 +1,45 @@
+import type { ModelProvider } from './provider.js';
+/**
+ * Scripted decisions in place of a model, so a run is the same every time. It reads the tool
+ * results the session gave it and decides as a careful agent would: the cheapest firm offer that
+ * holds the job's GPUs for its whole run within the budget, then a quote naming that booking. It
+ * speaks as `scripted`, so nothing it says can pass for a model's words.
+ */
+/** What the session says when an order comes in, which starts a job's run. */
+export declare const ORDER_PROMPT = "New order";
+/** What the session says when the developer switched compute off and still wants a quote. */
+export declare const SWITCH_OFF_PROMPT = "switched compute off";
+/** How the session's prompt starts when the customer refused a quote and the agent explains it. */
+export declare const CUSTOMER_REFUSED_PROMPT = "The customer refused the quote";
+interface OfferSeen {
+    id: string;
+    gpusPerBooking: string;
+    windowStarts: string;
+    windowEnds: string;
+    pricePerGpuHour: string;
+    freeCancellation: string;
+}
+interface ListingSeen {
+    offers: OfferSeen[];
+    limits: {
+        computeBudgetPerGpuHour: string;
+        computeSwitch: 'on' | 'off';
+    };
+}
+interface OrderSeen {
+    orderId: string;
+    needs: {
+        gpu: string;
+        gpus: number;
+    };
+    deliverBy: string;
+}
+/** The offer a careful agent books for the order, or why there's none. */
+export declare function chooseOffer(order: OrderSeen, listing: ListingSeen): {
+    offer: OfferSeen;
+} | {
+    none: string;
+};
+export declare function scriptedProvider(): ModelProvider;
+export {};
+//# sourceMappingURL=scripted.d.ts.map

package/dist/session/scripted.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripted.d.ts","sourceRoot":"","sources":["../../src/session/scripted.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,aAAa,EAId,MAAM,eAAe,CAAA;AAEtB;;;;;GAKG;AAEH,8EAA8E;AAC9E,eAAO,MAAM,YAAY,cAAc,CAAA;AACvC,6FAA6F;AAC7F,eAAO,MAAM,iBAAiB,yBAAyB,CAAA;AACvD,mGAAmG;AACnG,eAAO,MAAM,uBAAuB,mCAAmC,CAAA;AAEvE,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAA;IACV,cAAc,EAAE,MAAM,CAAA;IACtB,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;IACvB,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED,UAAU,WAAW;IACnB,MAAM,EAAE,SAAS,EAAE,CAAA;IACnB,MAAM,EAAE;QAAE,uBAAuB,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,IAAI,GAAG,KAAK,CAAA;KAAE,CAAA;CACzE;AAED,UAAU,SAAS;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACpC,SAAS,EAAE,MAAM,CAAA;CAClB;AAoBD,0EAA0E;AAC1E,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,WAAW,GACnB;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAyBzC;AA2KD,wBAAgB,gBAAgB,IAAI,aAAa,CAwBhD"}

package/dist/session/scripted.js

@@ -0,0 +1,236 @@
+import { SCRIPTED_MODEL } from '@avow-finance/spec';
+/**
+ * Scripted decisions in place of a model, so a run is the same every time. It reads the tool
+ * results the session gave it and decides as a careful agent would: the cheapest firm offer that
+ * holds the job's GPUs for its whole run within the budget, then a quote naming that booking. It
+ * speaks as `scripted`, so nothing it says can pass for a model's words.
+ */
+/** What the session says when an order comes in, which starts a job's run. */
+export const ORDER_PROMPT = 'New order';
+/** What the session says when the developer switched compute off and still wants a quote. */
+export const SWITCH_OFF_PROMPT = 'switched compute off';
+/** How the session's prompt starts when the customer refused a quote and the agent explains it. */
+export const CUSTOMER_REFUSED_PROMPT = 'The customer refused the quote';
+const dollars = (text) => Number(text.replace(/[^0-9.]/g, ''));
+/** Minutes after the job starts that a time the tool layer wrote names, negative before it. */
+function minutesFromStart(text) {
+    if (text.includes('when the job starts'))
+        return 0;
+    const m = /(\d+) min (before|after) the job starts/.exec(text);
+    if (!m)
+        return null;
+    return Number(m[1]) * (m[2] === 'before' ? -1 : 1);
+}
+/** Whether an offer takes a booking of `count` GPUs, as the tool layer wrote its range. */
+function takes(offer, count) {
+    const exactly = /^exactly (\d+)$/.exec(offer.gpusPerBooking);
+    if (exactly)
+        return Number(exactly[1]) === count;
+    const range = /^(\d+) to (\d+)$/.exec(offer.gpusPerBooking);
+    return range ? count >= Number(range[1]) && count <= Number(range[2]) : false;
+}
+/** The offer a careful agent books for the order, or why there's none. */
+export function chooseOffer(order, listing) {
+    const due = minutesFromStart(order.deliverBy) ?? 0;
+    const budget = dollars(listing.limits.computeBudgetPerGpuHour);
+    const fits = listing.offers.filter((o) => {
+        const from = minutesFromStart(o.windowStarts);
+        const to = minutesFromStart(o.windowEnds);
+        return (o.freeCancellation.startsWith('none') &&
+            from !== null &&
+            to !== null &&
+            from <= 0 &&
+            to >= due &&
+            takes(o, order.needs.gpus));
+    });
+    if (fits.length === 0) {
+        return { none: 'none of the offers is firm and holds the GPUs for the whole job' };
+    }
+    const affordable = fits.filter((o) => dollars(o.pricePerGpuHour) <= budget);
+    const [cheapest] = [...affordable].sort((a, b) => dollars(a.pricePerGpuHour) - dollars(b.pricePerGpuHour));
+    if (!cheapest)
+        return { none: `every offer that fits costs more than the $${budget.toFixed(2)} budget` };
+    return { offer: cheapest };
+}
+/** The turns since the latest thing the developer or the session said. */
+function sinceAsked(turns) {
+    let i = turns.length - 1;
+    while (i >= 0 && turns[i]?.role !== 'user')
+        i--;
+    const asked = turns[i];
+    return {
+        prompt: asked?.role === 'user' ? asked.text : '',
+        results: turns
+            .slice(i + 1)
+            .filter((t) => t.role === 'tool'),
+    };
+}
+/** The latest result of a tool anywhere in the conversation, as the JSON it carried. */
+function latest(turns, tool, ok = true) {
+    for (let i = turns.length - 1; i >= 0; i--) {
+        const t = turns[i];
+        if (t?.role === 'tool' && t.call.name === tool && t.ok === ok) {
+            try {
+                return JSON.parse(t.content);
+            }
+            catch {
+                return null;
+            }
+        }
+    }
+    return null;
+}
+let nextCall = 1;
+const call = (name, input = {}) => ({
+    id: `scripted_${nextCall++}`,
+    name,
+    input,
+});
+/**
+ * A refusal a tool gave, said as its layer and code and what would let it pass. The refusal's own
+ * sentence is already on the screen, so only its last sentence, which says what would let the same
+ * thing pass, is said again.
+ */
+function refusalLine(content) {
+    try {
+        const r = JSON.parse(content);
+        const passes = (r.sentence ?? r.why ?? '').split(/(?<=\.)\s+/).at(-1) ?? '';
+        return `It was refused at the ${r.layer} layer with ${r.code}. ${passes}`.trim();
+    }
+    catch {
+        return 'It was refused.';
+    }
+}
+/** The next step for the run the latest prompt started, given what the tools gave back so far. */
+function decide(turns) {
+    const { prompt, results } = sinceAsked(turns);
+    const last = results.at(-1);
+    const done = (tool) => results.find((r) => r.call.name === tool);
+    if (prompt.startsWith(ORDER_PROMPT) || prompt.includes(SWITCH_OFF_PROMPT)) {
+        if (!done('read_order'))
+            return { text: '', calls: [call('read_order')] };
+        if (!done('compute_offers'))
+            return { text: '', calls: [call('compute_offers')] };
+        const order = latest(turns, 'read_order');
+        const listing = latest(turns, 'compute_offers');
+        if (!order || !listing)
+            return { text: "I couldn't read the order or the offers.", calls: [] };
+        const quoted = done('submit_quote');
+        if (quoted) {
+            return quoted.ok
+                ? {
+                    text: `I quoted order ${order.orderId}. The customer checks the quote and the booking it names before it commits.`,
+                    calls: [],
+                }
+                : { text: `The quote didn't go out. ${refusalLine(quoted.content)}`, calls: [] };
+        }
+        if (listing.limits.computeSwitch === 'off') {
+            return {
+                text: 'Compute booking is off for this order, so I book nothing and quote without a booking, as you asked. The customer requires a compute booking, so I expect it to refuse.',
+                calls: [call('submit_quote')],
+            };
+        }
+        const booked = done('book_compute');
+        if (!booked) {
+            const choice = chooseOffer(order, listing);
+            if ('none' in choice)
+                return { text: `I booked nothing, since ${choice.none}.`, calls: [] };
+            return {
+                text: `I'll book ${order.needs.gpus} ${order.needs.gpu} of ${choice.offer.id} at ${choice.offer.pricePerGpuHour} per GPU-hour, the cheapest firm offer that holds the GPUs from the job's start past its deadline.`,
+                calls: [call('book_compute', { offer: choice.offer.id, quantity: order.needs.gpus })],
+            };
+        }
+        if (!booked.ok)
+            return { text: `I couldn't book the compute. ${refusalLine(booked.content)}`, calls: [] };
+        const booking = JSON.parse(booked.content).booking;
+        return { text: '', calls: [call('submit_quote', { booking })] };
+    }
+    // The quote went out and the customer answered it, so the agent explains and quotes nothing again.
+    if (prompt.startsWith(CUSTOMER_REFUSED_PROMPT)) {
+        const refused = /with ([a-z_.]+), at the ([a-z]+) layer/.exec(prompt);
+        return {
+            text: refused
+                ? `The customer refused my quote with ${refused[1]} at the ${refused[2]} layer, so no work started and nothing was charged. The order is closed, and the next one comes with job.`
+                : 'The customer refused my quote, so no work started and nothing was charged.',
+            calls: [],
+        };
+    }
+    if (/\bwhy\b/i.test(prompt)) {
+        const booking = latest(turns, 'book_compute');
+        const listing = latest(turns, 'compute_offers');
+        if (!booking || !listing)
+            return { text: "I haven't booked any compute yet.", calls: [] };
+        const chosen = listing.offers.find((o) => o.id === booking.offer);
+        const others = listing.offers.filter((o) => o.id !== booking.offer);
+        const why = others.map((o) => !o.freeCancellation.startsWith('none')
+            ? `${o.id} could still be cancelled for free, and the customer won't rely on that`
+            : !takes(o, 1)
+                ? `${o.id} only takes ${o.gpusPerBooking} GPUs in one booking`
+                : `${o.id} doesn't hold the GPUs for the whole job`);
+        return {
+            text: `I chose ${booking.offer} at ${chosen?.pricePerGpuHour ?? 'its rate'} per GPU-hour, under the ${listing.limits.computeBudgetPerGpuHour} budget in service.ts, with a ${booking.reserve} reserve inside my authority. ${why.join('. ')}.`,
+            calls: [],
+        };
+    }
+    const gpus = /(\d+)\s*(?:H100s?|GPUs?)/i.exec(prompt);
+    if (gpus) {
+        if (last?.call.name === 'book_compute') {
+            return last.ok
+                ? { text: 'That booking went through.', calls: [] }
+                : { text: `I couldn't book ${gpus[1]} GPUs. ${refusalLine(last.content)}`, calls: [] };
+        }
+        const listing = latest(turns, 'compute_offers');
+        const offer = listing?.offers.find((o) => takes(o, Number(gpus[1])) && o.freeCancellation.startsWith('none'));
+        if (!offer)
+            return { text: `No offer I've seen takes ${gpus[1]} GPUs.`, calls: [] };
+        return {
+            text: `I'll try to book ${gpus[1]} GPUs of ${offer.id}.`,
+            calls: [call('book_compute', { offer: offer.id, quantity: Number(gpus[1]) })],
+        };
+    }
+    if (/\bquote\b/i.test(prompt)) {
+        if (last?.call.name === 'submit_quote') {
+            return last.ok
+                ? { text: 'The quote went out, and the customer checks it now.', calls: [] }
+                : { text: `The quote didn't go out. ${refusalLine(last.content)}`, calls: [] };
+        }
+        const listing = latest(turns, 'compute_offers');
+        const booking = latest(turns, 'book_compute');
+        const off = listing?.limits.computeSwitch === 'off';
+        return {
+            text: off ? 'I quote without a booking, since compute is switched off.' : '',
+            calls: [call('submit_quote', off || !booking ? {} : { booking: booking.booking })],
+        };
+    }
+    return {
+        text: "I take orders from Avow's test customer, compare compute offers, book compute and quote. Ask me why I chose an offer, or ask for a booking.",
+        calls: [],
+    };
+}
+export function scriptedProvider() {
+    return {
+        kind: 'scripted',
+        model: SCRIPTED_MODEL,
+        line: 'scripted decisions, the same every run, with no model and no charge',
+        reaches: 'this machine',
+        async reply(request) {
+            const started = performance.now();
+            const { text, calls } = decide(request.turns);
+            if (text)
+                request.onText(text);
+            return {
+                text,
+                calls,
+                native: null,
+                stop: calls.length > 0 ? 'tools' : 'end',
+                timing: {
+                    firstTokenMs: 0,
+                    tokens: null,
+                    generatingMs: null,
+                    totalMs: performance.now() - started,
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=scripted.js.map

package/dist/session/scripted.js.map

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

package/dist/session/selection.d.ts

@@ -0,0 +1,37 @@
+import { type ModelProvider } from './provider.js';
+/**
+ * Picks the model the session talks to, so nobody is surprised by a bill. An explicit choice wins,
+ * and when it can't be used it stays a visible failure and nothing switches. With nothing explicit,
+ * only a free model on this machine is picked: Ollama, running, with a supported model pulled. A
+ * paid provider runs only once it's chosen, so a key in the environment is never enough. With no
+ * free model ready, it runs the scripted decisions, which cost nothing, and says so before the first
+ * turn, with how to get a model.
+ */
+export interface SelectionInput {
+    /** `--provider`, or `AVOW_MODEL_PROVIDER`. */
+    provider: string | null;
+    /** `--model`, or `AVOW_MODEL`. */
+    model: string | null;
+    /** `--scripted`. */
+    scripted: boolean;
+    /** The environment, for the Anthropic key, which is only ever read from there. */
+    env: Readonly<Record<string, string | undefined>>;
+    ollamaUrl?: string;
+    fetch?: typeof fetch;
+}
+export type Selection = {
+    ok: true;
+    provider: ModelProvider;
+    chosen: 'explicit' | 'automatic';
+    /** Set when no free model was ready and the scripted decisions run in its place. */
+    fallback?: {
+        why: string;
+        help: string[];
+    };
+} | {
+    ok: false;
+    why: string;
+    help: string[];
+};
+export declare function selectProvider(input: SelectionInput): Promise<Selection>;
+//# sourceMappingURL=selection.d.ts.map

package/dist/session/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../../src/session/selection.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,aAAa,EAAkB,MAAM,eAAe,CAAA;AAGlE;;;;;;;GAOG;AAEH,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,kCAAkC;IAClC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,oBAAoB;IACpB,QAAQ,EAAE,OAAO,CAAA;IACjB,kFAAkF;IAClF,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAA;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CACrB;AAED,MAAM,MAAM,SAAS,GACjB;IACE,EAAE,EAAE,IAAI,CAAA;IACR,QAAQ,EAAE,aAAa,CAAA;IACvB,MAAM,EAAE,UAAU,GAAG,WAAW,CAAA;IAChC,oFAAoF;IACpF,QAAQ,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;CAC3C,GACD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAAA;AAoE9C,wBAAsB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CA4C9E"}

package/dist/session/selection.js

@@ -0,0 +1,104 @@
+import { ANTHROPIC_MODEL, anthropicProvider } from './anthropic.js';
+import { localCapabilities, localModels, localProvider, OLLAMA_URL, SUPPORTED_LOCAL_MODELS, sameLocalModel, } from './ollama.js';
+import { PROVIDER_KINDS } from './provider.js';
+import { scriptedProvider } from './scripted.js';
+/** How to get a model, said when none is ready. */
+function helpLines(env) {
+    return [
+        `For a model on this machine at no charge, install Ollama from https://ollama.com and run ollama pull ${SUPPORTED_LOCAL_MODELS[0]}.`,
+        `For Claude, run npm start -- --provider anthropic with ANTHROPIC_API_KEY set. Each call is billed to that key.${env.ANTHROPIC_API_KEY ? ' The key is set, but the session uses it only when you choose it.' : ''}`,
+    ];
+}
+/** The scripted decisions, run because no free model was ready and nothing was chosen. */
+const scriptedInstead = (why, env) => ({
+    ok: true,
+    provider: scriptedProvider(),
+    chosen: 'automatic',
+    fallback: { why, help: helpLines(env) },
+});
+async function local(model, explicit, input) {
+    const base = input.ollamaUrl ?? OLLAMA_URL;
+    const pulled = await localModels(base, input.fetch);
+    if (pulled === null) {
+        return explicit
+            ? {
+                ok: false,
+                why: `You chose Ollama, and it isn't answering at ${base}. Open the Ollama app or run ollama serve.`,
+                help: [],
+            }
+            : scriptedInstead('No model is running on this machine, so your agent runs scripted decisions, the same every run and free.', input.env);
+    }
+    const name = model
+        ? pulled.find((p) => sameLocalModel(p, model))
+        : SUPPORTED_LOCAL_MODELS.map((s) => pulled.find((p) => sameLocalModel(p, s))).find(Boolean);
+    if (!name) {
+        return model
+            ? {
+                ok: false,
+                why: `Ollama has no model ${model}. Pull it with ollama pull ${model}.`,
+                help: [],
+            }
+            : scriptedInstead(`Ollama has none of the supported models pulled (${SUPPORTED_LOCAL_MODELS.join(', ')}), so your agent runs scripted decisions, the same every run and free.`, input.env);
+    }
+    const capabilities = await localCapabilities(name, base, input.fetch);
+    if (capabilities && !capabilities.includes('tools')) {
+        return { ok: false, why: `${name} can't call tools, which the session needs.`, help: [] };
+    }
+    return {
+        ok: true,
+        provider: localProvider({
+            model: name,
+            thinks: capabilities?.includes('thinking') ?? false,
+            base,
+            ...(input.fetch ? { fetch: input.fetch } : {}),
+        }),
+        chosen: explicit ? 'explicit' : 'automatic',
+    };
+}
+export async function selectProvider(input) {
+    if (input.scripted) {
+        if (input.provider && input.provider !== 'scripted') {
+            return {
+                ok: false,
+                why: `--scripted and --provider ${input.provider} can't both be chosen.`,
+                help: [],
+            };
+        }
+        return { ok: true, provider: scriptedProvider(), chosen: 'explicit' };
+    }
+    const kind = input.provider;
+    if (kind === null)
+        return local(input.model, input.model !== null, input);
+    switch (kind) {
+        case 'local':
+            return local(input.model, true, input);
+        case 'scripted':
+            return { ok: true, provider: scriptedProvider(), chosen: 'explicit' };
+        case 'anthropic': {
+            const apiKey = input.env.ANTHROPIC_API_KEY;
+            if (!apiKey) {
+                return {
+                    ok: false,
+                    why: "You chose Anthropic, and ANTHROPIC_API_KEY isn't set in this environment. Set it there, and the session reads it from there only.",
+                    help: [],
+                };
+            }
+            return {
+                ok: true,
+                provider: anthropicProvider({
+                    apiKey,
+                    model: input.model ?? ANTHROPIC_MODEL,
+                    ...(input.fetch ? { fetch: input.fetch } : {}),
+                }),
+                chosen: 'explicit',
+            };
+        }
+        default:
+            return {
+                ok: false,
+                why: `There's no provider ${kind}. Choose one of ${PROVIDER_KINDS.join(', ')}.`,
+                help: [],
+            };
+    }
+}
+//# sourceMappingURL=selection.js.map

package/dist/session/selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../src/session/selection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACnE,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,UAAU,EACV,sBAAsB,EACtB,cAAc,GACf,MAAM,aAAa,CAAA;AACpB,OAAO,EAAsB,cAAc,EAAE,MAAM,eAAe,CAAA;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAkChD,mDAAmD;AACnD,SAAS,SAAS,CAAC,GAA0B;IAC3C,OAAO;QACL,wGAAwG,sBAAsB,CAAC,CAAC,CAAC,GAAG;QACpI,iHAAiH,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,mEAAmE,CAAC,CAAC,CAAC,EAAE,EAAE;KACpN,CAAA;AACH,CAAC;AAED,0FAA0F;AAC1F,MAAM,eAAe,GAAG,CAAC,GAAW,EAAE,GAA0B,EAAa,EAAE,CAAC,CAAC;IAC/E,EAAE,EAAE,IAAI;IACR,QAAQ,EAAE,gBAAgB,EAAE;IAC5B,MAAM,EAAE,WAAW;IACnB,QAAQ,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE;CACxC,CAAC,CAAA;AAEF,KAAK,UAAU,KAAK,CAClB,KAAoB,EACpB,QAAiB,EACjB,KAAqB;IAErB,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,IAAI,UAAU,CAAA;IAC1C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IACnD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,QAAQ;YACb,CAAC,CAAC;gBACE,EAAE,EAAE,KAAK;gBACT,GAAG,EAAE,+CAA+C,IAAI,4CAA4C;gBACpG,IAAI,EAAE,EAAE;aACT;YACH,CAAC,CAAC,eAAe,CACb,0GAA0G,EAC1G,KAAK,CAAC,GAAG,CACV,CAAA;IACP,CAAC;IACD,MAAM,IAAI,GAAG,KAAK;QAChB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC9C,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC7F,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,KAAK;YACV,CAAC,CAAC;gBACE,EAAE,EAAE,KAAK;gBACT,GAAG,EAAE,uBAAuB,KAAK,8BAA8B,KAAK,GAAG;gBACvE,IAAI,EAAE,EAAE;aACT;YACH,CAAC,CAAC,eAAe,CACb,mDAAmD,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,wEAAwE,EAC5J,KAAK,CAAC,GAAG,CACV,CAAA;IACP,CAAC;IACD,MAAM,YAAY,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAA;IACrE,IAAI,YAAY,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACpD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,6CAA6C,EAAE,IAAI,EAAE,EAAE,EAAE,CAAA;IAC3F,CAAC;IACD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,QAAQ,EAAE,aAAa,CAAC;YACtB,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK;YACnD,IAAI;YACJ,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/C,CAAC;QACF,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW;KAC5C,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAqB;IACxD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;YACpD,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,GAAG,EAAE,6BAA6B,KAAK,CAAC,QAAQ,wBAAwB;gBACxE,IAAI,EAAE,EAAE;aACT,CAAA;QACH,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,gBAAgB,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAA;IACvE,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAA;IAC3B,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,KAAK,IAAI,EAAE,KAAK,CAAC,CAAA;IACzE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,OAAO;YACV,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;QACxC,KAAK,UAAU;YACb,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,gBAAgB,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAA;QACvE,KAAK,WAAW,EAAE,CAAC;YACjB,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAA;YAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO;oBACL,EAAE,EAAE,KAAK;oBACT,GAAG,EAAE,mIAAmI;oBACxI,IAAI,EAAE,EAAE;iBACT,CAAA;YACH,CAAC;YACD,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,QAAQ,EAAE,iBAAiB,CAAC;oBAC1B,MAAM;oBACN,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,eAAe;oBACrC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC/C,CAAC;gBACF,MAAM,EAAE,UAAU;aACnB,CAAA;QACH,CAAC;QACD;YACE,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,GAAG,EAAE,uBAAuB,IAAI,mBAAmB,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;gBAC/E,IAAI,EAAE,EAAE;aACT,CAAA;IACL,CAAC;AACH,CAAC"}

package/dist/session/service-check.d.ts

@@ -0,0 +1,48 @@
+import { type CommitmentReference, type PinnedBlock, type Side } from '@avow-finance/spec';
+import { type LockedBacking, type PinnedLockReader } from '@avow-finance/verifier';
+import { type Address, type Hex } from 'viem';
+import type { CommitmentCheck, ReservedJob, ServiceChecks } from './service.js';
+/**
+ * The read-only checks `checkBeforeWork` gets as `avow`. They read the chain at one finalized block
+ * and nothing else, and they hold no key, so the developer's own code can run them in a process
+ * with none.
+ */
+/** Where the checks read the chain: a reader pinned to finalized blocks, and full lock records. */
+export interface CommitmentChain {
+    readers: readonly PinnedLockReader[];
+    /** A lock's whole record of one side of a commitment as of a block, or null when it holds none. */
+    backing(lock: Address, commitmentId: Hex, side: Side, at: bigint): Promise<LockedBacking | null>;
+}
+/**
+ * The customer's commitment and its reserve, read at one finalized block. `verifyJobVerification`
+ * reads the commitment and each compute booking the job relies on at that block, and the lock's
+ * whole record is read at the same block, so every field the lock enforces is checked against the
+ * job's terms as of the block the check names.
+ */
+export declare function verifyCommitment(job: ReservedJob, chain: CommitmentChain, now: bigint): Promise<CommitmentCheck>;
+/** The checks bound to one chain, as `checkBeforeWork` gets them. */
+export declare function serviceChecks(chain: CommitmentChain, now: () => bigint): ServiceChecks;
+/**
+ * The chain at one block as a test or the eval holds it in memory, which a child process can't
+ * read. The parent hands it over as data, and the checks read it through the same interfaces they
+ * read a live chain through.
+ */
+export interface ChainSnapshot {
+    chainId: number;
+    factory: Address;
+    block: PinnedBlock;
+    locks: {
+        address: Address;
+        account: Address;
+        records: {
+            commitmentId: Hex;
+            side: Side;
+            record: LockedBacking;
+        }[];
+    }[];
+}
+/** A snapshot's chain, read as a live one is. */
+export declare function snapshotChain(snapshot: ChainSnapshot): CommitmentChain;
+/** The references of a job's commitment and its bookings, whose records a snapshot has to hold. */
+export declare const snapshotReferences: (job: ReservedJob) => CommitmentReference[];
+//# sourceMappingURL=service-check.d.ts.map

package/dist/session/service-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-check.d.ts","sourceRoot":"","sources":["../../src/session/service-check.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EAGxB,KAAK,WAAW,EAChB,KAAK,IAAI,EACV,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EAEtB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,GAAG,EAAkB,MAAM,MAAM,CAAA;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAE/E;;;;GAIG;AAEH,mGAAmG;AACnG,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAA;IACpC,mGAAmG;IACnG,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;CACjG;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,eAAe,EACtB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,eAAe,CAAC,CAuC1B;AAED,qEAAqE;AACrE,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,MAAM,GAAG,aAAa,CAEtF;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,WAAW,CAAA;IAClB,KAAK,EAAE;QACL,OAAO,EAAE,OAAO,CAAA;QAChB,OAAO,EAAE,OAAO,CAAA;QAChB,OAAO,EAAE;YAAE,YAAY,EAAE,GAAG,CAAC;YAAC,IAAI,EAAE,IAAI,CAAC;YAAC,MAAM,EAAE,aAAa,CAAA;SAAE,EAAE,CAAA;KACpE,EAAE,CAAA;CACJ;AAED,iDAAiD;AACjD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,GAAG,eAAe,CAkCtE;AAED,mGAAmG;AACnG,eAAO,MAAM,kBAAkB,QAAS,WAAW,KAAG,mBAAmB,EAGxE,CAAA"}