@makaio/framework 1.0.0-dev-1789609124644 → 1.0.0-dev-1790066089222

package/dist/credential-ref-w4ZYpYW0.d.mts

@@ -0,0 +1,49 @@
+import { z } from "zod";
+
+//#region core/contracts/src/config/credential-ref.d.ts
+/**
+ * Scheme prefix of every supported credential-reference format.
+ *
+ * Credential references are resolved at runtime by the active credential
+ * provider. Supported formats:
+ * - `keychain:<service>:<account>` - OS-backed secure store
+ * - `env:<VAR_NAME>` - Environment variable
+ * - `file:<path>` - File path
+ * - `stored:providerConfig:<configId>:<key>` - ConfigId-keyed credential store
+ *   (resolved via `CredentialSubjects.get({ configId })`)
+ *
+ * These prefixes are the format's public vocabulary, so consumers that have to
+ * name a scheme — diagnostics, resolvers, documentation — read them from here
+ * rather than restating them. {@link CredentialRefSchema} remains the sole
+ * authority on whether a given string is a valid reference.
+ */
+declare const CREDENTIAL_REF_PREFIXES: {
+  /** Environment-variable reference prefix. */readonly env: "env:"; /** File-path reference prefix. */
+  readonly file: "file:"; /** OS keychain reference prefix. */
+  readonly keychain: "keychain:"; /** Provider-config-keyed credential store reference prefix. */
+  readonly stored: "stored:providerConfig:";
+};
+declare const CredentialRefSchema: z.core.$ZodBranded<z.ZodString, "CredentialRef", "out">;
+type CredentialRef = z.infer<typeof CredentialRefSchema>;
+/**
+ * Build a stored credential reference keyed by provider config ID.
+ *
+ * The format is `stored:providerConfig:<configId>:<key>`. The last colon in the
+ * string acts as the configId/key separator, so `configId` may contain colons
+ * (e.g. `github:oauth-default`) but `key` must be a colon-free identifier.
+ * @param configId - Provider config ID; may contain colons (e.g. `github:oauth-default`)
+ * @param key - Credential key — must not contain colons (e.g. `apiKey`, `pat`)
+ * @returns Stored credential reference string
+ */
+declare function buildStoredCredentialRef(configId: string, key: string): CredentialRef;
+/**
+ * Parse a stored credential reference into its parts.
+ * @param ref - Credential reference string
+ * @returns Parsed parts, or `null` when the ref is not a stored credential ref
+ */
+declare function parseStoredCredentialRef(ref: CredentialRef): {
+  configId: string;
+  key: string;
+} | null;
+//#endregion
+export { parseStoredCredentialRef as a, buildStoredCredentialRef as i, CredentialRef as n, CredentialRefSchema as r, CREDENTIAL_REF_PREFIXES as t };

package/dist/{definition-CuaBQyde.d.mts → definition-DeIGoROj.d.mts}

@@ -1,4 +1,4 @@
-import { l as JsonValue$1 } from "./json-value-Ymw2f8i_.mjs";
+import { l as JsonValue$1 } from "./json-value-Bjl8jzom.mjs";
 import { z } from "zod";
 import * as _$_makaio_contracts0 from "@makaio/framework/contracts";
 

package/dist/{descriptor-to-package-Dw8dnl5E.mjs → descriptor-to-package-BPIArq6N.mjs}

@@ -1 +1 @@
-function e(e){return{name:e.name,displayName:e.displayName,version:e.version,...e.surface===void 0?{}:{surface:e.surface},...e.dependencies===void 0?{}:{dependencies:e.dependencies},...e.requires===void 0?{}:{requires:e.requires},...e.provides===void 0?{}:{provides:e.provides}}}export{e as t};
+function e(e){return{name:e.name,displayName:e.displayName,version:e.version,...e.surface===void 0?{}:{surface:e.surface},...e.dependencies===void 0?{}:{dependencies:e.dependencies},...e.requires===void 0?{}:{requires:e.requires},...e.provides===void 0?{}:{provides:e.provides},...e.critical===void 0?{}:{critical:e.critical}}}export{e as t};

package/dist/{detached-extension-handle-DN3aqLyq.mjs → detached-extension-handle-W5_yfCyE.mjs}

@@ -1 +1 @@
-import{t as e}from"./descriptor-to-package-Dw8dnl5E.mjs";import{t}from"./jsonl-transport-Bg033Ng0.mjs";import{z as n}from"zod";import{createBusNamespace as r}from"@makaio/framework/core";const i={idle:[`starting`],starting:[`running`,`crashed`,`stopping`],running:[`stopping`,`crashed`],stopping:[`stopped`],stopped:[`starting`],crashed:[`starting`,`stopped`]};function a(e,t){if(!i[e].includes(t))throw Error(`Invalid state transition: ${e} → ${t}`)}function o(e){return new Promise(t=>{if(e.exitCode!==null||e.signalCode!==null){t(!0);return}e.once(`exit`,()=>t(!0))})}function s(e){let{spawn:n,healthTimeoutMs:r=3e4,shutdownTimeoutMs:i=5e3,restartPolicy:s=`none`,onReady:c,onExit:l,onStateChange:u}=e,d=`idle`,f;function p(e){a(d,e),d=e,u?.(d)}function m(e){let t=f;if(f=void 0,t?.close(),d===`stopping`){p(`stopped`),l?.(e);return}if(d===`running`){if(e!==0){p(`crashed`),l?.(e),(s===`on-crash`||s===`always`)&&h().catch(e=>{console.error(`[ProcessLifecycle:${n.processName??n.command}] Restart failed:`,e instanceof Error?e.message:e)});return}p(`stopping`),p(`stopped`),l?.(e),s===`always`&&h().catch(e=>{console.error(`[ProcessLifecycle:${n.processName??n.command}] Restart failed:`,e instanceof Error?e.message:e)})}}async function h(){p(`starting`);let e=t(n);f=e;let i=e.process;await new Promise((t,a)=>{let o=!1;function s(e){o||(o=!0,clearTimeout(u),d(),i.off(`exit`,h),e())}let u=setTimeout(()=>{s(()=>{e.close(),f=void 0;try{p(`crashed`)}catch{}a(Error(`Process health timeout after ${r}ms: ${n.processName??n.command}`))})},r),d=e.onMessage(()=>{s(()=>{try{p(`running`)}catch(e){a(e);return}c?.(),i.once(`exit`,m),t()})});function h(e){s(()=>{f=void 0;try{p(`crashed`)}catch{}l?.(e),a(Error(`Process exited with code ${String(e)} before signaling readiness`))})}i.once(`exit`,h)})}async function g(){if(d===`stopped`||d===`idle`)return;if(d===`crashed`){f?.close(),f=void 0,p(`stopped`);return}if(d!==`stopping`&&p(`stopping`),!f){d===`stopping`&&p(`stopped`);return}let e=f,t=e.process;if(t.exitCode!==null){e.close(),f===e&&(f=void 0),d===`stopping`&&p(`stopped`);return}t.kill(`SIGTERM`);let n;await Promise.race([o(t).then(()=>(clearTimeout(n),!0)),new Promise(e=>{n=setTimeout(()=>e(!1),i)})])||(t.kill(`SIGKILL`),await o(t)),d===`stopping`&&p(`stopped`),e.close(),f===e&&(f=void 0)}return{get transport(){return f},get state(){return d},start:h,stop:g}}const c=n.object({dataDir:n.string().optional(),machineId:n.string().optional(),makaioHome:n.string().optional(),platform:n.string().optional(),username:n.string().optional()}),l={init:{request:n.object({config:n.unknown().optional(),context:c.optional()}),response:n.object({ready:n.boolean()})},ready:n.object({ready:n.boolean(),config:n.unknown().optional(),context:c.optional()}).passthrough(),destroy:{request:n.object({reason:n.string().optional()}),response:n.object({stopped:n.boolean()})},stopped:n.object({stopped:n.boolean()}).passthrough()};function u(e,t){return e.bus.registerNamespace(r(`extension.${t}`,l)).subjects}function d(e,t){let n;return()=>(n??=u(e,t),n)}function f(e){return{dataDir:e.dataDir,machineId:e.machineId,makaioHome:e.makaioHome,platform:e.platform,username:e.username}}var p=class{descriptor;ctx;extensionPath;getLifecycleSubjects;transport=null;unregister=null;constructor(e,t,n){this.descriptor=e,this.ctx=t,this.extensionPath=n,this.getLifecycleSubjects=d(t,e.name)}async init(){let{StdioServerTransport:e}=await import(`./src-CbAw9kjJ.mjs`),{transport:t}=this.descriptor,n=this.getLifecycleSubjects(),r=new e({name:this.descriptor.name,spawn:{command:t.command,args:t.args,cwd:this.extensionPath,env:t.env,processName:this.descriptor.name}}),i=null;try{let e=this.ctx.bus.registerTransport(r);i=e.unregister,await r.connect(),await r.ready,await e.ready,this.transport=r,this.unregister=i,await this.ctx.bus.request(n.init,{config:this.ctx.config??this.descriptor.config?.defaults,context:f(this.ctx)},{timeout:t.healthTimeoutMs})}catch(e){throw i?.(),await r.disconnect(),this.transport=null,this.unregister=null,e}}async destroy(){if(this.transport!==null){let e=this.getLifecycleSubjects();try{await this.ctx.bus.request(e.destroy,{reason:`runtime-shutdown`},{timeout:this.descriptor.transport.shutdownTimeoutMs})}catch(e){console.warn(`[extensions] ${this.descriptor.name}: detached destroy lifecycle request did not complete before disconnect:`,e instanceof Error?e.message:e)}}this.unregister?.(),this.unregister=null,await this.transport?.disconnect(),this.transport=null}},m=class{descriptor;ctx;extensionPath;getLifecycleSubjects;lifecycle=null;constructor(e,t,n){this.descriptor=e,this.ctx=t,this.extensionPath=n,this.getLifecycleSubjects=d(t,e.name)}async init(){let{transport:e}=this.descriptor;if(!this.ctx.busUrl)throw Error(`[extensions] ${this.descriptor.name}: bus-websocket transport requires NodeExtensionContext.busUrl`);let t=this.getLifecycleSubjects();this.lifecycle=s({spawn:{command:e.command,args:e.args,cwd:this.extensionPath,env:{...e.env,MAKAIO_BUS_TRANSPORT:`websocket`,MAKAIO_BUS_URL:this.ctx.busUrl,MAKAIO_EXTENSION_NAME:this.descriptor.name},processName:this.descriptor.name},healthTimeoutMs:e.healthTimeoutMs,shutdownTimeoutMs:e.shutdownTimeoutMs,restartPolicy:`restartPolicy`in e?e.restartPolicy:void 0});try{await this.lifecycle.start(),await this.ctx.bus.request(t.init,{config:this.ctx.config??this.descriptor.config?.defaults,context:f(this.ctx)},{timeout:e.healthTimeoutMs})}catch(e){throw await this.lifecycle.stop(),this.lifecycle=null,e}}async destroy(){if(this.lifecycle!==null){let e=this.getLifecycleSubjects();try{await this.ctx.bus.request(e.destroy,{reason:`runtime-shutdown`},{timeout:this.descriptor.transport.shutdownTimeoutMs})}catch(e){console.warn(`[extensions] ${this.descriptor.name}: detached destroy lifecycle request did not complete before process stop:`,e instanceof Error?e.message:e)}await this.lifecycle.stop(),this.lifecycle=null}}},h=class{descriptor;ctx;extensionPath;bridge=null;constructor(e,t,n){this.descriptor=e,this.ctx=t,this.extensionPath=n}async init(){let{startMcpClientBridge:e}=await import(`@makaio/framework/mcp-http-server`),{transport:t}=this.descriptor;this.bridge=await e({command:t.command,args:t.args,env:t.env,cwd:this.extensionPath,extensionName:this.descriptor.name,bus:this.ctx.bus})}async destroy(){this.bridge!==null&&(await this.bridge.close(),this.bridge=null)}};function g(t,n){return{...e(t),create(e){return t.transport.type===`bus-stdio`?new p(t,e,n):t.transport.type===`mcp-stdio`?new h(t,e,n):new m(t,e,n)}}}export{g as createDetachedExtensionPackage};
+import{t as e}from"./descriptor-to-package-BPIArq6N.mjs";import{t}from"./jsonl-transport-Ct1RWs0h.mjs";import{z as n}from"zod";import{createBusNamespace as r}from"@makaio/framework/core";const i={idle:[`starting`],starting:[`running`,`crashed`,`stopping`],running:[`stopping`,`crashed`],stopping:[`stopped`],stopped:[`starting`],crashed:[`starting`,`stopped`]};function a(e,t){if(!i[e].includes(t))throw Error(`Invalid state transition: ${e} → ${t}`)}function o(e){return new Promise(t=>{if(e.exitCode!==null||e.signalCode!==null){t(!0);return}e.once(`exit`,()=>t(!0))})}function s(e){let{spawn:n,healthTimeoutMs:r=3e4,shutdownTimeoutMs:i=5e3,restartPolicy:s=`none`,onReady:c,onExit:l,onStateChange:u}=e,d=`idle`,f;function p(e){a(d,e),d=e,u?.(d)}function m(e){let t=f;if(f=void 0,t?.close(),d===`stopping`){p(`stopped`),l?.(e);return}if(d===`running`){if(e!==0){p(`crashed`),l?.(e),(s===`on-crash`||s===`always`)&&h().catch(e=>{console.error(`[ProcessLifecycle:${n.processName??n.command}] Restart failed:`,e instanceof Error?e.message:e)});return}p(`stopping`),p(`stopped`),l?.(e),s===`always`&&h().catch(e=>{console.error(`[ProcessLifecycle:${n.processName??n.command}] Restart failed:`,e instanceof Error?e.message:e)})}}async function h(){p(`starting`);let e=t(n);f=e;let i=e.process;await new Promise((t,a)=>{let o=!1;function s(e){o||(o=!0,clearTimeout(u),d(),i.off(`exit`,h),e())}let u=setTimeout(()=>{s(()=>{e.close(),f=void 0;try{p(`crashed`)}catch{}a(Error(`Process health timeout after ${r}ms: ${n.processName??n.command}`))})},r),d=e.onMessage(()=>{s(()=>{try{p(`running`)}catch(e){a(e);return}c?.(),i.once(`exit`,m),t()})});function h(e){s(()=>{f=void 0;try{p(`crashed`)}catch{}l?.(e),a(Error(`Process exited with code ${String(e)} before signaling readiness`))})}i.once(`exit`,h)})}async function g(){if(d===`stopped`||d===`idle`)return;if(d===`crashed`){f?.close(),f=void 0,p(`stopped`);return}if(d!==`stopping`&&p(`stopping`),!f){d===`stopping`&&p(`stopped`);return}let e=f,t=e.process;if(t.exitCode!==null){e.close(),f===e&&(f=void 0),d===`stopping`&&p(`stopped`);return}t.kill(`SIGTERM`);let n;await Promise.race([o(t).then(()=>(clearTimeout(n),!0)),new Promise(e=>{n=setTimeout(()=>e(!1),i)})])||(t.kill(`SIGKILL`),await o(t)),d===`stopping`&&p(`stopped`),e.close(),f===e&&(f=void 0)}return{get transport(){return f},get state(){return d},start:h,stop:g}}const c=n.object({dataDir:n.string().optional(),machineId:n.string().optional(),makaioHome:n.string().optional(),platform:n.string().optional(),username:n.string().optional()}),l={init:{request:n.object({config:n.unknown().optional(),context:c.optional()}),response:n.object({ready:n.boolean()})},ready:n.object({ready:n.boolean(),config:n.unknown().optional(),context:c.optional()}).passthrough(),destroy:{request:n.object({reason:n.string().optional()}),response:n.object({stopped:n.boolean()})},stopped:n.object({stopped:n.boolean()}).passthrough()};function u(e,t){return e.bus.registerNamespace(r(`extension.${t}`,l)).subjects}function d(e,t){let n;return()=>(n??=u(e,t),n)}function f(e){return{dataDir:e.dataDir,machineId:e.machineId,makaioHome:e.makaioHome,platform:e.platform,username:e.username}}var p=class{descriptor;ctx;extensionPath;getLifecycleSubjects;transport=null;unregister=null;constructor(e,t,n){this.descriptor=e,this.ctx=t,this.extensionPath=n,this.getLifecycleSubjects=d(t,e.name)}async init(){let{StdioServerTransport:e}=await import(`./src-C0sw_Vs_.mjs`),{transport:t}=this.descriptor,n=this.getLifecycleSubjects(),r=new e({name:this.descriptor.name,spawn:{command:t.command,args:t.args,cwd:this.extensionPath,env:t.env,processName:this.descriptor.name}}),i=null;try{let e=this.ctx.bus.registerTransport(r);i=e.unregister,await r.connect(),await r.ready,await e.ready,this.transport=r,this.unregister=i,await this.ctx.bus.request(n.init,{config:this.ctx.config??this.descriptor.config?.defaults,context:f(this.ctx)},{timeout:t.healthTimeoutMs})}catch(e){throw i?.(),await r.disconnect(),this.transport=null,this.unregister=null,e}}async destroy(){if(this.transport!==null){let e=this.getLifecycleSubjects();try{await this.ctx.bus.request(e.destroy,{reason:`runtime-shutdown`},{timeout:this.descriptor.transport.shutdownTimeoutMs})}catch(e){console.warn(`[extensions] ${this.descriptor.name}: detached destroy lifecycle request did not complete before disconnect:`,e instanceof Error?e.message:e)}}this.unregister?.(),this.unregister=null,await this.transport?.disconnect(),this.transport=null}},m=class{descriptor;ctx;extensionPath;getLifecycleSubjects;lifecycle=null;constructor(e,t,n){this.descriptor=e,this.ctx=t,this.extensionPath=n,this.getLifecycleSubjects=d(t,e.name)}async init(){let{transport:e}=this.descriptor;if(!this.ctx.busUrl)throw Error(`[extensions] ${this.descriptor.name}: bus-websocket transport requires NodeExtensionContext.busUrl`);let t=this.getLifecycleSubjects();this.lifecycle=s({spawn:{command:e.command,args:e.args,cwd:this.extensionPath,env:{...e.env,MAKAIO_BUS_TRANSPORT:`websocket`,MAKAIO_BUS_URL:this.ctx.busUrl,MAKAIO_EXTENSION_NAME:this.descriptor.name},processName:this.descriptor.name},healthTimeoutMs:e.healthTimeoutMs,shutdownTimeoutMs:e.shutdownTimeoutMs,restartPolicy:`restartPolicy`in e?e.restartPolicy:void 0});try{await this.lifecycle.start(),await this.ctx.bus.request(t.init,{config:this.ctx.config??this.descriptor.config?.defaults,context:f(this.ctx)},{timeout:e.healthTimeoutMs})}catch(e){throw await this.lifecycle.stop(),this.lifecycle=null,e}}async destroy(){if(this.lifecycle!==null){let e=this.getLifecycleSubjects();try{await this.ctx.bus.request(e.destroy,{reason:`runtime-shutdown`},{timeout:this.descriptor.transport.shutdownTimeoutMs})}catch(e){console.warn(`[extensions] ${this.descriptor.name}: detached destroy lifecycle request did not complete before process stop:`,e instanceof Error?e.message:e)}await this.lifecycle.stop(),this.lifecycle=null}}},h=class{descriptor;ctx;extensionPath;bridge=null;constructor(e,t,n){this.descriptor=e,this.ctx=t,this.extensionPath=n}async init(){let{startMcpClientBridge:e}=await import(`@makaio/framework/mcp-http-server`),{transport:t}=this.descriptor;this.bridge=await e({command:t.command,args:t.args,env:t.env,cwd:this.extensionPath,extensionName:this.descriptor.name,bus:this.ctx.bus})}async destroy(){this.bridge!==null&&(await this.bridge.close(),this.bridge=null)}};function g(t,n){return{...e(t),create(e){return t.transport.type===`bus-stdio`?new p(t,e,n):t.transport.type===`mcp-stdio`?new h(t,e,n):new m(t,e,n)}}}export{g as createDetachedExtensionPackage};

