@kvman/kvcoder 0.1.0

package/dist/turns/compaction.js

@@ -0,0 +1,55 @@
+import { ProblemError } from '@kvman/sdk';
+import { txRecords } from "../store/collections.js";
+import { appendMessage, appendNotice } from "./history.js";
+import { modelInfo } from "./model-info.js";
+import { sentHistory, textOf } from "./model-context.js";
+// Compaction (plan 08 §8.1): above `kvcoder.compactAt` of the model's window (characters / 4), kvai summarizes the
+// older messages, the last `kvcoder.compactKeep` stay whole (ADR 0020, 1), and a summary message is stored. A step marks it in its stream with
+// `compaction` chunks (ADR 0009, 99); a failed summary adds a notice and the step goes on. Older messages smaller
+// than a tenth of the model's window aren't summarized, so a full chat isn't summarized again on every step (ADR 0019, 7).
+const minimumShare = 0.1;
+const summarizer = 'Summarize the conversation below for the agent that continues it: the goal, the decisions, the files and commands that matter, what is done, and what is left. Keep names, paths, and numbers exact. Reply with the summary only.';
+function lineOf(message) {
+    const content = message.content;
+    if (message.kind === 'toolResult')
+        return `Tool result: ${textOf(content['content'])}`;
+    if (message.kind === 'user')
+        return `User: ${textOf(content['content'])}`;
+    const calls = Array.isArray(content['content']) ? content['content'].flatMap((block) => (typeof block === 'object' && block !== null && !Array.isArray(block) && block['type'] === 'toolCall' ? [`[called ${String(block['name'])} ${JSON.stringify(block['arguments'] ?? {})}]`] : [])) : [];
+    return `Assistant: ${[textOf(content['content']), ...calls].filter((part) => part !== '').join(' ')}`;
+}
+function transcript(history, older) {
+    const summary = history.summary === undefined ? [] : [`Earlier summary: ${String(history.summary.content['text'] ?? '')}`];
+    return [...summary, ...older.map(lineOf)].join('\n\n');
+}
+const sizeOf = (messages) => messages.reduce((total, message) => total + JSON.stringify(message.content).length, 0) / 4;
+const estimate = (prompt, history) => (prompt.length + JSON.stringify(history.summary?.content ?? '').length) / 4 + sizeOf(history.messages);
+/** Summarizes the session's older messages when they pass the threshold, or with `force` whatever the threshold; says whether a summary was stored. */
+export async function compact(ctx, session, options) {
+    const history = await sentHistory(ctx, session.id, session.nextSeq);
+    const info = await modelInfo(ctx, session.model);
+    if (!options.force && (info === undefined || estimate(options.prompt, history) <= info.contextWindow * options.compactAt))
+        return false;
+    const older = history.messages.slice(0, Math.max(history.messages.length - options.keep, 0));
+    const last = older.at(-1);
+    if (last === undefined || (info !== undefined && sizeOf(older) < info.contextWindow * minimumShare))
+        return false;
+    ctx.job.progress({ type: 'compaction', state: 'started' });
+    try {
+        const answer = await ctx.exec('kvai.complete', { ...(session.model === null ? {} : { model: session.model }), sessionId: session.id, systemPrompt: summarizer, messages: [{ role: 'user', content: transcript(history, older), timestamp: Date.now() }] });
+        const text = textOf(answer.message.content);
+        await ctx.store.transaction((tx) => appendMessage(txRecords(tx), session, { kind: 'summary', content: { text, coversThroughSeq: last.seq }, turnId: options.turnId }));
+        return true;
+    }
+    catch (error) {
+        if (!(error instanceof ProblemError) || ctx.job.signal.aborted)
+            throw error;
+        const problem = error.problem;
+        await ctx.store.transaction((tx) => appendNotice(txRecords(tx), session, 'SUMMARY_FAILED', { code: problem.code }, options.turnId));
+        return false;
+    }
+    finally {
+        ctx.job.progress({ type: 'compaction', state: 'done' });
+    }
+}
+//# sourceMappingURL=compaction.js.map

package/dist/turns/compaction.js.map

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

package/dist/turns/end-turn.d.ts

