@north-light/crouter-api 0.3.207 → 0.3.209

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, NodeMessagesPageDTO, NodeMessagesQuery, NodeSessionDTO, NodeSnapshotDTO, NodeSummaryDTO, TranscriptDTO, TranscriptQuery } from './dto/nodes.js';
+import type { ArtifactListDTO, ArtifactsQuery, ContextListDTO, CreateNodeRequest, ListNodesQuery, NodeDetailDTO, NodeMessagesPageDTO, NodeMessagesQuery, NodeSessionDTO, NodeSnapshotDTO, NodeSubjectDTO, 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,8 @@ 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-config subject substrate gates evaluate against. */
+    nodeSubject(id: string): Promise<NodeSubjectDTO>;
     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. */

package/dist/api/client.js

@@ -253,6 +253,10 @@ export class CrtrClient {
     getSnapshot(id) {
         return this.request('GET', routes.nodeSnapshot(this.nodePath(id)));
     }
+    /** The node-config subject substrate gates evaluate against. */
+    nodeSubject(id) {
+        return this.request('GET', routes.nodeSubject(this.nodePath(id)));
+    }
     getNodeMessages(id, q) {
         return this.request('GET', withQuery(routes.nodeMessages(this.nodePath(id)), q));
     }

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

@@ -1,4 +1,5 @@
 import type { ExitIntentDTO, NodeStatusDTO } from './common.js';
+import type { NodeSubjectDTO } from './nodes.js';
 /** `POST /v1/nodes/{id}/broker/session-bound` body. Pi's session-start reason
  * distinguishes an ordinary boot/resume from `/new`, whose child-side session
  * reset is a different durable operation. `reviewBoundaryIds` reports only the
@@ -95,18 +96,7 @@ export interface BrokerExtensionNodeDTO {
     };
     created: string;
 }
-export interface BrokerExtensionSubjectDTO {
-    kind: string;
-    mode: 'base' | 'orchestrator';
-    lifecycle: 'terminal' | 'resident';
-    hasManager: boolean;
-    cwd: string;
-    scope: 'user' | 'project';
-    orchestration: {
-        depth: number;
-    };
-    profile: string | null;
-}
+export type BrokerExtensionSubjectDTO = NodeSubjectDTO;
 /** One resolved report sender. Report contents stay broker-local filesystem
  * data; this daemon projection supplies only existence and display metadata. */
 export interface BrokerReportNodeDTO {

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

@@ -1,4 +1,20 @@
 import type { Cursor, ExitIntentDTO, IsoTime, LifecycleDTO, ModeDTO, NodeIdDTO, NodeStatusDTO } from './common.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
+ *  docs without reaching canvas state. */
+export interface NodeSubjectDTO {
+    kind: string;
+    mode: ModeDTO;
+    lifecycle: LifecycleDTO;
+    hasManager: boolean;
+    cwd: string;
+    scope: 'user' | 'project';
+    orchestration: {
+        depth: number;
+    };
+    profile: string | null;
+}
 /** `POST /v1/nodes` body. Carries the full immediate spawn recipe. */
 export interface CreateNodeRequest {
     kind: string;

package/dist/api/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 nodeSubject: (id: string) => string;
     readonly nodeSession: (id: string) => string;
     readonly nodeTranscript: (id: string) => string;
     readonly nodeContext: (id: string) => string;

package/dist/api/routes.js

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

package/dist/shared/generated-context.d.ts

@@ -58,24 +58,7 @@ export interface GeneratedCard {
     facts: Readonly<Record<string, string>>;
     body: string;
     senders: CardSender[];
-    label: string;
-    summary: string;
-    expandable: boolean;
 }
-type CardSummary = (facts: Readonly<Record<string, string>>) => string;
-export interface CardKindDefinition {
-    label: string;
-    summary: CardSummary;
-    expandable: boolean;
-    customTypes?: Readonly<Record<string, Partial<Pick<CardKindDefinition, 'label' | 'summary' | 'expandable'>>>>;
-}
-/** The closed crouter vocabulary, plus custom-role aliases for the same cards. */
-export declare const KIND_TABLE: Readonly<Record<string, CardKindDefinition>>;
-/** Contribute presentation for namespaced kinds this process will render.
- *  Idempotent and last-write-wins, so a re-imported module cannot fail a boot.
- *  A process that never registers is not degraded: an unregistered kind still
- *  parses and only falls back to the generic label and summary. */
-export declare function registerCardKinds(kinds: Readonly<Record<string, CardKindDefinition>>): void;
 /** Plain text from a generated message's string or text-block content. */
 export declare function generatedContextText(message: GeneratedContextMessageLike): string;
 /** Wrap a user-role runtime message in its whole-message card envelope. */
@@ -91,4 +74,3 @@ export declare function parseCard(message: GeneratedContextMessageLike): Generat
 /** Format a complete inbox card from report bodies resolved by the caller. */
 export declare function formatInboxCard(sections: readonly InboxCardSection[]): string;
 export declare function isLegacyRuntimeText(text: string): boolean;
-export {};

package/dist/shared/generated-context.js

@@ -35,98 +35,13 @@ export function formatModelFallbackRecovery(previousModel, nextModel, reason) {
         ? `The previous model (${previousModel}) had no usable provider credential, so you were automatically switched to ${nextModel}. Continue the task from where the failed turn left off.`
         : `The previous model (${previousModel}) was unavailable (provider 404 not_found), so you were automatically switched to ${nextModel}. Continue the task from where the failed turn left off.`;
 }
-function countFact(facts, key) {
-    const value = facts[key];
-    if (value === undefined || !/^(?:0|[1-9]\d*)$/.test(value))
-        return null;
-    return Number(value);
-}
-function inboxSummary(facts) {
-    const updates = countFact(facts, 'updates');
-    const senders = countFact(facts, 'senders');
-    if (updates === null)
-        return 'inbox update';
-    if (senders === null || senders <= 1)
-        return `${updates === 1 ? 'message' : `${updates} messages`} received`;
-    return `${updates} messages received from ${senders} nodes`;
-}
-function recoverySummaryFromFacts(facts) {
-    switch (facts.reason) {
-        case 'model-fallback': return 'model route changed';
-        case 'connection': return 'network connection restored';
-        case 'provider': return 'provider retry';
-        case 'auth': return 'provider credentials updated';
-        default: return 'runtime recovery';
-    }
-}
-function reviewCommentSummary(facts) {
-    switch (facts.verb) {
-        case 'create': return 'review comment created';
-        case 'edit': return 'review comment edited';
-        case 'resolve': return 'review comment resolved';
-        case 'reopen': return 'review comment reopened';
-        case 'delete': return 'review comment deleted';
-        default: return 'review comment updated';
-    }
-}
-/** The closed crouter vocabulary, plus custom-role aliases for the same cards. */
-export const KIND_TABLE = {
-    inbox: { label: 'crtr inbox', summary: inboxSummary, expandable: true },
-    revive: { label: 'crtr revive', summary: () => 'fresh context kickoff', expandable: true },
-    'restart-continuation': { label: 'crouter continuation', summary: () => 'continuing from where it left off', expandable: true },
-    'stop-guard': {
-        label: 'crtr stop guard',
-        summary: (facts) => facts.reason === 'structured-output' ? 'structured output required' : 'completion required',
-        expandable: true,
-    },
-    recovery: { label: 'crouter continuation', summary: recoverySummaryFromFacts, expandable: true },
-    'persona-transition': { label: 'crtr persona', summary: () => 'runtime role update', expandable: true },
-    'review-approval': { label: 'crtr review', summary: () => 'review approved by the user', expandable: true },
-    'review-comment': { label: 'crtr review', summary: reviewCommentSummary, expandable: true },
-    'review-queued': { label: 'crtr review', summary: () => 'review submitted; completion pending', expandable: true },
-    'context-nudge': {
-        label: 'crtr',
-        summary: (facts) => facts.size === undefined ? 'context-window guidance' : `Context ${facts.size}`,
-        expandable: true,
-        customTypes: { [CONTEXT_NUDGE_CUSTOM_TYPE]: {} },
-    },
-    bearings: {
-        label: 'crtr context',
-        summary: () => 'orienting bearings',
-        expandable: true,
-        customTypes: { [CONTEXT_INTRO_CUSTOM_TYPE]: {} },
-    },
-    'review-boundary': {
-        label: 'review boundary',
-        summary: () => 'earlier conversation is not shown',
-        expandable: true,
-        customTypes: { [REVIEW_BOUNDARY_CUSTOM_TYPE]: {} },
-    },
-    situational: {
-        label: 'situational context',
-        summary: () => 'ambient context update',
-        expandable: true,
-        customTypes: { [SITUATIONAL_CONTEXT_CUSTOM_TYPE]: {} },
-    },
-};
-const GENERIC_CARD = {
-    label: 'crtr runtime',
-    summary: () => 'runtime context',
-    expandable: true,
-};
-/** Kinds contributed by a product or plugin, in whatever process renders them. */
-const KIND_REGISTRY = {};
-/** Contribute presentation for namespaced kinds this process will render.
- *  Idempotent and last-write-wins, so a re-imported module cannot fail a boot.
- *  A process that never registers is not degraded: an unregistered kind still
- *  parses and only falls back to the generic label and summary. */
-export function registerCardKinds(kinds) {
-    for (const [kind, definition] of Object.entries(kinds)) {
-        // Bare kinds are crouter core's closed vocabulary. A product claiming one
-        // is a programming error at boot, not a runtime condition to tolerate.
-        if (!kind.includes(':'))
-            throw new Error(`Runtime card kind must be namespaced (contain ':'): ${kind}`);
-        KIND_REGISTRY[kind] = definition;
+function legacyCustomTypeKind(customType) {
+    switch (customType) {
+        case CONTEXT_NUDGE_CUSTOM_TYPE: return 'context-nudge';
+        case CONTEXT_INTRO_CUSTOM_TYPE: return 'bearings';
+        case REVIEW_BOUNDARY_CUSTOM_TYPE: return 'review-boundary';
+        case SITUATIONAL_CONTEXT_CUSTOM_TYPE: return 'situational';
+        default: return undefined;
     }
 }
 const XML_ATTRIBUTE_NAME = /^[A-Za-z_:][A-Za-z0-9_:.-]*$/;
@@ -248,16 +163,7 @@ function parseInboxBody(body) {
     return senders;
 }
 function cardFor(kind, facts, body, senders) {
-    const definition = KIND_TABLE[kind] ?? KIND_REGISTRY[kind] ?? GENERIC_CARD;
-    return {
-        kind,
-        facts,
-        body,
-        senders,
-        label: definition.label,
-        summary: definition.summary(facts),
-        expandable: definition.expandable,
-    };
+    return { kind, facts, body, senders };
 }
 /** Parse a whole-message runtime envelope, regardless of delivery role. */
 function parseEnvelope(text) {
@@ -286,22 +192,13 @@ export function parseCard(message) {
         return null;
     // Pre-envelope custom-message fallback for old sessions. New custom messages
     // classify through their envelope; customType is delivery metadata only.
-    for (const [kind, definition] of Object.entries(KIND_TABLE)) {
-        const override = message.customType === undefined ? undefined : definition.customTypes?.[message.customType];
-        if (override === undefined)
-            continue;
-        const facts = Object.freeze({});
-        return {
-            kind,
-            facts,
-            body: text,
-            senders: [],
-            label: override.label ?? definition.label,
-            summary: (override.summary ?? definition.summary)(facts),
-            expandable: override.expandable ?? definition.expandable,
-        };
-    }
-    return null;
+    const kind = legacyCustomTypeKind(message.customType);
+    return kind === undefined ? null : {
+        kind,
+        facts: Object.freeze({}),
+        body: text,
+        senders: [],
+    };
 }
 /** Format a complete inbox card from report bodies resolved by the caller. */
 export function formatInboxCard(sections) {
@@ -316,8 +213,7 @@ export function formatInboxCard(sections) {
         }).join('\n');
         return `<from${formatAttributes({ id: section.id, name: section.name, updates, finished: finished || undefined })}>${entries}</from>`;
     }).join('\n');
-    const updates = sections.reduce((total, section) => total + (section.updates ?? section.entries.length), 0);
-    return formatCard('inbox', { senders: sections.length, updates }, body);
+    return formatCard('inbox', {}, body);
 }
 // LEGACY — landed 2026-08-14. Pre-envelope runtime text, kept ONLY so old
 // scrollback is not attributed to the person. Delete this section and its

package/package.json

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