@botbotgo/agent-harness 0.0.99 → 0.0.101

package/dist/config/workflows/runtime-profiles.yaml

@@ -1,94 +0,0 @@
-# agent-harness feature: schema version for this declarative config object.
-apiVersion: agent-harness/v1alpha1
-# agent-harness feature: catalog of reusable runtime entry profiles layered on workflow resources.
-kind: RuntimeProfiles
-spec:
-  - id: coding-runtime
-    workflowRef: langgraph-workflow/coding-loop
-    defaults:
-      approvalPolicy: safe-default
-      memoryPolicy: project-facts-only
-      directAnswerFirst: false
-      watchGithubActionsAfterPush: true
-      allowPushToMaster: false
-      closeGithubIssueOnSuccess: false
-    requiredAgents:
-      - coderAgent
-    optionalAgents:
-      - verifierAgent
-  - id: personal-assistant
-    workflowRef: langgraph-workflow/assistant-loop
-    defaults:
-      approvalPolicy: human-before-side-effects
-      memoryPolicy: user-preferences-and-routines
-      directAnswerFirst: true
-      persistDurableMemory: true
-    optionalAgents:
-      - defaultResearchAgent
-      - defaultWritingAgent
-      - defaultSchedulingAgent
-      - defaultWorkerAgent
-  - id: research-runtime
-    workflowRef: langgraph-workflow/research-loop
-    defaults:
-      approvalPolicy: minimal
-      memoryPolicy: report-summary-only
-      requireSourceGrounding: true
-      requireCoverageReview: true
-    requiredAgents:
-      - gathererAgent
-      - analystAgent
-    optionalAgents:
-      - synthesizerAgent
-  - id: approval-review-runtime
-    workflowRef: langgraph-workflow/approval-review-loop
-    defaults:
-      approvalPolicy: always-required
-      memoryPolicy: none
-      executeAfterApproval: true
-      auditTrail: full
-    requiredAgents:
-      - preparerAgent
-    optionalAgents:
-      - reviewerAgent
-  - id: claw-style-assistant
-    workflowRef: langgraph-workflow/assistant-loop
-    defaults:
-      approvalPolicy: human-before-side-effects
-      memoryPolicy: user-preferences-and-stable-context
-      channelFirst: true
-      attachmentAware: true
-      sessionMemory: thread-scoped
-    optionalAgents:
-      - defaultWorkerAgent
-  - id: chat-operator
-    workflowRef: langgraph-workflow/chat-router-loop
-    defaults:
-      approvalPolicy: route-dependent
-      memoryPolicy: thread-only
-      directAnswerFirst: true
-    optionalAgents:
-      - codingAgent
-      - researchAgent
-      - assistantAgent
-      - approvalAgent
-  - id: copilot-sidecar
-    workflowRef: langgraph-workflow/coding-lite-loop
-    defaults:
-      approvalPolicy: no-push
-      memoryPolicy: repo-context-only
-      directAnswerFirst: false
-      allowRepositoryEdits: true
-      allowPushToMaster: false
-      runIntegrationVerification: false
-    requiredAgents:
-      - coderAgent
-  - id: task-delegation-hub
-    workflowRef: langgraph-workflow/delegation-loop
-    defaults:
-      approvalPolicy: worker-dependent
-      memoryPolicy: task-summary-only
-      routingStrategy: planner-first
-      reviewerEnabled: true
-    optionalAgents:
-      - defaultWorkerFallback

package/dist/runtime/adapter/langgraph/presets.d.ts

@@ -1,25 +0,0 @@
-type LangGraphPresetNode = {
-    id: string;
-    kind: string;
-    prompt?: string;
-    role?: string;
-    agent?: string;
-    tool?: string;
-};
-type LangGraphPresetEdge = {
-    from: string;
-    to: string;
-    when?: string;
-};
-export type LangGraphPresetWorkflow = {
-    entryNode: string;
-    nodes: LangGraphPresetNode[];
-    edges: LangGraphPresetEdge[];
-};
-export type LangGraphPresetName = "react" | "prompt-chaining" | "routing" | "parallelization" | "plan-execute" | "review-loop" | "evaluator-optimizer" | "approval-gate" | "handoff" | "orchestrator-workers";
-type LangGraphPresetOptions = {
-    agent?: string;
-};
-export declare const SUPPORTED_LANGGRAPH_PRESETS: LangGraphPresetName[];
-export declare function resolveLangGraphPresetWorkflow(presetName: string | undefined, options?: LangGraphPresetOptions): LangGraphPresetWorkflow | undefined;
-export {};

