kairo-mcp 1.3.0

package/dist/storage/quarantine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quarantine.js","sourceRoot":"","sources":["../../src/storage/quarantine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AA6B5C,MAAM,OAAO,kBAAkB;IACZ,IAAI,CAAS;IACtB,OAAO,GAAG,KAAK,CAAC;IACxB,YAAY,aAAqB;QAC/B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;IACD,KAAK,CAAC,KAAK,CAAC,MAAyB;QACnC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QACjD,MAAM,UAAU,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC9D,MAAM,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM,UAAU,IAAI,EAAE,CAAC,CAAC;IAClG,CAAC;CACF;AAED,wEAAwE;AACxE,MAAM,OAAO,kBAAkB;IAC7B,KAAK,CAAC,KAAK,CAAC,OAA0B;QACpC,wBAAwB;IAC1B,CAAC;CACF"}

package/dist/storage/redactingAdapter.d.ts

@@ -0,0 +1,13 @@
+import type { StorageAdapter } from './storageAdapter.js';
+import type { Clock } from '../utils/time.js';
+/**
+ * Decorator that enforces the redaction boundary (docs/ARCHITECTURE.md §2.3).
+ *
+ * Every write path that can carry agent-supplied content — events, snapshots,
+ * checkpoints, continuation briefs — is sanitized here *before* delegation, and a
+ * non-leaking audit record is appended when secrets are removed. Engines wire this
+ * around the real adapter and can never reach the backend directly, so there is no
+ * code path that persists un-redacted data.
+ */
+export declare function withRedaction(inner: StorageAdapter, clock: Clock): StorageAdapter;
+//# sourceMappingURL=redactingAdapter.d.ts.map

package/dist/storage/redactingAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redactingAdapter.d.ts","sourceRoot":"","sources":["../../src/storage/redactingAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAM1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAG9C;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,GAAG,cAAc,CA8FjF"}

package/dist/storage/redactingAdapter.js

@@ -0,0 +1,91 @@
+import { sanitize } from '../security/redactor.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Decorator that enforces the redaction boundary (docs/ARCHITECTURE.md §2.3).
+ *
+ * Every write path that can carry agent-supplied content — events, snapshots,
+ * checkpoints, continuation briefs — is sanitized here *before* delegation, and a
+ * non-leaking audit record is appended when secrets are removed. Engines wire this
+ * around the real adapter and can never reach the backend directly, so there is no
+ * code path that persists un-redacted data.
+ */
+export function withRedaction(inner, clock) {
+    const auditFindings = async (where, findings) => {
+        if (Object.keys(findings).length === 0)
+            return;
+        const total = Object.values(findings).reduce((a, b) => a + b, 0);
+        logger.warn(`Redacted ${total} secret(s) before persisting ${where}`, findings);
+        await inner.audit({
+            ts: clock.iso(),
+            kind: 'redaction',
+            message: `Redacted secrets before persisting ${where}`,
+            details: findings,
+        });
+    };
+    return {
+        init: () => inner.init(),
+        async appendEvent(event) {
+            const { value, findings } = sanitize(event);
+            await inner.appendEvent(value);
+            await auditFindings(`event:${event.type}`, findings);
+        },
+        readEvents: () => inner.readEvents(),
+        async saveSessionSnapshot(state) {
+            const { value, findings } = sanitize(state);
+            await inner.saveSessionSnapshot(value);
+            await auditFindings('session-snapshot', findings);
+        },
+        loadSessionSnapshot: (id) => inner.loadSessionSnapshot(id),
+        async saveCheckpoint(checkpoint) {
+            const { value, findings } = sanitize(checkpoint);
+            await inner.saveCheckpoint(value);
+            await auditFindings('checkpoint', findings);
+        },
+        loadCheckpoint: (id) => inner.loadCheckpoint(id),
+        loadLatestCheckpoint: () => inner.loadLatestCheckpoint(),
+        async saveContinuation(name, markdown) {
+            const { value, findings } = sanitize(markdown);
+            const stored = await inner.saveContinuation(name, value);
+            await auditFindings('continuation', findings);
+            return stored;
+        },
+        loadContinuation: (name) => inner.loadContinuation(name),
+        loadLatestContinuation: () => inner.loadLatestContinuation(),
+        async saveIntelligence(intel) {
+            const { value, findings } = sanitize(intel);
+            await inner.saveIntelligence(value);
+            await auditFindings('repo-intelligence', findings);
+        },
+        loadLatestIntelligence: () => inner.loadLatestIntelligence(),
+        loadIntelligenceByFingerprint: (fp) => inner.loadIntelligenceByFingerprint(fp),
+        async saveGraph(kind, markdown) {
+            const { value, findings } = sanitize(markdown);
+            await inner.saveGraph(kind, value);
+            await auditFindings('graph', findings);
+        },
+        async saveVectorIndex(index) {
+            // Sanitise chunk text before it is embedded into the persisted index.
+            const { value, findings } = sanitize(index);
+            await inner.saveVectorIndex(value);
+            await auditFindings('vector-index', findings);
+        },
+        loadVectorIndex: () => inner.loadVectorIndex(),
+        // Audit entries are constructed internally and never carry secret values.
+        audit: (entry) => inner.audit(entry),
+        readAudit: () => inner.readAudit(),
+        async appendTelemetry(event) {
+            // Telemetry fields are structured non-secret scalars by construction; we still
+            // sanitise as defence in depth so it can never become a leak side-channel.
+            const { value, findings } = sanitize(event);
+            await inner.appendTelemetry(value);
+            await auditFindings('telemetry', findings);
+        },
+        readTelemetry: () => inner.readTelemetry(),
+        async saveReport(name, markdown) {
+            const { value, findings } = sanitize(markdown);
+            await inner.saveReport(name, value);
+            await auditFindings(`report:${name}`, findings);
+        },
+    };
+}
+//# sourceMappingURL=redactingAdapter.js.map

