@north-light/crouter-api 0.3.200 → 0.3.202

package/dist/api/client.d.ts

@@ -1,6 +1,6 @@
 import type { DaemonRestartDTO, HealthDTO, StatusDTO } from './dto/health.js';
 import type { BashJobStatusDTO, BashJobStopResultDTO } from './dto/bash-jobs.js';
-import type { ArtifactListDTO, ArtifactsQuery, ContextListDTO, CreateNodeRequest, ListNodesQuery, NodeDetailDTO, NodeSessionDTO, NodeSnapshotDTO, NodeSummaryDTO, TranscriptDTO, TranscriptQuery } from './dto/nodes.js';
+import type { ArtifactListDTO, ArtifactsQuery, ContextListDTO, CreateNodeRequest, ListNodesQuery, NodeDetailDTO, NodeMessagesPageDTO, NodeMessagesQuery, 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';
@@ -143,6 +143,7 @@ export declare class CrtrClient {
     getReports(id: string, q?: ReportsQuery): Promise<ReportDTO[]>;
     getTranscript(id: string, q?: TranscriptQuery): Promise<TranscriptDTO>;
     getSnapshot(id: string): Promise<NodeSnapshotDTO>;
+    getNodeMessages(id: string, q?: NodeMessagesQuery): Promise<NodeMessagesPageDTO>;
     /** 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>;

package/dist/api/client.js

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

package/dist/api/dto/inbox.d.ts

@@ -30,7 +30,7 @@ export interface PageTicketSummaryDTO {
     source: TicketSourceDTO;
     slot_kinds: string[];
     awaits_response: boolean;
-    state?: 'pending' | 'resolved' | 'canceled' | 'passive';
+    state: 'pending' | 'resolved' | 'canceled' | 'passive';
     /** Present only on resolved history entries; the stored one-line answer digest. */
     answer_digest?: string;
 }

package/dist/api/dto/nodes.d.ts

@@ -175,6 +175,22 @@ export interface NodeSnapshotDTO {
     }[];
     captured_at: IsoTime;
 }
+/** `GET /v1/nodes/{id}/messages` query. `cursor` walks backward from the
+ * newest messages; each returned page remains chronological. */
+export interface NodeMessagesQuery {
+    cursor?: Cursor;
+    limit?: number;
+}
+/** `GET /v1/nodes/{id}/messages` — a backward-paged window over the node's
+ * cycle-flattened visible history. */
+export interface NodeMessagesPageDTO {
+    node_id: NodeIdDTO;
+    /** pi AgentMessage[] JSON, chronological ascending within this page. */
+    messages: unknown[];
+    /** Opaque cursor toward older messages; null at the start of the session. */
+    next_cursor: Cursor | null;
+    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

package/package.json

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