@tangle-network/braid 0.1.0

package/dist/app/effect-coordinator.js

@@ -0,0 +1,272 @@
+import { canonicalDigest } from '../domain/canonical.js';
+import { isSafePublicMetadata } from '../domain/public-metadata.js';
+export class EffectCoordinatorError extends Error {
+    code;
+    constructor(code, message, options) {
+        super(message, options);
+        this.name = 'EffectCoordinatorError';
+        this.code = code;
+    }
+}
+export function effectRequestDigest(intent) {
+    return canonicalDigest({ effectKind: intent.effectKind, request: intent.request });
+}
+const SECRET_TEXT = /(secret|password|passphrase|token|bearer|authorization|credential|private(?:[_-]?key)?|api[-_]?key)\s*[:=]/iu;
+const SAFE_DETAIL = /^[A-Za-z][A-Za-z0-9._:-]{0,127}$/u;
+const SAFE_EXTERNAL_REFERENCE = /^[A-Za-z0-9][A-Za-z0-9._:/-]{0,255}$/u;
+function safeDetail(value, fallback) {
+    if (value === undefined)
+        return undefined;
+    const candidate = value.trim();
+    return SAFE_DETAIL.test(candidate) && !SECRET_TEXT.test(candidate) ? candidate : fallback;
+}
+function safeExternalReference(value) {
+    if (value === undefined)
+        return undefined;
+    const candidate = value.trim();
+    return SAFE_EXTERNAL_REFERENCE.test(candidate) && !SECRET_TEXT.test(candidate)
+        ? candidate
+        : undefined;
+}
+/**
+ * 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 class SerializedEffectCoordinator {
+    #storage;
+    #clock;
+    #inFlight = new Map();
+    #tails = new Map();
+    #onRecord;
+    constructor(storage, clock, options = {}) {
+        this.#storage = storage;
+        this.#clock = clock;
+        this.#onRecord = options.onRecord;
+    }
+    current(operationId) {
+        const record = this.#storage.current(operationId);
+        return record === undefined ? undefined : structuredClone(record);
+    }
+    /**
+     * 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, requestDigest, outcome) {
+        const current = this.#storage.current(operationId);
+        if (current === undefined || current.requestDigest !== requestDigest)
+            return undefined;
+        if (current.status !== 'pending' && current.status !== 'unknown')
+            return structuredClone(current);
+        const detail = safeDetail(outcome.detail, `EFFECT_${outcome.status.toUpperCase()}`);
+        const externalReference = safeExternalReference(outcome.externalReference);
+        if (current.status === outcome.status &&
+            current.detail === detail &&
+            current.externalReference === externalReference)
+            return structuredClone(current);
+        return this.#persistOutcome(current, outcome);
+    }
+    start(intent, handler) {
+        const requestDigest = this.#validateIntent(intent);
+        const metadata = intent.metadata ?? {};
+        if (!isSafePublicMetadata(metadata)) {
+            throw new EffectCoordinatorError('EFFECT_METADATA_UNSAFE', 'Effect metadata must contain only bounded public strings');
+        }
+        const now = this.#clock.now();
+        const pending = {
+            operationId: intent.operationId,
+            effectKind: intent.effectKind,
+            requestDigest,
+            status: 'pending',
+            attempt: 1,
+            createdAt: now,
+            updatedAt: now,
+            metadata: structuredClone(metadata),
+        };
+        let reservation;
+        try {
+            reservation = this.#storage.reserveEffect(pending);
+            if (reservation.created)
+                this.#onRecord?.(structuredClone(reservation.record));
+        }
+        catch (error) {
+            throw new EffectCoordinatorError('EFFECT_INTENT_NOT_DURABLE', `Could not atomically admit effect ${intent.operationId} before dispatch`, { cause: error });
+        }
+        const admitted = reservation.record;
+        if (!reservation.created && admitted.status === 'conflict') {
+            this.#onRecord?.(structuredClone(admitted));
+        }
+        if (!reservation.created &&
+            admitted.status !== 'pending' &&
+            !(admitted.status === 'unknown' && handler.reconcile !== undefined)) {
+            return this.#resolvedHandle(intent, requestDigest, admitted, true);
+        }
+        if (!reservation.created) {
+            const key = this.#key(intent.operationId, requestDigest);
+            const inFlight = this.#inFlight.get(key);
+            if (inFlight !== undefined) {
+                return {
+                    operationId: intent.operationId,
+                    requestDigest,
+                    replayed: true,
+                    record: structuredClone(admitted),
+                    completion: inFlight.completion,
+                };
+            }
+            if (handler.reconcile === undefined) {
+                return this.#resolvedHandle(intent, requestDigest, admitted, true);
+            }
+            const completion = this.#schedule(key, intent.serializationKey ?? 'default', () => this.#reconcilePending(intent, requestDigest, admitted, handler));
+            return {
+                operationId: intent.operationId,
+                requestDigest,
+                replayed: true,
+                record: structuredClone(admitted),
+                completion,
+            };
+        }
+        const key = this.#key(intent.operationId, requestDigest);
+        const completion = this.#schedule(key, intent.serializationKey ?? 'default', () => this.#dispatchNew(intent, pending, handler));
+        return {
+            operationId: intent.operationId,
+            requestDigest,
+            replayed: false,
+            record: structuredClone(pending),
+            completion,
+        };
+    }
+    async execute(intent, handler) {
+        return this.start(intent, handler).completion;
+    }
+    #validateIntent(intent) {
+        if (!intent.operationId) {
+            throw new EffectCoordinatorError('OPERATION_ID_REQUIRED', 'Effect operationId is required');
+        }
+        if (!intent.effectKind) {
+            throw new EffectCoordinatorError('EFFECT_KIND_REQUIRED', 'Effect effectKind is required');
+        }
+        if (intent.requestDigest !== undefined) {
+            if (!/^[0-9a-f]{64}$/u.test(intent.requestDigest))
+                throw new EffectCoordinatorError('EFFECT_INTENT_NOT_DURABLE', 'Effect request fingerprint must be a 256-bit hexadecimal value');
+            return intent.requestDigest;
+        }
+        return effectRequestDigest(intent);
+    }
+    async #dispatchNew(intent, pending, handler) {
+        let outcome;
+        try {
+            outcome = await handler.dispatch(this.#context(intent, pending.requestDigest));
+        }
+        catch {
+            outcome = {
+                status: 'unknown',
+                detail: 'EFFECT_DISPATCH_UNKNOWN',
+            };
+        }
+        return this.#persistOutcome(pending, outcome);
+    }
+    async #reconcilePending(intent, requestDigest, pending, handler) {
+        let outcome;
+        try {
+            outcome = await handler.reconcile?.(this.#context(intent, requestDigest));
+        }
+        catch {
+            outcome = {
+                status: 'unknown',
+                detail: 'EFFECT_RECONCILIATION_UNKNOWN',
+            };
+        }
+        if (outcome === undefined)
+            return structuredClone(pending);
+        return this.#persistOutcome(pending, outcome);
+    }
+    #persistOutcome(base, outcome) {
+        const detail = safeDetail(outcome.detail, `EFFECT_${outcome.status.toUpperCase()}`);
+        const externalReference = safeExternalReference(outcome.externalReference);
+        const next = {
+            ...base,
+            status: outcome.status,
+            updatedAt: this.#clock.now(),
+            ...(detail === undefined ? {} : { detail }),
+            ...(externalReference === undefined ? {} : { externalReference }),
+        };
+        try {
+            this.#storage.appendEffect(next);
+            this.#onRecord?.(structuredClone(next));
+            return structuredClone(next);
+        }
+        catch (_error) {
+            const unknown = {
+                ...base,
+                status: 'unknown',
+                updatedAt: this.#clock.now(),
+                detail: 'EFFECT_OUTCOME_NOT_DURABLE',
+            };
+            try {
+                this.#storage.appendEffect(unknown);
+                try {
+                    this.#onRecord?.(structuredClone(unknown));
+                }
+                catch {
+                    // The effect record is durable even if a secondary state projection failed.
+                }
+            }
+            catch {
+                // Leave the pending record for a later reconciliation attempt.
+            }
+            return structuredClone(unknown);
+        }
+    }
+    #context(intent, requestDigest) {
+        return {
+            operationId: intent.operationId,
+            effectKind: intent.effectKind,
+            requestDigest,
+            request: intent.request,
+            ...(intent.signal === undefined ? {} : { signal: intent.signal }),
+        };
+    }
+    #resolvedHandle(intent, requestDigest, record, replayed) {
+        return {
+            operationId: intent.operationId,
+            requestDigest,
+            replayed,
+            record: structuredClone(record),
+            completion: Promise.resolve(structuredClone(record)),
+        };
+    }
+    #key(operationId, requestDigest) {
+        return `${operationId}\u0000${requestDigest}`;
+    }
+    #schedule(key, serializationKey, task) {
+        const completion = this.#serialize(serializationKey, task);
+        const queued = { key, completion };
+        this.#inFlight.set(key, queued);
+        void completion.then(() => this.#clearInFlight(key, completion), () => this.#clearInFlight(key, completion));
+        return completion;
+    }
+    #clearInFlight(key, completion) {
+        if (this.#inFlight.get(key)?.completion === completion)
+            this.#inFlight.delete(key);
+    }
+    #serialize(serializationKey, task) {
+        const previous = this.#tails.get(serializationKey) ?? Promise.resolve();
+        let release;
+        const tail = new Promise((resolve) => {
+            release = resolve;
+        });
+        this.#tails.set(serializationKey, tail);
+        return previous.then(task).finally(() => {
+            release();
+            if (this.#tails.get(serializationKey) === tail)
+                this.#tails.delete(serializationKey);
+        });
+    }
+}
+export { SerializedEffectCoordinator as EffectCoordinator };
+//# sourceMappingURL=effect-coordinator.js.map

package/dist/app/effect-coordinator.js.map

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

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

@@ -0,0 +1,11 @@
+import type { EffectRecord as DomainEffectRecord } from '../domain/entities.js';
+import type { EffectRecord as StoredEffectRecord } from '../ports/effect-storage.js';
+/**
+ * Projects a durable effect-storage record into the journal's effect entity.
+ *
+ * Storage holds the record that guards external dispatch; the journal holds the
+ * user-visible operation history. Both describe the same attempt, so the
+ * projection carries digests rather than the request itself.
+ */
+export declare function projectEffectRecord(record: StoredEffectRecord): DomainEffectRecord;
+//# sourceMappingURL=effect-projection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"effect-projection.d.ts","sourceRoot":"","sources":["../../src/app/effect-projection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,IAAI,kBAAkB,EAAiB,MAAM,uBAAuB,CAAA;AAE9F,OAAO,KAAK,EAAE,YAAY,IAAI,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAMpF;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,CAqBlF"}

