@relayflows/sdk 2.0.0

package/dist/hn-poller.js

@@ -0,0 +1,79 @@
+/**
+ * Hacker News -> relayflow events.
+ *
+ * This lives OUTSIDE `kernel/` deliberately. An earlier version called Hacker
+ * News from `kernel/relayflowd` and review rejected it (PR #16, P1): a
+ * durable-execution kernel must not own provider-specific product logic or
+ * network I/O, or engine availability and dependencies become coupled to an
+ * external service. The kernel gained a `ureq` dependency purely to fetch a
+ * JSON feed — a clear sign the code was in the wrong place.
+ *
+ * So the adapter sits on the authoring surface and submits its events through
+ * the journal protocol (`event.submit`), which is the same path any other
+ * external producer would use. The kernel learns about Hacker News the way it
+ * learns about everything else: as an event.
+ */
+const TOP_STORIES_URL = 'https://hacker-news.firebaseio.com/v0/topstories.json';
+const DEFAULT_STORY_LIMIT = 5;
+/**
+ * Typed fetch-transport error. Callers (like sdk/src/cli/hn-monitor.ts)
+ * `instanceof` this to distinguish transient HN fetch failures from
+ * journal failures — avoids message-string matching (fragile cross-module
+ * coupling) and covers the shapes fetch() itself throws (network errors,
+ * ECONNREFUSED, TypeError('fetch failed')).
+ */
+export class HnTransientFetchError extends Error {
+    constructor(message, cause) {
+        // Use the native ErrorOptions.cause path so stack formatting and
+        // downstream inspectors (util.inspect, structured loggers) see it.
+        super(message, cause !== undefined ? { cause } : undefined);
+        this.name = 'HnTransientFetchError';
+    }
+}
+const defaultFetcher = async (url) => {
+    let response;
+    try {
+        response = await fetch(url);
+    }
+    catch (cause) {
+        // Network-layer failures from fetch() itself — TypeError('fetch failed'),
+        // ECONNREFUSED, DNS lookup failures — are all transient.
+        throw new HnTransientFetchError(`HN fetch failed: ${String(cause)}`, cause);
+    }
+    if (!response.ok) {
+        throw new HnTransientFetchError(`HN fetch failed: HTTP ${response.status}`);
+    }
+    return response.text();
+};
+/**
+ * Fetch the top-stories feed once and submit each story as an event.
+ *
+ * Dedupe is the kernel's job, not ours: the flow's `dedupeKeyTemplate` plus the
+ * (flow, subscription, key) claim means submitting the same story twice wakes
+ * it once. This function deliberately does not track what it has already seen.
+ */
+export async function pollHackerNewsOnce(spec, sink, options = {}) {
+    const storyLimit = options.storyLimit ?? DEFAULT_STORY_LIMIT;
+    const fetcher = options.fetcher ?? defaultFetcher;
+    const body = await fetcher(TOP_STORIES_URL);
+    let storyIds;
+    try {
+        storyIds = JSON.parse(body);
+    }
+    catch (cause) {
+        throw new HnTransientFetchError(`HN top stories response was not JSON: ${String(cause)}`);
+    }
+    if (!Array.isArray(storyIds)) {
+        throw new HnTransientFetchError('HN top stories response was not an array');
+    }
+    const outcomes = [];
+    for (const id of storyIds.slice(0, storyLimit)) {
+        outcomes.push(await sink.eventSubmit(spec, {
+            type: 'hn.story_posted',
+            payload: { id, type: 'story' },
+        }));
+    }
+    return outcomes;
+}
+export const HN_TOP_STORIES_URL = TOP_STORIES_URL;
+//# sourceMappingURL=hn-poller.js.map

