@kortix/sdk 0.12.5 → 0.12.7

package/dist/react/index.d.ts

@@ -9,9 +9,12 @@ export { useProjectSecrets, projectSecretsKey } from './use-project-secrets.js';
 export { useProjectTriggers, projectTriggersKey } from './use-project-triggers.js';
 export { useChangeRequests, changeRequestsKey } from './use-change-requests.js';
 export { useGatewayRoutingPolicy, gatewayRoutingPolicyKey } from './use-gateway-routing-policy.js';
+export { useProjectApps, useAppDeployments, useAppAccess, projectAppsKey, appDeploymentsKey, } from './use-project-apps.js';
 export { NoCompactionModelError } from './use-opencode-sessions/no-compaction-model-error.js';
 export * from './use-admin-accounts.js';
+export * from './use-admin-projects.js';
 export * from './use-admin-analytics.js';
+export * from './use-admin-activity-analytics.js';
 export * from './use-admin-feedback.js';
 export * from './use-system-status.js';
 export * from './use-ops-overview.js';
@@ -22,4 +25,10 @@ export * from './use-admin-sandboxes.js';
 export * from './use-authenticated-preview-url.js';
 export * from './run-pty-command.js';
 export * from './runtime-actions.js';
+export * from './query-keys.js';
+export * from './query-contracts.js';
+export * from './use-project-name.js';
+export * from './use-project-session.js';
+export * from './invalidate-project.js';
+export * from './use-feature-flag.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAKA,cAAc,YAAY,CAAC;AAI3B,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,SAAS,GACf,MAAM,eAAe,CAAC;AAKvB,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,KAAK,cAAc,GACpB,MAAM,yBAAyB,CAAC;AAOjC,OAAO,EACL,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,sBAAsB,GAC5B,MAAM,6BAA6B,CAAC;AAOrC,cAAc,qBAAqB,CAAC;AAMpC,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,4BAA4B,EAC5B,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAC;AAQ5B,OAAO,EAAE,YAAY,EAAE,KAAK,QAAQ,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC;AAOtF,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAMhG,OAAO,EAAE,sBAAsB,EAAE,MAAM,mDAAmD,CAAC;AAC3F,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,iCAAiC,CAAC;AAChD,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAKA,cAAc,YAAY,CAAC;AAI3B,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,SAAS,GACf,MAAM,eAAe,CAAC;AAKvB,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,KAAK,cAAc,GACpB,MAAM,yBAAyB,CAAC;AAOjC,OAAO,EACL,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,sBAAsB,GAC5B,MAAM,6BAA6B,CAAC;AAOrC,cAAc,qBAAqB,CAAC;AAMpC,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,4BAA4B,EAC5B,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAC;AAQ5B,OAAO,EAAE,YAAY,EAAE,KAAK,QAAQ,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC;AAOtF,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAChG,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAM5B,OAAO,EAAE,sBAAsB,EAAE,MAAM,mDAAmD,CAAC;AAC3F,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,iCAAiC,CAAC;AAChD,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAOlC,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC"}

package/dist/react/index.js

@@ -43,13 +43,16 @@ export { useProjectSecrets, projectSecretsKey } from './use-project-secrets.js';
 export { useProjectTriggers, projectTriggersKey } from './use-project-triggers.js';
 export { useChangeRequests, changeRequestsKey } from './use-change-requests.js';
 export { useGatewayRoutingPolicy, gatewayRoutingPolicyKey } from './use-gateway-routing-policy.js';
+export { useProjectApps, useAppDeployments, useAppAccess, projectAppsKey, appDeploymentsKey, } from './use-project-apps.js';
 // The expected "no compaction model configured" configuration state thrown by
 // `useSummarizeOpenCodeSession`'s mutation when every model-resolution fallback
 // tier fails. Re-exported here so hosts + the telemetry noise gate can
 // `instanceof`-match it without reaching into the hook's internal path.
 export { NoCompactionModelError } from './use-opencode-sessions/no-compaction-model-error.js';
 export * from './use-admin-accounts.js';
+export * from './use-admin-projects.js';
 export * from './use-admin-analytics.js';
+export * from './use-admin-activity-analytics.js';
 export * from './use-admin-feedback.js';
 export * from './use-system-status.js';
 export * from './use-ops-overview.js';
@@ -60,4 +63,15 @@ export * from './use-admin-sandboxes.js';
 export * from './use-authenticated-preview-url.js';
 export * from './run-pty-command.js';
 export * from './runtime-actions.js';
