@adecore/agents 0.27.2 → 0.27.3

package/dist/chat/backend.d.ts

@@ -12,6 +12,7 @@ export interface BackendLaunch {
     generation: number;
     instructions: string | null;
     resumeNote: string | null;
+    resumeInstructions?: string | null;
     goal?: ChatGoal;
     folders?: readonly string[];
     projectConfig?: boolean;

package/dist/chat/chat-core.d.ts

@@ -29,6 +29,7 @@ export interface ChatCoreHooks {
     runtimeModeFor?(chatId: string, mode: RuntimeMode): RuntimeMode;
     instructionsFor?(chatId: string): string | null;
     resumeNoteFor?(chatId: string): string | null;
+    resumeInstructionsFor?(chatId: string): string | null;
     foldersFor?(chatId: string): readonly string[];
     projectConfigFor?(chatId: string): boolean;
     hiddenFor?(chatId: string): boolean;

package/dist/chat/chat-core.js

@@ -306,6 +306,7 @@ export class ChatCore {
             saveGeneratedImage: (ref, upload) => this.attachments.saveGenerated(payload.chatId, ref, upload),
             instructions: () => (this.hooks.instructionsFor ? this.hooks.instructionsFor(payload.chatId) : this.instructions),
             resumeNote: () => this.hooks.resumeNoteFor?.(payload.chatId) ?? null,
+            resumeInstructions: () => this.hooks.resumeInstructionsFor?.(payload.chatId) ?? null,
             folders: () => this.hooks.foldersFor?.(payload.chatId) ?? [],
             projectConfig: () => this.hooks.projectConfigFor?.(payload.chatId) ?? true,
             ...(promptNotes ? { promptNotes } : {}),

package/dist/chat/chat-session.d.ts

@@ -41,6 +41,7 @@ export interface ChatSessionOptions {
     saveGeneratedImage?: BackendLaunch['saveGeneratedImage'];
     instructions?(): string | null;
     resumeNote?(): string | null;
+    resumeInstructions?(): string | null;
     folders?(): readonly string[];
     projectConfig?(): boolean;
     promptNotes?: PromptNotes;

package/dist/chat/chat-session.js

@@ -1629,6 +1629,7 @@ export class ChatSession {
             saveGeneratedImage: this.options.saveGeneratedImage,
             instructions: this.options.instructions?.() ?? null,
             resumeNote: this.options.resumeNote?.() ?? null,
+            resumeInstructions: this.options.resumeInstructions?.() ?? null,
             ...(info.goal === undefined ? {} : { goal: info.goal }),
             ...(folders.length > 0 ? { folders } : {}),
             ...(projectConfig ? {} : { projectConfig }),

package/dist/chat/codex-backend.d.ts

@@ -39,6 +39,7 @@ export declare class CodexBackend implements ChatBackend {
     get pid(): number | null;
     start(): Promise<void>;
     private handshake;
+    private resumeContext;
     private readGoal;
     private turnInput;
     sendTurn(input: TurnInput): void;

package/dist/chat/codex-backend.js

@@ -68,7 +68,7 @@ export class CodexBackend {
     imageWrites = null;
     transport = null;
     threadId = '';
-    // Codex 0.154 ignores developer instructions on `thread/resume` (measured), so the first prompt of a resumed process carries them.
+    // Codex ignores developer instructions on `thread/resume` (measured on 0.154 and 0.163), so the first prompt of a resumed process carries them.
     contextPending = null;
     imageInputSupported = null;
     /* A turn asked for that Codex has not named yet; `turn/interrupt` needs that name. */
@@ -131,7 +131,7 @@ export class CodexBackend {
         if (this.launch.resume) {
             try {
                 result = await transport.request('thread/resume', { threadId: this.launch.resume, excludeTurns: true, ...params });
-                this.contextPending = this.launch.resumeNote;
+                this.contextPending = await this.resumeContext(transport, this.launch.resume);
             }
             catch (error) {
                 // A refusal means the thread is gone from Codex's store and a fresh one keeps the chat usable; a silence or an exit says nothing about the thread.
@@ -156,6 +156,26 @@ export class CodexBackend {
             // An app-server without goals, or with the feature turned off, has none to report.
         });
     }
+    /*
+     * A developer message outranks the thread's first instructions, where a note in front of the prompt loses to
+     * them; an app-server without `thread/inject_items` gets the instructions in front of the prompt after all.
+     */
+    async resumeContext(transport, threadId) {
+        const instructions = this.launch.resumeInstructions ?? null;
+        if (instructions !== null) {
+            try {
+                const items = [{ type: 'message', role: 'developer', content: [{ type: 'input_text', text: instructions }] }];
+                await transport.request('thread/inject_items', { threadId, items });
+            }
+            catch (error) {
+                if (!(error instanceof Error) || error.name !== 'CodexRpcError') {
+                    throw error;
+                }
+                return [instructions, this.launch.resumeNote].filter((part) => part !== null).join('\n\n');
+            }
+        }
+        return this.launch.resumeNote;
+    }
     async readGoal(transport) {
         const result = await transport.request('thread/goal/get', { threadId: this.threadId });
         const goal = codexGoal(isRecord(result) ? result.goal : null);

package/dist/testing/fake-codex.d.ts

@@ -4,6 +4,7 @@ export declare const FAKE_CHILD_STEPS = 250;
 export declare const fakeCodexForks: Frame[];
 export interface FakeCodexOptions {
     resumeLead?: string;
+    injectItems?: boolean;
 }
 export declare function fakeCodexWith(options: FakeCodexOptions): FakeCli;
 export declare const fakeCodex: FakeCli;

package/dist/testing/fake-codex.js

@@ -451,6 +451,22 @@ export function fakeCodexWith(options) {
                     notify('thread/started', { thread });
                     return;
                 }
+                case 'thread/inject_items': {
+                    if (options.injectItems === false) {
+                        out({ id, error: { code: -32601, message: 'unknown method thread/inject_items' } });
+                        return;
+                    }
+                    // The newest developer message is the one the model follows, so `note?` answers with it.
+                    const items = Array.isArray(params.items) ? params.items : [];
+                    for (const injected of items) {
+                        const content = Array.isArray(injected.content) ? injected.content[0] : undefined;
+                        if (injected.role === 'developer' && typeof content?.text === 'string') {
+                            threadInstructions.set(String(params.threadId), content.text);
+                        }
+                    }
+                    out({ id, result: {} });
+                    return;
+                }
                 case 'thread/fork': {
                     const source = String(params.threadId);
                     const turns = threadTurns.get(source) ?? [];

package/package.json

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

package/src/chat/backend.ts

@@ -40,6 +40,9 @@ export interface BackendLaunch {
     // The part of it a resumed thread has to hear again in front of its next prompt, for a CLI that ignores new
     // instructions on a resume; null when there is nothing to repeat.
     resumeNote: string | null;
+    // Instructions a resumed thread takes in as a developer message, for a CLI that keeps the ones its thread started
+    // with; absent or null when the thread holds them already.
+    resumeInstructions?: string | null;
     // The goal the chat last knew of, which a CLI that takes it up again from its own transcript on a resume still works toward.
     goal?: ChatGoal;
     // Folders outside `cwd` the agent may reach without asking. Claude Code takes them as `--add-dir`; Codex's

package/src/chat/chat-core.ts

@@ -119,6 +119,8 @@ export interface ChatCoreHooks {
     instructionsFor?(chatId: string): string | null;
     /* What of the instructions a resumed thread hears again in front of its next prompt, for a CLI that ignores them on a resume. */
     resumeNoteFor?(chatId: string): string | null;
+    /* Instructions a resumed thread takes in again as a developer message, for a CLI that keeps those its thread started with; null when it holds them. */
+    resumeInstructionsFor?(chatId: string): string | null;
     /*
      * Folders outside its working directory a chat's agent may reach without asking, absolute. Asked
      * before every turn, so a host can hand one over for as long as it is needed: a change starts the
@@ -495,6 +497,7 @@ export class ChatCore {
             saveGeneratedImage: (ref, upload) => this.attachments.saveGenerated(payload.chatId, ref, upload),
             instructions: () => (this.hooks.instructionsFor ? this.hooks.instructionsFor(payload.chatId) : this.instructions),
             resumeNote: () => this.hooks.resumeNoteFor?.(payload.chatId) ?? null,
+            resumeInstructions: () => this.hooks.resumeInstructionsFor?.(payload.chatId) ?? null,
             folders: () => this.hooks.foldersFor?.(payload.chatId) ?? [],
             projectConfig: () => this.hooks.projectConfigFor?.(payload.chatId) ?? true,
             ...(promptNotes ? { promptNotes } : {}),

package/src/chat/chat-session.ts

@@ -76,6 +76,7 @@ export interface ChatSessionOptions {
     // What the agent is told at the start of every process, and what of it a resumed thread hears again; see `BackendLaunch`.
     instructions?(): string | null;
     resumeNote?(): string | null;
+    resumeInstructions?(): string | null;
     // The folders beside the working directory, asked before every turn; a change starts the next turn in a new process.
     folders?(): readonly string[];
     // False runs the CLI without the configuration of the working folder; asked before every turn like the folders.
@@ -1876,6 +1877,7 @@ export class ChatSession {
             saveGeneratedImage: this.options.saveGeneratedImage,
             instructions: this.options.instructions?.() ?? null,
             resumeNote: this.options.resumeNote?.() ?? null,
+            resumeInstructions: this.options.resumeInstructions?.() ?? null,
             ...(info.goal === undefined ? {} : { goal: info.goal }),
             ...(folders.length > 0 ? { folders } : {}),
             ...(projectConfig ? {} : { projectConfig }),

package/src/chat/codex-backend.ts

@@ -81,7 +81,7 @@ export class CodexBackend implements ChatBackend {
     private imageWrites: Promise<void> | null = null;
     private transport: CodexTransport | null = null;
     private threadId = '';
-    // Codex 0.154 ignores developer instructions on `thread/resume` (measured), so the first prompt of a resumed process carries them.
+    // Codex ignores developer instructions on `thread/resume` (measured on 0.154 and 0.163), so the first prompt of a resumed process carries them.
     private contextPending: string | null = null;
     private imageInputSupported: boolean | null = null;
     /* A turn asked for that Codex has not named yet; `turn/interrupt` needs that name. */
@@ -148,7 +148,7 @@ export class CodexBackend implements ChatBackend {
         if (this.launch.resume) {
             try {
                 result = await transport.request('thread/resume', { threadId: this.launch.resume, excludeTurns: true, ...params });
-                this.contextPending = this.launch.resumeNote;
+                this.contextPending = await this.resumeContext(transport, this.launch.resume);
             } catch (error) {
                 // A refusal means the thread is gone from Codex's store and a fresh one keeps the chat usable; a silence or an exit says nothing about the thread.
                 if (!(error instanceof Error) || error.name !== 'CodexRpcError') {
@@ -172,6 +172,26 @@ export class CodexBackend implements ChatBackend {
         });
     }
 
+    /*
+     * A developer message outranks the thread's first instructions, where a note in front of the prompt loses to
+     * them; an app-server without `thread/inject_items` gets the instructions in front of the prompt after all.
+     */
+    private async resumeContext(transport: CodexTransport, threadId: string): Promise<string | null> {
+        const instructions = this.launch.resumeInstructions ?? null;
+        if (instructions !== null) {
+            try {
+                const items = [{ type: 'message', role: 'developer', content: [{ type: 'input_text', text: instructions }] }];
+                await transport.request('thread/inject_items', { threadId, items });
+            } catch (error) {
+                if (!(error instanceof Error) || error.name !== 'CodexRpcError') {
+                    throw error;
+                }
+                return [instructions, this.launch.resumeNote].filter((part) => part !== null).join('\n\n');
+            }
+        }
+        return this.launch.resumeNote;
+    }
+
     private async readGoal(transport: CodexTransport): Promise<ChatGoal | null> {
         const result = await transport.request('thread/goal/get', { threadId: this.threadId });
         const goal = codexGoal(isRecord(result) ? result.goal : null);

package/src/testing/fake-codex.ts

@@ -26,6 +26,8 @@ export const fakeCodexForks: Frame[] = [];
 export interface FakeCodexOptions {
     // How the note a host repeats in front of a resumed thread's first prompt starts; `pasted?` answers it back.
     resumeLead?: string;
+    // False answers `thread/inject_items` the way an app-server without it does.
+    injectItems?: boolean;
 }
 
 export function fakeCodexWith(options: FakeCodexOptions): FakeCli {
@@ -490,6 +492,22 @@ export function fakeCodexWith(options: FakeCodexOptions): FakeCli {
                     notify('thread/started', { thread });
                     return;
                 }
+                case 'thread/inject_items': {
+                    if (options.injectItems === false) {
+                        out({ id, error: { code: -32601, message: 'unknown method thread/inject_items' } });
+                        return;
+                    }
+                    // The newest developer message is the one the model follows, so `note?` answers with it.
+                    const items = Array.isArray(params.items) ? (params.items as Frame[]) : [];
+                    for (const injected of items) {
+                        const content = Array.isArray(injected.content) ? (injected.content[0] as { text?: unknown } | undefined) : undefined;
+                        if (injected.role === 'developer' && typeof content?.text === 'string') {
+                            threadInstructions.set(String(params.threadId), content.text);
+                        }
+                    }
+                    out({ id, result: {} });
+                    return;
+                }
                 case 'thread/fork': {
                     const source = String(params.threadId);
                     const turns = threadTurns.get(source) ?? [];