@yourgpt/copilot-sdk 2.1.4 → 2.1.5-alpha.1

package/dist/react/index.js

@@ -1,9 +1,11 @@
-export { AbstractAgentLoop, AbstractChat, CopilotProvider, ReactChat, ReactChatState, ReactThreadManager, ReactThreadManagerState, createMessageIntentHandler, createPermissionStorage, createReactChat, createReactChatState, createReactThreadManager, createReactThreadManagerState, createSessionPermissionCache, createToolIntentHandler, formatKnowledgeResultsForAI, initialAgentLoopState, searchKnowledgeBase, useAIAction, useAIActions, useAIContext, useAIContexts, useAITools, useAgent, useCapabilities, useChat, useCopilot, useDevLogger, useFeatureSupport, useKnowledgeBase, useMCPClient, useMCPTools, useMCPUIIntents, useSuggestions, useSupportedMediaTypes, useThreadManager, useTool, useToolExecutor, useToolWithSchema, useTools, useToolsWithSchema } from '../chunk-7PKGRYHY.js';
-export { createLocalStorageAdapter, createMemoryAdapter, createServerAdapter, generateSuggestionReason } from '../chunk-37KEHUCE.js';
+export { AbstractAgentLoop, AbstractChat, CopilotProvider, MessageHistoryContext, MessageTree, ReactChat, ReactChatState, ReactThreadManager, ReactThreadManagerState, SkillProvider, createMessageIntentHandler, createPermissionStorage, createReactChat, createReactChatState, createReactThreadManager, createReactThreadManagerState, createSessionPermissionCache, createToolIntentHandler, defaultMessageHistoryConfig, defineSkill, formatKnowledgeResultsForAI, initialAgentLoopState, isCompactionMarker, keepToolPairsAtomic, searchKnowledgeBase, toDisplayMessage, toLLMMessage, toLLMMessages, useAIAction, useAIActions, useAIContext, useAIContexts, useAITools, useAgent, useCapabilities, useChat, useContextStats, useCopilot, useDevLogger, useFeatureSupport, useKnowledgeBase, useMCPClient, useMCPTools, useMCPUIIntents, useMessageHistory, useMessageHistoryContext, useSkill, useSkillStatus, useSuggestions, useSupportedMediaTypes, useThreadManager, useTool, useToolExecutor, useToolWithSchema, useTools, useToolsWithSchema } from '../chunk-5Q72LZ5H.js';
+export { createLocalStorageAdapter, createMemoryAdapter, createServerAdapter, generateSuggestionReason } from '../chunk-UXJ6LIZB.js';
 import '../chunk-EWVQWTNV.js';
-import '../chunk-LZMBBGWH.js';
-export { tool } from '../chunk-QLH6TSCC.js';
-import '../chunk-XGITAEXU.js';
+import '../chunk-VNLLW3ZI.js';
+import '../chunk-ENFWM3EY.js';
+export { tool } from '../chunk-4QXY2PBG.js';
+import '../chunk-LLM7AHMO.js';
+import '../chunk-RQ74USYU.js';
 import '../chunk-7W7QLZNC.js';
 import '../chunk-CEOMTQTP.js';
 import '../chunk-PPFHA6IL.js';
@@ -11,7 +13,6 @@ import '../chunk-DABZYCVX.js';
 import '../chunk-MNDGIW47.js';
 import '../chunk-VD74IPKB.js';
 import '../chunk-53UGJNHN.js';
-import '../chunk-RQ74USYU.js';
 import '../chunk-DGUM43GV.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/server/index.cjs

