@tangle-network/braid 0.1.0

package/dist/app/application-port-runtime.js

@@ -0,0 +1,55 @@
+import { buildPortViews } from './application-port-builder.js';
+import { startApplicationRun } from './application-support.js';
+export function buildApplicationPortRuntime(input) {
+    const state = {
+        currentState: input.currentState,
+        profile: input.profile,
+        findRun: (runId) => {
+            const run = input.currentState().runs.find((candidate) => candidate.id === runId);
+            if (!run)
+                throw new Error(`Run ${runId} is unknown`);
+            return run;
+        },
+        isTerminal: (status) => status === 'completed' ||
+            status === 'failed' ||
+            status === 'aborted' ||
+            status === 'cancelled' ||
+            status === 'blocked' ||
+            status === 'expired' ||
+            status === 'unknown',
+    };
+    const journal = {
+        commit: input.commit,
+        commitAndWait: input.commitAndWait,
+        commitBatchAndWait: input.commitBatchAndWait,
+        commitAndWaitRecovery: input.commitAndWaitRecovery,
+    };
+    return buildPortViews({
+        state,
+        journal,
+        execution: input.execution,
+        ledger: input.ledger,
+        effects: input.effects,
+        clock: input.clock,
+        ids: input.ids,
+        flush: input.flush,
+        storageFailure: input.storageFailure,
+        executeControl: input.executeControl,
+        admitPersistedSend: input.admitPersistedSend,
+        fingerprint: input.fingerprint,
+        startRun: (context, runInput, admission, abort, requestDigest) => startApplicationRun({
+            effects: input.effects,
+            journal: input.journal,
+            context,
+            runInput,
+            admission,
+            abort,
+            requestDigest,
+        }),
+        send: input.send,
+        ...(input.afterRuntimeEvent === undefined
+            ? {}
+            : { afterRuntimeEvent: input.afterRuntimeEvent }),
+    });
+}
+//# sourceMappingURL=application-port-runtime.js.map

package/dist/app/application-port-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-port-runtime.js","sourceRoot":"","sources":["../../src/app/application-port-runtime.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,cAAc,EAAkB,MAAM,+BAA+B,CAAA;AAQ9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AA8B9D,MAAM,UAAU,2BAA2B,CAAC,KAAkC;IAC5E,MAAM,KAAK,GAAgB;QACzB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YACjB,MAAM,GAAG,GAAG,KAAK,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,KAAK,CAAC,CAAA;YACjF,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,KAAK,CAAC,OAAO,KAAK,aAAa,CAAC,CAAA;YACpD,OAAO,GAAG,CAAA;QACZ,CAAC;QACD,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE,CACrB,MAAM,KAAK,WAAW;YACtB,MAAM,KAAK,QAAQ;YACnB,MAAM,KAAK,SAAS;YACpB,MAAM,KAAK,WAAW;YACtB,MAAM,KAAK,SAAS;YACpB,MAAM,KAAK,SAAS;YACpB,MAAM,KAAK,SAAS;KACvB,CAAA;IACD,MAAM,OAAO,GAAkB;QAC7B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,qBAAqB,EAAE,KAAK,CAAC,qBAAqB;KACnD,CAAA;IACD,OAAO,cAAc,CAAC;QACpB,KAAK;QACL,OAAO;QACP,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,CAC/D,mBAAmB,CAAC;YAClB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO;YACP,QAAQ;YACR,SAAS;YACT,KAAK;YACL,aAAa;SACd,CAAC;QACJ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG,CAAC,KAAK,CAAC,iBAAiB,KAAK,SAAS;YACvC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,EAAE,CAAC;KACpD,CAAC,CAAA;AACJ,CAAC"}

package/dist/app/application-ports.d.ts

