openai-code-assistant 1.0.1

package/README.md

@@ -0,0 +1,44 @@
+# Spey Project
+
+## Project Description
+Spey is an advanced agent-based system designed to facilitate automated task management through specialized agents. These agents include Customer Triage, Manager, Reviewer, and Supervisor, each handling specific operational domains like customer inquiry triage, task management, review processes, and supervision. Spey leverages OpenAI models to enhance automation and intelligence in handling workflows.
+
+## Setup Instructions
+1. Clone the repository.
+2. Install dependencies:
+   ```bash
+   npm install
+   ```
+3. Environment Configuration:
+   - Create a `.env` file in the root directory (if not existing).
+   - Set the following environment variables:
+     - `OPENAI_MODEL_NAME`: (Optional) OpenAI model to use. Defaults to `gpt-3.5-turbo` if unspecified.
+     - `AGENT_WORKSPACE_ROOT`: (Optional) Path to the workspace root directory. Defaults to current working directory.
+
+## Running Instructions
+Run the system using:
+```bash
+npm start
+```
+
+### Development vs Production
+- In development, you can run agents individually or in watch mode for rapid feedback (setup as needed).
+- Production mode runs the integrated system with all agents collaborating.
+
+## Typical Workflow Example with Agents
+- Customer Triage Agent receives and categorizes incoming customer requests.
+- Manager Agent allocates tasks and resources based on triage results.
+- Reviewer Agent audits completed tasks for quality assurance.
+- Supervisor Agent oversees overall system health and performance.
+
+## Key Configuration Constants (src/config.ts)
+- `OPENAI_MODEL_NAME`: Specifies the AI model name, defaults to "gpt-3.5-turbo" if not set.
+- `WORKSPACE_ROOT`: Absolute path to the project workspace root, defaulting to the current working directory, configurable via `AGENT_WORKSPACE_ROOT`.
+
+## Dependencies
+Spey uses key dependencies including:
+- `dotenv`: To load environment variables.
+- `OpenAI API Client` (assumed, based on usage): For interacting with OpenAI models.
+- Various utilities for file handling and workspace management.
+
+Feel free to explore the source codes under `src/` folder to understand the implementation details of each component.

package/dist/agents/customer-triage-agent.d.ts

@@ -0,0 +1,3 @@
+import { Agent } from "@openai/agents";
+export declare const customerFacingTriageAgent: Agent<unknown, "text">;
+//# sourceMappingURL=customer-triage-agent.d.ts.map

package/dist/agents/customer-triage-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customer-triage-agent.d.ts","sourceRoot":"","sources":["../../src/agents/customer-triage-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAqBvC,eAAO,MAAM,yBAAyB,wBAKpC,CAAC"}

package/dist/agents/customer-triage-agent.js

@@ -0,0 +1,26 @@
+import { Agent } from "@openai/agents";
+import { readWorkspaceFileTool } from "../tools/read-workspace.js";
+import { indexWorkspaceFilesTool } from "../tools/index-workspace.js";
+import { dynamicPromptTool } from "../tools/dynamic-prompt.js";
+import { OPENAI_MODEL_NAME } from "../config.js";
+const customerAgentInstruction = `You are the intake specialist. Your job is to translate messy user asks into a concise plan for downstream agents. Operate with the following guardrails:
+
+1. First restate the user request in your own words and call \\"index_workspace_files\\" only if you need high-level project context. Never dump more than ~50 paths; prefer filtering by folder or extension.
+2. Only call \\"read_workspace_file\\" for files that directly influence the request, and prefer partial reads (line ranges or snippets) over entire files.
+3. If you need to synthesize a polished plan from intermediate notes, call \\"dynamic_prompt\\" with the raw observations and let the tool format the final JSON.
+4. Summarize insights and produce structured output JSON:
+   {
+     "summary": "one paragraph",
+     "action_items": ["imperative step"],
+     "open_questions": ["clarification you need"]
+   }
+5. Keep the final plan under 800 words and avoid copying large code blocks—describe them instead.
+
+Return only that JSON string; do not attempt to fix code yourself.`;
+export const customerFacingTriageAgent = new Agent({
+    name: "Customer-facing triage agent",
+    instructions: customerAgentInstruction,
+    tools: [dynamicPromptTool, indexWorkspaceFilesTool, readWorkspaceFileTool],
+    model: OPENAI_MODEL_NAME,
+});
+//# sourceMappingURL=customer-triage-agent.js.map

package/dist/agents/customer-triage-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customer-triage-agent.js","sourceRoot":"","sources":["../../src/agents/customer-triage-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,wBAAwB,GAAG;;;;;;;;;;;;;mEAakC,CAAC;AAEpE,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,KAAK,CAAC;IACjD,IAAI,EAAE,8BAA8B;IACpC,YAAY,EAAE,wBAAwB;IACtC,KAAK,EAAE,CAAC,iBAAiB,EAAE,uBAAuB,EAAE,qBAAqB,CAAC;IAC1E,KAAK,EAAE,iBAAiB;CACzB,CAAC,CAAC"}

package/dist/agents/manager-agent.d.ts

@@ -0,0 +1,4 @@
+import "dotenv/config";
+import { Agent } from "@openai/agents";
+export declare const managerAgent: Agent<unknown, "text">;
+//# sourceMappingURL=manager-agent.d.ts.map

package/dist/agents/manager-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager-agent.d.ts","sourceRoot":"","sources":["../../src/agents/manager-agent.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAyBvC,eAAO,MAAM,YAAY,wBAcvB,CAAC"}

