videodraft 0.13.3 → 0.15.0

package/README.md

@@ -91,15 +91,25 @@ videodraft create "<idea>" --ar 9:16            # idea → script → visual ass
 videodraft shots <project> --grid --estimate    # preview the cost…
 videodraft shots <project> --grid               # …then batch-generate every shot image
 videodraft produce <project>                    # voiceovers + captions + production timeline
+videodraft produce <project> --mode full_video --allow-real-people
 videodraft export <project> --download final.mp4
 ```
 
+Seedance 2.x uses Byteplus only at the default lower price. If supplied visual
+input media, including a start/end frame or image/video reference, visibly
+contains a real identifiable person, pass
+`--allow-real-people` on the first request. It keeps Byteplus first, permits a
+submit-time Fal fallback, and uses Fal's higher tier-specific rate. If an
+unflagged request returns `SEEDANCE_REAL_PERSON_OPT_IN_REQUIRED`, estimate the
+higher rate and retry once with the flag. Do not loop if it was already set;
+late Byteplus output refusals are refunded but cannot be rerouted.
+
 ## Commands
 
 | Group           | Commands                                                                                                                                                                             |
 | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
 | Auth            | `login` `logout` `whoami`                                                                                                                                                            |
-| Account         | `credits` `costs [model]` `models [image\|video\|audio\|voices\|styles]` `workspaces` `sessions list/create` `kling-voices list/create/delete`                                       |
+| Account         | `credits` `costs [model]` `models [image\|video\|audio\|voices\|styles]` `workspaces` `sessions list/create/current/reset` `kling-voices list/create/delete`                                       |
 | Projects        | `projects list/get/delete/favorite/open` `checkpoint create/list/restore`                                                                                                            |
 | Pipeline        | `create` `shots` `produce` (`--mode full_video`) `attach` `finalize` `export` `export-status` `video-prompts`                                                                        |
 | Generate        | `generate image/video/audio/voiceover/music/sound-effect/dialogue/voice-changer/dub` `edit video/motion` `upscale image/video` `avatar script/create/render/get/list/fabric/lipsync` |

package/dist/client.d.ts

@@ -1,3 +1,72 @@
+/**
+ * Connection sessions for the CLI.
+ *
+ * The VideoDraft MCP server hands every connection an `Mcp-Session-Id` on
+ * `initialize` and files that connection's project-less generations into its
+ * own AI Studio session (named after the client and date). MCP hosts echo the
+ * header for free; the CLI is stateless per invocation, so it keeps the
+ * header in a small store and replays it on every request.
+ *
+ * Scope: one session per (profile, base URL, working directory), expiring
+ * after SESSION_IDLE_MS without use. A working directory is a good proxy for
+ * "one piece of work" — an agent's workspace, a project folder — and it is
+ * stable across the many short-lived shells agents spawn (parent PIDs are
+ * not). Override the scope with VIDEODRAFT_SESSION_SCOPE=<any label>, pin an
+ * explicit AI Studio session with --session / VIDEODRAFT_SESSION, or rotate
+ * with `videodraft sessions reset`.
+ *
+ * Runtime-agnostic: no console, no process.exit. Fails soft — a broken store
+ * just means the server falls back to the shared "Agent (MCP)" session.
+ */
+declare const SESSION_IDLE_MS: number;
+declare const MCP_SESSION_HEADER = "Mcp-Session-Id";
+interface ConnectionSessionRecord {
+    token: string;
+    scope: string;
+    cwd: string;
+    baseUrl: string;
+    profile: string;
+    createdAt: string;
+    lastUsedAt: string;
+}
+interface ConnectionSessionStore {
+    /** Current token for this scope, or null when absent/expired. */
+    load(): string | null;
+    /**
+     * Persist a freshly minted token for this scope and return the token that
+     * now owns the scope. Two processes racing on an empty scope both mint;
+     * the first writer wins and the second gets the winner's token back, so
+     * one directory never ends up split across two sessions.
+     */
+    save(token: string): string;
+    /** Replace the scope's token unconditionally (server re-mint). */
+    replace(token: string): void;
+    /** Forget the current token; the next call re-initialises. */
+    reset(): void;
+    /** Where this scope's record lives (for `sessions current`). */
+    describe(): {
+        scope: string;
+        file: string;
+        record: ConnectionSessionRecord | null;
+        /** True when a record exists but is past the idle window. */
+        expired: boolean;
+        /** The AI Studio session id inside the token, when it parses. */
+        sessionId: string | null;
+    };
+}
+interface SessionScopeInput {
+    baseUrl: string;
+    profile: string;
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    now?: () => number;
+}
+/** Stable label for this scope; what the record is keyed by. */
+declare function sessionScope(input: SessionScopeInput): string;
+declare function createConnectionSessionStore(input: SessionScopeInput): ConnectionSessionStore;
+/** Drop every stored connection session (all scopes) for this config dir. */
+declare function resetAllConnectionSessions(env?: NodeJS.ProcessEnv): number;
+
 /**
  * JSON-RPC 2.0 client for the VideoDraft MCP endpoint (POST {base}/api/mcp).
  *
@@ -5,6 +74,7 @@
  * console — this file is part of the `videodraft/client` subpath export the
  * macOS app's sidecar consumes. Errors are thrown, never printed.
  */
+
 interface TokenProvider {
     /** Return a bearer token (vd_mcp_...). Throw AuthError when none is available. */
     getAccessToken(): Promise<string>;
@@ -21,6 +91,20 @@ interface VideoDraftClientOptions {
     userAgent?: string;
     /** Per-request timeout in ms. Generation submits can be slow; default 300s (server maxDuration). */
     requestTimeoutMs?: number;
+    /**
+     * Optional connection-session store. When present the client performs the
+     * MCP `initialize` handshake once per scope, keeps the server's
+     * Mcp-Session-Id, and replays it on every request — which files this
+     * scope's project-less generations into their own AI Studio session
+     * instead of the shared "Agent (MCP)" one. Omit for a stateless client.
+     */
+    session?: ConnectionSessionStore;
+    /**
+     * Name reported as MCP clientInfo.name during the session handshake; it
+     * becomes the label of the auto-created AI Studio session ("Claude Code ·
+     * Aug 22, 2026"). Defaults to the user-agent's product token.
+     */
+    clientName?: string;
 }
 interface McpToolInfo {
     name: string;
@@ -33,8 +117,30 @@ declare class VideoDraftClient {
     private readonly fetchImpl;
     private readonly userAgent;
     private readonly requestTimeoutMs;
+    private readonly session?;
+    private readonly clientName;
+    /** In-memory copy of the Mcp-Session-Id for this process; null = none. */
+    private sessionId;
+    private handshake?;
     private nextId;
     constructor(options: VideoDraftClientOptions);
+    /** The Mcp-Session-Id this client sends, after the handshake (null = none). */
+    get connectionSessionId(): string | null;
+    /**
+     * Ensure we hold a Mcp-Session-Id when a store is configured: reuse the
+     * stored one, else run `initialize` once and keep what the server minted.
+     * Fails soft — any error here leaves sessionId null and the call proceeds
+     * stateless (server falls back to the shared session).
+     */
+    private ensureSession;
+    private sessionHeaders;
+    /**
+     * The server re-mints a Mcp-Session-Id on any response whose request
+     * carried one it could not verify (rotated signing secret, a token minted
+     * for another account on this profile). Adopt it so the store self-heals
+     * instead of silently falling back to the shared session until the TTL.
+     */
+    private adoptSession;
     get endpoint(): string;
     rpc<T = any>(method: string, params?: unknown): Promise<T>;
     private post;
@@ -277,7 +383,9 @@ declare class CliError extends Error {
     exitCode: number;
     /** One-line remediation shown under the error (human mode only). */
     hint?: string;
-    constructor(message: string, exitCode?: number, hint?: string);
+    /** Optional machine-readable server recovery contract. */
+    data?: unknown;
+    constructor(message: string, exitCode?: number, hint?: string, data?: unknown);
 }
 declare class AuthError extends CliError {
     constructor(message?: string);
@@ -291,7 +399,7 @@ declare class RpcError extends CliError {
 /** A tools/call result that came back isError:true. */
 declare class ToolError extends CliError {
     toolName: string;
-    constructor(toolName: string, message: string);
+    constructor(toolName: string, message: string, data?: unknown);
 }
 declare class TimeoutError extends CliError {
     constructor(message: string);
@@ -373,4 +481,4 @@ declare function refreshAccessToken(params: {
 /** RFC 7009 revocation — best-effort, used by `videodraft logout`. */
 declare function revokeToken(baseUrl: string, token: string, fetchImpl?: typeof fetch): Promise<void>;
 
-export { AuthError, type CliConfig, CliError, DEFAULT_BASE_URL, type DownloadedFile, EXIT, type GenerationResult, type McpToolInfo, type PollOptions, type Profile, type ResolvedAuth, RpcError, STATIC_CLI_CLIENT_ID, TimeoutError, type TokenProvider, ToolError, type UploadResult, VideoDraftClient, type VideoDraftClientOptions, authorizeViaLoopback, buildAuthorizeUrl, configDir, configPath, createPkcePair, downloadOutputs, downloadUrl, exchangeCode, extFromUrl, extractOutputUrls, getProfile, guessContentType, nextPollDelay, pollExport, pollGeneration, pollGenerations, pollGenerationsBatch, probeClientId, profileTokenProvider, readConfig, refreshAccessToken, registerCliClient, renderTemplate, resolveAuth, revokeToken, staticTokenProvider, updateConfig, uploadFile, writeConfig };
+export { AuthError, type CliConfig, CliError, type ConnectionSessionRecord, type ConnectionSessionStore, DEFAULT_BASE_URL, type DownloadedFile, EXIT, type GenerationResult, MCP_SESSION_HEADER, type McpToolInfo, type PollOptions, type Profile, type ResolvedAuth, RpcError, SESSION_IDLE_MS, STATIC_CLI_CLIENT_ID, TimeoutError, type TokenProvider, ToolError, type UploadResult, VideoDraftClient, type VideoDraftClientOptions, authorizeViaLoopback, buildAuthorizeUrl, configDir, configPath, createConnectionSessionStore, createPkcePair, downloadOutputs, downloadUrl, exchangeCode, extFromUrl, extractOutputUrls, getProfile, guessContentType, nextPollDelay, pollExport, pollGeneration, pollGenerations, pollGenerationsBatch, probeClientId, profileTokenProvider, readConfig, refreshAccessToken, registerCliClient, renderTemplate, resetAllConnectionSessions, resolveAuth, revokeToken, sessionScope, staticTokenProvider, updateConfig, uploadFile, writeConfig };