@tangle-network/agent-profile-materialize 0.17.3 → 0.18.1

package/dist/harness.d.ts

@@ -72,12 +72,27 @@ export declare const MATERIALIZER_RESERVED_PATHS: ReadonlySet<string>;
  * one is worse than refusing the turn.
  */
 export declare const MATERIALIZER_OWNED_PATHS: ReadonlySet<string>;
+/** Mark one generated native agent file without changing its harness meaning. */
+export declare function markMaterializerSubagent(relPath: string, content: string): string;
+/**
+ * Whether a generated file occupies a path that the profile materializer owns.
+ *
+ * Generated native agent files come from the active profile.
+ * The active profile must replace the prior profile version at the same path.
+ * Otherwise, a profile update stops every resumed session before launch.
+ * Explicit resources at these paths stay shared.
+ * The plan builder applies ownership only when the source is `generated`.
+ * An output marker proves ownership before replacement.
+ */
+export declare function isMaterializerOwnedPath(relPath: string): boolean;
 /** The top-level keys this package writes into `opencode.json`. */
 export declare const OPENCODE_CONFIG_KEYS: ReadonlySet<string>;
 /**
  * Whether the file already at owned path `relPath` is this package's own
- * earlier output. A reserved name proves that by itself, so `content` is read
- * only for `opencode.json`; `undefined` content means no regular file is there.
+ * earlier output. A reserved name proves that by itself. Native agent files
+ * require the generated marker. An exact unmarked copy of the planned file is
+ * adopted once for upgrades from materializer versions without that marker.
+ * `undefined` content means no regular file is there.
  *
  * An `opencode.json` this package wrote holds the opencode schema id, only the
  * keys this package writes, and only instruction paths this package invented.
@@ -85,7 +100,7 @@ export declare const OPENCODE_CONFIG_KEYS: ReadonlySet<string>;
  * and is replaced too; a config with any other key, or with an instruction path
  * of the user's own, is refused.
  */
