npm - @loicngr/kobo - Versions diffs - 1.8.5 → 1.8.6 - Mend

@loicngr/kobo 1.8.5 → 1.8.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (70) hide show

package/src/client/dist/spa/index.html CHANGED Viewed

@@ -1,4 +1,4 @@
-<!DOCTYPE html><html><head><title>Kōbō</title><link rel=icon type=image/svg+xml href=/favicon.svg><meta charset=utf-8><meta name=description content="Kōbō — multi-workspace agent manager for Claude Code"><meta name=format-detection content="telephone=no"><meta name=msapplication-tap-highlight content=no><meta name=viewport content="user-scalable=no,initial-scale=1,maximum-scale=1,minimum-scale=1,width=device-width,height=device-height">  <script type="module" crossorigin src="/assets/index-DY-0-pzs.js"></script>
+<!DOCTYPE html><html><head><title>Kōbō</title><link rel=icon type=image/svg+xml href=/favicon.svg><meta charset=utf-8><meta name=description content="Kōbō — multi-workspace agent manager for Claude Code"><meta name=format-detection content="telephone=no"><meta name=msapplication-tap-highlight content=no><meta name=viewport content="user-scalable=no,initial-scale=1,maximum-scale=1,minimum-scale=1,width=device-width,height=device-height">  <script type="module" crossorigin src="/assets/index-C1u3FMCQ.js"></script>
   <link rel="modulepreload" crossorigin href="/assets/chunk-QTnfLwEv.js">
   <link rel="modulepreload" crossorigin href="/assets/vue.runtime.esm-bundler-JZnIeD9D.js">
   <link rel="modulepreload" crossorigin href="/assets/QIcon-CfOEsLsF.js">

package/src/mcp-server/README.md CHANGED Viewed

@@ -8,7 +8,7 @@ Kōbō's Claude Code engine (under `src/server/services/agent/engines/claude-cod
 | Env var | Purpose |
 |---|---|
-| `KOBO_WORKSPACE_ID` | ID of the current workspace — scopes all queries. **Required**. |
+| `KOBO_WORKSPACE_ID` | ID of the current workspace — scopes all queries. Optional: when unset, the server runs in "global" mode (see [Global tools](#global-tools-workspace-less-mode) below) and only exposes the workspace-management tools; workspace-scoped tools are omitted from the tool list entirely. |
 | `KOBO_DB_PATH` | Absolute path to Kōbō's SQLite DB. **Required**. |
 | `KOBO_SETTINGS_PATH` | Absolute path to Kōbō's `settings.json`. Optional — `get_settings` returns an error shape if absent. |
 | `KOBO_BACKEND_URL` | Base URL of the running Kōbō HTTP backend. Default: `http://localhost:3000`. Used by tools that need runtime state (dev server, git info, workspace transitions). |
@@ -170,6 +170,51 @@ List all images uploaded to the current workspace via Kōbō's chat paste/upload
 ---
+### Global tools (workspace-less mode)
+These 4 tools are always registered, regardless of whether `KOBO_WORKSPACE_ID` is set — they let a Claude Code session that Kōbō did NOT spawn (e.g. a standalone terminal session) discover and manage workspaces instead of being bound to one.
+#### `list_workspaces`
+List Kōbō workspaces with id, title, status, and creation date. Reads the DB directly — works even when the Kōbō backend server isn't running.
+**Input:**
+- `include_archived` (boolean, optional) — default `false`
+**Output:** `Array<{ id, title, status, createdAt }>`
+---
+#### `create_workspace`
+Create a new workspace (git worktree + agent session), like the "Créer" button on the Create page. Requires the Kōbō backend server to be running and reachable at `KOBO_BACKEND_URL` — this API has no automatic branch-name derivation from the workspace name, unlike the UI.
+**Input:**
+- `name`, `project_path`, `source_branch`, `working_branch` (string, required)
+- `model`, `reasoning_effort`, `engine`, `description` (string, optional)
+- `tasks`, `acceptance_criteria` (string[], optional)
+- `agent_permission_mode` (`plan | bypass | strict | interactive`, optional)
+- `auto_loop` (boolean, optional), `auto_loop_session_mode` (`per_task | continuous`, optional)
+- `skip_setup_script` (boolean, optional)
+**Output:** created `Workspace`
+---
+#### `archive_workspace`
+Archive a workspace by id, like the "Archiver" action in the workspace context menu. Requires the backend to be running.
+**Input:**
+- `workspace_id` (string, required) — from `list_workspaces`
+---
+#### `stop_workspace`
+Force-stop the currently running agent session on a workspace, like the red "Arrêter" button in the chat header. Requires the backend to be running. Safe to call when nothing is running.
+**Input:**
+- `workspace_id` (string, required) — from `list_workspaces`
+---
 ## Implementation notes
 - **Handlers** live in `kobo-tasks-handlers.ts` as pure functions taking the DB handle (and sometimes paths) as arguments. This keeps them unit-testable in isolation — see `src/__tests__/kobo-tasks-server.test.ts`.

package/src/mcp-server/kobo-tasks-handlers.ts CHANGED Viewed

@@ -59,6 +59,43 @@ export function listTasksHandler(db: Database.Database, workspaceId: string): Ta
   return rows.map(rowToDto)
 }
+/** Public-facing representation of a workspace exposed via the global list_workspaces MCP tool. */
+export interface WorkspaceListItemDto {
+  id: string
+  title: string
+  status: string
+  createdAt: string
+}
+interface WorkspaceListRow {
+  id: string
+  name: string
+  status: string
+  created_at: string
+}
+/**
+ * List workspaces for the global `list_workspaces` MCP tool. Reads SQLite
+ * directly (no backend HTTP dependency) so it works even when the Kōbō
+ * server isn't running — the same DB file the backend uses.
+ */
+export function listWorkspacesHandler(
+  db: Database.Database,
+  opts: { includeArchived?: boolean },
+): WorkspaceListItemDto[] {
+  // updated_at can collide at second resolution (e.g. bulk-seeded test data); rowid DESC breaks ties, most-recently-inserted first.
+  const sql = opts.includeArchived
+    ? 'SELECT id, name, status, created_at FROM workspaces ORDER BY updated_at DESC, rowid DESC'
+    : 'SELECT id, name, status, created_at FROM workspaces WHERE archived_at IS NULL ORDER BY updated_at DESC, rowid DESC'
+  const rows = db.prepare(sql).all() as WorkspaceListRow[]
+  return rows.map((row) => ({
+    id: row.id,
+    title: row.name,
+    status: row.status,
+    createdAt: row.created_at,
+  }))
+}
 /**
  * Flip the workspace's `auto_loop_ready` flag. Called at the end of a
  * `/kobo-prep-autoloop` grooming session to unlock the auto-loop toggle.