@byldd/seo-tools-plugin 1.0.1 → 1.0.3

package/dist/worker.js

@@ -4873,14 +4873,19 @@ var instanceGeneralSettingsSchema = external_exports.object({
   censorUsernameInLogs: external_exports.boolean().default(false),
   keyboardShortcuts: external_exports.boolean().default(false),
   feedbackDataSharingPreference: feedbackDataSharingPreferenceSchema.default(DEFAULT_FEEDBACK_DATA_SHARING_PREFERENCE),
-  backupRetention: backupRetentionPolicySchema.default(DEFAULT_BACKUP_RETENTION)
+  backupRetention: backupRetentionPolicySchema.default(DEFAULT_BACKUP_RETENTION),
+  // Execution policy. Absent/"any" = unrestricted; "kubernetes" forces the
+  // Kubernetes sandbox provider and denies local/ssh execution (cloud_tenant).
+  executionMode: external_exports.enum(["kubernetes", "any"]).optional()
 }).strict();
 var patchInstanceGeneralSettingsSchema = instanceGeneralSettingsSchema.partial();
 var instanceExperimentalSettingsSchema = external_exports.object({
   enableEnvironments: external_exports.boolean().default(false),
   enableIsolatedWorkspaces: external_exports.boolean().default(false),
   enableStreamlinedLeftNavigation: external_exports.boolean().default(false),
+  enableConferenceRoomChat: external_exports.boolean().default(false),
   enableIssuePlanDecompositions: external_exports.boolean().default(false),
+  enableExperimentalFileViewer: external_exports.boolean().default(false),
   enableCloudSync: external_exports.boolean().default(false),
   autoRestartDevServerWhenIdle: external_exports.boolean().default(false),
   enableIssueGraphLivenessAutoRecovery: external_exports.boolean().default(false),
@@ -4982,10 +4987,15 @@ var companySkillSourceTypeSchema = external_exports.enum(["local_path", "github"
 var companySkillTrustLevelSchema = external_exports.enum(["markdown_only", "assets", "scripts_executables"]);
 var companySkillCompatibilitySchema = external_exports.enum(["compatible", "unknown", "invalid"]);
 var companySkillSourceBadgeSchema = external_exports.enum(["paperclip", "github", "local", "url", "catalog", "skills_sh"]);
+var companySkillSharingScopeSchema = external_exports.enum(["private", "company", "public_link"]);
+var companySkillListSortSchema = external_exports.enum(["alphabetical", "recent", "installs", "stars", "agents", "forks"]);
 var companySkillFileInventoryEntrySchema = external_exports.object({
   path: external_exports.string().min(1),
   kind: external_exports.enum(["skill", "markdown", "reference", "script", "asset", "other"])
 });
+var companySkillVersionFileInventoryEntrySchema = companySkillFileInventoryEntrySchema.extend({
+  content: external_exports.string()
+});
 var companySkillSchema = external_exports.object({
   id: external_exports.string().uuid(),
   companyId: external_exports.string().uuid(),
@@ -5000,6 +5010,20 @@ var companySkillSchema = external_exports.object({
   trustLevel: companySkillTrustLevelSchema,
   compatibility: companySkillCompatibilitySchema,
   fileInventory: external_exports.array(companySkillFileInventoryEntrySchema).default([]),
+  iconUrl: external_exports.string().nullable(),
+  color: external_exports.string().nullable(),
+  tagline: external_exports.string().nullable(),
+  authorName: external_exports.string().nullable(),
+  homepageUrl: external_exports.string().nullable(),
+  categories: external_exports.array(external_exports.string().min(1)).default([]),
+  sharingScope: companySkillSharingScopeSchema,
+  publicShareToken: external_exports.string().nullable(),
+  forkedFromSkillId: external_exports.string().uuid().nullable(),
+  forkedFromCompanyId: external_exports.string().uuid().nullable(),
+  starCount: external_exports.number().int().nonnegative(),
+  installCount: external_exports.number().int().nonnegative(),
+  forkCount: external_exports.number().int().nonnegative(),
+  currentVersionId: external_exports.string().uuid().nullable(),
   metadata: external_exports.record(external_exports.string(), external_exports.unknown()).nullable(),
   createdAt: external_exports.coerce.date(),
   updatedAt: external_exports.coerce.date()
@@ -5021,7 +5045,29 @@ var companySkillUsageAgentSchema = external_exports.object({
   urlKey: external_exports.string().min(1),
   adapterType: external_exports.string().min(1),
   desired: external_exports.boolean(),
-  actualState: external_exports.string().nullable().describe("Runtime adapter skill state when explicitly fetched; company skill detail reads return null without probing agent runtimes.")
+  actualState: external_exports.string().nullable().describe("Runtime adapter skill state when explicitly fetched; company skill detail reads return null without probing agent runtimes."),
+  versionId: external_exports.string().uuid().nullable()
+});
+var companySkillListQuerySchema = external_exports.object({
+  q: external_exports.string().min(1).optional(),
+  sort: companySkillListSortSchema.optional(),
+  categories: external_exports.array(external_exports.string().min(1)).optional(),
+  scope: companySkillSharingScopeSchema.optional()
+});
+var companySkillCategoryCountSchema = external_exports.object({
+  slug: external_exports.string().min(1),
+  count: external_exports.number().int().nonnegative()
+});
+var companySkillVersionSchema = external_exports.object({
+  id: external_exports.string().uuid(),
+  companyId: external_exports.string().uuid(),
+  companySkillId: external_exports.string().uuid(),
+  revisionNumber: external_exports.number().int().positive(),
+  label: external_exports.string().nullable(),
+  fileInventory: external_exports.array(companySkillVersionFileInventoryEntrySchema).default([]),
+  authorAgentId: external_exports.string().uuid().nullable(),
+  authorUserId: external_exports.string().nullable(),
+  createdAt: external_exports.coerce.date()
 });
 var companySkillDetailSchema = companySkillSchema.extend({
   attachedAgentCount: external_exports.number().int().nonnegative(),
@@ -5029,8 +5075,52 @@ var companySkillDetailSchema = companySkillSchema.extend({
   editable: external_exports.boolean(),
   editableReason: external_exports.string().nullable(),
   sourceLabel: external_exports.string().nullable(),
-  sourceBadge: companySkillSourceBadgeSchema
+  sourceBadge: companySkillSourceBadgeSchema,
+  currentVersion: companySkillVersionSchema.nullable(),
+  starredByCurrentActor: external_exports.boolean()
+});
+var companySkillVersionCreateSchema = external_exports.object({
+  label: external_exports.string().trim().min(1).nullable().optional()
+}).default({});
+var companySkillStarResultSchema = external_exports.object({
+  skillId: external_exports.string().uuid(),
+  starred: external_exports.boolean(),
+  starCount: external_exports.number().int().nonnegative()
+});
+var companySkillCommentSchema = external_exports.object({
+  id: external_exports.string().uuid(),
+  companyId: external_exports.string().uuid(),
+  companySkillId: external_exports.string().uuid(),
+  parentCommentId: external_exports.string().uuid().nullable(),
+  authorAgentId: external_exports.string().uuid().nullable(),
+  authorUserId: external_exports.string().nullable(),
+  body: external_exports.string(),
+  deletedAt: external_exports.coerce.date().nullable(),
+  createdAt: external_exports.coerce.date(),
+  updatedAt: external_exports.coerce.date()
+});
+var companySkillCommentCreateSchema = external_exports.object({
+  body: external_exports.string().min(1),
+  parentCommentId: external_exports.string().uuid().nullable().optional()
 });
+var companySkillCommentUpdateSchema = external_exports.object({
+  body: external_exports.string().min(1)
+});
+var companySkillForkSchema = external_exports.object({
+  name: external_exports.string().min(1).nullable().optional(),
+  slug: external_exports.string().min(1).nullable().optional(),
+  sharingScope: companySkillSharingScopeSchema.optional()
+}).default({});
+var companySkillUpdateSchema = external_exports.object({
+  description: external_exports.string().nullable().optional(),
+  iconUrl: external_exports.string().nullable().optional(),
+  color: external_exports.string().nullable().optional(),
+  tagline: external_exports.string().max(120).nullable().optional(),
+  authorName: external_exports.string().nullable().optional(),
+  homepageUrl: external_exports.string().nullable().optional(),
+  categories: external_exports.array(external_exports.string().min(1)).optional(),
+  sharingScope: companySkillSharingScopeSchema.optional()
+}).default({});
 var companySkillUpdateStatusSchema = external_exports.object({
   supported: external_exports.boolean(),
   reason: external_exports.string().nullable(),
@@ -5115,7 +5205,15 @@ var companySkillCreateSchema = external_exports.object({
   name: external_exports.string().min(1),
   slug: external_exports.string().min(1).nullable().optional(),
   description: external_exports.string().nullable().optional(),
-  markdown: external_exports.string().nullable().optional()
+  markdown: external_exports.string().nullable().optional(),
+  iconUrl: external_exports.string().nullable().optional(),
+  color: external_exports.string().nullable().optional(),
+  tagline: external_exports.string().max(120).nullable().optional(),
+  authorName: external_exports.string().nullable().optional(),
+  homepageUrl: external_exports.string().nullable().optional(),
+  categories: external_exports.array(external_exports.string().min(1)).optional(),
+  sharingScope: companySkillSharingScopeSchema.optional(),
+  forkedFromSkillId: external_exports.string().uuid().nullable().optional()
 });
 var companySkillFileDetailSchema = external_exports.object({
   skillId: external_exports.string().uuid(),
@@ -6791,9 +6889,19 @@ var agentSkillSyncModeSchema = external_exports.enum([
   "persistent",
   "ephemeral"
 ]);
+var agentDesiredSkillEntrySchema = external_exports.object({
+  key: external_exports.string().min(1),
+  versionId: external_exports.string().uuid().nullable()
+});
+var agentDesiredSkillSelectionSchema = external_exports.union([
+  external_exports.string().min(1),
+  agentDesiredSkillEntrySchema
+]);
 var agentSkillEntrySchema = external_exports.object({
   key: external_exports.string().min(1),
   runtimeName: external_exports.string().min(1).nullable(),
+  versionId: external_exports.string().uuid().nullable().optional(),
+  currentVersionId: external_exports.string().uuid().nullable().optional(),
   desired: external_exports.boolean(),
   managed: external_exports.boolean(),
   required: external_exports.boolean().optional(),
@@ -6812,11 +6920,12 @@ var agentSkillSnapshotSchema = external_exports.object({
   supported: external_exports.boolean(),
   mode: agentSkillSyncModeSchema,
   desiredSkills: external_exports.array(external_exports.string().min(1)),
+  desiredSkillEntries: external_exports.array(agentDesiredSkillEntrySchema).optional(),
   entries: external_exports.array(agentSkillEntrySchema),
   warnings: external_exports.array(external_exports.string())
 });
 var agentSkillSyncSchema = external_exports.object({
-  desiredSkills: external_exports.array(external_exports.string().min(1))
+  desiredSkills: external_exports.array(agentDesiredSkillSelectionSchema)
 });
 
 // node_modules/@paperclipai/shared/dist/validators/agent.js
@@ -6873,7 +6982,7 @@ var createAgentSchema = external_exports.object({
   icon: external_exports.enum(AGENT_ICON_NAMES).optional().nullable(),
   reportsTo: external_exports.string().uuid().optional().nullable(),
   capabilities: external_exports.string().optional().nullable(),
-  desiredSkills: external_exports.array(external_exports.string().min(1)).optional(),
+  desiredSkills: external_exports.array(agentDesiredSkillSelectionSchema).optional(),
   adapterType: agentAdapterTypeSchema,
   adapterConfig: adapterConfigSchema.optional().default({}),
   instructionsBundle: createAgentInstructionsBundleSchema.optional(),
@@ -7125,6 +7234,92 @@ var releaseIssueTreeHoldSchema = external_exports.object({
   metadata: external_exports.record(external_exports.string(), external_exports.unknown()).optional().nullable()
 }).strict();
 
+// node_modules/@paperclipai/shared/dist/validators/workspace-file-resource.js
+var workspaceFileListSearchMaxBytes = 128;
+function utf8ByteLength(value) {
+  return new TextEncoder().encode(value).length;
+}
+var workspaceFileWorkspaceKindSchema = external_exports.enum(["execution_workspace", "project_workspace"]);
+var workspaceFileSelectorSchema = external_exports.enum(["auto", "execution", "project"]).default("auto");
+var workspaceFileListModeSchema = external_exports.enum(["all", "recent", "changed"]).default("all");
+var workspaceFilePreviewKindSchema = external_exports.enum(["text", "image", "video", "pdf", "unsupported"]);
+var workspaceFileResourceKindSchema = external_exports.enum(["file", "directory", "remote_resource"]);
+var workspaceFileRefSchema = external_exports.object({
+  kind: external_exports.literal("workspace_file"),
+  issueId: external_exports.string().uuid().optional(),
+  projectId: external_exports.string().uuid().optional(),
+  projectName: external_exports.string().min(1).optional(),
+  workspaceKind: workspaceFileWorkspaceKindSchema,
+  workspaceId: external_exports.string().uuid(),
+  relativePath: external_exports.string().min(1),
+  line: external_exports.number().int().positive().nullable().optional(),
+  column: external_exports.number().int().positive().nullable().optional(),
+  displayPath: external_exports.string().min(1)
+});
+var workspaceFileResourceQuerySchema = external_exports.object({
+  projectId: external_exports.string().uuid().optional(),
+  workspaceId: external_exports.string().uuid().optional(),
+  path: external_exports.string().min(1).refine((value) => !/[\x00-\x1f\x7f]/.test(value), {
+    message: "Workspace file path contains an invalid character",
+    params: { code: "invalid_path" }
+  }),
+  workspace: workspaceFileSelectorSchema.optional()
+}).refine((value) => Boolean(value.projectId) === Boolean(value.workspaceId), {
+  message: "Workspace file target requires both projectId and workspaceId",
+  path: ["workspaceId"],
+  params: { code: "invalid_target" }
+});
+var workspaceFileListQuerySchema = external_exports.object({
+  projectId: external_exports.string().uuid().optional(),
+  workspaceId: external_exports.string().uuid().optional(),
+  workspace: workspaceFileSelectorSchema.optional(),
+  path: external_exports.string().min(1).refine((value) => !/[\x00-\x1f\x7f]/.test(value), {
+    message: "Workspace folder path contains an invalid character",
+    params: { code: "invalid_path" }
+  }).optional(),
+  mode: workspaceFileListModeSchema.optional(),
+  q: external_exports.string().refine((value) => !/[\x00-\x1f\x7f]/.test(value), {
+    message: "Workspace file search contains an invalid character",
+    params: { code: "invalid_query" }
+  }).refine((value) => utf8ByteLength(value.trim()) <= workspaceFileListSearchMaxBytes, {
+    message: "Workspace file search is too long",
+    params: { code: "invalid_query" }
+  }).optional(),
+  limit: external_exports.coerce.number().int().min(1).max(100).default(25),
+  offset: external_exports.coerce.number().int().min(0).max(1e4).default(0)
+}).refine((value) => Boolean(value.projectId) === Boolean(value.workspaceId), {
+  message: "Workspace file target requires both projectId and workspaceId",
+  path: ["workspaceId"],
+  params: { code: "invalid_target" }
+});
+var resolvedWorkspaceResourceSchema = external_exports.object({
+  kind: workspaceFileResourceKindSchema,
+  provider: external_exports.string().min(1),
+  title: external_exports.string().min(1),
+  displayPath: external_exports.string().min(1),
+  workspaceLabel: external_exports.string().min(1),
+  workspaceKind: workspaceFileWorkspaceKindSchema,
+  workspaceId: external_exports.string().uuid(),
+  projectId: external_exports.string().uuid().nullable().optional(),
+  projectName: external_exports.string().min(1).nullable().optional(),
+  contentType: external_exports.string().nullable().optional(),
+  byteSize: external_exports.number().int().nonnegative().nullable().optional(),
+  previewKind: workspaceFilePreviewKindSchema,
+  denialReason: external_exports.string().nullable().optional(),
+  capabilities: external_exports.object({
+    preview: external_exports.boolean(),
+    download: external_exports.literal(false),
+    listChildren: external_exports.boolean()
+  })
+});
+var workspaceFileContentSchema = external_exports.object({
+  resource: resolvedWorkspaceResourceSchema,
+  content: external_exports.object({
+    encoding: external_exports.enum(["utf8", "base64"]),
+    data: external_exports.string()
+  })
+});
+
 // node_modules/@paperclipai/shared/dist/validators/work-product.js
 function attachmentContentPath(attachmentId) {
   return `/api/attachments/${attachmentId}/content`;
@@ -7187,6 +7382,9 @@ var attachmentArtifactWorkProductMetadataSchema = external_exports.object({
     });
   }
 });
+var issueWorkProductMetadataSchema = external_exports.object({
+  resourceRef: workspaceFileRefSchema.optional().nullable()
+}).passthrough();
 var createIssueWorkProductSchema = external_exports.object({
   projectId: external_exports.string().uuid().optional().nullable(),
   executionWorkspaceId: external_exports.string().uuid().optional().nullable(),
@@ -7201,7 +7399,7 @@ var createIssueWorkProductSchema = external_exports.object({
   isPrimary: external_exports.boolean().optional().default(false),
   healthStatus: external_exports.enum(["unknown", "healthy", "unhealthy"]).optional().default("unknown"),
   summary: external_exports.string().optional().nullable(),
-  metadata: external_exports.record(external_exports.string(), external_exports.unknown()).optional().nullable(),
+  metadata: issueWorkProductMetadataSchema.optional().nullable(),
   createdByRunId: external_exports.string().uuid().optional().nullable()
 });
 var updateIssueWorkProductSchema = createIssueWorkProductSchema.partial();
@@ -8388,6 +8586,18 @@ var paperclipConfigSchema = external_exports.object({
   }
 });
 
+// node_modules/@paperclipai/shared/dist/validators/adapter-registry.js
+var adapterRegistryEntrySchema = external_exports.object({
+  adapterType: external_exports.string().min(1),
+  enabled: external_exports.boolean().default(true),
+  runtimeImage: external_exports.string().optional(),
+  envKeys: external_exports.array(external_exports.string()).optional(),
+  allowFqdns: external_exports.array(external_exports.string()).optional(),
+  probeCommand: external_exports.array(external_exports.string()).optional(),
+  defaultEnv: external_exports.record(external_exports.string()).optional()
+}).strict();
+var adapterRegistrySchema = external_exports.array(adapterRegistryEntrySchema);
+
 // node_modules/@paperclipai/plugin-sdk/dist/worker-rpc-host.js
 import fs from "node:fs";
 import { AsyncLocalStorage } from "node:async_hooks";
@@ -9773,88 +9983,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 +10000,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 +10009,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 +10034,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 +10047,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 +10067,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 +10078,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 +10122,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 +10130,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 +10149,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 +10159,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 +10186,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 +10229,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 +10253,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 +10272,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 +10287,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 +10308,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 +10329,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 +10353,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 +10364,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 +10394,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 +10418,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 +10434,7 @@ var plugin = definePlugin({
         }
         try {
           const json = await api(
-            `/api/keyword-research/${encodeURIComponent(keywordSessionRef)}/status`,
+            `/keyword-research/${encodeURIComponent(keywordSessionRef)}/status`,
             "GET"
           );
           return {