@4da/mcp-server 3.2.0 → 4.1.0

package/dist/tool-dispatch.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Tool Dispatch Registry
+ *
+ * Map-based dispatch replacing the monolithic switch statement in index.ts.
+ * All 33 execute functions are imported once and mapped by tool name.
+ *
+ * Adding a new tool = add to this map + schema-registry + barrel export.
+ */
+import type { FourDADatabase } from "./db.js";
+/**
+ * Executor signature — all tool execute functions follow this shape.
+ * Awaiting a sync return resolves immediately, so we can await uniformly.
+ *
+ * Uses `any` for params because each tool defines its own strict param type —
+ * type safety is enforced inside each tool file, not at the dispatch boundary.
+ * (The original switch statement used `as unknown as XParams` on every call.)
+ */
+export type ToolExecutor = (db: FourDADatabase, params: any) => unknown | Promise<unknown>;
+/**
+ * Dispatch a tool call by name. Awaits uniformly (no-op for sync executors).
+ * Returns MCP-formatted response with JSON-serialized result.
+ */
+export declare function dispatchTool(name: string, db: FourDADatabase, args: Record<string, unknown> | undefined): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+/** Check if a tool exists in the dispatch map */
+export declare function hasDispatchTool(name: string): boolean;
+/** Get count of registered tool executors */
+export declare function getDispatchToolCount(): number;
+//# sourceMappingURL=tool-dispatch.d.ts.map

package/dist/tool-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-dispatch.d.ts","sourceRoot":"","sources":["../src/tool-dispatch.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AA2C9C;;;;;;;GAOG;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAoE3F;;;GAGG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,cAAc,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GACxC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAU7D;AAED,iDAAiD;AACjD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,6CAA6C;AAC7C,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C"}

package/dist/tool-dispatch.js

@@ -0,0 +1,87 @@
+// SPDX-License-Identifier: FSL-1.1-Apache-2.0
+/**
+ * Tool Dispatch Registry
+ *
+ * Map-based dispatch replacing the monolithic switch statement in index.ts.
+ * All 33 execute functions are imported once and mapped by tool name.
+ *
+ * Adding a new tool = add to this map + schema-registry + barrel export.
+ */
+import { executeGetRelevantContent, executeGetContext, executeExplainRelevance, executeRecordFeedback, executeScoreAutopsy, executeTrendAnalysis, executeDailyBriefing, executeContextAnalysis, executeSourceHealth, executeTopicConnections, executeConfigValidator, executeLLMStatus, executeGetActionableSignals, executeExportContextPacket, executeKnowledgeGaps, executeSignalChains, executeSemanticShifts, executeReverseMentions, executeAttentionReport, executeProjectHealth, executeDecisionMemory, executeTechRadar, executeCheckDecisionAlignment, executeAgentMemory, executeAgentSessionBrief, executeDelegationScore, executeDeveloperDna, executeAutophagyStatus, executeDecisionWindows, executeCompoundAdvantage, executeRecordAgentFeedback, executeGetAgentFeedbackStats, executeWhatShouldIKnow, executeTrustSummary, executePreemptionFeed, executeVulnerabilityScan, } from "./tools/index.js";
+import { getLiveIntelligence } from "./live-singleton.js";
+/**
+ * Dispatch map — tool name → execute function
+ */
+const DISPATCH_MAP = {
+    // Core
+    get_relevant_content: executeGetRelevantContent,
+    get_context: executeGetContext,
+    explain_relevance: executeExplainRelevance,
+    record_feedback: executeRecordFeedback,
+    // Intelligence
+    score_autopsy: executeScoreAutopsy,
+    trend_analysis: executeTrendAnalysis,
+    daily_briefing: executeDailyBriefing,
+    context_analysis: executeContextAnalysis,
+    topic_connections: executeTopicConnections,
+    get_actionable_signals: executeGetActionableSignals,
+    signal_chains: executeSignalChains,
+    semantic_shifts: executeSemanticShifts,
+    attention_report: executeAttentionReport,
+    // Diagnostic
+    source_health: executeSourceHealth,
+    config_validator: executeConfigValidator,
+    llm_status: executeLLMStatus,
+    // Knowledge & Health
+    export_context_packet: executeExportContextPacket,
+    knowledge_gaps: executeKnowledgeGaps,
+    reverse_mentions: executeReverseMentions,
+    project_health: executeProjectHealth,
+    // Decision Intelligence
+    decision_memory: executeDecisionMemory,
+    tech_radar: executeTechRadar,
+    check_decision_alignment: executeCheckDecisionAlignment,
+    // Agent Autonomy
+    agent_memory: executeAgentMemory,
+    agent_session_brief: executeAgentSessionBrief,
+    delegation_score: executeDelegationScore,
+    // Developer DNA
+    developer_dna: executeDeveloperDna,
+    // Intelligence Metabolism
+    autophagy_status: executeAutophagyStatus,
+    decision_windows: executeDecisionWindows,
+    compound_advantage: executeCompoundAdvantage,
+    // Agent Feedback
+    record_agent_feedback: executeRecordAgentFeedback,
+    get_agent_feedback_stats: executeGetAgentFeedbackStats,
+    // Synthesis
+    what_should_i_know: executeWhatShouldIKnow,
+    // Trust & Preemption
+    trust_summary: executeTrustSummary,
+    preemption_feed: executePreemptionFeed,
+    // Live Intelligence
+    vulnerability_scan: (db, params) => executeVulnerabilityScan(db, params, getLiveIntelligence()),
+};
+/**
+ * Dispatch a tool call by name. Awaits uniformly (no-op for sync executors).
+ * Returns MCP-formatted response with JSON-serialized result.
+ */
+export async function dispatchTool(name, db, args) {
+    const executor = DISPATCH_MAP[name];
+    if (!executor) {
+        throw new Error(`Unknown tool: ${name}`);
+    }
+    const result = await executor(db, (args || {}));
+    return {
+        content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+    };
+}
+/** Check if a tool exists in the dispatch map */
+export function hasDispatchTool(name) {
+    return name in DISPATCH_MAP;
+}
+/** Get count of registered tool executors */
+export function getDispatchToolCount() {
+    return Object.keys(DISPATCH_MAP).length;
+}
+//# sourceMappingURL=tool-dispatch.js.map

