@makaio/framework 1.0.0-dev-1783477169057 → 1.0.0-dev-1783687982716

package/dist/.makaio-build.json

@@ -1,5 +1,5 @@
 {
   "version": 1,
-  "fingerprint": "bfc16b81a5b4ac4bf666afadba3055a595d4df33aa47323440b2cff4ab044324",
-  "builtAt": "2026-07-08T02:20:31.739Z"
+  "fingerprint": "cc562082771216d1033754cad421fb6f6be67d433426190f6c6999be66391362",
+  "builtAt": "2026-07-10T12:54:10.370Z"
 }

package/dist/adapter-CA8rPIUz.mjs

@@ -0,0 +1 @@
+import{_ as e,b as t,c as n,d as r,f as i,g as a,h as o,ht as s,l as c,m as l,o as u,p as d,s as f,t as p,u as m,v as h,y as g}from"./schemas-CVo8qAK-.mjs";import"./compression-C5JAWdgZ.mjs";import"./provider-context-CqMgPOWF.mjs";import"./contracts/adapter/schemas/session-lineage.mjs";import{createBusNamespace as _}from"@makaio/framework/core";const v={getCapabilities:s,startAgent:t,infer:g,listAgents:h,getAgent:e,stopAgent:a,rehydrateAgent:o,getConfigSchema:l,"agent.created":d,"session.created":i,"session.discovered":p,"session.usage":r,"session.closed":m,log:c,error:n,initialized:f,quota:u},y=_(`adapter`,v),b=y.subjects;export{b as n,v as r,y as t};

package/dist/adapters/config/index.d.mts

@@ -1,4 +1,4 @@
-import { g as BaseAgentConnectorConfig } from "../../types-D7W0ntGr.mjs";
+import { _ as BaseAgentConnectorConfig } from "../../types-1a2D10yb.mjs";
 import { z } from "zod";
 import { IMakaioBus, MakaioBusContext } from "@makaio/framework/bus";
 import { AIModelSchema, ProtocolId, ProviderContext } from "@makaio/framework/contracts";

package/dist/adapters/index.d.mts

@@ -1,10 +1,10 @@
-import { A as MessageHandle, B as ReasoningLevelMap, C as SendMessageRequestPayload, D as IAdapterConfigFactory, E as ConfigFactoryInput, F as MessageState, H as LedgerSessionContext, I as ProcessingState, L as SendMessageOptions, M as NormalizedMessageInput, N as normalizeMessageInput, O as AIAgentConnector, P as MessageResult, R as AIModel, S as NormalizedCallUsage, T as StartAgentOptions, U as SessionToolLedger, V as ISessionToolLedger, W as ToolLedgerEntry, _ as ConnectorSendMessageOptions, a as AgentCwdChangeRequestPayload, b as ExecutionContext, c as AgentInterruptRequestPayload, d as AgentMcpServersSetResponsePayload, f as AgentModelChangeRequestPayload, g as BaseAgentConnectorConfig, h as AgentStartResult, i as AgentCredentialChangeResponsePayload, j as markCompletedWithFinalResult, k as MessageDeliveryMode, l as AgentInterruptResponsePayload, m as AgentSendMessageOptions, n as AgentContext, o as AgentCwdChangeResponsePayload, p as AgentModelChangeResponsePayload, r as AgentCredentialChangeRequestPayload, s as AgentIdentity, t as AIAgentConfig, u as AgentMcpServersSetRequestPayload, v as ConnectorStartOptions, w as SendMessageResponsePayload, x as GetCapabilitiesResponsePayload, y as ContextWindowInput, z as AIReasoningLevel } from "../types-D7W0ntGr.mjs";
+import { A as MessageDeliveryMode, B as AIReasoningLevel, C as NormalizedCallUsage, D as ConfigFactoryInput, E as StartAgentOptions, F as MessageResult, G as ToolLedgerEntry, H as ISessionToolLedger, I as MessageState, L as ProcessingState, M as markCompletedWithFinalResult, N as NormalizedMessageInput, O as IAdapterConfigFactory, P as normalizeMessageInput, R as SendMessageOptions, S as GetCapabilitiesResponsePayload, T as SendMessageResponsePayload, U as LedgerSessionContext, V as ReasoningLevelMap, W as SessionToolLedger, _ as BaseAgentConnectorConfig, a as AgentCredentialChangeResponsePayload, b as ContextWindowInput, c as AgentIdentity, d as AgentMcpServersSetRequestPayload, f as AgentMcpServersSetResponsePayload, g as AgentStartResult, h as AgentSendMessageOptions, i as AgentCredentialChangeRequestPayload, j as MessageHandle, k as AIAgentConnector, l as AgentInterruptRequestPayload, m as AgentModelChangeResponsePayload, n as AgentConnectorConfigOverrides, o as AgentCwdChangeRequestPayload, p as AgentModelChangeRequestPayload, r as AgentContext, s as AgentCwdChangeResponsePayload, t as AIAgentConfig, u as AgentInterruptResponsePayload, v as ConnectorSendMessageOptions, w as SendMessageRequestPayload, x as ExecutionContext, y as ConnectorStartOptions, z as AIModel } from "../types-1a2D10yb.mjs";
 import { S as toImportSegment, _ as LogImporter, a as CompactionMetadata, b as ProcessLogFileResult, c as ExternalToolIdentifiers, d as ImportMetadata, f as ImportSegment, g as LogImportTestConfig, h as LogImportSessionContext, l as ExternalToolMeta, m as ImportSegmentTurn, n as LogOrchestratorConfig, o as DiscoveryMetadata, p as ImportSegmentLineage, r as ParseFileResult, s as ExternalToolIdentifier, u as ImportCursorPosition, v as LogImporterConfig, x as StorageMessagePayload, y as NormalizedEvent } from "../base-orchestrator-J1WKAUkF.mjs";
 import { z } from "zod";
 import * as _$_makaio_core0 from "@makaio/framework/core";
 import { CreateBusNamespaceOptions, ExtractSubjectPayload, FilterablePayloadIntersection, HandlerForSubjectDefinition, RegistrableBusNamespaceDefinition, RequestContext, SchemaRecord, ScopedSubjectDefinition, SubjectDefinition, SubjectRecordFromSchemaRecord } from "@makaio/framework/core";
 import { BusNamespace, IMakaioBus, OnOptions, ScopedBus, ScopedBusFor } from "@makaio/framework/bus";
