@crosshands/cli 0.2.0 → 0.2.1

package/dist/intent/log.d.ts

@@ -1,8 +1,82 @@
+import type { Suggestion } from '@crosshands/contract';
+import { type JevHttpStats } from './http.js';
+export type JevPhase = 'observe' | 'bind' | 'named';
+type JevShared = {
+    callId: string;
+    operation: string;
+    snapshotId: string;
+    phase: JevPhase;
+    goal?: string;
+};
+export type JevCallRecord = {
+    kind: 'jev.call';
+    callId: string;
+    operation: string;
+    durationMs: number;
+    httpMs: number;
+    brokerCalls: number;
+    ranks: number;
+    phase?: JevPhase;
+    bound?: boolean;
+    error?: string;
+    goal?: string;
+};
+export type JevHttpRecord = JevShared & {
+    kind: 'jev.http';
+    status: number;
+    durationMs: number;
+    requestBytes: number;
+    responseBytes: number;
+    candidateCount: number;
+};
+export type JevDecisionRecord = JevShared & {
+    kind: 'jev.decision';
+    app?: string;
+    move: Suggestion['move']['kind'];
+    elementIndex?: number;
+    reason?: string;
+    confidence?: number;
+    goalChars: number;
+    treeChars: number;
+    elementCount: number;
+    candidateCount: number;
+    parseMs: number;
+    evaluateMs?: number;
+};
+export type JevRecord = JevCallRecord | JevHttpRecord | JevDecisionRecord;
 export type JevLogger = {
-    emit(record: Record<string, unknown>): void;
+    emit(record: JevRecord): void;
     close(): Promise<void>;
 };
+export type JevCall = {
+    callId: string;
+    operation: string;
+    goal?: string;
+    ranks: number;
+    httpMs: number;
+    brokerCalls: number;
+    phase?: JevPhase;
+};
+export type JevRankStats = {
+    snapshotId: string;
+    treeChars: number;
+    elementCount: number;
+    candidateCount: number;
+    parseMs: number;
+    goalChars: number;
+    evaluateMs?: number;
+    app?: string;
+    http?: JevHttpStats;
+};
+export type RankRecorder = (phase: JevPhase, stats: JevRankStats, suggestion?: Suggestion) => void;
 export declare function hashGoal(goal: string): string;
+export declare function createJevCall(operation: string, goal?: string): JevCall;
+export declare function recordRank(log: JevLogger | undefined, call: JevCall | undefined, phase: JevPhase, stats: JevRankStats, suggestion?: Suggestion): void;
+export declare function emitCall(log: JevLogger | undefined, call: JevCall | undefined, started: number, extra?: {
+    error?: string;
+    bound?: boolean;
+}): void;
 export declare function createJevLogger(graphicalSessionId: string, env?: NodeJS.ProcessEnv): JevLogger;
 export declare function createCliJevLogger(env?: NodeJS.ProcessEnv): JevLogger | undefined;
+export {};
 //# sourceMappingURL=log.d.ts.map

package/dist/intent/log.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/intent/log.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB,CAAA;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C;AAID,wBAAgB,eAAe,CAC7B,kBAAkB,EAAE,MAAM,EAC1B,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,SAAS,CAoBX;AAED,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,SAAS,GAAG,SAAS,CAG9F"}
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/intent/log.ts"],"names":[],"mappings":"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"}

package/dist/intent/log.js

@@ -2,10 +2,89 @@ import { createHash, randomUUID } from 'node:crypto';
 import { JsonlFileWriter, diagnosticsDirectory } from '@crosshands/runtime';
 import { localClientPaths } from '../local-client.js';
 import { parseJevEnv } from './env.js';
+import { elapsedMs } from './http.js';
 export function hashGoal(goal) {
     return createHash('sha256').update(goal).digest('hex');
 }
 const OMIT = new Set(['goal', 'apiKey', 'treeText', 'text', 'value', 'TYPESAFE_API_KEY']);
