@hasna/skills 0.1.27 → 0.1.30

package/dist/lib/auth-store.d.ts

@@ -0,0 +1,13 @@
+export interface AuthConfig {
+    apiKey: string;
+    email: string;
+    orgId: string;
+    orgSlug: string;
+    userId: string;
+}
+export declare function getAuthConfig(): AuthConfig | null;
+export declare function saveAuthConfig(config: AuthConfig): void;
+export declare function clearAuthConfig(): void;
+export declare function getApiKey(): string | null;
+export declare function normalizePlatformApiOrigin(apiUrl: string): string;
+export declare function getApiUrl(): string;

package/dist/lib/installer.d.ts

@@ -1,101 +1,104 @@
 /**
- * Skill installer - handles copying skills to user projects
+ * Skill setup and project preferences.
+ *
+ * Skills are discovered through the CLI/MCP registry and executed from the
+ * bundled package or the remote platform. This module deliberately does not
+ * copy skill source, SKILL.md, package.json, scripts, or runtime folders into
+ * projects or agent-native skill folders.
  */
+import { type SkillMeta } from "./registry.js";
+import { type ProjectSkillPin } from "./project-state.js";
 export interface InstallResult {
     skill: string;
     success: boolean;
     error?: string;
     path?: string;
+    mode?: InstallMode;
+    source?: InstallSource;
 }
 export interface InstallOptions {
     targetDir?: string;
     overwrite?: boolean;
 }
+export type InstallMode = "pin" | "source" | "manifest";
+export type InstallSource = ProjectSkillPin["source"];
+export interface SkillInstallManifest {
+    name: string;
+    skillMd: string;
+    version?: string;
+    source?: InstallSource;
+    metadata?: Record<string, unknown>;
+}
+export interface ManifestInstallOptions extends InstallOptions {
+    source?: InstallSource;
+    createRuntimeDirs?: boolean;
+    writeManifestFile?: boolean;
+}
+interface InstallMetaEntry {
+    installedAt: string;
+    version: string;
+    mode?: InstallMode;
+    source?: InstallSource;
+}
+interface MetaFile {
+    skills: Record<string, InstallMetaEntry>;
+    disabled?: string[];
+}
 /**
- * Get the path to a skill in the package
+ * Get the path to a bundled skill in the package.
  */
 export declare function getSkillPath(name: string): string;
 /**
- * Check if a skill exists in the package
+ * Check if a skill exists in the bundled/registered catalog.
  */
 export declare function skillExists(name: string): boolean;
 /**
- * Install a single skill to the target directory
+ * Pin a skill in .skills/project.json.
+ *
+ * This intentionally does not write .skills/skills or any SKILL.md/source files.
  */
 export declare function installSkill(name: string, options?: InstallOptions): InstallResult;
+export declare function installRemoteSkill(skill: SkillMeta, options?: InstallOptions): InstallResult;
 /**
- * Install multiple skills
+ * Source installs are disabled by design. Runtime source stays in the package
+ * or on the platform, never in a user project.
  */
-export declare function installSkills(names: string[], options?: InstallOptions): InstallResult[];
-interface SkillMeta {
-    installedAt: string;
-    version: string;
-}
-interface MetaFile {
-    skills: Record<string, SkillMeta>;
-    disabled?: string[];
-}
+export declare function installSkillSource(name: string, _options?: InstallOptions): InstallResult;
 /**
- * Get installation metadata for installed skills
+ * SKILL.md manifest installs are disabled. Docs are served by the remote or
+ * bundled registry and must not be cached into project skill folders.
  */
-export declare function getInstallMeta(targetDir?: string): MetaFile;
+export declare function installSkillManifest(manifest: SkillInstallManifest, _options?: ManifestInstallOptions): InstallResult;
 /**
- * Disable a skill (exclude from .skills/index.ts without removing files)
+ * Build an in-memory manifest from a bundled local skill.
  */
