arcmira 0.3.0 → 0.4.0

package/README.md

@@ -5,7 +5,8 @@ The official `arcmira` package: a typed client for the [Arcmira API](https://arc
 - Zero runtime dependencies. Uses the global `fetch`, so it runs in Node 18 and later, Cloudflare Workers, Deno, Bun and browsers.
 - ESM and CommonJS builds with types.
 - Every list pages itself. Every error is a typed class carrying the parsed API body.
-- Full API scope: search, transcripts (reading and ordering them), mentions, momentum, sponsors and recommendations, monitors, trackers, team, corrections and feedback.
+- The whole documented API: search, transcripts (Premium included), mentions, momentum, sponsors and recommendations, monitors, trackers, Slack integrations and feedback.
+- Reads take ids (`ent_14`, `UC...`). `entities.resolve` turns a name into one.
 
 ## Install
 
@@ -22,25 +23,38 @@ npx arcmira setup             # apply, then sign in once per agent
 
 Get a key at [arcmira.com/docs/authentication](https://arcmira.com/docs/authentication) and set `ARCMIRA_API_KEY`, or pass `apiKey` to the client.
 
-## Premium quickstart
+## Premium transcripts
 
 ```ts
 import { ArcmiraClient } from "arcmira";
 const arcmira = new ArcmiraClient();
-const transcript = await arcmira.transcripts.prepareAndWait({ video_id: "dQw4w9WgXcQ" });
-for (const line of transcript.lines ?? []) console.log(line.speaker, line.text);
+const read = await arcmira.transcripts.get({ video_id: "dQw4w9WgXcQ", quality: "premium" });
+if (read.state === "ready") for (const line of read.lines ?? []) console.log(line.speaker, line.text);
+else console.log(`transcribing, read again in ${read.job.next_poll_seconds ?? 30} s`);
 ```
 
-`prepareAndWait({ video_id, maxOnDemandCents = 0, timeoutSeconds = 300 })` reads the Premium transcript and returns it. When your account does not own it yet, the call posts `{ video_id }` to `/v1/transcriptions` once, polls the job at the pace the API sets with `Retry-After` and `next_poll_seconds`, and reads the finished transcript. The default spends included credits only and sends no `Idempotency-Key`. Preparation buys the whole video, even if you later read a window.
+A Premium read is one GET. When your account does not own the transcript yet, the read buys it within your plan: included credits first, then your on-demand budget, which you set in the dashboard and which is the approval. The answer is `state: "ready"` (HTTP 200) with the lines, or `state: "pending"` (HTTP 202) with the `job` while it transcribes. Read again after `Retry-After` or `job.next_poll_seconds`. Repeated and concurrent reads join the same job and never buy twice. When the last purchase failed or was refunded, the read answers `state: "failed"` (HTTP 200) with `last_attempt` and buys nothing; read with `retry: true` to buy it again. `transcripts.quote({ video_id })` prices it first, free.
 
-Errors you can handle:
+A read the plan cannot pay for throws instead. `PaymentRequiredError` carries `quota_exceeded` or `spend_limit_exceeded`, and `ForbiddenError` carries `paid_plan_required` on a free plan. Both carry the price in `err.body.error.details.quote`.
 
-- `PreparationTimeoutError` when the job outlasts `timeoutSeconds`. It carries `job`, and the job keeps running.
-- `PreparationFailedError` when the job fails or is refunded. It carries `job`.
-- `PremiumUnavailableError` when the plan has no Premium. The read returned captions, which are never returned as Premium.
-- `ArcmiraError` subclasses for any API refusal, such as `quota_exceeded`, with the API's error object in `body`.
-
-To spend money, pass a cents ceiling you have approved: `prepareAndWait({ video_id, maxOnDemandCents: 25 })`. The call then sends the quoted `max_rows` and one generated `Idempotency-Key`, which the SDK's retries reuse.
+```ts
+import { Arcmira } from "arcmira";
+const sleep = (s: number) => new Promise((done) => setTimeout(done, s * 1000));
+async function premium(video_id: string) {
+    for (;;) {
+        const { data, rawResponse } = await arcmira.transcripts.get({ video_id, quality: "premium" }).withRawResponse();
+        if (data.state === "ready") return data;
+        if (data.state === "failed") throw new Error(`${data.last_attempt.status}: ${data.last_attempt.error}`);
+        await sleep(Number(rawResponse.headers.get("retry-after")) || data.job.next_poll_seconds || 30);
+    }
+}
+try {
+    console.log((await premium("dQw4w9WgXcQ")).speakers);
+} catch (err) {
+    if (err instanceof Arcmira.PaymentRequiredError || err instanceof Arcmira.ForbiddenError) console.log(err.body.error.code, err.body.error.details?.quote);
+    else throw err;
+}
+```
 
 ## Quickstart
 
@@ -49,7 +63,7 @@ import { Arcmira, ArcmiraClient } from "arcmira";
 
 const client = new ArcmiraClient({ apiKey: process.env.ARCMIRA_API_KEY });
 
-// Who is "Ramp"? Filters take ids, so resolve the name first. The answer is best (one row is meant),
+// Who is "Ramp"? Reads take ids, so resolve the name first. The answer is best (one row is meant),
 // suggested (one row stands out: use it and say you assumed it), or ask (show the options to the user).
 // context carries the user's own words about the name and settles close calls.
 const resolved = await client.entities.resolve({ q: "Ramp", context: "the corporate card company" });
@@ -58,20 +72,24 @@ if (!ramp) throw new Error(resolved.ask ? `${resolved.ask.question} ${resolved.a
 if (resolved.suggested) console.log(`Assuming ${ramp.name} (${ramp.type}): ${resolved.suggested.evidence}`);
 console.log(ramp.id, ramp.type, ramp.page);
 
-// Spoken slices that answer a phrase. about, by and channel_ids take ids only; a name answers 400 id_required.
-const hits = await client.transcripts.search({ q: "corporate cards", about: ramp.id, kind: "recommendation_sponsored", limit: 5 });
-for (const chunk of hits.chunks) console.log(chunk.channelName, chunk.publishedAt, chunk.watchUrl, chunk.text);
-// The plan window and index state come back with every search: say where the results stop.
-if (hits.filters.publishedBefore) console.log(`results stop before ${hits.filters.publishedBefore}`);
+// Spoken passages that answer a phrase. about, by, entity_ids and channel_ids take ids only; a name answers 400 id_required.
+// kind is sponsored, organic or mention. after is inclusive and before exclusive, in UTC.
+const hits = await client.transcripts.search({ q: "corporate cards", about: ramp.id, kind: "sponsored", after: "2026-09-01", before: "2026-10-01", limit: 5 });
+for (const chunk of hits.chunks) console.log(chunk.channel_name, chunk.published_at, chunk.watch_url, chunk.text);
+// The window and index state come back with every search: say where the results stop.
+if (hits.window.before) console.log(`results stop before ${hits.window.before}`);
 if (hits.search_index.missing_before) console.log(`transcripts before ${hits.search_index.missing_before} are still being added`);
 
 // Catalog rows page themselves: iterate and the client follows next_cursor. Each row bills, so stop when you have enough.
 let seen = 0;
-for await (const mention of await client.mentions.list({ entity_id: ramp.id, limit: 25 })) {
+for await (const mention of await client.mentions.list({ entity_id: ramp.id, after: "2026-09-01", limit: 25 })) {
     console.log(mention.media.title, mention.start_seconds);
     if (++seen === 40) break;
 }
 
+// Who recommends it on air, and whether they were paid.
+for await (const row of await client.recommendations.list({ entity_id: ramp.id, class: "organic", limit: 10 })) console.log(row.class, row.verbatim_quote);
+
 // Gates and failures are typed. The body is the API's error object.
 try {
     const momentum = await client.entities.momentum({ id: ramp.id });
@@ -80,17 +98,14 @@ try {
     if (err instanceof Arcmira.PaymentRequiredError) console.log(err.body.error.gate, err.body.error.unlock?.url);
     else throw err;
 }
-```
-
-To prepare Premium without waiting, read it, post the purchase, and poll the job yourself. GET never buys, and each state is typed. Every purchase answers one `TranscriptJob`. Without an `Idempotency-Key`, a purchase already open or owned for the video comes back with `existing: true`. A positive `max_on_demand_cents` requires both `Idempotency-Key` and `max_rows`.
 
-```ts
-const read = await client.transcripts.get({ video_id: "dQw4w9WgXcQ", quality: "premium" });
-if (read.state === "preparation_required") {
-    const { job } = await client.transcripts.request({ video_id: read.video_id });
-    console.log(job.state, job.next_poll_seconds, job.status_url);
-}
-for await (const job of await client.transcripts.listRequests({ limit: 10 })) console.log(job.id, job.state);
+// Follow an exact name. The tracker fires on newly analyzed media, even before the name is indexed.
+// A channel is followed by its YouTube channel id. A duplicate is a ConflictError with error.details.existing_id.
+const { monitor } = await client.monitors.create({ name: "Fintech", notify_frequency: "daily" });
+const { tracker } = await client.trackers.create({ entity_name: "Mercury", entity_type: "organization" });
+await client.monitors.trackers.add({ id: monitor.id, tracker_ids: [tracker.id] });
+// An indexed entity joins a monitor by id.
+await client.monitors.entities.add({ id: monitor.id, entity_ids: [ramp.id] });
 ```
 
 Every method is listed with its request and response types in [reference.md](./reference.md). The same operations, with `curl` samples, are in the [API reference](https://arcmira.com/docs/api-reference).
@@ -101,7 +116,7 @@ A method that returns a `Page` is an async iterable over rows. `page.data` holds
 
 ### Errors
 
-Every non-2xx answer throws a subclass of `ArcmiraError` named for the status: `BadRequestError`, `UnauthorizedError`, `PaymentRequiredError`, `ForbiddenError`, `NotFoundError`, `ConflictError`, `TooManyRequestsError`, `InternalServerError` and so on, all under the `Arcmira` namespace. `err.statusCode` is the status and `err.body.error` is the API's error object: `type`, `code`, `message`, `doc_url`, `request_id`, and on a plan gate `gate` and `unlock.url`. Switch on `type` and `gate` first; `code` is a string whose catalog is in the [errors page](https://arcmira.com/docs/errors).
+Every non-2xx answer throws a subclass of `ArcmiraError` named for the status: `BadRequestError`, `UnauthorizedError`, `PaymentRequiredError`, `ForbiddenError`, `NotFoundError`, `ConflictError`, `TooManyRequestsError`, `InternalServerError` and so on, all under the `Arcmira` namespace. `err.statusCode` is the status and `err.body.error` is the API's error object: `type`, `code`, `message`, `doc_url`, `request_id`, on a plan gate `gate` and `unlock.url`, and on a few codes `details` (`quote` on a priced refusal, `existing_id` on a duplicate follow). The envelope is `{ error }` alone. Switch on `type` and `gate` first; `code` is a string whose catalog is in the [errors page](https://arcmira.com/docs/errors).
 
 ### Options
 
@@ -109,15 +124,17 @@ Every non-2xx answer throws a subclass of `ArcmiraError` named for the status: `
 
 ## Command line
 
-The package ships the `arcmira` binary. Its data commands mirror the tools of the [Arcmira MCP server](https://github.com/arcmira/mcp), so a workflow you prototype with an agent runs the same from a shell.
+The package ships the `arcmira` binary. Its commands mirror the client of the [Arcmira MCP server](https://github.com/arcmira/mcp), so a workflow you prototype with an agent runs the same from a shell.
 
 ```sh
 npx arcmira login you@example.com                 # emails a six digit code
 npx arcmira login you@example.com --code 482913   # saves the key; later commands need no ARCMIRA_API_KEY
 npx arcmira whoami
-npx arcmira resolve Ramp
+npx arcmira resolve Ramp                          # ent_14  organization  Ramp
+npx arcmira mentions --entity ent_14 --after 2026-09-01 --before 2026-10-01
 npx arcmira search "agent payments" --limit 3
-npx arcmira sponsors TBPN
+npx arcmira resolve TBPN --type channel           # the UC id: arcmira sponsors UC-DRzaGnL_vtBUpCFH5M0tg
+npx arcmira follow Ramp --type org
 npx arcmira api GET /v1/mentions -f entity_id=ent_14 --paginate
 ```
 
@@ -152,23 +169,33 @@ Arcmira changes weekly. Three parts keep you current:
 ### Commands
 
 ```text
-Data commands (they mirror the MCP tools)
-  arcmira search <query>              spoken transcript slices for a topic or phrase; --about, --by (ids) and --kind filter them
+Data commands (they mirror the MCP client; filters take ids, arcmira resolve finds them)
+  arcmira search <query>              spoken transcript passages for a topic or phrase; --about, --by, --entity (ent_ ids), --channel (UC ids), --kind
   arcmira resolve <name>              a name to one entity id: the best match, an assumed pick, or options; --context settles close calls
-  arcmira mentions --entity <id|name> where an entity was mentioned, newest first
-  arcmira momentum <id|name>...       7 and 30 day volume for one to four entities
-  arcmira sponsors <channel>          recurring sponsors of a YouTube channel
-  arcmira recommendations <id|name>   who recommends an entity on air, paid or organic
-  arcmira episodes <channel>          newest indexed videos of a channel
-  arcmira transcripts get <video>     full transcript of one YouTube video
-  arcmira transcripts quote <video>   free whole-video quote
-  arcmira transcripts request <video> --max-rows N --idempotency-key KEY [--max-on-demand-cents N]
-  arcmira transcripts status <id>     state of a transcript request, with the next poll time
+  arcmira mentions --entity <ent_id>  where an entity was mentioned, newest first
+  arcmira momentum <ent_id>...        7 and 30 day volume for one to four entities
+  arcmira sponsors <UC id>            recurring sponsors of a YouTube channel
+  arcmira recommendations <ent_id>    who recommends an entity on air: --kind sponsored, organic, mention or all
+  arcmira episodes <UC id>            newest indexed videos of a channel
+  arcmira transcripts get <video>     full transcript of one YouTube video; --quality premium buys it within your plan
+  arcmira transcripts quote <video>   free whole-video Premium price
   arcmira occurrences --channel ...   ranked counts of the entities a set of channels or videos mention
-  arcmira status [channel]            your plan, or a channel's coverage
+  arcmira status [UC id]              your plan, or a channel's coverage
+
+Follow and alert (these change the account)
+  arcmira trackers create <name> --type T   follow an exact name; --type person, organization (or org), product, topic, or channel with a UC id
+  arcmira trackers list                     every followed name
+  arcmira monitors list                     monitors with tracker and alert counts
+  arcmira monitors create <name> --frequency realtime|hourly|daily [--email ...] [--webhook-url URL] [--slack-integration ID --slack-channel ID]
+  arcmira monitors update <id> [--name] [--frequency] [--pause|--resume] ...
+  arcmira monitors trackers <id>            the names one monitor follows
+  arcmira monitors add <id> <ent_id>...     follow indexed entities by id on a monitor
+  arcmira monitors attach <id> <trk_id>...  move existing trackers onto a monitor
+  arcmira integrations slack                connected Slack workspaces and channels
 
 Aliases
-  arcmira transcript <video>          same as arcmira transcripts get (the MCP tool get_transcript)
+  arcmira transcript <video>          same as arcmira transcripts get (the MCP client's transcript)
+  arcmira follow <name> --type T      same as arcmira trackers create
 
 Account
   arcmira setup [--only agent]        connect the MCP server and skills to your coding agents, updates on
@@ -187,24 +214,25 @@ Any endpoint
   arcmira examples                    worked examples, resolve first then filter by id
 
 Not available yet (each prints the arcmira api call that does the same, and exits 2)
-  arcmira monitors, arcmira trackers, arcmira corrections, arcmira feedback, arcmira keys
+  arcmira feedback, arcmira keys
 
 Also: arcmira help [command], --help, --version
 ```
 
-Commands that take an `ent_` or `UC` id also take a name or `@handle`; the CLI resolves it first (one extra call to `GET /v1/entities/resolve`) and says what it picked on stderr. A suggested pick is used and stated as an assumption with its reason. An ambiguous name exits 2 and lists the options with their ids.
+Reads take ids. `--entity`, `--about`, `--by` and every entity positional take an `ent_` id; `--channel` and every channel positional take a YouTube channel id (`UC` plus 22 characters). A name or `@handle` there exits 2 before any request, with the `arcmira resolve` command that finds the id. Follows are the one place a name belongs: `arcmira follow Ramp --type org` watches the exact name, matched case-insensitively in newly analyzed media, and works before Arcmira has indexed it. A channel is followed by its UC id.
 
-`arcmira transcripts get <video> --quality premium --wait` reads Premium, prepares it from included credits when your account does not own it yet (one keyless `POST /v1/transcriptions`, no money moves), waits for the job, and prints the transcript. `--timeout S` bounds the wait (default 300). Without `--wait`, a read never buys: when Premium needs preparing, the CLI exits 3 and prints the `--wait` command to run on stderr, and a job still running exits 4. With `--json` the API body is still printed on stdout, so `arcmira transcripts get X --quality premium --json | jq` fails on the exit code under `set -o pipefail`.
+Every dated command takes `--after` (inclusive) and `--before` (exclusive), as a date or an ISO 8601 datetime with an offset, read in UTC. September is `--after 2026-09-01 --before 2026-10-01`.
 
-`arcmira transcripts request` posts the same keyless purchase without waiting and prints the job. To spend on-demand money, pass the cents you approve with `--max-on-demand-cents`, plus `--max-rows` and a previously saved `--idempotency-key`; retry an unknown response with the same key and identical input. Whole-video pricing applies even when you later read a small window.
+`arcmira transcripts get <video> --quality premium` is one read. When your account does not own the transcript, the read buys it within your plan (included credits, then your on-demand budget) and exits 4 while it transcribes, naming the minutes left on stderr. Run the same command again later: it reads the same job and never buys twice. When the last purchase failed it exits 1 and names the error; add `--retry` to buy it again. A plan that cannot pay exits 1 and prints the quote. With `--json` the API body is still printed on stdout, so `arcmira transcripts get X --quality premium --json | jq` fails on the exit code under `set -o pipefail`.
 
-`arcmira api` follows `gh api`: `-f` adds a string parameter and `-F` a typed one (`true`, `false`, `null`, numbers, `@file`, `key[]=value`). They go to the query string on GET and DELETE, and into a JSON body otherwise. For `POST /v1/transcriptions`, pass your saved key with `-H 'Idempotency-Key: ...'`. Other POST requests generate a key when none is supplied; `--verbose` shows it. Reuse the same key and input to retry a write. The path may drop the `/v1` prefix.
+`arcmira api` follows `gh api`: `-f` adds a string parameter and `-F` a typed one (`true`, `false`, `null`, numbers, `@file`, `key[]=value`). They go to the query string on GET and DELETE, and into a JSON body otherwise. A POST without `-H 'Idempotency-Key: ...'` gets a generated key; `--verbose` shows it. Reuse the same key and input to retry a write. The path may drop the `/v1` prefix.
 
 - Key: `--key`, then `ARCMIRA_API_KEY`, then the key `arcmira login` saved in `~/.config/arcmira/config.json` (mode 0600; `XDG_CONFIG_HOME` is honored). `arcmira login --key arc_sk_...` saves a key you already have; `arcmira logout` deletes it.
 - Output: data on stdout, notes and errors on stderr, no colour. `--json` prints the API response unchanged on stdout; on failure it prints `{"error":{"type","code","message","request_id",...}}` on stderr, the API's own error body or a `usage_error` in the same shape.
 - Errors: every API error names its `request_id` (quote it to support). A 401 adds `try: arcmira login`.
-- Paging: `mentions` and `recommendations` take `--cursor`; the next page's command is printed on stderr, and `next_cursor` is in `--json`. `arcmira api --paginate` follows every page.
-- Exit codes: 0 ok, 1 an API or network error (the message names the code and any unlock link), 2 a usage error (bad input, no key, an unresolved name, a command or flag not available yet), 3 Premium needs preparing (stderr names the `--wait` command), 4 Premium is still pending (the job keeps running; run the same command again). Input is checked before any request.
+- Paging: `mentions`, `recommendations` and `episodes` take `--cursor`; the next page's command is printed on stderr, and `next_cursor` is in `--json`. `arcmira api --paginate` follows every page.
+- Exit codes: 0 ok, 1 an API or network error (the message names the code, any unlock link, and the quote on a priced refusal), 2 a usage error (bad input, a name where an id belongs, no key, a command or flag not available yet or retired), 4 Premium is still transcribing (run the same command again later). Input is checked before any request. Exit 3 is retired with Premium preparation.
+- Writes (`trackers create`, `monitors create|update|add|attach`) send a fresh `Idempotency-Key`, so the CLI's one retry never applies a write twice.
 - Reserved flags: `--dry-run`, `--force`, `-y`/`--yes`, `--profile` and `--jq` exit 2 in this version outside `arcmira setup`; their names are held for write commands to come.
 - Requests carry `User-Agent: arcmira-cli/<version>`. The SDK used on its own sends `arcmira/<version>`.
 - Telemetry: none. The CLI sends only the API requests you ask for, plus a docs search when you run `arcmira docs <query>`.
@@ -223,7 +251,7 @@ Commands that take an `ent_` or `UC` id also take a name or `@handle`; the CLI r
 
 ## Development
 
-`src/` is generated from the Arcmira OpenAPI document by [Fern](https://github.com/fern-api/fern); do not edit it by hand, a regeneration overwrites it. The one exception is `src/wrapper/`, which holds `transcripts.prepareAndWait`; the installer keeps it and points `src/index.ts` at its `ArcmiraClient`. `cli/`, `tests/` and this file are hand-written. `npm test` builds and runs the tests against a local fake of the API (`tests/fake-v1.mjs`, bodies in `tests/fixtures/v1.json`).
+`src/` is generated from the Arcmira OpenAPI document by [Fern](https://github.com/fern-api/fern); do not edit it by hand, a regeneration overwrites it. `cli/` (except `cli/operations.ts`), `tests/` and this file are hand-written. `npm test` builds and runs the tests against a local fake of the API (`tests/fake-v1.mjs`, bodies in `tests/fixtures/v1.json`).
 
 ## License
 
@@ -233,17 +261,8 @@ Apache-2.0. See [LICENSE](./LICENSE).
 
 Run `npm run generate -- <path to arcmira-v1.json>` with Node 22 or newer, Python 3, Docker, and Fern access for the `arcmira` organization. It vendors the spec into `fern/openapi.json` (omit the path to reuse the vendored copy), pins Fern CLI 5.131.1 and TypeScript generator 3.96.0, disables CLI version redirection and telemetry, and regenerates `src/`, `reference.md` and `cli/operations.ts`.
 
-The overlay combines success schemas into a `state` union, preserves existing method names, and discovers cursor collections from their schemas. Unknown or ambiguous collections fail generation. An exact checked patch keeps request timer cleanup in `finally` until the pinned generator includes the fix. Generated source is never edited by hand.
+`fern/method-names.json` names the SDK group and method of every operation by its `operationId`; an operation it does not name, or a name for an operation the spec lacks, fails generation. The overlay combines success schemas into a `state` union and discovers cursor collections from their schemas. The installer rewrites the `exports` map in `package.json` from the generated resources. Unknown or ambiguous collections fail generation. An exact checked patch keeps request timer cleanup in `finally` until the pinned generator includes the fix. Generated source is never edited by hand.
 
 Run `npm test` for the SDK and CLI tests, and `npm run test:types` for the consumer type contract. Tests use local HTTP fixtures and do not purchase transcripts.
 
-## Migrate from 0.2
-
-`transcripts.get` returns `TranscriptResult`. Narrow on `state` before accessing transcript lines. Use `.withRawResponse()` for HTTP status and headers. `transcripts.request` takes `video_id` and answers `{ job, existing }`. `channels.videos.list` and `transcripts.listRequests` return pages: iterate them with `for await`, or read `page.response` for the list body. See [CHANGELOG.md](./CHANGELOG.md).
-
-```ts
-const { data, rawResponse } = await client.transcripts.get({ video_id: "dQw4w9WgXcQ", quality: "premium" }).withRawResponse();
-if (data.state === "ready") console.log(data.lines);
-else if (data.state === "pending") console.log(data.job.status_url, data.job.next_poll_seconds, rawResponse.status);
-else console.log(data.quote, data.action);
-```
+Upgrading from 0.3: see [CHANGELOG.md](./CHANGELOG.md) for every removed method and its replacement.

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "arcmira",
-        "X-Fern-SDK-Version": "0.3.0",
-        "User-Agent": "arcmira/0.3.0",
+        "X-Fern-SDK-Version": "0.4.0",
+        "User-Agent": "arcmira/0.4.0",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/cjs/Client.d.ts

@@ -1,17 +1,12 @@
 import { ChannelsClient } from "./api/resources/channels/client/Client.js";
-import { CorrectionsClient } from "./api/resources/corrections/client/Client.js";
 import { EntitiesClient } from "./api/resources/entities/client/Client.js";
 import { FeedbackClient } from "./api/resources/feedback/client/Client.js";
 import { HealthClient } from "./api/resources/health/client/Client.js";
+import { IntegrationsClient } from "./api/resources/integrations/client/Client.js";
 import { MeClient } from "./api/resources/me/client/Client.js";
 import { MentionsClient } from "./api/resources/mentions/client/Client.js";
 import { MonitorsClient } from "./api/resources/monitors/client/Client.js";
-import { OrganizationsClient } from "./api/resources/organizations/client/Client.js";
-import { PeopleClient } from "./api/resources/people/client/Client.js";
-import { ProductsClient } from "./api/resources/products/client/Client.js";
 import { RecommendationsClient } from "./api/resources/recommendations/client/Client.js";
-import { TeamClient } from "./api/resources/team/client/Client.js";
-import { TopicsClient } from "./api/resources/topics/client/Client.js";
 import { TrackersClient } from "./api/resources/trackers/client/Client.js";
 import { TranscriptsClient } from "./api/resources/transcripts/client/Client.js";
 import type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.js";
@@ -32,14 +27,9 @@ export declare class ArcmiraClient {
     protected _feedback: FeedbackClient | undefined;
     protected _transcripts: TranscriptsClient | undefined;
     protected _channels: ChannelsClient | undefined;
-    protected _people: PeopleClient | undefined;
-    protected _topics: TopicsClient | undefined;
-    protected _organizations: OrganizationsClient | undefined;
-    protected _products: ProductsClient | undefined;
     protected _monitors: MonitorsClient | undefined;
     protected _trackers: TrackersClient | undefined;
-    protected _team: TeamClient | undefined;
-    protected _corrections: CorrectionsClient | undefined;
+    protected _integrations: IntegrationsClient | undefined;
     constructor(options?: ArcmiraClient.Options);
     get health(): HealthClient;
     get me(): MeClient;
@@ -49,14 +39,9 @@ export declare class ArcmiraClient {
     get feedback(): FeedbackClient;
     get transcripts(): TranscriptsClient;
     get channels(): ChannelsClient;
-    get people(): PeopleClient;
-    get topics(): TopicsClient;
-    get organizations(): OrganizationsClient;
-    get products(): ProductsClient;
     get monitors(): MonitorsClient;
     get trackers(): TrackersClient;
-    get team(): TeamClient;
-    get corrections(): CorrectionsClient;
+    get integrations(): IntegrationsClient;
     /**
      * Make a passthrough request using the SDK's configured auth, retry, logging, etc.
      * This is useful for making requests to endpoints not yet supported in the SDK.

package/dist/cjs/Client.js

@@ -45,21 +45,16 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ArcmiraClient = void 0;
 const Client_js_1 = require("./api/resources/channels/client/Client.js");
-const Client_js_2 = require("./api/resources/corrections/client/Client.js");
-const Client_js_3 = require("./api/resources/entities/client/Client.js");
-const Client_js_4 = require("./api/resources/feedback/client/Client.js");
-const Client_js_5 = require("./api/resources/health/client/Client.js");
+const Client_js_2 = require("./api/resources/entities/client/Client.js");
+const Client_js_3 = require("./api/resources/feedback/client/Client.js");
+const Client_js_4 = require("./api/resources/health/client/Client.js");
+const Client_js_5 = require("./api/resources/integrations/client/Client.js");
 const Client_js_6 = require("./api/resources/me/client/Client.js");
 const Client_js_7 = require("./api/resources/mentions/client/Client.js");
 const Client_js_8 = require("./api/resources/monitors/client/Client.js");
-const Client_js_9 = require("./api/resources/organizations/client/Client.js");
-const Client_js_10 = require("./api/resources/people/client/Client.js");
-const Client_js_11 = require("./api/resources/products/client/Client.js");
-const Client_js_12 = require("./api/resources/recommendations/client/Client.js");
-const Client_js_13 = require("./api/resources/team/client/Client.js");
-const Client_js_14 = require("./api/resources/topics/client/Client.js");
-const Client_js_15 = require("./api/resources/trackers/client/Client.js");
-const Client_js_16 = require("./api/resources/transcripts/client/Client.js");
+const Client_js_9 = require("./api/resources/recommendations/client/Client.js");
+const Client_js_10 = require("./api/resources/trackers/client/Client.js");
+const Client_js_11 = require("./api/resources/transcripts/client/Client.js");
 const BaseClient_js_1 = require("./BaseClient.js");
 const core = __importStar(require("./core/index.js"));
 class ArcmiraClient {
@@ -68,7 +63,7 @@ class ArcmiraClient {
     }
     get health() {
         var _a;
-        return ((_a = this._health) !== null && _a !== void 0 ? _a : (this._health = new Client_js_5.HealthClient(this._options)));
+        return ((_a = this._health) !== null && _a !== void 0 ? _a : (this._health = new Client_js_4.HealthClient(this._options)));
     }
     get me() {
         var _a;
@@ -76,7 +71,7 @@ class ArcmiraClient {
     }
     get entities() {
         var _a;
-        return ((_a = this._entities) !== null && _a !== void 0 ? _a : (this._entities = new Client_js_3.EntitiesClient(this._options)));
+        return ((_a = this._entities) !== null && _a !== void 0 ? _a : (this._entities = new Client_js_2.EntitiesClient(this._options)));
     }
     get mentions() {
         var _a;
@@ -84,51 +79,31 @@ class ArcmiraClient {
     }
     get recommendations() {
         var _a;
-        return ((_a = this._recommendations) !== null && _a !== void 0 ? _a : (this._recommendations = new Client_js_12.RecommendationsClient(this._options)));
+        return ((_a = this._recommendations) !== null && _a !== void 0 ? _a : (this._recommendations = new Client_js_9.RecommendationsClient(this._options)));
     }
     get feedback() {
         var _a;
-        return ((_a = this._feedback) !== null && _a !== void 0 ? _a : (this._feedback = new Client_js_4.FeedbackClient(this._options)));
+        return ((_a = this._feedback) !== null && _a !== void 0 ? _a : (this._feedback = new Client_js_3.FeedbackClient(this._options)));
     }
     get transcripts() {
         var _a;
-        return ((_a = this._transcripts) !== null && _a !== void 0 ? _a : (this._transcripts = new Client_js_16.TranscriptsClient(this._options)));
+        return ((_a = this._transcripts) !== null && _a !== void 0 ? _a : (this._transcripts = new Client_js_11.TranscriptsClient(this._options)));
     }
     get channels() {
         var _a;
         return ((_a = this._channels) !== null && _a !== void 0 ? _a : (this._channels = new Client_js_1.ChannelsClient(this._options)));
     }
-    get people() {
-        var _a;
-        return ((_a = this._people) !== null && _a !== void 0 ? _a : (this._people = new Client_js_10.PeopleClient(this._options)));
-    }
-    get topics() {
-        var _a;
-        return ((_a = this._topics) !== null && _a !== void 0 ? _a : (this._topics = new Client_js_14.TopicsClient(this._options)));
-    }
-    get organizations() {
-        var _a;
-        return ((_a = this._organizations) !== null && _a !== void 0 ? _a : (this._organizations = new Client_js_9.OrganizationsClient(this._options)));
-    }
-    get products() {
-        var _a;
-        return ((_a = this._products) !== null && _a !== void 0 ? _a : (this._products = new Client_js_11.ProductsClient(this._options)));
-    }
     get monitors() {
         var _a;
         return ((_a = this._monitors) !== null && _a !== void 0 ? _a : (this._monitors = new Client_js_8.MonitorsClient(this._options)));
     }
     get trackers() {
         var _a;
-        return ((_a = this._trackers) !== null && _a !== void 0 ? _a : (this._trackers = new Client_js_15.TrackersClient(this._options)));
-    }
-    get team() {
-        var _a;
-        return ((_a = this._team) !== null && _a !== void 0 ? _a : (this._team = new Client_js_13.TeamClient(this._options)));
+        return ((_a = this._trackers) !== null && _a !== void 0 ? _a : (this._trackers = new Client_js_10.TrackersClient(this._options)));
     }
-    get corrections() {
+    get integrations() {
         var _a;
-        return ((_a = this._corrections) !== null && _a !== void 0 ? _a : (this._corrections = new Client_js_2.CorrectionsClient(this._options)));
+        return ((_a = this._integrations) !== null && _a !== void 0 ? _a : (this._integrations = new Client_js_5.IntegrationsClient(this._options)));
     }
     /**
      * Make a passthrough request using the SDK's configured auth, retry, logging, etc.

package/dist/cjs/api/errors/index.d.ts

@@ -4,7 +4,6 @@ export * from "./ForbiddenError.js";
 export * from "./InternalServerError.js";
 export * from "./NotFoundError.js";
 export * from "./PaymentRequiredError.js";
-export * from "./PreconditionFailedError.js";
 export * from "./ServiceUnavailableError.js";
 export * from "./TooManyRequestsError.js";
 export * from "./UnauthorizedError.js";

package/dist/cjs/api/errors/index.js

@@ -20,7 +20,6 @@ __exportStar(require("./ForbiddenError.js"), exports);
 __exportStar(require("./InternalServerError.js"), exports);
 __exportStar(require("./NotFoundError.js"), exports);
 __exportStar(require("./PaymentRequiredError.js"), exports);
-__exportStar(require("./PreconditionFailedError.js"), exports);
 __exportStar(require("./ServiceUnavailableError.js"), exports);
 __exportStar(require("./TooManyRequestsError.js"), exports);
 __exportStar(require("./UnauthorizedError.js"), exports);

package/dist/cjs/api/resources/channels/client/Client.d.ts

@@ -2,8 +2,6 @@ import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClie
 import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.js";
 import * as core from "../../../../core/index.js";
 import * as Arcmira from "../../../index.js";
-import { GuestsClient } from "../resources/guests/client/Client.js";
-import { RelatedClient } from "../resources/related/client/Client.js";
 import { SponsorsClient } from "../resources/sponsors/client/Client.js";
 import { VideosClient } from "../resources/videos/client/Client.js";
 export declare namespace ChannelsClient {
@@ -15,13 +13,9 @@ export declare class ChannelsClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<ChannelsClient.Options>;
     protected _sponsors: SponsorsClient | undefined;
     protected _videos: VideosClient | undefined;
-    protected _related: RelatedClient | undefined;
-    protected _guests: GuestsClient | undefined;
     constructor(options?: ChannelsClient.Options);
     get sponsors(): SponsorsClient;
     get videos(): VideosClient;
-    get related(): RelatedClient;
-    get guests(): GuestsClient;
     /**
      * How many videos of a YouTube channel are searchable, the newest publish date among them, and the split by transcript source class. Call it when a search or mention lookup came back empty, before telling anyone we do not cover a show, and cite indexed_through as the as-of date for mentions and search_indexed_through for transcript search. It cannot request indexing; channel backfill is not available yet. Free (0 rows). Every gate is a typed error whose error.unlock.url names the plan that lifts it; pass src=mcp-tool only from the Arcmira MCP server.
      *
@@ -44,27 +38,4 @@ export declare class ChannelsClient {
      */
     coverage(request: Arcmira.CoverageChannelsRequest, requestOptions?: ChannelsClient.RequestOptions): core.HttpResponsePromise<Arcmira.ChannelCoverageResponse>;
     private __coverage;
-    /**
-     * Channel pages include a recommendations_summary teaser: sponsor_count for all callers; top_sponsors additionally requires a Pro+ plan.
-     *
-     * @param {Arcmira.GetChannelsRequest} request
-     * @param {ChannelsClient.RequestOptions} requestOptions - Request-specific configuration.
-     *
-     * @throws {@link Arcmira.BadRequestError}
-     * @throws {@link Arcmira.UnauthorizedError}
-     * @throws {@link Arcmira.PaymentRequiredError}
-     * @throws {@link Arcmira.ForbiddenError}
-     * @throws {@link Arcmira.NotFoundError}
-     * @throws {@link Arcmira.TooManyRequestsError}
-     * @throws {@link Arcmira.InternalServerError}
-     * @throws {@link errors.ArcmiraError}
-     * @throws {@link errors.ArcmiraTimeoutError}
-     *
-     * @example
-     *     await client.channels.get({
-     *         slug: "slug"
-     *     })
-     */
-    get(request: Arcmira.GetChannelsRequest, requestOptions?: ChannelsClient.RequestOptions): core.HttpResponsePromise<Arcmira.ChannelPageResponse>;
-    private __get;
 }