@mseep/clawdcursor 1.5.5

package/dist/core/agent-loop/project-mcp.d.ts

@@ -0,0 +1,97 @@
+/**
+ * project-mcp.ts — Project System B (agent-loop) UnifiedTools onto the
+ * System A (MCP/REST) ToolDefinition surface.
+ *
+ * PURELY ADDITIVE. This module is not yet imported by any production path.
+ * Wire-in happens in a later step (Step 3).
+ *
+ * The three public exports:
+ *
+ *   jsonSchemaToParamDefs(inputSchema)
+ *     Convert a UnifiedTool.inputSchema (raw JSON Schema object) into the
+ *     Record<string, ParameterDef> shape ToolDefinition expects.
+ *
+ *   toolContextToAgent(ctx)
+ *     Build a synthetic AgentToolContext from a ToolContext so a projected
+ *     handler can call the System B execute() function.
+ *
+ *   unifiedToToolResult(r)
+ *     Map a UnifiedToolResult back to the ToolResult shape the MCP surface
+ *     expects, including base64-encoding any screenshot.
+ *
+ *   projectToToolDefinition(t)
+ *     Assemble a complete ToolDefinition from a UnifiedTool + TOOL_META.
+ *     The handler bridges ToolContext → AgentToolContext → UnifiedToolResult →
+ *     ToolResult in a single async call.
+ */
+import type { UnifiedTool, UnifiedToolResult, AgentToolContext } from './types';
+import type { ToolDefinition, ToolContext, ToolResult, ParameterDef } from '../../tools/types';
+/**
+ * Convert a UnifiedTool JSON-Schema inputSchema into the
+ * Record<string, ParameterDef> shape that ToolDefinition.parameters expects.
+ *
+ * Supported JSON Schema property types: "string" | "number" | "boolean" | "array".
+ * Properties missing a supported type default to "string" with a note.
+ * The `required` array in the schema is used to set ParameterDef.required.
+ * `enum` is preserved when all values are strings.
+ *
+ * Description resolution order (per parameter):
+ *   1. System B inputSchema property's own description (if non-empty).
+ *   2. `paramDescriptions[key]` harvested from the corresponding System A
+ *      ToolDefinition (passed as the optional second argument).
+ *   3. Empty string fallback.
+ *
+ * @param inputSchema - The raw JSON Schema object from UnifiedTool.inputSchema.
+ * @param paramDescriptions - Optional per-parameter fallback descriptions
+ *   harvested from the System A ToolDefinition (TOOL_META[name].paramDescriptions).
+ * @returns A Record mapping parameter names to ParameterDef instances.
+ */
+export declare function jsonSchemaToParamDefs(inputSchema: UnifiedTool['inputSchema'], paramDescriptions?: Record<string, string>): Record<string, ParameterDef>;
+/**
+ * Build a synthetic AgentToolContext from a ToolContext.
+ *
+ * Called once per projected handler invocation. Awaits
+ * ctx.ensureInitialized() first to guarantee subsystems are ready
+ * before the System B tool execute() accesses ctx.platform.*.
+ *
+ * Fields that are absent from ToolContext (task, mode, screenshotsCaptured)
+ * are given safe neutral defaults so the System B tools don't crash.
+ *
+ * @param ctx - The ToolContext injected by the MCP server / REST handler.
+ * @returns A fully populated AgentToolContext ready for System B tool execute().
+ */
+export declare function toolContextToAgent(ctx: ToolContext): Promise<AgentToolContext>;
+/**
+ * Convert a UnifiedToolResult to the ToolResult shape the MCP surface expects.
+ *
+ * - success=false maps to isError=true.
+ * - screenshot (ScreenshotResult with a Buffer) is base64-encoded and returned
+ *   as { data, mimeType } in the image field — mirroring how the agent loop
+ *   and the existing MCP server serialize images.
+ * - All other UnifiedToolResult fields (stop, terminalExit, targetLabel) are
+ *   consumed internally and not forwarded — they are agent-loop concerns.
+ *
+ * @param r - The UnifiedToolResult from a System B tool execute() call.
+ * @returns A ToolResult ready for the MCP / REST transport.
+ */
+export declare function unifiedToToolResult(r: UnifiedToolResult): ToolResult;
+/**
+ * Project a System B UnifiedTool into a System A ToolDefinition.
+ *
+ * Assembles:
+ *   - name: TOOL_META[t.name].mcpName ?? t.name
+ *   - description: t.description (System B already has good descriptions)
+ *   - parameters: via jsonSchemaToParamDefs(t.inputSchema)
+ *   - category, compactGroup, safetyTier, costClass, cheaperAlternatives: from TOOL_META
+ *   - handler: bridges ToolContext → AgentToolContext → t.execute() → ToolResult
+ *
+ * Terminal actions (done, give_up, cannot_read) and vision compound tools
+ * (mouse, keyboard, window) should NOT be passed to this function — they have
+ * no counterpart on the MCP surface or have their own projection path.
+ *
+ * Throws if t.name has no TOOL_META entry (enforced by the coverage test).
+ *
+ * @param t - A UnifiedTool from buildUnifiedTools().
+ * @returns A fully populated ToolDefinition ready for getTools() or direct MCP use.
+ */
+export declare function projectToToolDefinition(t: UnifiedTool): ToolDefinition;

