@opengoat/core 2026.2.9

package/dist/core/skills/application/skill.service.js

@@ -0,0 +1,375 @@
+import os from "node:os";
+import path from "node:path";
+import { DEFAULT_AGENT_ID, normalizeAgentId } from "../../domain/agent-id.js";
+import { resolveSkillsConfig } from "../domain/skill.js";
+export class SkillService {
+    fileSystem;
+    pathPort;
+    pluginSkillDirsProvider;
+    constructor(deps) {
+        this.fileSystem = deps.fileSystem;
+        this.pathPort = deps.pathPort;
+        this.pluginSkillDirsProvider = deps.pluginSkillDirsProvider;
+    }
+    async listSkills(paths, agentId = DEFAULT_AGENT_ID, runtimeConfig) {
+        const normalizedAgentId = normalizeAgentId(agentId) || DEFAULT_AGENT_ID;
+        const resolvedConfig = resolveSkillsConfig(runtimeConfig ?? (await this.readAgentSkillsConfig(paths, normalizedAgentId)));
+        if (!resolvedConfig.enabled) {
+            return [];
+        }
+        const discovered = await this.loadSkillsWithPrecedence(paths, normalizedAgentId, resolvedConfig);
+        return [...discovered].sort((left, right) => left.id.localeCompare(right.id));
+    }
+    async listGlobalSkills(paths) {
+        const loaded = await this.loadSkillsFromDirectory(paths.skillsDir, "managed");
+        return loaded.sort((left, right) => left.id.localeCompare(right.id));
+    }
+    async buildSkillsPrompt(paths, agentId = DEFAULT_AGENT_ID, runtimeConfig) {
+        const skills = await this.listSkills(paths, agentId, runtimeConfig);
+        const resolvedConfig = resolveSkillsConfig(runtimeConfig ?? (await this.readAgentSkillsConfig(paths, normalizeAgentId(agentId) || DEFAULT_AGENT_ID)));
+        if (!resolvedConfig.enabled) {
+            return { prompt: "", skills: [] };
+        }
+        const selected = [];
+        let budgetUsed = 0;
+        for (const skill of skills.filter((entry) => entry.frontmatter.disableModelInvocation !== true)) {
+            if (selected.length >= resolvedConfig.prompt.maxSkills) {
+                break;
+            }
+            const content = resolvedConfig.prompt.includeContent
+                ? clampText(skill.content, resolvedConfig.prompt.maxCharsPerSkill)
+                : "";
+            const estimatedChars = skill.name.length + skill.description.length + skill.skillFilePath.length + content.length + 150;
+            if (budgetUsed + estimatedChars > resolvedConfig.prompt.maxTotalChars) {
+                break;
+            }
+            budgetUsed += estimatedChars;
+            selected.push({
+                ...skill,
+                content
+            });
+        }
+        const lines = [
+            "## Skills",
+            "Before replying, inspect available skill summaries and decide whether one skill clearly applies.",
+            "- If exactly one skill clearly applies, follow that skill.",
+            "- If multiple skills could apply, choose the most specific.",
+            "- If none apply, continue without using a skill.",
+            "Self-install/update: create or edit `skills/<skill-id>/SKILL.md` in this workspace.",
+            ""
+        ];
+        if (selected.length === 0) {
+            lines.push("No installed skills were found for this agent.");
+            return {
+                prompt: lines.join("\n"),
+                skills: []
+            };
+        }
+        lines.push("<available_skills>");
+        for (const skill of selected) {
+            lines.push("  <skill>");
+            lines.push(`    <id>${escapeXml(skill.id)}</id>`);
+            lines.push(`    <name>${escapeXml(skill.name)}</name>`);
+            lines.push(`    <description>${escapeXml(skill.description)}</description>`);
+            lines.push(`    <location>${escapeXml(skill.skillFilePath)}</location>`);
+            lines.push(`    <source>${skill.source}</source>`);
+            if (resolvedConfig.prompt.includeContent && skill.content.trim()) {
+                lines.push("    <content>");
+                lines.push(indentMultiline(skill.content, 6));
+                lines.push("    </content>");
+            }
+            lines.push("  </skill>");
+        }
+        lines.push("</available_skills>");
+        return {
+            prompt: lines.join("\n"),
+            skills: selected
+        };
+    }
+    async installSkill(paths, request) {
+        const scope = request.scope === "global" ? "global" : "agent";
+        const normalizedAgentId = normalizeAgentId(request.agentId ?? DEFAULT_AGENT_ID) || DEFAULT_AGENT_ID;
+        const skillId = normalizeAgentId(request.skillName);
+        if (!skillId) {
+            throw new Error("Skill name must contain at least one alphanumeric character.");
+        }
+        const baseDir = scope === "global" ? paths.skillsDir : this.pathPort.join(paths.workspacesDir, normalizedAgentId, "skills");
+        const targetDir = this.pathPort.join(baseDir, skillId);
+        const targetSkillFile = this.pathPort.join(targetDir, "SKILL.md");
+        const replaced = await this.fileSystem.exists(targetDir);
+        await this.fileSystem.ensureDir(baseDir);
+        if (request.sourcePath?.trim()) {
+            const sourcePath = resolveUserPath(request.sourcePath.trim());
+            const sourceSkillFile = sourcePath.toLowerCase().endsWith("/skill.md") || sourcePath.toLowerCase().endsWith("\\skill.md")
+                ? sourcePath
+                : this.pathPort.join(sourcePath, "SKILL.md");
+            const sourceFileExists = await this.fileSystem.exists(sourceSkillFile);
+            if (!sourceFileExists) {
+                throw new Error(`Source skill not found: ${sourceSkillFile}`);
+            }
+            const sourceDir = sourceSkillFile === sourcePath ? path.dirname(sourcePath) : sourcePath;
+            await this.fileSystem.removeDir(targetDir);
+            await this.fileSystem.copyDir(sourceDir, targetDir);
+            return {
+                scope,
+                agentId: scope === "agent" ? normalizedAgentId : undefined,
+                skillId,
+                skillName: request.skillName.trim(),
+                source: "source-path",
+                installedPath: targetSkillFile,
+                replaced
+            };
+        }
+        if (scope === "agent") {
+            const managedDir = this.pathPort.join(paths.skillsDir, skillId);
+            const managedSkillFile = this.pathPort.join(managedDir, "SKILL.md");
+            if (await this.fileSystem.exists(managedSkillFile)) {
+                await this.fileSystem.removeDir(targetDir);
+                await this.fileSystem.copyDir(managedDir, targetDir);
+                return {
+                    scope,
+                    agentId: normalizedAgentId,
+                    skillId,
+                    skillName: request.skillName.trim(),
+                    source: "managed",
+                    installedPath: targetSkillFile,
+                    replaced
+                };
+            }
+        }
+        const description = request.description?.trim() || `Skill instructions for ${request.skillName.trim()}.`;
+        const content = request.content?.trim() || renderSkillMarkdown({ skillId, description });
+        await this.fileSystem.ensureDir(targetDir);
+        await this.fileSystem.writeFile(targetSkillFile, ensureTrailingNewline(content));
+        return {
+            scope,
+            agentId: scope === "agent" ? normalizedAgentId : undefined,
+            skillId,
+            skillName: request.skillName.trim(),
+            source: "generated",
+            installedPath: targetSkillFile,
+            replaced
+        };
+    }
+    async loadSkillsWithPrecedence(paths, agentId, config) {
+        const workspaceSkillsDir = this.pathPort.join(paths.workspacesDir, agentId, "skills");
+        const pluginDirs = await this.resolvePluginSkillDirs(paths);
+        const extraDirs = config.load.extraDirs.map(resolveUserPath);
+        const sources = [
+            { source: "managed", dir: paths.skillsDir, enabled: config.includeManaged },
+            ...pluginDirs.map((dir) => ({ source: "plugin", dir, enabled: true })),
+            ...extraDirs.map((dir) => ({ source: "extra", dir, enabled: true })),
+            { source: "workspace", dir: workspaceSkillsDir, enabled: config.includeWorkspace }
+        ];
+        const merged = new Map();
+        for (const sourceEntry of sources) {
+            if (!sourceEntry.enabled) {
+                continue;
+            }
+            const loaded = await this.loadSkillsFromDirectory(sourceEntry.dir, sourceEntry.source);
+            for (const skill of loaded) {
+                merged.set(skill.id, skill);
+            }
+        }
+        return [...merged.values()];
+    }
+    async loadSkillsFromDirectory(baseDir, source) {
+        const skillDirs = await this.fileSystem.listDirectories(baseDir);
+        const loaded = [];
+        for (const directoryName of skillDirs) {
+            const skillDir = this.pathPort.join(baseDir, directoryName);
+            const skillFilePath = this.pathPort.join(skillDir, "SKILL.md");
+            const exists = await this.fileSystem.exists(skillFilePath);
+            if (!exists) {
+                continue;
+            }
+            let raw = "";
+            try {
+                raw = await this.fileSystem.readFile(skillFilePath);
+            }
+            catch {
+                continue;
+            }
+            const parsed = parseSkillMarkdown(raw);
+            if (parsed.frontmatter.enabled === false) {
+                continue;
+            }
+            const id = normalizeAgentId(parsed.frontmatter.name ?? directoryName) || normalizeAgentId(directoryName);
+            if (!id) {
+                continue;
+            }
+            loaded.push({
+                id,
+                name: parsed.frontmatter.name ?? humanizeSkillName(directoryName),
+                description: parsed.frontmatter.description ?? summarizeSkillBody(parsed.body),
+                source,
+                skillDir,
+                skillFilePath,
+                content: parsed.body.trim(),
+                frontmatter: parsed.frontmatter
+            });
+        }
+        return loaded;
+    }
+    async readAgentSkillsConfig(paths, agentId) {
+        const configPath = this.pathPort.join(paths.agentsDir, agentId, "config.json");
+        if (!(await this.fileSystem.exists(configPath))) {
+            return undefined;
+        }
+        try {
+            const raw = await this.fileSystem.readFile(configPath);
+            const parsed = JSON.parse(raw);
+            return parsed.runtime?.skills;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async resolvePluginSkillDirs(paths) {
+        if (!this.pluginSkillDirsProvider) {
+            return [];
+        }
+        try {
+            const loaded = await this.pluginSkillDirsProvider(paths);
+            return loaded.map((entry) => entry.trim()).filter(Boolean);
+        }
+        catch {
+            return [];
+        }
+    }
+}
+function renderSkillMarkdown(params) {
+    return [
+        "---",
+        `name: ${humanizeSkillName(params.skillId)}`,
+        `description: ${params.description}`,
+        "---",
+        "",
+        `# ${humanizeSkillName(params.skillId)}`,
+        "",
+        "## When to Use",
+        "- Describe when this skill should be applied.",
+        "",
+        "## Instructions",
+        "- Add explicit step-by-step guidance here.",
+        "",
+        "## Constraints",
+        "- Add constraints and safety checks here."
+    ].join("\n");
+}
+function parseSkillMarkdown(content) {
+    const lines = content.split(/\r?\n/);
+    if (lines[0]?.trim() !== "---") {
+        return { frontmatter: {}, body: content };
+    }
+    let index = 1;
+    const frontmatterLines = [];
+    while (index < lines.length && lines[index]?.trim() !== "---") {
+        frontmatterLines.push(lines[index] ?? "");
+        index += 1;
+    }
+    if (index >= lines.length) {
+        return { frontmatter: {}, body: content };
+    }
+    const frontmatter = {};
+    for (const line of frontmatterLines) {
+        const separator = line.indexOf(":");
+        if (separator <= 0) {
+            continue;
+        }
+        const key = line.slice(0, separator).trim().toLowerCase();
+        const value = line.slice(separator + 1).trim();
+        if (key === "name" && value) {
+            frontmatter.name = value;
+            continue;
+        }
+        if (key === "description" && value) {
+            frontmatter.description = value;
+            continue;
+        }
+        if (key === "enabled") {
+            const normalized = value.toLowerCase();
+            if (normalized === "true") {
+                frontmatter.enabled = true;
+            }
+            else if (normalized === "false") {
+                frontmatter.enabled = false;
+            }
+            continue;
+        }
+        if (key === "user-invocable" || key === "user_invocable") {
+            const normalized = value.toLowerCase();
+            if (normalized === "true") {
+                frontmatter.userInvocable = true;
+            }
+            else if (normalized === "false") {
+                frontmatter.userInvocable = false;
+            }
+            continue;
+        }
+        if (key === "disable-model-invocation" || key === "disable_model_invocation") {
+            const normalized = value.toLowerCase();
+            if (normalized === "true") {
+                frontmatter.disableModelInvocation = true;
+            }
+            else if (normalized === "false") {
+                frontmatter.disableModelInvocation = false;
+            }
+        }
+    }
+    const body = lines.slice(index + 1).join("\n");
+    return { frontmatter, body };
+}
+function summarizeSkillBody(body) {
+    const trimmed = body.trim();
+    if (!trimmed) {
+        return "No description provided.";
+    }
+    const lines = trimmed
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter(Boolean);
+    const descriptive = lines.find((line) => !line.startsWith("#")) ??
+        lines[0] ??
+        "No description provided.";
+    return clampText(descriptive, 180);
+}
+function humanizeSkillName(value) {
+    return value
+        .replace(/[-_]+/g, " ")
+        .replace(/\s+/g, " ")
+        .trim()
+        .replace(/\b\w/g, (char) => char.toUpperCase());
+}
+function clampText(value, maxChars) {
+    if (value.length <= maxChars) {
+        return value;
+    }
+    return `${value.slice(0, Math.max(1, maxChars - 3))}...`;
+}
+function ensureTrailingNewline(value) {
+    return value.endsWith("\n") ? value : `${value}\n`;
+}
+function resolveUserPath(value) {
+    if (value === "~") {
+        return os.homedir();
+    }
+    if (value.startsWith("~/")) {
+        return path.join(os.homedir(), value.slice(2));
+    }
+    return path.resolve(value);
+}
+function escapeXml(value) {
+    return value
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;");
+}
+function indentMultiline(value, spaces) {
+    const indent = " ".repeat(Math.max(0, spaces));
+    return value
+        .split(/\r?\n/)
+        .map((line) => `${indent}${line}`)
+        .join("\n");
+}
+//# sourceMappingURL=skill.service.js.map

package/dist/core/skills/application/skill.service.js.map

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

package/dist/core/skills/domain/skill.d.ts

@@ -0,0 +1,62 @@
+export type SkillSource = "workspace" | "managed" | "plugin" | "extra";
+export type SkillScope = "agent" | "global";
+export interface AgentSkillsLoadConfig {
+    extraDirs?: string[];
+}
+export interface AgentSkillsPromptConfig {
+    maxSkills?: number;
+    maxCharsPerSkill?: number;
+    maxTotalChars?: number;
+    includeContent?: boolean;
+}
+export interface AgentSkillsConfig {
+    enabled?: boolean;
+    includeWorkspace?: boolean;
+    includeManaged?: boolean;
+    load?: AgentSkillsLoadConfig;
+    prompt?: AgentSkillsPromptConfig;
+}
+export interface SkillFrontmatter {
+    name?: string;
+    description?: string;
+    enabled?: boolean;
+    userInvocable?: boolean;
+    disableModelInvocation?: boolean;
+}
+export interface ResolvedSkill {
+    id: string;
+    name: string;
+    description: string;
+    source: SkillSource;
+    skillDir: string;
+    skillFilePath: string;
+    content: string;
+    frontmatter: SkillFrontmatter;
+}
+export interface SkillsPromptResult {
+    prompt: string;
+    skills: ResolvedSkill[];
+}
+export interface InstallSkillRequest {
+    agentId?: string;
+    skillName: string;
+    sourcePath?: string;
+    description?: string;
+    content?: string;
+    scope?: SkillScope;
+}
+export interface InstallSkillResult {
+    scope: SkillScope;
+    agentId?: string;
+    skillId: string;
+    skillName: string;
+    source: "managed" | "source-path" | "generated";
+    installedPath: string;
+    replaced: boolean;
+}
+export declare const DEFAULT_SKILLS_CONFIG: Required<Omit<AgentSkillsConfig, "load" | "prompt">> & {
+    load: Required<AgentSkillsLoadConfig>;
+    prompt: Required<AgentSkillsPromptConfig>;
+};
+export declare function resolveSkillsConfig(input: AgentSkillsConfig | undefined): typeof DEFAULT_SKILLS_CONFIG;
+export declare function resolveSkillAgentId(value: string | undefined): string;

package/dist/core/skills/domain/skill.js

@@ -0,0 +1,46 @@
+import { DEFAULT_AGENT_ID } from "../../domain/agent-id.js";
+export const DEFAULT_SKILLS_CONFIG = {
+    enabled: true,
+    includeWorkspace: true,
+    includeManaged: true,
+    load: {
+        extraDirs: []
+    },
+    prompt: {
+        maxSkills: 12,
+        maxCharsPerSkill: 6_000,
+        maxTotalChars: 36_000,
+        includeContent: true
+    }
+};
+export function resolveSkillsConfig(input) {
+    const prompt = input?.prompt;
+    const load = input?.load;
+    return {
+        enabled: input?.enabled ?? DEFAULT_SKILLS_CONFIG.enabled,
+        includeWorkspace: input?.includeWorkspace ?? DEFAULT_SKILLS_CONFIG.includeWorkspace,
+        includeManaged: input?.includeManaged ?? DEFAULT_SKILLS_CONFIG.includeManaged,
+        load: {
+            extraDirs: Array.isArray(load?.extraDirs)
+                ? load.extraDirs.map((value) => value.trim()).filter(Boolean)
+                : DEFAULT_SKILLS_CONFIG.load.extraDirs
+        },
+        prompt: {
+            maxSkills: asPositiveInt(prompt?.maxSkills, DEFAULT_SKILLS_CONFIG.prompt.maxSkills),
+            maxCharsPerSkill: asPositiveInt(prompt?.maxCharsPerSkill, DEFAULT_SKILLS_CONFIG.prompt.maxCharsPerSkill),
+            maxTotalChars: asPositiveInt(prompt?.maxTotalChars, DEFAULT_SKILLS_CONFIG.prompt.maxTotalChars),
+            includeContent: prompt?.includeContent ?? DEFAULT_SKILLS_CONFIG.prompt.includeContent
+        }
+    };
+}
+export function resolveSkillAgentId(value) {
+    const normalized = value?.trim().toLowerCase();
+    return normalized || DEFAULT_AGENT_ID;
+}
+function asPositiveInt(value, fallback) {
+    if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+        return fallback;
+    }
+    return Math.floor(value);
+}
+//# sourceMappingURL=skill.js.map

package/dist/core/skills/domain/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../../../src/core/skills/domain/skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAmE5D,MAAM,CAAC,MAAM,qBAAqB,GAG9B;IACF,OAAO,EAAE,IAAI;IACb,gBAAgB,EAAE,IAAI;IACtB,cAAc,EAAE,IAAI;IACpB,IAAI,EAAE;QACJ,SAAS,EAAE,EAAE;KACd;IACD,MAAM,EAAE;QACN,SAAS,EAAE,EAAE;QACb,gBAAgB,EAAE,KAAK;QACvB,aAAa,EAAE,MAAM;QACrB,cAAc,EAAE,IAAI;KACrB;CACF,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,KAAoC;IACtE,MAAM,MAAM,GAAG,KAAK,EAAE,MAAM,CAAC;IAC7B,MAAM,IAAI,GAAG,KAAK,EAAE,IAAI,CAAC;IACzB,OAAO;QACL,OAAO,EAAE,KAAK,EAAE,OAAO,IAAI,qBAAqB,CAAC,OAAO;QACxD,gBAAgB,EAAE,KAAK,EAAE,gBAAgB,IAAI,qBAAqB,CAAC,gBAAgB;QACnF,cAAc,EAAE,KAAK,EAAE,cAAc,IAAI,qBAAqB,CAAC,cAAc;QAC7E,IAAI,EAAE;YACJ,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;gBACvC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;gBAC7D,CAAC,CAAC,qBAAqB,CAAC,IAAI,CAAC,SAAS;SACzC;QACD,MAAM,EAAE;YACN,SAAS,EAAE,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,qBAAqB,CAAC,MAAM,CAAC,SAAS,CAAC;YACnF,gBAAgB,EAAE,aAAa,CAAC,MAAM,EAAE,gBAAgB,EAAE,qBAAqB,CAAC,MAAM,CAAC,gBAAgB,CAAC;YACxG,aAAa,EAAE,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,qBAAqB,CAAC,MAAM,CAAC,aAAa,CAAC;YAC/F,cAAc,EAAE,MAAM,EAAE,cAAc,IAAI,qBAAqB,CAAC,MAAM,CAAC,cAAc;SACtF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAyB;IAC3D,MAAM,UAAU,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC/C,OAAO,UAAU,IAAI,gBAAgB,CAAC;AACxC,CAAC;AAED,SAAS,aAAa,CAAC,KAAc,EAAE,QAAgB;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACvE,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/dist/core/skills/index.d.ts

@@ -0,0 +1,3 @@
+export { SkillService } from "./application/skill.service.js";
+export type { AgentSkillsConfig, AgentSkillsLoadConfig, AgentSkillsPromptConfig, InstallSkillRequest, InstallSkillResult, ResolvedSkill, SkillFrontmatter, SkillScope, SkillSource, SkillsPromptResult } from "./domain/skill.js";
+export { DEFAULT_SKILLS_CONFIG, resolveSkillsConfig } from "./domain/skill.js";

package/dist/core/skills/index.js

@@ -0,0 +1,3 @@
+export { SkillService } from "./application/skill.service.js";
+export { DEFAULT_SKILLS_CONFIG, resolveSkillsConfig } from "./domain/skill.js";
+//# sourceMappingURL=index.js.map

package/dist/core/skills/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/skills/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAa9D,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/core/templates/default-templates.d.ts

@@ -0,0 +1,19 @@
+import type { AgentIdentity } from "../domain/agent.js";
+import type { AgentsIndex, OpenGoatConfig } from "../domain/opengoat-paths.js";
+export { DEFAULT_AGENT_ID } from "../domain/agent-id.js";
+export declare function renderGlobalConfig(nowIso: string): OpenGoatConfig;
+export declare function renderAgentsIndex(nowIso: string, agents: string[]): AgentsIndex;
+export declare function renderGlobalConfigMarkdown(): string;
+export declare function renderWorkspaceAgentsMarkdown(agent: AgentIdentity, providerId?: string): string;
+export declare function renderWorkspaceContextMarkdown(agent: AgentIdentity): string;
+export declare function renderWorkspaceSoulMarkdown(agent: AgentIdentity): string;
+export declare function renderWorkspaceToolsMarkdown(): string;
+export declare function renderWorkspaceIdentityMarkdown(agent: AgentIdentity): string;
+export declare function renderWorkspaceUserMarkdown(): string;
+export declare function renderWorkspaceHeartbeatMarkdown(): string;
+export declare function renderWorkspaceBootstrapMarkdown(agent: AgentIdentity): string;
+export declare function renderDefaultOrchestratorSkillMarkdown(): string;
+export declare function renderWorkspaceMetadata(agent: AgentIdentity): Record<string, unknown>;
+export declare function renderInternalAgentConfig(agent: AgentIdentity): Record<string, unknown>;
+export declare function renderInternalAgentMemoryMarkdown(agent: AgentIdentity): string;
+export declare function renderInternalAgentState(): Record<string, unknown>;