@north-light/crouter-api 0.3.217 → 0.3.219

package/dist/api/client.d.ts

@@ -78,6 +78,8 @@ export declare class CrtrClient {
      *  settled result. */
     restartDaemon(): Promise<DaemonRestartDTO>;
     createNode(req: CreateNodeRequest): Promise<NodeDetailDTO>;
+    /** List canvas nodes with composable row filters. `include: 'activity'` adds
+     * latest/canonical reports and pending-human counts in the same response. */
     listNodes(q?: ListNodesQuery): Promise<NodeSummaryDTO[]>;
     getNode(id: string): Promise<NodeDetailDTO>;
     listBashJobs(id: string): Promise<BashJobStatusDTO[]>;
@@ -197,8 +199,9 @@ export declare class CrtrClient {
     listHumanInbox(): Promise<InboxListDTO>;
     /** Read one page ticket by its opaque ticket id (pending, resolved, or canceled). */
     getHumanInboxPage(ticketId: InboxTicketIdDTO): Promise<InboxPageDTO>;
-    /** All page tickets raised by one node, oldest first (pending, resolved, or canceled). */
-    getInboxHistory(nodeId: string): Promise<InboxPageHistoryDTO>;
+    /** All page tickets, oldest first (pending, resolved, or canceled) —
+     *  home-wide, or narrowed to one raising node when `nodeId` is given. */
+    getInboxHistory(nodeId?: string): Promise<InboxPageHistoryDTO>;
     /** Submit responses for a page ticket. Single-assignment server-side: a competing
      *  resolution races to `ticket_already_resolved`. */
     respondHumanInboxPage(ticketId: InboxTicketIdDTO, request: RespondInboxPageRequest): Promise<PageTicketResultDTO>;

package/dist/api/client.js

@@ -92,6 +92,8 @@ export class CrtrClient {
     createNode(req) {
         return this.request('POST', routes.nodes(), req);
     }
+    /** List canvas nodes with composable row filters. `include: 'activity'` adds
+     * latest/canonical reports and pending-human counts in the same response. */
     listNodes(q) {
         return this.request('GET', withQuery(routes.nodes(), q));
     }
@@ -386,8 +388,12 @@ export class CrtrClient {
     getHumanInboxPage(ticketId) {
         return this.request('GET', routes.humanInboxTicket(this.ticketId(ticketId)));
     }
-    /** All page tickets raised by one node, oldest first (pending, resolved, or canceled). */
+    /** All page tickets, oldest first (pending, resolved, or canceled) —
+     *  home-wide, or narrowed to one raising node when `nodeId` is given. */
     getInboxHistory(nodeId) {
+        if (nodeId === undefined) {
+            return this.request('GET', routes.humanInbox() + '/history');
+        }
         if (typeof nodeId !== 'string' || nodeId === '') {
             throw new TypeError(`invalid node id: ${JSON.stringify(nodeId)}`);
         }

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

@@ -147,6 +147,10 @@ export interface SnapshotNodeDTO {
     lifecycle?: string;
     status: NodeStatusDTO;
     cwd: string;
+    /** The profile this node runs under; null for a historical no-profile row.
+     *  Carried here because it is the only field that says WHOSE work a node is —
+     *  a snapshot consumer grouping nodes by agent has nothing else to key on. */
+    profile_id: string | null;
     parent: NodeIdDTO | null;
     created: IsoTime;
     host_kind: string;
@@ -161,6 +165,11 @@ export interface SnapshotNodeDTO {
      *  as a loose object to keep this DTO free of a `core` type import. */
     hanging: Record<string, unknown> | null;
     viewed: boolean;
+    /** Basename of the node's final report, or null when it never pushed one.
+     *  Presence — not `status === 'done'` — is what distinguishes finished work
+     *  from clean parking. */
+    final_report: string | null;
+    finalized_at: IsoTime | null;
 }
 /** `GET /v1/canvas/snapshot` result — the machine-readable browser canvas
  *  roster (`crtr canvas snapshot`). Distinct from the per-node `NodeSnapshotDTO`

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

@@ -1,4 +1,5 @@
 import type { Cursor, ExitIntentDTO, IsoTime, LifecycleDTO, ModeDTO, NodeIdDTO, NodeStatusDTO } from './common.js';
+import type { ReportDTO } from './reports.js';
 /** `GET /v1/nodes/{id}/subject` — the node-config subject substrate gate
  *  predicates evaluate against. Mirrors `NodeConfigSubject`; this narrow
  *  endpoint exists so a CLI process (the `memory read` leaf) can gate-check
@@ -79,8 +80,19 @@ export interface NodeSummaryDTO {
     window: string | null;
     tmux_session: string | null;
     pane: string | null;
+    /** Basename of the canonical final report, or null when this node has not finalized. */
     final_report: string | null;
     finalized_at: IsoTime | null;
+    /** Present only when requested with `include=activity`. */
+    activity?: NodeActivityDTO;
+}
+/** Optional per-node activity payload for a list response. Reports are the
+ * stored push entries, newest first; `final_report` follows the row's canonical
+ * final-report basename rather than merely selecting the newest final-tier file. */
+export interface NodeActivityDTO {
+    latest_report: ReportDTO | null;
+    final_report: ReportDTO | null;
+    pending_human_count: number;
 }
 /** The spine + subscription edges of a node (absorbs `managers`/`paths` reads). */
 export interface NodeEdgesDTO {
@@ -166,15 +178,29 @@ export interface NodeDetailDTO extends NodeSummaryDTO {
     roadmap_path?: string;
     goal_path?: string;
 }
-/** `GET /v1/nodes` query filters. */
+/** `GET /v1/nodes` optional payloads. */
+export type NodeListInclude = 'activity';
+/** `GET /v1/nodes` query filters. Filters compose; `parent` selects direct
+ * children while `under` selects a whole subtree. */
 export interface ListNodesQuery {
     status?: NodeStatusDTO;
+    lifecycle?: LifecycleDTO;
     kind?: string;
     mode?: ModeDTO;
+    /** Exact profile id. */
+    profile_id?: string;
+    /** Profile-id prefix, for callers that own a namespaced profile family. */
+    profile_prefix?: string;
+    /** Restrict to direct children of this node. Mutually exclusive with `top_level`. */
+    parent?: NodeIdDTO;
+    /** Restrict to nodes without a parent. */
+    top_level?: boolean;
     /** Restrict to the subtree under this node. */
     under?: NodeIdDTO;
     /** Only nodes with a dangling/hanging manager edge. */
     hanging?: boolean;
+    /** Opt into richer per-node payloads that require filesystem reads. */
+    include?: NodeListInclude;
 }
 /** `GET /v1/nodes/{id}/snapshot` — the node's reconstructed broker snapshot
  *  (`readNodeSnapshot`): the message log, aggregate stats, and current engine

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@north-light/crouter-api",
-  "version": "0.3.217",
+  "version": "0.3.219",
   "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",