@opendatalabs/vana-sdk 0.1.0-alpha.5983460 → 0.1.0-alpha.5a59295

package/dist/controllers/server.cjs

@@ -285,6 +285,12 @@ class ServerController extends import_base.BaseController {
    * The download requires authentication using the application's signature.
    * This method returns the artifact as a Blob that can be saved or processed.
    *
+   * **Simplified Signature Scheme:**
+   * The signature is generated over the operation ID only, allowing a single signature
+   * to be reused for listing and downloading multiple artifacts from the same operation.
+   * This simplifies client implementation while maintaining security - access to the
+   * operation ID grants access to all artifacts.
+   *
    * @param params - The download parameters
    * @param params.operationId - The operation ID that generated the artifact
    * @param params.artifactPath - The path to the artifact file to download
@@ -315,14 +321,14 @@ class ServerController extends import_base.BaseController {
   async downloadArtifact(params) {
     this.assertWallet();
     try {
-      const requestData = {
-        operation_id: params.operationId,
-        artifact_path: params.artifactPath
+      const signatureData = {
+        operation_id: params.operationId
       };
-      const requestJson = JSON.stringify(requestData);
+      const requestJson = JSON.stringify(signatureData);
       const signature = await this.createSignature(requestJson);
       const requestBody = {
-        ...requestData,
+        operation_id: params.operationId,
+        artifact_path: params.artifactPath,
         signature
       };
       const response = await fetch(
@@ -351,6 +357,79 @@ class ServerController extends import_base.BaseController {
       );
     }
   }
+  /**
+   * Lists all artifacts generated by a server operation.
+   *
+   * @remarks
+   * Retrieves metadata for all artifact files produced by an operation,
+   * including file paths, sizes, and content types. This provides visibility
+   * into available outputs without downloading them.
+   *
+   * **Simplified Signature Scheme:**
+   * Uses the same signature as downloadArtifact - signs only operation_id.
+   * This allows reusing the same signature for listing and downloading.
+   *
+   * @param operationId - The operation ID that generated the artifacts
+   * @returns Promise resolving to array of artifact metadata objects
+   * @throws {PersonalServerError} When artifacts cannot be listed
+   * @throws {NetworkError} When unable to reach the personal server API
+   * @throws {SignatureError} When unable to create the required signature
+   * @example
+   * ```typescript
+   * // List artifacts from a Gemini operation
+   * const artifacts = await vana.server.listArtifacts('op_123');
+   *
+   * console.log(`Found ${artifacts.length} artifacts:`);
+   * artifacts.forEach(artifact => {
+   *   console.log(`- ${artifact.path} (${artifact.size} bytes)`);
+   * });
+   *
+   * // Download a specific artifact
+   * const blob = await vana.server.downloadArtifact({
+   *   operationId: 'op_123',
+   *   artifactPath: artifacts[0].path
+   * });
+   * ```
+   */
+  async listArtifacts(operationId) {
+    this.assertWallet();
+    try {
+      const signatureData = {
+        operation_id: operationId
+      };
+      const requestJson = JSON.stringify(signatureData);
+      const signature = await this.createSignature(requestJson);
+      const requestBody = {
+        operation_id: operationId,
+        signature
+      };
+      const response = await fetch(
+        `${this.personalServerBaseUrl}/artifacts/${operationId}/list`,
+        {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify(requestBody)
+        }
+      );
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new import_errors.PersonalServerError(
+          `Failed to list artifacts: ${response.status} ${response.statusText} - ${errorText}`
+        );
+      }
+      const data = await response.json();
+      return data.artifacts ?? [];
+    } catch (error) {
+      if (error instanceof import_errors.NetworkError || error instanceof import_errors.PersonalServerError || error instanceof import_errors.SignatureError) {
+        throw error;
+      }
+      throw new import_errors.PersonalServerError(
+        `Failed to list artifacts: ${error instanceof Error ? error.message : "Unknown error"}`
+      );
+    }
+  }
   /**
    * Cancels a running operation on the personal server.
    *

package/dist/controllers/server.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controllers/server.ts"],"sourcesContent":["import type {\n  CreateOperationParams,\n  InitPersonalServerParams,\n  PersonalServerIdentity,\n  DownloadArtifactParams,\n} from \"../types\";\nimport type {\n  CreateOperationResponse,\n  GetOperationResponse,\n  IdentityResponseModel,\n} from \"../generated/server/server-exports\";\nimport {\n  NetworkError,\n  SerializationError,\n  SignatureError,\n  PersonalServerError,\n} from \"../errors\";\nimport type { ControllerContext } from \"./permissions\";\nimport type { Operation, PollingOptions } from \"../types/operations\";\nimport { BaseController } from \"./base\";\n\n// Server types are now auto-imported from the generated exports\n\n/**\n * Manages personal server interactions for secure data processing.\n *\n * @remarks\n * Handles communication with personal servers for computation requests\n * and identity retrieval. Personal servers process user data with\n * cryptographic verification, ensuring privacy and permission compliance.\n *\n * **Architecture:**\n * Servers use deterministic key derivation from user addresses.\n * Identity cached for offline retrieval. Operations authenticated\n * via wallet signatures and permission verification.\n *\n * **Method Selection:**\n * - `getIdentity()` - Retrieve server public key for encryption\n * - `createOperation()` - Submit computation with permission ID\n * - `getOperation()` - Check status and retrieve results\n * - `waitForOperation()` - Poll until completion or timeout\n * - `cancelOperation()` - Stop running operations\n *\n * **Typical Workflow:**\n * 1. Get server identity for encryption key\n * 2. Create operation with permission ID\n * 3. Poll for completion\n * 4. Retrieve results\n *\n * @example\n * ```typescript\n * // Get server identity for encryption\n * const identity = await vana.server.getIdentity({\n *   userAddress: \"0x742d35Cc6558Fd4D9e9E0E888F0462ef6919Bd36\"\n * });\n * console.log(`Server key: ${identity.publicKey}`);\n *\n * // Submit computation request\n * const operation = await vana.server.createOperation({\n *   permissionId: 123\n * });\n *\n * // Wait for results\n * const result = await vana.server.waitForOperation(operation.id);\n * console.log(\"Processing complete:\", result.result);\n * ```\n *\n * @category Server Management\n * @see For conceptual overview, visit {@link https://docs.vana.org/docs/personal-servers}\n */\nexport class ServerController extends BaseController {\n  constructor(context: ControllerContext) {\n    super(context);\n  }\n\n  private get personalServerBaseUrl(): string {\n    if (!this.context.defaultPersonalServerUrl) {\n      throw new PersonalServerError(\n        \"Personal server URL is required for server operations. \" +\n          \"Please configure defaultPersonalServerUrl in your VanaConfig.\",\n      );\n    }\n    return this.context.defaultPersonalServerUrl;\n  }\n\n  /**\n   * Retrieves cryptographic identity for a personal server.\n   *\n   * @remarks\n   * Fetches public key and metadata required for data encryption.\n   * Identity cached by infrastructure for offline retrieval.\n   * Each user address maps to deterministic server identity.\n   *\n   * @param request - Identity request parameters\n   * @param request.userAddress - Wallet address of server owner\n   *\n   * @returns Server identity with public key and metadata\n   *\n   * @throws {NetworkError} Identity service unavailable.\n   *   Check network connection and server URL configuration.\n   * @throws {PersonalServerError} Identity retrieval failed.\n   *   Verify user address and server registration.\n   *\n   * @example\n   * ```typescript\n   * const identity = await vana.server.getIdentity({\n   *   userAddress: \"0x742d35Cc6558Fd4D9e9E0E888F0462ef6919Bd36\"\n   * });\n   *\n   * console.log(`Server: ${identity.name}`);\n   * console.log(`Address: ${identity.address}`);\n   * console.log(`Public Key: ${identity.publicKey}`);\n   *\n   * // Use for encryption before data sharing\n   * const encrypted = await encryptWithPublicKey(\n   *   data,\n   *   identity.publicKey\n   * );\n   * ```\n   */\n  async getIdentity(\n    request: InitPersonalServerParams,\n  ): Promise<PersonalServerIdentity> {\n    try {\n      const response = await fetch(\n        `${this.personalServerBaseUrl}/identity?address=${request.userAddress}`,\n        {\n          method: \"GET\",\n          headers: {\n            \"Content-Type\": \"application/json\",\n          },\n        },\n      );\n\n      console.debug(\"🔍 Debug - getIdentity response\", response);\n      if (!response.ok) {\n        const errorText = await response.text();\n        throw new NetworkError(\n          `Local identity API request failed: ${response.status} ${response.statusText} - ${errorText}`,\n        );\n      }\n\n      const serverResponse = (await response.json()) as IdentityResponseModel;\n\n      return {\n        kind: serverResponse.personal_server.kind,\n        address: serverResponse.personal_server.address,\n        publicKey: serverResponse.personal_server.public_key,\n        baseUrl: this.personalServerBaseUrl,\n        name: \"Hosted Vana Server\",\n      };\n    } catch (error) {\n      if (\n        error instanceof NetworkError ||\n        error instanceof PersonalServerError\n      ) {\n        throw error;\n      }\n      throw new PersonalServerError(\n        `Failed to get personal server identity: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Creates a server operation and returns its details as a plain object.\n   *\n   * @remarks\n   * This method submits a computation request to the personal server and returns\n   * an Operation object that can be serialized and passed across API boundaries.\n   * Use `waitForOperation()` to poll for completion.\n   *\n   * @param params - The operation request parameters\n   * @param params.permissionId - The permission ID authorizing this operation.\n   *   Obtain via `vana.permissions.getUserPermissionGrantsOnChain()`.\n   * @returns An Operation object containing the operation ID and status\n   * @throws {PersonalServerError} When the server request fails or parameters are invalid\n   * @throws {NetworkError} When personal server API communication fails\n   * @example\n   * ```typescript\n   * const operation = await vana.server.createOperation({\n   *   permissionId: 123\n   * });\n   * console.log(`Operation ID: ${operation.id}`);\n   *\n   * // Wait for completion\n   * const result = await vana.server.waitForOperation(operation.id);\n   * console.log(\"Result:\", result.result);\n   * ```\n   */\n  async createOperation<T = unknown>(\n    params: CreateOperationParams,\n  ): Promise<Operation<T>> {\n    this.assertWallet();\n\n    try {\n      const requestData = {\n        permission_id: params.permissionId,\n      };\n\n      const requestJson = JSON.stringify(requestData);\n\n      const signature = await this.createSignature(requestJson);\n\n      const requestBody = {\n        app_signature: signature,\n        operation_request_json: requestJson,\n      };\n\n      // Step 5: Make request to personal server API\n      console.debug(\"🔍 Debug - createOperation requestBody\", requestBody);\n      const response = await this.makeRequest(requestBody);\n\n      return {\n        id: response.id,\n        status: \"starting\",\n        createdAt: Date.now(),\n      } as Operation<T>;\n    } catch (error) {\n      if (error instanceof Error) {\n        // Re-throw known Vana errors directly\n        if (\n          error instanceof NetworkError ||\n          error instanceof SerializationError ||\n          error instanceof SignatureError ||\n          error instanceof PersonalServerError\n        ) {\n          throw error;\n        }\n        // Wrap unknown errors\n        throw new PersonalServerError(\n          `Personal server operation creation failed: ${error.message}`,\n          error,\n        );\n      }\n      throw new PersonalServerError(\n        \"Personal server operation creation failed with unknown error\",\n      );\n    }\n  }\n\n  /**\n   * Retrieves the current status and result of a server operation.\n   *\n   * @remarks\n   * Common status values: `starting`, `running`, `succeeded`, `failed`, `canceled`.\n   * When status is `succeeded`, the result field contains the operation output.\n   *\n   * @param operationId - The ID of the operation to query\n   * @returns The operation as a plain object containing status, result, and metadata\n   * @throws {NetworkError} When the API request fails or returns invalid data\n   * @example\n   * ```typescript\n   * const operation = await vana.server.getOperation(operationId);\n   * if (operation.status === 'succeeded') {\n   *   console.log('Result:', operation.result);\n   * }\n   * ```\n   */\n  async getOperation<T = unknown>(operationId: string): Promise<Operation<T>> {\n    try {\n      console.debug(\"Polling Operation Status:\", operationId);\n\n      const response = await fetch(\n        `${this.personalServerBaseUrl}/operations/${operationId}`,\n        {\n          method: \"GET\",\n          headers: {\n            \"Content-Type\": \"application/json\",\n          },\n        },\n      );\n\n      if (!response.ok) {\n        const errorText = await response.text();\n        console.debug(\"Polling Error Response:\", {\n          status: response.status,\n          statusText: response.statusText,\n          error: errorText,\n        });\n        throw new NetworkError(\n          `Status polling failed: ${response.status} ${response.statusText} - ${errorText}`,\n        );\n      }\n\n      const data = (await response.json()) as GetOperationResponse;\n\n      console.debug(\"Polling Success Response:\", data);\n\n      return {\n        id: data.id,\n        status: data.status as Operation[\"status\"],\n        createdAt: Date.now(),\n        updatedAt: Date.now(),\n        result: data.status === \"succeeded\" ? (data.result as T) : undefined,\n        error:\n          data.status === \"failed\" ? (data.result ?? undefined) : undefined,\n      };\n    } catch (error) {\n      if (error instanceof NetworkError) {\n        throw error;\n      }\n      throw new NetworkError(\n        `Failed to poll status: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Waits for an operation to complete and returns the final result.\n   *\n   * @remarks\n   * This method polls the operation status at regular intervals until it\n   * reaches a terminal state (succeeded, failed, or canceled). Supports\n   * ergonomic overloads to accept either an Operation object or just the ID.\n   *\n   * @param opOrId - Either an Operation object or operation ID string\n   * @param options - Optional polling configuration\n   * @returns The completed operation with result or error\n   * @throws {PersonalServerError} When the operation fails or times out\n   * @example\n   * ```typescript\n   * // Using operation object\n   * const operation = await vana.server.createOperation({ permissionId: 123 });\n   * const completed = await vana.server.waitForOperation(operation);\n   *\n   * // Using just the ID\n   * const completed = await vana.server.waitForOperation(\"op_abc123\");\n   *\n   * // With custom timeout\n   * const completed = await vana.server.waitForOperation(operation, {\n   *   timeout: 60000,\n   *   pollingInterval: 1000\n   * });\n   * ```\n   */\n  async waitForOperation<T = unknown>(\n    opOrId: Operation<T> | string,\n    options?: PollingOptions,\n  ): Promise<Operation<T>> {\n    const id = typeof opOrId === \"string\" ? opOrId : opOrId.id;\n    const startTime = Date.now();\n    const timeout = options?.timeout ?? 30000;\n    const interval = options?.pollingInterval ?? 500;\n\n    while (true) {\n      const operation = await this.getOperation<T>(id);\n\n      if (operation.status === \"succeeded\") {\n        return operation;\n      }\n\n      if (operation.status === \"failed\") {\n        throw new PersonalServerError(\n          `Operation ${operation.status}: ${operation.error ?? \"Unknown error\"}`,\n        );\n      }\n\n      if (operation.status === \"canceled\") {\n        throw new PersonalServerError(`Operation was canceled`);\n      }\n\n      if (Date.now() - startTime > timeout) {\n        throw new PersonalServerError(`Operation timed out after ${timeout}ms`);\n      }\n\n      await new Promise((resolve) => setTimeout(resolve, interval));\n    }\n  }\n\n  /**\n   * Downloads an artifact generated by a server operation.\n   *\n   * @remarks\n   * Artifacts are files generated during operations like Gemini agent analysis.\n   * The download requires authentication using the application's signature.\n   * This method returns the artifact as a Blob that can be saved or processed.\n   *\n   * @param params - The download parameters\n   * @param params.operationId - The operation ID that generated the artifact\n   * @param params.artifactPath - The path to the artifact file to download\n   * @returns A Blob containing the artifact data\n   * @throws {PersonalServerError} When the artifact cannot be downloaded or doesn't exist\n   * @throws {NetworkError} When unable to reach the personal server API\n   * @throws {SignatureError} When unable to create the required signature\n   * @example\n   * ```typescript\n   * // Download an artifact after a Gemini operation\n   * const blob = await vana.server.downloadArtifact({\n   *   operationId: 'op_123',\n   *   artifactPath: 'analysis_report.pdf'\n   * });\n   *\n   * // Save to file in Node.js\n   * const buffer = await blob.arrayBuffer();\n   * fs.writeFileSync('report.pdf', Buffer.from(buffer));\n   *\n   * // Or create download link in browser\n   * const url = URL.createObjectURL(blob);\n   * const a = document.createElement('a');\n   * a.href = url;\n   * a.download = 'report.pdf';\n   * a.click();\n   * ```\n   */\n  async downloadArtifact(params: DownloadArtifactParams): Promise<Blob> {\n    this.assertWallet();\n\n    try {\n      const requestData = {\n        operation_id: params.operationId,\n        artifact_path: params.artifactPath,\n      };\n\n      const requestJson = JSON.stringify(requestData);\n      const signature = await this.createSignature(requestJson);\n\n      const requestBody = {\n        ...requestData,\n        signature,\n      };\n\n      const response = await fetch(\n        `${this.personalServerBaseUrl}/artifacts/download`,\n        {\n          method: \"POST\",\n          headers: {\n            \"Content-Type\": \"application/json\",\n          },\n          body: JSON.stringify(requestBody),\n        },\n      );\n\n      if (!response.ok) {\n        const errorText = await response.text();\n        throw new PersonalServerError(\n          `Artifact download failed: ${response.status} ${response.statusText} - ${errorText}`,\n        );\n      }\n\n      return await response.blob();\n    } catch (error) {\n      if (\n        error instanceof NetworkError ||\n        error instanceof PersonalServerError ||\n        error instanceof SignatureError\n      ) {\n        throw error;\n      }\n      throw new PersonalServerError(\n        `Failed to download artifact: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Cancels a running operation on the personal server.\n   *\n   * @remarks\n   * This method attempts to cancel an operation that is currently processing\n   * on the personal server. The operation must be in a cancellable state\n   * (typically `starting` or `processing`). Not all operations support\n   * cancellation, and cancellation may not be immediate. The server will\n   * attempt to stop the operation and update its status to `canceled`.\n   *\n   * **Cancellation Behavior:**\n   * - Operations in `succeeded` or `failed` states cannot be canceled\n   * - Some long-running operations may take time to respond to cancellation\n   * - Always verify cancellation by polling the operation status afterward\n   *\n   * @param operationId - The unique identifier of the operation to cancel,\n   *   obtained from `createOperation()` response\n   * @returns Promise that resolves when the cancellation request is accepted\n   * @throws {PersonalServerError} When the operation cannot be canceled or doesn't exist.\n   *   Check operation status - it may already be completed or failed.\n   * @throws {NetworkError} When unable to reach the personal server API.\n   *   Verify server URL and network connectivity.\n   * @example\n   * ```typescript\n   * // Start a long-running operation\n   * const operation = await vana.server.createOperation({\n   *   permissionId: 123\n   * });\n   *\n   * // Cancel if needed\n   * try {\n   *   await vana.server.cancelOperation(operation.id);\n   *   console.log(\"Cancellation requested\");\n   *\n   *   // Verify cancellation\n   *   const status = await vana.server.getOperation(operation.id);\n   *   if (status.status === \"canceled\") {\n   *     console.log(\"Operation successfully canceled\");\n   *   }\n   * } catch (error) {\n   *   console.error(\"Failed to cancel:\", error);\n   * }\n   * ```\n   */\n  async cancelOperation(operationId: string): Promise<void> {\n    try {\n      const response = await fetch(\n        `${this.personalServerBaseUrl}/operations/${operationId}/cancel`,\n        {\n          method: \"POST\",\n        },\n      );\n\n      if (!response.ok) {\n        const errorText = await response.text();\n        throw new PersonalServerError(\n          `Failed to cancel operation: ${response.status} ${response.statusText} - ${errorText}`,\n        );\n      }\n    } catch (error) {\n      if (error instanceof NetworkError) {\n        throw error;\n      }\n      throw new NetworkError(\n        `Failed to cancel operation: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Makes the request to the personal server API.\n   *\n   * @param requestBody - The post request parameters to serialize\n   * @returns JSON string representation of the request data\n   */\n  private async makeRequest(\n    requestBody: Record<string, unknown>,\n  ): Promise<CreateOperationResponse> {\n    try {\n      console.debug(\"Personal Server Request:\", {\n        url: `${this.personalServerBaseUrl}/operations`,\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n        },\n        body: requestBody,\n      });\n\n      const response = await fetch(`${this.personalServerBaseUrl}/operations`, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify(requestBody),\n      });\n\n      if (!response.ok) {\n        const errorText = await response.text();\n        console.debug(\"Personal Server Error Response:\", {\n          status: response.status,\n          statusText: response.statusText,\n          error: errorText,\n        });\n        throw new NetworkError(\n          `Personal server API request failed: ${response.status} ${response.statusText} - ${errorText}`,\n        );\n      }\n\n      const data = (await response.json()) as CreateOperationResponse;\n\n      console.debug(\"Personal Server Success Response:\", data);\n\n      return data;\n    } catch (error) {\n      if (error instanceof NetworkError) {\n        throw error;\n      }\n      throw new NetworkError(\n        `Failed to make personal server API request: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Creates a signature for the request JSON.\n   *\n   * @param requestJson - The JSON string to sign\n   * @returns Promise resolving to the cryptographic signature\n   */\n  private async createSignature(requestJson: string): Promise<string> {\n    try {\n      console.debug(\"🔍 Debug - createSignature\", requestJson);\n\n      // Use applicationClient if available, fallback to walletClient\n      const client =\n        this.context.applicationClient ?? this.context.walletClient;\n\n      if (!client) {\n        throw new SignatureError(\"No client available for signing\");\n      }\n\n      // Get the account from the wallet client\n      const { account } = client;\n      if (!account) {\n        throw new SignatureError(\"No account available for signing\");\n      }\n\n      // Only allow local accounts for signing\n      if (account.type !== \"local\") {\n        throw new SignatureError(\n          \"Only local accounts are supported for signing\",\n        );\n      }\n\n      console.debug(\"🔍 Debug - createSignature account\", account);\n      // Sign locally using the account's signMessage method\n      const signature = await account.signMessage({\n        message: requestJson,\n      });\n\n      return signature;\n    } catch (error) {\n      if (error instanceof Error && error.message.includes(\"User rejected\")) {\n        throw new SignatureError(\"User rejected the signature request\");\n      }\n      throw new SignatureError(\n        `Failed to create signature: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/controllers/server.ts"],"sourcesContent":["import type {\n  CreateOperationParams,\n  InitPersonalServerParams,\n  PersonalServerIdentity,\n  DownloadArtifactParams,\n} from \"../types\";\nimport type {\n  CreateOperationResponse,\n  GetOperationResponse,\n  IdentityResponseModel,\n} from \"../generated/server/server-exports\";\nimport {\n  NetworkError,\n  SerializationError,\n  SignatureError,\n  PersonalServerError,\n} from \"../errors\";\nimport type { ControllerContext } from \"./permissions\";\nimport type { Operation, PollingOptions } from \"../types/operations\";\nimport { BaseController } from \"./base\";\n\n// Server types are now auto-imported from the generated exports\n\n/**\n * Manages personal server interactions for secure data processing.\n *\n * @remarks\n * Handles communication with personal servers for computation requests\n * and identity retrieval. Personal servers process user data with\n * cryptographic verification, ensuring privacy and permission compliance.\n *\n * **Architecture:**\n * Servers use deterministic key derivation from user addresses.\n * Identity cached for offline retrieval. Operations authenticated\n * via wallet signatures and permission verification.\n *\n * **Method Selection:**\n * - `getIdentity()` - Retrieve server public key for encryption\n * - `createOperation()` - Submit computation with permission ID\n * - `getOperation()` - Check status and retrieve results\n * - `waitForOperation()` - Poll until completion or timeout\n * - `cancelOperation()` - Stop running operations\n *\n * **Typical Workflow:**\n * 1. Get server identity for encryption key\n * 2. Create operation with permission ID\n * 3. Poll for completion\n * 4. Retrieve results\n *\n * @example\n * ```typescript\n * // Get server identity for encryption\n * const identity = await vana.server.getIdentity({\n *   userAddress: \"0x742d35Cc6558Fd4D9e9E0E888F0462ef6919Bd36\"\n * });\n * console.log(`Server key: ${identity.publicKey}`);\n *\n * // Submit computation request\n * const operation = await vana.server.createOperation({\n *   permissionId: 123\n * });\n *\n * // Wait for results\n * const result = await vana.server.waitForOperation(operation.id);\n * console.log(\"Processing complete:\", result.result);\n * ```\n *\n * @category Server Management\n * @see For conceptual overview, visit {@link https://docs.vana.org/docs/personal-servers}\n */\nexport class ServerController extends BaseController {\n  constructor(context: ControllerContext) {\n    super(context);\n  }\n\n  private get personalServerBaseUrl(): string {\n    if (!this.context.defaultPersonalServerUrl) {\n      throw new PersonalServerError(\n        \"Personal server URL is required for server operations. \" +\n          \"Please configure defaultPersonalServerUrl in your VanaConfig.\",\n      );\n    }\n    return this.context.defaultPersonalServerUrl;\n  }\n\n  /**\n   * Retrieves cryptographic identity for a personal server.\n   *\n   * @remarks\n   * Fetches public key and metadata required for data encryption.\n   * Identity cached by infrastructure for offline retrieval.\n   * Each user address maps to deterministic server identity.\n   *\n   * @param request - Identity request parameters\n   * @param request.userAddress - Wallet address of server owner\n   *\n   * @returns Server identity with public key and metadata\n   *\n   * @throws {NetworkError} Identity service unavailable.\n   *   Check network connection and server URL configuration.\n   * @throws {PersonalServerError} Identity retrieval failed.\n   *   Verify user address and server registration.\n   *\n   * @example\n   * ```typescript\n   * const identity = await vana.server.getIdentity({\n   *   userAddress: \"0x742d35Cc6558Fd4D9e9E0E888F0462ef6919Bd36\"\n   * });\n   *\n   * console.log(`Server: ${identity.name}`);\n   * console.log(`Address: ${identity.address}`);\n   * console.log(`Public Key: ${identity.publicKey}`);\n   *\n   * // Use for encryption before data sharing\n   * const encrypted = await encryptWithPublicKey(\n   *   data,\n   *   identity.publicKey\n   * );\n   * ```\n   */\n  async getIdentity(\n    request: InitPersonalServerParams,\n  ): Promise<PersonalServerIdentity> {\n    try {\n      const response = await fetch(\n        `${this.personalServerBaseUrl}/identity?address=${request.userAddress}`,\n        {\n          method: \"GET\",\n          headers: {\n            \"Content-Type\": \"application/json\",\n          },\n        },\n      );\n\n      console.debug(\"🔍 Debug - getIdentity response\", response);\n      if (!response.ok) {\n        const errorText = await response.text();\n        throw new NetworkError(\n          `Local identity API request failed: ${response.status} ${response.statusText} - ${errorText}`,\n        );\n      }\n\n      const serverResponse = (await response.json()) as IdentityResponseModel;\n\n      return {\n        kind: serverResponse.personal_server.kind,\n        address: serverResponse.personal_server.address,\n        publicKey: serverResponse.personal_server.public_key,\n        baseUrl: this.personalServerBaseUrl,\n        name: \"Hosted Vana Server\",\n      };\n    } catch (error) {\n      if (\n        error instanceof NetworkError ||\n        error instanceof PersonalServerError\n      ) {\n        throw error;\n      }\n      throw new PersonalServerError(\n        `Failed to get personal server identity: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Creates a server operation and returns its details as a plain object.\n   *\n   * @remarks\n   * This method submits a computation request to the personal server and returns\n   * an Operation object that can be serialized and passed across API boundaries.\n   * Use `waitForOperation()` to poll for completion.\n   *\n   * @param params - The operation request parameters\n   * @param params.permissionId - The permission ID authorizing this operation.\n   *   Obtain via `vana.permissions.getUserPermissionGrantsOnChain()`.\n   * @returns An Operation object containing the operation ID and status\n   * @throws {PersonalServerError} When the server request fails or parameters are invalid\n   * @throws {NetworkError} When personal server API communication fails\n   * @example\n   * ```typescript\n   * const operation = await vana.server.createOperation({\n   *   permissionId: 123\n   * });\n   * console.log(`Operation ID: ${operation.id}`);\n   *\n   * // Wait for completion\n   * const result = await vana.server.waitForOperation(operation.id);\n   * console.log(\"Result:\", result.result);\n   * ```\n   */\n  async createOperation<T = unknown>(\n    params: CreateOperationParams,\n  ): Promise<Operation<T>> {\n    this.assertWallet();\n\n    try {\n      const requestData = {\n        permission_id: params.permissionId,\n      };\n\n      const requestJson = JSON.stringify(requestData);\n\n      const signature = await this.createSignature(requestJson);\n\n      const requestBody = {\n        app_signature: signature,\n        operation_request_json: requestJson,\n      };\n\n      // Step 5: Make request to personal server API\n      console.debug(\"🔍 Debug - createOperation requestBody\", requestBody);\n      const response = await this.makeRequest(requestBody);\n\n      return {\n        id: response.id,\n        status: \"starting\",\n        createdAt: Date.now(),\n      } as Operation<T>;\n    } catch (error) {\n      if (error instanceof Error) {\n        // Re-throw known Vana errors directly\n        if (\n          error instanceof NetworkError ||\n          error instanceof SerializationError ||\n          error instanceof SignatureError ||\n          error instanceof PersonalServerError\n        ) {\n          throw error;\n        }\n        // Wrap unknown errors\n        throw new PersonalServerError(\n          `Personal server operation creation failed: ${error.message}`,\n          error,\n        );\n      }\n      throw new PersonalServerError(\n        \"Personal server operation creation failed with unknown error\",\n      );\n    }\n  }\n\n  /**\n   * Retrieves the current status and result of a server operation.\n   *\n   * @remarks\n   * Common status values: `starting`, `running`, `succeeded`, `failed`, `canceled`.\n   * When status is `succeeded`, the result field contains the operation output.\n   *\n   * @param operationId - The ID of the operation to query\n   * @returns The operation as a plain object containing status, result, and metadata\n   * @throws {NetworkError} When the API request fails or returns invalid data\n   * @example\n   * ```typescript\n   * const operation = await vana.server.getOperation(operationId);\n   * if (operation.status === 'succeeded') {\n   *   console.log('Result:', operation.result);\n   * }\n   * ```\n   */\n  async getOperation<T = unknown>(operationId: string): Promise<Operation<T>> {\n    try {\n      console.debug(\"Polling Operation Status:\", operationId);\n\n      const response = await fetch(\n        `${this.personalServerBaseUrl}/operations/${operationId}`,\n        {\n          method: \"GET\",\n          headers: {\n            \"Content-Type\": \"application/json\",\n          },\n        },\n      );\n\n      if (!response.ok) {\n        const errorText = await response.text();\n        console.debug(\"Polling Error Response:\", {\n          status: response.status,\n          statusText: response.statusText,\n          error: errorText,\n        });\n        throw new NetworkError(\n          `Status polling failed: ${response.status} ${response.statusText} - ${errorText}`,\n        );\n      }\n\n      const data = (await response.json()) as GetOperationResponse;\n\n      console.debug(\"Polling Success Response:\", data);\n\n      return {\n        id: data.id,\n        status: data.status as Operation[\"status\"],\n        createdAt: Date.now(),\n        updatedAt: Date.now(),\n        result: data.status === \"succeeded\" ? (data.result as T) : undefined,\n        error:\n          data.status === \"failed\" ? (data.result ?? undefined) : undefined,\n      };\n    } catch (error) {\n      if (error instanceof NetworkError) {\n        throw error;\n      }\n      throw new NetworkError(\n        `Failed to poll status: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Waits for an operation to complete and returns the final result.\n   *\n   * @remarks\n   * This method polls the operation status at regular intervals until it\n   * reaches a terminal state (succeeded, failed, or canceled). Supports\n   * ergonomic overloads to accept either an Operation object or just the ID.\n   *\n   * @param opOrId - Either an Operation object or operation ID string\n   * @param options - Optional polling configuration\n   * @returns The completed operation with result or error\n   * @throws {PersonalServerError} When the operation fails or times out\n   * @example\n   * ```typescript\n   * // Using operation object\n   * const operation = await vana.server.createOperation({ permissionId: 123 });\n   * const completed = await vana.server.waitForOperation(operation);\n   *\n   * // Using just the ID\n   * const completed = await vana.server.waitForOperation(\"op_abc123\");\n   *\n   * // With custom timeout\n   * const completed = await vana.server.waitForOperation(operation, {\n   *   timeout: 60000,\n   *   pollingInterval: 1000\n   * });\n   * ```\n   */\n  async waitForOperation<T = unknown>(\n    opOrId: Operation<T> | string,\n    options?: PollingOptions,\n  ): Promise<Operation<T>> {\n    const id = typeof opOrId === \"string\" ? opOrId : opOrId.id;\n    const startTime = Date.now();\n    const timeout = options?.timeout ?? 30000;\n    const interval = options?.pollingInterval ?? 500;\n\n    while (true) {\n      const operation = await this.getOperation<T>(id);\n\n      if (operation.status === \"succeeded\") {\n        return operation;\n      }\n\n      if (operation.status === \"failed\") {\n        throw new PersonalServerError(\n          `Operation ${operation.status}: ${operation.error ?? \"Unknown error\"}`,\n        );\n      }\n\n      if (operation.status === \"canceled\") {\n        throw new PersonalServerError(`Operation was canceled`);\n      }\n\n      if (Date.now() - startTime > timeout) {\n        throw new PersonalServerError(`Operation timed out after ${timeout}ms`);\n      }\n\n      await new Promise((resolve) => setTimeout(resolve, interval));\n    }\n  }\n\n  /**\n   * Downloads an artifact generated by a server operation.\n   *\n   * @remarks\n   * Artifacts are files generated during operations like Gemini agent analysis.\n   * The download requires authentication using the application's signature.\n   * This method returns the artifact as a Blob that can be saved or processed.\n   *\n   * **Simplified Signature Scheme:**\n   * The signature is generated over the operation ID only, allowing a single signature\n   * to be reused for listing and downloading multiple artifacts from the same operation.\n   * This simplifies client implementation while maintaining security - access to the\n   * operation ID grants access to all artifacts.\n   *\n   * @param params - The download parameters\n   * @param params.operationId - The operation ID that generated the artifact\n   * @param params.artifactPath - The path to the artifact file to download\n   * @returns A Blob containing the artifact data\n   * @throws {PersonalServerError} When the artifact cannot be downloaded or doesn't exist\n   * @throws {NetworkError} When unable to reach the personal server API\n   * @throws {SignatureError} When unable to create the required signature\n   * @example\n   * ```typescript\n   * // Download an artifact after a Gemini operation\n   * const blob = await vana.server.downloadArtifact({\n   *   operationId: 'op_123',\n   *   artifactPath: 'analysis_report.pdf'\n   * });\n   *\n   * // Save to file in Node.js\n   * const buffer = await blob.arrayBuffer();\n   * fs.writeFileSync('report.pdf', Buffer.from(buffer));\n   *\n   * // Or create download link in browser\n   * const url = URL.createObjectURL(blob);\n   * const a = document.createElement('a');\n   * a.href = url;\n   * a.download = 'report.pdf';\n   * a.click();\n   * ```\n   */\n  async downloadArtifact(params: DownloadArtifactParams): Promise<Blob> {\n    this.assertWallet();\n\n    try {\n      // Simplified signature scheme: sign only operation_id\n      // This allows the same signature to be reused for all artifacts\n      const signatureData = {\n        operation_id: params.operationId,\n      };\n\n      const requestJson = JSON.stringify(signatureData);\n      const signature = await this.createSignature(requestJson);\n\n      // Request body still includes artifact_path for the API\n      const requestBody = {\n        operation_id: params.operationId,\n        artifact_path: params.artifactPath,\n        signature,\n      };\n\n      const response = await fetch(\n        `${this.personalServerBaseUrl}/artifacts/download`,\n        {\n          method: \"POST\",\n          headers: {\n            \"Content-Type\": \"application/json\",\n          },\n          body: JSON.stringify(requestBody),\n        },\n      );\n\n      if (!response.ok) {\n        const errorText = await response.text();\n        throw new PersonalServerError(\n          `Artifact download failed: ${response.status} ${response.statusText} - ${errorText}`,\n        );\n      }\n\n      return await response.blob();\n    } catch (error) {\n      if (\n        error instanceof NetworkError ||\n        error instanceof PersonalServerError ||\n        error instanceof SignatureError\n      ) {\n        throw error;\n      }\n      throw new PersonalServerError(\n        `Failed to download artifact: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Lists all artifacts generated by a server operation.\n   *\n   * @remarks\n   * Retrieves metadata for all artifact files produced by an operation,\n   * including file paths, sizes, and content types. This provides visibility\n   * into available outputs without downloading them.\n   *\n   * **Simplified Signature Scheme:**\n   * Uses the same signature as downloadArtifact - signs only operation_id.\n   * This allows reusing the same signature for listing and downloading.\n   *\n   * @param operationId - The operation ID that generated the artifacts\n   * @returns Promise resolving to array of artifact metadata objects\n   * @throws {PersonalServerError} When artifacts cannot be listed\n   * @throws {NetworkError} When unable to reach the personal server API\n   * @throws {SignatureError} When unable to create the required signature\n   * @example\n   * ```typescript\n   * // List artifacts from a Gemini operation\n   * const artifacts = await vana.server.listArtifacts('op_123');\n   *\n   * console.log(`Found ${artifacts.length} artifacts:`);\n   * artifacts.forEach(artifact => {\n   *   console.log(`- ${artifact.path} (${artifact.size} bytes)`);\n   * });\n   *\n   * // Download a specific artifact\n   * const blob = await vana.server.downloadArtifact({\n   *   operationId: 'op_123',\n   *   artifactPath: artifacts[0].path\n   * });\n   * ```\n   */\n  async listArtifacts(operationId: string): Promise<\n    Array<{\n      path: string;\n      size: number;\n      content_type: string;\n    }>\n  > {\n    this.assertWallet();\n\n    try {\n      // Use simplified signature scheme: sign only operation_id\n      const signatureData = {\n        operation_id: operationId,\n      };\n\n      const requestJson = JSON.stringify(signatureData);\n      const signature = await this.createSignature(requestJson);\n\n      const requestBody = {\n        operation_id: operationId,\n        signature,\n      };\n\n      const response = await fetch(\n        `${this.personalServerBaseUrl}/artifacts/${operationId}/list`,\n        {\n          method: \"POST\",\n          headers: {\n            \"Content-Type\": \"application/json\",\n          },\n          body: JSON.stringify(requestBody),\n        },\n      );\n\n      if (!response.ok) {\n        const errorText = await response.text();\n        throw new PersonalServerError(\n          `Failed to list artifacts: ${response.status} ${response.statusText} - ${errorText}`,\n        );\n      }\n\n      const data = await response.json();\n      return data.artifacts ?? [];\n    } catch (error) {\n      if (\n        error instanceof NetworkError ||\n        error instanceof PersonalServerError ||\n        error instanceof SignatureError\n      ) {\n        throw error;\n      }\n      throw new PersonalServerError(\n        `Failed to list artifacts: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Cancels a running operation on the personal server.\n   *\n   * @remarks\n   * This method attempts to cancel an operation that is currently processing\n   * on the personal server. The operation must be in a cancellable state\n   * (typically `starting` or `processing`). Not all operations support\n   * cancellation, and cancellation may not be immediate. The server will\n   * attempt to stop the operation and update its status to `canceled`.\n   *\n   * **Cancellation Behavior:**\n   * - Operations in `succeeded` or `failed` states cannot be canceled\n   * - Some long-running operations may take time to respond to cancellation\n   * - Always verify cancellation by polling the operation status afterward\n   *\n   * @param operationId - The unique identifier of the operation to cancel,\n   *   obtained from `createOperation()` response\n   * @returns Promise that resolves when the cancellation request is accepted\n   * @throws {PersonalServerError} When the operation cannot be canceled or doesn't exist.\n   *   Check operation status - it may already be completed or failed.\n   * @throws {NetworkError} When unable to reach the personal server API.\n   *   Verify server URL and network connectivity.\n   * @example\n   * ```typescript\n   * // Start a long-running operation\n   * const operation = await vana.server.createOperation({\n   *   permissionId: 123\n   * });\n   *\n   * // Cancel if needed\n   * try {\n   *   await vana.server.cancelOperation(operation.id);\n   *   console.log(\"Cancellation requested\");\n   *\n   *   // Verify cancellation\n   *   const status = await vana.server.getOperation(operation.id);\n   *   if (status.status === \"canceled\") {\n   *     console.log(\"Operation successfully canceled\");\n   *   }\n   * } catch (error) {\n   *   console.error(\"Failed to cancel:\", error);\n   * }\n   * ```\n   */\n  async cancelOperation(operationId: string): Promise<void> {\n    try {\n      const response = await fetch(\n        `${this.personalServerBaseUrl}/operations/${operationId}/cancel`,\n        {\n          method: \"POST\",\n        },\n      );\n\n      if (!response.ok) {\n        const errorText = await response.text();\n        throw new PersonalServerError(\n          `Failed to cancel operation: ${response.status} ${response.statusText} - ${errorText}`,\n        );\n      }\n    } catch (error) {\n      if (error instanceof NetworkError) {\n        throw error;\n      }\n      throw new NetworkError(\n        `Failed to cancel operation: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Makes the request to the personal server API.\n   *\n   * @param requestBody - The post request parameters to serialize\n   * @returns JSON string representation of the request data\n   */\n  private async makeRequest(\n    requestBody: Record<string, unknown>,\n  ): Promise<CreateOperationResponse> {\n    try {\n      console.debug(\"Personal Server Request:\", {\n        url: `${this.personalServerBaseUrl}/operations`,\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n        },\n        body: requestBody,\n      });\n\n      const response = await fetch(`${this.personalServerBaseUrl}/operations`, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify(requestBody),\n      });\n\n      if (!response.ok) {\n        const errorText = await response.text();\n        console.debug(\"Personal Server Error Response:\", {\n          status: response.status,\n          statusText: response.statusText,\n          error: errorText,\n        });\n        throw new NetworkError(\n          `Personal server API request failed: ${response.status} ${response.statusText} - ${errorText}`,\n        );\n      }\n\n      const data = (await response.json()) as CreateOperationResponse;\n\n      console.debug(\"Personal Server Success Response:\", data);\n\n      return data;\n    } catch (error) {\n      if (error instanceof NetworkError) {\n        throw error;\n      }\n      throw new NetworkError(\n        `Failed to make personal server API request: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Creates a signature for the request JSON.\n   *\n   * @param requestJson - The JSON string to sign\n   * @returns Promise resolving to the cryptographic signature\n   */\n  private async createSignature(requestJson: string): Promise<string> {\n    try {\n      console.debug(\"🔍 Debug - createSignature\", requestJson);\n\n      // Use applicationClient if available, fallback to walletClient\n      const client =\n        this.context.applicationClient ?? this.context.walletClient;\n\n      if (!client) {\n        throw new SignatureError(\"No client available for signing\");\n      }\n\n      // Get the account from the wallet client\n      const { account } = client;\n      if (!account) {\n        throw new SignatureError(\"No account available for signing\");\n      }\n\n      // Only allow local accounts for signing\n      if (account.type !== \"local\") {\n        throw new SignatureError(\n          \"Only local accounts are supported for signing\",\n        );\n      }\n\n      console.debug(\"🔍 Debug - createSignature account\", account);\n      // Sign locally using the account's signMessage method\n      const signature = await account.signMessage({\n        message: requestJson,\n      });\n\n      return signature;\n    } catch (error) {\n      if (error instanceof Error && error.message.includes(\"User rejected\")) {\n        throw new SignatureError(\"User rejected the signature request\");\n      }\n      throw new SignatureError(\n        `Failed to create signature: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/controllers/server.d.ts

@@ -171,6 +171,12 @@ export declare class ServerController extends BaseController {
      * The download requires authentication using the application's signature.
      * This method returns the artifact as a Blob that can be saved or processed.
      *
+     * **Simplified Signature Scheme:**
+     * The signature is generated over the operation ID only, allowing a single signature
+     * to be reused for listing and downloading multiple artifacts from the same operation.
+     * This simplifies client implementation while maintaining security - access to the
+     * operation ID grants access to all artifacts.
+     *
      * @param params - The download parameters
      * @param params.operationId - The operation ID that generated the artifact
      * @param params.artifactPath - The path to the artifact file to download
@@ -199,6 +205,45 @@ export declare class ServerController extends BaseController {
      * ```
      */
     downloadArtifact(params: DownloadArtifactParams): Promise<Blob>;
+    /**
+     * Lists all artifacts generated by a server operation.
+     *
+     * @remarks
+     * Retrieves metadata for all artifact files produced by an operation,
+     * including file paths, sizes, and content types. This provides visibility
+     * into available outputs without downloading them.
+     *
+     * **Simplified Signature Scheme:**
+     * Uses the same signature as downloadArtifact - signs only operation_id.
+     * This allows reusing the same signature for listing and downloading.
+     *
+     * @param operationId - The operation ID that generated the artifacts
+     * @returns Promise resolving to array of artifact metadata objects
+     * @throws {PersonalServerError} When artifacts cannot be listed
+     * @throws {NetworkError} When unable to reach the personal server API
+     * @throws {SignatureError} When unable to create the required signature
+     * @example
+     * ```typescript
+     * // List artifacts from a Gemini operation
+     * const artifacts = await vana.server.listArtifacts('op_123');
+     *
+     * console.log(`Found ${artifacts.length} artifacts:`);
+     * artifacts.forEach(artifact => {
+     *   console.log(`- ${artifact.path} (${artifact.size} bytes)`);
+     * });
+     *
+     * // Download a specific artifact
+     * const blob = await vana.server.downloadArtifact({
+     *   operationId: 'op_123',
+     *   artifactPath: artifacts[0].path
+     * });
+     * ```
+     */
+    listArtifacts(operationId: string): Promise<Array<{
+        path: string;
+        size: number;
+        content_type: string;
+    }>>;
     /**
      * Cancels a running operation on the personal server.
      *

package/dist/controllers/server.js

@@ -267,6 +267,12 @@ class ServerController extends BaseController {
    * The download requires authentication using the application's signature.
    * This method returns the artifact as a Blob that can be saved or processed.
    *
+   * **Simplified Signature Scheme:**
+   * The signature is generated over the operation ID only, allowing a single signature
+   * to be reused for listing and downloading multiple artifacts from the same operation.
+   * This simplifies client implementation while maintaining security - access to the
+   * operation ID grants access to all artifacts.
+   *
    * @param params - The download parameters
    * @param params.operationId - The operation ID that generated the artifact
    * @param params.artifactPath - The path to the artifact file to download
@@ -297,14 +303,14 @@ class ServerController extends BaseController {
   async downloadArtifact(params) {
     this.assertWallet();
     try {
-      const requestData = {
-        operation_id: params.operationId,
-        artifact_path: params.artifactPath
+      const signatureData = {
+        operation_id: params.operationId
       };
-      const requestJson = JSON.stringify(requestData);
+      const requestJson = JSON.stringify(signatureData);
       const signature = await this.createSignature(requestJson);
       const requestBody = {
-        ...requestData,
+        operation_id: params.operationId,
+        artifact_path: params.artifactPath,
         signature
       };
       const response = await fetch(
@@ -333,6 +339,79 @@ class ServerController extends BaseController {
       );
     }
   }
+  /**
+   * Lists all artifacts generated by a server operation.
+   *
+   * @remarks
+   * Retrieves metadata for all artifact files produced by an operation,
+   * including file paths, sizes, and content types. This provides visibility
+   * into available outputs without downloading them.
+   *
+   * **Simplified Signature Scheme:**
+   * Uses the same signature as downloadArtifact - signs only operation_id.
+   * This allows reusing the same signature for listing and downloading.
+   *
+   * @param operationId - The operation ID that generated the artifacts
+   * @returns Promise resolving to array of artifact metadata objects
+   * @throws {PersonalServerError} When artifacts cannot be listed
+   * @throws {NetworkError} When unable to reach the personal server API
+   * @throws {SignatureError} When unable to create the required signature
+   * @example
+   * ```typescript
+   * // List artifacts from a Gemini operation
+   * const artifacts = await vana.server.listArtifacts('op_123');
+   *
+   * console.log(`Found ${artifacts.length} artifacts:`);
+   * artifacts.forEach(artifact => {
+   *   console.log(`- ${artifact.path} (${artifact.size} bytes)`);
+   * });
+   *
+   * // Download a specific artifact
+   * const blob = await vana.server.downloadArtifact({
+   *   operationId: 'op_123',
+   *   artifactPath: artifacts[0].path
+   * });
+   * ```
+   */
+  async listArtifacts(operationId) {
+    this.assertWallet();
+    try {
+      const signatureData = {
+        operation_id: operationId
+      };
+      const requestJson = JSON.stringify(signatureData);
+      const signature = await this.createSignature(requestJson);
+      const requestBody = {
+        operation_id: operationId,
+        signature
+      };
+      const response = await fetch(
+        `${this.personalServerBaseUrl}/artifacts/${operationId}/list`,
+        {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify(requestBody)
+        }
+      );
+      if (!response.ok) {
+        const errorText = await response.text();
+        throw new PersonalServerError(
+          `Failed to list artifacts: ${response.status} ${response.statusText} - ${errorText}`
+        );
+      }
+      const data = await response.json();
+      return data.artifacts ?? [];
+    } catch (error) {
+      if (error instanceof NetworkError || error instanceof PersonalServerError || error instanceof SignatureError) {
+        throw error;
+      }
+      throw new PersonalServerError(
+        `Failed to list artifacts: ${error instanceof Error ? error.message : "Unknown error"}`
+      );
+    }
+  }
   /**
    * Cancels a running operation on the personal server.
    *

package/dist/controllers/server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controllers/server.ts"],"sourcesContent":["import type {\n  CreateOperationParams,\n  InitPersonalServerParams,\n  PersonalServerIdentity,\n  DownloadArtifactParams,\n} from \"../types\";\nimport type {\n  CreateOperationResponse,\n  GetOperationResponse,\n  IdentityResponseModel,\n} from \"../generated/server/server-exports\";\nimport {\n  NetworkError,\n  SerializationError,\n  SignatureError,\n  PersonalServerError,\n} from \"../errors\";\nimport type { ControllerContext } from \"./permissions\";\nimport type { Operation, PollingOptions } from \"../types/operations\";\nimport { BaseController } from \"./base\";\n\n// Server types are now auto-imported from the generated exports\n\n/**\n * Manages personal server interactions for secure data processing.\n *\n * @remarks\n * Handles communication with personal servers for computation requests\n * and identity retrieval. Personal servers process user data with\n * cryptographic verification, ensuring privacy and permission compliance.\n *\n * **Architecture:**\n * Servers use deterministic key derivation from user addresses.\n * Identity cached for offline retrieval. Operations authenticated\n * via wallet signatures and permission verification.\n *\n * **Method Selection:**\n * - `getIdentity()` - Retrieve server public key for encryption\n * - `createOperation()` - Submit computation with permission ID\n * - `getOperation()` - Check status and retrieve results\n * - `waitForOperation()` - Poll until completion or timeout\n * - `cancelOperation()` - Stop running operations\n *\n * **Typical Workflow:**\n * 1. Get server identity for encryption key\n * 2. Create operation with permission ID\n * 3. Poll for completion\n * 4. Retrieve results\n *\n * @example\n * ```typescript\n * // Get server identity for encryption\n * const identity = await vana.server.getIdentity({\n *   userAddress: \"0x742d35Cc6558Fd4D9e9E0E888F0462ef6919Bd36\"\n * });\n * console.log(`Server key: ${identity.publicKey}`);\n *\n * // Submit computation request\n * const operation = await vana.server.createOperation({\n *   permissionId: 123\n * });\n *\n * // Wait for results\n * const result = await vana.server.waitForOperation(operation.id);\n * console.log(\"Processing complete:\", result.result);\n * ```\n *\n * @category Server Management\n * @see For conceptual overview, visit {@link https://docs.vana.org/docs/personal-servers}\n */\nexport class ServerController extends BaseController {\n  constructor(context: ControllerContext) {\n    super(context);\n  }\n\n  private get personalServerBaseUrl(): string {\n    if (!this.context.defaultPersonalServerUrl) {\n      throw new PersonalServerError(\n        \"Personal server URL is required for server operations. \" +\n          \"Please configure defaultPersonalServerUrl in your VanaConfig.\",\n      );\n    }\n    return this.context.defaultPersonalServerUrl;\n  }\n\n  /**\n   * Retrieves cryptographic identity for a personal server.\n   *\n   * @remarks\n   * Fetches public key and metadata required for data encryption.\n   * Identity cached by infrastructure for offline retrieval.\n   * Each user address maps to deterministic server identity.\n   *\n   * @param request - Identity request parameters\n   * @param request.userAddress - Wallet address of server owner\n   *\n   * @returns Server identity with public key and metadata\n   *\n   * @throws {NetworkError} Identity service unavailable.\n   *   Check network connection and server URL configuration.\n   * @throws {PersonalServerError} Identity retrieval failed.\n   *   Verify user address and server registration.\n   *\n   * @example\n   * ```typescript\n   * const identity = await vana.server.getIdentity({\n   *   userAddress: \"0x742d35Cc6558Fd4D9e9E0E888F0462ef6919Bd36\"\n   * });\n   *\n   * console.log(`Server: ${identity.name}`);\n   * console.log(`Address: ${identity.address}`);\n   * console.log(`Public Key: ${identity.publicKey}`);\n   *\n   * // Use for encryption before data sharing\n   * const encrypted = await encryptWithPublicKey(\n   *   data,\n   *   identity.publicKey\n   * );\n   * ```\n   */\n  async getIdentity(\n    request: InitPersonalServerParams,\n  ): Promise<PersonalServerIdentity> {\n    try {\n      const response = await fetch(\n        `${this.personalServerBaseUrl}/identity?address=${request.userAddress}`,\n        {\n          method: \"GET\",\n          headers: {\n            \"Content-Type\": \"application/json\",\n          },\n        },\n      );\n\n      console.debug(\"🔍 Debug - getIdentity response\", response);\n      if (!response.ok) {\n        const errorText = await response.text();\n        throw new NetworkError(\n          `Local identity API request failed: ${response.status} ${response.statusText} - ${errorText}`,\n        );\n      }\n\n      const serverResponse = (await response.json()) as IdentityResponseModel;\n\n      return {\n        kind: serverResponse.personal_server.kind,\n        address: serverResponse.personal_server.address,\n        publicKey: serverResponse.personal_server.public_key,\n        baseUrl: this.personalServerBaseUrl,\n        name: \"Hosted Vana Server\",\n      };\n    } catch (error) {\n      if (\n        error instanceof NetworkError ||\n        error instanceof PersonalServerError\n      ) {\n        throw error;\n      }\n      throw new PersonalServerError(\n        `Failed to get personal server identity: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Creates a server operation and returns its details as a plain object.\n   *\n   * @remarks\n   * This method submits a computation request to the personal server and returns\n   * an Operation object that can be serialized and passed across API boundaries.\n   * Use `waitForOperation()` to poll for completion.\n   *\n   * @param params - The operation request parameters\n   * @param params.permissionId - The permission ID authorizing this operation.\n   *   Obtain via `vana.permissions.getUserPermissionGrantsOnChain()`.\n   * @returns An Operation object containing the operation ID and status\n   * @throws {PersonalServerError} When the server request fails or parameters are invalid\n   * @throws {NetworkError} When personal server API communication fails\n   * @example\n   * ```typescript\n   * const operation = await vana.server.createOperation({\n   *   permissionId: 123\n   * });\n   * console.log(`Operation ID: ${operation.id}`);\n   *\n   * // Wait for completion\n   * const result = await vana.server.waitForOperation(operation.id);\n   * console.log(\"Result:\", result.result);\n   * ```\n   */\n  async createOperation<T = unknown>(\n    params: CreateOperationParams,\n  ): Promise<Operation<T>> {\n    this.assertWallet();\n\n    try {\n      const requestData = {\n        permission_id: params.permissionId,\n      };\n\n      const requestJson = JSON.stringify(requestData);\n\n      const signature = await this.createSignature(requestJson);\n\n      const requestBody = {\n        app_signature: signature,\n        operation_request_json: requestJson,\n      };\n\n      // Step 5: Make request to personal server API\n      console.debug(\"🔍 Debug - createOperation requestBody\", requestBody);\n      const response = await this.makeRequest(requestBody);\n\n      return {\n        id: response.id,\n        status: \"starting\",\n        createdAt: Date.now(),\n      } as Operation<T>;\n    } catch (error) {\n      if (error instanceof Error) {\n        // Re-throw known Vana errors directly\n        if (\n          error instanceof NetworkError ||\n          error instanceof SerializationError ||\n          error instanceof SignatureError ||\n          error instanceof PersonalServerError\n        ) {\n          throw error;\n        }\n        // Wrap unknown errors\n        throw new PersonalServerError(\n          `Personal server operation creation failed: ${error.message}`,\n          error,\n        );\n      }\n      throw new PersonalServerError(\n        \"Personal server operation creation failed with unknown error\",\n      );\n    }\n  }\n\n  /**\n   * Retrieves the current status and result of a server operation.\n   *\n   * @remarks\n   * Common status values: `starting`, `running`, `succeeded`, `failed`, `canceled`.\n   * When status is `succeeded`, the result field contains the operation output.\n   *\n   * @param operationId - The ID of the operation to query\n   * @returns The operation as a plain object containing status, result, and metadata\n   * @throws {NetworkError} When the API request fails or returns invalid data\n   * @example\n   * ```typescript\n   * const operation = await vana.server.getOperation(operationId);\n   * if (operation.status === 'succeeded') {\n   *   console.log('Result:', operation.result);\n   * }\n   * ```\n   */\n  async getOperation<T = unknown>(operationId: string): Promise<Operation<T>> {\n    try {\n      console.debug(\"Polling Operation Status:\", operationId);\n\n      const response = await fetch(\n        `${this.personalServerBaseUrl}/operations/${operationId}`,\n        {\n          method: \"GET\",\n          headers: {\n            \"Content-Type\": \"application/json\",\n          },\n        },\n      );\n\n      if (!response.ok) {\n        const errorText = await response.text();\n        console.debug(\"Polling Error Response:\", {\n          status: response.status,\n          statusText: response.statusText,\n          error: errorText,\n        });\n        throw new NetworkError(\n          `Status polling failed: ${response.status} ${response.statusText} - ${errorText}`,\n        );\n      }\n\n      const data = (await response.json()) as GetOperationResponse;\n\n      console.debug(\"Polling Success Response:\", data);\n\n      return {\n        id: data.id,\n        status: data.status as Operation[\"status\"],\n        createdAt: Date.now(),\n        updatedAt: Date.now(),\n        result: data.status === \"succeeded\" ? (data.result as T) : undefined,\n        error:\n          data.status === \"failed\" ? (data.result ?? undefined) : undefined,\n      };\n    } catch (error) {\n      if (error instanceof NetworkError) {\n        throw error;\n      }\n      throw new NetworkError(\n        `Failed to poll status: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Waits for an operation to complete and returns the final result.\n   *\n   * @remarks\n   * This method polls the operation status at regular intervals until it\n   * reaches a terminal state (succeeded, failed, or canceled). Supports\n   * ergonomic overloads to accept either an Operation object or just the ID.\n   *\n   * @param opOrId - Either an Operation object or operation ID string\n   * @param options - Optional polling configuration\n   * @returns The completed operation with result or error\n   * @throws {PersonalServerError} When the operation fails or times out\n   * @example\n   * ```typescript\n   * // Using operation object\n   * const operation = await vana.server.createOperation({ permissionId: 123 });\n   * const completed = await vana.server.waitForOperation(operation);\n   *\n   * // Using just the ID\n   * const completed = await vana.server.waitForOperation(\"op_abc123\");\n   *\n   * // With custom timeout\n   * const completed = await vana.server.waitForOperation(operation, {\n   *   timeout: 60000,\n   *   pollingInterval: 1000\n   * });\n   * ```\n   */\n  async waitForOperation<T = unknown>(\n    opOrId: Operation<T> | string,\n    options?: PollingOptions,\n  ): Promise<Operation<T>> {\n    const id = typeof opOrId === \"string\" ? opOrId : opOrId.id;\n    const startTime = Date.now();\n    const timeout = options?.timeout ?? 30000;\n    const interval = options?.pollingInterval ?? 500;\n\n    while (true) {\n      const operation = await this.getOperation<T>(id);\n\n      if (operation.status === \"succeeded\") {\n        return operation;\n      }\n\n      if (operation.status === \"failed\") {\n        throw new PersonalServerError(\n          `Operation ${operation.status}: ${operation.error ?? \"Unknown error\"}`,\n        );\n      }\n\n      if (operation.status === \"canceled\") {\n        throw new PersonalServerError(`Operation was canceled`);\n      }\n\n      if (Date.now() - startTime > timeout) {\n        throw new PersonalServerError(`Operation timed out after ${timeout}ms`);\n      }\n\n      await new Promise((resolve) => setTimeout(resolve, interval));\n    }\n  }\n\n  /**\n   * Downloads an artifact generated by a server operation.\n   *\n   * @remarks\n   * Artifacts are files generated during operations like Gemini agent analysis.\n   * The download requires authentication using the application's signature.\n   * This method returns the artifact as a Blob that can be saved or processed.\n   *\n   * @param params - The download parameters\n   * @param params.operationId - The operation ID that generated the artifact\n   * @param params.artifactPath - The path to the artifact file to download\n   * @returns A Blob containing the artifact data\n   * @throws {PersonalServerError} When the artifact cannot be downloaded or doesn't exist\n   * @throws {NetworkError} When unable to reach the personal server API\n   * @throws {SignatureError} When unable to create the required signature\n   * @example\n   * ```typescript\n   * // Download an artifact after a Gemini operation\n   * const blob = await vana.server.downloadArtifact({\n   *   operationId: 'op_123',\n   *   artifactPath: 'analysis_report.pdf'\n   * });\n   *\n   * // Save to file in Node.js\n   * const buffer = await blob.arrayBuffer();\n   * fs.writeFileSync('report.pdf', Buffer.from(buffer));\n   *\n   * // Or create download link in browser\n   * const url = URL.createObjectURL(blob);\n   * const a = document.createElement('a');\n   * a.href = url;\n   * a.download = 'report.pdf';\n   * a.click();\n   * ```\n   */\n  async downloadArtifact(params: DownloadArtifactParams): Promise<Blob> {\n    this.assertWallet();\n\n    try {\n      const requestData = {\n        operation_id: params.operationId,\n        artifact_path: params.artifactPath,\n      };\n\n      const requestJson = JSON.stringify(requestData);\n      const signature = await this.createSignature(requestJson);\n\n      const requestBody = {\n        ...requestData,\n        signature,\n      };\n\n      const response = await fetch(\n        `${this.personalServerBaseUrl}/artifacts/download`,\n        {\n          method: \"POST\",\n          headers: {\n            \"Content-Type\": \"application/json\",\n          },\n          body: JSON.stringify(requestBody),\n        },\n      );\n\n      if (!response.ok) {\n        const errorText = await response.text();\n        throw new PersonalServerError(\n          `Artifact download failed: ${response.status} ${response.statusText} - ${errorText}`,\n        );\n      }\n\n      return await response.blob();\n    } catch (error) {\n      if (\n        error instanceof NetworkError ||\n        error instanceof PersonalServerError ||\n        error instanceof SignatureError\n      ) {\n        throw error;\n      }\n      throw new PersonalServerError(\n        `Failed to download artifact: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Cancels a running operation on the personal server.\n   *\n   * @remarks\n   * This method attempts to cancel an operation that is currently processing\n   * on the personal server. The operation must be in a cancellable state\n   * (typically `starting` or `processing`). Not all operations support\n   * cancellation, and cancellation may not be immediate. The server will\n   * attempt to stop the operation and update its status to `canceled`.\n   *\n   * **Cancellation Behavior:**\n   * - Operations in `succeeded` or `failed` states cannot be canceled\n   * - Some long-running operations may take time to respond to cancellation\n   * - Always verify cancellation by polling the operation status afterward\n   *\n   * @param operationId - The unique identifier of the operation to cancel,\n   *   obtained from `createOperation()` response\n   * @returns Promise that resolves when the cancellation request is accepted\n   * @throws {PersonalServerError} When the operation cannot be canceled or doesn't exist.\n   *   Check operation status - it may already be completed or failed.\n   * @throws {NetworkError} When unable to reach the personal server API.\n   *   Verify server URL and network connectivity.\n   * @example\n   * ```typescript\n   * // Start a long-running operation\n   * const operation = await vana.server.createOperation({\n   *   permissionId: 123\n   * });\n   *\n   * // Cancel if needed\n   * try {\n   *   await vana.server.cancelOperation(operation.id);\n   *   console.log(\"Cancellation requested\");\n   *\n   *   // Verify cancellation\n   *   const status = await vana.server.getOperation(operation.id);\n   *   if (status.status === \"canceled\") {\n   *     console.log(\"Operation successfully canceled\");\n   *   }\n   * } catch (error) {\n   *   console.error(\"Failed to cancel:\", error);\n   * }\n   * ```\n   */\n  async cancelOperation(operationId: string): Promise<void> {\n    try {\n      const response = await fetch(\n        `${this.personalServerBaseUrl}/operations/${operationId}/cancel`,\n        {\n          method: \"POST\",\n        },\n      );\n\n      if (!response.ok) {\n        const errorText = await response.text();\n        throw new PersonalServerError(\n          `Failed to cancel operation: ${response.status} ${response.statusText} - ${errorText}`,\n        );\n      }\n    } catch (error) {\n      if (error instanceof NetworkError) {\n        throw error;\n      }\n      throw new NetworkError(\n        `Failed to cancel operation: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Makes the request to the personal server API.\n   *\n   * @param requestBody - The post request parameters to serialize\n   * @returns JSON string representation of the request data\n   */\n  private async makeRequest(\n    requestBody: Record<string, unknown>,\n  ): Promise<CreateOperationResponse> {\n    try {\n      console.debug(\"Personal Server Request:\", {\n        url: `${this.personalServerBaseUrl}/operations`,\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n        },\n        body: requestBody,\n      });\n\n      const response = await fetch(`${this.personalServerBaseUrl}/operations`, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify(requestBody),\n      });\n\n      if (!response.ok) {\n        const errorText = await response.text();\n        console.debug(\"Personal Server Error Response:\", {\n          status: response.status,\n          statusText: response.statusText,\n          error: errorText,\n        });\n        throw new NetworkError(\n          `Personal server API request failed: ${response.status} ${response.statusText} - ${errorText}`,\n        );\n      }\n\n      const data = (await response.json()) as CreateOperationResponse;\n\n      console.debug(\"Personal Server Success Response:\", data);\n\n      return data;\n    } catch (error) {\n      if (error instanceof NetworkError) {\n        throw error;\n      }\n      throw new NetworkError(\n        `Failed to make personal server API request: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Creates a signature for the request JSON.\n   *\n   * @param requestJson - The JSON string to sign\n   * @returns Promise resolving to the cryptographic signature\n   */\n  private async createSignature(requestJson: string): Promise<string> {\n    try {\n      console.debug(\"🔍 Debug - createSignature\", requestJson);\n\n      // Use applicationClient if available, fallback to walletClient\n      const client =\n        this.context.applicationClient ?? this.context.walletClient;\n\n      if (!client) {\n        throw new SignatureError(\"No client available for signing\");\n      }\n\n      // Get the account from the wallet client\n      const { account } = client;\n      if (!account) {\n        throw new SignatureError(\"No account available for signing\");\n      }\n\n      // Only allow local accounts for signing\n      if (account.type !== \"local\") {\n        throw new SignatureError(\n          \"Only local accounts are supported for signing\",\n        );\n      }\n\n      console.debug(\"🔍 Debug - createSignature account\", account);\n      // Sign locally using the account's signMessage method\n      const signature = await account.signMessage({\n        message: requestJson,\n      });\n\n      return signature;\n    } catch (error) {\n      if (error instanceof Error && error.message.includes(\"User rejected\")) {\n        throw new SignatureError(\"User rejected the signature request\");\n      }\n      throw new SignatureError(\n        `Failed to create signature: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/controllers/server.ts"],"sourcesContent":["import type {\n  CreateOperationParams,\n  InitPersonalServerParams,\n  PersonalServerIdentity,\n  DownloadArtifactParams,\n} from \"../types\";\nimport type {\n  CreateOperationResponse,\n  GetOperationResponse,\n  IdentityResponseModel,\n} from \"../generated/server/server-exports\";\nimport {\n  NetworkError,\n  SerializationError,\n  SignatureError,\n  PersonalServerError,\n} from \"../errors\";\nimport type { ControllerContext } from \"./permissions\";\nimport type { Operation, PollingOptions } from \"../types/operations\";\nimport { BaseController } from \"./base\";\n\n// Server types are now auto-imported from the generated exports\n\n/**\n * Manages personal server interactions for secure data processing.\n *\n * @remarks\n * Handles communication with personal servers for computation requests\n * and identity retrieval. Personal servers process user data with\n * cryptographic verification, ensuring privacy and permission compliance.\n *\n * **Architecture:**\n * Servers use deterministic key derivation from user addresses.\n * Identity cached for offline retrieval. Operations authenticated\n * via wallet signatures and permission verification.\n *\n * **Method Selection:**\n * - `getIdentity()` - Retrieve server public key for encryption\n * - `createOperation()` - Submit computation with permission ID\n * - `getOperation()` - Check status and retrieve results\n * - `waitForOperation()` - Poll until completion or timeout\n * - `cancelOperation()` - Stop running operations\n *\n * **Typical Workflow:**\n * 1. Get server identity for encryption key\n * 2. Create operation with permission ID\n * 3. Poll for completion\n * 4. Retrieve results\n *\n * @example\n * ```typescript\n * // Get server identity for encryption\n * const identity = await vana.server.getIdentity({\n *   userAddress: \"0x742d35Cc6558Fd4D9e9E0E888F0462ef6919Bd36\"\n * });\n * console.log(`Server key: ${identity.publicKey}`);\n *\n * // Submit computation request\n * const operation = await vana.server.createOperation({\n *   permissionId: 123\n * });\n *\n * // Wait for results\n * const result = await vana.server.waitForOperation(operation.id);\n * console.log(\"Processing complete:\", result.result);\n * ```\n *\n * @category Server Management\n * @see For conceptual overview, visit {@link https://docs.vana.org/docs/personal-servers}\n */\nexport class ServerController extends BaseController {\n  constructor(context: ControllerContext) {\n    super(context);\n  }\n\n  private get personalServerBaseUrl(): string {\n    if (!this.context.defaultPersonalServerUrl) {\n      throw new PersonalServerError(\n        \"Personal server URL is required for server operations. \" +\n          \"Please configure defaultPersonalServerUrl in your VanaConfig.\",\n      );\n    }\n    return this.context.defaultPersonalServerUrl;\n  }\n\n  /**\n   * Retrieves cryptographic identity for a personal server.\n   *\n   * @remarks\n   * Fetches public key and metadata required for data encryption.\n   * Identity cached by infrastructure for offline retrieval.\n   * Each user address maps to deterministic server identity.\n   *\n   * @param request - Identity request parameters\n   * @param request.userAddress - Wallet address of server owner\n   *\n   * @returns Server identity with public key and metadata\n   *\n   * @throws {NetworkError} Identity service unavailable.\n   *   Check network connection and server URL configuration.\n   * @throws {PersonalServerError} Identity retrieval failed.\n   *   Verify user address and server registration.\n   *\n   * @example\n   * ```typescript\n   * const identity = await vana.server.getIdentity({\n   *   userAddress: \"0x742d35Cc6558Fd4D9e9E0E888F0462ef6919Bd36\"\n   * });\n   *\n   * console.log(`Server: ${identity.name}`);\n   * console.log(`Address: ${identity.address}`);\n   * console.log(`Public Key: ${identity.publicKey}`);\n   *\n   * // Use for encryption before data sharing\n   * const encrypted = await encryptWithPublicKey(\n   *   data,\n   *   identity.publicKey\n   * );\n   * ```\n   */\n  async getIdentity(\n    request: InitPersonalServerParams,\n  ): Promise<PersonalServerIdentity> {\n    try {\n      const response = await fetch(\n        `${this.personalServerBaseUrl}/identity?address=${request.userAddress}`,\n        {\n          method: \"GET\",\n          headers: {\n            \"Content-Type\": \"application/json\",\n          },\n        },\n      );\n\n      console.debug(\"🔍 Debug - getIdentity response\", response);\n      if (!response.ok) {\n        const errorText = await response.text();\n        throw new NetworkError(\n          `Local identity API request failed: ${response.status} ${response.statusText} - ${errorText}`,\n        );\n      }\n\n      const serverResponse = (await response.json()) as IdentityResponseModel;\n\n      return {\n        kind: serverResponse.personal_server.kind,\n        address: serverResponse.personal_server.address,\n        publicKey: serverResponse.personal_server.public_key,\n        baseUrl: this.personalServerBaseUrl,\n        name: \"Hosted Vana Server\",\n      };\n    } catch (error) {\n      if (\n        error instanceof NetworkError ||\n        error instanceof PersonalServerError\n      ) {\n        throw error;\n      }\n      throw new PersonalServerError(\n        `Failed to get personal server identity: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Creates a server operation and returns its details as a plain object.\n   *\n   * @remarks\n   * This method submits a computation request to the personal server and returns\n   * an Operation object that can be serialized and passed across API boundaries.\n   * Use `waitForOperation()` to poll for completion.\n   *\n   * @param params - The operation request parameters\n   * @param params.permissionId - The permission ID authorizing this operation.\n   *   Obtain via `vana.permissions.getUserPermissionGrantsOnChain()`.\n   * @returns An Operation object containing the operation ID and status\n   * @throws {PersonalServerError} When the server request fails or parameters are invalid\n   * @throws {NetworkError} When personal server API communication fails\n   * @example\n   * ```typescript\n   * const operation = await vana.server.createOperation({\n   *   permissionId: 123\n   * });\n   * console.log(`Operation ID: ${operation.id}`);\n   *\n   * // Wait for completion\n   * const result = await vana.server.waitForOperation(operation.id);\n   * console.log(\"Result:\", result.result);\n   * ```\n   */\n  async createOperation<T = unknown>(\n    params: CreateOperationParams,\n  ): Promise<Operation<T>> {\n    this.assertWallet();\n\n    try {\n      const requestData = {\n        permission_id: params.permissionId,\n      };\n\n      const requestJson = JSON.stringify(requestData);\n\n      const signature = await this.createSignature(requestJson);\n\n      const requestBody = {\n        app_signature: signature,\n        operation_request_json: requestJson,\n      };\n\n      // Step 5: Make request to personal server API\n      console.debug(\"🔍 Debug - createOperation requestBody\", requestBody);\n      const response = await this.makeRequest(requestBody);\n\n      return {\n        id: response.id,\n        status: \"starting\",\n        createdAt: Date.now(),\n      } as Operation<T>;\n    } catch (error) {\n      if (error instanceof Error) {\n        // Re-throw known Vana errors directly\n        if (\n          error instanceof NetworkError ||\n          error instanceof SerializationError ||\n          error instanceof SignatureError ||\n          error instanceof PersonalServerError\n        ) {\n          throw error;\n        }\n        // Wrap unknown errors\n        throw new PersonalServerError(\n          `Personal server operation creation failed: ${error.message}`,\n          error,\n        );\n      }\n      throw new PersonalServerError(\n        \"Personal server operation creation failed with unknown error\",\n      );\n    }\n  }\n\n  /**\n   * Retrieves the current status and result of a server operation.\n   *\n   * @remarks\n   * Common status values: `starting`, `running`, `succeeded`, `failed`, `canceled`.\n   * When status is `succeeded`, the result field contains the operation output.\n   *\n   * @param operationId - The ID of the operation to query\n   * @returns The operation as a plain object containing status, result, and metadata\n   * @throws {NetworkError} When the API request fails or returns invalid data\n   * @example\n   * ```typescript\n   * const operation = await vana.server.getOperation(operationId);\n   * if (operation.status === 'succeeded') {\n   *   console.log('Result:', operation.result);\n   * }\n   * ```\n   */\n  async getOperation<T = unknown>(operationId: string): Promise<Operation<T>> {\n    try {\n      console.debug(\"Polling Operation Status:\", operationId);\n\n      const response = await fetch(\n        `${this.personalServerBaseUrl}/operations/${operationId}`,\n        {\n          method: \"GET\",\n          headers: {\n            \"Content-Type\": \"application/json\",\n          },\n        },\n      );\n\n      if (!response.ok) {\n        const errorText = await response.text();\n        console.debug(\"Polling Error Response:\", {\n          status: response.status,\n          statusText: response.statusText,\n          error: errorText,\n        });\n        throw new NetworkError(\n          `Status polling failed: ${response.status} ${response.statusText} - ${errorText}`,\n        );\n      }\n\n      const data = (await response.json()) as GetOperationResponse;\n\n      console.debug(\"Polling Success Response:\", data);\n\n      return {\n        id: data.id,\n        status: data.status as Operation[\"status\"],\n        createdAt: Date.now(),\n        updatedAt: Date.now(),\n        result: data.status === \"succeeded\" ? (data.result as T) : undefined,\n        error:\n          data.status === \"failed\" ? (data.result ?? undefined) : undefined,\n      };\n    } catch (error) {\n      if (error instanceof NetworkError) {\n        throw error;\n      }\n      throw new NetworkError(\n        `Failed to poll status: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Waits for an operation to complete and returns the final result.\n   *\n   * @remarks\n   * This method polls the operation status at regular intervals until it\n   * reaches a terminal state (succeeded, failed, or canceled). Supports\n   * ergonomic overloads to accept either an Operation object or just the ID.\n   *\n   * @param opOrId - Either an Operation object or operation ID string\n   * @param options - Optional polling configuration\n   * @returns The completed operation with result or error\n   * @throws {PersonalServerError} When the operation fails or times out\n   * @example\n   * ```typescript\n   * // Using operation object\n   * const operation = await vana.server.createOperation({ permissionId: 123 });\n   * const completed = await vana.server.waitForOperation(operation);\n   *\n   * // Using just the ID\n   * const completed = await vana.server.waitForOperation(\"op_abc123\");\n   *\n   * // With custom timeout\n   * const completed = await vana.server.waitForOperation(operation, {\n   *   timeout: 60000,\n   *   pollingInterval: 1000\n   * });\n   * ```\n   */\n  async waitForOperation<T = unknown>(\n    opOrId: Operation<T> | string,\n    options?: PollingOptions,\n  ): Promise<Operation<T>> {\n    const id = typeof opOrId === \"string\" ? opOrId : opOrId.id;\n    const startTime = Date.now();\n    const timeout = options?.timeout ?? 30000;\n    const interval = options?.pollingInterval ?? 500;\n\n    while (true) {\n      const operation = await this.getOperation<T>(id);\n\n      if (operation.status === \"succeeded\") {\n        return operation;\n      }\n\n      if (operation.status === \"failed\") {\n        throw new PersonalServerError(\n          `Operation ${operation.status}: ${operation.error ?? \"Unknown error\"}`,\n        );\n      }\n\n      if (operation.status === \"canceled\") {\n        throw new PersonalServerError(`Operation was canceled`);\n      }\n\n      if (Date.now() - startTime > timeout) {\n        throw new PersonalServerError(`Operation timed out after ${timeout}ms`);\n      }\n\n      await new Promise((resolve) => setTimeout(resolve, interval));\n    }\n  }\n\n  /**\n   * Downloads an artifact generated by a server operation.\n   *\n   * @remarks\n   * Artifacts are files generated during operations like Gemini agent analysis.\n   * The download requires authentication using the application's signature.\n   * This method returns the artifact as a Blob that can be saved or processed.\n   *\n   * **Simplified Signature Scheme:**\n   * The signature is generated over the operation ID only, allowing a single signature\n   * to be reused for listing and downloading multiple artifacts from the same operation.\n   * This simplifies client implementation while maintaining security - access to the\n   * operation ID grants access to all artifacts.\n   *\n   * @param params - The download parameters\n   * @param params.operationId - The operation ID that generated the artifact\n   * @param params.artifactPath - The path to the artifact file to download\n   * @returns A Blob containing the artifact data\n   * @throws {PersonalServerError} When the artifact cannot be downloaded or doesn't exist\n   * @throws {NetworkError} When unable to reach the personal server API\n   * @throws {SignatureError} When unable to create the required signature\n   * @example\n   * ```typescript\n   * // Download an artifact after a Gemini operation\n   * const blob = await vana.server.downloadArtifact({\n   *   operationId: 'op_123',\n   *   artifactPath: 'analysis_report.pdf'\n   * });\n   *\n   * // Save to file in Node.js\n   * const buffer = await blob.arrayBuffer();\n   * fs.writeFileSync('report.pdf', Buffer.from(buffer));\n   *\n   * // Or create download link in browser\n   * const url = URL.createObjectURL(blob);\n   * const a = document.createElement('a');\n   * a.href = url;\n   * a.download = 'report.pdf';\n   * a.click();\n   * ```\n   */\n  async downloadArtifact(params: DownloadArtifactParams): Promise<Blob> {\n    this.assertWallet();\n\n    try {\n      // Simplified signature scheme: sign only operation_id\n      // This allows the same signature to be reused for all artifacts\n      const signatureData = {\n        operation_id: params.operationId,\n      };\n\n      const requestJson = JSON.stringify(signatureData);\n      const signature = await this.createSignature(requestJson);\n\n      // Request body still includes artifact_path for the API\n      const requestBody = {\n        operation_id: params.operationId,\n        artifact_path: params.artifactPath,\n        signature,\n      };\n\n      const response = await fetch(\n        `${this.personalServerBaseUrl}/artifacts/download`,\n        {\n          method: \"POST\",\n          headers: {\n            \"Content-Type\": \"application/json\",\n          },\n          body: JSON.stringify(requestBody),\n        },\n      );\n\n      if (!response.ok) {\n        const errorText = await response.text();\n        throw new PersonalServerError(\n          `Artifact download failed: ${response.status} ${response.statusText} - ${errorText}`,\n        );\n      }\n\n      return await response.blob();\n    } catch (error) {\n      if (\n        error instanceof NetworkError ||\n        error instanceof PersonalServerError ||\n        error instanceof SignatureError\n      ) {\n        throw error;\n      }\n      throw new PersonalServerError(\n        `Failed to download artifact: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Lists all artifacts generated by a server operation.\n   *\n   * @remarks\n   * Retrieves metadata for all artifact files produced by an operation,\n   * including file paths, sizes, and content types. This provides visibility\n   * into available outputs without downloading them.\n   *\n   * **Simplified Signature Scheme:**\n   * Uses the same signature as downloadArtifact - signs only operation_id.\n   * This allows reusing the same signature for listing and downloading.\n   *\n   * @param operationId - The operation ID that generated the artifacts\n   * @returns Promise resolving to array of artifact metadata objects\n   * @throws {PersonalServerError} When artifacts cannot be listed\n   * @throws {NetworkError} When unable to reach the personal server API\n   * @throws {SignatureError} When unable to create the required signature\n   * @example\n   * ```typescript\n   * // List artifacts from a Gemini operation\n   * const artifacts = await vana.server.listArtifacts('op_123');\n   *\n   * console.log(`Found ${artifacts.length} artifacts:`);\n   * artifacts.forEach(artifact => {\n   *   console.log(`- ${artifact.path} (${artifact.size} bytes)`);\n   * });\n   *\n   * // Download a specific artifact\n   * const blob = await vana.server.downloadArtifact({\n   *   operationId: 'op_123',\n   *   artifactPath: artifacts[0].path\n   * });\n   * ```\n   */\n  async listArtifacts(operationId: string): Promise<\n    Array<{\n      path: string;\n      size: number;\n      content_type: string;\n    }>\n  > {\n    this.assertWallet();\n\n    try {\n      // Use simplified signature scheme: sign only operation_id\n      const signatureData = {\n        operation_id: operationId,\n      };\n\n      const requestJson = JSON.stringify(signatureData);\n      const signature = await this.createSignature(requestJson);\n\n      const requestBody = {\n        operation_id: operationId,\n        signature,\n      };\n\n      const response = await fetch(\n        `${this.personalServerBaseUrl}/artifacts/${operationId}/list`,\n        {\n          method: \"POST\",\n          headers: {\n            \"Content-Type\": \"application/json\",\n          },\n          body: JSON.stringify(requestBody),\n        },\n      );\n\n      if (!response.ok) {\n        const errorText = await response.text();\n        throw new PersonalServerError(\n          `Failed to list artifacts: ${response.status} ${response.statusText} - ${errorText}`,\n        );\n      }\n\n      const data = await response.json();\n      return data.artifacts ?? [];\n    } catch (error) {\n      if (\n        error instanceof NetworkError ||\n        error instanceof PersonalServerError ||\n        error instanceof SignatureError\n      ) {\n        throw error;\n      }\n      throw new PersonalServerError(\n        `Failed to list artifacts: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Cancels a running operation on the personal server.\n   *\n   * @remarks\n   * This method attempts to cancel an operation that is currently processing\n   * on the personal server. The operation must be in a cancellable state\n   * (typically `starting` or `processing`). Not all operations support\n   * cancellation, and cancellation may not be immediate. The server will\n   * attempt to stop the operation and update its status to `canceled`.\n   *\n   * **Cancellation Behavior:**\n   * - Operations in `succeeded` or `failed` states cannot be canceled\n   * - Some long-running operations may take time to respond to cancellation\n   * - Always verify cancellation by polling the operation status afterward\n   *\n   * @param operationId - The unique identifier of the operation to cancel,\n   *   obtained from `createOperation()` response\n   * @returns Promise that resolves when the cancellation request is accepted\n   * @throws {PersonalServerError} When the operation cannot be canceled or doesn't exist.\n   *   Check operation status - it may already be completed or failed.\n   * @throws {NetworkError} When unable to reach the personal server API.\n   *   Verify server URL and network connectivity.\n   * @example\n   * ```typescript\n   * // Start a long-running operation\n   * const operation = await vana.server.createOperation({\n   *   permissionId: 123\n   * });\n   *\n   * // Cancel if needed\n   * try {\n   *   await vana.server.cancelOperation(operation.id);\n   *   console.log(\"Cancellation requested\");\n   *\n   *   // Verify cancellation\n   *   const status = await vana.server.getOperation(operation.id);\n   *   if (status.status === \"canceled\") {\n   *     console.log(\"Operation successfully canceled\");\n   *   }\n   * } catch (error) {\n   *   console.error(\"Failed to cancel:\", error);\n   * }\n   * ```\n   */\n  async cancelOperation(operationId: string): Promise<void> {\n    try {\n      const response = await fetch(\n        `${this.personalServerBaseUrl}/operations/${operationId}/cancel`,\n        {\n          method: \"POST\",\n        },\n      );\n\n      if (!response.ok) {\n        const errorText = await response.text();\n        throw new PersonalServerError(\n          `Failed to cancel operation: ${response.status} ${response.statusText} - ${errorText}`,\n        );\n      }\n    } catch (error) {\n      if (error instanceof NetworkError) {\n        throw error;\n      }\n      throw new NetworkError(\n        `Failed to cancel operation: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Makes the request to the personal server API.\n   *\n   * @param requestBody - The post request parameters to serialize\n   * @returns JSON string representation of the request data\n   */\n  private async makeRequest(\n    requestBody: Record<string, unknown>,\n  ): Promise<CreateOperationResponse> {\n    try {\n      console.debug(\"Personal Server Request:\", {\n        url: `${this.personalServerBaseUrl}/operations`,\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n        },\n        body: requestBody,\n      });\n\n      const response = await fetch(`${this.personalServerBaseUrl}/operations`, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify(requestBody),\n      });\n\n      if (!response.ok) {\n        const errorText = await response.text();\n        console.debug(\"Personal Server Error Response:\", {\n          status: response.status,\n          statusText: response.statusText,\n          error: errorText,\n        });\n        throw new NetworkError(\n          `Personal server API request failed: ${response.status} ${response.statusText} - ${errorText}`,\n        );\n      }\n\n      const data = (await response.json()) as CreateOperationResponse;\n\n      console.debug(\"Personal Server Success Response:\", data);\n\n      return data;\n    } catch (error) {\n      if (error instanceof NetworkError) {\n        throw error;\n      }\n      throw new NetworkError(\n        `Failed to make personal server API request: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Creates a signature for the request JSON.\n   *\n   * @param requestJson - The JSON string to sign\n   * @returns Promise resolving to the cryptographic signature\n   */\n  private async createSignature(requestJson: string): Promise<string> {\n    try {\n      console.debug(\"🔍 Debug - createSignature\", requestJson);\n\n      // Use applicationClient if available, fallback to walletClient\n      const client =\n        this.context.applicationClient ?? this.context.walletClient;\n\n      if (!client) {\n        throw new SignatureError(\"No client available for signing\");\n      }\n\n      // Get the account from the wallet client\n      const { account } = client;\n      if (!account) {\n        throw new SignatureError(\"No account available for signing\");\n      }\n\n      // Only allow local accounts for signing\n      if (account.type !== \"local\") {\n        throw new SignatureError(\n          \"Only local accounts are supported for signing\",\n        );\n      }\n\n      console.debug(\"🔍 Debug - createSignature account\", account);\n      // Sign locally using the account's signMessage method\n      const signature = await account.signMessage({\n        message: requestJson,\n      });\n\n      return signature;\n    } catch (error) {\n      if (error instanceof Error && error.message.includes(\"User rejected\")) {\n        throw new SignatureError(\"User rejected the signature request\");\n      }\n      throw new SignatureError(\n        `Failed to create signature: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opendatalabs/vana-sdk",
-  "version": "0.1.0-alpha.5983460",
+  "version": "0.1.0-alpha.5a59295",
   "description": "A TypeScript library for interacting with Vana Network smart contracts.",
   "publishConfig": {
     "access": "public"