@jstn-sdk/rcs 0.1.0

package/dist/agents/definitions.js

@@ -0,0 +1,327 @@
+/**
+ * Agent role definitions for roblox-ai-os-creator-skills
+ * Each agent has a name, description, default reasoning effort, and tool access pattern.
+ * Prompt content is loaded from the prompts/ directory at runtime.
+ */
+const EXECUTOR_AGENT = {
+    name: 'executor',
+    description: 'Code implementation, refactoring, feature work',
+    reasoningEffort: 'medium',
+    posture: 'deep-worker',
+    modelClass: 'standard',
+    routingRole: 'executor',
+    tools: 'execution',
+    category: 'build',
+};
+const TEAM_EXECUTOR_AGENT = {
+    name: 'team-executor',
+    description: 'Supervised team execution for conservative delivery lanes',
+    reasoningEffort: 'medium',
+    posture: 'deep-worker',
+    modelClass: 'frontier',
+    routingRole: 'executor',
+    tools: 'execution',
+    category: 'build',
+};
+export const AGENT_DEFINITIONS = {
+    // Build/Analysis Lane
+    'explore': {
+        name: 'explore',
+        description: 'Fast codebase search and file/symbol mapping',
+        reasoningEffort: 'low',
+        posture: 'fast-lane',
+        modelClass: 'fast',
+        routingRole: 'specialist',
+        tools: 'read-only',
+        category: 'build',
+    },
+    'analyst': {
+        name: 'analyst',
+        description: 'Requirements clarity, acceptance criteria, hidden constraints',
+        reasoningEffort: 'medium',
+        posture: 'frontier-orchestrator',
+        modelClass: 'frontier',
+        routingRole: 'leader',
+        tools: 'analysis',
+        category: 'build',
+    },
+    'planner': {
+        name: 'planner',
+        description: 'Task sequencing, execution plans, risk flags',
+        reasoningEffort: 'medium',
+        posture: 'frontier-orchestrator',
+        modelClass: 'frontier',
+        routingRole: 'leader',
+        tools: 'analysis',
+        category: 'build',
+    },
+    'architect': {
+        name: 'architect',
+        description: 'System design, boundaries, interfaces, long-horizon tradeoffs',
+        reasoningEffort: 'high',
+        posture: 'frontier-orchestrator',
+        modelClass: 'frontier',
+        routingRole: 'leader',
+        tools: 'read-only',
+        category: 'build',
+    },
+    'debugger': {
+        name: 'debugger',
+        description: 'Root-cause analysis, regression isolation, failure diagnosis',
+        reasoningEffort: 'high',
+        posture: 'deep-worker',
+        modelClass: 'standard',
+        routingRole: 'executor',
+        tools: 'analysis',
+        category: 'build',
+    },
+    'executor': EXECUTOR_AGENT,
+    'team-executor': TEAM_EXECUTOR_AGENT,
+    'verifier': {
+        name: 'verifier',
+        description: 'Completion evidence, claim validation, test adequacy',
+        reasoningEffort: 'high',
+        posture: 'frontier-orchestrator',
+        modelClass: 'standard',
+        routingRole: 'leader',
+        tools: 'analysis',
+        category: 'build',
+    },
+    // Review Lane
+    'style-reviewer': {
+        name: 'style-reviewer',
+        description: 'Formatting, naming, idioms, lint conventions',
+        reasoningEffort: 'low',
+        posture: 'fast-lane',
+        modelClass: 'fast',
+        routingRole: 'specialist',
+        tools: 'read-only',
+        category: 'review',
+    },
+    'quality-reviewer': {
+        name: 'quality-reviewer',
+        description: 'Logic defects, maintainability, anti-patterns',
+        reasoningEffort: 'medium',
+        posture: 'frontier-orchestrator',
+        modelClass: 'standard',
+        routingRole: 'leader',
+        tools: 'read-only',
+        category: 'review',
+    },
+    'api-reviewer': {
+        name: 'api-reviewer',
+        description: 'API contracts, versioning, backward compatibility',
+        reasoningEffort: 'medium',
+        posture: 'frontier-orchestrator',
+        modelClass: 'standard',
+        routingRole: 'leader',
+        tools: 'read-only',
+        category: 'review',
+    },
+    'security-reviewer': {
+        name: 'security-reviewer',
+        description: 'Vulnerabilities, trust boundaries, authn/authz',
+        reasoningEffort: 'medium',
+        posture: 'frontier-orchestrator',
+        modelClass: 'frontier',
+        routingRole: 'leader',
+        tools: 'read-only',
+        category: 'review',
+    },
+    'performance-reviewer': {
+        name: 'performance-reviewer',
+        description: 'Hotspots, complexity, memory/latency optimization',
+        reasoningEffort: 'medium',
+        posture: 'frontier-orchestrator',
+        modelClass: 'standard',
+        routingRole: 'leader',
+        tools: 'read-only',
+        category: 'review',
+    },
+    'code-reviewer': {
+        name: 'code-reviewer',
+        description: 'Comprehensive review across all concerns',
+        reasoningEffort: 'high',
+        posture: 'frontier-orchestrator',
+        modelClass: 'frontier',
+        routingRole: 'leader',
+        tools: 'read-only',
+        category: 'review',
+    },
+    // Domain Specialists
+    'dependency-expert': {
+        name: 'dependency-expert',
+        description: 'External SDK/API/package evaluation',
+        reasoningEffort: 'high',
+        posture: 'frontier-orchestrator',
+        modelClass: 'standard',
+        routingRole: 'specialist',
+        tools: 'analysis',
+        category: 'domain',
+    },
+    'test-engineer': {
+        name: 'test-engineer',
+        description: 'Test strategy, coverage, flaky-test hardening',
+        reasoningEffort: 'medium',
+        posture: 'deep-worker',
+        modelClass: 'frontier',
+        routingRole: 'executor',
+        tools: 'execution',
+        category: 'domain',
+    },
+    'quality-strategist': {
+        name: 'quality-strategist',
+        description: 'Quality strategy, release readiness, risk assessment',
+        reasoningEffort: 'medium',
+        posture: 'frontier-orchestrator',
+        modelClass: 'standard',
+        routingRole: 'leader',
+        tools: 'analysis',
+        category: 'domain',
+    },
+    'build-fixer': {
+        name: 'build-fixer',
+        description: 'Build/toolchain/type failures resolution',
+        reasoningEffort: 'high',
+        posture: 'deep-worker',
+        modelClass: 'standard',
+        routingRole: 'executor',
+        tools: 'execution',
+        category: 'domain',
+    },
+    'designer': {
+        name: 'designer',
+        description: 'UX/UI architecture, interaction design',
+        reasoningEffort: 'high',
+        posture: 'deep-worker',
+        modelClass: 'standard',
+        routingRole: 'executor',
+        tools: 'execution',
+        category: 'domain',
+    },
+    'writer': {
+        name: 'writer',
+        description: 'Documentation, migration notes, user guidance',
+        reasoningEffort: 'high',
+        posture: 'fast-lane',
+        modelClass: 'standard',
+        routingRole: 'specialist',
+        tools: 'execution',
+        category: 'domain',
+    },
+    'qa-tester': {
+        name: 'qa-tester',
+        description: 'Interactive CLI/service runtime validation',
+        reasoningEffort: 'low',
+        posture: 'deep-worker',
+        modelClass: 'standard',
+        routingRole: 'executor',
+        tools: 'execution',
+        category: 'domain',
+    },
+    'git-master': {
+        name: 'git-master',
+        description: 'Commit strategy, history hygiene, rebasing',
+        reasoningEffort: 'high',
+        posture: 'deep-worker',
+        modelClass: 'standard',
+        routingRole: 'executor',
+        tools: 'execution',
+        category: 'domain',
+    },
+    'code-simplifier': {
+        name: 'code-simplifier',
+        description: 'Simplifies recently modified code for clarity and consistency without changing behavior',
+        reasoningEffort: 'high',
+        posture: 'deep-worker',
+        modelClass: 'frontier',
+        routingRole: 'executor',
+        tools: 'execution',
+        category: 'domain',
+    },
+    'researcher': {
+        name: 'researcher',
+        description: 'External documentation and reference research',
+        reasoningEffort: 'high',
+        posture: 'fast-lane',
+        modelClass: 'standard',
+        routingRole: 'specialist',
+        tools: 'analysis',
+        category: 'domain',
+    },
+    // Product Lane
+    'product-manager': {
+        name: 'product-manager',
+        description: 'Problem framing, personas/JTBD, PRDs',
+        reasoningEffort: 'medium',
+        posture: 'frontier-orchestrator',
+        modelClass: 'standard',
+        routingRole: 'leader',
+        tools: 'analysis',
+        category: 'product',
+    },
+    'ux-researcher': {
+        name: 'ux-researcher',
+        description: 'Heuristic audits, usability, accessibility',
+        reasoningEffort: 'medium',
+        posture: 'frontier-orchestrator',
+        modelClass: 'standard',
+        routingRole: 'specialist',
+        tools: 'analysis',
+        category: 'product',
+    },
+    'information-architect': {
+        name: 'information-architect',
+        description: 'Taxonomy, navigation, findability',
+        reasoningEffort: 'low',
+        posture: 'frontier-orchestrator',
+        modelClass: 'standard',
+        routingRole: 'specialist',
+        tools: 'analysis',
+        category: 'product',
+    },
+    'product-analyst': {
+        name: 'product-analyst',
+        description: 'Product metrics, funnel analysis, experiments',
+        reasoningEffort: 'low',
+        posture: 'frontier-orchestrator',
+        modelClass: 'standard',
+        routingRole: 'specialist',
+        tools: 'analysis',
+        category: 'product',
+    },
+    // Coordination
+    'critic': {
+        name: 'critic',
+        description: 'Plan/design critical challenge and review',
+        reasoningEffort: 'high',
+        posture: 'frontier-orchestrator',
+        modelClass: 'frontier',
+        routingRole: 'leader',
+        tools: 'read-only',
+        category: 'coordination',
+    },
+    'vision': {
+        name: 'vision',
+        description: 'Image/screenshot/diagram analysis',
+        reasoningEffort: 'low',
+        posture: 'fast-lane',
+        modelClass: 'frontier',
+        routingRole: 'specialist',
+        tools: 'read-only',
+        category: 'coordination',
+    },
+};
+/** Get agent definition by name */
+export function getAgent(name) {
+    return AGENT_DEFINITIONS[name];
+}
+/** Get all agents in a category */
+export function getAgentsByCategory(category) {
+    return Object.values(AGENT_DEFINITIONS).filter(a => a.category === category);
+}
+/** Get all agent names */
+export function getAgentNames() {
+    return Object.keys(AGENT_DEFINITIONS);
+}
+//# sourceMappingURL=definitions.js.map

