@lepsto/sdk-app 84.0.0

package/README.md

@@ -0,0 +1,233 @@
+# @lessly/sdk-app
+
+The Lessly SDK for App is a TypeScript SDK that provides runtime bindings and type-safe generated code for interacting with Lessly Platform APIs and services. This package generates type definitions and client bindings from API catalogs, enabling developers to build applications that consume Lessly platform services with full type safety and autocompletion.
+
+**Note:** The `src/gen` directory contains generated SDK code and should not be edited by hand. Generated files are produced by running `npm run generate` with an API catalog.
+
+The committed `src/gen` is a **convenience snapshot** — it lets the repo type-check, test, and build offline. It is **not** the source of truth: canonical generation happens **at publish time**, when Cloud Build regenerates `src/gen` from the live catalog before publishing. The catalog is **mid-migration**, so the committed snapshot's namespaces (currently `organization` and `playground`) will **grow as platform extensions migrate to `@lessly-platform/tools`** — a namespace only appears once its tools carry a REST binding (tools without one are excluded until migrated). Regenerate the snapshot with `npx tsx scripts/generate.ts <catalog.json> src/gen && npm run sync-exports` against the live catalog (`https://api.lessly.dev/catalog/tools`).
+
+## Usage
+
+Create a client with `createLesslyApp`, then call operations through the Proxy namespace tree:
+
+```ts
+import { createLesslyApp } from '@lessly/sdk-app';
+
+const sdk = createLesslyApp({
+  baseUrl: 'https://api.lessly.dev', // or a page-relative '/api' in the browser
+  productId: 'prod_123',
+  // getCsrfToken defaults to reading the `lessly_csrf` cookie; override for SSR/tests.
+});
+
+const connectors = await sdk.organization.connectors.list({ productId: 'prod_123' });
+await sdk.organization.product.create({ name: 'Acme' });
+```
+
+The available namespaces track the live catalog and grow as platform extensions migrate; check
+`package.json` `exports` (or `src/gen/manifest.gen.ts`) for what a given version exposes.
+
+### Operation identity on every method
+
+Every generated REST method is a callable that also carries its own catalog identity, typed as
+`((input: X) => Promise<Y>) & Operation`:
+
+```ts
+sdk.mail.domain.create.operationKey; // 'mail_domain_create' — the catalog tool name
+sdk.mail.domain.create.level;        // 'admin' — one of 'read' | 'write' | 'admin'
+```
+
+`level` comes verbatim from the platform catalog — the SDK transports it and never infers it from
+`readOnly` or the HTTP method. Read both off the method rather than rebuilding a tool name from the
+accessor path: a hyphenated resource (`sdk.tracking['event-names'].list`) joins several id
+segments, so the path is a lossy view of the name. The properties are own properties of the
+function, so they survive destructuring (`const { list } = sdk.organization.connectors`).
+
+`src/gen/manifest.gen.ts` additionally exports `operations`, the whole tool-name -> level table,
+for callers that need a level without holding a client.
+
+### Composer steps: `compositions`
+
+A catalog tool may declare a **composition** — the contract a workflow builder needs to offer that
+operation as a **step**. `src/gen/manifest.gen.ts` exports the whole table, re-exported from the
+package root:
+
+```ts
+import { compositions } from '@lessly/sdk-app';
+
+if ('mail_domain_create' in compositions) {
+  const step = compositions['mail_domain_create'];
+  step.label;            // 'Add a domain' — how a builder names the step
+  step.completion_event; // 'mail.domain.added' — the event that settles an async step
+  step.options;          // Record<string, string> — builder-level knobs
+  step.pii;              // input fields carrying personal data
+  step.secrets;          // input fields carrying secrets
+}
+```
+
+**Presence is the whole signal.** A key is in the map exactly when the catalog gave that tool a
+composition, and the value may legitimately be `{}` ("composable, nothing further to say"). Ask
+`name in compositions`; a truthiness test on `label` would drop a perfectly composable step.
+
+Every member is optional and the SDK reads none of them — the object is carried **verbatim** from
+the catalog into the generated map, so a key the platform adds reaches your App even before this
+SDK's `ToolComposition` type names it. Unlike `operations`, the map is **not** restricted to REST
+tools: composability is a property of the operation, not of its transport, so a ws-bound step is
+listed too.
+
+A tool gaining, losing or re-declaring a composition ships as a **minor** — the map only ever gains
+or loses a key, and no exported symbol appears or disappears with it.
+
+Streaming (`<tool>Connect`) factories carry neither field: a socket is neither a read nor a write,
+and the catalog declares no level for a ws-only tool.
+
+Errors are surfaced as a typed `LesslyApiError` (`status`, `code`, `body`). Mutating calls
+without the `lessly_csrf` cookie fail before the network with `status: 0` and
+`code: 'csrf_cookie_missing'` — no retry, no hidden refresh.
+
+### TanStack Query
+
+Each namespace subpath (`@lessly/sdk-app/<namespace>`) also ships framework-agnostic
+query/mutation **option factories** — plain objects, not hooks — usable with any
+TanStack Query adapter (React, Solid, Vue, Svelte). You pass the `sdk` instance
+explicitly:
+
+```ts
+// React example — works the same with any @tanstack/*-query adapter.
+import { useQuery, useMutation } from '@tanstack/react-query';
+import {
+  organizationConnectorsListQueryOptions,
+  organizationProductCreateMutationOptions,
+} from '@lessly/sdk-app/organization';
+
+function Connectors() {
+  const { data } = useQuery(organizationConnectorsListQueryOptions(sdk, { productId: 'prod_123' }));
+  const create = useMutation(organizationProductCreateMutationOptions(sdk));
+  // create.mutate({ name: 'Acme' })
+}
+```
+
+The factories return `{ queryKey, queryFn }` (and `{ mutationKey, mutationFn }`),
+so they also work directly with `queryClient.ensureQueryData(...)` and friends.
+This package has **no runtime dependencies** — bring your own TanStack Query adapter.
+
+## Publishing
+
+This repo holds source only — **humans push code to GitHub, builds run in dev-console
+via Cloud Build, and the published package lives on npmjs.** Nothing commits or pushes back to
+this repo automatically; the catalog snapshot and changelog are stored in GCS, not in git.
+
+Cloud Build clones the repo read-only and drives the runner-agnostic pipeline CLI:
+
+```sh
+npm run ci -- --channel <next|latest> --catalog-url <URL> [--baseline <path>]
+```
+
+- `--channel` — the npm dist-tag to publish under (`next` for staging, `latest` for production).
+- `--catalog-url` — the public catalog endpoint, fetched with an anonymous GET
+  (staging `https://api.lessly.dev/catalog/tools`, production `https://api.lessly.com/catalog/tools`).
+- `--baseline` — path to the previous catalog snapshot (downloaded from GCS) used for the
+  content-hash gate and the semver diff-classifier. **Omit it for the first publish.**
+
+The very first publish on the (empty) npmjs registry is floored at **`0.2.0`**, not `0.1.0`,
+so it lands strictly above the legacy GAR `0.1.x` line that existing consumers pinned (e.g.
+`^0.1.1`). This mirrors the `@lessly/ui` migration (GAR `0.1.0` → npmjs `0.2.0`). Once a version
+exists on a channel's dist-tag, normal semver bumping (and the recovery patch-bump) takes over.
+The floor is keyed off the **registry**, not the flag: if the channel's dist-tag resolves to
+nothing (empty npmjs), the run takes the first-publish path even when Cloud Build passes a stored
+(GAR-era) baseline — the baseline is ignored and the freshly-fetched catalog ships as the `0.2.0`
+initial release. So Cloud Build may keep passing the stored baseline through the migration without
+erroring.
+
+Because npm versions are immutable **package-wide** (not per-dist-tag), a missing channel tag does
+not by itself mean an empty registry. The pipeline therefore also checks the package-wide max
+version: if a tag is absent but the package already carries versions under another tag (e.g. `next`
+published `0.2.0` and a first production run finds `latest` absent), it force-publishes a **fresh
+patch bumped past that max** so `npm publish --tag <channel>` seeds the tag without a 409 on the
+already-published version. The genuine `0.2.0` first-publish floor applies only when the package
+has **no versions anywhere**.
+
+The CLI fetches the catalog, regenerates `src/gen`, and compares against the baseline. When
+the generated output changed it bumps the version in `package.json` (base version resolved
+from `npm view @lessly/sdk-app dist-tags` against the configured registry, per channel —
+see "Registry: public npmjs" below), appends `CHANGELOG.md`, and writes:
+
+- `out/result.json` — `{ publish_needed, level, version }` (always written).
+- `out/new-snapshot.json` — the new snapshot (written only when a publish is needed; see
+  "Snapshot shape" below).
+
+The CLI performs **no git, gcloud, or npm-publish operations** — it is pure Node. Cloud Build
+reads `out/result.json`, then runs `npm publish` and uploads the new snapshot + changelog to
+GCS itself.
+
+### Registry: public npmjs
+
+The package now publishes to **public npmjs**, not GAR: `package.json` sets
+`publishConfig.registry = https://registry.npmjs.org/` and `publishConfig.access = public`.
+Cloud Build publishes each channel under its own dist-tag — `next` for staging, `latest` for
+production.
+
+**Scope split (#493):** `@lessly` is **public-only** (npmjs); internal packages live in GAR under
+`@lessly-platform`. The repo `.npmrc` encodes exactly that — `@lessly` -> npmjs,
+`@lessly-platform` -> GAR (with `always-auth`). `@lessly/sdk-app` is **never** published to GAR
+again. `scripts/npmrc.test.ts` guards both mappings.
+
+**Scope-override gotcha:** a scoped `.npmrc` registry entry **outranks** both
+`publishConfig.registry` and a bare `--registry` flag for npm's own resolution — that is how an
+early run leaked a lookup to GAR. So every scripted npm call pins the scope explicitly, and the
+`rebuild_sdk` Cloud Build step MUST publish via the canonical script (or the identical command):
+
+```sh
+npm run publish:npmjs
+# == npm publish --registry https://registry.npmjs.org/ --@lessly:registry=https://registry.npmjs.org/
+```
+
+Base-version resolution (the `npm view` lookups inside the pipeline CLI — both the per-channel
+version and the package-wide max-version probe) follows the same rule, and in **two** steps:
+it reads the registry from `package.json`'s `publishConfig.registry` first (falling back to the
+`.npmrc` `@lessly:registry` value if absent), **and** passes that registry as an explicit CLI
+scope override (`--@lessly:registry=<registry>`) on every `npm view`. The `--registry` flag alone
+is not enough: because the package is scoped `@lessly`, the `.npmrc` `@lessly:registry=<GAR>` entry
+would otherwise outrank it and silently resolve the lookup against GAR — which is exactly how an
+early run read GAR's `0.1.x` line instead of the empty npmjs registry and skipped the `0.2.0`
+floor. This requires no change to the CLI's `--channel`/`--catalog-url`/`--baseline` contract.
+
+### Runtime changes: `runtime-bump.json`
+
+The catalog diff only classifies **generated** code. The hand-written runtime (`src/runtime`, plus
+`src/react` when present) is gated separately: the pipeline content-hashes those trees into
+`runtimeHash` and stores it in the snapshot, so a runtime-only change publishes on its own instead
+of waiting for an unrelated catalog change.
+
+A runtime change ships at least a **PATCH**. To publish it at a higher level, commit the marker at
+the repo root:
+
+```json
+{ "level": "minor" }
+```
+
+- `runtime-bump.json` — `{ "level": "none" | "patch" | "minor" | "major" }`; a missing file reads as
+  `none`. Any other value fails the run.
+- The marker applies **only while `runtimeHash` differs from the snapshot's**. The pipeline never
+  commits, so it is not reset after use — it simply goes inert once that publish is snapshotted and
+  the hashes match again. Set it in the same commit as the runtime change and leave it at that
+  value; set it back to `"none"` whenever you like.
+- The published level is the **highest** of: the catalog diff (only when the generated output
+  changed), the runtime level (`max(marker, patch)` when the runtime changed), and `patch` when the
+  shipped docs changed. A `major` catalog diff therefore outranks a `minor` marker, and vice versa.
+- A legacy snapshot with no `runtimeHash` publishes **one seeding PATCH** (when a runtime is
+  present) to record the hash, after which detection is fully hash-based — the same two-mode shape
+  as `docsHash`.
+
+### Snapshot shape
+
+`out/new-snapshot.json` is now a wrapper, `{ catalog, docsHash, runtimeHash }`, rather than a bare
+catalog —
+`docsHash` is the content hash of the **shipped** guide (the `docs/*.md` + `docs/recipes` files,
+matching the `files` globs; internal `docs/superpowers/` is excluded), added so a docs-only change
+(no catalog diff) still triggers a PATCH publish; `runtimeHash` covers `src/runtime` + `src/react`
+(see "Runtime changes" above). The file remains an **opaque blob** to Cloud
+Build: store it in GCS exactly as written and pass it back verbatim as `--baseline` on the next
+run. Older, bare-catalog baselines from before this change are still accepted: because such a
+baseline predates in-package docs, the first run against it publishes a **one-time migration
+PATCH** (when shipped docs are present) that ships the guide and seeds the wrapper snapshot —
+after which docs-change detection is fully hash-based.

