@keboola/api-client 47.0.0 → 49.0.0

package/AGENTS.md

@@ -82,9 +82,12 @@ Two flow-specific factories back the SDK:
 `session` is **flow-specific** lifecycle machinery:
 
 - bearer: `stack.select(baseUrl)` → `auth.authenticate(credential)` → `project.select(projectId)`,
-  plus `auth.signOut()` / `auth.replace(credential)` / `auth.isAuthenticated()` / `auth.isAuthenticatedAsync()` / `auth.rotate(baseUrl)` / `auth.getHeaders(projectId?)` / `auth.getHeadersAsync(projectId?)`, `stack.close` and
+  plus `auth.signOut({ baseUrl?, retain? }?)` / `auth.replace(credential)` / `auth.isAuthenticated()` / `auth.isAuthenticatedAsync()` / `auth.rotate(baseUrl)` / `auth.getHeaders(projectId?)` / `auth.getHeadersAsync(projectId?)`, `auth.restoreRetained(baseUrl)`, `stack.close` and
   the two `deactivate`s, and `getState()` / `subscribe(cb)` over the stack-and-project table. Every
-  verb is synchronous — nothing awaits a build; a namespace throws `NotReady` until its fetch lands.
+  verb changes the table synchronously — nothing awaits a build; a namespace throws `NotReady` until
+  its fetch lands. `stack.select`, `project.select` and `auth.signOut` also return a promise that
+  resolves once the change is stored: await it before leaving the document, or the reload boots
+  from the scope or sign-in it was meant to replace.
   The one fetch each entry does own is readable both ways: `stack.getContext(baseUrl?)` /
   `project.getContext(entryId?)` answer from cache (`null` until it lands), and the
   `getContextAsync` sibling of each awaits it. `retryContext` refetches after a failure. The
@@ -436,7 +439,7 @@ Surfacing — toast vs inline:
 
 `@keboola/api-client/domain/permissions` holds token-only capability predicates: `canX` (boolean, safe in any UI condition) paired with `assertCanX` (throws `PermissionDeniedError` before any HTTP round-trip). Catch the error to gate UI without a network call; let it propagate from `useQuery` to surface a "no access" empty state.
 
