@halo-sdk/core 1.0.0

package/dist/prefix.js

@@ -0,0 +1,84 @@
+import { createHash } from "node:crypto";
+export class StablePrefix {
+    _system;
+    _toolSpecs;
+    _fewShots;
+    _hashFn;
+    _fingerprintCache = null;
+    constructor(opts) {
+        this._system = opts.system;
+        this._toolSpecs = [...opts.tools];
+        this._fewShots = [...(opts.fewShots ?? [])];
+        this._hashFn = opts.hashFn ?? defaultHash;
+    }
+    /** Messages that form the stable prefix: [system, ...fewShots]. */
+    toMessages() {
+        return [{ role: "system", content: this._system }, ...this._fewShots.map((m) => ({ ...m }))];
+    }
+    /** Shallow copy of the tool list. */
+    tools() {
+        return this._toolSpecs.map((t) => ({ ...t, function: { ...t.function } }));
+    }
+    /** SHA-256[:16] fingerprint of the entire prefix. */
+    get fingerprint() {
+        if (this._fingerprintCache !== null)
+            return this._fingerprintCache;
+        this._fingerprintCache = this.computeFingerprint();
+        return this._fingerprintCache;
+    }
+    get diagnostics() {
+        return {
+            systemHash: this._hashFn(JSON.stringify(this._system)),
+            toolSpecsHash: this._hashFn(JSON.stringify(this._toolSpecs)),
+            fewShotsHash: this._hashFn(JSON.stringify(this._fewShots)),
+            toolCount: this._toolSpecs.length,
+            toolNames: this._toolSpecs.map((t) => t.function.name).filter(Boolean),
+        };
+    }
+    // ── Mutation ──
+    addTool(spec) {
+        const name = spec.function?.name;
+        if (!name)
+            return false;
+        if (this._toolSpecs.some((t) => t.function?.name === name))
+            return false;
+        this._toolSpecs.push(spec);
+        this.invalidate();
+        return true;
+    }
+    removeTool(name) {
+        const idx = this._toolSpecs.findIndex((t) => t.function?.name === name);
+        if (idx < 0)
+            return false;
+        this._toolSpecs.splice(idx, 1);
+        this.invalidate();
+        return true;
+    }
+    addFewShot(msg) {
+        this._fewShots.push(msg);
+        this.invalidate();
+    }
+    removeFewShot(index) {
+        if (index < 0 || index >= this._fewShots.length)
+            return false;
+        this._fewShots.splice(index, 1);
+        this.invalidate();
+        return true;
+    }
+    // ── Private ──
+    invalidate() {
+        this._fingerprintCache = null;
+    }
+    computeFingerprint() {
+        const blob = JSON.stringify({
+            system: this._system,
+            tools: this._toolSpecs,
+            shots: this._fewShots,
+        });
+        return this._hashFn(blob);
+    }
+}
+function defaultHash(input) {
+    return createHash("sha256").update(input).digest("hex").slice(0, 16);
+}
+//# sourceMappingURL=prefix.js.map

package/dist/prefix.js.map

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

package/dist/session-impl.d.ts