-export declare function isMaterializerOutput(relPath: string, content: () => string | undefined): boolean;
+export declare function isMaterializerOutput(relPath: string, content: () => string | undefined, plannedContent?: string): boolean;
 /**
  * cwd-relative native skill dir per harness, or null if the harness has no
  * cwd skill primitive (skills live in a user/global dir the workspace plan

package/dist/harness.js

@@ -142,6 +142,40 @@ export const MATERIALIZER_OWNED_PATHS = new Set([
     ...MATERIALIZER_RESERVED_PATHS,
     OPENCODE_CONFIG_FILE,
 ]);
+const MATERIALIZER_SUBAGENT_PATH = /^(?:(?:\.claude|\.opencode|\.gemini)\/agents\/[a-z0-9][a-z0-9_-]*\.md|\.codex\/agents\/[a-z0-9][a-z0-9_-]*\.toml)$/u;
+const MATERIALIZER_SUBAGENT_MARKER = "# tangle-agent-profile-materialize: generated";
+function materializerSubagentMarkerPrefix(relPath) {
+    return relPath.endsWith(".toml")
+        ? `${MATERIALIZER_SUBAGENT_MARKER}\n`
+        : `---\n${MATERIALIZER_SUBAGENT_MARKER}\n`;
+}
+/** Mark one generated native agent file without changing its harness meaning. */
+export function markMaterializerSubagent(relPath, content) {
+    if (!MATERIALIZER_SUBAGENT_PATH.test(relPath)) {
+        throw new Error(`Not a native agent path: ${relPath}`);
+    }
+    if (relPath.endsWith(".toml")) {
+        return `${materializerSubagentMarkerPrefix(relPath)}${content}`;
+    }
+    if (!content.startsWith("---\n")) {
+        throw new Error(`Native Markdown agent has no frontmatter: ${relPath}`);
+    }
+    return `${materializerSubagentMarkerPrefix(relPath)}${content.slice(4)}`;
+}
+/**
+ * Whether a generated file occupies a path that the profile materializer owns.
+ *
+ * Generated native agent files come from the active profile.
+ * The active profile must replace the prior profile version at the same path.
+ * Otherwise, a profile update stops every resumed session before launch.
+ * Explicit resources at these paths stay shared.
+ * The plan builder applies ownership only when the source is `generated`.
+ * An output marker proves ownership before replacement.
+ */
+export function isMaterializerOwnedPath(relPath) {
+    return (MATERIALIZER_OWNED_PATHS.has(relPath) ||
+        MATERIALIZER_SUBAGENT_PATH.test(relPath));
+}
 /** The top-level keys this package writes into `opencode.json`. */
 export const OPENCODE_CONFIG_KEYS = new Set([
     "$schema",
@@ -152,8 +186,10 @@ export const OPENCODE_CONFIG_KEYS = new Set([
 ]);
 /**
  * Whether the file already at owned path `relPath` is this package's own
- * earlier output. A reserved name proves that by itself, so `content` is read
- * only for `opencode.json`; `undefined` content means no regular file is there.
+ * earlier output. A reserved name proves that by itself. Native agent files
+ * require the generated marker. An exact unmarked copy of the planned file is
+ * adopted once for upgrades from materializer versions without that marker.
+ * `undefined` content means no regular file is there.
  *
  * An `opencode.json` this package wrote holds the opencode schema id, only the
  * keys this package writes, and only instruction paths this package invented.
@@ -161,9 +197,25 @@ export const OPENCODE_CONFIG_KEYS = new Set([
  * and is replaced too; a config with any other key, or with an instruction path
  * of the user's own, is refused.
  */
-export function isMaterializerOutput(relPath, content) {
+export function isMaterializerOutput(relPath, content, plannedContent) {
     if (MATERIALIZER_RESERVED_PATHS.has(relPath))
         return true;
+    if (MATERIALIZER_SUBAGENT_PATH.test(relPath)) {
+        const existing = content();
+        if (existing === undefined)
+            return false;
+        const markerPrefix = materializerSubagentMarkerPrefix(relPath);
+        if (existing.startsWith(markerPrefix))
+            return true;
+        if (plannedContent === undefined)
+            return false;
+        if (!plannedContent.startsWith(markerPrefix))
+            return false;
+        const legacyContent = relPath.endsWith(".toml")
+            ? plannedContent.slice(markerPrefix.length)
+            : `---\n${plannedContent.slice(markerPrefix.length)}`;
+        return existing === legacyContent;
+    }
     if (relPath !== OPENCODE_CONFIG_FILE)
         return false;
     const bytes = content();

package/dist/profile-plan.js

@@ -1,4 +1,4 @@
-import { MATERIALIZER_OWNED_PATHS, MATERIALIZER_RESERVED_PATHS, } from "./harness.js";
+import { isMaterializerOwnedPath, MATERIALIZER_RESERVED_PATHS, } from "./harness.js";
 import { workspacePlanConfigValue } from "./plan-json.js";
 import { mergeJsonFiles } from "./plan-normalize.js";
 import { formatUnsupported } from "./plan-support.js";
@@ -24,7 +24,7 @@ export function createProfilePlanBuilder(harness) {
             relPath: normalizedPath,
             content,
             source,
-            ...(source === "generated" && MATERIALIZER_OWNED_PATHS.has(normalizedPath)
+            ...(source === "generated" && isMaterializerOwnedPath(normalizedPath)
                 ? { ownership: "materializer" }
                 : {}),
             ...(fileMode === undefined ? {} : { mode: validateFileMode(fileMode) }),

package/dist/profile-prompt.js

@@ -1,4 +1,4 @@
-import { appendSystemPromptRefusal, CODEX_SYSTEM_PROMPT_FILE, CONTEXT_FILE, OPENCODE_APPEND_SYSTEM_PROMPT_FILE, OPENCODE_CONFIG_FILE, OPENCODE_CONFIG_SCHEMA, OPENCODE_PRIMARY_AGENT_PREFIX, systemPromptRefusal, } from "./harness.js";
+import { appendSystemPromptRefusal, CODEX_SYSTEM_PROMPT_FILE, CONTEXT_FILE, markMaterializerSubagent, OPENCODE_APPEND_SYSTEM_PROMPT_FILE, OPENCODE_CONFIG_FILE, OPENCODE_CONFIG_SCHEMA, OPENCODE_PRIMARY_AGENT_PREFIX, systemPromptRefusal, } from "./harness.js";
 import { sha256 } from "./plan-digest.js";
 import { serializeWorkspacePlanJson } from "./plan-json.js";
 export function lowerProfilePrompt(profile, harness, binds, builder) {
@@ -34,7 +34,7 @@ export function lowerProfilePrompt(profile, harness, binds, builder) {
                     throw new Error(`opencode: subagent name "${primaryAgentName}" is reserved for the profile primary agent`);
                 }
                 plan.systemPrompt = systemPrompt;
-                add(primaryAgentPath, ["---", "mode: primary", "---", systemPrompt, ""].join("\n"));
+                add(primaryAgentPath, markMaterializerSubagent(primaryAgentPath, ["---", "mode: primary", "---", systemPrompt, ""].join("\n")));
                 plan.flags.push("--agent", primaryAgentName);
             }
             else {

package/dist/subagents.js

@@ -27,7 +27,8 @@ export function materializeSubagent(h, name, sa, plan, add, unsupported) {
                 fm.push(`maxTurns: ${sa.maxSteps}`);
             reportUnsupportedSubagentFields(h, name, sa, new Set(["description", "prompt", "model", "tools", "maxSteps"]), unsupported);
             fm.push("---", "", sa.prompt ?? sa.description ?? name);
-            add(`.claude/agents/${name}.md`, `${fm.join("\n")}\n`);
+            const relPath = `.claude/agents/${name}.md`;
+            add(relPath, markMaterializerSubagent(relPath, `${fm.join("\n")}\n`));
             break;
         }
         case "opencode": {
@@ -53,7 +54,8 @@ export function materializeSubagent(h, name, sa, plan, add, unsupported) {
                 "maxSteps",
             ]), unsupported);
             fm.push("---", "", sa.prompt ?? "");
-            add(`.opencode/agents/${name}.md`, `${fm.join("\n")}\n`);
+            const relPath = `.opencode/agents/${name}.md`;
+            add(relPath, markMaterializerSubagent(relPath, `${fm.join("\n")}\n`));
             break;
         }
         case "gemini": {
@@ -63,7 +65,8 @@ export function materializeSubagent(h, name, sa, plan, add, unsupported) {
                     .map(([tool]) => tool)
                 : undefined;
             reportUnsupportedSubagentFields(h, name, sa, new Set(["description", "prompt", "model", "tools", "maxSteps"]), unsupported);
-            add(`.gemini/agents/${name}.md`, [
+            const relPath = `.gemini/agents/${name}.md`;
+            add(relPath, markMaterializerSubagent(relPath, [
                 "---",
                 `name: ${name}`,
                 `description: ${JSON.stringify(sa.description ?? name)}`,
@@ -75,7 +78,7 @@ export function materializeSubagent(h, name, sa, plan, add, unsupported) {
                 "",
                 sa.prompt ?? "",
                 "",
-            ].join("\n"));
+            ].join("\n")));
             break;
         }
         case "codex": {
@@ -88,7 +91,7 @@ export function materializeSubagent(h, name, sa, plan, add, unsupported) {
             if (sa.model)
                 lines.push(`model = ${tomlStr(sa.model)}`);
             reportUnsupportedSubagentFields(h, name, sa, new Set(["description", "prompt", "model"]), unsupported);
-            add(relPath, `${lines.join("\n")}\n`);
+            add(relPath, markMaterializerSubagent(relPath, `${lines.join("\n")}\n`));
             registerCodexAgent(plan, name, relPath, sa.description ?? name);
             break;
         }
@@ -130,4 +133,5 @@ function reportUnsupportedSubagentFields(harness, name, subagent, supported, uns
         }
     }
 }
+import { markMaterializerSubagent } from "./harness.js";
 import { tomlStr } from "./plan-json.js";

package/dist/workspace-apply.js

@@ -62,7 +62,7 @@ export function applyResolvedWorkspacePlan(publicPlan, resolvedPlan, workspaceDi
     // the workspace, not authorship.
     const mayReplace = (file) => existingFiles === "allow-identical" &&
         file.ownership === "materializer" &&
-        isMaterializerOutput(file.relPath, () => regularFileContent(file.absPath));
+        isMaterializerOutput(file.relPath, () => regularFileContent(file.absPath), file.content);
     // Validate the complete plan before the first write so a late traversal or
     // existing symlink cannot leave a partially materialized workspace.
     for (const file of filesToApply) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-profile-materialize",
-  "version": "0.17.3",
+  "version": "0.18.1",
   "description": "Materialize an AgentProfile into the native per-harness workspace files (the one shared materializer for cli-bridge, agent-dev-container, and VB).",
   "type": "module",
   "main": "./dist/index.js",
@@ -20,13 +20,13 @@
     "dist"
   ],
   "devDependencies": {
-    "@tangle-network/agent-interface": "1.0.0",
+    "@tangle-network/agent-interface": "2.0.0",
     "@types/node": "25.6.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10"
   },
   "peerDependencies": {
-    "@tangle-network/agent-interface": "^1.0.0"
+    "@tangle-network/agent-interface": "^1.0.0 || ^2.0.0"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",