@earendil-works/pi-agent-core 0.99.1 → 1.0.0

package/dist/harness/session/values.d.ts

@@ -1,95 +0,0 @@
-import type { AssistantMessageFrame } from "@earendil-works/pi-ai";
-import type { AgentToolResult } from "../../types.ts";
-import type { DurableStructuralPreparation, JsonValue, LaneConfiguration, LaneState, OperationMeta, OperationResultRecord, OperationState, PendingEntry } from "./types.ts";
-declare const storedValueType: unique symbol;
-export interface StoredAddressBase {
-    readonly namespace: string;
-    readonly key: string;
-    readonly kind: "value" | "list";
-}
-export interface Value<T> extends StoredAddressBase {
-    readonly kind: "value";
-    readonly [storedValueType]?: (value: T) => T;
-}
-export interface ValueList<T> extends StoredAddressBase {
-    readonly kind: "list";
-    readonly [storedValueType]?: (value: T) => T;
-}
-export interface StoredValue<T> {
-    address: Value<T>;
-    value: T;
-    seq: number;
-}
-export interface ListElement<T> {
-    seq: number;
-    value: T;
-}
-export interface ListCursor {
-    seq: number;
-}
-export interface ListReadOptions {
-    cursor?: ListCursor;
-    order?: "asc" | "desc";
-    limit?: number;
-}
-export interface ResolvedListReadOptions {
-    cursor?: ListCursor;
-    order: "asc" | "desc";
-    limit: number;
-}
-export interface ValueSetWrite {
-    kind: "value";
-    op: "set";
-    namespace: string;
-    key: string;
-    value: unknown;
-}
-export interface ValueDeleteWrite {
-    kind: "value";
-    op: "delete";
-    namespace: string;
-    key: string;
-}
-export interface ListAppendWrite {
-    kind: "list";
-    op: "append";
-    namespace: string;
-    key: string;
-    value: unknown;
-}
-export interface ListDeleteWrite {
-    kind: "list";
-    op: "delete";
-    namespace: string;
-    key: string;
-}
-export type ValueWrite = ValueSetWrite | ValueDeleteWrite;
-export type ListWrite = ListAppendWrite | ListDeleteWrite;
-export declare function value<T>(namespace: string, key?: string): Value<T>;
-export declare function list<T>(namespace: string, key?: string): ValueList<T>;
-export declare function setValue<T>(address: Value<T>, next: NoInfer<T>): ValueSetWrite;
-export declare function deleteValue<T>(address: Value<T>): ValueDeleteWrite;
-export declare function appendList<T>(address: ValueList<T>, element: NoInfer<T>): ListAppendWrite;
-export declare function deleteList<T>(address: ValueList<T>): ListDeleteWrite;
-export declare function resolveListReadOptions(options?: ListReadOptions): ResolvedListReadOptions;
-export declare const branchTip: (branch: string) => Value<string | null>;
-export declare const branchTipInventoryPrefix: () => Value<string | null>;
-export declare const laneConfig: (lane: string) => Value<LaneConfiguration>;
-export declare const laneState: (lane: string) => Value<LaneState>;
-export declare const operationResult: (operationId: string) => Value<OperationResultRecord>;
-export declare const operationMeta: (operationId: string) => Value<OperationMeta>;
-export declare const operationState: (operationId: string) => Value<OperationState>;
-export declare const operationToolArgs: (operationId: string, stepId: string, sourceIndex: number) => Value<Record<string, JsonValue>>;
-export declare const operationToolMemo: (operationId: string, invocationId: string, name: string) => Value<JsonValue>;
-export declare const operationPreparation: (operationId: string, taskId: string) => Value<DurableStructuralPreparation>;
-export declare const operationToolArgsPrefix: (operationId: string, stepId?: string) => Value<Record<string, JsonValue>>;
-export declare const operationToolMemoPrefix: (operationId: string, invocationId?: string) => Value<JsonValue>;
-export declare const operationPreparationPrefix: (operationId: string) => Value<DurableStructuralPreparation>;
-export declare const pendingEntry: (entryId: string) => Value<PendingEntry>;
-export declare const pendingToolOutput: (operationId: string, invocationId: string) => Value<AgentToolResult<unknown>>;
-export declare const pendingAssistantFrames: (operationId: string, responseEntryId: string) => ValueList<AssistantMessageFrame>;
-export declare const pendingToolOutputPrefix: (operationId: string) => Value<AgentToolResult<unknown>>;
-export declare const sessionName: Value<string>;
-export declare const entryLabel: (entryId: string) => Value<string>;
-export {};
-//# sourceMappingURL=values.d.ts.map

package/dist/harness/session/values.d.ts.map

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

package/dist/harness/session/values.js

