@anionex/dsh-computer-use 0.1.0 → 0.2.0

package/src/tools.ts

@@ -170,6 +170,24 @@ const actionResultSchema = {
         targetChanged: { type: 'boolean', required: true },
       },
     },
+    agentCursor: {
+      type: 'object',
+      additionalProperties: false,
+      properties: {
+        visible: { type: 'boolean', const: false, required: true },
+        reason: { type: 'string' },
+      },
+    },
+    effect: {
+      type: 'object',
+      additionalProperties: false,
+      required: true,
+      properties: {
+        observedStateChanged: { type: 'boolean', required: true },
+        observedForMs: { type: 'integer', required: true },
+        note: { type: 'string' },
+      },
+    },
     observation: { ...observationSchema, required: true },
   },
 } as const satisfies ValueSchemaSpec

package/src/types.ts

@@ -252,9 +252,29 @@ export interface ComputerActionResult {
   pointerRouting: 'none' | 'target-process'
   /** Present when the action addressed an observed element. */
   resolution?: ComputerTargetResolutionResult
+  /** Present only when the agent cursor should be on screen and is not. */
+  agentCursor?: { visible: false; reason?: string }
+  /** What changed in the bounded post-action structural observation. */
+  effect: ComputerActionEffect
   observation: ComputerObservation
 }
 
+/**
+ * What changed in the bounded structural observation after an action.
+ *
+ * The comparison covers the window title, id and frame plus the Accessibility
+ * element tree. It does not prove that the action caused the change, and it
+ * cannot observe pixel-only, transient, remote, or otherwise external effects.
+ */
+export interface ComputerActionEffect {
+  /** True when the post-action structural state hash differed. */
+  observedStateChanged: boolean
+  /** How long the settle loop watched, in milliseconds. */
+  observedForMs: number
+  /** Scope guidance when no structural change was observed. */
+  note?: string
+}
+
 /** Confirmation request binding an exact proposed action to human-readable impact. */
 export interface ComputerConfirmRequest {
   action: Omit<ComputerActionRequest, 'confirmationToken'>
@@ -282,7 +302,7 @@ export interface ComputerUseContext {
 /** Provider and permission diagnostics exposed to Settings. */
 export interface ComputerUseStatus {
   platform: NodeJS.Platform
-  provider: 'macos-ax'
+  provider: 'macos-ax' | 'unsupported'
   generation: number
   ready: boolean
   helperPath: string