@@ -0,0 +1,15 @@
+import type { Ctx } from '@kvman/sdk';
+import type { JsonValue } from '../connector-call.ts';
+import type { Outcome } from '../schemas/records.ts';
+export type EndedBy = 'step' | 'handler' | 'cancel';
+export type Notice = {
+    code: string;
+    params?: Record<string, JsonValue>;
+};
+export declare function endTurn(ctx: Ctx, sessionId: string, turnId: string, outcome: Outcome, by: EndedBy, notice?: Notice): Promise<boolean>;
+/** What a finished subagent returns (ADR 0009, 102). */
+export declare function childResult(ctx: Ctx, childId: string, outcome: Outcome): Promise<{
+    text: string;
+    isError: boolean;
+}>;
+//# sourceMappingURL=end-turn.d.ts.map

package/dist/turns/end-turn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"end-turn.d.ts","sourceRoot":"","sources":["../../src/turns/end-turn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAU,MAAM,YAAY,CAAC;AAE9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,KAAK,EAAE,OAAO,EAAc,MAAM,uBAAuB,CAAC;AAajE,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEpD,MAAM,MAAM,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;CAAE,CAAC;AAE1E,wBAAsB,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAoB3I;AAOD,wDAAwD;AACxD,wBAAsB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAG1H"}

package/dist/turns/end-turn.js

@@ -0,0 +1,67 @@
+import { truncate } from "../result-text.js";
+import { firePoint } from "../registry/session-points.js";
+import { now } from "../sessions/session-lookup.js";
+import { records, txRecords } from "../store/collections.js";
+import { appendBackground, backgroundText } from "./background.js";
+import { appendNotice, appendQueued } from "./history.js";
+import { textOf } from "./model-context.js";
+import { heldText, resolvePending } from "./resolve.js";
+export async function endTurn(ctx, sessionId, turnId, outcome, by, notice) {
+    const ended = await ctx.store.transaction((tx) => {
+        const store = txRecords(tx);
+        const session = store.sessions.get(sessionId);
+        const turn = store.turns.get(turnId);
+        if (session?.turnId !== turnId || turn === undefined || turn.outcome !== null)
+            return undefined;
+        const endedAt = now();
+        const durationMs = Math.max(Date.parse(endedAt) - Date.parse(turn.startedAt), 0);
+        store.turns.update(turnId, { endedAt, durationMs, outcome, calls: [], pending: [], results: [] });
+        for (const question of store.questions.find({ sessionId }, { limit: 1000 }))
+            store.questions.delete(question.id);
+        appendQueued(store, session, null);
+        if (notice !== undefined)
+            appendNotice(store, session, notice.code, notice.params ?? {}, turnId);
+        const updated = store.sessions.update(sessionId, { status: 'idle', turnId: null, stepJobId: null, endedTurns: session.endedTurns + 1, durationMs: session.durationMs + durationMs, updatedAt: endedAt });
+        return { session: updated, usage: turn.usage, durationMs };
+    });
+    if (ended === undefined)
+        return false;
+    await firePoint(ctx, 'kvcoder.turn.ended', { sessionId, turnId, outcome, usage: ended.usage, durationMs: ended.durationMs });
+    if (ended.session.parentId === null && ended.session.autoTitle && ended.session.endedTurns === 1)
+        await ctx.execAsync('kvcoder.session.title', { sessionId });
+    if (ended.session.parentId !== null && by !== 'cancel')
+        await childEnded(ctx, ended.session, outcome, by, notice);
+    return true;
+}
+async function lastAnswer(ctx, sessionId) {
+    const [answer] = await records(ctx.store).messages.find({ sessionId, kind: 'assistant' }, { limit: 1, order: 'desc' });
+    return answer === undefined ? '' : textOf(answer.content['content']);
+}
+/** What a finished subagent returns (ADR 0009, 102). */
+export async function childResult(ctx, childId, outcome) {
+    const answer = await lastAnswer(ctx, childId);
+    return outcome === 'done' ? { text: truncate(answer), isError: false } : { text: truncate(`subagent ended ${outcome}\n${answer}`), isError: true };
+}
+async function childEnded(ctx, child, outcome, by, notice) {
+    const store = records(ctx.store);
+    const parent = child.parentId === null ? undefined : await store.sessions.get(child.parentId);
+    if (parent === undefined)
+        return;
+    const turn = parent.turnId === null ? undefined : await store.turns.get(parent.turnId);
+    const waiting = turn?.pending.find((item) => item.childSessionId === child.id);
+    if (waiting !== undefined && turn !== undefined) {
+        if (by === 'handler') {
+            await endTurn(ctx, parent.id, turn.id, outcome === 'interrupted' ? 'interrupted' : 'failed', 'handler', notice);
+            return;
+        }
+        const result = await childResult(ctx, child.id, outcome);
+        await resolvePending(ctx, parent.id, waiting.toolCallId, heldText(waiting.toolCallId, result.text, result.isError), false);
+        return;
+    }
+    const [entry] = await store.background.find({ sessionId: parent.id, ref: child.id }, { limit: 1 });
+    if (entry === undefined)
+        return;
+    const result = await childResult(ctx, child.id, outcome);
+    await appendBackground(ctx, parent.id, { kind: 'subagent', sessionId: child.id }, backgroundText(entry.call, child.id, result.text), by === 'step');
+}
+//# sourceMappingURL=end-turn.js.map