+// The client-cache-unification `qk` key factory (rooted at `'kx'`, disjoint
+// from `kortixKeys`'s `'kortix'` root above) + its four freshness tiers, the
+// single `useProjectName` accessor, and the invalidation/optimistic-write
+// helpers that keep the projects-list and project-detail caches in sync. See
+// `query-keys.ts` for why the root segment is `'kx'` and not `'kortix'`.
+export * from './query-keys.js';
+export * from './query-contracts.js';
+export * from './use-project-name.js';
+export * from './use-project-session.js';
+export * from './invalidate-project.js';
+export * from './use-feature-flag.js';
 //# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,0EAA0E;AAC1E,gFAAgF;AAChF,qEAAqE;AACrE,cAAc,YAAY,CAAC;AAE3B,+EAA+E;AAC/E,qEAAqE;AACrE,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,iBAAiB,GAKlB,MAAM,eAAe,CAAC;AAEvB,qEAAqE;AACrE,8EAA8E;AAC9E,4EAA4E;AAC5E,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,uBAAuB,GAExB,MAAM,yBAAyB,CAAC;AAEjC,8EAA8E;AAC9E,0EAA0E;AAC1E,uEAAuE;AACvE,iEAAiE;AACjE,8BAA8B;AAC9B,OAAO,EACL,eAAe,GAMhB,MAAM,6BAA6B,CAAC;AAErC,0EAA0E;AAC1E,8DAA8D;AAC9D,sEAAsE;AACtE,yEAAyE;AACzE,4EAA4E;AAC5E,cAAc,qBAAqB,CAAC;AAEpC,0EAA0E;AAC1E,4EAA4E;AAC5E,2EAA2E;AAC3E,uEAAuE;AACvE,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,4BAA4B,EAC5B,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,GAajB,MAAM,oBAAoB,CAAC;AAE5B,yEAAyE;AACzE,mEAAmE;AACnE,2EAA2E;AAC3E,yEAAyE;AACzE,uEAAuE;AACvE,yCAAyC;AACzC,OAAO,EAAE,YAAY,EAAiB,WAAW,EAAsB,MAAM,QAAQ,CAAC;AAEtF,uEAAuE;AACvE,uEAAuE;AACvE,yEAAyE;AACzE,0EAA0E;AAC1E,oDAAoD;AACpD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEhG,8EAA8E;AAC9E,gFAAgF;AAChF,uEAAuE;AACvE,wEAAwE;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mDAAmD,CAAC;AAC3F,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,iCAAiC,CAAC;AAChD,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,0EAA0E;AAC1E,gFAAgF;AAChF,qEAAqE;AACrE,cAAc,YAAY,CAAC;AAE3B,+EAA+E;AAC/E,qEAAqE;AACrE,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,iBAAiB,GAKlB,MAAM,eAAe,CAAC;AAEvB,qEAAqE;AACrE,8EAA8E;AAC9E,4EAA4E;AAC5E,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,uBAAuB,GAExB,MAAM,yBAAyB,CAAC;AAEjC,8EAA8E;AAC9E,0EAA0E;AAC1E,uEAAuE;AACvE,iEAAiE;AACjE,8BAA8B;AAC9B,OAAO,EACL,eAAe,GAMhB,MAAM,6BAA6B,CAAC;AAErC,0EAA0E;AAC1E,8DAA8D;AAC9D,sEAAsE;AACtE,yEAAyE;AACzE,4EAA4E;AAC5E,cAAc,qBAAqB,CAAC;AAEpC,0EAA0E;AAC1E,4EAA4E;AAC5E,2EAA2E;AAC3E,uEAAuE;AACvE,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,4BAA4B,EAC5B,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,GAajB,MAAM,oBAAoB,CAAC;AAE5B,yEAAyE;AACzE,mEAAmE;AACnE,2EAA2E;AAC3E,yEAAyE;AACzE,uEAAuE;AACvE,yCAAyC;AACzC,OAAO,EAAE,YAAY,EAAiB,WAAW,EAAsB,MAAM,QAAQ,CAAC;AAEtF,uEAAuE;AACvE,uEAAuE;AACvE,yEAAyE;AACzE,0EAA0E;AAC1E,oDAAoD;AACpD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAChG,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,8EAA8E;AAC9E,gFAAgF;AAChF,uEAAuE;AACvE,wEAAwE;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mDAAmD,CAAC;AAC3F,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,cAAc,CAAC;AAC7B,cAAc,uBAAuB,CAAC;AACtC,cAAc,iCAAiC,CAAC;AAChD,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAElC,4EAA4E;AAC5E,6EAA6E;AAC7E,0EAA0E;AAC1E,6EAA6E;AAC7E,yEAAyE;AACzE,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC"}

package/dist/react/invalidate-project.d.ts

