@ny4n/durable 0.0.0-stage → 1.0.0

package/dist/documents.d.ts

@@ -0,0 +1,66 @@
+import { type JsonValue } from "@ny4n/chord";
+import type { Op } from "@ny4n/chord/delta";
+import type { CheckpointInfo, CommonDocDefinition, ConversationDocFamilyToken, ConversationDocToken, DocumentAddress, DocumentCreate, DocumentId, DocumentRecord, DocumentSemantics, JsonObject, LatestConversationSemantics, RewindableConversationDocFamilyToken, RewindableConversationDocToken, RewindableConversationSemantics, SessionDocFamilyToken, SessionDocToken, StoredDocument, TaskDocFamilyToken, TaskDocToken } from "./types.ts";
+type FamilyInput<T extends JsonObject, I extends JsonValue> = Omit<CommonDocDefinition<T>, "initial"> & {
+    readonly family: true;
+    initial(seed: I): T;
+};
+/** Define a Session-scoped singleton document. */
+export declare function defineDoc<T extends JsonObject>(definition: CommonDocDefinition<T> & {
+    readonly scope: "session";
+}): SessionDocToken<T>;
+/** Define a latest-only conversation singleton document. */
+export declare function defineDoc<T extends JsonObject>(definition: CommonDocDefinition<T> & LatestConversationSemantics): ConversationDocToken<T>;
+/** Define a rewindable conversation singleton document. */
+export declare function defineDoc<T extends JsonObject>(definition: CommonDocDefinition<T> & RewindableConversationSemantics): RewindableConversationDocToken<T>;
+/** Define a task-scoped singleton document. */
+export declare function defineDoc<T extends JsonObject>(definition: CommonDocDefinition<T> & {
+    readonly scope: "task";
+}): TaskDocToken<T>;
+/** Define a Session-scoped document family. */
+export declare function defineDocFamily<T extends JsonObject, I extends JsonValue>(definition: FamilyInput<T, I> & {
+    readonly scope: "session";
+}): SessionDocFamilyToken<T, I>;
+/** Define a latest-only conversation document family. */
+export declare function defineDocFamily<T extends JsonObject, I extends JsonValue>(definition: FamilyInput<T, I> & LatestConversationSemantics): ConversationDocFamilyToken<T, I>;
+/** Define a rewindable conversation document family. */
+export declare function defineDocFamily<T extends JsonObject, I extends JsonValue>(definition: FamilyInput<T, I> & RewindableConversationSemantics): RewindableConversationDocFamilyToken<T, I>;
+/** Define a task-scoped document family. */
+export declare function defineDocFamily<T extends JsonObject, I extends JsonValue>(definition: FamilyInput<T, I> & {
+    readonly scope: "task";
+}): TaskDocFamilyToken<T, I>;
+/** Erased definition shape used by the Session after overload resolution. */
+export type AnyDocDefinition = DocumentSemantics & {
+    readonly kind: string;
+    readonly version: number;
+    readonly family?: true;
+    initial(seed?: JsonValue): JsonObject;
+    migrate?(value: JsonObject, fromVersion: number): JsonObject;
+    checkpointWhen?(value: Readonly<JsonObject>, ops: readonly Op[], info: CheckpointInfo): boolean;
+};
+/** Erased singleton or family token. */
+export type AnyDocToken = {
+    readonly definition: AnyDocDefinition;
+};
+/** Logical address plus its string identity for maps. */
+export type ResolvedAddress = {
+    readonly address: DocumentAddress;
+    readonly id: string;
+    readonly nextArgument: number;
+};
+/** Resolve an overloaded argument list and return the index after the owner and family key. */
+export declare function resolveAddress(definition: AnyDocDefinition, args: readonly unknown[]): ResolvedAddress;
+/** Stable string identity of one logical address. */
+export declare function addressId(address: DocumentAddress): string;
+/** Build the storage create record for a new incarnation at an address. */
+export declare function documentCreate(definition: AnyDocDefinition, address: DocumentAddress, id: DocumentId): DocumentCreate;
+/** Reject typed access whose token disagrees with the persisted scope, history, or fork semantics. */
+export declare function checkRecordScope(definition: AnyDocDefinition, record: DocumentCreate | DocumentRecord): void;
+/** Reject typed access to a stored version the supplied definition cannot use. */
+export declare function checkRecordVersion(definition: AnyDocDefinition, record: DocumentCreate | DocumentRecord, version: number): void;
+/** Validate and materialize a detached stored value for typed access. */
+export declare function materializeDocument(definition: AnyDocDefinition, stored: StoredDocument): JsonObject;
+/** Validate and materialize one detached value before its first persisted incarnation. */
+export declare function materializeDocumentValue(definition: AnyDocDefinition, record: DocumentCreate | DocumentRecord, version: number, value: JsonObject): JsonObject;
+export {};
+//# sourceMappingURL=documents.d.ts.map

package/dist/documents.d.ts.map

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

package/dist/documents.js