package/dist/core/agent-loop/project-mcp.js

@@ -0,0 +1,253 @@
+"use strict";
+/**
+ * project-mcp.ts — Project System B (agent-loop) UnifiedTools onto the
+ * System A (MCP/REST) ToolDefinition surface.
+ *
+ * PURELY ADDITIVE. This module is not yet imported by any production path.
+ * Wire-in happens in a later step (Step 3).
+ *
+ * The three public exports:
+ *
+ *   jsonSchemaToParamDefs(inputSchema)
+ *     Convert a UnifiedTool.inputSchema (raw JSON Schema object) into the
+ *     Record<string, ParameterDef> shape ToolDefinition expects.
+ *
+ *   toolContextToAgent(ctx)
+ *     Build a synthetic AgentToolContext from a ToolContext so a projected
+ *     handler can call the System B execute() function.
+ *
+ *   unifiedToToolResult(r)
+ *     Map a UnifiedToolResult back to the ToolResult shape the MCP surface
+ *     expects, including base64-encoding any screenshot.
+ *
+ *   projectToToolDefinition(t)
+ *     Assemble a complete ToolDefinition from a UnifiedTool + TOOL_META.
+ *     The handler bridges ToolContext → AgentToolContext → UnifiedToolResult →
+ *     ToolResult in a single async call.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsonSchemaToParamDefs = jsonSchemaToParamDefs;
+exports.toolContextToAgent = toolContextToAgent;
+exports.unifiedToToolResult = unifiedToToolResult;
+exports.projectToToolDefinition = projectToToolDefinition;
+const tool_meta_1 = require("./tool-meta");
+const reactive_check_1 = require("../sense/reactive-check");
+const ocr_engine_1 = require("../../platform/ocr-engine");
+// Lazy OCR singleton for ocr_contains assertions in MCP-route expect checks.
+let _mcpOcr = null;
+function mcpOcr() { return (_mcpOcr ??= new ocr_engine_1.OcrEngine()); }
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+/**
+ * Convert a UnifiedTool JSON-Schema inputSchema into the
+ * Record<string, ParameterDef> shape that ToolDefinition.parameters expects.
+ *
+ * Supported JSON Schema property types: "string" | "number" | "boolean" | "array".
+ * Properties missing a supported type default to "string" with a note.
+ * The `required` array in the schema is used to set ParameterDef.required.
+ * `enum` is preserved when all values are strings.
+ *
+ * Description resolution order (per parameter):
+ *   1. System B inputSchema property's own description (if non-empty).
+ *   2. `paramDescriptions[key]` harvested from the corresponding System A
+ *      ToolDefinition (passed as the optional second argument).
+ *   3. Empty string fallback.
+ *
+ * @param inputSchema - The raw JSON Schema object from UnifiedTool.inputSchema.
+ * @param paramDescriptions - Optional per-parameter fallback descriptions
+ *   harvested from the System A ToolDefinition (TOOL_META[name].paramDescriptions).
+ * @returns A Record mapping parameter names to ParameterDef instances.
+ */
+function jsonSchemaToParamDefs(inputSchema, paramDescriptions) {
+    const result = {};
+    const props = inputSchema.properties ?? {};
+    const required = new Set(inputSchema.required ?? []);
+    for (const [key, raw] of Object.entries(props)) {
+        const prop = raw;
+        const rawType = typeof prop.type === 'string' ? prop.type : 'string';
+        // Narrow to ParameterDef's allowed types; fall back to 'string'.
+        const type = rawType === 'number' || rawType === 'boolean' || rawType === 'array' ? rawType : 'string';
+        // Prefer System B's own description; fall back to harvested System A description.
+        const ownDescription = typeof prop.description === 'string' ? prop.description : '';
+        const description = ownDescription || paramDescriptions?.[key] || '';
+        const def = {
+            type,
+            description,
+            required: required.has(key),
+        };
+        // Preserve the element schema for array params (ParameterDef.items),
+        // e.g. verify's `assertions: {type:'array', items:{type:'object'}}`.
+        if (type === 'array' && prop.items && typeof prop.items === 'object') {
+            def.items = prop.items;
+        }
+        // Preserve enum when all values are strings (ParameterDef only supports string enum).
+        if (Array.isArray(prop.enum)) {
+            const strEnum = prop.enum.filter(v => typeof v === 'string');
+            if (strEnum.length > 0)
+                def.enum = strEnum;
+        }
+        // Preserve numeric constraints.
+        if (typeof prop.minimum === 'number')
+            def.minimum = prop.minimum;
+        if (typeof prop.maximum === 'number')
+            def.maximum = prop.maximum;
+        result[key] = def;
+    }
+    return result;
+}
+/**
+ * Build a synthetic AgentToolContext from a ToolContext.
+ *
+ * Called once per projected handler invocation. Awaits
+ * ctx.ensureInitialized() first to guarantee subsystems are ready
+ * before the System B tool execute() accesses ctx.platform.*.
+ *
+ * Fields that are absent from ToolContext (task, mode, screenshotsCaptured)
+ * are given safe neutral defaults so the System B tools don't crash.
+ *
+ * @param ctx - The ToolContext injected by the MCP server / REST handler.
+ * @returns A fully populated AgentToolContext ready for System B tool execute().
+ */
+async function toolContextToAgent(ctx) {
+    // Guarantee all subsystems are initialized (lazy init gate).
+    await ctx.ensureInitialized();
+    // Derive the platform adapter. The `platform` field was added in Tranche 1A
+    // and is present on every modern ToolContext. Guard defensively for tests.
+    const platform = ctx.platform;
+    if (!platform) {
+        throw new Error('toolContextToAgent: ctx.platform is not initialized. ' +
+            'Ensure clawdcursor is running with a supported OS adapter.');
+    }
+    // Derive screen dimensions. System B tools use ctx.screen for coordinate math.
+    // ToolContext exposes getScreenSize() on ctx.desktop (NativeDesktop).
+    let screen;
+    try {
+        const size = ctx.desktop.getScreenSize();
+        const msf = ctx.getMouseScaleFactor(); // image → logical (mouse) scale
+        const ssf = ctx.getScreenshotScaleFactor(); // image → physical pixel scale
+        // msf ≈ physicalWidth / imageWidth (typically 1 on standard, 2 on HiDPI).
+        // We reconstruct logical and physical from physical size + ratio.
+        const physicalWidth = size.width;
+        const physicalHeight = size.height;
+        // Logical = physical / DPI ratio. DPI ratio = physical / logical = ssf / msf.
+        // For the typical case both scale factors are 1, leaving logical == physical.
+        const dpiRatio = ssf > 0 ? ssf / msf : 1;
+        const logicalWidth = dpiRatio > 0 ? Math.round(physicalWidth / dpiRatio) : physicalWidth;
+        const logicalHeight = dpiRatio > 0 ? Math.round(physicalHeight / dpiRatio) : physicalHeight;
+        screen = { logicalWidth, logicalHeight, physicalWidth, physicalHeight, dpiRatio };
+    }
+    catch {
+        // Fallback to a sane default if getScreenSize throws (e.g. in tests).
+        screen = { logicalWidth: 1920, logicalHeight: 1080, physicalWidth: 1920, physicalHeight: 1080, dpiRatio: 1 };
+    }
+    return {
+        platform,
+        task: '', // No task context available in the MCP surface layer.
+        screen,
+        screenshotsCaptured: { n: 0 },
+        cdp: ctx.cdp ?? null,
+        targetWindow: undefined,
+        activeApp: undefined,
+        uiMaps: ctx.uiMaps,
+    };
+}
+/**
+ * Convert a UnifiedToolResult to the ToolResult shape the MCP surface expects.
+ *
+ * - success=false maps to isError=true.
+ * - screenshot (ScreenshotResult with a Buffer) is base64-encoded and returned
+ *   as { data, mimeType } in the image field — mirroring how the agent loop
+ *   and the existing MCP server serialize images.
+ * - All other UnifiedToolResult fields (stop, terminalExit, targetLabel) are
+ *   consumed internally and not forwarded — they are agent-loop concerns.
+ *
+ * @param r - The UnifiedToolResult from a System B tool execute() call.
+ * @returns A ToolResult ready for the MCP / REST transport.
+ */
+function unifiedToToolResult(r) {
+    const result = {
+        text: r.text,
+        isError: !r.success,
+    };
+    if (r.screenshot) {
+        // ScreenshotResult.buffer is a Buffer containing raw image bytes (PNG per
+        // the platform/types.ts interface; the agent loop captures via screenshot()
+        // which returns PNG). The MCP image field expects base64-encoded string data.
+        result.image = {
+            data: r.screenshot.buffer.toString('base64'),
+            mimeType: 'image/png',
+        };
+    }
+    return result;
+}
+/**
+ * Project a System B UnifiedTool into a System A ToolDefinition.
+ *
+ * Assembles:
+ *   - name: TOOL_META[t.name].mcpName ?? t.name
+ *   - description: t.description (System B already has good descriptions)
+ *   - parameters: via jsonSchemaToParamDefs(t.inputSchema)
+ *   - category, compactGroup, safetyTier, costClass, cheaperAlternatives: from TOOL_META
+ *   - handler: bridges ToolContext → AgentToolContext → t.execute() → ToolResult
+ *
+ * Terminal actions (done, give_up, cannot_read) and vision compound tools
+ * (mouse, keyboard, window) should NOT be passed to this function — they have
+ * no counterpart on the MCP surface or have their own projection path.
+ *
+ * Throws if t.name has no TOOL_META entry (enforced by the coverage test).
+ *
+ * @param t - A UnifiedTool from buildUnifiedTools().
+ * @returns A fully populated ToolDefinition ready for getTools() or direct MCP use.
+ */
+function projectToToolDefinition(t) {
+    const meta = tool_meta_1.TOOL_META[t.name];
+    if (!meta) {
+        throw new Error(`projectToToolDefinition: no TOOL_META entry for System B tool "${t.name}". ` +
+            'Add an entry to src/core/agent-loop/tool-meta.ts.');
+    }
+    const name = meta.mcpName ?? t.name;
+    const parameters = jsonSchemaToParamDefs(t.inputSchema, meta.paramDescriptions);
+    const handler = async (params, ctx) => {
+        const agentCtx = await toolContextToAgent(ctx);
+        let result = await t.execute(params, agentCtx);
+        const executed = result.success;
+        // Honor a caller-supplied `expect` assertion array. The projected schemas
+        // advertise it (same as the agent loop), so an external agent passing
+        // post-conditions over MCP must get them VERIFIED — they were silently
+        // dropped before (audit 2026-06-10, finding E). Hard check only: the
+        // loop-side soft "no observable change" net needs per-turn fingerprints
+        // the MCP route doesn't track.
+        if (params.expect !== undefined && params.expect !== null) {
+            const reactive = await (0, reactive_check_1.reactiveCheck)({
+                expect: params.expect,
+                toolText: result.text,
+                toolSuccess: result.success,
+                changesScreen: false,
+                observedChange: true,
+                adapter: agentCtx.platform,
+                ocrText: async () => (await mcpOcr().recognizeScreen()).fullText ?? '',
+            }).catch(() => null);
+            if (reactive)
+                result = { ...result, success: reactive.success, text: reactive.text };
+        }
+        // Invalidate the shared UIMap holder only when the screen-changing action
+        // actually TOOK (pre-expect outcome — a DEVIATION still means the input
+        // was dispatched). A rejected el_NN ref / failed dispatch changed nothing
+        // and must not stale a still-valid map (parity with the agent loop's
+        // outcome-gated invalidation; audit finding E/A1).
+        if (t.changesScreen && executed)
+            ctx.uiMaps?.invalidate();
+        return unifiedToToolResult(result);
+    };
+    return {
+        name,
+        description: t.description,
+        parameters,
+        category: meta.category,
+        compactGroup: meta.compactGroup,
+        safetyTier: meta.safetyTier,
+        costClass: meta.costClass,
+        cheaperAlternatives: meta.cheaperAlternatives,
+        handler,
+    };
+}
+//# sourceMappingURL=project-mcp.js.map