@@ -1,81 +0,0 @@
-function validateAddress(namespace, key) {
-    if (namespace.length === 0)
-        throw new TypeError("Value namespace must not be empty");
-    if (namespace.includes("\u0000"))
-        throw new TypeError("Value namespace must not contain \\u0000");
-    if (key.includes("\u0000"))
-        throw new TypeError("Value key must not contain \\u0000");
-}
-export function value(namespace, key = "") {
-    validateAddress(namespace, key);
-    return Object.freeze({ namespace, key, kind: "value" });
-}
-export function list(namespace, key = "") {
-    validateAddress(namespace, key);
-    return Object.freeze({ namespace, key, kind: "list" });
-}
-export function setValue(address, next) {
-    return {
-        kind: "value",
-        op: "set",
-        namespace: address.namespace,
-        key: address.key,
-        value: next,
-    };
-}
-export function deleteValue(address) {
-    return {
-        kind: "value",
-        op: "delete",
-        namespace: address.namespace,
-        key: address.key,
-    };
-}
-export function appendList(address, element) {
-    return {
-        kind: "list",
-        op: "append",
-        namespace: address.namespace,
-        key: address.key,
-        value: element,
-    };
-}
-export function deleteList(address) {
-    return {
-        kind: "list",
-        op: "delete",
-        namespace: address.namespace,
-        key: address.key,
-    };
-}
-export function resolveListReadOptions(options = {}) {
-    const requestedLimit = options.limit ?? 1_000;
-    if (!Number.isSafeInteger(requestedLimit) || requestedLimit <= 0) {
-        throw new TypeError("List read limit must be a positive safe integer");
-    }
-    return {
-        ...(options.cursor === undefined ? {} : { cursor: options.cursor }),
-        order: options.order ?? "asc",
-        limit: Math.min(requestedLimit, 10_000),
-    };
-}
-export const branchTip = (branch) => value("pi.branch.tip", branch);
-export const branchTipInventoryPrefix = () => value("pi.branch.tip");
-export const laneConfig = (lane) => value("pi.lane.config", lane);
-export const laneState = (lane) => value("pi.lane.state", lane);
-export const operationResult = (operationId) => value("pi.result", operationId);
-export const operationMeta = (operationId) => value("pi.op.meta", operationId);
-export const operationState = (operationId) => value("pi.op.state", operationId);
-export const operationToolArgs = (operationId, stepId, sourceIndex) => value("pi.op.tool_args", `${operationId}:${stepId}:${sourceIndex}`);
-export const operationToolMemo = (operationId, invocationId, name) => value("pi.op.tool_memo", `${operationId}:${invocationId}:${name}`);
-export const operationPreparation = (operationId, taskId) => value("pi.op.preparation", `${operationId}:${taskId}`);
-export const operationToolArgsPrefix = (operationId, stepId) => value("pi.op.tool_args", stepId === undefined ? `${operationId}:` : `${operationId}:${stepId}:`);
-export const operationToolMemoPrefix = (operationId, invocationId) => value("pi.op.tool_memo", invocationId === undefined ? `${operationId}:` : `${operationId}:${invocationId}:`);
-export const operationPreparationPrefix = (operationId) => value("pi.op.preparation", `${operationId}:`);
-export const pendingEntry = (entryId) => value("pi.pending.entry", entryId);
-export const pendingToolOutput = (operationId, invocationId) => value("pi.pending.tool_output", `${operationId}:${invocationId}`);
-export const pendingAssistantFrames = (operationId, responseEntryId) => list("pi.pending.assistant_frame", `${operationId}:${responseEntryId}`);
-export const pendingToolOutputPrefix = (operationId) => value("pi.pending.tool_output", `${operationId}:`);
-export const sessionName = value("pi.session.name");
-export const entryLabel = (entryId) => value("pi.entry.label", entryId);
-//# sourceMappingURL=values.js.map

