@kortix/sdk 0.12.4 → 0.12.6

package/dist/react/query-keys.d.ts

@@ -0,0 +1,251 @@
+/**
+ * The one place a Kortix query key is constructed.
+ *
+ * Before this existed, `apps/web` hand-typed roughly 176 key literals across
+ * 30 `project*` families. One entity therefore had several cache entries (the
+ * flat `project-sessions` key and the flat `project-session-inventory` key
+ * held the same server data), and one key had several freshness contracts, because
+ * `staleTime` is per-observer and seven call sites disagreed about it.
+ *
+ * The first version of `sessions(id)` repeated that exact mistake one level
+ * down: it dropped `listProjectSessions`'s `scope` argument, so a
+ * `scope: 'visible'` reader and a `scope: 'project'` reader (a DIFFERENT
+ * server request — see `sessions` below) shared one cache slot, and
+ * whichever fetch resolved last silently overwrote what the other scope's
+ * readers saw. Anything that changes the response MUST be part of the key —
+ * that is the rule this file exists to enforce, and it is not optional just
+ * because the argument is easy to forget.
+ *
+ * The SECOND version of `sessions(id, scope)` fixed that, then introduced a
+ * narrower version of the same class of bug: `sessions(id, scope)` and
+ * `session(id, sessionId)` were both `sessionsScope(id)` plus exactly one
+ * segment, so a session id equal to a scope literal (`'visible'`,
+ * `'project'`) would collide byte-for-byte with a scoped list. Nothing in
+ * THIS file prevented that — the only thing standing in the way was a UUID
+ * regex enforced server-side, in `apps/api`, a different package, with no
+ * link back here. `sessions` now inserts a literal `'list'` segment so it is
+ * structurally longer than `session(...)` for every possible session id —
+ * the collision is unrepresentable, not merely unlikely.
+ *
+ * Two rules make this work:
+ *
+ *  1. `scope(id)` is a PREFIX, never a query key. Everything belonging to one
+ *     project sits under it, so `invalidateQueries({ queryKey: scope(id) })`
+ *     provably reaches all of it.
+ *  2. Nothing derived from another query gets its own key. Skills, commands
+ *     and agents are `config.*` fields of the project detail response, not
+ *     separate fetches — they are `select` projections over `detail(id)`.
+ *
+ * Not to be confused with `kortixKeys` in `use-kortix-master.ts`, which
+ * addresses the multi-server Kortix Master surface and means something else.
+ *
+ * The root segment below is `'kx'`, not `'kortix'`. `'kortix'` is already
+ * `kortixKeys`'s root (`use-kortix-master.ts:276-279`):
+ * `kortixKeys.projects() = ['kortix', 'projects']` and
+ * `kortixKeys.project(id) = ['kortix', 'projects', id]`. If this factory also
+ * rooted at `'kortix'`, `kortixKeys.project(id)` and `qk.projects.list(id)`
+ * would be the identical array for a matching id — one cache entry standing
+ * in for two unrelated concepts — and `kortixKeys.projects()` (used as an
+ * `invalidateQueries` prefix at `use-kortix-master.ts:371,384`) would also
+ * match every key this factory produces, since TanStack matches query keys by
+ * prefix. `'kx'` makes the two factories disjoint at segment 0, so neither
+ * can ever prefix-match the other. Do not "tidy" this back to `'kortix'`.
+ */
+export declare const qk: {
+    readonly projects: {
+        /** Invalidation prefix covering every account's list AND the accountless
+         *  slot. Never pass this as a `queryKey` — `list(accountId)` and
+         *  `list()` are SIBLINGS (`'<id>'` vs `'all'`), not a parent/child pair,
+         *  so `list()` alone does not prefix-match `list(accountId)`. Use this
+         *  when a mutation needs to reach every form at once. */
+        readonly scope: () => readonly ["kx", "projects"];
+        /** Every project the account can see. `undefined` means the active account. */
+        readonly list: (accountId?: string) => readonly ["kx", "projects", string];
+    };
+    readonly project: {
+        /** Invalidation prefix. Never pass this as a `queryKey`. */
+        readonly scope: (id: string) => readonly ["kx", "project", string];
+        /**
+         * The bare project row — `getProject`, `GET /projects/:id`, a
+         * `KortixProject`. NOT `detail(id)` below: `getProjectDetail` hits
+         * `GET /projects/:id/detail` and returns a completely different shape,
+         * `{ project, config, file_count, files, git_connection }`. An earlier
+         * draft of this migration folded the two onto one key because both
+         * requests are "about a project" — but they are different requests with
+         * different responses, so sharing a key means whichever one resolves
+         * last silently overwrites the other's shape: a `data.account_id` reader
+         * (this one) would intermittently receive the detail wrapper instead,
+         * where the same field lives at `data.project.account_id`. Keep them
+         * apart, the same way `sessions`/`session` and `policies`/
+         * `executorPolicies` below are kept apart for the identical reason.
+         */
+        readonly summary: (id: string) => readonly ["kx", "project", string, "summary"];
+        readonly detail: (id: string) => readonly ["kx", "project", string, "detail"];
+        /**
+         * Prefix reserved for config-adjacent sub-resources that do NOT share
+         * `getProjectDetail`'s response shape (currently only `modelPicker`
+         * below). The project config DATA ITSELF — `ProjectConfigSummary`,
+         * i.e. `getProjectDetail(id).config` — is not keyed here: it rides the
+         * shared `detail(id)` entry via a `select` projection (see
+         * `use-project-config.ts`), because it IS that same response every
+         * other detail reader already caches. Keying it separately here would
+         * bring back the exact double-fetch this factory exists to remove —
+         * `useProjectConfig` used to do exactly that under a standalone
+         * `['project-config', id]` key.
+         */
+        readonly config: (id: string) => readonly ["kx", "project", string, "config"];
+        /**
+         * `getProjectModelPicker`, `GET /projects/:id/model-picker` — the compact,
+         * connection-aware model catalog. LIVE: `useProjectModels` (`use-project-
+         * models.ts`) `useQuery`s it directly, rendered at `gateway-view.tsx`,
+         * `gateway-routing.tsx`, `gateway-playground.tsx`, `models-tab.tsx`, and
+         * `use-session.ts`. `useModelEnablement` (`use-model-enablement.ts`) reads
+         * and optimistically writes the SAME entry so a toggle and the picker never
+         * disagree. A routing-policy save's `invalidateQueries` targets this key
+         * too (`gateway-routing.tsx`) — before the `packages/sdk/src/react`
+         * migration that call and every reader above hand-typed the same flat
+         * `project-model-picker` array literal independently; an earlier
+         * version of this comment called the key "dead" because that literal
+         * search only ever turned up the invalidation site, never the readers —
+         * they lived one file away, under `packages/sdk/src/react`, which this
+         * factory did not yet reach.
+         */
+        readonly modelPicker: (id: string) => readonly ["kx", "project", string, "config", "models"];
+        /**
+         * Invalidation prefix for the WHOLE sessions family: the list, in every
+         * scope, and every individual session/message beneath it. Never pass
+         * this as a `queryKey` — pass it to `invalidateQueries` at every site
+         * that means "the sessions list changed" (create/rename/delete/restart/
+         * stop/share). `sessions(id)` and `sessions(id, 'project')` are SIBLINGS,
+         * not parent and child (see `sessions` below) — invalidating one alone
+         * would leave the other silently stale, and this prefix is the only form
+         * that reaches both in one call.
+         */
+        readonly sessionsScope: (id: string) => readonly ["kx", "project", string, "sessions"];
+        /**
+         * The sessions list. `scope` is part of the key ON PURPOSE:
+         * `listProjectSessions(id, { scope })`
+         * (`core/rest/projects-client/sessions.ts`) is a DIFFERENT server
+         * request per scope, not a client-side filter of one response —
+         * `'visible'` (the default; matches passing no `options` at all) returns
+         * what the caller can see, `'project'` is the manager-only unfiltered
+         * full inventory (`apps/api/src/projects/lib/session-inventory.ts`).
+         * Before this, both scopes shared one scope-less key, so whichever fetch
+         * resolved last silently overwrote what the OTHER scope's readers saw —
+         * the sidebar could render the unfiltered manager inventory, or the
+         * inventory page could render the sidebar's filtered list. Use
+         * `sessionsScope(id)`, not this, for invalidation.
+         *
+         * The literal `'list'` segment exists so this can NEVER collide with
+         * `session(id, sessionId)` below. Without it, both were
+         * `sessionsScope(id)` plus exactly one segment — a session whose id
+         * happened to equal the string `'visible'` or `'project'` would produce
+         * the identical array a scoped list produces, and the two would silently
+         * overwrite each other. Session ids are `crypto.randomUUID()`
+         * client-side and rejected server-side otherwise
+         * (`apps/api/src/projects/lib/sessions.ts`), so that made the collision
+         * unreachable, not impossible — safety by an invariant enforced in a
+         * DIFFERENT package, with no link back to this file. `'list'` makes
+         * `sessions(...)` structurally longer than `session(...)` for every
+         * possible session id, which is the same standard this file already
+         * applies to the `'kx'` root (see the top doc comment): make the
+         * collision unrepresentable, don't rely on another package's validation
+         * staying strict.
+         */
+        readonly sessions: (id: string, scope?: "visible" | "project") => readonly ["kx", "project", string, "sessions", "list", "project" | "visible"];
+        /**
+         * One session, by id. Nests directly under the scope-LESS
+         * `sessionsScope` prefix, not under a specific `sessions(id, scope)`
+         * slot: a session is not "owned" by whichever list scope happened to
+         * discover it (the same session id is reachable via either scope), so
+         * its own cache entry does not carry a scope segment either.
+         */
+        readonly session: (id: string, sessionId: string) => readonly ["kx", "project", string, "sessions", string];
+        readonly messages: (id: string, sessionId: string) => readonly ["kx", "project", string, "sessions", string, "messages"];
+        /**
+         * Orphaned pre-existing behavior, migrated verbatim rather than "fixed":
+         * three `apps/web` call sites invalidate this slot after a session
+         * restart / config reload, and one reads it with `getQueryData`, but no
+         * site anywhere `useQuery`s or `setQueryData`s it — so the read always
+         * resolves `undefined` and the three invalidations are no-ops today.
+         * Nests under `session(id, sessionId)` rather than folding onto it
+         * because `session(...)` became a REAL, live query in this same
+         * migration (`getProjectSession`); sharing that slot would make these
+         * dead invalidations start firing against real session data instead of
+         * continuing to hit nothing.
+         */
+        readonly sessionSandbox: (id: string, sessionId: string) => readonly ["kx", "project", string, "sessions", string, "sandbox"];
+        readonly connectors: (id: string) => readonly ["kx", "project", string, "connectors"];
+        /** One connector's config — `getConnectorConfig(id, slug)`. */
+        readonly connectorConfig: (id: string, slug: string) => readonly ["kx", "project", string, "connectors", string];
+        readonly access: (id: string) => readonly ["kx", "project", string, "access"];
+        readonly accessRequests: (id: string) => readonly ["kx", "project", string, "access", "requests"];
+        readonly pendingInvites: (id: string) => readonly ["kx", "project", string, "access", "invites"];
+        /** `listProjectGroupGrants` — `GET /group-grants`, `{ grants: ProjectGroupGrant[] }`. */
+        readonly groupGrants: (id: string) => readonly ["kx", "project", string, "access", "group-grants"];
+        /** `listProjectResourceGrants` — `GET /resource-grants`, a DIFFERENT
+         *  endpoint and shape from `groupGrants` above; do not fold together. */
+        readonly resourceGrants: (id: string) => readonly ["kx", "project", string, "access", "grants"];
+        readonly secrets: (id: string) => readonly ["kx", "project", string, "secrets"];
+        /** Stable App inventory for `GET /projects/:id/apps`. */
+        readonly apps: (id: string) => readonly ["kx", "project", string, "apps"];
+        /** Access policy and short-lived browser session for one App. */
+        readonly appAccess: (id: string, appId: string) => readonly ["kx", "project", string, "apps", string, "access"];
+        /** Short-lived browser exchange URL for one App. */
+        readonly appAccessSession: (id: string, appId: string) => readonly ["kx", "project", string, "apps", string, "access", "session"];
+        /** Immutable deployment history for one App. */
+        readonly appDeployments: (id: string, appId: string) => readonly ["kx", "project", string, "apps", string, "deployments"];
+        /** `listProjectTriggers` — `GET /projects/:id/triggers`, the cron/webhook
+         *  listing (file-defined in the repo manifest). Shared by
+         *  `useProjectTriggers` (`use-project-triggers.ts`), the Customize
+         *  settings pause switch, and the schedule/triggers view — all three read
+         *  and write the identical entity through `listProjectTriggers(id)`, so
+         *  they must share this one key. */
+        readonly triggers: (id: string) => readonly ["kx", "project", string, "triggers"];
+        /**
+         * `readProjectFile(id, path)` — a single-file source read, used by the
+         * Customize config-entity viewer. Unrelated to the much larger Git file
+         * browser under `features/project-files/` (its own local key factories,
+         * `commitKeys`/`branchKeys`/`changeRequestKeys`, rooted at the literal
+         * string `'project-files'` — never migrated onto `qk`, and never sharing
+         * this prefix).
+         */
+        readonly files: (id: string) => readonly ["kx", "project", string, "files"];
+        readonly fileSource: (id: string, path: string) => readonly ["kx", "project", string, "files", string];
+        readonly branches: (id: string) => readonly ["kx", "project", string, "branches"];
+        /** IAM role policies — `listPolicies(accountId, { scopeId: id })`,
+         *  `{ policies: IamPolicy[] }`. NOT the same entity as
+         *  `executorPolicies` below — see that member's doc comment. */
+        readonly policies: (id: string) => readonly ["kx", "project", string, "policies"];
+        /**
+         * Executor sandbox tool-execution allow/deny rules —
+         * `listProjectPolicies(id)`, `GET /executor/projects/:id/policies`,
+         * `ProjectPoliciesResponse`. A DIFFERENT endpoint and a DIFFERENT shape
+         * from `policies` above (account IAM role policies) — both used to read
+         * the identical literal `['project-policies', id]`, so whichever one's
+         * fetch resolved last silently overwrote the other's cache entry with an
+         * incompatible shape. Sibling of `policies`, not nested under it: they
+         * are unrelated domains that happen to share a name, not a parent/child
+         * pair, so invalidating one must never reach the other.
+         */
+        readonly executorPolicies: (id: string) => readonly ["kx", "project", string, "executor-policies"];
+        readonly sandboxes: (id: string) => readonly ["kx", "project", string, "sandboxes"];
+        readonly sandboxTemplates: (id: string) => readonly ["kx", "project", string, "sandboxes", "templates"];
+        readonly snapshots: (id: string) => readonly ["kx", "project", string, "snapshots"];
+        /** Prefix for the gateway family — keys, budgets, series, logs, overview. */
+        readonly gateway: (id: string) => readonly ["kx", "project", string, "gateway"];
+        readonly gatewayOverview: (id: string, days: number) => readonly ["kx", "project", string, "gateway", "overview", number];
+        readonly gatewaySeries: (id: string, days: number) => readonly ["kx", "project", string, "gateway", "series", number];
+        readonly gatewayBreakdown: (id: string, days: number) => readonly ["kx", "project", string, "gateway", "breakdown", number];
+        readonly gatewaySessions: (id: string, days: number) => readonly ["kx", "project", string, "gateway", "sessions", number];
+        readonly gatewayErrors: (id: string, days: number) => readonly ["kx", "project", string, "gateway", "errors", number];
+        /** `ok` mirrors `listGatewayLogs`'s optional pass/fail filter — `null` = unfiltered. */
+        readonly gatewayLogs: (id: string, ok: boolean | null) => readonly ["kx", "project", string, "gateway", "logs", boolean | null];
+        readonly gatewayLog: (id: string, logId: string | null) => readonly ["kx", "project", string, "gateway", "log", string | null];
+        readonly gatewayBudgets: (id: string) => readonly ["kx", "project", string, "gateway", "budgets"];
+        readonly gatewayKeys: (id: string) => readonly ["kx", "project", string, "gateway", "keys"];
+    };
+};
+export type ProjectScopeKey = ReturnType<typeof qk.project.scope>;
+export type ProjectsListKey = ReturnType<typeof qk.projects.list>;
+//# sourceMappingURL=query-keys.d.ts.map