@@ -0,0 +1,98 @@
+import { copyJson } from "@ny4n/chord";
+import { idFromNumber } from "./ids.js";
+export function defineDoc(definition) {
+    validateDefinition(definition);
+    return { definition };
+}
+export function defineDocFamily(definition) {
+    validateDefinition(definition);
+    return { definition };
+}
+function validateDefinition(definition) {
+    if (!Number.isSafeInteger(definition.version) || definition.version < 1) {
+        throw new TypeError(`Document ${definition.kind} version must be a positive integer`);
+    }
+}
+/** Resolve an overloaded argument list and return the index after the owner and family key. */
+export function resolveAddress(definition, args) {
+    let index = 0;
+    let scope;
+    switch (definition.scope) {
+        case "session":
+            scope = { kind: "session" };
+            break;
+        case "conversation":
+            scope = { kind: "conversation", conversationId: ownerId(args[index++], definition) };
+            break;
+        case "task":
+            scope = { kind: "task", taskId: ownerId(args[index++], definition) };
+            break;
+    }
+    const key = definition.family === true ? args[index++] : undefined;
+    const address = key === undefined ? { kind: definition.kind, scope } : { kind: definition.kind, scope, key };
+    return { address, id: addressId(address), nextArgument: index };
+}
+function ownerId(value, definition) {
+    if (typeof value !== "number" || !Number.isSafeInteger(value)) {
+        throw new TypeError(`Document ${definition.kind} requires a ${definition.scope} ID`);
+    }
+    return idFromNumber(value);
+}
+/** Stable string identity of one logical address. */
+export function addressId(address) {
+    const owner = address.scope.kind === "session"
+        ? null
+        : address.scope.kind === "conversation"
+            ? address.scope.conversationId
+            : address.scope.taskId;
+    return JSON.stringify([address.kind, address.scope.kind, owner, address.key ?? null]);
+}
+/** Build the storage create record for a new incarnation at an address. */
+export function documentCreate(definition, address, id) {
+    const key = address.key === undefined ? {} : { key: address.key };
+    switch (address.scope.kind) {
+        case "session":
+            return { id, kind: address.kind, ...key, scope: address.scope };
+        case "task":
+            return { id, kind: address.kind, ...key, scope: address.scope };
+        case "conversation":
+            return {
+                id,
+                kind: address.kind,
+                ...key,
+                scope: address.scope,
+                history: definition.history,
+                fork: definition.fork,
+            };
+    }
+}
+/** Reject typed access whose token disagrees with the persisted scope, history, or fork semantics. */
+export function checkRecordScope(definition, record) {
+    if (record.scope.kind !== definition.scope ||
+        (record.scope.kind === "conversation" &&
+            (record.history !== definition.history || record.fork !== definition.fork))) {
+        throw new TypeError(`Document ${record.id} (${record.kind}) does not match the supplied definition semantics`);
+    }
+}
+/** Reject typed access to a stored version the supplied definition cannot use. */
+export function checkRecordVersion(definition, record, version) {
+    if (version > definition.version) {
+        throw new Error(`Document ${record.id} (${record.kind}) has newer version ${version} than ${definition.version}`);
+    }
+    if (version < definition.version && definition.migrate === undefined) {
+        throw new Error(`Document ${record.id} (${record.kind}) requires migration from version ${version}`);
+    }
+}
+/** Validate and materialize a detached stored value for typed access. */
+export function materializeDocument(definition, stored) {
+    return materializeDocumentValue(definition, stored.record, stored.version, stored.value);
+}
+/** Validate and materialize one detached value before its first persisted incarnation. */
+export function materializeDocumentValue(definition, record, version, value) {
+    checkRecordScope(definition, record);
+    checkRecordVersion(definition, record, version);
+    if (version === definition.version)
+        return value;
+    return copyJson(definition.migrate(value, version));
+}
+//# sourceMappingURL=documents.js.map