package/dist/turns/end-turn.js.map

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

package/dist/turns/history.d.ts

@@ -0,0 +1,28 @@
+import type { Stored } from '@kvman/sdk';
+import type { JsonValue, MessageDoc, SessionDoc, Source, Usage } from '../schemas/records.ts';
+import type { TxRecords } from '../store/collections.ts';
+export type NewMessage = {
+    kind: MessageDoc['kind'];
+    content: Record<string, JsonValue>;
+    turnId?: string | null;
+    source?: Source | null;
+    fileIds?: readonly string[] | null;
+    fileNames?: readonly string[] | null;
+    model?: string | null;
+    usage?: Usage | null;
+    durationMs?: number | null;
+};
+/** Messages are found in blocks of 500 by `seq`, since the store pages only by equality. */
+export declare const blockSize = 500;
+export declare const blockOf: (seq: number) => number;
+export declare function appendMessage(tx: TxRecords, session: Stored<SessionDoc>, message: NewMessage): Stored<MessageDoc>;
+/** A user message's content, as pi-ai has it. */
+export declare function userContent(text: string): Record<string, JsonValue>;
+/** Moves the session's queued messages into its history, in the order they came; returns how many moved. */
+export declare function appendQueued(tx: TxRecords, session: Stored<SessionDoc>, turnId: string | null): number;
+/** A notice (plan 08 §8.1): kvcoder's own display-only message, shown as `kvcoder.notices.<code>`. */
+export declare function appendNotice(tx: TxRecords, session: Stored<SessionDoc>, code: string, params?: Record<string, JsonValue>, turnId?: string | null): void;
+/** No usage yet. */
+export declare const noUsage: () => Usage;
+export declare function addUsage(first: Usage, second: Usage): Usage;
+//# sourceMappingURL=history.d.ts.map

package/dist/turns/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/turns/history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAKzD,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF,4FAA4F;AAC5F,eAAO,MAAM,SAAS,MAAM,CAAC;AAE7B,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,KAAG,MAAqC,CAAC;AAE5E,wBAAgB,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,CAkBjH;AAED,iDAAiD;AACjD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAEnE;AAED,4GAA4G;AAC5G,wBAAgB,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAOtG;AAED,sGAAsG;AACtG,wBAAgB,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAM,EAAE,MAAM,GAAE,MAAM,GAAG,IAAW,GAAG,IAAI,CAEjK;AAID,oBAAoB;AACpB,eAAO,MAAM,OAAO,QAAO,KAAsB,CAAC;AAElD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,GAAG,KAAK,CAE3D"}

package/dist/turns/history.js