+export declare function createLocalSkillManifest(name: string, generateSkillMd?: (name: string) => string | null): SkillInstallManifest | null;
+export declare function installSkills(names: string[], options?: InstallOptions): InstallResult[];
+export declare function getInstallMeta(targetDir?: string): MetaFile;
 export declare function disableSkill(name: string, targetDir?: string): boolean;
-/**
- * Enable a previously disabled skill (re-add to .skills/index.ts)
- */
 export declare function enableSkill(name: string, targetDir?: string): boolean;
-/**
- * Get list of disabled skills
- */
 export declare function getDisabledSkills(targetDir?: string): string[];
 /**
- * Get list of installed skills in a directory
+ * Project-pinned skills. Historically this represented copied installs; it now
+ * reads .skills/project.json only.
  */
 export declare function getInstalledSkills(targetDir?: string): string[];
-/**
- * Remove an installed skill
- */
 export declare function removeSkill(name: string, targetDir?: string): boolean;
-export type AgentTarget = "claude" | "codex" | "gemini" | "pi" | "opencode";
+export declare function pinSkill(name: string, options?: InstallOptions): InstallResult;
+export declare function unpinSkill(name: string, targetDir?: string): boolean;
+export declare function getPinnedSkills(targetDir?: string): string[];
+export type AgentTarget = "claude" | "codex" | "gemini" | "pi" | "opencode" | "cursor" | "windsurf";
 export type AgentScope = "global" | "project";
 export declare const AGENT_TARGETS: AgentTarget[];
-/** Human-readable labels for each agent */
 export declare const AGENT_LABELS: Record<AgentTarget, string>;
-/**
- * Resolve an agent argument ("all" or a specific agent name) to a list of AgentTarget values.
- * Throws if the agent name is not recognized.
- */
 export declare function resolveAgents(agentArg: string): AgentTarget[];
 export interface AgentInstallOptions {
     agent: AgentTarget;
     scope?: AgentScope;
     projectDir?: string;
 }
-/**
- * Get the skills directory for a given agent and scope.
- *
- * Agent config dir conventions:
- *   claude  — ~/.claude/skills/          | .claude/skills/
- *   codex   — ~/.codex/skills/           | .codex/skills/
- *   gemini  — ~/.gemini/skills/          | .gemini/skills/
- *   pi      — ~/.pi/agent/skills/        | .pi/skills/
- *   opencode — ~/.opencode/skills/       | .opencode/skills/
- */
 export declare function getAgentSkillsDir(agent: AgentTarget, scope?: AgentScope, projectDir?: string): string;
-/**
- * Get the full path where a skill's SKILL.md would be installed for an agent
- */
 export declare function getAgentSkillPath(name: string, agent: AgentTarget, scope?: AgentScope, projectDir?: string): string;
-/**
- * Install a skill's SKILL.md for a specific agent
- * If the skill has no SKILL.md, one will be generated using the provided generator function
- */
-export declare function installSkillForAgent(name: string, options: AgentInstallOptions, generateSkillMd?: (name: string) => string | null): InstallResult;
-/**
- * Remove a skill from an agent's skill directory
- */
-export declare function removeSkillForAgent(name: string, options: AgentInstallOptions): boolean;
+export declare function installSkillForAgent(name: string, options: AgentInstallOptions, _generateSkillMd?: (name: string) => string | null): InstallResult;
+export declare function removeSkillForAgent(_name: string, _options: AgentInstallOptions): boolean;
 export {};

package/dist/lib/mcp-contracts.d.ts