package/dist/agents/manager-agent.js

@@ -0,0 +1,38 @@
+import "dotenv/config";
+import { Agent } from "@openai/agents";
+import { readWorkspaceFileTool } from "../tools/read-workspace.js";
+import { writeWorkspaceFileTool } from "../tools/write-workspace.js";
+import { indexWorkspaceFilesTool } from "../tools/index-workspace.js";
+import { dynamicPromptTool } from "../tools/dynamic-prompt.js";
+import { OPENAI_MODEL_NAME } from "../config.js";
+const managerAgentInstruction = `You orchestrate implementation. Consume the triage plan, decide what has to change, and coordinate tool usage safely:
+
+1. Parse the triage JSON and turn each action item into a concrete change list (files, rationale, acceptance criteria).
+2. Before editing, inspect current state by calling \\"index_workspace_files\\" (with filters) and \\"read_workspace_file\\" for only the relevant snippets.
+3. When code changes are needed, call the \\"code_assistant\\" tool with precise instructions (file path, target block, expected behavior). Review its response before applying anything.
+4. Write modifications via \\"write_workspace_file\\" using minimal edits, then immediately re-read the affected section to verify the change.
+5. Keep a running summary of what was updated so the reviewer can audit later. Never leave TODOs unresolved or partially applied.
+6. If requirements are unclear or risky, return a clarification request instead of guessing.
+
+Final output must recap the steps taken, files touched, and remaining follow-ups.`;
+const codingAgent = new Agent({
+    name: "Code assistant",
+    instructions: "Generate code with best practices which must adhere requirements",
+    model: OPENAI_MODEL_NAME,
+});
+export const managerAgent = new Agent({
+    name: "Manager agent",
+    instructions: managerAgentInstruction,
+    tools: [
+        dynamicPromptTool,
+        readWorkspaceFileTool,
+        writeWorkspaceFileTool,
+        indexWorkspaceFilesTool,
+        codingAgent.asTool({
+            toolName: "code_assistant",
+            toolDescription: "Handles coding implementations",
+        }),
+    ],
+    model: OPENAI_MODEL_NAME,
+});
+//# sourceMappingURL=manager-agent.js.map

package/dist/agents/manager-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager-agent.js","sourceRoot":"","sources":["../../src/agents/manager-agent.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,uBAAuB,GAAG;;;;;;;;;kFASkD,CAAC;AAEnF,MAAM,WAAW,GAAG,IAAI,KAAK,CAAC;IAC5B,IAAI,EAAE,gBAAgB;IACtB,YAAY,EACV,kEAAkE;IACpE,KAAK,EAAE,iBAAiB;CACzB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,KAAK,CAAC;IACpC,IAAI,EAAE,eAAe;IACrB,YAAY,EAAE,uBAAuB;IACrC,KAAK,EAAE;QACL,iBAAiB;QACjB,qBAAqB;QACrB,sBAAsB;QACtB,uBAAuB;QACvB,WAAW,CAAC,MAAM,CAAC;YACjB,QAAQ,EAAE,gBAAgB;YAC1B,eAAe,EAAE,gCAAgC;SAClD,CAAC;KACH;IACD,KAAK,EAAE,iBAAiB;CACzB,CAAC,CAAC"}

package/dist/agents/reviewer-agent.d.ts

@@ -0,0 +1,4 @@
+import "dotenv/config";
+import { Agent } from "@openai/agents";
+export declare const reviewerAgent: Agent<unknown, "text">;
+//# sourceMappingURL=reviewer-agent.d.ts.map

package/dist/agents/reviewer-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewer-agent.d.ts","sourceRoot":"","sources":["../../src/agents/reviewer-agent.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAcvC,eAAO,MAAM,aAAa,wBAKxB,CAAC"}

package/dist/agents/reviewer-agent.js

@@ -0,0 +1,20 @@
+import "dotenv/config";
+import { Agent } from "@openai/agents";
+import { readWorkspaceFileTool } from "../tools/read-workspace.js";
+import { writeWorkspaceFileTool } from "../tools/write-workspace.js";
+import { indexWorkspaceFilesTool } from "../tools/index-workspace.js";
+import { dynamicPromptTool } from "../tools/dynamic-prompt.js";
+import { OPENAI_MODEL_NAME } from "../config.js";
+const reviewerAgentInstruction = `You are the QA reviewer. Audit the latest changes against the original user input. Operate in a read-only manner:
+
+1. Use the triage plan plus manager summary to understand scope. Only call \\"read_workspace_file\\" for files cited in that scope.
+2. For each file, check functional correctness, adherence to instructions, and risk (missing tests, regressions, formatting issues).
+3. Respond with JSON: {"verdict":"Yes|No","findings":["issue or confirmation"],"follow_up":["next action"]}. Verdict "Yes" means requirements satisfied with no blockers.
+4. Never modify files. If information is insufficient, ask for clarifications instead of guessing.`;
+export const reviewerAgent = new Agent({
+    name: "Reviewer agent",
+    instructions: reviewerAgentInstruction,
+    tools: [dynamicPromptTool, readWorkspaceFileTool, indexWorkspaceFilesTool],
+    model: OPENAI_MODEL_NAME,
+});
+//# sourceMappingURL=reviewer-agent.js.map

