@north-light/crouter 0.3.205 → 0.3.206

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

@@ -1,4 +1,14 @@
 import type { InboxTierDTO, IsoTime, NodeIdDTO } from './common.js';
+/** One runtime card supplied by a caller: the runtime renders and escapes it
+ *  exactly once, so a caller cannot emit a malformed card or smuggle markup
+ *  into one. `kind` must be namespaced (contain `:`) — bare kinds are
+ *  crouter's own closed vocabulary. */
+export interface RuntimeCardRequest {
+    kind: string;
+    facts?: Record<string, string | number>;
+    /** Data, not markup. */
+    body?: string;
+}
 /** `POST /v1/nodes/{id}/messages` body. */
 export interface SendMessageRequest {
     body: string;
@@ -16,6 +26,14 @@ export interface SendMessageRequest {
      *  a `<situational-context>` block, never visible chat (`--situational-context`).
      *  Immediate only; valid alone (no body). */
     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
+     *  bearings after a context refresh. Mutually exclusive with
+     *  `situational_context`; valid alone (no body) on the durable path. */
+    situational_card?: RuntimeCardRequest;
+    /** One-shot runtime cards for this turn only — never persisted. Delivered in
+     *  array order, after `situational_card` and ahead of the body. */
+    context_cards?: RuntimeCardRequest[];
     /** Raw JSON-schema string granting a one-off `submit` tool before delivery
      *  (`--output-schema`). Immediate only. */
     output_schema?: string;
@@ -24,7 +42,10 @@ export interface SendMessageRequest {
      *  instead of the durable inbox; a dormant or mid-revive target falls back to
      *  the durable inbox + revive (watcher delivers post-boot). Plain immediate
      *  body only — rejected with fresh/reopen/situational_context/
-     *  output_schema or tier 'deferred'. Absent → durable inbox (unchanged). */
+     *  output_schema or tier 'deferred'. Runtime cards ARE accepted: a
+     *  card-bearing send is an ordinary human send that happens to carry context,
+     *  and the live deliver frame places the cards ahead of the body in one turn.
+     *  Absent → durable inbox (unchanged). */
     delivery?: 'interactive';
 }
 /** Result of an immediate message send. */