@covia/covia-sdk 1.18.0 → 1.19.0

package/dist/index.d.mts

@@ -525,6 +525,14 @@ declare class AssetManager {
      * a mutable lattice path the venue resolves (`w/my-assets/foo`, `o/my-op`,
      * `<DID>/w/...`). Only content-addressed (immutable) refs are cached;
      * mutable paths are always re-fetched, so a changed value is never served stale.
+     *
+     * **Content-addressed refs are caller-relative, not global** (covia#502). A
+     * bare hash or `a/<hash>` names the asset in *your own* `a/` namespace, so it
+     * 404s for a hash someone else registered, and for an anonymous request.
+     * Address another owner's asset explicitly as `<ownerDID>/a/<hash>`, and the
+     * venue's own catalog as `<venueDID>/a/<hash>`. Only the DID-qualified form
+     * is portable, so only it is eligible for the cross-session metadata store;
+     * caller-relative refs are cached in memory on this manager alone.
      * @param assetId - Asset identifier or lattice address
      * @returns Returns either an Operation or DataAsset based on the asset's metadata
      */
@@ -651,6 +659,7 @@ declare class WorkspaceManager {
     private venue;
     private valuesSupported;
     private scopeExpansionSupported;
+    private fieldsSupported;
     constructor(venue: WorkspaceManagerVenue);
     /** GET a job-free `/api/v1/values/{op}` read; omit undefined params. */
     private _values;
@@ -695,6 +704,48 @@ declare class WorkspaceManager {
     _scopedRead<T>(op: string, params: Record<string, string | number | boolean | undefined>, scope: ExecutionScope): Promise<T>;
     read(path: string, maxSize?: number, ucans?: string[]): Promise<WorkspaceReadResult>;
     list(path?: string, limit?: number, offset?: number, ucans?: string[]): Promise<WorkspaceListResult>;
+    /**
+     * List a node's children *and* read named subpaths of each one, in a single
+     * round trip (covia#191) — the standard partial-response / sparse-fieldset
+     * pattern, and the cure for the collection-view N+1 that list-then-read-each
+     * forces on every page.
+     *
+     * ```ts
+     * const page = await venue.workspace.listFields('j', ['status', 'meta/updated'], { limit: 50 });
+     * page.values['<jobid>']['status']; // → { exists: true, value: 'COMPLETE' }
+     * ```
+     *
+     * Each field is defined as a `read` of `<path>/<key>/<field>` and carries
+     * single-read semantics verbatim: stored null is present, absent is
+     * `{exists:false}`, and a value past `maxSize` withholds `value` and sets
+     * `truncated`. Projection applies *after* the `limit`/`offset` key page, so
+     * work is bounded by `limit × fields.length`.
+     *
+     * Output shape only — no filtering, no ordering. Filter the projected
+     * records locally; for a recency subset use key design plus `slice`.
+     *
+     * On a venue that predates projection this falls back to `list()` plus a
+     * bounded `read()` per (key, field), returning the identical shape, and
+     * remembers not to ask that venue again.
+     *
+     * @param path Parent node. Must be a keyed node (map/Index) — a sequence or
+     *   scalar is a venue 400.
+     * @param fields Subpaths to project per key; may be nested (`meta/updated`).
+     *   At most 16, the venue's cap.
+     */
+    listFields(path: string, fields: string[], opts?: {
+        limit?: number;
+        offset?: number;
+        maxSize?: number;
+    }): Promise<WorkspaceProjectedList>;
+    /**
+     * The pre-covia#191 fallback: one `list`, then a `read` per (key, field).
+     * Fan-out is bounded by the page the list already returned, so this costs
+     * `keys.length × fields.length` reads for the page — exactly the N+1 the
+     * server-side projection exists to remove, which is why it is the fallback
+     * and not the default.
+     */
+    private projectClientSide;
     slice(path: string, offset?: number, limit?: number, ucans?: string[]): Promise<WorkspaceSliceResult>;
     inspect(paths: string | string[], budget?: number, compact?: boolean, ucans?: string[]): Promise<WorkspaceInspectResult>;
     /**
@@ -974,6 +1025,123 @@ declare class A2AManager {
     }): Promise<Job>;
 }
 
+interface MCPOps {
+    invoke(assetId: string, input?: unknown, options?: InvokeOptions): Promise<Job>;
+}
+interface MCPManagerVenue extends VenueRequestContext {
+    operations: MCPOps;
+    mcpDiscovery(): Promise<MCPDiscovery>;
+}
+/**
+ * MCP client for a venue's native `/mcp` endpoint.
+ *
+ * The venue speaks Streamable HTTP MCP: JSON-RPC over POST, answering either
+ * `application/json` or `text/event-stream` at its discretion. Everything that
+ * implies — request-id correlation, reading a response that may arrive as SSE
+ * frames, applying the venue's auth with the venue DID as audience, turning
+ * JSON-RPC error objects into typed errors — is protocol plumbing every
+ * TypeScript consumer would otherwise rebuild (covia-sdk#23).
+ *
+ * ```ts
+ * const page = await venue.mcp.listTools();
+ * const out  = await venue.mcp.callTool(page.tools[0].name, { text: 'hi' });
+ * ```
+ *
+ * **`listTools()` is job-free.** It reads the native endpoint, never the
+ * `v/ops/mcp/tools-list` operation — discovery and display must not persist a
+ * job per page (covia#177).
+ */
+declare class MCPManager {
+    private venue;
+    private nextId;
+    private sessionId?;
+    private endpointPromise?;
+    constructor(venue: MCPManagerVenue);
+    /** The venue's MCP discovery document (`GET /.well-known/mcp`). */
+    discovery(): Promise<MCPDiscovery>;
+    /**
+     * List the tools this venue bridges, job-free.
+     *
+     * @param options.cursor Continue a previous page. MCP pagination is opaque:
+     *   pass back the `nextCursor` a page returned, and stop when it is absent.
+     */
+    listTools(options?: {
+        cursor?: string;
+        signal?: AbortSignal;
+    }): Promise<MCPToolPage>;
+    /**
+     * Every tool the venue bridges, draining the cursor.
+     *
+     * A server that never stops handing back a cursor would loop forever, so a
+     * repeated cursor is treated as the end rather than trusted.
+     */
+    listAllTools(options?: {
+        signal?: AbortSignal;
+    }): Promise<MCPToolPage['tools']>;
+    /**
+     * Call a bridged tool natively and return its MCP result.
+     *
+     * This is the direct protocol call: the answer comes back in the response,
+     * and the caller never holds a Job. The venue still runs the tool through
+     * its job machinery and records it — "direct" describes what *this* call
+     * hands back, not whether the venue keeps a record.
+     *
+     * Use {@link callToolTracked} when you want the `Job` itself: to stream it,
+     * inspect its steps, link to its receipt, or continue it when it pauses.
+     *
+     * An MCP tool that fails *its own* execution answers with `isError: true`
+     * and the failure in `content` — a successful protocol call reporting a
+     * failed tool, which is not thrown. Only a protocol-level error throws.
+     */
+    callTool(name: string, args?: Record<string, unknown>, options?: {
+        signal?: AbortSignal;
+    }): Promise<MCPToolResult>;
+    /**
+     * Call a tool through the `v/ops/mcp/tools-call` operation, returning the
+     * `Job` so the run is an inspectable, linkable record.
+     *
+     * The operation is the venue's bridge to *any* MCP server, so `server`
+     * defaults to this venue's own base URL — pointing the bridge back at the
+     * venue, which is how a local tool gets called with a Job in hand. Name a
+     * different `server` (with a `token` if it needs one) to reach a third-party
+     * MCP server through the venue instead, which the native endpoint cannot do.
+     *
+     * Unlike {@link callTool} this always persists a job, so it belongs to a
+     * user-driven execution, never a page load.
+     */
+    callToolTracked(name: string, args?: Record<string, unknown>, options?: {
+        server?: string;
+        token?: string;
+    } & InvokeOptions): Promise<Job>;
+    /**
+     * Send an arbitrary JSON-RPC method to the venue's MCP endpoint — the escape
+     * hatch for methods this manager does not wrap (`resources/list`,
+     * `prompts/list`, …).
+     *
+     * Request ids are minted and correlated here, so callers never supply one.
+     */
+    request<T = unknown>(method: string, params?: Record<string, unknown>, options?: {
+        signal?: AbortSignal;
+    }): Promise<T>;
+    /** The resolved MCP endpoint path, from discovery, probed once. */
+    private endpoint;
+    /**
+     * Discovery names the endpoint; `${baseUrl}/mcp` is the compatibility
+     * default. Discovery failing is not fatal — a venue that serves `/mcp`
+     * without advertising it still works, so a failed probe falls through to the
+     * default rather than failing the call that triggered it.
+     */
+    private resolveEndpoint;
+    /**
+     * Read the response frame from an SSE-framed answer: the first event whose
+     * JSON-RPC id matches the request. Notifications and unrelated frames are
+     * skipped rather than mistaken for the answer.
+     */
+    private readSSEFrame;
+    /** JSON-RPC envelope → result, or a typed error. */
+    private unwrap;
+}
+
 /**
  * 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
@@ -1031,6 +1199,7 @@ declare class Venue implements VenueInterface {
     private _dlfs?;
     private _users?;
     private _a2a?;
+    private _mcp?;
     get adapters(): AdapterManager;
     get agents(): AgentManager;
     get jobs(): JobManager;
@@ -1043,6 +1212,7 @@ declare class Venue implements VenueInterface {
     get memory(): MemoryManager;
     get dlfs(): DLFSManager;
     get users(): UserManager;
+    get mcp(): MCPManager;
     get a2a(): A2AManager;
     constructor(options?: VenueOptions);
     /**
@@ -1383,6 +1553,36 @@ interface MCPDiscovery {
     endpoint?: Record<string, any> | string;
     [key: string]: any;
 }
+/** One tool as MCP describes it (`tools/list`). */
+interface MCPTool {
+    name: string;
+    description?: string;
+    inputSchema: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+    [key: string]: any;
+}
+/** One page of `tools/list`. `nextCursor` absent = the last page. */
+interface MCPToolPage {
+    tools: MCPTool[];
+    nextCursor?: string;
+}
+/** One content block of a tool result. */
+interface MCPContent {
+    type: string;
+    text?: string;
+    [key: string]: any;
+}
+/**
+ * The result of `tools/call`. `isError` marks a tool that ran and failed —
+ * a successful protocol call reporting a failed tool — as distinct from a
+ * protocol error, which throws `MCPError` instead.
+ */
+interface MCPToolResult {
+    content?: MCPContent[];
+    structuredContent?: Record<string, unknown>;
+    isError?: boolean;
+    [key: string]: any;
+}
 /**
  * A2A agent card from `GET /.well-known/agent-card.json`.
  * Field names mirror the A2A v1.0 wire format the venue serves (via the
@@ -1860,6 +2060,26 @@ interface WorkspaceListResult {
     keys?: string[];
     offset?: number;
 }
+/**
+ * One projected field of one listed record (covia#191).
+ *
+ * Exactly what a `values/read` of `<parent>/<key>/<field>` returns, down to
+ * `valueBytes` — projection is pure composition of reads, not new semantics.
+ * So: a stored null is present (`{exists: true, value: null}`), an absent
+ * field is `{exists: false}`, and a value past the per-field byte guard
+ * withholds `value` and sets `truncated` alongside its `type`.
+ */
+type WorkspaceFieldValue = WorkspaceReadResult;
+/**
+ * A `list` carrying a field projection: the ordinary list result plus, per
+ * listed key, the read result of each requested subpath of that key's child.
+ *
+ * `values` is keyed by the same keys `keys` reports, in the same page —
+ * projection applies after `limit`/`offset`.
+ */
+interface WorkspaceProjectedList extends WorkspaceListResult {
+    values: Record<string, Record<string, WorkspaceFieldValue>>;
+}
 interface WorkspaceSliceInput {
     path: string;
     offset?: number;
@@ -2037,6 +2257,15 @@ declare class CoviaError extends Error {
     code: number | null;
     constructor(message: string, code?: number | null);
 }
+/**
+ * A JSON-RPC error from an MCP endpoint. `code` is the JSON-RPC code (e.g.
+ * -32602 invalid params), not an HTTP status — a JSON-RPC error arrives in a
+ * 200 response, so it would otherwise read as success.
+ */
+declare class MCPError extends CoviaError {
+    data?: unknown;
+    constructor(message: string, code: number, data?: unknown);
+}
 /** Raised when the Covia API returns an error response (4xx/5xx). */
 declare class GridError extends CoviaError {
     statusCode: number;
@@ -2266,7 +2495,11 @@ declare function parseSSEStream(response: Response, options?: {
  * Which DID belongs in a lattice address:
  * - `w`/`o`/`g`/`j`/`s` are per-user: the `<DID>` is the resource *owner's* DID
  *   (yours is your auth DID, e.g. `Ed25519Auth.getDID()`) — NOT the venue's.
- * - `a` (assets) is venue-global and content-addressed.
+ * - `a` (assets) is content-addressed, and **caller-relative**: a bare hash or
+ *   `a/<hash>` names the asset in the requesting caller's own `a/` namespace,
+ *   not a global one (covia#502). Name another owner's copy explicitly as
+ *   `<ownerDID>/a/<hash>` — the only portable form — and the venue's own
+ *   catalog as `<venueDID>/a/<hash>`.
  * - A namespace-relative path (no `<DID>`) resolves to the authenticated caller.
  */
 /** Lattice namespace identifiers. */
@@ -2319,23 +2552,30 @@ declare function assetHash(ref: string): string | null;
 /**
  * Pluggable persistent store for content-addressed asset metadata.
  *
- * An asset id is the Convex value hash of its metadata (`AMap.getHash()`
- * venue-side), so hash → metadata is immutable: entries never go stale and are
- * safe to cache indefinitely, across sessions and across venues. Keys are the
- * normalised bare hash (lowercase, no `0x`), so `<hash>`, `0x<hash>` and
- * `<DID>/a/<hash>` refs all share one entry.
+ * Keys are the **fully qualified** `<ownerDID>/a/<hash>` form, and only that
+ * form is admitted. A bare hash or `a/<hash>` is *caller-relative*: it names
+ * the asset in the requesting caller's own `a/` namespace, so the same bytes
+ * registered by two principals are two records, each readable only under its
+ * owner's authority (covia#502, `venue/docs/OPERATIONS.md` §"Content-addressed
+ * forms are caller-relative, not global"). Covia has no global lookup by hash.
+ * Keying this store on a bare hash would therefore let an entry populated
+ * under one identity be served back to another that may have no right to read
+ * it — and this store is cross-session by design, outliving the auth that
+ * filled it. `persistentCacheKey` returns null for those refs, and
+ * `AssetManager` keeps them in its own venue-local memory cache instead.
  *
  * Trust model: entries are cached as returned by the venue that served them.
  * Provable verification — recomputing the Convex value hash of the metadata
  * and rejecting mismatches — requires a canonical CVM cell encoder in
- * TypeScript, which does not exist yet; when it lands, verification will gate
- * admission to this cache so entries are correct by construction rather than
- * by trust. Until then this is a availability/performance cache with the same
- * trust as an uncached fetch from the same venue.
+ * TypeScript, which does not exist yet (covia-sdk#18); when it lands,
+ * verification will gate admission to this cache so entries are correct by
+ * construction rather than by trust. Until then this is an
+ * availability/performance cache with the same trust as an uncached fetch
+ * from the same venue.
  */
 interface AssetMetadataStore {
-    get(hash: string): AssetMetadata | undefined;
-    put(hash: string, metadata: AssetMetadata): void;
+    get(key: string): AssetMetadata | undefined;
+    put(key: string, metadata: AssetMetadata): void;
     clear(): void;
 }
 /** Replace the persistent metadata store (e.g. a file-backed store in Node),
@@ -2485,4 +2725,4 @@ declare function grant(ownerPrivateKey: Uint8Array, audienceDID: string, withRes
  */
 declare function relayDelegation(privateKey: Uint8Array, venueDID: string, lifetimeSeconds: number, caps?: UCANCapability[]): string;
 
-export { type A2AAuthRef, type A2AImportAgentInput, type A2AImportAgentResult, A2AManager, type A2AMessage, type A2APart, type A2ATask, type AdapterInfo, AdapterManager, type AdaptersResult, Agent, type AgentCancelTaskInput, type AgentCard, type AgentChatInput, type AgentChatResult, type AgentCompactedSegment, type AgentCompleteTaskResult, type AgentContextInput, type AgentCreateInput, type AgentCreateResult, type AgentCycleEndEvent, type AgentCycleStartEvent, type AgentDeleteInput, type AgentDeleteResult, type AgentEvent, type AgentEventEnvelope, type AgentFailTaskResult, type AgentForkInput, type AgentForkResult, type AgentInferenceEndEvent, type AgentInferenceStartEvent, type AgentInfoResult, type AgentListInput, type AgentListResult, AgentManager, type AgentMessageInput, type AgentMessageResult, type AgentRenameSessionResult, type AgentRequestInput, type AgentRequestResult, type AgentResumeInput, type AgentRunEndEvent, type AgentRunStartEvent, type AgentSession, type AgentSessionListOptions, type AgentSessionMessage, type AgentSessionMetadata, AgentSessionNotFoundError, type AgentSessionPage, type AgentSessionRole, AgentStatus, type AgentStatusEvent, type AgentSuspendResult, type AgentToolResultEvent, type AgentToolStartEvent, type AgentTriggerInput, type AgentTriggerResult, type AgentUpdateInput, Asset, type AssetID, type AssetList, type AssetListItem, type AssetListOptions, AssetManager, type AssetMetadata, type AssetMetadataStore, AssetNotFoundError, type AssetPinResult, type AssetSummary, Auth, type AuthenticationKeyEntry, type AuthenticationKeysMap, type AuthenticationKeysResult, type AuthenticatorRevokeResult, BasicAuth, BearerAuth, ChatSession, type ConnectionAttempt, type ContentDetails, type ContentHashResult, CoviaConnectionError, type CoviaConnectionErrorOptions, CoviaError, CoviaTimeoutError, type Credentials, CredentialsHTTP, type DIDDocument, type DIDURL, type DLFSDrivesResult, type DLFSEntry, type DLFSListResult, DLFSManager, DataAsset, Ed25519Auth, type ExecutionScope, type ExpandedAssetList, type FunctionInfo, type FunctionsResult, Grid, GridError, type GroupCount, type InvokeOptions, type InvokePayload, Job, JobFailedError, type JobHistoryOptions, type JobHistoryPage, JobManager, type JobMetadata, JobNotFoundError, JobStatus, KeyPairAuth, type MCPDiscovery, type MemoryChange, type MemoryEntry, MemoryManager, type MyAssetList, Namespace, NoAuth, NotFoundError, Operation, type OperationDetails, type OperationInfo, OperationManager, type OperationPayload, type OperationRunner, RateLimitError, RunStatus, type SSEEvent, ScopedWorkspace, 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, type UserInfo, type UserListResult, UserManager, type UserSummary, 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 A2AAuthRef, type A2AImportAgentInput, type A2AImportAgentResult, A2AManager, type A2AMessage, type A2APart, type A2ATask, type AdapterInfo, AdapterManager, type AdaptersResult, Agent, type AgentCancelTaskInput, type AgentCard, type AgentChatInput, type AgentChatResult, type AgentCompactedSegment, type AgentCompleteTaskResult, type AgentContextInput, type AgentCreateInput, type AgentCreateResult, type AgentCycleEndEvent, type AgentCycleStartEvent, type AgentDeleteInput, type AgentDeleteResult, type AgentEvent, type AgentEventEnvelope, type AgentFailTaskResult, type AgentForkInput, type AgentForkResult, type AgentInferenceEndEvent, type AgentInferenceStartEvent, type AgentInfoResult, type AgentListInput, type AgentListResult, AgentManager, type AgentMessageInput, type AgentMessageResult, type AgentRenameSessionResult, type AgentRequestInput, type AgentRequestResult, type AgentResumeInput, type AgentRunEndEvent, type AgentRunStartEvent, type AgentSession, type AgentSessionListOptions, type AgentSessionMessage, type AgentSessionMetadata, AgentSessionNotFoundError, type AgentSessionPage, type AgentSessionRole, AgentStatus, type AgentStatusEvent, type AgentSuspendResult, type AgentToolResultEvent, type AgentToolStartEvent, type AgentTriggerInput, type AgentTriggerResult, type AgentUpdateInput, Asset, type AssetID, type AssetList, type AssetListItem, type AssetListOptions, AssetManager, type AssetMetadata, type AssetMetadataStore, AssetNotFoundError, type AssetPinResult, type AssetSummary, Auth, type AuthenticationKeyEntry, type AuthenticationKeysMap, type AuthenticationKeysResult, type AuthenticatorRevokeResult, BasicAuth, BearerAuth, ChatSession, type ConnectionAttempt, type ContentDetails, type ContentHashResult, CoviaConnectionError, type CoviaConnectionErrorOptions, CoviaError, CoviaTimeoutError, type Credentials, CredentialsHTTP, type DIDDocument, type DIDURL, type DLFSDrivesResult, type DLFSEntry, type DLFSListResult, DLFSManager, DataAsset, Ed25519Auth, type ExecutionScope, type ExpandedAssetList, type FunctionInfo, type FunctionsResult, Grid, GridError, type GroupCount, type InvokeOptions, type InvokePayload, Job, JobFailedError, type JobHistoryOptions, type JobHistoryPage, JobManager, type JobMetadata, JobNotFoundError, JobStatus, KeyPairAuth, type MCPContent, type MCPDiscovery, MCPError, MCPManager, type MCPTool, type MCPToolPage, type MCPToolResult, type MemoryChange, type MemoryEntry, MemoryManager, type MyAssetList, Namespace, NoAuth, NotFoundError, Operation, type OperationDetails, type OperationInfo, OperationManager, type OperationPayload, type OperationRunner, RateLimitError, RunStatus, type SSEEvent, ScopedWorkspace, 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, type UserInfo, type UserListResult, UserManager, type UserSummary, 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 WorkspaceFieldValue, type WorkspaceInspectInput, type WorkspaceInspectResult, type WorkspaceListInput, type WorkspaceListResult, WorkspaceManager, type WorkspaceProjectedList, 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 };