@agenticprimitives/orchestration 0.0.0-alpha.1 → 0.0.0-alpha.11

package/dist/answer-quality.js

@@ -0,0 +1,97 @@
+// ANSWER QUALITY, JUDGED — spec 416 §4h. An instruction skill's answer is scored by typed yes-no questions (J9) over one
+// frozen state — the request, the skill's ontology card, the answer — so a faster or cheaper way of answering can be
+// traded against quality with evidence, not taste. Numbers only leave (J7): the per-question probabilities and their
+// mean. Evidence, never authority (J1): nothing reads the score to permit or refuse anything.
+import { judgeQuestions, judgeQuestionsAveraged, structuredCallDecisionModel } from './judgment.js';
+export const ANSWER_QUALITY_JUDGE = { name: 'ap.answer-quality-judge.v1', kind: 'model' };
+/** The rubric: each a statement the judge gives P(true) for. Stable ids — a changed rubric is a new judge name (J5). */
+export const ANSWER_QUALITY_RUBRIC = [
+    { id: 'answers', statement: 'The answer addresses what the request actually asks for, not a neighbouring task.' },
+    { id: 'method', statement: 'The answer follows the skill\'s method and produces what the skill says it produces.' },
+    { id: 'grounded', statement: 'The answer states no specific facts about the organization (names, figures, dates) that the request did not give, or marks each such fact as a placeholder to confirm.' },
+    { id: 'asks', statement: 'Where the request lacks information the skill needs, the answer says what is needed instead of inventing it (true if nothing was missing).' },
+    { id: 'usable', statement: 'A person could act on this answer as it stands, without rewriting it.' },
+];
+/** Judge one answer. The answer is truncated to `maxChars` (the judge reads a bounded state). */
+export async function judgeAnswerQuality(input, call) {
+    const t0 = Date.now();
+    const max = input.maxChars ?? 8000;
+    const answer = input.answer.length > max ? `${input.answer.slice(0, max)}\n…(truncated)` : input.answer;
+    const questions = ANSWER_QUALITY_RUBRIC.map((q) => ({ id: q.id, kind: 'yes-no', statement: q.statement }));
+    const j = await judgeQuestions(`The skill: ${input.skillCard}\n\nThe request:\n${input.request}\n\nThe answer:\n${answer}`, questions, structuredCallDecisionModel(call, { name: ANSWER_QUALITY_JUDGE.name, stablePrefix: true }));
+    const scores = Object.fromEntries(Object.entries(j.answers).map(([id, a]) => [id, Number((a.distribution['true'] ?? 0).toFixed(4))]));
+    const vals = Object.values(scores);
+    return { judge: ANSWER_QUALITY_JUDGE, scores, score: vals.length ? Number((vals.reduce((a, b) => a + b, 0) / vals.length).toFixed(4)) : 0, ms: Date.now() - t0, ...(j.error !== undefined ? { error: j.error } : {}) };
+}
+// ── PAIRWISE PREFERENCE — a rubric scored in isolation saturates (0.97–1.00 for everything, 2026-09-27); two answers to
+// the same request, judged side by side in BOTH orders under neutral labels and averaged (position bias cancelled), is
+// the comparison that discriminates. Numbers only: P(first better), P(second better), P(no real difference).
+export const ANSWER_PREFERENCE_JUDGE = { name: 'ap.answer-preference-judge.v1', kind: 'model' };
+export async function judgeAnswerPreference(input, call) {
+    const t0 = Date.now();
+    const max = input.maxChars ?? 6000;
+    const cut = (a) => (a.length > max ? `${a.slice(0, max)}\n…(truncated)` : a);
+    const q = { id: 'better', kind: 'choice', question: 'Which answer better serves this request under this skill — more correct, more complete, better grounded, more usable?', options: Object.entries(input.answers).map(([id, a]) => ({ id, describe: cut(a).replace(/\s+/g, ' ') })), alsoOutcomes: [{ id: 'tie', describe: 'No real difference in quality.' }] };
+    const j = await judgeQuestionsAveraged(`The skill: ${input.skillCard}\n\nThe request:\n${input.request}`, [q], structuredCallDecisionModel(call, { name: ANSWER_PREFERENCE_JUDGE.name }), { permutations: 2 });
+    const a = j.answers['better'];
+    return { judge: ANSWER_PREFERENCE_JUDGE, preference: a ? { ...a.distribution } : {}, permutations: j.permutations, ms: Date.now() - t0, ...(j.error !== undefined ? { error: j.error } : {}) };
+}
+// ── THE OUTCOME CHECK — spec 418 / gap register A2. Not "was the right skill chosen" but "did the answer DELIVER what the
+// request asked for". The ontology says what each skill PRODUCES; the request says WHICH of those it wants. So one call asks,
+// per candidate class of the terminal skill, "does the request ask for a <class>?" and, per class, "does the answer deliver
+// it — or, where the request lacks the facts it needs, its structure with the missing facts named?". Intermediate artifacts
+// the plan was built on are always required. The score is delivery over the REQUESTED classes (those asked with P ≥ 0.5;
+// the most-asked one when none is). v2 (2026-09-28): v1 required every product, and scored a correct letter of inquiry
+// 0.24 because the drafter also produces proposals, and a structured pipeline with its gaps named ~0.
+// v3 (2026-10-02) — ALTERNATIVE OUTPUTS ARE SCORED ONCE. A skill can produce EITHER one class OR another (the drafter: a
+// Letter of Inquiry or a Grant Proposal, two entries to one application; its body picks one). v2 still asked about each
+// and, when a request read as asking for both, averaged in the one the skill was never meant to write: on chain panels
+// 1–4 (3 repeats, Claude Haiku judging) 51 of 68 grant runs delivered exactly one and lost about a third of the score.
+// The ontology now says which produced classes are alternatives (`alternative`, a group name from the data graph's
+// `skills:alternativeGroup`), and the score counts UNITS: an ungrouped class is its own unit, exactly as in v2; a group
+// is one unit, requested = the most-asked member, delivered = the best-delivered member, required if any member is. The
+// per-class `classes` / `requested` maps keep their shape; `units` says what was scored.
+// Numbers only; evidence, never authority (J1).
+export const OUTCOME_CHECK_JUDGE = { name: 'ap.outcome-check-judge.v3', kind: 'model' };
+export async function judgeOutcomeDelivered(input, call) {
+    const t0 = Date.now();
+    const max = input.maxChars ?? 9000;
+    const answer = input.answer.length > max ? `${input.answer.slice(0, max)}\n…(truncated)` : input.answer;
+    const cands = input.expected.slice(0, 8);
+    if (!cands.length)
+        return { judge: OUTCOME_CHECK_JUDGE, classes: {}, requested: {}, score: 0, ms: 0, error: 'no expected classes' };
+    const qs = [
+        // Two plain questions per class, never one compound one: a judge reading "X, or else Y" anchored on X and scored a
+        // correct template-with-gaps 0.02 (validation, 2026-09-28). Delivered = the higher of the two.
+        ...cands.map((c, i) => ({ id: `d${i + 1}`, kind: 'yes-no', statement: `The answer contains a complete ${c.label}.` })),
+        ...cands.map((c, i) => ({ id: `s${i + 1}`, kind: 'yes-no', statement: `The answer lays out a ${c.label}'s full structure, filled in wherever the request gave the facts, and names the facts still needed to finish it.` })),
+        ...cands.flatMap((c, i) => (c.required ? [] : [{ id: `r${i + 1}`, kind: 'yes-no', statement: `The request asks for a ${c.label}.` }])),
+    ];
+    const j = await judgeQuestions(`The request:\n${input.request}\n\nThe answer:\n${answer}`, qs, structuredCallDecisionModel(call, { name: OUTCOME_CHECK_JUDGE.name, stablePrefix: true }));
+    const p = (id) => Number((j.answers[id]?.distribution['true'] ?? 0).toFixed(4));
+    const classes = Object.fromEntries(cands.map((c, i) => [c.iri, Math.max(p(`d${i + 1}`), p(`s${i + 1}`))]));
+    const requested = Object.fromEntries(cands.map((c, i) => [c.iri, c.required ? 1 : p(`r${i + 1}`)]));
+    // Fold each alternative group into ONE unit (v3); an ungrouped class is its own unit, so v2's arithmetic is unchanged.
+    const byId = new Map();
+    for (const c of cands) {
+        const id = c.alternative ? `alternative:${c.alternative}` : c.iri;
+        const u = byId.get(id) ?? (byId.set(id, { id, members: [], requested: 0, delivered: 0, counted: false }).get(id));
+        u.members.push(c.iri);
+        u.requested = Math.max(u.requested, requested[c.iri]);
+        u.delivered = Math.max(u.delivered, classes[c.iri]);
+        if (c.required)
+            u.required = true;
+    }
+    const units = [...byId.values()];
+    let counted = units.filter((u) => u.requested >= 0.5);
+    if (!counted.some((u) => !u.required)) {
+        const optional = units.filter((u) => !u.required).sort((a, b) => b.requested - a.requested);
+        if (optional[0])
+            counted = [...counted, optional[0]];
+    }
+    for (const u of counted)
+        u.counted = true;
+    const vals = counted.map((u) => u.delivered);
+    return { judge: OUTCOME_CHECK_JUDGE, classes, requested, units, score: vals.length ? Number((vals.reduce((a, b) => a + b, 0) / vals.length).toFixed(4)) : 0, ms: Date.now() - t0, ...(j.error !== undefined ? { error: j.error } : {}) };
+}
+//# sourceMappingURL=answer-quality.js.map

