@hubfluencer/mcp 0.17.0 → 0.18.0

package/README.md

@@ -28,7 +28,7 @@ Hubfluencer app, and a scoped access token is saved locally to `~/.hubfluencer/c
 (mode 0600) — the MCP server reads it from there automatically.
 
 ```bash
-npx -y @hubfluencer/mcp@0.17.0 login "Claude Code"
+npx -y @hubfluencer/mcp@0.18.0 login "Claude Code"
 #  1. Open:        https://app.hubfluencer.com/connect?code=ABCD-EFGH
 #  2. Confirm code: ABCDEFGH
 #  3. Click Approve.  →  ✓ Connected.
@@ -37,14 +37,14 @@ npx -y @hubfluencer/mcp@0.17.0 login "Claude Code"
 Then register the server (no token env needed — it uses the stored credential):
 
 ```bash
-claude mcp add hubfluencer -- npx -y @hubfluencer/mcp@0.17.0 --profile creator
+claude mcp add hubfluencer -- npx -y @hubfluencer/mcp@0.18.0 --profile creator
 ```
 
 Verify it connected:
 
 ```bash
 claude mcp list   # → hubfluencer: ... ✓ Connected
-npx -y @hubfluencer/mcp@0.17.0 doctor --profile creator
+npx -y @hubfluencer/mcp@0.18.0 doctor --profile creator
 ```
 
 ### Alternative: paste an access token
