@botbotgo/agent-harness 0.0.474 → 0.0.476

package/dist/scaffold/init-project.js

@@ -1,70 +1,20 @@
-import path from "node:path";
-import { writeFile } from "node:fs/promises";
-import { AGENT_HARNESS_VERSION } from "../package-version.js";
-import { readBundledText, renderBundledTemplate } from "../utils/bundled-text.js";
-import { ensureDir, fileExists } from "../utils/fs.js";
-function toProjectSlug(projectName) {
-    const normalized = projectName
-        .trim()
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, "-")
-        .replace(/^-+|-+$/g, "");
-    return normalized || "agent-harness-app";
-}
-function toDisplayName(projectName) {
-    return projectName
-        .trim()
-        .split(/[-_\s]+/)
-        .filter(Boolean)
-        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
-        .join(" ");
-}
-function resolveOptions(options = {}) {
-    return {
-        template: options.template ?? "deep-research",
-        provider: options.provider?.trim() || "openai",
-        model: options.model?.trim() || "gpt-4o-mini",
-        withWebSearch: options.withWebSearch ?? true,
-    };
-}
-function renderPackageJson(projectSlug, template) {
-    return `${JSON.stringify({
-        name: projectSlug,
-        version: "0.0.1",
-        private: true,
-        type: "module",
-        description: `Starter ${template} application generated by agent-harness init.`,
-        scripts: {
-            start: "node ./src/run.mjs",
-        },
-        dependencies: {
-            "@botbotgo/agent-harness": `^${AGENT_HARNESS_VERSION}`,
-        },
-    }, null, 2)}\n`;
-}
-function renderReadme(displayName, projectSlug, options) {
-    const webSearchLine = options.withWebSearch
-        ? `- ${options.provider} native web search enabled through \`config/catalogs/tools.yaml\``
-        : "- no provider-native web search by default";
-    const providerEnvLine = options.provider === "openai" ? "export OPENAI_API_KEY=your_key_here\n" : "";
-    const templateLine = options.template === "deep-research"
-        ? "- a host research agent plus an analyst subagent"
-        : "- a single host research agent for direct iteration";
-    return `# ${displayName}
-
-This project was scaffolded with \`agent-harness init ${projectSlug}\`.
-
-It is a minimal ${options.template} workspace with:
-
-${templateLine}
-${webSearchLine}
+import d from"node:path";import{writeFile as h}from"node:fs/promises";import{AGENT_HARNESS_VERSION as g}from"../package-version.js";import{readBundledText as c,renderBundledTemplate as f}from"../utils/bundled-text.js";import{ensureDir as u,fileExists as w}from"../utils/fs.js";function y(e){return e.trim().toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"")||"agent-harness-app"}function k(e){return e.trim().split(/[-_\s]+/).filter(Boolean).map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join(" ")}function b(e={}){return{template:e.template??"deep-research",provider:e.provider?.trim()||"openai",model:e.model?.trim()||"gpt-4o-mini",withWebSearch:e.withWebSearch??!0}}function v(e,t){return`${JSON.stringify({name:e,version:"0.0.1",private:!0,type:"module",description:`Starter ${t} application generated by agent-harness init.`,scripts:{start:"node ./src/run.mjs"},dependencies:{"@botbotgo/agent-harness":`^${g}`}},null,2)}
+`}function R(e,t,n){const r=n.withWebSearch?`- ${n.provider} native web search enabled through \`config/catalogs/tools.yaml\``:"- no provider-native web search by default",a=n.provider==="openai"?`export OPENAI_API_KEY=your_key_here
+`:"",o=n.template==="deep-research"?"- a host research agent plus an analyst subagent":"- a single host research agent for direct iteration";return`# ${e}
+
+This project was scaffolded with \`agent-harness init ${t}\`.
+
+It is a minimal ${n.template} workspace with:
+
+${o}
+${r}
 - one host agent that already carries the default behavior skills for inspection, safe edits, approvals, and clean completion
 
 ## Run
 
 \`\`\`bash
 npm install
-${providerEnvLine}npm run start -- "Research the latest model serving stack for agent products and summarize the tradeoffs."
+${a}npm run start -- "Research the latest model serving stack for agent products and summarize the tradeoffs."
 \`\`\`
 
 ## Fast first prompts
@@ -91,15 +41,9 @@ ${providerEnvLine}npm run start -- "Research the latest model serving stack for
 - add local \`tool({...})\` tools under \`resources/tools/\`
 - add product-specific skills under \`resources/skills/\`
 - edit the prompt files in \`config/prompts/\` to turn this into your own product
-`;
-}
-function renderGitignore() {
-    return `node_modules
+`}function x(){return`node_modules
 .agent
-`;
-}
-function renderWorkspaceYaml() {
-    return `apiVersion: agent-harness/v1alpha1
+`}function S(){return`apiVersion: agent-harness/v1alpha1
 kind: Runtime
 metadata:
   name: default
@@ -107,42 +51,15 @@ spec:
   applicationRoot: .
   dataRoot: ./.botbotgo
   profile: default
-`;
-}
-function resolveResearchHostPromptTemplate(options) {
-    return options.template === "deep-research"
-        ? (options.withWebSearch
-            ? "init-templates/prompts/research-host-deep-research-web-search.md"
-            : "init-templates/prompts/research-host-deep-research-basic.md")
-        : (options.withWebSearch
-            ? "init-templates/prompts/research-host-single-agent-web-search.md"
-            : "init-templates/prompts/research-host-single-agent-basic.md");
-}
-function resolveResearchAnalystPromptTemplate(options) {
-    return options.withWebSearch
-        ? "init-templates/prompts/research-analyst-web-search.md"
-        : "init-templates/prompts/research-analyst-basic.md";
-}
-function renderAgentContext(options) {
-    return renderBundledTemplate("init-templates/agent-context/deep-research.md", {
-        webSearchGuidance: options.withWebSearch
-            ? "- Favor recent, attributable sources when the request depends on current information."
-            : "- Favor clear internal reasoning and add search or local tools as your product needs evolve.",
-    });
-}
-function renderModelsYaml(options) {
-    return `apiVersion: agent-harness/v1alpha1
+`}function I(e){return e.template==="deep-research"?e.withWebSearch?"init-templates/prompts/research-host-deep-research-web-search.md":"init-templates/prompts/research-host-deep-research-basic.md":e.withWebSearch?"init-templates/prompts/research-host-single-agent-web-search.md":"init-templates/prompts/research-host-single-agent-basic.md"}function P(e){return e.withWebSearch?"init-templates/prompts/research-analyst-web-search.md":"init-templates/prompts/research-analyst-basic.md"}function M(e){return f("init-templates/agent-context/deep-research.md",{webSearchGuidance:e.withWebSearch?"- Favor recent, attributable sources when the request depends on current information.":"- Favor clear internal reasoning and add search or local tools as your product needs evolve."})}function q(e){return`apiVersion: agent-harness/v1alpha1
 kind: Models
 spec:
   - name: default
     kind: Model
-    provider: ${options.provider}
-    model: ${options.model}
+    provider: ${e.provider}
+    model: ${e.model}
     temperature: 0.2
-`;
-}
-function renderBackendsYaml() {
-    return `apiVersion: agent-harness/v1alpha1
+`}function j(){return`apiVersion: agent-harness/v1alpha1
 kind: Backends
 spec:
   - kind: Backend
@@ -155,10 +72,7 @@ spec:
     routes:
       /memories/:
         kind: StoreBackend
-`;
-}
-function renderRuntimeMemoryYaml(projectSlug) {
-    return `apiVersion: agent-harness/v1alpha1
+`}function A(e){return`apiVersion: agent-harness/v1alpha1
 kind: RuntimeMemory
 metadata:
   name: default
@@ -214,7 +128,7 @@ spec:
         - Use \`create\` for a newly introduced knowledge item, \`update\` for a revised active state of an existing knowledge item, and \`delete\` when the candidate says an existing knowledge item should no longer remain active.
         - If an existing relevant record already represents the same underlying knowledge item, reuse that record's \`knowledge_identity\` instead of inventing a new one.
         - Do not invent a second identity just because the new statement negates, revokes, deletes, or replaces the old wording. That is usually the same knowledge item with a different mutation operation.
-        - The stored \`content\` must be canonical knowledge text, not an assistant acknowledgement such as "已记住" or "I will remember".
+        - The stored \`content\` must be canonical knowledge text, not an assistant acknowledgement such as "\u5DF2\u8BB0\u4F4F" or "I will remember".
         - You may optionally include \`operationalRule\` when the knowledge is a durable user-approved rule, instruction, or recurring procedure. Do not use it for assistant-only workflow guidance inferred from one conversation. Treat it as structured metadata, not as the primary identity mechanism.
         - Prefer semantic/episodic/procedural kinds only.
         - Prefer scopes session/agent/workspace/user/project only.
@@ -246,13 +160,10 @@ spec:
   mem0:
     enabled: false
     apiKeyEnv: MEM0_API_KEY
-    appId: ${projectSlug}
+    appId: ${e}
     stateStorePath: knowledge/mem0-sync-state.json
     maxMessagesPerRequest: 200
-`;
-}
-function renderKnowledgeRuntimeYaml(projectSlug) {
-    return `apiVersion: agent-harness/v1alpha1
+`}function _(e){return`apiVersion: agent-harness/v1alpha1
 kind: KnowledgeRuntime
 metadata:
   name: default
@@ -293,7 +204,7 @@ spec:
         - Use \`create\` for a newly introduced knowledge item, \`update\` for a revised active state of an existing knowledge item, and \`delete\` when the candidate says an existing knowledge item should no longer remain active.
         - If an existing relevant record already represents the same underlying knowledge item, reuse that record's \`knowledge_identity\` instead of inventing a new one.
         - Do not invent a second identity just because the new statement negates, revokes, deletes, or replaces the old wording. That is usually the same knowledge item with a different mutation operation.
-        - The stored \`content\` must be canonical knowledge text, not an assistant acknowledgement such as "已记住" or "I will remember".
+        - The stored \`content\` must be canonical knowledge text, not an assistant acknowledgement such as "\u5DF2\u8BB0\u4F4F" or "I will remember".
         - You may optionally include \`operationalRule\` when the knowledge is a durable user-approved rule, instruction, or recurring procedure. Do not use it for assistant-only workflow guidance inferred from one conversation. Treat it as structured metadata, not as the primary identity mechanism.
         - Prefer semantic/episodic/procedural kinds only.
         - Prefer scopes session/agent/workspace/user/project only.
@@ -323,13 +234,10 @@ spec:
   mem0:
     enabled: false
     apiKeyEnv: MEM0_API_KEY
-    appId: ${projectSlug}
+    appId: ${e}
     stateStorePath: knowledge/mem0-sync-state.json
     maxMessagesPerRequest: 200
-`;
-}
-function renderProceduralMemoryRuntimeYaml() {
-    return `apiVersion: agent-harness/v1alpha1
+`}function T(){return`apiVersion: agent-harness/v1alpha1
 kind: ProceduralMemoryRuntime
 metadata:
   name: default
@@ -392,32 +300,27 @@ spec:
     pruning:
       minScore: 0.2
       minFrequency: 2
-`;
-}
-function renderToolsYaml(options) {
-    if (!options.withWebSearch) {
-        return `apiVersion: agent-harness/v1alpha1
-kind: ToolSets
-spec: []
-`;
-    }
-    return `apiVersion: agent-harness/v1alpha1
+`}function D(e){return e.withWebSearch?`apiVersion: agent-harness/v1alpha1
 kind: ToolSets
 spec:
   - name: web-search
     type: provider
     description: Use this when the runtime needs current web discovery for research tasks. Do not use this as a substitute for synthesis or comparison.
     providerTool:
-      provider: ${options.provider}
+      provider: ${e.provider}
       tool: webSearch
       args:
         searchContextSize: medium
-`;
-}
-function renderResearchAgentYaml(options) {
-    const toolsBlock = options.withWebSearch ? "  tools:\n    - web-search\n" : "  tools: []\n";
-    const subagentsBlock = options.template === "deep-research" ? "  subagents:\n    - research-analyst\n" : "  subagents: []\n";
-    return `apiVersion: agent-harness/v1alpha1
+`:`apiVersion: agent-harness/v1alpha1
+kind: ToolSets
+spec: []
+`}function $(e){const t=e.withWebSearch?`  tools:
+    - web-search
+`:`  tools: []
+`,n=e.template==="deep-research"?`  subagents:
+    - research-analyst
+`:`  subagents: []
+`;return`apiVersion: agent-harness/v1alpha1
 kind: Agent
 metadata:
   name: research
@@ -428,22 +331,18 @@ spec:
     proceduralMemory: default
   backend: deepagent
   modelRef: model/default
-${toolsBlock}  skills:
+${t}  skills:
     - workspace-inspection
     - safe-editing
     - delegation-discipline
     - approval-execution-policy
     - completion-discipline
     - deep-research
-${subagentsBlock}  config:
+${n}  config:
     backend: default
   systemPrompt:
     path: ../prompts/research-system.md
-`;
-}
-function renderResearchAnalystYaml(options) {
-    const toolsBlock = options.withWebSearch ? "  tools:\n    - web-search\n" : "  tools: []\n";
-    return `apiVersion: agent-harness/v1alpha1
+`}function E(e){return`apiVersion: agent-harness/v1alpha1
 kind: Agent
 metadata:
   name: research-analyst
@@ -454,7 +353,10 @@ spec:
     proceduralMemory: default
   backend: deepagent
   modelRef: model/default
-${toolsBlock}  skills:
+${e.withWebSearch?`  tools:
+    - web-search
+`:`  tools: []
+`}  skills:
     - workspace-inspection
     - approval-execution-policy
     - completion-discipline
@@ -463,22 +365,8 @@ ${toolsBlock}  skills:
     backend: default
   systemPrompt:
     path: ../prompts/research-analyst-system.md
-`;
-}
-function renderResourcePackageJson(projectSlug) {
-    return `${JSON.stringify({
-        name: `${projectSlug}-resources`,
-        version: "0.0.1",
-        private: true,
-        type: "module",
-        description: "Resource package for a generated agent-harness project.",
-    }, null, 2)}\n`;
-}
-function renderSkill(options) {
-    const stepTwo = options.withWebSearch
-        ? "2. Use `web-search` to collect recent primary or otherwise authoritative sources."
-        : "2. Collect the key facts and assumptions needed to answer the request cleanly.";
-    return `---
+`}function C(e){return`${JSON.stringify({name:`${e}-resources`,version:"0.0.1",private:!0,type:"module",description:"Resource package for a generated agent-harness project."},null,2)}
+`}function K(e){return`---
 name: deep-research
 description: Default research workflow for product investigations that need careful synthesis.
 ---
@@ -490,7 +378,7 @@ Use this skill when the user wants comparisons, source-backed analysis, or a con
 ## Workflow
 
 1. Clarify the target question and what "done" looks like.
-${stepTwo}
+${e.withWebSearch?"2. Use `web-search` to collect recent primary or otherwise authoritative sources.":"2. Collect the key facts and assumptions needed to answer the request cleanly."}
 3. Compare evidence instead of trusting a single source.
 4. Separate verified facts from inference.
 5. End with a concise synthesis, explicit caveats, and source links when available.
@@ -500,11 +388,7 @@ ${stepTwo}
 - Do not rely on one source when the question requires comparison.
 - Do not present inference as a verified fact.
 - If current information is required, prefer fresh sources over model memory.
-`;
-}
-function renderStarterSkill(name) {
-    if (name === "workspace-inspection") {
-        return `---
+`}function s(e){return e==="workspace-inspection"?`---
 name: workspace-inspection
 description: Inspect the current workspace before making claims or edits.
 ---
@@ -515,10 +399,7 @@ description: Inspect the current workspace before making claims or edits.
 2. Read only the files needed to establish the relevant facts.
 3. Ground each conclusion in inspected workspace evidence instead of guesses.
 4. If the workspace does not contain the needed evidence, say that plainly before proposing a next step.
-`;
-    }
-    if (name === "safe-editing") {
-        return `---
+`:e==="safe-editing"?`---
 name: safe-editing
 description: Make the smallest workspace change that solves the task, then verify it.
 ---
@@ -529,10 +410,7 @@ description: Make the smallest workspace change that solves the task, then verif
 2. Prefer bounded edits over large rewrites.
 3. Keep local conventions intact.
 4. Run the smallest reasonable verification step before you finish.
-`;
-    }
-    if (name === "delegation-discipline") {
-        return `---
+`:e==="delegation-discipline"?`---
 name: delegation-discipline
 description: Delegate only when a subagent is clearly the best fit and the handoff can be bounded cleanly.
 ---
@@ -542,10 +420,7 @@ description: Delegate only when a subagent is clearly the best fit and the hando
 1. Keep the next critical-path step local unless a subagent is clearly better.
 2. Delegate only with one bounded ask and a clear purpose.
 3. Integrate delegated results into one final answer instead of forwarding raw output.
-`;
-    }
-    if (name === "approval-execution-policy") {
-        return `---
+`:e==="approval-execution-policy"?`---
 name: approval-execution-policy
 description: Treat side effects, command execution, and external actions as governed runtime decisions.
 ---
@@ -555,9 +430,7 @@ description: Treat side effects, command execution, and external actions as gove
 1. Inspect first when the safest next step is still unclear.
 2. Request approval before destructive, external, privileged, or ambiguous actions.
 3. After approval, execute only the action that was approved and report the outcome plainly.
-`;
-    }
-    return `---
+`:`---
 name: completion-discipline
 description: Finish the task cleanly, verify what you can, and leave the user with a clear outcome.
 ---
@@ -568,13 +441,7 @@ description: Finish the task cleanly, verify what you can, and leave the user wi
 2. Verify the changed or inspected area with the smallest relevant check.
 3. Distinguish completed work, unverified areas, and blocked follow-up.
 4. Return a concise final answer that makes the outcome easy to trust.
-`;
-}
-function renderRunScript(options) {
-    const defaultInput = options.withWebSearch
-        ? "Research the latest model and tooling trends for AI product teams. Return a concise brief with sources and caveats."
-        : "Analyze the current architecture direction for this product and return a concise brief with assumptions and caveats.";
-    return `import { fileURLToPath } from "node:url";
+`}function L(e){const t=e.withWebSearch?"Research the latest model and tooling trends for AI product teams. Return a concise brief with sources and caveats.":"Analyze the current architecture direction for this product and return a concise brief with assumptions and caveats.";return`import { fileURLToPath } from "node:url";
 import { createAgentHarness, request, stop } from "@botbotgo/agent-harness";
 
 const appRoot = fileURLToPath(new URL("..", import.meta.url));
@@ -597,7 +464,7 @@ for (let index = 0; index < args.length; index += 1) {
 }
 
 const input = inputParts.join(" ").trim() ||
-  ${JSON.stringify(defaultInput)};
+  ${JSON.stringify(t)};
 
 const runtime = await createAgentHarness(appRoot);
 
@@ -610,50 +477,4 @@ try {
 } finally {
   await stop(runtime);
 }
-`;
-}
-export async function initProject(projectRoot, projectName, options = {}) {
-    if (await fileExists(projectRoot)) {
-        throw new Error(`Target path already exists: ${projectRoot}`);
-    }
-    const resolved = resolveOptions(options);
-    const projectSlug = toProjectSlug(projectName);
-    const displayName = toDisplayName(projectName) || "Agent Harness App";
-    const files = new Map([
-        ["package.json", renderPackageJson(projectSlug, resolved.template)],
-        [".gitignore", renderGitignore()],
-        ["README.md", renderReadme(displayName, projectSlug, resolved)],
-        ["src/run.mjs", renderRunScript(resolved)],
-        ["config/runtime/workspace.yaml", renderWorkspaceYaml()],
-        ["config/agent-context.md", renderAgentContext(resolved)],
-        ["config/prompts/research-system.md", readBundledText(resolveResearchHostPromptTemplate(resolved)).trim()],
-        ["config/models.yaml", renderModelsYaml(resolved)],
-        ["config/knowledge/knowledge-runtime.yaml", renderKnowledgeRuntimeYaml(projectSlug)],
-        ["config/knowledge/procedural-memory-runtime.yaml", renderProceduralMemoryRuntimeYaml()],
-        ["config/runtime/runtime-memory.yaml", renderRuntimeMemoryYaml(projectSlug)],
-        ["config/catalogs/backends.yaml", renderBackendsYaml()],
-        ["config/catalogs/tools.yaml", renderToolsYaml(resolved)],
-        ["config/agents/research.yaml", renderResearchAgentYaml(resolved)],
-        ["resources/package.json", renderResourcePackageJson(projectSlug)],
-        ["resources/skills/deep-research/SKILL.md", renderSkill(resolved)],
-        ["resources/skills/workspace-inspection/SKILL.md", renderStarterSkill("workspace-inspection")],
-        ["resources/skills/safe-editing/SKILL.md", renderStarterSkill("safe-editing")],
-        ["resources/skills/delegation-discipline/SKILL.md", renderStarterSkill("delegation-discipline")],
-        ["resources/skills/approval-execution-policy/SKILL.md", renderStarterSkill("approval-execution-policy")],
-        ["resources/skills/completion-discipline/SKILL.md", renderStarterSkill("completion-discipline")],
-    ]);
-    if (resolved.template === "deep-research") {
-        files.set("config/prompts/research-analyst-system.md", readBundledText(resolveResearchAnalystPromptTemplate(resolved)).trim());
-        files.set("config/agents/research-analyst.yaml", renderResearchAnalystYaml(resolved));
-    }
-    await ensureDir(projectRoot);
-    for (const [relativePath, content] of files) {
-        const filePath = path.join(projectRoot, relativePath);
-        await ensureDir(path.dirname(filePath));
-        await writeFile(filePath, content, "utf8");
-    }
-    return {
-        projectRoot,
-        projectSlug,
-    };
-}
+`}async function B(e,t,n={}){if(await w(e))throw new Error(`Target path already exists: ${e}`);const r=b(n),a=y(t),o=k(t)||"Agent Harness App",i=new Map([["package.json",v(a,r.template)],[".gitignore",x()],["README.md",R(o,a,r)],["src/run.mjs",L(r)],["config/runtime/workspace.yaml",S()],["config/agent-context.md",M(r)],["config/prompts/research-system.md",c(I(r)).trim()],["config/models.yaml",q(r)],["config/knowledge/knowledge-runtime.yaml",_(a)],["config/knowledge/procedural-memory-runtime.yaml",T()],["config/runtime/runtime-memory.yaml",A(a)],["config/catalogs/backends.yaml",j()],["config/catalogs/tools.yaml",D(r)],["config/agents/research.yaml",$(r)],["resources/package.json",C(a)],["resources/skills/deep-research/SKILL.md",K(r)],["resources/skills/workspace-inspection/SKILL.md",s("workspace-inspection")],["resources/skills/safe-editing/SKILL.md",s("safe-editing")],["resources/skills/delegation-discipline/SKILL.md",s("delegation-discipline")],["resources/skills/approval-execution-policy/SKILL.md",s("approval-execution-policy")],["resources/skills/completion-discipline/SKILL.md",s("completion-discipline")]]);r.template==="deep-research"&&(i.set("config/prompts/research-analyst-system.md",c(P(r)).trim()),i.set("config/agents/research-analyst.yaml",E(r))),await u(e);for(const[p,m]of i){const l=d.join(e,p);await u(d.dirname(l)),await h(l,m,"utf8")}return{projectRoot:e,projectSlug:a}}export{B as initProject};