@ponythewhite/base-context 1.0.0 → 1.0.1

package/dist/core/provider-contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider-contracts.d.ts","sourceRoot":"","sources":["../../src/core/provider-contracts.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,MAAM,WAAW,oBAAoB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,WAAW,GAAG,aAAa,GAAG,aAAa,CAAC;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,6EAA6E;AAC7E,eAAO,MAAM,gCAAgC,EAAE,SAAS,oBAAoB,EA6B3E,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAQhF;AAED,4FAA4F;AAC5F,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAIjG","sourcesContent":["/** Product auth capabilities, independent of protocol adapter registration. */\nexport interface ProviderAuthContract {\n\tproviderId: string;\n\toauth: \"validated\" | \"unvalidated\" | \"unsupported\";\n\tguidance: string;\n\tapiKeyProviderId?: string;\n}\n\n/** No copied model OAuth client has been validated for this distribution. */\nexport const BUILT_IN_PROVIDER_AUTH_CONTRACTS: readonly ProviderAuthContract[] = [\n\t{\n\t\tproviderId: \"anthropic\",\n\t\toauth: \"unvalidated\",\n\t\tguidance:\n\t\t\t\"Anthropic subscription OAuth is unavailable in Base Context: its client identity has not been validated for this distribution. Use Anthropic API-key login or ANTHROPIC_API_KEY instead.\",\n\t\tapiKeyProviderId: \"anthropic\",\n\t},\n\t{\n\t\tproviderId: \"github-copilot\",\n\t\toauth: \"unvalidated\",\n\t\tguidance:\n\t\t\t\"GitHub Copilot authentication is unavailable in Base Context: the copied client identity has not been validated for this distribution. Use an API-key provider such as openai or anthropic instead.\",\n\t\tapiKeyProviderId: \"openai\",\n\t},\n\t{\n\t\tproviderId: \"openai-codex\",\n\t\toauth: \"unvalidated\",\n\t\tguidance:\n\t\t\t\"OpenAI Codex subscription OAuth is unavailable in Base Context: its client identity has not been validated for this distribution. For API-key inference, select the openai provider and configure OPENAI_API_KEY.\",\n\t\tapiKeyProviderId: \"openai\",\n\t},\n\t{\n\t\tproviderId: \"prime-inference\",\n\t\toauth: \"unsupported\",\n\t\tguidance:\n\t\t\t\"Prime browser login is unavailable in Base Context. Use Prime Inference API-key login or PRIME_API_KEY instead.\",\n\t\tapiKeyProviderId: \"prime-inference\",\n\t},\n];\n\nexport function getProviderAuthContract(providerId: string): ProviderAuthContract {\n\treturn (\n\t\tBUILT_IN_PROVIDER_AUTH_CONTRACTS.find((entry) => entry.providerId === providerId) ?? {\n\t\t\tproviderId,\n\t\t\toauth: \"unvalidated\",\n\t\t\tguidance: `OAuth for ${providerId} is unavailable in Base Context until its provider contract is validated. Local registration is not validation. Use a supported API-key or bearer-token configuration instead.`,\n\t\t}\n\t);\n}\n\n/** Pasting a subscription token into an API-key field does not validate its OAuth route. */\nexport function isProviderApiKeyAllowed(providerId: string, apiKey: string, api?: string): boolean {\n\tif (providerId === \"github-copilot\" || providerId === \"openai-codex\" || api === \"openai-codex-responses\")\n\t\treturn false;\n\treturn (providerId !== \"anthropic\" && api !== \"anthropic-messages\") || !apiKey.includes(\"sk-ant-oat\");\n}\n"]}
+{"version":3,"file":"provider-contracts.d.ts","sourceRoot":"","sources":["../../src/core/provider-contracts.ts"],"names":[],"mappings":"AAEA,0FAA0F;AAC1F,MAAM,WAAW,oBAAoB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,WAAW,GAAG,aAAa,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAchF;AAED,eAAO,MAAM,gCAAgC,EAAE,SAAS,oBAAoB,EAK9C,CAAC;AAE/B,yDAAyD;AACzD,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAOlG","sourcesContent":["import { getOAuthProvider } from \"@ponythewhite/base-context-ai/oauth\";\n\n/** Supported adapters, not a claim of provider endorsement or live account validation. */\nexport interface ProviderAuthContract {\n\tproviderId: string;\n\toauth: \"supported\" | \"unsupported\";\n\tguidance: string;\n\tapiKeyProviderId?: string;\n}\n\nexport function getProviderAuthContract(providerId: string): ProviderAuthContract {\n\tif (providerId === \"prime\" || providerId === \"prime-intellect\") {\n\t\treturn { providerId, oauth: \"unsupported\", guidance: \"Prime integrations are disabled in Base Context.\" };\n\t}\n\tconst provider = getOAuthProvider(providerId);\n\treturn {\n\t\tproviderId,\n\t\toauth: provider ? \"supported\" : \"unsupported\",\n\t\tguidance: provider\n\t\t\t? providerId.startsWith(\"mcp:\")\n\t\t\t\t? `Use /mcp login ${providerId.slice(4)} to connect ${provider.name}.`\n\t\t\t\t: `Use /login to authenticate with ${provider.name}, then select a model with /model.`\n\t\t\t: `No OAuth adapter is registered for ${providerId}. Configure a supported provider or register its OAuth adapter.`,\n\t};\n}\n\nexport const BUILT_IN_PROVIDER_AUTH_CONTRACTS: readonly ProviderAuthContract[] = [\n\t\"anthropic\",\n\t\"github-copilot\",\n\t\"openai-codex\",\n\t\"prime-intellect\",\n].map(getProviderAuthContract);\n\n/** Codex uses OAuth credentials, not OpenAI API keys. */\nexport function isProviderApiKeyAllowed(providerId: string, _apiKey: string, api?: string): boolean {\n\treturn (\n\t\tproviderId !== \"prime\" &&\n\t\tproviderId !== \"prime-intellect\" &&\n\t\tproviderId !== \"openai-codex\" &&\n\t\tapi !== \"openai-codex-responses\"\n\t);\n}\n"]}

package/dist/core/provider-contracts.js

@@ -1,41 +1,30 @@
-/** No copied model OAuth client has been validated for this distribution. */
-export const BUILT_IN_PROVIDER_AUTH_CONTRACTS = [
-    {
-        providerId: "anthropic",
-        oauth: "unvalidated",
-        guidance: "Anthropic subscription OAuth is unavailable in Base Context: its client identity has not been validated for this distribution. Use Anthropic API-key login or ANTHROPIC_API_KEY instead.",
-        apiKeyProviderId: "anthropic",
-    },
-    {
-        providerId: "github-copilot",
-        oauth: "unvalidated",
-        guidance: "GitHub Copilot authentication is unavailable in Base Context: the copied client identity has not been validated for this distribution. Use an API-key provider such as openai or anthropic instead.",
-        apiKeyProviderId: "openai",
-    },
-    {
-        providerId: "openai-codex",
-        oauth: "unvalidated",
-        guidance: "OpenAI Codex subscription OAuth is unavailable in Base Context: its client identity has not been validated for this distribution. For API-key inference, select the openai provider and configure OPENAI_API_KEY.",
-        apiKeyProviderId: "openai",
-    },
-    {
-        providerId: "prime-inference",
-        oauth: "unsupported",
-        guidance: "Prime browser login is unavailable in Base Context. Use Prime Inference API-key login or PRIME_API_KEY instead.",
-        apiKeyProviderId: "prime-inference",
-    },
-];
+import { getOAuthProvider } from "@ponythewhite/base-context-ai/oauth";
 export function getProviderAuthContract(providerId) {
-    return (BUILT_IN_PROVIDER_AUTH_CONTRACTS.find((entry) => entry.providerId === providerId) ?? {
+    if (providerId === "prime" || providerId === "prime-intellect") {
+        return { providerId, oauth: "unsupported", guidance: "Prime integrations are disabled in Base Context." };
+    }
+    const provider = getOAuthProvider(providerId);
+    return {
         providerId,
-        oauth: "unvalidated",
-        guidance: `OAuth for ${providerId} is unavailable in Base Context until its provider contract is validated. Local registration is not validation. Use a supported API-key or bearer-token configuration instead.`,
-    });
+        oauth: provider ? "supported" : "unsupported",
+        guidance: provider
+            ? providerId.startsWith("mcp:")
+                ? `Use /mcp login ${providerId.slice(4)} to connect ${provider.name}.`
+                : `Use /login to authenticate with ${provider.name}, then select a model with /model.`
+            : `No OAuth adapter is registered for ${providerId}. Configure a supported provider or register its OAuth adapter.`,
+    };
 }
