@hansjm10/volt-coding-agent 0.0.0-bootstrap.0 → 0.1.0

package/dist/core/mcp/types.d.ts

@@ -0,0 +1,321 @@
+import type { CallToolResult, GetPromptResult, ListPromptsResult, ListResourcesResult, ListToolsResult, Prompt, ReadResourceResult, Resource, Tool as SdkTool } from "@modelcontextprotocol/sdk/types.js";
+export type McpTransportKind = "stdio" | "streamable-http" | "sse";
+export type McpLifecycle = "lazy" | "eager" | "keep-alive";
+export type McpRisk = "read" | "write" | "destructive" | "unknown";
+export type McpSourceScope = "user" | "project" | "temporary";
+export type McpServerStatus = "disabled" | "untrusted" | "cold" | "discovering" | "connecting" | "connected" | "ready" | "needs_auth" | "authenticating" | "error" | "disconnecting" | "disconnected";
+export type McpAuthState = "none" | "required" | "pending" | "authenticated" | "failed";
+export type McpRecentCallStatus = "started" | "completed" | "failed" | "cancelled";
+export type McpCallerSurface = "model" | "tui" | "rpc" | "mobile" | "print" | "json" | "unknown";
+export interface McpSettings {
+    enabled: boolean;
+    mode: "proxy";
+    idleTimeoutMs: number;
+    connectTimeoutMs: number;
+    metadataTimeoutMs: number;
+    callTimeoutMs: number;
+    maxOutputBytes: number;
+    maxOutputLines: number;
+    directTools: boolean;
+    resources: "explicit" | "disabled";
+    prompts: "user-preview" | "model" | "disabled";
+    metadataRefreshMs: number;
+}
+export interface McpAuthConfig {
+    type?: "none" | "bearer" | "oauth" | "env";
+    token?: string;
+    env?: string;
+    flow?: "browser" | "device" | "auto";
+    scope?: string;
+    clientId?: string;
+    clientSecret?: string;
+    clientMetadataUrl?: string;
+    resourceMetadataUrl?: string;
+    tokenEndpointAuthMethod?: "client_secret_basic" | "client_secret_post" | "none";
+}
+export interface McpServerConfig {
+    enabled: boolean;
+    displayName?: string;
+    transport: McpTransportKind;
+    lifecycle: McpLifecycle;
+    includeTools: string[];
+    excludeTools: string[];
+    directTools: boolean | string[];
+    connectTimeoutMs?: number;
+    callTimeoutMs?: number;
+    idleTimeoutMs?: number;
+    metadataRefreshMs?: number;
+    command?: string;
+    args: string[];
+    cwd?: string;
+    env: Record<string, string>;
+    envAllowlist: string[];
+    url?: string;
+    headers: Record<string, string>;
+    auth?: McpAuthConfig;
+}
+export interface McpConfigSource {
+    path: string;
+    scope: McpSourceScope;
+    label: string;
+    baseDir: string;
+    precedence: number;
+    shared: boolean;
+}
+export interface McpConfigDiagnostic {
+    severity: "info" | "warning" | "error";
+    message: string;
+    path?: string;
+    serverId?: string;
+}
+export interface McpResolvedServerConfig extends McpServerConfig {
+    id: string;
+    displayName: string;
+    source: McpConfigSource;
+    definedIn: McpConfigSource[];
+}
+export interface McpResolvedConfig {
+    settings: McpSettings;
+    servers: Record<string, McpResolvedServerConfig>;
+    diagnostics: McpConfigDiagnostic[];
+    sources: McpConfigSource[];
+}
+export interface McpToolMetadata {
+    server: string;
+    tool: SdkTool;
+    risk: McpRisk;
+    metadataHash: string;
+    lastSeenAt: string;
+}
+export interface McpDirectToolCandidate extends McpToolMetadata {
+    directToolName: string;
+}
+export interface McpServerMetadata {
+    server: string;
+    serverVersion?: string;
+    metadataHash: string;
+    configHash?: string;
+    tools: SdkTool[];
+    resources: Resource[];
+    prompts: Prompt[];
+    lastSeenAt: string;
+}
+export interface McpMetadataRefreshResult {
+    metadata: McpServerMetadata;
+    toolsResult: ListToolsResult;
+    resourcesResult?: ListResourcesResult;
+    promptsResult?: ListPromptsResult;
+}
+export interface McpRecentCallSummary {
+    id: string;
+    timestamp: string;
+    server: string;
+    tool: string;
+    risk: McpRisk;
+    status: McpRecentCallStatus;
+    durationMs?: number;
+    outputBytes?: number;
+    truncated?: boolean;
+}
+export interface McpToolSummary {
+    server: string;
+    name: string;
+    title?: string;
+    description?: string;
+    risk: McpRisk;
+    inputSchema?: unknown;
+    outputSchema?: unknown;
+    annotations?: Record<string, unknown>;
+    metadataHash: string;
+    lastSeenAt: string;
+    stale: boolean;
+    direct: boolean;
+}
+export interface McpResourceSummary {
+    server: string;
+    uri: string;
+    name?: string;
+    description?: string;
+    mimeType?: string;
+    size?: number;
+}
+export interface McpPromptSummary {
+    server: string;
+    name: string;
+    title?: string;
+    description?: string;
+    arguments?: Prompt["arguments"];
+}
+export interface McpServerSummary {
+    id: string;
+    displayName: string;
+    sourceScope: McpSourceScope;
+    sourceLabel: string;
+    enabled: boolean;
+    activeInSession: boolean;
+    transport: "stdio" | "streamable_http" | "sse";
+    lifecycle: "lazy" | "eager" | "keep_alive";
+    status: McpServerStatus;
+    authState: McpAuthState;
+    toolCounts: {
+        cached: number;
+        live?: number;
+        enabled?: number;
+    };
+    resourceCount?: number;
+    promptCount?: number;
+    recentCalls: McpRecentCallSummary[];
+    lastError?: string;
+    lastConnectedAt?: string;
+    capabilities: {
+        canEnable: boolean;
+        canConnect: boolean;
+        canDisconnect: boolean;
+        canRefresh: boolean;
+        canAuthenticate: boolean;
+        canPersistChanges: boolean;
+    };
+}
+export interface McpCallProgress {
+    progress: number;
+    total?: number;
+    message?: string;
+}
+export interface McpAuthRequestDetails {
+    flow: "browser" | "device";
+    authorizationUrl?: string;
+    redirectUrl?: string;
+    verificationUri?: string;
+    verificationUriComplete?: string;
+    userCode?: string;
+    expiresAt?: string;
+    intervalMs?: number;
+    message?: string;
+}
+/**
+ * Lifecycle events emitted by the MCP manager. These flow through
+ * AgentSession's event stream so TUI, RPC, daemon, and mobile clients
+ * observe MCP state changes without polling.
+ */
+export type McpManagerEvent = {
+    type: "mcp_servers_changed";
+    servers: McpServerSummary[];
+} | {
+    type: "mcp_server_status_changed";
+    server: McpServerSummary;
+} | {
+    type: "mcp_auth_request";
+    serverId: string;
+    auth: McpAuthRequestDetails;
+} | {
+    type: "mcp_auth_update";
+    serverId: string;
+    status: string;
+    authState: McpAuthState;
+    message?: string;
+    server?: McpServerSummary;
+} | {
+    type: "mcp_call_start";
+    call: McpRecentCallSummary;
+} | {
+    type: "mcp_call_update";
+    call: Pick<McpRecentCallSummary, "id" | "server" | "tool">;
+    progress: McpCallProgress;
+} | {
+    type: "mcp_call_end";
+    call: McpRecentCallSummary;
+    cacheId?: string;
+};
+export type McpManagerEventListener = (event: McpManagerEvent) => void;
+export interface McpGatewayInput {
+    action: "status" | "list_servers" | "search" | "describe" | "call" | "connect" | "disconnect" | "set_enabled" | "auth" | "poll_auth" | "cancel_auth" | "logout" | "list_tools" | "list_resources" | "read_resource" | "list_prompts" | "get_prompt" | "read_cache";
+    server?: string;
+    query?: string;
+    tool?: string;
+    enabled?: boolean;
+    flow?: "browser" | "device";
+    redirectUrl?: string;
+    code?: string;
+    state?: string;
+    arguments?: Record<string, unknown>;
+    argumentsJson?: string;
+    resourceUri?: string;
+    prompt?: string;
+    cacheId?: string;
+    limit?: number;
+    cursor?: string;
+}
+export interface McpSearchMatch {
+    server: string;
+    tool: string;
+    title: string;
+    summary: string;
+    risk: McpRisk;
+    metadataHash: string;
+    call: string;
+    describe: string;
+    score: number;
+}
+export interface McpOutputTruncation {
+    truncated: boolean;
+    returnedBytes: number;
+    totalBytes: number;
+    returnedLines: number;
+    totalLines: number;
+}
+export interface McpCacheReference {
+    id: string;
+    read: string;
+}
+export interface McpGatewayCallResult {
+    action: "call";
+    server: string;
+    tool: string;
+    status: "completed" | "failed";
+    risk: McpRisk;
+    content: string;
+    isError?: boolean;
+    truncation?: McpOutputTruncation;
+    cache?: McpCacheReference;
+}
+export interface McpClientConnection {
+    listTools(params: {
+        cursor?: string;
+    } | undefined, options: McpRequestOptions): Promise<ListToolsResult>;
+    listResources(params: {
+        cursor?: string;
+    } | undefined, options: McpRequestOptions): Promise<ListResourcesResult>;
+    readResource(params: {
+        uri: string;
+    }, options: McpRequestOptions): Promise<ReadResourceResult>;
+    listPrompts(params: {
+        cursor?: string;
+    } | undefined, options: McpRequestOptions): Promise<ListPromptsResult>;
+    getPrompt(params: {
+        name: string;
+        arguments?: Record<string, unknown>;
+    }, options: McpRequestOptions): Promise<GetPromptResult>;
+    callTool(params: {
+        name: string;
+        arguments?: Record<string, unknown>;
+    }, options: McpRequestOptions): Promise<CallToolResult>;
+    getServerVersion(): {
+        name: string;
+        version: string;
+    } | undefined;
+    close(): Promise<void>;
+}
+export interface McpRequestOptions {
+    signal?: AbortSignal;
+    timeout?: number;
+    resetTimeoutOnProgress?: boolean;
+    onProgress?: (progress: McpCallProgress) => void;
+}
+export interface McpClientFactory {
+    connect(server: McpResolvedServerConfig, options: McpRequestOptions): Promise<McpClientConnection>;
+}
+export interface McpGatewayExecutionContext {
+    mode: "tui" | "rpc" | "json" | "print" | "unknown";
+    caller?: "model" | "user";
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/mcp/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/mcp/types.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n\tCallToolResult,\n\tGetPromptResult,\n\tListPromptsResult,\n\tListResourcesResult,\n\tListToolsResult,\n\tPrompt,\n\tReadResourceResult,\n\tResource,\n\tTool as SdkTool,\n} from \"@modelcontextprotocol/sdk/types.js\";\n\nexport type McpTransportKind = \"stdio\" | \"streamable-http\" | \"sse\";\nexport type McpLifecycle = \"lazy\" | \"eager\" | \"keep-alive\";\nexport type McpRisk = \"read\" | \"write\" | \"destructive\" | \"unknown\";\nexport type McpSourceScope = \"user\" | \"project\" | \"temporary\";\nexport type McpServerStatus =\n\t| \"disabled\"\n\t| \"untrusted\"\n\t| \"cold\"\n\t| \"discovering\"\n\t| \"connecting\"\n\t| \"connected\"\n\t| \"ready\"\n\t| \"needs_auth\"\n\t| \"authenticating\"\n\t| \"error\"\n\t| \"disconnecting\"\n\t| \"disconnected\";\nexport type McpAuthState = \"none\" | \"required\" | \"pending\" | \"authenticated\" | \"failed\";\nexport type McpRecentCallStatus = \"started\" | \"completed\" | \"failed\" | \"cancelled\";\nexport type McpCallerSurface = \"model\" | \"tui\" | \"rpc\" | \"mobile\" | \"print\" | \"json\" | \"unknown\";\n\nexport interface McpSettings {\n\tenabled: boolean;\n\tmode: \"proxy\";\n\tidleTimeoutMs: number;\n\tconnectTimeoutMs: number;\n\tmetadataTimeoutMs: number;\n\tcallTimeoutMs: number;\n\tmaxOutputBytes: number;\n\tmaxOutputLines: number;\n\tdirectTools: boolean;\n\tresources: \"explicit\" | \"disabled\";\n\tprompts: \"user-preview\" | \"model\" | \"disabled\";\n\tmetadataRefreshMs: number;\n}\n\nexport interface McpAuthConfig {\n\ttype?: \"none\" | \"bearer\" | \"oauth\" | \"env\";\n\ttoken?: string;\n\tenv?: string;\n\tflow?: \"browser\" | \"device\" | \"auto\";\n\tscope?: string;\n\tclientId?: string;\n\tclientSecret?: string;\n\tclientMetadataUrl?: string;\n\tresourceMetadataUrl?: string;\n\ttokenEndpointAuthMethod?: \"client_secret_basic\" | \"client_secret_post\" | \"none\";\n}\n\nexport interface McpServerConfig {\n\tenabled: boolean;\n\tdisplayName?: string;\n\ttransport: McpTransportKind;\n\tlifecycle: McpLifecycle;\n\tincludeTools: string[];\n\texcludeTools: string[];\n\tdirectTools: boolean | string[];\n\tconnectTimeoutMs?: number;\n\tcallTimeoutMs?: number;\n\tidleTimeoutMs?: number;\n\tmetadataRefreshMs?: number;\n\tcommand?: string;\n\targs: string[];\n\tcwd?: string;\n\tenv: Record<string, string>;\n\tenvAllowlist: string[];\n\turl?: string;\n\theaders: Record<string, string>;\n\tauth?: McpAuthConfig;\n}\n\nexport interface McpConfigSource {\n\tpath: string;\n\tscope: McpSourceScope;\n\tlabel: string;\n\tbaseDir: string;\n\tprecedence: number;\n\tshared: boolean;\n}\n\nexport interface McpConfigDiagnostic {\n\tseverity: \"info\" | \"warning\" | \"error\";\n\tmessage: string;\n\tpath?: string;\n\tserverId?: string;\n}\n\nexport interface McpResolvedServerConfig extends McpServerConfig {\n\tid: string;\n\tdisplayName: string;\n\tsource: McpConfigSource;\n\tdefinedIn: McpConfigSource[];\n}\n\nexport interface McpResolvedConfig {\n\tsettings: McpSettings;\n\tservers: Record<string, McpResolvedServerConfig>;\n\tdiagnostics: McpConfigDiagnostic[];\n\tsources: McpConfigSource[];\n}\n\nexport interface McpToolMetadata {\n\tserver: string;\n\ttool: SdkTool;\n\trisk: McpRisk;\n\tmetadataHash: string;\n\tlastSeenAt: string;\n}\n\nexport interface McpDirectToolCandidate extends McpToolMetadata {\n\tdirectToolName: string;\n}\n\nexport interface McpServerMetadata {\n\tserver: string;\n\tserverVersion?: string;\n\tmetadataHash: string;\n\tconfigHash?: string;\n\ttools: SdkTool[];\n\tresources: Resource[];\n\tprompts: Prompt[];\n\tlastSeenAt: string;\n}\n\nexport interface McpMetadataRefreshResult {\n\tmetadata: McpServerMetadata;\n\ttoolsResult: ListToolsResult;\n\tresourcesResult?: ListResourcesResult;\n\tpromptsResult?: ListPromptsResult;\n}\n\nexport interface McpRecentCallSummary {\n\tid: string;\n\ttimestamp: string;\n\tserver: string;\n\ttool: string;\n\trisk: McpRisk;\n\tstatus: McpRecentCallStatus;\n\tdurationMs?: number;\n\toutputBytes?: number;\n\ttruncated?: boolean;\n}\n\nexport interface McpToolSummary {\n\tserver: string;\n\tname: string;\n\ttitle?: string;\n\tdescription?: string;\n\trisk: McpRisk;\n\tinputSchema?: unknown;\n\toutputSchema?: unknown;\n\tannotations?: Record<string, unknown>;\n\tmetadataHash: string;\n\tlastSeenAt: string;\n\tstale: boolean;\n\tdirect: boolean;\n}\n\nexport interface McpResourceSummary {\n\tserver: string;\n\turi: string;\n\tname?: string;\n\tdescription?: string;\n\tmimeType?: string;\n\tsize?: number;\n}\n\nexport interface McpPromptSummary {\n\tserver: string;\n\tname: string;\n\ttitle?: string;\n\tdescription?: string;\n\targuments?: Prompt[\"arguments\"];\n}\n\nexport interface McpServerSummary {\n\tid: string;\n\tdisplayName: string;\n\tsourceScope: McpSourceScope;\n\tsourceLabel: string;\n\tenabled: boolean;\n\tactiveInSession: boolean;\n\ttransport: \"stdio\" | \"streamable_http\" | \"sse\";\n\tlifecycle: \"lazy\" | \"eager\" | \"keep_alive\";\n\tstatus: McpServerStatus;\n\tauthState: McpAuthState;\n\ttoolCounts: { cached: number; live?: number; enabled?: number };\n\tresourceCount?: number;\n\tpromptCount?: number;\n\trecentCalls: McpRecentCallSummary[];\n\tlastError?: string;\n\tlastConnectedAt?: string;\n\tcapabilities: {\n\t\tcanEnable: boolean;\n\t\tcanConnect: boolean;\n\t\tcanDisconnect: boolean;\n\t\tcanRefresh: boolean;\n\t\tcanAuthenticate: boolean;\n\t\tcanPersistChanges: boolean;\n\t};\n}\n\nexport interface McpCallProgress {\n\tprogress: number;\n\ttotal?: number;\n\tmessage?: string;\n}\n\nexport interface McpAuthRequestDetails {\n\tflow: \"browser\" | \"device\";\n\tauthorizationUrl?: string;\n\tredirectUrl?: string;\n\tverificationUri?: string;\n\tverificationUriComplete?: string;\n\tuserCode?: string;\n\texpiresAt?: string;\n\tintervalMs?: number;\n\tmessage?: string;\n}\n\n/**\n * Lifecycle events emitted by the MCP manager. These flow through\n * AgentSession's event stream so TUI, RPC, daemon, and mobile clients\n * observe MCP state changes without polling.\n */\nexport type McpManagerEvent =\n\t| { type: \"mcp_servers_changed\"; servers: McpServerSummary[] }\n\t| { type: \"mcp_server_status_changed\"; server: McpServerSummary }\n\t| { type: \"mcp_auth_request\"; serverId: string; auth: McpAuthRequestDetails }\n\t| {\n\t\t\ttype: \"mcp_auth_update\";\n\t\t\tserverId: string;\n\t\t\tstatus: string;\n\t\t\tauthState: McpAuthState;\n\t\t\tmessage?: string;\n\t\t\tserver?: McpServerSummary;\n\t  }\n\t| { type: \"mcp_call_start\"; call: McpRecentCallSummary }\n\t| {\n\t\t\ttype: \"mcp_call_update\";\n\t\t\tcall: Pick<McpRecentCallSummary, \"id\" | \"server\" | \"tool\">;\n\t\t\tprogress: McpCallProgress;\n\t  }\n\t| { type: \"mcp_call_end\"; call: McpRecentCallSummary; cacheId?: string };\n\nexport type McpManagerEventListener = (event: McpManagerEvent) => void;\n\nexport interface McpGatewayInput {\n\taction:\n\t\t| \"status\"\n\t\t| \"list_servers\"\n\t\t| \"search\"\n\t\t| \"describe\"\n\t\t| \"call\"\n\t\t| \"connect\"\n\t\t| \"disconnect\"\n\t\t| \"set_enabled\"\n\t\t| \"auth\"\n\t\t| \"poll_auth\"\n\t\t| \"cancel_auth\"\n\t\t| \"logout\"\n\t\t| \"list_tools\"\n\t\t| \"list_resources\"\n\t\t| \"read_resource\"\n\t\t| \"list_prompts\"\n\t\t| \"get_prompt\"\n\t\t| \"read_cache\";\n\tserver?: string;\n\tquery?: string;\n\ttool?: string;\n\tenabled?: boolean;\n\tflow?: \"browser\" | \"device\";\n\tredirectUrl?: string;\n\tcode?: string;\n\tstate?: string;\n\targuments?: Record<string, unknown>;\n\targumentsJson?: string;\n\tresourceUri?: string;\n\tprompt?: string;\n\tcacheId?: string;\n\tlimit?: number;\n\tcursor?: string;\n}\n\nexport interface McpSearchMatch {\n\tserver: string;\n\ttool: string;\n\ttitle: string;\n\tsummary: string;\n\trisk: McpRisk;\n\tmetadataHash: string;\n\tcall: string;\n\tdescribe: string;\n\tscore: number;\n}\n\nexport interface McpOutputTruncation {\n\ttruncated: boolean;\n\treturnedBytes: number;\n\ttotalBytes: number;\n\treturnedLines: number;\n\ttotalLines: number;\n}\n\nexport interface McpCacheReference {\n\tid: string;\n\tread: string;\n}\n\nexport interface McpGatewayCallResult {\n\taction: \"call\";\n\tserver: string;\n\ttool: string;\n\tstatus: \"completed\" | \"failed\";\n\trisk: McpRisk;\n\tcontent: string;\n\tisError?: boolean;\n\ttruncation?: McpOutputTruncation;\n\tcache?: McpCacheReference;\n}\n\nexport interface McpClientConnection {\n\tlistTools(params: { cursor?: string } | undefined, options: McpRequestOptions): Promise<ListToolsResult>;\n\tlistResources(params: { cursor?: string } | undefined, options: McpRequestOptions): Promise<ListResourcesResult>;\n\treadResource(params: { uri: string }, options: McpRequestOptions): Promise<ReadResourceResult>;\n\tlistPrompts(params: { cursor?: string } | undefined, options: McpRequestOptions): Promise<ListPromptsResult>;\n\tgetPrompt(\n\t\tparams: { name: string; arguments?: Record<string, unknown> },\n\t\toptions: McpRequestOptions,\n\t): Promise<GetPromptResult>;\n\tcallTool(\n\t\tparams: { name: string; arguments?: Record<string, unknown> },\n\t\toptions: McpRequestOptions,\n\t): Promise<CallToolResult>;\n\tgetServerVersion(): { name: string; version: string } | undefined;\n\tclose(): Promise<void>;\n}\n\nexport interface McpRequestOptions {\n\tsignal?: AbortSignal;\n\ttimeout?: number;\n\tresetTimeoutOnProgress?: boolean;\n\tonProgress?: (progress: McpCallProgress) => void;\n}\n\nexport interface McpClientFactory {\n\tconnect(server: McpResolvedServerConfig, options: McpRequestOptions): Promise<McpClientConnection>;\n}\n\nexport interface McpGatewayExecutionContext {\n\tmode: \"tui\" | \"rpc\" | \"json\" | \"print\" | \"unknown\";\n\tcaller?: \"model\" | \"user\";\n}\n"]}

