@makaio/framework 1.0.0-dev-1785347612784 → 1.0.0-dev-1785409369816

package/dist/.makaio-build.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "fingerprint": "1fabeaa71552b725e4b44798ff1f17fada52990db0de1ea78c31a8d018657b5f",
-  "builtAt": "2026-07-29T17:54:54.322Z",
+  "fingerprint": "2a3cce3f4286964d4f4a5fe170e3253ec3ac6bf417f363e82e95db284b563d0f",
+  "builtAt": "2026-07-30T11:04:14.221Z",
   "declarations": true
 }

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

@@ -1413,8 +1413,8 @@ declare const SDKMessageSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodD
         web_search_requests: z.ZodNumber;
       }, z.core.$strip>>>;
       service_tier: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-        priority: "priority";
         batch: "batch";
+        priority: "priority";
         standard: "standard";
       }>>>;
     }, z.core.$strip>;
@@ -2021,8 +2021,8 @@ declare const SDKMessageSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodD
       web_search_requests: z.ZodNumber;
     }, z.core.$strip>>;
     service_tier: z.ZodEnum<{
-      priority: "priority";
       batch: "batch";
+      priority: "priority";
       standard: "standard";
     }>;
   }, z.core.$strip>;
@@ -2069,8 +2069,8 @@ declare const SDKMessageSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodD
       web_search_requests: z.ZodNumber;
     }, z.core.$strip>>;
     service_tier: z.ZodEnum<{
-      priority: "priority";
       batch: "batch";
+      priority: "priority";
       standard: "standard";
     }>;
   }, z.core.$strip>;
@@ -2135,8 +2135,8 @@ declare const SDKMessageSchema: z.ZodUnion<readonly [z.ZodUnion<readonly [z.ZodD
         web_search_requests: z.ZodNumber;
       }, z.core.$strip>>>;
       service_tier: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-        priority: "priority";
         batch: "batch";
+        priority: "priority";
         standard: "standard";
       }>>>;
     }, z.core.$strip>;
@@ -2742,8 +2742,8 @@ declare function createClaudeConnectorNamespace<N extends string>(namespaceName:
           web_search_requests: z.ZodNumber;
         }, z.core.$strip>>>;
         service_tier: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-          priority: "priority";
           batch: "batch";
+          priority: "priority";
           standard: "standard";
         }>>>;
       }, z.core.$strip>;
@@ -3350,8 +3350,8 @@ declare function createClaudeConnectorNamespace<N extends string>(namespaceName:
         web_search_requests: z.ZodNumber;
       }, z.core.$strip>>;
       service_tier: z.ZodEnum<{
-        priority: "priority";
         batch: "batch";
+        priority: "priority";
         standard: "standard";
       }>;
     }, z.core.$strip>;
@@ -3398,8 +3398,8 @@ declare function createClaudeConnectorNamespace<N extends string>(namespaceName:
         web_search_requests: z.ZodNumber;
       }, z.core.$strip>>;
       service_tier: z.ZodEnum<{
-        priority: "priority";
         batch: "batch";
+        priority: "priority";
         standard: "standard";
       }>;
     }, z.core.$strip>;
@@ -3464,8 +3464,8 @@ declare function createClaudeConnectorNamespace<N extends string>(namespaceName:
           web_search_requests: z.ZodNumber;
         }, z.core.$strip>>>;
         service_tier: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-          priority: "priority";
           batch: "batch";
+          priority: "priority";
           standard: "standard";
         }>>>;
       }, z.core.$strip>;
@@ -4033,8 +4033,8 @@ declare function createClaudeConnectorNamespace<N extends string>(namespaceName:
           web_search_requests: z.ZodNumber;
         }, z.core.$strip>>>;
         service_tier: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-          priority: "priority";
           batch: "batch";
+          priority: "priority";
           standard: "standard";
         }>>>;
       }, z.core.$strip>;
@@ -4643,8 +4643,8 @@ declare function createClaudeConnectorNamespace<N extends string>(namespaceName:
         web_search_requests: z.ZodNumber;
       }, z.core.$strip>>;
       service_tier: z.ZodEnum<{
-        priority: "priority";
         batch: "batch";
+        priority: "priority";
         standard: "standard";
       }>;
     }, z.core.$strip>;
