@chozzz/vargos 2.0.3

package/dist/gateway/emitter.js

@@ -0,0 +1,259 @@
+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 EventEmitter from 'node:events';
+import { randomUUID } from 'node:crypto';
+import { z } from 'zod';
+import { register, HANDLERS, TOOLS } from './decorators.js';
+import { createLogger } from '../lib/logger.js';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+const log = createLogger('bus');
+const DEFAULT_CALL_TIMEOUT_MS = 35 * 60 * 1000; // 35 minutes (exceeds agent.execute 30min timeout)
+/**
+ * Predicate: is this event metadata a usable tool?
+ * (type === 'tool', has a description, and has a schema)
+ */
+export function isToolEvent(metadata) {
+    return metadata.type === 'tool' && metadata.description !== '(no description)' && !!metadata.schema;
+}
+let EventEmitterBus = (() => {
+    let _instanceExtraInitializers = [];
+    let _search_decorators;
+    let _inspect_decorators;
+    return class EventEmitterBus {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
+            _search_decorators = [register('bus.search', {
+                    description: 'Search all callable bus events. Optionally filter by query string.',
+                    schema: z.object({
+                        query: z.string().optional().describe('Filter events by name substring'),
+                    }),
+                })];
+            _inspect_decorators = [register('bus.inspect', {
+                    description: 'Get detailed metadata for a specific bus event.',
+                    schema: z.object({
+                        event: z.string().describe('Event name to inspect'),
+                    }),
+                })];
+            __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);
+            __esDecorate(this, null, _inspect_decorators, { kind: "method", name: "inspect", static: false, private: false, access: { has: obj => "inspect" in obj, get: obj => obj.inspect }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        ee = (__runInitializers(this, _instanceExtraInitializers), new EventEmitter());
+        timeoutMs;
+        callableRegistry = new Map(); // Callable events from @register + schemas
+        handlersRegistry = new Set(); // Handler events from @on
+        constructor(timeoutMs = DEFAULT_CALL_TIMEOUT_MS) {
+            this.timeoutMs = timeoutMs;
+            this.ee.setMaxListeners(0); // Disable MaxListeners warning; this is a server with many legitimate listeners
+        }
+        // ── Bus interface ───────────────────────────────────────────────────────────
+        emit(event, payload) {
+            this.ee.emit(event, payload);
+        }
+        on(event, handler) {
+            return this.registerHandlers(event, handler);
+        }
+        /** Check if an event is callable (only events registered via @register). */
+        isCallable(eventName) {
+            return this.callableRegistry.has(eventName);
+        }
+        call(event, params) {
+            return new Promise((resolve, reject) => {
+                const cid = randomUUID();
+                const reqEvent = `${event}._req`;
+                const resEvent = `${event}._res`;
+                const timer = setTimeout(() => {
+                    this.ee.off(resEvent, onReply);
+                    reject(new Error(`bus.call('${event}') timed out after ${this.timeoutMs}ms`));
+                }, this.timeoutMs);
+                const onReply = (res) => {
+                    if (res._cid !== cid)
+                        return;
+                    clearTimeout(timer);
+                    this.ee.off(resEvent, onReply);
+                    if (res.error !== undefined)
+                        reject(new Error(res.error));
+                    else
+                        resolve(res.result);
+                };
+                this.ee.on(resEvent, onReply);
+                this.ee.emit(reqEvent, { params, _cid: cid });
+            });
+        }
+        // ── Service registration (called from index.ts after instantiation) ─────────
+        /**
+         * 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) {
+            const svc = service ?? this;
+            const handlers = svc[HANDLERS] ?? [];
+            const tools = svc[TOOLS] ?? [];
+            const allEvents = [...handlers.map(e => e.event), ...tools.map(e => e.event)];
+            log.info(`bootstrap: ${svc.constructor.name} → [${allEvents.join(', ')}]`);
+            // Register @on handlers (pure events)
+            for (const { event, method } of handlers) {
+                const fn = svc[method];
+                if (typeof fn !== 'function')
+                    continue;
+                this.handlersRegistry.add(event);
+                this.registerHandlers(event, fn.bind(svc));
+            }
+            // Pre-populate callable registry with tools that have schema (agent-callable)
+            for (const { event, schema } of tools) {
+                if (schema) {
+                    this.callableRegistry.set(event, schema);
+                }
+            }
+            for (const { event, method } of tools) {
+                const fn = svc[method];
+                if (typeof fn !== 'function')
+                    continue;
+                this.registerTools(event, fn.bind(svc));
+            }
+        }
+        // ── Runtime tool registration ─────────────────────────────────────────────────
+        /**
+         * 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, handler, schema) {
+            // Register in the callable registry
+            this.callableRegistry.set(event, schema);
+            // Wire the handler using the same pattern as @register decorated methods
+            return this.registerTools(event, handler);
+        }
+        /**
+         * Unregister a callable tool that was previously registered at runtime.
+         * Returns true if the tool existed and was removed, false otherwise.
+         */
+        unregisterTool(event) {
+            const existed = this.callableRegistry.has(event);
+            this.callableRegistry.delete(event);
+            return existed;
+        }
+        // ── Bus introspection ─────────────────────────────────────────────────────────
+        async search(params) {
+            const result = [];
+            const query = params?.query;
+            // Include handlers
+            for (const event of this.handlersRegistry) {
+                if (query && !event.includes(query))
+                    continue;
+                result.push({
+                    event,
+                    description: '(no description)',
+                    type: 'handler',
+                });
+            }
+            // Include tools
+            for (const event of this.callableRegistry.keys()) {
+                if (query && !event.includes(query))
+                    continue;
+                const toolSchema = this.callableRegistry.get(event);
+                let schema;
+                try {
+                    if (toolSchema?.schema) {
+                        schema = { params: zodToJsonSchema(toolSchema.schema) };
+                    }
+                }
+                catch (err) {
+                    log.error(`Failed to convert schema for ${event}: ${err instanceof Error ? err.message : String(err)}`);
+                }
+                result.push({
+                    event,
+                    description: toolSchema?.description || '(no description)',
+                    type: 'tool',
+                    schema,
+                });
+            }
+            return result;
+        }
+        async inspect(params) {
+            // Check if it's a tool
+            const toolSchema = this.callableRegistry.get(params.event);
+            if (toolSchema) {
+                let schema;
+                try {
+                    if (toolSchema.schema) {
+                        schema = { params: zodToJsonSchema(toolSchema.schema) };
+                    }
+                }
+                catch (err) {
+                    log.error(`Failed to convert schema for ${params.event}: ${err instanceof Error ? err.message : String(err)}`);
+                }
+                return {
+                    event: params.event,
+                    description: toolSchema.description,
+                    type: 'tool',
+                    schema,
+                };
+            }
+            // Check if it's a handler
+            if (this.handlersRegistry.has(params.event)) {
+                return {
+                    event: params.event,
+                    description: '(no description)',
+                    type: 'handler',
+                };
+            }
+            return null;
+        }
+        // ── Internal registration ──────────────────────────────────────────────────────
+        registerHandlers(event, handler) {
+            this.ee.on(event, handler);
+            return () => this.ee.off(event, handler);
+        }
+        registerTools(event, handler) {
+            const reqEvent = `${event}._req`;
+            const resEvent = `${event}._res`;
+            const wrapper = async (req) => {
+                try {
+                    const result = await handler(req.params);
+                    this.ee.emit(resEvent, { result, _cid: req._cid });
+                }
+                catch (err) {
+                    const error = err instanceof Error ? err.message : String(err);
+                    this.ee.emit(resEvent, { result: undefined, error, _cid: req._cid });
+                }
+            };
+            this.ee.on(reqEvent, wrapper);
+            return () => this.ee.off(reqEvent, wrapper);
+        }
+    };
+})();
+export { EventEmitterBus };
+//# sourceMappingURL=emitter.js.map

package/dist/gateway/emitter.js.map

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

package/dist/gateway/events.d.ts

@@ -0,0 +1,343 @@
+export type { ThinkingLevel, ChannelEntry, CronTask, CronAddParams, CronUpdateParams, WebhookEntry, Json, AppConfig } from '../services/config/index.js';
+import type { ChannelEntry, CronTask, CronAddParams, CronUpdateParams, WebhookEntry, Json, AppConfig } from '../services/config/index.js';
+export type { ImageMimeType, AudioMimeType, VideoMimeType, DocumentMimeType } from '../lib/media-transcribe.js';
+import type { ImageMimeType, AudioMimeType, VideoMimeType, DocumentMimeType } from '../lib/media-transcribe.js';
+export type ChannelStatus = 'disconnected' | 'connecting' | 'connected' | 'error';
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export type Pagination<T> = {
+    items: T[];
+    page: number;
+    limit: number;
+};
+export interface ChannelInfo {
+    instanceId: string;
+    type: string;
+    status: ChannelStatus;
+}
+export interface ErrorEntry {
+    service: string;
+    error: string;
+    context?: Json;
+    timestamp: number;
+}
+export interface MemorySearchResult {
+    citation: string;
+    score: number;
+    content: string;
+    startLine: number;
+    endLine: number;
+}
+export interface EventMetadata {
+    event: string;
+    description: string;
+    type: 'handler' | 'tool';
+    schema?: {
+        params?: unknown;
+        result?: unknown;
+    };
+}
+export interface InboundMessageMetadata {
+    /** Unique message identifier for reactions (e.g., Telegram message_id) */
+    messageId?: string;
+    /** When set to true, do not prompt agent. But still append the message to the agent's history. */
+    skipAgent?: boolean;
+    /** Working directory for the agent — defaults to vargos workspace. When set,
+     *  bootstrap files (AGENTS.md, SOUL.md, TOOLS.md) from both cwd and workspace are merged. */
+    cwd?: string;
+    /** Username/display name of the message sender (for group chat attribution) */
+    fromUser?: string;
+    /** Sender's user ID (for whitelist enforcement). Platform-specific: Telegram user ID, WhatsApp JID, etc. */
+    fromUserId?: string;
+    /** Sender's @handle on the platform (e.g. Telegram username). Optional — not all platforms have one. */
+    fromUserHandle?: string;
+    /** Chat type — 'private' for 1:1, 'group' for group chats. Helps determine if bot was explicitly addressed. */
+    chatType?: 'private' | 'group';
+    /** True if bot was explicitly mentioned or replied to in a group chat. */
+    isMentioned?: boolean;
+    /** Platform/adapter type (e.g., 'telegram', 'whatsapp') */
+    channelType?: string;
+    /** Bot's user ID on the platform (numeric for Telegram, JID for WhatsApp). */
+    botUserId?: string;
+    /** Bot's display/first name. */
+    botName?: string;
+    /** Bot's @handle on the platform (e.g. Telegram bot username). */
+    botHandle?: string;
+    /** Model override for this message (e.g., "claude-opus-4"). If not set, uses agent.model from config. */
+    model?: string;
+    /** Media attachment metadata with content reference — discriminated by type */
+    media?: {
+        type: 'image';
+        mimeType?: ImageMimeType;
+        path?: string;
+        description?: string;
+    } | {
+        type: 'audio';
+        mimeType?: AudioMimeType;
+        path?: string;
+        transcription?: string;
+    } | {
+        type: 'video';
+        mimeType?: VideoMimeType;
+        path?: string;
+    } | {
+        type: 'document';
+        mimeType?: DocumentMimeType;
+        path?: string;
+    };
+}
+export interface AgentExecuteParams {
+    /** Session key — required for direct callers (channels, cron, webhooks, TCP).
+     *  When the agent calls agent.execute as a tool, wrapEventAsToolDefinition injects this automatically. */
+    sessionKey: string;
+    /** The task to execute or delegate to the agent. */
+    task: string;
+    /** The current working directory to use for the agent. Fallbacks to channel's cwd config, then lastly vargos workspace dir. */
+    cwd?: string;
+    /** Metadata for the inbound message */
+    metadata?: InboundMessageMetadata;
+}
+export interface AgentAppendMessageParams extends Pick<AgentExecuteParams, 'sessionKey' | 'metadata'> {
+    content: string;
+}
+export interface EventMap {
+    /** Structured log line — LogService subscribes and handles output + persistence. */
+    'log.onLog': {
+        level: LogLevel;
+        service: string;
+        message: string;
+        data?: Json;
+    };
+    /** Streaming LLM chunk from an active agent run. */
+    'agent.onDelta': {
+        sessionKey: string;
+        chunk: string;
+    };
+    /** Tool lifecycle within a run. */
+    'agent.onTool': ({
+        sessionKey: string;
+        toolName: string;
+        phase: 'start';
+        args: Json;
+    } | {
+        sessionKey: string;
+        toolName: string;
+        phase: 'end';
+        result: Json;
+    });
+    /** Run finished (success or failure). */
+    'agent.onCompleted': ({
+        sessionKey: string;
+        success: true;
+        response: string;
+    } | {
+        sessionKey: string;
+        success: false;
+        error: string;
+    });
+    'channel.onConnected': {
+        instanceId: string;
+        type: string;
+    };
+    'channel.onDisconnected': {
+        instanceId: string;
+    };
+    /** Emitted after all services are registered — signals boot completion. Deferred startup can proceed. */
+    'bus.onReady': Record<string, never>;
+    'config.get': {
+        params: Record<string, never>;
+        result: AppConfig;
+    };
+    'config.set': {
+        params: AppConfig;
+        result: AppConfig;
+    };
+    'agent.execute': {
+        params: AgentExecuteParams;
+        result: {
+            response: string;
+        };
+    };
+    'agent.appendMessage': {
+        params: AgentAppendMessageParams;
+        result: void;
+    };
+    'agent.status': {
+        params: {
+            sessionKey?: string;
+        };
+        result: {
+            activeRuns: string[];
+        };
+    };
+    'media.transcribeAudio': {
+        params: {
+            filePath: string;
+        };
+        result: {
+            text: string;
+        };
+    };
+    'media.describeImage': {
+        params: {
+            filePath: string;
+        };
+        result: {
+            description: string;
+        };
+    };
+    'media.extractDocument': {
+        params: {
+            filePath: string;
+            mimeType: string;
+        };
+        result: {
+            text: string;
+        };
+    };
+    'web.fetch': {
+        params: {
+            url: string;
+            extractMode?: 'markdown' | 'text';
+            maxChars?: number;
+        };
+        result: {
+            text: string;
+        };
+    };
+    'channel.send': {
+        params: {
+            sessionKey: string;
+            text: string;
+            /** Optional source sessionKey for cross-session forwards. When set, the message is also
+             *  appended to the target session's history as `[fromSessionKey] text` so the receiving
+             *  agent knows it came from elsewhere (cron, webhook, agent forwarding to another channel). */
+            fromSessionKey?: string;
+        };
+        result: {
+            sent: boolean;
+        };
+    };
+    'channel.sendMedia': {
+        params: {
+            sessionKey: string;
+            filePath: string;
+            mimeType: string;
+            caption?: string;
+        };
+        result: {
+            sent: boolean;
+        };
+    };
+    'channel.search': {
+        params: {
+            query?: string;
+            page: number;
+            limit?: number;
+        };
+        result: Pagination<ChannelInfo>;
+    };
+    'channel.get': {
+        params: {
+            instanceId: string;
+        };
+        result: ChannelInfo;
+    };
+    'channel.register': {
+        params: ChannelEntry & {
+            persist?: boolean;
+        };
+        result: void;
+    };
+    'cron.search': {
+        params: {
+            query?: string;
+            page: number;
+            limit?: number;
+        };
+        result: Pagination<CronTask>;
+    };
+    'cron.add': {
+        params: CronAddParams;
+        result: void;
+    };
+    'cron.remove': {
+        params: {
+            id: string;
+        };
+        result: void;
+    };
+    'cron.update': {
+        params: CronUpdateParams;
+        result: void;
+    };
+    'cron.run': {
+        params: {
+            id: string;
+        };
+        result: void;
+    };
+    'webhook.search': {
+        params: {
+            query?: string;
+            page: number;
+            limit?: number;
+        };
+        result: Pagination<WebhookEntry>;
+    };
+    'memory.search': {
+        params: {
+            query: string;
+            maxResults?: number;
+            minScore?: number;
+        };
+        result: MemorySearchResult[];
+    };
+    'memory.read': {
+        params: {
+            path: string;
+            from?: number;
+            lines?: number;
+        };
+        result: {
+            path: string;
+            text: string;
+        };
+    };
+    'memory.write': {
+        params: {
+            path: string;
+            content: string;
+            mode?: 'overwrite' | 'append';
+        };
+        result: void;
+    };
+    'memory.stats': {
+        params: Record<string, never>;
+        result: {
+            files: number;
+            chunks: number;
+            lastSync: Date | null;
+        };
+    };
+    'log.search': {
+        params: {
+            sinceMs?: number;
+            service?: string;
+            level?: LogLevel;
+        };
+        result: ErrorEntry[];
+    };
+    'bus.search': {
+        params: {
+            query?: string;
+        };
+        result: EventMetadata[];
+    };
+    'bus.inspect': {
+        params: {
+            event: string;
+        };
+        result: EventMetadata | null;
+    };
+}
+//# sourceMappingURL=events.d.ts.map

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

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

package/dist/gateway/events.js

@@ -0,0 +1,7 @@
+// Single source of truth for all inter-service communication.
+//
+// Two event shapes:
+//   Pure     — flat payload, use bus.emit / @on
+//   Callable — { params, result }, use bus.call / @on (wired as request/reply)
+export {};
+//# sourceMappingURL=events.js.map

package/dist/gateway/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../gateway/events.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,EAAE;AACF,oBAAoB;AACpB,gDAAgD;AAChD,+EAA+E"}

package/dist/gateway/tcp-server.d.ts

@@ -0,0 +1,7 @@
+/**
+ * TCP/JSON-RPC server for the bus
+ * Minimal wrapper around EventEmitterBus to expose it over TCP
+ */
+import type { Bus } from './bus.js';
+export declare function startTCPServer(bus: Bus, host: string, port: number, socketTimeoutMs?: number): Promise<() => Promise<void>>;
+//# sourceMappingURL=tcp-server.d.ts.map

package/dist/gateway/tcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tcp-server.d.ts","sourceRoot":"","sources":["../../gateway/tcp-server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAoB,MAAM,UAAU,CAAC;AAiBtD,wBAAgB,cAAc,CAC5B,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,eAAe,GAAE,MAAe,GAC/B,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CA2C9B"}