agent-working-memory 0.6.0 → 0.6.1

package/dist/coordination/index.js

@@ -7,20 +7,61 @@
 import { ZodError } from 'zod';
 import { initCoordinationTables } from './schema.js';
 import { registerCoordinationRoutes } from './routes.js';
-import { cleanSlate } from './stale.js';
+import { cleanSlate, pruneOldHeartbeats, purgeDeadAgents } from './stale.js';
+import { createWriteMutex, needsWriteLock } from './write-mutex.js';
+import { createEventBus } from './events.js';
+import { loadPlugins, teardownPlugins } from './plugin-loader.js';
+/** Active cleanup intervals — cleared on shutdown. */
+const cleanupIntervals = [];
+/** Singleton event bus for this coordination module instance. */
+let coordinationEventBus = null;
+/** Get the coordination event bus (available after initCoordination). */
+export function getEventBus() {
+    return coordinationEventBus;
+}
 /** Check if coordination is enabled via environment variable. */
 export function isCoordinationEnabled() {
     const val = process.env.AWM_COORDINATION;
     return val === 'true' || val === '1';
 }
 /** Initialize the coordination module: create tables, clean slate, mount routes, error handler. */
-export function initCoordination(app, db) {
+export function initCoordination(app, db, store) {
     // Create coordination tables (idempotent)
     initCoordinationTables(db);
     // Clean slate: mark stale agents as dead from previous sessions
     cleanSlate(db);
+    // CORS — allow localhost origins only (coordination is local-only)
+    app.addHook('onRequest', async (request, reply) => {
+        const origin = request.headers.origin ?? '';
+        if (/^https?:\/\/localhost(:\d+)?$/.test(origin) || /^https?:\/\/127\.0\.0\.1(:\d+)?$/.test(origin)) {
+            reply.header('Access-Control-Allow-Origin', origin);
+            reply.header('Access-Control-Allow-Methods', 'GET, POST, PATCH, PUT, DELETE, OPTIONS');
+            reply.header('Access-Control-Allow-Headers', 'Content-Type, Authorization');
+        }
+        if (request.method === 'OPTIONS') {
+            return reply.code(204).send();
+        }
+    });
+    // Body size limit — 256KB max for coordination requests (tasks with context can be large)
+    app.addHook('onRoute', (routeOptions) => {
+        if (!routeOptions.bodyLimit) {
+            routeOptions.bodyLimit = 256_000;
+        }
+    });
+    // Write serialization: serialize POST/PATCH/PUT/DELETE through a mutex
+    // to prevent SQLITE_BUSY under 5+ concurrent worker burst
+    const writeMutex = createWriteMutex();
+    app.addHook('preHandler', async (request, reply) => {
+        if (needsWriteLock(request.method, request.url)) {
+            const release = await writeMutex.acquire();
+            // Release after response is sent (onResponse fires after reply)
+            reply.raw.on('finish', release);
+        }
+    });
+    // Create event bus for decoupled side-effects
+    coordinationEventBus = createEventBus();
     // Mount all coordination HTTP routes
-    registerCoordinationRoutes(app, db);
+    registerCoordinationRoutes(app, db, store, coordinationEventBus);
     // ZodError handler — coordination routes use .parse() which throws on invalid params
     app.setErrorHandler((error, _request, reply) => {
         if (error instanceof ZodError) {
@@ -34,6 +75,49 @@ export function initCoordination(app, db) {
             error: { code: 'INTERNAL_ERROR', message: error.message },
         });
     });
+    // Periodic cleanup: prune heartbeat events every 30 min, purge dead agents every hour
+    cleanupIntervals.push(setInterval(() => {
+        try {
+            pruneOldHeartbeats(db);
+        }
+        catch { /* db may be closed */ }
+    }, 30 * 60 * 1000), setInterval(() => {
+        try {
+            purgeDeadAgents(db, 24);
+        }
+        catch { /* db may be closed */ }
+    }, 60 * 60 * 1000));
+    // Periodic channel liveness probe every 60s — mark unreachable sessions as disconnected
+    cleanupIntervals.push(setInterval(async () => {
+        try {
+            const sessions = db.prepare(`SELECT agent_id, channel_id FROM coord_channel_sessions WHERE status = 'connected'`).all();
+            for (const session of sessions) {
+                try {
+                    const res = await fetch(`${session.channel_id}/health`, {
+                        signal: AbortSignal.timeout(3000),
+                    });
+                    if (!res.ok) {
+                        db.prepare(`UPDATE coord_channel_sessions SET status = 'disconnected' WHERE agent_id = ?`).run(session.agent_id);
+                    }
+                }
+                catch {
+                    db.prepare(`UPDATE coord_channel_sessions SET status = 'disconnected' WHERE agent_id = ?`).run(session.agent_id);
+                }
+            }
+        }
+        catch { /* db may be closed */ }
+    }, 60_000));
+    // Load plugins (async — fire and forget, errors logged per-plugin)
+    loadPlugins({ events: coordinationEventBus, db, fastify: app }).catch((err) => {
+        console.error('  [plugin] Plugin loader error:', err.message);
+    });
     console.log('  Coordination module enabled');
 }
+/** Stop periodic cleanup intervals and teardown plugins. Call on server shutdown. */
+export async function stopCoordinationCleanup() {
+    for (const id of cleanupIntervals)
+        clearInterval(id);
+    cleanupIntervals.length = 0;
+    await teardownPlugins();
+}
 //# sourceMappingURL=index.js.map

package/dist/coordination/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/coordination/index.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,sCAAsC;AACtC;;;GAGG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAC/B,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,iEAAiE;AACjE,MAAM,UAAU,qBAAqB;IACnC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IACzC,OAAO,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC;AACvC,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,gBAAgB,CAAC,GAAoB,EAAE,EAAqB;IAC1E,0CAA0C;IAC1C,sBAAsB,CAAC,EAAE,CAAC,CAAC;IAE3B,gEAAgE;IAChE,UAAU,CAAC,EAAE,CAAC,CAAC;IAEf,qCAAqC;IACrC,0BAA0B,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAEpC,qFAAqF;IACrF,GAAG,CAAC,eAAe,CAAC,CAAC,KAAsC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;QAC9E,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;gBAC5B,IAAI,EAAE,IAAI;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE;aAC5F,CAAC,CAAC;QACL,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;YACzC,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE;SAC1D,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/coordination/index.ts"],"names":[],"mappings":"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"}

package/dist/coordination/peer-decisions.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Peer-decision injection for memory_recall.
+ *
+ * When coordination is enabled, memory_recall appends recent decisions
+ * made by OTHER agents that are relevant to the current recall query.
+ * This enables passive cross-agent knowledge sharing without explicit
+ * communication.
+ */
+import type Database from 'better-sqlite3';
+export interface PeerDecision {
+    id: number;
+    author_name: string;
+    assignment_id: string | null;
+    tags: string | null;
+    summary: string;
+    created_at: string;
+}
+/**
+ * Extract significant keywords from a recall query for relevance matching.
+ * Returns up to maxKeywords words of length >= 4 that are not stop words.
+ */
+export declare function extractKeywords(query: string, maxKeywords?: number): string[];
+/**
+ * Query coord_decisions for recent decisions by agents OTHER than the current one
+ * that are relevant to the given query string.
+ *
+ * @param db         The shared coordination database handle.
+ * @param selfName   The current agent's name (AWM_AGENT_ID / WORKER_NAME). Excluded from results.
+ * @param query      The recall query text used for keyword relevance matching.
+ * @param windowHours  How far back to look (default 1 hour).
+ * @param limit      Maximum number of decisions to return (default 5).
+ * @returns Array of peer decisions, ordered newest-first. Empty array on any error.
+ */
+export declare function queryPeerDecisions(db: Database.Database, selfName: string, query: string, windowHours?: number, limit?: number): PeerDecision[];
+/**
+ * Format peer decisions as a text section to append to memory_recall output.
+ * Returns an empty string when there are no peer decisions.
+ */
+export declare function formatPeerDecisions(decisions: PeerDecision[], windowHours?: number): string;
+//# sourceMappingURL=peer-decisions.d.ts.map

package/dist/coordination/peer-decisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-decisions.d.ts","sourceRoot":"","sources":["../../src/coordination/peer-decisions.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAWD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,SAAI,GAAG,MAAM,EAAE,CAOxE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,WAAW,SAAI,EACf,KAAK,SAAI,GACR,YAAY,EAAE,CAgChB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,YAAY,EAAE,EAAE,WAAW,SAAI,GAAG,MAAM,CAKtF"}

package/dist/coordination/peer-decisions.js

@@ -0,0 +1,82 @@
+// Copyright 2026 Robert Winter / Complete Ideas
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Peer-decision injection for memory_recall.
+ *
+ * When coordination is enabled, memory_recall appends recent decisions
+ * made by OTHER agents that are relevant to the current recall query.
+ * This enables passive cross-agent knowledge sharing without explicit
+ * communication.
+ */
+/** Stop words filtered out before keyword matching. */
+const STOP_WORDS = new Set([
+    'that', 'this', 'with', 'from', 'have', 'been', 'will', 'when', 'what',
+    'which', 'then', 'than', 'into', 'over', 'after', 'some', 'more', 'also',
+    'most', 'other', 'each', 'such', 'only', 'just', 'about', 'there', 'their',
+    'where', 'would', 'could', 'should', 'these', 'those', 'make', 'made',
+    'using', 'used', 'call', 'calls', 'does', 'done', 'were', 'they',
+]);
+/**
+ * Extract significant keywords from a recall query for relevance matching.
+ * Returns up to maxKeywords words of length >= 4 that are not stop words.
+ */
+export function extractKeywords(query, maxKeywords = 8) {
+    return query
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, ' ')
+        .split(/\s+/)
+        .filter(w => w.length >= 4 && !STOP_WORDS.has(w))
+        .slice(0, maxKeywords);
+}
+/**
+ * Query coord_decisions for recent decisions by agents OTHER than the current one
+ * that are relevant to the given query string.
+ *
+ * @param db         The shared coordination database handle.
+ * @param selfName   The current agent's name (AWM_AGENT_ID / WORKER_NAME). Excluded from results.
+ * @param query      The recall query text used for keyword relevance matching.
+ * @param windowHours  How far back to look (default 1 hour).
+ * @param limit      Maximum number of decisions to return (default 5).
+ * @returns Array of peer decisions, ordered newest-first. Empty array on any error.
+ */
+export function queryPeerDecisions(db, selfName, query, windowHours = 1, limit = 5) {
+    try {
+        const safeHours = Math.max(0.1, Math.min(windowHours, 168)); // 6min – 1 week
+        const safeLimit = Math.max(1, Math.min(limit, 50));
+        const keywords = extractKeywords(query);
+        const baseWhere = `
+      d.created_at >= datetime('now', '-${safeHours} hours')
+      AND a.name != ?
+    `;
+        const select = `
+      SELECT d.id, a.name AS author_name, d.assignment_id, d.tags, d.summary, d.created_at
+      FROM coord_decisions d
+      JOIN coord_agents a ON d.author_id = a.id
+    `;
+        if (keywords.length === 0) {
+            // No useful keywords — return the N most recent decisions from other agents
+            const sql = `${select} WHERE ${baseWhere} ORDER BY d.created_at DESC LIMIT ?`;
+            return db.prepare(sql).all(selfName, safeLimit);
+        }
+        // Build keyword filter: match any keyword in summary or tags
+        const kwClauses = keywords.map(() => `(d.summary LIKE ? OR d.tags LIKE ?)`).join(' OR ');
+        const sql = `${select} WHERE ${baseWhere} AND (${kwClauses}) ORDER BY d.created_at DESC LIMIT ?`;
+        const kwParams = keywords.flatMap(kw => [`%${kw}%`, `%${kw}%`]);
+        return db.prepare(sql).all(selfName, ...kwParams, safeLimit);
+    }
+    catch {
+        return []; // non-fatal — peer decisions are best-effort
+    }
+}
+/**
+ * Format peer decisions as a text section to append to memory_recall output.
+ * Returns an empty string when there are no peer decisions.
+ */
+export function formatPeerDecisions(decisions, windowHours = 1) {
+    if (decisions.length === 0)
+        return '';
+    const label = windowHours === 1 ? '1h' : `${windowHours}h`;
+    const lines = decisions.map(d => `[${d.author_name}] ${d.summary}`);
+    return `\n--- Peer Decisions (last ${label}) ---\n${lines.join('\n')}`;
+}
+//# sourceMappingURL=peer-decisions.js.map

