@elie-laloum/outpost 7.0.0 → 9.0.0

package/dist/domain/agent.types.d.ts

@@ -2,6 +2,9 @@ import type { Harness } from "./harness.types.ts";
 import type { AgentModel, ModelSpec } from "./model.types.ts";
 import type { Command, CommandResult, Variables } from "./command.types.ts";
 import type { ConversationStore } from "./conversation.types.ts";
+import type { ReplayAgent } from "./replay.types.ts";
+import type { SteeringMode } from "./steering.types.ts";
+import type { FallbackCandidate, FallbackTrigger } from "./fallback-agent.types.ts";
 export interface Usage {
     readonly complete?: boolean;
     readonly input: number;
@@ -30,7 +33,11 @@ export type AgentEventDetails = {
     readonly truncated?: boolean;
 } | {
     readonly kind: "stopped";
-    readonly reason: "completion" | "idle-timeout" | "deadline" | "aborted" | "oversized-event";
+    readonly reason: "completion" | "idle-timeout" | "deadline" | "aborted" | "oversized-event" | "steered";
+} | {
+    readonly kind: "steer";
+    readonly text: string;
+    readonly mode: SteeringMode;
 } | {
     readonly kind: "reasoning";
     readonly text: string;
@@ -132,6 +139,17 @@ export type AgentEventDetails = {
 } | {
     readonly kind: "failure";
     readonly message: string;
+} | {
+    readonly kind: "quota";
+    readonly message: string;
+    readonly resetAt?: string;
+} | {
+    readonly kind: "fallback";
+    readonly from: FallbackCandidate;
+    readonly to: FallbackCandidate;
+    readonly failure: FallbackTrigger;
+    readonly message: string;
+    readonly resetAt?: string;
 } | {
     readonly kind: "finished";
 } | {
@@ -155,6 +173,8 @@ export type AgentEventHandlers = {
 export interface AgentInput {
     readonly text?: string;
     readonly interactive?: boolean;
+    /** Requests the liveInput protocol: stdin carries the encoded prompt and stays open. */
+    readonly liveInput?: boolean;
     readonly continuation?: {
         readonly id: string;
         readonly fork?: boolean;
@@ -166,7 +186,6 @@ export interface AgentFeatures {
     readonly requiresFinishedEvent?: boolean;
     readonly usage?: "events" | "session" | "unavailable";
     readonly variables?: Variables;
-    readonly conversations?: "claude" | "codex" | "copilot" | "kimi";
     readonly storage?: ConversationStore;
     readonly capture?: boolean;
     readonly resumable?: boolean;
@@ -176,10 +195,32 @@ export interface AgentFeatures {
 export interface AgentAdapter extends AgentFeatures {
     fork?(id: string, invoke: (command: Command) => Promise<CommandResult>): Promise<string>;
     credentials?(variables: Variables): CredentialPlan;
+    /** Plans CLI configuration merged into the agent home; throws when a referenced variable is missing. */
+    configuration?(variables: Variables): AgentConfiguration;
     request(input: AgentInput): Command;
     events(line: string): readonly AgentEvent[];
+    /** Recognizes a usage-limit or rate-limit message in failure or stderr text. */
+    quota?(text: string): boolean;
+    /** Recognizes a terminal service outage or connection failure in failure or stderr text. */
+    unavailable?(text: string): boolean;
     usageCommand?(conversation: string): Command | undefined;
     usageResult?(text: string): Usage | undefined;
+    /** Protocol for adding user messages to a running turn through live stdin. */
+    readonly liveInput?: AgentLiveInput;
+}
+export interface AgentLiveInput {
+    /** Starts the protocol state of one turn requested with input. */
+    open(input: AgentInput): AgentLiveSession;
+}
+export interface AgentLiveSession {
+    /** Encodes one user message for stdin, or returns "" when the session sends it later. */
+    encode(text: string): string;
+    /** Reads one output line: user messages it confirms and protocol replies to write. */
+    read(line: string): AgentLiveRead;
+}
+export interface AgentLiveRead {
+    readonly consumed: number;
+    readonly replies: readonly string[];
 }
 export interface RequiredAgent {
     readonly agent: Agent;
@@ -201,7 +242,7 @@ export interface CustomAgent extends AgentFeatures {
     readonly harness: Harness;
     readonly model: AgentModel;
 }
-export type Agent = CliAgent | CustomAgent;
+export type Agent = CliAgent | CustomAgent | ReplayAgent;
 export interface CliAgentOptions {
     readonly harness: CliHarness;
     readonly model?: ModelSpec;
@@ -250,6 +291,23 @@ export interface GeneratedCredential {
     readonly path: string;
     readonly content: string;
 }
+export interface ConfigurationFile {
+    readonly path: string;
+    readonly section?: string;
+    readonly entries: Readonly<Record<string, unknown>>;
+}
+export interface HostConfiguration {
+    readonly source: HostCredentialPath;
+    readonly path: string;
+    readonly section?: string;
+    readonly optional?: boolean;
+    readonly login: string;
+    select(content: string): Readonly<Record<string, unknown>>;
+}
+export interface AgentConfiguration {
+    readonly files: readonly ConfigurationFile[];
+    readonly host?: readonly HostConfiguration[];
+}
 export interface CredentialPlan {
     readonly variables: Variables;
     readonly host: readonly HostCredential[];

package/dist/domain/agent.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.types.js","sourceRoot":"","sources":["../../src/domain/agent.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Harness } from \"./harness.types.ts\";\nimport type { AgentModel, ModelSpec } from \"./model.types.ts\";\nimport type { Command, CommandResult, Variables } from \"./command.types.ts\";\nimport type { ConversationStore } from \"./conversation.types.ts\";\n\nexport interface Usage {\n  readonly complete?: boolean;\n  readonly input: number;\n  readonly cached: number;\n  readonly cacheCreated?: number;\n  readonly output: number;\n}\n\nexport type AgentEvent = AgentEventDetails & {\n  readonly subagentId?: string;\n};\n\nexport type AgentEventDetails =\n  | {\n      readonly kind: \"subagent\";\n      readonly id: string;\n      readonly callId: string;\n      readonly name: string;\n      readonly status: \"started\" | \"finished\" | \"failed\";\n      readonly conversation?: string;\n    }\n  | {\n      readonly kind: \"message-usage\";\n      readonly tokens: Usage;\n      readonly messageId?: string;\n      readonly parentCallId?: string;\n    }\n  | {\n      readonly kind: \"stderr\";\n      readonly text: string;\n      readonly truncated?: boolean;\n    }\n  | {\n      readonly kind: \"stopped\";\n      readonly reason:\n        | \"completion\"\n        | \"idle-timeout\"\n        | \"deadline\"\n        | \"aborted\"\n        | \"oversized-event\";\n    }\n  | {\n      readonly kind: \"reasoning\";\n      readonly text: string;\n      readonly parentCallId?: string;\n    }\n  | {\n      readonly kind: \"file-change\";\n      readonly changes: unknown;\n      readonly callId?: string;\n    }\n  | { readonly kind: \"model-request\"; readonly request: unknown }\n  | { readonly kind: \"model-response\"; readonly response: unknown }\n  | {\n      readonly kind: \"model-retry\";\n      readonly attempt: number;\n      readonly message?: string;\n    }\n  | { readonly kind: \"model-error\"; readonly message: string }\n  | { readonly kind: \"hook\"; readonly phase: string; readonly changed: boolean }\n  | { readonly kind: \"instructions-loaded\"; readonly count: number }\n  | { readonly kind: \"skills-loaded\"; readonly names: readonly string[] }\n  | {\n      readonly kind: \"tool-output\";\n      readonly callId: string;\n      readonly channel: \"stdout\" | \"stderr\";\n      readonly text: string;\n    }\n  | {\n      readonly kind: \"phase\";\n      readonly name: string;\n      readonly agent?: string;\n      readonly branch?: string;\n      readonly directory?: string;\n    }\n  | {\n      readonly kind: \"summary\";\n      readonly durationMs: number;\n      readonly status: number;\n      readonly tokens: Usage;\n    }\n  | { readonly kind: \"warning\"; readonly message: string }\n  | { readonly kind: \"text\"; readonly text: string }\n  | { readonly kind: \"text-delta\"; readonly text: string }\n  | { readonly kind: \"result\"; readonly text: string }\n  | { readonly kind: \"prompt\"; readonly text: string }\n  | {\n      readonly kind: \"tool\";\n      readonly name: string;\n      readonly input: unknown;\n      readonly callId?: string;\n      readonly parentCallId?: string;\n    }\n  | {\n      readonly kind: \"tool-result\";\n      readonly callId: string;\n      readonly name: string;\n      readonly isError: boolean;\n      readonly preview: string;\n      readonly characters: number;\n      readonly parentCallId?: string;\n    }\n  | { readonly kind: \"step\"; readonly index: number }\n  | {\n      readonly kind: \"tool-denied\";\n      readonly callId: string;\n      readonly name: string;\n      readonly reason: string;\n    }\n  | { readonly kind: \"stop-prevented\"; readonly message: string }\n  | {\n      readonly kind: \"compaction\";\n      readonly strategy: string;\n      readonly messages: number;\n    }\n  | { readonly kind: \"conversation\"; readonly id: string }\n  | {\n      readonly kind: \"usage\";\n      readonly tokens: Usage;\n      readonly cumulative?: boolean;\n    }\n  | { readonly kind: \"failure\"; readonly message: string }\n  | { readonly kind: \"finished\" }\n  | {\n      readonly kind: \"raw\";\n      readonly value: unknown;\n      readonly bytes?: number;\n      readonly truncated?: boolean;\n    };\n\nexport type AgentObservation = AgentEvent & {\n  readonly pass: number;\n  readonly at: string;\n  readonly seq?: number;\n  readonly source?: import(\"./observation.types.ts\").ObservationSource;\n  readonly scope?: import(\"./observation.types.ts\").ObservationScope;\n};\n\nexport type AgentEventHandlers = {\n  readonly [Kind in AgentEvent[\"kind\"]]?: (\n    event: Extract<AgentEvent, { kind: Kind }>,\n  ) => void;\n};\n\nexport interface AgentInput {\n  readonly text?: string;\n  readonly interactive?: boolean;\n  readonly continuation?: { readonly id: string; readonly fork?: boolean };\n}\n\nexport interface AgentFeatures {\n  readonly name: string;\n  readonly bootstrap?: string;\n  readonly requiresFinishedEvent?: boolean;\n  readonly usage?: \"events\" | \"session\" | \"unavailable\";\n  readonly variables?: Variables;\n  readonly conversations?: \"claude\" | \"codex\" | \"copilot\" | \"kimi\";\n  readonly storage?: ConversationStore;\n  readonly capture?: boolean;\n  readonly resumable?: boolean;\n  readonly forkable?: boolean;\n  transcriptUsage?(text: string): Usage | undefined;\n}\n\nexport interface AgentAdapter extends AgentFeatures {\n  fork?(\n    id: string,\n    invoke: (command: Command) => Promise<CommandResult>,\n  ): Promise<string>;\n  credentials?(variables: Variables): CredentialPlan;\n  request(input: AgentInput): Command;\n  events(line: string): readonly AgentEvent[];\n  usageCommand?(conversation: string): Command | undefined;\n  usageResult?(text: string): Usage | undefined;\n}\n\nexport interface RequiredAgent {\n  readonly agent: Agent;\n}\n\nexport interface CliHarness {\n  readonly kind: \"cli\";\n  bind(model?: AgentModel): AgentAdapter;\n}\n\nexport type AgentHarness = CliHarness | Harness;\n\nexport interface CliAgent extends AgentAdapter {\n  readonly kind: \"cli\";\n  readonly harness: CliHarness;\n  readonly model?: AgentModel;\n}\n\nexport interface CustomAgent extends AgentFeatures {\n  readonly resumable: boolean;\n  readonly capture: boolean;\n  readonly kind: \"custom\";\n  readonly harness: Harness;\n  readonly model: AgentModel;\n}\n\nexport type Agent = CliAgent | CustomAgent;\n\nexport interface CliAgentOptions {\n  readonly harness: CliHarness;\n  readonly model?: ModelSpec;\n}\nexport interface CustomAgentOptions {\n  readonly harness: Harness;\n  readonly model: ModelSpec;\n}\nexport type AgentOptions = CliAgentOptions | CustomAgentOptions;\n\nexport type AccountCredential =\n  | { readonly file: string }\n  | { readonly key: string }\n  | { readonly variable: string };\n\nexport type UsageCredential =\n  { readonly key: string } | { readonly variable: string };\n\nexport type AgentAuthentication =\n  | \"account\"\n  | \"usage\"\n  | { readonly account: AccountCredential }\n  | { readonly usage: UsageCredential };\n\nexport interface HostCredentialPath {\n  readonly path: string;\n  readonly home?: { readonly variable: string; readonly path: string };\n}\n\nexport interface HostCredential {\n  readonly source: HostCredentialPath;\n  readonly destination:\n    { readonly file: string } | { readonly variable: string };\n  readonly login: string;\n  readonly alternative?: string;\n  select?(content: string): string;\n}\n\nexport interface GeneratedCredential {\n  readonly path: string;\n  readonly content: string;\n}\n\nexport interface CredentialPlan {\n  readonly variables: Variables;\n  readonly host: readonly HostCredential[];\n  readonly files: readonly GeneratedCredential[];\n  readonly commands: readonly Command[];\n}\n"]}
+{"version":3,"file":"agent.types.js","sourceRoot":"","sources":["../../src/domain/agent.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Harness } from \"./harness.types.ts\";\nimport type { AgentModel, ModelSpec } from \"./model.types.ts\";\nimport type { Command, CommandResult, Variables } from \"./command.types.ts\";\nimport type { ConversationStore } from \"./conversation.types.ts\";\nimport type { ReplayAgent } from \"./replay.types.ts\";\nimport type { SteeringMode } from \"./steering.types.ts\";\nimport type {\n  FallbackCandidate,\n  FallbackTrigger,\n} from \"./fallback-agent.types.ts\";\n\nexport interface Usage {\n  readonly complete?: boolean;\n  readonly input: number;\n  readonly cached: number;\n  readonly cacheCreated?: number;\n  readonly output: number;\n}\n\nexport type AgentEvent = AgentEventDetails & {\n  readonly subagentId?: string;\n};\n\nexport type AgentEventDetails =\n  | {\n      readonly kind: \"subagent\";\n      readonly id: string;\n      readonly callId: string;\n      readonly name: string;\n      readonly status: \"started\" | \"finished\" | \"failed\";\n      readonly conversation?: string;\n    }\n  | {\n      readonly kind: \"message-usage\";\n      readonly tokens: Usage;\n      readonly messageId?: string;\n      readonly parentCallId?: string;\n    }\n  | {\n      readonly kind: \"stderr\";\n      readonly text: string;\n      readonly truncated?: boolean;\n    }\n  | {\n      readonly kind: \"stopped\";\n      readonly reason:\n        | \"completion\"\n        | \"idle-timeout\"\n        | \"deadline\"\n        | \"aborted\"\n        | \"oversized-event\"\n        | \"steered\";\n    }\n  | {\n      readonly kind: \"steer\";\n      readonly text: string;\n      readonly mode: SteeringMode;\n    }\n  | {\n      readonly kind: \"reasoning\";\n      readonly text: string;\n      readonly parentCallId?: string;\n    }\n  | {\n      readonly kind: \"file-change\";\n      readonly changes: unknown;\n      readonly callId?: string;\n    }\n  | { readonly kind: \"model-request\"; readonly request: unknown }\n  | { readonly kind: \"model-response\"; readonly response: unknown }\n  | {\n      readonly kind: \"model-retry\";\n      readonly attempt: number;\n      readonly message?: string;\n    }\n  | { readonly kind: \"model-error\"; readonly message: string }\n  | { readonly kind: \"hook\"; readonly phase: string; readonly changed: boolean }\n  | { readonly kind: \"instructions-loaded\"; readonly count: number }\n  | { readonly kind: \"skills-loaded\"; readonly names: readonly string[] }\n  | {\n      readonly kind: \"tool-output\";\n      readonly callId: string;\n      readonly channel: \"stdout\" | \"stderr\";\n      readonly text: string;\n    }\n  | {\n      readonly kind: \"phase\";\n      readonly name: string;\n      readonly agent?: string;\n      readonly branch?: string;\n      readonly directory?: string;\n    }\n  | {\n      readonly kind: \"summary\";\n      readonly durationMs: number;\n      readonly status: number;\n      readonly tokens: Usage;\n    }\n  | { readonly kind: \"warning\"; readonly message: string }\n  | { readonly kind: \"text\"; readonly text: string }\n  | { readonly kind: \"text-delta\"; readonly text: string }\n  | { readonly kind: \"result\"; readonly text: string }\n  | { readonly kind: \"prompt\"; readonly text: string }\n  | {\n      readonly kind: \"tool\";\n      readonly name: string;\n      readonly input: unknown;\n      readonly callId?: string;\n      readonly parentCallId?: string;\n    }\n  | {\n      readonly kind: \"tool-result\";\n      readonly callId: string;\n      readonly name: string;\n      readonly isError: boolean;\n      readonly preview: string;\n      readonly characters: number;\n      readonly parentCallId?: string;\n    }\n  | { readonly kind: \"step\"; readonly index: number }\n  | {\n      readonly kind: \"tool-denied\";\n      readonly callId: string;\n      readonly name: string;\n      readonly reason: string;\n    }\n  | { readonly kind: \"stop-prevented\"; readonly message: string }\n  | {\n      readonly kind: \"compaction\";\n      readonly strategy: string;\n      readonly messages: number;\n    }\n  | { readonly kind: \"conversation\"; readonly id: string }\n  | {\n      readonly kind: \"usage\";\n      readonly tokens: Usage;\n      readonly cumulative?: boolean;\n    }\n  | { readonly kind: \"failure\"; readonly message: string }\n  | {\n      readonly kind: \"quota\";\n      readonly message: string;\n      readonly resetAt?: string;\n    }\n  | {\n      readonly kind: \"fallback\";\n      readonly from: FallbackCandidate;\n      readonly to: FallbackCandidate;\n      readonly failure: FallbackTrigger;\n      readonly message: string;\n      readonly resetAt?: string;\n    }\n  | { readonly kind: \"finished\" }\n  | {\n      readonly kind: \"raw\";\n      readonly value: unknown;\n      readonly bytes?: number;\n      readonly truncated?: boolean;\n    };\n\nexport type AgentObservation = AgentEvent & {\n  readonly pass: number;\n  readonly at: string;\n  readonly seq?: number;\n  readonly source?: import(\"./observation.types.ts\").ObservationSource;\n  readonly scope?: import(\"./observation.types.ts\").ObservationScope;\n};\n\nexport type AgentEventHandlers = {\n  readonly [Kind in AgentEvent[\"kind\"]]?: (\n    event: Extract<AgentEvent, { kind: Kind }>,\n  ) => void;\n};\n\nexport interface AgentInput {\n  readonly text?: string;\n  readonly interactive?: boolean;\n  /** Requests the liveInput protocol: stdin carries the encoded prompt and stays open. */\n  readonly liveInput?: boolean;\n  readonly continuation?: { readonly id: string; readonly fork?: boolean };\n}\n\nexport interface AgentFeatures {\n  readonly name: string;\n  readonly bootstrap?: string;\n  readonly requiresFinishedEvent?: boolean;\n  readonly usage?: \"events\" | \"session\" | \"unavailable\";\n  readonly variables?: Variables;\n  readonly storage?: ConversationStore;\n  readonly capture?: boolean;\n  readonly resumable?: boolean;\n  readonly forkable?: boolean;\n  transcriptUsage?(text: string): Usage | undefined;\n}\n\nexport interface AgentAdapter extends AgentFeatures {\n  fork?(\n    id: string,\n    invoke: (command: Command) => Promise<CommandResult>,\n  ): Promise<string>;\n  credentials?(variables: Variables): CredentialPlan;\n  /** Plans CLI configuration merged into the agent home; throws when a referenced variable is missing. */\n  configuration?(variables: Variables): AgentConfiguration;\n  request(input: AgentInput): Command;\n  events(line: string): readonly AgentEvent[];\n  /** Recognizes a usage-limit or rate-limit message in failure or stderr text. */\n  quota?(text: string): boolean;\n  /** Recognizes a terminal service outage or connection failure in failure or stderr text. */\n  unavailable?(text: string): boolean;\n  usageCommand?(conversation: string): Command | undefined;\n  usageResult?(text: string): Usage | undefined;\n  /** Protocol for adding user messages to a running turn through live stdin. */\n  readonly liveInput?: AgentLiveInput;\n}\n\nexport interface AgentLiveInput {\n  /** Starts the protocol state of one turn requested with input. */\n  open(input: AgentInput): AgentLiveSession;\n}\n\nexport interface AgentLiveSession {\n  /** Encodes one user message for stdin, or returns \"\" when the session sends it later. */\n  encode(text: string): string;\n  /** Reads one output line: user messages it confirms and protocol replies to write. */\n  read(line: string): AgentLiveRead;\n}\n\nexport interface AgentLiveRead {\n  readonly consumed: number;\n  readonly replies: readonly string[];\n}\n\nexport interface RequiredAgent {\n  readonly agent: Agent;\n}\n\nexport interface CliHarness {\n  readonly kind: \"cli\";\n  bind(model?: AgentModel): AgentAdapter;\n}\n\nexport type AgentHarness = CliHarness | Harness;\n\nexport interface CliAgent extends AgentAdapter {\n  readonly kind: \"cli\";\n  readonly harness: CliHarness;\n  readonly model?: AgentModel;\n}\n\nexport interface CustomAgent extends AgentFeatures {\n  readonly resumable: boolean;\n  readonly capture: boolean;\n  readonly kind: \"custom\";\n  readonly harness: Harness;\n  readonly model: AgentModel;\n}\n\nexport type Agent = CliAgent | CustomAgent | ReplayAgent;\n\nexport interface CliAgentOptions {\n  readonly harness: CliHarness;\n  readonly model?: ModelSpec;\n}\nexport interface CustomAgentOptions {\n  readonly harness: Harness;\n  readonly model: ModelSpec;\n}\nexport type AgentOptions = CliAgentOptions | CustomAgentOptions;\n\nexport type AccountCredential =\n  | { readonly file: string }\n  | { readonly key: string }\n  | { readonly variable: string };\n\nexport type UsageCredential =\n  { readonly key: string } | { readonly variable: string };\n\nexport type AgentAuthentication =\n  | \"account\"\n  | \"usage\"\n  | { readonly account: AccountCredential }\n  | { readonly usage: UsageCredential };\n\nexport interface HostCredentialPath {\n  readonly path: string;\n  readonly home?: { readonly variable: string; readonly path: string };\n}\n\nexport interface HostCredential {\n  readonly source: HostCredentialPath;\n  readonly destination:\n    { readonly file: string } | { readonly variable: string };\n  readonly login: string;\n  readonly alternative?: string;\n  select?(content: string): string;\n}\n\nexport interface GeneratedCredential {\n  readonly path: string;\n  readonly content: string;\n}\n\nexport interface ConfigurationFile {\n  readonly path: string;\n  readonly section?: string;\n  readonly entries: Readonly<Record<string, unknown>>;\n}\n\nexport interface HostConfiguration {\n  readonly source: HostCredentialPath;\n  readonly path: string;\n  readonly section?: string;\n  readonly optional?: boolean;\n  readonly login: string;\n  select(content: string): Readonly<Record<string, unknown>>;\n}\n\nexport interface AgentConfiguration {\n  readonly files: readonly ConfigurationFile[];\n  readonly host?: readonly HostConfiguration[];\n}\n\nexport interface CredentialPlan {\n  readonly variables: Variables;\n  readonly host: readonly HostCredential[];\n  readonly files: readonly GeneratedCredential[];\n  readonly commands: readonly Command[];\n}\n"]}

package/dist/domain/artifact.d.ts

@@ -1,7 +1,5 @@
 import type { ArtifactContract, ArtifactContractOptions, ArtifactReference, ArtifactStore, JsonArtifactOptions, PublishArtifactOptions, ReadArtifactOptions } from "./artifact.types.ts";
-export declare const artifact: {
-    json<T>(options: JsonArtifactOptions<T>): ArtifactContract<T>;
-    binary(options: ArtifactContractOptions): ArtifactContract<Uint8Array>;
-};
+export declare function defineJsonArtifact<T>(options: JsonArtifactOptions<T>): ArtifactContract<T>;
+export declare function defineBinaryArtifact(options: ArtifactContractOptions): ArtifactContract<Uint8Array>;
 export declare function publishArtifact<T>(store: ArtifactStore, contract: ArtifactContract<T>, value: T, options: PublishArtifactOptions): Promise<ArtifactReference>;
 export declare function readStoredArtifact<T>(store: ArtifactStore, contract: ArtifactContract<T>, value: unknown, options?: ReadArtifactOptions): Promise<T>;

package/dist/domain/artifact.js

@@ -9,46 +9,44 @@ function identity(options) {
         throw new Error(`Artifact contract name and version must be nonempty and at most ${artifactLabelMaxLength} characters`);
     return { name: options.name, version: options.version };
 }
-export const artifact = {
-    json(options) {
-        const schema = options.schema;
-        async function validate(value) {
-            if (typeof schema === "function")
-                return schema(value);
-            const result = await schema["~standard"].validate(value);
-            if (result.issues)
-                throw new Error(`Artifact schema validation failed: ${JSON.stringify(result.issues)}`);
-            return result.value;
-        }
-        return Object.freeze({
-            ...identity(options),
-            encoding: "json",
-            async encode(value) {
-                const checked = checkpointValue(await validate(value));
-                if (checked.kind !== "json")
-                    throw new Error("Artifact payload must be JSON");
-                return Buffer.from(JSON.stringify(checked.value));
-            },
-            async decode(bytes) {
-                return validate(JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes)));
-            },
-        });
-    },
-    binary(options) {
-        return Object.freeze({
-            ...identity(options),
-            encoding: "binary",
-            async encode(value) {
-                if (!(value instanceof Uint8Array))
-                    throw new Error("Artifact payload must be Uint8Array");
-                return Uint8Array.from(value);
-            },
-            async decode(bytes) {
-                return Uint8Array.from(bytes);
-            },
-        });
-    },
-};
+export function defineJsonArtifact(options) {
+    const schema = options.schema;
+    async function validate(value) {
+        if (typeof schema === "function")
+            return schema(value);
+        const result = await schema["~standard"].validate(value);
+        if (result.issues)
+            throw new Error(`Artifact schema validation failed: ${JSON.stringify(result.issues)}`);
+        return result.value;
+    }
+    return Object.freeze({
+        ...identity(options),
+        encoding: "json",
+        async encode(value) {
+            const checked = checkpointValue(await validate(value));
+            if (checked.kind !== "json")
+                throw new Error("Artifact payload must be JSON");
+            return Buffer.from(JSON.stringify(checked.value));
+        },
+        async decode(bytes) {
+            return validate(JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes)));
+        },
+    });
+}
+export function defineBinaryArtifact(options) {
+    return Object.freeze({
+        ...identity(options),
+        encoding: "binary",
+        async encode(value) {
+            if (!(value instanceof Uint8Array))
+                throw new Error("Artifact payload must be Uint8Array");
+            return Uint8Array.from(value);
+        },
+        async decode(bytes) {
+            return Uint8Array.from(bytes);
+        },
+    });
+}
 export async function publishArtifact(store, contract, value, options) {
     options.signal?.throwIfAborted();
     const producer = { ...options.producer };

package/dist/domain/artifact.js.map

@@ -1 +1 @@
-{"version":3,"file":"artifact.js","sourceRoot":"","sources":["../../src/domain/artifact.ts"],"names":[],"mappings":"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","sourcesContent":["import { artifactLabelMaxLength } from \"./artifact.constants.ts\";\nimport {\n  artifactDigest,\n  artifactId,\n  validateArtifactReference,\n} from \"./artifact-reference.ts\";\nimport { checkpointValue } from \"./workflow/checkpoint-value.ts\";\nimport type {\n  ArtifactContract,\n  ArtifactContractOptions,\n  ArtifactReference,\n  ArtifactStore,\n  JsonArtifactOptions,\n  PublishArtifactOptions,\n  ReadArtifactOptions,\n} from \"./artifact.types.ts\";\n\nfunction identity(options: ArtifactContractOptions): ArtifactContractOptions {\n  if (\n    !options.name.trim() ||\n    !options.version.trim() ||\n    options.name.length > artifactLabelMaxLength ||\n    options.version.length > artifactLabelMaxLength\n  )\n    throw new Error(\n      `Artifact contract name and version must be nonempty and at most ${artifactLabelMaxLength} characters`,\n    );\n  return { name: options.name, version: options.version };\n}\n\nexport const artifact = {\n  json<T>(options: JsonArtifactOptions<T>): ArtifactContract<T> {\n    const schema = options.schema;\n    async function validate(value: unknown): Promise<T> {\n      if (typeof schema === \"function\") return schema(value);\n      const result = await schema[\"~standard\"].validate(value);\n      if (result.issues)\n        throw new Error(\n          `Artifact schema validation failed: ${JSON.stringify(result.issues)}`,\n        );\n      return result.value;\n    }\n    return Object.freeze({\n      ...identity(options),\n      encoding: \"json\",\n      async encode(value: T) {\n        const checked = checkpointValue(await validate(value));\n        if (checked.kind !== \"json\")\n          throw new Error(\"Artifact payload must be JSON\");\n        return Buffer.from(JSON.stringify(checked.value));\n      },\n      async decode(bytes: Uint8Array) {\n        return validate(\n          JSON.parse(\n            new TextDecoder(\"utf-8\", { fatal: true }).decode(bytes),\n          ) as unknown,\n        );\n      },\n    });\n  },\n  binary(options: ArtifactContractOptions): ArtifactContract<Uint8Array> {\n    return Object.freeze({\n      ...identity(options),\n      encoding: \"binary\",\n      async encode(value: Uint8Array) {\n        if (!(value instanceof Uint8Array))\n          throw new Error(\"Artifact payload must be Uint8Array\");\n        return Uint8Array.from(value);\n      },\n      async decode(bytes: Uint8Array) {\n        return Uint8Array.from(bytes);\n      },\n    });\n  },\n};\n\nexport async function publishArtifact<T>(\n  store: ArtifactStore,\n  contract: ArtifactContract<T>,\n  value: T,\n  options: PublishArtifactOptions,\n): Promise<ArtifactReference> {\n  options.signal?.throwIfAborted();\n  const producer = { ...options.producer };\n  const parents = (options.parents ?? []).map(\n    (parent) => validateArtifactReference(parent).id,\n  );\n  const bytes = Uint8Array.from(await contract.encode(value));\n  options.signal?.throwIfAborted();\n  const metadata = {\n    format: 1 as const,\n    digest: artifactDigest(bytes),\n    size: bytes.length,\n    contract: {\n      name: contract.name,\n      version: contract.version,\n      encoding: contract.encoding,\n    },\n    producer,\n    parents,\n  };\n  const reference = validateArtifactReference({\n    ...metadata,\n    id: artifactId(metadata),\n  });\n  await store.put(reference.id, bytes, options.signal);\n  options.signal?.throwIfAborted();\n  return reference;\n}\n\nexport async function readStoredArtifact<T>(\n  store: ArtifactStore,\n  contract: ArtifactContract<T>,\n  value: unknown,\n  options: ReadArtifactOptions = {},\n): Promise<T> {\n  options.signal?.throwIfAborted();\n  const reference = validateArtifactReference(value);\n  if (\n    reference.contract.name !== contract.name ||\n    reference.contract.version !== contract.version ||\n    reference.contract.encoding !== contract.encoding\n  )\n    throw new Error(\"Artifact contract mismatch\");\n  const producer = options.producer;\n  if (\n    producer &&\n    (reference.producer.executionId !== producer.executionId ||\n      reference.producer.taskKey !== producer.taskKey ||\n      reference.producer.attempt !== producer.attempt)\n  )\n    throw new Error(\"Artifact producer mismatch\");\n  if (\n    options.parents &&\n    JSON.stringify(reference.parents) !==\n      JSON.stringify(\n        options.parents.map((parent) => validateArtifactReference(parent).id),\n      )\n  )\n    throw new Error(\"Artifact lineage mismatch\");\n  const bytes = await store.get(reference.id, options.signal);\n  options.signal?.throwIfAborted();\n  if (\n    bytes.length !== reference.size ||\n    artifactDigest(bytes) !== reference.digest\n  )\n    throw new Error(\"Artifact content integrity mismatch\");\n  const result = await contract.decode(bytes);\n  options.signal?.throwIfAborted();\n  return result;\n}\n"]}
+{"version":3,"file":"artifact.js","sourceRoot":"","sources":["../../src/domain/artifact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EACL,cAAc,EACd,UAAU,EACV,yBAAyB,GAC1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAWjE,SAAS,QAAQ,CAAC,OAAgC;IAChD,IACE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE;QACpB,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE;QACvB,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,sBAAsB;QAC5C,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,sBAAsB;QAE/C,MAAM,IAAI,KAAK,CACb,mEAAmE,sBAAsB,aAAa,CACvG,CAAC;IACJ,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,OAA+B;IAE/B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,KAAK,UAAU,QAAQ,CAAC,KAAc;QACpC,IAAI,OAAO,MAAM,KAAK,UAAU;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACzD,IAAI,MAAM,CAAC,MAAM;YACf,MAAM,IAAI,KAAK,CACb,sCAAsC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CACtE,CAAC;QACJ,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,QAAQ,CAAC,OAAO,CAAC;QACpB,QAAQ,EAAE,MAAM;QAChB,KAAK,CAAC,MAAM,CAAC,KAAQ;YACnB,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;YACvD,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;gBACzB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;YACnD,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QACpD,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,KAAiB;YAC5B,OAAO,QAAQ,CACb,IAAI,CAAC,KAAK,CACR,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAC7C,CACb,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,OAAgC;IAEhC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,QAAQ,CAAC,OAAO,CAAC;QACpB,QAAQ,EAAE,QAAQ;QAClB,KAAK,CAAC,MAAM,CAAC,KAAiB;YAC5B,IAAI,CAAC,CAAC,KAAK,YAAY,UAAU,CAAC;gBAChC,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;YACzD,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,KAAiB;YAC5B,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAoB,EACpB,QAA6B,EAC7B,KAAQ,EACR,OAA+B;IAE/B,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAG,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CACzC,CAAC,MAAM,EAAE,EAAE,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,EAAE,CACjD,CAAC;IACF,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5D,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAG;QACf,MAAM,EAAE,CAAU;QAClB,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC;QAC7B,IAAI,EAAE,KAAK,CAAC,MAAM;QAClB,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;SAC5B;QACD,QAAQ;QACR,OAAO;KACR,CAAC;IACF,MAAM,SAAS,GAAG,yBAAyB,CAAC;QAC1C,GAAG,QAAQ;QACX,EAAE,EAAE,UAAU,CAAC,QAAQ,CAAC;KACzB,CAAC,CAAC;IACH,MAAM,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IACjC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAoB,EACpB,QAA6B,EAC7B,KAAc,EACd,UAA+B,EAAE;IAEjC,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IACjC,MAAM,SAAS,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;IACnD,IACE,SAAS,CAAC,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI;QACzC,SAAS,CAAC,QAAQ,CAAC,OAAO,KAAK,QAAQ,CAAC,OAAO;QAC/C,SAAS,CAAC,QAAQ,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ;QAEjD,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,IACE,QAAQ;QACR,CAAC,SAAS,CAAC,QAAQ,CAAC,WAAW,KAAK,QAAQ,CAAC,WAAW;YACtD,SAAS,CAAC,QAAQ,CAAC,OAAO,KAAK,QAAQ,CAAC,OAAO;YAC/C,SAAS,CAAC,QAAQ,CAAC,OAAO,KAAK,QAAQ,CAAC,OAAO,CAAC;QAElD,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,IACE,OAAO,CAAC,OAAO;QACf,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC;YAC/B,IAAI,CAAC,SAAS,CACZ,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CACtE;QAEH,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5D,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IACjC,IACE,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,IAAI;QAC/B,cAAc,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,MAAM;QAE1C,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5C,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IACjC,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import { artifactLabelMaxLength } from \"./artifact.constants.ts\";\nimport {\n  artifactDigest,\n  artifactId,\n  validateArtifactReference,\n} from \"./artifact-reference.ts\";\nimport { checkpointValue } from \"./workflow/checkpoint-value.ts\";\nimport type {\n  ArtifactContract,\n  ArtifactContractOptions,\n  ArtifactReference,\n  ArtifactStore,\n  JsonArtifactOptions,\n  PublishArtifactOptions,\n  ReadArtifactOptions,\n} from \"./artifact.types.ts\";\n\nfunction identity(options: ArtifactContractOptions): ArtifactContractOptions {\n  if (\n    !options.name.trim() ||\n    !options.version.trim() ||\n    options.name.length > artifactLabelMaxLength ||\n    options.version.length > artifactLabelMaxLength\n  )\n    throw new Error(\n      `Artifact contract name and version must be nonempty and at most ${artifactLabelMaxLength} characters`,\n    );\n  return { name: options.name, version: options.version };\n}\n\nexport function defineJsonArtifact<T>(\n  options: JsonArtifactOptions<T>,\n): ArtifactContract<T> {\n  const schema = options.schema;\n  async function validate(value: unknown): Promise<T> {\n    if (typeof schema === \"function\") return schema(value);\n    const result = await schema[\"~standard\"].validate(value);\n    if (result.issues)\n      throw new Error(\n        `Artifact schema validation failed: ${JSON.stringify(result.issues)}`,\n      );\n    return result.value;\n  }\n  return Object.freeze({\n    ...identity(options),\n    encoding: \"json\",\n    async encode(value: T) {\n      const checked = checkpointValue(await validate(value));\n      if (checked.kind !== \"json\")\n        throw new Error(\"Artifact payload must be JSON\");\n      return Buffer.from(JSON.stringify(checked.value));\n    },\n    async decode(bytes: Uint8Array) {\n      return validate(\n        JSON.parse(\n          new TextDecoder(\"utf-8\", { fatal: true }).decode(bytes),\n        ) as unknown,\n      );\n    },\n  });\n}\n\nexport function defineBinaryArtifact(\n  options: ArtifactContractOptions,\n): ArtifactContract<Uint8Array> {\n  return Object.freeze({\n    ...identity(options),\n    encoding: \"binary\",\n    async encode(value: Uint8Array) {\n      if (!(value instanceof Uint8Array))\n        throw new Error(\"Artifact payload must be Uint8Array\");\n      return Uint8Array.from(value);\n    },\n    async decode(bytes: Uint8Array) {\n      return Uint8Array.from(bytes);\n    },\n  });\n}\n\nexport async function publishArtifact<T>(\n  store: ArtifactStore,\n  contract: ArtifactContract<T>,\n  value: T,\n  options: PublishArtifactOptions,\n): Promise<ArtifactReference> {\n  options.signal?.throwIfAborted();\n  const producer = { ...options.producer };\n  const parents = (options.parents ?? []).map(\n    (parent) => validateArtifactReference(parent).id,\n  );\n  const bytes = Uint8Array.from(await contract.encode(value));\n  options.signal?.throwIfAborted();\n  const metadata = {\n    format: 1 as const,\n    digest: artifactDigest(bytes),\n    size: bytes.length,\n    contract: {\n      name: contract.name,\n      version: contract.version,\n      encoding: contract.encoding,\n    },\n    producer,\n    parents,\n  };\n  const reference = validateArtifactReference({\n    ...metadata,\n    id: artifactId(metadata),\n  });\n  await store.put(reference.id, bytes, options.signal);\n  options.signal?.throwIfAborted();\n  return reference;\n}\n\nexport async function readStoredArtifact<T>(\n  store: ArtifactStore,\n  contract: ArtifactContract<T>,\n  value: unknown,\n  options: ReadArtifactOptions = {},\n): Promise<T> {\n  options.signal?.throwIfAborted();\n  const reference = validateArtifactReference(value);\n  if (\n    reference.contract.name !== contract.name ||\n    reference.contract.version !== contract.version ||\n    reference.contract.encoding !== contract.encoding\n  )\n    throw new Error(\"Artifact contract mismatch\");\n  const producer = options.producer;\n  if (\n    producer &&\n    (reference.producer.executionId !== producer.executionId ||\n      reference.producer.taskKey !== producer.taskKey ||\n      reference.producer.attempt !== producer.attempt)\n  )\n    throw new Error(\"Artifact producer mismatch\");\n  if (\n    options.parents &&\n    JSON.stringify(reference.parents) !==\n      JSON.stringify(\n        options.parents.map((parent) => validateArtifactReference(parent).id),\n      )\n  )\n    throw new Error(\"Artifact lineage mismatch\");\n  const bytes = await store.get(reference.id, options.signal);\n  options.signal?.throwIfAborted();\n  if (\n    bytes.length !== reference.size ||\n    artifactDigest(bytes) !== reference.digest\n  )\n    throw new Error(\"Artifact content integrity mismatch\");\n  const result = await contract.decode(bytes);\n  options.signal?.throwIfAborted();\n  return result;\n}\n"]}

package/dist/domain/command.types.d.ts

@@ -5,6 +5,8 @@ export interface Command {
     readonly executable: string;
     readonly arguments?: readonly string[];
     readonly stdin?: string;
+    /** Live stdin written after `stdin`; stdin closes when this stream ends. */
+    readonly input?: Readable;
     readonly directory?: string;
     readonly variables?: Variables;
     readonly signal?: AbortSignal;

package/dist/domain/command.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"command.types.js","sourceRoot":"","sources":["../../src/domain/command.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Readable, Writable } from \"node:stream\";\n\nexport type Variables = Readonly<Record<string, string>>;\n\nexport type Channel = \"stdout\" | \"stderr\";\n\nexport interface Command {\n  readonly executable: string;\n  readonly arguments?: readonly string[];\n  readonly stdin?: string;\n  readonly directory?: string;\n  readonly variables?: Variables;\n  readonly signal?: AbortSignal;\n  readonly deadlineMs?: number;\n  readonly interactive?: boolean;\n  readonly terminal?: {\n    readonly input?: Readable;\n    readonly output?: Writable;\n    readonly error?: Writable;\n  };\n  readonly elevated?: boolean;\n  readonly retain?: number;\n  readonly observe?: (channel: Channel, text: string) => void;\n}\n\nexport interface CommandResult {\n  readonly status: number;\n  readonly stdout: string;\n  readonly stderr: string;\n}\n"]}
+{"version":3,"file":"command.types.js","sourceRoot":"","sources":["../../src/domain/command.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Readable, Writable } from \"node:stream\";\n\nexport type Variables = Readonly<Record<string, string>>;\n\nexport type Channel = \"stdout\" | \"stderr\";\n\nexport interface Command {\n  readonly executable: string;\n  readonly arguments?: readonly string[];\n  readonly stdin?: string;\n  /** Live stdin written after `stdin`; stdin closes when this stream ends. */\n  readonly input?: Readable;\n  readonly directory?: string;\n  readonly variables?: Variables;\n  readonly signal?: AbortSignal;\n  readonly deadlineMs?: number;\n  readonly interactive?: boolean;\n  readonly terminal?: {\n    readonly input?: Readable;\n    readonly output?: Writable;\n    readonly error?: Writable;\n  };\n  readonly elevated?: boolean;\n  readonly retain?: number;\n  readonly observe?: (channel: Channel, text: string) => void;\n}\n\nexport interface CommandResult {\n  readonly status: number;\n  readonly stdout: string;\n  readonly stderr: string;\n}\n"]}

package/dist/domain/conversation.d.ts

@@ -0,0 +1,3 @@
+import type { ConversationStore } from "./conversation.types.ts";
+export declare function isConversationStore(value: unknown): value is ConversationStore;
+export declare function conversationFormat(owner: string, store: ConversationStore, format: string): void;

package/dist/domain/conversation.js

@@ -0,0 +1,18 @@
+import { invariant } from "./errors.js";
+export function isConversationStore(value) {
+    return (value !== null &&
+        typeof value === "object" &&
+        "locate" in value &&
+        "capture" in value &&
+        "restore" in value &&
+        typeof value.locate === "function" &&
+        typeof value.capture === "function" &&
+        typeof value.restore === "function" &&
+        (!("format" in value) ||
+            value.format === undefined ||
+            typeof value.format === "string"));
+}
+export function conversationFormat(owner, store, format) {
+    invariant(store.format === undefined || store.format === format, `${owner} conversations must use the "${format}" format, not "${store.format}"`);
+}
+//# sourceMappingURL=conversation.js.map

package/dist/domain/conversation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.js","sourceRoot":"","sources":["../../src/domain/conversation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,UAAU,mBAAmB,CACjC,KAAc;IAEd,OAAO,CACL,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,QAAQ,IAAI,KAAK;QACjB,SAAS,IAAI,KAAK;QAClB,SAAS,IAAI,KAAK;QAClB,OAAO,KAAK,CAAC,MAAM,KAAK,UAAU;QAClC,OAAO,KAAK,CAAC,OAAO,KAAK,UAAU;QACnC,OAAO,KAAK,CAAC,OAAO,KAAK,UAAU;QACnC,CAAC,CAAC,CAAC,QAAQ,IAAI,KAAK,CAAC;YACnB,KAAK,CAAC,MAAM,KAAK,SAAS;YAC1B,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,KAAa,EACb,KAAwB,EACxB,MAAc;IAEd,SAAS,CACP,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM,EACrD,GAAG,KAAK,gCAAgC,MAAM,kBAAkB,KAAK,CAAC,MAAM,GAAG,CAChF,CAAC;AACJ,CAAC","sourcesContent":["import type { ConversationStore } from \"./conversation.types.ts\";\nimport { invariant } from \"./errors.ts\";\n\nexport function isConversationStore(\n  value: unknown,\n): value is ConversationStore {\n  return (\n    value !== null &&\n    typeof value === \"object\" &&\n    \"locate\" in value &&\n    \"capture\" in value &&\n    \"restore\" in value &&\n    typeof value.locate === \"function\" &&\n    typeof value.capture === \"function\" &&\n    typeof value.restore === \"function\" &&\n    (!(\"format\" in value) ||\n      value.format === undefined ||\n      typeof value.format === \"string\")\n  );\n}\n\nexport function conversationFormat(\n  owner: string,\n  store: ConversationStore,\n  format: string,\n): void {\n  invariant(\n    store.format === undefined || store.format === format,\n    `${owner} conversations must use the \"${format}\" format, not \"${store.format}\"`,\n  );\n}\n"]}

package/dist/domain/conversation.types.d.ts

@@ -16,7 +16,16 @@ export interface ConversationContext {
 }
 export interface ConversationStore {
     readonly name: string;
+    readonly format?: string;
     locate(id: string, repository: string, home?: string): Promise<ConversationRecord>;
     capture(id: string, context: ConversationContext): Promise<ConversationRecord>;
     restore(record: ConversationRecord, context: ConversationContext): Promise<void>;
 }
+export interface NativeConversationStore extends ConversationStore {
+    /** Persisted format name, used in transport keys, bundles and records. */
+    readonly format: string;
+    /** Host directory that holds this format's captured conversations. */
+    directory(repository: string, home?: string): string;
+    /** Sandbox path that restoration writes for a captured conversation. */
+    destination(id: string, sandbox: SandboxLease, original: string): string;
+}

package/dist/domain/conversation.types.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversation.types.js","sourceRoot":"","sources":["../../src/domain/conversation.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { TransportReference } from \"./transport.types.ts\";\nimport type { SandboxLease } from \"./sandbox.types.ts\";\n\nexport interface ConversationRecord {\n  readonly id: string;\n  readonly file: string;\n  readonly reference?: TransportReference;\n  readonly format: string;\n}\n\nexport interface ConversationContext {\n  readonly repository: string;\n  readonly sandbox: SandboxLease;\n  readonly staging: string;\n  readonly home?: string;\n  readonly local?: boolean;\n  readonly warn?: (message: string) => void;\n}\n\nexport interface ConversationStore {\n  readonly name: string;\n  locate(\n    id: string,\n    repository: string,\n    home?: string,\n  ): Promise<ConversationRecord>;\n  capture(\n    id: string,\n    context: ConversationContext,\n  ): Promise<ConversationRecord>;\n  restore(\n    record: ConversationRecord,\n    context: ConversationContext,\n  ): Promise<void>;\n}\n"]}
+{"version":3,"file":"conversation.types.js","sourceRoot":"","sources":["../../src/domain/conversation.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { TransportReference } from \"./transport.types.ts\";\nimport type { SandboxLease } from \"./sandbox.types.ts\";\n\nexport interface ConversationRecord {\n  readonly id: string;\n  readonly file: string;\n  readonly reference?: TransportReference;\n  readonly format: string;\n}\n\nexport interface ConversationContext {\n  readonly repository: string;\n  readonly sandbox: SandboxLease;\n  readonly staging: string;\n  readonly home?: string;\n  readonly local?: boolean;\n  readonly warn?: (message: string) => void;\n}\n\nexport interface ConversationStore {\n  readonly name: string;\n  readonly format?: string;\n  locate(\n    id: string,\n    repository: string,\n    home?: string,\n  ): Promise<ConversationRecord>;\n  capture(\n    id: string,\n    context: ConversationContext,\n  ): Promise<ConversationRecord>;\n  restore(\n    record: ConversationRecord,\n    context: ConversationContext,\n  ): Promise<void>;\n}\n\nexport interface NativeConversationStore extends ConversationStore {\n  /** Persisted format name, used in transport keys, bundles and records. */\n  readonly format: string;\n  /** Host directory that holds this format's captured conversations. */\n  directory(repository: string, home?: string): string;\n  /** Sandbox path that restoration writes for a captured conversation. */\n  destination(id: string, sandbox: SandboxLease, original: string): string;\n}\n"]}

package/dist/domain/cron.constants.d.ts

@@ -0,0 +1,10 @@
+import type { CronField } from "./cron.types.ts";
+export declare const cronFields: readonly CronField[];
+export declare const cronMacros: Readonly<Record<string, string>>;
+export declare const cronDefaultTimeZone = "UTC";
+export declare const cronMaxExpressionLength = 256;
+/** Covers a February 29 slot across a skipped leap year. */
+export declare const cronSearchDays: number;
+export declare const cronDayMs = 86400000;
+/** Bounds every real UTC offset, so candidates outside it are skipped cheaply. */
+export declare const cronOffsetBoundMs: number;

package/dist/domain/cron.constants.js

@@ -0,0 +1,47 @@
+export const cronFields = [
+    { name: "minute", min: 0, max: 59 },
+    { name: "hour", min: 0, max: 23 },
+    { name: "day of month", min: 1, max: 31 },
+    {
+        name: "month",
+        min: 1,
+        max: 12,
+        names: [
+            "JAN",
+            "FEB",
+            "MAR",
+            "APR",
+            "MAY",
+            "JUN",
+            "JUL",
+            "AUG",
+            "SEP",
+            "OCT",
+            "NOV",
+            "DEC",
+        ],
+    },
+    {
+        name: "day of week",
+        min: 0,
+        max: 7,
+        names: ["SUN", "MON", "TUE", "WED", "THU", "FRI", "SAT"],
+    },
+];
+export const cronMacros = {
+    "@yearly": "0 0 1 1 *",
+    "@annually": "0 0 1 1 *",
+    "@monthly": "0 0 1 * *",
+    "@weekly": "0 0 * * 0",
+    "@daily": "0 0 * * *",
+    "@midnight": "0 0 * * *",
+    "@hourly": "0 * * * *",
+};
+export const cronDefaultTimeZone = "UTC";
+export const cronMaxExpressionLength = 256;
+/** Covers a February 29 slot across a skipped leap year. */
+export const cronSearchDays = 366 * 8 + 2;
+export const cronDayMs = 86_400_000;
+/** Bounds every real UTC offset, so candidates outside it are skipped cheaply. */
+export const cronOffsetBoundMs = 15 * 3_600_000;
+//# sourceMappingURL=cron.constants.js.map

package/dist/domain/cron.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.constants.js","sourceRoot":"","sources":["../../src/domain/cron.constants.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAyB;IAC9C,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;IACnC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;IACjC,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE;IACzC;QACE,IAAI,EAAE,OAAO;QACb,GAAG,EAAE,CAAC;QACN,GAAG,EAAE,EAAE;QACP,KAAK,EAAE;YACL,KAAK;YACL,KAAK;YACL,KAAK;YACL,KAAK;YACL,KAAK;YACL,KAAK;YACL,KAAK;YACL,KAAK;YACL,KAAK;YACL,KAAK;YACL,KAAK;YACL,KAAK;SACN;KACF;IACD;QACE,IAAI,EAAE,aAAa;QACnB,GAAG,EAAE,CAAC;QACN,GAAG,EAAE,CAAC;QACN,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;KACzD;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAqC;IAC1D,SAAS,EAAE,WAAW;IACtB,WAAW,EAAE,WAAW;IACxB,UAAU,EAAE,WAAW;IACvB,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,WAAW;IACrB,WAAW,EAAE,WAAW;IACxB,SAAS,EAAE,WAAW;CACvB,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AACzC,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAC3C,4DAA4D;AAC5D,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;AAC1C,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAC;AACpC,kFAAkF;AAClF,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,GAAG,SAAS,CAAC","sourcesContent":["import type { CronField } from \"./cron.types.ts\";\n\nexport const cronFields: readonly CronField[] = [\n  { name: \"minute\", min: 0, max: 59 },\n  { name: \"hour\", min: 0, max: 23 },\n  { name: \"day of month\", min: 1, max: 31 },\n  {\n    name: \"month\",\n    min: 1,\n    max: 12,\n    names: [\n      \"JAN\",\n      \"FEB\",\n      \"MAR\",\n      \"APR\",\n      \"MAY\",\n      \"JUN\",\n      \"JUL\",\n      \"AUG\",\n      \"SEP\",\n      \"OCT\",\n      \"NOV\",\n      \"DEC\",\n    ],\n  },\n  {\n    name: \"day of week\",\n    min: 0,\n    max: 7,\n    names: [\"SUN\", \"MON\", \"TUE\", \"WED\", \"THU\", \"FRI\", \"SAT\"],\n  },\n];\n\nexport const cronMacros: Readonly<Record<string, string>> = {\n  \"@yearly\": \"0 0 1 1 *\",\n  \"@annually\": \"0 0 1 1 *\",\n  \"@monthly\": \"0 0 1 * *\",\n  \"@weekly\": \"0 0 * * 0\",\n  \"@daily\": \"0 0 * * *\",\n  \"@midnight\": \"0 0 * * *\",\n  \"@hourly\": \"0 * * * *\",\n};\n\nexport const cronDefaultTimeZone = \"UTC\";\nexport const cronMaxExpressionLength = 256;\n/** Covers a February 29 slot across a skipped leap year. */\nexport const cronSearchDays = 366 * 8 + 2;\nexport const cronDayMs = 86_400_000;\n/** Bounds every real UTC offset, so candidates outside it are skipped cheaply. */\nexport const cronOffsetBoundMs = 15 * 3_600_000;\n"]}

