@forgeax/engine-tool-runtime 0.1.28 → 0.1.30

package/dist/types.d.ts

@@ -1,4 +1,25 @@
 export type ToolRealm = 'build' | 'host' | 'engine';
+/**
+ * Trusted identity of the plugin fiber that owns a callable contribution.
+ *
+ * This is deliberately data shaped: it may cross a Host transport and never
+ * contains a Context, Fiber, executor, or other live runtime handle.
+ */
+export interface ToolExecutionOwner {
+    readonly providerId: string;
+    readonly sourceId: string;
+    readonly generation: number;
+    readonly realm: ToolRealm;
+    readonly fiberId?: string | number;
+    readonly module?: string;
+}
+/** Identity attached by a Host connection, rather than supplied in payload. */
+export interface ToolCallerIdentity {
+    readonly connectionId: string;
+    readonly kind?: 'in-process' | 'websocket' | 'cli' | 'frontend' | 'unknown';
+    readonly sourceId?: string;
+    readonly sourceGeneration?: number;
+}
 export type ToolEvidenceKind = 'rhi-tape' | 'profile-capture' | 'png';
 /** Stable subject identity carried by a domain contribution, never a live handle. */
 export interface ToolSubjectRef {
@@ -98,6 +119,10 @@ export interface ToolSnapshotInput {
 export interface ToolExecutionContext {
     readonly runId: string;
     readonly signal: AbortSignal;
+    /** Trusted owner assigned by the API capability, never client input. */
+    readonly owner?: ToolExecutionOwner;
+    /** Trusted caller attached by Host transport or an explicit local owner. */
+    readonly caller?: ToolCallerIdentity;
     readonly snapshot?: SnapshotRef;
     readonly emit: (event: ToolRunEvent) => void;
     readonly addCleanup: (cleanup: () => void | Promise<void>) => void;
@@ -137,6 +162,14 @@ export interface ToolRunOptions extends ToolSnapshotInput {
     readonly deadlineMs?: number;
     readonly evidence?: readonly ToolEvidenceKind[];
     readonly capabilityResolver?: ToolCapabilityResolver;
+    /** Explicit provider route used when one operation has multiple owners. */
+    readonly providerId?: string;
+    readonly sourceId?: string;
+    readonly generation?: number;
+    /** Internal owner context supplied by ToolApiRegistry. */
+    readonly owner?: ToolExecutionOwner;
+    /** Trusted caller context supplied by a Host or local execution owner. */
+    readonly caller?: ToolCallerIdentity;
 }
 export type ToolRunEvent = {
     readonly kind: 'started';
@@ -162,6 +195,8 @@ export interface ToolRun<TResult> {
     readonly id: string;
     readonly events: AsyncIterable<ToolRunEvent>;
     readonly terminal: Promise<ToolTerminal<TResult>>;
+    /** Resolves only after the executor promise has actually returned or thrown. */
+    readonly executorExited: Promise<void>;
     readonly cancel: (reason?: string) => void;
     readonly disconnect: (transport?: string) => void;
     readonly providerExit: (provider?: string) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeax/engine-tool-runtime",
-  "version": "0.1.28",
+  "version": "0.1.30",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",