@dyrra/sdk 0.1.1

package/README.md

@@ -0,0 +1,20 @@
+# @dyrra/sdk
+
+Типизированный клиент Dyrra — единый API к Mac для ИИ-агентов.
+
+```bash
+npm install @dyrra/sdk
+```
+
+```ts
+import { Dyrra } from "@dyrra/sdk";
+
+const dyrra = new Dyrra(process.env.DYRRA_API_KEY!);
+const mac = dyrra.targets("con_…");
+
+const tree = await mac.uiTree({ format: "compact" });
+await mac.actions([{ type: "click_element", snapshotId: tree.snapshotId, elementId: "e12" }]);
+```
+
+По умолчанию клиент обращается к `https://api.dyrra.dev`; другой адрес
+задаётся параметром `baseUrl`.

package/dist/computerUse.d.ts

@@ -0,0 +1,48 @@
+import type { Action } from "@dyrra/protocol";
+/**
+ * Переводчики действий computer-use в действия Dyrra.
+ *
+ * Названия сверены с официальной документацией 11.09.2026 (ТЗ 9.2, 22.10),
+ * а не написаны по памяти:
+ *  - Anthropic: платформенный тулсет `computer_toolset_20260801`, где действие —
+ *    это ИМЯ инструмента (left_click, key, …), а не поле `action`;
+ *  - OpenAI: `action.type` (click, double_click, drag, keypress, move, scroll,
+ *    type, wait, screenshot).
+ *
+ * ВАЖНО о координатах: обе модели работают в пикселях скриншота, а Dyrra —
+ * в логических точках экрана (ТЗ 7.6). Если скриншот запрашивался с maxWidth,
+ * передайте `scale` из ответа: координаты будут поделены на него.
+ */
+export interface AdapterOptions {
+    /** `scale` из ответа screenshot: imageWidth / widthPoints. */
+    scale?: number;
+}
+export interface AnthropicToolUse {
+    /** Имя инструмента внутри тулсета: left_click, type, key, … */
+    name: string;
+    input: Record<string, unknown>;
+}
+/**
+ * Одно действие Anthropic → ноль или одно действие Dyrra.
+ * `screenshot`, `zoom` и `cursor_position` возвращают null: это запросы
+ * состояния, для них есть отдельные вызовы API.
+ */
+export declare function fromAnthropicAction(toolUse: AnthropicToolUse, options?: AdapterOptions): Action | null;
+export declare function fromAnthropicActions(toolUses: AnthropicToolUse[], options?: AdapterOptions): Action[];
+export interface OpenAIComputerAction {
+    type: string;
+    x?: number;
+    y?: number;
+    button?: string;
+    path?: {
+        x: number;
+        y: number;
+    }[];
+    keys?: string[];
+    scroll_x?: number;
+    scroll_y?: number;
+    text?: string;
+}
+export declare function fromOpenAIAction(action: OpenAIComputerAction, options?: AdapterOptions): Action | null;
+export declare function fromOpenAIActions(actions: OpenAIComputerAction[], options?: AdapterOptions): Action[];
+//# sourceMappingURL=computerUse.d.ts.map

package/dist/computerUse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computerUse.d.ts","sourceRoot":"","sources":["../src/computerUse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAY,MAAM,iBAAiB,CAAC;AAExD;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAQD,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AA8CD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,cAAmB,GAC3B,MAAM,GAAG,IAAI,CAsEf;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,OAAO,GAAE,cAAmB,GAC3B,MAAM,EAAE,CAIV;AAID,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAqBD,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE,cAAmB,GAC3B,MAAM,GAAG,IAAI,CAwDf;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,oBAAoB,EAAE,EAC/B,OAAO,GAAE,cAAmB,GAC3B,MAAM,EAAE,CAIV"}

package/dist/computerUse.js