package/dist/_types/gen/analytics/index.d.ts

@@ -0,0 +1,2 @@
+export * from './queryOptions.gen.js';
+export type { AnalyticsCatalogGetInput, AnalyticsCatalogGetOutput, AnalyticsDashboardCreateInput, AnalyticsDashboardCreateOutput, AnalyticsDashboardDeleteInput, AnalyticsDashboardDeleteOutput, AnalyticsDashboardGetInput, AnalyticsDashboardGetOutput, AnalyticsDashboardListInput, AnalyticsDashboardListOutput, AnalyticsDashboardRunInput, AnalyticsDashboardRunOutput, AnalyticsDashboardUpdateInput, AnalyticsDashboardUpdateOutput, AnalyticsFunnelRunInput, AnalyticsFunnelRunOutput, AnalyticsInsightCreateInput, AnalyticsInsightCreateOutput, AnalyticsInsightDeleteInput, AnalyticsInsightDeleteOutput, AnalyticsInsightGetInput, AnalyticsInsightGetOutput, AnalyticsInsightListInput, AnalyticsInsightListOutput, AnalyticsInsightRunInput, AnalyticsInsightRunOutput, AnalyticsInsightUpdateInput, AnalyticsInsightUpdateOutput, AnalyticsMetricQueryInput, AnalyticsMetricQueryOutput, AnalyticsPersonTimelineInput, AnalyticsPersonTimelineOutput, AnalyticsQueryRunInput, AnalyticsQueryRunOutput, AnalyticsRetentionRunInput, AnalyticsRetentionRunOutput } from '../types.gen.js';