+export function createJevCall(operation, goal) {
+    return {
+        callId: randomUUID(),
+        operation,
+        ...(goal === undefined ? {} : { goal }),
+        ranks: 0,
+        httpMs: 0,
+        brokerCalls: 0
+    };
+}
+export function recordRank(log, call, phase, stats, suggestion) {
+    if (call !== undefined) {
+        call.phase = phase;
+        call.ranks += 1;
+        if (stats.http !== undefined)
+            call.httpMs += stats.http.durationMs;
+    }
+    if (log === undefined || call === undefined)
+        return;
+    const shared = {
+        callId: call.callId,
+        operation: call.operation,
+        snapshotId: stats.snapshotId,
+        phase,
+        ...(call.goal === undefined ? {} : { goal: call.goal })
+    };
+    if (stats.http !== undefined) {
+        log.emit({
+            kind: 'jev.http',
+            ...shared,
+            status: stats.http.status,
+            durationMs: stats.http.durationMs,
+            requestBytes: stats.http.requestBytes,
+            responseBytes: stats.http.responseBytes,
+            candidateCount: stats.candidateCount
+        });
+    }
+    if (suggestion === undefined)
+        return;
+    const move = suggestion.move;
+    log.emit({
+        kind: 'jev.decision',
+        ...shared,
+        ...(stats.app === undefined ? {} : { app: stats.app }),
+        move: move.kind,
+        ...(move.kind === 'click' ||
+            move.kind === 'setValue' ||
+            move.kind === 'secondary' ||
+            move.kind === 'scroll'
+            ? { elementIndex: move.elementIndex }
+            : {}),
+        ...(move.kind === 'blocked' ? { reason: move.reason } : {}),
+        ...(suggestion.confidence === undefined ? {} : { confidence: suggestion.confidence }),
+        goalChars: stats.goalChars,
+        treeChars: stats.treeChars,
+        elementCount: stats.elementCount,
+        candidateCount: stats.candidateCount,
+        parseMs: stats.parseMs,
+        ...(stats.evaluateMs === undefined ? {} : { evaluateMs: stats.evaluateMs })
+    });
+}
+export function emitCall(log, call, started, extra = {}) {
+    if (log === undefined || call === undefined)
+        return;
+    log.emit({
+        kind: 'jev.call',
+        callId: call.callId,
+        operation: call.operation,
+        durationMs: elapsedMs(started),
+        httpMs: call.httpMs,
+        brokerCalls: call.brokerCalls,
+        ranks: call.ranks,
+        ...(call.phase === undefined ? {} : { phase: call.phase }),
+        ...(extra.bound === undefined ? {} : { bound: extra.bound }),
+        ...(extra.error === undefined ? {} : { error: extra.error }),
+        ...(call.goal === undefined ? {} : { goal: call.goal })
+    });
+}
 export function createJevLogger(graphicalSessionId, env = process.env) {
     const writer = new JsonlFileWriter({
         directory: diagnosticsDirectory(graphicalSessionId, { env }),
@@ -14,17 +93,25 @@ export function createJevLogger(graphicalSessionId, env = process.env) {
     writer.start();
     return {
         emit(record) {
-            const kind = record.kind;
-            if (typeof kind !== 'string')
-                return;
-            const goal = record.goal;
-            const rest = { ...record, kind, v: 1, ts: new Date().toISOString() };
-            for (const key of OMIT)
-                delete rest[key];
-            writer.emit({
-                ...rest,
-                ...(typeof goal === 'string' ? { goalSha256: hashGoal(goal) } : {})
-            });
+            try {
+                const raw = record;
+                const goal = raw.goal;
+                const rest = {
+                    ...raw,
+                    kind: record.kind,
+                    v: 1,
+                    ts: new Date().toISOString()
+                };
+                for (const key of OMIT)
+                    delete rest[key];
+                writer.emit({
+                    ...rest,
+                    ...(typeof goal === 'string' ? { goalSha256: hashGoal(goal) } : {})
+                });
+            }
+            catch {
+                // Jev logs must not fail computer-use.
+            }
         },
         close: () => writer.close()
     };

package/dist/intent/log.js.map

@@ -1 +1 @@
-{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/intent/log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAEpD,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAE3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAOtC,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACxD,CAAC;AAED,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAA;AAEzF,MAAM,UAAU,eAAe,CAC7B,kBAA0B,EAC1B,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,SAAS,EAAE,oBAAoB,CAAC,kBAAkB,EAAE,EAAE,GAAG,EAAE,CAAC;QAC5D,UAAU,EAAE,OAAO,UAAU,EAAE,EAAE;KAClC,CAAC,CAAA;IACF,MAAM,CAAC,KAAK,EAAE,CAAA;IACd,OAAO;QACL,IAAI,CAAC,MAAM;YACT,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;YACxB,IAAI,OAAO,IAAI,KAAK,QAAQ;gBAAE,OAAM;YACpC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAA;YACxB,MAAM,IAAI,GAA4B,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAA;YAC7F,KAAK,MAAM,GAAG,IAAI,IAAI;gBAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAA;YACxC,MAAM,CAAC,IAAI,CAAC;gBACV,GAAG,IAAI;gBACP,GAAG,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpE,CAAC,CAAA;QACJ,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;KAC5B,CAAA;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACrE,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,SAAS,CAAA;IACrD,OAAO,eAAe,CAAC,gBAAgB,EAAE,CAAC,QAAQ,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAA;AAC7E,CAAC"}
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/intent/log.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crosshands/cli",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Agent-agnostic local computer-use CLI",
   "license": "MIT",
   "bin": {
@@ -23,8 +23,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@crosshands/contract": "0.2.0",
-    "@crosshands/runtime": "0.2.0"
+    "@crosshands/runtime": "0.2.1",
+    "@crosshands/contract": "0.2.1"
   },
   "devDependencies": {
     "@types/node": "24.10.1",
@@ -32,9 +32,9 @@
     "vitest": "4.1.5"
   },
   "optionalDependencies": {
-    "@crosshands/platform-linux": "0.2.0",
-    "@crosshands/platform-windows": "0.2.0",
-    "@crosshands/platform-darwin": "0.2.0"
+    "@crosshands/platform-darwin": "0.2.1",
+    "@crosshands/platform-windows": "0.2.1",
+    "@crosshands/platform-linux": "0.2.1"
   },
   "engines": {
     "node": ">=22"

package/src/intent/dispatch.ts

@@ -18,12 +18,22 @@ import {
 import { unwrapBrokerResult } from '../broker-result.js'
 import { parseJevEnv, type JevEnv } from './env.js'
 import {
+  JevEvaluateError,
   liveEvaluator,
   namedTargetAllowed,
   suggestionFromAnswers,
   type EvaluateFn
 } from './evaluate.js'
-import type { JevLogger } from './log.js'
+import { elapsedMs } from './http.js'
+import {
+  createJevCall,
+  emitCall,
+  recordRank,
+  type JevCall,
+  type JevLogger,
+  type JevRankStats,
+  type RankRecorder
+} from './log.js'
 import { clickableMoves, parseTreeMoves } from './tree.js'
 
 export type IntentBroker = {
@@ -38,6 +48,10 @@ export type DispatchOptions = {
 
 const NAMED_GATE = new Set<ComputerOperationName>(['click', 'setValue'])
 
+type RankOutcome =
+  | { ok: true; suggestion: Suggestion; stats: JevRankStats }
+  | { ok: false; stats: JevRankStats }
+
 function policyUnavailable() {
   return createComputerError('policy_unavailable', 'Jev could not rank this snapshot').toJSON()
 }
@@ -90,40 +104,81 @@ function boundIndex(operation: ComputerOperationName, suggestion: Suggestion): n
   return undefined
 }
 
+function errorFromResult(result: unknown): string | undefined {
+  const mutation = PublicMutationResultSchema.safeParse(result)
+  if (mutation.success) {
+    const outcome = mutation.data.outcome
+    if (outcome.state === 'not_attempted' || outcome.state === 'failed') return outcome.error?.code
+    return undefined
+  }
+  const snapshot = PublicSnapshotResultSchema.safeParse(result)
+  if (!snapshot.success) return undefined
+  return snapshot.data.issues.find((issue) => issue.code === 'policy_unavailable')?.code
+}
+
+function boundFromCall(call: JevCall | undefined, result: unknown): boolean | undefined {
+  if (call?.phase !== 'bind') return undefined
+  const mutation = PublicMutationResultSchema.safeParse(result)
+  return mutation.success && mutation.data.resolvedTarget !== undefined
+}
+
 async function rank(
   look: SnapshotResult,
   goal: string,
   evaluate: EvaluateFn,
-  log: JevLogger | undefined,
   app?: string
-): Promise<Suggestion> {
+): Promise<RankOutcome> {
+  const snapshotId = look.snapshot.id
+  const parseStarted = Date.now()
   const moves = clickableMoves(parseTreeMoves(look.snapshot.treeText))
+  const stats: JevRankStats = {
+    snapshotId,
+    treeChars: look.snapshot.treeText.length,
+    elementCount: look.snapshot.elementCount,
+    candidateCount: moves.length,
+    parseMs: elapsedMs(parseStarted),
+    goalChars: goal.length,
+    app: look.snapshot.app.id
+  }
   if (moves.length === 0) {
     return {
-      untrusted: true,
-      snapshotId: look.snapshot.id,
-      move: { kind: 'blocked', reason: 'no_candidate' }
+      ok: true,
+      suggestion: {
+        untrusted: true,
+        snapshotId,
+        move: { kind: 'blocked', reason: 'no_candidate' }
+      },
+      stats
+    }
+  }
+  const evalStarted = Date.now()
+  try {
+    const evaluated = await evaluate({
+      goal,
+      ...(app === undefined ? {} : { app }),
+      moves
+    })
+    return {
+      ok: true,
+      suggestion: suggestionFromAnswers(snapshotId, moves, evaluated.answers),
+      stats: {
+        ...stats,
+        evaluateMs: elapsedMs(evalStarted),
+        ...(evaluated.http === undefined ? {} : { http: evaluated.http })
+      }
+    }
+  } catch (cause) {
+    if (cause instanceof ComputerError) throw cause
+    const http = cause instanceof JevEvaluateError ? cause.http : undefined
+    return {
+      ok: false,
+      stats: {
+        ...stats,
+        evaluateMs: elapsedMs(evalStarted),
+        ...(http === undefined ? {} : { http })
+      }
     }
   }
-  const suggestion = suggestionFromAnswers(
-    look.snapshot.id,
-    moves,
-    await evaluate({ goal, ...(app === undefined ? {} : { app }), moves })
-  )
-  log?.emit({
-    kind: 'jev.decision',
-    snapshotId: suggestion.snapshotId,
-    move: suggestion.move.kind,
-    ...(suggestion.move.kind === 'click' ||
-    suggestion.move.kind === 'setValue' ||
-    suggestion.move.kind === 'secondary' ||
-    suggestion.move.kind === 'scroll'
-      ? { elementIndex: suggestion.move.elementIndex }
-      : {}),
-    confidence: suggestion.confidence,
-    goal
-  })
-  return suggestion
 }
 
 function evaluatorFor(env: JevEnv, override: EvaluateFn | undefined): EvaluateFn | undefined {
@@ -144,7 +199,7 @@ async function suggestObserve(
   goal: string | undefined,
   env: JevEnv,
   evaluate: EvaluateFn | undefined,
-  log: JevLogger | undefined
+  record: RankRecorder
 ): Promise<unknown> {
   const result = await request('getAppState', toBrokerInput('getAppState', input))
   if (goal === undefined || env.kind === 'off') return result
@@ -152,10 +207,15 @@ async function suggestObserve(
   if (env.kind === 'fail_closed' || evaluate === undefined) {
     return withSnapshotIssue(look, policyUnavailable())
   }
+  const app = 'app' in input && typeof input.app === 'string' ? input.app : undefined
   try {
-    const app = 'app' in input && typeof input.app === 'string' ? input.app : undefined
-    const suggestion = await rank(look, goal, evaluate, log, app)
-    return parsePublicOutput('getAppState', { ...look, suggestion })
+    const ranked = await rank(look, goal, evaluate, app)
+    if (!ranked.ok) {
+      record('observe', ranked.stats)
+      return withSnapshotIssue(look, policyUnavailable())
+    }
+    record('observe', ranked.stats, ranked.suggestion)
+    return parsePublicOutput('getAppState', { ...look, suggestion: ranked.suggestion })
   } catch {
     return withSnapshotIssue(look, policyUnavailable())
   }
@@ -168,7 +228,7 @@ async function bindIntentTarget(
   goal: string | undefined,
   env: JevEnv,
   evaluate: EvaluateFn | undefined,
-  log: JevLogger | undefined
+  record: RankRecorder
 ): Promise<unknown> {
   if (env.kind === 'off') {
     throw createComputerError('invalid_argument', 'intent targeting requires CROSSHANDS_JEV=1')
@@ -181,16 +241,20 @@ async function bindIntentTarget(
     throw createComputerError('invalid_argument', 'intent targeting requires a context token')
   }
   let look: SnapshotResult
-  let suggestion: Suggestion
   try {
     look = await lookAgain(request, token)
-    suggestion = await rank(look, goal, evaluate, log)
   } catch (cause) {
     if (cause instanceof ComputerError) throw cause
     return notAttempted(policyUnavailable())
   }
-  const index = boundIndex(operation, suggestion)
-  if (index === undefined) return notAttempted(policyUnavailable(), suggestion)
+  const ranked = await rank(look, goal, evaluate)
+  if (!ranked.ok) {
+    record('bind', ranked.stats)
+    return notAttempted(policyUnavailable())
+  }
+  record('bind', ranked.stats, ranked.suggestion)
+  const index = boundIndex(operation, ranked.suggestion)
+  if (index === undefined) return notAttempted(policyUnavailable(), ranked.suggestion)
   const bound = {
     ...splitPublicInput(input).rest,
     contextToken: look.context.token,
@@ -201,7 +265,7 @@ async function bindIntentTarget(
   return parsePublicOutput(operation, {
     ...body,
     resolvedTarget: { kind: 'element', elementIndex: index },
-    suggestion
+    suggestion: ranked.suggestion
   })
 }
 
@@ -210,25 +274,30 @@ async function gateNamedTarget(
   input: object,
   goal: string,
   evaluate: EvaluateFn,
-  log: JevLogger | undefined
+  record: RankRecorder
 ): Promise<unknown | undefined> {
   const named = elementIndexOf(input)
   const token = contextTokenOf(input)
   if (token === undefined || named === undefined) return undefined
   try {
     const look = await lookAgain(request, token)
-    const suggestion = await rank(look, goal, evaluate, log)
+    const ranked = await rank(look, goal, evaluate)
+    if (!ranked.ok) {
+      record('named', ranked.stats)
+      return notAttempted(policyUnavailable())
+    }
+    record('named', ranked.stats, ranked.suggestion)
     const picked =
-      suggestion.move.kind === 'click' || suggestion.move.kind === 'setValue'
-        ? suggestion.move.elementIndex
+      ranked.suggestion.move.kind === 'click' || ranked.suggestion.move.kind === 'setValue'
+        ? ranked.suggestion.move.elementIndex
         : undefined
-    if (picked !== named || !namedTargetAllowed(suggestion.confidence)) {
+    if (picked !== named || !namedTargetAllowed(ranked.suggestion.confidence)) {
       return notAttempted(
         createComputerError(
           'goal_mismatch',
           'Named target does not match the per-call goal'
         ).toJSON(),
-        suggestion
+        ranked.suggestion
       )
     }
   } catch {
@@ -247,30 +316,58 @@ export async function dispatchPublicOperation(
   const parsed = parsePublicInput(operation, rawInput)
   const { goal } = splitPublicInput(parsed)
   const evaluate = evaluatorFor(envState, options.evaluate)
-  const request: IntentBroker['request'] = async (name, input) =>
-    unwrapBrokerResult(await broker.request(name, input))
-
-  if (operation === 'getAppState') {
-    return suggestObserve(
-      request,
-      parsed as PublicOperationInput<'getAppState'>,
-      goal,
-      envState,
-      evaluate,
-      options.log
-    )
+  const log = options.log
+  const call = log === undefined ? undefined : createJevCall(operation, goal)
+  const record: RankRecorder = (phase, stats, suggestion) => {
+    recordRank(log, call, phase, stats, suggestion)
   }
-  if (hasIntentTarget(parsed)) {
-    return bindIntentTarget(request, operation, parsed, goal, envState, evaluate, options.log)
+  const request: IntentBroker['request'] = async (name, input) => {
+    if (call !== undefined) call.brokerCalls += 1
+    return unwrapBrokerResult(await broker.request(name, input))
   }
-  if (
-    goal !== undefined &&
-    envState.kind === 'on' &&
-    evaluate !== undefined &&
-    NAMED_GATE.has(operation)
-  ) {
-    const gated = await gateNamedTarget(request, parsed, goal, evaluate, options.log)
-    if (gated !== undefined) return gated
+
+  async function dispatch(): Promise<unknown> {
+    if (operation === 'getAppState') {
+      return suggestObserve(
+        request,
+        parsed as PublicOperationInput<'getAppState'>,
+        goal,
+        envState,
+        evaluate,
+        record
+      )
+    }
+    if (hasIntentTarget(parsed)) {
+      return bindIntentTarget(request, operation, parsed, goal, envState, evaluate, record)
+    }
+    if (
+      goal !== undefined &&
+      envState.kind === 'on' &&
+      evaluate !== undefined &&
+      NAMED_GATE.has(operation)
+    ) {
+      const gated = await gateNamedTarget(request, parsed, goal, evaluate, record)
+      if (gated !== undefined) return gated
+    }
+    return request(operation, toBrokerInput(operation, parsed))
+  }
+
+  const started = Date.now()
+  try {
+    const result = await dispatch()
+    if (call !== undefined) {
+      const extra: { error?: string; bound?: boolean } = {}
+      const error = errorFromResult(result)
+      const bound = boundFromCall(call, result)
+      if (error !== undefined) extra.error = error
+      if (bound !== undefined) extra.bound = bound
+      emitCall(log, call, started, extra)
+    }
+    return result
+  } catch (cause) {
+    if (call !== undefined) {
+      emitCall(log, call, started, cause instanceof ComputerError ? { error: cause.code } : {})
+    }
+    throw cause
   }
-  return request(operation, toBrokerInput(operation, parsed))
 }