sensorium-mcp 3.1.2 → 3.1.3-board.2

package/dist/dashboard/routes/board.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Dashboard API — Agent Task Board routes.
+ *
+ * The ONLY write surface for the board (single-writer invariant): the operator
+ * acts here; agents never see these endpoints. The orchestrator service is the
+ * other writer (worker reports → comments, status moves) but that is server
+ * code, not an exposed surface.
+ *
+ * Routes (all Bearer-auth like every /api/*):
+ *   GET    /api/board/cards?includeArchived=1&lane=<threadId>
+ *   POST   /api/board/cards
+ *   GET    /api/board/cards/:id            (card + comments)
+ *   PATCH  /api/board/cards/:id
+ *   DELETE /api/board/cards/:id
+ *   POST   /api/board/cards/:id/comments
+ *   GET    /api/board/lanes
+ *   POST   /api/board/lanes
+ *   DELETE /api/board/lanes/:threadId
+ *   GET    /api/board/profiles
+ *   PUT    /api/board/profiles
+ */
+import { type RouteArgs, type RouteHandler } from "./types.js";
+/** GET /api/board/cards → { cards } (comments not included; fetch per card). */
+export declare const handleGetBoardCards: RouteHandler;
+/** POST /api/board/cards — create; type seeds the profile, explicit fields win. */
+export declare const handlePostBoardCard: RouteHandler;
+/** GET /api/board/cards/:id → { card, comments } */
+export declare function handleGetBoardCard(args: RouteArgs, cardId: number): boolean;
+/**
+ * PATCH /api/board/cards/:id — operator edits, drag-drop status moves, resume.
+ *
+ * Live-card policy (design D2/D4): a card that is in_progress is TASK-IMMUTABLE.
+ * The bound worker owns what it is DOING; the only way to change that is an
+ * explicit Stop (POST .../stop) that decommissions it. So while in_progress:
+ *   • re-laning, archiving, and profile/type edits are REFUSED (409) — "Stop
+ *     first" — because they would silently diverge from what the worker runs.
+ *   • moving to backlog (re-run) or done ALLOWS the move but first releases
+ *     (kills + tears down) the bound worker, so no orphaned/duplicate worker
+ *     survives to double-push or leak its report (R1 closes B1/B2).
+ * Leaving in_progress/blocked clears the worker binding + blocked reason so a
+ * later dispatch spawns a FRESH stateless worker (design §3.5).
+ */
+export declare function handlePatchBoardCard(args: RouteArgs, cardId: number): Promise<boolean>;
+/**
+ * POST /api/board/cards/:id/stop — explicit operator Stop (design D3).
+ * Decommission the bound worker (kill + teardown) and park the card in blocked
+ * with a clear reason. Blocked is never auto-dispatched, so the card sits safely
+ * until the operator resumes it (→ backlog re-dispatches a fresh worker).
+ */
+export declare function handleStopBoardCard(args: RouteArgs, cardId: number): Promise<boolean>;
+/** DELETE /api/board/cards/:id — remove the card. A live card's bound worker
+ *  is decommissioned first (R1/B8) so deleting it never orphans a running
+ *  worker that would push/report against a card that no longer exists. */
+export declare function handleDeleteBoardCard(args: RouteArgs, cardId: number): Promise<boolean>;
+/** POST /api/board/cards/:id/comments — operator comment. */
+export declare function handlePostBoardComment(args: RouteArgs, cardId: number): Promise<boolean>;
+/** GET /api/board/lanes → lanes decorated with thread names for the UI. */
+export declare const handleGetBoardLanes: RouteHandler;
+/** POST /api/board/lanes — connect/disconnect a thread, set max_concurrent. */
+export declare const handlePostBoardLane: RouteHandler;
+/** DELETE /api/board/lanes/:threadId */
+export declare function handleDeleteBoardLane(args: RouteArgs, threadId: number): boolean;
+/** GET /api/board/profiles → effective per-type templates (builtin ⊕ overrides). */
+export declare const handleGetBoardProfiles: RouteHandler;
+/** PUT /api/board/profiles — persist operator overrides wholesale. */
+export declare const handlePutBoardProfiles: RouteHandler;
+/**
+ * GET /api/board/usage → current usage snapshot(s) from the shared provider.
+ * Agent-type-blind consumer of the port (OCP): returns whatever the poller has
+ * stored, `{ sources: [] }` when the monitor is inert.
+ */
+export declare function handleGetBoardUsage({ json }: RouteArgs): boolean;
+//# sourceMappingURL=board.d.ts.map

package/dist/dashboard/routes/board.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"board.d.ts","sourceRoot":"","sources":["../../../src/dashboard/routes/board.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAY,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAuJzE,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,EAAE,YAuBjC,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,mBAAmB,EAAE,YA4DjC,CAAC;AAEF,oDAAoD;AACpD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAa3E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAiJ5F;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAwB3F;AAED;;0EAE0E;AAC1E,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAoB7F;AAED,6DAA6D;AAC7D,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAkB9F;AAID,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB,EAAE,YAWjC,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB,EAAE,YAkCjC,CAAC;AAEF,wCAAwC;AACxC,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAuBhF;AAID,oFAAoF;AACpF,eAAO,MAAM,sBAAsB,EAAE,YAOpC,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,sBAAsB,EAAE,YAgCpC,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,GAAG,OAAO,CAGhE"}