@@ -0,0 +1,76 @@
+import type { QueryClient, QueryKey } from '@tanstack/react-query';
+/** Everything belonging to one project. Use after a write with broad effect. */
+export declare function invalidateProject(qc: QueryClient, projectId: string): Promise<void>;
+/**
+ * A project's NAME lives in two caches: every projects-LIST entry and the
+ * detail entry. Rename previously invalidated only `qk.projects.list()` — the
+ * single accountless slot — so the sidebar and the project home title
+ * disagreed until eviction. That was ALSO a second, narrower bug on top of
+ * the first: `qk.projects.list(accountId)` and `qk.projects.list()` are
+ * SIBLINGS under `qk.projects.scope()`, not parent and child (see
+ * `query-keys.ts`'s own warning about exactly this collision shape) — so
+ * invalidating `list()` alone never reached the account-scoped list every
+ * real project switcher actually reads. Reaching every list form needs the
+ * two-element `qk.projects.scope()` PREFIX, not the three-element `list()`
+ * key. Both invalidations, always, or the bug returns.
+ */
+export declare function invalidateProjectIdentity(qc: QueryClient, projectId: string): Promise<void>;
+type ProjectsListEntry = {
+    project_id: string;
+    name: string;
+};
+type ProjectDetailEntry = {
+    project?: {
+        name?: string;
+    };
+};
+/**
+ * Exactly what `writeProjectNameOptimistically` overwrote, restorable with
+ * `restoreProjectName`. `lists` is an array, not a single entry, because the
+ * project can be cached under several account-scoped list keys at once — see
+ * `invalidateProjectIdentity`'s doc comment for why that's a prefix, not a
+ * single key. A key with no snapshot row was never cached at write time, and
+ * `restoreProjectName` will correctly leave it alone.
+ */
+export interface ProjectNameSnapshot {
+    detail: ProjectDetailEntry | undefined;
+    lists: Array<{
+        queryKey: QueryKey;
+        data: ProjectsListEntry[] | undefined;
+    }>;
+}
+/**
+ * Paint the new name in the same frame the rename dialog closes, instead of a
+ * round-trip later. Callers still invalidate on settle; this only removes the
+ * visible lag. A missing cache entry is not an error — nothing to update yet.
+ *
+ * Returns a snapshot of exactly what it overwrote, so the caller can restore
+ * it with `restoreProjectName` if the mutation fails — see that function's
+ * doc comment for why a failed rename used to leave the optimistic name
+ * cached permanently. `setQueryData` needs an exact key, so the list side
+ * can't just target the `qk.projects.scope()` prefix directly — it fans out
+ * with `setQueriesData`, verified empirically to update every matching list
+ * entry and nothing outside the prefix (confirmed against the real TanStack
+ * engine: two sibling list keys both update, an unrelated
+ * `qk.project.detail` entry does not).
+ */
+export declare function writeProjectNameOptimistically(qc: QueryClient, projectId: string, name: string): ProjectNameSnapshot;
+/**
+ * Put back exactly what `writeProjectNameOptimistically` overwrote. THE
+ * Critical-path fix: `onMutate` used to write the optimistic name but never
+ * snapshot what it overwrote, and `onError` only showed a toast — so a FAILED
+ * rename left the wrong name cached until `invalidateQueries` happened to hit
+ * a mounted observer, which (with `refetchOnMount: false`, before that was
+ * also fixed) it never did. The wrong name was permanent until a hard
+ * refresh.
+ *
+ * Restores each snapshotted list key individually rather than re-invalidating
+ * broadly: a key with no row in `snapshot.lists` was never cached at write
+ * time (or was populated by an unrelated mutation AFTER the snapshot), and
+ * this leaves it untouched rather than evicting data this rollback never saw.
+ * `setQueryData(key, undefined)` is a verified no-op (does not evict an
+ * existing entry), so a snapshot that captured nothing is safely a no-op too.
+ */
+export declare function restoreProjectName(qc: QueryClient, projectId: string, snapshot: ProjectNameSnapshot): void;
+export {};
+//# sourceMappingURL=invalidate-project.d.ts.map

package/dist/react/invalidate-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalidate-project.d.ts","sourceRoot":"","sources":["../../src/react/invalidate-project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGnE,gFAAgF;AAChF,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,yBAAyB,CAC7C,EAAE,EAAE,WAAW,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,KAAK,iBAAiB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAC9D,KAAK,kBAAkB,GAAG;IAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACvC,KAAK,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,IAAI,EAAE,iBAAiB,EAAE,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;CAC7E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,8BAA8B,CAC5C,EAAE,EAAE,WAAW,EACf,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,mBAAmB,CAkBrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,WAAW,EACf,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,mBAAmB,GAC5B,IAAI,CAKN"}

package/dist/react/invalidate-project.js

