@chozzz/vargos 2.0.3

package/dist/edge/webhooks/index.js

@@ -0,0 +1,231 @@
+/**
+ * Webhooks edge service — inbound HTTP webhooks that trigger agent runs.
+ *
+ * Callable: webhook.search
+ * Subscribes: agent.onCompleted (delivery to notify targets)
+ *
+ * Inbound flow: POST /hooks/:id → validate token → transform payload
+ *   → session create/addMessage → agent.execute → deliver to notify targets
+ */
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+import http from 'node:http';
+import { timingSafeEqual, createHash } from 'node:crypto';
+import { z } from 'zod';
+import { register } from '../../gateway/decorators.js';
+import { createLogger } from '../../lib/logger.js';
+import { toMessage } from '../../lib/error.js';
+import { getDataPaths } from '../../lib/paths.js';
+import { webhookSessionKey, parseSessionKey } from '../../lib/subagent.js';
+import { paginate } from '../../lib/paginate.js';
+import { passthroughTransform, loadTransform } from './transform.js';
+const log = createLogger('webhooks');
+const MAX_BODY = 1024 * 1024; // 1 MB
+const HOOK_ID_RE = /^[a-z0-9_-]+$/i;
+const HTTP_PORT = 9002;
+const HTTP_HOST = '127.0.0.1';
+// ── WebhooksEdge ──────────────────────────────────────────────────────────────
+let WebhooksEdge = (() => {
+    let _instanceExtraInitializers = [];
+    let _search_decorators;
+    return class WebhooksEdge {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _search_decorators = [register('webhook.search', {
+                    description: 'List registered webhook endpoints.',
+                    schema: z.object({
+                        query: z.string().optional(),
+                        page: z.number(),
+                        limit: z.number().optional(),
+                    }),
+                })];
+            __esDecorate(this, null, _search_decorators, { kind: "method", name: "search", static: false, private: false, access: { has: obj => "search" in obj, get: obj => obj.search }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        bus = __runInitializers(this, _instanceExtraInitializers);
+        config;
+        hooks;
+        activeHooks = new Set();
+        server = null;
+        unsubscribeCompleted;
+        constructor(bus, config) {
+            this.bus = bus;
+            this.config = config;
+            this.hooks = new Map(config.webhooks.map(h => [h.id, h]));
+        }
+        async start() {
+            this.unsubscribeCompleted = this.bus.on('agent.onCompleted', (payload) => this.onAgentCompleted(payload));
+            await this.startHttp();
+            this.bus.bootstrap(this);
+            log.info(`started with ${this.hooks.size} webhook(s) on ${HTTP_HOST}:${HTTP_PORT}`);
+        }
+        async stop() {
+            this.unsubscribeCompleted?.();
+            await this.stopHttp();
+        }
+        // ── Callable handler ─────────────────────────────────────────────────────
+        async search(params) {
+            // Strip tokens — never expose secrets
+            const all = Array.from(this.hooks.values()).map(({ id, name, transform, notify }) => ({ id, name, token: '', transform, notify }));
+            const filtered = params.query
+                ? all.filter(h => h.id.includes(params.query) || h.name.includes(params.query))
+                : all;
+            return paginate(filtered, params.page, params.limit ?? 20);
+        }
+        // ── Agent completed handler ───────────────────────────────────────────────
+        onAgentCompleted(payload) {
+            const parsed = parseSessionKey(payload.sessionKey);
+            if (parsed.type !== 'webhook')
+                return;
+            // webhookSessionKey format: "webhook:<hookId>:<timestamp>"
+            const hookId = parsed.id.replace(/:\d+$/, '');
+            this.activeHooks.delete(hookId);
+        }
+        // ── HTTP server ───────────────────────────────────────────────────────────
+        startHttp() {
+            return new Promise((resolve, reject) => {
+                this.server = http.createServer((req, res) => this.handleRequest(req, res));
+                this.server.headersTimeout = 10_000;
+                this.server.requestTimeout = 30_000;
+                this.server.on('error', reject);
+                this.server.listen(HTTP_PORT, HTTP_HOST, () => {
+                    log.info(`http listening on ${HTTP_HOST}:${HTTP_PORT}`);
+                    resolve();
+                });
+            });
+        }
+        stopHttp() {
+            const srv = this.server;
+            if (!srv)
+                return Promise.resolve();
+            this.server = null;
+            return new Promise(resolve => srv.close(() => resolve()));
+        }
+        // ── Request handling ──────────────────────────────────────────────────────
+        handleRequest(req, res) {
+            if (req.method !== 'POST' || !req.url?.startsWith('/hooks/')) {
+                res.writeHead(404, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ error: 'Not found' }));
+                return;
+            }
+            const hookId = req.url.slice('/hooks/'.length).split('?')[0];
+            if (!HOOK_ID_RE.test(hookId)) {
+                res.writeHead(400, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ error: 'Invalid hook ID' }));
+                return;
+            }
+            const hook = this.hooks.get(hookId);
+            if (!hook) {
+                res.writeHead(404, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ error: 'Unknown hook' }));
+                return;
+            }
+            // Timing-safe comparison (hash prevents length leakage)
+            const auth = req.headers.authorization ?? '';
+            const expectedHash = createHash('sha256').update(`Bearer ${hook.token}`).digest();
+            const authHash = createHash('sha256').update(auth).digest();
+            if (!timingSafeEqual(authHash, expectedHash)) {
+                res.writeHead(401, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ error: 'Unauthorized' }));
+                return;
+            }
+            const chunks = [];
+            let size = 0;
+            let destroyed = false;
+            req.on('error', () => {
+                if (!res.writableEnded) {
+                    res.writeHead(400, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: 'Request error' }));
+                }
+            });
+            req.on('data', (chunk) => {
+                if (destroyed)
+                    return;
+                size += chunk.length;
+                if (size > MAX_BODY) {
+                    destroyed = true;
+                    req.destroy();
+                    res.writeHead(413, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: 'Payload too large' }));
+                    return;
+                }
+                chunks.push(chunk);
+            });
+            req.on('end', () => {
+                if (res.writableEnded)
+                    return;
+                // Respond immediately — fire and forget
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ ok: true }));
+                let payload;
+                try {
+                    payload = JSON.parse(Buffer.concat(chunks).toString());
+                }
+                catch {
+                    payload = {};
+                }
+                this.fireHook(hook, payload).catch(err => log.error(`fire hook ${hookId}: ${toMessage(err)}`));
+            });
+        }
+        // ── Fire ──────────────────────────────────────────────────────────────────
+        async fireHook(hook, payload) {
+            const { dataDir } = getDataPaths();
+            const task = hook.transform
+                ? await loadTransform(hook.transform, dataDir).then(fn => fn(payload))
+                : passthroughTransform(payload);
+            const sessionKey = webhookSessionKey(hook.id);
+            log.info(`fired: ${hook.id} → ${sessionKey}`);
+            this.activeHooks.add(hook.id);
+            const result = await this.bus.call('agent.execute', { sessionKey, task });
+            if (result.response && hook.notify?.length) {
+                log.info(`${hook.id} delivering response to ${hook.notify.length} targets`);
+                await Promise.all(hook.notify.map(target => this.bus.call('channel.send', {
+                    sessionKey: target,
+                    text: result.response,
+                    fromSessionKey: sessionKey,
+                }).catch(err => log.error(`notify send to ${target}: ${toMessage(err)}`))));
+            }
+        }
+    };
+})();
+export { WebhooksEdge };
+// ── Boot ───────────────────────────────────────────────────────────────────────
+export async function boot(bus) {
+    const config = await bus.call('config.get', {});
+    const svc = new WebhooksEdge(bus, config);
+    await svc.start();
+    return { stop: () => svc.stop() };
+}
+//# sourceMappingURL=index.js.map

