@north-light/crouter-api 0.3.156 → 0.3.158

package/README.md

@@ -3,7 +3,7 @@
 The typed contract for **crtrd**'s `/v1` HTTP API — DTOs, route builders, the
 error contract, and the `CrtrClient` transport. This is the client-side surface
 external consumers (e.g. Northlight Core) use to talk to a crtrd instance
-without depending on the full `@crouton-kit/crouter` runtime.
+without depending on the full `@north-light/crouter` runtime.
 
 Zero runtime dependencies: the built package is Node built-ins (`node:http`,
 `node:https`, `node:os`, `node:path`) plus its own modules only. No install

package/dist/client.d.ts

@@ -1,5 +1,5 @@
 import type { DaemonRestartDTO, HealthDTO, StatusDTO } from './dto/health.js';
-import type { ArtifactListDTO, ArtifactsQuery, ContextListDTO, CreateNodeRequest, ListNodesQuery, NodeDetailDTO, NodeSnapshotDTO, NodeSummaryDTO, TranscriptDTO, TranscriptQuery } from './dto/nodes.js';
+import type { ArtifactListDTO, ArtifactsQuery, ContextListDTO, CreateNodeRequest, ListNodesQuery, NodeDetailDTO, NodeSessionDTO, NodeSnapshotDTO, NodeSummaryDTO, TranscriptDTO, TranscriptQuery } from './dto/nodes.js';
 import type { InterruptResultDTO, MessageResultDTO, SendMessageRequest } from './dto/messages.js';
 import type { PushReportRequest, PushReportResultDTO, ReportDTO, ReportsQuery } from './dto/reports.js';
 import type { CloseRequest, CloseResultDTO, PromoteRequest, RelaunchRootResultDTO, ReviveRequest, ReviveResultDTO, WaitRequest, YieldRequest } from './dto/lifecycle.js';
@@ -125,6 +125,9 @@ export declare class CrtrClient {
     getReports(id: string, q?: ReportsQuery): Promise<ReportDTO[]>;
     getTranscript(id: string, q?: TranscriptQuery): Promise<TranscriptDTO>;
     getSnapshot(id: string): Promise<NodeSnapshotDTO>;
+    /** The node's conversation exactly as it ran — raw `.jsonl` bytes plus the
+     *  assembled system prompt. For exports; `getSnapshot` is for renderers. */
+    getSession(id: string): Promise<NodeSessionDTO>;
     getArtifacts(id: string, q?: ArtifactsQuery): Promise<ArtifactListDTO>;
     getContext(id: string): Promise<ContextListDTO>;
     /** Read an absolute host path as UTF-8 (capped, `truncated` when clipped) for

package/dist/client.js

@@ -219,6 +219,11 @@ export class CrtrClient {
     getSnapshot(id) {
         return this.request('GET', routes.nodeSnapshot(this.nodePath(id)));
     }
+    /** The node's conversation exactly as it ran — raw `.jsonl` bytes plus the
+     *  assembled system prompt. For exports; `getSnapshot` is for renderers. */
+    getSession(id) {
+        return this.request('GET', routes.nodeSession(this.nodePath(id)));
+    }
     getArtifacts(id, q) {
         return this.request('GET', withQuery(routes.nodeArtifacts(this.nodePath(id)), q));
     }

package/dist/dto/broker.d.ts

@@ -31,7 +31,7 @@ export interface BrokerWelcomeFrame<M = unknown> {
 }
 /**
  * The broker-control frames a relay consumer reads: `welcome` (catch-up snapshot)
- * and `error`. The broker interleaves others (display_*, control_changed, ack, …)
+ * and `error`. The broker interleaves others (display_*, ack, …)
  * under non-colliding `type` discriminants; a relay mapper drops those through its
  * `default` arm untyped, so they are not enumerated here.
  */

package/dist/dto/nodes.d.ts

@@ -145,6 +145,21 @@ export interface NodeSnapshotDTO {
     }[];
     captured_at: IsoTime;
 }
+/** `GET /v1/nodes/{id}/session` — the node's conversation exactly as it ran:
+ *  the raw session `.jsonl` bytes plus the assembled system prompt. Unlike
+ *  `NodeSnapshotDTO` nothing is reconstructed or flattened, so every
+ *  session-tree entry, cycle, branch, and custom message role survives. This is
+ *  what an export/download wants; `/snapshot` is what a renderer wants. */
+export interface NodeSessionDTO {
+    node_id: NodeIdDTO;
+    /** Absolute path (inside the node's host) of the file the bytes came from. */
+    session_file: string;
+    /** Verbatim `.jsonl` contents. */
+    session_jsonl: string;
+    /** Assembled system prompt as last captured, or `null` if never written. */
+    system_prompt: string | null;
+    captured_at: IsoTime;
+}
 /** `GET /v1/nodes/{id}/transcript` query. */
 export interface TranscriptQuery {
     limit?: number;

package/dist/index.js

@@ -1,4 +1,4 @@
-// `@crouton-kit/crouter/api` — the single source of truth for crtrd's API DTOs,
+// `@north-light/crouter/api` — the single source of truth for crtrd's API DTOs,
 // route constants, error contract, and the typed `CrtrClient`. Dependency-light
 // by design (spec §3.1): Node built-ins + `src/api/*` only.
 export { CrtrClient } from './client.js';

package/dist/routes.d.ts

@@ -9,6 +9,7 @@ export declare const routes: {
     readonly reviveAll: () => string;
     readonly node: (id: string) => string;
     readonly nodeSnapshot: (id: string) => string;
+    readonly nodeSession: (id: string) => string;
     readonly nodeTranscript: (id: string) => string;
     readonly nodeContext: (id: string) => string;
     readonly nodeArtifacts: (id: string) => string;

package/dist/routes.js

@@ -25,6 +25,7 @@ export const routes = {
     node: (id) => `${V}/nodes/${id}`,
     // Node reads
     nodeSnapshot: (id) => `${V}/nodes/${id}/snapshot`,
+    nodeSession: (id) => `${V}/nodes/${id}/session`,
     nodeTranscript: (id) => `${V}/nodes/${id}/transcript`,
     nodeContext: (id) => `${V}/nodes/${id}/context`,
     nodeArtifacts: (id) => `${V}/nodes/${id}/artifacts`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/crouter-api",
-  "version": "0.3.156",
+  "version": "0.3.158",
   "description": "Typed crtrd /v1 API contract — DTOs, route builders, the error contract, and the CrtrClient. Zero runtime dependencies.",
   "type": "module",
   "main": "./dist/index.js",