package/dist/tool-dispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-dispatch.js","sourceRoot":"","sources":["../src/tool-dispatch.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C;;;;;;;GAOG;AAIH,OAAO,EACL,yBAAyB,EACzB,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,gBAAgB,EAChB,2BAA2B,EAC3B,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,6BAA6B,EAC7B,kBAAkB,EAClB,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,0BAA0B,EAC1B,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAa1D;;GAEG;AACH,MAAM,YAAY,GAAiC;IACjD,OAAO;IACP,oBAAoB,EAAE,yBAAyB;IAC/C,WAAW,EAAE,iBAAiB;IAC9B,iBAAiB,EAAE,uBAAuB;IAC1C,eAAe,EAAE,qBAAqB;IAEtC,eAAe;IACf,aAAa,EAAE,mBAAmB;IAClC,cAAc,EAAE,oBAAoB;IACpC,cAAc,EAAE,oBAAoB;IACpC,gBAAgB,EAAE,sBAAsB;IACxC,iBAAiB,EAAE,uBAAuB;IAC1C,sBAAsB,EAAE,2BAA2B;IACnD,aAAa,EAAE,mBAAmB;IAClC,eAAe,EAAE,qBAAqB;IACtC,gBAAgB,EAAE,sBAAsB;IAExC,aAAa;IACb,aAAa,EAAE,mBAAmB;IAClC,gBAAgB,EAAE,sBAAsB;IACxC,UAAU,EAAE,gBAAgB;IAE5B,qBAAqB;IACrB,qBAAqB,EAAE,0BAA0B;IACjD,cAAc,EAAE,oBAAoB;IACpC,gBAAgB,EAAE,sBAAsB;IACxC,cAAc,EAAE,oBAAoB;IAEpC,wBAAwB;IACxB,eAAe,EAAE,qBAAqB;IACtC,UAAU,EAAE,gBAAgB;IAC5B,wBAAwB,EAAE,6BAA6B;IAEvD,iBAAiB;IACjB,YAAY,EAAE,kBAAkB;IAChC,mBAAmB,EAAE,wBAAwB;IAC7C,gBAAgB,EAAE,sBAAsB;IAExC,gBAAgB;IAChB,aAAa,EAAE,mBAAmB;IAElC,0BAA0B;IAC1B,gBAAgB,EAAE,sBAAsB;IACxC,gBAAgB,EAAE,sBAAsB;IACxC,kBAAkB,EAAE,wBAAwB;IAE5C,iBAAiB;IACjB,qBAAqB,EAAE,0BAA0B;IACjD,wBAAwB,EAAE,4BAA4B;IAEtD,YAAY;IACZ,kBAAkB,EAAE,sBAAsB;IAE1C,qBAAqB;IACrB,aAAa,EAAE,mBAAmB;IAClC,eAAe,EAAE,qBAAqB;IAEtC,oBAAoB;IACpB,kBAAkB,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,wBAAwB,CAAC,EAAE,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAEhG,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAY,EACZ,EAAkB,EAClB,IAAyC;IAEzC,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,EAAE,CAA4B,CAAC,CAAC;IAC3E,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;KACnE,CAAC;AACJ,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI,IAAI,YAAY,CAAC;AAC9B,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,oBAAoB;IAClC,OAAO,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC;AAC1C,CAAC"}

