lotux-mcp 0.24.0 → 0.26.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lotux-mcp",
-  "version": "0.24.0",
+  "version": "0.26.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

@@ -6,7 +6,7 @@
 
 import { z } from "zod";
 
-export const SERVER_INFO = { name: "lotux", version: "0.22.0" };
+export const SERVER_INFO = { name: "lotux", version: "0.25.0" };
 
 export function registerTools(server, rpc) {
   const ok = (result) => ({
@@ -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,
@@ -168,14 +168,14 @@ export function registerTools(server, rpc) {
 
   server.tool(
     "get_brand",
-    "One client's workspace settings: slug, client_status, second brain (Kennisbank id + name, shared with the client or not), workspace_folder, dropbox_client_path, raw_footage_paths, Claude project name, the Claude project kit (instructions text) and the active work claims.",
+    "One client's workspace settings: ad_languages (main + translations), slug, client_status, second brain (Kennisbank id + name, shared with the client or not), workspace_folder, dropbox_client_path, raw_footage_paths, Claude project name, the Claude project kit (instructions text) and the active work claims.",
     { account_id: z.string().describe("Brand id from list_brands") },
     async (args) => ok(await rpc("get_brand", args))
   );
 
   server.tool(
     "update_brand_settings",
-    "Change a client's workspace settings. Omitted fields stay as they are. slug is refused once client setup has run (it names the workspace folder). dropbox_client_path follows the Dropbox connection and workspace_folder follows the slug, so neither is set here.",
+    "Change a client's workspace settings, incl. the brand's ad languages (main_language + up to 2 translation_languages). Omitted fields stay as they are. slug is refused once client setup has run (it names the workspace folder). dropbox_client_path follows the Dropbox connection and workspace_folder follows the slug, so neither is set here.",
     {
       account_id: z.string().describe("Brand id from list_brands"),
       client_status: z.enum(["active", "archived", "internal"]).optional(),
@@ -183,6 +183,11 @@ export function registerTools(server, rpc) {
       kb_workspace_id: z.string().nullable().optional().describe("Kennisbank workspace id (list_kb_workspaces) to link as the second brain"),
       raw_footage_paths: z.array(z.string()).optional().describe("Dropbox paths, e.g. /CLIENTS/Active/Dr. Kegel/01_video/01_raw footage"),
       claude_project_name: z.string().optional(),
+      main_language: z.string().optional().describe("Ad languages: the main (script base) language for new concepts, full-written, e.g. Dutch"),
+      translation_languages: z
+        .array(z.string())
+        .optional()
+        .describe("Ad languages: up to 2 translation languages, full-written (e.g. [\"French\", \"English\"]). New concepts get a script tab for each. [] clears them."),
     },
     async (args) => ok(await rpc("update_brand_settings", args))
   );
@@ -222,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"]),
@@ -368,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 }))
   );
@@ -398,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)"),
@@ -438,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"),
     },
@@ -537,6 +543,19 @@ export function registerTools(server, rpc) {
     async ({ concept_id, confirm_code }) => ok(await rpc("delete_concept", { concept_id, confirm_code }))
   );
 
+  server.tool(
+    "apply_brand_languages",
+    "Bring existing concepts in line with the brand's ad languages (get_brand → ad_languages; change them with update_brand_settings). Pick concepts by concept_ids and/or stage (stage key like copy_check or the column name like \"Copy check\"); max 100 per call. Per concept: the base language becomes the brand's main language (the base text is re-labelled, not translated) and every script gets a tab for each missing brand language, holding a copy of the base text. Existing tabs are never changed or removed. dry_run: true shows the plan only. More than 10 concepts to change returns a preview first — show it to the user, then call again with confirm: true. Returns per concept what changed, the new tabs (script_id + language) and the linked ad copy with its language. LOTUX does not translate: afterwards write each translation with save_script and fix ad copy languages with update_copy / add_copy_translation.",
+    {
+      account_id: z.string().describe("Brand id from list_brands"),
+      concept_ids: z.array(z.string()).optional(),
+      stage: z.string().optional().describe("Stage key (copy_check) or column name (Copy check)"),
+      dry_run: z.boolean().optional(),
+      confirm: z.boolean().optional().describe("Required when more than 10 concepts would change"),
+    },
+    async (args) => ok(await rpc("apply_brand_languages", args))
+  );
+
   server.tool(
     "set_base_language",
     "Set the concept's base script language, e.g. English. Existing base-language script texts are re-labelled to the new language.",