@tangle-network/braid 0.1.0

package/dist/app/conversation-support.js.map

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

package/dist/app/conversation-types.d.ts

@@ -0,0 +1,92 @@
+import type { HarnessType } from '@tangle-network/agent-interface';
+import type { BranchRecord, ConversationRecord, DraftRecord, GraphEdgeRecord, GraphNodeRecord, OperationKind, OperationRecord, QueueRecord } from '../domain/entities.js';
+import type { BraidEvent } from '../domain/events.js';
+import type { PortableContextPlan } from '../domain/receipts.js';
+import type { BraidState } from '../domain/state.js';
+export interface ConversationHost {
+    state(): BraidState;
+    now(): string;
+    commit(event: BraidEvent): Promise<void>;
+    destroy?(input: {
+        readonly conversationId: string;
+        readonly operationId: string;
+    }): Promise<void>;
+    coordinate?<T>(input: {
+        readonly operationId: string;
+        readonly digest: string;
+    }, action: () => Promise<T>): Promise<T>;
+}
+export interface CreateConversationInput {
+    readonly operationId: string;
+    readonly title?: string;
+    readonly profileId?: string;
+    readonly connectionId?: string;
+}
+export interface OpenConversationInput {
+    readonly operationId: string;
+    readonly conversationId: string;
+    readonly branchId?: string;
+}
+export interface UpdateConversationInput {
+    readonly operationId: string;
+    readonly conversationId: string;
+}
+export interface CreateBranchInput {
+    readonly operationId: string;
+    readonly conversationId?: string;
+    readonly branchId?: string;
+    readonly throughMessageId?: string;
+    readonly text?: string;
+    readonly runner?: string;
+    readonly model?: string;
+    readonly effort?: string;
+}
+export interface CloneConversationInput {
+    readonly operationId: string;
+    readonly conversationId?: string;
+    readonly branchId?: string;
+    readonly title?: string;
+}
+export interface PlanContextInput {
+    readonly branchId?: string;
+    readonly throughMessageId?: string;
+    readonly destinationRunner?: HarnessType | string;
+}
+export interface ForkPlanInput extends CreateBranchInput {
+    readonly kind?: 'conversation' | 'workspace';
+}
+export interface ForkPlan {
+    readonly kind: 'conversation' | 'workspace';
+    readonly operationId: string;
+    readonly sourceConversationId: string;
+    readonly sourceBranchId: string;
+    readonly throughMessageId?: string;
+    readonly destinationBranchId: string;
+    readonly context: PortableContextPlan;
+    readonly environment: 'shared' | 'new' | 'unavailable';
+    readonly providerSession: 'new';
+    readonly checkpoint: 'none' | 'required' | 'unavailable';
+    readonly allowed: boolean;
+    readonly reason?: string;
+    readonly digest: string;
+}
+export interface ConversationListQuery {
+    readonly query?: string;
+    readonly workspace?: string;
+    readonly status?: 'active' | 'archived' | 'all';
+}
+export interface BuiltConversation {
+    readonly conversation: ConversationRecord;
+    readonly branch: BranchRecord;
+    readonly draft: DraftRecord;
+    readonly queue: QueueRecord;
+    readonly graphNodes: readonly GraphNodeRecord[];
+    readonly graphEdges: readonly GraphEdgeRecord[];
+}
+export interface OperationInput {
+    readonly operationId: string;
+    readonly kind: OperationKind;
+    readonly request: Readonly<Record<string, unknown>>;
+    readonly target?: OperationRecord['target'];
+}
+//# sourceMappingURL=conversation-types.d.ts.map

package/dist/app/conversation-types.d.ts.map

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

package/dist/app/conversation-types.js

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

package/dist/app/conversation-types.js.map

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

package/dist/app/conversation-visibility.d.ts