package/dist/storage/redactingAdapter.js.map

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

package/dist/storage/storageAdapter.d.ts

@@ -0,0 +1,46 @@
+import type { AuditEntry, KairoEvent } from '../types/events.js';
+import type { Checkpoint, SessionState } from '../types/domain.js';
+import type { RepoIntelligence } from '../core/repo/types.js';
+import type { VectorIndex } from '../core/vector/types.js';
+import type { TelemetryEvent } from '../core/telemetry/types.js';
+/**
+ * Persistence seam. Engines depend only on this interface, never on the filesystem.
+ * Backends (file, SQLite, vector store) are interchangeable, and the redaction
+ * decorator (see redactingAdapter.ts) wraps any adapter so sanitization cannot be
+ * bypassed.
+ */
+export interface StorageAdapter {
+    init(): Promise<void>;
+    /** Append a single event. Must be atomic at the record level. */
+    appendEvent(event: KairoEvent): Promise<void>;
+    /** Read the full event log in chronological order. */
+    readEvents(): Promise<KairoEvent[]>;
+    saveSessionSnapshot(state: SessionState): Promise<void>;
+    loadSessionSnapshot(id: string): Promise<SessionState | undefined>;
+    saveCheckpoint(checkpoint: Checkpoint): Promise<void>;
+    loadCheckpoint(id: string): Promise<Checkpoint | undefined>;
+    loadLatestCheckpoint(): Promise<Checkpoint | undefined>;
+    /** Persist a continuation brief. Returns the stored filename. */
+    saveContinuation(name: string, markdown: string): Promise<string>;
+    loadContinuation(name: string): Promise<string | undefined>;
+    loadLatestContinuation(): Promise<string | undefined>;
+    /** Persist a repo-intelligence artifact, keyed by fingerprint, and update `latest`. */
+    saveIntelligence(intel: RepoIntelligence): Promise<void>;
+    loadLatestIntelligence(): Promise<RepoIntelligence | undefined>;
+    loadIntelligenceByFingerprint(fingerprint: string): Promise<RepoIntelligence | undefined>;
+    /** Persist a rendered graph markdown mirror under `.kairo/graphs/<kind>.md`. */
+    saveGraph(kind: string, markdown: string): Promise<void>;
+    /** Persist / load the semantic memory index (fingerprint-keyed). */
+    saveVectorIndex(index: VectorIndex): Promise<void>;
+    loadVectorIndex(): Promise<VectorIndex | undefined>;
+    /** Append an audit record. Never contains secret values. */
+    audit(entry: AuditEntry): Promise<void>;
+    /** Read the audit log (analytics reads redaction/lifecycle counts from here). */
+    readAudit(): Promise<AuditEntry[]>;
+    /** Append a telemetry event (separate local log; opt-in export only). */
+    appendTelemetry(event: TelemetryEvent): Promise<void>;
+    readTelemetry(): Promise<TelemetryEvent[]>;
+    /** Persist a generated analytics/team/risk report under `.kairo/reports/`. */
+    saveReport(name: string, markdown: string): Promise<void>;
+}
+//# sourceMappingURL=storageAdapter.d.ts.map

