@indexnetwork/protocol 6.12.1-rc.404.1 → 6.14.0-rc.406.1

package/dist/signals/domain/intent.state.js

@@ -0,0 +1,190 @@
+import { Annotation } from "@langchain/langgraph";
+/**
+ * The Graph State using LangGraph Annotations.
+ * This acts as the central bus for data flowing through our graph.
+ */
+export const IntentGraphState = Annotation.Root({
+    // --- Inputs (Required at start) ---
+    /**
+     * The unique identifier of the user whose intents are being processed.
+     * Required for database operations.
+     */
+    userId: (Annotation),
+    /**
+     * The user's profile context (Identity, Narrative, etc.)
+     */
+    userProfile: (Annotation),
+    /**
+     * Explicit input content (e.g., user message).
+     * Optional - graph might run on implicit only.
+     */
+    inputContent: (Annotation),
+    /**
+     * Conversation history for context-aware intent inference.
+     * Used to resolve anaphoric references ("that intent", "this goal").
+     * Limited to recent messages (typically last 10) for token efficiency.
+     * Optional - if not provided, intent inference uses only inputContent.
+     */
+    conversationContext: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => undefined,
+    }),
+    /**
+     * Operation mode controls graph flow and determines which nodes execute.
+     * - 'create': Full pipeline (prep → inference → verification → reconciliation → execution)
+     * - 'update': Skip verification if no new intents (prep → inference → reconciliation → execution)
+     * - 'delete': Skip inference and verification (prep → reconciliation → execution)
+     * - 'read': Fast path (prep → queryNode → END) — reads intents without LLM calls
+     * - 'propose': Inference + verification only, stops before reconciliation (no DB writes)
+     *
+     * Defaults to 'create' for backward compatibility.
+     */
+    operationMode: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => 'create',
+    }),
+    /**
+     * For update/delete operations, specifies which intent IDs to target.
+     * Optional - used when modifying or removing specific intents.
+     */
+    targetIntentIds: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => undefined,
+    }),
+    /**
+     * Optional material compare-and-set guard used only by recovery-answer
+     * updates. The database rechecks it while holding the final intent row lock.
+     */
+    expectedIntentFingerprint: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => undefined,
+    }),
+    /**
+     * Optional network scope (network ID). Used for linking created intents to a network
+     * and for scoping read operations. Prep always fetches ALL user intents via
+     * getActiveIntents(userId) regardless of network scope (for global dedup/reconciliation).
+     */
+    networkId: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => undefined,
+    }),
+    /** Focused request scope type for write-side assignment and follow-up queues. */
+    scopeType: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => undefined,
+    }),
+    /** Focused request scope id. When scopeType is `network`, this is the focused network id. */
+    scopeId: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => undefined,
+    }),
+    // --- Populated by Graph (Prep Node) ---
+    /**
+     * The formatted string of currently active intents.
+     * Always populated by prep via getActiveIntents(userId).
+     */
+    activeIntents: Annotation({
+        reducer: (curr, next) => next,
+        default: () => "",
+    }),
+    /** IDs of active intents owned by the graph user, used to fail closed on explicit updates. */
+    activeIntentIds: Annotation({
+        reducer: (curr, next) => next,
+        default: () => [],
+    }),
+    // --- Intermediate State ---
+    /**
+     * List of raw intents extracted from text.
+     */
+    inferredIntents: Annotation({
+        reducer: (curr, next) => next, // Overwrite with new inference
+        default: () => [],
+    }),
+    /**
+     * List of intents that have passed semantic verification.
+     * Invalid intents are filtered out before reaching this state.
+     */
+    verifiedIntents: Annotation({
+        reducer: (curr, next) => next,
+        default: () => [],
+    }),
+    /** Structured reasons for candidates rejected before persistence. */
+    validationFailures: Annotation({
+        reducer: (curr, next) => next,
+        default: () => [],
+    }),
+    // --- Output ---
+    /**
+     * Final actions to be performed on the DB (Create, Update, Expire).
+     */
+    actions: Annotation({
+        reducer: (curr, next) => next,
+        default: () => [],
+    }),
+    /**
+     * Results of executing actions against the database.
+     * Populated by executorNode after actions are persisted.
+     */
+    executionResults: Annotation({
+        reducer: (curr, next) => next,
+        default: () => [],
+    }),
+    // --- Error State ---
+    /**
+     * If set, indicates a fatal error that should short-circuit the graph to END.
+     * Populated by prep when a precondition fails (e.g. missing profile).
+     */
+    error: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => undefined,
+    }),
+    // --- Trace Output ---
+    /**
+     * Accumulated trace entries from each graph node.
+     * Used for observability: surfaces internal processing steps (inference,
+     * verification with Felicity scores, reconciliation) to the frontend.
+     */
+    trace: Annotation({
+        reducer: (curr, next) => [...curr, ...(next || [])],
+        default: () => [],
+    }),
+    /** Timing records for each agent invocation within this graph run. */
+    agentTimings: Annotation({
+        reducer: (acc, val) => [...acc, ...val],
+        default: () => [],
+    }),
+    // --- Read Mode Fields ---
+    /**
+     * For read mode: the set of network IDs the caller's agent can reach.
+     * When set and neither networkId nor queryUserId is provided, the graph
+     * returns the caller's own intents across all networks in this set (scope-aware
+     * default path). Derived by the tool layer from the scope envelope plus memberships.
+     */
+    indexScope: Annotation({
+        reducer: (_curr, next) => next,
+        default: () => undefined,
+    }),
+    /**
+     * For read mode: filter intents by a specific user when reading in a network.
+     * When omitted and network-scoped, returns all intents in the network.
+     */
+    queryUserId: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => undefined,
+    }),
+    /**
+     * For read mode: when true, return all of the current user's intents
+     * ignoring network scope. Used before create_intent to detect duplicates.
+     */
+    allUserIntents: Annotation({
+        reducer: (curr, next) => next ?? curr,
+        default: () => false,
+    }),
+    /**
+     * Output of read mode: queried intents with count and optional metadata.
+     */
+    readResult: Annotation({
+        reducer: (curr, next) => next,
+        default: () => undefined,
+    }),
+});

