@alva-ai/toolkit 0.3.1 → 0.4.1

package/dist/index.cjs

@@ -270,7 +270,8 @@ var ReleaseResource = class {
         version: params.version,
         cronjob_id: params.cronjob_id,
         view_json: params.view_json,
-        description: params.description
+        description: params.description,
+        changelog: params.changelog
       }
     });
   }
@@ -282,8 +283,7 @@ var ReleaseResource = class {
         display_name: params.display_name,
         description: params.description,
         feeds: params.feeds,
-        trading_symbols: params.trading_symbols,
-        changelog: params.changelog
+        trading_symbols: params.trading_symbols
       }
     });
   }
@@ -595,6 +595,127 @@ var ArraysJwtResource = class {
   }
 };
 
+// src/resources/notifications.ts
+var NotificationsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * List the caller's notification history for one playbook
+   * `(username, name)`. Returns `NOT_FOUND` when the playbook is
+   * private or does not exist (the two cases are deliberately
+   * indistinguishable to prevent namespace enumeration).
+   */
+  async listPlaybook(params) {
+    this.client._requireAuth();
+    const path = `/api/v1/playbook/${encodeURIComponent(params.username)}/${encodeURIComponent(params.name)}/notifications`;
+    return this.client._request("GET", path, {
+      query: buildQuery(params)
+    });
+  }
+  /**
+   * List the caller's notification history for one feed
+   * `(username, name)`. Authorization is alfs read on
+   * `/alva/home/<username>/feeds/<name>`.
+   */
+  async listFeed(params) {
+    this.client._requireAuth();
+    const path = `/api/v1/feed/${encodeURIComponent(params.username)}/${encodeURIComponent(params.name)}/notifications`;
+    return this.client._request("GET", path, {
+      query: buildQuery(params)
+    });
+  }
+};
+function buildQuery(params) {
+  const q = {};
+  if (params.channel) q.channel = params.channel;
+  if (params.status) q.status = params.status;
+  if (params.since_time !== void 0 && params.since_time > 0) {
+    q.since_time = String(params.since_time);
+  }
+  if (params.first !== void 0 && params.first > 0) {
+    q.first = String(params.first);
+  }
+  if (params.cursor) q.cursor = params.cursor;
+  return q;
+}
+
+// src/resources/pushSubscriptions.ts
+var PushSubscriptionsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Opt into personal push for one playbook `(username, name)`.
+   * Fires for any feed of that playbook. Idempotent. Auth: callers must
+   * be able to read the playbook (public/paid pass; private requires
+   * explicit alfs grant).
+   */
+  async subscribePlaybook(params) {
+    this.client._requireAuth();
+    const path = `/api/v1/playbook/${encodeURIComponent(params.username)}/${encodeURIComponent(params.name)}/push-subscription`;
+    return this.client._request(
+      "POST",
+      path
+    );
+  }
+  /**
+   * Soft-disable personal push for one playbook `(username, name)`.
+   * Does NOT remove any social follow. Idempotent.
+   */
+  async unsubscribePlaybook(params) {
+    this.client._requireAuth();
+    const path = `/api/v1/playbook/${encodeURIComponent(params.username)}/${encodeURIComponent(params.name)}/push-subscription`;
+    return this.client._request(
+      "DELETE",
+      path
+    );
+  }
+  /**
+   * Opt into personal push for one feed `(username, name)`. Fires for
+   * that specific feed regardless of which playbook(s) consume it; if
+   * the feed is shared across playbooks the subscriber receives one
+   * push per playbook context. Idempotent.
+   */
+  async subscribeFeed(params) {
+    this.client._requireAuth();
+    const path = `/api/v1/feed/${encodeURIComponent(params.username)}/${encodeURIComponent(params.name)}/push-subscription`;
+    return this.client._request(
+      "POST",
+      path
+    );
+  }
+  /**
+   * Soft-disable personal push for one feed `(username, name)`.
+   * Idempotent.
+   */
+  async unsubscribeFeed(params) {
+    this.client._requireAuth();
+    const path = `/api/v1/feed/${encodeURIComponent(params.username)}/${encodeURIComponent(params.name)}/push-subscription`;
+    return this.client._request(
+      "DELETE",
+      path
+    );
+  }
+  /**
+   * List the caller's personal push subscriptions across all targets
+   * (playbook + feed). Defaults to currently-active rows only; pass
+   * `include_history=true` to also return previously-unsubscribed rows.
+   */
+  async list(params = {}) {
+    this.client._requireAuth();
+    const query = {};
+    if (params.include_history !== void 0) {
+      query.include_history = String(params.include_history);
+    }
+    return this.client._request("GET", "/api/v1/me/push-subscriptions", {
+      query
+    });
+  }
+};
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api-llm.prd.alva.ai";
 var DEFAULT_ARRAYS_BASE_URL = "https://data-tools.prd.space.id";
