@tangle-network/braid 0.1.0

package/dist/app/analysis-service.js

@@ -0,0 +1,202 @@
+import { AnalysisExecutionSession } from './analysis-execution-session.js';
+import { AnalysisGraphProjector } from './analysis-graph-projector.js';
+import { AnalysisLifecycle } from './analysis-lifecycle.js';
+import { analysisModelCallRecords } from './analysis-model-call-records.js';
+import { AnalysisOperationError } from './analysis-operation.js';
+import { prepareAnalysisRequest } from './analysis-request.js';
+import { completedAnalysisRecord, initialAnalysisRecord } from './analysis-result-mapper.js';
+import { AnalysisPersistenceError } from './analysis-types.js';
+import { UnavailableAnalyst } from './unavailable-analyst.js';
+function assertSuccessfulAnalysts(result) {
+    if (result.completion.status === 'failed')
+        throw new Error(result.completion.error.message);
+    const failed = result.per_analyst.find((summary) => summary.status === 'failed');
+    if (failed === undefined)
+        return;
+    const reason = failed.error?.message ?? 'The analyst failed without an error message.';
+    throw new Error(`Trace analyst '${failed.analyst_id}' failed: ${reason}`);
+}
+export class AnalysisService {
+    #host;
+    #lifecycle;
+    #execution;
+    #graph;
+    #active = new Set();
+    #reconciled = false;
+    constructor(host, analyst = new UnavailableAnalyst()) {
+        this.#host = host;
+        this.#lifecycle = new AnalysisLifecycle(host);
+        this.#execution = new AnalysisExecutionSession(analyst);
+        this.#graph = new AnalysisGraphProjector(host);
+    }
+    listAnalysts() {
+        return this.#execution.listAnalysts();
+    }
+    async reconcile() {
+        await this.#lifecycle.reconcile(this.#active);
+        this.#reconciled = true;
+    }
+    cancel(analysisId, reason = 'cancelled by user') {
+        return this.#execution.cancel(String(analysisId), reason);
+    }
+    async *stream(request) {
+        if (!this.#reconciled)
+            await this.reconcile();
+        const prepared = prepareAnalysisRequest(this.#host, request);
+        const existing = this.#lifecycle.existing(prepared.identity);
+        if (existing !== undefined) {
+            if (existing.status === 'preparing' || existing.status === 'running') {
+                throw new Error(`Analysis ${String(existing.id)} is already active`);
+            }
+            yield { type: 'started', analysis: existing, replayed: true };
+            await this.#graph.project(existing);
+            await this.#lifecycle.repairTerminal(existing);
+            yield this.#lifecycle.replay(existing, prepared.evidence);
+            return;
+        }
+        const record = initialAnalysisRecord({
+            host: this.#host,
+            evidence: prepared.evidence,
+            request,
+            identity: prepared.identity,
+            executionTarget: prepared.executionTarget,
+            at: this.#host.now(),
+        });
+        this.#active.add(String(record.id));
+        let current = record;
+        let resultCommitted = false;
+        let modelExecutions = [];
+        try {
+            const operation = await this.#lifecycle.reserve(prepared.identity);
+            if (!operation.created) {
+                const replay = this.#lifecycle.existing(prepared.identity);
+                if (replay !== undefined && replay.status !== 'preparing' && replay.status !== 'running') {
+                    yield { type: 'started', analysis: replay, replayed: true };
+                    yield this.#lifecycle.replay(replay, prepared.evidence);
+                    return;
+                }
+                throw new Error(`Analysis operation ${String(operation.operation.id)} is already active or unavailable`);
+            }
+            await this.#lifecycle.create(current);
+            yield { type: 'started', analysis: current };
+            current = await this.#lifecycle.running(current);
+            yield { type: 'running', analysis: current };
+            const analystIds = this.#execution.resolveAnalystIds(request);
+            let exactResult;
+            for await (const item of this.#execution.stream({
+                identity: prepared.identity,
+                evidence: prepared.evidence,
+                request,
+                analystIds,
+                executionTarget: prepared.executionTarget,
+            })) {
+                if (item.result !== undefined)
+                    exactResult = item.result;
+                yield {
+                    type: 'analyst',
+                    analysisId: prepared.identity.analysisId,
+                    analysisRunId: prepared.identity.analysisRunId,
+                    event: item.event,
+                };
+            }
+            if (exactResult === undefined)
+                throw new Error('agent-eval exact stream ended without a result');
+            assertSuccessfulAnalysts(exactResult);
+            modelExecutions = this.#execution.modelExecutions(String(prepared.identity.analysisRunId));
+            current = await completedAnalysisRecord({
+                host: this.#host,
+                base: current,
+                evidence: prepared.evidence,
+                request,
+                identity: prepared.identity,
+                executionTarget: prepared.executionTarget,
+                analystIds,
+                descriptors: this.#execution.listAnalysts(),
+                modelExecutions,
+                result: exactResult,
+                at: this.#host.now(),
+            });
+            await this.#lifecycle.completed(current);
+            resultCommitted = true;
+            await this.#graph.project(current);
+            await this.#lifecycle.finish(current);
+            yield {
+                type: 'completed',
+                analysis: current,
+                evidence: prepared.evidence,
+                result: exactResult,
+            };
+        }
+        catch (value) {
+            const error = value instanceof Error ? value : new Error(String(value));
+            if (resultCommitted)
+                throw error;
+            if (error instanceof AnalysisPersistenceError || error instanceof AnalysisOperationError) {
+                throw error;
+            }
+            modelExecutions = this.#execution.modelExecutions(String(prepared.identity.analysisRunId));
+            current = { ...current, modelCalls: analysisModelCallRecords(modelExecutions) };
+            const cancelled = this.#execution.wasCancelled(String(current.id));
+            const failed = await this.#lifecycle.failed(current, error, cancelled);
+            if (cancelled) {
+                yield {
+                    type: 'cancelled',
+                    analysis: failed,
+                    evidence: prepared.evidence,
+                    reason: error.message,
+                };
+            }
+            else {
+                yield {
+                    type: 'failed',
+                    analysis: failed,
+                    evidence: prepared.evidence,
+                    error,
+                };
+            }
+        }
+        finally {
+            this.#active.delete(String(record.id));
+        }
+    }
+    async run(request) {
+        let terminal;
+        for await (const progress of this.stream(request))
+            terminal = progress;
+        if (terminal === undefined)
+            throw new Error('analysis stream produced no terminal result');
+        if (terminal.type === 'completed') {
+            return {
+                status: 'completed',
+                analysis: terminal.analysis,
+                evidence: terminal.evidence,
+                ...(terminal.result === undefined
+                    ? {}
+                    : { result: terminal.result }),
+                ...(terminal.replayed === undefined ? {} : { replayed: terminal.replayed }),
+            };
+        }
+        if (terminal.type === 'failed') {
+            return {
+                status: 'failed',
+                analysis: terminal.analysis,
+                evidence: terminal.evidence,
+                error: terminal.error,
+                ...(terminal.result === undefined
+                    ? {}
+                    : { result: terminal.result }),
+                ...(terminal.replayed === undefined ? {} : { replayed: terminal.replayed }),
+            };
+        }
+        if (terminal.type === 'cancelled') {
+            return {
+                status: 'cancelled',
+                analysis: terminal.analysis,
+                evidence: terminal.evidence,
+                ...(terminal.replayed === undefined ? {} : { replayed: terminal.replayed }),
+            };
+        }
+        throw new Error(`analysis stream ended before a terminal result (${terminal.type})`);
+    }
+}
+//# sourceMappingURL=analysis-service.js.map

