@covia/covia-sdk 1.3.0 → 1.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE.md +190 -21
- package/README.md +592 -528
- package/dist/index.d.mts +155 -2
- package/dist/index.d.ts +155 -2
- package/dist/index.js +164 -5
- package/dist/index.mjs +163 -6
- package/package.json +66 -66
package/dist/index.d.mts
CHANGED
|
@@ -1,3 +1,54 @@
|
|
|
1
|
+
declare class Agent {
|
|
2
|
+
readonly id: string;
|
|
3
|
+
readonly venue: VenueInterface;
|
|
4
|
+
private _agents;
|
|
5
|
+
constructor(id: string, venue: VenueInterface);
|
|
6
|
+
request(input?: any, wait?: boolean | number): Promise<AgentRequestResult>;
|
|
7
|
+
message(message: any): Promise<AgentMessageResult>;
|
|
8
|
+
chat(message: any, sessionId?: string): Promise<AgentChatResult>;
|
|
9
|
+
/**
|
|
10
|
+
* Create a ChatSession bound to this agent.
|
|
11
|
+
* @param sessionId - Optional session ID to resume an existing session
|
|
12
|
+
*/
|
|
13
|
+
chatSession(sessionId?: string): ChatSession;
|
|
14
|
+
trigger(): Promise<AgentTriggerResult>;
|
|
15
|
+
query(): Promise<AgentQueryResult>;
|
|
16
|
+
suspend(): Promise<AgentSuspendResult>;
|
|
17
|
+
resume(autoWake?: boolean): Promise<AgentSuspendResult>;
|
|
18
|
+
update(options: {
|
|
19
|
+
config?: Record<string, any>;
|
|
20
|
+
state?: Record<string, any>;
|
|
21
|
+
}): Promise<any>;
|
|
22
|
+
cancelTask(taskId: string): Promise<any>;
|
|
23
|
+
info(): Promise<AgentInfoResult>;
|
|
24
|
+
/**
|
|
25
|
+
* Fork this agent into a new agent.
|
|
26
|
+
* @param agentId - ID for the new forked agent
|
|
27
|
+
* @param options - Fork options
|
|
28
|
+
* @returns A new Agent instance for the forked agent
|
|
29
|
+
*/
|
|
30
|
+
fork(agentId: string, options?: {
|
|
31
|
+
config?: Record<string, any>;
|
|
32
|
+
includeTimeline?: boolean;
|
|
33
|
+
overwrite?: boolean;
|
|
34
|
+
}): Promise<Agent>;
|
|
35
|
+
context(task?: any): Promise<string>;
|
|
36
|
+
delete(remove?: boolean): Promise<AgentDeleteResult>;
|
|
37
|
+
}
|
|
38
|
+
declare class ChatSession {
|
|
39
|
+
readonly agent: Agent;
|
|
40
|
+
private _sessionId;
|
|
41
|
+
constructor(agent: Agent, sessionId?: string);
|
|
42
|
+
/** The session ID, or undefined if no message has been sent yet and no ID was provided. */
|
|
43
|
+
get sessionId(): string | undefined;
|
|
44
|
+
/**
|
|
45
|
+
* Send a message on this session.
|
|
46
|
+
* On the first call (when no sessionId is set), the server mints a new session.
|
|
47
|
+
* The returned sessionId is captured and reused for all subsequent calls.
|
|
48
|
+
*/
|
|
49
|
+
send(message: any): Promise<AgentChatResult>;
|
|
50
|
+
}
|
|
51
|
+
|
|
1
52
|
declare class Job {
|
|
2
53
|
id: string;
|
|
3
54
|
venue: VenueInterface;
|
|
@@ -219,6 +270,23 @@ declare class AgentManager {
|
|
|
219
270
|
create(input: AgentCreateInput): Promise<AgentCreateResult>;
|
|
220
271
|
request(agentId: string, input?: any, wait?: boolean | number): Promise<AgentRequestResult>;
|
|
221
272
|
message(agentId: string, message: any): Promise<AgentMessageResult>;
|
|
273
|
+
/**
|
|
274
|
+
* Send a message to an agent and synchronously await its next response on the session.
|
|
275
|
+
*
|
|
276
|
+
* Session lifecycle:
|
|
277
|
+
* - Omit `sessionId` on the first call — the server mints a new session and returns
|
|
278
|
+
* its id in the result. Capture it.
|
|
279
|
+
* - Pass the returned `sessionId` on every subsequent call to continue the conversation.
|
|
280
|
+
* - An unknown `sessionId` is rejected (the server will not silently mint one); omit
|
|
281
|
+
* the field entirely to start a new session.
|
|
282
|
+
*
|
|
283
|
+
* Concurrency: only one chat may be in flight per session. Concurrent calls on the
|
|
284
|
+
* same session are rejected by the venue.
|
|
285
|
+
*
|
|
286
|
+
* Blocking: always blocks until the agent produces its next response on the session.
|
|
287
|
+
* No polling required.
|
|
288
|
+
*/
|
|
289
|
+
chat(agentId: string, message: any, sessionId?: string): Promise<AgentChatResult>;
|
|
222
290
|
trigger(agentId: string): Promise<AgentTriggerResult>;
|
|
223
291
|
query(agentId: string): Promise<AgentQueryResult>;
|
|
224
292
|
list(includeTerminated?: boolean): Promise<AgentListResult>;
|
|
@@ -227,6 +295,11 @@ declare class AgentManager {
|
|
|
227
295
|
resume(agentId: string, autoWake?: boolean): Promise<AgentSuspendResult>;
|
|
228
296
|
update(input: AgentUpdateInput): Promise<any>;
|
|
229
297
|
cancelTask(agentId: string, taskId: string): Promise<any>;
|
|
298
|
+
info(agentId: string): Promise<AgentInfoResult>;
|
|
299
|
+
fork(input: AgentForkInput): Promise<AgentForkResult>;
|
|
300
|
+
context(agentId: string, task?: any): Promise<string>;
|
|
301
|
+
completeTask(result?: any): Promise<AgentCompleteTaskResult>;
|
|
302
|
+
failTask(error: string): Promise<AgentFailTaskResult>;
|
|
230
303
|
}
|
|
231
304
|
|
|
232
305
|
interface JobManagerVenue {
|
|
@@ -254,6 +327,9 @@ interface AssetManagerVenue {
|
|
|
254
327
|
auth: {
|
|
255
328
|
apply(headers: Record<string, string>): void;
|
|
256
329
|
};
|
|
330
|
+
operations: {
|
|
331
|
+
run(assetId: string, input: any): Promise<any>;
|
|
332
|
+
};
|
|
257
333
|
}
|
|
258
334
|
declare class AssetManager {
|
|
259
335
|
private venue;
|
|
@@ -291,6 +367,12 @@ declare class AssetManager {
|
|
|
291
367
|
* @param assetId - Asset identifier
|
|
292
368
|
*/
|
|
293
369
|
getContent(assetId: string): Promise<ReadableStream<Uint8Array> | null>;
|
|
370
|
+
/**
|
|
371
|
+
* Pin a resolvable value into the content-addressed asset store.
|
|
372
|
+
* Idempotent — same value produces the same hash.
|
|
373
|
+
* @param path - Source address (hex hash, /a/<hash>, /o/<name>, /v/<path>, DID URL, or workspace path)
|
|
374
|
+
*/
|
|
375
|
+
pin(path: string): Promise<AssetPinResult>;
|
|
294
376
|
/**
|
|
295
377
|
* Clear the asset cache.
|
|
296
378
|
*/
|
|
@@ -313,7 +395,7 @@ declare class OperationManager {
|
|
|
313
395
|
list(): Promise<OperationInfo[]>;
|
|
314
396
|
/**
|
|
315
397
|
* Get details of a named operation
|
|
316
|
-
* @param name - Operation name (e.g., "
|
|
398
|
+
* @param name - Operation name (e.g., "v/ops/schema/infer")
|
|
317
399
|
*/
|
|
318
400
|
get(name: string): Promise<OperationInfo>;
|
|
319
401
|
/**
|
|
@@ -347,6 +429,8 @@ declare class WorkspaceManager {
|
|
|
347
429
|
append(path: string, value: any): Promise<WorkspaceAppendResult>;
|
|
348
430
|
list(path?: string, limit?: number, offset?: number): Promise<WorkspaceListResult>;
|
|
349
431
|
slice(path: string, offset?: number, limit?: number): Promise<WorkspaceSliceResult>;
|
|
432
|
+
copy(from: string, to: string): Promise<WorkspaceCopyResult>;
|
|
433
|
+
inspect(paths: string | string[], budget?: number, compact?: boolean): Promise<WorkspaceInspectResult>;
|
|
350
434
|
}
|
|
351
435
|
|
|
352
436
|
interface UCANManagerVenue {
|
|
@@ -433,6 +517,13 @@ declare class Venue implements VenueInterface {
|
|
|
433
517
|
* @returns {Promise<Job>}
|
|
434
518
|
*/
|
|
435
519
|
getJob(jobId: string): Promise<Job>;
|
|
520
|
+
/**
|
|
521
|
+
* Get a lazy Agent handle for the given agent ID.
|
|
522
|
+
* No network round-trip — the agent is not verified to exist.
|
|
523
|
+
* @param agentId - Agent identifier
|
|
524
|
+
* @returns {Agent} An Agent instance bound to this venue
|
|
525
|
+
*/
|
|
526
|
+
agent(agentId: string): Agent;
|
|
436
527
|
/**
|
|
437
528
|
* List secret names
|
|
438
529
|
* @returns {Promise<string[]>}
|
|
@@ -511,6 +602,7 @@ interface VenueInterface {
|
|
|
511
602
|
listSecrets(): Promise<string[]>;
|
|
512
603
|
putSecret(name: string, value: string): Promise<void>;
|
|
513
604
|
deleteSecret(name: string): Promise<void>;
|
|
605
|
+
agent(agentId: string): Agent;
|
|
514
606
|
close(): void;
|
|
515
607
|
}
|
|
516
608
|
type AssetID = string;
|
|
@@ -678,6 +770,16 @@ interface AgentMessageResult {
|
|
|
678
770
|
agentId: string;
|
|
679
771
|
delivered: boolean;
|
|
680
772
|
}
|
|
773
|
+
interface AgentChatInput {
|
|
774
|
+
agentId: string;
|
|
775
|
+
message: any;
|
|
776
|
+
sessionId?: string;
|
|
777
|
+
}
|
|
778
|
+
interface AgentChatResult {
|
|
779
|
+
agentId: string;
|
|
780
|
+
sessionId: string;
|
|
781
|
+
response: any;
|
|
782
|
+
}
|
|
681
783
|
interface AgentTriggerInput {
|
|
682
784
|
agentId: string;
|
|
683
785
|
}
|
|
@@ -734,6 +836,57 @@ interface AgentCancelTaskInput {
|
|
|
734
836
|
agentId: string;
|
|
735
837
|
taskId: string;
|
|
736
838
|
}
|
|
839
|
+
interface AgentInfoResult {
|
|
840
|
+
agentId: string;
|
|
841
|
+
status: string;
|
|
842
|
+
config?: Record<string, any>;
|
|
843
|
+
stateConfig?: Record<string, any>;
|
|
844
|
+
timelineLength?: number;
|
|
845
|
+
tasks?: number;
|
|
846
|
+
error?: string;
|
|
847
|
+
}
|
|
848
|
+
interface AgentForkInput {
|
|
849
|
+
sourceId: string;
|
|
850
|
+
agentId: string;
|
|
851
|
+
config?: Record<string, any>;
|
|
852
|
+
includeTimeline?: boolean;
|
|
853
|
+
overwrite?: boolean;
|
|
854
|
+
}
|
|
855
|
+
interface AgentForkResult {
|
|
856
|
+
agentId: string;
|
|
857
|
+
status: string;
|
|
858
|
+
created: boolean;
|
|
859
|
+
forkedFrom: string;
|
|
860
|
+
}
|
|
861
|
+
interface AgentContextInput {
|
|
862
|
+
agentId: string;
|
|
863
|
+
task?: any;
|
|
864
|
+
}
|
|
865
|
+
interface AgentCompleteTaskResult {
|
|
866
|
+
agentId: string;
|
|
867
|
+
taskId: string;
|
|
868
|
+
status: string;
|
|
869
|
+
}
|
|
870
|
+
interface AgentFailTaskResult {
|
|
871
|
+
agentId: string;
|
|
872
|
+
taskId: string;
|
|
873
|
+
status: string;
|
|
874
|
+
}
|
|
875
|
+
interface AssetPinResult {
|
|
876
|
+
path: string;
|
|
877
|
+
hash: string;
|
|
878
|
+
}
|
|
879
|
+
interface WorkspaceCopyResult {
|
|
880
|
+
copied: boolean;
|
|
881
|
+
}
|
|
882
|
+
interface WorkspaceInspectInput {
|
|
883
|
+
paths: string | string[];
|
|
884
|
+
budget?: number;
|
|
885
|
+
compact?: boolean;
|
|
886
|
+
}
|
|
887
|
+
interface WorkspaceInspectResult {
|
|
888
|
+
result: any;
|
|
889
|
+
}
|
|
737
890
|
interface WorkspaceReadInput {
|
|
738
891
|
path: string;
|
|
739
892
|
maxSize?: number;
|
|
@@ -1010,4 +1163,4 @@ declare function decodePublicKey(multikey: string): Uint8Array;
|
|
|
1010
1163
|
*/
|
|
1011
1164
|
declare function didFromPublicKey(publicKey: Uint8Array): string;
|
|
1012
1165
|
|
|
1013
|
-
export { type AdapterInfo, type AdaptersResult, type AgentCancelTaskInput, type AgentCard, 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 };
|
|
1166
|
+
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
CHANGED
|
@@ -1,3 +1,54 @@
|
|
|
1
|
+
declare class Agent {
|
|
2
|
+
readonly id: string;
|
|
3
|
+
readonly venue: VenueInterface;
|
|
4
|
+
private _agents;
|
|
5
|
+
constructor(id: string, venue: VenueInterface);
|
|
6
|
+
request(input?: any, wait?: boolean | number): Promise<AgentRequestResult>;
|
|
7
|
+
message(message: any): Promise<AgentMessageResult>;
|
|
8
|
+
chat(message: any, sessionId?: string): Promise<AgentChatResult>;
|
|
9
|
+
/**
|
|
10
|
+
* Create a ChatSession bound to this agent.
|
|
11
|
+
* @param sessionId - Optional session ID to resume an existing session
|
|
12
|
+
*/
|
|
13
|
+
chatSession(sessionId?: string): ChatSession;
|
|
14
|
+
trigger(): Promise<AgentTriggerResult>;
|
|
15
|
+
query(): Promise<AgentQueryResult>;
|
|
16
|
+
suspend(): Promise<AgentSuspendResult>;
|
|
17
|
+
resume(autoWake?: boolean): Promise<AgentSuspendResult>;
|
|
18
|
+
update(options: {
|
|
19
|
+
config?: Record<string, any>;
|
|
20
|
+
state?: Record<string, any>;
|
|
21
|
+
}): Promise<any>;
|
|
22
|
+
cancelTask(taskId: string): Promise<any>;
|
|
23
|
+
info(): Promise<AgentInfoResult>;
|
|
24
|
+
/**
|
|
25
|
+
* Fork this agent into a new agent.
|
|
26
|
+
* @param agentId - ID for the new forked agent
|
|
27
|
+
* @param options - Fork options
|
|
28
|
+
* @returns A new Agent instance for the forked agent
|
|
29
|
+
*/
|
|
30
|
+
fork(agentId: string, options?: {
|
|
31
|
+
config?: Record<string, any>;
|
|
32
|
+
includeTimeline?: boolean;
|
|
33
|
+
overwrite?: boolean;
|
|
34
|
+
}): Promise<Agent>;
|
|
35
|
+
context(task?: any): Promise<string>;
|
|
36
|
+
delete(remove?: boolean): Promise<AgentDeleteResult>;
|
|
37
|
+
}
|
|
38
|
+
declare class ChatSession {
|
|
39
|
+
readonly agent: Agent;
|
|
40
|
+
private _sessionId;
|
|
41
|
+
constructor(agent: Agent, sessionId?: string);
|
|
42
|
+
/** The session ID, or undefined if no message has been sent yet and no ID was provided. */
|
|
43
|
+
get sessionId(): string | undefined;
|
|
44
|
+
/**
|
|
45
|
+
* Send a message on this session.
|
|
46
|
+
* On the first call (when no sessionId is set), the server mints a new session.
|
|
47
|
+
* The returned sessionId is captured and reused for all subsequent calls.
|
|
48
|
+
*/
|
|
49
|
+
send(message: any): Promise<AgentChatResult>;
|
|
50
|
+
}
|
|
51
|
+
|
|
1
52
|
declare class Job {
|
|
2
53
|
id: string;
|
|
3
54
|
venue: VenueInterface;
|
|
@@ -219,6 +270,23 @@ declare class AgentManager {
|
|
|
219
270
|
create(input: AgentCreateInput): Promise<AgentCreateResult>;
|
|
220
271
|
request(agentId: string, input?: any, wait?: boolean | number): Promise<AgentRequestResult>;
|
|
221
272
|
message(agentId: string, message: any): Promise<AgentMessageResult>;
|
|
273
|
+
/**
|
|
274
|
+
* Send a message to an agent and synchronously await its next response on the session.
|
|
275
|
+
*
|
|
276
|
+
* Session lifecycle:
|
|
277
|
+
* - Omit `sessionId` on the first call — the server mints a new session and returns
|
|
278
|
+
* its id in the result. Capture it.
|
|
279
|
+
* - Pass the returned `sessionId` on every subsequent call to continue the conversation.
|
|
280
|
+
* - An unknown `sessionId` is rejected (the server will not silently mint one); omit
|
|
281
|
+
* the field entirely to start a new session.
|
|
282
|
+
*
|
|
283
|
+
* Concurrency: only one chat may be in flight per session. Concurrent calls on the
|
|
284
|
+
* same session are rejected by the venue.
|
|
285
|
+
*
|
|
286
|
+
* Blocking: always blocks until the agent produces its next response on the session.
|
|
287
|
+
* No polling required.
|
|
288
|
+
*/
|
|
289
|
+
chat(agentId: string, message: any, sessionId?: string): Promise<AgentChatResult>;
|
|
222
290
|
trigger(agentId: string): Promise<AgentTriggerResult>;
|
|
223
291
|
query(agentId: string): Promise<AgentQueryResult>;
|
|
224
292
|
list(includeTerminated?: boolean): Promise<AgentListResult>;
|
|
@@ -227,6 +295,11 @@ declare class AgentManager {
|
|
|
227
295
|
resume(agentId: string, autoWake?: boolean): Promise<AgentSuspendResult>;
|
|
228
296
|
update(input: AgentUpdateInput): Promise<any>;
|
|
229
297
|
cancelTask(agentId: string, taskId: string): Promise<any>;
|
|
298
|
+
info(agentId: string): Promise<AgentInfoResult>;
|
|
299
|
+
fork(input: AgentForkInput): Promise<AgentForkResult>;
|
|
300
|
+
context(agentId: string, task?: any): Promise<string>;
|
|
301
|
+
completeTask(result?: any): Promise<AgentCompleteTaskResult>;
|
|
302
|
+
failTask(error: string): Promise<AgentFailTaskResult>;
|
|
230
303
|
}
|
|
231
304
|
|
|
232
305
|
interface JobManagerVenue {
|
|
@@ -254,6 +327,9 @@ interface AssetManagerVenue {
|
|
|
254
327
|
auth: {
|
|
255
328
|
apply(headers: Record<string, string>): void;
|
|
256
329
|
};
|
|
330
|
+
operations: {
|
|
331
|
+
run(assetId: string, input: any): Promise<any>;
|
|
332
|
+
};
|
|
257
333
|
}
|
|
258
334
|
declare class AssetManager {
|
|
259
335
|
private venue;
|
|
@@ -291,6 +367,12 @@ declare class AssetManager {
|
|
|
291
367
|
* @param assetId - Asset identifier
|
|
292
368
|
*/
|
|
293
369
|
getContent(assetId: string): Promise<ReadableStream<Uint8Array> | null>;
|
|
370
|
+
/**
|
|
371
|
+
* Pin a resolvable value into the content-addressed asset store.
|
|
372
|
+
* Idempotent — same value produces the same hash.
|
|
373
|
+
* @param path - Source address (hex hash, /a/<hash>, /o/<name>, /v/<path>, DID URL, or workspace path)
|
|
374
|
+
*/
|
|
375
|
+
pin(path: string): Promise<AssetPinResult>;
|
|
294
376
|
/**
|
|
295
377
|
* Clear the asset cache.
|
|
296
378
|
*/
|
|
@@ -313,7 +395,7 @@ declare class OperationManager {
|
|
|
313
395
|
list(): Promise<OperationInfo[]>;
|
|
314
396
|
/**
|
|
315
397
|
* Get details of a named operation
|
|
316
|
-
* @param name - Operation name (e.g., "
|
|
398
|
+
* @param name - Operation name (e.g., "v/ops/schema/infer")
|
|
317
399
|
*/
|
|
318
400
|
get(name: string): Promise<OperationInfo>;
|
|
319
401
|
/**
|
|
@@ -347,6 +429,8 @@ declare class WorkspaceManager {
|
|
|
347
429
|
append(path: string, value: any): Promise<WorkspaceAppendResult>;
|
|
348
430
|
list(path?: string, limit?: number, offset?: number): Promise<WorkspaceListResult>;
|
|
349
431
|
slice(path: string, offset?: number, limit?: number): Promise<WorkspaceSliceResult>;
|
|
432
|
+
copy(from: string, to: string): Promise<WorkspaceCopyResult>;
|
|
433
|
+
inspect(paths: string | string[], budget?: number, compact?: boolean): Promise<WorkspaceInspectResult>;
|
|
350
434
|
}
|
|
351
435
|
|
|
352
436
|
interface UCANManagerVenue {
|
|
@@ -433,6 +517,13 @@ declare class Venue implements VenueInterface {
|
|
|
433
517
|
* @returns {Promise<Job>}
|
|
434
518
|
*/
|
|
435
519
|
getJob(jobId: string): Promise<Job>;
|
|
520
|
+
/**
|
|
521
|
+
* Get a lazy Agent handle for the given agent ID.
|
|
522
|
+
* No network round-trip — the agent is not verified to exist.
|
|
523
|
+
* @param agentId - Agent identifier
|
|
524
|
+
* @returns {Agent} An Agent instance bound to this venue
|
|
525
|
+
*/
|
|
526
|
+
agent(agentId: string): Agent;
|
|
436
527
|
/**
|
|
437
528
|
* List secret names
|
|
438
529
|
* @returns {Promise<string[]>}
|
|
@@ -511,6 +602,7 @@ interface VenueInterface {
|
|
|
511
602
|
listSecrets(): Promise<string[]>;
|
|
512
603
|
putSecret(name: string, value: string): Promise<void>;
|
|
513
604
|
deleteSecret(name: string): Promise<void>;
|
|
605
|
+
agent(agentId: string): Agent;
|
|
514
606
|
close(): void;
|
|
515
607
|
}
|
|
516
608
|
type AssetID = string;
|
|
@@ -678,6 +770,16 @@ interface AgentMessageResult {
|
|
|
678
770
|
agentId: string;
|
|
679
771
|
delivered: boolean;
|
|
680
772
|
}
|
|
773
|
+
interface AgentChatInput {
|
|
774
|
+
agentId: string;
|
|
775
|
+
message: any;
|
|
776
|
+
sessionId?: string;
|
|
777
|
+
}
|
|
778
|
+
interface AgentChatResult {
|
|
779
|
+
agentId: string;
|
|
780
|
+
sessionId: string;
|
|
781
|
+
response: any;
|
|
782
|
+
}
|
|
681
783
|
interface AgentTriggerInput {
|
|
682
784
|
agentId: string;
|
|
683
785
|
}
|
|
@@ -734,6 +836,57 @@ interface AgentCancelTaskInput {
|
|
|
734
836
|
agentId: string;
|
|
735
837
|
taskId: string;
|
|
736
838
|
}
|
|
839
|
+
interface AgentInfoResult {
|
|
840
|
+
agentId: string;
|
|
841
|
+
status: string;
|
|
842
|
+
config?: Record<string, any>;
|
|
843
|
+
stateConfig?: Record<string, any>;
|
|
844
|
+
timelineLength?: number;
|
|
845
|
+
tasks?: number;
|
|
846
|
+
error?: string;
|
|
847
|
+
}
|
|
848
|
+
interface AgentForkInput {
|
|
849
|
+
sourceId: string;
|
|
850
|
+
agentId: string;
|
|
851
|
+
config?: Record<string, any>;
|
|
852
|
+
includeTimeline?: boolean;
|
|
853
|
+
overwrite?: boolean;
|
|
854
|
+
}
|
|
855
|
+
interface AgentForkResult {
|
|
856
|
+
agentId: string;
|
|
857
|
+
status: string;
|
|
858
|
+
created: boolean;
|
|
859
|
+
forkedFrom: string;
|
|
860
|
+
}
|
|
861
|
+
interface AgentContextInput {
|
|
862
|
+
agentId: string;
|
|
863
|
+
task?: any;
|
|
864
|
+
}
|
|
865
|
+
interface AgentCompleteTaskResult {
|
|
866
|
+
agentId: string;
|
|
867
|
+
taskId: string;
|
|
868
|
+
status: string;
|
|
869
|
+
}
|
|
870
|
+
interface AgentFailTaskResult {
|
|
871
|
+
agentId: string;
|
|
872
|
+
taskId: string;
|
|
873
|
+
status: string;
|
|
874
|
+
}
|
|
875
|
+
interface AssetPinResult {
|
|
876
|
+
path: string;
|
|
877
|
+
hash: string;
|
|
878
|
+
}
|
|
879
|
+
interface WorkspaceCopyResult {
|
|
880
|
+
copied: boolean;
|
|
881
|
+
}
|
|
882
|
+
interface WorkspaceInspectInput {
|
|
883
|
+
paths: string | string[];
|
|
884
|
+
budget?: number;
|
|
885
|
+
compact?: boolean;
|
|
886
|
+
}
|
|
887
|
+
interface WorkspaceInspectResult {
|
|
888
|
+
result: any;
|
|
889
|
+
}
|
|
737
890
|
interface WorkspaceReadInput {
|
|
738
891
|
path: string;
|
|
739
892
|
maxSize?: number;
|
|
@@ -1010,4 +1163,4 @@ declare function decodePublicKey(multikey: string): Uint8Array;
|
|
|
1010
1163
|
*/
|
|
1011
1164
|
declare function didFromPublicKey(publicKey: Uint8Array): string;
|
|
1012
1165
|
|
|
1013
|
-
export { type AdapterInfo, type AdaptersResult, type AgentCancelTaskInput, type AgentCard, 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 };
|
|
1166
|
+
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 };
|