@makaio/framework 1.0.0-dev-1783705652236 → 1.0.0-dev-1783973359164

package/dist/{index-C23g_M_J2.d.mts → index-BmsPH78f2.d.mts}

@@ -1,7 +1,7 @@
 import { TransportPeerContext } from "@makaio/framework/core";
 import { IMakaioBus } from "@makaio/framework/bus";
 import * as _$_makaio_contracts0 from "@makaio/framework/contracts";
-import { CompletionMode, MakaioNodeExtension, PendingRequest, SubagentConfig, SubagentConstraints, SubagentStatus } from "@makaio/framework/contracts";
+import { AwaitSubagentResponse, CompletionMode, MakaioNodeExtension, PendingRequest, SubagentConfig, SubagentConstraints, SubagentStatus } from "@makaio/framework/contracts";
 import { BaseService } from "@makaio/framework/service-base";
 
 //#region services/core/src/subagent/spawn-delegation.d.ts
@@ -27,6 +27,16 @@ type SpawnDelegationAllowSet = Set<string>;
 declare function isPeerAuthorizedToDelegate(peer: TransportPeerContext | undefined, allowSet: SpawnDelegationAllowSet): boolean;
 //#endregion
 //#region services/core/src/subagent/subagent-service.d.ts
+/** Stable failures while finalizing a failed subagent spawn. */
+type SubagentFailureFinalizationErrorCode = 'child-session-close-failed' | 'failure-publication-failed';
+/** Credential-free diagnostic for one failed spawn-finalization operation. */
+declare class SubagentFailureFinalizationError extends Error {
+  readonly code: SubagentFailureFinalizationErrorCode;
+  /**
+   * @param code - Stable finalization failure category.
+   */
+  constructor(code: SubagentFailureFinalizationErrorCode);
+}
 /**
  * Orchestrates subagent execution lifecycle.
  *
@@ -39,9 +49,12 @@ declare function isPeerAuthorizedToDelegate(peer: TransportPeerContext | undefin
 declare class SubagentService extends BaseService {
   private readonly machineId?;
   private readonly delegationAllowSet;
+  private readonly requestHandlerPriority;
+  private readonly executionOwnerId;
   /** Manager is now private - tools use RPCs to interact with state */
   private readonly manager;
   private readonly pendingChildSessionClose;
+  private readonly spawningExecutions;
   /**
    * Creates a new SubagentService instance.
    * @param bus - The event bus for inter-service communication
@@ -51,8 +64,10 @@ declare class SubagentService extends BaseService {
    *   spawn or execute on this node from a remote origin. Authenticated
    *   `workflow-execution` peers are allowed by identity; this set is for
    *   additional delegated peer kinds.
+   * @param requestHandlerPriority - Priority for runtime-owned subagent lifecycle RPCs.
+   * @param executionOwnerId - Stable identity used to bind spawned execution to this service instance.
    */
-  constructor(bus?: IMakaioBus, constraints?: SubagentConstraints, machineId?: string | undefined, delegationAllowSet?: SpawnDelegationAllowSet);
+  constructor(bus?: IMakaioBus, constraints?: SubagentConstraints, machineId?: string | undefined, delegationAllowSet?: SpawnDelegationAllowSet, requestHandlerPriority?: number, executionOwnerId?: string);
   /**
    * Grant an authenticated peer permission to delegate spawn/execute requests.
    *
@@ -93,13 +108,22 @@ declare class SubagentService extends BaseService {
    * @returns Error message on failure, undefined on success
    */
   private handleSpawned;
+  /**
+   * Execute the single claimed spawn event for one subagent.
+   * @param payload - Spawned event payload.
+   * @param parentSessionId - Parent session that requested the subagent.
+   * @param task - Task sent to the child agent.
+   * @param spawningToolCallId - Tool call that initiated the spawn, if available.
+   * @returns Error message on failure, otherwise undefined.
+   */
+  private executeSpawned;
   /**
    * Creates the child session and updates tracked subagent state.
    * @param subagentId - Subagent identifier
    * @param parentSessionId - Parent session identifier
    * @param config - Parsed subagent config
    * @param executionTargetId - Resolved execution target ID
-   * @param resolutionParams - Framework execution-target fallback fields
+   * @param resolutionParams - Parent-derived execution target and working-directory fields
    * @param spawningToolCallId - Tool call ID that triggered the spawn, if available
    * @returns Created child session ID
    */