package/dist/tools/agent-feedback-stats.d.ts

@@ -0,0 +1,30 @@
+/**
+ * get_agent_feedback_stats tool
+ *
+ * Get statistics on how agents have used 4DA recommendations.
+ * Shows which sources and topics are most valuable for AI-assisted development.
+ */
+import type { FourDADatabase } from "../db.js";
+import type { GetAgentFeedbackStatsParams, AgentFeedbackStats } from "../types.js";
+/**
+ * Tool definition for MCP registration
+ */
+export declare const agentFeedbackStatsTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            days: {
+                type: string;
+                description: string;
+                default: number;
+            };
+        };
+    };
+};
+/**
+ * Execute the get_agent_feedback_stats tool
+ */
+export declare function executeGetAgentFeedbackStats(db: FourDADatabase, params: GetAgentFeedbackStatsParams): AgentFeedbackStats;
+//# sourceMappingURL=agent-feedback-stats.d.ts.map

package/dist/tools/agent-feedback-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-feedback-stats.d.ts","sourceRoot":"","sources":["../../src/tools/agent-feedback-stats.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEnF;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;CAsBlC,CAAC;AAEF;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,2BAA2B,GAClC,kBAAkB,CAGpB"}

package/dist/tools/agent-feedback-stats.js

@@ -0,0 +1,41 @@
+// SPDX-License-Identifier: FSL-1.1-Apache-2.0
+/**
+ * get_agent_feedback_stats tool
+ *
+ * Get statistics on how agents have used 4DA recommendations.
+ * Shows which sources and topics are most valuable for AI-assisted development.
+ */
+/**
+ * Tool definition for MCP registration
+ */
+export const agentFeedbackStatsTool = {
+    name: "get_agent_feedback_stats",
+    description: `Get statistics on how agents have used 4DA recommendations.
+
+Shows which sources and topics are most valuable for AI-assisted development:
+- Total recommendations: used / rejected / partially_used counts
+- By source type: which sources produce the most agent-useful content
+- Top used item IDs (most frequently recommended and accepted)
+- Recent feedback entries
+
+Use this to understand what content is actually being used by AI agents
+and where PASIFA scoring can be improved.`,
+    inputSchema: {
+        type: "object",
+        properties: {
+            days: {
+                type: "number",
+                description: "Number of days to look back (default: 30, max: 365)",
+                default: 30,
+            },
+        },
+    },
+};
+/**
+ * Execute the get_agent_feedback_stats tool
+ */
+export function executeGetAgentFeedbackStats(db, params) {
+    const days = Math.max(1, Math.min(365, params.days ?? 30));
+    return db.getAgentFeedbackStats(days);
+}
+//# sourceMappingURL=agent-feedback-stats.js.map

