kairo-mcp 1.3.0

package/dist/contracts/zodSchemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zodSchemas.d.ts","sourceRoot":"","sources":["../../src/contracts/zodSchemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;gCAST,CAAC;AAEjB,eAAO,MAAM,SAAS;;;;;;;;;;;;gCAMN,CAAC;AAEjB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;gCAOT,CAAC;AAEjB,eAAO,MAAM,WAAW;;;;;;;;;;;;gCAMR,CAAC;AAEjB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAMZ,CAAC;AAEjB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;gCAOd,CAAC;AAEjB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;gCASR,CAAC;AAEjB,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAWZ,CAAC;AAEjB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;gCAQR,CAAC;AAEjB,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCA0BV,CAAC;AAEjB,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAsBR,CAAC"}

package/dist/contracts/zodSchemas.js

@@ -0,0 +1,139 @@
+import { z } from 'zod';
+/**
+ * Permissive-on-read, strict-on-required zod schemas (ADR-0012). Validation
+ * runs at the storage-adapter seam. Extra fields are passthroughs so a
+ * client reading a record written by a later patch version doesn't crash on
+ * unknown additions — forward compat by construction.
+ */
+const isoString = z.string().min(1);
+const riskLevel = z.enum(['low', 'medium', 'high']);
+const changeKind = z.enum(['created', 'modified', 'deleted', 'renamed']);
+export const ChangedFileZ = z
+    .object({
+    path: z.string().min(1),
+    changeKind,
+    risk: riskLevel,
+    touches: z.number().int().nonnegative(),
+    lastTs: z.string(),
+    note: z.string().optional(),
+})
+    .passthrough();
+export const DecisionZ = z
+    .object({
+    ts: z.string(),
+    summary: z.string(),
+    rationale: z.string().optional(),
+})
+    .passthrough();
+export const ErrorRecordZ = z
+    .object({
+    ts: z.string(),
+    message: z.string(),
+    resolved: z.boolean(),
+    context: z.string().optional(),
+})
+    .passthrough();
+export const RiskFactorZ = z
+    .object({
+    code: z.string(),
+    level: riskLevel,
+    detail: z.string(),
+})
+    .passthrough();
+export const RiskAssessmentZ = z
+    .object({
+    level: riskLevel,
+    score: z.number(),
+    factors: z.array(RiskFactorZ),
+})
+    .passthrough();
+export const PressureSnapshotZ = z
+    .object({
+    score: z.number(),
+    directive: z.string(),
+    signals: z.record(z.string(), z.unknown()),
+    reasons: z.array(z.string()),
+})
+    .passthrough();
+export const KairoEventZ = z
+    .object({
+    schema: z.number().int().optional(),
+    id: z.string().min(1),
+    ts: isoString,
+    sessionId: z.string(),
+    type: z.string().min(1),
+    payload: z.unknown(),
+})
+    .passthrough();
+export const TelemetryEventZ = z
+    .object({
+    schema: z.number().int().optional(),
+    id: z.string().min(1),
+    ts: isoString,
+    sessionId: z.string(),
+    worker: z.string().optional(),
+    namespace: z.string().optional(),
+    kind: z.string().min(1),
+    data: z.record(z.string(), z.unknown()),
+})
+    .passthrough();
+export const AuditEntryZ = z
+    .object({
+    schema: z.number().int().optional(),
+    ts: isoString,
+    kind: z.enum(['redaction', 'lifecycle']),
+    message: z.string(),
+    details: z.record(z.string(), z.number()).optional(),
+})
+    .passthrough();
+export const SessionStateZ = z
+    .object({
+    schema: z.number().int().optional(),
+    id: z.string().min(1),
+    agent: z.string(),
+    task: z.string(),
+    projectRoot: z.string(),
+    startedAt: isoString,
+    lastActivityAt: isoString,
+    status: z.enum(['active', 'checkpointed', 'ended']),
+    changedFiles: z.record(z.string(), ChangedFileZ),
+    decisions: z.array(DecisionZ),
+    commands: z.array(z.record(z.string(), z.unknown())),
+    errors: z.array(ErrorRecordZ),
+    completedWork: z.array(z.string()),
+    pendingWork: z.array(z.string()),
+    blockers: z.array(z.string()),
+    retries: z.number(),
+    heartbeats: z.number(),
+    toolCalls: z.number(),
+    compactions: z.number(),
+    clarificationLoops: z.number(),
+    cumulativeDiffBytes: z.number(),
+    rereadCounts: z.record(z.string(), z.number()),
+    lastCheckpointId: z.string().optional(),
+})
+    .passthrough();
+export const CheckpointZ = z
+    .object({
+    schema: z.number().int().optional(),
+    id: z.string().min(1),
+    sessionId: z.string(),
+    agent: z.string(),
+    createdAt: isoString,
+    reason: z.enum(['manual', 'pressure', 'session-end']),
+    task: z.string(),
+    projectRoot: z.string(),
+    completedWork: z.array(z.string()),
+    remainingWork: z.array(z.string()),
+    blockers: z.array(z.string()),
+    changedFiles: z.array(ChangedFileZ),
+    decisions: z.array(DecisionZ),
+    unresolvedErrors: z.array(ErrorRecordZ),
+    pressure: PressureSnapshotZ,
+    risk: RiskAssessmentZ,
+    continuationRef: z.string(),
+    ownerWorkerId: z.string().optional(),
+    parentCheckpointId: z.string().optional(),
+})
+    .passthrough();
+//# sourceMappingURL=zodSchemas.js.map