@@ -0,0 +1,339 @@
+'use strict';
+
+var chunkBJYA5NDL_cjs = require('../chunk-BJYA5NDL.cjs');
+require('../chunk-JEQ2X3Z6.cjs');
+
+// src/server/compact-session.ts
+var COMPACTION_PROMPT = `You are summarizing a conversation to preserve its key context while reducing token usage. Create a structured summary that includes:
+
+1. **User's primary goals and requests** \u2014 what the user is trying to accomplish
+2. **Technical decisions made** \u2014 libraries chosen, schemas designed, approaches selected
+3. **Tool call outcomes** \u2014 what tools were called, key arguments, result status and brief outcome
+4. **Errors encountered** \u2014 what went wrong and how it was resolved
+5. **User messages** \u2014 verbatim if short (<50 words), paraphrased if long
+6. **Pending tasks** \u2014 unresolved questions or next steps mentioned
+7. **Current work state** \u2014 what was in progress when this summary was created
+
+Rules:
+- Preserve ALL specific values: file names, variable names, URLs, error messages, IDs
+- Be detailed on recent work, more concise on earlier work
+- Output structured prose (not bullet JSON)
+- Do NOT include meta-commentary about the summarization itself`;
+async function compactSession(options) {
+  const {
+    messages,
+    existingSummary,
+    workingMemory = [],
+    model = "claude-haiku-4-5-20251001",
+    maxSummaryTokens = 1024,
+    fetchImpl = fetch,
+    apiKey = typeof process !== "undefined" ? process.env.ANTHROPIC_API_KEY : void 0,
+    apiBaseUrl = "https://api.anthropic.com"
+  } = options;
+  if (!apiKey) {
+    throw new Error(
+      "compactSession: No API key provided. Set ANTHROPIC_API_KEY or pass options.apiKey."
+    );
+  }
+  const parts = [];
+  if (workingMemory.length > 0) {
+    parts.push(
+      `[Working memory \u2014 always preserve these facts]
+${workingMemory.join("\n")}`
+    );
+  }
+  if (existingSummary) {
+    parts.push(`[Previous summary \u2014 extend/update this]
+${existingSummary}`);
+  }
+  const conversationText = messages.map((m) => `${m.role.toUpperCase()}: ${m.content ?? "(no content)"}`).join("\n\n");
+  parts.push(`[Conversation to summarize]
+${conversationText}`);
+  const userContent = parts.join("\n\n---\n\n");
+  const response = await fetchImpl(`${apiBaseUrl}/v1/messages`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "x-api-key": apiKey,
+      "anthropic-version": "2023-06-01"
+    },
+    body: JSON.stringify({
+      model,
+      max_tokens: maxSummaryTokens,
+      system: COMPACTION_PROMPT,
+      messages: [{ role: "user", content: userContent }]
+    })
+  });
+  if (!response.ok) {
+    const err = await response.text();
+    throw new Error(
+      `compactSession: Anthropic API error ${response.status}: ${err}`
+    );
+  }
+  const data = await response.json();
+  const summary = data.content.filter((b) => b.type === "text").map((b) => b.text).join("");
+  return { summary };
+}
+
+// src/skill-system/frontmatter.ts
+function parseSkillFile(raw) {
+  const frontmatterRegex = /^---\r?\n([\s\S]*?)\r?\n---/;
+  const match = frontmatterRegex.exec(raw);
+  if (!match) {
+    return { frontmatter: {}, content: raw.trim() };
+  }
+  const frontmatterBlock = match[1];
+  const frontmatter = parseFrontmatterBlock(frontmatterBlock);
+  const afterFrontmatter = raw.slice(match.index + match[0].length);
+  const content = afterFrontmatter.replace(/^\r?\n/, "").trim();
+  return { frontmatter, content };
+}
+function parseFrontmatterBlock(block) {
+  const result = {};
+  const lines = block.split(/\r?\n/);
+  for (const line of lines) {
+    const colonIndex = line.indexOf(":");
+    if (colonIndex === -1) continue;
+    const key = line.slice(0, colonIndex).trim();
+    const value = line.slice(colonIndex + 1).trim();
+    if (!key || !value) continue;
+    switch (key) {
+      case "name":
+        result.name = stripQuotes(value);
+        break;
+      case "description":
+        result.description = stripQuotes(value);
+        break;
+      case "strategy":
+        result.strategy = stripQuotes(value);
+        break;
+      case "version":
+        result.version = stripQuotes(value);
+        break;
+    }
+  }
+  return result;
+}
+function stripQuotes(value) {
+  if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+    return value.slice(1, -1);
+  }
+  return value;
+}
+
+// src/skill-system/load-skills.ts
+var VALID_STRATEGIES = /* @__PURE__ */ new Set(["eager", "auto", "manual"]);
+function isValidStrategy(s) {
+  return VALID_STRATEGIES.has(s);
+}
+async function loadSkills(options = {}) {
+  const registry = new chunkBJYA5NDL_cjs.SkillRegistry();
+  const diagnostics = [];
+  const sourceMap = /* @__PURE__ */ new Map();
+  if (options.dir) {
+    const dirSkills = await loadFromDir(options.dir);
+    for (const skill of dirSkills) {
+      registry.register(skill);
+      sourceMap.set(skill.name, "server-dir");
+    }
+  }
+  if (options.remoteUrls?.length) {
+    const urlSkills = await loadFromUrls(options.remoteUrls);
+    for (const skill of urlSkills) {
+      const existingSource = sourceMap.get(skill.name);
+      if (existingSource) {
+        diagnostics.push({
+          type: "collision",
+          name: skill.name,
+          winner: existingSource,
+          loser: "remote-url"
+        });
+        continue;
+      }
+      registry.register(skill);
+      sourceMap.set(skill.name, "remote-url");
+    }
+  }
+  if (options.clientSkills?.length) {
+    for (const inline of options.clientSkills) {
+      const existingSource = sourceMap.get(inline.name);
+      if (existingSource) {
+        diagnostics.push({
+          type: "collision",
+          name: inline.name,
+          winner: existingSource,
+          loser: "client-inline"
+        });
+        continue;
+      }
+      const skill = {
+        name: inline.name,
+        description: inline.description,
+        content: inline.content,
+        strategy: inline.strategy ?? "auto",
+        source: { type: "inline", content: inline.content }
+      };
+      registry.register(skill);
+      sourceMap.set(inline.name, "client-inline");
+    }
+  }
+  return {
+    skills: registry.getAll(),
+    diagnostics,
+    buildSystemPrompt(basePrompt) {
+      const parts = [];
+      if (basePrompt) {
+        parts.push(basePrompt);
+      }
+      const eagerContent = registry.buildEagerContent();
+      if (eagerContent) {
+        parts.push(eagerContent);
+      }
+      const catalog = registry.buildCatalog();
+      if (catalog) {
+        parts.push(
+          `You have access to specialized skills. Call load_skill({ name }) when relevant.
+
+${catalog}`
+        );
+      }
+      return parts.join("\n\n").trim();
+    },
+    tools: {
+      load_skill: {
+        description: "Load a skill by name to get full instructions for a specialized task.",
+        parameters: {
+          type: "object",
+          properties: {
+            name: {
+              type: "string",
+              description: "The name of the skill to load."
+            }
+          },
+          required: ["name"]
+        },
+        execute: async ({ name }) => {
+          const skill = registry.get(name);
+          if (!skill) {
+            return {
+              error: `Skill "${name}" not found. Available skills: ${registry.getAuto().map((s) => s.name).join(", ") || "none"}`
+            };
+          }
+          const sourceTypeMap = {
+            inline: "client-inline",
+            url: "remote-url",
+            file: "server-dir"
+          };
+          return {
+            name: skill.name,
+            description: skill.description,
+            strategy: skill.strategy ?? "auto",
+            content: skill.content,
+            source: sourceTypeMap[skill.source.type]
+          };
+        }
+      }
+    }
+  };
+}
+async function loadFromDir(dir) {
+  const { readdir, readFile } = await import('fs/promises');
+  const path = await import('path');
+  let entries;
+  try {
+    entries = await readdir(dir);
+  } catch {
+    return [];
+  }
+  const skills = [];
+  for (const entry of entries) {
+    const entryPath = path.join(dir, entry);
+    if (entry.endsWith(".md")) {
+      const skill = await loadSkillFromFile(entryPath, readFile, path);
+      if (skill) skills.push(skill);
+    } else {
+      const skillMdPath = path.join(entryPath, "SKILL.md");
+      try {
+        const skill = await loadSkillFromFile(skillMdPath, readFile, path);
+        if (skill) skills.push(skill);
+      } catch {
+      }
+    }
+  }
+  return skills;
+}
+async function loadSkillFromFile(filePath, readFile, path) {
+  let raw;
+  try {
+    raw = await readFile(filePath, "utf-8");
+  } catch {
+    return null;
+  }
+  const { frontmatter, content } = parseSkillFile(raw);
+  const fileName = path.basename(filePath, ".md");
+  const name = frontmatter.name ?? (fileName === "SKILL" ? void 0 : fileName);
+  if (!name) {
+    console.warn(
+      `[copilot-sdk/skills] Skipping skill at ${filePath}: no name in frontmatter and could not derive from filename`
+    );
+    return null;
+  }
+  const strategy = frontmatter.strategy && isValidStrategy(frontmatter.strategy) ? frontmatter.strategy : "auto";
+  return {
+    name,
+    description: frontmatter.description ?? `Skill: ${name}`,
+    content,
+    strategy,
+    version: frontmatter.version,
+    source: { type: "file", path: filePath }
+  };
+}
+async function loadFromUrls(urls) {
+  const skills = [];
+  await Promise.allSettled(
+    urls.map(async (url) => {
+      try {
+        const res = await fetch(url);
+        if (!res.ok) {
+          console.warn(
+            `[copilot-sdk/skills] Failed to fetch skill from ${url}: HTTP ${res.status}`
+          );
+          return;
+        }
+        const raw = await res.text();
+        const { frontmatter, content } = parseSkillFile(raw);
+        if (!frontmatter.name) {
+          console.warn(
+            `[copilot-sdk/skills] Skipping remote skill at ${url}: no name in frontmatter`
+          );
+          return;
+        }
+        const strategy = frontmatter.strategy && isValidStrategy(frontmatter.strategy) ? frontmatter.strategy : "auto";
+        skills.push({
+          name: frontmatter.name,
+          description: frontmatter.description ?? `Skill: ${frontmatter.name}`,
+          content,
+          strategy,
+          version: frontmatter.version,
+          source: { type: "url", url }
+        });
+      } catch (err) {
+        console.warn(
+          `[copilot-sdk/skills] Error loading remote skill from ${url}:`,
+          err
+        );
+      }
+    })
+  );
+  return skills;
+}
+
+Object.defineProperty(exports, "SkillRegistry", {
+  enumerable: true,
+  get: function () { return chunkBJYA5NDL_cjs.SkillRegistry; }
+});
+exports.compactSession = compactSession;
+exports.loadSkills = loadSkills;
+exports.parseSkillFile = parseSkillFile;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/server/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/server/compact-session.ts","../../src/skill-system/frontmatter.ts","../../src/skill-system/load-skills.ts"],"names":["SkillRegistry"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * compactSession — server-side summarization helper\n *\n * Call this in your /api/compact route handler.\n * Uses a structured prompt that preserves all semantically important content.\n *\n * @example\n * ```ts\n * // app/api/compact/route.ts\n * import { compactSession } from '@yourgpt/copilot-sdk/server';\n *\n * export async function POST(req: Request) {\n *   const { messages, existingSummary, workingMemory } = await req.json();\n *   const summary = await compactSession({ messages, existingSummary, workingMemory });\n *   return Response.json({ summary });\n * }\n * ```\n */\n\nexport interface CompactSessionOptions {\n  messages: Array<{ role: string; content?: string | null }>;\n  existingSummary?: string | null;\n  workingMemory?: string[];\n  /**\n   * Model to use for summarization.\n   * @default 'claude-haiku-4-5' (cheaper model fine for summaries)\n   */\n  model?: string;\n  /** Max tokens for the summary output. @default 1024 */\n  maxSummaryTokens?: number;\n  /** Custom fetch implementation (for non-browser environments). */\n  fetchImpl?: typeof fetch;\n  /** Anthropic API key. Falls back to process.env.ANTHROPIC_API_KEY. */\n  apiKey?: string;\n  /** Base URL for Anthropic API. @default 'https://api.anthropic.com' */\n  apiBaseUrl?: string;\n}\n\nexport interface CompactSessionResult {\n  summary: string;\n}\n\nconst COMPACTION_PROMPT = `You are summarizing a conversation to preserve its key context while reducing token usage. Create a structured summary that includes:\n\n1. **User's primary goals and requests** — what the user is trying to accomplish\n2. **Technical decisions made** — libraries chosen, schemas designed, approaches selected\n3. **Tool call outcomes** — what tools were called, key arguments, result status and brief outcome\n4. **Errors encountered** — what went wrong and how it was resolved\n5. **User messages** — verbatim if short (<50 words), paraphrased if long\n6. **Pending tasks** — unresolved questions or next steps mentioned\n7. **Current work state** — what was in progress when this summary was created\n\nRules:\n- Preserve ALL specific values: file names, variable names, URLs, error messages, IDs\n- Be detailed on recent work, more concise on earlier work\n- Output structured prose (not bullet JSON)\n- Do NOT include meta-commentary about the summarization itself`;\n\nexport async function compactSession(\n  options: CompactSessionOptions,\n): Promise<CompactSessionResult> {\n  const {\n    messages,\n    existingSummary,\n    workingMemory = [],\n    model = \"claude-haiku-4-5-20251001\",\n    maxSummaryTokens = 1024,\n    fetchImpl = fetch,\n    apiKey = typeof process !== \"undefined\"\n      ? process.env.ANTHROPIC_API_KEY\n      : undefined,\n    apiBaseUrl = \"https://api.anthropic.com\",\n  } = options;\n\n  if (!apiKey) {\n    throw new Error(\n      \"compactSession: No API key provided. Set ANTHROPIC_API_KEY or pass options.apiKey.\",\n    );\n  }\n\n  // Build the content to summarize\n  const parts: string[] = [];\n\n  if (workingMemory.length > 0) {\n    parts.push(\n      `[Working memory — always preserve these facts]\\n${workingMemory.join(\"\\n\")}`,\n    );\n  }\n\n  if (existingSummary) {\n    parts.push(`[Previous summary — extend/update this]\\n${existingSummary}`);\n  }\n\n  const conversationText = messages\n    .map((m) => `${m.role.toUpperCase()}: ${m.content ?? \"(no content)\"}`)\n    .join(\"\\n\\n\");\n\n  parts.push(`[Conversation to summarize]\\n${conversationText}`);\n\n  const userContent = parts.join(\"\\n\\n---\\n\\n\");\n\n  const response = await fetchImpl(`${apiBaseUrl}/v1/messages`, {\n    method: \"POST\",\n    headers: {\n      \"Content-Type\": \"application/json\",\n      \"x-api-key\": apiKey,\n      \"anthropic-version\": \"2023-06-01\",\n    },\n    body: JSON.stringify({\n      model,\n      max_tokens: maxSummaryTokens,\n      system: COMPACTION_PROMPT,\n      messages: [{ role: \"user\", content: userContent }],\n    }),\n  });\n\n  if (!response.ok) {\n    const err = await response.text();\n    throw new Error(\n      `compactSession: Anthropic API error ${response.status}: ${err}`,\n    );\n  }\n\n  const data = (await response.json()) as {\n    content: Array<{ type: string; text: string }>;\n  };\n\n  const summary = data.content\n    .filter((b) => b.type === \"text\")\n    .map((b) => b.text)\n    .join(\"\");\n\n  return { summary };\n}\n","/**\n * Frontmatter parser for skill .md files\n *\n * Parses YAML-like frontmatter blocks delimited by ---\n * Supports single-line scalars only (no external YAML dependency).\n *\n * Example skill file:\n * ---\n * name: code-review\n * description: Performs thorough code reviews\n * strategy: auto\n * version: 1.0.0\n * ---\n *\n * ## Instructions\n * When reviewing code...\n */\n\nexport interface ParsedFrontmatter {\n  name?: string;\n  description?: string;\n  strategy?: string;\n  version?: string;\n}\n\nexport interface ParsedSkillFile {\n  frontmatter: ParsedFrontmatter;\n  content: string;\n}\n\n/**\n * Parse a skill markdown file.\n * Extracts frontmatter fields and returns the body content (without --- block).\n */\nexport function parseSkillFile(raw: string): ParsedSkillFile {\n  const frontmatterRegex = /^---\\r?\\n([\\s\\S]*?)\\r?\\n---/;\n  const match = frontmatterRegex.exec(raw);\n\n  if (!match) {\n    return { frontmatter: {}, content: raw.trim() };\n  }\n\n  const frontmatterBlock = match[1];\n  const frontmatter = parseFrontmatterBlock(frontmatterBlock);\n\n  // Content is everything after the closing ---\n  const afterFrontmatter = raw.slice(match.index + match[0].length);\n  const content = afterFrontmatter.replace(/^\\r?\\n/, \"\").trim();\n\n  return { frontmatter, content };\n}\n\n/**\n * Parse individual frontmatter key: value pairs (single-line scalars only).\n */\nfunction parseFrontmatterBlock(block: string): ParsedFrontmatter {\n  const result: ParsedFrontmatter = {};\n  const lines = block.split(/\\r?\\n/);\n\n  for (const line of lines) {\n    const colonIndex = line.indexOf(\":\");\n    if (colonIndex === -1) continue;\n\n    const key = line.slice(0, colonIndex).trim();\n    const value = line.slice(colonIndex + 1).trim();\n\n    if (!key || !value) continue;\n\n    // Only accept known keys, ignore others\n    switch (key) {\n      case \"name\":\n        result.name = stripQuotes(value);\n        break;\n      case \"description\":\n        result.description = stripQuotes(value);\n        break;\n      case \"strategy\":\n        result.strategy = stripQuotes(value);\n        break;\n      case \"version\":\n        result.version = stripQuotes(value);\n        break;\n    }\n  }\n\n  return result;\n}\n\n/** Strip optional surrounding quotes from a YAML scalar value */\nfunction stripQuotes(value: string): string {\n  if (\n    (value.startsWith('\"') && value.endsWith('\"')) ||\n    (value.startsWith(\"'\") && value.endsWith(\"'\"))\n  ) {\n    return value.slice(1, -1);\n  }\n  return value;\n}\n","/**\n * loadSkills() — Server-side skill loader\n *\n * Loads skills from three sources with precedence:\n *   server-dir > remote-url > client-inline\n *\n * Returns skills, diagnostics, buildSystemPrompt(), and the load_skill tool.\n *\n * Node.js only — uses fs and fetch.\n */\n\nimport type {\n  LoadSkillsOptions,\n  LoadSkillsResult,\n  ResolvedSkill,\n  SkillDiagnostic,\n  SkillDiagnosticWinner,\n  SkillStrategy,\n} from \"./types\";\nimport { parseSkillFile } from \"./frontmatter\";\nimport { SkillRegistry } from \"./registry\";\n\nconst VALID_STRATEGIES = new Set<SkillStrategy>([\"eager\", \"auto\", \"manual\"]);\n\nfunction isValidStrategy(s: string): s is SkillStrategy {\n  return VALID_STRATEGIES.has(s as SkillStrategy);\n}\n\n/**\n * Load skills from server directory, remote URLs, and/or inline client skills.\n *\n * @example\n * ```typescript\n * import { loadSkills } from '@yourgpt/copilot-sdk/server';\n *\n * const { skills, buildSystemPrompt, tools } = await loadSkills({\n *   dir: path.join(process.cwd(), 'skills'),\n * });\n *\n * // Use in your API route\n * const systemPrompt = buildSystemPrompt('You are a helpful assistant.');\n * ```\n */\nexport async function loadSkills(\n  options: LoadSkillsOptions = {},\n): Promise<LoadSkillsResult> {\n  const registry = new SkillRegistry();\n  const diagnostics: SkillDiagnostic[] = [];\n\n  // Track which names came from which source (for collision detection)\n  const sourceMap = new Map<string, SkillDiagnosticWinner>();\n\n  // ──────────────────────────────────────────────────\n  // Source 1: Server directory (highest precedence)\n  // ──────────────────────────────────────────────────\n  if (options.dir) {\n    const dirSkills = await loadFromDir(options.dir);\n    for (const skill of dirSkills) {\n      registry.register(skill);\n      sourceMap.set(skill.name, \"server-dir\");\n    }\n  }\n\n  // ──────────────────────────────────────────────────\n  // Source 2: Remote URLs (medium precedence)\n  // ──────────────────────────────────────────────────\n  if (options.remoteUrls?.length) {\n    const urlSkills = await loadFromUrls(options.remoteUrls);\n    for (const skill of urlSkills) {\n      const existingSource = sourceMap.get(skill.name);\n      if (existingSource) {\n        diagnostics.push({\n          type: \"collision\",\n          name: skill.name,\n          winner: existingSource,\n          loser: \"remote-url\",\n        });\n        continue; // Skip — lower precedence source loses\n      }\n      registry.register(skill);\n      sourceMap.set(skill.name, \"remote-url\");\n    }\n  }\n\n  // ──────────────────────────────────────────────────\n  // Source 3: Client inline (lowest precedence)\n  // ──────────────────────────────────────────────────\n  if (options.clientSkills?.length) {\n    for (const inline of options.clientSkills) {\n      const existingSource = sourceMap.get(inline.name);\n      if (existingSource) {\n        diagnostics.push({\n          type: \"collision\",\n          name: inline.name,\n          winner: existingSource,\n          loser: \"client-inline\",\n        });\n        continue;\n      }\n\n      const skill: ResolvedSkill = {\n        name: inline.name,\n        description: inline.description,\n        content: inline.content,\n        strategy: inline.strategy ?? \"auto\",\n        source: { type: \"inline\", content: inline.content },\n      };\n      registry.register(skill);\n      sourceMap.set(inline.name, \"client-inline\");\n    }\n  }\n\n  // ──────────────────────────────────────────────────\n  // Build result\n  // ──────────────────────────────────────────────────\n  return {\n    skills: registry.getAll(),\n    diagnostics,\n\n    buildSystemPrompt(basePrompt?: string): string {\n      const parts: string[] = [];\n\n      if (basePrompt) {\n        parts.push(basePrompt);\n      }\n\n      // Prepend eager skill content (always active)\n      const eagerContent = registry.buildEagerContent();\n      if (eagerContent) {\n        parts.push(eagerContent);\n      }\n\n      // Append auto catalog (discoverable via load_skill)\n      const catalog = registry.buildCatalog();\n      if (catalog) {\n        parts.push(\n          `You have access to specialized skills. Call load_skill({ name }) when relevant.\\n\\n${catalog}`,\n        );\n      }\n\n      return parts.join(\"\\n\\n\").trim();\n    },\n\n    tools: {\n      load_skill: {\n        description:\n          \"Load a skill by name to get full instructions for a specialized task.\",\n        parameters: {\n          type: \"object\",\n          properties: {\n            name: {\n              type: \"string\",\n              description: \"The name of the skill to load.\",\n            },\n          },\n          required: [\"name\"],\n        },\n        execute: async ({ name }: { name: string }) => {\n          const skill = registry.get(name);\n          if (!skill) {\n            return {\n              error: `Skill \"${name}\" not found. Available skills: ${\n                registry\n                  .getAuto()\n                  .map((s) => s.name)\n                  .join(\", \") || \"none\"\n              }`,\n            };\n          }\n          const sourceTypeMap = {\n            inline: \"client-inline\",\n            url: \"remote-url\",\n            file: \"server-dir\",\n          } as const;\n          return {\n            name: skill.name,\n            description: skill.description,\n            strategy: skill.strategy ?? \"auto\",\n            content: skill.content,\n            source: sourceTypeMap[skill.source.type],\n          };\n        },\n      },\n    },\n  };\n}\n\n// ──────────────────────────────────────────────────\n// Internal helpers\n// ──────────────────────────────────────────────────\n\nasync function loadFromDir(dir: string): Promise<ResolvedSkill[]> {\n  // Dynamic import to avoid bundling fs in browser builds\n  const { readdir, readFile } = await import(\"fs/promises\");\n  const path = await import(\"path\");\n\n  let entries: string[];\n  try {\n    entries = await readdir(dir);\n  } catch {\n    // Directory doesn't exist or unreadable — not an error\n    return [];\n  }\n\n  const skills: ResolvedSkill[] = [];\n\n  for (const entry of entries) {\n    const entryPath = path.join(dir, entry);\n\n    if (entry.endsWith(\".md\")) {\n      // Flat .md file\n      const skill = await loadSkillFromFile(entryPath, readFile, path);\n      if (skill) skills.push(skill);\n    } else {\n      // Check for folder-based skill: entry/SKILL.md\n      const skillMdPath = path.join(entryPath, \"SKILL.md\");\n      try {\n        const skill = await loadSkillFromFile(skillMdPath, readFile, path);\n        if (skill) skills.push(skill);\n      } catch {\n        // Not a skill folder — skip\n      }\n    }\n  }\n\n  return skills;\n}\n\nasync function loadSkillFromFile(\n  filePath: string,\n  readFile: (path: string, encoding: \"utf-8\") => Promise<string>,\n  path: { basename: (p: string, ext?: string) => string },\n): Promise<ResolvedSkill | null> {\n  let raw: string;\n  try {\n    raw = await readFile(filePath, \"utf-8\");\n  } catch {\n    return null;\n  }\n\n  const { frontmatter, content } = parseSkillFile(raw);\n\n  // Derive name from frontmatter or filename\n  const fileName = path.basename(filePath, \".md\");\n  const name =\n    frontmatter.name ?? (fileName === \"SKILL\" ? undefined : fileName);\n\n  if (!name) {\n    console.warn(\n      `[copilot-sdk/skills] Skipping skill at ${filePath}: no name in frontmatter and could not derive from filename`,\n    );\n    return null;\n  }\n\n  const strategy =\n    frontmatter.strategy && isValidStrategy(frontmatter.strategy)\n      ? frontmatter.strategy\n      : \"auto\";\n\n  return {\n    name,\n    description: frontmatter.description ?? `Skill: ${name}`,\n    content,\n    strategy,\n    version: frontmatter.version,\n    source: { type: \"file\", path: filePath },\n  };\n}\n\nasync function loadFromUrls(urls: string[]): Promise<ResolvedSkill[]> {\n  const skills: ResolvedSkill[] = [];\n\n  await Promise.allSettled(\n    urls.map(async (url) => {\n      try {\n        const res = await fetch(url);\n        if (!res.ok) {\n          console.warn(\n            `[copilot-sdk/skills] Failed to fetch skill from ${url}: HTTP ${res.status}`,\n          );\n          return;\n        }\n        const raw = await res.text();\n        const { frontmatter, content } = parseSkillFile(raw);\n\n        if (!frontmatter.name) {\n          console.warn(\n            `[copilot-sdk/skills] Skipping remote skill at ${url}: no name in frontmatter`,\n          );\n          return;\n        }\n\n        const strategy =\n          frontmatter.strategy && isValidStrategy(frontmatter.strategy)\n            ? frontmatter.strategy\n            : \"auto\";\n\n        skills.push({\n          name: frontmatter.name,\n          description: frontmatter.description ?? `Skill: ${frontmatter.name}`,\n          content,\n          strategy,\n          version: frontmatter.version,\n          source: { type: \"url\", url },\n        });\n      } catch (err) {\n        console.warn(\n          `[copilot-sdk/skills] Error loading remote skill from ${url}:`,\n          err,\n        );\n      }\n    }),\n  );\n\n  return skills;\n}\n"]}