-Implemented today: `admin.ts` (`isAdmin`, `isProductionManager`, … + matching `assertCan*`, all `(token)`-only), `configurations.ts` (`canCreate/canCopy/canMigrateFromTemplate/canPurge/canAssignFolder` + `assertCan*`, taking a trailing `ctx: ConfigurationCtx`), and `organization.ts` (`isOrganizationMember`, `isOrganizationAdmin`, `canWriteKaiSpendCaps`, all `(token)`-only — reads `StorageToken.admin.isOrganizationMember` rather than the project role string; `assertCanAdministerOrganization`/`assertCanWriteKaiSpendCaps` pair with the latter two, `isOrganizationMember` is a raw signal with no assert). `storage.ts`, `devBranches.ts`, `sandboxes.ts` are still `export {}` placeholders.
+Implemented today: `admin.ts` (`isAdmin`, `isProductionManager`, … + matching `assertCan*`, all `(token)`-only), `configurations.ts` (`canCreate/canCopy/canMigrateFromTemplate/canPurge/canAssignFolder` + `assertCan*`, taking a trailing `ctx: ConfigurationCtx`), and `organization.ts` (`isOrganizationMember`, `isOrganizationAdmin`, `canWriteKaiSpendCaps`, all `(token)`-only — reads `StorageToken.admin.isOrganizationMember` rather than the project role string; `assertCanAdministerOrganization`/`assertCanWriteKaiSpendCaps` pair with the latter two, `isOrganizationMember` is a raw signal with no assert), and `storage.ts` (`canListSharingTargets`, `(token)`-only, no assert — it gates a query; `api.context.project` exposes it). `devBranches.ts`, `sandboxes.ts` are still `export {}` placeholders.
 
 ```ts
 import { PermissionDeniedError } from '@keboola/api-client/domain/permissions';
@@ -488,7 +491,10 @@ api.sdk.tag.*        api.sdk.storage.*
 
 `api.apps` is the data-apps `/v2` App Deployments surface (apps + deployments); `api.dataScience` is the same service's `/v1` surface, which still owns workspaces (`/sandboxes`, `/runtimes`) and the data-app endpoints the UI has not moved off yet.
 
-**`hasService('data-science')` is not the availability check for `api.apps`, and neither is `api.apps.healthCheck()`.** Both clients resolve off that one service id, so `api.apps` is live on every stack that advertises it — while `/v2` itself is implemented only where sandboxes-service serves it (canary at the time of writing). Nothing cheap discriminates: `apps` is absent from the service index on every stack including canary; the `/v2/*` routes are scaffolded everywhere (unauthenticated they 401, so the route exists); and `healthCheck()` answers 200 everywhere because `GET /v2/` falls through to the same root handler as `GET /`, down to an `apiDocs` pointing at the v1 swagger. The one thing that differs is the implementation: off canary, a real call answers `501 {"error":"This endpoint is not implemented yet."}` — measured on three production stacks (AJDA-3140). So gate a data-apps feature on a real call's 501, or on a stack feature flag once one exists.
+**`api.apps` needs no availability check.** Every stack's sandboxes-service serves `/v2` from the same image as `/v1`, and `api.apps` resolves off the `data-science` service id like `api.dataScience`. When probing a stack by hand, only an authenticated call answers:
+
+- `healthCheck()`, `GET /v2/docs/swagger.yaml` and unauthenticated calls answer the same everywhere.
+- A `401` from an authenticated call means a bad or expired token, not a missing API.
 
 Clients backing optional stack services (vault, queue, …) throw `ServiceUnavailableError` if absent from the current stack — check `api.context.stack.hasService(...)` before assuming a namespace exists.
 

package/API-SURFACE.md

@@ -4,7 +4,7 @@
 
 Every namespace and method reachable from a ready `KeboolaApi` — the `api` half of a keboola client (`createKeboola(...).api` / `createLegacyKeboola(...).api`, or `useApiClient()`). Generated from the TypeScript type checker — see `scripts/gen-surface.mjs`.
 
-26 top-level namespaces, 725 methods. This index lists method **names** only — full signatures live per namespace under [`surface/`](./surface). Open `surface/<namespace>.md` for the one you need.
+26 top-level namespaces, 728 methods. This index lists method **names** only — full signatures live per namespace under [`surface/`](./surface). Open `surface/<namespace>.md` for the one you need.
 
 ## [`api.ai`](./surface/ai.md)
 
@@ -13,7 +13,6 @@ Every namespace and method reachable from a ready `KeboolaApi` — the `api` hal
 - `describeConfigurationVersion`
 - `docsQuestion`
 - `explainError`
-- `feedback`
 - `getComponentDetail`
 - `healthCheck`
 - `suggestComponent`
@@ -229,6 +228,7 @@ Every namespace and method reachable from a ready `KeboolaApi` — the `api` hal
 - `updateProjectToolPolicy`
 - `updateSpendCaps`
 - `updateUserAgentSettings`
+- `updateUserMemory`
 
 ## [`api.management`](./surface/management.md)
 
@@ -326,7 +326,9 @@ Every namespace and method reachable from a ready `KeboolaApi` — the `api` hal
 - `payAsYouGo.getTopUpSetting`
 - `payAsYouGo.updateStripeCustomer`
 - `payAsYouGo.updateTopUpSetting`
-- `programmaticProjects.confirm`
+- `programmaticProjects.confirmByCookie`
+- `programmaticProjects.confirmByToken`
+- `programmaticProjects.getClaim`
 - `projects.addProjectFeature`
 - `projects.addProjectTemplateFeature`
 - `projects.addProjectUser`
@@ -564,6 +566,7 @@ Every namespace and method reachable from a ready `KeboolaApi` — the `api` hal
 - `bucketSharing.shareBucketToUsersAsync`
 - `bucketSharing.shareBucketToUsersPoller`
 - `bucketSharing.sharedBuckets`
+- `bucketSharing.sharingTargets`
 - `bucketSharing.unshareBucketAsync`
 - `bucketSharing.unshareBucketPoller`
 - `buckets.createBucket`

package/CHANGELOG.md

@@ -1,5 +1,70 @@
 # @keboola/api-client
 
+## 49.0.0
+
+### Major Changes
+
+- **Breaking:** `programmaticProjects.confirm` is gone. `confirmByToken(claimToken)` redeems the claim a link carried and `confirmByCookie()` the claim Connection parked in its cookie, both through the OpenAPI client now that the Manage schema carries the endpoint (UT-5890)
+
+### Minor Changes
+
+- `App` carries `hasManagedGitRepo`: whether the app's code lives in a Keboola-managed Git repository.
+
+- `canListSharingTargets(token)` in `@keboola/api-client/domain/permissions`, exposed as `api.context.project.canListSharingTargets`, tells whether the token may call `api.storage.bucketSharing.sharingTargets()` — the `share` role, or organization membership, as Connection's voter decides.
+
+- `Credits` follows the billing spec's corrected `/credits` response (billing-api#225):
+  - `marketplaceSubscription` is a top-level key, not one under `stats`; its `vendor` includes `gcp` and its `billingLink` is `null` for `aws` and `gcp`.
+  - `stats` and its `componentJobs` are always present, and `stats.workspaceJobs` is a list.
+
+- `CreditPurchase` types x402 top-ups: `invoiceTopUpType` may be `'x402'`, and the optional `paymentProvider`, `paymentStatus` (`pending` | `settled` | `expired`) and `externalPaymentId` (the settlement tx hash) describe the payment. `X402_TOP_UP_TYPE` exports the top-up type value, and `X402_PAYMENT_STATUS` and `X402PaymentStatus` the payment-status values.
+
+- `ProjectFeature` in `constants` names every project feature the apps gate on, the new `AdminFeature` names the admin features, and `StackFeature` gains `SandboxesPythonSpark`
+
+- `ManageErrorCode` in `constants` names the Manage API's string error codes the apps classify on, starting with the programmatic-project ones (UT-5890)
+
+- `manageErrorCode(error)` reads the Manage API's string code off an `ApiError`, wherever the backend put it, and `isManageError(error, code)` narrows on one (UT-5890)
+
+- `retryAfterSeconds(error)` reads a failed response's `Retry-After` header off an `ApiError`, for the endpoints that answer 429 or 503 with one (UT-5890)
+
+- `StackFeature` in `constants` names the stack features the apps gate on, the way `ProjectFeature` already names project features (UT-5890)
+
+### Patch Changes
+
+- `resumeApp` wakes the app and clears a failure stop (`disabled`); a stopped app comes back `starting`.
+
+- The bearer session's stack-index fetch gives up after 30 seconds, so a stack that never answers errors its context instead of leaving every caller waiting (UT-5890)
+
+## 48.0.0
+
+### Major Changes
+
+- - A `StorageAdapter` may answer with a promise, and may offer `withLock` for a critical section shared across documents. **Breaking:** `createPersistor` is `read` / `write` / `modify` / `remove`, plus `transaction(task)`, which hands `task` the same four verbs under the adapter's lock: every write resolves once it has landed and rejects when it could not, writes run in the order they were issued, and `read` waits for the ones in flight. `hydrate`, `persist`, `update`, `clear`, `flush` and `hasPersistedValue` are gone.
+  - **Breaking:** `session.auth.signOut` resolves once the sign-out is stored — await it before leaving the document.
+  - **Breaking:** `session.auth.signOut` takes one options object, `{ baseUrl?, retain? }`. With `retain`, the stack signs out but keeps its grant; `session.auth.restoreRetained(baseUrl)` signs it back in. `Stack.retained` holds the kept grant with its issue time.
+  - **Breaking:** `CredentialType` is renamed `GrantType`. `Grant` is what renews a credential and what persists; `Credential` is the grant with its access token.
+
+- Remove `api.ai.feedback()` and the `FeedbackBody` type. The UI no longer sends 👍/👎 feedback on AI-generated content to the AI service.
+
+### Minor Changes
+
+- Kai saves a personal note right away by default (AI-4061). The chat shows "Remembered: …" with Undo and Edit; Kai settings → Memory switches back to asking before each save. Company notes still go through approval and a project admin's review. `api.kaiAgent.updateUserMemory(id, content)` edits a note, and user settings carry `memorySaveMode` (`auto` | `ask`).
+
+- `Workspace` carries `lastActivityAt`, the last observed use, and `warnAt`, when retention will warn the owner (both ISO 8601, `null` or absent otherwise).
+
+- `api.storage.bucketSharing.sharingTargets()` lists the projects and users a bucket can be shared to (`GET /v2/storage/sharing-targets`), and `api.management.programmaticProjects.getClaim()` reads the parked agent-project claim (`GET /manage/programmatic-projects/claim`). Both come from the regenerated Storage and Manage schemas; the Storage regen also adds `lastActivityAt` and `warnAt` to workspaces (UT-5889)
+
+### Patch Changes
+
+- The `apps` (`/v2` App Deployments) types are generated from `apps.keboola.com`; the types are unchanged.
+  - `suspendApp` sleeps the app; the next visitor wakes it.
+  - `getDeployments` lists live deployments; `archived: true` lists the deleted ones instead.
+
+- Regenerate the developerPortal, queryService, kaiAgent, componentsMcp, storage and management OpenAPI types against the live services (UT-5860)
+
+- `kaiAgent` history types: a stored tool part's `approval.approved` is optional — a call whose approval card was shown keeps only the approval `id`.
+
+- `canWriteSemanticLayer` admits the `share` project role, matching the metastore's role mapping (`admin`, `productionManager`, `share` get project-admin). A `share` member now gets the semantic-layer write actions in kbc-ui and Kai's semantic-layer write tools.
+
 ## 47.0.0
 
 ### Major Changes

package/README.md

@@ -224,7 +224,7 @@ Clients backed by OpenAPI specs are marked with (OpenAPI); the rest use the gene
 | `api.chat`          | Kai Assistant (OpenAPI)  | `getHistory()`, `getChat()`, `createChat()`, `deleteChat()`, `getVotes()`, `submitVote()`, `getUsage()`, `getSuggestions()`, `getAgentSettings()`, `getToolsList()`                                                 |
 | `api.kaiAgent`      | Kai Agent (OpenAPI)      | `getHistory()`, `getChat()`, `createChat()`, `deleteChat()`, `approveToolCall()`, `submitToolOutput()`, `getSuggestions()`, `getAgentSettings()`                                                                    |
 | `api.componentsMcp` | Components MCP (OpenAPI) | `getConnectors()`, `setConnectorCredentials()`                                                                                                                                                                      |
-| `api.ai`            | AI Service (OpenAPI)     | `describeConfiguration()`, `describeConfigurationVersion()`, `describeConfigurationMerge()`, `explainError()`, `suggestComponent()`, `feedback()`                                                                   |
+| `api.ai`            | AI Service (OpenAPI)     | `describeConfiguration()`, `describeConfigurationVersion()`, `describeConfigurationMerge()`, `explainError()`, `suggestComponent()`                                                                                 |
 | `api.queue`         | Job Queue (OpenAPI)      | `getJob()`, `searchJobs()`                                                                                                                                                                                          |
 | `api.queryService`  | Query Service (OpenAPI)  | `createQueryJob()`, `cancelQueryJob()`, `getQueryJob()`, `getQueryResults()`, `getQueryHistory()`, `exportResults()`                                                                                                |
 | `api.syncActions`   | Sync Actions (OpenAPI)   | `sendSyncAction()` + one namespace per component; see [`surface/syncActions.md`](./surface/syncActions.md)                                                                                                          |

package/dist/{adminRoles-CvdIUkiC.d.ts → adminRoles-BX1gk3At.d.ts}

@@ -1,4 +1,4 @@
-import { Lr as paths, l as OpenapiReturnType } from "./index-r6YSe8B-.js";
+import { Lr as paths, l as OpenapiReturnType } from "./index-BPMr8PQJ.js";
 //#region src/constants/adminRoles.d.ts
 type SpecAdminRole = NonNullable<NonNullable<OpenapiReturnType<paths['/v2/storage/tokens/verify']['get']>['admin']>['role']>;
 declare const AdminRole: {
@@ -13,4 +13,4 @@ declare const AdminRole: {
 type AdminRole = SpecAdminRole;
 //#endregion
 export { AdminRole as t };
-//# sourceMappingURL=adminRoles-CvdIUkiC.d.ts.map
+//# sourceMappingURL=adminRoles-BX1gk3At.d.ts.map

package/dist/{adminRoles-DGM8SuuF.d.cts → adminRoles-BbxFgfX-.d.cts}

@@ -1,4 +1,4 @@
-import { Lr as paths, l as OpenapiReturnType } from "./index-XaPb6unB.cjs";
+import { Lr as paths, l as OpenapiReturnType } from "./index-CL4iKFic.cjs";
 //#region src/constants/adminRoles.d.ts
 type SpecAdminRole = NonNullable<NonNullable<OpenapiReturnType<paths['/v2/storage/tokens/verify']['get']>['admin']>['role']>;
 declare const AdminRole: {
@@ -13,4 +13,4 @@ declare const AdminRole: {
 type AdminRole = SpecAdminRole;
 //#endregion
 export { AdminRole as t };
-//# sourceMappingURL=adminRoles-DGM8SuuF.d.cts.map
+//# sourceMappingURL=adminRoles-BbxFgfX-.d.cts.map

package/dist/ai/index.cjs

@@ -28,10 +28,6 @@ const createAiClient = ({ baseUrl, middlewares, auth }) => {
 		const { data } = await client.post("/suggest/component", { body });
 		return data;
 	};
-	const feedback = async (body) => {
-		const { data } = await client.post("/feedback", { body });
-		return data;
-	};
 	/** Answers a question using the Keboola documentation as a source. */
 	const docsQuestion = async (body) => {
 		const { data } = await client.post("/docs/question", { body });
@@ -53,7 +49,6 @@ const createAiClient = ({ baseUrl, middlewares, auth }) => {
 		explainError,
 		describeConfiguration,
 		suggestComponent,
-		feedback,
 		docsQuestion,
 		getComponentDetail
 	};

package/dist/ai/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["createOpenapiFetchClient","createAuthHeaders"],"sources":["../../src/clients/ai/aiClient.ts"],"sourcesContent":["import { createOpenapiFetchClient } from '../../fetchClient';\nimport { createAuthHeaders } from '../auth';\nimport type { ClientInitOptions } from '../types';\n\nimport type { paths } from './__generated__/schema';\nimport type {\n  DescribeConfigurationBody,\n  DescribeConfigurationMergeBody,\n  DescribeConfigurationVersionBody,\n  DocsQuestionBody,\n  ExplainErrorBody,\n  FeedbackBody,\n  SuggestComponentBody,\n} from './types';\n\nexport const createAiClient = ({ baseUrl, middlewares, auth }: ClientInitOptions) => {\n  const client = createOpenapiFetchClient<paths>({\n    baseUrl,\n    middlewares,\n    headers: createAuthHeaders(auth),\n  });\n\n  const describeConfigurationVersion = async (body: DescribeConfigurationVersionBody) => {\n    const { data } = await client.post('/describe/configuration-version', { body });\n\n    return data;\n  };\n\n  const describeConfigurationMerge = async (body: DescribeConfigurationMergeBody) => {\n    const { data } = await client.post('/describe/configuration-merge', { body });\n\n    return data;\n  };\n\n  const explainError = async (body: ExplainErrorBody) => {\n    const { data } = await client.post('/explain', { body });\n\n    return data;\n  };\n\n  const describeConfiguration = async (body: DescribeConfigurationBody) => {\n    const { data } = await client.post('/describe/configuration', { body });\n\n    return data;\n  };\n\n  const suggestComponent = async (body: SuggestComponentBody) => {\n    const { data } = await client.post('/suggest/component', { body });\n\n    return data;\n  };\n\n  const feedback = async (body: FeedbackBody) => {\n    const { data } = await client.post('/feedback', { body });\n\n    return data;\n  };\n\n  /** Answers a question using the Keboola documentation as a source. */\n  const docsQuestion = async (body: DocsQuestionBody) => {\n    const { data } = await client.post('/docs/question', { body });\n\n    return data;\n  };\n\n  /** Retrieves documentation details for a single component. */\n  const getComponentDetail = async (componentId: string) => {\n    const { data } = await client.get('/docs/components/{componentId}', {\n      path: { componentId },\n    });\n\n    return data;\n  };\n\n  const healthCheck = async (signal?: AbortSignal) => {\n    const { data } = await client.get('/health-check', {}, { signal });\n\n    return data;\n  };\n\n  return {\n    healthCheck,\n    describeConfigurationVersion,\n    describeConfigurationMerge,\n    explainError,\n    describeConfiguration,\n    suggestComponent,\n    feedback,\n    docsQuestion,\n    getComponentDetail,\n  };\n};\n"],"mappings":";;;;AAeA,MAAa,kBAAkB,EAAE,SAAS,aAAa,WAA8B;CACnF,MAAM,SAASA,iCAAAA,yBAAgC;EAC7C;EACA;EACA,SAASC,aAAAA,kBAAkB,IAAI;CACjC,CAAC;CAED,MAAM,+BAA+B,OAAO,SAA2C;EACrF,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,mCAAmC,EAAE,KAAK,CAAC;EAE9E,OAAO;CACT;CAEA,MAAM,6BAA6B,OAAO,SAAyC;EACjF,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,iCAAiC,EAAE,KAAK,CAAC;EAE5E,OAAO;CACT;CAEA,MAAM,eAAe,OAAO,SAA2B;EACrD,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,YAAY,EAAE,KAAK,CAAC;EAEvD,OAAO;CACT;CAEA,MAAM,wBAAwB,OAAO,SAAoC;EACvE,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,2BAA2B,EAAE,KAAK,CAAC;EAEtE,OAAO;CACT;CAEA,MAAM,mBAAmB,OAAO,SAA+B;EAC7D,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,sBAAsB,EAAE,KAAK,CAAC;EAEjE,OAAO;CACT;CAEA,MAAM,WAAW,OAAO,SAAuB;EAC7C,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,aAAa,EAAE,KAAK,CAAC;EAExD,OAAO;CACT;;CAGA,MAAM,eAAe,OAAO,SAA2B;EACrD,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,kBAAkB,EAAE,KAAK,CAAC;EAE7D,OAAO;CACT;;CAGA,MAAM,qBAAqB,OAAO,gBAAwB;EACxD,MAAM,EAAE,SAAS,MAAM,OAAO,IAAI,kCAAkC,EAClE,MAAM,EAAE,YAAY,EACtB,CAAC;EAED,OAAO;CACT;CAEA,MAAM,cAAc,OAAO,WAAyB;EAClD,MAAM,EAAE,SAAS,MAAM,OAAO,IAAI,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAC;EAEjE,OAAO;CACT;CAEA,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF"}
+{"version":3,"file":"index.cjs","names":["createOpenapiFetchClient","createAuthHeaders"],"sources":["../../src/clients/ai/aiClient.ts"],"sourcesContent":["import { createOpenapiFetchClient } from '../../fetchClient';\nimport { createAuthHeaders } from '../auth';\nimport type { ClientInitOptions } from '../types';\n\nimport type { paths } from './__generated__/schema';\nimport type {\n  DescribeConfigurationBody,\n  DescribeConfigurationMergeBody,\n  DescribeConfigurationVersionBody,\n  DocsQuestionBody,\n  ExplainErrorBody,\n  SuggestComponentBody,\n} from './types';\n\nexport const createAiClient = ({ baseUrl, middlewares, auth }: ClientInitOptions) => {\n  const client = createOpenapiFetchClient<paths>({\n    baseUrl,\n    middlewares,\n    headers: createAuthHeaders(auth),\n  });\n\n  const describeConfigurationVersion = async (body: DescribeConfigurationVersionBody) => {\n    const { data } = await client.post('/describe/configuration-version', { body });\n\n    return data;\n  };\n\n  const describeConfigurationMerge = async (body: DescribeConfigurationMergeBody) => {\n    const { data } = await client.post('/describe/configuration-merge', { body });\n\n    return data;\n  };\n\n  const explainError = async (body: ExplainErrorBody) => {\n    const { data } = await client.post('/explain', { body });\n\n    return data;\n  };\n\n  const describeConfiguration = async (body: DescribeConfigurationBody) => {\n    const { data } = await client.post('/describe/configuration', { body });\n\n    return data;\n  };\n\n  const suggestComponent = async (body: SuggestComponentBody) => {\n    const { data } = await client.post('/suggest/component', { body });\n\n    return data;\n  };\n\n  /** Answers a question using the Keboola documentation as a source. */\n  const docsQuestion = async (body: DocsQuestionBody) => {\n    const { data } = await client.post('/docs/question', { body });\n\n    return data;\n  };\n\n  /** Retrieves documentation details for a single component. */\n  const getComponentDetail = async (componentId: string) => {\n    const { data } = await client.get('/docs/components/{componentId}', {\n      path: { componentId },\n    });\n\n    return data;\n  };\n\n  const healthCheck = async (signal?: AbortSignal) => {\n    const { data } = await client.get('/health-check', {}, { signal });\n\n    return data;\n  };\n\n  return {\n    healthCheck,\n    describeConfigurationVersion,\n    describeConfigurationMerge,\n    explainError,\n    describeConfiguration,\n    suggestComponent,\n    docsQuestion,\n    getComponentDetail,\n  };\n};\n"],"mappings":";;;;AAcA,MAAa,kBAAkB,EAAE,SAAS,aAAa,WAA8B;CACnF,MAAM,SAASA,iCAAAA,yBAAgC;EAC7C;EACA;EACA,SAASC,aAAAA,kBAAkB,IAAI;CACjC,CAAC;CAED,MAAM,+BAA+B,OAAO,SAA2C;EACrF,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,mCAAmC,EAAE,KAAK,CAAC;EAE9E,OAAO;CACT;CAEA,MAAM,6BAA6B,OAAO,SAAyC;EACjF,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,iCAAiC,EAAE,KAAK,CAAC;EAE5E,OAAO;CACT;CAEA,MAAM,eAAe,OAAO,SAA2B;EACrD,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,YAAY,EAAE,KAAK,CAAC;EAEvD,OAAO;CACT;CAEA,MAAM,wBAAwB,OAAO,SAAoC;EACvE,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,2BAA2B,EAAE,KAAK,CAAC;EAEtE,OAAO;CACT;CAEA,MAAM,mBAAmB,OAAO,SAA+B;EAC7D,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,sBAAsB,EAAE,KAAK,CAAC;EAEjE,OAAO;CACT;;CAGA,MAAM,eAAe,OAAO,SAA2B;EACrD,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,kBAAkB,EAAE,KAAK,CAAC;EAE7D,OAAO;CACT;;CAGA,MAAM,qBAAqB,OAAO,gBAAwB;EACxD,MAAM,EAAE,SAAS,MAAM,OAAO,IAAI,kCAAkC,EAClE,MAAM,EAAE,YAAY,EACtB,CAAC;EAED,OAAO;CACT;CAEA,MAAM,cAAc,OAAO,WAAyB;EAClD,MAAM,EAAE,SAAS,MAAM,OAAO,IAAI,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAC;EAEjE,OAAO;CACT;CAEA,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF"}

