@kortix/sdk 0.13.19 → 0.13.20

package/dist/react/use-project-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-project-sessions.d.ts","sourceRoot":"","sources":["../../src/react/use-project-sessions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAEL,KAAK,0BAA0B,EAC/B,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACxB,MAAM,uCAAuC,CAAC;AAI/C;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,GAAG,SAAS,CAErF;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE;IAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAAC,UAAU,EAAE,OAAO,EAAE,CAAA;CAAE,GAAG,SAAS,GACvE,cAAc,EAAE,CAYlB;AAED,MAAM,WAAW,yBACf,SAAQ,IAAI,CAAC,0BAA0B,EAAE,OAAO,GAAG,OAAO,CAAC;IAC3D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,CAAC,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,MAAM,GAAG,KAAK,CAAC,CAAC;IACpF,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB;IAwBrF;;;;;;;OAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAPH;;;;;;;OAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAPH;;;;;;;OAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAPH;;;;;;;OAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAPH;;;;;;;OAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAPH;;;;;;;OAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGN"}

package/dist/react/use-project-sessions.js

@@ -0,0 +1,94 @@
+/**
+ * The project session list, paged.
+ *
+ * `GET /projects/:id/sessions` used to answer with every session row the viewer
+ * could see. On a project that had accumulated 12,617 sessions that is a
+ * multi-megabyte body — and the sidebar re-fetches this list every 5 seconds
+ * for as long as ANY one row sits in `queued`/`branching`/`provisioning`, which
+ * over twelve thousand rows is effectively always. The browser paid three times
+ * per tick: parsing the body, letting react-query structurally share 12k
+ * objects, then re-sorting and re-grouping them into sections.
+ *
+ * The list is now a bounded keyset page (`listProjectSessionsPage`). This module
+ * holds the two pure pieces of the `useInfiniteQuery` wiring so they can be
+ * tested without mounting react-query, plus the hook itself.
+ */
+import { useInfiniteQuery } from '@tanstack/react-query';
+import { listProjectSessionsPage, } from '../core/rest/projects-client/sessions.js';
+import { qk } from './query-keys.js';
+import { contract } from './query-contracts.js';
+/**
+ * `getNextPageParam`. Returns `undefined` — not `null` — at the end of the
+ * list: `undefined` is what react-query reads as "no more pages", and it is
+ * what makes `hasNextPage` go false. Handing back `null` leaves `hasNextPage`
+ * true and a Load-more button that re-fetches page one forever.
+ */
+export function projectSessionsPageParam(page) {
+    return page.next_cursor ?? undefined;
+}
+/**
+ * Flatten the fetched pages into the flat array every consumer of this list
+ * already renders.
+ *
+ * De-duplicates by `session_id`, keeping first occurrence. A session prompted
+ * between two page fetches moves to the top of the `updated_at DESC` order, so
+ * a row already served on page 1 legitimately reappears on page 2 — keyset
+ * paging makes that a shifted window, not a bug to fix server-side. Rendering
+ * it twice would hand React two children with the same key.
+ */
+export function flattenProjectSessionPages(data) {
+    if (!data)
+        return [];
+    const seen = new Set();
+    const flat = [];
+    for (const page of data.pages) {
+        for (const session of page.items) {
+            if (seen.has(session.session_id))
+                continue;
+            seen.add(session.session_id);
+            flat.push(session);
+        }
+    }
+    return flat;
+}
+/**
+ * One project's sessions, newest activity first, fetched a page at a time.
+ *
+ * Returns the flat `sessions` array plus the paging controls, so a list that
+ * previously read `data ?? []` changes only where the array comes from.
+ */
+export function useProjectSessions(projectId, options) {
+    const scope = options?.scope ?? 'visible';
+    const query = useInfiniteQuery({
+        queryKey: qk.project.sessionsPaged(projectId, scope),
+        initialPageParam: null,
+        queryFn: ({ pageParam }) => listProjectSessionsPage(projectId, {
+            scope,
+            limit: options?.limit,
+            cursor: pageParam,
+        }),
+        getNextPageParam: projectSessionsPageParam,
+        enabled: options?.enabled ?? true,
+        refetchOnWindowFocus: options?.refetchOnWindowFocus,
+        refetchInterval: (query) => {
+            const interval = options?.refetchInterval;
+            if (typeof interval !== 'function')
+                return interval ?? false;
+            return interval(flattenProjectSessionPages(query.state.data));
+        },
+        ...contract('inventory'),
+    });
+    return {
+        ...query,
+        /**
+         * Every page loaded so far, flattened and de-duplicated.
+         *
+         * A poll refetches EVERY loaded page, so a viewer who has pressed
+         * "Load more" several times pays for each of them on every tick. That is
+         * the intended trade — it is bounded by what the viewer actually asked to
+         * see, where the old behavior was bounded by nothing.
+         */
+        sessions: flattenProjectSessionPages(query.data),
+    };
+}
+//# sourceMappingURL=use-project-sessions.js.map

package/dist/react/use-project-sessions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-project-sessions.js","sourceRoot":"","sources":["../../src/react/use-project-sessions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EACL,uBAAuB,GAIxB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAwB;IAC/D,OAAO,IAAI,CAAC,WAAW,IAAI,SAAS,CAAC;AACvC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,0BAA0B,CACxC,IAAwE;IAExE,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,IAAI,GAAqB,EAAE,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACjC,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC;gBAAE,SAAS;YAC3C,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC7B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAUD;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB,EAAE,OAAmC;IACvF,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,SAAS,CAAC;IAC1C,MAAM,KAAK,GAAG,gBAAgB,CAAC;QAC7B,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,SAAS,EAAE,KAAK,CAAC;QACpD,gBAAgB,EAAE,IAAqB;QACvC,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CACzB,uBAAuB,CAAC,SAAS,EAAE;YACjC,KAAK;YACL,KAAK,EAAE,OAAO,EAAE,KAAK;YACrB,MAAM,EAAE,SAAS;SAClB,CAAC;QACJ,gBAAgB,EAAE,wBAAwB;QAC1C,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI;QACjC,oBAAoB,EAAE,OAAO,EAAE,oBAAoB;QACnD,eAAe,EAAE,CAAC,KAAK,EAAE,EAAE;YACzB,MAAM,QAAQ,GAAG,OAAO,EAAE,eAAe,CAAC;YAC1C,IAAI,OAAO,QAAQ,KAAK,UAAU;gBAAE,OAAO,QAAQ,IAAI,KAAK,CAAC;YAC7D,OAAO,QAAQ,CAAC,0BAA0B,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAChE,CAAC;QACD,GAAG,QAAQ,CAAC,WAAW,CAAC;KACzB,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,KAAK;QACR;;;;;;;WAOG;QACH,QAAQ,EAAE,0BAA0B,CAAC,KAAK,CAAC,IAAI,CAAC;KACjD,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kortix/sdk",
-  "version": "0.13.19",
+  "version": "0.13.20",
   "description": "Official Kortix frontend TypeScript SDK — one typed client for the Kortix agent platform. Unifies project/session lifecycle and live agent streaming behind a single ergonomic Session handle, so web, mobile, and white-label apps never touch the raw HTTP API or OpenCode semantics.",
   "type": "module",
   "license": "Elastic-2.0",
@@ -20,7 +20,7 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@kortix/llm-catalog": "0.13.19",
+    "@kortix/llm-catalog": "0.13.20",
     "@opencode-ai/sdk": "1.18.23",
     "zustand": "^5.0.3"
   },