package/dist/core/mcp/types.js

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

package/dist/core/mcp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/mcp/types.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n\tCallToolResult,\n\tGetPromptResult,\n\tListPromptsResult,\n\tListResourcesResult,\n\tListToolsResult,\n\tPrompt,\n\tReadResourceResult,\n\tResource,\n\tTool as SdkTool,\n} from \"@modelcontextprotocol/sdk/types.js\";\n\nexport type McpTransportKind = \"stdio\" | \"streamable-http\" | \"sse\";\nexport type McpLifecycle = \"lazy\" | \"eager\" | \"keep-alive\";\nexport type McpRisk = \"read\" | \"write\" | \"destructive\" | \"unknown\";\nexport type McpSourceScope = \"user\" | \"project\" | \"temporary\";\nexport type McpServerStatus =\n\t| \"disabled\"\n\t| \"untrusted\"\n\t| \"cold\"\n\t| \"discovering\"\n\t| \"connecting\"\n\t| \"connected\"\n\t| \"ready\"\n\t| \"needs_auth\"\n\t| \"authenticating\"\n\t| \"error\"\n\t| \"disconnecting\"\n\t| \"disconnected\";\nexport type McpAuthState = \"none\" | \"required\" | \"pending\" | \"authenticated\" | \"failed\";\nexport type McpRecentCallStatus = \"started\" | \"completed\" | \"failed\" | \"cancelled\";\nexport type McpCallerSurface = \"model\" | \"tui\" | \"rpc\" | \"mobile\" | \"print\" | \"json\" | \"unknown\";\n\nexport interface McpSettings {\n\tenabled: boolean;\n\tmode: \"proxy\";\n\tidleTimeoutMs: number;\n\tconnectTimeoutMs: number;\n\tmetadataTimeoutMs: number;\n\tcallTimeoutMs: number;\n\tmaxOutputBytes: number;\n\tmaxOutputLines: number;\n\tdirectTools: boolean;\n\tresources: \"explicit\" | \"disabled\";\n\tprompts: \"user-preview\" | \"model\" | \"disabled\";\n\tmetadataRefreshMs: number;\n}\n\nexport interface McpAuthConfig {\n\ttype?: \"none\" | \"bearer\" | \"oauth\" | \"env\";\n\ttoken?: string;\n\tenv?: string;\n\tflow?: \"browser\" | \"device\" | \"auto\";\n\tscope?: string;\n\tclientId?: string;\n\tclientSecret?: string;\n\tclientMetadataUrl?: string;\n\tresourceMetadataUrl?: string;\n\ttokenEndpointAuthMethod?: \"client_secret_basic\" | \"client_secret_post\" | \"none\";\n}\n\nexport interface McpServerConfig {\n\tenabled: boolean;\n\tdisplayName?: string;\n\ttransport: McpTransportKind;\n\tlifecycle: McpLifecycle;\n\tincludeTools: string[];\n\texcludeTools: string[];\n\tdirectTools: boolean | string[];\n\tconnectTimeoutMs?: number;\n\tcallTimeoutMs?: number;\n\tidleTimeoutMs?: number;\n\tmetadataRefreshMs?: number;\n\tcommand?: string;\n\targs: string[];\n\tcwd?: string;\n\tenv: Record<string, string>;\n\tenvAllowlist: string[];\n\turl?: string;\n\theaders: Record<string, string>;\n\tauth?: McpAuthConfig;\n}\n\nexport interface McpConfigSource {\n\tpath: string;\n\tscope: McpSourceScope;\n\tlabel: string;\n\tbaseDir: string;\n\tprecedence: number;\n\tshared: boolean;\n}\n\nexport interface McpConfigDiagnostic {\n\tseverity: \"info\" | \"warning\" | \"error\";\n\tmessage: string;\n\tpath?: string;\n\tserverId?: string;\n}\n\nexport interface McpResolvedServerConfig extends McpServerConfig {\n\tid: string;\n\tdisplayName: string;\n\tsource: McpConfigSource;\n\tdefinedIn: McpConfigSource[];\n}\n\nexport interface McpResolvedConfig {\n\tsettings: McpSettings;\n\tservers: Record<string, McpResolvedServerConfig>;\n\tdiagnostics: McpConfigDiagnostic[];\n\tsources: McpConfigSource[];\n}\n\nexport interface McpToolMetadata {\n\tserver: string;\n\ttool: SdkTool;\n\trisk: McpRisk;\n\tmetadataHash: string;\n\tlastSeenAt: string;\n}\n\nexport interface McpDirectToolCandidate extends McpToolMetadata {\n\tdirectToolName: string;\n}\n\nexport interface McpServerMetadata {\n\tserver: string;\n\tserverVersion?: string;\n\tmetadataHash: string;\n\tconfigHash?: string;\n\ttools: SdkTool[];\n\tresources: Resource[];\n\tprompts: Prompt[];\n\tlastSeenAt: string;\n}\n\nexport interface McpMetadataRefreshResult {\n\tmetadata: McpServerMetadata;\n\ttoolsResult: ListToolsResult;\n\tresourcesResult?: ListResourcesResult;\n\tpromptsResult?: ListPromptsResult;\n}\n\nexport interface McpRecentCallSummary {\n\tid: string;\n\ttimestamp: string;\n\tserver: string;\n\ttool: string;\n\trisk: McpRisk;\n\tstatus: McpRecentCallStatus;\n\tdurationMs?: number;\n\toutputBytes?: number;\n\ttruncated?: boolean;\n}\n\nexport interface McpToolSummary {\n\tserver: string;\n\tname: string;\n\ttitle?: string;\n\tdescription?: string;\n\trisk: McpRisk;\n\tinputSchema?: unknown;\n\toutputSchema?: unknown;\n\tannotations?: Record<string, unknown>;\n\tmetadataHash: string;\n\tlastSeenAt: string;\n\tstale: boolean;\n\tdirect: boolean;\n}\n\nexport interface McpResourceSummary {\n\tserver: string;\n\turi: string;\n\tname?: string;\n\tdescription?: string;\n\tmimeType?: string;\n\tsize?: number;\n}\n\nexport interface McpPromptSummary {\n\tserver: string;\n\tname: string;\n\ttitle?: string;\n\tdescription?: string;\n\targuments?: Prompt[\"arguments\"];\n}\n\nexport interface McpServerSummary {\n\tid: string;\n\tdisplayName: string;\n\tsourceScope: McpSourceScope;\n\tsourceLabel: string;\n\tenabled: boolean;\n\tactiveInSession: boolean;\n\ttransport: \"stdio\" | \"streamable_http\" | \"sse\";\n\tlifecycle: \"lazy\" | \"eager\" | \"keep_alive\";\n\tstatus: McpServerStatus;\n\tauthState: McpAuthState;\n\ttoolCounts: { cached: number; live?: number; enabled?: number };\n\tresourceCount?: number;\n\tpromptCount?: number;\n\trecentCalls: McpRecentCallSummary[];\n\tlastError?: string;\n\tlastConnectedAt?: string;\n\tcapabilities: {\n\t\tcanEnable: boolean;\n\t\tcanConnect: boolean;\n\t\tcanDisconnect: boolean;\n\t\tcanRefresh: boolean;\n\t\tcanAuthenticate: boolean;\n\t\tcanPersistChanges: boolean;\n\t};\n}\n\nexport interface McpCallProgress {\n\tprogress: number;\n\ttotal?: number;\n\tmessage?: string;\n}\n\nexport interface McpAuthRequestDetails {\n\tflow: \"browser\" | \"device\";\n\tauthorizationUrl?: string;\n\tredirectUrl?: string;\n\tverificationUri?: string;\n\tverificationUriComplete?: string;\n\tuserCode?: string;\n\texpiresAt?: string;\n\tintervalMs?: number;\n\tmessage?: string;\n}\n\n/**\n * Lifecycle events emitted by the MCP manager. These flow through\n * AgentSession's event stream so TUI, RPC, daemon, and mobile clients\n * observe MCP state changes without polling.\n */\nexport type McpManagerEvent =\n\t| { type: \"mcp_servers_changed\"; servers: McpServerSummary[] }\n\t| { type: \"mcp_server_status_changed\"; server: McpServerSummary }\n\t| { type: \"mcp_auth_request\"; serverId: string; auth: McpAuthRequestDetails }\n\t| {\n\t\t\ttype: \"mcp_auth_update\";\n\t\t\tserverId: string;\n\t\t\tstatus: string;\n\t\t\tauthState: McpAuthState;\n\t\t\tmessage?: string;\n\t\t\tserver?: McpServerSummary;\n\t  }\n\t| { type: \"mcp_call_start\"; call: McpRecentCallSummary }\n\t| {\n\t\t\ttype: \"mcp_call_update\";\n\t\t\tcall: Pick<McpRecentCallSummary, \"id\" | \"server\" | \"tool\">;\n\t\t\tprogress: McpCallProgress;\n\t  }\n\t| { type: \"mcp_call_end\"; call: McpRecentCallSummary; cacheId?: string };\n\nexport type McpManagerEventListener = (event: McpManagerEvent) => void;\n\nexport interface McpGatewayInput {\n\taction:\n\t\t| \"status\"\n\t\t| \"list_servers\"\n\t\t| \"search\"\n\t\t| \"describe\"\n\t\t| \"call\"\n\t\t| \"connect\"\n\t\t| \"disconnect\"\n\t\t| \"set_enabled\"\n\t\t| \"auth\"\n\t\t| \"poll_auth\"\n\t\t| \"cancel_auth\"\n\t\t| \"logout\"\n\t\t| \"list_tools\"\n\t\t| \"list_resources\"\n\t\t| \"read_resource\"\n\t\t| \"list_prompts\"\n\t\t| \"get_prompt\"\n\t\t| \"read_cache\";\n\tserver?: string;\n\tquery?: string;\n\ttool?: string;\n\tenabled?: boolean;\n\tflow?: \"browser\" | \"device\";\n\tredirectUrl?: string;\n\tcode?: string;\n\tstate?: string;\n\targuments?: Record<string, unknown>;\n\targumentsJson?: string;\n\tresourceUri?: string;\n\tprompt?: string;\n\tcacheId?: string;\n\tlimit?: number;\n\tcursor?: string;\n}\n\nexport interface McpSearchMatch {\n\tserver: string;\n\ttool: string;\n\ttitle: string;\n\tsummary: string;\n\trisk: McpRisk;\n\tmetadataHash: string;\n\tcall: string;\n\tdescribe: string;\n\tscore: number;\n}\n\nexport interface McpOutputTruncation {\n\ttruncated: boolean;\n\treturnedBytes: number;\n\ttotalBytes: number;\n\treturnedLines: number;\n\ttotalLines: number;\n}\n\nexport interface McpCacheReference {\n\tid: string;\n\tread: string;\n}\n\nexport interface McpGatewayCallResult {\n\taction: \"call\";\n\tserver: string;\n\ttool: string;\n\tstatus: \"completed\" | \"failed\";\n\trisk: McpRisk;\n\tcontent: string;\n\tisError?: boolean;\n\ttruncation?: McpOutputTruncation;\n\tcache?: McpCacheReference;\n}\n\nexport interface McpClientConnection {\n\tlistTools(params: { cursor?: string } | undefined, options: McpRequestOptions): Promise<ListToolsResult>;\n\tlistResources(params: { cursor?: string } | undefined, options: McpRequestOptions): Promise<ListResourcesResult>;\n\treadResource(params: { uri: string }, options: McpRequestOptions): Promise<ReadResourceResult>;\n\tlistPrompts(params: { cursor?: string } | undefined, options: McpRequestOptions): Promise<ListPromptsResult>;\n\tgetPrompt(\n\t\tparams: { name: string; arguments?: Record<string, unknown> },\n\t\toptions: McpRequestOptions,\n\t): Promise<GetPromptResult>;\n\tcallTool(\n\t\tparams: { name: string; arguments?: Record<string, unknown> },\n\t\toptions: McpRequestOptions,\n\t): Promise<CallToolResult>;\n\tgetServerVersion(): { name: string; version: string } | undefined;\n\tclose(): Promise<void>;\n}\n\nexport interface McpRequestOptions {\n\tsignal?: AbortSignal;\n\ttimeout?: number;\n\tresetTimeoutOnProgress?: boolean;\n\tonProgress?: (progress: McpCallProgress) => void;\n}\n\nexport interface McpClientFactory {\n\tconnect(server: McpResolvedServerConfig, options: McpRequestOptions): Promise<McpClientConnection>;\n}\n\nexport interface McpGatewayExecutionContext {\n\tmode: \"tui\" | \"rpc\" | \"json\" | \"print\" | \"unknown\";\n\tcaller?: \"model\" | \"user\";\n}\n"]}