package/dist/answer-quality.js.map

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

package/dist/artifacts.d.ts

@@ -0,0 +1,137 @@
+import type { StepObservation, PlanStep } from './types.js';
+import type { RunResult } from './types.js';
+export declare const ARTIFACT_REF_TYPE: "ap.artifact-ref.v1";
+/** A result whose canonical JSON is longer than this is offloaded when a store is bound. A deployment setting. */
+export declare const OFFLOAD_THRESHOLD_CHARS = 8000;
+/** The most a summary may run to — a shape, never a body. */
+export declare const SUMMARY_MAX_CHARS = 600;
+/** The stand-in for an offloaded result: where the body is, what it is, and its shape. */
+export interface ArtifactRefV1 {
+    $artifact: typeof ARTIFACT_REF_TYPE;
+    /** The agent whose vault holds it (the acting agent — the run's addressee). */
+    agent: string;
+    /** The vault record key: `run.artifact:<runRef>:<stepRef>`. */
+    recordType: string;
+    /** sha256 of the canonical JSON of the body — the same bytes the receipt's outputDigest commits to. */
+    digest: string;
+    bytes: number;
+    toolId: string;
+    summary: string;
+    /** The few top-level FACTS the run's record and spans read off a result (a chain tx hash, a routed step's
+     *  `via`, a count) — kept on the reference so offloading a body loses no evidence. Names from a fixed list. */
+    retained?: Record<string, unknown>;
+}
+/** Top-level result keys retained on a reference: what the record, the spans and the graph cite. */
+export declare const RETAINED_RESULT_KEYS: readonly ["txHash", "via", "count", "total", "ok", "outcome"];
+/** The facts of a result whether it is whole or a reference — what a projection reads. */
+export declare function resultFactsOf(result: unknown): Record<string, unknown> | undefined;
+export declare const RUN_ARTIFACT_RECORD_PREFIX: "run.artifact:";
+export declare const runArtifactRecordKey: (runRef: string, stepRef: string) => string;
+/** The vault record an offloaded result becomes. */
+export interface RunArtifactRecordV1 {
+    type: 'ap.run-artifact.v1';
+    runRef: string;
+    stepRef: string;
+    toolId: string;
+    digest: string;
+    bytes: number;
+    at: number;
+    result: unknown;
+}
+export declare function isArtifactRef(v: unknown): v is ArtifactRefV1;
+/** Canonical JSON: keys sorted, bigints as strings — the same bytes the receipt digests. */
+export declare const canonicalJson: (v: unknown) => string;
+/**
+ * A DETERMINISTIC summary of a result: its kind and top-level shape, the length of every array, the
+ * first three items' title-like field, a count when the result declares one. Bounded, never a body,
+ * never a model's words. Two runs over the same result produce the same string.
+ */
+export declare function summarizeResult(result: unknown): string;
+/** The port the app binds to the acting agent's vault door. Failures throw — an artifact that could not be
+ *  written is a step whose result stays in the record whole, and the caller says so (never a silent drop). */
+export interface ArtifactStore {
+    put(record: RunArtifactRecordV1, agent: string): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        error: string;
+    }>;
+    get(ref: ArtifactRefV1): Promise<RunArtifactRecordV1 | null>;
+}
+export interface OffloadReport {
+    stepRef: string;
+    toolId: string;
+    bytes: number;
+    recordType: string;
+    ok: boolean;
+    error?: string;
+}
+/**
+ * The record / checkpoint form of a run's observations: every result whose canonical JSON exceeds the
+ * threshold is written to the store and replaced by its reference. The receipts are untouched (their
+ * digests already commit to the full output). A write that fails leaves the result whole and is reported.
+ */
+export declare function offloadObservations(steps: ReadonlyArray<StepObservation>, opts: {
+    runRef: string;
+    agent: string;
+    store: ArtifactStore;
+    threshold?: number;
+    now?: number;
+}): Promise<{
+    steps: StepObservation[];
+    offloaded: OffloadReport[];
+}>;
+/** The record form of a whole RunResult (steps offloaded; everything else as it was). */
+export declare function offloadRunResult<T extends Pick<RunResult, 'steps'>>(result: T, opts: Parameters<typeof offloadObservations>[1]): Promise<{
+    result: T;
+    offloaded: OffloadReport[];
+}>;
+/** The step references a plan's remaining steps reach through `$ref` (`{ $ref: 'name.path' }` — the name is
+ *  the producing step's `ref` or `id`). */
+export declare function refsReachedBy(steps: ReadonlyArray<PlanStep>): Set<string>;
+/**
+ * The inverse, on a resume: a completed step whose result is a reference gets its body back from the store
+ * ONLY when a remaining step's `$ref` reaches it (by the step's `ref`, `id` or stepRef). A body nobody will
+ * read stays a reference. A missing artifact is an error the caller surfaces — a resume that guessed a
+ * result would be a resume that lied.
+ */
+export declare function rehydrateObservations<T extends {
+    stepRef: string;
+    result?: unknown;
+}>(completed: ReadonlyArray<T>, plan: {
+    steps: ReadonlyArray<PlanStep>;
+}, store: ArtifactStore): Promise<{
+    completed: T[];
+    rehydrated: string[];
+}>;
+/**
+ * Spec 391 W2 — what a RE-PLAN sees of prior observations: a body over the threshold becomes its summary (a
+ * reference keeps its own). A planner deciding what comes next needs what a step was and how big, not 40 KB
+ * of it in the prompt.
+ */
+export declare function compactObservations(observations: ReadonlyArray<StepObservation>, threshold?: number): StepObservation[];
+export interface EvidenceItemV1 {
+    tool: string;
+    result: unknown; /** A summary stood in for the body. */
+    summarized?: boolean;
+}
+export interface FittedEvidenceV1 {
+    items: EvidenceItemV1[];
+    /** Characters of the fitted evidence, and of the whole. */
+    chars: number;
+    of: number;
+    /** Every step whose body was replaced by its summary, in order — for the trace and the governor. */
+    dropped: Array<{
+        tool: string;
+        stepRef?: string;
+        bytes: number;
+    }>;
+}
+/**
+ * The composer's evidence, FITTED to a budget instead of sliced: successful observations in order; a
+ * reference contributes its summary; a body that fits is kept whole; a body that would push the whole
+ * past the cap is replaced by its summary and recorded as dropped. The first item is always kept whole
+ * when it fits alone — an answer with no evidence is not an answer.
+ */
+export declare function fitEvidence(observations: ReadonlyArray<StepObservation>, cap: number): FittedEvidenceV1;
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/artifacts.d.ts.map

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

