@xenosystem/agent-interface-core 0.1.3

package/dist/reviewProjection.js

@@ -0,0 +1,133 @@
+/**
+ * What a review surface is allowed to SHOW — §2.9 and §5.7, as a projection.
+ *
+ * Pure, and in `core` rather than in a component, because every rule here is a
+ * statement about honesty rather than about layout, and the honesty is the part
+ * that must not depend on someone remembering it while writing JSX.
+ * `packages/ui` holds `toolCardProjection` for the same reason — a projection
+ * kept out of the component that renders it.
+ *
+ * ⚠️ This sentence used to say `core` holds it. It does not; it is in
+ * `packages/ui`. Corrected rather than left, because a wrong pointer in a
+ * doc comment sends the next reader to the wrong package.
+ *
+ * ## 🔴 The rule the whole module exists for
+ *
+ * **An incomplete diff must never be presented as a review.** §2.9's claim is
+ * that tier 1 yields a real diff; a diff that quietly omits changes is worse
+ * than no diff, because a reviewer reads "3 files changed" and approves. So an
+ * incomplete snapshot projects to a state a surface cannot render as an ordinary
+ * file list — not to a list with a warning beside it, which is a thing people
+ * learn to skip past.
+ *
+ * ## Unobserved is not empty
+ *
+ * "This run changed nothing" and "nobody was watching" produce the same zero
+ * changes and mean opposite things. They are separate states here, and the
+ * second is not a variant of the first.
+ */
+export function projectReview(snapshot, overlaps) {
+    if (!snapshot.available) {
+        return {
+            runId: snapshot.runId,
+            status: 'unobserved',
+            changes: [],
+            counts: { added: 0, modified: 0, deleted: 0, contested: 0 },
+            notice: snapshot.reason ?? 'This run is not being observed, so there is nothing to review.',
+            trustworthy: false,
+        };
+    }
+    // Contested paths come from the OVERLAP report rather than being recomputed:
+    // two implementations of "did these runs collide" is how the answers diverge.
+    const contested = new Set();
+    if (overlaps?.available) {
+        for (const overlap of overlaps.overlaps) {
+            if (overlap.runIds.includes(snapshot.runId))
+                contested.add(overlap.path);
+        }
+    }
+    const changes = snapshot.changes.map((change) => ({
+        path: change.path,
+        kind: change.kind,
+        ...(contested.has(change.path) ? { contested: true } : {}),
+    }));
+    const counts = {
+        added: changes.filter((change) => change.kind === 'added').length,
+        modified: changes.filter((change) => change.kind === 'modified').length,
+        deleted: changes.filter((change) => change.kind === 'deleted').length,
+        contested: changes.filter((change) => change.contested).length,
+    };
+    if (!snapshot.complete) {
+        return {
+            runId: snapshot.runId,
+            status: 'incomplete',
+            changes,
+            counts,
+            notice: incompleteNotice(snapshot),
+            // The load-bearing line. Everything else in this module is presentation;
+            // this is the claim a surface must not make on an incomplete diff.
+            trustworthy: false,
+        };
+    }
+    if (changes.length === 0) {
+        return {
+            runId: snapshot.runId,
+            status: 'clean',
+            changes: [],
+            counts,
+            notice: 'This run changed nothing in the observed directories.',
+            trustworthy: true,
+        };
+    }
+    return { runId: snapshot.runId, status: 'reviewable', changes, counts, trustworthy: true };
+}
+function incompleteNotice(snapshot) {
+    // Dropped events are the definitive incompleteness: those changes exist on
+    // disk and are absent from this diff forever. Said first, and with the number,
+    // because "some changes may be missing" is not actionable and "412 changes
+    // were missed" is.
+    if (snapshot.droppedEvents > 0) {
+        return `${snapshot.droppedEvents} change${snapshot.droppedEvents === 1 ? '' : 's'} were missed and are not in this diff. Do not treat it as the whole story.`;
+    }
+    const first = snapshot.problems[0];
+    return first
+        ? `This diff is incomplete: ${first}`
+        : 'This diff is known to be incomplete. Do not treat it as the whole story.';
+}
+export function projectLanding(input) {
+    if (!input.available) {
+        return {
+            rows: [],
+            couldLand: false,
+            notice: input.reason ?? 'This host has no landing queue, so nothing can be landed from here.',
+        };
+    }
+    const rows = input.entries.map((entry) => ({
+        runId: entry.runId,
+        state: entry.state,
+        ...(entry.position === undefined ? {} : { positionLabel: ordinal(entry.position) }),
+        ...(entry.reason === undefined ? {} : { reason: entry.reason }),
+        // A refused or failed run is actionable — a human can fix and requeue it.
+        // A landing one is not: interrupting it is what the single-slot rule exists
+        // to prevent.
+        actionable: entry.state === 'refused' || entry.state === 'failed' || entry.state === 'queued',
+    }));
+    const head = rows.find((row) => row.state === 'queued');
+    return {
+        rows,
+        ...(input.landing ? { landing: input.landing } : {}),
+        couldLand: Boolean(head) && !input.landing,
+        ...(input.landing
+            ? { notice: `${input.landing} is landing. One run lands at a time, so the verified combination is the one that lands.` }
+            : rows.length === 0
+                ? { notice: 'Nothing is waiting to land.' }
+                : {}),
+    };
+}
+function ordinal(position) {
+    const suffix = position % 100 >= 11 && position % 100 <= 13
+        ? 'th'
+        : ['th', 'st', 'nd', 'rd'][position % 10] ?? 'th';
+    return `${position}${suffix} in line`;
+}
+//# sourceMappingURL=reviewProjection.js.map