package/dist/signals/domain/signal.specificity.d.ts

@@ -0,0 +1,2 @@
+/** Default user-facing warning for broad attributive intent proposals. */
+export declare const DEFAULT_SPECIFICITY_WARNING = "This signal is broad and may produce many weak matches. Add a more concrete role, outcome, location, timeframe, domain, or specific need to get better recommendations.";

package/dist/signals/domain/signal.specificity.js

@@ -0,0 +1,2 @@
+/** Default user-facing warning for broad attributive intent proposals. */
+export const DEFAULT_SPECIFICITY_WARNING = "This signal is broad and may produce many weak matches. Add a more concrete role, outcome, location, timeframe, domain, or specific need to get better recommendations.";

package/dist/signals/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * signals — domain-first module root.
+ *
+ * Re-exports the curated public surface.  Other modules inside the signals
+ * capability import directly from signals/domain, signals/application, or
+ * signals/ports; this barrel is for cross-capability consumers that must go
+ * through the signals public surface.
+ *
+ * IND-544: canonical home for intent/signal behaviour that was previously
+ * spread across intent/*.  Legacy intent/* paths remain as compatibility
+ * re-exports pointing here.
+ */
+export * from "./public/index.js";

package/dist/signals/index.js

@@ -0,0 +1,13 @@
+/**
+ * signals — domain-first module root.
+ *
+ * Re-exports the curated public surface.  Other modules inside the signals
+ * capability import directly from signals/domain, signals/application, or
+ * signals/ports; this barrel is for cross-capability consumers that must go
+ * through the signals public surface.
+ *
+ * IND-544: canonical home for intent/signal behaviour that was previously
+ * spread across intent/*.  Legacy intent/* paths remain as compatibility
+ * re-exports pointing here.
+ */
+export * from "./public/index.js";

package/dist/signals/ports/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * signals/ports — narrow injected dependency contracts.
+ *
+ * Re-exports the subset of shared/interfaces types that the signals
+ * capability declares as explicit injected ports.  Consumers of the
+ * signals module should import these port types here rather than from
+ * the broader shared/interfaces barrel to keep the dependency surface
+ * narrow and auditable.
+ *
+ * Ports are migrated here incrementally; placeholders name the intended
+ * contracts before they are physically relocated.
+ */
+export type { IntentGraphDatabase } from "../../shared/interfaces/database.interface.js";
+export type { EmbeddingGenerator } from "../../shared/interfaces/embedder.interface.js";
+export type { IntentGraphQueue } from "../../shared/interfaces/queue.interface.js";

package/dist/signals/ports/index.js

@@ -0,0 +1,13 @@
+/**
+ * signals/ports — narrow injected dependency contracts.
+ *
+ * Re-exports the subset of shared/interfaces types that the signals
+ * capability declares as explicit injected ports.  Consumers of the
+ * signals module should import these port types here rather than from
+ * the broader shared/interfaces barrel to keep the dependency surface
+ * narrow and auditable.
+ *
+ * Ports are migrated here incrementally; placeholders name the intended
+ * contracts before they are physically relocated.
+ */
+export {};

package/dist/signals/public/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * signals/public — curated public surface of the signals capability.
+ *
+ * Re-exports the stable contracts from domain, application, and ports.
+ * Runtime adapter creation (createIntentTools) is NOT exported here; it is
+ * accessible via capabilities/signals.facade for package consumers and via
+ * the foreground shell (runtime/foreground/signals) for internal registries.
+ *
+ * Boundary: public-compatibility.  References only signals/domain,
+ * signals/application, and signals/ports — never runtime/foreground or
+ * host implementations.
+ */
+export { type VerifiedIntent, type IntentValidationFailureCategory, type IntentValidationFailure, type ExecutionResult, IntentGraphState, DEFAULT_SPECIFICITY_WARNING, } from "../domain/index.js";
+export { IntentGraphFactory, enforceIntentActionBoundary, buildExplicitUpdateActions, SemanticVerifier, type SemanticVerifierOutput, ExplicitIntentInferrer, type InferredIntent, type InferrerOptions, IntentClarifier, IntentReconciler, type IntentReconcilerOutput, type NormalizedIntentAction, IntentIndexer, IntentIndexerOutputSchema, type IntentIndexerOutput, describeIntentUpdateFailure, } from "../application/index.js";
+export type { IntentGraphDatabase, EmbeddingGenerator, IntentGraphQueue } from "../ports/index.js";