package/dist/tools/agent-feedback-stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-feedback-stats.js","sourceRoot":"","sources":["../../src/tools/agent-feedback-stats.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C;;;;;GAKG;AAKH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,0BAA0B;IAChC,WAAW,EAAE;;;;;;;;;0CAS2B;IACxC,WAAW,EAAE;QACX,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qDAAqD;gBAClE,OAAO,EAAE,EAAE;aACZ;SACF;KACF;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAC1C,EAAkB,EAClB,MAAmC;IAEnC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3D,OAAO,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC"}

package/dist/tools/agent-memory.d.ts

@@ -0,0 +1,94 @@
+/**
+ * agent_memory tool
+ *
+ * Cross-agent persistent memory. What Claude Code learns, Cursor can access.
+ * Enables AI agents to store and recall memories across sessions and tools.
+ */
+import type { FourDADatabase } from "../db.js";
+export interface AgentMemoryParams {
+    action: "store" | "recall" | "recall_by_tags" | "get_recent";
+    session_id?: string;
+    agent_type?: string;
+    memory_type?: string;
+    subject?: string;
+    content?: string;
+    context_tags?: string[];
+    expires_at?: string;
+    query?: string;
+    filter_agent?: string;
+    limit?: number;
+    tags?: string[];
+    since?: string;
+}
+export declare const agentMemoryTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            action: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            session_id: {
+                type: string;
+                description: string;
+            };
+            agent_type: {
+                type: string;
+                description: string;
+            };
+            memory_type: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            subject: {
+                type: string;
+                description: string;
+            };
+            content: {
+                type: string;
+                description: string;
+            };
+            context_tags: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            expires_at: {
+                type: string;
+                description: string;
+            };
+            query: {
+                type: string;
+                description: string;
+            };
+            filter_agent: {
+                type: string;
+                description: string;
+            };
+            limit: {
+                type: string;
+                description: string;
+            };
+            tags: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            since: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function executeAgentMemory(db: FourDADatabase, params: AgentMemoryParams): object;
+//# sourceMappingURL=agent-memory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-memory.d.ts","sourceRoot":"","sources":["../../src/tools/agent-memory.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAM/C,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,GAAG,QAAQ,GAAG,gBAAgB,GAAG,YAAY,CAAC;IAE7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEhB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAmBD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmE3B,CAAC;AAkCF,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,iBAAiB,GACxB,MAAM,CA+LR"}

package/dist/tools/agent-memory.js