@@ -0,0 +1,189 @@
+function toPoints(value, scale) {
+    return scale === 1 ? value : value / scale;
+}
+const ANTHROPIC_MODIFIERS = {
+    super: "cmd",
+    cmd: "cmd",
+    ctrl: "ctrl",
+    control: "ctrl",
+    shift: "shift",
+    alt: "alt",
+    option: "alt",
+};
+/** Имена клавиш в стиле X11 → наши имена (ТЗ 8.4). */
+const ANTHROPIC_KEYS = {
+    Return: "return",
+    Enter: "return",
+    Tab: "tab",
+    space: "space",
+    BackSpace: "delete",
+    Delete: "forwarddelete",
+    Escape: "escape",
+    Up: "up",
+    Down: "down",
+    Left: "left",
+    Right: "right",
+    Home: "home",
+    End: "end",
+    Page_Up: "pageup",
+    Page_Down: "pagedown",
+};
+function anthropicKeys(text) {
+    return text.split("+").map((part) => {
+        const trimmed = part.trim();
+        return ANTHROPIC_MODIFIERS[trimmed.toLowerCase()] ?? ANTHROPIC_KEYS[trimmed] ?? trimmed.toLowerCase();
+    });
+}
+function anthropicModifiers(text) {
+    if (typeof text !== "string" || !text)
+        return [];
+    return text
+        .split("+")
+        .map((part) => ANTHROPIC_MODIFIERS[part.trim().toLowerCase()])
+        .filter((value) => Boolean(value));
+}
+/**
+ * Одно действие Anthropic → ноль или одно действие Dyrra.
+ * `screenshot`, `zoom` и `cursor_position` возвращают null: это запросы
+ * состояния, для них есть отдельные вызовы API.
+ */
+export function fromAnthropicAction(toolUse, options = {}) {
+    const scale = options.scale ?? 1;
+    const input = toolUse.input;
+    const coordinate = input["coordinate"];
+    const start = input["start_coordinate"];
+    const modifiers = anthropicModifiers(input["text"]);
+    const point = (pair) => pair ? { x: toPoints(pair[0], scale), y: toPoints(pair[1], scale) } : null;
+    switch (toolUse.name) {
+        case "left_click":
+        case "right_click":
+        case "middle_click":
+        case "double_click":
+        case "triple_click": {
+            const at = point(coordinate);
+            if (!at)
+                return null;
+            const button = toolUse.name === "right_click"
+                ? "right"
+                : toolUse.name === "middle_click"
+                    ? "middle"
+                    : "left";
+            const count = toolUse.name === "double_click" ? 2 : toolUse.name === "triple_click" ? 3 : 1;
+            return { type: "click", x: at.x, y: at.y, button, count, modifiers };
+        }
+        case "mouse_move": {
+            const at = point(coordinate);
+            return at ? { type: "move", x: at.x, y: at.y } : null;
+        }
+        case "left_click_drag": {
+            const from = point(start);
+            const to = point(coordinate);
+            if (!from || !to)
+                return null;
+            return { type: "drag", from, to, button: "left", durationMs: 300 };
+        }
+        case "scroll": {
+            const at = point(coordinate) ?? { x: 0, y: 0 };
+            const amount = Number(input["scroll_amount"] ?? 3) * 40;
+            const direction = String(input["scroll_direction"] ?? "down");
+            const deltas = {
+                up: { dx: 0, dy: amount },
+                down: { dx: 0, dy: -amount },
+                left: { dx: amount, dy: 0 },
+                right: { dx: -amount, dy: 0 },
+            };
+            const delta = deltas[direction] ?? deltas["down"];
+            return { type: "scroll", x: at.x, y: at.y, dx: delta.dx, dy: delta.dy };
+        }
+        case "type":
+            return { type: "type", text: String(input["text"] ?? "") };
+        case "key":
+            return { type: "key", keys: anthropicKeys(String(input["text"] ?? "")) };
+        case "wait":
+        case "hold_key": {
+            const seconds = Number(input["duration"] ?? 1);
+            return { type: "wait", ms: Math.min(5000, Math.round(seconds * 1000)) };
+        }
+        // screenshot, zoom, cursor_position, left_mouse_down/up — отдельные вызовы API.
+        default:
+            return null;
+    }
+}
+export function fromAnthropicActions(toolUses, options = {}) {
+    return toolUses
+        .map((toolUse) => fromAnthropicAction(toolUse, options))
+        .filter((action) => action !== null);
+}
+const OPENAI_KEYS = {
+    ENTER: "return",
+    RETURN: "return",
+    TAB: "tab",
+    SPACE: "space",
+    BACKSPACE: "delete",
+    ESC: "escape",
+    ESCAPE: "escape",
+    CMD: "cmd",
+    COMMAND: "cmd",
+    CTRL: "ctrl",
+    ALT: "alt",
+    SHIFT: "shift",
+    ARROWUP: "up",
+    ARROWDOWN: "down",
+    ARROWLEFT: "left",
+    ARROWRIGHT: "right",
+};
+export function fromOpenAIAction(action, options = {}) {
+    const scale = options.scale ?? 1;
+    const x = toPoints(action.x ?? 0, scale);
+    const y = toPoints(action.y ?? 0, scale);
+    switch (action.type) {
+        case "click": {
+            const button = action.button === "right" ? "right" : action.button === "middle" ? "middle" : "left";
+            return { type: "click", x, y, button, count: 1, modifiers: [] };
+        }
+        case "double_click":
+            return { type: "click", x, y, button: "left", count: 2, modifiers: [] };
+        case "move":
+            return { type: "move", x, y };
+        case "drag": {
+            const path = action.path ?? [];
+            const first = path[0];
+            const last = path[path.length - 1];
+            if (!first || !last)
+                return null;
+            return {
+                type: "drag",
+                from: { x: toPoints(first.x, scale), y: toPoints(first.y, scale) },
+                to: { x: toPoints(last.x, scale), y: toPoints(last.y, scale) },
+                button: "left",
+                durationMs: 300,
+            };
+        }
+        case "scroll":
+            return {
+                type: "scroll",
+                x,
+                y,
+                // У OpenAI положительный scroll_y — вниз, у macOS наоборот.
+                dx: -(action.scroll_x ?? 0),
+                dy: -(action.scroll_y ?? 0),
+            };
+        case "type":
+            return { type: "type", text: action.text ?? "" };
+        case "keypress":
+            return {
+                type: "key",
+                keys: (action.keys ?? []).map((key) => OPENAI_KEYS[key.toUpperCase()] ?? key.toLowerCase()),
+            };
+        case "wait":
+            return { type: "wait", ms: 1000 };
+        default:
+            return null;
+    }
+}
+export function fromOpenAIActions(actions, options = {}) {
+    return actions
+        .map((action) => fromOpenAIAction(action, options))
+        .filter((action) => action !== null);
+}
+//# sourceMappingURL=computerUse.js.map

