@0xmaxma/claude-gateway 2.0.9 → 2.0.11

package/dist/automation/computer-use.d.ts

@@ -0,0 +1,315 @@
+import { z } from 'zod';
+export declare const COMPUTER_USE_CONTRACT_VERSION = 1;
+/** Named commands a helper runs as one guarded keyboard shortcut (standard_command). */
+export declare const STANDARD_SHORTCUTS: readonly ["tab:new", "address:focus", "tab:close", "app:quit"];
+export declare const ComputerObservation: z.ZodPipe<z.ZodObject<{
+    contractVersion: z.ZodCatch<z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+    capabilities: z.ZodCatch<z.ZodOptional<z.ZodObject<{
+        standardCommands: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        keys: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    standardCommand: z.ZodCatch<z.ZodOptional<z.ZodEnum<{
+        "scroll:up": "scroll:up";
+        "scroll:down": "scroll:down";
+        "close:window": "close:window";
+        "tab:new": "tab:new";
+        "address:focus": "address:focus";
+        "tab:close": "tab:close";
+        "app:quit": "app:quit";
+    }>>>;
+    scrollAreas: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        ref: z.ZodString;
+        label: z.ZodString;
+        bounds: z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$strip>>>;
+    supportedActions: z.ZodOptional<z.ZodPreprocess<z.ZodArray<z.ZodEnum<{
+        "scroll:up": "scroll:up";
+        "scroll:down": "scroll:down";
+        "navigate:back": "navigate:back";
+        "navigate:forward": "navigate:forward";
+    }>>, unknown>>;
+    screenshotAvailable: z.ZodOptional<z.ZodBoolean>;
+    screenshotRestriction: z.ZodOptional<z.ZodString>;
+    observationStats: z.ZodOptional<z.ZodObject<{
+        visited: z.ZodNumber;
+        candidates: z.ZodNumber;
+        exported: z.ZodNumber;
+        incomplete: z.ZodBoolean;
+    }, z.core.$strip>>;
+    generation: z.ZodString;
+    application: z.ZodString;
+    controls: z.ZodArray<z.ZodObject<{
+        identity: z.ZodOptional<z.ZodString>;
+        bounds: z.ZodOptional<z.ZodObject<{
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>>;
+        ref: z.ZodString;
+        label: z.ZodString;
+        context: z.ZodOptional<z.ZodString>;
+        role: z.ZodString;
+        value: z.ZodOptional<z.ZodString>;
+        focused: z.ZodOptional<z.ZodBoolean>;
+        actions: z.ZodPreprocess<z.ZodArray<z.ZodEnum<{
+            type: "type";
+            press: "press";
+        }>>, unknown>;
+        sensitive: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    focusedControl: z.ZodOptional<z.ZodObject<{
+        ref: z.ZodOptional<z.ZodString>;
+        role: z.ZodString;
+        label: z.ZodString;
+        sensitive: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    windowTitle: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    truncated: z.ZodBoolean;
+    platform: z.ZodOptional<z.ZodObject<{
+        os: z.ZodString;
+        osVersion: z.ZodString;
+        appVersion: z.ZodOptional<z.ZodString>;
+        helperVersion: z.ZodOptional<z.ZodString>;
+        helperBuild: z.ZodOptional<z.ZodString>;
+        helperCommit: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    apps: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodTransform<{
+    generation: string;
+    application: string;
+    controls: {
+        ref: string;
+        label: string;
+        role: string;
+        actions: ("type" | "press")[];
+        identity?: string | undefined;
+        bounds?: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        } | undefined;
+        context?: string | undefined;
+        value?: string | undefined;
+        focused?: boolean | undefined;
+        sensitive?: boolean | undefined;
+    }[];
+    truncated: boolean;
+    apps: {
+        id: string;
+        name: string;
+    }[];
+    contractVersion?: string | number | undefined;
+    capabilities?: {
+        standardCommands?: string[] | undefined;
+        keys?: string[] | undefined;
+    } | undefined;
+    standardCommand?: "scroll:up" | "scroll:down" | "close:window" | "tab:new" | "address:focus" | "tab:close" | "app:quit" | undefined;
+    scrollAreas?: {
+        ref: string;
+        label: string;
+        bounds: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+    }[] | undefined;
+    supportedActions?: ("scroll:up" | "scroll:down" | "navigate:back" | "navigate:forward")[] | undefined;
+    screenshotAvailable?: boolean | undefined;
+    screenshotRestriction?: string | undefined;
+    observationStats?: {
+        visited: number;
+        candidates: number;
+        exported: number;
+        incomplete: boolean;
+    } | undefined;
+    focusedControl?: {
+        role: string;
+        label: string;
+        ref?: string | undefined;
+        sensitive?: boolean | undefined;
+    } | undefined;
+    windowTitle?: string | undefined;
+    text?: string[] | undefined;
+    platform?: {
+        os: string;
+        osVersion: string;
+        appVersion?: string | undefined;
+        helperVersion?: string | undefined;
+        helperBuild?: string | undefined;
+        helperCommit?: string | undefined;
+    } | undefined;
+}, {
+    generation: string;
+    application: string;
+    controls: {
+        ref: string;
+        label: string;
+        role: string;
+        actions: ("type" | "press")[];
+        identity?: string | undefined;
+        bounds?: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        } | undefined;
+        context?: string | undefined;
+        value?: string | undefined;
+        focused?: boolean | undefined;
+        sensitive?: boolean | undefined;
+    }[];
+    truncated: boolean;
+    apps: {
+        id: string;
+        name: string;
+    }[];
+    contractVersion?: string | number | undefined;
+    capabilities?: {
+        standardCommands?: string[] | undefined;
+        keys?: string[] | undefined;
+    } | undefined;
+    standardCommand?: "scroll:up" | "scroll:down" | "close:window" | "tab:new" | "address:focus" | "tab:close" | "app:quit" | undefined;
+    scrollAreas?: {
+        ref: string;
+        label: string;
+        bounds: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+    }[] | undefined;
+    supportedActions?: ("scroll:up" | "scroll:down" | "navigate:back" | "navigate:forward")[] | undefined;
+    screenshotAvailable?: boolean | undefined;
+    screenshotRestriction?: string | undefined;
+    observationStats?: {
+        visited: number;
+        candidates: number;
+        exported: number;
+        incomplete: boolean;
+    } | undefined;
+    focusedControl?: {
+        role: string;
+        label: string;
+        ref?: string | undefined;
+        sensitive?: boolean | undefined;
+    } | undefined;
+    windowTitle?: string | undefined;
+    text?: string[] | undefined;
+    platform?: {
+        os: string;
+        osVersion: string;
+        appVersion?: string | undefined;
+        helperVersion?: string | undefined;
+        helperBuild?: string | undefined;
+        helperCommit?: string | undefined;
+    } | undefined;
+}>>;
+export type ComputerState = z.infer<typeof ComputerObservation>;
+export interface GoalRevision {
+    revision: number;
+    goal: string;
+}
+/** Structural diagnostics only: no typed text, window contents or private field labels. */
+export interface ComputerProgress {
+    sequence: number;
+    round: number;
+    at: number;
+    revision: number;
+    steps: number;
+    evaluations: number;
+    phase: 'observing' | 'observed' | 'evaluating' | 'decided' | 'thinking' | 'verifying' | 'acting' | 'acted' | 'waiting' | 'reconciling' | 'terminal';
+    application?: string;
+    appId?: string;
+    decisionMode?: 'jev' | 'thinking';
+    action?: 'open' | 'press' | 'type' | 'key' | 'scroll' | 'navigate' | 'WAIT' | 'DONE' | 'BLOCKED';
+    key?: string;
+    ref?: string;
+    role?: string;
+    targetGeneration?: string;
+    focused?: boolean;
+    operationId?: string;
+    requestId?: string;
+    confidence?: number;
+    elapsedMs?: number;
+    outcome?: 'completed' | 'not_executed' | 'unknown';
+    changed?: boolean;
+    reason?: string;
+    status?: ComputerUseResult['status'];
+    /** Which Jev response check failed (JEV_INVALID_RESPONSE); a fixed code, never response content. */
+    validationReason?: string;
+}
+/** A bounded diagnostic code from a Jev error; anything else is dropped. */
+export declare const jevValidationReason: (error: unknown) => string | undefined;
+export interface ComputerUseDependencies {
+    interruptSignal?: AbortSignal;
+    call(name: string, args: Record<string, unknown>, signal: AbortSignal): Promise<unknown>;
+    evaluate(request: {
+        state: unknown;
+        questions: Record<string, {
+            type: 'choice';
+            instructions: string | {
+                command: string;
+                question: string;
+            };
+            criteria: Record<string, string>;
+        }>;
+        requestId: string;
+    }, signal: AbortSignal): Promise<{
+        answers: Record<string, unknown>;
+    }>;
+    observation?: (state: ComputerState) => void;
+    snapshot?: (state: ComputerState, signal: AbortSignal) => Promise<void | {
+        error: string;
+    }>;
+    thinking?: (request: unknown, signal: AbortSignal) => Promise<unknown>;
+    latestGoal?: () => GoalRevision;
+    authorized: () => boolean;
+    beforeMutation: (operationId: string, action: unknown) => Promise<void> | void;
+    progress?: (event: ComputerProgress) => void;
+    verify?: (state: ComputerState, goal: string, signal: AbortSignal) => Promise<boolean>;
+}
+export interface ComputerUseResult {
+    status: 'succeeded' | 'needs_verification' | 'needs_input' | 'blocked' | 'cancelled' | 'needs_reconciliation';
+    reason: string;
+    revision: number;
+    steps: number;
+    evaluations: number;
+    trace: {
+        events: ComputerProgress[];
+        truncated: boolean;
+    };
+    operationId?: string;
+    observation?: ComputerState;
+    stepRun?: import('./computer-steps').ComputerStepRun;
+    lastAction?: ComputerLastAction;
+}
+/** The command's own interaction, for the owner's outcome line. Never typed text. */
+export interface ComputerLastAction {
+    kind: string;
+    label?: string;
+    role?: string;
+    key?: string;
+    direction?: string;
+    appId?: string;
+    count?: number;
+    blocked?: boolean;
+    sequence?: string[];
+    planned?: number;
+    /** Not run: the agent's command chose a high-impact action and the user was asked to confirm it. */
+    confirm?: boolean;
+}
+export declare function runComputerUse(raw: unknown, deps: ComputerUseDependencies, signal: AbortSignal): Promise<ComputerUseResult>;
+//# sourceMappingURL=computer-use.d.ts.map

package/dist/automation/computer-use.d.ts.map

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