@chopin-ai/harness-pi 0.0.0-stage → 0.3.0

package/dist/bridge.js

@@ -0,0 +1,259 @@
+import { AgentSideConnection, PROTOCOL_VERSION, RequestError } from "@agentclientprotocol/sdk";
+import { setTimeout as sleep } from "node:timers/promises";
+import { entryUpdates, runInputs, stopReason } from "./acp.js";
+import { call, CALL_TIMEOUT_MS, CallTimeout, heldList, randomId, startConversation, unansweredText, within, } from "./protocol.js";
+import { lost as lostOutcome } from "./submissions.js";
+const AWAY = "the service stopped answering";
+const RESEND_WAIT_MS = 250;
+/** A request the service could not answer, however that came to be known. */
+function lostService(detail = AWAY) {
+    return RequestError.internalError({ reason: "lost", detail }, `the agent did not answer: ${unansweredText({ reason: "lost", detail })}`);
+}
+/**
+ * Speaks ACP on `stream` for the agent behind `client`, a host connected to the agent service, so any ACP client
+ * can drive it. One ACP session is one conversation.
+ */
+export function serveAcp(stream, client, options = {}) {
+    let bridge;
+    const lostAfterMs = options.lostAfterMs ?? CALL_TIMEOUT_MS;
+    const connection = new AgentSideConnection((opened) => (bridge = new Bridge(opened, client, lostAfterMs)), stream);
+    void connection.closed.finally(() => bridge?.release());
+    return connection;
+}
+class Bridge {
+    #connection;
+    #client;
+    #lostAfterMs;
+    #sessions = new Map();
+    /** Aborted once the client is gone. */
+    #gone = new AbortController();
+    #list;
+    constructor(connection, client, lostAfterMs) {
+        this.#connection = connection;
+        this.#client = client;
+        this.#lostAfterMs = lostAfterMs;
+        this.#list = heldList(client, { timeoutMs: lostAfterMs, signal: this.#gone.signal });
+    }
+    /** Lets go of every session's conversation, and ends the prompts still waiting, once the client is gone. */
+    async release() {
+        this.#gone.abort();
+        this.#list.release();
+        const sessions = [...this.#sessions.values()];
+        this.#sessions.clear();
+        await Promise.all(sessions.map(async (session) => (await session.catch(() => undefined))?.release()));
+    }
+    async initialize() {
+        return { protocolVersion: PROTOCOL_VERSION, agentCapabilities: {}, authMethods: [] };
+    }
+    async authenticate() {
+        return {};
+    }
+    async newSession() {
+        const { id, conversation } = await this.#reach((options) => startConversation(this.#client, this.#list.get, options));
+        if (this.#gone.signal.aborted) {
+            conversation.release();
+            throw RequestError.internalError(undefined, "the client has gone");
+        }
+        this.#sessions.set(String(id), Promise.resolve(conversation));
+        return { sessionId: String(id) };
+    }
+    async prompt({ sessionId, prompt }) {
+        const conversation = await this.#session(sessionId);
+        // Text and resource links are what every ACP agent takes; a link reaches the model as its name and its address.
+        const text = prompt.flatMap((block) => {
+            if (block.type === "text")
+                return [block.text];
+            if (block.type === "resource_link")
+                return [`${block.name} <${block.uri}>`];
+            return [];
+        }).join("\n");
+        if (text.trim() === "")
+            throw RequestError.invalidParams(undefined, "the prompt has no text or link");
+        const sent = new Set(view(conversation).entries.map((entry) => entry.id));
+        const answers = [];
+        let forwarding = Promise.resolve();
+        let undelivered;
+        // Committed entries go out in order, each once; the client already has its own prompt.
+        const forward = () => {
+            forwarding = forwarding.then(async () => {
+                if (conversation.status !== "live")
+                    return;
+                for (const entry of view(conversation).entries.filter((e) => !sent.has(e.id))) {
+                    sent.add(entry.id);
+                    answers.push(...(entry.model ?? []).filter((m) => m.role === "assistant"));
+                    for (const update of entryUpdates(entry)) {
+                        if (update.sessionUpdate !== "user_message_chunk")
+                            await this.#connection.sessionUpdate({ sessionId, update });
+                    }
+                }
+            }).catch((error) => {
+                undelivered ??= error;
+            });
+        };
+        const submission = await this.#send(sessionId, conversation, text);
+        const outcome = await this.#follow(sessionId, conversation, submission, forward);
+        if (outcome.status === "gone")
+            return { stopReason: "cancelled" };
+        if (outcome.status === "ended")
+            throw RequestError.resourceNotFound(sessionId);
+        forward();
+        await forwarding;
+        if (undelivered !== undefined)
+            throw undelivered;
+        if (outcome.status === "unanswered") {
+            if (outcome.reason === "aborted")
+                return { stopReason: "cancelled" };
+            if (outcome.reason === "lost")
+                throw lostService(outcome.detail);
+            const why = unansweredText({ reason: outcome.reason ?? "unknown", detail: outcome.detail });
+            throw RequestError.internalError({ reason: outcome.reason, detail: outcome.detail }, `the agent did not answer: ${why}`);
+        }
+        return { stopReason: stopReason(answers.at(-1)) };
+    }
+    /**
+     * Submits `text` under a request of its own, so it can be sent again when the link fails mid-call: the service
+     * admits it once, whether or not the first try reached it.
+     */
+    async #send(sessionId, conversation, text) {
+        const request = randomId();
+        // One bound for every try, so a send waits no longer than any other request.
+        return this.#reach((options) => within(options, async (signal) => {
+            for (;;) {
+                // Only a call whose link wavered while it ran is sent again; one on a steady link failed for what it is.
+                let wavered = false;
+                const stop = conversation.onStatus(() => void (wavered = true));
+                try {
+                    return await this.#client.root((ctx) => conversation.submit({ text, request }, ctx), { signal });
+                }
+                catch (error) {
+                    // The link's own news may trail the call's failure by a turn of the event loop.
+                    await sleep(0);
+                    if (conversation.status === "gone" || conversation.status === "released") {
+                        this.#forget(sessionId, conversation);
+                        throw RequestError.resourceNotFound(sessionId);
+                    }
+                    if (!wavered && conversation.status === "live")
+                        throw error;
+                    await sleep(RESEND_WAIT_MS, undefined, { signal });
+                }
+                finally {
+                    stop();
+                }
+            }
+        }));
+    }
+    async cancel({ sessionId }) {
+        const conversation = await this.#session(sessionId);
+        await this.#call((ctx) => conversation.abort({}, ctx));
+    }
+    /**
+     * How `submission` ends: once it has settled and the view no longer shows it running, so the last answer is in
+     * the view. A reconnect brings the object's state back as the store has it; a service that stays away, or a
+     * conversation that ended, takes the session with it.
+     */
+    #follow(sessionId, conversation, submission, changed) {
+        const stops = [];
+        let ended = false;
+        return new Promise((resolve) => {
+            const settle = (outcome) => {
+                if (ended)
+                    return;
+                ended = true;
+                resolve(outcome);
+            };
+            const lost = (detail) => settle(lostOutcome(detail));
+            const check = () => {
+                if (ended || conversation.status !== "live")
+                    return;
+                changed();
+                const current = conversation.submissions.value[String(submission)];
+                if (current !== undefined && current.status !== "pending" && !runInputs(view(conversation)).includes(submission))
+                    settle(current);
+            };
+            let away;
+            const followed = (status) => {
+                if (ended)
+                    return;
+                clearTimeout(away);
+                if (status === "live") {
+                    check();
+                }
+                else if (status === "loading") {
+                    away = setTimeout(() => {
+                        lost(AWAY);
+                        this.#forget(sessionId, conversation);
+                    }, this.#lostAfterMs);
+                }
+                else {
+                    settle({ status: "ended" });
+                    this.#forget(sessionId, conversation);
+                }
+            };
+            // The agent keeps working for a client that has gone, but nobody waits for it here any longer.
+            const gone = () => settle({ status: "gone" });
+            this.#gone.signal.addEventListener("abort", gone, { once: true });
+            stops.push(() => clearTimeout(away), () => this.#gone.signal.removeEventListener("abort", gone));
+            // Subscribing delivers the current value at once, so the outcome may already be known here.
+            stops.push(conversation.view.subscribe(check), conversation.submissions.subscribe(check), conversation.onStatus(followed));
+            // Status listeners hear only of changes; one that already happened is taken as it stands.
+            if (conversation.status !== "live")
+                followed(conversation.status);
+            if (this.#gone.signal.aborted)
+                gone();
+        }).finally(() => stops.forEach((stop) => stop()));
+    }
+    /** A held conversation, once it is live: waiting out a reconnect, but no longer than the service may stay away. */
+    async #session(sessionId) {
+        const session = this.#sessions.get(sessionId);
+        if (session === undefined)
+            throw RequestError.resourceNotFound(sessionId);
+        const conversation = await session;
+        await this.#reach((options) => within(options, (signal) => this.#live(sessionId, conversation, signal)));
+        return conversation;
+    }
+    /** Resolves once the session's conversation is live; one that ended takes the session with it. */
+    #live(sessionId, conversation, signal) {
+        return new Promise((resolve, reject) => {
+            const settled = (status) => {
+                if (status === "loading")
+                    return;
+                stop();
+                signal.removeEventListener("abort", aborted);
+                if (status === "live")
+                    return resolve();
+                this.#forget(sessionId, conversation);
+                reject(RequestError.resourceNotFound(sessionId));
+            };
+            const aborted = () => {
+                stop();
+                reject(signal.reason);
+            };
+            const stop = conversation.onStatus(settled);
+            if (signal.aborted)
+                return aborted();
+            signal.addEventListener("abort", aborted, { once: true });
+            settled(conversation.status);
+        });
+    }
+    #forget(sessionId, conversation) {
+        this.#sessions.delete(sessionId);
+        conversation.release();
+    }
+    /** A method call on an object the bridge holds, through any reconnect, as long as the service may stay away. */
+    #call(work) {
+        return this.#reach((options) => call(this.#client, work, options));
+    }
+    /** Any wait on the service, for as long as it may stay away and the client is here. */
+    async #reach(work) {
+        try {
+            return await work({ timeoutMs: this.#lostAfterMs, signal: this.#gone.signal });
+        }
+        catch (error) {
+            throw error instanceof CallTimeout || this.#gone.signal.aborted ? lostService() : error;
+        }
+    }
+}
+function view(conversation) {
+    return conversation.view.value;
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

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

package/dist/client-context.d.ts

@@ -0,0 +1,7 @@
+import { type Extension } from "@earendil-works/pi-durable";
+/** What a client shows its user beside a conversation, in the client's own words, such as the page they are on. */
+export declare const ClientContextDoc: import("@earendil-works/pi-durable").ConversationDocToken<{
+    text: string;
+}>;
+/** Gives the model the client's context as it stands at each request; nothing while the client has set none. */
+export declare const clientContext: Extension;

package/dist/client-context.js

@@ -0,0 +1,20 @@
+import { defineDoc, defineExtension, section } from "@earendil-works/pi-durable";
+/** What a client shows its user beside a conversation, in the client's own words, such as the page they are on. */
+export const ClientContextDoc = defineDoc({
+    kind: "chopin.client-context",
+    version: 1,
+    scope: "conversation",
+    history: "latest",
+    fork: "current",
+    initial: () => ({ text: "" }),
+    checkpointWhen: () => false,
+});
+/** Gives the model the client's context as it stands at each request; nothing while the client has set none. */
+export const clientContext = defineExtension({
+    name: "chopin-client-context",
+    sections: [section("client_context", async ({ read, conversationId }, context) => {
+            const text = (await read.snapshot(ClientContextDoc, conversationId, context))?.text ?? "";
+            return text === "" ? undefined : text;
+        })],
+});
+//# sourceMappingURL=client-context.js.map

package/dist/client-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-context.js","sourceRoot":"","sources":["../src/client-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,OAAO,EAAkB,MAAM,4BAA4B,CAAC;AAEjG,mHAAmH;AACnH,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAmB;IAC1D,IAAI,EAAE,uBAAuB;IAC7B,OAAO,EAAE,CAAC;IACV,KAAK,EAAE,cAAc;IACrB,OAAO,EAAE,QAAQ;IACjB,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAC7B,cAAc,EAAE,GAAG,EAAE,CAAC,KAAK;CAC5B,CAAC,CAAC;AAEH,gHAAgH;AAChH,MAAM,CAAC,MAAM,aAAa,GAAc,eAAe,CAAC;IACtD,IAAI,EAAE,uBAAuB;IAC7B,QAAQ,EAAE,CAAC,OAAO,CAAC,gBAAgB,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,EAAE;YAC/E,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,gBAAgB,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;YAC1F,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;QACxC,CAAC,CAAC,CAAC;CACJ,CAAC,CAAC"}

package/dist/continuation.d.ts

@@ -0,0 +1,34 @@
+import { type TranscriptEntry } from "@chopin-ai/core";
+import type { Api, AssistantMessage, Message, Model, Models } from "@earendil-works/pi-ai";
+import type { Extension } from "@earendil-works/pi-durable";
+/** A decision point to continue from: what came before it, and what the request carries. */
+export interface ContinuationInput {
+    /** The session before the decision point, as model messages. */
+    messages: readonly Message[];
+    /** The extensions whose sections and tools the request carries, the layer's among them, in install order. */
+    extensions: readonly Extension[];
+    model: Model<Api>;
+    models: Models;
+    signal?: AbortSignal;
+}
+/**
+ * The agent's next step at a decision point, from one request: the system prompt rendered from `extensions` as a
+ * session's would be, the tools they offer, and the session so far. Nothing it asks for is run. Two versions of a
+ * layer continued this way differ only in the layer.
+ */
+export declare function continueAt(input: ContinuationInput): Promise<AssistantMessage>;
+/**
+ * What a provider would refuse in a conversation continued at a step: it must open with the user, give every call its
+ * result right after it and no result without its call, and end with the user's or a tool's last word.
+ */
+export declare function conversationProblems(messages: readonly Message[]): string[];
+/** The step as a judge reads it: what it said and the calls it asked for. */
+export declare function stepText(step: AssistantMessage): string;
+/**
+ * The model messages of an ACP transcript: the user's text, the agent's text and calls, and the calls' results.
+ * Thoughts are left out, as no provider takes back another's. Assistant turns carry `model`'s identity, so the
+ * provider reads them as its own. A provider takes a result only right after its call, so a result whose call is not
+ * here is left out, as is a call that never got one, and what the user said while calls were running follows their
+ * results.
+ */
+export declare function transcriptMessages(entries: readonly TranscriptEntry[], model: Model<Api>): Message[];

package/dist/continuation.js

@@ -0,0 +1,171 @@
+import { LoopFault } from "@chopin-ai/core";
+import { BACKGROUND_CONTEXT } from "@earendil-works/chord/context";
+/**
+ * The agent's next step at a decision point, from one request: the system prompt rendered from `extensions` as a
+ * session's would be, the tools they offer, and the session so far. Nothing it asks for is run. Two versions of a
+ * layer continued this way differ only in the layer.
+ */
+export async function continueAt(input) {
+    const systemPrompt = await renderSections(input);
+    const tools = input.extensions.flatMap((extension) => (extension.tools ?? []).map((tool) => ({ name: tool.name, description: tool.description, parameters: tool.parameters })));
+    // The step is asked for after the last word of the user or a tool; text the agent had begun it with is part of it.
+    const messages = [...input.messages];
+    while (messages.at(-1)?.role === "assistant")
+        messages.pop();
+    const problems = conversationProblems(messages);
+    if (problems.length > 0)
+        throw new LoopFault(`a provider would refuse this continuation: ${problems.join("; ")}`);
+    return input.models.completeSimple(input.model, { systemPrompt, messages, tools }, {
+        ...(input.signal && { signal: input.signal }),
+    });
+}
+/**
+ * What a provider would refuse in a conversation continued at a step: it must open with the user, give every call its
+ * result right after it and no result without its call, and end with the user's or a tool's last word.
+ */
+export function conversationProblems(messages) {
+    const problems = [];
+    if (messages[0]?.role !== "user")
+        problems.push("it does not open with the user");
+    const last = messages.at(-1)?.role;
+    if (last !== "user" && last !== "toolResult")
+        problems.push("it ends with the agent");
+    messages.forEach((message, at) => {
+        if (message.role === "toolResult")
+            return;
+        const calls = message.role === "assistant" ? message.content.flatMap((block) => (block.type === "toolCall" ? [block.id] : [])) : [];
+        const results = [];
+        for (let next = at + 1; messages[next]?.role === "toolResult"; next += 1)
+            results.push(messages[next].toolCallId);
+        if (calls.some((id) => !results.includes(id)))
+            problems.push(`a call in message ${at} has no result right after it`);
+        if (results.some((id) => !calls.includes(id)))
+            problems.push(`a result after message ${at} answers no call in it`);
+    });
+    return problems;
+}
+/** The step as a judge reads it: what it said and the calls it asked for. */
+export function stepText(step) {
+    return JSON.stringify(step.content.flatMap((block) => {
+        if (block.type === "text")
+            return [{ text: block.text }];
+        if (block.type === "toolCall")
+            return [{ call: block.name, arguments: block.arguments }];
+        return [];
+    }));
+}
+/**
+ * The model messages of an ACP transcript: the user's text, the agent's text and calls, and the calls' results.
+ * Thoughts are left out, as no provider takes back another's. Assistant turns carry `model`'s identity, so the
+ * provider reads them as its own. A provider takes a result only right after its call, so a result whose call is not
+ * here is left out, as is a call that never got one, and what the user said while calls were running follows their
+ * results.
+ */
+export function transcriptMessages(entries, model) {
+    const messages = [];
+    const names = new Map();
+    const waiting = new Set();
+    let held = [];
+    const assistant = () => {
+        const last = messages.at(-1);
+        if (last?.role === "assistant")
+            return last;
+        const made = {
+            role: "assistant", content: [], api: model.api, provider: model.provider, model: model.id, stopReason: "stop",
+            usage: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, totalTokens: 0, cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 } },
+            timestamp: 0,
+        };
+        messages.push(made);
+        return made;
+    };
+    const say = (text) => {
+        const last = messages.at(-1);
+        if (last?.role === "user" && typeof last.content === "string")
+            last.content = `${last.content}\n${text}`;
+        else
+            messages.push({ role: "user", content: text, timestamp: 0 });
+    };
+    const flush = () => {
+        for (const text of held)
+            say(text);
+        held = [];
+    };
+    // Calls still waiting when the agent moves on never got a result.
+    const settle = () => {
+        if (waiting.size > 0) {
+            for (let at = messages.length - 1; at >= 0; at -= 1) {
+                const message = messages[at];
+                if (message.role !== "assistant")
+                    continue;
+                message.content = message.content.filter((block) => block.type !== "toolCall" || !waiting.has(block.id));
+                if (message.content.length === 0)
+                    messages.splice(at, 1);
+                else if (!message.content.some((block) => block.type === "toolCall"))
+                    message.stopReason = "stop";
+            }
+            waiting.clear();
+        }
+        flush();
+    };
+    for (const entry of entries) {
+        if (!("notification" in entry))
+            continue;
+        const update = entry.notification.update;
+        if (update.sessionUpdate === "user_message_chunk" && update.content.type === "text") {
+            if (waiting.size > 0)
+                held.push(update.content.text);
+            else
+                say(update.content.text);
+        }
+        else if (update.sessionUpdate === "agent_message_chunk" && update.content.type === "text") {
+            settle();
+            assistant().content.push({ type: "text", text: update.content.text });
+        }
+        else if (update.sessionUpdate === "tool_call") {
+            if (messages.at(-1)?.role !== "assistant")
+                settle();
+            names.set(update.toolCallId, update.title);
+            const call = { type: "toolCall", id: update.toolCallId, name: update.title, arguments: (update.rawInput ?? {}) };
+            const turn = assistant();
+            turn.content.push(call);
+            turn.stopReason = "toolUse";
+            waiting.add(update.toolCallId);
+        }
+        else if (update.sessionUpdate === "tool_call_update" && (update.status === "completed" || update.status === "failed")) {
+            if (!waiting.delete(update.toolCallId))
+                continue;
+            const text = (update.content ?? []).flatMap((item) => (item.type === "content" && item.content.type === "text" ? [item.content.text] : [])).join("\n");
+            messages.push({
+                role: "toolResult", toolCallId: update.toolCallId, toolName: names.get(update.toolCallId) ?? update.title ?? "",
+                content: [{ type: "text", text }], isError: update.status === "failed", timestamp: 0,
+            });
+            if (waiting.size === 0)
+                flush();
+        }
+    }
+    settle();
+    return messages;
+}
+const NO_DOCUMENTS = { snapshot: async () => undefined, snapshotAsOf: async () => undefined };
+async function renderSections(input) {
+    const sections = input.extensions.flatMap((extension) => extension.sections ?? []);
+    const prompt = {
+        conversationId: 0,
+        agent: {
+            model: { provider: input.model.provider, modelId: input.model.id }, thinkingLevel: "off", extensions: input.extensions,
+            tools: input.extensions.flatMap((extension) => extension.tools ?? []), callable: [], deferred: [], sections,
+        },
+        env: undefined,
+        shown: {},
+        read: NO_DOCUMENTS,
+    };
+    const rendered = [];
+    for (const section of sections) {
+        const text = await section.render(prompt, BACKGROUND_CONTEXT);
+        if (text === undefined || text === "")
+            continue;
+        rendered.push(section.tag === false ? text : `<${section.key}>\n${text}\n</${section.key}>`);
+    }
+    return rendered.join("\n\n");
+}
+//# sourceMappingURL=continuation.js.map

