npm - @hotmeshio/long-tail - Versions diffs - 0.1.21 → 0.2.1 - Mend

@hotmeshio/long-tail 0.1.21 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (269) hide show

package/build/api/agent-subscriptions.d.ts ADDED Viewed

@@ -0,0 +1,15 @@
+import type { LTApiResult } from '../types/sdk';
+export declare function listSubscriptions(input: {
+    agentId: string;
+}): Promise<LTApiResult>;
+export declare function createSubscription(input: {
+    agentId: string;
+    [key: string]: any;
+}): Promise<LTApiResult>;
+export declare function updateSubscription(input: {
+    id: string;
+    [key: string]: any;
+}): Promise<LTApiResult>;
+export declare function deleteSubscription(input: {
+    id: string;
+}): Promise<LTApiResult>;

package/build/api/agent-subscriptions.js ADDED Viewed

@@ -0,0 +1,82 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listSubscriptions = listSubscriptions;
+exports.createSubscription = createSubscription;
+exports.updateSubscription = updateSubscription;
+exports.deleteSubscription = deleteSubscription;
+const subService = __importStar(require("../services/agent/subscriptions"));
+async function listSubscriptions(input) {
+    try {
+        const subs = await subService.listSubscriptions(input.agentId);
+        return { status: 200, data: { subscriptions: subs } };
+    }
+    catch (err) {
+        return { status: 500, error: err.message };
+    }
+}
+async function createSubscription(input) {
+    try {
+        const { agentId, ...data } = input;
+        const sub = await subService.createSubscription(agentId, data);
+        return { status: 201, data: sub };
+    }
+    catch (err) {
+        return { status: 500, error: err.message };
+    }
+}
+async function updateSubscription(input) {
+    try {
+        const { id, ...data } = input;
+        const sub = await subService.updateSubscription(id, data);
+        if (!sub)
+            return { status: 404, error: 'Subscription not found' };
+        return { status: 200, data: sub };
+    }
+    catch (err) {
+        return { status: 500, error: err.message };
+    }
+}
+async function deleteSubscription(input) {
+    try {
+        const deleted = await subService.deleteSubscription(input.id);
+        if (!deleted)
+            return { status: 404, error: 'Subscription not found' };
+        return { status: 200, data: { deleted: true } };
+    }
+    catch (err) {
+        return { status: 500, error: err.message };
+    }
+}

package/build/api/agents.d.ts ADDED Viewed

@@ -0,0 +1,21 @@
+import type { LTApiResult, LTApiAuth } from '../types/sdk';
+export declare function listAgents(input: {
+    status?: string;
+    knowledge_domain?: string;
+    limit?: number;
+    offset?: number;
+}): Promise<LTApiResult>;
+export declare function getAgent(input: {
+    id: string;
+}): Promise<LTApiResult>;
+export declare function createAgent(input: {
+    name: string;
+    [key: string]: any;
+}, _auth?: LTApiAuth): Promise<LTApiResult>;
+export declare function updateAgent(input: {
+    id: string;
+    [key: string]: any;
+}): Promise<LTApiResult>;
+export declare function deleteAgent(input: {
+    id: string;
+}): Promise<LTApiResult>;

package/build/api/agents.js ADDED Viewed