@@ -0,0 +1,72 @@
+import { qk } from './query-keys.js';
+/** Everything belonging to one project. Use after a write with broad effect. */
+export async function invalidateProject(qc, projectId) {
+    await qc.invalidateQueries({ queryKey: qk.project.scope(projectId) });
+}
+/**
+ * A project's NAME lives in two caches: every projects-LIST entry and the
+ * detail entry. Rename previously invalidated only `qk.projects.list()` — the
+ * single accountless slot — so the sidebar and the project home title
+ * disagreed until eviction. That was ALSO a second, narrower bug on top of
+ * the first: `qk.projects.list(accountId)` and `qk.projects.list()` are
+ * SIBLINGS under `qk.projects.scope()`, not parent and child (see
+ * `query-keys.ts`'s own warning about exactly this collision shape) — so
+ * invalidating `list()` alone never reached the account-scoped list every
+ * real project switcher actually reads. Reaching every list form needs the
+ * two-element `qk.projects.scope()` PREFIX, not the three-element `list()`
+ * key. Both invalidations, always, or the bug returns.
+ */
+export async function invalidateProjectIdentity(qc, projectId) {
+    await Promise.all([
+        qc.invalidateQueries({ queryKey: qk.projects.scope() }),
+        qc.invalidateQueries({ queryKey: qk.project.detail(projectId) }),
+    ]);
+}
+/**
+ * Paint the new name in the same frame the rename dialog closes, instead of a
+ * round-trip later. Callers still invalidate on settle; this only removes the
+ * visible lag. A missing cache entry is not an error — nothing to update yet.
+ *
+ * Returns a snapshot of exactly what it overwrote, so the caller can restore
+ * it with `restoreProjectName` if the mutation fails — see that function's
+ * doc comment for why a failed rename used to leave the optimistic name
+ * cached permanently. `setQueryData` needs an exact key, so the list side
+ * can't just target the `qk.projects.scope()` prefix directly — it fans out
+ * with `setQueriesData`, verified empirically to update every matching list
+ * entry and nothing outside the prefix (confirmed against the real TanStack
+ * engine: two sibling list keys both update, an unrelated
+ * `qk.project.detail` entry does not).
+ */
+export function writeProjectNameOptimistically(qc, projectId, name) {
+    const lists = qc.getQueriesData({ queryKey: qk.projects.scope() });
+    const snapshot = {
+        detail: qc.getQueryData(qk.project.detail(projectId)),
+        lists: lists.map(([queryKey, data]) => ({ queryKey, data })),
+    };
+    qc.setQueriesData({ queryKey: qk.projects.scope() }, (prev) => prev?.map((p) => (p.project_id === projectId ? { ...p, name } : p)));
+    qc.setQueryData(qk.project.detail(projectId), (prev) => prev?.project ? { ...prev, project: { ...prev.project, name } } : prev);
+    return snapshot;
+}
+/**
+ * Put back exactly what `writeProjectNameOptimistically` overwrote. THE
+ * Critical-path fix: `onMutate` used to write the optimistic name but never
+ * snapshot what it overwrote, and `onError` only showed a toast — so a FAILED
+ * rename left the wrong name cached until `invalidateQueries` happened to hit
+ * a mounted observer, which (with `refetchOnMount: false`, before that was
+ * also fixed) it never did. The wrong name was permanent until a hard
+ * refresh.
+ *
+ * Restores each snapshotted list key individually rather than re-invalidating
+ * broadly: a key with no row in `snapshot.lists` was never cached at write
+ * time (or was populated by an unrelated mutation AFTER the snapshot), and
+ * this leaves it untouched rather than evicting data this rollback never saw.
+ * `setQueryData(key, undefined)` is a verified no-op (does not evict an
+ * existing entry), so a snapshot that captured nothing is safely a no-op too.
+ */
+export function restoreProjectName(qc, projectId, snapshot) {
+    for (const { queryKey, data } of snapshot.lists) {
+        qc.setQueryData(queryKey, data);
+    }
+    qc.setQueryData(qk.project.detail(projectId), snapshot.detail);
+}
+//# sourceMappingURL=invalidate-project.js.map

package/dist/react/invalidate-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalidate-project.js","sourceRoot":"","sources":["../../src/react/invalidate-project.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAElC,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,EAAe,EAAE,SAAiB;IACxE,MAAM,EAAE,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;AACxE,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,EAAe,EACf,SAAiB;IAEjB,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,EAAE,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC;QACvD,EAAE,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;KACjE,CAAC,CAAC;AACL,CAAC;AAkBD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,8BAA8B,CAC5C,EAAe,EACf,SAAiB,EACjB,IAAY;IAEZ,MAAM,KAAK,GAAG,EAAE,CAAC,cAAc,CAAsB,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACxF,MAAM,QAAQ,GAAwB;QACpC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAqB,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACzE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;KAC7D,CAAC;IAEF,EAAE,CAAC,cAAc,CACf,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,EACjC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAC9E,CAAC;IACF,EAAE,CAAC,YAAY,CACb,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,EAC5B,CAAC,IAAoC,EAAE,EAAE,CACvC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CACzE,CAAC;IAEF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,kBAAkB,CAChC,EAAe,EACf,SAAiB,EACjB,QAA6B;IAE7B,KAAK,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QAChD,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IACD,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;AACjE,CAAC"}

