@framers/agentos 0.12.13 → 0.12.14

package/dist/api/runtime/gmiSession.js

@@ -0,0 +1,285 @@
+/**
+ * @file gmiSession.ts
+ * One agent session served by one GMI (`agent({ runtime: 'gmi' })`, spec D10).
+ *
+ * The session store is the source of truth: before every turn the GMI's history
+ * is replaced with the store's messages, and as the turn runs each finished
+ * model step is written to the store through a turn writer; a turn that fails
+ * after some steps keeps them, marked partial. One turn runs at a time per
+ * session. Each step's usage goes to the usage ledger with the provider and
+ * model that served it.
+ */
+import { randomUUID } from 'node:crypto';
+import { GMIInteractionType, GMIOutputChunkType, } from '../../cognition/substrate/IGMI.js';
+import { addModelUsage, extractTextFromContent } from '../generateText.js';
+import { ObjectGenerationError } from '../generateObject.js';
+import { DEFAULT_MEMORY_TOKEN_BUDGET, MEMORY_TIMEOUT_MS } from './memoryProviderHooks.js';
+import { GmiTurnFolder, streamFromGmiTurn } from './gmiResults.js';
+import { stepToTranscript, transcriptToConversation } from './gmiTranscript.js';
+/** Serialises turns: `acquire()` resolves with a release function once every earlier holder released. */
+export class TurnLock {
+    constructor() {
+        this.tail = Promise.resolve();
+    }
+    acquire() {
+        let release;
+        const held = new Promise((resolve) => {
+            release = resolve;
+        });
+        const previous = this.tail;
+        this.tail = previous.then(() => held);
+        return previous.then(() => release);
+    }
+}
+/** `memoryProvider.getContext` for the turn, within its timeout; undefined when there is none or it fails. */
+async function memoryProviderContext(opts, userText) {
+    const provider = opts.memoryProvider;
+    if (!provider?.getContext)
+        return undefined;
+    const timeoutMs = opts.memoryProviderOptions?.timeoutMs ?? MEMORY_TIMEOUT_MS;
+    const tokenBudget = opts.memoryProviderOptions?.tokenBudget ?? DEFAULT_MEMORY_TOKEN_BUDGET;
+    let timer;
+    let timedOut = false;
+    try {
+        const result = await Promise.race([
+            provider.getContext(userText, { tokenBudget }),
+            new Promise((resolve) => {
+                timer = setTimeout(() => {
+                    timedOut = true;
+                    resolve(null);
+                }, timeoutMs);
+            }),
+        ]);
+        if (timedOut)
+            console.warn(`[agentos] memoryProvider.getContext exceeded ${timeoutMs}ms; continuing without memory context.`);
+        return result?.contextText || undefined;
+    }
+    catch (error) {
+        console.warn('[agentos] memoryProvider.getContext failed; continuing without memory context.', error);
+        return undefined;
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+/** One usage ledger event; a ledger failure is never the caller's error. */
+function recordLedgerUsage(ledger, providerId, modelId, usage) {
+    if (!usage || typeof usage !== 'object')
+        return;
+    const total = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
+    addModelUsage(total, usage);
+    // Imported on use, as agent() imports it: the ledger reads and writes files.
+    void import('./usageLedger.js')
+        .then(({ recordAgentOSUsage }) => recordAgentOSUsage({ providerId, modelId, usage: total, options: ledger }))
+        .catch(() => undefined);
+}
+/** `onAfterGeneration` for one finished step: a returned text replaces the step's text in the result and in the store. */
+async function afterGeneration(opts, folder, step, calls) {
+    if (!opts.onAfterGeneration)
+        return;
+    const usage = { promptTokens: 0, completionTokens: 0, totalTokens: 0 };
+    addModelUsage(usage, step.usage);
+    try {
+        const modified = await opts.onAfterGeneration({
+            text: folder.stepText(step),
+            toolCalls: calls.map((call) => ({ name: call.name, args: call.arguments })),
+            usage,
+            step: step.stepIndex,
+            ...(step.cacheDiagnostics !== undefined ? { cacheDiagnostics: step.cacheDiagnostics } : {}),
+        });
+        // A schema answer stays the JSON the schema validated.
+        if (modified && typeof modified.text === 'string' && step.structuredOutput === undefined) {
+            folder.overrideStepText(step.stepIndex, modified.text);
+        }
+    }
+    catch (hookError) {
+        console.warn('[agentos] onAfterGeneration hook error:', hookError);
+    }
+}
+/**
+ * Runs one GMI turn and yields its chunks, pushing each into `folder`, writing
+ * each finished step to the session store and each step's usage to the ledger.
+ * The caller folds the chunks (send) or streams them (stream).
+ *
+ * The turn reads the store's epoch and messages the moment it holds the lock,
+ * before it waits for its GMI or its memory context, so a clear or reseed during
+ * those waits makes the turn's writes no-ops, as an in-flight legacy send's are.
+ *
+ * @returns The messages the turn added to the store (or would have, with no history).
+ */
+export async function* runGmiTurn(deps, input, turn, folder) {
+    const release = await deps.lock.acquire();
+    const recorded = [];
+    let writer;
+    let ended = false;
+    let releaseGmi;
+    const userMessage = { role: 'user', content: input };
+    let pending;
+    // Writes the last finished step once its tool results are in.
+    const flush = () => {
+        if (!pending)
+            return;
+        const messages = stepToTranscript({
+            step: pending.step,
+            calls: pending.calls,
+            results: pending.results,
+            userMessage: pending.first ? userMessage : undefined,
+            textOverride: folder.stepText(pending.step),
+        });
+        if (!writer || writer.appendStep(messages))
+            recorded.push(...messages);
+        pending = undefined;
+    };
+    try {
+        // What the turn starts from, read together before any wait.
+        const epochAtStart = deps.history?.epoch();
+        const priorMessages = deps.history ? deps.history.messages() : [];
+        const userText = typeof input === 'string' ? input : extractTextFromContent(input);
+        const served = await deps.gmiFor();
+        releaseGmi = served.release;
+        const gmi = served.gmi;
+        gmi.replaceHistory?.(transcriptToConversation(priorMessages));
+        const memoryContext = deps.useMemoryProviderContext ? await memoryProviderContext(deps.opts, userText) : undefined;
+        served.prepare?.({ prompt: typeof input === 'string' ? input : undefined, memoryContext });
+        writer = deps.history?.beginTurn(turn.blockLabel, epochAtStart);
+        const turnInput = {
+            interactionId: `turn-${randomUUID()}`,
+            userId: deps.userId,
+            sessionId: deps.sessionId,
+            type: typeof input === 'string' ? GMIInteractionType.TEXT : GMIInteractionType.MULTIMODAL_CONTENT,
+            content: input,
+            metadata: {
+                options: {
+                    ...(turn.options ?? {}),
+                    ...(turn.responseSchema ? { responseSchema: turn.responseSchema, schemaName: turn.schemaName ?? 'response' } : {}),
+                },
+            },
+        };
+        let stepCalls = [];
+        let firstStep = true;
+        for await (const chunk of gmi.processTurnStream(turnInput)) {
+            folder.push(chunk);
+            switch (chunk.type) {
+                case GMIOutputChunkType.TOOL_CALL_REQUEST:
+                    stepCalls.push(...(chunk.content ?? []));
+                    break;
+                case GMIOutputChunkType.STEP_FINISHED: {
+                    flush();
+                    const step = chunk.content;
+                    await afterGeneration(deps.opts, folder, step, stepCalls);
+                    pending = { step, calls: stepCalls, results: [], first: firstStep };
+                    stepCalls = [];
+                    firstStep = false;
+                    recordLedgerUsage(deps.ledger, step.providerId, step.modelId, step.usage);
+                    break;
+                }
+                case GMIOutputChunkType.TOOL_RESULT:
+                    pending?.results.push(chunk.content);
+                    break;
+                case GMIOutputChunkType.USAGE_UPDATE: {
+                    // An attempt that failed before any output and was billed: no step carries it.
+                    const meta = chunk.metadata;
+                    if (meta?.attemptFailed)
+                        recordLedgerUsage(deps.ledger, meta.providerId, meta.modelId, chunk.content);
+                    break;
+                }
+                default:
+                    break;
+            }
+            yield chunk;
+        }
+        flush();
+        ended = true;
+        if (folder.error()) {
+            writer?.abort({ partial: true });
+        }
+        else {
+            writer?.commit();
+            const observe = deps.opts.memoryProvider?.observe;
+            if (observe) {
+                void observe('user', userText).catch(() => undefined);
+                const reply = folder.text();
+                if (reply)
+                    void observe('assistant', reply).catch(() => undefined);
+            }
+        }
+        return recorded;
+    }
+    catch (error) {
+        folder.fail(error);
+        flush();
+        ended = true;
+        writer?.abort({ partial: true });
+        throw error;
+    }
+    finally {
+        // A turn its consumer stopped reading keeps the steps that finished, marked partial.
+        if (!ended) {
+            flush();
+            writer?.abort({ partial: true });
+        }
+        const usage = folder.usage();
+        if (usage.totalTokens > 0 || usage.promptTokens > 0 || usage.completionTokens > 0)
+            deps.onUsage(usage);
+        if (releaseGmi)
+            void releaseGmi().catch(() => undefined);
+        release();
+    }
+}
+/** Parses a structured send's answer: the schema tool's arguments when a step carried them, else the reply text. */
+function parseStructured(folder, result, schema) {
+    const structured = folder.structuredOutput();
+    let raw = structured;
+    if (structured === undefined || typeof structured === 'string') {
+        const source = typeof structured === 'string' ? structured : result.text;
+        try {
+            raw = JSON.parse(source);
+        }
+        catch (err) {
+            throw new ObjectGenerationError(`session.send: provider response is not valid JSON despite enforcement (${err instanceof Error ? err.message : String(err)})`, source);
+        }
+    }
+    const safe = schema.safeParse(raw);
+    if (!safe.success) {
+        throw new ObjectGenerationError('session.send: provider-enforced JSON failed Zod validation', result.text, safe.error);
+    }
+    return safe.data;
+}
+/**
+ * `send()`: the whole turn, folded into a `GenerateTextResult` (with `object`
+ * when a schema was given). Rejects with the GMI's error, its code kept, when
+ * the turn failed; an error thrown before the turn ran (no provider or model
+ * resolves, the memory cannot be built) is rethrown as it was thrown.
+ */
+export async function sendGmiTurn(deps, input, turn) {
+    const folder = new GmiTurnFolder();
+    const run = runGmiTurn(deps, input, turn, folder);
+    let recorded = [];
+    for (;;) {
+        const next = await run.next();
+        if (next.done) {
+            recorded = next.value;
+            break;
+        }
+    }
+    const error = folder.toError();
+    if (error)
+        throw error;
+    const result = folder.toGenerateTextResult(recorded);
+    if (!turn.responseSchema)
+        return result;
+    return { ...result, object: parseStructured(folder, result, turn.responseSchema) };
+}
+/**
+ * `stream()`: the turn's chunks as a `StreamTextResult`. The promises settle
+ * after the turn is written to the session store, so a caller that awaits
+ * `text` and sends again finds the turn in the history.
+ */
+export function streamGmiTurn(deps, input, turn) {
+    const folder = new GmiTurnFolder();
+    const run = runGmiTurn(deps, input, turn, folder);
+    // runGmiTurn pushes every chunk into `folder` (with the onAfterGeneration replacements); the stream reads that folder.
+    return streamFromGmiTurn({ [Symbol.asyncIterator]: () => run }, { folder });
+}
+//# sourceMappingURL=gmiSession.js.map

package/dist/api/runtime/gmiSession.js.map

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

package/dist/api/runtime/gmiTranscript.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @file gmiTranscript.ts
+ * Conversions between the session store's transcript and a GMI's conversation
+ * history (`agent({ runtime: 'gmi' })`). Before every turn the GMI's history is
+ * replaced with the store's messages; as each model step finishes, the messages
+ * it adds are written to the store.
+ *
+ * A step is stored as the GMI put it in its own history (the assistant message
+ * with its tool calls and thinking blocks, then each tool result in the GMI's
+ * wording), so the next turn replays the bytes the provider already saw and a
+ * cached prompt prefix stays valid.
+ */
+import { type ConversationMessage } from '../../core/conversation/ConversationMessage.js';
+import type { StepFinishedChunkPayload, ToolCallRequest, ToolResultChunkPayload } from '../../cognition/substrate/IGMI.js';
+import { type SessionTranscriptMessage } from '../sessionTranscript.js';
+/**
+ * The store's messages as GMI conversation history: roles, tool calls with
+ * parsed arguments and Gemini thought signatures, tool-result ids, and thinking
+ * blocks (a caller-built signed `thinking` entry becomes a block, as a replay to
+ * the provider makes it). The `partial` marker is left out.
+ *
+ * @param messages - The session store's messages, oldest first.
+ * @returns History for `IGMI.replaceHistory`.
+ */
+export declare function transcriptToConversation(messages: readonly SessionTranscriptMessage[]): ConversationMessage[];
+/** One finished model step and what the turn produced around it. */
+export interface StepTranscriptInput {
+    step: StepFinishedChunkPayload;
+    /** The tool calls the step requested, in order. */
+    calls: ToolCallRequest[];
+    /** The step's tool results, in order. */
+    results: ToolResultChunkPayload[];
+    /** The turn's user message, given on the turn's first step. */
+    userMessage?: SessionTranscriptMessage;
+    /** `onAfterGeneration`'s replacement for the step text. */
+    textOverride?: string;
+}
+/**
+ * The store messages one finished step adds: the turn's user message on the
+ * first step, the assistant message (left out when the step produced neither
+ * text nor tool calls), then one tool message per result. A step that answered
+ * a response schema is stored as the JSON string of its answer.
+ *
+ * @param input - The step, its calls and results, and the turn's user message on the first step.
+ * @returns The messages to append through the turn writer.
+ */
+export declare function stepToTranscript(input: StepTranscriptInput): SessionTranscriptMessage[];
+//# sourceMappingURL=gmiTranscript.d.ts.map

package/dist/api/runtime/gmiTranscript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gmiTranscript.d.ts","sourceRoot":"","sources":["../../../src/api/runtime/gmiTranscript.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAA0C,KAAK,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AAElI,OAAO,KAAK,EAAE,wBAAwB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3H,OAAO,EAA2B,KAAK,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAsBjG;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,SAAS,wBAAwB,EAAE,GAAG,mBAAmB,EAAE,CAsB7G;AAED,oEAAoE;AACpE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,mDAAmD;IACnD,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,yCAAyC;IACzC,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,+DAA+D;IAC/D,WAAW,CAAC,EAAE,wBAAwB,CAAC;IACvC,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAUD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,mBAAmB,GAAG,wBAAwB,EAAE,CAuBvF"}

package/dist/api/runtime/gmiTranscript.js

@@ -0,0 +1,110 @@
+/**
+ * @file gmiTranscript.ts
+ * Conversions between the session store's transcript and a GMI's conversation
+ * history (`agent({ runtime: 'gmi' })`). Before every turn the GMI's history is
+ * replaced with the store's messages; as each model step finishes, the messages
+ * it adds are written to the store.
+ *
+ * A step is stored as the GMI put it in its own history (the assistant message
+ * with its tool calls and thinking blocks, then each tool result in the GMI's
+ * wording), so the next turn replays the bytes the provider already saw and a
+ * cached prompt prefix stays valid.
+ */
+import { createConversationMessage, MessageRole } from '../../core/conversation/ConversationMessage.js';
+import { toProviderReplayMessage } from '../sessionTranscript.js';
+/** A tool call's JSON arguments as an object; a non-object or unparsable value is kept under `value` or `raw`. */
+function parseArguments(raw) {
+    try {
+        const parsed = JSON.parse(raw);
+        return parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)
+            ? parsed
+            : { value: parsed };
+    }
+    catch {
+        return { raw };
+    }
+}
+/** Message content a GMI history entry can hold: text, parts, or null; anything else as its JSON. */
+function conversationContent(content) {
+    if (content === null || content === undefined)
+        return null;
+    if (typeof content === 'string')
+        return content;
+    if (Array.isArray(content))
+        return content;
+    return JSON.stringify(content);
+}
+/**
+ * The store's messages as GMI conversation history: roles, tool calls with
+ * parsed arguments and Gemini thought signatures, tool-result ids, and thinking
+ * blocks (a caller-built signed `thinking` entry becomes a block, as a replay to
+ * the provider makes it). The `partial` marker is left out.
+ *
+ * @param messages - The session store's messages, oldest first.
+ * @returns History for `IGMI.replaceHistory`.
+ */
+export function transcriptToConversation(messages) {
+    return messages.map((message) => {
+        if (message.role === 'user') {
+            return createConversationMessage(MessageRole.USER, conversationContent(message.content) ?? '');
+        }
+        if (message.role === 'tool') {
+            return createConversationMessage(MessageRole.TOOL, message.content, { tool_call_id: message.tool_call_id });
+        }
+        const replay = toProviderReplayMessage(message);
+        const toolCalls = message.tool_calls?.length
+            ? message.tool_calls.map((tc) => ({
+                id: tc.id,
+                name: tc.function.name,
+                arguments: parseArguments(tc.function.arguments),
+                ...(tc.thoughtSignature ? { thoughtSignature: tc.thoughtSignature } : {}),
+            }))
+            : undefined;
+        return createConversationMessage(MessageRole.ASSISTANT, conversationContent(message.content), {
+            ...(toolCalls ? { tool_calls: toolCalls } : {}),
+            ...(replay.thinkingBlocks?.length ? { thinkingBlocks: replay.thinkingBlocks } : {}),
+        });
+    });
+}
+/** A tool result's content, worded as the GMI words it in its own history (`ConversationHistoryManager.updateWithToolResult`). */
+function toolContent(result) {
+    if (result.isError) {
+        return `Error from tool '${result.name}': ${JSON.stringify(result.errorDetails || result.result)}`;
+    }
+    return typeof result.result === 'string' ? result.result : (JSON.stringify(result.result) ?? '');
+}
+/**
+ * The store messages one finished step adds: the turn's user message on the
+ * first step, the assistant message (left out when the step produced neither
+ * text nor tool calls), then one tool message per result. A step that answered
+ * a response schema is stored as the JSON string of its answer.
+ *
+ * @param input - The step, its calls and results, and the turn's user message on the first step.
+ * @returns The messages to append through the turn writer.
+ */
+export function stepToTranscript(input) {
+    const { step, calls, results, userMessage, textOverride } = input;
+    const text = step.structuredOutput !== undefined ? JSON.stringify(step.structuredOutput) : (textOverride ?? step.text);
+    const out = userMessage ? [userMessage] : [];
+    if (calls.length > 0 || text) {
+        out.push({
+            role: 'assistant',
+            content: text || null,
+            ...(calls.length > 0
+                ? {
+                    tool_calls: calls.map((tc) => ({
+                        id: tc.id,
+                        type: 'function',
+                        function: { name: tc.name, arguments: JSON.stringify(tc.arguments ?? {}) },
+                        ...(tc.thoughtSignature ? { thoughtSignature: tc.thoughtSignature } : {}),
+                    })),
+                }
+                : {}),
+            ...(step.thinkingBlocks?.length ? { thinkingBlocks: step.thinkingBlocks } : {}),
+        });
+    }
+    for (const result of results)
+        out.push({ role: 'tool', tool_call_id: result.toolCallId, content: toolContent(result) });
+    return out;
+}
+//# sourceMappingURL=gmiTranscript.js.map

package/dist/api/runtime/gmiTranscript.js.map

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

package/dist/api/runtime/lightweightAgentDiagnostics.d.ts

@@ -1,5 +1,10 @@
 import type { BaseAgentConfig } from '../types.js';
-import { type CapabilityKey } from './capabilityContract.js';
+import { type CapabilityKey, type CapabilitySurface } from './capabilityContract.js';
+/**
+ * The config fields that are set but that `surface` accepts without enforcing
+ * (`accepted_but_deferred` in {@link BASE_AGENT_CONFIG_CAPABILITY_CONTRACT}).
+ */
+export declare function getDeferredCapabilities(config: Partial<BaseAgentConfig>, surface: CapabilitySurface): CapabilityKey[];
 export declare function getDeferredLightweightAgentCapabilities(config: Partial<BaseAgentConfig>): CapabilityKey[];
 export declare function warnOnDeferredLightweightAgentCapabilities(config: Partial<BaseAgentConfig>, warn?: (message: string) => void): CapabilityKey[];
 //# sourceMappingURL=lightweightAgentDiagnostics.d.ts.map

package/dist/api/runtime/lightweightAgentDiagnostics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lightweightAgentDiagnostics.d.ts","sourceRoot":"","sources":["../../../src/api/runtime/lightweightAgentDiagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAGL,KAAK,aAAa,EACnB,MAAM,yBAAyB,CAAC;AAiBjC,wBAAgB,uCAAuC,CACrD,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAC/B,aAAa,EAAE,CAKjB;AAED,wBAAgB,0CAA0C,CACxD,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,EAChC,IAAI,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAmB,GAC7C,aAAa,EAAE,CAYjB"}
+{"version":3,"file":"lightweightAgentDiagnostics.d.ts","sourceRoot":"","sources":["../../../src/api/runtime/lightweightAgentDiagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACvB,MAAM,yBAAyB,CAAC;AAiBjC;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,EAChC,OAAO,EAAE,iBAAiB,GACzB,aAAa,EAAE,CAKjB;AAED,wBAAgB,uCAAuC,CACrD,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAC/B,aAAa,EAAE,CAEjB;AAED,wBAAgB,0CAA0C,CACxD,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,EAChC,IAAI,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAmB,GAC7C,aAAa,EAAE,CAYjB"}

package/dist/api/runtime/lightweightAgentDiagnostics.js

@@ -19,10 +19,17 @@ function isMeaningfullyConfigured(value) {
     }
     return true;
 }
-export function getDeferredLightweightAgentCapabilities(config) {
-    return CAPABILITY_KEYS.filter((key) => BASE_AGENT_CONFIG_CAPABILITY_CONTRACT[key].agent === 'accepted_but_deferred'
+/**
+ * The config fields that are set but that `surface` accepts without enforcing
+ * (`accepted_but_deferred` in {@link BASE_AGENT_CONFIG_CAPABILITY_CONTRACT}).
+ */
+export function getDeferredCapabilities(config, surface) {
+    return CAPABILITY_KEYS.filter((key) => BASE_AGENT_CONFIG_CAPABILITY_CONTRACT[key][surface] === 'accepted_but_deferred'
         && isMeaningfullyConfigured(config[key]));
 }
+export function getDeferredLightweightAgentCapabilities(config) {
+    return getDeferredCapabilities(config, 'agent');
+}
 export function warnOnDeferredLightweightAgentCapabilities(config, warn = console.warn) {
     const deferredCapabilities = getDeferredLightweightAgentCapabilities(config);
     if (deferredCapabilities.length === 0) {

package/dist/api/runtime/lightweightAgentDiagnostics.js.map

@@ -1 +1 @@
-{"version":3,"file":"lightweightAgentDiagnostics.js","sourceRoot":"","sources":["../../../src/api/runtime/lightweightAgentDiagnostics.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,qCAAqC,EACrC,eAAe,GAEhB,MAAM,yBAAyB,CAAC;AAEjC,SAAS,wBAAwB,CAAC,KAAc;IAC9C,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IAChC,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC;IACxF,IAAI,KAAK,YAAY,GAAG,IAAI,KAAK,YAAY,GAAG;QAAE,OAAO,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;IACxE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC;QAC3F,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACvC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,SAAS,IAAI,wBAAwB,CAAC,UAAU,CAAC,CAAC;eAChG,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,uCAAuC,CACrD,MAAgC;IAEhC,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CACpC,qCAAqC,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,uBAAuB;WACzE,wBAAwB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CACzC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0CAA0C,CACxD,MAAgC,EAChC,OAAkC,OAAO,CAAC,IAAI;IAE9C,MAAM,oBAAoB,GAAG,uCAAuC,CAAC,MAAM,CAAC,CAAC;IAC7E,IAAI,oBAAoB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED,IAAI,CACF,yFAAyF,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;UACxH,qGAAqG,CAC1G,CAAC;IAEF,OAAO,oBAAoB,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"lightweightAgentDiagnostics.js","sourceRoot":"","sources":["../../../src/api/runtime/lightweightAgentDiagnostics.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,qCAAqC,EACrC,eAAe,GAGhB,MAAM,yBAAyB,CAAC;AAEjC,SAAS,wBAAwB,CAAC,KAAc;IAC9C,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IAChC,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;IAC9D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC;IACxF,IAAI,KAAK,YAAY,GAAG,IAAI,KAAK,YAAY,GAAG;QAAE,OAAO,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;IACxE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC;QAC3F,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACvC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,SAAS,IAAI,wBAAwB,CAAC,UAAU,CAAC,CAAC;eAChG,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,MAAgC,EAChC,OAA0B;IAE1B,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CACpC,qCAAqC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,uBAAuB;WAC5E,wBAAwB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CACzC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uCAAuC,CACrD,MAAgC;IAEhC,OAAO,uBAAuB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,0CAA0C,CACxD,MAAgC,EAChC,OAAkC,OAAO,CAAC,IAAI;IAE9C,MAAM,oBAAoB,GAAG,uCAAuC,CAAC,MAAM,CAAC,CAAC;IAC7E,IAAI,oBAAoB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED,IAAI,CACF,yFAAyF,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;UACxH,qGAAqG,CAC1G,CAAC;IAEF,OAAO,oBAAoB,CAAC;AAC9B,CAAC"}

package/dist/api/sessionHistory.d.ts

@@ -21,13 +21,42 @@ export type HistoryEvent = {
     type: 'stale-append-discarded';
     label?: string;
 };
+/**
+ * One in-flight turn on the GMI path (`agent({ runtime: 'gmi' })`). The turn's
+ * model steps accumulate and land as ONE block, so eviction keeps or drops the
+ * whole turn and never separates a tool call from its result.
+ */
+export interface SessionTurnWriter {
+    /**
+     * Adds one model step's messages: the user message first on the turn's first
+     * step, then the assistant message and its tool results. Returns false, and
+     * adds nothing, when the step leaves a tool call unanswered or the writer is
+     * closed.
+     */
+    appendStep(messages: SessionTranscriptMessage[]): boolean;
+    /**
+     * Stores the turn as one block and runs eviction. Returns false when no step
+     * was appended, the writer is already closed, or the history was reseeded
+     * (or cleared) after the turn began.
+     */
+    commit(): boolean;
+    /**
+     * Ends a failed turn. With `partial: true` the steps that completed are
+     * stored, the block's last message marked `partial`; otherwise nothing is
+     * stored. Returns whether a block was stored.
+     */
+    abort(options?: {
+        partial?: boolean;
+    }): boolean;
+}
 /**
  * Session conversation state: whole-send blocks, chunk-amortized eviction,
  * epoch-guarded mutation (spec §1c/§1d). Pure state machine — no I/O, no
  * provider coupling — so eviction semantics are testable byte-for-byte.
  *
  * Eviction shape: one contiguous OLDEST chunk per event, whole blocks only
- * (a block is one send's complete delta, so tool_use never separates from
+ * (a block is one send's complete delta, or one GMI turn written through
+ * {@link SessionHistoryBuffer.beginTurn}, so tool_use never separates from
  * its tool_result), amortizing the cache re-pay to one write per event.
  * Byte-stability is an invariant of THIS stored serialization; the final
  * wire request may still diverge under dynamic memory-context injection
@@ -52,6 +81,19 @@ export declare class SessionHistoryBuffer {
      * is dropped (spec §1d).
      */
     appendSendDelta(delta: SessionTranscriptMessage[], label?: string, expectEpoch?: number): boolean;
+    /**
+     * Starts a turn whose steps land as one block (GMI path). The turn is tied
+     * to the current epoch: a reseed or clear while it runs discards it at
+     * commit, as {@link appendSendDelta} discards a stale send. Eviction runs
+     * at commit only, so a turn's earlier steps can never be evicted while its
+     * later steps are still being written.
+     *
+     * @param label - Telemetry and eviction-boundary label for the turn's block.
+     * @param expectEpoch - The epoch the turn started under, when it read the
+     *   history before calling this (default: the current epoch). A reseed or
+     *   clear between that read and this call makes the turn's commit a no-op.
+     */
+    beginTurn(label?: string, expectEpoch?: number): SessionTurnWriter;
     /** Atomic replace + epoch bump. Throws on pairing-invalid snapshots. */
     reseed(snapshot: SessionTranscriptMessage[]): void;
     /** Returns accumulated telemetry events and clears the queue. */

package/dist/api/sessionHistory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sessionHistory.d.ts","sourceRoot":"","sources":["../../src/api/sessionHistory.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,wBAAwB,CAAC;AAEhC,yFAAyF;AACzF,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,eAAe,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,wBAAwB,EAAE,oBAItC,CAAC;AAEF,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACtF;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAQvD;;;;;;;;;;;GAWG;AACH,qBAAa,oBAAoB;IAKnB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAJhC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,MAAM,CAAsB;gBAEP,GAAG,EAAE,oBAAoB;IAEtD,KAAK,IAAI,MAAM;IAIf,sEAAsE;IACtE,QAAQ,IAAI,wBAAwB,EAAE;IAItC,UAAU,IAAI,MAAM;IAIpB,WAAW,IAAI,MAAM;IAIrB;;;;;;OAMG;IACH,eAAe,CACb,KAAK,EAAE,wBAAwB,EAAE,EACjC,KAAK,CAAC,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO;IAcV,wEAAwE;IACxE,MAAM,CAAC,QAAQ,EAAE,wBAAwB,EAAE,GAAG,IAAI;IAUlD,iEAAiE;IACjE,kBAAkB,IAAI,YAAY,EAAE;IAMpC,OAAO,CAAC,aAAa;CAetB"}
+{"version":3,"file":"sessionHistory.d.ts","sourceRoot":"","sources":["../../src/api/sessionHistory.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,wBAAwB,CAAC;AAEhC,yFAAyF;AACzF,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,eAAe,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,wBAAwB,EAAE,oBAItC,CAAC;AAEF,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACtF;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,wBAAwB,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAQvD;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;OAKG;IACH,UAAU,CAAC,QAAQ,EAAE,wBAAwB,EAAE,GAAG,OAAO,CAAC;IAC1D;;;;OAIG;IACH,MAAM,IAAI,OAAO,CAAC;IAClB;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC;CACjD;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,oBAAoB;IAKnB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAJhC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,MAAM,CAAsB;gBAEP,GAAG,EAAE,oBAAoB;IAEtD,KAAK,IAAI,MAAM;IAIf,sEAAsE;IACtE,QAAQ,IAAI,wBAAwB,EAAE;IAItC,UAAU,IAAI,MAAM;IAIpB,WAAW,IAAI,MAAM;IAIrB;;;;;;OAMG;IACH,eAAe,CACb,KAAK,EAAE,wBAAwB,EAAE,EACjC,KAAK,CAAC,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO;IAcV;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,iBAAiB;IAqClE,wEAAwE;IACxE,MAAM,CAAC,QAAQ,EAAE,wBAAwB,EAAE,GAAG,IAAI;IAUlD,iEAAiE;IACjE,kBAAkB,IAAI,YAAY,EAAE;IAMpC,OAAO,CAAC,aAAa;CAetB"}