package/dist/agents/reviewer-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewer-agent.js","sourceRoot":"","sources":["../../src/agents/reviewer-agent.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,wBAAwB,GAAG;;;;;mGAKkE,CAAC;AAEpG,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,KAAK,CAAC;IACrC,IAAI,EAAE,gBAAgB;IACtB,YAAY,EAAE,wBAAwB;IACtC,KAAK,EAAE,CAAC,iBAAiB,EAAE,qBAAqB,EAAE,uBAAuB,CAAC;IAC1E,KAAK,EAAE,iBAAiB;CACzB,CAAC,CAAC"}

package/dist/agents/supervisor-agent.d.ts

@@ -0,0 +1,3 @@
+import { Agent } from "@openai/agents";
+export declare const supervisorAgent: Agent<unknown, "text">;
+//# sourceMappingURL=supervisor-agent.d.ts.map

package/dist/agents/supervisor-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-agent.d.ts","sourceRoot":"","sources":["../../src/agents/supervisor-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAuCvC,eAAO,MAAM,eAAe,wBAa1B,CAAC"}

package/dist/agents/supervisor-agent.js

@@ -0,0 +1,46 @@
+import { Agent } from "@openai/agents";
+import { customerFacingTriageAgent } from "./customer-triage-agent.js";
+import { managerAgent } from "./manager-agent.js";
+import { reviewerAgent } from "./reviewer-agent.js";
+import { readWorkspaceFileTool } from "../tools/read-workspace.js";
+import { writeWorkspaceFileTool } from "../tools/write-workspace.js";
+import { indexWorkspaceFilesTool } from "../tools/index-workspace.js";
+import { dynamicPromptTool } from "../tools/dynamic-prompt.js";
+import { OPENAI_MODEL_NAME } from "../config.js";
+const triageTool = customerFacingTriageAgent.asTool({
+    toolName: "triage_specialist",
+    toolDescription: "Pre-processes user intent, reviews context selectively, and outputs structured JSON with summary/action items/open questions.",
+});
+const managerTool = managerAgent.asTool({
+    toolName: "implementation_manager",
+    toolDescription: "Turns triage output into concrete code changes by coordinating workspace tools and the coding assistant.",
+});
+const reviewerTool = reviewerAgent.asTool({
+    toolName: "qa_reviewer",
+    toolDescription: "Audits the implemented changes against the requirements and returns a verdict JSON with findings.",
+});
+const supervisorInstructions = `You are the supervisor responsible for delivering complete user solutions.
+
+Workflow:
+1. Call triage_specialist with the raw user request to obtain the structured plan JSON.
+2. Feed that plan to implementation_manager so it performs the necessary workspace edits (it will call coding and file tools).
+3. Once implementation is done, call qa_reviewer with the original request plus the manager summary to confirm compliance.
+4. If qa_reviewer returns "No", summarize the findings and either re-run implementation_manager or escalate.
+5. Keep responses concise (under 400 words) and include a final section detailing files touched and outstanding questions.
+
+You may directly use workspace tools for quick spot checks, but prefer the specialized agents whenever possible.`;
+export const supervisorAgent = new Agent({
+    name: "Supervisor agent",
+    instructions: supervisorInstructions,
+    tools: [
+        triageTool,
+        managerTool,
+        reviewerTool,
+        dynamicPromptTool,
+        readWorkspaceFileTool,
+        writeWorkspaceFileTool,
+        indexWorkspaceFilesTool,
+    ],
+    model: OPENAI_MODEL_NAME,
+});
+//# sourceMappingURL=supervisor-agent.js.map

package/dist/agents/supervisor-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-agent.js","sourceRoot":"","sources":["../../src/agents/supervisor-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,UAAU,GAAG,yBAAyB,CAAC,MAAM,CAAC;IAClD,QAAQ,EAAE,mBAAmB;IAC7B,eAAe,EACb,+HAA+H;CAClI,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC;IACtC,QAAQ,EAAE,wBAAwB;IAClC,eAAe,EACb,0GAA0G;CAC7G,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,aAAa,CAAC,MAAM,CAAC;IACxC,QAAQ,EAAE,aAAa;IACvB,eAAe,EACb,mGAAmG;CACtG,CAAC,CAAC;AAEH,MAAM,sBAAsB,GAAG;;;;;;;;;iHASkF,CAAC;AAElH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,KAAK,CAAC;IACvC,IAAI,EAAE,kBAAkB;IACxB,YAAY,EAAE,sBAAsB;IACpC,KAAK,EAAE;QACL,UAAU;QACV,WAAW;QACX,YAAY;QACZ,iBAAiB;QACjB,qBAAqB;QACrB,sBAAsB;QACtB,uBAAuB;KACxB;IACD,KAAK,EAAE,iBAAiB;CACzB,CAAC,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,4 @@
+import "dotenv/config";
+export declare const OPENAI_MODEL_NAME: string;
+export declare const WORKSPACE_ROOT: string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AAGvB,eAAO,MAAM,iBAAiB,QACoB,CAAC;AAEnD,eAAO,MAAM,cAAc,QAEV,CAAC"}

package/dist/config.js

@@ -0,0 +1,7 @@
+import "dotenv/config";
+import path from "node:path";
+export const OPENAI_MODEL_NAME = process.env.OPENAI_MODEL_NAME || "gpt-3.5-turbo";
+export const WORKSPACE_ROOT = process.env.AGENT_WORKSPACE_ROOT
+    ? path.resolve(process.env.AGENT_WORKSPACE_ROOT)
+    : process.cwd();
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AACvB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,MAAM,iBAAiB,GAC5B,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,eAAe,CAAC;AAEnD,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB;IAC5D,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IAChD,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC"}