package/dist/coordination/peer-decisions.js.map

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

package/dist/coordination/plugin-loader.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Plugin loader for AWM coordination.
+ *
+ * Reads AWM_PLUGINS env var (comma-separated module paths or package names),
+ * dynamically imports each, and calls register() with the plugin context.
+ *
+ * Usage:
+ *   AWM_PLUGINS=./plugins/slack-notify.js,my-awm-plugin npm start
+ */
+import type { AWMPluginContext } from './plugin.js';
+/**
+ * Load and register all plugins specified in AWM_PLUGINS env var.
+ * Errors in individual plugins are logged but don't prevent other plugins from loading.
+ */
+export declare function loadPlugins(ctx: AWMPluginContext): Promise<void>;
+/** Teardown all loaded plugins (call on shutdown). */
+export declare function teardownPlugins(): Promise<void>;
+//# sourceMappingURL=plugin-loader.d.ts.map

package/dist/coordination/plugin-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../../src/coordination/plugin-loader.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAa,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAK/D;;;GAGG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BtE;AAED,sDAAsD;AACtD,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CASrD"}

package/dist/coordination/plugin-loader.js

@@ -0,0 +1,55 @@
+// Copyright 2026 Robert Winter / Complete Ideas
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Plugin loader for AWM coordination.
+ *
+ * Reads AWM_PLUGINS env var (comma-separated module paths or package names),
+ * dynamically imports each, and calls register() with the plugin context.
+ *
+ * Usage:
+ *   AWM_PLUGINS=./plugins/slack-notify.js,my-awm-plugin npm start
+ */
+/** Loaded plugin instances (for teardown). */
+const loadedPlugins = [];
+/**
+ * Load and register all plugins specified in AWM_PLUGINS env var.
+ * Errors in individual plugins are logged but don't prevent other plugins from loading.
+ */
+export async function loadPlugins(ctx) {
+    const pluginList = process.env.AWM_PLUGINS;
+    if (!pluginList)
+        return;
+    const paths = pluginList
+        .split(',')
+        .map((p) => p.trim())
+        .filter(Boolean);
+    for (const modulePath of paths) {
+        try {
+            const mod = await import(modulePath);
+            const plugin = mod.default ?? mod;
+            if (!plugin.name || typeof plugin.register !== 'function') {
+                console.warn(`  [plugin] Skipping ${modulePath}: missing name or register()`);
+                continue;
+            }
+            await plugin.register(ctx);
+            loadedPlugins.push(plugin);
+            console.log(`  [plugin] Loaded: ${plugin.name}`);
+        }
+        catch (err) {
+            console.error(`  [plugin] Failed to load ${modulePath}:`, err.message);
+        }
+    }
+}
+/** Teardown all loaded plugins (call on shutdown). */
+export async function teardownPlugins() {
+    for (const plugin of loadedPlugins) {
+        try {
+            await plugin.teardown?.();
+        }
+        catch (err) {
+            console.error(`  [plugin] Teardown error (${plugin.name}):`, err.message);
+        }
+    }
+    loadedPlugins.length = 0;
+}
+//# sourceMappingURL=plugin-loader.js.map

