@actant/core 0.2.0 → 0.2.1

package/dist/{skill-md-parser-2HXC4AAW.js → chunk-DYGZP4MW.js}

@@ -100,16 +100,22 @@ function parseSkillMdContent(raw) {
   if (actantTags) {
     tags.push(...actantTags.split(",").map((t) => t.trim()).filter(Boolean));
   }
+  const allowedToolsRaw = meta["allowed-tools"];
+  const allowedTools = allowedToolsRaw ? allowedToolsRaw.split(/\s+/).filter(Boolean) : void 0;
   return {
     name,
     description: meta.description || void 0,
     version: meta["metadata.version"] || meta.version || void 0,
     content,
-    tags: tags.length > 0 ? tags : void 0
+    tags: tags.length > 0 ? tags : void 0,
+    license: meta.license || void 0,
+    compatibility: meta.compatibility || void 0,
+    allowedTools
   };
 }
+
 export {
   parseSkillMd,
   parseSkillMdContent
 };
-//# sourceMappingURL=skill-md-parser-2HXC4AAW.js.map
+//# sourceMappingURL=chunk-DYGZP4MW.js.map

package/dist/{skill-md-parser-2HXC4AAW.js.map → chunk-DYGZP4MW.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/source/skill-md-parser.ts"],"sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport type { SkillDefinition } from \"@actant/shared\";\n\n/**\n * Parses a SKILL.md file (Agent Skills / skill.sh format) into a SkillDefinition.\n * Format:\n * ---\n * name: skill-name\n * description: ...\n * license: MIT\n * metadata:\n *   author: ...\n *   version: \"1.0.0\"\n *   actant-tags: \"tag1,tag2\"\n * ---\n *\n * # Skill content starts here...\n */\nexport async function parseSkillMd(filePath: string): Promise<SkillDefinition | null> {\n  try {\n    const raw = await readFile(filePath, \"utf-8\");\n    return parseSkillMdContent(raw);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Parses YAML frontmatter, handling single-line, quoted, and block scalar values.\n * Supports: key: value, key: \"quoted\", key: | (literal block), key: > (folded block).\n */\nfunction parseYamlFrontmatter(frontmatter: string): Record<string, string> {\n  const meta: Record<string, string> = {};\n  const lines = frontmatter.split(\"\\n\");\n  let i = 0;\n  let inMetadata = false;\n\n  while (i < lines.length) {\n    const line = lines[i];\n    if (line === undefined) break;\n    const trimmed = line.trim();\n\n    if (trimmed === \"metadata:\") {\n      inMetadata = true;\n      i++;\n      continue;\n    }\n\n    const isNested = inMetadata && (line.startsWith(\"  \") || line.startsWith(\"\\t\"));\n    const keyPrefix = isNested ? \"metadata.\" : \"\";\n\n    const blockMatch = trimmed.match(/^(\\w[\\w-]*)\\s*:\\s*(\\||>)\\s*$/);\n    if (blockMatch) {\n      const key = keyPrefix + (blockMatch[1] ?? \"\");\n      if (!isNested) inMetadata = false;\n\n      const keyLineIndent = line.search(/\\S/);\n      const blockIndent = keyLineIndent >= 0 ? keyLineIndent : line.length;\n      const blockLines: string[] = [];\n      i++;\n\n      while (i < lines.length) {\n        const nextLine = lines[i];\n        if (nextLine === undefined) break;\n        const nextIndent = nextLine.search(/\\S/);\n        const isEmpty = nextLine.trim() === \"\";\n\n        if (isEmpty) {\n          blockLines.push(nextLine);\n          i++;\n          continue;\n        }\n        if (nextIndent !== -1 && nextIndent <= blockIndent) {\n          break;\n        }\n        blockLines.push(nextLine);\n        i++;\n      }\n\n      const nonEmpty = blockLines.filter((l) => l.trim() !== \"\");\n      const minIndent =\n        nonEmpty.length > 0 ? Math.min(...nonEmpty.map((l) => l.search(/\\S/))) : 0;\n      meta[key] =\n        blockMatch[2] === \"|\"\n          ? blockLines\n              .map((l) => (l.trim() === \"\" ? \"\" : l.slice(minIndent)))\n              .join(\"\\n\")\n              .trimEnd()\n          : blockLines.map((l) => l.trim()).join(\" \").trim();\n      continue;\n    }\n\n    const quotedMatch = trimmed.match(/^(\\w[\\w-]*)\\s*:\\s*\"((?:[^\"\\\\]|\\\\.)*)\"\\s*$/);\n    if (quotedMatch) {\n      const key = keyPrefix + (quotedMatch[1] ?? \"\");\n      if (!isNested) inMetadata = false;\n      try {\n        meta[key] = JSON.parse(`\"${(quotedMatch[2] ?? \"\").replace(/\\\\/g, \"\\\\\\\\\")}\"`);\n      } catch {\n        meta[key] = (quotedMatch[2] ?? \"\").replace(/\\\\\"/g, '\"');\n      }\n      i++;\n      continue;\n    }\n\n    const match = trimmed.match(/^(\\w[\\w-]*)\\s*:\\s*(.*)$/);\n    if (match?.[1] !== undefined) {\n      const key = keyPrefix + match[1];\n      if (!isNested) inMetadata = false;\n      let value = (match[2] ?? \"\").trim();\n      if (value.startsWith('\"') && value.endsWith('\"')) {\n        try {\n          value = JSON.parse(value);\n        } catch {\n          value = value.slice(1, -1).replace(/\\\\\"/g, '\"');\n        }\n      }\n      meta[key] = value;\n      i++;\n      continue;\n    }\n\n    if (!isNested) inMetadata = false;\n    i++;\n  }\n\n  return meta;\n}\n\nexport function parseSkillMdContent(raw: string): SkillDefinition | null {\n  // Check for YAML frontmatter\n  if (!raw.startsWith(\"---\")) return null;\n\n  const endIdx = raw.indexOf(\"---\", 3);\n  if (endIdx === -1) return null;\n\n  const frontmatter = raw.substring(3, endIdx).trim();\n  const content = raw.substring(endIdx + 3).trim();\n\n  // YAML parsing (handles single-line, quoted, and block scalars)\n  const meta = parseYamlFrontmatter(frontmatter);\n\n  const name = meta.name;\n  if (!name) return null;\n\n  const tags: string[] = [];\n  const actantTags = meta[\"metadata.actant-tags\"];\n  if (actantTags) {\n    tags.push(...actantTags.split(\",\").map((t) => t.trim()).filter(Boolean));\n  }\n\n  return {\n    name,\n    description: meta.description || undefined,\n    version: meta[\"metadata.version\"] || meta.version || undefined,\n    content,\n    tags: tags.length > 0 ? tags : undefined,\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/source/skill-md-parser.ts"],"sourcesContent":["import { readFile } from \"node:fs/promises\";\nimport type { SkillDefinition } from \"@actant/shared\";\n\n/**\n * Parses a SKILL.md file (Agent Skills / skill.sh format) into a SkillDefinition.\n * Format:\n * ---\n * name: skill-name\n * description: ...\n * license: MIT\n * metadata:\n *   author: ...\n *   version: \"1.0.0\"\n *   actant-tags: \"tag1,tag2\"\n * ---\n *\n * # Skill content starts here...\n */\nexport async function parseSkillMd(filePath: string): Promise<SkillDefinition | null> {\n  try {\n    const raw = await readFile(filePath, \"utf-8\");\n    return parseSkillMdContent(raw);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Parses YAML frontmatter, handling single-line, quoted, and block scalar values.\n * Supports: key: value, key: \"quoted\", key: | (literal block), key: > (folded block).\n */\nfunction parseYamlFrontmatter(frontmatter: string): Record<string, string> {\n  const meta: Record<string, string> = {};\n  const lines = frontmatter.split(\"\\n\");\n  let i = 0;\n  let inMetadata = false;\n\n  while (i < lines.length) {\n    const line = lines[i];\n    if (line === undefined) break;\n    const trimmed = line.trim();\n\n    if (trimmed === \"metadata:\") {\n      inMetadata = true;\n      i++;\n      continue;\n    }\n\n    const isNested = inMetadata && (line.startsWith(\"  \") || line.startsWith(\"\\t\"));\n    const keyPrefix = isNested ? \"metadata.\" : \"\";\n\n    const blockMatch = trimmed.match(/^(\\w[\\w-]*)\\s*:\\s*(\\||>)\\s*$/);\n    if (blockMatch) {\n      const key = keyPrefix + (blockMatch[1] ?? \"\");\n      if (!isNested) inMetadata = false;\n\n      const keyLineIndent = line.search(/\\S/);\n      const blockIndent = keyLineIndent >= 0 ? keyLineIndent : line.length;\n      const blockLines: string[] = [];\n      i++;\n\n      while (i < lines.length) {\n        const nextLine = lines[i];\n        if (nextLine === undefined) break;\n        const nextIndent = nextLine.search(/\\S/);\n        const isEmpty = nextLine.trim() === \"\";\n\n        if (isEmpty) {\n          blockLines.push(nextLine);\n          i++;\n          continue;\n        }\n        if (nextIndent !== -1 && nextIndent <= blockIndent) {\n          break;\n        }\n        blockLines.push(nextLine);\n        i++;\n      }\n\n      const nonEmpty = blockLines.filter((l) => l.trim() !== \"\");\n      const minIndent =\n        nonEmpty.length > 0 ? Math.min(...nonEmpty.map((l) => l.search(/\\S/))) : 0;\n      meta[key] =\n        blockMatch[2] === \"|\"\n          ? blockLines\n              .map((l) => (l.trim() === \"\" ? \"\" : l.slice(minIndent)))\n              .join(\"\\n\")\n              .trimEnd()\n          : blockLines.map((l) => l.trim()).join(\" \").trim();\n      continue;\n    }\n\n    const quotedMatch = trimmed.match(/^(\\w[\\w-]*)\\s*:\\s*\"((?:[^\"\\\\]|\\\\.)*)\"\\s*$/);\n    if (quotedMatch) {\n      const key = keyPrefix + (quotedMatch[1] ?? \"\");\n      if (!isNested) inMetadata = false;\n      try {\n        meta[key] = JSON.parse(`\"${(quotedMatch[2] ?? \"\").replace(/\\\\/g, \"\\\\\\\\\")}\"`);\n      } catch {\n        meta[key] = (quotedMatch[2] ?? \"\").replace(/\\\\\"/g, '\"');\n      }\n      i++;\n      continue;\n    }\n\n    const match = trimmed.match(/^(\\w[\\w-]*)\\s*:\\s*(.*)$/);\n    if (match?.[1] !== undefined) {\n      const key = keyPrefix + match[1];\n      if (!isNested) inMetadata = false;\n      let value = (match[2] ?? \"\").trim();\n      if (value.startsWith('\"') && value.endsWith('\"')) {\n        try {\n          value = JSON.parse(value);\n        } catch {\n          value = value.slice(1, -1).replace(/\\\\\"/g, '\"');\n        }\n      }\n      meta[key] = value;\n      i++;\n      continue;\n    }\n\n    if (!isNested) inMetadata = false;\n    i++;\n  }\n\n  return meta;\n}\n\nexport function parseSkillMdContent(raw: string): SkillDefinition | null {\n  // Check for YAML frontmatter\n  if (!raw.startsWith(\"---\")) return null;\n\n  const endIdx = raw.indexOf(\"---\", 3);\n  if (endIdx === -1) return null;\n\n  const frontmatter = raw.substring(3, endIdx).trim();\n  const content = raw.substring(endIdx + 3).trim();\n\n  // YAML parsing (handles single-line, quoted, and block scalars)\n  const meta = parseYamlFrontmatter(frontmatter);\n\n  const name = meta.name;\n  if (!name) return null;\n\n  const tags: string[] = [];\n  const actantTags = meta[\"metadata.actant-tags\"];\n  if (actantTags) {\n    tags.push(...actantTags.split(\",\").map((t) => t.trim()).filter(Boolean));\n  }\n\n  const allowedToolsRaw = meta[\"allowed-tools\"];\n  const allowedTools = allowedToolsRaw\n    ? allowedToolsRaw.split(/\\s+/).filter(Boolean)\n    : undefined;\n\n  return {\n    name,\n    description: meta.description || undefined,\n    version: meta[\"metadata.version\"] || meta.version || undefined,\n    content,\n    tags: tags.length > 0 ? tags : undefined,\n    license: meta.license || undefined,\n    compatibility: meta.compatibility || undefined,\n    allowedTools,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { AgentBackendType, SkillDefinition, PromptDefinition, McpServerDefinition, PluginDefinition, WorkflowDefinition, PermissionsInput, Logger, ConfigValidationResult, DomainContextConfig, AgentBackendConfig, ModelProviderConfig, AgentTemplate, AgentInstanceMeta, LaunchMode, WorkspacePolicy, WorkDirConflict, InitializerStep, AgentStatus, ResolveResult, DetachResult, BackendDescriptor, AgentOpenMode, PermissionsConfig, SourceConfig, PackageManifest, PresetDefinition, GitHubSourceConfig, LocalSourceConfig, SourceEntry } from '@actant/shared';
+import { AgentBackendType, SkillDefinition, PromptDefinition, McpServerDefinition, PluginDefinition, WorkflowDefinition, PermissionsInput, Logger, ConfigValidationResult, DomainContextConfig, AgentBackendConfig, ModelProviderConfig, AgentTemplate, AgentInstanceMeta, LaunchMode, WorkspacePolicy, WorkDirConflict, InitializerStep, AgentStatus, ResolveResult, DetachResult, BackendDescriptor, AgentOpenMode, PermissionsConfig, SourceConfig, PackageManifest, PresetDefinition, GitHubSourceConfig, LocalSourceConfig, SourceEntry, ModelProviderDescriptor } from '@actant/shared';
 import { z } from 'zod/v4';
 import { EventEmitter } from 'node:events';
 import { Writable, Readable } from 'node:stream';
@@ -538,21 +538,32 @@ declare const AgentBackendSchema: z.ZodObject<{
     }>;
     config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strip>;
-declare const ModelProviderSchema: z.ZodObject<{
-    type: z.ZodEnum<{
+declare const ModelApiProtocolEnum: z.ZodEnum<{
+    custom: "custom";
+    openai: "openai";
+    anthropic: "anthropic";
+}>;
+type ApiProtocol = z.infer<typeof ModelApiProtocolEnum>;
+declare const ModelProviderSchema: z.ZodPipe<z.ZodObject<{
+    type: z.ZodString;
+    protocol: z.ZodOptional<z.ZodEnum<{
         custom: "custom";
-        anthropic: "anthropic";
         openai: "openai";
-        "openai-compatible": "openai-compatible";
-    }>;
-    protocol: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
-        http: "http";
-        websocket: "websocket";
-        grpc: "grpc";
-    }>>>;
+        anthropic: "anthropic";
+    }>>;
     baseUrl: z.ZodOptional<z.ZodString>;
     config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$strip>;
+}, z.core.$strip>, z.ZodTransform<{
+    protocol: ApiProtocol;
+    type: string;
+    baseUrl?: string | undefined;
+    config?: Record<string, unknown> | undefined;
+}, {
+    type: string;
+    protocol?: "custom" | "openai" | "anthropic" | undefined;
+    baseUrl?: string | undefined;
+    config?: Record<string, unknown> | undefined;
+}>>;
 declare const InitializerStepSchema: z.ZodObject<{
     type: z.ZodString;
     config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -656,21 +667,26 @@ declare const AgentTemplateSchema: z.ZodObject<{
         }>;
         config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>;
-    provider: z.ZodObject<{
-        type: z.ZodEnum<{
+    provider: z.ZodOptional<z.ZodPipe<z.ZodObject<{
+        type: z.ZodString;
+        protocol: z.ZodOptional<z.ZodEnum<{
             custom: "custom";
-            anthropic: "anthropic";
             openai: "openai";
-            "openai-compatible": "openai-compatible";
-        }>;
-        protocol: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
-            http: "http";
-            websocket: "websocket";
-            grpc: "grpc";
-        }>>>;
+            anthropic: "anthropic";
+        }>>;
         baseUrl: z.ZodOptional<z.ZodString>;
         config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-    }, z.core.$strip>;
+    }, z.core.$strip>, z.ZodTransform<{
+        protocol: ApiProtocol;
+        type: string;
+        baseUrl?: string | undefined;
+        config?: Record<string, unknown> | undefined;
+    }, {
+        type: string;
+        protocol?: "custom" | "openai" | "anthropic" | undefined;
+        baseUrl?: string | undefined;
+        config?: Record<string, unknown> | undefined;
+    }>>>;
     domainContext: z.ZodObject<{
         skills: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
         prompts: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
@@ -1150,6 +1166,16 @@ declare const AgentInstanceMetaSchema: z.ZodObject<{
         pi: "pi";
     }>>;
     backendConfig: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    providerConfig: z.ZodOptional<z.ZodObject<{
+        type: z.ZodString;
+        protocol: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+            custom: "custom";
+            openai: "openai";
+            anthropic: "anthropic";
+        }>>>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+        config: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
     status: z.ZodEnum<{
         error: "error";
         running: "running";
@@ -1937,6 +1963,8 @@ interface ComponentSource {
     readonly type: string;
     readonly packageName: string;
     readonly config: SourceConfig;
+    /** Filesystem root directory for this source's content. */
+    getRootDir(): string;
     fetch(): Promise<FetchResult>;
     sync(): Promise<FetchResult>;
     dispose(): Promise<void>;
@@ -1952,6 +1980,7 @@ declare class GitHubSource implements ComponentSource {
     readonly config: GitHubSourceConfig;
     private readonly cacheDir;
     constructor(packageName: string, config: GitHubSourceConfig, cacheDir: string);
+    getRootDir(): string;
     fetch(): Promise<FetchResult>;
     sync(): Promise<FetchResult>;
     dispose(): Promise<void>;
@@ -1965,6 +1994,7 @@ declare class LocalSource implements ComponentSource {
     readonly packageName: string;
     readonly config: LocalSourceConfig;
     constructor(packageName: string, config: LocalSourceConfig);
+    getRootDir(): string;
     fetch(): Promise<FetchResult>;
     sync(): Promise<FetchResult>;
     dispose(): Promise<void>;
@@ -2029,6 +2059,8 @@ declare class SourceManager {
     removeSource(name: string): Promise<boolean>;
     listSources(): SourceEntry[];
     hasSource(name: string): boolean;
+    /** Resolve a registered source name to its filesystem root directory. */
+    getSourceRootDir(name: string): string;
     listPresets(packageName?: string): PresetDefinition[];
     getPreset(qualifiedName: string): PresetDefinition | undefined;
     /**
@@ -2053,4 +2085,83 @@ declare class SourceManager {
     private buildSyncReport;
 }
 
-export { AgentBackendSchema, type AgentCommunicator, AgentInitializer, AgentInstanceMetaSchema, type AgentLauncher, AgentManager, type AgentProcess, AgentStatusSchema, type AgentTask, type AgentTemplateInput, type AgentTemplateOutput, AgentTemplateSchema, type AuditEntry, type BackendBuilder, BaseComponentManager, ClaudeCodeBuilder, ClaudeCodeCommunicator, type CommunicatorFactory, ComponentOriginSchema, type ComponentSource, type ComponentTypeHandler, ContextMaterializer, type CreateSessionOptions, type CronConfig, CronConfigSchema, CronInput, CursorBuilder, CursorCommunicator, CustomBuilder, type CustomBuilderConfig, DEFAULT_RESTART_POLICY, DEFAULT_SOURCE_CONFIG, DEFAULT_SOURCE_NAME, DomainContextSchema, type DomainManagers$1 as DomainManagers, EmployeeScheduler, ExecStep, ExecutionLog, type ExecutionRecord, type FetchResult, FileCopyStep, GitCloneStep, GitHubSource, type HeartbeatConfig, HeartbeatConfigSchema, HeartbeatInput, type HookConfig, HookConfigSchema, HookInput, InitializationPipeline, type InitializerOptions, InitializerSchema, InitializerStepExecutor, InitializerStepSchema, InputRouter, type InputSource, type InstanceOverrides, InstanceRegistry, type InstanceRegistryAdapter, type InstanceRegistryData, type InstanceRegistryEntry, type LaunchModeHandler, LaunchModeSchema, type LauncherConfig, type LauncherMode, LocalSource, type ManagerOptions, McpConfigManager, McpServerRefSchema, MkdirStep, MockLauncher, ModelProviderSchema, type NamedComponent, NpmInstallStep, type PermissionAuditEvent, PermissionAuditLogger, PermissionPolicyEnforcer, PermissionPresetSchema, PermissionsInputSchema, PermissionsObjectSchema, type PipelineOptions, type PipelineResult, PluginManager, type PolicyAction, type PolicyDecision, type ProcessExitAction, type ProcessExitHandler, type ProcessExitInfo, ProcessLauncher, type ProcessLauncherOptions, ProcessLogWriter, type ProcessLogWriterOptions, ProcessWatcher, type ProcessWatcherOptions, type PromptAgentFn, PromptManager, type PromptResult, type RecoveryAction, type RegistryOptions, type ResolvedBackend, type RestartDecision, type RestartPolicy, RestartTracker, type RunPromptOptions, type ScheduleConfig, type ScheduleConfigInput, ScheduleConfigSchema, type SessionLease, SessionRegistry, type SessionRegistryOptions, type SessionState, SkillManager, SourceManager, type SourceManagerDeps, type SourceManagerOptions, type StepContext, StepRegistry, type StepResult, type StepValidationResult, type StreamChunk, type TaskCallback, TaskDispatcher, type TaskPriority, TaskQueue, type TaskStatus, TemplateFileWatcher, type TemplateFileWatcherOptions, TemplateLoader, TemplateRegistry, type ToolCallInfo, type VerifyResult, WorkflowManager, type WorkspaceBuildResult, WorkspaceBuilder, createCommunicator, createDefaultStepRegistry, createLauncher, getBackendDescriptor, getLaunchModeHandler, globMatch, isAcpBackend, isAcpOnlyBackend, isProcessAlive, metaFilePath, openBackend, readInstanceMeta, registerBackend, registerCommunicator, requireMode, resolveAcpBackend, resolveBackend, resolvePermissions, resolvePermissionsWithMcp, scanInstances, supportsMode, toAgentTemplate, updateInstanceMeta, validateBackendConfig, validateDomainContextConfig, validatePermissionsConfig, validateProviderConfig, validateScheduleConfig, validateTemplate, writeInstanceMeta };
+interface SourceValidationIssue {
+    severity: "error" | "warning" | "info";
+    path: string;
+    component?: string;
+    message: string;
+    code?: string;
+}
+interface SourceValidationReport {
+    valid: boolean;
+    sourceName: string;
+    rootDir: string;
+    summary: {
+        pass: number;
+        warn: number;
+        error: number;
+    };
+    issues: SourceValidationIssue[];
+}
+type CompatMode = "agent-skills";
+interface ValidateOptions {
+    strict?: boolean;
+    /** Enable compatibility checks against an external standard. */
+    compat?: CompatMode;
+}
+declare class SourceValidator {
+    /**
+     * Validate all assets in a source directory.
+     * Returns a report with pass/warn/error counts and detailed issues.
+     */
+    validate(rootDir: string, options?: ValidateOptions): Promise<SourceValidationReport>;
+    private validateManifest;
+    private verifyManifestFileRefs;
+    private validateExplicitFiles;
+    private validateComponentDirs;
+    private scanDirectory;
+    private validateSingleFile;
+    private validateTemplateComponent;
+    private validateSkillMd;
+    private validateAgentSkillsCompat;
+    private validateSkillDirConventions;
+    private validatePresetReferences;
+    private trackComponentName;
+}
+
+/**
+ * Registry for model provider descriptors.
+ *
+ * Sources (registered at startup in this order):
+ *   1. Built-in providers (anthropic, openai, deepseek, ...)
+ *   2. Default provider from config.json `provider` field
+ *   3. User-registered providers from config.json `providers` field
+ *
+ * Consumers:
+ *   - Zod schema validation (warning for unknown types)
+ *   - CLI setup wizard (dynamic provider list)
+ *   - AgentInitializer (resolve default when template omits provider)
+ *   - AgentManager (resolve provider → env vars for ACP)
+ */
+declare class ModelProviderRegistry {
+    private readonly descriptors;
+    private defaultType;
+    register(descriptor: ModelProviderDescriptor): void;
+    get(type: string): ModelProviderDescriptor | undefined;
+    getOrThrow(type: string): ModelProviderDescriptor;
+    has(type: string): boolean;
+    list(): ModelProviderDescriptor[];
+    setDefault(type: string): void;
+    getDefault(): ModelProviderDescriptor | undefined;
+    getDefaultType(): string | undefined;
+    /** @internal Test-only: clear all registrations. */
+    _reset(): void;
+}
+/** Singleton instance used throughout the application. */
+declare const modelProviderRegistry: ModelProviderRegistry;
+
+declare const BUILTIN_PROVIDERS: readonly ModelProviderDescriptor[];
+/** Register all built-in providers into the singleton registry. */
+declare function registerBuiltinProviders(): void;
+
+export { AgentBackendSchema, type AgentCommunicator, AgentInitializer, AgentInstanceMetaSchema, type AgentLauncher, AgentManager, type AgentProcess, AgentStatusSchema, type AgentTask, type AgentTemplateInput, type AgentTemplateOutput, AgentTemplateSchema, type AuditEntry, BUILTIN_PROVIDERS, type BackendBuilder, BaseComponentManager, ClaudeCodeBuilder, ClaudeCodeCommunicator, type CommunicatorFactory, type CompatMode, ComponentOriginSchema, type ComponentSource, type ComponentTypeHandler, ContextMaterializer, type CreateSessionOptions, type CronConfig, CronConfigSchema, CronInput, CursorBuilder, CursorCommunicator, CustomBuilder, type CustomBuilderConfig, DEFAULT_RESTART_POLICY, DEFAULT_SOURCE_CONFIG, DEFAULT_SOURCE_NAME, DomainContextSchema, type DomainManagers$1 as DomainManagers, EmployeeScheduler, ExecStep, ExecutionLog, type ExecutionRecord, type FetchResult, FileCopyStep, GitCloneStep, GitHubSource, type HeartbeatConfig, HeartbeatConfigSchema, HeartbeatInput, type HookConfig, HookConfigSchema, HookInput, InitializationPipeline, type InitializerOptions, InitializerSchema, InitializerStepExecutor, InitializerStepSchema, InputRouter, type InputSource, type InstanceOverrides, InstanceRegistry, type InstanceRegistryAdapter, type InstanceRegistryData, type InstanceRegistryEntry, type LaunchModeHandler, LaunchModeSchema, type LauncherConfig, type LauncherMode, LocalSource, type ManagerOptions, McpConfigManager, McpServerRefSchema, MkdirStep, MockLauncher, ModelProviderRegistry, ModelProviderSchema, type NamedComponent, NpmInstallStep, type PermissionAuditEvent, PermissionAuditLogger, PermissionPolicyEnforcer, PermissionPresetSchema, PermissionsInputSchema, PermissionsObjectSchema, type PipelineOptions, type PipelineResult, PluginManager, type PolicyAction, type PolicyDecision, type ProcessExitAction, type ProcessExitHandler, type ProcessExitInfo, ProcessLauncher, type ProcessLauncherOptions, ProcessLogWriter, type ProcessLogWriterOptions, ProcessWatcher, type ProcessWatcherOptions, type PromptAgentFn, PromptManager, type PromptResult, type RecoveryAction, type RegistryOptions, type ResolvedBackend, type RestartDecision, type RestartPolicy, RestartTracker, type RunPromptOptions, type ScheduleConfig, type ScheduleConfigInput, ScheduleConfigSchema, type SessionLease, SessionRegistry, type SessionRegistryOptions, type SessionState, SkillManager, SourceManager, type SourceManagerDeps, type SourceManagerOptions, type SourceValidationIssue, type SourceValidationReport, SourceValidator, type StepContext, StepRegistry, type StepResult, type StepValidationResult, type StreamChunk, type TaskCallback, TaskDispatcher, type TaskPriority, TaskQueue, type TaskStatus, TemplateFileWatcher, type TemplateFileWatcherOptions, TemplateLoader, TemplateRegistry, type ToolCallInfo, type ValidateOptions, type VerifyResult, WorkflowManager, type WorkspaceBuildResult, WorkspaceBuilder, createCommunicator, createDefaultStepRegistry, createLauncher, getBackendDescriptor, getLaunchModeHandler, globMatch, isAcpBackend, isAcpOnlyBackend, isProcessAlive, metaFilePath, modelProviderRegistry, openBackend, readInstanceMeta, registerBackend, registerBuiltinProviders, registerCommunicator, requireMode, resolveAcpBackend, resolveBackend, resolvePermissions, resolvePermissionsWithMcp, scanInstances, supportsMode, toAgentTemplate, updateInstanceMeta, validateBackendConfig, validateDomainContextConfig, validatePermissionsConfig, validateProviderConfig, validateScheduleConfig, validateTemplate, writeInstanceMeta };