@tanstack/ai-code-mode-skills 0.1.0

package/dist/esm/create-skills-system-prompt.d.ts

@@ -0,0 +1,22 @@
+import { Skill } from './types.js';
+interface CreateSkillsSystemPromptOptions {
+    /**
+     * Skills that were selected for this request
+     */
+    selectedSkills: Array<Skill>;
+    /**
+     * Total number of skills in the library
+     */
+    totalSkillCount: number;
+    /**
+     * Whether skills are exposed as direct tools (not just sandbox bindings)
+     * @default true
+     */
+    skillsAsTools?: boolean;
+}
+/**
+ * Create system prompt documentation for the skill library.
+ * This is appended to the Code Mode system prompt.
+ */
+export declare function createSkillsSystemPrompt({ selectedSkills, totalSkillCount, skillsAsTools, }: CreateSkillsSystemPromptOptions): string;
+export {};

package/dist/esm/create-skills-system-prompt.js

@@ -0,0 +1,236 @@
+import { generateSkillTypes } from "./generate-skill-types.js";
+function generateExampleFromSchema(schema) {
+  if (schema.type === "object" && schema.properties) {
+    const props = schema.properties;
+    const example = {};
+    for (const [key, value] of Object.entries(props)) {
+      if (value.type === "string") example[key] = `'example_${key}'`;
+      else if (value.type === "number") example[key] = 0;
+      else if (value.type === "boolean") example[key] = true;
+      else if (value.type === "array") example[key] = [];
+      else example[key] = null;
+    }
+    return JSON.stringify(example).replace(/"/g, "");
+  }
+  return "{}";
+}
+function createSkillsSystemPrompt({
+  selectedSkills,
+  totalSkillCount,
+  skillsAsTools = true
+}) {
+  if (totalSkillCount === 0) {
+    return `## Skill Library
+
+You have access to a skill library for storing reusable code. The library is currently empty.
+
+### Skill Management Tools
+
+- \`search_skills(query, limit?)\` - Search for skills (currently empty)
+- \`get_skill(name)\` - Get full skill details including code
+- \`register_skill(...)\` - Save working code as a reusable skill
+
+When you write useful, reusable code, consider registering it as a skill for future use.
+
+**Important**: Newly registered skills become available as tools on the **next message**, not immediately in the current conversation turn.
+`;
+  }
+  if (selectedSkills.length === 0) {
+    return `## Skill Library
+
+You have access to a persistent skill library with ${totalSkillCount} skill${totalSkillCount === 1 ? "" : "s"}. No skills were pre-loaded for this conversation based on context.
+
+### Skill Management Tools
+
+- \`search_skills(query, limit?)\` - Search for relevant skills
+- \`get_skill(name)\` - Get full skill details including code
+- \`register_skill(...)\` - Save working code as a reusable skill
+
+When you write useful, reusable code, consider registering it as a skill for future use.
+
+**Important**: Newly registered skills become available as tools on the **next message**, not immediately in the current conversation turn.
+`;
+  }
+  if (skillsAsTools) {
+    const skillToolDocs = selectedSkills.map((skill) => {
+      const inputExample = generateExampleFromSchema(skill.inputSchema);
+      const trustBadge = skill.trustLevel === "trusted" ? "✓ trusted" : skill.trustLevel === "provisional" ? "◐ provisional" : "○ untrusted";
+      return `
+### ${skill.name} [${trustBadge}]
+
+${skill.description}
+
+${skill.usageHints.map((h) => `- ${h}`).join("\n")}
+
+**Input Schema:**
+\`\`\`json
+${JSON.stringify(skill.inputSchema, null, 2)}
+\`\`\`
+
+**Output Schema:**
+\`\`\`json
+${JSON.stringify(skill.outputSchema, null, 2)}
+\`\`\`
+
+**Example:**
+Call the \`${skill.name}\` tool with: ${inputExample}
+`;
+    }).join("\n---\n");
+    return `## Skill Library
+
+${selectedSkills.length} skill${selectedSkills.length === 1 ? "" : "s"} pre-loaded for this conversation (${totalSkillCount} total in library).
+
+### Available Skill Tools
+
+These skills are available as **direct tools** you can call (marked with [SKILL] in description):
+
+${skillToolDocs}
+
+### Skill Management Tools
+
+- \`search_skills(query, limit?)\` - Find additional skills not pre-loaded
+- \`get_skill(name)\` - Get full details of any skill
+- \`register_skill(...)\` - Save working code as a new skill
+
+### Using Skills
+
+Skills are **regular tools** - call them directly like any other tool. No need to use \`execute_typescript\`.
+
+### Creating New Skills
+
+When you write useful, reusable code with \`execute_typescript\`, register it:
+
+\`\`\`typescript
+// After verifying code works, call the register_skill tool
+register_skill({
+  name: 'compare_npm_packages',
+  description: 'Compare download counts for multiple NPM packages',
+  code: \`
+    const { packages } = input;
+    const results = await Promise.all(
+      packages.map(pkg => external_getNpmDownloads({ package: pkg }))
+    );
+    return packages.map((pkg, i) => ({ package: pkg, downloads: results[i].downloads }))
+      .sort((a, b) => b.downloads - a.downloads);
+  \`,
+  inputSchema: { 
+    type: 'object', 
+    properties: { packages: { type: 'array', items: { type: 'string' } } },
+    required: ['packages']
+  },
+  outputSchema: {
+    type: 'array',
+    items: { type: 'object', properties: { package: { type: 'string' }, downloads: { type: 'number' } } }
+  },
+  usageHints: ['Use when comparing popularity of NPM packages'],
+  dependsOn: [],
+});
+\`\`\`
+
+**Important**: Newly registered skills become available as tools on the **next message**, not immediately in the current conversation turn.
+`;
+  }
+  const skillDocs = selectedSkills.map((skill) => {
+    const inputExample = generateExampleFromSchema(skill.inputSchema);
+    const trustBadge = skill.trustLevel === "trusted" ? "✓ trusted" : skill.trustLevel === "provisional" ? "◐ provisional" : "○ untrusted";
+    return `
+### skill_${skill.name} [${trustBadge}]
+
+${skill.description}
+
+${skill.usageHints.map((h) => `- ${h}`).join("\n")}
+
+**Input Schema:**
+\`\`\`json
+${JSON.stringify(skill.inputSchema, null, 2)}
+\`\`\`
+
+**Output Schema:**
+\`\`\`json
+${JSON.stringify(skill.outputSchema, null, 2)}
+\`\`\`
+
+**Example:**
+\`\`\`typescript
+const result = await skill_${skill.name}(${inputExample});
+\`\`\`
+`;
+  }).join("\n---\n");
+  const typeStubs = generateSkillTypes(selectedSkills);
+  return `## Skill Library
+
+${selectedSkills.length} skill${selectedSkills.length === 1 ? "" : "s"} pre-loaded for this conversation (${totalSkillCount} total in library).
+
+### Pre-loaded Skills
+
+These are available as \`skill_*\` functions in your TypeScript code:
+
+${skillDocs}
+
+### Type Definitions
+
+\`\`\`typescript
+${typeStubs}
+\`\`\`
+
+### Skill Management Tools
+
+- \`search_skills(query, limit?)\` - Find additional skills not pre-loaded
+- \`get_skill(name)\` - Get full details of any skill
+- \`register_skill(...)\` - Save working code as a new skill
+
+### Using Skills
+
+Skills work just like \`external_*\` functions inside \`execute_typescript\`:
+
+\`\`\`typescript
+// Call a pre-loaded skill
+const stats = await skill_fetch_github_stats({ owner: 'tanstack', repo: 'query' });
+
+// Compose skills with external tools
+const repos = await external_searchRepositories({ query: 'react state' });
+const detailed = await Promise.all(
+  repos.items.slice(0, 5).map(r => 
+    skill_fetch_github_stats({ owner: r.owner.login, repo: r.name })
+  )
+);
+\`\`\`
+
+### Creating New Skills
+
+When you write useful, reusable code, register it:
+
+\`\`\`typescript
+// After verifying code works, call the register_skill tool
+register_skill({
+  name: 'compare_npm_packages',
+  description: 'Compare download counts for multiple NPM packages',
+  code: \`
+    const { packages } = input;
+    const results = await Promise.all(
+      packages.map(pkg => external_getNpmDownloads({ package: pkg }))
+    );
+    return packages.map((pkg, i) => ({ package: pkg, downloads: results[i].downloads }))
+      .sort((a, b) => b.downloads - a.downloads);
+  \`,
+  inputSchema: { 
+    type: 'object', 
+    properties: { packages: { type: 'array', items: { type: 'string' } } },
+    required: ['packages']
+  },
+  outputSchema: {
+    type: 'array',
+    items: { type: 'object', properties: { package: { type: 'string' }, downloads: { type: 'number' } } }
+  },
+  usageHints: ['Use when comparing popularity of NPM packages'],
+  dependsOn: [],
+});
+\`\`\`
+
+**Important**: Newly registered skills become available as tools on the **next message**, not immediately in the current conversation turn.
+`;
+}
+export {
+  createSkillsSystemPrompt
+};
+//# sourceMappingURL=create-skills-system-prompt.js.map

package/dist/esm/create-skills-system-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-skills-system-prompt.js","sources":["../../src/create-skills-system-prompt.ts"],"sourcesContent":["import { generateSkillTypes } from './generate-skill-types'\nimport type { Skill } from './types'\n\ninterface CreateSkillsSystemPromptOptions {\n  /**\n   * Skills that were selected for this request\n   */\n  selectedSkills: Array<Skill>\n\n  /**\n   * Total number of skills in the library\n   */\n  totalSkillCount: number\n\n  /**\n   * Whether skills are exposed as direct tools (not just sandbox bindings)\n   * @default true\n   */\n  skillsAsTools?: boolean\n}\n\n/**\n * Generate example input from a JSON Schema\n */\nfunction generateExampleFromSchema(schema: Record<string, unknown>): string {\n  if (schema.type === 'object' && schema.properties) {\n    const props = schema.properties as Record<string, { type: string }>\n    const example: Record<string, unknown> = {}\n\n    for (const [key, value] of Object.entries(props)) {\n      if (value.type === 'string') example[key] = `'example_${key}'`\n      else if (value.type === 'number') example[key] = 0\n      else if (value.type === 'boolean') example[key] = true\n      else if (value.type === 'array') example[key] = []\n      else example[key] = null\n    }\n\n    return JSON.stringify(example).replace(/\"/g, '')\n  }\n  return '{}'\n}\n\n/**\n * Create system prompt documentation for the skill library.\n * This is appended to the Code Mode system prompt.\n */\nexport function createSkillsSystemPrompt({\n  selectedSkills,\n  totalSkillCount,\n  skillsAsTools = true,\n}: CreateSkillsSystemPromptOptions): string {\n  // No skills in library\n  if (totalSkillCount === 0) {\n    return `## Skill Library\n\nYou have access to a skill library for storing reusable code. The library is currently empty.\n\n### Skill Management Tools\n\n- \\`search_skills(query, limit?)\\` - Search for skills (currently empty)\n- \\`get_skill(name)\\` - Get full skill details including code\n- \\`register_skill(...)\\` - Save working code as a reusable skill\n\nWhen you write useful, reusable code, consider registering it as a skill for future use.\n\n**Important**: Newly registered skills become available as tools on the **next message**, not immediately in the current conversation turn.\n`\n  }\n\n  // No skills selected for this conversation\n  if (selectedSkills.length === 0) {\n    return `## Skill Library\n\nYou have access to a persistent skill library with ${totalSkillCount} skill${totalSkillCount === 1 ? '' : 's'}. No skills were pre-loaded for this conversation based on context.\n\n### Skill Management Tools\n\n- \\`search_skills(query, limit?)\\` - Search for relevant skills\n- \\`get_skill(name)\\` - Get full skill details including code\n- \\`register_skill(...)\\` - Save working code as a reusable skill\n\nWhen you write useful, reusable code, consider registering it as a skill for future use.\n\n**Important**: Newly registered skills become available as tools on the **next message**, not immediately in the current conversation turn.\n`\n  }\n\n  if (skillsAsTools) {\n    // Skills are available as direct tools\n    const skillToolDocs = selectedSkills\n      .map((skill) => {\n        const inputExample = generateExampleFromSchema(skill.inputSchema)\n        const trustBadge =\n          skill.trustLevel === 'trusted'\n            ? '✓ trusted'\n            : skill.trustLevel === 'provisional'\n              ? '◐ provisional'\n              : '○ untrusted'\n\n        return `\n### ${skill.name} [${trustBadge}]\n\n${skill.description}\n\n${skill.usageHints.map((h) => `- ${h}`).join('\\n')}\n\n**Input Schema:**\n\\`\\`\\`json\n${JSON.stringify(skill.inputSchema, null, 2)}\n\\`\\`\\`\n\n**Output Schema:**\n\\`\\`\\`json\n${JSON.stringify(skill.outputSchema, null, 2)}\n\\`\\`\\`\n\n**Example:**\nCall the \\`${skill.name}\\` tool with: ${inputExample}\n`\n      })\n      .join('\\n---\\n')\n\n    return `## Skill Library\n\n${selectedSkills.length} skill${selectedSkills.length === 1 ? '' : 's'} pre-loaded for this conversation (${totalSkillCount} total in library).\n\n### Available Skill Tools\n\nThese skills are available as **direct tools** you can call (marked with [SKILL] in description):\n\n${skillToolDocs}\n\n### Skill Management Tools\n\n- \\`search_skills(query, limit?)\\` - Find additional skills not pre-loaded\n- \\`get_skill(name)\\` - Get full details of any skill\n- \\`register_skill(...)\\` - Save working code as a new skill\n\n### Using Skills\n\nSkills are **regular tools** - call them directly like any other tool. No need to use \\`execute_typescript\\`.\n\n### Creating New Skills\n\nWhen you write useful, reusable code with \\`execute_typescript\\`, register it:\n\n\\`\\`\\`typescript\n// After verifying code works, call the register_skill tool\nregister_skill({\n  name: 'compare_npm_packages',\n  description: 'Compare download counts for multiple NPM packages',\n  code: \\`\n    const { packages } = input;\n    const results = await Promise.all(\n      packages.map(pkg => external_getNpmDownloads({ package: pkg }))\n    );\n    return packages.map((pkg, i) => ({ package: pkg, downloads: results[i].downloads }))\n      .sort((a, b) => b.downloads - a.downloads);\n  \\`,\n  inputSchema: { \n    type: 'object', \n    properties: { packages: { type: 'array', items: { type: 'string' } } },\n    required: ['packages']\n  },\n  outputSchema: {\n    type: 'array',\n    items: { type: 'object', properties: { package: { type: 'string' }, downloads: { type: 'number' } } }\n  },\n  usageHints: ['Use when comparing popularity of NPM packages'],\n  dependsOn: [],\n});\n\\`\\`\\`\n\n**Important**: Newly registered skills become available as tools on the **next message**, not immediately in the current conversation turn.\n`\n  }\n\n  // Skills as sandbox bindings (legacy mode)\n  const skillDocs = selectedSkills\n    .map((skill) => {\n      const inputExample = generateExampleFromSchema(skill.inputSchema)\n      const trustBadge =\n        skill.trustLevel === 'trusted'\n          ? '✓ trusted'\n          : skill.trustLevel === 'provisional'\n            ? '◐ provisional'\n            : '○ untrusted'\n\n      return `\n### skill_${skill.name} [${trustBadge}]\n\n${skill.description}\n\n${skill.usageHints.map((h) => `- ${h}`).join('\\n')}\n\n**Input Schema:**\n\\`\\`\\`json\n${JSON.stringify(skill.inputSchema, null, 2)}\n\\`\\`\\`\n\n**Output Schema:**\n\\`\\`\\`json\n${JSON.stringify(skill.outputSchema, null, 2)}\n\\`\\`\\`\n\n**Example:**\n\\`\\`\\`typescript\nconst result = await skill_${skill.name}(${inputExample});\n\\`\\`\\`\n`\n    })\n    .join('\\n---\\n')\n\n  // Generate type stubs for selected skills\n  const typeStubs = generateSkillTypes(selectedSkills)\n\n  return `## Skill Library\n\n${selectedSkills.length} skill${selectedSkills.length === 1 ? '' : 's'} pre-loaded for this conversation (${totalSkillCount} total in library).\n\n### Pre-loaded Skills\n\nThese are available as \\`skill_*\\` functions in your TypeScript code:\n\n${skillDocs}\n\n### Type Definitions\n\n\\`\\`\\`typescript\n${typeStubs}\n\\`\\`\\`\n\n### Skill Management Tools\n\n- \\`search_skills(query, limit?)\\` - Find additional skills not pre-loaded\n- \\`get_skill(name)\\` - Get full details of any skill\n- \\`register_skill(...)\\` - Save working code as a new skill\n\n### Using Skills\n\nSkills work just like \\`external_*\\` functions inside \\`execute_typescript\\`:\n\n\\`\\`\\`typescript\n// Call a pre-loaded skill\nconst stats = await skill_fetch_github_stats({ owner: 'tanstack', repo: 'query' });\n\n// Compose skills with external tools\nconst repos = await external_searchRepositories({ query: 'react state' });\nconst detailed = await Promise.all(\n  repos.items.slice(0, 5).map(r => \n    skill_fetch_github_stats({ owner: r.owner.login, repo: r.name })\n  )\n);\n\\`\\`\\`\n\n### Creating New Skills\n\nWhen you write useful, reusable code, register it:\n\n\\`\\`\\`typescript\n// After verifying code works, call the register_skill tool\nregister_skill({\n  name: 'compare_npm_packages',\n  description: 'Compare download counts for multiple NPM packages',\n  code: \\`\n    const { packages } = input;\n    const results = await Promise.all(\n      packages.map(pkg => external_getNpmDownloads({ package: pkg }))\n    );\n    return packages.map((pkg, i) => ({ package: pkg, downloads: results[i].downloads }))\n      .sort((a, b) => b.downloads - a.downloads);\n  \\`,\n  inputSchema: { \n    type: 'object', \n    properties: { packages: { type: 'array', items: { type: 'string' } } },\n    required: ['packages']\n  },\n  outputSchema: {\n    type: 'array',\n    items: { type: 'object', properties: { package: { type: 'string' }, downloads: { type: 'number' } } }\n  },\n  usageHints: ['Use when comparing popularity of NPM packages'],\n  dependsOn: [],\n});\n\\`\\`\\`\n\n**Important**: Newly registered skills become available as tools on the **next message**, not immediately in the current conversation turn.\n`\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/generate-skill-types.d.ts

@@ -0,0 +1,7 @@
+import { Skill } from './types.js';
+/**
+ * Generate TypeScript type stubs for skills.
+ * These are included in the system prompt so the LLM knows
+ * the exact type signatures of available skills.
+ */
+export declare function generateSkillTypes(skills: Array<Skill>): string;

package/dist/esm/generate-skill-types.js

@@ -0,0 +1,87 @@
+function schemaToType(schema) {
+  if (typeof schema !== "object") {
+    return "unknown";
+  }
+  const schemaType = schema.type;
+  if (schemaType === "string") return "string";
+  if (schemaType === "number" || schemaType === "integer") return "number";
+  if (schemaType === "boolean") return "boolean";
+  if (schemaType === "null") return "null";
+  if (schemaType === "array") {
+    const items = schema.items;
+    const itemType = items ? schemaToType(items) : "unknown";
+    return `Array<${itemType}>`;
+  }
+  if (schemaType === "object" && schema.properties) {
+    const properties = schema.properties;
+    const required = new Set(
+      schema.required ?? []
+    );
+    const props = Object.entries(properties).map(([key, propSchema]) => {
+      const optional = required.has(key) ? "" : "?";
+      const propType = schemaToType(propSchema);
+      const safeName = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(key) ? key : `"${key}"`;
+      return `  ${safeName}${optional}: ${propType};`;
+    }).join("\n");
+    return `{
+${props}
+}`;
+  }
+  if (schema.enum) {
+    const enumValues = schema.enum;
+    return enumValues.map((v) => JSON.stringify(v)).join(" | ");
+  }
+  if (schema.anyOf || schema.oneOf) {
+    const variants = schema.anyOf || schema.oneOf;
+    return variants.map((v) => schemaToType(v)).join(" | ");
+  }
+  if (Array.isArray(schemaType)) {
+    return schemaType.map((t) => {
+      if (t === "string") return "string";
+      if (t === "number" || t === "integer") return "number";
+      if (t === "boolean") return "boolean";
+      if (t === "null") return "null";
+      if (t === "array") return "Array<unknown>";
+      if (t === "object") return "object";
+      return "unknown";
+    }).join(" | ");
+  }
+  return "unknown";
+}
+function capitalize(str) {
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}
+function toPascalCase(str) {
+  return str.split("_").map((part) => capitalize(part)).join("");
+}
+function generateSkillTypes(skills) {
+  const declarations = [];
+  for (const skill of skills) {
+    const baseName = toPascalCase(skill.name);
+    const inputTypeName = `Skill${baseName}Input`;
+    const outputTypeName = `Skill${baseName}Output`;
+    const inputType = schemaToType(skill.inputSchema);
+    if (skill.inputSchema.type === "object" && skill.inputSchema.properties && Object.keys(skill.inputSchema.properties).length > 0) {
+      declarations.push(`interface ${inputTypeName} ${inputType}`);
+    }
+    const outputType = schemaToType(skill.outputSchema);
+    if (skill.outputSchema.type === "object" && skill.outputSchema.properties && Object.keys(skill.outputSchema.properties).length > 0) {
+      declarations.push(`interface ${outputTypeName} ${outputType}`);
+    }
+    const inputRef = skill.inputSchema.type === "object" && skill.inputSchema.properties && Object.keys(skill.inputSchema.properties).length > 0 ? inputTypeName : inputType;
+    const outputRef = skill.outputSchema.type === "object" && skill.outputSchema.properties && Object.keys(skill.outputSchema.properties).length > 0 ? outputTypeName : outputType;
+    const hintsDoc = skill.usageHints.map((h) => ` * @hint ${h}`).join("\n");
+    declarations.push(
+      `/**
+ * ${skill.description}
+${hintsDoc}
+ */
+declare function skill_${skill.name}(input: ${inputRef}): Promise<${outputRef}>;`
+    );
+  }
+  return declarations.join("\n\n");
+}
+export {
+  generateSkillTypes
+};
+//# sourceMappingURL=generate-skill-types.js.map

package/dist/esm/generate-skill-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-skill-types.js","sources":["../../src/generate-skill-types.ts"],"sourcesContent":["import type { Skill } from './types'\n\n/**\n * Convert a JSON Schema to a TypeScript type string\n */\nfunction schemaToType(schema: Record<string, unknown>): string {\n  if (typeof schema !== 'object') {\n    return 'unknown'\n  }\n\n  const schemaType = schema.type\n\n  // Handle basic types\n  if (schemaType === 'string') return 'string'\n  if (schemaType === 'number' || schemaType === 'integer') return 'number'\n  if (schemaType === 'boolean') return 'boolean'\n  if (schemaType === 'null') return 'null'\n\n  // Handle arrays\n  if (schemaType === 'array') {\n    const items = schema.items as Record<string, unknown> | undefined\n    const itemType = items ? schemaToType(items) : 'unknown'\n    return `Array<${itemType}>`\n  }\n\n  // Handle objects with properties\n  if (schemaType === 'object' && schema.properties) {\n    const properties = schema.properties as Record<\n      string,\n      Record<string, unknown>\n    >\n    const required = new Set(\n      (schema.required as Array<string> | undefined) ?? [],\n    )\n\n    const props = Object.entries(properties)\n      .map(([key, propSchema]) => {\n        const optional = required.has(key) ? '' : '?'\n        const propType = schemaToType(propSchema)\n        // Handle property names that need quoting\n        const safeName = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(key)\n          ? key\n          : `\"${key}\"`\n        return `  ${safeName}${optional}: ${propType};`\n      })\n      .join('\\n')\n\n    return `{\\n${props}\\n}`\n  }\n\n  // Handle enums\n  if (schema.enum) {\n    const enumValues = schema.enum as Array<unknown>\n    return enumValues.map((v) => JSON.stringify(v)).join(' | ')\n  }\n\n  // Handle union types (anyOf, oneOf)\n  if (schema.anyOf || schema.oneOf) {\n    const variants = (schema.anyOf || schema.oneOf) as Array<\n      Record<string, unknown>\n    >\n    return variants.map((v) => schemaToType(v)).join(' | ')\n  }\n\n  // Handle type arrays (e.g., [\"string\", \"null\"])\n  if (Array.isArray(schemaType)) {\n    return schemaType\n      .map((t) => {\n        if (t === 'string') return 'string'\n        if (t === 'number' || t === 'integer') return 'number'\n        if (t === 'boolean') return 'boolean'\n        if (t === 'null') return 'null'\n        if (t === 'array') return 'Array<unknown>'\n        if (t === 'object') return 'object'\n        return 'unknown'\n      })\n      .join(' | ')\n  }\n\n  // Fallback for unknown schemas\n  return 'unknown'\n}\n\n/**\n * Capitalize the first letter of a string\n */\nfunction capitalize(str: string): string {\n  return str.charAt(0).toUpperCase() + str.slice(1)\n}\n\n/**\n * Convert snake_case to PascalCase\n */\nfunction toPascalCase(str: string): string {\n  return str\n    .split('_')\n    .map((part) => capitalize(part))\n    .join('')\n}\n\n/**\n * Generate TypeScript type stubs for skills.\n * These are included in the system prompt so the LLM knows\n * the exact type signatures of available skills.\n */\nexport function generateSkillTypes(skills: Array<Skill>): string {\n  const declarations: Array<string> = []\n\n  for (const skill of skills) {\n    const baseName = toPascalCase(skill.name)\n    const inputTypeName = `Skill${baseName}Input`\n    const outputTypeName = `Skill${baseName}Output`\n\n    // Generate input type\n    const inputType = schemaToType(skill.inputSchema)\n    if (\n      skill.inputSchema.type === 'object' &&\n      skill.inputSchema.properties &&\n      Object.keys(skill.inputSchema.properties as object).length > 0\n    ) {\n      declarations.push(`interface ${inputTypeName} ${inputType}`)\n    }\n\n    // Generate output type\n    const outputType = schemaToType(skill.outputSchema)\n    if (\n      skill.outputSchema.type === 'object' &&\n      skill.outputSchema.properties &&\n      Object.keys(skill.outputSchema.properties as object).length > 0\n    ) {\n      declarations.push(`interface ${outputTypeName} ${outputType}`)\n    }\n\n    // Determine type references\n    const inputRef =\n      skill.inputSchema.type === 'object' &&\n      skill.inputSchema.properties &&\n      Object.keys(skill.inputSchema.properties as object).length > 0\n        ? inputTypeName\n        : inputType\n\n    const outputRef =\n      skill.outputSchema.type === 'object' &&\n      skill.outputSchema.properties &&\n      Object.keys(skill.outputSchema.properties as object).length > 0\n        ? outputTypeName\n        : outputType\n\n    // Generate function declaration with JSDoc\n    const hintsDoc = skill.usageHints.map((h) => ` * @hint ${h}`).join('\\n')\n\n    declarations.push(\n      `/**\n * ${skill.description}\n${hintsDoc}\n */\ndeclare function skill_${skill.name}(input: ${inputRef}): Promise<${outputRef}>;`,\n    )\n  }\n\n  return declarations.join('\\n\\n')\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/index.d.ts

@@ -0,0 +1,13 @@
+export { codeModeWithSkills, createCodeModeWithSkillsConfig, } from './code-mode-with-skills.js';
+export type { CodeModeWithSkillsOptions, CodeModeWithSkillsResult, } from './code-mode-with-skills.js';
+export { createDefaultTrustStrategy, createAlwaysTrustedStrategy, createRelaxedTrustStrategy, createCustomTrustStrategy, } from './trust-strategies.js';
+export type { TrustStrategy } from './trust-strategies.js';
+export { selectRelevantSkills } from './select-relevant-skills.js';
+export { skillsToTools, skillToTool } from './skills-to-tools.js';
+export type { SkillToToolOptions } from './skills-to-tools.js';
+export { skillsToBindings, skillsToSimpleBindings } from './skills-to-bindings.js';
+export { createSkillManagementTools } from './create-skill-management-tools.js';
+export { createSkillsSystemPrompt } from './create-skills-system-prompt.js';
+export { generateSkillTypes } from './generate-skill-types.js';
+export * from './storage.js';
+export type { Skill, SkillIndexEntry, SkillStorage, SkillsConfig, SkillStats, TrustLevel, SkillBinding, } from './types.js';

package/dist/esm/index.js

@@ -0,0 +1,29 @@
+import { codeModeWithSkills, createCodeModeWithSkillsConfig } from "./code-mode-with-skills.js";
+import { createAlwaysTrustedStrategy, createCustomTrustStrategy, createDefaultTrustStrategy, createRelaxedTrustStrategy } from "./trust-strategies.js";
+import { selectRelevantSkills } from "./select-relevant-skills.js";
+import { skillToTool, skillsToTools } from "./skills-to-tools.js";
+import { skillsToBindings, skillsToSimpleBindings } from "./skills-to-bindings.js";
+import { createSkillManagementTools } from "./create-skill-management-tools.js";
+import { createSkillsSystemPrompt } from "./create-skills-system-prompt.js";
+import { generateSkillTypes } from "./generate-skill-types.js";
+import { createFileSkillStorage } from "./storage/file-storage.js";
+import { createMemorySkillStorage } from "./storage/memory-storage.js";
+export {
+  codeModeWithSkills,
+  createAlwaysTrustedStrategy,
+  createCodeModeWithSkillsConfig,
+  createCustomTrustStrategy,
+  createDefaultTrustStrategy,
+  createFileSkillStorage,
+  createMemorySkillStorage,
+  createRelaxedTrustStrategy,
+  createSkillManagementTools,
+  createSkillsSystemPrompt,
+  generateSkillTypes,
+  selectRelevantSkills,
+  skillToTool,
+  skillsToBindings,
+  skillsToSimpleBindings,
+  skillsToTools
+};
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;"}

package/dist/esm/select-relevant-skills.d.ts

@@ -0,0 +1,29 @@
+import { AnyTextAdapter, ModelMessage } from '@tanstack/ai';
+import { Skill, SkillIndexEntry, SkillStorage } from './types.js';
+interface SelectRelevantSkillsOptions {
+    /**
+     * Text adapter for skill selection (should be a cheap/fast model)
+     */
+    adapter: AnyTextAdapter;
+    /**
+     * Current conversation messages
+     */
+    messages: Array<ModelMessage>;
+    /**
+     * Skill index (lightweight metadata)
+     */
+    skillIndex: Array<SkillIndexEntry>;
+    /**
+     * Maximum number of skills to select
+     */
+    maxSkills: number;
+    /**
+     * Storage to load full skill data
+     */
+    storage: SkillStorage;
+}
+/**
+ * Use a cheap/fast LLM to select which skills are relevant for the current conversation
+ */
+export declare function selectRelevantSkills({ adapter, messages, skillIndex, maxSkills, storage, }: SelectRelevantSkillsOptions): Promise<Array<Skill>>;
+export {};

package/dist/esm/select-relevant-skills.js

@@ -0,0 +1,79 @@
+import { chat } from "@tanstack/ai";
+async function selectRelevantSkills({
+  adapter,
+  messages,
+  skillIndex,
+  maxSkills,
+  storage
+}) {
+  if (skillIndex.length === 0) return [];
+  if (messages.length === 0) return [];
+  const recentMessages = messages.slice(-5);
+  const recentContext = recentMessages.map((m) => {
+    let content;
+    if (typeof m.content === "string") {
+      content = m.content;
+    } else if (Array.isArray(m.content)) {
+      content = m.content.map((part) => {
+        if (typeof part === "string") return part;
+        if (part && typeof part === "object" && "text" in part)
+          return part.text;
+        return "[non-text content]";
+      }).join(" ");
+    } else {
+      content = "[complex content]";
+    }
+    return `${m.role}: ${content}`;
+  }).join("\n");
+  const skillCatalog = skillIndex.map((s) => {
+    const hints = s.usageHints.length > 0 ? ` (${s.usageHints[0]})` : "";
+    return `- ${s.name}: ${s.description}${hints}`;
+  }).join("\n");
+  const selectionPrompt = `Given this conversation context:
+---
+${recentContext}
+---
+
+Which of these skills (if any) would be useful for the next response? Return a JSON array of skill names, max ${maxSkills}. Return [] if none are relevant.
+
+Available skills:
+${skillCatalog}
+
+Respond with only the JSON array, no explanation. Example: ["skill_name_1", "skill_name_2"]`;
+  try {
+    const stream = chat({
+      adapter,
+      messages: [
+        {
+          role: "user",
+          content: selectionPrompt
+        }
+      ]
+    });
+    let responseText = "";
+    for await (const chunk of stream) {
+      if (chunk.type === "TEXT_MESSAGE_CONTENT") {
+        responseText += chunk.delta;
+      }
+    }
+    let jsonText = responseText.trim();
+    if (jsonText.startsWith("```")) {
+      jsonText = jsonText.replace(/^```(?:json)?\n?/, "").replace(/\n?```$/, "");
+    }
+    const selectedNames = JSON.parse(jsonText);
+    if (!Array.isArray(selectedNames)) {
+      return [];
+    }
+    const selectedSkills = await Promise.all(
+      selectedNames.slice(0, maxSkills).map((name) => storage.get(name))
+    );
+    return selectedSkills.filter((s) => s !== null);
+  } catch (error) {
+    console.warn("Skill selection failed, returning empty selection:", error);
+    return [];
+  }
+}
+export {
+  selectRelevantSkills
+};
+//# sourceMappingURL=select-relevant-skills.js.map

package/dist/esm/select-relevant-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-relevant-skills.js","sources":["../../src/select-relevant-skills.ts"],"sourcesContent":["import { chat } from '@tanstack/ai'\nimport type { AnyTextAdapter, ModelMessage, StreamChunk } from '@tanstack/ai'\nimport type { Skill, SkillIndexEntry, SkillStorage } from './types'\n\ninterface SelectRelevantSkillsOptions {\n  /**\n   * Text adapter for skill selection (should be a cheap/fast model)\n   */\n  adapter: AnyTextAdapter\n\n  /**\n   * Current conversation messages\n   */\n  messages: Array<ModelMessage>\n\n  /**\n   * Skill index (lightweight metadata)\n   */\n  skillIndex: Array<SkillIndexEntry>\n\n  /**\n   * Maximum number of skills to select\n   */\n  maxSkills: number\n\n  /**\n   * Storage to load full skill data\n   */\n  storage: SkillStorage\n}\n\n/**\n * Use a cheap/fast LLM to select which skills are relevant for the current conversation\n */\nexport async function selectRelevantSkills({\n  adapter,\n  messages,\n  skillIndex,\n  maxSkills,\n  storage,\n}: SelectRelevantSkillsOptions): Promise<Array<Skill>> {\n  // Early exit conditions\n  if (skillIndex.length === 0) return []\n  if (messages.length === 0) return []\n\n  // Build context from recent messages (last 5)\n  const recentMessages = messages.slice(-5)\n  const recentContext = recentMessages\n    .map((m) => {\n      let content: string\n      if (typeof m.content === 'string') {\n        content = m.content\n      } else if (Array.isArray(m.content)) {\n        // Handle content parts (text, images, etc.)\n        content = m.content\n          .map((part: unknown) => {\n            if (typeof part === 'string') return part\n            if (part && typeof part === 'object' && 'text' in part)\n              return (part as { text: string }).text\n            return '[non-text content]'\n          })\n          .join(' ')\n      } else {\n        content = '[complex content]'\n      }\n      return `${m.role}: ${content}`\n    })\n    .join('\\n')\n\n  // Build skill catalog for selection prompt\n  const skillCatalog = skillIndex\n    .map((s) => {\n      const hints = s.usageHints.length > 0 ? ` (${s.usageHints[0]})` : ''\n      return `- ${s.name}: ${s.description}${hints}`\n    })\n    .join('\\n')\n\n  // Ask cheap model to select relevant skills\n  const selectionPrompt = `Given this conversation context:\n---\n${recentContext}\n---\n\nWhich of these skills (if any) would be useful for the next response? Return a JSON array of skill names, max ${maxSkills}. Return [] if none are relevant.\n\nAvailable skills:\n${skillCatalog}\n\nRespond with only the JSON array, no explanation. Example: [\"skill_name_1\", \"skill_name_2\"]`\n\n  try {\n    // Use chat to get the selection\n    const stream = chat({\n      adapter,\n      messages: [\n        {\n          role: 'user',\n          content: selectionPrompt,\n        },\n      ],\n    })\n\n    // Collect the full response\n    let responseText = ''\n    for await (const chunk of stream as AsyncIterable<StreamChunk>) {\n      if (chunk.type === 'TEXT_MESSAGE_CONTENT') {\n        responseText += chunk.delta\n      }\n    }\n\n    // Parse the JSON response\n    // Handle potential markdown code blocks\n    let jsonText = responseText.trim()\n    if (jsonText.startsWith('```')) {\n      // Remove markdown code block\n      jsonText = jsonText.replace(/^```(?:json)?\\n?/, '').replace(/\\n?```$/, '')\n    }\n\n    const selectedNames: Array<string> = JSON.parse(jsonText)\n\n    if (!Array.isArray(selectedNames)) {\n      return []\n    }\n\n    // Load full skill data for selected skills\n    const selectedSkills = await Promise.all(\n      selectedNames.slice(0, maxSkills).map((name) => storage.get(name)),\n    )\n\n    return selectedSkills.filter((s): s is Skill => s !== null)\n  } catch (error) {\n    // If parsing fails or any error occurs, return empty (safe fallback)\n    console.warn('Skill selection failed, returning empty selection:', error)\n    return []\n  }\n}\n"],"names":[],"mappings":";AAkCA,eAAsB,qBAAqB;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAuD;AAErD,MAAI,WAAW,WAAW,EAAG,QAAO,CAAA;AACpC,MAAI,SAAS,WAAW,EAAG,QAAO,CAAA;AAGlC,QAAM,iBAAiB,SAAS,MAAM,EAAE;AACxC,QAAM,gBAAgB,eACnB,IAAI,CAAC,MAAM;AACV,QAAI;AACJ,QAAI,OAAO,EAAE,YAAY,UAAU;AACjC,gBAAU,EAAE;AAAA,IACd,WAAW,MAAM,QAAQ,EAAE,OAAO,GAAG;AAEnC,gBAAU,EAAE,QACT,IAAI,CAAC,SAAkB;AACtB,YAAI,OAAO,SAAS,SAAU,QAAO;AACrC,YAAI,QAAQ,OAAO,SAAS,YAAY,UAAU;AAChD,iBAAQ,KAA0B;AACpC,eAAO;AAAA,MACT,CAAC,EACA,KAAK,GAAG;AAAA,IACb,OAAO;AACL,gBAAU;AAAA,IACZ;AACA,WAAO,GAAG,EAAE,IAAI,KAAK,OAAO;AAAA,EAC9B,CAAC,EACA,KAAK,IAAI;AAGZ,QAAM,eAAe,WAClB,IAAI,CAAC,MAAM;AACV,UAAM,QAAQ,EAAE,WAAW,SAAS,IAAI,KAAK,EAAE,WAAW,CAAC,CAAC,MAAM;AAClE,WAAO,KAAK,EAAE,IAAI,KAAK,EAAE,WAAW,GAAG,KAAK;AAAA,EAC9C,CAAC,EACA,KAAK,IAAI;AAGZ,QAAM,kBAAkB;AAAA;AAAA,EAExB,aAAa;AAAA;AAAA;AAAA,gHAGiG,SAAS;AAAA;AAAA;AAAA,EAGvH,YAAY;AAAA;AAAA;AAIZ,MAAI;AAEF,UAAM,SAAS,KAAK;AAAA,MAClB;AAAA,MACA,UAAU;AAAA,QACR;AAAA,UACE,MAAM;AAAA,UACN,SAAS;AAAA,QAAA;AAAA,MACX;AAAA,IACF,CACD;AAGD,QAAI,eAAe;AACnB,qBAAiB,SAAS,QAAsC;AAC9D,UAAI,MAAM,SAAS,wBAAwB;AACzC,wBAAgB,MAAM;AAAA,MACxB;AAAA,IACF;AAIA,QAAI,WAAW,aAAa,KAAA;AAC5B,QAAI,SAAS,WAAW,KAAK,GAAG;AAE9B,iBAAW,SAAS,QAAQ,oBAAoB,EAAE,EAAE,QAAQ,WAAW,EAAE;AAAA,IAC3E;AAEA,UAAM,gBAA+B,KAAK,MAAM,QAAQ;AAExD,QAAI,CAAC,MAAM,QAAQ,aAAa,GAAG;AACjC,aAAO,CAAA;AAAA,IACT;AAGA,UAAM,iBAAiB,MAAM,QAAQ;AAAA,MACnC,cAAc,MAAM,GAAG,SAAS,EAAE,IAAI,CAAC,SAAS,QAAQ,IAAI,IAAI,CAAC;AAAA,IAAA;AAGnE,WAAO,eAAe,OAAO,CAAC,MAAkB,MAAM,IAAI;AAAA,EAC5D,SAAS,OAAO;AAEd,YAAQ,KAAK,sDAAsD,KAAK;AACxE,WAAO,CAAA;AAAA,EACT;AACF;"}

package/dist/esm/skills-to-bindings.d.ts

@@ -0,0 +1,34 @@
+import { ToolExecutionContext } from '@tanstack/ai';
+import { ToolBinding } from '@tanstack/ai-code-mode';
+import { Skill, SkillStorage } from './types.js';
+interface SkillsToBindingsOptions {
+    /**
+     * Skills to convert to bindings
+     */
+    skills: Array<Skill>;
+    /**
+     * Tool execution context for emitting custom events
+     */
+    context?: ToolExecutionContext;
+    /**
+     * Function to execute skill code in the sandbox
+     * The skill code receives `input` as a variable
+     */
+    executeInSandbox: (code: string, input: unknown) => Promise<unknown>;
+    /**
+     * Storage for updating execution stats
+     */
+    storage: SkillStorage;
+}
+/**
+ * Convert skills to sandbox bindings with the skill_ prefix.
+ * Skills become callable functions inside the sandbox.
+ */
+export declare function skillsToBindings({ skills, context, executeInSandbox, storage, }: SkillsToBindingsOptions): Record<string, ToolBinding>;
+/**
+ * Create a simple binding record for skills without full sandbox execution.
+ * This is used when skills are being documented in the system prompt
+ * but not yet being executed.
+ */
+export declare function skillsToSimpleBindings(skills: Array<Skill>): Record<string, ToolBinding>;
+export {};