package/dist/harness/session/values.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"values.js","sourceRoot":"","sources":["../../../src/harness/session/values.ts"],"names":[],"mappings":"AA2FA,SAAS,eAAe,CAAC,SAAiB,EAAE,GAAW;IACtD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,mCAAmC,CAAC,CAAC;IACrF,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC,CAAC;IAClG,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,oCAAoC,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,KAAK,CAAI,SAAiB,EAAE,GAAG,GAAG,EAAE;IACnD,eAAe,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAa,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,IAAI,CAAI,SAAiB,EAAE,GAAG,GAAG,EAAE;IAClD,eAAe,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAChC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAiB,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAI,OAAiB,EAAE,IAAgB;IAC9D,OAAO;QACN,IAAI,EAAE,OAAO;QACb,EAAE,EAAE,KAAK;QACT,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,IAAI;KACX,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAI,OAAiB;IAC/C,OAAO;QACN,IAAI,EAAE,OAAO;QACb,EAAE,EAAE,QAAQ;QACZ,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,GAAG,EAAE,OAAO,CAAC,GAAG;KAChB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAI,OAAqB,EAAE,OAAmB;IACvE,OAAO;QACN,IAAI,EAAE,MAAM;QACZ,EAAE,EAAE,QAAQ;QACZ,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,OAAO;KACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAI,OAAqB;IAClD,OAAO;QACN,IAAI,EAAE,MAAM;QACZ,EAAE,EAAE,QAAQ;QACZ,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,GAAG,EAAE,OAAO,CAAC,GAAG;KAChB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAO,GAAoB,EAAE;IACnE,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;IAC9C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC,IAAI,cAAc,IAAI,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,SAAS,CAAC,iDAAiD,CAAC,CAAC;IACxE,CAAC;IACD,OAAO;QACN,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;QACnE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK;QAC7B,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC;KACvC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,KAAK,CAAgB,eAAe,EAAE,MAAM,CAAC,CAAC;AAC3F,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,EAAE,CAAC,KAAK,CAAgB,eAAe,CAAC,CAAC;AACpF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAoB,gBAAgB,EAAE,IAAI,CAAC,CAAC;AAC7F,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAY,eAAe,EAAE,IAAI,CAAC,CAAC;AACnF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,WAAmB,EAAE,EAAE,CAAC,KAAK,CAAwB,WAAW,EAAE,WAAW,CAAC,CAAC;AAE/G,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,WAAmB,EAAE,EAAE,CAAC,KAAK,CAAgB,YAAY,EAAE,WAAW,CAAC,CAAC;AACtG,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,WAAmB,EAAE,EAAE,CAAC,KAAK,CAAiB,aAAa,EAAE,WAAW,CAAC,CAAC;AACzG,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,WAAmB,EAAE,MAAc,EAAE,WAAmB,EAAE,EAAE,CAC7F,KAAK,CAA4B,iBAAiB,EAAE,GAAG,WAAW,IAAI,MAAM,IAAI,WAAW,EAAE,CAAC,CAAC;AAChG,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,WAAmB,EAAE,YAAoB,EAAE,IAAY,EAAE,EAAE,CAC5F,KAAK,CAAY,iBAAiB,EAAE,GAAG,WAAW,IAAI,YAAY,IAAI,IAAI,EAAE,CAAC,CAAC;AAC/E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,WAAmB,EAAE,MAAc,EAAE,EAAE,CAC3E,KAAK,CAA+B,mBAAmB,EAAE,GAAG,WAAW,IAAI,MAAM,EAAE,CAAC,CAAC;AAEtF,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,WAAmB,EAAE,MAAe,EAAE,EAAE,CAC/E,KAAK,CACJ,iBAAiB,EACjB,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,GAAG,WAAW,IAAI,MAAM,GAAG,CACtE,CAAC;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,WAAmB,EAAE,YAAqB,EAAE,EAAE,CACrF,KAAK,CACJ,iBAAiB,EACjB,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,GAAG,WAAW,IAAI,YAAY,GAAG,CAClF,CAAC;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,WAAmB,EAAE,EAAE,CACjE,KAAK,CAA+B,mBAAmB,EAAE,GAAG,WAAW,GAAG,CAAC,CAAC;AAE7E,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,KAAK,CAAe,kBAAkB,EAAE,OAAO,CAAC,CAAC;AAClG,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,WAAmB,EAAE,YAAoB,EAAE,EAAE,CAC9E,KAAK,CAA2B,wBAAwB,EAAE,GAAG,WAAW,IAAI,YAAY,EAAE,CAAC,CAAC;AAC7F,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,WAAmB,EAAE,eAAuB,EAAE,EAAE,CACtF,IAAI,CAAwB,4BAA4B,EAAE,GAAG,WAAW,IAAI,eAAe,EAAE,CAAC,CAAC;AAChG,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,WAAmB,EAAE,EAAE,CAC9D,KAAK,CAA2B,wBAAwB,EAAE,GAAG,WAAW,GAAG,CAAC,CAAC;AAE9E,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,CAAS,iBAAiB,CAAC,CAAC;AAC5D,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAe,EAAE,EAAE,CAAC,KAAK,CAAS,gBAAgB,EAAE,OAAO,CAAC,CAAC","sourcesContent":["import type { AssistantMessageFrame } from \"@earendil-works/pi-ai\";\nimport type { AgentToolResult } from \"../../types.ts\";\nimport type {\n\tDurableStructuralPreparation,\n\tJsonValue,\n\tLaneConfiguration,\n\tLaneState,\n\tOperationMeta,\n\tOperationResultRecord,\n\tOperationState,\n\tPendingEntry,\n} from \"./types.ts\";\n\ndeclare const storedValueType: unique symbol;\n\nexport interface StoredAddressBase {\n\treadonly namespace: string;\n\treadonly key: string;\n\treadonly kind: \"value\" | \"list\";\n}\n\nexport interface Value<T> extends StoredAddressBase {\n\treadonly kind: \"value\";\n\treadonly [storedValueType]?: (value: T) => T;\n}\n\nexport interface ValueList<T> extends StoredAddressBase {\n\treadonly kind: \"list\";\n\treadonly [storedValueType]?: (value: T) => T;\n}\n\nexport interface StoredValue<T> {\n\taddress: Value<T>;\n\tvalue: T;\n\tseq: number;\n}\n\nexport interface ListElement<T> {\n\tseq: number;\n\tvalue: T;\n}\n\nexport interface ListCursor {\n\tseq: number;\n}\n\nexport interface ListReadOptions {\n\tcursor?: ListCursor;\n\torder?: \"asc\" | \"desc\";\n\tlimit?: number;\n}\n\nexport interface ResolvedListReadOptions {\n\tcursor?: ListCursor;\n\torder: \"asc\" | \"desc\";\n\tlimit: number;\n}\n\nexport interface ValueSetWrite {\n\tkind: \"value\";\n\top: \"set\";\n\tnamespace: string;\n\tkey: string;\n\tvalue: unknown;\n}\n\nexport interface ValueDeleteWrite {\n\tkind: \"value\";\n\top: \"delete\";\n\tnamespace: string;\n\tkey: string;\n}\n\nexport interface ListAppendWrite {\n\tkind: \"list\";\n\top: \"append\";\n\tnamespace: string;\n\tkey: string;\n\tvalue: unknown;\n}\n\nexport interface ListDeleteWrite {\n\tkind: \"list\";\n\top: \"delete\";\n\tnamespace: string;\n\tkey: string;\n}\n\nexport type ValueWrite = ValueSetWrite | ValueDeleteWrite;\nexport type ListWrite = ListAppendWrite | ListDeleteWrite;\n\nfunction validateAddress(namespace: string, key: string): void {\n\tif (namespace.length === 0) throw new TypeError(\"Value namespace must not be empty\");\n\tif (namespace.includes(\"\\u0000\")) throw new TypeError(\"Value namespace must not contain \\\\u0000\");\n\tif (key.includes(\"\\u0000\")) throw new TypeError(\"Value key must not contain \\\\u0000\");\n}\n\nexport function value<T>(namespace: string, key = \"\"): Value<T> {\n\tvalidateAddress(namespace, key);\n\treturn Object.freeze({ namespace, key, kind: \"value\" }) as Value<T>;\n}\n\nexport function list<T>(namespace: string, key = \"\"): ValueList<T> {\n\tvalidateAddress(namespace, key);\n\treturn Object.freeze({ namespace, key, kind: \"list\" }) as ValueList<T>;\n}\n\nexport function setValue<T>(address: Value<T>, next: NoInfer<T>): ValueSetWrite {\n\treturn {\n\t\tkind: \"value\",\n\t\top: \"set\",\n\t\tnamespace: address.namespace,\n\t\tkey: address.key,\n\t\tvalue: next,\n\t};\n}\n\nexport function deleteValue<T>(address: Value<T>): ValueDeleteWrite {\n\treturn {\n\t\tkind: \"value\",\n\t\top: \"delete\",\n\t\tnamespace: address.namespace,\n\t\tkey: address.key,\n\t};\n}\n\nexport function appendList<T>(address: ValueList<T>, element: NoInfer<T>): ListAppendWrite {\n\treturn {\n\t\tkind: \"list\",\n\t\top: \"append\",\n\t\tnamespace: address.namespace,\n\t\tkey: address.key,\n\t\tvalue: element,\n\t};\n}\n\nexport function deleteList<T>(address: ValueList<T>): ListDeleteWrite {\n\treturn {\n\t\tkind: \"list\",\n\t\top: \"delete\",\n\t\tnamespace: address.namespace,\n\t\tkey: address.key,\n\t};\n}\n\nexport function resolveListReadOptions(options: ListReadOptions = {}): ResolvedListReadOptions {\n\tconst requestedLimit = options.limit ?? 1_000;\n\tif (!Number.isSafeInteger(requestedLimit) || requestedLimit <= 0) {\n\t\tthrow new TypeError(\"List read limit must be a positive safe integer\");\n\t}\n\treturn {\n\t\t...(options.cursor === undefined ? {} : { cursor: options.cursor }),\n\t\torder: options.order ?? \"asc\",\n\t\tlimit: Math.min(requestedLimit, 10_000),\n\t};\n}\n\nexport const branchTip = (branch: string) => value<string | null>(\"pi.branch.tip\", branch);\nexport const branchTipInventoryPrefix = () => value<string | null>(\"pi.branch.tip\");\nexport const laneConfig = (lane: string) => value<LaneConfiguration>(\"pi.lane.config\", lane);\nexport const laneState = (lane: string) => value<LaneState>(\"pi.lane.state\", lane);\nexport const operationResult = (operationId: string) => value<OperationResultRecord>(\"pi.result\", operationId);\n\nexport const operationMeta = (operationId: string) => value<OperationMeta>(\"pi.op.meta\", operationId);\nexport const operationState = (operationId: string) => value<OperationState>(\"pi.op.state\", operationId);\nexport const operationToolArgs = (operationId: string, stepId: string, sourceIndex: number) =>\n\tvalue<Record<string, JsonValue>>(\"pi.op.tool_args\", `${operationId}:${stepId}:${sourceIndex}`);\nexport const operationToolMemo = (operationId: string, invocationId: string, name: string) =>\n\tvalue<JsonValue>(\"pi.op.tool_memo\", `${operationId}:${invocationId}:${name}`);\nexport const operationPreparation = (operationId: string, taskId: string) =>\n\tvalue<DurableStructuralPreparation>(\"pi.op.preparation\", `${operationId}:${taskId}`);\n\nexport const operationToolArgsPrefix = (operationId: string, stepId?: string) =>\n\tvalue<Record<string, JsonValue>>(\n\t\t\"pi.op.tool_args\",\n\t\tstepId === undefined ? `${operationId}:` : `${operationId}:${stepId}:`,\n\t);\nexport const operationToolMemoPrefix = (operationId: string, invocationId?: string) =>\n\tvalue<JsonValue>(\n\t\t\"pi.op.tool_memo\",\n\t\tinvocationId === undefined ? `${operationId}:` : `${operationId}:${invocationId}:`,\n\t);\nexport const operationPreparationPrefix = (operationId: string) =>\n\tvalue<DurableStructuralPreparation>(\"pi.op.preparation\", `${operationId}:`);\n\nexport const pendingEntry = (entryId: string) => value<PendingEntry>(\"pi.pending.entry\", entryId);\nexport const pendingToolOutput = (operationId: string, invocationId: string) =>\n\tvalue<AgentToolResult<unknown>>(\"pi.pending.tool_output\", `${operationId}:${invocationId}`);\nexport const pendingAssistantFrames = (operationId: string, responseEntryId: string) =>\n\tlist<AssistantMessageFrame>(\"pi.pending.assistant_frame\", `${operationId}:${responseEntryId}`);\nexport const pendingToolOutputPrefix = (operationId: string) =>\n\tvalue<AgentToolResult<unknown>>(\"pi.pending.tool_output\", `${operationId}:`);\n\nexport const sessionName = value<string>(\"pi.session.name\");\nexport const entryLabel = (entryId: string) => value<string>(\"pi.entry.label\", entryId);\n"]}