package/dist/hn-poller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hn-poller.js","sourceRoot":"","sources":["../src/hn-poller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,eAAe,GAAG,uDAAuD,CAAC;AAChF,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAU9B;;;;;;GAMG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAe,EAAE,KAAe;QAC1C,iEAAiE;QACjE,mEAAmE;QACnE,KAAK,CAAC,OAAO,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,cAAc,GAAY,KAAK,EAAE,GAAG,EAAE,EAAE;IAC5C,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,0EAA0E;QAC1E,yDAAyD;QACzD,MAAM,IAAI,qBAAqB,CAAC,oBAAoB,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,qBAAqB,CAAC,yBAAyB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC,CAAC;AAQF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAa,EACb,IAAe,EACf,UAAuB,EAAE;IAEzB,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,mBAAmB,CAAC;IAC7D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,cAAc,CAAC;IAElD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC,CAAC;IAE5C,IAAI,QAAiB,CAAC;IACtB,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,qBAAqB,CAAC,yCAAyC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC5F,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,qBAAqB,CAAC,0CAA0C,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,KAAK,MAAM,EAAE,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,CAAC;QAC/C,QAAQ,CAAC,IAAI,CACX,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE;YAC3B,IAAI,EAAE,iBAAiB;YACvB,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;SAC/B,CAAC,CACH,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+export type { AgentStepSpec, AgentSurfaces, BaseStepSpec, BudgetSpec, DeterministicStepSpec, ExitCodeGate, FlowSpec, JsonSchemaGate, JsonOutputSchema, KernelAgentStep, KernelAgentSurfaces, KernelBudgetSpec, KernelDeterministicStep, KernelLlmStep, KernelPermissionsSpec, KernelRetryPolicy, KernelRunSpec, KernelStepCommon, KernelStepSpec, KernelTriggerSpec, KernelVerificationSpec, LlmStepSpec, NamedAgentSpec, OutputContainsGate, OutputVerificationSpec, PermissionsSpec, RecoveryMode, StreamSurface, StepSpec, StepType, TriggerSpec, VerificationGateType, VerificationSpec, WorkspaceSurface, } from './spec.js';
+export { SPEC_SCHEMA_VERSION } from './spec.js';
+export { canonicalize, specHash } from './canonical.js';
+export { compileAndHash, compileSpec, compileYaml, compileYamlToCanonicalJson, kernelToAuthoring, toKernelSpec, CompileError, } from './compile.js';
+export { validateSpec, type ValidationResult } from './validate.js';
+export { getAuthoredFlowDefinition, type AuthoredFlowDefinition, type FlowHandle, } from './authored-flow.js';
+export { preflight, type CliResolution, type CliResolutionSource, type CliProbeResult, type PreflightDiagnostic, type PreflightOptions, type PreflightProbes, type PreflightRefusal, type PreflightResult, type PreflightWarning, } from './preflight.js';
+export { type DataGateClassification, type JournalGateCheck, type StepGateInspection, } from './gate-contract.js';
+export { CHECK_FAILURE_KINDS, CHECK_INPUT_FAILURE_KINDS, PREFLIGHT_FAILURE_KINDS, PREFLIGHT_WARNING_KINDS, isCheckFailureKind, type CheckFailureKind, type PreflightFailureKind, type PreflightWarningKind, } from './failure-kinds.js';
+export { runCli, type CheckInputDiagnostic, type CheckReport, type CliIo } from './cli.js';
+export type { CompletionReason, EffectRecordParams, EffectRecordResult, EffectRef, EventEmitParams, EventEmitResult, HelloParams, HelloResult, JournalReadParams, JournalReadResult, ProtocolError, Pins, Request, Response, RunGetParams, RunGetResult, RunOutcome, RunCompletionReason, RunCancelParams, RunCancelResult, RunResumeParams, RunResumeResult, RunStatus, RunWatchParams, RunWatchResult, ServerEvent, StepCompleteParams, StepCompleteResult, StepDispatchEvent, StepHeartbeatParams, StepHeartbeatResult, StreamAppendParams, StreamAppendResult, StreamReadParams, StreamReadResult, Verb, VerbContract, WorkerAttachParams, WorkerAttachResult, } from './protocol.js';
+export { JOURNAL_WRITE_FAILED, PROTOCOL_VERSION } from './protocol.js';
+export { JournalClient, type JournalClientOptions } from './journal-client.js';
+export { AgentWorker, type AgentWorkerOptions } from './worker.js';
+export { validateWorkPackage, packageFromEntry, type ValidatedWorkPackage, type WorkPackageValidation, type WorkPackageValidationReason, } from './backlog-picker.js';
+export { consumeWorkPackage, type EmittedWorkPackage, type WorkPackageConsumption, type WorkPackageRefusalReason, } from './work-package-consumer.js';
+export { validateNextWorkPackage, type NextWorkPackageRefusalReason, type NextWorkPackageValidation, type WorkPackagePathExists, } from './work-package-validator.js';
+export { pollHackerNewsOnce, HnTransientFetchError, HN_TOP_STORIES_URL, type EventSink, type Fetcher, type PollOptions, } from './hn-poller.js';
+export { pollDirectoryOnce, type DirLister, type PollOptions as DirWatcherPollOptions, } from './dir-watcher-poller.js';
+export { emitDueTicks, scheduledForMs, TickEmitError, slotFor, tickDedupeKey, DEFAULT_MAX_CATCH_UP, TICK_DEDUPE_KEY_TEMPLATE, TICK_EVENT_TYPE, type EventSink as TickEventSink, type TickCursor, type TickEmitResult, type TickPayload, type TickSchedule, } from './tick-source.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,30 @@
+// @relayflows/sdk — TypeScript-first authoring SDK for Relayflows.
+// Compiles specs (RFC-0001 §1 ladder) and speaks the journal protocol v0
+// (kernel DESIGN.md §5).
+export { SPEC_SCHEMA_VERSION } from './spec.js';
+export { canonicalize, specHash } from './canonical.js';
+export { compileAndHash, compileSpec, compileYaml, compileYamlToCanonicalJson, kernelToAuthoring, toKernelSpec, CompileError, } from './compile.js';
+export { validateSpec } from './validate.js';
+export { getAuthoredFlowDefinition, } from './authored-flow.js';
+export { preflight, } from './preflight.js';
+export { CHECK_FAILURE_KINDS, CHECK_INPUT_FAILURE_KINDS, PREFLIGHT_FAILURE_KINDS, PREFLIGHT_WARNING_KINDS, isCheckFailureKind, } from './failure-kinds.js';
+export { runCli } from './cli.js';
+export { JOURNAL_WRITE_FAILED, PROTOCOL_VERSION } from './protocol.js';
+export { JournalClient } from './journal-client.js';
+export { AgentWorker } from './worker.js';
+export { validateWorkPackage, packageFromEntry, } from './backlog-picker.js';
+export { consumeWorkPackage, } from './work-package-consumer.js';
+export { validateNextWorkPackage, } from './work-package-validator.js';
+// Hacker News adapter — deliberately outside kernel/ (see sdk/src/hn-poller.ts).
+export { pollHackerNewsOnce, HnTransientFetchError, HN_TOP_STORIES_URL, } from './hn-poller.js';
+// Directory watcher — second proactive workload for gate 2 primitives.
+// Non-provider: no HTTP, no API tokens, no gate-6 dependency. Proves the
+// pattern generalizes without regressing RFC-0001 §6 (providers = relayfile
+// adapters, not SDK code).
+export { pollDirectoryOnce, } from './dir-watcher-poller.js';
+// Tick event source — a relayflow can be scheduled. A schedule is an event
+// source subject to the same liveness sweep as any other subscription, not a
+// scheduler inside the kernel (RFC-0001 gate 2: "triggers are entry
+// conditions, not schedulers").
+export { emitDueTicks, scheduledForMs, TickEmitError, slotFor, tickDedupeKey, DEFAULT_MAX_CATCH_UP, TICK_DEDUPE_KEY_TEMPLATE, TICK_EVENT_TYPE, } from './tick-source.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,yEAAyE;AACzE,yBAAyB;AAsCzB,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EACL,cAAc,EACd,WAAW,EACX,WAAW,EACX,0BAA0B,EAC1B,iBAAiB,EACjB,YAAY,EACZ,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,YAAY,EAAyB,MAAM,eAAe,CAAC;AAEpE,OAAO,EACL,yBAAyB,GAG1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,SAAS,GAUV,MAAM,gBAAgB,CAAC;AAMxB,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,uBAAuB,EACvB,uBAAuB,EACvB,kBAAkB,GAInB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,MAAM,EAA2D,MAAM,UAAU,CAAC;AA2C3F,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEvE,OAAO,EAAE,aAAa,EAA6B,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,WAAW,EAA2B,MAAM,aAAa,CAAC;AAEnE,OAAO,EACL,mBAAmB,EACnB,gBAAgB,GAIjB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,kBAAkB,GAInB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,uBAAuB,GAIxB,MAAM,6BAA6B,CAAC;AAErC,iFAAiF;AACjF,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,GAInB,MAAM,gBAAgB,CAAC;AAExB,uEAAuE;AACvE,yEAAyE;AACzE,4EAA4E;AAC5E,2BAA2B;AAC3B,OAAO,EACL,iBAAiB,GAGlB,MAAM,yBAAyB,CAAC;AAEjC,2EAA2E;AAC3E,6EAA6E;AAC7E,oEAAoE;AACpE,gCAAgC;AAChC,OAAO,EACL,YAAY,EACZ,cAAc,EACd,aAAa,EACb,OAAO,EACP,aAAa,EACb,oBAAoB,EACpB,wBAAwB,EACxB,eAAe,GAMhB,MAAM,kBAAkB,CAAC"}