package/dist/generate-output.d.ts

@@ -0,0 +1,7 @@
+import "dotenv/config";
+export declare const generateOutput: ({ input, conversationId, signal, }: {
+    input: string;
+    conversationId: string;
+    signal?: AbortController["signal"];
+}) => Promise<string>;
+//# sourceMappingURL=generate-output.d.ts.map

package/dist/generate-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-output.d.ts","sourceRoot":"","sources":["../src/generate-output.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AAMvB,eAAO,MAAM,cAAc,GAAU,oCAIlC;IACD,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;CACpC,KAAG,OAAO,CAAC,MAAM,CAWjB,CAAC"}

package/dist/generate-output.js

@@ -0,0 +1,15 @@
+import "dotenv/config";
+import { run } from "@openai/agents";
+import { supervisorAgent } from "./agents/supervisor-agent.js";
+import { marked } from "marked";
+import { logOutputIteratively } from "./utils/cmd-operations.js";
+export const generateOutput = async ({ input, conversationId, signal, }) => {
+    const logIntervalId = logOutputIteratively("thinking");
+    const result = await run(supervisorAgent, input, {
+        conversationId,
+        ...(signal ? { signal } : undefined),
+    });
+    clearInterval(logIntervalId);
+    return result.finalOutput;
+};
+//# sourceMappingURL=generate-output.js.map

