kairo-mcp 1.3.0

package/dist/perf/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/perf/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAsC,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAkBnD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,QAAwB,EACxB,WAAmB,EACnB,OAA4B,EAAE;IAE9B,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,IAAI,iBAAiB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACzE,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;IACnE,MAAM,OAAO,GAAe,EAAE,CAAC;IAC/B,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;QAAE,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IACxE,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACtD,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACnD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACtF,MAAM,MAAM,GAAoB;QAC9B,YAAY,EAAE,cAAc;QAC5B,WAAW;QACX,SAAS;QACT,OAAO;QACP,SAAS,EAAE,OAAO;KACnB,CAAC;IACF,MAAM,QAAQ,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,GAAG,KAAK,CAAC,UAAU,iBAAiB,CAAC;IAC3E,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,MAAM,SAAS,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC9C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC;AAC1C,CAAC;AAED,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,cAAc,YAAY,CAAC"}

package/dist/perf/report.d.ts

@@ -0,0 +1,8 @@
+import type { BenchmarkReport } from './types.js';
+/**
+ * Renders a benchmark report as deterministic markdown (ADR-0014). No
+ * timestamps inside the table body so two reports with the same numbers
+ * compare cleanly.
+ */
+export declare function renderPerformanceReport(report: BenchmarkReport): string;
+//# sourceMappingURL=report.d.ts.map

package/dist/perf/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/perf/report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAA2B,MAAM,YAAY,CAAC;AAE3E;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CA6BvE"}

package/dist/perf/report.js

