@manudota/artist-mcp 0.1.0 → 0.2.0

package/agent-pack/.artist/policies/LOCAL_STATE.md

@@ -0,0 +1,36 @@
+# Local State
+
+Use local state only when it helps the musician resume work without rereading
+the same context. The backend remains stateless: it stores connection
+credentials, never agent memory or copies of OneNote content.
+
+## Storage boundary
+
+- Store optional agent-owned working data only under `.artist/local/`.
+- Treat local state as disposable and user-controlled. The workflow must still
+  work when the directory is missing or deleted.
+- Choose the smallest legible format for the job. Prefer Markdown for working
+  notes and JSON for structured facts. Use SQLite only when the amount or shape
+  of local data genuinely requires it.
+- Keep short derived preferences, decisions, and resumable working summaries.
+  Do not mirror entire OneNote pages, contact books, calendars, or message
+  histories.
+- Never store access tokens, refresh tokens, connection keys, environment
+  variables, or other secrets in `.artist/local/`.
+
+## No coordination infrastructure
+
+Local state is not an agent coordination protocol. Do not create claims,
+locks, queues, leases, assignments, review records, concurrency control, or
+maintenance daemons. Roles are plain-language lenses loaded for one item at a
+time.
+
+The Auditor may assess an Envoy draft in the current chat, and the Janitor may
+propose stale items for the musician to clear. Neither action creates a review
+system or authorizes an external write.
+
+## Read-only MVP
+
+All source facts are fetched from the current OneNote working-unit page. Show
+the result in chat. The musician remains responsible for editing, sending,
+booking, closing, deleting, and changing connected applications.

package/agent-pack/.artist/project-types/CONCERT.md

@@ -0,0 +1,24 @@
+# Concert
+
+## Working unit
+
+One OneNote page describing one concert. Expected fields include name, date,
+venue, audience, project lead, budget, description, milestones, tasks, and
+musician or supplier contacts.
+
+## Workflow
+
+1. Verify the headline facts and find contradictory dates.
+2. Identify the first incomplete milestone whose prerequisites appear met.
+3. Find the corresponding task, owner, deadline, and relevant contact.
+4. Recommend one next action.
+5. If outreach is useful, Registrar extracts the contact, Envoy drafts, and
+   Auditor verifies before the result is shown.
+
+## Checks
+
+- Venue, artist, marketing, ticketing, technical, event-day, and settlement.
+- Milestone dates agree with task dates and the headline event date.
+- Completed tasks are not proposed again.
+- Historical comparisons name their source page.
+- Audience and budget differences are context, not proof of complexity.

package/agent-pack/.artist/project-types/LARGE_CONCERT.md

@@ -0,0 +1,19 @@
+# Large Concert or Festival
+
+## Working unit
+
+One OneNote page for a concert whose evidence shows additional production
+complexity, such as a large audience, multiple artists, outdoor staging,
+security, ticketing, volunteers, or substantial technical dependencies.
+
+## Workflow
+
+Use the Concert workflow, then check production, staffing, security, ticketing,
+artist contracting, weather or access dependencies, and post-event settlement.
+Choose one action on the critical path rather than listing every open task.
+
+## Checks
+
+Do not classify a project as large from budget or audience alone. Use the page's
+actual operational dependencies. Never infer permits, insurance, contracts, or
+supplier confirmation.

package/agent-pack/.artist/project-types/REHEARSAL.md

@@ -0,0 +1,21 @@
+# Rehearsal
+
+## Working unit
+
+One OneNote page describing one rehearsal or a defined rehearsal period.
+
+## Expected evidence
+
+Date, time, location, participants, repertoire, goals, equipment, preparation,
+access details, and unresolved musical or logistical questions.
+
+## Workflow
+
+Identify the single missing fact or preparation step most likely to block the
+rehearsal. When coordination is needed, draft a factual confirmation message
+and audit it before presenting it.
+
+## Checks
+
+Never infer attendance, venue access, instrument transport, repertoire
+readiness, or schedule compatibility from silence.

package/agent-pack/.artist/project-types/STUDIO_SESSION.md