package/dist/edge/webhooks/index.js.map

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

package/dist/edge/webhooks/transform.d.ts

@@ -0,0 +1,8 @@
+export type TransformFn = (payload: unknown) => string;
+export declare function passthroughTransform(payload: unknown): string;
+/**
+ * Load a transform module. Path must resolve within baseDir.
+ * Caches loaded modules to avoid re-importing.
+ */
+export declare function loadTransform(modulePath: string, baseDir?: string): Promise<TransformFn>;
+//# sourceMappingURL=transform.d.ts.map

package/dist/edge/webhooks/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../edge/webhooks/transform.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;AAIvD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAE7D;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAmB9F"}

package/dist/edge/webhooks/transform.js

@@ -0,0 +1,29 @@
+import path from 'node:path';
+const cache = new Map();
+export function passthroughTransform(payload) {
+    return JSON.stringify(payload, null, 2);
+}
+/**
+ * Load a transform module. Path must resolve within baseDir.
+ * Caches loaded modules to avoid re-importing.
+ */
+export async function loadTransform(modulePath, baseDir) {
+    const cached = cache.get(modulePath);
+    if (cached)
+        return cached;
+    // Restrict to baseDir (dataDir) when provided
+    if (baseDir) {
+        const resolved = path.resolve(baseDir, modulePath);
+        if (!resolved.startsWith(path.resolve(baseDir))) {
+            throw new Error(`Transform path "${modulePath}" escapes data directory`);
+        }
+    }
+    const mod = await import(modulePath);
+    const fn = mod.default ?? mod.transform;
+    if (typeof fn !== 'function') {
+        throw new Error(`Transform module "${modulePath}" must export a function`);
+    }
+    cache.set(modulePath, fn);
+    return fn;
+}
+//# sourceMappingURL=transform.js.map

