@bluecopa/harness 0.0.0-snapshot.137

package/dist/observability/otel.d.ts

@@ -0,0 +1,36 @@
+interface SpanRecord {
+    traceId: string;
+    spanId: string;
+    parentSpanId?: string | undefined;
+    name: string;
+    attributes: Record<string, string | number | boolean>;
+    startTime: number;
+    endTime: number;
+}
+interface MetricRecord {
+    name: string;
+    value: number;
+    type: 'counter' | 'histogram';
+    attributes: Record<string, string | number | boolean>;
+}
+interface SpanHandle {
+    traceId: string;
+    spanId: string;
+    end(attributes?: Record<string, string | number | boolean>): void;
+}
+declare class HarnessTelemetry {
+    private readonly enabled;
+    private readonly context;
+    private readonly spans;
+    private readonly metrics;
+    constructor(enabled?: boolean);
+    isEnabled(): boolean;
+    startSpan(name: string, attributes?: Record<string, string | number | boolean>): SpanHandle;
+    withSpan<T>(name: string, attributes: Record<string, string | number | boolean>, fn: () => Promise<T>): Promise<T>;
+    counter(name: string, value?: number, attributes?: Record<string, string | number | boolean>): void;
+    histogram(name: string, value: number, attributes?: Record<string, string | number | boolean>): void;
+    getSpans(): SpanRecord[];
+    getMetrics(): MetricRecord[];
+}
+
+export { HarnessTelemetry, type MetricRecord, type SpanHandle, type SpanRecord };

package/dist/observability/otel.js

@@ -0,0 +1,73 @@
+import { AsyncLocalStorage } from 'async_hooks';
+import { randomUUID } from 'crypto';
+
+// src/observability/otel.ts
+var HarnessTelemetry = class {
+  constructor(enabled = true) {
+    this.enabled = enabled;
+  }
+  context = new AsyncLocalStorage();
+  spans = [];
+  metrics = [];
+  isEnabled() {
+    return this.enabled;
+  }
+  startSpan(name, attributes = {}) {
+    const now = Date.now();
+    const parent = this.context.getStore();
+    const traceId = parent?.traceId ?? randomUUID().replace(/-/g, "");
+    const spanId = randomUUID().replace(/-/g, "").slice(0, 16);
+    const record = {
+      traceId,
+      spanId,
+      parentSpanId: parent?.spanId,
+      name,
+      attributes: { ...attributes },
+      startTime: now,
+      endTime: now
+    };
+    this.spans.push(record);
+    return {
+      traceId,
+      spanId,
+      end: (extra = {}) => {
+        record.endTime = Date.now();
+        record.attributes = { ...record.attributes, ...extra };
+      }
+    };
+  }
+  async withSpan(name, attributes, fn) {
+    if (!this.enabled) {
+      return fn();
+    }
+    const span = this.startSpan(name, attributes);
+    return this.context.run({ traceId: span.traceId, spanId: span.spanId }, async () => {
+      try {
+        const result = await fn();
+        span.end({ success: true });
+        return result;
+      } catch (error) {
+        span.end({ success: false, error: error instanceof Error ? error.message : "unknown" });
+        throw error;
+      }
+    });
+  }
+  counter(name, value = 1, attributes = {}) {
+    if (!this.enabled) return;
+    this.metrics.push({ name, value, type: "counter", attributes });
+  }
+  histogram(name, value, attributes = {}) {
+    if (!this.enabled) return;
+    this.metrics.push({ name, value, type: "histogram", attributes });
+  }
+  getSpans() {
+    return [...this.spans];
+  }
+  getMetrics() {
+    return [...this.metrics];
+  }
+};
+
+export { HarnessTelemetry };
+//# sourceMappingURL=otel.js.map
+//# sourceMappingURL=otel.js.map