package/dist/core/messages.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Custom message types and transformers for the coding agent.
+ *
+ * Extends the base AgentMessage type with coding-agent specific message types,
+ * and provides a transformer to convert them to LLM-compatible messages.
+ */
+import type { AgentMessage } from "@hansjm10/volt-agent-core";
+import type { ImageContent, Message, TextContent } from "@hansjm10/volt-ai";
+export declare const COMPACTION_SUMMARY_PREFIX = "The conversation history before this point was compacted into the following summary:\n\n<summary>\n";
+export declare const COMPACTION_SUMMARY_SUFFIX = "\n</summary>";
+export declare const BRANCH_SUMMARY_PREFIX = "The following is a summary of a branch that this conversation came back from:\n\n<summary>\n";
+export declare const BRANCH_SUMMARY_SUFFIX = "</summary>";
+/**
+ * Message type for bash executions via the ! command.
+ */
+export interface BashExecutionMessage {
+    role: "bashExecution";
+    command: string;
+    output: string;
+    exitCode: number | undefined;
+    cancelled: boolean;
+    truncated: boolean;
+    fullOutputPath?: string;
+    timestamp: number;
+    /** If true, this message is excluded from LLM context (!! prefix) */
+    excludeFromContext?: boolean;
+}
+/**
+ * Message type for extension-injected messages via sendMessage().
+ * These are custom messages that extensions can inject into the conversation.
+ */
+export interface CustomMessage<T = unknown> {
+    role: "custom";
+    customType: string;
+    content: string | (TextContent | ImageContent)[];
+    display: boolean;
+    details?: T;
+    timestamp: number;
+}
+export interface BranchSummaryMessage {
+    role: "branchSummary";
+    summary: string;
+    fromId: string;
+    timestamp: number;
+}
+export interface CompactionSummaryMessage {
+    role: "compactionSummary";
+    summary: string;
+    tokensBefore: number;
+    timestamp: number;
+}
+declare module "@hansjm10/volt-agent-core" {
+    interface CustomAgentMessages {
+        bashExecution: BashExecutionMessage;
+        custom: CustomMessage;
+        branchSummary: BranchSummaryMessage;
+        compactionSummary: CompactionSummaryMessage;
+    }
+}
+/**
+ * Convert a BashExecutionMessage to user message text for LLM context.
+ */
+export declare function bashExecutionToText(msg: BashExecutionMessage): string;
+export declare function createBranchSummaryMessage(summary: string, fromId: string, timestamp: string): BranchSummaryMessage;
+export declare function createCompactionSummaryMessage(summary: string, tokensBefore: number, timestamp: string): CompactionSummaryMessage;
+/** Convert CustomMessageEntry to AgentMessage format */
+export declare function createCustomMessage(customType: string, content: string | (TextContent | ImageContent)[], display: boolean, details: unknown | undefined, timestamp: string): CustomMessage;
+export declare function extractVisibleTextContent(content: unknown, textPartSeparator?: string): string;
+/**
+ * Transform AgentMessages (including custom types) to LLM-compatible Messages.
+ *
+ * This is used by:
+ * - Agent's transormToLlm option (for prompt calls and queued messages)
+ * - Compaction's generateSummary (for summarization)
+ * - Custom extensions and tools
+ */
+export declare function convertToLlm(messages: AgentMessage[]): Message[];
+//# sourceMappingURL=messages.d.ts.map

