@actant/core 0.2.0 → 0.2.2

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":";AAAA,SAAS,gBAAgB;AAkBzB,eAAsB,aAAa,UAAmD;AACpF,MAAI;AACF,UAAM,MAAM,MAAM,SAAS,UAAU,OAAO;AAC5C,WAAO,oBAAoB,GAAG;AAAA,EAChC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAMA,SAAS,qBAAqB,aAA6C;AACzE,QAAM,OAA+B,CAAC;AACtC,QAAM,QAAQ,YAAY,MAAM,IAAI;AACpC,MAAI,IAAI;AACR,MAAI,aAAa;AAEjB,SAAO,IAAI,MAAM,QAAQ;AACvB,UAAM,OAAO,MAAM,CAAC;AACpB,QAAI,SAAS,OAAW;AACxB,UAAM,UAAU,KAAK,KAAK;AAE1B,QAAI,YAAY,aAAa;AAC3B,mBAAa;AACb;AACA;AAAA,IACF;AAEA,UAAM,WAAW,eAAe,KAAK,WAAW,IAAI,KAAK,KAAK,WAAW,GAAI;AAC7E,UAAM,YAAY,WAAW,cAAc;AAE3C,UAAM,aAAa,QAAQ,MAAM,8BAA8B;AAC/D,QAAI,YAAY;AACd,YAAM,MAAM,aAAa,WAAW,CAAC,KAAK;AAC1C,UAAI,CAAC,SAAU,cAAa;AAE5B,YAAM,gBAAgB,KAAK,OAAO,IAAI;AACtC,YAAM,cAAc,iBAAiB,IAAI,gBAAgB,KAAK;AAC9D,YAAM,aAAuB,CAAC;AAC9B;AAEA,aAAO,IAAI,MAAM,QAAQ;AACvB,cAAM,WAAW,MAAM,CAAC;AACxB,YAAI,aAAa,OAAW;AAC5B,cAAM,aAAa,SAAS,OAAO,IAAI;AACvC,cAAM,UAAU,SAAS,KAAK,MAAM;AAEpC,YAAI,SAAS;AACX,qBAAW,KAAK,QAAQ;AACxB;AACA;AAAA,QACF;AACA,YAAI,eAAe,MAAM,cAAc,aAAa;AAClD;AAAA,QACF;AACA,mBAAW,KAAK,QAAQ;AACxB;AAAA,MACF;AAEA,YAAM,WAAW,WAAW,OAAO,CAAC,MAAM,EAAE,KAAK,MAAM,EAAE;AACzD,YAAM,YACJ,SAAS,SAAS,IAAI,KAAK,IAAI,GAAG,SAAS,IAAI,CAAC,MAAM,EAAE,OAAO,IAAI,CAAC,CAAC,IAAI;AAC3E,WAAK,GAAG,IACN,WAAW,CAAC,MAAM,MACd,WACG,IAAI,CAAC,MAAO,EAAE,KAAK,MAAM,KAAK,KAAK,EAAE,MAAM,SAAS,CAAE,EACtD,KAAK,IAAI,EACT,QAAQ,IACX,WAAW,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,EAAE,KAAK;AACrD;AAAA,IACF;AAEA,UAAM,cAAc,QAAQ,MAAM,2CAA2C;AAC7E,QAAI,aAAa;AACf,YAAM,MAAM,aAAa,YAAY,CAAC,KAAK;AAC3C,UAAI,CAAC,SAAU,cAAa;AAC5B,UAAI;AACF,aAAK,GAAG,IAAI,KAAK,MAAM,KAAK,YAAY,CAAC,KAAK,IAAI,QAAQ,OAAO,MAAM,CAAC,GAAG;AAAA,MAC7E,QAAQ;AACN,aAAK,GAAG,KAAK,YAAY,CAAC,KAAK,IAAI,QAAQ,QAAQ,GAAG;AAAA,MACxD;AACA;AACA;AAAA,IACF;AAEA,UAAM,QAAQ,QAAQ,MAAM,yBAAyB;AACrD,QAAI,QAAQ,CAAC,MAAM,QAAW;AAC5B,YAAM,MAAM,YAAY,MAAM,CAAC;AAC/B,UAAI,CAAC,SAAU,cAAa;AAC5B,UAAI,SAAS,MAAM,CAAC,KAAK,IAAI,KAAK;AAClC,UAAI,MAAM,WAAW,GAAG,KAAK,MAAM,SAAS,GAAG,GAAG;AAChD,YAAI;AACF,kBAAQ,KAAK,MAAM,KAAK;AAAA,QAC1B,QAAQ;AACN,kBAAQ,MAAM,MAAM,GAAG,EAAE,EAAE,QAAQ,QAAQ,GAAG;AAAA,QAChD;AAAA,MACF;AACA,WAAK,GAAG,IAAI;AACZ;AACA;AAAA,IACF;AAEA,QAAI,CAAC,SAAU,cAAa;AAC5B;AAAA,EACF;AAEA,SAAO;AACT;AAEO,SAAS,oBAAoB,KAAqC;AAEvE,MAAI,CAAC,IAAI,WAAW,KAAK,EAAG,QAAO;AAEnC,QAAM,SAAS,IAAI,QAAQ,OAAO,CAAC;AACnC,MAAI,WAAW,GAAI,QAAO;AAE1B,QAAM,cAAc,IAAI,UAAU,GAAG,MAAM,EAAE,KAAK;AAClD,QAAM,UAAU,IAAI,UAAU,SAAS,CAAC,EAAE,KAAK;AAG/C,QAAM,OAAO,qBAAqB,WAAW;AAE7C,QAAM,OAAO,KAAK;AAClB,MAAI,CAAC,KAAM,QAAO;AAElB,QAAM,OAAiB,CAAC;AACxB,QAAM,aAAa,KAAK,sBAAsB;AAC9C,MAAI,YAAY;AACd,SAAK,KAAK,GAAG,WAAW,MAAM,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,OAAO,CAAC;AAAA,EACzE;AAEA,SAAO;AAAA,IACL;AAAA,IACA,aAAa,KAAK,eAAe;AAAA,IACjC,SAAS,KAAK,kBAAkB,KAAK,KAAK,WAAW;AAAA,IACrD;AAAA,IACA,MAAM,KAAK,SAAS,IAAI,OAAO;AAAA,EACjC;AACF;","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, OpenSpawnOptions, AgentStatus, ResolveResult, DetachResult, BackendDefinition, AgentOpenMode, PlatformCommand, BackendInstallMethod, BackendDescriptor, 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>>>;
@@ -1142,14 +1158,18 @@ declare const AgentInstanceMetaSchema: z.ZodObject<{
     name: z.ZodString;
     templateName: z.ZodString;
     templateVersion: z.ZodString;
-    backendType: z.ZodDefault<z.ZodEnum<{
-        cursor: "cursor";
-        "cursor-agent": "cursor-agent";
-        "claude-code": "claude-code";
-        custom: "custom";
-        pi: "pi";
-    }>>;
+    backendType: z.ZodDefault<z.ZodString>;
     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";
@@ -1279,6 +1299,46 @@ interface AgentLauncher {
     terminate(process: AgentProcess): Promise<void>;
 }
 
+interface ResolvedBackend {
+    command: string;
+    args: string[];
+    /** npm package providing the binary (for auto-resolution when not on PATH). */
+    resolvePackage?: string;
+    /** Working directory for the spawned process. */
+    cwd?: string;
+    /** Declarative spawn options for `open` mode (from BackendDescriptor). */
+    openSpawnOptions?: OpenSpawnOptions;
+}
+/**
+ * Whether a backend type supports the ACP protocol for Actant-managed control.
+ * Replaces the old hardcoded `isAcpBackend()`.
+ */
+declare function isAcpBackend(backendType: AgentBackendType): boolean;
+/**
+ * Whether a backend's ACP connection owns the process lifecycle.
+ * When true, ProcessLauncher.launch() is skipped — only AcpConnectionManager spawns the process.
+ */
+declare function isAcpOnlyBackend(backendType: AgentBackendType): boolean;
+/**
+ * Resolve the executable command and arguments for spawning a backend (resolve mode).
+ * @throws if the backend does not support "resolve" mode.
+ */
+declare function resolveBackend(backendType: AgentBackendType, workspaceDir: string, backendConfig?: Record<string, unknown>): ResolvedBackend;
+/**
+ * Resolve the open command for directly launching a backend's native TUI/UI.
+ * `openWorkspaceDir` is consumed here to build `args`/`cwd`; the returned
+ * `openSpawnOptions` maps 1:1 to `child_process.SpawnOptions` so the CLI
+ * can spread it as-is with zero branching.
+ */
+declare function openBackend(backendType: AgentBackendType, workspaceDir: string): ResolvedBackend;
+/**
+ * Resolve the ACP spawn command for a backend.
+ * For ACP backends, this returns the command used by AcpConnectionManager to spawn the agent process.
+ * Checks acpCommand first, then falls back to resolveCommand.
+ * @throws if the backend does not support "acp" mode.
+ */
+declare function resolveAcpBackend(backendType: AgentBackendType, workspaceDir: string, backendConfig?: Record<string, unknown>): ResolvedBackend;
+
 interface RestartPolicy {
     /** Maximum number of restarts before giving up. Default: 5 */
     maxRestarts: number;
@@ -1366,6 +1426,7 @@ interface AcpConnectionManagerLike {
         command: string;
         args: string[];
         cwd: string;
+        resolvePackage?: string;
         connectionOptions?: {
             autoApprove?: boolean;
             env?: Record<string, string>;
@@ -1459,10 +1520,7 @@ declare class AgentManager {
      * Requires the backend to support "open" mode.
      * @throws if backend does not support "open" mode
      */
-    openAgent(name: string): Promise<{
-        command: string;
-        args: string[];
-    }>;
+    openAgent(name: string): Promise<ResolvedBackend>;
     /**
      * Register an externally-spawned process with the manager.
      * Sets processOwnership to "external" and registers ProcessWatcher monitoring.
@@ -1632,55 +1690,62 @@ interface LauncherConfig {
  */
 declare function createLauncher(config?: Partial<LauncherConfig>): AgentLauncher;
 
-interface ResolvedBackend {
+type AcpResolverFn = (workspaceDir: string, backendConfig?: Record<string, unknown>) => {
     command: string;
     args: string[];
-}
-/**
- * Whether a backend type supports the ACP protocol for Actant-managed control.
- * Replaces the old hardcoded `isAcpBackend()`.
- */
-declare function isAcpBackend(backendType: AgentBackendType): boolean;
-/**
- * Whether a backend's ACP connection owns the process lifecycle.
- * When true, ProcessLauncher.launch() is skipped — only AcpConnectionManager spawns the process.
- */
-declare function isAcpOnlyBackend(backendType: AgentBackendType): boolean;
-/**
- * Resolve the executable command and arguments for spawning a backend (resolve mode).
- * @throws if the backend does not support "resolve" mode.
- */
-declare function resolveBackend(backendType: AgentBackendType, workspaceDir: string, backendConfig?: Record<string, unknown>): ResolvedBackend;
-/**
- * Resolve the open command for directly launching a backend's native TUI/UI.
- * @throws if the backend does not support "open" mode.
- */
-declare function openBackend(backendType: AgentBackendType, workspaceDir: string): ResolvedBackend;
+};
 /**
- * Resolve the ACP spawn command for a backend.
- * For ACP backends, this returns the command used by AcpConnectionManager to spawn the agent process.
- * Checks acpCommand first, then falls back to resolveCommand.
- * @throws if the backend does not support "acp" mode.
+ * Manages backend definitions as VersionedComponents.
+ *
+ * Pure-data definitions are stored in the component registry (JSON-serializable,
+ * loadable from `~/.actant/configs/backends/`). Non-serializable behavioral
+ * extensions (acpResolver) are stored in a separate Map keyed by backend name.
  */
-declare function resolveAcpBackend(backendType: AgentBackendType, workspaceDir: string, backendConfig?: Record<string, unknown>): ResolvedBackend;
+declare class BackendManager extends BaseComponentManager<BackendDefinition> {
+    protected readonly componentType = "Backend";
+    private readonly acpResolvers;
+    constructor();
+    registerAcpResolver(backendName: string, resolver: AcpResolverFn): void;
+    getAcpResolver(backendName: string): AcpResolverFn | undefined;
+    supportsMode(backendName: string, mode: AgentOpenMode): boolean;
+    requireMode(backendName: string, mode: AgentOpenMode): void;
+    getPlatformCommand(cmd: PlatformCommand): string;
+    /**
+     * Probe whether a backend binary is available on the system.
+     * Uses the `existenceCheck` field. Returns `{ available, version? }`.
+     * If no `existenceCheck` is configured, returns `{ available: true }` (assume ok).
+     */
+    checkAvailability(backendName: string): Promise<BackendAvailability>;
+    /**
+     * Get platform-appropriate install methods for a backend.
+     * Filters by `platforms` field; returns all methods if no platform restriction.
+     */
+    getInstallMethods(backendName: string): BackendInstallMethod[];
+    validate(data: unknown, _source: string): ConfigValidationResult<BackendDefinition>;
+}
+interface BackendAvailability {
+    available: boolean;
+    version?: string;
+    error?: string;
+}
 
+/** Access the singleton BackendManager for advanced operations (CRUD, persistence, directory loading). */
+declare function getBackendManager(): BackendManager;
 /**
- * Register a backend descriptor.
- * Call at startup for built-in backends and from external packages (e.g. @actant/pi).
+ * Register a backend descriptor (legacy API).
+ * Converts `BackendDescriptor.type` → `BackendDefinition.name` and
+ * extracts `acpResolver` into the behavioral registry.
  */
 declare function registerBackend(descriptor: BackendDescriptor): void;
 /**
- * Retrieve the descriptor for a backend type.
- * @throws if the type has not been registered.
+ * Register a BackendDefinition directly (new API).
+ * For behavioral extensions, use `getBackendManager().registerAcpResolver()`.
  */
-declare function getBackendDescriptor(type: AgentBackendType): BackendDescriptor;
-/** Check whether a backend supports a specific open mode. */
+declare function registerBackendDefinition(definition: BackendDefinition): void;
+declare function getBackendDescriptor(type: AgentBackendType): BackendDefinition;
 declare function supportsMode(type: AgentBackendType, mode: AgentOpenMode): boolean;
-/**
- * Assert that a backend supports a mode, throwing a descriptive error if not.
- * Used as a guard in manager methods before executing mode-specific logic.
- */
 declare function requireMode(type: AgentBackendType, mode: AgentOpenMode): void;
+declare function getInstallHint(type: AgentBackendType): string | undefined;
 
 /**
  * Check whether a process with the given PID is still alive.
@@ -1926,6 +1991,7 @@ interface FetchResult {
     prompts: PromptDefinition[];
     mcpServers: McpServerDefinition[];
     workflows: WorkflowDefinition[];
+    backends: BackendDefinition[];
     presets: PresetDefinition[];
     templates: AgentTemplate[];
 }
@@ -1937,6 +2003,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 +2020,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 +2034,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>;
@@ -1997,6 +2067,7 @@ interface SourceManagerDeps {
     promptManager: BaseComponentManager<PromptDefinition>;
     mcpConfigManager: BaseComponentManager<McpServerDefinition>;
     workflowManager: BaseComponentManager<WorkflowDefinition>;
+    backendManager?: BaseComponentManager<BackendDefinition>;
     templateRegistry?: TemplateRegistry;
 }
 /**
@@ -2029,6 +2100,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 +2126,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 { type AcpResolverFn, AgentBackendSchema, type AgentCommunicator, AgentInitializer, AgentInstanceMetaSchema, type AgentLauncher, AgentManager, type AgentProcess, AgentStatusSchema, type AgentTask, type AgentTemplateInput, type AgentTemplateOutput, AgentTemplateSchema, type AuditEntry, BUILTIN_PROVIDERS, type BackendAvailability, type BackendBuilder, BackendManager, 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, getBackendManager, getInstallHint, getLaunchModeHandler, globMatch, isAcpBackend, isAcpOnlyBackend, isProcessAlive, metaFilePath, modelProviderRegistry, openBackend, readInstanceMeta, registerBackend, registerBackendDefinition, registerBuiltinProviders, registerCommunicator, requireMode, resolveAcpBackend, resolveBackend, resolvePermissions, resolvePermissionsWithMcp, scanInstances, supportsMode, toAgentTemplate, updateInstanceMeta, validateBackendConfig, validateDomainContextConfig, validatePermissionsConfig, validateProviderConfig, validateScheduleConfig, validateTemplate, writeInstanceMeta };