@makaio/framework 1.0.0-dev-1783439621927 → 1.0.0-dev-1783615060726

package/dist/.makaio-build.json

@@ -1,5 +1,5 @@
 {
   "version": 1,
-  "fingerprint": "c014afb28c77fc7de84183ee58d4c899fbecc606b5427c1160f53565be4925a9",
-  "builtAt": "2026-07-07T15:54:56.580Z"
+  "fingerprint": "305e2b44c67a83ae6ba9698f20dcf72efb14d497813db06ded1e9cfde150809f",
+  "builtAt": "2026-07-09T16:38:44.937Z"
 }

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

@@ -1,4 +1,4 @@
-import { g as BaseAgentConnectorConfig } from "../../types-N_BOtTqt.mjs";
+import { _ as BaseAgentConnectorConfig } from "../../types-VwMx5_lS.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,5 +1,5 @@
-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-N_BOtTqt.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-ODRyDBzu.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-VwMx5_lS.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";
@@ -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