@covia/covia-sdk 1.8.0 → 1.9.0

package/dist/index.d.mts

@@ -20,6 +20,10 @@ declare class Agent {
     }): Promise<unknown>;
     cancelTask(taskId: string): Promise<unknown>;
     info(): Promise<AgentInfoResult>;
+    /** Page this agent's sessions through the job-free workspace Values API. */
+    listSessions(options?: AgentSessionListOptions): Promise<AgentSessionPage>;
+    /** Read one session through the job-free workspace Values API. */
+    getSession(sessionId: string): Promise<AgentSession>;
     /**
      * Fork this agent into a new agent.
      * @param agentId - ID for the new forked agent
@@ -215,7 +219,7 @@ declare class NoAuth extends Auth {
  * Adds `Authorization: Bearer <token>` to every request.
  *
  * Example:
- *   const venue = await Grid.connect("https://venue.covia.ai", new BearerAuth("my-token"));
+ *   const venue = await Grid.connect("https://your-venue.example.com", new BearerAuth("my-token"));
  */
 declare class BearerAuth extends Auth {
     private _token;
@@ -227,7 +231,7 @@ declare class BearerAuth extends Auth {
  * Adds `Authorization: Basic <base64(username:password)>` to every request.
  *
  * Example:
- *   const venue = await Grid.connect("https://venue.covia.ai", new BasicAuth("admin", "s3cret"));
+ *   const venue = await Grid.connect("https://your-venue.example.com", new BasicAuth("admin", "s3cret"));
  */
 declare class BasicAuth extends Auth {
     private _username;
@@ -244,7 +248,7 @@ declare class BasicAuth extends Auth {
  * Example:
  *   const auth = Ed25519Auth.generate();
  *   console.log(auth.getDID()); // did:key:z6Mk...
- *   const venue = await Grid.connect("https://venue.covia.ai", auth);
+ *   const venue = await Grid.connect("https://your-venue.example.com", auth);
  */
 declare class Ed25519Auth extends Auth {
     private _privateKey;
@@ -306,9 +310,8 @@ interface AdapterManagerVenue {
  * Adapter introspection for a venue.
  *
  * Reads go through the workspace manager, so they are job-free (`GET
- * /api/v1/values/*`, covia #177) on 0.3+ venues and transparently fall back
- * to the invoke path on older ones — the same job-free/fallback behaviour
- * every other workspace-backed read gets, rather than a hand-rolled fetch.
+ * /api/v1/values/*`, covia #177) on 0.3+ venues. Older venues reject rather
+ * than turning a metadata read into a persisted job.
  */
 declare class AdapterManager {
     private venue;
@@ -328,25 +331,31 @@ declare class AdapterManager {
     get(name: string): Promise<AdapterInfo | null>;
 }
 
-interface AgentManagerVenue {
+interface VenueRequestContext {
     baseUrl: string;
     venueId: string;
     auth: {
         apply(headers: Record<string, string>, audience?: string): void;
     };
+}
+
+interface AgentManagerVenue extends VenueRequestContext {
     operations: OperationRunner;
+    workspace: {
+        read(path: string, maxSize?: number): Promise<WorkspaceReadResult>;
+        slice(path: string, offset?: number, limit?: number): Promise<WorkspaceSliceResult>;
+    };
     lastKnownStatus?: StatusData;
 }
 declare class AgentManager {
     private venue;
     private agentsGetSupported;
     constructor(venue: AgentManagerVenue);
-    private _headers;
     /** Whether the venue serves `GET /api/v1/agents`: no if a probe already
      *  404'd, or if the venue's last known status identifies it as pre-0.4. */
     private supportsAgentsGet;
-    /** A job-free agents GET, falling back to the invoke path on pre-0.4 venues. */
-    private _agentsOr;
+    /** A job-free agents GET that rejects when the endpoint is unavailable. */
+    private agentsGet;
     create(input: AgentCreateInput): Promise<AgentCreateResult>;
     request(agentId: string, input?: unknown, wait?: boolean | number): Promise<AgentRequestResult>;
     message(agentId: string, message: unknown): Promise<AgentMessageResult>;
@@ -378,7 +387,7 @@ declare class AgentManager {
     /**
      * List the caller's agents. **Job-free** on covia ≥ 0.4: goes through
      * `GET /api/v1/agents` (covia#180) — synchronous, no Job persisted. Older
-     * venues transparently fall back to the invoke path (one probe, remembered).
+     * venues reject rather than silently creating a persisted Job.
      */
     list(includeTerminated?: boolean): Promise<AgentListResult>;
     delete(agentId: string, remove?: boolean): Promise<AgentDeleteResult>;
@@ -387,21 +396,24 @@ declare class AgentManager {
     update(input: AgentUpdateInput): Promise<unknown>;
     cancelTask(agentId: string, taskId: string): Promise<unknown>;
     /** Agent info. **Job-free** on covia ≥ 0.4 (`GET /api/v1/agents/{id}`,
-     *  covia#180); older venues fall back to the invoke path. */
+     *  covia#180); older venues require an explicit compatibility opt-in. */
     info(agentId: string): Promise<AgentInfoResult>;
+    /**
+     * Page an agent's sessions directly from `g/<agentId>/sessions`.
+     * This is a job-free Values read; session adapter-specific fields remain
+     * available on each record's `value` while common runtime fields are typed.
+     */
+    listSessions(agentId: string, options?: AgentSessionListOptions): Promise<AgentSessionPage>;
+    /** Read one agent session directly from the workspace Values surface. */
+    getSession(agentId: string, sessionId: string): Promise<AgentSession>;
+    private _readLargeSession;
     fork(input: AgentForkInput): Promise<AgentForkResult>;
     context(agentId: string, task?: unknown): Promise<string>;
     completeTask(result?: unknown): Promise<AgentCompleteTaskResult>;
     failTask(error: string): Promise<AgentFailTaskResult>;
 }
 
-interface JobManagerVenue {
-    baseUrl: string;
-    venueId: string;
-    auth: {
-        apply(headers: Record<string, string>, audience?: string): void;
-    };
-}
+type JobManagerVenue = VenueRequestContext;
 declare class JobManager {
     private venue;
     constructor(venue: JobManagerVenue);
@@ -413,19 +425,14 @@ declare class JobManager {
     resume(jobId: string): Promise<JobMetadata>;
     sendMessage(jobId: string, message: unknown): Promise<unknown>;
     stream(jobId: string): AsyncGenerator<SSEEvent>;
-    private _buildHeaders;
 }
 
-interface AssetManagerVenue {
-    baseUrl: string;
-    venueId: string;
-    auth: {
-        apply(headers: Record<string, string>, audience?: string): void;
-    };
+interface AssetManagerVenue extends VenueRequestContext {
     operations: OperationRunner;
 }
 declare class AssetManager {
     private venue;
+    private cache;
     constructor(venue: AssetManagerVenue);
     /**
      * Get an asset by lattice address.
@@ -476,15 +483,11 @@ declare class AssetManager {
      * Clear the asset cache.
      */
     clearCache(): void;
-    private _buildHeaders;
+    /** Clear the explicitly configured cross-session metadata store. */
+    clearPersistentCache(): void;
 }
 
-interface OperationManagerVenue {
-    baseUrl: string;
-    venueId: string;
-    auth: {
-        apply(headers: Record<string, string>, audience?: string): void;
-    };
+interface OperationManagerVenue extends VenueRequestContext {
     privateJobs?: boolean;
 }
 declare class OperationManager {
@@ -503,7 +506,7 @@ declare class OperationManager {
      * Execute an operation and wait for the result
      * @param assetId - Operation asset ID or named operation
      * @param input - Operation input parameters
-     * @param options - Invoke options (e.g., ucans)
+     * @param options - Execution options (e.g., ucans or private execution)
      */
     run<T = unknown>(assetId: string, input?: unknown, options?: InvokeOptions): Promise<T>;
     /**
@@ -522,15 +525,9 @@ declare class OperationManager {
      * @param options - Invoke options (e.g., ucans)
      */
     invoke(assetId: string, input?: unknown, options?: InvokeOptions): Promise<Job>;
-    private _buildHeaders;
 }
 
-interface WorkspaceManagerVenue {
-    baseUrl: string;
-    venueId: string;
-    auth: {
-        apply(headers: Record<string, string>, audience?: string): void;
-    };
+interface WorkspaceManagerVenue extends VenueRequestContext {
     operations: OperationRunner;
     lastKnownStatus?: StatusData;
 }
@@ -547,23 +544,15 @@ interface WorkspaceManagerVenue {
  * `operations.run`) — a mutation *should* leave an audit record.
  *
  * Paths resolve against the caller's own DID unless fully qualified
- * (`<DID>/w/...`). Reading another DID's namespace is capability-gated: the
- * job-free GET path carries only the caller's identity token, so a read that
- * needs UCAN **proof tokens** (`ucans`) transparently falls back to the invoke
- * path (the only transport that carries a proof array). Own-namespace reads —
- * the common case — never need this and stay fully job-free.
- *
- * Venues that predate the `/values` routes (< covia 0.3) are accommodated
- * here, not in application code: a 404 from the GET surface can only mean the
- * route is missing (an absent path is `200 {exists:false}`), so reads fall
- * back to the invoke path and the venue is remembered as pre-0.3 for the rest
- * of this manager's lifetime.
+ * (`<DID>/w/...`). Reads that require proof tokens, multi-path inspection, or
+ * a pre-0.3 venue cannot use the Values GET surface and reject by default.
+ * Applications may explicitly invoke the corresponding operation when
+ * creating a persisted job is intended.
  */
 declare class WorkspaceManager {
     private venue;
     private valuesSupported;
     constructor(venue: WorkspaceManagerVenue);
-    private _headers;
     /** GET a job-free `/api/v1/values/{op}` read; omit undefined params. */
     private _values;
     /**
@@ -573,8 +562,9 @@ declare class WorkspaceManager {
      * connect/`status()` may populate the status after this manager exists.
      */
     private supportsValues;
-    /** A job-free values read, falling back to the invoke path on pre-0.3 venues. */
-    private _valuesOr;
+    private unsupported;
+    /** A job-free Values read that rejects when the endpoint is unavailable. */
+    private valuesRead;
     read(path: string, maxSize?: number, ucans?: string[]): Promise<WorkspaceReadResult>;
     list(path?: string, limit?: number, offset?: number, ucans?: string[]): Promise<WorkspaceListResult>;
     slice(path: string, offset?: number, limit?: number, ucans?: string[]): Promise<WorkspaceSliceResult>;
@@ -650,6 +640,67 @@ declare class SecretManager {
     delete(name: string): Promise<void>;
 }
 
+/** Agent behaviour optionally attached to otherwise ordinary asset metadata. */
+interface SkillFacet {
+    tools?: readonly string[];
+    context?: readonly unknown[];
+}
+/** Metadata view exposed when an asset is being used as a skill. */
+type SkillMetadata = AssetMetadata & {
+    skill?: SkillFacet;
+};
+/** A skill is an ordinary Asset viewed with its optional skill metadata facet. */
+type Skill = Asset & {
+    metadata: SkillMetadata;
+};
+interface SkillManagerVenue {
+    workspace: {
+        list(path?: string, limit?: number, offset?: number): Promise<WorkspaceListResult>;
+    };
+    assets: {
+        get(path: string): Promise<Asset>;
+    };
+}
+/**
+ * Thin, job-free convenience over workspace collections and ordinary assets.
+ *
+ * Skill discovery, precedence and search are application policy. This manager
+ * only lists the asset objects at one location or gets the asset at one path.
+ */
+declare class SkillManager {
+    private venue;
+    constructor(venue: SkillManagerVenue);
+    /** Return every skill asset directly contained at `path`. */
+    list(path: string): Promise<Skill[]>;
+    /** Return the ordinary asset at exactly `path`, with typed skill metadata. */
+    get(path: string): Promise<Skill>;
+}
+
+interface MemoryManagerVenue {
+    workspace: {
+        read(path: string, maxSize?: number): Promise<WorkspaceReadResult>;
+        slice(path: string, offset?: number, limit?: number): Promise<WorkspaceSliceResult>;
+    };
+    operations: OperationRunner;
+}
+/** Structured access to the venue's conventional per-user memory list. */
+declare class MemoryManager {
+    private venue;
+    constructor(venue: MemoryManagerVenue);
+    /**
+     * Read memory directly from the workspace Values surface. This is job-free;
+     * unlike `v/ops/memory {command:'recall'}`, it returns structured entries
+     * rather than an LLM-oriented numbered text block.
+     */
+    list(path?: string): Promise<MemoryEntry[]>;
+    /** Append a memory entry. Mutations intentionally remain audited Jobs. */
+    remember(text: string, path?: string): Promise<MemoryChange>;
+    /** Replace a 1-based memory entry. Mutations intentionally remain audited Jobs. */
+    update(number: number, text: string, path?: string): Promise<MemoryChange>;
+    /** Remove a 1-based memory entry. Mutations intentionally remain audited Jobs. */
+    forget(number: number, path?: string): Promise<MemoryChange>;
+}
+
 /**
  * Resolve a non-DID venue id into the ordered list of base URLs that
  * {@link Venue.connect} will try in turn. Explicit `http(s)://` inputs are
@@ -660,7 +711,13 @@ declare class SecretManager {
  */
 declare function venueBaseUrlCandidates(venueId: string): string[];
 declare class Venue implements VenueInterface {
-    /** Connection-level private-jobs mode — see {@link setPrivate}. */
+    private _closed;
+    /** Whether this handle has been closed and should not be reused by Grid. */
+    get closed(): boolean;
+    /**
+     * Connection-level private-jobs mode — see {@link setPrivate}.
+     * @deprecated Pass `{ private: true }` to `operations.run()` instead.
+     */
     privateJobs: boolean;
     /**
      * Puts this connection in **private-jobs mode**: every subsequent
@@ -670,7 +727,10 @@ declare class Venue implements VenueInterface {
      *
      * Because a completed private job is immediately forgotten, results are
      * collected through the invoke `wait` window rather than polling — so
-     * private mode works with `run()`; a poll-style `invoke()` throws.
+    * private mode works with `run()`; a poll-style `invoke()` throws.
+     *
+     * @deprecated Pass `{ private: true }` to `operations.run()` instead. The
+     * per-call option avoids mutable connection-wide execution state.
      */
     setPrivate(enabled: boolean): void;
     baseUrl: string;
@@ -693,6 +753,8 @@ declare class Venue implements VenueInterface {
     private _workspace?;
     private _ucan?;
     private _secrets?;
+    private _skills?;
+    private _memory?;
     get adapters(): AdapterManager;
     get agents(): AgentManager;
     get jobs(): JobManager;
@@ -701,6 +763,8 @@ declare class Venue implements VenueInterface {
     get workspace(): WorkspaceManager;
     get ucan(): UCANManager;
     get secrets(): SecretManager;
+    get skills(): SkillManager;
+    get memory(): MemoryManager;
     constructor(options?: VenueOptions);
     /**
      * Connect to a venue, validating it with `GET {base}/api/v1/status`. If the
@@ -814,7 +878,6 @@ declare class Venue implements VenueInterface {
      * Disposable support — allows `using venue = await Grid.connect(...)` in TS 5.2+.
      */
     [Symbol.dispose](): void;
-    private _buildHeaders;
 }
 
 interface VenueOptions {
@@ -832,6 +895,8 @@ interface VenueConstructor {
 }
 interface InvokeOptions {
     ucans?: string[];
+    /** Execute this run as a memory-only private job. Only supported by `run()`. */
+    private?: boolean;
 }
 /**
  * The venue's operation-execution surface, as the typed managers consume it.
@@ -1118,6 +1183,37 @@ interface AgentInfoResult {
     tasks?: number;
     error?: string;
 }
+/** Metadata stored on a conversational agent session. Venues may add fields. */
+interface AgentSessionMetadata {
+    id?: string;
+    parties?: string[];
+    title?: string;
+    status?: string;
+    created?: number;
+    started?: number;
+    lastActivity?: number;
+    turns?: number;
+    turnCount?: number;
+    [key: string]: unknown;
+}
+/** A session record read directly from `g/<agentId>/sessions`. */
+interface AgentSession {
+    id: string;
+    metadata: AgentSessionMetadata;
+    pending: unknown[];
+    frames: unknown[];
+    wakeTime?: number;
+}
+interface AgentSessionListOptions {
+    offset?: number;
+    limit?: number;
+}
+interface AgentSessionPage {
+    items: AgentSession[];
+    total: number;
+    offset: number;
+    limit: number;
+}
 interface AgentForkInput {
     sourceId: string;
     agentId: string;
@@ -1260,6 +1356,18 @@ interface WorkspaceAggregateResult {
      *  Σ(group counts) == count. */
     groups?: Record<string, GroupCount>;
 }
+interface MemoryEntry {
+    /** 1-based position used by the venue memory mutation operation. */
+    number: number;
+    text: string;
+    createdAt?: number;
+    updatedAt?: number;
+}
+/** Position affected by a memory mutation and the resulting list size. */
+interface MemoryChange {
+    number: number;
+    count: number;
+}
 interface UCANAttenuation {
     with: string;
     can: string;
@@ -1346,6 +1454,15 @@ interface ConnectionAttempt {
     readonly method: string;
     readonly error: CoviaError;
 }
+/**
+ * Raised when a requested read has no job-free transport on the connected
+ * venue. Callers may explicitly invoke the corresponding operation when
+ * creating a persisted job is the intended action.
+ */
+declare class UnsupportedVenueFeatureError extends CoviaError {
+    readonly feature: string;
+    constructor(feature: string);
+}
 interface CoviaConnectionErrorOptions {
     /** Exact request target for a single transport failure. */
     url?: string;
@@ -1391,7 +1508,6 @@ declare class JobFailedError extends CoviaError {
     jobData: JobMetadata;
     constructor(jobData: JobMetadata);
 }
-/** Raised when a requested resource is not found (404). */
 /** HTTP 429 from the venue — a rate limit or concurrent-job cap. Carries the
  *  server's Retry-After hint (seconds). Thrown only after the SDK's bounded
  *  automatic retries are exhausted. */
@@ -1399,6 +1515,7 @@ declare class RateLimitError extends GridError {
     retryAfterSeconds: number;
     constructor(message: string, retryAfterSeconds: number, body?: unknown);
 }
+/** Raised when a requested resource is not found (404). */
 declare class NotFoundError extends GridError {
     constructor(message: string);
 }
@@ -1412,6 +1529,12 @@ declare class JobNotFoundError extends NotFoundError {
     jobId: string;
     constructor(jobId: string);
 }
+/** Raised when an exact agent-session lookup finds no session. */
+declare class AgentSessionNotFoundError extends CoviaError {
+    readonly agentId: string;
+    readonly sessionId: string;
+    constructor(agentId: string, sessionId: string);
+}
 
 /** Parse a Retry-After header (delta-seconds or HTTP-date) to ms from now. */
 declare function parseRetryAfterMs(header: string | null, nowMs: number): number;
@@ -1613,6 +1736,11 @@ declare function generateKeyPair(): {
 declare function privateKeyToHex(key: Uint8Array): string;
 /**
  * Convert a hex string back to a private key Uint8Array.
+ *
+ * Strict by design: this is an identity primitive that round-trips through
+ * storage, and lax parsing would turn a corrupted stored key into a
+ * *different valid key* (a new DID) with no error. Accepts exactly 64 hex
+ * chars, with an optional `0x` prefix.
  */
 declare function hexToPrivateKey(hex: string): Uint8Array;
 
@@ -1697,4 +1825,4 @@ declare function grant(ownerPrivateKey: Uint8Array, audienceDID: string, withRes
  */
 declare function relayDelegation(privateKey: Uint8Array, venueDID: string, lifetimeSeconds: number, caps?: UCANCapability[]): string;
 
-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 };
+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 };