@tangle-network/agent-interface 3.1.2 → 4.0.0

package/README.md

@@ -102,6 +102,8 @@ Partial input or output always requires explicit user or policy acceptance, even
 `ContextTransferRequest` binds an operation identifier to that accepted plan, while `ContextTransferResult` distinguishes first admission, exact replay, changed-input conflict, and unknown transport outcome.
 `contextTransferResultMatchesRequest()` checks the operation identifier and request digest for every outcome before a caller accepts, retries, or reports it.
 Its successful receipt repeats the exact destination and carries the provider's session-creation operation and timestamp, identifying the one fresh provider session that admitted the context.
+An accepted destination may omit `environmentId` when the provider allocates that identity. The receipt preserves the original destination and binds its actual fresh `environmentId`; a prebound destination still requires exact equality. Unbound creation requires the inline `profile` with its accepted canonical digest. Optional `workspace` and `resources` inputs are frozen into the transfer request digest, so changed retries conflict.
+
 Providers expose this operation through `AgentEnvironmentProvider.contextTransfer`.
 They advertise `contextTransfer` only when transfer, retry idempotency, and lookup are all durable.
 An accepted destination can set `CreateAgentEnvironmentInput.requestedId` to bind environment creation to its exact identifier.
@@ -323,3 +325,70 @@ Adapters emit `native.session.observed` with `provider` and `nativeSessionId` af
 The execution owner binds the observation to its execution and keeps it private.
 Public `session.updated` events retain their resume-key semantics and do not establish native identity.
 Native identity does not establish artifact capture completeness.
+
+### Optional native learning state interchange
+
+`@tangle-network/agent-interface/learning-state` describes an **opt-in** boundary
+between a host's existing durable state owner and one explicitly configured
+harness adapter. Native harness memory stays the default. This module creates no
+store, tools, provider connection, profile fields, or automatic synchronization.
+Hindsight memory branches and QMD source snapshots keep their existing
+`agent-knowledge` owners and references; do not copy their facts into a second
+file database to satisfy this contract.
+
+`AgentLearningIdentity` names an authenticated workspace, stable state, and
+personal member/agent or shared group/agent scope. A thread, native session,
+profile revision, or authority digest is not that identity. The host derives it
+from authenticated context and verifies the persisted root/volume binding;
+passing schema validation does not authorize access. Session and turn IDs belong
+in invocation provenance. Two turns need immutable per-turn state pins plus the
+state owner's lease or compare-and-swap, not an uncoordinated shared writable home.
+
+`AgentLearningManifest` references the existing owner's exact revision and
+content digest. The `files` field is only a bounded, protected-home-compatible
+text exchange subset: `USER.md` preferences, `MEMORY.md` facts,
+`memory/YYYY-MM-DD.md` notes, and `skills/<slug>/SKILL.md` procedure sources. These
+are interchange names, never a claim about a harness's actual native paths or a
+universal memory model. An adapter must explicitly map and verify this subset.
+A native-only adapter may leave `files` empty and preserve opaque native state
+references instead. Opaque references must resolve privately to verified bytes;
+they must not contain paths, credentials, or access tokens.
+
+A manifest digest uses the existing canonical candidate JSON/SHA-256 primitives.
+Inventory order is immaterial; exact text, provenance, scope and owner revision
+are bound. Content digests establish bytes, not factual truth or authorization.
+Imported content retains `source.trust: 'untrusted'`. Skill text may be retained
+and exposed as personal context under the caller's existing policy; this never
+automatically activates executable resources, expands permissions, or promotes a
+shared skill catalog. Those effects remain behind the existing profile/authority
+and promotion gates.
+
+`AgentLearningExport` binds one idempotent operation to the exact immutable base
+digest, harness, and adapter ID/revision. Files are explicit observed deltas;
+omission is not deletion, and `content: null` is a tombstone. The durable owner
+must retain deletion evidence or refuse a tombstone it cannot persist. Retrying
+an operation requires the same bytes and digest. A three-way merge may retain
+unrelated concurrent edits; edit/edit or edit/delete collisions must be explicit,
+never last-writer-wins. Apply with CAS against the latest owner revision, record
+the durable receipt through the existing owner's transaction/journal, then
+publish success. A plan or local checkpoint is not a remote durability receipt.
+Rollback creates a new guarded revision; historical pins remain immutable.
+
+#### Adding a harness adapter
+
+1. Declare exact harness and adapter ID/revision. Import and export kinds are
+   separate explicit lists. Missing support is refused; a new harness inherits
+   no learning capability from its session, filesystem, or skill support.
+2. Bind authenticated stable identity to actual retained storage. Define native
+   scope, lease/exclusive-access rules, resume, relocation and cleanup behavior.
+   Keep native-only state intact without exporting the whole home or credentials.
+3. Prefer native preservation. Add portable mappings only when intentionally
+   configured and lossless for the declared subset. State which native data is
+   opaque or unsupported; do not pretend every harness field maps one-to-one.
+4. Exercise a real filesystem fixture across write, session restart and restored
+   root; cover stale CAS, concurrent edits, explicit deletion, replay, conflict,
+   rollback, malformed/oversized input, symlinks and cross-scope isolation.
+5. Bind `nativeState.conformanceDigest` to retained evidence and label
+   `qualification: 'fixture'` or `'native-binary'` honestly. A fixture is not proof
+   of an external CLI binary or deployed volume. Complete native-binary and
+   deployment qualification before advertising those stronger guarantees.

