@athenaintel/sdk 4.3.2145 → 4.3.2146

package/dist/esm/api/resources/users/client/requests/DeleteSshKeyUsersRequest.d.mts

@@ -0,0 +1,9 @@
+/**
+ * @example
+ *     {
+ *         key_id: "key_id"
+ *     }
+ */
+export interface DeleteSshKeyUsersRequest {
+    key_id: string;
+}

package/dist/esm/api/resources/users/client/requests/DeleteSshKeyUsersRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/users/client/requests/index.d.mts

@@ -0,0 +1,2 @@
+export type { AddSshKeyRequestIn } from "./AddSshKeyRequestIn.mjs";
+export type { DeleteSshKeyUsersRequest } from "./DeleteSshKeyUsersRequest.mjs";

package/dist/esm/api/resources/users/client/requests/index.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/api/types/ComputerLifecycleResponseOut.d.mts

@@ -0,0 +1,11 @@
+/**
+ * Result of starting or stopping a computer asset's runtime.
+ */
+export interface ComputerLifecycleResponseOut {
+    /** The computer asset id. */
+    asset_id: string;
+    /** The computer's runtime provider (e.g. `talos_v2`). */
+    provider?: string | null;
+    /** Runtime state after the operation: `started`, `stopped`, a transitional state such as `restoring`, or `pending` when the transition was durably queued. */
+    state: string;
+}

package/dist/esm/api/types/ComputerLifecycleResponseOut.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/DeleteSshKeyResponseOut.d.mts

@@ -0,0 +1,7 @@
+/**
+ * Result of deleting one of the caller's SSH keys.
+ */
+export interface DeleteSshKeyResponseOut {
+    /** Whether the key was deleted. */
+    deleted: boolean;
+}

package/dist/esm/api/types/DeleteSshKeyResponseOut.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/SshAccessInfoOut.d.mts

@@ -0,0 +1,13 @@
+/**
+ * Where a registered SSH key connects for this computer (identity mode).
+ */
+export interface SshAccessInfoOut {
+    /** Ready-to-run `ssh [-p <port>] <asset_id>@<host>`. */
+    command: string;
+    /** SSH gateway hostname for this environment. */
+    host: string;
+    /** SSH gateway port. */
+    port: number;
+    /** The SSH username — the computer's asset id, which selects identity (registered-key) authentication at the gateway. */
+    username: string;
+}

package/dist/esm/api/types/SshAccessInfoOut.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/SshKeyListResponseOut.d.mts

@@ -0,0 +1,8 @@
+import type * as AthenaIntelligence from "../index.mjs";
+/**
+ * The caller's registered SSH public keys.
+ */
+export interface SshKeyListResponseOut {
+    /** Oldest first. */
+    keys: AthenaIntelligence.SshKeyOut[];
+}

package/dist/esm/api/types/SshKeyListResponseOut.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/SshKeyOut.d.mts

@@ -0,0 +1,19 @@
+/**
+ * One registered SSH public key.
+ */
+export interface SshKeyOut {
+    /** When the key was registered. */
+    created_at: string;
+    /** ``SHA256:…`` fingerprint, as printed by ``ssh-keygen -lf``. */
+    fingerprint: string;
+    /** Key id (``ussk_…``); use it to delete the key. */
+    id: string;
+    /** Key algorithm, e.g. ``ssh-ed25519``. */
+    key_type: string;
+    /** Display label (defaults to the key comment). */
+    label: string;
+    /** When the key last authorized an SSH connection, if ever. */
+    last_used_at?: string | null;
+    /** The key in ``<type> <base64>`` form (no comment). */
+    public_key: string;
+}

package/dist/esm/api/types/SshKeyOut.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/index.d.mts

@@ -29,6 +29,7 @@ export * from "./ChunkContentItem.mjs";
 export * from "./ChunkResult.mjs";
 export * from "./CollabAgentSendMessageResponseOut.mjs";
 export * from "./CollabTokenResponse.mjs";
+export * from "./ComputerLifecycleResponseOut.mjs";
 export * from "./ConversationAssetInfo.mjs";
 export * from "./ConversationMessage.mjs";
 export * from "./ConversationResult.mjs";
@@ -50,6 +51,7 @@ export * from "./DataFrameRequestOut.mjs";
 export * from "./DataFrameUnknownFormatError.mjs";
 export * from "./DefaultVisibility.mjs";
 export * from "./DeleteDataRequest.mjs";
+export * from "./DeleteSshKeyResponseOut.mjs";
 export * from "./DeployComputerResponseOut.mjs";
 export * from "./DimensionProperties.mjs";
 export * from "./DriveAgentResponse.mjs";
@@ -97,7 +99,10 @@ export * from "./ShareRecipientResultOut.mjs";
 export * from "./Sheet.mjs";
 export * from "./SheetOperationResponse.mjs";
 export * from "./SqlAgentResponse.mjs";
+export * from "./SshAccessInfoOut.mjs";
 export * from "./SshAccessResponseOut.mjs";
+export * from "./SshKeyListResponseOut.mjs";
+export * from "./SshKeyOut.mjs";
 export * from "./StructuredDataExtractorResponse.mjs";
 export * from "./TableRowData.mjs";
 export * from "./TextContent.mjs";

package/dist/esm/api/types/index.mjs