@@ -616,6 +737,8 @@ var AlvaClient = class {
   _user;
   _trading;
   _arraysJwt;
+  _notifications;
+  _pushSubscriptions;
   constructor(config) {
     this.baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
     this.arraysBaseUrl = config.arraysBaseUrl ?? DEFAULT_ARRAYS_BASE_URL;
@@ -661,6 +784,12 @@ var AlvaClient = class {
   get arraysJwt() {
     return this._arraysJwt ??= new ArraysJwtResource(this);
   }
+  get notifications() {
+    return this._notifications ??= new NotificationsResource(this);
+  }
+  get pushSubscriptions() {
+    return this._pushSubscriptions ??= new PushSubscriptionsResource(this);
+  }
   _requireAuth() {
     if (!this.viewer_token && !this.apiKey) {
       throw new AlvaError(
@@ -750,7 +879,7 @@ var AlvaClient = class {
 };
 
 // src/index.ts
-var VERSION = true ? "0.3.1" : "dev";
+var VERSION = true ? "0.4.1" : "dev";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AlvaClient,

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/error.ts","../src/resources/fs.ts","../src/resources/run.ts","../src/resources/deploy.ts","../src/resources/release.ts","../src/resources/secrets.ts","../src/resources/sdkDocs.ts","../src/resources/skills.ts","../src/resources/comments.ts","../src/resources/remix.ts","../src/resources/screenshot.ts","../src/resources/user.ts","../src/resources/trading.ts","../src/resources/arraysJwt.ts","../src/client.ts"],"sourcesContent":["declare const __VERSION__: string;\n\n/** SDK version, injected at build time from package.json. */\nexport const VERSION: string =\n  typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'dev';\n\nexport { AlvaClient } from './client.js';\nexport { AlvaError } from './error.js';\nexport type {\n  AlvaClientConfig,\n  FsReadParams,\n  FsWriteParams,\n  FsRawWriteParams,\n  FsWriteResponse,\n  FsStat,\n  FsReaddirParams,\n  FsEntry,\n  FsReaddirResponse,\n  FsMkdirParams,\n  FsRemoveParams,\n  FsRenameParams,\n  FsCopyParams,\n  FsSymlinkParams,\n  FsReadlinkParams,\n  FsChmodParams,\n  FsGrantParams,\n  FsRevokeParams,\n} from './types.js';\n","export class AlvaError extends Error {\n  readonly code: string;\n  readonly status: number;\n\n  constructor(code: string, message: string, status: number) {\n    super(message);\n    this.name = 'AlvaError';\n    this.code = code;\n    this.status = status;\n  }\n}\n\nexport class CliUsageError extends Error {\n  readonly command?: string;\n\n  constructor(message: string, command?: string) {\n    super(message);\n    this.name = 'CliUsageError';\n    this.command = command;\n  }\n}\n","import type { AlvaClient } from '../client.js';\nimport type {\n  FsReadParams,\n  FsWriteParams,\n  FsRawWriteParams,\n  FsWriteResponse,\n  FsStat,\n  FsReaddirParams,\n  FsReaddirResponse,\n  FsMkdirParams,\n  FsRemoveParams,\n  FsRenameParams,\n  FsCopyParams,\n  FsSymlinkParams,\n  FsReadlinkParams,\n  FsChmodParams,\n  FsGrantParams,\n  FsRevokeParams,\n} from '../types.js';\n\nexport class FsResource {\n  constructor(private client: AlvaClient) {}\n\n  /** Returns `ArrayBuffer` for binary files, or parsed JSON for time-series virtual paths. */\n  async read(params: FsReadParams): Promise<ArrayBuffer | unknown> {\n    const result = await this.client._request('GET', '/api/v1/fs/read', {\n      query: { path: params.path, offset: params.offset, size: params.size },\n    });\n    if (!(result instanceof ArrayBuffer)) return result;\n    try {\n      const text = new TextDecoder('utf-8', { fatal: true }).decode(result);\n      try {\n        return JSON.parse(text);\n      } catch {\n        return text;\n      }\n    } catch {\n      return result;\n    }\n  }\n\n  /** Write file using JSON body (Mode 2). For text content. */\n  async write(params: FsWriteParams): Promise<FsWriteResponse> {\n    this.client._requireAuth();\n    return this.client._request('POST', '/api/v1/fs/write', {\n      body: {\n        path: params.path,\n        data: params.data,\n        mkdir_parents: params.mkdir_parents,\n      },\n    }) as Promise<FsWriteResponse>;\n  }\n\n  /** Write file using raw body (Mode 1). Supports binary data. Path and options are query params. */\n  async rawWrite(params: FsRawWriteParams): Promise<FsWriteResponse> {\n    this.client._requireAuth();\n    return this.client._request('POST', '/api/v1/fs/write', {\n      query: {\n        path: params.path,\n        mkdir_parents: params.mkdir_parents,\n      },\n      rawBody: params.body,\n    }) as Promise<FsWriteResponse>;\n  }\n\n  async stat(params: { path: string }): Promise<FsStat> {\n    this.client._requireAuth();\n    return this.client._request('GET', '/api/v1/fs/stat', {\n      query: { path: params.path },\n    }) as Promise<FsStat>;\n  }\n\n  async readdir(params: FsReaddirParams): Promise<FsReaddirResponse> {\n    this.client._requireAuth();\n    return this.client._request('GET', '/api/v1/fs/readdir', {\n      query: { path: params.path, recursive: params.recursive },\n    }) as Promise<FsReaddirResponse>;\n  }\n\n  async mkdir(params: FsMkdirParams): Promise<void> {\n    this.client._requireAuth();\n    await this.client._request('POST', '/api/v1/fs/mkdir', {\n      body: { path: params.path },\n    });\n  }\n\n  async remove(params: FsRemoveParams): Promise<void> {\n    this.client._requireAuth();\n    await this.client._request('DELETE', '/api/v1/fs/remove', {\n      query: { path: params.path, recursive: params.recursive },\n    });\n  }\n\n  async rename(params: FsRenameParams): Promise<void> {\n    this.client._requireAuth();\n    await this.client._request('POST', '/api/v1/fs/rename', {\n      body: { old_path: params.old_path, new_path: params.new_path },\n    });\n  }\n\n  async copy(params: FsCopyParams): Promise<void> {\n    this.client._requireAuth();\n    await this.client._request('POST', '/api/v1/fs/copy', {\n      body: { src_path: params.src_path, dst_path: params.dst_path },\n    });\n  }\n\n  async symlink(params: FsSymlinkParams): Promise<void> {\n    this.client._requireAuth();\n    await this.client._request('POST', '/api/v1/fs/symlink', {\n      body: {\n        target_path: params.target_path,\n        link_path: params.link_path,\n      },\n    });\n  }\n\n  async readlink(params: FsReadlinkParams): Promise<{ target: string }> {\n    this.client._requireAuth();\n    return this.client._request('GET', '/api/v1/fs/readlink', {\n      query: { path: params.path },\n    }) as Promise<{ target: string }>;\n  }\n\n  async chmod(params: FsChmodParams): Promise<void> {\n    this.client._requireAuth();\n    await this.client._request('POST', '/api/v1/fs/chmod', {\n      body: { path: params.path, mode: params.mode },\n    });\n  }\n\n  async grant(params: FsGrantParams): Promise<void> {\n    this.client._requireAuth();\n    await this.client._request('POST', '/api/v1/fs/grant', {\n      body: {\n        path: params.path,\n        subject: params.subject,\n        permission: params.permission,\n      },\n    });\n  }\n\n  async revoke(params: FsRevokeParams): Promise<void> {\n    this.client._requireAuth();\n    await this.client._request('POST', '/api/v1/fs/revoke', {\n      body: {\n        path: params.path,\n        subject: params.subject,\n        permission: params.permission,\n      },\n    });\n  }\n}\n","import type { AlvaClient } from '../client.js';\nimport type { RunRequest, RunResponse } from '../types.js';\n\nexport class RunResource {\n  constructor(private client: AlvaClient) {}\n\n  async execute(params: RunRequest): Promise<RunResponse> {\n    this.client._requireAuth();\n    return this.client._request('POST', '/api/v1/run', {\n      body: {\n        code: params.code,\n        entry_path: params.entry_path,\n        working_dir: params.working_dir,\n        args: params.args,\n      },\n    }) as Promise<RunResponse>;\n  }\n}\n","import type { AlvaClient } from '../client.js';\nimport type {\n  CronjobCreateRequest,\n  Cronjob,\n  CronjobListParams,\n  CronjobListResponse,\n  CronjobUpdateRequest,\n  CronjobRunsListParams,\n  CronjobRunsListResponse,\n  CronjobRunLogsResponse,\n} from '../types.js';\n\nexport class DeployResource {\n  constructor(private client: AlvaClient) {}\n\n  async create(params: CronjobCreateRequest): Promise<Cronjob> {\n    this.client._requireAuth();\n    return this.client._request('POST', '/api/v1/deploy/cronjob', {\n      body: {\n        name: params.name,\n        path: params.path,\n        cron_expression: params.cron_expression,\n        args: params.args,\n        push_notify: params.push_notify,\n      },\n    }) as Promise<Cronjob>;\n  }\n\n  async list(params?: CronjobListParams): Promise<CronjobListResponse> {\n    this.client._requireAuth();\n    return this.client._request('GET', '/api/v1/deploy/cronjobs', {\n      query: { limit: params?.limit, cursor: params?.cursor },\n    }) as Promise<CronjobListResponse>;\n  }\n\n  async get(params: { id: number }): Promise<Cronjob> {\n    this.client._requireAuth();\n    return this.client._request(\n      'GET',\n      `/api/v1/deploy/cronjob/${params.id}`\n    ) as Promise<Cronjob>;\n  }\n\n  async update(params: CronjobUpdateRequest): Promise<Cronjob> {\n    this.client._requireAuth();\n    const { id, ...body } = params;\n    return this.client._request('PATCH', `/api/v1/deploy/cronjob/${id}`, {\n      body,\n    }) as Promise<Cronjob>;\n  }\n\n  async delete(params: { id: number }): Promise<void> {\n    this.client._requireAuth();\n    await this.client._request('DELETE', `/api/v1/deploy/cronjob/${params.id}`);\n  }\n\n  async pause(params: { id: number }): Promise<void> {\n    this.client._requireAuth();\n    await this.client._request(\n      'POST',\n      `/api/v1/deploy/cronjob/${params.id}/pause`\n    );\n  }\n\n  async resume(params: { id: number }): Promise<void> {\n    this.client._requireAuth();\n    await this.client._request(\n      'POST',\n      `/api/v1/deploy/cronjob/${params.id}/resume`\n    );\n  }\n\n  async listRuns(\n    params: CronjobRunsListParams\n  ): Promise<CronjobRunsListResponse> {\n    this.client._requireAuth();\n    return this.client._request(\n      'GET',\n      `/api/v1/deploy/cronjob/${params.cronjob_id}/runs`,\n      {\n        query: { first: params.first, cursor: params.cursor },\n      }\n    ) as Promise<CronjobRunsListResponse>;\n  }\n\n  async getRunLogs(params: {\n    cronjob_id: number;\n    run_id: number;\n  }): Promise<CronjobRunLogsResponse> {\n    this.client._requireAuth();\n    return this.client._request(\n      'GET',\n      `/api/v1/deploy/cronjob/${params.cronjob_id}/runs/${params.run_id}/logs`\n    ) as Promise<CronjobRunLogsResponse>;\n  }\n}\n","import type { AlvaClient } from '../client.js';\nimport type {\n  FeedReleaseRequest,\n  FeedReleaseResponse,\n  PlaybookDraftRequest,\n  PlaybookDraftResponse,\n  PlaybookReleaseRequest,\n  PlaybookReleaseResponse,\n} from '../types.js';\n\nexport class ReleaseResource {\n  constructor(private client: AlvaClient) {}\n\n  async feed(params: FeedReleaseRequest): Promise<FeedReleaseResponse> {\n    this.client._requireAuth();\n    return this.client._request('POST', '/api/v1/release/feed', {\n      body: {\n        name: params.name,\n        version: params.version,\n        cronjob_id: params.cronjob_id,\n        view_json: params.view_json,\n        description: params.description,\n      },\n    }) as Promise<FeedReleaseResponse>;\n  }\n\n  async playbookDraft(\n    params: PlaybookDraftRequest\n  ): Promise<PlaybookDraftResponse> {\n    this.client._requireAuth();\n    return this.client._request('POST', '/api/v1/draft/playbook', {\n      body: {\n        name: params.name,\n        display_name: params.display_name,\n        description: params.description,\n        feeds: params.feeds,\n        trading_symbols: params.trading_symbols,\n        changelog: params.changelog,\n      },\n    }) as Promise<PlaybookDraftResponse>;\n  }\n\n  async playbook(\n    params: PlaybookReleaseRequest\n  ): Promise<PlaybookReleaseResponse> {\n    this.client._requireAuth();\n    return this.client._request('POST', '/api/v1/release/playbook', {\n      body: {\n        name: params.name,\n        version: params.version,\n        feeds: params.feeds,\n        changelog: params.changelog,\n      },\n    }) as Promise<PlaybookReleaseResponse>;\n  }\n}\n","import type { AlvaClient } from '../client.js';\nimport type { CreateSecretRequest, Secret, SecretMetadata } from '../types.js';\n\nexport class SecretsResource {\n  constructor(private client: AlvaClient) {}\n\n  async create(params: CreateSecretRequest): Promise<void> {\n    this.client._requireAuth();\n    await this.client._request('POST', '/api/v1/secrets', {\n      body: { name: params.name, value: params.value },\n    });\n  }\n\n  async list(): Promise<{ secrets: SecretMetadata[] }> {\n    this.client._requireAuth();\n    return this.client._request('GET', '/api/v1/secrets') as Promise<{\n      secrets: SecretMetadata[];\n    }>;\n  }\n\n  async get(params: { name: string }): Promise<Secret> {\n    this.client._requireAuth();\n    const encoded = encodeURIComponent(params.name);\n    return this.client._request(\n      'GET',\n      `/api/v1/secrets/${encoded}`\n    ) as Promise<Secret>;\n  }\n\n  async update(params: { name: string; value: string }): Promise<void> {\n    this.client._requireAuth();\n    const encoded = encodeURIComponent(params.name);\n    await this.client._request('PUT', `/api/v1/secrets/${encoded}`, {\n      body: { value: params.value },\n    });\n  }\n\n  async delete(params: { name: string }): Promise<void> {\n    this.client._requireAuth();\n    const encoded = encodeURIComponent(params.name);\n    await this.client._request('DELETE', `/api/v1/secrets/${encoded}`);\n  }\n}\n","import type { AlvaClient } from '../client.js';\nimport type {\n  ModuleDoc,\n  PartitionsResponse,\n  PartitionSummaryResponse,\n} from '../types.js';\n\nexport class SdkDocsResource {\n  constructor(private client: AlvaClient) {}\n\n  async doc(params: { name: string }): Promise<ModuleDoc> {\n    this.client._requireAuth();\n    return this.client._request('GET', '/api/v1/sdk/doc', {\n      query: { name: params.name },\n    }) as Promise<ModuleDoc>;\n  }\n\n  async partitions(): Promise<PartitionsResponse> {\n    this.client._requireAuth();\n    return this.client._request(\n      'GET',\n      '/api/v1/sdk/partitions'\n    ) as Promise<PartitionsResponse>;\n  }\n\n  async partitionSummary(params: {\n    partition: string;\n  }): Promise<PartitionSummaryResponse> {\n    this.client._requireAuth();\n    const encoded = encodeURIComponent(params.partition);\n    return this.client._request(\n      'GET',\n      `/api/v1/sdk/partitions/${encoded}/summary`\n    ) as Promise<PartitionSummaryResponse>;\n  }\n}\n","import type { AlvaClient } from '../client.js';\n\ntype Envelope<T> = { success: boolean; data: T; request_id?: string };\n\nexport interface SkillSummary {\n  name: string;\n  description: string;\n}\n\nexport interface SkillDoc {\n  name: string;\n  description: string;\n  content: string;\n}\n\nexport class SkillsResource {\n  constructor(private client: AlvaClient) {}\n\n  async list(): Promise<{ skills: SkillSummary[] }> {\n    const res = (await this.client._request('GET', '/api/v1/skills', {\n      baseUrl: this.client.arraysBaseUrl,\n      noAuth: true,\n    })) as Envelope<SkillSummary[]>;\n    return { skills: res.data ?? [] };\n  }\n\n  async summary(params: { name: string }): Promise<SkillDoc> {\n    const encoded = encodeURIComponent(params.name);\n    const res = (await this.client._request(\n      'GET',\n      `/api/v1/skills/${encoded}`,\n      {\n        baseUrl: this.client.arraysBaseUrl,\n        noAuth: true,\n      }\n    )) as Envelope<SkillDoc[]>;\n    const doc = res.data?.[0];\n    if (!doc)\n      throw new Error(`empty skills summary response for \"${params.name}\"`);\n    return doc;\n  }\n\n  async endpoint(params: { name: string; file: string }): Promise<SkillDoc> {\n    const encoded = encodeURIComponent(params.name);\n    const res = (await this.client._request(\n      'GET',\n      `/api/v1/skills/${encoded}`,\n      {\n        baseUrl: this.client.arraysBaseUrl,\n        noAuth: true,\n        query: { endpoint: params.file },\n      }\n    )) as Envelope<SkillDoc[]>;\n    const doc = res.data?.[0];\n    if (!doc) {\n      throw new Error(\n        `empty skills endpoint response for \"${params.name}\" file \"${params.file}\"`\n      );\n    }\n    return doc;\n  }\n}\n","import type { AlvaClient } from '../client.js';\nimport type { CreateCommentRequest, Comment } from '../types.js';\n\nexport class CommentsResource {\n  constructor(private client: AlvaClient) {}\n\n  async create(params: CreateCommentRequest): Promise<Comment> {\n    this.client._requireAuth();\n    return this.client._request('POST', '/api/v1/playbook/comment', {\n      body: {\n        username: params.username,\n        name: params.name,\n        content: params.content,\n        parent_id: params.parent_id,\n      },\n    }) as Promise<Comment>;\n  }\n\n  async pin(params: { comment_id: number }): Promise<Comment> {\n    this.client._requireAuth();\n    return this.client._request('POST', '/api/v1/playbook/comment/pin', {\n      body: { comment_id: params.comment_id },\n    }) as Promise<Comment>;\n  }\n\n  async unpin(params: { comment_id: number }): Promise<Comment> {\n    this.client._requireAuth();\n    return this.client._request('POST', '/api/v1/playbook/comment/unpin', {\n      body: { comment_id: params.comment_id },\n    }) as Promise<Comment>;\n  }\n}\n","import type { AlvaClient } from '../client.js';\nimport type { RemixRequest } from '../types.js';\n\nexport class RemixResource {\n  constructor(private client: AlvaClient) {}\n\n  async save(params: RemixRequest): Promise<void> {\n    this.client._requireAuth();\n    await this.client._request('POST', '/api/v1/remix', {\n      body: {\n        child: params.child,\n        parents: params.parents,\n      },\n    });\n  }\n}\n","import type { AlvaClient } from '../client.js';\nimport type { ScreenshotParams } from '../types.js';\n\nexport class ScreenshotResource {\n  constructor(private client: AlvaClient) {}\n\n  async capture(params: ScreenshotParams): Promise<ArrayBuffer> {\n    this.client._requireAuth();\n    return this.client._request('GET', '/api/v1/screenshot', {\n      query: {\n        url: params.url,\n        selector: params.selector,\n        xpath: params.xpath,\n      },\n    }) as Promise<ArrayBuffer>;\n  }\n}\n","import type { AlvaClient } from '../client.js';\nimport type { UserProfile } from '../types.js';\n\nexport class UserResource {\n  constructor(private client: AlvaClient) {}\n\n  async me(): Promise<UserProfile> {\n    this.client._requireAuth();\n    return this.client._request('GET', '/api/v1/me') as Promise<UserProfile>;\n  }\n}\n","import type { AlvaClient } from '../client.js';\nimport type {\n  TradingAccount,\n  TradingPortfolio,\n  TradingOrder,\n  TradingSubscription,\n  EquityPoint,\n  TradingRiskRule,\n  TradingRiskRuleInput,\n  ExecuteSignalResult,\n} from '../types.js';\n\nexport class TradingResource {\n  constructor(private client: AlvaClient) {}\n\n  async accounts(): Promise<TradingAccount[]> {\n    this.client._requireAuth();\n    return this.client._request('GET', '/api/v1/trading/accounts') as Promise<\n      TradingAccount[]\n    >;\n  }\n\n  async portfolio(accountId: string): Promise<TradingPortfolio> {\n    this.client._requireAuth();\n    return this.client._request('GET', '/api/v1/trading/portfolio', {\n      query: { accountId },\n    }) as Promise<TradingPortfolio>;\n  }\n\n  async orders(params: {\n    accountId: string;\n    source?: string;\n    since?: number;\n    limit?: number;\n  }): Promise<TradingOrder[]> {\n    this.client._requireAuth();\n    return this.client._request('GET', '/api/v1/trading/orders', {\n      query: {\n        accountId: params.accountId,\n        source: params.source,\n        since: params.since,\n        limit: params.limit,\n      },\n    }) as Promise<TradingOrder[]>;\n  }\n\n  async subscriptions(accountId: string): Promise<TradingSubscription[]> {\n    this.client._requireAuth();\n    return this.client._request('GET', '/api/v1/trading/subscriptions', {\n      query: { accountId },\n    }) as Promise<TradingSubscription[]>;\n  }\n\n  async equityHistory(params: {\n    accountId: string;\n    timeframe?: string;\n    sinceMs?: number;\n    untilMs?: number;\n  }): Promise<EquityPoint[]> {\n    this.client._requireAuth();\n    return this.client._request('GET', '/api/v1/trading/equity-history', {\n      query: {\n        accountId: params.accountId,\n        timeframe: params.timeframe,\n        sinceMs: params.sinceMs,\n        untilMs: params.untilMs,\n      },\n    }) as Promise<EquityPoint[]>;\n  }\n\n  async riskRules(): Promise<TradingRiskRule> {\n    this.client._requireAuth();\n    return this.client._request(\n      'GET',\n      '/api/v1/trading/risk-rules'\n    ) as Promise<TradingRiskRule>;\n  }\n\n  async subscribe(params: {\n    accountId: string;\n    sourceUsername: string;\n    sourceFeed: string;\n    playbookId: string;\n    playbookVersion: string;\n    executeLatest?: boolean;\n  }): Promise<TradingSubscription> {\n    this.client._requireAuth();\n    return this.client._request('POST', '/api/v1/trading/subscribe', {\n      body: params,\n    }) as Promise<TradingSubscription>;\n  }\n\n  async unsubscribe(\n    subscriptionId: string\n  ): Promise<{ unsubscribedId: string }> {\n    this.client._requireAuth();\n    return this.client._request('POST', '/api/v1/trading/unsubscribe', {\n      body: { subscriptionId },\n    }) as Promise<{ unsubscribedId: string }>;\n  }\n\n  async execute(params: {\n    accountId: string;\n    signalJson: string;\n    dryRun: boolean;\n    sourceUsername?: string;\n    sourceFeed?: string;\n  }): Promise<ExecuteSignalResult> {\n    this.client._requireAuth();\n    return this.client._request('POST', '/api/v1/trading/execute', {\n      body: params,\n    }) as Promise<ExecuteSignalResult>;\n  }\n\n  async updateRiskRules(rules: TradingRiskRuleInput): Promise<TradingRiskRule> {\n    this.client._requireAuth();\n    return this.client._request('PUT', '/api/v1/trading/risk-rules', {\n      body: rules,\n    }) as Promise<TradingRiskRule>;\n  }\n}\n","import type { AlvaClient } from '../client.js';\nimport type {\n  EnsureArraysJwtResponse,\n  ArraysJwtStatusResponse,\n} from '../types.js';\n\nexport class ArraysJwtResource {\n  constructor(private client: AlvaClient) {}\n\n  /** Idempotently sign-or-renew the Arrays JWT server-side. */\n  async ensure(): Promise<EnsureArraysJwtResponse> {\n    this.client._requireAuth();\n    return this.client._request(\n      'POST',\n      '/api/v1/arrays-jwt/ensure'\n    ) as Promise<EnsureArraysJwtResponse>;\n  }\n\n  /** Report the current Arrays JWT state for the authenticated user. */\n  async status(): Promise<ArraysJwtStatusResponse> {\n    this.client._requireAuth();\n    return this.client._request(\n      'GET',\n      '/api/v1/arrays-jwt/status'\n    ) as Promise<ArraysJwtStatusResponse>;\n  }\n}\n","import { AlvaError } from './error.js';\nimport type { AlvaClientConfig } from './types.js';\nimport { FsResource } from './resources/fs.js';\nimport { RunResource } from './resources/run.js';\nimport { DeployResource } from './resources/deploy.js';\nimport { ReleaseResource } from './resources/release.js';\nimport { SecretsResource } from './resources/secrets.js';\nimport { SdkDocsResource } from './resources/sdkDocs.js';\nimport { SkillsResource } from './resources/skills.js';\nimport { CommentsResource } from './resources/comments.js';\nimport { RemixResource } from './resources/remix.js';\nimport { ScreenshotResource } from './resources/screenshot.js';\nimport { UserResource } from './resources/user.js';\nimport { TradingResource } from './resources/trading.js';\nimport { ArraysJwtResource } from './resources/arraysJwt.js';\n\nconst DEFAULT_BASE_URL = 'https://api-llm.prd.alva.ai';\nexport const DEFAULT_ARRAYS_BASE_URL = 'https://data-tools.prd.space.id';\n\ninterface RequestOptions {\n  query?: Record<string, unknown>;\n  body?: unknown;\n  /** Send raw body with application/octet-stream content type (for binary writes). */\n  rawBody?: BodyInit;\n  /** Override the base URL for this request (e.g. the Arrays data-tools endpoint). */\n  baseUrl?: string;\n  /** If true, skip attaching any Alva auth header (X-Alva-Api-Key / x-Playbook-Viewer). */\n  noAuth?: boolean;\n}\n\nexport class AlvaClient {\n  readonly baseUrl: string;\n  readonly arraysBaseUrl: string;\n  readonly viewer_token?: string;\n  readonly apiKey?: string;\n\n  private _fs?: FsResource;\n  private _run?: RunResource;\n  private _deploy?: DeployResource;\n  private _release?: ReleaseResource;\n  private _secrets?: SecretsResource;\n  private _sdk?: SdkDocsResource;\n  private _skills?: SkillsResource;\n  private _comments?: CommentsResource;\n  private _remix?: RemixResource;\n  private _screenshot?: ScreenshotResource;\n  private _user?: UserResource;\n  private _trading?: TradingResource;\n  private _arraysJwt?: ArraysJwtResource;\n\n  constructor(config: AlvaClientConfig) {\n    this.baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;\n    this.arraysBaseUrl = config.arraysBaseUrl ?? DEFAULT_ARRAYS_BASE_URL;\n    this.viewer_token = config.viewer_token;\n    this.apiKey = config.apiKey;\n  }\n\n  get fs(): FsResource {\n    return (this._fs ??= new FsResource(this));\n  }\n  get run(): RunResource {\n    return (this._run ??= new RunResource(this));\n  }\n  get deploy(): DeployResource {\n    return (this._deploy ??= new DeployResource(this));\n  }\n  get release(): ReleaseResource {\n    return (this._release ??= new ReleaseResource(this));\n  }\n  get secrets(): SecretsResource {\n    return (this._secrets ??= new SecretsResource(this));\n  }\n  get sdk(): SdkDocsResource {\n    return (this._sdk ??= new SdkDocsResource(this));\n  }\n  get skills(): SkillsResource {\n    return (this._skills ??= new SkillsResource(this));\n  }\n  get comments(): CommentsResource {\n    return (this._comments ??= new CommentsResource(this));\n  }\n  get remix(): RemixResource {\n    return (this._remix ??= new RemixResource(this));\n  }\n  get screenshot(): ScreenshotResource {\n    return (this._screenshot ??= new ScreenshotResource(this));\n  }\n  get user(): UserResource {\n    return (this._user ??= new UserResource(this));\n  }\n  get trading(): TradingResource {\n    return (this._trading ??= new TradingResource(this));\n  }\n  get arraysJwt(): ArraysJwtResource {\n    return (this._arraysJwt ??= new ArraysJwtResource(this));\n  }\n\n  _requireAuth(): void {\n    if (!this.viewer_token && !this.apiKey) {\n      throw new AlvaError(\n        'UNAUTHENTICATED',\n        'Authentication is required. Pass viewer_token or apiKey in the constructor.',\n        401\n      );\n    }\n  }\n\n  async _request(\n    method: string,\n    path: string,\n    options?: RequestOptions\n  ): Promise<unknown> {\n    const baseUrl = options?.baseUrl ?? this.baseUrl;\n    let url = `${baseUrl}${path}`;\n\n    if (options?.query) {\n      const params = new URLSearchParams();\n      for (const [key, value] of Object.entries(options.query)) {\n        if (value !== undefined && value !== null) {\n          params.set(key, String(value));\n        }\n      }\n      const qs = params.toString();\n      if (qs) {\n        url += `?${qs}`;\n      }\n    }\n\n    const headers: Record<string, string> = {};\n    if (!options?.noAuth) {\n      if (this.viewer_token) {\n        headers['x-Playbook-Viewer'] = this.viewer_token;\n      } else if (this.apiKey) {\n        headers['X-Alva-Api-Key'] = this.apiKey;\n      }\n    }\n\n    let fetchBody: BodyInit | undefined;\n    if (options?.rawBody !== undefined) {\n      headers['Content-Type'] = 'application/octet-stream';\n      fetchBody = options.rawBody;\n    } else if (options?.body !== undefined) {\n      headers['Content-Type'] = 'application/json';\n      fetchBody = JSON.stringify(options.body);\n    }\n\n    let response: Response;\n    try {\n      response = await fetch(url, {\n        method,\n        headers,\n        body: fetchBody,\n      });\n    } catch (err) {\n      throw new AlvaError(\n        'NETWORK_ERROR',\n        err instanceof Error ? err.message : 'Network request failed',\n        0\n      );\n    }\n\n    if (!response.ok) {\n      // Read body as text first to avoid double consumption\n      const bodyText = await response.text().catch(() => '');\n      const contentType = response.headers.get('content-type') ?? '';\n      if (contentType.includes('application/json') && bodyText) {\n        try {\n          const data = JSON.parse(bodyText) as {\n            error?: { code?: string; message?: string };\n          };\n          if (data.error) {\n            throw new AlvaError(\n              data.error.code ?? 'UNKNOWN',\n              data.error.message ?? `HTTP ${response.status}`,\n              response.status\n            );\n          }\n        } catch (e) {\n          if (e instanceof AlvaError) throw e;\n          // JSON parse failed or no error envelope — fall through\n        }\n      }\n      throw new AlvaError(\n        'UNKNOWN',\n        `HTTP ${response.status}: ${bodyText.slice(0, 200)}`,\n        response.status\n      );\n    }\n\n    // Handle 204 No Content and empty responses\n    if (response.status === 204) {\n      return undefined;\n    }\n\n    const contentType = response.headers.get('content-type') ?? '';\n    if (\n      contentType.includes('application/octet-stream') ||\n      contentType.includes('image/')\n    ) {\n      return response.arrayBuffer();\n    }\n\n    return response.json();\n  }\n}\n"],"mappings":"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","names":["contentType"]}
+{"version":3,"sources":["../src/index.ts","../src/error.ts","../src/resources/fs.ts","../src/resources/run.ts","../src/resources/deploy.ts","../src/resources/release.ts","../src/resources/secrets.ts","../src/resources/sdkDocs.ts","../src/resources/skills.ts","../src/resources/comments.ts","../src/resources/remix.ts","../src/resources/screenshot.ts","../src/resources/user.ts","../src/resources/trading.ts","../src/resources/arraysJwt.ts","../src/resources/notifications.ts","../src/resources/pushSubscriptions.ts","../src/client.ts"],"sourcesContent":["declare const __VERSION__: string;\n\n/** SDK version, injected at build time from package.json. */\nexport const VERSION: string =\n  typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'dev';\n\nexport { AlvaClient } from './client.js';\nexport { AlvaError } from './error.js';\nexport type {\n  AlvaClientConfig,\n  FsReadParams,\n  FsWriteParams,\n  FsRawWriteParams,\n  FsWriteResponse,\n  FsStat,\n  FsReaddirParams,\n  FsEntry,\n  FsReaddirResponse,\n  FsMkdirParams,\n  FsRemoveParams,\n  FsRenameParams,\n  FsCopyParams,\n  FsSymlinkParams,\n  FsReadlinkParams,\n  FsChmodParams,\n  FsGrantParams,\n  FsRevokeParams,\n} from './types.js';\n","export class AlvaError extends Error {\n  readonly code: string;\n  readonly status: number;\n\n  constructor(code: string, message: string, status: number) {\n    super(message);\n    this.name = 'AlvaError';\n    this.code = code;\n    this.status = status;\n  }\n}\n\nexport class CliUsageError extends Error {\n  readonly command?: string;\n\n  constructor(message: string, command?: string) {\n    super(message);\n    this.name = 'CliUsageError';\n    this.command = command;\n  }\n}\n","import type { AlvaClient } from '../client.js';\nimport type {\n  FsReadParams,\n  FsWriteParams,\n  FsRawWriteParams,\n  FsWriteResponse,\n  FsStat,\n  FsReaddirParams,\n  FsReaddirResponse,\n  FsMkdirParams,\n  FsRemoveParams,\n  FsRenameParams,\n  FsCopyParams,\n  FsSymlinkParams,\n  FsReadlinkParams,\n  FsChmodParams,\n  FsGrantParams,\n  FsRevokeParams,\n} from '../types.js';\n\nexport class FsResource {\n  constructor(private client: AlvaClient) {}\n\n  /** Returns `ArrayBuffer` for binary files, or parsed JSON for time-series virtual paths. */\n  async read(params: FsReadParams): Promise<ArrayBuffer | unknown> {\n    const result = await this.client._request('GET', '/api/v1/fs/read', {\n      query: { path: params.path, offset: params.offset, size: params.size },\n    });\n    if (!(result instanceof ArrayBuffer)) return result;\n    try {\n      const text = new TextDecoder('utf-8', { fatal: true }).decode(result);\n      try {\n        return JSON.parse(text);\n      } catch {\n        return text;\n      }\n    } catch {\n      return result;\n    }\n  }\n\n  /** Write file using JSON body (Mode 2). For text content. */\n  async write(params: FsWriteParams): Promise<FsWriteResponse> {\n    this.client._requireAuth();\n    return this.client._request('POST', '/api/v1/fs/write', {\n      body: {\n        path: params.path,\n        data: params.data,\n        mkdir_parents: params.mkdir_parents,\n      },\n    }) as Promise<FsWriteResponse>;\n  }\n\n  /** Write file using raw body (Mode 1). Supports binary data. Path and options are query params. */\n  async rawWrite(params: FsRawWriteParams): Promise<FsWriteResponse> {\n    this.client._requireAuth();\n    return this.client._request('POST', '/api/v1/fs/write', {\n      query: {\n        path: params.path,\n        mkdir_parents: params.mkdir_parents,\n      },\n      rawBody: params.body,\n    }) as Promise<FsWriteResponse>;\n  }\n\n  async stat(params: { path: string }): Promise<FsStat> {\n    this.client._requireAuth();\n    return this.client._request('GET', '/api/v1/fs/stat', {\n      query: { path: params.path },\n    }) as Promise<FsStat>;\n  }\n\n  async readdir(params: FsReaddirParams): Promise<FsReaddirResponse> {\n    this.client._requireAuth();\n    return this.client._request('GET', '/api/v1/fs/readdir', {\n      query: { path: params.path, recursive: params.recursive },\n    }) as Promise<FsReaddirResponse>;\n  }\n\n  async mkdir(params: FsMkdirParams): Promise<void> {\n    this.client._requireAuth();\n    await this.client._request('POST', '/api/v1/fs/mkdir', {\n      body: { path: params.path },\n    });\n  }\n\n  async remove(params: FsRemoveParams): Promise<void> {\n    this.client._requireAuth();\n    await this.client._request('DELETE', '/api/v1/fs/remove', {\n      query: { path: params.path, recursive: params.recursive },\n    });\n  }\n\n  async rename(params: FsRenameParams): Promise<void> {\n    this.client._requireAuth();\n    await this.client._request('POST', '/api/v1/fs/rename', {\n      body: { old_path: params.old_path, new_path: params.new_path },\n    });\n  }\n\n  async copy(params: FsCopyParams): Promise<void> {\n    this.client._requireAuth();\n    await this.client._request('POST', '/api/v1/fs/copy', {\n      body: { src_path: params.src_path, dst_path: params.dst_path },\n    });\n  }\n\n  async symlink(params: FsSymlinkParams): Promise<void> {\n    this.client._requireAuth();\n    await this.client._request('POST', '/api/v1/fs/symlink', {\n      body: {\n        target_path: params.target_path,\n        link_path: params.link_path,\n      },\n    });\n  }\n\n  async readlink(params: FsReadlinkParams): Promise<{ target: string }> {\n    this.client._requireAuth();\n    return this.client._request('GET', '/api/v1/fs/readlink', {\n      query: { path: params.path },\n    }) as Promise<{ target: string }>;\n  }\n\n  async chmod(params: FsChmodParams): Promise<void> {\n    this.client._requireAuth();\n    await this.client._request('POST', '/api/v1/fs/chmod', {\n      body: { path: params.path, mode: params.mode },\n    });\n  }\n\n  async grant(params: FsGrantParams): Promise<void> {\n    this.client._requireAuth();\n    await this.client._request('POST', '/api/v1/fs/grant', {\n      body: {\n        path: params.path,\n        subject: params.subject,\n        permission: params.permission,\n      },\n    });\n  }\n\n  async revoke(params: FsRevokeParams): Promise<void> {\n    this.client._requireAuth();\n    await this.client._request('POST', '/api/v1/fs/revoke', {\n      body: {\n        path: params.path,\n        subject: params.subject,\n        permission: params.permission,\n      },\n    });\n  }\n}\n","import type { AlvaClient } from '../client.js';\nimport type { RunRequest, RunResponse } from '../types.js';\n\nexport class RunResource {\n  constructor(private client: AlvaClient) {}\n\n  async execute(params: RunRequest): Promise<RunResponse> {\n    this.client._requireAuth();\n    return this.client._request('POST', '/api/v1/run', {\n      body: {\n        code: params.code,\n        entry_path: params.entry_path,\n        working_dir: params.working_dir,\n        args: params.args,\n      },\n    }) as Promise<RunResponse>;\n  }\n}\n","import type { AlvaClient } from '../client.js';\nimport type {\n  CronjobCreateRequest,\n  Cronjob,\n  CronjobListParams,\n  CronjobListResponse,\n  CronjobUpdateRequest,\n  CronjobRunsListParams,\n  CronjobRunsListResponse,\n  CronjobRunLogsResponse,\n} from '../types.js';\n\nexport class DeployResource {\n  constructor(private client: AlvaClient) {}\n\n  async create(params: CronjobCreateRequest): Promise<Cronjob> {\n    this.client._requireAuth();\n    return this.client._request('POST', '/api/v1/deploy/cronjob', {\n      body: {\n        name: params.name,\n        path: params.path,\n        cron_expression: params.cron_expression,\n        args: params.args,\n        push_notify: params.push_notify,\n      },\n    }) as Promise<Cronjob>;\n  }\n\n  async list(params?: CronjobListParams): Promise<CronjobListResponse> {\n    this.client._requireAuth();\n    return this.client._request('GET', '/api/v1/deploy/cronjobs', {\n      query: { limit: params?.limit, cursor: params?.cursor },\n    }) as Promise<CronjobListResponse>;\n  }\n\n  async get(params: { id: number }): Promise<Cronjob> {\n    this.client._requireAuth();\n    return this.client._request(\n      'GET',\n      `/api/v1/deploy/cronjob/${params.id}`\n    ) as Promise<Cronjob>;\n  }\n\n  async update(params: CronjobUpdateRequest): Promise<Cronjob> {\n    this.client._requireAuth();\n    const { id, ...body } = params;\n    return this.client._request('PATCH', `/api/v1/deploy/cronjob/${id}`, {\n      body,\n    }) as Promise<Cronjob>;\n  }\n\n  async delete(params: { id: number }): Promise<void> {\n    this.client._requireAuth();\n    await this.client._request('DELETE', `/api/v1/deploy/cronjob/${params.id}`);\n  }\n\n  async pause(params: { id: number }): Promise<void> {\n    this.client._requireAuth();\n    await this.client._request(\n      'POST',\n      `/api/v1/deploy/cronjob/${params.id}/pause`\n    );\n  }\n\n  async resume(params: { id: number }): Promise<void> {\n    this.client._requireAuth();\n    await this.client._request(\n      'POST',\n      `/api/v1/deploy/cronjob/${params.id}/resume`\n    );\n  }\n\n  async listRuns(\n    params: CronjobRunsListParams\n  ): Promise<CronjobRunsListResponse> {\n    this.client._requireAuth();\n    return this.client._request(\n      'GET',\n      `/api/v1/deploy/cronjob/${params.cronjob_id}/runs`,\n      {\n        query: { first: params.first, cursor: params.cursor },\n      }\n    ) as Promise<CronjobRunsListResponse>;\n  }\n\n  async getRunLogs(params: {\n    cronjob_id: number;\n    run_id: number;\n  }): Promise<CronjobRunLogsResponse> {\n    this.client._requireAuth();\n    return this.client._request(\n      'GET',\n      `/api/v1/deploy/cronjob/${params.cronjob_id}/runs/${params.run_id}/logs`\n    ) as Promise<CronjobRunLogsResponse>;\n  }\n}\n","import type { AlvaClient } from '../client.js';\nimport type {\n  FeedReleaseRequest,\n  FeedReleaseResponse,\n  PlaybookDraftRequest,\n  PlaybookDraftResponse,\n  PlaybookReleaseRequest,\n  PlaybookReleaseResponse,\n} from '../types.js';\n\nexport class ReleaseResource {\n  constructor(private client: AlvaClient) {}\n\n  async feed(params: FeedReleaseRequest): Promise<FeedReleaseResponse> {\n    this.client._requireAuth();\n    return this.client._request('POST', '/api/v1/release/feed', {\n      body: {\n        name: params.name,\n        version: params.version,\n        cronjob_id: params.cronjob_id,\n        view_json: params.view_json,\n        description: params.description,\n        changelog: params.changelog,\n      },\n    }) as Promise<FeedReleaseResponse>;\n  }\n\n  async playbookDraft(\n    params: PlaybookDraftRequest\n  ): Promise<PlaybookDraftResponse> {\n    this.client._requireAuth();\n    return this.client._request('POST', '/api/v1/draft/playbook', {\n      body: {\n        name: params.name,\n        display_name: params.display_name,\n        description: params.description,\n        feeds: params.feeds,\n        trading_symbols: params.trading_symbols,\n      },\n    }) as Promise<PlaybookDraftResponse>;\n  }\n\n  async playbook(\n    params: PlaybookReleaseRequest\n  ): Promise<PlaybookReleaseResponse> {\n    this.client._requireAuth();\n    return this.client._request('POST', '/api/v1/release/playbook', {\n      body: {\n        name: params.name,\n        version: params.version,\n        feeds: params.feeds,\n        changelog: params.changelog,\n      },\n    }) as Promise<PlaybookReleaseResponse>;\n  }\n}\n","import type { AlvaClient } from '../client.js';\nimport type { CreateSecretRequest, Secret, SecretMetadata } from '../types.js';\n\nexport class SecretsResource {\n  constructor(private client: AlvaClient) {}\n\n  async create(params: CreateSecretRequest): Promise<void> {\n    this.client._requireAuth();\n    await this.client._request('POST', '/api/v1/secrets', {\n      body: { name: params.name, value: params.value },\n    });\n  }\n\n  async list(): Promise<{ secrets: SecretMetadata[] }> {\n    this.client._requireAuth();\n    return this.client._request('GET', '/api/v1/secrets') as Promise<{\n      secrets: SecretMetadata[];\n    }>;\n  }\n\n  async get(params: { name: string }): Promise<Secret> {\n    this.client._requireAuth();\n    const encoded = encodeURIComponent(params.name);\n    return this.client._request(\n      'GET',\n      `/api/v1/secrets/${encoded}`\n    ) as Promise<Secret>;\n  }\n\n  async update(params: { name: string; value: string }): Promise<void> {\n    this.client._requireAuth();\n    const encoded = encodeURIComponent(params.name);\n    await this.client._request('PUT', `/api/v1/secrets/${encoded}`, {\n      body: { value: params.value },\n    });\n  }\n\n  async delete(params: { name: string }): Promise<void> {\n    this.client._requireAuth();\n    const encoded = encodeURIComponent(params.name);\n    await this.client._request('DELETE', `/api/v1/secrets/${encoded}`);\n  }\n}\n","import type { AlvaClient } from '../client.js';\nimport type {\n  ModuleDoc,\n  PartitionsResponse,\n  PartitionSummaryResponse,\n} from '../types.js';\n\nexport class SdkDocsResource {\n  constructor(private client: AlvaClient) {}\n\n  async doc(params: { name: string }): Promise<ModuleDoc> {\n    this.client._requireAuth();\n    return this.client._request('GET', '/api/v1/sdk/doc', {\n      query: { name: params.name },\n    }) as Promise<ModuleDoc>;\n  }\n\n  async partitions(): Promise<PartitionsResponse> {\n    this.client._requireAuth();\n    return this.client._request(\n      'GET',\n      '/api/v1/sdk/partitions'\n    ) as Promise<PartitionsResponse>;\n  }\n\n  async partitionSummary(params: {\n    partition: string;\n  }): Promise<PartitionSummaryResponse> {\n    this.client._requireAuth();\n    const encoded = encodeURIComponent(params.partition);\n    return this.client._request(\n      'GET',\n      `/api/v1/sdk/partitions/${encoded}/summary`\n    ) as Promise<PartitionSummaryResponse>;\n  }\n}\n","import type { AlvaClient } from '../client.js';\n\ntype Envelope<T> = { success: boolean; data: T; request_id?: string };\n\nexport interface SkillSummary {\n  name: string;\n  description: string;\n}\n\nexport interface SkillDoc {\n  name: string;\n  description: string;\n  content: string;\n}\n\nexport class SkillsResource {\n  constructor(private client: AlvaClient) {}\n\n  async list(): Promise<{ skills: SkillSummary[] }> {\n    const res = (await this.client._request('GET', '/api/v1/skills', {\n      baseUrl: this.client.arraysBaseUrl,\n      noAuth: true,\n    })) as Envelope<SkillSummary[]>;\n    return { skills: res.data ?? [] };\n  }\n\n  async summary(params: { name: string }): Promise<SkillDoc> {\n    const encoded = encodeURIComponent(params.name);\n    const res = (await this.client._request(\n      'GET',\n      `/api/v1/skills/${encoded}`,\n      {\n        baseUrl: this.client.arraysBaseUrl,\n        noAuth: true,\n      }\n    )) as Envelope<SkillDoc[]>;\n    const doc = res.data?.[0];\n    if (!doc)\n      throw new Error(`empty skills summary response for \"${params.name}\"`);\n    return doc;\n  }\n\n  async endpoint(params: { name: string; file: string }): Promise<SkillDoc> {\n    const encoded = encodeURIComponent(params.name);\n    const res = (await this.client._request(\n      'GET',\n      `/api/v1/skills/${encoded}`,\n      {\n        baseUrl: this.client.arraysBaseUrl,\n        noAuth: true,\n        query: { endpoint: params.file },\n      }\n    )) as Envelope<SkillDoc[]>;\n    const doc = res.data?.[0];\n    if (!doc) {\n      throw new Error(\n        `empty skills endpoint response for \"${params.name}\" file \"${params.file}\"`\n      );\n    }\n    return doc;\n  }\n}\n","import type { AlvaClient } from '../client.js';\nimport type { CreateCommentRequest, Comment } from '../types.js';\n\nexport class CommentsResource {\n  constructor(private client: AlvaClient) {}\n\n  async create(params: CreateCommentRequest): Promise<Comment> {\n    this.client._requireAuth();\n    return this.client._request('POST', '/api/v1/playbook/comment', {\n      body: {\n        username: params.username,\n        name: params.name,\n        content: params.content,\n        parent_id: params.parent_id,\n      },\n    }) as Promise<Comment>;\n  }\n\n  async pin(params: { comment_id: number }): Promise<Comment> {\n    this.client._requireAuth();\n    return this.client._request('POST', '/api/v1/playbook/comment/pin', {\n      body: { comment_id: params.comment_id },\n    }) as Promise<Comment>;\n  }\n\n  async unpin(params: { comment_id: number }): Promise<Comment> {\n    this.client._requireAuth();\n    return this.client._request('POST', '/api/v1/playbook/comment/unpin', {\n      body: { comment_id: params.comment_id },\n    }) as Promise<Comment>;\n  }\n}\n","import type { AlvaClient } from '../client.js';\nimport type { RemixRequest } from '../types.js';\n\nexport class RemixResource {\n  constructor(private client: AlvaClient) {}\n\n  async save(params: RemixRequest): Promise<void> {\n    this.client._requireAuth();\n    await this.client._request('POST', '/api/v1/remix', {\n      body: {\n        child: params.child,\n        parents: params.parents,\n      },\n    });\n  }\n}\n","import type { AlvaClient } from '../client.js';\nimport type { ScreenshotParams } from '../types.js';\n\nexport class ScreenshotResource {\n  constructor(private client: AlvaClient) {}\n\n  async capture(params: ScreenshotParams): Promise<ArrayBuffer> {\n    this.client._requireAuth();\n    return this.client._request('GET', '/api/v1/screenshot', {\n      query: {\n        url: params.url,\n        selector: params.selector,\n        xpath: params.xpath,\n      },\n    }) as Promise<ArrayBuffer>;\n  }\n}\n","import type { AlvaClient } from '../client.js';\nimport type { UserProfile } from '../types.js';\n\nexport class UserResource {\n  constructor(private client: AlvaClient) {}\n\n  async me(): Promise<UserProfile> {\n    this.client._requireAuth();\n    return this.client._request('GET', '/api/v1/me') as Promise<UserProfile>;\n  }\n}\n","import type { AlvaClient } from '../client.js';\nimport type {\n  TradingAccount,\n  TradingPortfolio,\n  TradingOrder,\n  TradingSubscription,\n  EquityPoint,\n  TradingRiskRule,\n  TradingRiskRuleInput,\n  ExecuteSignalResult,\n} from '../types.js';\n\nexport class TradingResource {\n  constructor(private client: AlvaClient) {}\n\n  async accounts(): Promise<TradingAccount[]> {\n    this.client._requireAuth();\n    return this.client._request('GET', '/api/v1/trading/accounts') as Promise<\n      TradingAccount[]\n    >;\n  }\n\n  async portfolio(accountId: string): Promise<TradingPortfolio> {\n    this.client._requireAuth();\n    return this.client._request('GET', '/api/v1/trading/portfolio', {\n      query: { accountId },\n    }) as Promise<TradingPortfolio>;\n  }\n\n  async orders(params: {\n    accountId: string;\n    source?: string;\n    since?: number;\n    limit?: number;\n  }): Promise<TradingOrder[]> {\n    this.client._requireAuth();\n    return this.client._request('GET', '/api/v1/trading/orders', {\n      query: {\n        accountId: params.accountId,\n        source: params.source,\n        since: params.since,\n        limit: params.limit,\n      },\n    }) as Promise<TradingOrder[]>;\n  }\n\n  async subscriptions(accountId: string): Promise<TradingSubscription[]> {\n    this.client._requireAuth();\n    return this.client._request('GET', '/api/v1/trading/subscriptions', {\n      query: { accountId },\n    }) as Promise<TradingSubscription[]>;\n  }\n\n  async equityHistory(params: {\n    accountId: string;\n    timeframe?: string;\n    sinceMs?: number;\n    untilMs?: number;\n  }): Promise<EquityPoint[]> {\n    this.client._requireAuth();\n    return this.client._request('GET', '/api/v1/trading/equity-history', {\n      query: {\n        accountId: params.accountId,\n        timeframe: params.timeframe,\n        sinceMs: params.sinceMs,\n        untilMs: params.untilMs,\n      },\n    }) as Promise<EquityPoint[]>;\n  }\n\n  async riskRules(): Promise<TradingRiskRule> {\n    this.client._requireAuth();\n    return this.client._request(\n      'GET',\n      '/api/v1/trading/risk-rules'\n    ) as Promise<TradingRiskRule>;\n  }\n\n  async subscribe(params: {\n    accountId: string;\n    sourceUsername: string;\n    sourceFeed: string;\n    playbookId: string;\n    playbookVersion: string;\n    executeLatest?: boolean;\n  }): Promise<TradingSubscription> {\n    this.client._requireAuth();\n    return this.client._request('POST', '/api/v1/trading/subscribe', {\n      body: params,\n    }) as Promise<TradingSubscription>;\n  }\n\n  async unsubscribe(\n    subscriptionId: string\n  ): Promise<{ unsubscribedId: string }> {\n    this.client._requireAuth();\n    return this.client._request('POST', '/api/v1/trading/unsubscribe', {\n      body: { subscriptionId },\n    }) as Promise<{ unsubscribedId: string }>;\n  }\n\n  async execute(params: {\n    accountId: string;\n    signalJson: string;\n    dryRun: boolean;\n    sourceUsername?: string;\n    sourceFeed?: string;\n  }): Promise<ExecuteSignalResult> {\n    this.client._requireAuth();\n    return this.client._request('POST', '/api/v1/trading/execute', {\n      body: params,\n    }) as Promise<ExecuteSignalResult>;\n  }\n\n  async updateRiskRules(rules: TradingRiskRuleInput): Promise<TradingRiskRule> {\n    this.client._requireAuth();\n    return this.client._request('PUT', '/api/v1/trading/risk-rules', {\n      body: rules,\n    }) as Promise<TradingRiskRule>;\n  }\n}\n","import type { AlvaClient } from '../client.js';\nimport type {\n  EnsureArraysJwtResponse,\n  ArraysJwtStatusResponse,\n} from '../types.js';\n\nexport class ArraysJwtResource {\n  constructor(private client: AlvaClient) {}\n\n  /** Idempotently sign-or-renew the Arrays JWT server-side. */\n  async ensure(): Promise<EnsureArraysJwtResponse> {\n    this.client._requireAuth();\n    return this.client._request(\n      'POST',\n      '/api/v1/arrays-jwt/ensure'\n    ) as Promise<EnsureArraysJwtResponse>;\n  }\n\n  /** Report the current Arrays JWT state for the authenticated user. */\n  async status(): Promise<ArraysJwtStatusResponse> {\n    this.client._requireAuth();\n    return this.client._request(\n      'GET',\n      '/api/v1/arrays-jwt/status'\n    ) as Promise<ArraysJwtStatusResponse>;\n  }\n}\n","import type { AlvaClient } from '../client.js';\nimport type {\n  FeedNotificationListResponse,\n  NotificationListParams,\n  PlaybookNotificationListResponse,\n} from '../types.js';\n\nexport class NotificationsResource {\n  constructor(private client: AlvaClient) {}\n\n  /**\n   * List the caller's notification history for one playbook\n   * `(username, name)`. Returns `NOT_FOUND` when the playbook is\n   * private or does not exist (the two cases are deliberately\n   * indistinguishable to prevent namespace enumeration).\n   */\n  async listPlaybook(\n    params: NotificationListParams\n  ): Promise<PlaybookNotificationListResponse> {\n    this.client._requireAuth();\n    const path = `/api/v1/playbook/${encodeURIComponent(params.username)}/${encodeURIComponent(params.name)}/notifications`;\n    return this.client._request('GET', path, {\n      query: buildQuery(params),\n    }) as Promise<PlaybookNotificationListResponse>;\n  }\n\n  /**\n   * List the caller's notification history for one feed\n   * `(username, name)`. Authorization is alfs read on\n   * `/alva/home/<username>/feeds/<name>`.\n   */\n  async listFeed(\n    params: NotificationListParams\n  ): Promise<FeedNotificationListResponse> {\n    this.client._requireAuth();\n    const path = `/api/v1/feed/${encodeURIComponent(params.username)}/${encodeURIComponent(params.name)}/notifications`;\n    return this.client._request('GET', path, {\n      query: buildQuery(params),\n    }) as Promise<FeedNotificationListResponse>;\n  }\n}\n\nfunction buildQuery(params: NotificationListParams): Record<string, string> {\n  const q: Record<string, string> = {};\n  if (params.channel) q.channel = params.channel;\n  if (params.status) q.status = params.status;\n  if (params.since_time !== undefined && params.since_time > 0) {\n    q.since_time = String(params.since_time);\n  }\n  if (params.first !== undefined && params.first > 0) {\n    q.first = String(params.first);\n  }\n  if (params.cursor) q.cursor = params.cursor;\n  return q;\n}\n","import type { AlvaClient } from '../client.js';\nimport type {\n  PushSubscriptionFeedParams,\n  PushSubscriptionListParams,\n  PushSubscriptionListResponse,\n  PushSubscriptionPlaybookParams,\n  SubscribeFeedPushTargetResponse,\n  SubscribePushTargetResponse,\n  UnsubscribePushTargetResponse,\n} from '../types.js';\n\n/**\n * Personal push subscriptions — opt the caller in or out of personal\n * DM/web push for a target. Independent of social follow:\n *\n *   - `subscribePlaybook` / `subscribeFeed` do not start following.\n *   - `unsubscribePlaybook` / `unsubscribeFeed` do not unfollow.\n *   - Following a playbook elsewhere will compound-subscribe automatically.\n *\n * Backed by alva-gateway REST (mirrors the GraphQL surface in\n * `pkg/schema/push_subscription.graphql`).\n */\nexport class PushSubscriptionsResource {\n  constructor(private client: AlvaClient) {}\n\n  /**\n   * Opt into personal push for one playbook `(username, name)`.\n   * Fires for any feed of that playbook. Idempotent. Auth: callers must\n   * be able to read the playbook (public/paid pass; private requires\n   * explicit alfs grant).\n   */\n  async subscribePlaybook(\n    params: PushSubscriptionPlaybookParams\n  ): Promise<SubscribePushTargetResponse> {\n    this.client._requireAuth();\n    const path = `/api/v1/playbook/${encodeURIComponent(params.username)}/${encodeURIComponent(params.name)}/push-subscription`;\n    return this.client._request(\n      'POST',\n      path\n    ) as Promise<SubscribePushTargetResponse>;\n  }\n\n  /**\n   * Soft-disable personal push for one playbook `(username, name)`.\n   * Does NOT remove any social follow. Idempotent.\n   */\n  async unsubscribePlaybook(\n    params: PushSubscriptionPlaybookParams\n  ): Promise<UnsubscribePushTargetResponse> {\n    this.client._requireAuth();\n    const path = `/api/v1/playbook/${encodeURIComponent(params.username)}/${encodeURIComponent(params.name)}/push-subscription`;\n    return this.client._request(\n      'DELETE',\n      path\n    ) as Promise<UnsubscribePushTargetResponse>;\n  }\n\n  /**\n   * Opt into personal push for one feed `(username, name)`. Fires for\n   * that specific feed regardless of which playbook(s) consume it; if\n   * the feed is shared across playbooks the subscriber receives one\n   * push per playbook context. Idempotent.\n   */\n  async subscribeFeed(\n    params: PushSubscriptionFeedParams\n  ): Promise<SubscribeFeedPushTargetResponse> {\n    this.client._requireAuth();\n    const path = `/api/v1/feed/${encodeURIComponent(params.username)}/${encodeURIComponent(params.name)}/push-subscription`;\n    return this.client._request(\n      'POST',\n      path\n    ) as Promise<SubscribeFeedPushTargetResponse>;\n  }\n\n  /**\n   * Soft-disable personal push for one feed `(username, name)`.\n   * Idempotent.\n   */\n  async unsubscribeFeed(\n    params: PushSubscriptionFeedParams\n  ): Promise<UnsubscribePushTargetResponse> {\n    this.client._requireAuth();\n    const path = `/api/v1/feed/${encodeURIComponent(params.username)}/${encodeURIComponent(params.name)}/push-subscription`;\n    return this.client._request(\n      'DELETE',\n      path\n    ) as Promise<UnsubscribePushTargetResponse>;\n  }\n\n  /**\n   * List the caller's personal push subscriptions across all targets\n   * (playbook + feed). Defaults to currently-active rows only; pass\n   * `include_history=true` to also return previously-unsubscribed rows.\n   */\n  async list(\n    params: PushSubscriptionListParams = {}\n  ): Promise<PushSubscriptionListResponse> {\n    this.client._requireAuth();\n    const query: Record<string, string> = {};\n    if (params.include_history !== undefined) {\n      query.include_history = String(params.include_history);\n    }\n    return this.client._request('GET', '/api/v1/me/push-subscriptions', {\n      query,\n    }) as Promise<PushSubscriptionListResponse>;\n  }\n}\n","import { AlvaError } from './error.js';\nimport type { AlvaClientConfig } from './types.js';\nimport { FsResource } from './resources/fs.js';\nimport { RunResource } from './resources/run.js';\nimport { DeployResource } from './resources/deploy.js';\nimport { ReleaseResource } from './resources/release.js';\nimport { SecretsResource } from './resources/secrets.js';\nimport { SdkDocsResource } from './resources/sdkDocs.js';\nimport { SkillsResource } from './resources/skills.js';\nimport { CommentsResource } from './resources/comments.js';\nimport { RemixResource } from './resources/remix.js';\nimport { ScreenshotResource } from './resources/screenshot.js';\nimport { UserResource } from './resources/user.js';\nimport { TradingResource } from './resources/trading.js';\nimport { ArraysJwtResource } from './resources/arraysJwt.js';\nimport { NotificationsResource } from './resources/notifications.js';\nimport { PushSubscriptionsResource } from './resources/pushSubscriptions.js';\n\nconst DEFAULT_BASE_URL = 'https://api-llm.prd.alva.ai';\nexport const DEFAULT_ARRAYS_BASE_URL = 'https://data-tools.prd.space.id';\n\ninterface RequestOptions {\n  query?: Record<string, unknown>;\n  body?: unknown;\n  /** Send raw body with application/octet-stream content type (for binary writes). */\n  rawBody?: BodyInit;\n  /** Override the base URL for this request (e.g. the Arrays data-tools endpoint). */\n  baseUrl?: string;\n  /** If true, skip attaching any Alva auth header (X-Alva-Api-Key / x-Playbook-Viewer). */\n  noAuth?: boolean;\n}\n\nexport class AlvaClient {\n  readonly baseUrl: string;\n  readonly arraysBaseUrl: string;\n  readonly viewer_token?: string;\n  readonly apiKey?: string;\n\n  private _fs?: FsResource;\n  private _run?: RunResource;\n  private _deploy?: DeployResource;\n  private _release?: ReleaseResource;\n  private _secrets?: SecretsResource;\n  private _sdk?: SdkDocsResource;\n  private _skills?: SkillsResource;\n  private _comments?: CommentsResource;\n  private _remix?: RemixResource;\n  private _screenshot?: ScreenshotResource;\n  private _user?: UserResource;\n  private _trading?: TradingResource;\n  private _arraysJwt?: ArraysJwtResource;\n  private _notifications?: NotificationsResource;\n  private _pushSubscriptions?: PushSubscriptionsResource;\n\n  constructor(config: AlvaClientConfig) {\n    this.baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;\n    this.arraysBaseUrl = config.arraysBaseUrl ?? DEFAULT_ARRAYS_BASE_URL;\n    this.viewer_token = config.viewer_token;\n    this.apiKey = config.apiKey;\n  }\n\n  get fs(): FsResource {\n    return (this._fs ??= new FsResource(this));\n  }\n  get run(): RunResource {\n    return (this._run ??= new RunResource(this));\n  }\n  get deploy(): DeployResource {\n    return (this._deploy ??= new DeployResource(this));\n  }\n  get release(): ReleaseResource {\n    return (this._release ??= new ReleaseResource(this));\n  }\n  get secrets(): SecretsResource {\n    return (this._secrets ??= new SecretsResource(this));\n  }\n  get sdk(): SdkDocsResource {\n    return (this._sdk ??= new SdkDocsResource(this));\n  }\n  get skills(): SkillsResource {\n    return (this._skills ??= new SkillsResource(this));\n  }\n  get comments(): CommentsResource {\n    return (this._comments ??= new CommentsResource(this));\n  }\n  get remix(): RemixResource {\n    return (this._remix ??= new RemixResource(this));\n  }\n  get screenshot(): ScreenshotResource {\n    return (this._screenshot ??= new ScreenshotResource(this));\n  }\n  get user(): UserResource {\n    return (this._user ??= new UserResource(this));\n  }\n  get trading(): TradingResource {\n    return (this._trading ??= new TradingResource(this));\n  }\n  get arraysJwt(): ArraysJwtResource {\n    return (this._arraysJwt ??= new ArraysJwtResource(this));\n  }\n  get notifications(): NotificationsResource {\n    return (this._notifications ??= new NotificationsResource(this));\n  }\n  get pushSubscriptions(): PushSubscriptionsResource {\n    return (this._pushSubscriptions ??= new PushSubscriptionsResource(this));\n  }\n\n  _requireAuth(): void {\n    if (!this.viewer_token && !this.apiKey) {\n      throw new AlvaError(\n        'UNAUTHENTICATED',\n        'Authentication is required. Pass viewer_token or apiKey in the constructor.',\n        401\n      );\n    }\n  }\n\n  async _request(\n    method: string,\n    path: string,\n    options?: RequestOptions\n  ): Promise<unknown> {\n    const baseUrl = options?.baseUrl ?? this.baseUrl;\n    let url = `${baseUrl}${path}`;\n\n    if (options?.query) {\n      const params = new URLSearchParams();\n      for (const [key, value] of Object.entries(options.query)) {\n        if (value !== undefined && value !== null) {\n          params.set(key, String(value));\n        }\n      }\n      const qs = params.toString();\n      if (qs) {\n        url += `?${qs}`;\n      }\n    }\n\n    const headers: Record<string, string> = {};\n    if (!options?.noAuth) {\n      if (this.viewer_token) {\n        headers['x-Playbook-Viewer'] = this.viewer_token;\n      } else if (this.apiKey) {\n        headers['X-Alva-Api-Key'] = this.apiKey;\n      }\n    }\n\n    let fetchBody: BodyInit | undefined;\n    if (options?.rawBody !== undefined) {\n      headers['Content-Type'] = 'application/octet-stream';\n      fetchBody = options.rawBody;\n    } else if (options?.body !== undefined) {\n      headers['Content-Type'] = 'application/json';\n      fetchBody = JSON.stringify(options.body);\n    }\n\n    let response: Response;\n    try {\n      response = await fetch(url, {\n        method,\n        headers,\n        body: fetchBody,\n      });\n    } catch (err) {\n      throw new AlvaError(\n        'NETWORK_ERROR',\n        err instanceof Error ? err.message : 'Network request failed',\n        0\n      );\n    }\n\n    if (!response.ok) {\n      // Read body as text first to avoid double consumption\n      const bodyText = await response.text().catch(() => '');\n      const contentType = response.headers.get('content-type') ?? '';\n      if (contentType.includes('application/json') && bodyText) {\n        try {\n          const data = JSON.parse(bodyText) as {\n            error?: { code?: string; message?: string };\n          };\n          if (data.error) {\n            throw new AlvaError(\n              data.error.code ?? 'UNKNOWN',\n              data.error.message ?? `HTTP ${response.status}`,\n              response.status\n            );\n          }\n        } catch (e) {\n          if (e instanceof AlvaError) throw e;\n          // JSON parse failed or no error envelope — fall through\n        }\n      }\n      throw new AlvaError(\n        'UNKNOWN',\n        `HTTP ${response.status}: ${bodyText.slice(0, 200)}`,\n        response.status\n      );\n    }\n\n    // Handle 204 No Content and empty responses\n    if (response.status === 204) {\n      return undefined;\n    }\n\n    const contentType = response.headers.get('content-type') ?? '';\n    if (\n      contentType.includes('application/octet-stream') ||\n      contentType.includes('image/')\n    ) {\n      return response.arrayBuffer();\n    }\n\n    return response.json();\n  }\n}\n"],"mappings":"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","names":["contentType"]}

package/dist/index.d.cts

@@ -9,6 +9,8 @@ interface UserProfile {
     username: string;
     subscription_tier: 'free' | 'pro';
     telegram_username: string | null;
+    /** Caller's alfs home directory, e.g. `/alva/home/<username>`. */
+    home_path: string;
 }
 type SubscriptionTier = 'SUBSCRIPTION_TIER_UNSPECIFIED' | 'SUBSCRIPTION_TIER_FREE' | 'SUBSCRIPTION_TIER_PRO';
 interface EnsureArraysJwtResponse {
@@ -181,11 +183,14 @@ interface FeedReleaseRequest {
     cronjob_id: number;
     view_json?: Record<string, unknown>;
     description?: string;
+    changelog?: string;
 }
 interface FeedReleaseResponse {
     feed_id: number;
     name: string;
     feed_major: number;
+    /** Canonical alfs path: `/alva/home/<username>/feeds/<name>`. */
+    feed_path: string;
 }
 interface PlaybookDraftRequest {
     name: string;
@@ -196,11 +201,12 @@ interface PlaybookDraftRequest {
         feed_major?: number;
     }>;
     trading_symbols?: string[];
-    changelog?: string;
 }
 interface PlaybookDraftResponse {
     playbook_id: number;
     playbook_version_id: number;
+    /** Canonical alfs path: `/alva/home/<username>/playbooks/<name>`. */
+    playbook_path: string;
 }
 interface PlaybookReleaseRequest {
     name: string;
@@ -215,6 +221,8 @@ interface PlaybookReleaseResponse {
     playbook_id: number;
     version: string;
     published_url: string;
+    /** Canonical alfs path: `/alva/home/<username>/playbooks/<name>`. */
+    playbook_path: string;
 }
 interface CreateSecretRequest {
     name: string;
@@ -372,6 +380,100 @@ interface ExecuteSignalResult {
     orders: ExecuteSignalOrder[];
     error?: string;
 }
+interface NotificationListParams {
+    username: string;
+    name: string;
+    channel?: string;
+    /** `sent` / `failed` / `filtered`. */
+    status?: string;
+    /** Unix seconds; only notifications newer than this. */
+    since_time?: number;
+    /** Page size, default 50, max 200. */
+    first?: number;
+    /** Opaque cursor token from previous page's `next_cursor`. */
+    cursor?: string;
+}
+interface NotificationEvent {
+    id: string;
+    event_type: string;
+    user_id: string;
+    channel: string;
+    /** `sent` / `failed` / `filtered`. */
+    status: string;
+    /** Unix seconds. */
+    created_at: number;
+    message?: string;
+    error_msg?: string;
+    /** Present when notification is playbook-scoped. */
+    playbook_id?: string;
+    /** Present when notification is feed-scoped. */
+    feed_id?: string;
+}
+interface PlaybookNotificationListResponse {
+    items: NotificationEvent[];
+    /** Empty when there is no next page. */
+    next_cursor: string;
+    /** Canonical alfs path: `/alva/home/<username>/playbooks/<name>`. */
+    playbook_path: string;
+}
+interface FeedNotificationListResponse {
+    items: NotificationEvent[];
+    next_cursor: string;
+    /** Canonical alfs path: `/alva/home/<username>/feeds/<name>`. */
+    feed_path: string;
+}
+/**
+ * Identifies the asset a personal push subscription is keyed to.
+ * `PLAYBOOK` is the only target supported today; `FEED` is reserved for
+ * a future phase where users can subscribe to a feed independent of any
+ * playbook that consumes it.
+ */
+type PushTargetType = 'PLAYBOOK' | 'FEED' | 'UNSPECIFIED';
+interface PushTarget {
+    type: PushTargetType;
+    /** Numeric id encoded as a string (matches the rest of the SDK). */
+    id: string;
+}
+interface PushSubscription {
+    target: PushTarget;
+    /**
+     * `true` when the row is currently active. `false` means the user
+     * previously subscribed and then unsubscribed; the row is preserved
+     * so re-subscribe restores seniority via UPSERT-revive. Only present
+     * when `include_history=true` is passed to `list`.
+     */
+    subscribed: boolean;
+    created_at_ms: number;
+    updated_at_ms: number;
+}
+interface PushSubscriptionPlaybookParams {
+    username: string;
+    name: string;
+}
+interface PushSubscriptionFeedParams {
+    username: string;
+    name: string;
+}
+interface PushSubscriptionListParams {
+    /** Default `false`. When `true`, include rows with `subscribed=false`. */
+    include_history?: boolean;
+}
+interface PushSubscriptionListResponse {
+    items: PushSubscription[];
+}
+interface SubscribePushTargetResponse {
+    subscription: PushSubscription;
+    /** Canonical alfs path: `/alva/home/<username>/playbooks/<name>`. */
+    playbook_path: string;
+}
+interface SubscribeFeedPushTargetResponse {
+    subscription: PushSubscription;
+    /** Canonical alfs path: `/alva/home/<username>/feeds/<name>`. */
+    feed_path: string;
+}
+interface UnsubscribePushTargetResponse {
+    ok: true;
+}
 
 declare class FsResource {
     private client;
@@ -572,6 +674,70 @@ declare class ArraysJwtResource {
     status(): Promise<ArraysJwtStatusResponse>;
 }
 
+declare class NotificationsResource {
+    private client;
+    constructor(client: AlvaClient);
+    /**
+     * List the caller's notification history for one playbook
+     * `(username, name)`. Returns `NOT_FOUND` when the playbook is
+     * private or does not exist (the two cases are deliberately
+     * indistinguishable to prevent namespace enumeration).
+     */
+    listPlaybook(params: NotificationListParams): Promise<PlaybookNotificationListResponse>;
+    /**
+     * List the caller's notification history for one feed
+     * `(username, name)`. Authorization is alfs read on
+     * `/alva/home/<username>/feeds/<name>`.
+     */
+    listFeed(params: NotificationListParams): Promise<FeedNotificationListResponse>;
+}
+
+/**
+ * Personal push subscriptions — opt the caller in or out of personal
+ * DM/web push for a target. Independent of social follow:
+ *
+ *   - `subscribePlaybook` / `subscribeFeed` do not start following.
+ *   - `unsubscribePlaybook` / `unsubscribeFeed` do not unfollow.
+ *   - Following a playbook elsewhere will compound-subscribe automatically.
+ *
+ * Backed by alva-gateway REST (mirrors the GraphQL surface in
+ * `pkg/schema/push_subscription.graphql`).
+ */
+declare class PushSubscriptionsResource {
+    private client;
+    constructor(client: AlvaClient);
+    /**
+     * Opt into personal push for one playbook `(username, name)`.
+     * Fires for any feed of that playbook. Idempotent. Auth: callers must
+     * be able to read the playbook (public/paid pass; private requires
+     * explicit alfs grant).
+     */
+    subscribePlaybook(params: PushSubscriptionPlaybookParams): Promise<SubscribePushTargetResponse>;
+    /**
+     * Soft-disable personal push for one playbook `(username, name)`.
+     * Does NOT remove any social follow. Idempotent.
+     */
+    unsubscribePlaybook(params: PushSubscriptionPlaybookParams): Promise<UnsubscribePushTargetResponse>;
+    /**
+     * Opt into personal push for one feed `(username, name)`. Fires for
+     * that specific feed regardless of which playbook(s) consume it; if
+     * the feed is shared across playbooks the subscriber receives one
+     * push per playbook context. Idempotent.
+     */
+    subscribeFeed(params: PushSubscriptionFeedParams): Promise<SubscribeFeedPushTargetResponse>;
+    /**
+     * Soft-disable personal push for one feed `(username, name)`.
+     * Idempotent.
+     */
+    unsubscribeFeed(params: PushSubscriptionFeedParams): Promise<UnsubscribePushTargetResponse>;
+    /**
+     * List the caller's personal push subscriptions across all targets
+     * (playbook + feed). Defaults to currently-active rows only; pass
+     * `include_history=true` to also return previously-unsubscribed rows.
+     */
+    list(params?: PushSubscriptionListParams): Promise<PushSubscriptionListResponse>;
+}
+
 interface RequestOptions {
     query?: Record<string, unknown>;
     body?: unknown;
@@ -600,6 +766,8 @@ declare class AlvaClient {
     private _user?;
     private _trading?;
     private _arraysJwt?;
+    private _notifications?;
+    private _pushSubscriptions?;
     constructor(config: AlvaClientConfig);
     get fs(): FsResource;
     get run(): RunResource;
@@ -614,6 +782,8 @@ declare class AlvaClient {
     get user(): UserResource;
     get trading(): TradingResource;
     get arraysJwt(): ArraysJwtResource;
+    get notifications(): NotificationsResource;
+    get pushSubscriptions(): PushSubscriptionsResource;
     _requireAuth(): void;
     _request(method: string, path: string, options?: RequestOptions): Promise<unknown>;
 }