@makaio/framework 1.0.0-dev-1779051654000 → 1.0.0-dev-1781023871421

package/dist/{types-C11LvekX.d.mts → types-BCMUtBj1.d.mts}

@@ -1,9 +1,8 @@
 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, JsonValue, McpRuntimeSessionContext, McpSessionContext, McpToolState, Message, MessageBlock, MessageDeliveryMode, MessageDeliveryMode as MessageDeliveryMode$1, MessageInput, MessageOutcome, ProviderContext, ReasoningLevelMap as ReasoningLevelMap$1, SendMessageResultInnerResult, SessionContext, SystemPrompt, ToolListItem } from "@makaio/framework/contracts";
+import { AIModel, AIReasoningLevel, AIReasoningLevel as AIReasoningLevel$1, AgentSchemas, AgentSubjects, 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 { DeferredPromise, TimeoutConfig, TrackedTimeoutConfig } from "@makaio/framework/utils";
-import * as _$emittery from "emittery";
 import { SetRequired } from "type-fest";
 
 //#region adapters/core/src/agent/session-tool-ledger.d.ts
@@ -171,6 +170,12 @@ declare class SessionToolLedger implements ISessionToolLedger {
   suggestInjectionSet(context: LedgerSessionContext, _currentTurnNumber: number): Promise<readonly ToolListItem[]>;
 }
 //#endregion
+//#region node_modules/emittery/index.d.ts
+/**
+Removes an event subscription.
+*/
+type UnsubscribeFunction = () => void;
+//#endregion
 //#region adapters/core/src/message-handle/types.d.ts
 /**
  * Result of a message operation.
@@ -181,6 +186,11 @@ type MessageResult = {
   outcome: MessageOutcome; /** Present when outcome='superseded': the messageId that replaced this one */
   supersededBy?: string; /** Present when outcome='merged': the messageId this was folded into */
   mergedInto?: string;
+  /**
+   * Structured-output validation result for this turn.
+   * Present only when a {@link ResponseSchemaDescriptor} was active and validation ran.
+   */
+  structuredOutputValidation?: StructuredOutputValidation;
 };
 /**
  * Lifecycle states for a queued message.
@@ -200,6 +210,33 @@ interface SendMessageOptions {
    */
   deliveryMode?: MessageDeliveryMode;
 }
+/**
+ * Options bag used when creating a message handle.
+ *
+ * Passed to {@link MessageHandle} via `AIAgentConnector.createMessageHandle`.
+ */
+interface MessageHandleOptions {
+  /** Optional stable message identifier; autogenerated when omitted. */
+  messageId?: string;
+  /** Optional delivery semantics for queue processing. */
+  deliveryMode?: MessageDeliveryMode;
+  /** Optional prior conversation messages to materialize for the turn. */
+  messageHistory?: Message[];
+  /** Optional per-turn metadata/context payload for prompt materialization. */
+  turnContext?: Record<string, JsonValue>;
+  /**
+   * Per-turn structured-output schema descriptor.
+   * When set, the agent's structured-output manager validates the terminal
+   * message against this schema before emitting completion events.
+   */
+  responseSchema?: ResponseSchemaDescriptor;
+  /**
+   * Whether this message handle was created for an internal retry turn.
+   * When `true`, the `onMessageSent` callback is suppressed so no
+   * `user_message.sent` event is emitted for the synthetic retry message.
+   */
+  internalRetry?: boolean;
+}
 /**
  * Processing state for agent orchestration.
  */