-/** Pasting a subscription token into an API-key field does not validate its OAuth route. */
-export function isProviderApiKeyAllowed(providerId, apiKey, api) {
-    if (providerId === "github-copilot" || providerId === "openai-codex" || api === "openai-codex-responses")
-        return false;
-    return (providerId !== "anthropic" && api !== "anthropic-messages") || !apiKey.includes("sk-ant-oat");
+export const BUILT_IN_PROVIDER_AUTH_CONTRACTS = [
+    "anthropic",
+    "github-copilot",
+    "openai-codex",
+    "prime-intellect",
+].map(getProviderAuthContract);
+/** Codex uses OAuth credentials, not OpenAI API keys. */
+export function isProviderApiKeyAllowed(providerId, _apiKey, api) {
+    return (providerId !== "prime" &&
+        providerId !== "prime-intellect" &&
+        providerId !== "openai-codex" &&
+        api !== "openai-codex-responses");
 }
 //# sourceMappingURL=provider-contracts.js.map

package/dist/core/provider-contracts.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-contracts.js","sourceRoot":"","sources":["../../src/core/provider-contracts.ts"],"names":[],"mappings":"AAQA,6EAA6E;AAC7E,MAAM,CAAC,MAAM,gCAAgC,GAAoC;IAChF;QACC,UAAU,EAAE,WAAW;QACvB,KAAK,EAAE,aAAa;QACpB,QAAQ,EACP,0LAA0L;QAC3L,gBAAgB,EAAE,WAAW;KAC7B;IACD;QACC,UAAU,EAAE,gBAAgB;QAC5B,KAAK,EAAE,aAAa;QACpB,QAAQ,EACP,qMAAqM;QACtM,gBAAgB,EAAE,QAAQ;KAC1B;IACD;QACC,UAAU,EAAE,cAAc;QAC1B,KAAK,EAAE,aAAa;QACpB,QAAQ,EACP,mNAAmN;QACpN,gBAAgB,EAAE,QAAQ;KAC1B;IACD;QACC,UAAU,EAAE,iBAAiB;QAC7B,KAAK,EAAE,aAAa;QACpB,QAAQ,EACP,iHAAiH;QAClH,gBAAgB,EAAE,iBAAiB;KACnC;CACD,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,UAAkB,EAAwB;IACjF,OAAO,CACN,gCAAgC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,KAAK,UAAU,CAAC,IAAI;QACpF,UAAU;QACV,KAAK,EAAE,aAAa;QACpB,QAAQ,EAAE,aAAa,UAAU,gLAAgL;KACjN,CACD,CAAC;AAAA,CACF;AAED,4FAA4F;AAC5F,MAAM,UAAU,uBAAuB,CAAC,UAAkB,EAAE,MAAc,EAAE,GAAY,EAAW;IAClG,IAAI,UAAU,KAAK,gBAAgB,IAAI,UAAU,KAAK,cAAc,IAAI,GAAG,KAAK,wBAAwB;QACvG,OAAO,KAAK,CAAC;IACd,OAAO,CAAC,UAAU,KAAK,WAAW,IAAI,GAAG,KAAK,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;AAAA,CACtG","sourcesContent":["/** Product auth capabilities, independent of protocol adapter registration. */\nexport interface ProviderAuthContract {\n\tproviderId: string;\n\toauth: \"validated\" | \"unvalidated\" | \"unsupported\";\n\tguidance: string;\n\tapiKeyProviderId?: string;\n}\n\n/** No copied model OAuth client has been validated for this distribution. */\nexport const BUILT_IN_PROVIDER_AUTH_CONTRACTS: readonly ProviderAuthContract[] = [\n\t{\n\t\tproviderId: \"anthropic\",\n\t\toauth: \"unvalidated\",\n\t\tguidance:\n\t\t\t\"Anthropic subscription OAuth is unavailable in Base Context: its client identity has not been validated for this distribution. Use Anthropic API-key login or ANTHROPIC_API_KEY instead.\",\n\t\tapiKeyProviderId: \"anthropic\",\n\t},\n\t{\n\t\tproviderId: \"github-copilot\",\n\t\toauth: \"unvalidated\",\n\t\tguidance:\n\t\t\t\"GitHub Copilot authentication is unavailable in Base Context: the copied client identity has not been validated for this distribution. Use an API-key provider such as openai or anthropic instead.\",\n\t\tapiKeyProviderId: \"openai\",\n\t},\n\t{\n\t\tproviderId: \"openai-codex\",\n\t\toauth: \"unvalidated\",\n\t\tguidance:\n\t\t\t\"OpenAI Codex subscription OAuth is unavailable in Base Context: its client identity has not been validated for this distribution. For API-key inference, select the openai provider and configure OPENAI_API_KEY.\",\n\t\tapiKeyProviderId: \"openai\",\n\t},\n\t{\n\t\tproviderId: \"prime-inference\",\n\t\toauth: \"unsupported\",\n\t\tguidance:\n\t\t\t\"Prime browser login is unavailable in Base Context. Use Prime Inference API-key login or PRIME_API_KEY instead.\",\n\t\tapiKeyProviderId: \"prime-inference\",\n\t},\n];\n\nexport function getProviderAuthContract(providerId: string): ProviderAuthContract {\n\treturn (\n\t\tBUILT_IN_PROVIDER_AUTH_CONTRACTS.find((entry) => entry.providerId === providerId) ?? {\n\t\t\tproviderId,\n\t\t\toauth: \"unvalidated\",\n\t\t\tguidance: `OAuth for ${providerId} is unavailable in Base Context until its provider contract is validated. Local registration is not validation. Use a supported API-key or bearer-token configuration instead.`,\n\t\t}\n\t);\n}\n\n/** Pasting a subscription token into an API-key field does not validate its OAuth route. */\nexport function isProviderApiKeyAllowed(providerId: string, apiKey: string, api?: string): boolean {\n\tif (providerId === \"github-copilot\" || providerId === \"openai-codex\" || api === \"openai-codex-responses\")\n\t\treturn false;\n\treturn (providerId !== \"anthropic\" && api !== \"anthropic-messages\") || !apiKey.includes(\"sk-ant-oat\");\n}\n"]}
+{"version":3,"file":"provider-contracts.js","sourceRoot":"","sources":["../../src/core/provider-contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAUvE,MAAM,UAAU,uBAAuB,CAAC,UAAkB,EAAwB;IACjF,IAAI,UAAU,KAAK,OAAO,IAAI,UAAU,KAAK,iBAAiB,EAAE,CAAC;QAChE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,kDAAkD,EAAE,CAAC;IAC3G,CAAC;IACD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC9C,OAAO;QACN,UAAU;QACV,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa;QAC7C,QAAQ,EAAE,QAAQ;YACjB,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC;gBAC9B,CAAC,CAAC,kBAAkB,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,QAAQ,CAAC,IAAI,GAAG;gBACtE,CAAC,CAAC,mCAAmC,QAAQ,CAAC,IAAI,oCAAoC;YACvF,CAAC,CAAC,sCAAsC,UAAU,iEAAiE;KACpH,CAAC;AAAA,CACF;AAED,MAAM,CAAC,MAAM,gCAAgC,GAAoC;IAChF,WAAW;IACX,gBAAgB;IAChB,cAAc;IACd,iBAAiB;CACjB,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAE/B,yDAAyD;AACzD,MAAM,UAAU,uBAAuB,CAAC,UAAkB,EAAE,OAAe,EAAE,GAAY,EAAW;IACnG,OAAO,CACN,UAAU,KAAK,OAAO;QACtB,UAAU,KAAK,iBAAiB;QAChC,UAAU,KAAK,cAAc;QAC7B,GAAG,KAAK,wBAAwB,CAChC,CAAC;AAAA,CACF","sourcesContent":["import { getOAuthProvider } from \"@ponythewhite/base-context-ai/oauth\";\n\n/** Supported adapters, not a claim of provider endorsement or live account validation. */\nexport interface ProviderAuthContract {\n\tproviderId: string;\n\toauth: \"supported\" | \"unsupported\";\n\tguidance: string;\n\tapiKeyProviderId?: string;\n}\n\nexport function getProviderAuthContract(providerId: string): ProviderAuthContract {\n\tif (providerId === \"prime\" || providerId === \"prime-intellect\") {\n\t\treturn { providerId, oauth: \"unsupported\", guidance: \"Prime integrations are disabled in Base Context.\" };\n\t}\n\tconst provider = getOAuthProvider(providerId);\n\treturn {\n\t\tproviderId,\n\t\toauth: provider ? \"supported\" : \"unsupported\",\n\t\tguidance: provider\n\t\t\t? providerId.startsWith(\"mcp:\")\n\t\t\t\t? `Use /mcp login ${providerId.slice(4)} to connect ${provider.name}.`\n\t\t\t\t: `Use /login to authenticate with ${provider.name}, then select a model with /model.`\n\t\t\t: `No OAuth adapter is registered for ${providerId}. Configure a supported provider or register its OAuth adapter.`,\n\t};\n}\n\nexport const BUILT_IN_PROVIDER_AUTH_CONTRACTS: readonly ProviderAuthContract[] = [\n\t\"anthropic\",\n\t\"github-copilot\",\n\t\"openai-codex\",\n\t\"prime-intellect\",\n].map(getProviderAuthContract);\n\n/** Codex uses OAuth credentials, not OpenAI API keys. */\nexport function isProviderApiKeyAllowed(providerId: string, _apiKey: string, api?: string): boolean {\n\treturn (\n\t\tproviderId !== \"prime\" &&\n\t\tproviderId !== \"prime-intellect\" &&\n\t\tproviderId !== \"openai-codex\" &&\n\t\tapi !== \"openai-codex-responses\"\n\t);\n}\n"]}

package/dist/core/provider-display-names.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider-display-names.d.ts","sourceRoot":"","sources":["../../src/core/provider-display-names.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAgClE,CAAC","sourcesContent":["export const BUILT_IN_PROVIDER_DISPLAY_NAMES: Record<string, string> = {\n\tanthropic: \"Anthropic\",\n\t\"amazon-bedrock\": \"Amazon Bedrock\",\n\t\"azure-openai-responses\": \"Azure OpenAI Responses\",\n\tcerebras: \"Cerebras\",\n\t\"cloudflare-ai-gateway\": \"Cloudflare AI Gateway\",\n\t\"cloudflare-workers-ai\": \"Cloudflare Workers AI\",\n\tdeepseek: \"DeepSeek\",\n\tfireworks: \"Fireworks\",\n\tgoogle: \"Google Gemini\",\n\t\"google-vertex\": \"Google Vertex AI\",\n\tgroq: \"Groq\",\n\thuggingface: \"Hugging Face\",\n\t\"kimi-coding\": \"Kimi For Coding\",\n\tmistral: \"Mistral\",\n\tminimax: \"MiniMax\",\n\t\"minimax-cn\": \"MiniMax (China)\",\n\tmoonshotai: \"Moonshot AI\",\n\t\"moonshotai-cn\": \"Moonshot AI (China)\",\n\topencode: \"OpenCode Zen\",\n\t\"opencode-go\": \"OpenCode Go\",\n\topenai: \"OpenAI\",\n\topenrouter: \"OpenRouter\",\n\t\"base-context-traces\": \"Base Context Traces\",\n\t\"prime-inference\": \"Prime Inference\",\n\t\"vercel-ai-gateway\": \"Vercel AI Gateway\",\n\txai: \"xAI\",\n\tzai: \"ZAI\",\n\txiaomi: \"Xiaomi MiMo\",\n\t\"xiaomi-token-plan-cn\": \"Xiaomi MiMo Token Plan (China)\",\n\t\"xiaomi-token-plan-ams\": \"Xiaomi MiMo Token Plan (Amsterdam)\",\n\t\"xiaomi-token-plan-sgp\": \"Xiaomi MiMo Token Plan (Singapore)\",\n};\n"]}
+{"version":3,"file":"provider-display-names.d.ts","sourceRoot":"","sources":["../../src/core/provider-display-names.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,+BAA+B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA8BlE,CAAC","sourcesContent":["export const BUILT_IN_PROVIDER_DISPLAY_NAMES: Record<string, string> = {\n\tanthropic: \"Anthropic\",\n\t\"amazon-bedrock\": \"Amazon Bedrock\",\n\t\"azure-openai-responses\": \"Azure OpenAI Responses\",\n\tcerebras: \"Cerebras\",\n\t\"cloudflare-ai-gateway\": \"Cloudflare AI Gateway\",\n\t\"cloudflare-workers-ai\": \"Cloudflare Workers AI\",\n\tdeepseek: \"DeepSeek\",\n\tfireworks: \"Fireworks\",\n\tgoogle: \"Google Gemini\",\n\t\"google-vertex\": \"Google Vertex AI\",\n\tgroq: \"Groq\",\n\thuggingface: \"Hugging Face\",\n\t\"kimi-coding\": \"Kimi For Coding\",\n\tmistral: \"Mistral\",\n\tminimax: \"MiniMax\",\n\t\"minimax-cn\": \"MiniMax (China)\",\n\tmoonshotai: \"Moonshot AI\",\n\t\"moonshotai-cn\": \"Moonshot AI (China)\",\n\topencode: \"OpenCode Zen\",\n\t\"opencode-go\": \"OpenCode Go\",\n\topenai: \"OpenAI\",\n\topenrouter: \"OpenRouter\",\n\t\"vercel-ai-gateway\": \"Vercel AI Gateway\",\n\txai: \"xAI\",\n\tzai: \"ZAI\",\n\txiaomi: \"Xiaomi MiMo\",\n\t\"xiaomi-token-plan-cn\": \"Xiaomi MiMo Token Plan (China)\",\n\t\"xiaomi-token-plan-ams\": \"Xiaomi MiMo Token Plan (Amsterdam)\",\n\t\"xiaomi-token-plan-sgp\": \"Xiaomi MiMo Token Plan (Singapore)\",\n};\n"]}

package/dist/core/provider-display-names.js

@@ -21,8 +21,6 @@ export const BUILT_IN_PROVIDER_DISPLAY_NAMES = {
     "opencode-go": "OpenCode Go",
     openai: "OpenAI",
     openrouter: "OpenRouter",
-    "base-context-traces": "Base Context Traces",
-    "prime-inference": "Prime Inference",
     "vercel-ai-gateway": "Vercel AI Gateway",
     xai: "xAI",
     zai: "ZAI",

package/dist/core/provider-display-names.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-display-names.js","sourceRoot":"","sources":["../../src/core/provider-display-names.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,+BAA+B,GAA2B;IACtE,SAAS,EAAE,WAAW;IACtB,gBAAgB,EAAE,gBAAgB;IAClC,wBAAwB,EAAE,wBAAwB;IAClD,QAAQ,EAAE,UAAU;IACpB,uBAAuB,EAAE,uBAAuB;IAChD,uBAAuB,EAAE,uBAAuB;IAChD,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,eAAe;IACvB,eAAe,EAAE,kBAAkB;IACnC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,cAAc;IAC3B,aAAa,EAAE,iBAAiB;IAChC,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,YAAY,EAAE,iBAAiB;IAC/B,UAAU,EAAE,aAAa;IACzB,eAAe,EAAE,qBAAqB;IACtC,QAAQ,EAAE,cAAc;IACxB,aAAa,EAAE,aAAa;IAC5B,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE,YAAY;IACxB,qBAAqB,EAAE,qBAAqB;IAC5C,iBAAiB,EAAE,iBAAiB;IACpC,mBAAmB,EAAE,mBAAmB;IACxC,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,MAAM,EAAE,aAAa;IACrB,sBAAsB,EAAE,gCAAgC;IACxD,uBAAuB,EAAE,oCAAoC;IAC7D,uBAAuB,EAAE,oCAAoC;CAC7D,CAAC","sourcesContent":["export const BUILT_IN_PROVIDER_DISPLAY_NAMES: Record<string, string> = {\n\tanthropic: \"Anthropic\",\n\t\"amazon-bedrock\": \"Amazon Bedrock\",\n\t\"azure-openai-responses\": \"Azure OpenAI Responses\",\n\tcerebras: \"Cerebras\",\n\t\"cloudflare-ai-gateway\": \"Cloudflare AI Gateway\",\n\t\"cloudflare-workers-ai\": \"Cloudflare Workers AI\",\n\tdeepseek: \"DeepSeek\",\n\tfireworks: \"Fireworks\",\n\tgoogle: \"Google Gemini\",\n\t\"google-vertex\": \"Google Vertex AI\",\n\tgroq: \"Groq\",\n\thuggingface: \"Hugging Face\",\n\t\"kimi-coding\": \"Kimi For Coding\",\n\tmistral: \"Mistral\",\n\tminimax: \"MiniMax\",\n\t\"minimax-cn\": \"MiniMax (China)\",\n\tmoonshotai: \"Moonshot AI\",\n\t\"moonshotai-cn\": \"Moonshot AI (China)\",\n\topencode: \"OpenCode Zen\",\n\t\"opencode-go\": \"OpenCode Go\",\n\topenai: \"OpenAI\",\n\topenrouter: \"OpenRouter\",\n\t\"base-context-traces\": \"Base Context Traces\",\n\t\"prime-inference\": \"Prime Inference\",\n\t\"vercel-ai-gateway\": \"Vercel AI Gateway\",\n\txai: \"xAI\",\n\tzai: \"ZAI\",\n\txiaomi: \"Xiaomi MiMo\",\n\t\"xiaomi-token-plan-cn\": \"Xiaomi MiMo Token Plan (China)\",\n\t\"xiaomi-token-plan-ams\": \"Xiaomi MiMo Token Plan (Amsterdam)\",\n\t\"xiaomi-token-plan-sgp\": \"Xiaomi MiMo Token Plan (Singapore)\",\n};\n"]}
+{"version":3,"file":"provider-display-names.js","sourceRoot":"","sources":["../../src/core/provider-display-names.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,+BAA+B,GAA2B;IACtE,SAAS,EAAE,WAAW;IACtB,gBAAgB,EAAE,gBAAgB;IAClC,wBAAwB,EAAE,wBAAwB;IAClD,QAAQ,EAAE,UAAU;IACpB,uBAAuB,EAAE,uBAAuB;IAChD,uBAAuB,EAAE,uBAAuB;IAChD,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,eAAe;IACvB,eAAe,EAAE,kBAAkB;IACnC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,cAAc;IAC3B,aAAa,EAAE,iBAAiB;IAChC,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,YAAY,EAAE,iBAAiB;IAC/B,UAAU,EAAE,aAAa;IACzB,eAAe,EAAE,qBAAqB;IACtC,QAAQ,EAAE,cAAc;IACxB,aAAa,EAAE,aAAa;IAC5B,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE,YAAY;IACxB,mBAAmB,EAAE,mBAAmB;IACxC,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,MAAM,EAAE,aAAa;IACrB,sBAAsB,EAAE,gCAAgC;IACxD,uBAAuB,EAAE,oCAAoC;IAC7D,uBAAuB,EAAE,oCAAoC;CAC7D,CAAC","sourcesContent":["export const BUILT_IN_PROVIDER_DISPLAY_NAMES: Record<string, string> = {\n\tanthropic: \"Anthropic\",\n\t\"amazon-bedrock\": \"Amazon Bedrock\",\n\t\"azure-openai-responses\": \"Azure OpenAI Responses\",\n\tcerebras: \"Cerebras\",\n\t\"cloudflare-ai-gateway\": \"Cloudflare AI Gateway\",\n\t\"cloudflare-workers-ai\": \"Cloudflare Workers AI\",\n\tdeepseek: \"DeepSeek\",\n\tfireworks: \"Fireworks\",\n\tgoogle: \"Google Gemini\",\n\t\"google-vertex\": \"Google Vertex AI\",\n\tgroq: \"Groq\",\n\thuggingface: \"Hugging Face\",\n\t\"kimi-coding\": \"Kimi For Coding\",\n\tmistral: \"Mistral\",\n\tminimax: \"MiniMax\",\n\t\"minimax-cn\": \"MiniMax (China)\",\n\tmoonshotai: \"Moonshot AI\",\n\t\"moonshotai-cn\": \"Moonshot AI (China)\",\n\topencode: \"OpenCode Zen\",\n\t\"opencode-go\": \"OpenCode Go\",\n\topenai: \"OpenAI\",\n\topenrouter: \"OpenRouter\",\n\t\"vercel-ai-gateway\": \"Vercel AI Gateway\",\n\txai: \"xAI\",\n\tzai: \"ZAI\",\n\txiaomi: \"Xiaomi MiMo\",\n\t\"xiaomi-token-plan-cn\": \"Xiaomi MiMo Token Plan (China)\",\n\t\"xiaomi-token-plan-ams\": \"Xiaomi MiMo Token Plan (Amsterdam)\",\n\t\"xiaomi-token-plan-sgp\": \"Xiaomi MiMo Token Plan (Singapore)\",\n};\n"]}

package/dist/core/rlm-max-subagents.d.ts

@@ -0,0 +1,32 @@
+import type { AgentSession } from "./agent-session.js";
+import type { SettingsManager } from "./settings-manager.js";
+export declare const DEFAULT_RLM_MAX_SUBAGENTS = 4;
+export interface RlmMaxSubagentsStatus {
+    maxSubagents: number;
+}
+export declare function assertRlmMaxSubagents(value: number): void;
+export interface RlmSubagentCapacityReservation {
+    release(): Promise<void>;
+}
+/** A hosted root may itself be a resumed subagent. Bind before constructor setup can fail. */
+export interface RlmRootAdmission extends RlmSubagentCapacityReservation {
+    readonly session: AgentSession | undefined;
+    bind(session: AgentSession): void;
+}
+/** One shared admission authority for a root family, including pending creations. */
+export interface RlmSubagentCapacity {
+    getStatus(): Promise<RlmMaxSubagentsStatus>;
+    setMaxSubagents(maxSubagents: number): Promise<RlmMaxSubagentsStatus>;
+    reserve(): Promise<RlmSubagentCapacityReservation>;
+}
+export declare class LocalRlmSubagentCapacity implements RlmSubagentCapacity {
+    private readonly settings;
+    private maxSubagents;
+    private readonly reservations;
+    private changes;
+    constructor(settings: SettingsManager);
+    getStatus(): Promise<RlmMaxSubagentsStatus>;
+    setMaxSubagents(maxSubagents: number): Promise<RlmMaxSubagentsStatus>;
+    reserve(): Promise<RlmSubagentCapacityReservation>;
+}
+//# sourceMappingURL=rlm-max-subagents.d.ts.map

package/dist/core/rlm-max-subagents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rlm-max-subagents.d.ts","sourceRoot":"","sources":["../../src/core/rlm-max-subagents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,MAAM,WAAW,qBAAqB;IACrC,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAIzD;AAED,MAAM,WAAW,8BAA8B;IAC9C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,8FAA8F;AAC9F,MAAM,WAAW,gBAAiB,SAAQ,8BAA8B;IACvE,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,CAAC;IAC3C,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;CAClC;AAED,qFAAqF;AACrF,MAAM,WAAW,mBAAmB;IACnC,SAAS,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC5C,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IACtE,OAAO,IAAI,OAAO,CAAC,8BAA8B,CAAC,CAAC;CACnD;AAED,qBAAa,wBAAyB,YAAW,mBAAmB;IAKvD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJrC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,OAAO,CAAuC;IAEtD,YAA6B,QAAQ,EAAE,eAAe,EAErD;IAEK,SAAS,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAEhD;IAED,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAgBpE;IAEK,OAAO,IAAI,OAAO,CAAC,8BAA8B,CAAC,CAavD;CACD","sourcesContent":["import type { AgentSession } from \"./agent-session.js\";\nimport type { SettingsManager } from \"./settings-manager.js\";\n\nexport const DEFAULT_RLM_MAX_SUBAGENTS = 4;\n\nexport interface RlmMaxSubagentsStatus {\n\tmaxSubagents: number;\n}\n\nexport function assertRlmMaxSubagents(value: number): void {\n\tif (!Number.isSafeInteger(value) || value < 0) {\n\t\tthrow new Error(\"The maximum number of concurrent subagents must be a non-negative safe integer.\");\n\t}\n}\n\nexport interface RlmSubagentCapacityReservation {\n\trelease(): Promise<void>;\n}\n\n/** A hosted root may itself be a resumed subagent. Bind before constructor setup can fail. */\nexport interface RlmRootAdmission extends RlmSubagentCapacityReservation {\n\treadonly session: AgentSession | undefined;\n\tbind(session: AgentSession): void;\n}\n\n/** One shared admission authority for a root family, including pending creations. */\nexport interface RlmSubagentCapacity {\n\tgetStatus(): Promise<RlmMaxSubagentsStatus>;\n\tsetMaxSubagents(maxSubagents: number): Promise<RlmMaxSubagentsStatus>;\n\treserve(): Promise<RlmSubagentCapacityReservation>;\n}\n\nexport class LocalRlmSubagentCapacity implements RlmSubagentCapacity {\n\tprivate maxSubagents: number;\n\tprivate readonly reservations = new Set<symbol>();\n\tprivate changes: Promise<unknown> = Promise.resolve();\n\n\tconstructor(private readonly settings: SettingsManager) {\n\t\tthis.maxSubagents = settings.getRlmMaxSubagents();\n\t}\n\n\tasync getStatus(): Promise<RlmMaxSubagentsStatus> {\n\t\treturn { maxSubagents: this.maxSubagents };\n\t}\n\n\tsetMaxSubagents(maxSubagents: number): Promise<RlmMaxSubagentsStatus> {\n\t\tassertRlmMaxSubagents(maxSubagents);\n\t\tconst change = this.changes.then(async () => {\n\t\t\tawait this.settings.flush();\n\t\t\tfor (const { error } of this.settings.drainErrors(\"global\")) {\n\t\t\t\tconsole.warn(`Warning: Earlier global settings write failed: ${error.message}`);\n\t\t\t}\n\t\t\tthis.settings.setRlmMaxSubagents(maxSubagents);\n\t\t\tawait this.settings.flush();\n\t\t\tconst errors = this.settings.drainErrors(\"global\");\n\t\t\tif (errors.length > 0) throw new Error(errors.map(({ error }) => error.message).join(\"; \"));\n\t\t\tthis.maxSubagents = maxSubagents;\n\t\t\treturn this.getStatus();\n\t\t});\n\t\tthis.changes = change.catch(() => undefined);\n\t\treturn change;\n\t}\n\n\tasync reserve(): Promise<RlmSubagentCapacityReservation> {\n\t\tif (this.reservations.size >= this.maxSubagents) {\n\t\t\tthrow new Error(\n\t\t\t\t`RLM resident child limit reached (maximum ${this.maxSubagents} concurrent subagents); dispose or passivate an existing child first`,\n\t\t\t);\n\t\t}\n\t\tconst token = Symbol();\n\t\tthis.reservations.add(token);\n\t\treturn {\n\t\t\trelease: async () => {\n\t\t\t\tthis.reservations.delete(token);\n\t\t\t},\n\t\t};\n\t}\n}\n"]}