package/dist/app/effect-projection.js

@@ -0,0 +1,34 @@
+import { canonicalDigest } from '../domain/canonical.js';
+import { createEffectId, parseOperationId } from '../domain/ids.js';
+const EFFECT_OPERATION_KINDS = {
+    'run.execute': 'send',
+};
+/**
+ * Projects a durable effect-storage record into the journal's effect entity.
+ *
+ * Storage holds the record that guards external dispatch; the journal holds the
+ * user-visible operation history. Both describe the same attempt, so the
+ * projection carries digests rather than the request itself.
+ */
+export function projectEffectRecord(record) {
+    const outcomeDigest = record.detail === undefined && record.externalReference === undefined
+        ? undefined
+        : canonicalDigest({
+            status: record.status,
+            detail: record.detail ?? null,
+            externalReference: record.externalReference ?? null,
+        });
+    return {
+        id: createEffectId(`effect-${record.operationId}-${record.requestDigest.slice(0, 24)}`),
+        operationId: parseOperationId(record.operationId),
+        effectKind: record.effectKind,
+        requestDigest: record.requestDigest,
+        kind: EFFECT_OPERATION_KINDS[record.effectKind] ?? 'custom',
+        status: record.status,
+        attempt: record.attempt,
+        ...(outcomeDigest === undefined ? {} : { outcomeDigest }),
+        createdAt: record.createdAt,
+        updatedAt: record.updatedAt,
+    };
+}
+//# sourceMappingURL=effect-projection.js.map