package/dist/domain/cron.d.ts

@@ -0,0 +1,2 @@
+import type { CronOptions, CronSchedule } from "./cron.types.ts";
+export declare function createCronSchedule(expression: string, options?: CronOptions): CronSchedule;

package/dist/domain/cron.js

@@ -0,0 +1,169 @@
+import { cronDayMs, cronDefaultTimeZone, cronFields, cronMacros, cronMaxExpressionLength, cronOffsetBoundMs, cronSearchDays, } from "./cron.constants.js";
+function fieldValue(token, field) {
+    const named = field.names?.indexOf(token.toUpperCase()) ?? -1;
+    if (named >= 0)
+        return field.min + named;
+    const value = /^\d{1,2}$/.test(token) ? Number(token) : Number.NaN;
+    if (!(value >= field.min && value <= field.max))
+        throw new Error(`Invalid cron ${field.name}: ${token}`);
+    return value;
+}
+function fieldRange(range, field, stepped) {
+    if (range === "*")
+        return [field.min, field.max];
+    const [first, last, extra] = range.split("-");
+    if (extra !== undefined || first === undefined)
+        throw new Error(`Invalid cron ${field.name}: ${range}`);
+    const start = fieldValue(first, field);
+    if (last !== undefined)
+        return [start, fieldValue(last, field)];
+    return [start, stepped ? field.max : start];
+}
+function parseField(text, field) {
+    const values = new Set();
+    for (const part of text.split(",")) {
+        const [range, stepText, extra] = part.split("/");
+        if (extra !== undefined || !range)
+            throw new Error(`Invalid cron ${field.name}: ${part}`);
+        const step = stepText === undefined ? 1 : Number(stepText);
+        if (!/^\d+$/.test(stepText ?? "1") || step < 1 || step > field.max)
+            throw new Error(`Invalid cron ${field.name} step: ${part}`);
+        const [start, end] = fieldRange(range, field, stepText !== undefined);
+        if (start > end)
+            throw new Error(`Invalid cron ${field.name}: ${part}`);
+        for (let value = start; value <= end; value += step)
+            values.add(value);
+    }
+    return values;
+}
+function parsePattern(expression) {
+    const fields = expression.split(" ");
+    if (fields.length !== cronFields.length)
+        throw new Error("Cron expressions require five fields");
+    const [minutes, hours, days, months, weekdays] = fields.map((text, index) => parseField(text, cronFields[index]));
+    if (weekdays.delete(7))
+        weekdays.add(0);
+    return Object.freeze({
+        minutes: [...minutes].sort((a, b) => a - b),
+        hours: [...hours].sort((a, b) => a - b),
+        days,
+        months,
+        weekdays,
+        eitherDay: !fields[2].startsWith("*") && !fields[4].startsWith("*"),
+    });
+}
+function matchesDay(pattern, date) {
+    if (!pattern.months.has(date.getUTCMonth() + 1))
+        return false;
+    const day = pattern.days.has(date.getUTCDate());
+    const weekday = pattern.weekdays.has(date.getUTCDay());
+    return pattern.eitherDay ? day || weekday : day && weekday;
+}
+function zoneFormatter(timeZone) {
+    try {
+        return new Intl.DateTimeFormat("en-US", {
+            timeZone,
+            hourCycle: "h23",
+            year: "numeric",
+            month: "numeric",
+            day: "numeric",
+            hour: "numeric",
+            minute: "numeric",
+            second: "numeric",
+        });
+    }
+    catch {
+        throw new Error(`Invalid cron time zone: ${timeZone}`);
+    }
+}
+function zoneClock(timeZone) {
+    const formatter = zoneFormatter(timeZone);
+    const utc = formatter.resolvedOptions().timeZone === "UTC";
+    function wallClock(instant) {
+        const parts = Object.fromEntries(formatter
+            .formatToParts(instant)
+            .map((part) => [part.type, Number(part.value)]));
+        return Date.UTC(parts.year, parts.month - 1, parts.day, parts.hour, parts.minute, parts.second);
+    }
+    /** Offsets observed around a local day; two values mark a DST transition. */
+    function offsets(day) {
+        if (utc)
+            return [0];
+        const probes = [-cronDayMs, 0, cronDayMs, 2 * cronDayMs].map((shift) => day + shift);
+        return [...new Set(probes.map((probe) => wallClock(probe) - probe))];
+    }
+    /** Earliest instant showing this wall-clock time; none inside a DST gap. */
+    function instant(local, around) {
+        if (around.length === 1)
+            return local - around[0];
+        const matches = around
+            .map((offset) => local - offset)
+            .filter((candidate) => wallClock(candidate) === local);
+        return matches.length ? Math.min(...matches) : undefined;
+    }
+    return {
+        timeZone: formatter.resolvedOptions().timeZone,
+        wallClock,
+        offsets,
+        instant,
+    };
+}
+function checkedTime(value, name) {
+    const time = value instanceof Date ? value.getTime() : Number.NaN;
+    if (!Number.isFinite(time))
+        throw new Error(`Invalid cron ${name} date`);
+    return time;
+}
+function localStart(wallClock) {
+    return wallClock - (wallClock % cronDayMs);
+}
+function localTimes(pattern, day) {
+    return pattern.hours.flatMap((hour) => pattern.minutes.map((minute) => day + hour * 3_600_000 + minute * 60_000));
+}
+function normalizedExpression(expression) {
+    if (typeof expression !== "string" ||
+        expression.length > cronMaxExpressionLength)
+        throw new Error("Invalid cron expression");
+    const text = expression.trim().split(/\s+/).join(" ");
+    return cronMacros[text.toLowerCase()] ?? text;
+}
+export function createCronSchedule(expression, options = {}) {
+    const text = normalizedExpression(expression);
+    const pattern = parsePattern(text);
+    const zone = zoneClock(options.timeZone ?? cronDefaultTimeZone);
+    function search(from, direction, accept) {
+        const first = localStart(zone.wallClock(from)) - direction * cronDayMs;
+        for (let index = 0; index < cronSearchDays; index++) {
+            const day = first + direction * index * cronDayMs;
+            if (!matchesDay(pattern, new Date(day)))
+                continue;
+            const times = localTimes(pattern, day);
+            if (direction < 0)
+                times.reverse();
+            const around = zone.offsets(day);
+            for (const local of times) {
+                if (direction * (local - from) < -cronOffsetBoundMs)
+                    continue;
+                const at = zone.instant(local, around);
+                if (at !== undefined && accept(at))
+                    return new Date(at);
+            }
+        }
+        throw new Error(`Cron expression has no occurrence: ${text}`);
+    }
+    const schedule = {
+        expression: text,
+        timeZone: zone.timeZone,
+        next(after) {
+            const from = checkedTime(after, "start");
+            return search(from, 1, (at) => at > from);
+        },
+        previous(at) {
+            const until = checkedTime(at, "end");
+            return search(until, -1, (candidate) => candidate <= until);
+        },
+    };
+    search(Date.UTC(2000, 0, 1), 1, () => true);
+    return Object.freeze(schedule);
+}
+//# sourceMappingURL=cron.js.map