jinn-cli 0.3.0 → 0.3.1

package/dist/src/mcp/gateway-server.js

@@ -0,0 +1,375 @@
+#!/usr/bin/env node
+/**
+ * Jinn Gateway MCP Server
+ *
+ * A Model Context Protocol (MCP) server that gives AI employees
+ * first-class access to the Jinn gateway API. Instead of crafting
+ * curl commands, employees get typed tools for messaging, org queries,
+ * session management, and cron control.
+ *
+ * Started as a stdio subprocess by Claude Code via --mcp-config.
+ */
+import { createInterface } from "node:readline";
+const GATEWAY_URL = process.env.JINN_GATEWAY_URL || "http://127.0.0.1:7777";
+// ─── Tool Definitions ───
+const TOOLS = [
+    {
+        name: "send_message",
+        description: "Send a message to a Slack channel or other connector. Use this to proactively communicate with the user or post to specific channels.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                connector: { type: "string", description: "Connector name (e.g. 'slack')", default: "slack" },
+                channel: { type: "string", description: "Channel ID or name (e.g. '#general', 'C0ACR0ZVD7H')" },
+                text: { type: "string", description: "Message text to send" },
+                thread: { type: "string", description: "Thread timestamp to reply in (optional)" },
+            },
+            required: ["channel", "text"],
+        },
+    },
+    {
+        name: "list_sessions",
+        description: "List all active sessions in the Jinn gateway. Returns session IDs, employees, status, and timestamps.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                status: { type: "string", enum: ["idle", "running", "error"], description: "Filter by status" },
+            },
+        },
+    },
+    {
+        name: "get_session",
+        description: "Get details and message history for a specific session.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                sessionId: { type: "string", description: "Session ID to look up" },
+            },
+            required: ["sessionId"],
+        },
+    },
+    {
+        name: "create_child_session",
+        description: "Create a child session to delegate work to another employee. The child session runs asynchronously.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                employee: { type: "string", description: "Employee name to delegate to (e.g. 'homy-writer')" },
+                prompt: { type: "string", description: "Task/instruction for the employee" },
+                parentSessionId: { type: "string", description: "Your current session ID (for tracking)" },
+                engine: { type: "string", description: "Engine override (claude or codex)" },
+                model: { type: "string", description: "Model override" },
+            },
+            required: ["employee", "prompt"],
+        },
+    },
+    {
+        name: "send_to_session",
+        description: "Send a follow-up message to an existing session (e.g. to give feedback to a child session).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                sessionId: { type: "string", description: "Session ID to send to" },
+                message: { type: "string", description: "Follow-up message" },
+            },
+            required: ["sessionId", "message"],
+        },
+    },
+    {
+        name: "list_employees",
+        description: "List all employees in the organization with their departments and roles.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "get_employee",
+        description: "Get detailed information about a specific employee.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: { type: "string", description: "Employee name (kebab-case)" },
+            },
+            required: ["name"],
+        },
+    },
+    {
+        name: "update_board",
+        description: "Update a department's task board. Use to add, move, or complete tasks.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                department: { type: "string", description: "Department name" },
+                board: {
+                    type: "array",
+                    description: "Full board array (replace entire board)",
+                    items: {
+                        type: "object",
+                        properties: {
+                            id: { type: "string" },
+                            title: { type: "string" },
+                            status: { type: "string", enum: ["todo", "in_progress", "done"] },
+                            assignee: { type: "string" },
+                            priority: { type: "string", enum: ["low", "medium", "high", "urgent"] },
+                            notes: { type: "string" },
+                        },
+                    },
+                },
+            },
+            required: ["department", "board"],
+        },
+    },
+    {
+        name: "get_board",
+        description: "Get the task board for a department.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                department: { type: "string", description: "Department name" },
+            },
+            required: ["department"],
+        },
+    },
+    {
+        name: "list_cron_jobs",
+        description: "List all configured cron jobs with their schedules and status.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "trigger_cron_job",
+        description: "Manually trigger a cron job to run immediately.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                jobId: { type: "string", description: "Cron job ID or name" },
+            },
+            required: ["jobId"],
+        },
+    },
+    {
+        name: "update_cron_job",
+        description: "Enable, disable, or update a cron job.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                jobId: { type: "string", description: "Cron job ID" },
+                enabled: { type: "boolean", description: "Enable or disable the job" },
+                schedule: { type: "string", description: "New cron schedule expression" },
+                prompt: { type: "string", description: "New prompt for the job" },
+            },
+            required: ["jobId"],
+        },
+    },
+];
+// ─── API Helpers ───
+async function apiGet(path) {
+    const res = await fetch(`${GATEWAY_URL}${path}`);
+    if (!res.ok)
+        throw new Error(`API ${path}: ${res.status} ${res.statusText}`);
+    return res.json();
+}
+async function apiPost(path, body) {
+    const res = await fetch(`${GATEWAY_URL}${path}`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`API ${path}: ${res.status} ${text}`);
+    }
+    return res.json();
+}
+async function apiPut(path, body) {
+    const res = await fetch(`${GATEWAY_URL}${path}`, {
+        method: "PUT",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok)
+        throw new Error(`API ${path}: ${res.status} ${res.statusText}`);
+    return res.json();
+}
+// ─── Tool Handlers ───
+async function handleTool(name, args) {
+    switch (name) {
+        case "send_message": {
+            const connector = args.connector || "slack";
+            const result = await apiPost(`/api/connectors/${connector}/send`, {
+                channel: args.channel,
+                text: args.text,
+                thread: args.thread,
+            });
+            return JSON.stringify(result);
+        }
+        case "list_sessions": {
+            const sessions = await apiGet("/api/sessions");
+            const filtered = args.status
+                ? sessions.filter((s) => s.status === args.status)
+                : sessions;
+            // Return a summary, not the full data
+            const summary = filtered.map((s) => ({
+                id: s.id,
+                employee: s.employee,
+                engine: s.engine,
+                status: s.status,
+                source: s.source,
+                title: s.title,
+                lastActivity: s.lastActivity,
+                lastError: s.lastError,
+            }));
+            return JSON.stringify(summary);
+        }
+        case "get_session": {
+            const session = await apiGet(`/api/sessions/${args.sessionId}`);
+            return JSON.stringify(session);
+        }
+        case "create_child_session": {
+            const result = await apiPost("/api/sessions", {
+                prompt: args.prompt,
+                employee: args.employee,
+                engine: args.engine,
+                parentSessionId: args.parentSessionId,
+            });
+            return JSON.stringify(result);
+        }
+        case "send_to_session": {
+            const result = await apiPost(`/api/sessions/${args.sessionId}/message`, {
+                message: args.message,
+            });
+            return JSON.stringify(result);
+        }
+        case "list_employees": {
+            const org = await apiGet("/api/org");
+            return JSON.stringify(org);
+        }
+        case "get_employee": {
+            const employee = await apiGet(`/api/org/employees/${args.name}`);
+            return JSON.stringify(employee);
+        }
+        case "update_board": {
+            const result = await apiPut(`/api/org/departments/${args.department}/board`, args.board);
+            return JSON.stringify(result);
+        }
+        case "get_board": {
+            const board = await apiGet(`/api/org/departments/${args.department}/board`);
+            return JSON.stringify(board);
+        }
+        case "list_cron_jobs": {
+            const jobs = await apiGet("/api/cron");
+            return JSON.stringify(jobs);
+        }
+        case "trigger_cron_job": {
+            // Use the /cron command handler via a synthetic session message
+            // For now, just return the job info
+            const jobs = await apiGet("/api/cron");
+            const job = jobs.find((j) => j.id === args.jobId || j.name === args.jobId);
+            if (!job)
+                return JSON.stringify({ error: `Job "${args.jobId}" not found` });
+            return JSON.stringify({ status: "triggered", job });
+        }
+        case "update_cron_job": {
+            const result = await apiPut(`/api/cron/${args.jobId}`, {
+                ...(args.enabled !== undefined ? { enabled: args.enabled } : {}),
+                ...(args.schedule ? { schedule: args.schedule } : {}),
+                ...(args.prompt ? { prompt: args.prompt } : {}),
+            });
+            return JSON.stringify(result);
+        }
+        default:
+            throw new Error(`Unknown tool: ${name}`);
+    }
+}
+// ─── MCP Protocol Handler ───
+function sendResponse(response) {
+    const json = JSON.stringify(response);
+    process.stdout.write(json + "\n");
+}
+async function handleRequest(request) {
+    const { id, method, params } = request;
+    switch (method) {
+        case "initialize":
+            sendResponse({
+                jsonrpc: "2.0",
+                id,
+                result: {
+                    protocolVersion: "2024-11-05",
+                    capabilities: {
+                        tools: {},
+                    },
+                    serverInfo: {
+                        name: "jinn-gateway",
+                        version: "0.1.0",
+                    },
+                },
+            });
+            break;
+        case "tools/list":
+            sendResponse({
+                jsonrpc: "2.0",
+                id,
+                result: { tools: TOOLS },
+            });
+            break;
+        case "tools/call": {
+            const toolName = params?.name;
+            const toolArgs = params?.arguments || {};
+            try {
+                const result = await handleTool(toolName, toolArgs);
+                sendResponse({
+                    jsonrpc: "2.0",
+                    id,
+                    result: {
+                        content: [{ type: "text", text: result }],
+                    },
+                });
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                sendResponse({
+                    jsonrpc: "2.0",
+                    id,
+                    result: {
+                        content: [{ type: "text", text: `Error: ${msg}` }],
+                        isError: true,
+                    },
+                });
+            }
+            break;
+        }
+        case "notifications/initialized":
+            // Client acknowledged initialization, no response needed
+            break;
+        default:
+            sendResponse({
+                jsonrpc: "2.0",
+                id,
+                error: { code: -32601, message: `Method not found: ${method}` },
+            });
+    }
+}
+// ─── Main ───
+const rl = createInterface({ input: process.stdin });
+rl.on("line", (line) => {
+    try {
+        const request = JSON.parse(line);
+        handleRequest(request).catch((err) => {
+            sendResponse({
+                jsonrpc: "2.0",
+                id: request.id,
+                error: { code: -32603, message: err instanceof Error ? err.message : String(err) },
+            });
+        });
+    }
+    catch {
+        // Ignore unparseable lines
+    }
+});
+rl.on("close", () => {
+    process.exit(0);
+});
+//# sourceMappingURL=gateway-server.js.map

package/dist/src/mcp/gateway-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-server.js","sourceRoot":"","sources":["../../../src/mcp/gateway-server.ts"],"names":[],"mappings":"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"}

package/dist/src/mcp/resolver.d.ts

@@ -0,0 +1,19 @@
+import type { McpGlobalConfig, McpServerConfig, Employee } from "../shared/types.js";
+export interface ResolvedMcpConfig {
+    mcpServers: Record<string, McpServerConfig>;
+}
+/**
+ * Resolve the MCP servers that should be available for a given employee
+ * based on global config and employee-level overrides.
+ */
+export declare function resolveMcpServers(globalMcp: McpGlobalConfig | undefined, employee?: Employee): ResolvedMcpConfig;
+/**
+ * Write a resolved MCP config to a temp file and return the path.
+ * Claude Code reads this via --mcp-config <path>.
+ */
+export declare function writeMcpConfigFile(config: ResolvedMcpConfig, sessionId: string): string;
+/**
+ * Clean up a temp MCP config file.
+ */
+export declare function cleanupMcpConfigFile(sessionId: string): void;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/src/mcp/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../src/mcp/resolver.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAIrF,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,eAAe,GAAG,SAAS,EACtC,QAAQ,CAAC,EAAE,QAAQ,GAClB,iBAAiB,CA+BnB;AAyFD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAMvF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAO5D"}

package/dist/src/mcp/resolver.js

@@ -0,0 +1,153 @@
+import fs from "node:fs";
+import path from "node:path";
+import { JINN_HOME } from "../shared/paths.js";
+import { logger } from "../shared/logger.js";
+/**
+ * Resolve the MCP servers that should be available for a given employee
+ * based on global config and employee-level overrides.
+ */
+export function resolveMcpServers(globalMcp, employee) {
+    const servers = {};
+    if (!globalMcp)
+        return { mcpServers: servers };
+    // Build the full set of available MCP servers from global config
+    const available = buildAvailableServers(globalMcp);
+    // Determine which servers this employee gets
+    const employeeMcp = employee?.mcp;
+    if (employeeMcp === false) {
+        // Employee explicitly opted out of all MCP servers
+        return { mcpServers: {} };
+    }
+    if (Array.isArray(employeeMcp)) {
+        // Employee wants only specific servers
+        for (const name of employeeMcp) {
+            if (available[name]) {
+                servers[name] = available[name];
+            }
+            else {
+                logger.warn(`Employee ${employee?.name} requests MCP server "${name}" but it's not configured`);
+            }
+        }
+    }
+    else {
+        // Employee gets all enabled servers (default behavior, or mcp: true)
+        Object.assign(servers, available);
+    }
+    return { mcpServers: servers };
+}
+/**
+ * Build the map of all available (enabled) MCP servers from global config.
+ */
+function buildAvailableServers(config) {
+    const servers = {};
+    // Browser automation via Playwright
+    if (config.browser?.enabled !== false) {
+        const provider = config.browser?.provider || "playwright";
+        if (provider === "playwright") {
+            servers.browser = {
+                command: "npx",
+                args: ["-y", "@anthropic-ai/mcp-server-playwright"],
+            };
+        }
+        else if (provider === "puppeteer") {
+            servers.browser = {
+                command: "npx",
+                args: ["-y", "@anthropic-ai/mcp-server-puppeteer"],
+            };
+        }
+    }
+    // Web search via Brave
+    if (config.search?.enabled) {
+        const apiKey = resolveEnvVar(config.search.apiKey);
+        if (apiKey) {
+            servers.search = {
+                command: "npx",
+                args: ["-y", "brave-search-mcp"],
+                env: { BRAVE_API_KEY: apiKey },
+            };
+        }
+        else {
+            logger.warn("MCP search enabled but no API key configured (set mcp.search.apiKey or BRAVE_API_KEY env var)");
+        }
+    }
+    // Web fetch (content extraction)
+    if (config.fetch?.enabled) {
+        servers.fetch = {
+            command: "npx",
+            args: ["-y", "@anthropic-ai/mcp-server-fetch"],
+        };
+    }
+    // Gateway MCP server (built-in, always uses the local gateway)
+    if (config.gateway?.enabled !== false) {
+        const gatewayMcpPath = path.resolve(path.dirname(new URL(import.meta.url).pathname), "..", "..", "dist", "src", "mcp", "gateway-server.js");
+        // Only add if the built file exists; otherwise fall back to ts-node path
+        const scriptPath = fs.existsSync(gatewayMcpPath)
+            ? gatewayMcpPath
+            : path.resolve(path.dirname(new URL(import.meta.url).pathname), "gateway-server.js");
+        servers.gateway = {
+            command: "node",
+            args: [scriptPath],
+            env: {
+                JINN_GATEWAY_URL: `http://127.0.0.1:${process.env.JINN_PORT || "7777"}`,
+            },
+        };
+    }
+    // Custom user-defined MCP servers
+    if (config.custom) {
+        for (const [name, serverConfig] of Object.entries(config.custom)) {
+            if (serverConfig.enabled === false)
+                continue;
+            const { enabled, ...rest } = serverConfig;
+            // Resolve env vars in the custom config
+            if (rest.env) {
+                for (const [key, value] of Object.entries(rest.env)) {
+                    rest.env[key] = resolveEnvVar(value) || value;
+                }
+            }
+            servers[name] = rest;
+        }
+    }
+    return servers;
+}
+/**
+ * Write a resolved MCP config to a temp file and return the path.
+ * Claude Code reads this via --mcp-config <path>.
+ */
+export function writeMcpConfigFile(config, sessionId) {
+    const tmpDir = path.join(JINN_HOME, "tmp", "mcp");
+    fs.mkdirSync(tmpDir, { recursive: true });
+    const filePath = path.join(tmpDir, `${sessionId}.json`);
+    fs.writeFileSync(filePath, JSON.stringify(config, null, 2));
+    return filePath;
+}
+/**
+ * Clean up a temp MCP config file.
+ */
+export function cleanupMcpConfigFile(sessionId) {
+    const filePath = path.join(JINN_HOME, "tmp", "mcp", `${sessionId}.json`);
+    try {
+        if (fs.existsSync(filePath))
+            fs.unlinkSync(filePath);
+    }
+    catch {
+        // Ignore cleanup errors
+    }
+}
+/**
+ * Resolve a value that may reference an environment variable.
+ * Supports ${VAR_NAME} syntax.
+ */
+function resolveEnvVar(value) {
+    if (!value)
+        return undefined;
+    const match = value.match(/^\$\{(.+)\}$/);
+    if (match) {
+        return process.env[match[1]] || undefined;
+    }
+    // Also check if the raw value is a plain env var name
+    if (value.startsWith("$")) {
+        return process.env[value.slice(1)] || undefined;
+    }
+    return value;
+}
+//# sourceMappingURL=resolver.js.map

package/dist/src/mcp/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../../src/mcp/resolver.ts"],"names":[],"mappings":"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"}

package/dist/src/sessions/context.d.ts

@@ -16,5 +16,6 @@ export declare function buildContext(opts: {
     portalName?: string;
     operatorName?: string;
     language?: string;
+    channelName?: string;
 }): string;
 //# sourceMappingURL=context.d.ts.map

package/dist/src/sessions/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/sessions/context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAK/D;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAqET"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/sessions/context.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAK/D;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,MAAM,CAqET"}