-import { AIReasoningLevel as AIReasoningLevel$1, AdapterClientRef, AdapterDefinitionContract, AdapterProviderDefinitionContract, AdapterSubjects, AgentSchemas, AgentStarted, AgentSubjects, AgentToolApproveRequest, AgentToolApproveResponse, BlockData, HarnessDefinition, HarnessSubjects, JsonValue, McpResolvedServer, McpRuntimeSessionContext, McpSessionContext, McpToolState, Message, MessageInput, NativeForkDirective, ProviderContext, ProviderDefinitionInput, ReasoningLevelMap as ReasoningLevelMap$1, ResponseSchemaDescriptor, SendMessageRequest, SendMessageResponse, SessionContext, SessionMessageBlock, StartAgentRequest, StartAgentResponse, StartMode, StepType, SystemPrompt, ToolListItem } from "@makaio/framework/contracts";
+import { AIReasoningLevel as AIReasoningLevel$1, AdapterClientRef, AdapterDefinitionContract, AdapterProviderDefinitionContract, AdapterSubjects, AgentSchemas, AgentStarted, AgentSubjects, AgentToolApproveRequest, AgentToolApproveResponse, BlockData, HarnessDefinition, HarnessSubjects, JsonValue, McpResolvedServer, McpRuntimeSessionContext, McpSessionContext, McpToolState, Message, MessageInput, NativeForkDirective, ProviderContext, ProviderDefinitionInput, ReasoningLevelMap as ReasoningLevelMap$1, RequestCorrelationContext, ResponseSchemaDescriptor, SendMessageRequest, SendMessageResponse, SessionContext, SessionMessageBlock, StartAgentRequest, StartAgentResponse, StartMode, StepType, SystemPrompt, ToolListItem } from "@makaio/framework/contracts";
 import * as _$_makaio_storage_core0 from "@makaio/framework/storage";
 import * as _$_makaio_ai_adapters_core0 from "@makaio/framework/adapters";
 import * as _$type_fest0 from "type-fest";
@@ -1702,12 +1702,106 @@ declare class ToolCallTracker {
   clear(): void;
 }
 //#endregion