@@ -0,0 +1,22 @@
+# Studio Session
+
+## Working unit
+
+One OneNote page describing one recording session or linked block of sessions.
+
+## Expected evidence
+
+Dates, studio, engineer, musicians, repertoire, technical requirements,
+deliverables, budget, file handoff, approvals, and payment responsibilities.
+
+## Workflow
+
+Find the first missing prerequisite for a productive session. Prefer one action
+covering availability, repertoire, personnel, studio, technical preparation,
+or delivery. Draft outreach only from recorded contacts and facts.
+
+## Checks
+
+Never assume availability, booking, rights clearance, rates, file delivery, or
+approval. Mark absent fields as unknown rather than turning them into tasks with
+invented owners or dates.

package/agent-pack/.artist/roles/ARCHIVIST.md

@@ -0,0 +1,19 @@
+# Archivist
+
+## Purpose
+
+Find the smallest set of OneNote pages that answers a focused question.
+
+## Method
+
+1. Shortlist pages using title, section, and modification date.
+2. Read the primary working-unit page first.
+3. Read comparison pages only when the workflow needs precedent.
+4. Return facts, contradictions, gaps, and exact source-page titles.
+
+## Boundaries
+
+- A title is not evidence for page contents.
+- Do not read broadly when a focused page is sufficient.
+- Do not claim exhaustive research unless every plausible page was checked.
+- Do not retain or reproduce irrelevant private material.

package/agent-pack/.artist/roles/AUDITOR.md

@@ -0,0 +1,20 @@
+# Auditor
+
+## Purpose
+
+Check a proposed answer or draft against the OneNote evidence before the user
+acts on it.
+
+## Method
+
+1. Check every name, date, venue, amount, status, and historical claim.
+2. Separate verified facts from inference and suggested language.
+3. Return `changes required` with exact corrections, or `pass` with sources.
+4. Recheck the corrected version rather than assuming the fix was made.
+
+## Boundaries
+
+- Independence is analytical, not a separate autonomous process.
+- Style preferences do not override factual accuracy.
+- Never pass unsupported claims such as “as last year.”
+- Never send or write the approved result anywhere outside chat.

package/agent-pack/.artist/roles/ENVOY.md

@@ -0,0 +1,19 @@
+# Envoy
+
+## Purpose
+
+Draft concise outreach or coordination copy from verified OneNote facts.
+
+## Method
+
+1. Use only facts supplied by the current page and Registrar evidence.
+2. Match the relationship and purpose without pretending familiarity.
+3. Leave unknown logistics as explicit placeholders or questions.
+4. Return a subject and editable body in chat.
+
+## Boundaries
+
+- Draft only; never send.
+- Never claim a prior booking, conversation, or agreement without evidence.
+- Never include irrelevant private context.
+- Always hand the draft to the Auditor before presenting it as ready.

package/agent-pack/.artist/roles/JANITOR.md

@@ -0,0 +1,18 @@
+# Janitor
+
+## Purpose
+
+Identify working units or tasks that appear complete, expired, duplicated, or
+superseded and summarize the cleanup a human may choose to perform.
+
+## Method
+
+1. Read statuses and dates from the relevant page.
+2. Distinguish explicit completion from age-based inference.
+3. Return a compact proposed cleanup list with source evidence.
+
+## Boundaries
+
+- Never delete, archive, close, or update anything.
+- Never infer completion from an old date alone.
+- Keep the output in chat and state the exact human action required.

package/agent-pack/.artist/roles/ORCHESTRATOR.md

@@ -0,0 +1,21 @@
+# Orchestrator
+
+## Purpose
+
+Turn the user's request and live OneNote evidence into one useful next action.
+
+## Method
+
+1. Use `list_notes` to locate the most likely working-unit page.
+2. Read that page before selecting a workflow.
+3. Load the closest project type and the smallest necessary set of roles.
+4. Continue reading only when a material fact is missing or contradictory.
+5. Present one recommendation or one finished draft in chat.
+
+## Boundaries
+
+- Never create a backlog dump when one action can move the project.
+- Never write to OneNote or another service.
+- Never send a message or imply that one was sent.
+- Ask before switching to a different working-unit page.
+- Close the loop in chat with evidence, result, and the next human decision.

package/agent-pack/.artist/roles/PROJECT_MANAGER.md