package/dist/generate-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-output.js","sourceRoot":"","sources":["../src/generate-output.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,EACnC,KAAK,EACL,cAAc,EACd,MAAM,GAKP,EAAmB,EAAE;IACpB,MAAM,aAAa,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAEvD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,eAAe,EAAE,KAAK,EAAE;QAC/C,cAAc;QACd,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;KACrC,CAAC,CAAC;IAEH,aAAa,CAAC,aAAa,CAAC,CAAC;IAE7B,OAAO,MAAM,CAAC,WAAqB,CAAC;AACtC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import "dotenv/config";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+import "dotenv/config";
+import OpenAI from "openai";
+import { marked } from "marked";
+import { markedTerminal } from "marked-terminal";
+import { generateOutput } from "./generate-output.js";
+marked.use(markedTerminal({}));
+const client = new OpenAI();
+const { id: conversationId } = await client.conversations.create({});
+// conversation history
+const abortController = new AbortController();
+let isProcessingRequest = false;
+console.log("Hello! How I can assist you today? Is there something specific you need help with?");
+console.log(marked("__Input prompt:__"));
+process.stdin.on("data", (chunk) => {
+    const input = chunk.toString();
+    if (isProcessingRequest) {
+        console.log(marked("interrupted"));
+        abortController.abort();
+    }
+    if (input.trim()) {
+        console.log(marked("**received:** " + chunk.toString()));
+        generateOutput({
+            input,
+            conversationId,
+            signal: abortController.signal,
+        })
+            .then((result) => {
+            console.log(`\r${marked(result)}`);
+        })
+            .finally(() => {
+            isProcessingRequest = false;
+        });
+    }
+    else {
+        console.log(marked("__Input prompt:__"));
+    }
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,eAAe,CAAC;AACvB,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAQ,CAAC,CAAC;AAEtC,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;AAC5B,MAAM,EAAE,EAAE,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAErE,uBAAuB;AAEvB,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;AAC9C,IAAI,mBAAmB,GAAG,KAAK,CAAC;AAEhC,OAAO,CAAC,GAAG,CACT,oFAAoF,CACrF,CAAC;AACF,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC;AAEzC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;IACjC,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IAE/B,IAAI,mBAAmB,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC;QACnC,eAAe,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAEzD,cAAc,CAAC;YACb,KAAK;YACL,cAAc;YACd,MAAM,EAAE,eAAe,CAAC,MAAM;SAC/B,CAAC;aACC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACrC,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,mBAAmB,GAAG,KAAK,CAAC;QAC9B,CAAC,CAAC,CAAC;IACP,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/tools/dynamic-prompt.d.ts

@@ -0,0 +1,20 @@
+export declare const dynamicPromptTool: import("@openai/agents").FunctionTool<unknown, {
+    type: "object";
+    properties: {
+        objective: {
+            type: string;
+            description: string;
+        };
+        workspaceSummary: {
+            type: string;
+            description: string;
+        };
+        constraints: {
+            type: string;
+            description: string;
+        };
+    };
+    required: string[];
+    additionalProperties: false;
+}, string>;
+//# sourceMappingURL=dynamic-prompt.d.ts.map

package/dist/tools/dynamic-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-prompt.d.ts","sourceRoot":"","sources":["../../src/tools/dynamic-prompt.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;UAgD5B,CAAC"}

package/dist/tools/dynamic-prompt.js

@@ -0,0 +1,48 @@
+import { tool } from "@openai/agents";
+import z from "zod";
+export const dynamicPromptTool = tool({
+    name: "dynamic_prompt_generation",
+    description: "Generates efficient prompt for AI other tools for specific tasks",
+    parameters: {
+        type: "object",
+        properties: {
+            objective: {
+                type: "string",
+                description: "Short sentence describing the current goal",
+            },
+            workspaceSummary: {
+                type: "string",
+                description: "Relevant context pulled from files or tests",
+            },
+            constraints: {
+                type: "string",
+                description: "Hard requirements (APIs, formatting, testing, etc.)",
+            },
+        },
+        required: ["objective", "workspaceSummary", "constraints"],
+        additionalProperties: false,
+    },
+    strict: true,
+    needsApproval: async (_ctx) => false,
+    async execute({ objective, workspaceSummary, constraints }) {
+        const constraintList = constraints.length > 0
+            ? constraints
+                .map((c, idx) => `${idx + 1}. ${c}`)
+                .join("\n")
+            : "None provided";
+        const prompt = [
+            "You are an expert coding copilot embedded in an orchestrated toolchain.",
+            `Primary objective: ${objective}`,
+            workspaceSummary ? `Context:\n${workspaceSummary}` : null,
+            `Constraints:\n${constraintList}`,
+            "Output expectations:",
+            "- Provide concise reasoning before sharing code.",
+            "- Prefer TypeScript, include imports, and ensure lint/tests pass.",
+            "- Flag uncertainties or missing data explicitly.",
+        ]
+            .filter(Boolean)
+            .join("\n\n");
+        return { prompt };
+    },
+});
+//# sourceMappingURL=dynamic-prompt.js.map

package/dist/tools/dynamic-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-prompt.js","sourceRoot":"","sources":["../../src/tools/dynamic-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC;IACpC,IAAI,EAAE,2BAA2B;IACjC,WAAW,EACT,kEAAkE;IACpE,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4CAA4C;aAC1D;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6CAA6C;aAC3D;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qDAAqD;aACnE;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,EAAE,kBAAkB,EAAE,aAAa,CAAC;QAC1D,oBAAoB,EAAE,KAAK;KAC5B;IACD,MAAM,EAAE,IAAI;IACZ,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK;IACpC,KAAK,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAO;QAC7D,MAAM,cAAc,GAClB,WAAW,CAAC,MAAM,GAAG,CAAC;YACpB,CAAC,CAAC,WAAW;iBACR,GAAG,CAAC,CAAC,CAAS,EAAE,GAAW,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;iBACnD,IAAI,CAAC,IAAI,CAAC;YACf,CAAC,CAAC,eAAe,CAAC;QAEtB,MAAM,MAAM,GAAG;YACb,yEAAyE;YACzE,sBAAsB,SAAS,EAAE;YACjC,gBAAgB,CAAC,CAAC,CAAC,aAAa,gBAAgB,EAAE,CAAC,CAAC,CAAC,IAAI;YACzD,iBAAiB,cAAc,EAAE;YACjC,sBAAsB;YACtB,kDAAkD;YAClD,mEAAmE;YACnE,kDAAkD;SACnD;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhB,OAAO,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/index-workspace.d.ts

@@ -0,0 +1,3 @@
+import z from "zod";
+export declare const indexWorkspaceFilesTool: import("@openai/agents").FunctionTool<unknown, z.ZodObject<{}, z.z.core.$strip>, string>;
+//# sourceMappingURL=index-workspace.d.ts.map

package/dist/tools/index-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-workspace.d.ts","sourceRoot":"","sources":["../../src/tools/index-workspace.ts"],"names":[],"mappings":"AAGA,OAAO,CAAC,MAAM,KAAK,CAAC;AAKpB,eAAO,MAAM,uBAAuB,0FAkBlC,CAAC"}

package/dist/tools/index-workspace.js

@@ -0,0 +1,42 @@
+import path from "node:path";
+import fs from "node:fs/promises";
+import { tool } from "@openai/agents";
+import z from "zod";
+import { WORKSPACE_ROOT } from "../config.js";
+const workspaceRoot = WORKSPACE_ROOT;
+export const indexWorkspaceFilesTool = tool({
+    name: "index_workspace_files",
+    description: "Index all existing files under the workspace root and return relative paths.",
+    parameters: z.object({}),
+    //   {
+    //     type: "object",
+    //     properties: {},
+    //     additionalProperties: false,
+    //     required: [],
+    //   },
+    strict: true,
+    needsApproval: async (_ctx) => false,
+    async execute() {
+        const files = [];
+        await traverse(workspaceRoot, files);
+        return JSON.stringify({ files });
+    },
+});
+const defaultExclusions = ["node_modules"];
+async function traverse(dir, files, exclusions = []) {
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    const allExclusions = [...exclusions, ...defaultExclusions];
+    for (const entry of entries) {
+        if (allExclusions.some((exclusion) => exclusion.includes(entry.name))) {
+            continue;
+        }
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            await traverse(fullPath, files, exclusions);
+        }
+        else {
+            files.push(path.relative(workspaceRoot, fullPath));
+        }
+    }
+}
+//# sourceMappingURL=index-workspace.js.map

package/dist/tools/index-workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-workspace.js","sourceRoot":"","sources":["../../src/tools/index-workspace.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,CAAC,MAAM,KAAK,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,aAAa,GAAG,cAAc,CAAC;AAErC,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;IAC1C,IAAI,EAAE,uBAAuB;IAC7B,WAAW,EACT,8EAA8E;IAChF,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACxB,MAAM;IACN,sBAAsB;IACtB,sBAAsB;IACtB,mCAAmC;IACnC,oBAAoB;IACpB,OAAO;IACP,MAAM,EAAE,IAAI;IACZ,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK;IACpC,KAAK,CAAC,OAAO;QACX,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACnC,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAG,CAAC,cAAc,CAAC,CAAC;AAE3C,KAAK,UAAU,QAAQ,CACrB,GAAW,EACX,KAAe,EACf,aAAuB,EAAE;IAEzB,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/D,MAAM,aAAa,GAAG,CAAC,GAAG,UAAU,EAAE,GAAG,iBAAiB,CAAC,CAAC;IAE5D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACtE,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAE5C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/tools/read-workspace.d.ts

@@ -0,0 +1,12 @@
+export declare const readWorkspaceFileTool: import("@openai/agents").FunctionTool<unknown, {
+    type: "object";
+    properties: {
+        relativePath: {
+            type: string;
+            description: string;
+        };
+    };
+    required: string[];
+    additionalProperties: false;
+}, string>;
+//# sourceMappingURL=read-workspace.d.ts.map

package/dist/tools/read-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-workspace.d.ts","sourceRoot":"","sources":["../../src/tools/read-workspace.ts"],"names":[],"mappings":"AAgDA,eAAO,MAAM,qBAAqB;;;;;;;;;;UAsBhC,CAAC"}

package/dist/tools/read-workspace.js

@@ -0,0 +1,62 @@
+// import path from "node:path";
+// import fs from "node:fs/promises";
+// const workspaceRoot = new URL("../", import.meta.url).pathname;
+// export const readWorkspaceFileTool = {
+//   type: "function",
+//   name: "read_workspace_file",
+//   description: "Return UTF-8 contents of a project file for inspection.",
+//   parameters: {
+//     type: "object",
+//     properties: {
+//       relativePath: {
+//         type: "string",
+//         description: "Path relative to the workspace root, e.g. src/index.ts",
+//       },
+//     },
+//     required: ["relativePath"],
+//   },
+//   execute: async ({ relativePath }: { relativePath: string }) => {
+//     const candidate = path.join(workspaceRoot, relativePath);
+//     if (!candidate.startsWith(workspaceRoot)) {
+//       throw new Error("Path outside workspace.");
+//     }
+//     const text = await fs.readFile(candidate, "utf8");
+//     return { content: text };
+//   },
+// };
+import path from "node:path";
+import fs from "node:fs/promises";
+import { tool } from "@openai/agents";
+import { WORKSPACE_ROOT } from "../config.js";
+const workspaceRoot = WORKSPACE_ROOT;
+const resolveWorkspacePath = (relativePath) => {
+    const candidate = path.resolve(workspaceRoot, relativePath);
+    if (!candidate.startsWith(workspaceRoot)) {
+        throw new Error("Path outside workspace.");
+    }
+    return candidate;
+};
+export const readWorkspaceFileTool = tool({
+    name: "read_workspace_file",
+    description: "Return UTF-8 contents of a project file for inspection.",
+    parameters: {
+        type: "object",
+        properties: {
+            relativePath: {
+                type: "string",
+                description: "Path relative to the workspace root, e.g. src/index.ts",
+            },
+        },
+        required: ["relativePath"],
+        additionalProperties: false,
+    },
+    strict: true,
+    needsApproval: async () => false,
+    async execute(input) {
+        const { relativePath } = input;
+        const filePath = resolveWorkspacePath(relativePath);
+        const text = await fs.readFile(filePath, "utf8");
+        return { content: text };
+    },
+});
+//# sourceMappingURL=read-workspace.js.map

package/dist/tools/read-workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-workspace.js","sourceRoot":"","sources":["../../src/tools/read-workspace.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,qCAAqC;AAErC,kEAAkE;AAElE,yCAAyC;AACzC,sBAAsB;AACtB,iCAAiC;AACjC,4EAA4E;AAC5E,kBAAkB;AAClB,sBAAsB;AACtB,oBAAoB;AACpB,wBAAwB;AACxB,0BAA0B;AAC1B,iFAAiF;AACjF,WAAW;AACX,SAAS;AACT,kCAAkC;AAClC,OAAO;AACP,qEAAqE;AACrE,gEAAgE;AAChE,kDAAkD;AAClD,oDAAoD;AACpD,QAAQ;AACR,yDAAyD;AACzD,gCAAgC;AAChC,OAAO;AACP,KAAK;AAEL,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,aAAa,GAAG,cAAc,CAAC;AAErC,MAAM,oBAAoB,GAAG,CAAC,YAAoB,EAAE,EAAE;IACpD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IAC5D,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAMF,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;IACxC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE,yDAAyD;IACtE,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wDAAwD;aACtE;SACF;QACD,QAAQ,EAAE,CAAC,cAAc,CAAC;QAC1B,oBAAoB,EAAE,KAAK;KAC5B;IACD,MAAM,EAAE,IAAI;IACZ,aAAa,EAAE,KAAK,IAAI,EAAE,CAAC,KAAK;IAChC,KAAK,CAAC,OAAO,CAAC,KAAc;QAC1B,MAAM,EAAE,YAAY,EAAE,GAAG,KAA+B,CAAC;QACzD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;QACpD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACjD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;CACF,CAAC,CAAC"}

package/dist/tools/write-workspace.d.ts

@@ -0,0 +1,16 @@
+export declare const writeWorkspaceFileTool: import("@openai/agents").FunctionTool<unknown, {
+    type: "object";
+    properties: {
+        relativePath: {
+            type: string;
+            description: string;
+        };
+        content: {
+            type: string;
+            description: string;
+        };
+    };
+    required: string[];
+    additionalProperties: false;
+}, string>;
+//# sourceMappingURL=write-workspace.d.ts.map

package/dist/tools/write-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-workspace.d.ts","sourceRoot":"","sources":["../../src/tools/write-workspace.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;UAwDjC,CAAC"}

package/dist/tools/write-workspace.js

@@ -0,0 +1,70 @@
+import path from "node:path";
+import fs from "node:fs/promises";
+import { tool } from "@openai/agents";
+import { WORKSPACE_ROOT } from "../config.js";
+const workspaceRoot = WORKSPACE_ROOT;
+const resolveWorkspacePath = (relativePath) => {
+    const candidate = path.resolve(workspaceRoot, relativePath);
+    if (!candidate.startsWith(workspaceRoot)) {
+        throw new Error("Path outside workspace.");
+    }
+    return candidate;
+};
+export const writeWorkspaceFileTool = tool({
+    name: "write_workspace_file",
+    description: "Write UTF-8 content project file.",
+    parameters: {
+        type: "object",
+        properties: {
+            relativePath: {
+                type: "string",
+                description: "Path relative to the workspace root, e.g. src/index.ts",
+            },
+            content: {
+                type: "string",
+                description: `Content of project file to write/store. It will create file if file doesn't exist
+          
+          e.g.: 
+          import fs from "fs";
+          import path from "path";
+          
+          export function indexFiles(directory: string, fileExtensions: string[] = []) {
+            const files: string[] = [];
+          
+            function traverse(dir: string) {
+              const entries = fs.readdirSync(dir, { withFileTypes: true });
+          
+              for (const entry of entries) {
+                const fullPath = path.join(dir, entry.name);
+          
+                if (entry.isDirectory()) {
+                  traverse(fullPath);
+                } else if (
+                  fileExtensions.length === 0 || // If no extensions are specified, include all files
+                  fileExtensions.includes(path.extname(entry.name))
+                ) {
+                  files.push(fullPath);
+                }
+              }
+            }
+          
+            traverse(directory);
+            return files;
+          }
+          
+          `,
+            },
+        },
+        required: ["relativePath", "content"],
+        additionalProperties: false,
+    },
+    strict: true,
+    needsApproval: async () => false,
+    async execute(input) {
+        const { relativePath, content } = input;
+        const candidate = resolveWorkspacePath(relativePath);
+        await fs.writeFile(candidate, content, "utf8");
+        return { content: "OK", isSaved: true };
+    },
+});
+//# sourceMappingURL=write-workspace.js.map

package/dist/tools/write-workspace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-workspace.js","sourceRoot":"","sources":["../../src/tools/write-workspace.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,aAAa,GAAG,cAAc,CAAC;AAErC,MAAM,oBAAoB,GAAG,CAAC,YAAoB,EAAE,EAAE;IACpD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IAC5D,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAOF,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;IACzC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,mCAAmC;IAChD,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,YAAY,EAAE;gBACZ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,wDAAwD;aACtE;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WA8BV;aACJ;SACF;QACD,QAAQ,EAAE,CAAC,cAAc,EAAE,SAAS,CAAC;QACrC,oBAAoB,EAAE,KAAK;KAC5B;IACD,MAAM,EAAE,IAAI;IACZ,aAAa,EAAE,KAAK,IAAI,EAAE,CAAC,KAAK;IAChC,KAAK,CAAC,OAAO,CAAC,KAAc;QAC1B,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,KAAqC,CAAC;QACxE,MAAM,SAAS,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;QACrD,MAAM,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC/C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC1C,CAAC;CACF,CAAC,CAAC"}

package/dist/utils/cmd-operations.d.ts

@@ -0,0 +1,8 @@
+export declare const logOutputIteratively: (input: string) => NodeJS.Timeout;
+type Option = {
+    value: string;
+    name: string;
+};
+export declare function selectOption(options: Option[]): Promise<any>;
+export {};
+//# sourceMappingURL=cmd-operations.d.ts.map

package/dist/utils/cmd-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmd-operations.d.ts","sourceRoot":"","sources":["../../src/utils/cmd-operations.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,oBAAoB,GAAI,OAAO,MAAM,mBAcjD,CAAC;AAEF,KAAK,MAAM,GAAG;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AACF,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,gBAWnD"}

package/dist/utils/cmd-operations.js

@@ -0,0 +1,26 @@
+import inquirer from "inquirer";
+export const logOutputIteratively = (input) => {
+    let index = 1;
+    const intervalTimeout = setInterval(() => {
+        process.stdout.write("\r");
+        process.stdout.write(" ".repeat(40));
+        process.stdout.write(`\r${input}${".".repeat(index)}`);
+        index++;
+        if (index > 3) {
+            index = 1;
+        }
+    }, 500);
+    return intervalTimeout;
+};
+export async function selectOption(options) {
+    const { choice } = await inquirer.prompt([
+        {
+            type: "list",
+            name: "choice",
+            message: "Pick an action:",
+            choices: options,
+        },
+    ]);
+    return choice;
+}
+//# sourceMappingURL=cmd-operations.js.map

package/dist/utils/cmd-operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmd-operations.js","sourceRoot":"","sources":["../../src/utils/cmd-operations.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAEhC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAa,EAAE,EAAE;IACpD,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE;QACvC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACvD,KAAK,EAAE,CAAC;QACR,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACd,KAAK,GAAG,CAAC,CAAC;QACZ,CAAC;IACH,CAAC,EAAE,GAAG,CAAC,CAAC;IAER,OAAO,eAAe,CAAC;AACzB,CAAC,CAAC;AAMF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAiB;IAClD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;QACvC;YACE,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,iBAAiB;YAC1B,OAAO,EAAE,OAAO;SACjB;KACF,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/files.d.ts

@@ -0,0 +1,10 @@
+export declare function traverse({ dir, files, workspaceRoot, }: {
+    dir: string;
+    files: string[];
+    workspaceRoot: string;
+}): Promise<void>;
+export declare function indexFiles(directory: string, fileExtensions?: string[]): Promise<string[]>;
+export declare function buildSearchableIndex(directory: string, fileExtensions?: string[]): Record<string, string>;
+export declare function readFileContent(filePath: string): string | null;
+export declare function getFileContentWithCache(fileCache: Record<string, string>, filePath: string): string | null;
+//# sourceMappingURL=files.d.ts.map

package/dist/utils/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/utils/files.ts"],"names":[],"mappings":"AAIA,wBAAsB,QAAQ,CAAC,EAC7B,GAAG,EACH,KAAK,EACL,aAAa,GACd,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB,iBAUA;AAED,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,cAAc,GAAE,MAAM,EAAO,qBAuB9B;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,cAAc,GAAE,MAAM,EAAO,0BA0B9B;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,iBAQ/C;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,QAAQ,EAAE,MAAM,iBAWjB"}

package/dist/utils/files.js

@@ -0,0 +1,75 @@
+import fs from "fs";
+import fsPromise from "fs/promises";
+import path from "path";
+export async function traverse({ dir, files, workspaceRoot, }) {
+    const entries = await fsPromise.readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            await traverse({ dir: fullPath, files, workspaceRoot });
+        }
+        else {
+            files.push(path.relative(workspaceRoot, fullPath));
+        }
+    }
+}
+export async function indexFiles(directory, fileExtensions = []) {
+    const files = [];
+    async function traverse(dir) {
+        const entries = await fsPromise.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                traverse(fullPath);
+            }
+            else if (fileExtensions.length === 0 || // If no extensions are specified, include all files
+                fileExtensions.includes(path.extname(entry.name))) {
+                files.push(fullPath);
+            }
+        }
+    }
+    await traverse(directory);
+    return files;
+}
+export function buildSearchableIndex(directory, fileExtensions = []) {
+    const index = {};
+    function traverse(dir) {
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                traverse(fullPath);
+            }
+            else if (fileExtensions.length === 0 || // If no extensions are specified, include all files
+                fileExtensions.includes(path.extname(entry.name))) {
+                const content = readFileContent(fullPath);
+                if (content) {
+                    index[fullPath] = content;
+                }
+            }
+        }
+    }
+    traverse(directory);
+    return index;
+}
+export function readFileContent(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, "utf-8");
+        return content;
+    }
+    catch (error) {
+        console.error(`Error reading file ${filePath}:`, error.message);
+        return null;
+    }
+}
+export function getFileContentWithCache(fileCache, filePath) {
+    if (fileCache[filePath]) {
+        return fileCache[filePath];
+    }
+    const content = readFileContent(filePath);
+    if (content) {
+        fileCache[filePath] = content;
+    }
+    return content;
+}
+//# sourceMappingURL=files.js.map