package/dist/app/analysis-service.js.map

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

package/dist/app/analysis-source.d.ts

@@ -0,0 +1,31 @@
+import type { BraidEventEnvelope, JournalEventEnvelope } from '../domain/events.js';
+import { type EventId } from '../domain/ids.js';
+import type { BraidState } from '../domain/state.js';
+import { type AnalysisSourceRequest, type FrozenAnalysisEvent, type FrozenAnalysisEvidence } from './analysis-types.js';
+export interface FreezeAnalysisSourceInput extends AnalysisSourceRequest {
+    readonly state: BraidState;
+    readonly events: readonly BraidEventEnvelope[];
+}
+export type AnalysisSourceKind = 'run' | 'branch';
+export interface AnalysisSourceReference {
+    readonly kind: AnalysisSourceKind;
+    readonly id: string;
+}
+export interface AnalysisSourceProjection {
+    readonly reference: AnalysisSourceReference;
+    readonly request: AnalysisSourceRequest;
+}
+/** Parses the stable command token without resolving it against current state. */
+export declare function parseAnalysisSourceReference(value: string): AnalysisSourceReference | undefined;
+export declare function formatAnalysisSourceReference(reference: AnalysisSourceReference): string;
+export declare function analysisSourceReference(source: {
+    readonly branchId: string;
+    readonly runId?: string;
+}): AnalysisSourceReference;
+/** Resolves one command source and retains whether the user named a run or branch. */
+export declare function projectAnalysisSource(state: BraidState, value: string): AnalysisSourceProjection | undefined;
+export declare function freezeAnalysisSource(input: FreezeAnalysisSourceInput): FrozenAnalysisEvidence;
+export declare function verifyFrozenAnalysisSource(evidence: FrozenAnalysisEvidence): void;
+export declare function sourceEventForId(evidence: FrozenAnalysisEvidence, eventId: EventId): FrozenAnalysisEvent | undefined;
+export declare function sourceEventIdForEnvelope(envelope: JournalEventEnvelope): EventId;
+//# sourceMappingURL=analysis-source.d.ts.map