@@ -0,0 +1,100 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listAgents = listAgents;
+exports.getAgent = getAgent;
+exports.createAgent = createAgent;
+exports.updateAgent = updateAgent;
+exports.deleteAgent = deleteAgent;
+const agentService = __importStar(require("../services/agent"));
+async function listAgents(input) {
+    try {
+        const result = await agentService.listAgents(input);
+        return { status: 200, data: result };
+    }
+    catch (err) {
+        return { status: 500, error: err.message };
+    }
+}
+async function getAgent(input) {
+    try {
+        const agent = await agentService.getAgent(input.id);
+        if (!agent) {
+            return { status: 404, error: 'Agent not found' };
+        }
+        const stats = await agentService.getAgentStats(agent);
+        return { status: 200, data: { ...agent, stats } };
+    }
+    catch (err) {
+        return { status: 500, error: err.message };
+    }
+}
+async function createAgent(input, _auth) {
+    try {
+        const agent = await agentService.createAgent(input);
+        return { status: 201, data: agent };
+    }
+    catch (err) {
+        if (err.code === '23505') {
+            return { status: 409, error: `Agent "${input.name}" already exists` };
+        }
+        return { status: 500, error: err.message };
+    }
+}
+async function updateAgent(input) {
+    try {
+        const { id, ...data } = input;
+        const agent = await agentService.updateAgent(id, data);
+        if (!agent) {
+            return { status: 404, error: 'Agent not found' };
+        }
+        return { status: 200, data: agent };
+    }
+    catch (err) {
+        return { status: 500, error: err.message };
+    }
+}
+async function deleteAgent(input) {
+    try {
+        const deleted = await agentService.deleteAgent(input.id);
+        if (!deleted) {
+            return { status: 404, error: 'Agent not found' };
+        }
+        return { status: 200, data: { deleted: true } };
+    }
+    catch (err) {
+        return { status: 500, error: err.message };
+    }
+}

package/build/api/capabilities.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import type { LTApiResult } from '../types/sdk';
2	+ export declare function listCapabilities(): Promise<LTApiResult>;

package/build/api/capabilities.js ADDED Viewed

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listCapabilities = listCapabilities;
+const db_1 = require("../lib/db");
+const LIST_SERVERS_WITH_TOOLS = `
+  SELECT id, name, description, tags, tool_manifest, compile_hints, category
+  FROM lt_mcp_servers
+  WHERE status IN ('registered', 'connected')
+    AND tool_manifest IS NOT NULL
+  ORDER BY name
+`;
+/**
+ * Fallback tag-to-category mapping for servers that don't have an explicit category.
+ */
+const TAG_FALLBACK = {
+    'escalation': 'Automation',
+    'browser-automation': 'Automation',
+    'translation': 'Analysis',
+    'vision': 'Analysis',
+    'gmail': 'Communication',
+    'email': 'Communication',
+    'messaging': 'Communication',
+    'storage': 'Data',
+    'knowledge': 'Data',
+    'http': 'Data',
+    'api': 'Data',
+    'authentication': 'System',
+    'admin': 'System',
+    'documentation': 'Reference',
+    'development': 'Development',
+};
+const CATEGORY_ORDER = ['Communication', 'Analysis', 'Media', 'Data', 'Automation', 'Development', 'System', 'Reference', 'Other'];
+function resolveCategory(server) {
+    if (server.category)
+        return server.category;
+    for (const tag of server.tags ?? []) {
+        const cat = TAG_FALLBACK[tag];
+        if (cat)
+            return cat;
+    }
+    return 'Other';
+}
+async function listCapabilities() {
+    try {
+        const pool = (0, db_1.getPool)();
+        const { rows } = await pool.query(LIST_SERVERS_WITH_TOOLS);
+        const categoryMap = new Map();
+        for (const server of rows) {
+            const category = resolveCategory(server);
+            const tools = (server.tool_manifest || []);
+            if (!categoryMap.has(category)) {
+                categoryMap.set(category, []);
+            }
+            for (const tool of tools) {
+                categoryMap.get(category).push({
+                    name: tool.name,
+                    description: tool.description || '',
+                    inputSchema: tool.inputSchema || {},
+                    serverName: server.name,
+                    serverId: server.id,
+                });
+            }
+        }
+        const categories = CATEGORY_ORDER
+            .filter((name) => categoryMap.has(name))
+            .map((name) => ({
+            name,
+            tools: categoryMap.get(name).sort((a, b) => a.name.localeCompare(b.name)),
+        }));
+        const totalTools = categories.reduce((sum, c) => sum + c.tools.length, 0);
+        return { status: 200, data: { categories, totalTools } };
+    }
+    catch (err) {
+        return { status: 500, error: err.message };
+    }
+}