package/dist/react/provider-refresh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider-refresh.d.ts","sourceRoot":"","sources":["../../src/react/provider-refresh.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAOzD,KAAK,kCAAkC,GAAG;IACxC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAKF;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAWT;AAaD,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,kCAAuC,GAC5C,IAAI,CA8CN"}
+{"version":3,"file":"provider-refresh.d.ts","sourceRoot":"","sources":["../../src/react/provider-refresh.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAQzD,KAAK,kCAAkC,GAAG;IACxC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAKF;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAWT;AAaD,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,kCAAuC,GAC5C,IAAI,CAsDN"}

package/dist/react/provider-refresh.js

@@ -3,6 +3,7 @@ import { listProjectSecrets } from '../core/rest/projects-client/index.js';
 import { connectedGatewayProviderIdsFromSecretNames } from './provider-selection.js';
 import { configKeys } from './use-opencode-config.js';
 import { clearProjectProviderCache, opencodeKeys } from './use-opencode-sessions/index.js';
+import { qk } from './query-keys.js';
 const CONVERGE_POLL_MS = 2_500;
 const CONVERGE_DEADLINE_MS = 45_000;
 /**
@@ -26,8 +27,8 @@ function invalidateProviderQueries(queryClient, projectId) {
     const projectProviderKey = ['project-providers', projectId];
     clearProjectProviderCache(projectId);
     void queryClient.invalidateQueries({ queryKey: projectProviderKey });
-    void queryClient.invalidateQueries({ queryKey: ['project-secrets', projectId] });
-    void queryClient.refetchQueries({ queryKey: ['project-secrets', projectId], type: 'all' });
+    void queryClient.invalidateQueries({ queryKey: qk.project.secrets(projectId) });
+    void queryClient.refetchQueries({ queryKey: qk.project.secrets(projectId), type: 'all' });
     void queryClient.refetchQueries({ queryKey: projectProviderKey, type: 'all' });
     void queryClient.invalidateQueries({ queryKey: opencodeKeys.providers() });
     void queryClient.invalidateQueries({ queryKey: configKeys.all });
@@ -59,8 +60,16 @@ export function refreshProjectProviderState(queryClient, projectId, opts = {}) {
     const poll = async () => {
         let connected = false;
         try {
+            // Same key `useProjectSecrets`/the Customize secrets view read —
+            // pre-migration this was a standalone flat `project-secrets` array
+            // literal, so every poll's `fetchQuery` populated a cache entry no
+            // `useQuery` observer ever read: a real network request whose result
+            // no UI ever saw. Sharing `qk.project.secrets(id)` means the poll's
+            // fresh (`staleTime: 0`) fetch is the SAME entry the secrets UI
+            // renders from, so the picker/secrets list update from this poll
+            // too, not only from the `refetchQueries` burst below.
             const secrets = await queryClient.fetchQuery({
-                queryKey: ['project-secrets', projectId],
+                queryKey: qk.project.secrets(projectId),
                 queryFn: () => listProjectSecrets(projectId),
                 staleTime: 0,
             });

package/dist/react/provider-refresh.js.map

@@ -1 +1 @@
-{"version":3,"file":"provider-refresh.js","sourceRoot":"","sources":["../../src/react/provider-refresh.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"provider-refresh.js","sourceRoot":"","sources":["../../src/react/provider-refresh.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAIb,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,0CAA0C,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAclC,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAC/B,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAEpC;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAgB,EAChB,kBAA0B;IAE1B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAClC,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,CAAE,OAAoE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IACzF,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,IAAI,OAAQ,IAA2B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAClE,KAAK,CAAC,GAAG,CAAE,IAAyB,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IACD,OAAO,0CAA0C,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;AACnF,CAAC;AAED,SAAS,yBAAyB,CAAC,WAAwB,EAAE,SAAiB;IAC5E,MAAM,kBAAkB,GAAG,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC;IAC5D,yBAAyB,CAAC,SAAS,CAAC,CAAC;IACrC,KAAK,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC,CAAC;IACrE,KAAK,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAChF,KAAK,WAAW,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1F,KAAK,WAAW,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/E,KAAK,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAC3E,KAAK,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,WAAwB,EACxB,SAAiB,EACjB,OAA2C,EAAE;IAE7C,MAAM,kBAAkB,GAAG,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC;IAC5D,IAAI,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAClC,WAAW,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,yBAAyB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAElD,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IAE1C,4EAA4E;IAC5E,0EAA0E;IAC1E,yEAAyE;IACzE,6EAA6E;IAC7E,0EAA0E;IAC1E,0EAA0E;IAC1E,yEAAyE;IACzE,4CAA4C;IAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC;IACvC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;YAC5C,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,yBAAyB,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;QACpF,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;QACrC,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC;YACH,iEAAiE;YACjE,mEAAmE;YACnE,mEAAmE;YACnE,qEAAqE;YACrE,oEAAoE;YACpE,gEAAgE;YAChE,iEAAiE;YACjE,uDAAuD;YACvD,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC;gBAC3C,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;gBACvC,OAAO,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,SAAS,CAAC;gBAC5C,SAAS,EAAE,CAAC;aACb,CAAC,CAAC;YACH,SAAS,GAAG,0BAA0B,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAC5D,CAAC;QAAC,MAAM,CAAC;YACP,4DAA4D;QAC9D,CAAC;QACD,IAAI,SAAS,EAAE,CAAC;YACd,yBAAyB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,IAAI,oBAAoB;YAAE,OAAO;QAC3D,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,EAAE,gBAAgB,CAAC,CAAC;IACzD,CAAC,CAAC;IACF,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,EAAE,gBAAgB,CAAC,CAAC;AACzD,CAAC"}

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

@@ -0,0 +1,112 @@
+/**
+ * One freshness contract per entity, declared once.
+ *
+ * `staleTime` is per-OBSERVER in React Query, not per-key. Seven call sites
+ * reading the flat `project-detail` key therefore declared seven answers to "when
+ * does a server-side change reach the user", and which one governed depended
+ * on which pages happened to be mounted. Tiers remove the choice from the call
+ * site: a consumer spreads a contract, it never authors one.
+ *
+ * `refetchOnMount` is `true` everywhere, DELIBERATELY, and it is the second
+ * time this file has gotten it wrong — the first version said `false`
+ * "because explicit invalidation is the freshness channel". That is
+ * empirically false: `invalidateQueries` defaults to `refetchType: 'active'`,
+ * which only refetches queries with a currently-mounted observer. An
+ * invalidated entry with NO mounted observer — the exact shape of a route the
+ * user has navigated away from — is marked invalidated but never refetched,
+ * and `refetchOnMount:false` means the next mount doesn't refetch it either.
+ * It serves its stale (or, worse, wrongly-optimistic — see
+ * `invalidate-project.ts`) value for the rest of `gcTime`. Verified against
+ * the real TanStack engine:
+ *
+ *   refetchOnMount:false -> {"seen":"OPTIMISTIC","totalFetches":1}   wrong value survives
+ *   refetchOnMount:true  -> {"seen":"SERVER","totalFetches":2}        self-heals
+ *
+ * This is NOT a tradeoff against "wasted" fetches on remount, because
+ * `refetchOnMount:true` still respects `staleTime` — it only refetches an
+ * entry that is actually stale or invalidated. A remount of FRESH data costs
+ * the same either way:
+ *
+ *   FRESH-FALSE {"refetchedOnRemount":0,"isPending":false}
+ *   FRESH-TRUE  {"refetchedOnRemount":0,"isPending":false}
+ *
+ * Do not "optimise" this back to `false` without redoing both probes above.
+ */
+export type FreshnessTier = 'live' | 'config' | 'inventory' | 'volatile';
+export declare function contract(tier: FreshnessTier): {
+    staleTime: number;
+    gcTime: number;
+    refetchOnMount: true;
+};
+/**
+ * Entity → tier. Adding an entity here without a tier is a type error, which
+ * is the point: a new query cannot quietly inherit the global default.
+ */
+export declare const FRESHNESS: {
+    readonly projectsList: "inventory";
+    readonly projectSummary: "config";
+    readonly projectDetail: "config";
+    readonly projectConfig: "config";
+    readonly session: "inventory";
+    readonly sessions: "inventory";
+    readonly messages: "live";
+    readonly connectors: "config";
+    readonly connectorConfig: "config";
+    readonly secrets: "config";
+    readonly apps: "inventory";
+    readonly appDeployments: "inventory";
+    readonly policies: "config";
+    readonly executorPolicies: "config";
+    readonly access: "inventory";
+    readonly accessRequests: "inventory";
+    readonly pendingInvites: "inventory";
+    readonly groupGrants: "inventory";
+    readonly resourceGrants: "inventory";
+    readonly files: "config";
+    readonly fileSource: "config";
+    readonly branches: "config";
+    /**
+     * NOT live sandbox health — the sandbox TEMPLATE catalog.
+     * `listProjectSandboxes` is `GET /projects/:id/sandboxes` returning
+     * `SandboxTemplatesResponse` (`{ items, default_slug, provider_mode, … }`),
+     * byte-for-byte the same call `sandboxTemplates` below already makes. Live
+     * health is a different entity entirely — `getProjectSandboxHealth`,
+     * `GET /projects/:id/sandbox-health`, read by `project-sandbox-alert.tsx`
+     * under its own key with its own adaptive `refetchInterval` (8s while a
+     * build is active, 120s otherwise). Nothing on THIS key is time-sensitive.
+     *
+     * Was `volatile` (5s) on the strength of the word "sandbox". Its
+     * pre-migration window was 60s, every change to it arrives through this
+     * app's own mutations (`sandbox-template-form.tsx`, `sandbox-view.tsx` —
+     * all three invalidate this key), and `refetchOnMount: true` at 5s meant a
+     * refetch on essentially every project landing. `config` restores the
+     * original window and matches the twin below, which reads the same
+     * response.
+     */
+    readonly sandboxes: "config";
+    readonly sandboxTemplates: "config";
+    readonly snapshots: "config";
+    readonly modelPicker: "config";
+    /**
+     * Analytics aggregates over a `days` window — overview, series, breakdown,
+     * sessions, errors — plus budgets and keys.
+     *
+     * The aggregates accumulate from TRAFFIC (agent runs, other members),
+     * which no mutation of ours announces, so they cannot be `config`. But they
+     * are aggregates over days: a 5-second window buys nothing a 30-second one
+     * doesn't, and cost real requests — `refetchOnMount: true` at `volatile`
+     * refetched all five on every Customize -> Gateway open. `inventory` is
+     * both the honest description ("can also change from another member") and
+     * exactly their pre-migration 30s window.
+     *
+     * Budgets and keys ride the same tier at 30s against a pre-migration 15s.
+     * Safe: both are mutated only through this UI and both invalidate on
+     * success (`use-project-gateway.ts`), so staleTime only ever bounds an
+     * out-of-band change. `gatewayLogs` opts out entirely — it sets
+     * `refetchInterval: 10_000` and no contract, because a log tail genuinely
+     * is a tail.
+     */
+    readonly gateway: "inventory";
+    readonly triggers: "config";
+};
+//# sourceMappingURL=query-contracts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-contracts.d.ts","sourceRoot":"","sources":["../../src/react/query-contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;AAyBzE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,aAAa;;;;EAM3C;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;IAuBpB;;;;;;;;;;;;;;;;;OAiBG;;;;;IAKH;;;;;;;;;;;;;;;;;;OAkBG;;;CAG6C,CAAC"}

package/dist/react/query-contracts.js

@@ -0,0 +1,100 @@
+const GC_TIME = 30 * 60 * 1000;
+const TIERS = {
+    /** Kept current by SSE events. Polling it would be redundant and racy. */
+    live: { staleTime: Infinity },
+    /** Changes arrive through this app's own mutations, which invalidate. */
+    config: { staleTime: 60_000 },
+    /** Can also change from another member or another tab. */
+    inventory: { staleTime: 30_000 },
+    /**
+     * Genuinely time-sensitive; no mutation announces the change, AND a
+     * 30-second-old value would actively mislead.
+     *
+     * UNCLAIMED as of the `sandboxes`/`gateway` review below. Kept because
+     * `FreshnessTier` is a published string-literal union and dropping a member
+     * is a breaking change — not because anything needs it. The first two
+     * entities put here got it for sounding urgent rather than being urgent, so
+     * the bar for the next claimant is the second clause: name the reader that
+     * is materially wrong at t+30s.
+     */
+    volatile: { staleTime: 5_000 },
+};
+export function contract(tier) {
+    return {
+        staleTime: TIERS[tier].staleTime,
+        gcTime: GC_TIME,
+        refetchOnMount: true,
+    };
+}
+/**
+ * Entity → tier. Adding an entity here without a tier is a type error, which
+ * is the point: a new query cannot quietly inherit the global default.
+ */
+export const FRESHNESS = {
+    projectsList: 'inventory',
+    projectSummary: 'config',
+    projectDetail: 'config',
+    projectConfig: 'config',
+    session: 'inventory',
+    sessions: 'inventory',
+    messages: 'live',
+    connectors: 'config',
+    connectorConfig: 'config',
+    secrets: 'config',
+    apps: 'inventory',
+    appDeployments: 'inventory',
+    policies: 'config',
+    executorPolicies: 'config',
+    access: 'inventory',
+    accessRequests: 'inventory',
+    pendingInvites: 'inventory',
+    groupGrants: 'inventory',
+    resourceGrants: 'inventory',
+    files: 'config',
+    fileSource: 'config',
+    branches: 'config',
+    /**
+     * NOT live sandbox health — the sandbox TEMPLATE catalog.
+     * `listProjectSandboxes` is `GET /projects/:id/sandboxes` returning
+     * `SandboxTemplatesResponse` (`{ items, default_slug, provider_mode, … }`),
+     * byte-for-byte the same call `sandboxTemplates` below already makes. Live
+     * health is a different entity entirely — `getProjectSandboxHealth`,
+     * `GET /projects/:id/sandbox-health`, read by `project-sandbox-alert.tsx`
+     * under its own key with its own adaptive `refetchInterval` (8s while a
+     * build is active, 120s otherwise). Nothing on THIS key is time-sensitive.
+     *
+     * Was `volatile` (5s) on the strength of the word "sandbox". Its
+     * pre-migration window was 60s, every change to it arrives through this
+     * app's own mutations (`sandbox-template-form.tsx`, `sandbox-view.tsx` —
+     * all three invalidate this key), and `refetchOnMount: true` at 5s meant a
+     * refetch on essentially every project landing. `config` restores the
+     * original window and matches the twin below, which reads the same
+     * response.
+     */
+    sandboxes: 'config',
+    sandboxTemplates: 'config',
+    snapshots: 'config',
+    modelPicker: 'config',
+    /**
+     * Analytics aggregates over a `days` window — overview, series, breakdown,
+     * sessions, errors — plus budgets and keys.
+     *
+     * The aggregates accumulate from TRAFFIC (agent runs, other members),
+     * which no mutation of ours announces, so they cannot be `config`. But they
+     * are aggregates over days: a 5-second window buys nothing a 30-second one
+     * doesn't, and cost real requests — `refetchOnMount: true` at `volatile`
+     * refetched all five on every Customize -> Gateway open. `inventory` is
+     * both the honest description ("can also change from another member") and
+     * exactly their pre-migration 30s window.
+     *
+     * Budgets and keys ride the same tier at 30s against a pre-migration 15s.
+     * Safe: both are mutated only through this UI and both invalidate on
+     * success (`use-project-gateway.ts`), so staleTime only ever bounds an
+     * out-of-band change. `gatewayLogs` opts out entirely — it sets
+     * `refetchInterval: 10_000` and no contract, because a log tail genuinely
+     * is a tail.
+     */
+    gateway: 'inventory',
+    triggers: 'config',
+};
+//# sourceMappingURL=query-contracts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-contracts.js","sourceRoot":"","sources":["../../src/react/query-contracts.ts"],"names":[],"mappings":"AAoCA,MAAM,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE/B,MAAM,KAAK,GAAiD;IAC1D,0EAA0E;IAC1E,IAAI,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE;IAC7B,yEAAyE;IACzE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE;IAC7B,0DAA0D;IAC1D,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE;IAChC;;;;;;;;;;OAUG;IACH,QAAQ,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;CAC/B,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,IAAmB;IAC1C,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS;QAChC,MAAM,EAAE,OAAO;QACf,cAAc,EAAE,IAAa;KAC9B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,YAAY,EAAE,WAAW;IACzB,cAAc,EAAE,QAAQ;IACxB,aAAa,EAAE,QAAQ;IACvB,aAAa,EAAE,QAAQ;IACvB,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,WAAW;IACrB,QAAQ,EAAE,MAAM;IAChB,UAAU,EAAE,QAAQ;IACpB,eAAe,EAAE,QAAQ;IACzB,OAAO,EAAE,QAAQ;IACjB,IAAI,EAAE,WAAW;IACjB,cAAc,EAAE,WAAW;IAC3B,QAAQ,EAAE,QAAQ;IAClB,gBAAgB,EAAE,QAAQ;IAC1B,MAAM,EAAE,WAAW;IACnB,cAAc,EAAE,WAAW;IAC3B,cAAc,EAAE,WAAW;IAC3B,WAAW,EAAE,WAAW;IACxB,cAAc,EAAE,WAAW;IAC3B,KAAK,EAAE,QAAQ;IACf,UAAU,EAAE,QAAQ;IACpB,QAAQ,EAAE,QAAQ;IAClB;;;;;;;;;;;;;;;;;OAiBG;IACH,SAAS,EAAE,QAAQ;IACnB,gBAAgB,EAAE,QAAQ;IAC1B,SAAS,EAAE,QAAQ;IACnB,WAAW,EAAE,QAAQ;IACrB;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,QAAQ;CAC8B,CAAC"}