package/dist/reviewProjection.js.map

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

package/dist/runDiff.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Continuous diff against a run's baseline — ADE spec §2.9, tier 1.
+ *
+ * > "from the sandbox filesystem: every create, write and delete with
+ * >  before/after content; **a real diff against the run's baseline, computed
+ * >  continuously**; hunk-level review, which needs the changes and not the
+ * >  agent's narration."
+ *
+ * This is the engine behind the tier-1 review capability, and it is also §9b's
+ * fourth load component — the last one unmeasured, and the only one where the
+ * case for a Rust host could still be won, because it is the one that scales
+ * with repository size rather than with agent count.
+ *
+ * ## An event log is not a diff
+ *
+ * The whole difficulty is that the filesystem stream describes WHAT HAPPENED
+ * while a reviewer needs to know WHAT IS DIFFERENT. Those disagree constantly:
+ *
+ * - create then delete → **nothing changed**, not "added" followed by "deleted".
+ *   A diff listing the added file sends a reviewer to a path that does not
+ *   exist.
+ * - delete then create → **modified**, if the file was in the baseline. Reported
+ *   as "added" it implies the original is gone when it was replaced.
+ * - modify a file the baseline never had → **added**. It was created before the
+ *   watcher attached, or created and then written; either way "modified"
+ *   describes a prior version that never existed.
+ * - many writes → **one** modified entry. A reviewer counting events would read
+ *   an agent that saved often as an agent that changed more.
+ *
+ * Each of those is a case where replaying events verbatim produces a confident,
+ * wrong answer — which is worse than no diff, because a reviewer acts on it.
+ *
+ * ## Baseline membership, not content hashes
+ *
+ * The baseline is the set of paths that existed when the run started. Content
+ * hashing is deliberately out of scope here: it belongs where the bytes live
+ * (the sandbox), and pulling contents into this layer would make a pure,
+ * cheap state machine depend on I/O — the thing that makes it measurable for
+ * §9b in the first place.
+ */
+/** The tier-1 filesystem event, mirroring `xeno-use`'s shape.
+ *
+ * Redeclared rather than imported: this package is provider-neutral and must not
+ * depend on the isolation substrate. The three kinds are the substrate's whole
+ * vocabulary, so the coupling is a shape, not a dependency. */
+export type RunFileEventKind = 'created' | 'modified' | 'removed';
+export interface RunFileEvent {
+    kind: RunFileEventKind;
+    /** Container-relative path, as the sandbox reports it. */
+    path: string;
+}
+/** What is DIFFERENT, which is not what happened. */
+export type RunChangeKind = 'added' | 'modified' | 'deleted';
+export interface RunChange {
+    path: string;
+    kind: RunChangeKind;
+    /** How many filesystem events touched this path. Diagnostic only: a reviewer
+     *  must never read it as a measure of how much changed. */
+    events: number;
+}
+export interface RunDiffOptions {
+    /** Paths that existed when the run started. */
+    baseline?: Iterable<string>;
+}
+/**
+ * Folds a filesystem event stream into a net change set.
+ *
+ * Incremental by construction: each event is O(1), so the cost tracks the event
+ * rate rather than the repository size. That is the property §9b's fourth
+ * component needs measured, and it only holds while this stays a pure fold.
+ */
+export declare class RunDiff {
+    #private;
+    constructor(options?: RunDiffOptions);
+    apply(event: RunFileEvent): void;
+    applyAll(events: Iterable<RunFileEvent>): void;
+    /**
+     * The net change set, sorted by path so two runs over the same work produce
+     * identical output — a diff whose order varies is a diff that cannot be
+     * compared between runs.
+     */
+    changes(): RunChange[];
+    /** True when the run has changed nothing on disk. */
+    isClean(): boolean;
+}
+//# sourceMappingURL=runDiff.d.ts.map