package/build/index.d.ts CHANGED Viewed

@@ -15,7 +15,7 @@ export { eventRegistry } from './lib/events';
 export { NatsEventAdapter } from './lib/events/nats';
 export { InMemoryEventAdapter } from './lib/events/memory';
 export { SocketIOEventAdapter, type SocketIOAuthenticator } from './lib/events/socketio';
-export { publishMilestoneEvent, publishTaskEvent, publishEscalationEvent, publishWorkflowEvent } from './lib/events/publish';
+export { publishMilestoneEvent, publishTaskEvent, publishEscalationEvent, publishWorkflowEvent, publishAgentEvent, publishKnowledgeEvent } from './lib/events/publish';
 export { telemetryRegistry } from './lib/telemetry';
 export { HoneycombTelemetryAdapter } from './lib/telemetry/honeycomb';
 export { loggerRegistry } from './lib/logger';
@@ -35,7 +35,7 @@ export { McpEscalationStrategy } from './services/escalation-strategy/mcp';
 export { getActivityIdentity } from './services/iam/activity';
 export { getToolContext } from './services/iam/context';
 export { registerMcpTool } from './services/mcp/register-tool';
-export { getSystemWorkers, builtinMcpServerFactories } from './system';
+export { getSystemWorkers, getSystemAgents, builtinMcpServerFactories } from './system';
 export { CallbackEventAdapter } from './lib/events/callback';
 export { createClient } from './sdk';
 export { getFreshAccessToken, listOAuthConnections } from './services/oauth';

package/build/index.js CHANGED Viewed

@@ -36,8 +36,8 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getStorageBackend = exports.listOAuthConnections = exports.getFreshAccessToken = exports.createClient = exports.CallbackEventAdapter = exports.builtinMcpServerFactories = exports.getSystemWorkers = exports.registerMcpTool = exports.getToolContext = exports.getActivityIdentity = exports.McpEscalationStrategy = exports.DefaultEscalationStrategy = exports.escalationStrategyRegistry = exports.McpVisionServer = exports.McpTranslationServer = exports.McpServer = exports.McpClient = exports.McpService = exports.BuiltInMcpAdapter = exports.mcpRegistry = exports.defaultMaintenanceConfig = exports.maintenanceRegistry = exports.PinoLoggerAdapter = exports.loggerRegistry = exports.HoneycombTelemetryAdapter = exports.telemetryRegistry = exports.publishWorkflowEvent = exports.publishEscalationEvent = exports.publishTaskEvent = exports.publishMilestoneEvent = exports.SocketIOEventAdapter = exports.InMemoryEventAdapter = exports.NatsEventAdapter = exports.eventRegistry = exports.ltConfig = exports.UserService = exports.ConfigService = exports.EscalationService = exports.TaskService = exports.signToken = exports.requireAdmin = exports.requireAuth = exports.createAuthMiddleware = exports.JwtAuthAdapter = exports.conditionLT = exports.executeLT = exports.createLTActivityInterceptor = exports.createLTInterceptor = exports.registerLT = exports.start = void 0;
-exports.api = exports.KnowledgeApi = exports.resolveCredential = exports.mimeFromPath = void 0;
+exports.createClient = exports.CallbackEventAdapter = exports.builtinMcpServerFactories = exports.getSystemAgents = exports.getSystemWorkers = exports.registerMcpTool = exports.getToolContext = exports.getActivityIdentity = exports.McpEscalationStrategy = exports.DefaultEscalationStrategy = exports.escalationStrategyRegistry = exports.McpVisionServer = exports.McpTranslationServer = exports.McpServer = exports.McpClient = exports.McpService = exports.BuiltInMcpAdapter = exports.mcpRegistry = exports.defaultMaintenanceConfig = exports.maintenanceRegistry = exports.PinoLoggerAdapter = exports.loggerRegistry = exports.HoneycombTelemetryAdapter = exports.telemetryRegistry = exports.publishKnowledgeEvent = exports.publishAgentEvent = exports.publishWorkflowEvent = exports.publishEscalationEvent = exports.publishTaskEvent = exports.publishMilestoneEvent = exports.SocketIOEventAdapter = exports.InMemoryEventAdapter = exports.NatsEventAdapter = exports.eventRegistry = exports.ltConfig = exports.UserService = exports.ConfigService = exports.EscalationService = exports.TaskService = exports.signToken = exports.requireAdmin = exports.requireAuth = exports.createAuthMiddleware = exports.JwtAuthAdapter = exports.conditionLT = exports.executeLT = exports.createLTActivityInterceptor = exports.createLTInterceptor = exports.registerLT = exports.start = void 0;
+exports.api = exports.KnowledgeApi = exports.resolveCredential = exports.mimeFromPath = exports.getStorageBackend = exports.listOAuthConnections = exports.getFreshAccessToken = void 0;
 const config_1 = require("./modules/config");
 const logger_1 = require("./lib/logger");
 const start_1 = require("./start");
