@skaile/workspaces 0.8.5

package/dist/chunk-CGYEHQOX.js

@@ -0,0 +1,117 @@
+import { existsSync, readFileSync } from 'fs';
+import { resolve } from 'path';
+
+// asset-manager/src/fragments.ts
+function agentModeFragment(ctx) {
+  if (ctx.subAgents.length === 0) {
+    return [
+      "## Operating Mode",
+      "",
+      "You are the sole agent for this workspace. Complete tasks autonomously",
+      "using your installed abilities and connected resources."
+    ].join("\n");
+  }
+  const list = ctx.subAgents.map((n) => `- \`${n}\``).join("\n");
+  return [
+    "## Operating Mode",
+    "",
+    "You are the orchestrator for this workspace. Coordinate specialized",
+    "sub-agents when tasks fall within their expertise:",
+    "",
+    list,
+    "",
+    "Delegate clearly: describe the task, expected output format, and any",
+    "constraints. Synthesize results before presenting to the user."
+  ].join("\n");
+}
+function handoffFragment(ctx) {
+  if (ctx.subAgents.length === 0) return null;
+  const lines = [
+    "## Delegation",
+    "",
+    "When delegating to a sub-agent:",
+    "1. State the specific task and its acceptance criteria.",
+    "2. Provide relevant context the sub-agent cannot infer on its own.",
+    "3. Specify the expected output format.",
+    "4. If the result is incomplete, refine and retry once before escalating."
+  ];
+  if (ctx.framework === "claude-code") {
+    lines.push("", `Use the Agent tool to dispatch. Sub-agents are in \`${ctx.agentsDir}/\`.`);
+  }
+  return lines.join("\n");
+}
+function skillDiscoveryFragment(ctx) {
+  if (ctx.abilityRefs.length === 0 && ctx.contractRefs.length === 0) return null;
+  const lines = [
+    "## Skills and Abilities",
+    "",
+    `Your specialized abilities are installed in \`${ctx.skillsDir}/\`.`,
+    "Read a skill's SKILL.md before executing a task that matches its purpose."
+  ];
+  if (ctx.framework === "claude-code") {
+    lines.push("Abilities are also available as slash commands.");
+  }
+  if (ctx.contractRefs.length > 0) {
+    lines.push(
+      "",
+      `Operational contracts are co-located in \`${ctx.skillsDir}/\`. Read the`,
+      "relevant CONTRACT.md before acting on any constrained task."
+    );
+  }
+  return lines.join("\n");
+}
+function connectorUsageFragment(ctx) {
+  if (ctx.connectors.length === 0) return null;
+  const rows = ctx.connectors.map((c) => `- \`${c.id}\` (${c.driver}, ${c.access})`);
+  return [
+    "## Connected Resources",
+    "",
+    "The following data sources are connected to this workspace:",
+    "",
+    ...rows,
+    "",
+    "Access via `skaile res <id> <operation>` or the registered tool functions.",
+    "Respect the declared access level \u2014 read-only resources must not be written to."
+  ].join("\n");
+}
+var BUILT_IN_FRAGMENTS = {
+  "agent-mode": agentModeFragment,
+  handoff: handoffFragment,
+  "skill-discovery": skillDiscoveryFragment,
+  "connector-usage": connectorUsageFragment
+};
+function resolveFragments(ctx, overrides, workspaceRoot) {
+  const results = [];
+  for (const id of [
+    "agent-mode",
+    "handoff",
+    "skill-discovery",
+    "connector-usage"
+  ]) {
+    const override = overrides?.[id];
+    if (override === false) continue;
+    if (typeof override === "string") {
+      const filePath = resolve(workspaceRoot, override);
+      if (existsSync(filePath)) {
+        const content = readFileSync(filePath, "utf-8").trim();
+        if (content) results.push(content);
+      }
+      continue;
+    }
+    const fragment = BUILT_IN_FRAGMENTS[id](ctx);
+    if (fragment) results.push(fragment);
+  }
+  return results;
+}
+function loadPromptExtensions(paths, workspaceRoot) {
+  if (!paths?.length) return [];
+  return paths.map((p) => {
+    const filePath = resolve(workspaceRoot, p);
+    if (!existsSync(filePath)) return null;
+    return readFileSync(filePath, "utf-8").trim();
+  }).filter((s) => s !== null && s.length > 0);
+}
+
+export { BUILT_IN_FRAGMENTS, loadPromptExtensions, resolveFragments };
+//# sourceMappingURL=chunk-CGYEHQOX.js.map
+//# sourceMappingURL=chunk-CGYEHQOX.js.map