package/dist/app/effect-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect-projection.js","sourceRoot":"","sources":["../../src/app/effect-projection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAExD,OAAO,EAAE,cAAc,EAAe,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAGhF,MAAM,sBAAsB,GAA4C;IACtE,aAAa,EAAE,MAAM;CACtB,CAAA;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAA0B;IAC5D,MAAM,aAAa,GACjB,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,iBAAiB,KAAK,SAAS;QACnE,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,eAAe,CAAC;YACd,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,IAAI;YAC7B,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,IAAI;SACpD,CAAC,CAAA;IACR,OAAO;QACL,EAAE,EAAE,cAAc,CAAC,UAAU,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QACvF,WAAW,EAAE,gBAAgB,CAAC,MAAM,CAAC,WAAW,CAAC;QACjD,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,aAAa,EAAE,MAAM,CAAC,aAAuB;QAC7C,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,QAAQ;QAC3D,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC;QACzD,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAA;AACH,CAAC"}

package/dist/app/errors.d.ts

@@ -0,0 +1,5 @@
+export declare class AppError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/app/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB,YAAY,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAIxC;CACF"}

package/dist/app/errors.js

@@ -0,0 +1,9 @@
+export class AppError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'AppError';
+        this.code = code;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/app/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/app/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,CAAQ;IAErB,YAAY,IAAY,EAAE,OAAe;QACvC,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,UAAU,CAAA;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF"}

