@agentxm/client-core 0.1.6

package/dist/src/unstable/subagents/rendering/adapters/roo.js

@@ -0,0 +1,125 @@
+/**
+ * Roo Code adapter for subagent rendering.
+ *
+ * For: Roo Code.
+ * Produces a mode entry for `.roomodes` (project scope) or
+ * `settings/custom_modes.yaml` (user scope).
+ *
+ * The mode entry is a data structure — the actual file read-modify-write
+ * is handled separately.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import { mapModelTier } from "../model-mapping.js";
+import { mapToolAccess } from "../tool-access-mapping.js";
+/** The JSON managed marker field value. */
+const AXM_MANAGED_VALUE = "axm subagents --help";
+/** Default groups when tool access mapping returns no groups. */
+const DEFAULT_GROUPS = ["read", "edit", "command", "mcp"];
+/**
+ * Extract groups from tool access fields, falling back to default.
+ */
+const extractGroups = (fields) => {
+    const groups = fields["groups"];
+    if (Array.isArray(groups)) {
+        return groups.filter((g) => typeof g === "string");
+    }
+    return DEFAULT_GROUPS;
+};
+/**
+ * Split a body into roleDefinition (first paragraph) and customInstructions (rest).
+ *
+ * The first paragraph is everything up to the first blank line (two consecutive newlines).
+ * If there is no blank line, the entire body becomes roleDefinition and
+ * customInstructions is empty.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const splitBody = (body) => {
+    const blankLineIndex = body.indexOf("\n\n");
+    if (blankLineIndex === -1) {
+        return { roleDefinition: body.trim(), customInstructions: "" };
+    }
+    return {
+        roleDefinition: body.slice(0, blankLineIndex).trim(),
+        customInstructions: body.slice(blankLineIndex + 2).trim(),
+    };
+};
+/**
+ * Build a Roo Code mode entry from a subagent render input.
+ *
+ * This is a pure function that produces the data structure.
+ * The caller is responsible for merging it into `.roomodes` or
+ * `settings/custom_modes.yaml`.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const buildRooModeEntry = (input) => {
+    const warnings = [];
+    const { roleDefinition, customInstructions } = splitBody(input.body);
+    // Model — Roo has no model field
+    const modelResult = mapModelTier(input.model, "roo-code");
+    if (modelResult.warning !== undefined) {
+        warnings.push(modelResult.warning);
+    }
+    // Tool access → groups
+    const toolResult = mapToolAccess(input.toolAccess, "roo-code");
+    warnings.push(...toolResult.warnings);
+    const groups = extractGroups(toolResult.fields);
+    // Background — Roo does not support background mode
+    if (input.background === true) {
+        warnings.push({
+            agent: "roo-code",
+            feature: "background",
+            message: "Roo Code does not support background mode; background: true will be ignored",
+        });
+    }
+    const entry = {
+        slug: input.name,
+        name: input.name,
+        roleDefinition,
+        ...(customInstructions.length > 0 ? { customInstructions } : {}),
+        groups,
+        description: input.description,
+        _axm_managed: AXM_MANAGED_VALUE,
+        ...input.agentOverrides,
+    };
+    return { entry, warnings };
+};
+/**
+ * Merge AXM-managed mode entries into an existing modes array.
+ *
+ * Preserves manually-defined modes (those without `_axm_managed`),
+ * updates existing AXM-managed modes with matching slug, and adds
+ * new AXM-managed modes.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const mergeRooModes = (existingModes, managedEntry) => {
+    const result = [];
+    let replaced = false;
+    for (const mode of existingModes) {
+        if (mode["slug"] === managedEntry.slug && mode["_axm_managed"] !== undefined) {
+            // Replace existing AXM-managed mode with same slug
+            result.push(managedEntry);
+            replaced = true;
+        }
+        else {
+            result.push(mode);
+        }
+    }
+    if (!replaced) {
+        result.push(managedEntry);
+    }
+    return result;
+};
+/**
+ * Remove an AXM-managed mode entry by slug from a modes array.
+ *
+ * Only removes entries that have the `_axm_managed` field.
+ * Manual modes with the same slug are preserved.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const removeRooMode = (existingModes, slug) => existingModes.filter((mode) => !(mode["slug"] === slug && mode["_axm_managed"] !== undefined));
+//# sourceMappingURL=roo.js.map

package/dist/src/unstable/subagents/rendering/adapters/roo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roo.js","sourceRoot":"","sources":["../../../../../../src/unstable/subagents/rendering/adapters/roo.ts"],"names":[],"mappings":"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"}

package/dist/src/unstable/subagents/rendering/adapters/toml.d.ts

@@ -0,0 +1,17 @@
+/**
+ * TOML adapter for subagent rendering.
+ *
+ * For: Codex.
+ * Produces `.toml` with managed-by marker comment, `name`, `description`,
+ * `developer_instructions`, `model`, and `sandbox_mode` fields.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import { type SubagentRenderInput, type SubagentRenderOutcome } from "../types.js";
+/**
+ * Render a subagent as TOML for Codex.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const renderToml: (input: SubagentRenderInput) => SubagentRenderOutcome;
+//# sourceMappingURL=toml.d.ts.map

package/dist/src/unstable/subagents/rendering/adapters/toml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toml.d.ts","sourceRoot":"","sources":["../../../../../../src/unstable/subagents/rendering/adapters/toml.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,OAAO,EAAY,KAAK,mBAAmB,EAAE,KAAK,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAiB7F;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,mBAAmB,KAAG,qBAuDvD,CAAC"}

package/dist/src/unstable/subagents/rendering/adapters/toml.js

@@ -0,0 +1,79 @@
+/**
+ * TOML adapter for subagent rendering.
+ *
+ * For: Codex.
+ * Produces `.toml` with managed-by marker comment, `name`, `description`,
+ * `developer_instructions`, `model`, and `sandbox_mode` fields.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+import { generateMarker } from "../../../extensions/managed-marker.js";
+import { mapModelTier } from "../model-mapping.js";
+import { mapToolAccess } from "../tool-access-mapping.js";
+import { rendered } from "../types.js";
+const decodeRenderedFilePath = Schema.decodeUnknownSync(Schema.String.pipe(Schema.brand("RenderedFilePath")));
+/**
+ * Escape a string value for TOML.
+ * Uses triple-quoted strings for multiline content, regular quotes otherwise.
+ */
+const tomlStringValue = (value) => {
+    if (value.includes("\n")) {
+        return `"""\n${value.replace(/"""/g, '"\\"\\""')}"""`;
+    }
+    return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+};
+/**
+ * Render a subagent as TOML for Codex.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const renderToml = (input) => {
+    const warnings = [];
+    const marker = generateMarker("subagents", "toml");
+    const lines = [marker, ""];
+    lines.push(`name = ${tomlStringValue(input.name)}`);
+    lines.push(`description = ${tomlStringValue(input.description)}`);
+    // Model mapping
+    const modelResult = mapModelTier(input.model, "codex");
+    if (modelResult.value !== undefined) {
+        lines.push(`model = ${tomlStringValue(modelResult.value)}`);
+    }
+    if (modelResult.warning !== undefined) {
+        warnings.push(modelResult.warning);
+    }
+    // Tool access mapping (maps to sandbox_mode)
+    const toolResult = mapToolAccess(input.toolAccess, "codex");
+    for (const [key, value] of Object.entries(toolResult.fields)) {
+        lines.push(`${key} = ${tomlStringValue(String(value))}`);
+    }
+    warnings.push(...toolResult.warnings);
+    // Background — Codex does not support background mode
+    if (input.background === true) {
+        warnings.push({
+            agent: "codex",
+            feature: "background",
+            message: "Codex does not support background mode; background: true will be ignored",
+        });
+    }
+    // Developer instructions (body)
+    lines.push(`developer_instructions = ${tomlStringValue(input.body)}`);
+    // Apply agent-specific overrides — override any fields set above
+    if (input.agentOverrides !== undefined) {
+        for (const [key, value] of Object.entries(input.agentOverrides)) {
+            // Find and replace existing line, or append
+            const prefix = `${key} = `;
+            const existingIdx = lines.findIndex((l) => l.startsWith(prefix));
+            const line = `${key} = ${tomlStringValue(String(value))}`;
+            if (existingIdx !== -1) {
+                lines[existingIdx] = line;
+            }
+            else {
+                lines.push(line);
+            }
+        }
+    }
+    const path = decodeRenderedFilePath(`.codex/agents/${input.name}.toml`);
+    return rendered([{ content: lines.join("\n"), path }], warnings);
+};
+//# sourceMappingURL=toml.js.map

package/dist/src/unstable/subagents/rendering/adapters/toml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toml.js","sourceRoot":"","sources":["../../../../../../src/unstable/subagents/rendering/adapters/toml.ts"],"names":[],"mappings":"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"}

package/dist/src/unstable/subagents/rendering/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Subagent rendering engine.
+ *
+ * Maps agent IDs to format-family renderers and handles Kiro dual-format.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type { AgentOverrides, SubagentRenderInput, SubagentRenderOutput, SubagentRenderOutcome, SubagentRendered, SubagentSkipped, SubagentRenderer, } from "./types.js";
+export { rendered, skipped } from "./types.js";
+export type { ModelMappingResult } from "./model-mapping.js";
+export { mapModelTier } from "./model-mapping.js";
+export type { ToolAccessMappingResult } from "./tool-access-mapping.js";
+export { mapToolAccess } from "./tool-access-mapping.js";
+export { renderMarkdownYaml } from "./adapters/markdown-yaml.js";
+export { renderToml } from "./adapters/toml.js";
+export { renderJson } from "./adapters/json.js";
+export { buildRooModeEntry, mergeRooModes, removeRooMode, splitBody, type RooModeEntry, type RooModeResult, } from "./adapters/roo.js";
+import type { SubagentRenderInput, SubagentRenderOutcome, SubagentRenderer } from "./types.js";
+/**
+ * Select the appropriate renderer for an agent ID.
+ *
+ * Returns undefined for agents that need special handling (roo-code).
+ * Handles Kiro dual-format internally.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const selectSubagentRenderer: (agentId: string) => SubagentRenderer | undefined;
+/**
+ * Render a subagent for a given agent ID.
+ *
+ * Delegates to the appropriate format-family renderer.
+ * Returns undefined for roo-code (which requires special read-modify-write handling).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const renderSubagent: (input: SubagentRenderInput) => SubagentRenderOutcome | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/unstable/subagents/rendering/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/subagents/rendering/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE/C,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,SAAS,EACT,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,mBAAmB,CAAC;AAK3B,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA4C/F;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,MAAM,KAAG,gBAAgB,GAAG,SAI3E,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,mBAAmB,KAAG,qBAAqB,GAAG,SAInF,CAAC"}

package/dist/src/unstable/subagents/rendering/index.js

@@ -0,0 +1,83 @@
+/**
+ * Subagent rendering engine.
+ *
+ * Maps agent IDs to format-family renderers and handles Kiro dual-format.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export { rendered, skipped } from "./types.js";
+export { mapModelTier } from "./model-mapping.js";
+export { mapToolAccess } from "./tool-access-mapping.js";
+export { renderMarkdownYaml } from "./adapters/markdown-yaml.js";
+export { renderToml } from "./adapters/toml.js";
+export { renderJson } from "./adapters/json.js";
+export { buildRooModeEntry, mergeRooModes, removeRooMode, splitBody, } from "./adapters/roo.js";
+import { renderMarkdownYaml } from "./adapters/markdown-yaml.js";
+import { renderToml } from "./adapters/toml.js";
+import { renderJson } from "./adapters/json.js";
+import { rendered } from "./types.js";
+/**
+ * Map of agent IDs to their subagent renderer function.
+ *
+ * Kiro is handled specially (dual-format) and is not in this map.
+ * Roo Code is also special (mode entry, not file) and is not in this map.
+ */
+const rendererMap = {
+    "claude-code": renderMarkdownYaml,
+    "github-copilot": renderMarkdownYaml,
+    cursor: renderMarkdownYaml,
+    "gemini-cli": renderMarkdownYaml,
+    opencode: renderMarkdownYaml,
+    augment: renderMarkdownYaml,
+    junie: renderMarkdownYaml,
+    "kilo-code": renderMarkdownYaml,
+    codex: renderToml,
+    "kiro-cli": renderJson,
+};
+/**
+ * Render a subagent for Kiro — produces two files (IDE .md + CLI .json).
+ *
+ * The IDE format uses the Markdown+YAML adapter; the CLI format uses
+ * the JSON adapter.
+ */
+const renderKiroDualFormat = (input) => {
+    const ideInput = { ...input, agentId: "kiro" };
+    const cliInput = { ...input, agentId: "kiro" };
+    const ideResult = renderMarkdownYaml(ideInput);
+    const cliResult = renderJson(cliInput);
+    if (ideResult._tag === "Skipped")
+        return ideResult;
+    if (cliResult._tag === "Skipped")
+        return cliResult;
+    return rendered([...ideResult.outputs, ...cliResult.outputs], [...ideResult.warnings, ...cliResult.warnings]);
+};
+/**
+ * Select the appropriate renderer for an agent ID.
+ *
+ * Returns undefined for agents that need special handling (roo-code).
+ * Handles Kiro dual-format internally.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const selectSubagentRenderer = (agentId) => {
+    if (agentId === "kiro")
+        return renderKiroDualFormat;
+    if (agentId === "roo-code")
+        return undefined;
+    return rendererMap[agentId] ?? renderMarkdownYaml;
+};
+/**
+ * Render a subagent for a given agent ID.
+ *
+ * Delegates to the appropriate format-family renderer.
+ * Returns undefined for roo-code (which requires special read-modify-write handling).
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const renderSubagent = (input) => {
+    const renderer = selectSubagentRenderer(input.agentId);
+    if (renderer === undefined)
+        return undefined;
+    return renderer(input);
+};
+//# sourceMappingURL=index.js.map

package/dist/src/unstable/subagents/rendering/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/unstable/subagents/rendering/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,SAAS,GAGV,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;GAKG;AACH,MAAM,WAAW,GAA+C;IAC9D,aAAa,EAAE,kBAAkB;IACjC,gBAAgB,EAAE,kBAAkB;IACpC,MAAM,EAAE,kBAAkB;IAC1B,YAAY,EAAE,kBAAkB;IAChC,QAAQ,EAAE,kBAAkB;IAC5B,OAAO,EAAE,kBAAkB;IAC3B,KAAK,EAAE,kBAAkB;IACzB,WAAW,EAAE,kBAAkB;IAC/B,KAAK,EAAE,UAAU;IACjB,UAAU,EAAE,UAAU;CACvB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,oBAAoB,GAAG,CAAC,KAA0B,EAAyB,EAAE;IACjF,MAAM,QAAQ,GAAwB,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IACpE,MAAM,QAAQ,GAAwB,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAEpE,MAAM,SAAS,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAEvC,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACnD,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAEnD,OAAO,QAAQ,CACb,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,EAC5C,CAAC,GAAG,SAAS,CAAC,QAAQ,EAAE,GAAG,SAAS,CAAC,QAAQ,CAAC,CAC/C,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,OAAe,EAAgC,EAAE;IACtF,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,oBAAoB,CAAC;IACpD,IAAI,OAAO,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC;IAC7C,OAAO,WAAW,CAAC,OAAO,CAAC,IAAI,kBAAkB,CAAC;AACpD,CAAC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAA0B,EAAqC,EAAE;IAC9F,MAAM,QAAQ,GAAG,sBAAsB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7C,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzB,CAAC,CAAC"}

package/dist/src/unstable/subagents/rendering/model-mapping.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Model tier mapping for subagent rendering.
+ *
+ * Maps portable model tiers to agent-native model values.
+ * Concrete model IDs pass through verbatim.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import type { LossyRenderingWarning } from "../../commands/rendering-warnings.js";
+/**
+ * Result of mapping a portable model tier to an agent-native value.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface ModelMappingResult {
+    /** The agent-native model value, or undefined if the field should be omitted. */
+    readonly value: string | undefined;
+    /** Optional warning for lossy mappings. */
+    readonly warning: LossyRenderingWarning | undefined;
+}
+/**
+ * Map a portable model tier (or concrete model ID) to an agent-native value.
+ *
+ * - Portable tiers are looked up in the mapping table.
+ * - Concrete model IDs pass through verbatim (unless the agent has no model field).
+ * - Roo Code always omits the model field with a warning.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const mapModelTier: (model: string | undefined, agentId: string) => ModelMappingResult;
+//# sourceMappingURL=model-mapping.d.ts.map

package/dist/src/unstable/subagents/rendering/model-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-mapping.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/subagents/rendering/model-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAOlF;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,SAAS,CAAC;CACrD;AAiFD;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,GAAG,SAAS,EAAE,SAAS,MAAM,KAAG,kBA+BzE,CAAC"}

package/dist/src/unstable/subagents/rendering/model-mapping.js

@@ -0,0 +1,127 @@
+/**
+ * Model tier mapping for subagent rendering.
+ *
+ * Maps portable model tiers to agent-native model values.
+ * Concrete model IDs pass through verbatim.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+/**
+ * Portable model tiers recognized by the mapping table.
+ */
+const PORTABLE_TIERS = new Set(["fast", "default", "powerful", "inherit"]);
+/**
+ * Per-agent mapping tables for portable model tiers.
+ *
+ * Values:
+ * - string: emit this value
+ * - undefined: omit the model field
+ *
+ * Agents not in this table do not support model fields and will
+ * always produce a warning.
+ */
+const MODEL_TIER_TABLE = {
+    "claude-code": {
+        fast: "haiku",
+        default: "inherit",
+        powerful: "opus",
+        inherit: "inherit",
+    },
+    "github-copilot": {
+        fast: undefined,
+        default: undefined,
+        powerful: undefined,
+        inherit: undefined,
+    },
+    codex: {
+        fast: undefined,
+        default: undefined,
+        powerful: undefined,
+        inherit: undefined,
+    },
+    cursor: {
+        fast: "fast",
+        default: "inherit",
+        powerful: "claude-sonnet-4-20250514",
+        inherit: "inherit",
+    },
+    "gemini-cli": {
+        fast: "gemini-3-flash-preview",
+        default: "inherit",
+        powerful: "gemini-2.5-pro",
+        inherit: "inherit",
+    },
+    opencode: {
+        fast: undefined,
+        default: undefined,
+        powerful: undefined,
+        inherit: undefined,
+    },
+    augment: {
+        fast: undefined,
+        default: undefined,
+        powerful: undefined,
+        inherit: undefined,
+    },
+    junie: {
+        fast: undefined,
+        default: undefined,
+        powerful: "opus",
+        inherit: undefined,
+    },
+    "kilo-code": {
+        fast: undefined,
+        default: undefined,
+        powerful: undefined,
+        inherit: undefined,
+    },
+    kiro: {
+        fast: undefined,
+        default: undefined,
+        powerful: undefined,
+        inherit: undefined,
+    },
+    "roo-code": {
+        fast: undefined,
+        default: undefined,
+        powerful: undefined,
+        inherit: undefined,
+    },
+};
+/**
+ * Map a portable model tier (or concrete model ID) to an agent-native value.
+ *
+ * - Portable tiers are looked up in the mapping table.
+ * - Concrete model IDs pass through verbatim (unless the agent has no model field).
+ * - Roo Code always omits the model field with a warning.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const mapModelTier = (model, agentId) => {
+    // No model specified — omit
+    if (model === undefined) {
+        return { value: undefined, warning: undefined };
+    }
+    // Roo Code has no model field
+    if (agentId === "roo-code") {
+        return {
+            value: undefined,
+            warning: model !== "default" && model !== "inherit"
+                ? {
+                    agent: agentId,
+                    feature: "model",
+                    message: `Roo Code does not support model configuration; "${model}" will be ignored`,
+                }
+                : undefined,
+        };
+    }
+    const agentTable = MODEL_TIER_TABLE[agentId];
+    // Known portable tier
+    if (PORTABLE_TIERS.has(model)) {
+        const value = agentTable?.[model];
+        return { value, warning: undefined };
+    }
+    // Concrete model ID — pass through verbatim
+    return { value: model, warning: undefined };
+};
+//# sourceMappingURL=model-mapping.js.map

package/dist/src/unstable/subagents/rendering/model-mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-mapping.js","sourceRoot":"","sources":["../../../../../src/unstable/subagents/rendering/model-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;GAEG;AACH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;AAc3E;;;;;;;;;GASG;AACH,MAAM,gBAAgB,GAA2E;IAC/F,aAAa,EAAE;QACb,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,SAAS;QAClB,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,SAAS;KACnB;IACD,gBAAgB,EAAE;QAChB,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,SAAS;QAClB,QAAQ,EAAE,SAAS;QACnB,OAAO,EAAE,SAAS;KACnB;IACD,KAAK,EAAE;QACL,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,SAAS;QAClB,QAAQ,EAAE,SAAS;QACnB,OAAO,EAAE,SAAS;KACnB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,SAAS;QAClB,QAAQ,EAAE,0BAA0B;QACpC,OAAO,EAAE,SAAS;KACnB;IACD,YAAY,EAAE;QACZ,IAAI,EAAE,wBAAwB;QAC9B,OAAO,EAAE,SAAS;QAClB,QAAQ,EAAE,gBAAgB;QAC1B,OAAO,EAAE,SAAS;KACnB;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,SAAS;QAClB,QAAQ,EAAE,SAAS;QACnB,OAAO,EAAE,SAAS;KACnB;IACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,SAAS;QAClB,QAAQ,EAAE,SAAS;QACnB,OAAO,EAAE,SAAS;KACnB;IACD,KAAK,EAAE;QACL,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,SAAS;QAClB,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,SAAS;KACnB;IACD,WAAW,EAAE;QACX,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,SAAS;QAClB,QAAQ,EAAE,SAAS;QACnB,OAAO,EAAE,SAAS;KACnB;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,SAAS;QAClB,QAAQ,EAAE,SAAS;QACnB,OAAO,EAAE,SAAS;KACnB;IACD,UAAU,EAAE;QACV,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,SAAS;QAClB,QAAQ,EAAE,SAAS;QACnB,OAAO,EAAE,SAAS;KACnB;CACF,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAyB,EAAE,OAAe,EAAsB,EAAE;IAC7F,4BAA4B;IAC5B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAClD,CAAC;IAED,8BAA8B;IAC9B,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3B,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,OAAO,EACL,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS;gBACxC,CAAC,CAAC;oBACE,KAAK,EAAE,OAAO;oBACd,OAAO,EAAE,OAAO;oBAChB,OAAO,EAAE,mDAAmD,KAAK,mBAAmB;iBACrF;gBACH,CAAC,CAAC,SAAS;SAChB,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAE7C,sBAAsB;IACtB,IAAI,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC;QAClC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IACvC,CAAC;IAED,4CAA4C;IAC5C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAC9C,CAAC,CAAC"}

package/dist/src/unstable/subagents/rendering/tool-access-mapping.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Tool access mapping for subagent rendering.
+ *
+ * Maps portable `toolAccess` values to agent-native tool control fields.
+ * Returns an object of fields to merge into the rendered output.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import type { LossyRenderingWarning } from "../../commands/rendering-warnings.js";
+import type { ToolAccessLevel } from "../tool-access.js";
+/**
+ * Result of mapping a portable tool access level to agent-native fields.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface ToolAccessMappingResult {
+    /** Agent-native fields to merge into the rendered output. */
+    readonly fields: Readonly<Record<string, unknown>>;
+    /** Optional warnings for lossy mappings. */
+    readonly warnings: ReadonlyArray<LossyRenderingWarning>;
+}
+/**
+ * Map a portable tool access level to agent-native fields.
+ *
+ * Returns fields to merge into the rendered output and any warnings
+ * for lossy mappings.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const mapToolAccess: (toolAccess: ToolAccessLevel | undefined, agentId: string) => ToolAccessMappingResult;
+//# sourceMappingURL=tool-access-mapping.d.ts.map

package/dist/src/unstable/subagents/rendering/tool-access-mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-access-mapping.d.ts","sourceRoot":"","sources":["../../../../../src/unstable/subagents/rendering/tool-access-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;CACzD;AAqJD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GACxB,YAAY,eAAe,GAAG,SAAS,EACvC,SAAS,MAAM,KACd,uBAUF,CAAC"}