@granular-software/sdk 0.4.31 → 0.4.33

package/README.md

@@ -594,6 +594,27 @@ 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 `./sandbox-tools`.
 
+### Live Session State And Durable Collections
+
+`session.document` and `session.getHeap()` are local, fast views of the live runtime state synced over the WebSocket.
+
+Older conversation history, timeline events, completed jobs, and saved heap artifacts are exposed through named durable collections:
+
+```ts
+const session = await env.sessions.create();
+
+const liveHeap = session.getHeap();
+const messages = await session.messages.list({ limit: 100 });
+const timeline = await session.timeline.list({ limit: 100 });
+const jobs = await session.jobs.list({ status: "all", limit: 100 });
+const job = await session.jobs.get("job_123");
+const entry = await session.heap.entries.get("customer_123");
+const savedList = await session.heap.lists.get("recent_customers");
+const transcript = await session.transcript.list({ limit: 100 });
+```
+
+Use the live state for current working context, and the collection APIs when you need durable history or artifacts that may have been moved out of the live document.
+
 ### `session.getDomainDocumentation()`
 
 Get auto-generated TypeScript class declarations. Pass this to LLMs to help them write correct code.

package/dist/agent-evals.d.mts

@@ -1,4 +1,4 @@
-import { P as Prompt, f as EnvironmentSession, c as SessionHeapSnapshot, b8 as ManifestContent, aG as RecordObjectOptions, T as ToolWithHandler, G as Granular, C as ConnectOptions, J as CreateEnvironmentData, k as GranularOptions } from './client-CTH1hfwe.mjs';
+import { P as Prompt, f as EnvironmentSession, c as SessionHeapSnapshot, bf as ManifestContent, aN as RecordObjectOptions, T as ToolWithHandler, G as Granular, C as ConnectOptions, J as CreateEnvironmentData, k as GranularOptions } from './client-DTvI5MUG.mjs';
 import { GeneratedJobCodeIssue, HarnessControllerBudgets } from './agent-harness.mjs';
 import '@automerge/automerge';
 import '@automerge/automerge/slim';

package/dist/agent-evals.d.ts

@@ -1,4 +1,4 @@
-import { P as Prompt, f as EnvironmentSession, c as SessionHeapSnapshot, b8 as ManifestContent, aG as RecordObjectOptions, T as ToolWithHandler, G as Granular, C as ConnectOptions, J as CreateEnvironmentData, k as GranularOptions } from './client-CTH1hfwe.js';
+import { P as Prompt, f as EnvironmentSession, c as SessionHeapSnapshot, bf as ManifestContent, aN as RecordObjectOptions, T as ToolWithHandler, G as Granular, C as ConnectOptions, J as CreateEnvironmentData, k as GranularOptions } from './client-DTvI5MUG.js';
 import { GeneratedJobCodeIssue, HarnessControllerBudgets } from './agent-harness.js';
 import '@automerge/automerge';
 import '@automerge/automerge/slim';