@north-light/crouter-api 0.3.156

package/dist/dto/worktree.d.ts

@@ -0,0 +1,19 @@
+import type { NodeIdDTO } from './common.js';
+/** `POST /v1/nodes/{id}/worktree/close` result. */
+export interface CloseWorktreeResultDTO {
+    node_id: NodeIdDTO;
+    /** The worktree branch fast-forwarded into its recorded local base branch. */
+    branch: string;
+    worktree_path: string;
+    /** The commit SHA the recorded local base branch was fast-forwarded onto. */
+    landed_sha: string;
+    /** False when the landing happened but the checkout could not be removed
+     *  automatically — the close still counts as done (state is closed);
+     *  `worktree_remove_error` carries the manual-cleanup note. */
+    worktree_removed: boolean;
+    worktree_remove_error?: string;
+    /** False when the landing happened but the local branch could not be deleted
+     *  automatically — same non-fatal treatment as `worktree_removed`. */
+    branch_deleted: boolean;
+    branch_delete_error?: string;
+}

package/dist/dto/worktree.js

@@ -0,0 +1,6 @@
+// Worktree DTOs (spec §6.2 — `node worktree close`). Landing + closing a
+// node-managed git worktree is a canvas WRITE interleaved with a git land
+// transaction, so it runs server-side (crtrd is the repo host — same principle
+// as spawnChild's server-side creation git). This is the projected result of
+// core's `CloseManagedWorktreeResult` — already snake_case, so a 1:1 mirror.
+export {};

package/dist/errors.d.ts

@@ -0,0 +1,19 @@
+/** The uniform JSON body crtrd returns on any non-2xx response. */
+export interface ErrorBody {
+    error: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+}
+/** Thrown by `CrtrClient` on a non-2xx response (or a synthesized transport
+ *  failure such as an unreachable daemon). Carries the HTTP status, the stable
+ *  machine `code` from the `ErrorBody`, and optional structured `details`. */
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly details?: unknown;
+    constructor(status: number, code: string, message: string, details?: unknown);
+}
+/** Type guard for an `ErrorBody`-shaped parsed payload. */
+export declare function isErrorBody(value: unknown): value is ErrorBody;

package/dist/errors.js

@@ -0,0 +1,30 @@
+// API error contract (spec §8). Uniform JSON error body on any non-2xx; the
+// client parses it and throws `ApiError`.
+//
+// PURITY (spec §3.1): Node built-ins + `src/api/*` only.
+/** Thrown by `CrtrClient` on a non-2xx response (or a synthesized transport
+ *  failure such as an unreachable daemon). Carries the HTTP status, the stable
+ *  machine `code` from the `ErrorBody`, and optional structured `details`. */
+export class ApiError extends Error {
+    status;
+    code;
+    details;
+    constructor(status, code, message, details) {
+        super(message);
+        this.name = 'ApiError';
+        this.status = status;
+        this.code = code;
+        if (details !== undefined)
+            this.details = details;
+    }
+}
+/** Type guard for an `ErrorBody`-shaped parsed payload. */
+export function isErrorBody(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const err = value.error;
+    if (typeof err !== 'object' || err === null)
+        return false;
+    const { code, message } = err;
+    return typeof code === 'string' && typeof message === 'string';
+}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+export { CrtrClient } from './client.js';
+export type { CrtrClientOptions } from './client.js';
+export { ApiError, isErrorBody } from './errors.js';
+export type { ErrorBody } from './errors.js';
+export { API_VERSION, routes } from './routes.js';
+export * from './dto/common.js';
+export * from './dto/health.js';
+export * from './dto/nodes.js';
+export * from './dto/messages.js';
+export * from './dto/reports.js';
+export * from './dto/lifecycle.js';
+export * from './dto/subscriptions.js';
+export * from './dto/focus.js';
+export * from './dto/crons.js';
+export * from './dto/config.js';
+export * from './dto/attach.js';
+export * from './dto/broker.js';
+export * from './dto/profiles.js';
+export * from './dto/modelauth.js';
+export * from './dto/canvas.js';
+export * from './dto/worktree.js';
+export * from './dto/human.js';
+export * from './dto/files.js';
+export * from './dto/inbox.js';

package/dist/index.js

@@ -0,0 +1,25 @@
+// `@crouton-kit/crouter/api` — the single source of truth for crtrd's API DTOs,
+// route constants, error contract, and the typed `CrtrClient`. Dependency-light
+// by design (spec §3.1): Node built-ins + `src/api/*` only.
+export { CrtrClient } from './client.js';
+export { ApiError, isErrorBody } from './errors.js';
+export { API_VERSION, routes } from './routes.js';
+export * from './dto/common.js';
+export * from './dto/health.js';
+export * from './dto/nodes.js';
+export * from './dto/messages.js';
+export * from './dto/reports.js';
+export * from './dto/lifecycle.js';
+export * from './dto/subscriptions.js';
+export * from './dto/focus.js';
+export * from './dto/crons.js';
+export * from './dto/config.js';
+export * from './dto/attach.js';
+export * from './dto/broker.js';
+export * from './dto/profiles.js';
+export * from './dto/modelauth.js';
+export * from './dto/canvas.js';
+export * from './dto/worktree.js';
+export * from './dto/human.js';
+export * from './dto/files.js';
+export * from './dto/inbox.js';

