howtofixcli 0.7.24 → 0.7.26

package/dist/workflow.js

@@ -0,0 +1,349 @@
+/**
+ * The `workflow` tool: one script becomes a fleet of agents.
+ *
+ * The model writes a JavaScript workflow and this runs it, which is Claude
+ * Code's `ultracode` mode reduced to what this harness's SDK can support. The
+ * script's bindings live in `workflow-engine.ts`; this file owns the two things
+ * that are about *this* harness:
+ *
+ * 1. **Which agent a call becomes.** The engine is backend-agnostic and asks for
+ *    an agent; here that resolves to the subagent registry in `agents.ts`
+ *    (`scout`/`task`/`reviewer`), opened directly rather than through the `task`
+ *    tool — the tool's `drain()` runs *every* queued run, so concurrent
+ *    `agent()` calls would each try to execute each other's runs. One run per
+ *    call, one session per call, no shared queue.
+ *
+ * 2. **`meta` and the load-time rules.** The spec's file grammar: the first
+ *    statement must be `export const meta = <pure literal>`, and the body must
+ *    not import or export. `meta.phases[].title` values are matched against
+ *    `phase()` calls for progress grouping.
+ */
+import { readFileSync } from "node:fs";
+import { basename } from "node:path";
+import { StringEnum } from "@netrodev/hxf-ai";
+import { defineTool } from "@netrodev/hxf-coding-agent";
+import { Type } from "typebox";
+import { agents, modelRef, openAgentSession } from "./agents.js";
+import { createAgentWorktree } from "./git.js";
+import { createBindings, WorkflowError } from "./workflow-engine.js";
+import { formatElapsed, formatProgressLine } from "./workflow-progress.js";
+/** The status key the live progress line is published under. */
+export const WORKFLOW_STATUS_KEY = "workflow";
+let workflowControls = null;
+export function setWorkflowControls(next) {
+    workflowControls = next;
+}
+/** Cap on how long one run may take, so a runaway script cannot hang the tool. */
+const RUN_TIMEOUT_MS = 10 * 60 * 1000;
+/**
+ * Read `meta` and enforce the load-time grammar.
+ *
+ * The spec allows only literal forms in `meta` (no identifiers, calls, member
+ * access or spreads) and forbids `import`/`export` in the body. Rather than
+ * writing a full AST check, the export is extracted textually and the literal is
+ * evaluated by a `Function` with the binding names shadowed — so an identifier
+ * in `meta` fails loudly instead of silently evaluating.
+ */
+export function parseMeta(code) {
+    // Comments and blank lines may precede `meta`: both reference parsers skip
+    // them, and the contract's own checklist *requires* a header comment ("use
+    // case, when to use, args, patterns demonstrated, cost profile, output
+    // shape") above the literal. Requiring the export to be the byte-zero
+    // statement rejected every real workflow.
+    const stripped = code.replace(/^(?:\s+|\/\/[^\n]*\n|\/\*[\s\S]*?\*\/)*/, "");
+    const head = /^export\s+const\s+meta\s*=\s*/.exec(stripped);
+    if (!head) {
+        throw new WorkflowError("a workflow script must start with `export const meta = { name, description }`");
+    }
+    // Keep the body relative to the original source so line numbers in later
+    // errors still point at the file the author wrote.
+    const bodyStart = code.length - stripped.length;
+    // Find the end of the literal by brace matching rather than by looking for a
+    // semicolon: the reference scripts omit it (`export const meta = { ... }`),
+    // and requiring one rejected every real workflow.
+    const literalStart = head[0].length;
+    let depth = 0;
+    let inString = null;
+    let end = -1;
+    for (let index = literalStart; index < stripped.length; index++) {
+        const char = stripped[index];
+        if (inString) {
+            if (char === "\\")
+                index++;
+            else if (char === inString)
+                inString = null;
+            continue;
+        }
+        if (char === '"' || char === "'" || char === "`")
+            inString = char;
+        else if (char === "{" || char === "[")
+            depth++;
+        else if (char === "}" || char === "]") {
+            depth--;
+            if (depth === 0) {
+                end = index + 1;
+                break;
+            }
+        }
+    }
+    if (end === -1)
+        throw new WorkflowError("meta is not a closed literal object");
+    const literal = stripped.slice(literalStart, end);
+    // A trailing semicolon is optional.
+    const body = code.slice(bodyStart + end).replace(/^\s*;/, "");
+    if (/^\s*(import|export)\b/m.test(body)) {
+        throw new WorkflowError("a workflow body must not contain import or export declarations");
+    }
+    if (/\bimport\s*\(/.test(body)) {
+        throw new WorkflowError("a workflow body must not use dynamic import()");
+    }
+    let meta;
+    try {
+        meta = new Function(`"use strict"; return (${literal});`)();
+    }
+    catch (error) {
+        throw new WorkflowError(`meta must be a literal object: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (typeof meta !== "object" || meta === null)
+        throw new WorkflowError("meta must be an object");
+    const record = meta;
+    if (typeof record.name !== "string" || !record.name.trim())
+        throw new WorkflowError("meta.name is required");
+    if (typeof record.description !== "string" || !record.description.trim()) {
+        throw new WorkflowError("meta.description is required");
+    }
+    const phases = Array.isArray(record.phases)
+        ? record.phases
+            .filter((entry) => typeof entry === "object" && entry !== null)
+            .map((entry) => ({
+            title: String(entry.title ?? ""),
+            ...(typeof entry.detail === "string" ? { detail: entry.detail } : {}),
+        }))
+            .filter((entry) => entry.title)
+        : undefined;
+    return {
+        meta: {
+            name: record.name,
+            description: record.description,
+            ...(typeof record.whenToUse === "string" ? { whenToUse: record.whenToUse } : {}),
+            ...(phases ? { phases } : {}),
+        },
+        body,
+    };
+}
+/**
+ * Compile a body into an async function.
+ *
+ * `Function` is the only option here: the sandbox `codemode` uses is not
+ * reachable with custom bindings (`CodemodeToolOptions` has no hook for them),
+ * and a workflow script is model-authored code running in the user's own
+ * session — the same trust level as the shell commands the agent already runs.
+ * The body is a module body, so top-level `await` and `return` are legal, which
+ * rules out a plain `Function`.
+ */
+export function compileBody(body) {
+    const names = ["agent", "parallel", "pipeline", "phase", "log", "args", "budget"];
+    const source = `"use strict"; return (async () => {\n${body}\n})();`;
+    let factory;
+    try {
+        factory = new Function(...names, source);
+    }
+    catch (error) {
+        throw new WorkflowError(`workflow did not compile: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return factory;
+}
+/** Read the final text out of an agent session, whatever shape it returns. */
+function finalText(session) {
+    return session.getLastAssistantText()?.trim() ?? "";
+}
+/**
+ * Run one agent call on a fresh subagent session.
+ *
+ * Output tokens, tool calls and the model come from the session's own stats,
+ * which is what makes the script's `budget` real rather than advisory and what
+ * fills the per-agent metric in the progress view.
+ *
+ * `isolation: "worktree"` gives the call its own checkout via `openAgentSession`,
+ * which is the only correct way to run parallel agents that write to the same
+ * files: siblings in one working tree race each other.
+ */
+export function createInvoker(parentModel) {
+    return async ({ prompt, agentType, effort, model, isolation }) => {
+        const spec = agents.get(agentType) ?? agents.get("task");
+        if (!spec)
+            throw new WorkflowError(`no agent named ${agentType}`);
+        // `isolation: "worktree"` means a private checkout, not just a private cwd:
+        // parallel writers in one tree race each other's builds and `git add -A`.
+        const worktree = isolation === "worktree" ? await createAgentWorktree(process.cwd(), agentType) : null;
+        const session = await openAgentSession({
+            agent: spec.name,
+            effort: (effort ?? spec.effort),
+            // The script's `model` has to reach the session, not only the metric line:
+            // it used to be reported as the model that ran while the child actually
+            // ran the runtime default.
+            ...(model ? { model } : {}),
+            ...(parentModel ? { parentModel } : {}),
+            ...(worktree ? { worktree: worktree.path } : {}),
+        });
+        try {
+            await session.prompt(`${spec.prompt}\n\nTask:\n${prompt}`);
+            const stats = session.getSessionStats();
+            // The session first: it is the one that ran. The script's request is the
+            // fallback for a runtime that cannot name its own model.
+            const resolved = modelId(session) ?? model;
+            return {
+                text: finalText(session),
+                outputTokens: stats.tokens.output,
+                toolCalls: stats.toolCalls,
+                ...(resolved ? { model: resolved } : {}),
+            };
+        }
+        finally {
+            session.dispose();
+            await worktree?.remove();
+        }
+    };
+}
+/** The model a session actually ran on, when the SDK exposes it. */
+function modelId(session) {
+    return session.model?.id ?? session.model?.name;
+}
+export const workflowParams = Type.Object({
+    code: Type.Optional(Type.String({ description: "The workflow script source" })),
+    path: Type.Optional(Type.String({ description: "Path to a workflow script, instead of code" })),
+    agent: Type.Optional(StringEnum(["scout", "task", "reviewer"], { description: "Default agent profile for calls" })),
+    budget: Type.Optional(Type.Number({ description: "Output-token ceiling for the whole run" })),
+});
+export function createWorkflowTool(options) {
+    // The workbench registers its panel hooks once, the same way `setAsker` and
+    // `setMirror` hand other modules a live surface. The tool is built during
+    // session construction, before the TUI exists, so it cannot be passed in.
+    const hooks = () => options ?? workflowControls;
+    return defineTool({
+        name: "workflow",
+        label: "workflow",
+        description: "Run a JavaScript workflow that orchestrates many agents deterministically. Provide `code` (or `path`). The script starts with `export const meta = { name, description, phases }` and then uses the injected bindings: `agent(prompt, {label, phase, schema, effort, model, agentType, isolation})`, `parallel(thunks)`, `pipeline(items, ...stages)`, `phase(title)`, `log(msg)`, `args`, `budget`. `agent()` resolves null on failure and throws only when the budget or the call cap is exhausted, so null-check every result. `parallel()` takes thunks and never rejects; `pipeline()` has no barrier between items. Use it for fan-out, for builder-verifier loops that converge on a verdict, and for anything needing many agents whose order and count must be deterministic.",
+        promptSnippet: "workflow: orchestrate many agents from one JavaScript script",
+        parameters: workflowParams,
+        executionMode: "sequential",
+        async execute(_toolCallId, params, signal, onUpdate, ctx) {
+            const code = params.path ? readFileSync(params.path, "utf8") : (params.code ?? "");
+            if (!code.trim())
+                throw new WorkflowError("provide code or path");
+            const { meta, body } = parseMeta(code);
+            // The contract requires `meta.name` to match the script's filename, so a
+            // run launched by path is identifiable in the progress list and in any
+            // artifact directory named after it. A mismatch is a real error, not a
+            // warning: it is what makes the name trustworthy.
+            if (params.path) {
+                const file = basename(params.path).replace(/\.(js|mjs|cjs|ts)$/, "");
+                if (file !== meta.name) {
+                    throw new WorkflowError(`meta.name "${meta.name}" must match the script filename "${file}"`);
+                }
+            }
+            const factory = compileBody(body);
+            const startedAt = Date.now();
+            const steps = [];
+            let outputTokens = 0;
+            let callCount = 0;
+            const detailsOf = (ok, error) => ({
+                name: meta.name,
+                ...(meta.description ? { description: meta.description } : {}),
+                ok,
+                agents: callCount,
+                outputTokens,
+                startedAt,
+                phases: meta.phases ?? [],
+                steps,
+                ...(error ? { error } : {}),
+            });
+            // The live surface: the dock line shows the run in flight, the way the
+            // reference puts its progress line in the task panel under the input box.
+            const publish = (progress, ended) => {
+                ctx.ui.setStatus(WORKFLOW_STATUS_KEY, ended ? undefined : formatProgressLine(progress));
+                onUpdate?.({ content: [], details: detailsOf(false) });
+            };
+            const onProgress = (agents) => {
+                callCount = agents.length;
+                outputTokens = agents.reduce((sum, agent) => sum + agent.outputTokens, 0);
+                steps.splice(0, steps.length, ...agents.map((agent) => ({
+                    label: agent.label,
+                    phase: agent.phase,
+                    agent: agent.agentType,
+                    status: agent.status,
+                    outputTokens: agent.outputTokens,
+                    startedAt: agent.startedAt,
+                    ...(agent.toolCalls !== undefined ? { toolCalls: agent.toolCalls } : {}),
+                    ...(agent.model ? { model: agent.model } : {}),
+                    ...(agent.endedAt ? { endedAt: agent.endedAt } : {}),
+                    ...(agent.detail ? { detail: agent.detail } : {}),
+                    ...(agent.tasks ? { tasks: agent.tasks } : {}),
+                })));
+                publish({ name: meta.name, ...(meta.description ? { description: meta.description } : {}), phases: meta.phases ?? [], steps, startedAt }, false);
+            };
+            const invoke = createInvoker(modelRef(ctx?.model));
+            const bindings = createBindings({
+                invoke: params.agent ? wrapAgent(invoke, params.agent) : invoke,
+                budgetTotal: params.budget ?? null,
+                onProgress,
+                ...(signal ? { signal } : {}),
+                ...(hooks()?.isPaused ? { isPaused: hooks().isPaused } : {}),
+            });
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), RUN_TIMEOUT_MS);
+            if (signal)
+                signal.addEventListener("abort", () => controller.abort(), { once: true });
+            // Hand the panel a way to stop this run. `x` in the panel calls it; the
+            // abort then resolves in-flight calls as `null`, which is the engine's
+            // normal failure mode, so a stopped run still returns a partial result
+            // instead of throwing.
+            hooks()?.onStop?.(() => controller.abort());
+            try {
+                const result = await Promise.race([
+                    factory(bindings.agent, bindings.parallel, bindings.pipeline, bindings.phase, bindings.log, bindings.args, bindings.budget),
+                    new Promise((_resolve, reject) => controller.signal.addEventListener("abort", () => reject(new WorkflowError("workflow timed out or was aborted")))),
+                ]);
+                const endedAt = Date.now();
+                ctx.ui.setStatus(WORKFLOW_STATUS_KEY, undefined);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `${meta.name}: ${callCount} agent call(s), ${outputTokens} output tokens in ${formatElapsed(endedAt - startedAt)}\n\n${render(result)}`,
+                        },
+                    ],
+                    details: { ...detailsOf(true), endedAt },
+                };
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                ctx.ui.setStatus(WORKFLOW_STATUS_KEY, undefined);
+                return {
+                    content: [{ type: "text", text: `${meta.name} failed after ${callCount} agent call(s): ${message}` }],
+                    details: { ...detailsOf(false, message), endedAt: Date.now() },
+                    isError: true,
+                };
+            }
+            finally {
+                clearTimeout(timer);
+                hooks()?.onStop?.(null);
+            }
+        },
+    });
+}
+/** Force every call to one agent profile, whatever the script asked for. */
+function wrapAgent(invoke, agentType) {
+    return (spec) => invoke({ ...spec, agentType });
+}
+/** The script's return value, as text for the model. */
+function render(value) {
+    if (typeof value === "string")
+        return value;
+    try {
+        return JSON.stringify(value, null, 2);
+    }
+    catch {
+        return String(value);
+    }
+}

