general-agent-runtime 0.0.1

package/dist/agent/integrations/session-context-source.js

@@ -0,0 +1,84 @@
+import { COMPACTION_CHECKPOINT_MESSAGE_KIND } from "../../types/compaction.js";
+import { newContextItemId, newMessageId, } from "../../utils/id.js";
+function checkpointText(checkpoint) {
+    const sections = [
+        `Conversation summary:\n${checkpoint.summary}`,
+        checkpoint.currentGoal
+            ? `Current goal:\n${checkpoint.currentGoal}`
+            : undefined,
+        checkpoint.decisions?.length
+            ? `Decisions:\n- ${checkpoint.decisions.join("\n- ")}`
+            : undefined,
+        checkpoint.constraints?.length
+            ? `Constraints:\n- ${checkpoint.constraints.join("\n- ")}`
+            : undefined,
+        checkpoint.importantFacts?.length
+            ? `Important facts:\n- ${checkpoint.importantFacts.join("\n- ")}`
+            : undefined,
+        checkpoint.modifiedResources?.length
+            ? `Modified resources:\n- ${checkpoint.modifiedResources.join("\n- ")}`
+            : undefined,
+        checkpoint.pendingTasks?.length
+            ? `Pending tasks:\n- ${checkpoint.pendingTasks.join("\n- ")}`
+            : undefined,
+    ].filter((value) => value !== undefined);
+    return sections.join("\n\n");
+}
+function checkpointMessage(checkpoint) {
+    return {
+        id: newMessageId(),
+        role: "assistant",
+        parts: [{ type: "text", text: checkpointText(checkpoint) }],
+        createdAt: checkpoint.createdAt,
+        metadata: {
+            kind: COMPACTION_CHECKPOINT_MESSAGE_KIND,
+            compactionId: checkpoint.id,
+        },
+    };
+}
+function messagesAfterCheckpoint(messages, checkpoint) {
+    const coveredId = checkpoint.coversThroughMessageId;
+    if (coveredId === undefined) {
+        return [...messages];
+    }
+    const coveredIndex = messages.findIndex((message) => message.id === coveredId);
+    if (coveredIndex < 0) {
+        return [...messages];
+    }
+    return messages.slice(coveredIndex + 1);
+}
+export class SessionContextSource {
+    store;
+    projector;
+    id = "session";
+    scope = "session";
+    constructor(store, projector) {
+        this.store = store;
+        this.projector = projector;
+    }
+    async load(request, signal) {
+        signal?.throwIfAborted();
+        const projection = await this.projector.project(this.store.read(request.sessionId, signal), signal);
+        const content = projection.latestCompaction === undefined
+            ? [...projection.messages]
+            : [
+                checkpointMessage(projection.latestCompaction),
+                ...messagesAfterCheckpoint(projection.messages, projection.latestCompaction),
+            ];
+        if (content.length === 0) {
+            return [];
+        }
+        return [
+            {
+                id: newContextItemId(),
+                scope: this.scope,
+                source: this.id,
+                priority: 0,
+                visibility: "model",
+                content,
+                createdAt: new Date().toISOString(),
+            },
+        ];
+    }
+}
+//# sourceMappingURL=session-context-source.js.map

package/dist/agent/integrations/session-context-source.js.map

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

package/dist/agent/integrations/session-run-recorder.d.ts

@@ -0,0 +1,17 @@
+import type { RunRecorder } from "../../loop/recorder.js";
+import type { Session } from "../../session/session.js";
+import type { ToolExecutionResult } from "../../tools/types.js";
+import type { AgentMessage, CompactionCheckpoint, SessionId, Usage } from "../../types/index.js";
+import type { RunRecorderFactory } from "../run-manager.js";
+export declare class SessionRunRecorderFactory implements RunRecorderFactory {
+    create(session: Session): RunRecorder;
+}
+export declare class SessionRunRecorder implements RunRecorder {
+    private readonly session;
+    readonly sessionId: SessionId;
+    constructor(session: Session);
+    appendUser(message: AgentMessage, signal?: AbortSignal): Promise<void>;
+    appendAssistant(message: AgentMessage, usage?: Usage, signal?: AbortSignal): Promise<void>;
+    appendToolResults(results: readonly ToolExecutionResult[], signal?: AbortSignal): Promise<void>;
+    appendCompaction(checkpoint: CompactionCheckpoint, signal?: AbortSignal): Promise<void>;
+}

