@north-light/crouter-api 0.3.322 → 0.3.323

package/dist/api/client.d.ts

@@ -19,9 +19,9 @@ import type { CancelReviewRequest, CreateReviewRequest, ListReviewsQuery, Review
 import type { CreateReviewCommentRequest, EditReviewCommentRequest, ListReviewCommentsQuery, ReadReviewCommentEventsQuery, ReviewCommentActionRequest, ReviewCommentDetailDTO, ReviewCommentEventsDTO, ReviewCommentForkDTO, ReviewCommentListDTO, ReviewCommentMutationDTO, ReviewCommentRangeBatchRequest, ReviewCommentRangeBatchResultDTO } from './dto/review-comments.js';
 import type { CancelInboxTicketRequest, CanceledTicketResultDTO, InboxListDTO, InboxPageDTO, InboxPageHistoryDTO, InboxPageResponseDTO, InboxTicketIdDTO, PageFeedbackResolutionDTO, PageResponsesDTO, PageTicketResultDTO, RespondInboxPageRequest } from './dto/inbox.js';
 import type { CreateHumanRequestDTO, CreateHumanRequestRequest, HumanRequestDTO, HumanRequestIdDTO, ReplaceHumanRequestRequest, RespondHumanRequestRequest, SettleHumanRequestRequest } from './dto/human-requests.js';
-import type { AttentionCountsDTO, AttentionDTO, DashboardDTO, DashboardQuery, HistoryGrepQuery, HistoryGrepResultDTO, HistoryReadQuery, HistoryStatsQuery, HistoryStatsResultDTO, HistoryReadResultDTO, HistorySearchQuery, HistorySearchResultDTO, PruneRequest, PruneResultDTO, RosterDTO, SnapshotDTO } from './dto/canvas.js';
+import type { AttentionCountsDTO, AttentionDTO, DashboardDTO, DashboardQuery, HistoryGrepQuery, HistoryGrepResultDTO, HistoryReadQuery, HistoryStatsQuery, HistoryStatsResultDTO, HistoryReadResultDTO, HistorySearchQuery, HistorySearchResultDTO, GraphDTO, PruneRequest, PruneResultDTO, RosterDTO, SnapshotDTO } from './dto/canvas.js';
 import type { AbandonWorktreeRequest, AbandonWorktreeResultDTO, CloseWorktreeResultDTO, QuarantinedWorktreeDTO } from './dto/worktree.js';
-import type { BrokerExtensionStateDTO, BrokerExecutionRequest, BrokerGeneratedNameRequest, BrokerGeneratedNameResultDTO, BrokerModelCommitRequest, BrokerModelCommitResultDTO, BrokerParkActivityResultDTO, BrokerParkCompleteRequest, BrokerPersonaAckRequest, BrokerPersonaAckResultDTO, BrokerSessionBoundRequest, BrokerSessionBoundResultDTO, BrokerSettleDirective, BrokerSettleRequest } from './dto/broker-ops.js';
+import type { BrokerExtensionStateDTO, BrokerExecutionRequest, BrokerGeneratedNameRequest, BrokerGeneratedNameResultDTO, BrokerModelCommitRequest, BrokerModelCommitResultDTO, BrokerParkActivityResultDTO, BrokerParkCompleteRequest, BrokerPersonaAckRequest, BrokerPersonaAckResultDTO, BrokerSessionBoundRequest, BrokerSessionBoundResultDTO, BrokerSettleDirective, BrokerSettleRequest, BrokerTelemetryRequest } from './dto/broker-ops.js';
 import type { AcknowledgeMailRequest, AcknowledgeMailResultDTO, ClaimMailRequest, ClaimMailResultDTO } from './dto/mail.js';
 import type { BrokerFaultInputDTO, BrokerFaultRequest, BrokerFaultResultDTO, BrokerProviderRetryRequest, BrokerProviderRetryResultDTO, BrokerTurnRequest, BrokerTurnResultDTO, NodeFaultClearResultDTO, RecoveryStateDTO } from './dto/recovery.js';
 export interface CrtrClientOptions {
@@ -129,6 +129,7 @@ export declare class CrtrClient {
     settleBroker(id: string, req: BrokerSettleRequest): Promise<BrokerSettleDirective>;
     completeBrokerPark(id: string, req: BrokerParkCompleteRequest): Promise<BrokerSettleDirective>;
     recordBrokerParkActivity(id: string, req: BrokerExecutionRequest): Promise<BrokerParkActivityResultDTO>;
+    recordBrokerTelemetry(id: string, req: BrokerTelemetryRequest): Promise<void>;
     claimNodeMail(id: string, req: ClaimMailRequest): Promise<ClaimMailResultDTO>;
     acknowledgeNodeMail(id: string, req: AcknowledgeMailRequest): Promise<AcknowledgeMailResultDTO>;
     recordBrokerTurn(id: string, req: BrokerTurnRequest): Promise<BrokerTurnResultDTO>;
@@ -315,6 +316,9 @@ export declare class CrtrClient {
      *  poll target for attach/browser topology; use `canvasSnapshot` for the
      *  enriched on-demand view. */
     canvasRoster(): Promise<RosterDTO>;
+    /** The lean attach-graph projection: display rows, topology, and focus state
+     * in one daemon-owned read rather than the full node-summary list. */
+    canvasGraph(): Promise<GraphDTO>;
     prune(req: PruneRequest): Promise<PruneResultDTO>;
     /** Raw request for routes not yet method-wrapped. Applies the same
      *  autostart + retry + error-mapping semantics. */

package/dist/api/client.js

@@ -178,6 +178,9 @@ export class CrtrClient {
     recordBrokerParkActivity(id, req) {
         return this.request('POST', routes.nodeBrokerParkActivity(this.nodePath(id)), req);
     }
+    async recordBrokerTelemetry(id, req) {
+        await this.request('POST', routes.nodeBrokerTelemetry(this.nodePath(id)), req);
+    }
     claimNodeMail(id, req) {
         return this.request('POST', routes.nodeMailClaim(this.nodePath(id)), req);
     }
@@ -597,6 +600,11 @@ export class CrtrClient {
     canvasRoster() {
         return this.request('GET', routes.canvasRoster());
     }
+    /** The lean attach-graph projection: display rows, topology, and focus state
+     * in one daemon-owned read rather than the full node-summary list. */
+    canvasGraph() {
+        return this.request('GET', routes.canvasGraph());
+    }
     prune(req) {
         return this.request('POST', routes.canvasPrune(), req);
     }

package/dist/api/dto/broker-ops.d.ts

@@ -29,6 +29,15 @@ export interface BrokerSettleRequest extends BrokerExecutionRequest {
     backgroundJobsRunning: boolean;
     pushedFinal: boolean;
 }
+/** `POST /v1/nodes/{id}/broker/telemetry` body. Tokens are cumulative within
+ * the broker's current Pi session; null context/activity values preserve the
+ * last usable value in the daemon projection, matching telemetry.json. */
+export interface BrokerTelemetryRequest extends BrokerExecutionRequest {
+    tokens_in: number;
+    context_tokens: number | null;
+    last_activity: string | null;
+    updated_at: string;
+}
 /** The only consequence a settle caller may enact. crtrd has already committed
  * every canvas and placement effect before returning this directive. */
 export type BrokerSettleDirective = {

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

@@ -1,5 +1,5 @@
 import type { Cursor, IsoTime, NodeIdDTO, NodeStatusDTO } from './common.js';
-import type { NodeSummaryDTO } from './nodes.js';
+import type { NodeFaultDTO, NodeSummaryDTO } from './nodes.js';
 /** `GET /v1/nodes` + `GET /v1/status` composed for the dashboard view. */
 export interface DashboardQuery {
     /** Restrict to the subtree under this node. */
@@ -280,6 +280,28 @@ export interface RosterDTO {
     nodes: RosterNodeDTO[];
     edges: RosterEdgeDTO[];
 }
+/** One row in `GET /v1/canvas/graph`: exactly the node fields the attach graph displays. */
+export interface GraphNodeDTO {
+    node_id: NodeIdDTO;
+    name: string;
+    description: string | null;
+    cycles: number | null;
+    kind: string;
+    status: NodeStatusDTO;
+    frozen_at: IsoTime | null;
+    pi_pid: number | null;
+    telemetry_context_tokens: number | null;
+    telemetry_last_activity: string | null;
+    fault: NodeFaultDTO | null;
+    streaming: boolean;
+}
+/** `GET /v1/canvas/graph` — the attach graph's one-read projection: display rows, subscription topology, and the current local viewer-focus set. */
+export interface GraphDTO {
+    generated_at: IsoTime;
+    nodes: GraphNodeDTO[];
+    edges: RosterEdgeDTO[];
+    focused_node_ids: NodeIdDTO[];
+}
 /** `POST /v1/canvas/prune` body — the three exclusive prune modes of
  *  `crtr canvas prune`, precedence COUNT (`limit`) > EMPTY (`empty`) > TTL sweep. */
 export interface PruneRequest {

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

@@ -105,6 +105,14 @@ export interface NodeSummaryDTO {
     final_report: string | null;
     finalized_at: IsoTime | null;
     deadline_at: IsoTime | null;
+    /** Cumulative input tokens reported by the broker telemetry producer. */
+    telemetry_tokens_in?: number | null;
+    /** Latest context-window token gauge reported by the broker. */
+    telemetry_context_tokens?: number | null;
+    /** Latest tool summary reported by the broker. */
+    telemetry_last_activity?: string | null;
+    /** Timestamp of the latest broker telemetry update. */
+    telemetry_updated_at?: IsoTime | null;
     outcome: NodeOutcomeSummaryDTO | null;
     fault?: NodeFaultDTO | null;
     streaming?: boolean;

package/dist/api/node-transport.js

@@ -65,7 +65,8 @@ export function socketFetch(socketPath) {
                     for (const one of Array.isArray(value) ? value : [value])
                         responseHeaders.append(name, one);
                 }
-                resolvePromise(new Response(body, { status: res.statusCode ?? 0, statusText: res.statusMessage, headers: responseHeaders }));
+                const status = res.statusCode ?? 0;
+                resolvePromise(new Response(status === 204 ? null : body, { status, statusText: res.statusMessage, headers: responseHeaders }));
             });
             req.on('error', (err) => reject(new TypeError('fetch failed', { cause: err })));
             const signal = init.signal;

package/dist/api/routes.d.ts

@@ -33,6 +33,7 @@ export declare const routes: {
     readonly nodeBrokerSettle: (id: string) => string;
     readonly nodeBrokerParkComplete: (id: string) => string;
     readonly nodeBrokerParkActivity: (id: string) => string;
+    readonly nodeBrokerTelemetry: (id: string) => string;
     readonly nodeMailClaim: (id: string) => string;
     readonly nodeMailAcknowledge: (id: string) => string;
     readonly nodeBrokerModel: (id: string) => string;
@@ -75,6 +76,7 @@ export declare const routes: {
     readonly canvasHistoryStats: () => string;
     readonly canvasSnapshot: () => string;
     readonly canvasRoster: () => string;
+    readonly canvasGraph: () => string;
     readonly canvasPrune: () => string;
     readonly humanReviews: () => string;
     readonly humanReview: (reviewId: string) => string;

package/dist/api/routes.js

@@ -51,6 +51,7 @@ export const routes = {
     nodeBrokerSettle: (id) => `${V}/nodes/${id}/broker/settle`,
     nodeBrokerParkComplete: (id) => `${V}/nodes/${id}/broker/park-complete`,
     nodeBrokerParkActivity: (id) => `${V}/nodes/${id}/broker/park-activity`,
+    nodeBrokerTelemetry: (id) => `${V}/nodes/${id}/broker/telemetry`,
     nodeMailClaim: (id) => `${V}/nodes/${id}/mail/claim`,
     nodeMailAcknowledge: (id) => `${V}/nodes/${id}/mail/acknowledge`,
     nodeBrokerModel: (id) => `${V}/nodes/${id}/broker/model`,
@@ -97,6 +98,7 @@ export const routes = {
     canvasHistoryStats: () => `${V}/canvas/history/stats`,
     canvasSnapshot: () => `${V}/canvas/snapshot`,
     canvasRoster: () => `${V}/canvas/roster`,
+    canvasGraph: () => `${V}/canvas/graph`,
     canvasPrune: () => `${V}/canvas/prune`,
     // Daemon-owned document reviews and comments. All interpolated ids are
     // guarded by `CrtrClient` before they reach these pure builders.

package/package.json

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