@covia/covia-sdk 1.1.0 → 1.2.0

package/dist/index.d.ts

@@ -2,6 +2,7 @@ declare class Job {
     id: string;
     venue: VenueInterface;
     metadata: JobMetadata;
+    private _jobs;
     constructor(id: string, venue: VenueInterface, metadata: JobMetadata);
     /**
      * Whether the job has reached a terminal state
@@ -47,15 +48,42 @@ declare class Job {
      */
     stream(): AsyncGenerator<SSEEvent>;
     /**
-     * Cancels the execution of the job
-     * @returns {Promise<number>}
+     * Whether the job is paused (PAUSED, INPUT_REQUIRED, or AUTH_REQUIRED)
      */
-    cancelJob(): Promise<number>;
+    get isPaused(): boolean;
+    /**
+     * Whether the job requires user input
+     */
+    get needsInput(): boolean;
+    /**
+     * Whether the job requires authentication
+     */
+    get needsAuth(): boolean;
+    /**
+     * Send a message to the running job
+     * @param message - Message payload
+     * @returns {Promise<any>}
+     */
+    sendMessage(message: any): Promise<any>;
+    /**
+     * Pause the job
+     * @returns {Promise<JobMetadata>} Updated job metadata
+     */
+    pause(): Promise<JobMetadata>;
+    /**
+     * Resume the job
+     * @returns {Promise<JobMetadata>} Updated job metadata
+     */
+    resume(): Promise<JobMetadata>;
+    /**
+     * Cancel the job
+     * @returns {Promise<JobMetadata>} Updated job metadata
+     */
+    cancel(): Promise<JobMetadata>;
     /**
      * Delete the job
-     * @returns {Promise<number>}
      */
-    deleteJob(): Promise<number>;
+    delete(): Promise<void>;
 }
 
 declare abstract class Asset {
@@ -64,23 +92,20 @@ declare abstract class Asset {
     metadata: AssetMetadata;
     status?: RunStatus;
     error?: string;
+    private _assets;
+    private _operations;
     constructor(id: AssetID, venue: VenueInterface, metadata?: AssetMetadata);
     /**
      * Get asset metadata
      * @returns {Promise<AssetMetadata>}
      */
     getMetadata(): Promise<AssetMetadata>;
-    /**
-     * Read stream from asset
-     * @param reader - ReadableStreamDefaultReader
-     */
-    readStream(reader: ReadableStreamDefaultReader<Uint8Array>): Promise<void>;
     /**
      * Put content to asset
      * @param content - Content to upload
-     * @returns {Promise<ReadableStream<Uint8Array> | null>}
+     * @returns {Promise<ContentHashResult>} The content hash returned by the server
      */
-    putContent(content: BodyInit): Promise<ReadableStream<Uint8Array> | null>;
+    putContent(content: BodyInit): Promise<ContentHashResult>;
     /**
      * Get asset content
      * @returns {Promise<ReadableStream<Uint8Array> | null>}
@@ -100,7 +125,7 @@ declare abstract class Asset {
     /**
     * Execute the operation
     * @param input - Operation input parameters
-    * @returns {Promise<any>}
+    * @returns {Promise<Job>}
     */
     invoke(input: any): Promise<Job>;
 }
@@ -139,29 +164,43 @@ declare class BearerAuth extends Auth {
     apply(headers: Record<string, string>): void;
 }
 /**
- * HTTP Basic authentication.
- * Adds `Authorization: Basic <base64(username:password)>` to every request.
- */
-declare class BasicAuth extends Auth {
-    private _encoded;
-    constructor(username: string, password: string);
-    apply(headers: Record<string, string>): void;
-}
-/**
- * Custom auth that sets the X-Covia-User header for user identity tracking.
+ * Ed25519 keypair authentication (self-issued EdDSA JWT).
+ * Generates a fresh short-lived JWT for every request, signed with the
+ * client's Ed25519 private key.  The server verifies the signature and
+ * extracts the caller's DID from the `sub` claim.
+ *
+ * Example:
+ *   const auth = KeyPairAuth.generate();
+ *   console.log(auth.getDID()); // did:key:z6Mk...
+ *   const venue = await Grid.connect("https://venue.covia.ai", auth);
  */
-declare class CoviaUserAuth extends Auth {
-    private _userId;
-    constructor(userId: string);
+declare class KeyPairAuth extends Auth {
+    private _privateKey;
+    private _publicKey;
+    private _did;
+    private _lifetime;
+    /**
+     * @param privateKey - 32-byte Ed25519 private key
+     * @param tokenLifetimeSeconds - JWT lifetime in seconds (default 300 = 5 min)
+     */
+    constructor(privateKey: Uint8Array, tokenLifetimeSeconds?: number);
     apply(headers: Record<string, string>): void;
-}
-/** @deprecated Use Auth subclasses instead (NoAuth, BearerAuth, BasicAuth, CoviaUserAuth). */
+    /** The caller's DID derived from the public key. */
+    getDID(): string;
+    /** The 32-byte Ed25519 public key. */
+    getPublicKey(): Uint8Array;
+    /** Generate a new random keypair and return a KeyPairAuth instance. */
+    static generate(tokenLifetimeSeconds?: number): KeyPairAuth;
+    /** Create from a hex-encoded private key string. */
+    static fromHex(privateKeyHex: string, tokenLifetimeSeconds?: number): KeyPairAuth;
+}
+/** @deprecated Use Auth subclasses instead (NoAuth, BearerAuth, KeyPairAuth). */
 interface Credentials {
     venueId: string;
     apiKey: string;
     userId: string;
 }
-/** @deprecated Use Auth subclasses instead (NoAuth, BearerAuth, BasicAuth, CoviaUserAuth). */
+/** @deprecated Use Auth subclasses instead (NoAuth, BearerAuth, KeyPairAuth). */
 declare class CredentialsHTTP implements Credentials {
     venueId: string;
     apiKey: string;
@@ -169,11 +208,203 @@ declare class CredentialsHTTP implements Credentials {
     constructor(venueId: string, apiKey: string, userId: string);
 }
 
+interface AgentManagerVenue {
+    operations: {
+        run(assetId: string, input: any): Promise<any>;
+    };
+}
+declare class AgentManager {
+    private venue;
+    constructor(venue: AgentManagerVenue);
+    create(input: AgentCreateInput): Promise<AgentCreateResult>;
+    request(agentId: string, input?: any, wait?: boolean | number): Promise<AgentRequestResult>;
+    message(agentId: string, message: any): Promise<AgentMessageResult>;
+    trigger(agentId: string): Promise<AgentTriggerResult>;
+    query(agentId: string): Promise<AgentQueryResult>;
+    list(includeTerminated?: boolean): Promise<AgentListResult>;
+    delete(agentId: string, remove?: boolean): Promise<AgentDeleteResult>;
+    suspend(agentId: string): Promise<AgentSuspendResult>;
+    resume(agentId: string, autoWake?: boolean): Promise<AgentSuspendResult>;
+    update(input: AgentUpdateInput): Promise<any>;
+    cancelTask(agentId: string, taskId: string): Promise<any>;
+}
+
+interface JobManagerVenue {
+    baseUrl: string;
+    auth: {
+        apply(headers: Record<string, string>): void;
+    };
+}
+declare class JobManager {
+    private venue;
+    constructor(venue: JobManagerVenue);
+    list(): Promise<string[]>;
+    get(jobId: string): Promise<Job>;
+    cancel(jobId: string): Promise<JobMetadata>;
+    delete(jobId: string): Promise<void>;
+    pause(jobId: string): Promise<JobMetadata>;
+    resume(jobId: string): Promise<JobMetadata>;
+    sendMessage(jobId: string, message: any): Promise<any>;
+    stream(jobId: string): AsyncGenerator<SSEEvent>;
+    private _buildHeaders;
+}
+
+interface AssetManagerVenue {
+    baseUrl: string;
+    auth: {
+        apply(headers: Record<string, string>): void;
+    };
+}
+declare class AssetManager {
+    private venue;
+    constructor(venue: AssetManagerVenue);
+    /**
+     * Get asset by ID
+     * @param assetId - Asset identifier
+     * @returns Returns either an Operation or DataAsset based on the asset's metadata
+     */
+    get(assetId: AssetID): Promise<Asset>;
+    /**
+     * List assets with pagination support
+     * @param options - Pagination options (offset, limit)
+     */
+    list(options?: AssetListOptions): Promise<AssetList>;
+    /**
+     * Register a new asset
+     * @param assetData - Asset configuration
+     */
+    register(assetData: any): Promise<Asset>;
+    /**
+     * Get asset metadata
+     * @param assetId - Asset identifier
+     */
+    getMetadata(assetId: string): Promise<AssetMetadata>;
+    /**
+     * Put content to asset
+     * @param assetId - Asset identifier
+     * @param content - Content to upload
+     * @returns The content hash returned by the server
+     */
+    putContent(assetId: string, content: BodyInit): Promise<ContentHashResult>;
+    /**
+     * Get asset content
+     * @param assetId - Asset identifier
+     */
+    getContent(assetId: string): Promise<ReadableStream<Uint8Array> | null>;
+    /**
+     * Clear the asset cache.
+     */
+    clearCache(): void;
+    private _buildHeaders;
+}
+
+interface OperationManagerVenue {
+    baseUrl: string;
+    auth: {
+        apply(headers: Record<string, string>): void;
+    };
+}
+declare class OperationManager {
+    private venue;
+    constructor(venue: OperationManagerVenue);
+    /**
+     * List all named operations available on this venue
+     */
+    list(): Promise<OperationInfo[]>;
+    /**
+     * Get details of a named operation
+     * @param name - Operation name (e.g., "test:echo")
+     */
+    get(name: string): Promise<OperationInfo>;
+    /**
+     * 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)
+     */
+    run(assetId: string, input: any, options?: InvokeOptions): Promise<any>;
+    /**
+     * Execute an operation and return a Job for tracking
+     * @param assetId - Operation asset ID or named operation
+     * @param input - Operation input parameters
+     * @param options - Invoke options (e.g., ucans)
+     */
+    invoke(assetId: string, input: any, options?: InvokeOptions): Promise<Job>;
+    private _buildHeaders;
+}
+
+interface WorkspaceManagerVenue {
+    operations: {
+        run(assetId: string, input: any): Promise<any>;
+    };
+}
+declare class WorkspaceManager {
+    private venue;
+    constructor(venue: WorkspaceManagerVenue);
+    read(path: string, maxSize?: number): Promise<WorkspaceReadResult>;
+    write(path: string, value: any): Promise<WorkspaceWriteResult>;
+    delete(path: string): Promise<WorkspaceDeleteResult>;
+    append(path: string, value: any): Promise<WorkspaceAppendResult>;
+    list(path?: string, limit?: number, offset?: number): Promise<WorkspaceListResult>;
+    slice(path: string, offset?: number, limit?: number): Promise<WorkspaceSliceResult>;
+    functions(): Promise<FunctionsResult>;
+    describe(name: string): Promise<any>;
+    adapters(): Promise<AdaptersResult>;
+}
+
+interface UCANManagerVenue {
+    operations: {
+        run(assetId: string, input: any): Promise<any>;
+    };
+}
+declare class UCANManager {
+    private venue;
+    constructor(venue: UCANManagerVenue);
+    issue(aud: string, att: UCANAttenuation[], exp: number): Promise<UCANIssueResult>;
+}
+
+interface SecretManagerVenue {
+    operations: {
+        run(assetId: string, input: any): Promise<any>;
+    };
+    listSecrets(): Promise<string[]>;
+    putSecret(name: string, value: string): Promise<void>;
+    deleteSecret(name: string): Promise<void>;
+}
+declare class SecretManager {
+    private venue;
+    constructor(venue: SecretManagerVenue);
+    set(name: string, value: string): Promise<SecretSetResult>;
+    /**
+     * Extract a secret value by name.
+     * NOTE: This operation requires a UCAN capability grant. The backend
+     * may reject requests that lack the appropriate capability proof.
+     */
+    extract(name: string): Promise<SecretExtractResult>;
+    list(): Promise<string[]>;
+    put(name: string, value: string): Promise<void>;
+    delete(name: string): Promise<void>;
+}
+
 declare class Venue implements VenueInterface {
     baseUrl: string;
     venueId: string;
     auth: Auth;
     metadata: VenueData;
+    private _agents?;
+    private _jobs?;
+    private _assets?;
+    private _operations?;
+    private _workspace?;
+    private _ucan?;
+    private _secrets?;
+    get agents(): AgentManager;
+    get jobs(): JobManager;
+    get assets(): AssetManager;
+    get operations(): OperationManager;
+    get workspace(): WorkspaceManager;
+    get ucan(): UCANManager;
+    get secrets(): SecretManager;
     constructor(options?: VenueOptions);
     /**
      * Static method to connect to a venue
@@ -183,24 +414,13 @@ declare class Venue implements VenueInterface {
      */
     static connect(venueId: string | Venue, auth?: Auth): Promise<Venue>;
     /**
-     * Register a new asset
-     * @param assetData - Asset configuration
-     * @returns {Promise<Asset>}
-     */
-    register(assetData: any): Promise<Asset>;
-    /**
-     * Read stream from asset
-     * @param reader - ReadableStreamDefaultReader
-     */
-    readStream(reader: ReadableStreamDefaultReader<Uint8Array>): Promise<void>;
-    /**
-     * Get asset by ID
+     * Get asset by ID (convenience delegate to venue.assets.get)
      * @param assetId - Asset identifier
      * @returns {Promise<Asset>} Returns either an Operation or DataAsset based on the asset's metadata
      */
     getAsset(assetId: AssetID): Promise<Asset>;
     /**
-     * List assets with pagination support
+     * List assets with pagination support (convenience delegate to venue.assets.list)
      * @param options - Pagination options (offset, limit)
      * @returns {Promise<AssetList>} Paginated list of asset IDs with metadata
      */
@@ -217,33 +437,26 @@ declare class Venue implements VenueInterface {
      */
     getJob(jobId: string): Promise<Job>;
     /**
-    * Cancel job by ID
-    * @param jobId - Job identifier
-    * @returns {Promise<number>}
-    */
-    cancelJob(jobId: string): Promise<number>;
-    /**
-    * Delete job by ID
-    * @param jobId - Job identifier
-    * @returns {Promise<number>}
-    */
-    deleteJob(jobId: string): Promise<number>;
+     * List secret names
+     * @returns {Promise<string[]>}
+     */
+    listSecrets(): Promise<string[]>;
     /**
-     * Get venue status
-     * @returns {Promise<StatusData>}
+     * Store a secret value
+     * @param name - Secret name
+     * @param value - Secret value
      */
-    status(): Promise<StatusData>;
+    putSecret(name: string, value: string): Promise<void>;
     /**
-     * List all named operations available on this venue
-     * @returns {Promise<OperationInfo[]>}
+     * Delete a secret
+     * @param name - Secret name
      */
-    listOperations(): Promise<OperationInfo[]>;
+    deleteSecret(name: string): Promise<void>;
     /**
-     * Get details of a named operation
-     * @param name - Operation name (e.g., "test:echo")
-     * @returns {Promise<OperationInfo>}
+     * Get venue status
+     * @returns {Promise<StatusData>}
      */
-    getOperation(name: string): Promise<OperationInfo>;
+    status(): Promise<StatusData>;
     /**
      * Get the full DID document for this venue
      * @returns {Promise<DIDDocument>}
@@ -259,40 +472,6 @@ declare class Venue implements VenueInterface {
      * @returns {Promise<AgentCard>}
      */
     agentCard(): Promise<AgentCard>;
-    /**
-     * Get asset metadata
-     * @returns {Promise<AssetMetadata>}
-     */
-    getMetadata(assetId: string): Promise<AssetMetadata>;
-    /**
-     * Put content to asset
-     * @param content - Content to upload
-     * @returns {Promise<ReadableStream<Uint8Array> | null>}
-     */
-    putContent(assetId: string, content: BodyInit): Promise<ReadableStream<Uint8Array> | null>;
-    /**
-     * Get asset content
-     * @returns {Promise<ReadableStream<Uint8Array> | null>}
-     */
-    getContent(assetId: string): Promise<ReadableStream<Uint8Array> | null>;
-    /**
-       * Execute the operation
-       * @param input - Operation input parameters
-       * @returns {Promise<any>}
-       */
-    run(assetId: string, input: any): Promise<any>;
-    /**
-    * Execute the operation
-    * @param input - Operation input parameters
-    * @returns {Promise<Job>}
-    */
-    invoke(assetId: string, input: any): Promise<Job>;
-    /**
-     * Stream server-sent events for a job.
-     * @param jobId - Job identifier
-     * @returns AsyncGenerator yielding SSEEvent objects
-     */
-    streamJobEvents(jobId: string): AsyncGenerator<SSEEvent>;
     /**
      * Close the venue and release resources.
      * Clears cached asset data for this venue.
@@ -316,30 +495,25 @@ interface VenueConstructor {
     new (): VenueInterface;
     connect(venueId: string | Venue, auth?: Auth): Promise<Venue>;
 }
+interface InvokeOptions {
+    ucans?: string[];
+}
 interface VenueInterface {
     baseUrl: string;
     venueId: string;
     metadata: VenueData;
-    cancelJob(jobId: string): Promise<number>;
-    deleteJob(jobId: string): Promise<number>;
+    auth: Auth;
     status(): Promise<StatusData>;
     getJob(jobId: string): Promise<Job>;
     listJobs(): Promise<string[]>;
     getAsset(assetId: AssetID): Promise<Asset>;
-    register(assetData: any): Promise<Asset>;
-    getMetadata(assetId: string): Promise<AssetMetadata>;
-    readStream(reader: ReadableStreamDefaultReader<Uint8Array>): Promise<void>;
-    putContent(assetId: string, content: BodyInit): Promise<ReadableStream<Uint8Array> | null>;
-    getContent(assetId: string): Promise<ReadableStream<Uint8Array> | null>;
-    run(assetId: string, input: any): Promise<any>;
-    invoke(assetId: string, input: any): Promise<Job>;
     listAssets(options?: AssetListOptions): Promise<AssetList>;
-    listOperations(): Promise<OperationInfo[]>;
-    getOperation(name: string): Promise<OperationInfo>;
     didDocument(): Promise<DIDDocument>;
     mcpDiscovery(): Promise<MCPDiscovery>;
     agentCard(): Promise<AgentCard>;
-    streamJobEvents(jobId: string): AsyncGenerator<SSEEvent>;
+    listSecrets(): Promise<string[]>;
+    putSecret(name: string, value: string): Promise<void>;
+    deleteSecret(name: string): Promise<void>;
     close(): void;
 }
 type AssetID = string;
@@ -375,6 +549,9 @@ interface ContentDetails {
 interface OperationPayload {
     [key: string]: any;
 }
+interface ContentHashResult {
+    hash: string;
+}
 interface JobMetadata {
     name?: string;
     status?: RunStatus;
@@ -382,7 +559,9 @@ interface JobMetadata {
     updated?: string;
     input?: any;
     output?: any;
-    op?: string;
+    operation?: string;
+    caller?: string;
+    error?: string;
     [key: string]: any;
 }
 interface InvokePayload {
@@ -467,6 +646,195 @@ interface SSEEvent {
     /** Parse the event data as JSON. */
     json: () => any;
 }
+declare enum AgentStatus {
+    SLEEPING = "SLEEPING",
+    RUNNING = "RUNNING",
+    SUSPENDED = "SUSPENDED",
+    TERMINATED = "TERMINATED"
+}
+interface AgentCreateInput {
+    agentId: string;
+    config?: Record<string, any>;
+    state?: Record<string, any>;
+    overwrite?: boolean;
+}
+interface AgentCreateResult {
+    agentId: string;
+    status: string;
+    created: boolean;
+}
+interface AgentRequestInput {
+    agentId: string;
+    input?: any;
+    wait?: boolean | number;
+}
+interface AgentRequestResult {
+    id: string;
+    status: string;
+    output?: any;
+}
+interface AgentMessageInput {
+    agentId: string;
+    message: any;
+}
+interface AgentMessageResult {
+    agentId: string;
+    delivered: boolean;
+}
+interface AgentTriggerInput {
+    agentId: string;
+}
+interface AgentTriggerResult {
+    agentId: string;
+    status: string;
+    result?: any;
+    taskResults?: any[];
+}
+interface AgentQueryInput {
+    agentId: string;
+}
+interface AgentQueryResult {
+    agentId: string;
+    status: string;
+    state?: Record<string, any>;
+    config?: Record<string, any>;
+    tasks?: any[];
+    [key: string]: any;
+}
+interface AgentListInput {
+    includeTerminated?: boolean;
+}
+interface AgentListResult {
+    agents: Array<{
+        agentId: string;
+        status: string;
+        tasks: number;
+    }>;
+}
+interface AgentDeleteInput {
+    agentId: string;
+    remove?: boolean;
+}
+interface AgentDeleteResult {
+    agentId: string;
+    status: string;
+    removed?: boolean;
+}
+interface AgentSuspendResult {
+    agentId: string;
+    status: string;
+}
+interface AgentResumeInput {
+    agentId: string;
+    autoWake?: boolean;
+}
+interface AgentUpdateInput {
+    agentId: string;
+    config?: Record<string, any>;
+    state?: Record<string, any>;
+}
+interface AgentCancelTaskInput {
+    agentId: string;
+    taskId: string;
+}
+interface WorkspaceReadInput {
+    path: string;
+    maxSize?: number;
+}
+interface WorkspaceReadResult {
+    exists: boolean;
+    value?: any;
+    truncated?: boolean;
+    size?: number;
+}
+interface WorkspaceWriteInput {
+    path: string;
+    value: any;
+}
+interface WorkspaceWriteResult {
+    written: boolean;
+}
+interface WorkspaceDeleteInput {
+    path: string;
+}
+interface WorkspaceDeleteResult {
+    deleted: boolean;
+}
+interface WorkspaceAppendInput {
+    path: string;
+    value: any;
+}
+interface WorkspaceAppendResult {
+    appended: boolean;
+}
+interface WorkspaceListInput {
+    path?: string;
+    limit?: number;
+    offset?: number;
+}
+interface WorkspaceListResult {
+    exists: boolean;
+    type: string;
+    count?: number;
+    keys?: string[];
+    values?: any[];
+    offset?: number;
+}
+interface WorkspaceSliceInput {
+    path: string;
+    offset?: number;
+    limit?: number;
+}
+interface WorkspaceSliceResult {
+    exists: boolean;
+    type: string;
+    values: any[];
+    count: number;
+    offset: number;
+}
+interface UCANAttenuation {
+    with: string;
+    can: string;
+}
+interface UCANIssueInput {
+    aud: string;
+    att: UCANAttenuation[];
+    exp: number;
+}
+interface UCANIssueResult {
+    [key: string]: any;
+}
+interface SecretSetInput {
+    name: string;
+    value: string;
+}
+interface SecretSetResult {
+    name: string;
+    stored: boolean;
+}
+interface SecretExtractInput {
+    name: string;
+}
+interface SecretExtractResult {
+    name: string;
+    value: string;
+}
+interface FunctionInfo {
+    name: string;
+    id: string;
+    description?: string;
+}
+interface FunctionsResult {
+    functions: FunctionInfo[];
+}
+interface AdapterInfo {
+    name: string;
+    description?: string;
+    operations: string[];
+}
+interface AdaptersResult {
+    adapters: AdapterInfo[];
+}
 declare class CoviaError extends Error {
     code: number | null;
     constructor(message: string, code?: number | null);
@@ -588,7 +956,7 @@ declare class Grid {
     /**
     * Static method to connect to a venue
     * @param venueId - Can be a HTTP base URL, DNS name, or existing Venue instance
-    * @param auth - Optional authentication provider (BearerAuth, BasicAuth, etc.)
+    * @param auth - Optional authentication provider (BearerAuth, KeyPairAuth, etc.)
     * @returns {Promise<Venue>} A new Venue instance configured appropriately
     */
     static connect(venueId: string, auth?: Auth): Promise<Venue>;
@@ -602,4 +970,47 @@ declare class DataAsset extends Asset {
     constructor(id: AssetID, venue: VenueInterface, metadata?: AssetMetadata);
 }
 
-export { type AgentCard, Asset, type AssetID, type AssetList, type AssetListOptions, type AssetMetadata, AssetNotFoundError, Auth, BasicAuth, BearerAuth, type ContentDetails, CoviaConnectionError, CoviaError, CoviaTimeoutError, CoviaUserAuth, type Credentials, CredentialsHTTP, type DIDDocument, DataAsset, Grid, GridError, type InvokePayload, Job, JobFailedError, type JobMetadata, JobNotFoundError, JobStatus, type MCPDiscovery, NoAuth, NotFoundError, Operation, type OperationDetails, type OperationInfo, type OperationPayload, RunStatus, type SSEEvent, type StatsData, type StatusData, Venue, type VenueConstructor, type VenueData, type VenueInterface, type VenueOptions, createSSEEvent, fetchStreamWithError, fetchWithError, getAssetIdFromPath, getAssetIdFromVenueId, getParsedAssetId, isJobComplete, isJobFinished, isJobPaused, logger, parseSSEStream };
+/**
+ * Ed25519 keypair generation and utility functions.
+ */
+/**
+ * Generate a random Ed25519 keypair.
+ * @returns Object with privateKey (32 bytes) and publicKey (32 bytes)
+ */
+declare function generateKeyPair(): {
+    privateKey: Uint8Array;
+    publicKey: Uint8Array;
+};
+/**
+ * Convert a private key to hex string for storage.
+ */
+declare function privateKeyToHex(key: Uint8Array): string;
+/**
+ * Convert a hex string back to a private key Uint8Array.
+ */
+declare function hexToPrivateKey(hex: string): Uint8Array;
+
+/**
+ * Multikey encoding for Ed25519 public keys.
+ * Follows the did:key spec with multicodec prefix 0xed01 for Ed25519.
+ */
+/**
+ * Encode an Ed25519 public key as a multikey string (z-prefixed base58-btc).
+ * @param publicKey - 32-byte Ed25519 public key
+ * @returns Multikey string like "z6MkhaXgBZD..."
+ */
+declare function encodePublicKey(publicKey: Uint8Array): string;
+/**
+ * Decode a multikey string back to a 32-byte Ed25519 public key.
+ * @param multikey - Multikey string starting with "z"
+ * @returns 32-byte Ed25519 public key
+ */
+declare function decodePublicKey(multikey: string): Uint8Array;
+/**
+ * Create a did:key DID from an Ed25519 public key.
+ * @param publicKey - 32-byte Ed25519 public key
+ * @returns DID string like "did:key:z6MkhaXgBZD..."
+ */
+declare function didFromPublicKey(publicKey: Uint8Array): string;
+
+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 };