package/dist/routes.d.ts

@@ -0,0 +1,63 @@
+/** The single API version constant; every versioned path prepends it. */
+export declare const API_VERSION = "v1";
+/** Route path builders. Keys mirror the spec §6 route table. */
+export declare const routes: {
+    readonly healthz: () => string;
+    readonly status: () => string;
+    readonly daemonRestart: () => string;
+    readonly nodes: () => string;
+    readonly reviveAll: () => string;
+    readonly node: (id: string) => string;
+    readonly nodeSnapshot: (id: string) => string;
+    readonly nodeTranscript: (id: string) => string;
+    readonly nodeContext: (id: string) => string;
+    readonly nodeArtifacts: (id: string) => string;
+    readonly nodeReports: (id: string) => string;
+    readonly nodeMessages: (id: string) => string;
+    readonly nodeInterrupt: (id: string) => string;
+    readonly nodeFork: (id: string) => string;
+    readonly nodeRevive: (id: string) => string;
+    readonly nodeRelaunchRoot: (id: string) => string;
+    readonly nodeClose: (id: string) => string;
+    readonly nodeRecycle: (id: string) => string;
+    readonly nodeDemote: (id: string) => string;
+    readonly nodePromote: (id: string) => string;
+    readonly nodeYield: (id: string) => string;
+    readonly nodeWait: (id: string) => string;
+    readonly nodeConfig: (id: string) => string;
+    readonly nodeWorktreeClose: (id: string) => string;
+    readonly nodeAttach: (id: string) => string;
+    readonly focuses: () => string;
+    readonly focusByNode: () => string;
+    readonly focusByPane: () => string;
+    readonly focus: (focusId: string) => string;
+    readonly nodeSubscriptions: (id: string) => string;
+    readonly nodeSubscription: (id: string, target: string) => string;
+    readonly crons: () => string;
+    readonly cron: (cronId: string) => string;
+    readonly cronPause: (cronId: string) => string;
+    readonly cronResume: (cronId: string) => string;
+    readonly cronRun: (cronId: string) => string;
+    readonly canvasAttention: () => string;
+    readonly canvasAttentionCounts: () => string;
+    readonly canvasHistorySearch: () => string;
+    readonly canvasHistoryGrep: () => string;
+    readonly canvasHistoryRead: () => string;
+    readonly canvasSnapshot: () => string;
+    readonly canvasRoster: () => string;
+    readonly canvasPrune: () => string;
+    readonly canvasRebuildIndex: () => string;
+    readonly canvasConsults: () => string;
+    readonly humanBridge: () => string;
+    readonly humanDeliver: () => string;
+    readonly humanConsult: () => string;
+    readonly humanVisual: () => string;
+    readonly humanInbox: () => string;
+    readonly humanInboxTicket: (ticketId: string) => string;
+    readonly humanInboxRespond: (ticketId: string) => string;
+    readonly humanInboxCancel: (ticketId: string) => string;
+    readonly profiles: () => string;
+    readonly profile: (name: string) => string;
+    readonly modelAuth: (provider: string) => string;
+    readonly filePeek: () => string;
+};

package/dist/routes.js

