@agntk/agent-harness 0.1.1

package/dist/chunk-W4T7PGI2.js

@@ -0,0 +1,346 @@
+#!/usr/bin/env node
+
+import {
+  writeIndexFile
+} from "./chunk-4FDUOGSZ.js";
+import {
+  loadDirectory,
+  parseHarnessDocument
+} from "./chunk-UPLBF4RZ.js";
+import {
+  getPrimitiveDirs
+} from "./chunk-4CWAGBNS.js";
+
+// src/runtime/intake.ts
+import { readFileSync, writeFileSync, unlinkSync, existsSync, mkdirSync, readdirSync, copyFileSync } from "fs";
+import { join, basename } from "path";
+import { tmpdir } from "os";
+import matter from "gray-matter";
+var VALID_TYPES = ["rule", "instinct", "skill", "playbook", "workflow", "tool", "agent"];
+var TYPE_DIRS = {
+  rule: "rules",
+  instinct: "instincts",
+  skill: "skills",
+  playbook: "playbooks",
+  workflow: "workflows",
+  tool: "tools",
+  agent: "agents"
+};
+function fixCapability(filePath) {
+  const result = {
+    valid: true,
+    type: null,
+    errors: [],
+    warnings: [],
+    fixes_applied: []
+  };
+  if (!existsSync(filePath)) {
+    result.valid = false;
+    result.errors.push("File does not exist");
+    return result;
+  }
+  if (!filePath.endsWith(".md")) {
+    result.valid = false;
+    result.errors.push("File must be a .md file");
+    return result;
+  }
+  const raw = readFileSync(filePath, "utf-8");
+  let parsed;
+  try {
+    parsed = matter(raw);
+  } catch (err) {
+    result.valid = false;
+    result.errors.push(`Failed to parse frontmatter: ${err}`);
+    return result;
+  }
+  const data = { ...parsed.data };
+  let content = parsed.content;
+  let modified = false;
+  if (!data.id) {
+    const name = basename(filePath, ".md");
+    data.id = name.replace(/[^a-z0-9-]/gi, "-").toLowerCase();
+    result.fixes_applied.push(`Added id: "${data.id}" (from filename)`);
+    modified = true;
+  }
+  if (!data.status) {
+    data.status = "active";
+    result.fixes_applied.push('Added status: "active"');
+    modified = true;
+  }
+  const existingTags = Array.isArray(data.tags) ? data.tags.map((t) => t.toLowerCase()) : [];
+  let detectedType = null;
+  for (const type of VALID_TYPES) {
+    if (existingTags.includes(type)) {
+      detectedType = type;
+      break;
+    }
+  }
+  if (!detectedType) {
+    const bodyLower = content.toLowerCase();
+    if (bodyLower.includes("# rule:")) detectedType = "rule";
+    else if (bodyLower.includes("# instinct:")) detectedType = "instinct";
+    else if (bodyLower.includes("# skill:")) detectedType = "skill";
+    else if (bodyLower.includes("# playbook:")) detectedType = "playbook";
+    else if (bodyLower.includes("# workflow:")) detectedType = "workflow";
+    else if (bodyLower.includes("# tool:")) detectedType = "tool";
+    else if (bodyLower.includes("# agent:")) detectedType = "agent";
+  }
+  if (detectedType && !existingTags.includes(detectedType)) {
+    if (!Array.isArray(data.tags)) data.tags = [];
+    data.tags.push(detectedType);
+    result.fixes_applied.push(`Added tag: "${detectedType}"`);
+    modified = true;
+  }
+  result.type = detectedType;
+  const l0Regex = /<!--\s*L0:\s*(.*?)\s*-->/;
+  if (!l0Regex.test(content)) {
+    const headingMatch = content.match(/^#\s+(.+)$/m);
+    const firstLine = content.split("\n").find((line) => line.trim().length > 0);
+    const summary = headingMatch ? headingMatch[1].trim() : firstLine?.trim() ?? "";
+    if (summary.length > 0) {
+      const l0Text = summary.length > 120 ? summary.slice(0, 117) + "..." : summary;
+      content = `<!-- L0: ${l0Text} -->
+${content}`;
+      result.fixes_applied.push("Generated L0 summary from content");
+      modified = true;
+    }
+  }
+  const l1Regex = /<!--\s*L1:\s*(.*?)\s*-->/s;
+  if (!l1Regex.test(content)) {
+    const paragraphs = content.split(/\n{2,}/).filter((p) => {
+      const trimmed = p.trim();
+      return trimmed.length > 0 && !trimmed.startsWith("<!--") && !trimmed.startsWith("#");
+    });
+    if (paragraphs.length > 0) {
+      const para = paragraphs[0].replace(/\n/g, " ").trim();
+      const l1Text = para.length > 300 ? para.slice(0, 297) + "..." : para;
+      const l0Pos = content.indexOf("-->");
+      if (l0Pos !== -1) {
+        const insertPos = l0Pos + 3;
+        content = content.slice(0, insertPos) + `
+<!-- L1: ${l1Text} -->` + content.slice(insertPos);
+      } else {
+        content = `<!-- L1: ${l1Text} -->
+${content}`;
+      }
+      result.fixes_applied.push("Generated L1 summary from first paragraph");
+      modified = true;
+    }
+  }
+  if (modified) {
+    const newRaw = matter.stringify(content, data);
+    writeFileSync(filePath, newRaw, "utf-8");
+  }
+  if (!result.type) {
+    result.errors.push(
+      'Cannot determine primitive type. Add a type tag or use a heading like "# Skill: Name"'
+    );
+  }
+  const bodyContent = content.replace(l0Regex, "").replace(l1Regex, "").trim();
+  if (!bodyContent || bodyContent.length < 20) {
+    result.valid = false;
+    result.errors.push("Body content is too short or empty");
+  }
+  if (result.errors.length > 0) {
+    result.valid = false;
+  }
+  return result;
+}
+function evaluateCapability(filePath, harnessDir) {
+  const result = {
+    valid: true,
+    type: null,
+    errors: [],
+    warnings: [],
+    fixes_applied: []
+  };
+  if (!existsSync(filePath)) {
+    result.valid = false;
+    result.errors.push("File does not exist");
+    return result;
+  }
+  if (!filePath.endsWith(".md")) {
+    result.valid = false;
+    result.errors.push("File must be a .md file");
+    return result;
+  }
+  let doc;
+  try {
+    doc = parseHarnessDocument(filePath);
+  } catch (err) {
+    result.valid = false;
+    result.errors.push(`Failed to parse: ${err}`);
+    return result;
+  }
+  if (!doc.frontmatter.id) {
+    result.valid = false;
+    result.errors.push("Missing frontmatter field: id");
+  }
+  if (!doc.frontmatter.status) {
+    result.warnings.push('Missing status field, defaulting to "active"');
+  }
+  const tags = doc.frontmatter.tags.map((t) => t.toLowerCase());
+  for (const type of VALID_TYPES) {
+    if (tags.includes(type)) {
+      result.type = type;
+      break;
+    }
+  }
+  if (!result.type) {
+    const bodyLower = doc.body.toLowerCase();
+    if (bodyLower.includes("# rule:")) result.type = "rule";
+    else if (bodyLower.includes("# instinct:")) result.type = "instinct";
+    else if (bodyLower.includes("# skill:")) result.type = "skill";
+    else if (bodyLower.includes("# playbook:")) result.type = "playbook";
+    else if (bodyLower.includes("# workflow:")) result.type = "workflow";
+    else if (bodyLower.includes("# tool:")) result.type = "tool";
+    else if (bodyLower.includes("# agent:")) result.type = "agent";
+  }
+  if (!result.type) {
+    result.valid = false;
+    result.errors.push(
+      'Cannot determine primitive type. Add a type tag (rule, instinct, skill, playbook, workflow, tool, agent) or use a heading like "# Skill: Name"'
+    );
+  }
+  if (!doc.l0) {
+    result.warnings.push("Missing L0 summary (<!-- L0: ... -->). Recommended for context loading.");
+  }
+  if (!doc.l1) {
+    result.warnings.push("Missing L1 summary (<!-- L1: ... -->). Recommended for context loading.");
+  }
+  if (!doc.body || doc.body.length < 20) {
+    result.valid = false;
+    result.errors.push("Body content is too short or empty");
+  }
+  if (harnessDir) {
+    resolveDependencies(doc, harnessDir, result);
+  }
+  return result;
+}
+function resolveDependencies(doc, harnessDir, result) {
+  const primitiveDirs = getPrimitiveDirs();
+  const knownIds = /* @__PURE__ */ new Set();
+  for (const dir of primitiveDirs) {
+    const fullPath = join(harnessDir, dir);
+    if (!existsSync(fullPath)) continue;
+    const docs = loadDirectory(fullPath);
+    for (const d of docs) {
+      knownIds.add(d.frontmatter.id);
+    }
+  }
+  const related = doc.frontmatter.related;
+  if (related && related.length > 0) {
+    for (const ref of related) {
+      if (knownIds.has(ref)) continue;
+      const refPath = join(harnessDir, ref);
+      if (existsSync(refPath) || existsSync(refPath + ".md")) continue;
+      result.warnings.push(`Unresolved reference: "${ref}" (related: field) \u2014 not found in harness`);
+    }
+  }
+  const withAgent = doc.frontmatter.with;
+  if (withAgent) {
+    const agentsDir = join(harnessDir, "agents");
+    let agentFound = false;
+    if (existsSync(agentsDir)) {
+      const agentDocs = loadDirectory(agentsDir);
+      agentFound = agentDocs.some(
+        (d) => d.frontmatter.id === withAgent || basename(d.path, ".md") === withAgent
+      );
+    }
+    if (!agentFound) {
+      result.warnings.push(`Unresolved agent: "${withAgent}" (with: field) \u2014 no matching agent found`);
+    }
+  }
+  const schedule = doc.frontmatter.schedule;
+  if (schedule) {
+    const fields = schedule.trim().split(/\s+/);
+    if (fields.length < 5 || fields.length > 6) {
+      result.warnings.push(`Possibly invalid cron expression: "${schedule}" (expected 5-6 fields)`);
+    }
+  }
+}
+function installCapability(harnessDir, filePath) {
+  const evalResult = evaluateCapability(filePath, harnessDir);
+  if (!evalResult.valid || !evalResult.type) {
+    return { installed: false, destination: "", evalResult };
+  }
+  const targetDir = join(harnessDir, TYPE_DIRS[evalResult.type]);
+  if (!existsSync(targetDir)) {
+    mkdirSync(targetDir, { recursive: true });
+  }
+  const destination = join(targetDir, basename(filePath));
+  copyFileSync(filePath, destination);
+  const processedDir = join(harnessDir, "intake", ".processed");
+  if (!existsSync(processedDir)) {
+    mkdirSync(processedDir, { recursive: true });
+  }
+  copyFileSync(filePath, join(processedDir, basename(filePath)));
+  writeIndexFile(harnessDir, TYPE_DIRS[evalResult.type]);
+  return { installed: true, destination, evalResult };
+}
+function processIntake(harnessDir) {
+  const intakeDir = join(harnessDir, "intake");
+  if (!existsSync(intakeDir)) return [];
+  const files = readdirSync(intakeDir).filter(
+    (f) => f.endsWith(".md") && !f.startsWith(".")
+  );
+  const results = [];
+  for (const file of files) {
+    const filePath = join(intakeDir, file);
+    const result = installCapability(harnessDir, filePath);
+    results.push({ file, result });
+    if (result.installed) {
+      try {
+        unlinkSync(filePath);
+      } catch (_unlinkErr) {
+      }
+    }
+  }
+  return results;
+}
+async function downloadCapability(url) {
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch {
+    return { downloaded: false, localPath: "", error: `Invalid URL: ${url}` };
+  }
+  if (parsed.protocol !== "https:") {
+    return { downloaded: false, localPath: "", error: "Only HTTPS URLs are supported" };
+  }
+  const urlPath = parsed.pathname;
+  let filename = basename(urlPath);
+  if (!filename.endsWith(".md")) {
+    filename = filename + ".md";
+  }
+  try {
+    const response = await fetch(url);
+    if (!response.ok) {
+      return { downloaded: false, localPath: "", error: `HTTP ${response.status}: ${response.statusText}` };
+    }
+    const body = await response.text();
+    if (body.length === 0) {
+      return { downloaded: false, localPath: "", error: "Downloaded file is empty" };
+    }
+    if (body.length > 1048576) {
+      return { downloaded: false, localPath: "", error: "File exceeds 1MB size limit" };
+    }
+    const tempDir = join(tmpdir(), "harness-download");
+    mkdirSync(tempDir, { recursive: true });
+    const localPath = join(tempDir, filename);
+    writeFileSync(localPath, body, "utf-8");
+    return { downloaded: true, localPath };
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return { downloaded: false, localPath: "", error: `Download failed: ${msg}` };
+  }
+}
+
+export {
+  fixCapability,
+  evaluateCapability,
+  installCapability,
+  processIntake,
+  downloadCapability
+};
+//# sourceMappingURL=chunk-W4T7PGI2.js.map

package/dist/chunk-W4T7PGI2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime/intake.ts"],"sourcesContent":["import { readFileSync, writeFileSync, unlinkSync, existsSync, mkdirSync, readdirSync, copyFileSync } from 'fs';\nimport { join, basename } from 'path';\nimport { tmpdir } from 'os';\nimport matter from 'gray-matter';\nimport { parseHarnessDocument, loadDirectory } from '../primitives/loader.js';\nimport { writeIndexFile } from './indexer.js';\nimport { getPrimitiveDirs } from '../core/types.js';\nimport type { HarnessDocument } from '../core/types.js';\n\nexport interface EvalResult {\n  valid: boolean;\n  type: string | null;\n  errors: string[];\n  warnings: string[];\n  fixes_applied: string[];\n}\n\nconst VALID_TYPES = ['rule', 'instinct', 'skill', 'playbook', 'workflow', 'tool', 'agent'];\nconst TYPE_DIRS: Record<string, string> = {\n  rule: 'rules',\n  instinct: 'instincts',\n  skill: 'skills',\n  playbook: 'playbooks',\n  workflow: 'workflows',\n  tool: 'tools',\n  agent: 'agents',\n};\n\n/**\n * Auto-fix common issues in a capability file.\n * Reads the file, applies fixes, writes back, returns what was fixed.\n * Does NOT fix unfixable issues (e.g., empty body, unparseable YAML).\n */\nexport function fixCapability(filePath: string): EvalResult {\n  const result: EvalResult = {\n    valid: true,\n    type: null,\n    errors: [],\n    warnings: [],\n    fixes_applied: [],\n  };\n\n  if (!existsSync(filePath)) {\n    result.valid = false;\n    result.errors.push('File does not exist');\n    return result;\n  }\n\n  if (!filePath.endsWith('.md')) {\n    result.valid = false;\n    result.errors.push('File must be a .md file');\n    return result;\n  }\n\n  const raw = readFileSync(filePath, 'utf-8');\n  let parsed: ReturnType<typeof matter>;\n  try {\n    parsed = matter(raw);\n  } catch (err) {\n    result.valid = false;\n    result.errors.push(`Failed to parse frontmatter: ${err}`);\n    return result;\n  }\n\n  const data = { ...parsed.data } as Record<string, unknown>;\n  let content = parsed.content;\n  let modified = false;\n\n  // Fix 1: Missing id — derive from filename\n  if (!data.id) {\n    const name = basename(filePath, '.md');\n    data.id = name.replace(/[^a-z0-9-]/gi, '-').toLowerCase();\n    result.fixes_applied.push(`Added id: \"${data.id}\" (from filename)`);\n    modified = true;\n  }\n\n  // Fix 2: Missing status — set to active\n  if (!data.status) {\n    data.status = 'active';\n    result.fixes_applied.push('Added status: \"active\"');\n    modified = true;\n  }\n\n  // Fix 3: Missing type tag — infer from content and add tag\n  const existingTags = Array.isArray(data.tags) ? (data.tags as string[]).map((t) => t.toLowerCase()) : [];\n  let detectedType: string | null = null;\n  for (const type of VALID_TYPES) {\n    if (existingTags.includes(type)) {\n      detectedType = type;\n      break;\n    }\n  }\n  if (!detectedType) {\n    const bodyLower = content.toLowerCase();\n    if (bodyLower.includes('# rule:')) detectedType = 'rule';\n    else if (bodyLower.includes('# instinct:')) detectedType = 'instinct';\n    else if (bodyLower.includes('# skill:')) detectedType = 'skill';\n    else if (bodyLower.includes('# playbook:')) detectedType = 'playbook';\n    else if (bodyLower.includes('# workflow:')) detectedType = 'workflow';\n    else if (bodyLower.includes('# tool:')) detectedType = 'tool';\n    else if (bodyLower.includes('# agent:')) detectedType = 'agent';\n  }\n  if (detectedType && !existingTags.includes(detectedType)) {\n    if (!Array.isArray(data.tags)) data.tags = [];\n    (data.tags as string[]).push(detectedType);\n    result.fixes_applied.push(`Added tag: \"${detectedType}\"`);\n    modified = true;\n  }\n  result.type = detectedType;\n\n  // Fix 4: Missing L0 — generate from first heading or first non-empty line\n  const l0Regex = /<!--\\s*L0:\\s*(.*?)\\s*-->/;\n  if (!l0Regex.test(content)) {\n    const headingMatch = content.match(/^#\\s+(.+)$/m);\n    const firstLine = content.split('\\n').find((line) => line.trim().length > 0);\n    const summary = headingMatch ? headingMatch[1].trim() : (firstLine?.trim() ?? '');\n    if (summary.length > 0) {\n      const l0Text = summary.length > 120 ? summary.slice(0, 117) + '...' : summary;\n      content = `<!-- L0: ${l0Text} -->\\n${content}`;\n      result.fixes_applied.push('Generated L0 summary from content');\n      modified = true;\n    }\n  }\n\n  // Fix 5: Missing L1 — generate from first paragraph\n  const l1Regex = /<!--\\s*L1:\\s*(.*?)\\s*-->/s;\n  if (!l1Regex.test(content)) {\n    const paragraphs = content.split(/\\n{2,}/).filter((p) => {\n      const trimmed = p.trim();\n      return trimmed.length > 0 && !trimmed.startsWith('<!--') && !trimmed.startsWith('#');\n    });\n    if (paragraphs.length > 0) {\n      const para = paragraphs[0].replace(/\\n/g, ' ').trim();\n      const l1Text = para.length > 300 ? para.slice(0, 297) + '...' : para;\n      // Insert L1 after L0 if present, otherwise at the top\n      const l0Pos = content.indexOf('-->');\n      if (l0Pos !== -1) {\n        const insertPos = l0Pos + 3;\n        content = content.slice(0, insertPos) + `\\n<!-- L1: ${l1Text} -->` + content.slice(insertPos);\n      } else {\n        content = `<!-- L1: ${l1Text} -->\\n${content}`;\n      }\n      result.fixes_applied.push('Generated L1 summary from first paragraph');\n      modified = true;\n    }\n  }\n\n  // Write back if modified\n  if (modified) {\n    const newRaw = matter.stringify(content, data);\n    writeFileSync(filePath, newRaw, 'utf-8');\n  }\n\n  // Re-evaluate after fixes\n  if (!result.type) {\n    result.errors.push(\n      'Cannot determine primitive type. Add a type tag or use a heading like \"# Skill: Name\"',\n    );\n  }\n\n  // Check body has content\n  const bodyContent = content.replace(l0Regex, '').replace(l1Regex, '').trim();\n  if (!bodyContent || bodyContent.length < 20) {\n    result.valid = false;\n    result.errors.push('Body content is too short or empty');\n  }\n\n  if (result.errors.length > 0) {\n    result.valid = false;\n  }\n\n  return result;\n}\n\n/**\n * Evaluate a capability file. If harnessDir is provided, also checks\n * dependency resolution (related: references, with: agent references).\n */\nexport function evaluateCapability(filePath: string, harnessDir?: string): EvalResult {\n  const result: EvalResult = {\n    valid: true,\n    type: null,\n    errors: [],\n    warnings: [],\n    fixes_applied: [],\n  };\n\n  // Step 1: Check file exists and is markdown\n  if (!existsSync(filePath)) {\n    result.valid = false;\n    result.errors.push('File does not exist');\n    return result;\n  }\n\n  if (!filePath.endsWith('.md')) {\n    result.valid = false;\n    result.errors.push('File must be a .md file');\n    return result;\n  }\n\n  // Step 2: Try to parse\n  let doc: HarnessDocument;\n  try {\n    doc = parseHarnessDocument(filePath);\n  } catch (err) {\n    result.valid = false;\n    result.errors.push(`Failed to parse: ${err}`);\n    return result;\n  }\n\n  // Step 3: Check frontmatter\n  if (!doc.frontmatter.id) {\n    result.valid = false;\n    result.errors.push('Missing frontmatter field: id');\n  }\n\n  if (!doc.frontmatter.status) {\n    result.warnings.push('Missing status field, defaulting to \"active\"');\n  }\n\n  // Step 4: Detect type from tags or directory hint\n  const tags = doc.frontmatter.tags.map((t) => t.toLowerCase());\n  for (const type of VALID_TYPES) {\n    if (tags.includes(type)) {\n      result.type = type;\n      break;\n    }\n  }\n\n  if (!result.type) {\n    // Try to infer from content\n    const bodyLower = doc.body.toLowerCase();\n    if (bodyLower.includes('# rule:')) result.type = 'rule';\n    else if (bodyLower.includes('# instinct:')) result.type = 'instinct';\n    else if (bodyLower.includes('# skill:')) result.type = 'skill';\n    else if (bodyLower.includes('# playbook:')) result.type = 'playbook';\n    else if (bodyLower.includes('# workflow:')) result.type = 'workflow';\n    else if (bodyLower.includes('# tool:')) result.type = 'tool';\n    else if (bodyLower.includes('# agent:')) result.type = 'agent';\n  }\n\n  if (!result.type) {\n    result.valid = false;\n    result.errors.push(\n      'Cannot determine primitive type. Add a type tag (rule, instinct, skill, playbook, workflow, tool, agent) or use a heading like \"# Skill: Name\"',\n    );\n  }\n\n  // Step 5: Check L0/L1\n  if (!doc.l0) {\n    result.warnings.push('Missing L0 summary (<!-- L0: ... -->). Recommended for context loading.');\n  }\n  if (!doc.l1) {\n    result.warnings.push('Missing L1 summary (<!-- L1: ... -->). Recommended for context loading.');\n  }\n\n  // Step 6: Check body has content\n  if (!doc.body || doc.body.length < 20) {\n    result.valid = false;\n    result.errors.push('Body content is too short or empty');\n  }\n\n  // Step 7: Dependency resolution (when harness dir is available)\n  if (harnessDir) {\n    resolveDependencies(doc, harnessDir, result);\n  }\n\n  return result;\n}\n\n/**\n * Check that referenced primitives (related: and with: fields) exist in the harness.\n */\nfunction resolveDependencies(doc: HarnessDocument, harnessDir: string, result: EvalResult): void {\n  // Load all known primitive IDs for reference checking\n  const primitiveDirs = getPrimitiveDirs();\n  const knownIds = new Set<string>();\n  for (const dir of primitiveDirs) {\n    const fullPath = join(harnessDir, dir);\n    if (!existsSync(fullPath)) continue;\n    const docs = loadDirectory(fullPath);\n    for (const d of docs) {\n      knownIds.add(d.frontmatter.id);\n    }\n  }\n\n  // Check related: references\n  const related = doc.frontmatter.related;\n  if (related && related.length > 0) {\n    for (const ref of related) {\n      if (knownIds.has(ref)) continue;\n      // Check if it's a file path\n      const refPath = join(harnessDir, ref);\n      if (existsSync(refPath) || existsSync(refPath + '.md')) continue;\n      result.warnings.push(`Unresolved reference: \"${ref}\" (related: field) — not found in harness`);\n    }\n  }\n\n  // Check with: agent reference (used for delegation)\n  const withAgent = doc.frontmatter.with;\n  if (withAgent) {\n    // Check if agent exists in agents/ directory\n    const agentsDir = join(harnessDir, 'agents');\n    let agentFound = false;\n    if (existsSync(agentsDir)) {\n      const agentDocs = loadDirectory(agentsDir);\n      agentFound = agentDocs.some(\n        (d) => d.frontmatter.id === withAgent || basename(d.path, '.md') === withAgent,\n      );\n    }\n    if (!agentFound) {\n      result.warnings.push(`Unresolved agent: \"${withAgent}\" (with: field) — no matching agent found`);\n    }\n  }\n\n  // Check schedule: cron expression validity (for workflows)\n  const schedule = doc.frontmatter.schedule;\n  if (schedule) {\n    // Basic cron validation: should have 5-6 space-separated fields\n    const fields = schedule.trim().split(/\\s+/);\n    if (fields.length < 5 || fields.length > 6) {\n      result.warnings.push(`Possibly invalid cron expression: \"${schedule}\" (expected 5-6 fields)`);\n    }\n  }\n}\n\nexport function installCapability(harnessDir: string, filePath: string): { installed: boolean; destination: string; evalResult: EvalResult } {\n  const evalResult = evaluateCapability(filePath, harnessDir);\n\n  if (!evalResult.valid || !evalResult.type) {\n    return { installed: false, destination: '', evalResult };\n  }\n\n  const targetDir = join(harnessDir, TYPE_DIRS[evalResult.type]);\n  if (!existsSync(targetDir)) {\n    mkdirSync(targetDir, { recursive: true });\n  }\n\n  const destination = join(targetDir, basename(filePath));\n\n  // Copy file to target directory\n  copyFileSync(filePath, destination);\n\n  // Move original to .processed\n  const processedDir = join(harnessDir, 'intake', '.processed');\n  if (!existsSync(processedDir)) {\n    mkdirSync(processedDir, { recursive: true });\n  }\n  copyFileSync(filePath, join(processedDir, basename(filePath)));\n\n  // Rebuild index for target directory\n  writeIndexFile(harnessDir, TYPE_DIRS[evalResult.type]);\n\n  return { installed: true, destination, evalResult };\n}\n\nexport function processIntake(harnessDir: string): Array<{ file: string; result: ReturnType<typeof installCapability> }> {\n  const intakeDir = join(harnessDir, 'intake');\n  if (!existsSync(intakeDir)) return [];\n\n  const files = readdirSync(intakeDir).filter(\n    (f) => f.endsWith('.md') && !f.startsWith('.'),\n  );\n\n  const results: Array<{ file: string; result: ReturnType<typeof installCapability> }> = [];\n\n  for (const file of files) {\n    const filePath = join(intakeDir, file);\n    const result = installCapability(harnessDir, filePath);\n    results.push({ file, result });\n\n    // Remove from intake if installed\n    if (result.installed) {\n      try {\n        unlinkSync(filePath);\n      } catch (_unlinkErr) {\n        // Best-effort cleanup — file persists if removal fails\n      }\n    }\n  }\n\n  return results;\n}\n\nexport interface DownloadResult {\n  downloaded: boolean;\n  localPath: string;\n  error?: string;\n}\n\n/**\n * Download a capability file from a URL to a temporary file.\n * Validates the URL (must be HTTPS) and content type (must look like markdown).\n * Returns a local temp path suitable for passing to installCapability().\n */\nexport async function downloadCapability(url: string): Promise<DownloadResult> {\n  // Validate URL\n  let parsed: URL;\n  try {\n    parsed = new URL(url);\n  } catch {\n    return { downloaded: false, localPath: '', error: `Invalid URL: ${url}` };\n  }\n\n  if (parsed.protocol !== 'https:') {\n    return { downloaded: false, localPath: '', error: 'Only HTTPS URLs are supported' };\n  }\n\n  // Derive filename from URL path\n  const urlPath = parsed.pathname;\n  let filename = basename(urlPath);\n  if (!filename.endsWith('.md')) {\n    filename = filename + '.md';\n  }\n\n  try {\n    const response = await fetch(url);\n\n    if (!response.ok) {\n      return { downloaded: false, localPath: '', error: `HTTP ${response.status}: ${response.statusText}` };\n    }\n\n    const body = await response.text();\n\n    // Basic validation: must contain frontmatter delimiters or be valid markdown\n    if (body.length === 0) {\n      return { downloaded: false, localPath: '', error: 'Downloaded file is empty' };\n    }\n\n    // Max size: 1MB\n    if (body.length > 1_048_576) {\n      return { downloaded: false, localPath: '', error: 'File exceeds 1MB size limit' };\n    }\n\n    // Write to temp directory\n    const tempDir = join(tmpdir(), 'harness-download');\n    mkdirSync(tempDir, { recursive: true });\n    const localPath = join(tempDir, filename);\n    writeFileSync(localPath, body, 'utf-8');\n\n    return { downloaded: true, localPath };\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err);\n    return { downloaded: false, localPath: '', error: `Download failed: ${msg}` };\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-XTBKL5BI.js

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+
+import {
+  loadDirectory
+} from "./chunk-UPLBF4RZ.js";
+
+// src/runtime/tools.ts
+import { existsSync } from "fs";
+import { join } from "path";
+function extractAuth(body) {
+  const authSection = body.match(/## Authentication\s*\n([\s\S]*?)(?=\n## |\n$|$)/i);
+  if (!authSection) return [];
+  const envVarPattern = /`([A-Z][A-Z0-9_]+)`/g;
+  const vars = [];
+  const seen = /* @__PURE__ */ new Set();
+  let match;
+  while ((match = envVarPattern.exec(authSection[1])) !== null) {
+    const envVar = match[1];
+    if (!seen.has(envVar)) {
+      seen.add(envVar);
+      vars.push({
+        envVar,
+        present: process.env[envVar] !== void 0 && process.env[envVar] !== ""
+      });
+    }
+  }
+  return vars;
+}
+function extractOperations(body) {
+  const opsSection = body.match(/## (?:Common )?Operations\s*\n([\s\S]*?)(?=\n## |\n$|$)/i);
+  if (!opsSection) return [];
+  const ops = [];
+  const lines = opsSection[1].split("\n");
+  let currentSection = "";
+  for (const line of lines) {
+    const headingMatch = line.match(/^### (.+)/);
+    if (headingMatch) {
+      currentSection = headingMatch[1].trim();
+      continue;
+    }
+    const opMatch = line.match(/`?(GET|POST|PUT|DELETE|PATCH)\s+(\S+?)`?(?:\s|$)/);
+    if (opMatch) {
+      const name = currentSection ? `${currentSection}: ${opMatch[2].split("/").pop() || opMatch[2]}` : opMatch[2].split("/").pop() || opMatch[2];
+      ops.push({
+        name,
+        method: opMatch[1],
+        endpoint: opMatch[2]
+      });
+    }
+  }
+  return ops;
+}
+function extractRateLimits(body) {
+  const section = body.match(/## Rate Limits\s*\n([\s\S]*?)(?=\n## |\n$|$)/i);
+  if (!section) return [];
+  return section[1].split("\n").filter((l) => l.startsWith("- ")).map((l) => l.replace(/^- /, "").trim());
+}
+function extractGotchas(body) {
+  const section = body.match(/## Gotchas\s*\n([\s\S]*?)(?=\n## |\n$|$)/i);
+  if (!section) return [];
+  return section[1].split("\n").filter((l) => l.startsWith("- ")).map((l) => l.replace(/^- /, "").trim());
+}
+function parseToolDefinition(doc) {
+  return {
+    id: doc.frontmatter.id,
+    doc,
+    tags: doc.frontmatter.tags,
+    status: doc.frontmatter.status,
+    auth: extractAuth(doc.body),
+    operations: extractOperations(doc.body),
+    rateLimits: extractRateLimits(doc.body),
+    gotchas: extractGotchas(doc.body)
+  };
+}
+function loadTools(harnessDir) {
+  const toolsDir = join(harnessDir, "tools");
+  if (!existsSync(toolsDir)) return [];
+  const docs = loadDirectory(toolsDir);
+  return docs.map(parseToolDefinition);
+}
+function getToolById(harnessDir, toolId) {
+  const tools = loadTools(harnessDir);
+  return tools.find((t) => t.id === toolId) ?? null;
+}
+function listToolSummaries(harnessDir) {
+  const tools = loadTools(harnessDir);
+  return tools.map((t) => ({
+    id: t.id,
+    l0: t.doc.l0,
+    tags: t.tags,
+    status: t.status,
+    authReady: t.auth.length === 0 || t.auth.every((a) => a.present),
+    operationCount: t.operations.length
+  }));
+}
+function checkToolAuth(harnessDir, toolId) {
+  const tools = toolId ? [getToolById(harnessDir, toolId)].filter((t) => t !== null) : loadTools(harnessDir);
+  return tools.map((t) => ({
+    tool: t.id,
+    auth: t.auth
+  }));
+}
+
+export {
+  parseToolDefinition,
+  loadTools,
+  getToolById,
+  listToolSummaries,
+  checkToolAuth
+};
+//# sourceMappingURL=chunk-XTBKL5BI.js.map

package/dist/chunk-XTBKL5BI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime/tools.ts"],"sourcesContent":["import { existsSync, readdirSync } from 'fs';\nimport { join, basename } from 'path';\nimport { loadDirectory } from '../primitives/loader.js';\nimport type { HarnessDocument } from '../core/types.js';\n\nexport interface ToolAuth {\n  envVar: string;\n  present: boolean;\n}\n\nexport interface ToolOperation {\n  name: string;\n  method: string;\n  endpoint: string;\n}\n\nexport interface ToolDefinition {\n  id: string;\n  doc: HarnessDocument;\n  tags: string[];\n  status: string;\n  auth: ToolAuth[];\n  operations: ToolOperation[];\n  rateLimits: string[];\n  gotchas: string[];\n}\n\nexport interface ToolSummary {\n  id: string;\n  l0: string;\n  tags: string[];\n  status: string;\n  authReady: boolean;\n  operationCount: number;\n}\n\n/**\n * Extract environment variable names from authentication section.\n * Looks for `ENV_VAR_NAME` patterns (all-caps with underscores) in the auth section.\n */\nfunction extractAuth(body: string): ToolAuth[] {\n  const authSection = body.match(/## Authentication\\s*\\n([\\s\\S]*?)(?=\\n## |\\n$|$)/i);\n  if (!authSection) return [];\n\n  const envVarPattern = /`([A-Z][A-Z0-9_]+)`/g;\n  const vars: ToolAuth[] = [];\n  const seen = new Set<string>();\n  let match: RegExpExecArray | null;\n\n  while ((match = envVarPattern.exec(authSection[1])) !== null) {\n    const envVar = match[1];\n    if (!seen.has(envVar)) {\n      seen.add(envVar);\n      vars.push({\n        envVar,\n        present: process.env[envVar] !== undefined && process.env[envVar] !== '',\n      });\n    }\n  }\n\n  return vars;\n}\n\n/**\n * Extract operations from Common Operations / Operations sections.\n * Looks for lines with HTTP method + endpoint patterns.\n */\nfunction extractOperations(body: string): ToolOperation[] {\n  const opsSection = body.match(/## (?:Common )?Operations\\s*\\n([\\s\\S]*?)(?=\\n## |\\n$|$)/i);\n  if (!opsSection) return [];\n\n  const ops: ToolOperation[] = [];\n  const lines = opsSection[1].split('\\n');\n  let currentSection = '';\n\n  for (const line of lines) {\n    const headingMatch = line.match(/^### (.+)/);\n    if (headingMatch) {\n      currentSection = headingMatch[1].trim();\n      continue;\n    }\n\n    // Match patterns like: `GET /repos/{owner}/{repo}/pulls`\n    // or: POST /sendMessage\n    const opMatch = line.match(/`?(GET|POST|PUT|DELETE|PATCH)\\s+(\\S+?)`?(?:\\s|$)/);\n    if (opMatch) {\n      const name = currentSection\n        ? `${currentSection}: ${opMatch[2].split('/').pop() || opMatch[2]}`\n        : opMatch[2].split('/').pop() || opMatch[2];\n      ops.push({\n        name,\n        method: opMatch[1],\n        endpoint: opMatch[2],\n      });\n    }\n  }\n\n  return ops;\n}\n\n/**\n * Extract rate limit lines from Rate Limits section.\n */\nfunction extractRateLimits(body: string): string[] {\n  const section = body.match(/## Rate Limits\\s*\\n([\\s\\S]*?)(?=\\n## |\\n$|$)/i);\n  if (!section) return [];\n\n  return section[1]\n    .split('\\n')\n    .filter((l) => l.startsWith('- '))\n    .map((l) => l.replace(/^- /, '').trim());\n}\n\n/**\n * Extract gotchas/caveats from Gotchas section.\n */\nfunction extractGotchas(body: string): string[] {\n  const section = body.match(/## Gotchas\\s*\\n([\\s\\S]*?)(?=\\n## |\\n$|$)/i);\n  if (!section) return [];\n\n  return section[1]\n    .split('\\n')\n    .filter((l) => l.startsWith('- '))\n    .map((l) => l.replace(/^- /, '').trim());\n}\n\n/**\n * Parse a tool document into a structured ToolDefinition.\n */\nexport function parseToolDefinition(doc: HarnessDocument): ToolDefinition {\n  return {\n    id: doc.frontmatter.id,\n    doc,\n    tags: doc.frontmatter.tags,\n    status: doc.frontmatter.status,\n    auth: extractAuth(doc.body),\n    operations: extractOperations(doc.body),\n    rateLimits: extractRateLimits(doc.body),\n    gotchas: extractGotchas(doc.body),\n  };\n}\n\n/**\n * Load all tool definitions from the tools/ directory.\n */\nexport function loadTools(harnessDir: string): ToolDefinition[] {\n  const toolsDir = join(harnessDir, 'tools');\n  if (!existsSync(toolsDir)) return [];\n\n  const docs = loadDirectory(toolsDir);\n  return docs.map(parseToolDefinition);\n}\n\n/**\n * Get a specific tool definition by ID.\n */\nexport function getToolById(harnessDir: string, toolId: string): ToolDefinition | null {\n  const tools = loadTools(harnessDir);\n  return tools.find((t) => t.id === toolId) ?? null;\n}\n\n/**\n * List tools with summary info (without full document content).\n */\nexport function listToolSummaries(harnessDir: string): ToolSummary[] {\n  const tools = loadTools(harnessDir);\n  return tools.map((t) => ({\n    id: t.id,\n    l0: t.doc.l0,\n    tags: t.tags,\n    status: t.status,\n    authReady: t.auth.length === 0 || t.auth.every((a) => a.present),\n    operationCount: t.operations.length,\n  }));\n}\n\n/**\n * Check auth status for a specific tool or all tools.\n */\nexport function checkToolAuth(harnessDir: string, toolId?: string): Array<{ tool: string; auth: ToolAuth[] }> {\n  const tools = toolId\n    ? [getToolById(harnessDir, toolId)].filter((t): t is ToolDefinition => t !== null)\n    : loadTools(harnessDir);\n\n  return tools.map((t) => ({\n    tool: t.id,\n    auth: t.auth,\n  }));\n}\n"],"mappings":"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","names":[]}