@bluecopa/harness 0.1.0-snapshot.59 → 0.1.0-snapshot.60

package/package.json

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

package/src/arc/arc-loop.ts

@@ -70,7 +70,7 @@ export class ArcLoop {
   private readonly memory: MemoryManager;
   private readonly modelMap: Record<ModelTier, string>;
   private readonly orchestratorModel: string;
-  private readonly systemPrompt: string;
+  private readonly systemPrompt: string | Array<{ text: string; cacheControl?: { type: 'ephemeral' } }>;
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   private readonly cachedSystem: any;
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -102,9 +102,9 @@ export class ArcLoop {
     this.systemPrompt = config.systemPrompt ?? DEFAULT_ORCHESTRATOR_PROMPT;
 
     // AI SDK v6 `system` parameter expects a string or Array<{ type: 'text', text: string }>.
-    // Passing [{ role: 'system', content }] causes 'system.0.text: Input should be a valid string'
-    // from the Anthropic API because the SDK reads `.text` (undefined) instead of `.content`.
-    this.cachedSystem = this.systemPrompt;
+    // Build system param: supports both string and structured blocks with cache control.
+    // Structured blocks are converted to AI SDK v6 SystemModelMessage format.
+    this.cachedSystem = this.buildSystemParam();
 
     this.tools = {
       ...orchestratorTools,
@@ -124,7 +124,9 @@ export class ArcLoop {
     this.ctx = new ContextWindow({
       contextWindowSize: config.contextWindowSize ?? 200_000,
       outputReserve: config.outputReserve ?? 20_000,
-      systemPrompt: this.systemPrompt,
+      systemPrompt: typeof this.systemPrompt === 'string'
+        ? this.systemPrompt
+        : this.systemPrompt.map(b => b.text).join('\n\n'),
       episodeStore: config.episodeStore,
       memory: this.memory,
       taskId: config.taskId,
@@ -144,6 +146,20 @@ export class ArcLoop {
     this.traceWriter?.({ ts: Date.now(), kind });
   }
 
+  /** Build the `system` parameter for streamText. Handles string and structured blocks with cache control. */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  private buildSystemParam(): any {
+    if (typeof this.systemPrompt === 'string') return this.systemPrompt;
+    // Structured blocks → AI SDK v6 SystemModelMessage format
+    return this.systemPrompt.map(block => ({
+      role: 'system' as const,
+      content: block.text,
+      ...(block.cacheControl
+        ? { providerOptions: { anthropic: { cacheControl: block.cacheControl } } }
+        : {}),
+    }));
+  }
+
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   private static extractUsage(usage: any): { inputTokens: number; outputTokens: number; cacheReadTokens?: number; cacheWriteTokens?: number; reasoningTokens?: number } | undefined {
     if (!usage) return undefined;

package/src/arc/types.ts

@@ -57,7 +57,8 @@ export interface ArcLoopConfig {
   /** @deprecated Use createModel instead. Anthropic API key (set via ANTHROPIC_API_KEY env var). */
   apiKey?: string;
   /** Custom orchestrator system prompt */
-  systemPrompt?: string;
+  /** System prompt — string or structured blocks with Anthropic cache control markers. */
+  systemPrompt?: string | Array<{ text: string; cacheControl?: { type: 'ephemeral' } }>;
   /** Max orchestrator turns before stopping (default: 30) */
   maxTurns?: number;
   /** Extra orchestrator tools beyond Thread/Check/Cancel/Remember */