package/dist/edge/webhooks/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../../edge/webhooks/transform.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAuB,CAAC;AAE7C,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAkB,EAAE,OAAgB;IACtE,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,8CAA8C;IAC9C,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACnD,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,mBAAmB,UAAU,0BAA0B,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;IACrC,MAAM,EAAE,GAAgB,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,SAAS,CAAC;IACrD,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,qBAAqB,UAAU,0BAA0B,CAAC,CAAC;IAC7E,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC1B,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/gateway/bus.d.ts

@@ -0,0 +1,48 @@
+import type { EventMap } from './events.js';
+/** Keys whose EventMap entry is callable ({ params, result }) */
+export type CallableEventKey = {
+    [E in keyof EventMap]: EventMap[E] extends {
+        params: unknown;
+        result: unknown;
+    } ? E : never;
+}[keyof EventMap];
+/** Keys whose EventMap entry is a plain payload */
+export type PureEventKey = Exclude<keyof EventMap, CallableEventKey>;
+/** Extract params type from a callable event */
+export type EventParams<E extends CallableEventKey> = EventMap[E] extends {
+    params: infer P;
+} ? P : never;
+/** Extract result type from a callable event */
+export type EventResult<E extends CallableEventKey> = EventMap[E] extends {
+    result: infer R;
+} ? R : never;
+/**
+ * Expected method signature for a handler of event E.
+ *   Pure event    → receives the payload, returns void
+ *   Callable event → receives params, returns Promise<result>
+ */
+export type HandlerOf<E extends keyof EventMap> = E extends CallableEventKey ? (params: EventParams<E>) => Promise<EventResult<E>> : (payload: EventMap[E]) => void | Promise<void>;
+export interface Bus {
+    /** Fire a pure event. Callable events cannot be emitted — use call(). */
+    emit<E extends PureEventKey>(event: E, payload: EventMap[E]): void;
+    /**
+     * Subscribe to a pure event (listener only).
+     * Handler receives the payload and returns void.
+     * Returns an unsubscribe function.
+     *
+     * Note: Callable events are wired exclusively via @register decorators
+     * and registerService(). Direct on() calls for callable events are not supported.
+     */
+    on<E extends PureEventKey>(event: E, handler: HandlerOf<E>): () => void;
+    /** Invoke a callable event and await the result. */
+    call<E extends CallableEventKey>(event: E, params: EventParams<E>): Promise<EventResult<E>>;
+    /** Check if an event is callable (only @register decorated events). */
+    isCallable(eventName: string): boolean;
+    /** Bootstrap a service (or the bus itself if no service provided) by wiring all @on and @register decorated methods to this bus. */
+    bootstrap(service?: object): void;
+    /** Register a new callable tool at runtime (used by services like MCP). Returns unsubscribe function. */
+    registerTool(event: string, handler: (params: unknown) => Promise<unknown>, schema: import('./decorators.js').ToolSchema): () => void;
+    /** Unregister a callable tool that was previously registered at runtime. */
+    unregisterTool(event: string): boolean;
+}
+//# sourceMappingURL=bus.d.ts.map

package/dist/gateway/bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../../gateway/bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAI5C,iEAAiE;AACjE,MAAM,MAAM,gBAAgB,GAAG;KAC5B,CAAC,IAAI,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,SAAS;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,CAAC,GAAG,KAAK;CAC5F,CAAC,MAAM,QAAQ,CAAC,CAAC;AAElB,mDAAmD;AACnD,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,QAAQ,EAAE,gBAAgB,CAAC,CAAC;AAErE,gDAAgD;AAChD,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,gBAAgB,IAChD,QAAQ,CAAC,CAAC,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,KAAK,CAAC;AAEtD,gDAAgD;AAChD,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,gBAAgB,IAChD,QAAQ,CAAC,CAAC,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,KAAK,CAAC;AAEtD;;;;GAIG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,QAAQ,IAC5C,CAAC,SAAS,gBAAgB,GACtB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GACnD,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAIrD,MAAM,WAAW,GAAG;IAClB,yEAAyE;IACzE,IAAI,CAAC,CAAC,SAAS,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAEnE;;;;;;;OAOG;IACH,EAAE,CAAC,CAAC,SAAS,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC;IAExE,oDAAoD;IACpD,IAAI,CAAC,CAAC,SAAS,gBAAgB,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5F,uEAAuE;IACvE,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAEvC,oIAAoI;IACpI,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAElC,yGAAyG;IACzG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,iBAAiB,EAAE,UAAU,GAAG,MAAM,IAAI,CAAC;IAEtI,4EAA4E;IAC5E,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACxC"}