package/dist/agent/integrations/session-run-recorder.js

@@ -0,0 +1,60 @@
+import { createToolResultMessage } from "../../utils/message.js";
+function jsonPayload(value) {
+    return structuredClone(value);
+}
+export class SessionRunRecorderFactory {
+    create(session) {
+        return new SessionRunRecorder(session);
+    }
+}
+export class SessionRunRecorder {
+    session;
+    sessionId;
+    constructor(session) {
+        this.session = session;
+        this.sessionId = session.id;
+    }
+    async appendUser(message, signal) {
+        await this.session.append({
+            type: "message",
+            payload: jsonPayload(message),
+        }, signal);
+    }
+    async appendAssistant(message, usage, signal) {
+        const entries = [
+            {
+                type: "message",
+                payload: jsonPayload(message),
+            },
+        ];
+        if (usage !== undefined) {
+            entries.push({
+                type: "usage",
+                payload: jsonPayload(usage),
+            });
+        }
+        await this.session.appendMany(entries, signal);
+    }
+    async appendToolResults(results, signal) {
+        const messages = results.map((result) => createToolResultMessage({
+            callId: result.call.callId,
+            toolName: result.call.toolName,
+            content: result.content,
+            isError: result.isError,
+            ...(result.metadata === undefined
+                ? {}
+                : { metadata: result.metadata }),
+        }));
+        await this.session.appendMany(messages.map((message) => ({
+            type: "message",
+            payload: jsonPayload(message),
+        })), signal);
+    }
+    async appendCompaction(checkpoint, signal) {
+        await this.session.append({
+            type: "compaction",
+            payload: jsonPayload(checkpoint),
+        }, signal);
+    }
+}
+//# sourceMappingURL=session-run-recorder.js.map

package/dist/agent/integrations/session-run-recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-run-recorder.js","sourceRoot":"","sources":["../../../src/agent/integrations/session-run-recorder.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAGjE,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,eAAe,CAAC,KAAK,CAAc,CAAC;AAC7C,CAAC;AAED,MAAM,OAAO,yBAAyB;IACpC,MAAM,CAAC,OAAgB;QACrB,OAAO,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;CACF;AAED,MAAM,OAAO,kBAAkB;IAGA;IAFpB,SAAS,CAAY;IAE9B,YAA6B,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;QAC3C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,EAAE,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,UAAU,CACd,OAAqB,EACrB,MAAoB;QAEpB,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CACvB;YACE,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC;SAC9B,EACD,MAAM,CACP,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,OAAqB,EACrB,KAAa,EACb,MAAoB;QAEpB,MAAM,OAAO,GAGR;YACH;gBACE,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC;aAC9B;SACF,CAAC;QAEF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC;aAC5B,CAAC,CAAC;QACL,CAAC;QAED,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,OAAuC,EACvC,MAAoB;QAEpB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACtC,uBAAuB,CAAC;YACtB,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM;YAC1B,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ;YAC9B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,GAAG,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS;gBAC/B,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;SACnC,CAAC,CACH,CAAC;QAEF,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAC3B,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACzB,IAAI,EAAE,SAAkB;YACxB,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC;SAC9B,CAAC,CAAC,EACH,MAAM,CACP,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,UAAgC,EAChC,MAAoB;QAEpB,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CACvB;YACE,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,WAAW,CAAC,UAAU,CAAC;SACjC,EACD,MAAM,CACP,CAAC;IACJ,CAAC;CACF"}

package/dist/agent/loop-factory.d.ts

@@ -0,0 +1,11 @@
+import { type AgentLoop, type AgentLoopDependencies, type AgentLoopOptions, type RunRecorder } from "../loop/index.js";
+export interface AgentLoopFactory {
+    create(recorder: RunRecorder): AgentLoop;
+}
+export type DefaultAgentLoopFactoryDependencies = Omit<AgentLoopDependencies, "recorder">;
+export declare class DefaultAgentLoopFactory implements AgentLoopFactory {
+    private readonly dependencies;
+    private readonly options;
+    constructor(dependencies: DefaultAgentLoopFactoryDependencies, options: AgentLoopOptions);
+    create(recorder: RunRecorder): AgentLoop;
+}

package/dist/agent/loop-factory.js