@@ -0,0 +1,47 @@
+import { now } from "../sessions/session-lookup.js";
+/** Messages are found in blocks of 500 by `seq`, since the store pages only by equality. */
+export const blockSize = 500;
+export const blockOf = (seq) => Math.floor(seq / blockSize);
+export function appendMessage(tx, session, message) {
+    const fresh = tx.sessions.get(session.id) ?? session;
+    tx.sessions.update(session.id, { nextSeq: fresh.nextSeq + 1, updatedAt: now() });
+    return tx.messages.insert({
+        sessionId: session.id,
+        turnId: message.turnId ?? null,
+        seq: fresh.nextSeq,
+        block: blockOf(fresh.nextSeq),
+        kind: message.kind,
+        source: message.source ?? null,
+        content: message.content,
+        fileIds: message.fileIds === undefined || message.fileIds === null ? null : [...message.fileIds],
+        fileNames: message.fileNames === undefined || message.fileNames === null ? null : [...message.fileNames],
+        model: message.model ?? null,
+        usage: message.usage ?? null,
+        durationMs: message.durationMs ?? null,
+        createdAt: now(),
+    });
+}
+/** A user message's content, as pi-ai has it. */
+export function userContent(text) {
+    return { role: 'user', content: text, timestamp: Date.now() };
+}
+/** Moves the session's queued messages into its history, in the order they came; returns how many moved. */
+export function appendQueued(tx, session, turnId) {
+    const queued = tx.queued.find({ sessionId: session.id }, { limit: 1000 });
+    for (const message of queued) {
+        tx.queued.delete(message.id);
+        appendMessage(tx, session, { kind: 'user', content: userContent(message.text), turnId, source: message.source, fileIds: message.fileIds, fileNames: message.fileNames });
+    }
+    return queued.length;
+}
+/** A notice (plan 08 §8.1): kvcoder's own display-only message, shown as `kvcoder.notices.<code>`. */
+export function appendNotice(tx, session, code, params = {}, turnId = null) {
+    appendMessage(tx, session, { kind: 'notice', content: { code, params }, turnId });
+}
+const zero = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0 };
+/** No usage yet. */
+export const noUsage = () => ({ ...zero });
+export function addUsage(first, second) {
+    return { input: first.input + second.input, output: first.output + second.output, cacheRead: first.cacheRead + second.cacheRead, cacheWrite: first.cacheWrite + second.cacheWrite, cost: first.cost + second.cost };
+}
+//# sourceMappingURL=history.js.map

package/dist/turns/history.js.map

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

package/dist/turns/lost-reply.d.ts

@@ -0,0 +1,31 @@
+/** The most automatic retries of a lost reply in one turn. */
+export declare const lostRetries = 2;
+export type ReplyBlock = {
+    type: string;
+    text?: string;
+    thinking?: string;
+};
+/** The output tokens of a reply that its visible text and its reasoning don't explain. */
+export declare function unaccountedTokens(blocks: readonly ReplyBlock[], usage: {
+    output: number;
+    reasoning?: number | undefined;
+}): number;
+/** The unaccounted tokens of a reply with no call that was lost, or `undefined` for a reply that was not. */
+export declare function lostTokens(blocks: readonly ReplyBlock[], usage: {
+    output: number;
+    reasoning?: number | undefined;
+}): number | undefined;
+/** What the model is told about its lost reply. */
+export declare function lostHint(tokens: number): string;
+type CallBlock = {
+    type: string;
+    id?: string;
+    name?: string;
+};
+/** A reply's blocks with a call that has a name but no id given one, and a call with no name dropped and counted (ADR 0009, 192). */
+export declare function repairedCalls<Block extends CallBlock>(blocks: readonly Block[]): {
+    blocks: Block[];
+    broken: number;
+};
+export {};
+//# sourceMappingURL=lost-reply.d.ts.map

package/dist/turns/lost-reply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lost-reply.d.ts","sourceRoot":"","sources":["../../src/turns/lost-reply.ts"],"names":[],"mappings":"AAMA,8DAA8D;AAC9D,eAAO,MAAM,WAAW,IAAI,CAAC;AAO7B,MAAM,MAAM,UAAU,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAI5E,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,EAAE,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG,MAAM,CAGlI;AAED,6GAA6G;AAC7G,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,EAAE,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAIvI;AAED,mDAAmD;AACnD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED,KAAK,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D,qIAAqI;AACrI,wBAAgB,aAAa,CAAC,KAAK,SAAS,SAAS,EAAE,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG;IAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CASpH"}

package/dist/turns/lost-reply.js