package/package.json

@@ -1,20 +1,8 @@
 {
   "name": "howtofixcli",
-  "version": "0.7.24",
-  "type": "module",
+  "version": "0.7.26",
   "description": "HowToFix coding agent. Workbench TUI, sessions, background agents.",
-  "license": "UNLICENSED",
-  "homepage": "https://howtofix.id",
-  "author": "HowToFix",
-  "keywords": [
-    "coding-agent",
-    "cli",
-    "tui",
-    "howtofix"
-  ],
-  "engines": {
-    "node": ">=22.19"
-  },
+  "type": "module",
   "bin": {
     "howtofix": "dist/main.js"
   },
@@ -23,6 +11,38 @@
     "README.md",
     "LICENSE"
   ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node --input-type=module -e \"import { rmSync, cpSync } from 'node:fs'; rmSync('dist/presets', { recursive: true, force: true }); cpSync('presets', 'dist/presets', { recursive: true });\" && node scripts/set-executable.mjs",
+    "start": "node dist/main.js",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "check": "node scripts/check-all.mjs",
+    "check:hub": "node scripts/check-hub-install.mjs",
+    "check:tar": "node scripts/check-tar.mjs --online",
+    "quality": "node scripts/quality.mjs",
+    "frame": "node scripts/render-frame.mjs",
+    "frame:workflow": "node scripts/render-workflow-frame.mjs",
+    "probe:commands": "python3 scripts/probe-slash-commands.py",
+    "build:release": "node scripts/build-release.mjs",
+    "version": "node scripts/sync-version.mjs",
+    "slop": "node scripts/slop.mjs",
+    "slop:commits": "node scripts/slop.mjs --commits",
+    "hooks:install": "git config core.hooksPath .githooks && echo 'hooks installed from .githooks'",
+    "check:sync": "node scripts/check-hub-sync.mjs --online",
+    "check:level-color": "python3 scripts/probe-level-color.py",
+    "check:skills-wire": "node scripts/check-skill-wire.mjs",
+    "check:agents-live": "node scripts/check-subagent-live.mjs",
+    "release:patch": "node scripts/release.mjs patch",
+    "release:minor": "node scripts/release.mjs minor",
+    "release:major": "node scripts/release.mjs major",
+    "release:dry": "node scripts/release.mjs patch --dry",
+    "test": "node --test test/*.test.mjs",
+    "format": "prettier --write \"src/**/*.ts\" \"scripts/**/*.mjs\" \"test/**/*.mjs\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"scripts/**/*.mjs\" \"test/**/*.mjs\""
+  },
+  "license": "UNLICENSED",
+  "engines": {
+    "node": ">=22.19"
+  },
   "dependencies": {
     "@netrodev/hxf-agent-core": "^1.0.22",
     "@netrodev/hxf-ai": "^1.0.22",
@@ -31,5 +51,32 @@
     "typebox": "^1.4.3",
     "typescript": "7.0.2",
     "undici": "^8.12.3"
-  }
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.5",
+    "esbuild": "^0.28.2",
+    "prettier": "^3.9.10"
+  },
+  "homepage": "https://howtofix.id",
+  "author": "HowToFix",
+  "keywords": [
+    "coding-agent",
+    "cli",
+    "tui",
+    "howtofix"
+  ],
+  "contributors": [
+    {
+      "name": "hshinosa",
+      "url": "https://github.com/hshinosa"
+    },
+    {
+      "name": "yhagus",
+      "url": "https://github.com/yhagus"
+    },
+    {
+      "name": "mmatttttt",
+      "url": "https://github.com/mmatttttt"
+    }
+  ]
 }