@@ -0,0 +1,16 @@
+import { DefaultAgentLoop, } from "../loop/index.js";
+export class DefaultAgentLoopFactory {
+    dependencies;
+    options;
+    constructor(dependencies, options) {
+        this.dependencies = dependencies;
+        this.options = options;
+    }
+    create(recorder) {
+        return new DefaultAgentLoop({
+            ...this.dependencies,
+            recorder,
+        }, this.options);
+    }
+}
+//# sourceMappingURL=loop-factory.js.map

package/dist/agent/loop-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-factory.js","sourceRoot":"","sources":["../../src/agent/loop-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,GAKjB,MAAM,kBAAkB,CAAC;AAS1B,MAAM,OAAO,uBAAuB;IAEf;IACA;IAFnB,YACmB,YAAiD,EACjD,OAAyB;QADzB,iBAAY,GAAZ,YAAY,CAAqC;QACjD,YAAO,GAAP,OAAO,CAAkB;IACzC,CAAC;IAEJ,MAAM,CAAC,QAAqB;QAC1B,OAAO,IAAI,gBAAgB,CACzB;YACE,GAAG,IAAI,CAAC,YAAY;YACpB,QAAQ;SACT,EACD,IAAI,CAAC,OAAO,CACb,CAAC;IACJ,CAAC;CACF"}

package/dist/agent/run-manager.d.ts

@@ -0,0 +1,38 @@
+import type { AgentEvent } from "../events/types.js";
+import type { ModelProvider } from "../model/provider.js";
+import type { SessionFactory } from "../session/factory.js";
+import type { Session } from "../session/session.js";
+import type { SessionProjector } from "../session/types.js";
+import type { RuntimeConfig } from "../settings/types.js";
+import type { AgentMessage, AgentRunState, RunId, SessionId } from "../types/index.js";
+import type { RunRecorder } from "../loop/recorder.js";
+import type { AgentLoopFactory } from "./loop-factory.js";
+import type { AgentRunOptions } from "./types.js";
+export interface RunRecorderFactory {
+    create(session: Session): RunRecorder;
+}
+export interface RunManager {
+    run(input: AgentMessage, options?: AgentRunOptions): AsyncIterable<AgentEvent>;
+    resume(sessionId: SessionId, options?: Omit<AgentRunOptions, "sessionId">): Promise<void>;
+    abort(runId: RunId): void;
+    getState(runId: RunId): Readonly<AgentRunState> | undefined;
+}
+export interface DefaultRunManagerDependencies {
+    readonly config: RuntimeConfig;
+    readonly modelProvider: ModelProvider;
+    readonly sessionFactory: SessionFactory;
+    readonly sessionProjector: SessionProjector;
+    readonly recorderFactory: RunRecorderFactory;
+    readonly loopFactory: AgentLoopFactory;
+}
+export declare class DefaultRunManager implements RunManager {
+    private readonly dependencies;
+    private readonly activeRuns;
+    private readonly states;
+    constructor(dependencies: DefaultRunManagerDependencies);
+    run(input: AgentMessage, options?: AgentRunOptions): AsyncIterable<AgentEvent>;
+    resume(sessionId: SessionId, options?: Omit<AgentRunOptions, "sessionId">): Promise<void>;
+    abort(runId: RunId): void;
+    getState(runId: RunId): Readonly<AgentRunState> | undefined;
+    private forwardAbort;
+}

package/dist/agent/run-manager.js

