@withpica/mcp-server 2.51.0 → 2.52.0

package/dist/tools/sharing.js

@@ -1,131 +0,0 @@
-// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
-import { formatSuccess } from "@withpica/mcp-utils";
-export class SharingTools {
-    pica;
-    constructor(pica) {
-        this.pica = pica;
-    }
-    getTools() {
-        return [
-            {
-                definition: {
-                    name: "pica_share_trace",
-                    tier: "read",
-                    description: "Use when the user asks: 'why does Tony have access to this song?', 'who can see this work?', 'how did this person see my recording?'. " +
-                        "Returns the chain of reasons a viewer (user or org) can see an entity. " +
-                        "Composes four substrates — org membership, custody chain, share links, cross-org grants — and ranks reasons by directness. " +
-                        "Two-axis access: 403 INSUFFICIENT_SCOPE if you don't own the entity; has_access:false with reasons:[] when you DO own it but the viewer can't see. " +
-                        "→ then: pica_share_links_list / pica_share_links_revoke (revoke a share_link reason), pica_works_inspect / pica_recordings_inspect (verify state)",
-                    workflows: "infrastructure",
-                    vernacular_kind: "creator-entry",
-                    inputSchema: {
-                        type: "object",
-                        properties: {
-                            entity_type: {
-                                type: "string",
-                                enum: ["work", "recording", "person"],
-                                description: "What kind of entity to trace access to. Persons only support the org_membership substrate (no work-scoped reasons apply).",
-                            },
-                            entity_id: {
-                                type: "string",
-                                description: "UUID of the work, recording, or person.",
-                            },
-                            viewer_user_id: {
-                                type: "string",
-                                description: "UUID of the user whose access we're tracing. Supply EITHER viewer_user_id OR viewer_org_id, not both.",
-                            },
-                            viewer_org_id: {
-                                type: "string",
-                                description: "UUID of the org whose access we're tracing. Supply EITHER viewer_user_id OR viewer_org_id, not both.",
-                            },
-                        },
-                        required: ["entity_type", "entity_id"],
-                    },
-                    nextSteps: [
-                        {
-                            tool: "pica_share_links_list",
-                            reason: "When the trace surfaces a share_link reason, list links for the work to find the right one to revoke.",
-                            when: "on_success",
-                        },
-                        {
-                            tool: "pica_works_inspect",
-                            reason: "Inspect the work to see related metadata when investigating sharing.",
-                            when: "on_success",
-                        },
-                    ],
-                },
-                executor: this.shareTrace.bind(this),
-            },
-        ];
-    }
-    async shareTrace(args) {
-        const entityType = args.entity_type;
-        const entityId = args.entity_id;
-        const viewerUserId = args.viewer_user_id;
-        const viewerOrgId = args.viewer_org_id;
-        if (!entityType ||
-            !["work", "recording", "person"].includes(entityType)) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "entity_type must be 'work', 'recording', or 'person'.",
-                    },
-                ],
-                isError: true,
-            };
-        }
-        if (!entityId) {
-            return {
-                content: [{ type: "text", text: "entity_id is required." }],
-                isError: true,
-            };
-        }
-        if (Boolean(viewerUserId) === Boolean(viewerOrgId)) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "supply exactly one of viewer_user_id or viewer_org_id.",
-                    },
-                ],
-                isError: true,
-            };
-        }
-        try {
-            const result = await this.pica.shareTrace.trace({
-                entity_type: entityType,
-                entity_id: entityId,
-                viewer_user_id: viewerUserId,
-                viewer_org_id: viewerOrgId,
-            });
-            const verdict = result.has_access
-                ? `Access via ${result.reasons.length} reason${result.reasons.length === 1 ? "" : "s"} (most-direct: ${result.reasons[0]?.kind})`
-                : "No access — viewer cannot see this entity";
-            return formatSuccess(verdict, result);
-        }
-        catch (err) {
-            const errorMessage = err instanceof Error ? err.message : String(err);
-            // 403 INSUFFICIENT_SCOPE bubbles up as a fetch error from the
-            // SDK — surface it without leaking entity existence.
-            if (/INSUFFICIENT_SCOPE|insufficient_scope|403/i.test(errorMessage)) {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `entity is not in scope for this organisation — only the entity's owning org can trace its sharing graph.`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-            return {
-                content: [
-                    { type: "text", text: `Failed to trace sharing: ${errorMessage}` },
-                ],
-                isError: true,
-            };
-        }
-    }
-}
-//# sourceMappingURL=sharing.js.map

package/dist/tools/sharing.js.map

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

package/dist/tools/skills.d.ts