package/dist/chunk-27TRKD65.js

@@ -1,2 +0,0 @@
-import{a as u}from"./chunk-UTYFLLSM.js";import{existsSync as l,mkdirSync as f,readFileSync as c}from"node:fs";import{dirname as p,join as m}from"node:path";var a={skipPermissions:!1,autoUpdate:!0,rightClickPaste:"auto",welcomeSeen:!1,compressToolOutput:!1};function g(t){return m(t,"settings.json")}function k(t){try{let e=JSON.parse(c(g(t),"utf8")),n=r=>{let i=e[r];return typeof i=="boolean"?i:a[r]},o=e.rightClickPaste;return{skipPermissions:n("skipPermissions"),autoUpdate:n("autoUpdate"),rightClickPaste:o==="on"||o==="off"||o==="auto"?o:a.rightClickPaste,welcomeSeen:n("welcomeSeen"),compressToolOutput:n("compressToolOutput"),...typeof e.agents=="number"&&Number.isInteger(e.agents)&&e.agents>0?{agents:e.agents}:{}}}catch{return{...a}}}function h(t,e,n){return s(t,e,n)}function w(t){return s(t,"welcomeSeen",!0)}function P(t,e){return s(t,"rightClickPaste",e==="auto"?void 0:e)}function y(t){return t==="on"?!0:t==="off"?!1:process.platform!=="win32"}function x(t,e){let n=typeof e=="number"&&Number.isInteger(e)&&e>0?e:void 0;return s(t,"agents",n)}function C(t,e,n){let o=n.trim();return s(t,e,o===""?void 0:o)}function s(t,e,n){let o=g(t),r={};try{let i=JSON.parse(c(o,"utf8"));i&&typeof i=="object"&&!Array.isArray(i)&&(r=i)}catch{if(l(o))return!1}n===void 0?delete r[e]:r[e]=n;try{f(p(o),{recursive:!0}),u(o,`${JSON.stringify(r,null,2)}
-`)}catch{return!1}return!0}export{a,k as b,h as c,w as d,P as e,y as f,x as g,C as h};

package/dist/chunk-3FYCFLNK.js

@@ -1 +0,0 @@
-import{readFileSync as u}from"node:fs";import{join as c}from"node:path";import{EnvHttpProxyAgent as p,ProxyAgent as l,getGlobalDispatcher as a,setGlobalDispatcher as s}from"undici";var f="httpsProxy";function d(n){let e;try{e=JSON.parse(u(c(n,"settings.json"),"utf8"))}catch{return}let r=e[f];if(typeof r!="string")return;let t=r.trim();return t===""?void 0:t}function m(){let e=(process.env.HTTPS_PROXY??process.env.HTTP_PROXY??process.env.ALL_PROXY)?.trim();return e||void 0}function g(n){let e=n.trim();if(e==="")return{ok:!1,problem:"empty"};let r;try{r=new URL(e)}catch{return{ok:!1,problem:`"${e}" is not a URL`}}let t=r.protocol.replace(/:$/,"").toLowerCase();return t!=="http"&&t!=="https"?{ok:!1,problem:`unsupported scheme "${t}"; use http:// or https://`}:r.hostname?{ok:!0,url:e}:{ok:!1,problem:"no host in the proxy URL"}}var i;function P(n){let e=()=>{i===void 0&&(i=a()),s(i)},r=d(n);if(r){let o=g(r);if(!o.ok)return{source:"settings"};try{s(new l(o.url))}catch{return e(),{source:"settings"}}return{url:o.url,source:"settings"}}let t=m();if(t){try{s(new p)}catch{return e(),{source:"env"}}return{url:t,source:"env"}}return e(),{source:"none"}}export{f as a,d as b,m as c,g as d,P as e};

package/dist/chunk-3LZR7OEU.js