@@ -0,0 +1,109 @@
+import type { AgentExactRunControlRef, AgentProfile } from '@tangle-network/agent-interface';
+import type { BraidEvent } from '../domain/events.js';
+import type { RunAdmissionReceipt } from '../domain/receipts.js';
+import type { BraidRun, BraidState, RunStatus } from '../domain/state.js';
+import type { Clock } from '../ports/clock.js';
+import type { EffectRecord } from '../ports/effect-storage.js';
+import type { ControlAcknowledgement, ExecutionPort } from '../ports/execution.js';
+import type { IdSource } from '../ports/ids.js';
+import type { SendInput, SendReceipt } from './application-types.js';
+import type { RunExecutionSnapshot } from './run-execution-snapshot.js';
+import type { RunLedger } from './run-ledger.js';
+export interface StateReader {
+    readonly currentState: () => BraidState;
+    readonly profile: () => Readonly<AgentProfile>;
+    readonly findRun: (runId: string) => BraidRun;
+    readonly isTerminal: (status: RunStatus) => status is Extract<RunStatus, 'completed' | 'failed' | 'aborted' | 'cancelled' | 'blocked' | 'expired' | 'unknown'>;
+}
+export interface JournalWriter {
+    readonly commit: (event: BraidEvent) => void;
+    readonly commitAndWait: (event: BraidEvent) => void | Promise<void>;
+    /** Commits related events without allowing another transition between them. */
+    readonly commitBatchAndWait?: (events: readonly BraidEvent[]) => Promise<void>;
+    /** Retry one recovery event after a durable write has already failed. */
+    readonly commitAndWaitRecovery?: (event: BraidEvent) => void | Promise<void>;
+}
+export interface DurabilityWaiter {
+    readonly flush: () => Promise<void>;
+    readonly storageFailure?: () => unknown;
+}
+export interface ClockAccess {
+    readonly clock: Clock;
+}
+export interface IdentityAccess {
+    readonly ids: IdSource;
+}
+export interface ExecutionAccess {
+    readonly execution: ExecutionPort;
+}
+export interface LedgerAccess {
+    readonly ledger: RunLedger;
+}
+export interface AdmissionReplayAccess {
+    readonly admitPersistedSend: (operationId: string, digest: string) => SendReceipt | undefined;
+    readonly fingerprint: (input: {
+        readonly effectKind: string;
+        readonly request: unknown;
+    }) => string;
+}
+export interface RunStarter {
+    readonly startRun: (input: RunExecutionSnapshot, admission: RunAdmissionReceipt, abort: AbortController, requestDigest: string) => Promise<unknown>;
+}
+export interface SendAccess {
+    readonly send: (input: SendInput) => SendReceipt;
+}
+export interface RuntimeIngestionAccess {
+    readonly ingestRuntimeEvent: (envelope: RuntimeEventEnvelopeLike) => RuntimeEventIngestionResult | Promise<RuntimeEventIngestionResult>;
+}
+export interface ReconnectAccess {
+    readonly reconnectRun: (input: ReconnectInput) => Promise<BraidState>;
+}
+export interface WaitAccess {
+    readonly waitForRun: (runId: string) => Promise<BraidState>;
+}
+export interface ControlDispatchAccess {
+    readonly executeControl: (input: ControlEffectRequest, options?: ControlDispatchOptions) => Promise<ControlAcknowledgement>;
+}
+export interface ControlDispatchOptions {
+    /** Receives one provider result that settled after the foreground deadline. */
+    readonly onLateSettlement?: (acknowledgement: ControlAcknowledgement) => void | Promise<void>;
+}
+export interface CancelTimingAccess {
+    readonly cancelTimeoutMs: number;
+}
+export type AdmissionPort = StateReader & JournalWriter & ClockAccess & IdentityAccess & ExecutionAccess & LedgerAccess & AdmissionReplayAccess & RunStarter;
+export type AsyncAdmissionPort = AdmissionPort & DurabilityWaiter;
+export type NativeContinuationPort = StateReader & ExecutionAccess & SendAccess;
+export type ExecutionRunPort = StateReader & JournalWriter & DurabilityWaiter & ClockAccess & ExecutionAccess & LedgerAccess & RuntimeIngestionAccess & ReconnectAccess & SendAccess;
+export type ControlPort = StateReader & JournalWriter & ExecutionAccess & LedgerAccess & ControlDispatchAccess & {
+    readonly currentEffect: (operationId: string) => EffectRecord | undefined;
+};
+export type QueuePort = StateReader & JournalWriter;
+export type IngestionPort = StateReader & JournalWriter & LedgerAccess;
+export type ReplayPort = StateReader & JournalWriter & ExecutionAccess & LedgerAccess & RuntimeIngestionAccess;
+export type StatusPort = StateReader & LedgerAccess;
+export type RestartPort = StateReader & JournalWriter & ExecutionAccess;
+export interface ControlEffectRequest {
+    readonly operationId: string;
+    readonly runId: string;
+    readonly control: 'cancel' | 'steer' | 'detach';
+    readonly providerSessionId?: string;
+    readonly controlRef?: AgentExactRunControlRef;
+    readonly reason?: string;
+    readonly text?: string;
+    readonly cursor?: string;
+}
+export type RuntimeEventEnvelopeLike = import('../domain/runtime-events.js').RuntimeEventEnvelope;
+export interface RuntimeEventIngestionResult {
+    readonly accepted: boolean;
+    readonly duplicate: boolean;
+    readonly sequenceGap?: {
+        readonly from: number;
+        readonly to: number;
+    };
+}
+export interface ReconnectInput {
+    readonly operationId: string;
+    readonly runId: string;
+}
+//# sourceMappingURL=application-ports.d.ts.map

package/dist/app/application-ports.d.ts.map

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

package/dist/app/application-ports.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=application-ports.js.map

