@dyrra/protocol 0.1.1

package/dist/screen.d.ts

@@ -0,0 +1,116 @@
+import { z } from "zod";
+export declare const ScreenshotRequest: z.ZodObject<{
+    format: z.ZodDefault<z.ZodEnum<{
+        jpeg: "jpeg";
+        png: "png";
+    }>>;
+    quality: z.ZodDefault<z.ZodNumber>;
+    maxWidth: z.ZodOptional<z.ZodNumber>;
+    response: z.ZodDefault<z.ZodEnum<{
+        base64: "base64";
+        binary: "binary";
+    }>>;
+}, z.core.$strip>;
+export type ScreenshotRequest = z.infer<typeof ScreenshotRequest>;
+export declare const Screenshot: z.ZodObject<{
+    mime: z.ZodString;
+    data: z.ZodString;
+    imageWidth: z.ZodNumber;
+    imageHeight: z.ZodNumber;
+    widthPoints: z.ZodNumber;
+    heightPoints: z.ZodNumber;
+    scale: z.ZodNumber;
+}, z.core.$strip>;
+export type Screenshot = z.infer<typeof Screenshot>;
+export declare const UiTreeScope: z.ZodEnum<{
+    all_windows: "all_windows";
+    frontmost: "frontmost";
+    menu_bar: "menu_bar";
+}>;
+export type UiTreeScope = z.infer<typeof UiTreeScope>;
+export declare const UiTreeRequest: z.ZodObject<{
+    scope: z.ZodDefault<z.ZodEnum<{
+        all_windows: "all_windows";
+        frontmost: "frontmost";
+        menu_bar: "menu_bar";
+    }>>;
+    interactiveOnly: z.ZodDefault<z.ZodBoolean>;
+    format: z.ZodDefault<z.ZodEnum<{
+        compact: "compact";
+        json: "json";
+    }>>;
+}, z.core.$strip>;
+export type UiTreeRequest = z.infer<typeof UiTreeRequest>;
+export declare const UiFrame: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    w: z.ZodNumber;
+    h: z.ZodNumber;
+}, z.core.$strip>;
+export declare const UiElement: z.ZodObject<{
+    id: z.ZodString;
+    role: z.ZodString;
+    subrole: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    value: z.ZodOptional<z.ZodString>;
+    identifier: z.ZodOptional<z.ZodString>;
+    frame: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+    }, z.core.$strip>;
+    enabled: z.ZodBoolean;
+    focused: z.ZodBoolean;
+    actions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type UiElement = z.infer<typeof UiElement>;
+/**
+ * Именованный тип обязателен: безымянный вложенный объект quicktype называет
+ * `App`, а это имя перекрывает протокол SwiftUI App в приложении.
+ */
+export declare const UiTreeApp: z.ZodObject<{
+    bundleId: z.ZodString;
+    name: z.ZodString;
+}, z.core.$strip>;
+export type UiTreeApp = z.infer<typeof UiTreeApp>;
+export declare const UiTree: z.ZodObject<{
+    snapshotId: z.ZodString;
+    app: z.ZodNullable<z.ZodObject<{
+        bundleId: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+    elements: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        role: z.ZodString;
+        subrole: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        value: z.ZodOptional<z.ZodString>;
+        identifier: z.ZodOptional<z.ZodString>;
+        frame: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            w: z.ZodNumber;
+            h: z.ZodNumber;
+        }, z.core.$strip>;
+        enabled: z.ZodBoolean;
+        focused: z.ZodBoolean;
+        actions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    compact: z.ZodOptional<z.ZodString>;
+    truncated: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type UiTree = z.infer<typeof UiTree>;
+/** Пределы обхода дерева (ТЗ 7.12), чтобы не вешать сложные окна. */
+export declare const UI_TREE_LIMITS: {
+    readonly maxDepth: 25;
+    readonly maxElements: 1500;
+    readonly totalTimeoutMs: 2000;
+    readonly perRequestTimeoutSec: 0.25;
+    readonly snapshotTtlSec: 30;
+};
+/** Роли, считающиеся интерактивными при interactiveOnly=true. */
+export declare const INTERACTIVE_ROLES: readonly ["AXButton", "AXTextField", "AXTextArea", "AXSecureTextField", "AXLink", "AXCheckBox", "AXRadioButton", "AXPopUpButton", "AXMenuItem", "AXMenuButton", "AXComboBox", "AXSlider", "AXTab", "AXDisclosureTriangle", "AXSegmentedControl"];
+//# sourceMappingURL=screen.d.ts.map

package/dist/screen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../src/screen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;iBAOM,CAAC;AACrC,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,UAAU;;;;;;;;iBAWM,CAAC;AAC9B,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAIpD,eAAO,MAAM,WAAW;;;;EAEM,CAAC;AAC/B,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,aAAa;;;;;;;;;;;iBAMM,CAAC;AACjC,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,eAAO,MAAM,OAAO;;;;;iBAE0E,CAAC;AAE/F,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;iBAeM,CAAC;AAC7B,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,SAAS;;;iBAEM,CAAC;AAC7B,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQM,CAAC;AAC1B,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE5C,qEAAqE;AACrE,eAAO,MAAM,cAAc;aACzB,QAAQ,EAAE,EAAE;aACZ,WAAW,EAAE,IAAI;aACjB,cAAc,EAAE,IAAI;aACpB,oBAAoB,EAAE,IAAI;aAC1B,cAAc,EAAE,EAAE;CACV,CAAC;AAEX,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,YAC5B,UAAU,EACV,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,eAAe,EACf,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,UAAU,EACV,OAAO,EACP,sBAAsB,EACtB,oBAAoB,CACZ,CAAC"}

package/dist/screen.js

@@ -0,0 +1,95 @@
+import { z } from "zod";
+/* ── Скриншот (ТЗ 8.4) ────────────────────────────────────────────────── */
+export const ScreenshotRequest = z
+    .object({
+    format: z.enum(["jpeg", "png"]).default("jpeg"),
+    quality: z.number().int().min(1).max(100).default(80),
+    maxWidth: z.number().int().min(64).max(8192).optional(),
+    response: z.enum(["base64", "binary"]).default("base64"),
+})
+    .meta({ id: "ScreenshotRequest" });
+export const Screenshot = z
+    .object({
+    mime: z.string(),
+    data: z.string().describe("base64, если response=base64"),
+    imageWidth: z.number().int().positive(),
+    imageHeight: z.number().int().positive(),
+    widthPoints: z.number().int().positive(),
+    heightPoints: z.number().int().positive(),
+    /** imageWidth / widthPoints. Координаты действий умножать НЕ надо: API всегда в точках. */
+    scale: z.number().positive(),
+})
+    .meta({ id: "Screenshot" });
+/* ── Структура экрана, ui_tree (ТЗ 7.12, 8.8) ─────────────────────────── */
+export const UiTreeScope = z
+    .enum(["frontmost", "all_windows", "menu_bar"])
+    .meta({ id: "UiTreeScope" });
+export const UiTreeRequest = z
+    .object({
+    scope: UiTreeScope.default("frontmost"),
+    interactiveOnly: z.boolean().default(true),
+    format: z.enum(["json", "compact"]).default("compact"),
+})
+    .meta({ id: "UiTreeRequest" });
+export const UiFrame = z
+    .object({ x: z.number(), y: z.number(), w: z.number(), h: z.number() })
+    .meta({ id: "UiFrame", description: "Глобальные координаты в точках, начало — левый верх" });
+export const UiElement = z
+    .object({
+    id: z.string(),
+    role: z.string(),
+    subrole: z.string().optional(),
+    title: z.string().optional(),
+    description: z.string().optional(),
+    /** Обрезано до 200 символов. НИКОГДА не заполняется для AXSecureTextField (ТЗ 3.4). */
+    value: z.string().max(200).optional(),
+    identifier: z.string().optional(),
+    frame: UiFrame,
+    enabled: z.boolean(),
+    focused: z.boolean(),
+    actions: z.array(z.string()).default([]),
+})
+    .meta({ id: "UiElement" });
+/**
+ * Именованный тип обязателен: безымянный вложенный объект quicktype называет
+ * `App`, а это имя перекрывает протокол SwiftUI App в приложении.
+ */
+export const UiTreeApp = z
+    .object({ bundleId: z.string(), name: z.string() })
+    .meta({ id: "UiTreeApp" });
+export const UiTree = z
+    .object({
+    snapshotId: z.string(),
+    app: UiTreeApp.nullable(),
+    elements: z.array(UiElement),
+    compact: z.string().optional(),
+    truncated: z.boolean().default(false),
+})
+    .meta({ id: "UiTree" });
+/** Пределы обхода дерева (ТЗ 7.12), чтобы не вешать сложные окна. */
+export const UI_TREE_LIMITS = {
+    maxDepth: 25,
+    maxElements: 1500,
+    totalTimeoutMs: 2000,
+    perRequestTimeoutSec: 0.25,
+    snapshotTtlSec: 30,
+};
+/** Роли, считающиеся интерактивными при interactiveOnly=true. */
+export const INTERACTIVE_ROLES = [
+    "AXButton",
+    "AXTextField",
+    "AXTextArea",
+    "AXSecureTextField",
+    "AXLink",
+    "AXCheckBox",
+    "AXRadioButton",
+    "AXPopUpButton",
+    "AXMenuItem",
+    "AXMenuButton",
+    "AXComboBox",
+    "AXSlider",
+    "AXTab",
+    "AXDisclosureTriangle",
+    "AXSegmentedControl",
+];
+//# sourceMappingURL=screen.js.map

package/dist/screen.js.map

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

package/dist/system.d.ts

@@ -0,0 +1,101 @@
+import { z } from "zod";
+export declare const ShellRequest: z.ZodObject<{
+    command: z.ZodString;
+    cwd: z.ZodOptional<z.ZodString>;
+    timeoutMs: z.ZodDefault<z.ZodNumber>;
+    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$strip>;
+export type ShellRequest = z.infer<typeof ShellRequest>;
+export declare const ShellResult: z.ZodObject<{
+    exitCode: z.ZodNumber;
+    stdout: z.ZodString;
+    stderr: z.ZodString;
+    durationMs: z.ZodNumber;
+    truncated: z.ZodBoolean;
+    timedOut: z.ZodBoolean;
+}, z.core.$strip>;
+export type ShellResult = z.infer<typeof ShellResult>;
+export declare const SHELL_LIMITS: {
+    readonly defaultTimeoutMs: 60000;
+    readonly maxTimeoutMs: 900000;
+    readonly maxOutputBytesPerStream: number;
+    readonly maxConcurrent: 4;
+    readonly sigtermGraceMs: 5000;
+};
+export declare const FileUploadBegin: z.ZodObject<{
+    path: z.ZodString;
+    sizeBytes: z.ZodNumber;
+    sha256: z.ZodString;
+}, z.core.$strip>;
+export type FileUploadBegin = z.infer<typeof FileUploadBegin>;
+export declare const FileStat: z.ZodObject<{
+    path: z.ZodString;
+    sizeBytes: z.ZodNumber;
+    sha256: z.ZodString;
+    modifiedAt: z.ZodString;
+}, z.core.$strip>;
+export type FileStat = z.infer<typeof FileStat>;
+export declare const FILE_LIMITS: {
+    readonly maxBytes: number;
+    readonly chunkBytes: number;
+};
+export declare const AppRef: z.ZodObject<{
+    bundleId: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type AppRef = z.infer<typeof AppRef>;
+export declare const RunningApp: z.ZodObject<{
+    bundleId: z.ZodString;
+    name: z.ZodString;
+    pid: z.ZodNumber;
+    active: z.ZodBoolean;
+}, z.core.$strip>;
+export type RunningApp = z.infer<typeof RunningApp>;
+export declare const WindowInfo: z.ZodObject<{
+    title: z.ZodString;
+    bundleId: z.ZodString;
+    appName: z.ZodString;
+    frame: z.ZodObject<{
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        w: z.ZodNumber;
+        h: z.ZodNumber;
+    }, z.core.$strip>;
+    active: z.ZodBoolean;
+}, z.core.$strip>;
+export type WindowInfo = z.infer<typeof WindowInfo>;
+export declare const OpenUrlRequest: z.ZodObject<{
+    url: z.ZodString;
+}, z.core.$strip>;
+export type OpenUrlRequest = z.infer<typeof OpenUrlRequest>;
+export declare const ClipboardText: z.ZodObject<{
+    text: z.ZodString;
+}, z.core.$strip>;
+export type ClipboardText = z.infer<typeof ClipboardText>;
+export declare const CommandStatus: z.ZodEnum<{
+    canceled: "canceled";
+    completed: "completed";
+    expired: "expired";
+    failed: "failed";
+    queued: "queued";
+    running: "running";
+}>;
+export type CommandStatus = z.infer<typeof CommandStatus>;
+export declare const QueuedCommand: z.ZodObject<{
+    commandId: z.ZodString;
+    status: z.ZodEnum<{
+        canceled: "canceled";
+        completed: "completed";
+        expired: "expired";
+        failed: "failed";
+        queued: "queued";
+        running: "running";
+    }>;
+    expiresAt: z.ZodString;
+    result: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strip>;
+export type QueuedCommand = z.infer<typeof QueuedCommand>;
+/** Типы команд, которые имеет смысл ставить в очередь (скриншот и ui_tree — нет). */
+export declare const QUEUEABLE_COMMAND_TYPES: readonly ["actions", "shell", "files.upload", "apps.open", "apps.activate", "urls.open", "clipboard.set"];
+//# sourceMappingURL=system.d.ts.map

package/dist/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../src/system.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,YAAY;;;;;iBAOM,CAAC;AAChC,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,eAAO,MAAM,WAAW;;;;;;;iBASM,CAAC;AAC/B,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,YAAY;aACvB,gBAAgB,EAAE,KAAM;aACxB,YAAY,EAAE,MAAO;aACrB,uBAAuB;aACvB,aAAa,EAAE,CAAC;aAChB,cAAc,EAAE,IAAI;CACZ,CAAC;AAIX,eAAO,MAAM,eAAe;;;;iBAMM,CAAC;AACnC,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,QAAQ;;;;;iBAOM,CAAC;AAC5B,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD,eAAO,MAAM,WAAW;aACtB,QAAQ;aACR,UAAU;CACF,CAAC;AAIX,eAAO,MAAM,MAAM;;;iBAGM,CAAC;AAC1B,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC;AAE5C,eAAO,MAAM,UAAU;;;;;iBAOM,CAAC;AAC9B,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,UAAU;;;;;;;;;;;iBAQM,CAAC;AAC9B,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,cAAc;;iBAEM,CAAC;AAClC,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,eAAO,MAAM,aAAa;;iBAEM,CAAC;AACjC,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAI1D,eAAO,MAAM,aAAa;;;;;;;EAEM,CAAC;AACjC,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,eAAO,MAAM,aAAa;;;;;;;;;;;;;iBAQM,CAAC;AACjC,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D,qFAAqF;AACrF,eAAO,MAAM,uBAAuB,YAClC,SAAS,EACT,OAAO,EACP,cAAc,EACd,WAAW,EACX,eAAe,EACf,WAAW,EACX,eAAe,CACP,CAAC"}

package/dist/system.js

@@ -0,0 +1,99 @@
+import { z } from "zod";
+/* ── Терминал (ТЗ 7.5, право shell) ───────────────────────────────────── */
+export const ShellRequest = z
+    .object({
+    command: z.string().min(1).max(10_000),
+    cwd: z.string().optional(),
+    timeoutMs: z.number().int().min(1000).max(900_000).default(60_000),
+    env: z.record(z.string(), z.string()).optional(),
+})
+    .meta({ id: "ShellRequest" });
+export const ShellResult = z
+    .object({
+    exitCode: z.number().int(),
+    stdout: z.string(),
+    stderr: z.string(),
+    durationMs: z.number().int().nonnegative(),
+    truncated: z.boolean(),
+    timedOut: z.boolean(),
+})
+    .meta({ id: "ShellResult" });
+export const SHELL_LIMITS = {
+    defaultTimeoutMs: 60_000,
+    maxTimeoutMs: 900_000,
+    maxOutputBytesPerStream: 1024 * 1024,
+    maxConcurrent: 4,
+    sigtermGraceMs: 5000,
+};
+/* ── Файлы (ТЗ 7.5, право files) ──────────────────────────────────────── */
+export const FileUploadBegin = z
+    .object({
+    path: z.string().min(1),
+    sizeBytes: z.number().int().min(0).max(100 * 1024 * 1024),
+    sha256: z.string().length(64),
+})
+    .meta({ id: "FileUploadBegin" });
+export const FileStat = z
+    .object({
+    path: z.string(),
+    sizeBytes: z.number().int().nonnegative(),
+    sha256: z.string(),
+    modifiedAt: z.string(),
+})
+    .meta({ id: "FileStat" });
+export const FILE_LIMITS = {
+    maxBytes: 100 * 1024 * 1024,
+    chunkBytes: 1024 * 1024,
+};
+/* ── Нативные действия (ТЗ 7.15, 8.9) ─────────────────────────────────── */
+export const AppRef = z
+    .object({ bundleId: z.string().optional(), name: z.string().optional() })
+    .refine((v) => Boolean(v.bundleId ?? v.name), { message: "нужен bundleId или name" })
+    .meta({ id: "AppRef" });
+export const RunningApp = z
+    .object({
+    bundleId: z.string(),
+    name: z.string(),
+    pid: z.number().int(),
+    active: z.boolean(),
+})
+    .meta({ id: "RunningApp" });
+export const WindowInfo = z
+    .object({
+    title: z.string(),
+    bundleId: z.string(),
+    appName: z.string(),
+    frame: z.object({ x: z.number(), y: z.number(), w: z.number(), h: z.number() }),
+    active: z.boolean(),
+})
+    .meta({ id: "WindowInfo" });
+export const OpenUrlRequest = z
+    .object({ url: z.string().url().max(4000) })
+    .meta({ id: "OpenUrlRequest" });
+export const ClipboardText = z
+    .object({ text: z.string().max(1024 * 1024) })
+    .meta({ id: "ClipboardText" });
+/* ── Очередь команд (ТЗ 7.16, 8.10) ───────────────────────────────────── */
+export const CommandStatus = z
+    .enum(["queued", "running", "completed", "failed", "expired", "canceled"])
+    .meta({ id: "CommandStatus" });
+export const QueuedCommand = z
+    .object({
+    commandId: z.string(),
+    status: CommandStatus,
+    expiresAt: z.string(),
+    result: z.unknown().optional(),
+    error: z.unknown().optional(),
+})
+    .meta({ id: "QueuedCommand" });
+/** Типы команд, которые имеет смысл ставить в очередь (скриншот и ui_tree — нет). */
+export const QUEUEABLE_COMMAND_TYPES = [
+    "actions",
+    "shell",
+    "files.upload",
+    "apps.open",
+    "apps.activate",
+    "urls.open",
+    "clipboard.set",
+];
+//# sourceMappingURL=system.js.map

package/dist/system.js.map

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

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@dyrra/protocol",
+  "version": "0.1.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "zod": "4.6.2"
+  },
+  "devDependencies": {
+    "quicktype": "26.0.0",
+    "@types/node": "24.10.1",
+    "tsx": "4.23.13"
+  },
+  "description": "Схемы протокола Dyrra: единый API к Mac для ИИ-агентов",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ceodaredevil/dyrra.git",
+    "directory": "packages/protocol"
+  },
+  "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"
+  ],
+  "scripts": {
+    "build": "tsx scripts/codegen.ts && tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "oxlint src",
+    "test": "vitest run",
+    "codegen": "tsx scripts/codegen.ts",
+    "build:types": "tsc -p tsconfig.build.json"
+  }
+}