videodraft 0.14.0 → 0.15.1

package/README.md

@@ -109,7 +109,7 @@ late Byteplus output refusals are refunded but cannot be rerouted.
 | 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,85 @@
+/**
+ * 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. Returns null
+     * when the token could NOT be persisted (read-only config dir): the
+     * caller must then go stateless — sending an unpersisted token would
+     * create a fresh AI Studio session per invocation, when the documented
+     * degraded mode is the shared server-side fallback.
+     */
+    save(token: string): string | null;
+    /** Replace the scope's token unconditionally (server re-mint). */
+    replace(token: string): void;
+    /**
+     * Forget the current token; the next call re-initialises. Returns whether
+     * the deletion actually ran — false means the scope lock could not be
+     * taken (or the filesystem refused) and the record may still exist.
+     */
+    reset(): boolean;
+    /** 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.
+ * Each record is removed under its per-scope lock — the same protocol as
+ * the single-scope reset — so a concurrent touch/replace that already read
+ * the old record cannot recreate it right after the sweep deletes it.
+ */
+declare function resetAllConnectionSessions(env?: NodeJS.ProcessEnv): number;
+
 /**
  * JSON-RPC 2.0 client for the VideoDraft MCP endpoint (POST {base}/api/mcp).
  *
@@ -5,6 +87,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 +104,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 +130,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;
@@ -375,4 +494,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 };