@@ -0,0 +1,43 @@
+import { randomUUID } from 'node:crypto';
+// A model reply that was lost on the way (plan 08 §8.2, ADR 0009, 188, 191, and 192): a provider can generate a tool call and
+// never deliver it, so the reply holds no call and little text, yet its output tokens are more than the text and the
+// reasoning explain. What is left over is the call that never came.
+/** The most automatic retries of a lost reply in one turn. */
+export const lostRetries = 2;
+const unaccountedLimit = 150;
+const shortTextLimit = 400;
+// Arabic runs near 2.2 characters a token and English near 4, so counting 2 never makes a visible reply look lost.
+const charactersPerToken = 2;
+const characters = (blocks, type) => blocks.reduce((total, block) => total + (block.type === type ? (block.text ?? block.thinking ?? '').length : 0), 0);
+/** The output tokens of a reply that its visible text and its reasoning don't explain. */
+export function unaccountedTokens(blocks, usage) {
+    const reasoning = usage.reasoning !== undefined && usage.reasoning > 0 ? usage.reasoning : Math.ceil(characters(blocks, 'thinking') / charactersPerToken);
+    return usage.output - reasoning - Math.ceil(characters(blocks, 'text') / charactersPerToken);
+}
+/** The unaccounted tokens of a reply with no call that was lost, or `undefined` for a reply that was not. */
+export function lostTokens(blocks, usage) {
+    if (blocks.some((block) => block.type === 'toolCall'))
+        return undefined;
+    const unaccounted = unaccountedTokens(blocks, usage);
+    return characters(blocks, 'text') < shortTextLimit && unaccounted > unaccountedLimit ? unaccounted : undefined;
+}
+/** What the model is told about its lost reply. */
+export function lostHint(tokens) {
+    const about = Math.round(tokens / 100) * 100;
+    return `Your last reply was lost on the way: the provider produced about ${String(about)} tokens, but no tool call or text reached me. Send it again now, calling the tool directly. If it was a large file, send the content in smaller pieces: one file per reply, under about 150 lines each, with \`fs write\`.`;
+}
+/** A reply's blocks with a call that has a name but no id given one, and a call with no name dropped and counted (ADR 0009, 192). */
+export function repairedCalls(blocks) {
+    const kept = [];
+    let broken = 0;
+    for (const block of blocks) {
+        if (block.type !== 'toolCall')
+            kept.push(block);
+        else if (block.name === undefined || block.name === '')
+            broken += 1;
+        else
+            kept.push(block.id === undefined || block.id === '' ? Object.assign({}, block, { id: `call_${randomUUID()}` }) : block);
+    }
+    return { blocks: kept, broken };
+}
+//# sourceMappingURL=lost-reply.js.map

package/dist/turns/lost-reply.js.map

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

package/dist/turns/message-blocks.d.ts

@@ -0,0 +1,9 @@
+import type { Ctx, Stored } from '@kvman/sdk';
+import type { MessageDoc } from '../schemas/records.ts';
+/** The messages from `fromSeq` on, in order. */
+export declare function messagesFrom(ctx: Ctx, sessionId: string, fromSeq: number, nextSeq: number): Promise<Stored<MessageDoc>[]>;
+/** The newest `limit` messages, in order. */
+export declare function newestMessages(ctx: Ctx, sessionId: string, limit: number, nextSeq: number): Promise<Stored<MessageDoc>[]>;
+/** The latest summary, if the session has one. */
+export declare function latestSummary(ctx: Ctx, sessionId: string): Promise<Stored<MessageDoc> | undefined>;
+//# sourceMappingURL=message-blocks.d.ts.map

package/dist/turns/message-blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-blocks.d.ts","sourceRoot":"","sources":["../../src/turns/message-blocks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAUxD,gDAAgD;AAChD,wBAAsB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAI/H;AAED,6CAA6C;AAC7C,wBAAsB,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAI/H;AAED,kDAAkD;AAClD,wBAAsB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC,CAExG"}

package/dist/turns/message-blocks.js