package/dist/continuation.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,7 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+import { type Authenticate } from "./auth.js";
+/**
+ * Whether the service has work in hand, as `GET /status` tells whoever runs it, so a workspace is reclaimed only once
+ * it has none. Asking is not using: it keeps nothing awake.
+ */
+export declare function statusHandler(authenticate: Authenticate, busy: () => Promise<boolean>): (request: IncomingMessage, response: ServerResponse) => Promise<void>;

package/dist/http.js

@@ -0,0 +1,14 @@
+import { credentialOf } from "./auth.js";
+/**
+ * Whether the service has work in hand, as `GET /status` tells whoever runs it, so a workspace is reclaimed only once
+ * it has none. Asking is not using: it keeps nothing awake.
+ */
+export function statusHandler(authenticate, busy) {
+    return async (request, response) => {
+        const credential = credentialOf(request);
+        if (credential === undefined || (await authenticate(credential)) === undefined)
+            return void response.writeHead(401).end("unauthorized");
+        response.writeHead(200, { "content-type": "application/json" }).end(JSON.stringify({ busy: await busy() }));
+    };
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAqB,MAAM,WAAW,CAAC;AAE5D;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,YAA0B,EAAE,IAA4B;IACpF,OAAO,KAAK,EAAE,OAAwB,EAAE,QAAwB,EAAiB,EAAE;QACjF,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACzC,IAAI,UAAU,KAAK,SAAS,IAAI,CAAC,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC,KAAK,SAAS;YAAE,OAAO,KAAK,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACxI,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9G,CAAC,CAAC;AACJ,CAAC"}

package/dist/idle-compaction.d.ts

@@ -0,0 +1,25 @@
+import type { Models } from "@earendil-works/pi-ai";
+import { type ConversationId, type Extension, type Harness } from "@earendil-works/pi-durable";
+/** Where a conversation was compacted for being idle; the model never reads it. */
+export declare const IdleCompactionEntry: import("@earendil-works/pi-durable").Entry<never>;
+export interface IdleCompactionOptions {
+    /** The models the harness asks, with its credentials. */
+    models: Models;
+    /** Whether people come back to `conversation`; no other is compacted for being idle. */
+    eligible(conversation: ConversationId): Promise<boolean>;
+    report?: (error: unknown) => void;
+}
+/**
+ * Compacts a conversation left idle just before its prompt cache expires. The summary is asked for in a request that
+ * repeats the conversation's own and adds one message, so the provider reads all but that from its cache.
+ */
+export declare class IdleCompaction {
+    #private;
+    readonly extension: Extension;
+    constructor(options: IdleCompactionOptions);
+    /** Starts on `harness`, which runs this extension. */
+    attach(harness: Harness): void;
+    /** Drops what is scheduled for `conversation`, and stops its compaction if one is asking for a summary. */
+    cancel(conversation: ConversationId): void;
+    close(): void;
+}