@@ -0,0 +1,262 @@
+// SPDX-License-Identifier: FSL-1.1-Apache-2.0
+/**
+ * agent_memory tool
+ *
+ * Cross-agent persistent memory. What Claude Code learns, Cursor can access.
+ * Enables AI agents to store and recall memories across sessions and tools.
+ */
+// ============================================================================
+// Tool Definition
+// ============================================================================
+export const agentMemoryTool = {
+    name: "agent_memory",
+    description: "Cross-agent persistent memory. Actions: store (save a memory), recall (search by subject), recall_by_tags (search by tags), get_recent (memories since timestamp). What one agent learns, all agents can access.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            action: {
+                type: "string",
+                enum: ["store", "recall", "recall_by_tags", "get_recent"],
+                description: "Action to perform",
+            },
+            session_id: {
+                type: "string",
+                description: "Session identifier (for store)",
+            },
+            agent_type: {
+                type: "string",
+                description: "Agent identifier, e.g. claude_code, cursor, windsurf (for store)",
+            },
+            memory_type: {
+                type: "string",
+                enum: ["discovery", "decision", "context", "warning", "preference"],
+                description: "Type of memory (for store). Default: context",
+            },
+            subject: {
+                type: "string",
+                description: "Short subject line for the memory (for store)",
+            },
+            content: {
+                type: "string",
+                description: "Full memory content (for store)",
+            },
+            context_tags: {
+                type: "array",
+                items: { type: "string" },
+                description: "Tags for categorization (for store)",
+            },
+            expires_at: {
+                type: "string",
+                description: "ISO datetime when this memory expires (for store, optional)",
+            },
+            query: {
+                type: "string",
+                description: "Search term to match against subject and tags (for recall)",
+            },
+            filter_agent: {
+                type: "string",
+                description: "Filter results to a specific agent type (for recall, get_recent)",
+            },
+            limit: {
+                type: "number",
+                description: "Max results to return (default 20)",
+            },
+            tags: {
+                type: "array",
+                items: { type: "string" },
+                description: "Tags to search for (for recall_by_tags)",
+            },
+            since: {
+                type: "string",
+                description: "ISO datetime to get memories after (for get_recent)",
+            },
+        },
+        required: ["action"],
+    },
+};
+// ============================================================================
+// Size Limits
+// ============================================================================
+/** Maximum content size per entry: 10KB */
+const MAX_CONTENT_BYTES = 10 * 1024;
+/** Maximum entries per agent */
+const MAX_ENTRIES_PER_AGENT = 1000;
+// ============================================================================
+// Helpers
+// ============================================================================
+function parseMemoryRow(row) {
+    return {
+        id: row.id,
+        session_id: row.session_id,
+        agent_type: row.agent_type,
+        memory_type: row.memory_type,
+        subject: row.subject,
+        content: row.content,
+        context_tags: JSON.parse(row.context_tags || "[]"),
+        created_at: row.created_at,
+        expires_at: row.expires_at,
+        promoted_to_decision_id: row.promoted_to_decision_id,
+    };
+}
+// ============================================================================
+// Execute
+// ============================================================================
+export function executeAgentMemory(db, params) {
+    const rawDb = db.getRawDb();
+    switch (params.action) {
+        // ========================================================================
+        // STORE
+        // ========================================================================
+        case "store": {
+            if (!params.subject || !params.content) {
+                return { error: "subject and content are required for store action" };
+            }
+            // --- Size limit: max 10KB per entry ---
+            const contentBytes = new TextEncoder().encode(params.content).length;
+            if (contentBytes > MAX_CONTENT_BYTES) {
+                return {
+                    error: `Content too large: ${contentBytes} bytes exceeds ${MAX_CONTENT_BYTES} byte limit (10KB)`,
+                };
+            }
+            // --- Storage quota: max 1000 entries per agent ---
+            const agentType = params.agent_type || "unknown";
+            try {
+                const countRow = rawDb
+                    .prepare(`SELECT COUNT(*) as cnt FROM agent_memory WHERE agent_type = ?`)
+                    .get(agentType);
+                const currentCount = countRow?.cnt ?? 0;
+                if (currentCount >= MAX_ENTRIES_PER_AGENT) {
+                    return {
+                        error: `Storage quota exceeded: agent "${agentType}" has ${currentCount} entries (max ${MAX_ENTRIES_PER_AGENT}). Delete old entries before storing new ones.`,
+                    };
+                }
+            }
+            catch (quotaErr) {
+                return {
+                    error: `Failed to check storage quota: ${quotaErr instanceof Error ? quotaErr.message : String(quotaErr)}`,
+                };
+            }
+            try {
+                const stmt = rawDb.prepare(`INSERT INTO agent_memory
+             (session_id, agent_type, memory_type, subject, content, context_tags, expires_at)
+           VALUES (?, ?, ?, ?, ?, ?, ?)`);
+                const result = stmt.run(params.session_id || "unknown", params.agent_type || "unknown", params.memory_type || "context", params.subject, params.content, JSON.stringify(params.context_tags || []), params.expires_at || null);
+                return {
+                    success: true,
+                    id: result.lastInsertRowid,
+                    message: `Memory stored: ${params.subject}`,
+                };
+            }
+            catch (error) {
+                return {
+                    error: `Failed to store memory: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        }
+        // ========================================================================
+        // RECALL
+        // ========================================================================
+        case "recall": {
+            if (!params.query) {
+                return { error: "query is required for recall action" };
+            }
+            try {
+                const pattern = `%${params.query.toLowerCase()}%`;
+                let sql = `SELECT id, session_id, agent_type, memory_type, subject, content,
+                          context_tags, created_at, expires_at, promoted_to_decision_id
+                   FROM agent_memory
+                   WHERE (LOWER(subject) LIKE ? OR LOWER(context_tags) LIKE ?)
+                   AND (expires_at IS NULL OR expires_at > datetime('now'))`;
+                const sqlParams = [pattern, pattern];
+                if (params.filter_agent) {
+                    sql += ` AND agent_type = ?`;
+                    sqlParams.push(params.filter_agent);
+                }
+                sql += ` ORDER BY created_at DESC LIMIT ?`;
+                sqlParams.push(params.limit || 20);
+                const rows = rawDb.prepare(sql).all(...sqlParams);
+                return {
+                    memories: rows.map(parseMemoryRow),
+                    count: rows.length,
+                };
+            }
+            catch (error) {
+                return {
+                    memories: [],
+                    count: 0,
+                    error: `Failed to recall memories: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        }
+        // ========================================================================
+        // RECALL BY TAGS
+        // ========================================================================
+        case "recall_by_tags": {
+            if (!params.tags || params.tags.length === 0) {
+                return { error: "tags array is required for recall_by_tags action" };
+            }
+            try {
+                // Build OR conditions for each tag
+                const conditions = params.tags.map(() => `LOWER(context_tags) LIKE ?`);
+                const tagParams = params.tags.map((t) => `%${t.toLowerCase()}%`);
+                const sql = `SELECT id, session_id, agent_type, memory_type, subject, content,
+                            context_tags, created_at, expires_at, promoted_to_decision_id
+                     FROM agent_memory
+                     WHERE (${conditions.join(" OR ")})
+                     AND (expires_at IS NULL OR expires_at > datetime('now'))
+                     ORDER BY created_at DESC LIMIT ?`;
+                const rows = rawDb
+                    .prepare(sql)
+                    .all(...tagParams, params.limit || 20);
+                return {
+                    memories: rows.map(parseMemoryRow),
+                    count: rows.length,
+                };
+            }
+            catch (error) {
+                return {
+                    memories: [],
+                    count: 0,
+                    error: `Failed to recall by tags: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        }
+        // ========================================================================
+        // GET RECENT
+        // ========================================================================
+        case "get_recent": {
+            const since = params.since ||
+                new Date(Date.now() - 24 * 60 * 60 * 1000).toISOString();
+            try {
+                let sql = `SELECT id, session_id, agent_type, memory_type, subject, content,
+                          context_tags, created_at, expires_at, promoted_to_decision_id
+                   FROM agent_memory
+                   WHERE created_at > ?`;
+                const sqlParams = [since];
+                if (params.filter_agent) {
+                    sql += ` AND agent_type = ?`;
+                    sqlParams.push(params.filter_agent);
+                }
+                sql += ` ORDER BY created_at DESC LIMIT ?`;
+                sqlParams.push(params.limit || 50);
+                const rows = rawDb.prepare(sql).all(...sqlParams);
+                return {
+                    memories: rows.map(parseMemoryRow),
+                    count: rows.length,
+                    since,
+                };
+            }
+            catch (error) {
+                return {
+                    memories: [],
+                    count: 0,
+                    since,
+                    error: `Failed to get recent memories: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        }
+        default:
+            return { error: `Unknown action: ${params.action}` };
+    }
+}
+//# sourceMappingURL=agent-memory.js.map

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

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

package/dist/tools/agent-session-brief.d.ts

@@ -0,0 +1,44 @@
+/**
+ * agent_session_brief tool
+ *
+ * Tailored session startup context for AI agents.
+ * Call at the START of every agent session to get caught up on:
+ * - Active developer decisions
+ * - Ecosystem changes (security, breaking, releases)
+ * - Recent agent memories from all agents
+ * - Latest briefing text
+ */
+import type { FourDADatabase } from "../db.js";
+export interface AgentSessionBriefParams {
+    agent_type?: string;
+    since?: string;
+    include_decisions?: boolean;
+    include_memories?: boolean;
+}
+export declare const agentSessionBriefTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            agent_type: {
+                type: string;
+                description: string;
+            };
+            since: {
+                type: string;
+                description: string;
+            };
+            include_decisions: {
+                type: string;
+                description: string;
+            };
+            include_memories: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+};
+export declare function executeAgentSessionBrief(db: FourDADatabase, params: AgentSessionBriefParams): object;
+//# sourceMappingURL=agent-session-brief.d.ts.map

package/dist/tools/agent-session-brief.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session-brief.d.ts","sourceRoot":"","sources":["../../src/tools/agent-session-brief.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAM/C,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAmCD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;CA2BjC,CAAC;AAMF,wBAAgB,wBAAwB,CACtC,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,uBAAuB,GAC9B,MAAM,CAwJR"}