@glie/mcp-polaris 0.6.0 → 0.7.0

package/dist/index.js

@@ -220,14 +220,19 @@ var TOOLS = [
   },
   {
     name: "polaris.task.create",
-    description: "Create a task within a milestone. For a marketing CREATIVE (a task in an mkt campaign): channel + format + scheduled_date (the publish day / calendar slot) + platform (if this creative is individually paid).",
+    description: "Create a task within a milestone. For a marketing CREATIVE (a task in an mkt campaign): channel + format + scheduled_date (the publish day / calendar slot) + platform (if this creative is individually paid). A CAROUSEL (format=carrossel) also requires `slides` (2..10) \u2014 without it the call is refused, because a carousel with no declared size ships one image.",
     inputSchema: objSchema({
       milestone_id: intSchema(),
       name: strSchema(),
       description_md: strSchema(),
       status: strSchema("draft|backlog|dev|test|approval|release (default draft)"),
       channel: strSchema("mkt: Instagram, TikTok, LinkedIn, \u2026"),
-      format: strSchema("mkt: post, reel, story, artigo, \u2026"),
+      format: strSchema("mkt: post, carrossel, reel, story, artigo, \u2026"),
+      slides: intSchema("mkt: REQUIRED when format is a carousel \u2014 how many images the piece has (2..10). " + "It is a contract: the generator delivers exactly this many. Omit for every other format."),
+      medium: strSchema("mkt: what the piece IS \u2014 image | video | text. The engine follows it (Codex, Remotion, " + "the writer). A carousel is `image` with slides > 1: only an image has more than one."),
+      surface: strSchema("mkt: where it publishes \u2014 feed | stories | reels | shorts | article | newsletter. It is " + "what separates a reel from a story: same medium, same 9:16, different place (and a " + "story is gone in 24h)."),
+      aspect: strSchema("mkt: the piece's SHAPE \u2014 1:1 | 4:5 | 9:16 | 16:9 | 2:3. The format says what the piece " + "IS (post, carrossel, reel), this says how it is framed, and they are independent: a " + "carousel can be vertical, a reel can be square. Omit to take the channel's usual one."),
+      output_type: strSchema("pr|post|video|email|generic \u2014 the delivery medium. Omit it: the format decides (reel/v\xEDdeo/short \u2192 video). Only pass it to override."),
       scheduled_date: strSchema("mkt: publish day (ISO date) \u2014 the calendar slot"),
       platform: strSchema("mkt: ad platform if this creative is individually paid"),
       asset_url: strSchema("mkt: URL of the produced creative asset (image/video) for the reviewer")
@@ -241,7 +246,8 @@ var TOOLS = [
       id: intSchema(),
       name: strSchema(),
       description_md: strSchema("full markdown brief; replaces the current description"),
-      asset_url: strSchema("mkt: URL of the produced creative asset (image/video) for the reviewer")
+      asset_url: strSchema("mkt: URL of the produced creative asset (image/video) for the reviewer"),
+      output_type: strSchema("pr|post|video|email|generic \u2014 fix the delivery medium of a task filed with the wrong one (it routes the worker to the video or the image pipeline).")
     }, ["id"]),
     call: async (args) => {
       const body = {};
@@ -251,6 +257,8 @@ var TOOLS = [
         body.description_md = args.description_md;
       if (typeof args.asset_url === "string")
         body.asset_url = args.asset_url;
+      if (typeof args.output_type === "string")
+        body.output_type = args.output_type;
       return (await apiCall("PATCH", `/api/tasks/${args.id}`, body)).body;
     }
   },
@@ -262,10 +270,28 @@ var TOOLS = [
   },
   {
     name: "polaris.task.approve",
-    description: "The human review gate: approve a task in `approval` \u2192 it advances toward release. Human-only. To ship several approval tasks of one milestone together, group them into a stack and use polaris.stack.release instead.",
+    description: "The human review gate: approve a dev task in `approval` \u2192 it advances toward release. Human-only. NOT valid for mkt creatives (output_type=post/video/etc.) \u2014 use polaris.task.schedule or polaris.task.mark_published instead. To ship several approval tasks together, group them into a stack and use polaris.stack.release.",
     inputSchema: objSchema({ id: intSchema() }, ["id"]),
     call: async (args) => (await apiCall("POST", `/api/tasks/${args.id}/approve`)).body
   },
+  {
+    name: "polaris.task.schedule",
+    description: "Schedule a mkt creative for publication: approval \u2192 agendado. The creative must be bound to an active social account (resolved from its market + channel) and have a publish_at in the future. Its copy is frozen while scheduled \u2014 editing it requires unscheduling first.",
+    inputSchema: objSchema({ id: intSchema() }, ["id"]),
+    call: async (args) => (await apiCall("POST", `/api/tasks/${args.id}/schedule`)).body
+  },
+  {
+    name: "polaris.task.unschedule",
+    description: "Unschedule a mkt creative: agendado \u2192 approval. Refused once the post is live. The creative returns to approval for edits or re-scheduling.",
+    inputSchema: objSchema({ id: intSchema() }, ["id"]),
+    call: async (args) => (await apiCall("POST", `/api/tasks/${args.id}/unschedule`)).body
+  },
+  {
+    name: "polaris.task.mark_published",
+    description: "Manually mark a mkt creative as published: approval \u2192 release (bypasses scheduling). Recorded as a manual human action. Use when the post was published outside the scheduler.",
+    inputSchema: objSchema({ id: intSchema() }, ["id"]),
+    call: async (args) => (await apiCall("POST", `/api/tasks/${args.id}/mark-published`)).body
+  },
   {
     name: "polaris.task.dep_add",
     description: "Add a dependency edge (cycle-checked).",
@@ -529,11 +555,10 @@ var TOOLS = [
   },
   {
     name: "polaris.project.update",
-    description: "Update a project (human-only): repo_url, description_md, name, status (active|paused|archived), owner_human_id.",
+    description: "Update a project (human-only): repo_url, name, status (active|paused|archived), owner_human_id. Brand/context live in the CLAUDE.md \u2014 use polaris.project.claude_md_set.",
     inputSchema: objSchema({
       key: strSchema("project key"),
       name: strSchema(),
-      description_md: strSchema(),
       repo_url: strSchema("github.com repo URL"),
       status: strSchema("active|paused|archived"),
       owner_human_id: intSchema()
@@ -609,6 +634,24 @@ var TOOLS = [
     ]),
     call: async (args) => (await apiCall("POST", `/api/agents/${args.id}/claude-login/code`, { code: args.code })).body
   },
+  {
+    name: "polaris.agent.claude_logout",
+    description: "Log an agent out of Claude (human-only): deletes its stored credentials and clears the login. Use when claude_login_status is 'expired' to force a clean re-login.",
+    inputSchema: objSchema({ id: intSchema("agent id") }, ["id"]),
+    call: async (args) => (await apiCall("POST", `/api/agents/${args.id}/claude-login/logout`)).body
+  },
+  {
+    name: "polaris.agent.codex_login",
+    description: "Kick off a generator agent's Codex device-login (human-only). Poll agent.get for codex_login_url, then approve it in the browser \u2014 no code to paste back.",
+    inputSchema: objSchema({ id: intSchema("agent id") }, ["id"]),
+    call: async (args) => (await apiCall("POST", `/api/agents/${args.id}/codex-login`)).body
+  },
+  {
+    name: "polaris.agent.codex_logout",
+    description: "Log an agent out of Codex (human-only): deletes its stored auth and clears the login. Use when codex_login_status is 'expired' to force a clean re-login.",
+    inputSchema: objSchema({ id: intSchema("agent id") }, ["id"]),
+    call: async (args) => (await apiCall("POST", `/api/agents/${args.id}/codex-login/logout`)).body
+  },
   {
     name: "polaris.milestone.create",
     description: "Create a milestone. team=dev|mkt; end_date = deadline (ISO date, required). For a marketing CAMPAIGN (team=mkt) these extra fields carry the plan: market (BR/US/EU), cadence (per-channel rules Discovery expands into dated creatives), max_creatives (cap on that expansion), and paid + platforms + budget for a paid campaign.",

package/package.json

@@ -1,14 +1,18 @@
 {
   "name": "@glie/mcp-polaris",
-  "version": "0.6.0",
-  "description": "Model Context Protocol (stdio) server exposing Polaris — glie's ops platform — as native tools in Claude Code and any MCP client.",
+  "version": "0.7.0",
+  "description": "Model Context Protocol (stdio) server exposing Polaris \u2014 glie's ops platform \u2014 as native tools in Claude Code and any MCP client.",
   "license": "Apache-2.0",
   "author": "glie <carlos@glie.ai>",
   "type": "module",
   "bin": {
     "mcp-polaris": "dist/index.js"
   },
-  "files": ["dist", "README.md", "LICENSE"],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "engines": {
     "node": ">=18"
   },
@@ -21,7 +25,14 @@
     "directory": "packages/mcp-polaris"
   },
   "homepage": "https://polaris.glie.ai",
-  "keywords": ["mcp", "model-context-protocol", "claude", "claude-code", "polaris", "glie"],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "claude",
+    "claude-code",
+    "polaris",
+    "glie"
+  ],
   "scripts": {
     "build": "bun run build.ts",
     "prepublishOnly": "bun run build.ts"