package/dist/ai/index.d.cts

@@ -1,5 +1,5 @@
-import { a as DescribeConfigurationVersionBody, f as SuggestComponentBody, i as DescribeConfigurationMergeBody, l as ExplainErrorBody, p as components, r as DescribeConfigurationBody, s as DocsQuestionBody, u as FeedbackBody } from "../types-BBbzWczQ.cjs";
-import { n as ClientInitOptions } from "../types-OkQWmonU.cjs";
+import { a as DescribeConfigurationVersionBody, d as SuggestComponentBody, f as components, i as DescribeConfigurationMergeBody, l as ExplainErrorBody, r as DescribeConfigurationBody, s as DocsQuestionBody } from "../types-DV7K07oX.cjs";
+import { n as ClientInitOptions } from "../types-O6XM48J8.cjs";
 //#region src/clients/ai/aiClient.d.ts
 declare const createAiClient: ({ baseUrl, middlewares, auth }: ClientInitOptions) => {
   healthCheck: (signal?: AbortSignal) => Promise<{
@@ -25,7 +25,6 @@ declare const createAiClient: ({ baseUrl, middlewares, auth }: ClientInitOptions
     components: components['schemas']['SuggestedComponent'][];
     correlationId: string;
   }>;
-  feedback: (body: FeedbackBody) => Promise<never>;
   docsQuestion: (body: DocsQuestionBody) => Promise<{
     response: string;
     metadata: {

package/dist/ai/index.d.ts

@@ -1,5 +1,5 @@
-import { a as DescribeConfigurationVersionBody, f as SuggestComponentBody, i as DescribeConfigurationMergeBody, l as ExplainErrorBody, p as components, r as DescribeConfigurationBody, s as DocsQuestionBody, u as FeedbackBody } from "../types-BNPvFLgC.js";
-import { n as ClientInitOptions } from "../types-Cw9UISvM.js";
+import { a as DescribeConfigurationVersionBody, d as SuggestComponentBody, f as components, i as DescribeConfigurationMergeBody, l as ExplainErrorBody, r as DescribeConfigurationBody, s as DocsQuestionBody } from "../types-BOT6TgOS.js";
+import { n as ClientInitOptions } from "../types-CeqZuOEC.js";
 //#region src/clients/ai/aiClient.d.ts
 declare const createAiClient: ({ baseUrl, middlewares, auth }: ClientInitOptions) => {
   healthCheck: (signal?: AbortSignal) => Promise<{
@@ -25,7 +25,6 @@ declare const createAiClient: ({ baseUrl, middlewares, auth }: ClientInitOptions
     components: components['schemas']['SuggestedComponent'][];
     correlationId: string;
   }>;
-  feedback: (body: FeedbackBody) => Promise<never>;
   docsQuestion: (body: DocsQuestionBody) => Promise<{
     response: string;
     metadata: {

package/dist/ai/index.js

@@ -27,10 +27,6 @@ const createAiClient = ({ baseUrl, middlewares, auth }) => {
 		const { data } = await client.post("/suggest/component", { body });
 		return data;
 	};
-	const feedback = async (body) => {
-		const { data } = await client.post("/feedback", { body });
-		return data;
-	};
 	/** Answers a question using the Keboola documentation as a source. */
 	const docsQuestion = async (body) => {
 		const { data } = await client.post("/docs/question", { body });
@@ -52,7 +48,6 @@ const createAiClient = ({ baseUrl, middlewares, auth }) => {
 		explainError,
 		describeConfiguration,
 		suggestComponent,
-		feedback,
 		docsQuestion,
 		getComponentDetail
 	};

package/dist/ai/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/clients/ai/aiClient.ts"],"sourcesContent":["import { createOpenapiFetchClient } from '../../fetchClient';\nimport { createAuthHeaders } from '../auth';\nimport type { ClientInitOptions } from '../types';\n\nimport type { paths } from './__generated__/schema';\nimport type {\n  DescribeConfigurationBody,\n  DescribeConfigurationMergeBody,\n  DescribeConfigurationVersionBody,\n  DocsQuestionBody,\n  ExplainErrorBody,\n  FeedbackBody,\n  SuggestComponentBody,\n} from './types';\n\nexport const createAiClient = ({ baseUrl, middlewares, auth }: ClientInitOptions) => {\n  const client = createOpenapiFetchClient<paths>({\n    baseUrl,\n    middlewares,\n    headers: createAuthHeaders(auth),\n  });\n\n  const describeConfigurationVersion = async (body: DescribeConfigurationVersionBody) => {\n    const { data } = await client.post('/describe/configuration-version', { body });\n\n    return data;\n  };\n\n  const describeConfigurationMerge = async (body: DescribeConfigurationMergeBody) => {\n    const { data } = await client.post('/describe/configuration-merge', { body });\n\n    return data;\n  };\n\n  const explainError = async (body: ExplainErrorBody) => {\n    const { data } = await client.post('/explain', { body });\n\n    return data;\n  };\n\n  const describeConfiguration = async (body: DescribeConfigurationBody) => {\n    const { data } = await client.post('/describe/configuration', { body });\n\n    return data;\n  };\n\n  const suggestComponent = async (body: SuggestComponentBody) => {\n    const { data } = await client.post('/suggest/component', { body });\n\n    return data;\n  };\n\n  const feedback = async (body: FeedbackBody) => {\n    const { data } = await client.post('/feedback', { body });\n\n    return data;\n  };\n\n  /** Answers a question using the Keboola documentation as a source. */\n  const docsQuestion = async (body: DocsQuestionBody) => {\n    const { data } = await client.post('/docs/question', { body });\n\n    return data;\n  };\n\n  /** Retrieves documentation details for a single component. */\n  const getComponentDetail = async (componentId: string) => {\n    const { data } = await client.get('/docs/components/{componentId}', {\n      path: { componentId },\n    });\n\n    return data;\n  };\n\n  const healthCheck = async (signal?: AbortSignal) => {\n    const { data } = await client.get('/health-check', {}, { signal });\n\n    return data;\n  };\n\n  return {\n    healthCheck,\n    describeConfigurationVersion,\n    describeConfigurationMerge,\n    explainError,\n    describeConfiguration,\n    suggestComponent,\n    feedback,\n    docsQuestion,\n    getComponentDetail,\n  };\n};\n"],"mappings":";;;AAeA,MAAa,kBAAkB,EAAE,SAAS,aAAa,WAA8B;CACnF,MAAM,SAAS,yBAAgC;EAC7C;EACA;EACA,SAAS,kBAAkB,IAAI;CACjC,CAAC;CAED,MAAM,+BAA+B,OAAO,SAA2C;EACrF,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,mCAAmC,EAAE,KAAK,CAAC;EAE9E,OAAO;CACT;CAEA,MAAM,6BAA6B,OAAO,SAAyC;EACjF,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,iCAAiC,EAAE,KAAK,CAAC;EAE5E,OAAO;CACT;CAEA,MAAM,eAAe,OAAO,SAA2B;EACrD,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,YAAY,EAAE,KAAK,CAAC;EAEvD,OAAO;CACT;CAEA,MAAM,wBAAwB,OAAO,SAAoC;EACvE,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,2BAA2B,EAAE,KAAK,CAAC;EAEtE,OAAO;CACT;CAEA,MAAM,mBAAmB,OAAO,SAA+B;EAC7D,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,sBAAsB,EAAE,KAAK,CAAC;EAEjE,OAAO;CACT;CAEA,MAAM,WAAW,OAAO,SAAuB;EAC7C,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,aAAa,EAAE,KAAK,CAAC;EAExD,OAAO;CACT;;CAGA,MAAM,eAAe,OAAO,SAA2B;EACrD,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,kBAAkB,EAAE,KAAK,CAAC;EAE7D,OAAO;CACT;;CAGA,MAAM,qBAAqB,OAAO,gBAAwB;EACxD,MAAM,EAAE,SAAS,MAAM,OAAO,IAAI,kCAAkC,EAClE,MAAM,EAAE,YAAY,EACtB,CAAC;EAED,OAAO;CACT;CAEA,MAAM,cAAc,OAAO,WAAyB;EAClD,MAAM,EAAE,SAAS,MAAM,OAAO,IAAI,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAC;EAEjE,OAAO;CACT;CAEA,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/clients/ai/aiClient.ts"],"sourcesContent":["import { createOpenapiFetchClient } from '../../fetchClient';\nimport { createAuthHeaders } from '../auth';\nimport type { ClientInitOptions } from '../types';\n\nimport type { paths } from './__generated__/schema';\nimport type {\n  DescribeConfigurationBody,\n  DescribeConfigurationMergeBody,\n  DescribeConfigurationVersionBody,\n  DocsQuestionBody,\n  ExplainErrorBody,\n  SuggestComponentBody,\n} from './types';\n\nexport const createAiClient = ({ baseUrl, middlewares, auth }: ClientInitOptions) => {\n  const client = createOpenapiFetchClient<paths>({\n    baseUrl,\n    middlewares,\n    headers: createAuthHeaders(auth),\n  });\n\n  const describeConfigurationVersion = async (body: DescribeConfigurationVersionBody) => {\n    const { data } = await client.post('/describe/configuration-version', { body });\n\n    return data;\n  };\n\n  const describeConfigurationMerge = async (body: DescribeConfigurationMergeBody) => {\n    const { data } = await client.post('/describe/configuration-merge', { body });\n\n    return data;\n  };\n\n  const explainError = async (body: ExplainErrorBody) => {\n    const { data } = await client.post('/explain', { body });\n\n    return data;\n  };\n\n  const describeConfiguration = async (body: DescribeConfigurationBody) => {\n    const { data } = await client.post('/describe/configuration', { body });\n\n    return data;\n  };\n\n  const suggestComponent = async (body: SuggestComponentBody) => {\n    const { data } = await client.post('/suggest/component', { body });\n\n    return data;\n  };\n\n  /** Answers a question using the Keboola documentation as a source. */\n  const docsQuestion = async (body: DocsQuestionBody) => {\n    const { data } = await client.post('/docs/question', { body });\n\n    return data;\n  };\n\n  /** Retrieves documentation details for a single component. */\n  const getComponentDetail = async (componentId: string) => {\n    const { data } = await client.get('/docs/components/{componentId}', {\n      path: { componentId },\n    });\n\n    return data;\n  };\n\n  const healthCheck = async (signal?: AbortSignal) => {\n    const { data } = await client.get('/health-check', {}, { signal });\n\n    return data;\n  };\n\n  return {\n    healthCheck,\n    describeConfigurationVersion,\n    describeConfigurationMerge,\n    explainError,\n    describeConfiguration,\n    suggestComponent,\n    docsQuestion,\n    getComponentDetail,\n  };\n};\n"],"mappings":";;;AAcA,MAAa,kBAAkB,EAAE,SAAS,aAAa,WAA8B;CACnF,MAAM,SAAS,yBAAgC;EAC7C;EACA;EACA,SAAS,kBAAkB,IAAI;CACjC,CAAC;CAED,MAAM,+BAA+B,OAAO,SAA2C;EACrF,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,mCAAmC,EAAE,KAAK,CAAC;EAE9E,OAAO;CACT;CAEA,MAAM,6BAA6B,OAAO,SAAyC;EACjF,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,iCAAiC,EAAE,KAAK,CAAC;EAE5E,OAAO;CACT;CAEA,MAAM,eAAe,OAAO,SAA2B;EACrD,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,YAAY,EAAE,KAAK,CAAC;EAEvD,OAAO;CACT;CAEA,MAAM,wBAAwB,OAAO,SAAoC;EACvE,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,2BAA2B,EAAE,KAAK,CAAC;EAEtE,OAAO;CACT;CAEA,MAAM,mBAAmB,OAAO,SAA+B;EAC7D,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,sBAAsB,EAAE,KAAK,CAAC;EAEjE,OAAO;CACT;;CAGA,MAAM,eAAe,OAAO,SAA2B;EACrD,MAAM,EAAE,SAAS,MAAM,OAAO,KAAK,kBAAkB,EAAE,KAAK,CAAC;EAE7D,OAAO;CACT;;CAGA,MAAM,qBAAqB,OAAO,gBAAwB;EACxD,MAAM,EAAE,SAAS,MAAM,OAAO,IAAI,kCAAkC,EAClE,MAAM,EAAE,YAAY,EACtB,CAAC;EAED,OAAO;CACT;CAEA,MAAM,cAAc,OAAO,WAAyB;EAClD,MAAM,EAAE,SAAS,MAAM,OAAO,IAAI,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAC;EAEjE,OAAO;CACT;CAEA,OAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF"}

package/dist/ai/types.d.cts

@@ -1,2 +1,2 @@
-import { a as DescribeConfigurationVersionBody, c as ErrorExplanation, d as ObjectDescription, f as SuggestComponentBody, i as DescribeConfigurationMergeBody, l as ExplainErrorBody, n as ComponentSuggestion, o as DocsAnswer, r as DescribeConfigurationBody, s as DocsQuestionBody, t as ComponentDocsDetail, u as FeedbackBody } from "../types-BBbzWczQ.cjs";
-export { ComponentDocsDetail, ComponentSuggestion, DescribeConfigurationBody, DescribeConfigurationMergeBody, DescribeConfigurationVersionBody, DocsAnswer, DocsQuestionBody, ErrorExplanation, ExplainErrorBody, FeedbackBody, ObjectDescription, SuggestComponentBody };
+import { a as DescribeConfigurationVersionBody, c as ErrorExplanation, d as SuggestComponentBody, i as DescribeConfigurationMergeBody, l as ExplainErrorBody, n as ComponentSuggestion, o as DocsAnswer, r as DescribeConfigurationBody, s as DocsQuestionBody, t as ComponentDocsDetail, u as ObjectDescription } from "../types-DV7K07oX.cjs";
+export { ComponentDocsDetail, ComponentSuggestion, DescribeConfigurationBody, DescribeConfigurationMergeBody, DescribeConfigurationVersionBody, DocsAnswer, DocsQuestionBody, ErrorExplanation, ExplainErrorBody, ObjectDescription, SuggestComponentBody };

package/dist/ai/types.d.ts

@@ -1,2 +1,2 @@
-import { a as DescribeConfigurationVersionBody, c as ErrorExplanation, d as ObjectDescription, f as SuggestComponentBody, i as DescribeConfigurationMergeBody, l as ExplainErrorBody, n as ComponentSuggestion, o as DocsAnswer, r as DescribeConfigurationBody, s as DocsQuestionBody, t as ComponentDocsDetail, u as FeedbackBody } from "../types-BNPvFLgC.js";
-export { ComponentDocsDetail, ComponentSuggestion, DescribeConfigurationBody, DescribeConfigurationMergeBody, DescribeConfigurationVersionBody, DocsAnswer, DocsQuestionBody, ErrorExplanation, ExplainErrorBody, FeedbackBody, ObjectDescription, SuggestComponentBody };
+import { a as DescribeConfigurationVersionBody, c as ErrorExplanation, d as SuggestComponentBody, i as DescribeConfigurationMergeBody, l as ExplainErrorBody, n as ComponentSuggestion, o as DocsAnswer, r as DescribeConfigurationBody, s as DocsQuestionBody, t as ComponentDocsDetail, u as ObjectDescription } from "../types-BOT6TgOS.js";
+export { ComponentDocsDetail, ComponentSuggestion, DescribeConfigurationBody, DescribeConfigurationMergeBody, DescribeConfigurationVersionBody, DocsAnswer, DocsQuestionBody, ErrorExplanation, ExplainErrorBody, ObjectDescription, SuggestComponentBody };

package/dist/{appLogs-xW0-JQXg.d.ts → appLogs-DI2Y4imY.d.ts}

@@ -1,4 +1,4 @@
-import "./index-r6YSe8B-.js";
+import "./index-BPMr8PQJ.js";
 //#region src/domain/appLogs.d.ts
 type LogEntry = {
   timestamp: string | null;
@@ -7,4 +7,4 @@ type LogEntry = {
 declare const parseLogLines: (raw: unknown) => LogEntry[];
 //#endregion
 export { parseLogLines as n, LogEntry as t };
-//# sourceMappingURL=appLogs-xW0-JQXg.d.ts.map
+//# sourceMappingURL=appLogs-DI2Y4imY.d.ts.map

package/dist/{appLogs-Cxhm2Rkn.d.cts → appLogs-IhRA3xyv.d.cts}

@@ -1,4 +1,4 @@
-import "./index-XaPb6unB.cjs";
+import "./index-CL4iKFic.cjs";
 //#region src/domain/appLogs.d.ts
 type LogEntry = {
   timestamp: string | null;
@@ -7,4 +7,4 @@ type LogEntry = {
 declare const parseLogLines: (raw: unknown) => LogEntry[];
 //#endregion
 export { parseLogLines as n, LogEntry as t };
-//# sourceMappingURL=appLogs-Cxhm2Rkn.d.cts.map
+//# sourceMappingURL=appLogs-IhRA3xyv.d.cts.map

package/dist/apps/index.cjs

@@ -47,12 +47,12 @@ const createAppsClient = ({ baseUrl, middlewares, auth }) => {
 		const { data } = await client.post("/apps/{appId}/unpublish", { path: { appId } }, { signal });
 		return data;
 	};
-	/** Sleeps the app and disarms wake-on-request: visitors get `503` until {@link resumeApp}. */
+	/** Sleeps the app now; the next visitor wakes it, as after an idle auto-suspend. */
 	const suspendApp = async (appId, signal) => {
 		const { data } = await client.post("/apps/{appId}/suspend", { path: { appId } }, { signal });
 		return data;
 	};
-	/** Wakes the app and re-arms wake-on-request. The returned app still reports `starting`. */
+	/** Wakes the app now and clears a failure stop (`disabled`). A stopped app comes back `starting`. */
 	const resumeApp = async (appId, signal) => {
 		const { data } = await client.post("/apps/{appId}/resume", { path: { appId } }, { signal });
 		return data;
@@ -95,7 +95,7 @@ const createAppsClient = ({ baseUrl, middlewares, auth }) => {
 		}, writeOptions(options));
 		return data;
 	};
-	/** Deployment history, newest first. Omitting `query.archived` returns deleted ones too. */
+	/** Live deployment history, newest first; `query.archived: true` lists the deleted ones instead. */
 	const getDeployments = async (appId, query = {}, signal) => {
 		const { data } = await client.get("/apps/{appId}/deployments", {
 			path: { appId },

package/dist/apps/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["createOpenapiFetchClient","createAuthHeaders","readAppLogsTail","readAppLogsDownload"],"sources":["../../src/clients/apps/appsClient.ts"],"sourcesContent":["import { readAppLogsDownload, readAppLogsTail } from '../../domain/appLogs';\nimport { createOpenapiFetchClient } from '../../fetchClient';\nimport { createAuthHeaders } from '../auth';\nimport type { ClientInitOptions } from '../types';\n\nimport type { paths } from './__generated__/schema';\nimport type {\n  App,\n  AppId,\n  CreateAppBody,\n  CreateCredentialBody,\n  CreateDeploymentBody,\n  CredentialId,\n  DeploymentId,\n  GetAppRunsQuery,\n  GetAppsQuery,\n  GetDeploymentsQuery,\n  GetLogsTailQuery,\n  RunId,\n} from './types';\n\n/**\n * Options every write takes.\n *\n * - No `idempotencyKey`: the service ignores it, so a retried create may duplicate.\n */\ntype WriteOptions = {\n  signal?: AbortSignal;\n};\n\ntype LogsTailOptions = {\n  query?: GetLogsTailQuery;\n  signal?: AbortSignal;\n};\n\n/**\n * `/v2` App Deployments — data apps and their immutable deployment history.\n *\n * - `/v1` of the same service is the `dataScience` client.\n * - `baseUrl` must already end in `/v2`; `createServiceClients` composes it.\n * - `POST /apps/{appId}/activity` is absent: it needs a Manage token with `apps:proxy` scope.\n */\nexport const createAppsClient = ({ baseUrl, middlewares, auth }: ClientInitOptions) => {\n  const client = createOpenapiFetchClient<paths>({\n    baseUrl,\n    middlewares,\n    headers: createAuthHeaders(auth),\n  });\n\n  const writeOptions = ({ signal }: WriteOptions) => ({ signal });\n\n  /** Service metadata — the `/v2` surface has no `/health-check`. */\n  const healthCheck = async (signal?: AbortSignal) => {\n    const { data } = await client.get('/', {}, { signal });\n\n    return data;\n  };\n\n  const getApps = async (query: GetAppsQuery = {}, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps', { query }, { signal });\n\n    return data;\n  };\n\n  const getApp = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps/{appId}', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /**\n   * Reserves the app and its Storage configuration only.\n   *\n   * - `parameters` and `authorization.app_proxy` are written afterwards via the Storage API.\n   */\n  const createApp = async (body: CreateAppBody, options: WriteOptions = {}) => {\n    const { data } = await client.post('/apps', { body }, writeOptions(options));\n\n    return data;\n  };\n\n  const deleteApp = async (appId: AppId, signal?: AbortSignal) => {\n    await client.delete('/apps/{appId}', { path: { appId } }, { signal });\n  };\n\n  /** Drops production routing (URL 404s). A no-op returns the app unchanged, not an error. */\n  const unpublishApp = async (appId: AppId, signal?: AbortSignal): Promise<App> => {\n    const { data } = await client.post('/apps/{appId}/unpublish', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /** Sleeps the app and disarms wake-on-request: visitors get `503` until {@link resumeApp}. */\n  const suspendApp = async (appId: AppId, signal?: AbortSignal): Promise<App> => {\n    const { data } = await client.post('/apps/{appId}/suspend', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /** Wakes the app and re-arms wake-on-request. The returned app still reports `starting`. */\n  const resumeApp = async (appId: AppId, signal?: AbortSignal): Promise<App> => {\n    const { data } = await client.post('/apps/{appId}/resume', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /** `null` until the first deployment or {@link resetAppPassword} mints one. */\n  const getAppPassword = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps/{appId}/password', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /** Replaces any existing password. Read it back with {@link getAppPassword}. */\n  const resetAppPassword = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.post(\n      '/apps/{appId}/password/reset',\n      { path: { appId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /** App-wide runs, newest first — where a failed deployment's `failureReason` lives. */\n  const getAppRuns = async (appId: AppId, query: GetAppRunsQuery = {}, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps/{appId}/runs', { path: { appId }, query }, { signal });\n\n    return data;\n  };\n\n  const getAppRun = async (appId: AppId, runId: RunId, signal?: AbortSignal) => {\n    const { data } = await client.get(\n      '/apps/{appId}/runs/{runId}',\n      { path: { appId, runId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /**\n   * Deploys the current config version as a new immutable deployment.\n   *\n   * - Promotes it unless `body.promote` is `false`; a staged release never runs until promoted.\n   * - Returns synchronously; readiness does not.\n   */\n  const createDeployment = async (\n    appId: AppId,\n    body?: CreateDeploymentBody,\n    options: WriteOptions = {},\n  ) => {\n    const { data } = await client.post(\n      '/apps/{appId}/deployments',\n      { path: { appId }, body },\n      writeOptions(options),\n    );\n\n    return data;\n  };\n\n  /** Deployment history, newest first. Omitting `query.archived` returns deleted ones too. */\n  const getDeployments = async (\n    appId: AppId,\n    query: GetDeploymentsQuery = {},\n    signal?: AbortSignal,\n  ) => {\n    const { data } = await client.get(\n      '/apps/{appId}/deployments',\n      { path: { appId }, query },\n      { signal },\n    );\n\n    return data;\n  };\n\n  const getDeployment = async (appId: AppId, deploymentId: DeploymentId, signal?: AbortSignal) => {\n    const { data } = await client.get(\n      '/apps/{appId}/deployments/{deploymentId}',\n      { path: { appId, deploymentId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /** Deletes the deployment, keeping its row as `archived`. `409` while it is production. */\n  const deleteDeployment = async (\n    appId: AppId,\n    deploymentId: DeploymentId,\n    signal?: AbortSignal,\n  ) => {\n    await client.delete(\n      '/apps/{appId}/deployments/{deploymentId}',\n      { path: { appId, deploymentId } },\n      { signal },\n    );\n  };\n\n  /**\n   * Makes this deployment production; also the rollback.\n   *\n   * - Routing switches once it serves; `desired`/`actualDeploymentId` differ until then.\n   */\n  const promoteDeployment = async (\n    appId: AppId,\n    deploymentId: DeploymentId,\n    signal?: AbortSignal,\n  ): Promise<App> => {\n    const { data } = await client.post(\n      '/apps/{appId}/deployments/{deploymentId}/promote',\n      { path: { appId, deploymentId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /** Serving container's log. `query.since` and `query.lines` are mutually exclusive. */\n  const getAppLogsTail = (appId: AppId, { query, signal }: LogsTailOptions = {}) =>\n    readAppLogsTail(() =>\n      client.get('/apps/{appId}/logs/tail', { path: { appId }, query }, { signal }),\n    );\n\n  const getAppLogsDownload = (appId: AppId, signal?: AbortSignal) =>\n    readAppLogsDownload(() =>\n      client.get('/apps/{appId}/logs/download', { path: { appId } }, { signal }),\n    );\n\n  const getDeploymentLogsTail = (\n    appId: AppId,\n    deploymentId: DeploymentId,\n    { query, signal }: LogsTailOptions = {},\n  ) =>\n    readAppLogsTail(() =>\n      client.get(\n        '/apps/{appId}/deployments/{deploymentId}/logs/tail',\n        { path: { appId, deploymentId }, query },\n        { signal },\n      ),\n    );\n\n  const getDeploymentLogsDownload = (\n    appId: AppId,\n    deploymentId: DeploymentId,\n    signal?: AbortSignal,\n  ) =>\n    readAppLogsDownload(() =>\n      client.get(\n        '/apps/{appId}/deployments/{deploymentId}/logs/download',\n        { path: { appId, deploymentId } },\n        { signal },\n      ),\n    );\n\n  /** `409` when the app has no Git repository configured. */\n  const getAppGitRepo = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps/{appId}/git-repo', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /** Per app, not per deployment. */\n  const getAppGitRepoCredentials = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.get(\n      '/apps/{appId}/git-repo/credentials',\n      { path: { appId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  const getAppGitRepoCredential = async (\n    appId: AppId,\n    credentialId: CredentialId,\n    signal?: AbortSignal,\n  ) => {\n    const { data } = await client.get(\n      '/apps/{appId}/git-repo/credentials/{credentialId}',\n      { path: { appId, credentialId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /** An `http_token` credential's `secret` is returned only here. */\n  const createAppGitRepoCredential = async (\n    appId: AppId,\n    body: CreateCredentialBody,\n    options: WriteOptions = {},\n  ) => {\n    const { data } = await client.post(\n      '/apps/{appId}/git-repo/credentials',\n      { path: { appId }, body },\n      writeOptions(options),\n    );\n\n    return data;\n  };\n\n  const deleteAppGitRepoCredential = async (\n    appId: AppId,\n    credentialId: CredentialId,\n    signal?: AbortSignal,\n  ) => {\n    await client.delete(\n      '/apps/{appId}/git-repo/credentials/{credentialId}',\n      { path: { appId, credentialId } },\n      { signal },\n    );\n  };\n\n  return {\n    healthCheck,\n    getApps,\n    getApp,\n    createApp,\n    deleteApp,\n    unpublishApp,\n    suspendApp,\n    resumeApp,\n    getAppPassword,\n    resetAppPassword,\n    getAppRuns,\n    getAppRun,\n    createDeployment,\n    getDeployments,\n    getDeployment,\n    deleteDeployment,\n    promoteDeployment,\n    getAppLogsTail,\n    getAppLogsDownload,\n    getDeploymentLogsTail,\n    getDeploymentLogsDownload,\n    getAppGitRepo,\n    getAppGitRepoCredentials,\n    getAppGitRepoCredential,\n    createAppGitRepoCredential,\n    deleteAppGitRepoCredential,\n  };\n};\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["createOpenapiFetchClient","createAuthHeaders","readAppLogsTail","readAppLogsDownload"],"sources":["../../src/clients/apps/appsClient.ts"],"sourcesContent":["import { readAppLogsDownload, readAppLogsTail } from '../../domain/appLogs';\nimport { createOpenapiFetchClient } from '../../fetchClient';\nimport { createAuthHeaders } from '../auth';\nimport type { ClientInitOptions } from '../types';\n\nimport type { paths } from './__generated__/schema';\nimport type {\n  App,\n  AppId,\n  CreateAppBody,\n  CreateCredentialBody,\n  CreateDeploymentBody,\n  CredentialId,\n  DeploymentId,\n  GetAppRunsQuery,\n  GetAppsQuery,\n  GetDeploymentsQuery,\n  GetLogsTailQuery,\n  RunId,\n} from './types';\n\n/**\n * Options every write takes.\n *\n * - No `idempotencyKey`: the service ignores it, so a retried create may duplicate.\n */\ntype WriteOptions = {\n  signal?: AbortSignal;\n};\n\ntype LogsTailOptions = {\n  query?: GetLogsTailQuery;\n  signal?: AbortSignal;\n};\n\n/**\n * `/v2` App Deployments — data apps and their immutable deployment history.\n *\n * - `/v1` of the same service is the `dataScience` client.\n * - `baseUrl` must already end in `/v2`; `createServiceClients` composes it.\n * - `POST /apps/{appId}/activity` is absent: it needs a Manage token with `apps:proxy` scope.\n */\nexport const createAppsClient = ({ baseUrl, middlewares, auth }: ClientInitOptions) => {\n  const client = createOpenapiFetchClient<paths>({\n    baseUrl,\n    middlewares,\n    headers: createAuthHeaders(auth),\n  });\n\n  const writeOptions = ({ signal }: WriteOptions) => ({ signal });\n\n  /** Service metadata — the `/v2` surface has no `/health-check`. */\n  const healthCheck = async (signal?: AbortSignal) => {\n    const { data } = await client.get('/', {}, { signal });\n\n    return data;\n  };\n\n  const getApps = async (query: GetAppsQuery = {}, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps', { query }, { signal });\n\n    return data;\n  };\n\n  const getApp = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps/{appId}', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /**\n   * Reserves the app and its Storage configuration only.\n   *\n   * - `parameters` and `authorization.app_proxy` are written afterwards via the Storage API.\n   */\n  const createApp = async (body: CreateAppBody, options: WriteOptions = {}) => {\n    const { data } = await client.post('/apps', { body }, writeOptions(options));\n\n    return data;\n  };\n\n  const deleteApp = async (appId: AppId, signal?: AbortSignal) => {\n    await client.delete('/apps/{appId}', { path: { appId } }, { signal });\n  };\n\n  /** Drops production routing (URL 404s). A no-op returns the app unchanged, not an error. */\n  const unpublishApp = async (appId: AppId, signal?: AbortSignal): Promise<App> => {\n    const { data } = await client.post('/apps/{appId}/unpublish', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /** Sleeps the app now; the next visitor wakes it, as after an idle auto-suspend. */\n  const suspendApp = async (appId: AppId, signal?: AbortSignal): Promise<App> => {\n    const { data } = await client.post('/apps/{appId}/suspend', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /** Wakes the app now and clears a failure stop (`disabled`). A stopped app comes back `starting`. */\n  const resumeApp = async (appId: AppId, signal?: AbortSignal): Promise<App> => {\n    const { data } = await client.post('/apps/{appId}/resume', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /** `null` until the first deployment or {@link resetAppPassword} mints one. */\n  const getAppPassword = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps/{appId}/password', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /** Replaces any existing password. Read it back with {@link getAppPassword}. */\n  const resetAppPassword = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.post(\n      '/apps/{appId}/password/reset',\n      { path: { appId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /** App-wide runs, newest first — where a failed deployment's `failureReason` lives. */\n  const getAppRuns = async (appId: AppId, query: GetAppRunsQuery = {}, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps/{appId}/runs', { path: { appId }, query }, { signal });\n\n    return data;\n  };\n\n  const getAppRun = async (appId: AppId, runId: RunId, signal?: AbortSignal) => {\n    const { data } = await client.get(\n      '/apps/{appId}/runs/{runId}',\n      { path: { appId, runId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /**\n   * Deploys the current config version as a new immutable deployment.\n   *\n   * - Promotes it unless `body.promote` is `false`; a staged release never runs until promoted.\n   * - Returns synchronously; readiness does not.\n   */\n  const createDeployment = async (\n    appId: AppId,\n    body?: CreateDeploymentBody,\n    options: WriteOptions = {},\n  ) => {\n    const { data } = await client.post(\n      '/apps/{appId}/deployments',\n      { path: { appId }, body },\n      writeOptions(options),\n    );\n\n    return data;\n  };\n\n  /** Live deployment history, newest first; `query.archived: true` lists the deleted ones instead. */\n  const getDeployments = async (\n    appId: AppId,\n    query: GetDeploymentsQuery = {},\n    signal?: AbortSignal,\n  ) => {\n    const { data } = await client.get(\n      '/apps/{appId}/deployments',\n      { path: { appId }, query },\n      { signal },\n    );\n\n    return data;\n  };\n\n  const getDeployment = async (appId: AppId, deploymentId: DeploymentId, signal?: AbortSignal) => {\n    const { data } = await client.get(\n      '/apps/{appId}/deployments/{deploymentId}',\n      { path: { appId, deploymentId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /** Deletes the deployment, keeping its row as `archived`. `409` while it is production. */\n  const deleteDeployment = async (\n    appId: AppId,\n    deploymentId: DeploymentId,\n    signal?: AbortSignal,\n  ) => {\n    await client.delete(\n      '/apps/{appId}/deployments/{deploymentId}',\n      { path: { appId, deploymentId } },\n      { signal },\n    );\n  };\n\n  /**\n   * Makes this deployment production; also the rollback.\n   *\n   * - Routing switches once it serves; `desired`/`actualDeploymentId` differ until then.\n   */\n  const promoteDeployment = async (\n    appId: AppId,\n    deploymentId: DeploymentId,\n    signal?: AbortSignal,\n  ): Promise<App> => {\n    const { data } = await client.post(\n      '/apps/{appId}/deployments/{deploymentId}/promote',\n      { path: { appId, deploymentId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /** Serving container's log. `query.since` and `query.lines` are mutually exclusive. */\n  const getAppLogsTail = (appId: AppId, { query, signal }: LogsTailOptions = {}) =>\n    readAppLogsTail(() =>\n      client.get('/apps/{appId}/logs/tail', { path: { appId }, query }, { signal }),\n    );\n\n  const getAppLogsDownload = (appId: AppId, signal?: AbortSignal) =>\n    readAppLogsDownload(() =>\n      client.get('/apps/{appId}/logs/download', { path: { appId } }, { signal }),\n    );\n\n  const getDeploymentLogsTail = (\n    appId: AppId,\n    deploymentId: DeploymentId,\n    { query, signal }: LogsTailOptions = {},\n  ) =>\n    readAppLogsTail(() =>\n      client.get(\n        '/apps/{appId}/deployments/{deploymentId}/logs/tail',\n        { path: { appId, deploymentId }, query },\n        { signal },\n      ),\n    );\n\n  const getDeploymentLogsDownload = (\n    appId: AppId,\n    deploymentId: DeploymentId,\n    signal?: AbortSignal,\n  ) =>\n    readAppLogsDownload(() =>\n      client.get(\n        '/apps/{appId}/deployments/{deploymentId}/logs/download',\n        { path: { appId, deploymentId } },\n        { signal },\n      ),\n    );\n\n  /** `409` when the app has no Git repository configured. */\n  const getAppGitRepo = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.get('/apps/{appId}/git-repo', { path: { appId } }, { signal });\n\n    return data;\n  };\n\n  /** Per app, not per deployment. */\n  const getAppGitRepoCredentials = async (appId: AppId, signal?: AbortSignal) => {\n    const { data } = await client.get(\n      '/apps/{appId}/git-repo/credentials',\n      { path: { appId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  const getAppGitRepoCredential = async (\n    appId: AppId,\n    credentialId: CredentialId,\n    signal?: AbortSignal,\n  ) => {\n    const { data } = await client.get(\n      '/apps/{appId}/git-repo/credentials/{credentialId}',\n      { path: { appId, credentialId } },\n      { signal },\n    );\n\n    return data;\n  };\n\n  /** An `http_token` credential's `secret` is returned only here. */\n  const createAppGitRepoCredential = async (\n    appId: AppId,\n    body: CreateCredentialBody,\n    options: WriteOptions = {},\n  ) => {\n    const { data } = await client.post(\n      '/apps/{appId}/git-repo/credentials',\n      { path: { appId }, body },\n      writeOptions(options),\n    );\n\n    return data;\n  };\n\n  const deleteAppGitRepoCredential = async (\n    appId: AppId,\n    credentialId: CredentialId,\n    signal?: AbortSignal,\n  ) => {\n    await client.delete(\n      '/apps/{appId}/git-repo/credentials/{credentialId}',\n      { path: { appId, credentialId } },\n      { signal },\n    );\n  };\n\n  return {\n    healthCheck,\n    getApps,\n    getApp,\n    createApp,\n    deleteApp,\n    unpublishApp,\n    suspendApp,\n    resumeApp,\n    getAppPassword,\n    resetAppPassword,\n    getAppRuns,\n    getAppRun,\n    createDeployment,\n    getDeployments,\n    getDeployment,\n    deleteDeployment,\n    promoteDeployment,\n    getAppLogsTail,\n    getAppLogsDownload,\n    getDeploymentLogsTail,\n    getDeploymentLogsDownload,\n    getAppGitRepo,\n    getAppGitRepoCredentials,\n    getAppGitRepoCredential,\n    createAppGitRepoCredential,\n    deleteAppGitRepoCredential,\n  };\n};\n"],"mappings":"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"}

package/dist/apps/index.d.cts

@@ -1,6 +1,6 @@
-import { n as ClientInitOptions } from "../types-OkQWmonU.cjs";
-import { C as components, S as RunId, b as GetDeploymentsQuery, c as CreateCredentialBody, f as CredentialId, g as DeploymentId, l as CreateDeploymentBody, r as AppId, s as CreateAppBody, t as App, v as GetAppRunsQuery, x as GetLogsTailQuery, y as GetAppsQuery } from "../types-L50Y6ATu.cjs";
-import { t as LogEntry } from "../appLogs-Cxhm2Rkn.cjs";
+import { n as ClientInitOptions } from "../types-O6XM48J8.cjs";
+import { C as components, S as RunId, b as GetDeploymentsQuery, c as CreateCredentialBody, f as CredentialId, g as DeploymentId, l as CreateDeploymentBody, r as AppId, s as CreateAppBody, t as App, v as GetAppRunsQuery, x as GetLogsTailQuery, y as GetAppsQuery } from "../types-dn6MHur3.cjs";
+import { t as LogEntry } from "../appLogs-IhRA3xyv.cjs";
 //#region src/clients/apps/appsClient.d.ts
 /**
  * Options every write takes.
@@ -35,6 +35,7 @@ declare const createAppsClient: ({ baseUrl, middlewares, auth }: ClientInitOptio
     configId: string;
     type?: 'streamlit' | 'python-js' | null;
     url: string | null;
+    hasManagedGitRepo: boolean;
     production: {
       desiredDeploymentId?: string | null;
       actualDeploymentId?: string | null;
@@ -49,6 +50,7 @@ declare const createAppsClient: ({ baseUrl, middlewares, auth }: ClientInitOptio
     configId: string;
     type?: 'streamlit' | 'python-js' | null;
     url: string | null;
+    hasManagedGitRepo: boolean;
     production: {
       desiredDeploymentId?: string | null;
       actualDeploymentId?: string | null;
@@ -63,6 +65,7 @@ declare const createAppsClient: ({ baseUrl, middlewares, auth }: ClientInitOptio
     configId: string;
     type?: 'streamlit' | 'python-js' | null;
     url: string | null;
+    hasManagedGitRepo: boolean;
     production: {
       desiredDeploymentId?: string | null;
       actualDeploymentId?: string | null;

package/dist/apps/index.d.ts

@@ -1,6 +1,6 @@
-import { n as ClientInitOptions } from "../types-Cw9UISvM.js";
-import { C as components, S as RunId, b as GetDeploymentsQuery, c as CreateCredentialBody, f as CredentialId, g as DeploymentId, l as CreateDeploymentBody, r as AppId, s as CreateAppBody, t as App, v as GetAppRunsQuery, x as GetLogsTailQuery, y as GetAppsQuery } from "../types-C3IQu1gV.js";
-import { t as LogEntry } from "../appLogs-xW0-JQXg.js";
+import { n as ClientInitOptions } from "../types-CeqZuOEC.js";
+import { C as components, S as RunId, b as GetDeploymentsQuery, c as CreateCredentialBody, f as CredentialId, g as DeploymentId, l as CreateDeploymentBody, r as AppId, s as CreateAppBody, t as App, v as GetAppRunsQuery, x as GetLogsTailQuery, y as GetAppsQuery } from "../types-CfXqFz2e.js";
+import { t as LogEntry } from "../appLogs-DI2Y4imY.js";
 //#region src/clients/apps/appsClient.d.ts
 /**
  * Options every write takes.
@@ -35,6 +35,7 @@ declare const createAppsClient: ({ baseUrl, middlewares, auth }: ClientInitOptio
     configId: string;
     type?: 'streamlit' | 'python-js' | null;
     url: string | null;
+    hasManagedGitRepo: boolean;
     production: {
       desiredDeploymentId?: string | null;
       actualDeploymentId?: string | null;
@@ -49,6 +50,7 @@ declare const createAppsClient: ({ baseUrl, middlewares, auth }: ClientInitOptio
     configId: string;
     type?: 'streamlit' | 'python-js' | null;
     url: string | null;
+    hasManagedGitRepo: boolean;
     production: {
       desiredDeploymentId?: string | null;
       actualDeploymentId?: string | null;
@@ -63,6 +65,7 @@ declare const createAppsClient: ({ baseUrl, middlewares, auth }: ClientInitOptio
     configId: string;
     type?: 'streamlit' | 'python-js' | null;
     url: string | null;
+    hasManagedGitRepo: boolean;
     production: {
       desiredDeploymentId?: string | null;
       actualDeploymentId?: string | null;

package/dist/apps/index.js

@@ -46,12 +46,12 @@ const createAppsClient = ({ baseUrl, middlewares, auth }) => {
 		const { data } = await client.post("/apps/{appId}/unpublish", { path: { appId } }, { signal });
 		return data;
 	};
-	/** Sleeps the app and disarms wake-on-request: visitors get `503` until {@link resumeApp}. */
+	/** Sleeps the app now; the next visitor wakes it, as after an idle auto-suspend. */
 	const suspendApp = async (appId, signal) => {
 		const { data } = await client.post("/apps/{appId}/suspend", { path: { appId } }, { signal });
 		return data;
 	};
-	/** Wakes the app and re-arms wake-on-request. The returned app still reports `starting`. */
+	/** Wakes the app now and clears a failure stop (`disabled`). A stopped app comes back `starting`. */
 	const resumeApp = async (appId, signal) => {
 		const { data } = await client.post("/apps/{appId}/resume", { path: { appId } }, { signal });
 		return data;
@@ -94,7 +94,7 @@ const createAppsClient = ({ baseUrl, middlewares, auth }) => {
 		}, writeOptions(options));
 		return data;
 	};
-	/** Deployment history, newest first. Omitting `query.archived` returns deleted ones too. */
+	/** Live deployment history, newest first; `query.archived: true` lists the deleted ones instead. */
 	const getDeployments = async (appId, query = {}, signal) => {
 		const { data } = await client.get("/apps/{appId}/deployments", {
 			path: { appId },