package/dist/journal-client.d.ts

@@ -0,0 +1,122 @@
+import { EventEmitter } from 'node:events';
+import type { VerbContract, EventSubmitParams } from './protocol.js';
+import { type CompletionReason, type EffectRef, type Pins } from './protocol.js';
+import type { KernelRunSpec, StepType } from './spec.js';
+export interface JournalClientOptions {
+    /** Override the timeout for bounded protocol requests (ms). Default 30000. */
+    requestTimeoutMs?: number;
+}
+/** A structured rejection returned by relayflowd over the journal protocol. */
+export declare class JournalProtocolError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare class JournalClient extends EventEmitter {
+    private readonly socketPath;
+    private socket;
+    private buffer;
+    private readonly pending;
+    private readonly requestTimeoutMs;
+    constructor(socketPath: string, options?: JournalClientOptions);
+    /** Open the unix socket connection. Rejects on connect failure (fail-closed). */
+    connect(): Promise<void>;
+    /** Close the connection and reject any pending requests. */
+    close(): void;
+    private onData;
+    private onLine;
+    private failAll;
+    private request;
+    /** Handshake; version mismatch is a hard error. */
+    hello(client: string): Promise<VerbContract['hello']['result']>;
+    /**
+     * Validate a compiled kernel-dialect spec (zero-agent flows legal), create
+     * the run file, and append `run.spawned`. Authoring specs must be compiled
+     * with `toKernelSpec` before crossing this journal-protocol boundary.
+     */
+    runStart(spec: KernelRunSpec): Promise<VerbContract['run.start']['result']>;
+    /** §3 memoized resume. */
+    runResume(runId: string): Promise<VerbContract['run.resume']['result']>;
+    /** Durably request cancellation and return the terminal run fact. */
+    runCancel(runId: string): Promise<VerbContract['run.cancel']['result']>;
+    /** Snapshot for legibility. */
+    runGet(runId: string): Promise<VerbContract['run.get']['result']>;
+    /**
+     * Open a push stream of every appended entry. Resolves once subscribed;
+     * entries arrive as `'entry'` events: `client.on('entry', (entry) => …)`.
+     */
+    runWatch(runId: string): Promise<VerbContract['run.watch']['result']>;
+    /** Connection becomes a worker; receives `step.dispatch` events. */
+    workerAttach(workerId: string, stepTypes: StepType[], pins?: Pins, capacity?: number): Promise<VerbContract['worker.attach']['result']>;
+    /**
+     * Phase one of the writeback protocol (Appendix A rule 5): ask the journal to
+     * elect this attempt to perform the effect. **Do not call this directly to
+     * perform an effect** — use {@link performEffect}, which cannot leave the
+     * election and the provider call separated. A `false` here means this attempt
+     * owes the provider call *and* the {@link effectConfirm} that closes it;
+     * returning from `effectRecord` without doing both leaves the election open.
+     */
+    effectRecord(runId: string, stepId: string, attempt: number, idempotencyKey: string, surfacePath: string, revisionBefore: string, revisionAfter: string): Promise<VerbContract['effect.record']['result']>;
+    /**
+     * Phase two: the provider call this attempt was elected for has happened.
+     * Confirming closes the election so no later attempt reclaims it. Only the
+     * attempt holding the election may confirm it; the kernel refuses anything
+     * else.
+     */
+    effectConfirm(runId: string, stepId: string, attempt: number, idempotencyKey: string, surfacePath: string): Promise<VerbContract['effect.confirm']['result']>;
+    /**
+     * Perform one declared external effect exactly once: elect, perform, confirm.
+     *
+     * Election alone is not a promise that the writeback happened — a worker that
+     * dies between `effect.record` and its provider call would otherwise leave a
+     * winner nothing ever performed, and every retry would skip the call while
+     * the run completed as if the effect had occurred. Holding the three phases
+     * inside one call is what makes them inseparable at this boundary: `perform`
+     * runs only for the attempt that won the election, and the election is closed
+     * only after `perform` returns. A `perform` that throws leaves the election
+     * unconfirmed and therefore reclaimable, so the next attempt performs it.
+     *
+     * Returns whether this attempt made the provider call; `false` means a
+     * confirmed election already covered it.
+     */
+    performEffect(effect: {
+        runId: string;
+        stepId: string;
+        attempt: number;
+        idempotencyKey: string;
+        surfacePath: string;
+        revisionBefore: string;
+        revisionAfter: string;
+    }, perform: () => Promise<void>): Promise<boolean>;
+    /** Renew the lease — the one lease primitive. */
+    stepHeartbeat(runId: string, stepId: string, attempt: number, leaseId: string): Promise<VerbContract['step.heartbeat']['result']>;
+    /** Complete a dispatched step — also the out-of-band path. */
+    stepComplete(runId: string, stepId: string, attempt: number, idempotencyKey: string, completionReason: CompletionReason, extra?: {
+        output?: unknown;
+        usage?: {
+            tokens_in: number;
+            tokens_out: number;
+            dollars: string;
+        };
+        started_pins?: Pins;
+        end_pins?: Pins;
+        effects?: EffectRef[];
+        trajectory_tail?: unknown;
+    }): Promise<VerbContract['step.complete']['result']>;
+    /** Satisfy `wait.event`; a human response arrives here too. */
+    eventEmit(runId: string, eventKey: string, payload: unknown): Promise<VerbContract['event.emit']['result']>;
+    /**
+     * Submit an external event to a flow that declares an event trigger.
+     *
+     * Without this wrapper the verb existed on the server but was unreachable
+     * through the typed client, so authors had to bypass the protocol surface
+     * entirely to use the feature.
+     */
+    eventSubmit(spec: unknown, event: EventSubmitParams['event']): Promise<VerbContract['event.submit']['result']>;
+    /** Durable channel write; journals `stream.appended`. */
+    streamAppend(runId: string, stream: string, message: unknown): Promise<VerbContract['stream.append']['result']>;
+    /** At-least-once replayable read. Committing the consumer offset happens via pins. */
+    streamRead(runId: string, stream: string, fromOffset: number, limit?: number): Promise<VerbContract['stream.read']['result']>;
+    /** Raw journal access — replay, audit, the report step. */
+    journalRead(runId: string, fromSeq: number, limit?: number): Promise<VerbContract['journal.read']['result']>;
+}
+//# sourceMappingURL=journal-client.d.ts.map