package/dist/core/rlm-max-subagents.js

@@ -0,0 +1,50 @@
+export const DEFAULT_RLM_MAX_SUBAGENTS = 4;
+export function assertRlmMaxSubagents(value) {
+    if (!Number.isSafeInteger(value) || value < 0) {
+        throw new Error("The maximum number of concurrent subagents must be a non-negative safe integer.");
+    }
+}
+export class LocalRlmSubagentCapacity {
+    settings;
+    maxSubagents;
+    reservations = new Set();
+    changes = Promise.resolve();
+    constructor(settings) {
+        this.settings = settings;
+        this.maxSubagents = settings.getRlmMaxSubagents();
+    }
+    async getStatus() {
+        return { maxSubagents: this.maxSubagents };
+    }
+    setMaxSubagents(maxSubagents) {
+        assertRlmMaxSubagents(maxSubagents);
+        const change = this.changes.then(async () => {
+            await this.settings.flush();
+            for (const { error } of this.settings.drainErrors("global")) {
+                console.warn(`Warning: Earlier global settings write failed: ${error.message}`);
+            }
+            this.settings.setRlmMaxSubagents(maxSubagents);
+            await this.settings.flush();
+            const errors = this.settings.drainErrors("global");
+            if (errors.length > 0)
+                throw new Error(errors.map(({ error }) => error.message).join("; "));
+            this.maxSubagents = maxSubagents;
+            return this.getStatus();
+        });
+        this.changes = change.catch(() => undefined);
+        return change;
+    }
+    async reserve() {
+        if (this.reservations.size >= this.maxSubagents) {
+            throw new Error(`RLM resident child limit reached (maximum ${this.maxSubagents} concurrent subagents); dispose or passivate an existing child first`);
+        }
+        const token = Symbol();
+        this.reservations.add(token);
+        return {
+            release: async () => {
+                this.reservations.delete(token);
+            },
+        };
+    }
+}
+//# sourceMappingURL=rlm-max-subagents.js.map

package/dist/core/rlm-max-subagents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rlm-max-subagents.js","sourceRoot":"","sources":["../../src/core/rlm-max-subagents.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAM3C,MAAM,UAAU,qBAAqB,CAAC,KAAa,EAAQ;IAC1D,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAC;IACpG,CAAC;AAAA,CACD;AAmBD,MAAM,OAAO,wBAAwB;IAKP,QAAQ;IAJ7B,YAAY,CAAS;IACZ,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IAC1C,OAAO,GAAqB,OAAO,CAAC,OAAO,EAAE,CAAC;IAEtD,YAA6B,QAAyB,EAAE;wBAA3B,QAAQ;QACpC,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC,kBAAkB,EAAE,CAAC;IAAA,CAClD;IAED,KAAK,CAAC,SAAS,GAAmC;QACjD,OAAO,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;IAAA,CAC3C;IAED,eAAe,CAAC,YAAoB,EAAkC;QACrE,qBAAqB,CAAC,YAAY,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YAC5C,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YAC5B,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC7D,OAAO,CAAC,IAAI,CAAC,kDAAkD,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACjF,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC;YAC/C,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YACnD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC5F,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;YACjC,OAAO,IAAI,CAAC,SAAS,EAAE,CAAC;QAAA,CACxB,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC7C,OAAO,MAAM,CAAC;IAAA,CACd;IAED,KAAK,CAAC,OAAO,GAA4C;QACxD,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACjD,MAAM,IAAI,KAAK,CACd,6CAA6C,IAAI,CAAC,YAAY,sEAAsE,CACpI,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC7B,OAAO;YACN,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;gBACpB,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAAA,CAChC;SACD,CAAC;IAAA,CACF;CACD","sourcesContent":["import type { AgentSession } from \"./agent-session.js\";\nimport type { SettingsManager } from \"./settings-manager.js\";\n\nexport const DEFAULT_RLM_MAX_SUBAGENTS = 4;\n\nexport interface RlmMaxSubagentsStatus {\n\tmaxSubagents: number;\n}\n\nexport function assertRlmMaxSubagents(value: number): void {\n\tif (!Number.isSafeInteger(value) || value < 0) {\n\t\tthrow new Error(\"The maximum number of concurrent subagents must be a non-negative safe integer.\");\n\t}\n}\n\nexport interface RlmSubagentCapacityReservation {\n\trelease(): Promise<void>;\n}\n\n/** A hosted root may itself be a resumed subagent. Bind before constructor setup can fail. */\nexport interface RlmRootAdmission extends RlmSubagentCapacityReservation {\n\treadonly session: AgentSession | undefined;\n\tbind(session: AgentSession): void;\n}\n\n/** One shared admission authority for a root family, including pending creations. */\nexport interface RlmSubagentCapacity {\n\tgetStatus(): Promise<RlmMaxSubagentsStatus>;\n\tsetMaxSubagents(maxSubagents: number): Promise<RlmMaxSubagentsStatus>;\n\treserve(): Promise<RlmSubagentCapacityReservation>;\n}\n\nexport class LocalRlmSubagentCapacity implements RlmSubagentCapacity {\n\tprivate maxSubagents: number;\n\tprivate readonly reservations = new Set<symbol>();\n\tprivate changes: Promise<unknown> = Promise.resolve();\n\n\tconstructor(private readonly settings: SettingsManager) {\n\t\tthis.maxSubagents = settings.getRlmMaxSubagents();\n\t}\n\n\tasync getStatus(): Promise<RlmMaxSubagentsStatus> {\n\t\treturn { maxSubagents: this.maxSubagents };\n\t}\n\n\tsetMaxSubagents(maxSubagents: number): Promise<RlmMaxSubagentsStatus> {\n\t\tassertRlmMaxSubagents(maxSubagents);\n\t\tconst change = this.changes.then(async () => {\n\t\t\tawait this.settings.flush();\n\t\t\tfor (const { error } of this.settings.drainErrors(\"global\")) {\n\t\t\t\tconsole.warn(`Warning: Earlier global settings write failed: ${error.message}`);\n\t\t\t}\n\t\t\tthis.settings.setRlmMaxSubagents(maxSubagents);\n\t\t\tawait this.settings.flush();\n\t\t\tconst errors = this.settings.drainErrors(\"global\");\n\t\t\tif (errors.length > 0) throw new Error(errors.map(({ error }) => error.message).join(\"; \"));\n\t\t\tthis.maxSubagents = maxSubagents;\n\t\t\treturn this.getStatus();\n\t\t});\n\t\tthis.changes = change.catch(() => undefined);\n\t\treturn change;\n\t}\n\n\tasync reserve(): Promise<RlmSubagentCapacityReservation> {\n\t\tif (this.reservations.size >= this.maxSubagents) {\n\t\t\tthrow new Error(\n\t\t\t\t`RLM resident child limit reached (maximum ${this.maxSubagents} concurrent subagents); dispose or passivate an existing child first`,\n\t\t\t);\n\t\t}\n\t\tconst token = Symbol();\n\t\tthis.reservations.add(token);\n\t\treturn {\n\t\t\trelease: async () => {\n\t\t\t\tthis.reservations.delete(token);\n\t\t\t},\n\t\t};\n\t}\n}\n"]}

package/dist/core/rlm-runtime.d.ts