@@ -0,0 +1,62 @@
+import type { ChatMessage, ToolCall, ToolDefinition, ToolSpec } from "./types.js";
+import type { TurnResult, TurnChunk, ToolResult, SessionStats, HaloAgentOptions } from "./session.js";
+/** Internal implementation. Exported for testing only. */
+export declare class HaloAgentImpl {
+    private _adapter;
+    private _prefix;
+    private _log;
+    private _context;
+    private _repair;
+    private _listeners;
+    private _stats;
+    private _keepAliveTimer;
+    private _toolExecutors;
+    constructor(opts: HaloAgentOptions);
+    get stats(): Readonly<SessionStats>;
+    run(input: string, opts?: {
+        maxSteps?: number;
+        onToolCall?: (call: ToolCall) => Promise<ToolResult>;
+        onStep?: (s: {
+            step: number;
+            content: string;
+            toolCalls: ToolCall[];
+        }) => void;
+    }): Promise<TurnResult>;
+    send(input: string): Promise<TurnResult>;
+    stream(input: string): AsyncGenerator<TurnChunk>;
+    submitToolResult(result: ToolResult): Promise<TurnResult>;
+    /**
+     * Stream-compatible entry for AI SDK (useChat) integration.
+     *
+     * Accepts UIMessages from `useChat()`, converts them to ChatMessages,
+     * hydrates prior history, then streams the last user message.
+     *
+     * When tools with `execute` are present, uses `run()` for auto-execution.
+     * Otherwise uses `stream()` for plain text streaming.
+     *
+     * Cache-first: only `_log` is modified via hydrate(), `_prefix` is untouched.
+     */
+    sdkStream(messages: {
+        role: string;
+        content: string;
+    }[]): AsyncGenerator<TurnChunk>;
+    addTool(spec: ToolSpec): void;
+    addTool(name: string, def: ToolDefinition): void;
+    removeTool(name: string): void;
+    addFewShot(msg: ChatMessage): void;
+    removeFewShot(index: number): boolean;
+    keepAlive(intervalMs?: number): {
+        stop: () => void;
+    };
+    /** Restore conversation state from external history. */
+    hydrate(messages: ChatMessage[]): void;
+    clearLog(): void;
+    setSystem(system: string): void;
+    /** Resolve history, applying ContextStrategy (prefix is read-only). */
+    private _resolveHistory;
+    private _callModel;
+    private _emit;
+    private _stopKeepAlive;
+    private _computeSavings;
+}
+//# sourceMappingURL=session-impl.d.ts.map

package/dist/session-impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-impl.d.ts","sourceRoot":"","sources":["../src/session-impl.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAClF,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,UAAU,EAEV,YAAY,EACZ,gBAAgB,EACjB,MAAM,cAAc,CAAC;AAItB,0DAA0D;AAC1D,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,UAAU,CAAsE;IACxF,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,eAAe,CAA+C;IACtE,OAAO,CAAC,cAAc,CAA2E;gBAErF,IAAI,EAAE,gBAAgB;IAiDlC,IAAI,KAAK,IAAI,QAAQ,CAAC,YAAY,CAAC,CAElC;IAEK,GAAG,CACP,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;QACL,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;QACrD,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,QAAQ,EAAE,CAAA;SAAE,KAAK,IAAI,CAAC;KAChF,GACA,OAAO,CAAC,UAAU,CAAC;IA+ChB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAKvC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC;IAOjD,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAS/D;;;;;;;;;;OAUG;IACI,SAAS,CACd,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,GAC5C,cAAc,CAAC,SAAS,CAAC;IAmC5B,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAC7B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI;IAgBhD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9B,UAAU,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAGlC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAMrC,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,IAAI,CAAA;KAAE;IAyBpD,wDAAwD;IACxD,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI;IAMtC,QAAQ,IAAI,IAAI;IAIhB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAS/B,uEAAuE;IACvE,OAAO,CAAC,eAAe;YAmBT,UAAU;IAyDxB,OAAO,CAAC,KAAK;IAYb,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,eAAe;CAOxB"}

package/dist/session-impl.js