package/dist/harness/skills.d.ts

@@ -1,46 +0,0 @@
-import type { Context } from "./context.ts";
-import { type ExecutionEnv, type Skill } from "./types.ts";
-export type SkillDiagnosticCode = "file_info_failed" | "list_failed" | "read_failed" | "parse_failed" | "invalid_metadata";
-/** Warning produced while loading skills. */
-export interface SkillDiagnostic {
-    /** Diagnostic severity. Currently only warnings are emitted. */
-    type: "warning";
-    /** Stable diagnostic code. */
-    code: SkillDiagnosticCode;
-    /** Human-readable diagnostic message. */
-    message: string;
-    /** Path associated with the diagnostic. */
-    path: string;
-}
-/** Format a skill invocation prompt, optionally appending additional user instructions. */
-export declare function formatSkillInvocation(skill: Skill, additionalInstructions?: string): string;
-/**
- * Load skills from one or more directories.
- *
- * Traverses directories recursively, loads `SKILL.md` files, loads direct root `.md` files with skill
- * frontmatter, honors ignore files, and returns diagnostics for invalid declared skill files. Missing input
- * directories are skipped.
- */
-export declare function loadSkills(env: ExecutionEnv, dirs: string | string[], context: Context): Promise<{
-    skills: Skill[];
-    diagnostics: SkillDiagnostic[];
-}>;
-/**
- * Load skills from source-tagged directories.
- *
- * Source values are preserved exactly and attached to every loaded skill and diagnostic. The agent package does not
- * interpret source values; applications define their own provenance shape.
- */
-export declare function loadSourcedSkills<TSource, TSkill extends Skill = Skill>(env: ExecutionEnv, inputs: Array<{
-    path: string;
-    source: TSource;
-}>, mapSkill: ((skill: Skill, source: TSource, context: Context) => TSkill) | undefined, context: Context): Promise<{
-    skills: Array<{
-        skill: TSkill;
-        source: TSource;
-    }>;
-    diagnostics: Array<SkillDiagnostic & {
-        source: TSource;
-    }>;
-}>;
-//# sourceMappingURL=skills.d.ts.map