@@ -60,7 +60,7 @@ export declare function createRlmFindModelsHostHandler(handler: RlmFindModelsHan
 export declare function createRlmListSubagentsHostHandler(handler: RlmListSubagentsHandler): HostRequestHandler;
 /** Delete one direct child selected from the current parent session's registry. */
 export declare function createRlmDeleteSubagentHostHandler(handler: RlmDeleteSubagentHandler): HostRequestHandler;
-/** One live parent's pending setup or resident child. Not a tree-wide reservation. */
+/** A parent-owned setup or resident child, charged to its root-family capacity. */
 export interface RlmChildAdmission {
     readonly parent: AgentSession;
     readonly session: AgentSession | undefined;
@@ -70,8 +70,8 @@ export interface RlmChildAdmission {
     bind(session: AgentSession): void;
     beginSetup(): void;
     claimFactory(): void;
-    confirmUnboundCleanup(): void;
-    settle(): void;
+    confirmUnboundCleanup(): Promise<void>;
+    settle(): Promise<void>;
 }
 export interface RlmSubagentRuntime {
     session: AgentSession;

package/dist/core/rlm-runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rlm-runtime.d.ts","sourceRoot":"","sources":["../../src/core/rlm-runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ThinkingLevel } from \"@ponythewhite/base-context-agent\";\nimport type { Api, Model, RequestTokenBudgetOptions, ServiceTier } from \"@ponythewhite/base-context-ai\";\nimport type { AgentSession } from \"./agent-session.js\";\nimport type { ToolDefinition } from \"./extensions/index.js\";\nimport type { HostRequestHandler } from \"./kernel/index.js\";\nimport { THINKING_LEVELS } from \"./thinking-levels.js\";\n\n/** Request emitted by `rlm.run`; cellSourceCode preserves the spawning cell for display. */\nexport interface RlmRunRequest {\n\tprompt: string;\n\tkwargs: Record<string, unknown>;\n\tcellSourceCode?: string;\n}\n\nexport interface RlmSpawnHandle {\n\trlm_child_id: string;\n\tname: string;\n\tsession_dir: string;\n\tmodel: string;\n}\n\nexport type RlmSubagentRegistryStatus = \"running\" | \"completed\" | \"error\";\n\nexport interface RlmSubagentRegistryEntry {\n\trlm_child_id: string;\n\tactive_session_id: string | null;\n\tsession_id: string | null;\n\tsession_name: string;\n\tsession_dir: string;\n\tstatus: RlmSubagentRegistryStatus;\n}\n\nexport interface RlmListSubagentsResult {\n\tsubagents: RlmSubagentRegistryEntry[];\n}\n\nexport interface RlmDeleteSubagentResult {\n\tsubagent: RlmSubagentRegistryEntry;\n\toutcome?: \"deleted\" | \"skipped_running\";\n}\n\nexport interface RlmModelMatch {\n\tprovider: string;\n\tid: string;\n\tname: string;\n\tselector: string;\n}\n\nexport interface RlmFindModelsResult {\n\tmodels: RlmModelMatch[];\n}\n\nexport type RlmRunHandler = (request: RlmRunRequest) => Promise<Record<string, unknown>>;\nexport type RlmListSubagentsHandler = () => RlmListSubagentsResult | Promise<RlmListSubagentsResult>;\nexport type RlmDeleteSubagentHandler = (target: string) => Promise<RlmDeleteSubagentResult>;\nexport type RlmFindModelsHandler = (query: string, limit: number) => RlmFindModelsResult | Promise<RlmFindModelsResult>;\n\nconst RLM_SUBAGENT_SESSION_NAME_MAX_LENGTH = 64;\nexport const DEFAULT_RLM_MODEL_SEARCH_LIMIT = 8;\nexport const MAX_RLM_MODEL_SEARCH_LIMIT = 20;\n\nexport function normalizeRequestedRlmSubagentSessionName(value: unknown): string | undefined {\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tif (typeof value !== \"string\") {\n\t\tthrow new Error(\"rlm.run name must be a string\");\n\t}\n\tconst name = value.trim();\n\tif (!name) {\n\t\tthrow new Error(\"rlm.run name must not be empty\");\n\t}\n\tif (name.length > RLM_SUBAGENT_SESSION_NAME_MAX_LENGTH) {\n\t\tthrow new Error(`rlm.run name must be at most ${RLM_SUBAGENT_SESSION_NAME_MAX_LENGTH} characters`);\n\t}\n\treturn name;\n}\n\nexport function normalizeRequestedRlmSubagentThinkingLevel(value: unknown): ThinkingLevel | undefined {\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tif (typeof value !== \"string\") {\n\t\tthrow new Error(\"rlm.run thinking must be a string\");\n\t}\n\tconst level = value.trim().toLowerCase();\n\tif (!THINKING_LEVELS.includes(level as ThinkingLevel)) {\n\t\tthrow new Error(`rlm.run thinking must be one of: ${THINKING_LEVELS.join(\", \")}`);\n\t}\n\treturn level as ThinkingLevel;\n}\n\nexport function normalizeRequestedRlmSubagentModel(value: unknown): string | undefined {\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tif (typeof value !== \"string\") {\n\t\tthrow new Error(\"rlm.run model must be a string\");\n\t}\n\tconst model = value.trim();\n\tif (!model) {\n\t\tthrow new Error(\"rlm.run model must not be empty\");\n\t}\n\treturn model;\n}\n\n/** Create a readable, collision-resistant default name usable as an agent-message selector. */\nexport function createDefaultRlmSubagentSessionName(prompt: string, childId: string): string {\n\tconst promptSlug = prompt\n\t\t.normalize(\"NFKD\")\n\t\t.replace(/[\\u0300-\\u036f]/g, \"\")\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9]+/g, \"-\")\n\t\t.replace(/^-+|-+$/g, \"\");\n\tconst idSuffix =\n\t\tchildId\n\t\t\t.replace(/^sub-/, \"\")\n\t\t\t.replace(/[^A-Za-z0-9]+/g, \"\")\n\t\t\t.slice(-8) || \"child\";\n\tconst fixedLength = \"subagent--\".length + idSuffix.length;\n\tconst promptPart = (promptSlug || \"worker\")\n\t\t.slice(0, Math.max(1, RLM_SUBAGENT_SESSION_NAME_MAX_LENGTH - fixedLength))\n\t\t.replace(/-+$/g, \"\");\n\treturn `subagent-${promptPart || \"worker\"}-${idSuffix}`;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction normalizeModelSearchText(value: string): string {\n\treturn value.toLowerCase().replace(/[^a-z0-9]+/g, \"\");\n}\n\nexport function findRlmModelMatches(query: string, models: Model<Api>[], limit: number): RlmModelMatch[] {\n\tconst normalizedQuery = normalizeModelSearchText(query.trim());\n\treturn models\n\t\t.map((model) => {\n\t\t\tconst selector = `${model.provider}/${model.id}`;\n\t\t\tconst fields = [selector, model.id, model.name || model.id];\n\t\t\tconst normalizedFields = fields.map(normalizeModelSearchText);\n\t\t\tlet score = normalizedQuery ? Number.POSITIVE_INFINITY : 0;\n\t\t\tif (normalizedQuery) {\n\t\t\t\tconst exactIndex = normalizedFields.indexOf(normalizedQuery);\n\t\t\t\tconst prefixIndex = normalizedFields.findIndex((field) => field.startsWith(normalizedQuery));\n\t\t\t\tconst partialIndex = normalizedFields.findIndex((field) => field.includes(normalizedQuery));\n\t\t\t\tif (exactIndex >= 0) score = exactIndex;\n\t\t\t\telse if (prefixIndex >= 0) score = 3 + prefixIndex;\n\t\t\t\telse if (partialIndex >= 0) score = 6 + partialIndex;\n\t\t\t}\n\t\t\treturn { model, selector, score };\n\t\t})\n\t\t.filter((candidate) => Number.isFinite(candidate.score))\n\t\t.sort((a, b) => a.score - b.score || a.selector.localeCompare(b.selector))\n\t\t.slice(0, limit)\n\t\t.map(({ model, selector }) => ({\n\t\t\tprovider: model.provider,\n\t\t\tid: model.id,\n\t\t\tname: model.name || model.id,\n\t\t\tselector,\n\t\t}));\n}\n\n/** Adapt an RlmRunHandler into the typed `rlm.run` kernel host handler. */\nexport function createRlmRunHostHandler(handler: RlmRunHandler): HostRequestHandler {\n\treturn async (payload) => {\n\t\tif (typeof payload.prompt !== \"string\") {\n\t\t\tthrow new Error(\"rlm.run prompt must be a string\");\n\t\t}\n\t\tconst kwargs = isRecord(payload.kwargs) ? payload.kwargs : {};\n\t\tconst cellSourceCode = typeof payload.cellSourceCode === \"string\" ? payload.cellSourceCode : undefined;\n\t\tconst result = await handler({\n\t\t\tprompt: payload.prompt,\n\t\t\tkwargs,\n\t\t\tcellSourceCode,\n\t\t});\n\t\treturn result as unknown as Record<string, unknown>;\n\t};\n}\n\n/** Search a bounded authenticated model catalog without adding it to the system prompt. */\nexport function createRlmFindModelsHostHandler(handler: RlmFindModelsHandler): HostRequestHandler {\n\treturn async (payload) => {\n\t\tif (typeof payload.query !== \"string\") {\n\t\t\tthrow new Error(\"rlm.find_models query must be a string\");\n\t\t}\n\t\tconst limit = payload.limit === undefined ? DEFAULT_RLM_MODEL_SEARCH_LIMIT : payload.limit;\n\t\tif (!Number.isInteger(limit) || (limit as number) < 1 || (limit as number) > MAX_RLM_MODEL_SEARCH_LIMIT) {\n\t\t\tthrow new Error(`rlm.find_models limit must be an integer from 1 to ${MAX_RLM_MODEL_SEARCH_LIMIT}`);\n\t\t}\n\t\treturn { models: (await handler(payload.query, limit as number)).models };\n\t};\n}\n\n/** Expose the current parent session's direct RLM child registry to its kernel. */\nexport function createRlmListSubagentsHostHandler(handler: RlmListSubagentsHandler): HostRequestHandler {\n\treturn async () => {\n\t\tconst { subagents } = await handler();\n\t\treturn { subagents };\n\t};\n}\n\n/** Delete one direct child selected from the current parent session's registry. */\nexport function createRlmDeleteSubagentHostHandler(handler: RlmDeleteSubagentHandler): HostRequestHandler {\n\treturn async (payload) => {\n\t\tif (typeof payload.target !== \"string\" || !payload.target.trim()) {\n\t\t\tthrow new Error(\"rlm.delete_subagent target must be a non-empty string\");\n\t\t}\n\t\tconst { subagent, outcome } = await handler(payload.target.trim());\n\t\treturn outcome === undefined ? { subagent } : { subagent, outcome };\n\t};\n}\n\n/** One live parent's pending setup or resident child. Not a tree-wide reservation. */\nexport interface RlmChildAdmission {\n\treadonly parent: AgentSession;\n\treadonly session: AgentSession | undefined;\n\treadonly settlement: Promise<void>;\n\treadonly pending: boolean;\n\tassertCurrent(): void;\n\tbind(session: AgentSession): void;\n\tbeginSetup(): void;\n\tclaimFactory(): void;\n\tconfirmUnboundCleanup(): void;\n\tsettle(): void;\n}\n\nexport interface RlmSubagentRuntime {\n\tsession: AgentSession;\n}\n\nexport interface CreateRlmSubagentRuntimeOptions {\n\tparentSession: AgentSession;\n\t/** Defined trusted creation options override the inherited explicit parent policy. */\n\trequestTokenBudget?: RequestTokenBudgetOptions;\n\tcontextMode?: \"on\" | \"off\";\n\t/** The same live parent owns this setup. Native factories reserve it when omitted. */\n\tadmission?: RlmChildAdmission;\n\tid: string;\n\tprompt: string;\n\tsessionName: string;\n\tsessionDir: string;\n\tmodel: Model<any>;\n\tthinkingLevel: ThinkingLevel;\n\tserviceTier: ServiceTier;\n\tscopedModels: Array<{ model: Model<any>; thinkingLevel?: ThinkingLevel }>;\n\tactiveToolNames: string[];\n\tallowedToolNames?: string[];\n\tcustomTools: ToolDefinition[];\n\tincludeGoals: boolean;\n\tincludeCompactSkill: boolean;\n\trlmDepth: number;\n\trlmMaxDepth: number;\n\trlmParentNodeId: string;\n\t/** Request ID of the parent model call whose tool call caused this spawn. */\n\tspawnedByRequestId?: string;\n\t/** Source of the Python cell that spawned this subagent, for display. */\n\tspawnCode?: string;\n\t/** Publish the session to the parent before a host makes the runtime addressable. */\n\tonSessionPublished?: (session: AgentSession) => void;\n}\n\nexport interface SubagentRuntimeHost {\n\tcreateRlmSubagentRuntime(options: CreateRlmSubagentRuntimeOptions): Promise<RlmSubagentRuntime>;\n\t/** Persist host-owned completion before the child becomes passivation-eligible. */\n\tcompleteRlmSubagentRuntime?(childId: string, session: AgentSession): boolean;\n\t/** Release a host-owned child after its detached initial task settles. */\n\treleaseRlmSubagentRuntime?: (\n\t\truntime: RlmSubagentRuntime,\n\t\toptions: CreateRlmSubagentRuntimeOptions,\n\t\tstatus: \"done\" | \"error\" | \"cancelled\",\n\t) => Promise<void>;\n\t/** Close or remove the host-owned child; session is absent when a persisted child is still passive. */\n\tdeleteRlmSubagentRuntime(childId: string, session?: AgentSession): Promise<void>;\n\tdisposeRlmSubagentRuntimes?(): Promise<void>;\n}\n"]}
+{"version":3,"file":"rlm-runtime.d.ts","sourceRoot":"","sources":["../../src/core/rlm-runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ThinkingLevel } from \"@ponythewhite/base-context-agent\";\nimport type { Api, Model, RequestTokenBudgetOptions, ServiceTier } from \"@ponythewhite/base-context-ai\";\nimport type { AgentSession } from \"./agent-session.js\";\nimport type { ToolDefinition } from \"./extensions/index.js\";\nimport type { HostRequestHandler } from \"./kernel/index.js\";\nimport { THINKING_LEVELS } from \"./thinking-levels.js\";\n\n/** Request emitted by `rlm.run`; cellSourceCode preserves the spawning cell for display. */\nexport interface RlmRunRequest {\n\tprompt: string;\n\tkwargs: Record<string, unknown>;\n\tcellSourceCode?: string;\n}\n\nexport interface RlmSpawnHandle {\n\trlm_child_id: string;\n\tname: string;\n\tsession_dir: string;\n\tmodel: string;\n}\n\nexport type RlmSubagentRegistryStatus = \"running\" | \"completed\" | \"error\";\n\nexport interface RlmSubagentRegistryEntry {\n\trlm_child_id: string;\n\tactive_session_id: string | null;\n\tsession_id: string | null;\n\tsession_name: string;\n\tsession_dir: string;\n\tstatus: RlmSubagentRegistryStatus;\n}\n\nexport interface RlmListSubagentsResult {\n\tsubagents: RlmSubagentRegistryEntry[];\n}\n\nexport interface RlmDeleteSubagentResult {\n\tsubagent: RlmSubagentRegistryEntry;\n\toutcome?: \"deleted\" | \"skipped_running\";\n}\n\nexport interface RlmModelMatch {\n\tprovider: string;\n\tid: string;\n\tname: string;\n\tselector: string;\n}\n\nexport interface RlmFindModelsResult {\n\tmodels: RlmModelMatch[];\n}\n\nexport type RlmRunHandler = (request: RlmRunRequest) => Promise<Record<string, unknown>>;\nexport type RlmListSubagentsHandler = () => RlmListSubagentsResult | Promise<RlmListSubagentsResult>;\nexport type RlmDeleteSubagentHandler = (target: string) => Promise<RlmDeleteSubagentResult>;\nexport type RlmFindModelsHandler = (query: string, limit: number) => RlmFindModelsResult | Promise<RlmFindModelsResult>;\n\nconst RLM_SUBAGENT_SESSION_NAME_MAX_LENGTH = 64;\nexport const DEFAULT_RLM_MODEL_SEARCH_LIMIT = 8;\nexport const MAX_RLM_MODEL_SEARCH_LIMIT = 20;\n\nexport function normalizeRequestedRlmSubagentSessionName(value: unknown): string | undefined {\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tif (typeof value !== \"string\") {\n\t\tthrow new Error(\"rlm.run name must be a string\");\n\t}\n\tconst name = value.trim();\n\tif (!name) {\n\t\tthrow new Error(\"rlm.run name must not be empty\");\n\t}\n\tif (name.length > RLM_SUBAGENT_SESSION_NAME_MAX_LENGTH) {\n\t\tthrow new Error(`rlm.run name must be at most ${RLM_SUBAGENT_SESSION_NAME_MAX_LENGTH} characters`);\n\t}\n\treturn name;\n}\n\nexport function normalizeRequestedRlmSubagentThinkingLevel(value: unknown): ThinkingLevel | undefined {\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tif (typeof value !== \"string\") {\n\t\tthrow new Error(\"rlm.run thinking must be a string\");\n\t}\n\tconst level = value.trim().toLowerCase();\n\tif (!THINKING_LEVELS.includes(level as ThinkingLevel)) {\n\t\tthrow new Error(`rlm.run thinking must be one of: ${THINKING_LEVELS.join(\", \")}`);\n\t}\n\treturn level as ThinkingLevel;\n}\n\nexport function normalizeRequestedRlmSubagentModel(value: unknown): string | undefined {\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tif (typeof value !== \"string\") {\n\t\tthrow new Error(\"rlm.run model must be a string\");\n\t}\n\tconst model = value.trim();\n\tif (!model) {\n\t\tthrow new Error(\"rlm.run model must not be empty\");\n\t}\n\treturn model;\n}\n\n/** Create a readable, collision-resistant default name usable as an agent-message selector. */\nexport function createDefaultRlmSubagentSessionName(prompt: string, childId: string): string {\n\tconst promptSlug = prompt\n\t\t.normalize(\"NFKD\")\n\t\t.replace(/[\\u0300-\\u036f]/g, \"\")\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9]+/g, \"-\")\n\t\t.replace(/^-+|-+$/g, \"\");\n\tconst idSuffix =\n\t\tchildId\n\t\t\t.replace(/^sub-/, \"\")\n\t\t\t.replace(/[^A-Za-z0-9]+/g, \"\")\n\t\t\t.slice(-8) || \"child\";\n\tconst fixedLength = \"subagent--\".length + idSuffix.length;\n\tconst promptPart = (promptSlug || \"worker\")\n\t\t.slice(0, Math.max(1, RLM_SUBAGENT_SESSION_NAME_MAX_LENGTH - fixedLength))\n\t\t.replace(/-+$/g, \"\");\n\treturn `subagent-${promptPart || \"worker\"}-${idSuffix}`;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction normalizeModelSearchText(value: string): string {\n\treturn value.toLowerCase().replace(/[^a-z0-9]+/g, \"\");\n}\n\nexport function findRlmModelMatches(query: string, models: Model<Api>[], limit: number): RlmModelMatch[] {\n\tconst normalizedQuery = normalizeModelSearchText(query.trim());\n\treturn models\n\t\t.map((model) => {\n\t\t\tconst selector = `${model.provider}/${model.id}`;\n\t\t\tconst fields = [selector, model.id, model.name || model.id];\n\t\t\tconst normalizedFields = fields.map(normalizeModelSearchText);\n\t\t\tlet score = normalizedQuery ? Number.POSITIVE_INFINITY : 0;\n\t\t\tif (normalizedQuery) {\n\t\t\t\tconst exactIndex = normalizedFields.indexOf(normalizedQuery);\n\t\t\t\tconst prefixIndex = normalizedFields.findIndex((field) => field.startsWith(normalizedQuery));\n\t\t\t\tconst partialIndex = normalizedFields.findIndex((field) => field.includes(normalizedQuery));\n\t\t\t\tif (exactIndex >= 0) score = exactIndex;\n\t\t\t\telse if (prefixIndex >= 0) score = 3 + prefixIndex;\n\t\t\t\telse if (partialIndex >= 0) score = 6 + partialIndex;\n\t\t\t}\n\t\t\treturn { model, selector, score };\n\t\t})\n\t\t.filter((candidate) => Number.isFinite(candidate.score))\n\t\t.sort((a, b) => a.score - b.score || a.selector.localeCompare(b.selector))\n\t\t.slice(0, limit)\n\t\t.map(({ model, selector }) => ({\n\t\t\tprovider: model.provider,\n\t\t\tid: model.id,\n\t\t\tname: model.name || model.id,\n\t\t\tselector,\n\t\t}));\n}\n\n/** Adapt an RlmRunHandler into the typed `rlm.run` kernel host handler. */\nexport function createRlmRunHostHandler(handler: RlmRunHandler): HostRequestHandler {\n\treturn async (payload) => {\n\t\tif (typeof payload.prompt !== \"string\") {\n\t\t\tthrow new Error(\"rlm.run prompt must be a string\");\n\t\t}\n\t\tconst kwargs = isRecord(payload.kwargs) ? payload.kwargs : {};\n\t\tconst cellSourceCode = typeof payload.cellSourceCode === \"string\" ? payload.cellSourceCode : undefined;\n\t\tconst result = await handler({\n\t\t\tprompt: payload.prompt,\n\t\t\tkwargs,\n\t\t\tcellSourceCode,\n\t\t});\n\t\treturn result as unknown as Record<string, unknown>;\n\t};\n}\n\n/** Search a bounded authenticated model catalog without adding it to the system prompt. */\nexport function createRlmFindModelsHostHandler(handler: RlmFindModelsHandler): HostRequestHandler {\n\treturn async (payload) => {\n\t\tif (typeof payload.query !== \"string\") {\n\t\t\tthrow new Error(\"rlm.find_models query must be a string\");\n\t\t}\n\t\tconst limit = payload.limit === undefined ? DEFAULT_RLM_MODEL_SEARCH_LIMIT : payload.limit;\n\t\tif (!Number.isInteger(limit) || (limit as number) < 1 || (limit as number) > MAX_RLM_MODEL_SEARCH_LIMIT) {\n\t\t\tthrow new Error(`rlm.find_models limit must be an integer from 1 to ${MAX_RLM_MODEL_SEARCH_LIMIT}`);\n\t\t}\n\t\treturn { models: (await handler(payload.query, limit as number)).models };\n\t};\n}\n\n/** Expose the current parent session's direct RLM child registry to its kernel. */\nexport function createRlmListSubagentsHostHandler(handler: RlmListSubagentsHandler): HostRequestHandler {\n\treturn async () => {\n\t\tconst { subagents } = await handler();\n\t\treturn { subagents };\n\t};\n}\n\n/** Delete one direct child selected from the current parent session's registry. */\nexport function createRlmDeleteSubagentHostHandler(handler: RlmDeleteSubagentHandler): HostRequestHandler {\n\treturn async (payload) => {\n\t\tif (typeof payload.target !== \"string\" || !payload.target.trim()) {\n\t\t\tthrow new Error(\"rlm.delete_subagent target must be a non-empty string\");\n\t\t}\n\t\tconst { subagent, outcome } = await handler(payload.target.trim());\n\t\treturn outcome === undefined ? { subagent } : { subagent, outcome };\n\t};\n}\n\n/** A parent-owned setup or resident child, charged to its root-family capacity. */\nexport interface RlmChildAdmission {\n\treadonly parent: AgentSession;\n\treadonly session: AgentSession | undefined;\n\treadonly settlement: Promise<void>;\n\treadonly pending: boolean;\n\tassertCurrent(): void;\n\tbind(session: AgentSession): void;\n\tbeginSetup(): void;\n\tclaimFactory(): void;\n\tconfirmUnboundCleanup(): Promise<void>;\n\tsettle(): Promise<void>;\n}\n\nexport interface RlmSubagentRuntime {\n\tsession: AgentSession;\n}\n\nexport interface CreateRlmSubagentRuntimeOptions {\n\tparentSession: AgentSession;\n\t/** Defined trusted creation options override the inherited explicit parent policy. */\n\trequestTokenBudget?: RequestTokenBudgetOptions;\n\tcontextMode?: \"on\" | \"off\";\n\t/** The same live parent owns this setup. Native factories reserve it when omitted. */\n\tadmission?: RlmChildAdmission;\n\tid: string;\n\tprompt: string;\n\tsessionName: string;\n\tsessionDir: string;\n\tmodel: Model<any>;\n\tthinkingLevel: ThinkingLevel;\n\tserviceTier: ServiceTier;\n\tscopedModels: Array<{ model: Model<any>; thinkingLevel?: ThinkingLevel }>;\n\tactiveToolNames: string[];\n\tallowedToolNames?: string[];\n\tcustomTools: ToolDefinition[];\n\tincludeGoals: boolean;\n\tincludeCompactSkill: boolean;\n\trlmDepth: number;\n\trlmMaxDepth: number;\n\trlmParentNodeId: string;\n\t/** Request ID of the parent model call whose tool call caused this spawn. */\n\tspawnedByRequestId?: string;\n\t/** Source of the Python cell that spawned this subagent, for display. */\n\tspawnCode?: string;\n\t/** Publish the session to the parent before a host makes the runtime addressable. */\n\tonSessionPublished?: (session: AgentSession) => void;\n}\n\nexport interface SubagentRuntimeHost {\n\tcreateRlmSubagentRuntime(options: CreateRlmSubagentRuntimeOptions): Promise<RlmSubagentRuntime>;\n\t/** Persist host-owned completion before the child becomes passivation-eligible. */\n\tcompleteRlmSubagentRuntime?(childId: string, session: AgentSession): boolean;\n\t/** Release a host-owned child after its detached initial task settles. */\n\treleaseRlmSubagentRuntime?: (\n\t\truntime: RlmSubagentRuntime,\n\t\toptions: CreateRlmSubagentRuntimeOptions,\n\t\tstatus: \"done\" | \"error\" | \"cancelled\",\n\t) => Promise<void>;\n\t/** Close or remove the host-owned child; session is absent when a persisted child is still passive. */\n\tdeleteRlmSubagentRuntime(childId: string, session?: AgentSession): Promise<void>;\n\tdisposeRlmSubagentRuntimes?(): Promise<void>;\n}\n"]}