package/dist/react/query-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-keys.d.ts","sourceRoot":"","sources":["../../src/react/query-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,eAAO,MAAM,EAAE;;QAEX;;;;iEAIyD;;QAGzD,+EAA+E;oCAC5D,MAAM;;;QAIzB,4DAA4D;6BAChD,MAAM;QAElB;;;;;;;;;;;;;WAaG;+BACW,MAAM;8BAEP,MAAM;QACnB;;;;;;;;;;;WAWG;8BACU,MAAM;QACnB;;;;;;;;;;;;;;;WAeG;mCACe,MAAM;QAExB;;;;;;;;;WASG;qCACiB,MAAM;QAE1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WA6BG;gCACY,MAAM,UAAS,SAAS,GAAG,SAAS;QAGnD;;;;;;WAMG;+BACW,MAAM,aAAa,MAAM;gCAExB,MAAM,aAAa,MAAM;QAExC;;;;;;;;;;;WAWG;sCACkB,MAAM,aAAa,MAAM;kCAG7B,MAAM;QACvB,+DAA+D;uCACzC,MAAM,QAAQ,MAAM;8BAG7B,MAAM;sCACE,MAAM;sCACN,MAAM;QAC3B,yFAAyF;mCACvE,MAAM;QACxB;iFACyE;sCACpD,MAAM;+BAEb,MAAM;QAEpB,yDAAyD;4BAC9C,MAAM;QACjB,iEAAiE;iCACjD,MAAM,SAAS,MAAM;QACrC,oDAAoD;wCAC7B,MAAM,SAAS,MAAM;QAE5C,gDAAgD;sCAC3B,MAAM,SAAS,MAAM;QAG1C;;;;;4CAKoC;gCACrB,MAAM;QAErB;;;;;;;WAOG;6BACS,MAAM;kCACD,MAAM,QAAQ,MAAM;gCAEtB,MAAM;QAErB;;wEAEgE;gCACjD,MAAM;QACrB;;;;;;;;;;WAUG;wCACoB,MAAM;iCAEb,MAAM;wCACC,MAAM;iCACb,MAAM;QAEtB,6EAA6E;+BAC/D,MAAM;uCACE,MAAM,QAAQ,MAAM;qCAEtB,MAAM,QAAQ,MAAM;wCAEjB,MAAM,QAAQ,MAAM;uCAErB,MAAM,QAAQ,MAAM;qCAEtB,MAAM,QAAQ,MAAM;QAExC,wFAAwF;mCACtE,MAAM,MAAM,OAAO,GAAG,IAAI;kCAE3B,MAAM,SAAS,MAAM,GAAG,IAAI;sCAExB,MAAM;mCACT,MAAM;;CAElB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAClE,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC"}