package/dist/harness/skills.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/harness/skills.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,KAAK,YAAY,EAA8B,KAAK,KAAK,EAAW,MAAM,YAAY,CAAC;AAQhG,MAAM,MAAM,mBAAmB,GAC5B,kBAAkB,GAClB,aAAa,GACb,aAAa,GACb,cAAc,GACd,kBAAkB,CAAC;AAEtB,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC/B,gEAAgE;IAChE,IAAI,EAAE,SAAS,CAAC;IAChB,8BAA8B;IAC9B,IAAI,EAAE,mBAAmB,CAAC;IAC1B,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;CACb;AASD,2FAA2F;AAC3F,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,KAAK,EAAE,sBAAsB,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3F;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC/B,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EACvB,OAAO,EAAE,OAAO,GACd,OAAO,CAAC;IAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAAC,WAAW,EAAE,eAAe,EAAE,CAAA;CAAE,CAAC,CAuB9D;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,SAAS,KAAK,GAAG,KAAK,EAC5E,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,EAChD,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC,GAAG,SAAS,EACnF,OAAO,EAAE,OAAO,GACd,OAAO,CAAC;IACV,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAClD,WAAW,EAAE,KAAK,CAAC,eAAe,GAAG;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC1D,CAAC,CAcD"}

package/dist/harness/skills.js