package/dist/app/fail-closed-journal.d.ts

@@ -0,0 +1,18 @@
+import type { BraidEvent, BraidEventEnvelope } from '../domain/events.js';
+import type { BraidState } from '../domain/state.js';
+import type { Clock } from '../ports/clock.js';
+import type { EffectRecord, EffectStoragePort, JournalPort } from '../ports/effect-storage.js';
+/** Used only before a production SQLite store has been opened. */
+export declare class FailClosedJournal implements JournalPort, EffectStoragePort {
+    #private;
+    constructor(clock: Clock);
+    envelope(state: BraidState, event: BraidEvent): BraidEventEnvelope;
+    append(): never;
+    all(): readonly BraidEventEnvelope[];
+    current(): EffectRecord | undefined;
+    latest(): EffectRecord | undefined;
+    reserveEffect(): never;
+    appendEffect(): never;
+    history(): readonly EffectRecord[];
+}
+//# sourceMappingURL=fail-closed-journal.d.ts.map

package/dist/app/fail-closed-journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fail-closed-journal.d.ts","sourceRoot":"","sources":["../../src/app/fail-closed-journal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAE9F,kEAAkE;AAClE,qBAAa,iBAAkB,YAAW,WAAW,EAAE,iBAAiB;;IAGtE,YAAY,KAAK,EAAE,KAAK,EAEvB;IAED,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,GAAG,kBAAkB,CAOjE;IAED,MAAM,IAAI,KAAK,CAEd;IAED,GAAG,IAAI,SAAS,kBAAkB,EAAE,CAEnC;IAED,OAAO,IAAI,YAAY,GAAG,SAAS,CAElC;IAED,MAAM,IAAI,YAAY,GAAG,SAAS,CAEjC;IAED,aAAa,IAAI,KAAK,CAIrB;IAED,YAAY,IAAI,KAAK,CAIpB;IAED,OAAO,IAAI,SAAS,YAAY,EAAE,CAEjC;CACF"}

package/dist/app/fail-closed-journal.js

@@ -0,0 +1,37 @@
+/** Used only before a production SQLite store has been opened. */
+export class FailClosedJournal {
+    #clock;
+    constructor(clock) {
+        this.#clock = clock;
+    }
+    envelope(state, event) {
+        return {
+            sequence: state.sequence + 1,
+            revision: state.revision + 1,
+            occurredAt: this.#clock.now(),
+            event,
+        };
+    }
+    append() {
+        throw new Error('BRAID_STORAGE_REQUIRED: open the encrypted SQLite store before mutating state');
+    }
+    all() {
+        return [];
+    }
+    current() {
+        return undefined;
+    }
+    latest() {
+        return undefined;
+    }
+    reserveEffect() {
+        throw new Error('BRAID_STORAGE_REQUIRED: open the encrypted SQLite store before dispatching effects');
+    }
+    appendEffect() {
+        throw new Error('BRAID_STORAGE_REQUIRED: open the encrypted SQLite store before dispatching effects');
+    }
+    history() {
+        return [];
+    }
+}
+//# sourceMappingURL=fail-closed-journal.js.map