package/dist/drizzle/0040_session_generation.sql

@@ -0,0 +1 @@
+ALTER TABLE `sessions` ADD `generation` integer DEFAULT 0 NOT NULL;

package/dist/drizzle/0041_session_principal_owner.sql

@@ -0,0 +1 @@
+ALTER TABLE `sessions` ADD `owner_principal_id` text;

package/dist/drizzle/meta/_journal.json

@@ -281,6 +281,20 @@
       "when": 1789233151788,
       "tag": "0039_m_mtyn7x1q",
       "breakpoints": true
+    },
+    {
+      "idx": 40,
+      "version": "6",
+      "when": 1789612527781,
+      "tag": "0040_session_generation",
+      "breakpoints": true
+    },
+    {
+      "idx": 41,
+      "version": "6",
+      "when": 1790032065513,
+      "tag": "0041_session_principal_owner",
+      "breakpoints": true
     }
   ]
 }

package/dist/{execution-attempt-owner-recovery-CE_rvHKE.mjs → execution-attempt-owner-recovery-BZOEVYFH.mjs}

@@ -1 +1 @@
-import{a as e}from"./execution-attempt-repository-aabFKcXN.mjs";import{canonicalStringify as t}from"@makaio/framework/utils";import{ExecutionAttemptInstructionSchema as n}from"@makaio/framework/contracts";function r(e){return typeof e==`object`&&!!e}function i(e){if(!(!r(e)||Object.isFrozen(e))){Object.freeze(e);for(let t of Object.values(e))i(t)}}function a(e,t){let n=t(structuredClone(e));return i(n),n}function o(e){return a(e,e=>n.parse(e))}function s(e,t){if(typeof e!=`string`||e.length===0)throw TypeError(`${t} must be a non-empty string`)}function c(e){let{executionId:t,requestKey:n}=e;return s(t,`executionId`),s(n,`requestKey`),{executionId:t,requestKey:n,instruction:o(e.instruction)}}function l(e){let{executionAttemptId:t,bootstrapTimeoutMs:n}=e;if(s(t,`executionAttemptId`),!Number.isSafeInteger(n)||n<=0)throw RangeError(`bootstrapTimeoutMs must be a positive safe integer`);return{...c(e),executionAttemptId:t,bootstrapTimeoutMs:n}}function u(e){let{executionId:t,executionAttemptId:n}=e;return s(t,`executionId`),s(n,`executionAttemptId`),{executionId:t,executionAttemptId:n}}function d(e,n){if(n===null||n.executionId!==e.executionId)throw Error(`Corrupt execution attempt request binding`);return t(n.instruction)===t(e.instruction)?{kind:`replayed`,attempt:structuredClone(n)}:{kind:`conflict`}}function f(t,n,r){let{attempt:i,activeAttemptId:a,outcomeText:o}=n;if(i===null||i.executionId!==t.executionId)return{kind:`not-found`};if(i.executionAttemptId!==t.executionAttemptId)throw Error(`Corrupt execution attempt settlement identity`);let s={attempt:structuredClone(i),isCurrentAttempt:a===i.executionAttemptId};if(i.status!==`settled`&&i.settlementKind==null&&o===null)return{kind:`unsettled`,...s};if(i.status===`settled`&&i.settlementKind===`outcome`&&o!==null)return{kind:`outcome`,...s,result:{text:o,outcome:e(r,o)},controlObservation:structuredClone(n.controlObservation)};if(i.status===`settled`&&(i.settlementKind===`abandoned`||i.settlementKind===`infrastructure-failure`)&&o===null)return{kind:`settled-without-outcome`,...s};throw Error(`Corrupt execution attempt settlement facts`)}export{u as a,l as i,d as n,o,c as r,a as s,f as t};
+import{a as e}from"./execution-attempt-repository-CY289HlC.mjs";import{canonicalStringify as t}from"@makaio/framework/utils";import{ExecutionAttemptInstructionSchema as n}from"@makaio/framework/contracts";function r(e){return typeof e==`object`&&!!e}function i(e){if(!(!r(e)||Object.isFrozen(e))){Object.freeze(e);for(let t of Object.values(e))i(t)}}function a(e,t){let n=t(structuredClone(e));return i(n),n}function o(e){return a(e,e=>n.parse(e))}function s(e,t){if(typeof e!=`string`||e.length===0)throw TypeError(`${t} must be a non-empty string`)}function c(e){let{executionId:t,requestKey:n}=e;return s(t,`executionId`),s(n,`requestKey`),{executionId:t,requestKey:n,instruction:o(e.instruction)}}function l(e){let{executionAttemptId:t,bootstrapTimeoutMs:n}=e;if(s(t,`executionAttemptId`),!Number.isSafeInteger(n)||n<=0)throw RangeError(`bootstrapTimeoutMs must be a positive safe integer`);return{...c(e),executionAttemptId:t,bootstrapTimeoutMs:n}}function u(e){let{executionId:t,executionAttemptId:n}=e;return s(t,`executionId`),s(n,`executionAttemptId`),{executionId:t,executionAttemptId:n}}function d(e,n){if(n===null||n.executionId!==e.executionId)throw Error(`Corrupt execution attempt request binding`);return t(n.instruction)===t(e.instruction)?{kind:`replayed`,attempt:structuredClone(n)}:{kind:`conflict`}}function f(t,n,r){let{attempt:i,activeAttemptId:a,outcomeText:o}=n;if(i===null||i.executionId!==t.executionId)return{kind:`not-found`};if(i.executionAttemptId!==t.executionAttemptId)throw Error(`Corrupt execution attempt settlement identity`);let s={attempt:structuredClone(i),isCurrentAttempt:a===i.executionAttemptId};if(i.status!==`settled`&&i.settlementKind==null&&o===null)return{kind:`unsettled`,...s};if(i.status===`settled`&&i.settlementKind===`outcome`&&o!==null)return{kind:`outcome`,...s,result:{text:o,outcome:e(r,o)},controlObservation:structuredClone(n.controlObservation)};if(i.status===`settled`&&(i.settlementKind===`abandoned`||i.settlementKind===`infrastructure-failure`)&&o===null)return{kind:`settled-without-outcome`,...s};throw Error(`Corrupt execution attempt settlement facts`)}export{u as a,l as i,d as n,o,c as r,a as s,f as t};