@@ -218,15 +255,32 @@ type NormalizedMessageInput = Required<Message> & {
 declare function normalizeMessageInput(input: MessageInput): NormalizedMessageInput;
 //#endregion
 //#region adapters/core/src/message-handle/message-handle.d.ts
+type CompletionTransform = (result: MessageResult) => MessageResult | Promise<MessageResult>;
+type CompletionObserver = (result: MessageResult) => void;
+type CompletionNotification = (handle: MessageHandle, result: MessageResult) => void | Promise<void>;
 declare class MessageHandle {
   readonly messageId: string;
   readonly message: NormalizedMessageInput;
   readonly deliveryMode: MessageDeliveryMode;
+  /**
+   * Per-turn structured-output schema descriptor.
+   * When present, the agent validates the terminal message against this
+   * schema before resolving completion and emitting terminal events.
+   */
+  readonly responseSchema?: ResponseSchemaDescriptor | undefined;
+  /**
+   * Internal structured-output retry turns must stay hidden from user-message
+   * lifecycle events while still taking precedence over queued user turns.
+   */
+  readonly internalRetry: boolean;
   protected readonly deferredCompletion: DeferredPromise<MessageResult>;
   protected readonly deferredAcknowledgement: DeferredPromise<boolean>;
   state: MessageState;
   private isAcknowledged;
   private completionResult;
+  private completionStarted;
+  private readonly completionTransforms;
+  private readonly completionObservers;
   /** If this message was merged into another, the winner's messageId */
   mergedInto?: string;
   /** If this is the merge winner, messageIds that were folded in */
@@ -244,7 +298,20 @@ declare class MessageHandle {
 
   messageHistory?: Message[], /** Turn-scoped context from PreUserMessage hooks */
 
-  turnContext?: Record<string, JsonValue>);
+  turnContext?: Record<string, JsonValue>,
+  /**
+   * Per-turn structured-output schema descriptor.
+   * When present, the agent validates the terminal message against this
+   * schema before resolving completion and emitting terminal events.
+   */
+
+  responseSchema?: ResponseSchemaDescriptor | undefined,
+  /**
+   * Internal structured-output retry turns must stay hidden from user-message
+   * lifecycle events while still taking precedence over queued user turns.
+   */
+
+  internalRetry?: boolean);
   /**
    * Curated message history from sessionContext
    * @returns The message history array or undefined if not set
@@ -291,14 +358,49 @@ declare class MessageHandle {
    * (e.g. false if immediate message arrived too late)
    */
   markAcknowledged(delivered?: boolean): void;
+  /**
+   * Register a transform that canonicalizes the terminal result before
+   * {@link waitForCompletion} resolves.
+   * @param transform - Transform applied to the raw provider completion result
+   */
+  addCompletionTransform(transform: CompletionTransform): void;
+  /**
+   * Register an observer that runs after all completion transforms have
+   * produced the canonical terminal result, but before completion resolves.
+   * @param observer - Observer called with the final completion result
+   */
+  addCompletionObserver(observer: CompletionObserver): void;
   /**
    * Mark message turn as completed
    * @param result - The result message or null if no result available
    */
   markCompleted(result: MessageResult): void;
+  /**
+   * Apply registered completion transforms and publish the canonical result.
+   * @param result - Raw provider completion result
+   */
+  private resolveCompletion;
+  /**
+   * Notify registered completion observers without changing terminal outcome.
+   * @param result - Canonical completion result
+   */
+  private notifyCompletionObservers;
   waitForAcknowledgment(timeoutMs?: number): Promise<boolean>;
   waitForCompletion(timeoutMs?: number): Promise<MessageResult>;
 }
+/**
+ * Complete a handle while notifying a callback with the transformed final result.
+ *
+ * `markCompleted()` starts async completion transforms before resolving
+ * waiters. Connector/session layers that cache `lastResult` must observe the
+ * final transformed value, not the raw provider result they pass into
+ * `markCompleted()`.
+ * @param handle - Message handle being completed
+ * @param result - Raw provider completion result
+ * @param onComplete - Optional notification callback receiving the final result
+ * @returns Promise that settles after the final-result callback completes
+ */
+declare function markCompletedWithFinalResult(handle: MessageHandle, result: MessageResult, onComplete?: CompletionNotification): Promise<void>;
 //#endregion
 //#region adapters/core/src/connector/agent-connector.d.ts
 type Forbid<T, K extends PropertyKey> = Omit<T, K> & { [P in K]?: never };
@@ -307,19 +409,6 @@ type ForbiddenKeys = 'agentId' | 'adapterId' | 'adapterSessionId' | 'adapterName
 type ExtractScopedBusSubjects<T> = T extends {
   withFilter: (...args: unknown[]) => IFilteredBus<string, infer S>;
 } ? S : T extends ScopedBus<string, infer S> ? S : SubjectRecord;
-/**
- * Public options bag used by connectors when creating a message handle.
- */
-interface MessageHandleOptions {
-  /** Optional stable message identifier; autogenerated when omitted. */
-  messageId?: string;
-  /** Optional delivery semantics for queue processing. */
-  deliveryMode?: MessageDeliveryMode;
-  /** Optional prior conversation messages to materialize for the turn. */
-  messageHistory?: Message[];
-  /** Optional per-turn metadata/context payload for prompt materialization. */
-  turnContext?: Record<string, JsonValue>;
-}
 /**
  * Abstract base class for AI agent implementations.
  *
@@ -413,7 +502,7 @@ declare abstract class AIAgentConnector<TBus extends ScopedBus<string> = ScopedB
    * @param handler - Called with `{ isProcessing: boolean }` on each state change
    * @returns Unsubscribe function
    */
