@cliangdev/conductor 0.13.0 → 0.17.0

package/dist/mcp/api.js

@@ -1,3 +1,4 @@
+import { Blob } from 'node:buffer';
 async function requestWithStatus(method, urlPath, body, config) {
     const url = `${config.apiUrl}${urlPath}`;
     const headers = {
@@ -13,7 +14,9 @@ async function requestWithStatus(method, urlPath, body, config) {
         const text = await response.text().catch(() => '');
         throw new Error(`API error ${response.status}: ${text}`);
     }
-    if (method === 'DELETE') {
+    // 204 as well as DELETE: an endpoint that answers "done, nothing to say" (e.g. confirming an upload)
+    // has no body to parse, and calling .json() on it throws.
+    if (method === 'DELETE' || response.status === 204) {
         return { data: undefined, status: response.status };
     }
     return { data: (await response.json()), status: response.status };
@@ -49,4 +52,45 @@ export async function apiPut(urlPath, body, config) {
 export async function apiDelete(urlPath, config) {
     await request('DELETE', urlPath, undefined, config);
 }
+/**
+ * PUTs raw bytes to an absolute upload URL — a signed bucket URL, or the backend's local passthrough.
+ * Deliberately sends no Authorization header: the URL itself is the capability, and a bucket signature is
+ * computed over an exact header set, so an extra one invalidates it.
+ */
+export async function putBytes(url, contentType, bytes) {
+    // Copy into a plain ArrayBuffer: the incoming view may be a slice of a pooled Node Buffer.
+    const buffer = new ArrayBuffer(bytes.byteLength);
+    new Uint8Array(buffer).set(bytes);
+    const response = await fetch(url, {
+        method: 'PUT',
+        headers: { 'Content-Type': contentType },
+        body: buffer,
+    });
+    if (!response.ok) {
+        const text = await response.text().catch(() => '');
+        throw new Error(`Upload PUT failed ${response.status}: ${text}`);
+    }
+}
+/**
+ * POSTs a single file as multipart/form-data. Deliberately does not set Content-Type: fetch has to
+ * generate it itself so the multipart boundary matches the body it builds.
+ */
+export async function apiPostFile(urlPath, file, config) {
+    // Copy into a plain ArrayBuffer: the incoming view may be backed by a pooled Node Buffer, which is
+    // both a type mismatch for Blob and a slice of a larger allocation.
+    const buffer = new ArrayBuffer(file.bytes.byteLength);
+    new Uint8Array(buffer).set(file.bytes);
+    const form = new FormData();
+    form.append(file.fieldName, new Blob([buffer], { type: file.contentType }), file.filename);
+    const response = await fetch(`${config.apiUrl}${urlPath}`, {
+        method: 'POST',
+        headers: { Authorization: `Bearer ${config.apiKey}` },
+        body: form,
+    });
+    if (!response.ok) {
+        const text = await response.text().catch(() => '');
+        throw new Error(`API error ${response.status}: ${text}`);
+    }
+    return (await response.json());
+}
 //# sourceMappingURL=api.js.map

package/dist/mcp/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/mcp/api.ts"],"names":[],"mappings":"AAEA,KAAK,UAAU,iBAAiB,CAC9B,MAAc,EACd,OAAe,EACf,IAAyB,EACzB,MAAc;IAEd,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,MAAM,GAAG,OAAO,EAAE,CAAA;IACxC,MAAM,OAAO,GAA2B;QACtC,aAAa,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE;QACxC,cAAc,EAAE,kBAAkB;KACnC,CAAA;IAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,MAAM;QACN,OAAO;QACP,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;KAC5D,CAAC,CAAA;IAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;QAClD,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAA;IAC1D,CAAC;IAED,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;QACxB,OAAO,EAAE,IAAI,EAAE,SAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAA;IAC1D,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAA;AACxE,CAAC;AAED,KAAK,UAAU,OAAO,CACpB,MAAc,EACd,OAAe,EACf,IAAyB,EACzB,MAAc;IAEd,OAAO,CAAC,MAAM,iBAAiB,CAAI,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAA;AACzE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,OAAO,GAAG,YAAY,KAAK,IAAI,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;AACtE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAI,OAAe,EAAE,MAAc;IAC7D,OAAO,OAAO,CAAI,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAA;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAI,OAAe,EAAE,IAAa,EAAE,MAAc;IAC7E,OAAO,OAAO,CAAI,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AAClD,CAAC;AAED;0GAC0G;AAC1G,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAe,EACf,IAAa,EACb,MAAc;IAEd,OAAO,iBAAiB,CAAI,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AAC5D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAI,OAAe,EAAE,IAAa,EAAE,MAAc;IAC9E,OAAO,OAAO,CAAI,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AACnD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAI,OAAe,EAAE,IAAa,EAAE,MAAc;IAC5E,OAAO,OAAO,CAAI,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe,EAAE,MAAc;IAC7D,MAAM,OAAO,CAAO,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAA;AAC3D,CAAC"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/mcp/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAGlC,KAAK,UAAU,iBAAiB,CAC9B,MAAc,EACd,OAAe,EACf,IAAyB,EACzB,MAAc;IAEd,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,MAAM,GAAG,OAAO,EAAE,CAAA;IACxC,MAAM,OAAO,GAA2B;QACtC,aAAa,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE;QACxC,cAAc,EAAE,kBAAkB;KACnC,CAAA;IAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,MAAM;QACN,OAAO;QACP,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;KAC5D,CAAC,CAAA;IAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;QAClD,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAA;IAC1D,CAAC;IAED,qGAAqG;IACrG,0DAA0D;IAC1D,IAAI,MAAM,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACnD,OAAO,EAAE,IAAI,EAAE,SAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAA;IAC1D,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAA;AACxE,CAAC;AAED,KAAK,UAAU,OAAO,CACpB,MAAc,EACd,OAAe,EACf,IAAyB,EACzB,MAAc;IAEd,OAAO,CAAC,MAAM,iBAAiB,CAAI,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAA;AACzE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,OAAO,GAAG,YAAY,KAAK,IAAI,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;AACtE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAI,OAAe,EAAE,MAAc;IAC7D,OAAO,OAAO,CAAI,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAA;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAI,OAAe,EAAE,IAAa,EAAE,MAAc;IAC7E,OAAO,OAAO,CAAI,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AAClD,CAAC;AAED;0GAC0G;AAC1G,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAe,EACf,IAAa,EACb,MAAc;IAEd,OAAO,iBAAiB,CAAI,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AAC5D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAI,OAAe,EAAE,IAAa,EAAE,MAAc;IAC9E,OAAO,OAAO,CAAI,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AACnD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAAI,OAAe,EAAE,IAAa,EAAE,MAAc;IAC5E,OAAO,OAAO,CAAI,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAe,EAAE,MAAc;IAC7D,MAAM,OAAO,CAAO,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAA;AAC3D,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,GAAW,EACX,WAAmB,EACnB,KAAiB;IAEjB,2FAA2F;IAC3F,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;IAChD,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAEjC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,MAAM,EAAE,KAAK;QACb,OAAO,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE;QACxC,IAAI,EAAE,MAAM;KACb,CAAC,CAAA;IAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;QAClD,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAA;IAClE,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAe,EACf,IAAqF,EACrF,MAAc;IAEd,mGAAmG;IACnG,oEAAoE;IACpE,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;IACrD,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAEtC,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAA;IAC3B,IAAI,CAAC,MAAM,CACT,IAAI,CAAC,SAAS,EACd,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,CAA+B,EAC5E,IAAI,CAAC,QAAQ,CACd,CAAA;IAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,OAAO,EAAE,EAAE;QACzD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,CAAC,MAAM,EAAE,EAAE;QACrD,IAAI,EAAE,IAAI;KACX,CAAC,CAAA;IAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;QAClD,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAA;IAC1D,CAAC;IAED,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAM,CAAA;AACrC,CAAC"}

package/dist/mcp/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AAgnBA,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CA2clD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AA05BA,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAupBlD"}

package/dist/mcp/index.js

@@ -11,6 +11,8 @@ import { listIntegrationTools, listConnectorCatalog } from './tools/integrations
 import { listAgents, createAgent, updateAgent, deleteAgent } from './tools/agents.js';
 import { listSkills, registerSkill } from './tools/skills.js';
 import { submitKnowledgeSource, readKnowledgeSources, searchKnowledge, readKnowledgePages, writeKnowledgePages, listKnowledgeDomains, suggestKnowledgeDomain, } from './tools/knowledge.js';
+import { listPublishTargets, setPublishTargets, uploadAsset, retryFailedPublishTargets, completeManualPublish, } from './tools/marketing.js';
+import { listProjectDocs, readProjectDoc, writeProjectDoc, moveProjectDoc, deleteProjectDoc, setProjectDocTask, listProjectDocComments, commentOnProjectDoc, respondToProjectDocComment, listProjectDocVersions, restoreProjectDocVersion, uploadProjectDocImage, moveProjectFolder, deleteProjectFolder, } from './tools/project-docs.js';
 const TOOLS = [
     // --- Canonical Work Item tools (v2 /work-items surface) ---
     {
@@ -22,20 +24,24 @@ const TOOLS = [
                 workflow: { type: 'string', description: 'Lifecycle Workflow slug that governs this Work Item (required). Discover with list_workflows({kind:"LIFECYCLE"}).' },
                 type: { type: 'string', description: 'Work Item type, validated against the chosen Workflow\'s allowed types (e.g. PRD, FEATURE_REQUEST, BUG_REPORT)' },
                 title: { type: 'string', description: 'Work Item title' },
-                description: { type: 'string', description: 'Work Item description (optional)' },
+                description: { type: 'string', description: 'Work Item description (optional). On a publishing Workflow this is the caption — the text that goes out to the platform — not a note about the item.' },
+                tags: { type: 'array', items: { type: 'string' }, description: 'Freeform labels for grouping work across type, status and Workflow. Stored lower-cased and de-duplicated, so "Autumn" and "autumn" are one tag. Sent whole: omit to leave existing tags alone, send [] to clear them.' },
             },
             required: ['workflow', 'type', 'title'],
         },
     },
     {
         name: 'update_work_item',
-        description: 'Update an existing Work Item. Canonical tool (targets the v2 work-items API).',
+        description: 'Update an existing Work Item\'s title, description, tags, or schedule. On a publishing Workflow the description is the caption that goes out to the platform, not a note. Canonical tool (targets the v2 work-items API). A field you omit is left unchanged. Verify with get_work_item.',
         inputSchema: {
             type: 'object',
             properties: {
                 issueId: { type: 'string', description: 'Work Item ID' },
                 title: { type: 'string', description: 'New title (optional)' },
                 description: { type: 'string', description: 'New description (optional)' },
+                scheduledFor: { type: 'string', description: 'ISO-8601 date-time this Work Item is due to fire (optional). On a Post this is when its publish targets go out.' },
+                scheduleTimezone: { type: 'string', description: 'IANA zone id the schedule is authored in, e.g. Europe/Berlin (optional). Empty string clears it; an unknown zone is rejected.' },
+                tags: { type: 'array', items: { type: 'string' }, description: 'Freeform labels for grouping work across type, status and Workflow. Stored lower-cased and de-duplicated, so "Autumn" and "autumn" are one tag. Sent whole: omit to leave existing tags alone, send [] to clear them.' },
             },
             required: ['issueId'],
         },
@@ -61,6 +67,7 @@ const TOOLS = [
                 type: { type: 'string', description: 'Filter by type (optional)' },
                 status: { type: 'string', description: 'Filter by status (optional)' },
                 workflow: { type: 'string', description: 'Filter by bound Workflow slug (optional, e.g. ENGINEERING)' },
+                tag: { type: 'string', description: 'Filter to Work Items carrying this tag (optional). Matched case-insensitively.' },
             },
         },
     },
@@ -552,6 +559,274 @@ const TOOLS = [
             required: ['slug', 'displayName', 'reason'],
         },
     },
+    // --- Project Docs (the project's own document tree, not Work Item documents) ---
+    {
+        name: 'list_project_docs',
+        description: "Map the project's Docs section: every document as a \"Folder/Title\" path with its docId, plus each folder with its docCount and lastUpdatedAt so you can judge which parts of the tree carry weight or have gone stale. Pass query to full-text search instead. Call this first to orient before reading or writing project docs.",
+        inputSchema: {
+            type: 'object',
+            properties: {
+                folder: { type: 'string', description: 'Limit to one folder path, e.g. "Plans/Q3" (omit for the whole tree)' },
+                query: { type: 'string', description: 'Full-text search over titles and content; returns matches with snippets instead of the tree' },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'read_project_doc',
+        description: 'Read one project document by path ("Plans/Q3 Roadmap") or docId. Returns full Markdown content plus taskLines — every checkbox with its 1-based line number and state, which is what set_project_doc_task takes. Pass versionNumber (from list_project_doc_versions) to read an earlier version instead of the current one.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Document path, e.g. "Plans/Q3 Roadmap"' },
+                docId: { type: 'string', description: 'Document ID — use instead of path when the title contains "/"' },
+                versionNumber: { type: 'number', description: 'Read this historical version instead of current content' },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'write_project_doc',
+        description: 'Create or replace a project document at a path, creating any missing folders (upsert). Replaces the whole document, records a version, and marks unresolved line comments stale — to tick a checkbox use set_project_doc_task instead, which does none of that. Verify with read_project_doc.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Destination path, e.g. "Plans/Q3 Roadmap" — folder segments are created if missing' },
+                content: { type: 'string', description: 'Full Markdown content' },
+            },
+            required: ['path', 'content'],
+        },
+    },
+    {
+        name: 'move_project_doc',
+        description: 'Rename a project document and/or move it to another folder, creating missing folders in the destination path. Verify with list_project_docs.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Current document path' },
+                docId: { type: 'string', description: 'Document ID — use instead of path' },
+                newPath: { type: 'string', description: 'New path, e.g. "Archive/Q2 Roadmap"' },
+            },
+            required: ['newPath'],
+        },
+    },
+    {
+        name: 'delete_project_doc',
+        description: 'Delete a project document. Irreversible — its version history and comments go with it. Verify with list_project_docs.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Document path' },
+                docId: { type: 'string', description: 'Document ID — use instead of path' },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'set_project_doc_task',
+        description: 'Check or uncheck one Markdown checkbox in a project document. lineNumber is 1-based against raw content including frontmatter — take it from read_project_doc\'s taskLines. Unlike write_project_doc this records no version and leaves comment anchors valid. Idempotent; returns conflict: true if that line is no longer a task item.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Document path' },
+                docId: { type: 'string', description: 'Document ID — use instead of path' },
+                lineNumber: { type: 'number', description: '1-based line number of the task item (from read_project_doc taskLines)' },
+                checked: { type: 'boolean', description: 'true to check the box, false to uncheck' },
+            },
+            required: ['lineNumber', 'checked'],
+        },
+    },
+    {
+        name: 'list_project_doc_comments',
+        description: 'Read the comments humans left on a project document — each with its anchored lineNumber, quotedText, lineStale flag and replies. Unresolved only by default. Answer them with respond_to_project_doc_comment.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Document path' },
+                docId: { type: 'string', description: 'Document ID — use instead of path' },
+                includeResolved: { type: 'boolean', description: 'Include already-resolved threads (default false)' },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'comment_on_project_doc',
+        description: 'Leave a comment anchored to one line of a project document. lineNumber is 1-based against raw content including frontmatter. Verify with list_project_doc_comments.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Document path' },
+                docId: { type: 'string', description: 'Document ID — use instead of path' },
+                lineNumber: { type: 'number', description: '1-based line number to anchor the comment to' },
+                content: { type: 'string', description: 'Comment text' },
+                quotedText: { type: 'string', description: 'Optional snippet of the line being commented on, shown as context' },
+            },
+            required: ['lineNumber', 'content'],
+        },
+    },
+    {
+        name: 'respond_to_project_doc_comment',
+        description: 'Answer a comment thread on a project document: post a reply, mark it resolved, or both. Verify with list_project_doc_comments.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Document path' },
+                docId: { type: 'string', description: 'Document ID — use instead of path' },
+                commentId: { type: 'string', description: 'ID of the comment thread (from list_project_doc_comments)' },
+                reply: { type: 'string', description: 'Reply text to post on the thread' },
+                resolve: { type: 'boolean', description: 'true to mark the thread resolved' },
+            },
+            required: ['commentId'],
+        },
+    },
+    {
+        name: 'list_project_doc_versions',
+        description: 'List a project document\'s edit history — versionNumber, who wrote it and when, newest first. Every full-content write adds one; ticking a checkbox does not. Read one with read_project_doc versionNumber, or roll back with restore_project_doc_version.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Document path' },
+                docId: { type: 'string', description: 'Document ID — use instead of path' },
+            },
+            required: [],
+        },
+    },
+    {
+        name: 'restore_project_doc_version',
+        description: 'Roll a project document back to an earlier version (from list_project_doc_versions). Appends the old content as a new version rather than rewinding, so the restore is itself undoable. Verify with read_project_doc.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Document path' },
+                docId: { type: 'string', description: 'Document ID — use instead of path' },
+                versionNumber: { type: 'number', description: 'Version to restore, from list_project_doc_versions' },
+            },
+            required: ['versionNumber'],
+        },
+    },
+    {
+        name: 'upload_project_doc_image',
+        description: 'Upload a local image file (png, jpeg, gif, webp) to a project document and get the Markdown snippet to embed. Include that snippet in the content you pass to write_project_doc — the link is stored as a stable reference and re-signed on every read, so it will not expire.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Document path the image belongs to' },
+                docId: { type: 'string', description: 'Document ID — use instead of path' },
+                filePath: { type: 'string', description: 'Path to the image file on this machine' },
+            },
+            required: ['filePath'],
+        },
+    },
+    {
+        name: 'move_project_folder',
+        description: 'Rename a docs folder and/or move it under another one, taking its whole subtree with it. Missing folders in the destination path are created. Cannot move a folder into its own subtree. Verify with list_project_docs.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Current folder path, e.g. "Plans/Q3"' },
+                newPath: { type: 'string', description: 'New folder path, e.g. "Archive/2026/Q3"' },
+            },
+            required: ['path', 'newPath'],
+        },
+    },
+    {
+        name: 'delete_project_folder',
+        description: 'Delete a docs folder and its subfolders. Not destructive to content: documents inside are kept and resurface at the project root. Use it to clear away empty or obsolete folders after reorganising. Verify with list_project_docs.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Folder path to delete, e.g. "Archive/Old"' },
+            },
+            required: ['path'],
+        },
+    },
+    {
+        name: 'list_publish_targets',
+        description: 'Publishing destinations for a project: each connected account with its platform, connectionId, label, lane and credential health. Pass issueId to also get the targets that Work Item publishes to, each with its state, permalink and error — the read-back for set_publish_targets and the status check after a scheduled publish or a retry. TikTok entries carry the creator\'s allowed privacy levels and nickname; they are the only source for a target\'s privacyLevel.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                issueId: { type: 'string', description: 'Work Item ID — include to also return that item\'s selected targets and their publish outcomes (optional)' },
+            },
+        },
+    },
+    {
+        name: 'set_publish_targets',
+        description: 'Choose which connected accounts a Work Item publishes to, with per-target options. Idempotent set-replace: send the complete selection (empty array clears it); already-selected targets keep their state. Discover platform/connectionId pairs with list_publish_targets first and call it again after to verify. Editing the selection on an approved item sends it back for review. Publishing to TikTok also needs the creator\'s consent, which a human records in the Conductor UI — no tool can record or skip it.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                issueId: { type: 'string', description: 'Work Item ID' },
+                targets: {
+                    type: 'array',
+                    description: 'The complete selection. Empty array clears every target.',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            platform: { type: 'string', description: 'Platform of the account, from list_publish_targets' },
+                            connectionId: { type: 'string', description: 'The connected account to publish to, from list_publish_targets. Omit it to select this platform\'s manual destination — the one a human posts by hand — which is offered whether or not the project has connected that platform.' },
+                            publishOptions: {
+                                type: 'object',
+                                description: 'Per-platform options for this target. A TikTok target with no privacyLevel blocks approval.',
+                                properties: {
+                                    privacyLevel: { type: 'string', description: 'TikTok: one of that account\'s privacyLevelOptions from list_publish_targets' },
+                                    disableComment: { type: 'boolean', description: 'TikTok: turn comments off' },
+                                    disableDuet: { type: 'boolean', description: 'TikTok: turn duets off' },
+                                    disableStitch: { type: 'boolean', description: 'TikTok: turn stitches off' },
+                                    brandContentToggle: { type: 'boolean', description: 'TikTok: paid partnership; TikTok refuses it combined with SELF_ONLY' },
+                                    brandOrganicToggle: { type: 'boolean', description: 'TikTok: promoting the creator\'s own brand' },
+                                },
+                            },
+                        },
+                        required: ['platform'],
+                    },
+                },
+            },
+            required: ['issueId', 'targets'],
+        },
+    },
+    {
+        name: 'upload_asset',
+        description: 'Attach a local file to a Work Item as a file Asset in one call — mints the upload URL, uploads the bytes and confirms. filePath is a path on this machine (this server runs locally). The server enforces the media-type allowlist and size ceiling; a refused file leaves no Asset behind. Video: pass width, height and durationSeconds — they cannot be derived server-side and approval stays blocked without them. Returns the stored Asset as read back after confirmation. Use record_asset instead for a link.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                issueId: { type: 'string', description: 'Work Item ID' },
+                filePath: { type: 'string', description: 'Absolute path to the file on this machine' },
+                type: { type: 'string', description: 'Asset type, validated against the Workflow\'s asset_types' },
+                label: { type: 'string', description: 'Human label (optional — defaults to the filename)' },
+                width: { type: 'number', description: 'Pixel width of the media (optional; required in practice for video)' },
+                height: { type: 'number', description: 'Pixel height of the media (optional; required in practice for video)' },
+                durationSeconds: { type: 'number', description: 'Playback length in seconds (optional; required in practice for video)' },
+            },
+            required: ['issueId', 'filePath', 'type'],
+        },
+    },
+    {
+        name: 'complete_manual_publish',
+        description: 'Record that a manual publish target was published by hand, storing the live URL. Only for targets on the MANUAL lane (list_publish_targets shows lane and state; a manual one due to go out is AWAITING_MANUAL) — a target that publishes automatically is refused, because its poller will publish it and report the real outcome. This reports what a human already did outside Conductor; it publishes nothing. Records the same destination Asset an API publish does, so the link surfaces on the calendar and list like any other. Returns the target as read back after recording.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                issueId: { type: 'string', description: 'Work Item ID' },
+                targetId: { type: 'string', description: 'The publish target\'s id, from list_publish_targets' },
+                permalink: { type: 'string', description: 'Link to the post that actually went out. Required — with no platform to ask, it is the only record this destination was published.' },
+                publishedAt: { type: 'string', description: 'ISO-8601 instant it actually went out (optional; defaults to now)' },
+            },
+            required: ['issueId', 'targetId', 'permalink'],
+        },
+    },
+    {
+        name: 'retry_failed_publish_targets',
+        description: 'Re-fire only the FAILED publish targets on a Work Item, with a fresh idempotency key. Published targets are untouched and nothing failed is a harmless no-op. Returns the item\'s status and every target. Publishing is asynchronous — call list_publish_targets after to see where each target landed.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                issueId: { type: 'string', description: 'Work Item ID' },
+            },
+            required: ['issueId'],
+        },
+    },
 ];
 function authErrorResponse() {
     return {
@@ -624,6 +899,7 @@ export async function runMcpServer() {
                         type: params['type'],
                         title: params['title'],
                         description: params['description'],
+                        tags: params['tags'],
                     }, config);
                     return successResponse(result);
                 }