@@ -110,6 +134,7 @@ declare class SubagentService extends BaseService {
    * @param config - Parsed subagent config
    * @param sessionId - Child session ID
    * @param task - Initial task message
+   * @param targetWorkingDirectory - Parent-derived adapter working directory, when present.
    * @returns Resolves when adapter start succeeds
    * @throws Error when adapter startup fails
    */
@@ -121,6 +146,7 @@ declare class SubagentService extends BaseService {
    * @param phase - Spawn phase where failure occurred
    * @param reason - Error object or message
    * @returns Normalized error message
+   * @throws AggregateError when child cleanup or failure publication also fails.
    */
   private failSpawn;
   /**
@@ -128,7 +154,7 @@ declare class SubagentService extends BaseService {
    *
    * Priority:
    * 1. Explicit subagent `executionTargetId`
-   * 2. Parent session stamped target + context
+   * 2. Parent session stamped target + working directory
    * @param parentSessionId - Parent session used as fallback context.
    * @param executionTargetId - Optional explicit target override from subagent config.
    * @returns Resolution parameters for `ExecutionTargetSubjects.resolve`.
@@ -143,6 +169,7 @@ declare class SubagentService extends BaseService {
    * @param parentSessionId - Parent session identifier from the spawn request
    * @param config - Parsed subagent config
    * @param executionTargetId - Resolved execution target to stamp on child session
+   * @param targetWorkingDirectory - Parent working directory inherited by the child session
    * @param spawningToolCallId - Tool call ID that triggered the spawn, if available
    * @returns Session.create payload for the child session
    */
@@ -172,6 +199,12 @@ declare class SubagentService extends BaseService {
    * @param subagentId - Subagent whose child session should be closed.
    */
   private closeChildSession;
+  /**
+   * Close a tracked child session while preserving failures for transactional callers.
+   * @param subagentId - Subagent whose child session should be closed.
+   * @throws Error when the session close request fails.
+   */
+  private requestChildSessionClose;
   /**
    * Check whether a subagent has reached a terminal status.
    * @param status - Subagent status to inspect.
@@ -237,7 +270,10 @@ declare const SubagentServiceToken: _$_makaio_contracts0.ExtensionToken<Subagent
  * The services-core manifest intentionally uses a service-specific export
  * name; `@makaio/extension-subagent` continues to own the tool-extension
  * `subagentPackage` export.
+ * @param requestHandlerPriority - Priority for runtime-owned lifecycle RPC handlers.
+ * @returns A subagent service package configured with the requested dispatch priority.
  */
+declare function createSubagentServicePackage(requestHandlerPriority?: number): MakaioNodeExtension<IMakaioBus>;
 declare const subagentServicePackage: MakaioNodeExtension<IMakaioBus>;
 //#endregion
 //#region services/core/src/subagent/utils/ring-buffer.d.ts
@@ -322,6 +358,8 @@ interface TrackedSubagent {
    * - `'turn'` — first completed agent turn was used as the result.
    */
   completionSource?: CompletionMode;
+  /** Tool outcomes observed directly from the child session runtime. */
+  toolObservations: NonNullable<AwaitSubagentResponse['toolObservations']>;
   /** Timestamp when the subagent was spawned. */
   startTime: number;
   /** Timestamp when the subagent reached a terminal state. */
@@ -355,6 +393,7 @@ interface AwaitResult {
    * - `'turn'` — first completed agent turn was used as the result.
    */
   completionSource?: CompletionMode;
+  toolObservations?: NonNullable<AwaitSubagentResponse['toolObservations']>;
 }
 //#endregion
 //#region services/core/src/subagent/manager/subagent-manager.d.ts
@@ -406,6 +445,12 @@ declare class SubagentManager {
    * @returns The tracked subagent, or undefined if not found
    */
   get(subagentId: string): TrackedSubagent | undefined;
+  /**
+   * Record one authoritative child-session tool outcome for terminal handoff.
+   * @param childSessionId - Child session whose runtime emitted the outcome.
+   * @param observation - Validated outcome and optional authoritative Artifact identity.
+   */
+  recordToolObservation(childSessionId: string, observation: TrackedSubagent['toolObservations'][number]): void;
   /**
    * Return all non-terminal subagents as an array.
    *
@@ -522,4 +567,4 @@ declare class SubagentManager {
   sweepHung(inactivityTimeoutMs: number): number;
 }
 //#endregion
-export { InternalPendingRequest as a, SubagentServiceToken as c, SpawnDelegationAllowSet as d, isPeerAuthorizedToDelegate as f, InputResolver as i, subagentServicePackage as l, TrackOptions as n, SpawnOptions as o, AwaitResult as r, TrackedSubagent as s, SubagentManager as t, SubagentService as u };
+export { InternalPendingRequest as a, SubagentServiceToken as c, SubagentFailureFinalizationError as d, SubagentFailureFinalizationErrorCode as f, isPeerAuthorizedToDelegate as h, InputResolver as i, createSubagentServicePackage as l, SpawnDelegationAllowSet as m, TrackOptions as n, SpawnOptions as o, SubagentService as p, AwaitResult as r, TrackedSubagent as s, SubagentManager as t, subagentServicePackage as u };