@bluecopa/harness 0.1.0-snapshot.21 → 0.1.0-snapshot.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bluecopa/harness",
-  "version": "0.1.0-snapshot.21",
+  "version": "0.1.0-snapshot.23",
   "description": "Provider-agnostic TypeScript agent framework",
   "license": "UNLICENSED",
   "scripts": {

package/src/arc/agent-runner.ts

@@ -366,6 +366,8 @@ export interface CreateProcessConfig {
   parentSignal: AbortSignal;
   /** Custom system prompt for this process (overrides PROCESS_SYSTEM_PROMPT). */
   processSystemPrompt?: string;
+  /** Async skill instructions to prepend to system prompt (resolved during process startup). */
+  skillPromptPromise?: Promise<string | null>;
 
   // Runtime extras
   hookRunner?: HookRunner;
@@ -421,12 +423,21 @@ export function createProcess(
       process.status = 'running';
       const seed = await seedPromise;
 
+      // Build system prompt: base + optional skill instructions
+      let systemPrompt = config.processSystemPrompt ?? PROCESS_SYSTEM_PROMPT;
+      if (config.skillPromptPromise) {
+        const skillInstructions = await config.skillPromptPromise;
+        if (skillInstructions) {
+          systemPrompt += '\n\n## Skill Instructions\n' + skillInstructions;
+        }
+      }
+
       const result = await Promise.race([
         runner.run({
           model,
           prompt: request.action,
           tools: config.processTools,
-          systemPrompt: config.processSystemPrompt ?? PROCESS_SYSTEM_PROMPT,
+          systemPrompt,
           toolProvider: config.toolProvider,
           maxSteps,
           signal: ac.signal,

package/src/arc/arc-loop.ts

@@ -27,6 +27,9 @@ import { createProcess, firstEvent } from './agent-runner';
 import { EpisodeCompressor } from './episode-compressor';
 import { runConsolidation } from './consolidation';
 import { pickDefined } from './utils';
+import { SkillRouter } from '../skills/skill-router';
+import { loadSkillFromFile } from '../skills/skill-loader';
+import type { SkillSummary } from '../skills/skill-types';
 
 // ── Default orchestrator prompt ──
 
@@ -75,6 +78,9 @@ export class ArcLoop {
   private readonly traceWriter: ((event: TraceEvent) => void) | undefined;
   private readonly tracedRunning = new Set<string>();
   private readonly processListeners: Promise<void>[] = [];
+  private readonly skillRouter: SkillRouter | undefined;
+  private skillSummaries: SkillSummary[] | null = null;
+  private skillSummariesPromise: Promise<SkillSummary[]> | null = null;
 
   constructor(config: ArcLoopConfig) {
     this.config = config;
@@ -114,6 +120,15 @@ export class ArcLoop {
 
     this.resilience = config.resilience;
     this.traceWriter = (config as ArcLoopConfig & { traceWriter?: (event: TraceEvent) => void }).traceWriter;
+
+    if (config.skillIndexPath) {
+      this.skillRouter = new SkillRouter();
+      // Lazy-load skill summaries on first dispatch
+      this.skillSummariesPromise = import('node:fs/promises')
+        .then(fs => fs.readFile(config.skillIndexPath!, 'utf-8'))
+        .then(raw => JSON.parse(raw) as SkillSummary[])
+        .catch(() => []);
+    }
   }
 
   private trace(kind: TraceEvent['kind']): void {
@@ -375,8 +390,10 @@ export class ArcLoop {
             }],
           });
         } else if (this.config.onOrchestratorTool) {
-          await this.config.onOrchestratorTool(call.toolName, call.args);
-          const resultText = `${call.toolName}: handled`;
+          const action = await this.config.onOrchestratorTool(call.toolName, call.args);
+          const resultText = (action && 'content' in action && typeof action.content === 'string')
+            ? action.content
+            : `${call.toolName}: handled`;
           toolResultMessages.push({
             role: 'tool',
             content: resultText,
@@ -457,6 +474,12 @@ export class ArcLoop {
       this.modelMap,
       this.modelMap.medium,
     );
+
+    // Resolve skill instructions only when skills are configured
+    const skillPromptPromise = this.skillRouter
+      ? this.resolveSkillPrompt(request.action)
+      : undefined;
+
     const proc = createProcess(request, {
       toolProvider: this.config.toolProvider,
       episodeStore: this.config.episodeStore,
@@ -469,6 +492,7 @@ export class ArcLoop {
       // eslint-disable-next-line @typescript-eslint/no-explicit-any
       processTools: (profile?.tools ?? this.config.processTools ?? builtinTools) as any,
       processSystemPrompt: profile?.systemPrompt ?? this.config.processSystemPrompt,
+      skillPromptPromise,
       parentSignal,
       ...pickDefined(this.config, [
         'hookRunner',
@@ -483,6 +507,28 @@ export class ArcLoop {
     return proc;
   }
 
+  /** Resolve skill instructions for a process action. Returns null if no skill matched. */
+  private async resolveSkillPrompt(action: string): Promise<string | null> {
+    if (!this.skillRouter || !this.skillSummariesPromise) return null;
+
+    // Ensure summaries are loaded
+    if (!this.skillSummaries) {
+      this.skillSummaries = await this.skillSummariesPromise;
+    }
+    if (this.skillSummaries.length === 0) return null;
+
+    // Fast match only (keyword + alias, no LLM call)
+    const matched = await this.skillRouter.selectSkill(action, this.skillSummaries);
+    if (!matched) return null;
+
+    try {
+      const skill = await loadSkillFromFile(matched.path);
+      return skill.instructions || null;
+    } catch {
+      return null;
+    }
+  }
+
   private traceProcessRunning(procId: string): void {
     if (!this.tracedRunning.has(procId)) {
       this.tracedRunning.add(procId);