package/dist/documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.js","sourceRoot":"","sources":["../src/documents.ts"],"names":[],"mappings":"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","sourcesContent":["import { copyJson, type JsonValue } from \"@ny4n/chord\";\nimport type { Op } from \"@ny4n/chord/delta\";\nimport { idFromNumber } from \"./ids.ts\";\nimport type {\n\tCheckpointInfo,\n\tCommonDocDefinition,\n\tConversationDocFamilyToken,\n\tConversationDocToken,\n\tConversationId,\n\tDocDefinition,\n\tDocFamilyDefinition,\n\tDocFamilyToken,\n\tDocToken,\n\tDocumentAddress,\n\tDocumentCreate,\n\tDocumentId,\n\tDocumentRecord,\n\tDocumentSemantics,\n\tId,\n\tJsonObject,\n\tLatestConversationSemantics,\n\tRewindableConversationDocFamilyToken,\n\tRewindableConversationDocToken,\n\tRewindableConversationSemantics,\n\tSessionDocFamilyToken,\n\tSessionDocToken,\n\tStoredDocument,\n\tTaskDocFamilyToken,\n\tTaskDocToken,\n\tTaskId,\n} from \"./types.ts\";\n\ntype FamilyInput<T extends JsonObject, I extends JsonValue> = Omit<CommonDocDefinition<T>, \"initial\"> & {\n\treadonly family: true;\n\tinitial(seed: I): T;\n};\n\n/** Define a Session-scoped singleton document. */\nexport function defineDoc<T extends JsonObject>(\n\tdefinition: CommonDocDefinition<T> & { readonly scope: \"session\" },\n): SessionDocToken<T>;\n/** Define a latest-only conversation singleton document. */\nexport function defineDoc<T extends JsonObject>(\n\tdefinition: CommonDocDefinition<T> & LatestConversationSemantics,\n): ConversationDocToken<T>;\n/** Define a rewindable conversation singleton document. */\nexport function defineDoc<T extends JsonObject>(\n\tdefinition: CommonDocDefinition<T> & RewindableConversationSemantics,\n): RewindableConversationDocToken<T>;\n/** Define a task-scoped singleton document. */\nexport function defineDoc<T extends JsonObject>(\n\tdefinition: CommonDocDefinition<T> & { readonly scope: \"task\" },\n): TaskDocToken<T>;\nexport function defineDoc<T extends JsonObject>(definition: DocDefinition<T>): DocToken<T, DocDefinition<T>> {\n\tvalidateDefinition(definition);\n\treturn { definition };\n}\n\n/** Define a Session-scoped document family. */\nexport function defineDocFamily<T extends JsonObject, I extends JsonValue>(\n\tdefinition: FamilyInput<T, I> & { readonly scope: \"session\" },\n): SessionDocFamilyToken<T, I>;\n/** Define a latest-only conversation document family. */\nexport function defineDocFamily<T extends JsonObject, I extends JsonValue>(\n\tdefinition: FamilyInput<T, I> & LatestConversationSemantics,\n): ConversationDocFamilyToken<T, I>;\n/** Define a rewindable conversation document family. */\nexport function defineDocFamily<T extends JsonObject, I extends JsonValue>(\n\tdefinition: FamilyInput<T, I> & RewindableConversationSemantics,\n): RewindableConversationDocFamilyToken<T, I>;\n/** Define a task-scoped document family. */\nexport function defineDocFamily<T extends JsonObject, I extends JsonValue>(\n\tdefinition: FamilyInput<T, I> & { readonly scope: \"task\" },\n): TaskDocFamilyToken<T, I>;\nexport function defineDocFamily<T extends JsonObject, I extends JsonValue>(\n\tdefinition: DocFamilyDefinition<T, I>,\n): DocFamilyToken<T, I, DocFamilyDefinition<T, I>> {\n\tvalidateDefinition(definition);\n\treturn { definition };\n}\n\n/** Erased definition shape used by the Session after overload resolution. */\nexport type AnyDocDefinition = DocumentSemantics & {\n\treadonly kind: string;\n\treadonly version: number;\n\treadonly family?: true;\n\tinitial(seed?: JsonValue): JsonObject;\n\tmigrate?(value: JsonObject, fromVersion: number): JsonObject;\n\tcheckpointWhen?(value: Readonly<JsonObject>, ops: readonly Op[], info: CheckpointInfo): boolean;\n};\n\n/** Erased singleton or family token. */\nexport type AnyDocToken = { readonly definition: AnyDocDefinition };\n\nfunction validateDefinition(definition: AnyDocDefinition): void {\n\tif (!Number.isSafeInteger(definition.version) || definition.version < 1) {\n\t\tthrow new TypeError(`Document ${definition.kind} version must be a positive integer`);\n\t}\n}\n\n/** Logical address plus its string identity for maps. */\nexport type ResolvedAddress = {\n\treadonly address: DocumentAddress;\n\treadonly id: string;\n\treadonly nextArgument: number;\n};\n\n/** Resolve an overloaded argument list and return the index after the owner and family key. */\nexport function resolveAddress(definition: AnyDocDefinition, args: readonly unknown[]): ResolvedAddress {\n\tlet index = 0;\n\tlet scope: DocumentAddress[\"scope\"];\n\tswitch (definition.scope) {\n\t\tcase \"session\":\n\t\t\tscope = { kind: \"session\" };\n\t\t\tbreak;\n\t\tcase \"conversation\":\n\t\t\tscope = { kind: \"conversation\", conversationId: ownerId<ConversationId>(args[index++], definition) };\n\t\t\tbreak;\n\t\tcase \"task\":\n\t\t\tscope = { kind: \"task\", taskId: ownerId<TaskId>(args[index++], definition) };\n\t\t\tbreak;\n\t}\n\tconst key = definition.family === true ? (args[index++] as string) : undefined;\n\tconst address: DocumentAddress =\n\t\tkey === undefined ? { kind: definition.kind, scope } : { kind: definition.kind, scope, key };\n\treturn { address, id: addressId(address), nextArgument: index };\n}\n\nfunction ownerId<I extends Id<string>>(value: unknown, definition: AnyDocDefinition): I {\n\tif (typeof value !== \"number\" || !Number.isSafeInteger(value)) {\n\t\tthrow new TypeError(`Document ${definition.kind} requires a ${definition.scope} ID`);\n\t}\n\treturn idFromNumber<I>(value);\n}\n\n/** Stable string identity of one logical address. */\nexport function addressId(address: DocumentAddress): string {\n\tconst owner =\n\t\taddress.scope.kind === \"session\"\n\t\t\t? null\n\t\t\t: address.scope.kind === \"conversation\"\n\t\t\t\t? address.scope.conversationId\n\t\t\t\t: address.scope.taskId;\n\treturn JSON.stringify([address.kind, address.scope.kind, owner, address.key ?? null]);\n}\n\n/** Build the storage create record for a new incarnation at an address. */\nexport function documentCreate(definition: AnyDocDefinition, address: DocumentAddress, id: DocumentId): DocumentCreate {\n\tconst key = address.key === undefined ? {} : { key: address.key };\n\tswitch (address.scope.kind) {\n\t\tcase \"session\":\n\t\t\treturn { id, kind: address.kind, ...key, scope: address.scope };\n\t\tcase \"task\":\n\t\t\treturn { id, kind: address.kind, ...key, scope: address.scope };\n\t\tcase \"conversation\":\n\t\t\treturn {\n\t\t\t\tid,\n\t\t\t\tkind: address.kind,\n\t\t\t\t...key,\n\t\t\t\tscope: address.scope,\n\t\t\t\thistory: definition.history!,\n\t\t\t\tfork: definition.fork!,\n\t\t\t} as DocumentCreate;\n\t}\n}\n\n/** Reject typed access whose token disagrees with the persisted scope, history, or fork semantics. */\nexport function checkRecordScope(definition: AnyDocDefinition, record: DocumentCreate | DocumentRecord): void {\n\tif (\n\t\trecord.scope.kind !== definition.scope ||\n\t\t(record.scope.kind === \"conversation\" &&\n\t\t\t(record.history !== definition.history || record.fork !== definition.fork))\n\t) {\n\t\tthrow new TypeError(`Document ${record.id} (${record.kind}) does not match the supplied definition semantics`);\n\t}\n}\n\n/** Reject typed access to a stored version the supplied definition cannot use. */\nexport function checkRecordVersion(\n\tdefinition: AnyDocDefinition,\n\trecord: DocumentCreate | DocumentRecord,\n\tversion: number,\n): void {\n\tif (version > definition.version) {\n\t\tthrow new Error(`Document ${record.id} (${record.kind}) has newer version ${version} than ${definition.version}`);\n\t}\n\tif (version < definition.version && definition.migrate === undefined) {\n\t\tthrow new Error(`Document ${record.id} (${record.kind}) requires migration from version ${version}`);\n\t}\n}\n\n/** Validate and materialize a detached stored value for typed access. */\nexport function materializeDocument(definition: AnyDocDefinition, stored: StoredDocument): JsonObject {\n\treturn materializeDocumentValue(definition, stored.record, stored.version, stored.value);\n}\n\n/** Validate and materialize one detached value before its first persisted incarnation. */\nexport function materializeDocumentValue(\n\tdefinition: AnyDocDefinition,\n\trecord: DocumentCreate | DocumentRecord,\n\tversion: number,\n\tvalue: JsonObject,\n): JsonObject {\n\tcheckRecordScope(definition, record);\n\tcheckRecordVersion(definition, record, version);\n\tif (version === definition.version) return value;\n\treturn copyJson(definition.migrate!(value, version)) as JsonObject;\n}\n"]}