package/dist/gateway/bus.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=bus.js.map

package/dist/gateway/bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.js","sourceRoot":"","sources":["../../gateway/bus.ts"],"names":[],"mappings":""}

package/dist/gateway/decorators.d.ts

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+import type { EventMap } from './events.js';
+import type { HandlerOf } from './bus.js';
+export interface ToolSchema {
+    description: string;
+    schema: z.ZodTypeAny;
+    format?: (result: unknown) => string;
+}
+export declare const HANDLERS: unique symbol;
+export declare const TOOLS: unique symbol;
+export interface HandlerEntry {
+    event: keyof EventMap;
+    method: string;
+}
+export interface RegisteredEntry extends HandlerEntry {
+    schema?: ToolSchema;
+}
+/**
+ * Marks a method as a listener for a bus event.
+ *   Pure event    → (payload: EventMap[E]) => void | Promise<void>
+ *   Callable event (rare) → (params: EventMap[E]['params']) => Promise<EventMap[E]['result']>
+ *
+ * Use @register instead for callable events that should be agent-accessible.
+ * Handlers are wired by bus.bootstrap() at boot.
+ */
+export declare function on<E extends keyof EventMap>(event: E): (method: HandlerOf<E>, context: ClassMethodDecoratorContext) => HandlerOf<E>;
+/**
+ * Marks a method as a callable event provider.
+ *
+ * Params:
+ *   - event: the callable event name (e.g., 'agent.execute')
+ *   - tool: optional ToolSchema with description and zod schema
+ *           If omitted, the callable is internal (not exposed as an agent tool)
+ *
+ * Signature: (params: EventMap[E]['params']) => Promise<EventMap[E]['result']>
+ *
+ * Handlers are wired by bus.bootstrap() at boot.
+ */
+export declare function register<E extends keyof EventMap>(event: E, tool?: ToolSchema): (method: HandlerOf<E>, context: ClassMethodDecoratorContext) => HandlerOf<E>;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/gateway/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../gateway/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAK1C,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAO,CAAC,CAAC,UAAU,CAAC;IAC1B,MAAM,CAAC,EAAM,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAC;CAC1C;AAID,eAAO,MAAM,QAAQ,eAA4B,CAAC;AAClD,eAAO,MAAM,KAAK,eAA4B,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAG,MAAM,QAAQ,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AASD;;;;;;;GAOG;AACH,wBAAgB,EAAE,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,KAAK,EAAE,CAAC,IAEjD,QAAQ,SAAS,CAAC,CAAC,CAAC,EACpB,SAAS,2BAA2B,KACnC,SAAS,CAAC,CAAC,CAAC,CAOhB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,UAAU,IAE1E,QAAQ,SAAS,CAAC,CAAC,CAAC,EACpB,SAAS,2BAA2B,KACnC,SAAS,CAAC,CAAC,CAAC,CAOhB"}

package/dist/gateway/decorators.js

@@ -0,0 +1,43 @@
+// ─── Internal metadata storage ────────────────────────────────────────────────
+export const HANDLERS = Symbol('vargos.handlers'); // @on decorated methods
+export const TOOLS = Symbol('vargos.tools'); // @register decorated methods
+// ─── Decorator ────────────────────────────────────────────────────────────────
+/**
+ * Marks a method as a listener for a bus event.
+ *   Pure event    → (payload: EventMap[E]) => void | Promise<void>
+ *   Callable event (rare) → (params: EventMap[E]['params']) => Promise<EventMap[E]['result']>
+ *
+ * Use @register instead for callable events that should be agent-accessible.
+ * Handlers are wired by bus.bootstrap() at boot.
+ */
+export function on(event) {
+    return function (method, context) {
+        context.addInitializer(function () {
+            const self = this;
+            (self[HANDLERS] ??= []).push({ event, method: String(context.name) });
+        });
+        return method;
+    };
+}
+/**
+ * Marks a method as a callable event provider.
+ *
+ * Params:
+ *   - event: the callable event name (e.g., 'agent.execute')
+ *   - tool: optional ToolSchema with description and zod schema
+ *           If omitted, the callable is internal (not exposed as an agent tool)
+ *
+ * Signature: (params: EventMap[E]['params']) => Promise<EventMap[E]['result']>
+ *
+ * Handlers are wired by bus.bootstrap() at boot.
+ */
+export function register(event, tool) {
+    return function (method, context) {
+        context.addInitializer(function () {
+            const self = this;
+            (self[TOOLS] ??= []).push({ event, method: String(context.name), schema: tool });
+        });
+        return method;
+    };
+}
+//# sourceMappingURL=decorators.js.map