package/dist/utils/files.js.map

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

package/dist/utils/generate-documentation.d.ts

@@ -0,0 +1,2 @@
+export declare function generateDocumentation(filePath: string): Promise<string | undefined>;
+//# sourceMappingURL=generate-documentation.d.ts.map

package/dist/utils/generate-documentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-documentation.d.ts","sourceRoot":"","sources":["../../src/utils/generate-documentation.ts"],"names":[],"mappings":"AAMA,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,+BAc3D"}

package/dist/utils/generate-documentation.js

@@ -0,0 +1,17 @@
+import OpenAI from "openai";
+import { readFileContent } from "./files.js";
+const MODEL = "gpt-3.5-turbo";
+const openai = new OpenAI();
+export async function generateDocumentation(filePath) {
+    const fileContent = readFileContent(filePath);
+    if (!fileContent) {
+        return "Error: Unable to read file content.";
+    }
+    const response = await openai.completions.create({
+        model: MODEL,
+        prompt: `Generate documentation for the following code:\n\n${fileContent}`,
+        max_tokens: 300,
+    });
+    return response.choices[0]?.text;
+}
+//# sourceMappingURL=generate-documentation.js.map

package/dist/utils/generate-documentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-documentation.js","sourceRoot":"","sources":["../../src/utils/generate-documentation.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,KAAK,GAAG,eAAe,CAAC;AAC9B,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;AAE5B,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,QAAgB;IAC1D,MAAM,WAAW,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAE9C,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,qCAAqC,CAAC;IAC/C,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC;QAC/C,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,qDAAqD,WAAW,EAAE;QAC1E,UAAU,EAAE,GAAG;KAChB,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;AACnC,CAAC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "openai-code-assistant",
+  "version": "1.0.1",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "build": "tsc"
+  },
+  "bin": {
+    "openai-code-assistant": "dist/index.js"
+  },
+  "author": "",
+  "license": "ISC",
+  "description": "",
+  "type": "module",
+  "devDependencies": {
+    "@types/node": "^25.3.3",
+    "ts-node": "^10.9.2",
+    "ts-node-dev": "^2.0.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@openai/agents": "^0.5.3",
+    "@types/inquirer": "^9.0.9",
+    "@types/marked-terminal": "^6.1.1",
+    "dotenv": "^17.3.1",
+    "inquirer": "^13.3.0",
+    "marked": "^15.0.12",
+    "marked-terminal": "^7.3.0",
+    "openai": "^6.25.0",
+    "zod": "^4.3.6"
+  }
+}