@loicngr/kobo 1.6.14 → 1.7.0

package/dist/server/services/agent/engines/claude-code/options-builder.js

@@ -0,0 +1,68 @@
+const KOBO_MCP_BRIEF = [
+    '[Kōbō MCP] This workspace exposes a dedicated MCP server with tools prefixed `kobo__`.',
+    'Non-interactive mode: this session runs via the Claude Agent SDK in single-shot mode. To ask the user a question, call the `AskUserQuestion` tool — Kōbō will pause the session, collect the answer asynchronously, and resume.',
+    '⚠️ HARD RULE — emit AT MOST ONE `AskUserQuestion` tool call per turn, and emit it ALONE (no other tool calls in the same response). The Claude Agent SDK rejects parallel defers: a second `AskUserQuestion` in the same turn breaks the pause mechanism, makes both calls fail with "AskUserQuestion fails", and the user sees the panel arrive only at the end of the turn (if at all). If you have N questions, group them as a multi-question array inside ONE call: `AskUserQuestion({ questions: [{ question: "Q1", options: [...] }, { question: "Q2", options: [...] }] })`. After invoking it, STOP — do not emit any other tool call. Wait for the resume.',
+    'Plan mode: when running with `permissionMode: plan`, the read-only restriction applies to MCP tools too. For Kōbō: `kobo__list_*`, `kobo__read_document`, `kobo__search_codebase`, `kobo__get_*` are fine; `kobo__mark_task_done`, `kobo__log_thought`, `kobo__set_workspace_status` are mutations and must wait until the plan is approved.',
+    'Conventions — read these BEFORE starting work, not as a fallback:',
+    '• `kobo__list_tasks` first on any non-trivial turn, then `kobo__mark_task_done` as each item completes.',
+    '• `kobo__list_documents` / `kobo__read_document` to discover existing plans and specs under docs/ and .ai/thoughts/ before writing new ones.',
+    '• `kobo__log_thought` to persist notable decisions to `.ai/thoughts/<date>-<slug>.md`.',
+    '• `kobo__search_codebase` to recall prior chat history (conversations, not source — use Grep for source).',
+    '• `kobo__get_workspace_info` / `kobo__get_git_info` / `kobo__get_notion_ticket` for context.',
+    '• `kobo__set_workspace_status` when the mission is done / blocked / idle.',
+    '• `kobo__schedule_wakeup` / `kobo__cancel_wakeup` to schedule (or cancel) a follow-up session — prefer these over the built-in `ScheduleWakeup` tool.',
+    'Each tool carries its own "WHEN to use" guidance in its description — follow it.',
+].join('\n');
+export function buildClaudeOptions(input) {
+    const options = {
+        cwd: input.workingDir,
+        systemPrompt: { type: 'preset', preset: 'claude_code' },
+        // Leave `tools` undefined: the `claude_code` preset EXCLUDES MCP tools, so
+        // under bypassPermissions MCP tools surface as "haven't granted it yet"
+        // even when the user chose bypass. Undefined → full toolbox (built-ins +
+        // MCP), matching pre-SDK CLI behaviour.
+        //
+        // `settingSources` defaults to [] in the SDK; we must opt in to all three
+        // levels. Restricting to ['project'] makes the SDK skip the user-level
+        // `~/.claude/settings.json` (where `skipDangerousModePermissionPrompt`
+        // lives), breaking bypass for MCP tools.
+        settingSources: ['user', 'project', 'local'],
+    };
+    switch (input.agentPermissionMode) {
+        case 'plan':
+            options.permissionMode = 'plan';
+            break;
+        case 'bypass':
+            options.permissionMode = 'bypassPermissions';
+            options.allowDangerouslySkipPermissions = true;
+            break;
+        case 'strict':
+            options.permissionMode = 'acceptEdits';
+            break;
+        case 'interactive':
+            // SDK 'default' + our canUseTool hook → every tool that would prompt is
+            // deferred to the user via a workspace-level permission request.
+            options.permissionMode = 'default';
+            break;
+    }
+    let prompt = input.prompt;
+    if (!input.resumeFromEngineSessionId) {
+        prompt = `${KOBO_MCP_BRIEF}\n\n${prompt}`;
+    }
+    if (input.model && input.model !== 'auto')
+        options.model = input.model;
+    if (input.effort && input.effort !== 'auto')
+        options.extraArgs = { effort: input.effort };
+    if (input.mcpServers && Object.keys(input.mcpServers).length > 0) {
+        options.mcpServers = input.mcpServers;
+    }
+    if (input.resumeFromEngineSessionId)
+        options.resume = input.resumeFromEngineSessionId;
+    if (input.hooks)
+        options.hooks = input.hooks;
+    if (input.canUseTool)
+        options.canUseTool = input.canUseTool;
+    if (input.stderr)
+        options.stderr = input.stderr;
+    return { options, effectivePrompt: prompt };
+}

package/dist/server/services/agent/engines/claude-code/precompact-hook.js

@@ -0,0 +1,27 @@
+import { getWorkspace, listTasks } from '../../../workspace-service.js';
+/**
+ * Build the reminder text injected back into the agent at compaction time.
+ * Returns an empty string if the workspace has neither tasks nor acceptance
+ * criteria — the caller should treat that as "nothing to inject".
+ *
+ * Pure with respect to its inputs other than the SQLite reads done via
+ * getWorkspace / listTasks, which keeps it trivially unit-testable.
+ */
+export function buildPreCompactCustomInstructions(workspaceId) {
+    const ws = getWorkspace(workspaceId);
+    const tasks = listTasks(workspaceId);
+    const criteria = tasks.filter((t) => t.isAcceptanceCriterion);
+    const todos = tasks.filter((t) => !t.isAcceptanceCriterion);
+    if (criteria.length === 0 && todos.length === 0)
+        return '';
+    let out = `Context reminder for the next session segment.\n`;
+    out += `Task: ${ws?.name ?? workspaceId}\n`;
+    if (todos.length > 0) {
+        out += `\nTasks:\n${todos.map((t) => `- [${t.status === 'done' ? 'x' : ' '}] ${t.title}`).join('\n')}\n`;
+    }
+    if (criteria.length > 0) {
+        out += `\nAcceptance criteria:\n${criteria.map((t) => `- [${t.status === 'done' ? 'x' : ' '}] ${t.title}`).join('\n')}\n`;
+        out += `\nWhen you complete a criterion, tell the user which one so it can be marked as done.\n`;
+    }
+    return out;
+}

package/dist/server/services/agent/engines/types.js

@@ -2,6 +2,7 @@
 export const ALL_AGENT_EVENT_KINDS = [
     'session:started',
     'session:ended',
+    'session:user-input-requested',
     'session:compacted',
     'session:brainstorm-complete',
     'message:text',