@@ -0,0 +1,52 @@
+/**
+ * Renders a benchmark report as deterministic markdown (ADR-0014). No
+ * timestamps inside the table body so two reports with the same numbers
+ * compare cleanly.
+ */
+export function renderPerformanceReport(report) {
+    const lines = [];
+    lines.push('# Kairo performance report');
+    lines.push('');
+    lines.push(`- Kairo: \`${report.kairoVersion}\``);
+    lines.push(`- Project: \`${report.projectRoot}\``);
+    lines.push(`- Started: \`${report.startedAt}\``);
+    lines.push(`- Sum of medians: **${report.totalMs.toFixed(2)} ms**`);
+    lines.push('');
+    lines.push('> Wall-clock timings depend on the host; treat them as relative.');
+    lines.push('');
+    lines.push('## Scenarios');
+    lines.push('');
+    lines.push('| Scenario | n | min (ms) | median (ms) | p95 (ms) | max (ms) | Counters |');
+    lines.push('|---|---:|---:|---:|---:|---:|---|');
+    for (const s of report.scenarios) {
+        lines.push(renderRow(s));
+    }
+    lines.push('');
+    const skipped = report.scenarios.filter((s) => s.skipped);
+    if (skipped.length > 0) {
+        lines.push('## Skipped');
+        lines.push('');
+        for (const s of skipped) {
+            lines.push(`- \`${s.name}\` — ${s.skipReason ?? 'no reason recorded'}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+function renderRow(s) {
+    if (s.skipped) {
+        return `| \`${s.name}\` | – | – | – | – | – | _skipped_ |`;
+    }
+    const c = s.counters;
+    const counterText = Object.keys(c).length === 0
+        ? '—'
+        : Object.entries(c)
+            .map(([k, v]) => `${k}=${v}`)
+            .join(' ');
+    return (`| \`${s.name}\` | ${s.stats.iterations} | ${fmt(s.stats.min)} | ${fmt(s.stats.median)} | ` +
+        `${fmt(s.stats.p95)} | ${fmt(s.stats.max)} | ${counterText} |`);
+}
+function fmt(n) {
+    return n.toFixed(2);
+}
+//# sourceMappingURL=report.js.map

package/dist/perf/report.js.map

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

package/dist/perf/runner.d.ts

@@ -0,0 +1,29 @@
+import type { BenchmarkScenarioResult } from './types.js';
+/**
+ * Pure benchmark runner (ADR-0014). Uses `process.hrtime.bigint()` for
+ * monotonic nanosecond timing — robust against system-clock changes during
+ * a run.
+ */
+export interface ScenarioFn {
+    (): Promise<{
+        counters?: Record<string, number>;
+    } | void>;
+}
+export interface ScenarioSpec {
+    name: string;
+    /** Optional precondition; if it returns a reason, the scenario is skipped. */
+    skipIf?: () => string | undefined | Promise<string | undefined>;
+    /** Optional one-shot setup (NOT timed). */
+    setup?: () => Promise<void>;
+    /** Optional one-shot teardown (NOT timed). */
+    teardown?: () => Promise<void>;
+    /** The hot path — this is what's timed. */
+    run: ScenarioFn;
+}
+export interface RunOptions {
+    iterations?: number;
+    /** Optional subset of scenarios to run (by name). */
+    only?: string[];
+}
+export declare function runScenarios(specs: ScenarioSpec[], opts?: RunOptions): Promise<BenchmarkScenarioResult[]>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/perf/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/perf/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAkB,MAAM,YAAY,CAAC;AAE1E;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,OAAO,CAAC;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;CAC3D;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAChE,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,2CAA2C;IAC3C,GAAG,EAAE,UAAU,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAID,wBAAsB,YAAY,CAChC,KAAK,EAAE,YAAY,EAAE,EACrB,IAAI,GAAE,UAAe,GACpB,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAqCpC"}

package/dist/perf/runner.js

@@ -0,0 +1,74 @@
+const NS_PER_MS = 1000000n;
+export async function runScenarios(specs, opts = {}) {
+    const iterations = Math.max(1, opts.iterations ?? 5);
+    const only = opts.only && opts.only.length > 0 ? new Set(opts.only) : undefined;
+    const out = [];
+    for (const spec of specs) {
+        if (only && !only.has(spec.name))
+            continue;
+        const skipReason = spec.skipIf ? await spec.skipIf() : undefined;
+        if (skipReason !== undefined) {
+            out.push({
+                name: spec.name,
+                stats: zeroStats(iterations),
+                counters: {},
+                skipped: true,
+                skipReason,
+            });
+            continue;
+        }
+        if (spec.setup)
+            await spec.setup();
+        const durations = [];
+        let counters = {};
+        for (let i = 0; i < iterations; i++) {
+            const t0 = process.hrtime.bigint();
+            const res = await spec.run();
+            const t1 = process.hrtime.bigint();
+            durations.push(Number((t1 - t0) / NS_PER_MS));
+            if (res && res.counters)
+                counters = mergeCounters(counters, res.counters);
+        }
+        if (spec.teardown)
+            await spec.teardown();
+        out.push({
+            name: spec.name,
+            stats: summarise(durations),
+            counters,
+            skipped: false,
+        });
+    }
+    return out;
+}
+function summarise(values) {
+    const sorted = [...values].sort((a, b) => a - b);
+    const n = sorted.length;
+    const sum = sorted.reduce((acc, v) => acc + v, 0);
+    return {
+        iterations: n,
+        min: sorted[0] ?? 0,
+        median: percentile(sorted, 0.5),
+        p95: percentile(sorted, 0.95),
+        max: sorted[n - 1] ?? 0,
+        totalMs: sum,
+    };
+}
+function percentile(sorted, p) {
+    if (sorted.length === 0)
+        return 0;
+    const idx = Math.min(sorted.length - 1, Math.max(0, Math.floor(sorted.length * p)));
+    return sorted[idx] ?? 0;
+}
+function mergeCounters(a, b) {
+    const out = { ...a };
+    for (const [k, v] of Object.entries(b)) {
+        // Counters across iterations: take the LAST observed value (these
+        // describe steady-state, not per-iteration deltas).
+        out[k] = v;
+    }
+    return out;
+}
+function zeroStats(iterations) {
+    return { iterations, min: 0, median: 0, p95: 0, max: 0, totalMs: 0 };
+}
+//# sourceMappingURL=runner.js.map

package/dist/perf/runner.js.map

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

package/dist/perf/scenarios.d.ts

@@ -0,0 +1,8 @@
+import type { SessionManager } from '../core/session/sessionManager.js';
+import type { ScenarioSpec } from './runner.js';
+/**
+ * Standard benchmark scenarios (ADR-0014). Each one is small, focused, and
+ * deterministic: no Date.now()/Math.random() inside the timed path.
+ */
+export declare function standardScenarios(sessions: SessionManager, projectRoot: string): ScenarioSpec[];
+//# sourceMappingURL=scenarios.d.ts.map

package/dist/perf/scenarios.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenarios.d.ts","sourceRoot":"","sources":["../../src/perf/scenarios.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAIxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE,CA2G/F"}

package/dist/perf/scenarios.js

@@ -0,0 +1,119 @@
+import { unlink } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { kairoPaths } from '../storage/paths.js';
+import { InspectProjection } from '../inspect/projections.js';
+import { exportSnapshot } from '../snapshot/export.js';
+/**
+ * Standard benchmark scenarios (ADR-0014). Each one is small, focused, and
+ * deterministic: no Date.now()/Math.random() inside the timed path.
+ */
+export function standardScenarios(sessions, projectRoot) {
+    const paths = kairoPaths(projectRoot);
+    const projection = new InspectProjection(projectRoot);
+    return [
+        {
+            name: 'repo.cold-scan',
+            // First scan: force=true bypasses the cache. We always run this even
+            // when a cache exists — the timing is the cold path, deliberately.
+            run: async () => {
+                await sessions.scanRepo(projectRoot, true);
+                return { counters: {} };
+            },
+        },
+        {
+            name: 'repo.warm-scan',
+            // Cached read: should be orders of magnitude faster.
+            run: async () => {
+                const r = await sessions.scanRepo(projectRoot, false);
+                return { counters: { fromCache: r.fromCache ? 1 : 0 } };
+            },
+        },
+        {
+            name: 'graph.generate',
+            // The scan persists graphs; here we just exercise the InspectProjection
+            // graph reader (representative of how surfaces consume them).
+            run: async () => {
+                const list = await projection.listGraphs();
+                let nodes = 0;
+                for (const k of list) {
+                    const g = await projection.readGraph(k);
+                    if (g)
+                        nodes += g.nodes;
+                }
+                return { counters: { graphs: list.length, totalNodes: nodes } };
+            },
+        },
+        {
+            name: 'inspect.projection',
+            run: async () => {
+                const o = await projection.overview();
+                await projection.listSessions();
+                await projection.listCheckpoints();
+                return {
+                    counters: {
+                        events: o.eventCount,
+                        telemetry: o.telemetryCount,
+                        sessions: o.sessionCount,
+                        checkpoints: o.checkpointCount,
+                    },
+                };
+            },
+        },
+        {
+            name: 'brief.tiny',
+            skipIf: async () => {
+                const cp = await projection.latestCheckpoint();
+                return cp ? undefined : 'no checkpoint exists';
+            },
+            run: async () => {
+                const b = await sessions.buildBrief({ mode: 'tiny' });
+                return { counters: { chars: b?.chars ?? 0 } };
+            },
+        },
+        {
+            name: 'brief.normal',
+            skipIf: async () => {
+                const cp = await projection.latestCheckpoint();
+                return cp ? undefined : 'no checkpoint exists';
+            },
+            run: async () => {
+                const b = await sessions.buildBrief({ mode: 'normal' });
+                return { counters: { chars: b?.chars ?? 0 } };
+            },
+        },
+        {
+            name: 'brief.deep',
+            skipIf: async () => {
+                const cp = await projection.latestCheckpoint();
+                return cp ? undefined : 'no checkpoint exists';
+            },
+            run: async () => {
+                const b = await sessions.buildBrief({ mode: 'deep' });
+                return { counters: { chars: b?.chars ?? 0 } };
+            },
+        },
+        {
+            name: 'snapshot.export',
+            skipIf: () => (existsSync(paths.base) ? undefined : '.kairo/ does not exist'),
+            run: async () => {
+                const r = await exportSnapshot(projectRoot, {
+                    path: `${paths.base}/snapshots/bench-snapshot.json`,
+                    now: () => new Date('2026-05-21T00:00:00.000Z'),
+                });
+                return {
+                    counters: {
+                        bytes: r.bytes,
+                        events: r.snapshot.manifest.counts.events,
+                        checkpoints: r.snapshot.manifest.counts.checkpoints,
+                    },
+                };
+            },
+            teardown: async () => {
+                const benchSnap = `${paths.base}/snapshots/bench-snapshot.json`;
+                if (existsSync(benchSnap))
+                    await unlink(benchSnap).catch(() => undefined);
+            },
+        },
+    ];
+}
+//# sourceMappingURL=scenarios.js.map

package/dist/perf/scenarios.js.map

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

package/dist/perf/types.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Benchmark types (ADR-0014). Pure data — no Date.now()/Math.random()
+ * leaks into the structured results so callers can snapshot them safely.
+ */
+export interface BenchmarkStats {
+    iterations: number;
+    /** Milliseconds. */
+    min: number;
+    median: number;
+    p95: number;
+    max: number;
+    /** Sum of all iteration durations (ms). */
+    totalMs: number;
+}
+export interface BenchmarkScenarioResult {
+    name: string;
+    stats: BenchmarkStats;
+    /** Scenario-specific counters (chunks built, files scanned, …). */
+    counters: Record<string, number>;
+    /** True if the scenario was skipped because preconditions weren't met. */
+    skipped: boolean;
+    skipReason?: string;
+}
+export interface BenchmarkReport {
+    kairoVersion: string;
+    projectRoot: string;
+    startedAt: string;
+    /** Total seconds across all scenarios (sum of medians). */
+    totalMs: number;
+    scenarios: BenchmarkScenarioResult[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/perf/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,CAAC;IACtB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,0EAA0E;IAC1E,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,uBAAuB,EAAE,CAAC;CACtC"}

package/dist/perf/types.js

@@ -0,0 +1,6 @@
+/**
+ * Benchmark types (ADR-0014). Pure data — no Date.now()/Math.random()
+ * leaks into the structured results so callers can snapshot them safely.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/perf/types.js.map

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

package/dist/plugins/loader.d.ts

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+import type { LoadedPlugin } from './types.js';
+export declare const ManifestZ: z.ZodObject<{
+    apiVersion: z.ZodLiteral<"kairo.plugin/1">;
+    name: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodString;
+    capabilities: z.ZodArray<z.ZodEnum<["read-events", "read-checkpoints", "read-telemetry", "render-reports", "extend-inspect", "embedder-provider"]>, "many">;
+    kairoCompatibility: z.ZodString;
+    mcpServer: z.ZodOptional<z.ZodObject<{
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        command: string;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+    }, {
+        command: string;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+    }>>;
+    homepage: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    apiVersion: z.ZodLiteral<"kairo.plugin/1">;
+    name: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodString;
+    capabilities: z.ZodArray<z.ZodEnum<["read-events", "read-checkpoints", "read-telemetry", "render-reports", "extend-inspect", "embedder-provider"]>, "many">;
+    kairoCompatibility: z.ZodString;
+    mcpServer: z.ZodOptional<z.ZodObject<{
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        command: string;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+    }, {
+        command: string;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+    }>>;
+    homepage: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    apiVersion: z.ZodLiteral<"kairo.plugin/1">;
+    name: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodString;
+    capabilities: z.ZodArray<z.ZodEnum<["read-events", "read-checkpoints", "read-telemetry", "render-reports", "extend-inspect", "embedder-provider"]>, "many">;
+    kairoCompatibility: z.ZodString;
+    mcpServer: z.ZodOptional<z.ZodObject<{
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        command: string;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+    }, {
+        command: string;
+        args?: string[] | undefined;
+        env?: Record<string, string> | undefined;
+    }>>;
+    homepage: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+}, z.ZodTypeAny, "passthrough">>;
+export declare function loadPlugins(projectRoot?: string): Promise<LoadedPlugin[]>;
+/**
+ * Tiny semver-range matcher — supports the forms we actually need for
+ * plugin metadata: `1.2.3`, `^1.2`, `^0.9`, `>=0.9 <1`, `*`, and disjunctions
+ * via `||`. Not a full semver implementation; the registry it serves is
+ * a hint, not a security boundary.
+ */
+export declare function checkCompatibility(range: string, version: string): boolean;
+//# sourceMappingURL=loader.d.ts.map

package/dist/plugins/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/plugins/loader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAuB,YAAY,EAAE,MAAM,YAAY,CAAC;AAmBpE,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAkBN,CAAC;AAEjB,wBAAsB,WAAW,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAkC/E;AAuDD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAS1E"}

package/dist/plugins/loader.js

@@ -0,0 +1,193 @@
+import { readFile, readdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { z } from 'zod';
+import { kairoPaths } from '../storage/paths.js';
+import { SERVER_VERSION } from '../server/createServer.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Plugin manifest loader (v0.9.4, ADR-0015). Reads
+ * `.kairo/plugins/*.json` (or a single `.kairo/plugins.json` array),
+ * validates with zod, performs a semver-range compatibility check, and
+ * returns the manifests. NOTHING IS EVER EXECUTED IN-PROCESS.
+ */
+const CapabilityZ = z.enum([
+    'read-events',
+    'read-checkpoints',
+    'read-telemetry',
+    'render-reports',
+    'extend-inspect',
+    'embedder-provider',
+]);
+export const ManifestZ = z
+    .object({
+    apiVersion: z.literal('kairo.plugin/1'),
+    name: z.string().min(1),
+    version: z.string().min(1),
+    description: z.string(),
+    capabilities: z.array(CapabilityZ),
+    kairoCompatibility: z.string().min(1),
+    mcpServer: z
+        .object({
+        command: z.string().min(1),
+        args: z.array(z.string()).optional(),
+        env: z.record(z.string(), z.string()).optional(),
+    })
+        .optional(),
+    homepage: z.string().optional(),
+    author: z.string().optional(),
+})
+    .passthrough();
+export async function loadPlugins(projectRoot) {
+    const paths = kairoPaths(projectRoot);
+    const dir = join(paths.base, 'plugins');
+    const indexFile = join(paths.base, 'plugins.json');
+    const out = [];
+    // (a) Multi-file form: `.kairo/plugins/*.json`
+    if (existsSync(dir)) {
+        let files = [];
+        try {
+            files = (await readdir(dir)).filter((f) => f.endsWith('.json')).sort();
+        }
+        catch {
+            /* unreadable dir → skip */
+        }
+        for (const f of files) {
+            const p = join(dir, f);
+            out.push(await loadManifestFile(p));
+        }
+    }
+    // (b) Single-file array form: `.kairo/plugins.json`
+    if (existsSync(indexFile)) {
+        try {
+            const raw = JSON.parse(await readFile(indexFile, 'utf8'));
+            const arr = Array.isArray(raw) ? raw : [raw];
+            for (let i = 0; i < arr.length; i++) {
+                out.push(parseManifest(arr[i], `${indexFile}#${i}`));
+            }
+        }
+        catch (e) {
+            logger.warn(`Could not read ${indexFile}: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    return out;
+}
+async function loadManifestFile(path) {
+    try {
+        const raw = JSON.parse(await readFile(path, 'utf8'));
+        return parseManifest(raw, path);
+    }
+    catch (e) {
+        return {
+            manifest: brokenManifest(path),
+            manifestPath: path,
+            compatible: false,
+            warning: `Failed to parse: ${e instanceof Error ? e.message : String(e)}`,
+        };
+    }
+}
+function parseManifest(raw, source) {
+    const result = ManifestZ.safeParse(raw);
+    if (!result.success) {
+        return {
+            manifest: brokenManifest(source),
+            manifestPath: source,
+            compatible: false,
+            warning: 'Schema validation failed: ' +
+                result.error.issues
+                    .slice(0, 3)
+                    .map((iss) => `${iss.path.join('.')}: ${iss.message}`)
+                    .join('; '),
+        };
+    }
+    const manifest = result.data;
+    const compatible = checkCompatibility(manifest.kairoCompatibility, SERVER_VERSION);
+    const entry = {
+        manifest,
+        manifestPath: source,
+        compatible,
+    };
+    if (!compatible) {
+        entry.warning = `Plugin targets ${manifest.kairoCompatibility}; running ${SERVER_VERSION}`;
+    }
+    return entry;
+}
+function brokenManifest(source) {
+    return {
+        apiVersion: 'kairo.plugin/1',
+        name: `broken:${source}`,
+        version: '0.0.0',
+        description: '(invalid manifest)',
+        capabilities: [],
+        kairoCompatibility: '*',
+    };
+}
+/**
+ * Tiny semver-range matcher — supports the forms we actually need for
+ * plugin metadata: `1.2.3`, `^1.2`, `^0.9`, `>=0.9 <1`, `*`, and disjunctions
+ * via `||`. Not a full semver implementation; the registry it serves is
+ * a hint, not a security boundary.
+ */
+export function checkCompatibility(range, version) {
+    const parts = range
+        .split('||')
+        .map((s) => s.trim())
+        .filter(Boolean);
+    for (const part of parts) {
+        if (matchOne(part, version))
+            return true;
+    }
+    return false;
+}
+function matchOne(range, version) {
+    range = range.trim();
+    if (range === '*')
+        return true;
+    if (range.startsWith('^')) {
+        const target = parseSemver(range.slice(1).trim());
+        const v = parseSemver(version);
+        if (!target || !v)
+            return false;
+        // ^0.x.y means "compatible with 0.x" — minor pinned.
+        if (target.major === 0)
+            return v.major === 0 && v.minor === target.minor && cmp(v, target) >= 0;
+        return v.major === target.major && cmp(v, target) >= 0;
+    }
+    if (range.startsWith('>=')) {
+        const target = parseSemver(range.slice(2).trim());
+        const v = parseSemver(version);
+        return target && v ? cmp(v, target) >= 0 : false;
+    }
+    // Conjunction with a space → all must match.
+    if (range.includes(' ')) {
+        return range
+            .split(/\s+/)
+            .filter(Boolean)
+            .every((sub) => matchOne(sub, version));
+    }
+    if (range.startsWith('<')) {
+        const target = parseSemver(range.slice(1).trim());
+        const v = parseSemver(version);
+        return target && v ? cmp(v, target) < 0 : false;
+    }
+    // Exact match.
+    return range === version;
+}
+function parseSemver(s) {
+    const m = /^(\d+)(?:\.(\d+))?(?:\.(\d+))?/.exec(s);
+    if (!m)
+        return undefined;
+    return {
+        major: Number(m[1]),
+        minor: m[2] !== undefined ? Number(m[2]) : 0,
+        patch: m[3] !== undefined ? Number(m[3]) : 0,
+    };
+}
+function cmp(a, b) {
+    if (a.major !== b.major)
+        return a.major - b.major;
+    if (a.minor !== b.minor)
+        return a.minor - b.minor;
+    return a.patch - b.patch;
+}
+//# sourceMappingURL=loader.js.map