-  onProcessingStateChanged(handler: (payload: EmitteryEvents['processingStateChanged']) => Promise<void> | void): _$emittery.UnsubscribeFunction;
+  onProcessingStateChanged(handler: (payload: EmitteryEvents['processingStateChanged']) => Promise<void> | void): UnsubscribeFunction;
   /**
    * Wait for a single processing state change matching an optional predicate.
    * @param predicate - Optional filter, e.g., `(e) => !e.isProcessing` for idle
@@ -679,6 +768,8 @@ interface ConfigFactoryInput<TBus extends ScopedBus<string> = ScopedBus<string>>
   clientId?: string;
   /** Client profile name for session-scoped config isolation. */
   clientProfileName?: string;
+  /** Harness identifier used to resolve per-agent tool governance. */
+  harnessId?: string;
   /**
    * Resolved MCP session context including upstream server configs.
    * When present, native-passthrough adapters use `servers` to configure SDK MCP connections.
@@ -925,12 +1016,12 @@ interface AgentSendMessageOptions extends SendMessageOptions {
    */
   sessionContext?: SessionContext;
   /**
-   * JSON Schema for structured output.
+   * Structured output descriptor.
    * When present and the adapter declares `structuredOutput` capability,
    * the adapter enforces this schema at the model level.
    * Ignored by adapters that lack the capability.
    */
-  responseSchema?: Record<string, unknown>;
+  responseSchema?: ResponseSchemaDescriptor;
 }
 /**
  * Options for starting an agent session.
@@ -953,6 +1044,12 @@ interface ConnectorSendMessageOptions extends AgentSendMessageOptions {
    * LLM-facing message using serializeTurnContext().
    */
   turnContext?: Record<string, JsonValue>;
+  /**
+   * Whether this message is an internal retry turn synthesized by the structured-output
+   * manager. When `true`, the connector suppresses `user_message.sent` so the retry
+   * is not surfaced as a new user message.
+   */
+  internalRetry?: boolean;
 }
 /**
  * Options for connector-level start operations.
@@ -1006,4 +1103,4 @@ interface ContextWindowInput {
   cachedTokens?: number;
 }
 //#endregion
-export { MessageHandle as A, ISessionToolLedger as B, SendMessageRequestPayload as C, IAdapterConfigFactory as D, ConfigFactoryInput as E, ProcessingState as F, SessionToolLedger as H, SendMessageOptions as I, AIModel as L, normalizeMessageInput as M, MessageResult as N, AIAgentConnector as O, MessageState as P, AIReasoningLevel$1 as R, NormalizedCallUsage as S, StartAgentOptions as T, ToolLedgerEntry as U, LedgerSessionContext as V, ConnectorSendMessageOptions as _, AgentCwdChangeRequestPayload as a, ExecutionContext as b, AgentInterruptRequestPayload as c, AgentMcpServersSetResponsePayload as d, AgentModelChangeRequestPayload as f, BaseAgentConnectorConfig as g, AgentStartResult as h, AgentCredentialChangeResponsePayload as i, NormalizedMessageInput as j, MessageDeliveryMode$1 as k, AgentInterruptResponsePayload as l, AgentSendMessageOptions as m, AgentContext as n, AgentCwdChangeResponsePayload as o, AgentModelChangeResponsePayload as p, AgentCredentialChangeRequestPayload as r, AgentIdentity as s, AIAgentConfig as t, AgentMcpServersSetRequestPayload as u, ConnectorStartOptions as v, SendMessageResponsePayload as w, GetCapabilitiesResponsePayload as x, ContextWindowInput as y, ReasoningLevelMap$1 as z };
+export { MessageHandle as A, ReasoningLevelMap$1 as B, SendMessageRequestPayload as C, IAdapterConfigFactory as D, ConfigFactoryInput as E, MessageState as F, LedgerSessionContext as H, ProcessingState as I, SendMessageOptions as L, NormalizedMessageInput as M, normalizeMessageInput as N, AIAgentConnector as O, MessageResult as P, AIModel as R, NormalizedCallUsage as S, StartAgentOptions as T, SessionToolLedger as U, ISessionToolLedger as V, ToolLedgerEntry as W, ConnectorSendMessageOptions as _, AgentCwdChangeRequestPayload as a, ExecutionContext as b, AgentInterruptRequestPayload as c, AgentMcpServersSetResponsePayload as d, AgentModelChangeRequestPayload as f, BaseAgentConnectorConfig as g, AgentStartResult as h, AgentCredentialChangeResponsePayload as i, markCompletedWithFinalResult as j, MessageDeliveryMode$1 as k, AgentInterruptResponsePayload as l, AgentSendMessageOptions as m, AgentContext as n, AgentCwdChangeResponsePayload as o, AgentModelChangeResponsePayload as p, AgentCredentialChangeRequestPayload as r, AgentIdentity as s, AIAgentConfig as t, AgentMcpServersSetRequestPayload as u, ConnectorStartOptions as v, SendMessageResponsePayload as w, GetCapabilitiesResponsePayload as x, ContextWindowInput as y, AIReasoningLevel$1 as z };

package/dist/{types-vNpkAe4Y.d.mts → types-C2Ob9zz_.d.mts}

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { SessionMessage } from "@makaio/framework/contracts";
 
-//#region packages/services/core/src/session-editor/types.d.ts
+//#region services/core/src/session-editor/types.d.ts
 /**
  * Category of pipeline action.
  */

