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

package/dist/{types-BMS6yfLS.d.mts → types-BNW5n6qm.d.mts}

@@ -90,8 +90,8 @@ declare const ActionResultSchema: z.ZodUnion<readonly [z.ZodObject<{
     editOf: z.ZodOptional<z.ZodString>;
     origin: z.ZodOptional<z.ZodEnum<{
       text: "text";
-      voice: "voice";
       compact: "compact";
+      voice: "voice";
     }>>;
   }, z.core.$strip>>;
 }, z.core.$strip>, z.ZodObject<{

package/dist/{types-BslClRkH.d.mts → types-BWduCvRU.d.mts}

@@ -1,4 +1,4 @@
-import { r as LogImportMode, t as LogImporterInfo } from "./index-CfIW5biI.mjs";
+import { r as LogImportMode, t as LogImporterInfo } from "./index-D7rWAEY0.mjs";
 import * as _$_makaio_bus_core0 from "@makaio/framework/bus";
 import { IMakaioBus } from "@makaio/framework/bus";
 import { LogImportOrchestrator, LogImporter } from "@makaio/framework/adapters";
@@ -84,6 +84,7 @@ declare class LogImportRegistry implements CapabilityProviderRegistrar {
    * - scan: Scan log directory for sessions (generic handler)
    * - uploadFiles: Process uploaded files (generic handler)
    * - importSession: Lazy-load pick-up for discovered sessions
+   * - importFile: File-path-addressable import trigger (graceful-absence contract)
    * - capability register: Auto-register adapters that publish log-import capabilities
    *
    * Must be called before using the registry.
@@ -254,6 +255,26 @@ interface LogImporterRegistration {
    * Defaults to true.
    */
   supportsManualImport?: boolean;
+  /**
+   * Stable client application id (e.g., `'claude-code'`) whose native hooks
+   * observe the sessions this importer ingests.
+   *
+   * Enables client-agnostic framework components to resolve the importer for
+   * a `client.session.*` event without hard-coding importer names. Any string
+   * is valid — framework logic never hard-codes specific client ids.
+   */
+  clientId?: string;
+  /**
+   * Machine identifier of the machine that owns the sessions this importer
+   * discovers and imports. Always caller-supplied by product code at
+   * registration time; never derived inside framework import handlers.
+   *
+   * When present, it is stamped on every `storage:session.importUpsert`
+   * payload emitted by the scan and full-import paths for this registration.
+   * Pass `undefined` (or omit the field) to leave the stored `machineId`
+   * untouched; pass `null` to explicitly store NULL.
+   */
+  machineId?: string | null;
   /**
    * Factory for creating orchestrators for this importer.
    *

package/dist/{types-Cse8s_cD.d.mts → types-N_BOtTqt.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
@@ -909,6 +902,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'). */
@@ -1001,6 +1000,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).