package/dist/app/analysis-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-source.d.ts","sourceRoot":"","sources":["../../src/app/analysis-source.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAc,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAE/F,OAAO,EAML,KAAK,OAAO,EAIb,MAAM,kBAAkB,CAAA;AAEzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC5B,MAAM,qBAAqB,CAAA;AAG5B,MAAM,WAAW,yBAA0B,SAAQ,qBAAqB;IACtE,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAA;CAC/C;AAED,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,QAAQ,CAAA;AAEjD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAA;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAA;IAC3C,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAA;CACxC;AAED,kFAAkF;AAClF,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS,CAS/F;AAED,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,uBAAuB,GAAG,MAAM,CAExF;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB,GAAG,uBAAuB,CAI1B;AAED,sFAAsF;AACtF,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,MAAM,GACZ,wBAAwB,GAAG,SAAS,CA4BtC;AAuLD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,GAAG,sBAAsB,CAqE7F;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAUjF;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,sBAAsB,EAChC,OAAO,EAAE,OAAO,GACf,mBAAmB,GAAG,SAAS,CAEjC;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAEhF"}

package/dist/app/analysis-source.js

@@ -0,0 +1,274 @@
+import { canonicalDigest } from '../domain/canonical.js';
+import { eventRunId } from '../domain/events.js';
+import { createEventId, createTraceId, isEventId, } from '../domain/ids.js';
+import { redactBraidEvent } from '../domain/redaction.js';
+import { AnalysisSourceError, } from './analysis-types.js';
+import { messagesVisibleOnBranch } from './conversation-context.js';
+/** Parses the stable command token without resolving it against current state. */
+export function parseAnalysisSourceReference(value) {
+    const normalized = value.trim();
+    for (const kind of ['run', 'branch']) {
+        const prefix = `${kind}:`;
+        if (!normalized.startsWith(prefix))
+            continue;
+        const id = normalized.slice(prefix.length).trim();
+        return id.length === 0 ? undefined : { kind, id };
+    }
+    return undefined;
+}
+export function formatAnalysisSourceReference(reference) {
+    return `${reference.kind}:${reference.id}`;
+}
+export function analysisSourceReference(source) {
+    return source.runId === undefined
+        ? { kind: 'branch', id: source.branchId }
+        : { kind: 'run', id: source.runId };
+}
+/** Resolves one command source and retains whether the user named a run or branch. */
+export function projectAnalysisSource(state, value) {
+    const normalized = value.trim();
+    if (normalized === 'active' || normalized === 'last') {
+        const run = [...state.runs]
+            .reverse()
+            .find((candidate) => candidate.branchId === state.branchId &&
+            candidate.complete &&
+            (candidate.status === 'completed' || candidate.status === 'failed'));
+        return run === undefined ? undefined : projectionForRun(run);
+    }
+    const parsed = parseAnalysisSourceReference(normalized);
+    if (parsed?.kind === 'run') {
+        const run = state.runs.find((candidate) => String(candidate.id) === parsed.id);
+        return run === undefined ? undefined : projectionForRun(run);
+    }
+    if (parsed?.kind === 'branch') {
+        const branch = state.branches.find((candidate) => String(candidate.id) === parsed.id);
+        return branch === undefined ? undefined : projectionForBranch(branch);
+    }
+    const run = state.runs.find((candidate) => String(candidate.id) === normalized);
+    if (run !== undefined)
+        return projectionForRun(run);
+    const branch = state.branches.find((candidate) => String(candidate.id) === normalized);
+    return branch === undefined ? undefined : projectionForBranch(branch);
+}
+function projectionForRun(run) {
+    return {
+        reference: analysisSourceReference({ branchId: String(run.branchId), runId: String(run.id) }),
+        request: { conversationId: run.conversationId, branchId: run.branchId, runId: run.id },
+    };
+}
+function projectionForBranch(branch) {
+    return {
+        reference: analysisSourceReference({ branchId: String(branch.id) }),
+        request: { conversationId: branch.conversationId, branchId: branch.id },
+    };
+}
+function cloneAndFreeze(value) {
+    let cloned;
+    try {
+        cloned = structuredClone(value);
+    }
+    catch (error) {
+        throw new AnalysisSourceError(`Analysis source contains a value that cannot be snapshotted: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return freezeValue(cloned);
+}
+function freezeValue(value) {
+    if (value === null || typeof value !== 'object')
+        return value;
+    for (const child of Object.values(value))
+        freezeValue(child);
+    return Object.freeze(value);
+}
+function safeEventId(envelope, event) {
+    if (envelope.eventId !== undefined && isEventId(envelope.eventId))
+        return envelope.eventId;
+    return createEventId(`event-${canonicalDigest({
+        sequence: envelope.sequence,
+        revision: envelope.revision,
+        occurredAt: envelope.occurredAt,
+        event,
+    }).slice(0, 40)}`);
+}
+function redactedClone(value) {
+    return cloneAndFreeze(redactBraidEvent(cloneAndFreeze(value)));
+}
+function eventMessageId(event) {
+    return event.kind === 'message.created' ? event.message.id : undefined;
+}
+function branchMessages(state, conversationId, branchId, throughMessageId) {
+    const messages = messagesVisibleOnBranch(state, branchId).filter((message) => message.conversationId === conversationId);
+    if (throughMessageId === undefined)
+        return messages.map(redactedClone);
+    const throughIndex = messages.findIndex((message) => message.id === throughMessageId);
+    if (throughIndex < 0)
+        return messages.map(redactedClone);
+    return messages.slice(0, throughIndex + 1).map(redactedClone);
+}
+function messageParts(state, messages) {
+    const messageIds = new Set(messages.map((message) => message.id));
+    return state.messageParts.filter((part) => messageIds.has(part.messageId)).map(redactedClone);
+}
+function matchingMissingHistory(state, runId) {
+    if (runId === undefined)
+        return undefined;
+    return state.missingHistory.find((range) => range.runId === runId);
+}
+function sourceRun(state, runId) {
+    if (runId === undefined)
+        return undefined;
+    const run = state.runs.find((candidate) => candidate.id === runId);
+    if (run === undefined)
+        throw new AnalysisSourceError(`Run ${runId} is not present in Braid state`);
+    return run;
+}
+function boundarySequence(events, throughMessageId) {
+    if (throughMessageId === undefined)
+        return undefined;
+    const boundary = events.find((envelope) => {
+        if (envelope.event.kind === 'message.created') {
+            return eventMessageId(envelope.event) === throughMessageId;
+        }
+        if (envelope.event.kind === 'run.requested') {
+            return (envelope.event.userMessageId === throughMessageId ||
+                envelope.event.assistantMessageId === throughMessageId);
+        }
+        return false;
+    });
+    return boundary?.sequence;
+}
+function sourceEvents(events, runId) {
+    if (runId === undefined)
+        return [];
+    const matching = events
+        .filter((envelope) => eventRunId(envelope.event) === runId)
+        .sort((left, right) => left.sequence - right.sequence);
+    const terminalSequence = matching.find((envelope) => {
+        if (envelope.event.kind === 'run.finished')
+            return true;
+        if (envelope.event.kind === 'run.reconciled') {
+            return [
+                'completed',
+                'failed',
+                'cancelled',
+                'aborted',
+                'blocked',
+                'expired',
+                'unknown',
+            ].includes(envelope.event.status);
+        }
+        return (envelope.event.kind === 'run.status.changed' &&
+            ['completed', 'failed', 'cancelled', 'aborted', 'blocked', 'expired', 'unknown'].includes(envelope.event.status));
+    })?.sequence;
+    return matching
+        .filter((envelope) => terminalSequence === undefined || envelope.sequence <= terminalSequence)
+        .map((envelope) => {
+        const event = redactedClone(envelope.event);
+        return cloneAndFreeze({
+            id: safeEventId(envelope, event),
+            sequence: envelope.sequence,
+            revision: envelope.revision,
+            occurredAt: envelope.occurredAt,
+            event,
+        });
+    });
+}
+function sourceDigestForEvidence(evidence) {
+    const evidenceDigest = digestOfEvidence({
+        run: evidence.run,
+        events: evidence.events,
+        messages: evidence.messages,
+        messageParts: evidence.messageParts,
+    });
+    return canonicalDigest({
+        conversationId: evidence.source.conversationId,
+        branchId: evidence.source.branchId,
+        runId: evidence.source.runId,
+        throughMessageId: evidence.source.throughMessageId,
+        evidenceDigest,
+        complete: evidence.source.complete,
+        missingHistory: evidence.source.missingHistory,
+    });
+}
+function digestOfEvidence(input) {
+    return canonicalDigest(input);
+}
+export function freezeAnalysisSource(input) {
+    const conversationId = input.conversationId ?? input.state.conversationId;
+    const branchId = input.branchId ?? input.state.branchId;
+    if (conversationId === null || branchId === null) {
+        throw new AnalysisSourceError('Analysis requires an open conversation and branch');
+    }
+    const run = sourceRun(input.state, input.runId);
+    if (run !== undefined) {
+        if (run.conversationId !== conversationId || run.branchId !== branchId) {
+            throw new AnalysisSourceError(`Run ${run.id} does not belong to ${conversationId}/${branchId}`);
+        }
+    }
+    const branch = input.state.branches.find((candidate) => candidate.id === branchId);
+    const throughMessageId = input.throughMessageId ?? branch?.tipMessageId;
+    const throughSequence = boundarySequence(input.events, throughMessageId);
+    const missingHistory = matchingMissingHistory(input.state, run?.id);
+    const messages = branchMessages(input.state, conversationId, branchId, throughMessageId);
+    const parts = messageParts(input.state, messages);
+    const events = sourceEvents(input.events, run?.id);
+    const evidenceDigest = digestOfEvidence({
+        run: run === undefined ? undefined : redactedClone(run),
+        events,
+        messages,
+        messageParts: parts,
+    });
+    const complete = missingHistory === undefined &&
+        (run === undefined ||
+            (run.complete && (throughMessageId === undefined || throughSequence !== undefined)));
+    const sourceDigest = canonicalDigest({
+        conversationId,
+        branchId,
+        runId: run?.id,
+        throughMessageId,
+        evidenceDigest,
+        complete,
+        missingHistory,
+    });
+    const source = cloneAndFreeze({
+        conversationId,
+        branchId,
+        ...(run === undefined ? {} : { runId: run.id }),
+        ...(throughMessageId === undefined ? {} : { throughMessageId }),
+        ...(run === undefined
+            ? {}
+            : {
+                trace: {
+                    id: createTraceId(`trace-${String(run.id).replace(/[^A-Za-z0-9._:-]/gu, '-')}`),
+                    provider: 'runtime',
+                    reference: `braid://run/${run.id}`,
+                    digest: sourceDigest,
+                },
+            }),
+        digest: sourceDigest,
+        complete,
+        ...(missingHistory === undefined ? {} : { missingHistory }),
+    });
+    return cloneAndFreeze({
+        source,
+        ...(run === undefined ? {} : { run: redactedClone(run) }),
+        events,
+        messages,
+        messageParts: parts,
+    });
+}
+export function verifyFrozenAnalysisSource(evidence) {
+    const expected = sourceDigestForEvidence(evidence);
+    if (expected !== evidence.source.digest) {
+        throw new AnalysisSourceError(`Frozen analysis source digest mismatch: expected ${expected}, received ${evidence.source.digest}`);
+    }
+    if (evidence.source.trace !== undefined && evidence.source.trace.digest !== expected) {
+        throw new AnalysisSourceError('Frozen trace reference digest does not match the source digest');
+    }
+}
+export function sourceEventForId(evidence, eventId) {
+    return evidence.events.find((event) => event.id === eventId);
+}
+export function sourceEventIdForEnvelope(envelope) {
+    return safeEventId(envelope, envelope.event);
+}
+//# sourceMappingURL=analysis-source.js.map