package/dist/entries.d.ts

@@ -0,0 +1,31 @@
+import type { JsonValue } from "@ny4n/chord";
+import type { CompactionReason, ToolDiagnostic } from "./harness/types.ts";
+import type { Entry } from "./types.ts";
+/** Define a typed entry kind whose `is()` guard narrows by `EntryRecord.kind`. */
+export declare function defineEntry<D extends JsonValue = never>(kind: string): Entry<D>;
+/** User input: `model` is `[UserMessage]`. Written by submissions. */
+export declare const UserEntry: Entry<never>;
+/** Provider result with any stop reason: `model` is `[AssistantMessage]`. Written by generation. */
+export declare const AssistantEntry: Entry<never>;
+/** Positional prompt and tool change: `model` is `[SystemMessage]` with empty `content`. */
+export declare const SystemEntry: Entry<never>;
+/**
+ * Tool result: `model` is `[ToolResultMessage]`, whose content ends with the rendered diagnostics block; `data` holds
+ * the structured diagnostics, possibly none. Written by tool tasks, and by generation for calls it did not offer.
+ */
+export declare const ToolResultEntry: Entry<{
+    diagnostics: ToolDiagnostic[];
+}>;
+/**
+ * Start of a new context: always `head: "self"`, with `model` absent for a plain reset or `[UserMessage]` carrying the
+ * handoff text. Written by `Conversation.reset()` and the `handoff` tool control.
+ */
+export declare const ResetEntry: Entry<never>;
+/**
+ * Compaction summary: `model` is `[UserMessage]` with the wrapped summary, `head` the first kept entry. Written by
+ * compaction tasks, directly or through a write submission.
+ */
+export declare const CompactionEntry: Entry<{
+    reason: CompactionReason;
+}>;
+//# sourceMappingURL=entries.d.ts.map

package/dist/entries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entries.d.ts","sourceRoot":"","sources":["../src/entries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,KAAK,EAAE,KAAK,EAA2B,MAAM,YAAY,CAAC;AAEjE,kFAAkF;AAClF,wBAAgB,WAAW,CAAC,CAAC,SAAS,SAAS,GAAG,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAM/E;AAED,sEAAsE;AACtE,eAAO,MAAM,SAAS,cAA2B,CAAC;AAClD,oGAAoG;AACpG,eAAO,MAAM,cAAc,cAAgC,CAAC;AAC5D,4FAA4F;AAC5F,eAAO,MAAM,WAAW,cAA6B,CAAC;AACtD;;;GAGG;AACH,eAAO,MAAM,eAAe;iBAA8B,cAAc,EAAE;EAAuB,CAAC;AAClG;;;GAGG;AACH,eAAO,MAAM,UAAU,cAA4B,CAAC;AACpD;;;GAGG;AACH,eAAO,MAAM,eAAe;YAAyB,gBAAgB;EAAsB,CAAC"}

package/dist/entries.js

