@thinkwell/acp 0.5.0-alpha.1 → 0.5.0-alpha.2

package/dist/index.d.ts

@@ -6,4 +6,8 @@ export { ActiveSession, SessionBuilder } from "./session.js";
 export type { SessionUpdate, PromptMessage, McpReadyOptions } from "./session.js";
 export { SacpConnection, connect, connectToConductor } from "./connection.js";
 export type { SessionOptions } from "./connection.js";
+export { parseSkillMd, validateSkillName, validateSkillDescription } from "./skill.js";
+export type { Skill, VirtualSkill, StoredSkill, SkillTool } from "./skill.js";
+export { createSkillServer } from "./skill-server.js";
+export type { ResolvedSkill } from "./skill-server.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,UAAU,EACV,cAAc,EACd,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,QAAQ,EACR,yBAAyB,EACzB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,WAAW,EACX,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC7D,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGlF,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,UAAU,EACV,cAAc,EACd,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,QAAQ,EACR,yBAAyB,EACzB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,WAAW,EACX,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvD,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAG9D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC7D,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGlF,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGtD,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACvF,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -6,4 +6,8 @@ export { McpOverAcpHandler } from "./mcp-over-acp-handler.js";
 export { ActiveSession, SessionBuilder } from "./session.js";
 // Connection
 export { SacpConnection, connect, connectToConductor } from "./connection.js";