package/dist/contracts/zodSchemas.js.map

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

package/dist/core/brief/budget.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Brief modes & token budgets (v0.8.2, ADR-0010). Budgets are character counts —
+ * a deterministic, tokeniser-agnostic local proxy for tokens. Honest: exact token
+ * cost depends on the model's tokeniser; chars are a tight upper bound for ASCII
+ * code/identifiers and a reasonable signal everywhere else.
+ */
+export type BriefMode = 'tiny' | 'normal' | 'deep';
+export interface BriefBudget {
+    mode: BriefMode;
+    maxBriefChars: number;
+    maxRecallItems: number;
+    maxChunkChars: number;
+    maxWarnings: number;
+    /** Inline Mermaid into briefs. Default false — graphs live in `.kairo/graphs/`. */
+    includeGraphs: boolean;
+}
+export declare const DEFAULT_BUDGETS: Record<BriefMode, BriefBudget>;
+export declare function resolveBudget(mode?: BriefMode, overrides?: Partial<BriefBudget>): BriefBudget;
+/** Trim text to a max length, suffixing an ellipsis when truncated. */
+export declare function clip(text: string, max: number): string;
+//# sourceMappingURL=budget.d.ts.map

package/dist/core/brief/budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../../src/core/brief/budget.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,SAAS,EAAE,WAAW,CAyB1D,CAAC;AAEF,wBAAgB,aAAa,CAC3B,IAAI,GAAE,SAAoB,EAC1B,SAAS,GAAE,OAAO,CAAC,WAAW,CAAM,GACnC,WAAW,CAEb;AAED,uEAAuE;AACvE,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGtD"}

package/dist/core/brief/budget.js

@@ -0,0 +1,42 @@
+/**
+ * Brief modes & token budgets (v0.8.2, ADR-0010). Budgets are character counts —
+ * a deterministic, tokeniser-agnostic local proxy for tokens. Honest: exact token
+ * cost depends on the model's tokeniser; chars are a tight upper bound for ASCII
+ * code/identifiers and a reasonable signal everywhere else.
+ */
+export const DEFAULT_BUDGETS = {
+    tiny: {
+        mode: 'tiny',
+        maxBriefChars: 1500,
+        maxRecallItems: 0,
+        maxChunkChars: 0,
+        maxWarnings: 3,
+        includeGraphs: false,
+    },
+    normal: {
+        mode: 'normal',
+        maxBriefChars: 4000,
+        maxRecallItems: 3,
+        maxChunkChars: 200,
+        maxWarnings: 5,
+        includeGraphs: false,
+    },
+    deep: {
+        mode: 'deep',
+        maxBriefChars: 20_000,
+        maxRecallItems: 8,
+        maxChunkChars: 600,
+        maxWarnings: 20,
+        includeGraphs: false,
+    },
+};
+export function resolveBudget(mode = 'normal', overrides = {}) {
+    return { ...DEFAULT_BUDGETS[mode], ...overrides };
+}
+/** Trim text to a max length, suffixing an ellipsis when truncated. */
+export function clip(text, max) {
+    if (max <= 0 || text.length <= max)
+        return text;
+    return `${text.slice(0, Math.max(0, max - 1))}…`;
+}
+//# sourceMappingURL=budget.js.map