package/dist/app/analysis-source.js.map

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

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

@@ -0,0 +1,118 @@
+import type { AgentProfile, HarnessType } from '@tangle-network/agent-interface';
+import type { AnalysisRecord, ConnectionRecord, FrozenAnalysisSource, MessagePartRecord, MessageRecord, RunRecord } from '../domain/entities.js';
+import type { BraidEvent, BraidEventEnvelope } from '../domain/events.js';
+import type { AnalysisId, AnalysisRunId, BranchId, ConnectionId, ConversationId, Digest, EventId, MessageId, ProfileId, RunId } from '../domain/ids.js';
+import type { BraidState } from '../domain/state.js';
+export type AnalysisRecipe = 'ask' | 'failure' | 'cost' | 'tools' | 'improvement' | (string & {});
+export interface AnalysisSourceRequest {
+    readonly conversationId?: ConversationId;
+    readonly branchId?: BranchId;
+    readonly runId?: RunId;
+    readonly throughMessageId?: MessageId;
+}
+export interface AnalysisRequest extends AnalysisSourceRequest {
+    readonly operationId?: string;
+    readonly question?: string;
+    readonly recipe?: AnalysisRecipe;
+    readonly analystIds?: readonly string[];
+    readonly analystProfileId?: ProfileId;
+    readonly analystProfileDigest?: Digest;
+    readonly budgetUsd?: number;
+    readonly totalTimeoutMs?: number;
+}
+export interface FrozenAnalysisEvent {
+    readonly id: EventId;
+    readonly sequence: number;
+    readonly revision: number;
+    readonly occurredAt: string;
+    readonly event: BraidEvent;
+}
+export interface FrozenAnalysisEvidence {
+    readonly source: FrozenAnalysisSource;
+    readonly run?: RunRecord;
+    readonly events: readonly FrozenAnalysisEvent[];
+    readonly messages: readonly MessageRecord[];
+    readonly messageParts: readonly MessagePartRecord[];
+}
+/** Exact, secret-free route captured before one analysis leaves the process. */
+export interface AnalysisExecutionTarget {
+    readonly profile: Readonly<AgentProfile>;
+    readonly profileId?: ProfileId;
+    readonly profileDigest: Digest;
+    readonly connection?: ConnectionRecord;
+    readonly connectionId?: ConnectionId;
+    readonly connectionDigest?: Digest;
+    readonly model?: string;
+    readonly runner?: HarnessType;
+}
+export interface AnalysisApplicationHost {
+    readonly currentState: () => BraidState;
+    readonly eventHistory: () => readonly BraidEventEnvelope[];
+    readonly commit: (event: BraidEvent) => void | Promise<void>;
+    readonly commitAndWait?: (event: BraidEvent) => void | Promise<void>;
+    readonly now: () => string;
+    readonly analysisExecutionTarget?: (state: BraidState) => AnalysisExecutionTarget;
+}
+export interface AnalysisProgressStarted {
+    readonly type: 'started';
+    readonly analysis: AnalysisRecord;
+    readonly replayed?: boolean;
+}
+export interface AnalysisProgressRunning {
+    readonly type: 'running';
+    readonly analysis: AnalysisRecord;
+}
+export interface AnalysisProgressAnalyst {
+    readonly type: 'analyst';
+    readonly analysisId: AnalysisId;
+    readonly analysisRunId: AnalysisRunId;
+    readonly event: unknown;
+}
+export interface AnalysisProgressCompleted {
+    readonly type: 'completed';
+    readonly analysis: AnalysisRecord;
+    readonly evidence: FrozenAnalysisEvidence;
+    readonly result: unknown;
+    readonly replayed?: boolean;
+}
+export interface AnalysisProgressFailed {
+    readonly type: 'failed';
+    readonly analysis: AnalysisRecord;
+    readonly evidence: FrozenAnalysisEvidence;
+    readonly error: AnalysisCapabilityError | Error;
+    readonly result?: unknown;
+    readonly replayed?: boolean;
+}
+export interface AnalysisProgressCancelled {
+    readonly type: 'cancelled';
+    readonly analysis: AnalysisRecord;
+    readonly evidence: FrozenAnalysisEvidence;
+    readonly reason?: string;
+    readonly replayed?: boolean;
+}
+export type AnalysisProgress = AnalysisProgressStarted | AnalysisProgressRunning | AnalysisProgressAnalyst | AnalysisProgressCompleted | AnalysisProgressFailed | AnalysisProgressCancelled;
+export interface AnalysisCapabilityIssue {
+    readonly capability: string;
+    readonly packageName: string;
+    readonly packageVersion: string;
+    readonly reason: string;
+    readonly reproduction: string;
+}
+export declare class AnalysisCapabilityError extends Error {
+    readonly code = "ANALYSIS_CAPABILITY_UNAVAILABLE";
+    readonly issue: AnalysisCapabilityIssue;
+    constructor(issue: AnalysisCapabilityIssue);
+}
+export declare class AnalysisSourceError extends Error {
+    readonly code = "ANALYSIS_SOURCE_INVALID";
+    constructor(message: string);
+}
+export declare class AnalysisCitationError extends Error {
+    readonly code = "ANALYSIS_CITATION_INVALID";
+    constructor(message: string);
+}
+export declare class AnalysisPersistenceError extends Error {
+    readonly code = "ANALYSIS_PERSISTENCE_UNKNOWN";
+    constructor(message: string, cause?: unknown);
+}
+//# sourceMappingURL=analysis-types.d.ts.map