@@ -53,13 +53,13 @@ Create a token in the app (**Settings → Access tokens**, scoped `video:generat
 it **cannot** delete your account, change credentials, publish, or create more tokens), then:
 
 ```bash
-claude mcp add hubfluencer --env HUBFLUENCER_API_TOKEN=YOUR_TOKEN -- npx -y @hubfluencer/mcp@0.17.0 --profile creator
+claude mcp add hubfluencer --env HUBFLUENCER_API_TOKEN=YOUR_TOKEN -- npx -y @hubfluencer/mcp@0.18.0 --profile creator
 ```
 
 Install the concise Agent Skill and its advanced reference in one command:
 
 ```bash
-npx -y @hubfluencer/mcp@0.17.0 install-skill --client claude-code
+npx -y @hubfluencer/mcp@0.18.0 install-skill --client claude-code
 # clients: claude-code, codex, opencode, pi; add --project for project scope
 ```
 
@@ -114,7 +114,6 @@ instead draw a **free daily quota of 20 AI assists** (top up with `unlock_ai_ass
 | `create_short` | Create a short draft (12s vertical: two 6s AI segments + title overlay + music; 14s when it ends on a poster or brand-lockup end card). Set `headline` (≈4 words, ≤40 chars), `subheadline`, `music_vibe`, and an explicit `visual_language` (`kinetic_creator` is a strong default) — and **always `cta_text`** (a short without a CTA doesn't convert; blank `cta_text` → the server renders a neutral localized ask, e.g. "Learn more" — a truly CTA-less short is not currently supported). End-card fields: `closing_claim` (≤80), `brand_name` (≤40), `end_card` (`"auto"`\|`"none"`). Other opt-in conversion graphics: `offer_text`/`badge_text`/`star_rating` — only what you can substantiate. | **0** |
 | `update_short` | Patch an existing short draft — brief (`product_prompt`), copy, styling, end-card fields (`closing_claim`/`brand_name`/`poster_includes_lockup`/`end_card`), logo overlay placement (`short_logo_position`/`short_logo_treatment`), or the opt-in conversion graphics; only the fields you pass change. Clear one with `""` (`[]` for `text_beats`, `0` for `star_rating`). Apply text/style/CTA/end-card/logo edits to a generated short free with `rerender_short`; footage/music edits need `generate_short`. | **0** |
 | `generate_short` | Render an existing short — re-rolls the footage + music (fresh AI generation). If headline/subheadline/beats are all blank the server auto-writes the copy first (`skip_auto_text:true` for a deliberately bare clip). Safe to re-call (in-flight = reported, no double charge; a failed or cancelled paid Short can re-generate when its summary advertises `start_generation`). | **15** |
-| `cancel_short_generation` | Stop the caller-observed paid short run, fence late workers from publishing, preserve the editable draft, and restore its 15 credits idempotently. The MCP tool re-reads the canonical summary and sends its run fence automatically; callers may optionally supply `generation_run_id` to reject a stale command. Raw REST callers must send the latest `generation_summary.run_id` plus `Idempotency-Key`, reusing the key only for transport retries of this exact cancellation. After cancellation, re-read the summary and generate a successor only when it advertises `start_generation`. | **full refund** |
 | `rerender_short` | **FREE re-render** — applies the short's current text/style/CTA/end-card/logo state over the already-paid footage + music. Use after `update_short` for copy/style/CTA tweaks, or after a logo change (`set_short_logo`, or `short_logo_position`/`short_logo_treatment`); footage or music changes need `generate_short` instead. Needs one completed generation first (422 `short_not_ready` otherwise); changed footage/music inputs return 422 `short_paid_regeneration_required`. A failed free re-render leaves the delivered video intact — retry `rerender_short`, it stays free. | **0** |
 | `generate_short_text` | AI-draft editable headline / subheadline / caption beats for a short. | 1 assist |
 | `create_editor_ad` | Create an editor project, attach optional local product/logo/closing assets, and return the live autopilot quote. Pass `segments_count` (3–10) as the exact structural target. Omit `max_credits` to stop free; provide an approved cap to launch. Write every required person, product, object, and continuity decision directly in the prompt. | **0** until capped launch |
@@ -394,7 +393,7 @@ start a NEW project (omit `slug`, pass `video_path`).
 | `/mcp` → **Failed to reconnect: -32000** | The server process never started — almost always because `claude mcp add` was run **inside a Claude session** (a nested `claude` runs the line as a prompt, not the subcommand), so nothing was registered. Re-run the `claude mcp add` above in a **normal terminal**, then `claude mcp list` to confirm. |
 | `npm error could not determine executable to run` | You're on a cached **0.1.x** (which shipped two bins). 0.2.0+ ships a single bin and resolves cleanly. Force a fresh fetch: `npx --ignore-existing -y @hubfluencer/mcp`. |
 | `npm error 404 … @hubfluencer/mcp` immediately after a release | npm registry/CDN propagation lag (a couple of minutes after publish). Wait and retry — it self-heals. |
-| Tools fail with **"Not connected to Hubfluencer"** | No token resolved. Run `npx -y @hubfluencer/mcp@0.17.0 login`, or pass `--env HUBFLUENCER_API_TOKEN=…`. |
+| Tools fail with **"Not connected to Hubfluencer"** | No token resolved. Run `npx -y @hubfluencer/mcp@0.18.0 login`, or pass `--env HUBFLUENCER_API_TOKEN=…`. |
 | A local-file tool fails with a **path-outside-base** error | The file is outside `HUBFLUENCER_INPUT_DIR` (reads) or `save_path` is outside `HUBFLUENCER_OUTPUT_DIR` (writes). Move the file into the allowed dir, or point the env var at it. |
 | An asset-catalog tool returns **subscription required** | `list_assets` / `get_asset_quota` / `upload_asset` need an active subscription — subscribe in the app. |
 
@@ -409,7 +408,7 @@ bun run build      # emits dist/
 
 The package exposes a single bin, `hubfluencer-mcp`: with no args it starts the stdio MCP
 server; `hubfluencer-mcp login [name]` runs the device-link login. This is why
-`npx -y @hubfluencer/mcp@0.17.0` and `npx -y @hubfluencer/mcp@0.17.0 login` both work without `-p`.
+`npx -y @hubfluencer/mcp@0.18.0` and `npx -y @hubfluencer/mcp@0.18.0 login` both work without `-p`.
 
 ### Release
 

package/dist/index.js

@@ -33979,7 +33979,6 @@ function knownGenerationActionTypesFrom(summary) {
 }
 var operation = (tool, required_fences = []) => ({ tool, required_fences });
 var generationProductOperations = {
-  "short:short.generation:cancel_generation": operation("cancel_short_generation", ["generation_run_id", "idempotency_key"]),
   "short:*:start_generation": operation("generate_short", ["idempotency_key"]),
   "short:*:download_result": operation("download_result"),
   "short:*:edit_required_input": operation("provide_generation_input", [
@@ -34942,7 +34941,7 @@ function readStoredCredentials() {
 // package.json
 var package_default = {
   name: "@hubfluencer/mcp",
-  version: "0.17.0",
+  version: "0.18.0",
   mcpName: "io.github.monocursive/hubfluencer",
   description: "Model Context Protocol server for Hubfluencer — let AI agents generate post-ready shorts and editor ads.",
   license: "MIT",
@@ -36044,7 +36043,6 @@ var CREATOR_TOOL_NAMES = [
   "create_short",
   "update_short",
   "generate_short",
-  "cancel_short_generation",
   "rerender_short",
   "set_short_product",
   "set_short_logo",
@@ -37692,45 +37690,6 @@ registerTool("generate_short", {
     throw e;
   }
 }));
-registerTool("cancel_short_generation", {
-  title: "Cancel a running short generation",
-  description: "Stops the currently observed paid Short generation through the product-scoped cancellation route, " + "fences late provider callbacks, and settles its refund exactly once. The canonical generation_run_id is " + "read from get_status when omitted. The draft is preserved for editing and " + "regeneration. Safe to repeat after a successful cancellation. The raw REST route requires Idempotency-Key; " + "reuse one only for transport retries of this exact run. Scope: video:generate.",
-  inputSchema: {
-    slug: exports_external.string().describe("Slug of the processing short"),
-    generation_run_id: exports_external.string().uuid().optional().describe("Exact run fence from get_status; normally omitted because the tool reads current status first")
-  },
-  annotations: {
-    title: "Cancel short generation",
-    readOnlyHint: false,
-    destructiveHint: true,
-    openWorldHint: true,
-    idempotentHint: true
-  }
-}, tool(async (args, client) => {
-  const observed = await observedGenerationAction(client, "short", args.slug, "cancel_generation", {
-    workflows: ["short.generation"],
-    statuses: ["queued", "running", "cancelled"],
-    recoverCancelled: true
-  });
-  const generationRunId = observed.summary.run_id;
-  if (typeof generationRunId !== "string" || generationRunId.length === 0) {
-    throw new Error("The Short response did not include a canonical run_id; refresh get_status before cancelling safely.");
-  }
-  if (args.generation_run_id !== undefined && args.generation_run_id !== generationRunId) {
-    throw new Error("The supplied generation_run_id does not match the authoritative Short state; refresh before cancelling.");
-  }
-  const receiptKey = idemKey("cancel-short-generation", args.slug, generationRunId);
-  const data = observed.settledReplay ? observed.state : asRecord(asRecord(await client.post(`/shorts/${args.slug}/cancel`, { generation_run_id: generationRunId }, receiptKey)).data);
-  return ok({
-    ...data,
-    slug: args.slug,
-    run_id: observed.summary.run_id,
-    workflow: observed.summary.workflow,
-    charged: false,
-    refund: "refunded" in data ? data.refunded : "settled (idempotent — no new credits minted on repeat)",
-    next: "Edit the preserved draft, then call generate_short when ready."
-  });
-}));
 registerTool("rerender_short", {
   title: "Re-render a short (FREE — 0 credits)",
   description: "FREE re-render: applies the short's current text/style/CTA/end-card/logo state over the already-paid " + "footage and music — 0 credits. Use after update_short for copy/style/CTA tweaks, or after a logo change " + "(set_short_logo, or short_logo_position/short_logo_treatment via update_short). Footage or music " + "changes need generate_short (15 credits) instead. Edits that add/remove the end card (poster, " + "end_card) can shift the video between 12s and 14s; when the pinned music bed is shorter than the " + "export it crossfades into a repeated continuation, then fades at the export end, without regeneration. " + "Requires a completed generation to re-render over " + "(422 short_not_ready otherwise — run generate_short once first); while any generation/render is in " + "flight it reports in-progress (409) rather than duplicating. Then poll with get_status or " + "wait_for_completion (kind=short). A failed free re-render leaves the delivered video intact — retry " + "rerender_short, it stays free (the status fields latest_render_free / last_free_rerender_failed " + "report this when the server sends them).",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hubfluencer/mcp",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "mcpName": "io.github.monocursive/hubfluencer",
   "description": "Model Context Protocol server for Hubfluencer — let AI agents generate post-ready shorts and editor ads.",
   "license": "MIT",

package/server.json

@@ -9,12 +9,12 @@
     "source": "github",
     "subfolder": "packages/mcp"
   },
-  "version": "0.17.0",
+  "version": "0.18.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@hubfluencer/mcp",
-      "version": "0.17.0",
+      "version": "0.18.0",
       "transport": {
         "type": "stdio"
       },

package/skill/hubfluencer-create/SKILL.md

@@ -21,8 +21,8 @@ substitute.
 If Hubfluencer is not connected, tell the user to run:
 
 ```bash
-npx -y @hubfluencer/mcp@0.17.0 login
-npx -y @hubfluencer/mcp@0.17.0 doctor --profile creator
+npx -y @hubfluencer/mcp@0.18.0 login
+npx -y @hubfluencer/mcp@0.18.0 doctor --profile creator
 ```
 
 Never invent, request in chat, or echo a token. A PAT may instead be supplied to
@@ -98,9 +98,9 @@ create_short -> edit/attach assets -> generate_short
 
 `generate_short` is the paid footage/music generation. After it completes,
 `update_short` plus `rerender_short` applies text/style/CTA/end-card/logo changes
-over the existing footage for free. `cancel_short_generation` reads the
-canonical summary and uses `generation_run_id` only when the caller supplies
-that optional stale-command fence.
+over the existing footage for free. A paid Short run cannot be stopped once
+started: there is no cancel tool or route, and the draft cannot be deleted until
+the run reaches a terminal state. A failed run still refunds its 15 credits.
 
 Editor ad:
 

package/skill/hubfluencer-create/references/full-guide.md

@@ -37,8 +37,8 @@ or guess a fence. Re-read status after the command.
 ## Prerequisites
 
 - The `hubfluencer` MCP server must be connected (tools like `make_video`, `get_credits`, `wait_for_completion` are available).
-- The user must have an access token configured (via `HUBFLUENCER_API_TOKEN`, or by having run `npx -y @hubfluencer/mcp@0.17.0 login` — a scoped token is then saved to `~/.hubfluencer/credentials.json` and the server reads it automatically).
-- **Never invent a token, and never echo a token in your output.** If no token is configured, tell the user to create one in the app (Settings → Access tokens, "Generate videos" scope) or to run `npx -y @hubfluencer/mcp@0.17.0 login`, then stop.
+- The user must have an access token configured (via `HUBFLUENCER_API_TOKEN`, or by having run `npx -y @hubfluencer/mcp@0.18.0 login` — a scoped token is then saved to `~/.hubfluencer/credentials.json` and the server reads it automatically).
+- **Never invent a token, and never echo a token in your output.** If no token is configured, tell the user to create one in the app (Settings → Access tokens, "Generate videos" scope) or to run `npx -y @hubfluencer/mcp@0.18.0 login`, then stop.
 
 ## Native macOS Studio
 
@@ -81,7 +81,7 @@ advertised; never guess fences. Retry targets the exact failed canonical step. O
 retrying it does not authorize a new parent run. For an insufficient-credit blocker, top up or reduce
 scope and follow the action in the newly read summary.
 
-Cancellation is run-fenced. `cancel_short_generation { slug, generation_run_id }` uses `generation_summary.run_id`, keeps the draft, and refunds 15 credits idempotently. `cancel_segment_generation { slug, segment_id, generation_claim_token }` uses the current token from `get_editor` and refunds an individually generated scene; batch/Autopilot scenes use workflow controls. `cancel_autopilot { slug }` re-reads and forwards the summary run/start fence, stopping only that parent chain while keeping completed work and already charged scenes. Re-read state after a stale fence error; never guess a fence value.
+Cancellation is run-fenced. A paid short is not cancellable once `generate_short` starts, and its draft cannot be deleted until the run is terminal; a failure still refunds its 15 credits. `cancel_segment_generation { slug, segment_id, generation_claim_token }` uses the current token from `get_editor` and refunds an individually generated scene; batch/Autopilot scenes use workflow controls. `cancel_autopilot { slug }` re-reads and forwards the summary run/start fence, stopping only that parent chain while keeping completed work and already charged scenes. Re-read state after a stale fence error; never guess a fence value.
 
 **Minimum sellable short** — check all seven before you spend:
 

package/src/generation-summary.ts

@@ -165,10 +165,6 @@ const operation = (
  * can carry out an already-advertised intent.
  */
 export const generationProductOperations = {
-	"short:short.generation:cancel_generation": operation(
-		"cancel_short_generation",
-		["generation_run_id", "idempotency_key"],
-	),
 	"short:*:start_generation": operation("generate_short", ["idempotency_key"]),
 	"short:*:download_result": operation("download_result"),
 	"short:*:edit_required_input": operation("provide_generation_input", [

package/src/index.ts

@@ -2947,96 +2947,6 @@ registerTool(
 	}),
 );
 
-registerTool(
-	"cancel_short_generation",
-	{
-		title: "Cancel a running short generation",
-		description:
-			"Stops the currently observed paid Short generation through the product-scoped cancellation route, " +
-			"fences late provider callbacks, and settles its refund exactly once. The canonical generation_run_id is " +
-			"read from get_status when omitted. The draft is preserved for editing and " +
-			"regeneration. Safe to repeat after a successful cancellation. The raw REST route requires Idempotency-Key; " +
-			"reuse one only for transport retries of this exact run. Scope: video:generate.",
-		inputSchema: {
-			slug: z.string().describe("Slug of the processing short"),
-			generation_run_id: z
-				.string()
-				.uuid()
-				.optional()
-				.describe(
-					"Exact run fence from get_status; normally omitted because the tool reads current status first",
-				),
-		},
-		annotations: {
-			title: "Cancel short generation",
-			readOnlyHint: false,
-			destructiveHint: true,
-			openWorldHint: true,
-			idempotentHint: true,
-		},
-	},
-	tool(async (args: { slug: string; generation_run_id?: string }, client) => {
-		const observed = await observedGenerationAction(
-			client,
-			"short",
-			args.slug,
-			"cancel_generation",
-			{
-				workflows: ["short.generation"],
-				statuses: ["queued", "running", "cancelled"],
-				recoverCancelled: true,
-			},
-		);
-		const generationRunId = observed.summary.run_id;
-		if (typeof generationRunId !== "string" || generationRunId.length === 0) {
-			throw new Error(
-				"The Short response did not include a canonical run_id; refresh get_status before cancelling safely.",
-			);
-		}
-		if (
-			args.generation_run_id !== undefined &&
-			args.generation_run_id !== generationRunId
-		) {
-			throw new Error(
-				"The supplied generation_run_id does not match the authoritative Short state; refresh before cancelling.",
-			);
-		}
-		const receiptKey = idemKey(
-			"cancel-short-generation",
-			args.slug,
-			generationRunId,
-		);
-
-		const data = observed.settledReplay
-			? observed.state
-			: asRecord(
-					asRecord(
-						await client.post<{ data: unknown }>(
-							`/shorts/${args.slug}/cancel`,
-							{ generation_run_id: generationRunId },
-							receiptKey,
-						),
-					).data,
-				);
-		return ok({
-			...data,
-			slug: args.slug,
-			run_id: observed.summary.run_id,
-			workflow: observed.summary.workflow,
-			charged: false,
-			// The cancel endpoint returns the short's STATE, not a refund receipt,
-			// so don't assert refunded:true on every call — a repeat cancel is a
-			// no-op that mints no new credits. Echo the server's own flag if it ever
-			// sends one; otherwise describe the honest idempotent settlement.
-			refund:
-				"refunded" in data
-					? data.refunded
-					: "settled (idempotent — no new credits minted on repeat)",
-			next: "Edit the preserved draft, then call generate_short when ready.",
-		});
-	}),
-);
-
 registerTool(
 	"rerender_short",
 	{

package/src/tool-profile.ts

@@ -18,7 +18,6 @@ export const CREATOR_TOOL_NAMES = [
 	"create_short",
 	"update_short",
 	"generate_short",
-	"cancel_short_generation",
 	"rerender_short",
 	"set_short_product",
 	"set_short_logo",