@harperfast/agent 0.13.1 → 0.13.3

package/README.md

@@ -56,6 +56,18 @@ Harper: What do you want to do together today?
 >
 ```
 
+### Non-interactive: pipe an initial prompt
+
+You can pass an initial chat dump via stdin. This runs a one-shot interaction and exits after responding:
+
+```bash
+cat somePrompt.md | harper-agent
+# or
+harper-agent < somePrompt.md
+```
+
+In this mode, the initial greeting question is suppressed, and the agent processes the provided prompt immediately.
+
 ## Model Selection
 
 By default, `harper-agent` uses OpenAI. You can switch to other models using the `--model` (or `-m`) flag:

package/dist/agent.js

@@ -92,6 +92,17 @@ var CostTracker = class {
     this.totalCompactionCost = 0;
     this.hasUnknownPrices = false;
   }
+  getTotalCost() {
+    return this.totalCost + this.totalCompactionCost;
+  }
+  getEstimatedTotalCost(currentTurnUsage, model, compactionModel) {
+    const { turnCost, compactionCost } = this.calculateUsageCosts(
+      model,
+      currentTurnUsage,
+      compactionModel
+    );
+    return this.getTotalCost() + turnCost + compactionCost;
+  }
   recordTurn(model, usage, compactionModel) {
     const { turnCost, compactionCost, unknownPrices } = this.calculateUsageCosts(model, usage, compactionModel);
     this.totalInputTokens += usage.inputTokens;
@@ -315,6 +326,8 @@ var trackedState = {
   useFlexTier: false,
   disableSpinner: false,
   enableInterruptions: true,
+  maxTurns: 30,
+  maxCost: null,
   session: null
 };
 
@@ -516,6 +529,12 @@ ${chalk3.bold("OPTIONS")}
                           Can also be set via HARPER_AGENT_COMPACTION_MODEL environment variable.
   -s, --session           Specify a path to a SQLite database file to persist the chat session.
                           Can also be set via HARPER_AGENT_SESSION environment variable.
+  --max-turns             Specify the maximum number of turns for the agent run.
+                          In task-driven mode, this defaults to unlimited.
+                          Can also be set via HARPER_AGENT_MAX_TURNS environment variable.
+  --max-cost              Specify the maximum cost (in USD) for the agent run.
+                          If exceeded, the agent will exit with a non-zero code.
+                          Can also be set via HARPER_AGENT_MAX_COST environment variable.
   --flex-tier             Force the use of the flex service tier for lower costs but potentially 
                           more errors under high system load.
                           Can also be set via HARPER_AGENT_FLEX_TIER=true environment variable.
@@ -583,19 +602,31 @@ function parseArgs() {
     const flagPairs = [
       ["model", ["--model", "-m", "model"]],
       ["compactionModel", ["--compaction-model", "-c", "compaction-model"]],
-      ["sessionPath", ["--session", "-s", "session"]]
+      ["sessionPath", ["--session", "-s", "session"]],
+      ["maxTurns", ["--max-turns"]],
+      ["maxCost", ["--max-cost"]]
     ];
     let handled = false;
     for (const [key, prefixes] of flagPairs) {
       for (const prefix of prefixes) {
         if (arg === prefix) {
           if (args[i + 1]) {
-            trackedState[key] = stripQuotes(args[++i]);
+            const val = stripQuotes(args[++i]);
+            if (key === "maxTurns" || key === "maxCost") {
+              trackedState[key] = parseFloat(val);
+            } else {
+              trackedState[key] = val;
+            }
           }
           handled = true;
           break;
         } else if (arg.startsWith(`${prefix}=`)) {
-          trackedState[key] = stripQuotes(arg.slice(prefix.length + 1));
+          const val = stripQuotes(arg.slice(prefix.length + 1));
+          if (key === "maxTurns" || key === "maxCost") {
+            trackedState[key] = parseFloat(val);
+          } else {
+            trackedState[key] = val;
+          }
           handled = true;
           break;
         }
@@ -631,6 +662,12 @@ function parseArgs() {
   if (!trackedState.sessionPath && process.env.HARPER_AGENT_SESSION) {
     trackedState.sessionPath = process.env.HARPER_AGENT_SESSION;
   }
+  if (process.env.HARPER_AGENT_MAX_TURNS) {
+    trackedState.maxTurns = parseFloat(process.env.HARPER_AGENT_MAX_TURNS);
+  }
+  if (process.env.HARPER_AGENT_MAX_COST) {
+    trackedState.maxCost = parseFloat(process.env.HARPER_AGENT_MAX_COST);
+  }
   const sp = trackedState.sessionPath;
   if (sp) {
     trackedState.sessionPath = sp && !sp.startsWith("~") && !path.isAbsolute(sp) ? path.resolve(process.cwd(), sp) : sp;
@@ -1231,12 +1268,12 @@ async function requiredSkillForOperation(path8, type) {
   }
   const p = normalizedPath(path8);
   const read = await getSkillsRead();
-  if (p.includes("/resources/") || p.startsWith("resources/")) {
-    if (!read.includes("custom-resources") && !read.includes("extending-tables")) {
-      return pickExistingSkill(["custom-resources", "extending-tables"]);
+  if (p.includes("/resources/") || p.startsWith("resources/") || p.endsWith("resources.ts") || p.endsWith("resources.js")) {
+    if (!read.includes("automatic-apis")) {
+      return pickExistingSkill(["automatic-apis"]);
     }
   }
-  if (p.includes("/schemas/") || p.startsWith("schemas/") || p.includes("/schema/") || p.startsWith("schema/")) {
+  if (p.endsWith(".graphql")) {
     if (!read.includes("adding-tables-with-schemas")) {
       return pickExistingSkill(["adding-tables-with-schemas"]);
     }
@@ -1275,40 +1312,42 @@ ${chalk7.bold.bgYellow.black(" Apply patch approval required: ")}`);
     return false;
   }
 }
