agentfootprint 10.6.1 → 10.7.0

package/CAPABILITIES.md

@@ -71,6 +71,7 @@ not in this table, search `src/index.ts` for the nearest noun before writing cod
 | declaring an agent's whole setup as one named, versioned thing — a preset, a template, a blueprint, "the support agent we all use" | `defineAgentRecipe` + `AgentBuilder.recipe()` | `src/recipes/` | 9.48.0 |
 | naming your own branches and nodes — which prefix is reserved, and telling framework plumbing from consumer structure in a trace | `RESERVED_SUBFLOW_PREFIX` + `isReservedSubflowSegment` | `src/lib/conventions.ts` | 9.49.0 |
 | keeping a large tool result out of the model's context | `artifacts` (bare store, or `{ store, placement: { maxInlineChars }, recordings }` — `placement` omitted ⇒ never placed; `recordings: true` / `{ label }`, default off) + `wants` + `placement` | `src/artifacts/` | 9.21.0 |
+| opening selected JSON from a host-admitted artifact without loading its whole payload into model context | `artifactDetailTool` + `ArtifactDetailError` — fresh host admission per call, small values, paginated child actions, whole-scalar omission and bounded context; no automatic store access, source read or claim authorization | `src/tools/artifactDetailTool.ts` | 10.7.0 |
 | the ticket placement just minted being REFUSED by your own `wants` argument as a kind mismatch — because the mint says `tool-result/<toolName>` and your consumer says `dataset/rows` | `Tool.resultKind` + `placedResultKind(toolName, declared?)` (the mint speaks the consumer's vocabulary; the exact-match matcher is untouched) | `src/artifacts/placement.ts` | 9.70.0 |
 | a viewer guessing which column of a dataset is time (epoch seconds under `ts`, wall-clock strings, a `bucket` column) and opening a series as a table | `timeAxis` on `PutArtifactInput` / `ArtifactMeta` (column · `'iso'`/`'epoch-s'`/`'epoch-ms'` · zone · interval · aggregate) + `readTimeAxis` + `describeTimeAxis` + `timeAxisIssues` (judged at mint, never repaired) | `src/time/axis.ts` | 9.128.0 |
 | a chart or check comparing a dataset's time values as spellings — epoch seconds beside ISO strings, `+02:00` beside `Z`, a wall-clock string with no offset silently read as UTC, two `01:30` rows in the hour the clocks go back; a READ-SIDE view (the stored rows are never rewritten): UTC instants at one precision, sorted, each with its row; an offset-less value under a zone-less axis is counted (`status: 'naive-values'`) or refused (`naive: 'refuse'`), never read as UTC; a fall-back wall time placed by row order and noted, else counted `dstAmbiguous`; a skipped one `dstGap` (the axis is re-exported from `src/artifacts/`) | `normaliseInstants` + `NormalisedAxis` | `src/time/axis.ts` | 9.129.0 |
@@ -89,6 +90,7 @@ not in this table, search `src/index.ts` for the nearest noun before writing cod
 | a skill wrongly activated by a keyword staying loaded for the whole turn — suspending/parking a map's prompt + tools when its contribution goes unused, WITHOUT touching its cursor, and re-engaging it on evidence | `.maps({ renewalGrace })` (default 3) + `MountedMap.nonParkable` + `advanceEngagement` + `agentfootprint.map.engaged/parked` + skip reason `'parked'` | `src/maps/` | 9.58.0 |
 | a value that must say how it knows itself — an unknown count that can never render as zero | `Claim<T>` (`known`/`unknown`/`notApplicable`) | `src/lib/claim/claim.ts` | 9.58.0 |
 | asking a debugging model "what did this run contradict itself about, and why?" — the Context Integrity findings, joined to the step that filed them | `find_context_errors` | `src/trace-toolpack/traceToolpack.ts` | 9.61.0 |
+| reading abnormal nodes, recorded dependency roots and downstream impact with bounded public Foottrace queries, scoped proof IDs and explicit unknown coverage; optional host-authorized storage graph, including inner tool and subflow questions | `attention_list` / `root_cause` / `impact` + `TraceToolpackArtifacts.cause` + `TraceToolpackOptions.cause` | `src/trace-toolpack/causeTools.ts` | 10.7.0 |
 | the model inventing an id or a reading that no tool ever returned — a deterministic fabrication detector on the final answer, with a posture for how hard it pushes back | `.namesAndNumbersFromEvidence()` + `posture` (`'assist'` record+flag, the default / `'guard'` one revision then ship flagged / `'rails'` refuse instead) + `shapes` + `exempt` + `minDigits` (default 4) + `nudge` (default off) | `src/core/agent/evidence/` | 9.35.0 |
 | counting a HUMAN-VERIFIED value as ground for the choice-seam check — the person clicked a row, the app verified the cells against the artifact, and the id the model takes from that selection is not fabricated; the source label travels onto the record | `externalGrounds` + `ExternalGround` + `external_ground_used` | `src/integrity/unsupported-argument/check.ts` | 9.72.0 |
 | a lookup tool that answers "nothing found" for EVERY id because a filter broke, and an agent reporting that absence as fact — the run itself produced the id, the lookup came back empty, and that PAIR is worth a look | `noticeEmptyLookups` + `readLookupResult` + `EMPTY_LOOKUP_CEILING` (dial default OFF and needs a tool declaring `argumentsFrom` too — two halves; kind `empty-lookup` at seam `write`, always `advisory: true`; empty = a zero-length ARRAY or an `absent()` envelope, every other shape files `not-applicable` and no finding; the ceiling is quoted verbatim into every message) | `src/integrity/empty-lookup/` | 9.77.0 |

package/dist/artifacts/detailError.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unavailableDetail = exports.invalidDetail = exports.ArtifactDetailError = void 0;
+const messages = {
+    ERR_ARTIFACT_DETAIL_INVALID: 'Invalid artifact detail request.',
+    ERR_ARTIFACT_DETAIL_UNAVAILABLE: 'Artifact detail is unavailable.',
+    ERR_ARTIFACT_DETAIL_CANCELLED: 'Artifact detail request was cancelled.',
+};
+/** A bounded detail request was malformed, could not be admitted, or was cancelled. */
+class ArtifactDetailError extends Error {
+    code;
+    constructor(code) {
+        super(messages[code]);
+        this.code = code;
+        this.name = 'ArtifactDetailError';
+    }
+}
+exports.ArtifactDetailError = ArtifactDetailError;
+function invalidDetail() {
+    throw new ArtifactDetailError('ERR_ARTIFACT_DETAIL_INVALID');
+}
+exports.invalidDetail = invalidDetail;
+function unavailableDetail() {
+    throw new ArtifactDetailError('ERR_ARTIFACT_DETAIL_UNAVAILABLE');
+}
+exports.unavailableDetail = unavailableDetail;
+//# sourceMappingURL=detailError.js.map

package/dist/artifacts/detailError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detailError.js","sourceRoot":"","sources":["../../src/artifacts/detailError.ts"],"names":[],"mappings":";;;AAMA,MAAM,QAAQ,GAAG;IACf,2BAA2B,EAAE,kCAAkC;IAC/D,+BAA+B,EAAE,iCAAiC;IAClE,6BAA6B,EAAE,wCAAwC;CAC/D,CAAC;AAEX,uFAAuF;AACvF,MAAa,mBAAoB,SAAQ,KAAK;IACvB;IAArB,YAAqB,IAA6B;QAChD,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QADH,SAAI,GAAJ,IAAI,CAAyB;QAEhD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AALD,kDAKC;AAED,SAAgB,aAAa;IAC3B,MAAM,IAAI,mBAAmB,CAAC,6BAA6B,CAAC,CAAC;AAC/D,CAAC;AAFD,sCAEC;AAED,SAAgB,iBAAiB;IAC/B,MAAM,IAAI,mBAAmB,CAAC,iCAAiC,CAAC,CAAC;AACnE,CAAC;AAFD,8CAEC"}

package/dist/artifacts/detailRequest.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readDetailArgs = exports.detailTokens = exports.DETAIL_LIMITS = void 0;
+const boundedJson_js_1 = require("../lib/boundedJson.js");
+const naming_js_1 = require("./naming.js");
+const detailError_js_1 = require("./detailError.js");
+exports.DETAIL_LIMITS = Object.freeze({
+    inputBytes: 1024 * 1024,
+    contextBytes: 4096,
+    path: 2048,
+    depth: 16,
+    page: 20,
+    offset: 1_000_000,
+    valueBytes: 8192,
+    outputBytes: 12 * 1024,
+    reserveBytes: 512,
+});
+const forbidden = new Set(['__proto__', 'prototype', 'constructor']);
+/** Strict pointer tokens, shared by request admission and child actions. */
+function detailTokens(path) {
+    if (path === '')
+        return [];
+    if (!path.startsWith('/') || path.length > exports.DETAIL_LIMITS.path)
+        return (0, detailError_js_1.invalidDetail)();
+    const parts = path.slice(1).split('/');
+    if (parts.length > exports.DETAIL_LIMITS.depth)
+        return (0, detailError_js_1.invalidDetail)();
+    return parts.map((part) => {
+        // eslint-disable-next-line no-control-regex -- A pointer must not carry C0 or DEL controls.
+        if (/~(?![01])/.test(part) || /[\u0000-\u001f\u007f]/.test(part))
+            return (0, detailError_js_1.invalidDetail)();
+        const key = part.replace(/~1/g, '/').replace(/~0/g, '~');
+        if (forbidden.has(key))
+            return (0, detailError_js_1.invalidDetail)();
+        return key;
+    });
+}
+exports.detailTokens = detailTokens;
+function readDetailArgs(value) {
+    try {
+        const fields = (0, boundedJson_js_1.ownData)(value, ['ref', 'path', 'offset', 'limit']);
+        if (typeof fields.ref !== 'string' ||
+            !(0, naming_js_1.isArtifactRef)(fields.ref) ||
+            typeof fields.path !== 'string')
+            return (0, detailError_js_1.invalidDetail)();
+        detailTokens(fields.path);
+        const offset = fields.offset === undefined ? 0 : fields.offset;
+        const limit = fields.limit === undefined ? exports.DETAIL_LIMITS.page : fields.limit;
+        if (!Number.isSafeInteger(offset) ||
+            Number(offset) < 0 ||
+            Number(offset) > exports.DETAIL_LIMITS.offset ||
+            !Number.isSafeInteger(limit) ||
+            Number(limit) < 1 ||
+            Number(limit) > exports.DETAIL_LIMITS.page)
+            return (0, detailError_js_1.invalidDetail)();
+        return { ref: fields.ref, path: fields.path, offset: Number(offset), limit: Number(limit) };
+    }
+    catch {
+        return (0, detailError_js_1.invalidDetail)();
+    }
+}
+exports.readDetailArgs = readDetailArgs;
+//# sourceMappingURL=detailRequest.js.map

package/dist/artifacts/detailRequest.js.map

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

package/dist/artifacts/detailTypes.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=detailTypes.js.map

package/dist/artifacts/detailTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detailTypes.js","sourceRoot":"","sources":["../../src/artifacts/detailTypes.ts"],"names":[],"mappings":""}

package/dist/artifacts/detailView.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectArtifactDetail = void 0;
+const payload_js_1 = require("./payload.js");
+const detailRequest_js_1 = require("./detailRequest.js");
+const detailError_js_1 = require("./detailError.js");
+const object = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+const container = (value) => object(value) || Array.isArray(value);
+// The payload owner counts bare strings as text; a one-element JSON array also counts quotes.
+const jsonBytes = (value) => (0, payload_js_1.measureArtifactBytes)([value]) - 2;
+const kind = (value) => value === null
+    ? 'null'
+    : Array.isArray(value)
+        ? 'array'
+        : typeof value;
+function select(root, path) {
+    let value = root;
+    for (const key of (0, detailRequest_js_1.detailTokens)(path)) {
+        if (Array.isArray(value) && !/^(0|[1-9]\d*)$/.test(key))
+            return (0, detailError_js_1.invalidDetail)();
+        if (!container(value) || !Object.hasOwn(value, key))
+            return (0, detailError_js_1.unavailableDetail)();
+        value = Array.isArray(value) ? value[Number(key)] : value[key];
+    }
+    return value;
+}
+function childPath(parent, key) {
+    return `${parent}/${key.replace(/~/g, '~0').replace(/\//g, '~1')}`;
+}
+function bounded(value) {
+    if (jsonBytes(value) > detailRequest_js_1.DETAIL_LIMITS.outputBytes)
+        return (0, detailError_js_1.unavailableDetail)();
+    return value;
+}
+/** Navigate only detached ordinary JSON; this function reads no store and authorizes no claim. */
+function projectArtifactDetail(root, args, tool, context) {
+    const value = select(root, args.path);
+    const base = {
+        ref: args.ref,
+        path: args.path,
+        kind: kind(value),
+        ...(context === undefined ? {} : { context }),
+    };
+    const keys = container(value) ? Object.keys(value) : [];
+    const inline = { ...base, mode: 'value', value, complete: true };
+    if (args.offset === 0 &&
+        keys.length <= args.limit &&
+        jsonBytes(value) <= detailRequest_js_1.DETAIL_LIMITS.valueBytes &&
+        jsonBytes(inline) <= detailRequest_js_1.DETAIL_LIMITS.outputBytes)
+        return inline;
+    if (!container(value)) {
+        if (args.offset !== 0)
+            return (0, detailError_js_1.invalidDetail)();
+        return bounded({
+            ...base,
+            mode: 'scalar-omitted',
+            omitted: true,
+            scalarBytes: jsonBytes(value),
+            complete: false,
+            reason: 'Selected scalar exceeds the bounded view; no partial value was returned.',
+        });
+    }
+    if (args.offset > keys.length)
+        return (0, detailError_js_1.invalidDetail)();
+    const children = [];
+    const response = () => ({
+        ...base,
+        mode: 'children',
+        children,
+        offset: args.offset,
+        shown: children.length,
+        total: keys.length,
+        complete: args.offset + children.length === keys.length,
+        ...(args.offset + children.length < keys.length
+            ? { nextOffset: args.offset + children.length }
+            : {}),
+    });
+    for (const key of keys.slice(args.offset, args.offset + args.limit)) {
+        const path = childPath(args.path, key);
+        (0, detailRequest_js_1.detailTokens)(path);
+        const child = Array.isArray(value) ? value[Number(key)] : value[key];
+        children.push({
+            path,
+            type: kind(child),
+            ...(container(child) ? { count: Object.keys(child).length } : {}),
+            action: { tool, args: { ref: args.ref, path } },
+        });
+        if (jsonBytes(response()) > detailRequest_js_1.DETAIL_LIMITS.outputBytes - detailRequest_js_1.DETAIL_LIMITS.reserveBytes) {
+            children.pop();
+            break;
+        }
+    }
+    if (!children.length && args.offset < keys.length)
+        return (0, detailError_js_1.unavailableDetail)();
+    return bounded(response());
+}
+exports.projectArtifactDetail = projectArtifactDetail;
+//# sourceMappingURL=detailView.js.map

package/dist/artifacts/detailView.js.map

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

package/dist/debug.js.map

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

package/dist/esm/artifacts/detailError.d.ts

@@ -0,0 +1,9 @@
+/** Fixed refusal codes: no reference, callback failure, payload or signal reason is echoed. */
+export type ArtifactDetailErrorCode = 'ERR_ARTIFACT_DETAIL_INVALID' | 'ERR_ARTIFACT_DETAIL_UNAVAILABLE' | 'ERR_ARTIFACT_DETAIL_CANCELLED';
+/** A bounded detail request was malformed, could not be admitted, or was cancelled. */
+export declare class ArtifactDetailError extends Error {
+    readonly code: ArtifactDetailErrorCode;
+    constructor(code: ArtifactDetailErrorCode);
+}
+export declare function invalidDetail(): never;
+export declare function unavailableDetail(): never;

package/dist/esm/artifacts/detailError.js

@@ -0,0 +1,21 @@
+const messages = {
+    ERR_ARTIFACT_DETAIL_INVALID: 'Invalid artifact detail request.',
+    ERR_ARTIFACT_DETAIL_UNAVAILABLE: 'Artifact detail is unavailable.',
+    ERR_ARTIFACT_DETAIL_CANCELLED: 'Artifact detail request was cancelled.',
+};
+/** A bounded detail request was malformed, could not be admitted, or was cancelled. */
+export class ArtifactDetailError extends Error {
+    code;
+    constructor(code) {
+        super(messages[code]);
+        this.code = code;
+        this.name = 'ArtifactDetailError';
+    }
+}
+export function invalidDetail() {
+    throw new ArtifactDetailError('ERR_ARTIFACT_DETAIL_INVALID');
+}
+export function unavailableDetail() {
+    throw new ArtifactDetailError('ERR_ARTIFACT_DETAIL_UNAVAILABLE');
+}
+//# sourceMappingURL=detailError.js.map

package/dist/esm/artifacts/detailError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detailError.js","sourceRoot":"","sources":["../../../src/artifacts/detailError.ts"],"names":[],"mappings":"AAMA,MAAM,QAAQ,GAAG;IACf,2BAA2B,EAAE,kCAAkC;IAC/D,+BAA+B,EAAE,iCAAiC;IAClE,6BAA6B,EAAE,wCAAwC;CAC/D,CAAC;AAEX,uFAAuF;AACvF,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACvB;IAArB,YAAqB,IAA6B;QAChD,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QADH,SAAI,GAAJ,IAAI,CAAyB;QAEhD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,UAAU,aAAa;IAC3B,MAAM,IAAI,mBAAmB,CAAC,6BAA6B,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,MAAM,IAAI,mBAAmB,CAAC,iCAAiC,CAAC,CAAC;AACnE,CAAC"}

package/dist/esm/artifacts/detailRequest.d.ts

@@ -0,0 +1,15 @@
+import type { ArtifactDetailArgs } from './detailTypes.js';
+export declare const DETAIL_LIMITS: Readonly<{
+    inputBytes: number;
+    contextBytes: 4096;
+    path: 2048;
+    depth: 16;
+    page: 20;
+    offset: 1000000;
+    valueBytes: 8192;
+    outputBytes: number;
+    reserveBytes: 512;
+}>;
+/** Strict pointer tokens, shared by request admission and child actions. */
+export declare function detailTokens(path: string): string[];
+export declare function readDetailArgs(value: unknown): Required<ArtifactDetailArgs>;

package/dist/esm/artifacts/detailRequest.js

@@ -0,0 +1,58 @@
+import { ownData } from '../lib/boundedJson.js';
+import { isArtifactRef } from './naming.js';
+import { invalidDetail } from './detailError.js';
+export const DETAIL_LIMITS = Object.freeze({
+    inputBytes: 1024 * 1024,
+    contextBytes: 4096,
+    path: 2048,
+    depth: 16,
+    page: 20,
+    offset: 1_000_000,
+    valueBytes: 8192,
+    outputBytes: 12 * 1024,
+    reserveBytes: 512,
+});
+const forbidden = new Set(['__proto__', 'prototype', 'constructor']);
+/** Strict pointer tokens, shared by request admission and child actions. */
+export function detailTokens(path) {
+    if (path === '')
+        return [];
+    if (!path.startsWith('/') || path.length > DETAIL_LIMITS.path)
+        return invalidDetail();
+    const parts = path.slice(1).split('/');
+    if (parts.length > DETAIL_LIMITS.depth)
+        return invalidDetail();
+    return parts.map((part) => {
+        // eslint-disable-next-line no-control-regex -- A pointer must not carry C0 or DEL controls.
+        if (/~(?![01])/.test(part) || /[\u0000-\u001f\u007f]/.test(part))
+            return invalidDetail();
+        const key = part.replace(/~1/g, '/').replace(/~0/g, '~');
+        if (forbidden.has(key))
+            return invalidDetail();
+        return key;
+    });
+}
+export function readDetailArgs(value) {
+    try {
+        const fields = ownData(value, ['ref', 'path', 'offset', 'limit']);
+        if (typeof fields.ref !== 'string' ||
+            !isArtifactRef(fields.ref) ||
+            typeof fields.path !== 'string')
+            return invalidDetail();
+        detailTokens(fields.path);
+        const offset = fields.offset === undefined ? 0 : fields.offset;
+        const limit = fields.limit === undefined ? DETAIL_LIMITS.page : fields.limit;
+        if (!Number.isSafeInteger(offset) ||
+            Number(offset) < 0 ||
+            Number(offset) > DETAIL_LIMITS.offset ||
+            !Number.isSafeInteger(limit) ||
+            Number(limit) < 1 ||
+            Number(limit) > DETAIL_LIMITS.page)
+            return invalidDetail();
+        return { ref: fields.ref, path: fields.path, offset: Number(offset), limit: Number(limit) };
+    }
+    catch {
+        return invalidDetail();
+    }
+}
+//# sourceMappingURL=detailRequest.js.map

package/dist/esm/artifacts/detailRequest.js.map

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

package/dist/esm/artifacts/detailTypes.d.ts

@@ -0,0 +1,49 @@
+import type { ArtifactRef } from './types.js';
+/** A reference and a bounded direct-child page, never a storage location. */
+export interface ArtifactDetailArgs {
+    readonly ref: ArtifactRef;
+    /** JSON pointer; the empty string opens the admitted root. */
+    readonly path: string;
+    readonly offset?: number;
+    readonly limit?: number;
+}
+/** An action the same mounted detail tool can execute. */
+export interface ArtifactDetailAction {
+    readonly tool: string;
+    readonly args: ArtifactDetailArgs;
+}
+/** One direct child; its value is available through its action, not implied by its name. */
+export interface ArtifactDetailChild {
+    readonly path: string;
+    readonly type: 'null' | 'boolean' | 'number' | 'string' | 'array' | 'object';
+    readonly count?: number;
+    readonly action: ArtifactDetailAction;
+}
+interface DetailBase {
+    readonly ref: ArtifactRef;
+    readonly path: string;
+    readonly kind: ArtifactDetailChild['type'];
+    /** Host presentation data, isolated from navigation fields and counted in the response limit. */
+    readonly context?: Readonly<Record<string, unknown>>;
+}
+/** A whole small value, an exact child page, or an explicitly withheld scalar. */
+export type ArtifactDetailResult = (DetailBase & {
+    readonly mode: 'value';
+    readonly value: unknown;
+    readonly complete: true;
+}) | (DetailBase & {
+    readonly mode: 'children';
+    readonly children: readonly ArtifactDetailChild[];
+    readonly offset: number;
+    readonly shown: number;
+    readonly total: number;
+    readonly complete: boolean;
+    readonly nextOffset?: number;
+}) | (DetailBase & {
+    readonly mode: 'scalar-omitted';
+    readonly omitted: true;
+    readonly scalarBytes: number;
+    readonly complete: false;
+    readonly reason: string;
+});
+export {};

package/dist/esm/artifacts/detailTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=detailTypes.js.map

package/dist/esm/artifacts/detailTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detailTypes.js","sourceRoot":"","sources":["../../../src/artifacts/detailTypes.ts"],"names":[],"mappings":""}

package/dist/esm/artifacts/detailView.d.ts

@@ -0,0 +1,3 @@
+import type { ArtifactDetailArgs, ArtifactDetailResult } from './detailTypes.js';
+/** Navigate only detached ordinary JSON; this function reads no store and authorizes no claim. */
+export declare function projectArtifactDetail(root: unknown, args: Required<ArtifactDetailArgs>, tool: string, context?: Readonly<Record<string, unknown>>): ArtifactDetailResult;

package/dist/esm/artifacts/detailView.js

@@ -0,0 +1,94 @@
+import { measureArtifactBytes } from './payload.js';
+import { DETAIL_LIMITS, detailTokens } from './detailRequest.js';
+import { invalidDetail, unavailableDetail } from './detailError.js';
+const object = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
+const container = (value) => object(value) || Array.isArray(value);
+// The payload owner counts bare strings as text; a one-element JSON array also counts quotes.
+const jsonBytes = (value) => measureArtifactBytes([value]) - 2;
+const kind = (value) => value === null
+    ? 'null'
+    : Array.isArray(value)
+        ? 'array'
+        : typeof value;
+function select(root, path) {
+    let value = root;
+    for (const key of detailTokens(path)) {
+        if (Array.isArray(value) && !/^(0|[1-9]\d*)$/.test(key))
+            return invalidDetail();
+        if (!container(value) || !Object.hasOwn(value, key))
+            return unavailableDetail();
+        value = Array.isArray(value) ? value[Number(key)] : value[key];
+    }
+    return value;
+}
+function childPath(parent, key) {
+    return `${parent}/${key.replace(/~/g, '~0').replace(/\//g, '~1')}`;
+}
+function bounded(value) {
+    if (jsonBytes(value) > DETAIL_LIMITS.outputBytes)
+        return unavailableDetail();
+    return value;
+}
+/** Navigate only detached ordinary JSON; this function reads no store and authorizes no claim. */
+export function projectArtifactDetail(root, args, tool, context) {
+    const value = select(root, args.path);
+    const base = {
+        ref: args.ref,
+        path: args.path,
+        kind: kind(value),
+        ...(context === undefined ? {} : { context }),
+    };
+    const keys = container(value) ? Object.keys(value) : [];
+    const inline = { ...base, mode: 'value', value, complete: true };
+    if (args.offset === 0 &&
+        keys.length <= args.limit &&
+        jsonBytes(value) <= DETAIL_LIMITS.valueBytes &&
+        jsonBytes(inline) <= DETAIL_LIMITS.outputBytes)
+        return inline;
+    if (!container(value)) {
+        if (args.offset !== 0)
+            return invalidDetail();
+        return bounded({
+            ...base,
+            mode: 'scalar-omitted',
+            omitted: true,
+            scalarBytes: jsonBytes(value),
+            complete: false,
+            reason: 'Selected scalar exceeds the bounded view; no partial value was returned.',
+        });
+    }
+    if (args.offset > keys.length)
+        return invalidDetail();
+    const children = [];
+    const response = () => ({
+        ...base,
+        mode: 'children',
+        children,
+        offset: args.offset,
+        shown: children.length,
+        total: keys.length,
+        complete: args.offset + children.length === keys.length,
+        ...(args.offset + children.length < keys.length
+            ? { nextOffset: args.offset + children.length }
+            : {}),
+    });
+    for (const key of keys.slice(args.offset, args.offset + args.limit)) {
+        const path = childPath(args.path, key);
+        detailTokens(path);
+        const child = Array.isArray(value) ? value[Number(key)] : value[key];
+        children.push({
+            path,
+            type: kind(child),
+            ...(container(child) ? { count: Object.keys(child).length } : {}),
+            action: { tool, args: { ref: args.ref, path } },
+        });
+        if (jsonBytes(response()) > DETAIL_LIMITS.outputBytes - DETAIL_LIMITS.reserveBytes) {
+            children.pop();
+            break;
+        }
+    }
+    if (!children.length && args.offset < keys.length)
+        return unavailableDetail();
+    return bounded(response());
+}
+//# sourceMappingURL=detailView.js.map

package/dist/esm/artifacts/detailView.js.map

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

package/dist/esm/debug.d.ts

@@ -22,7 +22,7 @@
  * symbols, one door. Import from the door.
  */
 export { adaptWeights, averageRelevancy, compositeScore, contentHash, DEFAULT_CLEAR_WINNER_MARGIN, DEFAULT_CLEAR_WINNER_RATIO, DEFAULT_INFLUENCE_WEIGHTS, DEFAULT_MARGIN_THRESHOLD, DEFAULT_PERSISTENCE_THRESHOLD, DEFAULT_SHORTLIST_BAND, EmbeddingCache, embeddingCache, finalAnswerSimilarity, attributeChoice, explainChoice, lexicalOverlapStrategy, listInfluenceStrategies, marginStrategy, pairwiseSimilarity, persistence, rankingConfidence, ratioStrategy, scoreContrastiveInfluence, scoreInfluence, scoreLexicalInfluence, scoreMargin, semanticAlignmentStrategy, snippetUnits, structuralProximity, type AttributeChoiceArgs, type AttributionUnit, type CandidateScore, type ChannelVerdict, type ChoiceAttribution, type ChoiceExplanation, type ConfidenceStrategy, type Embedder, type EmbeddingCacheOptions, type EmbeddingCacheStats, type EvidenceInput, type ExplainChoiceArgs, type InfluenceScore, type InfluenceScorer, type InfluenceStrategy, type InfluenceStrategyRequirement, type InfluenceWeights, type MarginCandidate, type MarginResult, type PairwiseSimilarityArgs, type PairwiseSimilarityResult, type RankingConfidence, type RankingConfidenceOptions, type ScoreContrastiveInfluenceArgs, type ScoreInfluenceArgs, type ScoreLexicalInfluenceArgs, type ScoreMarginArgs, type SignalScores, type SimilarityItem, type SimilarityPair, type SnippetUnitsOptions, type UnitScore, } from './influence-core/index.js';
-export { callTraceTool, lazyTraceToolpack, NO_COMPLETED_RUN_MESSAGE, TOOLPACK_HARD_CAPS, TRACE_TOOL_NAMES, traceToolpack, type TraceToolpackArtifacts, type TraceToolpackOptions, } from './trace-toolpack/index.js';
+export { callTraceTool, lazyTraceToolpack, NO_COMPLETED_RUN_MESSAGE, TOOLPACK_HARD_CAPS, TRACE_TOOL_NAMES, traceToolpack, type TraceToolpackArtifacts, type TraceToolpackOptions, type TraceCauseArtifacts, type TraceCauseOptions, type TraceCauseOperation, } from './trace-toolpack/index.js';
 export { openRecording, type OpenableRecording } from './trace-toolpack/index.js';
 export { DEFAULT_INNER_RUN_LIMIT, INNER_RUN_RECORDS, innerRunStore, innerRunsOf, mergeInnerRuns, type InnerRunLookup, type InnerRunOutcome, type InnerRunRecord, type InnerRunStore, type InnerRunSummary, type KeepsInnerRuns, } from './trace-toolpack/index.js';
 export { buildSelfExplainSkill, buildSelfExplainToolProvider, SELF_EXPLAIN_MAX_EVENTS, SelfExplainBinding, traceDebugAgent, type SelfExplainInclude, type SelfExplainOptions, type SelfExplainServing, type SelfExplainSource, type TraceDebugAgentOptions, } from './trace-toolpack/index.js';

package/dist/esm/debug.js.map

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

package/dist/esm/index.d.ts

@@ -60,6 +60,9 @@ export { MemberIdentityError, ParentRunRefusedError, ResumeRequestConflictError,
 export { flowchartAsTool, type FlowchartAsToolOptions, type FlowchartResultMapper, type FlowchartToolSnapshot, } from './core/flowchartAsTool.js';
 export { absenceSignalOf, DECLINED_VERDICT, DEFAULT_MAX_ROWS, DEFAULT_RECORDING_MAX_BYTES, DEFAULT_WALK_CAP, PANEL_RENDER_NOTE, probeDispatch, projectWalk, recordingDispatch, renderVerdictTable, runbookAsTool, RunbookAbsenceSignal, VERDICT_RENDER_NOTE, verdictRowsOf, type InnerCallRecord, type ProjectedWalk, type RecordedDispatch, type RunbookAsToolOptions, type RunbookEnvelope, type RunbookPresentation, type RunbookProcedure, type RunbookRecordingOptions, type RunbookRules, type RunbookVerdictsOptions, type RunbookWalkOptions, type VerdictRow, type WalkDescriptor, type WalkRow, } from './core/runbook/index.js';
 export type { Tool, ToolExecutionContext, ToolRegistryEntry, DefineToolOptions, ToolDispatch, ToolDispatchCallOptions, ToolResultCeiling, } from './tools/tools.js';
+export { artifactDetailTool, type ArtifactDetailOptions } from './tools/artifactDetailTool.js';
+export { ArtifactDetailError, type ArtifactDetailErrorCode } from './artifacts/detailError.js';
+export type { ArtifactDetailAction, ArtifactDetailArgs, ArtifactDetailChild, ArtifactDetailResult, } from './artifacts/detailTypes.js';
 export type { AskOrAssume, ToolPeriod } from './tools/declare.js';
 export { defineTool, assertResultCeiling, assertResultClass, assertResultKind, assertComposedOf, assertGates, } from './tools/tools.js';
 export { hostFilled, fromCredential, fromIdentity, HostFilledArgumentError, HostFilledValueMissingError, HOST_FILLED_PLACEHOLDER, type HostFill, type HostFillFromCredential, type HostFillFromIdentity, type HostFilledIdentityField, } from './tools/hostFilled.js';

package/dist/esm/index.js

@@ -285,6 +285,8 @@ export { absenceSignalOf, DECLINED_VERDICT, DEFAULT_MAX_ROWS,
 // and a bundle over this many bytes is REFUSED (never truncated) with the
 // reason stated on `walk.recording_note`.
 DEFAULT_RECORDING_MAX_BYTES, DEFAULT_WALK_CAP, PANEL_RENDER_NOTE, probeDispatch, projectWalk, recordingDispatch, renderVerdictTable, runbookAsTool, RunbookAbsenceSignal, VERDICT_RENDER_NOTE, verdictRowsOf, } from './core/runbook/index.js';
+export { artifactDetailTool } from './tools/artifactDetailTool.js';
+export { ArtifactDetailError } from './artifacts/detailError.js';
 export { defineTool, assertResultCeiling, assertResultClass, 
 // The placed-result kind (9.70.0) — `Tool.resultKind` lets a tool declare
 // the artifact kind its PLACED result is minted under, so the ticket speaks