agentopia 1.0.0

package/dist/services/pre-controller.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Pre-Controller: 系统级规则引擎，在 LLM controller 之前拦截简单编排场景。
+ * 返回 true = 已处理，不需要 LLM controller
+ * 返回 false = 需要 LLM controller 接手
+ */
+export declare function tryHandleWithoutLLM(projectId: string, triggerIssueNumber?: number): boolean;
+//# sourceMappingURL=pre-controller.d.ts.map

package/dist/services/pre-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-controller.d.ts","sourceRoot":"","sources":["../../src/services/pre-controller.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAoG3F"}

package/dist/services/pre-controller.js

@@ -0,0 +1,101 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tryHandleWithoutLLM = tryHandleWithoutLLM;
+const database_1 = require("../db/database");
+const process_manager_1 = require("./process-manager");
+const agent_issue_batch_1 = require("./agent-issue-batch");
+const system_prompt_1 = require("./system-prompt");
+const config_1 = require("../config");
+const logger_1 = __importDefault(require("../logger"));
+/**
+ * Pre-Controller: 系统级规则引擎，在 LLM controller 之前拦截简单编排场景。
+ * 返回 true = 已处理，不需要 LLM controller
+ * 返回 false = 需要 LLM controller 接手
+ */
+function tryHandleWithoutLLM(projectId, triggerIssueNumber) {
+    if (!triggerIssueNumber)
+        return false;
+    const db = (0, database_1.getDatabase)();
+    const issue = db.prepare('SELECT * FROM issues WHERE project_id = ? AND number = ?').get(projectId, triggerIssueNumber);
+    if (!issue)
+        return false;
+    // 规则2: issue assigned_to = "user" → 无需操作
+    if (issue.assigned_to === 'user') {
+        logger_1.default.info(`Pre-controller: issue #${triggerIssueNumber} assigned to user, skipping LLM`);
+        return true;
+    }
+    // 规则2b: issue is pending (waiting for child issues) → 无需操作
+    if (issue.status === 'pending') {
+        logger_1.default.info(`Pre-controller: issue #${triggerIssueNumber} is pending (waiting for children), skipping LLM`);
+        return true;
+    }
+    // 规则3: issue 已完成 (done/closed) → 检查是否还有其他需要 controller 处理的 issue
+    if (issue.status === 'done' || issue.status === 'closed') {
+        const pendingForController = db.prepare(`SELECT 1 FROM issues WHERE project_id = ? AND status IN ('open', 'in_progress')
+       AND (assigned_to IS NULL OR assigned_to = 'all' OR assigned_to IN (
+         SELECT id FROM agents WHERE project_id = ? AND is_controller = 1
+       )) LIMIT 1`).get(projectId, projectId);
+        if (!pendingForController) {
+            logger_1.default.info(`Pre-controller: issue #${triggerIssueNumber} is ${issue.status}, no pending controller issues, skipping LLM`);
+            return true;
+        }
+        // 还有待处理的 issue 需要 controller 决策
+        return false;
+    }
+    // 规则1: issue 分配给具体 worker agent 且 agent idle → 直接启动
+    if (issue.assigned_to && issue.assigned_to !== 'all') {
+        const agent = db.prepare('SELECT * FROM agents WHERE id = ? AND project_id = ?').get(issue.assigned_to, projectId);
+        if (!agent)
+            return false; // agent 不存在，交给 LLM
+        // 是 controller → 交给 LLM controller 处理
+        if (agent.is_controller)
+            return false;
+        // agent 被暂停 → 交给 LLM controller 处理
+        if (agent.paused)
+            return false;
+        // agent 正在运行 → 无需操作（它会处理）
+        if (agent.status === 'running' || (0, process_manager_1.isAgentRunning)(agent.id)) {
+            logger_1.default.info(`Pre-controller: issue #${triggerIssueNumber} assigned to ${agent.name} which is running, skipping LLM`);
+            return true;
+        }
+        // agent in cooldown → skip restart, treat as handled (will restart after cooldown)
+        if (agent.status === 'idle' && (0, process_manager_1.isAgentInCooldown)(agent.id)) {
+            logger_1.default.info(`Pre-controller: agent ${agent.name} in restart cooldown, deferring start for issue #${triggerIssueNumber}`);
+            return true;
+        }
+        // agent idle → 直接启动，但每轮只处理一个小批次，避免 prompt 过载
+        // New issue assigned = new work, so reset any low-output skip state
+        if (agent.status === 'idle') {
+            (0, process_manager_1.resetAutoRestartSkip)(agent.id);
+            const project = db.prepare('SELECT * FROM projects WHERE id = ?').get(projectId);
+            if (!project)
+                return false;
+            const allAssigned = db.prepare("SELECT * FROM issues WHERE project_id = ? AND assigned_to = ? AND status IN ('open', 'in_progress') ORDER BY priority DESC, created_at").all(projectId, agent.id);
+            const issueBatch = (0, agent_issue_batch_1.getAgentIssueBatch)(allAssigned);
+            const parts = [];
+            if (agent.role)
+                parts.push(`Role: ${agent.role}`);
+            if (project.task_description)
+                parts.push(`Task: ${project.task_description}`);
+            if (issueBatch.currentBatch.length > 0) {
+                parts.push((0, agent_issue_batch_1.buildAssignedIssuesPrompt)(issueBatch));
+                (0, agent_issue_batch_1.markCurrentBatchInProgress)(db, issueBatch);
+            }
+            const prompt = parts.join('\n\n');
+            if (!prompt)
+                return false;
+            const commandTemplate = agent.command_template || project.command_template || config_1.config.defaultCommandTemplate;
+            const isRawShell = /^\s*(bash|sh|zsh)\s+-c\b/.test(commandTemplate);
+            const systemPrompt = isRawShell ? undefined : (0, system_prompt_1.buildSystemPrompt)(agent, project);
+            logger_1.default.info(`Pre-controller: directly starting ${agent.name} for ${issueBatch.currentBatch.length}/${issueBatch.activeIssues.length} issue(s) in current batch (triggered by #${triggerIssueNumber}), bypassing LLM controller`);
+            (0, process_manager_1.startAgentProcess)(agent, prompt, commandTemplate, systemPrompt);
+            return true;
+        }
+    }
+    // 默认: 交给 LLM controller
+    return false;
+}
+//# sourceMappingURL=pre-controller.js.map