package/dist/core/rlm-runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"rlm-runtime.js","sourceRoot":"","sources":["../../src/core/rlm-runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ThinkingLevel } from \"@ponythewhite/base-context-agent\";\nimport type { Api, Model, RequestTokenBudgetOptions, ServiceTier } from \"@ponythewhite/base-context-ai\";\nimport type { AgentSession } from \"./agent-session.js\";\nimport type { ToolDefinition } from \"./extensions/index.js\";\nimport type { HostRequestHandler } from \"./kernel/index.js\";\nimport { THINKING_LEVELS } from \"./thinking-levels.js\";\n\n/** Request emitted by `rlm.run`; cellSourceCode preserves the spawning cell for display. */\nexport interface RlmRunRequest {\n\tprompt: string;\n\tkwargs: Record<string, unknown>;\n\tcellSourceCode?: string;\n}\n\nexport interface RlmSpawnHandle {\n\trlm_child_id: string;\n\tname: string;\n\tsession_dir: string;\n\tmodel: string;\n}\n\nexport type RlmSubagentRegistryStatus = \"running\" | \"completed\" | \"error\";\n\nexport interface RlmSubagentRegistryEntry {\n\trlm_child_id: string;\n\tactive_session_id: string | null;\n\tsession_id: string | null;\n\tsession_name: string;\n\tsession_dir: string;\n\tstatus: RlmSubagentRegistryStatus;\n}\n\nexport interface RlmListSubagentsResult {\n\tsubagents: RlmSubagentRegistryEntry[];\n}\n\nexport interface RlmDeleteSubagentResult {\n\tsubagent: RlmSubagentRegistryEntry;\n\toutcome?: \"deleted\" | \"skipped_running\";\n}\n\nexport interface RlmModelMatch {\n\tprovider: string;\n\tid: string;\n\tname: string;\n\tselector: string;\n}\n\nexport interface RlmFindModelsResult {\n\tmodels: RlmModelMatch[];\n}\n\nexport type RlmRunHandler = (request: RlmRunRequest) => Promise<Record<string, unknown>>;\nexport type RlmListSubagentsHandler = () => RlmListSubagentsResult | Promise<RlmListSubagentsResult>;\nexport type RlmDeleteSubagentHandler = (target: string) => Promise<RlmDeleteSubagentResult>;\nexport type RlmFindModelsHandler = (query: string, limit: number) => RlmFindModelsResult | Promise<RlmFindModelsResult>;\n\nconst RLM_SUBAGENT_SESSION_NAME_MAX_LENGTH = 64;\nexport const DEFAULT_RLM_MODEL_SEARCH_LIMIT = 8;\nexport const MAX_RLM_MODEL_SEARCH_LIMIT = 20;\n\nexport function normalizeRequestedRlmSubagentSessionName(value: unknown): string | undefined {\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tif (typeof value !== \"string\") {\n\t\tthrow new Error(\"rlm.run name must be a string\");\n\t}\n\tconst name = value.trim();\n\tif (!name) {\n\t\tthrow new Error(\"rlm.run name must not be empty\");\n\t}\n\tif (name.length > RLM_SUBAGENT_SESSION_NAME_MAX_LENGTH) {\n\t\tthrow new Error(`rlm.run name must be at most ${RLM_SUBAGENT_SESSION_NAME_MAX_LENGTH} characters`);\n\t}\n\treturn name;\n}\n\nexport function normalizeRequestedRlmSubagentThinkingLevel(value: unknown): ThinkingLevel | undefined {\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tif (typeof value !== \"string\") {\n\t\tthrow new Error(\"rlm.run thinking must be a string\");\n\t}\n\tconst level = value.trim().toLowerCase();\n\tif (!THINKING_LEVELS.includes(level as ThinkingLevel)) {\n\t\tthrow new Error(`rlm.run thinking must be one of: ${THINKING_LEVELS.join(\", \")}`);\n\t}\n\treturn level as ThinkingLevel;\n}\n\nexport function normalizeRequestedRlmSubagentModel(value: unknown): string | undefined {\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tif (typeof value !== \"string\") {\n\t\tthrow new Error(\"rlm.run model must be a string\");\n\t}\n\tconst model = value.trim();\n\tif (!model) {\n\t\tthrow new Error(\"rlm.run model must not be empty\");\n\t}\n\treturn model;\n}\n\n/** Create a readable, collision-resistant default name usable as an agent-message selector. */\nexport function createDefaultRlmSubagentSessionName(prompt: string, childId: string): string {\n\tconst promptSlug = prompt\n\t\t.normalize(\"NFKD\")\n\t\t.replace(/[\\u0300-\\u036f]/g, \"\")\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9]+/g, \"-\")\n\t\t.replace(/^-+|-+$/g, \"\");\n\tconst idSuffix =\n\t\tchildId\n\t\t\t.replace(/^sub-/, \"\")\n\t\t\t.replace(/[^A-Za-z0-9]+/g, \"\")\n\t\t\t.slice(-8) || \"child\";\n\tconst fixedLength = \"subagent--\".length + idSuffix.length;\n\tconst promptPart = (promptSlug || \"worker\")\n\t\t.slice(0, Math.max(1, RLM_SUBAGENT_SESSION_NAME_MAX_LENGTH - fixedLength))\n\t\t.replace(/-+$/g, \"\");\n\treturn `subagent-${promptPart || \"worker\"}-${idSuffix}`;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction normalizeModelSearchText(value: string): string {\n\treturn value.toLowerCase().replace(/[^a-z0-9]+/g, \"\");\n}\n\nexport function findRlmModelMatches(query: string, models: Model<Api>[], limit: number): RlmModelMatch[] {\n\tconst normalizedQuery = normalizeModelSearchText(query.trim());\n\treturn models\n\t\t.map((model) => {\n\t\t\tconst selector = `${model.provider}/${model.id}`;\n\t\t\tconst fields = [selector, model.id, model.name || model.id];\n\t\t\tconst normalizedFields = fields.map(normalizeModelSearchText);\n\t\t\tlet score = normalizedQuery ? Number.POSITIVE_INFINITY : 0;\n\t\t\tif (normalizedQuery) {\n\t\t\t\tconst exactIndex = normalizedFields.indexOf(normalizedQuery);\n\t\t\t\tconst prefixIndex = normalizedFields.findIndex((field) => field.startsWith(normalizedQuery));\n\t\t\t\tconst partialIndex = normalizedFields.findIndex((field) => field.includes(normalizedQuery));\n\t\t\t\tif (exactIndex >= 0) score = exactIndex;\n\t\t\t\telse if (prefixIndex >= 0) score = 3 + prefixIndex;\n\t\t\t\telse if (partialIndex >= 0) score = 6 + partialIndex;\n\t\t\t}\n\t\t\treturn { model, selector, score };\n\t\t})\n\t\t.filter((candidate) => Number.isFinite(candidate.score))\n\t\t.sort((a, b) => a.score - b.score || a.selector.localeCompare(b.selector))\n\t\t.slice(0, limit)\n\t\t.map(({ model, selector }) => ({\n\t\t\tprovider: model.provider,\n\t\t\tid: model.id,\n\t\t\tname: model.name || model.id,\n\t\t\tselector,\n\t\t}));\n}\n\n/** Adapt an RlmRunHandler into the typed `rlm.run` kernel host handler. */\nexport function createRlmRunHostHandler(handler: RlmRunHandler): HostRequestHandler {\n\treturn async (payload) => {\n\t\tif (typeof payload.prompt !== \"string\") {\n\t\t\tthrow new Error(\"rlm.run prompt must be a string\");\n\t\t}\n\t\tconst kwargs = isRecord(payload.kwargs) ? payload.kwargs : {};\n\t\tconst cellSourceCode = typeof payload.cellSourceCode === \"string\" ? payload.cellSourceCode : undefined;\n\t\tconst result = await handler({\n\t\t\tprompt: payload.prompt,\n\t\t\tkwargs,\n\t\t\tcellSourceCode,\n\t\t});\n\t\treturn result as unknown as Record<string, unknown>;\n\t};\n}\n\n/** Search a bounded authenticated model catalog without adding it to the system prompt. */\nexport function createRlmFindModelsHostHandler(handler: RlmFindModelsHandler): HostRequestHandler {\n\treturn async (payload) => {\n\t\tif (typeof payload.query !== \"string\") {\n\t\t\tthrow new Error(\"rlm.find_models query must be a string\");\n\t\t}\n\t\tconst limit = payload.limit === undefined ? DEFAULT_RLM_MODEL_SEARCH_LIMIT : payload.limit;\n\t\tif (!Number.isInteger(limit) || (limit as number) < 1 || (limit as number) > MAX_RLM_MODEL_SEARCH_LIMIT) {\n\t\t\tthrow new Error(`rlm.find_models limit must be an integer from 1 to ${MAX_RLM_MODEL_SEARCH_LIMIT}`);\n\t\t}\n\t\treturn { models: (await handler(payload.query, limit as number)).models };\n\t};\n}\n\n/** Expose the current parent session's direct RLM child registry to its kernel. */\nexport function createRlmListSubagentsHostHandler(handler: RlmListSubagentsHandler): HostRequestHandler {\n\treturn async () => {\n\t\tconst { subagents } = await handler();\n\t\treturn { subagents };\n\t};\n}\n\n/** Delete one direct child selected from the current parent session's registry. */\nexport function createRlmDeleteSubagentHostHandler(handler: RlmDeleteSubagentHandler): HostRequestHandler {\n\treturn async (payload) => {\n\t\tif (typeof payload.target !== \"string\" || !payload.target.trim()) {\n\t\t\tthrow new Error(\"rlm.delete_subagent target must be a non-empty string\");\n\t\t}\n\t\tconst { subagent, outcome } = await handler(payload.target.trim());\n\t\treturn outcome === undefined ? { subagent } : { subagent, outcome };\n\t};\n}\n\n/** One live parent's pending setup or resident child. Not a tree-wide reservation. */\nexport interface RlmChildAdmission {\n\treadonly parent: AgentSession;\n\treadonly session: AgentSession | undefined;\n\treadonly settlement: Promise<void>;\n\treadonly pending: boolean;\n\tassertCurrent(): void;\n\tbind(session: AgentSession): void;\n\tbeginSetup(): void;\n\tclaimFactory(): void;\n\tconfirmUnboundCleanup(): void;\n\tsettle(): void;\n}\n\nexport interface RlmSubagentRuntime {\n\tsession: AgentSession;\n}\n\nexport interface CreateRlmSubagentRuntimeOptions {\n\tparentSession: AgentSession;\n\t/** Defined trusted creation options override the inherited explicit parent policy. */\n\trequestTokenBudget?: RequestTokenBudgetOptions;\n\tcontextMode?: \"on\" | \"off\";\n\t/** The same live parent owns this setup. Native factories reserve it when omitted. */\n\tadmission?: RlmChildAdmission;\n\tid: string;\n\tprompt: string;\n\tsessionName: string;\n\tsessionDir: string;\n\tmodel: Model<any>;\n\tthinkingLevel: ThinkingLevel;\n\tserviceTier: ServiceTier;\n\tscopedModels: Array<{ model: Model<any>; thinkingLevel?: ThinkingLevel }>;\n\tactiveToolNames: string[];\n\tallowedToolNames?: string[];\n\tcustomTools: ToolDefinition[];\n\tincludeGoals: boolean;\n\tincludeCompactSkill: boolean;\n\trlmDepth: number;\n\trlmMaxDepth: number;\n\trlmParentNodeId: string;\n\t/** Request ID of the parent model call whose tool call caused this spawn. */\n\tspawnedByRequestId?: string;\n\t/** Source of the Python cell that spawned this subagent, for display. */\n\tspawnCode?: string;\n\t/** Publish the session to the parent before a host makes the runtime addressable. */\n\tonSessionPublished?: (session: AgentSession) => void;\n}\n\nexport interface SubagentRuntimeHost {\n\tcreateRlmSubagentRuntime(options: CreateRlmSubagentRuntimeOptions): Promise<RlmSubagentRuntime>;\n\t/** Persist host-owned completion before the child becomes passivation-eligible. */\n\tcompleteRlmSubagentRuntime?(childId: string, session: AgentSession): boolean;\n\t/** Release a host-owned child after its detached initial task settles. */\n\treleaseRlmSubagentRuntime?: (\n\t\truntime: RlmSubagentRuntime,\n\t\toptions: CreateRlmSubagentRuntimeOptions,\n\t\tstatus: \"done\" | \"error\" | \"cancelled\",\n\t) => Promise<void>;\n\t/** Close or remove the host-owned child; session is absent when a persisted child is still passive. */\n\tdeleteRlmSubagentRuntime(childId: string, session?: AgentSession): Promise<void>;\n\tdisposeRlmSubagentRuntimes?(): Promise<void>;\n}\n"]}
+{"version":3,"file":"rlm-runtime.js","sourceRoot":"","sources":["../../src/core/rlm-runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ThinkingLevel } from \"@ponythewhite/base-context-agent\";\nimport type { Api, Model, RequestTokenBudgetOptions, ServiceTier } from \"@ponythewhite/base-context-ai\";\nimport type { AgentSession } from \"./agent-session.js\";\nimport type { ToolDefinition } from \"./extensions/index.js\";\nimport type { HostRequestHandler } from \"./kernel/index.js\";\nimport { THINKING_LEVELS } from \"./thinking-levels.js\";\n\n/** Request emitted by `rlm.run`; cellSourceCode preserves the spawning cell for display. */\nexport interface RlmRunRequest {\n\tprompt: string;\n\tkwargs: Record<string, unknown>;\n\tcellSourceCode?: string;\n}\n\nexport interface RlmSpawnHandle {\n\trlm_child_id: string;\n\tname: string;\n\tsession_dir: string;\n\tmodel: string;\n}\n\nexport type RlmSubagentRegistryStatus = \"running\" | \"completed\" | \"error\";\n\nexport interface RlmSubagentRegistryEntry {\n\trlm_child_id: string;\n\tactive_session_id: string | null;\n\tsession_id: string | null;\n\tsession_name: string;\n\tsession_dir: string;\n\tstatus: RlmSubagentRegistryStatus;\n}\n\nexport interface RlmListSubagentsResult {\n\tsubagents: RlmSubagentRegistryEntry[];\n}\n\nexport interface RlmDeleteSubagentResult {\n\tsubagent: RlmSubagentRegistryEntry;\n\toutcome?: \"deleted\" | \"skipped_running\";\n}\n\nexport interface RlmModelMatch {\n\tprovider: string;\n\tid: string;\n\tname: string;\n\tselector: string;\n}\n\nexport interface RlmFindModelsResult {\n\tmodels: RlmModelMatch[];\n}\n\nexport type RlmRunHandler = (request: RlmRunRequest) => Promise<Record<string, unknown>>;\nexport type RlmListSubagentsHandler = () => RlmListSubagentsResult | Promise<RlmListSubagentsResult>;\nexport type RlmDeleteSubagentHandler = (target: string) => Promise<RlmDeleteSubagentResult>;\nexport type RlmFindModelsHandler = (query: string, limit: number) => RlmFindModelsResult | Promise<RlmFindModelsResult>;\n\nconst RLM_SUBAGENT_SESSION_NAME_MAX_LENGTH = 64;\nexport const DEFAULT_RLM_MODEL_SEARCH_LIMIT = 8;\nexport const MAX_RLM_MODEL_SEARCH_LIMIT = 20;\n\nexport function normalizeRequestedRlmSubagentSessionName(value: unknown): string | undefined {\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tif (typeof value !== \"string\") {\n\t\tthrow new Error(\"rlm.run name must be a string\");\n\t}\n\tconst name = value.trim();\n\tif (!name) {\n\t\tthrow new Error(\"rlm.run name must not be empty\");\n\t}\n\tif (name.length > RLM_SUBAGENT_SESSION_NAME_MAX_LENGTH) {\n\t\tthrow new Error(`rlm.run name must be at most ${RLM_SUBAGENT_SESSION_NAME_MAX_LENGTH} characters`);\n\t}\n\treturn name;\n}\n\nexport function normalizeRequestedRlmSubagentThinkingLevel(value: unknown): ThinkingLevel | undefined {\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tif (typeof value !== \"string\") {\n\t\tthrow new Error(\"rlm.run thinking must be a string\");\n\t}\n\tconst level = value.trim().toLowerCase();\n\tif (!THINKING_LEVELS.includes(level as ThinkingLevel)) {\n\t\tthrow new Error(`rlm.run thinking must be one of: ${THINKING_LEVELS.join(\", \")}`);\n\t}\n\treturn level as ThinkingLevel;\n}\n\nexport function normalizeRequestedRlmSubagentModel(value: unknown): string | undefined {\n\tif (value === undefined) {\n\t\treturn undefined;\n\t}\n\tif (typeof value !== \"string\") {\n\t\tthrow new Error(\"rlm.run model must be a string\");\n\t}\n\tconst model = value.trim();\n\tif (!model) {\n\t\tthrow new Error(\"rlm.run model must not be empty\");\n\t}\n\treturn model;\n}\n\n/** Create a readable, collision-resistant default name usable as an agent-message selector. */\nexport function createDefaultRlmSubagentSessionName(prompt: string, childId: string): string {\n\tconst promptSlug = prompt\n\t\t.normalize(\"NFKD\")\n\t\t.replace(/[\\u0300-\\u036f]/g, \"\")\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9]+/g, \"-\")\n\t\t.replace(/^-+|-+$/g, \"\");\n\tconst idSuffix =\n\t\tchildId\n\t\t\t.replace(/^sub-/, \"\")\n\t\t\t.replace(/[^A-Za-z0-9]+/g, \"\")\n\t\t\t.slice(-8) || \"child\";\n\tconst fixedLength = \"subagent--\".length + idSuffix.length;\n\tconst promptPart = (promptSlug || \"worker\")\n\t\t.slice(0, Math.max(1, RLM_SUBAGENT_SESSION_NAME_MAX_LENGTH - fixedLength))\n\t\t.replace(/-+$/g, \"\");\n\treturn `subagent-${promptPart || \"worker\"}-${idSuffix}`;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction normalizeModelSearchText(value: string): string {\n\treturn value.toLowerCase().replace(/[^a-z0-9]+/g, \"\");\n}\n\nexport function findRlmModelMatches(query: string, models: Model<Api>[], limit: number): RlmModelMatch[] {\n\tconst normalizedQuery = normalizeModelSearchText(query.trim());\n\treturn models\n\t\t.map((model) => {\n\t\t\tconst selector = `${model.provider}/${model.id}`;\n\t\t\tconst fields = [selector, model.id, model.name || model.id];\n\t\t\tconst normalizedFields = fields.map(normalizeModelSearchText);\n\t\t\tlet score = normalizedQuery ? Number.POSITIVE_INFINITY : 0;\n\t\t\tif (normalizedQuery) {\n\t\t\t\tconst exactIndex = normalizedFields.indexOf(normalizedQuery);\n\t\t\t\tconst prefixIndex = normalizedFields.findIndex((field) => field.startsWith(normalizedQuery));\n\t\t\t\tconst partialIndex = normalizedFields.findIndex((field) => field.includes(normalizedQuery));\n\t\t\t\tif (exactIndex >= 0) score = exactIndex;\n\t\t\t\telse if (prefixIndex >= 0) score = 3 + prefixIndex;\n\t\t\t\telse if (partialIndex >= 0) score = 6 + partialIndex;\n\t\t\t}\n\t\t\treturn { model, selector, score };\n\t\t})\n\t\t.filter((candidate) => Number.isFinite(candidate.score))\n\t\t.sort((a, b) => a.score - b.score || a.selector.localeCompare(b.selector))\n\t\t.slice(0, limit)\n\t\t.map(({ model, selector }) => ({\n\t\t\tprovider: model.provider,\n\t\t\tid: model.id,\n\t\t\tname: model.name || model.id,\n\t\t\tselector,\n\t\t}));\n}\n\n/** Adapt an RlmRunHandler into the typed `rlm.run` kernel host handler. */\nexport function createRlmRunHostHandler(handler: RlmRunHandler): HostRequestHandler {\n\treturn async (payload) => {\n\t\tif (typeof payload.prompt !== \"string\") {\n\t\t\tthrow new Error(\"rlm.run prompt must be a string\");\n\t\t}\n\t\tconst kwargs = isRecord(payload.kwargs) ? payload.kwargs : {};\n\t\tconst cellSourceCode = typeof payload.cellSourceCode === \"string\" ? payload.cellSourceCode : undefined;\n\t\tconst result = await handler({\n\t\t\tprompt: payload.prompt,\n\t\t\tkwargs,\n\t\t\tcellSourceCode,\n\t\t});\n\t\treturn result as unknown as Record<string, unknown>;\n\t};\n}\n\n/** Search a bounded authenticated model catalog without adding it to the system prompt. */\nexport function createRlmFindModelsHostHandler(handler: RlmFindModelsHandler): HostRequestHandler {\n\treturn async (payload) => {\n\t\tif (typeof payload.query !== \"string\") {\n\t\t\tthrow new Error(\"rlm.find_models query must be a string\");\n\t\t}\n\t\tconst limit = payload.limit === undefined ? DEFAULT_RLM_MODEL_SEARCH_LIMIT : payload.limit;\n\t\tif (!Number.isInteger(limit) || (limit as number) < 1 || (limit as number) > MAX_RLM_MODEL_SEARCH_LIMIT) {\n\t\t\tthrow new Error(`rlm.find_models limit must be an integer from 1 to ${MAX_RLM_MODEL_SEARCH_LIMIT}`);\n\t\t}\n\t\treturn { models: (await handler(payload.query, limit as number)).models };\n\t};\n}\n\n/** Expose the current parent session's direct RLM child registry to its kernel. */\nexport function createRlmListSubagentsHostHandler(handler: RlmListSubagentsHandler): HostRequestHandler {\n\treturn async () => {\n\t\tconst { subagents } = await handler();\n\t\treturn { subagents };\n\t};\n}\n\n/** Delete one direct child selected from the current parent session's registry. */\nexport function createRlmDeleteSubagentHostHandler(handler: RlmDeleteSubagentHandler): HostRequestHandler {\n\treturn async (payload) => {\n\t\tif (typeof payload.target !== \"string\" || !payload.target.trim()) {\n\t\t\tthrow new Error(\"rlm.delete_subagent target must be a non-empty string\");\n\t\t}\n\t\tconst { subagent, outcome } = await handler(payload.target.trim());\n\t\treturn outcome === undefined ? { subagent } : { subagent, outcome };\n\t};\n}\n\n/** A parent-owned setup or resident child, charged to its root-family capacity. */\nexport interface RlmChildAdmission {\n\treadonly parent: AgentSession;\n\treadonly session: AgentSession | undefined;\n\treadonly settlement: Promise<void>;\n\treadonly pending: boolean;\n\tassertCurrent(): void;\n\tbind(session: AgentSession): void;\n\tbeginSetup(): void;\n\tclaimFactory(): void;\n\tconfirmUnboundCleanup(): Promise<void>;\n\tsettle(): Promise<void>;\n}\n\nexport interface RlmSubagentRuntime {\n\tsession: AgentSession;\n}\n\nexport interface CreateRlmSubagentRuntimeOptions {\n\tparentSession: AgentSession;\n\t/** Defined trusted creation options override the inherited explicit parent policy. */\n\trequestTokenBudget?: RequestTokenBudgetOptions;\n\tcontextMode?: \"on\" | \"off\";\n\t/** The same live parent owns this setup. Native factories reserve it when omitted. */\n\tadmission?: RlmChildAdmission;\n\tid: string;\n\tprompt: string;\n\tsessionName: string;\n\tsessionDir: string;\n\tmodel: Model<any>;\n\tthinkingLevel: ThinkingLevel;\n\tserviceTier: ServiceTier;\n\tscopedModels: Array<{ model: Model<any>; thinkingLevel?: ThinkingLevel }>;\n\tactiveToolNames: string[];\n\tallowedToolNames?: string[];\n\tcustomTools: ToolDefinition[];\n\tincludeGoals: boolean;\n\tincludeCompactSkill: boolean;\n\trlmDepth: number;\n\trlmMaxDepth: number;\n\trlmParentNodeId: string;\n\t/** Request ID of the parent model call whose tool call caused this spawn. */\n\tspawnedByRequestId?: string;\n\t/** Source of the Python cell that spawned this subagent, for display. */\n\tspawnCode?: string;\n\t/** Publish the session to the parent before a host makes the runtime addressable. */\n\tonSessionPublished?: (session: AgentSession) => void;\n}\n\nexport interface SubagentRuntimeHost {\n\tcreateRlmSubagentRuntime(options: CreateRlmSubagentRuntimeOptions): Promise<RlmSubagentRuntime>;\n\t/** Persist host-owned completion before the child becomes passivation-eligible. */\n\tcompleteRlmSubagentRuntime?(childId: string, session: AgentSession): boolean;\n\t/** Release a host-owned child after its detached initial task settles. */\n\treleaseRlmSubagentRuntime?: (\n\t\truntime: RlmSubagentRuntime,\n\t\toptions: CreateRlmSubagentRuntimeOptions,\n\t\tstatus: \"done\" | \"error\" | \"cancelled\",\n\t) => Promise<void>;\n\t/** Close or remove the host-owned child; session is absent when a persisted child is still passive. */\n\tdeleteRlmSubagentRuntime(childId: string, session?: AgentSession): Promise<void>;\n\tdisposeRlmSubagentRuntimes?(): Promise<void>;\n}\n"]}

