@intentic/sandbox-contract 1.310.0 → 1.312.0

package/dist/contracts/workspace.contract.js

@@ -3,9 +3,10 @@ import { WorkspaceHealthQuerySchema, WorkspaceHealthSchema } from "../schemas/co
 import { WorkspaceModulesSchema } from "../schemas/git/git.js";
 import { OkSchema } from "../schemas/shared.js";
 import { AddAppsSchema, AppParamSchema, AppsListSchema, CloneRepoSchema, CreateRepoSchema, CloneResultSchema, RepoAppsParamSchema, ReposListSchema, RunTestsSchema, TemplatesListSchema, WorkspaceGraphSchema, WorkspaceSyncSchema, } from "../schemas/workspace/workspace-repos.js";
+import { MainlinePushDismissResultSchema, MainlinePushDismissSchema, MainlinePushRecheckResultSchema, MainlinePushRecheckSchema, MainlineStatusSchema, } from "../schemas/workspace/mainline.js";
 import { WorkspaceSearchQuerySchema, WorkspaceSearchResultSchema } from "../schemas/workspace/workspace-search.js";
 import { WorkspaceInstallResultSchema, WorkspaceInstallSchema, WorkspaceSetupSchema } from "../schemas/workspace/workspace-setup.js";
-import { WorkspaceChildrenQuerySchema, WorkspaceChildrenSchema, WorkspaceClassificationSchema, SidecarStatusSchema, WorkspaceDerivedQuerySchema, WorkspaceDerivedSchema, WorkspaceDirSchema, WorkspaceExtractSchema, WorkspaceFileQuerySchema, WorkspaceFileReadQuerySchema, WorkspaceFileSchema, WorkspaceMediaTicketQuerySchema, WorkspaceMediaTicketSchema, WorkspaceMoveSchema, WorkspaceResolveQuerySchema, WorkspaceResolveSchema, WorkspaceScopeSchema, WorkspaceTreeSchema, } from "../schemas/workspace/workspace-tree.js";
+import { WorkspaceChildrenQuerySchema, WorkspaceChildrenSchema, WorkspaceClassificationSchema, SidecarStatusSchema, WorkspaceDerivedQuerySchema, WorkspaceDerivedSchema, WorkspaceDeletedSchema, WorkspaceDirSchema, WorkspaceExtractSchema, WorkspaceRestoredSchema, WorkspaceRestoreSchema, WorkspaceFileQuerySchema, WorkspaceFileReadQuerySchema, WorkspaceFileSchema, WorkspaceMediaTicketQuerySchema, WorkspaceMediaTicketSchema, WorkspaceMoveSchema, WorkspaceResolveQuerySchema, WorkspaceResolveSchema, WorkspaceScopeSchema, WorkspaceTreeSchema, } from "../schemas/workspace/workspace-tree.js";
 export const workspaceContract = {
     tree: procedure
         .route({
@@ -128,11 +129,21 @@ export const workspaceContract = {
         method: "DELETE",
         path: "/workspace/entry",
         summary: "Delete a file or folder",
-        description: "Removes one entry and everything under it. The path travels in the body rather than the address, the same as every other write in this group.",
+        description: "Removes one entry and everything under it. It goes to the trash rather than being erased, and the answer carries the id that brings it back through the restore call for a day. The path travels in the body rather than the address, the same as every other write in this group.",
     })
         .meta({ floor: "writer" })
         .input(WorkspaceFileQuerySchema)
-        .output(OkSchema),
+        .output(WorkspaceDeletedSchema),
+    restore: procedure
+        .route({
+        method: "POST",
+        path: "/workspace/restore",
+        summary: "Bring back something deleted",
+        description: "Puts an entry a delete sent to the trash back where it was, recreating the folders above it. Nothing is written over: when something new holds the name, it comes back beside it and the answer says where. Trash older than a day is gone.",
+    })
+        .meta({ floor: "writer" })
+        .input(WorkspaceRestoreSchema)
+        .output(WorkspaceRestoredSchema),
     move: procedure
         .route({
         method: "POST",
@@ -180,6 +191,32 @@ export const workspaceContract = {
     })
         .input(WorkspaceInstallSchema)
         .output(WorkspaceInstallResultSchema),
+    mainline: procedure
+        .route({
+        method: "GET",
+        path: "/workspace/mainline",
+        summary: "The checks that run after work lands",
+        description: "What the main tree's own check is measuring right now, which landed work waits for the next run, what the last run in each project said, and what became of a red one: sent back to the conversation that landed it, handed to a fresh conversation, or waiting on one still working. Nothing here ever holds a land, a commit or a push.",
+    })
+        .output(MainlineStatusSchema),
+    mainlinePushDismiss: procedure
+        .route({
+        method: "POST",
+        path: "/workspace/mainline/push/dismiss",
+        summary: "Set aside what a push left behind",
+        description: "Marks findings a push check let through as not to be fixed, so they stop counting against the project, or opens dismissed ones again. Nothing is changed in the code.",
+    })
+        .input(MainlinePushDismissSchema)
+        .output(MainlinePushDismissResultSchema),
+    mainlinePushRecheck: procedure
+        .route({
+        method: "POST",
+        path: "/workspace/mainline/push/recheck",
+        summary: "Measure what a push left behind again",
+        description: "Runs the project's own push measurement over its main tree now and resolves every open finding it no longer prints. A few seconds; nothing is pushed.",
+    })
+        .input(MainlinePushRecheckSchema)
+        .output(MainlinePushRecheckResultSchema),
     repos: procedure
         .route({
         method: "GET",

package/dist/contracts/workspace.contract.js.map

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

package/dist/documents/conversions.d.ts

@@ -0,0 +1,81 @@
+export type JsonObject = Record<string, unknown>;
+export declare const isJsonObject: (value: unknown) => value is JsonObject;
+export interface ConversionChange {
+    readonly conversion: string;
+    readonly at: string;
+    readonly detail?: string;
+}
+interface ConversionBase<Kind extends string> {
+    readonly kind: Kind;
+    readonly describe: string;
+}
+export interface RenameConversion<From extends string = string, To extends string = string> extends ConversionBase<"rename"> {
+    readonly from: From;
+    readonly to: To;
+}
+export interface DropConversion<Key extends string = string> extends ConversionBase<"drop"> {
+    readonly key: Key;
+}
+export interface RetypeConversion<Key extends string = string, In = unknown, Out = unknown> extends ConversionBase<"retype"> {
+    readonly key: Key;
+    readonly guard: (value: unknown) => value is In;
+    convert(value: In): Out;
+}
+export interface MapValueConversion<Key extends string = string, Mapping extends Readonly<Record<string, unknown>> = Readonly<Record<string, unknown>>> extends ConversionBase<"mapValue"> {
+    readonly key: Key;
+    readonly mapping: Mapping;
+}
+export interface PinDefaultConversion<Key extends string = string, Value = unknown> extends ConversionBase<"pinDefault"> {
+    readonly key: Key;
+    readonly value: Value;
+}
+export interface TransformConversion<In extends JsonObject = JsonObject, Out extends JsonObject = JsonObject> extends ConversionBase<"transform"> {
+    readonly applies: (value: JsonObject) => value is In;
+    convert(value: In): Out;
+}
+export interface FoldConversion<From extends string = string, Into extends string = string, Out = unknown> extends ConversionBase<"fold"> {
+    readonly from: readonly From[];
+    readonly into: Into;
+    readonly applies: (value: JsonObject) => boolean;
+    convert(fields: Readonly<Partial<Record<From, unknown>>>, whole: JsonObject): Out;
+}
+export interface RetireEntriesConversion<Retired = unknown> extends ConversionBase<"retireEntries"> {
+    readonly isRetired: (entry: unknown) => entry is Retired;
+}
+export interface AtConversion<Path extends string = string, Inner = unknown> extends ConversionBase<"at"> {
+    readonly path: Path;
+    readonly inner: Inner;
+}
+export type Conversion = RenameConversion | DropConversion | RetypeConversion | MapValueConversion | PinDefaultConversion | TransformConversion | FoldConversion | RetireEntriesConversion | AtConversion<string, Conversion>;
+export type Granularity = "object" | "entries" | "record";
+export declare const rename: <const From extends string, const To extends string>(from: From, to: To) => RenameConversion<From, To>;
+export declare const drop: <const Key extends string>(key: Key) => DropConversion<Key>;
+export declare const retype: <const Key extends string, In, Out>(key: Key, guard: (value: unknown) => value is In, convert: (value: In) => Out, describe?: string) => RetypeConversion<Key, In, Out>;
+export declare const mapValue: <const Key extends string, const Mapping extends Readonly<Record<string, unknown>>>(key: Key, mapping: Mapping) => MapValueConversion<Key, Mapping>;
+export declare const pinDefault: <const Key extends string, const Value>(key: Key, value: Value) => PinDefaultConversion<Key, Value>;
+export declare const transform: <In extends JsonObject, Out extends JsonObject>(describe: string, applies: (value: JsonObject) => value is In, convert: (value: In) => Out) => TransformConversion<In, Out>;
+export declare const fold: <const From extends string, const Into extends string, Out>(describe: string, shape: {
+    readonly from: readonly From[];
+    readonly into: Into;
+    readonly applies: (value: JsonObject) => boolean;
+    readonly convert: (fields: Readonly<Partial<Record<From, unknown>>>, whole: JsonObject) => Out;
+}) => FoldConversion<From, Into, Out>;
+export declare const dropAll: <const Keys extends readonly string[]>(keys: Keys) => { readonly [I in keyof Keys]: DropConversion<Keys[I] & string>; };
+type Nested<Path extends string, History extends readonly Conversion[], Entries extends boolean> = {
+    readonly [I in keyof History]: History[I] extends RetireEntriesConversion ? AtConversion<Path, History[I]> : AtConversion<Entries extends true ? `${Path}.*` : Path, History[I]>;
+};
+export declare const nested: <const Path extends string, const History extends readonly Conversion[], const Entries extends boolean = false>(path: Path, history: History, entries?: Entries) => Nested<Path, History, Entries>;
+export declare const retireEntries: <Retired>(describe: string, isRetired: (entry: unknown) => entry is Retired) => RetireEntriesConversion<Retired>;
+export declare const at: <const Path extends string, const Inner extends Conversion>(path: Path, inner: Inner) => AtConversion<Path, Inner>;
+export declare class ConversionError extends Error {
+    readonly conversion: string;
+    constructor(conversion: string, cause: unknown);
+}
+export interface Converted {
+    readonly value: unknown;
+    readonly changes: readonly ConversionChange[];
+}
+export declare const convertDocument: (conversions: readonly Conversion[], granularity: Granularity, raw: unknown, checkSettles?: boolean) => Converted;
+export declare const describeConversions: (conversions: readonly Conversion[]) => string[];
+export {};
+//# sourceMappingURL=conversions.d.ts.map

package/dist/documents/conversions.d.ts.map

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

package/dist/documents/conversions.js

@@ -0,0 +1,213 @@
+export const isJsonObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const glimpse = (value) => {
+    const spelled = String(JSON.stringify(value));
+    return spelled.length > 80 ? `${spelled.slice(0, 77)}…` : spelled;
+};
+const renamedKey = (target, from, to) => Object.fromEntries(Object.entries(target).map(([key, value]) => [key === from ? to : key, value]));
+const withoutKey = (target, key) => Object.fromEntries(Object.entries(target).filter(([name]) => name !== key));
+export const rename = (from, to) => ({
+    kind: "rename",
+    describe: `renames ${from} to ${to}`,
+    from,
+    to,
+});
+export const drop = (key) => ({ kind: "drop", describe: `drops ${key}`, key });
+export const retype = (key, guard, convert, describe = `converts ${key} to its new form`) => ({ kind: "retype", describe, key, guard, convert });
+export const mapValue = (key, mapping) => {
+    const cyclic = Object.values(mapping).filter((mapped) => typeof mapped === "string" && Object.hasOwn(mapping, mapped));
+    if (cyclic.length > 0) {
+        throw new Error(`mapValue(${key}) maps onto its own keys (${cyclic.join(", ")}), so it would not settle`);
+    }
+    return { kind: "mapValue", describe: `converts ${key} from its old values`, key, mapping };
+};
+export const pinDefault = (key, value) => ({
+    kind: "pinDefault",
+    describe: `keeps the earlier default for ${key}`,
+    key,
+    value,
+});
+export const transform = (describe, applies, convert) => ({ kind: "transform", describe, applies, convert });
+export const fold = (describe, shape) => ({ kind: "fold", describe, from: shape.from, into: shape.into, applies: shape.applies, convert: shape.convert });
+export const dropAll = (keys) => keys.map((key) => drop(key));
+export const nested = (path, history, entries) => history.map((conversion) => at(conversion.kind === "retireEntries" || entries !== true ? path : `${path}.*`, conversion));
+export const retireEntries = (describe, isRetired) => ({
+    kind: "retireEntries",
+    describe,
+    isRetired,
+});
+export const at = (path, inner) => ({
+    kind: "at",
+    describe: `${inner.describe} under ${path}`,
+    path,
+    inner,
+});
+const applyToObject = (conversion, target, where, report) => {
+    switch (conversion.kind) {
+        case "rename": {
+            if (!Object.hasOwn(target, conversion.from)) {
+                return target;
+            }
+            if (!Object.hasOwn(target, conversion.to)) {
+                report({ conversion: conversion.describe, at: where });
+                return renamedKey(target, conversion.from, conversion.to);
+            }
+            if (JSON.stringify(target[conversion.from]) === JSON.stringify(target[conversion.to])) {
+                return withoutKey(target, conversion.from);
+            }
+            report({ conversion: conversion.describe, at: where, detail: `kept ${conversion.to}; ${conversion.from} held ${glimpse(target[conversion.from])}` });
+            return withoutKey(target, conversion.from);
+        }
+        case "drop": {
+            if (!Object.hasOwn(target, conversion.key)) {
+                return target;
+            }
+            report({ conversion: conversion.describe, at: where, detail: `it held ${glimpse(target[conversion.key])}` });
+            return withoutKey(target, conversion.key);
+        }
+        case "retype": {
+            const value = target[conversion.key];
+            if (!Object.hasOwn(target, conversion.key) || !conversion.guard(value)) {
+                return target;
+            }
+            report({ conversion: conversion.describe, at: where });
+            return { ...target, [conversion.key]: conversion.convert(value) };
+        }
+        case "mapValue": {
+            const value = target[conversion.key];
+            if (typeof value !== "string" || !Object.hasOwn(conversion.mapping, value)) {
+                return target;
+            }
+            report({ conversion: conversion.describe, at: where, detail: `${glimpse(value)} became ${glimpse(conversion.mapping[value])}` });
+            return { ...target, [conversion.key]: conversion.mapping[value] };
+        }
+        case "pinDefault": {
+            if (Object.hasOwn(target, conversion.key)) {
+                return target;
+            }
+            report({ conversion: conversion.describe, at: where });
+            return { ...target, [conversion.key]: conversion.value };
+        }
+        case "transform": {
+            if (!conversion.applies(target)) {
+                return target;
+            }
+            report({ conversion: conversion.describe, at: where });
+            return conversion.convert(target);
+        }
+        case "fold":
+            return applyFold(conversion, target, where, report);
+        case "retireEntries":
+            return target;
+        case "at":
+            return applyAt(conversion.inner, conversion.path.split("."), target, where, report);
+    }
+};
+const applyFold = (conversion, target, where, report) => {
+    if (!conversion.applies(target)) {
+        return target;
+    }
+    const folded = new Set(conversion.from);
+    const fields = Object.fromEntries(Object.entries(target).filter(([key]) => folded.has(key)));
+    const entries = Object.entries(target);
+    const first = entries.findIndex(([key]) => folded.has(key));
+    const kept = entries.filter(([key]) => !folded.has(key) && key !== conversion.into);
+    kept.splice(first === -1 ? kept.length : Math.min(first, kept.length), 0, [conversion.into, conversion.convert(fields, target)]);
+    report({ conversion: conversion.describe, at: where });
+    return Object.fromEntries(kept);
+};
+const retireFrom = (conversion, container, where, report) => {
+    const retired = (entry, place) => {
+        if (!conversion.isRetired(entry)) {
+            return false;
+        }
+        report({ conversion: conversion.describe, at: place, detail: glimpse(entry) });
+        return true;
+    };
+    if (Array.isArray(container)) {
+        const kept = container.filter((entry, index) => !retired(entry, joinWhere(where, `[${index}]`)));
+        return kept.length === container.length ? container : kept;
+    }
+    if (!isJsonObject(container)) {
+        return container;
+    }
+    const kept = Object.entries(container).filter(([key, entry]) => !retired(entry, joinWhere(where, key)));
+    return kept.length === Object.keys(container).length ? container : Object.fromEntries(kept);
+};
+const joinWhere = (where, segment) => (segment.startsWith("[") || where === "" ? `${where}${segment}` : `${where}.${segment}`);
+const applyToEach = (visit, container, where) => {
+    if (Array.isArray(container)) {
+        const next = container.map((value, index) => visit(value, joinWhere(where, `[${index}]`)));
+        return next.some((value, index) => value !== container[index]) ? next : container;
+    }
+    if (!isJsonObject(container)) {
+        return container;
+    }
+    const entries = Object.entries(container);
+    const next = entries.map(([key, value]) => [key, visit(value, joinWhere(where, key))]);
+    return next.some(([, value], index) => value !== entries[index]?.[1]) ? Object.fromEntries(next) : container;
+};
+const applyAt = (inner, segments, value, where, report) => {
+    const [head, ...rest] = segments;
+    if (head === undefined) {
+        if (inner.kind === "retireEntries") {
+            return retireFrom(inner, value, where, report);
+        }
+        return isJsonObject(value) ? applyToObject(inner, value, where, report) : value;
+    }
+    if (head === "*") {
+        return applyToEach((element, elementWhere) => applyAt(inner, rest, element, elementWhere, report), value, where);
+    }
+    if (!isJsonObject(value) || !Object.hasOwn(value, head)) {
+        return value;
+    }
+    const child = value[head];
+    const next = applyAt(inner, rest, child, joinWhere(where, head), report);
+    return next === child ? value : { ...value, [head]: next };
+};
+const applyOne = (conversion, granularity, value, report) => {
+    if (conversion.kind === "retireEntries" && granularity !== "object") {
+        return retireFrom(conversion, value, "", report);
+    }
+    if (granularity === "object") {
+        return isJsonObject(value) ? applyToObject(conversion, value, "", report) : value;
+    }
+    const container = granularity === "entries" ? Array.isArray(value) : isJsonObject(value);
+    return container ? applyToEach((entry, where) => (isJsonObject(entry) ? applyToObject(conversion, entry, where, report) : entry), value, "") : value;
+};
+export class ConversionError extends Error {
+    conversion;
+    constructor(conversion, cause) {
+        super(`conversion "${conversion}" failed: ${cause instanceof Error ? cause.message : String(cause)}`, { cause });
+        this.name = "ConversionError";
+        this.conversion = conversion;
+    }
+}
+const applyAll = (conversions, granularity, raw, report) => {
+    let value = raw;
+    for (const conversion of conversions) {
+        try {
+            value = applyOne(conversion, granularity, value, report);
+        }
+        catch (error) {
+            throw new ConversionError(conversion.describe, error);
+        }
+    }
+    return value;
+};
+export const convertDocument = (conversions, granularity, raw, checkSettles = false) => {
+    if (conversions.length === 0) {
+        return { value: raw, changes: [] };
+    }
+    const changes = [];
+    const value = applyAll(conversions, granularity, raw, (change) => changes.push(change));
+    if (checkSettles && changes.length > 0) {
+        const again = [];
+        const settled = applyAll(conversions, granularity, value, (change) => again.push(change));
+        if (settled !== value || again.length > 0) {
+            throw new ConversionError(again[0]?.conversion ?? "unknown", new Error("it changed its own output, so it would run on every read"));
+        }
+    }
+    return { value, changes };
+};
+export const describeConversions = (conversions) => conversions.map((conversion) => conversion.describe);
+//# sourceMappingURL=conversions.js.map

package/dist/documents/conversions.js.map

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

package/dist/documents/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./conversions.js";
+export * from "./passthrough.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/documents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/documents/index.ts"],"names":[],"mappings":"AAGA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/dist/documents/index.js

@@ -0,0 +1,3 @@
+export * from "./conversions.js";
+export * from "./passthrough.js";
+//# sourceMappingURL=index.js.map

package/dist/documents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/documents/index.ts"],"names":[],"mappings":"AAGA,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC"}

package/dist/documents/passthrough.d.ts

@@ -0,0 +1,13 @@
+export type IdKeys = readonly string[];
+export declare const carryUnknown: (raw: unknown, parsed: unknown, updated: unknown, idKeys?: IdKeys) => unknown;
+export interface EntryRead<E> {
+    readonly entries: E[];
+    readonly aligned: readonly unknown[];
+    readonly quarantined: readonly {
+        readonly index: number;
+        readonly entry: unknown;
+    }[];
+}
+export declare const readEntries: <E>(raw: readonly unknown[], parseEntry: (entry: unknown) => E | undefined) => EntryRead<E>;
+export declare const reemitQuarantined: (updated: readonly unknown[], quarantined: EntryRead<unknown>["quarantined"], idKeys?: IdKeys) => readonly unknown[];
+//# sourceMappingURL=passthrough.d.ts.map

package/dist/documents/passthrough.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"passthrough.d.ts","sourceRoot":"","sources":["../../src/documents/passthrough.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;AAuEvC,eAAO,MAAM,YAAY,QAAS,OAAO,UAAU,OAAO,WAAW,OAAO,WAAU,MAAM,KAAqB,OAQhH,CAAC;AAIF,MAAM,WAAW,SAAS,CAAC,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,SAAS;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;CACxF;AAED,eAAO,MAAM,WAAW,GAAI,CAAC,OAAO,SAAS,OAAO,EAAE,cAAc,CAAC,KAAK,EAAE,OAAO,KAAK,CAAC,GAAG,SAAS,KAAG,SAAS,CAAC,CAAC,CAclH,CAAC;AAIF,eAAO,MAAM,iBAAiB,YACjB,SAAS,OAAO,EAAE,eACd,SAAS,CAAC,OAAO,CAAC,CAAC,aAAa,CAAC,WACtC,MAAM,KACf,SAAS,OAAO,EAWlB,CAAC"}

package/dist/documents/passthrough.js

@@ -0,0 +1,101 @@
+import { isJsonObject } from "./conversions.js";
+const DISCRIMINATORS = ["kind", "type"];
+const sameArm = (parsed, updated) => DISCRIMINATORS.every((key) => typeof parsed[key] !== "string" || parsed[key] === updated[key]);
+const DEFAULT_ID_KEYS = ["id"];
+const carryObject = (raw, parsed, updated, idKeys) => {
+    if (!sameArm(parsed, updated)) {
+        return updated;
+    }
+    let result;
+    for (const [key, value] of Object.entries(raw)) {
+        if (!Object.hasOwn(updated, key)) {
+            if (!Object.hasOwn(parsed, key)) {
+                result ??= { ...updated };
+                result[key] = value;
+            }
+            continue;
+        }
+        if (Object.hasOwn(parsed, key)) {
+            const carried = carryUnknown(value, parsed[key], updated[key], idKeys);
+            if (carried !== updated[key]) {
+                result ??= { ...updated };
+                result[key] = carried;
+            }
+        }
+    }
+    return result ?? updated;
+};
+const idOf = (value, idKeys) => {
+    if (!isJsonObject(value)) {
+        return undefined;
+    }
+    const id = idKeys.map((key) => value[key]).find((candidate) => typeof candidate === "string");
+    return typeof id === "string" ? id : undefined;
+};
+const carryArray = (raw, parsed, updated, idKeys) => {
+    if (raw.length !== parsed.length) {
+        return updated;
+    }
+    const rawOfParsed = new Map();
+    const indexOfId = new Map();
+    parsed.forEach((element, index) => {
+        if (typeof element === "object" && element !== null) {
+            rawOfParsed.set(element, raw[index]);
+        }
+        const id = idOf(element, idKeys);
+        if (id !== undefined) {
+            indexOfId.set(id, index);
+        }
+    });
+    let result;
+    updated.forEach((element, index) => {
+        const byId = indexOfId.get(idOf(element, idKeys) ?? "");
+        const [source, before] = rawOfParsed.has(element) ? [rawOfParsed.get(element), element] : byId === undefined ? [undefined, undefined] : [raw[byId], parsed[byId]];
+        if (source === undefined) {
+            return;
+        }
+        const carried = carryUnknown(source, before, element, idKeys);
+        if (carried !== element) {
+            result ??= [...updated];
+            result[index] = carried;
+        }
+    });
+    return result ?? updated;
+};
+export const carryUnknown = (raw, parsed, updated, idKeys = DEFAULT_ID_KEYS) => {
+    if (isJsonObject(raw) && isJsonObject(parsed) && isJsonObject(updated)) {
+        return carryObject(raw, parsed, updated, idKeys);
+    }
+    if (Array.isArray(raw) && Array.isArray(parsed) && Array.isArray(updated)) {
+        return carryArray(raw, parsed, updated, idKeys);
+    }
+    return updated;
+};
+export const readEntries = (raw, parseEntry) => {
+    const entries = [];
+    const aligned = [];
+    const quarantined = [];
+    raw.forEach((entry, index) => {
+        const parsed = parseEntry(entry);
+        if (parsed === undefined) {
+            quarantined.push({ index, entry });
+            return;
+        }
+        entries.push(parsed);
+        aligned.push(entry);
+    });
+    return { entries, aligned, quarantined };
+};
+export const reemitQuarantined = (updated, quarantined, idKeys = DEFAULT_ID_KEYS) => {
+    const written = new Set(updated.map((entry) => idOf(entry, idKeys)).filter((id) => id !== undefined));
+    const kept = quarantined.filter(({ entry }) => !written.has(idOf(entry, idKeys) ?? "\u0000"));
+    if (kept.length === 0) {
+        return updated;
+    }
+    const result = [...updated];
+    for (const { index, entry } of kept) {
+        result.splice(Math.min(index, result.length), 0, entry);
+    }
+    return result;
+};
+//# sourceMappingURL=passthrough.js.map

package/dist/documents/passthrough.js.map

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

package/dist/events/agent-events.d.ts

@@ -49,6 +49,10 @@ export declare const AgentEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"init">;
     model: z.ZodString;
+    prompt: z.ZodOptional<z.ZodObject<{
+        hash: z.ZodString;
+        parts: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<{
     kind: z.ZodLiteral<"checkpoint">;
     id: z.ZodString;
@@ -213,6 +217,17 @@ export declare const AgentEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     cacheCreationTokens: z.ZodOptional<z.ZodNumber>;
     durationMs: z.ZodOptional<z.ZodNumber>;
     numTurns: z.ZodOptional<z.ZodNumber>;
+    openingCacheReadTokens: z.ZodOptional<z.ZodNumber>;
+    openingCacheCreationTokens: z.ZodOptional<z.ZodNumber>;
+    promptFingerprint: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    readTokens: z.ZodNumber;
+    writtenTokens: z.ZodNumber;
+    kept: z.ZodOptional<z.ZodObject<{
+        forMs: z.ZodNumber;
+        refreshes: z.ZodNumber;
+    }, z.core.$strip>>;
+    kind: z.ZodLiteral<"prompt_cache">;
 }, z.core.$strip>, z.ZodObject<{
     status: z.ZodEnum<{
         allowed: "allowed";
@@ -1332,6 +1347,11 @@ export declare const AttachFrameSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         op: z.ZodLiteral<"thinking">;
         index: z.ZodNumber;
         text: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        op: z.ZodLiteral<"toolThinking">;
+        index: z.ZodNumber;
+        id: z.ZodString;
+        text: z.ZodString;
     }, z.core.$strip>, z.ZodObject<{
         op: z.ZodLiteral<"tool">;
         index: z.ZodNumber;