@clawmasons/shared 0.1.0 → 0.1.1

package/README.md

@@ -0,0 +1,7 @@
+# @clawmasons/shared
+
+Shared types, schemas, and utilities for the Mason CLI
+
+## More Information
+
+This package is part of the [Mason](https://github.com/clawmasons/mason) monorepo. See the [main README](https://github.com/clawmasons/mason/blob/main/README.md) for full documentation.

package/dist/mason/index.d.ts

@@ -0,0 +1,3 @@
+export { scanProject, type ScanResult, type DiscoveredSkill, type DiscoveredCommand, type DiscoveredMcpServer, } from "./scanner.js";
+export { proposeRoleMd, type ProposeOptions, } from "./proposer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/mason/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mason/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,aAAa,EACb,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC"}

package/dist/mason/index.js

@@ -0,0 +1,5 @@
+// Scanner
+export { scanProject, } from "./scanner.js";
+// Proposer
+export { proposeRoleMd, } from "./proposer.js";
+//# sourceMappingURL=index.js.map

package/dist/mason/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mason/index.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,OAAO,EACL,WAAW,GAKZ,MAAM,cAAc,CAAC;AAEtB,WAAW;AACX,OAAO,EACL,aAAa,GAEd,MAAM,eAAe,CAAC"}

package/dist/mason/proposer.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Mason ROLE.md Proposer — generates draft ROLE.md from scanner results.
+ *
+ * Takes a ScanResult and produces a valid ROLE.md string with:
+ * - YAML frontmatter populated from discovered configuration
+ * - Least-privilege MCP server permissions (empty allow lists)
+ * - Credentials extracted from MCP server env keys
+ * - Default container ignore paths
+ * - System prompt as markdown body
+ */
+import type { ScanResult } from "./scanner.js";
+export interface ProposeOptions {
+    /** Role name override (defaults to project directory name) */
+    roleName?: string;
+    /** Role description override (defaults to a placeholder) */
+    description?: string;
+    /** Target dialect for the ROLE.md (defaults to "claude-code-agent") */
+    targetDialect?: string;
+}
+/**
+ * Generate a draft ROLE.md from scanner results.
+ *
+ * The generated ROLE.md:
+ * - Uses the Claude Code dialect by default
+ * - Maps discovered skills, commands, and MCP servers to frontmatter fields
+ * - Applies least-privilege permissions (empty tools.allow lists)
+ * - Extracts credentials from MCP server env keys with empty values
+ * - Includes default container ignore paths
+ * - Uses the discovered system prompt as the markdown body
+ *
+ * @param scanResult - Output from scanProject()
+ * @param options - Optional overrides for role name, description, dialect
+ * @returns Valid ROLE.md string
+ */
+export declare function proposeRoleMd(scanResult: ScanResult, options?: ProposeOptions): string;
+//# sourceMappingURL=proposer.d.ts.map

package/dist/mason/proposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proposer.d.ts","sourceRoot":"","sources":["../../src/mason/proposer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAM/C,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE,cAAc,GACvB,MAAM,CAuER"}

package/dist/mason/proposer.js

