@pleri/olam-cli 0.1.119 → 0.1.125

package/dist/commands/memory/logs.js

@@ -0,0 +1,45 @@
+/**
+ * olam memory logs — tail ~/.olam/memory-service.log.
+ *
+ * --follow (alias -f): tail -f-style; Ctrl-C to stop.
+ * --tail N (default 50): last N lines.
+ *
+ * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md A2
+ */
+import { existsSync } from 'node:fs';
+import { spawn } from 'node:child_process';
+import { printWarning, printHeader } from '../../output.js';
+import { MEMORY_LOG_PATH } from './_paths.js';
+export async function runMemoryLogs(opts) {
+    if (!existsSync(MEMORY_LOG_PATH)) {
+        printWarning(`no log at ${MEMORY_LOG_PATH} (start the service first via 'olam memory start')`);
+        return 1;
+    }
+    const tailN = opts.tail ? parseInt(opts.tail, 10) : 50;
+    if (!Number.isFinite(tailN) || tailN < 0) {
+        printWarning(`invalid --tail value: ${opts.tail}`);
+        return 1;
+    }
+    const args = ['-n', `${tailN}`];
+    if (opts.follow)
+        args.push('-f');
+    args.push(MEMORY_LOG_PATH);
+    printHeader(`olam memory logs (${opts.follow ? 'follow' : `tail -n ${tailN}`})`);
+    const child = spawn('tail', args, { stdio: 'inherit' });
+    return new Promise((resolve) => {
+        child.on('exit', (code) => resolve(code ?? 0));
+    });
+}
+export function registerMemoryLogs(cmd) {
+    cmd
+        .command('logs')
+        .description('Tail the memory service log file at ~/.olam/memory-service.log')
+        .option('-f, --follow', 'Stream new log lines (Ctrl-C to stop)', false)
+        .option('--tail <n>', 'Number of trailing lines (default 50)', '50')
+        .action(async (opts) => {
+        const rc = await runMemoryLogs(opts);
+        if (rc !== 0)
+            process.exitCode = rc;
+    });
+}
+//# sourceMappingURL=logs.js.map

package/dist/commands/memory/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../../src/commands/memory/logs.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAyC;IAC3E,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACjC,YAAY,CAAC,aAAa,eAAe,oDAAoD,CAAC,CAAC;QAC/F,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACzC,YAAY,CAAC,yBAAyB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACnD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAChC,IAAI,IAAI,CAAC,MAAM;QAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAE3B,WAAW,CAAC,qBAAqB,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,KAAK,EAAE,GAAG,CAAC,CAAC;IACjF,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACxD,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QACrC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC7C,GAAG;SACA,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,gEAAgE,CAAC;SAC7E,MAAM,CAAC,cAAc,EAAE,uCAAuC,EAAE,KAAK,CAAC;SACtE,MAAM,CAAC,YAAY,EAAE,uCAAuC,EAAE,IAAI,CAAC;SACnE,MAAM,CAAC,KAAK,EAAE,IAAyC,EAAE,EAAE;QAC1D,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,EAAE,KAAK,CAAC;YAAE,OAAO,CAAC,QAAQ,GAAG,EAAE,CAAC;IACtC,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/memory/secret.d.ts

@@ -0,0 +1,16 @@
+/**
+ * olam memory secret — show or rotate the bearer secret at ~/.olam/memory-secret.
+ *
+ * Subcommands:
+ *   show     — print the current secret value (use with care; do not pipe to logs)
+ *   rotate   — generate a fresh secret + restart the running memory service so
+ *              it picks up the new value. Worlds created BEFORE the rotation
+ *              continue to use the old value until they're re-created.
+ *
+ * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md A3
+ */
+import type { Command } from 'commander';
+export declare function runMemorySecretShow(): Promise<number>;
+export declare function runMemorySecretRotate(): Promise<number>;
+export declare function registerMemorySecret(cmd: Command): void;
+//# sourceMappingURL=secret.d.ts.map