package/dist/react/query-keys.js

@@ -0,0 +1,249 @@
+/**
+ * The one place a Kortix query key is constructed.
+ *
+ * Before this existed, `apps/web` hand-typed roughly 176 key literals across
+ * 30 `project*` families. One entity therefore had several cache entries (the
+ * flat `project-sessions` key and the flat `project-session-inventory` key
+ * held the same server data), and one key had several freshness contracts, because
+ * `staleTime` is per-observer and seven call sites disagreed about it.
+ *
+ * The first version of `sessions(id)` repeated that exact mistake one level
+ * down: it dropped `listProjectSessions`'s `scope` argument, so a
+ * `scope: 'visible'` reader and a `scope: 'project'` reader (a DIFFERENT
+ * server request — see `sessions` below) shared one cache slot, and
+ * whichever fetch resolved last silently overwrote what the other scope's
+ * readers saw. Anything that changes the response MUST be part of the key —
+ * that is the rule this file exists to enforce, and it is not optional just
+ * because the argument is easy to forget.
+ *
+ * The SECOND version of `sessions(id, scope)` fixed that, then introduced a
+ * narrower version of the same class of bug: `sessions(id, scope)` and
+ * `session(id, sessionId)` were both `sessionsScope(id)` plus exactly one
+ * segment, so a session id equal to a scope literal (`'visible'`,
+ * `'project'`) would collide byte-for-byte with a scoped list. Nothing in
+ * THIS file prevented that — the only thing standing in the way was a UUID
+ * regex enforced server-side, in `apps/api`, a different package, with no
+ * link back here. `sessions` now inserts a literal `'list'` segment so it is
+ * structurally longer than `session(...)` for every possible session id —
+ * the collision is unrepresentable, not merely unlikely.
+ *
+ * Two rules make this work:
+ *
+ *  1. `scope(id)` is a PREFIX, never a query key. Everything belonging to one
+ *     project sits under it, so `invalidateQueries({ queryKey: scope(id) })`
+ *     provably reaches all of it.
+ *  2. Nothing derived from another query gets its own key. Skills, commands
+ *     and agents are `config.*` fields of the project detail response, not
+ *     separate fetches — they are `select` projections over `detail(id)`.
+ *
+ * Not to be confused with `kortixKeys` in `use-kortix-master.ts`, which
+ * addresses the multi-server Kortix Master surface and means something else.
+ *
+ * The root segment below is `'kx'`, not `'kortix'`. `'kortix'` is already
+ * `kortixKeys`'s root (`use-kortix-master.ts:276-279`):
+ * `kortixKeys.projects() = ['kortix', 'projects']` and
+ * `kortixKeys.project(id) = ['kortix', 'projects', id]`. If this factory also
+ * rooted at `'kortix'`, `kortixKeys.project(id)` and `qk.projects.list(id)`
+ * would be the identical array for a matching id — one cache entry standing
+ * in for two unrelated concepts — and `kortixKeys.projects()` (used as an
+ * `invalidateQueries` prefix at `use-kortix-master.ts:371,384`) would also
+ * match every key this factory produces, since TanStack matches query keys by
+ * prefix. `'kx'` makes the two factories disjoint at segment 0, so neither
+ * can ever prefix-match the other. Do not "tidy" this back to `'kortix'`.
+ */
+export const qk = {
+    projects: {
+        /** Invalidation prefix covering every account's list AND the accountless
+         *  slot. Never pass this as a `queryKey` — `list(accountId)` and
+         *  `list()` are SIBLINGS (`'<id>'` vs `'all'`), not a parent/child pair,
+         *  so `list()` alone does not prefix-match `list(accountId)`. Use this
+         *  when a mutation needs to reach every form at once. */
+        scope: () => ['kx', 'projects'],
+        /** Every project the account can see. `undefined` means the active account. */
+        list: (accountId) => [...qk.projects.scope(), accountId ?? 'all'],
+    },
+    project: {
+        /** Invalidation prefix. Never pass this as a `queryKey`. */
+        scope: (id) => ['kx', 'project', id],
+        /**
+         * The bare project row — `getProject`, `GET /projects/:id`, a
+         * `KortixProject`. NOT `detail(id)` below: `getProjectDetail` hits
+         * `GET /projects/:id/detail` and returns a completely different shape,
+         * `{ project, config, file_count, files, git_connection }`. An earlier
+         * draft of this migration folded the two onto one key because both
+         * requests are "about a project" — but they are different requests with
+         * different responses, so sharing a key means whichever one resolves
+         * last silently overwrites the other's shape: a `data.account_id` reader
+         * (this one) would intermittently receive the detail wrapper instead,
+         * where the same field lives at `data.project.account_id`. Keep them
+         * apart, the same way `sessions`/`session` and `policies`/
+         * `executorPolicies` below are kept apart for the identical reason.
+         */
+        summary: (id) => [...qk.project.scope(id), 'summary'],
+        detail: (id) => [...qk.project.scope(id), 'detail'],
+        /**
+         * Prefix reserved for config-adjacent sub-resources that do NOT share
+         * `getProjectDetail`'s response shape (currently only `modelPicker`
+         * below). The project config DATA ITSELF — `ProjectConfigSummary`,
+         * i.e. `getProjectDetail(id).config` — is not keyed here: it rides the
+         * shared `detail(id)` entry via a `select` projection (see
+         * `use-project-config.ts`), because it IS that same response every
+         * other detail reader already caches. Keying it separately here would
+         * bring back the exact double-fetch this factory exists to remove —
+         * `useProjectConfig` used to do exactly that under a standalone
+         * `['project-config', id]` key.
+         */
+        config: (id) => [...qk.project.scope(id), 'config'],
+        /**
+         * `getProjectModelPicker`, `GET /projects/:id/model-picker` — the compact,
+         * connection-aware model catalog. LIVE: `useProjectModels` (`use-project-
+         * models.ts`) `useQuery`s it directly, rendered at `gateway-view.tsx`,
+         * `gateway-routing.tsx`, `gateway-playground.tsx`, `models-tab.tsx`, and
+         * `use-session.ts`. `useModelEnablement` (`use-model-enablement.ts`) reads
+         * and optimistically writes the SAME entry so a toggle and the picker never
+         * disagree. A routing-policy save's `invalidateQueries` targets this key
+         * too (`gateway-routing.tsx`) — before the `packages/sdk/src/react`
+         * migration that call and every reader above hand-typed the same flat
+         * `project-model-picker` array literal independently; an earlier
+         * version of this comment called the key "dead" because that literal
+         * search only ever turned up the invalidation site, never the readers —
+         * they lived one file away, under `packages/sdk/src/react`, which this
+         * factory did not yet reach.
+         */
+        modelPicker: (id) => [...qk.project.config(id), 'models'],
+        /**
+         * Invalidation prefix for the WHOLE sessions family: the list, in every
+         * scope, and every individual session/message beneath it. Never pass
+         * this as a `queryKey` — pass it to `invalidateQueries` at every site
+         * that means "the sessions list changed" (create/rename/delete/restart/
+         * stop/share). `sessions(id)` and `sessions(id, 'project')` are SIBLINGS,
+         * not parent and child (see `sessions` below) — invalidating one alone
+         * would leave the other silently stale, and this prefix is the only form
+         * that reaches both in one call.
+         */
+        sessionsScope: (id) => [...qk.project.scope(id), 'sessions'],
+        /**
+         * The sessions list. `scope` is part of the key ON PURPOSE:
+         * `listProjectSessions(id, { scope })`
+         * (`core/rest/projects-client/sessions.ts`) is a DIFFERENT server
+         * request per scope, not a client-side filter of one response —
+         * `'visible'` (the default; matches passing no `options` at all) returns
+         * what the caller can see, `'project'` is the manager-only unfiltered
+         * full inventory (`apps/api/src/projects/lib/session-inventory.ts`).
+         * Before this, both scopes shared one scope-less key, so whichever fetch
+         * resolved last silently overwrote what the OTHER scope's readers saw —
+         * the sidebar could render the unfiltered manager inventory, or the
+         * inventory page could render the sidebar's filtered list. Use
+         * `sessionsScope(id)`, not this, for invalidation.
+         *
+         * The literal `'list'` segment exists so this can NEVER collide with
+         * `session(id, sessionId)` below. Without it, both were
+         * `sessionsScope(id)` plus exactly one segment — a session whose id
+         * happened to equal the string `'visible'` or `'project'` would produce
+         * the identical array a scoped list produces, and the two would silently
+         * overwrite each other. Session ids are `crypto.randomUUID()`
+         * client-side and rejected server-side otherwise
+         * (`apps/api/src/projects/lib/sessions.ts`), so that made the collision
+         * unreachable, not impossible — safety by an invariant enforced in a
+         * DIFFERENT package, with no link back to this file. `'list'` makes
+         * `sessions(...)` structurally longer than `session(...)` for every
+         * possible session id, which is the same standard this file already
+         * applies to the `'kx'` root (see the top doc comment): make the
+         * collision unrepresentable, don't rely on another package's validation
+         * staying strict.
+         */
+        sessions: (id, scope = 'visible') => [...qk.project.sessionsScope(id), 'list', scope],
+        /**
+         * One session, by id. Nests directly under the scope-LESS
+         * `sessionsScope` prefix, not under a specific `sessions(id, scope)`
+         * slot: a session is not "owned" by whichever list scope happened to
+         * discover it (the same session id is reachable via either scope), so
+         * its own cache entry does not carry a scope segment either.
+         */
+        session: (id, sessionId) => [...qk.project.sessionsScope(id), sessionId],
+        messages: (id, sessionId) => [...qk.project.session(id, sessionId), 'messages'],
+        /**
+         * Orphaned pre-existing behavior, migrated verbatim rather than "fixed":
+         * three `apps/web` call sites invalidate this slot after a session
+         * restart / config reload, and one reads it with `getQueryData`, but no
+         * site anywhere `useQuery`s or `setQueryData`s it — so the read always
+         * resolves `undefined` and the three invalidations are no-ops today.
+         * Nests under `session(id, sessionId)` rather than folding onto it
+         * because `session(...)` became a REAL, live query in this same
+         * migration (`getProjectSession`); sharing that slot would make these
+         * dead invalidations start firing against real session data instead of
+         * continuing to hit nothing.
+         */
+        sessionSandbox: (id, sessionId) => [...qk.project.session(id, sessionId), 'sandbox'],
+        connectors: (id) => [...qk.project.scope(id), 'connectors'],
+        /** One connector's config — `getConnectorConfig(id, slug)`. */
+        connectorConfig: (id, slug) => [...qk.project.connectors(id), slug],
+        access: (id) => [...qk.project.scope(id), 'access'],
+        accessRequests: (id) => [...qk.project.access(id), 'requests'],
+        pendingInvites: (id) => [...qk.project.access(id), 'invites'],
+        /** `listProjectGroupGrants` — `GET /group-grants`, `{ grants: ProjectGroupGrant[] }`. */
+        groupGrants: (id) => [...qk.project.access(id), 'group-grants'],
+        /** `listProjectResourceGrants` — `GET /resource-grants`, a DIFFERENT
+         *  endpoint and shape from `groupGrants` above; do not fold together. */
+        resourceGrants: (id) => [...qk.project.access(id), 'grants'],
+        secrets: (id) => [...qk.project.scope(id), 'secrets'],
+        /** Stable App inventory for `GET /projects/:id/apps`. */
+        apps: (id) => [...qk.project.scope(id), 'apps'],
+        /** Access policy and short-lived browser session for one App. */
+        appAccess: (id, appId) => [...qk.project.apps(id), appId, 'access'],
+        /** Short-lived browser exchange URL for one App. */
+        appAccessSession: (id, appId) => [...qk.project.appAccess(id, appId), 'session'],
+        /** Immutable deployment history for one App. */
+        appDeployments: (id, appId) => [...qk.project.apps(id), appId, 'deployments'],
+        /** `listProjectTriggers` — `GET /projects/:id/triggers`, the cron/webhook
+         *  listing (file-defined in the repo manifest). Shared by
+         *  `useProjectTriggers` (`use-project-triggers.ts`), the Customize
+         *  settings pause switch, and the schedule/triggers view — all three read
+         *  and write the identical entity through `listProjectTriggers(id)`, so
+         *  they must share this one key. */
+        triggers: (id) => [...qk.project.scope(id), 'triggers'],
+        /**
+         * `readProjectFile(id, path)` — a single-file source read, used by the
+         * Customize config-entity viewer. Unrelated to the much larger Git file
+         * browser under `features/project-files/` (its own local key factories,
+         * `commitKeys`/`branchKeys`/`changeRequestKeys`, rooted at the literal
+         * string `'project-files'` — never migrated onto `qk`, and never sharing
+         * this prefix).
+         */
+        files: (id) => [...qk.project.scope(id), 'files'],
+        fileSource: (id, path) => [...qk.project.files(id), path],
+        branches: (id) => [...qk.project.scope(id), 'branches'],
+        /** IAM role policies — `listPolicies(accountId, { scopeId: id })`,
+         *  `{ policies: IamPolicy[] }`. NOT the same entity as
+         *  `executorPolicies` below — see that member's doc comment. */
+        policies: (id) => [...qk.project.scope(id), 'policies'],
+        /**
+         * Executor sandbox tool-execution allow/deny rules —
+         * `listProjectPolicies(id)`, `GET /executor/projects/:id/policies`,
+         * `ProjectPoliciesResponse`. A DIFFERENT endpoint and a DIFFERENT shape
+         * from `policies` above (account IAM role policies) — both used to read
+         * the identical literal `['project-policies', id]`, so whichever one's
+         * fetch resolved last silently overwrote the other's cache entry with an
+         * incompatible shape. Sibling of `policies`, not nested under it: they
+         * are unrelated domains that happen to share a name, not a parent/child
+         * pair, so invalidating one must never reach the other.
+         */
+        executorPolicies: (id) => [...qk.project.scope(id), 'executor-policies'],
+        sandboxes: (id) => [...qk.project.scope(id), 'sandboxes'],
+        sandboxTemplates: (id) => [...qk.project.sandboxes(id), 'templates'],
+        snapshots: (id) => [...qk.project.scope(id), 'snapshots'],
+        /** Prefix for the gateway family — keys, budgets, series, logs, overview. */
+        gateway: (id) => [...qk.project.scope(id), 'gateway'],
+        gatewayOverview: (id, days) => [...qk.project.gateway(id), 'overview', days],
+        gatewaySeries: (id, days) => [...qk.project.gateway(id), 'series', days],
+        gatewayBreakdown: (id, days) => [...qk.project.gateway(id), 'breakdown', days],
+        gatewaySessions: (id, days) => [...qk.project.gateway(id), 'sessions', days],
+        gatewayErrors: (id, days) => [...qk.project.gateway(id), 'errors', days],
+        /** `ok` mirrors `listGatewayLogs`'s optional pass/fail filter — `null` = unfiltered. */
+        gatewayLogs: (id, ok) => [...qk.project.gateway(id), 'logs', ok],
+        gatewayLog: (id, logId) => [...qk.project.gateway(id), 'log', logId],
+        gatewayBudgets: (id) => [...qk.project.gateway(id), 'budgets'],
+        gatewayKeys: (id) => [...qk.project.gateway(id), 'keys'],
+    },
+};
+//# sourceMappingURL=query-keys.js.map