package/dist/extension-C6ANjR33.mjs

@@ -0,0 +1 @@
+import{u as e}from"./kind-registration-Dzfo6kyb.mjs";import{n as t}from"./definition-Dd7bDWpP.mjs";import{n,t as r}from"./version-PuU2KG3I.mjs";import{z as i}from"zod";const a=i.object({entrypoint:i.string().startsWith(`/`,{message:`Entrypoint must be a URL path starting with "/"`})}),o=i.object({endpoint:i.string().url().optional()}),s=i.union([t,i.object({anthropic:o.optional(),openai:o.optional()}).refine(e=>Object.keys(e).length>0,{message:`ProtocolRef config object must specify at least one protocol`})]),c=i.object({id:i.string().min(1),version:n,binaryVersion:n.optional()}),l=i.object({name:i.string().min(1),displayName:i.string().min(1).optional(),description:i.string().optional(),clients:i.array(c).readonly().optional(),protocols:i.array(s).readonly(),defaultProvider:i.string().min(1).optional()}),u=i.object({id:i.string().min(1),name:i.string().min(1),description:i.string().optional(),binary:i.object({name:i.string().min(1),managed:i.boolean().optional(),version:r.optional()}).strict().refine(e=>e.managed!==!0||e.version!==void 0,{message:`binary.version is required when binary.managed is true`,path:[`version`]}).refine(e=>e.version===void 0||e.managed===!0,{message:`binary.managed must be true when binary.version is provided`,path:[`managed`]}).optional()}).strict(),d=i.object({id:i.string().min(1),name:i.string().min(1),description:i.string().optional()}),f=i.object({prefix:i.string().min(1),description:i.string().optional(),stage:i.enum([`gather`,`transform`,`action`]).optional()}),p=i.object({adapterName:i.string().min(1),displayName:i.string().min(1),logFilePattern:i.string().min(1).optional()}),m=i.object({id:i.string().min(1),label:i.string().min(1),description:i.string().optional(),icon:i.string().min(1).optional(),selectionMode:i.enum([`single`,`multi`]),messageRoles:i.array(i.enum([`user`,`assistant`])).readonly().optional()}),h=i.enum([`beforeCreate`,`beforeRevise`,`afterCreate`,`afterRevise`,`afterStatusChanged`,`afterObservationAdded`]),g=i.object({id:i.string().min(1),event:h,kind:i.string().min(1).optional(),schemaVersion:e.optional()}),_=i.object({tiles:i.boolean().optional(),widgets:i.boolean().optional(),pages:i.boolean().optional(),routes:i.boolean().optional()}),v={adapters:`adapter`,clients:`client`,providers:`provider`,hashTriggers:`hash trigger`,logImporters:`log importer`,sessionEventActions:`session event action`,artifactLifecycleHooks:`artifact lifecycle hook`};function y(e,t,n){e.addIssue({code:i.ZodIssueCode.custom,path:[t],message:`Duplicate ${v[t]} contribution identifier "${n}"`})}function b(e,t){let n=new Set,r=new Set,i=[];for(let a of e??[]){let e=t(a);if(n.has(e)){r.has(e)||(r.add(e),i.push(e));continue}n.add(e)}return i}const x=i.object({adapters:i.array(l).readonly().optional(),clients:i.array(u).readonly().optional(),providers:i.array(d).readonly().optional(),hashTriggers:i.array(f).readonly().optional(),logImporters:i.array(p).readonly().optional(),sessionEventActions:i.array(m).readonly().optional(),artifactLifecycleHooks:i.array(g).readonly().optional(),create:i.boolean().optional(),tools:i.boolean().optional(),bootstrap:i.boolean().optional(),namespace:i.boolean().optional(),configSchema:i.boolean().optional(),uiConfig:i.boolean().optional(),ui:_.optional()}).strict().superRefine((e,t)=>{for(let n of b(e.adapters,e=>e.name))y(t,`adapters`,n);for(let n of b(e.clients,e=>e.id))y(t,`clients`,n);for(let n of b(e.providers,e=>e.id))y(t,`providers`,n);for(let n of b(e.hashTriggers,e=>e.prefix))y(t,`hashTriggers`,n);for(let n of b(e.logImporters,e=>e.adapterName))y(t,`logImporters`,n);for(let n of b(e.sessionEventActions,e=>e.id))y(t,`sessionEventActions`,n);for(let n of b(e.artifactLifecycleHooks,e=>e.id))y(t,`artifactLifecycleHooks`,n)}),S=i.string().trim().min(1).transform(e=>e),C=i.object({name:i.string().min(1),required:i.boolean().optional()}),w=i.object({id:i.string(),style:i.enum([`tray-popover`,`utility`,`panel`]),width:i.number().optional(),height:i.number().optional(),singleton:i.boolean().optional(),params:i.array(C).readonly().optional()}).superRefine((e,t)=>{let n=new Set;for(let[r,a]of e.params?.entries()??[]){if(!n.has(a.name)){n.add(a.name);continue}t.addIssue({code:i.ZodIssueCode.custom,message:`Duplicate window param "${a.name}"`,path:[`params`,r,`name`]})}}),T=i.object({label:i.string(),section:i.enum([`utilities`,`tools`,`views`]).optional(),opensWindow:i.string().optional(),action:i.string().optional()}),E=i.object({name:i.string().min(1),description:i.string(),required:i.boolean().optional(),positional:i.boolean().optional(),short:i.string().regex(/^-[A-Za-z0-9]$/,`Expected a short flag like -p`).optional(),type:i.enum([`string`,`boolean`,`number`]).optional()}),D=i.object({name:i.string().min(1),description:i.string(),args:i.array(E).readonly().optional()}),O=i.object({name:i.string().min(1),description:i.string(),subcommands:i.array(D).readonly().optional(),hasInteractive:i.boolean().optional(),canProvideBus:i.boolean().optional()}),k=[`sqlite`,`postgres`];function ee(e){if(e!==void 0)return typeof e==`string`?e:e.sqlite??Object.values(e).find(e=>e!==void 0)}function te(e){if(e===void 0)return[];if(typeof e==`string`)return[e];let t=new Set;for(let n of Object.values(e))n!==void 0&&t.add(n);return[...t]}const A=i.string().min(1).refine(e=>!/^(?:[\\/]|[A-Za-z]:)/.test(e),`Expected a relative path`).refine(e=>!e.split(/[\\/]/).some(e=>e===``||e===`.`||e===`..`),`Path must not contain empty or dot segments`),j=i.object({migrations:i.union([A,i.object({sqlite:A.optional(),postgres:A.optional()}).strict().refine(e=>Object.values(e).some(e=>e!==void 0),`Per-dialect storage.migrations must declare at least one chain`)]).optional(),migrationSourceId:i.string().min(1).optional()}),M=i.object({type:i.literal(`extension`),name:i.string().min(1),version:n,optional:i.boolean().optional()});function ne(e,t=`>=0.1.0`,n){return n===void 0?{type:`extension`,name:e,version:t}:{type:`extension`,name:e,version:t,optional:n}}const N=i.discriminatedUnion(`type`,[i.object({type:i.literal(`host`),id:i.string().min(1)}),i.object({type:i.literal(`capability`),id:i.string().min(1),version:n.optional()})]),P=i.object({name:i.string().min(1).regex(/^(@[^/\\]+\/)?[^/\\]+$/,`Extension name must be a plain identifier or an npm-scoped name (@scope/pkg)`).refine(e=>(e.startsWith(`@`)?e.split(`/`):[e]).every(e=>e!==`.`&&e!==`..`),`Extension name must not be a dot-segment`),displayName:i.string().min(1),version:r,surface:i.enum([`interactive`,`headless`,`any`]).optional(),dependencies:i.array(M).readonly().optional(),requires:i.array(N).readonly().optional(),provides:i.array(S).readonly().optional(),critical:i.boolean().optional(),windows:i.array(w).readonly().optional(),tray:T.optional(),cli:O.optional(),storage:j.optional(),browser:a.optional(),contributions:x.optional()});function F(e){return Object.freeze({name:e})}function I(e){if(typeof e!=`object`||!e)return!1;let t=e;return typeof t.name==`string`&&typeof t.displayName==`string`&&typeof t.version==`string`}function L(e,t,n){if(Array.isArray(e)){let r=[],i=new Set;for(let t of e){if(!I(t)){n(`default export array contains an invalid MakaioExtension, skipping`);return}if(i.has(t.name)){n(`default export array contains duplicate package name '${t.name}', skipping`);return}i.add(t.name),r.push(t)}if(!r.some(e=>e.name===t)){n(`default export array must include a package named '${t}' to match descriptor identity, skipping`);return}if(r.some(e=>e.name!==t&&!e.name.startsWith(`${t}.`))){n(`default export array contains package names outside descriptor namespace '${t}', skipping`);return}return r}if(!I(e)){n(`default export is not a valid MakaioExtension or MakaioExtension[], skipping`);return}if(e.name!==t){n(`imported package name '${e.name}' does not match descriptor name '${t}', skipping`);return}return[e]}function re(e,t){return e?.[t]===!0}const R=i.object({command:i.string().min(1),args:i.array(i.string()).optional(),env:i.record(i.string(),i.string()).optional(),healthTimeoutMs:i.number().int().positive().optional(),shutdownTimeoutMs:i.number().int().positive().optional()}),ie=i.enum([`none`,`on-crash`,`always`]),z=R.extend({restartPolicy:ie.optional()}),B=i.discriminatedUnion(`type`,[z.extend({type:i.literal(`bus-stdio`)}),z.extend({type:i.literal(`bus-websocket`)}),R.extend({type:i.literal(`mcp-stdio`)})]);function ae(e){if(e.includes(`\\`)||e.startsWith(`./`)||e.startsWith(`../`)||e.startsWith(`/`))return!1;let t=e.split(`/`),n=t.at(-1);return!n||n.includes(`.`)?!1:t.every(e=>e!==``&&e!==`.`&&e!==`..`&&e!==`src`&&e!==`dist`)}const V=i.union([i.literal(!0),i.string().min(1).refine(ae,{message:`entrypoint stem must use forward-slash path stems, must not contain empty, . or .. segments, must not include a dotted final segment, and must not contain src or dist segments`})]),H=i.object({server:V.optional(),browser:V.optional(),cli:V.optional()}).refine(e=>e.server!==void 0||e.browser!==void 0||e.cli!==void 0,{message:`at least one entrypoint must be declared`});function U(e){return e.execution===`detached`}const W=P.extend({version:r,makaio:i.object({framework:n}).strict().readonly(),entrypoints:H.optional(),execution:i.enum([`embedded`,`detached`]).optional(),transport:B.optional(),prebundleDependencies:i.array(i.string().regex(/\S/,`prebundleDependencies entries must not be blank`)).readonly().optional(),config:i.object({defaults:i.record(i.string(),i.unknown()).optional()}).optional()}).superRefine((e,t)=>{e.prebundleDependencies!==void 0&&e.entrypoints?.browser===void 0&&t.addIssue({code:i.ZodIssueCode.custom,message:`prebundleDependencies requires a browser entrypoint`,path:[`prebundleDependencies`]}),e.critical!==void 0&&e.entrypoints?.server!==void 0&&t.addIssue({code:i.ZodIssueCode.custom,message:`'critical' must not be declared alongside a server entrypoint — declare it on the exported MakaioExtension package instead`,path:[`critical`]}),e.execution===`detached`?(e.transport===void 0&&t.addIssue({code:i.ZodIssueCode.custom,message:`detached extensions must declare a 'transport' config`,path:[`transport`]}),e.entrypoints!==void 0&&t.addIssue({code:i.ZodIssueCode.custom,message:`detached extensions must not declare entrypoints`,path:[`entrypoints`]})):(e.entrypoints===void 0&&t.addIssue({code:i.ZodIssueCode.custom,message:`embedded extensions must declare at least one entrypoint`,path:[`entrypoints`]}),e.transport!==void 0&&t.addIssue({code:i.ZodIssueCode.custom,message:`embedded extensions must not declare a transport config`,path:[`transport`]}))});function G(e){return e}function K(e){return G(W.parse(e))}function q(e){let t=W.safeParse(e);return t.success?{success:!0,data:G(t.data)}:t}const J=i.discriminatedUnion(`kind`,[i.object({kind:i.literal(`configure-integration`),clientId:i.string().min(1),bundle:i.string().min(1)}),i.object({kind:i.literal(`install-extension`),extensionName:i.string().min(1)}),i.object({kind:i.literal(`open-url`),url:i.string().url()}),i.object({kind:i.literal(`run-command`),command:i.string().min(1)})]),Y=i.enum([`info`,`recommended`,`degraded`]),X=i.object({severity:Y,title:i.string().min(1),message:i.string().min(1),action:J.optional()});function oe(e){switch(e.kind){case`configure-integration`:return`Configure`;case`install-extension`:return`Install`;case`open-url`:return`Open`;case`run-command`:return`Run`}}const se=i.object({extensionName:i.string().min(1),warnings:i.array(X)});function ce(e,t){return e.parse(t??{})}const Z=/^[a-z0-9._-]$/,le=`.json`,ue=255,de=`data`,fe=new Set([`.`,`..`]),pe=new Set([`CON`,`PRN`,`AUX`,`NUL`,`COM1`,`COM2`,`COM3`,`COM4`,`COM5`,`COM6`,`COM7`,`COM8`,`COM9`,`LPT1`,`LPT2`,`LPT3`,`LPT4`,`LPT5`,`LPT6`,`LPT7`,`LPT8`,`LPT9`]);function me(e){let t=e.indexOf(`.`),n=t===-1?e:e.slice(0,t);return pe.has(n.toUpperCase())}function Q(e){return e.length===0||fe.has(e)||me(e)?!1:e.isWellFormed()}function $(e){if(!Q(e))return;let t=new TextEncoder().encode(e),n=t.length-1,r=``;for(let[e,i]of t.entries()){let t=String.fromCharCode(i),a=e===0||e===n,o=Z.test(t)&&!(a&&t===`.`);r+=o?t:`%${i.toString(16).toUpperCase().padStart(2,`0`)}`}if(!(r.length+5>255))return r}function he(e){let t=ge(e);if(t===void 0)return;let n;try{n=new TextDecoder(`utf-8`,{fatal:!0,ignoreBOM:!0}).decode(new Uint8Array(t))}catch{return}return $(n)===e?n:void 0}function ge(e){let t=[],n=0;for(;n<e.length;){let r=e.charAt(n);if(r!==`%`){if(!Z.test(r))return;t.push(r.charCodeAt(0)),n+=1;continue}let i=e.slice(n+1,n+3);if(!/^[0-9A-Fa-f]{2}$/.test(i))return;t.push(Number.parseInt(i,16)),n+=3}return t}function _e(e){return JSON.stringify([e.extensionId,e.type,e.name,e.filename])}export{k as A,l as B,F as C,M as D,D as E,te as F,f as G,g as H,ne as I,s as J,p as K,ee as L,T as M,w as N,P as O,C as P,a as Q,S as R,L as S,O as T,u as U,h as V,x as W,m as X,d as Y,_ as Z,U as _,ue as a,re as b,ce as c,X as d,Y as f,H as g,W as h,le as i,j,N as k,J as l,B as m,de as n,he as o,oe as p,o as q,Z as r,$ as s,_e as t,se as u,K as v,E as w,I as x,q as y,c as z};