@@ -0,0 +1,96 @@
+export class DefaultRunManager {
+    dependencies;
+    activeRuns = new Map();
+    states = new Map();
+    constructor(dependencies) {
+        this.dependencies = dependencies;
+    }
+    async *run(input, options = {}) {
+        const controller = new AbortController();
+        const detachSignal = this.forwardAbort(options.signal, controller);
+        try {
+            controller.signal.throwIfAborted();
+            const session = options.sessionId === undefined
+                ? await this.dependencies.sessionFactory.create(options.metadata === undefined
+                    ? {}
+                    : { metadata: structuredClone(options.metadata) }, controller.signal)
+                : await this.dependencies.sessionFactory.open(options.sessionId, controller.signal);
+            const capabilities = await this.dependencies.modelProvider.getCapabilities(this.dependencies.config.model.model);
+            controller.signal.throwIfAborted();
+            const recorder = this.dependencies.recorderFactory.create(session);
+            const loop = this.dependencies.loopFactory.create(recorder);
+            let runId;
+            try {
+                for await (const event of loop.run({
+                    input: structuredClone(input),
+                    model: this.dependencies.config.model.model,
+                    capabilities,
+                    ...(this.dependencies.config.model.temperature === undefined
+                        ? {}
+                        : {
+                            temperature: this.dependencies.config.model.temperature,
+                        }),
+                    ...(this.dependencies.config.model.maxOutputTokens === undefined
+                        ? {}
+                        : {
+                            maxOutputTokens: this.dependencies.config.model.maxOutputTokens,
+                        }),
+                    ...(this.dependencies.config.model.extra === undefined
+                        ? {}
+                        : {
+                            providerOptions: structuredClone(this.dependencies.config.model.extra),
+                        }),
+                }, controller.signal)) {
+                    if (runId === undefined && event.runId !== undefined) {
+                        runId = event.runId;
+                        this.activeRuns.set(runId, { controller, loop });
+                    }
+                    if (runId !== undefined) {
+                        this.states.set(runId, loop.getState());
+                    }
+                    yield event;
+                }
+            }
+            finally {
+                const state = loop.getState();
+                this.states.set(state.runId, state);
+                this.activeRuns.delete(state.runId);
+            }
+        }
+        finally {
+            detachSignal();
+        }
+    }
+    async resume(sessionId, options = {}) {
+        options.signal?.throwIfAborted();
+        const session = await this.dependencies.sessionFactory.open(sessionId, options.signal);
+        await this.dependencies.sessionProjector.project(session.entries(options.signal), options.signal);
+    }
+    abort(runId) {
+        this.activeRuns.get(runId)?.controller.abort("user_abort");
+    }
+    getState(runId) {
+        const active = this.activeRuns.get(runId);
+        if (active !== undefined) {
+            return active.loop.getState();
+        }
+        return this.states.get(runId);
+    }
+    forwardAbort(signal, controller) {
+        if (signal === undefined) {
+            return () => undefined;
+        }
+        const abort = () => {
+            if (!controller.signal.aborted) {
+                controller.abort(signal.reason);
+            }
+        };
+        if (signal.aborted) {
+            abort();
+            return () => undefined;
+        }
+        signal.addEventListener("abort", abort, { once: true });
+        return () => signal.removeEventListener("abort", abort);
+    }
+}
+//# sourceMappingURL=run-manager.js.map

package/dist/agent/run-manager.js.map

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

package/dist/agent/types.d.ts

@@ -0,0 +1,38 @@
+import type { CompactionStrategy } from "../compaction/types.js";
+import type { ContextSource } from "../context/source.js";
+import type { AgentEvent } from "../events/types.js";
+import type { EventSink } from "../events/sink.js";
+import type { Hook } from "../hooks/types.js";
+import type { ModelProvider } from "../model/provider.js";
+import type { SessionStore } from "../session/store.js";
+import type { DeepPartial, RuntimeConfig } from "../settings/types.js";
+import type { Tool } from "../tools/tool.js";
+import type { AgentMessage, AgentRunState, Metadata, RunId, SessionId } from "../types/index.js";
+export interface AgentRunOptions {
+    sessionId?: SessionId;
+    metadata?: Metadata;
+    signal?: AbortSignal;
+}
+export interface Agent {
+    run(input: string | AgentMessage, options?: AgentRunOptions): AsyncIterable<AgentEvent>;
+    resume(sessionId: SessionId, options?: Omit<AgentRunOptions, "sessionId">): Promise<void>;
+    abort(runId: RunId): void;
+    getState(runId: RunId): Readonly<AgentRunState> | undefined;
+}
+export interface AgentBuilder {
+    withConfig(config: RuntimeConfig): AgentBuilder;
+    withModelProvider(provider: ModelProvider): AgentBuilder;
+    withSessionStore(store: SessionStore): AgentBuilder;
+    withContextSource(source: ContextSource): AgentBuilder;
+    withTool(tool: Tool): AgentBuilder;
+    withHook(hook: Hook): AgentBuilder;
+    withEventSink(sink: EventSink): AgentBuilder;
+    withCompactionStrategy(strategy: CompactionStrategy): AgentBuilder;
+    build(): Agent;
+}
+export interface CreateAgentOptions {
+    readonly model?: string;
+    readonly apiKey?: string;
+    readonly baseUrl?: string;
+    readonly config?: DeepPartial<RuntimeConfig>;
+}

package/dist/agent/types.js

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

package/dist/agent/types.js.map

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