package/dist/app/application-ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-ports.js","sourceRoot":"","sources":["../../src/app/application-ports.ts"],"names":[],"mappings":""}

package/dist/app/application-runtime-wiring.d.ts

@@ -0,0 +1,45 @@
+import type { BraidEvent } from '../domain/events.js';
+import type { BraidState } from '../domain/state.js';
+import type { Clock } from '../ports/clock.js';
+import type { ExecutionPort } from '../ports/execution.js';
+import type { IdSource } from '../ports/ids.js';
+import type { PortViews } from './application-port-builder.js';
+import type { ControlDispatchOptions, ControlEffectRequest } from './application-ports.js';
+import type { ApplicationJournal } from './application-support.js';
+import { type TransitionHost } from './application-transition.js';
+import type { AppSubscriber, SendInput, SendReceipt } from './application-types.js';
+import type { SerializedEffectCoordinator } from './effect-coordinator.js';
+import type { RunLedger } from './run-ledger.js';
+/** Pure wiring for the application's narrow ports; it owns no state. */
+export interface ApplicationRuntimeWiringInput {
+    readonly currentState: () => BraidState;
+    readonly setState: (state: BraidState) => void;
+    readonly profile: () => Readonly<import('@tangle-network/agent-interface').AgentProfile>;
+    readonly commit: (event: BraidEvent) => void;
+    readonly commitAndWait: (event: BraidEvent) => void | Promise<void>;
+    readonly commitAndWaitRecovery: (event: BraidEvent) => void | Promise<void>;
+    readonly execution: ExecutionPort;
+    readonly ledger: RunLedger;
+    readonly clock: Clock;
+    readonly ids: IdSource;
+    readonly journal: ApplicationJournal;
+    readonly effects: SerializedEffectCoordinator;
+    readonly subscribers: ReadonlySet<AppSubscriber>;
+    readonly asynchronousJournal: boolean;
+    readonly transitionTail: () => Promise<void>;
+    readonly setTransitionTail: (tail: Promise<void>) => void;
+    readonly storageFailure: () => unknown;
+    readonly markStorageFailure: (error: unknown) => void;
+    readonly flush: () => Promise<void>;
+    readonly executeControl: (input: ControlEffectRequest, options?: ControlDispatchOptions) => Promise<import('../ports/execution.js').ControlAcknowledgement>;
+    readonly admitPersistedSend: (operationId: string, digest: string) => SendReceipt | undefined;
+    readonly fingerprint: import('./application-ports.js').AdmissionReplayAccess['fingerprint'];
+    readonly send: (input: SendInput) => SendReceipt;
+    readonly afterRuntimeEvent?: import('./application-port-builder.js').PortBuilderInput['afterRuntimeEvent'];
+}
+export interface ApplicationRuntimeWiring {
+    readonly ports: PortViews;
+    readonly transition: TransitionHost;
+}
+export declare function wireApplicationRuntime(input: ApplicationRuntimeWiringInput): ApplicationRuntimeWiring;
+//# sourceMappingURL=application-runtime-wiring.d.ts.map

package/dist/app/application-runtime-wiring.d.ts.map

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

package/dist/app/application-runtime-wiring.js

@@ -0,0 +1,42 @@
+import { buildApplicationPortRuntime } from './application-port-runtime.js';
+import { commitEventsAndWaitAtRevision, createTransitionHost, } from './application-transition.js';
+export function wireApplicationRuntime(input) {
+    const transition = createTransitionHost({
+        state: input.currentState,
+        setState: input.setState,
+        journal: input.journal,
+        clock: input.clock,
+        providerEventKeys: input.ledger,
+        subscribers: input.subscribers,
+        asynchronous: input.asynchronousJournal,
+        transitionTail: input.transitionTail,
+        setTransitionTail: input.setTransitionTail,
+        storageFailure: input.storageFailure,
+        markStorageFailure: input.markStorageFailure,
+    });
+    const ports = buildApplicationPortRuntime({
+        currentState: input.currentState,
+        profile: input.profile,
+        commit: input.commit,
+        commitAndWait: input.commitAndWait,
+        commitBatchAndWait: (events) => commitEventsAndWaitAtRevision(transition, events),
+        commitAndWaitRecovery: input.commitAndWaitRecovery,
+        execution: input.execution,
+        ledger: input.ledger,
+        clock: input.clock,
+        ids: input.ids,
+        effects: input.effects,
+        journal: input.journal,
+        flush: input.flush,
+        storageFailure: input.storageFailure,
+        executeControl: input.executeControl,
+        admitPersistedSend: input.admitPersistedSend,
+        fingerprint: input.fingerprint,
+        send: input.send,
+        ...(input.afterRuntimeEvent === undefined
+            ? {}
+            : { afterRuntimeEvent: input.afterRuntimeEvent }),
+    });
+    return { ports, transition };
+}
+//# sourceMappingURL=application-runtime-wiring.js.map

