aismemory 0.7.1 → 0.7.3

package/dist/tool-args.js

@@ -16,7 +16,18 @@ export const rememberArgsSchema = z.object({
     type: memoryTypeSchema.optional().default('context'),
     importance: z.number().min(0).max(1).optional().default(0.5),
 });
+/**
+ * Optional delegated-read principal (CORBOT-3785D10D).
+ *
+ * Names ANOTHER agent whose memories should be read. The server refuses with
+ * 403 unless that agent's owner has granted this agent the `memory:read` scope
+ * and both share a tenant. Read-only — never accepted on a write tool.
+ */
+const principalAgentIdSchema = z
+    .string()
+    .regex(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i, 'principalAgentId must be a valid agent UUID');
 export const recallArgsSchema = z.object({
+    principalAgentId: principalAgentIdSchema.optional(),
     query: z
         .string({ message: 'query is required and must be a string' })
         .min(1, 'query is required and must be a string')
@@ -42,9 +53,129 @@ export const agentLoadArgsSchema = z.object({
         .trim()
         .min(1, 'agent_load: query is required')
         .max(500, 'agent_load: query exceeds maximum length of 500 characters'),
+    memoriesLimit: z.number().int().min(1).max(50).optional(),
 });
 /** Tools with no parameters — reject unexpected keys. */
 export const emptyArgsSchema = z.object({}).strict();
+/** full_context: optional delegated-read principal + configurable memory limit (CORBOT-45FE6ECE). */
+export const fullContextArgsSchema = z
+    .object({
+    principalAgentId: principalAgentIdSchema.optional(),
+    memoriesLimit: z.number().int().min(1).max(50).optional(),
+    /** View mode: full (default), lean (bounded), bootstrap (cross-harness session start). */
+    view: z.enum(['full', 'lean', 'bootstrap']).optional(),
+})
+    .strict();
+// ── Agent inbox (CORBOT-7115B8AE) ───────────────────────────────────────
+// Mirrors packages/agent-identity-service/src/core/inbox/types.ts and
+// mcp/handlers/agent-inbox-handlers.ts — this package cannot import from
+// agent-identity-service (it ships standalone to npm), so the limits and
+// arg shapes are duplicated here on purpose. Keep them in sync by hand if
+// the server side ever changes them.
+const AGENT_MESSAGE_KINDS = ['task', 'update', 'question', 'decision', 'handoff', 'ack'];
+export const INBOX_MAX_BODY_CHARS = 8_000;
+export const INBOX_MAX_TASK_ID_CHARS = 128;
+export const INBOX_MIN_TTL_SECONDS = 300;
+export const INBOX_MAX_TTL_SECONDS = 604_800;
+export const INBOX_DEFAULT_TTL_SECONDS = 7 * 24 * 60 * 60;
+export const INBOX_DEFAULT_PAGE_SIZE = 20;
+export const INBOX_MAX_PAGE_SIZE = 100;
+const inboxUuidSchema = z
+    .string()
+    .regex(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i, 'must be a valid uuid');
+export const inboxSendArgsSchema = z
+    .object({
+    recipientAgentId: inboxUuidSchema,
+    kind: z.enum(AGENT_MESSAGE_KINDS),
+    body: z
+        .string({ message: 'body is required' })
+        .min(1, 'body is required')
+        .max(INBOX_MAX_BODY_CHARS, `body exceeds ${INBOX_MAX_BODY_CHARS} characters`),
+    threadId: inboxUuidSchema.optional(),
+    taskId: z.string().min(1).max(INBOX_MAX_TASK_ID_CHARS).optional(),
+    inReplyTo: inboxUuidSchema.optional(),
+    messageId: inboxUuidSchema.optional(),
+    ttlSeconds: z.number().int().min(INBOX_MIN_TTL_SECONDS).max(INBOX_MAX_TTL_SECONDS).optional(),
+})
+    .strict();
+export const inboxReadArgsSchema = z
+    .object({
+    cursor: z.string().min(1).max(512).optional(),
+    limit: z.number().int().min(1).max(INBOX_MAX_PAGE_SIZE).optional().default(INBOX_DEFAULT_PAGE_SIZE),
+    // True by default, unlike the REST default of false — a harness reading
+    // its inbox wants what's new, not the whole retained stream (matches the
+    // MCP tool contract in agent-identity-service's inbox-tools.ts).
+    unreadOnly: z.boolean().optional().default(true),
+    ack: z.boolean().optional().default(false),
+})
+    .strict();
+// ── Goals (CORBOT-721e9a8b, L4 one-client-surface) ──────────────────────
+// Mirrors packages/agent-identity-service/src/api/routes/goals.ts and
+// core/state/IGoalService.ts — this package cannot import from
+// agent-identity-service (it ships standalone to npm), so the shapes are
+// duplicated here on purpose, same convention as the inbox tools above.
+const GOAL_STATUSES = ['draft', 'active', 'completing', 'completed', 'failed', 'cancelled'];
+export const GOAL_MAX_TITLE_CHARS = 500;
+export const GOAL_MAX_DESCRIPTION_CHARS = 10_000;
+export const GOAL_MAX_CRITERION_CHARS = 1_000;
+export const GOAL_MAX_CRITERIA_ITEMS = 50;
+export const GOAL_DEFAULT_PAGE_SIZE = 20;
+export const GOAL_MAX_PAGE_SIZE = 100;
+const goalUuidSchema = z
+    .string()
+    .regex(/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i, 'must be a valid uuid');
+export const goalCreateArgsSchema = z
+    .object({
+    title: z
+        .string({ message: 'title is required' })
+        .min(1, 'title is required')
+        .max(GOAL_MAX_TITLE_CHARS, `title exceeds ${GOAL_MAX_TITLE_CHARS} characters`),
+    description: z
+        .string({ message: 'description is required' })
+        .min(1, 'description is required')
+        .max(GOAL_MAX_DESCRIPTION_CHARS, `description exceeds ${GOAL_MAX_DESCRIPTION_CHARS} characters`),
+    successCriteria: z
+        .array(z.string().min(1).max(GOAL_MAX_CRITERION_CHARS))
+        .max(GOAL_MAX_CRITERIA_ITEMS, `successCriteria exceeds ${GOAL_MAX_CRITERIA_ITEMS} items`)
+        .optional(),
+    parentGoalId: goalUuidSchema.optional(),
+})
+    .strict();
+export const goalListArgsSchema = z
+    .object({
+    status: z.enum(GOAL_STATUSES).optional(),
+    page: z.number().int().min(1).optional(),
+    limit: z.number().int().min(1).max(GOAL_MAX_PAGE_SIZE).optional().default(GOAL_DEFAULT_PAGE_SIZE),
+    parentGoalId: goalUuidSchema.optional(),
+})
+    .strict();
+export const goalUpdateProgressArgsSchema = z
+    .object({
+    goalId: goalUuidSchema,
+    progress: z.number().min(0).max(100),
+})
+    .strict();
+export const goalCompleteArgsSchema = z
+    .object({
+    goalId: goalUuidSchema,
+    success: z.boolean({ message: 'success is required and must be a boolean' }),
+    notes: z.string().max(GOAL_MAX_DESCRIPTION_CHARS, `notes exceeds ${GOAL_MAX_DESCRIPTION_CHARS} characters`).optional(),
+    lessonsLearned: z
+        .array(z.string().min(1).max(GOAL_MAX_CRITERION_CHARS))
+        .max(GOAL_MAX_CRITERIA_ITEMS, `lessonsLearned exceeds ${GOAL_MAX_CRITERIA_ITEMS} items`)
+        .optional(),
+})
+    .strict();
+/** Mirrors AIS core/inbox/types.ts MAX_ACK_IDS — a page never exceeds it. */
+export const INBOX_MAX_ACK_IDS = 100;
+export const inboxAckArgsSchema = z
+    .object({
+    messageIds: z
+        .array(inboxUuidSchema)
+        .min(1, 'messageIds must contain at least one id')
+        .max(INBOX_MAX_ACK_IDS, `messageIds exceeds ${INBOX_MAX_ACK_IDS} items`),
+})
+    .strict();
 export function formatValidationError(error) {
     return error.issues
         .map((issue) => {
@@ -75,4 +206,28 @@ export function parseAgentLoadArgs(raw) {
 export function parseEmptyToolArgs(raw) {
     return parseOrThrow(emptyArgsSchema, raw);
 }
+export function parseFullContextArgs(raw) {
+    return parseOrThrow(fullContextArgsSchema, raw);
+}
+export function parseInboxSendArgs(raw) {
+    return parseOrThrow(inboxSendArgsSchema, raw);
+}
+export function parseInboxReadArgs(raw) {
+    return parseOrThrow(inboxReadArgsSchema, raw);
+}
+export function parseGoalCreateArgs(raw) {
+    return parseOrThrow(goalCreateArgsSchema, raw);
+}
+export function parseGoalListArgs(raw) {
+    return parseOrThrow(goalListArgsSchema, raw);
+}
+export function parseGoalUpdateProgressArgs(raw) {
+    return parseOrThrow(goalUpdateProgressArgsSchema, raw);
+}
+export function parseGoalCompleteArgs(raw) {
+    return parseOrThrow(goalCompleteArgsSchema, raw);
+}
+export function parseInboxAckArgs(raw) {
+    return parseOrThrow(inboxAckArgsSchema, raw);
+}
 //# sourceMappingURL=tool-args.js.map

package/dist/tool-args.js.map

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

package/dist/workspace-key-mode.d.ts

@@ -0,0 +1,40 @@
+export interface WorkspaceKeyConfig {
+    workspaceKey: string;
+    agentId: string;
+}
+/** Thrown by loadWorkspaceKeyConfig when AIS_WORKSPACE_KEY is set without AIS_AGENT_ID. */
+export declare class WorkspaceKeyConfigError extends Error {
+    constructor(message: string);
+}
+/**
+ * Thrown when agent_load probes a target agent's memory endpoint and
+ * receives a 403 AGENT_NOT_GRANTED response, meaning the workspace key
+ * has no grant for that agent.
+ */
+export declare class AgentNotGrantedError extends Error {
+    readonly targetAgentId: string;
+    constructor(targetAgentId: string);
+}
+/**
+ * Read workspace-key config from the environment.
+ *
+ * Returns null when AIS_WORKSPACE_KEY is unset -- the caller falls through to
+ * the agent-API-key / device-flow path. Throws WorkspaceKeyConfigError when
+ * the key is set but AIS_AGENT_ID is missing; the caller must print the
+ * message to stderr and exit nonzero, and must NEVER fall back to the device
+ * flow or create a provisional agent.
+ */
+export declare function loadWorkspaceKeyConfig(env?: Record<string, string | undefined>): WorkspaceKeyConfig | null;
+type FetchImpl = typeof globalThis.fetch;
+export declare function wksKeyPost(aisUrl: string, path: string, workspaceKey: string, body: unknown, fetchImpl?: FetchImpl): Promise<unknown>;
+export declare function wksKeyGet(aisUrl: string, path: string, workspaceKey: string, fetchImpl?: FetchImpl): Promise<unknown>;
+export declare function wksKeyPatch(aisUrl: string, path: string, workspaceKey: string, body: unknown, fetchImpl?: FetchImpl): Promise<unknown>;
+/** Sentinel returned for a tool name this dispatcher doesn't recognize. */
+export declare const UNKNOWN_TOOL_WORKSPACE_KEY_MODE: unique symbol;
+/** Result returned by agent_load on successful switch. */
+export interface AgentSwitchResult {
+    switched: true;
+    agentId: string;
+}
+export declare function dispatchToolWorkspaceKeyMode(aisUrl: string, config: WorkspaceKeyConfig, name: string, rawArgs: unknown, fetchImpl?: FetchImpl): Promise<unknown | typeof UNKNOWN_TOOL_WORKSPACE_KEY_MODE>;
+export {};

package/dist/workspace-key-mode.js

@@ -0,0 +1,258 @@
+/**
+ * Workspace key auth mode for the aismemory MCP client (CORBOT-3103ED88).
+ *
+ * Multi-agent workspace auth: a scoped `x-workspace-key` credential
+ * (AIS_WORKSPACE_KEY, prefix `ais_wk_`) that can access multiple agents
+ * within a workspace, unlike the single-agent `x-agent-api-key` mode.
+ * No device flow, no OAuth credential file, no DID key-auth.
+ *
+ * Server-side contract: the key authenticates ONLY
+ * `/v1/agents/:agentId/{memory,goals,dream,full-context}`, but unlike
+ * agent API keys, a workspace key may be granted access to multiple
+ * agents. `agent_load` is supported: it switches the active agent by
+ * probing the new agent's memory endpoint; a 403 AGENT_NOT_GRANTED
+ * means the workspace key has no grant for that agent.
+ *
+ * Precedence: workspace key -> agent API key -> DID/device flow.
+ */
+import { AisHttpError } from './ais-http-error.js';
+import { emitTelemetry } from './telemetry.js';
+import { OutOfScopeToolError } from './agent-key-mode.js';
+import { parseEmptyToolArgs, parseRecallArgs, parseFullContextArgs, parseRememberArgs, parseAgentLoadArgs, parseGoalCreateArgs, parseGoalListArgs, parseGoalUpdateProgressArgs, parseGoalCompleteArgs, } from './tool-args.js';
+/** Thrown by loadWorkspaceKeyConfig when AIS_WORKSPACE_KEY is set without AIS_AGENT_ID. */
+export class WorkspaceKeyConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'WorkspaceKeyConfigError';
+    }
+}
+/**
+ * Thrown when agent_load probes a target agent's memory endpoint and
+ * receives a 403 AGENT_NOT_GRANTED response, meaning the workspace key
+ * has no grant for that agent.
+ */
+export class AgentNotGrantedError extends Error {
+    targetAgentId;
+    constructor(targetAgentId) {
+        super(`Workspace key does not have a grant for agent "${targetAgentId}". ` +
+            'Ask the workspace owner to grant this key access to the target agent.');
+        this.name = 'AgentNotGrantedError';
+        this.targetAgentId = targetAgentId;
+    }
+}
+/**
+ * Read workspace-key config from the environment.
+ *
+ * Returns null when AIS_WORKSPACE_KEY is unset -- the caller falls through to
+ * the agent-API-key / device-flow path. Throws WorkspaceKeyConfigError when
+ * the key is set but AIS_AGENT_ID is missing; the caller must print the
+ * message to stderr and exit nonzero, and must NEVER fall back to the device
+ * flow or create a provisional agent.
+ */
+export function loadWorkspaceKeyConfig(env = process.env) {
+    const keyName = env['AIS_WORKSPACE_KEY'] !== undefined ? 'AIS_WORKSPACE_KEY' : 'AIS_API_KEY';
+    const rawKey = env[keyName];
+    // The generic alias may hold a workspace or agent key; other values are
+    // validated by loadAgentApiKeyConfig, never treated as service credentials.
+    if (keyName === 'AIS_API_KEY' && !rawKey?.trim().startsWith('ais_wk_'))
+        return null;
+    if (rawKey === undefined)
+        return null;
+    const workspaceKey = rawKey.trim();
+    if (workspaceKey === '') {
+        throw new WorkspaceKeyConfigError(`${keyName} is set but empty (or whitespace-only).\n` +
+            'Refusing to start: silently falling back to the device flow could ' +
+            'create a duplicate provisional agent.\n' +
+            'Unset the variable to use the device flow, or set a real ais_wk_ key.');
+    }
+    if (!workspaceKey.startsWith('ais_wk_')) {
+        throw new WorkspaceKeyConfigError(`${keyName} does not look like a workspace key -- expected the ` +
+            'ais_wk_ prefix. Agent API keys (ais_ak_) go in AIS_AGENT_API_KEY; ' +
+            'service keys and JWTs do not work here.');
+    }
+    const agentId = env['AIS_AGENT_ID']?.trim();
+    if (!agentId) {
+        throw new WorkspaceKeyConfigError(`${keyName} is set but AIS_AGENT_ID is missing.\n` +
+            'Workspace keys need a default agent -- set AIS_AGENT_ID to the id ' +
+            'of the agent this session should start with (agent_load can switch later).\n' +
+            'Refusing to start: falling back to the device flow or creating a new ' +
+            'provisional agent would silently create a duplicate agent.');
+    }
+    return { workspaceKey, agentId };
+}
+async function readJson(res) {
+    return res.json().catch(() => null);
+}
+export async function wksKeyPost(aisUrl, path, workspaceKey, body, fetchImpl = globalThis.fetch) {
+    const headers = {
+        'Content-Type': 'application/json',
+        'x-workspace-key': workspaceKey,
+    };
+    let res;
+    try {
+        res = await fetchImpl(`${aisUrl}${path}`, { method: 'POST', headers, body: JSON.stringify(body) });
+    }
+    catch (err) {
+        emitTelemetry({ event: 'ais.http.failure', path, error: err instanceof Error ? err.message : String(err) });
+        throw err;
+    }
+    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 wksKeyGet(aisUrl, path, workspaceKey, fetchImpl = globalThis.fetch) {
+    let res;
+    try {
+        res = await fetchImpl(`${aisUrl}${path}`, { headers: { 'x-workspace-key': workspaceKey } });
+    }
+    catch (err) {
+        emitTelemetry({ event: 'ais.http.failure', path, error: err instanceof Error ? err.message : String(err) });
+        throw err;
+    }
+    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 wksKeyPatch(aisUrl, path, workspaceKey, body, fetchImpl = globalThis.fetch) {
+    const headers = {
+        'Content-Type': 'application/json',
+        'x-workspace-key': workspaceKey,
+    };
+    let res;
+    try {
+        res = await fetchImpl(`${aisUrl}${path}`, { method: 'PATCH', headers, body: JSON.stringify(body) });
+    }
+    catch (err) {
+        emitTelemetry({ event: 'ais.http.failure', path, error: err instanceof Error ? err.message : String(err) });
+        throw err;
+    }
+    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;
+}
+// -- Scoped tool dispatch --------------------------------------------------
+/** Sentinel returned for a tool name this dispatcher doesn't recognize. */
+export const UNKNOWN_TOOL_WORKSPACE_KEY_MODE = Symbol('unknown-tool-workspace-key-mode');
+export async function dispatchToolWorkspaceKeyMode(aisUrl, config, name, rawArgs, fetchImpl = globalThis.fetch) {
+    const { agentId, workspaceKey } = config;
+    switch (name) {
+        case 'remember': {
+            const args = parseRememberArgs(rawArgs);
+            return wksKeyPost(aisUrl, `/v1/agents/${agentId}/memory`, workspaceKey, {
+                content: args.content,
+                type: args.type,
+                importance: args.importance,
+            }, fetchImpl);
+        }
+        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.principalAgentId !== undefined) {
+                params.set('principalAgentId', args.principalAgentId);
+            }
+            return wksKeyGet(aisUrl, `/v1/agents/${agentId}/memory?${params}`, workspaceKey, 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));
+            const fcQs = fcParams.toString();
+            const fcPath = `/v1/agents/${agentId}/full-context${fcQs ? `?${fcQs}` : ''}`;
+            return wksKeyGet(aisUrl, fcPath, workspaceKey, fetchImpl);
+        }
+        case 'dream':
+            parseEmptyToolArgs(rawArgs);
+            return wksKeyPost(aisUrl, `/v1/agents/${agentId}/dream`, workspaceKey, {}, fetchImpl);
+        case 'whoami': {
+            parseEmptyToolArgs(rawArgs);
+            await wksKeyGet(aisUrl, `/v1/agents/${agentId}/memory?limit=1`, workspaceKey, fetchImpl);
+            return {
+                success: true,
+                data: {
+                    agentId,
+                    authMode: 'workspace-key',
+                    keyValid: true,
+                },
+            };
+        }
+        case 'agent_load': {
+            const args = parseAgentLoadArgs(rawArgs);
+            const targetAgentId = args.query.trim();
+            // Probe the target agent's memory endpoint to verify the workspace key
+            // has a grant. If the server returns 403 AGENT_NOT_GRANTED, surface a
+            // typed error so the caller knows the switch failed due to scope.
+            try {
+                await wksKeyGet(aisUrl, `/v1/agents/${targetAgentId}/memory?limit=1`, workspaceKey, fetchImpl);
+            }
+            catch (err) {
+                if (err instanceof AisHttpError && err.status === 403) {
+                    throw new AgentNotGrantedError(targetAgentId);
+                }
+                throw err;
+            }
+            const result = { switched: true, agentId: targetAgentId };
+            return result;
+        }
+        case 'goal_create': {
+            const args = parseGoalCreateArgs(rawArgs);
+            return wksKeyPost(aisUrl, `/v1/agents/${agentId}/goals`, workspaceKey, {
+                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 wksKeyGet(aisUrl, `/v1/agents/${agentId}/goals?${params}`, workspaceKey, fetchImpl);
+        }
+        case 'goal_update_progress': {
+            const args = parseGoalUpdateProgressArgs(rawArgs);
+            return wksKeyPatch(aisUrl, `/v1/agents/${agentId}/goals/${args.goalId}`, workspaceKey, {
+                progress: args.progress,
+            }, fetchImpl);
+        }
+        case 'goal_complete': {
+            const args = parseGoalCompleteArgs(rawArgs);
+            return wksKeyPost(aisUrl, `/v1/agents/${agentId}/goals/${args.goalId}/complete`, workspaceKey, {
+                success: args.success,
+                ...(args.notes !== undefined ? { notes: args.notes } : {}),
+                ...(args.lessonsLearned !== undefined ? { lessonsLearned: args.lessonsLearned } : {}),
+            }, fetchImpl);
+        }
+        // inbox_ack is intentionally NOT handled here: workspace keys are scoped to
+        // memory, goals, dream, full-context only (no 'inbox' in the server-side
+        // allowlist — see workspaceKeyAuth.ts), matching inbox_send/inbox_read's
+        // existing absence from this dispatcher.
+        case 'handoff':
+            throw new OutOfScopeToolError('handoff', "the handoff route is outside the key's allowed scope (memory, goals, dream, full-context).");
+        default:
+            return UNKNOWN_TOOL_WORKSPACE_KEY_MODE;
+    }
+}
+//# sourceMappingURL=workspace-key-mode.js.map

package/dist/workspace-key-mode.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aismemory",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "description": "Persistent memory for AI agents. MCP server that connects to Agent Identity Service.",
   "mcpName": "ai.agentsandswarms/ais-memory",
   "type": "module",