package/dist/storage/storageAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storageAdapter.d.ts","sourceRoot":"","sources":["../../src/storage/storageAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB,iEAAiE;IACjE,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,sDAAsD;IACtD,UAAU,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAEpC,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;IAEnE,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAC5D,oBAAoB,IAAI,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IAExD,iEAAiE;IACjE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC5D,sBAAsB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAEtD,uFAAuF;IACvF,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,sBAAsB,IAAI,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;IAChE,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC;IAE1F,gFAAgF;IAChF,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzD,oEAAoE;IACpE,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,eAAe,IAAI,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;IAEpD,4DAA4D;IAC5D,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,iFAAiF;IACjF,SAAS,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAEnC,yEAAyE;IACzE,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,aAAa,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAE3C,8EAA8E;IAC9E,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3D"}

package/dist/storage/storageAdapter.js

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

package/dist/storage/storageAdapter.js.map

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

package/dist/types/domain.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Core domain model for Kairo's session-continuity engine.
+ *
+ * `SessionState` is a *derived projection* of the event log, not an independently
+ * mutated record. A `Checkpoint` is a durable, sanitized, resumable freeze of that
+ * projection plus the next-agent continuation brief.
+ */
+export type AgentKind = string;
+export type ChangeKind = 'created' | 'modified' | 'deleted' | 'renamed';
+export type RiskLevel = 'low' | 'medium' | 'high';
+export interface ChangedFile {
+    path: string;
+    changeKind: ChangeKind;
+    risk: RiskLevel;
+    /** Number of distinct times the agent reported changing this file. */
+    touches: number;
+    lastTs: string;
+    note?: string;
+}
+export interface Decision {
+    ts: string;
+    summary: string;
+    rationale?: string;
+}
+export interface CommandRecord {
+    ts: string;
+    command: string;
+    exitCode?: number;
+    note?: string;
+}
+export interface ErrorRecord {
+    ts: string;
+    message: string;
+    resolved: boolean;
+    context?: string;
+}
+export type DirectiveLevel = 'CONTINUE' | 'CHECKPOINT_SOON' | 'CHECKPOINT_NOW';
+export interface PressureSignals {
+    /** Tool calls handled by Kairo this session (volume proxy). */
+    toolCalls: number;
+    changedFiles: number;
+    cumulativeDiffBytes: number;
+    retries: number;
+    unresolvedErrors: number;
+    /** Re-reads of files already read — a strong proxy for context loss. */
+    repeatedRereads: number;
+    /** Times the agent reported its context was compacted/summarized. */
+    compactions: number;
+    /** Times the agent had to re-ask the user to re-explain (loss proxy). */
+    clarificationLoops: number;
+    elapsedMs: number;
+}
+export interface PressureSnapshot {
+    /** Risk of context loss, bounded [0,1]. */
+    score: number;
+    directive: DirectiveLevel;
+    signals: PressureSignals;
+    /** Human-readable explanations of the dominant contributing signals. */
+    reasons: string[];
+}
+export type SessionStatus = 'active' | 'checkpointed' | 'ended';
+export interface SessionState {
+    /** Schema version (ADR-0012). Optional for back-compat with pre-v0.9.1 records. */
+    schema?: number;
+    id: string;
+    agent: AgentKind;
+    task: string;
+    projectRoot: string;
+    startedAt: string;
+    lastActivityAt: string;
+    status: SessionStatus;
+    changedFiles: Record<string, ChangedFile>;
+    decisions: Decision[];
+    commands: CommandRecord[];
+    errors: ErrorRecord[];
+    completedWork: string[];
+    pendingWork: string[];
+    blockers: string[];
+    retries: number;
+    heartbeats: number;
+    toolCalls: number;
+    compactions: number;
+    clarificationLoops: number;
+    cumulativeDiffBytes: number;
+    /** path → number of times re-read. */
+    rereadCounts: Record<string, number>;
+    lastCheckpointId?: string;
+}
+export type CheckpointReason = 'manual' | 'pressure' | 'session-end';
+export interface Checkpoint {
+    /** Schema version (ADR-0012). Optional for back-compat with pre-v0.9.1 records. */
+    schema?: number;
+    id: string;
+    sessionId: string;
+    agent: AgentKind;
+    createdAt: string;
+    reason: CheckpointReason;
+    task: string;
+    projectRoot: string;
+    completedWork: string[];
+    remainingWork: string[];
+    blockers: string[];
+    changedFiles: ChangedFile[];
+    decisions: Decision[];
+    unresolvedErrors: ErrorRecord[];
+    pressure: PressureSnapshot;
+    /** Aggregate engineering risk of the session at checkpoint time. */
+    risk: RiskAssessment;
+    /** Filename of the generated continuation brief markdown. */
+    continuationRef: string;
+    /** Coordination (v0.7.0): owning worker + prior checkpoint, forming the DAG. */
+    ownerWorkerId?: string;
+    parentCheckpointId?: string;
+}
+export interface RiskFactor {
+    /** Stable tag, e.g. "auth-path", "deletion", "secret-adjacent". */
+    code: string;
+    level: RiskLevel;
+    detail: string;
+}
+export interface RiskAssessment {
+    level: RiskLevel;
+    /** Bounded [0,1] aggregate engineering risk of the operation/session. */
+    score: number;
+    factors: RiskFactor[];
+}
+/**
+ * Output of combining engineering risk with context-loss pressure. Kairo cannot
+ * truly block an agent (cooperative model) — `HOLD` is a strongly-worded advisory.
+ */
+export type GuardDecision = 'ALLOW' | 'CAUTION' | 'HOLD';
+export interface Guidance {
+    decision: GuardDecision;
+    risk: RiskAssessment;
+    pressure: PressureSnapshot;
+    directive: string;
+    reasons: string[];
+}
+//# sourceMappingURL=domain.d.ts.map

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

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

