@operor/skills 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,203 @@
+import { Skill, Tool } from "@operor/core";
+
+//#region src/config.d.ts
+interface MCPSkillConfig {
+  name: string;
+  transport: 'stdio' | 'http' | 'sse';
+  command?: string;
+  args?: string[];
+  env?: Record<string, string>;
+  url?: string;
+  headers?: Record<string, string>;
+  toolPrefix?: string;
+  enabled?: boolean;
+}
+interface PromptSkillConfig {
+  type: 'prompt';
+  name: string;
+  summary?: string;
+  version?: string;
+  tags?: string[];
+  author?: string;
+  content: string;
+  enabled?: boolean;
+}
+type AnySkillConfig = (MCPSkillConfig & {
+  type?: 'mcp';
+}) | PromptSkillConfig;
+declare function isPromptSkillConfig(config: AnySkillConfig): config is PromptSkillConfig;
+declare function isMCPSkillConfig(config: AnySkillConfig): config is MCPSkillConfig & {
+  type?: 'mcp';
+};
+interface SkillsConfig {
+  skills: AnySkillConfig[];
+}
+/**
+ * Resolve `${ENV_VAR}` placeholders in a string value.
+ */
+declare function resolveEnvVars(value: string): string;
+/**
+ * Resolve env vars in all values of a record.
+ */
+declare function resolveEnvRecord(record: Record<string, string>): Record<string, string>;
+/**
+ * Load skills config from `mcp.json` at the given root (defaults to cwd).
+ * Returns empty config if file doesn't exist.
+ */
+declare function loadSkillsConfig(root?: string): SkillsConfig;
+/**
+ * Save skills config to `mcp.json` at the given root (defaults to cwd).
+ */
+declare function saveSkillsConfig(config: SkillsConfig, root?: string): void;
+//#endregion
+//#region src/MCPSkill.d.ts
+declare class MCPSkill implements Skill {
+  readonly name: string;
+  tools: Record<string, Tool>;
+  private client;
+  private ready;
+  private config;
+  constructor(config: MCPSkillConfig);
+  initialize(): Promise<void>;
+  isReady(): boolean;
+  close(): Promise<void>;
+  /**
+   * Extract parameters from an AI SDK tool into JSON Schema format.
+   * The @ai-sdk/mcp client exposes the schema as `inputSchema` (a jsonSchema()
+   * wrapper with a `.jsonSchema` getter), while older/test code may use
+   * `parameters` directly.
+   */
+  private extractParameters;
+  /**
+   * Create the appropriate transport based on config.
+   */
+  private createTransport;
+  private createStdioTransport;
+  private createHttpTransport;
+  private createSseTransport;
+}
+//#endregion
+//#region src/PromptSkill.d.ts
+declare class PromptSkill implements Skill {
+  readonly name: string;
+  readonly tools: Record<string, Tool>;
+  private ready;
+  private _config;
+  constructor(config: PromptSkillConfig);
+  initialize(): Promise<void>;
+  isReady(): boolean;
+  close(): Promise<void>;
+  getContent(): string;
+  getConfig(): PromptSkillConfig;
+}
+//#endregion
+//#region src/SkillManager.d.ts
+declare class SkillManager {
+  private skills;
+  initialize(config: SkillsConfig): Promise<Skill[]>;
+  closeAll(): Promise<void>;
+  getSkills(): Skill[];
+  getPromptSkills(): PromptSkill[];
+  getMCPSkills(): MCPSkill[];
+  static validateConfig(config: MCPSkillConfig): string | null;
+  static validatePromptConfig(config: PromptSkillConfig): string | null;
+}
+//#endregion
+//#region src/catalog.d.ts
+/** A single MCP skill entry in the catalog. */
+interface MCPSkillCatalogEntry {
+  type?: 'mcp';
+  name: string;
+  displayName: string;
+  description: string;
+  category: SkillCategory;
+  tags: string[];
+  transport: 'stdio' | 'http' | 'sse';
+  package?: string;
+  command?: string;
+  args?: string[];
+  url?: string;
+  envVars: Record<string, EnvVarSpec>;
+  tools: SkillToolSummary[];
+  maturity: 'official' | 'community' | 'experimental';
+  vendor: string;
+  docsUrl?: string;
+  version?: string;
+  updatedAt?: string;
+}
+/** A prompt skill entry in the catalog — behavioral instructions, no tools. */
+interface PromptSkillCatalogEntry {
+  type: 'prompt';
+  name: string;
+  displayName: string;
+  description: string;
+  category: SkillCategory;
+  tags: string[];
+  content: string;
+  maturity: 'official' | 'community' | 'experimental';
+  vendor: string;
+  version?: string;
+  updatedAt?: string;
+}
+/** A single skill entry in the catalog — the "app store" listing. */
+type SkillCatalogEntry = MCPSkillCatalogEntry | PromptSkillCatalogEntry;
+declare function isPromptCatalogEntry(entry: SkillCatalogEntry): entry is PromptSkillCatalogEntry;
+type SkillCategory = 'commerce' | 'payments' | 'crm' | 'support' | 'marketing' | 'search' | 'analytics' | 'communication' | 'productivity' | 'developer' | 'other';
+/** Describes an env var a skill needs. */
+interface EnvVarSpec {
+  /** What this env var is for */
+  description: string;
+  /** Whether the skill cannot function without it */
+  required: boolean;
+  /** Hint for the setup wizard (e.g. "sk-..." or "https://...") */
+  placeholder?: string;
+}
+/** Summary of a tool exposed by a skill — for catalog display, not runtime. */
+interface SkillToolSummary {
+  /** Tool name as exposed by the MCP server */
+  name: string;
+  /** What this tool does */
+  description: string;
+}
+/** The top-level catalog file structure. */
+interface SkillCatalog {
+  /** Schema version for forward compatibility */
+  version: number;
+  /** When the catalog was last generated */
+  updatedAt: string;
+  /** The skill entries */
+  skills: SkillCatalogEntry[];
+}
+/**
+ * Load the built-in skill catalog shipped with @operor/skills.
+ * Falls back to empty catalog if file is missing.
+ */
+declare function loadSkillCatalog(): SkillCatalog;
+/**
+ * Load a custom/override catalog from a specific path.
+ */
+declare function loadSkillCatalogFrom(filePath: string): SkillCatalog;
+/** Filter options for querying the catalog. */
+interface CatalogFilter {
+  category?: SkillCategory;
+  maturity?: SkillCatalogEntry['maturity'];
+  search?: string;
+  tags?: string[];
+}
+/**
+ * Query the catalog with optional filters.
+ * Search matches against name, displayName, description, and tags.
+ */
+declare function querySkillCatalog(catalog: SkillCatalog, filter?: CatalogFilter): SkillCatalogEntry[];
+/**
+ * Look up a single skill by name.
+ */
+declare function findSkillInCatalog(catalog: SkillCatalog, name: string): SkillCatalogEntry | undefined;
+/**
+ * Convert a catalog entry into a config suitable for mcp.json.
+ * Handles both MCP and prompt skill entries.
+ */
+declare function catalogEntryToConfig(entry: SkillCatalogEntry): Record<string, any>;
+//#endregion
+export { type AnySkillConfig, type CatalogFilter, type EnvVarSpec, MCPSkill, type MCPSkillCatalogEntry, type MCPSkillConfig, PromptSkill, type PromptSkillCatalogEntry, type PromptSkillConfig, type SkillCatalog, type SkillCatalogEntry, type SkillCategory, SkillManager, type SkillToolSummary, type SkillsConfig, catalogEntryToConfig, findSkillInCatalog, isMCPSkillConfig, isPromptCatalogEntry, isPromptSkillConfig, loadSkillCatalog, loadSkillCatalogFrom, loadSkillsConfig, querySkillCatalog, resolveEnvRecord, resolveEnvVars, saveSkillsConfig };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/config.ts","../src/MCPSkill.ts","../src/PromptSkill.ts","../src/SkillManager.ts","../src/catalog.ts"],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,348 @@
+import { createMCPClient } from "@ai-sdk/mcp";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+//#region src/config.ts
+function isPromptSkillConfig(config) {
+	return config.type === "prompt";
+}
+function isMCPSkillConfig(config) {
+	return !isPromptSkillConfig(config);
+}
+/**
+* Resolve `${ENV_VAR}` placeholders in a string value.
+*/
+function resolveEnvVars(value) {
+	return value.replace(/\$\{([^}]+)\}/g, (_match, envVar) => {
+		return process.env[envVar] ?? "";
+	});
+}
+/**
+* Resolve env vars in all values of a record.
+*/
+function resolveEnvRecord(record) {
+	const resolved = {};
+	for (const [key, value] of Object.entries(record)) resolved[key] = resolveEnvVars(value);
+	return resolved;
+}
+/**
+* Load skills config from `mcp.json` at the given root (defaults to cwd).
+* Returns empty config if file doesn't exist.
+*/
+function loadSkillsConfig(root) {
+	const configPath = resolve(root ?? process.cwd(), "mcp.json");
+	if (!existsSync(configPath)) return { skills: [] };
+	const raw = readFileSync(configPath, "utf-8");
+	let parsed;
+	try {
+		parsed = JSON.parse(raw);
+	} catch {
+		throw new Error(`Invalid JSON in ${configPath}`);
+	}
+	if (!parsed || typeof parsed !== "object") return { skills: [] };
+	return { skills: Array.isArray(parsed.skills) ? parsed.skills : [] };
+}
+/**
+* Save skills config to `mcp.json` at the given root (defaults to cwd).
+*/
+function saveSkillsConfig(config, root) {
+	writeFileSync(resolve(root ?? process.cwd(), "mcp.json"), JSON.stringify(config, null, 2) + "\n", "utf-8");
+}
+
+//#endregion
+//#region src/MCPSkill.ts
+var MCPSkill = class {
+	name;
+	tools = {};
+	client = null;
+	ready = false;
+	config;
+	constructor(config) {
+		this.config = config;
+		this.name = config.name;
+	}
+	async initialize() {
+		if (this.ready) return;
+		this.client = await createMCPClient({ transport: await this.createTransport() });
+		const mcpTools = await this.client.tools();
+		const prefix = this.config.toolPrefix ?? this.name;
+		for (const [toolName, tool] of Object.entries(mcpTools)) {
+			const prefixedName = `${prefix}__${toolName}`;
+			const parameters = this.extractParameters(tool);
+			this.tools[prefixedName] = {
+				name: prefixedName,
+				description: tool.description || "",
+				parameters,
+				execute: async (params) => {
+					const result = await tool.execute(params, { toolCallId: `call_${Date.now()}` });
+					if (result && typeof result === "object" && result.isError) {
+						const msg = result.content?.[0]?.text || (result.content?.length ? JSON.stringify(result.content) : null) || "MCP tool returned an error (no details provided)";
+						throw new Error(msg);
+					}
+					return result;
+				}
+			};
+		}
+		this.ready = true;
+	}
+	isReady() {
+		return this.ready;
+	}
+	async close() {
+		if (this.client) {
+			await this.client.close();
+			this.client = null;
+		}
+		this.ready = false;
+	}
+	/**
+	* Extract parameters from an AI SDK tool into JSON Schema format.
+	* The @ai-sdk/mcp client exposes the schema as `inputSchema` (a jsonSchema()
+	* wrapper with a `.jsonSchema` getter), while older/test code may use
+	* `parameters` directly.
+	*/
+	extractParameters(tool) {
+		const schema = tool.inputSchema ?? tool.parameters;
+		if (schema) {
+			if (schema.jsonSchema) return schema.jsonSchema;
+			if (schema.type === "object" && schema.properties) return schema;
+		}
+		return {
+			type: "object",
+			properties: {}
+		};
+	}
+	/**
+	* Create the appropriate transport based on config.
+	*/
+	async createTransport() {
+		switch (this.config.transport) {
+			case "stdio": return await this.createStdioTransport();
+			case "http": return this.createHttpTransport();
+			case "sse": return this.createSseTransport();
+			default: throw new Error(`Unknown transport type: ${this.config.transport}`);
+		}
+	}
+	async createStdioTransport() {
+		if (!this.config.command) throw new Error(`Skill "${this.name}": stdio transport requires a "command" field`);
+		const args = this.config.args?.map(resolveEnvVars) ?? [];
+		const env = this.config.env ? resolveEnvRecord(this.config.env) : void 0;
+		const { StdioClientTransport } = await import("@modelcontextprotocol/sdk/client/stdio.js");
+		return new StdioClientTransport({
+			command: this.config.command,
+			args,
+			env: env ? {
+				...process.env,
+				...env
+			} : void 0
+		});
+	}
+	createHttpTransport() {
+		if (!this.config.url) throw new Error(`Skill "${this.name}": http transport requires a "url" field`);
+		const headers = this.config.headers ? resolveEnvRecord(this.config.headers) : void 0;
+		return {
+			type: "http",
+			url: resolveEnvVars(this.config.url),
+			headers
+		};
+	}
+	createSseTransport() {
+		if (!this.config.url) throw new Error(`Skill "${this.name}": sse transport requires a "url" field`);
+		const headers = this.config.headers ? resolveEnvRecord(this.config.headers) : void 0;
+		return {
+			type: "sse",
+			url: resolveEnvVars(this.config.url),
+			headers
+		};
+	}
+};
+
+//#endregion
+//#region src/PromptSkill.ts
+var PromptSkill = class {
+	name;
+	tools = {};
+	ready = false;
+	_config;
+	constructor(config) {
+		this._config = config;
+		this.name = config.name;
+	}
+	async initialize() {
+		if (this.ready) return;
+		if (!this._config.content?.trim()) throw new Error(`Prompt skill "${this.name}": content must be a non-empty string`);
+		this.ready = true;
+	}
+	isReady() {
+		return this.ready;
+	}
+	async close() {
+		this.ready = false;
+	}
+	getContent() {
+		return this._config.content;
+	}
+	getConfig() {
+		return { ...this._config };
+	}
+};
+
+//#endregion
+//#region src/SkillManager.ts
+var SkillManager = class SkillManager {
+	skills = [];
+	async initialize(config) {
+		const enabledSkills = config.skills.filter((s) => s.enabled !== false);
+		for (const skillConfig of enabledSkills) if (isPromptSkillConfig(skillConfig)) {
+			const validationError = SkillManager.validatePromptConfig(skillConfig);
+			if (validationError) {
+				console.warn(`[SkillManager] Skipping prompt skill "${skillConfig.name}": ${validationError}`);
+				continue;
+			}
+			try {
+				const skill = new PromptSkill(skillConfig);
+				await skill.initialize();
+				this.skills.push(skill);
+				console.log(`[SkillManager] ✅ ${skill.name}: prompt skill loaded`);
+			} catch (error) {
+				console.warn(`[SkillManager] ⚠️ Failed to load prompt skill "${skillConfig.name}": ${error.message}`);
+			}
+		} else {
+			const validationError = SkillManager.validateConfig(skillConfig);
+			if (validationError) {
+				console.warn(`[SkillManager] Skipping skill "${skillConfig.name}": ${validationError}`);
+				continue;
+			}
+			try {
+				const skill = new MCPSkill(skillConfig);
+				await skill.initialize();
+				this.skills.push(skill);
+				const toolCount = Object.keys(skill.tools).length;
+				console.log(`[SkillManager] ✅ ${skill.name}: ${toolCount} tools loaded`);
+			} catch (error) {
+				console.warn(`[SkillManager] ⚠️ Failed to start skill "${skillConfig.name}": ${error.message}`);
+			}
+		}
+		return this.skills;
+	}
+	async closeAll() {
+		const closePromises = this.skills.map(async (skill) => {
+			try {
+				if (skill.close) await skill.close();
+			} catch (error) {
+				console.warn(`[SkillManager] Error closing skill "${skill.name}": ${error.message}`);
+			}
+		});
+		await Promise.all(closePromises);
+		this.skills = [];
+	}
+	getSkills() {
+		return this.skills;
+	}
+	getPromptSkills() {
+		return this.skills.filter((s) => s instanceof PromptSkill);
+	}
+	getMCPSkills() {
+		return this.skills.filter((s) => s instanceof MCPSkill);
+	}
+	static validateConfig(config) {
+		if (!config.name || typeof config.name !== "string") return "Missing or invalid \"name\" field";
+		if (![
+			"stdio",
+			"http",
+			"sse"
+		].includes(config.transport)) return `Invalid transport "${config.transport}" — must be "stdio", "http", or "sse"`;
+		if (config.transport === "stdio" && !config.command) return "stdio transport requires a \"command\" field";
+		if ((config.transport === "http" || config.transport === "sse") && !config.url) return `${config.transport} transport requires a "url" field`;
+		return null;
+	}
+	static validatePromptConfig(config) {
+		if (!config.name || typeof config.name !== "string") return "Missing or invalid \"name\" field";
+		if (!config.content || typeof config.content !== "string" || !config.content.trim()) return "Missing or empty \"content\" field";
+		return null;
+	}
+};
+
+//#endregion
+//#region src/catalog.ts
+function isPromptCatalogEntry(entry) {
+	return entry.type === "prompt";
+}
+/**
+* Load the built-in skill catalog shipped with @operor/skills.
+* Falls back to empty catalog if file is missing.
+*/
+function loadSkillCatalog() {
+	const catalogPath = resolve(dirname(fileURLToPath(import.meta.url)), "..", "skill-catalog.json");
+	if (!existsSync(catalogPath)) return {
+		version: 1,
+		updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+		skills: []
+	};
+	const raw = readFileSync(catalogPath, "utf-8");
+	return JSON.parse(raw);
+}
+/**
+* Load a custom/override catalog from a specific path.
+*/
+function loadSkillCatalogFrom(filePath) {
+	const raw = readFileSync(filePath, "utf-8");
+	return JSON.parse(raw);
+}
+/**
+* Query the catalog with optional filters.
+* Search matches against name, displayName, description, and tags.
+*/
+function querySkillCatalog(catalog, filter) {
+	let results = catalog.skills;
+	if (filter?.category) results = results.filter((s) => s.category === filter.category);
+	if (filter?.maturity) results = results.filter((s) => s.maturity === filter.maturity);
+	if (filter?.tags && filter.tags.length > 0) {
+		const filterTags = filter.tags.map((t) => t.toLowerCase());
+		results = results.filter((s) => filterTags.some((ft) => s.tags.some((st) => st.toLowerCase().includes(ft))));
+	}
+	if (filter?.search) {
+		const q = filter.search.toLowerCase();
+		results = results.filter((s) => s.name.toLowerCase().includes(q) || s.displayName.toLowerCase().includes(q) || s.description.toLowerCase().includes(q) || s.tags.some((t) => t.toLowerCase().includes(q)));
+	}
+	return results;
+}
+/**
+* Look up a single skill by name.
+*/
+function findSkillInCatalog(catalog, name) {
+	return catalog.skills.find((s) => s.name === name);
+}
+/**
+* Convert a catalog entry into a config suitable for mcp.json.
+* Handles both MCP and prompt skill entries.
+*/
+function catalogEntryToConfig(entry) {
+	if (isPromptCatalogEntry(entry)) return {
+		type: "prompt",
+		name: entry.name,
+		content: entry.content,
+		enabled: true
+	};
+	const config = {
+		name: entry.name,
+		transport: entry.transport,
+		enabled: true
+	};
+	if (entry.transport === "stdio") {
+		config.command = entry.command ?? "npx";
+		config.args = entry.args ?? (entry.package ? ["-y", entry.package] : []);
+	}
+	if ((entry.transport === "http" || entry.transport === "sse") && entry.url) config.url = entry.url;
+	const envKeys = Object.keys(entry.envVars);
+	if (envKeys.length > 0) {
+		config.env = {};
+		for (const key of envKeys) config.env[key] = `\${${key}}`;
+	}
+	return config;
+}
+
+//#endregion
+export { MCPSkill, PromptSkill, SkillManager, catalogEntryToConfig, findSkillInCatalog, isMCPSkillConfig, isPromptCatalogEntry, isPromptSkillConfig, loadSkillCatalog, loadSkillCatalogFrom, loadSkillsConfig, querySkillCatalog, resolveEnvRecord, resolveEnvVars, saveSkillsConfig };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/config.ts","../src/MCPSkill.ts","../src/PromptSkill.ts","../src/SkillManager.ts","../src/catalog.ts"],"sourcesContent":["import { readFileSync, writeFileSync, existsSync } from 'node:fs';\nimport { resolve } from 'node:path';\n\nexport interface MCPSkillConfig {\n  name: string;\n  transport: 'stdio' | 'http' | 'sse';\n  command?: string;\n  args?: string[];\n  env?: Record<string, string>;\n  url?: string;\n  headers?: Record<string, string>;\n  toolPrefix?: string;\n  enabled?: boolean;\n}\n\nexport interface PromptSkillConfig {\n  type: 'prompt';\n  name: string;\n  summary?: string;\n  version?: string;\n  tags?: string[];\n  author?: string;\n  content: string;\n  enabled?: boolean;\n}\n\nexport type AnySkillConfig = (MCPSkillConfig & { type?: 'mcp' }) | PromptSkillConfig;\n\nexport function isPromptSkillConfig(config: AnySkillConfig): config is PromptSkillConfig {\n  return (config as any).type === 'prompt';\n}\n\nexport function isMCPSkillConfig(config: AnySkillConfig): config is MCPSkillConfig & { type?: 'mcp' } {\n  return !isPromptSkillConfig(config);\n}\n\nexport interface SkillsConfig {\n  skills: AnySkillConfig[];\n}\n\n/**\n * Resolve `${ENV_VAR}` placeholders in a string value.\n */\nexport function resolveEnvVars(value: string): string {\n  return value.replace(/\\$\\{([^}]+)\\}/g, (_match, envVar) => {\n    return process.env[envVar] ?? '';\n  });\n}\n\n/**\n * Resolve env vars in all values of a record.\n */\nexport function resolveEnvRecord(record: Record<string, string>): Record<string, string> {\n  const resolved: Record<string, string> = {};\n  for (const [key, value] of Object.entries(record)) {\n    resolved[key] = resolveEnvVars(value);\n  }\n  return resolved;\n}\n\n/**\n * Load skills config from `mcp.json` at the given root (defaults to cwd).\n * Returns empty config if file doesn't exist.\n */\nexport function loadSkillsConfig(root?: string): SkillsConfig {\n  const configPath = resolve(root ?? process.cwd(), 'mcp.json');\n\n  if (!existsSync(configPath)) {\n    return { skills: [] };\n  }\n\n  const raw = readFileSync(configPath, 'utf-8');\n\n  let parsed: any;\n  try {\n    parsed = JSON.parse(raw);\n  } catch {\n    throw new Error(`Invalid JSON in ${configPath}`);\n  }\n\n  if (!parsed || typeof parsed !== 'object') {\n    return { skills: [] };\n  }\n\n  const skills: AnySkillConfig[] = Array.isArray(parsed.skills) ? parsed.skills : [];\n  return { skills };\n}\n\n/**\n * Save skills config to `mcp.json` at the given root (defaults to cwd).\n */\nexport function saveSkillsConfig(config: SkillsConfig, root?: string): void {\n  const configPath = resolve(root ?? process.cwd(), 'mcp.json');\n  writeFileSync(configPath, JSON.stringify(config, null, 2) + '\\n', 'utf-8');\n}\n","import type { Skill, Tool } from '@operor/core';\nimport { createMCPClient } from '@ai-sdk/mcp';\nimport type { MCPSkillConfig } from './config.js';\nimport { resolveEnvVars, resolveEnvRecord } from './config.js';\n\nexport class MCPSkill implements Skill {\n  public readonly name: string;\n  public tools: Record<string, Tool> = {};\n  private client: any = null;\n  private ready = false;\n  private config: MCPSkillConfig;\n\n  constructor(config: MCPSkillConfig) {\n    this.config = config;\n    this.name = config.name;\n  }\n\n  async initialize(): Promise<void> {\n    if (this.ready) return;\n    const transport = await this.createTransport();\n\n    this.client = await createMCPClient({ transport });\n\n    // Discover tools via the AI SDK MCP client\n    const mcpTools = await this.client.tools();\n    const prefix = this.config.toolPrefix ?? this.name;\n\n    for (const [toolName, tool] of Object.entries(mcpTools) as [string, any][]) {\n      const prefixedName = `${prefix}__${toolName}`;\n\n      // Extract the JSON Schema from the AI SDK tool's parameters\n      const parameters = this.extractParameters(tool);\n\n      this.tools[prefixedName] = {\n        name: prefixedName,\n        description: tool.description || '',\n        parameters,\n        execute: async (params: any) => {\n          // Call the AI SDK tool's execute function directly\n          const result = await tool.execute(params, { toolCallId: `call_${Date.now()}` });\n          // MCP tools return { content: [...], isError: true } on failure\n          // instead of throwing — surface these as real errors\n          if (result && typeof result === 'object' && result.isError) {\n            const msg = result.content?.[0]?.text\n              || (result.content?.length ? JSON.stringify(result.content) : null)\n              || 'MCP tool returned an error (no details provided)';\n            throw new Error(msg);\n          }\n          return result;\n        },\n      };\n    }\n\n    this.ready = true;\n  }\n\n  isReady(): boolean {\n    return this.ready;\n  }\n\n  async close(): Promise<void> {\n    if (this.client) {\n      await this.client.close();\n      this.client = null;\n    }\n    this.ready = false;\n  }\n\n  /**\n   * Extract parameters from an AI SDK tool into JSON Schema format.\n   * The @ai-sdk/mcp client exposes the schema as `inputSchema` (a jsonSchema()\n   * wrapper with a `.jsonSchema` getter), while older/test code may use\n   * `parameters` directly.\n   */\n  private extractParameters(tool: any): Record<string, any> {\n    // AI SDK MCP tools use `inputSchema` (a jsonSchema() wrapper)\n    const schema = tool.inputSchema ?? tool.parameters;\n    if (schema) {\n      // jsonSchema() wrapper — has a `.jsonSchema` getter\n      if (schema.jsonSchema) {\n        return schema.jsonSchema;\n      }\n      // Plain JSON Schema object\n      if (schema.type === 'object' && schema.properties) {\n        return schema;\n      }\n    }\n    return { type: 'object', properties: {} };\n  }\n\n  /**\n   * Create the appropriate transport based on config.\n   */\n  private async createTransport(): Promise<any> {\n    switch (this.config.transport) {\n      case 'stdio':\n        return await this.createStdioTransport();\n      case 'http':\n        return this.createHttpTransport();\n      case 'sse':\n        return this.createSseTransport();\n      default:\n        throw new Error(`Unknown transport type: ${this.config.transport}`);\n    }\n  }\n\n  private async createStdioTransport(): Promise<any> {\n    if (!this.config.command) {\n      throw new Error(`Skill \"${this.name}\": stdio transport requires a \"command\" field`);\n    }\n\n    // Resolve env vars in args\n    const args = this.config.args?.map(resolveEnvVars) ?? [];\n\n    // Resolve env vars in env record\n    const env = this.config.env ? resolveEnvRecord(this.config.env) : undefined;\n\n    // ESM dynamic import for @modelcontextprotocol/sdk stdio transport\n    const { StdioClientTransport } = await import('@modelcontextprotocol/sdk/client/stdio.js');\n    return new StdioClientTransport({\n      command: this.config.command,\n      args,\n      env: env ? { ...process.env, ...env } : undefined,\n    });\n  }\n\n  private createHttpTransport(): any {\n    if (!this.config.url) {\n      throw new Error(`Skill \"${this.name}\": http transport requires a \"url\" field`);\n    }\n\n    const headers = this.config.headers ? resolveEnvRecord(this.config.headers) : undefined;\n\n    return {\n      type: 'http' as const,\n      url: resolveEnvVars(this.config.url),\n      headers,\n    };\n  }\n\n  private createSseTransport(): any {\n    if (!this.config.url) {\n      throw new Error(`Skill \"${this.name}\": sse transport requires a \"url\" field`);\n    }\n\n    const headers = this.config.headers ? resolveEnvRecord(this.config.headers) : undefined;\n\n    return {\n      type: 'sse' as const,\n      url: resolveEnvVars(this.config.url),\n      headers,\n    };\n  }\n}\n","import type { Skill, Tool } from '@operor/core';\nimport type { PromptSkillConfig } from './config.js';\n\nexport class PromptSkill implements Skill {\n  public readonly name: string;\n  public readonly tools: Record<string, Tool> = {};\n  private ready = false;\n  private _config: PromptSkillConfig;\n\n  constructor(config: PromptSkillConfig) {\n    this._config = config;\n    this.name = config.name;\n  }\n\n  async initialize(): Promise<void> {\n    if (this.ready) return;\n    if (!this._config.content?.trim()) {\n      throw new Error(`Prompt skill \"${this.name}\": content must be a non-empty string`);\n    }\n    this.ready = true;\n  }\n\n  isReady(): boolean {\n    return this.ready;\n  }\n\n  async close(): Promise<void> {\n    this.ready = false;\n  }\n\n  getContent(): string {\n    return this._config.content;\n  }\n\n  getConfig(): PromptSkillConfig {\n    return { ...this._config };\n  }\n}\n","import type { Skill } from '@operor/core';\nimport { MCPSkill } from './MCPSkill.js';\nimport { PromptSkill } from './PromptSkill.js';\nimport type { MCPSkillConfig, SkillsConfig, PromptSkillConfig } from './config.js';\nimport { isPromptSkillConfig } from './config.js';\n\nexport class SkillManager {\n  private skills: Skill[] = [];\n\n  async initialize(config: SkillsConfig): Promise<Skill[]> {\n    const enabledSkills = config.skills.filter(s => s.enabled !== false);\n\n    for (const skillConfig of enabledSkills) {\n      if (isPromptSkillConfig(skillConfig)) {\n        const validationError = SkillManager.validatePromptConfig(skillConfig);\n        if (validationError) {\n          console.warn(`[SkillManager] Skipping prompt skill \"${skillConfig.name}\": ${validationError}`);\n          continue;\n        }\n        try {\n          const skill = new PromptSkill(skillConfig);\n          await skill.initialize();\n          this.skills.push(skill);\n          console.log(`[SkillManager] ✅ ${skill.name}: prompt skill loaded`);\n        } catch (error: any) {\n          console.warn(`[SkillManager] ⚠️ Failed to load prompt skill \"${skillConfig.name}\": ${error.message}`);\n        }\n      } else {\n        const validationError = SkillManager.validateConfig(skillConfig);\n        if (validationError) {\n          console.warn(`[SkillManager] Skipping skill \"${skillConfig.name}\": ${validationError}`);\n          continue;\n        }\n        try {\n          const skill = new MCPSkill(skillConfig);\n          await skill.initialize();\n          this.skills.push(skill);\n          const toolCount = Object.keys(skill.tools).length;\n          console.log(`[SkillManager] ✅ ${skill.name}: ${toolCount} tools loaded`);\n        } catch (error: any) {\n          console.warn(`[SkillManager] ⚠️ Failed to start skill \"${skillConfig.name}\": ${error.message}`);\n        }\n      }\n    }\n\n    return this.skills;\n  }\n\n  async closeAll(): Promise<void> {\n    const closePromises = this.skills.map(async (skill) => {\n      try {\n        if (skill.close) await skill.close();\n      } catch (error: any) {\n        console.warn(`[SkillManager] Error closing skill \"${skill.name}\": ${error.message}`);\n      }\n    });\n    await Promise.all(closePromises);\n    this.skills = [];\n  }\n\n  getSkills(): Skill[] {\n    return this.skills;\n  }\n\n  getPromptSkills(): PromptSkill[] {\n    return this.skills.filter((s): s is PromptSkill => s instanceof PromptSkill);\n  }\n\n  getMCPSkills(): MCPSkill[] {\n    return this.skills.filter((s): s is MCPSkill => s instanceof MCPSkill);\n  }\n\n  static validateConfig(config: MCPSkillConfig): string | null {\n    if (!config.name || typeof config.name !== 'string') {\n      return 'Missing or invalid \"name\" field';\n    }\n    if (!['stdio', 'http', 'sse'].includes(config.transport)) {\n      return `Invalid transport \"${config.transport}\" — must be \"stdio\", \"http\", or \"sse\"`;\n    }\n    if (config.transport === 'stdio' && !config.command) {\n      return 'stdio transport requires a \"command\" field';\n    }\n    if ((config.transport === 'http' || config.transport === 'sse') && !config.url) {\n      return `${config.transport} transport requires a \"url\" field`;\n    }\n    return null;\n  }\n\n  static validatePromptConfig(config: PromptSkillConfig): string | null {\n    if (!config.name || typeof config.name !== 'string') {\n      return 'Missing or invalid \"name\" field';\n    }\n    if (!config.content || typeof config.content !== 'string' || !config.content.trim()) {\n      return 'Missing or empty \"content\" field';\n    }\n    return null;\n  }\n}\n","import { readFileSync, existsSync } from 'node:fs';\nimport { resolve, dirname } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\n// ─── Catalog Schema ─────────────────────────────────────────────────────────\n\n/** A single MCP skill entry in the catalog. */\nexport interface MCPSkillCatalogEntry {\n  type?: 'mcp';\n  name: string;\n  displayName: string;\n  description: string;\n  category: SkillCategory;\n  tags: string[];\n  transport: 'stdio' | 'http' | 'sse';\n  package?: string;\n  command?: string;\n  args?: string[];\n  url?: string;\n  envVars: Record<string, EnvVarSpec>;\n  tools: SkillToolSummary[];\n  maturity: 'official' | 'community' | 'experimental';\n  vendor: string;\n  docsUrl?: string;\n  version?: string;\n  updatedAt?: string;\n}\n\n/** A prompt skill entry in the catalog — behavioral instructions, no tools. */\nexport interface PromptSkillCatalogEntry {\n  type: 'prompt';\n  name: string;\n  displayName: string;\n  description: string;\n  category: SkillCategory;\n  tags: string[];\n  content: string;\n  maturity: 'official' | 'community' | 'experimental';\n  vendor: string;\n  version?: string;\n  updatedAt?: string;\n}\n\n/** A single skill entry in the catalog — the \"app store\" listing. */\nexport type SkillCatalogEntry = MCPSkillCatalogEntry | PromptSkillCatalogEntry;\n\nexport function isPromptCatalogEntry(entry: SkillCatalogEntry): entry is PromptSkillCatalogEntry {\n  return (entry as any).type === 'prompt';\n}\n\nexport type SkillCategory =\n  | 'commerce'\n  | 'payments'\n  | 'crm'\n  | 'support'\n  | 'marketing'\n  | 'search'\n  | 'analytics'\n  | 'communication'\n  | 'productivity'\n  | 'developer'\n  | 'other';\n\n/** Describes an env var a skill needs. */\nexport interface EnvVarSpec {\n  /** What this env var is for */\n  description: string;\n  /** Whether the skill cannot function without it */\n  required: boolean;\n  /** Hint for the setup wizard (e.g. \"sk-...\" or \"https://...\") */\n  placeholder?: string;\n}\n\n/** Summary of a tool exposed by a skill — for catalog display, not runtime. */\nexport interface SkillToolSummary {\n  /** Tool name as exposed by the MCP server */\n  name: string;\n  /** What this tool does */\n  description: string;\n}\n\n/** The top-level catalog file structure. */\nexport interface SkillCatalog {\n  /** Schema version for forward compatibility */\n  version: number;\n  /** When the catalog was last generated */\n  updatedAt: string;\n  /** The skill entries */\n  skills: SkillCatalogEntry[];\n}\n\n// ─── Catalog Loader ─────────────────────────────────────────────────────────\n\n/**\n * Load the built-in skill catalog shipped with @operor/skills.\n * Falls back to empty catalog if file is missing.\n */\nexport function loadSkillCatalog(): SkillCatalog {\n  const catalogPath = resolve(\n    dirname(fileURLToPath(import.meta.url)),\n    '..',\n    'skill-catalog.json',\n  );\n\n  if (!existsSync(catalogPath)) {\n    return { version: 1, updatedAt: new Date().toISOString(), skills: [] };\n  }\n\n  const raw = readFileSync(catalogPath, 'utf-8');\n  return JSON.parse(raw) as SkillCatalog;\n}\n\n/**\n * Load a custom/override catalog from a specific path.\n */\nexport function loadSkillCatalogFrom(filePath: string): SkillCatalog {\n  const raw = readFileSync(filePath, 'utf-8');\n  return JSON.parse(raw) as SkillCatalog;\n}\n\n// ─── Catalog Query Helpers ──────────────────────────────────────────────────\n\n/** Filter options for querying the catalog. */\nexport interface CatalogFilter {\n  category?: SkillCategory;\n  maturity?: SkillCatalogEntry['maturity'];\n  search?: string;\n  tags?: string[];\n}\n\n/**\n * Query the catalog with optional filters.\n * Search matches against name, displayName, description, and tags.\n */\nexport function querySkillCatalog(\n  catalog: SkillCatalog,\n  filter?: CatalogFilter,\n): SkillCatalogEntry[] {\n  let results = catalog.skills;\n\n  if (filter?.category) {\n    results = results.filter((s) => s.category === filter.category);\n  }\n\n  if (filter?.maturity) {\n    results = results.filter((s) => s.maturity === filter.maturity);\n  }\n\n  if (filter?.tags && filter.tags.length > 0) {\n    const filterTags = filter.tags.map((t) => t.toLowerCase());\n    results = results.filter((s) =>\n      filterTags.some((ft) => s.tags.some((st) => st.toLowerCase().includes(ft))),\n    );\n  }\n\n  if (filter?.search) {\n    const q = filter.search.toLowerCase();\n    results = results.filter(\n      (s) =>\n        s.name.toLowerCase().includes(q) ||\n        s.displayName.toLowerCase().includes(q) ||\n        s.description.toLowerCase().includes(q) ||\n        s.tags.some((t) => t.toLowerCase().includes(q)),\n    );\n  }\n\n  return results;\n}\n\n/**\n * Look up a single skill by name.\n */\nexport function findSkillInCatalog(\n  catalog: SkillCatalog,\n  name: string,\n): SkillCatalogEntry | undefined {\n  return catalog.skills.find((s) => s.name === name);\n}\n\n/**\n * Convert a catalog entry into a config suitable for mcp.json.\n * Handles both MCP and prompt skill entries.\n */\nexport function catalogEntryToConfig(entry: SkillCatalogEntry): Record<string, any> {\n  if (isPromptCatalogEntry(entry)) {\n    return { type: 'prompt', name: entry.name, content: entry.content, enabled: true };\n  }\n\n  const config: Record<string, any> = {\n    name: entry.name,\n    transport: entry.transport,\n    enabled: true,\n  };\n\n  if (entry.transport === 'stdio') {\n    config.command = entry.command ?? 'npx';\n    config.args = entry.args ?? (entry.package ? ['-y', entry.package] : []);\n  }\n\n  if ((entry.transport === 'http' || entry.transport === 'sse') && entry.url) {\n    config.url = entry.url;\n  }\n\n  const envKeys = Object.keys(entry.envVars);\n  if (envKeys.length > 0) {\n    config.env = {};\n    for (const key of envKeys) {\n      config.env[key] = `\\${${key}}`;\n    }\n  }\n\n  return config;\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@operor/skills",
+  "version": "0.1.0",
+  "description": "MCP-based skills for Agent OS — universal tool integration via Model Context Protocol",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@ai-sdk/mcp": "^1.0.18",
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "@operor/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsdown": "^0.20.3",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}