@@ -1 +0,0 @@
-var o=/no available channel for model\s+([^\s"',)\]]+)/i;function s(t){let e=t??"";if(e.trim())return o.exec(e)?.[1]}function a(t){let e=t??"";if(!e.trim())return;let n=s(e);if(n)return`the gateway has no live channel for ${n} right now \u2014 /model lists the models that answer; pick another.`;if(/\bmissing api key\b|\bauthenticationerror\b|\bauth\s*error\b/i.test(e))return"no key for this model yet \u2014 /connect signs you in and pulls the model list.";if(/\bunknown model\b/i.test(e))return"/connect pulls the current model list from the gateway.";if(/\bcode 11128\b|\billegal api invocation\b/i.test(e))return"the gateway refused the request shape (code 11128) \u2014 /connect re-syncs each model's compatibility flags.";if(/\binsufficient (?:balance|quota|credit)\b|\bexceeded your current quota\b|http\s*402/i.test(e))return"the account is out of credit \u2014 /usage shows what is left.";if(/\bserver error\b|http\s*5\d\d/i.test(e))return"the gateway's channel is failing, not the CLI \u2014 /model lists what your account can reach; pick another.";if(/\brate.?limit|\b429\b/i.test(e))return"the gateway is rate-limiting this token \u2014 wait a moment, then resend the prompt.";if(/\bprompt (?:is )?too long\b|\bprompt too long\b|\bexceeds? (?:the )?(?:model'?s )?maximum context length\b|\bmaximum context length is \d+ tokens\b|\bexceeds the context window\b|\bcontext[_ ]length[_ ]exceeded\b|\breduce the length of the messages\b/i.test(e))return"the conversation is past this model's context window \u2014 /compact summarises it and continues, or /model picks a model with a bigger window.";if(/\bupstream api error\b/i.test(e))return"the gateway refused the request \u2014 run /connect again to re-sync your models."}function u(t){let e=0,n;return{limit:t,close(r){e+=r},total(r){return e+r},check(r){if(t===void 0||n!==void 0)return n;let i=e+r;return i-t>1e-9&&(n={spent:i,limit:t}),n}}}function c(t,e){return`stopped \u2014 spent $${t.toFixed(4)} of a $${e.toFixed(2)} budget.`}function l(t,e){return`--max-budget-usd needs a model with prices, and ${t} declares none (its rates are zero, so every turn costs $0 and the budget would never fire). Add a cost to that model in ${e}/models.json, or drop the flag.`}export{s as a,a as b,u as c,c as d,l as e};

package/dist/chunk-56SEAGAQ.js

@@ -1 +0,0 @@
-import{b as a,c as b,d as c,e as d,f as e,g as f,h as g,i as h,j as i,k as j,l as k,m as l,n as m,o as n,p as o,q as p,r as q}from"./chunk-JFYVRWJI.js";import"./chunk-WOT6VMZA.js";export{c as APPROVAL_LABELS,b as APPROVAL_MODES,f as MODE_MAX_TIER,e as TIER_RANK,q as createPermissionExtension,h as criticalCommand,n as decideToolCall,o as describeToolCall,p as formatApprovalPrompt,j as getApprovalMode,d as isApprovalMode,l as isDangerousBypass,a as isReadOnlyCommand,g as resolveTier,i as setApprovalMode,m as setApprovalPrompt,k as setDangerousBypass};

package/dist/chunk-5AWTL34S.js

@@ -1 +0,0 @@
-import{a,b,c,d,e,f,g,h,i,j}from"./chunk-C5E3SFOQ.js";import"./chunk-N3J2J7EQ.js";import"./chunk-WOT6VMZA.js";export{h as CLI_CLIENT_HEADER,a as CLI_SIGNING_KEY_ID,i as cliClientHeader,c as cliSignaturePayload,f as cliSigningKeyFingerprint,e as cliSigningKeyMatchesPanel,b as cliSigningPublicKey,d as createNonce,g as describeClient,j as signLoginRequest};

package/dist/chunk-75P2SCOT.js

@@ -1 +0,0 @@
-import{A,B,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w,x,y,z}from"./chunk-MNDKS6UH.js";import"./chunk-UTYFLLSM.js";import"./chunk-C5E3SFOQ.js";import"./chunk-N3J2J7EQ.js";import"./chunk-WOT6VMZA.js";export{g as CATALOG_CACHE_TTL_MS,m as DEFAULT_CONTEXT_WINDOW,a as HOWTOFIX_BASE_URL,b as HOWTOFIX_CONSOLE_URL,l as HOWTOFIX_MODEL_COMPAT,c as HOWTOFIX_PROVIDERS,j as HTTP_IDLE_TIMEOUT_MS,r as UNLIMITED_SENTINEL,v as applyCatalog,w as applyCompat,A as checkAccount,s as checkUsage,d as configuredProviderIds,x as countNewModels,k as ensureGatewaySettings,B as fetchGatewayPrices,z as findLiveModels,q as isHowtofixProvider,h as loadCatalog,o as looksLikeToken,n as maskToken,u as mergeModels,e as newProviderEntry,p as parseModelIds,y as probeModel,f as repairGatewayModels,i as repairModelFacts,t as syncGatewayModelsOnStart};

package/dist/chunk-7CHDNTH6.js

@@ -1 +0,0 @@
-import{a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u}from"./chunk-WUPU6LTD.js";import"./chunk-WOT6VMZA.js";export{f as BROKEN_LOCK_GRACE_MS,c as CHECK_ATTEMPTS,k as CHECK_FAILED_MESSAGE,b as CHECK_TIMEOUT_MS,d as INSTALL_TIMEOUT_MS,e as LOCK_TIMEOUT_MS,j as NPM_MISSING_MESSAGE,a as PACKAGE_NAME,n as acquireUpdateLock,u as autoUpdateEnabled,l as checkFailedNote,q as checkForUpdate,g as compareVersions,s as installUpdate,t as isInstalledCopy,h as isNewer,p as latestVersion,r as npmFailureDetail,m as pidAlive,o as releaseUpdateLock,i as resolveNpm};

package/dist/chunk-7PHRNXLN.js

@@ -1,34 +0,0 @@
-import{$ as Ne,A as Te,B as $e,D as A,E as G,Ea as Xe,G as M,H as Ee,P as Ae,Pa as Ye,Q as ve,Qa as Ve,R as je,S as Oe,T as Pe,V as Re,W as Ce,Y as De,_ as W,a as C,b as D,ba as Fe,c as ie,ca as Me,d as ae,da as Ie,e as ce,ea as Le,f as le,fa as Ge,g as $,i as de,ia as Ue,j as ue,k as fe,ka as Be,l as me,la as U,m as ge,ma as He,na as We,o as he,p as we,pa as z,q as ye,r as be,s as ke,t as E,ta as ze,u as xe,ua as qe,v as Se,w as L,wa as Ze,x as _e,xa as Ke}from"./chunk-AUDMRGWF.js";import{r as re}from"./chunk-JFYVRWJI.js";import{b as pe}from"./chunk-27TRKD65.js";import{D as k,G as te,r as Q,s as ee}from"./chunk-V656XVXV.js";import{c as ne}from"./chunk-MNDKS6UH.js";import{h as oe,l as se}from"./chunk-QPHSHL7H.js";import"./chunk-UTYFLLSM.js";import"./chunk-C5E3SFOQ.js";import{b as I,c as V,d as J}from"./chunk-N3J2J7EQ.js";import"./chunk-WOT6VMZA.js";import{join as _t}from"node:path";import{hostname as Fn}from"node:os";import{createAgentSession as Mn,createCodemodeExtension as In,createMcpExtension as Ln,DefaultResourceLoader as Gn,ProjectTrustStore as Un,SessionManager as B,SettingsManager as Bn}from"@netrodev/hxf-coding-agent";import{existsSync as $t,readFileSync as Et}from"node:fs";import{join as At}from"node:path";var Je=At(k,"APPEND_SYSTEM.md"),vt=["<non-interactive>","This run has no user attached: it was started with --print, and there is nobody to answer a question. Anything that stops and waits for a reply \u2014 `ask`, a confirmation, a skill that resolves a mode by asking which mode to use \u2014 will simply end the run with the task unfinished.","So do not ask. Where an instruction tells you to ask the user and wait, take the default it describes and continue, and say which default you took and why in your final answer. The user reads that answer; they cannot answer mid-run.","Where a skill offers a choice of modes, prefer the one that applies the rules while you work over the one that audits afterwards: this is the mode for building something now, and the audit mode can still be run later by the same person who reads your answer.","</non-interactive>"].join(`
-`),jt=16*1024;function Ot(e){try{if(!$t(e))return;let o=Et(e,"utf8").trim();return!o||Buffer.byteLength(o,"utf8")>jt?void 0:o}catch{return}}function Qe(e,o){let s=[o?e:`${e}
-
-${vt}`],t=Ot(Je);return t&&s.push(`# Standing instructions from ${Je}
-${t}`),s}function Pt(e){return e.replace(/operating inside hxf, a coding agent harness/gi,"operating as HowToFix, a coding agent harness").replace(/^HowToFix documentation \(read only when the user asks about[^\n]*\):?$/gim,"Harness documentation (internal reference; the user is never told the harness name):").replace(/\bhxf itself\b/gi,"the harness itself").replace(/^- When reading hxf docs or examples/m,"- When reading harness docs or examples").replace(/^- When working on hxf topics/m,"- When working on harness topics").replace(/^- Always read hxf \.md files/m,"- Always read the harness .md files").replace(/\bhxf packages\b/gi,"harness packages").replace(/\bhxf \.md files\b/gi,"harness .md files").replace(/\bhxf docs\b/gi,"harness docs").replace(/^-\s*You can inspect HXF_\* environment variables/m,"- You can inspect the harness's environment variables")}var Rt=["preamble","rules","docs","addendum"];function Ct(e){if(!e)return;let o=!1,s={...e};for(let t of Rt){let n=s[t];if(typeof n!="string")continue;let r=Pt(n);r!==n&&(s[t]=r,o=!0)}return o?s:void 0}function et(){return e=>{e.on("context_with_system",async o=>{let s=o.messages[0];if(!s||s.role!=="system")return;let t=Ct(s.sections);return t?{messages:o.messages.map(r=>r===s?{...s,sections:t}:r)}:void 0})}}var x={hooks:{}},N;function tt(){return e=>{let o=ce(ie);x=o.config,N=void 0,le(),e.on("session_start",async(s,t)=>{for(let a of o.diagnostics)t.ui.notify(`hooks.json: ${a.message}`,"warning");let{outcome:n,ran:r}=await $(x,"SessionStart",{hook_event_name:"SessionStart",cwd:t.cwd},{cwd:t.cwd});n.context&&(N=n.context),n.error&&t.ui.notify(`SessionStart hook: ${n.error}`,"warning"),r&&N&&t.ui.notify(`SessionStart hooks added ${N.length} characters of context`,"info")}),e.on("input",async(s,t)=>{if(!x.hooks.UserPromptSubmit)return;let n={hook_event_name:"UserPromptSubmit",cwd:t.cwd,prompt:s.text},{outcome:r}=await $(x,"UserPromptSubmit",n,{cwd:t.cwd});if(r.error&&t.ui.notify(`UserPromptSubmit hook: ${r.error}`,"warning"),r.block)return t.ui.notify(r.reason??"blocked by a hook","warning"),{action:"handled"};if(r.context)return{action:"transform",text:`${s.text}
-
-${r.context}`}}),e.on("tool_call",async(s,t)=>{if(!x.hooks.PreToolUse)return;let n={hook_event_name:"PreToolUse",cwd:t.cwd,tool_name:s.toolName,tool_input:s.input},{outcome:r}=await $(x,"PreToolUse",n,{cwd:t.cwd});if(r.error&&t.ui.notify(`PreToolUse hook: ${r.error}`,"warning"),r.block)return{block:!0,reason:r.reason??"blocked by a hook"};if(r.updatedInput){let i=e.getAllTools().find(f=>f.name===s.toolName)?.parameters;if(!i)t.ui.notify(`PreToolUse hook rewrote \`${s.toolName}\`, but no schema is known for that tool \u2014 the rewrite was ignored`,"warning");else{let f=ae(i,r.updatedInput);f?t.ui.notify(`PreToolUse hook rewrite ignored \u2014 ${f}`,"warning"):Object.assign(s.input,r.updatedInput)}}}),e.on("tool_result",async(s,t)=>{if(!x.hooks.PostToolUse)return;let n=s.content.map(i=>i.type==="text"?i.text:"").join(`
-`),r={hook_event_name:"PostToolUse",cwd:t.cwd,tool_name:s.toolName,tool_input:s.input,tool_result:n,tool_is_error:s.isError},{outcome:a}=await $(x,"PostToolUse",r,{cwd:t.cwd});if(a.error&&t.ui.notify(`PostToolUse hook: ${a.error}`,"warning"),!!a.context)return{content:[...s.content,{type:"text",text:`
-[hook] ${a.context}`}],structuredContent:s.structuredContent}}),e.on("context_with_system",async s=>{if(!N)return;let t=s.messages[0];if(!t||t.role!=="system")return;let n=`${C(t.content)}
-
-${N}`;return{messages:s.messages.map(a=>a===t?{...t,content:D(t.content,n)}:a)}}),e.on("session_before_compact",async(s,t)=>{if(!x.hooks.PreCompact)return;let{outcome:n}=await $(x,"PreCompact",{hook_event_name:"PreCompact",cwd:t.cwd,compact_reason:s.reason},{cwd:t.cwd});n.error&&t.ui.notify(`PreCompact hook: ${n.error}`,"warning")}),e.on("session_shutdown",async(s,t)=>{if(!x.hooks.SessionEnd)return;let{outcome:n}=await $(x,"SessionEnd",{hook_event_name:"SessionEnd",cwd:t.cwd,reason:s.reason},{cwd:t.cwd});n.error&&t.ui.notify(`SessionEnd hook: ${n.error}`,"warning")}),e.on("agent_settled",async(s,t)=>{if(!x.hooks.Stop)return;let{outcome:n}=await $(x,"Stop",{hook_event_name:"Stop",cwd:t.cwd},{cwd:t.cwd});n.error&&t.ui.notify(`Stop hook: ${n.error}`,"warning")})}}var Dt=new Set(["bash","grep","find","ls","bash_output","powershell"]),Nt=new Set(["bash","bash_output","powershell"]),Ft=40,Mt=12,It=8,ot=6;function Lt(e,o){let s=e.trim();return!!(s===""||/^[-=*_~+#]{3,}$/.test(s)||o!==void 0&&e===o)}function nt(e){return e.replace(/\d+/g,"#").trimEnd()}function Gt(e){let o=[],s=0,t=0;for(;t<e.length;){let n=nt(e[t]);if(n===""||!/\d/.test(e[t])){o.push(e[t]),t+=1;continue}let r=t+1;for(;r<e.length&&nt(e[r])===n&&/\d/.test(e[r]);)r+=1;let a=r-t;if(a>=ot)o.push(e[t]),o.push(`  \u2026 ${a-2} more line${a-2===1?"":"s"} of the same shape \u2026`),o.push(e[r-1]),s+=1;else for(let i=t;i<r;i+=1)o.push(e[i]);t=r}return{out:o,collapsed:s}}function Ut(e,o,s={}){if(o?.truncated)return;let t=e.split(`
-`);if(t.length<Ft)return;let n=[],r=0;for(let g=0;g<t.length;g+=1){if(Lt(t[g],n[n.length-1])){if(t[g].trim()===""&&n[n.length-1]?.trim()!==""){n.push("");continue}r+=1;continue}n.push(t[g])}let a=s.toolName===void 0||Nt.has(s.toolName),{out:i,collapsed:f}=a?Gt(n):{out:n,collapsed:0},p=s.head??Mt,u=s.tail??It,c=i,d=0;if(i.length>p+u+ot&&(d=i.length-p-u,c=[...i.slice(0,p),`  \u2026 ${d} line${d===1?"":"s"} omitted (${p} kept from the top, ${u} from the end) \u2026`,...i.slice(i.length-u)]),!(r+f===0&&d===0))return{text:c.join(`
-`),stats:{before:t.length,after:c.length,collapsed:f}}}function st(e){return o=>{o.on("tool_result",s=>{if(!e.enabled()||s.isError||!Dt.has(s.toolName))return;let t=s.content.find(i=>i.type==="text");if(!t||t.type!=="text")return;let n=s.details,r=Ut(t.text,n,{toolName:s.toolName});return r?{content:s.content.map(i=>i===t?{type:"text",text:r.text}:i)}:void 0})}}import{readdirSync as Bt,readFileSync as Ht,statSync as Wt}from"node:fs";import{extname as zt,join as rt,relative as qt,resolve as Zt,sep as it}from"node:path";import{Type as P}from"@netrodev/hxf-ai";import{defineTool as Kt}from"@netrodev/hxf-coding-agent";var Xt=new Set(["node_modules",".git","dist","build","out","coverage","vendor","target","__pycache__",".venv","venv",".next",".turbo",".cache"]),v={".ts":{kind:"ts",patterns:[/^\s*export\s+(?:default\s+)?(?:async\s+)?function\s+([A-Za-z_$][\w$]*)/gm,/^\s*export\s+(?:abstract\s+)?class\s+([A-Za-z_$][\w$]*)/gm,/^\s*export\s+(?:interface|type)\s+([A-Za-z_$][\w$]*)/gm,/^\s*export\s+const\s+([A-Za-z_$][\w$]*)/gm,/^\s*(?:export\s+)?(?:async\s+)?function\s+([A-Za-z_$][\w$]*)/gm,/^\s*(?:export\s+)?class\s+([A-Za-z_$][\w$]*)/gm]},".tsx":{kind:"tsx",patterns:[]},".js":{kind:"js",patterns:[]},".mjs":{kind:"js",patterns:[]},".go":{kind:"go",patterns:[/^func\s+(?:\([^)]*\)\s*)?([A-Za-z_]\w*)/gm,/^type\s+([A-Za-z_]\w*)\s+(?:struct|interface)/gm]},".py":{kind:"py",patterns:[/^(?:async\s+)?def\s+([A-Za-z_]\w*)/gm,/^class\s+([A-Za-z_]\w*)/gm]},".rs":{kind:"rs",patterns:[/^\s*(?:pub\s+)?(?:async\s+)?fn\s+([A-Za-z_]\w*)/gm,/^\s*(?:pub\s+)?(?:struct|enum|trait)\s+([A-Za-z_]\w*)/gm]}};v[".tsx"].patterns=v[".ts"].patterns;v[".js"].patterns=v[".ts"].patterns;v[".mjs"].patterns=v[".ts"].patterns;var Yt=512*1024,Vt=12;function Jt(e,o){let s=v[o];if(!s)return[];let t=new Set,n=[];for(let r of s.patterns){r.lastIndex=0;for(let a of e.matchAll(r)){let i=a[1];i&&!t.has(i)&&(t.add(i),n.push(i))}}return n}function Qt(e,o){let s=new Set,t=n=>{n&&(n.startsWith("./")||n.startsWith("../"))&&s.add(n)};if(o===".ts"||o===".tsx"||o===".js"||o===".mjs"){for(let n of e.matchAll(/(?:from|require\()\s*["']([^"']+)["']/g))t(n[1]);for(let n of e.matchAll(/^\s*import\s+["']([^"']+)["']/gm))t(n[1])}else if(o===".go")for(let n of e.matchAll(/^\s*(?:[\w.]+\s+)?"([^"]+)"/gm))t(n[1]);else if(o===".py")for(let n of e.matchAll(/^\s*from\s+(\.+[\w.]*)\s+import/gm)){let r=n[1].replace(/\./g,"/");t(r.startsWith("/")?`.${r}`:`./${r}`)}else if(o===".rs")for(let n of e.matchAll(/^\s*use\s+(?:crate|super|self)::([\w:]+)/gm))t(`./${n[1].split("::").join("/")}`);return[...s]}function en(e,o,s){let t=e.split("/").slice(0,-1).join("/"),n=rt(t,o).split(it).join("/").replace(/^\.\//,"");return[n,`${n}.ts`,`${n}.tsx`,`${n}.js`,`${n}.mjs`,`${n}.go`,`${n}.py`,`${n}.rs`,`${n}/index.ts`,`${n}/index.tsx`,`${n}/index.js`,`${n}/mod.rs`,`${n}.py`].find(a=>s.has(a))}function tn(e,o="."){let s=[],t=(n,r)=>{if(r>Vt)return;let a;try{a=Bt(n,{withFileTypes:!0})}catch{return}for(let i of a){let f=rt(n,i.name);if(i.isDirectory()){if(Xt.has(i.name)||i.name.startsWith("."))continue;t(f,r+1);continue}let p=zt(i.name);if(v[p])try{if(Wt(f).size>Yt)continue;let u=Ht(f,"utf8"),c=qt(e,f).split(it).join("/");s.push({path:c,symbols:Jt(u,p),imports:Qt(u,p)})}catch{}}};return t(Zt(e,o),0),s}function nn(e,o){if(e.length===0)return[];let s=new Set(e.map(c=>c.path)),t=new Map(e.map((c,d)=>[c.path,d])),n=e.map(()=>[]),r=e.map(()=>[]);e.forEach((c,d)=>{for(let l of c.imports){let g=en(c.path,l,s);if(!g||g===c.path)continue;let b=t.get(g);b!==void 0&&(n[d].push(b),r[b].push(d))}});let a=e.length,i=o?.trim().toLowerCase(),f=e.map(c=>i&&`${c.path} ${c.symbols.join(" ")}`.toLowerCase().includes(i)?4/a:1/a),p=f.reduce((c,d)=>c+d,0),u=e.map((c,d)=>f[d]/p);for(let c=0;c<20;c++){let d=e.map((l,g)=>.15*(f[g]/p));for(let l=0;l<a;l++){if(n[l].length===0){for(let g=0;g<a;g++)d[g]+=.85*u[l]/a;continue}for(let g of n[l])d[g]+=.85*u[l]/n[l].length}u=d}return e.map((c,d)=>({file:c,score:u[d],match:i?`${c.path} ${c.symbols.join(" ")}`.toLowerCase().includes(i):!1})).sort((c,d)=>Number(d.match)-Number(c.match)||d.score-c.score||c.file.path.localeCompare(d.file.path)).map(c=>c.file)}function on(e,o={}){let t=Math.max(200,Math.min(8e3,o.budget??1200))*4,n=nn(e,o.query),r=[],a=0;for(let f of n){let p=f.symbols.slice(0,8).join(", "),u=p?`${f.path}: ${p}`:`${f.path}`;if(a+u.length+1>t)break;r.push(u),a+=u.length+1}if(r.length===0)return"(no source files found)";let i=n.length-r.length;return i>0&&r.push(`\u2026 ${i} more file${i===1?"":"s"} not shown`),r.join(`
-`)}var at;function ct(e){at=e}var lt=Kt({name:"repo_map",label:"repo_map",description:"A ranked outline of the repository: files by importance with their top declarations. Use it to find where something lives before reading files, instead of listing directories.",promptSnippet:"repo_map: ranked file outline of the project",parameters:P.Object({path:P.Optional(P.String({description:"Subdirectory to map, relative to the project root"})),query:P.Optional(P.String({description:"Keyword to bias the ranking, e.g. 'billing'"})),budget:P.Optional(P.Number({description:"Token budget, default 1200"}))}),async execute(e,o){let s=at?.()??process.cwd(),t=tn(s,o.path??".");return{content:[{type:"text",text:on(t,{budget:o.budget,query:o.query})}],details:{files:t.length}}}});function q(){return{consecutiveFailures:0,tripped:!1}}function sn(e,o){return o==="manual"?!1:e.consecutiveFailures>=3}function rn(e,o){if(o)return e;let s=e.consecutiveFailures+1;return{consecutiveFailures:s,tripped:e.tripped||s>=3}}function an(){return q()}function cn(e){return[`Auto-compaction failed ${e.consecutiveFailures} times in a row, so it is switched off for this session.`,"The context is over the limit and compaction cannot recover it. Start a new session, or switch to a model with a larger context window.","Manual /compact is still allowed."].join(" ")}var j=q();function dt(){return e=>{e.on("session_start",async()=>{j=q()}),e.on("session_compact",async()=>{j=an()}),e.on("session_compact_failed",async(o,s)=>{let t=j;j=rn(j,o.aborted),!t.tripped&&j.tripped&&s?.ui&&s.ui.notify(cn(j),"warning")}),e.on("session_before_compact",async o=>{if(sn(j,o.reason))return{cancel:!0}})}}function ln(e){A(M(e))}function pt(e){return`budget exhausted (${e.budget??"default"} continuations)`}function ut(){return e=>{e.on("session_start",async(o,s)=>{ln(s)}),e.on("context_with_system",async(o,s)=>{let t=M(s);if(A(t),!t||t.status!=="active")return;let n=o.messages[0];if(!n||n.role!=="system")return;let r=`${C(n.content)}
-
-${Te(t)}`;return{messages:o.messages.map(i=>i===n?{...n,content:D(n.content,r)}:i)}}),e.on("agent_before_settle",async(o,s)=>{try{let t=M(s);if(A(t),G(t).action==="stop"||!t||o.continue||!o.context.canContinue)return;let n={...t,used:t.used+1};if(e.appendEntry(L,n),A(n),G(n).action==="stop"){let r={...n,status:"done",note:pt(n)};e.appendEntry(L,r),A(r);return}return{entries:[{type:"custom_message",customType:_e,content:$e(n),display:!0}],continue:!0}}catch{return}}),e.on("agent_settled",async(o,s)=>{try{let t=M(s),n=G(t);if(t&&n.action==="stop"&&n.close){let r={...t,status:"done",note:pt(t)};e.appendEntry(L,r),A(r)}else A(t)}catch{return}})}}function dn(e){let o=ee(e);return o.length===0?"":["The user installed the following presets. Their rules apply to this session.","",...o.map(t=>`<preset name="${t.name}">
-${t.text}
-</preset>`)].join(`
-`)}function ft(e){return o=>{o.on("resources_discover",async()=>{let s=Q(e);return s.length>0?{skillPaths:s}:void 0}),o.on("context_with_system",async s=>{let t=dn(e);if(!t)return;let n=s.messages[0];if(!n||n.role!=="system")return;let r=`${C(n.content)}
-
-${t}`;return{messages:s.messages.map(i=>i===n?{...n,content:D(n.content,r)}:i)}})}}import{Type as w}from"@netrodev/hxf-ai";import{defineTool as pn}from"@netrodev/hxf-coding-agent";function un(){return[...U.values()].map(e=>`${e.name} (${e.description})`).join(", ")}function mt(){return pn({name:"task",label:"task",description:`Spawn subagents. Available: ${un()}. One call can carry tasks[]; each item may set agent, model, effort and isolation. Agents run concurrently, park when done, and can be resumed or messaged with /agents. Pass background: true to return as soon as they start instead of waiting for them. Use architect to design an approach before a large change. Set isolation: "worktree" on every task that writes files.`,promptSnippet:"task: spawn background agents",parameters:w.Object({agent:w.Optional(w.String()),effort:w.Optional(w.String()),model:w.Optional(w.String()),task:w.Optional(w.String()),isolation:w.Optional(w.String()),background:w.Optional(w.Boolean()),tasks:w.Optional(w.Array(w.Object({agent:w.Optional(w.String()),effort:w.Optional(w.String()),model:w.Optional(w.String()),task:w.String(),isolation:w.Optional(w.String())})))}),executionMode:"parallel",async execute(e,o,s,t,n){let r=o.tasks&&o.tasks.length>0?o.tasks.map(l=>({agent:l.agent??o.agent??"task",task:l.task,effort:l.effort??o.effort,model:l.model??o.model,isolation:l.isolation??o.isolation})):[{agent:o.agent??"task",task:o.task??"",effort:o.effort,model:o.model,isolation:o.isolation}],a=r.slice(0,z),i=r.length-a.length,f=!!o.background,p=[],u=[],c=[],d=[];try{for(let m of a){if(!m.task.trim())continue;let _;if(m.isolation==="worktree"){let h=await Xe(n?.cwd??process.cwd(),m.agent);if(h){u.push(h),_=h.path;for(let S of h.skipped)d.push(`${m.agent}:${S}`)}else c.push(m.agent)}p.push(await qe({...m,cwd:n?.cwd,background:f,parentModel:ze(n?.model),worktree:_})),t?.({content:[],details:{agents:p.map(h=>({id:h.id,agent:h.agent,status:h.status}))}})}if(p.length===0)throw new Error("task or tasks is required");let l=i>0?`(only the first ${z} of ${r.length} tasks ran)`:"",g=p.filter(m=>m.worktree).length,b=[l,c.length>0?`isolation: "worktree" was requested but not available for: ${c.join(", ")}. Those agents ran in the shared working tree \u2014 check their edits for collisions before trusting them.`:"",d.length>0?`too large to copy into the isolated worktree, so it was left out: ${d.join(", ")}. An agent that needs it cannot install or build \u2014 treat any "done" from those runs as unverified.`:""].filter(Boolean),y={agents:p.map(m=>({id:m.id,status:m.status,isolated:!!m.worktree}))};if(f){Ze();let m=p.map(_=>`${_.agent}#${_.id}`).join(", ");return{content:[{type:"text",text:`started ${p.length} agent${p.length===1?"":"s"} in the background: ${m}.`+(g>0?` ${g} of them in their own worktree.`:"")+`
-Their results are not part of this turn \u2014 keep working. Read them with /agents, or message one with /agents <id> <text>.`+(b.length>0?`
-${b.join(`
-`)}`:"")}],details:y}}await Ke(s);let T=p.map(m=>`${We(m)}${m.worktree?" [isolated]":""}
-${m.result??""}`);return b.length>0&&T.push(b.join(`
-`)),{content:[{type:"text",text:T.join(`
-
-`)}],details:y}}finally{for(let l of u)try{await l.remove()}catch{}}}})}import{readFileSync as fn,readdirSync as mn,statSync as gn}from"node:fs";import{dirname as hn,join as Z}from"node:path";import{getAgentDir as wn,parseFrontmatter as yn}from"@netrodev/hxf-coding-agent";var gt=["off","minimal","low","medium","high","xhigh","max"],bn=["name","description","tools","model","effort"],kn=["read","bash","edit","write","grep","find","ls","bash_output","kill_shell","todo","context","goal","task","workflow","web_search","web_fetch","lsp","quality","slop","claim","repo_map"],xn=["read","bash","edit","write","grep","find","ls","context","todo","web_search","web_fetch","lsp","claim"];function Sn(e){let s=(typeof e=="string"?e.split(","):Array.isArray(e)?e:[]).map(t=>String(t).trim().replace(/^["']|["']$/g,"")).filter(Boolean);return s.length>0?s:void 0}function _n(e){try{return gn(e).isDirectory()}catch{return!1}}function Tn(e){let o=e;for(;;){let s=Z(o,".howtofix","agents");if(_n(s))return s;let t=hn(o);if(t===o)return;o=t}}function $n(e){let o=[{scope:"user",dir:Z(wn(),"agents")}],s=Tn(e);return s&&o.push({scope:"project",dir:s}),o}function En(e,o){let s=[],t=[],n=e.replace(/^\uFEFF/,"");if(!/^---\r?\n/.test(n))return{notes:s,problems:[`${o}: no frontmatter \u2014 the file must start with --- and end the block with ---`]};let r={},a="";try{let m=yn(n);r=m.frontmatter??{},a=(m.body??"").trim()}catch(m){return{notes:s,problems:[`${o}: the frontmatter is not readable YAML \u2014 ${m instanceof Error?m.message:String(m)}`]}}for(let m of Object.keys(r))bn.includes(m)||s.push(`${o}: ignoring the unknown frontmatter key '${m}'`);let i=(o.split(/[\\/]/).pop()??o).replace(/\.md$/i,""),f=r.name,p=(typeof f=="string"&&f.trim()?f:i).trim();/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(p)||t.push(`${o}: '${p}' is not a usable agent name \u2014 letters, digits, dot, dash and underscore only`);let u=r.description,c=typeof u=="string"?u.trim():"";c||t.push(`${o}: a description is required \u2014 it is how the model decides to use this agent`),a||t.push(`${o}: no prompt body \u2014 the text below the frontmatter is the agent's standing instruction`);let d=r.effort,l=typeof d=="string"?d.trim().toLowerCase():"";l&&!gt.includes(l)&&t.push(`${o}: effort '${l}' is not one of ${gt.join(", ")}`);let g=Sn(r.tools),b=g??[...xn];if(g){let m=g.filter(_=>!kn.includes(_)&&!_.startsWith("mcp__"));m.length>0&&s.push(`${o}: unknown tool${m.length===1?"":"s"} ${m.join(", ")} \u2014 kept, but nothing registers them yet`)}let y=r.model,T=typeof y=="string"&&y.trim()?y.trim():void 0;return t.length>0?{notes:s,problems:t}:{def:{name:p,description:c,tools:b,prompt:a,effort:l||"medium",model:T,source:o},notes:s,problems:t}}function ht(e,o){let s=[],t=[],n=[],r=[];for(let{scope:a,dir:i}of $n(e)){let f;try{f=mn(i)}catch{continue}for(let p of f.filter(u=>u.toLowerCase().endsWith(".md")).sort()){let u=Z(i,p),c;try{c=fn(u,"utf8")}catch(g){n.push(`${u}: ${g instanceof Error?g.message:String(g)}`);continue}let d=En(c,u);t.push(...d.notes),n.push(...d.problems);let l=d.def;l&&(o.has(l.name)&&t.push(`${u}: replaces ${He.has(l.name)?"the built-in":"an earlier"} '${l.name}'`),o.set(l.name,l),s.push(l),r.includes(a)||r.push(a))}}if(s.length>0){let a=s.filter(i=>o.get(i.name)===i);t.unshift(`loaded ${a.length} subagent definition${a.length===1?"":"s"} (${r.join(" and ")}): ${a.map(i=>i.name).join(", ")}`)}return{loaded:s,notes:t,problems:n}}var An=["grep","find","ls","bash_output","kill_shell"];async function wt(e,{timeoutMs:o=2e3,quietTicks:s=2}={}){let t=Date.now()+o,n=e.getActiveToolNames().length,r=0;for(;Date.now()<t&&r<s;){await new Promise(i=>setTimeout(i,50));let a=e.getActiveToolNames().length;a>n?(n=a,r=0):r+=1}}function yt(e){let o=new Set(e.getActiveToolNames()),s=new Set(e.getAllTools().map(n=>n.name)),t=[];for(let n of An)s.has(n)&&!o.has(n)&&(o.add(n),t.push(n));return t.length>0&&e.setActiveToolsByName([...o]),t}import{spawnSync as vn}from"node:child_process";import{join as jn}from"node:path";import{defineTool as On}from"@netrodev/hxf-coding-agent";var Pn=6e3,bt=On({name:"slop",label:"slop",description:"Check code against the project's slop gate: naming, comments, placeholder values, swallowed errors, and the LLM tells that appear in model-written code. Read-only. Use it before reporting a task finished; it returns each finding as a rule id, a line, and what is wrong, so a claim of clean code becomes something the user can verify. Defaults to the changed files; pass a path to narrow it.",promptSnippet:"slop: naming, comment and placeholder findings for changed code",parameters:E.Object({path:E.Optional(E.String({description:"One file or directory, relative to the project root. Omit to scan the changed set."})),changes:E.Optional(E.Boolean({description:"Scan only files changed against the base ref. Default true when path is omitted."})),base:E.Optional(E.String({description:"Git ref for `changes`. Defaults to HEAD."}))}),async execute(e,o,s,t,n){let r=n.cwd??process.cwd(),i=[jn(r,"scripts","slop.mjs"),"--json"];o.path!==void 0?i.push(o.path):(o.changes??!0)&&i.push("--changes"),o.base!==void 0&&i.push("--base",o.base);let f=vn("node",i,{cwd:r,encoding:"utf8",timeout:12e4}),p;try{p=JSON.parse(f.stdout)}catch{p=void 0}if(!p){let b=(f.stderr||f.stdout||"").trim()||f.error?.message||(f.signal?`killed by ${f.signal} (timed out after 120 s?)`:"no output");return{content:[{type:"text",text:`slop gate produced no report: ${b.slice(0,400)}`}],details:{error:b.slice(0,400)}}}if(p.off)return{content:[{type:"text",text:"slop gate is off"}],details:{off:!0}};let u=p.files??{},c=[],d=0;for(let[b,y]of Object.entries(u)){c.push(`${b}`);for(let T of y)d+=1,c.push(`  ${T.rule}  L${T.line}  ${T.message}`)}if(d===0)return{content:[{type:"text",text:"slop gate: no findings in the scanned files"}],details:{files:Object.keys(u).length,findings:0}};let l=c.join(`
-`).slice(0,Pn),g=l.length<c.join(`
-`).length?`
-\u2026 truncated`:"";return{content:[{type:"text",text:`${d} finding${d===1?"":"s"}:
-
-${l}${g}`}],details:{files:Object.keys(u).length,findings:d}}}});function K(e){return e.extensionRunner.emit({type:"session_shutdown",reason:"quit"}).catch(()=>{}).finally(()=>e.dispose())}import{readdir as kt,rmdir as Rn,stat as Cn,unlink as Dn}from"node:fs/promises";import{dirname as Nn,join as X,resolve as xt}from"node:path";async function St(e={}){let o={removed:[],failed:[],removedDirs:[]},s=X(e.agentDir??k,"sessions"),t=(e.now??Date.now())-Ve*24*60*60*1e3,n=e.keep?xt(e.keep):void 0,r;try{r=await kt(s,{withFileTypes:!0})}catch{return o}for(let a of r){if(!a.isDirectory())continue;let i=X(s,a.name),f;try{f=await kt(i)}catch{continue}let p=f.filter(u=>!u.endsWith(".jsonl"));for(let u of f){if(!u.endsWith(".jsonl"))continue;let c=X(i,u),d;try{n&&xt(c)===n?d=!1:d=(await Cn(c)).mtimeMs<t}catch{d=!1}if(!d){p.push(u);continue}try{await Dn(c),o.removed.push(c)}catch{o.failed.push(c),p.push(u)}}if(p.length===0){if(n&&Nn(n)===i)continue;try{await Rn(i),o.removedDirs.push(i)}catch{}}}return o}var Y="howtofix.build",Ts=["read","repo_map","bash","edit","write","grep","find","ls","bash_output","kill_shell","task","think","ask","claim","sessions","todo","context","goal","enter_plan_mode","exit_plan_mode","workflow","web_search","web_fetch","lsp","quality","compress","slop"],Hn=()=>({exclude:process.platform==="win32"?[]:["powershell"]}),Tt=!1;async function $s(e){let o=new Un(k),s=Bn.create(e.cwd,k,{projectTrusted:o.get(e.cwd)===!0}),t=pe(k).compressToolOutput,n=e.sessionPath?B.open(e.sessionPath):e.noSession?B.inMemory(e.cwd):e.continueSession?B.continueRecent(e.cwd):B.create(e.cwd),r=(()=>{try{let S=n.getEntries().find(F=>F.type==="custom"&&F.customType===Y)?.data?.version;return!S||S===I?void 0:`this session was written by HowToFix ${S}; you are running ${I}`}catch{return}})(),a=new Gn({cwd:e.cwd,agentDir:k,settingsManager:s,appendSystemPrompt:Qe(V,e.interactive??!0),additionalSkillPaths:te(e.cwd),extensionFactories:[Ae(),re(),et(),tt(),Ne(),Pe(),ft(e.cwd),ut(),ve(),dt(),In(),st({enabled:()=>t}),Ln({loadConfig:h=>de({cwd:h.cwd,projectTrusted:h.isProjectTrusted?.()??!1})})]});await a.reload();let i=ht(e.cwd,U),f=mt(),p=n.getSessionId();ct(()=>e.cwd);let u=_t(k,fe);ye({root:()=>e.cwd,holder:()=>`session:${p}`,presenceDir:()=>u,selfId:()=>p});let c=()=>{try{me({dir:u},{id:p,cwd:e.cwd,host:Fn(),pid:process.pid,at:Date.now()})}catch{}};c();let d=setInterval(c,Math.max(5e3,Math.floor(ue/3)));d.unref?.();let l=await Mn({cwd:e.cwd,agentDir:k,settingsManager:s,sessionManager:n,resourceLoader:a,excludeTools:Hn().exclude,customTools:[f,lt,he,we,ke,be,xe,Se,Ee,je,Oe,Ye(),Fe,Me,Le,Ge,bt,Re({state:()=>Ce(W()??"dcp-sessionless"),messages:()=>De(W()??"dcp-sessionless")})],thinkingLevel:e.thinking});await l.session.bindExtensions({mode:"print",onError:()=>{}});let g=oe(k),b=[];if(g){let h=await se(k,g);h.renewed?await l.session.modelRuntime.setRuntimeApiKey("howtofix",h.credential.accessToken):(h.terminal&&h.message||h.message)&&b.push(h.message)}await wt(l.session),yt(l.session);let y=l.session.model;if(e.model){let h=await l.session.modelRuntime.getAvailable(),S=Ue(h,e.model);if(!S)throw await K(l.session),new Error(`unknown model '${e.model}'`);(y?.id!==S.id||y.provider!==S.provider)&&(await l.session.setModel(S),y=l.session.model)}else{let h=await l.session.modelRuntime.getAvailable(),S=new Map,F=[];for(let O of h){let R=S.get(O.provider);R===void 0&&(R=!!(await l.session.modelRuntime.getAuth(O.provider))?.auth?.apiKey,S.set(O.provider,R)),R&&F.push(O)}let H=ne;if(!H.includes(y?.provider??"")){let O=Be(F.filter(R=>H.includes(R.provider)),H);O&&(await l.session.setModel(O),y=l.session.model)}}if(!e.noSession&&n.getEntries().every(h=>h.type!=="custom"||h.customType!==Y))try{n.appendCustomEntry(Y,{version:I})}catch{}Tt||(Tt=!0,St({keep:l.session.sessionFile}).catch(()=>{}));let T=y?`${y.provider}/${y.id}`:"no model",m=!!(y&&y.cost&&(y.cost.input>0||y.cost.output>0)),_=[J(l.modelFallbackMessage),...b,...i.notes,...i.problems].filter(h=>!!h);return y||_.push(`no model configured. run \`howtofix\` and use /login, or edit ${_t(k,"models.json")}`),{session:l.session,dispose:async()=>{Ie(),await K(l.session),clearInterval(d),ge({dir:u},p)},modelLabel:T,priced:m,setCompressToolOutput:h=>{t=h},note:[r,..._].filter(Boolean).join(`
-`)||void 0}}export{Y as BUILD_ENTRY,Ts as MAIN_TOOLS,$s as openSession};

package/dist/chunk-AGGIYXN7.js

@@ -1,2 +0,0 @@
-function d(n,t){let e=`${n??""} ${t}`;if(/EACCES|EPERM/.test(e))return"the file or directory is not writable; check permissions and try again";if(/ENOENT/.test(e))return"a file or directory this command needs is missing";if(/ENOSPC/.test(e))return"the disk is full";if(/ECONNREFUSED|ENOTFOUND|EAI_AGAIN|ETIMEDOUT|UND_ERR|fetch failed/i.test(e))return"the network request failed; check the connection and the gateway address";if(/EADDRINUSE/.test(e))return"another process is already using that port";if(/MODULE_NOT_FOUND|ERR_MODULE_NOT_FOUND/.test(e))return"a required file or package is missing; reinstall HowToFix";if(/JSON/i.test(e)&&/parse|unexpected token|end of input/i.test(e))return"a configuration file is not valid JSON";if(/not a git repository/i.test(e))return"run the command inside a project, or pass --cwd"}function c(n){let e=(n instanceof Error?n.message:String(n)).trim()||"unknown error",i=n?.code;return{message:e,hint:d(i,e)}}function u(n,t,e,i=!1){let{message:r,hint:s}=c(e),o=[t?`${n}: ${t}: ${r}`:`${n}: ${r}`];return s&&o.push(`  ${s}`),i&&e instanceof Error&&e.stack&&o.push(e.stack),o.join(`
-`)}function f(n,t,e,i){let r=i?.debug??process.env.HOWTOFIX_DEBUG==="1";(i?.write??(a=>console.error(a)))(u(n,t,e,r))}export{c as a,f as b};