@granular-software/sdk 0.4.50 → 0.4.52

package/README.md

@@ -193,6 +193,36 @@ const result = await job.result;
 
 Effects must be declared ahead of time in the ontology version manifest with `withEffect`. Live registration only makes already-declared effects available at runtime.
 
+### Agent-selected result columns
+
+When an agent needs to show records with fields or calculations chosen for the
+current question, it can project a result table in the job runtime:
+
+```typescript
+import { relativeTime, showAgentResponse, table } from "@granular/agent";
+
+showAgentResponse({
+  reply: "Two recent orders need attention.",
+  show: table(
+    recentOrders,
+    [
+      { label: "Order", value: (record) => record.label },
+      {
+        label: "Status change",
+        value: (record) => `${record.before_status} → ${record.after_status}`,
+      },
+      { label: "Updated", value: (record) => relativeTime(record.timestamp) },
+    ],
+    { label: "Latest order changes" },
+  ),
+});
+```
+
+The callbacks run only inside the sandbox job. Granular persists the resolved
+column labels, primitive cells, typed dates, relative times, and grounded row
+references—not executable functions—so the conversation remains durable and
+safe to reopen in another browser.
+
 ## Core Flow
 
 ```
@@ -698,6 +728,29 @@ Registers ontology-scoped live handlers for effects declared in the ontology man
 
 Open a live runtime session for the environment, then submit code to the sandbox. The code imports typed classes from Harness v3 modules such as `@granular/domain/<Class>`.
 
+Pass `sessionScope` when one product has more than one independent conversation
+surface. The scope is persisted with the session and can be reused as a hard
+history filter:
+
+```ts
+const session = await env.sessions.create({
+  clientId: crypto.randomUUID(),
+  sessionScope: "spendish-order-ops",
+});
+
+const firstPage = await env.sessions.list({
+  status: "all",
+  sessionScope: "spendish-order-ops",
+  limit: 25,
+  offset: 0,
+});
+```
+
+Session history is always bounded (100 rows by default, 500 maximum). Increment
+`offset` to fetch another page. For tenant-level tooling,
+`granular.listSessions()` also accepts `environmentId`, `sandboxId`, and
+`subjectId`; at least one ownership filter is required.
+
 ### Live Session State And Durable Collections
 
 `session.document` and `session.getHeap()` are local, fast views of the live runtime state synced over the WebSocket.

package/dist/agent-evals.d.mts

@@ -1,5 +1,5 @@
-import { a as EnvironmentSession, G as Granular } from './client-DaYFTHG8.mjs';
-import { G as GranularSpendContext, h as OpenAITokenSpend, P as Prompt, bL as RecordObjectOptions, cz as ManifestContent, c as SessionHeapSnapshot, T as ToolWithHandler, J as ConnectOptions, ad as CreateEnvironmentData, y as GranularOptions } from './spend-RpJikX9w.mjs';
+import { a as EnvironmentSession, G as Granular } from './client-B2OyGOHE.mjs';
+import { G as GranularSpendContext, h as OpenAITokenSpend, P as Prompt, bW as RecordObjectOptions, cL as ManifestContent, c as SessionHeapSnapshot, T as ToolWithHandler, K as ConnectOptions, ag as CreateEnvironmentData, y as GranularOptions } from './spend-DpRRCrAr.mjs';
 import { GranularAgentToolInfo, GeneratedJobCodeIssue, BuildGranularAgentSystemPromptInput, HarnessRenderedPrompt, HarnessRenderedContinuation, HarnessControllerBudgets } from './agent-harness.mjs';
 import '@automerge/automerge';
 import '@automerge/automerge/slim';

package/dist/agent-evals.d.ts

@@ -1,5 +1,5 @@
-import { a as EnvironmentSession, G as Granular } from './client-BbI7ThzU.js';
-import { G as GranularSpendContext, h as OpenAITokenSpend, P as Prompt, bL as RecordObjectOptions, cz as ManifestContent, c as SessionHeapSnapshot, T as ToolWithHandler, J as ConnectOptions, ad as CreateEnvironmentData, y as GranularOptions } from './spend-RpJikX9w.js';
+import { a as EnvironmentSession, G as Granular } from './client-BMfjRJTs.js';
+import { G as GranularSpendContext, h as OpenAITokenSpend, P as Prompt, bW as RecordObjectOptions, cL as ManifestContent, c as SessionHeapSnapshot, T as ToolWithHandler, K as ConnectOptions, ag as CreateEnvironmentData, y as GranularOptions } from './spend-DpRRCrAr.js';
 import { GranularAgentToolInfo, GeneratedJobCodeIssue, BuildGranularAgentSystemPromptInput, HarnessRenderedPrompt, HarnessRenderedContinuation, HarnessControllerBudgets } from './agent-harness.js';
 import '@automerge/automerge';
 import '@automerge/automerge/slim';