@mnemom/mnemom 0.17.11 → 0.17.12

package/dist/commands/agent-session.js

@@ -37,7 +37,7 @@ export function goalAlignmentLine(mode) {
     }
     return m === "on"
         ? "mnemom agent: goal alignment: on (the judge nudges the agent back when it drifts from your goal)"
-        : "mnemom agent: goal alignment: off (--no-implicit or goal_mode = off — pass --goal or drop --no-implicit to turn it back on)";
+        : 'mnemom agent: goal alignment: off — add --goal "…" to seal a goal for this session';
 }
 const defaultSay = (line = "") => console.error(line);
 /**
@@ -62,7 +62,7 @@ export async function resolveSessionSetup(input, ask) {
     // ── 1. session name ──
     const fallback = defaultSessionName(input.cwd);
     say();
-    say("Session name — labels this session in your traces and the claude.ai session list.");
+    say("Session name — labels this session in your traces and in `mnemom agent sessions`.");
     say(`  (Next time you can pass it directly: mnemom agent <name>.)`);
     const typed = await ask.askInput(`Session name [${fallback}]:`);
     const scenario = sanitizeAgentName(typed.trim()) || fallback;

package/dist/commands/agent-sessions.js

@@ -15,7 +15,7 @@
  */
 import { readSessionRecords } from "../lib/agent-ledger.js";
 import { getGatewayUrl, MNEMOM_DIR } from "../lib/config.js";
-import { sameOrigin } from "../lib/agent.js";
+import { resumeCommand, sameOrigin } from "../lib/agent.js";
 import { getAgentSession, MnemomApiError } from "../lib/api.js";
 import { fmt, formatRelativeAge } from "../lib/format.js";
 import { goalControlFetch } from "../lib/goal-api.js";
@@ -186,6 +186,13 @@ export function buildShowView(local, remote, reason) {
         L.push(fmt.label("experimental: ", local.experimental.join(", ")));
     }
     L.push(fmt.label("conversation: ", local.conversation_id));