package/dist/core/brief/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../../src/core/brief/budget.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,MAAM,CAAC,MAAM,eAAe,GAAmC;IAC7D,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,aAAa,EAAE,IAAI;QACnB,cAAc,EAAE,CAAC;QACjB,aAAa,EAAE,CAAC;QAChB,WAAW,EAAE,CAAC;QACd,aAAa,EAAE,KAAK;KACrB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,aAAa,EAAE,IAAI;QACnB,cAAc,EAAE,CAAC;QACjB,aAAa,EAAE,GAAG;QAClB,WAAW,EAAE,CAAC;QACd,aAAa,EAAE,KAAK;KACrB;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,aAAa,EAAE,MAAM;QACrB,cAAc,EAAE,CAAC;QACjB,aAAa,EAAE,GAAG;QAClB,WAAW,EAAE,EAAE;QACf,aAAa,EAAE,KAAK;KACrB;CACF,CAAC;AAEF,MAAM,UAAU,aAAa,CAC3B,OAAkB,QAAQ,EAC1B,YAAkC,EAAE;IAEpC,OAAO,EAAE,GAAG,eAAe,CAAC,IAAI,CAAC,EAAE,GAAG,SAAS,EAAE,CAAC;AACpD,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,IAAI,CAAC,IAAY,EAAE,GAAW;IAC5C,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC;IAChD,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AACnD,CAAC"}

package/dist/core/checkpoint/checkpointManager.d.ts

@@ -0,0 +1,29 @@
+import type { StorageAdapter } from '../../storage/storageAdapter.js';
+import type { Checkpoint, CheckpointReason, PressureSnapshot, SessionState } from '../../types/domain.js';
+import type { Clock } from '../../utils/time.js';
+export interface CheckpointInput {
+    reason: CheckpointReason;
+    completed?: string[];
+    remaining?: string[];
+    blockers?: string[];
+    /** Coordination (v0.7.0): owning worker + prior checkpoint for the DAG. */
+    ownerWorkerId?: string;
+    parentCheckpointId?: string;
+}
+export interface CheckpointOutput {
+    checkpoint: Checkpoint;
+    continuationName: string;
+    continuationMarkdown: string;
+}
+/**
+ * Builds a durable, resumable checkpoint from the current session projection and the
+ * computed pressure, then renders + persists the continuation brief. The checkpoint
+ * and brief pass through the redaction boundary at the adapter seam on write.
+ */
+export declare class CheckpointManager {
+    private readonly adapter;
+    private readonly clock;
+    constructor(adapter: StorageAdapter, clock: Clock);
+    create(state: SessionState, pressure: PressureSnapshot, input: CheckpointInput): Promise<CheckpointOutput>;
+}
+//# sourceMappingURL=checkpointManager.d.ts.map

package/dist/core/checkpoint/checkpointManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpointManager.d.ts","sourceRoot":"","sources":["../../../src/core/checkpoint/checkpointManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAKjD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,2EAA2E;IAC3E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,UAAU,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,KAAK;IAGzB,MAAM,CACV,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,gBAAgB,CAAC;CAqC7B"}

package/dist/core/checkpoint/checkpointManager.js

@@ -0,0 +1,49 @@
+import { newId } from '../../utils/ids.js';
+import { buildContinuationMarkdown, deriveRemaining } from '../continuation/continuationBuilder.js';
+import { assessSession } from '../risk/riskEngine.js';
+/**
+ * Builds a durable, resumable checkpoint from the current session projection and the
+ * computed pressure, then renders + persists the continuation brief. The checkpoint
+ * and brief pass through the redaction boundary at the adapter seam on write.
+ */
+export class CheckpointManager {
+    adapter;
+    clock;
+    constructor(adapter, clock) {
+        this.adapter = adapter;
+        this.clock = clock;
+    }
+    async create(state, pressure, input) {
+        const id = newId(this.clock.now());
+        const continuationName = `${id}.md`;
+        const completedWork = [...new Set([...(input.completed ?? []), ...state.completedWork])];
+        const remainingWork = deriveRemaining(state, input.remaining);
+        const blockers = [...new Set([...(input.blockers ?? []), ...state.blockers])];
+        const checkpoint = {
+            id,
+            sessionId: state.id,
+            agent: state.agent,
+            createdAt: this.clock.iso(),
+            reason: input.reason,
+            task: state.task,
+            projectRoot: state.projectRoot,
+            completedWork,
+            remainingWork,
+            blockers,
+            changedFiles: Object.values(state.changedFiles),
+            decisions: state.decisions,
+            unresolvedErrors: state.errors.filter((e) => !e.resolved),
+            pressure,
+            risk: assessSession(state),
+            continuationRef: continuationName,
+            ...(input.ownerWorkerId ? { ownerWorkerId: input.ownerWorkerId } : {}),
+            ...(input.parentCheckpointId ? { parentCheckpointId: input.parentCheckpointId } : {}),
+        };
+        const continuationMarkdown = buildContinuationMarkdown(checkpoint);
+        // Persist the brief first: a checkpoint must never reference a missing brief.
+        await this.adapter.saveContinuation(continuationName, continuationMarkdown);
+        await this.adapter.saveCheckpoint(checkpoint);
+        return { checkpoint, continuationName, continuationMarkdown };
+    }
+}
+//# sourceMappingURL=checkpointManager.js.map