+async function execute11(operation) {
+  try {
+    const needed = await requiredSkillForOperation(operation.path, operation.type);
+    if (needed) {
+      const content = await execute10({ skill: needed });
+      console.log(`Understanding ${needed} is necessary before applying this patch.`);
+      return { status: "failed, skill guarded", output: content };
+    }
+    switch (operation.type) {
+      case "create_file":
+        if (!operation.diff) {
+          return { status: "failed", output: "Error: diff is required for create_file" };
+        }
+        return await editor.createFile(operation);
+      case "update_file":
+        if (!operation.diff) {
+          return { status: "failed", output: "Error: diff is required for update_file" };
+        }
+        return await editor.updateFile(operation);
+      case "delete_file":
+        return await editor.deleteFile(operation);
+      default:
+        return { status: "failed", output: `Error: Unknown operation type: ${operation.type}` };
+    }
+  } catch (err) {
+    console.error("hit unexpected error in apply patch tool", err);
+    return { status: "failed", output: `apply_patch threw: ${String(err)}` };
+  }
+}
 function createApplyPatchTool() {
   return tool11({
     name: "apply_patch",
     description: "Applies a patch (create, update, or delete a file) to the workspace.",
     parameters: ApplyPatchParameters,
     needsApproval,
-    execute: async (operation) => {
-      try {
-        const needed = await requiredSkillForOperation(operation.path, operation.type);
-        if (needed) {
-          const content = await execute10({ skill: needed });
-          return { status: "completed", output: content };
-        }
-        switch (operation.type) {
-          case "create_file":
-            if (!operation.diff) {
-              return { status: "failed", output: "Error: diff is required for create_file" };
-            }
-            return await editor.createFile(operation);
-          case "update_file":
-            if (!operation.diff) {
-              return { status: "failed", output: "Error: diff is required for update_file" };
-            }
-            return await editor.updateFile(operation);
-          case "delete_file":
-            return await editor.deleteFile(operation);
-          default:
-            return { status: "failed", output: `Error: Unknown operation type: ${operation.type}` };
-        }
-      } catch (err) {
-        console.error("hit unexpected error in apply patch tool", err);
-        return { status: "failed", output: `apply_patch threw: ${String(err)}` };
-      }
-    }
+    execute: execute11
   });
 }
 