package/dist/{extension-context-BH31eOMv.d.mts → extension-context-pQ7Uio_s.d.mts}

@@ -1,3 +1,4 @@
+import { n as CredentialRef } from "./credential-ref-w4ZYpYW0.mjs";
 import { z } from "zod";
 import { MakaioBusLike } from "@makaio/framework/core";
 
@@ -193,6 +194,36 @@ interface ExtensionServiceLifecycle {
 type ExtensionService = ExtensionServiceLifecycle;
 //#endregion
 //#region core/contracts/src/extension/extension-context.d.ts
+/**
+ * Host-supplied capability for resolving credential references at extension init time.
+ *
+ * Provided by the Node runtime on {@link NodeExtensionContext.credentials}. Extensions
+ * should call this instead of opening the credential channel directly so that the
+ * framework can degrade gracefully in headless hosts where the product-side credential
+ * service is not running.
+ *
+ * Resolution semantics by scheme:
+ * - `env:<VAR>` — reads the named environment variable from the current process.
+ * - `file:<path>` — reads the file at the given absolute path.
+ * - `keychain:<service>:<account>` — reads macOS Keychain (other platforms return null).
+ * - `stored:providerConfig:<configId>:<key>` — fetches through the host's credential
+ *   service when one is registered; returns `null` with a warning when no handler is
+ *   registered (bare headless hosts without the credential service).
+ *
+ * Extensions **must never log resolved values** — treat them as secrets at all times.
+ */
+interface CredentialResolver {
+  /**
+   * Resolve a credential reference to its runtime value.
+   *
+   * Returns `null` when the referenced credential is unavailable (environment
+   * variable unset, file missing, keychain entry absent, or `stored:` service
+   * not registered).
+   * @param ref - Branded credential reference string.
+   * @returns Resolved plaintext value, or `null` when unavailable.
+   */
+  resolve(ref: CredentialRef): Promise<string | null>;
+}
 /**
  * Generic context provided by a host runtime when creating an extension's service.
  *
@@ -290,6 +321,18 @@ interface NodeExtensionContext<TBus extends MakaioBusLike = MakaioBusLike> exten
    * Hosts without a WebSocket bus omit it.
    */
   readonly busUrl?: string;
+  /**
+   * Host-supplied credential resolver for resolving `CredentialRef` values.
+   *
+   * Resolves `env:`, `file:`, and `keychain:` references locally; resolves
+   * `stored:providerConfig:<configId>:<key>` through the host's credential
+   * service when one is registered, returning `null` with a warning when none
+   * is available (bare headless hosts).
+   *
+   * Absent when the host does not provide one (e.g., browser-only contexts).
+   * Extensions **must never log resolved values**.
+   */
+  readonly credentials?: CredentialResolver;
 }
 //#endregion
-export { ExtensionServiceLifecycle as a, ExtensionWarningActionSchema as c, ExtensionWarningSchema as d, ExtensionWarningSeverity as f, extensionToken as g, ExtensionToken as h, ExtensionService as i, ExtensionWarningEntry as l, getExtensionWarningActionLabel as m, NodeExtensionContext as n, ExtensionWarning as o, ExtensionWarningSeveritySchema as p, ExtensionIdentity as r, ExtensionWarningAction as s, ExtensionContext as t, ExtensionWarningEntrySchema as u };
+export { extensionToken as _, ExtensionService as a, ExtensionWarningAction as c, ExtensionWarningEntrySchema as d, ExtensionWarningSchema as f, ExtensionToken as g, getExtensionWarningActionLabel as h, ExtensionIdentity as i, ExtensionWarningActionSchema as l, ExtensionWarningSeveritySchema as m, ExtensionContext as n, ExtensionServiceLifecycle as o, ExtensionWarningSeverity as p, NodeExtensionContext as r, ExtensionWarning as s, CredentialResolver as t, ExtensionWarningEntry as u };

package/dist/{extension-discovery-CA2IhDRo.d.mts → extension-discovery-Rup-gANp.d.mts}