package/dist/agents/definitions.js.map

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

package/dist/agents/native-config.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Native agent config generators for Codex CLI.
+ * Writes standalone TOML files under ~/.codex/agents/ or ./.codex/agents/.
+ */
+import { AgentDefinition } from "./definitions.js";
+import type { CatalogManifest } from "../catalog/schema.js";
+export declare const EXACT_GPT_5_4_MINI_MODEL = "gpt-5.4-mini";
+export interface GeneratedNativeAgentConfig {
+    name: string;
+    description: string;
+    developerInstructions?: string;
+    model?: string;
+    modelProvider?: string;
+    reasoningEffort?: "low" | "medium" | "high" | "xhigh";
+}
+interface AgentModelResolutionOptions {
+    codexHomeOverride?: string;
+    configTomlContent?: string;
+    env?: NodeJS.ProcessEnv;
+}
+interface RoleInstructionMetadata {
+    name: string;
+    posture: AgentDefinition["posture"];
+    modelClass: AgentDefinition["modelClass"];
+    routingRole: AgentDefinition["routingRole"];
+}
+export declare function composeRoleInstructions(promptContent: string, metadata: RoleInstructionMetadata | null, resolvedModel?: string): string;
+export declare function composeRoleInstructionsForRole(roleName: string, promptContent: string, resolvedModel?: string): string;
+/**
+ * Strip YAML frontmatter (between --- markers) from markdown content.
+ */
+export declare function stripFrontmatter(content: string): string;
+export declare function generateStandaloneAgentToml(config: GeneratedNativeAgentConfig): string;
+/**
+ * Generate TOML content for a prompt-backed RCS role agent.
+ */
+export declare function generateAgentToml(agent: AgentDefinition, promptContent: string, options?: AgentModelResolutionOptions): string;
+/**
+ * Install prompt-backed native agent config .toml files to ~/.codex/agents/
+ * Returns the number of agent files written.
+ */
+export declare function installNativeAgentConfigs(pkgRoot: string, options?: {
+    force?: boolean;
+    dryRun?: boolean;
+    verbose?: boolean;
+    agentsDir?: string;
+    catalogManifest?: CatalogManifest;
+    allowUncatalogedDefinitions?: boolean;
+}): Promise<number>;
+export {};
+//# sourceMappingURL=native-config.d.ts.map