package/dist/react/query-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-keys.js","sourceRoot":"","sources":["../../src/react/query-keys.ts"],"names":[],"mappings":"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"}

package/dist/react/session-title-sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-title-sync.d.ts","sourceRoot":"","sources":["../../src/react/session-title-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,KAAK,uBAAuB,GAAG,IAAI,CAAC,WAAW,EAAE,cAAc,GAAG,gBAAgB,CAAC,CAAC;AAEpF,UAAU,0BAA0B;IAClC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE;AA8DD;;;;;GAKG;AACH,wBAAsB,qCAAqC,CACzD,WAAW,EAAE,uBAAuB,EACpC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED;;;;;GAKG;AACH,wBAAsB,6BAA6B,CACjD,WAAW,EAAE,uBAAuB,EACpC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EACxB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,OAAO,CAAC,CAIlB"}
+{"version":3,"file":"session-title-sync.d.ts","sourceRoot":"","sources":["../../src/react/session-title-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIzD,KAAK,uBAAuB,GAAG,IAAI,CAAC,WAAW,EAAE,cAAc,GAAG,gBAAgB,CAAC,CAAC;AAEpF,UAAU,0BAA0B;IAClC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAClE;AAuED;;;;;GAKG;AACH,wBAAsB,qCAAqC,CACzD,WAAW,EAAE,uBAAuB,EACpC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED;;;;;GAKG;AACH,wBAAsB,6BAA6B,CACjD,WAAW,EAAE,uBAAuB,EACpC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EACxB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,OAAO,CAAC,CAIlB"}

package/dist/react/session-title-sync.js

@@ -1,3 +1,4 @@
+import { qk } from './query-keys.js';
 const DEFAULT_TITLE_REFRESH_DELAYS_MS = [0, 5_000, 5_000, 10_000, 10_000, 15_000, 20_000];
 function readRealTitle(value) {
     const title = typeof value === 'string' ? value.trim() : '';
@@ -6,8 +7,13 @@ function readRealTitle(value) {
     return title;
 }
 function cachedSessionHasTitle(queryClient, projectId, sessionId) {
-    const list = queryClient.getQueryData(['project-sessions', projectId]);
-    const detail = queryClient.getQueryData(['project-session', projectId, sessionId]);
+    // Exact-match reads (`getQueryData`), so these have to be the REAL cache
+    // entries the list/detail queries populate, not the broad `sessionsScope`
+    // invalidation prefix used below — `getQueryData` never does prefix
+    // matching. Default scope ('visible') matches `listProjectSessions`' own
+    // default and what the sidebar/list surfaces actually read.
+    const list = queryClient.getQueryData(qk.project.sessions(projectId));
+    const detail = queryClient.getQueryData(qk.project.session(projectId, sessionId));
     const candidates = [...(Array.isArray(list) ? list : []), detail];
     return candidates.some((candidate) => {
         if (!candidate || typeof candidate !== 'object')
@@ -25,12 +31,16 @@ function cachedSessionHasTitle(queryClient, projectId, sessionId) {
 }
 function refetchSessionTitleQueries(queryClient, projectId, sessionId) {
     return Promise.all([
+        // The broad sessions-family prefix, not just the default-scope list: it
+        // reaches the list in EVERY scope plus every session/messages entry
+        // beneath it, so a manager-only 'project'-scope reader picks up the
+        // resolved title too, not only the default 'visible' one.
         queryClient.refetchQueries({
-            queryKey: ['project-sessions', projectId],
+            queryKey: qk.project.sessionsScope(projectId),
             type: 'active',
         }),
         queryClient.refetchQueries({
-            queryKey: ['project-session', projectId, sessionId],
+            queryKey: qk.project.session(projectId, sessionId),
             type: 'active',
         }),
     ]);

package/dist/react/session-title-sync.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-title-sync.js","sourceRoot":"","sources":["../../src/react/session-title-sync.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session-title-sync.js","sourceRoot":"","sources":["../../src/react/session-title-sync.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAUlC,MAAM,+BAA+B,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE1F,SAAS,aAAa,CAAC,KAAc;IACnC,MAAM,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,IAAI,CAAC,KAAK,IAAI,2BAA2B,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,qBAAqB,CAC5B,WAA8C,EAC9C,SAAiB,EACjB,SAAiB;IAEjB,yEAAyE;IACzE,0EAA0E;IAC1E,oEAAoE;IACpE,yEAAyE;IACzE,4DAA4D;IAC5D,MAAM,IAAI,GAAG,WAAW,CAAC,YAAY,CAAU,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/E,MAAM,MAAM,GAAG,WAAW,CAAC,YAAY,CAAU,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;IAC3F,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IAClE,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE;QACnC,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAC9D,MAAM,OAAO,GAAG,SAAoC,CAAC;QACrD,MAAM,WAAW,GACf,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ;YACpC,CAAC,CAAC,OAAO,CAAC,UAAU;YACpB,CAAC,CAAC,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ;gBACrC,CAAC,CAAC,OAAO,CAAC,SAAS;gBACnB,CAAC,CAAC,IAAI,CAAC;QACb,IAAI,WAAW,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAC5C,OAAO,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,0BAA0B,CACjC,WAAgD,EAChD,SAAiB,EACjB,SAAiB;IAEjB,OAAO,OAAO,CAAC,GAAG,CAAC;QACjB,wEAAwE;QACxE,oEAAoE;QACpE,oEAAoE;QACpE,0DAA0D;QAC1D,WAAW,CAAC,cAAc,CAAC;YACzB,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC;YAC7C,IAAI,EAAE,QAAQ;SACf,CAAC;QACF,WAAW,CAAC,cAAc,CAAC;YACzB,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC;YAClD,IAAI,EAAE,QAAQ;SACf,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED,SAAS,KAAK,CAAC,OAAe,EAAE,MAAoB;IAClD,IAAI,OAAO,IAAI,CAAC,IAAI,MAAM,EAAE,OAAO;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC9D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC7C,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC1C,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qCAAqC,CACzD,WAAoC,EACpC,SAAiB,EACjB,SAAiB,EACjB,UAAsC,EAAE;IAExC,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,IAAI,+BAA+B,CAAC;IACnE,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;IAEpC,KAAK,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;QAC7B,MAAM,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO;YAAE,OAAO,KAAK,CAAC;QAC1C,IAAI,qBAAqB,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1E,MAAM,0BAA0B,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QACpE,IAAI,qBAAqB,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,CAAC;YAAE,OAAO,IAAI,CAAC;IAC5E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,WAAoC,EACpC,SAAiB,EACjB,SAAiB,EACjB,gBAAwB,EACxB,UAAsC,EAAE;IAExC,IAAI,gBAAgB,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,IAAI,qBAAqB,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1E,OAAO,qCAAqC,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AAC3F,CAAC"}