@covia/covia-sdk 1.4.0 → 1.5.0

package/dist/index.d.mts

@@ -1,3 +1,54 @@
+declare class Agent {
+    readonly id: string;
+    readonly venue: VenueInterface;
+    private _agents;
+    constructor(id: string, venue: VenueInterface);
+    request(input?: any, wait?: boolean | number): Promise<AgentRequestResult>;
+    message(message: any): Promise<AgentMessageResult>;
+    chat(message: any, sessionId?: string): Promise<AgentChatResult>;
+    /**
+     * Create a ChatSession bound to this agent.
+     * @param sessionId - Optional session ID to resume an existing session
+     */
+    chatSession(sessionId?: string): ChatSession;
+    trigger(): Promise<AgentTriggerResult>;
+    query(): Promise<AgentQueryResult>;
+    suspend(): Promise<AgentSuspendResult>;
+    resume(autoWake?: boolean): Promise<AgentSuspendResult>;
+    update(options: {
+        config?: Record<string, any>;
+        state?: Record<string, any>;
+    }): Promise<any>;
+    cancelTask(taskId: string): Promise<any>;
+    info(): Promise<AgentInfoResult>;
+    /**
+     * 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
+     */
+    fork(agentId: string, options?: {
+        config?: Record<string, any>;
+        includeTimeline?: boolean;
+        overwrite?: boolean;
+    }): Promise<Agent>;
+    context(task?: any): Promise<string>;
+    delete(remove?: boolean): Promise<AgentDeleteResult>;
+}
+declare class ChatSession {
+    readonly agent: Agent;
+    private _sessionId;
+    constructor(agent: Agent, sessionId?: string);
+    /** The session ID, or undefined if no message has been sent yet and no ID was provided. */
+    get sessionId(): string | undefined;
+    /**
+     * 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.
+     */
+    send(message: any): Promise<AgentChatResult>;
+}
+
 declare class Job {
     id: string;
     venue: VenueInterface;
@@ -244,6 +295,11 @@ declare class AgentManager {
     resume(agentId: string, autoWake?: boolean): Promise<AgentSuspendResult>;
     update(input: AgentUpdateInput): Promise<any>;
     cancelTask(agentId: string, taskId: string): Promise<any>;
+    info(agentId: string): Promise<AgentInfoResult>;
+    fork(input: AgentForkInput): Promise<AgentForkResult>;
+    context(agentId: string, task?: any): Promise<string>;
+    completeTask(result?: any): Promise<AgentCompleteTaskResult>;
+    failTask(error: string): Promise<AgentFailTaskResult>;
 }
 
 interface JobManagerVenue {
@@ -271,6 +327,9 @@ interface AssetManagerVenue {
     auth: {
         apply(headers: Record<string, string>): void;
     };
+    operations: {
+        run(assetId: string, input: any): Promise<any>;
+    };
 }
 declare class AssetManager {
     private venue;
@@ -308,6 +367,12 @@ declare class AssetManager {
      * @param assetId - Asset identifier
      */
     getContent(assetId: string): Promise<ReadableStream<Uint8Array> | null>;
+    /**
+     * 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)
+     */
+    pin(path: string): Promise<AssetPinResult>;
     /**
      * Clear the asset cache.
      */
@@ -330,7 +395,7 @@ declare class OperationManager {
     list(): Promise<OperationInfo[]>;
     /**
      * Get details of a named operation
-     * @param name - Operation name (e.g., "test:echo")
+     * @param name - Operation name (e.g., "v/ops/schema/infer")
      */
     get(name: string): Promise<OperationInfo>;
     /**
@@ -364,6 +429,8 @@ declare class WorkspaceManager {
     append(path: string, value: any): Promise<WorkspaceAppendResult>;
     list(path?: string, limit?: number, offset?: number): Promise<WorkspaceListResult>;
     slice(path: string, offset?: number, limit?: number): Promise<WorkspaceSliceResult>;
+    copy(from: string, to: string): Promise<WorkspaceCopyResult>;
+    inspect(paths: string | string[], budget?: number, compact?: boolean): Promise<WorkspaceInspectResult>;
 }
 
 interface UCANManagerVenue {
@@ -450,6 +517,13 @@ declare class Venue implements VenueInterface {
      * @returns {Promise<Job>}
      */
     getJob(jobId: string): Promise<Job>;
+    /**
+     * 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: string): Agent;
     /**
      * List secret names
      * @returns {Promise<string[]>}
@@ -528,6 +602,7 @@ interface VenueInterface {
     listSecrets(): Promise<string[]>;
     putSecret(name: string, value: string): Promise<void>;
     deleteSecret(name: string): Promise<void>;
+    agent(agentId: string): Agent;
     close(): void;
 }
 type AssetID = string;
@@ -761,6 +836,57 @@ interface AgentCancelTaskInput {
     agentId: string;
     taskId: string;
 }
+interface AgentInfoResult {
+    agentId: string;
+    status: string;
+    config?: Record<string, any>;
+    stateConfig?: Record<string, any>;
+    timelineLength?: number;
+    tasks?: number;
+    error?: string;
+}
+interface AgentForkInput {
+    sourceId: string;
+    agentId: string;
+    config?: Record<string, any>;
+    includeTimeline?: boolean;
+    overwrite?: boolean;
+}
+interface AgentForkResult {
+    agentId: string;
+    status: string;
+    created: boolean;
+    forkedFrom: string;
+}
+interface AgentContextInput {
+    agentId: string;
+    task?: any;
+}
+interface AgentCompleteTaskResult {
+    agentId: string;
+    taskId: string;
+    status: string;
+}
+interface AgentFailTaskResult {
+    agentId: string;
+    taskId: string;
+    status: string;
+}
+interface AssetPinResult {
+    path: string;
+    hash: string;
+}
+interface WorkspaceCopyResult {
+    copied: boolean;
+}
+interface WorkspaceInspectInput {
+    paths: string | string[];
+    budget?: number;
+    compact?: boolean;
+}
+interface WorkspaceInspectResult {
+    result: any;
+}
 interface WorkspaceReadInput {
     path: string;
     maxSize?: number;
@@ -1037,4 +1163,4 @@ declare function decodePublicKey(multikey: string): Uint8Array;
  */
 declare function didFromPublicKey(publicKey: Uint8Array): string;
 
-export { type AdapterInfo, type AdaptersResult, type AgentCancelTaskInput, type AgentCard, type AgentChatInput, type AgentChatResult, type AgentCreateInput, type AgentCreateResult, type AgentDeleteInput, type AgentDeleteResult, type AgentListInput, type AgentListResult, AgentManager, type AgentMessageInput, type AgentMessageResult, type AgentQueryInput, type AgentQueryResult, type AgentRequestInput, type AgentRequestResult, type AgentResumeInput, AgentStatus, type AgentSuspendResult, type AgentTriggerInput, type AgentTriggerResult, type AgentUpdateInput, Asset, type AssetID, type AssetList, type AssetListOptions, AssetManager, type AssetMetadata, AssetNotFoundError, Auth, BearerAuth, type ContentDetails, type ContentHashResult, CoviaConnectionError, CoviaError, CoviaTimeoutError, type Credentials, CredentialsHTTP, type DIDDocument, DataAsset, type FunctionInfo, type FunctionsResult, Grid, GridError, type InvokeOptions, type InvokePayload, Job, JobFailedError, JobManager, type JobMetadata, JobNotFoundError, JobStatus, KeyPairAuth, type MCPDiscovery, NoAuth, NotFoundError, Operation, type OperationDetails, type OperationInfo, OperationManager, type OperationPayload, RunStatus, type SSEEvent, type SecretExtractInput, type SecretExtractResult, SecretManager, type SecretSetInput, type SecretSetResult, type StatsData, type StatusData, type UCANAttenuation, type UCANIssueInput, type UCANIssueResult, UCANManager, Venue, type VenueConstructor, type VenueData, type VenueInterface, type VenueOptions, type WorkspaceAppendInput, type WorkspaceAppendResult, type WorkspaceDeleteInput, type WorkspaceDeleteResult, type WorkspaceListInput, type WorkspaceListResult, WorkspaceManager, type WorkspaceReadInput, type WorkspaceReadResult, type WorkspaceSliceInput, type WorkspaceSliceResult, type WorkspaceWriteInput, type WorkspaceWriteResult, createSSEEvent, decodePublicKey, didFromPublicKey, encodePublicKey, fetchStreamWithError, fetchWithError, generateKeyPair, getAssetIdFromPath, getAssetIdFromVenueId, getParsedAssetId, hexToPrivateKey, isJobComplete, isJobFinished, isJobPaused, logger, parseSSEStream, privateKeyToHex };
+export { type AdapterInfo, type AdaptersResult, Agent, type AgentCancelTaskInput, type AgentCard, type AgentChatInput, type AgentChatResult, type AgentCompleteTaskResult, type AgentContextInput, type AgentCreateInput, type AgentCreateResult, type AgentDeleteInput, type AgentDeleteResult, type AgentFailTaskResult, type AgentForkInput, type AgentForkResult, type AgentInfoResult, type AgentListInput, type AgentListResult, AgentManager, type AgentMessageInput, type AgentMessageResult, type AgentQueryInput, type AgentQueryResult, type AgentRequestInput, type AgentRequestResult, type AgentResumeInput, AgentStatus, type AgentSuspendResult, type AgentTriggerInput, type AgentTriggerResult, type AgentUpdateInput, Asset, type AssetID, type AssetList, type AssetListOptions, AssetManager, type AssetMetadata, AssetNotFoundError, type AssetPinResult, Auth, BearerAuth, ChatSession, type ContentDetails, type ContentHashResult, CoviaConnectionError, CoviaError, CoviaTimeoutError, type Credentials, CredentialsHTTP, type DIDDocument, DataAsset, type FunctionInfo, type FunctionsResult, Grid, GridError, type InvokeOptions, type InvokePayload, Job, JobFailedError, JobManager, type JobMetadata, JobNotFoundError, JobStatus, KeyPairAuth, type MCPDiscovery, NoAuth, NotFoundError, Operation, type OperationDetails, type OperationInfo, OperationManager, type OperationPayload, RunStatus, type SSEEvent, type SecretExtractInput, type SecretExtractResult, SecretManager, type SecretSetInput, type SecretSetResult, type StatsData, type StatusData, type UCANAttenuation, type UCANIssueInput, type UCANIssueResult, UCANManager, Venue, type VenueConstructor, type VenueData, type VenueInterface, type VenueOptions, type WorkspaceAppendInput, type WorkspaceAppendResult, type WorkspaceCopyResult, type WorkspaceDeleteInput, type WorkspaceDeleteResult, type WorkspaceInspectInput, type WorkspaceInspectResult, type WorkspaceListInput, type WorkspaceListResult, WorkspaceManager, type WorkspaceReadInput, type WorkspaceReadResult, type WorkspaceSliceInput, type WorkspaceSliceResult, type WorkspaceWriteInput, type WorkspaceWriteResult, createSSEEvent, decodePublicKey, didFromPublicKey, encodePublicKey, fetchStreamWithError, fetchWithError, generateKeyPair, getAssetIdFromPath, getAssetIdFromVenueId, getParsedAssetId, hexToPrivateKey, isJobComplete, isJobFinished, isJobPaused, logger, parseSSEStream, privateKeyToHex };

package/dist/index.d.ts

@@ -1,3 +1,54 @@
+declare class Agent {
+    readonly id: string;
+    readonly venue: VenueInterface;
+    private _agents;
+    constructor(id: string, venue: VenueInterface);
+    request(input?: any, wait?: boolean | number): Promise<AgentRequestResult>;
+    message(message: any): Promise<AgentMessageResult>;
+    chat(message: any, sessionId?: string): Promise<AgentChatResult>;
+    /**
+     * Create a ChatSession bound to this agent.
+     * @param sessionId - Optional session ID to resume an existing session
+     */
+    chatSession(sessionId?: string): ChatSession;
+    trigger(): Promise<AgentTriggerResult>;
+    query(): Promise<AgentQueryResult>;
+    suspend(): Promise<AgentSuspendResult>;
+    resume(autoWake?: boolean): Promise<AgentSuspendResult>;
+    update(options: {
+        config?: Record<string, any>;
+        state?: Record<string, any>;
+    }): Promise<any>;
+    cancelTask(taskId: string): Promise<any>;
+    info(): Promise<AgentInfoResult>;
+    /**
+     * 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
+     */
+    fork(agentId: string, options?: {
+        config?: Record<string, any>;
+        includeTimeline?: boolean;
+        overwrite?: boolean;
+    }): Promise<Agent>;
+    context(task?: any): Promise<string>;
+    delete(remove?: boolean): Promise<AgentDeleteResult>;
+}
+declare class ChatSession {
+    readonly agent: Agent;
+    private _sessionId;
+    constructor(agent: Agent, sessionId?: string);
+    /** The session ID, or undefined if no message has been sent yet and no ID was provided. */
+    get sessionId(): string | undefined;
+    /**
+     * 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.
+     */
+    send(message: any): Promise<AgentChatResult>;
+}
+
 declare class Job {
     id: string;
     venue: VenueInterface;
@@ -244,6 +295,11 @@ declare class AgentManager {
     resume(agentId: string, autoWake?: boolean): Promise<AgentSuspendResult>;
     update(input: AgentUpdateInput): Promise<any>;
     cancelTask(agentId: string, taskId: string): Promise<any>;
+    info(agentId: string): Promise<AgentInfoResult>;
+    fork(input: AgentForkInput): Promise<AgentForkResult>;
+    context(agentId: string, task?: any): Promise<string>;
+    completeTask(result?: any): Promise<AgentCompleteTaskResult>;
+    failTask(error: string): Promise<AgentFailTaskResult>;
 }
 
 interface JobManagerVenue {
@@ -271,6 +327,9 @@ interface AssetManagerVenue {
     auth: {
         apply(headers: Record<string, string>): void;
     };
+    operations: {
+        run(assetId: string, input: any): Promise<any>;
+    };
 }
 declare class AssetManager {
     private venue;
@@ -308,6 +367,12 @@ declare class AssetManager {
      * @param assetId - Asset identifier
      */
     getContent(assetId: string): Promise<ReadableStream<Uint8Array> | null>;
+    /**
+     * 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)
+     */
+    pin(path: string): Promise<AssetPinResult>;
     /**
      * Clear the asset cache.
      */
@@ -330,7 +395,7 @@ declare class OperationManager {
     list(): Promise<OperationInfo[]>;
     /**
      * Get details of a named operation
-     * @param name - Operation name (e.g., "test:echo")
+     * @param name - Operation name (e.g., "v/ops/schema/infer")
      */
     get(name: string): Promise<OperationInfo>;
     /**
@@ -364,6 +429,8 @@ declare class WorkspaceManager {
     append(path: string, value: any): Promise<WorkspaceAppendResult>;
     list(path?: string, limit?: number, offset?: number): Promise<WorkspaceListResult>;
     slice(path: string, offset?: number, limit?: number): Promise<WorkspaceSliceResult>;
+    copy(from: string, to: string): Promise<WorkspaceCopyResult>;
+    inspect(paths: string | string[], budget?: number, compact?: boolean): Promise<WorkspaceInspectResult>;
 }
 
 interface UCANManagerVenue {
@@ -450,6 +517,13 @@ declare class Venue implements VenueInterface {
      * @returns {Promise<Job>}
      */
     getJob(jobId: string): Promise<Job>;
+    /**
+     * 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: string): Agent;
     /**
      * List secret names
      * @returns {Promise<string[]>}
@@ -528,6 +602,7 @@ interface VenueInterface {
     listSecrets(): Promise<string[]>;
     putSecret(name: string, value: string): Promise<void>;
     deleteSecret(name: string): Promise<void>;
+    agent(agentId: string): Agent;
     close(): void;
 }
 type AssetID = string;
@@ -761,6 +836,57 @@ interface AgentCancelTaskInput {
     agentId: string;
     taskId: string;
 }
+interface AgentInfoResult {
+    agentId: string;
+    status: string;
+    config?: Record<string, any>;
+    stateConfig?: Record<string, any>;
+    timelineLength?: number;
+    tasks?: number;
+    error?: string;
+}
+interface AgentForkInput {
+    sourceId: string;
+    agentId: string;
+    config?: Record<string, any>;
+    includeTimeline?: boolean;
+    overwrite?: boolean;
+}
+interface AgentForkResult {
+    agentId: string;
+    status: string;
+    created: boolean;
+    forkedFrom: string;
+}
+interface AgentContextInput {
+    agentId: string;
+    task?: any;
+}
+interface AgentCompleteTaskResult {
+    agentId: string;
+    taskId: string;
+    status: string;
+}
+interface AgentFailTaskResult {
+    agentId: string;
+    taskId: string;
+    status: string;
+}
+interface AssetPinResult {
+    path: string;
+    hash: string;
+}
+interface WorkspaceCopyResult {
+    copied: boolean;
+}
+interface WorkspaceInspectInput {
+    paths: string | string[];
+    budget?: number;
+    compact?: boolean;
+}
+interface WorkspaceInspectResult {
+    result: any;
+}
 interface WorkspaceReadInput {
     path: string;
     maxSize?: number;
@@ -1037,4 +1163,4 @@ declare function decodePublicKey(multikey: string): Uint8Array;
  */
 declare function didFromPublicKey(publicKey: Uint8Array): string;
 
-export { type AdapterInfo, type AdaptersResult, type AgentCancelTaskInput, type AgentCard, type AgentChatInput, type AgentChatResult, type AgentCreateInput, type AgentCreateResult, type AgentDeleteInput, type AgentDeleteResult, type AgentListInput, type AgentListResult, AgentManager, type AgentMessageInput, type AgentMessageResult, type AgentQueryInput, type AgentQueryResult, type AgentRequestInput, type AgentRequestResult, type AgentResumeInput, AgentStatus, type AgentSuspendResult, type AgentTriggerInput, type AgentTriggerResult, type AgentUpdateInput, Asset, type AssetID, type AssetList, type AssetListOptions, AssetManager, type AssetMetadata, AssetNotFoundError, Auth, BearerAuth, type ContentDetails, type ContentHashResult, CoviaConnectionError, CoviaError, CoviaTimeoutError, type Credentials, CredentialsHTTP, type DIDDocument, DataAsset, type FunctionInfo, type FunctionsResult, Grid, GridError, type InvokeOptions, type InvokePayload, Job, JobFailedError, JobManager, type JobMetadata, JobNotFoundError, JobStatus, KeyPairAuth, type MCPDiscovery, NoAuth, NotFoundError, Operation, type OperationDetails, type OperationInfo, OperationManager, type OperationPayload, RunStatus, type SSEEvent, type SecretExtractInput, type SecretExtractResult, SecretManager, type SecretSetInput, type SecretSetResult, type StatsData, type StatusData, type UCANAttenuation, type UCANIssueInput, type UCANIssueResult, UCANManager, Venue, type VenueConstructor, type VenueData, type VenueInterface, type VenueOptions, type WorkspaceAppendInput, type WorkspaceAppendResult, type WorkspaceDeleteInput, type WorkspaceDeleteResult, type WorkspaceListInput, type WorkspaceListResult, WorkspaceManager, type WorkspaceReadInput, type WorkspaceReadResult, type WorkspaceSliceInput, type WorkspaceSliceResult, type WorkspaceWriteInput, type WorkspaceWriteResult, createSSEEvent, decodePublicKey, didFromPublicKey, encodePublicKey, fetchStreamWithError, fetchWithError, generateKeyPair, getAssetIdFromPath, getAssetIdFromVenueId, getParsedAssetId, hexToPrivateKey, isJobComplete, isJobFinished, isJobPaused, logger, parseSSEStream, privateKeyToHex };
+export { type AdapterInfo, type AdaptersResult, Agent, type AgentCancelTaskInput, type AgentCard, type AgentChatInput, type AgentChatResult, type AgentCompleteTaskResult, type AgentContextInput, type AgentCreateInput, type AgentCreateResult, type AgentDeleteInput, type AgentDeleteResult, type AgentFailTaskResult, type AgentForkInput, type AgentForkResult, type AgentInfoResult, type AgentListInput, type AgentListResult, AgentManager, type AgentMessageInput, type AgentMessageResult, type AgentQueryInput, type AgentQueryResult, type AgentRequestInput, type AgentRequestResult, type AgentResumeInput, AgentStatus, type AgentSuspendResult, type AgentTriggerInput, type AgentTriggerResult, type AgentUpdateInput, Asset, type AssetID, type AssetList, type AssetListOptions, AssetManager, type AssetMetadata, AssetNotFoundError, type AssetPinResult, Auth, BearerAuth, ChatSession, type ContentDetails, type ContentHashResult, CoviaConnectionError, CoviaError, CoviaTimeoutError, type Credentials, CredentialsHTTP, type DIDDocument, DataAsset, type FunctionInfo, type FunctionsResult, Grid, GridError, type InvokeOptions, type InvokePayload, Job, JobFailedError, JobManager, type JobMetadata, JobNotFoundError, JobStatus, KeyPairAuth, type MCPDiscovery, NoAuth, NotFoundError, Operation, type OperationDetails, type OperationInfo, OperationManager, type OperationPayload, RunStatus, type SSEEvent, type SecretExtractInput, type SecretExtractResult, SecretManager, type SecretSetInput, type SecretSetResult, type StatsData, type StatusData, type UCANAttenuation, type UCANIssueInput, type UCANIssueResult, UCANManager, Venue, type VenueConstructor, type VenueData, type VenueInterface, type VenueOptions, type WorkspaceAppendInput, type WorkspaceAppendResult, type WorkspaceCopyResult, type WorkspaceDeleteInput, type WorkspaceDeleteResult, type WorkspaceInspectInput, type WorkspaceInspectResult, type WorkspaceListInput, type WorkspaceListResult, WorkspaceManager, type WorkspaceReadInput, type WorkspaceReadResult, type WorkspaceSliceInput, type WorkspaceSliceResult, type WorkspaceWriteInput, type WorkspaceWriteResult, createSSEEvent, decodePublicKey, didFromPublicKey, encodePublicKey, fetchStreamWithError, fetchWithError, generateKeyPair, getAssetIdFromPath, getAssetIdFromVenueId, getParsedAssetId, hexToPrivateKey, isJobComplete, isJobFinished, isJobPaused, logger, parseSSEStream, privateKeyToHex };

package/dist/index.js

@@ -1373,7 +1373,19 @@ var AgentManager = class {
     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 });
@@ -1393,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
@@ -1546,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) {
@@ -1828,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.
    */
@@ -1854,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}`);
@@ -1920,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
@@ -1958,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 {
@@ -2066,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[]>}
@@ -2074,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
@@ -2172,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;
@@ -2179,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;