package/dist/observability/otel.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/observability/otel.ts"],"names":[],"mappings":"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","file":"otel.js","sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks';\nimport { randomUUID } from 'node:crypto';\n\nexport interface SpanRecord {\n  traceId: string;\n  spanId: string;\n  parentSpanId?: string | undefined;\n  name: string;\n  attributes: Record<string, string | number | boolean>;\n  startTime: number;\n  endTime: number;\n}\n\nexport interface MetricRecord {\n  name: string;\n  value: number;\n  type: 'counter' | 'histogram';\n  attributes: Record<string, string | number | boolean>;\n}\n\nexport interface SpanHandle {\n  traceId: string;\n  spanId: string;\n  end(attributes?: Record<string, string | number | boolean>): void;\n}\n\nexport class HarnessTelemetry {\n  private readonly context = new AsyncLocalStorage<{ traceId: string; spanId: string }>();\n  private readonly spans: SpanRecord[] = [];\n  private readonly metrics: MetricRecord[] = [];\n\n  constructor(private readonly enabled = true) {}\n\n  isEnabled(): boolean {\n    return this.enabled;\n  }\n\n  startSpan(name: string, attributes: Record<string, string | number | boolean> = {}): SpanHandle {\n    const now = Date.now();\n    const parent = this.context.getStore();\n    const traceId = parent?.traceId ?? randomUUID().replace(/-/g, '');\n    const spanId = randomUUID().replace(/-/g, '').slice(0, 16);\n\n    const record: SpanRecord = {\n      traceId,\n      spanId,\n      parentSpanId: parent?.spanId,\n      name,\n      attributes: { ...attributes },\n      startTime: now,\n      endTime: now\n    };\n\n    this.spans.push(record);\n\n    return {\n      traceId,\n      spanId,\n      end: (extra = {}) => {\n        record.endTime = Date.now();\n        record.attributes = { ...record.attributes, ...extra };\n      }\n    };\n  }\n\n  async withSpan<T>(\n    name: string,\n    attributes: Record<string, string | number | boolean>,\n    fn: () => Promise<T>\n  ): Promise<T> {\n    if (!this.enabled) {\n      return fn();\n    }\n\n    const span = this.startSpan(name, attributes);\n    return this.context.run({ traceId: span.traceId, spanId: span.spanId }, async () => {\n      try {\n        const result = await fn();\n        span.end({ success: true });\n        return result;\n      } catch (error) {\n        span.end({ success: false, error: error instanceof Error ? error.message : 'unknown' });\n        throw error;\n      }\n    });\n  }\n\n  counter(name: string, value = 1, attributes: Record<string, string | number | boolean> = {}): void {\n    if (!this.enabled) return;\n    this.metrics.push({ name, value, type: 'counter', attributes });\n  }\n\n  histogram(name: string, value: number, attributes: Record<string, string | number | boolean> = {}): void {\n    if (!this.enabled) return;\n    this.metrics.push({ name, value, type: 'histogram', attributes });\n  }\n\n  getSpans(): SpanRecord[] {\n    return [...this.spans];\n  }\n\n  getMetrics(): MetricRecord[] {\n    return [...this.metrics];\n  }\n}\n"]}

package/dist/shared-types-DRxnerLT.d.ts

