@adecore/agents 0.48.3 → 0.48.4

package/dist/chat/claude-backend.js

@@ -3,6 +3,7 @@ import { errorText } from '../error-text.js';
 import { claudeArgs, claudeEnv, promptPrefix } from '../providers/claude.js';
 import { ChatChild, MAX_LINE_LENGTH, readStreamLines } from './chat-process.js';
 import { ClaudeProtocol } from './claude-protocol.js';
+import { claudeSystemPromptArgs } from './claude-system-prompt.js';
 import { buildUserMessage } from './input.js';
 // Claude may echo a steer only once a slow tool returns, so a running turn sets no deadline; after the turn ended, a message
 // it still holds opens the next turn at once or never arrives.
@@ -57,7 +58,12 @@ export class ClaudeBackend {
             })
         ];
         if (this.launch.instructions !== null) {
-            args.push('--append-system-prompt', this.launch.instructions);
+            try {
+                args.push(...claudeSystemPromptArgs(this.launch.instructions));
+            }
+            catch (error) {
+                return Promise.reject(error instanceof Error ? error : new Error(errorText(error)));
+            }
         }
         this.stdinClosed = false;
         const child = new ChatChild({

package/dist/chat/claude-system-prompt.d.ts

@@ -0,0 +1 @@
+export declare function claudeSystemPromptArgs(instructions: string, platform?: NodeJS.Platform, folder?: string): string[];

package/dist/chat/claude-system-prompt.js

@@ -0,0 +1,18 @@
+import { createHash } from 'node:crypto';
+import { writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+/*
+ * The flags that hand Claude its system prompt. npm installs the CLI as a batch file on Windows, and
+ * a line through cmd.exe holds no line break and stops near 8 KB, so there the prompt goes in a file.
+ * The name follows the content, so chats with the same prompt share one file and no chat removes it from under another.
+ */
+export function claudeSystemPromptArgs(instructions, platform = process.platform, folder = tmpdir()) {
+    if (platform !== 'win32') {
+        return ['--append-system-prompt', instructions];
+    }
+    const digest = createHash('sha256').update(instructions).digest('hex').slice(0, 32);
+    const path = join(folder, `adecore-claude-prompt-${digest}.md`);
+    writeFileSync(path, instructions, { mode: 0o600 });
+    return ['--append-system-prompt-file', path];
+}

package/dist/testing/fake-claude.js

@@ -3,7 +3,7 @@
  * compaction, edits, subagents, interrupts and crashes through the real frame shapes.
  */
 import { spawn } from 'node:child_process';
-import { writeFileSync } from 'node:fs';
+import { readFileSync, writeFileSync } from 'node:fs';
 import { resolve } from 'node:path';
 export function fakeClaude(io) {
     const args = io.argv;
@@ -938,7 +938,8 @@ export function fakeClaude(io) {
         }
         if (text === 'system?') {
             const at = args.indexOf('--append-system-prompt');
-            assistantText(at >= 0 ? args[at + 1] : 'none');
+            const fileAt = args.indexOf('--append-system-prompt-file');
+            assistantText(at >= 0 ? args[at + 1] : fileAt >= 0 ? readFileSync(args[fileAt + 1], 'utf8') : 'none');
             result();
             return;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adecore/agents",
-  "version": "0.48.3",
+  "version": "0.48.4",
   "description": "Node-compatible agent chat hosts, providers, accounts, usage and durable task coordination.",
   "type": "module",
   "exports": {
@@ -93,8 +93,8 @@
     "test": "bun --conditions=source test"
   },
   "dependencies": {
-    "@adecore/agent-contracts": "0.48.3",
-    "@adecore/intelligent-ui": "0.48.3",
+    "@adecore/agent-contracts": "0.48.4",
+    "@adecore/intelligent-ui": "0.48.4",
     "zod": "^4.6.7"
   },
   "devDependencies": {

package/src/chat/claude-backend.ts

@@ -4,6 +4,7 @@ import { claudeArgs, claudeEnv, promptPrefix } from '../providers/claude.ts';
 import type { ApprovalDecision, BackendHost, BackendLaunch, ChatBackend, TurnInput } from './backend.ts';
 import { ChatChild, MAX_LINE_LENGTH, readStreamLines } from './chat-process.ts';
 import { ClaudeProtocol } from './claude-protocol.ts';
+import { claudeSystemPromptArgs } from './claude-system-prompt.ts';
 import { buildUserMessage } from './input.ts';
 
 // Claude may echo a steer only once a slow tool returns, so a running turn sets no deadline; after the turn ended, a message
@@ -72,7 +73,11 @@ export class ClaudeBackend implements ChatBackend {
         ];
 
         if (this.launch.instructions !== null) {
-            args.push('--append-system-prompt', this.launch.instructions);
+            try {
+                args.push(...claudeSystemPromptArgs(this.launch.instructions));
+            } catch (error) {
+                return Promise.reject(error instanceof Error ? error : new Error(errorText(error)));
+            }
         }
 
         this.stdinClosed = false;

package/src/chat/claude-system-prompt.ts

@@ -0,0 +1,22 @@
+import { createHash } from 'node:crypto';
+import { writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+
+/*
+ * The flags that hand Claude its system prompt. npm installs the CLI as a batch file on Windows, and
+ * a line through cmd.exe holds no line break and stops near 8 KB, so there the prompt goes in a file.
+ * The name follows the content, so chats with the same prompt share one file and no chat removes it from under another.
+ */
+export function claudeSystemPromptArgs(instructions: string, platform: NodeJS.Platform = process.platform, folder: string = tmpdir()): string[] {
+    if (platform !== 'win32') {
+        return ['--append-system-prompt', instructions];
+    }
+
+    const digest = createHash('sha256').update(instructions).digest('hex').slice(0, 32);
+    const path = join(folder, `adecore-claude-prompt-${digest}.md`);
+
+    writeFileSync(path, instructions, { mode: 0o600 });
+
+    return ['--append-system-prompt-file', path];
+}

package/src/testing/fake-claude.ts

@@ -3,7 +3,7 @@
  * compaction, edits, subagents, interrupts and crashes through the real frame shapes.
  */
 import { spawn } from 'node:child_process';
-import { writeFileSync } from 'node:fs';
+import { readFileSync, writeFileSync } from 'node:fs';
 import { resolve } from 'node:path';
 import type { FakeCli, FakeIo, FakeProgram } from './fake-cli.ts';
 
@@ -1113,7 +1113,8 @@ export function fakeClaude(io: FakeIo): FakeProgram {
 
         if (text === 'system?') {
             const at = args.indexOf('--append-system-prompt');
-            assistantText(at >= 0 ? args[at + 1]! : 'none');
+            const fileAt = args.indexOf('--append-system-prompt-file');
+            assistantText(at >= 0 ? args[at + 1]! : fileAt >= 0 ? readFileSync(args[fileAt + 1]!, 'utf8') : 'none');
             result();
 
             return;