@@ -0,0 +1,6 @@
+import type { MessageRecord } from '../domain/entities.js';
+import type { BranchId, MessageId } from '../domain/ids.js';
+import type { BraidState } from '../domain/state.js';
+export declare function messagesVisibleOnBranch(state: BraidState, branchId: BranchId): readonly MessageRecord[];
+export declare function messagesThroughBoundary(messages: readonly MessageRecord[], throughMessageId: MessageId | undefined): readonly MessageRecord[];
+//# sourceMappingURL=conversation-visibility.d.ts.map

package/dist/app/conversation-visibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-visibility.d.ts","sourceRoot":"","sources":["../../src/app/conversation-visibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAGpD,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,QAAQ,GACjB,SAAS,aAAa,EAAE,CAE1B;AA2BD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,SAAS,aAAa,EAAE,EAClC,gBAAgB,EAAE,SAAS,GAAG,SAAS,GACtC,SAAS,aAAa,EAAE,CAU1B"}

package/dist/app/conversation-visibility.js

@@ -0,0 +1,33 @@
+import { AppError } from './errors.js';
+export function messagesVisibleOnBranch(state, branchId) {
+    return visibleForBranch(state, branchId, new Set());
+}
+function visibleForBranch(state, branchId, visiting) {
+    if (visiting.has(branchId))
+        throw new AppError('GRAPH_CYCLE', `Branch ancestry includes ${branchId}`);
+    const branch = state.branches.find((candidate) => candidate.id === branchId);
+    if (!branch)
+        throw new AppError('UNKNOWN_BRANCH', `Branch ${branchId} does not exist`);
+    visiting.add(branchId);
+    try {
+        const inherited = branch.source
+            ? messagesThroughBoundary(visibleForBranch(state, branch.source.branchId, visiting), branch.source.throughMessageId)
+            : [];
+        const local = state.messages.filter((message) => message.branchId === branchId);
+        const seen = new Set(inherited.map((message) => message.id));
+        return [...inherited, ...local.filter((message) => !seen.has(message.id))];
+    }
+    finally {
+        visiting.delete(branchId);
+    }
+}
+export function messagesThroughBoundary(messages, throughMessageId) {
+    if (throughMessageId === undefined)
+        return [];
+    const index = messages.findIndex((message) => message.id === throughMessageId);
+    if (index < 0) {
+        throw new AppError('UNKNOWN_MESSAGE_BOUNDARY', `Message ${throughMessageId} is not visible on the source branch`);
+    }
+    return messages.slice(0, index + 1);
+}
+//# sourceMappingURL=conversation-visibility.js.map

package/dist/app/conversation-visibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-visibility.js","sourceRoot":"","sources":["../../src/app/conversation-visibility.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAEtC,MAAM,UAAU,uBAAuB,CACrC,KAAiB,EACjB,QAAkB;IAElB,OAAO,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,GAAG,EAAE,CAAC,CAAA;AACrD,CAAC;AAED,SAAS,gBAAgB,CACvB,KAAiB,EACjB,QAAkB,EAClB,QAAqB;IAErB,IAAI,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC;QACxB,MAAM,IAAI,QAAQ,CAAC,aAAa,EAAE,4BAA4B,QAAQ,EAAE,CAAC,CAAA;IAC3E,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAA;IAC5E,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,QAAQ,CAAC,gBAAgB,EAAE,UAAU,QAAQ,iBAAiB,CAAC,CAAA;IACtF,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACtB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM;YAC7B,CAAC,CAAC,uBAAuB,CACrB,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,EACzD,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAC/B;YACH,CAAC,CAAC,EAAE,CAAA;QACN,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAA;QAC/E,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAA;QAC5D,OAAO,CAAC,GAAG,SAAS,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAC5E,CAAC;YAAS,CAAC;QACT,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC3B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,QAAkC,EAClC,gBAAuC;IAEvC,IAAI,gBAAgB,KAAK,SAAS;QAAE,OAAO,EAAE,CAAA;IAC7C,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,gBAAgB,CAAC,CAAA;IAC9E,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,MAAM,IAAI,QAAQ,CAChB,0BAA0B,EAC1B,WAAW,gBAAgB,sCAAsC,CAClE,CAAA;IACH,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAA;AACrC,CAAC"}