package/dist/cli/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/main.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+import { createInterface } from "node:readline/promises";
+import { stdin, stdout } from "node:process";
+import { createAgent, } from "../index.js";
+import { renderAgentEvent } from "./renderer.js";
+function parseSessionArg(args) {
+    const index = args.indexOf("--session");
+    if (index === -1) {
+        return undefined;
+    }
+    const value = args[index + 1];
+    if (value === undefined || value.startsWith("--")) {
+        throw new Error("--session requires a session id");
+    }
+    return value;
+}
+if (process.argv.includes("--help") || process.argv.includes("-h")) {
+    process.stdout.write([
+        "General Agent Runtime CLI",
+        "",
+        "Usage:",
+        "  general-agent-runtime",
+        "  general-agent-runtime --session <session-id>",
+        "",
+        "Environment:",
+        "  AGENT_BASE_URL",
+        "  AGENT_API_KEY",
+        "  AGENT_MODEL",
+        "",
+        "Ctrl+C aborts the active run; press Ctrl+C while idle to exit.",
+        "",
+    ].join("\n"));
+    process.exit(0);
+}
+const agent = await createAgent();
+let sessionId = parseSessionArg(process.argv.slice(2));
+let activeController;
+let running = false;
+if (sessionId !== undefined) {
+    await agent.resume(sessionId);
+    process.stderr.write(`[session] resumed ${sessionId}\n`);
+}
+const rl = createInterface({ input: stdin, output: stdout });
+process.on("SIGINT", () => {
+    if (running && activeController !== undefined) {
+        activeController.abort("user_abort");
+        process.stderr.write("\n[abort requested]\n");
+        return;
+    }
+    rl.close();
+});
+try {
+    while (true) {
+        let input;
+        try {
+            input = (await rl.question("> ")).trim();
+        }
+        catch {
+            break;
+        }
+        if (input.length === 0) {
+            continue;
+        }
+        if (input === "/exit" || input === "/quit") {
+            break;
+        }
+        const controller = new AbortController();
+        activeController = controller;
+        running = true;
+        try {
+            for await (const event of agent.run(input, {
+                ...(sessionId === undefined ? {} : { sessionId }),
+                signal: controller.signal,
+            })) {
+                sessionId ??= event.sessionId;
+                renderAgentEvent(event);
+            }
+        }
+        finally {
+            running = false;
+            activeController = undefined;
+        }
+    }
+}
+finally {
+    rl.close();
+}
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

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

package/dist/cli/renderer.d.ts

@@ -0,0 +1,2 @@
+import type { AgentEvent } from "../events/index.js";
+export declare function renderAgentEvent(event: AgentEvent): void;

package/dist/cli/renderer.js

@@ -0,0 +1,36 @@
+function summarize(value, maxChars = 240) {
+    const text = typeof value === "string" ? value : JSON.stringify(value);
+    return text.length <= maxChars
+        ? text
+        : `${text.slice(0, maxChars)}…`;
+}
+export function renderAgentEvent(event) {
+    if (event.type === "message_delta") {
+        process.stdout.write(event.data.delta);
+        return;
+    }
+    if (event.type === "tool_start") {
+        process.stderr.write(`\n[tool:start] ${event.data.call.toolName}\n`);
+        return;
+    }
+    if (event.type === "tool_end") {
+        process.stderr.write(`[tool:end] ${event.data.result.call.toolName} ${event.data.result.isError ? "error" : "ok"}: ${summarize(event.data.result.content)}\n`);
+        return;
+    }
+    if (event.type === "compact_start") {
+        process.stderr.write(`\n[compact:start] ${event.data.reason}\n`);
+        return;
+    }
+    if (event.type === "compact_end") {
+        process.stderr.write("[compact:end]\n");
+        return;
+    }
+    if (event.type === "error") {
+        process.stderr.write(`\n[error] ${event.data.error.code}: ${event.data.error.message}\n`);
+        return;
+    }
+    if (event.type === "run_end") {
+        process.stdout.write(`\n[done: ${event.data.reason}]\n`);
+    }
+}
+//# sourceMappingURL=renderer.js.map

package/dist/cli/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../src/cli/renderer.ts"],"names":[],"mappings":"AAEA,SAAS,SAAS,CAAC,KAAc,EAAE,QAAQ,GAAG,GAAG;IAC/C,MAAM,IAAI,GACR,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC5D,OAAO,IAAI,CAAC,MAAM,IAAI,QAAQ;QAC5B,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAiB;IAChD,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;QACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvC,OAAO;IACT,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,kBAAkB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAC/C,CAAC;QACF,OAAO;IACT,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,cAAc,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,IAC3C,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IACxC,KAAK,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAC9C,CAAC;QACF,OAAO;IACT,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;QACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,qBAAqB,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAC3C,CAAC;QACF,OAAO;IACT,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;QACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACxC,OAAO;IACT,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,aAAa,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CACpE,CAAC;QACF,OAAO;IACT,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC"}