@@ -0,0 +1,31 @@
+/** Define a typed entry kind whose `is()` guard narrows by `EntryRecord.kind`. */
+export function defineEntry(kind) {
+    if (typeof kind !== "string" || kind.length === 0)
+        throw new TypeError("Entry kind must be a non-empty string");
+    return {
+        kind,
+        is: (entry) => entry !== undefined && entry.kind === kind,
+    };
+}
+/** User input: `model` is `[UserMessage]`. Written by submissions. */
+export const UserEntry = defineEntry("nyan.user");
+/** Provider result with any stop reason: `model` is `[AssistantMessage]`. Written by generation. */
+export const AssistantEntry = defineEntry("nyan.assistant");
+/** Positional prompt and tool change: `model` is `[SystemMessage]` with empty `content`. */
+export const SystemEntry = defineEntry("nyan.system");
+/**
+ * Tool result: `model` is `[ToolResultMessage]`, whose content ends with the rendered diagnostics block; `data` holds
+ * the structured diagnostics, possibly none. Written by tool tasks, and by generation for calls it did not offer.
+ */
+export const ToolResultEntry = defineEntry("nyan.tool-result");
+/**
+ * Start of a new context: always `head: "self"`, with `model` absent for a plain reset or `[UserMessage]` carrying the
+ * handoff text. Written by `Conversation.reset()` and the `handoff` tool control.
+ */
+export const ResetEntry = defineEntry("nyan.reset");
+/**
+ * Compaction summary: `model` is `[UserMessage]` with the wrapped summary, `head` the first kept entry. Written by
+ * compaction tasks, directly or through a write submission.
+ */
+export const CompactionEntry = defineEntry("nyan.compaction");
+//# sourceMappingURL=entries.js.map

package/dist/entries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entries.js","sourceRoot":"","sources":["../src/entries.ts"],"names":[],"mappings":"AAIA,kFAAkF;AAClF,MAAM,UAAU,WAAW,CAA8B,IAAY;IACpE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,uCAAuC,CAAC,CAAC;IAChH,OAAO;QACN,IAAI;QACJ,EAAE,EAAE,CAAC,KAA8B,EAA0B,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI;KAC1G,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;AAClD,oGAAoG;AACpG,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAC,gBAAgB,CAAC,CAAC;AAC5D,4FAA4F;AAC5F,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;AACtD;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAoC,kBAAkB,CAAC,CAAC;AAClG;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;AACpD;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAA+B,iBAAiB,CAAC,CAAC","sourcesContent":["import type { JsonValue } from \"@ny4n/chord\";\nimport type { CompactionReason, ToolDiagnostic } from \"./harness/types.ts\";\nimport type { Entry, EntryRecord, TypedEntry } from \"./types.ts\";\n\n/** Define a typed entry kind whose `is()` guard narrows by `EntryRecord.kind`. */\nexport function defineEntry<D extends JsonValue = never>(kind: string): Entry<D> {\n\tif (typeof kind !== \"string\" || kind.length === 0) throw new TypeError(\"Entry kind must be a non-empty string\");\n\treturn {\n\t\tkind,\n\t\tis: (entry: EntryRecord | undefined): entry is TypedEntry<D> => entry !== undefined && entry.kind === kind,\n\t};\n}\n\n/** User input: `model` is `[UserMessage]`. Written by submissions. */\nexport const UserEntry = defineEntry(\"nyan.user\");\n/** Provider result with any stop reason: `model` is `[AssistantMessage]`. Written by generation. */\nexport const AssistantEntry = defineEntry(\"nyan.assistant\");\n/** Positional prompt and tool change: `model` is `[SystemMessage]` with empty `content`. */\nexport const SystemEntry = defineEntry(\"nyan.system\");\n/**\n * Tool result: `model` is `[ToolResultMessage]`, whose content ends with the rendered diagnostics block; `data` holds\n * the structured diagnostics, possibly none. Written by tool tasks, and by generation for calls it did not offer.\n */\nexport const ToolResultEntry = defineEntry<{ diagnostics: ToolDiagnostic[] }>(\"nyan.tool-result\");\n/**\n * Start of a new context: always `head: \"self\"`, with `model` absent for a plain reset or `[UserMessage]` carrying the\n * handoff text. Written by `Conversation.reset()` and the `handoff` tool control.\n */\nexport const ResetEntry = defineEntry(\"nyan.reset\");\n/**\n * Compaction summary: `model` is `[UserMessage]` with the wrapped summary, `head` the first kept entry. Written by\n * compaction tasks, directly or through a write submission.\n */\nexport const CompactionEntry = defineEntry<{ reason: CompactionReason }>(\"nyan.compaction\");\n"]}

package/dist/env/decode.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Decoding that matches `new TextDecoder().decode(bytes)` of the whole input when the input arrives in pieces. Node's
+ * streaming decoder with BOM handling can drop a U+FEFF that follows a chunk boundary, not only a leading byte-order
+ * mark, so these decoders turn BOM handling off and drop a leading mark themselves.
+ */
+/** A streaming decoder for a byte range; callers that start at the beginning of a file skip a leading mark themselves. */
+export declare function rangeDecoder(): InstanceType<typeof TextDecoder>;
+/** Whether decoding the whole input drops its first three bytes as a byte-order mark. */
+export declare function startsWithBom(firstBytes: Uint8Array): boolean;
+/** Decodes one stream chunk by chunk exactly like decoding all of it at once. */
+export declare class StreamDecoder {
+    #private;
+    /** Text for `bytes`, holding back an incomplete character; without `bytes`, the end of the stream. */
+    decode(bytes?: Uint8Array): string;
+}
+//# sourceMappingURL=decode.d.ts.map

package/dist/env/decode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.d.ts","sourceRoot":"","sources":["../../src/env/decode.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,0HAA0H;AAC1H,wBAAgB,YAAY,IAAI,YAAY,CAAC,OAAO,WAAW,CAAC,CAE/D;AAED,yFAAyF;AACzF,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAE7D;AAED,iFAAiF;AACjF,qBAAa,aAAa;;IAIzB,sGAAsG;IACtG,MAAM,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,MAAM,CAMjC;CACD"}

package/dist/env/decode.js