package/dist/core/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/core/messages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAE5E,eAAO,MAAM,yBAAyB,wGAGrC,CAAC;AAEF,eAAO,MAAM,yBAAyB,iBAC3B,CAAC;AAEZ,eAAO,MAAM,qBAAqB,iGAGjC,CAAC;AAEF,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACzC,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,CAAC,WAAW,GAAG,YAAY,CAAC,EAAE,CAAC;IACjD,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACxC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CAClB;AAGD,OAAO,QAAQ,2BAA2B,CAAC,CAAC;IAC3C,UAAU,mBAAmB;QAC5B,aAAa,EAAE,oBAAoB,CAAC;QACpC,MAAM,EAAE,aAAa,CAAC;QACtB,aAAa,EAAE,oBAAoB,CAAC;QACpC,iBAAiB,EAAE,wBAAwB,CAAC;KAC5C;CACD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,oBAAoB,GAAG,MAAM,CAgBrE;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,oBAAoB,CAOnH;AAED,wBAAgB,8BAA8B,CAC7C,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GACf,wBAAwB,CAO1B;AAED,wDAAwD;AACxD,wBAAgB,mBAAmB,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GAAG,CAAC,WAAW,GAAG,YAAY,CAAC,EAAE,EAChD,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5B,SAAS,EAAE,MAAM,GACf,aAAa,CASf;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,EAAE,iBAAiB,SAAO,GAAG,MAAM,CAiB5F;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,OAAO,EAAE,CA+ChE","sourcesContent":["/**\n * Custom message types and transformers for the coding agent.\n *\n * Extends the base AgentMessage type with coding-agent specific message types,\n * and provides a transformer to convert them to LLM-compatible messages.\n */\n\nimport type { AgentMessage } from \"@hansjm10/volt-agent-core\";\nimport type { ImageContent, Message, TextContent } from \"@hansjm10/volt-ai\";\n\nexport const COMPACTION_SUMMARY_PREFIX = `The conversation history before this point was compacted into the following summary:\n\n<summary>\n`;\n\nexport const COMPACTION_SUMMARY_SUFFIX = `\n</summary>`;\n\nexport const BRANCH_SUMMARY_PREFIX = `The following is a summary of a branch that this conversation came back from:\n\n<summary>\n`;\n\nexport const BRANCH_SUMMARY_SUFFIX = `</summary>`;\n\n/**\n * Message type for bash executions via the ! command.\n */\nexport interface BashExecutionMessage {\n\trole: \"bashExecution\";\n\tcommand: string;\n\toutput: string;\n\texitCode: number | undefined;\n\tcancelled: boolean;\n\ttruncated: boolean;\n\tfullOutputPath?: string;\n\ttimestamp: number;\n\t/** If true, this message is excluded from LLM context (!! prefix) */\n\texcludeFromContext?: boolean;\n}\n\n/**\n * Message type for extension-injected messages via sendMessage().\n * These are custom messages that extensions can inject into the conversation.\n */\nexport interface CustomMessage<T = unknown> {\n\trole: \"custom\";\n\tcustomType: string;\n\tcontent: string | (TextContent | ImageContent)[];\n\tdisplay: boolean;\n\tdetails?: T;\n\ttimestamp: number;\n}\n\nexport interface BranchSummaryMessage {\n\trole: \"branchSummary\";\n\tsummary: string;\n\tfromId: string;\n\ttimestamp: number;\n}\n\nexport interface CompactionSummaryMessage {\n\trole: \"compactionSummary\";\n\tsummary: string;\n\ttokensBefore: number;\n\ttimestamp: number;\n}\n\n// Extend CustomAgentMessages via declaration merging\ndeclare module \"@hansjm10/volt-agent-core\" {\n\tinterface CustomAgentMessages {\n\t\tbashExecution: BashExecutionMessage;\n\t\tcustom: CustomMessage;\n\t\tbranchSummary: BranchSummaryMessage;\n\t\tcompactionSummary: CompactionSummaryMessage;\n\t}\n}\n\n/**\n * Convert a BashExecutionMessage to user message text for LLM context.\n */\nexport function bashExecutionToText(msg: BashExecutionMessage): string {\n\tlet text = `Ran \\`${msg.command}\\`\\n`;\n\tif (msg.output) {\n\t\ttext += `\\`\\`\\`\\n${msg.output}\\n\\`\\`\\``;\n\t} else {\n\t\ttext += \"(no output)\";\n\t}\n\tif (msg.cancelled) {\n\t\ttext += \"\\n\\n(command cancelled)\";\n\t} else if (msg.exitCode !== null && msg.exitCode !== undefined && msg.exitCode !== 0) {\n\t\ttext += `\\n\\nCommand exited with code ${msg.exitCode}`;\n\t}\n\tif (msg.truncated && msg.fullOutputPath) {\n\t\ttext += `\\n\\n[Output truncated. Full output: ${msg.fullOutputPath}]`;\n\t}\n\treturn text;\n}\n\nexport function createBranchSummaryMessage(summary: string, fromId: string, timestamp: string): BranchSummaryMessage {\n\treturn {\n\t\trole: \"branchSummary\",\n\t\tsummary,\n\t\tfromId,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\nexport function createCompactionSummaryMessage(\n\tsummary: string,\n\ttokensBefore: number,\n\ttimestamp: string,\n): CompactionSummaryMessage {\n\treturn {\n\t\trole: \"compactionSummary\",\n\t\tsummary: summary,\n\t\ttokensBefore,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\n/** Convert CustomMessageEntry to AgentMessage format */\nexport function createCustomMessage(\n\tcustomType: string,\n\tcontent: string | (TextContent | ImageContent)[],\n\tdisplay: boolean,\n\tdetails: unknown | undefined,\n\ttimestamp: string,\n): CustomMessage {\n\treturn {\n\t\trole: \"custom\",\n\t\tcustomType,\n\t\tcontent,\n\t\tdisplay,\n\t\tdetails,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\nexport function extractVisibleTextContent(content: unknown, textPartSeparator = \"\\n\"): string {\n\tif (typeof content === \"string\") {\n\t\treturn content;\n\t}\n\tif (!Array.isArray(content)) {\n\t\treturn \"\";\n\t}\n\treturn content\n\t\t.filter(\n\t\t\t(part): part is TextContent =>\n\t\t\t\ttypeof part === \"object\" &&\n\t\t\t\tpart !== null &&\n\t\t\t\t(part as { type?: unknown }).type === \"text\" &&\n\t\t\t\ttypeof (part as { text?: unknown }).text === \"string\",\n\t\t)\n\t\t.map((part) => part.text)\n\t\t.join(textPartSeparator);\n}\n\n/**\n * Transform AgentMessages (including custom types) to LLM-compatible Messages.\n *\n * This is used by:\n * - Agent's transormToLlm option (for prompt calls and queued messages)\n * - Compaction's generateSummary (for summarization)\n * - Custom extensions and tools\n */\nexport function convertToLlm(messages: AgentMessage[]): Message[] {\n\treturn messages\n\t\t.map((m): Message | undefined => {\n\t\t\tswitch (m.role) {\n\t\t\t\tcase \"bashExecution\":\n\t\t\t\t\t// Skip messages excluded from context (!! prefix)\n\t\t\t\t\tif (m.excludeFromContext) {\n\t\t\t\t\t\treturn undefined;\n\t\t\t\t\t}\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: bashExecutionToText(m) }],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"custom\": {\n\t\t\t\t\tconst content = typeof m.content === \"string\" ? [{ type: \"text\" as const, text: m.content }] : m.content;\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent,\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tcase \"branchSummary\":\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [{ type: \"text\" as const, text: BRANCH_SUMMARY_PREFIX + m.summary + BRANCH_SUMMARY_SUFFIX }],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"compactionSummary\":\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [\n\t\t\t\t\t\t\t{ type: \"text\" as const, text: COMPACTION_SUMMARY_PREFIX + m.summary + COMPACTION_SUMMARY_SUFFIX },\n\t\t\t\t\t\t],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"user\":\n\t\t\t\tcase \"assistant\":\n\t\t\t\tcase \"toolResult\":\n\t\t\t\t\treturn m;\n\t\t\t\tdefault:\n\t\t\t\t\t// biome-ignore lint/correctness/noSwitchDeclarations: fine\n\t\t\t\t\tconst _exhaustiveCheck: never = m;\n\t\t\t\t\treturn undefined;\n\t\t\t}\n\t\t})\n\t\t.filter((m) => m !== undefined);\n}\n"]}