package/dist/chunk-CGYEHQOX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../asset-manager/src/fragments.ts"],"names":[],"mappings":"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","file":"chunk-CGYEHQOX.js","sourcesContent":["/**\n * Framework fragments — conditional system prompt sections injected by the\n * agent renderer at install time.\n *\n * Each fragment explains a specific aspect of the agent framework to the agent.\n * Fragments are conditional (return null when context is empty) and overridable\n * per project via skaile.yaml `agent.fragments`.\n */\n\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\n// ── Types ─────────────────────────────────────────────────────────────────────\n\n/**\n * A skill installed into the agent's ability directory, referenced in the system prompt.\n *\n * @docLink packages/asset-manager/api-reference#fragments\n */\nexport interface AbilityRef {\n  /** Skill name used as the slash command (e.g. `\"code-review\"`). */\n  name: string;\n  /** One-line description shown in the `## Installed Abilities` section. */\n  description: string;\n}\n\n/**\n * A contract file installed alongside skills, referenced by path in the system prompt.\n *\n * @docLink packages/asset-manager/api-reference#fragments\n */\nexport interface ContractRef {\n  /** Contract name for display purposes. */\n  name: string;\n  /** Path relative to workspace root, e.g. `\".claude/skills/iron-laws/CONTRACT.md\"`. */\n  relativePath: string;\n}\n\n/**\n * A data connector declared in `skaile.yaml` resources.\n *\n * @docLink packages/asset-manager/api-reference#fragments\n */\nexport interface ConnectorRef {\n  /** Connector ID as declared in `skaile.yaml`. */\n  id: string;\n  /** Connector driver type (e.g. `\"postgres\"`, `\"redis\"`, `\"sqlite\"`). */\n  driver: string;\n  /** Declared access level (`\"read-only\"` or `\"read-write\"`). */\n  access: string;\n}\n\n/**\n * Context passed to each fragment function at render time.\n *\n * @docLink packages/asset-manager/api-reference#fragments\n */\nexport interface FragmentContext {\n  /** Agent framework ID (e.g. `\"claude-code\"`, `\"omp\"`, `\"codex\"`). */\n  framework: string;\n  /** Relative path to the framework's skill/ability directory, e.g. `\".claude/skills\"`. */\n  skillsDir: string;\n  /** Relative path to the framework's agent directory, e.g. `\".claude/agents\"`. */\n  agentsDir: string;\n  /** Sub-agent names from `manifest.requires[]`. */\n  subAgents: string[];\n  /** Connectors declared in `skaile.yaml`. */\n  connectors: ConnectorRef[];\n  /** Resolved ability refs (installed skills). */\n  abilityRefs: AbilityRef[];\n  /** Resolved contract refs (installed alongside skills). */\n  contractRefs: ContractRef[];\n}\n\n/**\n * Identifier for a built-in system prompt fragment.\n * - `\"agent-mode\"` — describes whether the agent is a sole agent or an orchestrator.\n * - `\"handoff\"` — delegation guidelines injected when sub-agents are declared.\n * - `\"skill-discovery\"` — skill directory location injected when abilities are installed.\n * - `\"connector-usage\"` — connected resources list injected when connectors are declared.\n *\n * @docLink packages/asset-manager/api-reference#fragments\n */\nexport type FragmentId = \"agent-mode\" | \"handoff\" | \"skill-discovery\" | \"connector-usage\";\n\n// ── Built-in fragments ────────────────────────────────────────────────────────\n\nfunction agentModeFragment(ctx: FragmentContext): string | null {\n  if (ctx.subAgents.length === 0) {\n    return [\n      \"## Operating Mode\",\n      \"\",\n      \"You are the sole agent for this workspace. Complete tasks autonomously\",\n      \"using your installed abilities and connected resources.\",\n    ].join(\"\\n\");\n  }\n\n  const list = ctx.subAgents.map((n) => `- \\`${n}\\``).join(\"\\n\");\n  return [\n    \"## Operating Mode\",\n    \"\",\n    \"You are the orchestrator for this workspace. Coordinate specialized\",\n    \"sub-agents when tasks fall within their expertise:\",\n    \"\",\n    list,\n    \"\",\n    \"Delegate clearly: describe the task, expected output format, and any\",\n    \"constraints. Synthesize results before presenting to the user.\",\n  ].join(\"\\n\");\n}\n\nfunction handoffFragment(ctx: FragmentContext): string | null {\n  if (ctx.subAgents.length === 0) return null;\n\n  const lines = [\n    \"## Delegation\",\n    \"\",\n    \"When delegating to a sub-agent:\",\n    \"1. State the specific task and its acceptance criteria.\",\n    \"2. Provide relevant context the sub-agent cannot infer on its own.\",\n    \"3. Specify the expected output format.\",\n    \"4. If the result is incomplete, refine and retry once before escalating.\",\n  ];\n\n  if (ctx.framework === \"claude-code\") {\n    lines.push(\"\", `Use the Agent tool to dispatch. Sub-agents are in \\`${ctx.agentsDir}/\\`.`);\n  }\n\n  return lines.join(\"\\n\");\n}\n\nfunction skillDiscoveryFragment(ctx: FragmentContext): string | null {\n  if (ctx.abilityRefs.length === 0 && ctx.contractRefs.length === 0) return null;\n\n  const lines = [\n    \"## Skills and Abilities\",\n    \"\",\n    `Your specialized abilities are installed in \\`${ctx.skillsDir}/\\`.`,\n    \"Read a skill's SKILL.md before executing a task that matches its purpose.\",\n  ];\n\n  if (ctx.framework === \"claude-code\") {\n    lines.push(\"Abilities are also available as slash commands.\");\n  }\n\n  if (ctx.contractRefs.length > 0) {\n    lines.push(\n      \"\",\n      `Operational contracts are co-located in \\`${ctx.skillsDir}/\\`. Read the`,\n      \"relevant CONTRACT.md before acting on any constrained task.\",\n    );\n  }\n\n  return lines.join(\"\\n\");\n}\n\nfunction connectorUsageFragment(ctx: FragmentContext): string | null {\n  if (ctx.connectors.length === 0) return null;\n\n  const rows = ctx.connectors.map((c) => `- \\`${c.id}\\` (${c.driver}, ${c.access})`);\n\n  return [\n    \"## Connected Resources\",\n    \"\",\n    \"The following data sources are connected to this workspace:\",\n    \"\",\n    ...rows,\n    \"\",\n    \"Access via `skaile res <id> <operation>` or the registered tool functions.\",\n    \"Respect the declared access level — read-only resources must not be written to.\",\n  ].join(\"\\n\");\n}\n\n/**\n * Registry of all built-in fragment functions keyed by {@link FragmentId}.\n *\n * Each function receives a {@link FragmentContext} and returns the fragment markdown\n * to inject, or `null` when the fragment's condition is not met (e.g. `\"handoff\"`\n * returns `null` when there are no sub-agents).\n *\n * @docLink packages/asset-manager/api-reference#fragments\n */\nexport const BUILT_IN_FRAGMENTS: Record<FragmentId, (ctx: FragmentContext) => string | null> = {\n  \"agent-mode\": agentModeFragment,\n  handoff: handoffFragment,\n  \"skill-discovery\": skillDiscoveryFragment,\n  \"connector-usage\": connectorUsageFragment,\n};\n\n// ── Resolution ────────────────────────────────────────────────────────────────\n\n/**\n * Resolve all framework fragments for the rendered system prompt.\n *\n * Applies per-project overrides from `skaile.yaml` `agent.fragments`:\n * - `true` / absent → include built-in fragment (default)\n * - `false` → omit fragment\n * - `string` → load markdown from path relative to `workspaceRoot`\n *\n * @param ctx - Fragment context built from the agent manifest and workspace config.\n * @param overrides - Per-project overrides map from `skaile.yaml` `agent.fragments`.\n * @param workspaceRoot - Absolute path to the workspace root (for resolving custom fragment paths).\n * @returns Ordered list of resolved fragment markdown strings to inject into the system prompt.\n * @docLink packages/asset-manager/api-reference#fragments\n */\nexport function resolveFragments(\n  ctx: FragmentContext,\n  overrides: Record<string, boolean | string> | undefined,\n  workspaceRoot: string,\n): string[] {\n  const results: string[] = [];\n\n  for (const id of [\n    \"agent-mode\",\n    \"handoff\",\n    \"skill-discovery\",\n    \"connector-usage\",\n  ] as FragmentId[]) {\n    const override = overrides?.[id];\n\n    if (override === false) continue;\n\n    if (typeof override === \"string\") {\n      const filePath = resolve(workspaceRoot, override);\n      if (existsSync(filePath)) {\n        const content = readFileSync(filePath, \"utf-8\").trim();\n        if (content) results.push(content);\n      }\n      continue;\n    }\n\n    // true or absent — use built-in\n    const fragment = BUILT_IN_FRAGMENTS[id](ctx);\n    if (fragment) results.push(fragment);\n  }\n\n  return results;\n}\n\n/**\n * Load prompt-extension files declared under `skaile.yaml` `agent.prompt-extensions`.\n *\n * Paths are relative to `workspaceRoot`. Missing files are silently skipped.\n *\n * @param paths - Array of relative file paths from `skaile.yaml` `agent.prompt-extensions`.\n * @param workspaceRoot - Absolute path to the workspace root.\n * @returns Non-empty content strings for each file that exists and is non-empty.\n * @docLink packages/asset-manager/api-reference#fragments\n */\nexport function loadPromptExtensions(paths: string[] | undefined, workspaceRoot: string): string[] {\n  if (!paths?.length) return [];\n  return paths\n    .map((p) => {\n      const filePath = resolve(workspaceRoot, p);\n      if (!existsSync(filePath)) return null;\n      return readFileSync(filePath, \"utf-8\").trim();\n    })\n    .filter((s): s is string => s !== null && s.length > 0);\n}\n"]}