@@ -0,0 +1,91 @@
+// API version + route path builders (spec §4.1). Every route is prefixed `/v1`
+// EXCEPT `GET /healthz`, which stays unversioned so any-version probes (incl.
+// the P2 provisioning ladder) can reach it. A version mismatch surfaces as a
+// 404 — there is no negotiation, no Accept-header versioning, no compat shim.
+//
+// These builders carry NO logic — they are pure string constructors. Every
+// interpolated param (node id, target, cron id, profile name, provider) MUST
+// be a pre-validated single path segment (e.g. `isSafeNodeId`-gated ids;
+// upstream-constrained names) — nothing here parses, encodes, or branches, so a
+// param carrying `/` or `..` would corrupt the path.
+//
+// PURITY (spec §3.1): Node built-ins + `src/api/*` only.
+/** The single API version constant; every versioned path prepends it. */
+export const API_VERSION = 'v1';
+const V = `/${API_VERSION}`;
+/** Route path builders. Keys mirror the spec §6 route table. */
+export const routes = {
+    // Health / status
+    healthz: () => '/healthz',
+    status: () => `${V}/status`,
+    daemonRestart: () => `${V}/daemon/restart`,
+    // Nodes — collection + item
+    nodes: () => `${V}/nodes`,
+    reviveAll: () => `${V}/nodes/revive-all`,
+    node: (id) => `${V}/nodes/${id}`,
+    // Node reads
+    nodeSnapshot: (id) => `${V}/nodes/${id}/snapshot`,
+    nodeTranscript: (id) => `${V}/nodes/${id}/transcript`,
+    nodeContext: (id) => `${V}/nodes/${id}/context`,
+    nodeArtifacts: (id) => `${V}/nodes/${id}/artifacts`,
+    nodeReports: (id) => `${V}/nodes/${id}/reports`,
+    // Node messages / feed
+    nodeMessages: (id) => `${V}/nodes/${id}/messages`,
+    nodeInterrupt: (id) => `${V}/nodes/${id}/interrupt`,
+    // Node lifecycle actions
+    nodeFork: (id) => `${V}/nodes/${id}/fork`,
+    nodeRevive: (id) => `${V}/nodes/${id}/revive`,
+    nodeRelaunchRoot: (id) => `${V}/nodes/${id}/relaunch-root`,
+    nodeClose: (id) => `${V}/nodes/${id}/close`,
+    nodeRecycle: (id) => `${V}/nodes/${id}/recycle`,
+    nodeDemote: (id) => `${V}/nodes/${id}/demote`,
+    nodePromote: (id) => `${V}/nodes/${id}/promote`,
+    nodeYield: (id) => `${V}/nodes/${id}/yield`,
+    nodeWait: (id) => `${V}/nodes/${id}/wait`,
+    nodeConfig: (id) => `${V}/nodes/${id}/config`,
+    nodeWorktreeClose: (id) => `${V}/nodes/${id}/worktree/close`,
+    nodeAttach: (id) => `${V}/nodes/${id}/attach`,
+    // Focuses (viewer registry — the canvas.db `focuses` table)
+    focuses: () => `${V}/focuses`,
+    focusByNode: () => `${V}/focuses/by-node`,
+    focusByPane: () => `${V}/focuses/by-pane`,
+    focus: (focusId) => `${V}/focuses/${focusId}`,
+    // Subscriptions
+    nodeSubscriptions: (id) => `${V}/nodes/${id}/subscriptions`,
+    nodeSubscription: (id, target) => `${V}/nodes/${id}/subscriptions/${target}`,
+    // Crons (the cron-spec scheduler)
+    crons: () => `${V}/crons`,
+    cron: (cronId) => `${V}/crons/${cronId}`,
+    cronPause: (cronId) => `${V}/crons/${cronId}/pause`,
+    cronResume: (cronId) => `${V}/crons/${cronId}/resume`,
+    cronRun: (cronId) => `${V}/crons/${cronId}/run`,
+    // Canvas maintenance / reads
+    canvasAttention: () => `${V}/canvas/attention`,
+    canvasAttentionCounts: () => `${V}/canvas/attention/counts`,
+    canvasHistorySearch: () => `${V}/canvas/history/search`,
+    canvasHistoryGrep: () => `${V}/canvas/history/grep`,
+    canvasHistoryRead: () => `${V}/canvas/history/read`,
+    canvasSnapshot: () => `${V}/canvas/snapshot`,
+    canvasRoster: () => `${V}/canvas/roster`,
+    canvasPrune: () => `${V}/canvas/prune`,
+    canvasRebuildIndex: () => `${V}/canvas/rebuild-index`,
+    canvasConsults: () => `${V}/canvas/consults`,
+    // Human bridge + completion-handler forwarding (spec §6.5)
+    humanBridge: () => `${V}/human/bridge`,
+    humanDeliver: () => `${V}/human/deliver`,
+    humanConsult: () => `${V}/human/consult`,
+    humanVisual: () => `${V}/human/visual`,
+    // Humanloop inbox (Northlight crouter-inbox v1, inbox-contract.md §A)
+    humanInbox: () => `${V}/human/inbox`,
+    humanInboxTicket: (ticketId) => `${V}/human/inbox/${ticketId}`,
+    humanInboxRespond: (ticketId) => `${V}/human/inbox/${ticketId}/respond`,
+    humanInboxCancel: (ticketId) => `${V}/human/inbox/${ticketId}/cancel`,
+    // Profiles (server-side for P2 Core; CLI profile verbs stay fs-local)
+    profiles: () => `${V}/profiles`,
+    profile: (name) => `${V}/profiles/${name}`,
+    // Model auth
+    modelAuth: (provider) => `${V}/model-auth/${provider}`,
+    // Host file read (browser file-peek panel). The absolute path rides as a
+    // `path` query param, not a path segment — it is not a single safe segment.
+    filePeek: () => `${V}/files/peek`,
+};

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@north-light/crouter-api",
+  "version": "0.3.156",
+  "description": "Typed crtrd /v1 API contract — DTOs, route builders, the error contract, and the CrtrClient. Zero runtime dependencies.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  },
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vallum-security/crouter.git",
+    "directory": "packages/crouter-api"
+  },
+  "license": "UNLICENSED"
+}