@@ -1319,7 +1358,7 @@ import { z as z12 } from "zod";
 var ToolParameters11 = z12.object({
   path: z12.string().describe("Directory to switch into. Can be absolute or relative to current workspace.")
 });
-async function execute11({ path: path8 }) {
+async function execute12({ path: path8 }) {
   try {
     const target = resolvePath(trackedState.cwd, path8);
     const stat = statSync(target);
@@ -1350,7 +1389,7 @@ var changeCwdTool = tool12({
   name: "change_cwd",
   description: "Changes the current working directory for subsequent tools. Accepts absolute or relative paths.",
   parameters: ToolParameters11,
-  execute: execute11
+  execute: execute12
 });
 
 // tools/files/egrepTool.ts
@@ -1457,7 +1496,7 @@ var IMAGE_EXTENSIONS = {
   ".webp": "image/webp",
   ".bmp": "image/bmp"
 };
-async function execute12({ fileName }) {
+async function execute13({ fileName }) {
   try {
     const normalized = String(fileName).replace(/\\/g, "/");
     const m = normalized.match(/(?:^|\/)skills\/([A-Za-z0-9_-]+)\.md(?:$|[?#])/);
@@ -1483,7 +1522,7 @@ var readFileTool = tool16({
   name: "read_file",
   description: "Reads the contents of a specified file. If the file is an image, it returns a structured image object.",
   parameters: ToolParameters15,
-  execute: execute12
+  execute: execute13
 });
 
 // tools/general/codeInterpreterTool.ts
@@ -1505,7 +1544,7 @@ var codeInterpreterTool = tool17({
   name: "code_interpreter",
   description: "Executes Python or JavaScript code in a local environment. This is useful for data analysis, complex calculations, and more. All code will be executed in the current workspace.",
   parameters: CodeInterpreterParameters,
-  execute: execute13,
+  execute: execute14,
   needsApproval: needsApproval2
 });
 async function needsApproval2(runContext, { code, language }, callId) {
@@ -1527,7 +1566,7 @@ ${chalk8.bold.bgYellow.black(` Code interpreter (${language}) approval required:
   }
   return !autoApproved;
 }
-async function execute13({ code, language }) {
+async function execute14({ code, language }) {
   const extension = language === "javascript" ? "js" : "py";
   const interpreter = language === "javascript" ? "node" : "python3";
   const tempFile = path6.join(trackedState.cwd, `.temp_code_${Date.now()}.${extension}`);
@@ -2104,7 +2143,7 @@ var ToolParameters17 = z30.object({
   directoryName: z30.string().describe("The name of the directory to create the application in."),
   template: z30.enum(["vanilla-ts", "vanilla", "react-ts", "react"]).optional().describe("The template to use for the new application. Defaults to vanilla-ts.").default("vanilla-ts")
 });
-async function execute14({ directoryName, template }) {
+async function execute15({ directoryName, template }) {
   const currentCwd = trackedState.cwd;
   const resolvedPath = resolvePath(currentCwd, directoryName);
   const isCurrentDir = resolvedPath === currentCwd;
@@ -2121,7 +2160,7 @@ async function execute14({ directoryName, template }) {
     });
     console.log(`Initializing new Git repository in ${resolvedPath}...`);
     execSync3("git init", { cwd: resolvedPath, stdio: "ignore" });
-    const switchedDir = await execute11({ path: resolvedPath });
+    const switchedDir = await execute12({ path: resolvedPath });
     return `Successfully created a new Harper application in '${resolvedPath}' using template '${template}' with a matching Git repository initialized.  Use the readDir and readFile tools to inspect the contents of the application. ${switchedDir}.`;
   } catch (error) {
     let errorMsg = `Error creating new Harper application: ${error.message}`;
@@ -2138,7 +2177,7 @@ var createNewHarperApplicationTool = tool30({
   name: "create_new_harper_application",
   description: "Creates a new Harper application using the best available package manager (yarn/pnpm/bun/deno, falling back to npm).",
   parameters: ToolParameters17,
-  execute: execute14
+  execute: execute15
 });
 
 // tools/harper/getHarperConfigSchemaTool.ts
@@ -2671,6 +2710,19 @@ async function ensureApiKey() {
   }
 }
 
+// utils/shell/getStdin.ts
+async function getStdin() {
+  if (process.stdin.isTTY) {
+    return "";
+  }
+  let result = "";
+  process.stdin.setEncoding("utf8");
+  for await (const chunk of process.stdin) {
+    result += chunk;
+  }
+  return result.trim();
+}
+
 // utils/sessions/createSession.ts
 import { MemorySession as MemorySession3 } from "@openai/agents";
 
@@ -3115,6 +3167,7 @@ async function main() {
   parseArgs();
   await ensureApiKey();
   sayHi();
+  const stdinPrompt = await getStdin();
   const agent = trackedState.agent = new Agent2({
     name: "Harper App Development Assistant",
     model: isOpenAIModel(trackedState.model) ? trackedState.model : getModel(trackedState.model),
@@ -3123,12 +3176,20 @@ async function main() {
     tools: createTools()
   });
   const session = trackedState.session = createSession(trackedState.sessionPath);
+  let firstIteration = true;
   while (true) {
     let task = "";
     let lastToolCallInfo = null;
     trackedState.controller = new AbortController();
     if (!trackedState.approvalState) {
-      task = await askQuestion("> ");
+      if (firstIteration && stdinPrompt) {
+        task = stdinPrompt;
+        console.log(`${chalk13.bold(">")} ${task}
+`);
+      } else {
+        task = await askQuestion("> ");
+      }
+      firstIteration = false;
       if (!task) {
         trackedState.emptyLines += 1;
         if (trackedState.emptyLines >= 2) {
@@ -3145,7 +3206,7 @@ async function main() {
         session,
         stream: true,
         signal: trackedState.controller.signal,
-        maxTurns: 30
+        maxTurns: trackedState.maxTurns
       });
       trackedState.approvalState = null;
       let hasStartedResponse = false;
@@ -3222,6 +3283,26 @@ ${chalk13.yellow("\u{1F6E0}\uFE0F")}  ${chalk13.cyan(name)}${chalk13.dim(display
           trackedState.model || "gpt-5.2",
           trackedState.compactionModel || "gpt-4o-mini"
         );
+        if (trackedState.maxCost !== null) {
+          const estimatedTotalCost = costTracker.getEstimatedTotalCost(
+            stream.state.usage,
+            trackedState.model || "gpt-5.2",
+            trackedState.compactionModel || "gpt-4o-mini"
+          );
+          if (estimatedTotalCost > trackedState.maxCost) {
+            spinner.stop();
+            console.log(
+              chalk13.red(
+                `Cost limit exceeded: $${estimatedTotalCost.toFixed(4)} > $${trackedState.maxCost.toFixed(4)}`
+              )
+            );
+            if (trackedState.controller) {
+              trackedState.controller.abort();
+            }
+            process.exitCode = 1;
+            return handleExit();
+          }
+        }
       }
       if (stream.interruptions?.length) {
         for (const interruption of stream.interruptions) {
@@ -3250,6 +3331,19 @@ ${chalk13.yellow("\u{1F6E0}\uFE0F")}  ${chalk13.cyan(name)}${chalk13.dim(display
           stream.state.usage,
           trackedState.compactionModel || "gpt-4o-mini"
         );
+        if (trackedState.maxCost !== null && costTracker.getTotalCost() > trackedState.maxCost) {
+          spinner.stop();
+          console.log(
+            chalk13.red(
+              `Cost limit exceeded: $${costTracker.getTotalCost().toFixed(4)} > $${trackedState.maxCost.toFixed(4)}`
+            )
+          );
+          process.exitCode = 1;
+          return handleExit();
+        }
+      }
+      if (stdinPrompt) {
+        return handleExit();
       }
     } catch (error) {
       spinner.stop();

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@harperfast/agent",
 	"description": "AI to help you with Harper app management",
-	"version": "0.13.1",
+	"version": "0.13.3",
 	"main": "dist/agent.js",
 	"repository": "github:HarperFast/harper-agent",
 	"bugs": {