@covia/covia-sdk 1.24.1 → 1.24.2

package/README.md

@@ -408,6 +408,10 @@ await mina.delete();
 const clone = await mina.fork("Mina-v2", { includeTimeline: true });
 ```
 
+Create and fork require unused names. Use update to preserve an existing agent
+and its history. Deletion normally returns `status: "TERMINATED"`; physical
+removal (`remove: true`) returns `removed: true` without a status.
+
 #### Agent Instance
 
 | Method | Returns | Description |

package/dist/index.d.mts

@@ -46,7 +46,6 @@ declare class Agent {
     fork(agentId: string, options?: {
         config?: Record<string, unknown>;
         includeTimeline?: boolean;
-        overwrite?: boolean;
     }): Promise<Agent>;
     context(task?: unknown): Promise<string>;
     delete(remove?: boolean): Promise<AgentDeleteResult>;
@@ -1722,19 +1721,16 @@ declare enum AgentStatus {
     SUSPENDED = "SUSPENDED",
     TERMINATED = "TERMINATED"
 }
+/** Creates a new name only. Use update to preserve an existing agent and its history. */
 interface AgentCreateInput {
     agentId: string;
     config?: Record<string, any>;
     state?: Record<string, any>;
-    overwrite?: boolean;
 }
 interface AgentCreateResult {
     agentId: string;
     status: string;
-    created: boolean;
-    /** True when an existing SLEEPING/SUSPENDED record was updated in place
-     *  (mutually exclusive with created). Absent on venues before 0.4. */
-    updated?: boolean;
+    address?: string;
     /** Non-fatal advisories (venue 0.5+): present only when the config looks
      *  misconfigured but create still succeeded — e.g. an Ollama model whose
      *  tool-calling can't be confirmed, or declared tools that don't resolve
@@ -1807,7 +1803,9 @@ interface AgentDeleteInput {
 }
 interface AgentDeleteResult {
     agentId: string;
-    status: string;
+    address?: string;
+    /** Present on logical termination; absent on physical removal. */
+    status?: string;
     removed?: boolean;
 }
 interface AgentSuspendResult {
@@ -1936,17 +1934,17 @@ interface AgentSessionPage {
     offset: number;
     limit: number;
 }
+/** Forks into an unused name; replacement requires explicit deletion first. */
 interface AgentForkInput {
     sourceId: string;
     agentId: string;
     config?: Record<string, any>;
     includeTimeline?: boolean;
-    overwrite?: boolean;
 }
 interface AgentForkResult {
     agentId: string;
+    address?: string;
     status: string;
-    created: boolean;
     forkedFrom: string;
 }
 interface AgentContextInput {

package/dist/index.d.ts

@@ -46,7 +46,6 @@ declare class Agent {
     fork(agentId: string, options?: {
         config?: Record<string, unknown>;
         includeTimeline?: boolean;
-        overwrite?: boolean;
     }): Promise<Agent>;
     context(task?: unknown): Promise<string>;
     delete(remove?: boolean): Promise<AgentDeleteResult>;
@@ -1722,19 +1721,16 @@ declare enum AgentStatus {
     SUSPENDED = "SUSPENDED",
     TERMINATED = "TERMINATED"
 }
+/** Creates a new name only. Use update to preserve an existing agent and its history. */
 interface AgentCreateInput {
     agentId: string;
     config?: Record<string, any>;
     state?: Record<string, any>;
-    overwrite?: boolean;
 }
 interface AgentCreateResult {
     agentId: string;
     status: string;
-    created: boolean;
-    /** True when an existing SLEEPING/SUSPENDED record was updated in place
-     *  (mutually exclusive with created). Absent on venues before 0.4. */
-    updated?: boolean;
+    address?: string;
     /** Non-fatal advisories (venue 0.5+): present only when the config looks
      *  misconfigured but create still succeeded — e.g. an Ollama model whose
      *  tool-calling can't be confirmed, or declared tools that don't resolve
@@ -1807,7 +1803,9 @@ interface AgentDeleteInput {
 }
 interface AgentDeleteResult {
     agentId: string;
-    status: string;
+    address?: string;
+    /** Present on logical termination; absent on physical removal. */
+    status?: string;
     removed?: boolean;
 }
 interface AgentSuspendResult {
@@ -1936,17 +1934,17 @@ interface AgentSessionPage {
     offset: number;
     limit: number;
 }
+/** Forks into an unused name; replacement requires explicit deletion first. */
 interface AgentForkInput {
     sourceId: string;
     agentId: string;
     config?: Record<string, any>;
     includeTimeline?: boolean;
-    overwrite?: boolean;
 }
 interface AgentForkResult {
     agentId: string;
+    address?: string;
     status: string;
-    created: boolean;
     forkedFrom: string;
 }
 interface AgentContextInput {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@covia/covia-sdk",
-  "version": "1.24.1",
+  "version": "1.24.2",
   "description": "Typescript library for covia-ai",
   "packageManager": "pnpm@11.9.0",
   "main": "./dist/index.js",