@crosshands/cli 0.1.6 → 0.2.1

package/dist/intent/dispatch.js

@@ -0,0 +1,277 @@
+import { ComputerError, createComputerError, hasIntentTarget, parsePublicInput, parsePublicOutput, PublicMutationResultSchema, PublicSnapshotResultSchema, SnapshotResultSchema, splitPublicInput, toBrokerInput } from '@crosshands/contract';
+import { unwrapBrokerResult } from '../broker-result.js';
+import { parseJevEnv } from './env.js';
+import { JevEvaluateError, liveEvaluator, namedTargetAllowed, suggestionFromAnswers } from './evaluate.js';
+import { elapsedMs } from './http.js';
+import { createJevCall, emitCall, recordRank } from './log.js';
+import { clickableMoves, parseTreeMoves } from './tree.js';
+const NAMED_GATE = new Set(['click', 'setValue']);
+function policyUnavailable() {
+    return createComputerError('policy_unavailable', 'Jev could not rank this snapshot').toJSON();
+}
+function snapshotResultOf(value) {
+    return SnapshotResultSchema.parse(value);
+}
+function notAttempted(error, suggestion) {
+    return PublicMutationResultSchema.parse({
+        outcome: { state: 'not_attempted', error },
+        ...(suggestion === undefined ? {} : { suggestion })
+    });
+}
+function withSnapshotIssue(look, issue) {
+    return PublicSnapshotResultSchema.parse({
+        ...look,
+        issues: [...look.issues, issue]
+    });
+}
+function contextTokenOf(input) {
+    if (!('contextToken' in input) || typeof input.contextToken !== 'string')
+        return undefined;
+    return input.contextToken;
+}
+function elementIndexOf(input) {
+    if (!('target' in input))
+        return undefined;
+    const target = input.target;
+    if (target === null || typeof target !== 'object' || !('elementIndex' in target))
+        return undefined;
+    return typeof target.elementIndex === 'number' ? target.elementIndex : undefined;
+}
+function boundIndex(operation, suggestion) {
+    const move = suggestion.move;
+    if (operation === 'setValue' && move.kind === 'setValue')
+        return move.elementIndex;
+    if ((operation === 'click' || operation === 'scroll' || operation === 'performSecondaryAction') &&
+        move.kind === 'click') {
+        return move.elementIndex;
+    }
+    return undefined;
+}
+function errorFromResult(result) {
+    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, result) {
+    if (call?.phase !== 'bind')
+        return undefined;
+    const mutation = PublicMutationResultSchema.safeParse(result);
+    return mutation.success && mutation.data.resolvedTarget !== undefined;
+}
+async function rank(look, goal, evaluate, app) {
+    const snapshotId = look.snapshot.id;
+    const parseStarted = Date.now();
+    const moves = clickableMoves(parseTreeMoves(look.snapshot.treeText));
+    const stats = {
+        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 {
+            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 })
+            }
+        };
+    }
+}
+function evaluatorFor(env, override) {
+    if (override !== undefined)
+        return override;
+    if (env.kind !== 'on')
+        return undefined;
+    return liveEvaluator(env.apiKey);
+}
+async function lookAgain(request, token) {
+    return snapshotResultOf(await request('getAppState', { contextToken: token, captureScreenshot: false }));
+}
+async function suggestObserve(request, input, goal, env, evaluate, record) {
+    const result = await request('getAppState', toBrokerInput('getAppState', input));
+    if (goal === undefined || env.kind === 'off')
+        return result;
+    const look = snapshotResultOf(result);
+    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 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());
+    }
+}
+async function bindIntentTarget(request, operation, input, goal, env, evaluate, record) {
+    if (env.kind === 'off') {
+        throw createComputerError('invalid_argument', 'intent targeting requires CROSSHANDS_JEV=1');
+    }
+    if (env.kind === 'fail_closed' || evaluate === undefined || goal === undefined) {
+        throw createComputerError('intent_unavailable', 'Jev is enabled but no TypeSafe key is set');
+    }
+    const token = contextTokenOf(input);
+    if (token === undefined) {
+        throw createComputerError('invalid_argument', 'intent targeting requires a context token');
+    }
+    let look;
+    try {
+        look = await lookAgain(request, token);
+    }
+    catch (cause) {
+        if (cause instanceof ComputerError)
+            throw cause;
+        return notAttempted(policyUnavailable());
+    }
+    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,
+        target: { kind: 'element', elementIndex: index }
+    };
+    const result = await request(operation, toBrokerInput(operation, bound));
+    const body = result !== null && typeof result === 'object' ? result : {};
+    return parsePublicOutput(operation, {
+        ...body,
+        resolvedTarget: { kind: 'element', elementIndex: index },
+        suggestion: ranked.suggestion
+    });
+}
+async function gateNamedTarget(request, input, goal, evaluate, record) {
+    const named = elementIndexOf(input);
+    const token = contextTokenOf(input);
+    if (token === undefined || named === undefined)
+        return undefined;
+    try {
+        const look = await lookAgain(request, token);
+        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 = ranked.suggestion.move.kind === 'click' || ranked.suggestion.move.kind === 'setValue'
+            ? ranked.suggestion.move.elementIndex
+            : undefined;
+        if (picked !== named || !namedTargetAllowed(ranked.suggestion.confidence)) {
+            return notAttempted(createComputerError('goal_mismatch', 'Named target does not match the per-call goal').toJSON(), ranked.suggestion);
+        }
+    }
+    catch {
+        return notAttempted(policyUnavailable());
+    }
+    return undefined;
+}
+export async function dispatchPublicOperation(broker, operation, rawInput, options = {}) {
+    const envState = parseJevEnv(options.env);
+    const parsed = parsePublicInput(operation, rawInput);
+    const { goal } = splitPublicInput(parsed);
+    const evaluate = evaluatorFor(envState, options.evaluate);
+    const log = options.log;
+    const call = log === undefined ? undefined : createJevCall(operation, goal);
+    const record = (phase, stats, suggestion) => {
+        recordRank(log, call, phase, stats, suggestion);
+    };
+    const request = async (name, input) => {
+        if (call !== undefined)
+            call.brokerCalls += 1;
+        return unwrapBrokerResult(await broker.request(name, input));
+    };
+    async function dispatch() {
+        if (operation === 'getAppState') {
+            return suggestObserve(request, parsed, 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 = {};
+            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;
+    }
+}
+//# sourceMappingURL=dispatch.js.map

package/dist/intent/dispatch.js.map

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

package/dist/intent/env.d.ts

@@ -0,0 +1,11 @@
+export type JevEnv = {
+    kind: 'off';
+} | {
+    kind: 'fail_closed';
+    reason: 'missing_key';
+} | {
+    kind: 'on';
+    apiKey: string;
+};
+export declare function parseJevEnv(env?: NodeJS.ProcessEnv): JevEnv;
+//# sourceMappingURL=env.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/intent/env.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GACd;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GACf;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAElC,wBAAgB,WAAW,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAOxE"}

package/dist/intent/env.js

@@ -0,0 +1,10 @@
+export function parseJevEnv(env = process.env) {
+    if (env.CROSSHANDS_JEV !== '1')
+        return { kind: 'off' };
+    const apiKey = env.TYPESAFE_API_KEY;
+    if (typeof apiKey !== 'string' || apiKey.length === 0) {
+        return { kind: 'fail_closed', reason: 'missing_key' };
+    }
+    return { kind: 'on', apiKey };
+}
+//# sourceMappingURL=env.js.map

package/dist/intent/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/intent/env.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,WAAW,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC9D,IAAI,GAAG,CAAC,cAAc,KAAK,GAAG;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;IACtD,MAAM,MAAM,GAAG,GAAG,CAAC,gBAAgB,CAAA;IACnC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtD,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,CAAA;IACvD,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;AAC/B,CAAC"}

package/dist/intent/evaluate.d.ts

@@ -0,0 +1,31 @@
+import type { Suggestion } from '@crosshands/contract';
+import { type JevHttpStats } from './http.js';
+import type { TreeMove } from './tree.js';
+export type { JevHttpStats };
+export declare class JevEvaluateError extends Error {
+    readonly http: JevHttpStats;
+    constructor(message: string, http: JevHttpStats);
+}
+export type JevAnswers = {
+    move: 'click' | 'setValue' | 'wait' | 'done' | 'blocked';
+    clickWhich?: string;
+    setValueWhich?: string;
+    confidence?: number;
+    goalMet?: number;
+    blockedReason?: string;
+};
+export type EvaluateResult = {
+    answers: JevAnswers;
+    http?: JevHttpStats;
+};
+export type EvaluateInput = {
+    goal: string;
+    app?: string;
+    moves: readonly TreeMove[];
+};
+export type EvaluateFn = (input: EvaluateInput) => Promise<EvaluateResult>;
+export declare const GATE_REFUSE_BELOW = 0.35;
+export declare function namedTargetAllowed(confidence: number | undefined): boolean;
+export declare function suggestionFromAnswers(snapshotId: string, moves: readonly TreeMove[], answers: JevAnswers): Suggestion;
+export declare function liveEvaluator(apiKey: string): EvaluateFn;
+//# sourceMappingURL=evaluate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../src/intent/evaluate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEtD,OAAO,EAAa,KAAK,YAAY,EAAE,MAAM,WAAW,CAAA;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEzC,YAAY,EAAE,YAAY,EAAE,CAAA;AAE5B,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;gBACf,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY;CAKhD;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IACxD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,UAAU,CAAA;IACnB,IAAI,CAAC,EAAE,YAAY,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,cAAc,CAAC,CAAA;AAE1E,eAAO,MAAM,iBAAiB,OAAO,CAAA;AAErC,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAG1E;AAED,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,OAAO,EAAE,UAAU,GAClB,UAAU,CAiCZ;AAuDD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAyExD"}

package/dist/intent/evaluate.js

@@ -0,0 +1,156 @@
+import { elapsedMs } from './http.js';
+export class JevEvaluateError extends Error {
+    http;
+    constructor(message, http) {
+        super(message);
+        this.name = 'JevEvaluateError';
+        this.http = http;
+    }
+}
+export const GATE_REFUSE_BELOW = 0.35;
+export function namedTargetAllowed(confidence) {
+    if (confidence === undefined)
+        return true;
+    return confidence >= GATE_REFUSE_BELOW;
+}
+export function suggestionFromAnswers(snapshotId, moves, answers) {
+    const byIndex = new Map(moves.map((move) => [String(move.elementIndex), move]));
+    if (answers.move === 'wait') {
+        return { untrusted: true, snapshotId, move: { kind: 'wait' }, confidence: answers.confidence };
+    }
+    if (answers.move === 'done') {
+        return { untrusted: true, snapshotId, move: { kind: 'done' }, confidence: answers.confidence };
+    }
+    if (answers.move === 'blocked') {
+        return {
+            untrusted: true,
+            snapshotId,
+            move: { kind: 'blocked', reason: answers.blockedReason ?? 'blocked' },
+            confidence: answers.confidence
+        };
+    }
+    const raw = answers.move === 'setValue' ? answers.setValueWhich : answers.clickWhich;
+    const selected = raw === undefined ? undefined : byIndex.get(raw);
+    if (selected === undefined) {
+        return {
+            untrusted: true,
+            snapshotId,
+            move: { kind: 'blocked', reason: 'no_candidate' },
+            confidence: answers.confidence
+        };
+    }
+    return {
+        untrusted: true,
+        snapshotId,
+        move: { kind: answers.move, elementIndex: selected.elementIndex },
+        confidence: answers.confidence,
+        label: `${selected.role} ${selected.label}`.trim()
+    };
+}
+function criteria(moves) {
+    return Object.fromEntries(moves.map((move) => [String(move.elementIndex), `${move.role} ${move.label}`.trim()]));
+}
+const JEV_MODEL = 'jev-latest';
+function httpStats(started, requestBytes, status, responseBytes) {
+    return {
+        status,
+        durationMs: elapsedMs(started),
+        requestBytes,
+        responseBytes
+    };
+}
+function answersOf(raw) {
+    const move = raw.move?.choice;
+    if (move !== 'click' &&
+        move !== 'setValue' &&
+        move !== 'wait' &&
+        move !== 'done' &&
+        move !== 'blocked') {
+        return { move: 'blocked', blockedReason: 'no_candidate' };
+    }
+    const clickWhich = raw.click_which?.choice;
+    const setValueWhich = raw.setvalue_which?.choice;
+    const confidence = raw.move?.confidence ?? raw.click_which?.confidence;
+    const goalMet = raw.goal_met?.noul;
+    return {
+        move,
+        ...(clickWhich === undefined ? {} : { clickWhich }),
+        ...(setValueWhich === undefined ? {} : { setValueWhich }),
+        ...(confidence === undefined ? {} : { confidence }),
+        ...(goalMet === undefined ? {} : { goalMet })
+    };
+}
+export function liveEvaluator(apiKey) {
+    return async (input) => {
+        const clickable = criteria(input.moves);
+        const payload = JSON.stringify({
+            model: JEV_MODEL,
+            state: {
+                goal: input.goal,
+                ...(input.app === undefined ? {} : { app: input.app }),
+                clickable
+            },
+            questions: {
+                move: {
+                    type: 'choice',
+                    instructions: 'What should we do next for the goal?',
+                    criteria: {
+                        click: 'Press one clickable control',
+                        setValue: 'Pick a field for the caller to fill',
+                        wait: 'The window is still loading',
+                        done: 'The goal is already met',
+                        blocked: 'Stop'
+                    }
+                },
+                click_which: {
+                    type: 'choice',
+                    instructions: 'If the move is click, which control?',
+                    criteria: clickable
+                },
+                setvalue_which: {
+                    type: 'choice',
+                    instructions: 'If the move is setValue, which field?',
+                    criteria: clickable
+                },
+                goal_met: {
+                    type: 'noul',
+                    instructions: 'Is the goal already met?'
+                }
+            }
+        });
+        const requestBytes = Buffer.byteLength(payload);
+        const started = Date.now();
+        let status = 0;
+        let responseBytes = 0;
+        let raw = '';
+        try {
+            const response = await fetch('https://api.typesafe.ai/v1/systemone', {
+                method: 'POST',
+                headers: {
+                    authorization: `Bearer ${apiKey}`,
+                    'content-type': 'application/json'
+                },
+                body: payload
+            });
+            status = response.status;
+            raw = await response.text();
+            responseBytes = Buffer.byteLength(raw);
+        }
+        catch (cause) {
+            throw new JevEvaluateError(cause instanceof Error ? cause.message : 'TypeSafe HTTP failed', httpStats(started, requestBytes, 0, 0));
+        }
+        const http = httpStats(started, requestBytes, status, responseBytes);
+        if (status < 200 || status >= 300) {
+            throw new JevEvaluateError(`TypeSafe HTTP ${status}`, http);
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            throw new JevEvaluateError('TypeSafe HTTP response was not JSON', http);
+        }
+        return { answers: answersOf(parsed.answers ?? {}), http };
+    };
+}
+//# sourceMappingURL=evaluate.js.map

package/dist/intent/evaluate.js.map

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

package/dist/intent/http.d.ts

@@ -0,0 +1,8 @@
+export type JevHttpStats = {
+    status: number;
+    durationMs: number;
+    requestBytes: number;
+    responseBytes: number;
+};
+export declare function elapsedMs(started: number): number;
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/intent/http.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/intent/http.js

@@ -0,0 +1,4 @@
+export function elapsedMs(started) {
+    return Math.max(0, Date.now() - started);
+}
+//# sourceMappingURL=http.js.map

package/dist/intent/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/intent/http.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAA;AAC1C,CAAC"}

package/dist/intent/log.d.ts

@@ -0,0 +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: 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

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