@@ -1,25 +0,0 @@
-/**
- * Skill tools — ADR-140 Phase 2b
- *
- * Two meta-tools, not N wrapper tools (which would inflate the registry and
- * load every body eagerly). Mirrors the _inspect-sections lazy-slicing shape:
- *   - pica_skill_list — tiny summary (names + triggers + audience), cheap
- *   - pica_skill_get   — full methodology body, loaded only on demand
- *
- * The same content is reachable via skill:// resources (SEP-2640 bridge),
- * so clients that natively read skill:// URIs don't need these tools — but
- * every current client supports tools and not every client reads skill://
- * yet, so the tool lane is the today-it-works fallback.
- */
-import { ToolDefinition, ToolExecutor } from "./index.js";
-export declare class SkillsTools {
-    private registry;
-    constructor();
-    getTools(): Array<{
-        definition: ToolDefinition;
-        executor: ToolExecutor;
-    }>;
-    private listSkills;
-    private getSkill;
-}
-//# sourceMappingURL=skills.d.ts.map

package/dist/tools/skills.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/tools/skills.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,cAAc,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAGtE,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAiB;;IAMjC,QAAQ,IAAI,KAAK,CAAC;QAAE,UAAU,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE,CAAC;YAsD3D,UAAU;YAsBV,QAAQ;CAkEvB"}

package/dist/tools/skills.js

@@ -1,144 +0,0 @@
-// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
-import { SkillsRegistry, SkillNotFoundError } from "../skills/index.js";
-export class SkillsTools {
-    registry;
-    constructor() {
-        this.registry = new SkillsRegistry();
-    }
-    getTools() {
-        return [
-            {
-                definition: {
-                    name: "pica_skill_list",
-                    tier: "read",
-                    description: "Use when the user asks: 'what catalog workflows are available?', 'what can you help me do with my songs?', 'show me my workflow options'. " +
-                        "Returns the list of downloadable PICA skill methodologies — name, one-line description, and trigger phrases. " +
-                        "Cheap to call. Use pica_skill_get(name) to load a specific skill's full methodology body when you're ready to follow it.",
-                    workflows: "infrastructure",
-                    vernacular_kind: "creator-entry",
-                    inputSchema: {
-                        type: "object",
-                        properties: {},
-                        additionalProperties: false,
-                    },
-                    annotations: {
-                        readOnlyHint: true,
-                    },
-                },
-                executor: this.listSkills.bind(this),
-            },
-            {
-                definition: {
-                    name: "pica_skill_get",
-                    tier: "read",
-                    description: "Use when the user asks: 'audit my catalog', 'register my songs', 'prepare for sync', 'set up my workspace', 'close the loop on this song'. " +
-                        "Returns the full methodology body for one skill — markdown with step-by-step instructions, tool chains, and offer scripts. " +
-                        "Call pica_skill_list first to see available skill names, then pica_skill_get to load one. Read once at the start of the workflow; do not re-fetch on every step.",
-                    workflows: "infrastructure",
-                    vernacular_kind: "creator-entry",
-                    inputSchema: {
-                        type: "object",
-                        properties: {
-                            name: {
-                                type: "string",
-                                description: "Kebab-case skill name from pica_skill_list (e.g. 'catalog-audit', 'register-my-works', 'prepare-for-sync').",
-                            },
-                        },
-                        required: ["name"],
-                        additionalProperties: false,
-                    },
-                    annotations: {
-                        readOnlyHint: true,
-                    },
-                },
-                executor: this.getSkill.bind(this),
-            },
-        ];
-    }
-    async listSkills(_args) {
-        const skills = this.registry.listSkills();
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: skills.length
-                        ? `Available skills (${skills.length}):\n\n` +
-                            skills
-                                .map((s) => `- ${s.name} — ${s.description}\n  triggers: ${s.triggers.join(", ")}\n  audience: ${s.audience}`)
-                                .join("\n\n") +
-                            "\n\nCall pica_skill_get(name) to load a skill's full methodology."
-                        : "No skills available.",
-                },
-            ],
-            structuredContent: { skills },
-        };
-    }
-    async getSkill(args) {
-        const name = String(args?.name ?? "").trim();
-        if (!name) {
-            return {
-                isError: true,
-                content: [
-                    {
-                        type: "text",
-                        text: "Missing required argument: name. Call pica_skill_list to see available skill names.",
-                    },
-                ],
-            };
-        }
-        let skill;
-        try {
-            skill = this.registry.getSkill(name);
-        }
-        catch (err) {
-            if (err instanceof SkillNotFoundError) {
-                return {
-                    isError: true,
-                    content: [
-                        {
-                            type: "text",
-                            text: `Skill not found: ${name}. Call pica_skill_list to see available skill names.`,
-                        },
-                    ],
-                };
-            }
-            throw err;
-        }
-        const frontmatterSummary = [
-            `# ${skill.name}`,
-            "",
-            `**Description:** ${skill.description}`,
-            `**Audience:** ${skill.audience}`,
-            `**Triggers:** ${skill.triggers.join(", ")}`,
-            `**Tools used:** ${skill.tools_required.join(", ")}`,
-            `**Output:** ${skill.output}`,
-            "",
-            "---",
-            "",
-        ].join("\n");
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: frontmatterSummary + skill.body,
-                },
-                {
-                    type: "resource_link",
-                    uri: `skill://withpica/${skill.name}/SKILL.md`,
-                    name: `Skill — ${skill.name}`,
-                    description: skill.description,
-                    mimeType: "text/markdown",
-                },
-            ],
-            structuredContent: {
-                name: skill.name,
-                description: skill.description,
-                triggers: skill.triggers,
-                audience: skill.audience,
-                tools_required: skill.tools_required,
-                output: skill.output,
-            },
-        };
-    }
-}
-//# sourceMappingURL=skills.js.map

