@tangle-network/agent-profile-materialize 0.8.0 → 0.9.1

package/dist/index.d.ts

@@ -22,7 +22,9 @@
  * cli-bridge and agent-dev-container — this is the single source those re-export.
  */
 import type { AgentCandidateConfigValue, AgentCandidateProfile, AgentCandidateProfileActivation, AgentCandidateProfileApplication, AgentCandidateProfilePlanEvidence, AgentCandidateProfilePlanMaterial, AgentProfile, AgentProfileMcpServer, Sha256Digest } from "@tangle-network/agent-interface";
-export type HarnessId = "claude-code" | "claude" | "claudish" | "nanoclaw" | "codex" | "opencode" | "kimi-code" | "kimi" | "pi" | "gemini" | "hermes" | "openclaw";
+export declare const MATERIALIZER_HARNESSES: readonly ["claude-code", "nanoclaw", "codex", "opencode", "kimi-code", "pi", "gemini", "hermes", "openclaw"];
+export type HarnessId = (typeof MATERIALIZER_HARNESSES)[number];
+export declare function isMaterializerHarness(harness: string): harness is HarnessId;
 export interface PlanFile {
     relPath: string;
     content: string;
@@ -157,9 +159,8 @@ export declare function harnessContextFile(harness: HarnessId): string;
 export declare const HARNESS_SKILL_DIRS: Readonly<Record<HarnessId, string | null>>;
 /**
  * Resolve the cwd-relative directory `resources.skills` refs materialize
- * into on `harness` (after alias canonicalization: claude/claudish →
- * claude-code, kimi → kimi-code). `null` means the harness cannot receive
- * cwd skills — the same condition that surfaces as an `unsupported`
+ * into on `harness`. `null` means the harness cannot receive cwd skills, the
+ * same condition that surfaces as an `unsupported`
  * "skills" entry (and an {@link assertWorkspacePlanSupported} throw) at
  * materialize time, exposed here as branchable data.
  */
@@ -170,7 +171,10 @@ export interface ResolveAgentProfileResourcesOptions {
     fetch?: typeof globalThis.fetch;
     timeoutMs?: number;
 }
-/** Resolve every GitHub resource to exact inline bytes before materialization. */
+/**
+ * Resolve every GitHub resource to exact inline bytes before materialization.
+ * The profile's default harness does not affect resource resolution.
+ */
 export declare function resolveAgentProfileResources(inputProfile: AgentProfile, options?: ResolveAgentProfileResourcesOptions): Promise<AgentProfile>;
 /** Normalize any skill markdown (VB frontmatter `skill:`/`description:`, or raw) into a
  *  harness SKILL.md with `name:`/`description:` frontmatter the harnesses require. */
@@ -178,6 +182,7 @@ export declare function normalizeSkillMd(name: string, raw: string): string;
 /**
  * Build the WorkspacePlan for `profile` on `harness`. Pure — no IO. The caller
  * writes plan.files into the run cwd and applies plan.env/plan.flags to the spawn.
+ * The explicit target harness takes precedence over the profile's default.
  */
 export declare function materializeProfile(inputProfile: AgentProfile, harness: HarnessId, opts?: {
     skip?: Unsupported["dimension"][];

package/dist/index.js

@@ -54,6 +54,26 @@ function resolveInlineRef(ref) {
     }
     return null; // github / unresolved
 }
+export const MATERIALIZER_HARNESSES = [
+    "claude-code",
+    "nanoclaw",
+    "codex",
+    "opencode",
+    "kimi-code",
+    "pi",
+    "gemini",
+    "hermes",
+    "openclaw",
+];
+const MATERIALIZER_HARNESS_SET = new Set(MATERIALIZER_HARNESSES);
+export function isMaterializerHarness(harness) {
+    return MATERIALIZER_HARNESS_SET.has(harness);
+}
+function assertMaterializerHarness(harness) {
+    if (!isMaterializerHarness(harness)) {
+        throw new Error(`Unsupported profile materialization harness "${harness}"`);
+    }
+}
 /** The plan was applied, but one or more private staging files remain. */
 export class WorkspacePlanCleanupError extends AggregateError {
     receipt;
@@ -97,7 +117,8 @@ export function enforceWorkspacePlanSupport(plan, failOnError) {
  * lowering below, and the interactive TUI's persona fold.
  */
 export function harnessAutoLoadsContextFile(harness) {
-    return canonicalHarness(harness) !== "opencode";
+    assertMaterializerHarness(harness);
+    return harness !== "opencode";
 }
 /**
  * The project context file this harness reads from cwd — its stable, documented
@@ -107,11 +128,12 @@ export function harnessAutoLoadsContextFile(harness) {
  * of this per-harness map.
  */
 export function harnessContextFile(harness) {
+    assertMaterializerHarness(harness);
     // The map is keyed by HarnessId, but callers reach this from runtime strings
     // (a registry spec name, a request field). A miss would otherwise return
     // undefined behind a `string` return type and surface as an undefined write
     // path much later.
-    const path = CONTEXT_FILE[canonicalHarness(harness)];
+    const path = CONTEXT_FILE[harness];
     if (!path) {
         throw new Error(`No project context file is known for harness "${harness}"`);
     }
@@ -120,13 +142,10 @@ export function harnessContextFile(harness) {
 /** Project context file each harness actually reads from cwd. NEVER a constant. */
 const CONTEXT_FILE = {
     "claude-code": "CLAUDE.md",
-    claude: "CLAUDE.md",
-    claudish: "CLAUDE.md",
     nanoclaw: "CLAUDE.md",
     codex: "AGENTS.md",
     opencode: ".opencode/profile-instructions.md",
     "kimi-code": "AGENTS.md",
-    kimi: "AGENTS.md",
     pi: "AGENTS.md",
     gemini: "GEMINI.md", // current default; AGENTS.md only via .gemini/settings.json context.fileName
     hermes: "HERMES.md", // highest-priority native name; only ONE context loads (first match)
@@ -142,13 +161,10 @@ const CONTEXT_FILE = {
  */
 export const HARNESS_SKILL_DIRS = {
     "claude-code": ".claude/skills",
-    claude: ".claude/skills",
-    claudish: ".claude/skills",
     nanoclaw: ".claude/skills",
     codex: ".codex/skills",
     opencode: ".opencode/skills",
     "kimi-code": ".kimi/skills",
-    kimi: ".kimi/skills",
     pi: ".pi/skills",
     gemini: ".gemini/skills",
     hermes: null, // skills are ~/.hermes/skills (user) only — no cwd discovery
@@ -157,21 +173,14 @@ export const HARNESS_SKILL_DIRS = {
 const SKILL_DIR = HARNESS_SKILL_DIRS;
 /**
  * Resolve the cwd-relative directory `resources.skills` refs materialize
- * into on `harness` (after alias canonicalization: claude/claudish →
- * claude-code, kimi → kimi-code). `null` means the harness cannot receive
- * cwd skills — the same condition that surfaces as an `unsupported`
+ * into on `harness`. `null` means the harness cannot receive cwd skills, the
+ * same condition that surfaces as an `unsupported`
  * "skills" entry (and an {@link assertWorkspacePlanSupported} throw) at
  * materialize time, exposed here as branchable data.
  */
 export function skillDirForHarness(harness) {
-    return HARNESS_SKILL_DIRS[canonicalHarness(harness)];
-}
-function canonicalHarness(h) {
-    if (h === "claude" || h === "claudish")
-        return "claude-code";
-    if (h === "kimi")
-        return "kimi-code";
-    return h;
+    assertMaterializerHarness(harness);
+    return HARNESS_SKILL_DIRS[harness];
 }
 // ─── Helpers ────────────────────────────────────────────────────────────────
 const FRONTMATTER_RE = /^---\n([\s\S]*?)\n---\n?([\s\S]*)$/;
@@ -283,7 +292,10 @@ function validateFileMode(mode) {
     }
     return normalized;
 }
-/** Resolve every GitHub resource to exact inline bytes before materialization. */
+/**
+ * Resolve every GitHub resource to exact inline bytes before materialization.
+ * The profile's default harness does not affect resource resolution.
+ */
 export async function resolveAgentProfileResources(inputProfile, options = {}) {
     const profile = agentProfileSchema.parse(inputProfile);
     const resources = profile.resources;
@@ -429,10 +441,12 @@ const tomlStr = (s) => JSON.stringify(s); // valid TOML basic string
 /**
  * Build the WorkspacePlan for `profile` on `harness`. Pure — no IO. The caller
  * writes plan.files into the run cwd and applies plan.env/plan.flags to the spawn.
+ * The explicit target harness takes precedence over the profile's default.
  */
 export function materializeProfile(inputProfile, harness, opts = {}) {
+    assertMaterializerHarness(harness);
     const profile = agentProfileSchema.parse(inputProfile);
-    const h = canonicalHarness(harness);
+    const h = harness;
     const skip = new Set(opts.skip ?? []);
     const plan = {
         harness: h,
@@ -637,14 +651,7 @@ function activeMcpServers(servers) {
     return Object.fromEntries(Object.entries(servers ?? {}).filter((entry) => entry[1].enabled !== false));
 }
 function extensionNamespaces(harness) {
-    switch (harness) {
-        case "claude-code":
-            return ["claude-code", "claude"];
-        case "kimi-code":
-            return ["kimi-code", "kimi"];
-        default:
-            return [harness];
-    }
+    return [harness];
 }
 /**
  * Materialize a sealed candidate profile without weakening its process values.
@@ -652,6 +659,7 @@ function extensionNamespaces(harness) {
  * argv, and environment values separately. Other hook formats fail closed.
  */
 export function materializeCandidateProfile(profile, harness, opts = {}) {
+    assertMaterializerHarness(harness);
     const candidate = agentCandidateProfileSchema.parse(profile);
     verifyCandidateInlineResources(candidate);
     const hookLowering = lowerCandidateHooks(candidate.hooks, harness);
@@ -692,7 +700,7 @@ export function materializeCandidateProfile(profile, harness, opts = {}) {
 function lowerCandidateHooks(hooks, harness) {
     if (!hooks || Object.keys(hooks).length === 0)
         return { wrapperFiles: [] };
-    const nativeHarness = canonicalHarness(harness);
+    const nativeHarness = harness;
     if (nativeHarness !== "codex" && nativeHarness !== "claude-code") {
         return {
             wrapperFiles: [],
@@ -939,7 +947,7 @@ export function hashWorkspacePlan(plan) {
     const env = Object.fromEntries(Object.entries(plan.env).sort(([a], [b]) => compareStrings(a, b)));
     const unsupported = [...plan.unsupported].sort((a, b) => compareStrings(`${a.dimension}\0${a.reason}`, `${b.dimension}\0${b.reason}`));
     const canonical = JSON.stringify({
-        harness: canonicalHarness(plan.harness),
+        harness: plan.harness,
         files,
         env,
         flags: [...plan.flags],
@@ -954,7 +962,7 @@ export function hashWorkspacePlan(plan) {
 export function agentCandidateProfilePlanMaterial(plan) {
     const material = {
         sourceProfileDigest: plan.sourceProfileDigest,
-        harness: canonicalHarness(plan.harness),
+        harness: plan.harness,
         files: normalizePlanFiles(plan.files).map((file) => ({
             relPath: file.relPath,
             mode: file.mode,
@@ -1884,7 +1892,7 @@ const GEMINI_HOOK_EVENTS = new Set([
     "SessionStart",
 ]);
 function hookEventSupported(harness, event) {
-    switch (canonicalHarness(harness)) {
+    switch (harness) {
         case "claude-code":
             return CLAUDE_HOOK_EVENTS.has(event);
         case "codex":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/agent-profile-materialize",
-  "version": "0.8.0",
+  "version": "0.9.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",
@@ -16,12 +16,12 @@
     "dist"
   ],
   "dependencies": {
-    "@tangle-network/agent-interface": "0.33.0"
+    "@tangle-network/agent-interface": "0.35.0"
   },
   "devDependencies": {
     "@types/node": "25.6.0",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.5"
+    "vitest": "^4.1.10"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",