@@ -58,7 +58,32 @@ interface FilesystemDescriptorDiscoveryOptions {
 interface ExtensionDiscovery {
   /** Scan for extensions and return validated discoveries. */
   discover(): Promise<DiscoveredExtension[]>;
+  /**
+   * Report this strategy's raw precedence layers, highest priority first, with
+   * no name collision resolved yet.
+   *
+   * {@link discover} answers what the runtime loads: exactly one extension per
+   * name, refusing outright where no precedence can decide the winner. An
+   * observer — a catalog listing every installed package, including ones no
+   * boot would load — needs the input to that decision instead, so it can
+   * describe a contest rather than abort on it.
+   *
+   * Optional: a strategy that has no internal layering is one precedence layer
+   * by definition, which {@link discoverExtensionTiers} supplies for it.
+   */
+  discoverTiers?(): Promise<DiscoveredExtension[][]>;
 }
+/**
+ * Read a discovery strategy's precedence layers, whether or not it reports
+ * them itself.
+ *
+ * A strategy without {@link ExtensionDiscovery.discoverTiers} is a single
+ * precedence layer — the same status {@link MergedDescriptorDiscovery} already
+ * gives each strategy it merges — so its resolved result is that one layer.
+ * @param discovery - Strategy to read.
+ * @returns Its layers, highest priority first.
+ */
+declare function discoverExtensionTiers(discovery: ExtensionDiscovery): Promise<DiscoveredExtension[][]>;
 /**
  * Enumerate descriptor files from one configured filesystem path without
  * parsing them. A package-root descriptor wins over nested descriptors, and a
@@ -78,7 +103,10 @@ declare function enumerateDescriptorPaths(discoveryPath: string): Promise<string
  * Each location supports both flat (`pkg/`) and scoped (`@scope/pkg/`) packages.
  * Validates each descriptor against {@link ExtensionDescriptorSchema}.
  * Malformed or invalid descriptors are skipped with a console warning.
- * On name collision, earlier tiers win (local \> installed \> global-npm).
+ * On a cross-tier name collision, earlier tiers win (local \> installed \>
+ * global-npm) and the shadowed copy is reported; a collision *within* one tier
+ * has no precedence to appeal to and throws — see
+ * {@link deduplicateByDescriptorName}.
  */
 declare class FilesystemDescriptorDiscovery implements ExtensionDiscovery {
   private readonly localNodeModulesDir;
@@ -95,10 +123,17 @@ declare class FilesystemDescriptorDiscovery implements ExtensionDiscovery {
   /**
    * Scan all three extension locations and return a deduplicated list.
    *
-   * Priority: local → installed → global-npm. Earlier tiers win on name collision.
+   * Priority: local → installed → global-npm. Earlier tiers win a cross-tier
+   * name collision; a collision within one tier throws.
    * @returns Deduplicated list of discovered extensions ordered by priority.
+   * @throws ExtensionNameCollisionError when one tier declares the same descriptor name twice.
    */
   discover(): Promise<DiscoveredExtension[]>;
+  /**
+   * Scan all three extension locations without resolving any name collision.
+   * @returns One array per tier, ordered local → installed → global-npm.
+   */
+  discoverTiers(): Promise<DiscoveredExtension[][]>;
   /**
    * Scan project-local node_modules for descriptor.json files.
    * @returns Discovered extensions from node_modules.
@@ -122,14 +157,6 @@ declare class FilesystemDescriptorDiscovery implements ExtensionDiscovery {
    * @returns List of successfully parsed and validated extensions.
    */
   private scanPatterns;
-  /**
-   * Deduplicate by descriptor name across priority tiers.
-   *
-   * Tiers are processed in priority order — earlier tiers win on name collision.
-   * @param tiers - Extension arrays ordered by descending priority.
-   * @returns Merged list with no duplicate names.
-   */
-  private deduplicate;
 }
 /**
  * Returns a pre-defined list of extensions without filesystem scanning.
@@ -148,14 +175,52 @@ declare class ExplicitDescriptorDiscovery implements ExtensionDiscovery {
    * @returns The extension list passed to the constructor.
    */
   discover(): Promise<DiscoveredExtension[]>;
+  /**
+   * Report the fixed list as the single precedence layer it is.
+   * @returns One layer holding the extension list passed to the constructor.
+   */
+  discoverTiers(): Promise<DiscoveredExtension[][]>;
+}
+/**
+ * Two packages inside one discovery tier declare the same descriptor name.
+ *
+ * A descriptor name is an extension identity, and packages sitting side by side
+ * in one tier have no precedence over each other, so there is no deterministic
+ * winner to pick. Discovery refuses instead of loading an arbitrary copy, and
+ * boot propagates this refusal rather than starting without extensions — see
+ * {@link deduplicateByDescriptorName} for the full tier semantics.
+ */
+declare class ExtensionNameCollisionError extends Error {
+  readonly descriptorName: string;
+  /**
+   * @param descriptorName - Descriptor name claimed by both packages.
+   * @param claimed - Package that already claimed the name in this tier.
+   * @param conflicting - Package that re-declared the already claimed name.
+   */
+  constructor(descriptorName: string, claimed: DiscoveredExtension, conflicting: DiscoveredExtension);
 }
+/**
+ * Describe a descriptor name declared twice inside one discovery tier,
+ * including both packages' provenance.
+ *
+ * Shared with observers that report such a collision instead of refusing on it
+ * (an installed-package catalog, for example), so the diagnostic an operator
+ * has to act on reads identically wherever it surfaces.
+ * @param descriptorName - Descriptor name claimed by both packages.
+ * @param claimed - Package that already claimed the name in this tier.
+ * @param conflicting - Package that re-declared the already claimed name.
+ * @returns Operator-readable description of the collision.
+ */
+declare function describeSameTierNameCollision(descriptorName: string, claimed: DiscoveredExtension, conflicting: DiscoveredExtension): string;
 /**
  * Merges multiple discovery strategies into one deduplicated result.
  *
  * Discoveries run concurrently via `Promise.all` and their results are
- * merged in constructor order. Earlier discoveries win on name collision,
- * which lets hosts layer explicit descriptor sets without changing the
- * existing tier semantics.
+ * merged in constructor order. Each discovery is one precedence layer: earlier
+ * discoveries win a name collision against later ones, which lets hosts layer
+ * explicit descriptor sets without changing the existing tier semantics. A
+ * name declared twice *by the same discovery* has no precedence to appeal to
+ * and throws — see {@link deduplicateByDescriptorName}.
  */
 declare class MergedDescriptorDiscovery implements ExtensionDiscovery {
   private readonly discoveries;
@@ -165,9 +230,43 @@ declare class MergedDescriptorDiscovery implements ExtensionDiscovery {
   constructor(discoveries: ReadonlyArray<ExtensionDiscovery>);
   /**
    * Run all discoveries and merge their results by descriptor name.
-   * @returns Deduplicated list preserving the first occurrence of each name.
+   * @returns Deduplicated list preserving the highest-precedence discovery's
+   *   result for each name.
+   * @throws ExtensionNameCollisionError when one discovery returns the same descriptor name twice.
    */
   discover(): Promise<DiscoveredExtension[]>;
+  /**
+   * Report every merged strategy's layers, concatenated in constructor order.
+   *
+   * A strategy that layers internally contributes its own layers rather than
+   * one flattened result, so the precedence an observer sees is the same one
+   * {@link discover} resolves.
+   * @returns Every layer, ordered by descending priority.
+   */
+  discoverTiers(): Promise<DiscoveredExtension[][]>;
 }
+/**
+ * Resolve descriptor-name collisions across discovery tiers.
+ *
+ * A descriptor name is an extension identity, so exactly one discovery may
+ * hold it. Which discovery that is depends on where the collision happens:
+ *
+ * - **Across tiers** the answer is the declared tier precedence (local \>
+ *   installed \> global-npm): the higher tier wins. The loser is not dropped
+ *   silently — it is reported with both provenances so an operator can see
+ *   which copy the runtime is actually going to load.
+ * - **Within one tier** there is no precedence to appeal to. Two packages
+ *   sitting side by side in the same directory claiming one identity have no
+ *   deterministic winner — the order is whatever the filesystem returned — so
+ *   this throws instead of picking one. The managed install paths already
+ *   prevent this (a symlink install is keyed by descriptor name, and an npm
+ *   install is refused when another npm package already claims the name); a
+ *   collision here therefore means packages were placed by hand and the
+ *   operator has to resolve the ambiguity.
+ * @param tiers - Discovery tiers ordered from highest to lowest priority.
+ * @returns Merged discoveries with the winning tier's descriptor kept per name.
+ * @throws ExtensionNameCollisionError when one tier contains two descriptors declaring the same name.
+ */
+declare function deduplicateByDescriptorName(tiers: ReadonlyArray<ReadonlyArray<DiscoveredExtension>>): DiscoveredExtension[];
 //#endregion
-export { FilesystemDescriptorDiscovery as a, enumerateDescriptorPaths as c, ExtensionEntrypointModule as i, ExplicitDescriptorDiscovery as n, FilesystemDescriptorDiscoveryOptions as o, ExtensionDiscovery as r, MergedDescriptorDiscovery as s, DiscoveredExtension as t };
+export { ExtensionNameCollisionError as a, MergedDescriptorDiscovery as c, discoverExtensionTiers as d, enumerateDescriptorPaths as f, ExtensionEntrypointModule as i, deduplicateByDescriptorName as l, ExplicitDescriptorDiscovery as n, FilesystemDescriptorDiscovery as o, ExtensionDiscovery as r, FilesystemDescriptorDiscoveryOptions as s, DiscoveredExtension as t, describeSameTierNameCollision as u };

package/dist/extension-kOwzAMud.mjs

@@ -0,0 +1 @@
+import{n as e}from"./window-registry-2MZdZPdA.mjs";import{n as t}from"./namespace-BPf6AbBO.mjs";import{n}from"./extension-namespace-CeRpt6C8.mjs";import{t as r}from"./schema-introspection-_Yw9L_mB.mjs";import{z as i}from"zod";import a from"node:path";import{getErrorString as o,summarizeDiagnosticText as s}from"@makaio/framework/utils";import{MakaioError as c,createBusNamespace as l}from"@makaio/framework/core";import{EXTENSION_DATA_DIR_SEGMENT as u,ProviderDefinitionSchema as d,encodeExtensionNameAsPathSegment as f,primaryMigrationsPath as p,versionSatisfies as m}from"@makaio/framework/contracts";import{ToastSubjects as h}from"@makaio/framework/contracts/toast";import{ExtensionWarningSchema as ee,getExtensionWarningActionLabel as te}from"@makaio/framework/contracts/extension";import{TrayMenuSubjects as g}from"@makaio/framework/services/tray-menu";const _=i.object({name:i.string(),displayName:i.string()}),v=l(`kernel:boot`,{getState:{request:i.object({}),response:i.object({complete:i.boolean(),completedCount:i.number(),totalCount:i.number(),currentService:i.string().optional(),failedServices:i.array(i.string()),skippedServices:i.array(i.string()).default([]),totalDurationMs:i.number().optional()})},"service.starting":_,"service.ready":_.extend({durationMs:i.number().int().nonnegative()}),"service.failed":_.extend({errorMessage:i.string()}),"service.skipped":_.extend({reason:i.string()}),progress:i.object({completedCount:i.number(),totalCount:i.number(),currentService:i.string().optional()}),complete:i.object({totalDurationMs:i.number(),failedServices:i.array(i.string())})}),y=v.subjects;var b=class extends Error{reason;constructor(e){super(e),this.name=`ServiceSkipError`,this.reason=e}};function x(e){return{name:e.name,displayName:e.displayName}}var ne=class{bus;state;cleanup;constructor(e,t){this.bus=e,this.state={complete:!1,completedCount:0,totalCount:t,failedServices:[],skippedServices:[],startedAt:Date.now()},this.cleanup=this.bus.on(y.getState,e=>{e.setResult({complete:this.state.complete,completedCount:this.state.completedCount,totalCount:this.state.totalCount,...this.state.currentService===void 0?{}:{currentService:this.state.currentService},failedServices:[...this.state.failedServices],skippedServices:[...this.state.skippedServices],...this.state.totalDurationMs===void 0?{}:{totalDurationMs:this.state.totalDurationMs}})})}dispose(){this.cleanup()}starting(e){let t=x(e);this.state.currentService=t.displayName,this.state.currentServiceStartedAt=Date.now(),this.bus.emit(y.service.starting,t).catch(e=>{console.warn(`[ExtensionCoordinator] boot.service.starting emit failed for "${t.name}":`,e)})}ready(e){let t=x(e);this.state.completedCount+=1;let n=this.state.currentServiceStartedAt===void 0?0:Math.max(0,Date.now()-this.state.currentServiceStartedAt);this.bus.emit(y.service.ready,{...t,durationMs:n}).catch(e=>{console.warn(`[ExtensionCoordinator] boot.service.ready emit failed for "${t.name}":`,e)}),this.emitProgress()}failed(e,t){let n=x(e);this.state.completedCount+=1,this.state.failedServices.push(n.name),this.bus.emit(y.service.failed,{...n,errorMessage:t}).catch(e=>{console.warn(`[ExtensionCoordinator] boot.service.failed emit failed for "${n.name}":`,e)}),this.emitProgress()}skipped(e,t){let n=x(e);this.state.completedCount+=1,this.state.skippedServices.push(n.name),this.bus.emit(y.service.skipped,{...n,reason:t}).catch(e=>{console.warn(`[ExtensionCoordinator] boot.service.skipped emit failed for "${n.name}":`,e)}),this.emitProgress()}complete(){this.state.complete=!0,delete this.state.currentService,delete this.state.currentServiceStartedAt,this.state.totalDurationMs=Date.now()-this.state.startedAt,this.bus.emit(y.complete,{totalDurationMs:this.state.totalDurationMs,failedServices:[...this.state.failedServices]}).catch(e=>{console.warn(`[ExtensionCoordinator] boot.complete emit failed:`,e)})}emitProgress(){this.bus.emit(y.progress,{completedCount:this.state.completedCount,totalCount:this.state.totalCount,...this.state.currentService===void 0?{}:{currentService:this.state.currentService}}).catch(e=>{console.warn(`[ExtensionCoordinator] boot.progress emit failed:`,e)})}};function re(e){return{subject:`wiring.apply`,$meta:{namespace:`client:${e}`,isRequest:!0,local:!1,channel:!1,payload:{request:{},response:{}}}}}const S=`action`;function C(e,t){return`${e}:${t}`}function ie(e,t,n){return e.on(h.interacted,r=>{let{toastId:i,actionId:a}=r.payload,o=C(i,a),s=t.get(o);s&&ae(e,s,i,n).catch(e=>{console.error(`[ExtensionCoordinator] Warning action dispatch failed for toast "${i}":`,e)})})}async function ae(e,t,n,r){switch(t.kind){case`configure-integration`:await se(e,t.clientId,n,r);break;case`open-url`:console.info(`[ExtensionCoordinator] Toast "${n}" open-url action not routable from runtime layer: ${t.url}`);break;case`run-command`:console.info(`[ExtensionCoordinator] Toast "${n}" run-command action not routable from runtime layer: ${t.command}`);break;case`install-extension`:console.info(`[ExtensionCoordinator] Toast "${n}" install-extension action not routable from runtime layer: ${t.extensionName}`);break;default:oe(t)}}function oe(e){throw Error(`[ExtensionCoordinator] Unsupported warning action: ${JSON.stringify(e)}`)}async function se(e,t,n,r){let i=re(t),a=await e.requestOptional(i,{scope:`user`,makaioCommand:r});if(!a.handled){console.warn(`[ExtensionCoordinator] Toast "${n}" configure-integration: no wiring handler for client "${t}". Is the client package loaded?`);return}let{applied:o,skipped:s}=a.data;console.info(`[ExtensionCoordinator] Toast "${n}" configure-integration: wired client "${t}" — ${o} applied, ${s} skipped.`)}function ce(e){return e.map(e=>({name:e.name,description:e.description,hasInteractive:!!e.interactive,subcommands:e.subcommands.map(e=>({name:e.name,description:e.description,args:r(e.schema)}))}))}async function le(e,t,n){let{command:r,subcommand:i,args:a}=e,o=t.find(e=>e.name===r);if(!o)return{exitCode:1,stdout:[],stderr:[`Unknown command: ${r}`]};let s=o.subcommands.find(e=>e.name===i);if(!s)return{exitCode:1,stdout:[],stderr:[`Unknown subcommand: ${i}`]};let c=s.schema.safeParse(a??{});if(!c.success)return{exitCode:1,stdout:[],stderr:[`Validation failed:`,...c.error.issues.map(e=>`  ${e.path.join(`.`)||`(root)`}: ${e.message}`)]};if(o.beforeRun)try{let e=await o.beforeRun({subcommandName:i,args:c.data??{},bus:n});if(!e.proceed)return{exitCode:e.exitCode??1,stdout:[],stderr:[e.message]}}catch(e){return{exitCode:1,stdout:[],stderr:[`beforeRun hook failed: ${e instanceof Error?e.message:String(e)}`]}}let l=[],u=[],d={write:e=>l.push(e),error:e=>u.push(e)},f=0,p=new AbortController().signal;try{await s.handler({args:c.data,bus:n,output:d,signal:p,setExitCode:e=>{f=e}})}catch(e){f===0&&(f=1),u.push(e instanceof Error?e.message:String(e))}return{exitCode:f,stdout:l,stderr:u}}function w(e){let r=[];return r.push(e.bus.on(n.list,t=>{t.setResult({extensions:e.list()})})),r.push(e.bus.on(n.get,t=>{t.setResult({extension:e.getInfo(t.payload.name)})})),r.push(e.bus.on(n.setEnabled,async t=>{let{success:n,outcome:r,reason:i}=await e.handleSetEnabled(t.payload.name,t.payload.enabled);t.setResult({success:n,outcome:r,...i!==void 0&&{reason:i}})})),r.push(e.bus.on(n.catalog,async t=>{t.setResult({entries:await e.getInstalledCatalog()})})),r.push(e.bus.on(n.contributions.catalog,t=>{let n=[],r=[];for(let[t,i]of e.entries)if(i.state===`active`){for(let e of i.pkg.providers??[])n.push({packageName:t,definition:d.parse(e)});for(let e of i.pkg.clients??[])r.push({packageName:t,definition:e})}t.setResult({providers:n,clients:r})})),r.push(e.bus.on(t.listContributions,t=>{t.setResult({contributions:ce(e.cliContributions)})})),r.push(e.bus.on(t.execute,async t=>{t.setResult(await le(t.payload,e.cliContributions,e.bus))})),r.push(e.bus.on(n.warnings.list,t=>{let{extensionName:n}=t.payload;if(n!==void 0){let r=e.entries.get(n),i=r&&r.warnings.length>0?[{extensionName:n,warnings:[...r.warnings]}]:[];t.setResult({entries:i});return}let r=[];for(let[t,n]of e.entries)n.warnings.length>0&&r.push({extensionName:t,warnings:[...n.warnings]});t.setResult({entries:r})})),r}async function T(e){for(let[t,n]of e.entries)n.state===`active`&&await D(e,t,n)}function ue(e){if(e&&E(e))return[{id:S,label:te(e)}]}function E(e){return e.kind===`configure-integration`}function de(e,t){let n=`${t}:`;for(let t of e.keys())t.startsWith(n)&&e.delete(t)}async function D(e,t,n){de(e.warningActionMap,t);let r=n.warnings.filter(e=>e.severity===`degraded`);if(r.length!==0)for(let i=0;i<r.length;i++){let a=r[i];console.warn(`[${t}] ⚠ ${a.title}: ${a.message}`);let o=`${t}:${a.title}:${i}`,s=ue(a.action);try{await e.bus.emit(h.show,{level:`warning`,title:a.title,message:`${n.pkg.displayName}: ${a.message}`,toastId:o,durationMs:null,...s&&{actions:s}}),a.action&&E(a.action)&&e.warningActionMap.set(C(o,S),a.action)}catch(e){console.warn(`[${t}] toast emission failed for warning "${a.title}":`,e)}}}function O(e,t){let{pkg:n,state:r,error:i,enabled:a,extensionManaged:o}=e,s=o&&t?t(n.name)!==!1:void 0;return{name:n.name,displayName:n.displayName,state:r,...n.surface===void 0?{}:{surface:n.surface},enabled:a,extensionManaged:o,...s===void 0?{}:{persistedEnabled:s},critical:n.critical??!1,...n.browser===void 0?{}:{browser:n.browser},...i===void 0?{}:{error:i}}}function fe(e){return Object.freeze({extensionName:e})}var k=class extends c{extensionName;source;constructor(e){super(`Operator config for extension "${e.extensionName}" (source: ${e.source}) ${e.summary}`),this.extensionName=e.extensionName,this.source=e.source,e.cause!==void 0&&(this.cause=e.cause)}};const pe={unreadable:`could not be read`,"invalid-json":`is not valid JSON`,"not-an-object":`is not a JSON object`};function me(e){let{name:t,configSchema:n,configDefaults:r,storedConfig:i,operatorEntry:a,mode:c}=e,l=he(t,a,c);if(!n)return{config:void 0,usedSchemaDefaults:!1};let u={...r??{},...i??{},...l?.config??{}};try{return{config:n.parse(u),usedSchemaDefaults:!1}}catch(e){let r=s(o(e));if(c===`activate`&&l!==void 0)throw new k({extensionName:t,source:l.source,summary:`is part of a configuration rejected by the extension's config schema: ${r}`,cause:e});console.warn(`[ExtensionCoordinator] Config parse failed for "${t}", starting with schema defaults:`,r);try{return{config:n.parse({}),usedSchemaDefaults:!0}}catch{return console.warn(`[ExtensionCoordinator] Fallback config parse also failed for "${t}" — config will be absent`),{config:void 0,usedSchemaDefaults:!1}}}}function he(e,t,n){if(t===void 0)return;if(t.kind===`config`)return t;let r=new k({extensionName:e,source:t.source,summary:ge(t)});if(n===`activate`)throw r;console.warn(`[ExtensionCoordinator] ${r.message} — resolving without the operator layer`)}function ge(e){let t=pe[e.reason];if(e.detail===void 0)return t;let n=s(e.detail);return n.length===0?t:`${t}: ${n}`}function A(e,t,n,r){return j(e,t,n,r).config}function j(e,t,n,r){let i;if(n.pkg.configSchema)try{i=e.loadConfig?.(t)}catch(e){console.error(`[ExtensionCoordinator] loadConfig threw for "${t}":`,e)}return me({name:t,configSchema:n.pkg.configSchema,configDefaults:n.configDefaults,storedConfig:i,operatorEntry:e.operatorConfig?.get(t),mode:r})}function M(e){if(f(e)===void 0)return`Extension "${e}" cannot be encoded as a filesystem path segment and therefore has no addressable data directory. Valid extension names must be non-empty, must not be '.' or '..', must be well-formed Unicode, must not be a reserved Windows device basename (CON, NUL, COM1, etc.), and must encode within the filesystem component length limit.`}function N(e,t,n){if(!e.extensionContextBase)throw Error(`ExtensionCoordinator: extensionContextBase is required to start extensions with a create factory. Provide it via the constructor.`);let{extensionName:r}=t.identity,i=f(r);if(i===void 0)throw Error(`ExtensionCoordinator: extension "${r}" cannot be encoded as a filesystem path segment and therefore has no addressable data directory. Valid extension names must be non-empty, must not be '.' or '..', must be well-formed Unicode, must not be a reserved Windows device basename (CON, NUL, COM1, etc.), and must encode within the filesystem component length limit.`);return{...e.extensionContextBase,bus:e.bus,identity:t.identity,dataDir:a.join(e.extensionContextBase.makaioHome,u,i),getService:t=>e.getExtensionService(t.name),signal:e.signal,hasExtension:e.hasActiveExtension,...n===void 0?{}:{config:n}}}function _e(e){return{adapters:!!e.adapters?.length,tools:!!e.tools,hashTriggers:!!e.hashTriggers,providers:!!e.providers?.length,clients:!!e.clients?.length,ui:!!e.ui,storage:!!e.storage,sessionEventActions:!!e.sessionEventActions}}function P(e,t,r){let i=t.state;t.state=r,e.emit(n.stateChanged,{name:t.pkg.name,displayName:t.pkg.displayName,from:i,to:r,...t.error===void 0?{}:{error:t.error},contributes:_e(t.pkg)}).catch(e=>{console.error(`[ExtensionCoordinator] stateChanged emit failed for "${t.pkg.name}":`,e)})}async function F(e,t,n,r,i){return i===`activated`?(await I(e,t,n,r),[]):ve(e,n)}async function I(e,t,n,r){let i=[];try{for(let a of e){if(a.filter&&!a.filter(r.pkg))continue;let e=N(t,r,A(t,n,r,`activate`));await a.processActivated(n,r.pkg,e),i.push(a)}}catch(e){for(let e of i.reverse())if(e.processStopped)try{await e.processStopped(n)}catch(e){console.error(`[ExtensionCoordinator] Contribution processor rollback error for "${n}":`,e)}throw e}}async function ve(e,t){let n=[];for(let r of[...e].reverse())if(r.processStopped)try{await r.processStopped(t)}catch(e){n.push(e)}return n}async function L(e,t){if(!t.tray)return;let n=be(t);await e.request(g.register,{entry:n})}async function ye(e,t){t.tray&&await e.request(g.unregister,{packageName:t.name,entryId:R(t.tray)})}function be(e){let t=e.tray;if(!t)throw Error(`[tray-menu-entry-bridge] extension "${e.name}" does not declare a tray entry`);return{packageName:e.name,entryId:R(t),label:t.label,section:t.section??`views`,priority:50,enabled:!0,metadata:t.opensWindow?{registrationId:`${e.name}:${t.opensWindow}`}:t.action?{action:t.action}:void 0}}function R(e){return e.opensWindow??e.action??`default`}async function xe(e,t,r){let i=e.entries.get(t);if(!i)return`rejected`;let a=r?await Te(e,t,i):await De(e,t,i);return a===`rejected`||e.bus.emit(n.enabledChanged,{name:t,enabled:r}).catch(e=>{console.error(`[ExtensionCoordinator] enabledChanged emit failed for "${t}":`,e)}),a}async function Se(e,t,n,r){if(r.kind===`resolved`&&r.record?.collidesWith!==void 0)return{success:!1,outcome:`rejected`,reason:`name-collision`};let i=e.entries.get(t);return i?.extensionManaged?Ce(e,t,n,i):we(e,t,n,i!==void 0,r)}async function Ce(e,t,n,r){if(!e.persistEnabled)throw Error(`Cannot set enablement preference for "${t}": this runtime has no durable enablement store, so extension enablement is not persistable here.`);return!n&&r.pkg.critical?{success:!1,outcome:`rejected`,reason:`critical`}:(await e.persistEnabled(t,n),(r.state===`active`||r.state===`initializing`?!0:r.state===`discovered`?r.enabled:!1)===n?{success:!0,outcome:`applied`}:{success:!1,outcome:`restart-required`,reason:`runtime-state-diverges`})}async function we(e,t,n,r,i){if(!e.persistEnabled)throw Error(`Cannot set enablement preference for "${t}": this runtime has no durable enablement store, so extension enablement is not persistable here.`);if(i.kind!==`resolved`){if(r)throw Error(`Cannot set enablement preference for "${t}": framework packages are always loaded and have no operator enablement preference.`);return{success:!1,outcome:`rejected`,reason:`no-catalog`}}let a=i.record;if(!a)return{success:!1,outcome:`rejected`,reason:`not-installed`};if(!n&&a.critical)return{success:!1,outcome:`rejected`,reason:`critical`};if(!n&&a.criticalityUnknown)return{success:!1,outcome:`rejected`,reason:`criticality-unknown`};await e.persistEnabled(t,n);let o=r?`framework-package-shadowed`:`not-loaded`;return n?{success:!1,outcome:`restart-required`,reason:o}:{success:!0,outcome:`applied`,reason:o}}function z(e,t,n,r){return t.error=r,console.error(`[ExtensionCoordinator] Cannot re-enable "${n}":`,r),P(e.bus,t,`failed`),`rejected`}async function Te(e,t,n){if(n.state===`active`)return n.enabled=!0,`applied`;if(n.state!==`stopped`&&n.state!==`failed`&&n.state!==`skipped`)return`rejected`;if(n.state===`skipped`&&!n.surfacesCollected)return n.error=`Extension "${t}" was disabled at boot and never started this process; a restart is required to activate it.`,`rejected`;let{pkg:r}=n,i,a=(r.dependencies??[]).filter(t=>{if(t.optional)return!1;let n=e.entries.get(t.name);return!n||n.state!==`active`});if(a.length>0)return z(e,n,t,`Required dependencies not active: ${a.map(e=>e.name).join(`, `)}`);let s=M(n.identity.extensionName);if(s!==void 0)return z(e,n,t,s);n.enabled=!0,n.error=void 0,P(e.bus,n,`initializing`);let c;try{c=A(e,t,n,`activate`)}catch(r){return z(e,n,t,`Config resolution failed: ${o(r)}`)}if(r.storage?.registerHandlers&&e.db!==void 0)try{let t=N(e,n,c),a=r.storage.registerHandlers(e.bus,e.db,t);typeof a==`function`&&(i=a,n.storageCleanup=a)}catch(r){return n.error=o(r),console.error(`[ExtensionCoordinator] Extension "${t}" storage re-registration failed:`,r),P(e.bus,n,`failed`),`rejected`}if(!await Ee(e,t,n,c,i))return`rejected`;try{await F(e.contributionProcessors,e,t,n,`activated`)}catch(r){return await B(t,n.service,i,n),n.service=void 0,n.error=o(r),console.error(`[ExtensionCoordinator] Extension "${t}" contribution processing failed:`,r),P(e.bus,n,`failed`),`rejected`}P(e.bus,n,`active`);try{await L(e.bus,n.pkg)}catch(e){console.warn(`[ExtensionCoordinator] Failed to register tray entry for ${t}:`,e)}return await e.runHealthCheck(t),await e.emitWarningsForEntry(t,n),`applied`}async function Ee(e,t,n,r,i){let{create:a}=n.pkg;if(!a)return!0;let s;try{return s=await a(N(e,n,r)),await s.init?.(),n.service=s,!0}catch(r){return await B(t,s,i,n),r instanceof b?n.pkg.critical?(n.error=`Critical extension cannot skip startup: ${r.reason}`,console.error(`[ExtensionCoordinator] Extension "${t}" failed to re-initialize:`,n.error),P(e.bus,n,`failed`),!1):(n.error=r.reason,P(e.bus,n,`skipped`),!1):(n.error=o(r),console.error(`[ExtensionCoordinator] Extension "${t}" failed to re-initialize:`,r),P(e.bus,n,`failed`),!1)}}async function De(e,t,r){if(r.state===`initializing`)return`rejected`;if(r.state!==`active`)return r.enabled=!1,`applied`;let i=Array.from(e.entries.entries()).filter(([e,n])=>e===t||n.state!==`active`?!1:n.pkg.dependencies?.some(e=>!e.optional&&e.name===t)??!1).map(([e])=>e);if(i.length>0)return r.error=`Cannot disable "${t}" while active dependents remain: ${i.join(`, `)}`,console.error(`[ExtensionCoordinator] ${r.error}`),`rejected`;r.enabled=!1,r.error=void 0;let a=[];try{a.push(...await F(e.contributionProcessors,e,t,r,`stopped`))}catch(e){a.push(e),console.error(`[ExtensionCoordinator] Contribution processor error during disable of "${t}":`,e)}if(r.service)try{await r.service.destroy?.()}catch(e){a.push(e),console.error(`[ExtensionCoordinator] Error during disable destroy of "${t}":`,e)}finally{r.service=void 0}if(r.storageCleanup)try{r.storageCleanup()}catch(e){a.push(e),console.error(`[ExtensionCoordinator] Storage cleanup error during disable of "${t}":`,e)}finally{r.storageCleanup=void 0}try{await ye(e.bus,r.pkg)}catch(e){a.push(e),console.error(`[ExtensionCoordinator] Failed to unregister tray entry for ${t}:`,e)}if(a.length>0){let e=a.map(e=>o(e)).join(`; `);r.error=o(AggregateError(a,`Extension "${t}" disabled with ${a.length} teardown failure(s): ${e}`))}P(e.bus,r,`stopped`),r.warnings=[];try{await e.bus.emit(n.warnings.changed,{extensionName:t,warnings:[]})}catch(e){console.error(`[ExtensionCoordinator] warnings.changed emit failed for "${t}":`,e)}return`applied`}async function B(e,t,n,r){try{await t?.destroy?.()}catch(t){console.error(`[ExtensionCoordinator] Service cleanup error after failed enable of "${e}":`,t)}try{n?.()}catch(t){console.error(`[ExtensionCoordinator] Storage cleanup error after failed enable of "${e}":`,t)}finally{r.storageCleanup=void 0}}const Oe=new Set;function V(e,t=Oe){let n=new Map,r=new Set;for(let i of e){let e=n.get(i.name);if(e===void 0){n.set(i.name,i);continue}if(!t.has(i.name)||r.has(i.name))throw Error(ke(i.name,e,i));r.add(i.name),console.info(`[ExtensionCoordinator] Extension "${i.name}" overrides the framework package registered under the same name`),n.delete(i.name),n.set(i.name,i)}return[...n.values()]}function ke(e,t,n){return`Extension name collision: "${e}" is registered twice (${H(t)} and ${H(n)}). Extension package names are identities and cannot be shared — uninstall or rename one of them. Reaching load with two registrations under one name means discovery or boot selection admitted both, which they must not.`}function H(e){return`"${e.displayName}" v${e.version}`}function U(e,t,n){let r=new Set(e.map(e=>e.name)),i=e.filter(e=>Ae(e,t,n)),a=new Map(i.map(e=>[e.name,e])),o=new Set(a.keys()),s=!0;for(;s;){s=!1;for(let e of o)(a.get(e).dependencies??[]).some(e=>!e.optional&&r.has(e.name)&&!o.has(e.name))&&(o.delete(e),s=!0)}return i.filter(e=>o.has(e.name))}function Ae(e,t,n){if(!Me(e,t))return!1;let r=e.requires;return!r||r.length===0||!n?!0:r.every(e=>{switch(e.type){case`host`:return n.hosts.has(e.id);case`capability`:return n.capabilities.has(e.id)?e.version===void 0?!0:je(n,e.id,e.version):!1}})}function je(e,t,n){let r=e.capabilityVersions?.get(t);return r!==void 0&&m(r,n)}function Me(e,t){return e.surface===void 0||e.surface===`any`||e.surface===t}function Ne(e,t){let n=e.entries.get(t.name)?.extensionManaged??!0,r=n?e.loadEnabled?.(t.name):void 0;return{...t,extensionManaged:n,...r!==void 0&&{persistedEnabled:r}}}async function Pe(e){return e.installedCatalog?(await e.installedCatalog()).map(t=>Ne(e,t)):null}async function Fe(e,t){return e.installedCatalog?{kind:`resolved`,record:W(await e.installedCatalog(),t,e.surface)}:{kind:`unavailable`}}function W(e,t,n){let r=e.filter(e=>e.name===t),i=r.filter(e=>e.shadowedBy===void 0),a=i.length>0?i:r,o=a.filter(e=>e.surface===void 0||e.surface===n),s=i.length>0&&o.length>0,c=o.length>0?o:a,[l,...u]=c;if(l!==void 0)return Le(u.reduce(Re,l),Ie(r,c,s))}function Ie(e,t,n){let[r,...i]=t;if(r!==void 0)return e.length===1?r.collidesWith:n&&i.length>0?r.collidesWith??i[0]?.origin:t.find(e=>e.collisionIgnoresSurface===!0)?.collidesWith}function Le(e,t){let{collidesWith:n,collisionIgnoresSurface:r,...i}=e;return{...i,...t!==void 0&&{collidesWith:t}}}function Re(e,t){let n=e.critical===!0||t.critical===!0?!0:e.critical??t.critical,r=e.criticalityUnknown===!0||t.criticalityUnknown===!0?!0:e.criticalityUnknown??t.criticalityUnknown;return{...e,...n!==void 0&&{critical:n},...r!==void 0&&{criticalityUnknown:r}}}function ze(e,t={}){let n=Be(e);return Ve(e,n,new Map(e.map(e=>[e.name,e])),t),We(n,Ue(e,n),t)}function Be(e){let t=new Set;for(let n of e){if(t.has(n.name))throw Error(`ExtensionCoordinator: duplicate package name detected: "${n.name}"`);t.add(n.name)}return t}function Ve(e,t,n,r){for(let i of e)He(i,t,n,r)}function He(e,t,n,r){let i=r.enabledNames===void 0||r.enabledNames.has(e.name),a=e.dependencies??[],o=a.filter(e=>!e.optional&&!t.has(e.name));o.length>0&&G(r,i,e.name,`ExtensionCoordinator: package "${e.name}" declares missing dependencies: ${o.map(e=>e.name).join(`, `)}`);for(let t of a){let a=n.get(t.name);if(a===void 0)continue;let o=a.version;m(o,t.version)||G(r,i,e.name,`ExtensionCoordinator: package "${e.name}" dependency "${t.name}" version ${o} does not satisfy ${t.version}`)}}function G(e,t,n,r){if(t)throw Error(r);e.onSoftValidationWarning?.(n,r)}function Ue(e,t){let n=new Map;for(let r of e){let e=(r.dependencies??[]).filter(e=>t.has(e.name)).map(e=>e.name);n.set(r.name,new Set(e))}return n}function We(e,t,n){let r=[];for(let[e,n]of t)n.size===0&&r.push(e);let i=[],a=new Set;for(;r.length>0;){let e=r.shift();if(!a.has(e)){a.add(e),i.push(e);for(let[n,i]of t)i.has(e)&&(i.delete(e),i.size===0&&!a.has(n)&&r.push(n))}}if(i.length===e.size)return i;let o=[...e].filter(e=>!a.has(e));if((n.enabledNames===void 0?o:o.filter(e=>n.enabledNames.has(e))).length>0)throw Error(`ExtensionCoordinator: circular dependency detected among: ${o.join(`, `)}`);let s=`ExtensionCoordinator: circular dependency detected among disabled packages: ${o.join(`, `)}`;for(let e of o)n.onSoftValidationWarning?.(e,s),i.push(e);return i}function Ge(e,t,n){let r=new Set;for(let i of e){if(!(t?.has(i.name)??!0)){r.add(i.name);continue}let e=n?.(i.name)!==!1;(e||i.critical)&&r.add(i.name),!e&&i.critical&&console.warn(`[ExtensionCoordinator] Critical extension "${i.name}" is marked disabled in the enablement store but will start anyway to keep the runtime functional. Remove it from the disabled list in config/extensions.json to silence this warning.`)}return{enabled:r}}function K(e){let t=new Set(e.map(({name:e})=>e)),n=new Map(e.map(({name:e,entry:t})=>[e,t])),r=new Set(e.filter(({entry:e})=>e.enabled).map(({name:e})=>e)),i=[],a=!0;for(;a;){a=!1;for(let e of r){let o=(n.get(e).pkg.dependencies??[]).filter(e=>!e.optional&&t.has(e.name)&&!r.has(e.name)).map(e=>e.name);o.length!==0&&(r.delete(e),a=!0,i.push({name:e,missingDependencies:o}))}}return{closed:r,exclusions:i}}async function Ke(e){if(!e.runMigrations)return;let t=[];for(let n of e.loadOrder){let r=e.entries.get(n);if(!r)throw Error(`Extension "${n}" is in loadOrder but missing from entries`);t.push({name:n,entry:r})}let{closed:n,exclusions:r}=K(t);for(let{name:e,missingDependencies:t}of r)console.warn(`[ExtensionCoordinator] Excluding extension "%s" from migration collection: required dependency %s is disabled`,e,t.join(`, `));let i=[];for(let{name:e,entry:r}of t){if(!n.has(e))continue;let t=r.pkg.storage?.migrations;if(!t)continue;let a,o;if(typeof t==`string`)a=q(e,r.pkg,t);else{let n={};for(let[i,a]of Object.entries(t))a!==void 0&&(n[i]=q(e,r.pkg,a));let i=p(n);if(i===void 0)continue;a=i,o=n}i.push({name:e,migrationsPath:a,migrationSourceId:r.pkg.storage?.migrationSourceId??a,...o?{migrationsPathByDialect:o}:{}})}i.length!==0&&await e.runMigrations(i)}function q(e,t,n){if(a.isAbsolute(n))return n;let r=t.storage?.packageRoot;if(!r)throw Error(`Extension "${e}" declares relative storage.migrations "${n}" without storage.packageRoot`);let i=a.resolve(r),o=a.resolve(i,n),s=a.relative(i,o);if(s.startsWith(`..`)||a.isAbsolute(s))throw Error(`Extension "${e}" declares storage.migrations "${n}" outside storage.packageRoot`);return o}async function J(e,t){let r=e.entries.get(t);if(!r?.service||r.state!==`active`)return;let{checkHealth:i}=r.service;if(!i)return;let a;try{let e=await i.call(r.service),n=ee.array().safeParse(e);n.success?a=n.data:(console.error(`[ExtensionCoordinator] checkHealth for "${t}" returned invalid data:`,n.error),a=[])}catch(e){console.error(`[ExtensionCoordinator] checkHealth threw for "${t}":`,e),a=[]}r.warnings=a;try{await e.bus.emit(n.warnings.changed,{extensionName:t,warnings:[...a]})}catch(e){console.error(`[ExtensionCoordinator] warnings.changed emit failed for "${t}":`,e)}}function qe(e,t){if(t.windows)for(let n of t.windows)e.windowRegistry.register(t.name,t.displayName,n);if(t.tray&&e.trayEntries.push({...t.tray,packageName:t.name}),t.cli){let n=t.cli;`subcommands`in n&&e.cliContributions.push(n)}}function Je(e){return Array.from(e.values()).filter(e=>e.enabled).map(e=>e.pkg).filter(e=>!!e.http)}async function Ye(e){let t=[...e.loadOrder].reverse(),n=[],r=[];for(let i of t){let t=e.entries.get(i);if(!t)continue;let a=!1;if(t.state===`active`){let r=await F(e.contributionProcessors,e.contextHost,i,t,`stopped`);r.length>0&&(a=!0,n.push(...r))}if(t.service)try{await t.service.destroy?.()}catch(e){a=!0,n.push(e)}finally{t.service=void 0}if(t.storageCleanup)try{t.storageCleanup()}catch(e){a=!0,n.push(e)}finally{t.storageCleanup=void 0}a&&r.push(i),t.state===`active`&&P(e.contextHost.bus,t,`stopped`)}if(n.length>0)throw AggregateError(n,`Extensions failed to shut down cleanly: ${r.join(`, `)}`)}async function Xe(e,t,n){if(!n.enabled){P(e.bus,n,`skipped`),e.bootProgress.skipped(n.pkg,`disabled`);return}let r=(n.pkg.dependencies??[]).filter(t=>t.optional?!1:e.entries.get(t.name)?.state!==`active`);if(r.length>0){let i=`Required dependencies not active: ${r.map(e=>e.name).join(`, `)}`;if(Q(e,t,n,i),n.pkg.critical)throw Error(`Critical package "${t}" failed: ${i}`);return}let i=M(n.identity.extensionName);if(i!==void 0){if(Q(e,t,n,i),n.pkg.critical)throw Error(`Critical package "${t}" failed: ${i}`);return}e.bootProgress.starting(n.pkg),P(e.bus,n,`initializing`);let a;try{a=A(e.contextHost,t,n,`activate`)}catch(r){if(Q(e,t,n,o(r)),n.pkg.critical)throw r;return}if(Qe(e,t,n,a)){if(!n.pkg.create){await Ze(e,t,n);return}await Y(e,t,n,a)}}async function Ze(e,t,n){try{await F(e.contributionProcessors,e.contextHost,t,n,`activated`)}catch(r){if(Z(t,n),X(e,t,n,r))return;if(Q(e,t,n,r instanceof Error?r.message:String(r)),n.pkg.critical)throw r;return}P(e.bus,n,`active`),e.bootProgress.ready(n.pkg),await $(e.bus,t,n)}async function Y(e,t,n,r){let i;try{let a=N(e.contextHost,n,r);i=await n.pkg.create(a),await i.init?.(),n.service=i,await F(e.contributionProcessors,e.contextHost,t,n,`activated`),P(e.bus,n,`active`),e.bootProgress.ready(n.pkg),await $(e.bus,t,n)}catch(r){try{await i?.destroy?.()}catch(e){console.error(`[ExtensionCoordinator] Service cleanup error after failed start of "${t}":`,e)}if(n.service=void 0,Z(t,n),X(e,t,n,r))return;if(Q(e,t,n,r instanceof Error?r.message:String(r)),n.pkg.critical)throw r}}function X(e,t,n,r){if(!(r instanceof b))return!1;if(n.pkg.critical){let i=`Critical package cannot skip startup: ${r.reason}`;throw Q(e,t,n,i),Error(`Critical package "${t}" failed: ${i}`,{cause:r})}return n.error=r.reason,console.info(`[ExtensionCoordinator] Package "${t}" skipped: ${r.reason}`),P(e.bus,n,`skipped`),e.bootProgress.skipped(n.pkg,r.reason),!0}function Qe(e,t,n,r){if(!n.pkg.storage?.registerHandlers||e.db===void 0)return!0;try{let t=N(e.contextHost,n,r),i=n.pkg.storage.registerHandlers(e.bus,e.db,t);return i&&(n.storageCleanup=i),!0}catch(r){let i=r instanceof Error?r.message:String(r);if(console.error(`[ExtensionCoordinator] Package "${t}" storage registration failed:`,r),Q(e,t,n,i),n.pkg.critical)throw r;return!1}}function Z(e,t){if(t.storageCleanup)try{t.storageCleanup()}catch(t){console.error(`[ExtensionCoordinator] Storage cleanup error after failed start of "${e}":`,t)}finally{t.storageCleanup=void 0}}function Q(e,t,n,r){n.error=r,console.error(`[ExtensionCoordinator] Package "${t}" failed:`,r),P(e.bus,n,`failed`),e.bootProgress.failed(n.pkg,r)}async function $(e,t,n){try{await L(e,n.pkg)}catch(e){console.warn(`[ExtensionCoordinator] Failed to register tray entry for ${t}:`,e)}}var $e=class{bus;surface;db;extensionContextBase;runtimeEnvironment;shutdownController=new AbortController;entries=new Map;loadOrder=[];loaded=!1;started=!1;shutdownRequested=!1;shutdownPromise;lifecycleTail=Promise.resolve();rpcCleanups=[];contributionProcessors=[];warningActionMap=new Map;windowRegistry=new e;_trayEntries=[];_cliContributions=[];persistEnabled;loadEnabled;loadConfig;operatorConfig;runMigrations;extensionManagedNames;frameworkPackageNames;installedCatalog;constructor(e,t={}){this.bus=e,this.surface=t.surface??`headless`,this.db=t.db,this.extensionContextBase=t.extensionContextBase,this.runtimeEnvironment=t.runtimeEnvironment,this.persistEnabled=t.persistEnabled,this.loadEnabled=t.loadEnabled,this.loadConfig=t.loadConfig,this.operatorConfig=t.operatorConfig,this.runMigrations=t.runMigrations,this.extensionManagedNames=t.extensionManagedNames,this.frameworkPackageNames=t.frameworkPackageNames,this.installedCatalog=t.installedCatalog,this.rpcCleanups.push(ie(this.bus,this.warningActionMap,t.launcherCommand??`makaio`))}get trayEntries(){return this._trayEntries.map(e=>({...e}))}get cliContributions(){return this._cliContributions}extensionsWithHttp(){return Je(this.entries)}load(e,t){if(this.shutdownRequested)throw Error(`ExtensionCoordinator.load() called after shutdown(). The coordinator is terminal.`);if(this.loaded)throw Error(`ExtensionCoordinator.load() called twice. The coordinator is single-use; create a new instance if needed.`);let n=V(U(e,this.surface,this.runtimeEnvironment),this.frameworkPackageNames),{enabled:r}=Ge(n,this.extensionManagedNames,this.loadEnabled),i=new Map;this.loadOrder=ze(n,{enabledNames:r,onSoftValidationWarning:(e,t)=>{let n=i.get(e);n?n.push(t):i.set(e,[t])}});let a=[],o=[];for(let e of this.loadOrder){let s=n.find(t=>t.name===e);a.push(s);let c=i.get(e),l={pkg:s,identity:fe(s.name),state:`discovered`,enabled:r.has(e),extensionManaged:this.extensionManagedNames?.has(e)??!0,warnings:[],...c?{error:c.join(`; `)}:{}};if(t){let n=t.get(e);n&&(l.configDefaults=n)}this.entries.set(e,l),o.push({name:e,entry:l})}let{closed:s,exclusions:c}=K(o);for(let{name:e,missingDependencies:t}of c)console.warn(`[ExtensionCoordinator] Excluding extension "%s" from static surface collection and namespace registration: required dependency %s is disabled`,e,t.join(`, `));for(let{name:e,entry:t}of o)s.has(e)&&(t.pkg.namespaces&&this.bus.registerNamespaces(t.pkg.namespaces),qe({windowRegistry:this.windowRegistry,trayEntries:this._trayEntries,cliContributions:this._cliContributions},t.pkg),t.surfacesCollected=!0);return this.registerRpcHandlers(),this.loaded=!0,a}registerRpcHandlers(){this.rpcCleanups.push(...w({bus:this.bus,entries:this.entries,cliContributions:this._cliContributions,list:()=>this.list(),getInfo:e=>this.getInfo(e),handleSetEnabled:(e,t)=>this.handleSetEnabled(e,t),getInstalledCatalog:()=>Pe(this.createCatalogHost())}))}async startAll(){if(this.shutdownRequested)throw Error(`ExtensionCoordinator.startAll() called after shutdown(). The coordinator is terminal.`);if(!this.loaded)throw Error(`ExtensionCoordinator.startAll() called before load(). Call load() first.`);if(this.started)throw Error(`ExtensionCoordinator.startAll() called twice. The coordinator is single-use; create a new instance if needed.`);this.started=!0,await this.enqueueLifecycle(()=>this.startAllInLifecycleLane())}async startAllInLifecycleLane(){let e=new ne(this.bus,this.loadOrder.length);this.rpcCleanups.push(()=>e.dispose());try{await Ke({loadOrder:this.loadOrder,entries:this.entries,runMigrations:this.runMigrations});for(let t of this.loadOrder){let n=this.entries.get(t);n&&await Xe({bus:this.bus,db:this.db,entries:this.entries,contributionProcessors:this.contributionProcessors,contextHost:this.createExtensionContextHost(),bootProgress:e},t,n)}let t=this.createExtensionHealthHost();await Promise.all(this.loadOrder.map(e=>this.entries.get(e)?.state===`active`?J(t,e):void 0)),await T({bus:this.bus,entries:this.entries,warningActionMap:this.warningActionMap})}finally{e.complete()}}shutdown(){if(this.shutdownPromise)return this.shutdownPromise;this.shutdownRequested=!0;let e=this.enqueueLifecycle(()=>this.shutdownInLifecycleLane());return this.shutdownPromise=e,this.shutdownController.abort(),e}async shutdownInLifecycleLane(){let e=[],t;for(let t of this.rpcCleanups)try{t()}catch(t){e.push(t)}this.rpcCleanups=[],this.warningActionMap.clear();try{await Ye({entries:this.entries,loadOrder:this.loadOrder,contributionProcessors:this.contributionProcessors,contextHost:this.createExtensionContextHost()})}catch(n){n instanceof AggregateError?(t=n.message,e.push(...n.errors)):e.push(n)}if(e.length>0){let n=t===void 0?``:`; ${t}`;throw AggregateError(e,`Extension coordinator shutdown failed with ${e.length} error(s)${n}`)}}list(){return[...this.entries.values()].map(e=>O(e,this.loadEnabled))}getInfo(e){let t=this.entries.get(e);return t?O(t,this.loadEnabled):null}getExtensionService(e){let t=typeof e==`string`?e:e.name;return this.entries.get(t)?.service}getExtension(e){return this.entries.get(e)?.pkg}getResolvedConfig(e){let t=this.entries.get(e);if(t)return j(this.createExtensionContextHost(),e,t,`observe`)}getLoadedProviderDefinitionIds(){let e=new Set;for(let t of this.entries.values())if(t.enabled&&!(t.state===`failed`||t.state===`skipped`||t.state===`stopped`))for(let n of t.pkg.providers??[])e.add(n.id);return e}forEachActiveExtension(e){let t=this.createExtensionContextHost();for(let n of this.loadOrder){let r=this.entries.get(n);if(!r||r.state!==`active`)continue;let i=N(t,r,A(t,n,r,`observe`));e(n,r.pkg,i)}}forExtension(e,t){let n=this.entries.get(e);if(!n||n.state!==`active`)return;let r=this.createExtensionContextHost(),i=N(r,n,A(r,e,n,`observe`));t(e,n.pkg,i)}registerContributionProcessor(e){return this.contributionProcessors.push(e),()=>{let t=this.contributionProcessors.indexOf(e);t>=0&&this.contributionProcessors.splice(t,1)}}async handleSetEnabled(e,t){let n={success:!1,outcome:`rejected`,reason:`shutting-down`};if(this.shutdownRequested)return n;let r=await Fe(this.createCatalogHost(),e);return await this.admitLifecycle(()=>Se(this.createToggleHost(),e,t,r),n)}createCatalogHost(){return{entries:this.entries,loadEnabled:this.loadEnabled,installedCatalog:this.installedCatalog,surface:this.surface}}async applyExtensionTransition(e,t){return await this.admitLifecycle(()=>xe(this.createToggleHost(),e,t),`rejected`)}createToggleHost(){return{...this.createExtensionContextHost(),db:this.db,entries:this.entries,persistEnabled:this.persistEnabled,contributionProcessors:this.contributionProcessors,runHealthCheck:e=>J(this.createExtensionHealthHost(),e),emitWarningsForEntry:(e,t)=>D({bus:this.bus,entries:this.entries,warningActionMap:this.warningActionMap},e,t)}}async admitLifecycle(e,t){return this.shutdownRequested?t:await this.enqueueLifecycle(e)}enqueueLifecycle(e){let t=this.lifecycleTail.then(()=>e(),()=>e());return this.lifecycleTail=t.then(()=>void 0,()=>void 0),t}createExtensionContextHost(){return{bus:this.bus,extensionContextBase:this.extensionContextBase,loadConfig:this.loadConfig,operatorConfig:this.operatorConfig,signal:this.shutdownController.signal,hasActiveExtension:e=>this.hasActiveExtension(e),getExtensionService:e=>this.getExtensionService(e)}}createExtensionHealthHost(){return{bus:this.bus,entries:this.entries}}hasActiveExtension(e){return this.entries.get(e)?.state===`active`}};export{k as a,y as c,U as i,W as n,b as o,V as r,v as s,$e as t};

package/dist/extension-namespace-CeRpt6C8.mjs

@@ -0,0 +1 @@
+import{z as e}from"zod";import{createBusNamespace as t}from"@makaio/framework/core";import{BrowserEntrypointSchema as n,ClientDefinitionSchema as r,ProviderDefinitionSchema as i}from"@makaio/framework/contracts";import{ExtensionWarningEntrySchema as a}from"@makaio/framework/contracts/extension";const o=e.enum([`discovered`,`initializing`,`active`,`failed`,`skipped`,`stopped`]),s=e.object({name:e.string(),displayName:e.string()}),c=s.extend({state:o,error:e.string().optional()}),l=c.extend({critical:e.boolean()}),u=c.extend({surface:e.enum([`interactive`,`headless`,`any`]).optional(),enabled:e.boolean(),extensionManaged:e.boolean(),persistedEnabled:e.boolean().optional(),critical:e.boolean(),browser:n.optional()}),d=e.enum([`local`,`npm`,`project-local`]),f=e.object({name:e.string().min(1),version:e.string(),origin:d,critical:e.boolean().optional(),criticalityUnknown:e.boolean().optional(),declaresServerEntrypoint:e.boolean().optional(),npmName:e.string().min(1).optional(),surface:e.enum([`interactive`,`headless`]).optional(),shadowedBy:d.optional(),collidesWith:d.optional(),collisionIgnoresSurface:e.boolean().optional()}),p=f.extend({extensionManaged:e.boolean(),persistedEnabled:e.boolean().optional()}),m=e.object({packageName:e.string()}),h=m.extend({definition:i}),g=m.extend({definition:r}),_=e.enum([`applied`,`rejected`,`restart-required`]),v=e.enum([`critical`,`criticality-unknown`,`not-installed`,`no-catalog`,`name-collision`,`shutting-down`,`runtime-state-diverges`,`not-loaded`,`framework-package-shadowed`]),y=t(`kernel:extension`,{stateChanged:e.object({name:e.string(),displayName:e.string(),from:o,to:o,error:e.string().optional(),contributes:e.object({adapters:e.boolean(),tools:e.boolean(),hashTriggers:e.boolean(),providers:e.boolean(),clients:e.boolean(),ui:e.boolean(),storage:e.boolean(),sessionEventActions:e.boolean()}).optional()}),list:{request:e.object({}),response:e.object({extensions:e.array(u)})},get:{request:e.object({name:e.string()}),response:e.object({extension:u.nullable()})},setEnabled:{request:e.object({name:e.string(),enabled:e.boolean()}),response:e.object({success:e.boolean(),outcome:_,reason:v.optional()})},catalog:{request:e.object({}),response:e.object({entries:e.array(p).nullable()})},"contributions.catalog":{request:e.object({}),response:e.object({providers:e.array(h),clients:e.array(g)})},enabledChanged:e.object({name:e.string(),enabled:e.boolean()}),"warnings.list":{request:e.object({extensionName:e.string().optional()}),response:e.object({entries:e.array(a)})},"warnings.changed":a}),b=y.subjects;export{p as a,s as c,u as d,a as f,_ as i,c as l,b as n,d as o,l as p,v as r,f as s,y as t,o as u};