package/dist/app/conversations.d.ts

@@ -0,0 +1,27 @@
+import { ConversationBranches } from './conversation-branches.js';
+import { ConversationContext } from './conversation-context.js';
+import { ConversationDrafts } from './conversation-drafts.js';
+import { ConversationExports } from './conversation-exports.js';
+import { ConversationImports } from './conversation-imports.js';
+import { ConversationLifecycle } from './conversation-lifecycle.js';
+import type { ConversationHost } from './conversation-types.js';
+/**
+ * A small facade over focused conversation services.
+ *
+ * It owns no state: every read comes from the canonical Braid projection and
+ * every mutation goes through the canonical application event stream.
+ */
+export declare class ConversationActions {
+    readonly lifecycle: ConversationLifecycle;
+    readonly branches: ConversationBranches;
+    readonly context: ConversationContext;
+    readonly drafts: ConversationDrafts;
+    readonly exports: ConversationExports;
+    readonly imports: ConversationImports;
+    constructor(host: ConversationHost);
+}
+export type { SetConversationDraftInput, SetConversationDraftResult, } from './conversation-drafts.js';
+export type { ConversationExportDocument, ExportConversationInput, ExportConversationResult, } from './conversation-exports.js';
+export type { ImportConversationInput, ImportConversationResult, } from './conversation-imports.js';
+export type { CloneConversationInput, ConversationListQuery, CreateBranchInput, CreateConversationInput, ForkPlan, ForkPlanInput, OpenConversationInput, PlanContextInput, UpdateConversationInput, } from './conversation-types.js';
+//# sourceMappingURL=conversations.d.ts.map

package/dist/app/conversations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../../src/app/conversations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAE/D;;;;;GAKG;AACH,qBAAa,mBAAmB;IAC9B,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAA;IACzC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAA;IACvC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAA;IACrC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAA;IACnC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAA;IACrC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAA;IAErC,YAAY,IAAI,EAAE,gBAAgB,EAOjC;CACF;AAED,YAAY,EACV,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,0BAA0B,CAAA;AACjC,YAAY,EACV,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,2BAA2B,CAAA;AAClC,YAAY,EACV,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,2BAA2B,CAAA;AAClC,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,QAAQ,EACR,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,yBAAyB,CAAA"}

package/dist/app/conversations.js

@@ -0,0 +1,29 @@
+import { ConversationBranches } from './conversation-branches.js';
+import { ConversationContext } from './conversation-context.js';
+import { ConversationDrafts } from './conversation-drafts.js';
+import { ConversationExports } from './conversation-exports.js';
+import { ConversationImports } from './conversation-imports.js';
+import { ConversationLifecycle } from './conversation-lifecycle.js';
+/**
+ * A small facade over focused conversation services.
+ *
+ * It owns no state: every read comes from the canonical Braid projection and
+ * every mutation goes through the canonical application event stream.
+ */
+export class ConversationActions {
+    lifecycle;
+    branches;
+    context;
+    drafts;
+    exports;
+    imports;
+    constructor(host) {
+        this.lifecycle = new ConversationLifecycle(host);
+        this.branches = new ConversationBranches(host);
+        this.context = new ConversationContext(host);
+        this.drafts = new ConversationDrafts(host);
+        this.exports = new ConversationExports(host);
+        this.imports = new ConversationImports(host);
+    }
+}
+//# sourceMappingURL=conversations.js.map