package/dist/commands/memory/secret.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secret.d.ts","sourceRoot":"","sources":["../../../src/commands/memory/secret.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAazC,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC,CAU3D;AAED,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,CAoC7D;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAsBvD"}

package/dist/commands/memory/secret.js

@@ -0,0 +1,79 @@
+/**
+ * olam memory secret — show or rotate the bearer secret at ~/.olam/memory-secret.
+ *
+ * Subcommands:
+ *   show     — print the current secret value (use with care; do not pipe to logs)
+ *   rotate   — generate a fresh secret + restart the running memory service so
+ *              it picks up the new value. Worlds created BEFORE the rotation
+ *              continue to use the old value until they're re-created.
+ *
+ * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md A3
+ */
+import { existsSync } from 'node:fs';
+import { MEMORY_SECRET_PATH, hasMemorySecret, readMemorySecret, rotateMemorySecret, } from '../../lib/memory-secret.js';
+import { printError, printSuccess, printInfo, printWarning, printHeader } from '../../output.js';
+import { runMemoryStart } from './start.js';
+import { runMemoryStop } from './stop.js';
+import { MEMORY_PID_PATH } from './_paths.js';
+export async function runMemorySecretShow() {
+    if (!hasMemorySecret()) {
+        printError(`secret missing at ${MEMORY_SECRET_PATH}. Run 'olam memory start' to generate it.`);
+        return 1;
+    }
+    // Plain stdout so it's pipeable; helper helpers go to stderr in the lib.
+    process.stdout.write(`${readMemorySecret()}\n`);
+    return 0;
+}
+export async function runMemorySecretRotate() {
+    printHeader('olam memory secret rotate');
+    const wasRunning = existsSync(MEMORY_PID_PATH);
+    if (wasRunning) {
+        printInfo('current state', 'service running; will restart with new secret');
+        const stopRc = await runMemoryStop();
+        if (stopRc !== 0) {
+            printError('failed to stop the running service; rotation aborted to avoid split-brain');
+            return stopRc;
+        }
+    }
+    else {
+        printInfo('current state', 'service stopped');
+    }
+    const fresh = rotateMemorySecret();
+    printSuccess(`secret rotated (${fresh.length / 2}-byte hex written to ${MEMORY_SECRET_PATH})`);
+    if (wasRunning) {
+        printInfo('restarting', 'memory service with new secret');
+        const startRc = await runMemoryStart();
+        if (startRc !== 0) {
+            printError('service failed to restart after rotation. The new secret is on disk; run `olam memory start` once you fix the underlying issue.');
+            return startRc;
+        }
+    }
+    else {
+        printWarning('service was not running; new secret will be picked up on next `olam memory start`');
+    }
+    // Heads-up: worlds created before this rotation still have the old value in env.
+    printWarning('worlds created BEFORE this rotation still have the old secret in their env. Re-create them (olam destroy + olam create) to pick up the new value.');
+    return 0;
+}
+export function registerMemorySecret(cmd) {
+    const secret = cmd
+        .command('secret')
+        .description('Show or rotate the bearer secret at ~/.olam/memory-secret');
+    secret
+        .command('show')
+        .description('Print the current secret value (use with care; do not pipe to logs)')
+        .action(async () => {
+        const rc = await runMemorySecretShow();
+        if (rc !== 0)
+            process.exitCode = rc;
+    });
+    secret
+        .command('rotate')
+        .description('Regenerate the secret and restart the running memory service (worlds created before rotation must be re-created)')
+        .action(async () => {
+        const rc = await runMemorySecretRotate();
+        if (rc !== 0)
+            process.exitCode = rc;
+    });
+}
+//# sourceMappingURL=secret.js.map

package/dist/commands/memory/secret.js.map

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

package/dist/commands/memory/start.d.ts