package/dist/app/fail-closed-journal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fail-closed-journal.js","sourceRoot":"","sources":["../../src/app/fail-closed-journal.ts"],"names":[],"mappings":"AAKA,kEAAkE;AAClE,MAAM,OAAO,iBAAiB;IACnB,MAAM,CAAO;IAEtB,YAAY,KAAY;QACtB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;IACrB,CAAC;IAED,QAAQ,CAAC,KAAiB,EAAE,KAAiB;QAC3C,OAAO;YACL,QAAQ,EAAE,KAAK,CAAC,QAAQ,GAAG,CAAC;YAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ,GAAG,CAAC;YAC5B,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE;YAC7B,KAAK;SACN,CAAA;IACH,CAAC;IAED,MAAM;QACJ,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAA;IAClG,CAAC;IAED,GAAG;QACD,OAAO,EAAE,CAAA;IACX,CAAC;IAED,OAAO;QACL,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,MAAM;QACJ,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,aAAa;QACX,MAAM,IAAI,KAAK,CACb,oFAAoF,CACrF,CAAA;IACH,CAAC;IAED,YAAY;QACV,MAAM,IAAI,KAAK,CACb,oFAAoF,CACrF,CAAA;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,CAAA;IACX,CAAC;CACF"}

package/dist/app/intelligence-actions.d.ts

@@ -0,0 +1,28 @@
+import type { RuntimeSupervisorController } from '../adapters/runtime/supervisor-control.js';
+import type { RuntimeSupervisorWatcher } from '../adapters/runtime/supervisor-watch.js';
+import { AnalysisComparisonService } from './analysis-comparison.js';
+import { AnalysisPromotionService } from './analysis-promotion.js';
+import { AnalysisService } from './analysis-service.js';
+import type { AnalysisApplicationHost } from './analysis-types.js';
+import { SupervisorService } from './supervisor-service.js';
+import type { AnalysisAnalyst } from './analysis-execution-session.js';
+/**
+ * Product-owned composition for analysis and supervisor actions.
+ *
+ * The individual services own their domain behavior; this object only gives
+ * the application and UI one stable entry point to the focused services.
+ */
+export declare class IntelligenceActions {
+    readonly analysis: AnalysisService;
+    readonly comparison: AnalysisComparisonService;
+    readonly promotion: AnalysisPromotionService;
+    readonly supervisor: SupervisorService;
+    constructor(host: AnalysisApplicationHost, options?: IntelligenceActionsOptions);
+}
+export interface IntelligenceActionsOptions {
+    readonly analyst?: AnalysisAnalyst;
+    readonly supervisorWatcher?: RuntimeSupervisorWatcher;
+    readonly supervisorController?: RuntimeSupervisorController;
+}
+export declare function createIntelligenceActions(host: AnalysisApplicationHost, options?: IntelligenceActionsOptions): IntelligenceActions;
+//# sourceMappingURL=intelligence-actions.d.ts.map

package/dist/app/intelligence-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intelligence-actions.d.ts","sourceRoot":"","sources":["../../src/app/intelligence-actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAA;AAC5F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAA;AACvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAA;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AACvD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AAEtE;;;;;GAKG;AACH,qBAAa,mBAAmB;IAC9B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAA;IAClC,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAA;IAC9C,QAAQ,CAAC,SAAS,EAAE,wBAAwB,CAAA;IAC5C,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAA;IAEtC,YAAY,IAAI,EAAE,uBAAuB,EAAE,OAAO,GAAE,0BAA+B,EAUlF;CACF;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAA;IAClC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,wBAAwB,CAAA;IACrD,QAAQ,CAAC,oBAAoB,CAAC,EAAE,2BAA2B,CAAA;CAC5D;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,uBAAuB,EAC7B,OAAO,GAAE,0BAA+B,GACvC,mBAAmB,CAErB"}

package/dist/app/intelligence-actions.js

@@ -0,0 +1,31 @@
+import { AnalysisComparisonService } from './analysis-comparison.js';
+import { AnalysisPromotionService } from './analysis-promotion.js';
+import { AnalysisService } from './analysis-service.js';
+import { SupervisorService } from './supervisor-service.js';
+/**
+ * Product-owned composition for analysis and supervisor actions.
+ *
+ * The individual services own their domain behavior; this object only gives
+ * the application and UI one stable entry point to the focused services.
+ */
+export class IntelligenceActions {
+    analysis;
+    comparison;
+    promotion;
+    supervisor;
+    constructor(host, options = {}) {
+        this.analysis = new AnalysisService(host, options.analyst);
+        this.comparison = new AnalysisComparisonService(host);
+        this.promotion = new AnalysisPromotionService(host);
+        this.supervisor = new SupervisorService(host, {
+            ...(options.supervisorWatcher === undefined ? {} : { watcher: options.supervisorWatcher }),
+            ...(options.supervisorController === undefined
+                ? {}
+                : { controller: options.supervisorController }),
+        });
+    }
+}
+export function createIntelligenceActions(host, options = {}) {
+    return new IntelligenceActions(host, options);
+}
+//# sourceMappingURL=intelligence-actions.js.map