@@ -1,326 +0,0 @@
-import ignore from "ignore";
-import { parse } from "yaml";
-import { toError } from "./types.js";
-const MAX_NAME_LENGTH = 64;
-const MAX_DESCRIPTION_LENGTH = 1024;
-const IGNORE_FILE_NAMES = [".gitignore", ".ignore", ".fdignore"];
-/** Format a skill invocation prompt, optionally appending additional user instructions. */
-export function formatSkillInvocation(skill, additionalInstructions) {
-    const skillBlock = `<skill name="${skill.name}" location="${skill.filePath}">\nReferences are relative to ${dirnameEnvPath(skill.filePath)}.\n\n${skill.content}\n</skill>`;
-    return additionalInstructions ? `${skillBlock}\n\n${additionalInstructions}` : skillBlock;
-}
-/**
- * Load skills from one or more directories.
- *
- * Traverses directories recursively, loads `SKILL.md` files, loads direct root `.md` files with skill
- * frontmatter, honors ignore files, and returns diagnostics for invalid declared skill files. Missing input
- * directories are skipped.
- */
-export async function loadSkills(env, dirs, context) {
-    const skills = [];
-    const diagnostics = [];
-    for (const dir of Array.isArray(dirs) ? dirs : [dirs]) {
-        const rootInfoResult = await env.fileInfo(dir, context);
-        if (!rootInfoResult.ok) {
-            if (rootInfoResult.error.code !== "not_found") {
-                diagnostics.push({
-                    type: "warning",
-                    code: "file_info_failed",
-                    message: rootInfoResult.error.message,
-                    path: dir,
-                });
-            }
-            continue;
-        }
-        const rootInfo = rootInfoResult.value;
-        if ((await resolveKind(env, rootInfo, diagnostics, context)) !== "directory")
-            continue;
-        const result = await loadSkillsFromDirInternal(env, rootInfo.path, true, ignore(), rootInfo.path, context);
-        skills.push(...result.skills);
-        diagnostics.push(...result.diagnostics);
-    }
-    return { skills, diagnostics };
-}
-/**
- * Load skills from source-tagged directories.
- *
- * Source values are preserved exactly and attached to every loaded skill and diagnostic. The agent package does not
- * interpret source values; applications define their own provenance shape.
- */
-export async function loadSourcedSkills(env, inputs, mapSkill, context) {
-    const skills = [];
-    const diagnostics = [];
-    for (const input of inputs) {
-        const result = await loadSkills(env, input.path, context);
-        for (const skill of result.skills) {
-            skills.push({
-                skill: mapSkill ? mapSkill(skill, input.source, context) : skill,
-                source: input.source,
-            });
-        }
-        for (const diagnostic of result.diagnostics)
-            diagnostics.push({ ...diagnostic, source: input.source });
-    }
-    return { skills, diagnostics };
-}
-async function loadSkillsFromDirInternal(env, dir, includeRootFiles, ignoreMatcher, rootDir, context) {
-    const skills = [];
-    const diagnostics = [];
-    const dirInfoResult = await env.fileInfo(dir, context);
-    if (!dirInfoResult.ok) {
-        if (dirInfoResult.error.code !== "not_found") {
-            diagnostics.push({
-                type: "warning",
-                code: "file_info_failed",
-                message: dirInfoResult.error.message,
-                path: dir,
-            });
-        }
-        return { skills, diagnostics };
-    }
-    const dirInfo = dirInfoResult.value;
-    if ((await resolveKind(env, dirInfo, diagnostics, context)) !== "directory")
-        return { skills, diagnostics };
-    await addIgnoreRules(env, ignoreMatcher, dir, rootDir, diagnostics, context);
-    const entriesResult = await env.listDir(dir, context);
-    if (!entriesResult.ok) {
-        diagnostics.push({ type: "warning", code: "list_failed", message: entriesResult.error.message, path: dir });
-        return { skills, diagnostics };
-    }
-    const entries = entriesResult.value;
-    for (const entry of entries) {
-        if (entry.name !== "SKILL.md")
-            continue;
-        const fullPath = entry.path;
-        const kind = await resolveKind(env, entry, diagnostics, context);
-        if (kind !== "file")
-            continue;
-        const relPath = relativeEnvPath(rootDir, fullPath);
-        if (ignoreMatcher.ignores(relPath))
-            continue;
-        const result = await loadSkillFromFile(env, fullPath, dirInfo.name, context);
-        if (result.skill)
-            skills.push(result.skill);
-        diagnostics.push(...result.diagnostics);
-        return { skills, diagnostics };
-    }
-    for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
-        if (entry.name.startsWith(".") || entry.name === "node_modules")
-            continue;
-        const fullPath = entry.path;
-        const kind = await resolveKind(env, entry, diagnostics, context);
-        if (!kind)
-            continue;
-        const relPath = relativeEnvPath(rootDir, fullPath);
-        const ignorePath = kind === "directory" ? `${relPath}/` : relPath;
-        if (ignoreMatcher.ignores(ignorePath))
-            continue;
-        if (kind === "directory") {
-            const result = await loadSkillsFromDirInternal(env, fullPath, false, ignoreMatcher, rootDir, context);
-            skills.push(...result.skills);
-            diagnostics.push(...result.diagnostics);
-            continue;
-        }
-        if (kind !== "file" || !includeRootFiles || !entry.name.endsWith(".md"))
-            continue;
-        const result = await loadSkillFromFile(env, fullPath, dirInfo.name, context);
-        if (result.skill)
-            skills.push(result.skill);
-        diagnostics.push(...result.diagnostics);
-    }
-    return { skills, diagnostics };
-}
-async function addIgnoreRules(env, ig, dir, rootDir, diagnostics, context) {
-    const relativeDir = relativeEnvPath(rootDir, dir);
-    const prefix = relativeDir ? `${relativeDir}/` : "";
-    for (const filename of IGNORE_FILE_NAMES) {
-        const ignorePathResult = await env.joinPath([dir, filename], context);
-        if (!ignorePathResult.ok) {
-            diagnostics.push({
-                type: "warning",
-                code: "file_info_failed",
-                message: ignorePathResult.error.message,
-                path: dir,
-            });
-            continue;
-        }
-        const ignorePath = ignorePathResult.value;
-        const info = await env.fileInfo(ignorePath, context);
-        if (!info.ok) {
-            if (info.error.code !== "not_found") {
-                diagnostics.push({
-                    type: "warning",
-                    code: "file_info_failed",
-                    message: info.error.message,
-                    path: ignorePath,
-                });
-            }
-            continue;
-        }
-        if (info.value.kind !== "file")
-            continue;
-        const content = await env.readTextFile(ignorePath, context);
-        if (!content.ok) {
-            diagnostics.push({ type: "warning", code: "read_failed", message: content.error.message, path: ignorePath });
-            continue;
-        }
-        const patterns = content.value
-            .split(/\r?\n/)
-            .map((line) => prefixIgnorePattern(line, prefix))
-            .filter((line) => Boolean(line));
-        if (patterns.length > 0)
-            ig.add(patterns);
-    }
-}
-function prefixIgnorePattern(line, prefix) {
-    const trimmed = line.trim();
-    if (!trimmed)
-        return null;
-    if (trimmed.startsWith("#") && !trimmed.startsWith("\\#"))
-        return null;
-    let pattern = line;
-    let negated = false;
-    if (pattern.startsWith("!")) {
-        negated = true;
-        pattern = pattern.slice(1);
-    }
-    else if (pattern.startsWith("\\!")) {
-        pattern = pattern.slice(1);
-    }
-    if (pattern.startsWith("/"))
-        pattern = pattern.slice(1);
-    const prefixed = prefix ? `${prefix}${pattern}` : pattern;
-    return negated ? `!${prefixed}` : prefixed;
-}
-async function loadSkillFromFile(env, filePath, parentDirName, context) {
-    const diagnostics = [];
-    const isDeclaredSkill = filePath
-        .replace(/[\\/]+$/, "")
-        .split(/[\\/]/)
-        .pop() === "SKILL.md";
-    const rawContent = await env.readTextFile(filePath, context);
-    if (!rawContent.ok) {
-        diagnostics.push({ type: "warning", code: "read_failed", message: rawContent.error.message, path: filePath });
-        return { skill: null, diagnostics };
-    }
-    const parsed = parseFrontmatter(rawContent.value);
-    if (!parsed.ok) {
-        if (isDeclaredSkill) {
-            diagnostics.push({ type: "warning", code: "parse_failed", message: parsed.error.message, path: filePath });
-        }
-        return { skill: null, diagnostics };
-    }
-    const { frontmatter, body } = parsed.value;
-    const description = typeof frontmatter.description === "string" ? frontmatter.description : undefined;
-    if (!isDeclaredSkill && (!description || description.trim() === "")) {
-        return { skill: null, diagnostics };
-    }
-    for (const error of validateDescription(description)) {
-        diagnostics.push({ type: "warning", code: "invalid_metadata", message: error, path: filePath });
-    }
-    const frontmatterName = typeof frontmatter.name === "string" ? frontmatter.name : undefined;
-    const name = frontmatterName || parentDirName;
-    for (const error of validateName(name, parentDirName)) {
-        diagnostics.push({ type: "warning", code: "invalid_metadata", message: error, path: filePath });
-    }
-    if (!description || description.trim() === "") {
-        return { skill: null, diagnostics };
-    }
-    return {
-        skill: {
-            name,
-            description,
-            content: body,
-            filePath,
-            disableModelInvocation: frontmatter["disable-model-invocation"] === true,
-        },
-        diagnostics,
-    };
-}
-function validateName(name, parentDirName) {
-    const errors = [];
-    if (name !== parentDirName)
-        errors.push(`name "${name}" does not match parent directory "${parentDirName}"`);
-    if (name.length > MAX_NAME_LENGTH)
-        errors.push(`name exceeds ${MAX_NAME_LENGTH} characters (${name.length})`);
-    if (!/^[a-z0-9-]+$/.test(name)) {
-        errors.push("name contains invalid characters (must be lowercase a-z, 0-9, hyphens only)");
-    }
-    if (name.startsWith("-") || name.endsWith("-"))
-        errors.push("name must not start or end with a hyphen");
-    if (name.includes("--"))
-        errors.push("name must not contain consecutive hyphens");
-    return errors;
-}
-function validateDescription(description) {
-    const errors = [];
-    if (!description || description.trim() === "") {
-        errors.push("description is required");
-    }
-    else if (description.length > MAX_DESCRIPTION_LENGTH) {
-        errors.push(`description exceeds ${MAX_DESCRIPTION_LENGTH} characters (${description.length})`);
-    }
-    return errors;
-}
-function parseFrontmatter(content) {
-    try {
-        const normalized = content.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
-        if (!normalized.startsWith("---"))
-            return { ok: true, value: { frontmatter: {}, body: normalized } };
-        const endIndex = normalized.indexOf("\n---", 3);
-        if (endIndex === -1)
-            return { ok: true, value: { frontmatter: {}, body: normalized } };
-        const yamlString = normalized.slice(4, endIndex);
-        const body = normalized.slice(endIndex + 4).trim();
-        return { ok: true, value: { frontmatter: (parse(yamlString) ?? {}), body } };
-    }
-    catch (error) {
-        return { ok: false, error: toError(error) };
-    }
-}
-async function resolveKind(env, info, diagnostics, context) {
-    if (info.kind === "file" || info.kind === "directory")
-        return info.kind;
-    const canonicalPath = await env.canonicalPath(info.path, context);
-    if (!canonicalPath.ok) {
-        if (canonicalPath.error.code !== "not_found") {
-            diagnostics.push({
-                type: "warning",
-                code: "file_info_failed",
-                message: canonicalPath.error.message,
-                path: info.path,
-            });
-        }
-        return undefined;
-    }
-    const target = await env.fileInfo(canonicalPath.value, context);
-    if (!target.ok) {
-        if (target.error.code !== "not_found") {
-            diagnostics.push({
-                type: "warning",
-                code: "file_info_failed",
-                message: target.error.message,
-                path: info.path,
-            });
-        }
-        return undefined;
-    }
-    return target.value.kind === "file" || target.value.kind === "directory" ? target.value.kind : undefined;
-}
-function dirnameEnvPath(path) {
-    const normalized = path.replace(/[\\/]+$/, "");
-    const separatorIndex = Math.max(normalized.lastIndexOf("/"), normalized.lastIndexOf("\\"));
-    if (separatorIndex === 2 && normalized[1] === ":")
-        return normalized.slice(0, 3);
-    return separatorIndex <= 0 ? "/" : normalized.slice(0, separatorIndex);
-}
-function relativeEnvPath(root, path) {
-    const normalizedRoot = root.replace(/\\/g, "/").replace(/\/+$/, "");
-    const normalizedPath = path.replace(/\\/g, "/").replace(/\/+$/, "");
-    if (normalizedPath === normalizedRoot)
-        return "";
-    return normalizedPath.startsWith(`${normalizedRoot}/`)
-        ? normalizedPath.slice(normalizedRoot.length + 1)
-        : normalizedPath.replace(/^\/+/, "");
-}
-//# sourceMappingURL=skills.js.map