+// Skills
+export { parseSkillMd, validateSkillName, validateSkillDescription } from "./skill.js";
+// Skill MCP Server
+export { createSkillServer } from "./skill-server.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAyBA,aAAa;AACb,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEzE,uBAAuB;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,UAAU;AACV,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG7D,aAAa;AACb,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAyBA,aAAa;AACb,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEzE,uBAAuB;AACvB,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,UAAU;AACV,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG7D,aAAa;AACb,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAG9E,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAGvF,mBAAmB;AACnB,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/skill-server.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Skill MCP server builder.
+ *
+ * Creates an MCP server that exposes three tools for skill interaction:
+ * - activate_skill: returns a skill's instruction body
+ * - call_skill_tool: dispatches to a virtual skill's tool handler
+ * - read_skill_file: reads a file from a stored skill's basePath
+ *
+ * These tools are registered as standard MCP tools but are intended to be
+ * hidden from the prompt (via ThinkBuilder's defineTool pattern).
+ */
+import type { McpServer } from "./mcp-server.js";
+import type { VirtualSkill, StoredSkill } from "./skill.js";
+/** A resolved skill is either a VirtualSkill or a StoredSkill. */
+export type ResolvedSkill = VirtualSkill | StoredSkill;
+/**
+ * Build an MCP server that provides skill tools.
+ *
+ * @param skills - resolved skills (virtual or stored) to make available
+ * @returns an McpServer with activate_skill, call_skill_tool, and read_skill_file tools
+ */
+export declare function createSkillServer(skills: ResolvedSkill[]): McpServer;
+//# sourceMappingURL=skill-server.d.ts.map

package/dist/skill-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-server.d.ts","sourceRoot":"","sources":["../src/skill-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE5D,kEAAkE;AAClE,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,WAAW,CAAC;AAOvD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,SAAS,CAmGpE"}

package/dist/skill-server.js

@@ -0,0 +1,96 @@
+/**
+ * Skill MCP server builder.
+ *
+ * Creates an MCP server that exposes three tools for skill interaction:
+ * - activate_skill: returns a skill's instruction body
+ * - call_skill_tool: dispatches to a virtual skill's tool handler
+ * - read_skill_file: reads a file from a stored skill's basePath
+ *
+ * These tools are registered as standard MCP tools but are intended to be
+ * hidden from the prompt (via ThinkBuilder's defineTool pattern).
+ */
+import { readFile } from "node:fs/promises";
+import { resolve, relative, isAbsolute } from "node:path";
+import { mcpServer } from "./mcp-server.js";
+/** Type guard for StoredSkill (has basePath). */
+function isStoredSkill(skill) {
+    return "basePath" in skill && typeof skill.basePath === "string";
+}
+/**
+ * Build an MCP server that provides skill tools.
+ *
+ * @param skills - resolved skills (virtual or stored) to make available
+ * @returns an McpServer with activate_skill, call_skill_tool, and read_skill_file tools
+ */
+export function createSkillServer(skills) {
+    const skillsByName = new Map();
+    for (const skill of skills) {
+        skillsByName.set(skill.name, skill);
+    }
+    return mcpServer("skills")
+        .tool("activate_skill", "Activate a skill by name, returning its full instructions.", {
+        type: "object",
+        properties: {
+            skill_name: { type: "string", description: "The name of the skill to activate" },
+        },
+        required: ["skill_name"],
+    }, { type: "string" }, async (input) => {
+        const skill = skillsByName.get(input.skill_name);
+        if (!skill) {
+            throw new Error(`Unknown skill: "${input.skill_name}"`);
+        }
+        return skill.body;
+    })
+        .tool("call_skill_tool", "Call a tool provided by a skill.", {
+        type: "object",
+        properties: {
+            skill_name: { type: "string", description: "The name of the skill that provides the tool" },
+            tool_name: { type: "string", description: "The name of the tool to call" },
+            input: { description: "Input to pass to the tool handler" },
+        },
+        required: ["skill_name", "tool_name"],
+    }, {}, async (input) => {
+        const skill = skillsByName.get(input.skill_name);
+        if (!skill) {
+            throw new Error(`Unknown skill: "${input.skill_name}"`);
+        }
+        const tools = skill.tools;
+        if (!tools || tools.length === 0) {
+            throw new Error(`Skill "${input.skill_name}" has no tools`);
+        }
+        const tool = tools.find((t) => t.name === input.tool_name);
+        if (!tool) {
+            throw new Error(`Unknown tool "${input.tool_name}" for skill "${input.skill_name}"`);
+        }
+        return tool.handler(input.input);
+    })
+        .tool("read_skill_file", "Read a file from a stored skill's directory.", {
+        type: "object",
+        properties: {
+            skill_name: { type: "string", description: "The name of the skill" },
+            path: { type: "string", description: "Relative path to the file within the skill directory" },
+        },
+        required: ["skill_name", "path"],
+    }, { type: "string" }, async (input) => {
+        const skill = skillsByName.get(input.skill_name);
+        if (!skill) {
+            throw new Error(`Unknown skill: "${input.skill_name}"`);
+        }
+        if (!isStoredSkill(skill)) {
+            throw new Error(`Skill "${input.skill_name}" is not a stored skill (no basePath)`);
+        }
+        // Reject absolute paths outright
+        if (isAbsolute(input.path)) {
+            throw new Error("Path must be relative");
+        }
+        const resolved = resolve(skill.basePath, input.path);
+        // Path traversal check: resolved path must be within basePath
+        const rel = relative(skill.basePath, resolved);
+        if (rel.startsWith("..") || isAbsolute(rel)) {
+            throw new Error("Path traversal is not allowed");
+        }
+        return readFile(resolved, "utf-8");
+    })
+        .build();
+}
+//# sourceMappingURL=skill-server.js.map

package/dist/skill-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-server.js","sourceRoot":"","sources":["../src/skill-server.ts"],"names":[],"mappings":"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"}

package/dist/skill.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Skill types and SKILL.md parser for the Agent Skills standard.
+ *
+ * This module defines the core skill types and provides a parser for
+ * SKILL.md files (YAML frontmatter + Markdown body).
+ */
+/**
+ * A tool bundled with a virtual skill.
+ * Same trust model as ThinkBuilder's .tool() -- user-authored handler functions.
+ *
+ * Unlike top-level .tool() registrations, skill tools are not registered as
+ * individual MCP tools with formal schemas. Instead, the skill body documents
+ * available tools and their expected inputs as Markdown. The agent invokes them
+ * via the generic `call_skill_tool` dispatcher, which routes to the handler.
+ */
+export interface SkillTool<I = unknown, O = unknown> {
+    name: string;
+    description: string;
+    handler: (input: I) => Promise<O>;
+}
+/**
+ * Base skill definition: metadata + instructions.
+ */
+export interface Skill {
+    /** Skill name (lowercase, hyphens, matches directory name in the spec) */
+    name: string;
+    /** When to use this skill (max 1024 chars) */
+    description: string;
+    /** Full instruction content (Markdown body from SKILL.md) */
+    body: string;
+}
+/**
+ * A virtual skill defined programmatically, with optional handler functions
+ * dispatched via `call_skill_tool`.
+ */
+export interface VirtualSkill extends Skill {
+    tools?: SkillTool[];
+}
+/**
+ * A stored skill loaded from a SKILL.md file on the filesystem.
+ * The basePath is used to serve reference docs and assets via `read_skill_file`.
+ */
+export interface StoredSkill extends Skill {
+    basePath: string;
+}
+/**
+ * Validate a skill name per the Agent Skills spec.
+ * - 1-64 characters
+ * - Lowercase alphanumeric + hyphens
+ * - No leading, trailing, or consecutive hyphens
+ */
+export declare function validateSkillName(name: unknown): asserts name is string;
+/**
+ * Validate a skill description per the Agent Skills spec.
+ * - 1-1024 characters
+ * - Non-empty (after trimming)
+ */
+export declare function validateSkillDescription(description: unknown): asserts description is string;
+/**
+ * Parse a SKILL.md file content into a Skill.
+ *
+ * Extracts YAML frontmatter (delimited by `---`), validates required fields
+ * (name, description), and returns the parsed skill with the Markdown body.
+ *
+ * Optional frontmatter fields (license, compatibility, metadata) are preserved
+ * in the returned object but not acted upon.
+ *
+ * @throws Error if frontmatter is missing, malformed, or required fields are invalid
+ */
+export declare function parseSkillMd(content: string): Skill & Record<string, unknown>;
+//# sourceMappingURL=skill.d.ts.map

package/dist/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;GAQG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,KAAK;IACzC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,KAAK;IACxC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAWD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,IAAI,MAAM,CAYvE;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,IAAI,MAAM,CAS5F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAa7E"}

package/dist/skill.js

@@ -0,0 +1,117 @@
+/**
+ * Skill types and SKILL.md parser for the Agent Skills standard.
+ *
+ * This module defines the core skill types and provides a parser for
+ * SKILL.md files (YAML frontmatter + Markdown body).
+ */
+/** Validation pattern for skill names: lowercase alphanumeric + hyphens, no leading/trailing/consecutive hyphens. */
+const SKILL_NAME_PATTERN = /^[a-z0-9](?:[a-z0-9]|-(?=[a-z0-9]))*$/;
+/** Maximum length for skill names. */
+const MAX_NAME_LENGTH = 64;
+/** Maximum length for skill descriptions. */
+const MAX_DESCRIPTION_LENGTH = 1024;
+/**
+ * Validate a skill name per the Agent Skills spec.
+ * - 1-64 characters
+ * - Lowercase alphanumeric + hyphens
+ * - No leading, trailing, or consecutive hyphens
+ */
+export function validateSkillName(name) {
+    if (typeof name !== "string" || name.length === 0) {
+        throw new Error("Skill name is required");
+    }
+    if (name.length > MAX_NAME_LENGTH) {
+        throw new Error(`Skill name must be at most ${MAX_NAME_LENGTH} characters, got ${name.length}`);
+    }
+    if (!SKILL_NAME_PATTERN.test(name)) {
+        throw new Error(`Invalid skill name "${name}": must be lowercase alphanumeric with hyphens, no leading/trailing/consecutive hyphens`);
+    }
+}
+/**
+ * Validate a skill description per the Agent Skills spec.
+ * - 1-1024 characters
+ * - Non-empty (after trimming)
+ */
+export function validateSkillDescription(description) {
+    if (typeof description !== "string" || description.trim().length === 0) {
+        throw new Error("Skill description is required");
+    }
+    if (description.length > MAX_DESCRIPTION_LENGTH) {
+        throw new Error(`Skill description must be at most ${MAX_DESCRIPTION_LENGTH} characters, got ${description.length}`);
+    }
+}
+/**
+ * Parse a SKILL.md file content into a Skill.
+ *
+ * Extracts YAML frontmatter (delimited by `---`), validates required fields
+ * (name, description), and returns the parsed skill with the Markdown body.
+ *
+ * Optional frontmatter fields (license, compatibility, metadata) are preserved
+ * in the returned object but not acted upon.
+ *
+ * @throws Error if frontmatter is missing, malformed, or required fields are invalid
+ */
+export function parseSkillMd(content) {
+    const { frontmatter, body } = extractFrontmatter(content);
+    const fields = parseYamlFrontmatter(frontmatter);
+    validateSkillName(fields.name);
+    validateSkillDescription(fields.description);
+    return {
+        ...fields,
+        name: fields.name,
+        description: fields.description,
+        body,
+    };
+}
+/**
+ * Extract YAML frontmatter and body from a SKILL.md string.
+ * Frontmatter is delimited by opening and closing `---` lines.
+ */
+function extractFrontmatter(content) {
+    const trimmed = content.trimStart();
+    if (!trimmed.startsWith("---")) {
+        throw new Error("SKILL.md must begin with YAML frontmatter (---)");
+    }
+    // Find the closing `---` after the opening one
+    const endIndex = trimmed.indexOf("\n---", 3);
+    if (endIndex === -1) {
+        throw new Error("SKILL.md frontmatter is missing closing ---");
+    }
+    const frontmatter = trimmed.slice(3, endIndex).trim();
+    // Body starts after the closing `---` and its newline
+    const afterClosing = endIndex + 4; // "\n---".length
+    // Strip the line ending after the closing --- and any single blank line
+    const body = trimmed.slice(afterClosing).replace(/^(\r?\n){1,2}/, "");
+    return { frontmatter, body };
+}
+/**
+ * Minimal YAML parser for SKILL.md frontmatter.
+ *
+ * Supports only the flat key-value structure needed for skill metadata:
+ * simple string values (quoted or unquoted). This is intentionally limited --
+ * we don't need nested objects, arrays, or other YAML features.
+ */
+function parseYamlFrontmatter(yaml) {
+    const result = {};
+    for (const line of yaml.split("\n")) {
+        const trimmed = line.trim();
+        if (trimmed === "" || trimmed.startsWith("#"))
+            continue;
+        const colonIndex = trimmed.indexOf(":");
+        if (colonIndex === -1) {
+            throw new Error(`Invalid frontmatter line: ${trimmed}`);
+        }
+        const key = trimmed.slice(0, colonIndex).trim();
+        let value = trimmed.slice(colonIndex + 1).trim();
+        // Strip surrounding quotes (single or double)
+        if (typeof value === "string") {
+            if ((value.startsWith('"') && value.endsWith('"')) ||
+                (value.startsWith("'") && value.endsWith("'"))) {
+                value = value.slice(1, -1);
+            }
+        }
+        result[key] = value;
+    }
+    return result;
+}
+//# sourceMappingURL=skill.js.map

package/dist/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thinkwell/acp",
-  "version": "0.5.0-alpha.1",
+  "version": "0.5.0-alpha.2",
   "description": "TypeScript implementation of ACP (Agent Client Protocol) extensions for Thinkwell",
   "type": "module",
   "main": "./dist/index.js",
@@ -27,8 +27,8 @@
   "dependencies": {
     "@agentclientprotocol/sdk": "^0.4.0",
     "uuid": "^11.0.3",
-    "@thinkwell/conductor": "0.5.0-alpha.1",
-    "@thinkwell/protocol": "0.5.0-alpha.1"
+    "@thinkwell/conductor": "0.5.0-alpha.2",
+    "@thinkwell/protocol": "0.5.0-alpha.2"
   },
   "devDependencies": {
     "@types/node": "^24.10.4",