ferrycat 0.3.2 → 0.4.0

package/dist/supervisor.js

@@ -0,0 +1,562 @@
+/**
+ * FerryCat execution supervisor (Phase 3 Step 0).
+ *
+ * Owns the lifecycle of one automated `worker --exec / --exec-file` child process:
+ *   - Heartbeat lease keep-alive bound to claim_token (CK-01 / CK-02 / CK-03)
+ *   - Process-tree termination incl. grandchildren (CK-04 / CK-05)
+ *   - Minimal environment allowlist for the child (CK-06)
+ *   - Partial-output salvage before the execution window closes (CK-07)
+ *
+ * Deliberately introduces NO new contract states (CK-09): every outcome maps onto the
+ * existing CLAIMED -> COMPLETED / FAILED / TIMED_OUT transitions exposed by the engine.
+ * See docs/audits/2026-10-24-phase-3-multi-agent-consensus-audit_zh.md.
+ */
+import { spawn, spawnSync } from 'node:child_process';
+import path from 'node:path';
+import { expandTilde } from './engine.js';
+import { FulfillContractSchema } from './schemas.js';
+// ---------------------------------------------------------------------------
+// CK-06: Minimal child environment
+// ---------------------------------------------------------------------------
+/**
+ * Variables the child genuinely needs to run and to locate the user's *file-based* login
+ * state (~/.config, %APPDATA%). Token-bearing env vars are a different threat model from
+ * user-authorized credential files and are stripped (see audit §1.4 "reverse trap").
+ */
+const WINDOWS_ENV_ALLOWLIST = new Set([
+    'PATH',
+    'PATHEXT',
+    'SYSTEMROOT',
+    'SYSTEMDRIVE',
+    'WINDIR',
+    'COMSPEC',
+    'TEMP',
+    'TMP',
+    'USERPROFILE',
+    'USERNAME',
+    'HOMEDRIVE',
+    'HOMEPATH',
+    'APPDATA',
+    'LOCALAPPDATA',
+    'PROGRAMDATA',
+    'PROGRAMFILES',
+    'PROGRAMFILES(X86)',
+    'NUMBER_OF_PROCESSORS',
+    'PROCESSOR_ARCHITECTURE',
+    'LANG',
+    'AGENT_NAME',
+]);
+const POSIX_ENV_ALLOWLIST = new Set([
+    'PATH',
+    'HOME',
+    'TMPDIR',
+    'SHELL',
+    'USER',
+    'LOGNAME',
+    'LANG',
+    'LC_ALL',
+    'LC_CTYPE',
+    'TERM',
+    'XDG_CONFIG_HOME',
+    'XDG_DATA_HOME',
+    'XDG_CACHE_HOME',
+    'XDG_STATE_HOME',
+    'XDG_RUNTIME_DIR',
+    'AGENT_NAME',
+]);
+/** Defense in depth: even an allowlisted or FERRYCAT_* name is dropped if it looks secret. */
+const SECRET_NAME_PATTERNS = [
+    /_TOKEN$/i,
+    /_KEY$/i,
+    /_SECRET$/i,
+    /SECRET/i,
+    /PASSWORD/i,
+    /CREDENTIAL/i,
+    /^AWS_/i,
+    /^GITHUB_/i,
+    /^GH_/i,
+    /^NPM_/i,
+    /^OPENAI_/i,
+    /^ANTHROPIC_/i,
+];
+const ENV_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_().]*$/;
+export function isSecretEnvName(name) {
+    return SECRET_NAME_PATTERNS.some((re) => re.test(name));
+}
+export function buildChildEnv(contract, passEnv = [], parentEnv = process.env, platform = process.platform) {
+    const isWin = platform === 'win32';
+    const allowlist = isWin ? WINDOWS_ENV_ALLOWLIST : POSIX_ENV_ALLOWLIST;
+    const norm = (k) => (isWin ? k.toUpperCase() : k);
+    const explicit = new Set(passEnv.map((n) => n.trim()).filter((n) => ENV_NAME_PATTERN.test(n)).map(norm));
+    const env = {};
+    let dropped = 0;
+    for (const [key, value] of Object.entries(parentEnv)) {
+        if (value === undefined)
+            continue;
+        const k = norm(key);
+        if (explicit.has(k)) {
+            // Explicit --pass-env is user consent and intentionally overrides the secret filter.
+            env[key] = value;
+            continue;
+        }
+        const allowed = allowlist.has(k) || k.toUpperCase().startsWith('FERRYCAT_');
+        if (allowed && !isSecretEnvName(key)) {
+            env[key] = value;
+        }
+        else {
+            dropped++;
+        }
+    }
+    // Injected lease context always wins over anything inherited.
+    env.FERRYCAT_CONTRACT_ID = contract.contract_id;
+    env.FERRYCAT_TASK_TYPE = contract.task_type;
+    env.FERRYCAT_WORKSPACE_ROOT = contract.workspace_root;
+    env.FERRYCAT_TARGET_AGENT = contract.target_agent;
+    env.FERRYCAT_CLAIM_TOKEN = contract.claim_token ?? '';
+    return { env, dropped };
+}
+const activeChildren = new Set();
+function resolveExecTarget(spec) {
+    const extraArgs = spec.args ?? [];
+    if (spec.execFile) {
+        const script = path.resolve(expandTilde(spec.execFile));
+        const ext = path.extname(script).toLowerCase();
+        if (ext === '.js' || ext === '.mjs' || ext === '.cjs') {
+            return { command: process.execPath, args: [script, ...extraArgs], shell: false };
+        }
+        if (ext === '.ts') {
+            return { command: process.execPath, args: ['--import', 'tsx', script, ...extraArgs], shell: false };
+        }
+        if (ext === '.ps1') {
+            return {
+                command: 'powershell',
+                args: ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', script, ...extraArgs],
+                shell: false,
+            };
+        }
+        if (ext === '.sh') {
+            return { command: 'sh', args: [script, ...extraArgs], shell: false };
+        }
+        return { command: script, args: [...extraArgs], shell: false };
+    }
+    // --exec: explicit shell compatibility mode (FC-303), unchanged semantics.
+    return { command: spec.execCmd, args: [], shell: true };
+}
+function waitWithTimeout(p, ms) {
+    return new Promise((resolve) => {
+        const timer = setTimeout(() => resolve(false), ms);
+        p.then(() => {
+            clearTimeout(timer);
+            resolve(true);
+        });
+    });
+}
+export function createSupervisedChild(child) {
+    let resolveClosed;
+    const closedPromise = new Promise((r) => (resolveClosed = r));
+    const sup = {
+        child,
+        pid: child.pid,
+        startedAt: Date.now(),
+        closed: false,
+        closedPromise,
+    };
+    child.once('close', () => {
+        sup.closed = true;
+        resolveClosed();
+    });
+    return sup;
+}
+/**
+ * Terminate the child's whole process tree and wait until it is confirmed gone.
+ *
+ * PID-reuse safety (CK-05): we ONLY ever signal a tree that we explicitly spawned and still
+ * supervise via its SupervisedChild handle. Bare numeric PID inputs are strictly forbidden
+ * to eliminate inadvertent signaling of recycled OS PIDs.
+ *   - POSIX: the child leads its own process group (detached: true). A PGID cannot be recycled
+ *     while any member is alive, so kill(-pid) cannot hit an unrelated process group.
+ *   - Windows: libuv holds the process handle until exit, so the PID cannot be recycled
+ *     while the leader is alive. Once the leader exited, `taskkill /T` can no longer walk
+ *     the tree; this is the documented non-equivalence vs. Job Objects (audit §1.3).
+ */
+export async function terminateProcessTree(sup, graceMs = 3000) {
+    if (sup.closed)
+        return { skipped: 'ALREADY_EXITED', confirmed: true };
+    const pid = sup.pid;
+    if (!pid)
+        return { skipped: 'NO_PID', confirmed: sup.closed };
+    if (process.platform === 'win32') {
+        spawnSync('taskkill', ['/PID', String(pid), '/T', '/F'], { windowsHide: true, stdio: 'ignore' });
+        const confirmed = await waitWithTimeout(sup.closedPromise, Math.max(2000, graceMs));
+        return { method: 'taskkill /T /F', confirmed };
+    }
+    const signalGroup = (sig) => {
+        try {
+            process.kill(-pid, sig);
+            return true;
+        }
+        catch {
+            return false; // ESRCH: group already empty
+        }
+    };
+    signalGroup('SIGTERM');
+    if (await waitWithTimeout(sup.closedPromise, graceMs)) {
+        return { method: 'SIGTERM(-pgid)', confirmed: true };
+    }
+    signalGroup('SIGKILL');
+    const confirmed = await waitWithTimeout(sup.closedPromise, 2000);
+    return { method: 'SIGTERM->SIGKILL(-pgid)', confirmed };
+}
+/**
+ * Synchronous last-resort cleanup for a forced worker exit (second Ctrl+C). Because POSIX
+ * children now run in their own process group, terminal SIGINT no longer reaches them, so
+ * the worker must take them down explicitly instead of orphaning them.
+ */
+export function terminateActiveChildrenSync() {
+    let count = 0;
+    for (const sup of activeChildren) {
+        if (sup.closed || !sup.pid)
+            continue;
+        count++;
+        if (process.platform === 'win32') {
+            spawnSync('taskkill', ['/PID', String(sup.pid), '/T', '/F'], { windowsHide: true, stdio: 'ignore' });
+        }
+        else {
+            try {
+                process.kill(-sup.pid, 'SIGKILL');
+            }
+            catch {
+                // group already gone
+            }
+        }
+    }
+    return count;
+}
+// ---------------------------------------------------------------------------
+// Execution with heartbeat lease (CK-01 / CK-02 / CK-03 / CK-07)
+// ---------------------------------------------------------------------------
+const SALVAGE_TAIL_CHARS = 256 * 1024;
+function clamp(n, lo, hi) {
+    return Math.min(hi, Math.max(lo, n));
+}
+function stripBom(content) {
+    return content.charCodeAt(0) === 0xfeff ? content.slice(1) : content;
+}
+export async function executeTaskAndFulfill(engine, contract, spec, opts = {}) {
+    const emit = (event) => {
+        try {
+            opts.onEvent?.({ contract_id: contract.contract_id, ...event });
+        }
+        catch {
+            // observability must never affect lifecycle correctness
+        }
+    };
+    const effectiveTtlSec = opts.execTtlSec
+        ? Math.min(contract.exec_ttl_sec, opts.execTtlSec)
+        : contract.exec_ttl_sec;
+    const ttlMs = effectiveTtlSec * 1000;
+    const tickMs = opts.heartbeatIntervalMs ?? Math.max(100, Math.min(60000, Math.floor(ttlMs / 3)));
+    const graceMs = opts.killGraceMs ?? clamp(Math.floor(ttlMs / 10), 200, 3000);
+    // The guard fires early enough to terminate (grace) AND report failure before the window closes.
+    const guardLeadMs = graceMs + clamp(Math.floor(ttlMs / 10), 200, 2000);
+    const renewSlackMs = Math.min(1000, Math.floor(tickMs / 2));
+    const maxBuffer = opts.maxBufferBytes ?? 10 * 1024 * 1024;
+    const label = spec.execFile ?? spec.execCmd ?? 'exec';
+    const token = contract.claim_token;
+    const { env, dropped } = buildChildEnv(contract, spec.passEnv ?? []);
+    emit({ event: 'ENV_SANITIZED', dropped_vars: dropped, passed_explicitly: spec.passEnv?.length ?? 0 });
+    const target = resolveExecTarget(spec);
+    let child;
+    try {
+        child = spawn(target.command, target.args, {
+            env,
+            shell: target.shell,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            detached: process.platform !== 'win32',
+            windowsHide: true,
+        });
+    }
+    catch (spawnErr) {
+        return failAfterExit(`External exec command failed to start: ${spawnErr instanceof Error ? spawnErr.message : String(spawnErr)}`);
+    }
+    let resolveClosed;
+    const closedPromise = new Promise((r) => (resolveClosed = r));
+    const sup = {
+        child,
+        pid: child.pid,
+        startedAt: Date.now(),
+        closed: false,
+        closedPromise,
+    };
+    activeChildren.add(sup);
+    emit({ event: 'CHILD_SPAWNED', pid: sup.pid ?? null, started_at: sup.startedAt, tick_ms: tickMs });
+    let stdout = '';
+    let stderr = '';
+    let stdoutBytes = 0;
+    let abort = null;
+    let salvaged = false;
+    let windowEndsAt = (contract.claimed_at ?? Date.now()) + ttlMs;
+    let budgetExhausted = false;
+    let tickTimer;
+    let guardTimer;
+    const exitInfo = new Promise((resolve) => {
+        let settled = false;
+        const settle = (v) => {
+            if (settled)
+                return;
+            settled = true;
+            sup.closed = true;
+            resolveClosed();
+            resolve(v);
+        };
+        child.on('error', (error) => settle({ code: null, signal: null, error }));
+        child.on('close', (code, signal) => settle({ code, signal }));
+    });
+    const stopTimers = () => {
+        if (tickTimer)
+            clearInterval(tickTimer);
+        if (guardTimer)
+            clearTimeout(guardTimer);
+        tickTimer = undefined;
+        guardTimer = undefined;
+    };
+    const salvageNow = (source) => {
+        if (!stdout && !stderr)
+            return;
+        try {
+            const ok = engine.recordSalvage({
+                contract_id: contract.contract_id,
+                agent_id: contract.target_agent,
+                claim_token: token,
+                salvage: {
+                    source,
+                    captured_at: Date.now(),
+                    pid: sup.pid ?? null,
+                    started_at: sup.startedAt,
+                    stdout_bytes: stdoutBytes,
+                    truncated: stdout.length > SALVAGE_TAIL_CHARS,
+                    stdout_tail: stdout.slice(-SALVAGE_TAIL_CHARS),
+                    stderr_tail: stderr.slice(-16 * 1024),
+                },
+            });
+            salvaged = salvaged || ok;
+        }
+        catch (err) {
+            emit({ event: 'SALVAGE_FAILED', error: err instanceof Error ? err.message : String(err) });
+        }
+    };
+    const triggerAbort = (kind, reason) => {
+        if (abort)
+            return;
+        abort = { kind, reason };
+        stopTimers();
+        salvageNow(kind);
+        emit({ event: 'CHILD_TERMINATING', kind, reason });
+        void terminateProcessTree(sup, graceMs).then((r) => emit({ event: 'CHILD_TERMINATED', ...r }));
+    };
+    const armGuard = () => {
+        if (guardTimer)
+            clearTimeout(guardTimer);
+        const delay = Math.max(0, windowEndsAt - guardLeadMs - Date.now());
+        guardTimer = setTimeout(() => {
+            triggerAbort('WINDOW_EXHAUSTED', budgetExhausted
+                ? 'EXEC_WINDOW_EXHAUSTED: heartbeat renewal budget exhausted (max extends or lifetime cap); child terminated before the window closed'
+                : 'EXEC_WINDOW_EXHAUSTED: execution window about to close without a successful renewal; child terminated');
+        }, delay);
+    };
+    /** Re-read the row; returns true if we still hold the lease (and syncs the window). */
+    const stillOwnsLease = () => {
+        const snap = engine.getLeaseSnapshot(contract.contract_id);
+        if (!snap || snap.status !== 'CLAIMED')
+            return false;
+        if (snap.claim_token && token && snap.claim_token !== token)
+            return false;
+        if (snap.claimed_at !== null) {
+            const synced = snap.claimed_at + snap.exec_ttl_sec * 1000;
+            if (synced !== windowEndsAt) {
+                windowEndsAt = synced;
+                armGuard();
+            }
+        }
+        return true;
+    };
+    const tick = () => {
+        if (abort)
+            return;
+        try {
+            if (!stillOwnsLease()) {
+                triggerAbort('LEASE_LOST', 'LEASE_LOST: contract is no longer CLAIMED under this claim_token');
+                return;
+            }
+            if (budgetExhausted)
+                return;
+            // Lazy renewal: only spend one of the MAX_TTL_EXTENSIONS when the next tick would land
+            // inside the guard lead. Renewing on every tick would burn the 5-extension budget in
+            // under two windows (CK-01 acceptance: ttl=30s, tick=10s, 120s run must complete).
+            const headroom = windowEndsAt - guardLeadMs - Date.now();
+            if (headroom > tickMs + renewSlackMs)
+                return;
+            const res = engine.extendTtl({
+                contract_id: contract.contract_id,
+                agent_id: contract.target_agent,
+                claim_token: token,
+            });
+            if (res.ok && res.expires_at) {
+                windowEndsAt = res.expires_at;
+                armGuard();
+                emit({ event: 'HEARTBEAT_RENEWED', extend_count: res.extend_count, expires_at: res.expires_at });
+            }
+            else if (res.status === 'TIMED_OUT') {
+                triggerAbort('LEASE_LOST', `LEASE_LOST: ${res.message}`);
+            }
+            else {
+                // CK-02 reverse binding: ok:false while still CLAIMED (extend cap / lifetime cap).
+                // Stop renewing; the guard (already armed for the current window) will terminate
+                // the tree before the window closes instead of leaving an orphan behind.
+                budgetExhausted = true;
+                if (res.expires_at)
+                    windowEndsAt = res.expires_at;
+                armGuard();
+                emit({ event: 'HEARTBEAT_EXHAUSTED', message: res.message });
+            }
+        }
+        catch (err) {
+            // CK-03: optimistic-lock conflicts throw; never let a heartbeat kill the worker.
+            const message = err instanceof Error ? err.message : String(err);
+            emit({ event: 'HEARTBEAT_ERROR', error: message });
+            try {
+                if (!stillOwnsLease()) {
+                    triggerAbort('LEASE_LOST', `LEASE_LOST: ${message}`);
+                }
+            }
+            catch (readErr) {
+                emit({ event: 'HEARTBEAT_ERROR', error: readErr instanceof Error ? readErr.message : String(readErr) });
+            }
+        }
+    };
+    child.stdout?.setEncoding('utf8');
+    child.stderr?.setEncoding('utf8');
+    child.stdout?.on('data', (chunk) => {
+        stdoutBytes += Buffer.byteLength(chunk, 'utf8');
+        if (stdoutBytes > maxBuffer) {
+            triggerAbort('MAX_BUFFER', `stdout exceeded maxBuffer (${maxBuffer} bytes)`);
+            return;
+        }
+        stdout += chunk;
+    });
+    child.stderr?.on('data', (chunk) => {
+        stderr = (stderr + chunk).slice(-64 * 1024);
+    });
+    if (child.stdin) {
+        child.stdin.on('error', () => {
+            // Child exited without consuming stdin, ignore EPIPE
+        });
+        child.stdin.write(JSON.stringify(contract));
+        child.stdin.end();
+    }
+    armGuard();
+    tickTimer = setInterval(tick, tickMs);
+    const exit = await exitInfo;
+    stopTimers();
+    activeChildren.delete(sup);
+    if (exit.error) {
+        return failAfterExit(`External exec command failed with code ${exit.error.code ?? 1}: ${exit.error.message}`);
+    }
+    const abortState = abort;
+    if (abortState?.kind === 'LEASE_LOST') {
+        return { ok: false, status: 'LEASE_LOST', error: abortState.reason, salvaged };
+    }
+    if (abortState) {
+        const res = failAfterExit(`${abortState.reason}${stderr ? ` | stderr: ${stderr.slice(-1000)}` : ''}`);
+        res.status = abortState.kind === 'MAX_BUFFER' ? 'EXEC_FAILED' : 'EXEC_WINDOW_EXHAUSTED';
+        res.salvaged = salvaged;
+        return res;
+    }
+    if (exit.code !== 0) {
+        salvageNow('NON_ZERO_EXIT');
+        const exitDesc = exit.signal
+            ? `terminated by signal ${exit.signal}`
+            : `failed with code ${exit.code ?? 1}`;
+        return failAfterExit(`External exec command ${exitDesc}: ${stderr || 'no stderr output'}`);
+    }
+    return fulfillFromStdout();
+    // -------------------------------------------------------------------------
+    function failAfterExit(reason) {
+        let contractStatus;
+        try {
+            contractStatus = engine.failContract({
+                contract_id: contract.contract_id,
+                agent_id: contract.target_agent,
+                claim_token: token,
+                reason: reason.slice(0, 2000),
+            }).status;
+        }
+        catch (failErr) {
+            contractStatus = `UNCHANGED (${failErr instanceof Error ? failErr.message : String(failErr)})`;
+        }
+        return { ok: false, status: 'EXEC_FAILED', error: reason, contract_status: contractStatus, salvaged };
+    }
+    function fulfillFromStdout() {
+        let structuredOutput;
+        let resultSummary = stripBom(stdout).trim();
+        try {
+            const parsed = JSON.parse(resultSummary);
+            if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+                if (parsed.structured_output && typeof parsed.structured_output === 'object') {
+                    structuredOutput = parsed.structured_output;
+                }
+                else {
+                    structuredOutput = parsed;
+                }
+                if (parsed.result_summary && typeof parsed.result_summary === 'string') {
+                    resultSummary = parsed.result_summary;
+                }
+            }
+        }
+        catch {
+            // Plain text stdout, fallback to result_summary
+        }
+        const boundedSummary = (resultSummary || `Completed via automated worker exec: ${label}`).slice(0, 20000);
+        try {
+            const validatedFulfillInput = FulfillContractSchema.parse({
+                contract_id: contract.contract_id,
+                agent_id: contract.target_agent,
+                claim_token: token,
+                result_summary: boundedSummary,
+                structured_output: structuredOutput,
+            });
+            let fulfillRes = engine.fulfillContract(validatedFulfillInput);
+            if (fulfillRes.status === 'RETRY_NEEDED') {
+                // RETRY_NEEDED has two distinct causes with incompatible retry semantics:
+                //   (a) schema validation failure -> retry_count increments, so retrying the
+                //       same payload until the breaker trips is the intended behavior.
+                //   (b) TOCTOU dirty pointers     -> retry_count does NOT move. The on-disk
+                //       baseline cannot heal between two consecutive calls, so retrying only
+                //       burns the single ADR-0004 strike and forces a terminal POINTER_STALE
+                //       with nobody in the loop to restore the files. Never auto-retry it.
+                const isToctouRejection = (fulfillRes.toctou_strike ?? 0) > 0 && (fulfillRes.retry_count ?? 0) === 0;
+                if (isToctouRejection) {
+                    return {
+                        ok: false,
+                        status: 'TOCTOU_RESCUE_REQUIRED',
+                        fulfill_result: fulfillRes,
+                        error: 'Automated exec mutated pointer files. The contract stays CLAIMED with a renewed execution window. Restore the files (git stash / git checkout) and re-run, or deliver edits via structured_output.fixes instead of writing to the workspace.',
+                    };
+                }
+                const maxAttempts = (fulfillRes.max_retries ?? 2) + 1;
+                for (let i = fulfillRes.retry_count ?? 1; i < maxAttempts; i++) {
+                    fulfillRes = engine.fulfillContract(validatedFulfillInput);
+                    if (fulfillRes.status !== 'RETRY_NEEDED')
+                        break;
+                }
+            }
+            return { ok: fulfillRes.ok, status: fulfillRes.status, fulfill_result: fulfillRes };
+        }
+        catch (fulfillErr) {
+            const fulfillError = fulfillErr instanceof Error ? fulfillErr.message : String(fulfillErr);
+            const res = failAfterExit(`FULFILL_ERROR: ${fulfillError}`);
+            return { ...res, status: 'FULFILL_ERROR', error: fulfillError };
+        }
+    }
+}
+//# sourceMappingURL=supervisor.js.map