package/dist/types/domain.js

@@ -0,0 +1,9 @@
+/**
+ * Core domain model for Kairo's session-continuity engine.
+ *
+ * `SessionState` is a *derived projection* of the event log, not an independently
+ * mutated record. A `Checkpoint` is a durable, sanitized, resumable freeze of that
+ * projection plus the next-agent continuation brief.
+ */
+export {};
+//# sourceMappingURL=domain.js.map

package/dist/types/domain.js.map

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

package/dist/types/events.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Event model. The append-only event log is Kairo's source of truth; every other
+ * persisted artifact (session snapshot, checkpoint, continuation) is a projection of
+ * these events. See docs/adr/0001-event-sourced-storage.md.
+ */
+export declare const EVENT_SCHEMA_VERSION: 1;
+export type EventType = 'session.started' | 'session.resumed' | 'file.changed' | 'decision.recorded' | 'command.run' | 'error.recorded' | 'error.resolved' | 'retry.recorded' | 'note.recorded' | 'compaction.observed' | 'clarification.recorded' | 'work.completed' | 'work.pending' | 'blocker.recorded' | 'heartbeat' | 'checkpoint.created' | 'session.ended' | 'worker.registered' | 'lease.acquired' | 'lease.renewed' | 'lease.released';
+export interface KairoEvent<TPayload = unknown> {
+    readonly schema: typeof EVENT_SCHEMA_VERSION;
+    /** Monotonic, lexicographically sortable id. */
+    readonly id: string;
+    /** ISO-8601 timestamp. */
+    readonly ts: string;
+    readonly sessionId: string;
+    readonly type: EventType;
+    readonly payload: TPayload;
+}
+/** A redaction/lifecycle audit record. Never contains secret values. */
+export interface AuditEntry {
+    /** Schema version (ADR-0012). Optional for back-compat with pre-v0.9.1 records. */
+    readonly schema?: number;
+    readonly ts: string;
+    readonly kind: 'redaction' | 'lifecycle';
+    readonly message: string;
+    /** For redaction: secret type → count. Values are never recorded. */
+    readonly details?: Record<string, number>;
+}
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,oBAAoB,EAAG,CAAU,CAAC;AAE/C,MAAM,MAAM,SAAS,GACjB,iBAAiB,GACjB,iBAAiB,GACjB,cAAc,GACd,mBAAmB,GACnB,aAAa,GACb,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,GAChB,eAAe,GACf,qBAAqB,GACrB,wBAAwB,GACxB,gBAAgB,GAChB,cAAc,GACd,kBAAkB,GAClB,WAAW,GACX,oBAAoB,GACpB,eAAe,GACf,mBAAmB,GACnB,gBAAgB,GAChB,eAAe,GACf,gBAAgB,CAAC;AAErB,MAAM,WAAW,UAAU,CAAC,QAAQ,GAAG,OAAO;IAC5C,QAAQ,CAAC,MAAM,EAAE,OAAO,oBAAoB,CAAC;IAC7C,gDAAgD;IAChD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;CAC5B;AAED,wEAAwE;AACxE,MAAM,WAAW,UAAU;IACzB,mFAAmF;IACnF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C"}