package/dist/environment-requests.d.ts

@@ -104,6 +104,14 @@ export interface ResourceRequest {
     gpu?: string;
     providerOptions?: Record<string, unknown>;
 }
+/** The resource request used by environment creation and accepted transfers. */
+export declare const ResourceRequestSchema: z.ZodObject<{
+    cpu: z.ZodOptional<z.ZodNumber>;
+    memoryMb: z.ZodOptional<z.ZodNumber>;
+    diskMb: z.ZodOptional<z.ZodNumber>;
+    gpu: z.ZodOptional<z.ZodString>;
+    providerOptions: z.ZodOptional<z.ZodCustom<Record<string, unknown>, Record<string, unknown>>>;
+}, z.core.$strict>;
 export interface AgentEnvironmentQuery {
     name?: string;
     metadata?: Record<string, unknown>;

package/dist/environment-requests.js

@@ -63,3 +63,11 @@ export const WorkspaceRequestSchema = z
         });
     }
 });
+/** The resource request used by environment creation and accepted transfers. */
+export const ResourceRequestSchema = z.strictObject({
+    cpu: z.number().finite().positive().max(Number.MAX_SAFE_INTEGER).optional(),
+    memoryMb: z.number().int().positive().max(Number.MAX_SAFE_INTEGER).optional(),
+    diskMb: z.number().int().positive().max(Number.MAX_SAFE_INTEGER).optional(),
+    gpu: boundedIdentifierSchema.optional(),
+    providerOptions: boundedJsonRecordSchema.optional(),
+});

package/dist/environment-runtime.d.ts