package/dist/core/sdk.d.ts

@@ -24,8 +24,8 @@ export interface CreateAgentSessionOptions extends AgentSessionCreationOptions {
     authStorage?: AuthStorage;
     /** Model registry. Default: ModelRegistry.create(authStorage, agentDir/models.json) */
     modelRegistry?: ModelRegistry;
-    /** Model to use. Default: from settings, else first available */
-    model?: Model<any>;
+    /** Model to use. Undefined restores a saved explicit choice; null leaves the session unselected. */
+    model?: Model<any> | null;
     /** Thinking level. Default: from settings, else 'medium' (clamped to model capabilities) */
     thinkingLevel?: ThinkingLevel;
     /** Models available for cycling (Ctrl+P in interactive mode) */
@@ -72,7 +72,7 @@ export interface CreateAgentSessionResult {
     session: AgentSession;
     /** Extensions result (for UI context setup in interactive mode) */
     extensionsResult: LoadExtensionsResult;
-    /** Warning if session was restored with a different model than saved */
+    /** Diagnostic when the selected session or saved model cannot be used. */
     modelFallbackMessage?: string;
 }
 export type { AgentSessionRuntimeConfig } from "./agent-session-config.js";
@@ -80,6 +80,7 @@ export * from "./agent-session-runtime.js";
 export type { AgentSessionCreationOptions } from "./agent-session-services.js";
 export type { ExtensionAPI, ExtensionCommandContext, ExtensionContext, ExtensionFactory, SlashCommandInfo, SlashCommandSource, ToolDefinition, } from "./extensions/index.js";
 export type { PromptTemplate } from "./prompt-templates.js";
+export type { RlmMaxSubagentsStatus, RlmRootAdmission, RlmSubagentCapacity, RlmSubagentCapacityReservation, } from "./rlm-max-subagents.js";
 export type { CreateRlmSubagentRuntimeOptions, RlmChildAdmission, RlmSubagentRuntime, SubagentRuntimeHost, } from "./rlm-runtime.js";
 export type { Skill } from "./skills.js";
 export type { Tool } from "./tools/index.js";

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

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/core/sdk.ts"],"names":[],"mappings":"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","sourcesContent":["import { join } from \"node:path\";\nimport { Agent, type AgentMessage, type AgentOutputLimits, type ThinkingLevel } from \"@ponythewhite/base-context-agent\";\nimport { clampThinkingLevel, type Message, type Model, supportsFastMode } from \"@ponythewhite/base-context-ai\";\nimport { getAgentDir } from \"../config.js\";\nimport { AgentSession } from \"./agent-session.js\";\nimport type { AgentSessionCreationOptions } from \"./agent-session-services.js\";\nimport { formatNoModelsAvailableMessage } from \"./auth-guidance.js\";\nimport { AuthStorage } from \"./auth-storage.js\";\nimport type { AgentAutonomousConfig } from \"./autonomous.js\";\nimport { DEFAULT_THINKING_LEVEL } from \"./defaults.js\";\nimport type { ExtensionRunner, LoadExtensionsResult, SessionStartEvent, ToolDefinition } from \"./extensions/index.js\";\nimport { createNativeInferenceStream } from \"./inference-coordinator.js\";\nimport { McpManager } from \"./mcp/mcp-manager.js\";\nimport { convertToLlm } from \"./messages.js\";\nimport { ModelRegistry } from \"./model-registry.js\";\nimport { findInitialModel } from \"./model-resolver.js\";\nimport type { ResourceLoader } from \"./resource-loader.js\";\nimport { DefaultResourceLoader } from \"./resource-loader.js\";\nimport { readSessionBootstrap } from \"./session-bootstrap.js\";\nimport { getDefaultSessionDir, SessionManager } from \"./session-manager.js\";\nimport { SettingsManager } from \"./settings-manager.js\";\nimport { time } from \"./timings.js\";\nimport {\n\tcreateBashTool,\n\tcreateEditTool,\n\tcreateIpythonTool,\n\tcreatePrimeContextTool,\n\twithFileMutationQueue,\n} from \"./tools/index.js\";\n\nexport interface CreateAgentSessionOptions extends AgentSessionCreationOptions {\n\t/** Working directory for project-local discovery. Default: process.cwd() */\n\tcwd?: string;\n\t/** Global config directory. Default: ~/.base-context */\n\tagentDir?: string;\n\n\t/** Auth storage for credentials. Default: AuthStorage.create(agentDir/auth.json).\n\t * Existing host Codex subscriptions can be injected with\n\t * AuthStorage.fromStorage(readOnlyBackend, { existingOpenAICodexSubscription: true }).\n\t * This retains the built-in owned dispatcher; it does not enable OAuth login/refresh.\n\t */\n\tauthStorage?: AuthStorage;\n\t/** Model registry. Default: ModelRegistry.create(authStorage, agentDir/models.json) */\n\tmodelRegistry?: ModelRegistry;\n\n\t/** Model to use. Default: from settings, else first available */\n\tmodel?: Model<any>;\n\t/** Thinking level. Default: from settings, else 'medium' (clamped to model capabilities) */\n\tthinkingLevel?: ThinkingLevel;\n\t/** Models available for cycling (Ctrl+P in interactive mode) */\n\tscopedModels?: Array<{ model: Model<any>; thinkingLevel?: ThinkingLevel }>;\n\n\t/**\n\t * Optional default tool suppression mode when no explicit allowlist is provided.\n\t *\n\t * - \"all\": start with no tools enabled\n\t * - \"builtin\": disable the default built-in tools (ipython and prime_context)\n\t *   but keep extension/custom tools enabled\n\t */\n\tnoTools?: \"all\" | \"builtin\";\n\t/**\n\t * Optional allowlist of tool names.\n\t *\n\t * When omitted, Base Context enables the default built-in tools (ipython and prime_context)\n\t * and leaves extension/custom tools enabled unless `noTools` changes that default.\n\t * When provided, only the listed tool names are enabled.\n\t */\n\ttools?: string[];\n\t/** Custom tools to register (in addition to built-in tools). */\n\tcustomTools?: ToolDefinition[];\n\n\t/** Resource loader. When omitted, DefaultResourceLoader is used. */\n\tresourceLoader?: ResourceLoader;\n\n\t/** MCP integration manager. When omitted, MCP host handlers are not wired. */\n\tmcpManager?: McpManager;\n\n\t/** Session manager. Default: SessionManager.create(cwd) */\n\tsessionManager?: SessionManager;\n\n\t/** Override complete native invocation output limits from settings. */\n\tinvocationOutputLimits?: AgentOutputLimits;\n\t/** Settings manager. Default: SettingsManager.create(cwd, agentDir) */\n\tsettingsManager?: SettingsManager;\n\t/** Session start event metadata for extension runtime startup. */\n\tsessionStartEvent?: SessionStartEvent;\n\t/** Host-side autonomous continuation policy. */\n\tautonomous?: AgentAutonomousConfig;\n}\n\n/** Result from createAgentSession */\nexport interface CreateAgentSessionResult {\n\t/** The created session */\n\tsession: AgentSession;\n\t/** Extensions result (for UI context setup in interactive mode) */\n\textensionsResult: LoadExtensionsResult;\n\t/** Warning if session was restored with a different model than saved */\n\tmodelFallbackMessage?: string;\n}\n\nexport type { AgentSessionRuntimeConfig } from \"./agent-session-config.js\";\nexport * from \"./agent-session-runtime.js\";\nexport type { AgentSessionCreationOptions } from \"./agent-session-services.js\";\nexport type {\n\tExtensionAPI,\n\tExtensionCommandContext,\n\tExtensionContext,\n\tExtensionFactory,\n\tSlashCommandInfo,\n\tSlashCommandSource,\n\tToolDefinition,\n} from \"./extensions/index.js\";\nexport type { PromptTemplate } from \"./prompt-templates.js\";\nexport type {\n\tCreateRlmSubagentRuntimeOptions,\n\tRlmChildAdmission,\n\tRlmSubagentRuntime,\n\tSubagentRuntimeHost,\n} from \"./rlm-runtime.js\";\nexport type { Skill } from \"./skills.js\";\nexport type { Tool } from \"./tools/index.js\";\n\nexport { createBashTool, createEditTool, createIpythonTool, createPrimeContextTool, withFileMutationQueue };\n\nfunction getDefaultAgentDir(): string {\n\treturn getAgentDir();\n}\n\n/**\n * Create an AgentSession with the specified options.\n *\n * @example\n * ```typescript\n * // Minimal - uses defaults\n * const { session } = await createAgentSession();\n *\n * // With explicit model\n * import { getModel } from '@ponythewhite/base-context-ai';\n * const { session } = await createAgentSession({\n *   model: getModel('anthropic', 'claude-opus-4-5'),\n *   thinkingLevel: 'high',\n * });\n *\n * // Continue previous session\n * const { session, modelFallbackMessage } = await createAgentSession({\n *   continueSession: true,\n * });\n *\n * // Full control\n * const loader = new DefaultResourceLoader({\n *   cwd: process.cwd(),\n *   agentDir: getAgentDir(),\n *   settingsManager: SettingsManager.create(),\n * });\n * await loader.reload();\n * const { session } = await createAgentSession({\n *   model: myModel,\n *   tools: [\"ipython\"],\n *   resourceLoader: loader,\n *   sessionManager: SessionManager.inMemory(),\n * });\n * ```\n */\nexport async function createAgentSession(options: CreateAgentSessionOptions = {}): Promise<CreateAgentSessionResult> {\n\tconst contextMode = options.contextMode;\n\tif (options.requestTokenBudget)\n\t\toptions = { ...options, requestTokenBudget: structuredClone(options.requestTokenBudget) };\n\tconst cwd = options.cwd ?? options.sessionManager?.getCwd() ?? process.cwd();\n\tconst agentDir = options.agentDir ?? getDefaultAgentDir();\n\tlet resourceLoader = options.resourceLoader;\n\n\tconst authPath = options.agentDir ? join(agentDir, \"auth.json\") : undefined;\n\tconst modelsPath = options.agentDir ? join(agentDir, \"models.json\") : undefined;\n\tconst authStorage = options.authStorage ?? AuthStorage.create(authPath);\n\tconst modelRegistry = options.modelRegistry ?? ModelRegistry.create(authStorage, modelsPath);\n\n\tconst settingsManager = options.settingsManager ?? SettingsManager.create(cwd, agentDir);\n\tconst sessionManager =\n\t\toptions.sessionManager ?? (await SessionManager.create(cwd, getDefaultSessionDir(cwd, agentDir)));\n\n\tlet session: AgentSession | undefined;\n\ttry {\n\t\t// Ensure MCP providers are registered and built-in MCP skills are gated by\n\t\t// auth even on the bare SDK path (not just the CLI's createAgentSessionServices).\n\t\tconst mcpManager =\n\t\t\toptions.mcpManager ??\n\t\t\tnew McpManager({ authStorage, getUserServers: () => settingsManager.getGlobalMcpServers() });\n\t\tmodelRegistry.setOnOAuthProvidersReset(() => mcpManager.registerUserProviders());\n\n\t\tif (!resourceLoader) {\n\t\t\tresourceLoader = new DefaultResourceLoader({\n\t\t\t\tcwd,\n\t\t\t\tagentDir,\n\t\t\t\tsettingsManager,\n\t\t\t\textraBuiltinSkillOverrides: () => mcpManager.getDisabledBuiltinSkillOverrides(),\n\t\t\t});\n\t\t\tawait resourceLoader.reload();\n\t\t\ttime(\"resourceLoader.reload\");\n\t\t}\n\n\t\tconst {\n\t\t\tcontext: existingSession,\n\t\t\thasExistingSession,\n\t\t\thasThinkingEntry,\n\t\t\thasServiceTierEntry,\n\t\t} = await readSessionBootstrap(sessionManager, settingsManager.getCanonicalContextLimits(), {\n\t\t\tallowPendingToolPublic: options.requestTokenBudget !== undefined,\n\t\t\tinitialContextMode: contextMode ?? settingsManager.getContextMode(),\n\t\t});\n\n\t\tlet model = options.model;\n\t\tlet modelFallbackMessage: string | undefined;\n\n\t\tif (!model && hasExistingSession && existingSession.model) {\n\t\t\tconst restoredModel = modelRegistry.find(existingSession.model.provider, existingSession.model.modelId);\n\t\t\tif (restoredModel && modelRegistry.hasConfiguredAuth(restoredModel)) {\n\t\t\t\tmodel = restoredModel;\n\t\t\t}\n\t\t\tif (!model) {\n\t\t\t\tmodelFallbackMessage = `Could not restore model ${existingSession.model.provider}/${existingSession.model.modelId}`;\n\t\t\t}\n\t\t}\n\n\t\tif (!model) {\n\t\t\tconst result = await findInitialModel({\n\t\t\t\tscopedModels: [],\n\t\t\t\tisContinuing: hasExistingSession,\n\t\t\t\tdefaultProvider: settingsManager.getDefaultProvider(),\n\t\t\t\tdefaultModelId: settingsManager.getDefaultModel(),\n\t\t\t\tdefaultThinkingLevel: settingsManager.getDefaultThinkingLevel(),\n\t\t\t\tmodelRegistry,\n\t\t\t});\n\t\t\tmodel = result.model;\n\t\t\tif (!model) {\n\t\t\t\tmodelFallbackMessage = formatNoModelsAvailableMessage();\n\t\t\t} else if (modelFallbackMessage) {\n\t\t\t\tmodelFallbackMessage += `. Using ${model.provider}/${model.id}`;\n\t\t\t}\n\t\t}\n\n\t\tlet thinkingLevel = options.thinkingLevel;\n\n\t\tif (thinkingLevel === undefined && hasExistingSession) {\n\t\t\tthinkingLevel = hasThinkingEntry\n\t\t\t\t? (existingSession.thinkingLevel as ThinkingLevel)\n\t\t\t\t: (settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL);\n\t\t}\n\n\t\tif (thinkingLevel === undefined) {\n\t\t\tthinkingLevel = settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL;\n\t\t}\n\n\t\tif (!model) {\n\t\t\tthinkingLevel = \"off\";\n\t\t} else {\n\t\t\tthinkingLevel = clampThinkingLevel(model, thinkingLevel) as ThinkingLevel;\n\t\t}\n\n\t\tconst serviceTierPreference =\n\t\t\toptions.serviceTier ??\n\t\t\t(hasServiceTierEntry ? existingSession.serviceTier : settingsManager.getDefaultServiceTier());\n\t\tconst serviceTier =\n\t\t\tserviceTierPreference === \"priority\" && (!model || !supportsFastMode(model))\n\t\t\t\t? \"default\"\n\t\t\t\t: serviceTierPreference;\n\n\t\tconst allowedToolNames =\n\t\t\toptions.allowedToolNames ?? options.tools ?? (options.noTools === \"all\" ? [] : undefined);\n\t\tconst includeGoals = options.includeGoals ?? (options.tools !== undefined || options.noTools !== \"all\");\n\t\tconst initialActiveToolNames: string[] =\n\t\t\toptions.initialActiveToolNames ??\n\t\t\t(options.tools ? [...options.tools] : options.noTools ? [] : [\"ipython\", \"prime_context\"]);\n\n\t\tlet agent: Agent;\n\n\t\tconst convertToLlmWithBlockImages = (messages: AgentMessage[]): Message[] => {\n\t\t\tconst converted = convertToLlm(messages);\n\t\t\tif (!settingsManager.getBlockImages()) {\n\t\t\t\treturn converted;\n\t\t\t}\n\t\t\treturn converted.map((msg) => {\n\t\t\t\tif (msg.role === \"user\" || msg.role === \"toolResult\") {\n\t\t\t\t\tconst content = msg.content;\n\t\t\t\t\tif (Array.isArray(content)) {\n\t\t\t\t\t\tconst hasImages = content.some((c) => c.type === \"image\");\n\t\t\t\t\t\tif (hasImages) {\n\t\t\t\t\t\t\tconst filteredContent = content\n\t\t\t\t\t\t\t\t.map((c) =>\n\t\t\t\t\t\t\t\t\tc.type === \"image\" ? { type: \"text\" as const, text: \"Image reading is disabled.\" } : c,\n\t\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t\t.filter(\n\t\t\t\t\t\t\t\t\t(c, i, arr) =>\n\t\t\t\t\t\t\t\t\t\t!(\n\t\t\t\t\t\t\t\t\t\t\tc.type === \"text\" &&\n\t\t\t\t\t\t\t\t\t\t\tc.text === \"Image reading is disabled.\" &&\n\t\t\t\t\t\t\t\t\t\t\ti > 0 &&\n\t\t\t\t\t\t\t\t\t\t\tarr[i - 1].type === \"text\" &&\n\t\t\t\t\t\t\t\t\t\t\t(arr[i - 1] as { type: \"text\"; text: string }).text === \"Image reading is disabled.\"\n\t\t\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\treturn { ...msg, content: filteredContent };\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn msg;\n\t\t\t});\n\t\t};\n\n\t\tconst extensionRunnerRef: { current?: ExtensionRunner } = {};\n\n\t\tagent = new Agent({\n\t\t\tinitialState: {\n\t\t\t\tsystemPrompt: \"\",\n\t\t\t\tmodel,\n\t\t\t\tthinkingLevel,\n\t\t\t\tserviceTier,\n\t\t\t\ttools: [],\n\t\t\t},\n\t\t\tconvertToLlm: convertToLlmWithBlockImages,\n\t\t\tstreamFn: createNativeInferenceStream(async (model, _context, options) => {\n\t\t\t\tconst auth = await modelRegistry.getApiKeyAndHeaders(model);\n\t\t\t\tif (!auth.ok) {\n\t\t\t\t\tthrow new Error(auth.error);\n\t\t\t\t}\n\t\t\t\tconst providerRetrySettings = settingsManager.getProviderRetrySettings();\n\t\t\t\treturn {\n\t\t\t\t\t...options,\n\t\t\t\t\tapiKey: auth.apiKey,\n\t\t\t\t\ttimeoutMs: options?.timeoutMs ?? providerRetrySettings.timeoutMs,\n\t\t\t\t\tmaxRetries: options?.maxRetries ?? providerRetrySettings.maxRetries,\n\t\t\t\t\tmaxRetryDelayMs: options?.maxRetryDelayMs ?? providerRetrySettings.maxRetryDelayMs,\n\t\t\t\t\theaders: auth.headers || options?.headers ? { ...auth.headers, ...options?.headers } : undefined,\n\t\t\t\t};\n\t\t\t}),\n\t\t\tonPayload: async (payload, _model) => {\n\t\t\t\tconst runner = extensionRunnerRef.current;\n\t\t\t\tif (!runner?.hasHandlers(\"before_provider_request\")) {\n\t\t\t\t\treturn payload;\n\t\t\t\t}\n\t\t\t\treturn runner.emitBeforeProviderRequest(payload);\n\t\t\t},\n\t\t\tonResponse: async (response, _model) => {\n\t\t\t\tconst runner = extensionRunnerRef.current;\n\t\t\t\tif (!runner?.hasHandlers(\"after_provider_response\")) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tawait runner.emit({\n\t\t\t\t\ttype: \"after_provider_response\",\n\t\t\t\t\tstatus: response.status,\n\t\t\t\t\theaders: response.headers,\n\t\t\t\t});\n\t\t\t},\n\t\t\tsessionId: sessionManager.getSessionId(),\n\t\t\ttransformContext: async (messages) => {\n\t\t\t\tconst runner = extensionRunnerRef.current;\n\t\t\t\tif (!runner) return messages;\n\t\t\t\treturn runner.emitContext(messages);\n\t\t\t},\n\t\t\tsteeringMode: settingsManager.getSteeringMode(),\n\t\t\tfollowUpMode: settingsManager.getFollowUpMode(),\n\t\t\ttransport: settingsManager.getTransport(),\n\t\t\tthinkingBudgets: settingsManager.getThinkingBudgets(),\n\t\t\tmaxRetryDelayMs: settingsManager.getProviderRetrySettings().maxRetryDelayMs,\n\t\t});\n\n\t\tif (hasExistingSession) {\n\t\t\tagent.state.messages = existingSession.messages;\n\t\t\tif (!hasThinkingEntry) {\n\t\t\t\tawait sessionManager.appendThinkingLevelChange(thinkingLevel);\n\t\t\t}\n\t\t} else {\n\t\t\tif (model) {\n\t\t\t\tawait sessionManager.appendModelChange(model.provider, model.id);\n\t\t\t}\n\t\t\tawait sessionManager.appendThinkingLevelChange(thinkingLevel);\n\t\t}\n\t\tif (!hasServiceTierEntry) {\n\t\t\tawait sessionManager.appendServiceTierChange(serviceTierPreference);\n\t\t}\n\n\t\tsession = new AgentSession({\n\t\t\tinvocationOutputLimits: options.invocationOutputLimits,\n\t\t\trequestTokenBudget: options.requestTokenBudget,\n\t\t\tcontextMode,\n\t\t\tagent,\n\t\t\tsessionManager,\n\t\t\tsettingsManager,\n\t\t\tserviceTierPreference,\n\t\t\tcwd,\n\t\t\t// Only the explicit dir — the default may not match injected custom storage.\n\t\t\tagentDir: options.agentDir,\n\t\t\tscopedModels: options.scopedModels,\n\t\t\tresourceLoader,\n\t\t\tcustomTools: options.customTools,\n\t\t\tmodelRegistry,\n\t\t\tmcpManager,\n\t\t\tinitialActiveToolNames,\n\t\t\tallowedToolNames,\n\t\t\tincludeGoals,\n\t\t\tincludeCompactSkill: options.includeCompactSkill,\n\t\t\trlmHeartbeatController: options.rlmHeartbeatController,\n\t\t\tagentMessageController: options.agentMessageController,\n\t\t\tagentObserveController: options.agentObserveController,\n\t\t\textensionRunnerRef,\n\t\t\trlmDepth: options.rlmDepth,\n\t\t\trlmMaxDepth: options.rlmMaxDepth,\n\t\t\trlmSessionDir: options.rlmSessionDir,\n\t\t\trlmParentNodeId: options.rlmParentNodeId,\n\t\t\trlmParentAgent: options.rlmParentAgent,\n\t\t\trlmChildAdmission: options.rlmChildAdmission,\n\t\t\tsemanticParentSessionId: options.semanticParentSessionId,\n\t\t\tsemanticSpawnedByRequestId: options.semanticSpawnedByRequestId,\n\t\t\tsubagentRuntimeHost: options.subagentRuntimeHost,\n\t\t\tsessionStartEvent: options.sessionStartEvent,\n\t\t\tprewarmIpythonKernel: options.prewarmIpythonKernel,\n\t\t\tautonomous: options.autonomous,\n\t\t\tserializedRefine: options.serializedRefine,\n\t\t\tinitialGoal: options.initialGoal,\n\t\t});\n\t\tawait session.initialize();\n\t\tconst extensionsResult = resourceLoader.getExtensions();\n\n\t\treturn {\n\t\t\tsession,\n\t\t\textensionsResult,\n\t\t\tmodelFallbackMessage,\n\t\t};\n\t} catch (error) {\n\t\ttry {\n\t\t\tconst admitted = options.rlmChildAdmission?.session;\n\t\t\tconst failedSession = session ?? (admitted?.sessionManager === sessionManager ? admitted : undefined);\n\t\t\tif (failedSession) await failedSession.disposeAsync();\n\t\t\telse {\n\t\t\t\tawait sessionManager.close();\n\t\t\t\toptions.rlmChildAdmission?.confirmUnboundCleanup();\n\t\t\t}\n\t\t} catch (cleanupError) {\n\t\t\tif (cleanupError === error || (error instanceof AggregateError && error.errors.includes(cleanupError)))\n\t\t\t\tthrow error;\n\t\t\tthrow new AggregateError([error, cleanupError], \"Session creation and cleanup failed\");\n\t\t}\n\t\tthrow error;\n\t}\n}\n"]}
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/core/sdk.ts"],"names":[],"mappings":"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","sourcesContent":["import { join } from \"node:path\";\nimport { Agent, type AgentMessage, type AgentOutputLimits, type ThinkingLevel } from \"@ponythewhite/base-context-agent\";\nimport { clampThinkingLevel, type Message, type Model, supportsFastMode } from \"@ponythewhite/base-context-ai\";\nimport { getAgentDir } from \"../config.js\";\nimport { AgentSession } from \"./agent-session.js\";\nimport type { AgentSessionCreationOptions } from \"./agent-session-services.js\";\nimport { formatNoModelsAvailableMessage } from \"./auth-guidance.js\";\nimport { AuthStorage } from \"./auth-storage.js\";\nimport type { AgentAutonomousConfig } from \"./autonomous.js\";\nimport { DEFAULT_THINKING_LEVEL } from \"./defaults.js\";\nimport type { ExtensionRunner, LoadExtensionsResult, SessionStartEvent, ToolDefinition } from \"./extensions/index.js\";\nimport { createNativeInferenceStream } from \"./inference-coordinator.js\";\nimport { McpManager } from \"./mcp/mcp-manager.js\";\nimport { convertToLlm } from \"./messages.js\";\nimport { ModelRegistry } from \"./model-registry.js\";\nimport { findInitialModel } from \"./model-resolver.js\";\nimport type { ResourceLoader } from \"./resource-loader.js\";\nimport { DefaultResourceLoader } from \"./resource-loader.js\";\nimport { readSessionBootstrap } from \"./session-bootstrap.js\";\nimport { getDefaultSessionDir, SessionManager } from \"./session-manager.js\";\nimport { SettingsManager } from \"./settings-manager.js\";\nimport { time } from \"./timings.js\";\nimport {\n\tcreateBashTool,\n\tcreateEditTool,\n\tcreateIpythonTool,\n\tcreatePrimeContextTool,\n\twithFileMutationQueue,\n} from \"./tools/index.js\";\n\nexport interface CreateAgentSessionOptions extends AgentSessionCreationOptions {\n\t/** Working directory for project-local discovery. Default: process.cwd() */\n\tcwd?: string;\n\t/** Global config directory. Default: ~/.base-context */\n\tagentDir?: string;\n\n\t/** Auth storage for credentials. Default: AuthStorage.create(agentDir/auth.json).\n\t * Existing host Codex subscriptions can be injected with\n\t * AuthStorage.fromStorage(readOnlyBackend, { existingOpenAICodexSubscription: true }).\n\t * This retains the built-in owned dispatcher; it does not enable OAuth login/refresh.\n\t */\n\tauthStorage?: AuthStorage;\n\t/** Model registry. Default: ModelRegistry.create(authStorage, agentDir/models.json) */\n\tmodelRegistry?: ModelRegistry;\n\n\t/** Model to use. Undefined restores a saved explicit choice; null leaves the session unselected. */\n\tmodel?: Model<any> | null;\n\t/** Thinking level. Default: from settings, else 'medium' (clamped to model capabilities) */\n\tthinkingLevel?: ThinkingLevel;\n\t/** Models available for cycling (Ctrl+P in interactive mode) */\n\tscopedModels?: Array<{ model: Model<any>; thinkingLevel?: ThinkingLevel }>;\n\n\t/**\n\t * Optional default tool suppression mode when no explicit allowlist is provided.\n\t *\n\t * - \"all\": start with no tools enabled\n\t * - \"builtin\": disable the default built-in tools (ipython and prime_context)\n\t *   but keep extension/custom tools enabled\n\t */\n\tnoTools?: \"all\" | \"builtin\";\n\t/**\n\t * Optional allowlist of tool names.\n\t *\n\t * When omitted, Base Context enables the default built-in tools (ipython and prime_context)\n\t * and leaves extension/custom tools enabled unless `noTools` changes that default.\n\t * When provided, only the listed tool names are enabled.\n\t */\n\ttools?: string[];\n\t/** Custom tools to register (in addition to built-in tools). */\n\tcustomTools?: ToolDefinition[];\n\n\t/** Resource loader. When omitted, DefaultResourceLoader is used. */\n\tresourceLoader?: ResourceLoader;\n\n\t/** MCP integration manager. When omitted, MCP host handlers are not wired. */\n\tmcpManager?: McpManager;\n\n\t/** Session manager. Default: SessionManager.create(cwd) */\n\tsessionManager?: SessionManager;\n\n\t/** Override complete native invocation output limits from settings. */\n\tinvocationOutputLimits?: AgentOutputLimits;\n\t/** Settings manager. Default: SettingsManager.create(cwd, agentDir) */\n\tsettingsManager?: SettingsManager;\n\t/** Session start event metadata for extension runtime startup. */\n\tsessionStartEvent?: SessionStartEvent;\n\t/** Host-side autonomous continuation policy. */\n\tautonomous?: AgentAutonomousConfig;\n}\n\n/** Result from createAgentSession */\nexport interface CreateAgentSessionResult {\n\t/** The created session */\n\tsession: AgentSession;\n\t/** Extensions result (for UI context setup in interactive mode) */\n\textensionsResult: LoadExtensionsResult;\n\t/** Diagnostic when the selected session or saved model cannot be used. */\n\tmodelFallbackMessage?: string;\n}\n\nexport type { AgentSessionRuntimeConfig } from \"./agent-session-config.js\";\nexport * from \"./agent-session-runtime.js\";\nexport type { AgentSessionCreationOptions } from \"./agent-session-services.js\";\nexport type {\n\tExtensionAPI,\n\tExtensionCommandContext,\n\tExtensionContext,\n\tExtensionFactory,\n\tSlashCommandInfo,\n\tSlashCommandSource,\n\tToolDefinition,\n} from \"./extensions/index.js\";\nexport type { PromptTemplate } from \"./prompt-templates.js\";\nexport type {\n\tRlmMaxSubagentsStatus,\n\tRlmRootAdmission,\n\tRlmSubagentCapacity,\n\tRlmSubagentCapacityReservation,\n} from \"./rlm-max-subagents.js\";\nexport type {\n\tCreateRlmSubagentRuntimeOptions,\n\tRlmChildAdmission,\n\tRlmSubagentRuntime,\n\tSubagentRuntimeHost,\n} from \"./rlm-runtime.js\";\nexport type { Skill } from \"./skills.js\";\nexport type { Tool } from \"./tools/index.js\";\n\nexport { createBashTool, createEditTool, createIpythonTool, createPrimeContextTool, withFileMutationQueue };\n\nfunction getDefaultAgentDir(): string {\n\treturn getAgentDir();\n}\n\n/**\n * Create an AgentSession with the specified options.\n *\n * @example\n * ```typescript\n * // Minimal - uses defaults\n * const { session } = await createAgentSession();\n *\n * // With explicit model\n * import { getModel } from '@ponythewhite/base-context-ai';\n * const { session } = await createAgentSession({\n *   model: getModel('anthropic', 'claude-opus-4-5'),\n *   thinkingLevel: 'high',\n * });\n *\n * // Continue previous session\n * const { session, modelFallbackMessage } = await createAgentSession({\n *   continueSession: true,\n * });\n *\n * // Full control\n * const loader = new DefaultResourceLoader({\n *   cwd: process.cwd(),\n *   agentDir: getAgentDir(),\n *   settingsManager: SettingsManager.create(),\n * });\n * await loader.reload();\n * const { session } = await createAgentSession({\n *   model: myModel,\n *   tools: [\"ipython\"],\n *   resourceLoader: loader,\n *   sessionManager: SessionManager.inMemory(),\n * });\n * ```\n */\nexport async function createAgentSession(options: CreateAgentSessionOptions = {}): Promise<CreateAgentSessionResult> {\n\tconst contextMode = options.contextMode;\n\tif (options.requestTokenBudget)\n\t\toptions = { ...options, requestTokenBudget: structuredClone(options.requestTokenBudget) };\n\tconst cwd = options.cwd ?? options.sessionManager?.getCwd() ?? process.cwd();\n\tconst agentDir = options.agentDir ?? getDefaultAgentDir();\n\tlet resourceLoader = options.resourceLoader;\n\n\tconst authPath = options.agentDir ? join(agentDir, \"auth.json\") : undefined;\n\tconst modelsPath = options.agentDir ? join(agentDir, \"models.json\") : undefined;\n\tconst authStorage = options.authStorage ?? AuthStorage.create(authPath);\n\tconst modelRegistry = options.modelRegistry ?? ModelRegistry.create(authStorage, modelsPath);\n\n\tconst settingsManager = options.settingsManager ?? SettingsManager.create(cwd, agentDir);\n\tconst sessionManager =\n\t\toptions.sessionManager ?? (await SessionManager.create(cwd, getDefaultSessionDir(cwd, agentDir)));\n\n\tlet session: AgentSession | undefined;\n\ttry {\n\t\t// Ensure MCP providers are registered and built-in MCP skills are gated by\n\t\t// auth even on the bare SDK path (not just the CLI's createAgentSessionServices).\n\t\tconst mcpManager =\n\t\t\toptions.mcpManager ??\n\t\t\tnew McpManager({ authStorage, getUserServers: () => settingsManager.getGlobalMcpServers() });\n\t\tmodelRegistry.setOnOAuthProvidersReset(() => mcpManager.registerUserProviders());\n\n\t\tif (!resourceLoader) {\n\t\t\tresourceLoader = new DefaultResourceLoader({\n\t\t\t\tcwd,\n\t\t\t\tagentDir,\n\t\t\t\tsettingsManager,\n\t\t\t\textraBuiltinSkillOverrides: () => mcpManager.getDisabledBuiltinSkillOverrides(),\n\t\t\t});\n\t\t\tawait resourceLoader.reload();\n\t\t\ttime(\"resourceLoader.reload\");\n\t\t}\n\n\t\tconst {\n\t\t\tcontext: existingSession,\n\t\t\thasExistingSession,\n\t\t\thasThinkingEntry,\n\t\t\thasServiceTierEntry,\n\t\t} = await readSessionBootstrap(sessionManager, settingsManager.getCanonicalContextLimits(), {\n\t\t\tallowPendingToolPublic: options.requestTokenBudget !== undefined,\n\t\t\tinitialContextMode: contextMode ?? settingsManager.getContextMode(),\n\t\t});\n\n\t\tlet model = options.model ?? undefined;\n\t\tlet modelFallbackMessage: string | undefined;\n\n\t\tif (options.model === undefined && hasExistingSession && existingSession.model) {\n\t\t\tconst saved = existingSession.model;\n\t\t\tconst restoredModel = modelRegistry.find(saved.provider, saved.modelId);\n\t\t\tmodel = restoredModel;\n\t\t\tif (!restoredModel) {\n\t\t\t\tmodelFallbackMessage = `Could not restore model ${saved.provider}/${saved.modelId}. Use /model to select a supported model.`;\n\t\t\t} else if (!modelRegistry.hasConfiguredAuth(restoredModel)) {\n\t\t\t\tmodelFallbackMessage = `Selected model ${saved.provider}/${saved.modelId} needs authentication. Use /login to configure this provider.`;\n\t\t\t}\n\t\t} else if (options.model === undefined) {\n\t\t\tconst result = await findInitialModel({\n\t\t\t\tscopedModels: [],\n\t\t\t\tisContinuing: hasExistingSession,\n\t\t\t\tdefaultProvider: settingsManager.getDefaultProvider(),\n\t\t\t\tdefaultModelId: settingsManager.getDefaultModel(),\n\t\t\t\tdefaultThinkingLevel: settingsManager.getDefaultThinkingLevel(),\n\t\t\t\tmodelRegistry,\n\t\t\t});\n\t\t\tmodel = result.model;\n\t\t\tif (model && !modelRegistry.hasConfiguredAuth(model)) {\n\t\t\t\tmodelFallbackMessage = `Selected model ${model.provider}/${model.id} needs authentication. Use /login to configure this provider.`;\n\t\t\t} else if (!model) {\n\t\t\t\tconst provider = settingsManager.getDefaultProvider();\n\t\t\t\tconst modelId = settingsManager.getDefaultModel();\n\t\t\t\tmodelFallbackMessage =\n\t\t\t\t\tprovider && modelId\n\t\t\t\t\t\t? `Selected model ${provider}/${modelId} is unavailable. Use /model to select a supported model.`\n\t\t\t\t\t\t: formatNoModelsAvailableMessage();\n\t\t\t}\n\t\t}\n\n\t\tlet thinkingLevel = options.thinkingLevel;\n\n\t\tif (thinkingLevel === undefined && hasExistingSession) {\n\t\t\tthinkingLevel = hasThinkingEntry\n\t\t\t\t? (existingSession.thinkingLevel as ThinkingLevel)\n\t\t\t\t: (settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL);\n\t\t}\n\n\t\tif (thinkingLevel === undefined) {\n\t\t\tthinkingLevel = settingsManager.getDefaultThinkingLevel() ?? DEFAULT_THINKING_LEVEL;\n\t\t}\n\n\t\tif (!model) {\n\t\t\tthinkingLevel = \"off\";\n\t\t} else {\n\t\t\tthinkingLevel = clampThinkingLevel(model, thinkingLevel) as ThinkingLevel;\n\t\t}\n\n\t\tconst serviceTierPreference =\n\t\t\toptions.serviceTier ??\n\t\t\t(hasServiceTierEntry ? existingSession.serviceTier : settingsManager.getDefaultServiceTier());\n\t\tconst serviceTier =\n\t\t\tserviceTierPreference === \"priority\" && (!model || !supportsFastMode(model))\n\t\t\t\t? \"default\"\n\t\t\t\t: serviceTierPreference;\n\n\t\tconst allowedToolNames =\n\t\t\toptions.allowedToolNames ?? options.tools ?? (options.noTools === \"all\" ? [] : undefined);\n\t\tconst includeGoals = options.includeGoals ?? (options.tools !== undefined || options.noTools !== \"all\");\n\t\tconst initialActiveToolNames: string[] =\n\t\t\toptions.initialActiveToolNames ??\n\t\t\t(options.tools ? [...options.tools] : options.noTools ? [] : [\"ipython\", \"prime_context\"]);\n\n\t\tlet agent: Agent;\n\n\t\tconst convertToLlmWithBlockImages = (messages: AgentMessage[]): Message[] => {\n\t\t\tconst converted = convertToLlm(messages);\n\t\t\tif (!settingsManager.getBlockImages()) {\n\t\t\t\treturn converted;\n\t\t\t}\n\t\t\treturn converted.map((msg) => {\n\t\t\t\tif (msg.role === \"user\" || msg.role === \"toolResult\") {\n\t\t\t\t\tconst content = msg.content;\n\t\t\t\t\tif (Array.isArray(content)) {\n\t\t\t\t\t\tconst hasImages = content.some((c) => c.type === \"image\");\n\t\t\t\t\t\tif (hasImages) {\n\t\t\t\t\t\t\tconst filteredContent = content\n\t\t\t\t\t\t\t\t.map((c) =>\n\t\t\t\t\t\t\t\t\tc.type === \"image\" ? { type: \"text\" as const, text: \"Image reading is disabled.\" } : c,\n\t\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t\t.filter(\n\t\t\t\t\t\t\t\t\t(c, i, arr) =>\n\t\t\t\t\t\t\t\t\t\t!(\n\t\t\t\t\t\t\t\t\t\t\tc.type === \"text\" &&\n\t\t\t\t\t\t\t\t\t\t\tc.text === \"Image reading is disabled.\" &&\n\t\t\t\t\t\t\t\t\t\t\ti > 0 &&\n\t\t\t\t\t\t\t\t\t\t\tarr[i - 1].type === \"text\" &&\n\t\t\t\t\t\t\t\t\t\t\t(arr[i - 1] as { type: \"text\"; text: string }).text === \"Image reading is disabled.\"\n\t\t\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\treturn { ...msg, content: filteredContent };\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn msg;\n\t\t\t});\n\t\t};\n\n\t\tconst extensionRunnerRef: { current?: ExtensionRunner } = {};\n\n\t\tagent = new Agent({\n\t\t\tinitialState: {\n\t\t\t\tsystemPrompt: \"\",\n\t\t\t\tmodel,\n\t\t\t\tthinkingLevel,\n\t\t\t\tserviceTier,\n\t\t\t\ttools: [],\n\t\t\t},\n\t\t\tconvertToLlm: convertToLlmWithBlockImages,\n\t\t\tstreamFn: createNativeInferenceStream(async (model, _context, options) => {\n\t\t\t\tif (!modelRegistry.hasConfiguredAuth(model)) {\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`Selected model ${model.provider}/${model.id} needs authentication. Use /login to configure this provider.`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tconst auth = await modelRegistry.getApiKeyAndHeaders(model);\n\t\t\t\tif (!auth.ok) {\n\t\t\t\t\tthrow new Error(auth.error);\n\t\t\t\t}\n\t\t\t\tconst providerRetrySettings = settingsManager.getProviderRetrySettings();\n\t\t\t\treturn {\n\t\t\t\t\t...options,\n\t\t\t\t\tapiKey: auth.apiKey,\n\t\t\t\t\tauthSourceToken: auth.sourceToken,\n\t\t\t\t\ttimeoutMs: options?.timeoutMs ?? providerRetrySettings.timeoutMs,\n\t\t\t\t\tmaxRetries: options?.maxRetries ?? providerRetrySettings.maxRetries,\n\t\t\t\t\tmaxRetryDelayMs: options?.maxRetryDelayMs ?? providerRetrySettings.maxRetryDelayMs,\n\t\t\t\t\theaders: auth.headers || options?.headers ? { ...auth.headers, ...options?.headers } : undefined,\n\t\t\t\t};\n\t\t\t}),\n\t\t\tonPayload: async (payload, _model) => {\n\t\t\t\tconst runner = extensionRunnerRef.current;\n\t\t\t\tif (!runner?.hasHandlers(\"before_provider_request\")) {\n\t\t\t\t\treturn payload;\n\t\t\t\t}\n\t\t\t\treturn runner.emitBeforeProviderRequest(payload);\n\t\t\t},\n\t\t\tonResponse: async (response, _model) => {\n\t\t\t\tconst runner = extensionRunnerRef.current;\n\t\t\t\tif (!runner?.hasHandlers(\"after_provider_response\")) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tawait runner.emit({\n\t\t\t\t\ttype: \"after_provider_response\",\n\t\t\t\t\tstatus: response.status,\n\t\t\t\t\theaders: response.headers,\n\t\t\t\t});\n\t\t\t},\n\t\t\tsessionId: sessionManager.getSessionId(),\n\t\t\ttransformContext: async (messages) => {\n\t\t\t\tconst runner = extensionRunnerRef.current;\n\t\t\t\tif (!runner) return messages;\n\t\t\t\treturn runner.emitContext(messages);\n\t\t\t},\n\t\t\tsteeringMode: settingsManager.getSteeringMode(),\n\t\t\tfollowUpMode: settingsManager.getFollowUpMode(),\n\t\t\ttransport: settingsManager.getTransport(),\n\t\t\tthinkingBudgets: settingsManager.getThinkingBudgets(),\n\t\t\tmaxRetryDelayMs: settingsManager.getProviderRetrySettings().maxRetryDelayMs,\n\t\t});\n\n\t\tif (hasExistingSession) {\n\t\t\tagent.state.messages = existingSession.messages;\n\t\t\tif (!hasThinkingEntry) {\n\t\t\t\tawait sessionManager.appendThinkingLevelChange(thinkingLevel);\n\t\t\t}\n\t\t} else {\n\t\t\tif (model) {\n\t\t\t\tawait sessionManager.appendModelChange(model.provider, model.id);\n\t\t\t}\n\t\t\tawait sessionManager.appendThinkingLevelChange(thinkingLevel);\n\t\t}\n\t\tif (!hasServiceTierEntry) {\n\t\t\tawait sessionManager.appendServiceTierChange(serviceTierPreference);\n\t\t}\n\n\t\tsession = new AgentSession({\n\t\t\tinvocationOutputLimits: options.invocationOutputLimits,\n\t\t\trequestTokenBudget: options.requestTokenBudget,\n\t\t\tcontextMode,\n\t\t\tagent,\n\t\t\tsessionManager,\n\t\t\tsettingsManager,\n\t\t\tserviceTierPreference,\n\t\t\tcwd,\n\t\t\t// Only the explicit dir — the default may not match injected custom storage.\n\t\t\tagentDir: options.agentDir,\n\t\t\tscopedModels: options.scopedModels,\n\t\t\tresourceLoader,\n\t\t\tcustomTools: options.customTools,\n\t\t\tmodelRegistry,\n\t\t\tmcpManager,\n\t\t\tinitialActiveToolNames,\n\t\t\tallowedToolNames,\n\t\t\tincludeGoals,\n\t\t\tincludeCompactSkill: options.includeCompactSkill,\n\t\t\trlmHeartbeatController: options.rlmHeartbeatController,\n\t\t\tagentMessageController: options.agentMessageController,\n\t\t\tagentObserveController: options.agentObserveController,\n\t\t\textensionRunnerRef,\n\t\t\trlmDepth: options.rlmDepth,\n\t\t\trlmMaxDepth: options.rlmMaxDepth,\n\t\t\trlmSessionDir: options.rlmSessionDir,\n\t\t\trlmParentNodeId: options.rlmParentNodeId,\n\t\t\trlmParentAgent: options.rlmParentAgent,\n\t\t\trlmChildAdmission: options.rlmChildAdmission,\n\t\t\trlmSubagentCapacity: options.rlmSubagentCapacity,\n\t\t\trlmRootAdmission: options.rlmRootAdmission,\n\t\t\tsemanticParentSessionId: options.semanticParentSessionId,\n\t\t\tsemanticSpawnedByRequestId: options.semanticSpawnedByRequestId,\n\t\t\tsubagentRuntimeHost: options.subagentRuntimeHost,\n\t\t\tsessionStartEvent: options.sessionStartEvent,\n\t\t\tprewarmIpythonKernel: options.prewarmIpythonKernel,\n\t\t\tautonomous: options.autonomous,\n\t\t\tserializedRefine: options.serializedRefine,\n\t\t\tinitialGoal: options.initialGoal,\n\t\t});\n\t\tawait session.initialize();\n\t\tconst extensionsResult = resourceLoader.getExtensions();\n\n\t\treturn {\n\t\t\tsession,\n\t\t\textensionsResult,\n\t\t\tmodelFallbackMessage,\n\t\t};\n\t} catch (error) {\n\t\ttry {\n\t\t\tconst admitted = options.rlmChildAdmission?.session ?? options.rlmRootAdmission?.session;\n\t\t\tconst failedSession = session ?? (admitted?.sessionManager === sessionManager ? admitted : undefined);\n\t\t\tif (failedSession) await failedSession.disposeAsync();\n\t\t\telse {\n\t\t\t\tawait sessionManager.close();\n\t\t\t\tawait options.rlmChildAdmission?.confirmUnboundCleanup();\n\t\t\t}\n\t\t} catch (cleanupError) {\n\t\t\tif (cleanupError === error || (error instanceof AggregateError && error.errors.includes(cleanupError)))\n\t\t\t\tthrow error;\n\t\t\tthrow new AggregateError([error, cleanupError], \"Session creation and cleanup failed\");\n\t\t}\n\t\tthrow error;\n\t}\n}\n"]}