@@ -0,0 +1,28 @@
+/**
+ * Decoding that matches `new TextDecoder().decode(bytes)` of the whole input when the input arrives in pieces. Node's
+ * streaming decoder with BOM handling can drop a U+FEFF that follows a chunk boundary, not only a leading byte-order
+ * mark, so these decoders turn BOM handling off and drop a leading mark themselves.
+ */
+/** A streaming decoder for a byte range; callers that start at the beginning of a file skip a leading mark themselves. */
+export function rangeDecoder() {
+    return new TextDecoder("utf-8", { ignoreBOM: true });
+}
+/** Whether decoding the whole input drops its first three bytes as a byte-order mark. */
+export function startsWithBom(firstBytes) {
+    return firstBytes[0] === 0xef && firstBytes[1] === 0xbb && firstBytes[2] === 0xbf;
+}
+/** Decodes one stream chunk by chunk exactly like decoding all of it at once. */
+export class StreamDecoder {
+    #decoder = rangeDecoder();
+    #started = false;
+    /** Text for `bytes`, holding back an incomplete character; without `bytes`, the end of the stream. */
+    decode(bytes) {
+        const text = bytes === undefined ? this.#decoder.decode() : this.#decoder.decode(bytes, { stream: true });
+        if (this.#started || text === "")
+            return text;
+        this.#started = true;
+        // U+FEFF encodes only as EF BB BF, so a leading U+FEFF is exactly a byte-order mark at the stream's start.
+        return text.startsWith("\ufeff") ? text.slice(1) : text;
+    }
+}
+//# sourceMappingURL=decode.js.map

package/dist/env/decode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decode.js","sourceRoot":"","sources":["../../src/env/decode.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,0HAA0H;AAC1H,MAAM,UAAU,YAAY;IAC3B,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,aAAa,CAAC,UAAsB;IACnD,OAAO,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AACnF,CAAC;AAED,iFAAiF;AACjF,MAAM,OAAO,aAAa;IAChB,QAAQ,GAAG,YAAY,EAAE,CAAC;IACnC,QAAQ,GAAG,KAAK,CAAC;IAEjB,sGAAsG;IACtG,MAAM,CAAC,KAAkB;QACxB,MAAM,IAAI,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1G,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,KAAK,EAAE;YAAE,OAAO,IAAI,CAAC;QAC9C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,2GAA2G;QAC3G,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzD,CAAC;CACD","sourcesContent":["/**\n * Decoding that matches `new TextDecoder().decode(bytes)` of the whole input when the input arrives in pieces. Node's\n * streaming decoder with BOM handling can drop a U+FEFF that follows a chunk boundary, not only a leading byte-order\n * mark, so these decoders turn BOM handling off and drop a leading mark themselves.\n */\n\n/** A streaming decoder for a byte range; callers that start at the beginning of a file skip a leading mark themselves. */\nexport function rangeDecoder(): InstanceType<typeof TextDecoder> {\n\treturn new TextDecoder(\"utf-8\", { ignoreBOM: true });\n}\n\n/** Whether decoding the whole input drops its first three bytes as a byte-order mark. */\nexport function startsWithBom(firstBytes: Uint8Array): boolean {\n\treturn firstBytes[0] === 0xef && firstBytes[1] === 0xbb && firstBytes[2] === 0xbf;\n}\n\n/** Decodes one stream chunk by chunk exactly like decoding all of it at once. */\nexport class StreamDecoder {\n\treadonly #decoder = rangeDecoder();\n\t#started = false;\n\n\t/** Text for `bytes`, holding back an incomplete character; without `bytes`, the end of the stream. */\n\tdecode(bytes?: Uint8Array): string {\n\t\tconst text = bytes === undefined ? this.#decoder.decode() : this.#decoder.decode(bytes, { stream: true });\n\t\tif (this.#started || text === \"\") return text;\n\t\tthis.#started = true;\n\t\t// U+FEFF encodes only as EF BB BF, so a leading U+FEFF is exactly a byte-order mark at the stream's start.\n\t\treturn text.startsWith(\"\\ufeff\") ? text.slice(1) : text;\n\t}\n}\n"]}

package/dist/env/index.d.ts

@@ -0,0 +1,263 @@
+import type { Context } from "@ny4n/chord";
+/** Result of a fallible operation. Expected failures are returned instead of thrown. */
+export type Result<TValue, TError> = {
+    ok: true;
+    value: TValue;
+} | {
+    ok: false;
+    error: TError;
+};
+export declare function ok<TValue, TError>(value: TValue): Result<TValue, TError>;
+export declare function err<TValue, TError>(error: TError): Result<TValue, TError>;
+export declare function getOrThrow<TValue, TError>(result: Result<TValue, TError>): TValue;
+export declare function getOrUndefined<TValue extends object, TError>(result: Result<TValue, TError>): TValue | undefined;
+export declare function toError(error: unknown): Error;
+export type FileKind = "file" | "directory" | "symlink";
+export type FileErrorCode = "aborted" | "not_found" | "permission_denied" | "not_directory" | "is_directory" | "invalid" | "not_supported" | "unknown";
+export declare class FileError extends Error {
+    code: FileErrorCode;
+    path?: string;
+    constructor(code: FileErrorCode, message: string, path?: string, cause?: Error);
+}
+export type ExecutionErrorCode = "aborted" | "timeout" | "shell_unavailable" | "spawn_error" | "callback_error" | "unknown";
+export declare class ExecutionError extends Error {
+    code: ExecutionErrorCode;
+    /** Spill file of a command that timed out or was aborted after its output crossed the spill thresholds. */
+    spillPath?: string;
+    constructor(code: ExecutionErrorCode, message: string, cause?: Error);
+}
+export interface FileInfo {
+    name: string;
+    path: string;
+    kind: FileKind;
+    size: number;
+    mtimeMs: number;
+}
+export interface TextLine {
+    text: string;
+    terminated: boolean;
+}
+export interface TextLineReader {
+    readLine(context: Context): Promise<Result<TextLine | undefined, FileError>>;
+    close(context: Context): Promise<void>;
+}
+/** Positional reads from one opened regular file; all calls see the same file even if its path is renamed. */
+export interface BinaryReader {
+    /** Metadata of the opened file, not of whatever its path names now. */
+    info(context: Context): Promise<Result<FileInfo, FileError>>;
+    /** Up to `length` bytes at `offset`; fewer only at end of file. */
+    read(offset: number, length: number, context: Context): Promise<Result<Uint8Array, FileError>>;
+    /**
+     * One pass over the file that locates lines `[startLine, endLine)` (`endLine` absent: to the end), 0-based, where line
+     * `k` starts after the `k`-th newline byte. Decoded sizes are those of the text `new TextDecoder().decode(file)` would
+     * produce for that range, so a byte-order mark at the start of the file is not counted.
+     */
+    scanLines(options: {
+        startLine: number;
+        endLine?: number;
+    }, context: Context): Promise<Result<LineScan, FileError>>;
+    close(context: Context): Promise<void>;
+}
+/** A file or directory to watch. It may be missing; creating it is a change. */
+export interface WatchTarget {
+    path: string;
+    /** Watch everything below a directory, not only its entries. Symbolic links below it are not followed. */
+    recursive?: boolean;
+    /** Entries below `path` that are neither watched nor reported: names starting with `.`, or these names. */
+    exclude?: {
+        hidden?: boolean;
+        names?: readonly string[];
+    };
+}
+/**
+ * What changed:
+ * - `paths`: something at or below each path may have changed (a directory path covers its whole subtree). Calls may be
+ *   spurious; a change is never missed while the watcher is healthy.
+ * - `overflow`: coverage was uncertain for a while (lost events, reconnect); rescan everything that is watched.
+ * - `error`: the watcher stopped, for example because the watched tree grew past the environment's limit; no calls
+ *   follow.
+ */
+export type WatchChange = {
+    paths: string[];
+} | {
+    overflow: true;
+} | {
+    error: FileError;
+};
+export interface FileWatcher {
+    /**
+     * `native`: changes are reported within about two seconds. `polling`: the environment compares snapshots, because
+     * the file system does not report changes reliably (network and FUSE file systems); a change undone between two
+     * snapshots can be missed.
+     */
+    readonly mode: "native" | "polling";
+    /** Stop watching; no `onChange` call starts after this resolves. Idempotent. */
+    close(context: Context): Promise<void>;
+}
+/** Where lines of a file are, as `BinaryReader.scanLines` found them. */
+export interface LineScan {
+    /** Newline bytes in the whole file; it has `newlines + 1` lines. */
+    newlines: number;
+    /**
+     * Byte range of the selected lines: from the start of the first to the end of the last, without the newline that
+     * ends it. A selection past the last line is empty at the end of the file.
+     */
+    start: number;
+    end: number;
+    /** Where the first selected line ends: its newline, or the end of the file. */
+    firstLineEnd: number;
+    /** Where the last selected line starts. */
+    lastLineStart: number;
+    /** UTF-8 byte length of the decoded selection and of its first line. */
+    selectedBytes: number;
+    firstLineBytes: number;
+}
+/** Pages of one directory's entries. */
+export interface DirReader {
+    /**
+     * Up to `maxEntries` entries in the order the file system returns them, continuing where the previous call stopped.
+     * `done` marks the end; it may come with the last entries or with an empty page. An entry that disappears before its
+     * metadata is read is skipped, as are entries of unsupported kinds. After a failed or aborted call, close the reader.
+     */
+    next(maxEntries: number, context: Context): Promise<Result<{
+        entries: FileInfo[];
+        done: boolean;
+    }, FileError>>;
+    close(context: Context): Promise<void>;
+}
+/** Portable filesystem capability. Operations return failures rather than throwing. */
+export interface FileSystem {
+    /**
+     * The file namespace: equal ids see the same files at the same paths, whatever their `cwd`. Every local Node
+     * environment shares one id; each container or remote host has its own.
+     */
+    readonly id: string;
+    cwd: string;
+    absolutePath(path: string, context: Context): Promise<Result<string, FileError>>;
+    joinPath(parts: string[], context: Context): Promise<Result<string, FileError>>;
+    readTextFile(path: string, context: Context): Promise<Result<string, FileError>>;
+    openTextLineReader(path: string, context: Context): Promise<Result<TextLineReader, FileError>>;
+    readTextLines(path: string, options: {
+        maxLines?: number;
+    } | undefined, context: Context): Promise<Result<string[], FileError>>;
+    readBinaryFile(path: string, context: Context): Promise<Result<Uint8Array, FileError>>;
+    /**
+     * Open a regular file for bounded positional reads. A directory fails with `is_directory`, other non-regular files
+     * with `invalid`. With `noFollow`, a symbolic link as the final path component fails with `invalid` instead of being
+     * followed; earlier components are still resolved.
+     */
+    openBinaryReader(path: string, options: {
+        noFollow?: boolean;
+    } | undefined, context: Context): Promise<Result<BinaryReader, FileError>>;
+    writeFile(path: string, content: string | Uint8Array, context: Context): Promise<Result<void, FileError>>;
+    appendFile(path: string, content: string | Uint8Array, context: Context): Promise<Result<void, FileError>>;
+    /** Truncate or extend a file to exactly `size` bytes. */
+    truncateFile(path: string, size: number, context: Context): Promise<Result<void, FileError>>;
+    /** Flush file contents and metadata needed to retrieve them from an open file handle. */
+    flushFile(path: string, context: Context): Promise<Result<void, FileError>>;
+    renameFile(sourcePath: string, destinationPath: string, context: Context): Promise<Result<void, FileError>>;
+    fileInfo(path: string, context: Context): Promise<Result<FileInfo, FileError>>;
+    listDir(path: string, context: Context): Promise<Result<FileInfo[], FileError>>;
+    openDirReader(path: string, context: Context): Promise<Result<DirReader, FileError>>;
+    /**
+     * Report changes to files and directories, for hosts that load resources from the environment. When the returned
+     * watcher exists, coverage is established: a host that watches before it loads cannot miss a change made during the
+     * load. See `WatchChange` for what is reported and `FileWatcher.mode` for how reliably.
+     */
+    watch(targets: readonly WatchTarget[], onChange: (change: WatchChange) => void, context: Context): Promise<Result<FileWatcher, FileError>>;
+    canonicalPath(path: string, context: Context): Promise<Result<string, FileError>>;
+    exists(path: string, context: Context): Promise<Result<boolean, FileError>>;
+    createDir(path: string, options: {
+        recursive?: boolean;
+    } | undefined, context: Context): Promise<Result<void, FileError>>;
+    remove(path: string, options: {
+        recursive?: boolean;
+        force?: boolean;
+    } | undefined, context: Context): Promise<Result<void, FileError>>;
+    createTempDir(prefix: string | undefined, context: Context): Promise<Result<string, FileError>>;
+    createTempFile(options: {
+        prefix?: string;
+        suffix?: string;
+    } | undefined, context: Context): Promise<Result<string, FileError>>;
+    cleanup(context: Context): Promise<void>;
+}
+/** Spill the complete output to a temporary file once it exceeds either threshold. */
+export interface ShellSpillOptions {
+    afterBytes: number;
+    /** Complete or partial lines. */
+    afterLines: number;
+}
+export interface ShellExecResult {
+    exitCode: number;
+    /** Temporary file holding the complete raw output, when the spill thresholds were exceeded. */
+    spillPath?: string;
+}
+export interface ShellExecOptions {
+    cwd?: string;
+    env?: Record<string, string>;
+    inheritEnv?: boolean;
+    timeout?: number;
+    /**
+     * Every decoded chunk of stdout and stderr as it arrives, in arrival order, with the stream it came from: raw,
+     * unbounded, and unthrottled. Each stream is decoded separately, so a character split across chunks survives.
+     */
+    onOutput?: (text: string, context: Context, info: ShellOutputInfo) => void;
+    spill?: ShellSpillOptions;
+    /**
+     * The caller keeps only this tail of the output, so the environment may omit output outside it and report the omission
+     * as `info.skipped`. Without it, every chunk is delivered.
+     */
+    window?: ShellOutputWindow;
+}
+/**
+ * The tail of the combined output a caller keeps, and how often it samples it. An environment that transfers output
+ * over a slow link uses it to omit what the caller would drop anyway and to send no faster than the caller commits.
+ */
+export interface ShellOutputWindow {
+    /** UTF-8 bytes of decoded text kept at the end of the output. */
+    maxBytes: number;
+    /** Lines kept at the end of the output. */
+    maxLines: number;
+    /** Minimum pause between the caller's samples of the output. */
+    minIntervalMs: number;
+    /** Each sample also pauses the caller in proportion to its size at this rate. */
+    bytesPerSecond: number;
+}
+/**
+ * Output an environment omitted, measured on the decoded text `onOutput` would have received: every U+FFFD counts as
+ * three bytes, and no sanitizing is applied.
+ */
+export interface ShellOutputSkip {
+    /** UTF-8 byte length of the omitted text. */
+    bytes: number;
+    /** Newlines (U+000A) in the omitted text. */
+    newlines: number;
+    /** Whether the omitted text ends with a newline. */
+    endsWithNewline: boolean;
+}
+export interface ShellOutputInfo {
+    stream: "stdout" | "stderr";
+    /**
+     * Output omitted immediately before this chunk, only with `window`. The chunk then holds all output after the
+     * omission up to its end, and that is more than the window by at least one byte or one line: more than
+     * `window.maxBytes` bytes or more than `window.maxLines` newlines. So the omitted text can never be in the kept tail.
+     * The omission and such a chunk may span both streams in arrival order; `stream` then names the chunk's last stream.
+     * Callers that need the streams apart do not pass `window`.
+     */
+    skipped?: ShellOutputSkip;
+}
+export interface Shell {
+    /**
+     * Run a command. A string runs through the environment's shell. An array runs `command[0]` directly with the rest
+     * as its arguments, without a shell, so they reach the program unparsed. Aborting the context or a timeout kills
+     * only this command's processes.
+     */
+    exec(command: string | readonly string[], options: ShellExecOptions | undefined, context: Context): Promise<Result<ShellExecResult, ExecutionError>>;
+    /** Kill every command this environment still runs; for its owner's shutdown, never for one request. */
+    cleanup(context: Context): Promise<void>;
+}
+export interface ExecutionEnv extends FileSystem, Shell {
+}
+export { rangeDecoder, StreamDecoder, startsWithBom } from "./decode.ts";
+export { LineScanner } from "./line-scan.ts";
+//# sourceMappingURL=index.d.ts.map

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

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