octo-vec 1.0.0

package/dist/onboarding.js

@@ -0,0 +1,188 @@
+/**
+ * First-run onboarding — creates ITS_ME.md if it doesn't exist.
+ * Prompts the user for their name, role, and optionally configures
+ * communication channels (Telegram, Slack, Discord).
+ * Also checks for Docker and offers to install it + pull scanner images.
+ */
+import { existsSync, writeFileSync } from "fs";
+import { join } from "path";
+import { execSync } from "child_process";
+import { platform } from "os";
+import readline from "readline";
+import { USER_DATA_DIR } from "./config.js";
+import { saveChannelCredentials, loadChannelConfig } from "./channels/channelConfig.js";
+const ITS_ME_PATH = join(USER_DATA_DIR, "ITS_ME.md");
+// ── Docker helpers ──────────────────────────────────────────────────────────
+function isDockerInstalled() {
+    try {
+        execSync("docker --version", { stdio: "pipe", timeout: 5000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isDockerRunning() {
+    try {
+        execSync("docker info", { stdio: "pipe", timeout: 10000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function getDockerInstallCmd() {
+    const os = platform();
+    if (os === "win32") {
+        return { cmd: "winget install -e --id Docker.DockerDesktop", label: "winget (Docker Desktop)" };
+    }
+    if (os === "darwin") {
+        return { cmd: "brew install --cask docker", label: "Homebrew (Docker Desktop)" };
+    }
+    if (os === "linux") {
+        return { cmd: "curl -fsSL https://get.docker.com | sh", label: "get.docker.com (Docker Engine)" };
+    }
+    return null;
+}
+async function checkAndInstallDocker(ask) {
+    console.log("  ── Dependencies: Docker ──\n");
+    if (isDockerInstalled()) {
+        console.log("  ✓ Docker is installed.");
+        if (isDockerRunning()) {
+            console.log("  ✓ Docker daemon is running.\n");
+        }
+        else {
+            console.log("  ⚠ Docker daemon is NOT running.");
+            console.log("  Start Docker to use security scanners and integrations.\n");
+        }
+        return;
+    }
+    console.log("  ✗ Docker not found on this system.\n");
+    console.log("  Docker is needed for security scanning integrations");
+    console.log("  (Gitleaks, Semgrep, Trivy, SonarQube).\n");
+    console.log("  You can enable/disable individual tools later from the Dashboard.\n");
+    const installInfo = getDockerInstallCmd();
+    if (installInfo) {
+        const doInstall = await ask(`  Install Docker via ${installInfo.label}? (y/N): `);
+        if (doInstall.toLowerCase() === "y" || doInstall.toLowerCase() === "yes") {
+            console.log(`\n  Running: ${installInfo.cmd}\n`);
+            try {
+                execSync(installInfo.cmd, { stdio: "inherit", timeout: 300000 });
+                console.log("\n  ✓ Docker installed successfully!");
+                if (platform() !== "linux") {
+                    console.log("  Note: Start Docker Desktop and restart your terminal before using scanners.\n");
+                }
+                else {
+                    console.log("");
+                }
+            }
+            catch {
+                console.log(`\n  ✗ Installation failed. You may need admin/sudo privileges.`);
+                console.log(`  Try running manually: ${installInfo.cmd}\n`);
+            }
+        }
+        else {
+            console.log("  Skipped. Install Docker anytime — scanners are optional.\n");
+        }
+    }
+    else {
+        console.log("  Install Docker manually: https://docs.docker.com/get-docker/\n");
+    }
+}
+// ── Main onboarding ─────────────────────────────────────────────────────────
+export async function runOnboardingIfNeeded() {
+    if (existsSync(ITS_ME_PATH))
+        return;
+    console.log("");
+    console.log("  ╔══════════════════════════════════════════════╗");
+    console.log("  ║        Welcome to OCTO VEC!                  ║");
+    console.log("  ║        Let's get you set up.                 ║");
+    console.log("  ╚══════════════════════════════════════════════╝");
+    console.log("");
+    console.log(`  Your data will be stored at: ${USER_DATA_DIR}`);
+    console.log("");
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const ask = (q) => new Promise((resolve) => rl.question(q, (ans) => resolve(ans.trim())));
+    // ── Pre-step: Docker check ─────────────────────────────────────────────
+    await checkAndInstallDocker(ask);
+    // ── Step 1: Profile ─────────────────────────────────────────────────────
+    console.log("  ── Step 1: Your Profile ──\n");
+    const name = (await ask("  Your name (press Enter for 'User'): ")) || "User";
+    const role = (await ask("  Your role (press Enter for 'Founder & CEO'): ")) || "Founder & CEO";
+    const content = `**Name:** ${name}\n**Role:** ${role}\n`;
+    writeFileSync(ITS_ME_PATH, content, "utf-8");
+    console.log(`\n  Profile saved. Your agents will call you "${name}".\n`);
+    // ── Step 2: Integrations (optional) ─────────────────────────────────────
+    console.log("  ── Step 2: Communication Channels (optional) ──\n");
+    console.log("  OCTO VEC can connect to messaging platforms so you can");
+    console.log("  talk to your agents from Telegram, Slack, or Discord.\n");
+    console.log("  You can skip this now and configure later from the Dashboard.\n");
+    const setupChannels = await ask("  Configure channels now? (y/N): ");
+    if (setupChannels.toLowerCase() === "y" || setupChannels.toLowerCase() === "yes") {
+        // ── Telegram ──
+        console.log("\n  ── Telegram ──");
+        console.log("  Needs: Bot Token (from @BotFather) + Chat ID\n");
+        const setupTg = await ask("  Set up Telegram? (y/N): ");
+        if (setupTg.toLowerCase() === "y" || setupTg.toLowerCase() === "yes") {
+            const tgToken = await ask("  Bot Token: ");
+            const tgChatId = await ask("  Chat ID: ");
+            if (tgToken && tgChatId) {
+                saveChannelCredentials("telegram", { botToken: tgToken, chatId: tgChatId });
+                console.log("  Telegram configured.\n");
+            }
+            else {
+                console.log("  Skipped (missing values).\n");
+            }
+        }
+        // ── Slack ──
+        console.log("  ── Slack ──");
+        console.log("  Needs: Bot Token (xoxb-...), App Token (xapp-...), Channel ID\n");
+        const setupSlack = await ask("  Set up Slack? (y/N): ");
+        if (setupSlack.toLowerCase() === "y" || setupSlack.toLowerCase() === "yes") {
+            const slackBot = await ask("  Bot Token (xoxb-...): ");
+            const slackApp = await ask("  App Token (xapp-...): ");
+            const slackCh = await ask("  Channel ID: ");
+            if (slackBot && slackApp && slackCh) {
+                saveChannelCredentials("slack", { botToken: slackBot, appToken: slackApp, channelId: slackCh });
+                console.log("  Slack configured.\n");
+            }
+            else {
+                console.log("  Skipped (missing values).\n");
+            }
+        }
+        // ── Discord ──
+        console.log("  ── Discord ──");
+        console.log("  Needs: Bot Token (from Developer Portal) + Channel ID\n");
+        const setupDiscord = await ask("  Set up Discord? (y/N): ");
+        if (setupDiscord.toLowerCase() === "y" || setupDiscord.toLowerCase() === "yes") {
+            const dcToken = await ask("  Bot Token: ");
+            const dcChannel = await ask("  Channel ID: ");
+            if (dcToken && dcChannel) {
+                saveChannelCredentials("discord", { botToken: dcToken, channelId: dcChannel });
+                console.log("  Discord configured.\n");
+            }
+            else {
+                console.log("  Skipped (missing values).\n");
+            }
+        }
+    }
+    else {
+        console.log("  Skipped. You can configure channels anytime from the Dashboard Settings.\n");
+    }
+    // ── Done ────────────────────────────────────────────────────────────────
+    const cfg = loadChannelConfig();
+    const activeChannels = [
+        cfg.telegram ? "Telegram" : null,
+        cfg.slack ? "Slack" : null,
+        cfg.discord ? "Discord" : null,
+    ].filter(Boolean);
+    console.log("  ── Setup Complete ──\n");
+    console.log(`  Profile  : ${name} (${role})`);
+    console.log(`  Data Dir : ${USER_DATA_DIR}`);
+    console.log(`  Channels : ${activeChannels.length ? activeChannels.join(", ") : "None (CLI + Dashboard only)"}`);
+    console.log("");
+    console.log("  Tip: Open the Dashboard at http://localhost:3000 to manage everything visually.");
+    console.log("");
+    rl.close();
+}
+//# sourceMappingURL=onboarding.js.map

package/dist/onboarding.js.map

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

package/dist/tools/domain/baFileTools.d.ts

@@ -0,0 +1,7 @@
+/**
+ * BA file tools — read, write, edit restricted to .md and .mmd (documentation) files only.
+ * BA's role is writing documentation, not reading or modifying code files.
+ */
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+export declare function getBAFileTools(): AgentTool[];
+//# sourceMappingURL=baFileTools.d.ts.map

package/dist/tools/domain/baFileTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baFileTools.d.ts","sourceRoot":"","sources":["../../../src/tools/domain/baFileTools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAsC7D,wBAAgB,cAAc,IAAI,SAAS,EAAE,CAsB5C"}

package/dist/tools/domain/baFileTools.js

@@ -0,0 +1,46 @@
+/**
+ * BA file tools — read, write, edit restricted to .md and .mmd (documentation) files only.
+ * BA's role is writing documentation, not reading or modifying code files.
+ */
+import { getCodingTools } from "../shared/fileTools.js";
+const ALLOWED_EXTENSIONS = [".md", ".mmd"];
+function isAllowed(filePath) {
+    const lower = (filePath ?? "").toLowerCase();
+    return ALLOWED_EXTENSIONS.some((ext) => lower.endsWith(ext));
+}
+function blocked(toolName, filePath) {
+    return {
+        content: [{
+                type: "text",
+                text: `BLOCKED: '${toolName}' is restricted to .md and .mmd files only.\n` +
+                    `'${filePath}' is not a documentation file.\n` +
+                    `BA role: write and edit documentation files (.md, .mmd). Reading or modifying code files is not your responsibility.\n` +
+                    `Save deliverables as .md files in shared/ or agents/ba/.`,
+            }],
+        details: {},
+    };
+}
+function wrap(tool, toolName, descriptionOverride) {
+    return {
+        ...tool,
+        description: descriptionOverride,
+        execute: async (ctx, params) => {
+            const filePath = params?.path ?? params?.file_path ?? "";
+            if (filePath && !isAllowed(filePath)) {
+                return blocked(toolName, filePath);
+            }
+            return tool.execute(ctx, params);
+        },
+    };
+}
+export function getBAFileTools() {
+    const base = getCodingTools();
+    const byName = new Map(base.map((t) => [t.name, t]));
+    return [
+        wrap(byName.get("read"), "read", "Read a .md or .mmd documentation file from disk. Only .md and .mmd files are permitted."),
+        wrap(byName.get("write"), "write", "Write a .md or .mmd documentation file. Only .md and .mmd extensions are allowed — BA writes documentation, not code."),
+        wrap(byName.get("edit"), "edit", "Make targeted edits to a .md or .mmd documentation file. Only .md and .mmd files are allowed."),
+        // bash intentionally excluded — BA does not run shell commands
+    ];
+}
+//# sourceMappingURL=baFileTools.js.map

package/dist/tools/domain/baFileTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baFileTools.js","sourceRoot":"","sources":["../../../src/tools/domain/baFileTools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAE3C,SAAS,SAAS,CAAC,QAAgB;IACjC,MAAM,KAAK,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7C,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,OAAO,CAAC,QAAgB,EAAE,QAAgB;IACjD,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAe;gBACrB,IAAI,EACF,aAAa,QAAQ,+CAA+C;oBACpE,IAAI,QAAQ,kCAAkC;oBAC9C,wHAAwH;oBACxH,0DAA0D;aAC7D,CAAC;QACF,OAAO,EAAE,EAAE;KACZ,CAAC;AACJ,CAAC;AAED,SAAS,IAAI,CAAC,IAAe,EAAE,QAAgB,EAAE,mBAA2B;IAC1E,OAAO;QACL,GAAG,IAAI;QACP,WAAW,EAAE,mBAAmB;QAChC,OAAO,EAAE,KAAK,EAAE,GAAQ,EAAE,MAAW,EAAE,EAAE;YACvC,MAAM,QAAQ,GAAW,MAAM,EAAE,IAAI,IAAI,MAAM,EAAE,SAAS,IAAI,EAAE,CAAC;YACjE,IAAI,QAAQ,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACrC,OAAO,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACrC,CAAC;YACD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACnC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAErD,OAAO;QACL,IAAI,CACF,MAAM,CAAC,GAAG,CAAC,MAAM,CAAE,EACnB,MAAM,EACN,yFAAyF,CAC1F;QACD,IAAI,CACF,MAAM,CAAC,GAAG,CAAC,OAAO,CAAE,EACpB,OAAO,EACP,uHAAuH,CACxH;QACD,IAAI,CACF,MAAM,CAAC,GAAG,CAAC,MAAM,CAAE,EACnB,MAAM,EACN,+FAA+F,CAChG;QACD,+DAA+D;KAChE,CAAC;AACJ,CAAC"}

package/dist/tools/domain/baTools.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Business Analyst domain tools — template scaffolds for the LLM to populate.
+ */
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+export declare const baTools: AgentTool[];
+//# sourceMappingURL=baTools.d.ts.map

package/dist/tools/domain/baTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baTools.d.ts","sourceRoot":"","sources":["../../../src/tools/domain/baTools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAQ7D,eAAO,MAAM,OAAO,EAAE,SAAS,EAwJ9B,CAAC"}

package/dist/tools/domain/baTools.js

@@ -0,0 +1,160 @@
+/**
+ * Business Analyst domain tools — template scaffolds for the LLM to populate.
+ */
+import { Type } from "@mariozechner/pi-ai";
+import { EventLog } from "../../atp/eventLog.js";
+import { EventType } from "../../atp/models.js";
+function ok(text) {
+    return { content: [{ type: "text", text }], details: {} };
+}
+export const baTools = [
+    {
+        name: "analyze_requirements",
+        label: "Analyze Requirements",
+        description: "Analyze business requirements and break them down into a structured format.",
+        parameters: Type.Object({
+            requirement_text: Type.String({ description: "The business requirement to analyze" }),
+            task_id: Type.Optional(Type.String({ description: "Optional ATP task ID for tracking" })),
+        }),
+        execute: async (_, params) => {
+            EventLog.log(EventType.AGENT_TOOL_CALL, "ba", params.task_id ?? "", "BA analyzing requirements");
+            return ok(`## REQUIREMENT ANALYSIS
+
+**Original Requirement:** ${params.requirement_text}
+
+### 1. OBJECTIVE
+- **What**: [Core goal to be achieved]
+- **Why**: [Business value/justification]
+
+### 2. STAKEHOLDERS
+- **Primary**: [Direct beneficiaries]
+- **Secondary**: [Indirect stakeholders]
+
+### 3. ACCEPTANCE CRITERIA
+- Given [initial context/state]
+- When [action/trigger]
+- Then [expected outcome]
+
+### 4. DEPENDENCIES
+- Technical: [Systems/APIs/Infrastructure]
+- Business: [Processes/Teams/Data]
+
+### 5. RISKS & ASSUMPTIONS
+- Risks: [Potential blockers]
+- Assumptions: [What we're assuming is true]
+
+### 6. SUCCESS METRICS
+- KPIs: [How we'll measure success]`);
+        },
+    },
+    {
+        name: "create_user_story",
+        label: "Create User Story",
+        description: "Convert a feature description into proper user stories with acceptance criteria.",
+        parameters: Type.Object({
+            feature_description: Type.String({ description: "Description of the feature" }),
+            task_id: Type.Optional(Type.String({ description: "Optional ATP task ID for tracking" })),
+        }),
+        execute: async (_, params) => {
+            EventLog.log(EventType.AGENT_TOOL_CALL, "ba", params.task_id ?? "", "BA creating user story");
+            return ok(`## USER STORY
+
+**Based on:** ${params.feature_description}
+
+**As a** [user type],
+**I want to** [action/feature],
+**So that** [benefit/value].
+
+### Acceptance Criteria:
+
+**Scenario 1: Happy Path**
+- Given [initial state]
+- When [user action]
+- Then [expected result]
+
+**Scenario 2: Edge Case**
+- Given [different state]
+- When [user action]
+- Then [expected handling]
+
+### Definition of Done:
+- [ ] Functionality implemented and tested
+- [ ] Code reviewed and merged
+- [ ] Documentation updated
+- [ ] QA sign-off received
+
+**Story Points:** [To be estimated]
+**Priority:** [To be defined]`);
+        },
+    },
+    {
+        name: "perform_gap_analysis",
+        label: "Perform Gap Analysis",
+        description: "Identify gaps between current state and desired future state.",
+        parameters: Type.Object({
+            current_state: Type.String({ description: "Description of the current state/situation" }),
+            desired_state: Type.String({ description: "Description of the desired future state" }),
+            task_id: Type.Optional(Type.String({ description: "Optional ATP task ID for tracking" })),
+        }),
+        execute: async (_, params) => {
+            EventLog.log(EventType.AGENT_TOOL_CALL, "ba", params.task_id ?? "", "BA performing gap analysis");
+            return ok(`## GAP ANALYSIS
+
+**Current State:** ${params.current_state}
+**Desired State:** ${params.desired_state}
+
+### GAPS IDENTIFIED
+
+| Gap | Impact | Effort | Priority |
+|-----|--------|--------|----------|
+| [Gap 1] | High/Med/Low | High/Med/Low | P1/P2/P3 |
+| [Gap 2] | High/Med/Low | High/Med/Low | P1/P2/P3 |
+
+### RECOMMENDED ACTIONS
+1. **[Action 1]** — Owner: [Team/Agent], Timeline: [Estimate]
+2. **[Action 2]** — Owner: [Team/Agent], Timeline: [Estimate]
+
+### RISKS OF NOT CLOSING GAPS
+- [Risk if gap remains]
+
+### SUCCESS METRICS
+- [KPI 1]: [Target value]
+- [KPI 2]: [Target value]`);
+        },
+    },
+    {
+        name: "define_kpis",
+        label: "Define KPIs",
+        description: "Define measurable KPIs and success metrics for a project or feature.",
+        parameters: Type.Object({
+            project_description: Type.String({ description: "Project or feature to define KPIs for" }),
+            task_id: Type.Optional(Type.String({ description: "Optional ATP task ID for tracking" })),
+        }),
+        execute: async (_, params) => {
+            EventLog.log(EventType.AGENT_TOOL_CALL, "ba", params.task_id ?? "", "BA defining KPIs");
+            return ok(`## KPI DEFINITION
+
+**Project:** ${params.project_description}
+
+### KEY PERFORMANCE INDICATORS
+
+| KPI | Description | Measurement Method | Target | Baseline | Frequency |
+|-----|-------------|-------------------|--------|----------|-----------|
+| [KPI 1] | [What it measures] | [How measured] | [Target] | [Current] | [Daily/Weekly] |
+| [KPI 2] | [What it measures] | [How measured] | [Target] | [Current] | [Daily/Weekly] |
+
+### LEADING INDICATORS (Predictive)
+- [Indicator 1]: Predicts [outcome]
+- [Indicator 2]: Predicts [outcome]
+
+### LAGGING INDICATORS (Outcome)
+- [Indicator 1]: Measures [result]
+
+### REPORTING DASHBOARD
+- Tool: [Analytics platform]
+- Refresh: [Frequency]
+- Stakeholders: [Who receives reports]`);
+        },
+    },
+];
+//# sourceMappingURL=baTools.js.map

package/dist/tools/domain/baTools.js.map

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

package/dist/tools/domain/baseSpecialistTools.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Common task-management tools shared by all 8 specialist agents.
+ * Factory that injects the agent's ID and required dependencies.
+ *
+ * Tools:
+ *   read_my_tasks, read_task_details, update_my_task, read_task_messages
+ *
+ * Usage:
+ *   import { getSpecialistTaskTools } from "./baseSpecialistTools.js";
+ *   tools: [...getSpecialistTaskTools("ba", { db, pmQueue, agentQueue }), ...]
+ */
+import type { AgentTool } from "@mariozechner/pi-agent-core";
+import { ATPDatabase } from "../../atp/database.js";
+import { MessageQueue } from "../../atp/messageQueue.js";
+import { AgentMessageQueue } from "../../atp/agentMessageQueue.js";
+export interface SpecialistTaskDeps {
+    db: typeof ATPDatabase;
+    pmQueue: typeof MessageQueue;
+    agentQueue: typeof AgentMessageQueue;
+}
+export declare function getSpecialistTaskTools(agentId: string, deps: SpecialistTaskDeps): AgentTool[];
+//# sourceMappingURL=baseSpecialistTools.d.ts.map

package/dist/tools/domain/baseSpecialistTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseSpecialistTools.d.ts","sourceRoot":"","sources":["../../../src/tools/domain/baseSpecialistTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAKnE,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,OAAO,WAAW,CAAC;IACvB,OAAO,EAAE,OAAO,YAAY,CAAC;IAC7B,UAAU,EAAE,OAAO,iBAAiB,CAAC;CACtC;AAgBD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,SAAS,EAAE,CAuN7F"}

package/dist/tools/domain/baseSpecialistTools.js

@@ -0,0 +1,183 @@
+/**
+ * Common task-management tools shared by all 8 specialist agents.
+ * Factory that injects the agent's ID and required dependencies.
+ *
+ * Tools:
+ *   read_my_tasks, read_task_details, update_my_task, read_task_messages
+ *
+ * Usage:
+ *   import { getSpecialistTaskTools } from "./baseSpecialistTools.js";
+ *   tools: [...getSpecialistTaskTools("ba", { db, pmQueue, agentQueue }), ...]
+ */
+import { Type } from "@mariozechner/pi-ai";
+import { EventLog } from "../../atp/eventLog.js";
+import { EventType } from "../../atp/models.js";
+import { AgentInterrupt } from "../../atp/agentInterrupt.js";
+const TASK_ID_RE = /^TASK-\d+$/;
+function normalizeTaskId(taskId) {
+    return taskId.trim().toUpperCase();
+}
+function isValidTaskId(taskId) {
+    return TASK_ID_RE.test(taskId);
+}
+function ok(text) {
+    return { content: [{ type: "text", text }], details: {} };
+}
+export function getSpecialistTaskTools(agentId, deps) {
+    const read_my_tasks = {
+        name: "read_my_tasks",
+        label: "Read My Tasks",
+        description: "Read tasks assigned to you from ATP, optionally filtered by status. " +
+            "Use this to see what work you have pending or in progress.",
+        parameters: Type.Object({
+            status: Type.Optional(Type.String({
+                description: "Filter by status: 'pending', 'in_progress', 'completed', 'failed', or empty for all",
+            })),
+        }),
+        execute: async (_, params) => {
+            AgentInterrupt.check(agentId);
+            const statusFilter = (params.status ?? "").trim().toLowerCase();
+            const allowed = new Set(["", "pending", "in_progress", "completed", "failed"]);
+            if (!allowed.has(statusFilter)) {
+                return ok("ERROR: Invalid status. Use pending, in_progress, completed, failed, or empty.");
+            }
+            const tasks = deps.db.getTasksForAgent(agentId, statusFilter || undefined);
+            if (!tasks.length) {
+                return ok(`No tasks found for ${agentId}${statusFilter ? ` with status '${statusFilter}'` : ""}.`);
+            }
+            const priorityRank = { high: 0, medium: 1, low: 2 };
+            const statusRank = { in_progress: 0, pending: 1, failed: 2, completed: 3 };
+            const sorted = [...tasks].sort((a, b) => (statusRank[a.status] ?? 99) - (statusRank[b.status] ?? 99) ||
+                (priorityRank[a.priority] ?? 99) - (priorityRank[b.priority] ?? 99) ||
+                a.created_at.localeCompare(b.created_at));
+            EventLog.log(EventType.AGENT_TOOL_CALL, agentId, "", `${agentId.toUpperCase()} reading own task queue (filter=${statusFilter || "all"})`);
+            const lines = [`${agentId.toUpperCase()} task queue (${sorted.length} task(s)):`];
+            for (const t of sorted) {
+                lines.push(`- ${t.task_id} | ${t.priority.toUpperCase()} | ${t.status} | ${t.description}`);
+            }
+            return ok(lines.join("\n"));
+        },
+    };
+    const read_task_details = {
+        name: "read_task_details",
+        label: "Read Task Details",
+        description: "Read full details for a specific ATP task ID assigned to you.",
+        parameters: Type.Object({
+            task_id: Type.String({ description: "ATP task ID (e.g. 'TASK-001')" }),
+        }),
+        execute: async (_, params) => {
+            AgentInterrupt.check(agentId);
+            const normalizedId = normalizeTaskId(params.task_id);
+            if (!isValidTaskId(normalizedId)) {
+                return ok(`ERROR: Invalid task ID '${params.task_id}'. Expected format TASK-XXX.`);
+            }
+            const task = deps.db.getTask(normalizedId);
+            if (!task)
+                return ok(`ERROR: Task ${normalizedId} not found.`);
+            if (task.agent_id !== agentId) {
+                return ok(`ERROR: Task ${normalizedId} is assigned to '${task.agent_id}', not ${agentId}.`);
+            }
+            EventLog.log(EventType.AGENT_TOOL_CALL, agentId, normalizedId, `${agentId.toUpperCase()} reading details for ${normalizedId}`);
+            return ok(`Task: ${task.task_id}\n` +
+                `  Description: ${task.description}\n` +
+                `  Assigned to: ${task.agent_id}\n` +
+                `  Priority: ${task.priority}\n` +
+                `  Status: ${task.status}\n` +
+                `  Folder Access: ${task.folder_access || "N/A"}\n` +
+                `  Result: ${task.result || "N/A"}\n` +
+                `  Created: ${task.created_at}\n` +
+                `  Updated: ${task.updated_at}`);
+        },
+    };
+    const update_my_task = {
+        name: "update_my_task",
+        label: "Update My Task",
+        description: "Update a task's status in ATP and notify PM. " +
+            "Call this when you start, complete, or fail a task.",
+        parameters: Type.Object({
+            task_id: Type.String({ description: "ATP task ID (e.g. 'TASK-001')" }),
+            status: Type.Union([Type.Literal("in_progress"), Type.Literal("completed"), Type.Literal("failed")], { description: "'in_progress', 'completed', or 'failed'" }),
+            result: Type.Optional(Type.String({ description: "Deliverable summary or status message (max 4000 chars)" })),
+        }),
+        execute: async (_, params) => {
+            AgentInterrupt.check(agentId);
+            const normalizedId = normalizeTaskId(params.task_id);
+            if (!isValidTaskId(normalizedId)) {
+                return ok(`ERROR: Invalid task ID '${params.task_id}'.`);
+            }
+            const task = deps.db.getTask(normalizedId);
+            if (!task)
+                return ok(`ERROR: Task ${normalizedId} not found.`);
+            if (task.agent_id !== agentId) {
+                return ok(`ERROR: Task ${normalizedId} is not assigned to ${agentId}.`);
+            }
+            const result = (params.result ?? "").slice(0, 4000);
+            deps.db.updateTaskStatus(normalizedId, params.status, result);
+            deps.pmQueue.pushSimple(agentId, normalizedId, `Task ${normalizedId} status -> ${params.status}: ${result.slice(0, 200)}`, "status_update");
+            const eventType = params.status === "completed"
+                ? EventType.TASK_COMPLETED
+                : params.status === "failed"
+                    ? EventType.TASK_FAILED
+                    : EventType.TASK_IN_PROGRESS;
+            EventLog.log(eventType, agentId, normalizedId, `${agentId.toUpperCase()} updated ${normalizedId} -> ${params.status}`);
+            EventLog.log(EventType.MESSAGE_SENT, agentId, normalizedId, `${agentId.toUpperCase()} notified PM about ${normalizedId}`);
+            return ok(`Task ${normalizedId} updated to '${params.status}'. PM has been notified.`);
+        },
+    };
+    const read_task_messages = {
+        name: "read_task_messages",
+        label: "Read Task Messages",
+        description: "Read PM messages for a specific task. Use at checkpoints to check for priority instructions.",
+        parameters: Type.Object({
+            task_id: Type.String({ description: "ATP task ID (e.g. 'TASK-001')" }),
+            priority: Type.Optional(Type.Union([Type.Literal("normal"), Type.Literal("priority")], {
+                description: "'normal' or 'priority' (default: normal)",
+            })),
+        }),
+        execute: async (_, params) => {
+            AgentInterrupt.check(agentId);
+            const normalizedId = normalizeTaskId(params.task_id);
+            if (!isValidTaskId(normalizedId)) {
+                return ok(`ERROR: Invalid task ID '${params.task_id}'. Expected format TASK-XXX.`);
+            }
+            const priority = (params.priority ?? "normal");
+            const messages = deps.agentQueue.popForAgent(agentId, {
+                task_id: normalizedId,
+                priority,
+            });
+            if (!messages.length) {
+                return ok(`No ${priority} messages for ${normalizedId}.`);
+            }
+            EventLog.log(EventType.AGENT_TOOL_CALL, agentId, normalizedId, `${agentId.toUpperCase()} read ${messages.length} ${priority} message(s)`);
+            const lines = [`${messages.length} ${priority} message(s) for ${normalizedId}:`];
+            for (let i = 0; i < messages.length; i++) {
+                lines.push(`${i + 1}. [${messages[i].from_agent}] ${messages[i].message}`);
+            }
+            return ok(lines.join("\n"));
+        },
+    };
+    const self_assign_task = {
+        name: "self_assign_task",
+        label: "Self-Assign Task",
+        description: "Create a new task for yourself and mark it in_progress immediately. " +
+            "Use this when the founder gives you a direct work request and there is no existing task for it. " +
+            "After calling this, the system will automatically route you into full task execution mode.",
+        parameters: Type.Object({
+            description: Type.String({ description: "Clear description of what needs to be built or done" }),
+            priority: Type.Optional(Type.Union([Type.Literal("high"), Type.Literal("medium"), Type.Literal("low")], { description: "Task priority (default: high for direct founder requests)" })),
+        }),
+        execute: async (_, params) => {
+            AgentInterrupt.check(agentId);
+            const priority = (params.priority ?? "high");
+            const task = deps.db.createTask(params.description, agentId, priority);
+            deps.db.updateTaskStatus(task.task_id, "in_progress");
+            EventLog.log(EventType.TASK_IN_PROGRESS, agentId, task.task_id, `${agentId.toUpperCase()} self-assigned ${task.task_id}: ${params.description}`);
+            deps.pmQueue.pushSimple(agentId, task.task_id, `${agentId.toUpperCase()} self-assigned task ${task.task_id} from direct founder request: ${params.description}`, "info");
+            return ok(`Task ${task.task_id} created and marked in_progress.\n` +
+                `Description: ${params.description}\n` +
+                `The system will now route you into full task execution. Stand by.`);
+        },
+    };
+    return [read_my_tasks, read_task_details, update_my_task, read_task_messages, self_assign_task];
+}
+//# sourceMappingURL=baseSpecialistTools.js.map