package/dist/core/messages.js

@@ -0,0 +1,138 @@
+/**
+ * Custom message types and transformers for the coding agent.
+ *
+ * Extends the base AgentMessage type with coding-agent specific message types,
+ * and provides a transformer to convert them to LLM-compatible messages.
+ */
+export const COMPACTION_SUMMARY_PREFIX = `The conversation history before this point was compacted into the following summary:
+
+<summary>
+`;
+export const COMPACTION_SUMMARY_SUFFIX = `
+</summary>`;
+export const BRANCH_SUMMARY_PREFIX = `The following is a summary of a branch that this conversation came back from:
+
+<summary>
+`;
+export const BRANCH_SUMMARY_SUFFIX = `</summary>`;
+/**
+ * Convert a BashExecutionMessage to user message text for LLM context.
+ */
+export function bashExecutionToText(msg) {
+    let text = `Ran \`${msg.command}\`\n`;
+    if (msg.output) {
+        text += `\`\`\`\n${msg.output}\n\`\`\``;
+    }
+    else {
+        text += "(no output)";
+    }
+    if (msg.cancelled) {
+        text += "\n\n(command cancelled)";
+    }
+    else if (msg.exitCode !== null && msg.exitCode !== undefined && msg.exitCode !== 0) {
+        text += `\n\nCommand exited with code ${msg.exitCode}`;
+    }
+    if (msg.truncated && msg.fullOutputPath) {
+        text += `\n\n[Output truncated. Full output: ${msg.fullOutputPath}]`;
+    }
+    return text;
+}
+export function createBranchSummaryMessage(summary, fromId, timestamp) {
+    return {
+        role: "branchSummary",
+        summary,
+        fromId,
+        timestamp: new Date(timestamp).getTime(),
+    };
+}
+export function createCompactionSummaryMessage(summary, tokensBefore, timestamp) {
+    return {
+        role: "compactionSummary",
+        summary: summary,
+        tokensBefore,
+        timestamp: new Date(timestamp).getTime(),
+    };
+}
+/** Convert CustomMessageEntry to AgentMessage format */
+export function createCustomMessage(customType, content, display, details, timestamp) {
+    return {
+        role: "custom",
+        customType,
+        content,
+        display,
+        details,
+        timestamp: new Date(timestamp).getTime(),
+    };
+}
+export function extractVisibleTextContent(content, textPartSeparator = "\n") {
+    if (typeof content === "string") {
+        return content;
+    }
+    if (!Array.isArray(content)) {
+        return "";
+    }
+    return content
+        .filter((part) => typeof part === "object" &&
+        part !== null &&
+        part.type === "text" &&
+        typeof part.text === "string")
+        .map((part) => part.text)
+        .join(textPartSeparator);
+}
+/**
+ * Transform AgentMessages (including custom types) to LLM-compatible Messages.
+ *
+ * This is used by:
+ * - Agent's transormToLlm option (for prompt calls and queued messages)
+ * - Compaction's generateSummary (for summarization)
+ * - Custom extensions and tools
+ */
+export function convertToLlm(messages) {
+    return messages
+        .map((m) => {
+        switch (m.role) {
+            case "bashExecution":
+                // Skip messages excluded from context (!! prefix)
+                if (m.excludeFromContext) {
+                    return undefined;
+                }
+                return {
+                    role: "user",
+                    content: [{ type: "text", text: bashExecutionToText(m) }],
+                    timestamp: m.timestamp,
+                };
+            case "custom": {
+                const content = typeof m.content === "string" ? [{ type: "text", text: m.content }] : m.content;
+                return {
+                    role: "user",
+                    content,
+                    timestamp: m.timestamp,
+                };
+            }
+            case "branchSummary":
+                return {
+                    role: "user",
+                    content: [{ type: "text", text: BRANCH_SUMMARY_PREFIX + m.summary + BRANCH_SUMMARY_SUFFIX }],
+                    timestamp: m.timestamp,
+                };
+            case "compactionSummary":
+                return {
+                    role: "user",
+                    content: [
+                        { type: "text", text: COMPACTION_SUMMARY_PREFIX + m.summary + COMPACTION_SUMMARY_SUFFIX },
+                    ],
+                    timestamp: m.timestamp,
+                };
+            case "user":
+            case "assistant":
+            case "toolResult":
+                return m;
+            default:
+                // biome-ignore lint/correctness/noSwitchDeclarations: fine
+                const _exhaustiveCheck = m;
+                return undefined;
+        }
+    })
+        .filter((m) => m !== undefined);
+}
+//# sourceMappingURL=messages.js.map