package/dist/app/conversations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.js","sourceRoot":"","sources":["../../src/app/conversations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAA;AAGnE;;;;;GAKG;AACH,MAAM,OAAO,mBAAmB;IACrB,SAAS,CAAuB;IAChC,QAAQ,CAAsB;IAC9B,OAAO,CAAqB;IAC5B,MAAM,CAAoB;IAC1B,OAAO,CAAqB;IAC5B,OAAO,CAAqB;IAErC,YAAY,IAAsB;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAA;QAChD,IAAI,CAAC,QAAQ,GAAG,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAA;QAC9C,IAAI,CAAC,OAAO,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAA;QAC5C,IAAI,CAAC,MAAM,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAA;QAC1C,IAAI,CAAC,OAAO,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAA;QAC5C,IAAI,CAAC,OAAO,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAA;IAC9C,CAAC;CACF"}

package/dist/app/durable-send.d.ts

@@ -0,0 +1,33 @@
+import type { BraidState } from '../domain/state.js';
+import type { IdSource } from '../ports/ids.js';
+import type { AdmissionRegistration } from './application-lifecycle.js';
+import type { SendReceipt } from './application-types.js';
+import type { RunExecutionSnapshot } from './run-execution-snapshot.js';
+export interface DurableSendInput {
+    readonly input: RunExecutionSnapshot;
+    readonly state: BraidState;
+    readonly currentState: () => BraidState;
+    readonly ids: IdSource;
+    readonly restartReconciliation: Promise<void>;
+    readonly transitionTail: Promise<void>;
+    readonly admitPersistedSend: (operationId: string, digest: string) => SendReceipt | undefined;
+    readonly requestDigest: (state: BraidState, input: RunExecutionSnapshot) => string;
+    readonly registerAdmission: (runId: string) => AdmissionRegistration;
+    readonly sendAsync: (input: RunExecutionSnapshot, ids: {
+        readonly runId: string;
+        readonly turnId: string;
+    }, signal: AbortSignal) => Promise<SendReceipt>;
+}
+export interface DurableSendRuntime {
+    readonly currentState: () => BraidState;
+    readonly ids: IdSource;
+    readonly restartReconciliation: Promise<void>;
+    readonly transitionTail: () => Promise<void>;
+    readonly admitPersistedSend: (operationId: string, digest: string) => SendReceipt | undefined;
+    readonly requestDigest: DurableSendInput['requestDigest'];
+    readonly registerAdmission: DurableSendInput['registerAdmission'];
+    readonly sendAsync: DurableSendInput['sendAsync'];
+}
+export declare function createDurableSender(runtime: DurableSendRuntime): (input: RunExecutionSnapshot) => SendReceipt;
+export declare function durableSend(input: DurableSendInput): SendReceipt;
+//# sourceMappingURL=durable-send.d.ts.map

package/dist/app/durable-send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-send.d.ts","sourceRoot":"","sources":["../../src/app/durable-send.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAGzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAEvE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAA;IACpC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,UAAU,CAAA;IACvC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAA;IACtB,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7C,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IACtC,QAAQ,CAAC,kBAAkB,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,CAAA;IAC7F,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,oBAAoB,KAAK,MAAM,CAAA;IAClF,QAAQ,CAAC,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,qBAAqB,CAAA;IACpE,QAAQ,CAAC,SAAS,EAAE,CAClB,KAAK,EAAE,oBAAoB,EAC3B,GAAG,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EACxD,MAAM,EAAE,WAAW,KAChB,OAAO,CAAC,WAAW,CAAC,CAAA;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,UAAU,CAAA;IACvC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAA;IACtB,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7C,QAAQ,CAAC,cAAc,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C,QAAQ,CAAC,kBAAkB,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS,CAAA;IAC7F,QAAQ,CAAC,aAAa,EAAE,gBAAgB,CAAC,eAAe,CAAC,CAAA;IACzD,QAAQ,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,mBAAmB,CAAC,CAAA;IACjE,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAA;CAClD;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,kBAAkB,GAC1B,CAAC,KAAK,EAAE,oBAAoB,KAAK,WAAW,CAgD9C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW,CA+ChE"}

