@tangle-network/agent-interface 0.49.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,24 @@ 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.
+     *
+     * A capability the connected deployment decides is environment-scoped: one
+     * provider reaches deployments of different ages, so
+     * {@link AgentEnvironmentProvider.capabilities} can only state what holds
+     * before an environment exists. A provider that measures a capability per
+     * environment publishes the measured answer here, and the operations this
+     * environment exposes match it exactly. Absent when the provider document
+     * already describes every environment it creates.
+     */
+    readonly capabilities?: AgentEnvironmentCapabilities;
     status(options?: {
         signal?: AbortSignal;
     }): Promise<AgentEnvironmentStatus>;

package/package.json

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