@north-light/crouter 0.3.204 → 0.3.206

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

@@ -1,62 +1,94 @@
-import { REVIEW_BOUNDARY_CUSTOM_TYPE } from '../core/runtime/session-visibility.js';
-export { REVIEW_BOUNDARY_CUSTOM_TYPE };
 /** Custom message carrying the node's session-start bearings. */
 export declare const CONTEXT_INTRO_CUSTOM_TYPE = "crtr-context";
 /** Custom message carrying an ambient situational-context update. */
 export declare const SITUATIONAL_CONTEXT_CUSTOM_TYPE = "crtr-situational-context";
 /** Custom message used when a context-size nudge waits for the next turn. */
 export declare const CONTEXT_NUDGE_CUSTOM_TYPE = "crtr-context-nudge";
-/** Opening text of a fresh-revive kickoff user message. */
+/** Custom message that opens a review companion's visible transcript. */
+export declare const REVIEW_BOUNDARY_CUSTOM_TYPE = "crtr-review-boundary";
+/** Opening text of a pre-envelope fresh-revive kickoff user message. */
 export declare const REVIVE_KICKOFF_SENTINEL = "You have been revived fresh after a context refresh";
-/** Prefix shared by the producer and the compatibility classifier for context nudges. */
-export declare const CONTEXT_NUDGE_PREFIX = "[crtr] Context ~";
-/** Runtime-authored continuation after a cleanly aborted turn survives a restart. */
-export declare const RUNTIME_RESTART_CONTINUATION = "<runtime-restart-continuation>\ncontinue\n</runtime-restart-continuation>";
 /** Generic completion mandate issued by the terminal-node stop guard. */
 export declare const STALL_REPROMPT: string;
 /** Static recovery prompts shared by the broker producer and display classifier. */
 export declare const AUTH_FAULT_RECOVERY_BODY = "Provider credentials were just updated (a new login landed). Your previous turn stopped on a provider authentication failure. Continue from where you left off and retry the work that failed.";
 export declare const CONNECTION_FAULT_RECOVERY_BODY = "The network connection is back online. Your previous turn stopped on a connection error (the network was down). Continue from where you left off and retry the work that failed.";
 export declare const PROVIDER_FAULT_RECOVERY_BODY = "Your previous turn stopped on a provider fault. Continue from where you left off and retry the work that failed.";
-/** Mark an active persona transition without changing the guidance inside it. */
-export declare function formatPersonaTransition(guidance: string): string;
-/** Mark a daemon-delivered review approval for compact viewer presentation. */
-export declare function formatReviewApproval(body: string): string;
+export type ModelFallbackRecoveryReason = 'credential' | 'not-found';
 /** Format the stop guard's dynamic structured-output mandate. */
 export declare function formatStructuredOutputReprompt(schema: string): string;
-export type ModelFallbackRecoveryReason = 'credential' | 'not-found';
-/** Mark a model-route fallback re-drive while retaining its full guidance. */
+/** Keep model-fallback guidance editable without making it a reader contract. */
 export declare function formatModelFallbackRecovery(previousModel: string, nextModel: string, reason: ModelFallbackRecoveryReason): string;
 export interface GeneratedContextMessageLike {
     role?: string;
     customType?: string;
     content?: unknown;
 }
-export interface GeneratedContextPresentation {
-    kind: 'bearings' | 'situational' | 'revive' | 'context-nudge' | 'inbox' | 'review-approval' | 'persona-transition' | 'stop-guard' | 'recovery';
+export type CardEntryDisposition = 'report' | 'human-answer' | 'human-canceled';
+export interface CardEntry {
+    disposition: CardEntryDisposition;
+    kind: string;
+    body: string;
+    ref?: string;
+}
+export interface CardSender {
+    id: string;
+    name?: string;
+    updates: number;
+    finished: boolean;
+    entries: CardEntry[];
+}
+/** An already-resolved inbox entry supplied to the pure digest formatter. */
+export interface InboxCardEntry {
+    kind: string;
+    body: string;
+    ref?: string;
+    disposition?: CardEntryDisposition;
+}
+/** An already-resolved sender section supplied to the pure digest formatter. */
+export interface InboxCardSection {
+    id: string;
+    name?: string;
+    entries: readonly InboxCardEntry[];
+    updates?: number;
+    finished?: boolean;
+}
+export interface GeneratedCard {
+    kind: string;
+    facts: Readonly<Record<string, string>>;
+    body: string;
+    senders: CardSender[];
     label: string;
     summary: string;
-    /** The unmodified, model-visible message content. */
-    body: 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'>>>>;
 }
-export declare function generatedContextExpandedBody(presentation: GeneratedContextPresentation): string;
+/** 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;
-/** Format the runtime's visible context-size guidance. */
-export declare function formatContextNudge(note: string): string;
-export declare function isInboxDigest(text: string): boolean;
-export declare function extractInboxSender(text: string): string | null;
-/** Node ids whose section of this digest reports a finished node. Sections are
- *  delimited by their `From <sender>` headers, so a final never attaches to the
- *  neighbouring sender. */
-export declare function inboxFinishedSenders(text: string): string[];
-/** Exact producer-owned marker for the continuation a successor broker inserts
- * after a runtime restart. Other recovery bodies intentionally do not match. */
-export declare function isRuntimeRestartContinuation(message: GeneratedContextMessageLike): boolean;
-/**
- * Classify a crouter-generated context message for display. The checks are
- * exact producer-owned contracts: custom messages use their customType, and
- * user messages use stable sentinels or the same exact formatter/constants as
- * their producers. Ordinary user prompts remain ordinary user prompts.
- */
-export declare function generatedContextPresentation(message: GeneratedContextMessageLike): GeneratedContextPresentation | null;
+/** Wrap a user-role runtime message in its whole-message card envelope. */
+export declare function formatCard(kind: string, facts: Record<string, string | number | boolean | undefined>, body: string): string;
+/** Wrap a card whose body is DATA, not markup — the only escape on the API
+ *  path, so a caller can neither emit a malformed card nor smuggle markup into
+ *  one. `formatCard` keeps its raw body for the trusted crouter producers that
+ *  deliberately nest markup (bearings blocks, the inbox `<from>`/`<entry>`
+ *  grammar `parseInboxBody` depends on). */
+export declare function formatDataCard(kind: string, facts: Record<string, string | number | boolean | undefined>, body: string): string;
+/** Parse a runtime envelope, with pre-envelope customType compatibility. */
+export declare function parseCard(message: GeneratedContextMessageLike): GeneratedCard | null;
+/** 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 {};