@@ -0,0 +1,25 @@
+import { records } from "../store/collections.js";
+import { blockOf } from "./history.js";
+// Reading a session's history by blocks of `seq`, in order.
+async function block(ctx, sessionId, index) {
+    return (await records(ctx.store).messages.find({ sessionId, block: index }, { limit: 1000 })).sort((first, second) => first.seq - second.seq);
+}
+/** The messages from `fromSeq` on, in order. */
+export async function messagesFrom(ctx, sessionId, fromSeq, nextSeq) {
+    const found = [];
+    for (let index = blockOf(fromSeq); index <= blockOf(Math.max(nextSeq - 1, 0)); index += 1)
+        found.push(...(await block(ctx, sessionId, index)).filter((message) => message.seq >= fromSeq && message.seq < nextSeq));
+    return found;
+}
+/** The newest `limit` messages, in order. */
+export async function newestMessages(ctx, sessionId, limit, nextSeq) {
+    const found = [];
+    for (let index = blockOf(Math.max(nextSeq - 1, 0)); index >= 0 && found.length < limit; index -= 1)
+        found.unshift(...(await block(ctx, sessionId, index)));
+    return found.slice(Math.max(found.length - limit, 0));
+}
+/** The latest summary, if the session has one. */
+export async function latestSummary(ctx, sessionId) {
+    return (await records(ctx.store).messages.find({ sessionId, kind: 'summary' }, { limit: 1, order: 'desc' }))[0];
+}
+//# sourceMappingURL=message-blocks.js.map

package/dist/turns/message-blocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-blocks.js","sourceRoot":"","sources":["../../src/turns/message-blocks.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,4DAA4D;AAE5D,KAAK,UAAU,KAAK,CAAC,GAAQ,EAAE,SAAiB,EAAE,KAAa;IAC7D,OAAO,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;AAChJ,CAAC;AAED,gDAAgD;AAChD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAQ,EAAE,SAAiB,EAAE,OAAe,EAAE,OAAe;IAC9F,MAAM,KAAK,GAAyB,EAAE,CAAC;IACvC,KAAK,IAAI,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,IAAI,OAAO,CAAC,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IACpN,OAAO,KAAK,CAAC;AACf,CAAC;AAED,6CAA6C;AAC7C,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAQ,EAAE,SAAiB,EAAE,KAAa,EAAE,OAAe;IAC9F,MAAM,KAAK,GAAyB,EAAE,CAAC;IACvC,KAAK,IAAI,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,KAAK,EAAE,KAAK,IAAI,CAAC;QAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3J,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,kDAAkD;AAClD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAQ,EAAE,SAAiB;IAC7D,OAAO,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClH,CAAC"}

package/dist/turns/model-context.d.ts

@@ -0,0 +1,81 @@
+import { type Ctx, type Json, type Stored } from '@kvman/sdk';
+import type { MessageDoc } from '../schemas/records.ts';
+export type History = {
+    summary: Stored<MessageDoc> | undefined;
+    messages: Stored<MessageDoc>[];
+};
+/** The summary and the model-visible messages after it. */
+export declare function sentHistory(ctx: Ctx, sessionId: string, nextSeq: number): Promise<History>;
+/** A message's text: a string, or its text blocks joined. */
+export declare function textOf(content: Json | undefined): string;
+/** The messages a step sends, checked as kvai takes them. */
+export declare function modelMessages(ctx: Ctx, history: History): Promise<({
+    role: "user";
+    content: string | ({
+        type: "text";
+        text: string;
+        textSignature?: string;
+    } | {
+        type: "image";
+        data: string;
+        mimeType: string;
+    })[];
+    timestamp: number;
+} | {
+    stopReason: "error" | "length" | "stop" | "toolUse" | "aborted";
+    role: "assistant";
+    content: ({
+        type: "text";
+        text: string;
+        textSignature?: string;
+    } | {
+        type: "thinking";
+        thinking: string;
+        thinkingSignature?: string;
+        redacted?: boolean;
+    } | {
+        type: "toolCall";
+        id: string;
+        name: string;
+        arguments: Record<string, import("zod").JSONType>;
+        thoughtSignature?: string;
+    })[];
+    api: string;
+    provider: string;
+    model: string;
+    usage: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+        totalTokens: number;
+        cost: {
+            input: number;
+            output: number;
+            cacheRead: number;
+            cacheWrite: number;
+            total: number;
+        };
+        cacheWrite1h?: number;
+        reasoning?: number;
+    };
+    timestamp: number;
+    responseId?: string;
+} | {
+    role: "toolResult";
+    toolCallId: string;
+    toolName: string;
+    content: ({
+        type: "text";
+        text: string;
+        textSignature?: string;
+    } | {
+        type: "image";
+        data: string;
+        mimeType: string;
+    })[];
+    isError: boolean;
+    timestamp: number;
+    details?: import("zod").JSONType;
+})[]>;
+//# sourceMappingURL=model-context.d.ts.map