package/dist/core/checkpoint/checkpointManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpointManager.js","sourceRoot":"","sources":["../../../src/core/checkpoint/checkpointManager.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACpG,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAkBtD;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IAET;IACA;IAFnB,YACmB,OAAuB,EACvB,KAAY;QADZ,YAAO,GAAP,OAAO,CAAgB;QACvB,UAAK,GAAL,KAAK,CAAO;IAC5B,CAAC;IAEJ,KAAK,CAAC,MAAM,CACV,KAAmB,EACnB,QAA0B,EAC1B,KAAsB;QAEtB,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;QACnC,MAAM,gBAAgB,GAAG,GAAG,EAAE,KAAK,CAAC;QAEpC,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QACzF,MAAM,aAAa,GAAG,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAE9E,MAAM,UAAU,GAAe;YAC7B,EAAE;YACF,SAAS,EAAE,KAAK,CAAC,EAAE;YACnB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE;YAC3B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,aAAa;YACb,aAAa;YACb,QAAQ;YACR,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC;YAC/C,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;YACzD,QAAQ;YACR,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC;YAC1B,eAAe,EAAE,gBAAgB;YACjC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,GAAG,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,KAAK,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtF,CAAC;QAEF,MAAM,oBAAoB,GAAG,yBAAyB,CAAC,UAAU,CAAC,CAAC;QAEnE,8EAA8E;QAC9E,MAAM,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,oBAAoB,CAAC,CAAC;QAC5E,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QAE9C,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,CAAC;IAChE,CAAC;CACF"}