package/dist/runtime/adapter/langgraph/presets.js

@@ -1,165 +0,0 @@
-const DEFAULT_PLANNER_PROMPT = "You are the workflow planner. Produce a concise execution plan for the user request before execution starts.";
-const DEFAULT_REVIEWER_PROMPT = "Review the current result, call out missing verification or obvious gaps, and state whether the work looks sufficient.";
-const DEFAULT_REPLANNER_PROMPT = "Refine the plan based on the reviewer feedback and current result. Return only the updated plan.";
-const DEFAULT_FINALIZER_PROMPT = "Rewrite the current result into a concise user-facing final answer. Preserve facts and caveats.";
-export const SUPPORTED_LANGGRAPH_PRESETS = [
-    "react",
-    "prompt-chaining",
-    "routing",
-    "parallelization",
-    "plan-execute",
-    "review-loop",
-    "evaluator-optimizer",
-    "approval-gate",
-    "handoff",
-    "orchestrator-workers",
-];
-function requireAgent(preset, options) {
-    if (typeof options.agent === "string" && options.agent.trim()) {
-        return options.agent.trim();
-    }
-    throw new Error(`LangGraph preset ${preset} requires config.agent`);
-}
-export function resolveLangGraphPresetWorkflow(presetName, options = {}) {
-    switch (presetName) {
-        case undefined:
-        case "":
-            return undefined;
-        case "react":
-            return {
-                entryNode: "step1",
-                nodes: [
-                    { id: "step1", kind: "agent" },
-                ],
-                edges: [],
-            };
-        case "prompt-chaining":
-        case "plan-execute":
-            return {
-                entryNode: "step1",
-                nodes: [
-                    { id: "step1", kind: "llm", role: "planner", prompt: DEFAULT_PLANNER_PROMPT },
-                    { id: "step2", kind: "agent" },
-                    { id: "step3", kind: "llm", role: "finalizer", prompt: DEFAULT_FINALIZER_PROMPT },
-                ],
-                edges: [
-                    { from: "step1", to: "step2" },
-                    { from: "step2", to: "step3", when: "has_result" },
-                ],
-            };
-        case "routing": {
-            const agent = requireAgent("routing", options);
-            return {
-                entryNode: "step1",
-                nodes: [
-                    { id: "step1", kind: "llm", role: "planner", prompt: DEFAULT_PLANNER_PROMPT },
-                    { id: "step2", kind: "agent", agent },
-                    { id: "step3", kind: "llm", role: "finalizer", prompt: DEFAULT_FINALIZER_PROMPT },
-                ],
-                edges: [
-                    { from: "step1", to: "step2" },
-                    { from: "step2", to: "step3", when: "has_result" },
-                ],
-            };
-        }
-        case "parallelization": {
-            const agent = requireAgent("parallelization", options);
-            return {
-                entryNode: "step1",
-                nodes: [
-                    { id: "step1", kind: "llm", role: "planner", prompt: DEFAULT_PLANNER_PROMPT },
-                    { id: "step2", kind: "agent", agent },
-                    { id: "step3", kind: "llm", role: "reviewer", prompt: DEFAULT_REVIEWER_PROMPT },
-                    { id: "step4", kind: "llm", role: "finalizer", prompt: DEFAULT_FINALIZER_PROMPT },
-                ],
-                edges: [
-                    { from: "step1", to: "step2" },
-                    { from: "step2", to: "step3", when: "has_result" },
-                    { from: "step3", to: "step4", when: "review_ok" },
-                ],
-            };
-        }
-        case "review-loop":
-            return {
-                entryNode: "step1",
-                nodes: [
-                    { id: "step1", kind: "llm", role: "planner", prompt: DEFAULT_PLANNER_PROMPT },
-                    { id: "step2", kind: "agent" },
-                    { id: "step3", kind: "llm", role: "reviewer", prompt: DEFAULT_REVIEWER_PROMPT },
-                    { id: "step4", kind: "llm", role: "replanner", prompt: DEFAULT_REPLANNER_PROMPT },
-                    { id: "step5", kind: "llm", role: "finalizer", prompt: DEFAULT_FINALIZER_PROMPT },
-                ],
-                edges: [
-                    { from: "step1", to: "step2" },
-                    { from: "step2", to: "step3", when: "has_result" },
-                    { from: "step3", to: "step5", when: "review_ok" },
-                    { from: "step3", to: "step4", when: "review_incomplete" },
-                    { from: "step4", to: "step2", when: "has_plan" },
-                ],
-            };
-        case "evaluator-optimizer":
-            return {
-                entryNode: "step1",
-                nodes: [
-                    { id: "step1", kind: "agent" },
-                    { id: "step2", kind: "llm", role: "reviewer", prompt: DEFAULT_REVIEWER_PROMPT },
-                    { id: "step3", kind: "llm", role: "replanner", prompt: DEFAULT_REPLANNER_PROMPT },
-                    { id: "step4", kind: "llm", role: "finalizer", prompt: DEFAULT_FINALIZER_PROMPT },
-                ],
-                edges: [
-                    { from: "step1", to: "step2", when: "has_result" },
-                    { from: "step2", to: "step4", when: "review_ok" },
-                    { from: "step2", to: "step3", when: "review_incomplete" },
-                    { from: "step3", to: "step1", when: "has_plan" },
-                ],
-            };
-        case "approval-gate":
-            return {
-                entryNode: "step1",
-                nodes: [
-                    { id: "step1", kind: "llm", role: "planner", prompt: DEFAULT_PLANNER_PROMPT },
-                    { id: "step2", kind: "approval" },
-                    { id: "step3", kind: "agent" },
-                    { id: "step4", kind: "llm", role: "finalizer", prompt: DEFAULT_FINALIZER_PROMPT },
-                ],
-                edges: [
-                    { from: "step1", to: "step2" },
-                    { from: "step2", to: "step3", when: "approval_approved" },
-                    { from: "step2", to: "step3", when: "approval_edited" },
-                    { from: "step3", to: "step4", when: "has_result" },
-                ],
-            };
-        case "handoff": {
-            const agent = requireAgent("handoff", options);
-            return {
-                entryNode: "step1",
-                nodes: [
-                    { id: "step1", kind: "agent", agent },
-                    { id: "step2", kind: "llm", role: "finalizer", prompt: DEFAULT_FINALIZER_PROMPT },
-                ],
-                edges: [
-                    { from: "step1", to: "step2", when: "has_result" },
-                ],
-            };
-        }
-        case "orchestrator-workers": {
-            const agent = requireAgent("orchestrator-workers", options);
-            return {
-                entryNode: "step1",
-                nodes: [
-                    { id: "step1", kind: "llm", role: "planner", prompt: DEFAULT_PLANNER_PROMPT },
-                    { id: "step2", kind: "agent", agent },
-                    { id: "step3", kind: "llm", role: "reviewer", prompt: DEFAULT_REVIEWER_PROMPT },
-                    { id: "step4", kind: "llm", role: "finalizer", prompt: DEFAULT_FINALIZER_PROMPT },
-                ],
-                edges: [
-                    { from: "step1", to: "step2" },
-                    { from: "step2", to: "step3", when: "has_result" },
-                    { from: "step3", to: "step4", when: "review_ok" },
-                ],
-            };
-        }
-        default:
-            throw new Error(`Unsupported LangGraph preset ${String(presetName)}. Supported presets: ${SUPPORTED_LANGGRAPH_PRESETS.join(", ")}`);
-    }
-}