package/dist/supervisor.js.map

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

package/dist/types.d.ts

@@ -82,6 +82,7 @@ export interface DispatchContractResult {
 }
 export interface PollNextTaskInput {
     agent_id?: string;
+    task_types?: TaskType[];
 }
 export interface PollNextTaskResult {
     has_task: boolean;
@@ -201,3 +202,43 @@ export interface InspectMeshStateInput {
     status?: ContractStatus | 'ACTIVE' | 'ALL';
     limit?: number;
 }
+export interface DaemonLockRow {
+    id: string;
+    owner_token: string;
+    heartbeat_at: number;
+    expires_at: number;
+    metadata_json: string | null;
+}
+export interface AcquireDaemonLeaseInput {
+    lock_id?: string;
+    owner_token: string;
+    ttl_sec?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface AcquireDaemonLeaseResult {
+    ok: boolean;
+    lock_id: string;
+    owner_token: string;
+    expires_at: number;
+    message?: string;
+}
+export interface RenewDaemonLeaseInput {
+    lock_id?: string;
+    owner_token: string;
+    ttl_sec?: number;
+}
+export interface RenewDaemonLeaseResult {
+    ok: boolean;
+    lock_id: string;
+    expires_at: number;
+    message?: string;
+}
+export interface ReleaseDaemonLeaseInput {
+    lock_id?: string;
+    owner_token: string;
+}
+export interface ReleaseDaemonLeaseResult {
+    ok: boolean;
+    lock_id: string;
+    message?: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ferrycat",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "mcpName": "io.github.GuoBug/ferrycat",
   "description": "FerryCat: Contract-driven cross-host AI agent handoff & review bus over MCP and SQLite WAL",
   "type": "module",
@@ -21,6 +21,7 @@
   "scripts": {
     "build": "tsc",
     "prepack": "npm run build",
+    "bump": "node scripts/bump-version.js",
     "start": "node --experimental-sqlite dist/index.js",
     "test": "node --experimental-sqlite --import tsx test/run-all.ts"
   },