@@ -0,0 +1,86 @@
+import type { SkillMeta } from "./registry.js";
+export declare const MCP_CONTRACT_SCHEMA_VERSION: 1;
+export interface JsonSchemaObject {
+    type?: string;
+    title?: string;
+    description?: string;
+    enum?: unknown[];
+    const?: unknown;
+    default?: unknown;
+    format?: string;
+    minimum?: number;
+    items?: JsonSchemaObject;
+    properties?: Record<string, JsonSchemaObject>;
+    required?: string[];
+    additionalProperties?: boolean | JsonSchemaObject;
+    oneOf?: JsonSchemaObject[];
+}
+export type McpToolCategory = "agent-session" | "discovery" | "execution" | "feedback" | "metadata" | "pinning" | "scheduling" | "validation";
+export type McpToolSideEffect = "filesystem" | "local-process-or-remote-run" | "none" | "schedule-state";
+export interface McpToolContract {
+    name: string;
+    title: string;
+    description: string;
+    params: string[];
+    category: McpToolCategory;
+    sideEffects: McpToolSideEffect;
+    stable: true;
+    inputSchema: JsonSchemaObject;
+    outputSchema: JsonSchemaObject;
+}
+export interface UnknownMcpToolContract {
+    name: string;
+    known: false;
+    description: "Unknown tool";
+    params: [];
+}
+export type DescribedMcpToolContract = (McpToolContract & {
+    known: true;
+}) | UnknownMcpToolContract;
+export interface McpResourceContract {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: "application/json";
+    schema: JsonSchemaObject;
+}
+export interface McpContractManifest {
+    schemaVersion: typeof MCP_CONTRACT_SCHEMA_VERSION;
+    tools: McpToolContract[];
+    resources: McpResourceContract[];
+}
+export interface SkillMcpSchemaContract {
+    tool: string;
+    inputSchema: JsonSchemaObject;
+    outputSchema: JsonSchemaObject;
+}
+export interface SkillMcpMetadata {
+    schemaVersion: typeof MCP_CONTRACT_SCHEMA_VERSION;
+    name: string;
+    slug: string;
+    displayName: string;
+    description: string;
+    category: string;
+    tags: string[];
+    source: SkillMeta["source"] | "official";
+    cliCommand: string;
+    schemas: {
+        install: SkillMcpSchemaContract;
+        run: SkillMcpSchemaContract;
+        validate: SkillMcpSchemaContract;
+    };
+}
+export declare function listMcpToolContracts(query?: string): McpToolContract[];
+export declare function describeMcpToolContracts(names: string[]): DescribedMcpToolContract[];
+export declare function summarizeMcpToolContract(contract: McpToolContract): Pick<McpToolContract, "name" | "title" | "description" | "params" | "category" | "sideEffects">;
+export declare function getMcpResourceContracts(): McpResourceContract[];
+export declare function createMcpContractManifest(options?: {
+    names?: string[];
+    includeResources?: boolean;
+}): McpContractManifest;
+export declare function createSkillMcpMetadata(skill: SkillMeta): SkillMcpMetadata;
+export declare function getMcpToolDescriptions(): Record<string, {
+    description: string;
+    params: string[];
+}>;
+export declare const MCP_ERROR_RESPONSE_SCHEMA: JsonSchemaObject;