package/dist/_types/gen/analytics/queryOptions.gen.d.ts

@@ -0,0 +1,74 @@
+import type { GeneratedClient } from '../client.gen.js';
+import type { AnalyticsCatalogGetInput, AnalyticsCatalogGetOutput, AnalyticsDashboardCreateInput, AnalyticsDashboardDeleteInput, AnalyticsDashboardGetInput, AnalyticsDashboardGetOutput, AnalyticsDashboardListInput, AnalyticsDashboardListOutput, AnalyticsDashboardRunInput, AnalyticsDashboardRunOutput, AnalyticsDashboardUpdateInput, AnalyticsFunnelRunInput, AnalyticsFunnelRunOutput, AnalyticsInsightCreateInput, AnalyticsInsightDeleteInput, AnalyticsInsightGetInput, AnalyticsInsightGetOutput, AnalyticsInsightListInput, AnalyticsInsightListOutput, AnalyticsInsightRunInput, AnalyticsInsightRunOutput, AnalyticsInsightUpdateInput, AnalyticsMetricQueryInput, AnalyticsMetricQueryOutput, AnalyticsPersonTimelineInput, AnalyticsPersonTimelineOutput, AnalyticsQueryRunInput, AnalyticsQueryRunOutput, AnalyticsRetentionRunInput, AnalyticsRetentionRunOutput } from '../types.gen.js';
+export declare const analyticsCatalogGetQueryOptions: (sdk: GeneratedClient, input: AnalyticsCatalogGetInput) => {
+    queryKey: readonly ["analytics", "catalog", "get", AnalyticsCatalogGetInput];
+    queryFn: () => Promise<AnalyticsCatalogGetOutput>;
+};
+export declare const analyticsDashboardCreateMutationOptions: (sdk: GeneratedClient) => {
+    mutationKey: string[];
+    mutationFn: (input: AnalyticsDashboardCreateInput) => Promise<import(".").AnalyticsDashboardCreateOutput>;
+};
+export declare const analyticsDashboardDeleteMutationOptions: (sdk: GeneratedClient) => {
+    mutationKey: string[];
+    mutationFn: (input: AnalyticsDashboardDeleteInput) => Promise<import(".").AnalyticsDashboardDeleteOutput>;
+};
+export declare const analyticsDashboardGetQueryOptions: (sdk: GeneratedClient, input: AnalyticsDashboardGetInput) => {
+    queryKey: readonly ["analytics", "dashboard", "get", AnalyticsDashboardGetInput];
+    queryFn: () => Promise<AnalyticsDashboardGetOutput>;
+};
+export declare const analyticsDashboardListQueryOptions: (sdk: GeneratedClient, input: AnalyticsDashboardListInput) => {
+    queryKey: readonly ["analytics", "dashboard", "list", AnalyticsDashboardListInput];
+    queryFn: () => Promise<AnalyticsDashboardListOutput>;
+};
+export declare const analyticsDashboardRunQueryOptions: (sdk: GeneratedClient, input: AnalyticsDashboardRunInput) => {
+    queryKey: readonly ["analytics", "dashboard", "run", AnalyticsDashboardRunInput];
+    queryFn: () => Promise<AnalyticsDashboardRunOutput>;
+};
+export declare const analyticsDashboardUpdateMutationOptions: (sdk: GeneratedClient) => {
+    mutationKey: string[];
+    mutationFn: (input: AnalyticsDashboardUpdateInput) => Promise<import(".").AnalyticsDashboardUpdateOutput>;
+};
+export declare const analyticsFunnelRunQueryOptions: (sdk: GeneratedClient, input: AnalyticsFunnelRunInput) => {
+    queryKey: readonly ["analytics", "funnel", "run", AnalyticsFunnelRunInput];
+    queryFn: () => Promise<AnalyticsFunnelRunOutput>;
+};
+export declare const analyticsInsightCreateMutationOptions: (sdk: GeneratedClient) => {
+    mutationKey: string[];
+    mutationFn: (input: AnalyticsInsightCreateInput) => Promise<import(".").AnalyticsInsightCreateOutput>;
+};
+export declare const analyticsInsightDeleteMutationOptions: (sdk: GeneratedClient) => {
+    mutationKey: string[];
+    mutationFn: (input: AnalyticsInsightDeleteInput) => Promise<import(".").AnalyticsInsightDeleteOutput>;
+};
+export declare const analyticsInsightGetQueryOptions: (sdk: GeneratedClient, input: AnalyticsInsightGetInput) => {
+    queryKey: readonly ["analytics", "insight", "get", AnalyticsInsightGetInput];
+    queryFn: () => Promise<AnalyticsInsightGetOutput>;
+};
+export declare const analyticsInsightListQueryOptions: (sdk: GeneratedClient, input: AnalyticsInsightListInput) => {
+    queryKey: readonly ["analytics", "insight", "list", AnalyticsInsightListInput];
+    queryFn: () => Promise<AnalyticsInsightListOutput>;
+};
+export declare const analyticsInsightRunQueryOptions: (sdk: GeneratedClient, input: AnalyticsInsightRunInput) => {
+    queryKey: readonly ["analytics", "insight", "run", AnalyticsInsightRunInput];
+    queryFn: () => Promise<AnalyticsInsightRunOutput>;
+};
+export declare const analyticsInsightUpdateMutationOptions: (sdk: GeneratedClient) => {
+    mutationKey: string[];
+    mutationFn: (input: AnalyticsInsightUpdateInput) => Promise<import(".").AnalyticsInsightUpdateOutput>;
+};
+export declare const analyticsMetricQueryQueryOptions: (sdk: GeneratedClient, input: AnalyticsMetricQueryInput) => {
+    queryKey: readonly ["analytics", "metric", "query", AnalyticsMetricQueryInput];
+    queryFn: () => Promise<AnalyticsMetricQueryOutput>;
+};
+export declare const analyticsPersonTimelineQueryOptions: (sdk: GeneratedClient, input: AnalyticsPersonTimelineInput) => {
+    queryKey: readonly ["analytics", "person", "timeline", AnalyticsPersonTimelineInput];
+    queryFn: () => Promise<AnalyticsPersonTimelineOutput>;
+};
+export declare const analyticsQueryRunQueryOptions: (sdk: GeneratedClient, input: AnalyticsQueryRunInput) => {
+    queryKey: readonly ["analytics", "query", "run", AnalyticsQueryRunInput];
+    queryFn: () => Promise<AnalyticsQueryRunOutput>;
+};
+export declare const analyticsRetentionRunQueryOptions: (sdk: GeneratedClient, input: AnalyticsRetentionRunInput) => {
+    queryKey: readonly ["analytics", "retention", "run", AnalyticsRetentionRunInput];
+    queryFn: () => Promise<AnalyticsRetentionRunOutput>;
+};

