@eddyskywalker/dsh-chatgpt-subscription 0.30.0 → 0.32.0

package/lib/types/host/cline-pass/types.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Static facts about the Cline Pass subscription and its gateway.
+ *
+ * The upstream is an OpenAI-compatible `chat/completions` endpoint
+ * (`https://api.cline.bot/api/v1`) that fronts several model providers. Routing
+ * is decided by that gateway, and the two pipelines it can use spell an upstream
+ * pin differently — see `protocol.ts`. Authentication is a static API key in
+ * `Authorization: Bearer`: there is no OAuth flow and no token expiry.
+ *
+ * The model table below is transcribed from the Cline Pass subscription list and
+ * the public `models.dev` catalog. It is a fallback, not a ceiling: a model the
+ * live catalog scan discovers is described by what that scan published, and a
+ * model this release has never heard of is adopted with conservative metadata
+ * rather than hidden.
+ */
+import type { ClinePassPinMode } from '../../shared/cline-pass-contracts.ts';
+export declare const PROVIDER_ID = "cline-pass";
+export declare const PROVIDER_NAME = "Cline Pass";
+/** Default gateway. Overridable per deployment and per account. */
+export declare const DEFAULT_BASE_URL = "https://api.cline.bot/api/v1";
+/** Public endpoint that lists subscription models without auth. */
+export declare const RECOMMENDED_MODELS_URL = "https://api.cline.bot/api/v1/ai/cline/recommended-models";
+/** The upstream gateway's own catalog: the only source naming reasoning levels. */
+export declare const VERCEL_MODELS_URL = "https://ai-gateway.vercel.sh/v1/models";
+/** The community model registry, a metadata backstop. */
+export declare const MODELS_DEV_URL = "https://models.dev/api.json";
+/** OpenRouter's public API, used only for direct-pipeline endpoint detail. */
+export declare const OPENROUTER_API = "https://openrouter.ai/api/v1";
+/** Authenticated sub-paths on the gateway. */
+export declare const USAGE_LIMITS_PATH = "/users/me/plan/usage-limits";
+export declare const PROFILE_PATH = "/users/me";
+export declare const USAGE_PAGE_SIZE = 200;
+export declare const USAGE_MAX_PAGES = 12;
+/** Conservative context capacity for a model no catalog describes. */
+export declare const DEFAULT_CONTEXT_WINDOW = 128000;
+/**
+ * Per-request output budget when the caller states none.
+ *
+ * A budget, not a ceiling: the harness reserves it as completion room before it
+ * compacts, so this decides how much of the window stays available. 64k keeps
+ * the reserve far below the compaction ratio while leaving room for a
+ * tool-calling agent's longest turn.
+ */
+export declare const DEFAULT_MAX_TOKENS = 64000;
+/** Streams one account may keep open at once; `0` lifts the cap. */
+export declare const DEFAULT_MAX_CONCURRENT_REQUESTS = 16;
+/** Idle budget for one Cline Pass stream. */
+export declare const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 300000;
+/** Request-history rows retained in memory. */
+export declare const DEFAULT_HISTORY_LIMIT = 100;
+/**
+ * How long one account-level refusal keeps an account out of the pool.
+ *
+ * Only the two refusals that are about the ACCOUNT are listed: a transient 429
+ * is answered by the channel retry, and standing an account down for it would
+ * cost capacity the request never proved was gone.
+ */
+export declare const POOL_COOLDOWN_MS: number;
+export declare const AUTH_COOLDOWN_MS: number;
+/** How many channels one model's list may hold. */
+export declare const MAX_UPSTREAMS = 64;
+/** How many channels one validation run tests concurrently. */
+export declare const VALIDATE_CONCURRENCY = 5;
+/** Reasoning levels the gateway accepts for every reasoning-capable model. */
+export declare const REASONING_EFFORTS: readonly [{
+    readonly id: "none";
+    readonly name: "None";
+    readonly description: "No extra thinking; fastest and cheapest.";
+}, {
+    readonly id: "minimal";
+    readonly name: "Minimal";
+    readonly description: "A bare minimum of reasoning.";
+}, {
+    readonly id: "low";
+    readonly name: "Low";
+    readonly description: "Prefer for routine or latency-sensitive work.";
+}, {
+    readonly id: "medium";
+    readonly name: "Medium";
+    readonly description: "A balanced amount of reasoning.";
+}, {
+    readonly id: "high";
+    readonly name: "High";
+    readonly description: "More thorough reasoning for multi-step work.";
+}, {
+    readonly id: "xhigh";
+    readonly name: "Extra high";
+    readonly description: "For difficult work that rewards more thinking.";
+}, {
+    readonly id: "max";
+    readonly name: "Max";
+    readonly description: "Reserve for the hardest quality-first tasks.";
+}];
+export type ClinePassReasoningEffort = typeof REASONING_EFFORTS[number]['id'];
+/** One published model entry. */
+export interface ClinePassModelMeta {
+    name: string;
+    contextWindow: number;
+    maxTokens: number;
+    reasoning: boolean;
+    /** Levels this model offers; absent keeps the whole vocabulary. */
+    efforts?: readonly string[];
+    input: readonly string[];
+}
+/**
+ * Published metadata for the shipped Cline Pass models.
+ *
+ * `name` mirrors the provider's own label where one is published and falls back
+ * to the model id. `maxTokens` is the published output ceiling, used to clamp the
+ * configured request budget rather than taken as the budget itself.
+ */
+export declare const MODEL_CATALOG: Readonly<Record<string, ClinePassModelMeta>>;
+/** Subscriptions models current at release time; refreshed on demand. */
+export declare const DEFAULT_MODELS: readonly string[];
+/** Published entry for one model id, if the shipped table knows it. */
+export declare function catalogEntry(model: string): ClinePassModelMeta | undefined;
+/** One stored pin, as the settings file keeps it. */
+export interface ClinePassPinSettings {
+    upstreams: string[];
+    exclude: string[];
+    pinMode: ClinePassPinMode;
+    sort: string;
+}
+/** The default pin: automatic routing, no exclusions. */
+export declare function defaultPin(): ClinePassPinSettings;
+/**
+ * One model as the live catalog describes it, after merging the shipped table,
+ * the last official scan and any per-model override.
+ */
+export interface ClinePassModelInfo {
+    id: string;
+    displayName: string;
+    contextWindow: number;
+    maxTokens: number;
+    reasoning: boolean;
+    efforts: readonly string[];
+    input: readonly string[];
+}
+/** Connection facts one request is built from. */
+export interface ClinePassConnection {
+    baseURL: string;
+    displayName: string;
+    models: ClinePassModelInfo[];
+    defaultContextWindow: number;
+    maxTokens: number;
+    streamIdleTimeoutMs: number;
+    maxConcurrentRequests: number;
+    pinSpelling: string;
+}
+/** One model's metadata as the last official scan published it. */
+export interface ClinePassDiscoveredModel {
+    name?: string;
+    contextWindow?: number;
+    maxTokens?: number;
+    /** The seam vocabulary spelling (`models.dev`). */
+    input?: string[];
+    /** The upstream gateway's spelling. */
+    inputModalities?: string[];
+    reasoning?: boolean;
+    efforts?: string[];
+}
+/** The whole official scan: ids, per-model metadata, and the sources that answered. */
+export interface ClinePassCatalogScan {
+    models: string[];
+    catalog: Record<string, ClinePassDiscoveredModel>;
+    sources: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types/host/cline-pass/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/host/cline-pass/types.ts"],"names":[],"mappings":"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"}

package/lib/types/host/common/model-request-control.d.ts

@@ -1,5 +1,5 @@
 import { ConcurrencyGate } from './concurrency-gate.ts';
-export declare const CONTROLLED_PROVIDERS: readonly ["codex-chatgpt", "claude", "antigravity", "kimi-code", "minimax-code", "command-code", "workbuddy", "ollama", "glm-coding-plan", "step-code"];
+export declare const CONTROLLED_PROVIDERS: readonly ["codex-chatgpt", "claude", "antigravity", "kimi-code", "minimax-code", "command-code", "workbuddy", "ollama", "glm-coding-plan", "step-code", "cline-pass"];
 export type ControlledProvider = typeof CONTROLLED_PROVIDERS[number];
 export interface ModelRequestLimits {
     /** Per credential limits, not guessed subscription entitlements. Zero disables. */

package/lib/types/host/common/model-request-control.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-request-control.d.ts","sourceRoot":"","sources":["../../../../src/host/common/model-request-control.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD,eAAO,MAAM,oBAAoB,yJAA0J,CAAA;AAC3L,MAAM,MAAM,kBAAkB,GAAG,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAA;AACpE,MAAM,WAAW,kBAAkB;IACjC,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAA;IACvD,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,gFAAgF;AAChF,wBAAgB,sBAAsB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,kBAAkB,CAqB/F;AAED,kGAAkG;AAClG,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAO9F;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,MAAM,EAAE,kBAAkB,CAAA;IAC1B,IAAI,CAAC,EAAE,eAAe,CAAA;CACvB;AAED,4FAA4F;AAC5F,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,OAAO,KAAK,EAAE,OAAO,EAAE,0BAA0B,GAAG,OAAO,KAAK,CAmErH"}
+{"version":3,"file":"model-request-control.d.ts","sourceRoot":"","sources":["../../../../src/host/common/model-request-control.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD,eAAO,MAAM,oBAAoB,uKAAwK,CAAA;AACzM,MAAM,MAAM,kBAAkB,GAAG,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAA;AACpE,MAAM,WAAW,kBAAkB;IACjC,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAA;IACvD,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,gFAAgF;AAChF,wBAAgB,sBAAsB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,kBAAkB,CAqB/F;AAED,kGAAkG;AAClG,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAO9F;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,MAAM,EAAE,kBAAkB,CAAA;IAC1B,IAAI,CAAC,EAAE,eAAe,CAAA;CACvB;AAED,4FAA4F;AAC5F,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,OAAO,KAAK,EAAE,OAAO,EAAE,0BAA0B,GAAG,OAAO,KAAK,CAmErH"}

package/lib/types/host/common/request-diagnostics.d.ts

@@ -13,7 +13,7 @@
  *
  * @module dsh-chatgpt-subscription/request-diagnostics
  */
-export declare const DIAGNOSTIC_PROVIDERS: readonly ["codex-chatgpt", "claude-subscription", "antigravity", "kimi-code", "minimax-code", "command-code", "workbuddy-subscription", "ollama", "claude", "workbuddy", "codex", "glm-coding-plan", "step-code"];
+export declare const DIAGNOSTIC_PROVIDERS: readonly ["codex-chatgpt", "claude-subscription", "antigravity", "kimi-code", "minimax-code", "command-code", "workbuddy-subscription", "ollama", "claude", "workbuddy", "codex", "glm-coding-plan", "step-code", "cline-pass"];
 export type DiagnosticProviderId = (typeof DIAGNOSTIC_PROVIDERS)[number];
 export declare const KNOWN_WIRE_ENDPOINTS: readonly ["messages", "responses", "chat_completions", "generate_content", "stream_generate_content", "ollama_chat", "ollama_generate", "workbuddy_chat", "unknown"];
 export type KnownWireEndpoint = (typeof KNOWN_WIRE_ENDPOINTS)[number];

package/lib/types/host/common/request-diagnostics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-diagnostics.d.ts","sourceRoot":"","sources":["../../../../src/host/common/request-diagnostics.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"request-diagnostics.d.ts","sourceRoot":"","sources":["../../../../src/host/common/request-diagnostics.ts"],"names":[],"mappings":"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"}

package/lib/types/host/minimax-code/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/host/minimax-code/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/host/minimax-code/client.ts"],"names":[],"mappings":"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"}

package/lib/types/host/minimax-code/iso-bmff-duration.d.ts

@@ -0,0 +1,84 @@
+/**
+ * The smallest ISO BMFF duration reader this route needs, with no decoder.
+ *
+ * WHY IT EXISTS. A reference video must be sent to the generation service with
+ * its length in seconds beside it (docs/minimax-video-extended-spec.md section
+ * 4), and upstream reads that number out of the container itself rather than
+ * asking the caller for it - `readIsoBmffDurationSeconds` is the name of the
+ * upstream file too. A LOCAL reference video therefore owes the caller no
+ * `referenceVideoDurationSeconds` argument: this module supplies it.
+ *
+ * WHY IT IS NOT AFFMPEG. The number lives in exactly one box, `moov/mvhd`, at a
+ * fixed byte offset inside it. Reaching it is an eight-byte header walk, not a
+ * demux; pulling in a media toolchain (or a native binding) to read two integers
+ * would dwarf the rest of this plugin.
+ *
+ * THE TWO LAYOUTS, which is the whole reason the walk is written the way it is:
+ *
+ * | layout        | box order            | what a whole-file read would cost |
+ * | ------------- | -------------------- | --------------------------------- |
+ * | faststart     | `ftyp moov mdat`     | the moov is near the front         |
+ * | ordinary mp4  | `ftyp mdat moov`     | the moov is AFTER tens of megabytes |
+ *
+ * So the reader NEVER loads the file. It opens a handle, `stat`s the size, and
+ * seeks: it reads the eight-byte header of each TOP-LEVEL box only, jumps over a
+ * `mdat` by its declared size, and - once it lands on `moov` - reads that box's
+ * own child headers the same way until it finds `mvhd`, of which it keeps the
+ * last 32 bytes. A 500 MB clip costs a few dozen bytes of I/O.
+ *
+ * WHAT IT REFUSES, deliberately, instead of guessing:
+ *   - a file that is not ISO BMFF at all (a WebM's EBML magic is not a box
+ *     header) -> `MINIMAX_VIDEO_NOT_ISO_BMFF`;
+ *   - a box header that runs past the end of its container, or a box smaller
+ *     than its own header -> `MINIMAX_VIDEO_NOT_ISO_BMFF`;
+ *   - an ISO BMFF file with no `moov`, no `mvhd`, or a `mvhd` too short to hold
+ *     its own fields -> `MINIMAX_VIDEO_DURATION_UNREADABLE`;
+ *   - a `timescale` of zero (the division has no answer) -> the same code;
+ *   - `mvhd`'s documented "unknown duration" sentinels (all bits set) -> the
+ *     same code, because reporting a made-up length is worse than refusing.
+ *
+ * Every refusal is an ERROR, never `undefined`: a caller that silently got no
+ * duration would send a reference video with no length, or `null`, and neither
+ * is a thing the service asked for.
+ *
+ * @module dsh-chatgpt-subscription/minimax-code/iso-bmff-duration
+ */
+import { HarnessError } from '@deepseek-ai/dsh-llm';
+/**
+ * Raised when a file's length cannot be read out of its ISO BMFF container.
+ *
+ * A `HarnessError` subclass rather than a bare `Error`, so the tool layer can
+ * hand its `code` straight to the caller without re-wrapping the message.
+ */
+export declare class IsoBmffDurationError extends HarnessError {
+    constructor(message: string, code: string);
+}
+/**
+ * Read one mp4/mov file's length in seconds, without decoding a frame.
+ *
+ * The walk, in full:
+ *
+ * 1. `stat` the file - the size is the only bound needed, and nothing is read
+ *    before it is known.
+ * 2. From offset 0, read each TOP-LEVEL box header and jump to the next one, so
+ *    an `mdat` is skipped by arithmetic rather than by reading it. The first box
+ *    must be one of {@link ISO_BMFF_LEADING_BOX_TYPES}, which is where a
+ *    non-mp4 file is caught.
+ * 3. On `moov`, walk ITS direct children the same way until `mvhd` appears. A
+ *    `trak` is skipped by size, exactly like `mdat`.
+ * 4. Read the first {@link MVHD_MAX_READ_BYTES} bytes of `mvhd` and divide
+ *    `duration` by `timescale`.
+ *
+ * Both measured layouts work for the same reason: the walk is driven by the
+ * sizes the boxes declare, so it does not care whether `moov` came before or
+ * after the media data. Faststart files find it on the first or second hop; a
+ * camera/encoder file finds it after one seek over the entire `mdat`.
+ *
+ * @param filePath - absolute path to the file to read.
+ * @returns the clip length in seconds, as an exact ratio.
+ * @throws IsoBmffDurationError (a `HarnessError`) whenever the length cannot be
+ *   established - a missing file, a non-ISO-BMFF file, a truncated box, a
+ *   missing `moov`/`mvhd`, an unreadable `mvhd`, or a zero timescale.
+ */
+export declare function readIsoBmffDurationSeconds(filePath: string): Promise<number>;
+//# sourceMappingURL=iso-bmff-duration.d.ts.map

package/lib/types/host/minimax-code/iso-bmff-duration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iso-bmff-duration.d.ts","sourceRoot":"","sources":["../../../../src/host/minimax-code/iso-bmff-duration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEnD;;;;;GAKG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;gBACxC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAI1C;AAyOD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkFlF"}

package/lib/types/host/minimax-code/matrix-client.d.ts

@@ -0,0 +1,168 @@
+/**
+ * The Matrix media gateway client for the MiniMax Code subscription.
+ *
+ * The Messages route (`{agentBase}/mavis/api/v1/llm/v1/messages`) carries the
+ * chat surface only. Everything else the subscription can do — video generation,
+ * video understanding, image and audio tools — lives behind a SECOND prefix on
+ * the SAME origin: `{agentBase}/mavis/api/v1/mcp/<tool>`. Nothing in
+ * ./client.ts reaches it, and this module is that missing half.
+ *
+ * Why the endpoint set is what it is (docs/minimax-video-design-spec.md section
+ * 3, and the live probe in scripts/probe-minimax-matrix-gateway.probe.ts):
+ *
+ * - the host is the AGENT host, not the API host. cn is `https://agent.minimax.cn`
+ *   and global is `https://agent.minimax.io`, both already named by
+ *   ./types.ts's REGION_HOSTS. `agent.minimaxi.com` is the CHECK-IN surface's
+ *   host — the upstream tree spells it LEGACY (matrix-env.ts:28) — and pointing
+ *   a media call at it would miss.
+ * - authentication is the subscription bearer and nothing else. The measured
+ *   request carried exactly accept / authorization / content-type / user-agent
+ *   and was answered HTTP 200 `base_resp.status_code: 0`. The `yy` /
+ *   `x-timestamp` / `x-signature` triple belongs to the check-in surface, and
+ *   `user_id` / `biz_id` / `request_sk` are gated on a non-prod build env and
+ *   resolve to {} in prod, so none of them is sent here either.
+ *
+ * TWO FAILURE KINDS, and they are not the same verdict:
+ *
+ * - a BUSINESS failure is HTTP 200 with `base_resp.status_code !== 0` OR with a
+ *   non-zero TOP-LEVEL `code`. Both are the service accepting the request,
+ *   understanding it, and refusing it: retrying the same body asks the same
+ *   question again and gets the same answer, so it is terminal. Upstream proves
+ *   the same pair (packages/agent-tools/src/cloud/matrix-tools/client.ts:140-158)
+ *   and a client that only reads the first one reports a refusal as a success.
+ * - a REQUEST failure is a non-2xx status. Which one it is (a refused
+ *   credential, back-pressure, an overloaded gateway, a malformed body) is
+ *   decided by {@link classifyMinimaxFailure}, which this line already uses for
+ *   every other refusal it reports.
+ *
+ * The classification SHAPE is reused rather than reinvented: `code`,
+ * `message`, `retryable`, `accountScoped`. A caller that reads a verdict from
+ * the Messages route and a caller that reads one from here must not have to
+ * know which surface produced it.
+ *
+ * @module dsh-chatgpt-subscription/minimax-code/matrix-client
+ */
+import { HarnessError } from '@deepseek-ai/dsh-llm';
+import type { MinimaxCodeRegion } from '../../shared/minimax-code-contracts.ts';
+import { type MinimaxFailureClassification } from './adapter.ts';
+/** Prefix every Matrix media tool hangs off. */
+export declare const MATRIX_API_PREFIX = "/mavis/api/v1/mcp";
+/**
+ * User agent the gateway was measured to accept.
+ *
+ * NOT the package's own product token (./types.ts USER_AGENT). A media call is
+ * a first-party-client surface rather than an LLM endpoint, and the measured
+ * shape sent this literal; the note in ./types.ts about not impersonating the
+ * official app is about the TELEMETRY headers (`yy` and friends), which are
+ * still never sent.
+ */
+export declare const MATRIX_USER_AGENT = "MiniMaxAgent";
+/** Default per-call time budget, matching the upstream media-tool timeout table. */
+export declare const MATRIX_DEFAULT_TIMEOUT_MS = 120000;
+/** Path segment of the video-understanding tool. */
+export declare const MATRIX_TOOL_VIDEOS_UNDERSTAND = "videos_understand";
+/** Path segment of the async video-generation submit tool. */
+export declare const MATRIX_TOOL_SUBMIT_VIDEO = "submit_video_generation";
+/** Path segment of the async video-generation query tool. */
+export declare const MATRIX_TOOL_QUERY_VIDEO = "query_video_generation";
+/** Path segment of the presigned-upload broker. */
+export declare const MATRIX_TOOL_GET_UPLOAD_URL = "get_upload_url";
+type FetchLike = typeof fetch;
+/**
+ * The Matrix media route for one region and tool.
+ *
+ * @param region - subscription region (`cn` or `global`).
+ * @param tool - tool path segment, e.g. `videos_understand`.
+ * @returns the absolute endpoint URL.
+ */
+export declare function matrixToolUrl(region: MinimaxCodeRegion, tool: string): string;
+/**
+ * The complete header set of one Matrix request: exactly four entries.
+ *
+ * Kept as a function of the token alone so a test can assert the absence of the
+ * check-in surface's signature headers and the routing headers by name, rather
+ * than trusting that nobody added one later.
+ *
+ * @param accessToken - subscription access token.
+ * @returns the four headers, in the measured spelling.
+ */
+export declare function matrixRequestHeaders(accessToken: string): Record<string, string>;
+/**
+ * One settled Matrix call.
+ *
+ * `body` is the parsed JSON envelope with `base_resp` still on it, so a caller
+ * can read `status_msg` when it needs the service's own wording. Payload fields
+ * sit at the TOP level of that envelope on every tool this line has read.
+ *
+ * The one top-level key that is NOT a payload field is `code`: it is the
+ * envelope's second status code, already proven zero by the time a response is
+ * returned (see {@link businessStatusOf}).
+ */
+export interface MatrixToolResponse {
+    /** The tool the call named. */
+    readonly tool: string;
+    /** HTTP status of the answer. */
+    readonly status: number;
+    /** Parsed JSON object body. */
+    readonly body: Record<string, unknown>;
+}
+/** One Matrix failure, carrying the verdict the rest of the line speaks. */
+export declare class MatrixToolError extends HarnessError {
+    /** The reused classification: `code`/`message`/`retryable`/`accountScoped`. */
+    readonly classification: MinimaxFailureClassification;
+    /** HTTP status when there was one; undefined for a transport failure. */
+    readonly status: number | undefined;
+    /** The tool the failing call named. */
+    readonly tool: string;
+    constructor(message: string, code: string, classification: MinimaxFailureClassification, tool: string, status?: number);
+}
+/** Error code for a business refusal (HTTP 200, `base_resp.status_code !== 0`). */
+export declare const MATRIX_BUSINESS_ERROR_CODE = "MINIMAX_MATRIX_BUSINESS_ERROR";
+/** Error code for a non-2xx answer. */
+export declare const MATRIX_HTTP_ERROR_CODE = "MINIMAX_MATRIX_HTTP_ERROR";
+/** Error code for a request that never produced a response. */
+export declare const MATRIX_TRANSPORT_ERROR_CODE = "MINIMAX_MATRIX_TRANSPORT_ERROR";
+/** Error code for a call that outlived its budget. */
+export declare const MATRIX_TIMEOUT_ERROR_CODE = "MINIMAX_MATRIX_TIMEOUT";
+/** Options for {@link callMatrixTool}. */
+export interface CallMatrixToolOptions {
+    /** Subscription region; decides which agent host is used. */
+    readonly region: MinimaxCodeRegion;
+    /** Subscription access token (bearer). */
+    readonly accessToken: string;
+    /** Tool path segment, e.g. `videos_understand`. */
+    readonly tool: string;
+    /** JSON request body. */
+    readonly body: Record<string, unknown>;
+    /** Injected fetch, so tests never touch the network. */
+    readonly fetchFn?: FetchLike;
+    /** Caller cancellation. */
+    readonly signal?: AbortSignal;
+    /** Per-call budget; defaults to {@link MATRIX_DEFAULT_TIMEOUT_MS}. */
+    readonly timeoutMs?: number;
+}
+/**
+ * Call one Matrix media tool and return its parsed envelope.
+ *
+ * @param options - region, credential, tool, body and the injectable transport.
+ * @returns the parsed envelope, with the business status already proven zero.
+ * @throws MatrixToolError for a business refusal, a non-2xx answer, a transport
+ *   failure, or a timeout. Every one carries a reused classification.
+ */
+export declare function callMatrixTool(options: CallMatrixToolOptions): Promise<MatrixToolResponse>;
+/**
+ * Read one payload field out of an envelope, trying the shapes this gateway
+ * has been observed to use.
+ *
+ * Top level first — that is where every measured tool puts its payload — then
+ * `data` and `result` for a tool that nests it. Undefined when none of them
+ * carries the key, so the caller refuses rather than reading a missing field as
+ * an empty string.
+ *
+ * @param body - the parsed envelope.
+ * @param key - the field name the tool documents.
+ * @returns the value, whatever it is, or undefined.
+ */
+export declare function matrixPayloadField(body: Record<string, unknown>, key: string): unknown;
+export {};
+//# sourceMappingURL=matrix-client.d.ts.map

package/lib/types/host/minimax-code/matrix-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matrix-client.d.ts","sourceRoot":"","sources":["../../../../src/host/minimax-code/matrix-client.ts"],"names":[],"mappings":"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"}

package/lib/types/host/minimax-code/media-store.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Where a generated video is written, and how the path it gets is derived.
+ *
+ * WHY THE SESSION WORKSPACE AND NOT A PRIVATE DIRECTORY. The sidebar's video
+ * preview is a DOCUMENT preview: it renders a file the workspace can address,
+ * because that is what the preview registry is keyed on. A clip parked in
+ * `$DSH_HOME/storages/...` — which is where the Kimi line's attachment store
+ * lives — is invisible to that surface: the tool would report success and the
+ * user would have no player to open it in. So the bytes land in the session's
+ * own working directory, and this module's whole job is to do that without
+ * letting a caller name a path.
+ *
+ * HOW THE ROOT IS RESOLVED (the answer to "what can a tool actually see here"):
+ *
+ * 1. `ctx.get('workingDirectory')` then `ensure(agent, signal)` — the same call
+ *    the harness itself makes. `packages/core/tools/src/index.ts:949-956` uses
+ *    it to capture `run_code`'s cwd, and `packages/deliverables/tool-present/
+ *    src/index.ts:82` uses it to resolve the directory `present` addresses.
+ *    It is the CURRENT directory, which is what a user means by "the
+ *    workspace" after they change it mid-session.
+ * 2. `agent.session.header.cwd` — `packages/core/session/src/types.ts:106`
+ *    documents it as "Absolute working directory the session was created in".
+ *    This is the fallback when the working-directory service is not composed
+ *    (a headless host), and it is a plain field, so reading it cannot fail.
+ * 3. Neither: the call FAILS. There is deliberately no third fallback to a
+ *    plugin-owned directory, because the product contract is that the file is
+ *    reachable from the workspace; silently writing somewhere else would report
+ *    a success the user cannot open. The error names both remedies.
+ *
+ * The host's own workspace-file scope agrees with the same decision:
+ * `packages/api/workspace-files/src/index.ts:218` resolves a session's root as
+ * `header.cwd ?? scope.sandboxPolicy.workspaceRoot`, i.e. the header first.
+ *
+ * @module dsh-chatgpt-subscription/minimax-code/media-store
+ */
+import { HarnessError } from '@deepseek-ai/dsh-llm';
+/**
+ * Largest single generated video this route will write.
+ *
+ * A 15-second 2K H3 clip is a few tens of megabytes, so 200 MB is not a
+ * prediction of the output size — it is the ceiling that stops a runaway
+ * download (a wrong URL that streams an ISO, a redirect to something huge) from
+ * filling the user's disk. Nothing legitimate comes near it.
+ */
+export declare const MAX_GENERATED_VIDEO_BYTES: number;
+/** Directory, under the workspace root, that generated videos land in. */
+export declare const GENERATED_VIDEO_DIR = "minimax-videos";
+/** Raised when a write cannot produce a usable workspace path. */
+export declare class MediaStoreError extends HarnessError {
+    constructor(message: string, code: string);
+}
+/** The one place a generated video may be written, and how to name it. */
+export interface MediaStoreTarget {
+    /** Absolute workspace root. */
+    readonly root: string;
+    /** Absolute directory the file is written into. */
+    readonly directory: string;
+    /**
+     * Whether the root came from the working-directory service (true) or from
+     * the session header (false). Reported so a caller can tell a live directory
+     * from the creation-time one.
+     */
+    readonly fromWorkingDirectory: boolean;
+}
+/**
+ * The least a tool execution must expose for {@link resolveMediaStoreTarget}.
+ *
+ * Structural rather than the registry's own `ToolRunContext` so a test can
+ * hand in a plain object; every field is optional because a tool is also
+ * executed by tooling that composes no agent at all.
+ */
+export interface MediaStoreExec {
+    readonly signal?: AbortSignal;
+    readonly agent?: {
+        readonly session?: {
+            readonly header?: {
+                readonly cwd?: string;
+            };
+        };
+    };
+}
+/** The part of the harness `workingDirectory` service this module reads. */
+export interface WorkingDirectoryLookup {
+    ensure(agent: unknown, signal?: AbortSignal): Promise<string>;
+}
+/**
+ * The session's current working directory, or undefined when nothing can name
+ * one.
+ *
+ * @param ctx - anything with a `get` that returns the harness services.
+ * @param exec - the tool execution naming the agent and its cancellation.
+ * @returns an absolute directory, or undefined.
+ */
+export declare function resolveSessionRoot(ctx: {
+    get(name: string): unknown;
+}, exec: MediaStoreExec): Promise<{
+    root: string;
+    fromWorkingDirectory: boolean;
+} | undefined>;
+/**
+ * Resolve where a generated video will be written for one execution.
+ *
+ * @param ctx - host context, for the working-directory service.
+ * @param exec - the tool execution.
+ * @returns the resolved target.
+ * @throws MediaStoreError when no workspace directory can be named at all.
+ */
+export declare function resolveMediaStoreTarget(ctx: {
+    get(name: string): unknown;
+}, exec: MediaStoreExec): Promise<MediaStoreTarget>;
+/**
+ * A filesystem-safe file name derived from values this module controls.
+ *
+ * Every part is generated here — a timestamp, the task id the service issued and
+ * a fixed extension — and everything outside `[A-Za-z0-9._-]` is replaced, so a
+ * task id carrying a separator cannot climb out of the directory. The caller
+ * never supplies a path, which is what makes path traversal impossible rather
+ * than merely filtered.
+ *
+ * @param taskId - upstream task id (or an equivalent generated identity).
+ * @param extension - leading-dot extension, e.g. `.mp4`.
+ * @param now - clock, injected so a test can pin the name.
+ * @returns a leaf file name with no directory component.
+ */
+export declare function generatedVideoFileName(taskId: string, extension: string, now?: number): string;
+/** A file extension for one media type, defaulting to .mp4. */
+export declare function extensionForMediaType(mediaType: string): string;
+/** Result of one committed write. */
+export interface StoredVideo {
+    /** Path relative to the workspace root, always POSIX-separated. */
+    readonly relativePath: string;
+    /** Absolute path on this machine. */
+    readonly absolutePath: string;
+    /** Exact byte length written. */
+    readonly bytes: number;
+}
+/**
+ * Write one generated video into the workspace.
+ *
+ * @param target - the resolved target from {@link resolveMediaStoreTarget}.
+ * @param data - the complete video bytes.
+ * @param taskId - upstream task id, used to derive the file name.
+ * @param mediaType - media type the response declared, for the extension.
+ * @param now - clock, injected for a pinned test name.
+ * @returns the workspace-relative path and its absolute counterpart.
+ * @throws MediaStoreError for an empty or oversized payload.
+ */
+export declare function writeGeneratedVideo(target: MediaStoreTarget, data: Uint8Array, options: {
+    taskId: string;
+    mediaType: string;
+    now?: number;
+}): Promise<StoredVideo>;
+//# sourceMappingURL=media-store.d.ts.map