@madewithremy/admin 0.1.51 → 0.1.53

package/CHANGELOG.md

@@ -4,6 +4,28 @@ What changed in `@madewithremy/admin`, newest first, each version under its own
 
 Versions before 0.1.44 aren't recorded here.
 
+## 0.1.53
+
+### Changed behavior
+
+- `remy-admin voice numbers buy` (`admin.voice.numbersBuy`) buys a number for an app that already has one: an app can hold several, one per tenant say, and app code can buy, list and release them through `createAdminClient`. The limit is the workspace's, 10 numbers across its apps unless support raised it, and a buy past it is refused with `phone_number_limit_reached` (422). `number_already_assigned` is gone, so code that branched on it should branch on `phone_number_limit_reached` instead.
+
+### Fixed
+
+- The voice ops' docs give `number_unavailable`, `telnyx_not_configured`, `order_in_progress` and `number_not_active` their real status, 412.
+
+## 0.1.52
+
+### New
+
+- `remy-admin apps list [--search <words>] [--status draft|published]` (`admin.apps.list`): the workspace's apps, last active first, each with its `appId`, `name`, `subdomain`, `isPublished`, `lastDeployedAt` and `createdBy`. It lists every published app and your own drafts. `--search` keeps the apps whose name or subdomain contains every word, so an app the user names can be found for `issues create --app <appId>` without asking for its id.
+- `remy-admin releases wait` on a release that went live returns `primaryUrl`, the address the app is served on: its live custom domain, else its platform subdomain, else its id's own host. `remy-admin releases current` (`admin.releases.dashboardLive`) returns it too.
+- `remy-admin email domains list` (`admin.email.listDomains('sending')`) returns `effectiveSender.anyRecipient`. It's false on the platform's shared address, which only mails the app's verified users and its workspace's members, in dev and live alike, and refuses anyone else with `unverified_recipients`. A subdomain or a verified sending domain lifts it.
+
+### Changed behavior
+
+- `remy-admin domains check` returns `reason` beside `isAvailable`: `reserved` (the platform's own, never any app's), `taken` (another app has it) or `invalid`, and null when the subdomain is available. `domains set` refuses with the same codes as before, `subdomain_not_allowed` or `unavailable`, and its message now says which case applies. Code that matched either message's text should match the code instead.
+
 ## 0.1.51
 
 ### Changed behavior

package/dist/index.d.ts

