@askdkc/kiokuko 0.1.0

package/dist/ledger/store.js

@@ -0,0 +1,324 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { withImmediateTransaction } from '../db/transaction.js';
+import { KiokukoError } from '../errors.js';
+import { canonicalJson, hashLedgerEvent, GENESIS_HASH } from './hash.js';
+import { sanitizeEvent, sanitizeRunMetadata, sanitizeTask } from './redaction.js';
+import { sanitizeJson } from '../security/sanitize.js';
+import { validateEventBatch, validateRunInput, validateRunStatus, validateTimestamp } from './validate.js';
+import { TERMINAL_RUN_STATUSES, } from './types.js';
+function notFound(message) {
+    throw new KiokukoError('NOT_FOUND', message);
+}
+function conflict(message) {
+    throw new KiokukoError('CONFLICT', message);
+}
+function parseJson(value) {
+    return JSON.parse(value);
+}
+function sameOptional(left, right) {
+    return (left ?? null) === (right ?? null);
+}
+function withBatchSavepoint(database, operation) {
+    const savepoint = `kiokuko_ledger_batch_${randomUUID().replaceAll('-', '')}`;
+    database.exec(`SAVEPOINT ${savepoint}`);
+    try {
+        const result = operation();
+        database.exec(`RELEASE SAVEPOINT ${savepoint}`);
+        return result;
+    }
+    catch (error) {
+        try {
+            database.exec(`ROLLBACK TO SAVEPOINT ${savepoint}`);
+            database.exec(`RELEASE SAVEPOINT ${savepoint}`);
+        }
+        catch {
+            // Preserve the original batch failure.
+        }
+        throw error;
+    }
+}
+function eventFingerprint(event, redaction) {
+    return canonicalJson({
+        sourceEventId: event.sourceEventId ?? null,
+        sourceSequence: event.sourceSequence ?? null,
+        eventType: event.eventType,
+        sourceType: event.sourceType ?? null,
+        actor: event.actor,
+        outcome: event.outcome ?? null,
+        occurredAt: event.occurredAt ?? null,
+        payload: event.payload,
+        redaction,
+    });
+}
+function rowFingerprint(row) {
+    return eventFingerprint({
+        ...(row.source_event_id === null ? {} : { sourceEventId: row.source_event_id }),
+        ...(row.source_sequence === null ? {} : { sourceSequence: row.source_sequence }),
+        eventType: row.event_type,
+        ...(row.source_type === null ? {} : { sourceType: row.source_type }),
+        actor: row.actor,
+        outcome: row.outcome,
+        ...(row.occurred_at === null ? {} : { occurredAt: row.occurred_at }),
+        payload: parseJson(row.payload_json),
+    }, parseJson(row.redaction_json));
+}
+function preparedEvents(events, options) {
+    const prepared = events.map((input) => {
+        const sanitized = sanitizeEvent(input, options);
+        const sanitizedInput = sanitized.value;
+        return {
+            input: sanitizedInput,
+            sanitized,
+            eventId: sanitizedInput.eventId ?? randomUUID(),
+            fingerprint: eventFingerprint(sanitizedInput, sanitized.redactions),
+        };
+    });
+    const sourceIds = new Set();
+    const eventIds = new Set();
+    for (const event of prepared) {
+        if (event.input.sourceEventId && sourceIds.has(event.input.sourceEventId))
+            conflict('duplicate source event ID in batch');
+        if (event.input.sourceEventId)
+            sourceIds.add(event.input.sourceEventId);
+        if (eventIds.has(event.eventId))
+            conflict('duplicate event ID in batch');
+        eventIds.add(event.eventId);
+    }
+    return prepared;
+}
+function rowToRun(row) {
+    return {
+        runId: row.run_id,
+        workspace: row.workspace,
+        client: {
+            kind: row.client_kind,
+            ...(row.client_version === null ? {} : { version: row.client_version }),
+            ...(row.source_session_id === null ? {} : { sessionId: row.source_session_id }),
+        },
+        protocolVersion: row.protocol_version,
+        captureProfile: row.capture_profile,
+        coverage: parseJson(row.coverage_json),
+        status: row.status,
+        title: row.title,
+        taskHash: row.task_hash,
+        metadata: parseJson(row.metadata_json),
+        lastSequence: row.last_sequence,
+        lastSourceSequence: row.last_source_sequence,
+        startedAt: row.started_at,
+        endedAt: row.ended_at,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+export class LedgerStore {
+    database;
+    options;
+    constructor(database, options = {}) {
+        this.database = database;
+        this.options = options;
+    }
+    /** Run a standalone operation in the store's top-level transaction. */
+    withTransaction(operation) {
+        return withImmediateTransaction(this.database, operation);
+    }
+    createRun(input) {
+        const prepared = this.prepareRun(input);
+        return withImmediateTransaction(this.database, () => this.insertPreparedRun(prepared));
+    }
+    /** Caller-owned transaction primitive; it deliberately does not begin or commit a transaction. */
+    createRunInTransaction(input, now = this.now()) {
+        const prepared = this.prepareRun(input, now);
+        return this.insertPreparedRun(prepared);
+    }
+    readRun(runId, workspace) {
+        const row = workspace === undefined
+            ? this.database.prepare('SELECT * FROM ledger_runs WHERE run_id = ?').get(runId)
+            : this.database.prepare('SELECT * FROM ledger_runs WHERE run_id = ? AND workspace = ?').get(runId, workspace);
+        return row ? rowToRun(row) : undefined;
+    }
+    getRunStatus(runId, workspace) {
+        return this.readRun(runId, workspace)?.status;
+    }
+    updateRunStatus(runId, status, endedAt) {
+        const validatedStatus = validateRunStatus(status);
+        const timestamp = validateTimestamp(endedAt ?? this.now(), 'endedAt');
+        return withImmediateTransaction(this.database, () => this.updateRunStatusInTransaction(runId, validatedStatus, timestamp));
+    }
+    updateRunStatusInTransaction(runId, status, endedAt = this.now()) {
+        const validatedStatus = validateRunStatus(status);
+        const timestamp = validateTimestamp(endedAt, 'endedAt');
+        const current = this.database.prepare('SELECT * FROM ledger_runs WHERE run_id = ?').get(runId);
+        if (!current)
+            notFound('Ledger run not found');
+        if (TERMINAL_RUN_STATUSES.includes(current.status) && current.status !== validatedStatus)
+            conflict('Terminal ledger run cannot change status');
+        this.database.prepare('UPDATE ledger_runs SET status = ?, ended_at = ?, updated_at = ? WHERE run_id = ?').run(validatedStatus, TERMINAL_RUN_STATUSES.includes(validatedStatus) ? timestamp : null, timestamp, runId);
+        const updated = this.database.prepare('SELECT * FROM ledger_runs WHERE run_id = ?').get(runId);
+        if (!updated)
+            notFound('Ledger run not found');
+        return rowToRun(updated);
+    }
+    appendBatch(runId, input) {
+        const events = preparedEvents(validateEventBatch(input), this.options);
+        return withImmediateTransaction(this.database, () => this.appendPreparedBatchInTransaction(runId, events));
+    }
+    /** Caller-owned transaction primitive; a savepoint isolates this batch without committing or rolling back the outer transaction. */
+    appendBatchInTransaction(runId, input) {
+        const events = preparedEvents(validateEventBatch(input), this.options);
+        return withBatchSavepoint(this.database, () => this.appendPreparedBatchInTransaction(runId, events));
+    }
+    readEvents(runId) {
+        return this.database.prepare('SELECT * FROM ledger_events WHERE run_id = ? ORDER BY sequence').all(runId);
+    }
+    verifyChain(runId) {
+        let previous = GENESIS_HASH;
+        const rows = this.readEvents(runId);
+        for (let index = 0; index < rows.length; index += 1) {
+            const row = rows[index];
+            if (!row || row.sequence !== index + 1 || row.previous_hash !== previous)
+                return false;
+            const calculated = hashLedgerEvent({
+                runId,
+                sequence: row.sequence,
+                eventId: row.event_id,
+                previousHash: row.previous_hash,
+                eventType: row.event_type,
+                ...(row.source_event_id === null ? {} : { sourceEventId: row.source_event_id }),
+                ...(row.source_sequence === null ? {} : { sourceSequence: row.source_sequence }),
+                ...(row.source_type === null ? {} : { sourceType: row.source_type }),
+                actor: row.actor,
+                ...(row.outcome === null ? {} : { outcome: row.outcome }),
+                ...(row.occurred_at === null ? {} : { occurredAt: row.occurred_at }),
+                ingestedAt: row.ingested_at,
+                payload: parseJson(row.payload_json),
+                redaction: parseJson(row.redaction_json),
+            });
+            if (calculated !== row.event_hash)
+                return false;
+            previous = row.event_hash;
+        }
+        return true;
+    }
+    now() {
+        return this.options.now?.() ?? new Date().toISOString();
+    }
+    prepareRun(input, now = this.now()) {
+        const validated = validateRunInput(input);
+        const client = sanitizeJson(validated.client, this.options).value;
+        const task = sanitizeTask(validated.task, this.options);
+        const metadata = sanitizeRunMetadata(validated.metadata ?? {}, this.options).value;
+        return { input: { ...validated, client }, task, metadata: (metadata && typeof metadata === 'object' && !Array.isArray(metadata) ? metadata : {}), now };
+    }
+    insertPreparedRun(prepared) {
+        const { input, task, metadata, now } = prepared;
+        if (this.database.prepare('SELECT run_id FROM ledger_runs WHERE run_id = ?').get(input.runId))
+            conflict('Ledger run already exists');
+        const taskHash = hashText(canonicalJson(task.value));
+        const taskTitle = task.value.title;
+        this.database.prepare(`
+      INSERT INTO ledger_runs (
+        run_id, workspace, client_kind, client_version, source_session_id, parent_run_id,
+        protocol_version, capture_profile, coverage_json, status, title, task_hash,
+        metadata_json, last_sequence, last_source_sequence, started_at, ended_at, created_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, 'intake', ?, ?, ?, 0, NULL, ?, NULL, ?, ?)
+    `).run(input.runId, input.workspace, input.client.kind, input.client.version ?? null, input.client.sessionId ?? null, input.parentRunId ?? null, input.protocolVersion, input.captureProfile, canonicalJson(input.coverage), taskTitle, taskHash, canonicalJson(metadata), input.startedAt ?? now, now, now);
+        const row = this.database.prepare('SELECT * FROM ledger_runs WHERE run_id = ?').get(input.runId);
+        if (!row)
+            notFound('Ledger run not found after creation');
+        return rowToRun(row);
+    }
+    appendPreparedBatchInTransaction(runId, events) {
+        const run = this.database.prepare('SELECT * FROM ledger_runs WHERE run_id = ?').get(runId);
+        if (!run)
+            notFound('Ledger run not found');
+        const existingRows = [];
+        for (const event of events) {
+            const sourceRow = event.input.sourceEventId
+                ? this.database.prepare('SELECT * FROM ledger_events WHERE run_id = ? AND source_event_id = ?').get(runId, event.input.sourceEventId)
+                : undefined;
+            const eventIdRow = this.database.prepare('SELECT * FROM ledger_events WHERE event_id = ?').get(event.eventId);
+            if (sourceRow && eventIdRow && sourceRow.event_id !== eventIdRow.event_id)
+                conflict('Event identities refer to different ledger events');
+            const existing = sourceRow ?? eventIdRow;
+            if (!existing)
+                continue;
+            if (existing.run_id !== runId)
+                conflict('Event ID is already owned by another ledger run');
+            if (event.input.eventId !== undefined && existing.event_id !== event.input.eventId)
+                conflict('Event ID conflicts with the stored source event');
+            if (event.fingerprint !== rowFingerprint(existing))
+                conflict('Source event conflicts with an existing ledger event');
+            existingRows.push(existing);
+        }
+        if (existingRows.length > 0) {
+            if (existingRows.length !== events.length || new Set(existingRows.map((row) => row.event_id)).size !== existingRows.length) {
+                conflict('Source event conflicts with an existing ledger event');
+            }
+            return this.ackFromRows(runId, existingRows);
+        }
+        if (TERMINAL_RUN_STATUSES.includes(run.status))
+            conflict('Cannot append events to a terminal ledger run');
+        let sequence = run.last_sequence;
+        let previousHash = sequence === 0 ? GENESIS_HASH : (this.database.prepare('SELECT event_hash FROM ledger_events WHERE run_id = ? AND sequence = ?').get(runId, sequence)?.event_hash ?? '');
+        if (sequence > 0 && !previousHash)
+            throw new KiokukoError('INTEGRITY_ERROR', 'Ledger sequence has no previous hash');
+        let lastSourceSequence = run.last_source_sequence;
+        const localSequences = [];
+        const sourceSequences = [];
+        const eventIds = [];
+        const ingestedAt = this.now();
+        for (const event of events) {
+            sequence += 1;
+            const sourceSequence = event.input.sourceSequence ?? null;
+            const payloadJson = canonicalJson(event.input.payload);
+            const redactionJson = canonicalJson(event.sanitized.redactions);
+            const eventHash = hashLedgerEvent({
+                runId,
+                sequence,
+                eventId: event.eventId,
+                previousHash,
+                eventType: event.input.eventType,
+                ...(event.input.sourceEventId === undefined ? {} : { sourceEventId: event.input.sourceEventId }),
+                ...(event.input.sourceSequence === undefined ? {} : { sourceSequence: event.input.sourceSequence }),
+                ...(event.input.sourceType === undefined ? {} : { sourceType: event.input.sourceType }),
+                actor: event.input.actor,
+                ...(event.input.outcome === undefined ? {} : { outcome: event.input.outcome }),
+                ...(event.input.occurredAt === undefined ? {} : { occurredAt: event.input.occurredAt }),
+                ingestedAt,
+                payload: event.input.payload,
+                redaction: event.sanitized.redactions,
+            });
+            this.database.prepare(`
+        INSERT INTO ledger_events (
+          event_id, run_id, sequence, source_event_id, source_sequence, event_type, source_type,
+          actor, outcome, occurred_at, ingested_at, payload_json, redaction_json, previous_hash, event_hash
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `).run(event.eventId, runId, sequence, event.input.sourceEventId ?? null, sourceSequence, event.input.eventType, event.input.sourceType ?? null, event.input.actor, event.input.outcome ?? null, event.input.occurredAt ?? null, ingestedAt, payloadJson, redactionJson, previousHash, eventHash);
+            previousHash = eventHash;
+            if (sourceSequence !== null)
+                lastSourceSequence = lastSourceSequence === null ? sourceSequence : Math.max(lastSourceSequence, sourceSequence);
+            localSequences.push(sequence);
+            sourceSequences.push(sourceSequence);
+            eventIds.push(event.eventId);
+        }
+        this.database.prepare('UPDATE ledger_runs SET last_sequence = ?, last_source_sequence = ?, updated_at = ? WHERE run_id = ?').run(sequence, lastSourceSequence, ingestedAt, runId);
+        return { runId, acceptedThrough: sequence, localSequences, sourceSequences, eventIds };
+    }
+    ackFromRows(runId, rows) {
+        const ordered = [...rows].sort((left, right) => left.sequence - right.sequence);
+        return {
+            runId,
+            acceptedThrough: ordered.at(-1)?.sequence ?? 0,
+            localSequences: ordered.map((row) => row.sequence),
+            sourceSequences: ordered.map((row) => row.source_sequence),
+            eventIds: ordered.map((row) => row.event_id),
+        };
+    }
+}
+function hashText(value) {
+    return createHash('sha256').update(value, 'utf8').digest('hex');
+}
+export function withLedgerTransaction(database, operation) {
+    return withImmediateTransaction(database, operation);
+}
+//# sourceMappingURL=store.js.map

package/dist/ledger/store.js.map

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

package/dist/ledger/types.d.ts

@@ -0,0 +1,119 @@
+export type JsonValue = null | boolean | number | string | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+export declare const MAX_BATCH_EVENTS = 200;
+export declare const MAX_EVENT_PAYLOAD_BYTES: number;
+export declare const MAX_PREVIEW_BYTES: number;
+export declare const MAX_ID_LENGTH = 256;
+export declare const MAX_TEXT_LENGTH: number;
+export declare const LEDGER_EVENT_TYPES: readonly ["intake.started", "intake.answered", "intake.ready", "intake.exhausted", "run.started", "run.closed", "request.received", "constraint.recorded", "decision.recorded", "step.started", "step.completed", "step.failed", "approval.requested", "approval.decided", "tool.requested", "tool.started", "tool.completed", "tool.failed", "tool.outcome_unknown", "command.started", "command.completed", "file.observed", "file.changed", "test.started", "test.completed", "verification.recorded", "error.recorded", "retry.recorded", "cancellation.recorded", "context.used", "context.feedback", "memory.proposed", "memory.promoted", "task_profile.revised", "correction.recorded", "source.event"];
+export type LedgerEventType = (typeof LEDGER_EVENT_TYPES)[number];
+export declare const CAPTURE_PROFILES: readonly ["minimal", "standard", "diagnostic"];
+export type CaptureProfile = (typeof CAPTURE_PROFILES)[number];
+export declare const COVERAGE_LEVELS: readonly ["complete", "best_effort", "declared", "unavailable"];
+export type CoverageLevel = (typeof COVERAGE_LEVELS)[number];
+export declare const RUN_STATUSES: readonly ["intake", "active", "completed", "failed", "cancelled", "interrupted"];
+export type RunStatus = (typeof RUN_STATUSES)[number];
+export declare const TERMINAL_RUN_STATUSES: readonly ["completed", "failed", "cancelled", "interrupted"];
+export type TerminalRunStatus = (typeof TERMINAL_RUN_STATUSES)[number];
+export declare const TASK_TYPES: readonly ["build", "debug", "research", "review", "devops", "writing", "analysis"];
+export type TaskType = (typeof TASK_TYPES)[number];
+export interface Coverage {
+    run: CoverageLevel;
+    tool: CoverageLevel;
+    command: CoverageLevel;
+    file: CoverageLevel;
+    approval: CoverageLevel;
+}
+export interface ClientInput {
+    kind: string;
+    version?: string;
+    sessionId?: string;
+}
+export interface ProfileHints {
+    taskType: TaskType | null;
+    target: string | null;
+    expected: string | null;
+    constraints: JsonValue | null;
+}
+export interface TaskInput {
+    title: string;
+    query: string;
+    profileHints: ProfileHints;
+}
+export interface AnswerInput {
+    apiVersion: '1';
+    questionId: string;
+    value: JsonValue;
+}
+export interface CreateRunInput {
+    runId: string;
+    workspace: string;
+    protocolVersion: '1';
+    client: ClientInput;
+    captureProfile: CaptureProfile;
+    coverage: Coverage;
+    task: TaskInput;
+    metadata?: JsonObject;
+    parentRunId?: string;
+    startedAt?: string;
+}
+export interface LedgerEventInput {
+    eventId?: string;
+    sourceEventId?: string;
+    sourceSequence?: number;
+    eventType: LedgerEventType;
+    sourceType?: string;
+    actor: string;
+    outcome?: string | null;
+    occurredAt?: string;
+    payload: JsonValue;
+}
+export interface AppendBatchInput {
+    events: LedgerEventInput[];
+}
+export interface Redaction {
+    path: string;
+    kind: 'sensitive_key' | 'secret_pattern' | 'url' | 'home_path' | 'preview_truncated' | 'environment_value' | 'hidden_reasoning';
+}
+export interface SanitizationOptions {
+    workspace?: string;
+    home?: string;
+}
+export interface Sanitized<T> {
+    value: T;
+    redactions: Redaction[];
+    truncated: string[];
+}
+export interface RunRecord {
+    runId: string;
+    workspace: string;
+    client: ClientInput;
+    protocolVersion: string;
+    captureProfile: CaptureProfile;
+    coverage: Coverage;
+    status: RunStatus;
+    title: string | null;
+    taskHash: string | null;
+    metadata: JsonObject;
+    lastSequence: number;
+    lastSourceSequence: number | null;
+    startedAt: string;
+    endedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AppendAck {
+    runId: string;
+    acceptedThrough: number;
+    localSequences: number[];
+    sourceSequences: Array<number | null>;
+    eventIds: string[];
+}
+export interface LedgerStoreOptions extends SanitizationOptions {
+    now?: () => string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/ledger/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ledger/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AACtG,MAAM,MAAM,UAAU,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAEtD,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,uBAAuB,QAAY,CAAC;AACjD,eAAO,MAAM,iBAAiB,QAAW,CAAC;AAC1C,eAAO,MAAM,aAAa,MAAM,CAAC;AACjC,eAAO,MAAM,eAAe,QAAY,CAAC;AAEzC,eAAO,MAAM,kBAAkB,irBAUrB,CAAC;AACX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,eAAO,MAAM,gBAAgB,gDAAiD,CAAC;AAC/E,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,eAAO,MAAM,eAAe,iEAAkE,CAAC;AAC/F,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D,eAAO,MAAM,YAAY,kFAAmF,CAAC;AAC7G,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AACtD,eAAO,MAAM,qBAAqB,8DAA+D,CAAC;AAClG,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE,eAAO,MAAM,UAAU,oFAAqF,CAAC;AAC7G,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,aAAa,CAAC;IACnB,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,aAAa,CAAC;IACvB,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,SAAS,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,GAAG,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,GAAG,CAAC;IACrB,MAAM,EAAE,WAAW,CAAC;IACpB,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,eAAe,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,eAAe,GAAG,gBAAgB,GAAG,KAAK,GAAG,WAAW,GAAG,mBAAmB,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;CACjI;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,KAAK,EAAE,CAAC,CAAC;IACT,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,cAAc,CAAC;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,UAAU,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB"}

package/dist/ledger/types.js

@@ -0,0 +1,22 @@
+export const MAX_BATCH_EVENTS = 200;
+export const MAX_EVENT_PAYLOAD_BYTES = 64 * 1024;
+export const MAX_PREVIEW_BYTES = 4 * 1024;
+export const MAX_ID_LENGTH = 256;
+export const MAX_TEXT_LENGTH = 16 * 1024;
+export const LEDGER_EVENT_TYPES = [
+    'intake.started', 'intake.answered', 'intake.ready', 'intake.exhausted',
+    'run.started', 'run.closed', 'request.received', 'constraint.recorded',
+    'decision.recorded', 'step.started', 'step.completed', 'step.failed',
+    'approval.requested', 'approval.decided', 'tool.requested', 'tool.started',
+    'tool.completed', 'tool.failed', 'tool.outcome_unknown', 'command.started',
+    'command.completed', 'file.observed', 'file.changed', 'test.started',
+    'test.completed', 'verification.recorded', 'error.recorded', 'retry.recorded',
+    'cancellation.recorded', 'context.used', 'context.feedback', 'memory.proposed',
+    'memory.promoted', 'task_profile.revised', 'correction.recorded', 'source.event',
+];
+export const CAPTURE_PROFILES = ['minimal', 'standard', 'diagnostic'];
+export const COVERAGE_LEVELS = ['complete', 'best_effort', 'declared', 'unavailable'];
+export const RUN_STATUSES = ['intake', 'active', 'completed', 'failed', 'cancelled', 'interrupted'];
+export const TERMINAL_RUN_STATUSES = ['completed', 'failed', 'cancelled', 'interrupted'];
+export const TASK_TYPES = ['build', 'debug', 'research', 'review', 'devops', 'writing', 'analysis'];
+//# sourceMappingURL=types.js.map

package/dist/ledger/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/ledger/types.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AACpC,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,GAAG,IAAI,CAAC;AACjD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,GAAG,IAAI,CAAC;AAC1C,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AACjC,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,GAAG,IAAI,CAAC;AAEzC,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,gBAAgB,EAAE,iBAAiB,EAAE,cAAc,EAAE,kBAAkB;IACvE,aAAa,EAAE,YAAY,EAAE,kBAAkB,EAAE,qBAAqB;IACtE,mBAAmB,EAAE,cAAc,EAAE,gBAAgB,EAAE,aAAa;IACpE,oBAAoB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,cAAc;IAC1E,gBAAgB,EAAE,aAAa,EAAE,sBAAsB,EAAE,iBAAiB;IAC1E,mBAAmB,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc;IACpE,gBAAgB,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,gBAAgB;IAC7E,uBAAuB,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB;IAC9E,iBAAiB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,cAAc;CACxE,CAAC;AAGX,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,SAAS,EAAE,UAAU,EAAE,YAAY,CAAU,CAAC;AAG/E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,CAAU,CAAC;AAG/F,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,CAAU,CAAC;AAE7G,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,CAAU,CAAC;AAGlG,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAU,CAAC"}

package/dist/ledger/validate.d.ts

@@ -0,0 +1,10 @@
+import { type AnswerInput, type CreateRunInput, type LedgerEventInput, type ProfileHints, type RunStatus, type TaskInput } from './types.js';
+export declare function validateTimestamp(value: unknown, label?: string): string;
+export declare function validateProfileHints(value: unknown): ProfileHints;
+export declare function validateTaskInput(value: unknown): TaskInput;
+export declare function validateAnswerInput(value: unknown): AnswerInput;
+export declare function validateEventInput(value: unknown): LedgerEventInput;
+export declare function validateEventBatch(value: unknown): LedgerEventInput[];
+export declare function validateRunInput(value: unknown): CreateRunInput;
+export declare function validateRunStatus(value: unknown): RunStatus;
+//# sourceMappingURL=validate.d.ts.map

package/dist/ledger/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/ledger/validate.ts"],"names":[],"mappings":"AAEA,OAAO,EASL,KAAK,WAAW,EAGhB,KAAK,cAAc,EAInB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,YAAY,CAAC;AA8DpB,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAc,GAAG,MAAM,CAK7E;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAQjE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAQ3D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAQ/D;AAqBD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAkBnE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,EAAE,CAarE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAqB/D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAE3D"}