@songsid/agend 2.1.11-beta.1 → 2.1.11-beta.3

package/dist/backend/kiro-engine-ledger.d.ts

@@ -0,0 +1,36 @@
+export type KiroUi = "legacy" | "tui" | "v3";
+export interface KiroLaunchRecord {
+    at: string;
+    kiroVersion: string | null;
+    agendVersion: string;
+    ui: KiroUi;
+    flags: string[];
+}
+export interface KiroLedgerEntry {
+    workingDirectory: string;
+    /** The credential profile the instance launched under; null for the shared store. */
+    credentialProfile: string | null;
+    firstSeen: string;
+    lastLaunch: KiroLaunchRecord;
+    /** One row per change of kiro version, AgEnD version, UI or engine flags; newest last. */
+    history: KiroLaunchRecord[];
+}
+export type KiroLedger = Record<string, KiroLedgerEntry>;
+export declare function kiroLedgerPath(agendHome?: string): string;
+export declare function agendVersion(): string;
+export declare function readKiroLedger(path?: string): KiroLedger;
+/** Write via a temp file and rename; the temp file is removed whatever happens. Throws on failure. */
+export declare function writeFileAtomic(path: string, data: string): void;
+/** Read, change one entry, write back atomically. Returns false when the ledger could not be written. */
+export declare function updateKiroLedger(instance: string, change: (entry: KiroLedgerEntry | undefined) => KiroLedgerEntry | undefined, path?: string): boolean;
+export interface KiroLaunchFacts {
+    instance: string;
+    workingDirectory: string;
+    credentialProfile: string | null;
+    kiroVersion: string | null;
+    ui: KiroUi;
+    /** The UI/engine flags AgEnD pinned for this launch. */
+    flags: string[];
+    now?: Date;
+}
+export declare function recordKiroLaunch(facts: KiroLaunchFacts, path?: string): boolean;

package/dist/backend/kiro-engine-ledger.js

