@north-light/crouter-api 0.3.213 → 0.3.215

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

@@ -17,6 +17,21 @@ export interface ReviewTicketSummaryDTO {
     blocked_since: IsoTime;
     source: TicketSourceDTO;
 }
+/** One question's recommended option, flat on the wire like every other summary field. */
+export interface RecommendedOptionDTO {
+    slot_id: string;
+    option_id: string;
+    label: string;
+}
+/**
+ * What one keypress on an inbox row publishes. `responses` is a complete final response
+ * map this daemon already accepts for the ticket, so a client publishes it untouched
+ * rather than assembling one from the summary.
+ */
+export interface PageFastActionDTO {
+    kind: 'answer' | 'acknowledge';
+    responses: PageResponsesDTO;
+}
 export interface PageTicketSummaryDTO {
     ticket_id: InboxTicketIdDTO;
     kind: 'page';
@@ -30,6 +45,10 @@ export interface PageTicketSummaryDTO {
     source: TicketSourceDTO;
     slot_kinds: string[];
     awaits_response: boolean;
+    /** Omitted when no question recommends an option. */
+    recommended_options?: RecommendedOptionDTO[];
+    /** Present only on a pending ticket that a row can settle without opening it. */
+    fast_action?: PageFastActionDTO;
     state: 'pending' | 'resolved' | 'canceled' | 'passive';
     /** Present only on resolved history entries; the stored one-line answer digest. */
     answer_digest?: string;

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

@@ -17,7 +17,8 @@ export interface NodeSubjectDTO {
 }
 /** `POST /v1/nodes` body. Carries the full immediate spawn recipe. */
 export interface CreateNodeRequest {
-    kind: string;
+    /** Persona kind. Omit to resolve the selected profile's `default_kind`, then `general`. */
+    kind?: string;
     prompt?: string;
     profile?: string;
     mode?: ModeDTO;

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

@@ -1,7 +1,13 @@
-/** `PUT /v1/profiles/{name}` body — idempotent ensure. */
+/** `PUT /v1/profiles/{name}` body — idempotent ensure. Every field applies
+ *  only at create; an existing same-named profile is returned untouched. */
 export interface EnsureProfileRequest {
     /** Absolute project directories in the profile's purview. */
     projects?: string[];
+    /** Persona kind for node creates under the profile that omit kind. */
+    default_kind?: string;
+    /** Profile facts (identity, role); each entry reaches every broker
+     *  launched under the profile as `CRTR_PROFILE_META_<KEY>` env. */
+    metadata?: Record<string, string>;
 }
 /** `DELETE /v1/profiles/{name}` body. Destructive deletion is never implicit. */
 export interface DeleteProfileRequest {
@@ -35,6 +41,12 @@ export interface ProfileDTO {
     /** Where nodes under this profile run — one of `projects` (the first unless
      *  re-pointed), or null when the profile owns none. */
     home: string | null;
+    /** ISO timestamp when the profile was paused, or null while active. */
+    paused_at: string | null;
+    /** Default node kind when a create omits kind; `general` when absent on the manifest. */
+    default_kind: string;
+    /** Stored profile facts; empty when the manifest carries none. */
+    metadata: Record<string, string>;
     /** The directory this profile is pinned as default for, if any. */
     default_dir?: string | null;
 }

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

@@ -33,7 +33,6 @@ export interface CardEntry {
 }
 export interface CardSender {
     id: string;
-    name?: string;
     updates: number;
     finished: boolean;
     entries: CardEntry[];
@@ -48,10 +47,7 @@ export interface InboxCardEntry {
 /** 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;

package/dist/shared/generated-context.js

@@ -130,10 +130,7 @@ function parseInboxBody(body) {
     const fromRe = /<from\b([^>]*)>([\s\S]*?)<\/from>/g;
     for (const fromMatch of body.matchAll(fromRe)) {
         const attributes = parseAttributes(fromMatch[1] ?? '');
-        if (attributes?.id === undefined || attributes.updates === undefined)
-            continue;
-        const updates = Number(attributes.updates);
-        if (!Number.isFinite(updates))
+        if (attributes?.id === undefined)
             continue;
         const entries = [];
         const entryBody = fromMatch[2] ?? '';
@@ -152,10 +149,12 @@ function parseInboxBody(body) {
                 ...(entryAttributes.ref === undefined ? {} : { ref: entryAttributes.ref }),
             });
         }
+        // `updates` and `finished` are derived from the entry list; pre-cut
+        // scrollback still carries them as attributes, honored when present.
+        const legacyUpdates = attributes.updates === undefined ? Number.NaN : Number(attributes.updates);
         senders.push({
             id: attributes.id,
-            ...(attributes.name === undefined ? {} : { name: attributes.name }),
-            updates,
+            updates: Number.isFinite(legacyUpdates) ? legacyUpdates : entries.length,
             finished: attributes.finished === 'true' || entries.some((entry) => entry.kind === 'final'),
             entries,
         });
@@ -203,15 +202,13 @@ export function parseCard(message) {
 /** Format a complete inbox card from report bodies resolved by the caller. */
 export function formatInboxCard(sections) {
     const body = sections.map((section) => {
-        const updates = section.updates ?? section.entries.length;
-        const finished = section.finished ?? section.entries.some((entry) => entry.kind === 'final');
         const entries = section.entries.map((entry) => {
             const disposition = entry.disposition === 'human-answer' || entry.disposition === 'human-canceled'
                 ? entry.disposition
                 : undefined;
             return `<entry${formatAttributes({ kind: entry.kind, ref: entry.ref, disposition })}>${escapeXmlText(entry.body)}</entry>`;
         }).join('\n');
-        return `<from${formatAttributes({ id: section.id, name: section.name, updates, finished: finished || undefined })}>${entries}</from>`;
+        return `<from${formatAttributes({ id: section.id })}>${entries}</from>`;
     }).join('\n');
     return formatCard('inbox', {}, body);
 }

package/package.json

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