package/dist/runDiff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runDiff.d.ts","sourceRoot":"","sources":["../src/runDiff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAEH;;;;+DAI+D;AAC/D,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAA;AAEjE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAA;IACtB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAA;CACb;AAED,qDAAqD;AACrD,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAA;AAE5D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,aAAa,CAAA;IACnB;+DAC2D;IAC3D,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;CAC5B;AAED;;;;;;GAMG;AACH,qBAAa,OAAO;;gBAON,OAAO,GAAE,cAAmB;IAKxC,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAahC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;IAI9C;;;;OAIG;IACH,OAAO,IAAI,SAAS,EAAE;IAoBtB,qDAAqD;IACrD,OAAO,IAAI,OAAO;CAGnB"}

package/dist/runDiff.js

@@ -0,0 +1,103 @@
+/**
+ * Continuous diff against a run's baseline — ADE spec §2.9, tier 1.
+ *
+ * > "from the sandbox filesystem: every create, write and delete with
+ * >  before/after content; **a real diff against the run's baseline, computed
+ * >  continuously**; hunk-level review, which needs the changes and not the
+ * >  agent's narration."
+ *
+ * This is the engine behind the tier-1 review capability, and it is also §9b's
+ * fourth load component — the last one unmeasured, and the only one where the
+ * case for a Rust host could still be won, because it is the one that scales
+ * with repository size rather than with agent count.
+ *
+ * ## An event log is not a diff
+ *
+ * The whole difficulty is that the filesystem stream describes WHAT HAPPENED
+ * while a reviewer needs to know WHAT IS DIFFERENT. Those disagree constantly:
+ *
+ * - create then delete → **nothing changed**, not "added" followed by "deleted".
+ *   A diff listing the added file sends a reviewer to a path that does not
+ *   exist.
+ * - delete then create → **modified**, if the file was in the baseline. Reported
+ *   as "added" it implies the original is gone when it was replaced.
+ * - modify a file the baseline never had → **added**. It was created before the
+ *   watcher attached, or created and then written; either way "modified"
+ *   describes a prior version that never existed.
+ * - many writes → **one** modified entry. A reviewer counting events would read
+ *   an agent that saved often as an agent that changed more.
+ *
+ * Each of those is a case where replaying events verbatim produces a confident,
+ * wrong answer — which is worse than no diff, because a reviewer acts on it.
+ *
+ * ## Baseline membership, not content hashes
+ *
+ * The baseline is the set of paths that existed when the run started. Content
+ * hashing is deliberately out of scope here: it belongs where the bytes live
+ * (the sandbox), and pulling contents into this layer would make a pure,
+ * cheap state machine depend on I/O — the thing that makes it measurable for
+ * §9b in the first place.
+ */
+/**
+ * Folds a filesystem event stream into a net change set.
+ *
+ * Incremental by construction: each event is O(1), so the cost tracks the event
+ * rate rather than the repository size. That is the property §9b's fourth
+ * component needs measured, and it only holds while this stays a pure fold.
+ */
+export class RunDiff {
+    #baseline;
+    /** Paths that exist right now, as far as the stream has told us. */
+    #present = new Set();
+    /** Paths the stream has touched at all, with a count. */
+    #touched = new Map();
+    constructor(options = {}) {
+        this.#baseline = new Set(options.baseline ?? []);
+        for (const path of this.#baseline)
+            this.#present.add(path);
+    }
+    apply(event) {
+        this.#touched.set(event.path, (this.#touched.get(event.path) ?? 0) + 1);
+        if (event.kind === 'removed') {
+            this.#present.delete(event.path);
+            return;
+        }
+        // `created` and `modified` both mean "it exists now". The distinction the
+        // reviewer needs comes from the BASELINE, not from which verb the watcher
+        // used — a file created before the watcher attached arrives as `modified`,
+        // and one written twice arrives as `created` then `modified`.
+        this.#present.add(event.path);
+    }
+    applyAll(events) {
+        for (const event of events)
+            this.apply(event);
+    }
+    /**
+     * The net change set, sorted by path so two runs over the same work produce
+     * identical output — a diff whose order varies is a diff that cannot be
+     * compared between runs.
+     */
+    changes() {
+        const changes = [];
+        for (const [path, events] of this.#touched) {
+            const inBaseline = this.#baseline.has(path);
+            const existsNow = this.#present.has(path);
+            if (!inBaseline && !existsNow) {
+                // Created and then deleted within the run. Nothing is different, and
+                // listing it would send a reviewer to a path that does not exist.
+                continue;
+            }
+            if (inBaseline && existsNow) {
+                changes.push({ path, kind: 'modified', events });
+                continue;
+            }
+            changes.push({ path, kind: existsNow ? 'added' : 'deleted', events });
+        }
+        return changes.sort((left, right) => left.path.localeCompare(right.path));
+    }
+    /** True when the run has changed nothing on disk. */
+    isClean() {
+        return this.changes().length === 0;
+    }
+}
+//# sourceMappingURL=runDiff.js.map

package/dist/runDiff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runDiff.js","sourceRoot":"","sources":["../src/runDiff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AA+BH;;;;;;GAMG;AACH,MAAM,OAAO,OAAO;IACT,SAAS,CAAa;IAC/B,oEAAoE;IAC3D,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAA;IACrC,yDAAyD;IAChD,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAA;IAE7C,YAAY,UAA0B,EAAE;QACtC,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAA;QAChD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,SAAS;YAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC5D,CAAC;IAED,KAAK,CAAC,KAAmB;QACvB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;QACvE,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAChC,OAAM;QACR,CAAC;QACD,0EAA0E;QAC1E,0EAA0E;QAC1E,2EAA2E;QAC3E,8DAA8D;QAC9D,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC/B,CAAC;IAED,QAAQ,CAAC,MAA8B;QACrC,KAAK,MAAM,KAAK,IAAI,MAAM;YAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAC/C,CAAC;IAED;;;;OAIG;IACH,OAAO;QACL,MAAM,OAAO,GAAgB,EAAE,CAAA;QAC/B,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YAEzC,IAAI,CAAC,UAAU,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC9B,qEAAqE;gBACrE,kEAAkE;gBAClE,SAAQ;YACV,CAAC;YACD,IAAI,UAAU,IAAI,SAAS,EAAE,CAAC;gBAC5B,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAA;gBAChD,SAAQ;YACV,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,CAAA;QACvE,CAAC;QACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;IAC3E,CAAC;IAED,qDAAqD;IACrD,OAAO;QACL,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,KAAK,CAAC,CAAA;IACpC,CAAC;CACF"}

package/dist/runtime/agentReasoningEffort.d.ts

@@ -0,0 +1,22 @@
+export declare const AGENT_REASONING_EFFORTS: readonly ["none", "low", "medium", "high", "xhigh"];
+export type AgentReasoningEffort = 'auto' | 'thinking' | typeof AGENT_REASONING_EFFORTS[number];
+export interface AgentReasoningEffortOption {
+    effort: AgentReasoningEffort;
+    modelId: string;
+}
+export interface AgentReasoningEffortFamily {
+    baseId: string;
+    effort: AgentReasoningEffort;
+    options: AgentReasoningEffortOption[];
+}
+export declare function splitAgentReasoningEffort(id: string): {
+    baseId: string;
+    effort: Exclude<AgentReasoningEffort, 'auto' | 'thinking'>;
+} | null;
+export declare function agentReasoningEffortLabel(effort: AgentReasoningEffort): string;
+export declare function agentReasoningEffortRank(effort: AgentReasoningEffort): number;
+export declare function buildExplicitAgentReasoningEffortFamilies(modelIds: readonly string[]): Map<string, AgentReasoningEffortOption[]>;
+export declare function indexAgentReasoningEffortFamilies(families: ReadonlyMap<string, readonly AgentReasoningEffortOption[]>): Map<string, string>;
+export declare function resolveAgentReasoningEffortFamily(selectedModelId: string | undefined, families: ReadonlyMap<string, AgentReasoningEffortOption[]>, familyByModelId: ReadonlyMap<string, string>): AgentReasoningEffortFamily | null;
+export declare function preferredAgentReasoningModelId(options: readonly AgentReasoningEffortOption[]): string | undefined;
+//# sourceMappingURL=agentReasoningEffort.d.ts.map

package/dist/runtime/agentReasoningEffort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentReasoningEffort.d.ts","sourceRoot":"","sources":["../../src/runtime/agentReasoningEffort.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,qDAAsD,CAAA;AAE1F,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,uBAAuB,CAAC,MAAM,CAAC,CAAA;AAE/F,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,oBAAoB,CAAA;IAC5B,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,oBAAoB,CAAA;IAC5B,OAAO,EAAE,0BAA0B,EAAE,CAAA;CACtC;AAED,wBAAgB,yBAAyB,CACvC,EAAE,EAAE,MAAM,GACT;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC,oBAAoB,EAAE,MAAM,GAAG,UAAU,CAAC,CAAA;CAAE,GAAG,IAAI,CAQvF;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAI9E;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAI7E;AAED,wBAAgB,yCAAyC,CACvD,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,GAAG,CAAC,MAAM,EAAE,0BAA0B,EAAE,CAAC,CAuB3C;AAED,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,0BAA0B,EAAE,CAAC,GACnE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAOrB;AAED,wBAAgB,iCAAiC,CAC/C,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,0BAA0B,EAAE,CAAC,EAC3D,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3C,0BAA0B,GAAG,IAAI,CAenC;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,SAAS,0BAA0B,EAAE,GAC7C,MAAM,GAAG,SAAS,CAMpB"}

package/dist/runtime/agentReasoningEffort.js

@@ -0,0 +1,76 @@
+export const AGENT_REASONING_EFFORTS = ['none', 'low', 'medium', 'high', 'xhigh'];
+export function splitAgentReasoningEffort(id) {
+    const match = id.replace(/:thinking$/, '').match(/^(.*)-(none|low|medium|high|xhigh)$/);
+    return match
+        ? {
+            baseId: match[1],
+            effort: match[2],
+        }
+        : null;
+}
+export function agentReasoningEffortLabel(effort) {
+    return effort === 'xhigh'
+        ? 'X-High'
+        : `${effort.charAt(0).toUpperCase()}${effort.slice(1)}`;
+}
+export function agentReasoningEffortRank(effort) {
+    if (effort === 'auto')
+        return -1;
+    if (effort === 'thinking')
+        return AGENT_REASONING_EFFORTS.length;
+    return AGENT_REASONING_EFFORTS.indexOf(effort);
+}
+export function buildExplicitAgentReasoningEffortFamilies(modelIds) {
+    const variants = new Map();
+    const modelIdSet = new Set(modelIds);
+    for (const modelId of modelIds) {
+        const parsed = splitAgentReasoningEffort(modelId);
+        if (!parsed)
+            continue;
+        const family = variants.get(parsed.baseId) || [];
+        family.push({ effort: parsed.effort, modelId });
+        variants.set(parsed.baseId, family);
+    }
+    const families = new Map();
+    for (const [baseId, options] of variants) {
+        if (options.length < 2 && !modelIdSet.has(baseId))
+            continue;
+        const sorted = [...options].sort((a, b) => agentReasoningEffortRank(a.effort) - agentReasoningEffortRank(b.effort));
+        if (modelIdSet.has(baseId))
+            sorted.unshift({ effort: 'auto', modelId: baseId });
+        families.set(baseId, sorted);
+    }
+    return families;
+}
+export function indexAgentReasoningEffortFamilies(families) {
+    const familyByModelId = new Map();
+    for (const [baseId, options] of families) {
+        familyByModelId.set(baseId, baseId);
+        for (const option of options)
+            familyByModelId.set(option.modelId, baseId);
+    }
+    return familyByModelId;
+}
+export function resolveAgentReasoningEffortFamily(selectedModelId, families, familyByModelId) {
+    if (!selectedModelId)
+        return null;
+    const parsed = splitAgentReasoningEffort(selectedModelId);
+    const baseId = familyByModelId.get(selectedModelId)
+        || parsed?.baseId
+        || selectedModelId.replace(/:thinking$/, '');
+    const options = families.get(baseId);
+    if (!options)
+        return null;
+    const selectedOption = options.find((option) => option.modelId === selectedModelId);
+    return {
+        baseId,
+        effort: selectedOption?.effort || parsed?.effort || 'auto',
+        options,
+    };
+}
+export function preferredAgentReasoningModelId(options) {
+    return (options.find((option) => option.effort === 'auto')
+        || options.find((option) => option.effort === 'high')
+        || options[0])?.modelId;
+}
+//# sourceMappingURL=agentReasoningEffort.js.map

package/dist/runtime/agentReasoningEffort.js.map

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

package/dist/runtime/agentRuntimeProvider.d.ts

@@ -0,0 +1,12 @@
+import type { AcpRuntimeAgentDescriptor, HubAgentRuntimeProvider, HubAgentRuntimeSelection } from './agentRuntimeProviderTypes.js';
+export declare const DEFAULT_HUB_AGENT_RUNTIME_SELECTION: HubAgentRuntimeSelection;
+export declare function normalizeHubAgentRuntimeSelection(value: unknown): HubAgentRuntimeSelection;
+export interface ResolveHubAgentRuntimeProviderOptions {
+    selection?: unknown;
+    permissionProfile?: string | undefined;
+    acpAgents?: AcpRuntimeAgentDescriptor[] | undefined;
+}
+export declare function resolveHubAgentRuntimeProvider(options?: ResolveHubAgentRuntimeProviderOptions): HubAgentRuntimeProvider;
+export declare function runtimeProviderDisplayLabel(provider: Pick<HubAgentRuntimeProvider, 'kind' | 'displayName' | 'status'>): string;
+export declare function acpAgentDisplayName(agent: Pick<AcpRuntimeAgentDescriptor, 'id' | 'name'>): string;
+//# sourceMappingURL=agentRuntimeProvider.d.ts.map

package/dist/runtime/agentRuntimeProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentRuntimeProvider.d.ts","sourceRoot":"","sources":["../../src/runtime/agentRuntimeProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EAGzB,uBAAuB,EAEvB,wBAAwB,EACzB,MAAM,gCAAgC,CAAA;AAsBvC,eAAO,MAAM,mCAAmC,EAAE,wBAKjD,CAAA;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,CAqB1F;AAED,MAAM,WAAW,qCAAqC;IACpD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,SAAS,CAAC,EAAE,yBAAyB,EAAE,GAAG,SAAS,CAAA;CACpD;AAED,wBAAgB,8BAA8B,CAAC,OAAO,GAAE,qCAA0C,GAAG,uBAAuB,CAgE3H;AAED,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,IAAI,CAAC,uBAAuB,EAAE,MAAM,GAAG,aAAa,GAAG,QAAQ,CAAC,GAAG,MAAM,CAG9H;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC,yBAAyB,EAAE,IAAI,GAAG,MAAM,CAAC,GAAG,MAAM,CAIjG"}