@north-light/crouter-api 0.3.227 → 0.3.228

package/dist/api/client.d.ts

@@ -21,7 +21,7 @@ import type { CancelInboxTicketRequest, CanceledTicketResultDTO, InboxListDTO, I
 import type { CreateHumanRequestDTO, CreateHumanRequestRequest, HumanRequestDTO, HumanRequestIdDTO, ReplaceHumanRequestRequest, RespondHumanRequestRequest, SettleHumanRequestRequest } from './dto/human-requests.js';
 import type { AttentionCountsDTO, AttentionDTO, DashboardDTO, DashboardQuery, HistoryGrepQuery, HistoryGrepResultDTO, HistoryReadQuery, HistoryReadResultDTO, HistorySearchQuery, HistorySearchResultDTO, PruneRequest, PruneResultDTO, RebuildIndexResultDTO, RosterDTO, SnapshotDTO } from './dto/canvas.js';
 import type { CloseWorktreeResultDTO } from './dto/worktree.js';
-import type { BrokerExtensionStateDTO, BrokerGeneratedNameRequest, BrokerGeneratedNameResultDTO, BrokerInboxCursorDirective, BrokerInboxCursorRequest, BrokerModelCommitRequest, BrokerModelCommitResultDTO, BrokerPersonaAckRequest, BrokerSessionBoundRequest, BrokerSessionBoundResultDTO, BrokerSettleDirective, BrokerSettleRequest } from './dto/broker-ops.js';
+import type { BrokerExtensionStateDTO, BrokerGeneratedNameRequest, BrokerGeneratedNameResultDTO, BrokerInboxCursorDirective, BrokerInboxCursorRequest, BrokerModelCommitRequest, BrokerModelCommitResultDTO, BrokerPersonaAckRequest, BrokerPersonaAckResultDTO, BrokerSessionBoundRequest, BrokerSessionBoundResultDTO, BrokerSettleDirective, BrokerSettleRequest } from './dto/broker-ops.js';
 export interface CrtrClientOptions {
     /** Unix socket path (default local transport). Exactly one of socketPath|baseUrl. */
     socketPath?: string;
@@ -101,7 +101,7 @@ export declare class CrtrClient {
     commitBrokerModel(id: string, req: BrokerModelCommitRequest): Promise<BrokerModelCommitResultDTO>;
     brokerExtensionState(id: string): Promise<BrokerExtensionStateDTO>;
     commitBrokerGeneratedName(id: string, req: BrokerGeneratedNameRequest): Promise<BrokerGeneratedNameResultDTO>;
-    commitBrokerPersonaAck(id: string, req: BrokerPersonaAckRequest): Promise<void>;
+    commitBrokerPersonaAck(id: string, req: BrokerPersonaAckRequest): Promise<BrokerPersonaAckResultDTO>;
     closeNode(id: string, req?: CloseRequest): Promise<CloseResultDTO>;
     recycleNode(id: string): Promise<NodeDetailDTO>;
     demoteNode(id: string): Promise<NodeDetailDTO>;
@@ -164,9 +164,9 @@ export declare class CrtrClient {
     /** Read an absolute host path as UTF-8 (capped, `truncated` when clipped) for
      *  the browser file-peek panel. */
     peekFile(path: string): Promise<FilePeekDTO>;
-    /** Resolve a `[[name]]` memory-document link to the absolute path the given
-     *  node would read — the node's own precedence chain, not this process's.
-     *  Pair with `peekFile` to render the document. */
+    /** Resolve an exact canonical `[[name]]` memory-document link to the winning
+     *  document's physical origin for the given node — the node's own precedence
+     *  chain, not this process's. Pair with `peekFile` to render the document. */
     resolveMemoryDoc(name: string, nodeId: string): Promise<MemoryDocRefDTO>;
     /** Create-or-return by name. Supplied `projects` are shape-checked even when
      *  the profile already exists; their directories are only required to exist

package/dist/api/client.js

@@ -290,9 +290,9 @@ export class CrtrClient {
         return this.request('GET', withQuery(routes.filePeek(), { path }));
     }
     // ---- Memory documents --------------------------------------------------
-    /** Resolve a `[[name]]` memory-document link to the absolute path the given
-     *  node would read — the node's own precedence chain, not this process's.
-     *  Pair with `peekFile` to render the document. */
+    /** Resolve an exact canonical `[[name]]` memory-document link to the winning
+     *  document's physical origin for the given node — the node's own precedence
+     *  chain, not this process's. Pair with `peekFile` to render the document. */
     resolveMemoryDoc(name, nodeId) {
         return this.request('GET', withQuery(routes.memoryResolve(), { name, node: nodeId }));
     }

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

@@ -90,7 +90,10 @@ export interface BrokerExtensionNodeDTO {
         target_file: string;
     } | null;
     intent: ExitIntentDTO;
+    /** `kind` is absent on rows written before kind joined the drift key; a read
+     *  resolves it to the node's current kind. */
     persona_ack?: {
+        kind?: string;
         mode: 'base' | 'orchestrator';
         lifecycle: 'terminal' | 'resident';
     };
@@ -145,11 +148,16 @@ export interface BrokerGeneratedNameResultDTO {
 }
 export interface BrokerPersonaAckRequest {
     from: {
+        kind: string;
         mode: 'base' | 'orchestrator';
         lifecycle: 'terminal' | 'resident';
     };
     to: {
+        kind: string;
         mode: 'base' | 'orchestrator';
         lifecycle: 'terminal' | 'resident';
     };
 }
+export interface BrokerPersonaAckResultDTO {
+    applied: boolean;
+}

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

@@ -1,16 +1,17 @@
-/** `GET /v1/memory/resolve?name=<name>&node=<id>` result — where the named
- *  document lives for that node. Resolution runs the node's own precedence
- *  chain (its context store, its project stack, its profile, user, builtin), so
- *  the same name can answer with different documents for different nodes. */
+/** `GET /v1/memory/resolve?name=<name>&node=<id>` result. Resolution runs the
+ *  node's own precedence chain (its context store, its project stack, its
+ *  profile, user, builtin) and returns the winner for the exact canonical name. */
 export interface MemoryDocRefDTO {
-    /** The document's canonical identity (its frontmatter `name`, else its
-     *  path-derived name) — which may differ from the queried name when the query
-     *  was a bare leaf or a directory whose INDEX resolved. */
+    /** The winner's canonical identity for the exact resolved query. */
     name: string;
     /** Which store it came from: node | project | profile | user | builtin. */
     scope: string;
     /** Absolute path to the `.md` file. */
     path: string;
+    /** Absolute path to the physical memory store root. */
+    store_root: string;
+    /** Store-relative markdown path of the winning document. */
+    physical_relative_path: string;
     /** The owning plugin's name when the doc is mounted from an installed plugin,
      *  absent for a native scope doc. */
     plugin?: string;

package/dist/api/dto/memory.js

@@ -1,6 +1,6 @@
 // Memory-document resolution DTO. Backs `GET /v1/memory/resolve` — a client
-// holding a `[[name]]` link out of a node's transcript turns it into the
-// absolute path of the document that node would read, then peeks that path.
+// holding a canonical `[[name]]` link out of a node's transcript gets the
+// winning document's canonical identity and physical origin.
 //
 // PURITY (spec §3.1): Node built-ins + `src/api/*` only.
 export {};

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

@@ -6,8 +6,6 @@ export declare const SITUATIONAL_CONTEXT_CUSTOM_TYPE = "crtr-situational-context
 export declare const CONTEXT_NUDGE_CUSTOM_TYPE = "crtr-context-nudge";
 /** 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";
 /** 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. */
@@ -69,4 +67,3 @@ export declare function formatDataCard(kind: string, facts: Record<string, strin
 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;

package/dist/shared/generated-context.js

@@ -10,8 +10,6 @@ export const SITUATIONAL_CONTEXT_CUSTOM_TYPE = 'crtr-situational-context';
 export const CONTEXT_NUDGE_CUSTOM_TYPE = 'crtr-context-nudge';
 /** Custom message that opens a review companion's visible transcript. */
 export const REVIEW_BOUNDARY_CUSTOM_TYPE = 'crtr-review-boundary';
-/** Opening text of a pre-envelope fresh-revive kickoff user message. */
-export const REVIVE_KICKOFF_SENTINEL = 'You have been revived fresh after a context refresh';
 /** Generic completion mandate issued by the terminal-node stop guard. */
 export const STALL_REPROMPT = "You've stopped but you're not waiting on anyone and haven't finished. " +
     "Pipe the result to `crtr push final` through a single-quoted heredoc if the work is done, or use `crtr human send` if you are blocked or need the user.";
@@ -212,58 +210,3 @@ export function formatInboxCard(sections) {
     }).join('\n');
     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
-// callers one week after that date; after deletion, pre-cut scrollback
-// misattributes and that cost is accepted.
-const LEGACY_RESTART_CONTINUATION = '<runtime-restart-continuation>\ncontinue\n</runtime-restart-continuation>';
-const CONTEXT_NUDGE_PREFIX = '[crtr] Context ~';
-const PERSONA_TRANSITION_OPEN = '<persona-transition>';
-const PERSONA_TRANSITION_CLOSE = '</persona-transition>';
-const INBOX_SENDER_ID = '[a-z0-9]+(?:-[a-z0-9]+)+';
-const INBOX_HEADER_RE = new RegExp(`^From (?:(.+?) \\[(${INBOX_SENDER_ID})\\]|(${INBOX_SENDER_ID}|system|human|crtrd)) — (\\d+) update`, 'm');
-function isPersonaTransition(body) {
-    return body.startsWith(`${PERSONA_TRANSITION_OPEN}\n`) && body.endsWith(`\n${PERSONA_TRANSITION_CLOSE}`);
-}
-function isReviewApproval(body) {
-    return body.startsWith(`${REVIEW_APPROVAL_OPEN}\n`) && body.endsWith(`\n${REVIEW_APPROVAL_CLOSE}`);
-}
-function isStructuredOutputReprompt(body) {
-    if (!body.startsWith(STRUCTURED_OUTPUT_REPROMPT_PREFIX) || !body.endsWith(STRUCTURED_OUTPUT_REPROMPT_SUFFIX)) {
-        return false;
-    }
-    const schema = body.slice(STRUCTURED_OUTPUT_REPROMPT_PREFIX.length, -STRUCTURED_OUTPUT_REPROMPT_SUFFIX.length);
-    try {
-        JSON.parse(schema);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-const MODEL_CREDENTIAL_RECOVERY_RE = /^The previous model \([^\n]+\) had no usable provider credential, so you were automatically switched to [^\n]+\. Continue the task from where the failed turn left off\.$/;
-const MODEL_NOT_FOUND_RECOVERY_RE = /^The previous model \([^\n]+\) was unavailable \(provider 404 not_found\), so you were automatically switched to [^\n]+\. Continue the task from where the failed turn left off\.$/;
-function isModelFallbackRecovery(body) {
-    if (!body.startsWith(`${MODEL_FALLBACK_RECOVERY_OPEN}\n`) || !body.endsWith(`\n${MODEL_FALLBACK_RECOVERY_CLOSE}`)) {
-        return false;
-    }
-    const guidance = body.slice(MODEL_FALLBACK_RECOVERY_OPEN.length + 1, -(MODEL_FALLBACK_RECOVERY_CLOSE.length + 1));
-    return MODEL_CREDENTIAL_RECOVERY_RE.test(guidance) || MODEL_NOT_FOUND_RECOVERY_RE.test(guidance);
-}
-function isRecoveryBody(body) {
-    return body === AUTH_FAULT_RECOVERY_BODY
-        || body === CONNECTION_FAULT_RECOVERY_BODY
-        || body === PROVIDER_FAULT_RECOVERY_BODY
-        || body === LEGACY_RESTART_CONTINUATION
-        || isModelFallbackRecovery(body);
-}
-export function isLegacyRuntimeText(text) {
-    return text.startsWith(REVIVE_KICKOFF_SENTINEL)
-        || text.startsWith(CONTEXT_NUDGE_PREFIX)
-        || INBOX_HEADER_RE.test(text)
-        || isReviewApproval(text)
-        || isPersonaTransition(text)
-        || text === STALL_REPROMPT
-        || isStructuredOutputReprompt(text)
-        || isRecoveryBody(text);
-}

package/package.json

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