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

package/dist/{types-Cse8s_cD.d.mts → types-D7W0ntGr.d.mts}

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { ExtractSubjectPayload, ExtractSubjectResponse, HandlerForSubjectDefinition, ScopedSubjectDefinition, SubjectRecord } from "@makaio/framework/core";
 import { IFilteredBus, IMakaioBus, OnOptions, ScopedBus } from "@makaio/framework/bus";
-import { AIModel, AIReasoningLevel, AIReasoningLevel as AIReasoningLevel$1, AgentSchemas, AgentSubjects, CacheStrategy, JsonValue, McpRuntimeSessionContext, McpSessionContext, McpToolState, Message, MessageBlock, MessageDeliveryMode, MessageDeliveryMode as MessageDeliveryMode$1, MessageInput, MessageOutcome, ProviderContext, ReasoningLevelMap as ReasoningLevelMap$1, ResponseSchemaDescriptor, SendMessageResultInnerResult, SessionContext, StructuredOutputValidation, SystemPrompt, ToolListItem } from "@makaio/framework/contracts";
+import { AIModel, AIReasoningLevel, AIReasoningLevel as AIReasoningLevel$1, AgentSchemas, AgentSubjects, CacheStrategy, JsonValue, McpRuntimeSessionContext, McpSessionContext, McpToolState, Message, MessageBlock, MessageDeliveryMode, MessageDeliveryMode as MessageDeliveryMode$1, MessageInput, MessageOutcome, NativeForkDirective, ProviderContext, ReasoningLevelMap as ReasoningLevelMap$1, ResponseSchemaDescriptor, SendMessageResultInnerResult, SessionContext, StructuredOutputValidation, SystemPrompt, ToolListItem } from "@makaio/framework/contracts";
 import { DeferredPromise, TimeoutConfig, TrackedTimeoutConfig } from "@makaio/framework/utils";
 import { SetRequired } from "type-fest";
 
@@ -563,33 +563,26 @@ declare abstract class AIAgentConnector<TBus extends ScopedBus<string> = ScopedB
    * @returns Session ID from provider
    */
   abstract getAdapterSessionId(): Promise<string>;
+  /**
+   * Provider-confirmed adapter session ID, or `undefined` when unconfirmed.
+   * Default returns `this.adapterSessionId`; Claude connectors override to
+   * defer until `system.init` confirms the provider-side session.
+   * @returns Confirmed ID or `undefined`
+   */
+  getConfirmedAdapterSessionId(): string | undefined;
   /**
    * Complete the agent session by waiting for all messages to finish.
    * @returns Last message result or null if no messages processed
    */
   abstract complete(): Promise<MessageResult | null>;
   /**
-   * Create a MessageHandle with standard initialization.
-   *
-   * Centralizes the pattern used by all connectors:
-   * 1. Generate messageId (use provided or generate UUID)
-   * 2. Create MessageHandle instance
-   * 3. Set adapterSessionId
-   * 4. Call onMessageSent callback
+   * Create a MessageHandle with standard initialization (messageId, adapterSessionId, onMessageSent).
    * @param message - Normalized user message
    * @param options - Optional message options (id, delivery mode, history, and turn context)
-   * @returns Initialized MessageHandle ready for enqueueing
+   * @returns Initialized MessageHandle instance
    */
   protected createMessageHandle(message: NormalizedMessageInput, options?: MessageHandleOptions): MessageHandle;
-  /**
-   * Signal that MCP tools have changed and should be refreshed at the next turn boundary.
-   *
-   * Called by the AIAgent layer when receiving MCP bus events (`mcp.tools.updated`,
-   * `mcp.tools.enabled`). Connectors that support direct-inject tool refresh (e.g.,
-   * `BaseStreamConnector`) override this to set an internal pending-refresh flag.
-   * The default implementation is a no-op so connectors that do not manage MCP tools
-   * directly are unaffected.
-   */
+  /** Signal MCP tools changed; connectors with direct-inject refresh override this. */
   markToolRefreshPending(): void;
   /**
    * Stage the canonical orchestrator-assigned turn number for consumption by the next
@@ -802,6 +795,14 @@ interface ConfigFactoryInput<TBus extends ScopedBus<string> = ScopedBus<string>>
    * Passed through unchanged so connectors can track injection and mcp_call usage.
    */
   toolLedger?: ISessionToolLedger;
+  /**
+   * When true, the agent is ephemeral (one-shot, not a resume/fork target).
+   *
+   * Ephemeral agents skip PreUserMessage hooks and are never resumed or forked
+   * natively. Connectors should disable session persistence for ephemeral agents
+   * so no transcript is written to the provider's session store.
+   */
+  ephemeral?: boolean;
 }
 /**
  * Interface for adapter-specific configuration factories.
@@ -909,6 +910,12 @@ interface BaseAgentConnectorConfig<TBus extends ScopedBus<string> = ScopedBus<st
   supportedReasoningLevels?: ReasoningLevelMap$1;
   /** Previous adapter session ID for resume attempts. */
   resumeAdapterSessionId?: string;
+  /**
+   * Provider-native fork directive approved by session orchestration.
+   * When present, native-fork capable connectors should branch from the source
+   * provider session instead of starting fresh with replayed history.
+   */
+  nativeFork?: NativeForkDirective;
   /** Resolved harness ID for tool policy lookup. */
   harnessId?: string;
   /** Client identifier for the application this adapter belongs to (e.g., 'claude-code', 'gemini'). */
@@ -939,6 +946,14 @@ interface BaseAgentConnectorConfig<TBus extends ScopedBus<string> = ScopedBus<st
    * When present, the connector records tool events into this ledger.
    */
   toolLedger?: ISessionToolLedger;
+  /**
+   * When true, the connector is handling an ephemeral one-shot agent.
+   *
+   * Ephemeral agents are by contract never resume or fork targets. Connectors
+   * that support session persistence should disable it for ephemeral agents so
+   * no transcript is written to the provider's session store.
+   */
+  ephemeral?: boolean;
 }
 /**
  * Configuration for creating an AIAgent instance.
@@ -1001,6 +1016,18 @@ interface AIAgentConfig<TBus extends ScopedBus<string> = ScopedBus<string>, TCon
    * are not needed and would be actively harmful.
    */
   ephemeral?: boolean;
+  /**
+   * Native fork directive from the orchestrator.
+   *
+   * When present, the adapter should use the provider's branching API
+   * rather than replaying history into a fresh session.
+   * Populated by AIAdapter.createAgent when the startAgent mode is 'fork'.
+   *
+   * AIAgent forwards this through config-factory input so standardized adapter
+   * config factories can carry it into connector config. Adapter code must not
+   * derive this from raw fork-mode request fields.
+   */
+  nativeFork?: NativeForkDirective;
   /**
    * Config factory - transforms partial input into full adapter-specific config.
    * This is the seam where adapters inject their defaults (especially model).