package/dist/coordination/plugin-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-loader.js","sourceRoot":"","sources":["../../src/coordination/plugin-loader.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,sCAAsC;AACtC;;;;;;;;GAQG;AAIH,8CAA8C;AAC9C,MAAM,aAAa,GAAgB,EAAE,CAAC;AAEtC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAqB;IACrD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IAC3C,IAAI,CAAC,UAAU;QAAE,OAAO;IAExB,MAAM,KAAK,GAAG,UAAU;SACrB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,OAAO,CAAC,CAAC;IAEnB,KAAK,MAAM,UAAU,IAAI,KAAK,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;YACrC,MAAM,MAAM,GAAc,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC;YAE7C,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;gBAC1D,OAAO,CAAC,IAAI,CAAC,uBAAuB,UAAU,8BAA8B,CAAC,CAAC;gBAC9E,SAAS;YACX,CAAC;YAED,MAAM,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC3B,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,sBAAsB,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,6BAA6B,UAAU,GAAG,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;AACH,CAAC;AAED,sDAAsD;AACtD,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;QAC5B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,8BAA8B,MAAM,CAAC,IAAI,IAAI,EAAG,GAAa,CAAC,OAAO,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IACD,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;AAC3B,CAAC"}

package/dist/coordination/plugin.d.ts