@@ -0,0 +1,138 @@
+import { Tool, LanguageModel } from 'ai';
+
+/** What a tool call actually did to the world */
+type ActionType = "observed" | "produced" | "modified";
+interface ToolResultArtifact {
+    action: ActionType;
+    /** file, url, command_output, value */
+    kind: string;
+    uri: string;
+}
+interface ToolResult {
+    success: boolean;
+    output: string;
+    /** Compact summary for LLM context. When present, sent to the model instead of `output`. */
+    modelOutput?: string | undefined;
+    error?: string | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    /** What this tool call affected — set by execute, read by worker/compactor */
+    artifact?: ToolResultArtifact | undefined;
+}
+interface BashOptions {
+    timeout?: number | undefined;
+    cwd?: string | undefined;
+}
+interface ReadOptions {
+    lineRange?: [number, number] | undefined;
+    maxLines?: number | undefined;
+}
+interface GlobOptions {
+    ignore?: string[] | undefined;
+    maxResults?: number | undefined;
+}
+interface GrepOptions {
+    caseInsensitive?: boolean | undefined;
+    wholeWord?: boolean | undefined;
+    maxResults?: number | undefined;
+    include?: string | undefined;
+}
+interface WebFetchOptions {
+    url: string;
+    selector?: string | undefined;
+    maxContentLength?: number | undefined;
+    headers?: Record<string, string> | undefined;
+}
+type TextEditorRequest = {
+    command: "view";
+    path: string;
+    startLine?: number | undefined;
+    endLine?: number | undefined;
+} | {
+    command: "create";
+    path: string;
+    fileText: string;
+} | {
+    command: "str_replace";
+    path: string;
+    oldText: string;
+    newText: string;
+    replaceAll?: boolean | undefined;
+} | {
+    command: "insert";
+    path: string;
+    insertLine: number;
+    newText: string;
+};
+type BatchOp = {
+    op: "exec";
+    command: string;
+    cwd?: string;
+    timeoutMs?: number;
+} | {
+    op: "write_file";
+    path: string;
+    content: string;
+    encoding?: "utf8" | "base64";
+} | {
+    op: "read_file";
+    path: string;
+    encoding?: "utf8" | "base64";
+};
+type BatchResult = {
+    success: true;
+    op: "exec";
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+} | {
+    success: true;
+    op: "write_file";
+} | {
+    success: true;
+    op: "read_file";
+    content: string;
+} | {
+    success: false;
+    op: string;
+    error: string;
+};
+interface ToolProviderCapabilities {
+    bash: boolean;
+    fileSystem: boolean;
+    webFetch: boolean;
+    webSearch: boolean;
+    codeExecution: boolean;
+    sandboxed: boolean;
+}
+interface ThreadStatus {
+    threadId: string;
+    isComplete: boolean;
+    exitCode: number | null;
+    output: string;
+    error?: string;
+}
+interface ToolProvider {
+    bash(command: string, options?: BashOptions): Promise<ToolResult>;
+    readFile(path: string, options?: ReadOptions): Promise<ToolResult>;
+    writeFile(path: string, content: string): Promise<ToolResult>;
+    editFile(path: string, oldText: string, newText: string): Promise<ToolResult>;
+    textEditor?: ((request: TextEditorRequest) => Promise<ToolResult>) | undefined;
+    glob(pattern: string, options?: GlobOptions): Promise<ToolResult>;
+    grep(pattern: string, path?: string, options?: GrepOptions): Promise<ToolResult>;
+    webFetch?: ((options: WebFetchOptions) => Promise<ToolResult>) | undefined;
+    webSearch?: ((query: string) => Promise<ToolResult>) | undefined;
+    thread?: ((command: string, options?: BashOptions) => Promise<ToolResult>) | undefined;
+    check?: ((threadId: string) => Promise<ToolResult>) | undefined;
+    cancel?: ((threadId: string) => Promise<ToolResult>) | undefined;
+    activeThreads?: (() => ThreadStatus[]) | undefined;
+    batch?: ((ops: BatchOp[]) => Promise<BatchResult[]>) | undefined;
+    initialize?: (() => Promise<void>) | undefined;
+    destroy?: (() => Promise<void>) | undefined;
+    capabilities(): ToolProviderCapabilities;
+}
+
+type AnyTool = Tool<any, any>;
+
+type ModelFactory = (modelId: string) => LanguageModel;
+
+export type { AnyTool as A, BashOptions as B, GlobOptions as G, ModelFactory as M, ReadOptions as R, ToolProvider as T, WebFetchOptions as W, ToolResult as a, ToolResultArtifact as b, ActionType as c, BatchOp as d, BatchResult as e, GrepOptions as f, TextEditorRequest as g, ThreadStatus as h, ToolProviderCapabilities as i };

package/dist/skills/index.d.ts

@@ -0,0 +1,67 @@
+import { T as ToolProvider, M as ModelFactory } from '../shared-types-DRxnerLT.js';
+import { HarnessTelemetry } from '../observability/otel.js';
+import 'ai';
+
+interface SkillSummary {
+    name: string;
+    description: string;
+    path: string;
+}
+interface SkillDefinition extends SkillSummary {
+    instructions?: string;
+    contextMode?: 'inline' | 'fork';
+    dependencies?: {
+        python?: string[];
+        npm?: string[];
+    };
+}
+interface SkillInvokeResult {
+    skill: SkillSummary;
+    instructions: string;
+    execution?: {
+        attempted: boolean;
+        success: boolean;
+        output: string;
+        error?: string;
+        commandsRun?: number;
+    };
+}
+
+declare class SkillManager {
+    private readonly toolProvider;
+    private readonly telemetry?;
+    private readonly summaries;
+    private readonly fullSkills;
+    private readonly installState;
+    constructor(toolProvider: ToolProvider, telemetry?: HarnessTelemetry | undefined);
+    registerSummary(skill: SkillSummary): void;
+    getSkillSummaryForPrompt(): SkillSummary[];
+    discover(skillIndexPath: string): Promise<SkillSummary[]>;
+    private assertSafeSkillPath;
+    private extractShellBlocks;
+    invoke(name: string, options?: {
+        mode?: 'execute' | 'instructions_only';
+    }): Promise<SkillInvokeResult>;
+    installDependencies(name: string): Promise<void>;
+    getInstallState(name: string): 'ready' | 'degraded' | 'installing' | 'unknown';
+}
+
+declare function loadSkillFromFile(path: string): Promise<SkillDefinition>;
+
+interface SkillRouterConfig {
+    model?: string;
+    createModel?: ModelFactory;
+    minConfidence?: number;
+    aliases?: Record<string, string[]>;
+}
+declare class SkillRouter {
+    private readonly model;
+    private readonly createModel;
+    private readonly minConfidence;
+    private readonly aliases;
+    constructor(config?: SkillRouterConfig);
+    selectSkill(prompt: string, summaries: SkillSummary[]): Promise<SkillSummary | null>;
+    private containsToken;
+}
+
+export { type SkillDefinition, type SkillInvokeResult, SkillManager, SkillRouter, type SkillRouterConfig, type SkillSummary, loadSkillFromFile };

