agent-working-memory 0.5.6 → 0.6.1

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;AAsB3C,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,eAAe,EAAE,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAgnB5F"}
+{"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"}