@covia/covia-sdk 1.3.0 → 1.5.0

package/dist/index.js

@@ -1350,11 +1350,42 @@ var AgentManager = class {
   async message(agentId, message) {
     return this.venue.operations.run("v/ops/agent/message", { agentId, message });
   }
+  /**
+   * Send a message to an agent and synchronously await its next response on the session.
+   *
+   * Session lifecycle:
+   * - Omit `sessionId` on the first call — the server mints a new session and returns
+   *   its id in the result. Capture it.
+   * - Pass the returned `sessionId` on every subsequent call to continue the conversation.
+   * - An unknown `sessionId` is rejected (the server will not silently mint one); omit
+   *   the field entirely to start a new session.
+   *
+   * Concurrency: only one chat may be in flight per session. Concurrent calls on the
+   * same session are rejected by the venue.
+   *
+   * Blocking: always blocks until the agent produces its next response on the session.
+   * No polling required.
+   */
+  async chat(agentId, message, sessionId) {
+    return this.venue.operations.run("v/ops/agent/chat", { agentId, message, sessionId });
+  }
   async trigger(agentId) {
     return this.venue.operations.run("v/ops/agent/trigger", { agentId });
   }
   async query(agentId) {
-    return this.venue.operations.run("v/ops/agent/info", { agentId });
+    const read = (path) => this.venue.operations.run("v/ops/covia/read", { path }).catch(() => ({ value: null }));
+    const [info, timelineRes, stateRes, inboxRes] = await Promise.all([
+      this.venue.operations.run("v/ops/agent/info", { agentId }),
+      read(`g/${agentId}/timeline`),
+      read(`g/${agentId}/state`),
+      read(`g/${agentId}/inbox`)
+    ]);
+    return {
+      ...info,
+      timeline: Array.isArray(timelineRes.value) ? timelineRes.value : [],
+      state: stateRes.value ?? {},
+      inbox: Array.isArray(inboxRes.value) ? inboxRes.value : []
+    };
   }
   async list(includeTerminated) {
     return this.venue.operations.run("v/ops/agent/list", { includeTerminated });
@@ -1374,6 +1405,21 @@ var AgentManager = class {
   async cancelTask(agentId, taskId) {
     return this.venue.operations.run("v/ops/agent/cancel-task", { agentId, taskId });
   }
+  async info(agentId) {
+    return this.venue.operations.run("v/ops/agent/info", { agentId });
+  }
+  async fork(input) {
+    return this.venue.operations.run("v/ops/agent/fork", input);
+  }
+  async context(agentId, task) {
+    return this.venue.operations.run("v/ops/agent/context", { agentId, task });
+  }
+  async completeTask(result) {
+    return this.venue.operations.run("v/ops/agent/complete-task", { result });
+  }
+  async failTask(error) {
+    return this.venue.operations.run("v/ops/agent/fail-task", { error });
+  }
 };
 
 // src/Job.ts
@@ -1527,11 +1573,15 @@ var JobManager = class {
     this.venue = venue;
   }
   async list() {
-    return fetchWithError(`${this.venue.baseUrl}/api/v1/jobs`);
+    return fetchWithError(`${this.venue.baseUrl}/api/v1/jobs`, {
+      headers: this._buildHeaders()
+    });
   }
   async get(jobId) {
     try {
-      const data = await fetchWithError(`${this.venue.baseUrl}/api/v1/jobs/${jobId}`);
+      const data = await fetchWithError(`${this.venue.baseUrl}/api/v1/jobs/${jobId}`, {
+        headers: this._buildHeaders()
+      });
       return new Job(jobId, this.venue, data);
     } catch (error) {
       if (error instanceof NotFoundError) {
@@ -1809,6 +1859,14 @@ var AssetManager = class {
       throw error;
     }
   }
+  /**
+   * Pin a resolvable value into the content-addressed asset store.
+   * Idempotent — same value produces the same hash.
+   * @param path - Source address (hex hash, /a/<hash>, /o/<name>, /v/<path>, DID URL, or workspace path)
+   */
+  async pin(path) {
+    return this.venue.operations.run("v/ops/asset/pin", { path });
+  }
   /**
    * Clear the asset cache.
    */
@@ -1835,7 +1893,7 @@ var OperationManager = class {
   }
   /**
    * Get details of a named operation
-   * @param name - Operation name (e.g., "test:echo")
+   * @param name - Operation name (e.g., "v/ops/schema/infer")
    */
   async get(name) {
     return fetchWithError(`${this.venue.baseUrl}/api/v1/operations/${name}`);
@@ -1901,6 +1959,12 @@ var WorkspaceManager = class {
   async slice(path, offset, limit) {
     return this.venue.operations.run("v/ops/covia/slice", { path, offset, limit });
   }
+  async copy(from, to) {
+    return this.venue.operations.run("v/ops/covia/copy", { from, to });
+  }
+  async inspect(paths, budget, compact) {
+    return this.venue.operations.run("v/ops/covia/inspect", { paths, budget, compact });
+  }
 };
 
 // src/UCANManager.ts
@@ -1939,6 +2003,90 @@ var SecretManager = class {
     return this.venue.deleteSecret(name);
   }
 };
+
+// src/Agent.ts
+var Agent = class _Agent {
+  constructor(id, venue) {
+    this.id = id;
+    this.venue = venue;
+    this._agents = venue.agents;
+  }
+  async request(input, wait) {
+    return this._agents.request(this.id, input, wait);
+  }
+  async message(message) {
+    return this._agents.message(this.id, message);
+  }
+  async chat(message, sessionId) {
+    return this._agents.chat(this.id, message, sessionId);
+  }
+  /**
+   * Create a ChatSession bound to this agent.
+   * @param sessionId - Optional session ID to resume an existing session
+   */
+  chatSession(sessionId) {
+    return new ChatSession(this, sessionId);
+  }
+  async trigger() {
+    return this._agents.trigger(this.id);
+  }
+  async query() {
+    return this._agents.query(this.id);
+  }
+  async suspend() {
+    return this._agents.suspend(this.id);
+  }
+  async resume(autoWake) {
+    return this._agents.resume(this.id, autoWake);
+  }
+  async update(options) {
+    return this._agents.update({ agentId: this.id, ...options });
+  }
+  async cancelTask(taskId) {
+    return this._agents.cancelTask(this.id, taskId);
+  }
+  async info() {
+    return this._agents.info(this.id);
+  }
+  /**
+   * Fork this agent into a new agent.
+   * @param agentId - ID for the new forked agent
+   * @param options - Fork options
+   * @returns A new Agent instance for the forked agent
+   */
+  async fork(agentId, options) {
+    await this._agents.fork({ sourceId: this.id, agentId, ...options });
+    return new _Agent(agentId, this.venue);
+  }
+  async context(task) {
+    return this._agents.context(this.id, task);
+  }
+  async delete(remove) {
+    return this._agents.delete(this.id, remove);
+  }
+};
+var ChatSession = class {
+  constructor(agent, sessionId) {
+    this.agent = agent;
+    this._sessionId = sessionId;
+  }
+  /** The session ID, or undefined if no message has been sent yet and no ID was provided. */
+  get sessionId() {
+    return this._sessionId;
+  }
+  /**
+   * Send a message on this session.
+   * On the first call (when no sessionId is set), the server mints a new session.
+   * The returned sessionId is captured and reused for all subsequent calls.
+   */
+  async send(message) {
+    const result = await this.agent.chat(message, this._sessionId);
+    this._sessionId = result.sessionId;
+    return result;
+  }
+};
+
+// src/Venue.ts
 var webResolver = webDidResolver.getResolver();
 var resolver = new didResolver.Resolver(webResolver);
 var Venue = class _Venue {
@@ -2047,6 +2195,15 @@ var Venue = class _Venue {
   async getJob(jobId) {
     return this.jobs.get(jobId);
   }
+  /**
+   * Get a lazy Agent handle for the given agent ID.
+   * No network round-trip — the agent is not verified to exist.
+   * @param agentId - Agent identifier
+   * @returns {Agent} An Agent instance bound to this venue
+   */
+  agent(agentId) {
+    return new Agent(agentId, this);
+  }
   /**
    * List secret names
    * @returns {Promise<string[]>}
@@ -2055,7 +2212,7 @@ var Venue = class _Venue {
     const result = await fetchWithError(`${this.baseUrl}/api/v1/secrets`, {
       headers: this._buildHeaders()
     });
-    return result.items;
+    return Array.isArray(result.items) ? result.items : [];
   }
   /**
    * Store a secret value
@@ -2153,6 +2310,7 @@ var Grid = class {
   (*! noble-hashes - MIT License (c) 2022 Paul Miller (paulmillr.com) *)
 */
 
+exports.Agent = Agent;
 exports.AgentManager = AgentManager;
 exports.AgentStatus = AgentStatus;
 exports.Asset = Asset;
@@ -2160,6 +2318,7 @@ exports.AssetManager = AssetManager;
 exports.AssetNotFoundError = AssetNotFoundError;
 exports.Auth = Auth;
 exports.BearerAuth = BearerAuth;
+exports.ChatSession = ChatSession;
 exports.CoviaConnectionError = CoviaConnectionError;
 exports.CoviaError = CoviaError;
 exports.CoviaTimeoutError = CoviaTimeoutError;

package/dist/index.mjs

@@ -1348,11 +1348,42 @@ var AgentManager = class {
   async message(agentId, message) {
     return this.venue.operations.run("v/ops/agent/message", { agentId, message });
   }
+  /**
+   * Send a message to an agent and synchronously await its next response on the session.
+   *
+   * Session lifecycle:
+   * - Omit `sessionId` on the first call — the server mints a new session and returns
+   *   its id in the result. Capture it.
+   * - Pass the returned `sessionId` on every subsequent call to continue the conversation.
+   * - An unknown `sessionId` is rejected (the server will not silently mint one); omit
+   *   the field entirely to start a new session.
+   *
+   * Concurrency: only one chat may be in flight per session. Concurrent calls on the
+   * same session are rejected by the venue.
+   *
+   * Blocking: always blocks until the agent produces its next response on the session.
+   * No polling required.
+   */
+  async chat(agentId, message, sessionId) {
+    return this.venue.operations.run("v/ops/agent/chat", { agentId, message, sessionId });
+  }
   async trigger(agentId) {
     return this.venue.operations.run("v/ops/agent/trigger", { agentId });
   }
   async query(agentId) {
-    return this.venue.operations.run("v/ops/agent/info", { agentId });
+    const read = (path) => this.venue.operations.run("v/ops/covia/read", { path }).catch(() => ({ value: null }));
+    const [info, timelineRes, stateRes, inboxRes] = await Promise.all([
+      this.venue.operations.run("v/ops/agent/info", { agentId }),
+      read(`g/${agentId}/timeline`),
+      read(`g/${agentId}/state`),
+      read(`g/${agentId}/inbox`)
+    ]);
+    return {
+      ...info,
+      timeline: Array.isArray(timelineRes.value) ? timelineRes.value : [],
+      state: stateRes.value ?? {},
+      inbox: Array.isArray(inboxRes.value) ? inboxRes.value : []
+    };
   }
   async list(includeTerminated) {
     return this.venue.operations.run("v/ops/agent/list", { includeTerminated });
@@ -1372,6 +1403,21 @@ var AgentManager = class {
   async cancelTask(agentId, taskId) {
     return this.venue.operations.run("v/ops/agent/cancel-task", { agentId, taskId });
   }
+  async info(agentId) {
+    return this.venue.operations.run("v/ops/agent/info", { agentId });
+  }
+  async fork(input) {
+    return this.venue.operations.run("v/ops/agent/fork", input);
+  }
+  async context(agentId, task) {
+    return this.venue.operations.run("v/ops/agent/context", { agentId, task });
+  }
+  async completeTask(result) {
+    return this.venue.operations.run("v/ops/agent/complete-task", { result });
+  }
+  async failTask(error) {
+    return this.venue.operations.run("v/ops/agent/fail-task", { error });
+  }
 };
 
 // src/Job.ts
@@ -1525,11 +1571,15 @@ var JobManager = class {
     this.venue = venue;
   }
   async list() {
-    return fetchWithError(`${this.venue.baseUrl}/api/v1/jobs`);
+    return fetchWithError(`${this.venue.baseUrl}/api/v1/jobs`, {
+      headers: this._buildHeaders()
+    });
   }
   async get(jobId) {
     try {
-      const data = await fetchWithError(`${this.venue.baseUrl}/api/v1/jobs/${jobId}`);
+      const data = await fetchWithError(`${this.venue.baseUrl}/api/v1/jobs/${jobId}`, {
+        headers: this._buildHeaders()
+      });
       return new Job(jobId, this.venue, data);
     } catch (error) {
       if (error instanceof NotFoundError) {
@@ -1807,6 +1857,14 @@ var AssetManager = class {
       throw error;
     }
   }
+  /**
+   * Pin a resolvable value into the content-addressed asset store.
+   * Idempotent — same value produces the same hash.
+   * @param path - Source address (hex hash, /a/<hash>, /o/<name>, /v/<path>, DID URL, or workspace path)
+   */
+  async pin(path) {
+    return this.venue.operations.run("v/ops/asset/pin", { path });
+  }
   /**
    * Clear the asset cache.
    */
@@ -1833,7 +1891,7 @@ var OperationManager = class {
   }
   /**
    * Get details of a named operation
-   * @param name - Operation name (e.g., "test:echo")
+   * @param name - Operation name (e.g., "v/ops/schema/infer")
    */
   async get(name) {
     return fetchWithError(`${this.venue.baseUrl}/api/v1/operations/${name}`);
@@ -1899,6 +1957,12 @@ var WorkspaceManager = class {
   async slice(path, offset, limit) {
     return this.venue.operations.run("v/ops/covia/slice", { path, offset, limit });
   }
+  async copy(from, to) {
+    return this.venue.operations.run("v/ops/covia/copy", { from, to });
+  }
+  async inspect(paths, budget, compact) {
+    return this.venue.operations.run("v/ops/covia/inspect", { paths, budget, compact });
+  }
 };
 
 // src/UCANManager.ts
@@ -1937,6 +2001,90 @@ var SecretManager = class {
     return this.venue.deleteSecret(name);
   }
 };
+
+// src/Agent.ts
+var Agent = class _Agent {
+  constructor(id, venue) {
+    this.id = id;
+    this.venue = venue;
+    this._agents = venue.agents;
+  }
+  async request(input, wait) {
+    return this._agents.request(this.id, input, wait);
+  }
+  async message(message) {
+    return this._agents.message(this.id, message);
+  }
+  async chat(message, sessionId) {
+    return this._agents.chat(this.id, message, sessionId);
+  }
+  /**
+   * Create a ChatSession bound to this agent.
+   * @param sessionId - Optional session ID to resume an existing session
+   */
+  chatSession(sessionId) {
+    return new ChatSession(this, sessionId);
+  }
+  async trigger() {
+    return this._agents.trigger(this.id);
+  }
+  async query() {
+    return this._agents.query(this.id);
+  }
+  async suspend() {
+    return this._agents.suspend(this.id);
+  }
+  async resume(autoWake) {
+    return this._agents.resume(this.id, autoWake);
+  }
+  async update(options) {
+    return this._agents.update({ agentId: this.id, ...options });
+  }
+  async cancelTask(taskId) {
+    return this._agents.cancelTask(this.id, taskId);
+  }
+  async info() {
+    return this._agents.info(this.id);
+  }
+  /**
+   * Fork this agent into a new agent.
+   * @param agentId - ID for the new forked agent
+   * @param options - Fork options
+   * @returns A new Agent instance for the forked agent
+   */
+  async fork(agentId, options) {
+    await this._agents.fork({ sourceId: this.id, agentId, ...options });
+    return new _Agent(agentId, this.venue);
+  }
+  async context(task) {
+    return this._agents.context(this.id, task);
+  }
+  async delete(remove) {
+    return this._agents.delete(this.id, remove);
+  }
+};
+var ChatSession = class {
+  constructor(agent, sessionId) {
+    this.agent = agent;
+    this._sessionId = sessionId;
+  }
+  /** The session ID, or undefined if no message has been sent yet and no ID was provided. */
+  get sessionId() {
+    return this._sessionId;
+  }
+  /**
+   * Send a message on this session.
+   * On the first call (when no sessionId is set), the server mints a new session.
+   * The returned sessionId is captured and reused for all subsequent calls.
+   */
+  async send(message) {
+    const result = await this.agent.chat(message, this._sessionId);
+    this._sessionId = result.sessionId;
+    return result;
+  }
+};
+
+// src/Venue.ts
 var webResolver = getResolver();
 var resolver = new Resolver(webResolver);
 var Venue = class _Venue {
@@ -2045,6 +2193,15 @@ var Venue = class _Venue {
   async getJob(jobId) {
     return this.jobs.get(jobId);
   }
+  /**
+   * Get a lazy Agent handle for the given agent ID.
+   * No network round-trip — the agent is not verified to exist.
+   * @param agentId - Agent identifier
+   * @returns {Agent} An Agent instance bound to this venue
+   */
+  agent(agentId) {
+    return new Agent(agentId, this);
+  }
   /**
    * List secret names
    * @returns {Promise<string[]>}
@@ -2053,7 +2210,7 @@ var Venue = class _Venue {
     const result = await fetchWithError(`${this.baseUrl}/api/v1/secrets`, {
       headers: this._buildHeaders()
     });
-    return result.items;
+    return Array.isArray(result.items) ? result.items : [];
   }
   /**
    * Store a secret value
@@ -2151,4 +2308,4 @@ var Grid = class {
   (*! noble-hashes - MIT License (c) 2022 Paul Miller (paulmillr.com) *)
 */
 
-export { AgentManager, AgentStatus, Asset, AssetManager, AssetNotFoundError, Auth, BearerAuth, CoviaConnectionError, CoviaError, CoviaTimeoutError, CredentialsHTTP, DataAsset, Grid, GridError, Job, JobFailedError, JobManager, JobNotFoundError, JobStatus, KeyPairAuth, NoAuth, NotFoundError, Operation, OperationManager, RunStatus, SecretManager, UCANManager, Venue, WorkspaceManager, createSSEEvent, decodePublicKey, didFromPublicKey, encodePublicKey, fetchStreamWithError, fetchWithError, generateKeyPair, getAssetIdFromPath, getAssetIdFromVenueId, getParsedAssetId, hexToPrivateKey, isJobComplete, isJobFinished, isJobPaused, logger, parseSSEStream, privateKeyToHex };
+export { Agent, AgentManager, AgentStatus, Asset, AssetManager, AssetNotFoundError, Auth, BearerAuth, ChatSession, CoviaConnectionError, CoviaError, CoviaTimeoutError, CredentialsHTTP, DataAsset, Grid, GridError, Job, JobFailedError, JobManager, JobNotFoundError, JobStatus, KeyPairAuth, NoAuth, NotFoundError, Operation, OperationManager, RunStatus, SecretManager, UCANManager, Venue, WorkspaceManager, createSSEEvent, decodePublicKey, didFromPublicKey, encodePublicKey, fetchStreamWithError, fetchWithError, generateKeyPair, getAssetIdFromPath, getAssetIdFromVenueId, getParsedAssetId, hexToPrivateKey, isJobComplete, isJobFinished, isJobPaused, logger, parseSSEStream, privateKeyToHex };

package/package.json

@@ -1,67 +1,67 @@
-{
-  "name": "@covia/covia-sdk",
-  "version": "1.3.0",
-  "description": "Typescript library for covia-ai",
-  "main": "./dist/index.js",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "require": "./dist/index.js",
-      "import": "./dist/index.mjs"
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
-    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
-    "lint": "eslint src --ext .ts",
-    "test": "jest",
-    "test:unit": "jest src/__tests__/",
-    "test:integration": "jest venue.test.ts",
-    "prepublishOnly": "npm run build && npm test",
-    "prepare": "npm run build"
-  },
-  "keywords": [
-    "covia",
-    "grid",
-    "api",
-    "typescript",
-    "data-assets",
-    "operations"
-  ],
-  "author": "Covia AI",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/covia-ai/covia-sdk.git"
-  },
-  "bugs": {
-    "url": "https://github.com/covia-ai/covia-sdk/issues"
-  },
-  "homepage": "https://github.com/covia-ai/covia-sdk#readme",
-  "publishConfig": {
-    "access": "public"
-  },
-  "devDependencies": {
-    "@types/jest": "^30.0.0",
-    "@types/node": "^20.0.0",
-    "dotenv": "^17.2.3",
-    "jest": "^30.2.0",
-    "ts-jest": "^29.4.6",
-    "tsup": "^8.0.0",
-    "typescript": "^5.3.0"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "dependencies": {
-    "@noble/ed25519": "^2.0.0",
-    "@noble/hashes": "^1.0.0",
-    "did-resolver": "^4.1.0",
-    "web-did-resolver": "^2.0.32"
-  }
+{
+  "name": "@covia/covia-sdk",
+  "version": "1.5.0",
+  "description": "Typescript library for covia-ai",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "lint": "eslint src --ext .ts",
+    "test": "jest",
+    "test:unit": "jest src/__tests__/",
+    "test:integration": "jest venue.test.ts",
+    "prepublishOnly": "npm run build && npm run test:unit",
+    "prepare": "npm run build"
+  },
+  "keywords": [
+    "covia",
+    "grid",
+    "api",
+    "typescript",
+    "data-assets",
+    "operations"
+  ],
+  "author": "Covia AI",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/covia-ai/covia-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/covia-ai/covia-sdk/issues"
+  },
+  "homepage": "https://github.com/covia-ai/covia-sdk#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^20.0.0",
+    "dotenv": "^17.2.3",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.6",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@noble/ed25519": "^2.0.0",
+    "@noble/hashes": "^1.0.0",
+    "did-resolver": "^4.1.0",
+    "web-did-resolver": "^2.0.32"
+  }
 }