@makaio/framework 1.0.0-dev-1781382091626 → 1.0.0-dev-1781397017668

package/dist/index-B99Prx5a.d.mts

@@ -0,0 +1,859 @@
+import * as _$zod from "zod";
+import { z } from "zod";
+import * as _$_makaio_core0 from "@makaio/framework/core";
+import * as _$zod_v4_core0 from "zod/v4/core";
+
+//#region core/contracts/src/canonical-model/types.d.ts
+/** Exhaustive tuple of all {@link CanonicalModelParseErrorCode} values. */
+declare const CANONICAL_MODEL_PARSE_ERROR_CODES: readonly ["empty", "empty-model", "empty-routing", "empty-segment", "too-many-segments", "invalid-segment", "invalid-virtual-name", "empty-virtual-name"];
+/**
+ * Error codes produced by the canonical model parser.
+ *
+ * Each code identifies a distinct malformed-input condition:
+ * - `'empty'` - empty or whitespace-only input
+ * - `'empty-model'` - `'::'` present with nothing after it
+ * - `'empty-routing'` - `'::'` present with nothing before it
+ * - `'empty-segment'` - consecutive slashes produce an empty routing segment
+ * - `'too-many-segments'` - more than two routing segments before `'::'`
+ * - `'invalid-segment'` - routing segment contains characters outside `[a-z0-9._-]`
+ * - `'invalid-virtual-name'` - virtual model name contains characters outside `[a-z0-9_-]`
+ * - `'empty-virtual-name'` - bare `'~'` sigil with no name following it
+ */
+type CanonicalModelParseErrorCode = (typeof CANONICAL_MODEL_PARSE_ERROR_CODES)[number];
+/** Zod schema for {@link CanonicalModelParseErrorCode}. */
+declare const CanonicalModelParseErrorCodeSchema: z.ZodEnum<{
+  empty: "empty";
+  "empty-model": "empty-model";
+  "empty-routing": "empty-routing";
+  "empty-segment": "empty-segment";
+  "too-many-segments": "too-many-segments";
+  "invalid-segment": "invalid-segment";
+  "invalid-virtual-name": "invalid-virtual-name";
+  "empty-virtual-name": "empty-virtual-name";
+}>;
+/**
+ * Parse error returned by the canonical model parser.
+ *
+ * Discriminated by `kind: 'parse-error'` so it can be combined into
+ * {@link CanonicalModelParseResult} and narrowed with a type guard.
+ */
+interface CanonicalModelParseError {
+  readonly kind: 'parse-error';
+  /** Machine-readable error category. */
+  readonly code: CanonicalModelParseErrorCode;
+  /** Human-readable description of the problem. */
+  readonly message: string;
+  /** The verbatim input string that produced the error. */
+  readonly input: string;
+}
+/** Zod schema for {@link CanonicalModelParseError}. */
+declare const CanonicalModelParseErrorSchema: z.ZodObject<{
+  kind: z.ZodLiteral<"parse-error">;
+  code: z.ZodEnum<{
+    empty: "empty";
+    "empty-model": "empty-model";
+    "empty-routing": "empty-routing";
+    "empty-segment": "empty-segment";
+    "too-many-segments": "too-many-segments";
+    "invalid-segment": "invalid-segment";
+    "invalid-virtual-name": "invalid-virtual-name";
+    "empty-virtual-name": "empty-virtual-name";
+  }>;
+  message: z.ZodString;
+  input: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Bare model reference - no routing qualifier.
+ *
+ * The entire input is treated as the verbatim model name and resolved
+ * against the default adapter/provider at runtime.
+ */
+interface BareModelRef {
+  readonly kind: 'bare';
+  /** Verbatim model name as provided by the caller (for example `'sonnet'`). */
+  readonly model: string;
+}
+/** Zod schema for {@link BareModelRef}. */
+declare const BareModelRefSchema: z.ZodObject<{
+  kind: z.ZodLiteral<"bare">;
+  model: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Qualified model reference - one or two routing segments followed by `'::'` and a model name.
+ *
+ * Routing segments are case-normalised to lowercase during parsing.
+ * The model name is passed through verbatim.
+ */
+interface QualifiedModelRef {
+  readonly kind: 'qualified';
+  /** First routing segment - adapter or provider slug, lowercased. */
+  readonly segment1: string;
+  /** Second routing segment - provider slug when `segment1` is an adapter, lowercased. */
+  readonly segment2?: string;
+  /** Verbatim model name appearing after `'::'`. */
+  readonly model: string;
+}
+/** Zod schema for {@link QualifiedModelRef}. */
+declare const QualifiedModelRefSchema: z.ZodObject<{
+  kind: z.ZodLiteral<"qualified">;
+  segment1: z.ZodString;
+  segment2: z.ZodOptional<z.ZodString>;
+  model: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Virtual model reference - a logical alias introduced with the `'~'` sigil.
+ *
+ * Hosts may translate this higher-level reference through the existing
+ * virtual-model resolution seam. The framework-owned canonical-model resolver
+ * intentionally does not consume this parsed form.
+ */
+interface VirtualModelRef {
+  readonly kind: 'virtual';
+  /** Virtual model name without the leading `'~'` sigil. */
+  readonly name: string;
+}
+/** Zod schema for {@link VirtualModelRef}. */
+declare const VirtualModelRefSchema: z.ZodObject<{
+  kind: z.ZodLiteral<"virtual">;
+  name: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Discriminated union of all successfully parsed canonical model forms.
+ *
+ * Narrow with `result.kind` or use the {@link isCanonicalModelParseError} type
+ * guard to separate success from failure.
+ */
+type ParsedCanonicalModel = BareModelRef | QualifiedModelRef | VirtualModelRef;
+/** Zod schema for {@link ParsedCanonicalModel}. */
+declare const ParsedCanonicalModelSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  kind: z.ZodLiteral<"bare">;
+  model: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  kind: z.ZodLiteral<"qualified">;
+  segment1: z.ZodString;
+  segment2: z.ZodOptional<z.ZodString>;
+  model: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  kind: z.ZodLiteral<"virtual">;
+  name: z.ZodString;
+}, z.core.$strip>], "kind">;
+/**
+ * Framework-resolvable parsed canonical model forms.
+ *
+ * Host-only `kind: 'virtual'` expansion is intentionally excluded from the
+ * framework resolver contract.
+ */
+type ResolvableCanonicalModel = BareModelRef | QualifiedModelRef;
+/** Zod schema for {@link ResolvableCanonicalModel}. */
+declare const ResolvableCanonicalModelSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  kind: z.ZodLiteral<"bare">;
+  model: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  kind: z.ZodLiteral<"qualified">;
+  segment1: z.ZodString;
+  segment2: z.ZodOptional<z.ZodString>;
+  model: z.ZodString;
+}, z.core.$strip>], "kind">;
+/**
+ * Result of parsing a canonical model string.
+ *
+ * Either a successfully parsed {@link ParsedCanonicalModel} or a
+ * {@link CanonicalModelParseError} describing why parsing failed.
+ */
+type CanonicalModelParseResult = ParsedCanonicalModel | CanonicalModelParseError;
+/** Zod schema for {@link CanonicalModelParseResult}. */
+declare const CanonicalModelParseResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  kind: z.ZodLiteral<"bare">;
+  model: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  kind: z.ZodLiteral<"qualified">;
+  segment1: z.ZodString;
+  segment2: z.ZodOptional<z.ZodString>;
+  model: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  kind: z.ZodLiteral<"virtual">;
+  name: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  kind: z.ZodLiteral<"parse-error">;
+  code: z.ZodEnum<{
+    empty: "empty";
+    "empty-model": "empty-model";
+    "empty-routing": "empty-routing";
+    "empty-segment": "empty-segment";
+    "too-many-segments": "too-many-segments";
+    "invalid-segment": "invalid-segment";
+    "invalid-virtual-name": "invalid-virtual-name";
+    "empty-virtual-name": "empty-virtual-name";
+  }>;
+  message: z.ZodString;
+  input: z.ZodString;
+}, z.core.$strip>], "kind">;
+//#endregion
+//#region core/contracts/src/canonical-model/parser.d.ts
+/**
+ * Matches a valid routing segment: starts with `[a-z0-9]`, followed by
+ * `[a-z0-9._-]*`.
+ *
+ * Exported so other schema layers can share the same routing constraint.
+ */
+declare const SEGMENT_RE: RegExp;
+/**
+ * Matches a valid virtual model name: starts with `[a-z0-9]`, followed by
+ * `[a-z0-9_-]*`.
+ *
+ * Exported so host-owned virtual-model schemas can enforce the same naming
+ * rule at write time.
+ */
+declare const VIRTUAL_NAME_RE: RegExp;
+/**
+ * Parse a canonical model string into a structured reference.
+ *
+ * The grammar is:
+ * ```
+ * canonical          := "~" virtual_model_name
+ *                     | routing "::" model_name
+ *                     | model_name
+ *
+ * routing            := segment
+ *                     | segment "/" segment
+ *
+ * segment            := [a-z0-9][a-z0-9._-]*
+ * model_name         := <any non-empty string>
+ * virtual_model_name := [a-z0-9][a-z0-9_-]*
+ * ```
+ *
+ * Routing segments are lowercased during parsing because they are
+ * case-insensitive for matching purposes. Model names are passed through
+ * verbatim as they are provider-defined and case-sensitive.
+ * @param input - The canonical model string to parse
+ * @returns A parsed reference or a parse error
+ */
+declare function parseCanonicalModel(input: string): CanonicalModelParseResult;
+/**
+ * Type guard for distinguishing parse errors from successful parse results.
+ * @param result - The parse result to check
+ * @returns `true` when the result is a parse error
+ */
+declare function isCanonicalModelParseError(result: CanonicalModelParseResult): result is CanonicalModelParseError;
+//#endregion
+//#region core/contracts/src/canonical-model/selection.d.ts
+/**
+ * Agent selection for `kind: 'canonical-model'`.
+ *
+ * The `model` field carries the canonical model reference string verbatim.
+ * Resolution happens immediately at the `AgentResolutionSubjects.resolve`
+ * chokepoint, so this kind never persists into runtime spawn paths.
+ */
+declare const CanonicalModelSelectionSchema: z.ZodObject<{
+  providerConfigId: z.ZodOptional<z.ZodString>;
+  reasoningEffort: z.ZodOptional<z.ZodEnum<{
+    none: "none";
+    low: "low";
+    medium: "medium";
+    high: "high";
+    "extra-high": "extra-high";
+  }>>;
+  cwd: z.ZodOptional<z.ZodString>;
+  systemPrompt: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    mode: z.ZodLiteral<"append">;
+    content: z.ZodString;
+  }, z.core.$strip>]>>;
+  allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  mcpSessionContext: z.ZodOptional<z.ZodObject<{
+    sessionId: z.ZodString;
+    directTools: z.ZodArray<z.ZodObject<{
+      fullName: z.ZodString;
+      originalName: z.ZodString;
+      serverName: z.ZodString;
+      description: z.ZodOptional<z.ZodString>;
+      inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+      exposureMode: z.ZodEnum<{
+        hidden: "hidden";
+        discovery: "discovery";
+        direct: "direct";
+      }>;
+      enabled: z.ZodBoolean;
+      enabledBy: z.ZodOptional<z.ZodEnum<{
+        discovery: "discovery";
+        toolset: "toolset";
+      }>>;
+      enabledAt: z.ZodOptional<z.ZodNumber>;
+      exposed: z.ZodBoolean;
+    }, z.core.$strip>>;
+    servers: z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      transport: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"stdio">;
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        alwaysLoad: z.ZodOptional<z.ZodBoolean>;
+      }, z.core.$strip>, z.ZodObject<{
+        url: z.ZodString;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+          name: z.ZodString;
+          permission_policy: z.ZodEnum<{
+            always_allow: "always_allow";
+            always_ask: "always_ask";
+            always_deny: "always_deny";
+          }>;
+        }, z.core.$strip>>>;
+        alwaysLoad: z.ZodOptional<z.ZodBoolean>;
+        type: z.ZodLiteral<"sse">;
+      }, z.core.$strip>, z.ZodObject<{
+        url: z.ZodString;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+          name: z.ZodString;
+          permission_policy: z.ZodEnum<{
+            always_allow: "always_allow";
+            always_ask: "always_ask";
+            always_deny: "always_deny";
+          }>;
+        }, z.core.$strip>>>;
+        alwaysLoad: z.ZodOptional<z.ZodBoolean>;
+        type: z.ZodLiteral<"http">;
+      }, z.core.$strip>], "type">;
+      exposureMode: z.ZodEnum<{
+        discovery: "discovery";
+        direct: "direct";
+      }>;
+    }, z.core.$strip>>;
+    discoverableTools: z.ZodArray<z.ZodObject<{
+      fullName: z.ZodString;
+      originalName: z.ZodString;
+      serverName: z.ZodString;
+      description: z.ZodOptional<z.ZodString>;
+      inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+      exposureMode: z.ZodEnum<{
+        hidden: "hidden";
+        discovery: "discovery";
+        direct: "direct";
+      }>;
+      enabled: z.ZodBoolean;
+      enabledBy: z.ZodOptional<z.ZodEnum<{
+        discovery: "discovery";
+        toolset: "toolset";
+      }>>;
+      enabledAt: z.ZodOptional<z.ZodNumber>;
+      exposed: z.ZodBoolean;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+  allowedDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  adapterConfig: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
+  kind: z.ZodLiteral<"canonical-model">;
+  model: z.ZodString;
+}, z.core.$loose>;
+type CanonicalModelSelection = z.infer<typeof CanonicalModelSelectionSchema>;
+declare module '@makaio/framework/contracts' {
+  interface AgentSelectionKindMap {
+    'canonical-model': CanonicalModelSelection;
+  }
+}
+//#endregion
+//#region core/contracts/src/canonical-model/schemas.d.ts
+/**
+ * Resolved adapter selection produced by framework canonical-model resolution.
+ *
+ * Canonical-model resolution is intentionally limited to adapter/provider/model
+ * routing. Host-only virtual-model expansion happens at the higher-level
+ * agent-resolution seam.
+ */
+declare const CanonicalModelResolvedSelectionSchema: z.ZodObject<{
+  reasoningEffort: z.ZodOptional<z.ZodEnum<{
+    none: "none";
+    low: "low";
+    medium: "medium";
+    high: "high";
+    "extra-high": "extra-high";
+  }>>;
+  cwd: z.ZodOptional<z.ZodString>;
+  systemPrompt: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    mode: z.ZodLiteral<"append">;
+    content: z.ZodString;
+  }, z.core.$strip>]>>;
+  allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  mcpSessionContext: z.ZodOptional<z.ZodObject<{
+    sessionId: z.ZodString;
+    directTools: z.ZodArray<z.ZodObject<{
+      fullName: z.ZodString;
+      originalName: z.ZodString;
+      serverName: z.ZodString;
+      description: z.ZodOptional<z.ZodString>;
+      inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+      exposureMode: z.ZodEnum<{
+        hidden: "hidden";
+        discovery: "discovery";
+        direct: "direct";
+      }>;
+      enabled: z.ZodBoolean;
+      enabledBy: z.ZodOptional<z.ZodEnum<{
+        discovery: "discovery";
+        toolset: "toolset";
+      }>>;
+      enabledAt: z.ZodOptional<z.ZodNumber>;
+      exposed: z.ZodBoolean;
+    }, z.core.$strip>>;
+    servers: z.ZodArray<z.ZodObject<{
+      name: z.ZodString;
+      transport: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"stdio">;
+        command: z.ZodString;
+        args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        alwaysLoad: z.ZodOptional<z.ZodBoolean>;
+      }, z.core.$strip>, z.ZodObject<{
+        url: z.ZodString;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+          name: z.ZodString;
+          permission_policy: z.ZodEnum<{
+            always_allow: "always_allow";
+            always_ask: "always_ask";
+            always_deny: "always_deny";
+          }>;
+        }, z.core.$strip>>>;
+        alwaysLoad: z.ZodOptional<z.ZodBoolean>;
+        type: z.ZodLiteral<"sse">;
+      }, z.core.$strip>, z.ZodObject<{
+        url: z.ZodString;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+          name: z.ZodString;
+          permission_policy: z.ZodEnum<{
+            always_allow: "always_allow";
+            always_ask: "always_ask";
+            always_deny: "always_deny";
+          }>;
+        }, z.core.$strip>>>;
+        alwaysLoad: z.ZodOptional<z.ZodBoolean>;
+        type: z.ZodLiteral<"http">;
+      }, z.core.$strip>], "type">;
+      exposureMode: z.ZodEnum<{
+        discovery: "discovery";
+        direct: "direct";
+      }>;
+    }, z.core.$strip>>;
+    discoverableTools: z.ZodArray<z.ZodObject<{
+      fullName: z.ZodString;
+      originalName: z.ZodString;
+      serverName: z.ZodString;
+      description: z.ZodOptional<z.ZodString>;
+      inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+      exposureMode: z.ZodEnum<{
+        hidden: "hidden";
+        discovery: "discovery";
+        direct: "direct";
+      }>;
+      enabled: z.ZodBoolean;
+      enabledBy: z.ZodOptional<z.ZodEnum<{
+        discovery: "discovery";
+        toolset: "toolset";
+      }>>;
+      enabledAt: z.ZodOptional<z.ZodNumber>;
+      exposed: z.ZodBoolean;
+    }, z.core.$strip>>;
+  }, z.core.$strip>>;
+  allowedDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  adapterConfig: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
+  adapterId: z.ZodOptional<z.ZodString>;
+  kind: z.ZodLiteral<"adapter">;
+  adapterName: z.ZodString;
+  providerConfigId: z.ZodString;
+  model: z.ZodString;
+}, z.core.$loose>;
+type CanonicalModelResolvedSelection = z.infer<typeof CanonicalModelResolvedSelectionSchema>;
+/**
+ * Bus schemas for framework canonical-model resolution.
+ *
+ * Each key becomes a subject identifier as `canonicalModel.<key>`.
+ */
+declare const CanonicalModelSchemas: {
+  resolve: {
+    request: z.ZodObject<{
+      parsed: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"bare">;
+        model: z.ZodString;
+      }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"qualified">;
+        segment1: z.ZodString;
+        segment2: z.ZodOptional<z.ZodString>;
+        model: z.ZodString;
+      }, z.core.$strip>], "kind">;
+      context: z.ZodOptional<z.ZodObject<{
+        sessionId: z.ZodOptional<z.ZodString>;
+        projectId: z.ZodOptional<z.ZodString>;
+        promptText: z.ZodOptional<z.ZodString>;
+        sessionContext: z.ZodOptional<z.ZodUnknown>;
+      }, z.core.$strip>>;
+    }, z.core.$strip>;
+    response: z.ZodObject<{
+      reasoningEffort: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        low: "low";
+        medium: "medium";
+        high: "high";
+        "extra-high": "extra-high";
+      }>>;
+      cwd: z.ZodOptional<z.ZodString>;
+      systemPrompt: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        mode: z.ZodLiteral<"append">;
+        content: z.ZodString;
+      }, z.core.$strip>]>>;
+      allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+      mcpSessionContext: z.ZodOptional<z.ZodObject<{
+        sessionId: z.ZodString;
+        directTools: z.ZodArray<z.ZodObject<{
+          fullName: z.ZodString;
+          originalName: z.ZodString;
+          serverName: z.ZodString;
+          description: z.ZodOptional<z.ZodString>;
+          inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+          exposureMode: z.ZodEnum<{
+            hidden: "hidden";
+            discovery: "discovery";
+            direct: "direct";
+          }>;
+          enabled: z.ZodBoolean;
+          enabledBy: z.ZodOptional<z.ZodEnum<{
+            discovery: "discovery";
+            toolset: "toolset";
+          }>>;
+          enabledAt: z.ZodOptional<z.ZodNumber>;
+          exposed: z.ZodBoolean;
+        }, z.core.$strip>>;
+        servers: z.ZodArray<z.ZodObject<{
+          name: z.ZodString;
+          transport: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"stdio">;
+            command: z.ZodString;
+            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            alwaysLoad: z.ZodOptional<z.ZodBoolean>;
+          }, z.core.$strip>, z.ZodObject<{
+            url: z.ZodString;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+              name: z.ZodString;
+              permission_policy: z.ZodEnum<{
+                always_allow: "always_allow";
+                always_ask: "always_ask";
+                always_deny: "always_deny";
+              }>;
+            }, z.core.$strip>>>;
+            alwaysLoad: z.ZodOptional<z.ZodBoolean>;
+            type: z.ZodLiteral<"sse">;
+          }, z.core.$strip>, z.ZodObject<{
+            url: z.ZodString;
+            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+              name: z.ZodString;
+              permission_policy: z.ZodEnum<{
+                always_allow: "always_allow";
+                always_ask: "always_ask";
+                always_deny: "always_deny";
+              }>;
+            }, z.core.$strip>>>;
+            alwaysLoad: z.ZodOptional<z.ZodBoolean>;
+            type: z.ZodLiteral<"http">;
+          }, z.core.$strip>], "type">;
+          exposureMode: z.ZodEnum<{
+            discovery: "discovery";
+            direct: "direct";
+          }>;
+        }, z.core.$strip>>;
+        discoverableTools: z.ZodArray<z.ZodObject<{
+          fullName: z.ZodString;
+          originalName: z.ZodString;
+          serverName: z.ZodString;
+          description: z.ZodOptional<z.ZodString>;
+          inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+          exposureMode: z.ZodEnum<{
+            hidden: "hidden";
+            discovery: "discovery";
+            direct: "direct";
+          }>;
+          enabled: z.ZodBoolean;
+          enabledBy: z.ZodOptional<z.ZodEnum<{
+            discovery: "discovery";
+            toolset: "toolset";
+          }>>;
+          enabledAt: z.ZodOptional<z.ZodNumber>;
+          exposed: z.ZodBoolean;
+        }, z.core.$strip>>;
+      }, z.core.$strip>>;
+      allowedDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+      adapterConfig: z.ZodOptional<z.ZodType<Record<string, unknown>, Record<string, unknown>, z.core.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
+      adapterId: z.ZodOptional<z.ZodString>;
+      kind: z.ZodLiteral<"adapter">;
+      adapterName: z.ZodString;
+      providerConfigId: z.ZodString;
+      model: z.ZodString;
+    }, z.core.$loose>;
+  };
+};
+//#endregion
+//#region core/contracts/src/canonical-model/namespace.d.ts
+/** Bus namespace definition for framework canonical-model resolution. */
+declare const CanonicalModelNamespace: _$_makaio_core0.BusNamespaceDefinition<"canonicalModel", {
+  resolve: {
+    request: _$zod.ZodObject<{
+      parsed: _$zod.ZodDiscriminatedUnion<[_$zod.ZodObject<{
+        kind: _$zod.ZodLiteral<"bare">;
+        model: _$zod.ZodString;
+      }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
+        kind: _$zod.ZodLiteral<"qualified">;
+        segment1: _$zod.ZodString;
+        segment2: _$zod.ZodOptional<_$zod.ZodString>;
+        model: _$zod.ZodString;
+      }, _$zod_v4_core0.$strip>], "kind">;
+      context: _$zod.ZodOptional<_$zod.ZodObject<{
+        sessionId: _$zod.ZodOptional<_$zod.ZodString>;
+        projectId: _$zod.ZodOptional<_$zod.ZodString>;
+        promptText: _$zod.ZodOptional<_$zod.ZodString>;
+        sessionContext: _$zod.ZodOptional<_$zod.ZodUnknown>;
+      }, _$zod_v4_core0.$strip>>;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      reasoningEffort: _$zod.ZodOptional<_$zod.ZodEnum<{
+        none: "none";
+        low: "low";
+        medium: "medium";
+        high: "high";
+        "extra-high": "extra-high";
+      }>>;
+      cwd: _$zod.ZodOptional<_$zod.ZodString>;
+      systemPrompt: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodString, _$zod.ZodObject<{
+        mode: _$zod.ZodLiteral<"append">;
+        content: _$zod.ZodString;
+      }, _$zod_v4_core0.$strip>]>>;
+      allowedTools: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodString>>;
+      disallowedTools: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodString>>;
+      env: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodString>>;
+      mcpSessionContext: _$zod.ZodOptional<_$zod.ZodObject<{
+        sessionId: _$zod.ZodString;
+        directTools: _$zod.ZodArray<_$zod.ZodObject<{
+          fullName: _$zod.ZodString;
+          originalName: _$zod.ZodString;
+          serverName: _$zod.ZodString;
+          description: _$zod.ZodOptional<_$zod.ZodString>;
+          inputSchema: _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>;
+          exposureMode: _$zod.ZodEnum<{
+            hidden: "hidden";
+            discovery: "discovery";
+            direct: "direct";
+          }>;
+          enabled: _$zod.ZodBoolean;
+          enabledBy: _$zod.ZodOptional<_$zod.ZodEnum<{
+            discovery: "discovery";
+            toolset: "toolset";
+          }>>;
+          enabledAt: _$zod.ZodOptional<_$zod.ZodNumber>;
+          exposed: _$zod.ZodBoolean;
+        }, _$zod_v4_core0.$strip>>;
+        servers: _$zod.ZodArray<_$zod.ZodObject<{
+          name: _$zod.ZodString;
+          transport: _$zod.ZodDiscriminatedUnion<[_$zod.ZodObject<{
+            type: _$zod.ZodLiteral<"stdio">;
+            command: _$zod.ZodString;
+            args: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodString>>;
+            env: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodString>>;
+            alwaysLoad: _$zod.ZodOptional<_$zod.ZodBoolean>;
+          }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
+            url: _$zod.ZodString;
+            headers: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodString>>;
+            tools: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodObject<{
+              name: _$zod.ZodString;
+              permission_policy: _$zod.ZodEnum<{
+                always_allow: "always_allow";
+                always_ask: "always_ask";
+                always_deny: "always_deny";
+              }>;
+            }, _$zod_v4_core0.$strip>>>;
+            alwaysLoad: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            type: _$zod.ZodLiteral<"sse">;
+          }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
+            url: _$zod.ZodString;
+            headers: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodString>>;
+            tools: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodObject<{
+              name: _$zod.ZodString;
+              permission_policy: _$zod.ZodEnum<{
+                always_allow: "always_allow";
+                always_ask: "always_ask";
+                always_deny: "always_deny";
+              }>;
+            }, _$zod_v4_core0.$strip>>>;
+            alwaysLoad: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            type: _$zod.ZodLiteral<"http">;
+          }, _$zod_v4_core0.$strip>], "type">;
+          exposureMode: _$zod.ZodEnum<{
+            discovery: "discovery";
+            direct: "direct";
+          }>;
+        }, _$zod_v4_core0.$strip>>;
+        discoverableTools: _$zod.ZodArray<_$zod.ZodObject<{
+          fullName: _$zod.ZodString;
+          originalName: _$zod.ZodString;
+          serverName: _$zod.ZodString;
+          description: _$zod.ZodOptional<_$zod.ZodString>;
+          inputSchema: _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>;
+          exposureMode: _$zod.ZodEnum<{
+            hidden: "hidden";
+            discovery: "discovery";
+            direct: "direct";
+          }>;
+          enabled: _$zod.ZodBoolean;
+          enabledBy: _$zod.ZodOptional<_$zod.ZodEnum<{
+            discovery: "discovery";
+            toolset: "toolset";
+          }>>;
+          enabledAt: _$zod.ZodOptional<_$zod.ZodNumber>;
+          exposed: _$zod.ZodBoolean;
+        }, _$zod_v4_core0.$strip>>;
+      }, _$zod_v4_core0.$strip>>;
+      allowedDirectories: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodString>>;
+      adapterConfig: _$zod.ZodOptional<_$zod.ZodType<Record<string, unknown>, Record<string, unknown>, _$zod_v4_core0.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
+      adapterId: _$zod.ZodOptional<_$zod.ZodString>;
+      kind: _$zod.ZodLiteral<"adapter">;
+      adapterName: _$zod.ZodString;
+      providerConfigId: _$zod.ZodString;
+      model: _$zod.ZodString;
+    }, _$zod_v4_core0.$loose>;
+  };
+}>;
+/** Typed subjects for canonical model bus operations. */
+declare const CanonicalModelSubjects: _$_makaio_core0.BusSubjects<_$_makaio_core0.FlatSubjectDefinitions<"canonicalModel", {
+  resolve: {
+    request: _$zod.ZodObject<{
+      parsed: _$zod.ZodDiscriminatedUnion<[_$zod.ZodObject<{
+        kind: _$zod.ZodLiteral<"bare">;
+        model: _$zod.ZodString;
+      }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
+        kind: _$zod.ZodLiteral<"qualified">;
+        segment1: _$zod.ZodString;
+        segment2: _$zod.ZodOptional<_$zod.ZodString>;
+        model: _$zod.ZodString;
+      }, _$zod_v4_core0.$strip>], "kind">;
+      context: _$zod.ZodOptional<_$zod.ZodObject<{
+        sessionId: _$zod.ZodOptional<_$zod.ZodString>;
+        projectId: _$zod.ZodOptional<_$zod.ZodString>;
+        promptText: _$zod.ZodOptional<_$zod.ZodString>;
+        sessionContext: _$zod.ZodOptional<_$zod.ZodUnknown>;
+      }, _$zod_v4_core0.$strip>>;
+    }, _$zod_v4_core0.$strip>;
+    response: _$zod.ZodObject<{
+      reasoningEffort: _$zod.ZodOptional<_$zod.ZodEnum<{
+        none: "none";
+        low: "low";
+        medium: "medium";
+        high: "high";
+        "extra-high": "extra-high";
+      }>>;
+      cwd: _$zod.ZodOptional<_$zod.ZodString>;
+      systemPrompt: _$zod.ZodOptional<_$zod.ZodUnion<readonly [_$zod.ZodString, _$zod.ZodObject<{
+        mode: _$zod.ZodLiteral<"append">;
+        content: _$zod.ZodString;
+      }, _$zod_v4_core0.$strip>]>>;
+      allowedTools: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodString>>;
+      disallowedTools: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodString>>;
+      env: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodString>>;
+      mcpSessionContext: _$zod.ZodOptional<_$zod.ZodObject<{
+        sessionId: _$zod.ZodString;
+        directTools: _$zod.ZodArray<_$zod.ZodObject<{
+          fullName: _$zod.ZodString;
+          originalName: _$zod.ZodString;
+          serverName: _$zod.ZodString;
+          description: _$zod.ZodOptional<_$zod.ZodString>;
+          inputSchema: _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>;
+          exposureMode: _$zod.ZodEnum<{
+            hidden: "hidden";
+            discovery: "discovery";
+            direct: "direct";
+          }>;
+          enabled: _$zod.ZodBoolean;
+          enabledBy: _$zod.ZodOptional<_$zod.ZodEnum<{
+            discovery: "discovery";
+            toolset: "toolset";
+          }>>;
+          enabledAt: _$zod.ZodOptional<_$zod.ZodNumber>;
+          exposed: _$zod.ZodBoolean;
+        }, _$zod_v4_core0.$strip>>;
+        servers: _$zod.ZodArray<_$zod.ZodObject<{
+          name: _$zod.ZodString;
+          transport: _$zod.ZodDiscriminatedUnion<[_$zod.ZodObject<{
+            type: _$zod.ZodLiteral<"stdio">;
+            command: _$zod.ZodString;
+            args: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodString>>;
+            env: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodString>>;
+            alwaysLoad: _$zod.ZodOptional<_$zod.ZodBoolean>;
+          }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
+            url: _$zod.ZodString;
+            headers: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodString>>;
+            tools: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodObject<{
+              name: _$zod.ZodString;
+              permission_policy: _$zod.ZodEnum<{
+                always_allow: "always_allow";
+                always_ask: "always_ask";
+                always_deny: "always_deny";
+              }>;
+            }, _$zod_v4_core0.$strip>>>;
+            alwaysLoad: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            type: _$zod.ZodLiteral<"sse">;
+          }, _$zod_v4_core0.$strip>, _$zod.ZodObject<{
+            url: _$zod.ZodString;
+            headers: _$zod.ZodOptional<_$zod.ZodRecord<_$zod.ZodString, _$zod.ZodString>>;
+            tools: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodObject<{
+              name: _$zod.ZodString;
+              permission_policy: _$zod.ZodEnum<{
+                always_allow: "always_allow";
+                always_ask: "always_ask";
+                always_deny: "always_deny";
+              }>;
+            }, _$zod_v4_core0.$strip>>>;
+            alwaysLoad: _$zod.ZodOptional<_$zod.ZodBoolean>;
+            type: _$zod.ZodLiteral<"http">;
+          }, _$zod_v4_core0.$strip>], "type">;
+          exposureMode: _$zod.ZodEnum<{
+            discovery: "discovery";
+            direct: "direct";
+          }>;
+        }, _$zod_v4_core0.$strip>>;
+        discoverableTools: _$zod.ZodArray<_$zod.ZodObject<{
+          fullName: _$zod.ZodString;
+          originalName: _$zod.ZodString;
+          serverName: _$zod.ZodString;
+          description: _$zod.ZodOptional<_$zod.ZodString>;
+          inputSchema: _$zod.ZodRecord<_$zod.ZodString, _$zod.ZodUnknown>;
+          exposureMode: _$zod.ZodEnum<{
+            hidden: "hidden";
+            discovery: "discovery";
+            direct: "direct";
+          }>;
+          enabled: _$zod.ZodBoolean;
+          enabledBy: _$zod.ZodOptional<_$zod.ZodEnum<{
+            discovery: "discovery";
+            toolset: "toolset";
+          }>>;
+          enabledAt: _$zod.ZodOptional<_$zod.ZodNumber>;
+          exposed: _$zod.ZodBoolean;
+        }, _$zod_v4_core0.$strip>>;
+      }, _$zod_v4_core0.$strip>>;
+      allowedDirectories: _$zod.ZodOptional<_$zod.ZodArray<_$zod.ZodString>>;
+      adapterConfig: _$zod.ZodOptional<_$zod.ZodType<Record<string, unknown>, Record<string, unknown>, _$zod_v4_core0.$ZodTypeInternals<Record<string, unknown>, Record<string, unknown>>>>;
+      adapterId: _$zod.ZodOptional<_$zod.ZodString>;
+      kind: _$zod.ZodLiteral<"adapter">;
+      adapterName: _$zod.ZodString;
+      providerConfigId: _$zod.ZodString;
+      model: _$zod.ZodString;
+    }, _$zod_v4_core0.$loose>;
+  };
+}>, "canonicalModel">;
+//#endregion
+export { QualifiedModelRef as C, VirtualModelRef as D, ResolvableCanonicalModelSchema as E, VirtualModelRefSchema as O, ParsedCanonicalModelSchema as S, ResolvableCanonicalModel as T, CanonicalModelParseErrorCodeSchema as _, CanonicalModelSchemas as a, CanonicalModelParseResultSchema as b, SEGMENT_RE as c, parseCanonicalModel as d, BareModelRef as f, CanonicalModelParseErrorCode as g, CanonicalModelParseError as h, CanonicalModelResolvedSelectionSchema as i, VIRTUAL_NAME_RE as l, CANONICAL_MODEL_PARSE_ERROR_CODES as m, CanonicalModelSubjects as n, CanonicalModelSelection as o, BareModelRefSchema as p, CanonicalModelResolvedSelection as r, CanonicalModelSelectionSchema as s, CanonicalModelNamespace as t, isCanonicalModelParseError as u, CanonicalModelParseErrorSchema as v, QualifiedModelRefSchema as w, ParsedCanonicalModel as x, CanonicalModelParseResult as y };