package/dist/computerUse.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,125 @@
+import type { Action, CloudMac, Connection, CreateCloudMacRequest, CreateEndUserRequest, CreateLinkSessionRequest, EndUser, ErrorCode, LinkSession, QueuedCommand, Screenshot, ScreenshotRequest, ShellRequest, ShellResult, UiTree, UiTreeRequest, WebhookEvent } from "@dyrra/protocol";
+export * from "./computerUse.js";
+export interface DyrraOptions {
+    baseUrl?: string;
+    fetch?: typeof fetch;
+    /** Сколько раз повторять при machine_offline (ТЗ 9.2). */
+    maxRetries?: number;
+}
+/** Ошибка API в типизированном виде. */
+export declare class DyrraApiError extends Error {
+    readonly code: ErrorCode | string;
+    readonly status: number;
+    readonly requestId: string | undefined;
+    readonly details?: Record<string, unknown> | undefined;
+    constructor(code: ErrorCode | string, message: string, status: number, requestId: string | undefined, details?: Record<string, unknown> | undefined);
+}
+export declare class Dyrra {
+    #private;
+    constructor(apiKey: string, options?: DyrraOptions);
+    readonly endUsers: {
+        create: (body: CreateEndUserRequest) => Promise<EndUser>;
+        get: (id: string) => Promise<EndUser>;
+    };
+    readonly linkSessions: {
+        create: (body: CreateLinkSessionRequest) => Promise<LinkSession>;
+    };
+    readonly connections: {
+        list: (params?: {
+            endUserId?: string;
+        }) => Promise<{
+            data: Connection[];
+        }>;
+        get: (connectionId: string) => Promise<Connection>;
+        revoke: (connectionId: string) => Promise<{
+            ok: true;
+        }>;
+    };
+    readonly cloudMacs: {
+        /**
+         * Облачные Mac сдаются только для разработки и тестирования ПО:
+         * это условие раздела 3 лицензии macOS (ТЗ 3.2).
+         */
+        create: (body: CreateCloudMacRequest) => Promise<CloudMac>;
+        list: () => Promise<{
+            data: CloudMac[];
+        }>;
+        get: (id: string) => Promise<CloudMac>;
+        extend: (id: string, term: "day" | "week" | "month") => Promise<CloudMac>;
+        end: (id: string) => Promise<CloudMac>;
+    };
+    readonly commands: {
+        get: (commandId: string) => Promise<QueuedCommand>;
+        cancel: (commandId: string) => Promise<QueuedCommand>;
+    };
+    /**
+     * Управление конкретным Mac. `target` — connectionId (личный Mac)
+     * или cloudMacId (облачный): API одинаковый (ТЗ 8.4).
+     */
+    targets(target: string): {
+        screenshot: (body?: Partial<ScreenshotRequest>) => Promise<Screenshot>;
+        actions: (actions: Action[], options?: {
+            screenshotAfter?: Partial<ScreenshotRequest>;
+            whenUnavailable?: "fail" | "queue";
+            ttlSeconds?: number;
+            /**
+             * Приложение, в котором должна идти серия. Если активно другое,
+             * Mac остановит серию с app_not_frontmost — ввод не уйдёт в чужое окно.
+             */
+            expectBundleId?: string;
+        }) => Promise<{
+            ok: boolean;
+            screenshot: Screenshot | null;
+        } | QueuedCommand>;
+        uiTree: (body?: Partial<UiTreeRequest>) => Promise<UiTree>;
+        cursor: () => Promise<{
+            x: number;
+            y: number;
+        }>;
+        shell: (body: ShellRequest) => Promise<ShellResult | QueuedCommand>;
+        /** Завершается, когда приложение стало активным; возвращает его bundle id. */
+        openApp: (body: {
+            bundleId?: string;
+            name?: string;
+        }) => Promise<{
+            ok: true;
+            bundleId?: string;
+            name?: string;
+        }>;
+        activateApp: (bundleId: string) => Promise<{
+            ok: true;
+            bundleId?: string;
+            name?: string;
+        }>;
+        apps: () => Promise<{
+            data: unknown[];
+        }>;
+        windows: () => Promise<{
+            data: unknown[];
+        }>;
+        openUrl: (url: string) => Promise<{
+            ok: true;
+        }>;
+        getClipboard: () => Promise<{
+            text: string;
+        }>;
+        setClipboard: (text: string) => Promise<{
+            ok: true;
+        }>;
+        readFile: (path: string) => Promise<{
+            mime: string;
+            data: string;
+        }>;
+        writeFile: (path: string, data: string, sha256: string) => Promise<{
+            ok: true;
+        }>;
+    };
+    readonly webhooks: {
+        /** Проверка подписи Dyrra-Signature (ТЗ 8.6). */
+        verify(signatureHeader: string, body: string, secret: string, toleranceSec?: number): boolean;
+        parse(body: string): WebhookEvent;
+    };
+    private request;
+    private retryDelay;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,154 @@
+import { createHmac, timingSafeEqual } from "node:crypto";
+import { DEFAULT_API_BASE_URL } from "@dyrra/protocol";
+export * from "./computerUse.js";
+/** Ошибка API в типизированном виде. */
+export class DyrraApiError extends Error {
+    code;
+    status;
+    requestId;
+    details;
+    constructor(code, message, status, requestId, details) {
+        super(message);
+        this.code = code;
+        this.status = status;
+        this.requestId = requestId;
+        this.details = details;
+        this.name = "DyrraApiError";
+    }
+}
+const RETRY_ON_OFFLINE_MS = [1000, 3000, 8000];
+export class Dyrra {
+    #apiKey;
+    #baseUrl;
+    #fetch;
+    #maxRetries;
+    constructor(apiKey, options = {}) {
+        if (!apiKey)
+            throw new Error("Нужен ключ платформы (dk_live_… или dk_test_…)");
+        this.#apiKey = apiKey;
+        this.#baseUrl = (options.baseUrl ?? DEFAULT_API_BASE_URL).replace(/\/$/, "");
+        this.#fetch = options.fetch ?? globalThis.fetch;
+        this.#maxRetries = options.maxRetries ?? RETRY_ON_OFFLINE_MS.length;
+    }
+    /* ── Пользователи платформы ─────────────────────────────────────────── */
+    endUsers = {
+        create: (body) => this.request("POST", "/v1/end-users", body),
+        get: (id) => this.request("GET", `/v1/end-users/${id}`),
+    };
+    /* ── Сессии подключения ─────────────────────────────────────────────── */
+    linkSessions = {
+        create: (body) => this.request("POST", "/v1/link-sessions", body),
+    };
+    /* ── Подключения ────────────────────────────────────────────────────── */
+    connections = {
+        list: (params = {}) => {
+            const query = params.endUserId ? `?endUserId=${encodeURIComponent(params.endUserId)}` : "";
+            return this.request("GET", `/v1/connections${query}`);
+        },
+        get: (connectionId) => this.request("GET", `/v1/connections/${connectionId}`),
+        revoke: (connectionId) => this.request("DELETE", `/v1/connections/${connectionId}`),
+    };
+    /* ── Облачные Mac ───────────────────────────────────────────────────── */
+    cloudMacs = {
+        /**
+         * Облачные Mac сдаются только для разработки и тестирования ПО:
+         * это условие раздела 3 лицензии macOS (ТЗ 3.2).
+         */
+        create: (body) => this.request("POST", "/v1/cloud-macs", body),
+        list: () => this.request("GET", "/v1/cloud-macs"),
+        get: (id) => this.request("GET", `/v1/cloud-macs/${id}`),
+        extend: (id, term) => this.request("POST", `/v1/cloud-macs/${id}/extend`, { term }),
+        end: (id) => this.request("DELETE", `/v1/cloud-macs/${id}`),
+    };
+    commands = {
+        get: (commandId) => this.request("GET", `/v1/commands/${commandId}`),
+        cancel: (commandId) => this.request("DELETE", `/v1/commands/${commandId}`),
+    };
+    /**
+     * Управление конкретным Mac. `target` — connectionId (личный Mac)
+     * или cloudMacId (облачный): API одинаковый (ТЗ 8.4).
+     */
+    targets(target) {
+        const base = `/v1/targets/${encodeURIComponent(target)}`;
+        return {
+            screenshot: (body = {}) => this.request("POST", `${base}/screenshot`, body),
+            actions: (actions, options = {}) => this.request("POST", `${base}/actions`, { actions, ...options }),
+            uiTree: (body = {}) => this.request("POST", `${base}/ui-tree`, body),
+            cursor: () => this.request("GET", `${base}/cursor`),
+            shell: (body) => this.request("POST", `${base}/shell`, body),
+            /** Завершается, когда приложение стало активным; возвращает его bundle id. */
+            openApp: (body) => this.request("POST", `${base}/apps/open`, body),
+            activateApp: (bundleId) => this.request("POST", `${base}/apps/activate`, { bundleId }),
+            apps: () => this.request("GET", `${base}/apps`),
+            windows: () => this.request("GET", `${base}/windows`),
+            openUrl: (url) => this.request("POST", `${base}/urls/open`, { url }),
+            getClipboard: () => this.request("GET", `${base}/clipboard`),
+            setClipboard: (text) => this.request("PUT", `${base}/clipboard`, { text }),
+            readFile: (path) => this.request("GET", `${base}/files?path=${encodeURIComponent(path)}`),
+            writeFile: (path, data, sha256) => this.request("PUT", `${base}/files?path=${encodeURIComponent(path)}`, { data, sha256 }),
+        };
+    }
+    /* ── Webhooks ───────────────────────────────────────────────────────── */
+    webhooks = {
+        /** Проверка подписи Dyrra-Signature (ТЗ 8.6). */
+        verify(signatureHeader, body, secret, toleranceSec = 300) {
+            const parts = Object.fromEntries(signatureHeader.split(",").map((p) => {
+                const [k, v] = p.split("=");
+                return [k?.trim() ?? "", v?.trim() ?? ""];
+            }));
+            const timestamp = Number(parts["t"]);
+            const provided = parts["v1"];
+            if (!Number.isFinite(timestamp) || !provided)
+                return false;
+            if (Math.abs(Date.now() / 1000 - timestamp) > toleranceSec)
+                return false;
+            const expected = createHmac("sha256", secret)
+                .update(`${timestamp}.${body}`)
+                .digest("hex");
+            const a = Buffer.from(provided);
+            const b = Buffer.from(expected);
+            return a.length === b.length && timingSafeEqual(a, b);
+        },
+        parse(body) {
+            return JSON.parse(body);
+        },
+    };
+    /* ── Транспорт ──────────────────────────────────────────────────────── */
+    async request(method, path, body) {
+        let attempt = 0;
+        for (;;) {
+            const response = await this.#fetch(`${this.#baseUrl}${path}`, {
+                method,
+                headers: {
+                    authorization: `Bearer ${this.#apiKey}`,
+                    ...(body === undefined ? {} : { "content-type": "application/json" }),
+                    ...(method === "POST" ? { "idempotency-key": crypto.randomUUID() } : {}),
+                },
+                ...(body === undefined ? {} : { body: JSON.stringify(body) }),
+            });
+            if (response.ok)
+                return (await response.json());
+            const payload = (await response.json().catch(() => null));
+            const code = payload?.error?.code ?? "internal_error";
+            const requestId = response.headers.get("x-request-id") ?? undefined;
+            // Mac мог просто отключиться на секунду — пробуем ещё раз (ТЗ 9.2).
+            const retryDelay = this.retryDelay(code, response, attempt);
+            if (retryDelay !== null && attempt < this.#maxRetries) {
+                await new Promise((resolve) => setTimeout(resolve, retryDelay));
+                attempt += 1;
+                continue;
+            }
+            throw new DyrraApiError(code, payload?.error?.message ?? response.statusText, response.status, requestId, payload?.error?.details);
+        }
+    }
+    retryDelay(code, response, attempt) {
+        if (code === "machine_offline")
+            return RETRY_ON_OFFLINE_MS[attempt] ?? null;
+        if (code === "machine_busy" || code === "rate_limited") {
+            const retryAfter = Number(response.headers.get("retry-after") ?? "1");
+            return Number.isFinite(retryAfter) ? retryAfter * 1000 : 1000;
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@dyrra/sdk",
+  "version": "0.1.1",
+  "description": "Типизированный клиент Dyrra: единый API к Mac для ИИ-агентов",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@dyrra/protocol": "0.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "24.10.1"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ceodaredevil/dyrra.git",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://github.com/ceodaredevil/dyrra",
+  "bugs": {
+    "url": "https://github.com/ceodaredevil/dyrra/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "mac",
+    "macos",
+    "ai-agent",
+    "computer-use",
+    "mcp",
+    "automation"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "oxlint src",
+    "test": "vitest run",
+    "build:types": "tsc -p tsconfig.build.json"
+  }
+}