@covia/covia-sdk 1.8.0 → 1.9.1
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/README.md +98 -33
- package/dist/index.d.mts +203 -60
- package/dist/index.d.ts +203 -60
- package/dist/index.js +516 -156
- package/dist/index.mjs +513 -157
- package/package.json +9 -4
package/dist/index.d.mts
CHANGED
|
@@ -20,6 +20,10 @@ declare class Agent {
|
|
|
20
20
|
}): Promise<unknown>;
|
|
21
21
|
cancelTask(taskId: string): Promise<unknown>;
|
|
22
22
|
info(): Promise<AgentInfoResult>;
|
|
23
|
+
/** Page this agent's sessions through the job-free workspace Values API. */
|
|
24
|
+
listSessions(options?: AgentSessionListOptions): Promise<AgentSessionPage>;
|
|
25
|
+
/** Read one session through the job-free workspace Values API. */
|
|
26
|
+
getSession(sessionId: string): Promise<AgentSession>;
|
|
23
27
|
/**
|
|
24
28
|
* Fork this agent into a new agent.
|
|
25
29
|
* @param agentId - ID for the new forked agent
|
|
@@ -215,7 +219,7 @@ declare class NoAuth extends Auth {
|
|
|
215
219
|
* Adds `Authorization: Bearer <token>` to every request.
|
|
216
220
|
*
|
|
217
221
|
* Example:
|
|
218
|
-
* const venue = await Grid.connect("https://venue.
|
|
222
|
+
* const venue = await Grid.connect("https://your-venue.example.com", new BearerAuth("my-token"));
|
|
219
223
|
*/
|
|
220
224
|
declare class BearerAuth extends Auth {
|
|
221
225
|
private _token;
|
|
@@ -227,7 +231,7 @@ declare class BearerAuth extends Auth {
|
|
|
227
231
|
* Adds `Authorization: Basic <base64(username:password)>` to every request.
|
|
228
232
|
*
|
|
229
233
|
* Example:
|
|
230
|
-
* const venue = await Grid.connect("https://venue.
|
|
234
|
+
* const venue = await Grid.connect("https://your-venue.example.com", new BasicAuth("admin", "s3cret"));
|
|
231
235
|
*/
|
|
232
236
|
declare class BasicAuth extends Auth {
|
|
233
237
|
private _username;
|
|
@@ -244,7 +248,7 @@ declare class BasicAuth extends Auth {
|
|
|
244
248
|
* Example:
|
|
245
249
|
* const auth = Ed25519Auth.generate();
|
|
246
250
|
* console.log(auth.getDID()); // did:key:z6Mk...
|
|
247
|
-
* const venue = await Grid.connect("https://venue.
|
|
251
|
+
* const venue = await Grid.connect("https://your-venue.example.com", auth);
|
|
248
252
|
*/
|
|
249
253
|
declare class Ed25519Auth extends Auth {
|
|
250
254
|
private _privateKey;
|
|
@@ -258,6 +262,21 @@ declare class Ed25519Auth extends Auth {
|
|
|
258
262
|
*/
|
|
259
263
|
constructor(privateKey: Uint8Array, tokenLifetimeSeconds?: number);
|
|
260
264
|
apply(headers: Record<string, string>, audience?: string): void;
|
|
265
|
+
/**
|
|
266
|
+
* Mint a bearer-usable identity JWT for this key — the same token
|
|
267
|
+
* {@link apply} attaches to every request, exposed for callers that need
|
|
268
|
+
* to present this identity elsewhere (CLI tools, curl, another client:
|
|
269
|
+
* `Authorization: Bearer <token>`).
|
|
270
|
+
*
|
|
271
|
+
* An explicitly-pinned {@link audience} wins; otherwise the JWT `aud` is
|
|
272
|
+
* bound to the venue DID given here. A token with no `aud` is replayable
|
|
273
|
+
* at any venue that accepts the caller's DID, so minting one is refused
|
|
274
|
+
* rather than silently weakened.
|
|
275
|
+
*
|
|
276
|
+
* @param audience - The venue DID the token is bound to (`aud` claim).
|
|
277
|
+
* @param lifetimeSeconds - Token lifetime; defaults to this instance's.
|
|
278
|
+
*/
|
|
279
|
+
identityToken(audience?: string, lifetimeSeconds?: number): string;
|
|
261
280
|
/** The caller's DID derived from the public key. */
|
|
262
281
|
getDID(): string;
|
|
263
282
|
/**
|
|
@@ -306,9 +325,8 @@ interface AdapterManagerVenue {
|
|
|
306
325
|
* Adapter introspection for a venue.
|
|
307
326
|
*
|
|
308
327
|
* Reads go through the workspace manager, so they are job-free (`GET
|
|
309
|
-
* /api/v1/values/*`, covia #177) on 0.3+ venues
|
|
310
|
-
*
|
|
311
|
-
* every other workspace-backed read gets, rather than a hand-rolled fetch.
|
|
328
|
+
* /api/v1/values/*`, covia #177) on 0.3+ venues. Older venues reject rather
|
|
329
|
+
* than turning a metadata read into a persisted job.
|
|
312
330
|
*/
|
|
313
331
|
declare class AdapterManager {
|
|
314
332
|
private venue;
|
|
@@ -328,25 +346,31 @@ declare class AdapterManager {
|
|
|
328
346
|
get(name: string): Promise<AdapterInfo | null>;
|
|
329
347
|
}
|
|
330
348
|
|
|
331
|
-
interface
|
|
349
|
+
interface VenueRequestContext {
|
|
332
350
|
baseUrl: string;
|
|
333
351
|
venueId: string;
|
|
334
352
|
auth: {
|
|
335
353
|
apply(headers: Record<string, string>, audience?: string): void;
|
|
336
354
|
};
|
|
355
|
+
}
|
|
356
|
+
|
|
357
|
+
interface AgentManagerVenue extends VenueRequestContext {
|
|
337
358
|
operations: OperationRunner;
|
|
359
|
+
workspace: {
|
|
360
|
+
read(path: string, maxSize?: number): Promise<WorkspaceReadResult>;
|
|
361
|
+
slice(path: string, offset?: number, limit?: number): Promise<WorkspaceSliceResult>;
|
|
362
|
+
};
|
|
338
363
|
lastKnownStatus?: StatusData;
|
|
339
364
|
}
|
|
340
365
|
declare class AgentManager {
|
|
341
366
|
private venue;
|
|
342
367
|
private agentsGetSupported;
|
|
343
368
|
constructor(venue: AgentManagerVenue);
|
|
344
|
-
private _headers;
|
|
345
369
|
/** Whether the venue serves `GET /api/v1/agents`: no if a probe already
|
|
346
370
|
* 404'd, or if the venue's last known status identifies it as pre-0.4. */
|
|
347
371
|
private supportsAgentsGet;
|
|
348
|
-
/** A job-free agents GET
|
|
349
|
-
private
|
|
372
|
+
/** A job-free agents GET that rejects when the endpoint is unavailable. */
|
|
373
|
+
private agentsGet;
|
|
350
374
|
create(input: AgentCreateInput): Promise<AgentCreateResult>;
|
|
351
375
|
request(agentId: string, input?: unknown, wait?: boolean | number): Promise<AgentRequestResult>;
|
|
352
376
|
message(agentId: string, message: unknown): Promise<AgentMessageResult>;
|
|
@@ -378,7 +402,7 @@ declare class AgentManager {
|
|
|
378
402
|
/**
|
|
379
403
|
* List the caller's agents. **Job-free** on covia ≥ 0.4: goes through
|
|
380
404
|
* `GET /api/v1/agents` (covia#180) — synchronous, no Job persisted. Older
|
|
381
|
-
* venues
|
|
405
|
+
* venues reject rather than silently creating a persisted Job.
|
|
382
406
|
*/
|
|
383
407
|
list(includeTerminated?: boolean): Promise<AgentListResult>;
|
|
384
408
|
delete(agentId: string, remove?: boolean): Promise<AgentDeleteResult>;
|
|
@@ -387,21 +411,24 @@ declare class AgentManager {
|
|
|
387
411
|
update(input: AgentUpdateInput): Promise<unknown>;
|
|
388
412
|
cancelTask(agentId: string, taskId: string): Promise<unknown>;
|
|
389
413
|
/** Agent info. **Job-free** on covia ≥ 0.4 (`GET /api/v1/agents/{id}`,
|
|
390
|
-
* covia#180); older venues
|
|
414
|
+
* covia#180); older venues require an explicit compatibility opt-in. */
|
|
391
415
|
info(agentId: string): Promise<AgentInfoResult>;
|
|
416
|
+
/**
|
|
417
|
+
* Page an agent's sessions directly from `g/<agentId>/sessions`.
|
|
418
|
+
* This is a job-free Values read; session adapter-specific fields remain
|
|
419
|
+
* available on each record's `value` while common runtime fields are typed.
|
|
420
|
+
*/
|
|
421
|
+
listSessions(agentId: string, options?: AgentSessionListOptions): Promise<AgentSessionPage>;
|
|
422
|
+
/** Read one agent session directly from the workspace Values surface. */
|
|
423
|
+
getSession(agentId: string, sessionId: string): Promise<AgentSession>;
|
|
424
|
+
private _readLargeSession;
|
|
392
425
|
fork(input: AgentForkInput): Promise<AgentForkResult>;
|
|
393
426
|
context(agentId: string, task?: unknown): Promise<string>;
|
|
394
427
|
completeTask(result?: unknown): Promise<AgentCompleteTaskResult>;
|
|
395
428
|
failTask(error: string): Promise<AgentFailTaskResult>;
|
|
396
429
|
}
|
|
397
430
|
|
|
398
|
-
|
|
399
|
-
baseUrl: string;
|
|
400
|
-
venueId: string;
|
|
401
|
-
auth: {
|
|
402
|
-
apply(headers: Record<string, string>, audience?: string): void;
|
|
403
|
-
};
|
|
404
|
-
}
|
|
431
|
+
type JobManagerVenue = VenueRequestContext;
|
|
405
432
|
declare class JobManager {
|
|
406
433
|
private venue;
|
|
407
434
|
constructor(venue: JobManagerVenue);
|
|
@@ -413,19 +440,14 @@ declare class JobManager {
|
|
|
413
440
|
resume(jobId: string): Promise<JobMetadata>;
|
|
414
441
|
sendMessage(jobId: string, message: unknown): Promise<unknown>;
|
|
415
442
|
stream(jobId: string): AsyncGenerator<SSEEvent>;
|
|
416
|
-
private _buildHeaders;
|
|
417
443
|
}
|
|
418
444
|
|
|
419
|
-
interface AssetManagerVenue {
|
|
420
|
-
baseUrl: string;
|
|
421
|
-
venueId: string;
|
|
422
|
-
auth: {
|
|
423
|
-
apply(headers: Record<string, string>, audience?: string): void;
|
|
424
|
-
};
|
|
445
|
+
interface AssetManagerVenue extends VenueRequestContext {
|
|
425
446
|
operations: OperationRunner;
|
|
426
447
|
}
|
|
427
448
|
declare class AssetManager {
|
|
428
449
|
private venue;
|
|
450
|
+
private cache;
|
|
429
451
|
constructor(venue: AssetManagerVenue);
|
|
430
452
|
/**
|
|
431
453
|
* Get an asset by lattice address.
|
|
@@ -476,15 +498,11 @@ declare class AssetManager {
|
|
|
476
498
|
* Clear the asset cache.
|
|
477
499
|
*/
|
|
478
500
|
clearCache(): void;
|
|
479
|
-
|
|
501
|
+
/** Clear the explicitly configured cross-session metadata store. */
|
|
502
|
+
clearPersistentCache(): void;
|
|
480
503
|
}
|
|
481
504
|
|
|
482
|
-
interface OperationManagerVenue {
|
|
483
|
-
baseUrl: string;
|
|
484
|
-
venueId: string;
|
|
485
|
-
auth: {
|
|
486
|
-
apply(headers: Record<string, string>, audience?: string): void;
|
|
487
|
-
};
|
|
505
|
+
interface OperationManagerVenue extends VenueRequestContext {
|
|
488
506
|
privateJobs?: boolean;
|
|
489
507
|
}
|
|
490
508
|
declare class OperationManager {
|
|
@@ -503,7 +521,7 @@ declare class OperationManager {
|
|
|
503
521
|
* Execute an operation and wait for the result
|
|
504
522
|
* @param assetId - Operation asset ID or named operation
|
|
505
523
|
* @param input - Operation input parameters
|
|
506
|
-
* @param options -
|
|
524
|
+
* @param options - Execution options (e.g., ucans or private execution)
|
|
507
525
|
*/
|
|
508
526
|
run<T = unknown>(assetId: string, input?: unknown, options?: InvokeOptions): Promise<T>;
|
|
509
527
|
/**
|
|
@@ -522,15 +540,9 @@ declare class OperationManager {
|
|
|
522
540
|
* @param options - Invoke options (e.g., ucans)
|
|
523
541
|
*/
|
|
524
542
|
invoke(assetId: string, input?: unknown, options?: InvokeOptions): Promise<Job>;
|
|
525
|
-
private _buildHeaders;
|
|
526
543
|
}
|
|
527
544
|
|
|
528
|
-
interface WorkspaceManagerVenue {
|
|
529
|
-
baseUrl: string;
|
|
530
|
-
venueId: string;
|
|
531
|
-
auth: {
|
|
532
|
-
apply(headers: Record<string, string>, audience?: string): void;
|
|
533
|
-
};
|
|
545
|
+
interface WorkspaceManagerVenue extends VenueRequestContext {
|
|
534
546
|
operations: OperationRunner;
|
|
535
547
|
lastKnownStatus?: StatusData;
|
|
536
548
|
}
|
|
@@ -547,23 +559,15 @@ interface WorkspaceManagerVenue {
|
|
|
547
559
|
* `operations.run`) — a mutation *should* leave an audit record.
|
|
548
560
|
*
|
|
549
561
|
* Paths resolve against the caller's own DID unless fully qualified
|
|
550
|
-
* (`<DID>/w/...`).
|
|
551
|
-
*
|
|
552
|
-
*
|
|
553
|
-
*
|
|
554
|
-
* the common case — never need this and stay fully job-free.
|
|
555
|
-
*
|
|
556
|
-
* Venues that predate the `/values` routes (< covia 0.3) are accommodated
|
|
557
|
-
* here, not in application code: a 404 from the GET surface can only mean the
|
|
558
|
-
* route is missing (an absent path is `200 {exists:false}`), so reads fall
|
|
559
|
-
* back to the invoke path and the venue is remembered as pre-0.3 for the rest
|
|
560
|
-
* of this manager's lifetime.
|
|
562
|
+
* (`<DID>/w/...`). Reads that require proof tokens, multi-path inspection, or
|
|
563
|
+
* a pre-0.3 venue cannot use the Values GET surface and reject by default.
|
|
564
|
+
* Applications may explicitly invoke the corresponding operation when
|
|
565
|
+
* creating a persisted job is intended.
|
|
561
566
|
*/
|
|
562
567
|
declare class WorkspaceManager {
|
|
563
568
|
private venue;
|
|
564
569
|
private valuesSupported;
|
|
565
570
|
constructor(venue: WorkspaceManagerVenue);
|
|
566
|
-
private _headers;
|
|
567
571
|
/** GET a job-free `/api/v1/values/{op}` read; omit undefined params. */
|
|
568
572
|
private _values;
|
|
569
573
|
/**
|
|
@@ -573,8 +577,9 @@ declare class WorkspaceManager {
|
|
|
573
577
|
* connect/`status()` may populate the status after this manager exists.
|
|
574
578
|
*/
|
|
575
579
|
private supportsValues;
|
|
576
|
-
|
|
577
|
-
|
|
580
|
+
private unsupported;
|
|
581
|
+
/** A job-free Values read that rejects when the endpoint is unavailable. */
|
|
582
|
+
private valuesRead;
|
|
578
583
|
read(path: string, maxSize?: number, ucans?: string[]): Promise<WorkspaceReadResult>;
|
|
579
584
|
list(path?: string, limit?: number, offset?: number, ucans?: string[]): Promise<WorkspaceListResult>;
|
|
580
585
|
slice(path: string, offset?: number, limit?: number, ucans?: string[]): Promise<WorkspaceSliceResult>;
|
|
@@ -650,6 +655,67 @@ declare class SecretManager {
|
|
|
650
655
|
delete(name: string): Promise<void>;
|
|
651
656
|
}
|
|
652
657
|
|
|
658
|
+
/** Agent behaviour optionally attached to otherwise ordinary asset metadata. */
|
|
659
|
+
interface SkillFacet {
|
|
660
|
+
tools?: readonly string[];
|
|
661
|
+
context?: readonly unknown[];
|
|
662
|
+
}
|
|
663
|
+
/** Metadata view exposed when an asset is being used as a skill. */
|
|
664
|
+
type SkillMetadata = AssetMetadata & {
|
|
665
|
+
skill?: SkillFacet;
|
|
666
|
+
};
|
|
667
|
+
/** A skill is an ordinary Asset viewed with its optional skill metadata facet. */
|
|
668
|
+
type Skill = Asset & {
|
|
669
|
+
metadata: SkillMetadata;
|
|
670
|
+
};
|
|
671
|
+
interface SkillManagerVenue {
|
|
672
|
+
workspace: {
|
|
673
|
+
list(path?: string, limit?: number, offset?: number): Promise<WorkspaceListResult>;
|
|
674
|
+
};
|
|
675
|
+
assets: {
|
|
676
|
+
get(path: string): Promise<Asset>;
|
|
677
|
+
};
|
|
678
|
+
}
|
|
679
|
+
/**
|
|
680
|
+
* Thin, job-free convenience over workspace collections and ordinary assets.
|
|
681
|
+
*
|
|
682
|
+
* Skill discovery, precedence and search are application policy. This manager
|
|
683
|
+
* only lists the asset objects at one location or gets the asset at one path.
|
|
684
|
+
*/
|
|
685
|
+
declare class SkillManager {
|
|
686
|
+
private venue;
|
|
687
|
+
constructor(venue: SkillManagerVenue);
|
|
688
|
+
/** Return every skill asset directly contained at `path`. */
|
|
689
|
+
list(path: string): Promise<Skill[]>;
|
|
690
|
+
/** Return the ordinary asset at exactly `path`, with typed skill metadata. */
|
|
691
|
+
get(path: string): Promise<Skill>;
|
|
692
|
+
}
|
|
693
|
+
|
|
694
|
+
interface MemoryManagerVenue {
|
|
695
|
+
workspace: {
|
|
696
|
+
read(path: string, maxSize?: number): Promise<WorkspaceReadResult>;
|
|
697
|
+
slice(path: string, offset?: number, limit?: number): Promise<WorkspaceSliceResult>;
|
|
698
|
+
};
|
|
699
|
+
operations: OperationRunner;
|
|
700
|
+
}
|
|
701
|
+
/** Structured access to the venue's conventional per-user memory list. */
|
|
702
|
+
declare class MemoryManager {
|
|
703
|
+
private venue;
|
|
704
|
+
constructor(venue: MemoryManagerVenue);
|
|
705
|
+
/**
|
|
706
|
+
* Read memory directly from the workspace Values surface. This is job-free;
|
|
707
|
+
* unlike `v/ops/memory {command:'recall'}`, it returns structured entries
|
|
708
|
+
* rather than an LLM-oriented numbered text block.
|
|
709
|
+
*/
|
|
710
|
+
list(path?: string): Promise<MemoryEntry[]>;
|
|
711
|
+
/** Append a memory entry. Mutations intentionally remain audited Jobs. */
|
|
712
|
+
remember(text: string, path?: string): Promise<MemoryChange>;
|
|
713
|
+
/** Replace a 1-based memory entry. Mutations intentionally remain audited Jobs. */
|
|
714
|
+
update(number: number, text: string, path?: string): Promise<MemoryChange>;
|
|
715
|
+
/** Remove a 1-based memory entry. Mutations intentionally remain audited Jobs. */
|
|
716
|
+
forget(number: number, path?: string): Promise<MemoryChange>;
|
|
717
|
+
}
|
|
718
|
+
|
|
653
719
|
/**
|
|
654
720
|
* Resolve a non-DID venue id into the ordered list of base URLs that
|
|
655
721
|
* {@link Venue.connect} will try in turn. Explicit `http(s)://` inputs are
|
|
@@ -660,7 +726,13 @@ declare class SecretManager {
|
|
|
660
726
|
*/
|
|
661
727
|
declare function venueBaseUrlCandidates(venueId: string): string[];
|
|
662
728
|
declare class Venue implements VenueInterface {
|
|
663
|
-
|
|
729
|
+
private _closed;
|
|
730
|
+
/** Whether this handle has been closed and should not be reused by Grid. */
|
|
731
|
+
get closed(): boolean;
|
|
732
|
+
/**
|
|
733
|
+
* Connection-level private-jobs mode — see {@link setPrivate}.
|
|
734
|
+
* @deprecated Pass `{ private: true }` to `operations.run()` instead.
|
|
735
|
+
*/
|
|
664
736
|
privateJobs: boolean;
|
|
665
737
|
/**
|
|
666
738
|
* Puts this connection in **private-jobs mode**: every subsequent
|
|
@@ -670,7 +742,10 @@ declare class Venue implements VenueInterface {
|
|
|
670
742
|
*
|
|
671
743
|
* Because a completed private job is immediately forgotten, results are
|
|
672
744
|
* collected through the invoke `wait` window rather than polling — so
|
|
673
|
-
|
|
745
|
+
* private mode works with `run()`; a poll-style `invoke()` throws.
|
|
746
|
+
*
|
|
747
|
+
* @deprecated Pass `{ private: true }` to `operations.run()` instead. The
|
|
748
|
+
* per-call option avoids mutable connection-wide execution state.
|
|
674
749
|
*/
|
|
675
750
|
setPrivate(enabled: boolean): void;
|
|
676
751
|
baseUrl: string;
|
|
@@ -693,6 +768,8 @@ declare class Venue implements VenueInterface {
|
|
|
693
768
|
private _workspace?;
|
|
694
769
|
private _ucan?;
|
|
695
770
|
private _secrets?;
|
|
771
|
+
private _skills?;
|
|
772
|
+
private _memory?;
|
|
696
773
|
get adapters(): AdapterManager;
|
|
697
774
|
get agents(): AgentManager;
|
|
698
775
|
get jobs(): JobManager;
|
|
@@ -701,6 +778,8 @@ declare class Venue implements VenueInterface {
|
|
|
701
778
|
get workspace(): WorkspaceManager;
|
|
702
779
|
get ucan(): UCANManager;
|
|
703
780
|
get secrets(): SecretManager;
|
|
781
|
+
get skills(): SkillManager;
|
|
782
|
+
get memory(): MemoryManager;
|
|
704
783
|
constructor(options?: VenueOptions);
|
|
705
784
|
/**
|
|
706
785
|
* Connect to a venue, validating it with `GET {base}/api/v1/status`. If the
|
|
@@ -814,7 +893,6 @@ declare class Venue implements VenueInterface {
|
|
|
814
893
|
* Disposable support — allows `using venue = await Grid.connect(...)` in TS 5.2+.
|
|
815
894
|
*/
|
|
816
895
|
[Symbol.dispose](): void;
|
|
817
|
-
private _buildHeaders;
|
|
818
896
|
}
|
|
819
897
|
|
|
820
898
|
interface VenueOptions {
|
|
@@ -832,6 +910,8 @@ interface VenueConstructor {
|
|
|
832
910
|
}
|
|
833
911
|
interface InvokeOptions {
|
|
834
912
|
ucans?: string[];
|
|
913
|
+
/** Execute this run as a memory-only private job. Only supported by `run()`. */
|
|
914
|
+
private?: boolean;
|
|
835
915
|
}
|
|
836
916
|
/**
|
|
837
917
|
* The venue's operation-execution surface, as the typed managers consume it.
|
|
@@ -1118,6 +1198,37 @@ interface AgentInfoResult {
|
|
|
1118
1198
|
tasks?: number;
|
|
1119
1199
|
error?: string;
|
|
1120
1200
|
}
|
|
1201
|
+
/** Metadata stored on a conversational agent session. Venues may add fields. */
|
|
1202
|
+
interface AgentSessionMetadata {
|
|
1203
|
+
id?: string;
|
|
1204
|
+
parties?: string[];
|
|
1205
|
+
title?: string;
|
|
1206
|
+
status?: string;
|
|
1207
|
+
created?: number;
|
|
1208
|
+
started?: number;
|
|
1209
|
+
lastActivity?: number;
|
|
1210
|
+
turns?: number;
|
|
1211
|
+
turnCount?: number;
|
|
1212
|
+
[key: string]: unknown;
|
|
1213
|
+
}
|
|
1214
|
+
/** A session record read directly from `g/<agentId>/sessions`. */
|
|
1215
|
+
interface AgentSession {
|
|
1216
|
+
id: string;
|
|
1217
|
+
metadata: AgentSessionMetadata;
|
|
1218
|
+
pending: unknown[];
|
|
1219
|
+
frames: unknown[];
|
|
1220
|
+
wakeTime?: number;
|
|
1221
|
+
}
|
|
1222
|
+
interface AgentSessionListOptions {
|
|
1223
|
+
offset?: number;
|
|
1224
|
+
limit?: number;
|
|
1225
|
+
}
|
|
1226
|
+
interface AgentSessionPage {
|
|
1227
|
+
items: AgentSession[];
|
|
1228
|
+
total: number;
|
|
1229
|
+
offset: number;
|
|
1230
|
+
limit: number;
|
|
1231
|
+
}
|
|
1121
1232
|
interface AgentForkInput {
|
|
1122
1233
|
sourceId: string;
|
|
1123
1234
|
agentId: string;
|
|
@@ -1260,6 +1371,18 @@ interface WorkspaceAggregateResult {
|
|
|
1260
1371
|
* Σ(group counts) == count. */
|
|
1261
1372
|
groups?: Record<string, GroupCount>;
|
|
1262
1373
|
}
|
|
1374
|
+
interface MemoryEntry {
|
|
1375
|
+
/** 1-based position used by the venue memory mutation operation. */
|
|
1376
|
+
number: number;
|
|
1377
|
+
text: string;
|
|
1378
|
+
createdAt?: number;
|
|
1379
|
+
updatedAt?: number;
|
|
1380
|
+
}
|
|
1381
|
+
/** Position affected by a memory mutation and the resulting list size. */
|
|
1382
|
+
interface MemoryChange {
|
|
1383
|
+
number: number;
|
|
1384
|
+
count: number;
|
|
1385
|
+
}
|
|
1263
1386
|
interface UCANAttenuation {
|
|
1264
1387
|
with: string;
|
|
1265
1388
|
can: string;
|
|
@@ -1346,6 +1469,15 @@ interface ConnectionAttempt {
|
|
|
1346
1469
|
readonly method: string;
|
|
1347
1470
|
readonly error: CoviaError;
|
|
1348
1471
|
}
|
|
1472
|
+
/**
|
|
1473
|
+
* Raised when a requested read has no job-free transport on the connected
|
|
1474
|
+
* venue. Callers may explicitly invoke the corresponding operation when
|
|
1475
|
+
* creating a persisted job is the intended action.
|
|
1476
|
+
*/
|
|
1477
|
+
declare class UnsupportedVenueFeatureError extends CoviaError {
|
|
1478
|
+
readonly feature: string;
|
|
1479
|
+
constructor(feature: string);
|
|
1480
|
+
}
|
|
1349
1481
|
interface CoviaConnectionErrorOptions {
|
|
1350
1482
|
/** Exact request target for a single transport failure. */
|
|
1351
1483
|
url?: string;
|
|
@@ -1391,7 +1523,6 @@ declare class JobFailedError extends CoviaError {
|
|
|
1391
1523
|
jobData: JobMetadata;
|
|
1392
1524
|
constructor(jobData: JobMetadata);
|
|
1393
1525
|
}
|
|
1394
|
-
/** Raised when a requested resource is not found (404). */
|
|
1395
1526
|
/** HTTP 429 from the venue — a rate limit or concurrent-job cap. Carries the
|
|
1396
1527
|
* server's Retry-After hint (seconds). Thrown only after the SDK's bounded
|
|
1397
1528
|
* automatic retries are exhausted. */
|
|
@@ -1399,6 +1530,7 @@ declare class RateLimitError extends GridError {
|
|
|
1399
1530
|
retryAfterSeconds: number;
|
|
1400
1531
|
constructor(message: string, retryAfterSeconds: number, body?: unknown);
|
|
1401
1532
|
}
|
|
1533
|
+
/** Raised when a requested resource is not found (404). */
|
|
1402
1534
|
declare class NotFoundError extends GridError {
|
|
1403
1535
|
constructor(message: string);
|
|
1404
1536
|
}
|
|
@@ -1412,6 +1544,12 @@ declare class JobNotFoundError extends NotFoundError {
|
|
|
1412
1544
|
jobId: string;
|
|
1413
1545
|
constructor(jobId: string);
|
|
1414
1546
|
}
|
|
1547
|
+
/** Raised when an exact agent-session lookup finds no session. */
|
|
1548
|
+
declare class AgentSessionNotFoundError extends CoviaError {
|
|
1549
|
+
readonly agentId: string;
|
|
1550
|
+
readonly sessionId: string;
|
|
1551
|
+
constructor(agentId: string, sessionId: string);
|
|
1552
|
+
}
|
|
1415
1553
|
|
|
1416
1554
|
/** Parse a Retry-After header (delta-seconds or HTTP-date) to ms from now. */
|
|
1417
1555
|
declare function parseRetryAfterMs(header: string | null, nowMs: number): number;
|
|
@@ -1613,6 +1751,11 @@ declare function generateKeyPair(): {
|
|
|
1613
1751
|
declare function privateKeyToHex(key: Uint8Array): string;
|
|
1614
1752
|
/**
|
|
1615
1753
|
* Convert a hex string back to a private key Uint8Array.
|
|
1754
|
+
*
|
|
1755
|
+
* Strict by design: this is an identity primitive that round-trips through
|
|
1756
|
+
* storage, and lax parsing would turn a corrupted stored key into a
|
|
1757
|
+
* *different valid key* (a new DID) with no error. Accepts exactly 64 hex
|
|
1758
|
+
* chars, with an optional `0x` prefix.
|
|
1616
1759
|
*/
|
|
1617
1760
|
declare function hexToPrivateKey(hex: string): Uint8Array;
|
|
1618
1761
|
|
|
@@ -1697,4 +1840,4 @@ declare function grant(ownerPrivateKey: Uint8Array, audienceDID: string, withRes
|
|
|
1697
1840
|
*/
|
|
1698
1841
|
declare function relayDelegation(privateKey: Uint8Array, venueDID: string, lifetimeSeconds: number, caps?: UCANCapability[]): string;
|
|
1699
1842
|
|
|
1700
|
-
export { type AdapterInfo, AdapterManager, 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 AgentRenameSessionResult, 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, type AssetMetadataStore, AssetNotFoundError, type AssetPinResult, Auth, BasicAuth, BearerAuth, ChatSession, type ConnectionAttempt, type ContentDetails, type ContentHashResult, CoviaConnectionError, type CoviaConnectionErrorOptions, CoviaError, CoviaTimeoutError, type Credentials, CredentialsHTTP, type DIDDocument, type DIDURL, DataAsset, Ed25519Auth, type FunctionInfo, type FunctionsResult, Grid, GridError, type GroupCount, type InvokeOptions, type InvokePayload, Job, JobFailedError, JobManager, type JobMetadata, JobNotFoundError, JobStatus, KeyPairAuth, type MCPDiscovery, Namespace, NoAuth, NotFoundError, Operation, type OperationDetails, type OperationInfo, OperationManager, type OperationPayload, type OperationRunner, RateLimitError, RunStatus, type SSEEvent, type SecretExtractInput, type SecretExtractResult, SecretManager, type SecretSetInput, type SecretSetResult, type StatsData, type StatusData, type UCANAttenuation, type UCANCapability, type UCANIssueInput, type UCANIssueResult, UCANManager, type UCANVerifyResult, VENUE_RELAY, Venue, type VenueConstructor, type VenueData, VenueIdentityChangedError, type VenueInterface, type VenueOptions, type WorkspaceAggregateResult, type WorkspaceAppendInput, type WorkspaceAppendResult, type WorkspaceCopyResult, type WorkspaceCountResult, 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, assetHash, createSSEEvent, createUCANJWT, decodePublicKey, didFor, didFromPublicKey, didMethod, didUrl, encodePublicKey, fetchStreamWithError, fetchWithError, generateKeyPair, getAssetIdFromPath, getAssetIdFromVenueId, getAssetMetadataStore, getParsedAssetId, grant, hexToPrivateKey, identityToken, isDid, isJobComplete, isJobFinished, isJobPaused, logger, parseDidUrl, parseRetryAfterMs, parseSSEStream, privateKeyToHex, relayDelegation, retryDelayMs, setAssetMetadataStore, venueBaseUrlCandidates };
|
|
1843
|
+
export { type AdapterInfo, AdapterManager, 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 AgentRenameSessionResult, type AgentRequestInput, type AgentRequestResult, type AgentResumeInput, type AgentSession, type AgentSessionListOptions, type AgentSessionMetadata, AgentSessionNotFoundError, type AgentSessionPage, AgentStatus, type AgentSuspendResult, type AgentTriggerInput, type AgentTriggerResult, type AgentUpdateInput, Asset, type AssetID, type AssetList, type AssetListOptions, AssetManager, type AssetMetadata, type AssetMetadataStore, AssetNotFoundError, type AssetPinResult, Auth, BasicAuth, BearerAuth, ChatSession, type ConnectionAttempt, type ContentDetails, type ContentHashResult, CoviaConnectionError, type CoviaConnectionErrorOptions, CoviaError, CoviaTimeoutError, type Credentials, CredentialsHTTP, type DIDDocument, type DIDURL, DataAsset, Ed25519Auth, type FunctionInfo, type FunctionsResult, Grid, GridError, type GroupCount, type InvokeOptions, type InvokePayload, Job, JobFailedError, JobManager, type JobMetadata, JobNotFoundError, JobStatus, KeyPairAuth, type MCPDiscovery, type MemoryChange, type MemoryEntry, MemoryManager, Namespace, NoAuth, NotFoundError, Operation, type OperationDetails, type OperationInfo, OperationManager, type OperationPayload, type OperationRunner, RateLimitError, RunStatus, type SSEEvent, type SecretExtractInput, type SecretExtractResult, SecretManager, type SecretSetInput, type SecretSetResult, type Skill, type SkillFacet, SkillManager, type SkillMetadata, type StatsData, type StatusData, type UCANAttenuation, type UCANCapability, type UCANIssueInput, type UCANIssueResult, UCANManager, type UCANVerifyResult, UnsupportedVenueFeatureError, VENUE_RELAY, Venue, type VenueConstructor, type VenueData, VenueIdentityChangedError, type VenueInterface, type VenueOptions, type WorkspaceAggregateResult, type WorkspaceAppendInput, type WorkspaceAppendResult, type WorkspaceCopyResult, type WorkspaceCountResult, 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, assetHash, createSSEEvent, createUCANJWT, decodePublicKey, didFor, didFromPublicKey, didMethod, didUrl, encodePublicKey, fetchStreamWithError, fetchWithError, generateKeyPair, getAssetIdFromPath, getAssetIdFromVenueId, getAssetMetadataStore, getParsedAssetId, grant, hexToPrivateKey, identityToken, isDid, isJobComplete, isJobFinished, isJobPaused, logger, parseDidUrl, parseRetryAfterMs, parseSSEStream, privateKeyToHex, relayDelegation, retryDelayMs, setAssetMetadataStore, venueBaseUrlCandidates };
|