package/dist/app/application-runtime-wiring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-runtime-wiring.js","sourceRoot":"","sources":["../../src/app/application-runtime-wiring.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAA;AAG3E,OAAO,EACL,6BAA6B,EAC7B,oBAAoB,GAErB,MAAM,6BAA6B,CAAA;AAyCpC,MAAM,UAAU,sBAAsB,CACpC,KAAoC;IAEpC,MAAM,UAAU,GAAG,oBAAoB,CAAC;QACtC,KAAK,EAAE,KAAK,CAAC,YAAY;QACzB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,iBAAiB,EAAE,KAAK,CAAC,MAAM;QAC/B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,YAAY,EAAE,KAAK,CAAC,mBAAmB;QACvC,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;QAC1C,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;KAC7C,CAAC,CAAA;IACF,MAAM,KAAK,GAAG,2BAA2B,CAAC;QACxC,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,kBAAkB,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,6BAA6B,CAAC,UAAU,EAAE,MAAM,CAAC;QACjF,qBAAqB,EAAE,KAAK,CAAC,qBAAqB;QAClD,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG,CAAC,KAAK,CAAC,iBAAiB,KAAK,SAAS;YACvC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,EAAE,CAAC;KACpD,CAAC,CAAA;IACF,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAA;AAC9B,CAAC"}

package/dist/app/application-support.d.ts

@@ -0,0 +1,61 @@
+import type { BraidEvent, BraidEventEnvelope } from '../domain/events.js';
+import type { RunAdmissionReceipt } from '../domain/receipts.js';
+import type { BraidState } from '../domain/state.js';
+import type { Clock } from '../ports/clock.js';
+import type { EffectStoragePort } from '../ports/effect-storage.js';
+import type { ExecutionRunPort, RestartPort } from './application-ports.js';
+import type { AppSubscriber, SendReceipt } from './application-types.js';
+import type { EffectDispatchResult, SerializedEffectCoordinator } from './effect-coordinator.js';
+import type { RunExecutionSnapshot } from './run-execution-snapshot.js';
+import type { RunLedger } from './run-ledger.js';
+export interface ApplicationJournal {
+    readonly all: () => readonly BraidEventEnvelope[];
+    readonly replay?: () => readonly BraidEventEnvelope[];
+    readonly initialState?: () => BraidState | undefined;
+    readonly append: (envelope: BraidEventEnvelope) => undefined | {
+        readonly appended?: boolean;
+    } | Promise<{
+        readonly appended?: boolean;
+    } | undefined>;
+    readonly appendWithState?: (envelope: BraidEventEnvelope, state: BraidState) => Promise<{
+        readonly appended?: boolean;
+    } | undefined>;
+    readonly asynchronous?: boolean;
+    readonly envelope?: (state: BraidState, event: BraidEvent) => BraidEventEnvelope;
+    readonly flush?: () => Promise<void>;
+    readonly close?: () => Promise<void>;
+}
+export declare function startApplicationRun(input: {
+    readonly effects: SerializedEffectCoordinator;
+    readonly journal: ApplicationJournal;
+    readonly context: ExecutionRunPort;
+    readonly runInput: RunExecutionSnapshot;
+    readonly admission: RunAdmissionReceipt;
+    readonly abort: AbortController;
+    readonly requestDigest: string;
+}): Promise<EffectDispatchResult>;
+export interface RestoreOperationsTarget {
+    readonly state: () => BraidState;
+    readonly ledger: RunLedger;
+}
+export declare function restoreApplicationOperations(events: readonly BraidEventEnvelope[], target: RestoreOperationsTarget): void;
+export declare function reconcileRestartRun(context: RestartPort): Promise<void>;
+export declare function admitPersistedSend(input: {
+    readonly effects: SerializedEffectCoordinator;
+    readonly operations: Pick<RunLedger, 'getOperation'>;
+    readonly state: () => BraidState;
+    readonly operationId: string;
+    readonly digest: string;
+}): SendReceipt | undefined;
+export interface CommitApplicationEventInput {
+    readonly state: BraidState;
+    readonly event: BraidEvent;
+    readonly journal: ApplicationJournal;
+    readonly clock: Clock;
+    readonly providerEventKeys: Pick<RunLedger, 'hasProviderEvent' | 'addProviderEvent'>;
+    readonly subscribers: ReadonlySet<AppSubscriber>;
+}
+export declare function commitApplicationEvent(input: CommitApplicationEventInput): BraidState;
+export declare function commitApplicationEventAsync(input: CommitApplicationEventInput): Promise<BraidState>;
+export declare function isEffectStorage(value: unknown): value is EffectStoragePort;
+//# sourceMappingURL=application-support.d.ts.map

package/dist/app/application-support.d.ts.map

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