@tangle-network/agent-interface 0.50.0 → 0.51.0

package/README.md

@@ -10,6 +10,8 @@ shapes; higher-level packages import from here rather than redefining them.
 `AgentRunControlRef` identifies a retained run without depending on a live JavaScript object and may carry the provider's admission digest so reconstruction can reject changed-input reuse.
 `RuntimeEventEnvelope` adds stable run, event, sequence, cursor, and timestamp fields around the existing `StreamEvent` union, and its runtime schema validates every canonical event variant.
 Providers advertise `retainedControl` only when exact run, result, event, cancellation, replay, detach, turn, and session identity are all implemented together.
+`AgentEnvironment.metadata` is the detached snapshot returned by create or get, so recovery can check persisted annotations without listing environments.
+Metadata can include caller-authored values and does not prove authorization or authorship.
 `AgentSession.cancelRun()` accepts a canonical request digest bound to one operation and `AgentExactRunControlRef`, so a caller can safely repeat the same cancellation after losing the first acknowledgement.
 Its acknowledgement repeats the operation, digest, and run coordinates and distinguishes a known cancellation effect from conflict or unknown state.
 

package/dist/environment-runtime.d.ts

@@ -623,6 +623,11 @@ export interface AgentEnvironment {
     readonly id: string;
     readonly provider: string;
     readonly name?: string;
+    /**
+     * Detached metadata returned by the provider.
+     * It can contain caller-authored annotations and is not authorization evidence.
+     */
+    readonly metadata?: Readonly<Record<string, unknown>>;
     /**
      * The capability document for THIS environment, and the document a caller
      * reads to decide which operation to offer against it.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-interface",
-  "version": "0.50.0",
+  "version": "0.51.0",
   "type": "module",
   "sideEffects": false,
   "license": "MIT",