+    if (local.cc_session_id && local.launch_shape !== "server") {
+        L.push(fmt.label("resume:       ", resumeCommand({
+            scenario: local.session,
+            agent: local.agent_slug,
+            ccSessionId: local.cc_session_id,
+        })));
+    }
     const goalMode = resolveGoalMode(local, remote);
     L.push(fmt.label("goal alignment:", goalBadge(goalMode)));
     if (local.contract) {

package/dist/commands/agent-setup.js

@@ -598,7 +598,7 @@ export async function ensureMnemomSession(opts = {}) {
     say(fmt.section("Sign in to Mnemom"));
     say(fmt.dim("  mnemom agent runs your coding session governed and under your Mnemom account,"));
     say(fmt.dim("  so it shows up in your traces and draws on your org's µ balance."));
-    say(fmt.dim(`  New to Mnemom? You can create a free account in the same flow (or at ${getWebsiteUrl()}/signup).`));
+    say(fmt.dim(`  New to Mnemom? You can create your account in the same flow (or at ${getWebsiteUrl()}/signup).`));
     if (!(await askYesNo("Sign in or create your account now?", true)))
         return false;
     const device = headlessEnv();
@@ -688,7 +688,7 @@ export async function ensureSessionAndBalance(opts) {
     if (!haveSession) {
         throw new Error("mnemom agent needs a Mnemom account — it runs your coding session governed and on your org's µ balance.\n" +
             "  Sign in:   mnemom login   (or set MNEMOM_API_KEY)\n" +
-            `  New here?  create a free account, then top up µ: ${getWebsiteUrl()}/settings/billing`);
+            `  New here?  create your account, then top up µ: ${getWebsiteUrl()}/settings/billing`);
     }
     const active = getActiveOrg();
     const orgId = active?.org_id ?? (await getMyPersonalOrg()).org_id;

package/dist/commands/agent.d.ts

@@ -143,6 +143,24 @@ export declare function passthroughResumeId(passthrough: readonly string[]): str
  * The ledger read is best-effort: a failure means a new id.
  */
 export declare function resolveLaunchConversationId(input: LaunchContinuationInput): Promise<string>;
+/** Whether the passthrough continues the directory's newest session (`--continue` / `-c`, unforked). */
+export declare function passthroughContinues(passthrough: readonly string[]): boolean;
+/**
+ * The Claude Code session `--continue` picks in `cwd`: the newest `<uuid>.jsonl` in that
+ * directory's project folder (Claude Code names it after the path, each non-alphanumeric
+ * character a `-`). Best-effort: null when there is none or it can't be read.
+ */
+export declare function newestCcSessionIn(cwd: string, env: NodeJS.ProcessEnv): string | null;
+/**
+ * The line `mnemom agent` prints after Claude Code exits: how to resume the session THROUGH
+ * Mnemom (Claude Code's own `claude --resume <id>` leaves the gateway). `--agent` is repeated
+ * only when this launch named one; an unknown session id falls back to `--continue`.
+ */
+export declare function resumeHintLine(ctx: {
+    scenario: string;
+    agent?: string;
+    ccSessionId: string | null;
+}): string;
 /**
  * Whether Claude Code still has the transcript of session `id`
  * (`${CLAUDE_CONFIG_DIR:-~/.claude}/projects/<any project>/<id>.jsonl`; `--resume` finds it in any

package/dist/commands/agent.js

@@ -26,7 +26,7 @@
  * an argv value.
  */
 import { spawn, spawnSync } from "node:child_process";
-import { existsSync, mkdtempSync, readdirSync, readFileSync, rmSync, writeFileSync, renameSync, } from "node:fs";
+import { existsSync, mkdtempSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync, renameSync, } from "node:fs";
 import { randomUUID } from "node:crypto";
 import { tmpdir, homedir, hostname, userInfo } from "node:os";
 import { basename, join, dirname } from "node:path";
@@ -46,7 +46,7 @@ import { authConfigured, chooseAuth, detectClaudeLogin, readClaudeLoginState, }
 import { requireConsoleKey, readConsoleKey } from "../lib/console-key.js";
 import { goalAlignmentLine, resolveSessionSetup } from "./agent-session.js";
 import { defaultAgentSlug, ensureClaimedServedAgent, ensureSessionAndBalance, isQuietPreambleExit, resolveDefaultSlug, resolvePreflightedAccount, } from "./agent-setup.js";
-import { assembleContract, buildGoalModeHeader, buildCustomHeaders, buildHandoffMcpConfigJson, buildSessionConfig, buildSessionConfigB64, assertCompactAtCompatible, assertOffProfileCompatible, compactAtWindowWarning, describeCompactAt, launchWindow, resolveCompactAt, applyGatewayHintHeaders, resolveCompactionIntercept, resolveContextHandoff, resolveContextProfile, resolveHandoffGatewayHost, HANDOFF_RC_KEY_ENV_NAME, isProdGateway, launchPreferenceExplicit, launchPreflighted, remoteControlAllowed, applyToolSearchDefault, DISABLE_1M_ENV, readCcSettings, resolveWindowModel, resolveAnthropicDoor, resolveLaunchModel, resolveConversationId, resolveGatewayHost, singleCellError, resolveLaunchShape, resolveRemoteControlShape, passthroughName, sanitizeAgentName, sessionDisplayName, SESSION_NAME_ENV, SESSION_CONFIG_HEADER, } from "../lib/agent.js";
+import { assembleContract, buildGoalModeHeader, buildCustomHeaders, buildHandoffMcpConfigJson, buildSessionConfig, buildSessionConfigB64, assertCompactAtCompatible, assertOffProfileCompatible, compactAtWindowWarning, describeCompactAt, launchWindow, resolveCompactAt, applyGatewayHintHeaders, resolveCompactionIntercept, resolveContextHandoff, resolveContextProfile, resolveHandoffGatewayHost, HANDOFF_RC_KEY_ENV_NAME, isProdGateway, launchPreferenceExplicit, launchPreflighted, remoteControlAllowed, applyToolSearchDefault, DISABLE_1M_ENV, readCcSettings, resolveWindowModel, resolveAnthropicDoor, resolveLaunchModel, resolveConversationId, resolveGatewayHost, singleCellError, resolveLaunchShape, resolveRemoteControlShape, passthroughName, sanitizeAgentName, resumeCommand, sessionDisplayName, SESSION_NAME_ENV, SESSION_CONFIG_HEADER, } from "../lib/agent.js";
 import { LAUNCHER_STORE_PATH, mergeStore } from "../lib/launcher-store.js";
 import { slackChannelArgs } from "../lib/slack-launch.js";
 /** The CLI's own provider-key store (zero 1Password): ~/.mnemom/launcher.json, 0600. */
@@ -441,10 +441,16 @@ export async function agentCommand(scenarioArg, options = {}) {
             passthrough: [...(options.passthrough ?? []), "--resume", continuation.resumeCcSessionId],
         };
     }
-    // A launch that resumes a Claude Code session (the continuation above, or the caller's own
-    // `-- --resume <id>`) keeps the profile that session ran under, unless this launch chose one
-    // with a flag. Read from the ledger only — nothing here writes a default anywhere.
-    const resumeId = shape === "server" ? null : passthroughResumeId(options.passthrough ?? []);
+    // A launch that resumes a Claude Code session (the continuation above, the caller's own
+    // `-- --resume <id>`, or `-- --continue`, which picks this directory's newest session) keeps
+    // the profile that session ran under, unless this launch chose one with a flag. Read from the
+    // ledger only — nothing here writes a default anywhere.
+    const continuedCcSessionId = shape !== "server" && passthroughContinues(options.passthrough ?? [])
+        ? newestCcSessionIn(process.cwd(), process.env)
+        : null;
+    const resumeId = shape === "server"
+        ? null
+        : (passthroughResumeId(options.passthrough ?? []) ?? continuedCcSessionId);
     if (resumeId && options.contextProfile === undefined && options.context !== false) {
         let resumed;
         try {
@@ -502,7 +508,8 @@ export async function agentCommand(scenarioArg, options = {}) {
         cli,
         envelope,
         goalMode,
-        ccSessionId: cc.id,
+        // A `--continue` records the session it continues, so a later resume finds its profile.
+        ccSessionId: cc.id ?? continuedCcSessionId,
         contextProfile,
         compactAt: contextProfile === "off" ? null : compactAt,
     });
@@ -565,6 +572,12 @@ export async function agentCommand(scenarioArg, options = {}) {
             contextHint,
             ccSessionId,
             handoffMcpConfigPath,
+            resumeHint: (id) => resumeHintLine({
+                scenario,
+                agent: options.agent?.trim() ? agent : undefined,
+                ccSessionId: id,
+            }),
+            knownCcSessionId: cc.id ?? continuedCcSessionId,
         });
         return; // launchTerminal exits the process
     }