package/dist/skills/index.js

@@ -0,0 +1,282 @@
+import { readFile } from 'fs/promises';
+import { resolve } from 'path';
+import { generateObject } from 'ai';
+import { anthropic } from '@ai-sdk/anthropic';
+import { z } from 'zod';
+
+// src/skills/skill-manager.ts
+
+// src/observability/tracing.ts
+async function traceStep(telemetry, name, attributes, fn) {
+  if (!telemetry?.isEnabled()) {
+    return fn();
+  }
+  return telemetry.withSpan(name, attributes, fn);
+}
+function parseFrontmatter(raw) {
+  if (!raw.startsWith("---\n")) {
+    return { meta: {}, body: raw };
+  }
+  const end = raw.indexOf("\n---\n", 4);
+  if (end === -1) {
+    return { meta: {}, body: raw };
+  }
+  const header = raw.slice(4, end).split("\n");
+  const meta = {};
+  for (const line of header) {
+    const idx = line.indexOf(":");
+    if (idx <= 0) continue;
+    const key = line.slice(0, idx).trim();
+    const value = line.slice(idx + 1).trim().replace(/^"|"$/g, "");
+    meta[key] = value;
+  }
+  return {
+    meta,
+    body: raw.slice(end + 5).trim()
+  };
+}
+async function loadSkillFromFile(path) {
+  const raw = await readFile(path, "utf8");
+  const parsed = parseFrontmatter(raw);
+  const pythonDeps = parsed.meta.python_deps ? parsed.meta.python_deps.split(",").map((item) => item.trim()).filter(Boolean) : [];
+  const npmDeps = parsed.meta.npm_deps ? parsed.meta.npm_deps.split(",").map((item) => item.trim()).filter(Boolean) : [];
+  return {
+    name: parsed.meta.name ?? path.split("/").slice(-2, -1)[0] ?? "unknown-skill",
+    description: parsed.meta.description ?? "No description provided",
+    path,
+    contextMode: parsed.meta.context === "fork" ? "fork" : "inline",
+    dependencies: {
+      python: pythonDeps,
+      npm: npmDeps
+    },
+    instructions: parsed.body
+  };
+}
+
+// src/skills/skill-manager.ts
+function assertSafeDependencyName(dep) {
+  if (!/^[@a-zA-Z0-9._\-/>=<~^]+$/.test(dep)) {
+    throw new Error(`unsafe dependency name: ${dep}`);
+  }
+}
+var SkillManager = class {
+  constructor(toolProvider, telemetry) {
+    this.toolProvider = toolProvider;
+    this.telemetry = telemetry;
+  }
+  summaries = /* @__PURE__ */ new Map();
+  fullSkills = /* @__PURE__ */ new Map();
+  installState = /* @__PURE__ */ new Map();
+  registerSummary(skill) {
+    this.summaries.set(skill.name, skill);
+  }
+  getSkillSummaryForPrompt() {
+    return [...this.summaries.values()];
+  }
+  async discover(skillIndexPath) {
+    const raw = await readFile(skillIndexPath, "utf8");
+    const entries = JSON.parse(raw);
+    for (const entry of entries) {
+      this.registerSummary(entry);
+    }
+    return this.getSkillSummaryForPrompt();
+  }
+  assertSafeSkillPath(path) {
+    if (path.includes("..")) {
+      throw new Error("unsafe skill path");
+    }
+  }
+  extractShellBlocks(instructions) {
+    const blocks = [];
+    const regex = /```(?:bash|sh|shell)\n([\s\S]*?)```/g;
+    let match;
+    while ((match = regex.exec(instructions)) !== null) {
+      const code = (match[1] ?? "").trim();
+      if (code.length > 0) {
+        blocks.push(code);
+      }
+    }
+    return blocks;
+  }
+  async invoke(name, options) {
+    return traceStep(this.telemetry, "skill.exec", { skill: name }, async () => {
+      const summary = this.summaries.get(name);
+      if (!summary) {
+        throw new Error(`unknown skill: ${name}`);
+      }
+      this.assertSafeSkillPath(summary.path);
+      let full = this.fullSkills.get(name);
+      if (!full) {
+        full = await loadSkillFromFile(resolve(summary.path));
+        this.fullSkills.set(name, full);
+      }
+      const mode = options?.mode ?? "execute";
+      if (mode === "instructions_only") {
+        return {
+          skill: summary,
+          instructions: full.instructions ?? "",
+          execution: {
+            attempted: false,
+            success: true,
+            output: "instructions_only mode",
+            commandsRun: 0
+          }
+        };
+      }
+      const shellBlocks = this.extractShellBlocks(full.instructions ?? "");
+      if (shellBlocks.length === 0) {
+        return {
+          skill: summary,
+          instructions: full.instructions ?? "",
+          execution: {
+            attempted: false,
+            success: true,
+            output: "no executable shell blocks found",
+            commandsRun: 0
+          }
+        };
+      }
+      if (this.getInstallState(name) === "unknown") {
+        await this.installDependencies(name);
+      }
+      let aggregateOutput = "";
+      for (const block of shellBlocks) {
+        const result = await this.toolProvider.bash(block);
+        aggregateOutput += result.output;
+        if (!result.success) {
+          return {
+            skill: summary,
+            instructions: full.instructions ?? "",
+            execution: {
+              attempted: true,
+              success: false,
+              output: aggregateOutput,
+              error: result.error || "skill block failed",
+              commandsRun: shellBlocks.length
+            }
+          };
+        }
+      }
+      return {
+        skill: summary,
+        instructions: full.instructions ?? "",
+        execution: {
+          attempted: true,
+          success: true,
+          output: aggregateOutput,
+          commandsRun: shellBlocks.length
+        }
+      };
+    });
+  }
+  async installDependencies(name) {
+    const skill = this.fullSkills.get(name);
+    if (!skill) {
+      throw new Error(`skill must be invoked before install: ${name}`);
+    }
+    this.installState.set(name, "installing");
+    try {
+      const pythonDeps = skill.dependencies?.python ?? [];
+      const npmDeps = skill.dependencies?.npm ?? [];
+      for (const dep of pythonDeps) {
+        assertSafeDependencyName(dep);
+        const result = await this.toolProvider.bash(`pip install '${dep}'`);
+        if (!result.success) {
+          throw new Error(result.error || `pip install failed for ${dep}`);
+        }
+      }
+      for (const dep of npmDeps) {
+        assertSafeDependencyName(dep);
+        const result = await this.toolProvider.bash(`npm install '${dep}'`);
+        if (!result.success) {
+          throw new Error(result.error || `npm install failed for ${dep}`);
+        }
+      }
+      this.installState.set(name, "ready");
+    } catch (error) {
+      this.installState.set(name, "degraded");
+      throw error;
+    }
+  }
+  getInstallState(name) {
+    return this.installState.get(name) ?? "unknown";
+  }
+};
+var routeSchema = z.object({
+  skillName: z.string().nullable(),
+  confidence: z.number().min(0).max(1),
+  rationale: z.string()
+});
+var DEFAULT_ALIASES = {
+  xlsx: ["excel", "spreadsheet", "workbook", "csv"],
+  docx: ["word", "document", "doc"],
+  pptx: ["powerpoint", "slides", "presentation"],
+  "visual-explainer": ["visual explainer", "visual explanation", "interactive visual", "visualize", "diagram d3", "data visualization", "d3"],
+  "excalidraw-diagram": ["excalidraw", "architecture diagram", "flowchart", "sequence diagram"],
+  "json-render": ["jsonrender", "interactive ui", "action buttons"]
+};
+var SkillRouter = class {
+  model;
+  createModel;
+  minConfidence;
+  aliases;
+  constructor(config = {}) {
+    this.model = config.model ?? process.env.HARNESS_SKILL_ROUTER_MODEL ?? "claude-3-5-haiku-latest";
+    this.createModel = config.createModel ?? anthropic;
+    this.minConfidence = config.minConfidence ?? Number(process.env.HARNESS_SKILL_ROUTER_THRESHOLD ?? "0.55");
+    this.aliases = {
+      ...DEFAULT_ALIASES,
+      ...config.aliases ?? {}
+    };
+  }
+  async selectSkill(prompt, summaries) {
+    if (summaries.length === 0) return null;
+    const lower = prompt.toLowerCase();
+    const direct = summaries.find((skill) => this.containsToken(lower, skill.name.toLowerCase()));
+    if (direct) return direct;
+    for (const summary of summaries) {
+      const aliasList = this.aliases[summary.name.toLowerCase()] ?? [];
+      if (aliasList.some((alias) => this.containsToken(lower, alias.toLowerCase()))) {
+        return summary;
+      }
+    }
+    try {
+      const skillList = summaries.map((s) => `- ${s.name}: ${s.description}`).join("\n");
+      const { object } = await generateObject({
+        model: this.createModel(this.model),
+        schema: routeSchema,
+        system: [
+          "You are a skill router.",
+          "Pick at most one skill name from the provided list.",
+          "Only choose a skill when it clearly helps with the user request.",
+          "If nothing clearly matches, return null skillName and low confidence."
+        ].join(" "),
+        prompt: [
+          "User request:",
+          prompt,
+          "",
+          "Available skills:",
+          skillList,
+          "",
+          "Return one object with skillName, confidence, rationale."
+        ].join("\n")
+      });
+      if (!object.skillName || object.confidence < this.minConfidence) {
+        return null;
+      }
+      return summaries.find((s) => s.name === object.skillName) ?? null;
+    } catch {
+      return null;
+    }
+  }
+  containsToken(haystack, needle) {
+    if (!needle) return false;
+    const escaped = needle.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const regex = new RegExp(`\\b${escaped}\\b`, "i");
+    return regex.test(haystack);
+  }
+};
+
+export { SkillManager, SkillRouter, loadSkillFromFile };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/observability/tracing.ts","../../src/skills/skill-loader.ts","../../src/skills/skill-manager.ts","../../src/skills/skill-router.ts"],"names":["readFile","defaultAnthropicProvider"],"mappings":"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","file":"index.js","sourcesContent":["import { HarnessTelemetry } from './otel';\n\nexport async function traceStep<T>(\n  telemetry: HarnessTelemetry | undefined,\n  name: string,\n  attributes: Record<string, string | number | boolean>,\n  fn: () => Promise<T>\n): Promise<T> {\n  if (!telemetry?.isEnabled()) {\n    return fn();\n  }\n  return telemetry.withSpan(name, attributes, fn);\n}\n","import { readFile } from 'node:fs/promises';\n\nimport type { SkillDefinition } from './skill-types';\n\nfunction parseFrontmatter(raw: string): { meta: Record<string, string>; body: string } {\n  if (!raw.startsWith('---\\n')) {\n    return { meta: {}, body: raw };\n  }\n\n  const end = raw.indexOf('\\n---\\n', 4);\n  if (end === -1) {\n    return { meta: {}, body: raw };\n  }\n\n  const header = raw.slice(4, end).split('\\n');\n  const meta: Record<string, string> = {};\n  for (const line of header) {\n    const idx = line.indexOf(':');\n    if (idx <= 0) continue;\n    const key = line.slice(0, idx).trim();\n    const value = line.slice(idx + 1).trim().replace(/^\"|\"$/g, '');\n    meta[key] = value;\n  }\n\n  return {\n    meta,\n    body: raw.slice(end + 5).trim()\n  };\n}\n\nexport async function loadSkillFromFile(path: string): Promise<SkillDefinition> {\n  const raw = await readFile(path, 'utf8');\n  const parsed = parseFrontmatter(raw);\n  const pythonDeps = parsed.meta.python_deps\n    ? parsed.meta.python_deps.split(',').map((item) => item.trim()).filter(Boolean)\n    : [];\n  const npmDeps = parsed.meta.npm_deps\n    ? parsed.meta.npm_deps.split(',').map((item) => item.trim()).filter(Boolean)\n    : [];\n\n  return {\n    name: parsed.meta.name ?? path.split('/').slice(-2, -1)[0] ?? 'unknown-skill',\n    description: parsed.meta.description ?? 'No description provided',\n    path,\n    contextMode: parsed.meta.context === 'fork' ? 'fork' : 'inline',\n    dependencies: {\n      python: pythonDeps,\n      npm: npmDeps\n    },\n    instructions: parsed.body\n  };\n}\n","import { readFile } from 'node:fs/promises';\nimport { resolve } from 'node:path';\n\nimport type { ToolProvider } from '../interfaces/tool-provider';\nimport type { HarnessTelemetry } from '../observability/otel';\nimport { traceStep } from '../observability/tracing';\nimport type { SkillDefinition, SkillInvokeResult, SkillSummary } from './skill-types';\nimport { loadSkillFromFile } from './skill-loader';\n\n/** Validate a dependency name to prevent command injection */\nfunction assertSafeDependencyName(dep: string): void {\n  // Allow: alphanumeric, hyphens, underscores, dots, slashes (scoped packages), @, =, >=, <=, ~, ^\n  // Block: semicolons, pipes, backticks, $(), etc.\n  if (!/^[@a-zA-Z0-9._\\-/>=<~^]+$/.test(dep)) {\n    throw new Error(`unsafe dependency name: ${dep}`);\n  }\n}\n\nexport class SkillManager {\n  private readonly summaries = new Map<string, SkillSummary>();\n  private readonly fullSkills = new Map<string, SkillDefinition>();\n  private readonly installState = new Map<string, 'ready' | 'degraded' | 'installing'>();\n\n  constructor(\n    private readonly toolProvider: ToolProvider,\n    private readonly telemetry?: HarnessTelemetry\n  ) {}\n\n  registerSummary(skill: SkillSummary): void {\n    this.summaries.set(skill.name, skill);\n  }\n\n  getSkillSummaryForPrompt(): SkillSummary[] {\n    return [...this.summaries.values()];\n  }\n\n  async discover(skillIndexPath: string): Promise<SkillSummary[]> {\n    const raw = await readFile(skillIndexPath, 'utf8');\n    const entries = JSON.parse(raw) as Array<{ name: string; description: string; path: string }>;\n    for (const entry of entries) {\n      this.registerSummary(entry);\n    }\n    return this.getSkillSummaryForPrompt();\n  }\n\n  private assertSafeSkillPath(path: string): void {\n    if (path.includes('..')) {\n      throw new Error('unsafe skill path');\n    }\n  }\n\n  private extractShellBlocks(instructions: string): string[] {\n    const blocks: string[] = [];\n    const regex = /```(?:bash|sh|shell)\\n([\\s\\S]*?)```/g;\n    let match: RegExpExecArray | null;\n    while ((match = regex.exec(instructions)) !== null) {\n      const code = (match[1] ?? '').trim();\n      if (code.length > 0) {\n        blocks.push(code);\n      }\n    }\n    return blocks;\n  }\n\n  async invoke(\n    name: string,\n    options?: { mode?: 'execute' | 'instructions_only' }\n  ): Promise<SkillInvokeResult> {\n    return traceStep(this.telemetry, 'skill.exec', { skill: name }, async () => {\n      const summary = this.summaries.get(name);\n      if (!summary) {\n        throw new Error(`unknown skill: ${name}`);\n      }\n\n      this.assertSafeSkillPath(summary.path);\n\n      let full = this.fullSkills.get(name);\n      if (!full) {\n        full = await loadSkillFromFile(resolve(summary.path));\n        this.fullSkills.set(name, full);\n      }\n\n      const mode = options?.mode ?? 'execute';\n      if (mode === 'instructions_only') {\n        return {\n          skill: summary,\n          instructions: full.instructions ?? '',\n          execution: {\n            attempted: false,\n            success: true,\n            output: 'instructions_only mode',\n            commandsRun: 0\n          }\n        };\n      }\n\n      const shellBlocks = this.extractShellBlocks(full.instructions ?? '');\n      if (shellBlocks.length === 0) {\n        return {\n          skill: summary,\n          instructions: full.instructions ?? '',\n          execution: {\n            attempted: false,\n            success: true,\n            output: 'no executable shell blocks found',\n            commandsRun: 0\n          }\n        };\n      }\n\n      if (this.getInstallState(name) === 'unknown') {\n        await this.installDependencies(name);\n      }\n\n      let aggregateOutput = '';\n      for (const block of shellBlocks) {\n        const result = await this.toolProvider.bash(block);\n        aggregateOutput += result.output;\n        if (!result.success) {\n          return {\n            skill: summary,\n            instructions: full.instructions ?? '',\n            execution: {\n              attempted: true,\n              success: false,\n              output: aggregateOutput,\n              error: result.error || 'skill block failed',\n              commandsRun: shellBlocks.length\n            }\n          };\n        }\n      }\n\n      return {\n        skill: summary,\n        instructions: full.instructions ?? '',\n        execution: {\n          attempted: true,\n          success: true,\n          output: aggregateOutput,\n          commandsRun: shellBlocks.length\n        }\n      };\n    });\n  }\n\n  async installDependencies(name: string): Promise<void> {\n    const skill = this.fullSkills.get(name);\n    if (!skill) {\n      throw new Error(`skill must be invoked before install: ${name}`);\n    }\n\n    this.installState.set(name, 'installing');\n\n    try {\n      const pythonDeps = skill.dependencies?.python ?? [];\n      const npmDeps = skill.dependencies?.npm ?? [];\n\n      for (const dep of pythonDeps) {\n        assertSafeDependencyName(dep);\n        const result = await this.toolProvider.bash(`pip install '${dep}'`);\n        if (!result.success) {\n          throw new Error(result.error || `pip install failed for ${dep}`);\n        }\n      }\n\n      for (const dep of npmDeps) {\n        assertSafeDependencyName(dep);\n        const result = await this.toolProvider.bash(`npm install '${dep}'`);\n        if (!result.success) {\n          throw new Error(result.error || `npm install failed for ${dep}`);\n        }\n      }\n\n      this.installState.set(name, 'ready');\n    } catch (error) {\n      this.installState.set(name, 'degraded');\n      throw error;\n    }\n  }\n\n  getInstallState(name: string): 'ready' | 'degraded' | 'installing' | 'unknown' {\n    return this.installState.get(name) ?? 'unknown';\n  }\n}\n","import { generateObject } from 'ai';\nimport { anthropic as defaultAnthropicProvider } from '@ai-sdk/anthropic';\nimport { z } from 'zod';\n\nimport type { SkillSummary } from './skill-types';\nimport type { ModelFactory } from '../arc/types';\n\nconst routeSchema = z.object({\n  skillName: z.string().nullable(),\n  confidence: z.number().min(0).max(1),\n  rationale: z.string()\n});\n\nexport interface SkillRouterConfig {\n  model?: string;\n  createModel?: ModelFactory;\n  minConfidence?: number;\n  aliases?: Record<string, string[]>;\n}\n\nconst DEFAULT_ALIASES: Record<string, string[]> = {\n  xlsx: ['excel', 'spreadsheet', 'workbook', 'csv'],\n  docx: ['word', 'document', 'doc'],\n  pptx: ['powerpoint', 'slides', 'presentation'],\n  'visual-explainer': ['visual explainer', 'visual explanation', 'interactive visual', 'visualize', 'diagram d3', 'data visualization', 'd3'],\n  'excalidraw-diagram': ['excalidraw', 'architecture diagram', 'flowchart', 'sequence diagram'],\n  'json-render': ['jsonrender', 'interactive ui', 'action buttons'],\n};\n\nexport class SkillRouter {\n  private readonly model: string;\n  private readonly createModel: ModelFactory;\n  private readonly minConfidence: number;\n  private readonly aliases: Record<string, string[]>;\n\n  constructor(config: SkillRouterConfig = {}) {\n    this.model = config.model ?? process.env.HARNESS_SKILL_ROUTER_MODEL ?? 'claude-3-5-haiku-latest';\n    this.createModel = config.createModel ?? defaultAnthropicProvider;\n    this.minConfidence = config.minConfidence ?? Number(process.env.HARNESS_SKILL_ROUTER_THRESHOLD ?? '0.55');\n    this.aliases = {\n      ...DEFAULT_ALIASES,\n      ...(config.aliases ?? {})\n    };\n  }\n\n  async selectSkill(prompt: string, summaries: SkillSummary[]): Promise<SkillSummary | null> {\n    if (summaries.length === 0) return null;\n    const lower = prompt.toLowerCase();\n\n    const direct = summaries.find((skill) => this.containsToken(lower, skill.name.toLowerCase()));\n    if (direct) return direct;\n\n    for (const summary of summaries) {\n      const aliasList = this.aliases[summary.name.toLowerCase()] ?? [];\n      if (aliasList.some((alias) => this.containsToken(lower, alias.toLowerCase()))) {\n        return summary;\n      }\n    }\n\n    // LLM-based routing — if no API key is configured, the provider will fail\n    // and the catch block below will return null (graceful fallback).\n\n    try {\n      const skillList = summaries\n        .map((s) => `- ${s.name}: ${s.description}`)\n        .join('\\n');\n\n      const { object } = await generateObject({\n        model: this.createModel(this.model),\n        schema: routeSchema,\n        system: [\n          'You are a skill router.',\n          'Pick at most one skill name from the provided list.',\n          'Only choose a skill when it clearly helps with the user request.',\n          'If nothing clearly matches, return null skillName and low confidence.'\n        ].join(' '),\n        prompt: [\n          'User request:',\n          prompt,\n          '',\n          'Available skills:',\n          skillList,\n          '',\n          'Return one object with skillName, confidence, rationale.'\n        ].join('\\n')\n      });\n\n      if (!object.skillName || object.confidence < this.minConfidence) {\n        return null;\n      }\n\n      return summaries.find((s) => s.name === object.skillName) ?? null;\n    } catch {\n      return null;\n    }\n  }\n\n  private containsToken(haystack: string, needle: string): boolean {\n    if (!needle) return false;\n    const escaped = needle.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n    const regex = new RegExp(`\\\\b${escaped}\\\\b`, 'i');\n    return regex.test(haystack);\n  }\n}\n\n"]}