package/dist/_types/gen/bindings.gen.d.ts

@@ -0,0 +1,3 @@
+import type { BindingsMap, WsBindingsMap } from '../runtime/types.js';
+export declare const bindings: BindingsMap;
+export declare const wsBindings: WsBindingsMap;

package/dist/_types/gen/brain/index.d.ts

@@ -0,0 +1,2 @@
+export * from './queryOptions.gen.js';
+export type { BrainBackupCreateInput, BrainBackupCreateOutput, BrainBackupRestoreInput, BrainBackupRestoreOutput, BrainBackupStatusInput, BrainBackupStatusOutput, BrainBackupsListInput, BrainBackupsListOutput, BrainClickupChannelsListInput, BrainClickupChannelsListOutput, BrainClickupConnectionsListInput, BrainClickupConnectionsListOutput, BrainClickupListsListInput, BrainClickupListsListOutput, BrainClickupSpacesListInput, BrainClickupSpacesListOutput, BrainCognitionDigestInput, BrainCognitionDigestOutput, BrainCognitionStatusInput, BrainCognitionStatusOutput, BrainCognitionSweepInput, BrainCognitionSweepOutput, BrainConnectorBranchesListInput, BrainConnectorBranchesListOutput, BrainConnectorConnectionsListInput, BrainConnectorConnectionsListOutput, BrainConnectorReposListInput, BrainConnectorReposListOutput, BrainDaemonBatchStatusInput, BrainDaemonBatchStatusOutput, BrainDaemonCreateInput, BrainDaemonCreateOutput, BrainDaemonGetInput, BrainDaemonGetOutput, BrainDaemonReingestInput, BrainDaemonReingestOutput, BrainDaemonRemoveInput, BrainDaemonRemoveOutput, BrainDaemonRunInput, BrainDaemonRunItemsInput, BrainDaemonRunItemsOutput, BrainDaemonRunOutput, BrainDaemonRunsInput, BrainDaemonRunsOutput, BrainDaemonStatusInput, BrainDaemonStatusOutput, BrainDaemonUpdateInput, BrainDaemonUpdateOutput, BrainDaemonsListInput, BrainDaemonsListOutput, BrainGdriveConnectionsListInput, BrainGdriveConnectionsListOutput, BrainKnowledgeEntityMemoriesInput, BrainKnowledgeEntityMemoriesOutput, BrainKnowledgeGraphInput, BrainKnowledgeGraphOutput, BrainKnowledgeNeighborhoodInput, BrainKnowledgeNeighborhoodOutput, BrainKnowledgeRelationsInput, BrainKnowledgeRelationsOutput, BrainKnowledgeSearchInput, BrainKnowledgeSearchOutput, BrainMemoryAddInput, BrainMemoryAddOutput, BrainMemoryDeleteInput, BrainMemoryDeleteOutput, BrainMemoryGetInput, BrainMemoryGetOutput, BrainMemoryListInput, BrainMemoryListOutput, BrainMemorySearchInput, BrainMemorySearchOutput, BrainMemoryStatsInput, BrainMemoryStatsOutput, BrainMemoryUpdateInput, BrainMemoryUpdateOutput, BrainProductSharedMemoryResetInput, BrainProductSharedMemoryResetOutput, BrainRestoreStatusInput, BrainRestoreStatusOutput, BrainUsageReportInput, BrainUsageReportOutput } from '../types.gen.js';