@@ -627,6 +640,52 @@ function choosesCcSession(passthrough) {
     return !pickCcSessionId([...passthrough], () => "").inject;
 }
 const CC_SESSION_ID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/** `${CLAUDE_CONFIG_DIR:-~/.claude}/projects` — where Claude Code keeps session transcripts. */
+function ccProjectsDir(env) {
+    return join((env.CLAUDE_CONFIG_DIR ?? "").trim() || join(homedir(), ".claude"), "projects");
+}
+/** Whether the passthrough continues the directory's newest session (`--continue` / `-c`, unforked). */
+export function passthroughContinues(passthrough) {
+    return ((passthrough.includes("--continue") || passthrough.includes("-c")) &&
+        !passthrough.includes("--fork-session") &&
+        passthroughResumeId(passthrough) === null);
+}
+/**
+ * The Claude Code session `--continue` picks in `cwd`: the newest `<uuid>.jsonl` in that
+ * directory's project folder (Claude Code names it after the path, each non-alphanumeric
+ * character a `-`). Best-effort: null when there is none or it can't be read.
+ */
+export function newestCcSessionIn(cwd, env) {
+    const dir = join(ccProjectsDir(env), cwd.replace(/[^a-zA-Z0-9]/g, "-"));
+    try {
+        let best = null;
+        for (const f of readdirSync(dir)) {
+            const id = f.endsWith(".jsonl") ? f.slice(0, -".jsonl".length) : "";
+            if (!CC_SESSION_ID_RE.test(id))
+                continue;
+            const mtime = statSync(join(dir, f)).mtimeMs;
+            if (!best || mtime > best.mtime)
+                best = { id, mtime };
+        }
+        return best?.id ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * The line `mnemom agent` prints after Claude Code exits: how to resume the session THROUGH
+ * Mnemom (Claude Code's own `claude --resume <id>` leaves the gateway). `--agent` is repeated
+ * only when this launch named one; an unknown session id falls back to `--continue`.
+ */
+export function resumeHintLine(ctx) {
+    return (`Resume with: ${resumeCommand(ctx)}` +
+        "  (keeps it governed; `claude --resume` runs outside Mnemom)");
+}
+/** An interactive Claude Code session — not `-p` / `--print`, which has nothing to resume into. */
+function wantsResumeHint(cli, args) {
+    return cli.name === "claude" && !args.includes("-p") && !args.includes("--print");
+}
 /**
  * Whether Claude Code still has the transcript of session `id`
  * (`${CLAUDE_CONFIG_DIR:-~/.claude}/projects/<any project>/<id>.jsonl`; `--resume` finds it in any
@@ -636,7 +695,7 @@ const CC_SESSION_ID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a
 export function ccSessionTranscriptExists(id, env) {
     if (!CC_SESSION_ID_RE.test(id))
         return false;
-    const projects = join((env.CLAUDE_CONFIG_DIR ?? "").trim() || join(homedir(), ".claude"), "projects");
+    const projects = ccProjectsDir(env);
     try {
         return readdirSync(projects).some((d) => existsSync(join(projects, d, `${id}.jsonl`)));
     }
@@ -1086,8 +1145,15 @@ function launchTerminal(ctx) {
         child.on("exit", (code, signal) => {
             if (signal)
                 process.kill(process.pid, signal);
-            else
+            else {
+                // Claude Code's own last line is "Resume this session with: claude --resume <id>",
+                // which reopens it OUTSIDE Mnemom (ungoverned, unbilled). Ours goes after it, last.
+                if (code === 0 && ctx.resumeHint && wantsResumeHint(ctx.cli, args)) {
+                    const id = ctx.knownCcSessionId ?? newestCcSessionIn(process.cwd(), process.env);
+                    say(ctx.resumeHint(id));
+                }
                 process.exit(code ?? 0);
+            }
         });
     };
     // Implicit goal mode: put the local base-URL proxy in front of the door so each main request

package/dist/index.js

@@ -140,7 +140,7 @@ function printAgentHelp(verb) {
 }
 const agentCmd = program
     .command("agent [session] [passthrough...]")
-    .description("Launch your governed agent (Claude Code in v1) through the Mnemom gateway — governed identity + optional sealed goal contract. Plain `mnemom agent` asks for a session name and an optional goal. " +
+    .description("Launch your governed agent (Claude Code in v1) through the Mnemom gateway — governed identity + optional sealed goal contract. Plain `mnemom agent` asks for a session name. " +
     "Sub-verbs: `setup` provisions your governed agent; `doctor` preflights prerequisites; `config …` manages persistent settings (~/.mnemom/launcher.toml); `invite <token>` redeems a Mnemom Agent invitation; `list` / `claim` / `move` manage the agents in your orgs; `sessions` lists your past launches and `show [ref]` merges one with its live goal state; `help [verb]` prints help and never launches.")
     .option("--goal <statement>", "Contract goal statement (required if any contract flag is given)")
     .option("--requirement <text>", "Contract requirement (repeatable)", collectRepeatable, [])

package/dist/lib/agent.d.ts

@@ -228,6 +228,16 @@ export declare function resolveWindowModel(input: {
     env: Record<string, string | undefined>;
     settings: () => CcSettingsView[];
 }): WindowModel;
+/**
+ * The command that resumes a Claude Code session THROUGH Mnemom (governed, billed) — never
+ * Claude Code's own `claude --resume <id>`, which leaves the gateway. An unknown session id
+ * falls back to `--continue` (Claude Code's newest session in this directory).
+ */
+export declare function resumeCommand(ctx: {
+    scenario: string;
+    agent?: string;
+    ccSessionId: string | null;
+}): string;
 /** The session display name: "<agent>-<scenario>" (sanitised), else the agent slug. */
 export declare function sessionDisplayName(agent: string, scenario: string): string;
 /** A caller's own `--name <x>` in the passthrough args, if any (last one wins). */

package/dist/lib/agent.js

@@ -301,6 +301,20 @@ export function resolveWindowModel(input) {
         return { model: explicit, reason: "unsupported" };
     return { model: `${base}${ONE_M_SUFFIX}`, reason: "one-m", from: base };
 }
+/** Single-quote `s` for a POSIX shell unless it is plainly safe as-is. */
+function shellArg(s) {
+    return /^[A-Za-z0-9._@%+=:,/-]+$/.test(s) ? s : `'${s.replace(/'/g, "'\\''")}'`;
+}
+/**
+ * The command that resumes a Claude Code session THROUGH Mnemom (governed, billed) — never
+ * Claude Code's own `claude --resume <id>`, which leaves the gateway. An unknown session id
+ * falls back to `--continue` (Claude Code's newest session in this directory).
+ */
+export function resumeCommand(ctx) {
+    const agentFlag = ctx.agent ? ` --agent ${shellArg(ctx.agent)}` : "";
+    const resume = ctx.ccSessionId ? `--resume ${shellArg(ctx.ccSessionId)}` : "--continue";
+    return `mnemom agent ${shellArg(ctx.scenario)}${agentFlag} -- ${resume}`;
+}
 /** The session display name: "<agent>-<scenario>" (sanitised), else the agent slug. */
 export function sessionDisplayName(agent, scenario) {
     return sanitizeAgentName(`${agent}-${scenario}`) || agent;

package/dist/lib/update/install-method.js

@@ -27,6 +27,11 @@ export function classifyInstall(entryRealpath, npmGlobalRoot) {
     if (npmGlobalRoot && p.startsWith(`${norm(npmGlobalRoot).replace(/\/$/, "")}/@mnemom/mnemom/`)) {
         return "npm-global";
     }
+    // `<prefix>/lib/node_modules/…` is npm's GLOBAL layout under a prefix `npm root -g` doesn't
+    // report (a custom --prefix, a switched HOME/.npmrc): not a project dependency, and not ours
+    // to self-update either — "unknown" gets the plain `npm install -g` hint.
+    if (p.includes("/lib/node_modules/@mnemom/mnemom/"))
+        return "unknown";
     if (p.includes("/node_modules/@mnemom/mnemom/"))
         return "project";
     return "unknown";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mnemom/mnemom",
-  "version": "0.17.11",
+  "version": "0.17.12",
   "description": "Transparent AI agent tracing",
   "type": "module",
   "bin": {