@@ -805,6 +1081,9 @@ export async function runMcpServer() {
                         issueId: params['issueId'],
                         title: params['title'],
                         description: params['description'],
+                        scheduledFor: params['scheduledFor'],
+                        scheduleTimezone: params['scheduleTimezone'],
+                        tags: params['tags'],
                     }, config);
                     return successResponse(result);
                 }
@@ -820,6 +1099,7 @@ export async function runMcpServer() {
                         type: params['type'],
                         status: params['status'],
                         workflow: params['workflow'],
+                        tag: params['tag'],
                     }, config);
                     return successResponse(result);
                 }
@@ -887,6 +1167,146 @@ export async function runMcpServer() {
                     }, config);
                     return successResponse(result);
                 }
+                // --- Project Docs ---
+                case 'list_project_docs': {
+                    const result = await listProjectDocs({
+                        folder: params['folder'],
+                        query: params['query'],
+                    }, config);
+                    return successResponse(result);
+                }
+                case 'read_project_doc': {
+                    const result = await readProjectDoc({
+                        path: params['path'],
+                        docId: params['docId'],
+                        versionNumber: params['versionNumber'],
+                    }, config);
+                    return successResponse(result);
+                }
+                case 'write_project_doc': {
+                    const result = await writeProjectDoc({
+                        path: params['path'],
+                        content: params['content'],
+                    }, config);
+                    return successResponse(result);
+                }
+                case 'move_project_doc': {
+                    const result = await moveProjectDoc({
+                        path: params['path'],
+                        docId: params['docId'],
+                        newPath: params['newPath'],
+                    }, config);
+                    return successResponse(result);
+                }
+                case 'delete_project_doc': {
+                    const result = await deleteProjectDoc({
+                        path: params['path'],
+                        docId: params['docId'],
+                    }, config);
+                    return successResponse(result);
+                }
+                case 'set_project_doc_task': {
+                    const result = await setProjectDocTask({
+                        path: params['path'],
+                        docId: params['docId'],
+                        lineNumber: params['lineNumber'],
+                        checked: params['checked'],
+                    }, config);
+                    return successResponse(result);
+                }
+                case 'list_project_doc_comments': {
+                    const result = await listProjectDocComments({
+                        path: params['path'],
+                        docId: params['docId'],
+                        includeResolved: params['includeResolved'],
+                    }, config);
+                    return successResponse(result);
+                }
+                case 'comment_on_project_doc': {
+                    const result = await commentOnProjectDoc({
+                        path: params['path'],
+                        docId: params['docId'],
+                        lineNumber: params['lineNumber'],
+                        content: params['content'],
+                        quotedText: params['quotedText'],
+                    }, config);
+                    return successResponse(result);
+                }
+                case 'respond_to_project_doc_comment': {
+                    const result = await respondToProjectDocComment({
+                        path: params['path'],
+                        docId: params['docId'],
+                        commentId: params['commentId'],
+                        reply: params['reply'],
+                        resolve: params['resolve'],
+                    }, config);
+                    return successResponse(result);
+                }
+                case 'list_project_doc_versions': {
+                    const result = await listProjectDocVersions({
+                        path: params['path'],
+                        docId: params['docId'],
+                    }, config);
+                    return successResponse(result);
+                }
+                case 'restore_project_doc_version': {
+                    const result = await restoreProjectDocVersion({
+                        path: params['path'],
+                        docId: params['docId'],
+                        versionNumber: params['versionNumber'],
+                    }, config);
+                    return successResponse(result);
+                }
+                case 'move_project_folder': {
+                    const result = await moveProjectFolder({
+                        path: params['path'],
+                        newPath: params['newPath'],
+                    }, config);
+                    return successResponse(result);
+                }
+                case 'delete_project_folder': {
+                    const result = await deleteProjectFolder({ path: params['path'] }, config);
+                    return successResponse(result);
+                }
+                case 'list_publish_targets': {
+                    return successResponse(await listPublishTargets({ issueId: params['issueId'] }, config));
+                }
+                case 'set_publish_targets': {
+                    return successResponse(await setPublishTargets({
+                        issueId: params['issueId'],
+                        targets: params['targets'],
+                    }, config));
+                }
+                case 'upload_asset': {
+                    return successResponse(await uploadAsset({
+                        issueId: params['issueId'],
+                        filePath: params['filePath'],
+                        type: params['type'],
+                        label: params['label'],
+                        width: params['width'],
+                        height: params['height'],
+                        durationSeconds: params['durationSeconds'],
+                    }, config));
+                }
+                case 'complete_manual_publish': {
+                    return successResponse(await completeManualPublish({
+                        issueId: params['issueId'],
+                        targetId: params['targetId'],
+                        permalink: params['permalink'],
+                        publishedAt: params['publishedAt'],
+                    }, config));
+                }
+                case 'retry_failed_publish_targets': {
+                    return successResponse(await retryFailedPublishTargets({ issueId: params['issueId'] }, config));
+                }
+                case 'upload_project_doc_image': {
+                    const result = await uploadProjectDocImage({
+                        path: params['path'],
+                        docId: params['docId'],
+                        filePath: params['filePath'],
+                    }, config);
+                    return successResponse(result);
+                }
                 default:
                     return errorResponse(`Unknown tool: ${name}`);
             }