package/dist/journal-client.d.ts.map

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

package/dist/journal-client.js

@@ -0,0 +1,277 @@
+// Journal-protocol v0 client (kernel DESIGN.md §5).
+//
+// A real client implementation of the wire protocol — newline-delimited JSON
+// over a unix socket. It correlates requests by `id`, demultiplexes
+// server-pushed events, and is fail-closed: a connection drop or write error
+// rejects every pending request (a journal write that fails fails the step;
+// AGENTS.md rule 4). The kernel binary (`kernel/relayflowd serve`) speaks
+// this transport, including out-of-band leases, watches, events, and durable
+// stream plumbing. The client's framing and failure behavior is covered by a
+// loopback double in tests.
+import { EventEmitter } from 'node:events';
+import { randomUUID } from 'node:crypto';
+import { createConnection } from 'node:net';
+import { PROTOCOL_VERSION, } from './protocol.js';
+/** A structured rejection returned by relayflowd over the journal protocol. */
+export class JournalProtocolError extends Error {
+    code;
+    constructor(code, message) {
+        super(`${code}: ${message}`);
+        this.name = 'JournalProtocolError';
+        this.code = code;
+    }
+}
+export class JournalClient extends EventEmitter {
+    socketPath;
+    socket = null;
+    buffer = '';
+    pending = new Map();
+    requestTimeoutMs;
+    constructor(socketPath, options = {}) {
+        super();
+        this.socketPath = socketPath;
+        this.requestTimeoutMs = options.requestTimeoutMs ?? 30_000;
+    }
+    /** Open the unix socket connection. Rejects on connect failure (fail-closed). */
+    connect() {
+        return new Promise((resolve, reject) => {
+            if (this.socket)
+                return resolve();
+            const socket = createConnection({ path: this.socketPath });
+            const onError = (err) => {
+                socket.removeAllListeners();
+                this.failAll(err);
+                reject(new Error(`journal client: connect failed: ${err.message}`));
+            };
+            socket.once('error', onError);
+            socket.once('connect', () => {
+                socket.removeListener('error', onError);
+                socket.on('error', (err) => this.failAll(err));
+                socket.on('data', (chunk) => this.onData(chunk));
+                socket.on('close', () => this.failAll(new Error('journal client: connection closed')));
+                this.socket = socket;
+                resolve();
+            });
+        });
+    }
+    /** Close the connection and reject any pending requests. */
+    close() {
+        this.failAll(new Error('journal client: closed by caller'));
+        this.socket?.destroy();
+        this.socket = null;
+        this.buffer = '';
+    }
+    onData(chunk) {
+        this.buffer += chunk.toString('utf8');
+        let nl;
+        while ((nl = this.buffer.indexOf('\n')) !== -1) {
+            const line = this.buffer.slice(0, nl);
+            this.buffer = this.buffer.slice(nl + 1);
+            if (line.length > 0)
+                this.onLine(line);
+        }
+    }
+    onLine(line) {
+        let msg;
+        try {
+            msg = JSON.parse(line);
+        }
+        catch {
+            // A malformed frame is a protocol violation; fail closed.
+            this.failAll(new Error('journal client: malformed frame from server'));
+            return;
+        }
+        if (typeof msg.id === 'string' && 'ok' in msg) {
+            const res = msg;
+            const pending = this.pending.get(res.id);
+            if (!pending)
+                return; // reply for an already-timed-out request
+            this.pending.delete(res.id);
+            if (pending.timer !== undefined)
+                clearTimeout(pending.timer);
+            if (res.ok)
+                pending.resolve(res.result);
+            else
+                pending.reject(new JournalProtocolError(res.error.code, res.error.message));
+        }
+        else {
+            const ev = msg;
+            this.emit(ev.event, ev.data);
+            this.emit('event', ev);
+        }
+    }
+    failAll(err) {
+        for (const [, p] of this.pending) {
+            if (p.timer !== undefined)
+                clearTimeout(p.timer);
+            p.reject(err);
+        }
+        this.pending.clear();
+    }
+    request(verb, params, timeoutMs = this.requestTimeoutMs) {
+        return new Promise((resolve, reject) => {
+            if (!this.socket || this.socket.destroyed) {
+                reject(new Error(`journal client: not connected (${verb})`));
+                return;
+            }
+            const id = randomUUID();
+            const frame = { id, verb: verb, params };
+            const timer = timeoutMs === null ? undefined : setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`journal client: ${verb} timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            this.pending.set(id, { resolve: resolve, reject, timer });
+            this.socket.write(JSON.stringify(frame) + '\n', (err) => {
+                if (err) {
+                    const p = this.pending.get(id);
+                    if (p) {
+                        if (p.timer !== undefined)
+                            clearTimeout(p.timer);
+                        this.pending.delete(id);
+                        p.reject(new Error(`journal client: ${verb} write failed: ${err.message}`));
+                    }
+                }
+            });
+        });
+    }
+    // --- Typed verb methods (gate 1 minimal set, kernel DESIGN.md §5) --------
+    /** Handshake; version mismatch is a hard error. */
+    hello(client) {
+        return this.request('hello', { protocol: PROTOCOL_VERSION, client });
+    }
+    /**
+     * Validate a compiled kernel-dialect spec (zero-agent flows legal), create
+     * the run file, and append `run.spawned`. Authoring specs must be compiled
+     * with `toKernelSpec` before crossing this journal-protocol boundary.
+     */
+    runStart(spec) {
+        return this.request('run.start', { spec }, null);
+    }
+    /** §3 memoized resume. */
+    runResume(runId) {
+        return this.request('run.resume', { run_id: runId }, null);
+    }
+    /** Durably request cancellation and return the terminal run fact. */
+    runCancel(runId) {
+        return this.request('run.cancel', { run_id: runId }, null);
+    }
+    /** Snapshot for legibility. */
+    runGet(runId) {
+        return this.request('run.get', { run_id: runId });
+    }
+    /**
+     * Open a push stream of every appended entry. Resolves once subscribed;
+     * entries arrive as `'entry'` events: `client.on('entry', (entry) => …)`.
+     */
+    runWatch(runId) {
+        return this.request('run.watch', { run_id: runId });
+    }
+    /** Connection becomes a worker; receives `step.dispatch` events. */
+    workerAttach(workerId, stepTypes, pins, capacity) {
+        return this.request('worker.attach', { worker_id: workerId, step_types: stepTypes, pins, capacity });
+    }
+    /**
+     * Phase one of the writeback protocol (Appendix A rule 5): ask the journal to
+     * elect this attempt to perform the effect. **Do not call this directly to
+     * perform an effect** — use {@link performEffect}, which cannot leave the
+     * election and the provider call separated. A `false` here means this attempt
+     * owes the provider call *and* the {@link effectConfirm} that closes it;
+     * returning from `effectRecord` without doing both leaves the election open.
+     */
+    effectRecord(runId, stepId, attempt, idempotencyKey, surfacePath, revisionBefore, revisionAfter) {
+        return this.request('effect.record', {
+            run_id: runId,
+            step_id: stepId,
+            attempt,
+            idempotency_key: idempotencyKey,
+            surface_path: surfacePath,
+            revision_before: revisionBefore,
+            revision_after: revisionAfter,
+        });
+    }
+    /**
+     * Phase two: the provider call this attempt was elected for has happened.
+     * Confirming closes the election so no later attempt reclaims it. Only the
+     * attempt holding the election may confirm it; the kernel refuses anything
+     * else.
+     */
+    effectConfirm(runId, stepId, attempt, idempotencyKey, surfacePath) {
+        return this.request('effect.confirm', {
+            run_id: runId,
+            step_id: stepId,
+            attempt,
+            idempotency_key: idempotencyKey,
+            surface_path: surfacePath,
+        });
+    }
+    /**
+     * Perform one declared external effect exactly once: elect, perform, confirm.
+     *
+     * Election alone is not a promise that the writeback happened — a worker that
+     * dies between `effect.record` and its provider call would otherwise leave a
+     * winner nothing ever performed, and every retry would skip the call while
+     * the run completed as if the effect had occurred. Holding the three phases
+     * inside one call is what makes them inseparable at this boundary: `perform`
+     * runs only for the attempt that won the election, and the election is closed
+     * only after `perform` returns. A `perform` that throws leaves the election
+     * unconfirmed and therefore reclaimable, so the next attempt performs it.
+     *
+     * Returns whether this attempt made the provider call; `false` means a
+     * confirmed election already covered it.
+     */
+    async performEffect(effect, perform) {
+        const { deduped } = await this.effectRecord(effect.runId, effect.stepId, effect.attempt, effect.idempotencyKey, effect.surfacePath, effect.revisionBefore, effect.revisionAfter);
+        if (deduped)
+            return false;
+        await perform();
+        await this.effectConfirm(effect.runId, effect.stepId, effect.attempt, effect.idempotencyKey, effect.surfacePath);
+        return true;
+    }
+    /** Renew the lease — the one lease primitive. */
+    stepHeartbeat(runId, stepId, attempt, leaseId) {
+        return this.request('step.heartbeat', {
+            run_id: runId,
+            step_id: stepId,
+            attempt,
+            lease_id: leaseId,
+        });
+    }
+    /** Complete a dispatched step — also the out-of-band path. */
+    stepComplete(runId, stepId, attempt, idempotencyKey, completionReason, extra = {}) {
+        return this.request('step.complete', {
+            run_id: runId,
+            step_id: stepId,
+            attempt,
+            idempotency_key: idempotencyKey,
+            completionReason,
+            ...extra,
+        });
+    }
+    /** Satisfy `wait.event`; a human response arrives here too. */
+    eventEmit(runId, eventKey, payload) {
+        return this.request('event.emit', { run_id: runId, event_key: eventKey, payload });
+    }
+    /**
+     * Submit an external event to a flow that declares an event trigger.
+     *
+     * Without this wrapper the verb existed on the server but was unreachable
+     * through the typed client, so authors had to bypass the protocol surface
+     * entirely to use the feature.
+     */
+    eventSubmit(spec, event) {
+        return this.request('event.submit', { spec, event });
+    }
+    /** Durable channel write; journals `stream.appended`. */
+    streamAppend(runId, stream, message) {
+        return this.request('stream.append', { run_id: runId, stream, message });
+    }
+    /** At-least-once replayable read. Committing the consumer offset happens via pins. */
+    streamRead(runId, stream, fromOffset, limit) {
+        return this.request('stream.read', { run_id: runId, stream, from_offset: fromOffset, limit });
+    }
+    /** Raw journal access — replay, audit, the report step. */
+    journalRead(runId, fromSeq, limit) {
+        return this.request('journal.read', { run_id: runId, from_seq: fromSeq, limit });
+    }
+}
+//# sourceMappingURL=journal-client.js.map

package/dist/journal-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal-client.js","sourceRoot":"","sources":["../src/journal-client.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,EAAE;AACF,6EAA6E;AAC7E,oEAAoE;AACpE,6EAA6E;AAC7E,4EAA4E;AAC5E,0EAA0E;AAC1E,6EAA6E;AAC7E,6EAA6E;AAC7E,4BAA4B;AAE5B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAe,MAAM,UAAU,CAAC;AAEzD,OAAO,EACL,gBAAgB,GAOjB,MAAM,eAAe,CAAC;AAcvB,+EAA+E;AAC/E,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACpC,IAAI,CAAS;IAEtB,YAAY,IAAY,EAAE,OAAe;QACvC,KAAK,CAAC,GAAG,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,YAAY;IAO1B;IANX,MAAM,GAAkB,IAAI,CAAC;IAC7B,MAAM,GAAG,EAAE,CAAC;IACH,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAC;IACrC,gBAAgB,CAAS;IAE1C,YACmB,UAAkB,EACnC,UAAgC,EAAE;QAElC,KAAK,EAAE,CAAC;QAHS,eAAU,GAAV,UAAU,CAAQ;QAInC,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,MAAM,CAAC;IAC7D,CAAC;IAED,iFAAiF;IACjF,OAAO;QACL,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,IAAI,CAAC,MAAM;gBAAE,OAAO,OAAO,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;YAC3D,MAAM,OAAO,GAAG,CAAC,GAAU,EAAQ,EAAE;gBACnC,MAAM,CAAC,kBAAkB,EAAE,CAAC;gBAC5B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAClB,MAAM,CAAC,IAAI,KAAK,CAAC,mCAAmC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACtE,CAAC,CAAC;YACF,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;gBAC1B,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACxC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC/C,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBACjD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC,CAAC,CAAC;gBACvF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;gBACrB,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,4DAA4D;IAC5D,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;IAEO,MAAM,CAAC,KAAa;QAC1B,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,EAAU,CAAC;QACf,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YACxC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,IAAY;QACzB,IAAI,GAA2B,CAAC;QAChC,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA2B,CAAC;QACnD,CAAC;QAAC,MAAM,CAAC;YACP,0DAA0D;YAC1D,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC,CAAC;YACvE,OAAO;QACT,CAAC;QAED,IAAI,OAAQ,GAAgB,CAAC,EAAE,KAAK,QAAQ,IAAI,IAAI,IAAK,GAAgB,EAAE,CAAC;YAC1E,MAAM,GAAG,GAAG,GAAe,CAAC;YAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO;gBAAE,OAAO,CAAC,yCAAyC;YAC/D,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC5B,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;gBAAE,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC7D,IAAI,GAAG,CAAC,EAAE;gBAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;;gBACnC,OAAO,CAAC,MAAM,CAAC,IAAI,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACnF,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,GAAG,GAAkB,CAAC;YAC9B,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;YAC7B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAEO,OAAO,CAAC,GAAU;QACxB,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS;gBAAE,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACjD,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAEO,OAAO,CACb,IAAO,EACP,MAAiC,EACjC,YAA2B,IAAI,CAAC,gBAAgB;QAEhD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBAC1C,MAAM,CAAC,IAAI,KAAK,CAAC,kCAAkC,IAAI,GAAG,CAAC,CAAC,CAAC;gBAC7D,OAAO;YACT,CAAC;YACD,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;YACxB,MAAM,KAAK,GAAY,EAAE,EAAE,EAAE,IAAI,EAAE,IAAc,EAAE,MAAM,EAAE,CAAC;YAC5D,MAAM,KAAK,GAAG,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE;gBAC7D,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACxB,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,IAAI,oBAAoB,SAAS,IAAI,CAAC,CAAC,CAAC;YAC9E,CAAC,EAAE,SAAS,CAAC,CAAC;YACd,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,OAA+B,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YAClF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE;gBACtD,IAAI,GAAG,EAAE,CAAC;oBACR,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBAC/B,IAAI,CAAC,EAAE,CAAC;wBACN,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS;4BAAE,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;wBACjD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;wBACxB,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,IAAI,kBAAkB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;oBAC9E,CAAC;gBACH,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,4EAA4E;IAE5E,mDAAmD;IACnD,KAAK,CAAC,MAAc;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC,CAAC;IACvE,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,IAAmB;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;IACnD,CAAC;IAED,0BAA0B;IAC1B,SAAS,CAAC,KAAa;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;IAC7D,CAAC;IAED,qEAAqE;IACrE,SAAS,CAAC,KAAa;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;IAC7D,CAAC;IAED,+BAA+B;IAC/B,MAAM,CAAC,KAAa;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACpD,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,KAAa;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,oEAAoE;IACpE,YAAY,CAAC,QAAgB,EAAE,SAAqB,EAAE,IAAW,EAAE,QAAiB;QAClF,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IACvG,CAAC;IAED;;;;;;;OAOG;IACH,YAAY,CACV,KAAa,EACb,MAAc,EACd,OAAe,EACf,cAAsB,EACtB,WAAmB,EACnB,cAAsB,EACtB,aAAqB;QAErB,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE;YACnC,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,MAAM;YACf,OAAO;YACP,eAAe,EAAE,cAAc;YAC/B,YAAY,EAAE,WAAW;YACzB,eAAe,EAAE,cAAc;YAC/B,cAAc,EAAE,aAAa;SAC9B,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,aAAa,CACX,KAAa,EACb,MAAc,EACd,OAAe,EACf,cAAsB,EACtB,WAAmB;QAEnB,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE;YACpC,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,MAAM;YACf,OAAO;YACP,eAAe,EAAE,cAAc;YAC/B,YAAY,EAAE,WAAW;SAC1B,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,aAAa,CACjB,MAQC,EACD,OAA4B;QAE5B,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,YAAY,CACzC,MAAM,CAAC,KAAK,EACZ,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,cAAc,EACrB,MAAM,CAAC,WAAW,EAClB,MAAM,CAAC,cAAc,EACrB,MAAM,CAAC,aAAa,CACrB,CAAC;QACF,IAAI,OAAO;YAAE,OAAO,KAAK,CAAC;QAC1B,MAAM,OAAO,EAAE,CAAC;QAChB,MAAM,IAAI,CAAC,aAAa,CACtB,MAAM,CAAC,KAAK,EACZ,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,OAAO,EACd,MAAM,CAAC,cAAc,EACrB,MAAM,CAAC,WAAW,CACnB,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iDAAiD;IACjD,aAAa,CACX,KAAa,EACb,MAAc,EACd,OAAe,EACf,OAAe;QAEf,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE;YACpC,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,MAAM;YACf,OAAO;YACP,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;IACL,CAAC;IAED,8DAA8D;IAC9D,YAAY,CACV,KAAa,EACb,MAAc,EACd,OAAe,EACf,cAAsB,EACtB,gBAAkC,EAClC,QAOI,EAAE;QAEN,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE;YACnC,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,MAAM;YACf,OAAO;YACP,eAAe,EAAE,cAAc;YAC/B,gBAAgB;YAChB,GAAG,KAAK;SACT,CAAC,CAAC;IACL,CAAC;IAED,+DAA+D;IAC/D,SAAS,CAAC,KAAa,EAAE,QAAgB,EAAE,OAAgB;QACzD,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IACrF,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,IAAa,EAAE,KAAiC;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,yDAAyD;IACzD,YAAY,CAAC,KAAa,EAAE,MAAc,EAAE,OAAgB;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,sFAAsF;IACtF,UAAU,CAAC,KAAa,EAAE,MAAc,EAAE,UAAkB,EAAE,KAAc;QAC1E,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IAChG,CAAC;IAED,2DAA2D;IAC3D,WAAW,CAAC,KAAa,EAAE,OAAe,EAAE,KAAc;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IACnF,CAAC;CACF"}

package/dist/json-schema-bound.d.ts

@@ -0,0 +1,7 @@
+export declare const UNBOUNDED_REF_CYCLE = "unbounded $ref cycle";
+/**
+ * Refuse a declaration whose validation is not guaranteed to terminate.
+ * Returns the named refusal, or `undefined` when the schema is bounded.
+ */
+export declare function jsonSchemaBoundError(schema: unknown): string | undefined;
+//# sourceMappingURL=json-schema-bound.d.ts.map

package/dist/json-schema-bound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema-bound.d.ts","sourceRoot":"","sources":["../src/json-schema-bound.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,mBAAmB,yBAAyB,CAAC;AAoR1D;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAyDxE"}