@aui.io/apollo 0.1.91 → 0.1.93

package/node_modules/@aui.io/apollo-core/dist/src/output/index.d.ts

@@ -8,6 +8,11 @@ export interface OutputOptions {
 export interface SuccessEnvelope {
     success: true;
     data: unknown;
+    /** Where a keyset listing continues (`thread list`). Additive, like `update`. */
+    page?: {
+        has_next: boolean;
+        next_cursor?: string | null;
+    };
     /** A newer console is published. Additive: absent unless one is known,
      *  so consumers that never look for it see the envelope they always did. */
     update?: UpdateNotice;
@@ -25,7 +30,7 @@ export interface ErrorEnvelope {
      *  "upgrade", so the notice rides the error envelope too. */
     update?: UpdateNotice;
 }
-export declare function successEnvelope(data: unknown, update?: UpdateNotice): SuccessEnvelope;
+export declare function successEnvelope(data: unknown, update?: UpdateNotice, page?: SuccessEnvelope["page"]): SuccessEnvelope;
 export declare function errorEnvelope(error: CliError, update?: UpdateNotice): ErrorEnvelope;
 /** A user as people are named: "you" for `me`, else their email, else "someone" — never an id. */
 export declare function personName(id: string | null | undefined, email: string | null | undefined, me: string | undefined): string;
@@ -40,7 +45,11 @@ export declare class Output {
      *  `upgrade` command does that, being the update surface itself. */
     setUpdateNotice(update: UpdateNotice | undefined): void;
     get updateNotice(): UpdateNotice | undefined;
-    result(data: unknown, renderHuman: (value: unknown) => string): void;
+    result(data: unknown, renderHuman: (value: unknown) => string, extra?: {
+        page?: SuccessEnvelope["page"];
+    }): void;
+    /** One JSON line straight to stdout — a frame of a streamed result (`--events`). */
+    jsonLine(value: unknown): void;
     error(error: CliError): void;
     /** A non-fatal caution — the command went through, but something the user
      *  should know about did not hold. Stderr in every mode (stdout stays the

package/node_modules/@aui.io/apollo-core/dist/src/output/index.js

@@ -1,6 +1,6 @@
 import pc from "picocolors";
-export function successEnvelope(data, update) {
-    return { success: true, data, ...(update === undefined ? {} : { update }) };
+export function successEnvelope(data, update, page) {
+    return { success: true, data, ...(page === undefined ? {} : { page }), ...(update === undefined ? {} : { update }) };
 }
 export function errorEnvelope(error, update) {
     return {
@@ -46,12 +46,16 @@ export class Output {
     get updateNotice() {
         return this.update;
     }
-    result(data, renderHuman) {
+    result(data, renderHuman, extra = {}) {
         const value = this.options.json
-            ? JSON.stringify(successEnvelope(data, this.update))
+            ? JSON.stringify(successEnvelope(data, this.update, extra.page))
             : renderHuman(data);
         this.stdout.write(`${value}\n`);
     }
+    /** One JSON line straight to stdout — a frame of a streamed result (`--events`). */
+    jsonLine(value) {
+        this.stdout.write(`${JSON.stringify(value)}\n`);
+    }
     error(error) {
         const value = this.options.json
             ? JSON.stringify(errorEnvelope(error, this.update))

package/node_modules/@aui.io/apollo-core/dist/src/output/index.js.map

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

package/node_modules/@aui.io/apollo-core/dist/src/output/trace-lines.d.ts

@@ -0,0 +1,28 @@
+/**
+ * One readable line per trace entry — what a live view prints while a turn
+ * streams, and what `chat --trace` prints after it. The words are the trace's
+ * own (the engine streams the same sections the sealed trace holds); this
+ * only picks the fields a reader recognizes and keeps each line short.
+ */
+/** The plain word each streamed trace section reads as. */
+export declare const TRACE_SECTION_LABELS: Readonly<Record<string, string>>;
+/**
+ * The turn's outcome fields a summary names after its steps. Each is set only
+ * on the turns a test exists to catch — a policy refused, a capability was
+ * blocked, a change waits on the caller's go-ahead, the engine failed — and
+ * empty on an ordinary turn.
+ */
+export declare const TURN_OUTCOME_LABELS: Readonly<Record<string, string>>;
+export declare function traceSectionLabel(section: string): string;
+/** One outcome line of a sealed trace: which field, what it says, and whether it is a failure. */
+export interface TurnOutcomeLine {
+    field: string;
+    text: string;
+    failed: boolean;
+}
+/** A sealed trace's outcome lines, in reading order — none on an ordinary turn. */
+export declare function describeTurnOutcome(sealed: Record<string, unknown>): TurnOutcomeLine[];
+/** One entry of one section, as a single line. */
+export declare function describeTraceEntry(section: string, entry: unknown): string;
+/** A value on one line, at most MAX_VALUE_CHARS long. */
+export declare function short(value: unknown): string;

package/node_modules/@aui.io/apollo-core/dist/src/output/trace-lines.js

@@ -0,0 +1,140 @@
+/**
+ * One readable line per trace entry — what a live view prints while a turn
+ * streams, and what `chat --trace` prints after it. The words are the trace's
+ * own (the engine streams the same sections the sealed trace holds); this
+ * only picks the fields a reader recognizes and keeps each line short.
+ */
+/** The plain word each streamed trace section reads as. */
+export const TRACE_SECTION_LABELS = {
+    understood: "understood",
+    intents: "intent",
+    asking: "asking",
+    ambiguous: "unclear",
+    confirmations: "confirming",
+    needed_first: "needs first",
+    plan: "plan",
+    still_owed: "still owed",
+    decided: "decided",
+    computed: "computed",
+    sources: "looked up",
+    learned: "learned",
+    did: "did",
+    wrote: "wrote",
+    transitioned: "moved to",
+    checks: "checked",
+};
+/**
+ * The turn's outcome fields a summary names after its steps. Each is set only
+ * on the turns a test exists to catch — a policy refused, a capability was
+ * blocked, a change waits on the caller's go-ahead, the engine failed — and
+ * empty on an ordinary turn.
+ */
+export const TURN_OUTCOME_LABELS = {
+    refused_by: "refused by",
+    blocked: "blocked",
+    awaiting_authorisation: "waiting on",
+    error: "error",
+};
+const MAX_VALUE_CHARS = 80;
+export function traceSectionLabel(section) {
+    return TRACE_SECTION_LABELS[section] ?? TURN_OUTCOME_LABELS[section] ?? section.replaceAll("_", " ");
+}
+/** A sealed trace's outcome lines, in reading order — none on an ordinary turn. */
+export function describeTurnOutcome(sealed) {
+    const lines = [];
+    if (typeof sealed.refused_by === "string" && sealed.refused_by) {
+        lines.push({ field: "refused_by", text: sealed.refused_by, failed: false });
+    }
+    if (sealed.blocked !== null && typeof sealed.blocked === "object") {
+        const blocked = sealed.blocked;
+        const what = typeof blocked.capability === "string" && blocked.capability ? blocked.capability : "?";
+        const kind = typeof blocked.class === "string" && blocked.class ? ` (${blocked.class})` : "";
+        const because = blocked.because ? ` — ${short(blocked.because)}` : "";
+        lines.push({ field: "blocked", text: `${what}${kind}${because}`, failed: false });
+    }
+    if (typeof sealed.awaiting_authorisation === "string" && sealed.awaiting_authorisation) {
+        lines.push({ field: "awaiting_authorisation", text: `your go-ahead for ${sealed.awaiting_authorisation}`, failed: false });
+    }
+    if (typeof sealed.error === "string" && sealed.error) {
+        lines.push({ field: "error", text: short(sealed.error), failed: true });
+    }
+    return lines;
+}
+/** One entry of one section, as a single line. */
+export function describeTraceEntry(section, entry) {
+    if (typeof entry === "string")
+        return entry;
+    if (entry === null || typeof entry !== "object")
+        return short(entry);
+    const e = entry;
+    switch (section) {
+        case "understood":
+        case "learned":
+            return `${name(e, ["fact", "name"])} = ${short(e.value)}`;
+        case "computed":
+            return `${name(e, ["fact", "name"])} = ${short(e.output ?? e.value)}`;
+        case "intents":
+            return `${name(e, ["capability", "intent", "name"])}${e.outcome ? ` (${text(e.outcome)})` : ""}`;
+        case "checks":
+            return `${e.passed === false ? "✗" : "✓"} ${name(e, ["check", "name"])}${e.note ? ` — ${short(e.note)}` : ""}`;
+        case "sources":
+            return `${name(e, ["source", "name"])}${askedFor(e.asked_for)}${rows(e)}`;
+        case "transitioned":
+            return name(e, ["to", "state", "name"]);
+        default:
+            return named(e);
+    }
+}
+function askedFor(value) {
+    if (value === null || typeof value !== "object")
+        return "";
+    const pairs = Object.entries(value).map(([key, v]) => `${key}=${short(v)}`);
+    return pairs.length ? ` (${pairs.join(", ")})` : "";
+}
+function rows(e) {
+    const count = Array.isArray(e.rows) ? e.rows.length : typeof e.row_count === "number" ? e.row_count : undefined;
+    return count === undefined ? "" : ` → ${count} row${count === 1 ? "" : "s"}`;
+}
+/** The first field a reader would name the entry by, else a compact preview. */
+function named(e) {
+    for (const key of ["capability", "policy", "situation", "fact", "source", "name", "id", "title", "text", "summary"]) {
+        const value = e[key];
+        if (typeof value === "string" && value) {
+            const outcome = e.outcome ?? e.status ?? e.value;
+            return outcome === undefined || outcome === null || outcome === "" ? value : `${value} (${short(outcome)})`;
+        }
+    }
+    return short(e);
+}
+function name(e, keys) {
+    for (const key of keys) {
+        const value = e[key];
+        if (typeof value === "string" && value)
+            return value;
+    }
+    return "?";
+}
+function text(value) {
+    return typeof value === "string" ? value : short(value);
+}
+/** A value on one line, at most MAX_VALUE_CHARS long. */
+export function short(value) {
+    let rendered;
+    if (typeof value === "string")
+        rendered = value;
+    else if (value === undefined)
+        rendered = "";
+    else if (typeof value === "function" || typeof value === "symbol")
+        rendered = typeof value;
+    else {
+        try {
+            rendered = JSON.stringify(value);
+        }
+        catch {
+            rendered = "(unprintable)";
+        }
+    }
+    rendered = rendered.replace(/\s+/g, " ").trim();
+    return rendered.length > MAX_VALUE_CHARS ? `${rendered.slice(0, MAX_VALUE_CHARS - 1)}…` : rendered;
+}
+//# sourceMappingURL=trace-lines.js.map

package/node_modules/@aui.io/apollo-core/dist/src/output/trace-lines.js.map

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

package/node_modules/@aui.io/apollo-core/dist/src/services/chat-script.d.ts

@@ -0,0 +1,39 @@
+import type { Message } from "../api/runtime-api.js";
+/** The most turns one scripted conversation sends — from stdin (`chat -`) or a file (`chat --script`). */
+export declare const MAX_SCRIPT_TURNS = 200;
+/**
+ * What one turn must show, read off the sealed trace that rides its reply.
+ * Every key is optional; those given must all hold.
+ */
+export interface TurnExpectation {
+    /** Capabilities that ran (each of them), or "none" for a turn that ran none. */
+    did?: string[] | "none";
+    /** Capabilities the agent took as the caller's intent (each of them). */
+    intent?: string[];
+    /** The policy that refused the turn, or "none" for a turn nothing refused. */
+    refused_by?: string;
+    /** "pass": every check on the turn passed. */
+    checks?: "pass";
+    /** Phrases the reply contains, ignoring case. */
+    says?: string[];
+    /** Phrases the reply never contains, ignoring case. */
+    not_says?: string[];
+}
+export interface ScriptTurn {
+    message: string;
+    expect?: TurnExpectation;
+}
+export interface ExpectationResult {
+    /** The expectation as written: `did answer-rates`. */
+    expect: string;
+    met: boolean;
+    /** What the turn showed instead, when it was not met. */
+    got?: string;
+}
+export declare const EXPECTATION_KEYS: readonly ["did", "intent", "refused_by", "checks", "says", "not_says"];
+/** A conversation script from a YAML (or JSON) file. */
+export declare function loadChatScript(path: string): Promise<ScriptTurn[]>;
+/** Turns from a parsed script: `{turns: [...]}` or the list itself; a turn is `message` plus an optional `expect`. */
+export declare function parseChatScript(document: unknown, source?: string): ScriptTurn[];
+/** Each expectation of a turn against what its reply and sealed trace show. */
+export declare function checkTurn(expectation: TurnExpectation, message: Message): ExpectationResult[];

package/node_modules/@aui.io/apollo-core/dist/src/services/chat-script.js

@@ -0,0 +1,150 @@
+import { readFile } from "node:fs/promises";
+import YAML from "yaml";
+import { ConfigError } from "../errors/index.js";
+/** The most turns one scripted conversation sends — from stdin (`chat -`) or a file (`chat --script`). */
+export const MAX_SCRIPT_TURNS = 200;
+export const EXPECTATION_KEYS = ["did", "intent", "refused_by", "checks", "says", "not_says"];
+const EXAMPLE = [
+    "turns:",
+    '  - message: "How much is an e-bike for the day?"',
+    "    expect: { did: answer-rates, checks: pass }",
+    '  - message: "Can you recommend a restaurant?"',
+    "    expect: { did: none, says: only help with }",
+].join("\n");
+/** A conversation script from a YAML (or JSON) file. */
+export async function loadChatScript(path) {
+    let text;
+    try {
+        text = await readFile(path, "utf8");
+    }
+    catch (error) {
+        const reason = error instanceof Error && "code" in error && error.code === "ENOENT" ? "no such file" : "it could not be read";
+        throw new ConfigError(`Cannot read the script ${path}: ${reason}.`, "Pass the path of a YAML or JSON file of turns.");
+    }
+    let document;
+    try {
+        document = YAML.parse(text);
+    }
+    catch (error) {
+        throw new ConfigError(`${path} is not valid YAML or JSON: ${error instanceof Error ? error.message : String(error)}`, EXAMPLE);
+    }
+    return parseChatScript(document, path);
+}
+/** Turns from a parsed script: `{turns: [...]}` or the list itself; a turn is `message` plus an optional `expect`. */
+export function parseChatScript(document, source = "the script") {
+    const list = Array.isArray(document) ? document : isRecord(document) && Array.isArray(document.turns) ? document.turns : undefined;
+    if (list === undefined)
+        throw new ConfigError(`${source} needs a \`turns:\` list.`, EXAMPLE);
+    if (list.length === 0)
+        throw new ConfigError(`${source} has no turns.`, EXAMPLE);
+    if (list.length > MAX_SCRIPT_TURNS) {
+        throw new ConfigError(`${source} has ${list.length} turns; one run sends at most ${MAX_SCRIPT_TURNS}.`, "Split it, and continue the conversation with --thread <id>.");
+    }
+    return list.map((raw, index) => parseTurn(raw, `${source}, turn ${index + 1}`));
+}
+function parseTurn(raw, where) {
+    if (typeof raw === "string" && raw.trim())
+        return { message: raw.trim() };
+    if (!isRecord(raw))
+        throw new ConfigError(`${where}: a turn is a \`message\` with an optional \`expect\`.`, EXAMPLE);
+    const extra = Object.keys(raw).find((key) => key !== "message" && key !== "expect");
+    if (extra !== undefined)
+        throw new ConfigError(`${where}: unknown key \`${extra}\` — a turn takes \`message\` and \`expect\`.`);
+    const message = typeof raw.message === "string" ? raw.message.trim() : "";
+    if (!message)
+        throw new ConfigError(`${where}: \`message\` is missing or empty.`);
+    return raw.expect === undefined || raw.expect === null ? { message } : { message, expect: parseExpectation(raw.expect, where) };
+}
+function parseExpectation(raw, where) {
+    if (!isRecord(raw))
+        throw new ConfigError(`${where}: \`expect\` is a mapping, such as { did: answer-hours, checks: pass }.`);
+    const expectation = {};
+    for (const [key, value] of Object.entries(raw)) {
+        switch (key) {
+            case "did":
+                // `[]` reads as it is written: no capability ran.
+                expectation.did = value === "none" || (Array.isArray(value) && value.length === 0) ? "none" : names(value, `${where}, did`);
+                break;
+            case "intent":
+                expectation.intent = names(value, `${where}, intent`);
+                break;
+            case "refused_by":
+                expectation.refused_by = names(value, `${where}, refused_by`, 1)[0];
+                break;
+            case "checks":
+                if (value !== "pass")
+                    throw new ConfigError(`${where}: \`checks\` takes \`pass\`.`);
+                expectation.checks = "pass";
+                break;
+            case "says":
+                expectation.says = names(value, `${where}, says`);
+                break;
+            case "not_says":
+                expectation.not_says = names(value, `${where}, not_says`);
+                break;
+            default:
+                throw new ConfigError(`${where}: unknown expectation \`${key}\`.`, `An expectation is one of: ${EXPECTATION_KEYS.join(", ")}.`);
+        }
+    }
+    if (Object.keys(expectation).length === 0)
+        throw new ConfigError(`${where}: \`expect\` is empty.`);
+    return expectation;
+}
+/** One name or a list of names, none empty. */
+function names(value, where, most) {
+    const list = Array.isArray(value) ? value : [value];
+    const ok = list.length > 0 && list.every((item) => typeof item === "string" && item.trim() !== "");
+    if (!ok || (most !== undefined && list.length > most)) {
+        throw new ConfigError(`${where}: takes ${most === 1 ? "one name" : "a name or a list of names"}.`);
+    }
+    return list.map((item) => item.trim());
+}
+/** Each expectation of a turn against what its reply and sealed trace show. */
+export function checkTurn(expectation, message) {
+    const trace = message.trace_info ?? undefined;
+    const results = [];
+    const did = strings(trace?.did);
+    if (expectation.did === "none")
+        results.push(outcome("did none", did.length === 0, `did ${did.join(", ")}`));
+    for (const capability of expectation.did === "none" ? [] : (expectation.did ?? [])) {
+        results.push(outcome(`did ${capability}`, did.includes(capability), did.length ? `did ${did.join(", ")}` : "did nothing"));
+    }
+    const intents = capabilities(trace?.intents);
+    for (const capability of expectation.intent ?? []) {
+        results.push(outcome(`intent ${capability}`, intents.includes(capability), intents.length ? `intent ${intents.join(", ")}` : "no intent"));
+    }
+    if (expectation.refused_by !== undefined) {
+        const refused = typeof trace?.refused_by === "string" && trace.refused_by ? trace.refused_by : undefined;
+        const met = expectation.refused_by === "none" ? refused === undefined : refused === expectation.refused_by;
+        results.push(outcome(`refused_by ${expectation.refused_by}`, met, refused ? `refused by ${refused}` : "nothing refused it"));
+    }
+    if (expectation.checks === "pass") {
+        const checks = Array.isArray(trace?.checks) ? trace.checks : undefined;
+        const failed = (checks ?? []).filter((check) => isRecord(check) && check.passed === false);
+        const named = failed.map((check) => (isRecord(check) && typeof check.check === "string" ? check.check : "?"));
+        results.push(outcome("checks pass", checks !== undefined && failed.length === 0, checks === undefined ? "no checks came back" : `failed: ${named.join("; ")}`));
+    }
+    const text = (message.text ?? "").toLowerCase();
+    for (const phrase of expectation.says ?? []) {
+        results.push(outcome(`says "${phrase}"`, text.includes(phrase.toLowerCase()), "not in the reply"));
+    }
+    for (const phrase of expectation.not_says ?? []) {
+        results.push(outcome(`never says "${phrase}"`, !text.includes(phrase.toLowerCase()), "it is in the reply"));
+    }
+    return results;
+}
+function outcome(expect, met, got) {
+    return met ? { expect, met } : { expect, met, got };
+}
+function strings(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+function capabilities(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.flatMap((entry) => (isRecord(entry) && typeof entry.capability === "string" ? [entry.capability] : []));
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=chat-script.js.map

package/node_modules/@aui.io/apollo-core/dist/src/services/chat-script.js.map

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

package/node_modules/@aui.io/apollo-core/dist/src/services/clients.js

@@ -3,6 +3,7 @@ import { AgentSettingsClient } from "../api/agent-settings.js";
 import { BuilderApiClient } from "../api/builder-api.js";
 import { CloneClient } from "../api/clone.js";
 import { IdentityClient } from "../api/identity.js";
+import { jwtExpiresAt } from "../api/jwt.js";
 import { KbmClient } from "../api/kbm.js";
 import { ManagementClient } from "../api/management.js";
 import { RuntimeApiClient } from "../api/runtime-api.js";
@@ -12,16 +13,8 @@ import { readCredentials, writeCredentials, } from "../config/index.js";
 import { AuthError } from "../errors/index.js";
 import { RUNTIME_VERSION_HEADER, runtimeRouteResolver, } from "../runtime-version/index.js";
 function expiry(token) {
-    try {
-        const payload = token.split(".")[1];
-        if (!payload)
-            return undefined;
-        const claims = JSON.parse(Buffer.from(payload, "base64url").toString("utf8"));
-        return claims.exp ? new Date(claims.exp * 1_000).toISOString() : undefined;
-    }
-    catch {
-        return undefined;
-    }
+    const exp = jwtExpiresAt(token);
+    return exp ? new Date(exp * 1_000).toISOString() : undefined;
 }
 export function createClients(context, options = {}) {
     const homeDir = options.homeDir ?? homedir();

package/node_modules/@aui.io/apollo-core/dist/src/services/clients.js.map

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

package/node_modules/@aui.io/apollo-core/dist/src/services/messaging.d.ts

@@ -1,5 +1,5 @@
 import { type ManagementClient } from "../api/management.js";
-import type { Message, RuntimeApiClient, RuntimeTrace, SendMessageResponse, Thread } from "../api/runtime-api.js";
+import type { AgentThreadFilters, ChatStreamEvent, Message, RuntimeApiClient, RuntimeTrace, SendMessageResponse, Thread, ThreadPage } from "../api/runtime-api.js";
 import type { Context } from "../config/index.js";
 import { type ThreadCommitHints } from "../errors/index.js";
 export declare function parseVariables(values?: string[]): Record<string, unknown>;
@@ -15,14 +15,39 @@ export declare function resolveThreadVersion(context: Context, clients: {
     management: ManagementClient;
     runtime: RuntimeApiClient;
 }, threadId: string, hints: ThreadCommitHints, at?: string): Promise<SendVersion>;
-export declare function sendMessage(context: Context, runtime: RuntimeApiClient, input: {
+export interface SendInput {
     text: string;
     threadId?: string;
     version?: SendVersion;
     variables?: string[];
     localDir?: string;
     includeTrace?: boolean;
-}): Promise<SendMessageResponse>;
+}
+export declare function sendMessage(context: Context, runtime: RuntimeApiClient, input: SendInput): Promise<SendMessageResponse>;
+/** How long a turn waits, after its reply, for the late follow-up suggestions. */
+export declare const SUGGESTIONS_WAIT_MS = 15000;
+export interface ChatTurnOptions {
+    /** Stream the turn (the default); `false` sends the blocking request. */
+    stream?: boolean;
+    /** Stops the turn (Ctrl+C). The runtime may still finish it on the thread. */
+    signal?: AbortSignal;
+    /** Every frame as it arrives — what a live view draws. */
+    onEvent?: (event: ChatStreamEvent) => void;
+    /** The stream route was not there, so the turn was sent as one request. */
+    onFallback?: (reason: string) => void;
+    /** How long to wait after the reply for the late follow-up suggestions;
+     *  `0` returns the moment the reply lands, as a blocking send does. */
+    suggestionsWaitMs?: number;
+}
+/**
+ * One turn, streamed: the same request and the same result as `sendMessage`
+ * (`{thread_id, message}`), with every frame handed to `onEvent` as the
+ * engine works. Late follow-up suggestions fill the message's own
+ * `followup_suggestions` when they arrive within `suggestionsWaitMs` of the
+ * reply. A runtime without the stream route (404/405) gets the blocking
+ * request instead, so streaming never costs a turn.
+ */
+export declare function chatTurn(context: Context, runtime: RuntimeApiClient, input: SendInput, options?: ChatTurnOptions): Promise<SendMessageResponse>;
 export declare function createThread(context: Context, runtime: RuntimeApiClient, version?: SendVersion): Promise<Thread>;
 export declare function getThread(runtime: RuntimeApiClient, threadId: string): Promise<Thread>;
 export declare function listThreads(context: Context, runtime: RuntimeApiClient, options?: {
@@ -40,5 +65,16 @@ export declare function listAgentThreads(context: Context, runtime: RuntimeApiCl
     after?: string;
     before?: string;
 }): Promise<Thread[]>;
+/**
+ * One page of conversations for `thread list`: the checkout's agent (the
+ * signed-in user's own, unless `everyone`), or — outside a checkout, or with
+ * `allAgents` — the user's threads across every agent.
+ */
+export declare function threadPage(context: Context, runtime: RuntimeApiClient, options?: Omit<AgentThreadFilters, "userId"> & {
+    everyone?: boolean;
+    allAgents?: boolean;
+}): Promise<ThreadPage & {
+    scope: "agent" | "user";
+}>;
 export declare function listMessages(runtime: RuntimeApiClient, threadId: string): Promise<Message[]>;
 export declare function trace(runtime: RuntimeApiClient, threadId: string, interactionId?: string): Promise<RuntimeTrace | RuntimeTrace[]>;