package/dist/runtime/adapter/langgraph/profiles.d.ts

@@ -1,6 +0,0 @@
-import type { LangGraphPresetWorkflow } from "./presets.js";
-export type LangGraphProfileName = "coding-runtime" | "personal-assistant" | "research-runtime" | "approval-review-runtime" | "claw-style-assistant" | "chat-operator" | "copilot-sidecar" | "task-delegation-hub";
-type LangGraphProfileOptions = Record<string, unknown>;
-export declare const SUPPORTED_LANGGRAPH_PROFILES: LangGraphProfileName[];
-export declare function resolveLangGraphProfileWorkflow(profileName: string | undefined, options?: LangGraphProfileOptions): LangGraphPresetWorkflow | undefined;
-export {};

package/dist/runtime/adapter/langgraph/profiles.js

@@ -1,206 +0,0 @@
-const DEFAULT_PLANNER_PROMPT = "You are the workflow planner. Produce a concise execution plan for the user request before execution starts.";
-const DEFAULT_REVIEWER_PROMPT = "Review the current result, call out missing verification or obvious gaps, and state whether the work looks sufficient.";
-const DEFAULT_FINALIZER_PROMPT = "Rewrite the current result into a concise user-facing final answer. Preserve facts and caveats.";
-const DEFAULT_REPLANNER_PROMPT = "Refine the plan based on the reviewer feedback and current result. Return only the updated plan.";
-export const SUPPORTED_LANGGRAPH_PROFILES = [
-    "coding-runtime",
-    "personal-assistant",
-    "research-runtime",
-    "approval-review-runtime",
-    "claw-style-assistant",
-    "chat-operator",
-    "copilot-sidecar",
-    "task-delegation-hub",
-];
-function readStringOption(options, key) {
-    const value = options[key];
-    return typeof value === "string" && value.trim() ? value.trim() : undefined;
-}
-function requireAgentOption(profile, options, key) {
-    const value = readStringOption(options, key);
-    if (value) {
-        return value;
-    }
-    throw new Error(`LangGraph profile ${profile} requires with.${key}`);
-}
-function buildCodingRuntimeWorkflow(options) {
-    const coderAgent = requireAgentOption("coding-runtime", options, "coderAgent");
-    const verifierAgent = readStringOption(options, "verifierAgent");
-    const needsVerification = Boolean(verifierAgent) || options.runIntegrationVerification === true;
-    return {
-        entryNode: "step1",
-        nodes: [
-            { id: "step1", kind: "llm", role: "planner", prompt: DEFAULT_PLANNER_PROMPT },
-            { id: "step2", kind: "agent", agent: coderAgent },
-            { id: "step3", kind: "llm", role: "reviewer", prompt: DEFAULT_REVIEWER_PROMPT },
-            { id: "step4", kind: "llm", role: "replanner", prompt: DEFAULT_REPLANNER_PROMPT },
-            ...(needsVerification
-                ? [{ id: "step5", kind: "approval" }, { id: "step6", kind: "agent", agent: verifierAgent ?? coderAgent }]
-                : []),
-            { id: "step7", kind: "llm", role: "finalizer", prompt: DEFAULT_FINALIZER_PROMPT },
-        ],
-        edges: [
-            { from: "step1", to: "step2" },
-            { from: "step2", to: "step3", when: "has_result" },
-            { from: "step3", to: needsVerification ? "step5" : "step7", when: "review_ok" },
-            { from: "step3", to: "step4", when: "review_incomplete" },
-            { from: "step4", to: "step2", when: "has_plan" },
-            ...(needsVerification
-                ? [
-                    { from: "step5", to: "step6", when: "approval_approved" },
-                    { from: "step5", to: "step6", when: "approval_edited" },
-                    { from: "step6", to: "step7", when: "has_result" },
-                ]
-                : []),
-        ],
-    };
-}
-function buildAssistantWorkflow(options) {
-    const worker = readStringOption(options, "defaultWorkerAgent") ??
-        readStringOption(options, "defaultResearchAgent") ??
-        readStringOption(options, "defaultWritingAgent") ??
-        readStringOption(options, "defaultSchedulingAgent");
-    return {
-        entryNode: "step1",
-        nodes: [
-            { id: "step1", kind: "llm", role: "planner", prompt: DEFAULT_PLANNER_PROMPT },
-            ...(worker ? [{ id: "step2", kind: "agent", agent: worker }] : [{ id: "step2", kind: "tool", tool: "repo_inventory" }]),
-            { id: "step3", kind: "llm", role: "reviewer", prompt: DEFAULT_REVIEWER_PROMPT },
-            { id: "step4", kind: "approval" },
-            { id: "step5", kind: "llm", role: "finalizer", prompt: DEFAULT_FINALIZER_PROMPT },
-        ],
-        edges: [
-            { from: "step1", to: "step2" },
-            { from: "step2", to: "step3", when: "has_result" },
-            { from: "step3", to: "step4", when: "review_incomplete" },
-            { from: "step3", to: "step5", when: "review_ok" },
-            { from: "step4", to: "step5", when: "approval_approved" },
-            { from: "step4", to: "step5", when: "approval_edited" },
-        ],
-    };
-}
-function buildResearchWorkflow(options) {
-    const gathererAgent = requireAgentOption("research-runtime", options, "gathererAgent");
-    const analystAgent = requireAgentOption("research-runtime", options, "analystAgent");
-    const synthesizerAgent = readStringOption(options, "synthesizerAgent");
-    return {
-        entryNode: "step1",
-        nodes: [
-            { id: "step1", kind: "llm", role: "planner", prompt: DEFAULT_PLANNER_PROMPT },
-            { id: "step2", kind: "agent", agent: gathererAgent },
-            { id: "step3", kind: "llm", role: "reviewer", prompt: DEFAULT_REVIEWER_PROMPT },
-            { id: "step4", kind: "agent", agent: analystAgent },
-            ...(synthesizerAgent ? [{ id: "step5", kind: "agent", agent: synthesizerAgent }] : []),
-            { id: "step6", kind: "llm", role: "finalizer", prompt: DEFAULT_FINALIZER_PROMPT },
-        ],
-        edges: [
-            { from: "step1", to: "step2" },
-            { from: "step2", to: "step3", when: "has_result" },
-            { from: "step3", to: "step4", when: "review_ok" },
-            { from: "step3", to: "step2", when: "review_incomplete" },
-            { from: "step4", to: synthesizerAgent ? "step5" : "step6", when: "has_result" },
-            ...(synthesizerAgent ? [{ from: "step5", to: "step6", when: "has_result" }] : []),
-        ],
-    };
-}
-function buildApprovalReviewWorkflow(options) {
-    const preparerAgent = requireAgentOption("approval-review-runtime", options, "preparerAgent");
-    const reviewerAgent = readStringOption(options, "reviewerAgent");
-    return {
-        entryNode: "step1",
-        nodes: [
-            { id: "step1", kind: "llm", role: "planner", prompt: DEFAULT_PLANNER_PROMPT },
-            { id: "step2", kind: "agent", agent: preparerAgent },
-            ...(reviewerAgent ? [{ id: "step3", kind: "agent", agent: reviewerAgent }] : [{ id: "step3", kind: "llm", role: "reviewer", prompt: DEFAULT_REVIEWER_PROMPT }]),
-            { id: "step4", kind: "approval" },
-            { id: "step5", kind: "llm", role: "finalizer", prompt: DEFAULT_FINALIZER_PROMPT },
-        ],
-        edges: [
-            { from: "step1", to: "step2" },
-            { from: "step2", to: "step3", when: "has_result" },
-            { from: "step3", to: "step4", when: "has_result" },
-            { from: "step4", to: "step5", when: "approval_approved" },
-            { from: "step4", to: "step5", when: "approval_edited" },
-        ],
-    };
-}
-function buildChatOperatorWorkflow(options) {
-    const routedAgent = readStringOption(options, "assistantAgent") ??
-        readStringOption(options, "researchAgent") ??
-        readStringOption(options, "codingAgent") ??
-        readStringOption(options, "approvalAgent");
-    if (!routedAgent) {
-        throw new Error("LangGraph profile chat-operator requires at least one target agent in with.assistantAgent, with.researchAgent, with.codingAgent, or with.approvalAgent");
-    }
-    return {
-        entryNode: "step1",
-        nodes: [
-            { id: "step1", kind: "llm", role: "planner", prompt: DEFAULT_PLANNER_PROMPT },
-            { id: "step2", kind: "agent", agent: routedAgent },
-            { id: "step3", kind: "llm", role: "finalizer", prompt: DEFAULT_FINALIZER_PROMPT },
-        ],
-        edges: [
-            { from: "step1", to: "step2" },
-            { from: "step2", to: "step3", when: "has_result" },
-        ],
-    };
-}
-function buildCopilotSidecarWorkflow(options) {
-    const coderAgent = requireAgentOption("copilot-sidecar", options, "coderAgent");
-    return {
-        entryNode: "step1",
-        nodes: [
-            { id: "step1", kind: "llm", role: "planner", prompt: DEFAULT_PLANNER_PROMPT },
-            { id: "step2", kind: "agent", agent: coderAgent },
-            { id: "step3", kind: "llm", role: "finalizer", prompt: DEFAULT_FINALIZER_PROMPT },
-        ],
-        edges: [
-            { from: "step1", to: "step2" },
-            { from: "step2", to: "step3", when: "has_result" },
-        ],
-    };
-}
-function buildDelegationHubWorkflow(options) {
-    const workerAgent = readStringOption(options, "defaultWorkerFallback");
-    if (!workerAgent) {
-        throw new Error("LangGraph profile task-delegation-hub requires with.defaultWorkerFallback");
-    }
-    return {
-        entryNode: "step1",
-        nodes: [
-            { id: "step1", kind: "llm", role: "planner", prompt: DEFAULT_PLANNER_PROMPT },
-            { id: "step2", kind: "agent", agent: workerAgent },
-            { id: "step3", kind: "llm", role: "reviewer", prompt: DEFAULT_REVIEWER_PROMPT },
-            { id: "step4", kind: "llm", role: "finalizer", prompt: DEFAULT_FINALIZER_PROMPT },
-        ],
-        edges: [
-            { from: "step1", to: "step2" },
-            { from: "step2", to: "step3", when: "has_result" },
-            { from: "step3", to: "step4", when: "review_ok" },
-        ],
-    };
-}
-export function resolveLangGraphProfileWorkflow(profileName, options = {}) {
-    switch (profileName) {
-        case undefined:
-        case "":
-            return undefined;
-        case "coding-runtime":
-            return buildCodingRuntimeWorkflow(options);
-        case "personal-assistant":
-        case "claw-style-assistant":
-            return buildAssistantWorkflow(options);
-        case "research-runtime":
-            return buildResearchWorkflow(options);
-        case "approval-review-runtime":
-            return buildApprovalReviewWorkflow(options);
-        case "chat-operator":
-            return buildChatOperatorWorkflow(options);
-        case "copilot-sidecar":
-            return buildCopilotSidecarWorkflow(options);
-        case "task-delegation-hub":
-            return buildDelegationHubWorkflow(options);
-        default:
-            throw new Error(`Unsupported LangGraph profile ${String(profileName)}. Supported profiles: ${SUPPORTED_LANGGRAPH_PROFILES.join(", ")}`);
-    }
-}

package/dist/runtime/checkpoint-maintenance.d.ts

@@ -1 +0,0 @@
-export * from "./maintenance/checkpoint-maintenance.js";

package/dist/runtime/checkpoint-maintenance.js

@@ -1 +0,0 @@
-export * from "./maintenance/checkpoint-maintenance.js";

package/dist/runtime/file-checkpoint-saver.d.ts

@@ -1 +0,0 @@
-export * from "./maintenance/file-checkpoint-saver.js";

package/dist/runtime/file-checkpoint-saver.js

@@ -1 +0,0 @@
-export * from "./maintenance/file-checkpoint-saver.js";

package/dist/runtime/sqlite-maintained-checkpoint-saver.d.ts

@@ -1 +0,0 @@
-export * from "./maintenance/sqlite-maintained-checkpoint-saver.js";

package/dist/runtime/sqlite-maintained-checkpoint-saver.js

@@ -1 +0,0 @@
-export * from "./maintenance/sqlite-maintained-checkpoint-saver.js";