@mnemom/mnemom 0.17.4-next.0 → 0.17.4-next.1

package/dist/commands/agent.d.ts

@@ -26,6 +26,7 @@
  * an argv value.
  */
 import { type MnemomKeyDeps } from "../lib/subscription-login.js";
+import { type SessionRecord } from "../lib/agent-ledger.js";
 import { type ExperimentalId } from "../lib/experimental.js";
 import { type ContextProfile, type LaunchShape, type SealedContractEnvelope } from "../lib/agent.js";
 export interface AgentOptions {
@@ -103,6 +104,34 @@ export interface AgentOptions {
 }
 /** Entry point for `mnemom agent [scenario]`. Throws on fatal misconfig. */
 export declare function agentCommand(scenarioArg: string | undefined, options?: AgentOptions): Promise<void>;
+/** The Claude Code session id a passthrough `--resume <id>` / `-r <id>` / `--resume=<id>` names. */
+export declare function passthroughResumeId(passthrough: readonly string[]): string | null;
+/**
+ * The conversation id this launch runs under (IG5 #1, decision D1). The gateway keys the
+ * implicit goal by conversation id, so an implicit relaunch reuses the earlier one:
+ *   - `--conversation-id` → that id, no lookup;
+ *   - not implicit (a sealed contract, or alignment off) → a new id;
+ *   - only an earlier implicit launch with the same session name, org, agent and gateway host
+ *     is continued; any mismatch → a new id, no prompt;
+ *   - `-- --resume <cc-session-id>` → the matching row that pinned that Claude Code session
+ *     (else the newest matching row), reused without asking;
+ *   - no `--resume` → "Resume previous session <name>? [Y/n]", default Y; Y reuses that row's
+ *     conversation, n mints a new one. `--resume` is NOT added to Claude Code (the user often
+ *     resumes inside it with /resume). No TTY: Y.
+ * The ledger read is best-effort: a failure means a new id.
+ */
+export declare function resolveLaunchConversationId(input: {
+    session: string;
+    orgId: string;
+    agent: string;
+    gatewayHost: string;
+    explicit?: string;
+    implicit: boolean;
+    passthrough: readonly string[];
+    interactive: boolean;
+    records: () => SessionRecord[];
+    askYesNo: (question: string, defaultYes: boolean) => Promise<boolean>;
+}): Promise<string>;
 /**
  * Record this launch in ~/.mnemom/sessions.jsonl. The agent record id is
  * resolved best-effort (a lookup failure or an unknown slug records null); a

package/dist/commands/agent.js

@@ -34,7 +34,7 @@ import { fileURLToPath } from "node:url";
 import { getApiUrl, getGatewayUrl, MNEMOM_DIR } from "../lib/config.js";
 import { createApiKey, getAgentByName } from "../lib/api.js";
 import { MNEMOM_KEY_STORE_FIELD, resolveAgentAuth, resolveSubscriptionMnemomKey, subscriptionChildEnv, subscriptionShape, } from "../lib/subscription-login.js";
-import { LEDGER_FILE, appendSessionRecord, resolveRetentionDays, toLedgerContract, } from "../lib/agent-ledger.js";
+import { LEDGER_FILE, appendSessionRecord, findResumeCandidate, readSessionRecords, resolveRetentionDays, toLedgerContract, } from "../lib/agent-ledger.js";
 import { loadCliConfig } from "../lib/cli-config.js";
 import { configKeySpec, loadLauncherConfig, writeLauncherConfig } from "../lib/launcher-config.js";
 import { experimentalNotice } from "../lib/experimental.js";
@@ -42,7 +42,7 @@ import { fmt } from "../lib/format.js";
 import { askInput, askYesNo, isInteractive } from "../lib/prompt.js";
 import { goalAlignmentLine, resolveSessionSetup } from "./agent-session.js";
 import { AgentIdentityMismatchError, defaultAgentSlug, ensureGovernedAgent, ensureSessionAndBalance, isQuietPreambleExit, resolveDefaultSlug, resolvePreflightedAccount, } from "./agent-setup.js";
-import { assembleContract, buildGoalModeHeader, buildCustomHeaders, buildHandoffMcpConfigJson, buildSessionConfig, buildSessionConfigB64, resolveContextHandoff, resolveContextProfile, resolveHandoffGatewayHost, HANDOFF_RC_KEY_ENV_NAME, isProdGateway, launchPreferenceExplicit, launchPreflighted, remoteControlAllowed, resolveAnthropicDoor, 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, resolveContextHandoff, resolveContextProfile, resolveHandoffGatewayHost, HANDOFF_RC_KEY_ENV_NAME, isProdGateway, launchPreferenceExplicit, launchPreflighted, remoteControlAllowed, resolveAnthropicDoor, resolveConversationId, resolveGatewayHost, singleCellError, resolveLaunchShape, resolveRemoteControlShape, passthroughName, sanitizeAgentName, sessionDisplayName, GATEWAY_HINT_HEADERS_ENV, 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. */
@@ -89,7 +89,6 @@ export async function agentCommand(scenarioArg, options = {}) {
     if (!agent) {
         throw new Error("mnemom agent: --agent sanitised to an empty string — pick a value with at least one letter or digit.");
     }
-    const conversationId = resolveConversationId(options.conversationId);
     // ── contract (built only if a contract flag was given; --goal then required) ──
     const envelope = assembleContract({
         goal: session.goal,
@@ -173,7 +172,8 @@ export async function agentCommand(scenarioArg, options = {}) {
             scenario,
             shape: previewShape,
             agent,
-            conversationId,
+            // The org is only known after sign-in, so a dry run never offers a resume (IG5 #1).
+            conversationId: resolveConversationId(options.conversationId),
             door,
             cellNote,
             envelope,
@@ -305,6 +305,22 @@ export async function agentCommand(scenarioArg, options = {}) {
             say(fmt.warn(`mnemom agent: agent setup did not complete (${msg}) — launching with the unclaimed identity.`));
         }
     }
+    // ── conversation id ── an implicit relaunch continues its earlier conversation (IG5 #1, D1)
+    // so the goal the gateway inferred there is still the one it steers by. Resolved here, after
+    // sign-in and the agent refresh, because a resume needs the org, agent and gateway host to
+    // match the earlier launch.
+    const conversationId = await resolveLaunchConversationId({
+        session: scenario,
+        orgId: account.orgId,
+        agent,
+        gatewayHost,
+        explicit: options.conversationId,
+        implicit: goalAlignmentMode(envelope, goalMode) === "implicit",
+        passthrough: options.passthrough ?? [],
+        interactive: isInteractive(),
+        records: () => readSessionRecords({ dir: MNEMOM_DIR }),
+        askYesNo: (q, d) => askYesNo(q, d),
+    });
     // ── local session ledger (~/.mnemom/sessions.jsonl) ── one line per real
     // launch so `mnemom agent sessions` / `show` can find this conversation later.
     // Written after provisioning so a freshly claimed agent's id resolves. Holds
@@ -409,6 +425,63 @@ export async function agentCommand(scenarioArg, options = {}) {
 // ───────────────────────────────────────────────────────────────────────────
 // Session ledger (thin driver over lib/agent-ledger.ts)
 // ───────────────────────────────────────────────────────────────────────────
+/** The Claude Code session id a passthrough `--resume <id>` / `-r <id>` / `--resume=<id>` names. */
+export function passthroughResumeId(passthrough) {
+    for (let i = 0; i < passthrough.length; i++) {
+        const a = passthrough[i];
+        if (a === "--resume" || a === "-r") {
+            const next = passthrough[i + 1];
+            return next !== undefined && !next.startsWith("-") && next.trim() !== "" ? next.trim() : null;
+        }
+        if (a.startsWith("--resume="))
+            return a.slice("--resume=".length).trim() || null;
+    }
+    return null;
+}
+/**
+ * The conversation id this launch runs under (IG5 #1, decision D1). The gateway keys the
+ * implicit goal by conversation id, so an implicit relaunch reuses the earlier one:
+ *   - `--conversation-id` → that id, no lookup;
+ *   - not implicit (a sealed contract, or alignment off) → a new id;
+ *   - only an earlier implicit launch with the same session name, org, agent and gateway host
+ *     is continued; any mismatch → a new id, no prompt;
+ *   - `-- --resume <cc-session-id>` → the matching row that pinned that Claude Code session
+ *     (else the newest matching row), reused without asking;
+ *   - no `--resume` → "Resume previous session <name>? [Y/n]", default Y; Y reuses that row's
+ *     conversation, n mints a new one. `--resume` is NOT added to Claude Code (the user often
+ *     resumes inside it with /resume). No TTY: Y.
+ * The ledger read is best-effort: a failure means a new id.
+ */
+export async function resolveLaunchConversationId(input) {
+    if ((input.explicit ?? "").trim())
+        return resolveConversationId(input.explicit);
+    if (!input.implicit)
+        return resolveConversationId(undefined);
+    let records;
+    try {
+        records = input.records();
+    }
+    catch {
+        return resolveConversationId(undefined);
+    }
+    const found = findResumeCandidate(records, {
+        session: input.session,
+        orgId: input.orgId,
+        agent: input.agent,
+        gatewayHost: input.gatewayHost,
+        resumeId: passthroughResumeId(input.passthrough),
+    });
+    if (!found)
+        return resolveConversationId(undefined);
+    const conv = found.record.conversation_id;
+    if (found.source === "session_name" && input.interactive) {
+        const yes = await input.askYesNo(`Resume previous session ${input.session}?`, true);
+        if (!yes)
+            return resolveConversationId(undefined);
+    }
+    say(`mnemom agent: continuing conversation ${conv} from the earlier '${found.record.session}' launch (${found.record.started_at}), so its goal carries over.`);
+    return resolveConversationId(conv);
+}
 /**
  * Record this launch in ~/.mnemom/sessions.jsonl. The agent record id is
  * resolved best-effort (a lookup failure or an unknown slug records null); a
@@ -738,6 +811,7 @@ function launchTerminal(ctx) {
     }
     const sessionName = passthroughName(ctx.options.passthrough ?? []) ?? sessionDisplayName(ctx.agent, ctx.scenario);
     childEnv[SESSION_NAME_ENV] = sessionName;
+    childEnv[GATEWAY_HINT_HEADERS_ENV] = "1";
     if (ctx.options.slack)
         args.push(...slackChannelArgs(sessionName));
     if (ctx.contextHint) {

package/dist/lib/agent-ledger.d.ts

@@ -133,3 +133,30 @@ export declare function appendSessionRecord(input: SessionRecordInput, deps: Led
 export declare function readSessionRecords(deps: Pick<LedgerDeps, "dir">): SessionRecord[];
 /** One ledger line → a record, or null when it is not a v1 record object. */
 export declare function parseRecord(line: string): SessionRecord | null;
+/**
+ * Which earlier launch a new one continues (IG5 #1, decision D1). The gateway keys the implicit
+ * goal by conversation id, so a relaunch that mints a fresh id starts goal-less. A row
+ * qualifies only when it is an implicit-mode launch (a sealed contract is sealed on its own
+ * conversation and is never carried) with the same session name, org, agent and gateway host as
+ * this launch; an empty org never matches. `records` is file order (oldest first); the newest
+ * qualifying row wins.
+ *   - `resumeId` (the `--resume <cc-session-id>` passed through to Claude Code) → the qualifying
+ *     row that pinned that Claude Code session, else the newest qualifying row; `source:
+ *     "resume_flag"` — reused without asking.
+ *   - no `resumeId` → the newest qualifying row; `source: "session_name"` — the launcher asks
+ *     first.
+ *   - nothing qualifies → null (a new conversation id).
+ */
+export interface ResumeCandidate {
+    record: SessionRecord;
+    source: "resume_flag" | "session_name";
+    /** True when the row was found by its Claude Code session id (not by the name fallback). */
+    byCcSession: boolean;
+}
+export declare function findResumeCandidate(records: readonly SessionRecord[], want: {
+    session: string;
+    orgId: string;
+    agent: string;
+    gatewayHost: string;
+    resumeId?: string | null;
+}): ResumeCandidate | null;

package/dist/lib/agent-ledger.js

@@ -170,3 +170,30 @@ export function parseRecord(line) {
 function nonEmptyLines(text) {
     return text.split("\n").filter((l) => l.trim().length > 0);
 }
+export function findResumeCandidate(records, want) {
+    const implicitRows = records.filter((r) => r.goal_mode === "implicit" &&
+        typeof r.conversation_id === "string" &&
+        r.conversation_id &&
+        r.session === want.session &&
+        !!want.orgId &&
+        r.org_id === want.orgId &&
+        r.agent_slug === want.agent &&
+        r.gateway_host === want.gatewayHost);
+    const newest = (pred) => {
+        for (let i = implicitRows.length - 1; i >= 0; i--) {
+            const r = implicitRows[i];
+            if (pred(r))
+                return r;
+        }
+        return undefined;
+    };
+    const latest = newest(() => true);
+    const resumeId = want.resumeId?.trim();
+    if (resumeId) {
+        const byCc = newest((r) => r.cc_session_id === resumeId);
+        if (byCc)
+            return { record: byCc, source: "resume_flag", byCcSession: true };
+        return latest ? { record: latest, source: "resume_flag", byCcSession: false } : null;
+    }
+    return latest ? { record: latest, source: "session_name", byCcSession: false } : null;
+}

package/dist/lib/agent.d.ts

@@ -116,6 +116,15 @@ export declare function sanitizeAgentName(raw: string): string;
  * post`) can identify themselves by the same name the claude.ai session list shows.
  */
 export declare const SESSION_NAME_ENV = "MNEMOM_AGENT_SESSION_NAME";
+/**
+ * Claude Code's opt-in for its gateway hint headers (`x-claude-code-request-class`,
+ * `x-claude-code-agent-type`, `x-claude-code-prompt-id`). CC sends them to api.anthropic.com on
+ * its own, so a Remote Control launch (rc-proxy in front of api.anthropic.com) already carries
+ * them; with `ANTHROPIC_BASE_URL` pointing at the gateway door (the terminal shape) CC sends them
+ * only when this is "1". The gateway reads them to keep away summaries, titles, compaction and
+ * teammates off the main implicit goal.
+ */
+export declare const GATEWAY_HINT_HEADERS_ENV = "CLAUDE_CODE_GATEWAY_HINT_HEADERS";
 /** 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

@@ -117,6 +117,15 @@ export function sanitizeAgentName(raw) {
  * post`) can identify themselves by the same name the claude.ai session list shows.
  */
 export const SESSION_NAME_ENV = "MNEMOM_AGENT_SESSION_NAME";
+/**
+ * Claude Code's opt-in for its gateway hint headers (`x-claude-code-request-class`,
+ * `x-claude-code-agent-type`, `x-claude-code-prompt-id`). CC sends them to api.anthropic.com on
+ * its own, so a Remote Control launch (rc-proxy in front of api.anthropic.com) already carries
+ * them; with `ANTHROPIC_BASE_URL` pointing at the gateway door (the terminal shape) CC sends them
+ * only when this is "1". The gateway reads them to keep away summaries, titles, compaction and
+ * teammates off the main implicit goal.
+ */
+export const GATEWAY_HINT_HEADERS_ENV = "CLAUDE_CODE_GATEWAY_HINT_HEADERS";
 /** The session display name: "<agent>-<scenario>" (sanitised), else the agent slug. */
 export function sessionDisplayName(agent, scenario) {
     return sanitizeAgentName(`${agent}-${scenario}`) || agent;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mnemom/mnemom",
-  "version": "0.17.4-next.0",
+  "version": "0.17.4-next.1",
   "description": "Transparent AI agent tracing",
   "type": "module",
   "bin": {