package/dist/gateway/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../gateway/decorators.ts"],"names":[],"mappings":"AAaA,iFAAiF;AAEjF,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAK,wBAAwB;AAC/E,MAAM,CAAC,MAAM,KAAK,GAAM,MAAM,CAAC,cAAc,CAAC,CAAC,CAAS,8BAA8B;AAgBtF,iFAAiF;AAEjF;;;;;;;GAOG;AACH,MAAM,UAAU,EAAE,CAA2B,KAAQ;IACnD,OAAO,UACL,MAAoB,EACpB,OAAoC;QAEpC,OAAO,CAAC,cAAc,CAAC;YACrB,MAAM,IAAI,GAAG,IAAmB,CAAC;YACjC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,QAAQ,CAA2B,KAAQ,EAAE,IAAiB;IAC5E,OAAO,UACL,MAAoB,EACpB,OAAoC;QAEpC,OAAO,CAAC,cAAc,CAAC;YACrB,MAAM,IAAI,GAAG,IAAmB,CAAC;YACjC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACnF,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}

package/dist/gateway/emitter.d.ts

@@ -0,0 +1,42 @@
+import type { EventMap, EventMetadata } from './events.js';
+import type { Bus, HandlerOf, CallableEventKey, PureEventKey } from './bus.js';
+import { type ToolSchema } from './decorators.js';
+import type { EventParams, EventResult } from './bus.js';
+/**
+ * Predicate: is this event metadata a usable tool?
+ * (type === 'tool', has a description, and has a schema)
+ */
+export declare function isToolEvent(metadata: EventMetadata): boolean;
+export declare class EventEmitterBus implements Bus {
+    private readonly ee;
+    private readonly timeoutMs;
+    private readonly callableRegistry;
+    private readonly handlersRegistry;
+    constructor(timeoutMs?: number);
+    emit<E extends PureEventKey>(event: E, payload: EventMap[E]): void;
+    on<E extends PureEventKey>(event: E, handler: HandlerOf<E>): () => void;
+    /** Check if an event is callable (only events registered via @register). */
+    isCallable(eventName: string): boolean;
+    call<E extends CallableEventKey>(event: E, params: EventParams<E>): Promise<EventResult<E>>;
+    /**
+     * Reads @on and @register decorator metadata from a service instance (or the bus itself
+     * if no service provided) and wires all declared handlers to this bus.
+     */
+    bootstrap(service?: object): void;
+    /**
+     * Register a new callable tool at runtime.
+     * Used by services (like MCP) to dynamically register tools after boot.
+     * Returns an unsubscribe function to remove the tool.
+     */
+    registerTool(event: string, handler: (params: unknown) => Promise<unknown>, schema: ToolSchema): () => void;
+    /**
+     * Unregister a callable tool that was previously registered at runtime.
+     * Returns true if the tool existed and was removed, false otherwise.
+     */
+    unregisterTool(event: string): boolean;
+    search(params?: EventMap['bus.search']['params']): Promise<EventMetadata[]>;
+    inspect(params: EventMap['bus.inspect']['params']): Promise<EventMetadata | null>;
+    private registerHandlers;
+    private registerTools;
+}
+//# sourceMappingURL=emitter.d.ts.map

package/dist/gateway/emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../../gateway/emitter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC/E,OAAO,EAA6B,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAiBzD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAE5D;AAED,qBAAa,eAAgB,YAAW,GAAG;IACzC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAsB;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAiC;IAClE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqB;gBAE1C,SAAS,SAA0B;IAO/C,IAAI,CAAC,CAAC,SAAS,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;IAIlE,EAAE,CAAC,CAAC,SAAS,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAKvE,4EAA4E;IAC5E,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAItC,IAAI,CAAC,CAAC,SAAS,gBAAgB,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IA0B3F;;;OAGG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAgCjC;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,IAAI;IAQ3G;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAchC,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA2C3E,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAkCvF,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,aAAa;CAiBtB"}