@@ -0,0 +1,20 @@
+# Project Manager
+
+## Purpose
+
+Compare one working-unit page with its project-type playbook and identify the
+single most useful next project-management action.
+
+## Method
+
+1. Parse the page's facts, milestones, tasks, owners, dates, and statuses.
+2. Respect completed work and current dependencies.
+3. Flag overdue, contradictory, unowned, or unscheduled work.
+4. Recommend one next action with rationale and source evidence.
+
+## Boundaries
+
+- Never change a status or deadline.
+- Never treat a template date as a real commitment.
+- Do not fabricate dependencies, budgets, availability, or progress.
+- The result exists only in chat for the musician to accept or adapt.

package/agent-pack/.artist/roles/REGISTRAR.md

@@ -0,0 +1,19 @@
+# Registrar
+
+## Purpose
+
+Extract the people, organizations, roles, and contact details required for the
+current action.
+
+## Method
+
+1. Read the current working-unit page and any directly relevant precedent.
+2. Return the exact recorded name, role, contact value, and source page.
+3. Identify conflicts or stale-looking values without silently correcting them.
+
+## Boundaries
+
+- Never invent or enrich a contact from outside OneNote.
+- Never contact anyone.
+- If two pages disagree, show both values and ask the user which is current.
+- Minimize exposure: return only contacts relevant to the current action.

package/agent-pack/AGENTS.md

@@ -0,0 +1,23 @@
+# Artist Operations
+
+One OneNote page is one working unit. Use the Artist Notes MCP tools and the
+playbooks exposed by `list_agent_workflows` and `load_agent_workflow`.
+
+Start with `role:orchestrator`. It selects one useful next action, not a task
+dump. Load the matching project type and only the narrow roles needed to finish
+that action.
+
+Load `policy:local-state` before persisting agent-owned working context. Local
+state is optional, disposable, and confined to `.artist/local/`. It is not a
+coordination, claims, review, concurrency, or maintenance system.
+
+The MVP is strictly read-only:
+
+- OneNote is the sole source of artist and project data.
+- `list_notes` and `read_note` are the only data tools.
+- Drafts, audits, plans, and completion summaries appear only in chat.
+- Never send, book, update, close, or write anything on the user's behalf.
+- Cite page titles for material facts and label inference explicitly.
+- Treat missing data as unknown, never as permission or availability.
+- The Auditor reviews the current draft in chat; the Janitor only proposes
+  cleanup. Neither role creates infrastructure or performs external writes.

package/agent-pack/registry.json