package/dist/app/durable-send.js

@@ -0,0 +1,103 @@
+import { AppError } from './errors.js';
+import { pendingAdmissionReceipt } from './run-admission.js';
+export function createDurableSender(runtime) {
+    let pending;
+    return (input) => {
+        const state = runtime.currentState();
+        const digest = runtime.requestDigest(state, input);
+        const persisted = runtime.admitPersistedSend(input.operationId, digest);
+        if (persisted)
+            return persisted;
+        if (pending) {
+            if (pending.operationId !== input.operationId)
+                throw new AppError('RUN_ACTIVE', `Run ${pending.receipt.runId} is awaiting admission; queue the next input explicitly`);
+            if (pending.digest !== digest)
+                throw new AppError('OPERATION_CONFLICT', `Operation ${input.operationId} was already used with different input`);
+            return replayPendingReceipt(pending.receipt);
+        }
+        const receipt = durableSend({
+            input,
+            state,
+            currentState: runtime.currentState,
+            ids: runtime.ids,
+            restartReconciliation: runtime.restartReconciliation,
+            transitionTail: runtime.transitionTail(),
+            admitPersistedSend: runtime.admitPersistedSend,
+            requestDigest: runtime.requestDigest,
+            registerAdmission: runtime.registerAdmission,
+            sendAsync: runtime.sendAsync,
+        });
+        const reservation = { operationId: input.operationId, digest, receipt };
+        pending = reservation;
+        const clear = () => {
+            if (pending === reservation)
+                pending = undefined;
+        };
+        receipt.admissionReady?.then(clear, clear);
+        return receipt;
+    };
+}
+export function durableSend(input) {
+    const state = input.state;
+    const digest = input.requestDigest(state, input.input);
+    const replay = input.admitPersistedSend(input.input.operationId, digest);
+    if (replay)
+        return replay;
+    if (state.activeRunId)
+        throw new AppError('RUN_ACTIVE', `Run ${state.activeRunId} is still active; queue the next input explicitly`);
+    const runId = input.ids.next('run');
+    const turnId = input.ids.next('turn');
+    const registration = input.registerAdmission(runId);
+    const pending = pendingAdmissionReceipt(input.input, runId, turnId);
+    let admission = pending;
+    const admissionTask = input.restartReconciliation
+        .then(() => input.transitionTail)
+        .then(() => assertAdmissionActive(registration.signal))
+        .then(() => input.sendAsync(input.input, { runId, turnId }, registration.signal))
+        .then((result) => {
+        assertAdmissionActive(registration.signal);
+        admission = result.admission;
+        return result;
+    })
+        .catch((error) => {
+        admission = {
+            ...pending,
+            admissionStatus: 'unavailable',
+        };
+        throw error;
+    })
+        .finally(() => {
+        registration.release();
+    });
+    const task = admissionTask.then((result) => result.completion);
+    task.catch(() => undefined);
+    return {
+        operationId: input.input.operationId,
+        runId,
+        revision: state.revision,
+        replayed: false,
+        get admission() {
+            return admission;
+        },
+        admissionReady: admissionTask.then(() => undefined),
+        completion: task.then(() => structuredClone(input.currentState())),
+    };
+}
+function assertAdmissionActive(signal) {
+    if (signal.aborted)
+        throw new AppError('APPLICATION_CLOSING', 'Braid is closing and cannot materialize a run');
+}
+function replayPendingReceipt(receipt) {
+    return {
+        operationId: receipt.operationId,
+        runId: receipt.runId,
+        revision: receipt.revision,
+        replayed: true,
+        get admission() {
+            return receipt.admission;
+        },
+        ...(receipt.admissionReady === undefined ? {} : { admissionReady: receipt.admissionReady }),
+        completion: receipt.completion,
+    };
+}
+//# sourceMappingURL=durable-send.js.map