@@ -0,0 +1,23 @@
+/**
+ * olam memory start — spawn agentmemory as a managed host child process.
+ *
+ * Flow:
+ *   1. Ensure iii v0.11.2 binary at ~/.olam/bin/iii (calls A1's ensure-iii-engine.mjs equivalent)
+ *   2. Ensure ~/.olam/memory-secret (0600) exists
+ *   3. Locate packages/memory-service/ (the npm-installed agentmemory)
+ *   4. Spawn `agentmemory` (the bin from @agentmemory/agentmemory@0.9.6) with:
+ *        env: { AGENTMEMORY_SECRET, PATH: ~/.olam/bin:$PATH, ...inherit }
+ *        cwd: ~/.olam (so agentmemory writes state under ~/.olam/data/)
+ *        stdio: append to ~/.olam/memory-service.log
+ *        detached: true so the child outlives this CLI invocation
+ *   5. Write child pid to ~/.olam/memory.pid
+ *   6. Poll http://localhost:3111/agentmemory/livez until 200 (timeout 30s)
+ *
+ * Idempotent: re-running while the service is healthy prints status and exits 0.
+ *
+ * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md A2
+ */
+import type { Command } from 'commander';
+export declare function runMemoryStart(): Promise<number>;
+export declare function registerMemoryStart(cmd: Command): void;
+//# sourceMappingURL=start.d.ts.map

package/dist/commands/memory/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../src/commands/memory/start.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwFzC,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CA6EtD;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAQtD"}

package/dist/commands/memory/start.js