package/dist/compaction/budget.d.ts

@@ -0,0 +1,14 @@
+import type { ModelCapabilities } from "../model/types.js";
+import type { AgentMessage } from "../types/index.js";
+import type { ContextBudgetEstimator, ContextBudgetUsage } from "./types.js";
+export interface MessageTokenEstimator {
+    estimate(messages: readonly AgentMessage[]): number;
+}
+export declare class CharacterBudgetTokenEstimator implements MessageTokenEstimator {
+    estimate(messages: readonly AgentMessage[]): number;
+}
+export declare class DefaultContextBudgetEstimator implements ContextBudgetEstimator {
+    private readonly estimator;
+    constructor(estimator?: MessageTokenEstimator);
+    estimate(messages: readonly AgentMessage[], capabilities: ModelCapabilities): Promise<ContextBudgetUsage>;
+}

package/dist/compaction/budget.js

@@ -0,0 +1,28 @@
+export class CharacterBudgetTokenEstimator {
+    estimate(messages) {
+        if (messages.length === 0) {
+            return 0;
+        }
+        return Math.max(1, Math.ceil(JSON.stringify(messages).length / 4));
+    }
+}
+export class DefaultContextBudgetEstimator {
+    estimator;
+    constructor(estimator = new CharacterBudgetTokenEstimator()) {
+        this.estimator = estimator;
+    }
+    async estimate(messages, capabilities) {
+        const contextWindow = Math.max(1, capabilities.contextWindow);
+        const reservedOutputTokens = Math.min(capabilities.maxOutputTokens ??
+            Math.max(1, Math.floor(contextWindow / 4)), Math.max(0, contextWindow - 1));
+        const estimatedInputTokens = this.estimator.estimate(messages);
+        const ratio = Math.min(Number.MAX_SAFE_INTEGER, (estimatedInputTokens + reservedOutputTokens) / contextWindow);
+        return {
+            estimatedInputTokens,
+            contextWindow,
+            reservedOutputTokens,
+            ratio,
+        };
+    }
+}
+//# sourceMappingURL=budget.js.map

package/dist/compaction/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/compaction/budget.ts"],"names":[],"mappings":"AAWA,MAAM,OAAO,6BAA6B;IACxC,QAAQ,CAAC,QAAiC;QACxC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,CAAC;QACX,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;CACF;AAED,MAAM,OAAO,6BAA6B;IAIrB;IADnB,YACmB,YACf,IAAI,6BAA6B,EAAE;QADpB,cAAS,GAAT,SAAS,CACW;IACpC,CAAC;IAEJ,KAAK,CAAC,QAAQ,CACZ,QAAiC,EACjC,YAA+B;QAE/B,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC;QAC9D,MAAM,oBAAoB,GAAG,IAAI,CAAC,GAAG,CACnC,YAAY,CAAC,eAAe;YAC1B,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,EAC5C,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,GAAG,CAAC,CAAC,CAC/B,CAAC;QACF,MAAM,oBAAoB,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,MAAM,CAAC,gBAAgB,EACvB,CAAC,oBAAoB,GAAG,oBAAoB,CAAC,GAAG,aAAa,CAC9D,CAAC;QAEF,OAAO;YACL,oBAAoB;YACpB,aAAa;YACb,oBAAoB;YACpB,KAAK;SACN,CAAC;IACJ,CAAC;CACF"}

package/dist/compaction/deterministic.d.ts

@@ -0,0 +1,9 @@
+import { type MessageTokenEstimator } from "./budget.js";
+import type { CompactionResult, CompactionStrategy, CompactionStrategyRequest } from "./types.js";
+export declare class DeterministicCompactionStrategy implements CompactionStrategy {
+    private readonly estimator;
+    readonly id = "deterministic";
+    constructor(estimator?: MessageTokenEstimator);
+    supports(reason: CompactionStrategyRequest["reason"]): boolean;
+    compact(request: CompactionStrategyRequest, signal?: AbortSignal): Promise<CompactionResult>;
+}