package/dist/types/events.js

@@ -0,0 +1,7 @@
+/**
+ * Event model. The append-only event log is Kairo's source of truth; every other
+ * persisted artifact (session snapshot, checkpoint, continuation) is a projection of
+ * these events. See docs/adr/0001-event-sourced-storage.md.
+ */
+export const EVENT_SCHEMA_VERSION = 1;
+//# sourceMappingURL=events.js.map

package/dist/types/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAU,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,6 @@
+/** Domain error whose message is safe to surface to the agent. */
+export declare class KairoError extends Error {
+    readonly hint?: string | undefined;
+    constructor(message: string, hint?: string | undefined);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,qBAAa,UAAW,SAAQ,KAAK;IAGjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM;gBADtB,OAAO,EAAE,MAAM,EACN,IAAI,CAAC,EAAE,MAAM,YAAA;CAKzB"}

package/dist/utils/errors.js

@@ -0,0 +1,10 @@
+/** Domain error whose message is safe to surface to the agent. */
+export class KairoError extends Error {
+    hint;
+    constructor(message, hint) {
+        super(message);
+        this.hint = hint;
+        this.name = 'KairoError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,OAAO,UAAW,SAAQ,KAAK;IAGxB;IAFX,YACE,OAAe,EACN,IAAa;QAEtB,KAAK,CAAC,OAAO,CAAC,CAAC;QAFN,SAAI,GAAJ,IAAI,CAAS;QAGtB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF"}

package/dist/utils/ids.d.ts

@@ -0,0 +1,7 @@
+/**
+ * A monotonic, lexicographically sortable id (ULID-style): 48-bit millisecond
+ * timestamp + 80 bits of randomness. Sorting ids sorts by creation time, which the
+ * event log relies on for ordering without a separate sequence column.
+ */
+export declare function newId(now?: number): string;
+//# sourceMappingURL=ids.d.ts.map

package/dist/utils/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/utils/ids.ts"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,GAAE,MAAmB,GAAG,MAAM,CAatD"}

package/dist/utils/ids.js

@@ -0,0 +1,22 @@
+import { randomBytes } from 'node:crypto';
+const ENCODING = '0123456789ABCDEFGHJKMNPQRSTVWXYZ'; // Crockford base32
+/**
+ * A monotonic, lexicographically sortable id (ULID-style): 48-bit millisecond
+ * timestamp + 80 bits of randomness. Sorting ids sorts by creation time, which the
+ * event log relies on for ordering without a separate sequence column.
+ */
+export function newId(now = Date.now()) {
+    let ts = now;
+    const time = [];
+    for (let i = 9; i >= 0; i--) {
+        time[i] = ENCODING[ts % 32];
+        ts = Math.floor(ts / 32);
+    }
+    const rnd = randomBytes(16);
+    let rand = '';
+    for (let i = 0; i < 16; i++) {
+        rand += ENCODING[rnd[i] % 32];
+    }
+    return time.join('') + rand;
+}
+//# sourceMappingURL=ids.js.map

package/dist/utils/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/utils/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,QAAQ,GAAG,kCAAkC,CAAC,CAAC,mBAAmB;AAExE;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,MAAc,IAAI,CAAC,GAAG,EAAE;IAC5C,IAAI,EAAE,GAAG,GAAG,CAAC;IACb,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAW,CAAC;QACtC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IAC3B,CAAC;IACD,MAAM,GAAG,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC;IAC5B,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,IAAI,IAAI,QAAQ,CAAE,GAAG,CAAC,CAAC,CAAY,GAAG,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;AAC9B,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,7 @@
+export declare const logger: {
+    debug: (m: string, meta?: unknown) => void;
+    info: (m: string, meta?: unknown) => void;
+    warn: (m: string, meta?: unknown) => void;
+    error: (m: string, meta?: unknown) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AA2BA,eAAO,MAAM,MAAM;eACN,MAAM,SAAS,OAAO;cACvB,MAAM,SAAS,OAAO;cACtB,MAAM,SAAS,OAAO;eACrB,MAAM,SAAS,OAAO;CAClC,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,26 @@
+const order = { debug: 10, info: 20, warn: 30, error: 40 };
+function threshold() {
+    const env = process.env.KAIRO_LOG_LEVEL?.toLowerCase();
+    return order[env ?? 'info'] ?? order.info;
+}
+function emit(level, message, meta) {
+    if (order[level] < threshold())
+        return;
+    const line = `[kairo] ${new Date().toISOString()} ${level.toUpperCase()} ${message}`;
+    console.error(meta === undefined ? line : `${line} ${safe(meta)}`);
+}
+function safe(meta) {
+    try {
+        return JSON.stringify(meta);
+    }
+    catch {
+        return '[unserializable meta]';
+    }
+}
+export const logger = {
+    debug: (m, meta) => emit('debug', m, meta),
+    info: (m, meta) => emit('info', m, meta),
+    warn: (m, meta) => emit('warn', m, meta),
+    error: (m, meta) => emit('error', m, meta),
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAMA,MAAM,KAAK,GAA0B,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAElF,SAAS,SAAS;IAChB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,WAAW,EAAuB,CAAC;IAC5E,OAAO,KAAK,CAAC,GAAG,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC;AAC5C,CAAC;AAED,SAAS,IAAI,CAAC,KAAY,EAAE,OAAe,EAAE,IAAc;IACzD,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,SAAS,EAAE;QAAE,OAAO;IACvC,MAAM,IAAI,GAAG,WAAW,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,OAAO,EAAE,CAAC;IACrF,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,IAAI,CAAC,IAAa;IACzB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,uBAAuB,CAAC;IACjC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,CAAC,CAAS,EAAE,IAAc,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC;IAC5D,IAAI,EAAE,CAAC,CAAS,EAAE,IAAc,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,CAAC;IAC1D,IAAI,EAAE,CAAC,CAAS,EAAE,IAAc,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,CAAC;IAC1D,KAAK,EAAE,CAAC,CAAS,EAAE,IAAc,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC;CAC7D,CAAC"}

package/dist/utils/time.d.ts

@@ -0,0 +1,8 @@
+/** Single clock seam so tests can pin time deterministically. */
+export interface Clock {
+    now(): number;
+    iso(): string;
+}
+export declare const systemClock: Clock;
+export declare function fixedClock(epochMs: number): Clock;
+//# sourceMappingURL=time.d.ts.map

package/dist/utils/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,WAAW,KAAK;IACpB,GAAG,IAAI,MAAM,CAAC;IACd,GAAG,IAAI,MAAM,CAAC;CACf;AAED,eAAO,MAAM,WAAW,EAAE,KAGzB,CAAC;AAEF,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAKjD"}

package/dist/utils/time.js

@@ -0,0 +1,11 @@
+export const systemClock = {
+    now: () => Date.now(),
+    iso: () => new Date().toISOString(),
+};
+export function fixedClock(epochMs) {
+    return {
+        now: () => epochMs,
+        iso: () => new Date(epochMs).toISOString(),
+    };
+}
+//# sourceMappingURL=time.js.map

package/dist/utils/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,WAAW,GAAU;IAChC,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;IACrB,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;CACpC,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,OAAO;QACL,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO;QAClB,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE;KAC3C,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "kairo-mcp",
+  "version": "1.3.0",
+  "description": "Kairo — a persistent engineering memory and session-continuity control layer for AI coding agents, exposed over the Model Context Protocol.",
+  "license": "MIT",
+  "author": "Kairo maintainers",
+  "homepage": "https://github.com/sandy001-kki/Kairo#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sandy001-kki/Kairo.git"
+  },
+  "bugs": {
+    "url": "https://github.com/sandy001-kki/Kairo/issues"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "kairo": "dist/cli/cli.js",
+    "kairo-mcp": "dist/index.js",
+    "kairo-inspect": "dist/inspect/cli.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai-agents",
+    "ai-coding",
+    "agent-memory",
+    "claude",
+    "claude-code",
+    "cursor",
+    "session-continuity",
+    "checkpoint",
+    "local-first",
+    "deterministic",
+    "developer-tools",
+    "cli",
+    "typescript"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "start": "node dist/index.js",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.9.0",
+    "@types/node": "^20.14.0",
+    "eslint": "^9.9.0",
+    "typescript-eslint": "^8.0.0",
+    "prettier": "^3.3.3",
+    "typescript": "^5.5.4",
+    "vitest": "^2.0.5"
+  }
+}