package/dist/artifacts.js

@@ -0,0 +1,232 @@
+export const ARTIFACT_REF_TYPE = 'ap.artifact-ref.v1';
+/** A result whose canonical JSON is longer than this is offloaded when a store is bound. A deployment setting. */
+export const OFFLOAD_THRESHOLD_CHARS = 8_000;
+/** The most a summary may run to — a shape, never a body. */
+export const SUMMARY_MAX_CHARS = 600;
+/** Top-level result keys retained on a reference: what the record, the spans and the graph cite. */
+export const RETAINED_RESULT_KEYS = ['txHash', 'via', 'count', 'total', 'ok', 'outcome'];
+/** The facts of a result whether it is whole or a reference — what a projection reads. */
+export function resultFactsOf(result) {
+    if (isArtifactRef(result))
+        return result.retained;
+    return result && typeof result === 'object' && !Array.isArray(result) ? result : undefined;
+}
+export const RUN_ARTIFACT_RECORD_PREFIX = 'run.artifact:';
+export const runArtifactRecordKey = (runRef, stepRef) => `${RUN_ARTIFACT_RECORD_PREFIX}${runRef}:${stepRef}`;
+export function isArtifactRef(v) {
+    return !!v && typeof v === 'object' && v.$artifact === ARTIFACT_REF_TYPE && typeof v.recordType === 'string';
+}
+/** Canonical JSON: keys sorted, bigints as strings — the same bytes the receipt digests. */
+export const canonicalJson = (v) => JSON.stringify(v, (_k, x) => (typeof x === 'bigint' ? x.toString() : x && typeof x === 'object' && !Array.isArray(x) ? Object.keys(x).sort().reduce((o, k) => { o[k] = x[k]; return o; }, {}) : x)) ?? 'null';
+const sha256 = async (s) => {
+    const bytes = new Uint8Array(await crypto.subtle.digest('SHA-256', new TextEncoder().encode(s)));
+    return `0x${Array.from(bytes, (b) => b.toString(16).padStart(2, '0')).join('')}`;
+};
+const TITLE_KEYS = ['title', 'name', 'id', 'label', 'handle'];
+const COUNT_KEYS = ['count', 'total', 'length', 'size'];
+const short = (s, n) => (s.length > n ? `${s.slice(0, n - 1)}…` : s);
+/**
+ * A DETERMINISTIC summary of a result: its kind and top-level shape, the length of every array, the
+ * first three items' title-like field, a count when the result declares one. Bounded, never a body,
+ * never a model's words. Two runs over the same result produce the same string.
+ */
+export function summarizeResult(result) {
+    const parts = [];
+    const firstTitles = (items) => items.slice(0, 3).map((it) => {
+        if (it && typeof it === 'object') {
+            for (const k of TITLE_KEYS) {
+                const v = it[k];
+                if (typeof v === 'string' && v.trim())
+                    return short(v.trim(), 60);
+            }
+            // No title-like key (a query's rows, say): the first short string field names the item better than `{…}`.
+            for (const [k, v] of Object.entries(it))
+                if (typeof v === 'string' && v.trim() && v.length <= 80 && !/^0x[0-9a-fA-F]{40,}$/.test(v))
+                    return `${k}=${short(v.trim(), 40)}`;
+            return '{…}';
+        }
+        return typeof it === 'string' ? short(it, 40) : String(it);
+    }).join(' · ');
+    if (Array.isArray(result)) {
+        parts.push(`array of ${result.length}`);
+        if (result.length)
+            parts.push(`first: ${firstTitles(result)}`);
+    }
+    else if (result && typeof result === 'object') {
+        const o = result;
+        const keys = Object.keys(o).sort();
+        parts.push(`object{${keys.slice(0, 12).join(',')}${keys.length > 12 ? ',…' : ''}}`);
+        for (const k of COUNT_KEYS)
+            if (typeof o[k] === 'number') {
+                parts.push(`${k}=${o[k]}`);
+                break;
+            }
+        for (const k of keys) {
+            const v = o[k];
+            if (Array.isArray(v)) {
+                parts.push(`${k}[${v.length}]${v.length ? `: ${firstTitles(v)}` : ''}`);
+                if (parts.join('; ').length > SUMMARY_MAX_CHARS)
+                    break;
+            }
+        }
+    }
+    else if (typeof result === 'string') {
+        parts.push(`string of ${result.length} chars`);
+    }
+    else {
+        parts.push(String(result));
+    }
+    return short(parts.join('; '), SUMMARY_MAX_CHARS);
+}
+/**
+ * The record / checkpoint form of a run's observations: every result whose canonical JSON exceeds the
+ * threshold is written to the store and replaced by its reference. The receipts are untouched (their
+ * digests already commit to the full output). A write that fails leaves the result whole and is reported.
+ */
+export async function offloadObservations(steps, opts) {
+    const threshold = opts.threshold ?? OFFLOAD_THRESHOLD_CHARS;
+    const offloaded = [];
+    const out = [];
+    for (const [i, o] of steps.entries()) {
+        if (o.result === undefined || isArtifactRef(o.result)) {
+            out.push(o);
+            continue;
+        }
+        const json = canonicalJson(o.result);
+        if (json.length <= threshold) {
+            out.push(o);
+            continue;
+        }
+        const stepRef = o.stepRef ?? o.step.id ?? `s${i}`;
+        const recordType = runArtifactRecordKey(opts.runRef, stepRef);
+        const digest = await sha256(json);
+        const record = { type: 'ap.run-artifact.v1', runRef: opts.runRef, stepRef, toolId: o.step.toolId, digest, bytes: json.length, at: opts.now ?? Date.now(), result: o.result };
+        const wrote = await opts.store.put(record, opts.agent).catch((e) => ({ ok: false, error: e instanceof Error ? e.message : String(e) }));
+        if (!wrote.ok) {
+            offloaded.push({ stepRef, toolId: o.step.toolId, bytes: json.length, recordType, ok: false, error: wrote.error });
+            out.push(o);
+            continue;
+        }
+        const retained = {};
+        if (o.result && typeof o.result === 'object' && !Array.isArray(o.result))
+            for (const k of RETAINED_RESULT_KEYS) {
+                const v = o.result[k];
+                if (v !== undefined && canonicalJson(v).length <= 400)
+                    retained[k] = v;
+            }
+        const ref = { $artifact: ARTIFACT_REF_TYPE, agent: opts.agent.toLowerCase(), recordType, digest, bytes: json.length, toolId: o.step.toolId, summary: summarizeResult(o.result), ...(Object.keys(retained).length ? { retained } : {}) };
+        offloaded.push({ stepRef, toolId: o.step.toolId, bytes: json.length, recordType, ok: true });
+        out.push({ ...o, result: ref });
+    }
+    return { steps: out, offloaded };
+}
+/** The record form of a whole RunResult (steps offloaded; everything else as it was). */
+export async function offloadRunResult(result, opts) {
+    const { steps, offloaded } = await offloadObservations(result.steps, opts);
+    return { result: { ...result, steps }, offloaded };
+}
+/** The step references a plan's remaining steps reach through `$ref` (`{ $ref: 'name.path' }` — the name is
+ *  the producing step's `ref` or `id`). */
+export function refsReachedBy(steps) {
+    const names = new Set();
+    const walk = (v) => {
+        if (!v || typeof v !== 'object')
+            return;
+        const r = v.$ref;
+        if (typeof r === 'string') {
+            names.add(r.split('.')[0]);
+            return;
+        }
+        for (const x of Object.values(v))
+            walk(x);
+    };
+    for (const s of steps)
+        walk(s.args);
+    return names;
+}
+/**
+ * The inverse, on a resume: a completed step whose result is a reference gets its body back from the store
+ * ONLY when a remaining step's `$ref` reaches it (by the step's `ref`, `id` or stepRef). A body nobody will
+ * read stays a reference. A missing artifact is an error the caller surfaces — a resume that guessed a
+ * result would be a resume that lied.
+ */
+export async function rehydrateObservations(completed, plan, store) {
+    const reached = refsReachedBy(plan.steps);
+    const nameOf = new Map();
+    for (const [i, s] of plan.steps.entries()) {
+        const ref = `s${i}`;
+        if (s.ref)
+            nameOf.set(s.ref, ref);
+        if (s.id)
+            nameOf.set(s.id, s.id);
+    }
+    const rehydrated = [];
+    const out = [];
+    for (const c of completed) {
+        if (!isArtifactRef(c.result)) {
+            out.push(c);
+            continue;
+        }
+        const wanted = [...reached].some((n) => n === c.stepRef || nameOf.get(n) === c.stepRef || plan.steps.some((s) => (s.ref === n || s.id === n) && (s.id === c.stepRef || s.ref === c.stepRef)));
+        if (!wanted) {
+            out.push(c);
+            continue;
+        }
+        const rec = await store.get(c.result);
+        if (!rec)
+            throw new Error(`artifact ${c.result.recordType} is not in the vault — the resume cannot restore step ${c.stepRef}'s result`);
+        rehydrated.push(c.stepRef);
+        out.push({ ...c, result: rec.result });
+    }
+    return { completed: out, rehydrated };
+}
+/**
+ * Spec 391 W2 — what a RE-PLAN sees of prior observations: a body over the threshold becomes its summary (a
+ * reference keeps its own). A planner deciding what comes next needs what a step was and how big, not 40 KB
+ * of it in the prompt.
+ */
+export function compactObservations(observations, threshold = OFFLOAD_THRESHOLD_CHARS) {
+    return observations.map((o) => {
+        if (o.result === undefined)
+            return o;
+        if (isArtifactRef(o.result))
+            return { ...o, result: `[offloaded: ${o.result.summary}]` };
+        const json = canonicalJson(o.result);
+        return json.length <= threshold ? o : { ...o, result: `[summary: ${summarizeResult(o.result)}]` };
+    });
+}
+/**
+ * The composer's evidence, FITTED to a budget instead of sliced: successful observations in order; a
+ * reference contributes its summary; a body that fits is kept whole; a body that would push the whole
+ * past the cap is replaced by its summary and recorded as dropped. The first item is always kept whole
+ * when it fits alone — an answer with no evidence is not an answer.
+ */
+export function fitEvidence(observations, cap) {
+    const ok = observations.filter((o) => o.ok);
+    const whole = ok.map((o) => ({ o, json: isArtifactRef(o.result) ? null : canonicalJson(o.result ?? null) }));
+    const of = whole.reduce((n, w) => n + (w.json !== null ? w.json.length : w.o.result.summary.length), 0);
+    const items = [];
+    const dropped = [];
+    let chars = 0;
+    for (const { o, json } of whole) {
+        const tool = o.step.toolId;
+        if (json === null) {
+            const ref = o.result;
+            const s = `[offloaded: ${ref.summary}]`;
+            items.push({ tool, result: s, summarized: true });
+            chars += s.length;
+            continue;
+        }
+        if (chars + json.length <= cap) {
+            items.push({ tool, result: o.result });
+            chars += json.length;
+            continue;
+        }
+        const s = `[summary: ${summarizeResult(o.result)}]`;
+        items.push({ tool, result: s, summarized: true });
+        chars += s.length;
+        dropped.push({ tool, ...(o.stepRef ? { stepRef: o.stepRef } : {}), bytes: json.length });
+    }
+    return { items, chars, of, dropped };
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/artifacts.js.map

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