@wingmanjs/core 0.1.0

package/dist/telemetry.d.ts

@@ -0,0 +1,52 @@
+/**
+ * WingmanTracer — OpenTelemetry instrumentation for the Copilot SDK.
+ *
+ * Maps SDK SessionEvents → OTel spans following:
+ * - GenAI semantic conventions (gen_ai.* attributes)
+ * - MCP semantic conventions (mcp.* attributes)
+ *
+ * Designed to be fully no-op when telemetry is disabled.
+ *
+ * Span hierarchy:
+ *   HTTP request span (auto from Express instrumentation)
+ *     └─ chat {model}                    (parent — one per sendMessage call)
+ *         ├─ tools/call {toolName}       (child — one per tool execution)
+ *         ├─ invoke_agent {agentName}    (child — one per subagent)
+ *         └─ skill {skillName}           (child — one per skill invocation)
+ *
+ * @see https://opentelemetry.io/docs/specs/semconv/gen-ai/
+ * @see https://github.com/open-telemetry/semantic-conventions/blob/main/docs/gen-ai/mcp.md
+ */
+import type { WingmanTelemetryConfig } from './types.js';
+import type { EventCallbacks } from './events.js';
+export declare class WingmanTracer {
+    private tracer;
+    private config;
+    constructor(config?: WingmanTelemetryConfig);
+    /**
+     * Create EventCallbacks that produce OTel spans.
+     * State is scoped per-call so concurrent sendMessage turns are isolated.
+     */
+    createCallbacks(sessionId: string, model: string): EventCallbacks;
+    /**
+     * Track MCP server connection lifecycle with OTel spans.
+     * Call `onConnect`, `onDisconnect`, or `onAuthError` to record lifecycle events.
+     * Each returned function also ends the span — call exactly one of them.
+     */
+    traceMCPConnection(serverName: string): {
+        onConnect: () => void;
+        onDisconnect: (reason?: string) => void;
+        onAuthError: (error: Error) => void;
+    };
+}
+/** Returns empty callbacks that do nothing — zero overhead. */
+export declare function createNoopCallbacks(): EventCallbacks;
+/**
+ * Create a tracer (or no-op) based on config.
+ * Call this at startup; returns the tracer + its callbacks.
+ */
+export declare function createTracer(config?: WingmanTelemetryConfig): {
+    tracer: WingmanTracer | null;
+    createCallbacks: (sessionId: string, model: string) => EventCallbacks;
+};
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAyClD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAA2D;gBAE7D,MAAM,GAAE,sBAA2B;IAO/C;;;OAGG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc;IA2NjE;;;;OAIG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG;QACtC,SAAS,EAAE,MAAM,IAAI,CAAC;QACtB,YAAY,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;QACxC,WAAW,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;KACrC;CAiCF;AAMD,+DAA+D;AAC/D,wBAAgB,mBAAmB,IAAI,cAAc,CAEpD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,MAAM,GAAE,sBAA2B,GAClC;IAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAAC,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,cAAc,CAAA;CAAE,CAczG"}

package/dist/telemetry.js