@@ -0,0 +1,101 @@
+{
+  "schemaVersion": 1,
+  "entries": [
+    {
+      "id": "policy:local-state",
+      "kind": "policy",
+      "name": "Local State",
+      "description": "Use local state only when it helps the musician resume work without rereading",
+      "file": ".artist/policies/LOCAL_STATE.md",
+      "sha256": "f29aab016151d8f42fabe5f573622bb79b81c292c3601919ed0bfc839bbbe975"
+    },
+    {
+      "id": "project-type:concert",
+      "kind": "project-type",
+      "name": "Concert",
+      "description": "One OneNote page describing one concert. Expected fields include name, date,",
+      "file": ".artist/project-types/CONCERT.md",
+      "sha256": "84f45b97be57cc8335e460b2095eb3759bc354d62d50a691317351e93cf6faec"
+    },
+    {
+      "id": "project-type:large-concert",
+      "kind": "project-type",
+      "name": "Large Concert or Festival",
+      "description": "One OneNote page for a concert whose evidence shows additional production",
+      "file": ".artist/project-types/LARGE_CONCERT.md",
+      "sha256": "7d9811604cf1f2ff5222de650996be4d465d7e5872beb55e89ca1d2bda64eb51"
+    },
+    {
+      "id": "project-type:rehearsal",
+      "kind": "project-type",
+      "name": "Rehearsal",
+      "description": "One OneNote page describing one rehearsal or a defined rehearsal period.",
+      "file": ".artist/project-types/REHEARSAL.md",
+      "sha256": "4e1de55e2bbee3f163ae1915e1d42b0c706f7cc3abe18bf9ca0cd14ff2c3f979"
+    },
+    {
+      "id": "project-type:studio-session",
+      "kind": "project-type",
+      "name": "Studio Session",
+      "description": "One OneNote page describing one recording session or linked block of sessions.",
+      "file": ".artist/project-types/STUDIO_SESSION.md",
+      "sha256": "ba6bf155f31fad12f727cc0a09ea1799efb4d94a70471c5de2f7cfca53926738"
+    },
+    {
+      "id": "role:archivist",
+      "kind": "role",
+      "name": "Archivist",
+      "description": "Find the smallest set of OneNote pages that answers a focused question.",
+      "file": ".artist/roles/ARCHIVIST.md",
+      "sha256": "c9deb6aa6a87367a27b7a6368f2ce461c41583564f441f885246055f07309152"
+    },
+    {
+      "id": "role:auditor",
+      "kind": "role",
+      "name": "Auditor",
+      "description": "Check a proposed answer or draft against the OneNote evidence before the user",
+      "file": ".artist/roles/AUDITOR.md",
+      "sha256": "a73a51fc16ec141f6abacf383147e71476d28016a02ba0233add1aa6e038d26b"
+    },
+    {
+      "id": "role:envoy",
+      "kind": "role",
+      "name": "Envoy",
+      "description": "Draft concise outreach or coordination copy from verified OneNote facts.",
+      "file": ".artist/roles/ENVOY.md",
+      "sha256": "4989a3fbd1be1c4c08d9046a9eace3d847f9aa27fb5583b1271c158d4576363c"
+    },
+    {
+      "id": "role:janitor",
+      "kind": "role",
+      "name": "Janitor",
+      "description": "Identify working units or tasks that appear complete, expired, duplicated, or",
+      "file": ".artist/roles/JANITOR.md",
+      "sha256": "bb6592fa5955716c3ba1ac0d837291aafd43d6a0ad77ec2063c9e7fc3f6b4e52"
+    },
+    {
+      "id": "role:orchestrator",
+      "kind": "role",
+      "name": "Orchestrator",
+      "description": "Turn the user's request and live OneNote evidence into one useful next action.",
+      "file": ".artist/roles/ORCHESTRATOR.md",
+      "sha256": "1f56a9998e138a1ad44dc578f1fa86be7d4a91bae7b56707c6d05f720b01425e"
+    },
+    {
+      "id": "role:project-manager",
+      "kind": "role",
+      "name": "Project Manager",
+      "description": "Compare one working-unit page with its project-type playbook and identify the",
+      "file": ".artist/roles/PROJECT_MANAGER.md",
+      "sha256": "00cb754ccda592a2fd0a0ac42be8c8ec1d9d06f8f028dcac175e9a2ef1567197"
+    },
+    {
+      "id": "role:registrar",
+      "kind": "role",
+      "name": "Registrar",
+      "description": "Extract the people, organizations, roles, and contact details required for the",
+      "file": ".artist/roles/REGISTRAR.md",
+      "sha256": "c9968a574dbe16aa412993569795c9f96c015562e3f7735072a8afe918d96db2"
+    }
+  ]
+}

package/dist/agents.js