package/dist/lib/project-state.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Project-local Skills state.
+ *
+ * `.skills/` is runtime/output state plus optional project preferences. It is
+ * not a skill source directory and must never contain copied skill definitions.
+ */
+export declare const SKILLS_PROJECT_DIR = ".skills";
+export declare const PROJECT_CONFIG_FILE = "project.json";
+export declare const DEFAULT_EXPORT_DIR = ".skills/exports";
+export interface ProjectSkillPin {
+    name: string;
+    pinnedAt: string;
+    version: string;
+    source: "official" | "custom" | "remote" | "local";
+}
+export interface SkillsProjectConfig {
+    version: 1;
+    defaultExportDir: string;
+    pinnedSkills: string[];
+    pins: Record<string, ProjectSkillPin>;
+    disabledSkills?: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+export declare function getProjectStateDir(targetDir?: string): string;
+export declare function getProjectConfigPath(targetDir?: string): string;
+export declare function loadProjectConfig(targetDir?: string): SkillsProjectConfig | null;
+export declare function ensureProjectConfig(targetDir?: string): SkillsProjectConfig;
+export declare function saveProjectConfig(config: SkillsProjectConfig, targetDir?: string): void;
+export declare function pinProjectSkill(name: string, details?: {
+    version?: string;
+    source?: ProjectSkillPin["source"];
+}, targetDir?: string): {
+    pinned: boolean;
+    config: SkillsProjectConfig;
+};
+export declare function unpinProjectSkill(name: string, targetDir?: string): {
+    unpinned: boolean;
+    config: SkillsProjectConfig | null;
+};
+export declare function listPinnedSkills(targetDir?: string): string[];
+export declare function setSkillDisabled(name: string, disabled: boolean, targetDir?: string): boolean;
+export declare function getDisabledProjectSkills(targetDir?: string): string[];

package/dist/lib/registry-data/business-marketing.d.ts

@@ -0,0 +1,2 @@
+import type { SkillMeta } from "../registry-types.js";
+export declare const BUSINESS_MARKETING_SKILLS: SkillMeta[];

package/dist/lib/registry-data/communication.d.ts

@@ -0,0 +1,2 @@
+import type { SkillMeta } from "../registry-types.js";
+export declare const COMMUNICATION_SKILLS: SkillMeta[];

package/dist/lib/registry-data/content-generation.d.ts

@@ -0,0 +1,2 @@
+import type { SkillMeta } from "../registry-types.js";
+export declare const CONTENT_GENERATION_SKILLS: SkillMeta[];

package/dist/lib/registry-data/data-analysis.d.ts

@@ -0,0 +1,2 @@
+import type { SkillMeta } from "../registry-types.js";
+export declare const DATA_ANALYSIS_SKILLS: SkillMeta[];

package/dist/lib/registry-data/design-branding.d.ts

@@ -0,0 +1,2 @@
+import type { SkillMeta } from "../registry-types.js";
+export declare const DESIGN_BRANDING_SKILLS: SkillMeta[];

package/dist/lib/registry-data/development-tools.d.ts

@@ -0,0 +1,2 @@
+import type { SkillMeta } from "../registry-types.js";
+export declare const DEVELOPMENT_TOOLS_SKILLS: SkillMeta[];

package/dist/lib/registry-data/education-learning.d.ts

@@ -0,0 +1,2 @@
+import type { SkillMeta } from "../registry-types.js";
+export declare const EDUCATION_LEARNING_SKILLS: SkillMeta[];

package/dist/lib/registry-data/event-management.d.ts

@@ -0,0 +1,2 @@
+import type { SkillMeta } from "../registry-types.js";
+export declare const EVENT_MANAGEMENT_SKILLS: SkillMeta[];

package/dist/lib/registry-data/finance-compliance.d.ts

@@ -0,0 +1,2 @@
+import type { SkillMeta } from "../registry-types.js";
+export declare const FINANCE_COMPLIANCE_SKILLS: SkillMeta[];

package/dist/lib/registry-data/health-wellness.d.ts

@@ -0,0 +1,2 @@
+import type { SkillMeta } from "../registry-types.js";
+export declare const HEALTH_WELLNESS_SKILLS: SkillMeta[];

package/dist/lib/registry-data/index.d.ts

@@ -0,0 +1,2 @@
+import type { SkillMeta } from "../registry-types.js";
+export declare const SKILLS: SkillMeta[];

package/dist/lib/registry-data/media-processing.d.ts

@@ -0,0 +1,2 @@
+import type { SkillMeta } from "../registry-types.js";
+export declare const MEDIA_PROCESSING_SKILLS: SkillMeta[];

package/dist/lib/registry-data/productivity-organization.d.ts

@@ -0,0 +1,2 @@
+import type { SkillMeta } from "../registry-types.js";
+export declare const PRODUCTIVITY_ORGANIZATION_SKILLS: SkillMeta[];

package/dist/lib/registry-data/project-management.d.ts

@@ -0,0 +1,2 @@
+import type { SkillMeta } from "../registry-types.js";
+export declare const PROJECT_MANAGEMENT_SKILLS: SkillMeta[];

package/dist/lib/registry-data/research-writing.d.ts

@@ -0,0 +1,2 @@
+import type { SkillMeta } from "../registry-types.js";
+export declare const RESEARCH_WRITING_SKILLS: SkillMeta[];

package/dist/lib/registry-data/science-academic.d.ts

@@ -0,0 +1,2 @@
+import type { SkillMeta } from "../registry-types.js";
+export declare const SCIENCE_ACADEMIC_SKILLS: SkillMeta[];

package/dist/lib/registry-data/travel-lifestyle.d.ts

@@ -0,0 +1,2 @@
+import type { SkillMeta } from "../registry-types.js";
+export declare const TRAVEL_LIFESTYLE_SKILLS: SkillMeta[];

package/dist/lib/registry-data/web-browser.d.ts

@@ -0,0 +1,2 @@
+import type { SkillMeta } from "../registry-types.js";
+export declare const WEB_BROWSER_SKILLS: SkillMeta[];

package/dist/lib/registry-types.d.ts

@@ -0,0 +1,27 @@
+export interface SkillMeta {
+    name: string;
+    displayName: string;
+    description: string;
+    category: string;
+    tags: string[];
+    dependencies?: string[];
+    version?: string;
+    pricing?: SkillPricingMetadata;
+    source?: "official" | "custom" | "remote";
+}
+export interface SkillPricingMetadata {
+    tier?: "free" | "premium" | string;
+    billingUnit?: string;
+    costCents?: number;
+    formattedCost: string;
+    formattedUnitCost?: string;
+    unitCount?: number;
+    estimated?: boolean;
+    quoteDependsOnInput?: boolean;
+    quoteRequired?: boolean;
+    description?: string;
+}
+export declare const CATEGORIES: readonly ["Development Tools", "Business & Marketing", "Productivity & Organization", "Project Management", "Content Generation", "Finance & Compliance", "Data & Analysis", "Media Processing", "Design & Branding", "Web & Browser", "Research & Writing", "Science & Academic", "Education & Learning", "Communication", "Health & Wellness", "Travel & Lifestyle", "Event Management"];
+export type Category = (typeof CATEGORIES)[number];
+export declare const BASIC_SKILL_NAMES: readonly ["image", "video", "audio", "music", "transcript", "audio-extract", "read-image", "read-pdf", "pdf-read", "pdf-to-markdown", "doc-read", "pdf-generate", "doc-generate", "read-csv", "read-excel", "excel", "convert"];
+export type SkillRegistryProfile = "basic" | "all";

package/dist/lib/registry.d.ts

@@ -1,26 +1,14 @@
 /**
  * Skill registry - metadata about all available skills
  */
-export interface SkillMeta {
-    name: string;
-    displayName: string;
-    description: string;
-    category: string;
-    tags: string[];
-    dependencies?: string[];
-    source?: "official" | "custom" | "remote";
-}
-export declare const CATEGORIES: readonly ["Development Tools", "Business & Marketing", "Productivity & Organization", "Project Management", "Content Generation", "Finance & Compliance", "Data & Analysis", "Media Processing", "Design & Branding", "Web & Browser", "Research & Writing", "Science & Academic", "Education & Learning", "Communication", "Health & Wellness", "Travel & Lifestyle", "Event Management"];
-export type Category = (typeof CATEGORIES)[number];
-export declare const BASIC_SKILL_NAMES: readonly ["image", "video", "audio", "music", "sound-effects", "transcript", "audio-extract", "read-image", "read-pdf", "pdf-read", "doc-read", "pdf-generate", "doc-generate", "read-csv", "read-excel", "excel", "convert"];
-export type SkillRegistryProfile = "basic" | "all";
+import { SKILLS } from "./registry-data/index.js";
+import { BASIC_SKILL_NAMES, CATEGORIES, type Category, type SkillMeta, type SkillRegistryProfile } from "./registry-types.js";
+export { BASIC_SKILL_NAMES, CATEGORIES, SKILLS };
+export type { Category, SkillMeta, SkillRegistryProfile };
 export declare function isBasicSkillName(name: string): boolean;
-export declare const SKILLS: SkillMeta[];
 /**
- * Load the full registry: official skills merged with custom skills from:
- * - ~/.hasna/skills/custom/ (global custom, new path)
- * - ~/.skills/ (global custom, legacy path)
- * - ./.custom-skills/ (project-level custom, relative to cwd)
+ * Load the full registry: official skills merged with global custom skills
+ * from ~/.hasna/skills/custom/.
  *
  * Custom skills with the same name as official skills take precedence.
  * Results are cached for 5 seconds.

package/dist/lib/remote-registry.d.ts

@@ -11,9 +11,12 @@ export interface RemoteRegistryOptions {
     apiUrl?: string;
     endpoint?: string;
     timeoutMs?: number;
+    authToken?: string | null;
     fetchImpl?: (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
 }
 export declare function getConfiguredApiUrl(config?: SkillsConfig, env?: Record<string, string | undefined>): string | undefined;
 export declare function buildSkillsApiUrl(apiUrl: string, endpoint?: string): string;
 export declare function parseRemoteRegistryPayload(payload: unknown): SkillMeta[];
+export declare function parseRemoteSkillPayload(payload: unknown): SkillMeta;
 export declare function loadRemoteRegistry(options?: RemoteRegistryOptions): Promise<SkillMeta[]>;
+export declare function loadRemoteSkill(name: string, options?: RemoteRegistryOptions): Promise<SkillMeta>;

package/dist/lib/run-state.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Runtime records for skill executions.
+ *
+ * `.skills/runs` and `.skills/exports` hold what skills produced, not what
+ * skills are. Source files and SKILL.md documents are never written here.
+ */
+export type SkillRunStatus = "queued" | "running" | "completed" | "failed";
+export interface SkillRunArtifact {
+    path: string;
+    mime: string;
+    sha256: string;
+    sizeBytes: number;
+}
+export interface SkillRunRecord {
+    id: string;
+    skill: string;
+    status: SkillRunStatus;
+    prompt?: string;
+    args: string[];
+    startedAt: string;
+    completedAt?: string;
+    remote: boolean;
+    remoteRunId?: string;
+    costCents?: number;
+    error?: string;
+    artifacts: SkillRunArtifact[];
+    paths: {
+        runDir: string;
+        exportDir: string;
+        logsDir: string;
+    };
+}
+export interface SkillRunContext {
+    targetDir: string;
+    runDir: string;
+    exportDir: string;
+    logsDir: string;
+    record: SkillRunRecord;
+}
+export declare function createSkillRun(params: {
+    skill: string;
+    args?: string[];
+    prompt?: string;
+    remote?: boolean;
+    remoteRunId?: string;
+    costCents?: number;
+    status?: SkillRunStatus;
+}, targetDir?: string): SkillRunContext;
+export declare function completeSkillRun(context: SkillRunContext, patch: {
+    status: SkillRunStatus;
+    error?: string;
+    remoteRunId?: string;
+    costCents?: number;
+}): SkillRunRecord;
+export declare function updateSkillRun(context: SkillRunContext, patch: Partial<SkillRunRecord>): SkillRunRecord;
+export declare function writeRunLogs(context: SkillRunContext, stdout?: string, stderr?: string): void;
+export declare function appendRunEvent(context: SkillRunContext, event: string, data?: Record<string, unknown>): void;
+export declare function listSkillRuns(targetDir?: string, limit?: number): SkillRunRecord[];
+export declare function findSkillRun(runId: string, targetDir?: string): SkillRunRecord | null;
+export declare function getRunExportDir(runId: string, skill: string, targetDir?: string): string;

package/dist/lib/skill-aliases.d.ts

@@ -0,0 +1,17 @@
+export declare const SKILL_ALIASES: {
+    readonly transcribe: "transcript";
+    readonly "speech-to-text": "transcript";
+    readonly "generate-pdf": "pdf-generate";
+    readonly "create-pdf": "pdf-generate";
+    readonly "generate-doc": "doc-generate";
+    readonly "generate-document": "doc-generate";
+    readonly "read-document": "doc-read";
+    readonly "document-read": "doc-read";
+    readonly "pdf-reader": "read-pdf";
+    readonly "generate-image": "image";
+    readonly "image-generator": "image";
+    readonly "create-blog-article": "blog-article";
+};
+export type SkillAlias = keyof typeof SKILL_ALIASES;
+export declare function normalizeSkillSlug(name: string): string;
+export declare function resolveSkillAlias(name: string): string;

package/dist/lib/skillinfo.d.ts

@@ -30,9 +30,13 @@ export declare function getSkillRequirements(name: string): SkillRequirements |
  */
 export declare function runSkill(name: string, args: string[], options?: {
     installed?: boolean;
+    stdio?: "inherit" | "pipe";
+    env?: Record<string, string>;
 }): Promise<{
     exitCode: number;
     error?: string;
+    stdout?: string;
+    stderr?: string;
 }>;
 export interface DetectedProjectSkills {
     detected: string[];
@@ -43,7 +47,7 @@ export interface DetectedProjectSkills {
  */
 export declare function detectProjectSkills(cwd?: string): DetectedProjectSkills;
 /**
- * Generate a .env.example from installed skills
+ * Generate a .env.example from pinned skills
  */
 export declare function generateEnvExample(targetDir?: string): string;
 /**

package/dist/mcp/discovery-tools.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerDiscoveryTools(server: McpServer): void;

package/dist/mcp/helpers.d.ts

@@ -0,0 +1,26 @@
+export declare function stripNulls(obj: Record<string, unknown>): Record<string, unknown>;
+export declare function cacheGet(key: string): unknown | undefined;
+export declare function cacheSet(key: string, value: unknown): void;
+export declare function cacheClear(): void;
+/** Structured MCP error response */
+export declare function mcpError(code: string, message: string, suggestions?: string[]): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+};
+export declare function mcpJson(payload: unknown, pretty?: boolean): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function remoteRunNextActions(runId: string | undefined): {
+    poll: string;
+    download: string;
+} | undefined;
+export declare const TOOL_DESCRIPTIONS: Record<string, {
+    description: string;
+    params: string[];
+}>;

package/dist/mcp/http.d.ts

@@ -0,0 +1,11 @@
+import { createServer, type IncomingMessage, type ServerResponse } from "node:http";
+export declare const MCP_HTTP_DEFAULT_PORT = 8879;
+export declare const MCP_HTTP_SERVICE_NAME = "skills";
+export declare function isMcpHttpMode(argv?: string[]): boolean;
+export declare function isMcpStdioMode(argv?: string[]): boolean;
+export declare function parseMcpHttpPort(argv: string[], defaultPort?: number): number;
+export declare function handleMcpHttpNodeRequest(req: IncomingMessage, res: ServerResponse): Promise<boolean>;
+export declare function startSkillsMcpHttpServer(options?: {
+    port?: number;
+    hostname?: string;
+}): Promise<ReturnType<typeof createServer>>;

package/dist/mcp/index.d.ts

@@ -1,10 +1,11 @@
 #!/usr/bin/env bun
 /**
  * MCP server for the skills library.
- * Exposes tools for listing, searching, and installing skills.
+ * Exposes tools for listing, searching, pinning, and running skills.
  *
  * Usage:
  *   skills mcp          # Start MCP server on stdio
  *   skills-mcp          # Direct binary
+ *   skills-mcp --http   # Streamable HTTP on 127.0.0.1:8836
  */
-export {};
+export { buildServer } from "./server.js";

package/dist/mcp/operation-tools.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerOperationTools(server: McpServer): void;

package/dist/mcp/resource-meta-tools.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerResourceMetaTools(server: McpServer): void;

package/dist/mcp/schedule-tools.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerScheduleTools(server: McpServer): void;

package/dist/mcp/server.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function buildServer(): McpServer;
+/** @deprecated Use buildServer() — kept for internal imports during migration */
+export declare const server: McpServer;