@north-light/crouter 0.3.355 → 0.3.357

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

@@ -1,3 +1,4 @@
+import type { NodeSubjectDTO } from './nodes.js';
 export type DeliveryActivity = 'boot' | 'system-prompt' | 'compact' | 'persona' | 'file-read' | 'command' | 'pre-command' | 'slash-command' | 'names'
 /** Dry run only: a live node's workspace-open arrives inside its boot. */
  | 'workspace-open'
@@ -9,7 +10,7 @@ export interface DeliveryRequest {
     subject?: string;
     inherited?: boolean;
     dry_run?: boolean;
-    subject_override?: Partial<import('../../core/substrate/subject-fields.js').NodeConfigSubject>;
+    subject_override?: Partial<NodeSubjectDTO>;
 }
 /** A node that does not exist, for `POST /v1/delivery/dry-run`. Unset fields
  *  come from `node` when one is named, else from defaults. */
@@ -32,7 +33,16 @@ export interface DeliveryDryRunRequest {
     subject?: string;
     node?: string;
     hypothetical?: HypotheticalNodeDTO;
-    subject_override?: Partial<import('../../core/substrate/subject-fields.js').NodeConfigSubject>;
+    subject_override?: Partial<NodeSubjectDTO>;
+}
+/** One resolvable inline memory reference — the broker's `RefMeta`. Metadata
+ *  only, never the document body or its source path. */
+export interface DeliveryRefDTO {
+    name: string;
+    kind: 'knowledge' | 'preference';
+    scope: 'node' | 'project' | 'profile' | 'user' | 'builtin';
+    shortForm: string;
+    gatewayVisible: boolean;
 }
 export interface DeliveryCommandDTO {
     name: string;
@@ -47,7 +57,7 @@ export interface DeliveryResponse {
     commands?: DeliveryCommandDTO[];
     blocks?: string[];
     execution_body?: string;
-    refs?: import('../../core/runtime/broker-protocol.js').RefMeta[];
+    refs?: DeliveryRefDTO[];
     names?: string[];
     plan?: unknown;
 }

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

@@ -1,5 +1,3 @@
-export declare const OBJECT_TYPES: readonly ["document", "node", "job", "person", "app", "repo", "profile"];
-export type ObjectTypeName = typeof OBJECT_TYPES[number];
 export declare const PRIVACY_LEVELS_DTO: readonly ["public", "friends", "private"];
 export type PrivacyName = typeof PRIVACY_LEVELS_DTO[number];
 export type OwnerTypeName = 'person' | 'app' | 'repo' | 'profile' | 'node' | 'document' | 'job';
@@ -10,7 +8,8 @@ export interface ObjectOwnerDTO {
 }
 export interface ObjectDTO {
     id: string;
-    type: ObjectTypeName;
+    /** The object's kind name: `document`, `node`, `job`, `person`, `app`, `repo`, `profile`, or a later kind. */
+    type: string;
     kind: string | null;
     owner: ObjectOwnerDTO | null;
     privacy: PrivacyName;
@@ -33,10 +32,8 @@ export interface DocFieldsDTO {
     extensions?: Record<string, Record<string, unknown>>;
     rules?: import('./docs.js').DeliveryRuleDTO[];
 }
-export interface DocumentReadDTO {
-    state: 'object';
-    type: 'document';
-    object: ObjectDTO;
+/** `data` of a document read. */
+export interface DocumentReadData {
     summary: string | null;
     revision: number;
     heads: DocHeadDTO[];
@@ -49,29 +46,23 @@ export interface DocumentReadDTO {
     attachments?: string;
     fields?: DocFieldsDTO;
 }
-export interface NodeReadDTO {
-    state: 'object';
-    type: 'node';
-    object: ObjectDTO;
+/** `data` of a node read. */
+export interface NodeReadData {
     status: string;
     mandate_first_line: string;
     children: ObjectDTO[];
     owned: ObjectDTO[];
     jobs: ObjectDTO[];
 }
-export interface JobReadDTO {
-    state: 'object';
-    type: 'job';
-    object: ObjectDTO;
+/** `data` of a job read. */
+export interface JobReadData {
     command: string;
     status: string;
     exit_code: number | null;
     log_path: string;
 }
-export interface OwnerReadDTO {
-    state: 'object';
-    type: 'person' | 'app' | 'repo' | 'profile';
-    object: ObjectDTO;
+/** `data` of a person, app, repo or profile read. */
+export interface OwnerReadData {
     handle: string;
     display_name: string;
     identity: {
@@ -79,6 +70,15 @@ export interface OwnerReadDTO {
         external_id: string;
     };
 }
+/** A live object: `text` is exactly what `crtr canvas read` prints; `data` holds the kind's
+ *  structured fields (for the built-in kinds, the `*ReadData` shapes above). */
+export interface ObjectLiveReadDTO {
+    state: 'object';
+    type: string;
+    object: ObjectDTO;
+    text: string;
+    data: Record<string, unknown>;
+}
 /** A pointer to a deleted object resolves to that object (§8); an answer, not an error. */
 export interface ObjectDeletedDTO {
     state: 'deleted';
@@ -89,12 +89,13 @@ export interface ObjectRemoteDTO {
     state: 'remote';
     remote: string;
 }
-export type ObjectReadDTO = DocumentReadDTO | NodeReadDTO | JobReadDTO | OwnerReadDTO | ObjectDeletedDTO | ObjectRemoteDTO;
+export type ObjectReadDTO = ObjectLiveReadDTO | ObjectDeletedDTO | ObjectRemoteDTO;
 export interface ObjectReadQuery {
     fields?: boolean;
 }
 export interface ObjectListRequest {
-    type?: ObjectTypeName;
+    /** A kind name. */
+    type?: string;
     kind?: string;
     /** An owner ref (name or id). */
     owner?: string;
@@ -118,7 +119,8 @@ export interface ObjectSearchRequest {
     text: string;
     body?: boolean;
     grep?: string;
-    type?: ObjectTypeName;
+    /** A kind name. */
+    type?: string;
     kind?: string;
     owner?: string;
     limit?: number;

package/dist/api/dto/objects.js

@@ -1 +1 @@
-const o=["document","node","job","person","app","repo","profile"],e=["public","friends","private"];export{o as OBJECT_TYPES,e as PRIVACY_LEVELS_DTO};
+const e=["public","friends","private"];export{e as PRIVACY_LEVELS_DTO};

package/dist/clients/attach/session/document-links.js

@@ -1 +1 @@
-var k=Object.defineProperty;var i=(o,r)=>k(o,"name",{value:r,configurable:!0});import{APIError as C}from"../../../api/errors.js";import{cliClient as v}from"../../../commands/api-client.js";import{setDocLinkContext as y}from"../render/doc-links.js";import{DOC_SAVEBACK_ENV as g,documentForPath as h,materializeDocument as b,saveDocumentEdit as E,saveOutcomeNotice as L}from"./doc-materialize.js";async function w(o){const r=await v().objects.read(o);if(r.state!=="object"||r.type!=="document")return`${o} is not a readable document`;const n=r;if(n.needs_merge||n.bodies.length!==1)return`${o} has ${n.heads.length} heads and needs a merge`;const s=n.object.owner?.handle;return{id:n.object.id,name:s===void 0?n.object.name:`${s}/${n.object.name}`,revision:n.revision,heads_key:n.heads.map(d=>d.rev_id).sort().join(","),body:n.bodies[0]}}i(w,"readSnapshot");function z(o){const r=new Map,n=new Map,s=new Set,d=new Set;let m=!1,f=!1,l=!1;const j=i(()=>{m||f||(f=!0,o.canvasSource.listNodes().then(t=>{for(const e of t)r.set(e.node_id,e.name);m=!0,l||o.refresh()}).catch(()=>{m=!0}).finally(()=>{f=!1}))},"loadRoster"),N=i(t=>{o.remote||s.has(t)||d.has(t)||(s.add(t),w(t).then(e=>{if(typeof e=="string"){d.add(t);return}n.set(t,b(t,e)),l||o.refresh()}).catch(()=>{d.add(t)}).finally(()=>{s.delete(t)}))},"materialize"),S={selfNodeId:o.selfNodeId,nodeName:i(t=>{const e=r.get(t);return e===void 0&&j(),e},"nodeName"),pathFor:i(t=>{const e=n.get(t);return e===void 0&&N(t),e},"pathFor")};return y(S),{isDocumentPath:i(t=>h(t)!==void 0,"isDocumentPath"),async prepareOpen(t){if(o.remote)return{notice:"Opening a document is unavailable in a remote attach"};const e=h(t);if(e===void 0)return{notice:"Not a document link"};try{const a=await w(e.id);if(typeof a=="string")return{notice:a};const c=b(e.ref,a);return n.set(e.ref,c),{path:c}}catch(a){return{notice:`Could not read ${e.name}: ${a instanceof Error?a.message:String(a)}`}}},async consumeSaveBack(t){const e=process.env[g];if(e===void 0||e==="")return;delete process.env[g];const a=h(e),c=await E(e,async(_,$,D)=>{try{return{revision:(await v().docs.edit(_,{body:$,base:D,rationale:"edited by the person in the attach viewer"})).revision}}catch(u){if(u instanceof C&&u.code==="stale_revision")return"stale";throw u}}),p=L(a?.name??e,c);p!==void 0&&t(p)},dispose(){l=!0,y(void 0)}}}i(z,"createDocumentLinks");export{z as createDocumentLinks};
+var k=Object.defineProperty;var i=(n,o)=>k(n,"name",{value:o,configurable:!0});import{APIError as C}from"../../../api/errors.js";import{cliClient as v}from"../../../commands/api-client.js";import{setDocLinkContext as y}from"../render/doc-links.js";import{DOC_SAVEBACK_ENV as g,documentForPath as h,materializeDocument as b,saveDocumentEdit as E,saveOutcomeNotice as L}from"./doc-materialize.js";async function w(n){const o=await v().objects.read(n);if(o.state!=="object"||o.type!=="document")return`${n} is not a readable document`;const a=o.data;if(a.needs_merge||a.bodies.length!==1)return`${n} has ${a.heads.length} heads and needs a merge`;const s=o.object.owner?.handle;return{id:o.object.id,name:s===void 0?o.object.name:`${s}/${o.object.name}`,revision:a.revision,heads_key:a.heads.map(d=>d.rev_id).sort().join(","),body:a.bodies[0]}}i(w,"readSnapshot");function z(n){const o=new Map,a=new Map,s=new Set,d=new Set;let m=!1,f=!1,l=!1;const j=i(()=>{m||f||(f=!0,n.canvasSource.listNodes().then(t=>{for(const e of t)o.set(e.node_id,e.name);m=!0,l||n.refresh()}).catch(()=>{m=!0}).finally(()=>{f=!1}))},"loadRoster"),N=i(t=>{n.remote||s.has(t)||d.has(t)||(s.add(t),w(t).then(e=>{if(typeof e=="string"){d.add(t);return}a.set(t,b(t,e)),l||n.refresh()}).catch(()=>{d.add(t)}).finally(()=>{s.delete(t)}))},"materialize"),S={selfNodeId:n.selfNodeId,nodeName:i(t=>{const e=o.get(t);return e===void 0&&j(),e},"nodeName"),pathFor:i(t=>{const e=a.get(t);return e===void 0&&N(t),e},"pathFor")};return y(S),{isDocumentPath:i(t=>h(t)!==void 0,"isDocumentPath"),async prepareOpen(t){if(n.remote)return{notice:"Opening a document is unavailable in a remote attach"};const e=h(t);if(e===void 0)return{notice:"Not a document link"};try{const r=await w(e.id);if(typeof r=="string")return{notice:r};const c=b(e.ref,r);return a.set(e.ref,c),{path:c}}catch(r){return{notice:`Could not read ${e.name}: ${r instanceof Error?r.message:String(r)}`}}},async consumeSaveBack(t){const e=process.env[g];if(e===void 0||e==="")return;delete process.env[g];const r=h(e),c=await E(e,async(_,$,D)=>{try{return{revision:(await v().docs.edit(_,{body:$,base:D,rationale:"edited by the person in the attach viewer"})).revision}}catch(u){if(u instanceof C&&u.code==="stale_revision")return"stale";throw u}}),p=L(r?.name??e,c);p!==void 0&&t(p)},dispose(){l=!0,y(void 0)}}}i(z,"createDocumentLinks");export{z as createDocumentLinks};