@north-light/crouter-api 0.3.206 → 0.3.208

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

@@ -22,9 +22,10 @@ export interface SendMessageRequest {
     /** Clear a latched target's finalization latch before an immediate delivery
      *  or `--fresh` revive (`--reopen`). Immediate only. */
     reopen?: boolean;
-    /** Hidden ambient context upserted onto the target's sidecar and delivered as
-     *  a `<situational-context>` block, never visible chat (`--situational-context`).
-     *  Immediate only; valid alone (no body). */
+    /** Hidden ambient context upserted onto the target's sidecar as a
+     *  `situational` card, never visible chat (`--situational-context`).
+     *  Immediate only; valid alone (no body). Prose only — its body is NOT
+     *  escaped; a caller with untrusted text uses `situational_card`. */
     situational_context?: string;
     /** A runtime card that REPLACES the target's situational sidecar, delivered
      *  ahead of the body in the same turn and re-stated by the session-start

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.206",
+  "version": "0.3.208",
   "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",