@sentropic/h2a-runtime 0.81.0

package/dist/config.js

@@ -0,0 +1,334 @@
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { homedir } from "node:os";
+export const DEFAULT_LAYOUT = {
+    maxAgeHours: 48,
+    maxPerWindow: 12,
+    sharedWindows: 2,
+    multiSession: {},
+    multiSessionDefault: 1,
+    groups: [],
+};
+/** Default h2a side-window command (a2a-cli launcher contract). */
+export const DEFAULT_H2A_COMMAND = "h2a mcp-serve --auto-open --auto-upgrade --wake local-tmux";
+/** Default session target when none is configured/passed. */
+export const DEFAULT_SESSION_TARGET = "scaleway-kapsule";
+function parseTunnel(raw) {
+    if (!raw || typeof raw !== "object")
+        return undefined;
+    const t = raw;
+    if (typeof t.namespace !== "string" ||
+        typeof t.service !== "string" ||
+        typeof t.localPort !== "number" ||
+        typeof t.remotePort !== "number") {
+        return undefined;
+    }
+    const tunnel = {
+        namespace: t.namespace,
+        service: t.service,
+        localPort: t.localPort,
+        remotePort: t.remotePort,
+    };
+    if (typeof t.kubeconfig === "string")
+        tunnel.kubeconfig = t.kubeconfig;
+    return tunnel;
+}
+function parseH2a(raw) {
+    if (!raw || typeof raw !== "object")
+        return undefined;
+    const h = raw;
+    const h2a = {};
+    if (typeof h.enabled === "boolean")
+        h2a.enabled = h.enabled;
+    if (typeof h.command === "string")
+        h2a.command = h.command;
+    return Object.keys(h2a).length > 0 ? h2a : undefined;
+}
+function parseLlmMeshRuntime(raw) {
+    if (!raw || typeof raw !== "object")
+        return undefined;
+    const r = raw;
+    const llmMesh = {};
+    if (typeof r.enabled === "boolean")
+        llmMesh.enabled = r.enabled;
+    return Object.keys(llmMesh).length > 0 ? llmMesh : undefined;
+}
+function parseTmuxProfile(raw) {
+    if (!raw || typeof raw !== "object")
+        return undefined;
+    const r = raw;
+    const tmux = {};
+    if (typeof r.profile === "string" && r.profile.trim()) {
+        tmux.profile = r.profile.trim();
+    }
+    return Object.keys(tmux).length > 0 ? tmux : undefined;
+}
+function parsePluginMcp(raw) {
+    if (!raw || typeof raw !== "object")
+        return undefined;
+    const m = raw;
+    if (typeof m.name !== "string" ||
+        typeof m.command !== "string" ||
+        !Array.isArray(m.args) ||
+        !m.args.every((a) => typeof a === "string")) {
+        return undefined;
+    }
+    const mcp = {
+        name: m.name,
+        command: m.command,
+        args: m.args,
+    };
+    if (typeof m.scriptRel === "string")
+        mcp.scriptRel = m.scriptRel;
+    return mcp;
+}
+function parsePlugins(raw) {
+    if (!Array.isArray(raw))
+        return undefined;
+    const plugins = [];
+    for (const item of raw) {
+        if (!item || typeof item !== "object")
+            continue;
+        const p = item;
+        if (typeof p.pkg !== "string" ||
+            typeof p.version !== "string" ||
+            !Array.isArray(p.mcp)) {
+            continue;
+        }
+        const mcp = p.mcp
+            .map(parsePluginMcp)
+            .filter((m) => m !== undefined);
+        const entry = { pkg: p.pkg, version: p.version, mcp };
+        const install = parsePluginInstall(p.install);
+        if (install)
+            entry.install = install;
+        plugins.push(entry);
+    }
+    return plugins;
+}
+function parsePluginInstall(raw) {
+    if (!raw || typeof raw !== "object")
+        return undefined;
+    const i = raw;
+    if (i.method !== "npm" && i.method !== "curl" && i.method !== "script") {
+        return undefined;
+    }
+    const install = { method: i.method };
+    if (typeof i.spec === "string")
+        install.spec = i.spec;
+    return install;
+}
+// Resolved lazily so tests can redirect the config home via
+// REMOTE_CLI_CONFIG_HOME without clobbering the real ~/.config.
+function configHome() {
+    return process.env.REMOTE_CLI_CONFIG_HOME ?? homedir();
+}
+export function resolveConfigPath() {
+    return join(configHome(), ".config", "sentropic", "remote-cli", "config.json");
+}
+export function normalizeRemoteUrl(rawUrl) {
+    const trimmed = rawUrl.trim();
+    if (!trimmed) {
+        throw new Error("Remote URL cannot be empty.");
+    }
+    const parsed = new URL(trimmed);
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+        throw new Error(`Unsupported remote URL protocol "${parsed.protocol}". Use http:// or https://.`);
+    }
+    return trimmed.replace(/\/+$/, "");
+}
+export function readRemoteConfig() {
+    try {
+        const raw = readFileSync(resolveConfigPath(), "utf8");
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === "object") {
+            const config = {};
+            if (typeof parsed.defaultRemote === "string")
+                config.defaultRemote = parsed.defaultRemote;
+            if (typeof parsed.token === "string")
+                config.token = parsed.token;
+            if (typeof parsed.defaultTarget === "string")
+                config.defaultTarget = parsed.defaultTarget;
+            if (Array.isArray(parsed.defaultTools) &&
+                parsed.defaultTools.every((t) => typeof t === "string")) {
+                config.defaultTools = parsed.defaultTools;
+            }
+            const tunnel = parseTunnel(parsed.tunnel);
+            if (tunnel)
+                config.tunnel = tunnel;
+            if (parsed.layout && typeof parsed.layout === "object")
+                config.layout = parsed.layout;
+            const plugins = parsePlugins(parsed.plugins);
+            if (plugins)
+                config.plugins = plugins;
+            const h2a = parseH2a(parsed.h2a);
+            if (h2a)
+                config.h2a = h2a;
+            const llmMesh = parseLlmMeshRuntime(parsed.llmMesh);
+            if (llmMesh)
+                config.llmMesh = llmMesh;
+            const tmux = parseTmuxProfile(parsed.tmux);
+            if (tmux)
+                config.tmux = tmux;
+            if (typeof parsed.maxConcurrent === "number" &&
+                Number.isFinite(parsed.maxConcurrent) &&
+                parsed.maxConcurrent > 0) {
+                config.maxConcurrent = Math.trunc(parsed.maxConcurrent);
+            }
+            return config;
+        }
+        return {};
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return {};
+        throw new Error(`failed to read remote config: ${error.message}`);
+    }
+}
+export function writeRemoteConfig(config) {
+    const path = resolveConfigPath();
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(config, null, 2), "utf8");
+}
+export function getDefaultRemote() {
+    const config = readRemoteConfig();
+    return config.defaultRemote;
+}
+export function setDefaultRemote(rawUrl) {
+    const defaultRemote = normalizeRemoteUrl(rawUrl);
+    writeRemoteConfig({ ...readRemoteConfig(), defaultRemote });
+    return defaultRemote;
+}
+export function clearDefaultRemote() {
+    const { defaultRemote: _drop, ...rest } = readRemoteConfig();
+    writeRemoteConfig(rest);
+}
+export function getDefaultTarget() {
+    const configured = readRemoteConfig().defaultTarget;
+    return configured ?? DEFAULT_SESSION_TARGET;
+}
+export function setDefaultTarget(value) {
+    writeRemoteConfig({ ...readRemoteConfig(), defaultTarget: value });
+}
+export function getDefaultTools() {
+    return readRemoteConfig().defaultTools ?? [];
+}
+export function setDefaultTools(tools) {
+    writeRemoteConfig({ ...readRemoteConfig(), defaultTools: tools });
+}
+/** Plugins installed via `remote plugin add` (mirrors getDefaultTools). */
+export function getPlugins() {
+    return readRemoteConfig().plugins ?? [];
+}
+export function setPlugins(plugins) {
+    writeRemoteConfig({ ...readRemoteConfig(), plugins });
+}
+/** h2a config merged with defaults (enabled=false, default mcp-serve command). */
+export function getH2aConfig() {
+    const raw = readRemoteConfig().h2a ?? {};
+    return {
+        enabled: raw.enabled ?? false,
+        command: raw.command ?? DEFAULT_H2A_COMMAND,
+    };
+}
+export function setH2aConfig(h2a) {
+    writeRemoteConfig({ ...readRemoteConfig(), h2a });
+}
+export function getLlmMeshRuntimeConfig() {
+    const raw = readRemoteConfig().llmMesh ?? {};
+    return {
+        enabled: raw.enabled ?? false,
+    };
+}
+export function setLlmMeshRuntimeConfig(llmMesh) {
+    writeRemoteConfig({ ...readRemoteConfig(), llmMesh });
+}
+export function getTmuxProfileConfig() {
+    const raw = readRemoteConfig().tmux ?? {};
+    return { profile: raw.profile ?? "remote" };
+}
+export function setTmuxProfileConfig(tmux) {
+    writeRemoteConfig({ ...readRemoteConfig(), tmux });
+}
+/**
+ * P4 — the configured default concurrency cap for delegated jobs, or undefined
+ * when unset (the caller falls back to DEFAULT_MAX_CONCURRENT). The env override
+ * `REMOTE_MAX_CONCURRENT` wins so a conductor window can be tuned without writing
+ * config.
+ */
+export function getMaxConcurrent() {
+    const env = process.env.REMOTE_MAX_CONCURRENT;
+    if (env !== undefined) {
+        const n = Number.parseInt(env, 10);
+        if (Number.isFinite(n) && n > 0)
+            return n;
+    }
+    return readRemoteConfig().maxConcurrent;
+}
+export function setMaxConcurrent(value) {
+    writeRemoteConfig({ ...readRemoteConfig(), maxConcurrent: value });
+}
+/** Generous default age (hours) after which a stuck `running` job is swept → failed. */
+export const DEFAULT_JOB_MAX_AGE_HOURS = 24;
+/**
+ * Max age (hours) a delegated job may stay `running`/`awaiting-decision` before
+ * the reconciler sweeps it to `failed` (M2 — convergence: a job whose hook +
+ * liveness signal were both lost would otherwise occupy a slot forever).
+ * `REMOTE_JOB_MAX_AGE_HOURS` overrides; default is generous (24h) so a genuinely
+ * long-running interactive job is never killed prematurely.
+ */
+export function getJobMaxAgeHours() {
+    const env = process.env.REMOTE_JOB_MAX_AGE_HOURS;
+    if (env !== undefined) {
+        const n = Number.parseFloat(env);
+        if (Number.isFinite(n) && n > 0)
+            return n;
+    }
+    return DEFAULT_JOB_MAX_AGE_HOURS;
+}
+export function getTunnel() {
+    return readRemoteConfig().tunnel;
+}
+export function setTunnel(tunnel) {
+    writeRemoteConfig({ ...readRemoteConfig(), tunnel });
+}
+export function clearTunnel() {
+    const { tunnel: _drop, ...rest } = readRemoteConfig();
+    writeRemoteConfig(rest);
+}
+/** Layout config merged with defaults (used by `remote restore`). */
+export function getLayoutConfig() {
+    const raw = readRemoteConfig().layout ?? {};
+    return {
+        maxAgeHours: typeof raw.maxAgeHours === "number"
+            ? raw.maxAgeHours
+            : DEFAULT_LAYOUT.maxAgeHours,
+        maxPerWindow: typeof raw.maxPerWindow === "number"
+            ? raw.maxPerWindow
+            : DEFAULT_LAYOUT.maxPerWindow,
+        sharedWindows: typeof raw.sharedWindows === "number"
+            ? raw.sharedWindows
+            : DEFAULT_LAYOUT.sharedWindows,
+        multiSession: raw.multiSession && typeof raw.multiSession === "object"
+            ? raw.multiSession
+            : DEFAULT_LAYOUT.multiSession,
+        multiSessionDefault: typeof raw.multiSessionDefault === "number"
+            ? raw.multiSessionDefault
+            : DEFAULT_LAYOUT.multiSessionDefault,
+        groups: Array.isArray(raw.groups) ? raw.groups : DEFAULT_LAYOUT.groups,
+    };
+}
+export function setLayoutConfig(layout) {
+    writeRemoteConfig({ ...readRemoteConfig(), layout });
+}
+export function getToken() {
+    return process.env.REMOTE_TOKEN ?? readRemoteConfig().token;
+}
+export function setToken(value) {
+    writeRemoteConfig({ ...readRemoteConfig(), token: value });
+}
+export function authHeaders() {
+    const token = getToken();
+    return token ? { Authorization: `Bearer ${token}` } : {};
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/conv-guard.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Single-writer guard per conversation (WP5).
+ *
+ * A claude/codex conversation is one append-only .jsonl — TWO CLIs resuming
+ * the same convId at once interleave their appends and corrupt it (the user's
+ * critical asset). Before `remote run -r <conv>` / `remote migrate forward
+ * -r <conv>` start a new writer, convOwners() lists every LIVE writer already
+ * holding that conversation:
+ *
+ *  (a) live local registry entries (registry.ts) with the same convId —
+ *      another tmux session or a hook-enrolled plain-terminal CLI,
+ *  (b) live remote sessions whose cliSessionId (reported by the session-agent)
+ *      matches; a remote session WITHOUT a cliSessionId but running on the
+ *      same workspacePath is flagged as a SUSPECT (warning, not refusal).
+ *
+ * guardConvWriters() is the shared wiring: prints the warnings/refusal and
+ * tells the caller whether to proceed (--force overrides, loudly).
+ */
+import { type LivenessOpts } from "./registry.js";
+export type ConvOwnerWhere = "local-tmux" | "local" | "remote";
+export type ConvOwner = {
+    where: ConvOwnerWhere;
+    /** Short handle: tmux slug, registry label, or remote session id/name. */
+    label: string;
+    /** Human sentence: what holds the conversation and how to release it. */
+    detail: string;
+    /** true = cwd-only heuristic (no cliSessionId) — warn, do not refuse. */
+    suspect?: boolean;
+};
+/** The subset of listRemoteSessions() rows the guard needs. */
+export type RemoteSessionLite = {
+    id: string;
+    displayName?: string;
+    cliSessionId?: string;
+    workspacePath?: string;
+};
+export type ConvOwnersOpts = LivenessOpts & {
+    /** Registry file override (tests). */
+    registryPath?: string;
+    /** Registry entry id to ignore (the entry the caller is creating/reviving). */
+    excludeId?: string;
+    /** Live remote sessions, already fetched by the caller (omit = no remote check). */
+    remoteSessions?: ReadonlyArray<RemoteSessionLite>;
+    /** Local project path — enables the workspacePath "suspect" heuristic. */
+    cwd?: string;
+};
+/**
+ * Every live writer currently holding convId. Entries with suspect=true are
+ * heuristic matches (same workspacePath, no cliSessionId) — warning-grade only.
+ */
+export declare function convOwners(convId: string, opts?: ConvOwnersOpts): ConvOwner[];
+/** Multi-line refusal message for hard (non-suspect) conflicts. */
+export declare function formatConvConflict(convId: string, owners: ReadonlyArray<ConvOwner>): string;
+export type GuardConvWritersArgs = LivenessOpts & {
+    convId: string;
+    /** Local project path (suspect heuristic for remote sessions). */
+    cwd: string;
+    /** Registry entry id to ignore (the entry the caller is creating/reviving). */
+    excludeId?: string;
+    /** Override the refusal (still warns). */
+    force?: boolean;
+    /**
+     * Best-effort fetch of live remote sessions; a throw (no remote configured,
+     * tunnel down) silently degrades the guard to local-registry-only.
+     */
+    fetchRemoteSessions?: () => Promise<ReadonlyArray<RemoteSessionLite>>;
+    /** Registry file override (tests). */
+    registryPath?: string;
+};
+/**
+ * Shared wiring for `remote run -r` / `remote migrate forward -r`. Prints
+ * warnings (suspects, --force override) and the refusal itself; returns
+ * true when the caller may start the new writer.
+ */
+export declare function guardConvWriters(args: GuardConvWritersArgs): Promise<boolean>;
+//# sourceMappingURL=conv-guard.d.ts.map

package/dist/conv-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conv-guard.d.ts","sourceRoot":"","sources":["../src/conv-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAY,KAAK,YAAY,EAAsB,MAAM,eAAe,CAAC;AAEhF,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE/D,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,cAAc,CAAC;IACtB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,+DAA+D;AAC/D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG;IAC1C,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,cAAc,CAAC,EAAE,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAClD,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAuBF;;;GAGG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,cAAmB,GACxB,SAAS,EAAE,CAsCb;AAED,mEAAmE;AACnE,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,GAC/B,MAAM,CAQR;AAED,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAC;IACZ,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACtE,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,OAAO,CAAC,CAkClB"}

package/dist/conv-guard.js

@@ -0,0 +1,131 @@
+/**
+ * Single-writer guard per conversation (WP5).
+ *
+ * A claude/codex conversation is one append-only .jsonl — TWO CLIs resuming
+ * the same convId at once interleave their appends and corrupt it (the user's
+ * critical asset). Before `remote run -r <conv>` / `remote migrate forward
+ * -r <conv>` start a new writer, convOwners() lists every LIVE writer already
+ * holding that conversation:
+ *
+ *  (a) live local registry entries (registry.ts) with the same convId —
+ *      another tmux session or a hook-enrolled plain-terminal CLI,
+ *  (b) live remote sessions whose cliSessionId (reported by the session-agent)
+ *      matches; a remote session WITHOUT a cliSessionId but running on the
+ *      same workspacePath is flagged as a SUSPECT (warning, not refusal).
+ *
+ * guardConvWriters() is the shared wiring: prints the warnings/refusal and
+ * tells the caller whether to proceed (--force overrides, loudly).
+ */
+import { listLive } from "./registry.js";
+function ownerFromEntry(e) {
+    if (e.kind === "local-tmux") {
+        const slug = e.label ?? e.id;
+        return {
+            where: "local-tmux",
+            label: slug,
+            detail: `local tmux session ${e.tmuxSession ?? `remote-${e.id}`} (${e.tool}, cwd ${e.cwd}) — stop it first: remote stop ${slug}`,
+        };
+    }
+    return {
+        where: "local",
+        label: e.label ?? e.id.slice(0, 12),
+        detail: `local ${e.tool} process${e.pid !== undefined ? ` (pid ${e.pid})` : ""} in ${e.cwd} — exit that CLI first`,
+        // A no-pid hook entry is UNVERIFIABLE (no process to probe): a crash leaves
+        // it "live" forever. Demote it to a SUSPECT (warn) so it never hard-blocks
+        // a relaunch; only verifiable writers (live tmux / pid+cmdline / remote)
+        // refuse. A pid'd entry that reached here passed the liveness check → hard.
+        ...(e.pid === undefined ? { suspect: true } : {}),
+    };
+}
+/**
+ * Every live writer currently holding convId. Entries with suspect=true are
+ * heuristic matches (same workspacePath, no cliSessionId) — warning-grade only.
+ */
+export function convOwners(convId, opts = {}) {
+    const owners = [];
+    const live = listLive({
+        ...(opts.tmuxHasSession ? { tmuxHasSession: opts.tmuxHasSession } : {}),
+        ...(opts.pidAlive ? { pidAlive: opts.pidAlive } : {}),
+        ...(opts.bootTimeMs !== undefined ? { bootTimeMs: opts.bootTimeMs } : {}),
+        ...(opts.processCmdline ? { processCmdline: opts.processCmdline } : {}),
+        ...(opts.registryPath ? { path: opts.registryPath } : {}),
+    });
+    for (const e of live) {
+        if (e.convId !== convId)
+            continue;
+        if (opts.excludeId !== undefined && e.id === opts.excludeId)
+            continue;
+        // kind "remote" registry entries can be stale (the registry cannot probe
+        // the cluster) — opts.remoteSessions, fetched live, is authoritative.
+        if (e.kind === "remote")
+            continue;
+        owners.push(ownerFromEntry(e));
+    }
+    for (const s of opts.remoteSessions ?? []) {
+        if (s.cliSessionId === convId) {
+            owners.push({
+                where: "remote",
+                label: s.displayName ?? s.id,
+                detail: `remote session ${s.id}${s.workspacePath ? ` (${s.workspacePath})` : ""} is on this conversation — stop it first: remote stop ${s.id}`,
+            });
+        }
+        else if (s.cliSessionId === undefined &&
+            opts.cwd !== undefined &&
+            s.workspacePath === opts.cwd) {
+            owners.push({
+                where: "remote",
+                label: s.displayName ?? s.id,
+                detail: `remote session ${s.id} runs on the same path (${s.workspacePath}) and MAY hold this conversation (no cliSessionId reported yet)`,
+                suspect: true,
+            });
+        }
+    }
+    return owners;
+}
+/** Multi-line refusal message for hard (non-suspect) conflicts. */
+export function formatConvConflict(convId, owners) {
+    const lines = owners.map((o) => `  - [${o.where}] ${o.label}: ${o.detail}`);
+    return (`[remote] conversation ${convId} already has a live writer:\n` +
+        `${lines.join("\n")}\n` +
+        `[remote] two CLIs appending to the same conversation .jsonl corrupt it — ` +
+        `stop the other writer first, or pass --force to take over anyway.\n`);
+}
+/**
+ * Shared wiring for `remote run -r` / `remote migrate forward -r`. Prints
+ * warnings (suspects, --force override) and the refusal itself; returns
+ * true when the caller may start the new writer.
+ */
+export async function guardConvWriters(args) {
+    let remoteSessions;
+    if (args.fetchRemoteSessions) {
+        try {
+            remoteSessions = await args.fetchRemoteSessions();
+        }
+        catch {
+            // remote unreachable — degrade to the local registry (best-effort)
+        }
+    }
+    const owners = convOwners(args.convId, {
+        cwd: args.cwd,
+        ...(args.excludeId !== undefined ? { excludeId: args.excludeId } : {}),
+        ...(remoteSessions !== undefined ? { remoteSessions } : {}),
+        ...(args.registryPath ? { registryPath: args.registryPath } : {}),
+        ...(args.tmuxHasSession ? { tmuxHasSession: args.tmuxHasSession } : {}),
+        ...(args.pidAlive ? { pidAlive: args.pidAlive } : {}),
+        ...(args.bootTimeMs !== undefined ? { bootTimeMs: args.bootTimeMs } : {}),
+        ...(args.processCmdline ? { processCmdline: args.processCmdline } : {}),
+    });
+    const hard = owners.filter((o) => !o.suspect);
+    for (const s of owners.filter((o) => o.suspect)) {
+        process.stderr.write(`[remote] warning: ${s.detail} — make sure it is not resuming conversation ${args.convId}.\n`);
+    }
+    if (hard.length === 0)
+        return true;
+    if (args.force) {
+        process.stderr.write(`[remote] warning: --force — taking over conversation ${args.convId} despite ${hard.length} live writer(s); concurrent writes WILL corrupt the .jsonl.\n`);
+        return true;
+    }
+    process.stderr.write(formatConvConflict(args.convId, hard));
+    return false;
+}
+//# sourceMappingURL=conv-guard.js.map

package/dist/conv-guard.js.map

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

package/dist/convsync.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Conversation alignment check: is a remote session's conversation log in sync
+ * with the latest LOCAL conversation for the same project? Compares metrics only
+ * (id, bytes, lines, sha256) — local read directly, remote computed in-Pod via
+ * kubectl (only the numbers cross the wire, never the conversation content).
+ */
+export type ConvStat = {
+    convId: string;
+    bytes: number;
+    lines: number;
+    sha: string;
+};
+/** claude's cwd→project-dir encoding (slashes → dashes). */
+export declare function encodeCwd(cwd: string): string;
+/** Newest local conversation for a project path (or undefined). */
+export declare function localConvStat(workspacePath: string, home?: string): ConvStat | undefined;
+/** Newest remote conversation for a session (computed in-Pod, metrics only). */
+export declare function remoteConvStat(sessionId: string, workspacePath: string): ConvStat | undefined;
+export type AlignVerdict = {
+    state: "in-sync" | "local-ahead" | "remote-ahead" | "diverged" | "missing";
+    detail: string;
+};
+export declare function alignment(local: ConvStat | undefined, remote: ConvStat | undefined): AlignVerdict;
+//# sourceMappingURL=convsync.d.ts.map

package/dist/convsync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convsync.d.ts","sourceRoot":"","sources":["../src/convsync.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,4DAA4D;AAC5D,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAMD,mEAAmE;AACnE,wBAAgB,aAAa,CAC3B,aAAa,EAAE,MAAM,EACrB,IAAI,GAAE,MAAkB,GACvB,QAAQ,GAAG,SAAS,CAmBtB;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GACpB,QAAQ,GAAG,SAAS,CAgCtB;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,SAAS,GAAG,aAAa,GAAG,cAAc,GAAG,UAAU,GAAG,SAAS,CAAC;IAC3E,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,wBAAgB,SAAS,CACvB,KAAK,EAAE,QAAQ,GAAG,SAAS,EAC3B,MAAM,EAAE,QAAQ,GAAG,SAAS,GAC3B,YAAY,CA0Bd"}