package/dist/app/intelligence-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intelligence-actions.js","sourceRoot":"","sources":["../../src/app/intelligence-actions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAA;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAG3D;;;;;GAKG;AACH,MAAM,OAAO,mBAAmB;IACrB,QAAQ,CAAiB;IACzB,UAAU,CAA2B;IACrC,SAAS,CAA0B;IACnC,UAAU,CAAmB;IAEtC,YAAY,IAA6B,EAAE,OAAO,GAA+B,EAAE;QACjF,IAAI,CAAC,QAAQ,GAAG,IAAI,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;QAC1D,IAAI,CAAC,UAAU,GAAG,IAAI,yBAAyB,CAAC,IAAI,CAAC,CAAA;QACrD,IAAI,CAAC,SAAS,GAAG,IAAI,wBAAwB,CAAC,IAAI,CAAC,CAAA;QACnD,IAAI,CAAC,UAAU,GAAG,IAAI,iBAAiB,CAAC,IAAI,EAAE;YAC5C,GAAG,CAAC,OAAO,CAAC,iBAAiB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAC1F,GAAG,CAAC,OAAO,CAAC,oBAAoB,KAAK,SAAS;gBAC5C,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,oBAAoB,EAAE,CAAC;SAClD,CAAC,CAAA;IACJ,CAAC;CACF;AAQD,MAAM,UAAU,yBAAyB,CACvC,IAA6B,EAC7B,OAAO,GAA+B,EAAE;IAExC,OAAO,IAAI,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;AAC/C,CAAC"}

package/dist/app/interaction-automation-coordinator.d.ts

@@ -0,0 +1,27 @@
+import type { InteractionRequest } from '@tangle-network/agent-interface';
+import type { BraidEventEnvelope } from '../domain/events.js';
+import type { OperationId } from '../domain/ids.js';
+import type { BraidInteraction } from '../domain/runtime-projection.js';
+import type { BraidState } from '../domain/state.js';
+export type InteractionAutomationTarget = BraidInteraction;
+export interface InteractionAutomationApplyInput {
+    readonly operationId: OperationId;
+    readonly runId: string;
+    readonly interactionId: string;
+}
+export interface InteractionAutomationCoordinatorOptions {
+    readonly state: () => BraidState;
+    readonly events: () => readonly BraidEventEnvelope[];
+    readonly apply: (input: InteractionAutomationApplyInput) => Promise<unknown>;
+    readonly onError?: (error: unknown, target: InteractionAutomationTarget) => void | Promise<void>;
+}
+export declare function interactionAutomationOperationId(runId: string, request: InteractionRequest, rules?: BraidState['rules']): OperationId;
+export declare function automationPolicyDigest(rules: BraidState['rules']): string;
+export declare class InteractionAutomationCoordinator {
+    #private;
+    constructor(options: InteractionAutomationCoordinatorOptions);
+    schedule(target: InteractionAutomationTarget): Promise<void>;
+    reconcile(): Promise<void>;
+    whenIdle(): Promise<void>;
+}
+//# sourceMappingURL=interaction-automation-coordinator.d.ts.map

package/dist/app/interaction-automation-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interaction-automation-coordinator.d.ts","sourceRoot":"","sources":["../../src/app/interaction-automation-coordinator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AAEzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAEnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AACvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAIpD,MAAM,MAAM,2BAA2B,GAAG,gBAAgB,CAAA;AAE1D,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC/B;AAED,MAAM,WAAW,uCAAuC;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,UAAU,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,SAAS,kBAAkB,EAAE,CAAA;IACpD,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,+BAA+B,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC5E,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,2BAA2B,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACjG;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,kBAAkB,EAC3B,KAAK,GAAE,UAAU,CAAC,OAAO,CAAM,GAC9B,WAAW,CAQb;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,MAAM,CAMzE;AAED,qBAAa,gCAAgC;;IAK3C,YAAY,OAAO,EAAE,uCAAuC,EAE3D;IAED,QAAQ,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CAe3D;IAEK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAK/B;IAEK,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAE9B;CA0CF"}

