@motrix/mdxp 0.1.0

package/dist/schemas/url.d.ts

@@ -0,0 +1,162 @@
+import { z } from 'zod';
+export declare const UrlProbeParamsSchema: z.ZodObject<{
+    url: z.ZodString;
+    hint: z.ZodOptional<z.ZodObject<{
+        siteName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const UrlProbeResultSchema: z.ZodObject<{
+    handled: z.ZodBoolean;
+    adapterId: z.ZodOptional<z.ZodString>;
+    confidence: z.ZodOptional<z.ZodEnum<{
+        high: "high";
+        medium: "medium";
+        low: "low";
+    }>>;
+}, z.core.$strip>;
+export declare const UrlResolveParamsSchema: z.ZodObject<{
+    url: z.ZodString;
+    preferences: z.ZodOptional<z.ZodObject<{
+        maxQuality: z.ZodOptional<z.ZodEnum<{
+            "360p": "360p";
+            "720p": "720p";
+            "1080p": "1080p";
+            "1440p": "1440p";
+            "2160p": "2160p";
+            best: "best";
+        }>>;
+        preferContainer: z.ZodOptional<z.ZodEnum<{
+            mp4: "mp4";
+            mkv: "mkv";
+            webm: "webm";
+        }>>;
+        includeAudio: z.ZodOptional<z.ZodBoolean>;
+        includeSubtitles: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const UrlResolveResultSchema: z.ZodObject<{
+    selections: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"direct">;
+        primary: z.ZodObject<{
+            url: z.ZodURL;
+            headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+            cookies: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                value: z.ZodString;
+                domain: z.ZodString;
+                path: z.ZodDefault<z.ZodString>;
+                secure: z.ZodDefault<z.ZodBoolean>;
+                httpOnly: z.ZodDefault<z.ZodBoolean>;
+                sameSite: z.ZodDefault<z.ZodEnum<{
+                    strict: "strict";
+                    lax: "lax";
+                    none: "none";
+                    unspecified: "unspecified";
+                }>>;
+                expiresAt: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            refererPolicy: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>;
+        container: z.ZodOptional<z.ZodString>;
+        quality: z.ZodString;
+        sizeBytes: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"hls">;
+        primary: z.ZodObject<{
+            url: z.ZodURL;
+            headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+            cookies: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                value: z.ZodString;
+                domain: z.ZodString;
+                path: z.ZodDefault<z.ZodString>;
+                secure: z.ZodDefault<z.ZodBoolean>;
+                httpOnly: z.ZodDefault<z.ZodBoolean>;
+                sameSite: z.ZodDefault<z.ZodEnum<{
+                    strict: "strict";
+                    lax: "lax";
+                    none: "none";
+                    unspecified: "unspecified";
+                }>>;
+                expiresAt: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            refererPolicy: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>;
+        container: z.ZodString;
+        quality: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"mux">;
+        video: z.ZodObject<{
+            url: z.ZodURL;
+            headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+            cookies: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                value: z.ZodString;
+                domain: z.ZodString;
+                path: z.ZodDefault<z.ZodString>;
+                secure: z.ZodDefault<z.ZodBoolean>;
+                httpOnly: z.ZodDefault<z.ZodBoolean>;
+                sameSite: z.ZodDefault<z.ZodEnum<{
+                    strict: "strict";
+                    lax: "lax";
+                    none: "none";
+                    unspecified: "unspecified";
+                }>>;
+                expiresAt: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            refererPolicy: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>;
+        audio: z.ZodObject<{
+            url: z.ZodURL;
+            headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+            cookies: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                value: z.ZodString;
+                domain: z.ZodString;
+                path: z.ZodDefault<z.ZodString>;
+                secure: z.ZodDefault<z.ZodBoolean>;
+                httpOnly: z.ZodDefault<z.ZodBoolean>;
+                sameSite: z.ZodDefault<z.ZodEnum<{
+                    strict: "strict";
+                    lax: "lax";
+                    none: "none";
+                    unspecified: "unspecified";
+                }>>;
+                expiresAt: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            refererPolicy: z.ZodDefault<z.ZodString>;
+        }, z.core.$strip>;
+        container: z.ZodString;
+        quality: z.ZodString;
+        sizeBytes: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>], "kind">>;
+    meta: z.ZodObject<{
+        title: z.ZodString;
+        author: z.ZodOptional<z.ZodString>;
+        durationSec: z.ZodOptional<z.ZodNumber>;
+        thumbnail: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        publishedAt: z.ZodOptional<z.ZodNumber>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+    subtitles: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        languageCode: z.ZodString;
+        languageName: z.ZodString;
+        url: z.ZodString;
+        format: z.ZodEnum<{
+            vtt: "vtt";
+            srt: "srt";
+            ttml: "ttml";
+        }>;
+    }, z.core.$strip>>>;
+    extractedBy: z.ZodObject<{
+        adapterId: z.ZodString;
+        adapterVersion: z.ZodString;
+        extractedAt: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type UrlProbeParams = z.infer<typeof UrlProbeParamsSchema>;
+export type UrlProbeResult = z.infer<typeof UrlProbeResultSchema>;
+export type UrlResolveParams = z.infer<typeof UrlResolveParamsSchema>;
+export type UrlResolveResult = z.infer<typeof UrlResolveResultSchema>;
+//# sourceMappingURL=url.d.ts.map

package/dist/schemas/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/schemas/url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAKvB,eAAO,MAAM,oBAAoB;;;;;iBAG/B,CAAA;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;iBAI/B,CAAA;AAqCF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;iBAUjC,CAAA;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiBjC,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AACjE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AACjE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AACrE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA"}

package/dist/schemas/url.js

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+import { ResourceSchema } from './resource.js';
+// url/probe ----------------------------------------------------
+export const UrlProbeParamsSchema = z.object({
+    url: z.string().url(),
+    hint: z.object({ siteName: z.string().optional() }).optional(),
+});
+export const UrlProbeResultSchema = z.object({
+    handled: z.boolean(),
+    adapterId: z.string().optional(),
+    confidence: z.enum(['high', 'medium', 'low']).optional(),
+});
+// url/resolve --------------------------------------------------
+const QualityEnum = z.enum(['360p', '720p', '1080p', '1440p', '2160p', 'best']);
+const ResolvedSelectionSchema = z.discriminatedUnion('kind', [
+    z.object({
+        kind: z.literal('direct'),
+        primary: ResourceSchema,
+        container: z.string().optional(),
+        quality: z.string(),
+        sizeBytes: z.number().nonnegative().optional(),
+    }),
+    z.object({
+        kind: z.literal('hls'),
+        primary: ResourceSchema,
+        container: z.string(),
+        quality: z.string(),
+    }),
+    z.object({
+        kind: z.literal('mux'),
+        video: ResourceSchema,
+        audio: ResourceSchema,
+        container: z.string(),
+        quality: z.string(),
+        sizeBytes: z.number().nonnegative().optional(),
+    }),
+]);
+const SubtitleSchema = z.object({
+    languageCode: z.string(),
+    languageName: z.string(),
+    url: z.string().url(),
+    format: z.enum(['vtt', 'srt', 'ttml']),
+});
+export const UrlResolveParamsSchema = z.object({
+    url: z.string().url(),
+    preferences: z
+        .object({
+        maxQuality: QualityEnum.optional(),
+        preferContainer: z.enum(['mp4', 'mkv', 'webm']).optional(),
+        includeAudio: z.boolean().optional(),
+        includeSubtitles: z.boolean().optional(),
+    })
+        .optional(),
+});
+export const UrlResolveResultSchema = z.object({
+    selections: z.array(ResolvedSelectionSchema),
+    meta: z.object({
+        title: z.string(),
+        author: z.string().optional(),
+        durationSec: z.number().nonnegative().optional(),
+        thumbnail: z.string().url().optional(),
+        description: z.string().optional(),
+        publishedAt: z.number().optional(),
+        tags: z.array(z.string()).optional(),
+    }),
+    subtitles: z.array(SubtitleSchema).optional(),
+    extractedBy: z.object({
+        adapterId: z.string(),
+        adapterVersion: z.string(),
+        extractedAt: z.number(),
+    }),
+});
+//# sourceMappingURL=url.js.map

package/dist/schemas/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../src/schemas/url.ts"],"names":[],"mappings":"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"}

package/dist/tools.d.ts

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import { type Method } from './methods.js';
+export interface MdxpToolDef {
+    readonly method: Method;
+    readonly description: string;
+    readonly paramsSchema: z.ZodType;
+    readonly resultSchema: z.ZodType;
+    /** True for methods a CLI / AI agent calls directly (vs handshake/meta). */
+    readonly agentFacing: boolean;
+}
+/**
+ * Methods the SERVER initiates against the client — not agent-callable, so they
+ * are absent from {@link Tools}. Colocated here so the registry's
+ * "client→server only" invariant has a single source of truth (the drift test
+ * derives the expected Tools key set from this).
+ */
+export declare const SERVER_INITIATED_METHODS: readonly Method[];
+/**
+ * Registry of every client→server request method, keyed by wire method name —
+ * the single source of truth tying method ↔ schema ↔ description together. The
+ * `agentFacing` subset is the tool catalog an AI agent sees (consumed by
+ * `motrix describe` in Spec 8). The server-initiated `url/probe` + `url/resolve`
+ * are intentionally absent (the server calls those on the client).
+ */
+export declare const Tools: Readonly<Record<string, MdxpToolDef>>;
+export interface AgentTool {
+    name: string;
+    description: string;
+    /** JSON Schema (draft 2020-12) emitted by `z.toJSONSchema`. */
+    inputSchema: Record<string, unknown>;
+    outputSchema: Record<string, unknown>;
+}
+/** The agent-facing tool catalog: JSON-Schema-typed tools for LLM consumption. */
+export declare function toAgentToolCatalog(): AgentTool[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,KAAK,MAAM,EAAW,MAAM,cAAc,CAAA;AAmCnD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC,OAAO,CAAA;IAChC,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC,OAAO,CAAA;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;CAC9B;AAED;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EAGrD,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAwFvD,CAAA;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACtC;AAED,kFAAkF;AAClF,wBAAgB,kBAAkB,IAAI,SAAS,EAAE,CAYhD"}

package/dist/tools.js

@@ -0,0 +1,124 @@
+import { z } from 'zod';
+import { Methods } from './methods.js';
+import { DownloadCancelParamsSchema, DownloadCancelResultSchema, DownloadSubmitParamsSchema, DownloadSubmitResultSchema, } from './schemas/download.js';
+import { DownloadAddParamsSchema, DownloadAddResultSchema, } from './schemas/download-add.js';
+import { EngineStatusParamsSchema, EngineStatusResultSchema, } from './schemas/engine.js';
+import { InitializeParamsSchema, InitializeResultSchema, } from './schemas/initialize.js';
+import { StatsGetParamsSchema, StatsResultSchema } from './schemas/stats.js';
+import { SystemPingParamsSchema, SystemPingResultSchema, } from './schemas/system.js';
+import { OkResultSchema, TaskGetParamsSchema, TaskGetResultSchema, TaskListParamsSchema, TaskListResultSchema, TaskPauseParamsSchema, TaskRemoveParamsSchema, TaskResumeParamsSchema, } from './schemas/task.js';
+/**
+ * Methods the SERVER initiates against the client — not agent-callable, so they
+ * are absent from {@link Tools}. Colocated here so the registry's
+ * "client→server only" invariant has a single source of truth (the drift test
+ * derives the expected Tools key set from this).
+ */
+export const SERVER_INITIATED_METHODS = [
+    Methods.UrlProbe,
+    Methods.UrlResolve,
+];
+/**
+ * Registry of every client→server request method, keyed by wire method name —
+ * the single source of truth tying method ↔ schema ↔ description together. The
+ * `agentFacing` subset is the tool catalog an AI agent sees (consumed by
+ * `motrix describe` in Spec 8). The server-initiated `url/probe` + `url/resolve`
+ * are intentionally absent (the server calls those on the client).
+ */
+export const Tools = {
+    [Methods.MotrixInitialize]: {
+        method: Methods.MotrixInitialize,
+        description: 'Handshake: negotiate protocol version, identity, and capabilities.',
+        paramsSchema: InitializeParamsSchema,
+        resultSchema: InitializeResultSchema,
+        agentFacing: false,
+    },
+    [Methods.SystemPing]: {
+        method: Methods.SystemPing,
+        description: 'Liveness probe; echoes sentAt with the server recvAt.',
+        paramsSchema: SystemPingParamsSchema,
+        resultSchema: SystemPingResultSchema,
+        agentFacing: false,
+    },
+    [Methods.DownloadSubmit]: {
+        method: Methods.DownloadSubmit,
+        description: 'Submit a browser-detected download (page-shaped; used by the extension).',
+        paramsSchema: DownloadSubmitParamsSchema,
+        resultSchema: DownloadSubmitResultSchema,
+        agentFacing: false,
+    },
+    [Methods.DownloadCancel]: {
+        method: Methods.DownloadCancel,
+        description: 'Cancel a previously submitted download by task id.',
+        paramsSchema: DownloadCancelParamsSchema,
+        resultSchema: DownloadCancelResultSchema,
+        agentFacing: false,
+    },
+    [Methods.DownloadAdd]: {
+        method: Methods.DownloadAdd,
+        description: 'Add a download by URL(s), magnet, or torrent; returns the created task.',
+        paramsSchema: DownloadAddParamsSchema,
+        resultSchema: DownloadAddResultSchema,
+        agentFacing: true,
+    },
+    [Methods.TaskList]: {
+        method: Methods.TaskList,
+        description: 'List tasks, optionally filtered by status and paginated.',
+        paramsSchema: TaskListParamsSchema,
+        resultSchema: TaskListResultSchema,
+        agentFacing: true,
+    },
+    [Methods.TaskGet]: {
+        method: Methods.TaskGet,
+        description: 'Get a single task by id (null if not found).',
+        paramsSchema: TaskGetParamsSchema,
+        resultSchema: TaskGetResultSchema,
+        agentFacing: true,
+    },
+    [Methods.TaskPause]: {
+        method: Methods.TaskPause,
+        description: 'Pause a task by id.',
+        paramsSchema: TaskPauseParamsSchema,
+        resultSchema: OkResultSchema,
+        agentFacing: true,
+    },
+    [Methods.TaskResume]: {
+        method: Methods.TaskResume,
+        description: 'Resume a paused task by id.',
+        paramsSchema: TaskResumeParamsSchema,
+        resultSchema: OkResultSchema,
+        agentFacing: true,
+    },
+    [Methods.TaskRemove]: {
+        method: Methods.TaskRemove,
+        description: 'Remove a task by id, optionally deleting its files.',
+        paramsSchema: TaskRemoveParamsSchema,
+        resultSchema: OkResultSchema,
+        agentFacing: true,
+    },
+    [Methods.StatsGet]: {
+        method: Methods.StatsGet,
+        description: 'Get aggregate global stats (speeds + task counts).',
+        paramsSchema: StatsGetParamsSchema,
+        resultSchema: StatsResultSchema,
+        agentFacing: true,
+    },
+    [Methods.EngineStatus]: {
+        method: Methods.EngineStatus,
+        description: 'Get the download engine lifecycle state + feature report.',
+        paramsSchema: EngineStatusParamsSchema,
+        resultSchema: EngineStatusResultSchema,
+        agentFacing: true,
+    },
+};
+/** The agent-facing tool catalog: JSON-Schema-typed tools for LLM consumption. */
+export function toAgentToolCatalog() {
+    return Object.values(Tools)
+        .filter((tool) => tool.agentFacing)
+        .map((tool) => ({
+        name: tool.method,
+        description: tool.description,
+        inputSchema: z.toJSONSchema(tool.paramsSchema),
+        outputSchema: z.toJSONSchema(tool.resultSchema),
+    }));
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,12 @@
+export type { DownloadCancelParams, DownloadCancelResult, DownloadSubmitParams, DownloadSubmitResult, } from './schemas/download.js';
+export type { DownloadAddParams, DownloadAddResult, } from './schemas/download-add.js';
+export type { EngineFeatureReport, EngineState, EngineStatusParams, EngineStatusResult, } from './schemas/engine.js';
+export type { CancelRequestParams, PairRevokedParams, TaskCompletedParams, TaskErrorParams, TaskProgressParams, } from './schemas/events.js';
+export type { InitializeParams, InitializeResult, } from './schemas/initialize.js';
+export type { Cookie, Resource, } from './schemas/resource.js';
+export type { Selection } from './schemas/selection.js';
+export type { StatsGetParams, StatsResult, StatsUpdateParams, } from './schemas/stats.js';
+export type { SystemPingParams, SystemPingResult, } from './schemas/system.js';
+export type { MdxpTask, MdxpTaskStatus, MdxpTaskType, OkResult, TaskGetParams, TaskGetResult, TaskListParams, TaskListResult, TaskPauseParams, TaskPauseResult, TaskRemoveParams, TaskRemoveResult, TaskResumeParams, TaskResumeResult, } from './schemas/task.js';
+export type { UrlProbeParams, UrlProbeResult, UrlResolveParams, UrlResolveResult, } from './schemas/url.js';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACV,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,2BAA2B,CAAA;AAClC,YAAY,EACV,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,kBAAkB,GACnB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EACV,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,yBAAyB,CAAA;AAChC,YAAY,EACV,MAAM,EACN,QAAQ,GACT,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AACvD,YAAY,EACV,cAAc,EACd,WAAW,EACX,iBAAiB,GAClB,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EACV,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EACV,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,kBAAkB,CAAA"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@motrix/mdxp",
+  "version": "0.1.0",
+  "description": "Motrix Download eXchange Protocol — JSON-RPC 2.0 wire types and connection helpers",
+  "license": "MIT",
+  "author": "Motrix",
+  "homepage": "https://github.com/motrixapp/mdxp#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/motrixapp/mdxp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/motrixapp/mdxp/issues"
+  },
+  "keywords": [
+    "motrix",
+    "mdxp",
+    "json-rpc",
+    "jsonrpc",
+    "download",
+    "protocol",
+    "websocket",
+    "zod"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js",
+      "default": "./dist/node.js"
+    },
+    "./browser": {
+      "types": "./dist/browser.d.ts",
+      "import": "./dist/browser.js",
+      "default": "./dist/browser.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/__tests__",
+    "README.md"
+  ],
+  "packageManager": "pnpm@11.9.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "biome check .",
+    "format": "biome format --write .",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "vscode-jsonrpc": "^9.0.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.1",
+    "@types/node": "^24.0.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.9"
+  }
+}

package/src/browser.ts

@@ -0,0 +1,14 @@
+// Browser platform entry.
+//
+// vscode-jsonrpc v9 split the runtime abstraction layer (RAL) out of the bare
+// `vscode-jsonrpc` entry: creating/listening on a `MessageConnection` now
+// requires a platform RAL to be installed first. Importing this module installs
+// the browser RAL into the SAME `vscode-jsonrpc` instance that this package's
+// `createMdxpConnection` resolves.
+//
+// A browser host (e.g. the Motrix extension background script) imports
+// `@motrix/mdxp/browser` once at startup. The full public API is re-exported, so
+// `import { createMdxpConnection } from '@motrix/mdxp/browser'` also works.
+import 'vscode-jsonrpc/browser'
+
+export * from './index.js'