@skaile/workspaces 0.8.5

package/dist/chunk-7HLNUSNE.js

@@ -0,0 +1,212 @@
+import { normalizeAnthropicModel } from './chunk-Z3RER6YZ.js';
+import { mkdirSync, writeFileSync } from 'fs';
+import { join, dirname, relative } from 'path';
+import { stringify } from 'yaml';
+
+function writeAgent(filePath, content, workspaceRoot, created) {
+  mkdirSync(dirname(filePath), { recursive: true });
+  writeFileSync(filePath, content, "utf-8");
+  created.push(relative(workspaceRoot, filePath));
+}
+function buildMarkdownBody(soul, rules, duties, abilityRefs, contractRefs, frameworkFragments, promptExtensions) {
+  const parts = [];
+  if (soul) parts.push(soul.trim());
+  for (const fragment of frameworkFragments) parts.push(fragment);
+  if (rules) parts.push(`## Constraints
+
+${rules.trim()}`);
+  if (duties) parts.push(`## Duties
+
+${duties.trim()}`);
+  if (abilityRefs.length > 0) {
+    const lines = ["## Installed Abilities", ""];
+    for (const a of abilityRefs) lines.push(`- \`/${a.name}\` \u2014 ${a.description}`);
+    parts.push(lines.join("\n"));
+  }
+  if (contractRefs.length > 0) {
+    const lines = [
+      "## Contracts",
+      "",
+      "Read the relevant contract before acting on constrained tasks:",
+      ""
+    ];
+    for (const c of contractRefs) lines.push(`- \`${c.relativePath}\``);
+    parts.push(lines.join("\n"));
+  }
+  for (const ext of promptExtensions) parts.push(ext);
+  return `${parts.join("\n\n")}
+`;
+}
+function toTomlMultilineString(s) {
+  return s.replace(/"""/g, '\\"\\"\\"');
+}
+var claudeCodeRenderer = ({
+  manifest,
+  soul,
+  rules,
+  duties,
+  agentName,
+  agentDeployDir,
+  workspaceRoot,
+  abilityRefs,
+  contractRefs,
+  frameworkFragments,
+  promptExtensions
+}) => {
+  const created = [];
+  const warnings = [];
+  const frontmatter = {
+    name: agentName,
+    description: manifest.description ?? `${agentName} agent`
+  };
+  if (manifest.model?.preferred) {
+    const raw = manifest.model.preferred;
+    const normalized = normalizeAnthropicModel(raw);
+    if (normalized !== raw) {
+      warnings.push(
+        `agent ${agentName}: model "${raw}" is not a valid Claude model ID; normalized to alias "${normalized}". Update agent.yaml.`
+      );
+    }
+    frontmatter.model = normalized;
+  }
+  if (manifest.tools?.allowed?.length) {
+    frontmatter.tools = manifest.tools.allowed.join(", ");
+  }
+  if (manifest.tools?.denied?.length) {
+    frontmatter.disallowedTools = manifest.tools.denied.join(", ");
+  }
+  if (manifest.runtime?.max_turns) {
+    frontmatter.maxTurns = manifest.runtime.max_turns;
+  }
+  if (manifest.metadata?.color) frontmatter.color = manifest.metadata.color;
+  if (manifest.metadata?.effort) frontmatter.effort = manifest.metadata.effort;
+  if (manifest.metadata?.isolation) frontmatter.isolation = manifest.metadata.isolation;
+  const body = buildMarkdownBody(
+    soul,
+    rules,
+    duties,
+    abilityRefs,
+    contractRefs,
+    frameworkFragments,
+    promptExtensions
+  );
+  const content = `---
+${stringify(frontmatter).trim()}
+---
+
+${body}`;
+  const filePath = join(agentDeployDir, `${agentName}.md`);
+  writeAgent(filePath, content, workspaceRoot, created);
+  return { created, warnings };
+};
+var codexRenderer = ({
+  manifest,
+  soul,
+  rules,
+  duties,
+  agentName,
+  agentDeployDir,
+  workspaceRoot,
+  abilityRefs,
+  contractRefs,
+  frameworkFragments,
+  promptExtensions
+}) => {
+  const created = [];
+  const warnings = [];
+  const instructions = buildMarkdownBody(
+    soul,
+    rules,
+    duties,
+    abilityRefs,
+    contractRefs,
+    frameworkFragments,
+    promptExtensions
+  );
+  const escaped = toTomlMultilineString(instructions);
+  const lines = [
+    `name = ${JSON.stringify(agentName)}`,
+    `description = ${JSON.stringify(manifest.description ?? `${agentName} agent`)}`,
+    `developer_instructions = """`,
+    escaped.trim(),
+    `"""`
+  ];
+  if (manifest.model?.preferred) {
+    lines.splice(2, 0, `model = ${JSON.stringify(manifest.model.preferred)}`);
+  }
+  const content = `${lines.join("\n")}
+`;
+  const filePath = join(agentDeployDir, `${agentName}.toml`);
+  writeAgent(filePath, content, workspaceRoot, created);
+  const agentMdPath = join(dirname(agentDeployDir), "skaile-agent.md");
+  writeAgent(agentMdPath, instructions, workspaceRoot, created);
+  return { created, warnings };
+};
+var ompRenderer = ({
+  manifest,
+  soul,
+  rules,
+  duties,
+  agentName,
+  agentDeployDir,
+  workspaceRoot,
+  abilityRefs,
+  contractRefs,
+  frameworkFragments,
+  promptExtensions
+}) => {
+  const created = [];
+  const warnings = [];
+  const destDir = join(agentDeployDir, agentName);
+  mkdirSync(destDir, { recursive: true });
+  const agentYaml = {
+    spec_version: manifest.spec_version ?? "0.1.0",
+    name: manifest.name ?? agentName,
+    version: manifest.version ?? "1.0.0",
+    description: manifest.description ?? `${agentName} agent`
+  };
+  if (manifest.model) agentYaml.model = manifest.model;
+  if (manifest.tools) agentYaml.tools = manifest.tools;
+  if (manifest.delegation) agentYaml.delegation = manifest.delegation;
+  if (manifest.runtime) agentYaml.runtime = manifest.runtime;
+  if (manifest.requires?.length) agentYaml.requires = manifest.requires;
+  if (manifest.tags?.length) agentYaml.tags = manifest.tags;
+  if (manifest.metadata) agentYaml.metadata = manifest.metadata;
+  writeFileSync(join(destDir, "agent.yaml"), stringify(agentYaml), "utf-8");
+  const enrichedSoul = buildMarkdownBody(
+    soul,
+    rules,
+    duties,
+    abilityRefs,
+    contractRefs,
+    frameworkFragments,
+    promptExtensions
+  );
+  writeFileSync(join(destDir, "SOUL.md"), enrichedSoul, "utf-8");
+  created.push(relative(workspaceRoot, destDir));
+  return { created, warnings };
+};
+var noop = () => {
+};
+function renderAgentToFramework(input, driverTarget, log = noop) {
+  const renderer = AGENT_RENDERERS[driverTarget];
+  if (!renderer) {
+    return { created: [], warnings: [`No renderer for framework "${driverTarget}"`] };
+  }
+  const result = renderer(input);
+  for (const c of result.created) log(`  rendered agent: ${c}`);
+  for (const w of result.warnings) log(`  warn: ${w}`);
+  return result;
+}
+var AGENT_RENDERERS = {
+  "claude-code": claudeCodeRenderer,
+  omp: ompRenderer,
+  codex: codexRenderer
+};
+function driverTargetSupportsAgents(driverTarget) {
+  return driverTarget in AGENT_RENDERERS;
+}
+
+export { AGENT_RENDERERS, claudeCodeRenderer, codexRenderer, driverTargetSupportsAgents, ompRenderer, renderAgentToFramework };
+//# sourceMappingURL=chunk-7HLNUSNE.js.map
+//# sourceMappingURL=chunk-7HLNUSNE.js.map

package/dist/chunk-7HLNUSNE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../asset-manager/src/renderers.ts"],"names":["stringifyYaml"],"mappings":"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","file":"chunk-7HLNUSNE.js","sourcesContent":["/**\n * Framework-specific renderers for GitAgent packages.\n *\n * Each renderer transforms a parsed GitAgent package (agent.yaml + SOUL.md + RULES.md)\n * into the native file format that the target agent framework natively reads.\n *\n * Only backends with a full bridge driver (runtime execution) are included:\n *   claude-code → .claude/agents/<name>.md     (YAML frontmatter + markdown body)\n *   omp         → .omp/agents/<name>/          (directory with agent.yaml + SOUL.md)\n *   codex       → .codex/agents/<name>.toml    (TOML)\n *\n * Removed (no bridge driver): cursor, roo, github-copilot, gemini, amp.\n * Add them back when a bridge driver is implemented.\n */\n\nimport { mkdirSync, writeFileSync } from \"node:fs\";\nimport { dirname, join, relative } from \"node:path\";\nimport { stringify as stringifyYaml } from \"yaml\";\nimport type { AgentManifest } from \"@skaile/workspaces/core\";\nimport { normalizeAnthropicModel } from \"@skaile/workspaces/types/manifests\";\nimport type { AbilityRef, ContractRef } from \"./fragments.js\";\n\n// ── Types ─────────────────────────────────��───────────────────────────────────\n\nexport type { AgentManifest };\n\n/**\n * All data an {@link AgentRenderer} needs to produce a native agent definition file.\n *\n * @docLink packages/asset-manager/api-reference#renderers\n */\nexport interface AgentRenderInput {\n  /** Parsed `agent.yaml` manifest for the GitAgent being rendered. */\n  manifest: AgentManifest;\n  /** Raw content of `SOUL.md`, or `null` if absent. */\n  soul: string | null;\n  /** Raw content of `RULES.md`, or `null` if absent. */\n  rules: string | null;\n  /** Raw content of `DUTIES.md`, or `null` if absent. */\n  duties: string | null;\n  /** Agent name used as the output filename and frontmatter `name` field. */\n  agentName: string;\n  /** Resolved absolute path to the framework's agent deploy directory (e.g. `.claude/agents/`). */\n  agentDeployDir: string;\n  /** Absolute path to the workspace root. */\n  workspaceRoot: string;\n  /** Resolved ability refs — installed skills referenced in the `## Installed Abilities` section. */\n  abilityRefs: AbilityRef[];\n  /** Resolved contract refs — installed in the skills dir, listed in the `## Contracts` section. */\n  contractRefs: ContractRef[];\n  /** Resolved framework fragment markdown blocks (agent-mode, handoff, skill-discovery, etc.). */\n  frameworkFragments: string[];\n  /** Per-project prompt extension markdown blocks loaded from `skaile.yaml` `agent.prompt-extensions`. */\n  promptExtensions: string[];\n}\n\n/**\n * Result returned by every {@link AgentRenderer}.\n *\n * @docLink packages/asset-manager/api-reference#renderers\n */\nexport interface AgentRenderResult {\n  /** Paths to files/dirs created, relative to `workspaceRoot`. */\n  created: string[];\n  /** Non-fatal warnings (e.g. experimental feature notices). */\n  warnings: string[];\n}\n\n/**\n * A function that transforms an {@link AgentRenderInput} into framework-native agent definition files.\n *\n * @docLink packages/asset-manager/api-reference#renderers\n */\nexport type AgentRenderer = (input: AgentRenderInput) => AgentRenderResult;\n\n// ── Helpers ───────────────────────────────────────────────────────────────────\n\n/**\n * Write an agent definition file, always overwriting if it already exists.\n * Agents are compiled artifacts — they must reflect the current canonical source.\n */\nfunction writeAgent(\n  filePath: string,\n  content: string,\n  workspaceRoot: string,\n  created: string[],\n): void {\n  mkdirSync(dirname(filePath), { recursive: true });\n  writeFileSync(filePath, content, \"utf-8\");\n  created.push(relative(workspaceRoot, filePath));\n}\n\n/**\n * Build the full agent system prompt body baked into the framework-native agent file.\n *\n * This is the sole source of the agent's system prompt body. Agent identity is rendered at install time; the backend reads it natively at runtime.\n * The rendered output ends up in .claude/agents/<name>.md, .omp/agents/<name>/SOUL.md,\n * .codex/agents/<name>.toml and is read natively by the framework on every agent invocation.\n *\n * Composition order:\n *   1. SOUL.md            — agent identity and values (inlined verbatim)\n *   2. Framework fragments — agent-mode, handoff, skill-discovery, connector-usage\n *                           (conditional; see fragments.ts BUILT_IN_FRAGMENTS)\n *   3. ## Constraints     — RULES.md behavioral constraints (inlined)\n *   4. ## Duties          — DUTIES.md responsibilities (inlined)\n *   5. ## Installed Abilities — skill name + description, listed as slash commands\n *   6. ## Contracts       — relative paths to CONTRACT.md in the skills dir\n *   7. Prompt extensions  — per-project markdown from skaile.yaml agent.prompt-extensions\n */\nfunction buildMarkdownBody(\n  soul: string | null,\n  rules: string | null,\n  duties: string | null,\n  abilityRefs: AbilityRef[],\n  contractRefs: ContractRef[],\n  frameworkFragments: string[],\n  promptExtensions: string[],\n): string {\n  const parts: string[] = [];\n\n  if (soul) parts.push(soul.trim());\n  for (const fragment of frameworkFragments) parts.push(fragment);\n  if (rules) parts.push(`## Constraints\\n\\n${rules.trim()}`);\n  if (duties) parts.push(`## Duties\\n\\n${duties.trim()}`);\n\n  if (abilityRefs.length > 0) {\n    const lines = [\"## Installed Abilities\", \"\"];\n    for (const a of abilityRefs) lines.push(`- \\`/${a.name}\\` — ${a.description}`);\n    parts.push(lines.join(\"\\n\"));\n  }\n\n  if (contractRefs.length > 0) {\n    const lines = [\n      \"## Contracts\",\n      \"\",\n      \"Read the relevant contract before acting on constrained tasks:\",\n      \"\",\n    ];\n    for (const c of contractRefs) lines.push(`- \\`${c.relativePath}\\``);\n    parts.push(lines.join(\"\\n\"));\n  }\n\n  for (const ext of promptExtensions) parts.push(ext);\n\n  return `${parts.join(\"\\n\\n\")}\\n`;\n}\n\n/** Escape a string for use as a TOML multi-line basic string (triple-quote). */\nfunction toTomlMultilineString(s: string): string {\n  // Replace \"\"\" with \\\\\"\"\" to avoid breaking the TOML literal\n  return s.replace(/\"\"\"/g, '\\\\\"\\\\\"\\\\\"');\n}\n\n// ── Claude Code ────────────��──────────────────────────────────────────────────\n// Format: .claude/agents/<name>.md\n// Sub-agent support: automatic (description-based) + @-mention\n// Required frontmatter: name, description\n//\n// Installation → runtime handoff:\n//   skaile install (claudeCodeRenderer) creates the .md file from GitAgent source\n//   ClaudeSdkDriver.startQuery() passes options.agent = agentName to the SDK query\n//   The SDK reads .claude/agents/<agentName>.md to get model, tools, and system prompt\n//   This is equivalent to running: claude --agent <agentName>\n\n/**\n * Render a GitAgent to Claude Code's `.claude/agents/<name>.md` format.\n *\n * Writes YAML frontmatter (name, description, model, tools, maxTurns) followed\n * by the enriched system prompt body. Always overwrites to reflect current source.\n *\n * @docLink packages/asset-manager/api-reference#renderers\n */\nexport const claudeCodeRenderer: AgentRenderer = ({\n  manifest,\n  soul,\n  rules,\n  duties,\n  agentName,\n  agentDeployDir,\n  workspaceRoot,\n  abilityRefs,\n  contractRefs,\n  frameworkFragments,\n  promptExtensions,\n}) => {\n  const created: string[] = [];\n  const warnings: string[] = [];\n\n  const frontmatter: Record<string, unknown> = {\n    name: agentName,\n    description: manifest.description ?? `${agentName} agent`,\n  };\n\n  // Model: map to Claude Code's model field. Accepts aliases (sonnet/opus/haiku/inherit)\n  // or a full Anthropic ID. Unrecognized values (e.g. legacy `claude-opus-4`) are\n  // coerced to the matching family alias so the agent still loads.\n  if (manifest.model?.preferred) {\n    const raw = manifest.model.preferred;\n    const normalized = normalizeAnthropicModel(raw);\n    if (normalized !== raw) {\n      warnings.push(\n        `agent ${agentName}: model \"${raw}\" is not a valid Claude model ID; normalized to alias \"${normalized}\". Update agent.yaml.`,\n      );\n    }\n    frontmatter.model = normalized;\n  }\n\n  // Tool restrictions\n  if (manifest.tools?.allowed?.length) {\n    frontmatter.tools = manifest.tools.allowed.join(\", \");\n  }\n  if (manifest.tools?.denied?.length) {\n    frontmatter.disallowedTools = manifest.tools.denied.join(\", \");\n  }\n\n  // Runtime\n  if (manifest.runtime?.max_turns) {\n    frontmatter.maxTurns = manifest.runtime.max_turns;\n  }\n\n  // Metadata pass-through for Claude Code-specific fields\n  if (manifest.metadata?.color) frontmatter.color = manifest.metadata.color;\n  if (manifest.metadata?.effort) frontmatter.effort = manifest.metadata.effort;\n  if (manifest.metadata?.isolation) frontmatter.isolation = manifest.metadata.isolation;\n\n  const body = buildMarkdownBody(\n    soul,\n    rules,\n    duties,\n    abilityRefs,\n    contractRefs,\n    frameworkFragments,\n    promptExtensions,\n  );\n  const content = `---\\n${stringifyYaml(frontmatter).trim()}\\n---\\n\\n${body}`;\n  const filePath = join(agentDeployDir, `${agentName}.md`);\n  writeAgent(filePath, content, workspaceRoot, created);\n\n  return { created, warnings };\n};\n\n// ── OpenAI Codex ──────────────────────────────────────────────────────────────\n// Format: .codex/agents/<name>.toml\n// Sub-agent support: explicit user request only (not automatic)\n// Required fields: name, description, developer_instructions\n\n/**\n * Render a GitAgent to OpenAI Codex's `.codex/agents/<name>.toml` format.\n *\n * Produces a TOML file with `name`, `description`, and `developer_instructions`\n * fields. Triple-quoted TOML multi-line strings are escaped to avoid syntax errors.\n *\n * @docLink packages/asset-manager/api-reference#renderers\n */\nexport const codexRenderer: AgentRenderer = ({\n  manifest,\n  soul,\n  rules,\n  duties,\n  agentName,\n  agentDeployDir,\n  workspaceRoot,\n  abilityRefs,\n  contractRefs,\n  frameworkFragments,\n  promptExtensions,\n}) => {\n  const created: string[] = [];\n  const warnings: string[] = [];\n\n  const instructions = buildMarkdownBody(\n    soul,\n    rules,\n    duties,\n    abilityRefs,\n    contractRefs,\n    frameworkFragments,\n    promptExtensions,\n  );\n  const escaped = toTomlMultilineString(instructions);\n\n  const lines: string[] = [\n    `name = ${JSON.stringify(agentName)}`,\n    `description = ${JSON.stringify(manifest.description ?? `${agentName} agent`)}`,\n    `developer_instructions = \"\"\"`,\n    escaped.trim(),\n    `\"\"\"`,\n  ];\n  if (manifest.model?.preferred) {\n    lines.splice(2, 0, `model = ${JSON.stringify(manifest.model.preferred)}`);\n  }\n\n  const content = `${lines.join(\"\\n\")}\\n`;\n  const filePath = join(agentDeployDir, `${agentName}.toml`);\n  writeAgent(filePath, content, workspaceRoot, created);\n\n  // Write the full agent identity as markdown for the Codex driver to read at runtime.\n  // The driver combines this with the session's dynamic content (resources, context)\n  // and passes the result via model_instructions_file.\n  const agentMdPath = join(dirname(agentDeployDir), \"skaile-agent.md\");\n  writeAgent(agentMdPath, instructions, workspaceRoot, created);\n\n  return { created, warnings };\n};\n\n// ── oh-my-pi ─��────────────��────────────────────────────────��─────────────────\n// Format: .omp/agents/<name>/ (directory with agent.yaml + SOUL.md + RULES.md)\n// oh-my-pi reads GitAgent directories natively via PI_CODING_AGENT_DIR.\n// The renderer copies/enriches the source directory rather than flattening to .md.\n//\n// Installation → runtime handoff:\n//   skaile install (ompRenderer) creates .omp/agents/<name>/ from GitAgent source\n//   OmpDriver._start() sets env.PI_CODING_AGENT_DIR = agentDir in the child process\n//   omp reads SOUL.md/RULES.md/knowledge/ from that directory natively on startup\n//\n// Note: REPL mode can bypass the install step — agentDir can point directly to the\n// GitAgent source directory, and omp will read it natively via PI_CODING_AGENT_DIR.\n// The rendered .omp/agents/ copy is only needed when the source is not accessible\n// from the project cwd (e.g. different repo, remote workspace).\n\n/**\n * Render a GitAgent to oh-my-pi's `.omp/agents/<name>/` directory format.\n *\n * Writes `agent.yaml` (with resolved model/tools/delegation) and an enriched\n * `SOUL.md` that includes fragments and extensions. omp reads this directory\n * natively via the `PI_CODING_AGENT_DIR` environment variable.\n *\n * @docLink packages/asset-manager/api-reference#renderers\n */\nexport const ompRenderer: AgentRenderer = ({\n  manifest,\n  soul,\n  rules,\n  duties,\n  agentName,\n  agentDeployDir,\n  workspaceRoot,\n  abilityRefs,\n  contractRefs,\n  frameworkFragments,\n  promptExtensions,\n}) => {\n  const created: string[] = [];\n  const warnings: string[] = [];\n\n  const destDir = join(agentDeployDir, agentName);\n  mkdirSync(destDir, { recursive: true });\n\n  // Write agent.yaml with tools resolved\n  const agentYaml: Record<string, unknown> = {\n    spec_version: manifest.spec_version ?? \"0.1.0\",\n    name: manifest.name ?? agentName,\n    version: manifest.version ?? \"1.0.0\",\n    description: manifest.description ?? `${agentName} agent`,\n  };\n  // Pass model through verbatim — omp expects provider-prefixed full IDs and does\n  // not understand Claude Code aliases (`opus` / `sonnet` / `haiku`). Invalid IDs\n  // are caught upstream by `validateAgent` (ModelIdSchema in @skaile/workspaces/types).\n  // Do NOT call `normalizeAnthropicModel` here: it would coerce a bad ID into a\n  // Claude alias that omp cannot resolve, masking the failure.\n  if (manifest.model) agentYaml.model = manifest.model;\n  if (manifest.tools) agentYaml.tools = manifest.tools;\n  if (manifest.delegation) agentYaml.delegation = manifest.delegation;\n  if (manifest.runtime) agentYaml.runtime = manifest.runtime;\n  if (manifest.requires?.length) agentYaml.requires = manifest.requires;\n  if (manifest.tags?.length) agentYaml.tags = manifest.tags;\n  if (manifest.metadata) agentYaml.metadata = manifest.metadata;\n\n  writeFileSync(join(destDir, \"agent.yaml\"), stringifyYaml(agentYaml), \"utf-8\");\n\n  // Write SOUL.md (enriched with fragments and extensions, like other renderers)\n  const enrichedSoul = buildMarkdownBody(\n    soul,\n    rules,\n    duties,\n    abilityRefs,\n    contractRefs,\n    frameworkFragments,\n    promptExtensions,\n  );\n  writeFileSync(join(destDir, \"SOUL.md\"), enrichedSoul, \"utf-8\");\n\n  created.push(relative(workspaceRoot, destDir));\n  return { created, warnings };\n};\n\n// ── Renderer registry ──────────────────────────────���──────────────────────────\n\nexport type Log = (msg: string) => void;\nconst noop: Log = () => {};\n\n/**\n * Render an agent to framework-native format via the renderer registry.\n *\n * Shared by both the simple deploy path (`deployAsset`) and the enriched scaffold path (agents layer).\n *\n * @param input - Full render input including manifest, SOUL/RULES text, and resolved refs.\n * @param driverTarget - Agent framework ID to look up in {@link AGENT_RENDERERS}.\n * @param log - Optional logger callback for progress messages.\n * @returns Object with `created` file paths and `warnings` list.\n * @docLink packages/asset-manager/api-reference#renderers\n */\nexport function renderAgentToFramework(\n  input: AgentRenderInput,\n  driverTarget: string,\n  log: Log = noop,\n): { created: string[]; warnings: string[] } {\n  const renderer = AGENT_RENDERERS[driverTarget];\n  if (!renderer) {\n    return { created: [], warnings: [`No renderer for framework \"${driverTarget}\"`] };\n  }\n  const result = renderer(input);\n  for (const c of result.created) log(`  rendered agent: ${c}`);\n  for (const w of result.warnings) log(`  warn: ${w}`);\n  return result;\n}\n\n/**\n * Registry mapping framework IDs to their {@link AgentRenderer} functions.\n *\n * Only backends with a full bridge driver are registered. Add new entries\n * when a bridge driver is implemented in `workspaces/bridge/src/drivers/`.\n *\n * @docLink packages/asset-manager/api-reference#renderers\n */\nexport const AGENT_RENDERERS: Record<string, AgentRenderer> = {\n  \"claude-code\": claudeCodeRenderer,\n  omp: ompRenderer,\n  codex: codexRenderer,\n};\n\n/**\n * Returns `true` if the given driver target supports file-based sub-agent installation.\n *\n * @param driverTarget - Agent framework ID to check.\n * @returns `true` when `driverTarget` has a registered entry in {@link AGENT_RENDERERS}.\n * @docLink packages/asset-manager/api-reference#renderers\n */\nexport function driverTargetSupportsAgents(driverTarget: string): boolean {\n  return driverTarget in AGENT_RENDERERS;\n}\n"]}

package/dist/chunk-7PTP3SQJ.js

@@ -0,0 +1,151 @@
+// transport/src/ws/client.ts
+var DEFAULT_RECONNECT_MAX_ATTEMPTS = 5;
+var DEFAULT_RECONNECT_BASE_MS = 1e3;
+var DEFAULT_RECONNECT_MAX_MS = 3e4;
+var DEFAULT_HEARTBEAT_MS = 3e4;
+var DEFAULT_CONNECT_TIMEOUT_MS = 1e4;
+var WebSocketClientTransport = class {
+  ws = null;
+  url;
+  reconnectConfig;
+  heartbeatMs;
+  connectTimeoutMs;
+  log;
+  heartbeatTimer = null;
+  reconnectAttempts = 0;
+  intentionalClose = false;
+  messageHandlers = /* @__PURE__ */ new Set();
+  disconnectHandlers = /* @__PURE__ */ new Set();
+  constructor(options) {
+    this.url = options.url;
+    this.reconnectConfig = {
+      maxAttempts: options.reconnect?.maxAttempts ?? DEFAULT_RECONNECT_MAX_ATTEMPTS,
+      baseMs: options.reconnect?.baseMs ?? DEFAULT_RECONNECT_BASE_MS,
+      maxMs: options.reconnect?.maxMs ?? DEFAULT_RECONNECT_MAX_MS
+    };
+    this.heartbeatMs = options.heartbeatMs ?? DEFAULT_HEARTBEAT_MS;
+    this.connectTimeoutMs = options.connectTimeoutMs ?? DEFAULT_CONNECT_TIMEOUT_MS;
+    this.log = options.onLog ?? (() => {
+    });
+  }
+  async connect() {
+    this.intentionalClose = false;
+    this.reconnectAttempts = 0;
+    return this.doConnect();
+  }
+  async disconnect() {
+    this.intentionalClose = true;
+    this.clearHeartbeat();
+    if (this.ws) {
+      if (this.ws.readyState === WebSocket.OPEN) {
+        this.ws.close(1e3, "Client disconnect");
+      }
+      this.ws = null;
+    }
+  }
+  send(command) {
+    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+      this.log("[ws-client] cannot send: not connected");
+      return;
+    }
+    this.ws.send(JSON.stringify(command));
+  }
+  onMessage(handler) {
+    this.messageHandlers.add(handler);
+    return () => {
+      this.messageHandlers.delete(handler);
+    };
+  }
+  onDisconnect(handler) {
+    this.disconnectHandlers.add(handler);
+    return () => {
+      this.disconnectHandlers.delete(handler);
+    };
+  }
+  get connected() {
+    return this.ws?.readyState === WebSocket.OPEN;
+  }
+  // ---------------------------------------------------------------------------
+  // Internal
+  // ---------------------------------------------------------------------------
+  doConnect() {
+    return new Promise((resolve, reject) => {
+      this.log(`[ws-client] connecting to ${this.url}`);
+      const ws = new WebSocket(this.url);
+      this.ws = ws;
+      const timeout = setTimeout(() => {
+        ws.close();
+        reject(new Error(`Connection timeout to ${this.url}`));
+      }, this.connectTimeoutMs);
+      ws.addEventListener("open", () => {
+        clearTimeout(timeout);
+        this.log("[ws-client] connected");
+        this.reconnectAttempts = 0;
+        this.startHeartbeat();
+        resolve();
+      });
+      ws.addEventListener("message", (event) => {
+        try {
+          const data = JSON.parse(String(event.data));
+          for (const handler of this.messageHandlers) {
+            handler(data);
+          }
+        } catch {
+          this.log("[ws-client] failed to parse message");
+        }
+      });
+      ws.addEventListener("close", (event) => {
+        clearTimeout(timeout);
+        this.clearHeartbeat();
+        this.log(`[ws-client] disconnected (code=${event.code})`);
+        for (const handler of this.disconnectHandlers) {
+          handler();
+        }
+        if (!this.intentionalClose && event.code !== 1e3) {
+          this.scheduleReconnect();
+        }
+      });
+      ws.addEventListener("error", () => {
+        clearTimeout(timeout);
+      });
+    });
+  }
+  scheduleReconnect() {
+    if (this.reconnectAttempts >= this.reconnectConfig.maxAttempts) {
+      this.log(`[ws-client] giving up reconnect after ${this.reconnectAttempts} attempts`);
+      return;
+    }
+    this.reconnectAttempts++;
+    const delay = Math.min(
+      this.reconnectConfig.baseMs * 2 ** (this.reconnectAttempts - 1),
+      this.reconnectConfig.maxMs
+    );
+    this.log(`[ws-client] reconnecting in ${delay}ms (attempt ${this.reconnectAttempts})`);
+    setTimeout(() => {
+      if (this.intentionalClose) return;
+      this.doConnect().catch(() => {
+      });
+    }, delay);
+  }
+  startHeartbeat() {
+    this.clearHeartbeat();
+    this.heartbeatTimer = setInterval(() => {
+      if (this.ws?.readyState === WebSocket.OPEN) {
+        try {
+          this.ws.ping?.();
+        } catch {
+        }
+      }
+    }, this.heartbeatMs);
+  }
+  clearHeartbeat() {
+    if (this.heartbeatTimer) {
+      clearInterval(this.heartbeatTimer);
+      this.heartbeatTimer = null;
+    }
+  }
+};
+
+export { WebSocketClientTransport };
+//# sourceMappingURL=chunk-7PTP3SQJ.js.map
+//# sourceMappingURL=chunk-7PTP3SQJ.js.map

package/dist/chunk-7PTP3SQJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../transport/src/ws/client.ts"],"names":[],"mappings":"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","file":"chunk-7PTP3SQJ.js","sourcesContent":["/**\n * WebSocketClientTransport — connects to a skaile serve WebSocket server.\n *\n * Handles connection, reconnection with exponential backoff, heartbeat,\n * and JSON serialization. Implements ClientTransport from @skaile/workspaces/types.\n */\n\nimport type { AgentCommand, AgentEvent, ClientTransport } from \"@skaile/workspaces/types\";\n\nconst DEFAULT_RECONNECT_MAX_ATTEMPTS = 5;\nconst DEFAULT_RECONNECT_BASE_MS = 1_000;\nconst DEFAULT_RECONNECT_MAX_MS = 30_000;\nconst DEFAULT_HEARTBEAT_MS = 30_000;\nconst DEFAULT_CONNECT_TIMEOUT_MS = 10_000;\n\n/**\n * Options for {@link WebSocketClientTransport}.\n *\n * @param url - WebSocket server URL to connect to (e.g. `ws://localhost:8080`).\n * @param reconnect - Exponential-backoff reconnect policy. Defaults: 5 attempts, 1s base, 30s max.\n * @param heartbeatMs - Interval in milliseconds between WebSocket ping frames. Default: 30 000.\n * @param connectTimeoutMs - Maximum time in milliseconds to wait for the initial handshake. Default: 10 000.\n * @param onLog - Optional callback for internal log lines (connection state, errors).\n *\n * @docLink packages/transport/dev-guide#websocket-client-transport\n */\nexport interface WebSocketClientOptions {\n  url: string;\n  reconnect?: {\n    maxAttempts?: number;\n    baseMs?: number;\n    maxMs?: number;\n  };\n  heartbeatMs?: number;\n  connectTimeoutMs?: number;\n  onLog?: (line: string) => void;\n}\n\n/**\n * `ClientTransport` implementation that connects to a skaile agent server over WebSocket.\n *\n * Uses the browser-standard `WebSocket` API so it works in both Bun and browser\n * environments. On an unintentional disconnect it automatically retries with\n * exponential backoff (default: 5 attempts, 1s base, 30s max). A periodic ping\n * keeps the connection alive through NAT and load-balancer idle timeouts. All\n * `AgentCommand` / `AgentEvent` messages are JSON-serialised on the wire.\n *\n * @example\n * ```ts\n * const transport = new WebSocketClientTransport({ url: 'ws://localhost:8080' });\n * await transport.connect();\n * transport.send({ type: 'prompt', prompt: 'Hello' });\n * ```\n *\n * @docLink packages/transport/dev-guide#websocket-client-transport\n */\nexport class WebSocketClientTransport implements ClientTransport {\n  private ws: WebSocket | null = null;\n  private readonly url: string;\n  private readonly reconnectConfig: Required<NonNullable<WebSocketClientOptions[\"reconnect\"]>>;\n  private readonly heartbeatMs: number;\n  private readonly connectTimeoutMs: number;\n  private readonly log: (line: string) => void;\n\n  private heartbeatTimer: ReturnType<typeof setInterval> | null = null;\n  private reconnectAttempts = 0;\n  private intentionalClose = false;\n\n  private readonly messageHandlers = new Set<(event: AgentEvent) => void>();\n  private readonly disconnectHandlers = new Set<() => void>();\n\n  constructor(options: WebSocketClientOptions) {\n    this.url = options.url;\n    this.reconnectConfig = {\n      maxAttempts: options.reconnect?.maxAttempts ?? DEFAULT_RECONNECT_MAX_ATTEMPTS,\n      baseMs: options.reconnect?.baseMs ?? DEFAULT_RECONNECT_BASE_MS,\n      maxMs: options.reconnect?.maxMs ?? DEFAULT_RECONNECT_MAX_MS,\n    };\n    this.heartbeatMs = options.heartbeatMs ?? DEFAULT_HEARTBEAT_MS;\n    this.connectTimeoutMs = options.connectTimeoutMs ?? DEFAULT_CONNECT_TIMEOUT_MS;\n    this.log = options.onLog ?? (() => {});\n  }\n\n  async connect(): Promise<void> {\n    this.intentionalClose = false;\n    this.reconnectAttempts = 0;\n    return this.doConnect();\n  }\n\n  async disconnect(): Promise<void> {\n    this.intentionalClose = true;\n    this.clearHeartbeat();\n    if (this.ws) {\n      if (this.ws.readyState === WebSocket.OPEN) {\n        this.ws.close(1000, \"Client disconnect\");\n      }\n      this.ws = null;\n    }\n  }\n\n  send(command: AgentCommand): void {\n    if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {\n      this.log(\"[ws-client] cannot send: not connected\");\n      return;\n    }\n    this.ws.send(JSON.stringify(command));\n  }\n\n  onMessage(handler: (event: AgentEvent) => void): () => void {\n    this.messageHandlers.add(handler);\n    return () => {\n      this.messageHandlers.delete(handler);\n    };\n  }\n\n  onDisconnect(handler: () => void): () => void {\n    this.disconnectHandlers.add(handler);\n    return () => {\n      this.disconnectHandlers.delete(handler);\n    };\n  }\n\n  get connected(): boolean {\n    return this.ws?.readyState === WebSocket.OPEN;\n  }\n\n  // ---------------------------------------------------------------------------\n  // Internal\n  // ---------------------------------------------------------------------------\n\n  private doConnect(): Promise<void> {\n    return new Promise<void>((resolve, reject) => {\n      this.log(`[ws-client] connecting to ${this.url}`);\n\n      const ws = new WebSocket(this.url);\n      this.ws = ws;\n\n      const timeout = setTimeout(() => {\n        ws.close();\n        reject(new Error(`Connection timeout to ${this.url}`));\n      }, this.connectTimeoutMs);\n\n      ws.addEventListener(\"open\", () => {\n        clearTimeout(timeout);\n        this.log(\"[ws-client] connected\");\n        this.reconnectAttempts = 0;\n        this.startHeartbeat();\n        resolve();\n      });\n\n      ws.addEventListener(\"message\", (event) => {\n        try {\n          const data = JSON.parse(String(event.data)) as AgentEvent;\n          for (const handler of this.messageHandlers) {\n            handler(data);\n          }\n        } catch {\n          this.log(\"[ws-client] failed to parse message\");\n        }\n      });\n\n      ws.addEventListener(\"close\", (event) => {\n        clearTimeout(timeout);\n        this.clearHeartbeat();\n        this.log(`[ws-client] disconnected (code=${event.code})`);\n\n        for (const handler of this.disconnectHandlers) {\n          handler();\n        }\n\n        if (!this.intentionalClose && event.code !== 1000) {\n          this.scheduleReconnect();\n        }\n      });\n\n      ws.addEventListener(\"error\", () => {\n        clearTimeout(timeout);\n        // The close event fires after error, handling reconnection\n      });\n    });\n  }\n\n  private scheduleReconnect(): void {\n    if (this.reconnectAttempts >= this.reconnectConfig.maxAttempts) {\n      this.log(`[ws-client] giving up reconnect after ${this.reconnectAttempts} attempts`);\n      return;\n    }\n\n    this.reconnectAttempts++;\n    const delay = Math.min(\n      this.reconnectConfig.baseMs * 2 ** (this.reconnectAttempts - 1),\n      this.reconnectConfig.maxMs,\n    );\n    this.log(`[ws-client] reconnecting in ${delay}ms (attempt ${this.reconnectAttempts})`);\n\n    setTimeout(() => {\n      if (this.intentionalClose) return;\n      this.doConnect().catch(() => {\n        // doConnect rejection triggers another close → scheduleReconnect cycle\n      });\n    }, delay);\n  }\n\n  private startHeartbeat(): void {\n    this.clearHeartbeat();\n    this.heartbeatTimer = setInterval(() => {\n      if (this.ws?.readyState === WebSocket.OPEN) {\n        // WebSocket ping — Bun's WebSocket supports ping natively\n        try {\n          (this.ws as unknown as { ping?: () => void }).ping?.();\n        } catch {\n          // Fallback: some environments don't support ping on the client\n        }\n      }\n    }, this.heartbeatMs);\n  }\n\n  private clearHeartbeat(): void {\n    if (this.heartbeatTimer) {\n      clearInterval(this.heartbeatTimer);\n      this.heartbeatTimer = null;\n    }\n  }\n}\n"]}

package/dist/chunk-AIGWF3TJ.js

@@ -0,0 +1,73 @@
+import { err, okJson, ok } from './chunk-X5YPJV4N.js';
+
+// workspace-plugin/src/tools/connectors.ts
+async function connectorList(manager) {
+  if (!manager) return err("No connectors configured in skaile.yaml");
+  try {
+    const connectors = manager.listConnectors();
+    return okJson(connectors);
+  } catch (e) {
+    return err(e instanceof Error ? e.message : String(e));
+  }
+}
+async function connectorRead(manager, id, path) {
+  if (!manager) return err("No connectors configured in skaile.yaml");
+  try {
+    const content = await manager.read(id, path);
+    if (content === null) return err(`No content at path "${path}" in connector "${id}"`);
+    return okJson(content);
+  } catch (e) {
+    return err(e instanceof Error ? e.message : String(e));
+  }
+}
+async function connectorWrite(manager, id, path, content) {
+  if (!manager) return err("No connectors configured in skaile.yaml");
+  try {
+    await manager.write(id, path, { data: content });
+    return ok(`Written to "${path}" in connector "${id}"`);
+  } catch (e) {
+    return err(e instanceof Error ? e.message : String(e));
+  }
+}
+async function connectorSearch(manager, id, query) {
+  if (!manager) return err("No connectors configured in skaile.yaml");
+  try {
+    const results = await manager.search(id, query);
+    return okJson(results);
+  } catch (e) {
+    return err(e instanceof Error ? e.message : String(e));
+  }
+}
+async function connectorExec(manager, id, operation, args) {
+  if (!manager) return err("No connectors configured in skaile.yaml");
+  try {
+    const result = await manager.executeOp(id, operation, args);
+    return ok(result);
+  } catch (e) {
+    return err(e instanceof Error ? e.message : String(e));
+  }
+}
+async function connectorLoadSkill(manager, id) {
+  if (!manager) return err("No connectors configured in skaile.yaml");
+  try {
+    const skill = manager.loadSkill(id);
+    return ok(skill);
+  } catch (e) {
+    return err(e instanceof Error ? e.message : String(e));
+  }
+}
+async function connectorDescribe(manager, id) {
+  if (!manager) return err("No connectors configured in skaile.yaml");
+  try {
+    const skills = manager.listSkills();
+    const descriptor = skills.find((s) => s.id === id);
+    if (!descriptor) return err(`No skill descriptor for connector "${id}"`);
+    return okJson(descriptor);
+  } catch (e) {
+    return err(e instanceof Error ? e.message : String(e));
+  }
+}
+
+export { connectorDescribe, connectorExec, connectorList, connectorLoadSkill, connectorRead, connectorSearch, connectorWrite };
+//# sourceMappingURL=chunk-AIGWF3TJ.js.map
+//# sourceMappingURL=chunk-AIGWF3TJ.js.map

package/dist/chunk-AIGWF3TJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../workspace-plugin/src/tools/connectors.ts"],"names":[],"mappings":"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","file":"chunk-AIGWF3TJ.js","sourcesContent":["// src/tools/connectors.ts\nimport type { ConnectorManager } from \"@skaile/workspaces/connectors\";\nimport { err, ok, okJson } from \"../types.js\";\nimport type { ToolResult } from \"../types.js\";\n\n/**\n * List all connectors registered with the `ConnectorManager`.\n *\n * Returns a JSON array of connector descriptors as reported by\n * `manager.listConnectors()`.  Returns an error result when no manager is\n * configured (i.e. `skaile.yaml` has no `connectors` section).\n *\n * @param manager - Active `ConnectorManager` or `null` when not configured.\n *\n * @docLink packages/workspace-plugin/concepts#tool-delivery\n */\nexport async function connectorList(manager: ConnectorManager | null): Promise<ToolResult> {\n  if (!manager) return err(\"No connectors configured in skaile.yaml\");\n  try {\n    const connectors = manager.listConnectors();\n    return okJson(connectors);\n  } catch (e: unknown) {\n    return err(e instanceof Error ? e.message : String(e));\n  }\n}\n\n/**\n * Read content from a connector at the given path.\n *\n * Delegates to `manager.read(id, path)`.  Returns an error result when the\n * path yields `null` (not found) or the manager is absent.\n *\n * @param manager - Active `ConnectorManager` or `null`.\n * @param id      - Connector ID declared in `skaile.yaml`.\n * @param path    - Resource path within the connector (connector-specific format).\n *\n * @docLink packages/workspace-plugin/concepts#tool-delivery\n */\nexport async function connectorRead(\n  manager: ConnectorManager | null,\n  id: string,\n  path: string,\n): Promise<ToolResult> {\n  if (!manager) return err(\"No connectors configured in skaile.yaml\");\n  try {\n    const content = await manager.read(id, path);\n    if (content === null) return err(`No content at path \"${path}\" in connector \"${id}\"`);\n    return okJson(content);\n  } catch (e: unknown) {\n    return err(e instanceof Error ? e.message : String(e));\n  }\n}\n\n/**\n * Write string content to a connector at the given path.\n *\n * Delegates to `manager.write(id, path, { data: content })`.\n *\n * @param manager - Active `ConnectorManager` or `null`.\n * @param id      - Connector ID declared in `skaile.yaml`.\n * @param path    - Destination path within the connector.\n * @param content - String payload to write.\n *\n * @docLink packages/workspace-plugin/concepts#tool-delivery\n */\nexport async function connectorWrite(\n  manager: ConnectorManager | null,\n  id: string,\n  path: string,\n  content: string,\n): Promise<ToolResult> {\n  if (!manager) return err(\"No connectors configured in skaile.yaml\");\n  try {\n    await manager.write(id, path, { data: content });\n    return ok(`Written to \"${path}\" in connector \"${id}\"`);\n  } catch (e: unknown) {\n    return err(e instanceof Error ? e.message : String(e));\n  }\n}\n\n/**\n * Search a connector's data using a query string.\n *\n * Delegates to `manager.search(id, query)` and returns the result set as JSON.\n *\n * @param manager - Active `ConnectorManager` or `null`.\n * @param id      - Connector ID declared in `skaile.yaml`.\n * @param query   - Free-text or structured query (connector-specific format).\n *\n * @docLink packages/workspace-plugin/concepts#tool-delivery\n */\nexport async function connectorSearch(\n  manager: ConnectorManager | null,\n  id: string,\n  query: string,\n): Promise<ToolResult> {\n  if (!manager) return err(\"No connectors configured in skaile.yaml\");\n  try {\n    const results = await manager.search(id, query);\n    return okJson(results);\n  } catch (e: unknown) {\n    return err(e instanceof Error ? e.message : String(e));\n  }\n}\n\n/**\n * Execute a named operation on a connector.\n *\n * Delegates to `manager.executeOp(id, operation, args)`.  Operations and\n * their argument shapes are connector-specific; use {@link connectorDescribe}\n * to discover what operations a connector supports.\n *\n * @param manager   - Active `ConnectorManager` or `null`.\n * @param id        - Connector ID declared in `skaile.yaml`.\n * @param operation - Operation name (from the connector's `RuntimeSkillDescriptor`).\n * @param args      - Named arguments for the operation.\n *\n * @docLink packages/workspace-plugin/concepts#tool-delivery\n */\nexport async function connectorExec(\n  manager: ConnectorManager | null,\n  id: string,\n  operation: string,\n  args: Record<string, unknown>,\n): Promise<ToolResult> {\n  if (!manager) return err(\"No connectors configured in skaile.yaml\");\n  try {\n    const result = await manager.executeOp(id, operation, args);\n    return ok(result);\n  } catch (e: unknown) {\n    return err(e instanceof Error ? e.message : String(e));\n  }\n}\n\n/**\n * Load the rendered skill body for a connector.\n *\n * Delegates to `manager.loadSkill(id)` and returns the skill content as\n * plain text.  Useful when the agent needs the connector's operations and\n * usage instructions injected as prompt context.\n *\n * @param manager - Active `ConnectorManager` or `null`.\n * @param id      - Connector ID declared in `skaile.yaml`.\n *\n * @docLink packages/workspace-plugin/concepts#tool-delivery\n */\nexport async function connectorLoadSkill(\n  manager: ConnectorManager | null,\n  id: string,\n): Promise<ToolResult> {\n  if (!manager) return err(\"No connectors configured in skaile.yaml\");\n  try {\n    const skill = manager.loadSkill(id);\n    return ok(skill);\n  } catch (e: unknown) {\n    return err(e instanceof Error ? e.message : String(e));\n  }\n}\n\n/**\n * Describe a connector's capabilities via its `RuntimeSkillDescriptor`.\n *\n * Finds the matching skill descriptor from `manager.listSkills()` and returns\n * it as JSON.  The descriptor includes the connector's operations, argument\n * shapes, and usage instructions.\n *\n * @param manager - Active `ConnectorManager` or `null`.\n * @param id      - Connector ID declared in `skaile.yaml`.\n *\n * @docLink packages/workspace-plugin/concepts#tool-delivery\n */\nexport async function connectorDescribe(\n  manager: ConnectorManager | null,\n  id: string,\n): Promise<ToolResult> {\n  if (!manager) return err(\"No connectors configured in skaile.yaml\");\n  try {\n    const skills = manager.listSkills();\n    const descriptor = skills.find((s) => s.id === id);\n    if (!descriptor) return err(`No skill descriptor for connector \"${id}\"`);\n    return okJson(descriptor);\n  } catch (e: unknown) {\n    return err(e instanceof Error ? e.message : String(e));\n  }\n}\n"]}