package/dist/signals/public/index.js

@@ -0,0 +1,16 @@
+/**
+ * signals/public — curated public surface of the signals capability.
+ *
+ * Re-exports the stable contracts from domain, application, and ports.
+ * Runtime adapter creation (createIntentTools) is NOT exported here; it is
+ * accessible via capabilities/signals.facade for package consumers and via
+ * the foreground shell (runtime/foreground/signals) for internal registries.
+ *
+ * Boundary: public-compatibility.  References only signals/domain,
+ * signals/application, and signals/ports — never runtime/foreground or
+ * host implementations.
+ */
+// ── Domain contracts ──────────────────────────────────────────────────────────
+export { IntentGraphState, DEFAULT_SPECIFICITY_WARNING, } from "../domain/index.js";
+// ── Application seams ─────────────────────────────────────────────────────────
+export { IntentGraphFactory, enforceIntentActionBoundary, buildExplicitUpdateActions, SemanticVerifier, ExplicitIntentInferrer, IntentClarifier, IntentReconciler, IntentIndexer, IntentIndexerOutputSchema, describeIntentUpdateFailure, } from "../application/index.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/protocol",
-  "version": "6.12.1-rc.404.1",
+  "version": "6.14.0-rc.406.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -17,11 +17,22 @@
     "CHANGELOG.md"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "rm -rf dist && tsc",
+    "build:package": "rm -rf dist && tsc --project tsconfig.package.json",
     "dev": "tsc --watch",
     "test": "bun test",
     "test:isolated": "bun scripts/test.ts",
+    "test:architecture": "bun test src/architecture/tests",
+    "architecture:exports": "bun scripts/architecture/export-inventory.ts",
+    "architecture:exports:update": "bun scripts/architecture/export-inventory.ts --write",
+    "architecture:consumer": "bunx tsc --project architecture/consumer/tsconfig.json",
+    "architecture:host-isolation": "bun scripts/architecture/host-isolation.ts",
+    "architecture:capabilities": "bun scripts/architecture/capability-boundaries.ts",
+    "architecture:cycles": "bun scripts/architecture/cycle-baseline.ts",
+    "architecture:artifacts": "bun run build && bun scripts/architecture/artifact-inventory.ts",
+    "architecture:check": "bun run architecture:exports && bun run architecture:consumer && bun run architecture:host-isolation && bun run architecture:capabilities && bun run architecture:cycles && bun run architecture:artifacts && bun run test:architecture",
     "prepublishOnly": "bun run build",
+    "prepack": "bun run build:package",
     "eval:matching": "bun --env-file=../../.env.test ./eval/matching/matching.eval.ts",
     "eval:hyde": "bun --env-file=../../.env.test ./eval/hyde/hyde.eval.ts",
     "eval:premise": "bun --env-file=../../.env.test ./eval/premise/premise.eval.ts",
@@ -37,11 +48,11 @@
     "@langchain/langgraph": "^1.1.2",
     "@langchain/openai": "^1.2.3",
     "@modelcontextprotocol/server": "^2.0.0-alpha.2",
-    "dotenv": "^16.3.1",
     "zod": "^3.22.4"
   },
   "devDependencies": {
     "@types/node": "^25.5.2",
+    "dotenv": "^16.3.1",
     "typescript": "^5.0.0"
   }
 }

package/dist/agent/agent.tools.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent.tools.d.ts","sourceRoot":"/","sources":["agent/agent.tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAuD5E,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,qDAyRtE"}

