aismemory 0.7.5 → 0.8.2

package/dist/pending-device-flow.js

@@ -77,6 +77,13 @@ export function loadPendingDeviceFlow(home = homedir(), now = Date.now()) {
             agentId: typeof parsed.agentId === 'string' ? parsed.agentId : '',
             provisionalTenantId: typeof parsed.provisionalTenantId === 'string' ? parsed.provisionalTenantId : '',
             startedAt: typeof parsed.startedAt === 'string' ? parsed.startedAt : '',
+            ...(typeof parsed.deviceCode === 'string' ? { deviceCode: parsed.deviceCode } : {}),
+            ...(typeof parsed.userCode === 'string' ? { userCode: parsed.userCode } : {}),
+            ...(typeof parsed.verificationUriComplete === 'string'
+                ? { verificationUriComplete: parsed.verificationUriComplete }
+                : {}),
+            ...(typeof parsed.interval === 'number' ? { interval: parsed.interval } : {}),
+            ...(typeof parsed.codeExpiresAt === 'string' ? { codeExpiresAt: parsed.codeExpiresAt } : {}),
         };
     }
     catch {
@@ -93,4 +100,35 @@ export function clearPendingDeviceFlow(home = homedir()) {
         // reuse attempt, which degrades to minting.
     }
 }
+/**
+ * A device code that is still redeemable: the human can open the bond link
+ * that was already printed and it will work.
+ *
+ * `MIN_RESUMABLE_REMAINING_MS` keeps a code that is about to expire out of
+ * the resume path — re-surfacing a link with four seconds of life left is
+ * worse for the human than minting a fresh one.
+ */
+const MIN_RESUMABLE_REMAINING_MS = 60_000;
+/**
+ * True when `flow` carries a device code that has not expired yet, so the
+ * caller should resume polling it instead of minting a new one.
+ */
+export function isResumableDeviceFlow(flow, now = Date.now()) {
+    if (!flow)
+        return false;
+    if (typeof flow.deviceCode !== 'string' || flow.deviceCode.length === 0)
+        return false;
+    if (typeof flow.userCode !== 'string' || flow.userCode.length === 0)
+        return false;
+    if (typeof flow.verificationUriComplete !== 'string' ||
+        flow.verificationUriComplete.length === 0) {
+        return false;
+    }
+    if (typeof flow.codeExpiresAt !== 'string')
+        return false;
+    const expiresAt = Date.parse(flow.codeExpiresAt);
+    if (!Number.isFinite(expiresAt))
+        return false;
+    return expiresAt - now >= MIN_RESUMABLE_REMAINING_MS;
+}
 //# sourceMappingURL=pending-device-flow.js.map

package/dist/pending-device-flow.js.map

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

package/dist/refresh.js