package/dist/{types-t295YC6T.d.mts → types-CCdqjeuH.d.mts}

@@ -80,7 +80,7 @@ type Condition = FieldCondition | AndCondition | OrCondition | NotCondition | Ex
  */
 declare const ConditionSchema: z.ZodType<Condition>;
 //#endregion
-//#region packages/services/core/src/context-rules/types.d.ts
+//#region services/core/src/context-rules/types.d.ts
 /**
  * Default turn-context bucket used for rules that inject additional context.
  */
@@ -259,4 +259,4 @@ interface ContextRuleChangedEvent {
   timestamp: number;
 }
 //#endregion
-export { ManagedInstructionFileTarget as _, ContextRuleInput as a, TurnContextRuleAction as b, ContextRuleScope as c, ContextSnapshot as d, ContextSnapshotBase as f, MANAGED_INSTRUCTION_FILE_TARGETS as g, FileContextRuleAction as h, ContextRuleCondition as i, ContextRuleScopeFields as l, DEFAULT_CONTEXT_RULE_TURN_CONTEXT_KEY as m, ContextRuleAction as n, ContextRuleListQuery as o, ContextSnapshotExtensions as p, ContextRuleChangedEvent as r, ContextRuleResolutionRequest as s, ContextRule as t, ContextRuleScopeIdentity as u, ResolvedContextRule as v, ResolvedContextRules as y };
+export { ManagedInstructionFileTarget as _, ContextRuleInput as a, TurnContextRuleAction as b, ContextRuleScope as c, ContextSnapshot as d, ContextSnapshotBase as f, MANAGED_INSTRUCTION_FILE_TARGETS as g, FileContextRuleAction as h, ContextRuleCondition as i, ContextRuleScopeFields as l, DEFAULT_CONTEXT_RULE_TURN_CONTEXT_KEY as m, ContextRuleAction as n, ContextRuleListQuery as o, ContextSnapshotExtensions as p, ContextRuleChangedEvent as r, ContextRuleResolutionRequest as s, ContextRule as t, ContextRuleScopeIdentity as u, ResolvedContextRule as v, Condition as x, ResolvedContextRules as y };

package/dist/{types-Cvrj2ogm.d.mts → types-DZHvOc_Q.d.mts}

@@ -1,11 +1,11 @@
-import { r as LogImportMode, t as LogImporterInfo } from "./index-D1T-PPqF.mjs";
+import { r as LogImportMode, t as LogImporterInfo } from "./index-D9MwJ2Q8.mjs";
 import * as _$_makaio_bus_core0 from "@makaio/framework/bus";
 import { IMakaioBus } from "@makaio/framework/bus";
 import { LogImportOrchestrator, LogImporter } from "@makaio/framework/adapters";
 import { JsonObject } from "type-fest";
 import { CapabilityService } from "@makaio/framework/services/capability";
 
-//#region packages/services/log-import/src/capability-provider.d.ts
+//#region services/log-import/src/capability-provider.d.ts
 /**
  * Minimal registry API required to register providers from capability events.
  *
@@ -37,7 +37,7 @@ interface CapabilityProviderRegistrar {
   switchMode(importerId: string, mode: LogImportMode): Promise<void>;
 }
 //#endregion
-//#region packages/services/log-import/src/log-import-registry.d.ts
+//#region services/log-import/src/log-import-registry.d.ts
 /**
  * Registry for managing log importers and their orchestrator lifecycle.
  *
@@ -201,7 +201,7 @@ declare class LogImportRegistry implements CapabilityProviderRegistrar {
   destroy(): Promise<void>;
 }
 //#endregion
-//#region packages/services/log-import/src/types.d.ts
+//#region services/log-import/src/types.d.ts
 /**
  * Factory function that creates a {@link LogImportOrchestrator} for a given mode.
  *