package/dist/services/pre-controller.js.map

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

package/dist/services/process-manager.d.ts

@@ -0,0 +1,67 @@
+import { Agent } from '../types';
+declare const DEFAULT_IDLE_TIMEOUT_MS: number;
+declare const FINAL_RESULT_KILL_DELAY_MS: number;
+declare const RESTART_COOLDOWN_MS: number;
+declare const MAX_CONSECUTIVE_LOW_OUTPUT = 2;
+export type OnAgentFinishCallback = (agent: Agent, exitCode: number | null) => void;
+export declare function setOnAgentFinish(cb: OnAgentFinishCallback | null): void;
+export declare function classifyAgentExitStatus(input: {
+    currentStatus?: string | null;
+    exitCode: number | null;
+    requiresCompletionSignal: boolean;
+    sawClosedStdinSessionError: boolean;
+    sawCompletionSignal: boolean;
+    hadFinalResult: boolean;
+}): 'idle' | 'error' | 'stopped';
+export declare function startAgentProcess(agent: Agent, prompt: string, commandTemplate: string, systemPrompt?: string): {
+    runId: string;
+    pid: number;
+};
+/**
+ * Check child process CPU activity for watchdog.
+ * Returns:
+ *   'active'      — children exist and CPU time increased since last check
+ *   'stale'       — children exist but CPU unchanged for >= CPU_STALE_THRESHOLD scans
+ *   'warming'     — children exist, CPU unchanged but below threshold (give more time)
+ *   'no_children' — no descendant processes found
+ */
+export declare function checkChildCpuActivity(agentId: string, pid: number): 'active' | 'stale' | 'warming' | 'no_children';
+/** Clean up CPU snapshot when agent stops */
+export declare function clearCpuSnapshot(agentId: string): void;
+export declare function stopAgentProcess(agentId: string): boolean;
+export declare function isAgentRunning(agentId: string): boolean;
+/** Returns how many ms since the agent last produced output, or -1 if not tracked. */
+export declare function getAgentIdleMs(agentId: string): number;
+/** Reset the last activity timestamp to now (used by watchdog when child processes are detected). */
+export declare function resetAgentActivity(agentId: string): void;
+export { DEFAULT_IDLE_TIMEOUT_MS, FINAL_RESULT_KILL_DELAY_MS, RESTART_COOLDOWN_MS, MAX_CONSECUTIVE_LOW_OUTPUT };
+/** Returns true if the agent recently finished and should not be auto-restarted yet.
+ *  Uses extended cooldown (10 min) if the last run had very low output tokens,
+ *  indicating a "tail request" that didn't produce useful work. */
+export declare function isAgentInCooldown(agentId: string): boolean;
+/**
+ * Called from issue routes when a running agent marks all its assigned issues as done/closed.
+ * Signals that the agent's work is complete — subsequent low-output turns are likely tail requests.
+ */
+export declare function markAgentIssuesCompleted(agentId: string): void;
+/**
+ * Returns true if the agent should NOT be auto-restarted by scheduler/pre-controller.
+ * Blocks restart when:
+ * 1. Agent had 2+ consecutive low-output runs (clearly just doing tail confirmations)
+ * 2. Agent completed all issues AND had a low-output last run (work is done)
+ * The flag is cleared when new issues are assigned (checked externally).
+ */
+export declare function shouldSkipAutoRestart(agentId: string): boolean;
+/**
+ * Reset the auto-restart skip state for an agent.
+ * Called when new issues are assigned or agent state changes meaningfully.
+ */
+export declare function resetAutoRestartSkip(agentId: string): void;
+/**
+ * Returns how many ms since the agent received its final result, or -1 if no final result yet.
+ * Used by watchdog to force-kill agents whose child processes are stuck after completion.
+ */
+export declare function getAgentFinalResultAge(agentId: string): number;
+export declare function getRunningAgentIds(): string[];
+export declare function stopAllProcesses(): Promise<void>;
+//# sourceMappingURL=process-manager.d.ts.map

package/dist/services/process-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-manager.d.ts","sourceRoot":"","sources":["../../src/services/process-manager.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AASjC,QAAA,MAAM,uBAAuB,QAAiB,CAAC;AA2B/C,QAAA,MAAM,0BAA0B,QAAgB,CAAC;AAIjD,QAAA,MAAM,mBAAmB,QAAgB,CAAC;AAO1C,QAAA,MAAM,0BAA0B,IAAI,CAAC;AAwDrC,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;AAGpF,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,qBAAqB,GAAG,IAAI,GAAG,IAAI,CAEvE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,wBAAwB,EAAE,OAAO,CAAC;IAClC,0BAA0B,EAAE,OAAO,CAAC;IACpC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,cAAc,EAAE,OAAO,CAAC;CACzB,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAM/B;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,EACvB,YAAY,CAAC,EAAE,MAAM,GACpB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CA2iBhC;AA6CD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,aAAa,CA8BlH;AAED,6CAA6C;AAC7C,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEtD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAqCzD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,qGAAqG;AACrG,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAExD;AAED,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,CAAC;AAEhH;;mEAEmE;AACnE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAO1D;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAG9D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAW9D;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAG1D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C;AAED,wBAAgB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAiFhD"}