@@ -0,0 +1,113 @@
+/**
+ * Which kiro engine, kiro-cli version and AgEnD version each kiro instance
+ * has been launched with — the baseline the V1 → V3 migration works from.
+ *
+ * Kept in `<AGEND_HOME>/kiro-engine-ledger.json`, not the instance directory:
+ * `replace_instance` deletes that directory, and the migration needs to know
+ * what an instance ran on before it was replaced.
+ *
+ * It is a record, not a source of truth: writing it is best-effort, and a
+ * launch never fails because it could not be read or written. Which V3
+ * session an instance owns is NOT kept here (see kiro-v3-identity.ts), since
+ * that has to be durable and exclusive and this does not.
+ */
+import { createRequire } from "node:module";
+import { readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { randomBytes } from "node:crypto";
+import { getAgendHome } from "../paths.js";
+const HISTORY_LIMIT = 20;
+export function kiroLedgerPath(agendHome = getAgendHome()) {
+    return join(agendHome, "kiro-engine-ledger.json");
+}
+let agendVersionCache;
+export function agendVersion() {
+    if (agendVersionCache === undefined) {
+        try {
+            agendVersionCache = String(createRequire(import.meta.url)("../../package.json").version ?? "unknown");
+        }
+        catch {
+            agendVersionCache = "unknown";
+        }
+    }
+    return agendVersionCache;
+}
+const isObject = (v) => !!v && typeof v === "object" && !Array.isArray(v);
+const UIS = ["legacy", "tui", "v3"];
+function isLaunchRecord(v) {
+    return isObject(v) && typeof v.at === "string"
+        && (v.kiroVersion === null || typeof v.kiroVersion === "string")
+        && typeof v.agendVersion === "string" && UIS.includes(v.ui)
+        && Array.isArray(v.flags) && v.flags.every(f => typeof f === "string");
+}
+/** An entry the code can read without guessing, down to every launch record; anything else is dropped. */
+function isLedgerEntry(v) {
+    return isObject(v) && typeof v.workingDirectory === "string" && typeof v.firstSeen === "string"
+        && (v.credentialProfile === null || typeof v.credentialProfile === "string")
+        && isLaunchRecord(v.lastLaunch) && Array.isArray(v.history) && v.history.every(isLaunchRecord);
+}
+export function readKiroLedger(path = kiroLedgerPath()) {
+    try {
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        if (isObject(parsed))
+            return Object.fromEntries(Object.entries(parsed).filter(([, e]) => isLedgerEntry(e)));
+    }
+    catch { /* missing or damaged: start over */ }
+    return {};
+}
+/** Write via a temp file and rename; the temp file is removed whatever happens. Throws on failure. */
+export function writeFileAtomic(path, data) {
+    const tmp = `${path}.${process.pid}.${randomBytes(4).toString("hex")}.tmp`;
+    try {
+        writeFileSync(tmp, data, { mode: 0o600, flag: "wx" });
+        renameSync(tmp, path);
+    }
+    finally {
+        rmSync(tmp, { force: true });
+    }
+}
+function writeKiroLedger(ledger, path) {
+    writeFileAtomic(path, JSON.stringify(ledger, null, 2) + "\n");
+}
+/** Read, change one entry, write back atomically. Returns false when the ledger could not be written. */
+export function updateKiroLedger(instance, change, path = kiroLedgerPath()) {
+    try {
+        const ledger = readKiroLedger(path);
+        const next = change(ledger[instance]);
+        if (next === undefined)
+            return true;
+        ledger[instance] = next;
+        writeKiroLedger(ledger, path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function sameLaunch(a, b) {
+    return a.kiroVersion === b.kiroVersion && a.agendVersion === b.agendVersion && a.ui === b.ui
+        && a.flags.length === b.flags.length && a.flags.every((f, i) => f === b.flags[i]);
+}
+export function recordKiroLaunch(facts, path = kiroLedgerPath()) {
+    const record = {
+        at: (facts.now ?? new Date()).toISOString(),
+        kiroVersion: facts.kiroVersion,
+        agendVersion: agendVersion(),
+        ui: facts.ui,
+        flags: [...facts.flags],
+    };
+    return updateKiroLedger(facts.instance, entry => {
+        const history = entry?.history ?? [];
+        const last = history[history.length - 1];
+        const nextHistory = last && sameLaunch(last, record) ? history : [...history, record].slice(-HISTORY_LIMIT);
+        return {
+            ...entry,
+            workingDirectory: facts.workingDirectory,
+            credentialProfile: facts.credentialProfile,
+            firstSeen: entry?.firstSeen ?? record.at,
+            lastLaunch: record,
+            history: nextHistory,
+        };
+    }, path);
+}
+//# sourceMappingURL=kiro-engine-ledger.js.map

package/dist/backend/kiro-engine-ledger.js.map

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

package/dist/backend/kiro-kas-store.d.ts

@@ -0,0 +1,11 @@
+export interface KasSession {
+    id: string;
+    /** Epoch ms from session.json, or null when absent or not a time. */
+    createdAt: number | null;
+    lastModifiedAt: number | null;
+}
+export declare function kiroHome(env?: NodeJS.ProcessEnv): string;
+/** The bucket kiro files a working directory's V3 sessions under. */
+export declare function kasBucket(workingDirectory: string): string;
+/** This working directory's V3 sessions, most recently active first. Unreadable entries are skipped. */
+export declare function listKasSessions(workingDirectory: string, env?: NodeJS.ProcessEnv): KasSession[];

package/dist/backend/kiro-kas-store.js

@@ -0,0 +1,67 @@
+/**
+ * Kiro's V3 (KAS) session store, read-only.
+ *
+ * V3 keeps a conversation as a directory, not a sqlite row:
+ *   <KIRO_HOME or ~/.kiro>/sessions/<bucket>/<session id>/{session.json, messages.jsonl}
+ * where <bucket> is the first 16 hex of SHA-256 of the working directory
+ * (checked against real buckets kiro-cli 2.27.1 wrote). Session ids are
+ * `sess_<uuid>` for sessions V3 started and `cli_<classic id>_<suffix>` for ones
+ * converted from a classic conversation.
+ *
+ * Unlike the classic store this is not under XDG_DATA_HOME, so a credential
+ * profile does not give an instance its own copy of it.
+ */
+import { createHash } from "node:crypto";
+import { readdirSync, readFileSync, realpathSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+/** A timestamp kiro wrote, as an instant; anything that is not one is null (never "" or NaN). */
+function instant(v) {
+    if (typeof v !== "string")
+        return null;
+    const ms = Date.parse(v);
+    return Number.isFinite(ms) ? ms : null;
+}
+export function kiroHome(env = process.env) {
+    return env.KIRO_HOME || join(homedir(), ".kiro");
+}
+/** The bucket kiro files a working directory's V3 sessions under. */
+export function kasBucket(workingDirectory) {
+    let cwd = workingDirectory;
+    // kiro hashes its process cwd, which the kernel reports with symlinks resolved.
+    try {
+        cwd = realpathSync(workingDirectory);
+    }
+    catch { /* not there (yet): hash it as given */ }
+    return createHash("sha256").update(cwd).digest("hex").slice(0, 16);
+}
+/** This working directory's V3 sessions, most recently active first. Unreadable entries are skipped. */
+export function listKasSessions(workingDirectory, env = process.env) {
+    const dir = join(kiroHome(env), "sessions", kasBucket(workingDirectory));
+    let names;
+    try {
+        names = readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    const sessions = [];
+    for (const name of names) {
+        if (name.startsWith("."))
+            continue;
+        try {
+            const meta = JSON.parse(readFileSync(join(dir, name, "session.json"), "utf8"));
+            // The directory name is the id `--resume-id` takes (what ensure-session returns).
+            sessions.push({
+                id: name,
+                createdAt: instant(meta.createdAt),
+                lastModifiedAt: instant(meta.lastModifiedAt),
+            });
+        }
+        catch { /* not a session directory, or one being written */ }
+    }
+    // Compared as instants (offsets differ between writers); one with no time sorts last.
+    const latest = (s) => s.lastModifiedAt ?? s.createdAt ?? -Infinity;
+    return sessions.sort((a, b) => latest(b) - latest(a));
+}
+//# sourceMappingURL=kiro-kas-store.js.map

package/dist/backend/kiro-kas-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kiro-kas-store.js","sourceRoot":"","sources":["../../src/backend/kiro-kas-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AASjC,iGAAiG;AACjG,SAAS,OAAO,CAAC,CAAU;IACzB,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACzB,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC3D,OAAO,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,SAAS,CAAC,gBAAwB;IAChD,IAAI,GAAG,GAAG,gBAAgB,CAAC;IAC3B,gFAAgF;IAChF,IAAI,CAAC;QAAC,GAAG,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,uCAAuC,CAAC,CAAC;IAC/F,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,eAAe,CAAC,gBAAwB,EAAE,MAAyB,OAAO,CAAC,GAAG;IAC5F,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACzE,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QAAC,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC;IAAC,CAAC;IACtD,MAAM,QAAQ,GAAiB,EAAE,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QACnC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAA4B,CAAC;YAC1G,kFAAkF;YAClF,QAAQ,CAAC,IAAI,CAAC;gBACZ,EAAE,EAAE,IAAI;gBACR,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;gBAClC,cAAc,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC;aAC7C,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC,CAAC,mDAAmD,CAAC,CAAC;IACjE,CAAC;IACD,sFAAsF;IACtF,MAAM,MAAM,GAAG,CAAC,CAAa,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,QAAQ,CAAC;IAC/E,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC"}

package/dist/backend/kiro-v3-identity.d.ts

@@ -0,0 +1,28 @@
+/** The fresh start could not be recorded: launching anyway would let the next launch resume what this one gave up. */
+export declare class KiroV3IdentityError extends Error {
+    constructor(detail: string);
+}
+export interface KiroV3ResumeOptions {
+    /** Start fresh: give up the session this instance owned. */
+    skipResume?: boolean;
+    agendHome?: string;
+    env?: NodeJS.ProcessEnv;
+    now?: Date;
+}
+export declare function resolveKiroV3Resume(instance: string, workingDirectory: string, credentialProfile: string | null, opts?: KiroV3ResumeOptions): string | null;
+export type KiroV3Identity = {
+    kind: "none";
+} | {
+    kind: "unreadable";
+} | {
+    kind: "owned";
+    id: string;
+    claimHeld: boolean;
+    credentialProfile: string | null;
+} | {
+    kind: "fresh";
+    since: string;
+    credentialProfile: string | null;
+};
+/** What an instance's V3 identity says right now, read-only (for kiro_engine_status). */
+export declare function readKiroV3Identity(instance: string, agendHome?: string): KiroV3Identity;

package/dist/backend/kiro-v3-identity.js

@@ -0,0 +1,213 @@
+/**
+ * Which V3 session a V3 kiro instance owns, and so resumes.
+ *
+ * Kiro's V3 `--resume` takes the newest conversation in the working directory
+ * from ANY engine, and converts a classic one into a new V3 copy on every
+ * launch (#1141 kiro migration study). A V3 instance therefore resumes by id —
+ * and the id must be its own: never a sibling's running conversation, never
+ * one it gave up, never a guess. Two stores, both under `<AGEND_HOME>/kiro-v3`:
+ *
+ *   claims/<session id>   created exclusively ("wx") holding the owner's name
+ *                         and a newline, the newline written last: a claim
+ *                         without it is still being written (or was cut
+ *                         short) and belongs to nobody who can use it.
+ *                         Whoever created it owns the session; nobody else
+ *                         can take it over, and only the owner removes it.
+ *   instances/<name>.json the instance's state, written only by its own
+ *                         launch: the session it owns, or a fresh-start mark
+ *                         (`id: null`, when, and which sessions already existed).
+ *
+ * A session is taken up only with evidence that this instance's own fresh
+ * launch made it: created (a valid instant) after the mark, absent from the
+ * mark's list, owned by nobody, and the only such session — with no other
+ * instance in the same directory waiting to take up its own. Anything less
+ * certain starts fresh again — and a fresh start is only made once it is
+ * on record: one that cannot be recorded refuses the launch, since the next
+ * launch would otherwise go back to the session this one gave up. Two V3
+ * instances in one working directory
+ * cannot tell their sessions apart and each keeps starting fresh: a known
+ * limit, chosen over handing one of them the other's conversation.
+ */
+import { mkdirSync, openSync, closeSync, readdirSync, readFileSync, rmSync, writeSync } from "node:fs";
+import { join } from "node:path";
+import { getAgendHome } from "../paths.js";
+import { writeFileAtomic } from "./kiro-engine-ledger.js";
+import { kasBucket, listKasSessions } from "./kiro-kas-store.js";
+/** Session ids and instance names become file names: only plain ones. */
+const SAFE_NAME = /^[A-Za-z0-9][A-Za-z0-9_.-]{0,199}$/;
+/** Never a valid instance name (it fails SAFE_NAME), so never mistaken for one. */
+const INCOMPLETE = "\0incomplete";
+function isState(v) {
+    if (!v || typeof v !== "object" || Array.isArray(v))
+        return false;
+    const s = v;
+    return typeof s.bucket === "string"
+        && (s.credentialProfile === null || typeof s.credentialProfile === "string")
+        && (s.id === null || (typeof s.id === "string" && SAFE_NAME.test(s.id)))
+        // A real instant: Date accepts only ±8.64e15 ms, and an out-of-range mark is no evidence of anything.
+        && typeof s.since === "number" && Number.isFinite(new Date(s.since).getTime())
+        && Array.isArray(s.known) && s.known.every(k => typeof k === "string");
+}
+/** The fresh start could not be recorded: launching anyway would let the next launch resume what this one gave up. */
+export class KiroV3IdentityError extends Error {
+    constructor(detail) {
+        super(`AgEnD could not record this V3 instance's fresh start (${detail}); not launching, so the conversation it gave up is not resumed later`);
+        this.name = "KiroV3IdentityError";
+    }
+}
+export function resolveKiroV3Resume(instance, workingDirectory, credentialProfile, opts = {}) {
+    if (!SAFE_NAME.test(instance))
+        return null;
+    const root = join(opts.agendHome ?? getAgendHome(), "kiro-v3");
+    const claims = join(root, "claims");
+    const instances = join(root, "instances");
+    const statePath = join(instances, `${instance}.json`);
+    const bucket = kasBucket(workingDirectory);
+    const sessions = listKasSessions(workingDirectory, opts.env).filter(s => SAFE_NAME.test(s.id));
+    const readState = (path) => {
+        try {
+            const v = JSON.parse(readFileSync(path, "utf8"));
+            return isState(v) ? v : null;
+        }
+        catch {
+            return null;
+        }
+    };
+    /** null: unclaimed. INCOMPLETE: a claim being written, or cut short — someone's, and not usable. */
+    const owner = (id) => {
+        let text;
+        try {
+            text = readFileSync(join(claims, id), "utf8");
+        }
+        catch (err) {
+            return err.code === "ENOENT" ? null : INCOMPLETE;
+        }
+        return text.endsWith("\n") ? text.slice(0, -1) : INCOMPLETE;
+    };
+    /** Claims an unclaimed session. True only once the whole owner line is on disk. */
+    const claim = (id) => {
+        const path = join(claims, id);
+        let fd;
+        try {
+            mkdirSync(claims, { recursive: true, mode: 0o700 });
+            fd = openSync(path, "wx", 0o600);
+        }
+        catch {
+            return false;
+        }
+        let complete = false;
+        try {
+            const line = Buffer.from(`${instance}\n`);
+            let offset = 0;
+            while (offset < line.length) {
+                const n = writeSync(fd, line, offset, line.length - offset);
+                if (n <= 0)
+                    break;
+                offset += n;
+            }
+            complete = offset === line.length;
+        }
+        catch { /* the claim stays incomplete */ }
+        finally {
+            closeSync(fd);
+        }
+        // Ours (created exclusively), so ours to take back when it could not be finished.
+        if (!complete)
+            rmSync(path, { force: true });
+        return complete;
+    };
+    // Only the owner removes a claim, and no one can create it while it exists, so read-then-remove is safe.
+    const release = (id) => { if (owner(id) === instance)
+        rmSync(join(claims, id), { force: true }); };
+    const writeState = (state) => {
+        try {
+            mkdirSync(instances, { recursive: true, mode: 0o700 });
+            writeFileAtomic(statePath, JSON.stringify(state) + "\n");
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    const state = readState(statePath);
+    const startFresh = () => {
+        // Recorded first: until it is, the old state still says which session this instance holds.
+        if (!writeState({ bucket, credentialProfile, id: null, since: (opts.now ?? new Date()).getTime(), known: sessions.map(s => s.id) })) {
+            throw new KiroV3IdentityError(`cannot write ${statePath}`);
+        }
+        try {
+            if (state?.id)
+                release(state.id);
+        }
+        catch { /* the claim stays; it only keeps others off a session nobody resumes */ }
+        return null;
+    };
+    if (opts.skipResume || !state || state.bucket !== bucket || state.credentialProfile !== credentialProfile)
+        return startFresh();
+    if (state.id) {
+        const id = state.id;
+        // Resumed only while the claim is really held: a state alone never re-creates one.
+        return sessions.some(s => s.id === id) && owner(id) === instance ? id : startFresh();
+    }
+    // A fresh start is on record: take up the session that launch made, if — and only if — that is certain.
+    const known = new Set(state.known);
+    const candidates = sessions.filter(s => !known.has(s.id) && s.createdAt !== null && s.createdAt > state.since
+        && (owner(s.id) ?? instance) === instance);
+    const siblingWaiting = (() => {
+        let names;
+        // Siblings that cannot be listed are siblings that cannot be ruled out.
+        try {
+            names = readdirSync(instances);
+        }
+        catch {
+            return true;
+        }
+        return names.some(n => {
+            if (n === `${instance}.json` || !n.endsWith(".json"))
+                return false;
+            const other = readState(join(instances, n));
+            // An unreadable state in this directory could be a sibling waiting: not certain, so it counts.
+            return other === null || (other.bucket === bucket && other.id === null);
+        });
+    })();
+    if (candidates.length !== 1 || siblingWaiting)
+        return startFresh();
+    const pick = candidates[0].id;
+    // Already ours when an earlier launch claimed it but could not record that in its state.
+    if (owner(pick) !== instance && !claim(pick))
+        return startFresh();
+    // The claim is the ownership; if the state cannot record it, the next launch finds the claim again.
+    writeState({ ...state, id: pick });
+    return pick;
+}
+/** What an instance's V3 identity says right now, read-only (for kiro_engine_status). */
+export function readKiroV3Identity(instance, agendHome = getAgendHome()) {
+    if (!SAFE_NAME.test(instance))
+        return { kind: "none" };
+    const root = join(agendHome, "kiro-v3");
+    let raw;
+    try {
+        raw = readFileSync(join(root, "instances", `${instance}.json`), "utf8");
+    }
+    catch (err) {
+        return err.code === "ENOENT" ? { kind: "none" } : { kind: "unreadable" };
+    }
+    let state;
+    try {
+        state = JSON.parse(raw);
+    }
+    catch {
+        return { kind: "unreadable" };
+    }
+    if (!isState(state))
+        return { kind: "unreadable" };
+    if (state.id === null)
+        return { kind: "fresh", since: new Date(state.since).toISOString(), credentialProfile: state.credentialProfile };
+    let claimHeld = false;
+    try {
+        claimHeld = readFileSync(join(root, "claims", state.id), "utf8") === `${instance}\n`;
+    }
+    catch { /* not held */ }
+    return { kind: "owned", id: state.id, claimHeld, credentialProfile: state.credentialProfile };
+}
+//# sourceMappingURL=kiro-v3-identity.js.map

package/dist/backend/kiro-v3-identity.js.map

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

package/dist/backend/kiro.d.ts

@@ -89,6 +89,13 @@ export declare function planKiroLaunch(ui: "legacy" | "tui" | "v3", compat: Kiro
 export declare function getCachedKiroCliCompatibility(binaryPath: string, run?: KiroProbeRunner): KiroCliCompatibility;
 /** Test-only reset for the process-level compatibility and warning memo. */
 export declare function resetKiroCompatibilityCacheForTests(): void;
+/** The kiro-cli compatibility AgEnD last probed for a launch: read by kiro_engine_status, which never probes itself. */
+export interface KiroCompatibilitySnapshot {
+    binaryPath: string;
+    compatibility: KiroCliCompatibility;
+    at: string;
+}
+export declare function lastKiroCompatibilitySnapshot(): KiroCompatibilitySnapshot | null;
 /** Startup budget for a `--resume` launch (60% first output, 40% ready). */
 export declare const KIRO_RESUME_STARTUP_BUDGET_MS = 60000;
 export declare class KiroBackend implements CliBackend {

package/dist/backend/kiro.js

@@ -8,6 +8,8 @@ import { UnsupportedCliError, resolveBinary, shellQuote, validateEffort, validat
 import { PIE_CLASS } from "../tui-glyphs.js";
 import { KIRO_EXPIRED_LOGIN_SCREEN } from "../login-flows.js";
 import { t } from "../locale.js";
+import { recordKiroLaunch } from "./kiro-engine-ledger.js";
+import { resolveKiroV3Resume } from "./kiro-v3-identity.js";
 // Kiro CLI feature gates. These are deliberately separate: the flags shipped
 // in different releases, so one broad "old Kiro" check would still crash some
 // supported versions with an unknown argument. Every row below was read from
@@ -485,6 +487,13 @@ export function resetKiroCompatibilityCacheForTests() {
     warnedUnsupportedEffortCacheKeys.clear();
     warnedVersionGateCacheKeys.clear();
 }
+let lastKiroCompatibility = null;
+export function lastKiroCompatibilitySnapshot() {
+    return lastKiroCompatibility;
+}
+function publishKiroCompatibility(binaryPath, compatibility) {
+    lastKiroCompatibility = { binaryPath, compatibility, at: new Date().toISOString() };
+}
 /** Startup budget for a `--resume` launch (60% first output, 40% ready). */
 export const KIRO_RESUME_STARTUP_BUDGET_MS = 60_000;
 export class KiroBackend {
@@ -524,6 +533,7 @@ export class KiroBackend {
             const cached = cachedKiroCliCompatibility(this.binaryPath);
             this.compatibility = cached.compatibility;
             this.compatibilityCacheKey = cached.cacheKey;
+            publishKiroCompatibility(this.binaryPath, this.compatibility);
         }
     }
     requiresDeliveryEnterRetry() {
@@ -604,6 +614,8 @@ export class KiroBackend {
             this.compatibility = current.compatibility;
             this.compatibilityCacheKey = current.cacheKey;
         }
+        // What this launch is judged by, for kiro_engine_status to read without probing.
+        publishKiroCompatibility(this.binaryPath, this.compatibility);
         if (this.compatibility.source === "unknown") {
             // Neither --version nor chat --help answered: a missing or wedged binary,
             // or a loaded host timing out. Launching blind could start kiro on its
@@ -617,6 +629,15 @@ export class KiroBackend {
         for (const flag of plan.flags)
             cmd += ` ${flag}`;
         this.noteVersionGate();
+        const credentialProfile = resolveCredentialProfile(config.backendOptions);
+        recordKiroLaunch({
+            instance: config.instanceName,
+            workingDirectory: config.workingDirectory,
+            credentialProfile,
+            kiroVersion: this.compatibility.version ?? null,
+            ui,
+            flags: plan.flags,
+        });
         // Record what is actually being launched for the delivery gate (see
         // dropsEnterWhileBusy): the legacy prompt row exists only under
         // --legacy-ui; a binary from before 1.27 paints its own classic screen.
@@ -636,8 +657,20 @@ export class KiroBackend {
         // store, which is the same thing every brand-new instance does on its first
         // launch. Switching profiles also skips resume outright (crash-state
         // resumeDisabled), so this never fires against a store that just changed.
-        if (!config.skipResume)
+        //
+        // V3 is the exception, and resumes only the session it owns, by id: its
+        // `--resume` takes the newest conversation in the directory from ANY
+        // engine and converts a classic one into a new V3 copy — on every launch.
+        // A skipped resume is recorded there too, so the session given up is not
+        // taken back on the next launch. See kiro-v3-identity.ts.
+        if (ui === "v3") {
+            const id = resolveKiroV3Resume(config.instanceName, config.workingDirectory, credentialProfile, { skipResume: config.skipResume });
+            if (id)
+                cmd += ` --resume-id ${shellQuote(id)}`;
+        }
+        else if (!config.skipResume) {
             cmd += " --resume";
+        }
         if (config.model) {
             const model = validateModel(config.model);
             warnIfModelMismatch("kiro-cli", model);