@@ -29,6 +29,7 @@ export * from "./ChunkContentItem.mjs";
 export * from "./ChunkResult.mjs";
 export * from "./CollabAgentSendMessageResponseOut.mjs";
 export * from "./CollabTokenResponse.mjs";
+export * from "./ComputerLifecycleResponseOut.mjs";
 export * from "./ConversationAssetInfo.mjs";
 export * from "./ConversationMessage.mjs";
 export * from "./ConversationResult.mjs";
@@ -50,6 +51,7 @@ export * from "./DataFrameRequestOut.mjs";
 export * from "./DataFrameUnknownFormatError.mjs";
 export * from "./DefaultVisibility.mjs";
 export * from "./DeleteDataRequest.mjs";
+export * from "./DeleteSshKeyResponseOut.mjs";
 export * from "./DeployComputerResponseOut.mjs";
 export * from "./DimensionProperties.mjs";
 export * from "./DriveAgentResponse.mjs";
@@ -97,7 +99,10 @@ export * from "./ShareRecipientResultOut.mjs";
 export * from "./Sheet.mjs";
 export * from "./SheetOperationResponse.mjs";
 export * from "./SqlAgentResponse.mjs";
+export * from "./SshAccessInfoOut.mjs";
 export * from "./SshAccessResponseOut.mjs";
+export * from "./SshKeyListResponseOut.mjs";
+export * from "./SshKeyOut.mjs";
 export * from "./StructuredDataExtractorResponse.mjs";
 export * from "./TableRowData.mjs";
 export * from "./TextContent.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "4.3.2145";
+export declare const SDK_VERSION = "4.3.2146";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "4.3.2145";
+export const SDK_VERSION = "4.3.2146";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@athenaintel/sdk",
-    "version": "4.3.2145",
+    "version": "4.3.2146",
     "private": false,
     "repository": "github:Athena-Intel/athena-typescript",
     "type": "commonjs",

package/reference.md

@@ -1634,6 +1634,71 @@ await client.computer.deployComputer({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.computer.<a href="/src/api/resources/computer/client/Client.ts">getSshAccess</a>({ ...params }) -> AthenaIntelligence.SshAccessInfoOut</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Return the SSH gateway host, port, username, and ready-made command for connecting to a computer with a registered SSH public key (see `add_ssh_key`). The username is the computer's asset id; the gateway authorizes the connection against your current edit permission on the computer and starts it if it is stopped. Unlike `create_ssh_access`, this mints nothing and never wakes the computer. Returns 409 when the computer's provider does not support SSH.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.computer.getSshAccess({
+    asset_id: "asset_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AthenaIntelligence.GetSshAccessComputerRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ComputerClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -1766,6 +1831,136 @@ await client.computer.revokeSshAccess({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.computer.<a href="/src/api/resources/computer/client/Client.ts">startComputer</a>({ ...params }) -> AthenaIntelligence.ComputerLifecycleResponseOut</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Start a stopped computer's runtime and wait for it to come up — the same operation as the Start button in Athena. Idempotent for a running computer. Returns 409 when the computer's provider does not support lifecycle operations.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.computer.startComputer({
+    asset_id: "asset_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AthenaIntelligence.StartComputerComputerRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ComputerClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.computer.<a href="/src/api/resources/computer/client/Client.ts">stopComputer</a>({ ...params }) -> AthenaIntelligence.ComputerLifecycleResponseOut</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Stop (suspend) a running computer's runtime — the same operation as the Stop button in Athena. The computer's files persist and it can be started again with `start_computer`. Returns 409 when the provider does not support lifecycle operations or when the stop was refused because the workspace could not be saved (the computer is left running; retry).
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.computer.stopComputer({
+    asset_id: "asset_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AthenaIntelligence.StopComputerComputerRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ComputerClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -2464,6 +2659,192 @@ await client.users.meSources();
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.users.<a href="/src/api/resources/users/client/Client.ts">listSshKeys</a>() -> AthenaIntelligence.SshKeyListResponseOut</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+List the SSH public keys registered on the caller's Athena account. A registered key authenticates `ssh <computer_asset_id>@<gateway>` to every computer the caller can edit; keys are not tied to a workspace.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.users.listSshKeys();
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**requestOptions:** `UsersClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.users.<a href="/src/api/resources/users/client/Client.ts">addSshKey</a>({ ...params }) -> AthenaIntelligence.SshKeyOut</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Register an SSH public key (the contents of an OpenSSH `.pub` file) on the caller's account. Returns 400 for a malformed or unsupported key, 409 when the key is already registered or the caller has reached the per-account limit.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.users.addSshKey({
+    label: "laptop",
+    public_key: "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIBZzuCu6wC9oVY2lVbVKdwpMElfCYiWTOIVQQBtq7HW9 me@laptop"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AthenaIntelligence.AddSshKeyRequestIn` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `UsersClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.users.<a href="/src/api/resources/users/client/Client.ts">deleteSshKey</a>({ ...params }) -> AthenaIntelligence.DeleteSshKeyResponseOut</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Delete an SSH public key from the caller's account. SSH sessions authenticated with the key are closed by the gateway within a minute. Returns 404 for a key the caller does not own.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.users.deleteSshKey({
+    key_id: "key_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AthenaIntelligence.DeleteSshKeyUsersRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `UsersClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>