@north-light/crouter 0.3.317 → 0.3.319

package/dist/api/client.js

@@ -1,912 +1,2 @@
-// CrtrClient — the typed HTTP+WS client over crtrd's API (spec §3.4).
-//
-// PURITY (spec §3.1): the ONLY runtime imports are Node built-ins
-// (`node:http`, `node:https`, `node:os`, `node:path`) plus `src/api/*`. Never
-// `core/*` / `node:sqlite` / TUI. The daemon-spawn logic lives in `core`/
-// `daemon`, which this module may not import — so autostart is delegated to an
-// injectable `onColdSocket` hook the CLI wires in (spec §7.1). A cold socket
-// always gets one bounded availability observation; the hook only permits spawning.
-//
-// TRANSPORT (spec O-1): `node:http`/`node:https` `request()` — NO `undici`.
-// unix socket via `{ socketPath }`; TCP/remote via a parsed `baseUrl`.
-import { envHomeOverride } from '../shared/env.js';
-import { request as httpRequest } from 'node:http';
-import { request as httpsRequest } from 'node:https';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { ApiError, isErrorBody } from './errors.js';
-import { routes } from './routes.js';
-import { isSafeNodeId } from './dto/common.js';
-import { isSafeBashJobId } from './dto/bash-jobs.js';
-import { isSafeCronId, } from './dto/crons.js';
-/** Filesystem/scope constants mirrored from `core/types.ts` (`CRTR_DIR_NAME`)
- *  and `core/canvas/paths.ts` (`crtrHome`/`apiSocketPath`). Duplicated — not
- *  imported — to keep the exported `/api` contract dependency-light; the two
- *  MUST agree on the resolved socket path. */
-const CRTR_DIR_NAME = '.crouter';
-const SOCKET_BASENAME = 'crtrd.sock';
-/** Resolve crtrd's default unix socket path the same way `apiSocketPath()` does,
- *  via Node built-ins only (no `core/canvas/paths.ts` import). */
-function defaultSocketPath() {
-    const override = envHomeOverride();
-    const home = override !== undefined && override !== ''
-        ? override
-        : join(homedir(), CRTR_DIR_NAME, 'canvas');
-    return join(home, SOCKET_BASENAME);
-}
-const DEFAULT_TIMEOUT_MS = 30_000;
-/** Default bounded window to wait for `/healthz` to come up after
- *  `onColdSocket`, when the caller does not pass `coldStartPollWindowMs`. */
-const HEALTHZ_POLL_WINDOW_MS = 10_000;
-const HEALTHZ_POLL_INTERVAL_MS = 200;
-/** One strict wall-clock availability window shared by local API clients and
- * daemon management. Each probe gets only the budget remaining at its start. */
-export async function waitForDaemonAvailability({ windowMs, probe, initialError, pollIntervalMs = HEALTHZ_POLL_INTERVAL_MS, retry = () => true, now = Date.now, sleep = sleepMs, }) {
-    const deadline = now() + windowMs;
-    let lastError = initialError;
-    for (;;) {
-        const remaining = deadline - now();
-        if (remaining <= 0)
-            throw lastError ?? new Error('crtrd availability window expired without a probe failure');
-        try {
-            await probe(remaining);
-            return;
-        }
-        catch (error) {
-            lastError = error;
-            if (!retry(error))
-                throw error;
-        }
-        const afterProbe = deadline - now();
-        if (afterProbe <= 0)
-            throw lastError;
-        await sleep(Math.min(pollIntervalMs, afterProbe));
-    }
-}
-export class CrtrClient {
-    socketPath;
-    baseUrl;
-    headers;
-    autostart;
-    timeoutMs;
-    onColdSocket;
-    coldStartDiagnostic;
-    coldStartPollWindowMs;
-    /** Guards against invoking the daemon-start hook more than once per client. */
-    coldStartAttempted = false;
-    constructor(opts) {
-        const hasSocket = opts.socketPath !== undefined && opts.socketPath !== '';
-        const hasBaseUrl = opts.baseUrl !== undefined && opts.baseUrl !== '';
-        if (hasSocket === hasBaseUrl) {
-            throw new TypeError('CrtrClient requires exactly one of socketPath | baseUrl');
-        }
-        if (hasSocket)
-            this.socketPath = opts.socketPath;
-        if (hasBaseUrl)
-            this.baseUrl = new URL(opts.baseUrl);
-        this.headers = { ...opts.headers };
-        this.autostart = opts.autostart ?? hasSocket;
-        this.timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-        if (opts.onColdSocket !== undefined)
-            this.onColdSocket = opts.onColdSocket;
-        if (opts.coldStartDiagnostic !== undefined)
-            this.coldStartDiagnostic = opts.coldStartDiagnostic;
-        this.coldStartPollWindowMs = opts.coldStartPollWindowMs ?? HEALTHZ_POLL_WINDOW_MS;
-    }
-    /** Construct a client bound to the default local socket with autostart on. Pass
-     *  `onColdSocket` to enable the daemon-spawn hook (spec §7.1); without it a cold
-     *  socket fails loud with `daemon_unavailable`. */
-    static forLocalSocket(opts) {
-        return new CrtrClient({ socketPath: defaultSocketPath(), autostart: true, ...opts });
-    }
-    // Health / status
-    healthz() {
-        return this.request('GET', routes.healthz());
-    }
-    /** One `/healthz` observation without cold-socket recovery. Availability
-     * waiters own retry policy and pass their remaining wall-clock budget here. */
-    async probeHealthz(timeoutMs) {
-        const response = await this.transport('GET', routes.healthz(), undefined, undefined, timeoutMs);
-        // A restricted daemon is alive and deliberately answers its health DTO with
-        // 503. Preserve that state for daemon startup management instead of treating
-        // the expected non-2xx status as a generic API failure.
-        if (response.status === 503) {
-            try {
-                const health = JSON.parse(response.text);
-                if (typeof health.startup_blocked === 'string')
-                    return health;
-            }
-            catch {
-                // `parse` below reports malformed/non-health 503 responses normally.
-            }
-        }
-        return parse(response);
-    }
-    status() {
-        return this.request('GET', routes.status());
-    }
-    /** Ask the daemon to replace itself with a successor running the currently
-     *  selected runtime generation. Answers before the handover starts, so a
-     *  caller living inside a node the handover will tear down still gets a
-     *  settled result. */
-    restartDaemon() {
-        return this.request('POST', routes.daemonRestart());
-    }
-    admitDaemon() {
-        return this.request('POST', routes.daemonAdmit());
-    }
-    migrateState(req) {
-        return this.request('POST', routes.daemonMigrate(), req);
-    }
-    // Nodes
-    createNode(req) {
-        return this.request('POST', routes.nodes(), req);
-    }
-    /** List canvas nodes with composable row filters. `include: 'activity'` adds
-     * latest/canonical reports and pending-human counts in the same response. */
-    listNodes(q) {
-        return this.request('GET', withQuery(routes.nodes(), q));
-    }
-    getNode(id) {
-        return this.request('GET', routes.node(this.nodePath(id)));
-    }
-    /** Read a node outcome, optionally awaiting it for at most 25 seconds. This
-     * is a GET so the client can safely replay it across daemon handover. */
-    getNodeOutcome(id, { waitSeconds } = {}) {
-        if (waitSeconds !== undefined && (!Number.isInteger(waitSeconds) || waitSeconds < 0 || waitSeconds > 25)) {
-            throw new RangeError('waitSeconds must be an integer between 0 and 25');
-        }
-        return this.request('GET', withQuery(routes.nodeOutcome(this.nodePath(id)), { wait: waitSeconds }));
-    }
-    /** Register or replace an armed target for terminal-outcome delivery. */
-    registerOutcomeDelivery(id, req) {
-        return this.request('PUT', routes.nodeOutcomeDelivery(this.nodePath(id)), req);
-    }
-    getOutcomeDelivery(id) {
-        return this.request('GET', routes.nodeOutcomeDelivery(this.nodePath(id)));
-    }
-    /** Disarm an unsettled outcome-delivery registration. */
-    async disarmOutcomeDelivery(id) {
-        await this.request('DELETE', routes.nodeOutcomeDelivery(this.nodePath(id)));
-    }
-    listBashJobs(id) {
-        return this.request('GET', routes.nodeJobs(this.nodePath(id)));
-    }
-    stopBashJob(id, jobId) {
-        return this.request('DELETE', routes.nodeJob(this.nodePath(id), this.jobPath(jobId)));
-    }
-    sendMessage(id, req) {
-        return this.request('POST', routes.nodeMessages(this.nodePath(id)), req);
-    }
-    /** First-class interrupt (the human Esc): cancels pending undelivered
-     *  human-send inbox entries, then aborts a live in-flight turn. NEVER
-     *  revives a dormant target. */
-    interruptNode(id) {
-        return this.request('POST', routes.nodeInterrupt(this.nodePath(id)), {});
-    }
-    pushReport(id, req) {
-        return this.request('POST', routes.nodeReports(this.nodePath(id)), req);
-    }
-    submitResult(id, req) {
-        return this.request('POST', routes.nodeResult(this.nodePath(id)), req);
-    }
-    forkNode(id) {
-        return this.request('POST', routes.nodeFork(this.nodePath(id)), {});
-    }
-    reviveNode(id, req) {
-        return this.request('POST', routes.nodeRevive(this.nodePath(id)), req ?? {});
-    }
-    relaunchRoot(id) {
-        return this.request('POST', routes.nodeRelaunchRoot(this.nodePath(id)), {});
-    }
-    bindBrokerSession(id, req) {
-        return this.request('POST', routes.nodeBrokerSessionBound(this.nodePath(id)), req);
-    }
-    settleBroker(id, req) {
-        return this.request('POST', routes.nodeBrokerSettle(this.nodePath(id)), req);
-    }
-    completeBrokerPark(id, req) {
-        return this.request('POST', routes.nodeBrokerParkComplete(this.nodePath(id)), req);
-    }
-    recordBrokerParkActivity(id, req) {
-        return this.request('POST', routes.nodeBrokerParkActivity(this.nodePath(id)), req);
-    }
-    claimNodeMail(id, req) {
-        return this.request('POST', routes.nodeMailClaim(this.nodePath(id)), req);
-    }
-    acknowledgeNodeMail(id, req) {
-        return this.request('POST', routes.nodeMailAcknowledge(this.nodePath(id)), req);
-    }
-    recordBrokerTurn(id, req) {
-        return this.request('POST', routes.brokerTurn(this.nodePath(id)), req);
-    }
-    mutateBrokerProviderRetry(id, req) {
-        return this.request('POST', routes.brokerProviderRetry(this.nodePath(id)), req);
-    }
-    mutateBrokerFault(id, req) {
-        return this.request('POST', routes.brokerFault(this.nodePath(id)), req);
-    }
-    getBrokerRecovery(id, expectedExecutionId) {
-        return this.request('GET', `${routes.brokerRecovery(this.nodePath(id))}?expected_execution_id=${encodeURIComponent(expectedExecutionId)}`);
-    }
-    recordNodeFault(id, req) {
-        return this.request('POST', routes.nodeFault(this.nodePath(id)), req);
-    }
-    clearNodeFault(id, opts = {}) {
-        const query = new URLSearchParams();
-        if (opts.link !== undefined)
-            query.set('link', opts.link);
-        if (opts.preserve_episode !== undefined)
-            query.set('preserve_episode', String(opts.preserve_episode));
-        const suffix = query.size === 0 ? '' : `?${query.toString()}`;
-        return this.request('DELETE', `${routes.nodeFault(this.nodePath(id))}${suffix}`);
-    }
-    commitBrokerModel(id, req) {
-        return this.request('POST', routes.nodeBrokerModel(this.nodePath(id)), req);
-    }
-    brokerExtensionState(id) {
-        return this.request('GET', routes.nodeBrokerExtensionState(this.nodePath(id)));
-    }
-    commitBrokerGeneratedName(id, req) {
-        return this.request('POST', routes.nodeBrokerGeneratedName(this.nodePath(id)), req);
-    }
-    commitBrokerPersonaAck(id, req) {
-        return this.request('POST', routes.nodeBrokerPersonaAck(this.nodePath(id)), req);
-    }
-    closeNode(id, req) {
-        return this.request('POST', routes.nodeClose(this.nodePath(id)), req ?? {});
-    }
-    recycleNode(id) {
-        return this.request('POST', routes.nodeRecycle(this.nodePath(id)), {});
-    }
-    demoteNode(id) {
-        return this.request('POST', routes.nodeDemote(this.nodePath(id)), {});
-    }
-    promoteNode(id, req) {
-        return this.request('POST', routes.nodePromote(this.nodePath(id)), req);
-    }
-    yieldNode(id, req) {
-        return this.request('POST', routes.nodeYield(this.nodePath(id)), req);
-    }
-    waitNode(id, req) {
-        return this.request('POST', routes.nodeWait(this.nodePath(id)), req);
-    }
-    patchConfig(id, patch) {
-        return this.request('PATCH', routes.nodeConfig(this.nodePath(id)), patch);
-    }
-    /** 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
-     *  crtrd is the repo host (same principle as spawnChild's creation git). */
-    closeWorktree(id) {
-        return this.request('POST', routes.nodeWorktreeClose(this.nodePath(id)), {});
-    }
-    abandonWorktree(id, req) {
-        return this.request('POST', routes.nodeWorktreeAbandon(this.nodePath(id)), req);
-    }
-    listQuarantinedWorktrees() {
-        return this.request('GET', routes.quarantinedWorktrees());
-    }
-    subscribe(id, req) {
-        return this.request('POST', routes.nodeSubscriptions(this.nodePath(id)), req);
-    }
-    // Focuses (viewer registry)
-    // The tmux verbs that open/move/close a viewer pane run LOCALLY in the
-    // caller's session (placement-tmux); only the canvas.db focus rows route here.
-    // Reads GC lazily server-side, so a returned row is always live; a `null` body
-    // is the normal "no viewer" answer, not a 404.
-    listFocuses() {
-        return this.request('GET', routes.focuses());
-    }
-    focusOf(nodeId) {
-        return this.request('GET', withQuery(routes.focusByNode(), { node_id: nodeId }));
-    }
-    focusByPane(pane) {
-        return this.request('GET', withQuery(routes.focusByPane(), { pane }));
-    }
-    registerFocus(req) {
-        return this.request('POST', routes.focuses(), req);
-    }
-    async setFocusPane(focusId, req) {
-        await this.request('PATCH', routes.focus(focusId), req);
-    }
-    async closeFocus(focusId) {
-        await this.request('DELETE', routes.focus(focusId));
-    }
-    async unsubscribe(id, target) {
-        await this.request('DELETE', routes.nodeSubscription(this.nodePath(id), this.nodePath(target)));
-    }
-    /** Arm one cron (`POST /v1/crons`) — the server mints the cron_id. */
-    armCron(req) {
-        return this.request('POST', routes.crons(), req);
-    }
-    /** Crons visible to the caller (`GET /v1/crons`). With `q.profile` that is
-     *  that profile's crons plus every global one; omit it only for a
-     *  canvas-home-wide provenance read ("which crons did node X arm"). */
-    listCrons(q) {
-        return this.request('GET', withQuery(routes.crons(), q));
-    }
-    /** One cron with its run-log ring (`GET /v1/crons/:cronId`). */
-    showCron(cronId, q) {
-        return this.request('GET', withQuery(routes.cron(this.cronPath(cronId)), q));
-    }
-    /** Pause one cron (`POST /v1/crons/:cronId/pause`) — stops firing, keeps config+history. */
-    pauseCron(cronId, q) {
-        return this.request('POST', withQuery(routes.cronPause(this.cronPath(cronId)), q), {});
-    }
-    /** Resume one paused cron (`POST /v1/crons/:cronId/resume`). */
-    resumeCron(cronId, q) {
-        return this.request('POST', withQuery(routes.cronResume(this.cronPath(cronId)), q), {});
-    }
-    /** Run one cron NOW, out of band (`POST /v1/crons/:cronId/run`) — synchronous:
-     *  resolves with the settled run record after the subprocess closes. Does not
-     *  advance the schedule or consume a one-shot; never escalates. */
-    runCron(cronId, q) {
-        return this.request('POST', withQuery(routes.cronRun(this.cronPath(cronId)), q), {});
-    }
-    /** Cancel one cron (`DELETE /v1/crons/:cronId`, idempotent). */
-    async cancelCron(cronId, q) {
-        await this.request('DELETE', withQuery(routes.cron(this.cronPath(cronId)), q));
-    }
-    /** Bare eligibility poke (`POST /v1/crons/poke`): re-dues every held active
-     *  cron now — "something changed; re-check now". Canvas-wide, label-free,
-     *  idempotent, and free when nothing is held. */
-    pokeCrons() {
-        return this.request('POST', routes.cronsPoke(), {});
-    }
-    ensureAttach(id, req) {
-        return this.request('POST', routes.nodeAttach(this.nodePath(id)), req ?? {});
-    }
-    // Reads / feed
-    getReports(id, q) {
-        return this.request('GET', withQuery(routes.nodeReports(this.nodePath(id)), q));
-    }
-    getTranscript(id, q) {
-        return this.request('GET', withQuery(routes.nodeTranscript(this.nodePath(id)), q));
-    }
-    getSnapshot(id) {
-        return this.request('GET', routes.nodeSnapshot(this.nodePath(id)));
-    }
-    /** The node-config subject substrate gates evaluate against. */
-    nodeSubject(id) {
-        return this.request('GET', routes.nodeSubject(this.nodePath(id)));
-    }
-    getNodeMessages(id, q) {
-        return this.request('GET', withQuery(routes.nodeMessages(this.nodePath(id)), q));
-    }
-    /** The node's conversation exactly as it ran — raw `.jsonl` bytes plus the
-     *  assembled system prompt. For exports; `getSnapshot` is for renderers. */
-    getSession(id) {
-        return this.request('GET', routes.nodeSession(this.nodePath(id)));
-    }
-    /** What a non-terminal chat surface may offer for this node: the chat-capable
-     *  slash commands its live engine registered, and the memory documents an
-     *  inline `/name` token resolves to. Never revives — a node whose broker is
-     *  not live answers `broker_live: false` with empty arrays. */
-    getChatInventory(id) {
-        return this.request('GET', routes.nodeChatInventory(this.nodePath(id)));
-    }
-    getProspectiveChatInventory(q) {
-        return this.request('GET', withQuery(routes.prospectiveChatInventory(), q));
-    }
-    getArtifacts(id, q) {
-        return this.request('GET', withQuery(routes.nodeArtifacts(this.nodePath(id)), q));
-    }
-    getContext(id) {
-        return this.request('GET', routes.nodeContext(this.nodePath(id)));
-    }
-    // Host file read
-    /** Read an absolute host path as UTF-8 (capped, `truncated` when clipped) for
-     *  the browser file-peek panel. */
-    peekFile(path) {
-        return this.request('GET', withQuery(routes.filePeek(), { path }));
-    }
-    // Memory documents
-    /** 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 }));
-    }
-    // Profiles
-    /** Create-or-return by name. Supplied `projects` are shape-checked even when
-     *  the profile already exists; their directories are only required to exist
-     *  when this call creates the profile. */
-    ensureProfile(name, req) {
-        return this.request('PUT', routes.profile(name), req ?? {});
-    }
-    listProfiles() {
-        return this.request('GET', routes.profiles());
-    }
-    getProfile(name) {
-        return this.request('GET', routes.profile(name));
-    }
-    pauseProfile(name) {
-        return this.request('POST', routes.profilePause(name), {});
-    }
-    resumeProfile(name) {
-        return this.request('POST', routes.profileResume(name), {});
-    }
-    /** Merge and remove entries in a profile's metadata map. */
-    updateProfileMetadata(name, req) {
-        return this.request('PATCH', routes.profileMetadata(name), req);
-    }
-    /** Force-delete or detach one profile by exact id or unique name. */
-    deleteProfile(name, req) {
-        return this.request('DELETE', routes.profile(name), req);
-    }
-    // Model auth
-    listModelAuth() {
-        return this.request('GET', routes.modelAuths());
-    }
-    installCredential(provider, req) {
-        return this.request('PUT', routes.modelAuth(provider), req);
-    }
-    removeCredential(provider) {
-        return this.request('DELETE', routes.modelAuth(provider));
-    }
-    // Daemon-owned document reviews and comments
-    createReview(req) {
-        return this.request('POST', routes.humanReviews(), req);
-    }
-    listReviews(query) {
-        return this.request('GET', withQuery(routes.humanReviews(), query));
-    }
-    getReview(reviewId) {
-        return this.request('GET', routes.humanReview(this.reviewPath(reviewId)));
-    }
-    submitReview(reviewId) {
-        return this.request('POST', routes.humanReviewSubmit(this.reviewPath(reviewId)), {});
-    }
-    cancelReview(reviewId, req = {}) {
-        return this.request('POST', routes.humanReviewCancel(this.reviewPath(reviewId)), req);
-    }
-    getReviewDocumentBase(reviewId) {
-        return this.request('GET', routes.humanReviewDocument(this.reviewPath(reviewId)));
-    }
-    createReviewComment(reviewId, req) {
-        const path = reviewId === undefined ? 'self' : this.reviewPath(reviewId);
-        return this.request('POST', routes.humanReviewComments(path), req);
-    }
-    listReviewComments(reviewId, query) {
-        const path = reviewId === undefined ? 'self' : this.reviewPath(reviewId);
-        return this.request('GET', withQuery(routes.humanReviewComments(path), query));
-    }
-    readReviewCommentEvents(reviewId, query) {
-        return this.request('GET', withQuery(routes.humanReviewCommentEvents(this.reviewPath(reviewId)), query));
-    }
-    updateReviewCommentRanges(reviewId, req) {
-        return this.request('POST', routes.humanReviewCommentRanges(this.reviewPath(reviewId)), req);
-    }
-    getReviewComment(commentId) {
-        return this.request('GET', routes.humanComment(this.commentPath(commentId)));
-    }
-    editReviewComment(commentId, req) {
-        return this.request('POST', routes.humanCommentEdit(this.commentPath(commentId)), req);
-    }
-    resolveReviewComment(commentId, req = {}) {
-        return this.request('POST', routes.humanCommentResolve(this.commentPath(commentId)), req);
-    }
-    reopenReviewComment(commentId, req = {}) {
-        return this.request('POST', routes.humanCommentReopen(this.commentPath(commentId)), req);
-    }
-    deleteReviewComment(commentId, req = {}) {
-        return this.request('POST', routes.humanCommentDelete(this.commentPath(commentId)), req);
-    }
-    // ---- Humanloop inbox (Northlight crouter-inbox v1, inbox-contract.md §A) --
-    /** Pending page/review tickets across every available crouter-owned
-     *  humanloop root. */
-    listHumanInbox() {
-        return this.request('GET', routes.humanInbox());
-    }
-    /** Read one page ticket by its opaque ticket id (pending, resolved, or canceled). */
-    getHumanInboxPage(ticketId) {
-        return this.request('GET', routes.humanInboxTicket(this.ticketId(ticketId)));
-    }
-    /** All page tickets, oldest first (pending, resolved, or canceled) —
-     *  home-wide, or narrowed to one raising node when `nodeId` is given. */
-    getInboxHistory(nodeId) {
-        if (nodeId === undefined) {
-            return this.request('GET', routes.humanInbox() + '/history');
-        }
-        if (typeof nodeId !== 'string' || nodeId === '') {
-            throw new TypeError(`invalid node id: ${JSON.stringify(nodeId)}`);
-        }
-        return this.request('GET', withQuery(routes.humanInbox() + '/history', { node_id: nodeId }));
-    }
-    /** Submit responses for a page ticket. Single-assignment server-side: a competing
-     *  resolution races to `ticket_already_resolved`. */
-    respondHumanInboxPage(ticketId, request) {
-        return this.request('POST', routes.humanInboxRespond(this.ticketId(ticketId)), request);
-    }
-    /** Autosave partial page work. Omitted slots are permitted in progress updates. */
-    postInboxProgress(ticketId, responses) {
-        return this.request('POST', routes.humanInboxProgress(this.ticketId(ticketId)), { responses });
-    }
-    /** Get the published response for a resolved page ticket. 404 if pending or canceled. */
-    getInboxResponse(ticketId) {
-        return this.request('GET', routes.humanInboxResponse(this.ticketId(ticketId)));
-    }
-    /** Cancel a ticket (terminal response, never deletion). */
-    cancelHumanInboxTicket(ticketId, request) {
-        return this.request('POST', routes.humanInboxCancel(this.ticketId(ticketId)), request ?? {});
-    }
-    // Durable programmatic human requests
-    /** Create one durable human request. The minted `request_id` identifies the
-     *  request; inbox presentation has its own ticket id. An unresolvable
-     *  `action.name` is rejected before the page is published, leaving no inbox
-     *  row behind. */
-    createHumanRequest(request) {
-        return this.request('POST', routes.humanRequests(), request);
-    }
-    /** Read one request: its current state, its answer when answered, and the
-     *  delivery state of its completion action when it bound one. */
-    getHumanRequest(requestId) {
-        return this.request('GET', routes.humanRequest(this.requestPath(requestId)));
-    }
-    /** Revise a pending request's page in place. Identity, provenance, and the
-     *  frozen action binding are preserved; a settled request refuses. */
-    replaceHumanRequest(requestId, request) {
-        return this.request('POST', routes.humanRequestReplace(this.requestPath(requestId)), request);
-    }
-    /** Settle a request `answered` programmatically. Races a human answer to the
-     *  same first-writer-wins result. */
-    respondHumanRequest(requestId, request) {
-        return this.request('POST', routes.humanRequestRespond(this.requestPath(requestId)), request);
-    }
-    /** The recipient surface closing a request without answering. */
-    dismissHumanRequest(requestId, request = {}) {
-        return this.request('POST', routes.humanRequestDismiss(this.requestPath(requestId)), request);
-    }
-    /** The requester withdrawing its own request. */
-    cancelHumanRequest(requestId, request = {}) {
-        return this.request('POST', routes.humanRequestCancel(this.requestPath(requestId)), request);
-    }
-    /** Resolve one page feedback comment — the bound companion's report that it
-     *  has been dealt with. `nodeId` names the caller; the daemon refuses any
-     *  node but the ticket's companion. Terminal for the comment; appends no
-     *  chat turn. */
-    resolvePageFeedbackComment(ticketId, commentId, nodeId) {
-        if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/.test(commentId)) {
-            throw new TypeError(`invalid feedback comment id: ${JSON.stringify(commentId)}`);
-        }
-        return this.request('POST', routes.humanInboxFeedbackResolve(this.ticketId(ticketId), commentId), { node_id: nodeId });
-    }
-    // Canvas reads / maintenance
-    /** Composed client-side from `GET /v1/nodes` + `GET /v1/status` (spec §6.3 —
-     *  the dashboard is absorbed into those two reads; there is no single route).
-     *  `generated_at` is the client-side capture instant of the composition. */
-    async dashboard(q) {
-        const listQuery = q?.under !== undefined ? { under: q.under } : undefined;
-        const [nodes, status] = await Promise.all([this.listNodes(listQuery), this.status()]);
-        return { nodes, counts: status.node_counts, generated_at: new Date().toISOString() };
-    }
-    attention() {
-        return this.request('GET', routes.canvasAttention());
-    }
-    /** Per-node pending-ticket counts for a bounded viewer slice. */
-    attentionCounts(node_ids) {
-        const body = { node_ids };
-        return this.request('POST', routes.canvasAttentionCounts(), body);
-    }
-    /** Ranked/filtered content search over the per-cwd episodic corpus
-     *  (`crtr canvas history search`). Optional query: ranked when present,
-     *  recency browse when omitted. POST-bodied — the query carries arrays and
-     *  free text; the whole search executes server-side (spec §6.3). */
-    historySearch(q) {
-        return this.request('POST', routes.canvasHistorySearch(), q);
-    }
-    /** Required-pattern line-hit search over the per-cwd episodic corpus
-     *  (`crtr canvas history grep`). Distinct stable schema from `historySearch`
-     *  — POST-bodied for the same reasons. */
-    historyGrep(q) {
-        return this.request('POST', routes.canvasHistoryGrep(), q);
-    }
-    /** Resolve one `<node-id>:<relpath>` history ref to its full body
-     *  (`crtr canvas history read`). */
-    historyRead(q) {
-        return this.request('GET', withQuery(routes.canvasHistoryRead(), q));
-    }
-    /** Grouped-count projection over the per-cwd episodic corpus
-     *  (`crtr canvas history stats`). Same filters as search/grep, aggregate
-     *  result instead of a hit page — POST-bodied for the same reasons. */
-    historyStats(q) {
-        return this.request('POST', routes.canvasHistoryStats(), q);
-    }
-    /** The machine-readable browser canvas roster (`crtr canvas snapshot`) —
-     *  distinct from the per-node `getSnapshot`. */
-    canvasSnapshot() {
-        return this.request('GET', routes.canvasSnapshot());
-    }
-    /** 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
-     *  enriched on-demand view. */
-    canvasRoster() {
-        return this.request('GET', routes.canvasRoster());
-    }
-    prune(req) {
-        return this.request('POST', routes.canvasPrune(), req);
-    }
-    // Escape hatch
-    /** Raw request for routes not yet method-wrapped. Applies the same
-     *  autostart + error-mapping semantics. */
-    async request(method, path, body) {
-        return parse(await this.send(method, path, body));
-    }
-    /** The unparsed request: cold-socket and interrupted-response recovery, no
-     * JSON parse. Every wrapper goes through here; only non-JSON routes call it directly. */
-    async send(method, path, body, extraHeaders) {
-        try {
-            return await this.transport(method, path, body, extraHeaders);
-        }
-        catch (err) {
-            if (this.isColdSocketError(err)) {
-                try {
-                    await this.handleColdSocket(err);
-                    return await this.transport(method, path, body, extraHeaders);
-                }
-                catch (recoveryError) {
-                    throw toTransportApiError(recoveryError);
-                }
-            }
-            if (this.isInterruptedSocketError(err))
-                return await this.rideOutInterruptedRequest(method, path, body, extraHeaders);
-            throw toTransportApiError(err);
-        }
-    }
-    // internals
-    nodePath(id) {
-        if (!isSafeNodeId(id)) {
-            throw new ApiError(400, 'invalid_node_id', `invalid node id: ${JSON.stringify(id)}`);
-        }
-        return id;
-    }
-    /** Validate a background job id before route construction. Job ids arrive
-     *  from the daemon's file-backed roster and must remain one path segment. */
-    jobPath(id) {
-        if (!isSafeBashJobId(id)) {
-            throw new ApiError(400, 'invalid_job_id', `invalid background job id: ${JSON.stringify(id)}`);
-        }
-        return id;
-    }
-    /** Validate a cron id before route construction — `routes.ts` interpolates
-     *  it raw, so a value carrying `/`, whitespace or `?` would corrupt the
-     *  request line rather than 404 cleanly. Mirrors `nodePath`. */
-    cronPath(id) {
-        if (!isSafeCronId(id)) {
-            throw new ApiError(400, 'invalid_cron_id', `invalid cron id: ${JSON.stringify(id)}`);
-        }
-        return id;
-    }
-    /** Validate a request id before route construction. Requests use the daemon's
-     * node-id-shaped identifiers, while inbox presentation uses a separate ticket
-     * id. A malformed request id is a server-rejectable request. */
-    requestPath(id) {
-        if (!isSafeNodeId(id)) {
-            throw new ApiError(400, 'invalid_request_id', `invalid request id: ${JSON.stringify(id)}`);
-        }
-        return id;
-    }
-    /** Validate an opaque inbox ticket id before route construction. A local
-     *  shape violation is a caller bug, not a server-rejectable request — throws
-     *  `TypeError` (matching the existing safe-segment discipline of a local
-     *  precondition, distinct from `nodePath`'s `ApiError` because that one IS a
-     *  request the server could plausibly receive and reject itself). */
-    ticketId(id) {
-        if (!/^[a-f0-9]{64}$/.test(id)) {
-            throw new TypeError(`invalid inbox ticket id: ${JSON.stringify(id)}`);
-        }
-        return id;
-    }
-    /** Validate a review id before route construction (D-A6). Reviews are minted
-     *  and addressed like node ids, but arrive from agent argv, so a malformed
-     *  one is a plausible request the server would also reject — `ApiError`,
-     *  not `TypeError`, matching `nodePath`. */
-    reviewPath(id) {
-        if (!isSafeNodeId(id)) {
-            throw new ApiError(400, 'invalid_review_id', `invalid review id: ${JSON.stringify(id)}`);
-        }
-        return id;
-    }
-    /** Validate a comment id before route construction (D-A6). Comment ids are
-     *  daemon-minted 32-char lowercase hex, but — like `reviewPath` — arrive from
-     *  agent argv, so a bad one is a plausible request the server would also
-     *  reject, not a caller-bug `TypeError` like `ticketId`. */
-    commentPath(id) {
-        if (!/^[a-f0-9]{32}$/.test(id)) {
-            throw new ApiError(400, 'invalid_comment_id', `invalid comment id: ${JSON.stringify(id)}`);
-        }
-        return id;
-    }
-    transport(method, path, body, extraHeaders, timeoutMs = this.timeoutMs) {
-        const usingHttps = this.baseUrl?.protocol === 'https:';
-        const doRequest = usingHttps ? httpsRequest : httpRequest;
-        const payload = body === undefined ? undefined : JSON.stringify(body);
-        const headers = { accept: 'application/json', ...this.headers, ...extraHeaders };
-        if (payload !== undefined) {
-            headers['content-type'] = 'application/json';
-            headers['content-length'] = String(Buffer.byteLength(payload));
-        }
-        const options = {
-            method,
-            path,
-            headers,
-            timeout: timeoutMs,
-        };
-        if (this.socketPath !== undefined) {
-            options.socketPath = this.socketPath;
-        }
-        else if (this.baseUrl !== undefined) {
-            options.protocol = this.baseUrl.protocol;
-            options.hostname = this.baseUrl.hostname;
-            if (this.baseUrl.port !== '')
-                options.port = this.baseUrl.port;
-        }
-        return new Promise((resolve, reject) => {
-            const req = doRequest(options, (res) => {
-                const chunks = [];
-                res.on('data', (chunk) => chunks.push(chunk));
-                res.on('end', () => {
-                    const received = {};
-                    for (const [name, value] of Object.entries(res.headers)) {
-                        if (value !== undefined)
-                            received[name] = Array.isArray(value) ? value.join(', ') : value;
-                    }
-                    resolve({ status: res.statusCode ?? 0, text: Buffer.concat(chunks).toString('utf8'), headers: received });
-                });
-                res.on('error', reject);
-            });
-            req.on('error', reject);
-            req.on('timeout', () => {
-                req.destroy(Object.assign(new Error('request timed out'), { code: 'ETIMEDOUT' }));
-            });
-            if (payload !== undefined)
-                req.write(payload);
-            req.end();
-        });
-    }
-    isColdSocketError(err) {
-        if (this.socketPath === undefined)
-            return false;
-        const code = err?.code;
-        return code === 'ECONNREFUSED' || code === 'ENOENT' || code === 'ENOTSOCK';
-    }
-    /** A connection torn down MID-request (Node's "socket hang up" / a broken
-     * pipe). It establishes only that the response was interrupted, not why. */
-    isInterruptedSocketError(err) {
-        if (this.socketPath === undefined)
-            return false;
-        const code = err?.code;
-        return code === 'ECONNRESET' || code === 'EPIPE';
-    }
-    /** Wait for the local API after an interrupted response. GET/HEAD can retry
-     * because they are idempotent. A mutation may already have been applied, so
-     * it never replays. */
-    async rideOutInterruptedRequest(method, path, body, extraHeaders) {
-        try {
-            await this.awaitAvailability();
-        }
-        catch (error) {
-            throw toTransportApiError(error);
-        }
-        if (method !== 'GET' && method !== 'HEAD') {
-            throw new ApiError(503, 'daemon_request_interrupted', `crtrd connection ended before this ${method} response; the request may or may not have been applied.`);
-        }
-        try {
-            return await this.transport(method, path, body, extraHeaders);
-        }
-        catch (err) {
-            throw toTransportApiError(err);
-        }
-    }
-    async awaitAvailability(initialError) {
-        await waitForDaemonAvailability({
-            windowMs: this.coldStartPollWindowMs,
-            initialError,
-            probe: async (timeoutMs) => {
-                const response = await this.transport('GET', routes.healthz(), undefined, undefined, timeoutMs);
-                if (response.status >= 200 && response.status < 300)
-                    return;
-                try {
-                    const health = JSON.parse(response.text);
-                    if (typeof health.startup_blocked === 'string')
-                        return;
-                }
-                catch {
-                    // The normal unavailable error below carries the response body.
-                }
-                throw new ApiError(response.status, 'daemon_health_unavailable', `crtrd health check returned HTTP ${response.status}: ${response.text.slice(0, 500)}`);
-            },
-        });
-    }
-    /** Optionally start the daemon, then observe availability before retrying the
-     * request. Waiting is independent from permission to spawn: externally
-     * managed daemons still get the same bounded readiness window. */
-    async handleColdSocket(initialError) {
-        const startedHere = this.autostart && this.onColdSocket !== undefined && !this.coldStartAttempted;
-        if (startedHere) {
-            this.coldStartAttempted = true;
-            await this.onColdSocket();
-        }
-        try {
-            await this.awaitAvailability(initialError);
-        }
-        catch (error) {
-            if (startedHere) {
-                const diagnostic = safeColdStartDiagnostic(this.coldStartDiagnostic);
-                if (diagnostic !== undefined) {
-                    const transportError = toTransportApiError(error);
-                    throw new ApiError(transportError.status, transportError.code, `${transportError.message}\n${diagnostic}`);
-                }
-            }
-            throw error;
-        }
-    }
-}
-/** Append defined query params to a path. Kept in the client (not `routes.ts`,
- *  which stays logic-free). Undefined/null values are skipped. */
-function withQuery(base, query) {
-    if (query === undefined)
-        return base;
-    const params = new URLSearchParams();
-    for (const [key, value] of Object.entries(query)) {
-        if (value !== undefined && value !== null)
-            params.set(key, String(value));
-    }
-    const qs = params.toString();
-    return qs === '' ? base : `${base}?${qs}`;
-}
-/** Parse a raw response into `T`, or throw `ApiError` on non-2xx. A 204/empty
- *  body yields `undefined` (callers that type `void`/optional handle it). */
-function parse(res) {
-    const ok = res.status >= 200 && res.status < 300;
-    const trimmed = res.text.trim();
-    let payload;
-    if (trimmed !== '') {
-        try {
-            payload = JSON.parse(trimmed);
-        }
-        catch {
-            if (ok)
-                return undefined;
-            throw new ApiError(res.status, 'invalid_response', res.text.slice(0, 500));
-        }
-    }
-    if (ok)
-        return payload;
-    if (isErrorBody(payload)) {
-        throw new ApiError(res.status, payload.error.code, payload.error.message, payload.error.details);
-    }
-    throw new ApiError(res.status, 'internal', `request failed with status ${res.status}`);
-}
-/** Map a transport-layer throw (never an HTTP status) to an `ApiError`. A
- *  connection refusal here means the daemon is unreachable and autostart could
- *  not recover it. */
-function toTransportApiError(err) {
-    if (err instanceof ApiError)
-        return err;
-    const code = err?.code;
-    const message = err instanceof Error ? err.message : String(err);
-    if (code === 'ECONNREFUSED' || code === 'ENOENT' || code === 'ENOTSOCK') {
-        return new ApiError(503, 'daemon_unavailable', `crtrd is not reachable: ${message}`);
-    }
-    if (code === 'ETIMEDOUT') {
-        // A per-request timeout against a REACHABLE daemon is not "crtrd not running"
-        // (§8 reserves daemon_unavailable for unreachable/autostart-failed).
-        return new ApiError(504, 'request_timeout', `crtrd request timed out: ${message}`);
-    }
-    return new ApiError(503, 'transport_error', message);
-}
-function sleepMs(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-export function safeColdStartDiagnostic(hook) {
-    if (hook === undefined)
-        return undefined;
-    try {
-        return hook();
-    }
-    catch {
-        return undefined;
-    }
-}
+var b=Object.defineProperty;var d=(n,e)=>b(n,"name",{value:e,configurable:!0});import{envHomeOverride as C}from"../shared/env.js";import{request as G}from"node:http";import{request as N}from"node:https";import{homedir as _}from"node:os";import{join as k}from"node:path";import{ApiError as u,isErrorBody as A}from"./errors.js";import{routes as r}from"./routes.js";import{isSafeNodeId as p}from"./dto/common.js";import{isSafeBashJobId as D}from"./dto/bash-jobs.js";import{isSafeCronId as I}from"./dto/crons.js";const x=".crouter",M="crtrd.sock";function B(){const n=C(),e=n!==void 0&&n!==""?n:k(_(),x,"canvas");return k(e,M)}d(B,"defaultSocketPath");const H=3e4,$=1e4,U=200;async function L({windowMs:n,probe:e,initialError:t,pollIntervalMs:s=U,retry:o=d(()=>!0,"retry"),now:a=Date.now,sleep:h=F}){const P=a()+n;let c=t;for(;;){const m=P-a();if(m<=0)throw c??new Error("crtrd availability window expired without a probe failure");try{await e(m);return}catch(f){if(c=f,!o(f))throw f}const l=P-a();if(l<=0)throw c;await h(Math.min(s,l))}}d(L,"waitForDaemonAvailability");class R{static{d(this,"CrtrClient")}socketPath;baseUrl;headers;autostart;timeoutMs;onColdSocket;coldStartDiagnostic;coldStartPollWindowMs;coldStartAttempted=!1;constructor(e){const t=e.socketPath!==void 0&&e.socketPath!=="",s=e.baseUrl!==void 0&&e.baseUrl!=="";if(t===s)throw new TypeError("CrtrClient requires exactly one of socketPath | baseUrl");t&&(this.socketPath=e.socketPath),s&&(this.baseUrl=new URL(e.baseUrl)),this.headers={...e.headers},this.autostart=e.autostart??t,this.timeoutMs=e.timeoutMs??H,e.onColdSocket!==void 0&&(this.onColdSocket=e.onColdSocket),e.coldStartDiagnostic!==void 0&&(this.coldStartDiagnostic=e.coldStartDiagnostic),this.coldStartPollWindowMs=e.coldStartPollWindowMs??$}static forLocalSocket(e){return new R({socketPath:B(),autostart:!0,...e})}healthz(){return this.request("GET",r.healthz())}async probeHealthz(e){const t=await this.transport("GET",r.healthz(),void 0,void 0,e);if(t.status===503)try{const s=JSON.parse(t.text);if(typeof s.startup_blocked=="string")return s}catch{}return y(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",i(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",i(r.nodeOutcome(this.nodePath(e)),{wait:t}),void 0,(t??0)*1e3+this.timeoutMs)}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)}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 o=s.size===0?"":`?${s.toString()}`;return this.request("DELETE",`${r.nodeFault(this.nodePath(e))}${o}`)}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",i(r.focusByNode(),{node_id:e}))}focusByPane(e){return this.request("GET",i(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",i(r.crons(),e))}showCron(e,t){return this.request("GET",i(r.cron(this.cronPath(e)),t))}pauseCron(e,t){return this.request("POST",i(r.cronPause(this.cronPath(e)),t),{})}resumeCron(e,t){return this.request("POST",i(r.cronResume(this.cronPath(e)),t),{})}runCron(e,t){return this.request("POST",i(r.cronRun(this.cronPath(e)),t),{})}async cancelCron(e,t){await this.request("DELETE",i(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",i(r.nodeReports(this.nodePath(e)),t))}getTranscript(e,t){return this.request("GET",i(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",i(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",i(r.prospectiveChatInventory(),e))}getArtifacts(e,t){return this.request("GET",i(r.nodeArtifacts(this.nodePath(e)),t))}getContext(e){return this.request("GET",r.nodeContext(this.nodePath(e)))}peekFile(e){return this.request("GET",i(r.filePeek(),{path:e}))}resolveMemoryDoc(e,t){return this.request("GET",i(r.memoryResolve(),{name:e,node: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())}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",i(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",i(r.humanReviewComments(s),t))}readReviewCommentEvents(e,t){return this.request("GET",i(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)}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",i(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,o]=await Promise.all([this.listNodes(t),this.status()]);return{nodes:s,counts:o.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",i(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())}prune(e){return this.request("POST",r.canvasPrune(),e)}async request(e,t,s,o){return y(await this.send(e,t,s,void 0,o))}async send(e,t,s,o,a){try{return await this.transport(e,t,s,o,a)}catch(h){if(this.isColdSocketError(h))try{return await this.handleColdSocket(h),await this.transport(e,t,s,o,a)}catch(P){throw S(P)}if(this.isInterruptedSocketError(h))return await this.rideOutInterruptedRequest(e,t,s,o,a);throw S(h)}}nodePath(e){if(!p(e))throw new u(400,"invalid_node_id",`invalid node id: ${JSON.stringify(e)}`);return e}jobPath(e){if(!D(e))throw new u(400,"invalid_job_id",`invalid background job id: ${JSON.stringify(e)}`);return e}cronPath(e){if(!I(e))throw new u(400,"invalid_cron_id",`invalid cron id: ${JSON.stringify(e)}`);return e}requestPath(e){if(!p(e))throw new u(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(!p(e))throw new u(400,"invalid_review_id",`invalid review id: ${JSON.stringify(e)}`);return e}commentPath(e){if(!/^[a-f0-9]{32}$/.test(e))throw new u(400,"invalid_comment_id",`invalid comment id: ${JSON.stringify(e)}`);return e}transport(e,t,s,o,a=this.timeoutMs){const P=this.baseUrl?.protocol==="https:"?N:G,c=s===void 0?void 0:JSON.stringify(s),m={accept:"application/json",...this.headers,...o};c!==void 0&&(m["content-type"]="application/json",m["content-length"]=String(Buffer.byteLength(c)));const l={method:e,path:t,headers:m,timeout:a};return this.socketPath!==void 0?l.socketPath=this.socketPath:this.baseUrl!==void 0&&(l.protocol=this.baseUrl.protocol,l.hostname=this.baseUrl.hostname,this.baseUrl.port!==""&&(l.port=this.baseUrl.port)),new Promise((f,v)=>{const q=P(l,T=>{const O=[];T.on("data",E=>O.push(E)),T.on("end",()=>{const E={};for(const[g,w]of Object.entries(T.headers))w!==void 0&&(E[g]=Array.isArray(w)?w.join(", "):w);f({status:T.statusCode??0,text:Buffer.concat(O).toString("utf8"),headers:E})}),T.on("error",v)});q.on("error",v),q.on("timeout",()=>{q.destroy(Object.assign(new Error("request timed out"),{code:"ETIMEDOUT"}))}),c!==void 0&&q.write(c),q.end()})}isColdSocketError(e){if(this.socketPath===void 0)return!1;const t=e?.code;return t==="ECONNREFUSED"||t==="ENOENT"||t==="ENOTSOCK"}isInterruptedSocketError(e){if(this.socketPath===void 0)return!1;const t=e?.code;return t==="ECONNRESET"||t==="EPIPE"}async rideOutInterruptedRequest(e,t,s,o,a){try{await this.awaitAvailability()}catch(h){throw S(h)}if(e!=="GET"&&e!=="HEAD")throw new u(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,o,a)}catch(h){throw S(h)}}async awaitAvailability(e){await L({windowMs:this.coldStartPollWindowMs,initialError:e,probe:d(async t=>{const s=await this.transport("GET",r.healthz(),void 0,void 0,t);if(!(s.status>=200&&s.status<300)){try{if(typeof JSON.parse(s.text).startup_blocked=="string")return}catch{}throw new u(s.status,"daemon_health_unavailable",`crtrd health check returned HTTP ${s.status}: ${s.text.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 o=J(this.coldStartDiagnostic);if(o!==void 0){const a=S(s);throw new u(a.status,a.code,`${a.message}
+${o}`)}}throw s}}}function i(n,e){if(e===void 0)return n;const t=new URLSearchParams;for(const[o,a]of Object.entries(e))a!=null&&t.set(o,String(a));const s=t.toString();return s===""?n:`${n}?${s}`}d(i,"withQuery");function y(n){const e=n.status>=200&&n.status<300,t=n.text.trim();let s;if(t!=="")try{s=JSON.parse(t)}catch{if(e)return;throw new u(n.status,"invalid_response",n.text.slice(0,500))}if(e)return s;throw A(s)?new u(n.status,s.error.code,s.error.message,s.error.details):new u(n.status,"internal",`request failed with status ${n.status}`)}d(y,"parse");function S(n){if(n instanceof u)return n;const e=n?.code,t=n instanceof Error?n.message:String(n);return e==="ECONNREFUSED"||e==="ENOENT"||e==="ENOTSOCK"?new u(503,"daemon_unavailable",`crtrd is not reachable: ${t}`):e==="ETIMEDOUT"?new u(504,"request_timeout",`crtrd request timed out: ${t}`):new u(503,"transport_error",t)}d(S,"toTransportApiError");function F(n){return new Promise(e=>setTimeout(e,n))}d(F,"sleepMs");function J(n){if(n!==void 0)try{return n()}catch{return}}d(J,"safeColdStartDiagnostic");export{R as CrtrClient,J as safeColdStartDiagnostic,L as waitForDaemonAvailability};