package/dist/tools/skills.js.map

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

package/scripts/build-skills.ts

@@ -1,229 +0,0 @@
-// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
-
-/**
- * ADR-140 Phase 2b — generator for `skills.generated.ts`.
- *
- * Reads `src/skills/<name>/SKILL.md` files, parses YAML frontmatter, and emits
- * a TypeScript constant consumed by SkillsRegistry. Generation at build time
- * (not runtime FS reads) so npm-published `dist/` ships bundled bytes — `.md`
- * files are excluded by `.npmignore`.
- *
- * Frontmatter shape:
- *   ---
- *   name: kebab-case-name
- *   description: one-line
- *   triggers:
- *     - phrase one
- *     - phrase two
- *   audience: manager / artist / etc
- *   tools_required:
- *     - tool_a
- *     - tool_b
- *   output: one-line description
- *   ---
- *
- * Hand-rolled YAML parser (frontmatter only — no nested objects, no anchors).
- * Adding a `js-yaml` dep would be overkill for the constrained shape.
- *
- * Re-runs are deterministic: same .md files produce a byte-identical output.
- */
-
-import { readFileSync, readdirSync, writeFileSync, existsSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const MCP_SERVER_ROOT = join(__dirname, "..");
-const SKILLS_ROOT = join(MCP_SERVER_ROOT, "src/skills");
-const OUTPUT_PATH = join(SKILLS_ROOT, "skills.generated.ts");
-
-interface SkillFrontmatter {
-  name: string;
-  description: string;
-  triggers: string[];
-  audience: string;
-  tools_required: string[];
-  output: string;
-}
-
-interface ParsedSkill extends SkillFrontmatter {
-  body: string;
-}
-
-function parseFrontmatter(src: string, sourceFile: string): ParsedSkill {
-  // Strip leading HTML comment (copyright header) if present, then expect ---
-  let i = 0;
-  if (src.startsWith("<!--")) {
-    const end = src.indexOf("-->");
-    if (end === -1) {
-      throw new Error(`${sourceFile}: unterminated HTML comment header`);
-    }
-    i = end + 3;
-    // Skip whitespace/newlines
-    while (i < src.length && /\s/.test(src[i])) i++;
-  }
-
-  if (src.slice(i, i + 3) !== "---") {
-    throw new Error(`${sourceFile}: missing --- frontmatter opener`);
-  }
-  i += 3;
-  // Skip newline after opener
-  while (i < src.length && src[i] !== "\n") i++;
-  i++;
-
-  const closeIdx = src.indexOf("\n---", i);
-  if (closeIdx === -1) {
-    throw new Error(`${sourceFile}: missing --- frontmatter closer`);
-  }
-
-  const frontmatterText = src.slice(i, closeIdx);
-  const bodyStart = closeIdx + 4; // skip \n---
-  const body = src.slice(bodyStart).replace(/^\n+/, "").trimEnd() + "\n";
-
-  // Parse: key: value OR key: (list follows)
-  const fm: Record<string, string | string[]> = {};
-  const lines = frontmatterText.split("\n");
-  let currentListKey: string | null = null;
-
-  for (const line of lines) {
-    if (line.trim() === "") {
-      currentListKey = null;
-      continue;
-    }
-    const listItemMatch = line.match(/^\s+-\s+(.+)$/);
-    if (listItemMatch && currentListKey) {
-      (fm[currentListKey] as string[]).push(listItemMatch[1].trim());
-      continue;
-    }
-    const kvMatch = line.match(/^([a-z_][a-z0-9_]*)\s*:\s*(.*)$/i);
-    if (!kvMatch) continue;
-    const key = kvMatch[1];
-    const value = kvMatch[2].trim();
-    if (value === "") {
-      // List follows
-      fm[key] = [];
-      currentListKey = key;
-    } else {
-      fm[key] = value;
-      currentListKey = null;
-    }
-  }
-
-  // Validate required fields
-  const required = [
-    "name",
-    "description",
-    "triggers",
-    "audience",
-    "tools_required",
-    "output",
-  ];
-  for (const field of required) {
-    if (!(field in fm)) {
-      throw new Error(`${sourceFile}: missing required frontmatter field "${field}"`);
-    }
-  }
-  if (!Array.isArray(fm.triggers) || fm.triggers.length === 0) {
-    throw new Error(`${sourceFile}: triggers must be a non-empty list`);
-  }
-  if (!Array.isArray(fm.tools_required) || fm.tools_required.length === 0) {
-    throw new Error(`${sourceFile}: tools_required must be a non-empty list`);
-  }
-
-  return {
-    name: fm.name as string,
-    description: fm.description as string,
-    triggers: fm.triggers as string[],
-    audience: fm.audience as string,
-    tools_required: fm.tools_required as string[],
-    output: fm.output as string,
-    body,
-  };
-}
-
-function discoverSkills(): ParsedSkill[] {
-  if (!existsSync(SKILLS_ROOT)) {
-    return [];
-  }
-  const entries = readdirSync(SKILLS_ROOT, { withFileTypes: true });
-  const skills: ParsedSkill[] = [];
-  for (const entry of entries) {
-    if (!entry.isDirectory()) continue;
-    const skillFile = join(SKILLS_ROOT, entry.name, "SKILL.md");
-    if (!existsSync(skillFile)) continue;
-    const src = readFileSync(skillFile, "utf-8");
-    const parsed = parseFrontmatter(src, `src/skills/${entry.name}/SKILL.md`);
-    if (parsed.name !== entry.name) {
-      throw new Error(
-        `src/skills/${entry.name}/SKILL.md: frontmatter name "${parsed.name}" must match directory name "${entry.name}"`,
-      );
-    }
-    skills.push(parsed);
-  }
-  skills.sort((a, b) => a.name.localeCompare(b.name));
-  return skills;
-}
-
-function emit(skills: ParsedSkill[]): string {
-  const header = `// Copyright (c) 2024-2026 Withpica Ltd. All rights reserved.
-
-/**
- * GENERATED FILE — DO NOT EDIT BY HAND.
- *
- * Regenerated by \`scripts/build-skills.ts\` from \`src/skills/<name>/SKILL.md\`.
- * Runs in \`prebuild\` and \`prepublishOnly\`. See ADR-140 Phase 2b.
- */
-
-export interface Skill {
-  /** Stable kebab-case identifier matching the directory name. */
-  name: string;
-  /** One-line description shown in pica_skill_list. */
-  description: string;
-  /** Trigger phrases an agent should recognise as invoking this skill. */
-  triggers: string[];
-  /** Audience tag (manager / artist / sync supervisor / etc). */
-  audience: string;
-  /** Tools the skill body chains. Lint-checkable. */
-  tools_required: string[];
-  /** One-line output shape description. */
-  output: string;
-  /** Full skill methodology body — markdown, exposed by pica_skill_get. */
-  body: string;
-}
-
-`;
-  const lines: string[] = [header, "export const SKILLS: Record<string, Skill> = {"];
-  for (const skill of skills) {
-    lines.push(`  ${JSON.stringify(skill.name)}: {`);
-    lines.push(`    name: ${JSON.stringify(skill.name)},`);
-    lines.push(`    description: ${JSON.stringify(skill.description)},`);
-    lines.push(`    triggers: ${JSON.stringify(skill.triggers)},`);
-    lines.push(`    audience: ${JSON.stringify(skill.audience)},`);
-    lines.push(`    tools_required: ${JSON.stringify(skill.tools_required)},`);
-    lines.push(`    output: ${JSON.stringify(skill.output)},`);
-    lines.push(`    body: ${JSON.stringify(skill.body)},`);
-    lines.push(`  },`);
-  }
-  lines.push("};");
-  lines.push("");
-  lines.push(
-    `export const SKILL_NAMES: ReadonlyArray<string> = ${JSON.stringify(skills.map((s) => s.name))};`,
-  );
-  lines.push("");
-  return lines.join("\n");
-}
-
-function main(): void {
-  const skills = discoverSkills();
-  const output = emit(skills);
-  writeFileSync(OUTPUT_PATH, output, "utf-8");
-  console.log(
-    `[build-skills] Wrote ${skills.length} skill(s) to src/skills/skills.generated.ts`,
-  );
-  for (const skill of skills) {
-    console.log(`  - ${skill.name} (${skill.body.length} bytes body)`);
-  }
-}
-
-main();