@@ -0,0 +1,308 @@
+import { StablePrefix } from "./prefix.js";
+import { MessageLog } from "./log.js";
+import { normalizeTools, definitionToSpec } from "./tool-utils.js";
+/** Internal implementation. Exported for testing only. */
+export class HaloAgentImpl {
+    _adapter;
+    _prefix;
+    _log;
+    _context;
+    _repair;
+    _listeners;
+    _stats;
+    _keepAliveTimer = null;
+    _toolExecutors;
+    constructor(opts) {
+        this._adapter = opts.adapter;
+        // Normalize tools: accept both ToolSpec[] and Record<string, ToolDefinition>.
+        const { toolSpecs, executors } = normalizeTools(opts.tools);
+        this._toolExecutors = executors;
+        this._prefix = new StablePrefix({
+            system: opts.system,
+            tools: toolSpecs,
+            fewShots: opts.fewShots,
+        });
+        this._log = new MessageLog();
+        this._context = opts.context;
+        this._repair = opts.repair;
+        this._listeners = new Map();
+        // Register external listener if provided.
+        if (opts.on) {
+            for (const ev of ["cache:miss", "context:truncated", "repair:applied"]) {
+                this._listeners.set(ev, new Set());
+                this._listeners.get(ev).add(opts.on);
+            }
+        }
+        this._stats = {
+            turns: 0,
+            totalPromptTokens: 0,
+            totalCompletionTokens: 0,
+            pricingSnapshot: {
+                recordedAt: Date.now(),
+                inputPricePer1k: this._adapter.pricing?.inputPricePer1k ?? 0,
+                cachedInputPricePer1k: this._adapter.pricing?.cachedInputPricePer1k ?? 0,
+            },
+            recentDiagnostics: [],
+        };
+        if (this._adapter.pricing) {
+            this._stats.caching = {
+                totalCacheHitTokens: 0,
+                totalCacheMissTokens: 0,
+                cacheHitRate: 0,
+                estimatedSavingsUsd: null,
+            };
+        }
+    }
+    // ── Core ──
+    get stats() {
+        return this._stats;
+    }
+    async run(input, opts) {
+        const maxSteps = opts?.maxSteps ?? 10;
+        const onToolCall = opts?.onToolCall;
+        const onStep = opts?.onStep;
+        let step = 0;
+        let result = await this.send(input);
+        while (result.toolCalls.length > 0 && step < maxSteps) {
+            step++;
+            for (const call of result.toolCalls) {
+                const executor = this._toolExecutors.get(call.function.name);
+                if (executor) {
+                    // Auto-execute when tool definition includes execute().
+                    let parsed;
+                    try {
+                        parsed = JSON.parse(call.function.arguments);
+                    }
+                    catch {
+                        parsed = {};
+                    }
+                    const output = await executor(parsed);
+                    this._log.append({
+                        role: "tool",
+                        tool_call_id: call.id,
+                        content: output,
+                    });
+                }
+                else if (onToolCall) {
+                    const r = await onToolCall(call);
+                    this._log.append({
+                        role: "tool",
+                        tool_call_id: call.id,
+                        content: r.isError ? `ERROR: ${r.output}` : r.output,
+                    });
+                }
+                else {
+                    // No executor and no onToolCall — stop loop, return current result.
+                    return result;
+                }
+            }
+            onStep?.({ step, content: result.content, toolCalls: result.toolCalls });
+            result = await this._callModel();
+        }
+        return result;
+    }
+    async send(input) {
+        this._log.append({ role: "user", content: input });
+        return this._callModel();
+    }
+    async *stream(input) {
+        this._log.append({ role: "user", content: input });
+        const prefix = this._prefix.toMessages();
+        const history = this._log.toFullHistory();
+        yield* this._adapter.stream(prefix, history, this._prefix.tools());
+    }
+    async submitToolResult(result) {
+        this._log.append({
+            role: "tool",
+            tool_call_id: result.toolCallId,
+            content: result.isError ? `ERROR: ${result.output}` : result.output,
+        });
+        return this._callModel();
+    }
+    /**
+     * Stream-compatible entry for AI SDK (useChat) integration.
+     *
+     * Accepts UIMessages from `useChat()`, converts them to ChatMessages,
+     * hydrates prior history, then streams the last user message.
+     *
+     * When tools with `execute` are present, uses `run()` for auto-execution.
+     * Otherwise uses `stream()` for plain text streaming.
+     *
+     * Cache-first: only `_log` is modified via hydrate(), `_prefix` is untouched.
+     */
+    async *sdkStream(messages) {
+        // Convert UIMessages → ChatMessages (system role is already in prefix).
+        const chatMessages = messages
+            .filter((m) => m.role !== "system")
+            .map((m) => ({
+            role: m.role,
+            content: m.content,
+        }));
+        if (chatMessages.length === 0) {
+            yield { type: "text-delta", delta: "" };
+            yield { type: "done", usage: { promptTokens: 0, completionTokens: 0 } };
+            return;
+        }
+        // Last message is the current user input; everything before it is history.
+        const lastMsg = chatMessages.pop();
+        if (chatMessages.length > 0) {
+            this.hydrate(chatMessages);
+        }
+        // If the agent has tools with auto-execute, use run() for full tool loop.
+        if (this._toolExecutors.size > 0) {
+            const result = await this.run(lastMsg.content);
+            yield { type: "text-delta", delta: result.content };
+            yield { type: "done", usage: result.usage };
+            return;
+        }
+        // Plain text: stream normally.
+        yield* this.stream(lastMsg.content);
+    }
+    addTool(specOrName, def) {
+        if (typeof specOrName === "string") {
+            // addTool(name, def)
+            const name = specOrName;
+            const d = def;
+            const spec = definitionToSpec(name, d);
+            this._prefix.addTool(spec);
+            if (d.execute) {
+                this._toolExecutors.set(name, d.execute);
+            }
+        }
+        else {
+            // addTool(spec)
+            this._prefix.addTool(specOrName);
+        }
+    }
+    removeTool(name) {
+        this._prefix.removeTool(name);
+        this._toolExecutors.delete(name);
+    }
+    addFewShot(msg) {
+        this._prefix.addFewShot(msg);
+    }
+    removeFewShot(index) {
+        return this._prefix.removeFewShot(index);
+    }
+    // ── Keep-alive ──
+    keepAlive(intervalMs) {
+        // Delegate to adapter if it provides a custom keep-alive (e.g. Gemini).
+        if (this._adapter.keepAlive) {
+            return this._adapter.keepAlive(this._prefix.toMessages());
+        }
+        // Default: periodic ping to maintain server-side KV cache.
+        const ms = intervalMs ?? 120_000;
+        if (this._keepAliveTimer)
+            clearInterval(this._keepAliveTimer);
+        this._keepAliveTimer = setInterval(() => {
+            this._adapter
+                .chat(this._prefix.toMessages(), [{ role: "user", content: "ping" }], undefined)
+                .catch(() => {
+                /* keep-alive failure is silent */
+            });
+        }, ms);
+        return { stop: () => this._stopKeepAlive() };
+    }
+    // ── Hydrate ──
+    /** Restore conversation state from external history. */
+    hydrate(messages) {
+        this._log.hydrate(messages);
+    }
+    // ── Lifecycle ──
+    clearLog() {
+        this._log = new MessageLog();
+    }
+    setSystem(system) {
+        this._prefix = new StablePrefix({
+            system,
+            tools: this._prefix.tools(),
+        });
+    }
+    // ── Private ──
+    /** Resolve history, applying ContextStrategy (prefix is read-only). */
+    _resolveHistory() {
+        const prefix = this._prefix.toMessages();
+        let history = this._log.toFullHistory();
+        if (this._context) {
+            const ctxMax = this._adapter.contextWindow;
+            const prepared = this._context.prepare(prefix, history, ctxMax);
+            if (prepared.modified) {
+                this._emit("context:truncated", {
+                    droppedCount: prepared.droppedCount,
+                    summary: prepared.summary,
+                });
+            }
+            return prepared.history;
+        }
+        return history;
+    }
+    async _callModel() {
+        const prefix = this._prefix.toMessages();
+        const history = this._resolveHistory();
+        const tools = this._prefix.tools();
+        const { content, toolCalls, usage } = await this._adapter.chat(prefix, history, tools.length > 0 ? tools : undefined);
+        // Apply repair.
+        let repairedCalls = toolCalls;
+        if (this._repair && toolCalls.length > 0) {
+            const rr = this._repair.repair(toolCalls, content);
+            repairedCalls = rr.toolCalls;
+            if (rr.fixed > 0 || rr.suppressed > 0) {
+                this._emit("repair:applied", {
+                    fixed: rr.fixed,
+                    suppressed: rr.suppressed,
+                    notes: rr.notes,
+                });
+            }
+        }
+        // Append assistant message.
+        const assistantMsg = { role: "assistant", content };
+        if (repairedCalls.length > 0)
+            assistantMsg.tool_calls = repairedCalls;
+        this._log.append(assistantMsg);
+        // Update stats.
+        this._stats.turns++;
+        this._stats.totalPromptTokens += usage.promptTokens;
+        this._stats.totalCompletionTokens += usage.completionTokens;
+        if (this._stats.caching && usage.caching) {
+            this._stats.caching.totalCacheHitTokens += usage.caching.hitTokens;
+            this._stats.caching.totalCacheMissTokens += usage.caching.missTokens;
+            const total = this._stats.caching.totalCacheHitTokens + this._stats.caching.totalCacheMissTokens;
+            this._stats.caching.cacheHitRate =
+                total > 0 ? this._stats.caching.totalCacheHitTokens / total : 0;
+            this._stats.caching.estimatedSavingsUsd = this._computeSavings(this._stats.caching.totalCacheHitTokens);
+            if (usage.caching.missTokens > 0 && this._stats.turns > 1) {
+                this._emit("cache:miss", {
+                    type: "unknown",
+                    detail: `missTokens: ${usage.caching.missTokens}`,
+                });
+            }
+        }
+        return { content, toolCalls: repairedCalls, usage };
+    }
+    _emit(event, payload) {
+        const handlers = this._listeners.get(event);
+        if (!handlers)
+            return;
+        for (const fn of handlers) {
+            try {
+                fn(event, payload);
+            }
+            catch {
+                /* silent */
+            }
+        }
+    }
+    _stopKeepAlive() {
+        if (this._keepAliveTimer) {
+            clearInterval(this._keepAliveTimer);
+            this._keepAliveTimer = null;
+        }
+    }
+    _computeSavings(cacheHitTokens) {
+        if (!this._adapter.pricing)
+            return null;
+        return ((cacheHitTokens / 1000) *
+            (this._adapter.pricing.inputPricePer1k - this._adapter.pricing.cachedInputPricePer1k));
+    }
+}
+//# sourceMappingURL=session-impl.js.map