package/dist/app/interaction-automation-coordinator.js

@@ -0,0 +1,114 @@
+import { canonicalDigest } from '../domain/canonical.js';
+import { createOperationId } from '../domain/ids.js';
+import { findRuleUseReservation } from './automation-rule-persistence.js';
+import { interactionRequestDigest } from './automation-rule-validation.js';
+export function interactionAutomationOperationId(runId, request, rules = []) {
+    return createOperationId(`operation-automation-interaction-${canonicalDigest({
+        runId,
+        interactionRequestDigest: interactionRequestDigest(request),
+        policyDigest: automationPolicyDigest(rules),
+    }).slice(0, 48)}`);
+}
+export function automationPolicyDigest(rules) {
+    return canonicalDigest([...rules]
+        .sort((left, right) => (left.id < right.id ? -1 : left.id > right.id ? 1 : 0))
+        .map(({ uses: _uses, ...definition }) => definition));
+}
+export class InteractionAutomationCoordinator {
+    #options;
+    #pending = new Map();
+    #tail = Promise.resolve();
+    constructor(options) {
+        this.#options = options;
+    }
+    schedule(target) {
+        const operationId = operationForTarget(target, this.#options.state(), this.#options.events());
+        if (operationId === undefined)
+            return Promise.resolve();
+        const key = interactionKey(target.runId, target.request.id, operationId);
+        const pending = this.#pending.get(key);
+        if (pending !== undefined)
+            return pending;
+        const work = this.#tail.then(() => this.#process(target, operationId));
+        this.#tail = work.catch(() => undefined);
+        this.#pending.set(key, work);
+        void work.then(() => this.#clearPending(key, work), () => this.#clearPending(key, work));
+        return work;
+    }
+    async reconcile() {
+        const targets = this.#options
+            .state()
+            .runs.flatMap((run) => run.interactions);
+        await Promise.all(targets.map((target) => this.schedule(target)));
+    }
+    async whenIdle() {
+        await this.#tail;
+    }
+    async #process(scheduled, scheduledOperationId) {
+        let target = scheduled;
+        try {
+            const current = findInteraction(this.#options.state(), scheduled.runId, scheduled.request.id);
+            if (current === undefined)
+                return;
+            const currentOperationId = operationForTarget(current, this.#options.state(), this.#options.events());
+            if (currentOperationId !== scheduledOperationId) {
+                if (currentOperationId !== undefined)
+                    void this.schedule(current);
+                return;
+            }
+            target = current;
+            await this.#options.apply({
+                operationId: scheduledOperationId,
+                runId: target.runId,
+                interactionId: target.request.id,
+            });
+        }
+        catch (error) {
+            await this.#reportError(error, target);
+        }
+    }
+    async #reportError(error, target) {
+        if (this.#options.onError === undefined)
+            return;
+        try {
+            await this.#options.onError(error, target);
+        }
+        catch {
+            // Error reporting must not stop later interaction work.
+        }
+    }
+    #clearPending(key, work) {
+        if (this.#pending.get(key) === work)
+            this.#pending.delete(key);
+    }
+}
+function interactionKey(runId, interactionId, operationId) {
+    return `${runId}\u0000${interactionId}\u0000${operationId}`;
+}
+function findInteraction(state, runId, interactionId) {
+    const run = state.runs.find((candidate) => candidate.id === runId);
+    return run?.interactions.find((candidate) => candidate.request.id === interactionId);
+}
+function operationForTarget(target, state, events) {
+    if (target.status === 'pending')
+        return interactionAutomationOperationId(target.runId, target.request, state.rules);
+    if (target.status !== 'responding')
+        return undefined;
+    if (target.responseOperation?.automationRule !== undefined)
+        return target.responseOperation.operationId;
+    const requested = requestedResponseOperation(events, target);
+    if (requested === undefined || findRuleUseReservation(events, requested) === undefined)
+        return undefined;
+    return createOperationId(requested);
+}
+function requestedResponseOperation(events, target) {
+    for (let index = events.length - 1; index >= 0; index -= 1) {
+        const event = events[index]?.event;
+        if (event?.kind === 'run.interaction.response.requested' &&
+            event.runId === target.runId &&
+            event.interactionId === target.request.id)
+            return event.operationId;
+    }
+    return undefined;
+}
+//# sourceMappingURL=interaction-automation-coordinator.js.map