@byldd/seo-tools-plugin 1.0.0 → 1.0.2

package/dist/manifest.js

@@ -1,3 +1,14 @@
+// src/types/index.ts
+var RerunStage = /* @__PURE__ */ ((RerunStage2) => {
+  RerunStage2["GEO"] = "geo";
+  RerunStage2["SCHEMA"] = "schema";
+  RerunStage2["OUTLINE"] = "outline";
+  RerunStage2["ENRICHMENT"] = "enrichment";
+  RerunStage2["INTENT"] = "intent";
+  RerunStage2["STRATEGY"] = "strategy";
+  return RerunStage2;
+})(RerunStage || {});
+
 // src/manifest.ts
 var manifest = {
   id: "byldd.seo-tools",
@@ -55,9 +66,9 @@ var manifest = {
   },
   tools: [
     {
-      name: "runKeywordResearch",
-      displayName: "Run Keyword Research",
-      description: "Call this when user asks for keyword research or Keyword Planner. Starts an async job \u2014 returns a keywordSessionRef immediately. Research takes ~20-30s. Wait ~20 seconds, then poll getKeywordSessionStatus every 10 seconds until status is 'completed' or 'failed' (max ~16 attempts, ~3 min).",
+      name: "startKeywordResearch",
+      displayName: "Start a New Keyword Research",
+      description: "ONLY entry point for new keyword research. Handles discovery AND enrichment in one pipeline. Returns a keywordSessionRef immediately \u2014 the job runs in the background. Research typically takes ~20-30s. Wait ~20 seconds, then poll getKeywordSessionStatus with that keywordSessionRef every 10 seconds until status is 'completed' or 'failed'. Max ~16 poll attempts (~3 minutes including the initial wait) before reporting timeout.",
       parametersSchema: {
         type: "object",
         properties: {
@@ -69,7 +80,7 @@ var manifest = {
     {
       name: "getKeywordSessionStatus",
       displayName: "Get Keyword Session Status",
-      description: "Poll the status of a KeywordSession started with runKeywordResearch. Wait ~20 seconds before the first poll, then call every 10 seconds until status is 'completed' or 'failed' (max ~16 attempts, ~3 min).",
+      description: "Poll the status of a KeywordSession started by startKeywordResearch. Wait ~20 seconds before the first poll (research takes ~20-30s), then call every 10 seconds. Stop when status is 'completed' or 'failed'. Max ~16 attempts (~3 min) \u2014 if still running after that, report timeout to the user and stop. When status is 'completed', the response contains the keywordSessionRef \u2014 the single id for this research run; pass it to clusterKeywords. Save it.",
       parametersSchema: {
         type: "object",
         properties: {
@@ -79,33 +90,9 @@ var manifest = {
       }
     },
     {
-      name: "enrichKeywords",
-      displayName: "Enrich Keywords",
-      description: "Use only to re-enrich an EXISTING session that was previously discovered. For new keyword research, use runKeywordResearch which handles everything end-to-end.",
-      parametersSchema: {
-        type: "object",
-        properties: {
-          keywordSessionRef: { type: "string" }
-        },
-        required: ["keywordSessionRef"]
-      }
-    },
-    {
-      name: "getKeywordSuggestions",
-      displayName: "Get Keyword Suggestions",
-      description: "List raw expansion keywords for a session WITHOUT triggering the costly enrich step.",
-      parametersSchema: {
-        type: "object",
-        properties: {
-          keywordSessionRef: { type: "string" }
-        },
-        required: ["keywordSessionRef"]
-      }
-    },
-    {
-      name: "listKeywordSessions",
+      name: "listKeywordResearchSessions",
       displayName: "List Keyword Sessions",
-      description: "List all past keyword research sessions.",
+      description: "List all past keyword research sessions with a brief overview \u2014 seedKeyword, status, and keyword count only.",
       parametersSchema: {
         type: "object",
         properties: {}
@@ -114,7 +101,7 @@ var manifest = {
     {
       name: "clusterKeywords",
       displayName: "Cluster Keywords",
-      description: "Call this AFTER getKeywordSessionStatus returns 'completed' (and the user approves). Group enriched keywords into topical clusters. Returns a clusterId. Clustering can take ~20s to 1 min or more. Wait ~20 seconds, then poll getClusterStatus every 15 seconds until status is 'completed' (max ~18 attempts, ~5 min).",
+      description: "Call this AFTER getKeywordSessionStatus returns 'completed'. Pass the keywordSessionRef from that completed response (or from listKeywordResearchSessions). Returns a clusterId. Clustering can take ~20s to 1 min or more. Wait ~20 seconds, then poll getClusterStatus every 15 seconds until status is 'completed'. Max ~18 attempts (~5 min) before reporting timeout.",
       parametersSchema: {
         type: "object",
         properties: {
@@ -126,7 +113,7 @@ var manifest = {
     {
       name: "getClusterStatus",
       displayName: "Get Cluster Status",
-      description: "Fetch status and results of a clustering session. After clusterKeywords, wait ~20 seconds, then poll every 15 seconds until status is completed (max ~18 attempts, ~5 min).",
+      description: "Poll the status of a clustering job. After clusterKeywords, wait ~20 seconds, then call every 15 seconds until status is 'completed' or 'failed'. Max ~18 attempts (~5 min) before reporting timeout. When completed, the response contains the full cluster plan \u2014 render it as a Markdown table immediately.",
       parametersSchema: {
         type: "object",
         properties: {
@@ -138,7 +125,7 @@ var manifest = {
     {
       name: "listClusterSessions",
       displayName: "List Cluster Sessions",
-      description: "List all past clustering sessions.",
+      description: "List all past clustering sessions with a brief overview \u2014 seedKeyword, status, and keyword count only.",
       parametersSchema: {
         type: "object",
         properties: {}
@@ -147,7 +134,7 @@ var manifest = {
     {
       name: "generateContentBrief",
       displayName: "Generate Content Brief",
-      description: "Call this once user approves a cluster. Returns a briefId. You MUST then poll getBriefStatus until status is 'COMPLETED'. Start the async content-brief pipeline.",
+      description: "Call this once user approves a cluster or passed only a keyword. Returns a briefId. You MUST then poll getBriefStatus until status is 'COMPLETED'. When source is 'cluster', clusterSessionRef is REQUIRED (the clusterId from a completed clusterKeywords run); for source 'standalone' omit clusterSessionRef and pass only keyword.",
       parametersSchema: {
         type: "object",
         properties: {
@@ -190,7 +177,10 @@ var manifest = {
         type: "object",
         properties: {
           briefId: { type: "string" },
-          stage: { type: "string" }
+          stage: {
+            type: "string",
+            enum: Object.values(RerunStage)
+          }
         },
         required: ["briefId", "stage"]
       }

package/dist/manifest.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
-  "sources": ["../src/manifest.ts"],
-  "sourcesContent": ["import type { PaperclipPluginManifestV1 } from \"@paperclipai/plugin-sdk\";\n\nconst manifest: PaperclipPluginManifestV1 = {\n  id: \"byldd.seo-tools\",\n  apiVersion: 1,\n  version: \"0.1.0\",\n  displayName: \"Seo Tools\",\n  description: \"A Paperclip plugin\",\n  author: \"Plugin Author\",\n  categories: [\"connector\"],\n  capabilities: [\n    \"agent.tools.register\",\n    \"http.outbound\",\n    \"ui.detailTab.register\",\n    \"events.subscribe\",\n    \"plugin.state.read\",\n    \"plugin.state.write\",\n    \"ui.dashboardWidget.register\",\n  ],\n  instanceConfigSchema: {\n    type: \"object\",\n    properties: {\n      backendUrl: {\n        type: \"string\",\n        title: \"Backend URL\",\n        description: \"Base URL of the SEO Byldd Server\",\n      },\n      authToken: {\n        type: \"string\",\n        title: \"Auth Token\",\n        description: \"JWT auth token for the SEO Byldd Server\",\n      },\n    },\n    required: [\"backendUrl\", \"authToken\"],\n  },\n  entrypoints: {\n    worker: \"./dist/worker.js\",\n    ui: \"./dist/ui\",\n  },\n  ui: {\n    slots: [\n      {\n        type: \"dashboardWidget\",\n        id: \"health-widget\",\n        displayName: \"Seo Tools Health\",\n        exportName: \"DashboardWidget\",\n      },\n      {\n        type: \"detailTab\",\n        id: \"keyword-research-tab\",\n        displayName: \"Keyword Research\",\n        exportName: \"KeywordResearchTab\",\n        entityTypes: [\"issue\"],\n      },\n    ],\n  },\n  tools: [\n    {\n      name: \"runKeywordResearch\",\n      displayName: \"Run Keyword Research\",\n      description:\n        \"Call this when user asks for keyword research or Keyword Planner. Starts an async job \u2014 returns a keywordSessionRef immediately. Research takes ~20-30s. Wait ~20 seconds, then poll getKeywordSessionStatus every 10 seconds until status is 'completed' or 'failed' (max ~16 attempts, ~3 min).\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          keyword: { type: \"string\" },\n        },\n        required: [\"keyword\"],\n      },\n    },\n    {\n      name: \"getKeywordSessionStatus\",\n      displayName: \"Get Keyword Session Status\",\n      description:\n        \"Poll the status of a KeywordSession started with runKeywordResearch. Wait ~20 seconds before the first poll, then call every 10 seconds until status is 'completed' or 'failed' (max ~16 attempts, ~3 min).\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          keywordSessionRef: { type: \"string\" },\n        },\n        required: [\"keywordSessionRef\"],\n      },\n    },\n    {\n      name: \"enrichKeywords\",\n      displayName: \"Enrich Keywords\",\n      description:\n        \"Use only to re-enrich an EXISTING session that was previously discovered. For new keyword research, use runKeywordResearch which handles everything end-to-end.\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          keywordSessionRef: { type: \"string\" },\n        },\n        required: [\"keywordSessionRef\"],\n      },\n    },\n    {\n      name: \"getKeywordSuggestions\",\n      displayName: \"Get Keyword Suggestions\",\n      description:\n        \"List raw expansion keywords for a session WITHOUT triggering the costly enrich step.\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          keywordSessionRef: { type: \"string\" },\n        },\n        required: [\"keywordSessionRef\"],\n      },\n    },\n    {\n      name: \"listKeywordSessions\",\n      displayName: \"List Keyword Sessions\",\n      description: \"List all past keyword research sessions.\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {},\n      },\n    },\n    {\n      name: \"clusterKeywords\",\n      displayName: \"Cluster Keywords\",\n      description:\n        \"Call this AFTER getKeywordSessionStatus returns 'completed' (and the user approves). Group enriched keywords into topical clusters. Returns a clusterId. Clustering can take ~20s to 1 min or more. Wait ~20 seconds, then poll getClusterStatus every 15 seconds until status is 'completed' (max ~18 attempts, ~5 min).\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          keywordSessionRef: { type: \"string\" },\n        },\n        required: [\"keywordSessionRef\"],\n      },\n    },\n    {\n      name: \"getClusterStatus\",\n      displayName: \"Get Cluster Status\",\n      description:\n        \"Fetch status and results of a clustering session. After clusterKeywords, wait ~20 seconds, then poll every 15 seconds until status is completed (max ~18 attempts, ~5 min).\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          clusterId: { type: \"string\" },\n        },\n        required: [\"clusterId\"],\n      },\n    },\n    {\n      name: \"listClusterSessions\",\n      displayName: \"List Cluster Sessions\",\n      description: \"List all past clustering sessions.\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {},\n      },\n    },\n    {\n      name: \"generateContentBrief\",\n      displayName: \"Generate Content Brief\",\n      description:\n        \"Call this once user approves a cluster. Returns a briefId. You MUST then poll getBriefStatus until status is 'COMPLETED'. Start the async content-brief pipeline.\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          source: { type: \"string\", enum: [\"cluster\", \"standalone\"] },\n          keyword: { type: \"string\" },\n          clusterSessionRef: { type: \"string\" },\n          isSelfReferentialListicle: { type: \"boolean\" },\n        },\n        required: [\"source\", \"keyword\"],\n      },\n    },\n    {\n      name: \"getBriefStatus\",\n      displayName: \"Get Brief Status\",\n      description:\n        \"Fetch the current state of a brief. Poll this until status is COMPLETED.\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          briefId: { type: \"string\" },\n        },\n        required: [\"briefId\"],\n      },\n    },\n    {\n      name: \"listContentBriefs\",\n      displayName: \"List Content Briefs\",\n      description: \"List content briefs, optionally filtered by cluster.\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          clusterSessionRef: { type: \"string\" },\n        },\n      },\n    },\n    {\n      name: \"rerunBriefStage\",\n      displayName: \"Rerun Brief Stage\",\n      description: \"Regenerate a single stage of the brief pipeline.\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          briefId: { type: \"string\" },\n          stage: { type: \"string\" },\n        },\n        required: [\"briefId\", \"stage\"],\n      },\n    },\n    {\n      name: \"attachProofPoints\",\n      displayName: \"Attach Proof Points\",\n      description: \"Inject business-specific proof points into a brief.\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          briefId: { type: \"string\" },\n          pricingRanges: { type: \"string\" },\n          timelines: { type: \"string\" },\n          clientOutcomes: { type: \"array\", items: { type: \"string\" } },\n          methodology: { type: \"string\" },\n        },\n        required: [\"briefId\"],\n      },\n    },\n  ],\n};\n\nexport default manifest;\n"],
-  "mappings": "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",
-  "names": []
+  "sources": ["../src/types/index.ts", "../src/manifest.ts"],
+  "sourcesContent": ["// Tool param types \u2014 mirror parametersSchema definitions in worker.ts\nexport interface RunKeywordResearchParams {\n  keyword: string;\n}\n\nexport interface GetKeywordSessionStatusParams {\n  keywordSessionRef: string;\n}\n\nexport interface ClusterKeywordsParams {\n  keywordSessionRef: string;\n}\n\nexport interface GetClusterStatusParams {\n  clusterId: string;\n}\n\nexport enum BriefSource {\n  CLUSTER = \"cluster\",\n  STANDALONE = \"standalone\",\n}\n\nexport interface GenerateContentBriefParams {\n  source: BriefSource;\n  keyword: string;\n  clusterSessionRef?: string;\n  isSelfReferentialListicle?: boolean;\n}\n\nexport interface GetBriefStatusParams {\n  briefId: string;\n}\n\nexport interface ListContentBriefsParams {\n  clusterSessionRef?: string;\n}\n\nexport interface RerunBriefStageParams {\n  briefId: string;\n  stage: RerunStage;\n}\n\nexport interface AttachProofPointsParams {\n  briefId: string;\n  pricingRanges?: string;\n  timelines?: string;\n  clientOutcomes?: string[];\n  methodology?: string;\n}\n\n// Keyword session status\nexport enum KeywordSessionStatus {\n  PENDING = \"pending\",\n  DISCOVERING = \"discovering\",\n  ENRICHING = \"enriching\",\n  COMPLETED = \"completed\",\n  FAILED = \"failed\",\n}\n\n// Raw KeywordSession item as returned by GET /api/keyword-research/.\n// Mongo ObjectIds and Dates are serialized to strings over JSON.\nexport interface KeywordSessionApiItem {\n  _id: string;\n  seedKeyword: string;\n  status: KeywordSessionStatus;\n  keywordCount?: number;\n  createdAt: string;\n}\n\n// Output of listKeywordResearchSessions \u2014 one summary row per session.\nexport interface KeywordResearchSessionSummary {\n  keywordSessionRef: string;\n  seedKeyword: string;\n  status: KeywordSessionStatus;\n  keywordCount: number;\n  createdAt: string;\n}\n\n// Brief pipeline rerun stages\nexport enum RerunStage {\n  GEO = \"geo\",\n  SCHEMA = \"schema\",\n  OUTLINE = \"outline\",\n  ENRICHMENT = \"enrichment\",\n  INTENT = \"intent\",\n  STRATEGY = \"strategy\",\n}\n\n// Clustering session status\nexport enum ClusterStatus {\n  PENDING = \"pending\",\n  FETCHING_SERPS = \"fetching_serps\",\n  PROCESSING = \"processing\",\n  ARCHITECTING = \"architecting\",\n  COMPLETED = \"completed\",\n  FAILED = \"failed\",\n}\n\n// Raw ClusterSession item as returned by GET /api/clustering/.\n// Mongo ObjectIds and Dates are serialized to strings over JSON.\nexport interface ClusterSessionApiItem {\n  _id: string;\n  seedKeyword?: string;\n  status: ClusterStatus;\n  keywordCount?: number;\n  createdAt: string;\n}\n\n// Output of listClusterSessions \u2014 one summary row per session.\nexport interface ClusterSessionSummary {\n  clusterId: string;\n  seedKeyword?: string;\n  status: ClusterStatus;\n  keywordCount: number;\n  createdAt: string;\n}\n\n// Raw ContentBrief item as returned by GET /api/content-brief/ (list).\n// Mongo ObjectIds and Dates are serialized to strings over JSON.\nexport interface ContentBriefApiItem {\n  _id: string;\n  keyword: string;\n  status: string;\n  createdAt: string;\n  updatedAt: string;\n}\n\n// Output of listContentBriefs \u2014 one summary row per brief.\nexport interface ContentBriefSummary {\n  briefId: string;\n  keyword: string;\n  status: string;\n  createdAt: string;\n  updatedAt: string;\n}\n\n// Cluster plan shapes\nexport interface ClusterPost {\n  keyword: string;\n  volume: number;\n  intent: string;\n  pageType: string;\n  title: string;\n}\n\nexport interface ClusterGroup {\n  name: string;\n  posts: ClusterPost[];\n}\n\nexport interface ClusterPillar {\n  keyword: string;\n  volume: number;\n  intent: string;\n  pageType: string;\n  title: string;\n}\n\nexport interface ClusterLandingPage {\n  keyword: string;\n  pageType: string;\n  urlSlug: string;\n}\n\nexport interface ClusterInternalLinking {\n  pillarLinksTo: string[];\n  spokesLinkTo: string[];\n}\n\nexport interface ClusterArchitecture {\n  pillar: ClusterPillar | null;\n  clusters: ClusterGroup[];\n  landingPage: ClusterLandingPage | null;\n  internalLinking: ClusterInternalLinking | null;\n}\n\n// Brief writer-view shapes \u2014 the trimmed projection getBriefStatus returns to\n// the agent. Only the writer-facing fields survive; raw SERP/enrichment/schema\n// JSON, EEAT, and ops/meta are dropped here so RENDERING.md never has to.\nexport interface BriefOutlineSectionView {\n  heading: string;\n  level: number;\n  wordCount: number;\n  importance: string | null;\n  format: string;\n  guidance: string;\n  subSections?: BriefOutlineSectionView[];\n}\n\nexport interface BriefInternalLinkView {\n  anchor: string;\n  targetUrl: string;\n  reason: string;\n}\n\nexport interface BriefClusterSpokeView {\n  keyword: string;\n  title: string;\n  url: string;\n}\n\nexport interface BriefWriterView {\n  status: string;\n  // Q1 \u2014 page identity\n  pageType: string;\n  intent: string;\n  targetKeyword: string;\n  targetAudience?: string;\n  priorityScore?: number;\n  priorityTier?: string;\n  clusterPosition?: string;\n  recommendedTitle?: string;\n  metaDescription?: string;\n  urlSlug?: string;\n  // Q2 \u2014 coverage & depth\n  supportingKeywords: string[];\n  mustAnswer: string[];\n  niceToAnswer: string[];\n  targetWordCount?: number;\n  competitorAvgWordCount?: number;\n  outline: BriefOutlineSectionView[];\n  // coverage checklist material (derived from coverageMatrix)\n  requiredTopics: string[];\n  contentGaps: string[];\n  differentiatorOpportunities: string[];\n  faq: string[];\n  // Q3 \u2014 citability\n  tldrBlock?: {\n    text: string;\n    wordCount: number;\n    placement: string;\n    fsTarget: boolean;\n  };\n  objectiveLanguageInstruction?: string;\n  requiredSignals: string[];\n  schemaRequired: string[];\n  // Q4 \u2014 differentiation\n  contentAngle?: string;\n  competitorGap?: string;\n  mustOwnTopics: string[];\n  uniqueAssets: string[];\n  proofPointsToInclude: string[];\n  competitorBlindSpots: string[];\n  competitorPagesToReference: string[];\n  // Q5 \u2014 site connection\n  internalLinks: BriefInternalLinkView[];\n  internalLinksFrom: string[];\n  isSelfReferentialListicle: boolean;\n  clusterContext?: {\n    pillarTitle: string;\n    pillarUrl: string;\n    spokes: BriefClusterSpokeView[];\n  };\n  // kept for the agent's polling / Manager report \u2014 not for the writer doc\n  flags: { code: string; note?: string }[];\n}\n", "import type { PaperclipPluginManifestV1 } from \"@paperclipai/plugin-sdk\";\nimport { RerunStage } from \"./types/index.js\";\n\nconst manifest: PaperclipPluginManifestV1 = {\n  id: \"byldd.seo-tools\",\n  apiVersion: 1,\n  version: \"0.1.0\",\n  displayName: \"Seo Tools\",\n  description: \"A Paperclip plugin\",\n  author: \"Plugin Author\",\n  categories: [\"connector\"],\n  capabilities: [\n    \"agent.tools.register\",\n    \"http.outbound\",\n    \"ui.detailTab.register\",\n    \"events.subscribe\",\n    \"plugin.state.read\",\n    \"plugin.state.write\",\n    \"ui.dashboardWidget.register\",\n  ],\n  instanceConfigSchema: {\n    type: \"object\",\n    properties: {\n      backendUrl: {\n        type: \"string\",\n        title: \"Backend URL\",\n        description: \"Base URL of the SEO Byldd Server\",\n      },\n      authToken: {\n        type: \"string\",\n        title: \"Auth Token\",\n        description: \"JWT auth token for the SEO Byldd Server\",\n      },\n    },\n    required: [\"backendUrl\", \"authToken\"],\n  },\n  entrypoints: {\n    worker: \"./dist/worker.js\",\n    ui: \"./dist/ui\",\n  },\n  ui: {\n    slots: [\n      {\n        type: \"dashboardWidget\",\n        id: \"health-widget\",\n        displayName: \"Seo Tools Health\",\n        exportName: \"DashboardWidget\",\n      },\n      {\n        type: \"detailTab\",\n        id: \"keyword-research-tab\",\n        displayName: \"Keyword Research\",\n        exportName: \"KeywordResearchTab\",\n        entityTypes: [\"issue\"],\n      },\n    ],\n  },\n  tools: [\n    {\n      name: \"startKeywordResearch\",\n      displayName: \"Start a New Keyword Research\",\n      description:\n        \"ONLY entry point for new keyword research. Handles discovery AND enrichment in one pipeline. Returns a keywordSessionRef immediately \u2014 the job runs in the background. Research typically takes ~20-30s. Wait ~20 seconds, then poll getKeywordSessionStatus with that keywordSessionRef every 10 seconds until status is 'completed' or 'failed'. Max ~16 poll attempts (~3 minutes including the initial wait) before reporting timeout.\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          keyword: { type: \"string\" },\n        },\n        required: [\"keyword\"],\n      },\n    },\n    {\n      name: \"getKeywordSessionStatus\",\n      displayName: \"Get Keyword Session Status\",\n      description:\n        \"Poll the status of a KeywordSession started by startKeywordResearch. Wait ~20 seconds before the first poll (research takes ~20-30s), then call every 10 seconds. Stop when status is 'completed' or 'failed'. Max ~16 attempts (~3 min) \u2014 if still running after that, report timeout to the user and stop. When status is 'completed', the response contains the keywordSessionRef \u2014 the single id for this research run; pass it to clusterKeywords. Save it.\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          keywordSessionRef: { type: \"string\" },\n        },\n        required: [\"keywordSessionRef\"],\n      },\n    },\n    {\n      name: \"listKeywordResearchSessions\",\n      displayName: \"List Keyword Sessions\",\n      description:\n        \"List all past keyword research sessions with a brief overview \u2014 seedKeyword, status, and keyword count only.\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {},\n      },\n    },\n    {\n      name: \"clusterKeywords\",\n      displayName: \"Cluster Keywords\",\n      description:\n        \"Call this AFTER getKeywordSessionStatus returns 'completed'. Pass the keywordSessionRef from that completed response (or from listKeywordResearchSessions). Returns a clusterId. Clustering can take ~20s to 1 min or more. Wait ~20 seconds, then poll getClusterStatus every 15 seconds until status is 'completed'. Max ~18 attempts (~5 min) before reporting timeout.\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          keywordSessionRef: { type: \"string\" },\n        },\n        required: [\"keywordSessionRef\"],\n      },\n    },\n    {\n      name: \"getClusterStatus\",\n      displayName: \"Get Cluster Status\",\n      description:\n        \"Poll the status of a clustering job. After clusterKeywords, wait ~20 seconds, then call every 15 seconds until status is 'completed' or 'failed'. Max ~18 attempts (~5 min) before reporting timeout. When completed, the response contains the full cluster plan \u2014 render it as a Markdown table immediately.\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          clusterId: { type: \"string\" },\n        },\n        required: [\"clusterId\"],\n      },\n    },\n    {\n      name: \"listClusterSessions\",\n      displayName: \"List Cluster Sessions\",\n      description:\n        \"List all past clustering sessions with a brief overview \u2014 seedKeyword, status, and keyword count only.\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {},\n      },\n    },\n    {\n      name: \"generateContentBrief\",\n      displayName: \"Generate Content Brief\",\n      description:\n        \"Call this once user approves a cluster or passed only a keyword. Returns a briefId. You MUST then poll getBriefStatus until status is 'COMPLETED'. When source is 'cluster', clusterSessionRef is REQUIRED (the clusterId from a completed clusterKeywords run); for source 'standalone' omit clusterSessionRef and pass only keyword.\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          source: { type: \"string\", enum: [\"cluster\", \"standalone\"] },\n          keyword: { type: \"string\" },\n          clusterSessionRef: { type: \"string\" },\n          isSelfReferentialListicle: { type: \"boolean\" },\n        },\n        required: [\"source\", \"keyword\"],\n      },\n    },\n    {\n      name: \"getBriefStatus\",\n      displayName: \"Get Brief Status\",\n      description:\n        \"Fetch the current state of a brief. Poll this until status is COMPLETED.\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          briefId: { type: \"string\" },\n        },\n        required: [\"briefId\"],\n      },\n    },\n    {\n      name: \"listContentBriefs\",\n      displayName: \"List Content Briefs\",\n      description: \"List content briefs, optionally filtered by cluster.\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          clusterSessionRef: { type: \"string\" },\n        },\n      },\n    },\n    {\n      name: \"rerunBriefStage\",\n      displayName: \"Rerun Brief Stage\",\n      description: \"Regenerate a single stage of the brief pipeline.\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          briefId: { type: \"string\" },\n          stage: {\n            type: \"string\",\n            enum: Object.values(RerunStage),\n          },\n        },\n        required: [\"briefId\", \"stage\"],\n      },\n    },\n    {\n      name: \"attachProofPoints\",\n      displayName: \"Attach Proof Points\",\n      description: \"Inject business-specific proof points into a brief.\",\n      parametersSchema: {\n        type: \"object\",\n        properties: {\n          briefId: { type: \"string\" },\n          pricingRanges: { type: \"string\" },\n          timelines: { type: \"string\" },\n          clientOutcomes: { type: \"array\", items: { type: \"string\" } },\n          methodology: { type: \"string\" },\n        },\n        required: [\"briefId\"],\n      },\n    },\n  ],\n};\n\nexport default manifest;\n"],
+  "mappings": ";AA+EO,IAAK,aAAL,kBAAKA,gBAAL;AACL,EAAAA,YAAA,SAAM;AACN,EAAAA,YAAA,YAAS;AACT,EAAAA,YAAA,aAAU;AACV,EAAAA,YAAA,gBAAa;AACb,EAAAA,YAAA,YAAS;AACT,EAAAA,YAAA,cAAW;AAND,SAAAA;AAAA,GAAA;;;AC5EZ,IAAM,WAAsC;AAAA,EAC1C,IAAI;AAAA,EACJ,YAAY;AAAA,EACZ,SAAS;AAAA,EACT,aAAa;AAAA,EACb,aAAa;AAAA,EACb,QAAQ;AAAA,EACR,YAAY,CAAC,WAAW;AAAA,EACxB,cAAc;AAAA,IACZ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,sBAAsB;AAAA,IACpB,MAAM;AAAA,IACN,YAAY;AAAA,MACV,YAAY;AAAA,QACV,MAAM;AAAA,QACN,OAAO;AAAA,QACP,aAAa;AAAA,MACf;AAAA,MACA,WAAW;AAAA,QACT,MAAM;AAAA,QACN,OAAO;AAAA,QACP,aAAa;AAAA,MACf;AAAA,IACF;AAAA,IACA,UAAU,CAAC,cAAc,WAAW;AAAA,EACtC;AAAA,EACA,aAAa;AAAA,IACX,QAAQ;AAAA,IACR,IAAI;AAAA,EACN;AAAA,EACA,IAAI;AAAA,IACF,OAAO;AAAA,MACL;AAAA,QACE,MAAM;AAAA,QACN,IAAI;AAAA,QACJ,aAAa;AAAA,QACb,YAAY;AAAA,MACd;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,IAAI;AAAA,QACJ,aAAa;AAAA,QACb,YAAY;AAAA,QACZ,aAAa,CAAC,OAAO;AAAA,MACvB;AAAA,IACF;AAAA,EACF;AAAA,EACA,OAAO;AAAA,IACL;AAAA,MACE,MAAM;AAAA,MACN,aAAa;AAAA,MACb,aACE;AAAA,MACF,kBAAkB;AAAA,QAChB,MAAM;AAAA,QACN,YAAY;AAAA,UACV,SAAS,EAAE,MAAM,SAAS;AAAA,QAC5B;AAAA,QACA,UAAU,CAAC,SAAS;AAAA,MACtB;AAAA,IACF;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,aAAa;AAAA,MACb,aACE;AAAA,MACF,kBAAkB;AAAA,QAChB,MAAM;AAAA,QACN,YAAY;AAAA,UACV,mBAAmB,EAAE,MAAM,SAAS;AAAA,QACtC;AAAA,QACA,UAAU,CAAC,mBAAmB;AAAA,MAChC;AAAA,IACF;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,aAAa;AAAA,MACb,aACE;AAAA,MACF,kBAAkB;AAAA,QAChB,MAAM;AAAA,QACN,YAAY,CAAC;AAAA,MACf;AAAA,IACF;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,aAAa;AAAA,MACb,aACE;AAAA,MACF,kBAAkB;AAAA,QAChB,MAAM;AAAA,QACN,YAAY;AAAA,UACV,mBAAmB,EAAE,MAAM,SAAS;AAAA,QACtC;AAAA,QACA,UAAU,CAAC,mBAAmB;AAAA,MAChC;AAAA,IACF;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,aAAa;AAAA,MACb,aACE;AAAA,MACF,kBAAkB;AAAA,QAChB,MAAM;AAAA,QACN,YAAY;AAAA,UACV,WAAW,EAAE,MAAM,SAAS;AAAA,QAC9B;AAAA,QACA,UAAU,CAAC,WAAW;AAAA,MACxB;AAAA,IACF;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,aAAa;AAAA,MACb,aACE;AAAA,MACF,kBAAkB;AAAA,QAChB,MAAM;AAAA,QACN,YAAY,CAAC;AAAA,MACf;AAAA,IACF;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,aAAa;AAAA,MACb,aACE;AAAA,MACF,kBAAkB;AAAA,QAChB,MAAM;AAAA,QACN,YAAY;AAAA,UACV,QAAQ,EAAE,MAAM,UAAU,MAAM,CAAC,WAAW,YAAY,EAAE;AAAA,UAC1D,SAAS,EAAE,MAAM,SAAS;AAAA,UAC1B,mBAAmB,EAAE,MAAM,SAAS;AAAA,UACpC,2BAA2B,EAAE,MAAM,UAAU;AAAA,QAC/C;AAAA,QACA,UAAU,CAAC,UAAU,SAAS;AAAA,MAChC;AAAA,IACF;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,aAAa;AAAA,MACb,aACE;AAAA,MACF,kBAAkB;AAAA,QAChB,MAAM;AAAA,QACN,YAAY;AAAA,UACV,SAAS,EAAE,MAAM,SAAS;AAAA,QAC5B;AAAA,QACA,UAAU,CAAC,SAAS;AAAA,MACtB;AAAA,IACF;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,aAAa;AAAA,MACb,aAAa;AAAA,MACb,kBAAkB;AAAA,QAChB,MAAM;AAAA,QACN,YAAY;AAAA,UACV,mBAAmB,EAAE,MAAM,SAAS;AAAA,QACtC;AAAA,MACF;AAAA,IACF;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,aAAa;AAAA,MACb,aAAa;AAAA,MACb,kBAAkB;AAAA,QAChB,MAAM;AAAA,QACN,YAAY;AAAA,UACV,SAAS,EAAE,MAAM,SAAS;AAAA,UAC1B,OAAO;AAAA,YACL,MAAM;AAAA,YACN,MAAM,OAAO,OAAO,UAAU;AAAA,UAChC;AAAA,QACF;AAAA,QACA,UAAU,CAAC,WAAW,OAAO;AAAA,MAC/B;AAAA,IACF;AAAA,IACA;AAAA,MACE,MAAM;AAAA,MACN,aAAa;AAAA,MACb,aAAa;AAAA,MACb,kBAAkB;AAAA,QAChB,MAAM;AAAA,QACN,YAAY;AAAA,UACV,SAAS,EAAE,MAAM,SAAS;AAAA,UAC1B,eAAe,EAAE,MAAM,SAAS;AAAA,UAChC,WAAW,EAAE,MAAM,SAAS;AAAA,UAC5B,gBAAgB,EAAE,MAAM,SAAS,OAAO,EAAE,MAAM,SAAS,EAAE;AAAA,UAC3D,aAAa,EAAE,MAAM,SAAS;AAAA,QAChC;AAAA,QACA,UAAU,CAAC,SAAS;AAAA,MACtB;AAAA,IACF;AAAA,EACF;AACF;AAEA,IAAO,mBAAQ;",
+  "names": ["RerunStage"]
 }

package/dist/worker.js

@@ -9773,88 +9773,16 @@ function startWorkerRpcHost(options) {
   };
 }
 
-// src/utils/brief-view.ts
-var SCHEMA_KEY_LABELS = {
-  article: "Article",
-  itemList: "ItemList",
-  breadcrumbList: "BreadcrumbList",
-  faqPage: "FAQPage",
-  howTo: "HowTo",
-  service: "Service",
-  offer: "Offer"
-};
-function toBriefWriterView(d) {
-  const brief = d.brief ?? {};
-  const coverage = d.coverageMatrix ?? {};
-  const intentSat = d.searchIntentSatisfaction ?? {};
-  const diff = d.differentiationStrategy ?? {};
-  const schemaBundle = d.schemaBundle ?? {};
-  const mapOutline = (s) => ({
-    heading: s.heading,
-    level: s.level,
-    wordCount: s.wordCount,
-    importance: s.importance ?? null,
-    format: s.formatNotes,
-    guidance: s.keywordGuidance,
-    ...Array.isArray(s.subSections) && s.subSections.length ? { subSections: s.subSections.map(mapOutline) } : {}
-  });
-  return {
-    status: d.status,
-    pageType: d.template,
-    intent: d.intent,
-    targetKeyword: d.keyword,
-    targetAudience: d.targetAudience,
-    priorityScore: d.priorityScore,
-    priorityTier: d.priorityTier,
-    clusterPosition: d.clusterPosition,
-    recommendedTitle: brief.title,
-    metaDescription: brief.metaDescription,
-    urlSlug: brief.urlSlug,
-    supportingKeywords: d.supportingKeywords ?? [],
-    mustAnswer: intentSat.mustAnswer ?? [],
-    niceToAnswer: intentSat.niceToAnswer ?? [],
-    targetWordCount: brief.targetWordCount,
-    competitorAvgWordCount: brief.competitorAvgWordCount,
-    outline: (brief.outline ?? []).map(mapOutline),
-    requiredTopics: (coverage.requiredTopics ?? []).map((t) => t.topic),
-    contentGaps: coverage.contentGaps ?? [],
-    differentiatorOpportunities: coverage.differentiatorOpportunities ?? [],
-    faq: (brief.faq ?? []).map((f) => f.q),
-    tldrBlock: d.tldrBlock ? {
-      text: d.tldrBlock.text,
-      wordCount: d.tldrBlock.wordCount,
-      placement: d.tldrBlock.placement,
-      fsTarget: d.tldrBlock.fsTarget
-    } : void 0,
-    objectiveLanguageInstruction: d.objectiveLanguageInstruction,
-    requiredSignals: d.geo?.requiredSignals ?? [],
-    schemaRequired: Object.keys(SCHEMA_KEY_LABELS).filter((k) => schemaBundle[k]).map((k) => SCHEMA_KEY_LABELS[k]),
-    contentAngle: d.contentAngle,
-    competitorGap: d.competitorGap,
-    mustOwnTopics: diff.mustOwnTopics ?? [],
-    uniqueAssets: diff.uniqueAssets ?? [],
-    proofPointsToInclude: diff.proofPointsToInclude ?? [],
-    competitorBlindSpots: diff.competitorBlindSpots ?? [],
-    competitorPagesToReference: d.competitorPagesToReference ?? [],
-    internalLinks: (brief.internalLinks ?? []).map((l) => ({
-      anchor: l.anchor,
-      targetUrl: l.targetUrl,
-      reason: l.reason
-    })),
-    internalLinksFrom: brief.internalLinksFrom ?? [],
-    isSelfReferentialListicle: Boolean(d.isSelfReferentialListicle),
-    clusterContext: d.clusterContext ? {
-      pillarTitle: d.clusterContext.pillarTitle,
-      pillarUrl: d.clusterContext.pillarUrl,
-      spokes: (d.clusterContext.spokes ?? []).map((s) => ({
-        keyword: s.keyword,
-        title: s.title,
-        url: s.url
-      }))
-    } : void 0,
-    flags: (d.flags ?? []).map((f) => ({ code: f.code, note: f.note }))
-  };
-}
+// src/types/index.ts
+var RerunStage = /* @__PURE__ */ ((RerunStage2) => {
+  RerunStage2["GEO"] = "geo";
+  RerunStage2["SCHEMA"] = "schema";
+  RerunStage2["OUTLINE"] = "outline";
+  RerunStage2["ENRICHMENT"] = "enrichment";
+  RerunStage2["INTENT"] = "intent";
+  RerunStage2["STRATEGY"] = "strategy";
+  return RerunStage2;
+})(RerunStage || {});
 
 // src/worker.ts
 var plugin = definePlugin({
@@ -9862,6 +9790,8 @@ var plugin = definePlugin({
     const config = await ctx.config.get();
     const BASE = config.backendUrl;
     const AUTH_TOKEN = config.authToken;
+    const API_PREFIX2 = "/api";
+    const apiRoot = `${BASE}${API_PREFIX2}`;
     ctx.logger.info("Loaded config on startup", {
       BACKEND_URL: BASE,
       hasApiToken: !!AUTH_TOKEN
@@ -9869,7 +9799,7 @@ var plugin = definePlugin({
     const api = async (path2, method = "GET", body) => {
       ctx.logger.info(`pluggin called - ${method} ${path2}`);
       try {
-        const res = await ctx.http.fetch(`${BASE}${path2}`, {
+        const res = await ctx.http.fetch(`${apiRoot}${path2}`, {
           method,
           headers: {
             "Content-Type": "application/json",
@@ -9894,9 +9824,9 @@ var plugin = definePlugin({
       }
     };
     ctx.tools.register(
-      "runKeywordResearch",
+      "startKeywordResearch",
       {
-        displayName: "Run Keyword Research",
+        displayName: "Start a New Keyword Research",
         description: "ONLY entry point for new keyword research. Handles discovery AND enrichment in one pipeline. Returns a keywordSessionRef immediately \u2014 the job runs in the background. Research typically takes ~20-30s. Wait ~20 seconds, then poll getKeywordSessionStatus with that keywordSessionRef every 10 seconds until status is 'completed' or 'failed'. Max ~16 poll attempts (~3 minutes including the initial wait) before reporting timeout.",
         parametersSchema: {
           type: "object",
@@ -9907,7 +9837,7 @@ var plugin = definePlugin({
       async (params) => {
         const { keyword } = params;
         try {
-          const json = await api("/api/keyword-research/start", "POST", {
+          const json = await api("/keyword-research/start", "POST", {
             keyword
           });
           const d = json?.data ?? {};
@@ -9927,7 +9857,7 @@ var plugin = definePlugin({
       "getKeywordSessionStatus",
       {
         displayName: "Get Keyword Session Status",
-        description: "Poll the status of a KeywordSession started by runKeywordResearch. Wait ~20 seconds before the first poll (research takes ~20-30s), then call every 10 seconds. Stop when status is 'completed' or 'failed'. Max ~16 attempts (~3 min) \u2014 if still running after that, report timeout to the user and stop. When status is 'completed', the response contains the keywordSessionRef \u2014 the single id for this research run; pass it to clusterKeywords. Save it.",
+        description: "Poll the status of a KeywordSession started by startKeywordResearch. Wait ~20 seconds before the first poll (research takes ~20-30s), then call every 10 seconds. Stop when status is 'completed' or 'failed'. Max ~16 attempts (~3 min) \u2014 if still running after that, report timeout to the user and stop. When status is 'completed', the response contains the keywordSessionRef \u2014 the single id for this research run; pass it to clusterKeywords. Save it.",
         parametersSchema: {
           type: "object",
           properties: { keywordSessionRef: { type: "string" } },
@@ -9938,40 +9868,43 @@ var plugin = definePlugin({
         const { keywordSessionRef } = params;
         try {
           const json = await api(
-            `/api/keyword-research/${keywordSessionRef}/status`,
+            `/keyword-research/${keywordSessionRef}/status`,
             "GET"
           );
-          const d = json?.data ?? {};
-          if (d.status === "completed") {
+          const sessionStatus = json?.data ?? {};
+          if (sessionStatus.status === "completed" /* COMPLETED */) {
             return {
-              content: `Keyword research for "${d.seedKeyword}" complete: ${d.highCount} HIGH, ${d.medCount} MEDIUM, ${d.lowCount} LOW, ${d.deadCount} DEAD out of ${d.totalEnriched} enriched keywords. keywordSessionRef is "${d.keywordSessionRef}" \u2014 save it for clusterKeywords. Full keyword list is in the 'keywords' array \u2014 render it as a Markdown table now.`,
+              content: `Keyword research for "${sessionStatus.seedKeyword}" complete: ${sessionStatus.highCount} HIGH, ${sessionStatus.medCount} MEDIUM, ${sessionStatus.lowCount} LOW, ${sessionStatus.deadCount} DEAD out of ${sessionStatus.totalEnriched} enriched keywords. keywordSessionRef is "${sessionStatus.keywordSessionRef}" \u2014 save it for clusterKeywords. Full keyword list is in the 'keywords' array \u2014 render it as a Markdown table now.`,
               data: {
-                status: d.status,
-                keywordSessionRef: d.keywordSessionRef,
-                seedKeyword: d.seedKeyword,
-                totalSuggestions: d.totalSuggestions,
-                totalEnriched: d.totalEnriched,
-                highCount: d.highCount,
-                medCount: d.medCount,
-                lowCount: d.lowCount,
-                deadCount: d.deadCount,
-                keywords: d.keywords ?? []
+                status: sessionStatus.status,
+                keywordSessionRef: sessionStatus.keywordSessionRef,
+                seedKeyword: sessionStatus.seedKeyword,
+                totalSuggestions: sessionStatus.totalSuggestions,
+                totalEnriched: sessionStatus.totalEnriched,
+                highCount: sessionStatus.highCount,
+                medCount: sessionStatus.medCount,
+                lowCount: sessionStatus.lowCount,
+                deadCount: sessionStatus.deadCount,
+                keywords: sessionStatus.keywords ?? []
               }
             };
           }
-          if (d.status === "failed") {
+          if (sessionStatus.status === "failed" /* FAILED */) {
             return {
-              content: `Keyword research for "${d.seedKeyword}" failed: ${d.errorMessage}`,
+              content: `Keyword research for "${sessionStatus.seedKeyword}" failed: ${sessionStatus.errorMessage}`,
               data: {
-                status: d.status,
-                keywordSessionRef: d.keywordSessionRef,
-                errorMessage: d.errorMessage
+                status: sessionStatus.status,
+                keywordSessionRef: sessionStatus.keywordSessionRef,
+                errorMessage: sessionStatus.errorMessage
               }
             };
           }
           return {
-            content: `Job is still running (phase: ${d.status}). Poll again in 10 seconds.`,
-            data: { status: d.status, keywordSessionRef: d.keywordSessionRef }
+            content: `Job is still running (phase: ${sessionStatus.status}). Poll again in 10 seconds.`,
+            data: {
+              status: sessionStatus.status,
+              keywordSessionRef: sessionStatus.keywordSessionRef
+            }
           };
         } catch (e) {
           return { error: String(e) };
@@ -9979,7 +9912,7 @@ var plugin = definePlugin({
       }
     );
     ctx.tools.register(
-      "listKeywordSessions",
+      "listKeywordResearchSessions",
       {
         displayName: "List Keyword Sessions",
         description: "List all past keyword research sessions with a brief overview \u2014 seedKeyword, status, and keyword count only.",
@@ -9987,17 +9920,16 @@ var plugin = definePlugin({
       },
       async () => {
         try {
-          const json = await api("/api/keyword-research/", "GET");
+          const json = await api("/keyword-research/", "GET");
           const sessions = json?.data ?? [];
-          return {
-            data: sessions.map((s) => ({
-              keywordSessionRef: String(s._id ?? ""),
-              seedKeyword: s.seedKeyword,
-              status: s.status,
-              keywordCount: s.keywordCount ?? 0,
-              createdAt: s.createdAt
-            }))
-          };
+          const data = sessions.map((s) => ({
+            keywordSessionRef: String(s._id ?? ""),
+            seedKeyword: s.seedKeyword,
+            status: s.status,
+            keywordCount: s.keywordCount ?? 0,
+            createdAt: s.createdAt
+          }));
+          return { data };
         } catch (e) {
           return { error: String(e) };
         }
@@ -10007,7 +9939,7 @@ var plugin = definePlugin({
       "clusterKeywords",
       {
         displayName: "Cluster Keywords",
-        description: "Call this AFTER getKeywordSessionStatus returns 'completed'. Pass the keywordSessionRef from that completed response (or from listKeywordSessions). Returns a clusterId. Clustering can take ~20s to 1 min or more. Wait ~20 seconds, then poll getClusterStatus every 15 seconds until status is 'completed'. Max ~18 attempts (~5 min) before reporting timeout.",
+        description: "Call this AFTER getKeywordSessionStatus returns 'completed'. Pass the keywordSessionRef from that completed response (or from listKeywordResearchSessions). Returns a clusterId. Clustering can take ~20s to 1 min or more. Wait ~20 seconds, then poll getClusterStatus every 15 seconds until status is 'completed'. Max ~18 attempts (~5 min) before reporting timeout.",
         parametersSchema: {
           type: "object",
           properties: { keywordSessionRef: { type: "string" } },
@@ -10017,7 +9949,7 @@ var plugin = definePlugin({
       async (params) => {
         const { keywordSessionRef } = params;
         try {
-          const json = await api("/api/clustering", "POST", {
+          const json = await api("/clustering", "POST", {
             keywordSessionRef
           });
           const d = json?.data ?? {};
@@ -10044,9 +9976,10 @@ var plugin = definePlugin({
       async (params) => {
         const { clusterId } = params;
         try {
-          const json = await api(`/api/clustering/${clusterId}`, "GET");
+          const json = await api(`/clustering/${clusterId}`, "GET");
           const d = json?.data ?? {};
-          if (d.status === "completed" || d.status === "COMPLETED") {
+          const clusterStatus = String(d.status ?? "").toLowerCase();
+          if (clusterStatus === "completed" /* COMPLETED */) {
             const plan = d.clusterPlan ?? {};
             const architectures = (plan.architectures ?? []).map((arch) => ({
               pillar: arch.pillar ? {
@@ -10086,7 +10019,7 @@ var plugin = definePlugin({
               }
             };
           }
-          if (d.status === "failed" || d.status === "FAILED") {
+          if (clusterStatus === "failed" /* FAILED */) {
             return {
               content: `Clustering failed: ${d.error ?? "Unknown error"}`,
               data: { status: d.status, error: d.error }
@@ -10110,17 +10043,16 @@ var plugin = definePlugin({
       },
       async () => {
         try {
-          const json = await api("/api/clustering/", "GET");
+          const json = await api("/clustering/", "GET");
           const sessions = json?.data ?? [];
-          return {
-            data: sessions.map((s) => ({
-              clusterId: String(s._id ?? ""),
-              seedKeyword: s.seedKeyword,
-              status: s.status,
-              keywordCount: s.keywordCount ?? 0,
-              createdAt: s.createdAt
-            }))
-          };
+          const data = sessions.map((s) => ({
+            clusterId: String(s._id ?? ""),
+            seedKeyword: s.seedKeyword,
+            status: s.status,
+            keywordCount: s.keywordCount ?? 0,
+            createdAt: s.createdAt
+          }));
+          return { data };
         } catch (e) {
           return { error: String(e) };
         }
@@ -10130,7 +10062,7 @@ var plugin = definePlugin({
       "generateContentBrief",
       {
         displayName: "Generate Content Brief",
-        description: "Call this once user approves a cluster or passed only a keyword. Returns a briefId. You MUST then poll getBriefStatus until status is 'COMPLETED'.",
+        description: "Call this once user approves a cluster or passed only a keyword. Returns a briefId. You MUST then poll getBriefStatus until status is 'COMPLETED'. When source is 'cluster', clusterSessionRef is REQUIRED (the clusterId from a completed clusterKeywords run); for source 'standalone' omit clusterSessionRef and pass only keyword.",
         parametersSchema: {
           type: "object",
           properties: {
@@ -10145,8 +10077,8 @@ var plugin = definePlugin({
       async (params) => {
         const p = params;
         try {
-          const data = await api("/api/content-brief/generate", "POST", p);
-          return { data };
+          const json = await api("/content-brief/generate", "POST", p);
+          return { data: json?.data ?? {} };
         } catch (e) {
           return { error: String(e) };
         }
@@ -10166,24 +10098,8 @@ var plugin = definePlugin({
       async (params) => {
         const { briefId } = params;
         try {
-          const json = await api(`/api/content-brief/${briefId}`, "GET");
-          const d = json?.data ?? {};
-          if (d.status === "COMPLETED" || d.status === "NEEDS_REVIEW") {
-            return {
-              content: `Brief ${d.status} for "${d.keyword}". The 'brief' object is the trimmed writer view \u2014 render it per RENDERING.md.`,
-              data: { briefId, brief: toBriefWriterView(d) }
-            };
-          }
-          if (d.status === "FAILED") {
-            return {
-              content: `Brief generation failed: ${d.error ?? "Unknown error"}`,
-              data: { briefId, status: d.status, error: d.error }
-            };
-          }
-          return {
-            content: `Brief is still running (status: ${d.status}). Poll again in ~10 seconds.`,
-            data: { briefId, status: d.status }
-          };
+          const json = await api(`/content-brief/${briefId}`, "GET");
+          return { data: json?.data ?? {} };
         } catch (e) {
           return { error: String(e) };
         }
@@ -10203,7 +10119,15 @@ var plugin = definePlugin({
         const { clusterSessionRef } = params;
         try {
           const qs = clusterSessionRef ? `?clusterSessionRef=${clusterSessionRef}` : "";
-          const data = await api(`/api/content-brief/${qs}`, "GET");
+          const json = await api(`/content-brief/${qs}`, "GET");
+          const briefs = json?.data ?? [];
+          const data = briefs.map((b) => ({
+            briefId: String(b._id ?? ""),
+            keyword: b.keyword,
+            status: b.status,
+            createdAt: b.createdAt,
+            updatedAt: b.updatedAt
+          }));
           return { data };
         } catch (e) {
           return { error: String(e) };
@@ -10219,7 +10143,10 @@ var plugin = definePlugin({
           type: "object",
           properties: {
             briefId: { type: "string" },
-            stage: { type: "string" }
+            stage: {
+              type: "string",
+              enum: Object.values(RerunStage)
+            }
           },
           required: ["briefId", "stage"]
         }
@@ -10227,11 +10154,11 @@ var plugin = definePlugin({
       async (params) => {
         const { briefId, stage } = params;
         try {
-          const data = await api(
-            `/api/content-brief/${briefId}/rerun?stage=${stage}`,
+          const json = await api(
+            `/content-brief/${briefId}/rerun?stage=${stage}`,
             "POST"
           );
-          return { data };
+          return { data: json?.data ?? {} };
         } catch (e) {
           return { error: String(e) };
         }
@@ -10257,12 +10184,12 @@ var plugin = definePlugin({
       async (params) => {
         const { briefId, ...bodyParams } = params;
         try {
-          const data = await api(
-            `/api/content-brief/${briefId}/proof-points`,
+          const json = await api(
+            `/content-brief/${briefId}/proof-points`,
             "PATCH",
             bodyParams
           );
-          return { data };
+          return { data: json?.data ?? {} };
         } catch (e) {
           return { error: String(e) };
         }
@@ -10281,7 +10208,7 @@ var plugin = definePlugin({
     });
     ctx.data.register("sessions", async () => {
       try {
-        const json = await api("/api/keyword-research/", "GET");
+        const json = await api("/keyword-research/", "GET");
         return { sessions: json?.data ?? [] };
       } catch (err) {
         ctx.logger.error("sessions handler failed", { error: String(err) });
@@ -10297,7 +10224,7 @@ var plugin = definePlugin({
         }
         try {
           const json = await api(
-            `/api/keyword-research/${encodeURIComponent(keywordSessionRef)}/status`,
+            `/keyword-research/${encodeURIComponent(keywordSessionRef)}/status`,
             "GET"
           );
           return {