package/dist/session-impl.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,72 @@
+import type { ChatMessage, ToolCall, ToolDefinition, ToolSpec, Usage } from "./types.js";
+import type { ContextStrategy, RepairStrategy } from "./strategies.js";
+import type { ModelAdapter } from "./model-adapter.js";
+export interface TurnResult {
+    content: string;
+    toolCalls: ToolCall[];
+    usage: Usage;
+}
+export interface ToolResult {
+    toolCallId: string;
+    output: string;
+    isError?: boolean;
+}
+export type TurnChunk = {
+    type: "text-delta";
+    delta: string;
+} | {
+    type: "tool-call-delta";
+    index: number;
+    name?: string;
+    argumentsDelta?: string;
+} | {
+    type: "tool-call-ready";
+    index: number;
+    call: ToolCall;
+} | {
+    type: "done";
+    usage: Usage;
+};
+export type AgentEvent = "cache:miss" | "context:truncated" | "repair:applied";
+export interface CacheMissReason {
+    type: "cold-start" | "system-changed" | "tools-changed" | "fewshots-changed" | "unknown";
+    detail: string;
+    added?: string[];
+    removed?: string[];
+}
+export interface PricingSnapshot {
+    recordedAt: number;
+    inputPricePer1k: number;
+    cachedInputPricePer1k: number;
+}
+export interface SessionStats {
+    turns: number;
+    totalPromptTokens: number;
+    totalCompletionTokens: number;
+    caching?: {
+        totalCacheHitTokens: number;
+        totalCacheMissTokens: number;
+        cacheHitRate: number;
+        estimatedSavingsUsd: number | null;
+    };
+    pricingSnapshot: PricingSnapshot;
+    recentDiagnostics: CacheMissReason[];
+}
+export interface HaloAgentOptions {
+    adapter: ModelAdapter;
+    system: string;
+    /**
+     * Tools available to the model.
+     *
+     * Accepts either a flat array of `ToolSpec` objects (backward-compatible),
+     * or a named record of `ToolDefinition` objects. When `ToolDefinition`
+     * includes `execute`, the `run()` method calls it automatically —
+     * no `onToolCall` callback needed.
+     */
+    tools?: ToolSpec[] | Record<string, ToolDefinition<any>>;
+    fewShots?: ChatMessage[];
+    context?: ContextStrategy;
+    repair?: RepairStrategy;
+    on?: (event: AgentEvent, payload: unknown) => void;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,KAAK,EAAE,KAAK,CAAC;CACd;AAID,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAID,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAClF;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAInC,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,mBAAmB,GAAG,gBAAgB,CAAC;AAI/E,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,YAAY,GAAG,gBAAgB,GAAG,eAAe,GAAG,kBAAkB,GAAG,SAAS,CAAC;IACzF,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IAEd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAE9B,OAAO,CAAC,EAAE;QACR,mBAAmB,EAAE,MAAM,CAAC;QAC5B,oBAAoB,EAAE,MAAM,CAAC;QAC7B,YAAY,EAAE,MAAM,CAAC;QACrB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;KACpC,CAAC;IAEF,eAAe,EAAE,eAAe,CAAC;IAEjC,iBAAiB,EAAE,eAAe,EAAE,CAAC;CACtC;AAID,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IAEf;;;;;;;OAOG;IAEH,KAAK,CAAC,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IAEzB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,MAAM,CAAC,EAAE,cAAc,CAAC;IAExB,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACpD"}

package/dist/session.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/strategies.d.ts

@@ -0,0 +1,26 @@
+import type { ChatMessage, ToolCall } from "./types.js";
+export interface ContextStrategy {
+    /**
+     * Prepare history for a context-limited send.
+     *
+     * `prefix` is READ-ONLY — strategies MUST NOT modify it.
+     * Only `history` may be truncated / summarized.
+     * This preserves the stable prefix for cache-hit guarantees.
+     */
+    prepare(prefix: ChatMessage[], history: ChatMessage[], ctxMax: number): {
+        history: ChatMessage[];
+        modified: boolean;
+        summary?: string;
+        droppedCount: number;
+    };
+}
+export interface RepairResult {
+    toolCalls: ToolCall[];
+    fixed: number;
+    suppressed: number;
+    notes: string[];
+}
+export interface RepairStrategy {
+    repair(toolCalls: ToolCall[], rawContent: string): RepairResult;
+}
+//# sourceMappingURL=strategies.d.ts.map

package/dist/strategies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategies.d.ts","sourceRoot":"","sources":["../src/strategies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAIxD,MAAM,WAAW,eAAe;IAC9B;;;;;;OAMG;IACH,OAAO,CACL,MAAM,EAAE,WAAW,EAAE,EACrB,OAAO,EAAE,WAAW,EAAE,EACtB,MAAM,EAAE,MAAM,GACb;QACD,OAAO,EAAE,WAAW,EAAE,CAAC;QACvB,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAID,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,CAAC;CACjE"}

package/dist/strategies.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=strategies.js.map

package/dist/strategies.js.map

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

package/dist/tool-utils.d.ts

@@ -0,0 +1,14 @@
+import type { ToolSpec, ToolDefinition } from "./types.js";
+/** Convert a named ToolDefinition to a ToolSpec. */
+export declare function definitionToSpec(name: string, def: ToolDefinition): ToolSpec;
+/** Result of normalizing tool inputs: flat specs + executor map. */
+export interface NormalizedTools {
+    toolSpecs: ToolSpec[];
+    executors: Map<string, (args: Record<string, unknown>) => string | Promise<string>>;
+}
+/**
+ * Normalize tools from either a flat array of ToolSpec objects or a
+ * named record of ToolDefinition objects into a unified representation.
+ */
+export declare function normalizeTools(tools: ToolSpec[] | Record<string, ToolDefinition<any>> | undefined): NormalizedTools;
+//# sourceMappingURL=tool-utils.d.ts.map

package/dist/tool-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-utils.d.ts","sourceRoot":"","sources":["../src/tool-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE3D,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,QAAQ,CAS5E;AAED,oEAAoE;AACpE,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;CACrF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAE5B,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,GAClE,eAAe,CAsBjB"}

package/dist/tool-utils.js

@@ -0,0 +1,36 @@
+/** Convert a named ToolDefinition to a ToolSpec. */
+export function definitionToSpec(name, def) {
+    return {
+        type: "function",
+        function: {
+            name,
+            description: def.description,
+            parameters: def.parameters,
+        },
+    };
+}
+/**
+ * Normalize tools from either a flat array of ToolSpec objects or a
+ * named record of ToolDefinition objects into a unified representation.
+ */
+export function normalizeTools(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+tools) {
+    const executors = new Map();
+    if (!tools)
+        return { toolSpecs: [], executors };
+    if (Array.isArray(tools)) {
+        return { toolSpecs: tools, executors };
+    }
+    const specs = [];
+    for (const [name, def] of Object.entries(tools)) {
+        specs.push(definitionToSpec(name, def));
+        if (def.execute) {
+            executors.set(name, 
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            def.execute);
+        }
+    }
+    return { toolSpecs: specs, executors };
+}
+//# sourceMappingURL=tool-utils.js.map