@north-light/crouter 0.3.349 → 0.3.350

package/bin/crtr-launcher

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runSelected } from './runtime-selector.mjs';
+
+await runSelected('crtr-launcher', 'launcher');

package/bin/runtime-generation-manifest.mjs

@@ -11,7 +11,17 @@ export function runtimeHome() {
 export const GENERATION_ID = /^[a-f0-9]{64}$/;
 export const MANIFEST_SCHEMA = 1;
 export const PACKAGE_NAME = '@north-light/crouter';
-export const ENTRY_NAMES = ['broker', 'cli', 'daemon'];
+export const ENTRY_NAMES = ['broker', 'cli', 'daemon', 'launcher'];
+/** Entries every generation carries. Generations installed before the root
+ *  launcher existed lack `launcher`; a source-linked install moves `bin/` with
+ *  git while the installed generation stays put, so launching those older
+ *  generations must keep working for every entry they do carry. */
+const REQUIRED_ENTRY_NAMES = ['broker', 'cli', 'daemon'];
+
+function entryNamesSupported(entries) {
+  const names = Object.keys(entries);
+  return REQUIRED_ENTRY_NAMES.every((name) => names.includes(name)) && names.every((name) => ENTRY_NAMES.includes(name));
+}
 export const MANIFEST_KEYS = ['arch', 'createdAt', 'entries', 'files', 'id', 'nodeVersion', 'packageName', 'packageVersion', 'platform', 'schema'];
 
 /** Extract the Node major version number from a `process.version`-shaped
@@ -254,7 +264,7 @@ export function validateManifestShape(manifest, { id, entryName }) {
       error: `runtime generation was built for node ${manifest.nodeVersion}, this is ${process.version} — reinstall the runtime (\`npm run install-runtime\` / reinstall crouter)`,
     };
   }
-  if (manifest.schema !== MANIFEST_SCHEMA || manifest.id !== id || !GENERATION_ID.test(manifest.id) || manifest.packageName !== PACKAGE_NAME || typeof manifest.packageVersion !== 'string' || manifest.packageVersion === '' || manifest.platform !== process.platform || manifest.arch !== process.arch || typeof manifest.createdAt !== 'string' || Number.isNaN(Date.parse(manifest.createdAt)) || !manifest.entries || typeof manifest.entries !== 'object' || Array.isArray(manifest.entries) || JSON.stringify(Object.keys(manifest.entries).sort()) !== JSON.stringify(ENTRY_NAMES) || !Array.isArray(manifest.files)) {
+  if (manifest.schema !== MANIFEST_SCHEMA || manifest.id !== id || !GENERATION_ID.test(manifest.id) || manifest.packageName !== PACKAGE_NAME || typeof manifest.packageVersion !== 'string' || manifest.packageVersion === '' || manifest.platform !== process.platform || manifest.arch !== process.arch || typeof manifest.createdAt !== 'string' || Number.isNaN(Date.parse(manifest.createdAt)) || !manifest.entries || typeof manifest.entries !== 'object' || Array.isArray(manifest.entries) || !entryNamesSupported(manifest.entries) || !Array.isArray(manifest.files)) {
     return { ok: false, error: 'generation manifest has an unsupported schema or identity' };
   }
   const entry = manifest.entries[entryName];

package/dist/api/client.d.ts

@@ -2,28 +2,30 @@ import type { DaemonAdmitDTO, DaemonRestartDTO, HealthDTO, MigrateStateDTO, Migr
 import type { BashJobStatusDTO, BashJobStopResultDTO } from './dto/bash-jobs.js';
 import type { ArtifactListDTO, ArtifactsQuery, ContextListDTO, CreateNodeRequest, ListNodesQuery, NodeDetailDTO, NodeMessagesPageDTO, NodeMessagesQuery, NodeSessionDTO, NodeSnapshotDTO, NodeSubjectDTO, NodeSummaryDTO, TranscriptDTO, TranscriptQuery } from './dto/nodes.js';
 import type { NodeOutcomeResponseDTO, OutcomeDeliveryDTO, RegisterOutcomeDeliveryRequest } from './dto/node-outcomes.js';
+import type { AnalyticsDTO, AnalyticsQuery, MemoryReadsRequestDTO } from './dto/analytics.js';
 import type { NodeEventsQuery } from './dto/node-events.js';
+import type { NodeLogAppendRequest, NodeLogAppendResultDTO, NodeTelemetryRecordRequest, NodeRecapRecordRequest, NodeMessageBodyDTO, NodePushedFinalRequest, NodePushedFinalResultDTO } from './dto/node-records.js';
 import type { InterruptResultDTO, MessageResultDTO, SendMessageRequest } from './dto/messages.js';
 import type { PushReportRequest, PushReportResultDTO, ReportDTO, ReportsQuery, SubmitResultDTO, SubmitResultRequest } from './dto/reports.js';
 import type { CloseRequest, CloseResultDTO, PromoteRequest, RelaunchRootResultDTO, ReviveRequest, ReviveResultDTO, WaitRequest, YieldRequest } from './dto/lifecycle.js';
 import type { SubscribeRequest, SubscriptionDTO } from './dto/subscriptions.js';
 import type { FocusDTO, RegisterFocusRequest, SetFocusPaneRequest } from './dto/focus.js';
 import { type ArmCronRequest, type CancelCronQuery, type CronDTO, type CronRunDTO, type CronScopeQuery, type CronShowDTO, type ListCronsQuery, type PokeCronsResult } from './dto/crons.js';
-import type { NodeConfigPatch } from './dto/config.js';
+import type { KindListDTO, NodeConfigPatch } from './dto/config.js';
 import type { AttachEnsureRequest, AttachEnsureResultDTO } from './dto/attach.js';
-import type { DeleteProfileRequest, DeleteProfileResultDTO, EnsureProfileRequest, ProfileDTO, ProfilePauseResultDTO, UpdateProfileMetadataRequest } from './dto/profiles.js';
+import type { CreateProfileRequest, DeleteProfileRequest, DeleteProfileResultDTO, EnsureProfileRequest, ProfileDTO, ProfileEnvChangeDTO, ProfileEnvNamesDTO, ProfilePauseResultDTO, UpdateProfileMetadataRequest, UpdateProfileRequest } from './dto/profiles.js';
 import type { FileEncoding, FileListDTO, FilePeekDTO, FileWriteDTO } from './dto/files.js';
 import type { BashRunDTO, BashRunParams } from './dto/bash.js';
-import type { MemoryDocCreateRequest, MemoryDocDeletedDTO, MemoryDocDTO, MemoryDocMoveRequest, MemoryDocMovedDTO, MemoryDocRefDTO, MemoryDocUpdateRequest, MemoryHistoryDTO, MemoryHistoryQuery, MemoryListDTO, MemoryListQuery, MemoryScope, MemoryDocSummaryDTO, MemorySearchHitDTO, MemorySearchRequest } from './dto/memory.js';
+import type { MemoryDocCreateRequest, MemoryDocDeletedDTO, MemoryDocDTO, MemoryDocMoveRequest, MemoryDocMovedDTO, MemoryOriginConversationDTO, MemoryDocRefDTO, MemoryDocUpdateRequest, MemoryHistoryDTO, MemoryHistoryQuery, MemoryListDTO, MemoryListQuery, MemoryScope, MemoryDocSummaryDTO, MemorySearchHitDTO, MemorySearchRequest } from './dto/memory.js';
 import type { ChatInventoryDTO, ProspectiveChatInventoryDTO, ProspectiveChatInventoryQuery } from './dto/chat-inventory.js';
-import type { CredentialRemovalResultDTO, CredentialResultDTO, InstallCredentialRequest, ModelAuthListDTO, ModelAuthReadinessDTO, ModelAuthReadinessQuery } from './dto/modelauth.js';
+import type { CredentialRemovalResultDTO, CredentialResultDTO, InstallCredentialRequest, CompleteModelAuthFlowRequest, ModelAuthFlowCompletedDTO, ModelAuthFlowDTO, ModelAuthFlowStartedDTO, ModelAuthListDTO, ModelAuthReadinessDTO, ModelAuthReadinessQuery, StartModelAuthFlowRequest } from './dto/modelauth.js';
 import type { CancelReviewRequest, CreateReviewRequest, ListReviewsQuery, ReviewCancelResultDTO, ReviewDocumentBaseDTO, ReviewDTO, ReviewListDTO, ReviewSubmitResultDTO } from './dto/reviews.js';
 import type { CreateReviewCommentRequest, EditReviewCommentRequest, ListReviewCommentsQuery, ReadReviewCommentEventsQuery, ReviewCommentActionRequest, ReviewCommentDetailDTO, ReviewCommentEventsDTO, ReviewCommentForkDTO, ReviewCommentListDTO, ReviewCommentMutationDTO, ReviewCommentRangeBatchRequest, ReviewCommentRangeBatchResultDTO } from './dto/review-comments.js';
 import type { CancelInboxTicketRequest, CanceledTicketResultDTO, InboxListDTO, InboxPageDTO, InboxPageHistoryDTO, InboxPageResponseDTO, InboxTicketIdDTO, PageFeedbackResolutionDTO, PageResponsesDTO, PageTicketResultDTO, RespondInboxPageRequest } from './dto/inbox.js';
-import type { CreateHumanRequestDTO, CreateHumanRequestRequest, HumanRequestDTO, HumanRequestIdDTO, ReplaceHumanRequestRequest, RespondHumanRequestRequest, SettleHumanRequestRequest } from './dto/human-requests.js';
+import type { CreateHumanRequestDTO, CreateHumanRequestRequest, HumanRequestDTO, HumanRequestIdDTO, ReplaceHumanRequestRequest, RespondHumanRequestRequest, SettleHumanRequestRequest, PageComponentListDTO } from './dto/human-requests.js';
 import type { AttentionCountsDTO, AttentionDTO, DashboardDTO, DashboardQuery, HistoryGrepQuery, HistoryGrepResultDTO, HistoryReadQuery, HistoryStatsQuery, HistoryStatsResultDTO, HistoryReadResultDTO, HistorySearchQuery, HistorySearchResultDTO, GraphDTO, PruneRequest, PruneResultDTO, RosterDTO, SnapshotDTO } from './dto/canvas.js';
-import type { AbandonWorktreeRequest, AbandonWorktreeResultDTO, CloseWorktreeResultDTO, QuarantinedWorktreeDTO } from './dto/worktree.js';
-import type { BrokerExtensionStateDTO, BrokerExecutionRequest, BrokerGeneratedNameRequest, BrokerGeneratedNameResultDTO, BrokerModelCommitRequest, BrokerModelCommitResultDTO, BrokerParkActivityResultDTO, BrokerParkCompleteRequest, BrokerPersonaAckRequest, BrokerPersonaAckResultDTO, BrokerSessionBoundRequest, BrokerSessionBoundResultDTO, BrokerSettleDirective, BrokerSettleRequest, BrokerTelemetryRequest } from './dto/broker-ops.js';
+import type { AbandonWorktreeRequest, AbandonWorktreeResultDTO, CloseWorktreeResultDTO, QuarantinedWorktreeDTO, SpaceListDTO } from './dto/worktree.js';
+import type { BrokerExtensionStateDTO, BrokerContextRequest, BrokerContextDTO, BrokerContextCommitRequest, BrokerContextEventRequest, BrokerExecutionRequest, BrokerGeneratedNameRequest, BrokerGeneratedNameResultDTO, BrokerModelCommitRequest, BrokerModelCommitResultDTO, BrokerParkActivityResultDTO, BrokerParkCompleteRequest, BrokerPersonaAckRequest, BrokerPersonaAckResultDTO, BrokerSessionBoundRequest, BrokerSessionBoundResultDTO, BrokerSettleDirective, BrokerSettleRequest, BrokerTelemetryRequest } from './dto/broker-ops.js';
 import type { AcknowledgeMailRequest, AcknowledgeMailResultDTO, ClaimMailRequest, ClaimMailResultDTO } from './dto/mail.js';
 import type { BrokerFaultInputDTO, BrokerFaultRequest, BrokerFaultResultDTO, BrokerProviderRetryRequest, BrokerProviderRetryResultDTO, BrokerTurnRequest, BrokerTurnResultDTO, NodeFaultClearResultDTO, RecoveryStateDTO } from './dto/recovery.js';
 export interface CrtrClientOptions {
@@ -100,6 +102,12 @@ export declare class CrtrClient {
     restartDaemon(): Promise<DaemonRestartDTO>;
     admitDaemon(): Promise<DaemonAdmitDTO>;
     migrateState(req: MigrateStateRequest): Promise<MigrateStateDTO>;
+    appendNodeLog(id: string, req: NodeLogAppendRequest): Promise<NodeLogAppendResultDTO>;
+    putNodeTelemetry(id: string, req: NodeTelemetryRecordRequest): Promise<void>;
+    putNodeRecap(id: string, req: NodeRecapRecordRequest): Promise<void>;
+    readNodeInboxReport(id: string, ref: string, executionId: string): Promise<NodeMessageBodyDTO>;
+    readNodePassiveMessage(id: string, ref: string): Promise<NodeMessageBodyDTO>;
+    nodePushedFinal(id: string, req: NodePushedFinalRequest): Promise<NodePushedFinalResultDTO>;
     createNode(req: CreateNodeRequest): Promise<NodeDetailDTO>;
     /** List canvas nodes with composable row filters. `include: 'activity'` adds
      * latest/canonical reports and pending-human counts in the same response. */
@@ -149,6 +157,10 @@ export declare class CrtrClient {
     }): Promise<NodeFaultClearResultDTO>;
     commitBrokerModel(id: string, req: BrokerModelCommitRequest): Promise<BrokerModelCommitResultDTO>;
     brokerExtensionState(id: string): Promise<BrokerExtensionStateDTO>;
