@tangle-network/braid 0.1.0

package/dist/app/connections.js

@@ -0,0 +1,199 @@
+import { canonicalDigest } from '../domain/canonical.js';
+import { parseConnectionId } from '../domain/ids.js';
+import { assertConnectionRecord } from '../domain/invariants-profile.js';
+import { redactSensitiveText } from '../domain/redaction.js';
+import { ConnectionError } from './connection-errors.js';
+/**
+ * In-memory connection catalog for the application boundary.
+ *
+ * Durable event/state adapters can feed records into this catalog, while the
+ * runtime resolver only receives an exact id-based selection.
+ */
+export class ConnectionRegistry {
+    #records = new Map();
+    constructor(records = []) {
+        for (const record of records) {
+            if (this.#records.has(record.id)) {
+                throw new ConnectionError('INVALID_CONNECTION_RECORD', 'Duplicate connection identifier');
+            }
+            this.#records.set(record.id, freezeConnectionRecord(validateRecord(record)));
+        }
+    }
+    get(connectionId) {
+        try {
+            return this.#records.get(parseConnectionId(connectionId));
+        }
+        catch {
+            return undefined;
+        }
+    }
+    list(workspaceId) {
+        const records = [...this.#records.values()].filter((record) => workspaceId === undefined || record.workspaceId === workspaceId);
+        return Object.freeze(records);
+    }
+    upsert(record) {
+        const normalized = freezeConnectionRecord(validateRecord(record));
+        this.#records.set(normalized.id, normalized);
+        return normalized;
+    }
+    remove(input) {
+        const selected = this.select(input);
+        this.#records.delete(selected.record.id);
+        return selected.record;
+    }
+    select(input) {
+        const id = parseSelectionId(input);
+        const record = this.#records.get(id);
+        if (!record) {
+            throw new ConnectionError('CONNECTION_NOT_FOUND', 'The selected connection does not exist', {
+                connectionId: id,
+            });
+        }
+        if (input.expectedKind !== undefined && input.expectedKind !== record.kind) {
+            throw new ConnectionError('CONNECTION_KIND_MISMATCH', 'The selected connection kind does not match the requested kind', { connectionId: id });
+        }
+        if (input.expectedUpdatedAt !== undefined && input.expectedUpdatedAt !== record.updatedAt) {
+            throw new ConnectionError('CONNECTION_REVISION_MISMATCH', 'The selected connection changed before execution was admitted', { connectionId: id });
+        }
+        return Object.freeze({
+            input: Object.freeze({ ...input, connectionId: id }),
+            record,
+            digest: canonicalDigest({
+                connectionId: id,
+                kind: record.kind,
+                updatedAt: record.updatedAt,
+            }),
+        });
+    }
+}
+/** Saved connection identity wins; newer journal observations may refresh only health fields. */
+export function mergeConnectionTelemetry(saved, observed) {
+    if (saved.kind !== observed.kind ||
+        saved.workspaceId !== observed.workspaceId ||
+        saved.endpoint !== observed.endpoint ||
+        saved.credentialRef !== observed.credentialRef ||
+        canonicalDigest(saved.providerOptions) !== canonicalDigest(observed.providerOptions)) {
+        return saved;
+    }
+    const savedHealthAt = 'checkedAt' in saved.lastHealth ? saved.lastHealth.checkedAt : undefined;
+    const observedHealthAt = 'checkedAt' in observed.lastHealth ? observed.lastHealth.checkedAt : undefined;
+    const lastHealth = observedHealthAt !== undefined &&
+        (savedHealthAt === undefined || observedHealthAt > savedHealthAt)
+        ? observed.lastHealth
+        : saved.lastHealth;
+    const savedModelAt = saved.lastModelVerification?.checkedAt;
+    const observedModelAt = observed.lastModelVerification?.checkedAt;
+    const lastModelVerification = observedModelAt !== undefined && (savedModelAt === undefined || observedModelAt > savedModelAt)
+        ? observed.lastModelVerification
+        : saved.lastModelVerification;
+    return {
+        ...saved,
+        lastHealth,
+        ...(lastModelVerification === undefined ? {} : { lastModelVerification }),
+    };
+}
+function parseSelectionId(input) {
+    try {
+        return parseConnectionId(input.connectionId);
+    }
+    catch {
+        throw new ConnectionError('INVALID_CONNECTION_SELECTION', 'A connection id is required');
+    }
+}
+function validateRecord(record) {
+    try {
+        assertSecretFree(record);
+        assertConnectionRecord(record);
+        return record;
+    }
+    catch (error) {
+        if (error instanceof ConnectionError)
+            throw error;
+        throw new ConnectionError('INVALID_CONNECTION_RECORD', 'The connection record is invalid');
+    }
+}
+function assertSecretFree(record) {
+    const allowedKeys = new Set([
+        'id',
+        'workspaceId',
+        'kind',
+        'name',
+        'endpoint',
+        'credentialRef',
+        'providerOptions',
+        'createdAt',
+        'updatedAt',
+        'lastHealth',
+        'lastModelVerification',
+    ]);
+    for (const key of Object.keys(record)) {
+        if (!allowedKeys.has(key)) {
+            throw new ConnectionError('SECRET_IN_CONNECTION_RECORD', 'Connection records may contain references, not provider-native or credential material', { connectionId: record.id });
+        }
+    }
+    const healthKeys = new Set(['status', 'checkedAt', 'message']);
+    for (const key of Object.keys(record.lastHealth)) {
+        if (!healthKeys.has(key)) {
+            throw new ConnectionError('SECRET_IN_CONNECTION_RECORD', 'Connection health metadata may not contain provider-native or credential material', { connectionId: record.id });
+        }
+    }
+    if (record.lastModelVerification !== undefined) {
+        const verificationKeys = new Set([
+            'model',
+            'status',
+            'checkedAt',
+            'code',
+            'httpStatus',
+            'message',
+        ]);
+        for (const key of Object.keys(record.lastModelVerification)) {
+            if (!verificationKeys.has(key)) {
+                throw new ConnectionError('SECRET_IN_CONNECTION_RECORD', 'Connection verification metadata may not contain provider-native or credential material', { connectionId: record.id });
+            }
+        }
+    }
+    const strings = [
+        record.name,
+        record.endpoint,
+        record.providerOptions.transport,
+        record.providerOptions.endpoint,
+        record.providerOptions.region,
+        record.providerOptions.account,
+        ...(record.providerOptions.capabilityHints ?? []),
+        ...('message' in record.lastHealth ? [record.lastHealth.message] : []),
+        ...(record.lastModelVerification === undefined
+            ? []
+            : [
+                record.lastModelVerification.model,
+                record.lastModelVerification.code,
+                record.lastModelVerification.message,
+            ]),
+    ];
+    for (const value of strings) {
+        if (value !== undefined && redactSensitiveText(value) !== value) {
+            throw new ConnectionError('SECRET_IN_CONNECTION_RECORD', 'Connection records may contain references, not credential material', { connectionId: record.id });
+        }
+        if (value?.includes('?') || value?.includes('#')) {
+            throw new ConnectionError('SECRET_IN_CONNECTION_RECORD', 'Connection URLs must not contain query or fragment data', { connectionId: record.id });
+        }
+    }
+}
+function freezeConnectionRecord(record) {
+    const providerOptions = Object.freeze({
+        ...record.providerOptions,
+        ...(record.providerOptions.capabilityHints === undefined
+            ? {}
+            : { capabilityHints: Object.freeze([...record.providerOptions.capabilityHints]) }),
+    });
+    const lastHealth = Object.freeze({ ...record.lastHealth });
+    const lastModelVerification = record.lastModelVerification === undefined
+        ? undefined
+        : Object.freeze({ ...record.lastModelVerification });
+    return Object.freeze({
+        ...record,
+        providerOptions,
+        lastHealth,
+        ...(lastModelVerification === undefined ? {} : { lastModelVerification }),
+    });
+}
+//# sourceMappingURL=connections.js.map

package/dist/app/connections.js.map

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

package/dist/app/control-effects.d.ts

@@ -0,0 +1,14 @@
+import type { ControlAcknowledgement, ExecutionPort } from '../ports/execution.js';
+import type { ControlDispatchOptions, ControlEffectRequest } from './application-ports.js';
+import type { SerializedEffectCoordinator } from './effect-coordinator.js';
+export declare function executeControlEffect(input: {
+    readonly effects: SerializedEffectCoordinator;
+    readonly execution: ExecutionPort;
+    readonly request: ControlEffectRequest;
+    readonly owner: string;
+    readonly timeoutMs: number;
+    readonly whenDurable: () => Promise<void>;
+    readonly canSettleLate?: () => boolean;
+    readonly onLateSettlement?: ControlDispatchOptions['onLateSettlement'];
+}): Promise<ControlAcknowledgement>;
+//# sourceMappingURL=control-effects.d.ts.map

package/dist/app/control-effects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-effects.d.ts","sourceRoot":"","sources":["../../src/app/control-effects.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,sBAAsB,EACtB,aAAa,EAEd,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC1F,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAA;AAG1E,wBAAsB,oBAAoB,CAAC,KAAK,EAAE;IAChD,QAAQ,CAAC,OAAO,EAAE,2BAA2B,CAAA;IAC7C,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAA;IACjC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAA;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACzC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,OAAO,CAAA;IACtC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,sBAAsB,CAAC,kBAAkB,CAAC,CAAA;CACvE,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAqDlC"}

package/dist/app/control-effects.js

@@ -0,0 +1,186 @@
+import { safeDiagnostic } from './provider-values.js';
+export async function executeControlEffect(input) {
+    const { request } = input;
+    let providerResult;
+    let foregroundTimedOut = false;
+    const effect = input.effects.start({
+        operationId: request.operationId,
+        effectKind: `run.control.${request.control}`,
+        request: {
+            ...request,
+            providerSessionId: request.providerSessionId ?? null,
+            reason: request.reason ?? null,
+            text: request.text ?? null,
+            cursor: request.cursor ?? null,
+        },
+        serializationKey: `run:${request.runId}:control`,
+        metadata: {
+            runId: request.runId,
+            control: request.control,
+            owner: input.owner,
+            leaseExpiresAt: new Date(Date.now() + input.timeoutMs).toISOString(),
+        },
+    }, {
+        dispatch: async () => {
+            const controller = new AbortController();
+            providerResult = dispatchControl(input.execution, request, controller.signal);
+            const result = await controlDeadline(providerResult, controller, input.timeoutMs);
+            foregroundTimedOut = result.timedOut;
+            return effectResult(result.acknowledgement);
+        },
+        reconcile: async () => reconcileControl(input.execution, request),
+    });
+    const record = await effect.completion;
+    await input.whenDurable();
+    if (foregroundTimedOut && providerResult !== undefined && input.onLateSettlement !== undefined) {
+        const lateResult = providerResult;
+        void lateResult
+            .then(async (acknowledgement) => {
+            if (input.canSettleLate?.() === false)
+                return;
+            const settled = input.effects.settle(effect.operationId, effect.requestDigest, effectResult(acknowledgement));
+            if (settled !== undefined)
+                await input.whenDurable();
+            if (input.canSettleLate?.() === false)
+                return;
+            await input.onLateSettlement?.(acknowledgement);
+        })
+            .catch(() => undefined);
+    }
+    return acknowledgementFromEffect(request.operationId, record.status, record.detail);
+}
+async function dispatchControl(execution, request, signal) {
+    try {
+        if (request.control === 'cancel') {
+            if (!execution.cancelRun)
+                return unknown(request.operationId, 'CONTROL_CANCELLATION_UNCONFIRMED');
+            return normalize(request.operationId, await execution.cancelRun({
+                runId: request.runId,
+                operationId: request.operationId,
+                ...(request.providerSessionId === undefined
+                    ? {}
+                    : { providerSessionId: request.providerSessionId }),
+                ...(request.controlRef === undefined ? {} : { controlRef: request.controlRef }),
+                signal,
+                ...(request.reason === undefined ? {} : { reason: request.reason }),
+            }));
+        }
+        if (request.control === 'steer') {
+            if (!execution.steerRun)
+                return unknown(request.operationId, 'CONTROL_STEERING_UNCONFIRMED');
+            return execution.steerRun({
+                runId: request.runId,
+                operationId: request.operationId,
+                text: request.text ?? '',
+                signal,
+            });
+        }
+        if (!execution.detachRun)
+            return unknown(request.operationId, 'CONTROL_DETACH_UNCONFIRMED');
+        return execution.detachRun({
+            runId: request.runId,
+            operationId: request.operationId,
+            ...(request.providerSessionId === undefined
+                ? {}
+                : { providerSessionId: request.providerSessionId }),
+            ...(request.controlRef === undefined ? {} : { controlRef: request.controlRef }),
+            signal,
+            ...(request.cursor === undefined ? {} : { cursor: request.cursor }),
+        });
+    }
+    catch {
+        return unknown(request.operationId, 'CONTROL_DISPATCH_UNKNOWN');
+    }
+}
+async function reconcileControl(execution, request) {
+    if (request.control === 'steer' || !execution.status)
+        return undefined;
+    let snapshot;
+    try {
+        snapshot = await execution.status({
+            runId: request.runId,
+            ...(request.providerSessionId === undefined
+                ? {}
+                : { providerSessionId: request.providerSessionId }),
+            ...(request.controlRef === undefined ? {} : { controlRef: request.controlRef }),
+        });
+    }
+    catch {
+        return undefined;
+    }
+    if (!snapshot ||
+        snapshot.runId !== request.runId ||
+        (request.providerSessionId !== undefined && snapshot.sessionId !== request.providerSessionId))
+        return undefined;
+    if (request.control === 'cancel' && !['aborted', 'cancelled'].includes(snapshot.status))
+        return undefined;
+    if (request.control === 'detach' && snapshot.status !== 'detached')
+        return undefined;
+    if (!providerTerminal(snapshot.status))
+        return undefined;
+    return { status: 'terminal', detail: 'CONTROL_RECONCILED_TERMINAL' };
+}
+function effectResult(value) {
+    if (value.outcome === 'accepted')
+        return {
+            status: 'acknowledged',
+            detail: safeDiagnostic(value.detail, 'CONTROL_ACKNOWLEDGED'),
+        };
+    if (value.outcome === 'already-applied')
+        return { status: 'terminal', detail: 'CONTROL_ALREADY_APPLIED' };
+    if (value.outcome === 'rejected')
+        return { status: 'failed', detail: 'CONTROL_REJECTED' };
+    return { status: 'unknown', detail: 'CONTROL_OUTCOME_UNKNOWN' };
+}
+function acknowledgementFromEffect(operationId, status, detail) {
+    if (status === 'acknowledged')
+        return { operationId, outcome: 'accepted', ...(detail ? { detail } : {}) };
+    if (status === 'terminal')
+        return { operationId, outcome: 'already-applied', ...(detail ? { detail } : {}) };
+    if (status === 'failed')
+        return { operationId, outcome: 'rejected', detail: 'CONTROL_REJECTED' };
+    return { operationId, outcome: 'unknown', detail: 'CONTROL_OUTCOME_UNKNOWN' };
+}
+function normalize(operationId, value) {
+    if ('outcome' in value)
+        return {
+            operationId,
+            outcome: value.outcome,
+            ...(value.detail === undefined
+                ? {}
+                : { detail: safeDiagnostic(value.detail, 'CONTROL_DETAIL') }),
+        };
+    return value.status === 'cancelled'
+        ? { operationId, outcome: 'accepted' }
+        : {
+            operationId,
+            outcome: 'unknown',
+            detail: safeDiagnostic(value.reason, 'CONTROL_OUTCOME_UNKNOWN'),
+        };
+}
+function unknown(operationId, detail) {
+    return { operationId, outcome: 'unknown', detail };
+}
+async function controlDeadline(action, controller, timeoutMs) {
+    let timer;
+    let timedOut = false;
+    const timeout = new Promise((resolve) => {
+        timer = setTimeout(() => {
+            timedOut = true;
+            controller.abort(new Error('Control acknowledgement deadline elapsed'));
+            resolve({
+                operationId: 'unknown',
+                outcome: 'unknown',
+                detail: 'CONTROL_ACKNOWLEDGEMENT_TIMEOUT',
+            });
+        }, timeoutMs);
+    });
+    const acknowledgement = await Promise.race([action, timeout]);
+    if (timer !== undefined)
+        clearTimeout(timer);
+    return { acknowledgement, timedOut };
+}
+function providerTerminal(status) {
+    return ['completed', 'failed', 'aborted', 'cancelled', 'blocked', 'expired'].includes(status);
+}
+//# sourceMappingURL=control-effects.js.map

package/dist/app/control-effects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-effects.js","sourceRoot":"","sources":["../../src/app/control-effects.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAErD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,KAS1C;IACC,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAA;IACzB,IAAI,cAA2D,CAAA;IAC/D,IAAI,kBAAkB,GAAG,KAAK,CAAA;IAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAChC;QACE,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,UAAU,EAAE,eAAe,OAAO,CAAC,OAAO,EAAE;QAC5C,OAAO,EAAE;YACP,GAAG,OAAO;YACV,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,IAAI;YACpD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;YAC9B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI;YAC1B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;SAC/B;QACD,gBAAgB,EAAE,OAAO,OAAO,CAAC,KAAK,UAAU;QAChD,QAAQ,EAAE;YACR,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,cAAc,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;SACrE;KACF,EACD;QACE,QAAQ,EAAE,KAAK,IAAI,EAAE;YACnB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;YACxC,cAAc,GAAG,eAAe,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,CAAA;YAC7E,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,cAAc,EAAE,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,CAAA;YACjF,kBAAkB,GAAG,MAAM,CAAC,QAAQ,CAAA;YACpC,OAAO,YAAY,CAAC,MAAM,CAAC,eAAe,CAAC,CAAA;QAC7C,CAAC;QACD,SAAS,EAAE,KAAK,IAAI,EAAE,CAAC,gBAAgB,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC;KAClE,CACF,CAAA;IACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAA;IACtC,MAAM,KAAK,CAAC,WAAW,EAAE,CAAA;IACzB,IAAI,kBAAkB,IAAI,cAAc,KAAK,SAAS,IAAI,KAAK,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;QAC/F,MAAM,UAAU,GAAG,cAAc,CAAA;QACjC,KAAK,UAAU;aACZ,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,EAAE;YAC9B,IAAI,KAAK,CAAC,aAAa,EAAE,EAAE,KAAK,KAAK;gBAAE,OAAM;YAC7C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAClC,MAAM,CAAC,WAAW,EAClB,MAAM,CAAC,aAAa,EACpB,YAAY,CAAC,eAAe,CAAC,CAC9B,CAAA;YACD,IAAI,OAAO,KAAK,SAAS;gBAAE,MAAM,KAAK,CAAC,WAAW,EAAE,CAAA;YACpD,IAAI,KAAK,CAAC,aAAa,EAAE,EAAE,KAAK,KAAK;gBAAE,OAAM;YAC7C,MAAM,KAAK,CAAC,gBAAgB,EAAE,CAAC,eAAe,CAAC,CAAA;QACjD,CAAC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;IAC3B,CAAC;IACD,OAAO,yBAAyB,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;AACrF,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,SAAwB,EACxB,OAA6B,EAC7B,MAAmB;IAEnB,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACjC,IAAI,CAAC,SAAS,CAAC,SAAS;gBACtB,OAAO,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,kCAAkC,CAAC,CAAA;YACzE,OAAO,SAAS,CACd,OAAO,CAAC,WAAW,EACnB,MAAM,SAAS,CAAC,SAAS,CAAC;gBACxB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,GAAG,CAAC,OAAO,CAAC,iBAAiB,KAAK,SAAS;oBACzC,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC;gBACrD,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;gBAC/E,MAAM;gBACN,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;aACpE,CAAC,CACH,CAAA;QACH,CAAC;QACD,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YAChC,IAAI,CAAC,SAAS,CAAC,QAAQ;gBAAE,OAAO,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,8BAA8B,CAAC,CAAA;YAC5F,OAAO,SAAS,CAAC,QAAQ,CAAC;gBACxB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;gBACxB,MAAM;aACP,CAAC,CAAA;QACJ,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,SAAS;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,4BAA4B,CAAC,CAAA;QAC3F,OAAO,SAAS,CAAC,SAAS,CAAC;YACzB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,GAAG,CAAC,OAAO,CAAC,iBAAiB,KAAK,SAAS;gBACzC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC;YACrD,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;YAC/E,MAAM;YACN,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;SACpE,CAAC,CAAA;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,0BAA0B,CAAC,CAAA;IACjE,CAAC;AACH,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,SAAwB,EACxB,OAA6B;IAE7B,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM;QAAE,OAAO,SAAS,CAAA;IACtE,IAAI,QAAoC,CAAA;IACxC,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC;YAChC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,GAAG,CAAC,OAAO,CAAC,iBAAiB,KAAK,SAAS;gBACzC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC;YACrD,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;SAChF,CAAC,CAAA;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IACE,CAAC,QAAQ;QACT,QAAQ,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK;QAChC,CAAC,OAAO,CAAC,iBAAiB,KAAK,SAAS,IAAI,QAAQ,CAAC,SAAS,KAAK,OAAO,CAAC,iBAAiB,CAAC;QAE7F,OAAO,SAAS,CAAA;IAClB,IAAI,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;QACrF,OAAO,SAAS,CAAA;IAClB,IAAI,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,UAAU;QAAE,OAAO,SAAS,CAAA;IACpF,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAA;IACxD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,6BAA6B,EAAE,CAAA;AACtE,CAAC;AAED,SAAS,YAAY,CAAC,KAA6B;IACjD,IAAI,KAAK,CAAC,OAAO,KAAK,UAAU;QAC9B,OAAO;YACL,MAAM,EAAE,cAAuB;YAC/B,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,sBAAsB,CAAC;SAC7D,CAAA;IACH,IAAI,KAAK,CAAC,OAAO,KAAK,iBAAiB;QACrC,OAAO,EAAE,MAAM,EAAE,UAAmB,EAAE,MAAM,EAAE,yBAAyB,EAAE,CAAA;IAC3E,IAAI,KAAK,CAAC,OAAO,KAAK,UAAU;QAAE,OAAO,EAAE,MAAM,EAAE,QAAiB,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAA;IAClG,OAAO,EAAE,MAAM,EAAE,SAAkB,EAAE,MAAM,EAAE,yBAAyB,EAAE,CAAA;AAC1E,CAAC;AAED,SAAS,yBAAyB,CAChC,WAAmB,EACnB,MAAoB,EACpB,MAA0B;IAE1B,IAAI,MAAM,KAAK,cAAc;QAC3B,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;IAC5E,IAAI,MAAM,KAAK,UAAU;QACvB,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;IACnF,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAA;IAChG,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,yBAAyB,EAAE,CAAA;AAC/E,CAAC;AAED,SAAS,SAAS,CAChB,WAAmB,EACnB,KAA+C;IAE/C,IAAI,SAAS,IAAI,KAAK;QACpB,OAAO;YACL,WAAW;YACX,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS;gBAC5B,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,gBAAgB,CAAC,EAAE,CAAC;SAChE,CAAA;IACH,OAAO,KAAK,CAAC,MAAM,KAAK,WAAW;QACjC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE;QACtC,CAAC,CAAC;YACE,WAAW;YACX,OAAO,EAAE,SAAS;YAClB,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,yBAAyB,CAAC;SAChE,CAAA;AACP,CAAC;AAED,SAAS,OAAO,CAAC,WAAmB,EAAE,MAAc;IAClD,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAA;AACpD,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,MAAuC,EACvC,UAA2B,EAC3B,SAAiB;IAEjB,IAAI,KAAgD,CAAA;IACpD,IAAI,QAAQ,GAAG,KAAK,CAAA;IACpB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAyB,CAAC,OAAO,EAAE,EAAE;QAC9D,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,QAAQ,GAAG,IAAI,CAAA;YACf,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC,CAAA;YACvE,OAAO,CAAC;gBACN,WAAW,EAAE,SAAS;gBACtB,OAAO,EAAE,SAAS;gBAClB,MAAM,EAAE,iCAAiC;aAC1C,CAAC,CAAA;QACJ,CAAC,EAAE,SAAS,CAAC,CAAA;IACf,CAAC,CAAC,CAAA;IACF,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC7D,IAAI,KAAK,KAAK,SAAS;QAAE,YAAY,CAAC,KAAK,CAAC,CAAA;IAC5C,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAA;AACtC,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAqC;IAC7D,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;AAC/F,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { BranchRecord, ConversationRecord } from '../domain/entities.js';
+import { type BranchId, type ConversationId } from '../domain/ids.js';
+import type { CloneConversationInput, ConversationHost, CreateBranchInput, ForkPlan, ForkPlanInput } from './conversation-types.js';
+export declare class ConversationBranches {
+    #private;
+    constructor(host: ConversationHost);
+    create(input: CreateBranchInput): Promise<BranchRecord>;
+    clone(input: CloneConversationInput): Promise<ConversationRecord>;
+    plan(input: ForkPlanInput): ForkPlan;
+    execute(input: ForkPlanInput & {
+        readonly planDigest: string;
+    }): Promise<BranchRecord>;
+}
+export type { BranchId, ConversationId };
+//# sourceMappingURL=conversation-branches.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-branches.d.ts","sourceRoot":"","sources":["../../src/app/conversation-branches.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAiB,MAAM,uBAAuB,CAAA;AAE5F,OAAO,EAIL,KAAK,QAAQ,EACb,KAAK,cAAc,EAEpB,MAAM,kBAAkB,CAAA;AAqBzB,OAAO,KAAK,EACV,sBAAsB,EACtB,gBAAgB,EAChB,iBAAiB,EACjB,QAAQ,EACR,aAAa,EACd,MAAM,yBAAyB,CAAA;AAShC,qBAAa,oBAAoB;;IAG/B,YAAY,IAAI,EAAE,gBAAgB,EAEjC;IAEK,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CAE5D;IAoFK,KAAK,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAEtE;IAwDD,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,QAAQ,CA8CnC;IAEK,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG;QAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAI3F;CAmBF;AA+FD,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAA"}