package/dist/app/durable-send.js.map

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

package/dist/app/effect-coordinator.d.ts

@@ -0,0 +1,76 @@
+import type { Clock } from '../ports/clock.js';
+import type { EffectOutcomeStatus, EffectRecord, EffectStoragePort } from '../ports/effect-storage.js';
+export interface EffectIntent<TRequest> {
+    readonly operationId: string;
+    readonly effectKind: string;
+    readonly request: TRequest;
+    /** Optional storage-owned keyed binding; never recompute it from public receipt data. */
+    readonly requestDigest?: string;
+    /**
+     * Effects sharing a key are serialized; independent keys may progress while
+     * a long-running stream effect is active.
+     */
+    readonly serializationKey?: string;
+    readonly metadata?: Readonly<Record<string, string>>;
+    readonly signal?: AbortSignal;
+}
+export interface EffectContext<TRequest> {
+    readonly operationId: string;
+    readonly effectKind: string;
+    readonly requestDigest: string;
+    readonly request: TRequest;
+    readonly signal?: AbortSignal;
+}
+export interface EffectDispatchResult {
+    readonly status: EffectOutcomeStatus;
+    readonly detail?: string;
+    readonly externalReference?: string;
+}
+export interface EffectHandler<TRequest> {
+    dispatch(context: EffectContext<TRequest>): Promise<EffectDispatchResult>;
+    /**
+     * Resolves a durable pending record through the owning external authority.
+     * Returning undefined leaves the record pending; the coordinator never
+     * guesses that a pending external mutation is safe to repeat.
+     */
+    reconcile?(context: EffectContext<TRequest>): Promise<EffectDispatchResult | undefined>;
+}
+export interface EffectCoordinatorOptions {
+    readonly onRecord?: (record: EffectRecord) => void;
+}
+export interface EffectHandle {
+    readonly operationId: string;
+    readonly requestDigest: string;
+    readonly replayed: boolean;
+    readonly record: EffectRecord;
+    readonly completion: Promise<EffectRecord>;
+}
+export declare class EffectCoordinatorError extends Error {
+    readonly code: 'EFFECT_KIND_REQUIRED' | 'OPERATION_ID_REQUIRED' | 'EFFECT_METADATA_UNSAFE' | 'EFFECT_INTENT_NOT_DURABLE';
+    constructor(code: EffectCoordinatorError['code'], message: string, options?: ErrorOptions);
+}
+export declare function effectRequestDigest<TRequest>(intent: Pick<EffectIntent<TRequest>, 'effectKind' | 'request'>): string;
+/**
+ * Serializes durable effect admission and external dispatch.
+ *
+ * The storage port is deliberately synchronous at this boundary so an
+ * application controller can commit the pending intent before it returns a
+ * receipt. A SQLite adapter can implement the same port with a synchronous
+ * transaction API while remaining replaceable behind this seam.
+ */
+export declare class SerializedEffectCoordinator {
+    #private;
+    constructor(storage: EffectStoragePort, clock: Clock, options?: EffectCoordinatorOptions);
+    current(operationId: string): EffectRecord | undefined;
+    /**
+     * Applies a provider result that arrived after the foreground deadline.
+     *
+     * Only pending or unknown records may be corrected. A later call observes
+     * the already settled record, so the operation remains idempotent.
+     */
+    settle(operationId: string, requestDigest: string, outcome: EffectDispatchResult): EffectRecord | undefined;
+    start<TRequest>(intent: EffectIntent<TRequest>, handler: EffectHandler<TRequest>): EffectHandle;
+    execute<TRequest>(intent: EffectIntent<TRequest>, handler: EffectHandler<TRequest>): Promise<EffectRecord>;
+}
+export { SerializedEffectCoordinator as EffectCoordinator };
+//# sourceMappingURL=effect-coordinator.d.ts.map

package/dist/app/effect-coordinator.d.ts.map

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