package/dist/core/compaction/compactor.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Memory compaction (v0.9.3, ADR-0014). Conservative on purpose: prefers
+ * false negatives ("did not archive an event that could safely have been
+ * archived") over false positives ("archived something replay needs").
+ *
+ * Compaction NEVER deletes. Archived events go to `.kairo/archive/`; the
+ * manifest at `.kairo/archive/MANIFEST.md` records what was moved, when,
+ * and why.
+ */
+export interface CompactionOptions {
+    /** Sessions ended longer ago than this become candidates (default 90). */
+    olderThanDays?: number;
+    /** Dry-run only writes the report. Default true. */
+    dryRun?: boolean;
+    /** Clock injection for deterministic tests. */
+    now?: () => Date;
+}
+export interface CompactionPlan {
+    candidateEvents: number;
+    retainedEvents: number;
+    candidateSessionIds: string[];
+    reasons: CompactionReason[];
+    archivePath: string;
+    manifestPath: string;
+    reportPath: string;
+}
+export interface CompactionReason {
+    sessionId: string;
+    events: number;
+    status: 'archived' | 'retained';
+    detail: string;
+}
+export interface CompactionResult {
+    plan: CompactionPlan;
+    applied: boolean;
+    /** Markdown report (also written to disk). */
+    markdown: string;
+}
+export declare function compact(projectRoot: string, opts?: CompactionOptions): Promise<CompactionResult>;
+//# sourceMappingURL=compactor.d.ts.map

package/dist/core/compaction/compactor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compactor.d.ts","sourceRoot":"","sources":["../../../src/core/compaction/compactor.ts"],"names":[],"mappings":"AAOA;;;;;;;;GAQG;AAEH,MAAM,WAAW,iBAAiB;IAChC,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,GAAG,UAAU,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,OAAO,CAC3B,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,CA+G3B"}

package/dist/core/compaction/compactor.js

@@ -0,0 +1,168 @@
+import { mkdir, readFile, rename, writeFile, readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { kairoPaths } from '../../storage/paths.js';
+import { FileStorageAdapter } from '../../storage/fileStorageAdapter.js';
+import { logger } from '../../utils/logger.js';
+export async function compact(projectRoot, opts = {}) {
+    const paths = kairoPaths(projectRoot);
+    const adapter = new FileStorageAdapter(projectRoot);
+    await adapter.init();
+    const olderThanDays = opts.olderThanDays ?? 90;
+    const dryRun = opts.dryRun ?? true;
+    const now = (opts.now ?? (() => new Date()))();
+    const cutoffMs = now.getTime() - olderThanDays * 86_400_000;
+    // ── Load ──────────────────────────────────────────────────────────────
+    const events = await adapter.readEvents();
+    const checkpoints = await loadAllCheckpoints(adapter, paths.checkpointsDir);
+    // Build the set of sessions whose ended-at is older than the cutoff.
+    const sessionStatus = new Map();
+    for (const e of events) {
+        const s = sessionStatus.get(e.sessionId) ?? { lastTs: e.ts, ended: false, events: 0 };
+        s.lastTs = s.lastTs < e.ts ? e.ts : s.lastTs;
+        s.events += 1;
+        if (e.type === 'session.ended')
+            s.ended = true;
+        sessionStatus.set(e.sessionId, s);
+    }
+    // Walk lineage from every checkpoint; sessions referenced by surviving
+    // checkpoints' chains must NOT be archived.
+    const protectedSessions = new Set();
+    for (const cp of checkpoints)
+        protectedSessions.add(cp.sessionId);
+    const candidates = new Set();
+    const reasons = [];
+    for (const [sid, st] of sessionStatus.entries()) {
+        const eligible = st.ended && Date.parse(st.lastTs) < cutoffMs;
+        if (!eligible) {
+            reasons.push({
+                sessionId: sid,
+                events: st.events,
+                status: 'retained',
+                detail: st.ended
+                    ? `ended at ${st.lastTs}, within ${olderThanDays}-day window`
+                    : 'session not ended',
+            });
+            continue;
+        }
+        if (protectedSessions.has(sid)) {
+            reasons.push({
+                sessionId: sid,
+                events: st.events,
+                status: 'retained',
+                detail: 'referenced by an existing checkpoint',
+            });
+            continue;
+        }
+        candidates.add(sid);
+        reasons.push({
+            sessionId: sid,
+            events: st.events,
+            status: 'archived',
+            detail: `ended at ${st.lastTs}, older than ${olderThanDays} days`,
+        });
+    }
+    const archived = events.filter((e) => candidates.has(e.sessionId));
+    const retained = events.filter((e) => !candidates.has(e.sessionId));
+    const ts = now.toISOString().replace(/[:.]/g, '-');
+    const archivePath = join(paths.base, 'archive', `events-${ts}.jsonl`);
+    const manifestPath = join(paths.base, 'archive', 'MANIFEST.md');
+    const reportPath = join(paths.reportsDir, 'COMPACTION.md');
+    const plan = {
+        candidateEvents: archived.length,
+        retainedEvents: retained.length,
+        candidateSessionIds: [...candidates].sort(),
+        reasons: reasons.sort((a, b) => a.sessionId.localeCompare(b.sessionId)),
+        archivePath,
+        manifestPath,
+        reportPath,
+    };
+    const markdown = renderReport(plan, { olderThanDays, dryRun, now: now.toISOString() });
+    await mkdir(paths.reportsDir, { recursive: true });
+    await writeFile(reportPath, markdown, 'utf8');
+    if (dryRun || archived.length === 0) {
+        return { plan, applied: false, markdown };
+    }
+    // ── Apply ────────────────────────────────────────────────────────────
+    await mkdir(join(paths.base, 'archive'), { recursive: true });
+    // Write archive first (atomically), then rewrite events.jsonl.
+    const archiveBody = archived.map((e) => JSON.stringify(e)).join('\n') + '\n';
+    const tmpArchive = `${archivePath}.${process.pid}.tmp`;
+    await writeFile(tmpArchive, archiveBody, 'utf8');
+    await rename(tmpArchive, archivePath);
+    const retainedBody = retained.map((e) => JSON.stringify(e)).join('\n') + (retained.length > 0 ? '\n' : '');
+    const tmpEvents = `${paths.events}.${process.pid}.tmp`;
+    await writeFile(tmpEvents, retainedBody, 'utf8');
+    await rename(tmpEvents, paths.events);
+    await appendManifest(manifestPath, plan, now);
+    logger.info('Compaction applied', {
+        archived: archived.length,
+        retained: retained.length,
+        archivePath,
+    });
+    return { plan, applied: true, markdown };
+}
+async function loadAllCheckpoints(adapter, dir) {
+    const out = [];
+    let files = [];
+    try {
+        files = (await readdir(dir)).filter((f) => f.endsWith('.json')).sort();
+    }
+    catch {
+        return out;
+    }
+    for (const f of files) {
+        const id = f.replace(/\.json$/, '');
+        const cp = await adapter.loadCheckpoint(id);
+        if (cp)
+            out.push(cp);
+    }
+    return out;
+}
+async function appendManifest(manifestPath, plan, now) {
+    await mkdir(dirOf(manifestPath), { recursive: true });
+    let existing = '';
+    try {
+        existing = await readFile(manifestPath, 'utf8');
+    }
+    catch {
+        /* first compaction */
+    }
+    const entry = `\n## ${now.toISOString()}\n\n` +
+        `- Archive: \`${plan.archivePath}\`\n` +
+        `- Archived events: ${plan.candidateEvents}\n` +
+        `- Retained events: ${plan.retainedEvents}\n` +
+        `- Sessions archived: ${plan.candidateSessionIds.length}\n`;
+    const header = existing
+        ? existing
+        : '# Kairo compaction archive manifest\n\n> Every line below records a compaction event. ' +
+            'Archived events are MOVED, never deleted.\n';
+    await writeFile(manifestPath, header + entry, 'utf8');
+}
+function dirOf(p) {
+    const idx = Math.max(p.lastIndexOf('/'), p.lastIndexOf('\\'));
+    return idx === -1 ? '.' : p.slice(0, idx);
+}
+function renderReport(plan, meta) {
+    const lines = [];
+    lines.push('# Kairo compaction report');
+    lines.push('');
+    lines.push(`- Mode: \`${meta.dryRun ? 'dry-run' : 'applied'}\``);
+    lines.push(`- olderThanDays: \`${meta.olderThanDays}\``);
+    lines.push(`- Generated: \`${meta.now}\``);
+    lines.push(`- Candidate events: **${plan.candidateEvents}**`);
+    lines.push(`- Retained events: **${plan.retainedEvents}**`);
+    lines.push(`- Candidate sessions: ${plan.candidateSessionIds.length}`);
+    lines.push('');
+    lines.push('## Per-session decisions');
+    lines.push('');
+    lines.push('| Session | Events | Decision | Reason |');
+    lines.push('|---|---:|---|---|');
+    for (const r of plan.reasons) {
+        lines.push(`| \`${r.sessionId}\` | ${r.events} | ${r.status} | ${r.detail} |`);
+    }
+    lines.push('');
+    lines.push('> Compaction NEVER deletes. Archived events are moved to ' +
+        `\`${plan.archivePath}\`; the manifest is at \`${plan.manifestPath}\`.`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=compactor.js.map

package/dist/core/compaction/compactor.js.map

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

package/dist/core/continuation/continuationBuilder.d.ts

@@ -0,0 +1,19 @@
+import type { Checkpoint, SessionState } from '../../types/domain.js';
+import { type BriefBudget } from '../brief/budget.js';
+/**
+ * Generates the next-agent continuation brief in one of three modes
+ * (v0.8.2, ADR-0010):
+ *   - `tiny`   — task / stop / next 3 / changed-file count + top 5 / critical warnings.
+ *   - `normal` — default; full structure but trimmed (top files/decisions, no graphs).
+ *   - `deep`   — full historical context (opt-in).
+ *
+ * Backward-compatible: with no opts it defaults to `normal`, which still includes
+ * every section the existing tests assert (the change is *size*, not *structure*).
+ */
+export interface BuildBriefOptions {
+    budget?: BriefBudget;
+}
+export declare function buildContinuationMarkdown(cp: Checkpoint, opts?: BuildBriefOptions): string;
+/** Derives the remaining-work list for a checkpoint from session state. */
+export declare function deriveRemaining(state: SessionState, explicit?: string[]): string[];
+//# sourceMappingURL=continuationBuilder.d.ts.map

package/dist/core/continuation/continuationBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuationBuilder.d.ts","sourceRoot":"","sources":["../../../src/core/continuation/continuationBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE3E;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,wBAAgB,yBAAyB,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,GAAE,iBAAsB,GAAG,MAAM,CAK9F;AAwLD,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAMlF"}