@@ -4691,8 +4691,8 @@ declare function createClaudeConnectorNamespace<N extends string>(namespaceName:
         web_search_requests: z.ZodNumber;
       }, z.core.$strip>>;
       service_tier: z.ZodEnum<{
-        priority: "priority";
         batch: "batch";
+        priority: "priority";
         standard: "standard";
       }>;
     }, z.core.$strip>;
@@ -4758,8 +4758,8 @@ declare function createClaudeConnectorNamespace<N extends string>(namespaceName:
           web_search_requests: z.ZodNumber;
         }, z.core.$strip>>>;
         service_tier: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-          priority: "priority";
           batch: "batch";
+          priority: "priority";
           standard: "standard";
         }>>>;
       }, z.core.$strip>;
@@ -5369,8 +5369,8 @@ declare function createClaudeConnectorNamespace<N extends string>(namespaceName:
           web_search_requests: z.ZodNumber;
         }, z.core.$strip>>>;
         service_tier: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-          priority: "priority";
           batch: "batch";
+          priority: "priority";
           standard: "standard";
         }>>>;
       }, z.core.$strip>;
@@ -5977,8 +5977,8 @@ declare function createClaudeConnectorNamespace<N extends string>(namespaceName:
         web_search_requests: z.ZodNumber;
       }, z.core.$strip>>;
       service_tier: z.ZodEnum<{
-        priority: "priority";
         batch: "batch";
+        priority: "priority";
         standard: "standard";
       }>;
     }, z.core.$strip>;
@@ -6025,8 +6025,8 @@ declare function createClaudeConnectorNamespace<N extends string>(namespaceName:
         web_search_requests: z.ZodNumber;
       }, z.core.$strip>>;
       service_tier: z.ZodEnum<{
-        priority: "priority";
         batch: "batch";
+        priority: "priority";
         standard: "standard";
       }>;
     }, z.core.$strip>;
@@ -6091,8 +6091,8 @@ declare function createClaudeConnectorNamespace<N extends string>(namespaceName:
           web_search_requests: z.ZodNumber;
         }, z.core.$strip>>>;
         service_tier: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-          priority: "priority";
           batch: "batch";
+          priority: "priority";
           standard: "standard";
         }>>>;
       }, z.core.$strip>;
@@ -6660,8 +6660,8 @@ declare function createClaudeConnectorNamespace<N extends string>(namespaceName:
           web_search_requests: z.ZodNumber;
         }, z.core.$strip>>>;
         service_tier: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-          priority: "priority";
           batch: "batch";
+          priority: "priority";
           standard: "standard";
         }>>>;
       }, z.core.$strip>;
@@ -7270,8 +7270,8 @@ declare function createClaudeConnectorNamespace<N extends string>(namespaceName:
         web_search_requests: z.ZodNumber;
       }, z.core.$strip>>;
       service_tier: z.ZodEnum<{
-        priority: "priority";
         batch: "batch";
+        priority: "priority";
         standard: "standard";
       }>;
     }, z.core.$strip>;
@@ -7318,8 +7318,8 @@ declare function createClaudeConnectorNamespace<N extends string>(namespaceName:
         web_search_requests: z.ZodNumber;
       }, z.core.$strip>>;
       service_tier: z.ZodEnum<{
-        priority: "priority";
         batch: "batch";
+        priority: "priority";
         standard: "standard";
       }>;
     }, z.core.$strip>;
@@ -7385,8 +7385,8 @@ declare function createClaudeConnectorNamespace<N extends string>(namespaceName:
           web_search_requests: z.ZodNumber;
         }, z.core.$strip>>>;
         service_tier: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-          priority: "priority";
           batch: "batch";
+          priority: "priority";
           standard: "standard";
         }>>>;
       }, z.core.$strip>;

package/dist/adapters/index.d.mts

@@ -2616,6 +2616,18 @@ interface AgentUsageTotals {
   totalOutputTokens: number;
   totalCalls: number;
 }
