@tangle-network/agent-provider-tangle 0.13.0 → 0.13.2

package/dist/tangle-capabilities.js

@@ -1,4 +1,4 @@
-import { harnessSystemPromptIntents } from "@tangle-network/agent-interface";
+import { deepFreeze, harnessSystemPromptIntents } from "@tangle-network/agent-interface";
 import { SandboxInstance } from "@tangle-network/sandbox";
 import { ADAPTER_CEILING_DEPLOYMENT, deploymentBacksInteractiveAgent, deploymentBacksRetainedControl, } from "./tangle-deployment-capabilities.js";
 import { clientObservationSurfaceSupport, observationSurfaceSupport, } from "./tangle-observation.js";
@@ -428,11 +428,7 @@ export function capabilitiesForClient(declared, client) {
  * mutated flag would describe a surface this environment does not have.
  */
 export function frozenCapabilityDocument(document) {
-    if (document === null || typeof document !== "object")
-        return document;
-    for (const value of Object.values(document))
-        frozenCapabilityDocument(value);
-    return Object.freeze(document);
+    return deepFreeze(document);
 }
 /**
  * Narrow a declared capability document to what this Sandbox instance backs

package/dist/tangle-environment-values.d.ts

@@ -1,5 +1,5 @@
-import type { AgentEnvironmentStatus, AgentSessionStatus, PlacementInfo } from "@tangle-network/agent-interface/environment-provider";
-import type { SandboxInstanceLike } from "./tangle-types.js";
+import type { AgentEnvironmentCreation, AgentEnvironmentStatus, AgentSessionStatus, PlacementInfo } from "@tangle-network/agent-interface/environment-provider";
+import type { SandboxCreateReceiptLike, SandboxInstanceLike } from "./tangle-types.js";
 export declare function nonEmptyString(value: unknown): string | undefined;
 export declare function optionalNonEmptyString(value: unknown, label: string): string | undefined;
 export declare function placementInfoFromLoopPlacement(placement: unknown, box: SandboxInstanceLike): PlacementInfo;
@@ -16,3 +16,9 @@ export declare function sessionStatusFromUnknown(status: unknown): AgentSessionS
  * "unknown" instead of fabricating an execution-scoped answer.
  */
 export declare function executionBoundSessionStatus(payload: unknown, executionId: string): AgentSessionStatus;
+/**
+ * Map the platform create receipt to the environment creation verdict. An
+ * `unknown` outcome, a null receipt, and an SDK without receipts all leave the
+ * verdict absent, so a consumer cannot read them as proof of creation.
+ */
+export declare function creationFromSandboxCreateReceipt(receipt: SandboxCreateReceiptLike | null | undefined): AgentEnvironmentCreation | undefined;

package/dist/tangle-environment-values.js

@@ -117,3 +117,24 @@ export function executionBoundSessionStatus(payload, executionId) {
         return sessionStatus;
     return "unknown";
 }
+/**
+ * Map the platform create receipt to the environment creation verdict. An
+ * `unknown` outcome, a null receipt, and an SDK without receipts all leave the
+ * verdict absent, so a consumer cannot read them as proof of creation.
+ */
+export function creationFromSandboxCreateReceipt(receipt) {
+    if (receipt === null || receipt === undefined)
+        return undefined;
+    switch (receipt.outcome) {
+        case "created":
+            return "created";
+        case "idempotent_replay":
+            return "replayed";
+        case "unknown":
+            return undefined;
+        default: {
+            const outcome = receipt.outcome;
+            throw new Error(`Tangle create receipt reported an unknown outcome: ${String(outcome)}`);
+        }
+    }
+}

package/dist/tangle-environment.js

@@ -1,9 +1,9 @@
-import { AgentTurnInputSchema } from "@tangle-network/agent-interface";
+import { AgentTurnInputSchema, deepFreeze } from "@tangle-network/agent-interface";
 import { AgentEnvironmentCapabilitiesSchema } from "@tangle-network/agent-interface/environment-provider";
 import { environmentEventFromSandboxEvent } from "./tangle-events.js";
 import { executionIdFromTurnInput, promptFromTurnInput, promptOptionsFromTurnInput, } from "./tangle-prompt.js";
 import { resolveRetainedSessionControlRef } from "./tangle-session-control.js";
-import { placementInfoFromLoopPlacement, statusFromUnknown, } from "./tangle-environment-values.js";
+import { creationFromSandboxCreateReceipt, placementInfoFromLoopPlacement, statusFromUnknown, } from "./tangle-environment-values.js";
 import { execResultFromSandboxExecResult } from "./tangle-result-values.js";
 import { capabilitiesForSandbox, frozenCapabilityDocument, sandboxCapabilitySupport, } from "./tangle-capabilities.js";
 import { readDeploymentCapabilitySupport } from "./tangle-deployment-capabilities.js";
@@ -76,9 +76,11 @@ export async function sandboxInstanceAsEnvironment(box, providerName, client, de
         ...(options.signal ? { signal: options.signal } : {}),
         ...(options.controlRef ? { runControlRef: options.controlRef } : {}),
     });