@@ -0,0 +1,313 @@
+/**
+ * WingmanTracer — OpenTelemetry instrumentation for the Copilot SDK.
+ *
+ * Maps SDK SessionEvents → OTel spans following:
+ * - GenAI semantic conventions (gen_ai.* attributes)
+ * - MCP semantic conventions (mcp.* attributes)
+ *
+ * Designed to be fully no-op when telemetry is disabled.
+ *
+ * Span hierarchy:
+ *   HTTP request span (auto from Express instrumentation)
+ *     └─ chat {model}                    (parent — one per sendMessage call)
+ *         ├─ tools/call {toolName}       (child — one per tool execution)
+ *         ├─ invoke_agent {agentName}    (child — one per subagent)
+ *         └─ skill {skillName}           (child — one per skill invocation)
+ *
+ * @see https://opentelemetry.io/docs/specs/semconv/gen-ai/
+ * @see https://github.com/open-telemetry/semantic-conventions/blob/main/docs/gen-ai/mcp.md
+ */
+import { trace, context, SpanStatusCode } from '@opentelemetry/api';
+const TRACER_NAME = 'wingman';
+const TRACER_VERSION = '0.1.0';
+// ---------------------------------------------------------------------------
+// GenAI + MCP semantic convention attribute keys
+// ---------------------------------------------------------------------------
+const ATTR = {
+    // GenAI conventions
+    GEN_AI_SYSTEM: 'gen_ai.system',
+    GEN_AI_REQUEST_MODEL: 'gen_ai.request.model',
+    GEN_AI_RESPONSE_MODEL: 'gen_ai.response.model',
+    GEN_AI_CONVERSATION_ID: 'gen_ai.conversation.id',
+    GEN_AI_OPERATION_NAME: 'gen_ai.operation.name',
+    GEN_AI_USAGE_INPUT_TOKENS: 'gen_ai.usage.input_tokens',
+    GEN_AI_USAGE_OUTPUT_TOKENS: 'gen_ai.usage.output_tokens',
+    GEN_AI_USAGE_CACHE_READ_TOKENS: 'gen_ai.usage.cache_read.input_tokens',
+    GEN_AI_TOOL_NAME: 'gen_ai.tool.name',
+    GEN_AI_TOOL_CALL_ID: 'gen_ai.tool.call.id',
+    // MCP conventions
+    MCP_METHOD_NAME: 'mcp.method.name',
+    MCP_SERVER_NAME: 'mcp.server.name',
+    MCP_SESSION_ID: 'mcp.session.id',
+    NETWORK_TRANSPORT: 'network.transport',
+    // Error conventions
+    ERROR_TYPE: 'error.type',
+    // OTel exception conventions
+    EXCEPTION_TYPE: 'exception.type',
+    EXCEPTION_MESSAGE: 'exception.message',
+    EXCEPTION_STACKTRACE: 'exception.stacktrace',
+};
+// ---------------------------------------------------------------------------
+// WingmanTracer
+// ---------------------------------------------------------------------------
+export class WingmanTracer {
+    tracer;
+    config;
+    constructor(config = {}) {
+        this.tracer = trace.getTracer(TRACER_NAME, TRACER_VERSION);
+        this.config = {
+            captureContent: config.captureContent ?? false,
+        };
+    }
+    /**
+     * Create EventCallbacks that produce OTel spans.
+     * State is scoped per-call so concurrent sendMessage turns are isolated.
+     */
+    createCallbacks(sessionId, model) {
+        // Per-turn state — each sendMessage call gets isolated span tracking
+        let chatSpan = null;
+        const toolSpans = new Map();
+        const subagentSpans = new Map();
+        const tracer = this.tracer;
+        const captureContent = this.config.captureContent;
+        // -- Span lifecycle helpers (close over per-turn state) --
+        const startChatSpan = () => {
+            endChatSpan();
+            chatSpan = tracer.startSpan(`chat ${model}`, {
+                attributes: {
+                    [ATTR.GEN_AI_SYSTEM]: 'github.copilot',
+                    [ATTR.GEN_AI_OPERATION_NAME]: 'chat',
+                    [ATTR.GEN_AI_REQUEST_MODEL]: model,
+                    [ATTR.GEN_AI_CONVERSATION_ID]: sessionId,
+                },
+            });
+        };
+        const endChatSpan = () => {
+            if (chatSpan) {
+                chatSpan.end();
+                chatSpan = null;
+            }
+            for (const [id, span] of toolSpans) {
+                span.setStatus({ code: SpanStatusCode.ERROR, message: 'Orphaned tool span' });
+                span.end();
+                toolSpans.delete(id);
+            }
+            for (const [id, span] of subagentSpans) {
+                span.setStatus({ code: SpanStatusCode.ERROR, message: 'Orphaned subagent span' });
+                span.end();
+                subagentSpans.delete(id);
+            }
+        };
+        const startToolSpan = (toolCallId, toolName, mcpServerName, mcpToolName, args) => {
+            const parentContext = chatSpan
+                ? trace.setSpan(context.active(), chatSpan)
+                : context.active();
+            const attributes = {
+                [ATTR.GEN_AI_SYSTEM]: 'github.copilot',
+                [ATTR.GEN_AI_TOOL_NAME]: toolName,
+                [ATTR.GEN_AI_TOOL_CALL_ID]: toolCallId,
+                ...(mcpServerName && {
+                    [ATTR.MCP_SERVER_NAME]: mcpServerName,
+                    [ATTR.MCP_METHOD_NAME]: 'tools/call',
+                    [ATTR.NETWORK_TRANSPORT]: 'pipe',
+                }),
+                ...(mcpToolName && { 'mcp.tool.name': mcpToolName }),
+            };
+            if (captureContent && args) {
+                try {
+                    attributes['gen_ai.tool.call.arguments'] = JSON.stringify(args);
+                }
+                catch {
+                    attributes['gen_ai.tool.call.arguments'] = '[unserializable]';
+                }
+            }
+            const span = tracer.startSpan(`tools/call ${toolName}`, { attributes }, parentContext);
+            toolSpans.set(toolCallId, span);
+        };
+        const endToolSpan = (toolCallId, _toolName, result) => {
+            const span = toolSpans.get(toolCallId);
+            if (!span)
+                return;
+            const isError = result.startsWith('Error:') || result.startsWith('error:');
+            if (isError) {
+                const err = new Error(result.slice(0, 500));
+                err.name = 'ToolError';
+                span.recordException(err);
+                span.setStatus({ code: SpanStatusCode.ERROR, message: result.slice(0, 200) });
+                span.setAttribute(ATTR.ERROR_TYPE, 'tool_error');
+            }
+            else {
+                span.setStatus({ code: SpanStatusCode.OK });
+            }
+            if (captureContent && !isError) {
+                span.setAttribute('gen_ai.tool.call.result', result.slice(0, 4096));
+            }
+            span.end();
+            toolSpans.delete(toolCallId);
+        };
+        const startSubagentSpan = (toolCallId, agentName) => {
+            const parentContext = chatSpan
+                ? trace.setSpan(context.active(), chatSpan)
+                : context.active();
+            const span = tracer.startSpan(`invoke_agent ${agentName}`, {
+                attributes: {
+                    [ATTR.GEN_AI_SYSTEM]: 'github.copilot',
+                    [ATTR.GEN_AI_OPERATION_NAME]: 'invoke_agent',
+                    'gen_ai.agent.name': agentName,
+                },
+            }, parentContext);
+            subagentSpans.set(toolCallId, span);
+        };
+        const endSubagentSpan = (toolCallId, error) => {
+            const span = subagentSpans.get(toolCallId);
+            if (!span)
+                return;
+            if (error) {
+                span.setStatus({ code: SpanStatusCode.ERROR, message: error });
+                span.setAttribute(ATTR.ERROR_TYPE, 'agent_error');
+            }
+            else {
+                span.setStatus({ code: SpanStatusCode.OK });
+            }
+            span.end();
+            subagentSpans.delete(toolCallId);
+        };
+        const recordUsage = (inputTokens, outputTokens, cacheReadTokens, responseModel) => {
+            if (!chatSpan)
+                return;
+            chatSpan.setAttribute(ATTR.GEN_AI_USAGE_INPUT_TOKENS, inputTokens);
+            chatSpan.setAttribute(ATTR.GEN_AI_USAGE_OUTPUT_TOKENS, outputTokens);
+            if (cacheReadTokens != null) {
+                chatSpan.setAttribute(ATTR.GEN_AI_USAGE_CACHE_READ_TOKENS, cacheReadTokens);
+            }
+            if (responseModel) {
+                chatSpan.setAttribute(ATTR.GEN_AI_RESPONSE_MODEL, responseModel);
+            }
+        };
+        const recordError = (message) => {
+            if (!chatSpan)
+                return;
+            chatSpan.recordException(new Error(message));
+            chatSpan.setStatus({ code: SpanStatusCode.ERROR, message });
+            chatSpan.setAttribute(ATTR.ERROR_TYPE, 'session_error');
+        };
+        const recordSkillInvocation = (name, pluginName) => {
+            if (!chatSpan)
+                return;
+            chatSpan.addEvent('skill.invoked', {
+                'skill.name': name,
+                ...(pluginName && { 'skill.plugin': pluginName }),
+            });
+        };
+        const recordSpanEvent = (eventName, attributes) => {
+            if (!chatSpan)
+                return;
+            const safeAttrs = {};
+            if (attributes) {
+                for (const [key, value] of Object.entries(attributes)) {
+                    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+                        safeAttrs[key] = value;
+                    }
+                    else if (value != null) {
+                        try {
+                            safeAttrs[key] = JSON.stringify(value);
+                        }
+                        catch {
+                            safeAttrs[key] = '[unserializable]';
+                        }
+                    }
+                }
+            }
+            chatSpan.addEvent(eventName, safeAttrs);
+        };
+        // -- Return callbacks that close over per-turn state --
+        return {
+            onTurnStart: (_turnId) => startChatSpan(),
+            onTurnEnd: (_turnId) => endChatSpan(),
+            onToolStart: (tool) => {
+                startToolSpan(tool.toolCallId, tool.toolName, tool.mcpServerName, tool.mcpToolName, tool.arguments);
+            },
+            onToolComplete: (toolCallId, toolName, result) => {
+                endToolSpan(toolCallId, toolName, result);
+            },
+            onUsage: (usage) => {
+                recordUsage(usage.inputTokens, usage.outputTokens, usage.cacheReadTokens, usage.model);
+            },
+            onError: (message) => recordError(message),
+            onSubagentStarted: (toolCallId, name) => startSubagentSpan(toolCallId, name),
+            onSubagentCompleted: (toolCallId) => endSubagentSpan(toolCallId),
+            onSubagentFailed: (toolCallId, _name, error) => endSubagentSpan(toolCallId, error),
+            onSkillInvoked: (name, pluginName) => recordSkillInvocation(name, pluginName),
+            onTruncation: (data) => recordSpanEvent('context.truncation', data),
+            onCompactionStart: () => recordSpanEvent('context.compaction_start'),
+            onCompactionComplete: () => recordSpanEvent('context.compaction_complete'),
+            onModelChange: (newModel) => {
+                if (chatSpan) {
+                    chatSpan.setAttribute(ATTR.GEN_AI_RESPONSE_MODEL, newModel);
+                }
+            },
+        };
+    }
+    /**
+     * Track MCP server connection lifecycle with OTel spans.
+     * Call `onConnect`, `onDisconnect`, or `onAuthError` to record lifecycle events.
+     * Each returned function also ends the span — call exactly one of them.
+     */
+    traceMCPConnection(serverName) {
+        const span = this.tracer.startSpan('mcp.connect', {
+            attributes: {
+                [ATTR.MCP_SERVER_NAME]: serverName,
+                [ATTR.MCP_METHOD_NAME]: 'initialize',
+            },
+        });
+        return {
+            onConnect: () => {
+                span.addEvent('mcp.connected', { [ATTR.MCP_SERVER_NAME]: serverName });
+                span.setStatus({ code: SpanStatusCode.OK });
+                span.end();
+            },
+            onDisconnect: (reason) => {
+                span.addEvent('mcp.disconnected', {
+                    [ATTR.MCP_SERVER_NAME]: serverName,
+                    ...(reason && { reason }),
+                });
+                span.end();
+            },
+            onAuthError: (error) => {
+                span.recordException(error);
+                span.addEvent('mcp.auth_error', {
+                    [ATTR.MCP_SERVER_NAME]: serverName,
+                    [ATTR.EXCEPTION_TYPE]: error.name || error.constructor.name,
+                    [ATTR.EXCEPTION_MESSAGE]: error.message,
+                });
+                span.setStatus({ code: SpanStatusCode.ERROR, message: error.message });
+                span.end();
+            },
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// No-op tracer for when telemetry is disabled
+// ---------------------------------------------------------------------------
+/** Returns empty callbacks that do nothing — zero overhead. */
+export function createNoopCallbacks() {
+    return {};
+}
+/**
+ * Create a tracer (or no-op) based on config.
+ * Call this at startup; returns the tracer + its callbacks.
+ */
+export function createTracer(config = {}) {
+    if (!config.enabled) {
+        return {
+            tracer: null,
+            createCallbacks: () => createNoopCallbacks(),
+        };
+    }
+    const tracer = new WingmanTracer(config);
+    return {
+        tracer,
+        createCallbacks: (sessionId, model) => tracer.createCallbacks(sessionId, model),
+    };
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Wingman — Core types for the GitHub Copilot SDK chat framework.
+ *
+ * These types define the public API surface. All 51 SDK event types are
+ * represented, along with RPC method types, transport adapters, and
+ * configuration schemas.
+ */
+/** Categories of SDK events for routing and filtering. */
+export type EventCategory = 'streaming' | 'reasoning' | 'usage' | 'turn' | 'tool' | 'skill' | 'subagent' | 'session' | 'model' | 'context' | 'mode' | 'title' | 'permission' | 'user_input' | 'message' | 'workspace' | 'hook' | 'task';
+/** All 51 SDK event type strings. */
+export type SDKEventType = 'assistant.message_delta' | 'assistant.streaming_delta' | 'assistant.reasoning_delta' | 'assistant.reasoning' | 'assistant.usage' | 'assistant.turn_start' | 'assistant.turn_end' | 'assistant.intent' | 'tool.execution_start' | 'tool.execution_complete' | 'tool.execution_progress' | 'tool.execution_partial_result' | 'tool.user_requested' | 'skill.invoked' | 'subagent.started' | 'subagent.completed' | 'subagent.failed' | 'subagent.selected' | 'subagent.deselected' | 'session.start' | 'session.resume' | 'session.shutdown' | 'session.idle' | 'session.error' | 'session.info' | 'session.warning' | 'session.model_change' | 'session.truncation' | 'session.compaction_start' | 'session.compaction_complete' | 'session.context_changed' | 'session.mode_changed' | 'session.plan_changed' | 'session.title_changed' | 'permission.requested' | 'permission.completed' | 'elicitation.requested' | 'elicitation.completed' | 'user_input.requested' | 'user_input.completed' | 'user.message' | 'system.message' | 'assistant.message' | 'pending_messages.modified' | 'session.workspace_file_changed' | 'session.snapshot_rewind' | 'hook.start' | 'hook.end' | 'session.task_complete' | 'session.handoff' | 'session.usage_info';
+/** Mapping of event types to their categories for routing. */
+export declare const EVENT_CATEGORIES: Record<SDKEventType, EventCategory>;
+export interface UsageData {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+    model?: string;
+}
+export interface ToolExecution {
+    toolCallId: string;
+    toolName: string;
+    arguments?: Record<string, unknown>;
+    result?: string;
+    status: 'running' | 'complete' | 'error';
+    startedAt: number;
+    completedAt?: number;
+}
+export interface SessionInfo {
+    sessionId: string;
+    title?: string;
+    model?: string;
+    mode?: AgentMode;
+    createdAt: number;
+    updatedAt: number;
+}
+export type AgentMode = 'interactive' | 'plan' | 'autopilot';
+export interface ChatMessage {
+    id: string;
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    timestamp: number;
+    /** Tool executions that occurred during this message. */
+    tools?: ToolExecution[];
+    /** Reasoning/thinking content. */
+    reasoning?: string;
+    /** Token usage for this turn. */
+    usage?: UsageData;
+}
+export interface MCPStdioConfig {
+    type: 'stdio';
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    /** Tool names to enable. Default: ["*"] (all). */
+    tools: string[];
+}
+export interface MCPHttpConfig {
+    type: 'http';
+    url: string;
+    headers?: Record<string, string>;
+    /** Tool names to enable. Default: ["*"] (all). */
+    tools: string[];
+}
+export type MCPServerConfig = MCPStdioConfig | MCPHttpConfig;
+export interface DiscoveredMCPServer {
+    name: string;
+    config: MCPServerConfig;
+    source: 'built-in' | 'global' | 'plugin' | 'project';
+    status: 'connected' | 'disconnected' | 'error';
+    toolCount?: number;
+}
+export type TransportType = 'socketio' | 'sse';
+export interface TransportAdapter {
+    connect(url: string): void;
+    disconnect(): void;
+    send(event: string, data: unknown): void;
+    on(event: string, handler: (data: unknown) => void): void;
+    off(event: string, handler: (data: unknown) => void): void;
+}
+export interface WingmanUIConfig {
+    title?: string;
+    theme?: 'dark' | 'light' | 'system';
+    logo?: string;
+    welcomeMessage?: string;
+    suggestions?: string[];
+    colors?: Record<string, string>;
+    showTokenUsage?: boolean;
+    showModelPicker?: boolean;
+    showModeSwitcher?: boolean;
+    showDebugPanel?: boolean;
+}
+export interface WingmanServerConfig {
+    port?: number;
+    /**
+     * CORS configuration.
+     * - `true`  — allow all origins (`*`). Fine for local dev; **unsafe in production**.
+     * - `false` — disable CORS headers entirely.
+     * - `string` — allow a single origin (e.g. `'https://myapp.com'`).
+     * - `string[]` — allow multiple specific origins.
+     *
+     * @default true
+     */
+    cors?: boolean | string | string[];
+    transport?: TransportType;
+}
+export interface WingmanTelemetryConfig {
+    /** Enable OpenTelemetry tracing. Default: false (fully no-op when disabled). */
+    enabled?: boolean;
+    /** Trace exporter to use. Default: 'console'. */
+    exporter?: 'console' | 'otlp';
+    /** OTLP endpoint URL. Default: http://localhost:4318/v1/traces (Jaeger default). */
+    endpoint?: string;
+    /** OTel service.name attribute. Default: 'wingman'. */
+    serviceName?: string;
+    /** Capture tool arguments and results in span attributes. Off by default (sensitive data). */
+    captureContent?: boolean;
+}
+export interface WingmanConfig {
+    systemPrompt?: string;
+    model?: string;
+    reasoningEffort?: 'low' | 'medium' | 'high' | 'xhigh';
+    mcpServers?: Record<string, MCPServerConfig>;
+    skillDirectories?: string[];
+    customAgents?: string[];
+    tools?: string[];
+    ui?: WingmanUIConfig;
+    server?: WingmanServerConfig;
+    telemetry?: WingmanTelemetryConfig;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,62 @@
+/**
+ * Wingman — Core types for the GitHub Copilot SDK chat framework.
+ *
+ * These types define the public API surface. All 51 SDK event types are
+ * represented, along with RPC method types, transport adapters, and
+ * configuration schemas.
+ */
+/** Mapping of event types to their categories for routing. */
+export const EVENT_CATEGORIES = {
+    'assistant.message_delta': 'streaming',
+    'assistant.streaming_delta': 'streaming',
+    'assistant.reasoning_delta': 'reasoning',
+    'assistant.reasoning': 'reasoning',
+    'assistant.usage': 'usage',
+    'assistant.turn_start': 'turn',
+    'assistant.turn_end': 'turn',
+    'assistant.intent': 'turn',
+    'tool.execution_start': 'tool',
+    'tool.execution_complete': 'tool',
+    'tool.execution_progress': 'tool',
+    'tool.execution_partial_result': 'tool',
+    'tool.user_requested': 'tool',
+    'skill.invoked': 'skill',
+    'subagent.started': 'subagent',
+    'subagent.completed': 'subagent',
+    'subagent.failed': 'subagent',
+    'subagent.selected': 'subagent',
+    'subagent.deselected': 'subagent',
+    'session.start': 'session',
+    'session.resume': 'session',
+    'session.shutdown': 'session',
+    'session.idle': 'session',
+    'session.error': 'session',
+    'session.info': 'session',
+    'session.warning': 'session',
+    'session.model_change': 'model',
+    'session.truncation': 'context',
+    'session.compaction_start': 'context',
+    'session.compaction_complete': 'context',
+    'session.context_changed': 'context',
+    'session.mode_changed': 'mode',
+    'session.plan_changed': 'mode',
+    'session.title_changed': 'title',
+    'permission.requested': 'permission',
+    'permission.completed': 'permission',
+    'elicitation.requested': 'user_input',
+    'elicitation.completed': 'user_input',
+    'user_input.requested': 'user_input',
+    'user_input.completed': 'user_input',
+    'user.message': 'message',
+    'system.message': 'message',
+    'assistant.message': 'message',
+    'pending_messages.modified': 'message',
+    'session.workspace_file_changed': 'workspace',
+    'session.snapshot_rewind': 'workspace',
+    'hook.start': 'hook',
+    'hook.end': 'hook',
+    'session.task_complete': 'task',
+    'session.handoff': 'task',
+    'session.usage_info': 'task',
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmGH,8DAA8D;AAC9D,MAAM,CAAC,MAAM,gBAAgB,GAAwC;IACnE,yBAAyB,EAAE,WAAW;IACtC,2BAA2B,EAAE,WAAW;IACxC,2BAA2B,EAAE,WAAW;IACxC,qBAAqB,EAAE,WAAW;IAClC,iBAAiB,EAAE,OAAO;IAC1B,sBAAsB,EAAE,MAAM;IAC9B,oBAAoB,EAAE,MAAM;IAC5B,kBAAkB,EAAE,MAAM;IAC1B,sBAAsB,EAAE,MAAM;IAC9B,yBAAyB,EAAE,MAAM;IACjC,yBAAyB,EAAE,MAAM;IACjC,+BAA+B,EAAE,MAAM;IACvC,qBAAqB,EAAE,MAAM;IAC7B,eAAe,EAAE,OAAO;IACxB,kBAAkB,EAAE,UAAU;IAC9B,oBAAoB,EAAE,UAAU;IAChC,iBAAiB,EAAE,UAAU;IAC7B,mBAAmB,EAAE,UAAU;IAC/B,qBAAqB,EAAE,UAAU;IACjC,eAAe,EAAE,SAAS;IAC1B,gBAAgB,EAAE,SAAS;IAC3B,kBAAkB,EAAE,SAAS;IAC7B,cAAc,EAAE,SAAS;IACzB,eAAe,EAAE,SAAS;IAC1B,cAAc,EAAE,SAAS;IACzB,iBAAiB,EAAE,SAAS;IAC5B,sBAAsB,EAAE,OAAO;IAC/B,oBAAoB,EAAE,SAAS;IAC/B,0BAA0B,EAAE,SAAS;IACrC,6BAA6B,EAAE,SAAS;IACxC,yBAAyB,EAAE,SAAS;IACpC,sBAAsB,EAAE,MAAM;IAC9B,sBAAsB,EAAE,MAAM;IAC9B,uBAAuB,EAAE,OAAO;IAChC,sBAAsB,EAAE,YAAY;IACpC,sBAAsB,EAAE,YAAY;IACpC,uBAAuB,EAAE,YAAY;IACrC,uBAAuB,EAAE,YAAY;IACrC,sBAAsB,EAAE,YAAY;IACpC,sBAAsB,EAAE,YAAY;IACpC,cAAc,EAAE,SAAS;IACzB,gBAAgB,EAAE,SAAS;IAC3B,mBAAmB,EAAE,SAAS;IAC9B,2BAA2B,EAAE,SAAS;IACtC,gCAAgC,EAAE,WAAW;IAC7C,yBAAyB,EAAE,WAAW;IACtC,YAAY,EAAE,MAAM;IACpB,UAAU,EAAE,MAAM;IAClB,uBAAuB,EAAE,MAAM;IAC/B,iBAAiB,EAAE,MAAM;IACzB,oBAAoB,EAAE,MAAM;CAC7B,CAAC"}