lotux-mcp 0.25.0 → 0.27.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lotux-mcp",
-  "version": "0.25.0",
+  "version": "0.27.0",
   "type": "module",
   "description": "Local MCP server that lets Claude create LOTUX concepts (fetch brand-DB entities, create concepts, fill scripts + copy). Talks to the LOTUX app with a personal token; no business logic or secrets live here.",
   "bin": {

package/tools.mjs

@@ -75,7 +75,7 @@ export function registerTools(server, rpc) {
 
   server.tool(
     "plan_items",
-    "Plan 1–60 items on ONE person's calendar on a date. With start_time they run back to back, each as long as that person's HR output allows (40 h ÷ weekly output; tasks 1 h); without start_time they land all-day. The person becomes the editor (post) or media buyer (go_live); on a task they are added to the assignees. Planning concept blocks needs Creative edit rights. More than 10 items → returns a PREVIEW only and changes nothing: show the list, ask for a yes, then call apply_planning_preview. Never deletes anything.",
+    "Plan 1–60 items on ONE person's calendar on a date. With start_time they run back to back, each as long as that person's HR output allows (40 h ÷ weekly output; tasks 1 h); without start_time they land all-day. The person becomes the maker (post: video editor on video concepts, static designer on statics) or media buyer (go_live); on a task they are added to the assignees. Planning concept blocks needs Creative edit rights. More than 10 items → returns a PREVIEW only and changes nothing: show the list, ask for a yes, then call apply_planning_preview. Never deletes anything.",
     {
       person: z.string().describe("id, name or 'me'"),
       items: PLAN_ITEMS,
@@ -227,7 +227,7 @@ export function registerTools(server, rpc) {
 
   server.tool(
     "claim_work",
-    "Claim a piece of work before writing files for it. kind: concept (ref = concept id; prep / edit / revise / re-render one concept; 6 h), inventory (the brand's inventory run; 6 h), brand_shared (files several concepts of the brand use: logos, shared media, shared code; 15 min), house_rules (the shared house rules or style spec, agency-wide; 15 min). Returns {ok: true, claim_id, expires_at} or {ok: false, held_by, since, expires_at} when someone else holds it: then don't write, ask or wait. A concept claim warns when you're not its editor and sets you as editor when it has none.",
+    "Claim a piece of work before writing files for it. kind: concept (ref = concept id; prep / edit / revise / re-render one concept; 6 h), inventory (the brand's inventory run; 6 h), brand_shared (files several concepts of the brand use: logos, shared media, shared code; 15 min), house_rules (the shared house rules or style spec, agency-wide; 15 min). Returns {ok: true, claim_id, expires_at} or {ok: false, held_by, since, expires_at} when someone else holds it: then don't write, ask or wait. A concept claim warns when you're not its maker (video editor on video, static designer otherwise) and sets you as maker when it has none.",
     {
       account_id: z.string().describe("Brand id from list_brands (house_rules: any brand of the agency, or the agency)"),
       kind: z.enum(["concept", "inventory", "brand_shared", "house_rules"]),
@@ -373,7 +373,7 @@ export function registerTools(server, rpc) {
 
   server.tool(
     "list_members",
-    "List the agency team members (id + name) assignable to a concept's roles. Use the ids with set_concept_fields (strategist_id, copy_checker_id, editor_id, media_buyer_id, final_check_id).",
+    "List the agency team members (id + name) assignable to a concept's roles. Use the ids with set_concept_fields (strategist_id, copy_checker_id, editor_id = video editor, designer_id = static designer, media_buyer_id, final_check_id).",
     { account_id: z.string().describe("Brand id from list_brands") },
     async ({ account_id }) => ok(await rpc("list_members", { account_id }))
   );
@@ -403,7 +403,7 @@ export function registerTools(server, rpc) {
 
   server.tool(
     "set_concept_fields",
-    "Update fields on an existing concept — including renaming it via title. Any omitted field is left unchanged; the id arrays, when given, replace the full set of links. Assign team roles by passing a person id from list_members into strategist_id / copy_checker_id / editor_id / media_buyer_id / final_check_id.",
+    "Update fields on an existing concept — including renaming it via title. Any omitted field is left unchanged; the id arrays, when given, replace the full set of links. Assign team roles by passing a person id from list_members into strategist_id / copy_checker_id / editor_id (video editor) / designer_id (static designer) / media_buyer_id / final_check_id.",
     {
       concept_id: z.string(),
       title: z.string().optional().describe("Rename the concept (blank is ignored — title is required)"),
@@ -443,7 +443,8 @@ export function registerTools(server, rpc) {
       // Team roles — pass a member id from list_members.
       strategist_id: z.string().optional().describe("Member id from list_members"),
       copy_checker_id: z.string().optional().describe("Member id from list_members"),
-      editor_id: z.string().optional().describe("Member id from list_members"),
+      editor_id: z.string().optional().describe("Video editor: member id from list_members"),
+      designer_id: z.string().optional().describe("Static designer: member id from list_members"),
       media_buyer_id: z.string().optional().describe("Member id from list_members"),
       final_check_id: z.string().optional().describe("Member id from list_members"),
     },
@@ -701,6 +702,15 @@ export function registerTools(server, rpc) {
 
   // ── Kennisbank (knowledge base) ─────────────────────────────────────────────────
 
+  // How a Second Brain page's markdown is laid out — the app renders these.
+  const KB_FORMAT =
+    " Page markdown supports, besides normal markdown (headings, lists, tables, --- dividers, images): " +
+    "fenced blocks the app renders as page blocks — ```cards (one card per line: Label | Title | Text), " +
+    "```stats (Value | Label | Note), ```steps (Title | Text), ```callout (first line = title, the rest = body), " +
+    "```buttons (Label | link), ```mermaid (a Mermaid diagram). Any of those may start with a line " +
+    "`tone: gray|yellow|blue|green|red|purple|ink` for its colour. Link to another page with a normal markdown link " +
+    "to /brain/second-brain?ws=<workspace id>&doc=<page id>.";
+
   server.tool(
     "list_kb_workspaces",
     "List the Kennisbank (knowledge base) workspaces you can access — markdown docs the team and AI share. Returns id, name, visibility. Use a workspace id with list_kb_docs / create_kb_doc. Only each workspace's \"Exposed to MCP\" section is visible to the MCP; the rest is the team's own notes.",
@@ -710,37 +720,41 @@ export function registerTools(server, rpc) {
 
   server.tool(
     "list_kb_docs",
-    "List the pages in a Kennisbank workspace's \"Exposed to MCP\" section (id, title, folder path inside the section; \"\" = its top level). Pages outside the section are not listed. Use a doc id with get_kb_doc.",
+    "List the pages in a Kennisbank workspace's \"Exposed to MCP\" section (id, title, folder path inside the section; \"\" = its top level; tags; date). Pages outside the section are not listed. Use a doc id with get_kb_doc.",
     { workspace_id: z.string().describe("Workspace id from list_kb_workspaces") },
     async ({ workspace_id }) => ok(await rpc("list_kb_docs", { workspace_id }))
   );
 
   server.tool(
     "get_kb_doc",
-    "Read one Kennisbank page's full markdown content by id. Only pages in the \"Exposed to MCP\" section can be read.",
+    "Read one Kennisbank page by id: title, author, date, tags, full markdown content and linked_pages (the pages it links to; a linked page outside an \"Exposed to MCP\" section shows only its id with exposed: false). Only pages in the \"Exposed to MCP\" section can be read." + KB_FORMAT,
     { doc_id: z.string() },
     async ({ doc_id }) => ok(await rpc("get_kb_doc", { doc_id }))
   );
 
   server.tool(
     "create_kb_doc",
-    "Create a new markdown page in a Kennisbank workspace's \"Exposed to MCP\" section. Returns the new doc id. content is markdown; folder_id is optional (top of the section if omitted) and must be a folder from list_kb_folders.",
+    "Create a new markdown page in a Kennisbank workspace's \"Exposed to MCP\" section. Returns the new doc id. content is markdown; folder_id is optional (top of the section if omitted) and must be a folder from list_kb_folders. You become the page's author." + KB_FORMAT,
     {
       workspace_id: z.string().describe("Workspace id from list_kb_workspaces"),
       title: z.string(),
       content: z.string().optional().describe("Markdown body"),
       folder_id: z.string().optional(),
+      tags: z.array(z.string()).optional().describe("Page tags"),
+      date: z.string().optional().describe("Page date, YYYY-MM-DD (default: today)"),
     },
     async (args) => ok(await rpc("create_kb_doc", args))
   );
 
   server.tool(
     "update_kb_doc",
-    "Update a Kennisbank page's title and/or markdown content (pages in the \"Exposed to MCP\" section only). Omitted fields are left unchanged.",
+    "Update a Kennisbank page's title, markdown content, tags and/or date (pages in the \"Exposed to MCP\" section only). Omitted fields are left unchanged." + KB_FORMAT,
     {
       doc_id: z.string(),
       title: z.string().optional(),
       content: z.string().optional().describe("Markdown body (replaces the page content)"),
+      tags: z.array(z.string()).optional().describe("Replaces the page's tags"),
+      date: z.string().nullable().optional().describe("Page date YYYY-MM-DD; null = back to the created date"),
     },
     async (args) => ok(await rpc("update_kb_doc", args))
   );