@@ -79,6 +79,8 @@ Object.defineProperty(exports, "publishMilestoneEvent", { enumerable: true, get:
 Object.defineProperty(exports, "publishTaskEvent", { enumerable: true, get: function () { return publish_1.publishTaskEvent; } });
 Object.defineProperty(exports, "publishEscalationEvent", { enumerable: true, get: function () { return publish_1.publishEscalationEvent; } });
 Object.defineProperty(exports, "publishWorkflowEvent", { enumerable: true, get: function () { return publish_1.publishWorkflowEvent; } });
+Object.defineProperty(exports, "publishAgentEvent", { enumerable: true, get: function () { return publish_1.publishAgentEvent; } });
+Object.defineProperty(exports, "publishKnowledgeEvent", { enumerable: true, get: function () { return publish_1.publishKnowledgeEvent; } });
 var telemetry_1 = require("./lib/telemetry");
 Object.defineProperty(exports, "telemetryRegistry", { enumerable: true, get: function () { return telemetry_1.telemetryRegistry; } });
 var honeycomb_1 = require("./lib/telemetry/honeycomb");
@@ -114,6 +116,7 @@ var register_tool_1 = require("./services/mcp/register-tool");
 Object.defineProperty(exports, "registerMcpTool", { enumerable: true, get: function () { return register_tool_1.registerMcpTool; } });
 var system_1 = require("./system");
 Object.defineProperty(exports, "getSystemWorkers", { enumerable: true, get: function () { return system_1.getSystemWorkers; } });
+Object.defineProperty(exports, "getSystemAgents", { enumerable: true, get: function () { return system_1.getSystemAgents; } });
 Object.defineProperty(exports, "builtinMcpServerFactories", { enumerable: true, get: function () { return system_1.builtinMcpServerFactories; } });
 var callback_1 = require("./lib/events/callback");
 Object.defineProperty(exports, "CallbackEventAdapter", { enumerable: true, get: function () { return callback_1.CallbackEventAdapter; } });

package/build/lib/db/schemas/003_agents.sql ADDED Viewed

@@ -0,0 +1,46 @@
+-- Long Tail: Agent data model
+-- Agents are autonomous personas that compose identity, memory, capabilities,
+-- behaviors, and goals atop existing primitives.
+CREATE TABLE IF NOT EXISTS lt_agents (
+  id                UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  name              TEXT UNIQUE NOT NULL,
+  description       TEXT,
+  status            TEXT NOT NULL DEFAULT 'inactive'
+                      CHECK (status IN ('inactive', 'active', 'paused', 'error')),
+  -- Identity: links to a service account (bot user)
+  user_id           UUID REFERENCES lt_users(id) ON DELETE SET NULL,
+  -- Memory: knowledge domain this agent owns
+  knowledge_domain  TEXT,
+  -- Capabilities: which MCP servers/tools it can use
+  capabilities      JSONB NOT NULL DEFAULT '[]'::JSONB,
+  -- Behaviors: triggers, schedules, escalation patterns
+  behaviors         JSONB NOT NULL DEFAULT '{}'::JSONB,
+  -- Goals and guardrails (natural language)
+  goals             TEXT,
+  rules             TEXT,
+  -- Workflow bindings (soft references)
+  workflow_type     TEXT,
+  pipeline_id       UUID,
+  -- Metadata
+  metadata          JSONB NOT NULL DEFAULT '{}'::JSONB,
+  last_run_at       TIMESTAMPTZ,
+  created_at        TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at        TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+CREATE INDEX IF NOT EXISTS idx_lt_agents_status ON lt_agents (status);
+CREATE INDEX IF NOT EXISTS idx_lt_agents_user_id ON lt_agents (user_id);
+CREATE INDEX IF NOT EXISTS idx_lt_agents_knowledge_domain ON lt_agents (knowledge_domain);
+CREATE INDEX IF NOT EXISTS idx_lt_agents_capabilities ON lt_agents USING GIN (capabilities);
+CREATE OR REPLACE TRIGGER trg_lt_agents_updated_at
+  BEFORE UPDATE ON lt_agents
+  FOR EACH ROW EXECUTE FUNCTION lt_set_updated_at();

package/build/lib/db/schemas/004_agent_subscriptions.sql ADDED Viewed

@@ -0,0 +1,38 @@
+-- Agent event subscriptions — reactive wiring from events to workflows.
+-- Each row maps a topic pattern to a workflow reaction for a specific agent.
+CREATE TABLE IF NOT EXISTS lt_agent_subscriptions (
+  id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  agent_id        UUID NOT NULL REFERENCES lt_agents(id) ON DELETE CASCADE,
+  -- What to listen for
+  topic           TEXT NOT NULL,
+  filter          JSONB,
+  -- How to react
+  reaction_type   TEXT NOT NULL CHECK (reaction_type IN ('durable', 'pipeline', 'mcp_query')),
+  workflow_type   TEXT,
+  pipeline_id     UUID,
+  mcp_prompt      TEXT,
+  -- Input mapping: transform event payload → workflow envelope
+  input_mapping   JSONB NOT NULL DEFAULT '{}'::JSONB,
+  -- Identity for the reaction execution
+  execute_as      TEXT,
+  enabled         BOOLEAN NOT NULL DEFAULT true,
+  created_at      TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at      TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+CREATE INDEX IF NOT EXISTS idx_lt_agent_subs_agent ON lt_agent_subscriptions (agent_id);
+CREATE INDEX IF NOT EXISTS idx_lt_agent_subs_topic ON lt_agent_subscriptions (topic);
+CREATE INDEX IF NOT EXISTS idx_lt_agent_subs_enabled ON lt_agent_subscriptions (enabled) WHERE enabled = true;
+CREATE OR REPLACE TRIGGER trg_lt_agent_subs_updated_at
+  BEFORE UPDATE ON lt_agent_subscriptions
+  FOR EACH ROW EXECUTE FUNCTION lt_set_updated_at();
+-- Add GIN index on agent behaviors for efficient trigger queries
+CREATE INDEX IF NOT EXISTS idx_lt_agents_behaviors ON lt_agents USING GIN (behaviors);

package/build/lib/db/schemas/005_server_category.sql ADDED Viewed

@@ -0,0 +1,6 @@
+-- Add category column to MCP servers for capability grouping.
+-- Replaces the tag-derived category mapping with an explicit, configurable value.
+ALTER TABLE lt_mcp_servers ADD COLUMN IF NOT EXISTS category TEXT;
+CREATE INDEX IF NOT EXISTS idx_lt_mcp_servers_category ON lt_mcp_servers (category) WHERE category IS NOT NULL;

package/build/lib/db/schemas/006_agent_sub_unique.sql ADDED Viewed

@@ -0,0 +1,9 @@
+-- Add unique constraint on (agent_id, topic) for idempotent subscription seeding.
+-- Two containers inserting the same subscription simultaneously: one wins, other is a no-op.
+DO $$ BEGIN
+  ALTER TABLE lt_agent_subscriptions
+    ADD CONSTRAINT uq_agent_sub_topic UNIQUE (agent_id, topic);
+EXCEPTION
+  WHEN duplicate_object THEN NULL;
+END $$;

package/build/lib/events/callback.d.ts CHANGED Viewed

@@ -7,25 +7,11 @@ type EventCallback = (event: LTEvent) => void;
  * SDK callers subscribe with `.on()` and receive events as direct
  * function calls — no network transport, no serialization overhead.
  *
- * Supports:
- * - Exact type matching: `on('task.created', cb)`
- * - Category wildcards: `on('task.*', cb)` — matches all task.* events
+ * Supports NATS-style pattern matching:
+ * - Exact: `on('task.created', cb)`
+ * - Single-token wildcard: `on('task.*', cb)` — matches task.created, task.failed, etc.
+ * - Multi-token wildcard: `on('app.epic.>', cb)` — matches app.epic.apis.createorder.error
  * - Global wildcard: `on('*', cb)` — matches every event
- *
- * Usage:
- * ```typescript
- * import { CallbackEventAdapter } from '@hotmeshio/long-tail';
- * import { eventRegistry } from '@hotmeshio/long-tail';
- *
- * const adapter = new CallbackEventAdapter();
- * eventRegistry.register(adapter);
- *
- * const unsub = adapter.on('escalation.claimed', (event) => {
- *   console.log('claimed:', event.escalationId);
- * });
- *
- * // Later: unsub() to remove the listener
- * ```
  */
 export declare class CallbackEventAdapter implements LTEventAdapter {
     private listeners;

package/build/lib/events/callback.js CHANGED Viewed

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CallbackEventAdapter = void 0;
 const logger_1 = require("../logger");
+const matching_1 = require("./matching");
 /**
  * In-process event adapter that delivers events via registered callbacks.
  *
@@ -9,25 +10,11 @@ const logger_1 = require("../logger");
  * SDK callers subscribe with `.on()` and receive events as direct
  * function calls — no network transport, no serialization overhead.
  *
- * Supports:
- * - Exact type matching: `on('task.created', cb)`
- * - Category wildcards: `on('task.*', cb)` — matches all task.* events
+ * Supports NATS-style pattern matching:
+ * - Exact: `on('task.created', cb)`
+ * - Single-token wildcard: `on('task.*', cb)` — matches task.created, task.failed, etc.
+ * - Multi-token wildcard: `on('app.epic.>', cb)` — matches app.epic.apis.createorder.error
  * - Global wildcard: `on('*', cb)` — matches every event
- *
- * Usage:
- * ```typescript
- * import { CallbackEventAdapter } from '@hotmeshio/long-tail';
- * import { eventRegistry } from '@hotmeshio/long-tail';
- *
- * const adapter = new CallbackEventAdapter();
- * eventRegistry.register(adapter);
- *
- * const unsub = adapter.on('escalation.claimed', (event) => {
- *   console.log('claimed:', event.escalationId);
- * });
- *
- * // Later: unsub() to remove the listener
- * ```
  */
 class CallbackEventAdapter {
     constructor() {
@@ -55,23 +42,9 @@ class CallbackEventAdapter {
         logger_1.loggerRegistry.info('[lt-events:callback] adapter connected');
     }
     async publish(event) {
-        // Exact match listeners
-        const exact = this.listeners.get(event.type);
-        if (exact) {
-            for (const cb of exact) {
-                try {
-                    cb(event);
-                }
-                catch { /* fire-and-forget */ }
-            }
-        }
-        // Category wildcard listeners (e.g. 'task.*' matches 'task.created')
-        const dotIdx = event.type.indexOf('.');
-        if (dotIdx > 0) {
-            const category = event.type.slice(0, dotIdx) + '.*';
-            const catListeners = this.listeners.get(category);
-            if (catListeners) {
-                for (const cb of catListeners) {
+        for (const [pattern, callbacks] of this.listeners) {
+            if ((0, matching_1.subjectMatchesPattern)(event.type, pattern)) {
+                for (const cb of callbacks) {
                     try {
                         cb(event);
                     }
@@ -79,16 +52,6 @@ class CallbackEventAdapter {
                 }
             }
         }
-        // Global wildcard listeners
-        const global = this.listeners.get('*');
-        if (global) {
-            for (const cb of global) {
-                try {
-                    cb(event);
-                }
-                catch { /* fire-and-forget */ }
-            }
-        }
     }
     async disconnect() {
         this.listeners.clear();

package/build/lib/events/matching.d.ts ADDED Viewed

@@ -0,0 +1,13 @@
+/**
+ * Match a dot-delimited subject against a pattern with NATS-style wildcards.
+ *
+ * - `*` matches exactly one token
+ * - `>` matches one or more remaining tokens (must be last segment)
+ *
+ * Examples:
+ * - `task.created` matches `task.*`
+ * - `app.epic.apis.createorder.error` matches `app.epic.apis.*.error`
+ * - `app.epic.apis.createorder.error` matches `app.epic.>`
+ * - `app.epic.apis.createorder.error` does NOT match `app.vendor.>`
+ */
+export declare function subjectMatchesPattern(subject: string, pattern: string): boolean;

package/build/lib/events/matching.js ADDED Viewed

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.subjectMatchesPattern = subjectMatchesPattern;
+/**
+ * Match a dot-delimited subject against a pattern with NATS-style wildcards.
+ *
+ * - `*` matches exactly one token
+ * - `>` matches one or more remaining tokens (must be last segment)
+ *
+ * Examples:
+ * - `task.created` matches `task.*`
+ * - `app.epic.apis.createorder.error` matches `app.epic.apis.*.error`
+ * - `app.epic.apis.createorder.error` matches `app.epic.>`
+ * - `app.epic.apis.createorder.error` does NOT match `app.vendor.>`
+ */
+function subjectMatchesPattern(subject, pattern) {
+    if (pattern === '*')
+        return true;
+    const subjectTokens = subject.split('.');
+    const patternTokens = pattern.split('.');
+    for (let i = 0; i < patternTokens.length; i++) {
+        const pt = patternTokens[i];
+        if (pt === '>')
+            return true;
+        if (i >= subjectTokens.length)
+            return false;
+        if (pt !== '*' && pt !== subjectTokens[i])
+            return false;
+    }
+    return subjectTokens.length === patternTokens.length;
+}

package/build/lib/events/publish.d.ts CHANGED Viewed

@@ -56,6 +56,26 @@ export declare function publishActivityEvent(params: {
     activityName: string;
     data?: Record<string, any>;
 }): Promise<void>;
+/**
+ * Publish a knowledge lifecycle event (stored, deleted).
+ * Lightweight — no workflow context required since knowledge writes
+ * happen both inside and outside workflows.
+ */
+export declare function publishKnowledgeEvent(params: {
+    type: 'knowledge.stored' | 'knowledge.deleted';
+    domain: string;
+    key: string;
+}): Promise<void>;
+/**
+ * Publish an agent lifecycle event.
+ */
+export declare function publishAgentEvent(params: {
+    type: 'agent.started' | 'agent.completed' | 'agent.failed' | 'agent.status_changed';
+    agentId: string;
+    agentName: string;
+    status?: string;
+    data?: Record<string, any>;
+}): Promise<void>;
 /**
  * Publish a workflow lifecycle event (started, completed, failed).
  */