package/dist/agent/agent.tools.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agent.tools.js","sourceRoot":"/","sources":["agent/agent.tools.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\n\nimport type { DefineTool, ToolDeps } from '../shared/agent/tool.helpers.js';\nimport { error, success } from '../shared/agent/tool.helpers.js';\nimport { protocolLogger } from '../shared/observability/protocol.logger.js';\n\nconst logger = protocolLogger('ChatTools:Agent');\n\nconst AGENT_ACTIONS = [\n  'manage:profile',\n  'manage:intents',\n  'manage:networks',\n  'manage:contacts',\n  'manage:opportunities',\n  'manage:negotiations',\n] as const;\n\nfunction invalidActionMessage(action: string) {\n  return `Invalid action: ${action}. Valid actions: ${AGENT_ACTIONS.join(', ')}`;\n}\n\nfunction isValidAction(action: string): action is (typeof AGENT_ACTIONS)[number] {\n  return (AGENT_ACTIONS as readonly string[]).includes(action);\n}\n\nfunction requireAgentDatabase(deps: ToolDeps) {\n  if (!deps.agentDatabase) {\n    return null;\n  }\n\n  return deps.agentDatabase;\n}\n\nfunction ensureAgentScopedAccess(context: { agentId?: string }, requestedAgentId: string): string | null {\n  if (context.agentId && context.agentId !== requestedAgentId) {\n    return 'This agent can only manage its own registration.';\n  }\n\n  return null;\n}\n\nfunction sanitizeAgentForOutput<T extends { transports?: Array<{ channel: string; config: Record<string, unknown> }> }>(agent: T): T {\n  return {\n    ...agent,\n    transports: agent.transports,\n  };\n}\n\nfunction sanitizeAgentName(name: string): string | null {\n  const cleanName = name.trim();\n  return cleanName ? cleanName : null;\n}\n\nfunction normalizePermissions(permissions: string[] | undefined): string[] {\n  return [...new Set((permissions ?? []).map((action) => action.trim()).filter(Boolean))];\n}\n\nexport function createAgentTools(defineTool: DefineTool, deps: ToolDeps) {\n  const agentDb = requireAgentDatabase(deps);\n  if (!agentDb) {\n    return [];\n  }\n\n  const registerAgent = defineTool({\n    name: 'register_agent',\n    description:\n      'Register a new personal agent for the current user. Optionally configure initial permissions. ' +\n      'Use this when connecting an external agent to Index.',\n    querySchema: z.object({\n      name: z.string().min(1).describe('Display name for the agent.'),\n      description: z.string().optional().describe('What the agent does.'),\n      permissions: z.array(z.string()).optional().describe('Optional initial permission actions to grant.'),\n    }),\n    handler: async ({ context, query }) => {\n      if (context.agentId) {\n        return error(\n          'Agent registration must be done from a user session (web UI or personal API key), ' +\n          'not from within an existing agent context. To register a new agent, visit the Index web app.'\n        );\n      }\n\n      try {\n        const name = sanitizeAgentName(query.name);\n        if (!name) {\n          return error('Agent name is required.');\n        }\n\n        const permissions = normalizePermissions(query.permissions);\n        for (const permission of permissions) {\n          if (!isValidAction(permission)) {\n            return error(invalidActionMessage(permission));\n          }\n        }\n\n        const agent = await agentDb.createAgent({\n          ownerId: context.userId,\n          name,\n          description: query.description?.trim() || undefined,\n          type: 'external',\n        });\n\n        try {\n          if (permissions.length > 0) {\n            await agentDb.grantPermission({\n              agentId: agent.id,\n              userId: context.userId,\n              scope: 'global',\n              actions: permissions,\n            });\n          }\n        } catch (setupError) {\n          try {\n            await agentDb.deleteAgent(agent.id);\n          } catch {\n            // Best-effort cleanup to avoid leaving partially registered agents behind.\n          }\n\n          throw setupError;\n        }\n\n        const fullAgent = await agentDb.getAgentWithRelations(agent.id);\n        return success({\n          message: `Agent \"${agent.name}\" registered successfully.`,\n          agent: sanitizeAgentForOutput(fullAgent ?? ({ ...agent, transports: [], permissions: [] })),\n        });\n      } catch (err) {\n        logger.error('Failed to register agent', { err });\n        return error('Failed to register agent. Please try again.');\n      }\n    },\n  });\n\n  const listAgents = defineTool({\n    name: 'list_agents',\n    description: 'List all agents the current user owns or has authorized.',\n    querySchema: z.object({}),\n    handler: async ({ context }) => {\n      try {\n        const agents = await agentDb.listAgentsForUser(context.userId);\n        const filteredAgents = context.agentId\n          ? agents.filter((agent) => agent.id === context.agentId)\n          : agents;\n        return success({\n          agents: filteredAgents.map((agent) => sanitizeAgentForOutput(agent)),\n          count: filteredAgents.length,\n        });\n      } catch (err) {\n        logger.error('Failed to list agents', { err });\n        return error('Failed to list agents. Please try again.');\n      }\n    },\n  });\n\n  const updateAgent = defineTool({\n    name: 'update_agent',\n    description: 'Update an agent name, description, or status.',\n    querySchema: z.object({\n      agent_id: z.string().min(1).describe('The agent ID to update.'),\n      name: z.string().optional().describe('Updated display name.'),\n      description: z.string().optional().describe('Updated description.'),\n      status: z.enum(['active', 'inactive']).optional().describe('Updated status.'),\n    }),\n    handler: async ({ context, query }) => {\n      const scopeError = ensureAgentScopedAccess(context, query.agent_id);\n      if (scopeError) {\n        return error(scopeError);\n      }\n\n      try {\n        const agent = await agentDb.getAgent(query.agent_id);\n        if (!agent || agent.ownerId !== context.userId) {\n          return error('Agent not found');\n        }\n\n        if (agent.type === 'system') {\n          return error('System agents cannot be modified');\n        }\n\n        const updates: { name?: string; description?: string | null; status?: 'active' | 'inactive' } = {};\n        if (query.name !== undefined) {\n          const name = query.name.trim();\n          if (!name) {\n            return error('Agent name is required');\n          }\n          updates.name = name;\n        }\n        if (query.description !== undefined) {\n          updates.description = query.description.trim() || null;\n        }\n        if (query.status) {\n          updates.status = query.status;\n        }\n\n        if (Object.keys(updates).length === 0) {\n          return error('At least one field is required.');\n        }\n\n        const updated = await agentDb.updateAgent(query.agent_id, updates);\n        if (!updated) {\n          return error('Agent not found');\n        }\n\n        const fullAgent = await agentDb.getAgentWithRelations(query.agent_id);\n        return success({\n          message: 'Agent updated.',\n          agent: sanitizeAgentForOutput(fullAgent ?? ({ ...updated, transports: [], permissions: [] })),\n        });\n      } catch (err) {\n        logger.error('Failed to update agent', { err });\n        return error('Failed to update agent. Please try again.');\n      }\n    },\n  });\n\n  const deleteAgent = defineTool({\n    name: 'delete_agent',\n    description: 'Soft-delete a personal agent and deactivate its transports.',\n    querySchema: z.object({\n      agent_id: z.string().min(1).describe('The agent ID to delete.'),\n    }),\n    handler: async ({ context, query }) => {\n      const scopeError = ensureAgentScopedAccess(context, query.agent_id);\n      if (scopeError) {\n        return error(scopeError);\n      }\n\n      try {\n        const agent = await agentDb.getAgent(query.agent_id);\n        if (!agent || agent.ownerId !== context.userId) {\n          return error('Agent not found');\n        }\n        if (agent.type === 'system') {\n          return error('System agents cannot be deleted');\n        }\n\n        await agentDb.deleteAgent(query.agent_id);\n        return success({ message: `Agent \"${agent.name}\" deleted.` });\n      } catch (err) {\n        logger.error('Failed to delete agent', { err });\n        return error('Failed to delete agent. Please try again.');\n      }\n    },\n  });\n\n  const grantAgentPermission = defineTool({\n    name: 'grant_agent_permission',\n    description: 'Grant one or more permissions to an agent for the current user. ' +\n      'Valid actions: manage:profile, manage:intents, manage:networks, manage:contacts, manage:opportunities, manage:negotiations.',\n    querySchema: z.object({\n      agent_id: z.string().min(1).describe('The agent ID to grant permissions to.'),\n      actions: z.array(z.string()).min(1).describe('Permission actions to grant. Valid values: manage:profile, manage:intents, manage:networks, manage:contacts, manage:opportunities, manage:negotiations.'),\n      scope: z.enum(['global', 'node', 'network']).optional().describe('Optional permission scope.'),\n      scope_id: z.string().optional().describe('Scope target ID for node/network scopes.'),\n    }),\n    handler: async ({ context, query }) => {\n      const scopeError = ensureAgentScopedAccess(context, query.agent_id);\n      if (scopeError) {\n        return error(scopeError);\n      }\n\n      const actions = normalizePermissions(query.actions);\n      if (actions.length === 0) {\n        return error('At least one non-empty action is required.');\n      }\n\n      for (const action of actions) {\n        if (!isValidAction(action)) {\n          return error(invalidActionMessage(action));\n        }\n      }\n\n      if ((query.scope === 'network' || query.scope === 'node') && !query.scope_id?.trim()) {\n        return error(`scope_id is required for ${query.scope} permissions.`);\n      }\n\n      try {\n        const agent = await agentDb.getAgent(query.agent_id);\n        if (!agent || agent.ownerId !== context.userId) {\n          return error('Agent not found');\n        }\n\n        const permission = await agentDb.grantPermission({\n          agentId: query.agent_id,\n          userId: context.userId,\n          scope: query.scope,\n          scopeId: query.scope === 'global' || query.scope === undefined ? undefined : query.scope_id?.trim(),\n          actions,\n        });\n\n        return success({ message: 'Permission granted.', permission });\n      } catch (err) {\n        logger.error('Failed to grant permission', { err });\n        return error('Failed to grant permission. Please try again.');\n      }\n    },\n  });\n\n  const revokeAgentPermission = defineTool({\n    name: 'revoke_agent_permission',\n    description: 'Revoke a specific permission from an agent.',\n    querySchema: z.object({\n      agent_id: z.string().min(1).describe('The agent ID that owns the permission.'),\n      permission_id: z.string().min(1).describe('The permission ID to revoke.'),\n    }),\n    handler: async ({ context, query }) => {\n      const scopeError = ensureAgentScopedAccess(context, query.agent_id);\n      if (scopeError) {\n        return error(scopeError);\n      }\n\n      try {\n        const agent = await agentDb.getAgentWithRelations(query.agent_id);\n        if (!agent || agent.ownerId !== context.userId) {\n          return error('Agent not found');\n        }\n\n        const permission = agent.permissions.find((item) => item.id === query.permission_id);\n        if (!permission) {\n          return error('Permission not found');\n        }\n\n        await agentDb.revokePermission(query.permission_id);\n        return success({ message: 'Permission revoked.' });\n      } catch (err) {\n        logger.error('Failed to revoke permission', { err });\n        return error('Failed to revoke permission. Please try again.');\n      }\n    },\n  });\n\n  return [\n    registerAgent,\n    listAgents,\n    updateAgent,\n    deleteAgent,\n    grantAgentPermission,\n    revokeAgentPermission,\n  ] as const;\n}\n"]}

package/dist/agent/tests/fakes.d.ts

@@ -1,25 +0,0 @@
-/**
- * Minimal in-memory fake of the {@link AgentDatabase} interface used by agent
- * tool tests. Only the surface area exercised by the specs in this folder is
- * implemented — unused methods throw if called so tests fail loudly.
- */
-import type { AgentDatabase, AgentPermissionRecord, AgentRecord, AgentTransportRecord } from '../../shared/interfaces/agent.interface.js';
-export interface SeedAgentInput {
-    id: string;
-    ownerId: string;
-    name: string;
-    type?: 'personal' | 'external' | 'system';
-    description?: string | null;
-    status?: 'active' | 'inactive';
-}
-export interface FakeAgentDb extends AgentDatabase {
-    seedAgent(input: SeedAgentInput): Promise<AgentRecord>;
-    getPermissionsForAgent(agentId: string): AgentPermissionRecord[];
-    getTransportsForAgent(agentId: string): AgentTransportRecord[];
-}
-/**
- * Creates an in-memory agent database fake for unit tests. Only the methods
- * exercised by the agent tool specs are implemented; the rest throw.
- */
-export declare function createFakeAgentDb(): FakeAgentDb;
-//# sourceMappingURL=fakes.d.ts.map

package/dist/agent/tests/fakes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fakes.d.ts","sourceRoot":"/","sources":["agent/tests/fakes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,WAAW,EAAE,oBAAoB,EAAoF,MAAM,4CAA4C,CAAC;AAE5N,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC1C,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CAChC;AAED,MAAM,WAAW,WAAY,SAAQ,aAAa;IAChD,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACvD,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,EAAE,CAAC;IACjE,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAAC;CAChE;AAOD;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAsL/C"}

package/dist/agent/tests/fakes.js

@@ -1,178 +0,0 @@
-/**
- * Minimal in-memory fake of the {@link AgentDatabase} interface used by agent
- * tool tests. Only the surface area exercised by the specs in this folder is
- * implemented — unused methods throw if called so tests fail loudly.
- */
-function nextId(prefix, counter) {
-    counter.value += 1;
-    return `${prefix}-${counter.value}`;
-}
-/**
- * Creates an in-memory agent database fake for unit tests. Only the methods
- * exercised by the agent tool specs are implemented; the rest throw.
- */
-export function createFakeAgentDb() {
-    const agents = new Map();
-    const transports = new Map();
-    const permissions = new Map();
-    const agentCounter = { value: 0 };
-    const transportCounter = { value: 0 };
-    const permissionCounter = { value: 0 };
-    function buildRelations(agent) {
-        const agentTransports = [...transports.values()].filter((t) => t.agentId === agent.id);
-        const agentPermissions = [...permissions.values()].filter((p) => p.agentId === agent.id);
-        return {
-            ...agent,
-            transports: agentTransports,
-            permissions: agentPermissions,
-        };
-    }
-    const db = {
-        getPermissionsForAgent(agentId) {
-            return [...permissions.values()]
-                .filter((permission) => permission.agentId === agentId)
-                .map((permission) => ({ ...permission, actions: [...permission.actions] }));
-        },
-        getTransportsForAgent(agentId) {
-            return [...transports.values()]
-                .filter((transport) => transport.agentId === agentId)
-                .map((transport) => ({ ...transport }));
-        },
-        async seedAgent(input) {
-            const now = new Date();
-            const agent = {
-                id: input.id,
-                ownerId: input.ownerId,
-                name: input.name,
-                description: input.description ?? null,
-                type: input.type ?? 'external',
-                status: input.status ?? 'active',
-                metadata: {},
-                createdAt: now,
-                updatedAt: now,
-            };
-            agents.set(agent.id, agent);
-            return agent;
-        },
-        async createAgent(input) {
-            const now = new Date();
-            const agent = {
-                id: nextId('agent', agentCounter),
-                ownerId: input.ownerId,
-                name: input.name,
-                description: input.description ?? null,
-                type: input.type,
-                status: 'active',
-                metadata: input.metadata ?? {},
-                createdAt: now,
-                updatedAt: now,
-            };
-            agents.set(agent.id, agent);
-            return agent;
-        },
-        async getAgent(agentId) {
-            return agents.get(agentId) ?? null;
-        },
-        async getAgentWithRelations(agentId) {
-            const agent = agents.get(agentId);
-            if (!agent)
-                return null;
-            return buildRelations(agent);
-        },
-        async updateAgent(agentId, updates) {
-            const existing = agents.get(agentId);
-            if (!existing)
-                return null;
-            const updated = {
-                ...existing,
-                ...('name' in updates && updates.name !== undefined ? { name: updates.name } : {}),
-                ...('description' in updates && updates.description !== undefined ? { description: updates.description } : {}),
-                ...('status' in updates && updates.status !== undefined ? { status: updates.status } : {}),
-                ...('metadata' in updates && updates.metadata !== undefined ? { metadata: updates.metadata } : {}),
-                updatedAt: new Date(),
-            };
-            agents.set(agentId, updated);
-            return updated;
-        },
-        async deleteAgent(agentId) {
-            agents.delete(agentId);
-            for (const [id, transport] of transports) {
-                if (transport.agentId === agentId)
-                    transports.delete(id);
-            }
-            for (const [id, permission] of permissions) {
-                if (permission.agentId === agentId)
-                    permissions.delete(id);
-            }
-        },
-        async listAgentsForUser(userId) {
-            return [...agents.values()]
-                .filter((agent) => agent.ownerId === userId)
-                .map((agent) => buildRelations(agent));
-        },
-        async createTransport(input) {
-            const transport = {
-                id: nextId('transport', transportCounter),
-                agentId: input.agentId,
-                channel: input.channel,
-                config: input.config ?? {},
-                priority: input.priority ?? 0,
-                active: true,
-                failureCount: 0,
-            };
-            transports.set(transport.id, transport);
-            return transport;
-        },
-        async deleteTransport(transportId) {
-            transports.delete(transportId);
-        },
-        async recordTransportFailure(transportId) {
-            const transport = transports.get(transportId);
-            if (transport) {
-                transport.failureCount += 1;
-            }
-        },
-        async recordTransportSuccess(transportId) {
-            const transport = transports.get(transportId);
-            if (transport) {
-                transport.failureCount = 0;
-            }
-        },
-        async grantPermission(input) {
-            const permission = {
-                id: nextId('permission', permissionCounter),
-                agentId: input.agentId,
-                userId: input.userId,
-                scope: input.scope ?? 'global',
-                scopeId: input.scopeId ?? null,
-                actions: [...input.actions],
-                createdAt: new Date(),
-            };
-            permissions.set(permission.id, permission);
-            return permission;
-        },
-        async revokePermission(permissionId) {
-            permissions.delete(permissionId);
-        },
-        async hasPermission(agentId, userId, action, scope) {
-            const requestedScope = scope?.type ?? 'global';
-            const requestedScopeId = scope?.id ?? null;
-            return [...permissions.values()].some((permission) => permission.agentId === agentId &&
-                permission.userId === userId &&
-                permission.scope === requestedScope &&
-                (requestedScope === 'global' || permission.scopeId === requestedScopeId) &&
-                permission.actions.includes(action));
-        },
-        async findAuthorizedAgents() {
-            throw new Error('findAuthorizedAgents is not implemented in the fake agent DB.');
-        },
-        getSystemAgentIds() {
-            return {
-                chatOrchestrator: '00000000-0000-0000-0000-000000000001',
-                negotiator: '00000000-0000-0000-0000-000000000002',
-            };
-        },
-    };
-    return db;
-}
-//# sourceMappingURL=fakes.js.map

package/dist/agent/tests/fakes.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fakes.js","sourceRoot":"/","sources":["agent/tests/fakes.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Minimal in-memory fake of the {@link AgentDatabase} interface used by agent\n * tool tests. Only the surface area exercised by the specs in this folder is\n * implemented — unused methods throw if called so tests fail loudly.\n */\n\nimport type { AgentDatabase, AgentPermissionRecord, AgentRecord, AgentTransportRecord, AgentWithRelations, CreateAgentInput, CreateTransportInput, GrantPermissionInput } from '../../shared/interfaces/agent.interface.js';\n\nexport interface SeedAgentInput {\n  id: string;\n  ownerId: string;\n  name: string;\n  type?: 'personal' | 'external' | 'system';\n  description?: string | null;\n  status?: 'active' | 'inactive';\n}\n\nexport interface FakeAgentDb extends AgentDatabase {\n  seedAgent(input: SeedAgentInput): Promise<AgentRecord>;\n  getPermissionsForAgent(agentId: string): AgentPermissionRecord[];\n  getTransportsForAgent(agentId: string): AgentTransportRecord[];\n}\n\nfunction nextId(prefix: string, counter: { value: number }): string {\n  counter.value += 1;\n  return `${prefix}-${counter.value}`;\n}\n\n/**\n * Creates an in-memory agent database fake for unit tests. Only the methods\n * exercised by the agent tool specs are implemented; the rest throw.\n */\nexport function createFakeAgentDb(): FakeAgentDb {\n  const agents = new Map<string, AgentRecord>();\n  const transports = new Map<string, AgentTransportRecord>();\n  const permissions = new Map<string, AgentPermissionRecord>();\n  const agentCounter = { value: 0 };\n  const transportCounter = { value: 0 };\n  const permissionCounter = { value: 0 };\n\n  function buildRelations(agent: AgentRecord): AgentWithRelations {\n    const agentTransports = [...transports.values()].filter((t) => t.agentId === agent.id);\n    const agentPermissions = [...permissions.values()].filter((p) => p.agentId === agent.id);\n    return {\n      ...agent,\n      transports: agentTransports,\n      permissions: agentPermissions,\n    };\n  }\n\n  const db: FakeAgentDb = {\n    getPermissionsForAgent(agentId: string) {\n      return [...permissions.values()]\n        .filter((permission) => permission.agentId === agentId)\n        .map((permission) => ({ ...permission, actions: [...permission.actions] }));\n    },\n\n    getTransportsForAgent(agentId: string) {\n      return [...transports.values()]\n        .filter((transport) => transport.agentId === agentId)\n        .map((transport) => ({ ...transport }));\n    },\n\n    async seedAgent(input: SeedAgentInput) {\n      const now = new Date();\n      const agent: AgentRecord = {\n        id: input.id,\n        ownerId: input.ownerId,\n        name: input.name,\n        description: input.description ?? null,\n        type: input.type ?? 'external',\n        status: input.status ?? 'active',\n        metadata: {},\n        createdAt: now,\n        updatedAt: now,\n      };\n      agents.set(agent.id, agent);\n      return agent;\n    },\n\n    async createAgent(input: CreateAgentInput) {\n      const now = new Date();\n      const agent: AgentRecord = {\n        id: nextId('agent', agentCounter),\n        ownerId: input.ownerId,\n        name: input.name,\n        description: input.description ?? null,\n        type: input.type,\n        status: 'active',\n        metadata: input.metadata ?? {},\n        createdAt: now,\n        updatedAt: now,\n      };\n      agents.set(agent.id, agent);\n      return agent;\n    },\n\n    async getAgent(agentId: string) {\n      return agents.get(agentId) ?? null;\n    },\n\n    async getAgentWithRelations(agentId: string) {\n      const agent = agents.get(agentId);\n      if (!agent) return null;\n      return buildRelations(agent);\n    },\n\n    async updateAgent(agentId, updates) {\n      const existing = agents.get(agentId);\n      if (!existing) return null;\n      const updated: AgentRecord = {\n        ...existing,\n        ...('name' in updates && updates.name !== undefined ? { name: updates.name } : {}),\n        ...('description' in updates && updates.description !== undefined ? { description: updates.description } : {}),\n        ...('status' in updates && updates.status !== undefined ? { status: updates.status } : {}),\n        ...('metadata' in updates && updates.metadata !== undefined ? { metadata: updates.metadata } : {}),\n        updatedAt: new Date(),\n      };\n      agents.set(agentId, updated);\n      return updated;\n    },\n\n    async deleteAgent(agentId: string) {\n      agents.delete(agentId);\n      for (const [id, transport] of transports) {\n        if (transport.agentId === agentId) transports.delete(id);\n      }\n      for (const [id, permission] of permissions) {\n        if (permission.agentId === agentId) permissions.delete(id);\n      }\n    },\n\n    async listAgentsForUser(userId: string) {\n      return [...agents.values()]\n        .filter((agent) => agent.ownerId === userId)\n        .map((agent) => buildRelations(agent));\n    },\n\n    async createTransport(input: CreateTransportInput) {\n      const transport: AgentTransportRecord = {\n        id: nextId('transport', transportCounter),\n        agentId: input.agentId,\n        channel: input.channel,\n        config: input.config ?? {},\n        priority: input.priority ?? 0,\n        active: true,\n        failureCount: 0,\n      };\n      transports.set(transport.id, transport);\n      return transport;\n    },\n\n    async deleteTransport(transportId: string) {\n      transports.delete(transportId);\n    },\n\n    async recordTransportFailure(transportId: string) {\n      const transport = transports.get(transportId);\n      if (transport) {\n        transport.failureCount += 1;\n      }\n    },\n\n    async recordTransportSuccess(transportId: string) {\n      const transport = transports.get(transportId);\n      if (transport) {\n        transport.failureCount = 0;\n      }\n    },\n\n    async grantPermission(input: GrantPermissionInput) {\n      const permission: AgentPermissionRecord = {\n        id: nextId('permission', permissionCounter),\n        agentId: input.agentId,\n        userId: input.userId,\n        scope: input.scope ?? 'global',\n        scopeId: input.scopeId ?? null,\n        actions: [...input.actions],\n        createdAt: new Date(),\n      };\n      permissions.set(permission.id, permission);\n      return permission;\n    },\n\n    async revokePermission(permissionId: string) {\n      permissions.delete(permissionId);\n    },\n\n    async hasPermission(agentId, userId, action, scope) {\n      const requestedScope = scope?.type ?? 'global';\n      const requestedScopeId = scope?.id ?? null;\n      return [...permissions.values()].some(\n        (permission) =>\n          permission.agentId === agentId &&\n          permission.userId === userId &&\n          permission.scope === requestedScope &&\n          (requestedScope === 'global' || permission.scopeId === requestedScopeId) &&\n          permission.actions.includes(action),\n      );\n    },\n\n    async findAuthorizedAgents() {\n      throw new Error('findAuthorizedAgents is not implemented in the fake agent DB.');\n    },\n\n    getSystemAgentIds() {\n      return {\n        chatOrchestrator: '00000000-0000-0000-0000-000000000001',\n        negotiator: '00000000-0000-0000-0000-000000000002',\n      };\n    },\n  };\n\n  return db;\n}\n"]}