package/dist/turns/model-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-context.d.ts","sourceRoot":"","sources":["../../src/turns/model-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,GAAG,EAAE,KAAK,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAE5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAMxD,MAAM,MAAM,OAAO,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE,CAAA;CAAE,CAAC;AAIlG,2DAA2D;AAC3D,wBAAsB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAKhG;AAED,6DAA6D;AAC7D,wBAAgB,MAAM,CAAC,OAAO,EAAE,IAAI,GAAG,SAAS,GAAG,MAAM,CAMxD;AAoBD,6DAA6D;AAC7D,wBAAsB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAI7D"}

package/dist/turns/model-context.js

@@ -0,0 +1,46 @@
+import { ProblemError } from '@kvman/sdk';
+import { messageSchema } from '@kvman/kvai/messages';
+import { latestSummary, messagesFrom } from "./message-blocks.js";
+const sent = new Set(['user', 'assistant', 'toolResult']);
+/** The summary and the model-visible messages after it. */
+export async function sentHistory(ctx, sessionId, nextSeq) {
+    const summary = await latestSummary(ctx, sessionId);
+    const from = summary === undefined ? 0 : Number(summary.content['coversThroughSeq'] ?? -1) + 1;
+    const messages = (await messagesFrom(ctx, sessionId, from, nextSeq)).filter((message) => sent.has(message.kind));
+    return { summary, messages };
+}
+/** A message's text: a string, or its text blocks joined. */
+export function textOf(content) {
+    if (typeof content === 'string')
+        return content;
+    if (!Array.isArray(content))
+        return '';
+    return content
+        .flatMap((block) => (typeof block === 'object' && block !== null && !Array.isArray(block) && block['type'] === 'text' && typeof block['text'] === 'string' ? [block['text']] : []))
+        .join('\n');
+}
+async function imageBlock(ctx, fileId, name) {
+    try {
+        const file = await ctx.files.get(fileId);
+        return { type: 'image', data: (await ctx.files.read(fileId)).toString('base64'), mimeType: file.type };
+    }
+    catch (error) {
+        if (error instanceof ProblemError && error.problem.code === 'NOT_FOUND')
+            return { type: 'text', text: `[image ${name} was deleted]` };
+        throw error;
+    }
+}
+async function userMessage(ctx, message) {
+    if (message.fileIds === null || message.fileIds.length === 0)
+        return message.content;
+    const images = await Promise.all(message.fileIds.map((fileId, index) => imageBlock(ctx, fileId, message.fileNames?.[index] ?? fileId)));
+    return { ...message.content, content: [{ type: 'text', text: textOf(message.content['content']) }, ...images] };
+}
+const summaryLead = 'A summary of the earlier conversation:';
+/** The messages a step sends, checked as kvai takes them. */
+export async function modelMessages(ctx, history) {
+    const lead = history.summary === undefined ? [] : [{ role: 'user', content: `${summaryLead}\n${String(history.summary.content['text'] ?? '')}`, timestamp: Date.parse(history.summary.createdAt) }];
+    const rest = await Promise.all(history.messages.map((message) => (message.kind === 'user' ? userMessage(ctx, message) : Promise.resolve(message.content))));
+    return messageSchema.array().parse([...lead, ...rest]);
+}
+//# sourceMappingURL=model-context.js.map

package/dist/turns/model-context.js.map

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

package/dist/turns/model-info.d.ts

@@ -0,0 +1,7 @@
+import type { Ctx } from '@kvman/sdk';
+export type ModelInfo = {
+    contextWindow: number;
+    images: boolean;
+};
+export declare function modelInfo(ctx: Ctx, model: string | null): Promise<ModelInfo | undefined>;
+//# sourceMappingURL=model-info.d.ts.map

