@engineeros/connector 0.16.0 → 0.17.0

package/src/agent-harness.mjs

@@ -1,264 +0,0 @@
-import { readFileSync } from "node:fs";
-
-const ROLE_BOUNDARIES = Object.freeze({
-  research: Object.freeze({
-    sandboxMode: "read-only",
-    skill: "codebase-research",
-  }),
-  planning: Object.freeze({
-    sandboxMode: "read-only",
-    skill: "change-planning",
-  }),
-  implementation: Object.freeze({
-    sandboxMode: "workspace-write",
-    skill: "goal-execution",
-  }),
-  verification: Object.freeze({
-    sandboxMode: "read-only",
-    skill: "change-verification",
-  }),
-});
-
-const skillCache = new Map();
-
-export const AGENT_ROLE_IDS = Object.freeze(Object.keys(ROLE_BOUNDARIES));
-export const AGENT_SKILL_IDS = Object.freeze(
-  AGENT_ROLE_IDS.map((roleId) => ROLE_BOUNDARIES[roleId].skill),
-);
-
-export function agentHarnessCapabilities() {
-  return {
-    agent_roles: [...AGENT_ROLE_IDS],
-    agent_skills: [...AGENT_SKILL_IDS],
-  };
-}
-
-export function buildAgentHarnessPrompt({
-  agentRole,
-  agentDefinition,
-  prompt,
-  sandboxMode,
-  requiredOutputHeading,
-}) {
-  const boundary = ROLE_BOUNDARIES[agentRole];
-  if (!boundary) {
-    throw new Error(
-      `EngineerOS assignment has an unsupported agent_role. Expected one of: ${AGENT_ROLE_IDS.join(", ")}.`,
-    );
-  }
-  if (boundary.sandboxMode !== sandboxMode) {
-    throw new Error(
-      `EngineerOS ${agentRole} role requires ${boundary.sandboxMode} access, but the assignment requested ${sandboxMode}.`,
-    );
-  }
-  const role = validatedAgentDefinition(agentDefinition, agentRole, boundary);
-  const assignment = String(prompt || "").trim();
-  if (!assignment) {
-    throw new Error("EngineerOS assignment is missing prompt_markdown.");
-  }
-  const outputHeading = normalizedOutputHeading(requiredOutputHeading);
-
-  const sections = [
-    "# EngineerOS Agent Assignment",
-    "",
-    "## Active Role",
-    "",
-    `- Role: ${role.title}`,
-    `- Access: ${role.access}`,
-    `- Responsibility: ${role.instruction}`,
-    `- Permitted tools: ${role.tools.length ? role.tools.join(", ") : "none"}`,
-    "- User-facing language: refer to yourself neutrally as the Agent. Do not expose internal role, harness, provider, or coding-agent terminology unless the user asks.",
-  ];
-  if (!outputHeading) {
-    sections.push(
-      "",
-      "## Interaction Contract",
-      "",
-      "- Infer the current project situation from the assignment and workspace evidence before responding.",
-      "- Lead with the useful answer or outcome. Do not narrate routine searches, tool calls, or internal work.",
-      "- When one next activity clearly follows and would help, offer exactly one short, concrete suggestion. Do not force a next step when none is useful.",
-      "- Ask a question only when a consequential choice cannot be resolved from available evidence.",
-      "- If the Assignment defines a response format, follow it exactly instead of adding conversational guidance.",
-    );
-  }
-  sections.push(
-    "",
-    "## Active Skill",
-    "",
-    bundledSkill(role.skill),
-    "",
-    "## Assignment",
-    "",
-    assignment,
-  );
-  if (outputHeading) {
-    sections.push(
-      "",
-      "## Final Response Contract",
-      "",
-      "- Return only the structured Markdown required by the Assignment.",
-      `- The first non-whitespace line must be exactly: ${outputHeading}`,
-      "- Do not add a preamble, status message, commentary, or code fence.",
-      "- Do not append a conversational summary or next activity.",
-    );
-  }
-  return sections.join("\n");
-}
-
-function validatedAgentDefinition(definition, agentRole, boundary) {
-  if (!definition || typeof definition !== "object") {
-    throw new Error("EngineerOS assignment is missing agent_definition.");
-  }
-  if (definition.role !== agentRole || definition.access !== boundary.sandboxMode) {
-    throw new Error("EngineerOS agent_definition does not match the assigned role and access.");
-  }
-  if (definition.skill !== boundary.skill) {
-    throw new Error(`EngineerOS ${agentRole} role requires the ${boundary.skill} skill.`);
-  }
-  if (
-    typeof definition.title !== "string" ||
-    !definition.title.trim() ||
-    typeof definition.instruction !== "string" ||
-    !definition.instruction.trim() ||
-    !Array.isArray(definition.tools)
-  ) {
-    throw new Error("EngineerOS agent_definition is incomplete.");
-  }
-  return definition;
-}
-
-export function normalizeAgentStructuredOutput(
-  response,
-  requiredOutputHeading,
-) {
-  const outputHeading = normalizedOutputHeading(requiredOutputHeading);
-  if (!outputHeading) {
-    throw new Error(
-      "EngineerOS structured output requires a heading contract.",
-    );
-  }
-  const content = String(response || "").trim();
-  if (!content) {
-    throw new Error("Agent completed without returning a response.");
-  }
-  const firstSection = {
-    "# Workspace Assessment": "## Executive Summary",
-    "# Workspace Assessment Delta": "## Updated Executive Summary",
-    "# Assessment Stage: Architecture": "## Architecture Summary",
-    "# Assessment Stage: Capability Catalog": "## Capability Catalog",
-    "# Assessment Stage: Capabilities": "## Observed Capabilities",
-    "# Assessment Stage: Quality": "## Quality Summary",
-    "# Assessment Stage: Synthesis": "## Executive Summary",
-  }[outputHeading];
-  if (
-    firstSection &&
-    (content.startsWith(firstSection) ||
-      hasRequiredAssessmentSections(content, outputHeading))
-  ) {
-    return `${outputHeading}\n\n${content}`;
-  }
-  const lines = content.split(/\r?\n/);
-  const headingIndex = lines.findIndex(
-    (line) => line.trim() === outputHeading,
-  );
-  const firstSectionIndex = firstSection
-    ? lines.findIndex((line) => line.trim() === firstSection)
-    : -1;
-  if (
-    headingIndex < 0 &&
-    outputHeading.startsWith("# Assessment Stage:") &&
-    firstSectionIndex >= 0
-  ) {
-    const preamble = lines.slice(0, firstSectionIndex).join("\n");
-    if (preamble.length > 2_000) {
-      throw new Error(
-        `Agent response contains too much text before the required section '${firstSection}'.`,
-      );
-    }
-    const normalized = lines.slice(firstSectionIndex).join("\n").trim();
-    if (/```/.test(preamble) || /(?:^|\n)```\s*$/.test(normalized)) {
-      throw new Error(
-        `Agent response must return '${outputHeading}' as plain Markdown, without a code fence.`,
-      );
-    }
-    return `${outputHeading}\n\n${normalized}`;
-  }
-  const preamble =
-    headingIndex >= 0 ? lines.slice(0, headingIndex).join("\n") : content;
-  if (headingIndex < 0) {
-    throw new Error(
-      `Agent response is missing the required heading '${outputHeading}'.`,
-    );
-  }
-  if (preamble.length > 2_000) {
-    throw new Error(
-      `Agent response contains too much text before the required heading '${outputHeading}'.`,
-    );
-  }
-  const normalized = lines.slice(headingIndex).join("\n").trim();
-  if (/```/.test(preamble) || /(?:^|\n)```\s*$/.test(normalized)) {
-    throw new Error(
-      `Agent response must return '${outputHeading}' as plain Markdown, without a code fence.`,
-    );
-  }
-  return normalized;
-}
-
-function hasRequiredAssessmentSections(content, outputHeading) {
-  const sections =
-    outputHeading === "# Workspace Assessment"
-      ? [
-          "## Executive Summary",
-          "## Assessment Delta",
-          "## Current System Map",
-          "## Observed Capabilities",
-          "## Findings",
-          "## Implementation Scorecard",
-          "## Highest-Return Actions",
-          "## Commands Observed",
-        ]
-      : [
-          "## Updated Executive Summary",
-          "## Assessment Delta",
-          "## Current System Map",
-          "## Capability Changes",
-          "## Finding Changes",
-          "## Scorecard Changes",
-          "## Highest-Return Actions",
-          "## Commands Observed",
-        ];
-  return sections.every((section) =>
-    new RegExp(`(?:^|\\n)${section.replace(/[.*+?^${}()|[\\]\\]/g, "\\$&")}\\s*$`, "m").test(
-      content,
-    ),
-  );
-}
-
-function bundledSkill(skillName) {
-  const cached = skillCache.get(skillName);
-  if (cached) return cached;
-  try {
-    const content = readFileSync(
-      new URL(`./skills/${skillName}/SKILL.md`, import.meta.url),
-      "utf8",
-    ).trim();
-    skillCache.set(skillName, content);
-    return content;
-  } catch (error) {
-    throw new Error(
-      `EngineerOS bundled skill '${skillName}' is unavailable. Reinstall @engineeros/connector.`,
-      { cause: error },
-    );
-  }
-}
-
-function normalizedOutputHeading(value) {
-  if (value === undefined || value === null) return null;
-  const heading = String(value).trim();
-  if (!/^# [^\r\n]+$/.test(heading)) {
-    throw new Error(
-      "EngineerOS requiredOutputHeading must be one level-one Markdown heading.",
-    );
-  }
-  return heading;
-}