@pellux/goodvibes-sdk 0.30.3 → 0.33.0

package/dist/platform/providers/tool-formats.d.ts

@@ -1,5 +1,10 @@
 import type { ToolDefinition, ToolCall } from '../types/tools.js';
 import type { ProviderMessage } from './interface.js';
+export interface ToolArgumentParseContext {
+    readonly provider?: string | undefined;
+    readonly toolName?: string | undefined;
+    readonly callId?: string | undefined;
+}
 export interface OpenAITool {
     type: 'function';
     function: {
@@ -28,8 +33,8 @@ export type OpenAIContentPart = {
 export interface OpenAIMessage {
     role: 'system' | 'user' | 'assistant' | 'tool';
     content: string | OpenAIContentPart[] | null;
-    tool_calls?: OpenAIToolCall[];
-    tool_call_id?: string;
+    tool_calls?: OpenAIToolCall[] | undefined;
+    tool_call_id?: string | undefined;
 }
 /** Convert internal ToolDefinitions to OpenAI tools array. */
 export declare function toOpenAITools(tools: ToolDefinition[]): OpenAITool[];
@@ -81,7 +86,7 @@ export interface GeminiFunctionDeclaration {
     parameters: Record<string, unknown>;
 }
 export interface GeminiPart {
-    text?: string;
+    text?: string | undefined;
     inlineData?: {
         mimeType: string;
         data: string;
@@ -113,7 +118,7 @@ export declare function toGeminiContents(messages: ProviderMessage[], systemProm
     contents: GeminiContent[];
     systemInstruction?: {
         parts: GeminiPart[];
-    };
+    } | undefined;
 };
 /**
  * Extracts tool calls from raw text content for models (e.g. kimi-k2-thinking
@@ -134,4 +139,5 @@ export declare function extractTextToolCalls(content: string): {
     toolCalls: ToolCall[];
     cleanedContent: string;
 };
+export declare function parseToolCallArguments(raw: string, context?: ToolArgumentParseContext): Record<string, unknown> | undefined;
 //# sourceMappingURL=tool-formats.d.ts.map

package/dist/platform/providers/tool-formats.d.ts.map

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

package/dist/platform/providers/tool-formats.js

@@ -13,11 +13,21 @@ export function toOpenAITools(tools) {
 }
 /** Parse OpenAI tool_calls from a response into internal ToolCall[]. */
 export function fromOpenAIToolCalls(calls) {
-    return calls.map((c) => ({
-        id: c.id,
-        name: c.function.name,
-        arguments: parseJson(c.function.arguments),
-    }));
+    const toolCalls = [];
+    for (const c of calls) {
+        const parsedArguments = parseToolCallArguments(c.function.arguments, {
+            toolName: c.function.name,
+            callId: c.id,
+        });
+        if (parsedArguments === undefined)
+            continue;
+        toolCalls.push({
+            id: c.id,
+            name: c.function.name,
+            arguments: parsedArguments,
+        });
+    }
+    return toolCalls;
 }
 /** Convert internal ProviderMessages to OpenAI message array. */
 export function toOpenAIMessages(messages, systemPrompt) {
@@ -276,10 +286,18 @@ export function extractTextToolCalls(content) {
         lastEnd = matchEnd;
         const toolName = match[1];
         const rawArgs = match[2];
+        const parsedArguments = parseToolCallArguments(rawArgs, {
+            toolName,
+            callId: `text-call-${index}`,
+        });
+        if (parsedArguments === undefined) {
+            index++;
+            continue;
+        }
         toolCalls.push({
             id: `text-call-${index}`,
             name: toolName,
-            arguments: parseJson(rawArgs),
+            arguments: parsedArguments,
         });
         index++;
     }
@@ -295,12 +313,19 @@ export function extractTextToolCalls(content) {
 // ---------------------------------------------------------------------------
 // Shared helper
 // ---------------------------------------------------------------------------
-function parseJson(raw) {
+export function parseToolCallArguments(raw, context = {}) {
+    if (raw.trim().length === 0)
+        return {};
     try {
         return JSON.parse(raw);
     }
     catch (err) {
-        logger.warn('tool-formats: failed to parse JSON tool arguments', { error: summarizeError(err) });
-        return {};
+        logger.warn('tool-formats: failed to parse JSON tool arguments; dropping malformed tool call', {
+            error: summarizeError(err),
+            provider: context.provider,
+            toolName: context.toolName,
+            callId: context.callId,
+        });
+        return undefined;
     }
 }

package/dist/platform/providers/well-known-endpoints.d.ts

@@ -1,7 +1,7 @@
 /**
  * Well-known local LLM service endpoints and ports.
  *
- * These are **fallback defaults** used for zero-config local LLM discovery when
+ * These are default endpoints used for zero-config local LLM discovery when
  * no explicit base URL has been provided by the user. They represent the
  * conventional ports that popular local inference servers listen on out of the box.
  *
@@ -18,6 +18,10 @@
  * Keys correspond to the canonical service identifier used across the codebase.
  * Values are the bare origin (scheme + host + port, **no trailing slash**).
  * Append a path suffix (e.g. `/v1`) at the call site where the full URL is built.
+ *
+ * @remarks These are development/local defaults only. Production deployments
+ * must configure explicit provider base URLs via the `providers` config key.
+ * These constants are never used when a user-supplied value is present.
  */
 export declare const WELL_KNOWN_LOCAL_ENDPOINTS: Readonly<{
     /** Ollama — default listen address (loopback) */

package/dist/platform/providers/well-known-endpoints.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"well-known-endpoints.d.ts","sourceRoot":"","sources":["../../../src/platform/providers/well-known-endpoints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B;IACrC,iDAAiD;;IAEjD,+CAA+C;;IAE/C,sCAAsC;;IAEtC,sCAAsC;;IAEtC,qDAAqD;;EAE5C,CAAC;AAEZ;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB;;;;;;IAMjC,0DAA0D;;;;;EAKjD,CAAC"}
+{"version":3,"file":"well-known-endpoints.d.ts","sourceRoot":"","sources":["../../../src/platform/providers/well-known-endpoints.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0BAA0B;IACrC,iDAAiD;;IAEjD,+CAA+C;;IAE/C,sCAAsC;;IAEtC,sCAAsC;;IAEtC,qDAAqD;;EAE5C,CAAC;AAEZ;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB;;;;;;IAMjC,0DAA0D;;;;;EAKjD,CAAC"}

package/dist/platform/providers/well-known-endpoints.js

@@ -1,7 +1,7 @@
 /**
  * Well-known local LLM service endpoints and ports.
  *
- * These are **fallback defaults** used for zero-config local LLM discovery when
+ * These are default endpoints used for zero-config local LLM discovery when
  * no explicit base URL has been provided by the user. They represent the
  * conventional ports that popular local inference servers listen on out of the box.
  *
@@ -18,6 +18,10 @@
  * Keys correspond to the canonical service identifier used across the codebase.
  * Values are the bare origin (scheme + host + port, **no trailing slash**).
  * Append a path suffix (e.g. `/v1`) at the call site where the full URL is built.
+ *
+ * @remarks These are development/local defaults only. Production deployments
+ * must configure explicit provider base URLs via the `providers` config key.
+ * These constants are never used when a user-supplied value is present.
  */
 export const WELL_KNOWN_LOCAL_ENDPOINTS = Object.freeze({
     /** Ollama — default listen address (loopback) */

package/dist/platform/runtime/auth/inspection.d.ts

@@ -5,16 +5,16 @@ export type AuthInspectionFreshness = 'healthy' | 'expiring' | 'expired' | 'pend
 export interface ProviderAuthInspection {
     readonly provider: string;
     readonly configured: boolean;
-    readonly source?: 'service' | 'builtin';
+    readonly source?: 'service' | 'builtin' | undefined;
     readonly freshness: AuthInspectionFreshness;
-    readonly redirectUri?: string;
+    readonly redirectUri?: string | undefined;
     readonly callbackMode: 'local' | 'manual';
-    readonly localCallback?: string;
+    readonly localCallback?: string | undefined;
     readonly activeSubscription: boolean;
     readonly pendingLogin: boolean;
     readonly overrideAmbientApiKeys: boolean;
-    readonly tokenType?: string;
-    readonly expiresAt?: number;
+    readonly tokenType?: string | undefined;
+    readonly expiresAt?: number | undefined;
     readonly issues: readonly string[];
     readonly nextActions: readonly string[];
 }

package/dist/platform/runtime/auth/inspection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inspection.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/auth/inspection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAA6B,MAAM,+BAA+B,CAAC;AAG/F,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,cAAc,CAAC;AAEpH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,SAAS,sBAAsB,EAAE,CAAC;CACvD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,KAAK,GAAG,QAAQ,CAAC,CAAC;IAClE,QAAQ,CAAC,mBAAmB,EAAE,IAAI,CAAC,mBAAmB,EAAE,KAAK,GAAG,YAAY,GAAG,MAAM,GAAG,aAAa,CAAC,CAAC;IACvG,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;CACvD;AAWD,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,sBAAsB,CAAC,CAgDjC;AAED,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,sBAAsB,CAAC,CAsBjC"}
+{"version":3,"file":"inspection.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/auth/inspection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAA6B,MAAM,+BAA+B,CAAC;AAG/F,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,cAAc,CAAC;AAEpH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,SAAS,sBAAsB,EAAE,CAAC;CACvD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,KAAK,GAAG,QAAQ,CAAC,CAAC;IAClE,QAAQ,CAAC,mBAAmB,EAAE,IAAI,CAAC,mBAAmB,EAAE,KAAK,GAAG,YAAY,GAAG,MAAM,GAAG,aAAa,CAAC,CAAC;IACvG,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;CACvD;AAWD,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,sBAAsB,CAAC,CAgDjC;AAED,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,sBAAsB,CAAC,CAsBjC"}

package/dist/platform/runtime/auth/oauth-client.d.ts

@@ -23,9 +23,9 @@ export declare class OAuthClient {
      * Redirect the user's browser to `result.authorizationUrl`.
      */
     beginAuthorization(input?: {
-        readonly state?: string;
-        readonly verifier?: string;
-        readonly redirectUri?: string;
+        readonly state?: string | undefined;
+        readonly verifier?: string | undefined;
+        readonly redirectUri?: string | undefined;
     }): Promise<OAuthStartState>;
     /**
      * Exchange an authorization code (returned via the redirect) for tokens.
@@ -35,7 +35,7 @@ export declare class OAuthClient {
         readonly code: string;
         readonly verifier: string;
         readonly redirectUri: string;
-        readonly state?: string;
+        readonly state?: string | undefined;
     }): Promise<OAuthTokenPayload>;
     /**
      * Use a refresh token to obtain a new access token without user interaction.

package/dist/platform/runtime/auth/oauth-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"oauth-client.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/auth/oauth-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAOzE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAC9F,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE9F,qBAAa,WAAW;;gBAGV,MAAM,EAAE,mBAAmB;IAIvC;;;OAGG;IACG,kBAAkB,CAAC,KAAK,CAAC,EAAE;QAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;KAC/B,GAAG,OAAO,CAAC,eAAe,CAAC;IAI5B;;;OAGG;IACG,YAAY,CAAC,KAAK,EAAE;QACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAI9B;;OAEG;IACG,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIpE;;;OAGG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,6DAA6D;IAC7D,IAAI,MAAM,IAAI,mBAAmB,CAEhC;CACF"}
+{"version":3,"file":"oauth-client.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/auth/oauth-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAOzE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAC9F,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE9F,qBAAa,WAAW;;gBAGV,MAAM,EAAE,mBAAmB;IAIvC;;;OAGG;IACG,kBAAkB,CAAC,KAAK,CAAC,EAAE;QAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC3C,GAAG,OAAO,CAAC,eAAe,CAAC;IAI5B;;;OAGG;IACG,YAAY,CAAC,KAAK,EAAE;QACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACrC,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAI9B;;OAEG;IACG,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIpE;;;OAGG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,6DAA6D;IAC7D,IAAI,MAAM,IAAI,mBAAmB,CAEhC;CACF"}

package/dist/platform/runtime/auth/oauth-core.d.ts

@@ -6,15 +6,15 @@ export declare function createPkceVerifier(bytes?: number): string;
 export declare function createPkceChallenge(verifier: string): Promise<string>;
 export declare function parseOAuthScopes(raw: unknown): readonly string[] | undefined;
 export declare function buildOAuthAuthorizationStart(config: OAuthProviderConfig, input?: {
-    readonly state?: string;
-    readonly verifier?: string;
-    readonly redirectUri?: string;
+    readonly state?: string | undefined;
+    readonly verifier?: string | undefined;
+    readonly redirectUri?: string | undefined;
 }): Promise<OAuthStartState>;
 export declare function exchangeOAuthAuthorizationCode(config: OAuthProviderConfig, input: {
     readonly code: string;
     readonly verifier: string;
     readonly redirectUri: string;
-    readonly state?: string;
+    readonly state?: string | undefined;
 }): Promise<OAuthTokenPayload>;
 export declare function refreshOAuthAccessToken(config: OAuthProviderConfig, refreshToken: string): Promise<OAuthTokenPayload>;
 export declare function decodeJwtPayload(token: string): Record<string, unknown> | null;

package/dist/platform/runtime/auth/oauth-core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"oauth-core.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/auth/oauth-core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAGzE,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE9F,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE9F,wBAAgB,gBAAgB,CAAC,KAAK,SAAK,GAAG,MAAM,CAEnD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,SAAK,GAAG,MAAM,CAErD;AAED,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE3E;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAI5E;AAED,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,mBAAmB,EAC3B,KAAK,CAAC,EAAE;IACN,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B,GACA,OAAO,CAAC,eAAe,CAAC,CA4B1B;AA4CD,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,mBAAmB,EAC3B,KAAK,EAAE;IACL,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,GACA,OAAO,CAAC,iBAAiB,CAAC,CAc5B;AAED,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,mBAAmB,EAC3B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAc5B;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAa9E"}
+{"version":3,"file":"oauth-core.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/auth/oauth-core.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAGzE,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE9F,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAE9F,wBAAgB,gBAAgB,CAAC,KAAK,SAAK,GAAG,MAAM,CAEnD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,SAAK,GAAG,MAAM,CAErD;AAED,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE3E;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAI5E;AAED,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,mBAAmB,EAC3B,KAAK,CAAC,EAAE;IACN,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C,GACA,OAAO,CAAC,eAAe,CAAC,CA4B1B;AA4CD,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,mBAAmB,EAC3B,KAAK,EAAE;IACL,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC,GACA,OAAO,CAAC,iBAAiB,CAAC,CAc5B;AAED,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,mBAAmB,EAC3B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAc5B;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAa9E"}

package/dist/platform/runtime/bootstrap-background.d.ts

@@ -15,13 +15,23 @@ export interface BackgroundProviderDiscoveryOptions {
     providerRegistry: ProviderRegistry;
     runtime: RuntimeSelectionState;
     requestRender: () => void;
-    restoreRuntimeModel?: (providerRegistry: ProviderRegistry, savedModel: string, savedProvider: string, runtime: RuntimeSelectionState) => void;
-    restoreSavedModel?: (providerRegistry: ProviderRegistry, savedModel: string, savedProvider: string, runtime: RuntimeSelectionState) => void;
+    restoreRuntimeModel: (providerRegistry: ProviderRegistry, savedModel: string, runtime: RuntimeSelectionState) => void;
     systemMessageRouter: HostSystemMessageSink;
     shellPaths: Pick<ShellPathService, 'workingDirectory' | 'homeDirectory'>;
     surfaceRoot: string;
 }
-export declare function startBackgroundProviderDiscovery(options: BackgroundProviderDiscoveryOptions): void;
+export interface BackgroundRuntimeTaskHandle {
+    readonly stopped: boolean;
+    stop(): void;
+}
+/**
+ * Starts one asynchronous provider discovery pass and returns a handle that
+ * prevents late scan results from mutating runtime state after the host stops.
+ *
+ * The underlying scanner does not currently expose cancellable I/O, so `stop()`
+ * is intentionally a state guard rather than a hard abort.
+ */
+export declare function startBackgroundProviderDiscovery(options: BackgroundProviderDiscoveryOptions): BackgroundRuntimeTaskHandle;
 export interface BackgroundMcpDiscoveryOptions {
     mcpRegistry: McpRegistry;
     systemMessageRouter: HostSystemMessageSink;
@@ -29,5 +39,9 @@ export interface BackgroundMcpDiscoveryOptions {
     shellPaths: Pick<ShellPathService, 'workingDirectory' | 'homeDirectory'>;
     surfaceRoot: string;
 }
-export declare function scheduleBackgroundMcpDiscovery(options: BackgroundMcpDiscoveryOptions): void;
+/**
+ * Schedules MCP auto-discovery and returns a handle that cancels the delayed
+ * scan and suppresses late async side effects after host shutdown.
+ */
+export declare function scheduleBackgroundMcpDiscovery(options: BackgroundMcpDiscoveryOptions): BackgroundRuntimeTaskHandle;
 //# sourceMappingURL=bootstrap-background.d.ts.map

package/dist/platform/runtime/bootstrap-background.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap-background.d.ts","sourceRoot":"","sources":["../../../src/platform/runtime/bootstrap-background.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGzD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,kCAAkC;IACjD,aAAa,EAAE,aAAa,CAAC;IAC7B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,OAAO,EAAE,qBAAqB,CAAC;IAC/B,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,mBAAmB,CAAC,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC9I,iBAAiB,CAAC,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC5I,mBAAmB,EAAE,qBAAqB,CAAC;IAC3C,UAAU,EAAE,IAAI,CAAC,gBAAgB,EAAE,kBAAkB,GAAG,eAAe,CAAC,CAAC;IACzE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,kCAAkC,GAC1C,IAAI,CAmGN;AAED,MAAM,WAAW,6BAA6B;IAC5C,WAAW,EAAE,WAAW,CAAC;IACzB,mBAAmB,EAAE,qBAAqB,CAAC;IAC3C,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,UAAU,EAAE,IAAI,CAAC,gBAAgB,EAAE,kBAAkB,GAAG,eAAe,CAAC,CAAC;IACzE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,6BAA6B,GAAG,IAAI,CAsB3F"}
+{"version":3,"file":"bootstrap-background.d.ts","sourceRoot":"","sources":["../../../src/platform/runtime/bootstrap-background.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AASzD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,kCAAkC;IACjD,aAAa,EAAE,aAAa,CAAC;IAC7B,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,OAAO,EAAE,qBAAqB,CAAC;IAC/B,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,mBAAmB,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACtH,mBAAmB,EAAE,qBAAqB,CAAC;IAC3C,UAAU,EAAE,IAAI,CAAC,gBAAgB,EAAE,kBAAkB,GAAG,eAAe,CAAC,CAAC;IACzE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,IAAI,IAAI,IAAI,CAAC;CACd;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,kCAAkC,GAC1C,2BAA2B,CAwG7B;AAED,MAAM,WAAW,6BAA6B;IAC5C,WAAW,EAAE,WAAW,CAAC;IACzB,mBAAmB,EAAE,qBAAqB,CAAC;IAC3C,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,UAAU,EAAE,IAAI,CAAC,gBAAgB,EAAE,kBAAkB,GAAG,eAAe,CAAC,CAAC;IACzE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,6BAA6B,GAAG,2BAA2B,CA0ClH"}

package/dist/platform/runtime/bootstrap-background.js

@@ -2,30 +2,49 @@ import { logger } from '../utils/logger.js';
 import { autoRegisterProviders } from '../providers/auto-register.js';
 import { scan, loadPersistedProviders, persistProviders, removePersistedProviders, scanMcpServers } from '../discovery/index.js';
 import { summarizeError } from '../utils/error-display.js';
+import { splitModelRegistryKey } from '../providers/registry-helpers.js';
+const FALLBACK_MODEL = {
+    model: 'openrouter:openrouter/free',
+    provider: 'openrouter',
+};
+/**
+ * Starts one asynchronous provider discovery pass and returns a handle that
+ * prevents late scan results from mutating runtime state after the host stops.
+ *
+ * The underlying scanner does not currently expose cancellable I/O, so `stop()`
+ * is intentionally a state guard rather than a hard abort.
+ */
 export function startBackgroundProviderDiscovery(options) {
     const { configManager, providerRegistry, runtime, requestRender, restoreRuntimeModel, systemMessageRouter, shellPaths, surfaceRoot } = options;
-    const restoreModel = restoreRuntimeModel ?? options.restoreSavedModel;
-    if (!restoreModel) {
-        throw new Error('startBackgroundProviderDiscovery requires restoreRuntimeModel or restoreSavedModel.');
-    }
     autoRegisterProviders(providerRegistry);
+    let stopped = false;
+    const handle = {
+        get stopped() {
+            return stopped;
+        },
+        stop() {
+            stopped = true;
+        },
+    };
     const persisted = loadPersistedProviders({ ...shellPaths, surfaceRoot });
     if (persisted.length > 0) {
         try {
             providerRegistry.registerDiscoveredProviders(persisted);
-            restoreModel(providerRegistry, configManager.get('provider.model'), configManager.get('provider.provider'), runtime);
+            restoreRuntimeModel(providerRegistry, configManager.get('provider.model'), runtime);
             for (const server of persisted) {
                 systemMessageRouter.low(`[Local] ${server.name} at ${server.host}:${server.port} (${server.models.length} model${server.models.length !== 1 ? 's' : ''}) — from last session`);
             }
             requestRender();
         }
         catch (err) {
-            logger.debug('[bootstrap] Non-fatal error during persisted provider registration', {
+            logger.warn('[bootstrap] Persisted provider registration failed', {
                 error: summarizeError(err),
             });
         }
     }
     scan().then((result) => {
+        if (stopped)
+            return;
         const currentModel = configManager.get('provider.model');
         const foundKeys = new Set(result.servers.map((server) => `${server.host}:${server.port}`));
         const persistedKeys = new Set(persisted.map((server) => `${server.host}:${server.port}`));
@@ -34,10 +53,10 @@ export function startBackgroundProviderDiscovery(options) {
         if (result.servers.length > 0) {
             try {
                 providerRegistry.registerDiscoveredProviders(result.servers);
-                restoreModel(providerRegistry, configManager.get('provider.model'), configManager.get('provider.provider'), runtime);
+                restoreRuntimeModel(providerRegistry, configManager.get('provider.model'), runtime);
             }
             catch (err) {
-                logger.debug('[bootstrap] Non-fatal error during scan provider registration', {
+                logger.warn('[bootstrap] Scan provider registration failed', {
                     error: summarizeError(err),
                 });
             }
@@ -49,21 +68,21 @@ export function startBackgroundProviderDiscovery(options) {
             removePersistedProviders({ ...shellPaths, surfaceRoot }, removedServers);
             for (const server of removedServers) {
                 systemMessageRouter.low(`[Scan] ${server.name} at ${server.host}:${server.port} is no longer reachable — removed`);
-                const wasActive = server.models.includes(currentModel);
+                const currentModelBareId = splitModelRegistryKey(currentModel).resolvedModelId;
+                const wasActive = server.models.includes(currentModelBareId);
                 if (wasActive) {
-                    configManager.set('provider.model', 'openrouter/free');
-                    configManager.set('provider.provider', 'openrouter');
+                    configManager.set('provider.model', FALLBACK_MODEL.model);
                     try {
-                        providerRegistry.setCurrentModel('openrouter/free');
-                        runtime.model = 'openrouter/free';
-                        runtime.provider = 'openrouter';
+                        providerRegistry.setCurrentModel(FALLBACK_MODEL.model);
+                        runtime.model = FALLBACK_MODEL.model;
+                        runtime.provider = FALLBACK_MODEL.provider;
                     }
                     catch (err) {
-                        logger.debug('[bootstrap] Non-fatal error switching model after server removal', {
+                        logger.warn('[bootstrap] Model switch after server removal failed', {
                             error: summarizeError(err),
                         });
                     }
-                    systemMessageRouter.high(`[Scan] Active model was on ${server.name} — switched to openrouter/free`);
+                    systemMessageRouter.high(`[Scan] Active model was on ${server.name} — switched to ${FALLBACK_MODEL.model}`);
                 }
             }
         }
@@ -74,19 +93,47 @@ export function startBackgroundProviderDiscovery(options) {
             requestRender();
         }
     }).catch((error) => {
-        logger.debug('[bootstrap] provider discovery scan failed', {
+        if (stopped)
+            return;
+        logger.warn('[bootstrap] Provider discovery scan failed', {
             error: summarizeError(error),
         });
     });
+    return handle;
 }
+/**
+ * Schedules MCP auto-discovery and returns a handle that cancels the delayed
+ * scan and suppresses late async side effects after host shutdown.
+ */
 export function scheduleBackgroundMcpDiscovery(options) {
     const { mcpRegistry, systemMessageRouter, requestRender, shellPaths, surfaceRoot } = options;
+    let stopped = false;
+    let scanTimer = null;
+    const handle = {
+        get stopped() {
+            return stopped;
+        },
+        stop() {
+            stopped = true;
+            if (scanTimer) {
+                clearTimeout(scanTimer);
+                scanTimer = null;
+            }
+        },
+    };
     mcpRegistry.connectAll(shellPaths).catch((err) => {
-        logger.debug('MCP auto-connect failed (non-fatal)', { error: summarizeError(err) });
+        if (stopped)
+            return;
+        logger.warn('MCP auto-connect failed', { error: summarizeError(err) });
     });
-    const scanTimer = setTimeout(() => {
+    scanTimer = setTimeout(() => {
+        scanTimer = null;
+        if (stopped)
+            return;
         const registeredNames = new Set(mcpRegistry.serverNames);
         scanMcpServers({ ...shellPaths, surfaceRoot }, registeredNames).then((result) => {
+            if (stopped)
+                return;
             if (result.suggestions.length === 0)
                 return;
             for (const suggestion of result.suggestions) {
@@ -94,8 +141,11 @@ export function scheduleBackgroundMcpDiscovery(options) {
             }
             requestRender();
         }).catch((err) => {
-            logger.debug('MCP auto-discovery scan failed (non-fatal)', { error: summarizeError(err) });
+            if (stopped)
+                return;
+            logger.warn('MCP auto-discovery scan failed', { error: summarizeError(err) });
         });
     }, 2000);
     scanTimer.unref?.();
+    return handle;
 }

package/dist/platform/runtime/bootstrap-helpers.d.ts

@@ -8,5 +8,5 @@ export interface RuntimeModelSelectionState {
 }
 export declare function loadRuntimeSystemPrompt(configManager: ConfigManager): string;
 export declare function synchronizeConfiguredServices(syncIntegration: (record: IntegrationRecord, source?: string) => void, serviceRegistry: ServiceRegistry): Promise<void>;
-export declare function restoreRuntimeModel(providerRegistry: ProviderRegistry, savedModel: string, savedProvider: string, runtime: RuntimeModelSelectionState): void;
+export declare function restoreRuntimeModel(providerRegistry: ProviderRegistry, savedModel: string, runtime: RuntimeModelSelectionState): void;
 //# sourceMappingURL=bootstrap-helpers.d.ts.map

package/dist/platform/runtime/bootstrap-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap-helpers.d.ts","sourceRoot":"","sources":["../../../src/platform/runtime/bootstrap-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAMzE,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAUD,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,aAAa,GAAG,MAAM,CAiB5E;AAED,wBAAsB,6BAA6B,CACjD,eAAe,EAAE,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,EACrE,eAAe,EAAE,eAAe,GAC/B,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED,wBAAgB,mBAAmB,CACjC,gBAAgB,EAAE,gBAAgB,EAClC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,0BAA0B,GAClC,IAAI,CAeN"}
+{"version":3,"file":"bootstrap-helpers.d.ts","sourceRoot":"","sources":["../../../src/platform/runtime/bootstrap-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAMzE,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAUD,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,aAAa,GAAG,MAAM,CAiB5E;AAED,wBAAsB,6BAA6B,CACjD,eAAe,EAAE,CAAC,MAAM,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,EACrE,eAAe,EAAE,eAAe,GAC/B,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED,wBAAgB,mBAAmB,CACjC,gBAAgB,EAAE,gBAAgB,EAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,0BAA0B,GAClC,IAAI,CAYN"}

package/dist/platform/runtime/bootstrap-helpers.js

@@ -52,21 +52,18 @@ export async function synchronizeConfiguredServices(syncIntegration, serviceRegi
         }, 'bootstrap.services');
     }));
 }
-export function restoreRuntimeModel(providerRegistry, savedModel, savedProvider, runtime) {
+export function restoreRuntimeModel(providerRegistry, savedModel, runtime) {
     const registry = providerRegistry.listModels();
-    const modelDef = savedModel.includes(':')
-        ? (registry.find((m) => m.registryKey === savedModel) ?? registry.find((m) => m.id === savedModel))
-        : registry.find((m) => m.id === savedModel && (!savedProvider || m.provider === savedProvider))
-            ?? registry.find((m) => m.id === savedModel);
+    const modelDef = registry.find((m) => m.registryKey === savedModel);
     if (!modelDef)
         return;
     try {
-        const key = modelDef.registryKey ?? `${modelDef.provider}:${modelDef.id}`;
+        const key = modelDef.registryKey;
         providerRegistry.setCurrentModel(key);
         runtime.model = key;
         runtime.provider = modelDef.provider;
     }
     catch (err) {
-        logger.debug('Model restore failed (non-fatal)', { error: summarizeError(err) });
+        logger.warn('Model restore failed', { error: summarizeError(err) });
     }
 }

package/dist/platform/runtime/bootstrap-hook-bridge.js

@@ -9,7 +9,7 @@ function fireHook(options, path, phase, category, specific, payload) {
         sessionId: options.runtime.sessionId,
         timestamp: Date.now(),
         payload,
-    }).catch((err) => logger.debug('Hook bridge fire error', { path, error: summarizeError(err) }));
+    }).catch((err) => logger.warn('Hook bridge fire error', { path, error: summarizeError(err) }));
 }
 export function registerBootstrapHookBridge(options) {
     const fireOptions = {

package/dist/platform/runtime/bootstrap-runtime-events.d.ts

@@ -13,7 +13,7 @@ export interface HostRuntimeEventBridgeOptions {
     readonly runtimeBus: RuntimeEventBus;
     readonly domainDispatch: ReturnType<typeof createDomainDispatch>;
     readonly getSystemMessageRouter: () => HostRuntimeMessageRouter | null;
-    readonly queueConversationFollowUp?: (item: ConversationFollowUpItem) => void;
+    readonly queueConversationFollowUp?: ((item: ConversationFollowUpItem) => void) | undefined;
     readonly requestRender: () => void;
     readonly configManager: ConfigManager;
     readonly agentManager: AgentManager;

package/dist/platform/runtime/bootstrap-runtime-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap-runtime-events.d.ts","sourceRoot":"","sources":["../../../src/platform/runtime/bootstrap-runtime-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,KAAK,EAA6B,eAAe,EAAiB,MAAM,mBAAmB,CAAC;AACnG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAI5D,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,cAAc,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IACjE,QAAQ,CAAC,sBAAsB,EAAE,MAAM,wBAAwB,GAAG,IAAI,CAAC;IACvE,QAAQ,CAAC,yBAAyB,CAAC,EAAE,CAAC,IAAI,EAAE,wBAAwB,KAAK,IAAI,CAAC;IAC9E,QAAQ,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;CACzC;AAoED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,6BAA6B,GACrC;IAAE,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;IAAC,sBAAsB,EAAE;QAAE,KAAK,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,GAAG,IAAI,CAAA;KAAE,CAAA;CAAE,CAsKzG;AAED,MAAM,MAAM,kCAAkC,GAAG,6BAA6B,CAAC;AAC/E,eAAO,MAAM,8BAA8B,kCAA4B,CAAC"}
+{"version":3,"file":"bootstrap-runtime-events.d.ts","sourceRoot":"","sources":["../../../src/platform/runtime/bootstrap-runtime-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,KAAK,EAA6B,eAAe,EAAiB,MAAM,mBAAmB,CAAC;AACnG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAI5D,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,cAAc,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IACjE,QAAQ,CAAC,sBAAsB,EAAE,MAAM,wBAAwB,GAAG,IAAI,CAAC;IACvE,QAAQ,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,wBAAwB,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC5F,QAAQ,CAAC,aAAa,EAAE,MAAM,IAAI,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;CACzC;AAoED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,6BAA6B,GACrC;IAAE,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;IAAC,sBAAsB,EAAE;QAAE,KAAK,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,GAAG,IAAI,CAAA;KAAE,CAAA;CAAE,CAsKzG;AAED,MAAM,MAAM,kCAAkC,GAAG,6BAA6B,CAAC;AAC/E,eAAO,MAAM,8BAA8B,kCAA4B,CAAC"}

package/dist/platform/runtime/bootstrap-runtime-events.js

@@ -194,7 +194,7 @@ export function registerHostRuntimeEvents(options) {
         });
         requestRender();
     }, AGENT_STATUS_INTERVAL_MS);
-    // Don't block clean process exit (PERF-07).
+    // Don't block clean process exit.
     agentStatusIntervalRef.value.unref?.();
     return { unsubs, agentStatusIntervalRef };
 }

package/dist/platform/runtime/bootstrap-services.d.ts

@@ -19,10 +19,10 @@ interface HttpListenerService {
 interface ServiceFactories {
     createDaemonServer?: (runtimeBus: RuntimeEventBus, userAuth: RuntimeServices['localUserAuthManager'], runtimeServices: RuntimeServices) => DaemonService;
     createHttpListener?: (hookDispatcher: HookDispatcher, userAuth: RuntimeServices['localUserAuthManager'], configManager: RuntimeServices['configManager']) => HttpListenerService;
-    startupTimeoutMs?: number;
-    probeDaemonPortInUse?: (host: string, port: number) => Promise<boolean>;
+    startupTimeoutMs?: number | undefined;
+    probeDaemonPortInUse?: ((host: string, port: number) => Promise<boolean>) | undefined;
     probeDaemonIdentity?: (host: string, port: number, token?: string) => Promise<DaemonIdentityProbeResult>;
-    probeHttpListenerPortInUse?: (host: string, port: number) => Promise<boolean>;
+    probeHttpListenerPortInUse?: ((host: string, port: number) => Promise<boolean>) | undefined;
     /**
      * Shared bearer token the daemon should accept on inbound HTTP requests.
      * When set, `daemon.enable()` registers this token and requests carrying
@@ -30,13 +30,13 @@ interface ServiceFactories {
      * Surfaces that generate companion-app pairing tokens should pass the token
      * here so the embedded daemon accepts scanned QR credentials.
      */
-    sharedDaemonToken?: string;
+    sharedDaemonToken?: string | undefined;
     /**
      * Shared bearer token for the HTTP listener (webhook-style surfaces).
      * Independent from `sharedDaemonToken`; different surfaces may issue
      * different tokens, or both may share the same bearer.
      */
-    sharedHttpListenerToken?: string;
+    sharedHttpListenerToken?: string | undefined;
 }
 export type HostServiceMode = 'disabled' | 'embedded' | 'external' | 'blocked' | 'unavailable';
 export interface HostServiceStatus {
@@ -44,16 +44,16 @@ export interface HostServiceStatus {
     readonly host: string;
     readonly port: number;
     readonly baseUrl: string;
-    readonly reason?: string;
-    readonly status?: string;
-    readonly version?: string;
-    readonly authenticated?: boolean;
+    readonly reason?: string | undefined;
+    readonly status?: string | undefined;
+    readonly version?: string | undefined;
+    readonly authenticated?: boolean | undefined;
 }
 interface DaemonIdentityProbeResult {
     readonly kind: 'goodvibes' | 'unauthorized' | 'unknown';
-    readonly status?: string;
-    readonly version?: string;
-    readonly reason?: string;
+    readonly status?: string | undefined;
+    readonly version?: string | undefined;
+    readonly reason?: string | undefined;
 }
 export interface HostServicesHandle {
     readonly daemonServer: DaemonService | null;
@@ -66,6 +66,6 @@ export interface HostServicesHandle {
 export interface HostServicesConfig {
     get(key: 'danger.daemon' | 'danger.httpListener' | 'controlPlane.host' | 'controlPlane.port' | 'httpListener.host' | 'httpListener.port'): boolean | string | number;
 }
-export declare function startHostServices(config: HostServicesConfig, runtimeBus: RuntimeEventBus, hookDispatcher: HookDispatcher, factories: ServiceFactories | undefined, runtimeServices: RuntimeServices): Promise<HostServicesHandle>;
+export declare function startHostServices(config: HostServicesConfig, runtimeBus: RuntimeEventBus, hookDispatcher: HookDispatcher, runtimeServices: RuntimeServices, factories?: ServiceFactories): Promise<HostServicesHandle>;
 export {};
 //# sourceMappingURL=bootstrap-services.d.ts.map