+    brokerContext(id: string, req: BrokerContextRequest): Promise<BrokerContextDTO>;
+    brokerMemoryRefs(id: string, expectedExecutionId: string): Promise<import('./dto/broker-ops.js').BrokerMemoryRefsDTO>;
+    commitBrokerContext(id: string, req: BrokerContextCommitRequest): Promise<void>;
+    brokerContextEvent(id: string, req: BrokerContextEventRequest): Promise<BrokerContextDTO>;
     commitBrokerGeneratedName(id: string, req: BrokerGeneratedNameRequest): Promise<BrokerGeneratedNameResultDTO>;
     commitBrokerPersonaAck(id: string, req: BrokerPersonaAckRequest): Promise<BrokerPersonaAckResultDTO>;
     closeNode(id: string, req?: CloseRequest): Promise<CloseResultDTO>;
@@ -157,6 +169,9 @@ export declare class CrtrClient {
     promoteNode(id: string, req: PromoteRequest): Promise<NodeDetailDTO>;
     yieldNode(id: string, req: YieldRequest): Promise<NodeDetailDTO>;
     waitNode(id: string, req: WaitRequest): Promise<NodeDetailDTO>;
+    listKinds(): Promise<KindListDTO>;
+    /** A model change may first wait up to 30 s for a starting broker's view
+     *  socket and then 15 s for its ack, so it gets that budget on top. */
     patchConfig(id: string, patch: NodeConfigPatch): Promise<NodeDetailDTO>;
     /** Land + close the node's managed git worktree (spec §6.2). Server-side
      *  because it interleaves a canvas WRITE with a git land transaction and
@@ -164,6 +179,8 @@ export declare class CrtrClient {
     closeWorktree(id: string): Promise<CloseWorktreeResultDTO>;
     abandonWorktree(id: string, req: AbandonWorktreeRequest): Promise<AbandonWorktreeResultDTO>;
     listQuarantinedWorktrees(): Promise<QuarantinedWorktreeDTO[]>;
+    /** Every space on the runtime with its size (person only). */
+    listSpaces(): Promise<SpaceListDTO>;
     subscribe(id: string, req: SubscribeRequest): Promise<SubscriptionDTO>;
     listFocuses(): Promise<FocusDTO[]>;
     focusOf(nodeId: string): Promise<FocusDTO | null>;
@@ -217,6 +234,7 @@ export declare class CrtrClient {
     writeFile(path: string, content: string, encoding?: FileEncoding, options?: CrtrRequestOptions): Promise<FileWriteDTO>;
     listFiles(path: string, limit?: number, options?: CrtrRequestOptions): Promise<FileListDTO>;
     runBash(params: BashRunParams, options?: CrtrRequestOptions): Promise<BashRunDTO>;
+    getMemoryOriginConversation(conversationId: string): Promise<MemoryOriginConversationDTO>;
     /** 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. */
@@ -235,7 +253,14 @@ export declare class CrtrClient {
      *  the profile already exists; their directories are only required to exist
      *  when this call creates the profile. */
     ensureProfile(name: string, req?: EnsureProfileRequest): Promise<ProfileDTO>;
+    /** Create a profile of the caller's app; a name it already holds is refused. */
+    createProfile(req: CreateProfileRequest): Promise<ProfileDTO>;
     listProfiles(): Promise<ProfileDTO[]>;
+    /** Rename, set the default kind, or add or remove one project. */
+    updateProfile(name: string, req: UpdateProfileRequest): Promise<ProfileDTO>;
+    listProfileEnv(name: string): Promise<ProfileEnvNamesDTO>;
+    setProfileEnv(name: string, variable: string, value: string): Promise<ProfileEnvChangeDTO>;
+    removeProfileEnv(name: string, variable: string): Promise<ProfileEnvChangeDTO>;
     getProfile(name: string): Promise<ProfileDTO>;
     pauseProfile(name: string): Promise<ProfilePauseResultDTO>;
     resumeProfile(name: string): Promise<ProfilePauseResultDTO>;
@@ -247,6 +272,14 @@ export declare class CrtrClient {
     getModelAuthReadiness(query?: ModelAuthReadinessQuery): Promise<ModelAuthReadinessDTO>;
     installCredential(provider: string, req: InstallCredentialRequest): Promise<CredentialResultDTO>;
     removeCredential(provider: string): Promise<CredentialRemovalResultDTO>;
+    /** `model_auth.start` — the daemon runs the vendor OAuth; the caller only shows `url`. */
+    startModelAuth(req: StartModelAuthFlowRequest): Promise<ModelAuthFlowStartedDTO>;
+    /** `model_auth.complete` — hand the daemon the code the vendor showed. */
+    completeModelAuth(flowId: string, req: CompleteModelAuthFlowRequest): Promise<ModelAuthFlowCompletedDTO>;
+    /** `model_auth.cancel` — end an in-flight flow the person gave up on; it writes nothing. */
+    cancelModelAuth(flowId: string): Promise<ModelAuthFlowDTO>;
+    /** A flow's state; `waitSeconds` (1-25) long-polls until it leaves `pending`. */
+    getModelAuthFlow(flowId: string, waitSeconds?: number): Promise<ModelAuthFlowDTO>;
     createReview(req: CreateReviewRequest): Promise<ReviewDTO>;
     listReviews(query?: ListReviewsQuery): Promise<ReviewListDTO>;
     getReview(reviewId: string): Promise<ReviewDTO>;
@@ -285,6 +318,8 @@ export declare class CrtrClient {
      *  `action.name` is rejected before the page is published, leaving no inbox
      *  row behind. */
     createHumanRequest(request: CreateHumanRequestRequest): Promise<CreateHumanRequestDTO>;
+    /** Product page components registered on the runtime (config + enabled plugins). */
+    listPageComponents(): Promise<PageComponentListDTO>;
     /** Read one request: its current state, its answer when answered, and the
      *  delivery state of its completion action when it bound one. */
     getHumanRequest(requestId: HumanRequestIdDTO): Promise<HumanRequestDTO>;
@@ -329,6 +364,14 @@ export declare class CrtrClient {
     /** The machine-readable browser canvas roster (`crtr canvas snapshot`) —
      *  distinct from the per-node `getSnapshot`. */
     canvasSnapshot(): Promise<SnapshotDTO>;
+    /** The Analytics page model (`GET /v1/canvas/analytics`, person only). The
+     *  daemon scans transcripts for the window: a cold 7d scan of ~2 GB of
+     *  transcripts measured 10 s, and with scan workers capped at 4 a queued
+     *  request waits about one scan more. 60 s is 3x that worst case; past it the
+     *  page shows the error instead of computing forever. */
+    analytics(q: AnalyticsQuery): Promise<AnalyticsDTO>;
+    /** Record memory reads/loads for one node (`POST /v1/nodes/:id/memory-reads`). */
+    recordMemoryReads(nodeId: string, body: MemoryReadsRequestDTO): Promise<void>;
     /** The lean, set-based topology roster (`GET /v1/canvas/roster`) — exactly
      *  two indexed queries server-side, no per-row enrichment. The recurring
      *  poll target for attach/browser topology; use `canvasSnapshot` for the

package/dist/api/client.js

@@ -1,2 +1,2 @@
-var p=Object.defineProperty;var d=(n,e)=>p(n,"name",{value:e,configurable:!0});import{ApiError as h,isErrorBody as b}from"./errors.js";import{routes as r}from"./routes.js";import{isSafeNodeId as S}from"./dto/common.js";import{isSafeBashJobId as g}from"./dto/bash-jobs.js";import{isSafeCronId as R}from"./dto/crons.js";const k=3e4,C=Symbol.for("@north-light/crouter-api/local-socket-fetch"),G=1e4,D=200;async function N({windowMs:n,probe:e,initialError:t,pollIntervalMs:s=D,retry:i=d(()=>!0,"retry"),now:a=Date.now,sleep:P=w}){const l=a()+n;let u=t;for(;;){const c=l-a();if(c<=0)throw u??new Error("crtrd availability window expired without a probe failure");try{await e(c);return}catch(f){if(u=f,!i(f))throw f}const m=l-a();if(m<=0)throw u;await P(Math.min(s,m))}}d(N,"waitForDaemonAvailability");class U{static{d(this,"CrtrClient")}baseUrl;fetch;headers;autostart;timeoutMs;maxRetries;localSocketTransport;onColdSocket;coldStartDiagnostic;coldStartPollWindowMs;coldStartAttempted=!1;constructor(e){if(e.baseUrl==="")throw new TypeError("CrtrClient requires baseUrl");this.baseUrl=new URL(e.baseUrl),this.fetch=e.fetch??globalThis.fetch,this.headers={...e.headers},this.autostart=e.autostart??!1,this.timeoutMs=e.timeoutMs??k,this.maxRetries=e.maxRetries??2,this.localSocketTransport=this.fetch[C]===!0,e.onColdSocket!==void 0&&(this.onColdSocket=e.onColdSocket),e.coldStartDiagnostic!==void 0&&(this.coldStartDiagnostic=e.coldStartDiagnostic),this.coldStartPollWindowMs=e.coldStartPollWindowMs??G}healthz(){return this.request("GET",r.healthz())}async probeHealthz(e){const t=await this.transport("GET",r.healthz(),void 0,{timeout:e});if(t.status===503)try{const s=await t.clone().json();if(typeof s.startup_blocked=="string")return s}catch{}return v(t)}status(){return this.request("GET",r.status())}restartDaemon(){return this.request("POST",r.daemonRestart())}admitDaemon(){return this.request("POST",r.daemonAdmit())}migrateState(e){return this.request("POST",r.daemonMigrate(),e)}createNode(e){return this.request("POST",r.nodes(),e)}listNodes(e){return this.request("GET",o(r.nodes(),e))}getNode(e){return this.request("GET",r.node(this.nodePath(e)))}getNodeOutcome(e,{waitSeconds:t}={}){if(t!==void 0&&(!Number.isInteger(t)||t<0||t>25))throw new RangeError("waitSeconds must be an integer between 0 and 25");return this.request("GET",o(r.nodeOutcome(this.nodePath(e)),{wait:t}),void 0,{timeout:(t??0)*1e3+this.timeoutMs})}getNodeEvents(e,t={},s={}){if(t.after!==void 0&&(!Number.isSafeInteger(t.after)||t.after<0))throw new RangeError("after must be a non-negative safe integer");return this.transport("GET",o(r.nodeEvents(this.nodePath(e)),t),void 0,{...s,headers:{accept:"text/event-stream",...s.headers??{}},timeout:0})}registerOutcomeDelivery(e,t){return this.request("PUT",r.nodeOutcomeDelivery(this.nodePath(e)),t)}getOutcomeDelivery(e){return this.request("GET",r.nodeOutcomeDelivery(this.nodePath(e)))}async disarmOutcomeDelivery(e){await this.request("DELETE",r.nodeOutcomeDelivery(this.nodePath(e)))}listBashJobs(e){return this.request("GET",r.nodeJobs(this.nodePath(e)))}stopBashJob(e,t){return this.request("DELETE",r.nodeJob(this.nodePath(e),this.jobPath(t)))}sendMessage(e,t){return this.request("POST",r.nodeMessages(this.nodePath(e)),t)}interruptNode(e){return this.request("POST",r.nodeInterrupt(this.nodePath(e)),{})}pushReport(e,t){return this.request("POST",r.nodeReports(this.nodePath(e)),t)}submitResult(e,t){return this.request("POST",r.nodeResult(this.nodePath(e)),t)}forkNode(e){return this.request("POST",r.nodeFork(this.nodePath(e)),{})}reviveNode(e,t){return this.request("POST",r.nodeRevive(this.nodePath(e)),t??{})}relaunchRoot(e){return this.request("POST",r.nodeRelaunchRoot(this.nodePath(e)),{})}bindBrokerSession(e,t){return this.request("POST",r.nodeBrokerSessionBound(this.nodePath(e)),t)}settleBroker(e,t){return this.request("POST",r.nodeBrokerSettle(this.nodePath(e)),t)}completeBrokerPark(e,t){return this.request("POST",r.nodeBrokerParkComplete(this.nodePath(e)),t)}recordBrokerParkActivity(e,t){return this.request("POST",r.nodeBrokerParkActivity(this.nodePath(e)),t)}async recordBrokerTelemetry(e,t){await this.request("POST",r.nodeBrokerTelemetry(this.nodePath(e)),t)}claimNodeMail(e,t){return this.request("POST",r.nodeMailClaim(this.nodePath(e)),t)}acknowledgeNodeMail(e,t){return this.request("POST",r.nodeMailAcknowledge(this.nodePath(e)),t)}recordBrokerTurn(e,t){return this.request("POST",r.brokerTurn(this.nodePath(e)),t)}mutateBrokerProviderRetry(e,t){return this.request("POST",r.brokerProviderRetry(this.nodePath(e)),t)}mutateBrokerFault(e,t){return this.request("POST",r.brokerFault(this.nodePath(e)),t)}getBrokerRecovery(e,t){return this.request("GET",`${r.brokerRecovery(this.nodePath(e))}?expected_execution_id=${encodeURIComponent(t)}`)}recordNodeFault(e,t){return this.request("POST",r.nodeFault(this.nodePath(e)),t)}clearNodeFault(e,t={}){const s=new URLSearchParams;t.link!==void 0&&s.set("link",t.link),t.preserve_episode!==void 0&&s.set("preserve_episode",String(t.preserve_episode));const i=s.size===0?"":`?${s.toString()}`;return this.request("DELETE",`${r.nodeFault(this.nodePath(e))}${i}`)}commitBrokerModel(e,t){return this.request("POST",r.nodeBrokerModel(this.nodePath(e)),t)}brokerExtensionState(e){return this.request("GET",r.nodeBrokerExtensionState(this.nodePath(e)))}commitBrokerGeneratedName(e,t){return this.request("POST",r.nodeBrokerGeneratedName(this.nodePath(e)),t)}commitBrokerPersonaAck(e,t){return this.request("POST",r.nodeBrokerPersonaAck(this.nodePath(e)),t)}closeNode(e,t){return this.request("POST",r.nodeClose(this.nodePath(e)),t??{})}recycleNode(e){return this.request("POST",r.nodeRecycle(this.nodePath(e)),{})}demoteNode(e){return this.request("POST",r.nodeDemote(this.nodePath(e)),{})}promoteNode(e,t){return this.request("POST",r.nodePromote(this.nodePath(e)),t)}yieldNode(e,t){return this.request("POST",r.nodeYield(this.nodePath(e)),t)}waitNode(e,t){return this.request("POST",r.nodeWait(this.nodePath(e)),t)}patchConfig(e,t){return this.request("PATCH",r.nodeConfig(this.nodePath(e)),t)}closeWorktree(e){return this.request("POST",r.nodeWorktreeClose(this.nodePath(e)),{})}abandonWorktree(e,t){return this.request("POST",r.nodeWorktreeAbandon(this.nodePath(e)),t)}listQuarantinedWorktrees(){return this.request("GET",r.quarantinedWorktrees())}subscribe(e,t){return this.request("POST",r.nodeSubscriptions(this.nodePath(e)),t)}listFocuses(){return this.request("GET",r.focuses())}focusOf(e){return this.request("GET",o(r.focusByNode(),{node_id:e}))}focusByPane(e){return this.request("GET",o(r.focusByPane(),{pane:e}))}registerFocus(e){return this.request("POST",r.focuses(),e)}async setFocusPane(e,t){await this.request("PATCH",r.focus(e),t)}async closeFocus(e){await this.request("DELETE",r.focus(e))}async unsubscribe(e,t){await this.request("DELETE",r.nodeSubscription(this.nodePath(e),this.nodePath(t)))}armCron(e){return this.request("POST",r.crons(),e)}listCrons(e){return this.request("GET",o(r.crons(),e))}showCron(e,t){return this.request("GET",o(r.cron(this.cronPath(e)),t))}pauseCron(e,t){return this.request("POST",o(r.cronPause(this.cronPath(e)),t),{})}resumeCron(e,t){return this.request("POST",o(r.cronResume(this.cronPath(e)),t),{})}runCron(e,t){return this.request("POST",o(r.cronRun(this.cronPath(e)),t),{})}async cancelCron(e,t){await this.request("DELETE",o(r.cron(this.cronPath(e)),t))}pokeCrons(){return this.request("POST",r.cronsPoke(),{})}ensureAttach(e,t){return this.request("POST",r.nodeAttach(this.nodePath(e)),t??{})}getReports(e,t){return this.request("GET",o(r.nodeReports(this.nodePath(e)),t))}getTranscript(e,t){return this.request("GET",o(r.nodeTranscript(this.nodePath(e)),t))}getSnapshot(e){return this.request("GET",r.nodeSnapshot(this.nodePath(e)))}nodeSubject(e){return this.request("GET",r.nodeSubject(this.nodePath(e)))}getNodeMessages(e,t){return this.request("GET",o(r.nodeMessages(this.nodePath(e)),t))}getSession(e){return this.request("GET",r.nodeSession(this.nodePath(e)))}getChatInventory(e){return this.request("GET",r.nodeChatInventory(this.nodePath(e)))}getProspectiveChatInventory(e){return this.request("GET",o(r.prospectiveChatInventory(),e))}getArtifacts(e,t){return this.request("GET",o(r.nodeArtifacts(this.nodePath(e)),t))}getContext(e){return this.request("GET",r.nodeContext(this.nodePath(e)))}peekFile(e,t,s){return this.request("GET",o(r.filePeek(),{path:e,encoding:t}),void 0,s)}writeFile(e,t,s,i){return this.request("POST",r.fileWrite(),{path:e,content:t,encoding:s},i)}listFiles(e,t,s){return this.request("GET",o(r.fileList(),{path:e,limit:t}),void 0,s)}runBash(e,t){return this.request("POST",r.bash(),e,t)}resolveMemoryDoc(e,t={}){return this.request("GET",o(r.memoryResolve(),{name:e,...t}))}listMemoryDocs(e){return this.request("GET",o(r.memoryDocs(),e))}getMemoryDoc(e,t){return this.request("GET",o(r.memoryDoc(e),t))}createMemoryDoc(e){return this.request("POST",r.memoryDocs(),e)}updateMemoryDoc(e,t){return this.request("PATCH",r.memoryDoc(e),t)}deleteMemoryDoc(e,t){return this.request("DELETE",o(r.memoryDoc(e),t))}moveMemoryDoc(e,t){return this.request("POST",r.memoryDocMove(e),t)}searchMemoryDocs(e){return this.request("POST",r.memorySearch(),e)}getMemoryHistory(e,t){return this.request("GET",o(r.memoryDocHistory(e),t))}ensureProfile(e,t){return this.request("PUT",r.profile(e),t??{})}listProfiles(){return this.request("GET",r.profiles())}getProfile(e){return this.request("GET",r.profile(e))}pauseProfile(e){return this.request("POST",r.profilePause(e),{})}resumeProfile(e){return this.request("POST",r.profileResume(e),{})}updateProfileMetadata(e,t){return this.request("PATCH",r.profileMetadata(e),t)}deleteProfile(e,t){return this.request("DELETE",r.profile(e),t)}listModelAuth(){return this.request("GET",r.modelAuths())}getModelAuthReadiness(e){return this.request("GET",o(r.modelAuthReadiness(),e))}installCredential(e,t){return this.request("PUT",r.modelAuth(e),t)}removeCredential(e){return this.request("DELETE",r.modelAuth(e))}createReview(e){return this.request("POST",r.humanReviews(),e)}listReviews(e){return this.request("GET",o(r.humanReviews(),e))}getReview(e){return this.request("GET",r.humanReview(this.reviewPath(e)))}submitReview(e){return this.request("POST",r.humanReviewSubmit(this.reviewPath(e)),{})}cancelReview(e,t={}){return this.request("POST",r.humanReviewCancel(this.reviewPath(e)),t)}getReviewDocumentBase(e){return this.request("GET",r.humanReviewDocument(this.reviewPath(e)))}createReviewComment(e,t){const s=e===void 0?"self":this.reviewPath(e);return this.request("POST",r.humanReviewComments(s),t)}listReviewComments(e,t){const s=e===void 0?"self":this.reviewPath(e);return this.request("GET",o(r.humanReviewComments(s),t))}readReviewCommentEvents(e,t){return this.request("GET",o(r.humanReviewCommentEvents(this.reviewPath(e)),t))}updateReviewCommentRanges(e,t){return this.request("POST",r.humanReviewCommentRanges(this.reviewPath(e)),t)}getReviewComment(e){return this.request("GET",r.humanComment(this.commentPath(e)))}editReviewComment(e,t){return this.request("POST",r.humanCommentEdit(this.commentPath(e)),t)}resolveReviewComment(e,t={}){return this.request("POST",r.humanCommentResolve(this.commentPath(e)),t)}reopenReviewComment(e,t={}){return this.request("POST",r.humanCommentReopen(this.commentPath(e)),t)}deleteReviewComment(e,t={}){return this.request("POST",r.humanCommentDelete(this.commentPath(e)),t)}forkReviewComment(e){return this.request("POST",r.humanCommentFork(this.commentPath(e)),{})}listHumanInbox(){return this.request("GET",r.humanInbox())}getHumanInboxPage(e){return this.request("GET",r.humanInboxTicket(this.ticketId(e)))}getInboxHistory(e){if(e===void 0)return this.request("GET",r.humanInbox()+"/history");if(typeof e!="string"||e==="")throw new TypeError(`invalid node id: ${JSON.stringify(e)}`);return this.request("GET",o(r.humanInbox()+"/history",{node_id:e}))}respondHumanInboxPage(e,t){return this.request("POST",r.humanInboxRespond(this.ticketId(e)),t)}postInboxProgress(e,t){return this.request("POST",r.humanInboxProgress(this.ticketId(e)),{responses:t})}getInboxResponse(e){return this.request("GET",r.humanInboxResponse(this.ticketId(e)))}cancelHumanInboxTicket(e,t){return this.request("POST",r.humanInboxCancel(this.ticketId(e)),t??{})}createHumanRequest(e){return this.request("POST",r.humanRequests(),e)}getHumanRequest(e){return this.request("GET",r.humanRequest(this.requestPath(e)))}replaceHumanRequest(e,t){return this.request("POST",r.humanRequestReplace(this.requestPath(e)),t)}respondHumanRequest(e,t){return this.request("POST",r.humanRequestRespond(this.requestPath(e)),t)}dismissHumanRequest(e,t={}){return this.request("POST",r.humanRequestDismiss(this.requestPath(e)),t)}cancelHumanRequest(e,t={}){return this.request("POST",r.humanRequestCancel(this.requestPath(e)),t)}resolvePageFeedbackComment(e,t,s){if(!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/.test(t))throw new TypeError(`invalid feedback comment id: ${JSON.stringify(t)}`);return this.request("POST",r.humanInboxFeedbackResolve(this.ticketId(e),t),{node_id:s})}async dashboard(e){const t=e?.under!==void 0?{under:e.under}:void 0,[s,i]=await Promise.all([this.listNodes(t),this.status()]);return{nodes:s,counts:i.node_counts,generated_at:new Date().toISOString()}}attention(){return this.request("GET",r.canvasAttention())}attentionCounts(e){const t={node_ids:e};return this.request("POST",r.canvasAttentionCounts(),t)}historySearch(e){return this.request("POST",r.canvasHistorySearch(),e)}historyGrep(e){return this.request("POST",r.canvasHistoryGrep(),e)}historyRead(e){return this.request("GET",o(r.canvasHistoryRead(),e))}historyStats(e){return this.request("POST",r.canvasHistoryStats(),e)}canvasSnapshot(){return this.request("GET",r.canvasSnapshot())}canvasRoster(){return this.request("GET",r.canvasRoster())}canvasGraph(){return this.request("GET",r.canvasGraph())}prune(e){return this.request("POST",r.canvasPrune(),e)}async request(e,t,s,i){try{return await v(await this.send(e,t,s,i))}catch(a){throw T(a,i?.signal)}}async send(e,t,s,i={}){const a=e==="GET"||e==="HEAD"||e==="DELETE",P=i.maxRetries??this.maxRetries;for(let l=0;;l++){let u;try{u=await this.transport(e,t,s,i)}catch(c){if(this.isColdSocketError(c))try{await this.handleColdSocket(c),u=await this.transport(e,t,s,i)}catch(m){throw T(m,i.signal)}else{if(this.isInterruptedSocketError(c)&&this.localSocketTransport&&(!a||l<P))return await this.rideOutInterruptedRequest(e,t,s,i);if(a&&l<P&&!x(c,i.signal)&&(!this.localSocketTransport||!this.isInterruptedSocketError(c))){await w(O(l+1));continue}else throw T(c,i.signal)}}if(a&&l<P&&M(u.status)){await _(u),await w(O(l+1));continue}return u}}nodePath(e){if(!S(e))throw new h(400,"invalid_node_id",`invalid node id: ${JSON.stringify(e)}`);return e}jobPath(e){if(!g(e))throw new h(400,"invalid_job_id",`invalid background job id: ${JSON.stringify(e)}`);return e}cronPath(e){if(!R(e))throw new h(400,"invalid_cron_id",`invalid cron id: ${JSON.stringify(e)}`);return e}requestPath(e){if(!S(e))throw new h(400,"invalid_request_id",`invalid request id: ${JSON.stringify(e)}`);return e}ticketId(e){if(!/^[a-f0-9]{64}$/.test(e))throw new TypeError(`invalid inbox ticket id: ${JSON.stringify(e)}`);return e}reviewPath(e){if(!S(e))throw new h(400,"invalid_review_id",`invalid review id: ${JSON.stringify(e)}`);return e}commentPath(e){if(!/^[a-f0-9]{32}$/.test(e))throw new h(400,"invalid_comment_id",`invalid comment id: ${JSON.stringify(e)}`);return e}transport(e,t,s,i={}){const a=s===void 0?void 0:JSON.stringify(s),P={accept:"application/json",...this.headers,...i.headers};a!==void 0&&(P["content-type"]="application/json");const l=i.timeout??this.timeoutMs,u=new AbortController,c=l>0?setTimeout(()=>u.abort(new DOMException("request timed out","TimeoutError")),l):void 0,m=i.signal,f=d(()=>u.abort(m?.reason),"onExternalAbort");m!==void 0&&(m.aborted?u.abort(m.reason):m.addEventListener("abort",f,{once:!0}));const y=d(()=>{c!==void 0&&clearTimeout(c),m?.removeEventListener("abort",f)},"finish");return this.fetch(new URL(t,this.baseUrl),{method:e,headers:P,body:a,signal:u.signal}).then(q=>this.retainRequestLifetime(q,y,()=>u.signal.aborted?u.signal.reason:void 0),q=>{throw y(),q})}retainRequestLifetime(e,t,s){if(e.body===null)return t(),e;const i=e.body.getReader();let a=!1;const P=d(()=>{a||(a=!0,t())},"close"),l=new ReadableStream({async pull(u){try{const{done:c,value:m}=await i.read();c?(P(),u.close()):u.enqueue(m)}catch(c){P(),u.error(s()??c)}},async cancel(u){P(),await i.cancel(u)}});return new Response(l,{status:e.status,statusText:e.statusText,headers:e.headers})}isColdSocketError(e){const t=E(e);return t==="ECONNREFUSED"||t==="ENOENT"||t==="ENOTSOCK"}isInterruptedSocketError(e){const t=E(e);return t==="ECONNRESET"||t==="EPIPE"}async rideOutInterruptedRequest(e,t,s,i={}){try{await this.awaitAvailability()}catch(a){throw T(a,i.signal)}if(e!=="GET"&&e!=="HEAD")throw new h(503,"daemon_request_interrupted",`crtrd connection ended before this ${e} response; the request may or may not have been applied.`);try{return await this.transport(e,t,s,i)}catch(a){throw T(a,i.signal)}}async awaitAvailability(e){await N({windowMs:this.coldStartPollWindowMs,initialError:e,probe:d(async t=>{const s=await this.transport("GET",r.healthz(),void 0,{timeout:t});if(s.status>=200&&s.status<300)return;const i=await s.text();try{if(typeof JSON.parse(i).startup_blocked=="string")return}catch{}throw new h(s.status,"daemon_health_unavailable",`crtrd health check returned HTTP ${s.status}: ${i.slice(0,500)}`)},"probe")})}async handleColdSocket(e){const t=this.autostart&&this.onColdSocket!==void 0&&!this.coldStartAttempted;t&&(this.coldStartAttempted=!0,await this.onColdSocket());try{await this.awaitAvailability(e)}catch(s){if(t){const i=A(this.coldStartDiagnostic);if(i!==void 0){const a=T(s);throw new h(a.status,a.code,`${a.message}
-${i}`)}}throw s}}}function o(n,e){if(e===void 0)return n;const t=new URLSearchParams;for(const[i,a]of Object.entries(e))a!=null&&t.set(i,String(a));const s=t.toString();return s===""?n:`${n}?${s}`}d(o,"withQuery");async function v(n){const e=n.status>=200&&n.status<300,t=(await n.text()).trim();let s;if(t!=="")try{s=JSON.parse(t)}catch{if(e)return;throw new h(n.status,"invalid_response",t.slice(0,500),void 0,n.headers)}if(e)return s;throw b(s)?new h(n.status,s.error.code,s.error.message,s.error.details,n.headers):new h(n.status,"internal",`request failed with status ${n.status}`,void 0,n.headers)}d(v,"parse");function M(n){return n===429||n>=500}d(M,"isRetryableStatus");async function _(n){try{await n.body?.cancel()}catch{}}d(_,"drainResponseBody");function O(n){return Math.min(2e3,250*2**(n-1))}d(O,"retryDelayMs");function E(n){if(typeof n!="object"||n===null)return;const e=n.code;if(typeof e=="string")return e;const t=n.cause;if(typeof t=="object"&&t!==null){const s=t.code;if(typeof s=="string")return s}}d(E,"transportErrorCode");function x(n,e){return e?.aborted?!0:n instanceof DOMException&&(n.name==="AbortError"||n.name==="TimeoutError")}d(x,"isAbortError");function T(n,e){if(e?.aborted)return new h(0,"request_aborted","request aborted by caller signal");if(n instanceof h)return n;if(n instanceof DOMException&&n.name==="TimeoutError")return new h(504,"request_timeout",`crtrd request timed out: ${n.message}`);if(n instanceof DOMException&&n.name==="AbortError")return new h(0,"request_aborted","request aborted by caller signal");const t=E(n),s=n instanceof Error?n.message:String(n);return t==="ECONNREFUSED"||t==="ENOENT"||t==="ENOTSOCK"?new h(503,"daemon_unavailable",`crtrd is not reachable: ${s}`):t==="ETIMEDOUT"?new h(504,"request_timeout",`crtrd request timed out: ${s}`):new h(503,"transport_error",s)}d(T,"toTransportApiError");function w(n){return new Promise(e=>setTimeout(e,n))}d(w,"sleepMs");function A(n){if(n!==void 0)try{return n()}catch{return}}d(A,"safeColdStartDiagnostic");export{U as CrtrClient,A as safeColdStartDiagnostic,N as waitForDaemonAvailability};
+var g=Object.defineProperty;var d=(n,e)=>g(n,"name",{value:e,configurable:!0});import{ApiError as h,isErrorBody as b}from"./errors.js";import{routes as r}from"./routes.js";import{isSafeNodeId as E}from"./dto/common.js";import{isSafeBashJobId as R}from"./dto/bash-jobs.js";import{isSafeCronId as k}from"./dto/crons.js";const C=3e4,G=Symbol.for("@north-light/crouter-api/local-socket-fetch"),M=1e4,D=200;async function _({windowMs:n,probe:e,initialError:t,pollIntervalMs:s=D,retry:i=d(()=>!0,"retry"),now:a=Date.now,sleep:P=w}){const l=a()+n;let u=t;for(;;){const c=l-a();if(c<=0)throw u??new Error("crtrd availability window expired without a probe failure");try{await e(c);return}catch(f){if(u=f,!i(f))throw f}const m=l-a();if(m<=0)throw u;await P(Math.min(s,m))}}d(_,"waitForDaemonAvailability");class U{static{d(this,"CrtrClient")}baseUrl;fetch;headers;autostart;timeoutMs;maxRetries;localSocketTransport;onColdSocket;coldStartDiagnostic;coldStartPollWindowMs;coldStartAttempted=!1;constructor(e){if(e.baseUrl==="")throw new TypeError("CrtrClient requires baseUrl");this.baseUrl=new URL(e.baseUrl),this.fetch=e.fetch??globalThis.fetch,this.headers={...e.headers},this.autostart=e.autostart??!1,this.timeoutMs=e.timeoutMs??C,this.maxRetries=e.maxRetries??2,this.localSocketTransport=this.fetch[G]===!0,e.onColdSocket!==void 0&&(this.onColdSocket=e.onColdSocket),e.coldStartDiagnostic!==void 0&&(this.coldStartDiagnostic=e.coldStartDiagnostic),this.coldStartPollWindowMs=e.coldStartPollWindowMs??M}healthz(){return this.request("GET",r.healthz())}async probeHealthz(e){const t=await this.transport("GET",r.healthz(),void 0,{timeout:e});if(t.status===503)try{const s=await t.clone().json();if(typeof s.startup_blocked=="string")return s}catch{}return p(t)}status(){return this.request("GET",r.status())}restartDaemon(){return this.request("POST",r.daemonRestart())}admitDaemon(){return this.request("POST",r.daemonAdmit())}migrateState(e){return this.request("POST",r.daemonMigrate(),e)}appendNodeLog(e,t){return this.request("POST",r.nodeLog(this.nodePath(e)),t)}async putNodeTelemetry(e,t){await this.request("PUT",r.nodeTelemetry(this.nodePath(e)),t)}async putNodeRecap(e,t){await this.request("PUT",r.nodeRecap(this.nodePath(e)),t)}readNodeInboxReport(e,t,s){return this.request("GET",o(r.nodeInboxReport(this.nodePath(e)),{ref:t,execution_id:s}))}readNodePassiveMessage(e,t){return this.request("GET",o(r.nodePassiveMessage(this.nodePath(e)),{ref:t}))}nodePushedFinal(e,t){return this.request("POST",r.nodePushedFinal(this.nodePath(e)),t)}createNode(e){return this.request("POST",r.nodes(),e)}listNodes(e){return this.request("GET",o(r.nodes(),e))}getNode(e){return this.request("GET",r.node(this.nodePath(e)))}getNodeOutcome(e,{waitSeconds:t}={}){if(t!==void 0&&(!Number.isInteger(t)||t<0||t>25))throw new RangeError("waitSeconds must be an integer between 0 and 25");return this.request("GET",o(r.nodeOutcome(this.nodePath(e)),{wait:t}),void 0,{timeout:(t??0)*1e3+this.timeoutMs})}getNodeEvents(e,t={},s={}){if(t.after!==void 0&&(!Number.isSafeInteger(t.after)||t.after<0))throw new RangeError("after must be a non-negative safe integer");return this.transport("GET",o(r.nodeEvents(this.nodePath(e)),t),void 0,{...s,headers:{accept:"text/event-stream",...s.headers??{}},timeout:0})}registerOutcomeDelivery(e,t){return this.request("PUT",r.nodeOutcomeDelivery(this.nodePath(e)),t)}getOutcomeDelivery(e){return this.request("GET",r.nodeOutcomeDelivery(this.nodePath(e)))}async disarmOutcomeDelivery(e){await this.request("DELETE",r.nodeOutcomeDelivery(this.nodePath(e)))}listBashJobs(e){return this.request("GET",r.nodeJobs(this.nodePath(e)))}stopBashJob(e,t){return this.request("DELETE",r.nodeJob(this.nodePath(e),this.jobPath(t)))}sendMessage(e,t){return this.request("POST",r.nodeMessages(this.nodePath(e)),t)}interruptNode(e){return this.request("POST",r.nodeInterrupt(this.nodePath(e)),{})}pushReport(e,t){return this.request("POST",r.nodeReports(this.nodePath(e)),t)}submitResult(e,t){return this.request("POST",r.nodeResult(this.nodePath(e)),t)}forkNode(e){return this.request("POST",r.nodeFork(this.nodePath(e)),{})}reviveNode(e,t){return this.request("POST",r.nodeRevive(this.nodePath(e)),t??{})}relaunchRoot(e){return this.request("POST",r.nodeRelaunchRoot(this.nodePath(e)),{})}bindBrokerSession(e,t){return this.request("POST",r.nodeBrokerSessionBound(this.nodePath(e)),t)}settleBroker(e,t){return this.request("POST",r.nodeBrokerSettle(this.nodePath(e)),t)}completeBrokerPark(e,t){return this.request("POST",r.nodeBrokerParkComplete(this.nodePath(e)),t)}recordBrokerParkActivity(e,t){return this.request("POST",r.nodeBrokerParkActivity(this.nodePath(e)),t)}async recordBrokerTelemetry(e,t){await this.request("POST",r.nodeBrokerTelemetry(this.nodePath(e)),t)}claimNodeMail(e,t){return this.request("POST",r.nodeMailClaim(this.nodePath(e)),t)}acknowledgeNodeMail(e,t){return this.request("POST",r.nodeMailAcknowledge(this.nodePath(e)),t)}recordBrokerTurn(e,t){return this.request("POST",r.brokerTurn(this.nodePath(e)),t)}mutateBrokerProviderRetry(e,t){return this.request("POST",r.brokerProviderRetry(this.nodePath(e)),t)}mutateBrokerFault(e,t){return this.request("POST",r.brokerFault(this.nodePath(e)),t)}getBrokerRecovery(e,t){return this.request("GET",`${r.brokerRecovery(this.nodePath(e))}?expected_execution_id=${encodeURIComponent(t)}`)}recordNodeFault(e,t){return this.request("POST",r.nodeFault(this.nodePath(e)),t)}clearNodeFault(e,t={}){const s=new URLSearchParams;t.link!==void 0&&s.set("link",t.link),t.preserve_episode!==void 0&&s.set("preserve_episode",String(t.preserve_episode));const i=s.size===0?"":`?${s.toString()}`;return this.request("DELETE",`${r.nodeFault(this.nodePath(e))}${i}`)}commitBrokerModel(e,t){return this.request("POST",r.nodeBrokerModel(this.nodePath(e)),t)}brokerExtensionState(e){return this.request("GET",r.nodeBrokerExtensionState(this.nodePath(e)))}brokerContext(e,t){return this.request("POST",r.nodeBrokerContext(this.nodePath(e)),t)}brokerMemoryRefs(e,t){return this.request("POST",r.nodeBrokerMemoryRefs(this.nodePath(e)),{expected_execution_id:t})}commitBrokerContext(e,t){return this.request("POST",r.nodeBrokerContextCommit(this.nodePath(e)),t)}brokerContextEvent(e,t){return this.request("POST",r.nodeBrokerContextEvent(this.nodePath(e)),t)}commitBrokerGeneratedName(e,t){return this.request("POST",r.nodeBrokerGeneratedName(this.nodePath(e)),t)}commitBrokerPersonaAck(e,t){return this.request("POST",r.nodeBrokerPersonaAck(this.nodePath(e)),t)}closeNode(e,t){return this.request("POST",r.nodeClose(this.nodePath(e)),t??{})}recycleNode(e){return this.request("POST",r.nodeRecycle(this.nodePath(e)),{})}demoteNode(e){return this.request("POST",r.nodeDemote(this.nodePath(e)),{})}promoteNode(e,t){return this.request("POST",r.nodePromote(this.nodePath(e)),t)}yieldNode(e,t){return this.request("POST",r.nodeYield(this.nodePath(e)),t)}waitNode(e,t){return this.request("POST",r.nodeWait(this.nodePath(e)),t)}listKinds(){return this.request("GET",r.kinds())}patchConfig(e,t){return this.request("PATCH",r.nodeConfig(this.nodePath(e)),t,t.model!==void 0?{timeout:45e3+this.timeoutMs}:void 0)}closeWorktree(e){return this.request("POST",r.nodeWorktreeClose(this.nodePath(e)),{})}abandonWorktree(e,t){return this.request("POST",r.nodeWorktreeAbandon(this.nodePath(e)),t)}listQuarantinedWorktrees(){return this.request("GET",r.quarantinedWorktrees())}listSpaces(){return this.request("GET",r.spaces())}subscribe(e,t){return this.request("POST",r.nodeSubscriptions(this.nodePath(e)),t)}listFocuses(){return this.request("GET",r.focuses())}focusOf(e){return this.request("GET",o(r.focusByNode(),{node_id:e}))}focusByPane(e){return this.request("GET",o(r.focusByPane(),{pane:e}))}registerFocus(e){return this.request("POST",r.focuses(),e)}async setFocusPane(e,t){await this.request("PATCH",r.focus(e),t)}async closeFocus(e){await this.request("DELETE",r.focus(e))}async unsubscribe(e,t){await this.request("DELETE",r.nodeSubscription(this.nodePath(e),this.nodePath(t)))}armCron(e){return this.request("POST",r.crons(),e)}listCrons(e){return this.request("GET",o(r.crons(),e))}showCron(e,t){return this.request("GET",o(r.cron(this.cronPath(e)),t))}pauseCron(e,t){return this.request("POST",o(r.cronPause(this.cronPath(e)),t),{})}resumeCron(e,t){return this.request("POST",o(r.cronResume(this.cronPath(e)),t),{})}runCron(e,t){return this.request("POST",o(r.cronRun(this.cronPath(e)),t),{})}async cancelCron(e,t){await this.request("DELETE",o(r.cron(this.cronPath(e)),t))}pokeCrons(){return this.request("POST",r.cronsPoke(),{})}ensureAttach(e,t){return this.request("POST",r.nodeAttach(this.nodePath(e)),t??{})}getReports(e,t){return this.request("GET",o(r.nodeReports(this.nodePath(e)),t))}getTranscript(e,t){return this.request("GET",o(r.nodeTranscript(this.nodePath(e)),t))}getSnapshot(e){return this.request("GET",r.nodeSnapshot(this.nodePath(e)))}nodeSubject(e){return this.request("GET",r.nodeSubject(this.nodePath(e)))}getNodeMessages(e,t){return this.request("GET",o(r.nodeMessages(this.nodePath(e)),t))}getSession(e){return this.request("GET",r.nodeSession(this.nodePath(e)))}getChatInventory(e){return this.request("GET",r.nodeChatInventory(this.nodePath(e)))}getProspectiveChatInventory(e){return this.request("GET",o(r.prospectiveChatInventory(),e))}getArtifacts(e,t){return this.request("GET",o(r.nodeArtifacts(this.nodePath(e)),t))}getContext(e){return this.request("GET",r.nodeContext(this.nodePath(e)))}peekFile(e,t,s){return this.request("GET",o(r.filePeek(),{path:e,encoding:t}),void 0,s)}writeFile(e,t,s,i){return this.request("POST",r.fileWrite(),{path:e,content:t,encoding:s},i)}listFiles(e,t,s){return this.request("GET",o(r.fileList(),{path:e,limit:t}),void 0,s)}runBash(e,t){return this.request("POST",r.bash(),e,t)}getMemoryOriginConversation(e){return this.request("GET",o(r.memoryOrigin(),{conversation_id:e}))}resolveMemoryDoc(e,t={}){return this.request("GET",o(r.memoryResolve(),{name:e,...t}))}listMemoryDocs(e){return this.request("GET",o(r.memoryDocs(),e))}getMemoryDoc(e,t){return this.request("GET",o(r.memoryDoc(e),t))}createMemoryDoc(e){return this.request("POST",r.memoryDocs(),e)}updateMemoryDoc(e,t){return this.request("PATCH",r.memoryDoc(e),t)}deleteMemoryDoc(e,t){return this.request("DELETE",o(r.memoryDoc(e),t))}moveMemoryDoc(e,t){return this.request("POST",r.memoryDocMove(e),t)}searchMemoryDocs(e){return this.request("POST",r.memorySearch(),e)}getMemoryHistory(e,t){return this.request("GET",o(r.memoryDocHistory(e),t))}ensureProfile(e,t){return this.request("PUT",r.profile(e),t??{})}createProfile(e){return this.request("POST",r.profiles(),e)}listProfiles(){return this.request("GET",r.profiles())}updateProfile(e,t){return this.request("PATCH",r.profile(e),t)}listProfileEnv(e){return this.request("GET",r.profileEnv(e))}setProfileEnv(e,t,s){return this.request("PUT",r.profileEnvVar(e,t),{value:s})}removeProfileEnv(e,t){return this.request("DELETE",r.profileEnvVar(e,t))}getProfile(e){return this.request("GET",r.profile(e))}pauseProfile(e){return this.request("POST",r.profilePause(e),{})}resumeProfile(e){return this.request("POST",r.profileResume(e),{})}updateProfileMetadata(e,t){return this.request("PATCH",r.profileMetadata(e),t)}deleteProfile(e,t){return this.request("DELETE",r.profile(e),t)}listModelAuth(){return this.request("GET",r.modelAuths())}getModelAuthReadiness(e){return this.request("GET",o(r.modelAuthReadiness(),e))}installCredential(e,t){return this.request("PUT",r.modelAuth(e),t)}removeCredential(e){return this.request("DELETE",r.modelAuth(e))}startModelAuth(e){return this.request("POST",r.modelAuthFlows(),e,{timeout:3e4+this.timeoutMs})}completeModelAuth(e,t){return this.request("POST",r.modelAuthFlowComplete(e),t,{timeout:35e3+this.timeoutMs})}cancelModelAuth(e){return this.request("POST",r.modelAuthFlowCancel(e),{})}getModelAuthFlow(e,t){return this.request("GET",o(r.modelAuthFlow(e),{wait:t}),void 0,{timeout:(t??0)*1e3+this.timeoutMs})}createReview(e){return this.request("POST",r.humanReviews(),e)}listReviews(e){return this.request("GET",o(r.humanReviews(),e))}getReview(e){return this.request("GET",r.humanReview(this.reviewPath(e)))}submitReview(e){return this.request("POST",r.humanReviewSubmit(this.reviewPath(e)),{})}cancelReview(e,t={}){return this.request("POST",r.humanReviewCancel(this.reviewPath(e)),t)}getReviewDocumentBase(e){return this.request("GET",r.humanReviewDocument(this.reviewPath(e)))}createReviewComment(e,t){const s=e===void 0?"self":this.reviewPath(e);return this.request("POST",r.humanReviewComments(s),t)}listReviewComments(e,t){const s=e===void 0?"self":this.reviewPath(e);return this.request("GET",o(r.humanReviewComments(s),t))}readReviewCommentEvents(e,t){return this.request("GET",o(r.humanReviewCommentEvents(this.reviewPath(e)),t))}updateReviewCommentRanges(e,t){return this.request("POST",r.humanReviewCommentRanges(this.reviewPath(e)),t)}getReviewComment(e){return this.request("GET",r.humanComment(this.commentPath(e)))}editReviewComment(e,t){return this.request("POST",r.humanCommentEdit(this.commentPath(e)),t)}resolveReviewComment(e,t={}){return this.request("POST",r.humanCommentResolve(this.commentPath(e)),t)}reopenReviewComment(e,t={}){return this.request("POST",r.humanCommentReopen(this.commentPath(e)),t)}deleteReviewComment(e,t={}){return this.request("POST",r.humanCommentDelete(this.commentPath(e)),t)}forkReviewComment(e){return this.request("POST",r.humanCommentFork(this.commentPath(e)),{})}listHumanInbox(){return this.request("GET",r.humanInbox())}getHumanInboxPage(e){return this.request("GET",r.humanInboxTicket(this.ticketId(e)))}getInboxHistory(e){if(e===void 0)return this.request("GET",r.humanInbox()+"/history");if(typeof e!="string"||e==="")throw new TypeError(`invalid node id: ${JSON.stringify(e)}`);return this.request("GET",o(r.humanInbox()+"/history",{node_id:e}))}respondHumanInboxPage(e,t){return this.request("POST",r.humanInboxRespond(this.ticketId(e)),t)}postInboxProgress(e,t){return this.request("POST",r.humanInboxProgress(this.ticketId(e)),{responses:t})}getInboxResponse(e){return this.request("GET",r.humanInboxResponse(this.ticketId(e)))}cancelHumanInboxTicket(e,t){return this.request("POST",r.humanInboxCancel(this.ticketId(e)),t??{})}createHumanRequest(e){return this.request("POST",r.humanRequests(),e)}listPageComponents(){return this.request("GET",r.humanComponents())}getHumanRequest(e){return this.request("GET",r.humanRequest(this.requestPath(e)))}replaceHumanRequest(e,t){return this.request("POST",r.humanRequestReplace(this.requestPath(e)),t)}respondHumanRequest(e,t){return this.request("POST",r.humanRequestRespond(this.requestPath(e)),t)}dismissHumanRequest(e,t={}){return this.request("POST",r.humanRequestDismiss(this.requestPath(e)),t)}cancelHumanRequest(e,t={}){return this.request("POST",r.humanRequestCancel(this.requestPath(e)),t)}resolvePageFeedbackComment(e,t,s){if(!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/.test(t))throw new TypeError(`invalid feedback comment id: ${JSON.stringify(t)}`);return this.request("POST",r.humanInboxFeedbackResolve(this.ticketId(e),t),{node_id:s})}async dashboard(e){const t=e?.under!==void 0?{under:e.under}:void 0,[s,i]=await Promise.all([this.listNodes(t),this.status()]);return{nodes:s,counts:i.node_counts,generated_at:new Date().toISOString()}}attention(){return this.request("GET",r.canvasAttention())}attentionCounts(e){const t={node_ids:e};return this.request("POST",r.canvasAttentionCounts(),t)}historySearch(e){return this.request("POST",r.canvasHistorySearch(),e)}historyGrep(e){return this.request("POST",r.canvasHistoryGrep(),e)}historyRead(e){return this.request("GET",o(r.canvasHistoryRead(),e))}historyStats(e){return this.request("POST",r.canvasHistoryStats(),e)}canvasSnapshot(){return this.request("GET",r.canvasSnapshot())}analytics(e){return this.request("GET",o(r.canvasAnalytics(),e),void 0,{timeout:6e4})}async recordMemoryReads(e,t){await this.request("POST",r.nodeMemoryReads(this.nodePath(e)),t)}canvasRoster(){return this.request("GET",r.canvasRoster())}canvasGraph(){return this.request("GET",r.canvasGraph())}prune(e){return this.request("POST",r.canvasPrune(),e)}async request(e,t,s,i){try{return await p(await this.send(e,t,s,i))}catch(a){throw T(a,i?.signal)}}async send(e,t,s,i={}){const a=e==="GET"||e==="HEAD"||e==="DELETE",P=i.maxRetries??this.maxRetries;for(let l=0;;l++){let u;try{u=await this.transport(e,t,s,i)}catch(c){if(this.isColdSocketError(c))try{await this.handleColdSocket(c),u=await this.transport(e,t,s,i)}catch(m){throw T(m,i.signal)}else{if(this.isInterruptedSocketError(c)&&this.localSocketTransport&&(!a||l<P))return await this.rideOutInterruptedRequest(e,t,s,i);if(a&&l<P&&!N(c,i.signal)&&(!this.localSocketTransport||!this.isInterruptedSocketError(c))){await w(O(l+1));continue}else throw T(c,i.signal)}}if(a&&l<P&&x(u.status)){await v(u),await w(O(l+1));continue}return u}}nodePath(e){if(!E(e))throw new h(400,"invalid_node_id",`invalid node id: ${JSON.stringify(e)}`);return e}jobPath(e){if(!R(e))throw new h(400,"invalid_job_id",`invalid background job id: ${JSON.stringify(e)}`);return e}cronPath(e){if(!k(e))throw new h(400,"invalid_cron_id",`invalid cron id: ${JSON.stringify(e)}`);return e}requestPath(e){if(!E(e))throw new h(400,"invalid_request_id",`invalid request id: ${JSON.stringify(e)}`);return e}ticketId(e){if(!/^[a-f0-9]{64}$/.test(e))throw new TypeError(`invalid inbox ticket id: ${JSON.stringify(e)}`);return e}reviewPath(e){if(!E(e))throw new h(400,"invalid_review_id",`invalid review id: ${JSON.stringify(e)}`);return e}commentPath(e){if(!/^[a-f0-9]{32}$/.test(e))throw new h(400,"invalid_comment_id",`invalid comment id: ${JSON.stringify(e)}`);return e}transport(e,t,s,i={}){const a=s===void 0?void 0:JSON.stringify(s),P={accept:"application/json",...this.headers,...i.headers};a!==void 0&&(P["content-type"]="application/json");const l=i.timeout??this.timeoutMs,u=new AbortController,c=l>0?setTimeout(()=>u.abort(new DOMException("request timed out","TimeoutError")),l):void 0,m=i.signal,f=d(()=>u.abort(m?.reason),"onExternalAbort");m!==void 0&&(m.aborted?u.abort(m.reason):m.addEventListener("abort",f,{once:!0}));const y=d(()=>{c!==void 0&&clearTimeout(c),m?.removeEventListener("abort",f)},"finish");return this.fetch(new URL(t,this.baseUrl),{method:e,headers:P,body:a,signal:u.signal}).then(q=>this.retainRequestLifetime(q,y,()=>u.signal.aborted?u.signal.reason:void 0),q=>{throw y(),q})}retainRequestLifetime(e,t,s){if(e.body===null)return t(),e;const i=e.body.getReader();let a=!1;const P=d(()=>{a||(a=!0,t())},"close"),l=new ReadableStream({async pull(u){try{const{done:c,value:m}=await i.read();c?(P(),u.close()):u.enqueue(m)}catch(c){P(),u.error(s()??c)}},async cancel(u){P(),await i.cancel(u)}});return new Response(l,{status:e.status,statusText:e.statusText,headers:e.headers})}isColdSocketError(e){const t=S(e);return t==="ECONNREFUSED"||t==="ENOENT"||t==="ENOTSOCK"}isInterruptedSocketError(e){const t=S(e);return t==="ECONNRESET"||t==="EPIPE"}async rideOutInterruptedRequest(e,t,s,i={}){try{await this.awaitAvailability()}catch(a){throw T(a,i.signal)}if(e!=="GET"&&e!=="HEAD")throw new h(503,"daemon_request_interrupted",`crtrd connection ended before this ${e} response; the request may or may not have been applied.`);try{return await this.transport(e,t,s,i)}catch(a){throw T(a,i.signal)}}async awaitAvailability(e){await _({windowMs:this.coldStartPollWindowMs,initialError:e,probe:d(async t=>{const s=await this.transport("GET",r.healthz(),void 0,{timeout:t});if(s.status>=200&&s.status<300){await v(s);return}const i=await s.text();try{if(typeof JSON.parse(i).startup_blocked=="string")return}catch{}throw new h(s.status,"daemon_health_unavailable",`crtrd health check returned HTTP ${s.status}: ${i.slice(0,500)}`)},"probe")})}async handleColdSocket(e){const t=this.autostart&&this.onColdSocket!==void 0&&!this.coldStartAttempted;t&&(this.coldStartAttempted=!0,await this.onColdSocket());try{await this.awaitAvailability(e)}catch(s){if(t){const i=A(this.coldStartDiagnostic);if(i!==void 0){const a=T(s);throw new h(a.status,a.code,`${a.message}
+${i}`)}}throw s}}}function o(n,e){if(e===void 0)return n;const t=new URLSearchParams;for(const[i,a]of Object.entries(e))a!=null&&t.set(i,String(a));const s=t.toString();return s===""?n:`${n}?${s}`}d(o,"withQuery");async function p(n){const e=n.status>=200&&n.status<300,t=(await n.text()).trim();let s;if(t!=="")try{s=JSON.parse(t)}catch{if(e)return;throw new h(n.status,"invalid_response",t.slice(0,500),void 0,n.headers)}if(e)return s;throw b(s)?new h(n.status,s.error.code,s.error.message,s.error.details,n.headers,s.error):new h(n.status,"internal",`request failed with status ${n.status}`,void 0,n.headers)}d(p,"parse");function x(n){return n===429||n>=500}d(x,"isRetryableStatus");async function v(n){try{await n.body?.cancel()}catch{}}d(v,"drainResponseBody");function O(n){return Math.min(2e3,250*2**(n-1))}d(O,"retryDelayMs");function S(n){if(typeof n!="object"||n===null)return;const e=n.code;if(typeof e=="string")return e;const t=n.cause;if(typeof t=="object"&&t!==null){const s=t.code;if(typeof s=="string")return s}}d(S,"transportErrorCode");function N(n,e){return e?.aborted?!0:n instanceof DOMException&&(n.name==="AbortError"||n.name==="TimeoutError")}d(N,"isAbortError");function T(n,e){if(e?.aborted)return new h(0,"request_aborted","request aborted by caller signal");if(n instanceof h)return n;if(n instanceof DOMException&&n.name==="TimeoutError")return new h(504,"request_timeout",`crtrd request timed out: ${n.message}`);if(n instanceof DOMException&&n.name==="AbortError")return new h(0,"request_aborted","request aborted by caller signal");const t=S(n),s=n instanceof Error?n.message:String(n);return t==="ECONNREFUSED"||t==="ENOENT"||t==="ENOTSOCK"?new h(503,"daemon_unavailable",`crtrd is not reachable: ${s}`):t==="ETIMEDOUT"?new h(504,"request_timeout",`crtrd request timed out: ${s}`):new h(503,"transport_error",s)}d(T,"toTransportApiError");function w(n){return new Promise(e=>setTimeout(e,n))}d(w,"sleepMs");function A(n){if(n!==void 0)try{return n()}catch{return}}d(A,"safeColdStartDiagnostic");export{U as CrtrClient,A as safeColdStartDiagnostic,_ as waitForDaemonAvailability};

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

@@ -0,0 +1,184 @@
+export type AnalyticsWindow = '24h' | '7d';
+export interface AnalyticsQuery {
+    as_of: string;
+    window: AnalyticsWindow;
+    project?: string;
+}
+export type MeasureDTO<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    reason: string;
+};
+export interface AnalyticsDTO {
+    as_of: string;
+    window_start: string;
+    window: AnalyticsWindow;
+    project: string | null;
+    projects: Array<{
+        cwd: string;
+        api_price_estimate: number;
+    }>;
+    transcripts: {
+        total: number;
+        read: number;
+        unreadable: Array<{
+            node_id: string;
+            reason: 'file missing' | 'unreadable' | 'parse error';
+        }>;
+    } | null;
+    unknown_responses: number | null;
+    oldest_agent_created: string | null;
+    memory_log_started_at: string | null;
+    agents: AgentRowDTO[];
+    graphs: MeasureDTO<GraphsDTO>;
+    time: MeasureDTO<TimeDTO>;
+    usage: MeasureDTO<UsageDTO>;
+    memory: MeasureDTO<{
+        read: MemoryViewDTO;
+        loaded: MemoryViewDTO;
+    }>;
+}
+export interface AgentRowDTO {
+    node_id: string;
+    name: string;
+    kind: string;
+    graph_id: string;
+    in_graph_detail: boolean;
+    parent: string | null;
+    depth: number;
+    created: string;
+    finalized_at: string | null;
+    lifecycle: 'resident' | 'terminal';
+    active: boolean;
+    spawned_in_window: boolean;
+    finished_in_window: boolean;
+    agent_time_ms: number | null;
+    api_price_estimate: number;
+    tokens: number;
+    responses: number;
+    response_times_ms: number[];
+    final_report_ref: string | null;
+}
+export interface GraphRowDTO {
+    graph_id: string;
+    name: string;
+    root_deleted: boolean;
+    cwd: string;
+    root_kind: string;
+    root_lifecycle: 'resident' | 'terminal';
+    root_created: string;
+    active_agents: number;
+    depth: number;
+    api_price_estimate: number;
+    tokens: number;
+    spawned_kinds: string[];
+}
+export interface GraphsDTO {
+    count: number;
+    spawned: number;
+    deepest: number;
+    graphs: GraphRowDTO[];
+    size_buckets: Array<{
+        label: '1' | '2–5' | '6–10' | '11–20' | '21+';
+        graphs: number;
+    }>;
+    spawned_by_kind: Array<{
+        kind: string;
+        agents: number;
+    }>;
+}
+export interface DurationStatsDTO {
+    count: number;
+    p10_ms: number;
+    median_ms: number;
+    p90_ms: number;
+    max_ms: number;
+}
+export interface TimeDTO {
+    all: DurationStatsDTO | null;
+    by_kind: Array<{
+        kind: string;
+    } & DurationStatsDTO>;
+    activity: {
+        bucket_ms: number;
+        buckets: Array<{
+            start: string;
+            agents: number;
+        }>;
+        max: number;
+    };
+}
+export interface ModelKeyDTO {
+    provider: string;
+    model: string;
+}
+export interface ModelRowDTO extends ModelKeyDTO {
+    responses: number;
+    api_price_estimate: number;
+    tokens: number;
+    tokens_by_type: {
+        cache_read: number;
+        cache_write: number;
+        input: number;
+        output: number;
+    };
+    cache_read_share: number;
+    context: {
+        median: number;
+        p90: number;
+        max: number;
+        buckets: [number, number, number, number, number];
+    };
+}
+export interface UsageDTO {
+    api_price_estimate: number;
+    tokens: number;
+    median_context: number | null;
+    models: ModelRowDTO[];
+    legend: ModelKeyDTO[];
+    kinds: Array<{
+        kind: string;
+        api_price_estimate: number;
+        tokens: number;
+        responses_by_model: Array<ModelKeyDTO & {
+            responses: number;
+        }>;
+    }>;
+}
+export interface MemoryDocRowDTO {
+    name: string;
+    scope: string;
+    reads: number;
+    agents: number;
+    graphs: number;
+    readers_by_kind: Array<{
+        kind: string;
+        agents: number;
+    }>;
+    readers: Array<{
+        node_id: string;
+        kind: string;
+        name: string;
+        graph_id: string;
+        reads: number;
+        first_at: string;
+    }>;
+}
+export interface MemoryViewDTO {
+    entries: number;
+    documents: number;
+    agents_with_entry: number;
+    active_agents: number;
+    rows: MemoryDocRowDTO[];
+}
+export interface MemoryReadEventDTO {
+    name: string;
+    scope: string;
+    at: string;
+    type: 'read' | 'loaded';
+}
+export interface MemoryReadsRequestDTO {
+    events: MemoryReadEventDTO[];
+}

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

@@ -62,7 +62,11 @@ export interface BrokerParkCompleteRequest extends BrokerExecutionRequest {
 /** Durable model recipe selected by the live broker after Pi accepts a model or thinking change. */
 export interface BrokerModelCommitRequest extends BrokerExecutionRequest {
     spec: string;
-    pinnedOverride?: boolean;
+    /** Portable routing contract for a user-selected change; absent means exact. */
+    intent?: {
+        family: string;
+        strength: 'ultra' | 'strong' | 'medium' | 'light';
+    };
     userSelected: boolean;
 }
 export interface BrokerModelCommitResultDTO {
@@ -72,6 +76,7 @@ export interface BrokerModelCommitResultDTO {
  * render their local Pi hooks without reading canvas.db themselves. */
 export interface BrokerExtensionNodeDTO {
     node_id: string;
+    grantee: string;
     name: string;
     description?: string;
     title?: string;
@@ -114,6 +119,7 @@ export type BrokerExtensionSubjectDTO = NodeSubjectDTO;
  * data; this daemon projection supplies only existence and display metadata. */
 export interface BrokerReportNodeDTO {
     node_id: string;
+    grantee: string;
     name: string;
     created: string;
 }
@@ -128,6 +134,42 @@ export interface BrokerExtensionStateDTO {
     subject: BrokerExtensionSubjectDTO;
     report_nodes: BrokerReportNodeDTO[];
 }
+/** Memory-bearing context is rendered by crtrd, not by a sandboxed broker. */
+export interface BrokerContextSnapshotDTO {
+    preferenceSnapshot: string | null;
+    exposures: Record<string, {
+        system?: number;
+        transcript?: number;
+    }>;
+}
+export interface BrokerContextRequest extends BrokerExecutionRequest {
+    mode: 'baseline' | 'compact' | 'preferences';
+}
+/** One full document body that entered the context: a `loaded` memory-log event. */
+export interface BrokerContextLoadDTO {
+    name: string;
+    scope: string;
+}
+export interface BrokerContextDTO {
+    content: string;
+    compact: boolean;
+    snapshot: BrokerContextSnapshotDTO;
+    /** Full bodies this preparation delivers; the broker returns them with the commit. */
+    loads: BrokerContextLoadDTO[];
+}
+export interface BrokerMemoryRefsDTO {
+    refs: import('../../core/runtime/broker-protocol.js').RefMeta[];
+    names: string[];
+}
+export interface BrokerContextCommitRequest extends BrokerExecutionRequest {
+    snapshot: BrokerContextSnapshotDTO;
+    /** The prepared `loads` once the broker has delivered them; recorded as `loaded` events. */
+    loads?: BrokerContextLoadDTO[];
+}
+export interface BrokerContextEventRequest extends BrokerExecutionRequest {
+    event: 'read' | 'command' | 'pre-command' | 'compact' | 'persona';
+    value?: string;
+}
 /** Guarded generated-label update. `initial` can only fill a blank generated
  * description; `recap` additionally compares the exact automatic-name snapshot
  * captured before the headless naming call. */

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

@@ -19,3 +19,14 @@ export interface NodeConfigPatch {
     /** Per-run allow-list. A patch may only remove scopes; it applies to a live broker on its next revive. */
     scopes?: string[];
 }
+/** One installed persona kind, as the daemon resolves kinds for node creation. */
+export interface KindDTO {
+    kind: string;
+    when_to_use: string | null;
+    /** Top-level kinds a sub-kind is offered to; null takes the default (its own ancestor). */
+    available_to: string[] | null;
+}
+/** `GET /v1/kinds` — every kind the daemon accepts on create, sorted by name. */
+export interface KindListDTO {
+    kinds: KindDTO[];
+}

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

@@ -0,0 +1,14 @@
+export interface GrantGetDTO {
+    sub: string;
+    grantee: string;
+    client_id: string;
+    grant: string;
+    exp: number;
+    rev: number;
+    resolved_scopes: {
+        scope: string;
+        mode: 'always' | 'ask';
+    }[];
+    spend_cap: number | null;
+    payer: 'user';
+}

package/dist/api/dto/human-requests.d.ts

@@ -97,3 +97,17 @@ export interface SettleHumanRequestRequest {
     reason?: string;
     actor?: string;
 }
+/** One product page component registered by config or an enabled plugin. */
+export interface PageComponentDTO {
+    kind: string;
+    description?: string;
+    useWhen?: string;
+    doc?: string;
+    /** A display-only product slot contributes no page response. */
+    display?: boolean;
+}
+/** `GET /v1/human/components` — the product page components the runtime's
+ *  config and enabled plugins register, merged in precedence order. */
+export interface PageComponentListDTO {
+    components: PageComponentDTO[];
+}

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

@@ -2,6 +2,9 @@ export declare const MEMORY_SCOPES: readonly ["node", "project", "profile", "use
 export type MemoryScopeName = typeof MEMORY_SCOPES[number];
 /** A canonical document address: slash-joined safe segments, carried as one percent-encoded path segment. */
 export declare function isMemoryDocName(name: string): boolean;
+export interface MemoryOriginConversationDTO {
+    session_file: string;
+}
 export interface MemoryScope {
     node?: string;
     cwd?: string;
@@ -12,6 +15,7 @@ export interface MemoryDocSummaryDTO {
     name: string;
     short_form: string;
     kind: string;
+    privacy: 'public' | 'friends' | 'private';
     scope: MemoryScopeName;
     extensions: Record<string, Record<string, string | boolean | number>>;
     path: string;
@@ -95,6 +99,7 @@ export type MemorySearchHitDTO = MemoryRankedSearchHitDTO | MemoryGrepSearchHitD
 export interface MemoryRankedSearchHitDTO {
     name: string;
     kind: string;
+    privacy: 'public' | 'friends' | 'private';
     scope: MemoryScopeName;
     score: number;
     short_form: string;
@@ -105,6 +110,7 @@ export interface MemoryRankedSearchHitDTO {
 }
 export interface MemoryGrepSearchHitDTO {
     name: string;
+    privacy: 'public' | 'friends' | 'private';
     scope: MemoryScopeName;
     line: number;
     text: string;