@makaio/framework 1.0.0-dev-1783705652236 → 1.0.0-dev-1783973359164

package/dist/{load-extensions-DNRIy4zC.d.mts → load-extensions-_EnedkUp.d.mts}

@@ -1,4 +1,4 @@
-import { t as DiscoveredExtension } from "./extension-discovery-CIZn5bkq.mjs";
+import { t as DiscoveredExtension } from "./extension-discovery-APMf1Tes.mjs";
 import { KernelMakaioExtension } from "@makaio/framework/kernel";
 import { CliContribution } from "@makaio/framework/kernel/cli";
 

package/dist/{load-extensions-Cze1RHcG.mjs → load-extensions-nqL5WAKj.mjs}

@@ -1 +1 @@
-import{t as e}from"./descriptor-to-package-DdpjpT7n.mjs";import{pathToFileURL as t}from"node:url";import*as n from"node:path";import*as r from"node:fs";import{versionSatisfies as i}from"@makaio/framework/contracts";async function a(e,t){let{frameworkVersion:n,importModule:r=S}=t,i=[],a=new Map,s;for(let t of e){let{descriptor:e,extensionPath:c}=t,l=`[extensions] ${e.name}@${e.version}`;if(!u(t,n))continue;if(e.execution===`detached`){let t;try{s??=(await import(`./detached-extension-handle-Cx6-0eqg.mjs`)).createDetachedExtensionPackage,t=s(e,c)}catch(e){console.warn(`${l}: failed to synthesize detached extension package:`,e instanceof Error?e.message:e);continue}i.push(t),e.config?.defaults&&a.set(e.name,e.config.defaults);continue}if(!e.entrypoints.server){!e.entrypoints.browser&&!e.entrypoints.cli&&console.warn(`${l}: no executable entrypoint declared, skipping`);continue}let d;if(t.preloadedModule)d=t.preloadedModule;else try{let t=_(`server`,e.entrypoints.server,c);if(!t){console.warn(`${l}: server entrypoint could not be resolved within extension directory, skipping`);continue}d=await r(t)}catch(e){console.warn(`${l}: failed to import server entry:`,e instanceof Error?e.message:e);continue}let f=o(d.default,e.name,l);f&&(i.push(...f),e.config?.defaults&&a.set(e.name,e.config.defaults))}return{packages:i,configDefaults:a}}function o(e,t,n){if(Array.isArray(e)){let r=[],i=new Set;for(let t of e){if(!f(t)){console.warn(`${n}: default export array contains an invalid MakaioExtension, skipping`);return}if(i.has(t.name)){console.warn(`${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)){console.warn(`${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}.`))){console.warn(`${n}: default export array contains package names outside descriptor namespace '${t}', skipping`);return}return r}if(!f(e)){console.warn(`${n}: default export is not a valid MakaioExtension or MakaioExtension[], skipping`);return}if(e.name!==t){console.warn(`${n}: imported package name '${e.name}' does not match descriptor name '${t}', skipping`);return}return[e]}async function s(e,t,n){let{importModule:r=S,frameworkVersion:i}=n,a=new Map(t.map(e=>[e.name,e])),o=new Map;for(let t of e){let e=c(t,i);if(!e)continue;let n=`[extensions] ${t.descriptor.name}@${t.descriptor.version}`,s=a.get(t.descriptor.name);if(s?.cli)continue;let u=await d(t,e,n,r);if(!u)continue;if(!p(u.default)){console.warn(`${n}: default export is not a valid CliContribution, skipping`);continue}let f=t.descriptor.cli?.name??t.descriptor.name;if(u.default.name!==f){console.warn(`${n}: imported CLI contribution name '${u.default.name}' does not match descriptor CLI name '${f}', skipping`);continue}if(s){a.set(t.descriptor.name,{...s,cli:u.default});continue}if(t.descriptor.entrypoints?.server||t.descriptor.entrypoints?.browser){console.warn(`${n}: server or browser entry is present but no package was loaded, skipping CLI-only synthesis`);continue}a.set(t.descriptor.name,l(t,u.default)),t.descriptor.config?.defaults&&o.set(t.descriptor.name,t.descriptor.config.defaults)}return{packages:[...a.values()],configDefaults:o}}function c(e,t){if(u(e,t)&&e.descriptor.execution!==`detached`)return e.descriptor.entrypoints?.cli}function l(t,n){return{...e(t.descriptor),cli:n}}function u(e,t){let{descriptor:n}=e,r=`[extensions] ${n.name}@${n.version}`;try{return i(t,n.makaio.framework)?!0:(console.warn(`${r}: requires framework ${n.makaio.framework}, current is ${t}, skipping`),!1)}catch(e){return console.warn(`${r}: invalid version metadata (framework=${t}, range=${n.makaio.framework}), skipping:`,e instanceof Error?e.message:e),!1}}async function d(e,t,n,r){try{let i=_(`cli`,t,e.extensionPath);if(!i){console.warn(`${n}: cli entrypoint has no resolvable candidate within extension directory, skipping`);return}return await r(i)}catch(e){console.warn(`${n}: failed to import cli entry:`,e instanceof Error?e.message:e);return}}function f(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 p(e){if(typeof e!=`object`||!e)return!1;let t=e;return typeof t.name!=`string`||typeof t.description!=`string`||!Array.isArray(t.subcommands)||`interactive`in t&&t.interactive!==void 0&&typeof t.interactive!=`function`?!1:t.subcommands.length===0?typeof t.interactive==`function`:t.subcommands.every(m)}function m(e){if(typeof e!=`object`||!e)return!1;let t=e;return typeof t.name==`string`&&typeof t.description==`string`&&h(t.schema)&&typeof t.handler==`function`}function h(e){return typeof e==`object`&&!!e&&typeof e.safeParse==`function`}function g(e,t){return t===!0?e:t}function _(e,t,r){if(!n.isAbsolute(r))return;let i=g(e,t),a=x(r),o=n.resolve(r,`src`,`${i}.ts`);if(y(o,a))return o;let s=n.resolve(r,`dist`,`${i}.mjs`);if(y(s,a))return s}function v(e,t){let n=x(t);return b(x(e),n)}function y(e,t){try{return b(r.realpathSync(e),t)}catch{return!1}}function b(e,t){return e.startsWith(t+n.sep)}function x(e){let t=n.resolve(e);try{return r.realpathSync(t)}catch{return t}}async function S(e){return await import(t(e).href)}export{f as a,_ as c,u as i,g as n,v as o,p as r,a as s,s as t};
+import{t as e}from"./descriptor-to-package-Rs-OjOQU.mjs";import{pathToFileURL as t}from"node:url";import*as n from"node:path";import*as r from"node:fs";import{versionSatisfies as i}from"@makaio/framework/contracts";async function a(e,t){let{frameworkVersion:n,importModule:r=S}=t,i=[],a=new Map,s;for(let t of e){let{descriptor:e,extensionPath:c}=t,l=`[extensions] ${e.name}@${e.version}`;if(!u(t,n))continue;if(e.execution===`detached`){let t;try{s??=(await import(`./detached-extension-handle-vDK194QV.mjs`)).createDetachedExtensionPackage,t=s(e,c)}catch(e){console.warn(`${l}: failed to synthesize detached extension package:`,e instanceof Error?e.message:e);continue}i.push(t),e.config?.defaults&&a.set(e.name,e.config.defaults);continue}if(!e.entrypoints.server){!e.entrypoints.browser&&!e.entrypoints.cli&&console.warn(`${l}: no executable entrypoint declared, skipping`);continue}let d;if(t.preloadedModule)d=t.preloadedModule;else try{let t=_(`server`,e.entrypoints.server,c);if(!t){console.warn(`${l}: server entrypoint could not be resolved within extension directory, skipping`);continue}d=await r(t)}catch(e){console.warn(`${l}: failed to import server entry:`,e instanceof Error?e.message:e);continue}let f=o(d.default,e.name,l);f&&(i.push(...f),e.config?.defaults&&a.set(e.name,e.config.defaults))}return{packages:i,configDefaults:a}}function o(e,t,n){if(Array.isArray(e)){let r=[],i=new Set;for(let t of e){if(!f(t)){console.warn(`${n}: default export array contains an invalid MakaioExtension, skipping`);return}if(i.has(t.name)){console.warn(`${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)){console.warn(`${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}.`))){console.warn(`${n}: default export array contains package names outside descriptor namespace '${t}', skipping`);return}return r}if(!f(e)){console.warn(`${n}: default export is not a valid MakaioExtension or MakaioExtension[], skipping`);return}if(e.name!==t){console.warn(`${n}: imported package name '${e.name}' does not match descriptor name '${t}', skipping`);return}return[e]}async function s(e,t,n){let{importModule:r=S,frameworkVersion:i}=n,a=new Map(t.map(e=>[e.name,e])),o=new Map;for(let t of e){let e=c(t,i);if(!e)continue;let n=`[extensions] ${t.descriptor.name}@${t.descriptor.version}`,s=a.get(t.descriptor.name);if(s?.cli)continue;let u=await d(t,e,n,r);if(!u)continue;if(!p(u.default)){console.warn(`${n}: default export is not a valid CliContribution, skipping`);continue}let f=t.descriptor.cli?.name??t.descriptor.name;if(u.default.name!==f){console.warn(`${n}: imported CLI contribution name '${u.default.name}' does not match descriptor CLI name '${f}', skipping`);continue}if(s){a.set(t.descriptor.name,{...s,cli:u.default});continue}if(t.descriptor.entrypoints?.server||t.descriptor.entrypoints?.browser){console.warn(`${n}: server or browser entry is present but no package was loaded, skipping CLI-only synthesis`);continue}a.set(t.descriptor.name,l(t,u.default)),t.descriptor.config?.defaults&&o.set(t.descriptor.name,t.descriptor.config.defaults)}return{packages:[...a.values()],configDefaults:o}}function c(e,t){if(u(e,t)&&e.descriptor.execution!==`detached`)return e.descriptor.entrypoints?.cli}function l(t,n){return{...e(t.descriptor),cli:n}}function u(e,t){let{descriptor:n}=e,r=`[extensions] ${n.name}@${n.version}`;try{return i(t,n.makaio.framework)?!0:(console.warn(`${r}: requires framework ${n.makaio.framework}, current is ${t}, skipping`),!1)}catch(e){return console.warn(`${r}: invalid version metadata (framework=${t}, range=${n.makaio.framework}), skipping:`,e instanceof Error?e.message:e),!1}}async function d(e,t,n,r){try{let i=_(`cli`,t,e.extensionPath);if(!i){console.warn(`${n}: cli entrypoint has no resolvable candidate within extension directory, skipping`);return}return await r(i)}catch(e){console.warn(`${n}: failed to import cli entry:`,e instanceof Error?e.message:e);return}}function f(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 p(e){if(typeof e!=`object`||!e)return!1;let t=e;return typeof t.name!=`string`||typeof t.description!=`string`||!Array.isArray(t.subcommands)||`interactive`in t&&t.interactive!==void 0&&typeof t.interactive!=`function`?!1:t.subcommands.length===0?typeof t.interactive==`function`:t.subcommands.every(m)}function m(e){if(typeof e!=`object`||!e)return!1;let t=e;return typeof t.name==`string`&&typeof t.description==`string`&&h(t.schema)&&typeof t.handler==`function`}function h(e){return typeof e==`object`&&!!e&&typeof e.safeParse==`function`}function g(e,t){return t===!0?e:t}function _(e,t,r){if(!n.isAbsolute(r))return;let i=g(e,t),a=x(r),o=n.resolve(r,`src`,`${i}.ts`);if(y(o,a))return o;let s=n.resolve(r,`dist`,`${i}.mjs`);if(y(s,a))return s}function v(e,t){let n=x(t);return b(x(e),n)}function y(e,t){try{return b(r.realpathSync(e),t)}catch{return!1}}function b(e,t){return e.startsWith(t+n.sep)}function x(e){let t=n.resolve(e);try{return r.realpathSync(t)}catch{return t}}async function S(e){return await import(t(e).href)}export{f as a,_ as c,u as i,g as n,v as o,p as r,a as s,s as t};

package/dist/mcp-http-server/index.d.mts

@@ -188,116 +188,56 @@ declare function resolveMcpTools(bus: IMakaioBus, options?: McpToolDiscoveryOpti
  */
 declare function toolInfoToMcpTool(tool: ToolInfo, mcpName: string): McpToolDefinition;
 //#endregion
-//#region subsystems/mcp-http-server/src/server.d.ts
-/** Query parameter name used by adapters to pass the session ID when custom headers are not available. */
-declare const ADAPTER_SESSION_ID_PARAM = "adapterSessionId";
-/** HTTP header name that carries the adapter session ID after query-param promotion. */
-declare const ADAPTER_SESSION_ID_HEADER = "x-adapter-session-id";
-/**
- * Options for configuring MCP server startup.
- */
-interface McpServerOptions {
-  /** Required. Defaults to `'stdio'` when using {@link startMcpServer}. */
+//#region subsystems/mcp-http-server/src/server-options.d.ts
+/** Resolve session-stable context overrides for an adapter session. */
+type ResolveContextOverrides = (adapterSessionId: string | undefined) => ToolExecutionContextOverrides | undefined;
+/** Shared timeout option for MCP tool execution. */
+interface ToolExecutionTimeoutOption {
+  /** Positive timeout in milliseconds, bounded to 30 minutes. */
+  toolExecutionTimeoutMs?: number;
+}
+/** Options for configuring MCP server startup. */
+interface McpServerOptions extends ToolExecutionTimeoutOption {
   transport: 'stdio' | 'http';
-  /** Port for HTTP transport. When omitted or 0, OS assigns an available port. */
   port?: number;
-  /** Agent context for HTTP transport routing. */
   agentContext?: McpAgentContext$1;
-  /** Optional MCP tool discovery customization. */
   toolDiscovery?: McpToolDiscoveryOptions;
-  /**
-   * Optional callback invoked exactly once when the stdio transport closes.
-   *
-   * Fired on whichever of these happens first: the client detaches (stdin EOF),
-   * the SDK transport fires its own `onclose` hook, or an explicit
-   * {@link StdioMcpServerHandle.close} call completes. Subsequent triggers are
-   * suppressed so the callback is guaranteed to fire at most once.
-   *
-   * Only consulted for `transport: 'stdio'`; ignored for HTTP.
-   */
+  resolveContextOverrides?: ResolveContextOverrides;
   onclose?: () => void;
 }
-/**
- * Result returned by {@link startMcpServer} for the stdio transport.
- */
+/** Result returned for the stdio transport. */
 interface StdioMcpServerHandle {
-  /** Gracefully close the MCP server and stdio transport. */
   close: () => Promise<void>;
 }
-/**
- * Result returned by {@link startHttpMcpServer}.
- */
+/** Result returned for the HTTP transport. */
 interface HttpMcpServerHandle {
-  /** OS-assigned port the HTTP server is listening on. */
   port: number;
-  /** Context registry for registering/unregistering agent sessions. */
   contextRegistry: IMcpContextRegistry;
-  /** Gracefully close the HTTP server and MCP transport. */
   close: () => Promise<void>;
 }
-/**
- * Callback that resolves session-stable context overrides for a given
- * adapter session ID.
- *
- * Invoked on every tool-call request. When the session is found, its
- * return value overrides the default fallback context
- * `{ cwd: process.cwd(), sessionId }`. When the session is unknown or
- * the header is absent, returning `undefined` keeps the fallback.
- * @param adapterSessionId - The adapter session ID extracted from request
- *   headers, or `undefined` when the header is absent.
- * @returns Resolved context overrides, or `undefined` to use the fallback.
- */
-type ResolveContextOverrides = (adapterSessionId: string | undefined) => ToolExecutionContextOverrides | undefined;
-/**
- * Options for {@link createMcpServer}.
- */
-interface CreateMcpServerOptions {
-  /** Registry for resolving agent context by adapterSessionId. When present, the `approve` tool is exposed. */
+/** Options for creating the transport-independent MCP server. */
+interface CreateMcpServerOptions extends ToolExecutionTimeoutOption {
   contextRegistry?: IMcpContextRegistry;
-  /** Optional tool discovery customization. */
   toolDiscovery?: McpToolDiscoveryOptions;
-  /** Optional callback to resolve session-stable context overrides from an adapter session ID at tool-call time. */
   resolveContextOverrides?: ResolveContextOverrides;
 }
-/**
- * Transport-agnostic options shared by {@link createHttpMcpHandler},
- * {@link createFetchMcpHandler}, and {@link startHttpMcpServer}.  These fields configure the MCP server and its
- * attached transport without prescribing how the resulting handler is mounted
- * onto an HTTP stack.
- */
-interface HttpMcpHandlerOptions {
-  /** Agent context for HTTP transport routing. */
+/** Transport-independent HTTP MCP handler options. */
+interface HttpMcpHandlerOptions extends ToolExecutionTimeoutOption {
   agentContext?: McpAgentContext$1;
-  /** Optional MCP tool discovery customization. */
   toolDiscovery?: McpToolDiscoveryOptions;
-  /**
-   * Optional callback invoked when the underlying MCP transport closes.
-   *
-   * Called synchronously by the MCP SDK's transport `onclose` hook — that is,
-   * after {@link HttpMcpHandlerHandle.close}, {@link FetchMcpHandlerHandle.close},
-   * or {@link HttpMcpServerHandle.close}
-   * has been called and the transport has finished tearing down.  Intended for
-   * best-effort resource cleanup (e.g. flushing session registries) without
-   * blocking the close path.
-   *
-   * When used via {@link startHttpMcpServer}, the callback fires after the MCP
-   * transport closes, which occurs during the combined server-and-transport
-   * teardown initiated by {@link HttpMcpServerHandle.close}.
-   */
   onclose?: () => void;
-  /** Optional callback for session-stable context override resolution. */
   resolveContextOverrides?: ResolveContextOverrides;
 }
-/**
- * Options accepted by {@link startHttpMcpServer}.
- *
- * Extends {@link HttpMcpHandlerOptions} with `port`, which controls which
- * TCP port the internally-created `http.Server` listens on.
- */
+/** Options for starting a standalone HTTP MCP server. */
 interface HttpMcpServerOptions extends HttpMcpHandlerOptions {
-  /** Port for HTTP transport. When omitted or 0, OS assigns an available port. */
   port?: number;
 }
+//#endregion
+//#region subsystems/mcp-http-server/src/server.d.ts
+/** Query parameter name used by adapters to pass the session ID when custom headers are not available. */
+declare const ADAPTER_SESSION_ID_PARAM = "adapterSessionId";
+/** HTTP header name that carries the adapter session ID after query-param promotion. */
+declare const ADAPTER_SESSION_ID_HEADER = "x-adapter-session-id";
 /**
  * Result returned by {@link createHttpMcpHandler}.
  *
@@ -329,11 +269,6 @@ interface HttpMcpHandlerHandle {
  *
  * **Freshness contract:** Tool lists are resolved fresh on every MCP `tools/list` and
  * `tools/call` request. There is no caching between calls.
- *
- * **Side-effect:** Subscribes to {@link ToolSubjects.registryChanged} on `bus` and
- * sends `notifications/tools/list_changed` to connected MCP clients on each emission.
- * Calling `server.close()` unsubscribes this listener; connected transport closure
- * also reaches the same idempotent cleanup through the SDK's `onclose` hook.
  * @param bus - Bus instance for tool execution and approval RPC.
  * @param sessionId - Session identifier for tool execution context.
  * @param options - Optional server configuration.
@@ -456,7 +391,9 @@ declare function startHttpMcpServer(bus: IMakaioBus, options?: HttpMcpServerOpti
  * For the stdio transport, returns a {@link StdioMcpServerHandle} whose
  * `close()` method gracefully tears down the MCP server. Pass
  * `options.onclose` to receive a single callback when the transport closes for
- * any reason (client detach via stdin EOF, or explicit `handle.close()`).
+ * any reason (client detach via stdin EOF, or explicit `handle.close()`). Pass
+ * `options.resolveContextOverrides` to resolve current execution context on
+ * every tool call, including calls after client reconnects.
  * Signal handling is intentionally left to the composition root — library code
  * must not own process-global resources such as `process.on('SIGINT')`.
  * @param bus - Bus instance.