@@ -295,7 +295,7 @@ interface TasksListParams {
  * const { traces } = await admin.tasks.list({ limit: 10 });
  * const broken = traces.filter((t) => t.outcome !== 'answered' || t.toolErrorCount > 0);
  */
-declare function list$c(ctx: AdminContext, params?: TasksListParams): Promise<TasksListResult>;
+declare function list$d(ctx: AdminContext, params?: TasksListParams): Promise<TasksListResult>;
 /**
  * One task with its full transcript: the prompt and tools it was given, its
  * input, each turn's reply and reasoning, and every tool call with what came
@@ -316,7 +316,7 @@ declare function get$9(ctx: AdminContext, traceId: string): Promise<TasksGetResu
 
 type tasks_TasksListParams = TasksListParams;
 declare namespace tasks {
-  export { get$9 as get, list$c as list };
+  export { get$9 as get, list$d as list };
   export type { tasks_TasksListParams as TasksListParams };
 }
 
@@ -725,6 +725,85 @@ declare namespace analytics {
   export type { analytics_AiSourcesParams as AiSourcesParams, analytics_CrawlersParams as CrawlersParams, analytics_MapParams as MapParams, analytics_SourcesParams as SourcesParams };
 }
 
+/**
+ * Response shapes for the apps command group — transcribed from the api.
+ *
+ * Sources (apps/api/src/):
+ *   roles/http/routes/Apps/create.ts (GET /_internal/v2/apps)
+ *   customerApps/AppRecord/dao/AppRecordDao.ts (AppListItem)
+ */
+/** One page of GET /_internal/v2/apps: the workspace's apps, last active first. */
+interface AppsListPage {
+    apps: Array<{
+        appId: string;
+        name: string;
+        isPublished: boolean;
+        lastDeployedAt: string | null;
+        /** Public (hyphenated) platform subdomain, or null if unset. */
+        customSubdomain: string | null;
+        createdBy: {
+            userId: string;
+            name: string;
+        };
+    }>;
+    nextCursor: string | null;
+}
+/** An app in the workspace, as `apps list` shows it. */
+interface WorkspaceApp {
+    appId: string;
+    name: string;
+    /** Its platform subdomain (`<subdomain>.<apex>`), or null if it has none. */
+    subdomain: string | null;
+    /** Whether it has a live release; a draft is listed only to its creator. */
+    isPublished: boolean;
+    lastDeployedAt: string | null;
+    /** Who made it. */
+    createdBy: string;
+}
+/** apps list */
+interface AppsListResult {
+    apps: WorkspaceApp[];
+}
+
+/**
+ * Apps operations: the other apps in this app's workspace.
+ *
+ * Ops are pure: (ctx, params) → typed result, throwing AdminApiError /
+ * AdminTimeoutError. No printing, no process coupling — the CLI skin in
+ * commands/apps.ts and the importable client both call these.
+ */
+
+interface AppsListParams {
+    /**
+     * Words an app's name or subdomain must all contain, in any case: `remy
+     * marketing` finds "Remy Marketing site".
+     */
+    search?: string;
+    /** `published` (has a live release) or `draft`. Default: both. */
+    status?: 'draft' | 'published';
+}
+/**
+ * The workspace's apps, last active first: every published app, and the
+ * drafts of the person this key belongs to (another member's draft isn't
+ * listed). An app's `appId` is what `issues --app` and `forApp` take.
+ *
+ * The list route doesn't search, so this reads every page and matches here,
+ * as the editor's app list does in the browser.
+ *
+ * @throws AdminApiError `invalid_status` (400) — status is not `draft` or
+ *   `published`.
+ * @example
+ * const { apps } = await admin.apps.list({ search: 'marketing' });
+ * const marketing = admin.forApp(apps[0].appId);
+ */
+declare function list$c(ctx: AdminContext, params?: AppsListParams): Promise<AppsListResult>;
+
+type apps_AppsListParams = AppsListParams;
+declare namespace apps {
+  export { list$c as list };
+  export type { apps_AppsListParams as AppsListParams };
+}
+
 /**
  * Response types for the v2 app-events observability endpoints.
  *
@@ -4531,6 +4610,12 @@ interface DomainsCheckResult {
     /** Normalized (public hyphenated) form of the requested subdomain. */
     subdomain: string;
     isAvailable: boolean;
+    /**
+     * Why it isn't available, or null when it is: `reserved` (the platform's,
+     * never any app's), `taken` (another app has it) or `invalid` (not 1 to 63
+     * letters, digits and hyphens, or shaped like an app's ID).
+     */
+    reason: 'invalid' | 'reserved' | 'taken' | null;
 }
 /** GET /_internal/v2/apps/:appId/settings/custom-domains */
 interface DomainsCustomListResult {
@@ -5233,6 +5318,13 @@ interface EmailEffectiveSender {
     tier: EmailSenderTier;
     /** Null for the `default` platform tier. */
     domain: string | null;
+    /**
+     * Whether the app can mail any address. False on the shared platform address
+     * (the `default` tier), which only mails the app's verified users and its
+     * workspace's members and refuses anyone else with `unverified_recipients`; a
+     * subdomain or a verified sending domain lifts it.
+     */
+    anyRecipient: boolean;
 }
 /** email list → GET /outbound-email/messages */
 interface EmailListResult {
@@ -7195,7 +7287,8 @@ interface ReleasesGetResult extends ReleaseFailureFields {
 }
 /**
  * Response from GET /_internal/v2/apps/:appId/releases/by-commit/:sha.
- * Plain release row — no databases/diff enrichment — plus previewUrl.
+ * Plain release row — no databases/diff enrichment — plus previewUrl and
+ * primaryUrl.
  * Used by 'releases wait', which polls this endpoint in a loop.
  */
 interface ReleasesByCommitResult extends ReleaseFailureFields {
@@ -7228,6 +7321,12 @@ interface ReleasesByCommitResult extends ReleaseFailureFields {
      * Synthesised synchronously from the release id by buildPreviewUrl().
      */
     previewUrl: string | null;
+    /**
+     * The address the app is served on when status is 'live' (its live custom
+     * domain, else its platform subdomain, else its id's own host; ends in a
+     * slash); null otherwise.
+     */
+    primaryUrl: string | null;
     /**
      * The data sources this release declares app code for. A live release's
      * reader entries carry `readerUnread`: the source's documents its reader
@@ -7820,13 +7919,16 @@ declare function byCommit(ctx: AdminContext, commitSha: string): Promise<{
 }>;
 /**
  * The currently-live release, or null when the app has never been published.
- * Fetched from the dashboard endpoint — same source as `releases current`.
+ * Fetched from the dashboard endpoint — same source as `releases current` —
+ * with the address it's served on as `primaryUrl` (see `primaryUrl` below).
  *
  * @example
  * const live = await admin.releases.dashboardLive();
- * if (live) console.log(live.commitSha, live.publishedAt);
+ * if (live) console.log(live.commitSha, live.publishedAt, live.primaryUrl);
  */
-declare function dashboardLive(ctx: AdminContext): Promise<DashboardLiveRelease | null>;
+declare function dashboardLive(ctx: AdminContext): Promise<(DashboardLiveRelease & {
+    primaryUrl: string;
+}) | null>;
 /**
  * The URL the app is served on, as the platform resolves it: its live custom
  * domain, then its platform subdomain, then its id's own host. Ends in a slash.
@@ -7841,8 +7943,9 @@ declare function primaryUrl(ctx: AdminContext): Promise<string>;
  *
  * `previewUrl` is present for a feature-branch build (status 'preview') and is
  * where that build is actually reachable — gated to anyone who can open the app
- * in Remy. Reported as data rather than taught as a URL shape, so the caller
- * never has to construct one.
+ * in Remy. `primaryUrl` is present for a live one: the address the app is
+ * served on. Both are reported as data rather than taught as a URL shape, so
+ * the caller never has to construct one.
  */
 interface ReleaseSummary {
     releaseId: string;
@@ -7852,6 +7955,11 @@ interface ReleaseSummary {
     buildDurationMs: number | null;
     publishedAt: string | null;
     previewUrl?: string;
+    /**
+     * Where the live app is served: its live custom domain, then its platform
+     * subdomain, then its id's own host. Only present when status is `live`.
+     */
+    primaryUrl?: string;
     /** Why it failed; only present when status is `failed`. */
     error?: string;
     /**
@@ -8780,7 +8888,7 @@ interface NumbersSearchParams {
  *
  * @throws AdminApiError `missing_search_filter` (400) — neither areaCode nor
  *   locality provided; `invalid_area_code` (400) — area code is not 3 digits;
- *   `telnyx_not_configured` (422) — phone numbers are not available on this
+ *   `telnyx_not_configured` (412) — phone numbers are not available on this
  *   platform host.
  * @example
  * const { results } = await admin.voice.numbersSearch({ areaCode: '310', limit: 5 });
@@ -8798,17 +8906,21 @@ interface NumbersBuyParams {
 }
 /**
  * Buy and attach a dedicated phone number to the app ($1/month billed to the
- * workspace starting immediately — always confirm with the user before calling).
+ * workspace starting immediately — an agent acting for the user always
+ * confirms with them first).
  *
- * The number is both the outbound caller-ID for `voice.call()` and the app's
- * inbound line. A `pending` status usually activates within seconds; poll
- * `numbersList` to confirm. One number per app in v1 — release before switching.
+ * The number is an inbound line to the app's voice agent and a caller ID for
+ * `voice.call()`. An app can hold several, one per tenant say, up to its
+ * workspace's limit (10 unless support raised it), and app code can buy and
+ * release them with this client. A `pending` status usually activates within
+ * seconds; poll `numbersList` to confirm.
  *
  * @throws AdminApiError `invalid_phone_number` (400) — not a valid +1 E.164
- *   US number; `number_already_assigned` (422) — this app already has a live
- *   number; `number_unavailable` (422) — the number is no longer available;
- *   `insufficient_credits/*` (402) — the workspace can't cover it;
- *   `telnyx_not_configured` (422) — phone numbers unavailable on this host.
+ *   US number; `phone_number_limit_reached` (422) — the workspace holds as
+ *   many numbers as it may; `number_unavailable` (412) — the number is no
+ *   longer available; `insufficient_credits/*` (402) — the workspace can't
+ *   cover it; `telnyx_not_configured` (412) — phone numbers unavailable on
+ *   this host.
  * @example
  * const { number } = await admin.voice.numbersBuy({
  *   phoneNumber: '+13105551234',
@@ -8822,13 +8934,14 @@ declare function numbersBuy(ctx: AdminContext, params: NumbersBuyParams): Promis
  * Release a dedicated phone number from the app (permanent).
  *
  * The monthly rental stops immediately (no refund for the current month),
- * the carrier quarantines the number for ~15 days, and both inbound calls
- * and outbound `voice.call()` stop working until a new number is attached.
+ * the carrier quarantines the number for ~15 days, and the number stops
+ * ringing the app and can't be a `voice.call()` caller ID. The app's other
+ * numbers are unaffected.
  *
  * @param e164 The phone number in E.164 or bare 10-digit US format.
  * @throws Error `No phone number "${e164}" on this app` when not found;
  *   AdminApiError `number_not_found` (404) if the resolved id has gone stale;
- *   `order_in_progress` (422) — the purchase is still settling, try again in
+ *   `order_in_progress` (412) — the purchase is still settling, try again in
  *   a minute.
  * @example
  * await admin.voice.numbersRelease('+13105551234');
@@ -8845,7 +8958,7 @@ declare function numbersRelease(ctx: AdminContext, e164: string): Promise<VoiceN
  * @param displayName 1–15 character CNAM string, or `""` to remove the listing.
  * @throws Error `No phone number "${e164}" on this app` when not found;
  *   AdminApiError `number_not_found` (404) if the resolved id has gone stale;
- *   `number_not_active` (422) — the number must be active before setting a
+ *   `number_not_active` (412) — the number must be active before setting a
  *   display name; `invalid_display_name` (400) — value is not 1–15 letters,
  *   numbers, or spaces.
  * @example
@@ -8959,6 +9072,7 @@ declare function buildClient(ctx: AdminContext): {
     agent: BoundOps<typeof agent>;
     tasks: BoundOps<typeof tasks>;
     analytics: BoundOps<typeof analytics>;
+    apps: BoundOps<typeof apps>;
     events: BoundOps<typeof appEvents>;
     crashes: BoundOps<typeof crashes>;
     cron: BoundOps<typeof cron>;
@@ -9048,4 +9162,4 @@ declare class AdminTimeoutError extends Error {
 declare const admin: AdminClient;
 
 export { AdminApiError, AdminTimeoutError, admin, createAdminClient, admin as default };
-export type { AdminClient, AdminClientOptions, AdminContext, AgentThreadDetail, AgentThreadListItem, AgentThreadsGetResult, AgentThreadsListResult, AgentToolCall, AgentTranscriptMessage, AgentTurnError, AnalyticsAiHostRow, AnalyticsAiSourcesResult, AnalyticsAiVendorRow, AnalyticsBatchResult, AnalyticsCrawlersOverviewResult, AnalyticsCrawlersRecentResult, AnalyticsCrawlersRecentRow, AnalyticsCrawlersResult, AnalyticsCrawlersTimeseriesBucket, AnalyticsCrawlersTimeseriesResult, AnalyticsLiveResult, AnalyticsMapPoint, AnalyticsMapResult, AnalyticsMetric, AnalyticsQueryResult, AnalyticsQueryResultRow, AnalyticsSourceRow, AnalyticsSourcesResult, AppCronJobStatus, AppCronJobStatusReason, AppCronRunState, AppEmailSuppression, AppSecretRow, BoughtDomain, CrashGroup, CrashOccurrenceRow, CrashesGetResult, CrashesListResult, CrashesOccurrencesResult, CrashesStatsBucket, CrashesStatsResult, CronJobDecorated, CronOverviewResult, CronRunResult, CronRunSummary, DashboardLiveRelease, DashboardReleaseMethod, DashboardResult, DataLiftFromDevResult, DataLiftFromLiveResult, DataSourceConnector, DataSourceConnectorCredentials, DataSourceConnectorDeletions, DataSourceConnectorGetResult, DataSourceConnectorPolicy, DataSourceConnectorResult, DataSourceInspectReport, DataSourceInspectResult, DataSourceJob, DataSourceJobGetResult, DataSourceJobManifestTokenResult, DataSourceJobPlan, DataSourceJobResult, DataSourceJobSource, DataSourceJobState, DataSourceJobsListResult, DataSourceMapDeployResult, DataSourceMapTestDocument, DataSourceMapTestOutcome, DataSourceMapTestResult, DataSourceMapper, DataSourceObjectSelection, DataSourceQuarantineResult, DataSourceQuarantinedObject, DataSourceReader, DataSourceReaderDeliveries, DataSourceReaderRetryResult, DataSourceReaderStatusResult, DataSourceReaderTestDocument, DataSourceReaderTestResult, DataSourceRemapResult, DataSourceRereadResult, DataSourceSyncResult, DataSourcesBuildProgress, DataSourcesChunkingConfig, DataSourcesChunkingStrategy, DataSourcesConfigResult, DataSourcesConfigUpdateResult, DataSourcesCountResult, DataSourcesCreateResult, DataSourcesDeleteResult, DataSourcesDictionaryPushResult, DataSourcesDictionaryReport, DataSourcesDictionaryStatus, DataSourcesDocument, DataSourcesDocumentConfirmResult, DataSourcesDocumentDeleteManyResult, DataSourcesDocumentDeleteResult, DataSourcesDocumentSelector, DataSourcesDocumentStatus, DataSourcesDocumentsResult, DataSourcesDropResult, DataSourcesEntitiesResult, DataSourcesHydrateResult, DataSourcesHydration, DataSourcesIndex, DataSourcesIngestConfig, DataSourcesIngestUpdate, DataSourcesLinkResult, DataSourcesListEntry, DataSourcesListResult, DataSourcesMigration, DataSourcesMoveResult, DataSourcesPassage, DataSourcesPassagesResult, DataSourcesPlacement, DataSourcesPromoteResult, DataSourcesRelink, DataSourcesRetrievalConfig, DataSourcesRetrievalUpdate, DataSourcesRevectorizeResult, DataSourcesSampleResult, DataSourcesSearchCitation, DataSourcesSearchResult, DataSourcesSearchResultItem, DataSourcesUploadTokenResult, DatasetFile, DbHistoryResult, DbQueryResult, DiagnosticsAuditEnvironment, DiagnosticsDashboardResult, DiagnosticsFinding, DiagnosticsLighthouseScores, DiagnosticsPayload, DiagnosticsReleaseResult, DiagnosticsRuntimeFindings, DomainsCheckResult, DomainsCustomAddResult, DomainsCustomCheckResult, DomainsCustomHostnameUiStatus, DomainsCustomHostnameView, DomainsCustomListResult, DomainsCustomRemoveResult, DomainsCustomRetryResult, DomainsDnsInstructions, DomainsGetResult, DomainsSetResult, EmailBatchLifecycle, EmailBatchResult, EmailBatchSummary, EmailBatchesResult, EmailDomainBase, EmailEffectiveSender, EmailInboxResult, EmailListResult, EmailMessageKind, EmailMessageResult, EmailMessageStatus, EmailSenderTier, EmailSendingStatusResult, EmailStatsResult, EmailSummary, EmailSuppressResult, EmailSuppressionsResult, EmailUnsuppressResult, EvalAggregates, EvalCompareResult, EvalExpectation, EvalQueriesAddResult, EvalQueriesListResult, EvalQuery, EvalQueryResult, EvalQueryStyle, EvalRetrieval, EvalRun, EvalRunResult, EvalRunState, EvalRunsListResult, EvalSet, EvalSetGetResult, EvalSetResult, EvalSetState, EvalSetsListResult, EventChannelActivity, EventsChannelsListResult, EventsPublishResult, EventsTailFrame, FilesDeleteResult, FilesFileMeta, FilesListEntry, FilesListResult, FilesLsResult, FilesScanBadge, FilesScanFlagged, FilesScanStore, FilesStatResult, FilesStoreSummaryEntry, FilesUploadUrlResult, FilesUrlResult, FrontendErrorType, InboundDnsInstructions, InboundEmailDomainAddResult, InboundEmailDomainCheckResult, InboundEmailDomainDeleteResult, InboundEmailDomainUiStatus, InboundEmailDomainVerifyResult, InboundEmailDomainView, InboundEmailDomainsListResult, InboxEmailPreview, IssueAuthorKind, IssueCommentRow, IssueEventType, IssueRow, IssueStatus, IssuesCommentResult, IssuesCreateResult, IssuesDeleteResult, IssuesGetResult, IssuesListResult, IssuesUpdateResult, JewelPairRow, JewelPairSummaryRow, JewelVerdict, JewelsDatasetSummary, JewelsDryrunResult, JewelsExportResult, JewelsGradeResult, JewelsGrading, JewelsOverviewResult, JewelsPairResult, JewelsPairsResult, JewelsQueueResult, JewelsResolveResult, JewelsRunResult, JewelsRunsResult, JewelsTimeseriesBucket, JewelsTimeseriesResult, JewelsTrainResult, LiftedDatabase, MethodsInvokeResult, OperationProgress, OutboundDnsInstructions, OutboundDnsRecord, OutboundEmailDomainAddResult, OutboundEmailDomainCheckResult, OutboundEmailDomainDeleteResult, OutboundEmailDomainUiStatus, OutboundEmailDomainVerifyResult, OutboundEmailDomainView, OutboundEmailDomainsListResult, PlatformSuppression, PrerenderGetResult, PrerenderInvalidateResult, PrerenderPage, PrerenderPagesResult, PrerenderViewResult, PreviewShareLink, PreviewShareListResult, PreviewShareResult, PreviewShareRevokeResult, RegisteredDomainConnection, RegisteredDomainOffer, RegisteredDomainQuote, RegisteredDomainRecordType, RegisteredDomainRecords, RegisteredDomainStatus, RegisteredDomainView, RegisteredDomainZoneRecord, RegisteredDomainsBuyResult, RegisteredDomainsContactResult, RegisteredDomainsContactSetResult, RegisteredDomainsListResult, RegisteredDomainsQuoteResult, RegisteredDomainsRecordDeleteResult, RegisteredDomainsRecordResult, RegisteredDomainsSearchResult, RegisteredDomainsZoneResult, RegistrantContact, ReleaseFailureFields, ReleaseFragment, ReleasesByCommitResult, ReleasesGetResult, ReleasesListResult, RequestsGetResult, RequestsListResult, RequestsListRow, RequestsStatsMethodBucket, RequestsStatsMethodResult, RequestsStatsSummaryBucket, RequestsStatsSummaryResult, SecretsDeleteResult, SecretsGetResult, SecretsListResult, SecretsSetResult, SettingsResult, SuppressionSource, TaskTraceOutcome, TaskTraceSummary, TaskTranscriptMessage, TaskTurnError, TasksGetResult, TasksListResult, TrainingLogEntry, TrainingRunRow, TrainingRunStatus, UserAuthProvider, UserListItem, UserRecord, UsersCreateApiKeyResult, UsersListResult, UsersRevokeApiKeyResult, UsersSetRoleResult, V2AppSettings, V2BuildLogEntry, V2BuildStats, V2CommitInfo, V2EmailMessage, V2ReleaseStatus, VoiceAvailableNumber, VoiceNumbersBuyResult, VoiceNumbersListResult, VoiceNumbersReleaseResult, VoiceNumbersSearchResult, VoiceNumbersSetNameResult, VoicePhoneNumberStatus, VoicePhoneNumberView, VoiceResolvedPolicy, VoiceSessionChannel, VoiceSessionCost, VoiceSessionCostLine, VoiceSessionDetail, VoiceSessionGetResult, VoiceSessionListItem, VoiceSessionSip, VoiceSessionSpeechEntry, VoiceSessionStatus, VoiceSessionToolEntry, VoiceSessionTranscriptEntry, VoiceSessionsListResult, VoiceSettingsCeilings, VoiceSettingsGetResult, VoiceSettingsOverrides, VoiceSettingsSetResult, WorkspaceRegistrantContact };
+export type { AdminClient, AdminClientOptions, AdminContext, AgentThreadDetail, AgentThreadListItem, AgentThreadsGetResult, AgentThreadsListResult, AgentToolCall, AgentTranscriptMessage, AgentTurnError, AnalyticsAiHostRow, AnalyticsAiSourcesResult, AnalyticsAiVendorRow, AnalyticsBatchResult, AnalyticsCrawlersOverviewResult, AnalyticsCrawlersRecentResult, AnalyticsCrawlersRecentRow, AnalyticsCrawlersResult, AnalyticsCrawlersTimeseriesBucket, AnalyticsCrawlersTimeseriesResult, AnalyticsLiveResult, AnalyticsMapPoint, AnalyticsMapResult, AnalyticsMetric, AnalyticsQueryResult, AnalyticsQueryResultRow, AnalyticsSourceRow, AnalyticsSourcesResult, AppCronJobStatus, AppCronJobStatusReason, AppCronRunState, AppEmailSuppression, AppSecretRow, AppsListPage, AppsListResult, BoughtDomain, CrashGroup, CrashOccurrenceRow, CrashesGetResult, CrashesListResult, CrashesOccurrencesResult, CrashesStatsBucket, CrashesStatsResult, CronJobDecorated, CronOverviewResult, CronRunResult, CronRunSummary, DashboardLiveRelease, DashboardReleaseMethod, DashboardResult, DataLiftFromDevResult, DataLiftFromLiveResult, DataSourceConnector, DataSourceConnectorCredentials, DataSourceConnectorDeletions, DataSourceConnectorGetResult, DataSourceConnectorPolicy, DataSourceConnectorResult, DataSourceInspectReport, DataSourceInspectResult, DataSourceJob, DataSourceJobGetResult, DataSourceJobManifestTokenResult, DataSourceJobPlan, DataSourceJobResult, DataSourceJobSource, DataSourceJobState, DataSourceJobsListResult, DataSourceMapDeployResult, DataSourceMapTestDocument, DataSourceMapTestOutcome, DataSourceMapTestResult, DataSourceMapper, DataSourceObjectSelection, DataSourceQuarantineResult, DataSourceQuarantinedObject, DataSourceReader, DataSourceReaderDeliveries, DataSourceReaderRetryResult, DataSourceReaderStatusResult, DataSourceReaderTestDocument, DataSourceReaderTestResult, DataSourceRemapResult, DataSourceRereadResult, DataSourceSyncResult, DataSourcesBuildProgress, DataSourcesChunkingConfig, DataSourcesChunkingStrategy, DataSourcesConfigResult, DataSourcesConfigUpdateResult, DataSourcesCountResult, DataSourcesCreateResult, DataSourcesDeleteResult, DataSourcesDictionaryPushResult, DataSourcesDictionaryReport, DataSourcesDictionaryStatus, DataSourcesDocument, DataSourcesDocumentConfirmResult, DataSourcesDocumentDeleteManyResult, DataSourcesDocumentDeleteResult, DataSourcesDocumentSelector, DataSourcesDocumentStatus, DataSourcesDocumentsResult, DataSourcesDropResult, DataSourcesEntitiesResult, DataSourcesHydrateResult, DataSourcesHydration, DataSourcesIndex, DataSourcesIngestConfig, DataSourcesIngestUpdate, DataSourcesLinkResult, DataSourcesListEntry, DataSourcesListResult, DataSourcesMigration, DataSourcesMoveResult, DataSourcesPassage, DataSourcesPassagesResult, DataSourcesPlacement, DataSourcesPromoteResult, DataSourcesRelink, DataSourcesRetrievalConfig, DataSourcesRetrievalUpdate, DataSourcesRevectorizeResult, DataSourcesSampleResult, DataSourcesSearchCitation, DataSourcesSearchResult, DataSourcesSearchResultItem, DataSourcesUploadTokenResult, DatasetFile, DbHistoryResult, DbQueryResult, DiagnosticsAuditEnvironment, DiagnosticsDashboardResult, DiagnosticsFinding, DiagnosticsLighthouseScores, DiagnosticsPayload, DiagnosticsReleaseResult, DiagnosticsRuntimeFindings, DomainsCheckResult, DomainsCustomAddResult, DomainsCustomCheckResult, DomainsCustomHostnameUiStatus, DomainsCustomHostnameView, DomainsCustomListResult, DomainsCustomRemoveResult, DomainsCustomRetryResult, DomainsDnsInstructions, DomainsGetResult, DomainsSetResult, EmailBatchLifecycle, EmailBatchResult, EmailBatchSummary, EmailBatchesResult, EmailDomainBase, EmailEffectiveSender, EmailInboxResult, EmailListResult, EmailMessageKind, EmailMessageResult, EmailMessageStatus, EmailSenderTier, EmailSendingStatusResult, EmailStatsResult, EmailSummary, EmailSuppressResult, EmailSuppressionsResult, EmailUnsuppressResult, EvalAggregates, EvalCompareResult, EvalExpectation, EvalQueriesAddResult, EvalQueriesListResult, EvalQuery, EvalQueryResult, EvalQueryStyle, EvalRetrieval, EvalRun, EvalRunResult, EvalRunState, EvalRunsListResult, EvalSet, EvalSetGetResult, EvalSetResult, EvalSetState, EvalSetsListResult, EventChannelActivity, EventsChannelsListResult, EventsPublishResult, EventsTailFrame, FilesDeleteResult, FilesFileMeta, FilesListEntry, FilesListResult, FilesLsResult, FilesScanBadge, FilesScanFlagged, FilesScanStore, FilesStatResult, FilesStoreSummaryEntry, FilesUploadUrlResult, FilesUrlResult, FrontendErrorType, InboundDnsInstructions, InboundEmailDomainAddResult, InboundEmailDomainCheckResult, InboundEmailDomainDeleteResult, InboundEmailDomainUiStatus, InboundEmailDomainVerifyResult, InboundEmailDomainView, InboundEmailDomainsListResult, InboxEmailPreview, IssueAuthorKind, IssueCommentRow, IssueEventType, IssueRow, IssueStatus, IssuesCommentResult, IssuesCreateResult, IssuesDeleteResult, IssuesGetResult, IssuesListResult, IssuesUpdateResult, JewelPairRow, JewelPairSummaryRow, JewelVerdict, JewelsDatasetSummary, JewelsDryrunResult, JewelsExportResult, JewelsGradeResult, JewelsGrading, JewelsOverviewResult, JewelsPairResult, JewelsPairsResult, JewelsQueueResult, JewelsResolveResult, JewelsRunResult, JewelsRunsResult, JewelsTimeseriesBucket, JewelsTimeseriesResult, JewelsTrainResult, LiftedDatabase, MethodsInvokeResult, OperationProgress, OutboundDnsInstructions, OutboundDnsRecord, OutboundEmailDomainAddResult, OutboundEmailDomainCheckResult, OutboundEmailDomainDeleteResult, OutboundEmailDomainUiStatus, OutboundEmailDomainVerifyResult, OutboundEmailDomainView, OutboundEmailDomainsListResult, PlatformSuppression, PrerenderGetResult, PrerenderInvalidateResult, PrerenderPage, PrerenderPagesResult, PrerenderViewResult, PreviewShareLink, PreviewShareListResult, PreviewShareResult, PreviewShareRevokeResult, RegisteredDomainConnection, RegisteredDomainOffer, RegisteredDomainQuote, RegisteredDomainRecordType, RegisteredDomainRecords, RegisteredDomainStatus, RegisteredDomainView, RegisteredDomainZoneRecord, RegisteredDomainsBuyResult, RegisteredDomainsContactResult, RegisteredDomainsContactSetResult, RegisteredDomainsListResult, RegisteredDomainsQuoteResult, RegisteredDomainsRecordDeleteResult, RegisteredDomainsRecordResult, RegisteredDomainsSearchResult, RegisteredDomainsZoneResult, RegistrantContact, ReleaseFailureFields, ReleaseFragment, ReleasesByCommitResult, ReleasesGetResult, ReleasesListResult, RequestsGetResult, RequestsListResult, RequestsListRow, RequestsStatsMethodBucket, RequestsStatsMethodResult, RequestsStatsSummaryBucket, RequestsStatsSummaryResult, SecretsDeleteResult, SecretsGetResult, SecretsListResult, SecretsSetResult, SettingsResult, SuppressionSource, TaskTraceOutcome, TaskTraceSummary, TaskTranscriptMessage, TaskTurnError, TasksGetResult, TasksListResult, TrainingLogEntry, TrainingRunRow, TrainingRunStatus, UserAuthProvider, UserListItem, UserRecord, UsersCreateApiKeyResult, UsersListResult, UsersRevokeApiKeyResult, UsersSetRoleResult, V2AppSettings, V2BuildLogEntry, V2BuildStats, V2CommitInfo, V2EmailMessage, V2ReleaseStatus, VoiceAvailableNumber, VoiceNumbersBuyResult, VoiceNumbersListResult, VoiceNumbersReleaseResult, VoiceNumbersSearchResult, VoiceNumbersSetNameResult, VoicePhoneNumberStatus, VoicePhoneNumberView, VoiceResolvedPolicy, VoiceSessionChannel, VoiceSessionCost, VoiceSessionCostLine, VoiceSessionDetail, VoiceSessionGetResult, VoiceSessionListItem, VoiceSessionSip, VoiceSessionSpeechEntry, VoiceSessionStatus, VoiceSessionToolEntry, VoiceSessionTranscriptEntry, VoiceSessionsListResult, VoiceSettingsCeilings, VoiceSettingsGetResult, VoiceSettingsOverrides, VoiceSettingsSetResult, WorkspaceApp, WorkspaceRegistrantContact };

package/dist/index.js

@@ -281,6 +281,42 @@ function crawlers(ctx, params) {
   );
 }
 
+// src/ops/apps.ts
+var apps_exports = {};
+__export(apps_exports, {
+  list: () => list2
+});
+var PAGE_SIZE = 500;
+async function list2(ctx, params = {}) {
+  const words = (params.search ?? "").toLowerCase().split(/\s+/).filter(Boolean);
+  const apps = [];
+  let cursor;
+  while (true) {
+    const page = await call(
+      ctx,
+      "GET",
+      `/_internal/v2/apps${qs({ status: params.status, limit: PAGE_SIZE, cursor })}`
+    );
+    for (const app of page.apps) {
+      const text = `${app.name} ${app.customSubdomain ?? ""}`.toLowerCase();
+      if (words.every((word) => text.includes(word))) {
+        apps.push({
+          appId: app.appId,
+          name: app.name,
+          subdomain: app.customSubdomain,
+          isPublished: app.isPublished,
+          lastDeployedAt: app.lastDeployedAt,
+          createdBy: app.createdBy.name
+        });
+      }
+    }
+    if (!page.nextCursor) {
+      return { apps };
+    }
+    cursor = page.nextCursor;
+  }
+}
+
 // src/ops/events.ts
 var events_exports = {};
 __export(events_exports, {
@@ -307,11 +343,11 @@ function publish(ctx, params) {
 var crashes_exports = {};
 __export(crashes_exports, {
   get: () => get2,
-  list: () => list2,
+  list: () => list3,
   occurrences: () => occurrences,
   stats: () => stats
 });
-function list2(ctx, params = {}) {
+function list3(ctx, params = {}) {
   return call(
     ctx,
     "GET",
@@ -343,10 +379,10 @@ function stats(ctx, params = {}) {
 // src/ops/cron.ts
 var cron_exports = {};
 __export(cron_exports, {
-  list: () => list3,
+  list: () => list4,
   run: () => run
 });
-function list3(ctx, params = {}) {
+function list4(ctx, params = {}) {
   return call(
     ctx,
     "GET",
@@ -423,7 +459,7 @@ __export(dataSources_exports, {
   drop: () => drop,
   entities: () => entities,
   link: () => link,
-  list: () => list4,
+  list: () => list5,
   move: () => move,
   passages: () => passages,
   promote: () => promote,
@@ -666,7 +702,7 @@ async function waitForCandidate(ctx, params) {
   const timeoutMs = params.timeoutMs ?? DEFAULT_WAIT_TIMEOUT_MS;
   const outcome = await pollUntil(
     async () => {
-      const { dataSources } = await list4(ctx);
+      const { dataSources } = await list5(ctx);
       const source = dataSources.find((s) => s.slug === params.slug);
       if (!source) {
         throw new Error(`Data source "${params.slug}" not found.`);
@@ -748,7 +784,7 @@ async function allDocuments(ctx, params) {
   }
   return out;
 }
-function list4(ctx) {
+function list5(ctx) {
   return call(ctx, "GET", base(ctx.appId));
 }
 function search(ctx, params) {
@@ -867,7 +903,7 @@ async function waitForMove(ctx, params) {
   const timeoutMs = params.timeoutMs ?? DEFAULT_WAIT_TIMEOUT_MS;
   const outcome = await pollUntil(
     async () => {
-      const { dataSources } = await list4(ctx);
+      const { dataSources } = await list5(ctx);
       const source2 = dataSources.find((s) => s.slug === params.slug);
       if (!source2) {
         throw new Error(`Data source "${params.slug}" not found.`);
@@ -1048,7 +1084,7 @@ __export(dataSourceJobs_exports, {
   cancel: () => cancel,
   describeProgress: () => describeProgress,
   get: () => get3,
-  list: () => list5,
+  list: () => list6,
   pause: () => pause,
   resume: () => resume,
   retry: () => retry,
@@ -1084,7 +1120,7 @@ async function uploadManifest(ctx, params) {
   await uploadDirect(token.upload, params.content, "manifest.jsonl");
   return { key: token.key };
 }
-function list5(ctx, params) {
+function list6(ctx, params) {
   return call(
     ctx,
     "GET",
@@ -1322,7 +1358,7 @@ async function waitForHydration(ctx, params) {
   const timeoutMs = params.timeoutMs ?? DEFAULT_WAIT_TIMEOUT_MS3;
   const outcome = await pollUntil(
     async () => {
-      const { dataSources } = await list4(ctx);
+      const { dataSources } = await list5(ctx);
       const source2 = dataSources.find((s) => s.slug === params.slug);
       if (!source2) {
         throw new Error(`Data source "${params.slug}" not found.`);
@@ -1665,11 +1701,11 @@ __export(releases_exports, {
   byCommit: () => byCommit,
   dashboardLive: () => dashboardLive,
   get: () => get5,
-  list: () => list6,
+  list: () => list7,
   primaryUrl: () => primaryUrl,
   waitForCommit: () => waitForCommit
 });
-function list6(ctx, params = {}) {
+function list7(ctx, params = {}) {
   return call(
     ctx,
     "GET",
@@ -1696,7 +1732,7 @@ async function dashboardLive(ctx) {
     "GET",
     `/_internal/v2/apps/${ctx.appId}/dashboard`
   );
-  return dashboard.liveRelease;
+  return dashboard.liveRelease ? { ...dashboard.liveRelease, primaryUrl: dashboard.primaryUrl } : null;
 }
 async function primaryUrl(ctx) {
   const dashboard = await call(
@@ -1714,7 +1750,8 @@ function summarizeRelease(release) {
     status: release.status,
     buildDurationMs: release.buildDurationMs ?? null,
     publishedAt: release.publishedAt ?? null,
-    ...release.previewUrl ? { previewUrl: release.previewUrl } : {}
+    ...release.previewUrl ? { previewUrl: release.previewUrl } : {},
+    ...release.primaryUrl ? { primaryUrl: release.primaryUrl } : {}
   };
   const readers = (release.dataSources ?? []).filter((d) => d.reader);
   if (readers.length > 0 && release.status === "live") {
@@ -2020,7 +2057,7 @@ __export(email_exports, {
   checkDomain: () => checkDomain,
   get: () => get7,
   inbox: () => inbox,
-  list: () => list7,
+  list: () => list8,
   listDomains: () => listDomains,
   removeDomain: () => removeDomain,
   stats: () => stats2,
@@ -2055,7 +2092,7 @@ async function resolveDomainId(ctx, direction, domain) {
   }
   return match.id;
 }
-function list7(ctx, params = {}) {
+function list8(ctx, params = {}) {
   return call(
     ctx,
     "GET",
@@ -2256,7 +2293,7 @@ __export(infra_exports, {
   destroy: () => destroy,
   get: () => get8,
   hibernate: () => hibernate,
-  list: () => list8,
+  list: () => list9,
   logs: () => logs,
   provision: () => provision,
   rename: () => rename,
@@ -2269,7 +2306,7 @@ var POLL_MS5 = 3e3;
 function base6(appId) {
   return `/_internal/v2/apps/${appId}/infra`;
 }
-function list8(ctx, params) {
+function list9(ctx, params) {
   return call(
     ctx,
     "GET",
@@ -2390,7 +2427,7 @@ __export(issues_exports, {
   edit: () => edit,
   filed: () => filed,
   get: () => get9,
-  list: () => list9,
+  list: () => list10,
   reopen: () => reopen
 });
 function authorship(ctx) {
@@ -2405,7 +2442,7 @@ function listQuery(params) {
     cursor: params.cursor
   });
 }
-function list9(ctx, params = {}) {
+function list10(ctx, params = {}) {
   return call(
     ctx,
     "GET",
@@ -2637,10 +2674,10 @@ var methods_exports = {};
 __export(methods_exports, {
   METHOD_RUN_TIMEOUT_MS: () => METHOD_RUN_TIMEOUT_MS,
   invoke: () => invoke,
-  list: () => list10
+  list: () => list11
 });
 var METHOD_RUN_TIMEOUT_MS = 6e5;
-async function list10(ctx) {
+async function list11(ctx) {
   const dashboard = await call(
     ctx,
     "GET",
@@ -2703,7 +2740,7 @@ function invalidate(ctx, params = {}) {
 // src/ops/previews.ts
 var previews_exports = {};
 __export(previews_exports, {
-  list: () => list11,
+  list: () => list12,
   revoke: () => revoke,
   share: () => share
 });
@@ -2715,7 +2752,7 @@ function share(ctx, params) {
     { branch: params.branch, days: params.days, label: params.label }
   );
 }
-function list11(ctx, branch) {
+function list12(ctx, branch) {
   return call(
     ctx,
     "GET",
@@ -2891,11 +2928,11 @@ async function exportVideo(_ctx, params) {
 var requests_exports = {};
 __export(requests_exports, {
   get: () => get10,
-  list: () => list12,
+  list: () => list13,
   statsForMethod: () => statsForMethod,
   statsSummary: () => statsSummary
 });
-function list12(ctx, params = {}) {
+function list13(ctx, params = {}) {
   return call(
     ctx,
     "GET",
@@ -2929,10 +2966,10 @@ var secrets_exports = {};
 __export(secrets_exports, {
   del: () => del2,
   get: () => get11,
-  list: () => list13,
+  list: () => list14,
   set: () => set2
 });
-function list13(ctx) {
+function list14(ctx) {
   return call(
     ctx,
     "GET",
@@ -2995,11 +3032,11 @@ function updateSettings(ctx, partial) {
 var users_exports = {};
 __export(users_exports, {
   createApiKey: () => createApiKey,
-  list: () => list14,
+  list: () => list15,
   revokeApiKey: () => revokeApiKey,
   setRole: () => setRole
 });
-function list14(ctx, params = {}) {
+function list15(ctx, params = {}) {
   return call(
     ctx,
     "GET",
@@ -3192,6 +3229,7 @@ function buildClient(ctx) {
     agent: bindOps(agent_exports, ctx),
     tasks: bindOps(tasks_exports, ctx),
     analytics: bindOps(analytics_exports, ctx),
+    apps: bindOps(apps_exports, ctx),
     events: bindOps(events_exports, ctx),
     crashes: bindOps(crashes_exports, ctx),
     cron: bindOps(cron_exports, ctx),