+    const creation = creationFromSandboxCreateReceipt(box.createReceipt?.());
     return {
         id: environmentId,
         provider: providerName,
+        ...(creation === undefined ? {} : { creation }),
         ...(box.name ? { name: boundedString(box.name, "Tangle environment name") } : {}),
         ...(box.metadata ? { metadata: snapshotMetadata(box.metadata) } : {}),
         capabilities,
@@ -302,11 +304,3 @@ export async function sandboxInstanceAsEnvironment(box, providerName, client, de
 function snapshotMetadata(metadata) {
     return deepFreeze(structuredClone(metadata));
 }
-function deepFreeze(value, seen = new Set()) {
-    if (value === null || typeof value !== "object" || seen.has(value))
-        return value;
-    seen.add(value);
-    for (const child of Object.values(value))
-        deepFreeze(child, seen);
-    return Object.freeze(value);
-}

package/dist/tangle-types.d.ts

@@ -1,6 +1,16 @@
 import type { BackendRegistryEntry, BackendRegistryResponse, BackendType, CreateSandboxOptions, ExecResult as SandboxExecResult, PromptOptions, PromptResult, SandboxEvent } from "@tangle-network/sandbox";
 import type { AgentRunCancellationAcknowledgement, AgentRunCancellationRequest, AgentExecutionPreparationReceipt, AgentInteractiveSessionControlClaim, AgentInteractiveSessionControlClaimAcknowledgement, AgentInteractiveSessionControlClaimRequest, AgentInteractiveSessionPromptAcknowledgement, AgentInteractiveSessionPromptCommand, AgentInteractiveSessionStopAcknowledgement, AgentInteractiveSessionStopCommand, AgentProfile, InputPart, InteractionRequest, InteractionResponseCommand } from "@tangle-network/agent-interface";
 import type { AgentEnvironmentCapabilities, AgentEnvironmentProvider, CreateAgentEnvironmentInput } from "@tangle-network/agent-interface/environment-provider";
+/**
+ * The platform verdict for the create call that returned a sandbox.
+ * `created` means the call allocated the sandbox; `idempotent_replay` means an
+ * earlier call with the same idempotency key allocated it; `unknown` means the
+ * platform cannot prove either outcome.
+ */
+export interface SandboxCreateReceiptLike {
+    outcome: "created" | "idempotent_replay" | "unknown";
+    idempotencyKeyApplied: boolean;
+}
 export interface TangleExactProcessOptions {
     teamId?: string;
 }
@@ -367,6 +377,12 @@ export interface SandboxInstanceLike {
     resourceUsage?(): Promise<SandboxResourceUsageLike | null>;
     /** Interactive terminal transport. Absent on a client that cannot serve a PTY. */
     terminals?: SandboxTerminalsLike;
+    /**
+     * The platform verdict for the create call that returned this instance.
+     * Absent on a Sandbox SDK older than 0.30.1; null for an instance resolved
+     * by id or when the platform reported no receipt.
+     */
+    createReceipt?(): SandboxCreateReceiptLike | null;
     refresh?(options?: {
         signal?: AbortSignal;
     }): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-provider-tangle",
-  "version": "0.13.0",
+  "version": "0.13.2",
   "description": "AgentEnvironmentProvider adapter for Tangle sandboxes",
   "type": "module",
   "license": "MIT",
@@ -85,7 +85,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@tangle-network/agent-interface": "^1.0.1"
+    "@tangle-network/agent-interface": "^1.5.0"
   },
   "peerDependencies": {
     "@tangle-network/sandbox": ">=0.30.1 <1.0.0"
@@ -102,7 +102,7 @@
     "@types/node": "25.6.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.5",
-    "@tangle-network/agent-provider-testkit": "0.8.3"
+    "@tangle-network/agent-provider-testkit": "0.8.4"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",