package/dist/core/agent-loop/project-mcp.js.map

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

package/dist/core/agent-loop/prompt.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Unified-agent system prompt + perception renderer.
+ *
+ * A single compact prompt (~70 lines) for the thin agent loop: accessibility-
+ * first, screenshot only on demand. No per-mode variation, no app-specific
+ * rules, no model names — the autonomous pipeline and its blind/hybrid/vision
+ * rungs were removed in v1.0.0 (a capable model is its own pipeline).
+ *
+ * Prompt-injection defense: screen content is wrapped in
+ * `<untrusted-screen-content>` delimiters and the prompt explicitly tells
+ * the model to treat anything inside as data, never as instructions.
+ */
+import type { AgentStep } from './types';
+import type { Snapshot } from '../sense/types';
+/**
+ * Wrap screen content in explicit delimiters to make prompt-injection defense
+ * auditable. Callers feed this into the user message, not the system prompt.
+ */
+export declare function wrapUntrustedScreenContent(text: string): string;
+/**
+ * Build the system prompt. Compact; kept under budget so the token budget
+ * goes to snapshots + tool results, not rules.
+ *
+ * The thin agent loop is accessibility-first: screenshot only on demand.
+ */
+export declare function buildSystemPrompt(): string;
+/**
+ * Render a Snapshot as compact text for the user message. Ranks by
+ * role-priority (rank.ts) so the most actionable elements survive
+ * truncation. Respects the secure-field redaction in the Snapshot type.
+ *
+ * Zero app-specific rules. A new LOB app follows the same a11y contract
+ * and renders cleanly.
+ */
+export declare function renderSnapshot(snapshot: Snapshot, opts?: {
+    elementCap?: number;
+    screenWidth?: number;
+    screenHeight?: number;
+    focusProcessId?: number;
+}): string;
+/**
+ * Build a compact recent-history line block for the user message.
+ * Keeps only the last `keep` turns to stay under the token budget.
+ */
+export declare function renderHistory(steps: AgentStep[], keep?: number): string;