@tangle-network/agent-profile-materialize 1.0.2 → 1.1.1

package/dist/harness-prompt.d.ts

@@ -16,3 +16,5 @@ import type { HarnessId } from "./harness.js";
 export declare function keepsHarnessSystemPrompt(profile: AgentProfile | undefined, harness: HarnessId | string | undefined): boolean;
 /** Join prompt additions in order, skipping empty ones. */
 export declare function joinSystemPromptAdditions(...additions: Array<string | undefined>): string | undefined;
+/** Native inline context has a bounded argument; long context belongs in resources.files. */
+export declare function codexDeveloperInstructionArgs(value: string | undefined, flags?: readonly string[]): string[];

package/dist/harness-prompt.js

@@ -27,13 +27,12 @@ const HARNESSES_WITH_ADDITIVE_HOST_PROMPT = new Set(["claude-code", "pi", "openc
  */
 export function keepsHarnessSystemPrompt(profile, harness) {
     const prompt = profile?.prompt;
-    if (!prompt || prompt.systemPrompt !== undefined)
+    if (!profile || prompt?.systemPrompt !== undefined)
         return false;
-    const declaresIntent = (prompt.instructions?.length ?? 0) > 0 ||
-        prompt.appendSystemPrompt !== undefined;
-    return (declaresIntent &&
-        harness !== undefined &&
-        HARNESSES_WITH_ADDITIVE_HOST_PROMPT.has(harness));
+    return (HARNESSES_WITH_ADDITIVE_HOST_PROMPT.has(harness ?? "") &&
+        ((prompt?.instructions?.length ?? 0) > 0 ||
+            prompt?.appendSystemPrompt !== undefined ||
+            (harness === "codex" && profile.resources?.instructions !== undefined)));
 }
 /** Join prompt additions in order, skipping empty ones. */
 export function joinSystemPromptAdditions(...additions) {
@@ -42,3 +41,21 @@ export function joinSystemPromptAdditions(...additions) {
         .filter((addition) => Boolean(addition));
     return parts.length > 0 ? parts.join("\n\n") : undefined;
 }
+/** Native inline context has a bounded argument; long context belongs in resources.files. */
+export function codexDeveloperInstructionArgs(value, flags = []) {
+    if (value === undefined)
+        return [];
+    if (flags.some((flag, index) => {
+        const selector = ["-c", "--config"].includes(flags[index - 1] ?? "")
+            ? flag
+            : /^(?:--config=|-c=?)(.+)$/su.exec(flag)?.[1];
+        return (selector &&
+            /^(?:developer_instructions\s*=|["'])/u.test(selector.trimStart()));
+    }))
+        throw new Error("Codex context conflicts with a caller configuration override; put developer_instructions in the AgentProfile and use unquoted configuration keys");
+    const encoded = `developer_instructions=${JSON.stringify(value)}`;
+    // This is the adapter's portable inline budget, not an OS capacity claim.
+    if (Buffer.byteLength(encoded, "utf8") > 64 * 1024)
+        throw new Error("Codex inline context is too large; move long context into profile.resources.files and keep prompt.instructions short");
+    return ["-c", encoded];
+}

package/dist/plan-types.d.ts

@@ -148,8 +148,10 @@ export declare function assertSkippableDimensions(skip: readonly string[] | unde
  * guarantee — so the plan refuses the intent (harnessSystemPromptIntents in
  * @tangle-network/agent-interface answers `replace: false` for opencode).
  *
- * The two declarations describe the two executor shapes that CAN reach it, and
- * each gets the lowering it can actually apply:
+ * The replacement declarations describe the executor shapes that can reach it;
+ * each gets the lowering it can apply. Codex launchers separately declare
+ * `codex.developer-instructions` to consume ordinary instructions as additive
+ * context; undeclared callers retain workspace files:
  *
  *   - `systemPrompt` — the executor applies the plan's launch flags to the
  *     spawn it owns, so the plan writes the generated `mode: primary` agent and
@@ -159,10 +161,10 @@ export declare function assertSkippableDimensions(skip: readonly string[] | unde
  *     plan hands the text over in {@link WorkspacePlan.systemPromptBinding}
  *     instead of writing a workspace agent that would never be selected.
  *
- * They are mutually exclusive claims about the same caller: declaring both is a
+ * The replacement declarations are mutually exclusive: declaring both is a
  * caller bug, not a broader capability.
  */
-export declare const BINDABLE_LAUNCH_CONTROLS: readonly ["systemPrompt", "opencode.agent-prompt"];
+export declare const BINDABLE_LAUNCH_CONTROLS: readonly ["systemPrompt", "codex.developer-instructions", "opencode.agent-prompt"];
 export type BindableLaunchControl = (typeof BINDABLE_LAUNCH_CONTROLS)[number];
 /** Reject a binding declaration this materializer has no lowering for, rather than ignoring it. */
 export declare function assertBindableLaunchControls(binds: readonly string[] | undefined): ReadonlySet<BindableLaunchControl>;
@@ -188,15 +190,13 @@ export interface WorkspacePlan {
      */
     systemPrompt?: string;
     /**
-     * Exact text ADDED to the harness's own system prompt, which stays intact.
+     * Text added to the harness context; its own system prompt stays intact.
      *
-     * Separate from {@link WorkspacePlan.systemPrompt} because the two are
-     * different intents against the same channel, and every harness that has one
-     * control may lack the other. An executor binds this ONLY to an additive
-     * control (claude-code `--append-system-prompt`, pi
-     * `--append-system-prompt`); there is no harness for which folding it into
-     * the replacement is correct, because that would delete the built-in prompt
-     * the caller asked to keep.
+     * Claude Code and Pi bind their additive system-prompt control. Codex binds
+     * ordinary profile instructions to developer_instructions, composed once
+     * with host context; this is not a privileged system-prompt append. Authored
+     * Codex appendSystemPrompt remains unsupported. Never fold this into an exact
+     * system-prompt replacement, which carries the caller's unchanged bytes.
      */
     appendSystemPrompt?: string;
     /**

package/dist/plan-types.js

@@ -52,8 +52,10 @@ export function assertSkippableDimensions(skip) {
  * guarantee — so the plan refuses the intent (harnessSystemPromptIntents in
  * @tangle-network/agent-interface answers `replace: false` for opencode).
  *
- * The two declarations describe the two executor shapes that CAN reach it, and
- * each gets the lowering it can actually apply:
+ * The replacement declarations describe the executor shapes that can reach it;
+ * each gets the lowering it can apply. Codex launchers separately declare
+ * `codex.developer-instructions` to consume ordinary instructions as additive
+ * context; undeclared callers retain workspace files:
  *
  *   - `systemPrompt` — the executor applies the plan's launch flags to the
  *     spawn it owns, so the plan writes the generated `mode: primary` agent and
@@ -63,11 +65,12 @@ export function assertSkippableDimensions(skip) {
  *     plan hands the text over in {@link WorkspacePlan.systemPromptBinding}
  *     instead of writing a workspace agent that would never be selected.
  *
- * They are mutually exclusive claims about the same caller: declaring both is a
+ * The replacement declarations are mutually exclusive: declaring both is a
  * caller bug, not a broader capability.
  */
 export const BINDABLE_LAUNCH_CONTROLS = [
     "systemPrompt",
+    "codex.developer-instructions",
     ...EXECUTOR_SYSTEM_PROMPT_BINDINGS,
 ];
 const BINDABLE_LAUNCH_CONTROL_SET = new Set(BINDABLE_LAUNCH_CONTROLS);

package/dist/profile-prompt.js

@@ -70,10 +70,7 @@ export function lowerProfilePrompt(profile, harness, binds, instructionsRoot, bu
             unsupported("appendSystemPrompt", appendSystemPromptRefusal(harness));
         }
     }
-    const instructions = [];
-    if (profile.prompt?.instructions?.length) {
-        instructions.push(...profile.prompt.instructions);
-    }
+    const instructions = [...(profile.prompt?.instructions ?? [])];
     const resourceInstructions = profile.resources?.instructions;
     if (typeof resourceInstructions === "string") {
         instructions.push(resourceInstructions);
@@ -85,7 +82,12 @@ export function lowerProfilePrompt(profile, harness, binds, instructionsRoot, bu
         unsupported("instructions", "instruction ref is not inline (github refs need async pre-resolution)");
     }
     if (instructions.length) {
-        if (openCodeConfigUnreachable) {
+        if (harness === "codex" && binds.has("codex.developer-instructions")) {
+            // Codex's developer channel composes profile context without replacing
+            // repository AGENTS.md or the harness's own system instructions.
+            plan.appendSystemPrompt = instructions.join("\n\n");
+        }
+        else if (openCodeConfigUnreachable) {
             unsupported("instructions", "opencode: the launcher that binds opencode.agent-prompt composes opencode's config itself and loads no workspace opencode.json, so an instruction file registered there would never reach the model; compose it into the launcher's own instructions[]");
         }
         else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-profile-materialize",
-  "version": "1.0.2",
+  "version": "1.1.1",
   "description": "Materialize an AgentProfile into the native per-harness workspace files (the one shared materializer for cli-bridge, agent-container, and VB).",
   "type": "module",
   "repository": {
@@ -35,8 +35,8 @@
     "@tangle-network/agent-interface": "^3.0.0 || ^4.0.0 || ^5.0.0"
   },
   "tangleRelease": {
-    "sourceSha": "0f6ba1deca15d9e117553eae67ff01cae6425004",
-    "mergedAt": "2026-10-27T04:36:51-06:00"
+    "sourceSha": "978d63826f9678b70d7e77f21742d4d99b91e580",
+    "mergedAt": "2026-10-27T06:00:15-06:00"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",