@@ -0,0 +1,166 @@
+/**
+ * olam memory start — spawn agentmemory as a managed host child process.
+ *
+ * Flow:
+ *   1. Ensure iii v0.11.2 binary at ~/.olam/bin/iii (calls A1's ensure-iii-engine.mjs equivalent)
+ *   2. Ensure ~/.olam/memory-secret (0600) exists
+ *   3. Locate packages/memory-service/ (the npm-installed agentmemory)
+ *   4. Spawn `agentmemory` (the bin from @agentmemory/agentmemory@0.9.6) with:
+ *        env: { AGENTMEMORY_SECRET, PATH: ~/.olam/bin:$PATH, ...inherit }
+ *        cwd: ~/.olam (so agentmemory writes state under ~/.olam/data/)
+ *        stdio: append to ~/.olam/memory-service.log
+ *        detached: true so the child outlives this CLI invocation
+ *   5. Write child pid to ~/.olam/memory.pid
+ *   6. Poll http://localhost:3111/agentmemory/livez until 200 (timeout 30s)
+ *
+ * Idempotent: re-running while the service is healthy prints status and exits 0.
+ *
+ * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md A2
+ */
+import { spawn } from 'node:child_process';
+import { existsSync, mkdirSync, openSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { printError, printSuccess, printInfo, printHeader } from '../../output.js';
+import { ensureMemorySecret } from '../../lib/memory-secret.js';
+import { III_BINARY_PATH, MEMORY_DATA_DIR, MEMORY_LIVEZ_URL, MEMORY_LOG_PATH, MEMORY_PID_PATH, MEMORY_SERVICE_CANDIDATES, OLAM_BIN_DIR, OLAM_HOME, } from './_paths.js';
+const READINESS_TIMEOUT_MS = 30_000;
+const READINESS_POLL_MS = 500;
+function resolveMemoryServiceDir() {
+    for (const c of MEMORY_SERVICE_CANDIDATES) {
+        if (existsSync(c))
+            return c;
+    }
+    throw new Error(`Could not find packages/memory-service/. Searched: ${MEMORY_SERVICE_CANDIDATES.join(', ')}. ` +
+        `If running from a published @pleri/olam-cli tarball, this is a packaging bug — please file an issue.`);
+}
+function resolveAgentMemoryBin(serviceDir) {
+    // npm hoists @agentmemory/agentmemory to the workspace root in monorepo mode.
+    // Search likely locations in order.
+    const candidates = [
+        join(serviceDir, 'node_modules', '.bin', 'agentmemory'),
+        join(serviceDir, '..', '..', 'node_modules', '.bin', 'agentmemory'),
+        join(serviceDir, '..', '..', '..', 'node_modules', '.bin', 'agentmemory'),
+    ];
+    for (const c of candidates) {
+        if (existsSync(c))
+            return c;
+    }
+    throw new Error(`Could not find agentmemory bin. Searched: ${candidates.join(', ')}. ` +
+        `Run 'npm install' from the repo root.`);
+}
+function isProcessAlive(pid) {
+    try {
+        // signal 0 doesn't deliver; just tests existence + permission
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function readPidFromFile() {
+    if (!existsSync(MEMORY_PID_PATH))
+        return null;
+    const raw = readFileSync(MEMORY_PID_PATH, 'utf8').trim();
+    const pid = parseInt(raw, 10);
+    if (!Number.isFinite(pid) || pid <= 0)
+        return null;
+    return pid;
+}
+async function probeLivez(secret, signal) {
+    try {
+        const resp = await fetch(MEMORY_LIVEZ_URL, {
+            headers: { authorization: `Bearer ${secret}` },
+            signal,
+        });
+        if (!resp.ok)
+            return false;
+        const body = (await resp.json());
+        return body.status === 'ok';
+    }
+    catch {
+        return false;
+    }
+}
+async function waitForReady(secret) {
+    const deadline = Date.now() + READINESS_TIMEOUT_MS;
+    while (Date.now() < deadline) {
+        if (await probeLivez(secret))
+            return true;
+        await new Promise((r) => setTimeout(r, READINESS_POLL_MS));
+    }
+    return false;
+}
+export async function runMemoryStart() {
+    printHeader('olam memory start');
+    // 1. iii binary (A1's deliverable)
+    if (!existsSync(III_BINARY_PATH)) {
+        printError(`iii binary missing at ${III_BINARY_PATH}. Run: node packages/memory-service/scripts/ensure-iii-engine.mjs`);
+        return 1;
+    }
+    printInfo('iii binary', III_BINARY_PATH);
+    // 2. Secret (A3 lib)
+    const secret = ensureMemorySecret();
+    printInfo('secret', '~/.olam/memory-secret (0600)');
+    // 3. Locate the service + agentmemory bin
+    const serviceDir = resolveMemoryServiceDir();
+    const agentmemoryBin = resolveAgentMemoryBin(serviceDir);
+    printInfo('agentmemory', agentmemoryBin);
+    // 4. Idempotency: already running?
+    const existingPid = readPidFromFile();
+    if (existingPid !== null && isProcessAlive(existingPid)) {
+        const ready = await probeLivez(secret);
+        if (ready) {
+            printSuccess(`already running (pid ${existingPid}); /agentmemory/livez ok`);
+            return 0;
+        }
+        // Pidfile points at a live process that isn't responding — leave it alone, error out.
+        printError(`pid ${existingPid} is alive but /agentmemory/livez isn't responding. ` +
+            `Run 'olam memory stop' to clear, then retry.`);
+        return 1;
+    }
+    // 5. Ensure dirs exist
+    mkdirSync(OLAM_HOME, { recursive: true });
+    mkdirSync(MEMORY_DATA_DIR, { recursive: true });
+    // 6. Spawn detached, redirect output to log file (append).
+    const logFd = openSync(MEMORY_LOG_PATH, 'a');
+    const child = spawn(agentmemoryBin, [], {
+        cwd: OLAM_HOME,
+        env: {
+            ...process.env,
+            AGENTMEMORY_SECRET: secret,
+            PATH: `${OLAM_BIN_DIR}:${process.env.PATH ?? ''}`,
+        },
+        stdio: ['ignore', logFd, logFd],
+        detached: true,
+    });
+    child.unref();
+    if (child.pid === undefined) {
+        printError('spawn returned no pid (process failed to start)');
+        return 1;
+    }
+    // 7. Persist pid
+    writeFileSync(MEMORY_PID_PATH, `${child.pid}\n`, { mode: 0o644 });
+    printInfo('pid', `${child.pid}`);
+    // 8. Wait for readiness
+    printInfo('readiness', `polling ${MEMORY_LIVEZ_URL}`);
+    const ready = await waitForReady(secret);
+    if (!ready) {
+        printError(`agentmemory failed to come up within ${READINESS_TIMEOUT_MS / 1000}s. ` +
+            `Inspect ${MEMORY_LOG_PATH} for engine errors.`);
+        return 1;
+    }
+    printSuccess(`memory service ready (pid ${child.pid}; logs at ${MEMORY_LOG_PATH})`);
+    return 0;
+}
+export function registerMemoryStart(cmd) {
+    cmd
+        .command('start')
+        .description('Start the host agent-memory process (idempotent; polls livez until ready)')
+        .action(async () => {
+        const rc = await runMemoryStart();
+        if (rc !== 0)
+            process.exitCode = rc;
+    });
+}
+//# sourceMappingURL=start.js.map

package/dist/commands/memory/start.js.map

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

package/dist/commands/memory/status.d.ts

@@ -0,0 +1,25 @@
+/**
+ * olam memory status — diagnostic dump for the host memory service.
+ *
+ * Reports: pidfile state, process liveness, /agentmemory/livez response,
+ * secret-set Y/N, iii binary location, REST port. Intended for both
+ * humans (default output) and machines (--json).
+ *
+ * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md A2
+ */
+import type { Command } from 'commander';
+interface MemoryStatus {
+    pid: number | null;
+    alive: boolean | null;
+    livez: 'ok' | 'unreachable' | 'unauthorized' | 'unknown';
+    secretSet: boolean;
+    iiiBinary: string | null;
+    port: number;
+}
+export declare function collectMemoryStatus(): Promise<MemoryStatus>;
+export declare function runMemoryStatus(opts?: {
+    json?: boolean;
+}): Promise<number>;
+export declare function registerMemoryStatus(cmd: Command): void;
+export {};
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/memory/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/memory/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWzC,UAAU,YAAY;IACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,IAAI,GAAG,aAAa,GAAG,cAAc,GAAG,SAAS,CAAC;IACzD,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAyBD,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,YAAY,CAAC,CAkBjE;AAED,wBAAsB,eAAe,CAAC,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAgCpF;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CASvD"}

package/dist/commands/memory/status.js

@@ -0,0 +1,101 @@
+/**
+ * olam memory status — diagnostic dump for the host memory service.
+ *
+ * Reports: pidfile state, process liveness, /agentmemory/livez response,
+ * secret-set Y/N, iii binary location, REST port. Intended for both
+ * humans (default output) and machines (--json).
+ *
+ * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md A2
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { printError, printInfo, printHeader, printWarning } from '../../output.js';
+import { hasMemorySecret, readMemorySecretOrNull } from '../../lib/memory-secret.js';
+import { III_BINARY_PATH, MEMORY_LIVEZ_URL, MEMORY_PID_PATH, MEMORY_REST_PORT, } from './_paths.js';
+function isAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function probe(secret) {
+    try {
+        const headers = {};
+        if (secret)
+            headers.authorization = `Bearer ${secret}`;
+        const resp = await fetch(MEMORY_LIVEZ_URL, { headers });
+        if (resp.status === 401)
+            return 'unauthorized';
+        if (!resp.ok)
+            return 'unknown';
+        const body = (await resp.json());
+        return body.status === 'ok' ? 'ok' : 'unknown';
+    }
+    catch {
+        return 'unreachable';
+    }
+}
+export async function collectMemoryStatus() {
+    let pid = null;
+    if (existsSync(MEMORY_PID_PATH)) {
+        const raw = readFileSync(MEMORY_PID_PATH, 'utf8').trim();
+        const parsed = parseInt(raw, 10);
+        pid = Number.isFinite(parsed) && parsed > 0 ? parsed : null;
+    }
+    const alive = pid === null ? null : isAlive(pid);
+    const secret = readMemorySecretOrNull();
+    const livez = await probe(secret);
+    return {
+        pid,
+        alive,
+        livez,
+        secretSet: hasMemorySecret(),
+        iiiBinary: existsSync(III_BINARY_PATH) ? III_BINARY_PATH : null,
+        port: MEMORY_REST_PORT,
+    };
+}
+export async function runMemoryStatus(opts = {}) {
+    const s = await collectMemoryStatus();
+    if (opts.json) {
+        process.stdout.write(JSON.stringify(s, null, 2) + '\n');
+        return s.livez === 'ok' ? 0 : 1;
+    }
+    printHeader('olam memory status');
+    printInfo('pid', s.pid === null ? '(no pidfile)' : `${s.pid}`);
+    printInfo('alive', s.alive === null ? 'n/a' : s.alive ? 'yes' : 'no (stale pidfile)');
+    printInfo('livez', s.livez);
+    printInfo('secret', s.secretSet ? '~/.olam/memory-secret (set)' : '(missing)');
+    printInfo('iii', s.iiiBinary ?? '(not installed)');
+    printInfo('port', `${s.port}`);
+    if (s.livez === 'ok' && s.alive)
+        return 0;
+    if (s.livez === 'unauthorized') {
+        printWarning('livez returned 401 — the memory service is up but the local secret does not match. Try `olam memory secret rotate`.');
+        return 1;
+    }
+    if (s.alive === false && s.pid !== null) {
+        printWarning('pidfile points at a dead process; run `olam memory stop` to clean up');
+        return 1;
+    }
+    if (!s.iiiBinary) {
+        printWarning('iii binary missing; run `node packages/memory-service/scripts/ensure-iii-engine.mjs`');
+    }
+    if (!s.secretSet) {
+        printWarning('secret missing; `olam memory start` will generate it');
+    }
+    return s.livez === 'ok' ? 0 : 1;
+}
+export function registerMemoryStatus(cmd) {
+    cmd
+        .command('status')
+        .description('Diagnostic dump for the host memory service (pid + livez + secret-set check)')
+        .option('--json', 'Machine-readable JSON output', false)
+        .action(async (opts) => {
+        const rc = await runMemoryStatus(opts);
+        if (rc !== 0)
+            process.exitCode = rc;
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/memory/status.js.map

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

package/dist/commands/memory/stop.d.ts

@@ -0,0 +1,12 @@
+/**
+ * olam memory stop — terminate the host agent-memory process gracefully.
+ *
+ * SIGTERM → wait 10s → SIGKILL. Removes the pidfile on clean exit.
+ * Idempotent: no pidfile or stale pidfile → exit 0 with informational message.
+ *
+ * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md A2
+ */
+import type { Command } from 'commander';
+export declare function runMemoryStop(): Promise<number>;
+export declare function registerMemoryStop(cmd: Command): void;
+//# sourceMappingURL=stop.d.ts.map

package/dist/commands/memory/stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../../src/commands/memory/stop.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBzC,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAmDrD;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAQrD"}

package/dist/commands/memory/stop.js

@@ -0,0 +1,81 @@
+/**
+ * olam memory stop — terminate the host agent-memory process gracefully.
+ *
+ * SIGTERM → wait 10s → SIGKILL. Removes the pidfile on clean exit.
+ * Idempotent: no pidfile or stale pidfile → exit 0 with informational message.
+ *
+ * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md A2
+ */
+import { existsSync, readFileSync, unlinkSync } from 'node:fs';
+import { printSuccess, printWarning, printInfo, printHeader } from '../../output.js';
+import { MEMORY_PID_PATH } from './_paths.js';
+const SIGTERM_GRACE_MS = 10_000;
+const POLL_MS = 250;
+function isAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function runMemoryStop() {
+    printHeader('olam memory stop');
+    if (!existsSync(MEMORY_PID_PATH)) {
+        printSuccess('no pidfile present (nothing to stop)');
+        return 0;
+    }
+    const pid = parseInt(readFileSync(MEMORY_PID_PATH, 'utf8').trim(), 10);
+    if (!Number.isFinite(pid) || pid <= 0) {
+        printWarning(`pidfile contained invalid value; removing`);
+        unlinkSync(MEMORY_PID_PATH);
+        return 0;
+    }
+    if (!isAlive(pid)) {
+        printSuccess(`pid ${pid} is not running (stale pidfile); cleaned up`);
+        unlinkSync(MEMORY_PID_PATH);
+        return 0;
+    }
+    printInfo('pid', `${pid}`);
+    try {
+        process.kill(pid, 'SIGTERM');
+    }
+    catch (err) {
+        printWarning(`SIGTERM to pid ${pid} failed: ${err.message}`);
+    }
+    // Wait for graceful exit
+    const deadline = Date.now() + SIGTERM_GRACE_MS;
+    while (Date.now() < deadline) {
+        if (!isAlive(pid))
+            break;
+        await new Promise((r) => setTimeout(r, POLL_MS));
+    }
+    if (isAlive(pid)) {
+        printWarning(`pid ${pid} did not exit within ${SIGTERM_GRACE_MS / 1000}s; sending SIGKILL`);
+        try {
+            process.kill(pid, 'SIGKILL');
+        }
+        catch (err) {
+            printWarning(`SIGKILL to pid ${pid} failed: ${err.message}`);
+        }
+        // Brief wait for SIGKILL to take effect
+        await new Promise((r) => setTimeout(r, 500));
+    }
+    if (existsSync(MEMORY_PID_PATH)) {
+        unlinkSync(MEMORY_PID_PATH);
+    }
+    printSuccess(`stopped (pid ${pid})`);
+    return 0;
+}
+export function registerMemoryStop(cmd) {
+    cmd
+        .command('stop')
+        .description('Stop the host agent-memory process (SIGTERM → SIGKILL after 10s; idempotent)')
+        .action(async () => {
+        const rc = await runMemoryStop();
+        if (rc !== 0)
+            process.exitCode = rc;
+    });
+}
+//# sourceMappingURL=stop.js.map

package/dist/commands/memory/stop.js.map

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

package/dist/commands/memory/uninstall.d.ts

@@ -0,0 +1,19 @@
+/**
+ * olam memory uninstall — Remove `agentmemory` from the operator's host
+ * claude. Symmetric with `install`. Idempotent — "not registered" is
+ * success-as-noop.
+ *
+ * Plan reference: docs/plans/olam-agent-memory-distributed/phase-a-tasks.md A4
+ */
+import type { Command } from 'commander';
+import { type ClaudeShellDeps, type McpScope } from '../mcp/install-shared.js';
+export declare function buildClaudeMcpRemoveArgs(scope: McpScope): {
+    command: string;
+    args: string[];
+};
+export interface UninstallOpts {
+    scope: McpScope;
+}
+export declare function runUninstall(opts: UninstallOpts, deps?: ClaudeShellDeps): Promise<number>;
+export declare function registerMemoryUninstall(cmd: Command): void;
+//# sourceMappingURL=uninstall.d.ts.map

package/dist/commands/memory/uninstall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uninstall.d.ts","sourceRoot":"","sources":["../../../src/commands/memory/uninstall.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAML,KAAK,eAAe,EACpB,KAAK,QAAQ,EACd,MAAM,0BAA0B,CAAC;AAIlC,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,QAAQ,GAAG;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,CAKA;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,aAAa,EACnB,IAAI,GAAE,eAA2C,GAChD,OAAO,CAAC,MAAM,CAAC,CAkCjB;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAmB1D"}