nanocodex 0.6.4 → 0.6.6

package/managed/internal.mjs

@@ -59,13 +59,14 @@ export function routeManagedRealtime(agent, voiceSessionId, operationId, input)
 }
 
 /** @internal Ends the canonical Realtime lifecycle on the selected durable Agent. */
-export function stopManagedRealtime(agent, voiceSessionId, operationId) {
+export function stopManagedRealtime(agent, voiceSessionId, operationId, transcript) {
   const { client, id } = managedAgent(agent);
   return client.json(`${agentPath(id)}/realtime/stop`, {
     method: "POST",
     body: JSON.stringify({
       voice_session_id: voiceSessionId,
       operation_id: operationId,
+      ...(transcript?.length ? { transcript } : {}),
     }),
   });
 }

package/node/Agent.d.mts

@@ -40,7 +40,7 @@ export declare namespace create {
     | {
       durability: DurabilityStore;
       durabilityId: string;
-      /** The root remains durable; clean subagent children are in-memory. */
+      /** The root remains durable; all subagent children are ephemeral. */
       tools?: ToolConfiguration<SubagentTool> | undefined;
     }
   );

package/node/Agent.mjs

@@ -35,8 +35,10 @@ export function create(options = {}) {
     thinking,
     reasoningMode,
     fastMode,
+    rawApiEvents,
     instructions,
     additionalInstructions,
+    beforeCompaction,
     sessionId,
     workspace,
     resume,
@@ -72,6 +74,7 @@ export function create(options = {}) {
       ? undefined
       : tempoMcp ? { ...tempoMcp, ...mcp } : mcp,
     onEvent: events.emit,
+    beforeCompaction,
     filesystem,
     tools: hostTools,
     toolMode,
@@ -114,6 +117,7 @@ export function create(options = {}) {
           websocketWarmup,
           subagents: subagentConfig,
           hostDefinitionId,
+          beforeCompaction: beforeCompaction !== undefined,
           ...config,
           durabilityHostId: durabilityOwner?.id,
         }));
@@ -133,12 +137,13 @@ export function create(options = {}) {
     adopt(raw) {
       host.retain();
       try {
-        durabilityOwner?.retain();
+        // Adopted child handles are ephemeral and do not own the root store.
+        if (raw.sessionId === stableSessionId) durabilityOwner?.retain();
         bindHostSession(host, raw.sessionId);
         events.addSource(raw);
       } catch (error) {
         events.removeSource(raw);
-        durabilityOwner?.release();
+        if (raw.sessionId === stableSessionId) durabilityOwner?.release();
         releaseHost(host);
         throw error;
       }
@@ -147,7 +152,7 @@ export function create(options = {}) {
       events.removeSource(raw);
       host.releaseSession(raw.sessionId);
       releaseHostSession(host, raw.sessionId);
-      durabilityOwner?.release();
+      if (raw.sessionId === stableSessionId) durabilityOwner?.release();
       releaseHost(host);
     },
     decorate: (agent) => agent.extend(agentActions()),
@@ -157,6 +162,7 @@ export function create(options = {}) {
     thinking,
     reasoningMode,
     fastMode,
+    rawApiEvents,
     instructions,
     additionalInstructions,
     sessionId: stableSessionId,

package/node/host.mjs

@@ -1,3 +1,4 @@
+import { createBeforeCompaction } from "../runtime/before-compaction.mjs";
 import { createResponsesHttp, responsesHttpHeaders } from "../runtime/responses-http.mjs";
 import { Console } from "node:console";
 import { createRequire } from "node:module";
@@ -23,6 +24,7 @@ const DEFAULT_MAX_FRAME_BYTES = 16 * 1024 * 1024;
 const MPP_CLIENT_PROTOCOL_ERROR_CLOSE_CODE = 3008;
 
 export function createNodeHost(options = {}) {
+  const preservation = createBeforeCompaction(options.beforeCompaction);
   const toolMode = options.toolMode ?? "code";
   if (toolMode !== "code" && toolMode !== "direct") {
     throw new TypeError("toolMode must be code or direct");
@@ -295,6 +297,7 @@ export function createNodeHost(options = {}) {
 
   function dispose() {
     if (disposal) return disposal;
+    preservation.dispose();
     http.dispose();
     disposal = Promise.resolve().then(() => settleCleanup([
       ...[...connections.keys()].map((handle) => () => close(handle)),
@@ -317,6 +320,8 @@ export function createNodeHost(options = {}) {
       if (references > 0) references -= 1;
       return references === 0 ? dispose() : Promise.resolve();
     },
+    beforeCompaction: preservation.preserve,
+    cancelBeforeCompaction: preservation.cancel,
     httpOpen: http.httpOpen,
     httpReady: http.httpReady,
     httpNext: http.httpNext,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nanocodex",
-  "version": "0.6.4",
+  "version": "0.6.6",
   "description": "Viem-style Node and browser bindings for the Nanocodex WASM agent",
   "type": "module",
   "sideEffects": [
@@ -51,10 +51,22 @@
       "types": "./cloudflare/index.d.mts",
       "import": "./cloudflare/index.mjs"
     },
+    "./cloudflare/workers-ai-responses": {
+      "types": "./cloudflare/workers-ai-responses.d.mts",
+      "import": "./cloudflare/workers-ai-responses.mjs"
+    },
+    "./cloudflare/durable-placement": {
+      "types": "./cloudflare/durable-placement.d.mts",
+      "import": "./cloudflare/durable-placement.mjs"
+    },
     "./cloudflare/managed-access": {
       "types": "./cloudflare/managed-access.d.mts",
       "import": "./cloudflare/managed-access.mjs"
     },
+    "./cloudflare/rpc": {
+      "types": "./cloudflare/rpc.d.mts",
+      "import": "./cloudflare/rpc.mjs"
+    },
     "./cloudflare/egress": {
       "types": "./cloudflare/egress.d.mts",
       "import": "./cloudflare/egress.mjs"
@@ -134,6 +146,26 @@
     "./tools/environment": {
       "types": "./tools/environment.d.mts",
       "import": "./tools/environment.mjs"
+    },
+    "./cloudflare/gateway-responses": {
+      "types": "./cloudflare/gateway-responses.d.mts",
+      "import": "./cloudflare/gateway-responses.mjs"
+    },
+    "./cloudflare/agent-settings": {
+      "types": "./cloudflare/agent-settings.d.mts",
+      "import": "./cloudflare/agent-settings.mjs"
+    },
+    "./cloudflare/managed-auth": {
+      "types": "./cloudflare/managed-auth.d.mts",
+      "import": "./cloudflare/managed-auth.mjs"
+    },
+    "./cloudflare/managed-live": {
+      "types": "./cloudflare/managed-live.d.mts",
+      "import": "./cloudflare/managed-live.mjs"
+    },
+    "./cloudflare/tracing": {
+      "types": "./cloudflare/tracing.d.mts",
+      "import": "./cloudflare/tracing.mjs"
     }
   },
   "files": [
@@ -171,7 +203,7 @@
     "isomorphic-git": "^1.41.5",
     "minisearch": "7.2.0",
     "mppx": "0.9.1",
-    "nanocodex-tools": "0.6.4",
+    "nanocodex-tools": "0.6.6",
     "ox": "1.6.2",
     "pako": "2.1.0",
     "pyodide": "314.0.5",

package/pkg-node/nanocodex.d.ts

@@ -140,7 +140,7 @@ export class BrowserVoice {
      */
     start(): Promise<void>;
     /**
-     * Flushes any final transcript tail and ends Codex's Realtime lifecycle.
+     * Retains final transcript history without a task and ends the Realtime lifecycle.
      *
      * # Errors
      *
@@ -220,6 +220,13 @@ export class ManagedBrowserVoice {
      * Rejects inactive sessions, invalid roles/text, or a full output queue.
      */
     appendText(role: string, text: string): string;
+    /**
+     * Binds the known managed call before admission or microphone setup begins.
+     *
+     * # Errors
+     * Rejects invalid session IDs or rebinding an active call.
+     */
+    bindSession(managed_session_id: string): void;
     /**
      * Encodes the managed same-origin call request after the browser creates its SDP offer.
      *
@@ -331,9 +338,9 @@ export class ManagedBrowserVoice {
      *
      * Rejects malformed `AgentSessionContext` JSON.
      */
-    start(context_json: string): void;
+    start(context_json: string): string;
     /**
-     * Stops the protocol and returns final transcript delegation plus close effects.
+     * Stops the protocol and returns transcript history plus close effects, without a delegation.
      *
      * # Errors
      *
@@ -367,6 +374,14 @@ export class Nanocodex {
      * Rejects voices outside Codex's ChatGPT V3 catalog.
      */
     browserVoice(voice: string): BrowserVoice;
+    /**
+     * Exports the exact latest committed model boundary without mutating this agent.
+     *
+     * # Errors
+     *
+     * Rejects before the first safe boundary or after the driver stops.
+     */
+    checkpoint(): Promise<string>;
     /**
      * Closes one canonical task-tree child and its descendants.
      */
@@ -463,16 +478,6 @@ export class Nanocodex {
      * Rejects malformed transcript JSON.
      */
     realtimeTailDelegation(transcript: string): string | undefined;
-    /**
-     * Restores persisted logical children after the JavaScript owner acquires
-     * its durability generation and activates the replacement host.
-     *
-     * # Errors
-     *
-     * Rejects malformed descriptors, disabled subagents, duplicate restoration,
-     * or an invalid persisted topology.
-     */
-    restoreSubagents(descriptors_json: string, host_contexts_json?: string | null): Promise<void>;
     /**
      * Atomically steers the active turn or starts a new independently awaitable turn.
      *
@@ -665,12 +670,11 @@ export class TurnResult {
  */
 export function applyBrowserPatch(patch: string, session_id: string): Promise<string>;
 
-/**
- * Returns the shared bounded first-prompt retrieval plan for a managed host.
- */
-export function managedBootstrapPlan(input: string): string;
-
 /**
  * Prunes old replay receipts before the full Agent runtime is constructed.
+ * Capability marker checked against the actual bundled module before deployment.
+ * Older kernels reject the native child route emitted by the current host.
  */
+export function nativeSpawnContractVersion(): number;
+
 export function pruneDurableReceipts(durability_host_id: string, durability_id: string, terminal_receipt_limit: number): Promise<void>;