package/dist/core/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../src/core/messages.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Custom message types and transformers for the coding agent.\n *\n * Extends the base AgentMessage type with coding-agent specific message types,\n * and provides a transformer to convert them to LLM-compatible messages.\n */\n\nimport type { AgentMessage } from \"@hansjm10/volt-agent-core\";\nimport type { ImageContent, Message, TextContent } from \"@hansjm10/volt-ai\";\n\nexport const COMPACTION_SUMMARY_PREFIX = `The conversation history before this point was compacted into the following summary:\n\n<summary>\n`;\n\nexport const COMPACTION_SUMMARY_SUFFIX = `\n</summary>`;\n\nexport const BRANCH_SUMMARY_PREFIX = `The following is a summary of a branch that this conversation came back from:\n\n<summary>\n`;\n\nexport const BRANCH_SUMMARY_SUFFIX = `</summary>`;\n\n/**\n * Message type for bash executions via the ! command.\n */\nexport interface BashExecutionMessage {\n\trole: \"bashExecution\";\n\tcommand: string;\n\toutput: string;\n\texitCode: number | undefined;\n\tcancelled: boolean;\n\ttruncated: boolean;\n\tfullOutputPath?: string;\n\ttimestamp: number;\n\t/** If true, this message is excluded from LLM context (!! prefix) */\n\texcludeFromContext?: boolean;\n}\n\n/**\n * Message type for extension-injected messages via sendMessage().\n * These are custom messages that extensions can inject into the conversation.\n */\nexport interface CustomMessage<T = unknown> {\n\trole: \"custom\";\n\tcustomType: string;\n\tcontent: string | (TextContent | ImageContent)[];\n\tdisplay: boolean;\n\tdetails?: T;\n\ttimestamp: number;\n}\n\nexport interface BranchSummaryMessage {\n\trole: \"branchSummary\";\n\tsummary: string;\n\tfromId: string;\n\ttimestamp: number;\n}\n\nexport interface CompactionSummaryMessage {\n\trole: \"compactionSummary\";\n\tsummary: string;\n\ttokensBefore: number;\n\ttimestamp: number;\n}\n\n// Extend CustomAgentMessages via declaration merging\ndeclare module \"@hansjm10/volt-agent-core\" {\n\tinterface CustomAgentMessages {\n\t\tbashExecution: BashExecutionMessage;\n\t\tcustom: CustomMessage;\n\t\tbranchSummary: BranchSummaryMessage;\n\t\tcompactionSummary: CompactionSummaryMessage;\n\t}\n}\n\n/**\n * Convert a BashExecutionMessage to user message text for LLM context.\n */\nexport function bashExecutionToText(msg: BashExecutionMessage): string {\n\tlet text = `Ran \\`${msg.command}\\`\\n`;\n\tif (msg.output) {\n\t\ttext += `\\`\\`\\`\\n${msg.output}\\n\\`\\`\\``;\n\t} else {\n\t\ttext += \"(no output)\";\n\t}\n\tif (msg.cancelled) {\n\t\ttext += \"\\n\\n(command cancelled)\";\n\t} else if (msg.exitCode !== null && msg.exitCode !== undefined && msg.exitCode !== 0) {\n\t\ttext += `\\n\\nCommand exited with code ${msg.exitCode}`;\n\t}\n\tif (msg.truncated && msg.fullOutputPath) {\n\t\ttext += `\\n\\n[Output truncated. Full output: ${msg.fullOutputPath}]`;\n\t}\n\treturn text;\n}\n\nexport function createBranchSummaryMessage(summary: string, fromId: string, timestamp: string): BranchSummaryMessage {\n\treturn {\n\t\trole: \"branchSummary\",\n\t\tsummary,\n\t\tfromId,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\nexport function createCompactionSummaryMessage(\n\tsummary: string,\n\ttokensBefore: number,\n\ttimestamp: string,\n): CompactionSummaryMessage {\n\treturn {\n\t\trole: \"compactionSummary\",\n\t\tsummary: summary,\n\t\ttokensBefore,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\n/** Convert CustomMessageEntry to AgentMessage format */\nexport function createCustomMessage(\n\tcustomType: string,\n\tcontent: string | (TextContent | ImageContent)[],\n\tdisplay: boolean,\n\tdetails: unknown | undefined,\n\ttimestamp: string,\n): CustomMessage {\n\treturn {\n\t\trole: \"custom\",\n\t\tcustomType,\n\t\tcontent,\n\t\tdisplay,\n\t\tdetails,\n\t\ttimestamp: new Date(timestamp).getTime(),\n\t};\n}\n\nexport function extractVisibleTextContent(content: unknown, textPartSeparator = \"\\n\"): string {\n\tif (typeof content === \"string\") {\n\t\treturn content;\n\t}\n\tif (!Array.isArray(content)) {\n\t\treturn \"\";\n\t}\n\treturn content\n\t\t.filter(\n\t\t\t(part): part is TextContent =>\n\t\t\t\ttypeof part === \"object\" &&\n\t\t\t\tpart !== null &&\n\t\t\t\t(part as { type?: unknown }).type === \"text\" &&\n\t\t\t\ttypeof (part as { text?: unknown }).text === \"string\",\n\t\t)\n\t\t.map((part) => part.text)\n\t\t.join(textPartSeparator);\n}\n\n/**\n * Transform AgentMessages (including custom types) to LLM-compatible Messages.\n *\n * This is used by:\n * - Agent's transormToLlm option (for prompt calls and queued messages)\n * - Compaction's generateSummary (for summarization)\n * - Custom extensions and tools\n */\nexport function convertToLlm(messages: AgentMessage[]): Message[] {\n\treturn messages\n\t\t.map((m): Message | undefined => {\n\t\t\tswitch (m.role) {\n\t\t\t\tcase \"bashExecution\":\n\t\t\t\t\t// Skip messages excluded from context (!! prefix)\n\t\t\t\t\tif (m.excludeFromContext) {\n\t\t\t\t\t\treturn undefined;\n\t\t\t\t\t}\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [{ type: \"text\", text: bashExecutionToText(m) }],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"custom\": {\n\t\t\t\t\tconst content = typeof m.content === \"string\" ? [{ type: \"text\" as const, text: m.content }] : m.content;\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent,\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\t}\n\t\t\t\tcase \"branchSummary\":\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [{ type: \"text\" as const, text: BRANCH_SUMMARY_PREFIX + m.summary + BRANCH_SUMMARY_SUFFIX }],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"compactionSummary\":\n\t\t\t\t\treturn {\n\t\t\t\t\t\trole: \"user\",\n\t\t\t\t\t\tcontent: [\n\t\t\t\t\t\t\t{ type: \"text\" as const, text: COMPACTION_SUMMARY_PREFIX + m.summary + COMPACTION_SUMMARY_SUFFIX },\n\t\t\t\t\t\t],\n\t\t\t\t\t\ttimestamp: m.timestamp,\n\t\t\t\t\t};\n\t\t\t\tcase \"user\":\n\t\t\t\tcase \"assistant\":\n\t\t\t\tcase \"toolResult\":\n\t\t\t\t\treturn m;\n\t\t\t\tdefault:\n\t\t\t\t\t// biome-ignore lint/correctness/noSwitchDeclarations: fine\n\t\t\t\t\tconst _exhaustiveCheck: never = m;\n\t\t\t\t\treturn undefined;\n\t\t\t}\n\t\t})\n\t\t.filter((m) => m !== undefined);\n}\n"]}