@@ -1,9 +1,13 @@
+import { getAisRequestTimeoutMs } from './request-timeout.js';
 let refreshInterval = null;
 export function startRefreshTimer(aisUrl, agentId, token, onUpdate, intervalMs = 5 * 60 * 1000) {
     stopRefreshTimer();
     refreshInterval = setInterval(async () => {
         try {
-            const res = await fetch(`${aisUrl}/v1/agents/${agentId}/memory?limit=20&minImportance=0.5`, { headers: { Authorization: `Bearer ${token}` } });
+            const res = await fetch(`${aisUrl}/v1/agents/${agentId}/memory?limit=20&minImportance=0.5`, {
+                headers: { Authorization: `Bearer ${token}` },
+                signal: AbortSignal.timeout(getAisRequestTimeoutMs()),
+            });
             if (!res.ok)
                 return;
             const json = await res.json();

package/dist/refresh.js.map

@@ -1 +1 @@
-{"version":3,"file":"refresh.js","sourceRoot":"","sources":["../src/refresh.ts"],"names":[],"mappings":"AAEA,IAAI,eAAe,GAA0C,IAAI,CAAC;AAElE,MAAM,UAAU,iBAAiB,CAC/B,MAAc,EACd,OAAe,EACf,KAAa,EACb,QAA2C,EAC3C,aAAqB,CAAC,GAAG,EAAE,GAAG,IAAI;IAElC,gBAAgB,EAAE,CAAC;IACnB,eAAe,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACvC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CACrB,GAAG,MAAM,cAAc,OAAO,oCAAoC,EAClE,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE,EAAE,CAClD,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,EAAE;gBAAE,OAAO;YACpB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC;gBACxC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,kDAAkD;QACpD,CAAC;IACH,CAAC,EAAE,UAAU,CAAC,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,IAAI,eAAe,EAAE,CAAC;QACpB,aAAa,CAAC,eAAe,CAAC,CAAC;QAC/B,eAAe,GAAG,IAAI,CAAC;IACzB,CAAC;AACH,CAAC"}
+{"version":3,"file":"refresh.js","sourceRoot":"","sources":["../src/refresh.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,IAAI,eAAe,GAA0C,IAAI,CAAC;AAElE,MAAM,UAAU,iBAAiB,CAC/B,MAAc,EACd,OAAe,EACf,KAAa,EACb,QAA2C,EAC3C,aAAqB,CAAC,GAAG,EAAE,GAAG,IAAI;IAElC,gBAAgB,EAAE,CAAC;IACnB,eAAe,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACvC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CACrB,GAAG,MAAM,cAAc,OAAO,oCAAoC,EAClE;gBACE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,KAAK,EAAE,EAAE;gBAC7C,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,sBAAsB,EAAE,CAAC;aACtD,CACF,CAAC;YACF,IAAI,CAAC,GAAG,CAAC,EAAE;gBAAE,OAAO;YACpB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC;gBACxC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,kDAAkD;QACpD,CAAC;IACH,CAAC,EAAE,UAAU,CAAC,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,IAAI,eAAe,EAAE,CAAC;QACpB,aAAa,CAAC,eAAe,CAAC,CAAC;QAC/B,eAAe,GAAG,IAAI,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/request-timeout.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Shared client-side request timeout for every HTTP call the aismemory MCP
+ * server makes to AIS (GitHub issue #6635). A stalled AIS call must fail fast
+ * with a clear error instead of hanging the agent process for tens of
+ * minutes — that hang previously froze an entire floor session for 6 hours.
+ */
+/** Default timeout for an AIS request, in milliseconds. */
+export declare const DEFAULT_AIS_REQUEST_TIMEOUT_MS = 20000;
+/**
+ * Resolve the AIS request timeout from AIS_MCP_REQUEST_TIMEOUT_MS. Falls back
+ * to the default for anything unset, blank, non-numeric, or non-positive — a
+ * malformed override must degrade to a safe timeout, never disable it.
+ */
+export declare function getAisRequestTimeoutMs(env?: Record<string, string | undefined>): number;
+/** True when `err` is the abort produced by an `AbortSignal.timeout()` firing. */
+export declare function isAisRequestTimeout(err: unknown): boolean;
+export declare class AisRequestTimeoutError extends Error {
+    constructor(path: string, timeoutMs: number);
+}
+/**
+ * Replace a raw timeout abort with a clear, path- and duration-specific
+ * error so it surfaces as an actionable MCP tool error (`isError`) instead of
+ * an opaque "operation was aborted" message. Every other error passes through
+ * unchanged.
+ */
+export declare function toAisRequestError(err: unknown, path: string, timeoutMs: number): unknown;

package/dist/request-timeout.js

@@ -0,0 +1,49 @@
+/**
+ * Shared client-side request timeout for every HTTP call the aismemory MCP
+ * server makes to AIS (GitHub issue #6635). A stalled AIS call must fail fast
+ * with a clear error instead of hanging the agent process for tens of
+ * minutes — that hang previously froze an entire floor session for 6 hours.
+ */
+/** Default timeout for an AIS request, in milliseconds. */
+export const DEFAULT_AIS_REQUEST_TIMEOUT_MS = 20_000;
+const ENV_VAR = 'AIS_MCP_REQUEST_TIMEOUT_MS';
+/**
+ * Resolve the AIS request timeout from AIS_MCP_REQUEST_TIMEOUT_MS. Falls back
+ * to the default for anything unset, blank, non-numeric, or non-positive — a
+ * malformed override must degrade to a safe timeout, never disable it.
+ */
+export function getAisRequestTimeoutMs(env = process.env) {
+    const raw = env[ENV_VAR]?.trim();
+    if (!raw)
+        return DEFAULT_AIS_REQUEST_TIMEOUT_MS;
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        process.stderr.write(`[aismemory] ${ENV_VAR}="${raw}" is not a positive number of milliseconds; ` +
+            `using the default ${DEFAULT_AIS_REQUEST_TIMEOUT_MS}ms.\n`);
+        return DEFAULT_AIS_REQUEST_TIMEOUT_MS;
+    }
+    return parsed;
+}
+/** True when `err` is the abort produced by an `AbortSignal.timeout()` firing. */
+export function isAisRequestTimeout(err) {
+    return err instanceof DOMException && err.name === 'TimeoutError';
+}
+export class AisRequestTimeoutError extends Error {
+    constructor(path, timeoutMs) {
+        super(`AIS request to ${path} timed out after ${timeoutMs}ms`);
+        this.name = 'AisRequestTimeoutError';
+    }
+}
+/**
+ * Replace a raw timeout abort with a clear, path- and duration-specific
+ * error so it surfaces as an actionable MCP tool error (`isError`) instead of
+ * an opaque "operation was aborted" message. Every other error passes through
+ * unchanged.
+ */
+export function toAisRequestError(err, path, timeoutMs) {
+    if (isAisRequestTimeout(err)) {
+        return new AisRequestTimeoutError(path, timeoutMs);
+    }
+    return err;
+}
+//# sourceMappingURL=request-timeout.js.map

package/dist/request-timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-timeout.js","sourceRoot":"","sources":["../src/request-timeout.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,2DAA2D;AAC3D,MAAM,CAAC,MAAM,8BAA8B,GAAG,MAAM,CAAC;AAErD,MAAM,OAAO,GAAG,4BAA4B,CAAC;AAE7C;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAA0C,OAAO,CAAC,GAAG;IAErD,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC;IACjC,IAAI,CAAC,GAAG;QAAE,OAAO,8BAA8B,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAC5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,eAAe,OAAO,KAAK,GAAG,8CAA8C;YAC1E,qBAAqB,8BAA8B,OAAO,CAC7D,CAAC;QACF,OAAO,8BAA8B,CAAC;IACxC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,OAAO,GAAG,YAAY,YAAY,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,CAAC;AACpE,CAAC;AAED,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,IAAY,EAAE,SAAiB;QACzC,KAAK,CAAC,kBAAkB,IAAI,oBAAoB,SAAS,IAAI,CAAC,CAAC;QAC/D,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAY,EAAE,IAAY,EAAE,SAAiB;IAC7E,IAAI,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,sBAAsB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/retry-after.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Retry-After handling (Jaire C9, CORBOT-D452451A).
+ *
+ * AIS sends `Retry-After` on every 429 and 503. A read that is told to wait a
+ * few seconds waits and tries once more; a longer wait is not slept through
+ * inside a tool call — the error says, in plain words, how long to wait.
+ */
+/** Longest server-requested wait a GET sleeps through before its one retry. */
+export declare const MAX_HONOURED_RETRY_AFTER_SECONDS = 5;
+/** Statuses whose `Retry-After` means "back off, then the same call can work". */
+export declare const RETRY_AFTER_STATUSES: ReadonlySet<number>;
+/**
+ * Seconds to wait, from a `Retry-After` value (delta-seconds or HTTP-date).
+ * Null when the header is absent or unreadable.
+ */
+export declare function parseRetryAfterSeconds(value: string | null | undefined, nowMs?: number): number | null;
+/** The server's requested wait on a 429/503, or null when there is none. */
+export declare function retryAfterOf(res: {
+    status: number;
+    headers?: {
+        get(name: string): string | null;
+    };
+}): number | null;
+/** True when a GET should sleep `seconds` and try once more. */
+export declare function shouldHonourRetryAfter(seconds: number | null): seconds is number;
+export declare function sleepSeconds(seconds: number): Promise<void>;

package/dist/retry-after.js

@@ -0,0 +1,42 @@
+/**
+ * Retry-After handling (Jaire C9, CORBOT-D452451A).
+ *
+ * AIS sends `Retry-After` on every 429 and 503. A read that is told to wait a
+ * few seconds waits and tries once more; a longer wait is not slept through
+ * inside a tool call — the error says, in plain words, how long to wait.
+ */
+/** Longest server-requested wait a GET sleeps through before its one retry. */
+export const MAX_HONOURED_RETRY_AFTER_SECONDS = 5;
+/** Statuses whose `Retry-After` means "back off, then the same call can work". */
+export const RETRY_AFTER_STATUSES = new Set([429, 503]);
+/**
+ * Seconds to wait, from a `Retry-After` value (delta-seconds or HTTP-date).
+ * Null when the header is absent or unreadable.
+ */
+export function parseRetryAfterSeconds(value, nowMs = Date.now()) {
+    if (value === null || value === undefined)
+        return null;
+    const trimmed = value.trim();
+    if (/^\d+$/.test(trimmed))
+        return Number(trimmed);
+    if (!/[A-Za-z]/.test(trimmed))
+        return null;
+    const at = Date.parse(trimmed);
+    if (Number.isNaN(at))
+        return null;
+    return Math.max(0, Math.ceil((at - nowMs) / 1000));
+}
+/** The server's requested wait on a 429/503, or null when there is none. */
+export function retryAfterOf(res) {
+    if (!RETRY_AFTER_STATUSES.has(res.status))
+        return null;
+    return parseRetryAfterSeconds(res.headers?.get('retry-after'));
+}
+/** True when a GET should sleep `seconds` and try once more. */
+export function shouldHonourRetryAfter(seconds) {
+    return seconds !== null && seconds <= MAX_HONOURED_RETRY_AFTER_SECONDS;
+}
+export function sleepSeconds(seconds) {
+    return new Promise((resolve) => setTimeout(resolve, seconds * 1000));
+}
+//# sourceMappingURL=retry-after.js.map

package/dist/retry-after.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-after.js","sourceRoot":"","sources":["../src/retry-after.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,+EAA+E;AAC/E,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC;AAElD,kFAAkF;AAClF,MAAM,CAAC,MAAM,oBAAoB,GAAwB,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAE7E;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAgC,EAAE,QAAgB,IAAI,CAAC,GAAG,EAAE;IACjG,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACvD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,YAAY,CAAC,GAAuE;IAClG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACvD,OAAO,sBAAsB,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,sBAAsB,CAAC,OAAsB;IAC3D,OAAO,OAAO,KAAK,IAAI,IAAI,OAAO,IAAI,gCAAgC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;AACvE,CAAC"}

package/dist/run-pass-mode.d.ts

@@ -0,0 +1,16 @@
+export interface RunPassConfig {
+    runPassFile: string;
+    agentId: string;
+}
+export declare class RunPassConfigError extends Error {
+    constructor(message: string);
+}
+type FetchImpl = typeof globalThis.fetch;
+export declare function loadRunPassConfig(env?: Record<string, string | undefined>): RunPassConfig | null;
+export declare function readRunPassFile(runPassFile: string): Promise<string>;
+export declare function runPassPost(aisUrl: string, path: string, runPassFile: string, body: unknown, fetchImpl?: FetchImpl): Promise<unknown>;
+export declare function runPassGet(aisUrl: string, path: string, runPassFile: string, fetchImpl?: FetchImpl): Promise<unknown>;
+export declare function runPassPatch(aisUrl: string, path: string, runPassFile: string, body: unknown, fetchImpl?: FetchImpl): Promise<unknown>;
+export declare const UNKNOWN_TOOL_RUN_PASS_MODE: unique symbol;
+export declare function dispatchToolRunPassMode(aisUrl: string, config: RunPassConfig, name: string, rawArgs: unknown, fetchImpl?: FetchImpl): Promise<unknown | typeof UNKNOWN_TOOL_RUN_PASS_MODE>;
+export {};

package/dist/run-pass-mode.js

@@ -0,0 +1,274 @@
+/**
+ * Run-pass auth mode for the aismemory MCP client (CORBOT-662A4B3A).
+ *
+ * A launcher writes the current short-lived pass to AIS_RUN_PASS_FILE and may
+ * rotate that file while this process is running. Every request re-reads the
+ * file and sends exactly one credential header: x-run-pass.
+ */
+import { readFile } from 'node:fs/promises';
+import { AisHttpError, duplicateMemoryResult } from './ais-http-error.js';
+import { getAisRequestTimeoutMs, toAisRequestError } from './request-timeout.js';
+import { emitTelemetry } from './telemetry.js';
+import { OutOfScopeToolError } from './agent-key-mode.js';
+import { readInboxAndMaybeAck } from './inbox-client.js';
+import { orient } from './cli/orientation.js';
+import { AGENT_ARCHIVE_KEY_MODE_DETAIL } from './agent-archive.js';
+import { fetchCredentialWhoami } from './credential-whoami.js';
+import { parseEmptyToolArgs, parseRecallArgs, parseFullContextArgs, parseRememberArgs, parseGoalCreateArgs, parseGoalListArgs, parseGoalUpdateProgressArgs, parseGoalCompleteArgs, parseInboxSendArgs, parseInboxReadArgs, parseInboxAckArgs, parseHandoffArgs, } from './tool-args.js';
+const RUN_PASS_PATTERN = /^ais_rp_[A-Za-z0-9_-]{43}$/;
+export class RunPassConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'RunPassConfigError';
+    }
+}
+async function readJson(res) {
+    return res.json().catch(() => null);
+}
+export function loadRunPassConfig(env = process.env) {
+    const rawPath = env['AIS_RUN_PASS_FILE'];
+    if (rawPath === undefined)
+        return null;
+    const runPassFile = rawPath.trim();
+    if (runPassFile === '') {
+        throw new RunPassConfigError('AIS_RUN_PASS_FILE is set but empty. Refusing to start run-pass mode.');
+    }
+    const agentId = env['AIS_AGENT_ID']?.trim();
+    if (!agentId) {
+        throw new RunPassConfigError('AIS_RUN_PASS_FILE is set but AIS_AGENT_ID is missing. ' +
+            'Run-pass mode needs the one agent this pass is scoped to.');
+    }
+    return { runPassFile, agentId };
+}
+export async function readRunPassFile(runPassFile) {
+    let raw;
+    try {
+        raw = await readFile(runPassFile, 'utf8');
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : 'unknown read error';
+        throw new RunPassConfigError(`Refusing AIS request: cannot read AIS_RUN_PASS_FILE at ${runPassFile}: ${reason}`);
+    }
+    const runPass = raw.trim();
+    if (runPass.length === 0) {
+        throw new RunPassConfigError(`Refusing AIS request: AIS_RUN_PASS_FILE at ${runPassFile} is empty.`);
+    }
+    if (!RUN_PASS_PATTERN.test(runPass)) {
+        throw new RunPassConfigError(`Refusing AIS request: AIS_RUN_PASS_FILE at ${runPassFile} does not contain a valid ais_rp_ run pass.`);
+    }
+    return runPass;
+}
+async function runPassHeaders(runPassFile, includeContentType) {
+    const runPass = await readRunPassFile(runPassFile);
+    return {
+        ...(includeContentType ? { 'Content-Type': 'application/json' } : {}),
+        'x-run-pass': runPass,
+    };
+}
+export async function runPassPost(aisUrl, path, runPassFile, body, fetchImpl = globalThis.fetch) {
+    const headers = await runPassHeaders(runPassFile, true);
+    const timeoutMs = getAisRequestTimeoutMs();
+    let res;
+    try {
+        res = await fetchImpl(`${aisUrl}${path}`, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+    }
+    catch (err) {
+        const wrapped = toAisRequestError(err, path, timeoutMs);
+        emitTelemetry({ event: 'ais.http.failure', path, error: wrapped instanceof Error ? wrapped.message : String(wrapped) });
+        throw wrapped;
+    }
+    const data = await readJson(res);
+    if (!res.ok) {
+        emitTelemetry({ event: 'ais.http.failure', path, httpStatus: res.status, error: `HTTP ${res.status}` });
+        throw new AisHttpError(res.status, path, data);
+    }
+    return data;
+}
+export async function runPassGet(aisUrl, path, runPassFile, fetchImpl = globalThis.fetch) {
+    const headers = await runPassHeaders(runPassFile, false);
+    const timeoutMs = getAisRequestTimeoutMs();
+    let res;
+    try {
+        res = await fetchImpl(`${aisUrl}${path}`, {
+            headers,
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+    }
+    catch (err) {
+        const wrapped = toAisRequestError(err, path, timeoutMs);
+        emitTelemetry({ event: 'ais.http.failure', path, error: wrapped instanceof Error ? wrapped.message : String(wrapped) });
+        throw wrapped;
+    }
+    const data = await readJson(res);
+    if (!res.ok) {
+        emitTelemetry({ event: 'ais.http.failure', path, httpStatus: res.status, error: `HTTP ${res.status}` });
+        throw new AisHttpError(res.status, path, data);
+    }
+    return data;
+}
+export async function runPassPatch(aisUrl, path, runPassFile, body, fetchImpl = globalThis.fetch) {
+    const headers = await runPassHeaders(runPassFile, true);
+    const timeoutMs = getAisRequestTimeoutMs();
+    let res;
+    try {
+        res = await fetchImpl(`${aisUrl}${path}`, {
+            method: 'PATCH',
+            headers,
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+    }
+    catch (err) {
+        const wrapped = toAisRequestError(err, path, timeoutMs);
+        emitTelemetry({ event: 'ais.http.failure', path, error: wrapped instanceof Error ? wrapped.message : String(wrapped) });
+        throw wrapped;
+    }
+    const data = await readJson(res);
+    if (!res.ok) {
+        emitTelemetry({ event: 'ais.http.failure', path, httpStatus: res.status, error: `HTTP ${res.status}` });
+        throw new AisHttpError(res.status, path, data);
+    }
+    return data;
+}
+export const UNKNOWN_TOOL_RUN_PASS_MODE = Symbol('unknown-tool-run-pass-mode');
+export async function dispatchToolRunPassMode(aisUrl, config, name, rawArgs, fetchImpl = globalThis.fetch) {
+    const { agentId, runPassFile } = config;
+    switch (name) {
+        case 'remember': {
+            const args = parseRememberArgs(rawArgs);
+            try {
+                return await runPassPost(aisUrl, `/v1/agents/${agentId}/memory`, runPassFile, {
+                    content: args.content,
+                    type: args.type,
+                    importance: args.importance,
+                    ...(args.tags !== undefined && { tags: args.tags }),
+                }, fetchImpl);
+            }
+            catch (err) {
+                const duplicate = duplicateMemoryResult(err);
+                if (duplicate)
+                    return duplicate;
+                throw err;
+            }
+        }
+        case 'recall': {
+            const args = parseRecallArgs(rawArgs);
+            const params = new URLSearchParams();
+            params.set('query', args.query);
+            if (args.limit !== undefined)
+                params.set('limit', String(args.limit));
+            if (args.type !== undefined)
+                params.set('types', args.type);
+            if (args.tags !== undefined && args.tags.length > 0)
+                params.set('tags', args.tags.join(','));
+            if (args.principalAgentId !== undefined)
+                params.set('principalAgentId', args.principalAgentId);
+            return runPassGet(aisUrl, `/v1/agents/${agentId}/memory?${params}`, runPassFile, fetchImpl);
+        }
+        case 'full_context': {
+            const fcArgs = parseFullContextArgs(rawArgs);
+            const fcParams = new URLSearchParams();
+            if (fcArgs.principalAgentId !== undefined)
+                fcParams.set('principalAgentId', fcArgs.principalAgentId);
+            if (fcArgs.memoriesLimit !== undefined)
+                fcParams.set('memoriesLimit', String(fcArgs.memoriesLimit));
+            if (fcArgs.view !== undefined)
+                fcParams.set('view', fcArgs.view);
+            if (fcArgs.maxTokens !== undefined)
+                fcParams.set('maxTokens', String(fcArgs.maxTokens));
+            const fcQs = fcParams.toString();
+            return runPassGet(aisUrl, `/v1/agents/${agentId}/full-context${fcQs ? `?${fcQs}` : ''}`, runPassFile, fetchImpl);
+        }
+        case 'dream':
+            parseEmptyToolArgs(rawArgs);
+            return runPassPost(aisUrl, `/v1/agents/${agentId}/dream`, runPassFile, {}, fetchImpl);
+        case 'whoami':
+            parseEmptyToolArgs(rawArgs);
+            return fetchCredentialWhoami(agentId, 'run-pass', () => runPassGet(aisUrl, `/v1/agents/${agentId}/whoami`, runPassFile, fetchImpl), () => runPassGet(aisUrl, `/v1/agents/${agentId}/memory?limit=1`, runPassFile, fetchImpl));
+        case 'orientation_check':
+            return orient(rawArgs);
+        case 'agent_load':
+            throw new OutOfScopeToolError(name, 'Run passes are scoped to one agent for one run; start a new run pass for another agent.');
+        case 'goal_create': {
+            const args = parseGoalCreateArgs(rawArgs);
+            return runPassPost(aisUrl, `/v1/agents/${agentId}/goals`, runPassFile, {
+                title: args.title,
+                description: args.description,
+                ...(args.successCriteria !== undefined ? { successCriteria: args.successCriteria } : {}),
+                ...(args.parentGoalId !== undefined ? { parentGoalId: args.parentGoalId } : {}),
+            }, fetchImpl);
+        }
+        case 'goal_list': {
+            const args = parseGoalListArgs(rawArgs);
+            const params = new URLSearchParams();
+            if (args.status !== undefined)
+                params.set('status', args.status);
+            if (args.page !== undefined)
+                params.set('page', String(args.page));
+            params.set('limit', String(args.limit));
+            if (args.parentGoalId !== undefined)
+                params.set('parentGoalId', args.parentGoalId);
+            return runPassGet(aisUrl, `/v1/agents/${agentId}/goals?${params}`, runPassFile, fetchImpl);
+        }
+        case 'goal_update_progress': {
+            const args = parseGoalUpdateProgressArgs(rawArgs);
+            return runPassPatch(aisUrl, `/v1/agents/${agentId}/goals/${args.goalId}`, runPassFile, {
+                progress: args.progress,
+            }, fetchImpl);
+        }
+        case 'goal_complete': {
+            const args = parseGoalCompleteArgs(rawArgs);
+            return runPassPost(aisUrl, `/v1/agents/${agentId}/goals/${args.goalId}/complete`, runPassFile, {
+                success: args.success,
+                ...(args.notes !== undefined ? { notes: args.notes } : {}),
+                ...(args.lessonsLearned !== undefined ? { lessonsLearned: args.lessonsLearned } : {}),
+            }, fetchImpl);
+        }
+        case 'inbox_send': {
+            const args = parseInboxSendArgs(rawArgs);
+            return runPassPost(aisUrl, `/v1/agents/${agentId}/inbox`, runPassFile, {
+                recipientAgentId: args.recipientAgentId,
+                kind: args.kind,
+                body: args.body,
+                ...(args.threadId !== undefined ? { threadId: args.threadId } : {}),
+                ...(args.taskId !== undefined ? { taskId: args.taskId } : {}),
+                ...(args.inReplyTo !== undefined ? { inReplyTo: args.inReplyTo } : {}),
+                ...(args.messageId !== undefined ? { messageId: args.messageId } : {}),
+                ...(args.ttlSeconds !== undefined ? { ttlSeconds: args.ttlSeconds } : {}),
+            }, fetchImpl);
+        }
+        case 'inbox_read': {
+            const args = parseInboxReadArgs(rawArgs);
+            const params = new URLSearchParams();
+            if (args.cursor !== undefined)
+                params.set('cursor', args.cursor);
+            params.set('limit', String(args.limit));
+            params.set('unreadOnly', String(args.unreadOnly));
+            return readInboxAndMaybeAck(args, () => runPassGet(aisUrl, `/v1/agents/${agentId}/inbox?${params}`, runPassFile, fetchImpl), (messageIds) => runPassPost(aisUrl, `/v1/agents/${agentId}/inbox/ack`, runPassFile, { messageIds }, fetchImpl));
+        }
+        case 'inbox_ack': {
+            const args = parseInboxAckArgs(rawArgs);
+            return runPassPost(aisUrl, `/v1/agents/${agentId}/inbox/ack`, runPassFile, { messageIds: args.messageIds }, fetchImpl);
+        }
+        case 'handoff': {
+            const args = parseHandoffArgs(rawArgs);
+            return runPassPost(aisUrl, `/v1/agents/${agentId}/handoff`, runPassFile, {
+                ...(args.summary !== undefined ? { summary: args.summary } : {}),
+                ...(args.keyLearnings !== undefined ? { keyLearnings: args.keyLearnings } : {}),
+                ...(args.docPath !== undefined ? { docPath: args.docPath } : {}),
+                ...(args.docPrUrl !== undefined ? { docPrUrl: args.docPrUrl } : {}),
+            }, fetchImpl);
+        }
+        case 'agent_archive':
+        case 'agent_delete':
+            throw new OutOfScopeToolError(name, AGENT_ARCHIVE_KEY_MODE_DETAIL);
+        default:
+            return UNKNOWN_TOOL_RUN_PASS_MODE;
+    }
+}
+//# sourceMappingURL=run-pass-mode.js.map

package/dist/run-pass-mode.js.map

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

package/dist/session-identity.d.ts

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+declare const sessionIdentitySchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    source: z.ZodEnum<{
+        agent_load: "agent_load";
+        env: "env";
+    }>;
+    agentId: z.ZodString;
+}, z.core.$strict>;
+export type SessionIdentity = z.infer<typeof sessionIdentitySchema>;
+export declare const IDENTITY_REPAIR = "Set AIS_AGENT_ID for THIS session only \u2014 export it in the shell that launches aismemory, or set it in the env block of this session's own MCP config \u2014 then restart the session and run aismemory doctor. Switch agents inside a session with agent_load. Never pin a machine, install or harness to one agent; other sessions on this machine run as other agents.";
+export declare const RECENT_IDENTITY_CONFIRMATION_TTL_MS: number;
+export declare const WHOAMI_RETRY_BACKOFF_MS: readonly [250, 500];
+type Clock = () => number;
+type Sleep = (ms: number) => Promise<void>;
+export interface VerifyPinnedIdentityOptions {
+    /** Identifies the credential without storing the secret itself. */
+    credentialKey: string;
+    /** Switch and doctor checks must ask AIS and may not accept cached proof. */
+    freshOnly?: boolean;
+    clock?: Clock;
+    sleep?: Sleep;
+}
+export declare function identityCredentialFingerprint(kind: string, credential: string): string;
+export declare function clearPinnedIdentityConfirmation(pin: SessionIdentity | null, credentialKey?: string): void;
+/**
+ * Lists leftover per-harness manifest files from the removed machine-wide pin.
+ * They are read by nothing; doctor only reports them so a human can delete
+ * them deliberately. Never deletes anything.
+ */
+export declare function legacyHarnessManifests(home?: string): string[];
+/** Reads this process's own identity. No file, no shared state, no machine-wide pin. */
+export declare function loadSessionIdentity(env?: NodeJS.ProcessEnv): SessionIdentity | null;
+/** The identity this session holds after a successful in-session agent_load switch. */
+export declare function switchedTo(previous: SessionIdentity, agentId: string): SessionIdentity;
+export declare function assertPinnedAgent(pin: SessionIdentity | null, agentId: string): void;
+/** Verify the same whoami response exposed by the selected auth adapter, before every mutation. */
+export declare function verifyPinnedIdentity(pin: SessionIdentity | null, agentId: string, whoami: () => Promise<unknown>, options: VerifyPinnedIdentityOptions): Promise<void>;
+export declare function requiresIdentityGate(name: string, args: Record<string, unknown>): boolean;
+export {};