asteroid-odyssey 1.7.516 → 1.7.523

package/dist/index.d.mts

@@ -3953,7 +3953,7 @@ type AgentsWorkflowExternalWorkflowSnapshot = {
      */
     author?: string;
     /**
-     * Monotonic optimistic-concurrency revision. Only meaningful for the editable head: supply it as baseRev on the next head patch; a stale baseRev is rejected with 409. Frozen snapshots never receive in-place patches.
+     * Monotonic optimistic-concurrency revision. Only meaningful for the editable head: supply it as baseRev on the next head patch. Agent-file-only patches overlay the current head if it has moved; structural-file patches are rejected with 409 when stale. Frozen snapshots never receive in-place patches.
      */
     rev: number;
     /**
@@ -4125,7 +4125,7 @@ type AgentsWorkflowWorkflowFileKind = "structural" | "agent_file";
  */
 type AgentsWorkflowWorkflowFileTree = {
     /**
-     * The revision the tree reflects. For the editable head, supply this as `baseRev` when patching; a stale value is rejected with 409.
+     * The revision the tree reflects. For the editable head, supply this as `baseRev` when patching. Agent-file-only patches overlay the current head if it has moved; structural-file patches are rejected with 409 when stale.
      */
     rev: number;
     /**
@@ -4167,11 +4167,11 @@ type AgentsWorkflowWorkflowFileWrite = {
     contentBase64: string;
 };
 /**
- * Request to patch the editable head's file representation. The server classifies each path: structural files re-derive the structured workflow, the agent's own files (memory, uploads, node scripts) go to their blob store — the client just writes files. Rev-guarded by `baseRev`: a stale value is rejected with 409.
+ * Request to patch the editable head's file representation. The server classifies each path: structural files re-derive the structured workflow, the agent's own files (memory, uploads, node scripts) go to their blob store. Agent-file writes overlay the head resolved under the edit lock, so a stale baseRev is not rejected. Structural-file writes still require a matching baseRev; a stale value is rejected with 409.
  */
 type AgentsWorkflowWorkflowFilesPatchRequest = {
     /**
-     * The revision this edit is based on. The patch only applies when it still matches the stored head revision; otherwise it is rejected with 409.
+     * The revision this edit is based on. Agent-file-only patches overlay the current head even when this is stale. A structural-file patch is rejected with 409 when it does not match the stored head revision.
      */
     baseRev: number;
     /**
@@ -7001,7 +7001,7 @@ declare const agentWorkflowHeadGetFiles: <ThrowOnError extends boolean = false>(
 /**
  * Patch workflow head files
  *
- * Patch the editable head's file representation in place: apply file writes/deletes, re-derive the structured workflow, and persist it. Structural files re-derive the graph; agent files go to the blob store. Guarded by baseRev for optimistic concurrency. When the head is frozen (published or executed) the edit forks a fresh version behind the scenes.
+ * Patch the editable head's file representation in place: apply file writes/deletes, re-derive the structured workflow, and persist it. Structural files re-derive the graph; agent files go to the blob store. Agent-file writes overlay the current head even when baseRev is stale. Structural-file writes still require a matching baseRev. When the head is frozen (published or executed) the edit forks a fresh version behind the scenes.
  */
 declare const agentWorkflowHeadPatchFiles: <ThrowOnError extends boolean = false>(options: Options<AgentWorkflowHeadPatchFilesData, ThrowOnError>) => RequestResult<AgentWorkflowHeadPatchFilesResponses, AgentWorkflowHeadPatchFilesErrors, ThrowOnError>;
 /**

package/dist/index.d.ts

@@ -3953,7 +3953,7 @@ type AgentsWorkflowExternalWorkflowSnapshot = {
      */
     author?: string;
     /**
-     * Monotonic optimistic-concurrency revision. Only meaningful for the editable head: supply it as baseRev on the next head patch; a stale baseRev is rejected with 409. Frozen snapshots never receive in-place patches.
+     * Monotonic optimistic-concurrency revision. Only meaningful for the editable head: supply it as baseRev on the next head patch. Agent-file-only patches overlay the current head if it has moved; structural-file patches are rejected with 409 when stale. Frozen snapshots never receive in-place patches.
      */
     rev: number;
     /**
@@ -4125,7 +4125,7 @@ type AgentsWorkflowWorkflowFileKind = "structural" | "agent_file";
  */
 type AgentsWorkflowWorkflowFileTree = {
     /**
-     * The revision the tree reflects. For the editable head, supply this as `baseRev` when patching; a stale value is rejected with 409.
+     * The revision the tree reflects. For the editable head, supply this as `baseRev` when patching. Agent-file-only patches overlay the current head if it has moved; structural-file patches are rejected with 409 when stale.
      */
     rev: number;
     /**
@@ -4167,11 +4167,11 @@ type AgentsWorkflowWorkflowFileWrite = {
     contentBase64: string;
 };
 /**
- * Request to patch the editable head's file representation. The server classifies each path: structural files re-derive the structured workflow, the agent's own files (memory, uploads, node scripts) go to their blob store — the client just writes files. Rev-guarded by `baseRev`: a stale value is rejected with 409.
+ * Request to patch the editable head's file representation. The server classifies each path: structural files re-derive the structured workflow, the agent's own files (memory, uploads, node scripts) go to their blob store. Agent-file writes overlay the head resolved under the edit lock, so a stale baseRev is not rejected. Structural-file writes still require a matching baseRev; a stale value is rejected with 409.
  */
 type AgentsWorkflowWorkflowFilesPatchRequest = {
     /**
-     * The revision this edit is based on. The patch only applies when it still matches the stored head revision; otherwise it is rejected with 409.
+     * The revision this edit is based on. Agent-file-only patches overlay the current head even when this is stale. A structural-file patch is rejected with 409 when it does not match the stored head revision.
      */
     baseRev: number;
     /**
@@ -7001,7 +7001,7 @@ declare const agentWorkflowHeadGetFiles: <ThrowOnError extends boolean = false>(
 /**
  * Patch workflow head files
  *
- * Patch the editable head's file representation in place: apply file writes/deletes, re-derive the structured workflow, and persist it. Structural files re-derive the graph; agent files go to the blob store. Guarded by baseRev for optimistic concurrency. When the head is frozen (published or executed) the edit forks a fresh version behind the scenes.
+ * Patch the editable head's file representation in place: apply file writes/deletes, re-derive the structured workflow, and persist it. Structural files re-derive the graph; agent files go to the blob store. Agent-file writes overlay the current head even when baseRev is stale. Structural-file writes still require a matching baseRev. When the head is frozen (published or executed) the edit forks a fresh version behind the scenes.
  */
 declare const agentWorkflowHeadPatchFiles: <ThrowOnError extends boolean = false>(options: Options<AgentWorkflowHeadPatchFilesData, ThrowOnError>) => RequestResult<AgentWorkflowHeadPatchFilesResponses, AgentWorkflowHeadPatchFilesErrors, ThrowOnError>;
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "asteroid-odyssey",
-  "version": "1.7.516",
+  "version": "1.7.523",
   "description": "SDK for interacting with Asteroid Agents API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",