@@ -0,0 +1,121 @@
+/**
+ * Mason ROLE.md Proposer — generates draft ROLE.md from scanner results.
+ *
+ * Takes a ScanResult and produces a valid ROLE.md string with:
+ * - YAML frontmatter populated from discovered configuration
+ * - Least-privilege MCP server permissions (empty allow lists)
+ * - Credentials extracted from MCP server env keys
+ * - Default container ignore paths
+ * - System prompt as markdown body
+ */
+import { dump as yamlDump } from "js-yaml";
+import { basename } from "node:path";
+// ---------------------------------------------------------------------------
+// Proposer
+// ---------------------------------------------------------------------------
+/**
+ * Generate a draft ROLE.md from scanner results.
+ *
+ * The generated ROLE.md:
+ * - Uses the Claude Code dialect by default
+ * - Maps discovered skills, commands, and MCP servers to frontmatter fields
+ * - Applies least-privilege permissions (empty tools.allow lists)
+ * - Extracts credentials from MCP server env keys with empty values
+ * - Includes default container ignore paths
+ * - Uses the discovered system prompt as the markdown body
+ *
+ * @param scanResult - Output from scanProject()
+ * @param options - Optional overrides for role name, description, dialect
+ * @returns Valid ROLE.md string
+ */
+export function proposeRoleMd(scanResult, options) {
+    const roleName = options?.roleName ?? basename(scanResult.projectDir);
+    const description = options?.description ?? `Role for ${roleName} project`;
+    // Build frontmatter object
+    const frontmatter = {
+        name: roleName,
+        description,
+    };
+    // Commands (Claude dialect field name)
+    if (scanResult.commands.length > 0) {
+        frontmatter.commands = scanResult.commands.map((c) => c.name);
+    }
+    // Skills
+    if (scanResult.skills.length > 0) {
+        frontmatter.skills = scanResult.skills.map((s) => s.name);
+    }
+    // MCP Servers with least-privilege permissions
+    if (scanResult.mcpServers.length > 0) {
+        frontmatter.mcp_servers = scanResult.mcpServers.map((server) => {
+            const entry = {
+                name: server.name,
+                tools: {
+                    allow: [], // Least-privilege: no tools granted by default
+                },
+            };
+            if (server.command) {
+                entry.command = server.command;
+            }
+            if (server.args && server.args.length > 0) {
+                entry.args = server.args;
+            }
+            if (server.url) {
+                entry.url = server.url;
+            }
+            return entry;
+        });
+    }
+    // Container requirements with default ignore paths
+    frontmatter.container = {
+        ignore: {
+            paths: [".mason/", ".claude/", ".env"],
+        },
+    };
+    // Governance — extract credentials from MCP server env
+    const credentials = extractCredentials(scanResult);
+    if (credentials.length > 0) {
+        frontmatter.credentials = credentials;
+    }
+    // Generate YAML frontmatter
+    const yamlStr = yamlDump(frontmatter, {
+        lineWidth: -1,
+        noRefs: true,
+        quotingType: "'",
+        forceQuotes: false,
+    }).trim();
+    // Build markdown body
+    const body = scanResult.systemPrompt ?? generatePlaceholderPrompt(roleName);
+    return `---\n${yamlStr}\n---\n\n${body}\n`;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Extract credential names from MCP server env configurations.
+ * Keys with empty string values are treated as credential references
+ * (the actual values are provided at runtime by the credential service).
+ */
+function extractCredentials(scanResult) {
+    const credentialSet = new Set();
+    for (const server of scanResult.mcpServers) {
+        if (!server.env)
+            continue;
+        for (const [key, value] of Object.entries(server.env)) {
+            // Empty string values indicate credential placeholders
+            if (value === "") {
+                credentialSet.add(key);
+            }
+        }
+    }
+    return [...credentialSet].sort();
+}
+/**
+ * Generate a minimal placeholder system prompt.
+ */
+function generatePlaceholderPrompt(roleName) {
+    return `You are an AI assistant operating in the ${roleName} role.
+
+Review and customize this system prompt to describe the specific behavior,
+constraints, and capabilities for this role.`;
+}
+//# sourceMappingURL=proposer.js.map

package/dist/mason/proposer.js.map

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

package/dist/mason/scanner.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Mason Project Scanner — discovers existing project configuration.
+ *
+ * Scans a project directory for:
+ * - Skills in `.<agent>/skills/` directories
+ * - Commands in `.<agent>/commands/` directories
+ * - MCP server configurations from agent settings files
+ * - System prompts from CLAUDE.md, AGENTS.md
+ *
+ * Uses the dialect registry to automatically scan all registered agent directories.
+ */
+export interface DiscoveredSkill {
+    /** Skill name (derived from directory name) */
+    name: string;
+    /** Absolute path to the skill directory */
+    path: string;
+    /** Dialect that owns this skill (e.g., "claude-code-agent") */
+    dialect: string;
+}
+export interface DiscoveredCommand {
+    /** Command name (derived from file name without extension, may include subdirectory) */
+    name: string;
+    /** Absolute path to the command file */
+    path: string;
+    /** Dialect that owns this command */
+    dialect: string;
+}
+export interface DiscoveredMcpServer {
+    /** Server name (key from settings) */
+    name: string;
+    /** Command to run the server */
+    command?: string;
+    /** Arguments for the command */
+    args?: string[];
+    /** URL for remote servers */
+    url?: string;
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Dialect that owns this configuration */
+    dialect: string;
+}
+export interface ScanResult {
+    /** Absolute path to the scanned project directory */
+    projectDir: string;
+    /** Discovered skills across all dialect directories */
+    skills: DiscoveredSkill[];
+    /** Discovered commands/slash-commands */
+    commands: DiscoveredCommand[];
+    /** Discovered MCP server configurations */
+    mcpServers: DiscoveredMcpServer[];
+    /** System prompt content from CLAUDE.md or AGENTS.md */
+    systemPrompt: string | undefined;
+}
+/**
+ * Scan a project directory for existing agent configuration.
+ *
+ * Iterates over all registered dialects, scanning each agent directory for
+ * skills, commands, and MCP server configurations.
+ *
+ * @param projectDir - Absolute path to the project root
+ * @returns Scan results with all discovered configuration
+ */
+export declare function scanProject(projectDir: string): Promise<ScanResult>;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/mason/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/mason/scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,6BAA6B;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,yCAAyC;IACzC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,2CAA2C;IAC3C,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,wDAAwD;IACxD,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAMD;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAqCzE"}

package/dist/mason/scanner.js

@@ -0,0 +1,212 @@
+/**
+ * Mason Project Scanner — discovers existing project configuration.
+ *
+ * Scans a project directory for:
+ * - Skills in `.<agent>/skills/` directories
+ * - Commands in `.<agent>/commands/` directories
+ * - MCP server configurations from agent settings files
+ * - System prompts from CLAUDE.md, AGENTS.md
+ *
+ * Uses the dialect registry to automatically scan all registered agent directories.
+ */
+import { readdir, readFile, stat } from "node:fs/promises";
+import { join, relative } from "node:path";
+import { getAllDialects } from "../role/dialect-registry.js";
+// ---------------------------------------------------------------------------
+// Main Scanner
+// ---------------------------------------------------------------------------
+/**
+ * Scan a project directory for existing agent configuration.
+ *
+ * Iterates over all registered dialects, scanning each agent directory for
+ * skills, commands, and MCP server configurations.
+ *
+ * @param projectDir - Absolute path to the project root
+ * @returns Scan results with all discovered configuration
+ */
+export async function scanProject(projectDir) {
+    const dialects = getAllDialects();
+    const skills = [];
+    const commands = [];
+    const mcpServers = [];
+    for (const dialect of dialects) {
+        const agentDir = join(projectDir, `.${dialect.directory}`);
+        if (!(await dirExists(agentDir))) {
+            continue;
+        }
+        // Scan skills
+        const discoveredSkills = await scanSkills(agentDir, dialect);
+        skills.push(...discoveredSkills);
+        // Scan commands
+        const discoveredCommands = await scanCommands(agentDir, dialect);
+        commands.push(...discoveredCommands);
+        // Scan MCP server configs
+        const discoveredServers = await scanMcpServers(agentDir, dialect);
+        mcpServers.push(...discoveredServers);
+    }
+    // Read system prompt
+    const systemPrompt = await readSystemPrompt(projectDir);
+    return {
+        projectDir,
+        skills,
+        commands,
+        mcpServers,
+        systemPrompt,
+    };
+}
+// ---------------------------------------------------------------------------
+// Skills Scanner
+// ---------------------------------------------------------------------------
+async function scanSkills(agentDir, dialect) {
+    const skillsDir = join(agentDir, "skills");
+    if (!(await dirExists(skillsDir))) {
+        return [];
+    }
+    const results = [];
+    const entries = await readdir(skillsDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const skillDir = join(skillsDir, entry.name);
+        const skillMdPath = join(skillDir, "SKILL.md");
+        if (await fileExists(skillMdPath)) {
+            results.push({
+                name: entry.name,
+                path: skillDir,
+                dialect: dialect.name,
+            });
+        }
+    }
+    return results;
+}
+// ---------------------------------------------------------------------------
+// Commands Scanner
+// ---------------------------------------------------------------------------
+async function scanCommands(agentDir, dialect) {
+    const commandsDir = join(agentDir, "commands");
+    if (!(await dirExists(commandsDir))) {
+        return [];
+    }
+    const results = [];
+    await walkCommands(commandsDir, commandsDir, dialect, results);
+    return results;
+}
+async function walkCommands(baseDir, currentDir, dialect, results) {
+    const entries = await readdir(currentDir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = join(currentDir, entry.name);
+        if (entry.isDirectory()) {
+            await walkCommands(baseDir, fullPath, dialect, results);
+        }
+        else if (entry.isFile() && entry.name.endsWith(".md")) {
+            const relPath = relative(baseDir, fullPath);
+            // Remove .md extension for command name
+            const name = relPath.replace(/\.md$/, "");
+            results.push({
+                name,
+                path: fullPath,
+                dialect: dialect.name,
+            });
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// MCP Server Scanner
+// ---------------------------------------------------------------------------
+async function scanMcpServers(agentDir, dialect) {
+    // Read settings files (base + local)
+    const baseSettings = await readJsonFile(join(agentDir, "settings.json"));
+    const localSettings = await readJsonFile(join(agentDir, "settings.local.json"));
+    // Merge: local overrides base
+    const mergedServers = {};
+    if (baseSettings?.mcpServers && typeof baseSettings.mcpServers === "object") {
+        Object.assign(mergedServers, baseSettings.mcpServers);
+    }
+    if (localSettings?.mcpServers && typeof localSettings.mcpServers === "object") {
+        Object.assign(mergedServers, localSettings.mcpServers);
+    }
+    const results = [];
+    for (const [name, config] of Object.entries(mergedServers)) {
+        if (typeof config !== "object" || config === null)
+            continue;
+        const serverConfig = config;
+        const server = {
+            name,
+            dialect: dialect.name,
+        };
+        if (typeof serverConfig.command === "string") {
+            server.command = serverConfig.command;
+        }
+        if (Array.isArray(serverConfig.args)) {
+            server.args = serverConfig.args.map(String);
+        }
+        if (typeof serverConfig.url === "string") {
+            server.url = serverConfig.url;
+        }
+        if (typeof serverConfig.env === "object" &&
+            serverConfig.env !== null &&
+            !Array.isArray(serverConfig.env)) {
+            server.env = serverConfig.env;
+        }
+        results.push(server);
+    }
+    return results;
+}
+// ---------------------------------------------------------------------------
+// System Prompt Reader
+// ---------------------------------------------------------------------------
+async function readSystemPrompt(projectDir) {
+    // Check in priority order
+    const candidates = [
+        join(projectDir, "CLAUDE.md"),
+        join(projectDir, "AGENTS.md"),
+        join(projectDir, ".claude", "AGENTS.md"),
+    ];
+    for (const candidate of candidates) {
+        if (await fileExists(candidate)) {
+            try {
+                const content = await readFile(candidate, "utf-8");
+                return content.trim();
+            }
+            catch {
+                // Continue to next candidate
+            }
+        }
+    }
+    return undefined;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+async function dirExists(path) {
+    try {
+        const s = await stat(path);
+        return s.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+async function fileExists(path) {
+    try {
+        const s = await stat(path);
+        return s.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+async function readJsonFile(path) {
+    try {
+        const content = await readFile(path, "utf-8");
+        const parsed = JSON.parse(content);
+        if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=scanner.js.map

package/dist/mason/scanner.js.map

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

package/dist/role/adapter.d.ts

@@ -21,7 +21,7 @@ export declare class AdapterError extends Error {
  * Convert a Role into a ResolvedAgent that existing materializers accept.
  *
  * @param role - A validated Role from the ROLE_TYPES pipeline
- * @param agentType - The target agent dialect name (e.g., "claude-code", "codex", "aider")
+ * @param agentType - The target agent dialect name (e.g., "claude-code-agent", "codex", "aider")
  * @returns A ResolvedAgent suitable for passing to any RuntimeMaterializer
  * @throws AdapterError if agentType does not match a registered dialect
  */

package/dist/role/adapter.js

@@ -23,7 +23,7 @@ export class AdapterError extends Error {
  * Convert a Role into a ResolvedAgent that existing materializers accept.
  *
  * @param role - A validated Role from the ROLE_TYPES pipeline
- * @param agentType - The target agent dialect name (e.g., "claude-code", "codex", "aider")
+ * @param agentType - The target agent dialect name (e.g., "claude-code-agent", "codex", "aider")
  * @returns A ResolvedAgent suitable for passing to any RuntimeMaterializer
  * @throws AdapterError if agentType does not match a registered dialect
  */
@@ -31,7 +31,7 @@ export function adaptRoleToResolvedAgent(role, agentType) {
     // Validate agent type against dialect registry
     const dialect = getDialect(agentType);
     if (!dialect) {
-        throw new AdapterError(`Unknown agent type "${agentType}". Must be a registered dialect (e.g., "claude-code", "codex", "aider", "mcp-agent").`);
+        throw new AdapterError(`Unknown agent type "${agentType}". Must be a registered dialect (e.g., "claude-code-agent", "codex", "aider", "mcp-agent").`);
     }
     const name = role.metadata.name;
     const version = role.metadata.version ?? "0.0.0";

package/dist/role/adapter.js.map

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

package/dist/role/dialect-registry.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Dialect Registry — maps agent directories to field name translations.
+ *
+ * Each supported agent runtime uses its own vocabulary in ROLE.md frontmatter.
+ * The registry normalizes these to generic ROLE_TYPES field names:
+ *   - tasks (Claude: commands, Codex: instructions, Aider: conventions)
+ *   - apps (all: mcp_servers)
+ *   - skills (all: skills)
+ *
+ * New runtimes are registered by calling `registerDialect()`.
+ */
+export interface DialectFieldMapping {
+    /** Agent-specific field name for tasks (e.g., "commands") */
+    tasks: string;
+    /** Agent-specific field name for apps (e.g., "mcp_servers") */
+    apps: string;
+    /** Agent-specific field name for skills (e.g., "skills") */
+    skills: string;
+}
+export interface DialectEntry {
+    /** Dialect identifier (e.g., "claude-code-agent") */
+    name: string;
+    /** Agent directory name without dot (e.g., "claude") */
+    directory: string;
+    /** Mapping from generic field names to agent-specific field names */
+    fieldMapping: DialectFieldMapping;
+}
+/**
+ * Register a new dialect entry. Overwrites if the same name already exists.
+ */
+export declare function registerDialect(entry: DialectEntry): void;
+/**
+ * Look up a dialect by its name (e.g., "claude-code-agent").
+ */
+export declare function getDialect(name: string): DialectEntry | undefined;
+/**
+ * Look up a dialect by its directory name (e.g., "claude").
+ * The directory should not include the leading dot.
+ */
+export declare function getDialectByDirectory(directory: string): DialectEntry | undefined;
+/**
+ * Get all registered dialect entries.
+ */
+export declare function getAllDialects(): DialectEntry[];
+/**
+ * Get all known agent directory names (without dot prefix).
+ */
+export declare function getKnownDirectories(): string[];
+//# sourceMappingURL=dialect-registry.d.ts.map

package/dist/role/dialect-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialect-registry.d.ts","sourceRoot":"","sources":["../../src/role/dialect-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,YAAY,EAAE,mBAAmB,CAAC;CACnC;AAOD;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAGzD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEjE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAIjF;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,YAAY,EAAE,CAE/C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C"}