@@ -0,0 +1,40 @@
+/**
+ * AWM Plugin contract.
+ *
+ * Plugins extend coordination with custom behavior by subscribing to
+ * events, adding routes, or querying the DB. They are loaded at startup
+ * via AWM_PLUGINS env var (comma-separated module paths).
+ *
+ * Example plugin:
+ *   import type { AWMPlugin } from 'agent-working-memory';
+ *   export default {
+ *     name: 'my-plugin',
+ *     register(ctx) {
+ *       ctx.events.on('assignment.completed', (evt) => {
+ *         console.log(`Task done: ${evt.assignmentId}`);
+ *       });
+ *     },
+ *   } satisfies AWMPlugin;
+ */
+import type { FastifyInstance } from 'fastify';
+import type Database from 'better-sqlite3';
+import type { CoordinationEventBus } from './events.js';
+/** Context passed to plugin register(). */
+export interface AWMPluginContext {
+    /** Typed event bus — subscribe to coordination events. */
+    events: CoordinationEventBus;
+    /** Raw better-sqlite3 database handle (coordination tables). */
+    db: Database.Database;
+    /** Fastify instance — add custom routes if needed. */
+    fastify: FastifyInstance;
+}
+/** Plugin contract. Every AWM plugin must export this shape. */
+export interface AWMPlugin {
+    /** Unique plugin name (for logging and dedup). */
+    name: string;
+    /** Called once at startup with the plugin context. */
+    register(ctx: AWMPluginContext): void | Promise<void>;
+    /** Optional cleanup on shutdown. */
+    teardown?(): void | Promise<void>;
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/coordination/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/coordination/plugin.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAExD,2CAA2C;AAC3C,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,MAAM,EAAE,oBAAoB,CAAC;IAC7B,gEAAgE;IAChE,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IACtB,sDAAsD;IACtD,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED,gEAAgE;AAChE,MAAM,WAAW,SAAS;IACxB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,QAAQ,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,oCAAoC;IACpC,QAAQ,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC"}

package/dist/coordination/plugin.js

@@ -0,0 +1,22 @@
+// Copyright 2026 Robert Winter / Complete Ideas
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * AWM Plugin contract.
+ *
+ * Plugins extend coordination with custom behavior by subscribing to
+ * events, adding routes, or querying the DB. They are loaded at startup
+ * via AWM_PLUGINS env var (comma-separated module paths).
+ *
+ * Example plugin:
+ *   import type { AWMPlugin } from 'agent-working-memory';
+ *   export default {
+ *     name: 'my-plugin',
+ *     register(ctx) {
+ *       ctx.events.on('assignment.completed', (evt) => {
+ *         console.log(`Task done: ${evt.assignmentId}`);
+ *       });
+ *     },
+ *   } satisfies AWMPlugin;
+ */
+export {};
+//# sourceMappingURL=plugin.js.map

package/dist/coordination/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/coordination/plugin.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,sCAAsC;AACtC;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/coordination/routes.d.ts

@@ -5,5 +5,6 @@
  */
 import type { FastifyInstance } from 'fastify';
 import type Database from 'better-sqlite3';
-export declare function registerCoordinationRoutes(app: FastifyInstance, db: Database.Database): void;
+import type { EngramStore } from '../storage/sqlite.js';
+export declare function registerCoordinationRoutes(app: FastifyInstance, db: Database.Database, store?: EngramStore, eventBus?: import('./events.js').CoordinationEventBus): void;
 //# sourceMappingURL=routes.d.ts.map

package/dist/coordination/routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/coordination/routes.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAuB3C,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,eAAe,EAAE,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CA6yB5F"}
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/coordination/routes.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAsCxD,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,eAAe,EAAE,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,OAAO,aAAa,EAAE,oBAAoB,GAAG,IAAI,CA40DxK"}