@glie/mcp-polaris 0.5.0 → 0.7.0

package/dist/index.js

@@ -220,17 +220,34 @@ var TOOLS = [
   },
   {
     name: "polaris.task.create",
-    description: "Create a task within a milestone.",
-    inputSchema: objSchema({ milestone_id: intSchema(), name: strSchema(), description_md: strSchema() }, ["milestone_id", "name"]),
+    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, 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")
+    }, ["milestone_id", "name"]),
     call: async (args) => (await apiCall("POST", "/api/tasks", args)).body
   },
   {
     name: "polaris.task.update",
-    description: "Correct or refine a task's spec \u2014 PATCH its description_md (and optionally name). Use this to sharpen an underspecified brief so the implementing agent gets better results; it is NOT a log of what was done (leave that as a comment). Needs a token.",
+    description: "Correct or refine a task's spec \u2014 PATCH its description_md (and optionally name). For a marketing creative, set asset_url to the produced asset (image/video) so the reviewer can download and review it. It is NOT a log of what was done (leave that as a comment). Needs a token.",
     inputSchema: objSchema({
       id: intSchema(),
       name: strSchema(),
-      description_md: strSchema("full markdown brief; replaces the current description")
+      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"),
+      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 = {};
@@ -238,6 +255,10 @@ var TOOLS = [
         body.name = args.name;
       if (typeof args.description_md === "string")
         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;
     }
   },
@@ -249,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).",
@@ -339,12 +378,12 @@ var TOOLS = [
   },
   {
     name: "polaris.ticket.update",
-    description: "Update a ticket's type, its human assignee, and/or its guidance (the communicator's orientation on what to do/say next).",
+    description: "Update a ticket's type, its human assignee, and/or its guidance (the helpdesker's orientation on what to do/say next).",
     inputSchema: objSchema({
       id: intSchema(),
       type: strSchema("bug|question|suggestion|feedback"),
       assignee_human_id: intSchema(),
-      guidance: strSchema("The communicator's guidance on what to do/say next \u2014 orientation (e.g. create an issue, inform, reassure), researched from the customer's history + related issues. Shown to the human as advice; NOT inserted into the reply box.")
+      guidance: strSchema("The helpdesker's guidance on what to do/say next \u2014 orientation (e.g. create an issue, inform, reassure), researched from the customer's history + related issues. Shown to the human as advice; NOT inserted into the reply box.")
     }, ["id"]),
     call: async (args) => (await apiCall("PATCH", `/api/tickets/${args.id}`, {
       type: args.type,
@@ -377,20 +416,23 @@ var TOOLS = [
   },
   {
     name: "polaris.issue.open",
-    description: "Open a STANDALONE issue (no ticket needed) \u2014 e.g. an internal dev files a bug. Scope with project_key.",
-    inputSchema: objSchema({ project_key: strSchema(), title: strSchema() }, [
-      "project_key",
-      "title"
-    ]),
+    description: "Open a STANDALONE issue (no ticket needed) \u2014 e.g. an internal dev files a bug. Scope with project_key. owner_human_id = the human accountable (defaults to you).",
+    inputSchema: objSchema({ project_key: strSchema(), title: strSchema(), owner_human_id: intSchema() }, ["project_key", "title"]),
     call: async (args) => (await apiCall("POST", "/api/issues", args)).body
   },
   {
     name: "polaris.issue.update",
-    description: "Update an issue \u2014 set its title and/or assign it to an agent (assignee_agent_id, e.g. hand it to a planner).",
-    inputSchema: objSchema({ id: intSchema(), title: strSchema(), assignee_agent_id: intSchema() }, ["id"]),
+    description: "Update an issue \u2014 set its title, assign it to an agent (assignee_agent_id, e.g. hand it to a planner), and/or set its owner (owner_human_id, the accountable human).",
+    inputSchema: objSchema({
+      id: intSchema(),
+      title: strSchema(),
+      assignee_agent_id: intSchema(),
+      owner_human_id: intSchema()
+    }, ["id"]),
     call: async (args) => (await apiCall("PATCH", `/api/issues/${args.id}`, {
       title: args.title,
-      assignee_agent_id: args.assignee_agent_id
+      assignee_agent_id: args.assignee_agent_id,
+      owner_human_id: args.owner_human_id
     })).body
   },
   {
@@ -513,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()
@@ -535,10 +576,10 @@ var TOOLS = [
   },
   {
     name: "polaris.agent.create",
-    description: "Create an agent/employee (human-only). function: developer|tester|planner|communicator; product = project key; team = dev|mkt; domain optional (roadmap|helpdesk|both).",
+    description: "Create an agent/employee (human-only). function: developer|tester|planner|helpdesker; product = project key; team = dev|mkt; domain optional (roadmap|helpdesk|both).",
     inputSchema: objSchema({
       agent_id_slug: strSchema("stable slug, e.g. developer-polaris-01"),
-      function: strSchema("developer|tester|planner|communicator"),
+      function: strSchema("developer|tester|planner|helpdesker"),
       product: strSchema("project key"),
       name: strSchema("friendly display name"),
       team: strSchema("dev|mkt"),
@@ -593,16 +634,61 @@ 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); framework_key optional.",
+    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.",
     inputSchema: objSchema({
       project_key: strSchema(),
       name: strSchema(),
       team: strSchema("dev|mkt"),
       end_date: strSchema("ISO date, e.g. 2026-06-30"),
+      start_date: strSchema("ISO date (optional)"),
       framework_key: strSchema(),
-      description_md: strSchema()
+      description_md: strSchema(),
+      market: {
+        type: "array",
+        items: { type: "string" },
+        description: "mkt: target markets \u2014 any of BR, US, EU"
+      },
+      cadence: {
+        type: "array",
+        description: "mkt: per-channel cadence rules Discovery expands into dated creatives",
+        items: {
+          type: "object",
+          properties: {
+            channel: { type: "string", description: "Instagram, TikTok, LinkedIn, \u2026" },
+            format: { type: "string", description: "post, reel, story, artigo, \u2026" },
+            n: { type: "integer", description: "count per period" },
+            per: { type: "string", description: "day | week" }
+          }
+        }
+      },
+      max_creatives: intSchema("mkt: cap on how many creatives Discovery/cadence may generate"),
+      paid: { type: "boolean", description: "mkt: is the whole campaign paid?" },
+      platforms: {
+        type: "array",
+        items: { type: "string" },
+        description: "mkt paid: any of Meta, Google, Reddit, LinkedIn, TikTok, YouTube"
+      },
+      budget: { type: "number", description: "mkt: campaign ad-spend budget (\u20AC)" }
     }, ["project_key", "name", "team", "end_date"]),
     call: async (args) => (await apiCall("POST", "/api/milestones", args)).body
   },
@@ -677,7 +763,7 @@ var TOOLS = [
   },
   {
     name: "polaris.team.create",
-    description: 'Create a team (human-only). requires = capability keys (e.g. ["repo"]); functions = agent functions it runs (developer|tester|planner|communicator).',
+    description: 'Create a team (human-only). requires = capability keys (e.g. ["repo"]); functions = agent functions it runs (developer|tester|planner|helpdesker).',
     inputSchema: objSchema({
       key: strSchema("team key, e.g. dev"),
       name: strSchema(),
@@ -689,7 +775,7 @@ var TOOLS = [
       functions: {
         type: "array",
         items: { type: "string" },
-        description: "developer|tester|planner|communicator"
+        description: "developer|tester|planner|helpdesker"
       },
       framework_key: strSchema()
     }, ["key", "name"]),

package/package.json

@@ -1,14 +1,18 @@
 {
   "name": "@glie/mcp-polaris",
-  "version": "0.5.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"