@@ -348,7 +348,7 @@ export declare const AgentTurnInputSchema: z.ZodObject<{
             destination: z.ZodObject<{
                 runner: z.ZodString;
                 provider: z.ZodString;
-                environmentId: z.ZodString;
+                environmentId: z.ZodOptional<z.ZodString>;
                 sessionId: z.ZodString;
                 runId: z.ZodString;
                 executionId: z.ZodString;
@@ -437,6 +437,268 @@ export declare const AgentTurnInputSchema: z.ZodObject<{
                 user: "user";
             }>;
         }, z.core.$strict>;
+        profile: z.ZodOptional<z.ZodObject<{
+            name: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            version: z.ZodOptional<z.ZodString>;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            prompt: z.ZodOptional<z.ZodObject<{
+                systemPrompt: z.ZodOptional<z.ZodString>;
+                appendSystemPrompt: z.ZodOptional<z.ZodString>;
+                instructions: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$strict>>;
+            model: z.ZodOptional<z.ZodObject<{
+                default: z.ZodOptional<z.ZodString>;
+                small: z.ZodOptional<z.ZodString>;
+                provider: z.ZodOptional<z.ZodString>;
+                reasoningEffort: z.ZodOptional<z.ZodEnum<{
+                    high: "high";
+                    low: "low";
+                    medium: "medium";
+                    minimal: "minimal";
+                    none: "none";
+                    ultracode: "ultracode";
+                    xhigh: "xhigh";
+                }>>;
+                maxVisibleOutputTokens: z.ZodOptional<z.ZodNumber>;
+                maxReasoningTokens: z.ZodOptional<z.ZodNumber>;
+                maxTotalOutputTokens: z.ZodOptional<z.ZodNumber>;
+                metadata: z.ZodOptional<z.ZodType<Record<string, unknown>, unknown, z.core.$ZodTypeInternals<Record<string, unknown>, unknown>>>;
+            }, z.core.$strict>>;
+            harness: z.ZodOptional<z.ZodEnum<{
+                acp: "acp";
+                amp: "amp";
+                "claude-code": "claude-code";
+                "cli-base": "cli-base";
+                codex: "codex";
+                cursor: "cursor";
+                "factory-droids": "factory-droids";
+                forge: "forge";
+                gemini: "gemini";
+                hermes: "hermes";
+                "kimi-code": "kimi-code";
+                nanoclaw: "nanoclaw";
+                openclaw: "openclaw";
+                opencode: "opencode";
+                pi: "pi";
+                prime: "prime";
+            }>>;
+            seats: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                harness: z.ZodEnum<{
+                    acp: "acp";
+                    amp: "amp";
+                    "claude-code": "claude-code";
+                    "cli-base": "cli-base";
+                    codex: "codex";
+                    cursor: "cursor";
+                    "factory-droids": "factory-droids";
+                    forge: "forge";
+                    gemini: "gemini";
+                    hermes: "hermes";
+                    "kimi-code": "kimi-code";
+                    nanoclaw: "nanoclaw";
+                    openclaw: "openclaw";
+                    opencode: "opencode";
+                    pi: "pi";
+                    prime: "prime";
+                }>;
+                provider: z.ZodString;
+                model: z.ZodString;
+                selector: z.ZodUnion<readonly [z.ZodObject<{
+                    kind: z.ZodLiteral<"all-eligible">;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"seat">;
+                    id: z.ZodString;
+                }, z.core.$strict>]>;
+                tools: z.ZodOptional<z.ZodType<Record<string, boolean>, unknown, z.core.$ZodTypeInternals<Record<string, boolean>, unknown>>>;
+                permissions: z.ZodOptional<z.ZodType<Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">>, unknown, z.core.$ZodTypeInternals<Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">>, unknown>>>;
+            }, z.core.$strict>>>;
+            permissions: z.ZodOptional<z.ZodType<Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">>, unknown, z.core.$ZodTypeInternals<Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">>, unknown>>>;
+            tools: z.ZodOptional<z.ZodType<Record<string, boolean>, unknown, z.core.$ZodTypeInternals<Record<string, boolean>, unknown>>>;
+            mcp: z.ZodOptional<z.ZodType<Record<string, import("./agent-profile.js").AgentProfileMcpServer>, unknown, z.core.$ZodTypeInternals<Record<string, import("./agent-profile.js").AgentProfileMcpServer>, unknown>>>;
+            connections: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                connectionId: z.ZodString;
+                capabilities: z.ZodArray<z.ZodString>;
+                alias: z.ZodOptional<z.ZodString>;
+            }, z.core.$strict>>>;
+            subagents: z.ZodOptional<z.ZodType<Record<string, {
+                description?: string | undefined;
+                prompt?: string | undefined;
+                model?: string | undefined;
+                tools?: Record<string, boolean> | undefined;
+                permissions?: Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">> | undefined;
+                maxSteps?: number | undefined;
+                metadata?: Record<string, unknown> | undefined;
+            }>, unknown, z.core.$ZodTypeInternals<Record<string, {
+                description?: string | undefined;
+                prompt?: string | undefined;
+                model?: string | undefined;
+                tools?: Record<string, boolean> | undefined;
+                permissions?: Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">> | undefined;
+                maxSteps?: number | undefined;
+                metadata?: Record<string, unknown> | undefined;
+            }>, unknown>>>;
+            resources: z.ZodOptional<z.ZodObject<{
+                files: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    path: z.ZodString;
+                    resource: z.ZodUnion<readonly [z.ZodObject<{
+                        kind: z.ZodLiteral<"inline">;
+                        name: z.ZodString;
+                        content: z.ZodString;
+                    }, z.core.$strict>, z.ZodObject<{
+                        kind: z.ZodLiteral<"github">;
+                        repository: z.ZodOptional<z.ZodString>;
+                        path: z.ZodString;
+                        ref: z.ZodOptional<z.ZodString>;
+                        name: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strict>]>;
+                    executable: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strict>>>;
+                tools: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                    kind: z.ZodLiteral<"inline">;
+                    name: z.ZodString;
+                    content: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"github">;
+                    repository: z.ZodOptional<z.ZodString>;
+                    path: z.ZodString;
+                    ref: z.ZodOptional<z.ZodString>;
+                    name: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>]>>>;
+                skills: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                    kind: z.ZodLiteral<"inline">;
+                    name: z.ZodString;
+                    content: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"github">;
+                    repository: z.ZodOptional<z.ZodString>;
+                    path: z.ZodString;
+                    ref: z.ZodOptional<z.ZodString>;
+                    name: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>]>>>;
+                agents: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                    kind: z.ZodLiteral<"inline">;
+                    name: z.ZodString;
+                    content: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"github">;
+                    repository: z.ZodOptional<z.ZodString>;
+                    path: z.ZodString;
+                    ref: z.ZodOptional<z.ZodString>;
+                    name: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>]>>>;
+                commands: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+                    kind: z.ZodLiteral<"inline">;
+                    name: z.ZodString;
+                    content: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"github">;
+                    repository: z.ZodOptional<z.ZodString>;
+                    path: z.ZodString;
+                    ref: z.ZodOptional<z.ZodString>;
+                    name: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>]>>>;
+                instructions: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+                    kind: z.ZodLiteral<"inline">;
+                    name: z.ZodString;
+                    content: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"github">;
+                    repository: z.ZodOptional<z.ZodString>;
+                    path: z.ZodString;
+                    ref: z.ZodOptional<z.ZodString>;
+                    name: z.ZodOptional<z.ZodString>;
+                }, z.core.$strict>]>]>>;
+                failOnError: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
+            hooks: z.ZodOptional<z.ZodType<Record<string, {
+                command: string;
+                timeoutMs?: number | undefined;
+                blocking?: boolean | undefined;
+                matcher?: string | undefined;
+                env?: Record<string, {
+                    kind: "public";
+                    value: string;
+                } | {
+                    kind: "secret-ref";
+                    key: string;
+                    format?: "bearer" | "raw" | undefined;
+                }> | undefined;
+            }[]>, unknown, z.core.$ZodTypeInternals<Record<string, {
+                command: string;
+                timeoutMs?: number | undefined;
+                blocking?: boolean | undefined;
+                matcher?: string | undefined;
+                env?: Record<string, {
+                    kind: "public";
+                    value: string;
+                } | {
+                    kind: "secret-ref";
+                    key: string;
+                    format?: "bearer" | "raw" | undefined;
+                }> | undefined;
+            }[]>, unknown>>>;
+            modes: z.ZodOptional<z.ZodType<Record<string, {
+                description?: string | undefined;
+                model?: string | undefined;
+                prompt?: string | undefined;
+                tools?: Record<string, boolean> | undefined;
+                permissions?: Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">> | undefined;
+                metadata?: Record<string, unknown> | undefined;
+            }>, unknown, z.core.$ZodTypeInternals<Record<string, {
+                description?: string | undefined;
+                model?: string | undefined;
+                prompt?: string | undefined;
+                tools?: Record<string, boolean> | undefined;
+                permissions?: Record<string, "allow" | "ask" | "deny" | Record<string, "allow" | "ask" | "deny">> | undefined;
+                metadata?: Record<string, unknown> | undefined;
+            }>, unknown>>>;
+            confidential: z.ZodOptional<z.ZodObject<{
+                tee: z.ZodOptional<z.ZodString>;
+                attestationNonce: z.ZodOptional<z.ZodString>;
+                sealed: z.ZodOptional<z.ZodBoolean>;
+                attestationRefresh: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strict>>;
+            metadata: z.ZodOptional<z.ZodType<import("./agent-profile.js").AgentProfileMetadata, unknown, z.core.$ZodTypeInternals<import("./agent-profile.js").AgentProfileMetadata, unknown>>>;
+            extensions: z.ZodOptional<z.ZodType<Record<string, Record<string, unknown> | undefined>, unknown, z.core.$ZodTypeInternals<Record<string, Record<string, unknown> | undefined>, unknown>>>;
+        }, z.core.$strict>>;
+        workspace: z.ZodOptional<z.ZodObject<{
+            environment: z.ZodOptional<z.ZodString>;
+            image: z.ZodOptional<z.ZodString>;
+            repoUrl: z.ZodOptional<z.ZodString>;
+            gitRef: z.ZodOptional<z.ZodString>;
+            cwd: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                base: z.ZodLiteral<"repository">;
+                path: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+            }, z.core.$strict>, z.ZodObject<{
+                base: z.ZodLiteral<"host">;
+                path: z.ZodString;
+            }, z.core.$strict>], "base">>;
+            checkpoint: z.ZodOptional<z.ZodObject<{
+                checkpointId: z.ZodString;
+                provider: z.ZodString;
+                source: z.ZodObject<{
+                    runId: z.ZodString;
+                    provider: z.ZodString;
+                    environmentId: z.ZodString;
+                    sessionId: z.ZodString;
+                    executionId: z.ZodString;
+                    requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
+                }, z.core.$strict>;
+                idempotencyKey: z.ZodString;
+                requestDigest: z.ZodType<`sha256:${string}`, unknown, z.core.$ZodTypeInternals<`sha256:${string}`, unknown>>;
+                createdAt: z.ZodISODateTime;
+                metadata: z.ZodOptional<z.ZodCustom<Record<string, unknown>, Record<string, unknown>>>;
+            }, z.core.$strict>>;
+            providerOptions: z.ZodOptional<z.ZodCustom<Record<string, unknown>, Record<string, unknown>>>;
+        }, z.core.$strict>>;
+        resources: z.ZodOptional<z.ZodObject<{
+            cpu: z.ZodOptional<z.ZodNumber>;
+            memoryMb: z.ZodOptional<z.ZodNumber>;
+            diskMb: z.ZodOptional<z.ZodNumber>;
+            gpu: z.ZodOptional<z.ZodString>;
+            providerOptions: z.ZodOptional<z.ZodCustom<Record<string, unknown>, Record<string, unknown>>>;
+        }, z.core.$strict>>;
     }, z.core.$strict>>;
     nativeContinuation: z.ZodOptional<z.ZodObject<{
         operationId: z.ZodString;
@@ -552,7 +814,7 @@ export declare const AgentTurnResultSchema: z.ZodObject<{
         destination: z.ZodObject<{
             runner: z.ZodString;
             provider: z.ZodString;
-            environmentId: z.ZodString;
+            environmentId: z.ZodOptional<z.ZodString>;
             sessionId: z.ZodString;
             runId: z.ZodString;
             executionId: z.ZodString;
@@ -588,7 +850,7 @@ export declare const AgentTurnResultSchema: z.ZodObject<{
         destination: z.ZodObject<{
             runner: z.ZodString;
             provider: z.ZodString;
-            environmentId: z.ZodString;
+            environmentId: z.ZodOptional<z.ZodString>;
             sessionId: z.ZodString;
             runId: z.ZodString;
             executionId: z.ZodString;
@@ -708,7 +970,7 @@ export declare const AgentNativeContextContinuationResultSchema: z.ZodUnion<read
             destination: z.ZodObject<{
                 runner: z.ZodString;
                 provider: z.ZodString;
-                environmentId: z.ZodString;
+                environmentId: z.ZodOptional<z.ZodString>;
                 sessionId: z.ZodString;
                 runId: z.ZodString;
                 executionId: z.ZodString;
@@ -744,7 +1006,7 @@ export declare const AgentNativeContextContinuationResultSchema: z.ZodUnion<read
             destination: z.ZodObject<{
                 runner: z.ZodString;
                 provider: z.ZodString;
-                environmentId: z.ZodString;
+                environmentId: z.ZodOptional<z.ZodString>;
                 sessionId: z.ZodString;
                 runId: z.ZodString;
                 executionId: z.ZodString;
@@ -1106,6 +1368,8 @@ export interface AgentEnvironmentCapabilities {
      * exactly that, instead of advertising an egress mode it does not accept.
      */
     create?: {
+        /** The provider durably binds keyed create input and can reconstruct it after restart. */
+        durableIdempotency?: boolean;
         /**
          * Egress modes create accepts, each named once. A mode absent here is refused, never weakened
          * or widened. Absent altogether means create does not read
@@ -1268,6 +1532,7 @@ export declare const AgentEnvironmentCapabilitiesSchema: z.ZodObject<{
             open: "open";
             strict: "strict";
         }>>>;
+        durableIdempotency: z.ZodOptional<z.ZodBoolean>;
         billingOwner: z.ZodOptional<z.ZodBoolean>;
         runtimeAttachments: z.ZodOptional<z.ZodObject<{
             mcp: z.ZodLiteral<true>;

package/dist/environment-runtime.js

@@ -241,6 +241,7 @@ export const AgentEnvironmentCapabilitiesSchema = z
             .min(1)
             .max(CONTRACT_MAX_ARRAY_LENGTH)
             .optional(),
+        durableIdempotency: z.boolean().optional(),
         billingOwner: z.boolean().optional(),
         runtimeAttachments: z.strictObject({ mcp: z.literal(true) }).optional(),
         workspaceCheckpoint: z.boolean().optional(),
@@ -350,7 +351,8 @@ export const AgentEnvironmentCapabilitiesSchema = z
     }
     const create = capabilities.create;
     if (create !== undefined) {
-        if (create.egress === undefined &&
+        if (create.durableIdempotency === undefined &&
+            create.egress === undefined &&
             create.billingOwner === undefined &&
             create.runtimeAttachments === undefined &&
             create.workspaceCheckpoint === undefined) {

package/dist/index.d.ts

@@ -9,7 +9,7 @@ export * from "./host-services.js";
 export * from "./mcp.js";
 export * from "./provider-adapter.js";
 export type * from "./environment-provider.js";
-export { AgentEnvironmentCapabilitiesSchema, AgentRuntimeAttachmentsSchema, AgentNativeContextContinuationAdmissionSchema, AgentNativeContextContinuationResultSchema, AgentTurnInputSchema, AgentTurnResultSchema, agentEnvironmentCreateInputDigest, agentNativeContextContinuationAdmissionMatchesRequest, agentNativeContextContinuationResultMatchesRequest, AccountUsageSchema, AgentEnvironmentObservationSchema, AgentEnvironmentStatusSchema, ComputeBillingSchema, EnvironmentLifecycleSchema, ModelUsageSchema, ObservationProvenanceSchema, PlacementDescriptorSchema, ProviderIdentitySchema, ResourceProfileSchema, ResourceUseSampleSchema, SafeEndpointSchema, agentEnvironmentObservationIdentityMatches, observationContainsCredential, observationOf, AgentInteractiveSessionAttachSchema, AgentInteractiveSessionControlClaimAcknowledgementSchema, AgentInteractiveSessionControlClaimRequestSchema, AgentInteractiveSessionControlClaimSchema, AgentInteractiveSessionPromptAcknowledgementSchema, AgentInteractiveSessionPromptCommandSchema, AgentInteractiveSessionRefSchema, AgentInteractiveSessionStartSchema, AgentInteractiveSessionStopAcknowledgementSchema, AgentInteractiveSessionStopCommandSchema, AgentInteractiveSessionStatusSchema, agentInteractiveSessionControlClaimAcknowledgementMatchesRequest, agentInteractiveSessionControlClaimRequestDigest, agentInteractiveSessionControlClaimMatchesRef, agentInteractiveSessionControlClaimIsNewer, agentInteractiveSessionPromptAcknowledgementMatchesCommand, agentInteractiveSessionPromptRequestDigest, agentInteractiveSessionStopAcknowledgementMatchesCommand, agentInteractiveSessionStopRequestDigest, agentInteractiveSessionRefMatchesStart, agentInteractiveSessionRunRef, agentInteractiveSessionStatusMatchesRef, exactAgentInteractiveSessionStart, createAgentEnvironmentWithIdempotency, canonicalWorkspaceCwd, MAX_WORKSPACE_CWD_LENGTH, workspaceCwdSchema, workspaceCwdPathForBase, WorkspaceRequestSchema, TerminalAttachRequestSchema, TerminalAttachResultSchema, TerminalDetachAckSchema, TerminalInputSchema, TerminalOutputEventSchema, TerminalReplayWindowSchema, TerminalResizeSchema, TerminalSessionRefSchema, terminalAttachResultMatchesRequest, terminalSessionUsable, } from "./environment-provider.js";
+export { AgentEnvironmentCapabilitiesSchema, AgentRuntimeAttachmentsSchema, AgentNativeContextContinuationAdmissionSchema, AgentNativeContextContinuationResultSchema, AgentTurnInputSchema, AgentTurnResultSchema, agentEnvironmentCreateInputDigest, agentNativeContextContinuationAdmissionMatchesRequest, agentNativeContextContinuationResultMatchesRequest, AccountUsageSchema, AgentEnvironmentObservationSchema, AgentEnvironmentStatusSchema, ComputeBillingSchema, EnvironmentLifecycleSchema, ModelUsageSchema, ObservationProvenanceSchema, PlacementDescriptorSchema, ProviderIdentitySchema, ResourceProfileSchema, ResourceUseSampleSchema, SafeEndpointSchema, agentEnvironmentObservationIdentityMatches, observationContainsCredential, observationOf, AgentInteractiveSessionAttachSchema, AgentInteractiveSessionControlClaimAcknowledgementSchema, AgentInteractiveSessionControlClaimRequestSchema, AgentInteractiveSessionControlClaimSchema, AgentInteractiveSessionPromptAcknowledgementSchema, AgentInteractiveSessionPromptCommandSchema, AgentInteractiveSessionRefSchema, AgentInteractiveSessionStartSchema, AgentInteractiveSessionStopAcknowledgementSchema, AgentInteractiveSessionStopCommandSchema, AgentInteractiveSessionStatusSchema, agentInteractiveSessionControlClaimAcknowledgementMatchesRequest, agentInteractiveSessionControlClaimRequestDigest, agentInteractiveSessionControlClaimMatchesRef, agentInteractiveSessionControlClaimIsNewer, agentInteractiveSessionPromptAcknowledgementMatchesCommand, agentInteractiveSessionPromptRequestDigest, agentInteractiveSessionStopAcknowledgementMatchesCommand, agentInteractiveSessionStopRequestDigest, agentInteractiveSessionRefMatchesStart, agentInteractiveSessionRunRef, agentInteractiveSessionStatusMatchesRef, exactAgentInteractiveSessionStart, createAgentEnvironmentWithIdempotency, canonicalWorkspaceCwd, MAX_WORKSPACE_CWD_LENGTH, workspaceCwdSchema, workspaceCwdPathForBase, WorkspaceRequestSchema, ResourceRequestSchema, TerminalAttachRequestSchema, TerminalAttachResultSchema, TerminalDetachAckSchema, TerminalInputSchema, TerminalOutputEventSchema, TerminalReplayWindowSchema, TerminalResizeSchema, TerminalSessionRefSchema, terminalAttachResultMatchesRequest, terminalSessionUsable, } from "./environment-provider.js";
 export * from "./plan.js";
 export * from "./runtime-control.js";
 export * from "./portable-context.js";
@@ -43,3 +43,4 @@ export * from "./sandbox-size.js";
 export { CONTRACT_MAX_ARRAY_LENGTH, CONTRACT_MAX_CONFIDENTIAL_ATTESTATION_QUOTE_LENGTH, CONTRACT_MAX_IDENTIFIER_LENGTH, CONTRACT_MAX_JSON_BYTES, CONTRACT_MAX_JSON_DEPTH, CONTRACT_MAX_JSON_NODES, CONTRACT_MAX_MAP_ENTRIES, CONTRACT_MAX_STRING_LENGTH, boundedEventContentJsonSchema, boundedEventContentRecordSchema, boundedEventContentStringSchema, isBoundedEventContentJson, } from "./contract-limits.js";
 export { AgentEnvironmentEgressPolicySchema } from "./environment-requests.js";
 export * from "./native-session-event.js";
+export * from "./learning-state.js";

package/dist/index.js

@@ -8,7 +8,7 @@ export * from "./provider-config.js";
 export * from "./host-services.js";
 export * from "./mcp.js";
 export * from "./provider-adapter.js";
-export { AgentEnvironmentCapabilitiesSchema, AgentRuntimeAttachmentsSchema, AgentNativeContextContinuationAdmissionSchema, AgentNativeContextContinuationResultSchema, AgentTurnInputSchema, AgentTurnResultSchema, agentEnvironmentCreateInputDigest, agentNativeContextContinuationAdmissionMatchesRequest, agentNativeContextContinuationResultMatchesRequest, AccountUsageSchema, AgentEnvironmentObservationSchema, AgentEnvironmentStatusSchema, ComputeBillingSchema, EnvironmentLifecycleSchema, ModelUsageSchema, ObservationProvenanceSchema, PlacementDescriptorSchema, ProviderIdentitySchema, ResourceProfileSchema, ResourceUseSampleSchema, SafeEndpointSchema, agentEnvironmentObservationIdentityMatches, observationContainsCredential, observationOf, AgentInteractiveSessionAttachSchema, AgentInteractiveSessionControlClaimAcknowledgementSchema, AgentInteractiveSessionControlClaimRequestSchema, AgentInteractiveSessionControlClaimSchema, AgentInteractiveSessionPromptAcknowledgementSchema, AgentInteractiveSessionPromptCommandSchema, AgentInteractiveSessionRefSchema, AgentInteractiveSessionStartSchema, AgentInteractiveSessionStopAcknowledgementSchema, AgentInteractiveSessionStopCommandSchema, AgentInteractiveSessionStatusSchema, agentInteractiveSessionControlClaimAcknowledgementMatchesRequest, agentInteractiveSessionControlClaimRequestDigest, agentInteractiveSessionControlClaimMatchesRef, agentInteractiveSessionControlClaimIsNewer, agentInteractiveSessionPromptAcknowledgementMatchesCommand, agentInteractiveSessionPromptRequestDigest, agentInteractiveSessionStopAcknowledgementMatchesCommand, agentInteractiveSessionStopRequestDigest, agentInteractiveSessionRefMatchesStart, agentInteractiveSessionRunRef, agentInteractiveSessionStatusMatchesRef, exactAgentInteractiveSessionStart, createAgentEnvironmentWithIdempotency, canonicalWorkspaceCwd, MAX_WORKSPACE_CWD_LENGTH, workspaceCwdSchema, workspaceCwdPathForBase, WorkspaceRequestSchema, TerminalAttachRequestSchema, TerminalAttachResultSchema, TerminalDetachAckSchema, TerminalInputSchema, TerminalOutputEventSchema, TerminalReplayWindowSchema, TerminalResizeSchema, TerminalSessionRefSchema, terminalAttachResultMatchesRequest, terminalSessionUsable, } from "./environment-provider.js";
+export { AgentEnvironmentCapabilitiesSchema, AgentRuntimeAttachmentsSchema, AgentNativeContextContinuationAdmissionSchema, AgentNativeContextContinuationResultSchema, AgentTurnInputSchema, AgentTurnResultSchema, agentEnvironmentCreateInputDigest, agentNativeContextContinuationAdmissionMatchesRequest, agentNativeContextContinuationResultMatchesRequest, AccountUsageSchema, AgentEnvironmentObservationSchema, AgentEnvironmentStatusSchema, ComputeBillingSchema, EnvironmentLifecycleSchema, ModelUsageSchema, ObservationProvenanceSchema, PlacementDescriptorSchema, ProviderIdentitySchema, ResourceProfileSchema, ResourceUseSampleSchema, SafeEndpointSchema, agentEnvironmentObservationIdentityMatches, observationContainsCredential, observationOf, AgentInteractiveSessionAttachSchema, AgentInteractiveSessionControlClaimAcknowledgementSchema, AgentInteractiveSessionControlClaimRequestSchema, AgentInteractiveSessionControlClaimSchema, AgentInteractiveSessionPromptAcknowledgementSchema, AgentInteractiveSessionPromptCommandSchema, AgentInteractiveSessionRefSchema, AgentInteractiveSessionStartSchema, AgentInteractiveSessionStopAcknowledgementSchema, AgentInteractiveSessionStopCommandSchema, AgentInteractiveSessionStatusSchema, agentInteractiveSessionControlClaimAcknowledgementMatchesRequest, agentInteractiveSessionControlClaimRequestDigest, agentInteractiveSessionControlClaimMatchesRef, agentInteractiveSessionControlClaimIsNewer, agentInteractiveSessionPromptAcknowledgementMatchesCommand, agentInteractiveSessionPromptRequestDigest, agentInteractiveSessionStopAcknowledgementMatchesCommand, agentInteractiveSessionStopRequestDigest, agentInteractiveSessionRefMatchesStart, agentInteractiveSessionRunRef, agentInteractiveSessionStatusMatchesRef, exactAgentInteractiveSessionStart, createAgentEnvironmentWithIdempotency, canonicalWorkspaceCwd, MAX_WORKSPACE_CWD_LENGTH, workspaceCwdSchema, workspaceCwdPathForBase, WorkspaceRequestSchema, ResourceRequestSchema, TerminalAttachRequestSchema, TerminalAttachResultSchema, TerminalDetachAckSchema, TerminalInputSchema, TerminalOutputEventSchema, TerminalReplayWindowSchema, TerminalResizeSchema, TerminalSessionRefSchema, terminalAttachResultMatchesRequest, terminalSessionUsable, } from "./environment-provider.js";
 export * from "./plan.js";
 export * from "./runtime-control.js";
 export * from "./portable-context.js";
@@ -45,3 +45,4 @@ export {
 CONTRACT_MAX_ARRAY_LENGTH, CONTRACT_MAX_CONFIDENTIAL_ATTESTATION_QUOTE_LENGTH, CONTRACT_MAX_IDENTIFIER_LENGTH, CONTRACT_MAX_JSON_BYTES, CONTRACT_MAX_JSON_DEPTH, CONTRACT_MAX_JSON_NODES, CONTRACT_MAX_MAP_ENTRIES, CONTRACT_MAX_STRING_LENGTH, boundedEventContentJsonSchema, boundedEventContentRecordSchema, boundedEventContentStringSchema, isBoundedEventContentJson, } from "./contract-limits.js";
 export { AgentEnvironmentEgressPolicySchema } from "./environment-requests.js";
 export * from "./native-session-event.js";
+export * from "./learning-state.js";