-//#region adapters/core/src/agent/ai-agent.d.ts
-interface ToolOutputResolution {
+//#region adapters/core/src/agent/agent-event-bridge.d.ts
+/**
+ * Dependencies for AgentEventBridge.
+ */
+interface AgentEventBridgeConfig {
+  /** Emit usage payload (agent context gets added by AIAgent). */
+  emitUsage: (payload: Omit<ExtractSubjectPayload<typeof AgentSubjects.usage>, keyof AgentContext>) => Promise<void>;
+  /** Emit context window status payload. */
+  emitContextWindowUpdated: (payload: Omit<ExtractSubjectPayload<typeof AgentSubjects.contextWindow.updated>, keyof AgentContext>) => Promise<void>;
+  /** Emit tool.use payload. */
+  emitToolUse: (payload: Omit<ExtractSubjectPayload<typeof AgentSubjects.tool.use>, keyof AgentContext>) => Promise<void>;
+  /** Emit tool.output payload. */
+  emitToolOutput: (payload: Omit<ExtractSubjectPayload<typeof AgentSubjects.tool.output>, keyof AgentContext>) => Promise<void>;
+  /** Emit adapter log payload. */
+  emitAdapterLog: (payload: Omit<ExtractSubjectPayload<typeof AdapterSubjects.log>, 'adapterId' | 'adapterName'>) => Promise<void>;
+  /** Emit step.started payload. */
+  emitStepStarted: (payload: Omit<ExtractSubjectPayload<typeof AgentSubjects.step.started>, keyof AgentContext>) => Promise<void>;
+  /** Emit step.finished payload. */
+  emitStepFinished: (payload: Omit<ExtractSubjectPayload<typeof AgentSubjects.step.finished>, keyof AgentContext>) => Promise<void>;
+  /** Correlation tracker for tool.use -\> tool.output. */
+  toolCallTracker: ToolCallTracker;
+  /** Current content block index getter. */
+  getBlockIndex: () => number;
+  /** Increment block index after step completion. */
+  incrementBlockIndex: () => void;
+  /** Resolve model name for usage events. */
+  getUsageModel: () => string | undefined;
+}
+/**
+ * Resolution metadata returned when emitting tool output.
+ */
+interface ToolOutputResult {
   toolCallId: string;
   toolName: string;
   args?: Record<string, unknown>;
 }
+/**
+ * Event-focused helper for AIAgent.
+ *
+ * Keeps event payload formatting, correlation warnings, and block-indexed
+ * step emissions out of the base class while preserving existing behavior.
+ */
+declare class AgentEventBridge {
+  private readonly emitUsagePayload;
+  private readonly emitContextWindowUpdatedPayload;
+  private readonly emitToolUsePayload;
+  private readonly emitToolOutputPayload;
+  private readonly emitAdapterLogPayload;
+  private readonly emitStepStartedPayload;
+  private readonly emitStepFinishedPayload;
+  private readonly toolCallTracker;
+  private readonly getBlockIndex;
+  private readonly incrementBlockIndex;
+  private readonly getUsageModel;
+  /**
+   * Create an event bridge with emission and correlation dependencies.
+   * @param config - Event bridge dependencies (emitters, tracker, and block-index accessors)
+   */
+  constructor(config: AgentEventBridgeConfig);
+  /**
+   * Emit usage event to global bus.
+   * @param normalized - Provider-normalized usage metrics
+   */
+  trackUsage(normalized: NormalizedCallUsage): Promise<void>;
+  /**
+   * Emit context window health signal.
+   * @param input - Raw usage and capacity metrics
+   */
+  emitContextWindowUpdate(input: ContextWindowInput): Promise<void>;
+  /**
+   * Emit tool.use event with correlation tracking.
+   * @param toolName - Tool identifier
+   * @param args - Tool arguments
+   * @param nativeId - Provider-native call ID
+   * @returns Correlation ID for the call
+   */
+  emitToolUse(toolName: string, args?: Record<string, unknown>, nativeId?: string): Promise<string>;
+  /**
+   * Emit tool.output event with best-effort correlation resolution.
+   * @param output - Tool output text
+   * @param hints - Correlation hints from adapter events
+   * @returns Resolved toolCallId, toolName (falls back to 'unknown'), and args from the matched tool.use call
+   */
+  emitToolOutput(output: string, hints: ResolveHints): Promise<ToolOutputResult>;
+  /**
+   * Emit step.started for the current block index.
+   * @param stepType - Block step type
+   * @param blockData - Optional step metadata
+   * @param content - Optional immediate block content
+   */
+  emitStepStarted(stepType: StepType, blockData?: BlockData, content?: SessionMessageBlock): Promise<void>;
+  /**
+   * Emit step.finished and advance block index.
+   * @param stepType - Completed step type
+   * @param content - Final block content
+   */
+  emitStepFinished(stepType: StepType, content: SessionMessageBlock): Promise<void>;
+}
+//#endregion
+//#region adapters/core/src/agent/ai-agent.d.ts
 /**
  * Abstract base class for AI agents.
  *
@@ -1728,7 +1822,7 @@ declare abstract class AIAgent<TBus extends ScopedBus<string> = ScopedBus<string
   private initialized;
   /** Runtime system prompt captured from start/initialize, preserved across connector swaps. */
   private runtimeSystemPrompt?;
-  /** Tracks message lifecycle and emits turn events. */
+  /** Tracks message lifecycle and emits turn events (emission is lazy — safe as field initializer). */
   protected readonly lifecycleTracker: MessageLifecycleTracker;
   /** Tracks tool.use → tool.output correlation across adapters. */
   protected readonly toolCallTracker: ToolCallTracker;
@@ -1770,13 +1864,8 @@ declare abstract class AIAgent<TBus extends ScopedBus<string> = ScopedBus<string
    * @param config - Agent configuration
    */
   constructor(config: AIAgentConfig<TBus, TConnector>);
+  private getAgentContextBase;
   private getEventMetadataDefaults;
-  private createLifecycleEmitter;
-  /**
-   * Create the structured-output manager for this agent.
-   * @returns Configured manager instance
-   */
-  private createStructuredOutputManager;
   /** @returns Unique agent identifier */
   get agentId(): string;
   /** @returns Adapter instance identifier */
@@ -1892,7 +1981,7 @@ declare abstract class AIAgent<TBus extends ScopedBus<string> = ScopedBus<string
    * @param hints - Hints for correlation (nativeId and/or toolName)
    * @returns Resolved toolCallId, toolName (falls back to 'unknown'), and args from the matched tool.use call
    */
-  protected emitToolOutput(output: string, hints: ResolveHints): Promise<ToolOutputResolution>;
+  protected emitToolOutput(output: string, hints: ResolveHints): Promise<ToolOutputResult>;
   /**
    * Emit step.started event with automatic block index management.
    * Call this when a content block begins processing.
@@ -1963,29 +2052,12 @@ declare abstract class AIAgent<TBus extends ScopedBus<string> = ScopedBus<string
    * @param configOverrides - Optional config overrides (e.g., new cwd, model)
    * @throws Error if connector is currently processing a turn
    */
-  swapConnector(configOverrides?: Partial<{
-    cwd: string;
-    model: string;
-    providerContext: ProviderContext;
-    adapterSessionId: string;
-    resumeAdapterSessionId: string;
-    mcpSessionContext: McpRuntimeSessionContext | McpSessionContext | LedgerSessionContext;
-  }>): Promise<void>;
-  /**
-   * Resolve the supported reasoning levels for a given model name.
-   *
-   * Centralised lookup into `availableModels` so callers do not repeat the
-   * find/optional-chain pattern inline.
-   * @param model - Model name to look up, or `undefined` to return `undefined`
-   * @returns The `supportedReasoningLevels` map for the model, or `undefined`
-   */
-  private getSupportedReasoningLevels;
+  swapConnector(configOverrides?: AgentConnectorConfigOverrides): Promise<void>;
   /**
    * Build config factory input from agent config with optional overrides.
    *
-   * Explicitly maps AIAgentConfig fields to ConfigFactoryInput — avoids
-   * accidentally forwarding adapter-only fields (capabilities, nativeTools, etc.)
-   * into the factory.
+   * Delegates to {@link buildConfigFactoryInput} with live connector-derived
+   * values (reasoning effort) and the agent's error sink.
    * @param overrides - Optional field overrides (e.g., cwd, model, adapterSessionId)
    * @returns ConfigFactoryInput ready for config factory
    */
@@ -1997,26 +2069,6 @@ declare abstract class AIAgent<TBus extends ScopedBus<string> = ScopedBus<string
    * @returns Callback function for connector config
    */
   private createOnMessageSent;
-  /**
-   * Handle agent.cwd.change request — prefers native in-place change, falls back to connector swap.
-   * @param ctx - Request context with newCwd payload
-   */
-  private handleCwdChange;
-  /**
-   * Handle agent.model.change request — prefers native in-place change, falls back to connector swap.
-   * @param ctx - Request context with newModel payload
-   */
-  private handleModelChange;
-  /**
-   * Handle agent.mcp.servers.set request — rebuilds immediately when idle or stages for the next turn.
-   * @param ctx - Request context with replacement MCP session context
-   */
-  private handleMcpServersSet;
-  /**
-   * Handle agent.credential.change request — defers when a turn is active, otherwise swaps connector.
-   * @param ctx - Request context with credential change payload
-   */
-  private handleCredentialChanged;
   /**
    * Wire adapter-specific connector events.
    * Called automatically during init() and connector swap.
@@ -2204,105 +2256,6 @@ interface AIAdapterContext<Scope extends ScopedBus<string>> {
   globalBus: IMakaioBus;
 }
 //#endregion
-//#region adapters/core/src/agent/agent-event-bridge.d.ts
-/**
- * Dependencies for AgentEventBridge.
- */
-interface AgentEventBridgeConfig {
-  /** Emit usage payload (agent context gets added by AIAgent). */
-  emitUsage: (payload: Omit<ExtractSubjectPayload<typeof AgentSubjects.usage>, keyof AgentContext>) => Promise<void>;
-  /** Emit context window status payload. */
-  emitContextWindowUpdated: (payload: Omit<ExtractSubjectPayload<typeof AgentSubjects.contextWindow.updated>, keyof AgentContext>) => Promise<void>;
-  /** Emit tool.use payload. */
-  emitToolUse: (payload: Omit<ExtractSubjectPayload<typeof AgentSubjects.tool.use>, keyof AgentContext>) => Promise<void>;
-  /** Emit tool.output payload. */
-  emitToolOutput: (payload: Omit<ExtractSubjectPayload<typeof AgentSubjects.tool.output>, keyof AgentContext>) => Promise<void>;
-  /** Emit adapter log payload. */
-  emitAdapterLog: (payload: Omit<ExtractSubjectPayload<typeof AdapterSubjects.log>, 'adapterId' | 'adapterName'>) => Promise<void>;
-  /** Emit step.started payload. */
-  emitStepStarted: (payload: Omit<ExtractSubjectPayload<typeof AgentSubjects.step.started>, keyof AgentContext>) => Promise<void>;
-  /** Emit step.finished payload. */
-  emitStepFinished: (payload: Omit<ExtractSubjectPayload<typeof AgentSubjects.step.finished>, keyof AgentContext>) => Promise<void>;
-  /** Correlation tracker for tool.use -\> tool.output. */
-  toolCallTracker: ToolCallTracker;
-  /** Current content block index getter. */
-  getBlockIndex: () => number;
-  /** Increment block index after step completion. */
-  incrementBlockIndex: () => void;
-  /** Resolve model name for usage events. */
-  getUsageModel: () => string | undefined;
-}
-/**
- * Resolution metadata returned when emitting tool output.
- */
-interface ToolOutputResult {
-  toolCallId: string;
-  toolName: string;
-  args?: Record<string, unknown>;
-}
-/**
- * Event-focused helper for AIAgent.
- *
- * Keeps event payload formatting, correlation warnings, and block-indexed
- * step emissions out of the base class while preserving existing behavior.
- */
-declare class AgentEventBridge {
-  private readonly emitUsagePayload;
-  private readonly emitContextWindowUpdatedPayload;
-  private readonly emitToolUsePayload;
-  private readonly emitToolOutputPayload;
-  private readonly emitAdapterLogPayload;
-  private readonly emitStepStartedPayload;
-  private readonly emitStepFinishedPayload;
-  private readonly toolCallTracker;
-  private readonly getBlockIndex;
-  private readonly incrementBlockIndex;
-  private readonly getUsageModel;
-  /**
-   * Create an event bridge with emission and correlation dependencies.
-   * @param config - Event bridge dependencies (emitters, tracker, and block-index accessors)
-   */
-  constructor(config: AgentEventBridgeConfig);
-  /**
-   * Emit usage event to global bus.
-   * @param normalized - Provider-normalized usage metrics
-   */
-  trackUsage(normalized: NormalizedCallUsage): Promise<void>;
-  /**
-   * Emit context window health signal.
-   * @param input - Raw usage and capacity metrics
-   */
-  emitContextWindowUpdate(input: ContextWindowInput): Promise<void>;
-  /**
-   * Emit tool.use event with correlation tracking.
-   * @param toolName - Tool identifier
-   * @param args - Tool arguments
-   * @param nativeId - Provider-native call ID
-   * @returns Correlation ID for the call
-   */
-  emitToolUse(toolName: string, args?: Record<string, unknown>, nativeId?: string): Promise<string>;
-  /**
-   * Emit tool.output event with best-effort correlation resolution.
-   * @param output - Tool output text
-   * @param hints - Correlation hints from adapter events
-   * @returns Resolved toolCallId, toolName (falls back to 'unknown'), and args from the matched tool.use call
-   */
-  emitToolOutput(output: string, hints: ResolveHints): Promise<ToolOutputResult>;
-  /**
-   * Emit step.started for the current block index.
-   * @param stepType - Block step type
-   * @param blockData - Optional step metadata
-   * @param content - Optional immediate block content
-   */
-  emitStepStarted(stepType: StepType, blockData?: BlockData, content?: SessionMessageBlock): Promise<void>;
-  /**
-   * Emit step.finished and advance block index.
-   * @param stepType - Completed step type
-   * @param content - Final block content
-   */
-  emitStepFinished(stepType: StepType, content: SessionMessageBlock): Promise<void>;
-}
-//#endregion
 //#region adapters/core/src/agent/agent-turn-executor.d.ts
 /**
  * Runtime dependencies for AgentTurnExecutor.
@@ -2576,14 +2529,7 @@ interface AgentConnectorLifecycleManagerConfig<TBus extends ScopedBus<string>, T
   /** Stable agent identifier (used for diagnostics). */
   agentId: string;
   /** Create config input for connector/config factories. */
-  buildConfigInput: (overrides?: Partial<{
-    cwd: string;
-    model: string;
-    providerContext: ProviderContext;
-    adapterSessionId: string;
-    resumeAdapterSessionId: string;
-    mcpSessionContext: McpRuntimeSessionContext | McpSessionContext | LedgerSessionContext;
-  }>) => ConfigFactoryInput<TBus>;
+  buildConfigInput: (overrides?: AgentConnectorConfigOverrides) => ConfigFactoryInput<TBus>;
   /** Adapter config factory from AIAgent config. */
   configFactory: (input: ConfigFactoryInput<TBus>) => Promise<BaseAgentConnectorConfig<TBus> & {
     adapterId: string;
@@ -2637,14 +2583,7 @@ declare class AgentConnectorLifecycleManager<TBus extends ScopedBus<string>, TCo
    * Uses create-before-close pattern with rollback to preserve availability.
    * @param configOverrides - Optional runtime override fields
    */
-  swapConnector(configOverrides?: Partial<{
-    cwd: string;
-    model: string;
-    providerContext: ProviderContext;
-    adapterSessionId: string;
-    resumeAdapterSessionId: string;
-    mcpSessionContext: McpRuntimeSessionContext | McpSessionContext | LedgerSessionContext;
-  }>): Promise<void>;
+  swapConnector(configOverrides?: AgentConnectorConfigOverrides): Promise<void>;
 }
 //#endregion
 //#region adapters/core/src/agent/agent-lifecycle-emitter.d.ts
@@ -3051,6 +2990,41 @@ declare function extractMcpCallTarget(args: Record<string, unknown>): string | u
  */
 declare function isMcpCallTool(toolName: string): boolean;
 //#endregion
+//#region adapters/core/src/agent/request-correlation.d.ts
+/** Exact Factory Gateway headers accepted by its content-free usage boundary. */
+declare const FactoryUsageCorrelationHeaders: {
+  readonly sessionId: "x-factory-session-id";
+  readonly turnId: "x-factory-turn-id";
+  readonly messageId: "x-factory-message-id";
+  readonly llmCallId: "x-factory-llm-call-id";
+  readonly executionId: "x-factory-execution-id";
+  readonly frameId: "x-factory-frame-id";
+};
+type ProviderRequestCorrelation = RequestCorrelationContext & {
+  llmCallId: string;
+};
+/**
+ * Bind caller correlation to identifiers owned by the active runtime request.
+ * Runtime values always win, preventing stale or spoofed session/message IDs.
+ * @param context - Optional orchestrator-supplied workflow correlation
+ * @param runtime - IDs known by the connector for this concrete API request
+ * @returns Fully bound correlation including one LLM-call ID
+ */
+declare function bindProviderRequestCorrelation(context: RequestCorrelationContext | undefined, runtime: {
+  sessionId?: string;
+  messageId: string;
+  llmCallId: string;
+}): ProviderRequestCorrelation;
+/**
+ * Project a validated correlation context to the Factory Gateway allowlist.
+ *
+ * No arbitrary metadata or headers can cross this boundary. Callers must also
+ * explicitly opt into the `factory-v1` transport mode before using the result.
+ * @param correlation - Content-free runtime and workflow identifiers
+ * @returns Header record accepted by the Factory Gateway usage boundary
+ */
+declare function buildFactoryUsageCorrelationHeaders(correlation: ProviderRequestCorrelation): Record<string, string>;
+//#endregion
 //#region adapters/core/src/adapter/ai-adapter.d.ts
 /**
  * Base class for AI adapters.
@@ -4399,4 +4373,4 @@ declare const ToolCompletedEventSchema: z.ZodObject<{
 type ToolStartedEvent = z.infer<typeof ToolStartedEventSchema>;
 type ToolCompletedEvent = z.infer<typeof ToolCompletedEventSchema>;
 //#endregion
-export { AIAdapter, type AIAdapterCapabilities, type AIAdapterCapability, type AIAdapterCapabilityRegistry, type AIAdapterConfig, type AIAdapterConstructorConfig, type AIAdapterContext, type AIAdapterDefinition, type AIAdapterInitOptions, type AIAdapterPromptFailureResult, type AIAdapterPromptOptions, type AIAdapterPromptResult, type AIAdapterPromptSuccessResult, AIAgent, type AIAgentConfig, AIAgentConnector, type AIModel, type AIReasoningLevel, type AdapterNamespace, type AdapterProviderDefinition, type AgentBusHandlerRegistrarConfig, type AgentCompleteEvent, AgentCompleteEventSchema, AgentConnectorLifecycleManager, type AgentConnectorLifecycleManagerConfig, type AgentContext, AgentEventBridge, type AgentEventBridgeConfig, type AgentIdentity, AgentLifecycleEmitter, type AgentLifecycleEmitterConfig, AgentPayloadEmitter, type AgentPayloadEmitterConfig, type AgentRuntimeCreationResult, AgentRuntimeMutationManager, type AgentRuntimeMutationManagerConfig, type AgentSendMessageOptions, type AgentStartResult, type AgentStartedEvent, AgentStartedEventSchema, AgentTurnExecutor, type AgentTurnExecutorConfig, type AgentUsageTotals, type BaseAgentConnectorConfig, BaseConnectorSession, BaseConnectorTurn, BaseLogImporter, type CompactionMetadata, type ConfigFactoryInput, type ConformanceEnvReader, type ConformanceTestConfig, type ConnectorSendMessageOptions, type ConnectorSessionConfig, type ConnectorStartOptions, type CreateConformanceTestConfigOptions, type CreateTestAgentOptions, type DiscoveryMetadata, type DiscriminatedHandler, type DiscriminatedHandlersConfig, type DiscriminatedHandlersMap, type ErrorEvent, ErrorEventSchema, type ExecutionContext, type ExternalToolIdentifier, type ExternalToolIdentifiers, type ExternalToolMeta, type FromGlobalToolApprovalFn, type GeneratedCapabilityProperties, type HarnessRequester, type IAdapterConfigFactory, type ISessionToolLedger, type ImportCursorPosition, ImportCursorPositionSchema, ImportCursorStorageNamespace, ImportCursorStorageSubjects, type ImportMetadata, type ImportSegment, type ImportSegmentLineage, type ImportSegmentTurn, type LedgerSessionContext, type LogImportConfig, type LogImportOrchestrator, type LogImportRegistration, type LogImportSessionContext, type LogImportTestConfig, type LogImporter, type LogImporterConfig, type LogImporterConstructor, type LogOrchestratorConfig, type LogOrchestratorConstructor, MAKAIO_CONFORMANCE_PRIMARY_MODEL_ENV, MAKAIO_CONFORMANCE_PROVIDER_DEFINITIONS_ENV, MAKAIO_CONFORMANCE_PROVIDER_ENV, MAKAIO_CONFORMANCE_SECONDARY_MODEL_ENV, type McpIntegrationStrategy, type McpSessionResources, type McpToolChange, type MergeResult, type MergeScopedToolApprovalOptions, type MessageDeliveryMode, MessageHandle, MessageLifecycleTracker, type MessageResult, type MessageState, type NormalizedCallUsage, type NormalizedEvent, type NormalizedMessageInput, type ParseFileResult, type PauseResult, type PlatformDefaults, ProceduralAgentConnector, type ProceduralConnectorSession, ProceduralConnectorTurn, type ProceduralTurnConfig, type ProceduralTurnState, type ProcessLogFileResult, type ProcessQueueCallbacks, type ProcessingState, type QueueableTurn, type ReasoningLevelMap, type ResolveConformanceTestPresetOptions, type ResolveHints, type ResolvedConformanceTestPreset, type ScopedBusFor, type ScopedToolApprovalRequest, type ScopedToolApprovalResponse, ScopedToolApprovalSchema, type SendMessageOptions, type SendMessageRequest, type SendMessageResponse, type SerializedContextBlock, SessionLifecycle, SessionToolLedger, type ShouldUseNativeResumeFn, type StartAgentOptions, type StartAgentRequest, type StartAgentResponse, type StorageMessagePayload, type SyncDiscriminatedHandler, type SyncDiscriminatedHandlersConfig, type SyncDiscriminatedHandlersMap, type SyncTypedEmitFn, type TestModelRef, type ToGlobalToolApprovalFn, type ToolApprovalContext, ToolCallTracker, type ToolCompletedEvent, ToolCompletedEventSchema, type ToolLedgerEntry, type ToolStartedEvent, ToolStartedEventSchema, type TurnEvent, type TurnState, type TurnSubjects, TurnTracker, type TurnTrackerOptions, type TurnTrackerSerializedState, TurnTrackerSerializedStateSchema, type TypedEmitFn, UserMessageQueue, type ValidCapability, type WireSessionConfig, type WireSessionSubjects, cleanEnvForAdapter, createAdapterNamespace, createTestProviderContext, createToolApprovalHandler, defineDiscriminatedHandlers, defineDiscriminatedHandlersSync, extractMcpCallTarget, formatContextBlockAsText, formatContextBlocksAsText, formatMessageHistoryAsTranscript, isMcpCallTool, isTextLikeMimeType, markCompletedWithFinalResult, mergeScopedToolApproval, normalizeEnvValue, normalizeMessageInput, normalizeMimeType, parseAIAdapterCapabilities, processDiscriminatedItems, processDiscriminatedItemsSync, processQueueMessages, registerAgentBusHandlers, registerMemoryImportCursorStorage, resolveConformanceTestPreset, resolveDisabledNativeTools, resolvePresetCredentials, resolveRequiredSessionId, resolveTestConfig, safeJsonStringify, serializeBlockToText, serializeTurnContext, toImportSegment };
+export { AIAdapter, type AIAdapterCapabilities, type AIAdapterCapability, type AIAdapterCapabilityRegistry, type AIAdapterConfig, type AIAdapterConstructorConfig, type AIAdapterContext, type AIAdapterDefinition, type AIAdapterInitOptions, type AIAdapterPromptFailureResult, type AIAdapterPromptOptions, type AIAdapterPromptResult, type AIAdapterPromptSuccessResult, AIAgent, type AIAgentConfig, AIAgentConnector, type AIModel, type AIReasoningLevel, type AdapterNamespace, type AdapterProviderDefinition, type AgentBusHandlerRegistrarConfig, type AgentCompleteEvent, AgentCompleteEventSchema, AgentConnectorLifecycleManager, type AgentConnectorLifecycleManagerConfig, type AgentContext, AgentEventBridge, type AgentEventBridgeConfig, type AgentIdentity, AgentLifecycleEmitter, type AgentLifecycleEmitterConfig, AgentPayloadEmitter, type AgentPayloadEmitterConfig, type AgentRuntimeCreationResult, AgentRuntimeMutationManager, type AgentRuntimeMutationManagerConfig, type AgentSendMessageOptions, type AgentStartResult, type AgentStartedEvent, AgentStartedEventSchema, AgentTurnExecutor, type AgentTurnExecutorConfig, type AgentUsageTotals, type BaseAgentConnectorConfig, BaseConnectorSession, BaseConnectorTurn, BaseLogImporter, type CompactionMetadata, type ConfigFactoryInput, type ConformanceEnvReader, type ConformanceTestConfig, type ConnectorSendMessageOptions, type ConnectorSessionConfig, type ConnectorStartOptions, type CreateConformanceTestConfigOptions, type CreateTestAgentOptions, type DiscoveryMetadata, type DiscriminatedHandler, type DiscriminatedHandlersConfig, type DiscriminatedHandlersMap, type ErrorEvent, ErrorEventSchema, type ExecutionContext, type ExternalToolIdentifier, type ExternalToolIdentifiers, type ExternalToolMeta, FactoryUsageCorrelationHeaders, type FromGlobalToolApprovalFn, type GeneratedCapabilityProperties, type HarnessRequester, type IAdapterConfigFactory, type ISessionToolLedger, type ImportCursorPosition, ImportCursorPositionSchema, ImportCursorStorageNamespace, ImportCursorStorageSubjects, type ImportMetadata, type ImportSegment, type ImportSegmentLineage, type ImportSegmentTurn, type LedgerSessionContext, type LogImportConfig, type LogImportOrchestrator, type LogImportRegistration, type LogImportSessionContext, type LogImportTestConfig, type LogImporter, type LogImporterConfig, type LogImporterConstructor, type LogOrchestratorConfig, type LogOrchestratorConstructor, MAKAIO_CONFORMANCE_PRIMARY_MODEL_ENV, MAKAIO_CONFORMANCE_PROVIDER_DEFINITIONS_ENV, MAKAIO_CONFORMANCE_PROVIDER_ENV, MAKAIO_CONFORMANCE_SECONDARY_MODEL_ENV, type McpIntegrationStrategy, type McpSessionResources, type McpToolChange, type MergeResult, type MergeScopedToolApprovalOptions, type MessageDeliveryMode, MessageHandle, MessageLifecycleTracker, type MessageResult, type MessageState, type NormalizedCallUsage, type NormalizedEvent, type NormalizedMessageInput, type ParseFileResult, type PauseResult, type PlatformDefaults, ProceduralAgentConnector, type ProceduralConnectorSession, ProceduralConnectorTurn, type ProceduralTurnConfig, type ProceduralTurnState, type ProcessLogFileResult, type ProcessQueueCallbacks, type ProcessingState, type ProviderRequestCorrelation, type QueueableTurn, type ReasoningLevelMap, type ResolveConformanceTestPresetOptions, type ResolveHints, type ResolvedConformanceTestPreset, type ScopedBusFor, type ScopedToolApprovalRequest, type ScopedToolApprovalResponse, ScopedToolApprovalSchema, type SendMessageOptions, type SendMessageRequest, type SendMessageResponse, type SerializedContextBlock, SessionLifecycle, SessionToolLedger, type ShouldUseNativeResumeFn, type StartAgentOptions, type StartAgentRequest, type StartAgentResponse, type StorageMessagePayload, type SyncDiscriminatedHandler, type SyncDiscriminatedHandlersConfig, type SyncDiscriminatedHandlersMap, type SyncTypedEmitFn, type TestModelRef, type ToGlobalToolApprovalFn, type ToolApprovalContext, ToolCallTracker, type ToolCompletedEvent, ToolCompletedEventSchema, type ToolLedgerEntry, type ToolStartedEvent, ToolStartedEventSchema, type TurnEvent, type TurnState, type TurnSubjects, TurnTracker, type TurnTrackerOptions, type TurnTrackerSerializedState, TurnTrackerSerializedStateSchema, type TypedEmitFn, UserMessageQueue, type ValidCapability, type WireSessionConfig, type WireSessionSubjects, bindProviderRequestCorrelation, buildFactoryUsageCorrelationHeaders, cleanEnvForAdapter, createAdapterNamespace, createTestProviderContext, createToolApprovalHandler, defineDiscriminatedHandlers, defineDiscriminatedHandlersSync, extractMcpCallTarget, formatContextBlockAsText, formatContextBlocksAsText, formatMessageHistoryAsTranscript, isMcpCallTool, isTextLikeMimeType, markCompletedWithFinalResult, mergeScopedToolApproval, normalizeEnvValue, normalizeMessageInput, normalizeMimeType, parseAIAdapterCapabilities, processDiscriminatedItems, processDiscriminatedItemsSync, processQueueMessages, registerAgentBusHandlers, registerMemoryImportCursorStorage, resolveConformanceTestPreset, resolveDisabledNativeTools, resolvePresetCredentials, resolveRequiredSessionId, resolveTestConfig, safeJsonStringify, serializeBlockToText, serializeTurnContext, toImportSegment };