+/**
+ * In-process handle for an active agent and its registry-owned session metadata.
+ * @typeParam TAgent - Live agent implementation exposed to local callers
+ */
+interface ActiveAgentHandle<TAgent = AIAgent> {
+  /** Live agent instance with its prototype and runtime state intact. */
+  readonly agent: TAgent;
+  /** Makaio session ID associated with the registry entry. */
+  readonly sessionId: string;
+  /** Provider-specific session ID, unavailable until the provider confirms it. */
+  readonly adapterSessionId: string | undefined;
+}
 /** Result from creating an agent runtime. */
 interface AgentRuntimeCreationResult {
   cleanup: () => void;
@@ -3298,14 +3310,11 @@ declare abstract class AIAdapter<TBus extends ScopedBus<string> = ScopedBus<stri
   /** Hook for subclass cleanup. Override to perform async teardown (close connections, etc.). */
   protected onClose(): Promise<void>;
   /**
-   * Get an agent by ID with session info.
+   * Get a live agent and its registry-owned session metadata.
    * @param agentId - Agent identifier
-   * @returns Agent with session info, or undefined if not found
+   * @returns Active agent handle, or undefined if not found
    */
-  getAgent(agentId: string): (TAgent & {
-    sessionId: string;
-    adapterSessionId: string;
-  }) | undefined;
+  getAgent(agentId: string): ActiveAgentHandle<TAgent> | undefined;
   /**
    * Dispose resources for an agent.
    *
@@ -3316,12 +3325,9 @@ declare abstract class AIAdapter<TBus extends ScopedBus<string> = ScopedBus<stri
   disposeAgent(agentId: string): boolean;
   /**
    * Get all active agents managed by this adapter.
-   * @returns Array of active agents with session info
+   * @returns Active agent handles
    */
-  getActiveAgents(): Array<TAgent & {
-    sessionId: string;
-    adapterSessionId: string;
-  }>;
+  getActiveAgents(): Array<ActiveAgentHandle<TAgent>>;
   /**
    * Check if the adapter has been initialized.
    * @returns true if init() has been called successfully
@@ -4577,4 +4583,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, ConformanceConnectorRuntimeRegistry, 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 ResolveConformanceDefinitionProvidersOptions, type ResolveConformanceTestPresetOptions, type ResolveHints, type ResolvedConformanceTestPreset, SESSION_CLOSED_QUEUE_ERROR, 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, createNoAuthTestProviderContext, createTestProviderContext, createToolApprovalHandler, defineDiscriminatedHandlers, defineDiscriminatedHandlersSync, extractMcpCallTarget, formatContextBlockAsText, formatContextBlocksAsText, formatMessageHistoryAsTranscript, isMcpCallTool, isTextLikeMimeType, markCompletedWithFinalResult, mergeScopedToolApproval, normalizeEnvValue, normalizeMessageInput, normalizeMimeType, parseAIAdapterCapabilities, processDiscriminatedItems, processDiscriminatedItemsSync, processQueueMessages, registerAgentBusHandlers, registerMemoryImportCursorStorage, rejectQueuedHandles, resolveConformanceDefinitionProviders, resolveConformanceTestPreset, resolveDisabledNativeTools, 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 ActiveAgentHandle, 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, ConformanceConnectorRuntimeRegistry, 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 ResolveConformanceDefinitionProvidersOptions, type ResolveConformanceTestPresetOptions, type ResolveHints, type ResolvedConformanceTestPreset, SESSION_CLOSED_QUEUE_ERROR, 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, createNoAuthTestProviderContext, createTestProviderContext, createToolApprovalHandler, defineDiscriminatedHandlers, defineDiscriminatedHandlersSync, extractMcpCallTarget, formatContextBlockAsText, formatContextBlocksAsText, formatMessageHistoryAsTranscript, isMcpCallTool, isTextLikeMimeType, markCompletedWithFinalResult, mergeScopedToolApproval, normalizeEnvValue, normalizeMessageInput, normalizeMimeType, parseAIAdapterCapabilities, processDiscriminatedItems, processDiscriminatedItemsSync, processQueueMessages, registerAgentBusHandlers, registerMemoryImportCursorStorage, rejectQueuedHandles, resolveConformanceDefinitionProviders, resolveConformanceTestPreset, resolveDisabledNativeTools, resolveRequiredSessionId, resolveTestConfig, safeJsonStringify, serializeBlockToText, serializeTurnContext, toImportSegment };