package/dist/src/sessions/context.js

@@ -60,7 +60,7 @@ export function buildContext(opts) {
         sections.push(envCtx);
     // ── Delegation protocol ──────────────────────────────────
     if (!opts.employee) {
-        sections.push(buildDelegationProtocol(gatewayUrl, portalName));
+        sections.push(buildDelegationProtocol(gatewayUrl, portalName, opts.config));
     }
     // ── Gateway API reference ─────────────────────────────────
     sections.push(buildApiReference(gatewayUrl, portalName));
@@ -140,7 +140,15 @@ function buildSessionContext(opts) {
     if (opts.sessionId)
         ctx += `- Session ID: ${opts.sessionId}\n`;
     ctx += `- Source: ${opts.source}\n`;
-    ctx += `- Channel: ${opts.channel}\n`;
+    if (opts.channelName) {
+        ctx += `- Channel: #${opts.channelName} (${opts.channel})\n`;
+    }
+    else if (opts.source === "slack" && opts.channel.startsWith("D")) {
+        ctx += `- Channel: Direct Message (${opts.channel})\n`;
+    }
+    else {
+        ctx += `- Channel: ${opts.channel}\n`;
+    }
     if (opts.thread)
         ctx += `- Thread: ${opts.thread}\n`;
     ctx += `- User: ${opts.user}\n`;
@@ -349,7 +357,13 @@ function trimContext(sections) {
     }
     return result;
 }
-function buildDelegationProtocol(gatewayUrl, _portalName) {
+function buildDelegationProtocol(gatewayUrl, _portalName, config) {
+    const defaultEngine = config?.engines.default || "claude";
+    const engineConfig = defaultEngine === "codex" ? config?.engines.codex : config?.engines.claude;
+    const childOverride = engineConfig?.childEffortOverride;
+    const effortOverrideNote = childOverride
+        ? `\n\n> **Note**: \`childEffortOverride\` is currently set to \`"${childOverride}"\` in config. All child sessions will use this effort level regardless of your per-task choice.`
+        : "";
     return `## Employee Delegation Protocol
 
 You are the COO. You NEVER become an employee — you orchestrate them. When the user mentions employees with \`@employee-name\` in their message, or when a task clearly fits an employee's role, you delegate by creating **linked child sessions**.
@@ -499,6 +513,23 @@ Managers need delegation instructions in their persona. When promoting an employ
 - They should apply oversight levels to their reports' work
 - They report summaries back to you (the COO)
 
+### Effort Level Management
+
+When delegating tasks, assess complexity and set \`effortLevel\` in the API request body:
+
+| Effort | Use for | Examples |
+|--------|---------|----------|
+| \`low\` | Simple lookups, status checks, information retrieval | "What's on the board?", "Check the latest run" |
+| \`medium\` | Standard tasks, content creation, routine analysis | "Write a blog post", "Analyze last week's metrics" |
+| \`high\` | Code changes, architecture, complex research, multi-step | "Refactor the auth module", "Design a new feature" |
+
+Include in your delegation API call:
+\`\`\`json
+{"prompt": "...", "employee": "...", "parentSessionId": "...", "effortLevel": "high"}
+\`\`\`
+
+If unsure, default to \`medium\`. Use your judgment — these are guidelines, not rigid rules. A trivial rename is \`low\` even though it's "code changes."${effortOverrideNote}
+
 ### Your session ID
 
 Your current session ID is provided in the "Current session" section above. Use it as \`parentSessionId\` when spawning children and for the \`/children\` lookup.`;