package/dist/agents/native-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-config.d.ts","sourceRoot":"","sources":["../../src/agents/native-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAqB,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAY5D,eAAO,MAAM,wBAAwB,iBAAiB,CAAC;AAiFvD,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;CACvD;AAED,UAAU,2BAA2B;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,UAAU,uBAAuB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACpC,UAAU,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;IAC1C,WAAW,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC;CAC7C;AAwDD,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,uBAAuB,GAAG,IAAI,EACxC,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,CAsCR;AAED,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,aAAa,CAAC,EAAE,MAAM,GACrB,MAAM,CAcR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMxD;AAcD,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,0BAA0B,GACjC,MAAM,CA4BR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,eAAe,EACtB,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,2BAAgC,GACxC,MAAM,CAWR;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,2BAA2B,CAAC,EAAE,OAAO,CAAC;CAClC,GACL,OAAO,CAAC,MAAM,CAAC,CAkDjB"}

package/dist/agents/native-config.js

@@ -0,0 +1,265 @@
+/**
+ * Native agent config generators for Codex CLI.
+ * Writes standalone TOML files under ~/.codex/agents/ or ./.codex/agents/.
+ */
+import { existsSync, readFileSync } from "fs";
+import { mkdir, readFile, writeFile } from "fs/promises";
+import { join } from "path";
+import { AGENT_DEFINITIONS } from "./definitions.js";
+import { readCatalogManifest } from "../catalog/reader.js";
+import { getInstallableNativeAgentNames } from "./policy.js";
+import { getCodexConfigRootModelProvider, getEnvConfiguredStandardDefaultModel, getMainDefaultModel, getSparkDefaultModel, getStandardDefaultModel, } from "../config/models.js";
+import { getRootModelName } from "../config/generator.js";
+import { codexAgentsDir } from "../utils/paths.js";
+export const EXACT_GPT_5_4_MINI_MODEL = "gpt-5.4-mini";
+const POSTURE_OVERLAYS = {
+    "frontier-orchestrator": [
+        "<posture_overlay>",
+        "",
+        "You are operating in the frontier-orchestrator posture.",
+        "- Prioritize intent classification before implementation.",
+        "- Default to delegation and orchestration when specialists exist.",
+        "- Treat the first decision as a routing problem: research vs planning vs implementation vs verification.",
+        "- Challenge flawed user assumptions concisely before execution when the design is likely to cause avoidable problems.",
+        "- Preserve explicit executor handoff boundaries: do not absorb deep implementation work when a specialized executor is more appropriate.",
+        "",
+        "</posture_overlay>",
+    ].join("\n"),
+    "deep-worker": [
+        "<posture_overlay>",
+        "",
+        "You are operating in the deep-worker posture.",
+        "- Once the task is clearly implementation-oriented, bias toward direct execution and end-to-end completion.",
+        "- Explore first, then implement minimal changes that match existing patterns.",
+        "- Keep verification strict: diagnostics, tests, and build evidence are mandatory before claiming completion.",
+        "- Escalate only after materially different approaches fail or when architecture tradeoffs exceed local implementation scope.",
+        "",
+        "</posture_overlay>",
+    ].join("\n"),
+    "fast-lane": [
+        "<posture_overlay>",
+        "",
+        "You are operating in the fast-lane posture.",
+        "- Optimize for fast triage, search, lightweight synthesis, and narrow routing decisions.",
+        "- Do not start deep implementation unless the task is tightly bounded and obvious.",
+        "- If the task expands beyond quick classification or lightweight execution, escalate to a frontier-orchestrator or deep-worker role.",
+        "- Keep responses quality-first, scope-aware, and conservative under ambiguity; avoid empty verbosity and reflexive tool escalation.",
+        "",
+        "</posture_overlay>",
+    ].join("\n"),
+};
+const MODEL_CLASS_OVERLAYS = {
+    frontier: [
+        "<model_class_guidance>",
+        "",
+        "This role is tuned for frontier-class models.",
+        "- Use the model's steerability for coordination, tradeoff reasoning, and precise delegation.",
+        "- Favor clean routing decisions over impulsive implementation.",
+        "",
+        "</model_class_guidance>",
+    ].join("\n"),
+    standard: [
+        "<model_class_guidance>",
+        "",
+        "This role is tuned for standard-capability models.",
+        "- Balance autonomy with clear boundaries.",
+        "- Prefer explicit verification and narrow scope control over speculative reasoning.",
+        "",
+        "</model_class_guidance>",
+    ].join("\n"),
+    fast: [
+        "<model_class_guidance>",
+        "",
+        "This role is tuned for fast/low-latency models.",
+        "- Prefer quick search, synthesis, and routing over prolonged reasoning.",
+        "- Escalate rather than bluff when deeper work is required.",
+        "",
+        "</model_class_guidance>",
+    ].join("\n"),
+};
+const EXACT_MINI_MODEL_OVERLAY = [
+    "<exact_model_guidance>",
+    "",
+    `This role is executing under the exact ${EXACT_GPT_5_4_MINI_MODEL} model.`,
+    "- Use a strict execution order: inspect -> plan -> act -> verify.",
+    "- Treat completion criteria as explicit: only report done after the requested work is implemented and fresh verification passes.",
+    "- If requirements are ambiguous or a blocker appears, state the blocker plainly and stop guessing until the missing decision is resolved.",
+    "- Do not bluff, pad, or invent results; report missing evidence and incomplete work honestly.",
+    "",
+    "</exact_model_guidance>",
+].join("\n");
+function readConfigTomlContent(codexHomeOverride, provided) {
+    if (typeof provided === "string")
+        return provided;
+    const configPath = join(codexHomeOverride ?? process.env.CODEX_HOME ?? "", "config.toml");
+    if (codexHomeOverride && existsSync(configPath)) {
+        return readFileSync(configPath, "utf-8");
+    }
+    return "";
+}
+function resolveFrontierModel(options) {
+    const configTomlContent = readConfigTomlContent(options.codexHomeOverride, options.configTomlContent);
+    return getRootModelName(configTomlContent)
+        ?? getMainDefaultModel(options.codexHomeOverride);
+}
+function resolveStandardModel(options) {
+    const explicitStandardModel = getEnvConfiguredStandardDefaultModel(options.env ?? process.env, options.codexHomeOverride);
+    if (explicitStandardModel)
+        return explicitStandardModel;
+    return getStandardDefaultModel(options.codexHomeOverride);
+}
+function resolveAgentModel(agent, options = {}) {
+    if (agent.name === "executor") {
+        return resolveFrontierModel(options);
+    }
+    switch (agent.modelClass) {
+        case "frontier":
+            return resolveFrontierModel(options);
+        case "fast":
+            return getSparkDefaultModel(options.codexHomeOverride);
+        case "standard":
+        default:
+            return resolveStandardModel(options);
+    }
+}
+function isExactMiniModel(resolvedModel) {
+    return resolvedModel?.trim() === EXACT_GPT_5_4_MINI_MODEL;
+}
+export function composeRoleInstructions(promptContent, metadata, resolvedModel) {
+    const instructions = stripFrontmatter(promptContent);
+    const parts = [instructions];
+    if (metadata) {
+        parts.push("", POSTURE_OVERLAYS[metadata.posture], "", MODEL_CLASS_OVERLAYS[metadata.modelClass]);
+    }
+    if (isExactMiniModel(resolvedModel)) {
+        parts.push("", EXACT_MINI_MODEL_OVERLAY);
+    }
+    const metadataLines = [];
+    if (metadata) {
+        metadataLines.push("## RCS Agent Metadata", `- role: ${metadata.name}`, `- posture: ${metadata.posture}`, `- model_class: ${metadata.modelClass}`, `- routing_role: ${metadata.routingRole}`);
+    }
+    if (resolvedModel) {
+        if (metadataLines.length === 0) {
+            metadataLines.push("## RCS Agent Metadata");
+        }
+        metadataLines.push(`- resolved_model: ${resolvedModel}`);
+    }
+    if (metadataLines.length > 0) {
+        parts.push("", ...metadataLines);
+    }
+    return parts.join("\n");
+}
+export function composeRoleInstructionsForRole(roleName, promptContent, resolvedModel) {
+    const agent = AGENT_DEFINITIONS[roleName];
+    return composeRoleInstructions(promptContent, agent
+        ? {
+            name: agent.name,
+            posture: agent.posture,
+            modelClass: agent.modelClass,
+            routingRole: agent.routingRole,
+        }
+        : null, resolvedModel);
+}
+/**
+ * Strip YAML frontmatter (between --- markers) from markdown content.
+ */
+export function stripFrontmatter(content) {
+    const match = content.match(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/);
+    if (match) {
+        return content.slice(match[0].length).trim();
+    }
+    return content.trim();
+}
+/**
+ * Escape content for TOML triple-quoted strings.
+ * TOML """ strings only need to escape sequences of 3+ consecutive quotes.
+ */
+function escapeTomlMultiline(s) {
+    return s.replace(/"{3,}/g, (match) => match.split("").join("\\"));
+}
+function escapeTomlBasicString(s) {
+    return s.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+export function generateStandaloneAgentToml(config) {
+    const lines = [
+        `# roblox-ai-os-creator-skills agent: ${config.name}`,
+        `name = "${escapeTomlBasicString(config.name)}"`,
+        `description = "${escapeTomlBasicString(config.description)}"`,
+    ];
+    if (config.model) {
+        lines.push(`model = "${escapeTomlBasicString(config.model)}"`);
+    }
+    if (config.modelProvider) {
+        lines.push(`model_provider = "${escapeTomlBasicString(config.modelProvider)}"`);
+    }
+    if (config.reasoningEffort) {
+        lines.push(`model_reasoning_effort = "${config.reasoningEffort}"`);
+    }
+    if (typeof config.developerInstructions === "string" &&
+        config.developerInstructions.trim().length > 0) {
+        const escapedInstructions = escapeTomlMultiline(config.developerInstructions);
+        lines.push('developer_instructions = """', escapedInstructions, '"""');
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+/**
+ * Generate TOML content for a prompt-backed RCS role agent.
+ */
+export function generateAgentToml(agent, promptContent, options = {}) {
+    const resolvedModel = resolveAgentModel(agent, options);
+    const resolvedModelProvider = getCodexConfigRootModelProvider(options.codexHomeOverride);
+    return generateStandaloneAgentToml({
+        name: agent.name,
+        description: agent.description,
+        developerInstructions: composeRoleInstructions(promptContent, agent, resolvedModel),
+        model: resolvedModel,
+        modelProvider: resolvedModelProvider,
+        reasoningEffort: agent.reasoningEffort,
+    });
+}
+/**
+ * Install prompt-backed native agent config .toml files to ~/.codex/agents/
+ * Returns the number of agent files written.
+ */
+export async function installNativeAgentConfigs(pkgRoot, options = {}) {
+    const { force = false, dryRun = false, verbose = false, agentsDir = codexAgentsDir(), catalogManifest, allowUncatalogedDefinitions = false, } = options;
+    const codexHomeOverride = join(agentsDir, "..");
+    if (!dryRun) {
+        await mkdir(agentsDir, { recursive: true });
+    }
+    let count = 0;
+    const installableAgentNames = allowUncatalogedDefinitions
+        ? new Set(Object.keys(AGENT_DEFINITIONS))
+        : getInstallableNativeAgentNames(catalogManifest ?? readCatalogManifest(pkgRoot));
+    for (const name of [...installableAgentNames].sort()) {
+        const agent = AGENT_DEFINITIONS[name];
+        if (!agent) {
+            if (verbose)
+                console.log(`  skip ${name} (no agent definition)`);
+            continue;
+        }
+        const promptPath = join(pkgRoot, "prompts", `${name}.md`);
+        if (!existsSync(promptPath)) {
+            if (verbose)
+                console.log(`  skip ${name} (no prompt file)`);
+            continue;
+        }
+        const dst = join(agentsDir, `${name}.toml`);
+        if (!force && existsSync(dst)) {
+            if (verbose)
+                console.log(`  skip ${name} (already exists)`);
+            continue;
+        }
+        const promptContent = await readFile(promptPath, "utf-8");
+        const toml = generateAgentToml(agent, promptContent, { codexHomeOverride });
+        if (!dryRun) {
+            await writeFile(dst, toml);
+        }
+        if (verbose)
+            console.log(`  ${name}.toml`);
+        count += 1;
+    }
+    return count;
+}
+//# sourceMappingURL=native-config.js.map