package/dist/server/index.d.cts

@@ -0,0 +1,171 @@
+import { L as LoadSkillsOptions, a as LoadSkillsResult, R as ResolvedSkill } from '../types-BckL3hiw.cjs';
+export { C as ClientInlineSkill, g as LoadSkillError, f as LoadSkillResult, S as SkillDefinition, d as SkillDiagnostic, e as SkillDiagnosticWinner, b as SkillSource, c as SkillStrategy } from '../types-BckL3hiw.cjs';
+
+/**
+ * compactSession — server-side summarization helper
+ *
+ * Call this in your /api/compact route handler.
+ * Uses a structured prompt that preserves all semantically important content.
+ *
+ * @example
+ * ```ts
+ * // app/api/compact/route.ts
+ * import { compactSession } from '@yourgpt/copilot-sdk/server';
+ *
+ * export async function POST(req: Request) {
+ *   const { messages, existingSummary, workingMemory } = await req.json();
+ *   const summary = await compactSession({ messages, existingSummary, workingMemory });
+ *   return Response.json({ summary });
+ * }
+ * ```
+ */
+interface CompactSessionOptions {
+    messages: Array<{
+        role: string;
+        content?: string | null;
+    }>;
+    existingSummary?: string | null;
+    workingMemory?: string[];
+    /**
+     * Model to use for summarization.
+     * @default 'claude-haiku-4-5' (cheaper model fine for summaries)
+     */
+    model?: string;
+    /** Max tokens for the summary output. @default 1024 */
+    maxSummaryTokens?: number;
+    /** Custom fetch implementation (for non-browser environments). */
+    fetchImpl?: typeof fetch;
+    /** Anthropic API key. Falls back to process.env.ANTHROPIC_API_KEY. */
+    apiKey?: string;
+    /** Base URL for Anthropic API. @default 'https://api.anthropic.com' */
+    apiBaseUrl?: string;
+}
+interface CompactSessionResult {
+    summary: string;
+}
+declare function compactSession(options: CompactSessionOptions): Promise<CompactSessionResult>;
+
+/**
+ * loadSkills() — Server-side skill loader
+ *
+ * Loads skills from three sources with precedence:
+ *   server-dir > remote-url > client-inline
+ *
+ * Returns skills, diagnostics, buildSystemPrompt(), and the load_skill tool.
+ *
+ * Node.js only — uses fs and fetch.
+ */
+
+/**
+ * Load skills from server directory, remote URLs, and/or inline client skills.
+ *
+ * @example
+ * ```typescript
+ * import { loadSkills } from '@yourgpt/copilot-sdk/server';
+ *
+ * const { skills, buildSystemPrompt, tools } = await loadSkills({
+ *   dir: path.join(process.cwd(), 'skills'),
+ * });
+ *
+ * // Use in your API route
+ * const systemPrompt = buildSystemPrompt('You are a helpful assistant.');
+ * ```
+ */
+declare function loadSkills(options?: LoadSkillsOptions): Promise<LoadSkillsResult>;
+
+/**
+ * SkillRegistry — manages registered skills
+ *
+ * Shared between server (loadSkills) and client (SkillProvider).
+ * Framework-agnostic — no React dependencies.
+ */
+
+declare class SkillRegistry {
+    private skills;
+    /**
+     * Register a skill. Silently overwrites if name already exists.
+     * Use collision detection in loadSkills() instead.
+     */
+    register(skill: ResolvedSkill): void;
+    /**
+     * Unregister a skill by name.
+     */
+    unregister(name: string): void;
+    /**
+     * Get a skill by name.
+     */
+    get(name: string): ResolvedSkill | undefined;
+    /**
+     * Get all registered skills.
+     */
+    getAll(): ResolvedSkill[];
+    /**
+     * Get all skills with strategy === "eager".
+     * These are injected directly into the system prompt.
+     */
+    getEager(): ResolvedSkill[];
+    /**
+     * Get all skills with strategy === "auto".
+     * These appear in the catalog and are loadable on demand.
+     */
+    getAuto(): ResolvedSkill[];
+    /**
+     * Check if a skill is registered.
+     */
+    has(name: string): boolean;
+    /**
+     * Number of registered skills.
+     */
+    get count(): number;
+    /**
+     * Build a skill catalog string for "auto" skills.
+     * Appended to the system prompt so the AI can discover available skills.
+     */
+    buildCatalog(): string;
+    /**
+     * Concatenate content of all "eager" skills.
+     * These instructions are always active without requiring load_skill.
+     */
+    buildEagerContent(): string;
+    /**
+     * Resolve content for a skill by name.
+     * For inline/file/url skills, content is already resolved at registration time.
+     */
+    resolveContent(name: string): Promise<string | undefined>;
+    private resolveStrategy;
+}
+
+/**
+ * Frontmatter parser for skill .md files
+ *
+ * Parses YAML-like frontmatter blocks delimited by ---
+ * Supports single-line scalars only (no external YAML dependency).
+ *
+ * Example skill file:
+ * ---
+ * name: code-review
+ * description: Performs thorough code reviews
+ * strategy: auto
+ * version: 1.0.0
+ * ---
+ *
+ * ## Instructions
+ * When reviewing code...
+ */
+interface ParsedFrontmatter {
+    name?: string;
+    description?: string;
+    strategy?: string;
+    version?: string;
+}
+interface ParsedSkillFile {
+    frontmatter: ParsedFrontmatter;
+    content: string;
+}
+/**
+ * Parse a skill markdown file.
+ * Extracts frontmatter fields and returns the body content (without --- block).
+ */
+declare function parseSkillFile(raw: string): ParsedSkillFile;
+
+export { type CompactSessionOptions, type CompactSessionResult, LoadSkillsOptions, LoadSkillsResult, ResolvedSkill, SkillRegistry, compactSession, loadSkills, parseSkillFile };