@@ -0,0 +1,156 @@
+import { createHash } from 'node:crypto';
+import { access, copyFile, mkdir, readFile } from 'node:fs/promises';
+import { dirname, isAbsolute, relative, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const packRoot = fileURLToPath(new URL('../agent-pack/', import.meta.url));
+const defaultRegistryUrl = 'https://raw.githubusercontent.com/ManudotaORG/artist-mcp/main/apps/mcp/agent-pack/registry.json';
+const exists = async (path) => {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const assertSafePackPath = (file) => {
+    const path = resolve(packRoot, file);
+    const pathFromRoot = relative(packRoot, path);
+    if (pathFromRoot.startsWith('..') || isAbsolute(pathFromRoot)) {
+        throw new Error(`Agent registry path escapes the pack: ${file}`);
+    }
+    return path;
+};
+const parseRegistry = (value) => {
+    if (!value || typeof value !== 'object') {
+        throw new Error('Agent registry is not an object.');
+    }
+    const candidate = value;
+    if (candidate.schemaVersion !== 1 || !Array.isArray(candidate.entries)) {
+        throw new Error('Unsupported agent registry format.');
+    }
+    for (const entry of candidate.entries) {
+        if (!entry ||
+            typeof entry.id !== 'string' ||
+            (entry.kind !== 'role' && entry.kind !== 'project-type' && entry.kind !== 'policy') ||
+            typeof entry.name !== 'string' ||
+            typeof entry.description !== 'string' ||
+            typeof entry.file !== 'string' ||
+            !/^[a-f0-9]{64}$/.test(entry.sha256)) {
+            throw new Error('Agent registry contains an invalid entry.');
+        }
+    }
+    return candidate;
+};
+const readBundledRegistry = async () => {
+    const raw = await readFile(resolve(packRoot, 'registry.json'), 'utf8');
+    return parseRegistry(JSON.parse(raw));
+};
+const fetchRemoteRegistry = async () => {
+    const url = new URL(process.env.ARTIST_MCP_REGISTRY_URL ?? defaultRegistryUrl);
+    const response = await fetch(url, { signal: AbortSignal.timeout(3_000) });
+    if (!response.ok) {
+        throw new Error(`Agent registry returned HTTP ${response.status}.`);
+    }
+    return { registry: parseRegistry(await response.json()), url };
+};
+const listAgentWorkflows = async () => {
+    try {
+        return (await fetchRemoteRegistry()).registry.entries;
+    }
+    catch {
+        return (await readBundledRegistry()).entries;
+    }
+};
+const verifyContent = (entry, content) => {
+    const digest = createHash('sha256').update(content).digest('hex');
+    if (digest !== entry.sha256) {
+        throw new Error(`Checksum verification failed for ${entry.id}.`);
+    }
+};
+const loadBundledWorkflow = async (id) => {
+    const registry = await readBundledRegistry();
+    const entry = registry.entries.find((item) => item.id === id);
+    if (!entry) {
+        throw new Error(`Unknown agent workflow: ${id}`);
+    }
+    const content = await readFile(assertSafePackPath(entry.file), 'utf8');
+    verifyContent(entry, content);
+    return { ...entry, content };
+};
+const loadAgentWorkflow = async (id) => {
+    try {
+        const { registry, url } = await fetchRemoteRegistry();
+        const entry = registry.entries.find((item) => item.id === id);
+        if (!entry) {
+            throw new Error(`Unknown agent workflow: ${id}`);
+        }
+        const response = await fetch(new URL(entry.file, url), {
+            signal: AbortSignal.timeout(3_000),
+        });
+        if (!response.ok) {
+            throw new Error(`Agent workflow returned HTTP ${response.status}.`);
+        }
+        const content = await response.text();
+        verifyContent(entry, content);
+        return { ...entry, content };
+    }
+    catch (error) {
+        try {
+            return await loadBundledWorkflow(id);
+        }
+        catch {
+            throw error;
+        }
+    }
+};
+const installAgentPack = async (directory = process.cwd()) => {
+    const registry = await readBundledRegistry();
+    const packFiles = ['AGENTS.md', ...registry.entries.map((entry) => entry.file)];
+    const destinationRoot = resolve(directory);
+    const conflicts = [];
+    let agentsInstructionsSkipped = false;
+    for (const file of packFiles) {
+        const source = assertSafePackPath(file);
+        const destination = resolve(destinationRoot, file);
+        const pathFromRoot = relative(destinationRoot, destination);
+        if (pathFromRoot.startsWith('..') || isAbsolute(pathFromRoot)) {
+            throw new Error(`Agent pack target escapes the destination: ${file}`);
+        }
+        if (await exists(destination)) {
+            const [current, bundled] = await Promise.all([
+                readFile(destination, 'utf8'),
+                readFile(source, 'utf8'),
+            ]);
+            if (current !== bundled) {
+                if (file === 'AGENTS.md')
+                    agentsInstructionsSkipped = true;
+                else
+                    conflicts.push(file);
+            }
+        }
+    }
+    if (conflicts.length > 0) {
+        throw new Error(`Agent pack stopped before writing. Existing files differ: ${conflicts.join(', ')}`);
+    }
+    for (const file of packFiles) {
+        const destination = resolve(destinationRoot, file);
+        if (file === 'AGENTS.md' && agentsInstructionsSkipped) {
+            console.log('Left existing AGENTS.md unchanged');
+            continue;
+        }
+        await mkdir(dirname(destination), { recursive: true });
+        if (!(await exists(destination))) {
+            await copyFile(assertSafePackPath(file), destination);
+            console.log(`Installed ${file}`);
+        }
+        else {
+            console.log(`Already current ${file}`);
+        }
+    }
+    if (agentsInstructionsSkipped) {
+        console.log('Reference the files under .artist/ from your existing AGENTS.md.');
+    }
+    console.log('Read-only artist workflow pack is ready.');
+};
+export { installAgentPack, listAgentWorkflows, loadAgentWorkflow, };

package/dist/client.js

@@ -7,9 +7,9 @@
  */
 const DEFAULT_ENDPOINT = "https://zxiemadwrkcoovvpscfb.supabase.co/functions/v1/graph";
 /** Overridable for testing; the baked-in default is what shipped copies use. */
-export function endpoint() {
+export const endpoint = () => {
     return process.env.ARTIST_MCP_ENDPOINT ?? DEFAULT_ENDPOINT;
-}
+};
 export class GraphError extends Error {
     reconnectNeeded;
     constructor(message, reconnectNeeded) {
@@ -18,7 +18,7 @@ export class GraphError extends Error {
         this.name = "GraphError";
     }
 }
-export async function call(op, key, params = {}) {
+export const call = async (op, key, params = {}) => {
     let res;
     try {
         res = await fetch(endpoint(), {
@@ -43,4 +43,4 @@ export async function call(op, key, params = {}) {
         throw new GraphError(detail, body.reconnect_needed === true);
     }
     return body;
-}
+};

package/dist/config.js

@@ -4,7 +4,7 @@ import { join } from "node:path";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { dirname } from "node:path";
 export const ENTRY_NAME = "artist-notes";
-export function configPath() {
+export const configPath = () => {
     const home = homedir();
     switch (platform()) {
         case "darwin":
@@ -17,9 +17,9 @@ export function configPath() {
             throw new Error(`Claude Desktop has no config location on ${platform()}. ` +
                 "Install on macOS or Windows.");
     }
-}
+};
 /** Missing file is not an error — it's the first-install case. */
-export async function readConfig(path) {
+export const readConfig = async (path) => {
     let raw;
     try {
         raw = await readFile(path, "utf8");
@@ -38,8 +38,8 @@ export async function readConfig(path) {
         throw new Error(`${path} is not valid JSON. Fix or move it, then run init again — ` +
             "refusing to overwrite a file that may hold your other MCP servers.");
     }
-}
-export async function writeConfig(path, config) {
+};
+export const writeConfig = async (path, config) => {
     await mkdir(dirname(path), { recursive: true });
     await writeFile(path, `${JSON.stringify(config, null, 2)}\n`, "utf8");
-}
+};

package/dist/index.js

@@ -1,23 +1,32 @@
 #!/usr/bin/env node
-import { runInit, runUninstall } from "./init.js";
-import { runServer } from "./server.js";
+import { runInit, runUninstall } from './init.js';
+import { runServer } from './server.js';
+import { installAgentPack } from './agents.js';
 const mode = process.argv[2];
 try {
     switch (mode) {
         case undefined:
             await runServer();
             break;
-        case "init":
+        case 'init':
             await runInit();
             break;
-        case "uninstall":
+        case 'uninstall':
             await runUninstall();
             break;
+        case 'agents':
+            if (process.argv[3] !== 'install') {
+                throw new Error('Usage: artist-mcp agents install [directory]');
+            }
+            await installAgentPack(process.argv[4]);
+            break;
         default:
             console.error(`Unknown command "${mode}".\n\n` +
-                "  artist-mcp            run the MCP server over stdio\n" +
-                "  artist-mcp init       connect this machine to your notes\n" +
-                "  artist-mcp uninstall  remove the Claude Desktop entry\n");
+                '  artist-mcp            run the MCP server over stdio\n' +
+                '  artist-mcp init       connect this machine to your notes\n' +
+                '  artist-mcp agents install [directory]\n' +
+                '                       install the notes-analysis agent pack\n' +
+                '  artist-mcp uninstall  remove the Claude Desktop entry\n');
             process.exit(1);
     }
 }

package/dist/init.js

@@ -3,7 +3,7 @@ import { stdin, stdout } from "node:process";
 import { call, GraphError } from "./client.js";
 import { configPath, ENTRY_NAME, readConfig, writeConfig } from "./config.js";
 const PACKAGE = "@manudota/artist-mcp";
-export async function runInit() {
+export const runInit = async () => {
     const rl = createInterface({ input: stdin, output: stdout });
     let key;
     try {
@@ -38,8 +38,8 @@ export async function runInit() {
     await writeConfig(path, config);
     console.log(`\nConnected. Wrote "${ENTRY_NAME}" to ${path}`);
     console.log("Restart Claude Desktop — it doesn't reload its config on its own.");
-}
-export async function runUninstall() {
+};
+export const runUninstall = async () => {
     const path = configPath();
     const config = await readConfig(path);
     const servers = (config.mcpServers ?? {});
@@ -52,4 +52,4 @@ export async function runUninstall() {
     await writeConfig(path, config);
     console.log(`Removed "${ENTRY_NAME}" from ${path}`);
     console.log("Restart Claude Desktop to apply.");
-}
+};

package/dist/server.js

@@ -1,15 +1,47 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
+import { listAgentWorkflows, loadAgentWorkflow } from "./agents.js";
 import { call, GraphError } from "./client.js";
-export async function runServer() {
+const serverVersion = '0.2.0'; // x-release-please-version
+const errorResult = (err) => {
+    const message = err instanceof GraphError ? err.message : `Unexpected error: ${err}`;
+    return { content: [{ type: "text", text: message }], isError: true };
+};
+const runServer = async () => {
     const key = process.env.ARTIST_MCP_KEY;
     if (!key) {
         // stderr, not stdout — stdout is the protocol channel.
         console.error("ARTIST_MCP_KEY is not set. Run `npx @manudota/artist-mcp init` to configure.");
         process.exit(1);
     }
-    const server = new McpServer({ name: "artist-notes", version: "0.1.0" });
+    const server = new McpServer({ name: "artist-notes", version: serverVersion });
+    server.tool("list_agent_workflows", "List the read-only artist roles, project types, and policies available at runtime. Load the Orchestrator before handling a project.", {}, async () => {
+        try {
+            const entries = await listAgentWorkflows();
+            const lines = entries.map((entry) => `- ${entry.id}: ${entry.name} — ${entry.description}`);
+            return { content: [{ type: "text", text: lines.join("\n") }] };
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
+    server.tool("load_agent_workflow", "Load one checksummed role, project-type, or policy playbook. This only returns instructions; it never changes OneNote or another service.", { workflow_id: z.string().describe("An id returned by list_agent_workflows") }, async ({ workflow_id }) => {
+        try {
+            const workflow = await loadAgentWorkflow(workflow_id);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `# ${workflow.name}\n\n${workflow.content}`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return errorResult(err);
+        }
+    });
     server.tool("list_notes", "List the user's OneNote pages, with title, section and last modified date.", {}, async () => {
         try {
             const { notes } = await call("list_notes", key);
@@ -33,8 +65,5 @@ export async function runServer() {
         }
     });
     await server.connect(new StdioServerTransport());
-}
-function errorResult(err) {
-    const message = err instanceof GraphError ? err.message : `Unexpected error: ${err}`;
-    return { content: [{ type: "text", text: message }], isError: true };
-}
+};
+export { runServer };

package/package.json

@@ -1,13 +1,18 @@
 {
   "name": "@manudota/artist-mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server that reads your OneNote notes, via a hosted connection.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ManudotaORG/artist-mcp"
+  },
   "type": "module",
   "bin": {
     "artist-mcp": "dist/index.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "agent-pack"
   ],
   "engines": {
     "node": ">=20"
@@ -16,7 +21,8 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json && chmod +x dist/index.js",
+    "build": "node scripts/build-agent-registry.mjs && tsc -p tsconfig.json && chmod +x dist/index.js",
+    "test": "pnpm run build && node --test test/*.test.mjs",
     "prepublishOnly": "pnpm run build"
   },
   "dependencies": {