package/dist/_types/gen/brain/queryOptions.gen.d.ts

@@ -0,0 +1,166 @@
+import type { GeneratedClient } from '../client.gen.js';
+import type { BrainBackupCreateInput, BrainBackupRestoreInput, BrainBackupStatusInput, BrainBackupStatusOutput, BrainBackupsListInput, BrainBackupsListOutput, BrainClickupChannelsListInput, BrainClickupChannelsListOutput, BrainClickupConnectionsListInput, BrainClickupConnectionsListOutput, BrainClickupListsListInput, BrainClickupListsListOutput, BrainClickupSpacesListInput, BrainClickupSpacesListOutput, BrainCognitionDigestInput, BrainCognitionStatusInput, BrainCognitionStatusOutput, BrainCognitionSweepInput, BrainConnectorBranchesListInput, BrainConnectorBranchesListOutput, BrainConnectorConnectionsListInput, BrainConnectorConnectionsListOutput, BrainConnectorReposListInput, BrainConnectorReposListOutput, BrainDaemonBatchStatusInput, BrainDaemonBatchStatusOutput, BrainDaemonCreateInput, BrainDaemonGetInput, BrainDaemonGetOutput, BrainDaemonReingestInput, BrainDaemonRemoveInput, BrainDaemonRunInput, BrainDaemonRunItemsInput, BrainDaemonRunItemsOutput, BrainDaemonRunsInput, BrainDaemonRunsOutput, BrainDaemonStatusInput, BrainDaemonStatusOutput, BrainDaemonUpdateInput, BrainDaemonsListInput, BrainDaemonsListOutput, BrainGdriveConnectionsListInput, BrainGdriveConnectionsListOutput, BrainKnowledgeEntityMemoriesInput, BrainKnowledgeEntityMemoriesOutput, BrainKnowledgeGraphInput, BrainKnowledgeGraphOutput, BrainKnowledgeNeighborhoodInput, BrainKnowledgeNeighborhoodOutput, BrainKnowledgeRelationsInput, BrainKnowledgeRelationsOutput, BrainKnowledgeSearchInput, BrainKnowledgeSearchOutput, BrainMemoryAddInput, BrainMemoryDeleteInput, BrainMemoryGetInput, BrainMemoryGetOutput, BrainMemoryListInput, BrainMemoryListOutput, BrainMemorySearchInput, BrainMemorySearchOutput, BrainMemoryStatsInput, BrainMemoryStatsOutput, BrainMemoryUpdateInput, BrainProductSharedMemoryResetInput, BrainRestoreStatusInput, BrainRestoreStatusOutput, BrainUsageReportInput, BrainUsageReportOutput } from '../types.gen.js';
+export declare const brainBackupCreateMutationOptions: (sdk: GeneratedClient) => {
+    mutationKey: string[];
+    mutationFn: (input: BrainBackupCreateInput) => Promise<import(".").BrainBackupCreateOutput>;
+};
+export declare const brainBackupRestoreMutationOptions: (sdk: GeneratedClient) => {
+    mutationKey: string[];
+    mutationFn: (input: BrainBackupRestoreInput) => Promise<import(".").BrainBackupRestoreOutput>;
+};
+export declare const brainBackupStatusQueryOptions: (sdk: GeneratedClient, input: BrainBackupStatusInput) => {
+    queryKey: readonly ["brain", "backup", "status", BrainBackupStatusInput];
+    queryFn: () => Promise<BrainBackupStatusOutput>;
+};
+export declare const brainBackupsListQueryOptions: (sdk: GeneratedClient, input: BrainBackupsListInput) => {
+    queryKey: readonly ["brain", "backups", "list", BrainBackupsListInput];
+    queryFn: () => Promise<BrainBackupsListOutput>;
+};
+export declare const brainClickupChannelsListQueryOptions: (sdk: GeneratedClient, input: BrainClickupChannelsListInput) => {
+    queryKey: readonly ["brain", "clickup-channels", "list", BrainClickupChannelsListInput];
+    queryFn: () => Promise<BrainClickupChannelsListOutput>;
+};
+export declare const brainClickupConnectionsListQueryOptions: (sdk: GeneratedClient, input: BrainClickupConnectionsListInput) => {
+    queryKey: readonly ["brain", "clickup-connections", "list", BrainClickupConnectionsListInput];
+    queryFn: () => Promise<BrainClickupConnectionsListOutput>;
+};
+export declare const brainClickupListsListQueryOptions: (sdk: GeneratedClient, input: BrainClickupListsListInput) => {
+    queryKey: readonly ["brain", "clickup-lists", "list", BrainClickupListsListInput];
+    queryFn: () => Promise<BrainClickupListsListOutput>;
+};
+export declare const brainClickupSpacesListQueryOptions: (sdk: GeneratedClient, input: BrainClickupSpacesListInput) => {
+    queryKey: readonly ["brain", "clickup-spaces", "list", BrainClickupSpacesListInput];
+    queryFn: () => Promise<BrainClickupSpacesListOutput>;
+};
+export declare const brainCognitionDigestMutationOptions: (sdk: GeneratedClient) => {
+    mutationKey: string[];
+    mutationFn: (input: BrainCognitionDigestInput) => Promise<import(".").BrainCognitionDigestOutput>;
+};
+export declare const brainCognitionStatusQueryOptions: (sdk: GeneratedClient, input: BrainCognitionStatusInput) => {
+    queryKey: readonly ["brain", "cognition", "status", BrainCognitionStatusInput];
+    queryFn: () => Promise<BrainCognitionStatusOutput>;
+};
+export declare const brainCognitionSweepMutationOptions: (sdk: GeneratedClient) => {
+    mutationKey: string[];
+    mutationFn: (input: BrainCognitionSweepInput) => Promise<import(".").BrainCognitionSweepOutput>;
+};
+export declare const brainConnectorBranchesListQueryOptions: (sdk: GeneratedClient, input: BrainConnectorBranchesListInput) => {
+    queryKey: readonly ["brain", "connector-branches", "list", BrainConnectorBranchesListInput];
+    queryFn: () => Promise<BrainConnectorBranchesListOutput>;
+};
+export declare const brainConnectorConnectionsListQueryOptions: (sdk: GeneratedClient, input: BrainConnectorConnectionsListInput) => {
+    queryKey: readonly ["brain", "connector-connections", "list", BrainConnectorConnectionsListInput];
+    queryFn: () => Promise<BrainConnectorConnectionsListOutput>;
+};
+export declare const brainConnectorReposListQueryOptions: (sdk: GeneratedClient, input: BrainConnectorReposListInput) => {
+    queryKey: readonly ["brain", "connector-repos", "list", BrainConnectorReposListInput];
+    queryFn: () => Promise<BrainConnectorReposListOutput>;
+};
+export declare const brainDaemonBatchStatusQueryOptions: (sdk: GeneratedClient, input: BrainDaemonBatchStatusInput) => {
+    queryKey: readonly ["brain", "daemon-batch", "status", BrainDaemonBatchStatusInput];
+    queryFn: () => Promise<BrainDaemonBatchStatusOutput>;
+};
+export declare const brainDaemonCreateMutationOptions: (sdk: GeneratedClient) => {
+    mutationKey: string[];
+    mutationFn: (input: BrainDaemonCreateInput) => Promise<import(".").BrainDaemonCreateOutput>;
+};
+export declare const brainDaemonGetQueryOptions: (sdk: GeneratedClient, input: BrainDaemonGetInput) => {
+    queryKey: readonly ["brain", "daemon", "get", BrainDaemonGetInput];
+    queryFn: () => Promise<BrainDaemonGetOutput>;
+};
+export declare const brainDaemonReingestMutationOptions: (sdk: GeneratedClient) => {
+    mutationKey: string[];
+    mutationFn: (input: BrainDaemonReingestInput) => Promise<import(".").BrainDaemonReingestOutput>;
+};
+export declare const brainDaemonRemoveMutationOptions: (sdk: GeneratedClient) => {
+    mutationKey: string[];
+    mutationFn: (input: BrainDaemonRemoveInput) => Promise<import(".").BrainDaemonRemoveOutput>;
+};
+export declare const brainDaemonRunMutationOptions: (sdk: GeneratedClient) => {
+    mutationKey: string[];
+    mutationFn: (input: BrainDaemonRunInput) => Promise<import(".").BrainDaemonRunOutput>;
+};
+export declare const brainDaemonRunItemsQueryOptions: (sdk: GeneratedClient, input: BrainDaemonRunItemsInput) => {
+    queryKey: readonly ["brain", "daemon-run", "items", BrainDaemonRunItemsInput];
+    queryFn: () => Promise<BrainDaemonRunItemsOutput>;
+};
+export declare const brainDaemonRunsQueryOptions: (sdk: GeneratedClient, input: BrainDaemonRunsInput) => {
+    queryKey: readonly ["brain", "daemon", "runs", BrainDaemonRunsInput];
+    queryFn: () => Promise<BrainDaemonRunsOutput>;
+};
+export declare const brainDaemonStatusQueryOptions: (sdk: GeneratedClient, input: BrainDaemonStatusInput) => {
+    queryKey: readonly ["brain", "daemon", "status", BrainDaemonStatusInput];
+    queryFn: () => Promise<BrainDaemonStatusOutput>;
+};
+export declare const brainDaemonUpdateMutationOptions: (sdk: GeneratedClient) => {
+    mutationKey: string[];
+    mutationFn: (input: BrainDaemonUpdateInput) => Promise<import(".").BrainDaemonUpdateOutput>;
+};
+export declare const brainDaemonsListQueryOptions: (sdk: GeneratedClient, input: BrainDaemonsListInput) => {
+    queryKey: readonly ["brain", "daemons", "list", BrainDaemonsListInput];
+    queryFn: () => Promise<BrainDaemonsListOutput>;
+};
+export declare const brainGdriveConnectionsListQueryOptions: (sdk: GeneratedClient, input: BrainGdriveConnectionsListInput) => {
+    queryKey: readonly ["brain", "gdrive-connections", "list", BrainGdriveConnectionsListInput];
+    queryFn: () => Promise<BrainGdriveConnectionsListOutput>;
+};
+export declare const brainKnowledgeEntityMemoriesQueryOptions: (sdk: GeneratedClient, input: BrainKnowledgeEntityMemoriesInput) => {
+    queryKey: readonly ["brain", "knowledge-entity", "memories", BrainKnowledgeEntityMemoriesInput];
+    queryFn: () => Promise<BrainKnowledgeEntityMemoriesOutput>;
+};
+export declare const brainKnowledgeGraphQueryOptions: (sdk: GeneratedClient, input: BrainKnowledgeGraphInput) => {
+    queryKey: readonly ["brain", "knowledge", "graph", BrainKnowledgeGraphInput];
+    queryFn: () => Promise<BrainKnowledgeGraphOutput>;
+};
+export declare const brainKnowledgeNeighborhoodQueryOptions: (sdk: GeneratedClient, input: BrainKnowledgeNeighborhoodInput) => {
+    queryKey: readonly ["brain", "knowledge", "neighborhood", BrainKnowledgeNeighborhoodInput];
+    queryFn: () => Promise<BrainKnowledgeNeighborhoodOutput>;
+};
+export declare const brainKnowledgeRelationsQueryOptions: (sdk: GeneratedClient, input: BrainKnowledgeRelationsInput) => {
+    queryKey: readonly ["brain", "knowledge", "relations", BrainKnowledgeRelationsInput];
+    queryFn: () => Promise<BrainKnowledgeRelationsOutput>;
+};
+export declare const brainKnowledgeSearchQueryOptions: (sdk: GeneratedClient, input: BrainKnowledgeSearchInput) => {
+    queryKey: readonly ["brain", "knowledge", "search", BrainKnowledgeSearchInput];
+    queryFn: () => Promise<BrainKnowledgeSearchOutput>;
+};
+export declare const brainMemoryAddMutationOptions: (sdk: GeneratedClient) => {
+    mutationKey: string[];
+    mutationFn: (input: BrainMemoryAddInput) => Promise<import(".").BrainMemoryAddOutput>;
+};
+export declare const brainMemoryDeleteMutationOptions: (sdk: GeneratedClient) => {
+    mutationKey: string[];
+    mutationFn: (input: BrainMemoryDeleteInput) => Promise<import(".").BrainMemoryDeleteOutput>;
+};
+export declare const brainMemoryGetQueryOptions: (sdk: GeneratedClient, input: BrainMemoryGetInput) => {
+    queryKey: readonly ["brain", "memory", "get", BrainMemoryGetInput];
+    queryFn: () => Promise<BrainMemoryGetOutput>;
+};
+export declare const brainMemoryListQueryOptions: (sdk: GeneratedClient, input: BrainMemoryListInput) => {
+    queryKey: readonly ["brain", "memory", "list", BrainMemoryListInput];
+    queryFn: () => Promise<BrainMemoryListOutput>;
+};
+export declare const brainMemorySearchQueryOptions: (sdk: GeneratedClient, input: BrainMemorySearchInput) => {
+    queryKey: readonly ["brain", "memory", "search", BrainMemorySearchInput];
+    queryFn: () => Promise<BrainMemorySearchOutput>;
+};
+export declare const brainMemoryStatsQueryOptions: (sdk: GeneratedClient, input: BrainMemoryStatsInput) => {
+    queryKey: readonly ["brain", "memory", "stats", BrainMemoryStatsInput];
+    queryFn: () => Promise<BrainMemoryStatsOutput>;
+};
+export declare const brainMemoryUpdateMutationOptions: (sdk: GeneratedClient) => {
+    mutationKey: string[];
+    mutationFn: (input: BrainMemoryUpdateInput) => Promise<import(".").BrainMemoryUpdateOutput>;
+};
+export declare const brainProductSharedMemoryResetMutationOptions: (sdk: GeneratedClient) => {
+    mutationKey: string[];
+    mutationFn: (input: BrainProductSharedMemoryResetInput) => Promise<import(".").BrainProductSharedMemoryResetOutput>;
+};
+export declare const brainRestoreStatusQueryOptions: (sdk: GeneratedClient, input: BrainRestoreStatusInput) => {
+    queryKey: readonly ["brain", "restore", "status", BrainRestoreStatusInput];
+    queryFn: () => Promise<BrainRestoreStatusOutput>;
+};
+export declare const brainUsageReportQueryOptions: (sdk: GeneratedClient, input: BrainUsageReportInput) => {
+    queryKey: readonly ["brain", "usage", "report", BrainUsageReportInput];
+    queryFn: () => Promise<BrainUsageReportOutput>;
+};