package/dist/turns/model-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-info.d.ts","sourceRoot":"","sources":["../../src/turns/model-info.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAKtC,MAAM,MAAM,SAAS,GAAG;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAEnE,wBAAsB,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAM9F"}

package/dist/turns/model-info.js

@@ -0,0 +1,10 @@
+export async function modelInfo(ctx, model) {
+    if (model === null)
+        return undefined;
+    const provider = model.slice(0, model.indexOf('/'));
+    if (provider === '')
+        return undefined;
+    const found = (await ctx.exec('kvai.model.list', { provider })).find((candidate) => candidate.id === model);
+    return found === undefined ? undefined : { contextWindow: found.contextWindow, images: found.input.includes('image') };
+}
+//# sourceMappingURL=model-info.js.map

package/dist/turns/model-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-info.js","sourceRoot":"","sources":["../../src/turns/model-info.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAQ,EAAE,KAAoB;IAC5D,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACtC,MAAM,KAAK,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC;IAC5G,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;AACzH,CAAC"}

package/dist/turns/model-retry.d.ts

@@ -0,0 +1,3 @@
+import { type Ctx, type InputOf, type OutputOf } from '@kvman/sdk';
+export declare function completeWithRetries(ctx: Ctx, input: InputOf<'kvai.complete'>): Promise<OutputOf<'kvai.complete'>>;
+//# sourceMappingURL=model-retry.d.ts.map

package/dist/turns/model-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-retry.d.ts","sourceRoot":"","sources":["../../src/turns/model-retry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,GAAG,EAAE,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAWjF,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAavH"}

package/dist/turns/model-retry.js

@@ -0,0 +1,23 @@
+import { ProblemError } from '@kvman/sdk';
+import { delay } from "../delay.js";
+// A step's model call, tried again when it fails for a temporary reason (plan 08 §8.2, ADR 0009, 154, 155, and 203):
+// four tries in all, after 1 s, 4 s, and then 15 s. Any other failure, and a stop, end it at once.
+const waitsMs = [1_000, 4_000, 15_000];
+const transient = (error) => error.problem.code === 'kvai/RATE_LIMITED' || (error.problem.code === 'kvai/PROVIDER_ERROR' && error.problem.params?.['transient'] === true);
+export async function completeWithRetries(ctx, input) {
+    for (let attempt = 1;; attempt += 1) {
+        try {
+            return await ctx.exec('kvai.complete', input);
+        }
+        catch (error) {
+            const wait = waitsMs[attempt - 1];
+            if (!(error instanceof ProblemError) || !transient(error) || wait === undefined || ctx.job.signal.aborted)
+                throw error;
+            ctx.log.warn('A model call failed for a temporary reason; trying again.', { code: error.problem.code, attempt });
+            ctx.job.progress({ type: 'retry', attempt: attempt + 1, of: waitsMs.length + 1 });
+            await delay(wait, ctx.job.signal);
+            ctx.job.signal.throwIfAborted();
+        }
+    }
+}
+//# sourceMappingURL=model-retry.js.map

package/dist/turns/model-retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-retry.js","sourceRoot":"","sources":["../../src/turns/model-retry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAyC,MAAM,YAAY,CAAC;AAEjF,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,qHAAqH;AACrH,mGAAmG;AAEnG,MAAM,OAAO,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAU,CAAC;AAEhD,MAAM,SAAS,GAAG,CAAC,KAAmB,EAAW,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,mBAAmB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,KAAK,qBAAqB,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC,CAAC;AAEjM,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAQ,EAAE,KAA+B;IACjF,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,IAAI,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,OAAO,MAAM,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;YAClC,IAAI,CAAC,CAAC,KAAK,YAAY,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO;gBAAE,MAAM,KAAK,CAAC;YACvH,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,2DAA2D,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YACjH,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAC;YAClF,MAAM,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAClC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAClC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/turns/register-interruptions.d.ts

@@ -0,0 +1,3 @@
+import type { Ctx } from '@kvman/sdk';
+export declare function registerInterruptions(ctx: Ctx): void;
+//# sourceMappingURL=register-interruptions.d.ts.map

package/dist/turns/register-interruptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-interruptions.d.ts","sourceRoot":"","sources":["../../src/turns/register-interruptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAetC,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAcpD"}