@modelprofile.com/flexharness 10.11.0 → 10.13.0

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@modelprofile.com/flexharness',
-    version: '10.11.0',
+    version: '10.13.0',
     description: 'The FlexHarness toolbox source repository and shared dependency catalog.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSwrQkFBK0I7SUFDckMsT0FBTyxFQUFFLFNBQVM7SUFDbEIsV0FBVyxFQUFFLDBFQUEwRTtDQUN4RixDQUFBIn0=

package/dist_ts/classes.flexharness.d.ts

@@ -1,4 +1,4 @@
-import type { IFlexBackgroundExecution, IFlexBeginSessionImportOptions, IFlexCompactSessionOptions, IFlexCreateProjectTaskInput, IFlexCreateSessionOptions, IFlexDeleteSessionGenerationCohortInput, IFlexDeleteSessionGenerationCohortResult, IFlexEventArchiveMetadata, IFlexHarnessOptions, IFlexImportedRun, IFlexMessage, IFlexMessagePage, IFlexMessagePageOptions, IFlexPermissionRequest, IFlexProjectGoalResult, IFlexSteerAdmission, IFlexSteerInput, IFlexProjectScratchpadResult, IFlexProjectStateResult, IFlexProjectTaskResult, IFlexProjectTasksResult, IFlexPromptAdmission, IFlexPromptQueueAdmission, IFlexPromptQueueEntry, IFlexPromptOptions, IFlexPromptResult, IFlexRedoSessionResult, IFlexScheduledPromptAdmission, IFlexSchedulePromptOptions, IFlexSession, IFlexSessionView, IFlexSessionImportHandle, IFlexSessionImportProgress, IFlexSessionReversionInfo, IFlexSlashCommandDescriptor, IFlexSlashCommandExecutionOptions, IFlexUncertainToolExecution, IFlexUndoSessionResult, IFlexUpdateSessionOptions, IFlexUpdateProjectTaskInput, IJsonObject, TFlexBeginSessionImportResult, TFlexHarnessEventListener, TFlexPermissionDecision, TFlexPrompt, TFlexSlashCommandExecutionResult, TFlexToolExecutionReconciliation } from './interfaces.js';
+import type { IFlexBackgroundExecution, IFlexBeginSessionImportOptions, IFlexCompactSessionOptions, IFlexCreateProjectTaskInput, IFlexCreateSessionOptions, IFlexDeleteSessionGenerationCohortInput, IFlexDeleteSessionGenerationCohortResult, IFlexEventArchiveMetadata, IFlexHarnessOptions, IFlexImportedRun, IFlexMessage, IFlexMessagePage, IFlexMessagePageOptions, IFlexPermissionRequest, IFlexProjectGoalResult, IFlexSteerAdmission, IFlexSteerInput, IFlexProjectScratchpadResult, IFlexProjectStateResult, IFlexProjectTaskResult, IFlexProjectTasksResult, IFlexPromptAdmission, IFlexPromptQueueAdmission, IFlexPromptQueueEntry, IFlexPromptOptions, IFlexPromptResult, IFlexRedoSessionResult, IFlexScheduledPromptAdmission, IFlexSchedulePromptOptions, IFlexSession, IFlexSessionView, IFlexSessionMetrics, IFlexSessionImportHandle, IFlexSessionImportProgress, IFlexSessionReversionInfo, IFlexSlashCommandDescriptor, IFlexSlashCommandExecutionOptions, IFlexUncertainToolExecution, IFlexUndoSessionResult, IFlexUpdateSessionOptions, IFlexUpdateProjectTaskInput, IJsonObject, TFlexBeginSessionImportResult, TFlexHarnessEventListener, TFlexPermissionDecision, TFlexPrompt, TFlexSlashCommandExecutionResult, TFlexToolExecutionReconciliation } from './interfaces.js';
 export declare function createFlexResourceToolNamespace(resourceId: string, attachmentRevision: number): string;
 export declare function createFlexResourceToolName(namespace: string, toolName: string): string;
 export declare class FlexHarness<TScope = unknown> {
@@ -22,6 +22,7 @@ export declare class FlexHarness<TScope = unknown> {
     private readonly externalErrorProjector?;
     private readonly subagents;
     private readonly builtInTools;
+    private readonly toolCatalogOptions;
     private readonly slashCommands;
     private readonly maxSubagentDepth;
     private readonly maxSubagentCallsPerRun;
@@ -73,6 +74,8 @@ export declare class FlexHarness<TScope = unknown> {
     /** Discards a staged import. Nothing of it was persisted; an unknown or finished handle is ignored. */
     abortSessionImport(handle: IFlexSessionImportHandle): Promise<void>;
     getSession(scopeId: string, sessionId: string): Promise<IFlexSession>;
+    /** Bounded projection-state read: no message, event, archive or child-history scan. */
+    getSessionMetrics(scopeId: string, sessionId: string): Promise<IFlexSessionMetrics>;
     getSessionReversionInfo(scopeId: string, sessionId: string): Promise<IFlexSessionReversionInfo>;
     updateSession(scopeId: string, sessionId: string, options: IFlexUpdateSessionOptions): Promise<IFlexSession>;
     getProjectState(scopeId: string, sessionId: string): Promise<IFlexProjectStateResult>;
@@ -149,6 +152,13 @@ export declare class FlexHarness<TScope = unknown> {
      * next turn.
      */
     steerPrompt(scopeId: string, sessionId: string, queueId: string, steer: IFlexSteerInput): Promise<IFlexSteerAdmission>;
+    /** Sends follow-up input only to an exact running direct child owned by this parent run. */
+    sendSubagentInput(scopeId: string, parentSessionId: string, parentRunId: string, taskId: string, steer: IFlexSteerInput): Promise<IFlexSteerAdmission>;
+    /** The shared synchronous admission point; neither entrypoint starts or resumes a run. */
+    private admitRunSteer;
+    private sendSubagentInputInRun;
+    /** Fences live ownership by exact runtime pointers and admission seeds all the way to root. */
+    private assertLiveSubagentOwnership;
     abort(scopeId: string, sessionId: string): Promise<boolean>;
     listPendingPermissions(scopeId: string, sessionId?: string): Promise<IFlexPermissionRequest[]>;
     respondToPermission(scopeId: string, sessionId: string, permissionId: string, decision: TFlexPermissionDecision): Promise<void>;
@@ -202,7 +212,8 @@ export declare class FlexHarness<TScope = unknown> {
     /**
      * Holds the end of a run's generation until one more of its background subagents settles. The
      * subagent commits its result to the generation before it settles, so the model takes the result
-     * in with another step instead of the run ending without it. Returns at once when none runs.
+     * in with another step instead of the run ending without it. The engine bounds the scoped
+     * wait from its observed dispatch and commits timer check-ins. Returns at once when none runs.
      */
     private awaitNextBackgroundSubagent;
     private executeRun;
@@ -235,6 +246,12 @@ export declare class FlexHarness<TScope = unknown> {
     private prepareGeneration;
     private enabledBuiltInToolNames;
     private assertNoBuiltInToolCollisions;
+    /**
+     * search_tools, describe_tools and execute. `execute` validates the call and runs the method
+     * inside this tool call, so the tool wrapper bounds its output and projects its errors, and the
+     * call's part, events and permission requests carry the method's path.
+     */
+    private createCatalogTools;
     private createBuiltInTools;
     private createRenameSessionTool;
     private createProjectTaskTool;
@@ -247,6 +264,7 @@ export declare class FlexHarness<TScope = unknown> {
     private createProjectTaskId;
     private createSubagentTool;
     private executeSubagentTask;
+    private createSubagentSendTool;
     private createSubagentResultTool;
     private createDelegatedRunAdmissionSeed;
     private acquireSubagentSession;
@@ -332,6 +350,7 @@ export declare class FlexHarness<TScope = unknown> {
      * the usage of a run that exhausted its callback budget or failed in a callback must not be lost.
      */
     private onModelCallUsage;
+    private settleMetricsOperation;
     private callbackRun;
     private reserveCallbackCapacity;
     private failCallback;