@machina.ai/cell-cli-core 1.36.0-rc1 → 1.38.1-rc2

package/dist/src/agents/browser/snapshotSuperseder.js

@@ -0,0 +1,101 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { debugLogger } from '../../utils/debugLogger.js';
+const TAKE_SNAPSHOT_TOOL_NAME = 'take_snapshot';
+/**
+ * Placeholder that replaces superseded snapshot outputs.
+ * Kept short to minimise token cost while still being informative.
+ */
+export const SNAPSHOT_SUPERSEDED_PLACEHOLDER = '[Snapshot superseded — a newer snapshot exists later in this conversation. ' +
+    'Call take_snapshot for current page state.]';
+/**
+ * Scans the chat history and replaces all but the most recent
+ * `take_snapshot` `functionResponse` with a compact placeholder.
+ *
+ * No-ops when:
+ * - There are fewer than 2 snapshots (nothing to supersede).
+ * - All prior snapshots have already been superseded.
+ *
+ * Uses {@link GeminiChat.setHistory} to apply the modified history.
+ */
+export function supersedeStaleSnapshots(chat) {
+    const history = chat.getHistory();
+    // Locate all (contentIndex, partIndex) tuples for take_snapshot responses.
+    const snapshotLocations = [];
+    for (let i = 0; i < history.length; i++) {
+        const parts = history[i].parts;
+        if (!parts)
+            continue;
+        for (let j = 0; j < parts.length; j++) {
+            const part = parts[j];
+            if (part.functionResponse &&
+                part.functionResponse.name === TAKE_SNAPSHOT_TOOL_NAME) {
+                snapshotLocations.push({ contentIdx: i, partIdx: j });
+            }
+        }
+    }
+    // Nothing to do if there are 0 or 1 snapshots.
+    if (snapshotLocations.length < 2) {
+        return;
+    }
+    // Check whether any stale snapshot actually needs replacement.
+    // (Skip the last entry — that's the one we keep.)
+    const staleLocations = snapshotLocations.slice(0, -1);
+    const needsUpdate = staleLocations.some(({ contentIdx, partIdx }) => {
+        const output = getResponseOutput(history[contentIdx].parts[partIdx].functionResponse?.response);
+        return !output.includes(SNAPSHOT_SUPERSEDED_PLACEHOLDER);
+    });
+    if (!needsUpdate) {
+        return;
+    }
+    // Shallow-copy the history and replace stale snapshots.
+    const newHistory = history.map((content) => ({
+        ...content,
+        parts: content.parts ? [...content.parts] : undefined,
+    }));
+    let replacedCount = 0;
+    for (const { contentIdx, partIdx } of staleLocations) {
+        const originalPart = newHistory[contentIdx].parts[partIdx];
+        if (!originalPart.functionResponse)
+            continue;
+        // Check if already superseded
+        const output = getResponseOutput(originalPart.functionResponse.response);
+        if (output.includes(SNAPSHOT_SUPERSEDED_PLACEHOLDER)) {
+            continue;
+        }
+        const replacementPart = {
+            functionResponse: {
+                // eslint-disable-next-line @typescript-eslint/no-misused-spread
+                ...originalPart.functionResponse,
+                response: { output: SNAPSHOT_SUPERSEDED_PLACEHOLDER },
+            },
+        };
+        newHistory[contentIdx].parts[partIdx] = replacementPart;
+        replacedCount++;
+    }
+    if (replacedCount > 0) {
+        chat.setHistory(newHistory);
+        debugLogger.log(`[SnapshotSuperseder] Replaced ${replacedCount} stale take_snapshot output(s).`);
+    }
+}
+function isResponseWithOutput(response) {
+    return (response !== null &&
+        response !== undefined &&
+        'output' in response &&
+        typeof response.output === 'string');
+}
+/**
+ * Safely extracts the `output` string from a functionResponse.response object.
+ * The GenAI SDK types `response` as `object | undefined`, so we need runtime
+ * checks to access the `output` field.
+ */
+function getResponseOutput(response) {
+    if (isResponseWithOutput(response)) {
+        return response.output;
+    }
+    return '';
+}
+//# sourceMappingURL=snapshotSuperseder.js.map

package/dist/src/agents/browser/snapshotSuperseder.js.map

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

package/dist/src/agents/browser/snapshotSuperseder.test.js

@@ -0,0 +1,158 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { supersedeStaleSnapshots, SNAPSHOT_SUPERSEDED_PLACEHOLDER, } from './snapshotSuperseder.js';
+/** Builds a minimal mock GeminiChat around a mutable history array. */
+function createMockChat(history) {
+    return {
+        getHistory: vi.fn(() => [...history]),
+        setHistory: vi.fn((newHistory) => {
+            history.length = 0;
+            history.push(...newHistory);
+        }),
+    };
+}
+/** Helper: creates a take_snapshot functionResponse part. */
+function snapshotResponse(output) {
+    return {
+        functionResponse: {
+            name: 'take_snapshot',
+            response: { output },
+        },
+    };
+}
+/** Helper: creates a non-snapshot functionResponse part. */
+function otherToolResponse(name, output) {
+    return {
+        functionResponse: {
+            name,
+            response: { output },
+        },
+    };
+}
+describe('supersedeStaleSnapshots', () => {
+    let history;
+    let chat;
+    beforeEach(() => {
+        history = [];
+    });
+    it('should no-op when history has no snapshots', () => {
+        history.push({ role: 'user', parts: [{ text: 'Click the button' }] }, {
+            role: 'user',
+            parts: [otherToolResponse('click', 'Clicked element')],
+        });
+        chat = createMockChat(history);
+        supersedeStaleSnapshots(chat);
+        expect(chat.setHistory).not.toHaveBeenCalled();
+    });
+    it('should no-op when history has exactly 1 snapshot', () => {
+        history.push({ role: 'user', parts: [{ text: 'Navigate to page' }] }, {
+            role: 'user',
+            parts: [snapshotResponse('<tree>big accessibility tree</tree>')],
+        });
+        chat = createMockChat(history);
+        supersedeStaleSnapshots(chat);
+        expect(chat.setHistory).not.toHaveBeenCalled();
+    });
+    it('should replace all but the last snapshot when there are 2+', () => {
+        history.push({
+            role: 'user',
+            parts: [snapshotResponse('<tree>snapshot 1</tree>')],
+        }, {
+            role: 'user',
+            parts: [otherToolResponse('click', 'Clicked OK')],
+        }, {
+            role: 'user',
+            parts: [snapshotResponse('<tree>snapshot 2</tree>')],
+        }, {
+            role: 'user',
+            parts: [otherToolResponse('type_text', 'Typed hello')],
+        }, {
+            role: 'user',
+            parts: [snapshotResponse('<tree>snapshot 3 (latest)</tree>')],
+        });
+        chat = createMockChat(history);
+        supersedeStaleSnapshots(chat);
+        expect(chat.setHistory).toHaveBeenCalledTimes(1);
+        // First two snapshots should be replaced
+        const part0 = history[0].parts[0];
+        expect(part0.functionResponse?.response).toEqual({
+            output: SNAPSHOT_SUPERSEDED_PLACEHOLDER,
+        });
+        const part2 = history[2].parts[0];
+        expect(part2.functionResponse?.response).toEqual({
+            output: SNAPSHOT_SUPERSEDED_PLACEHOLDER,
+        });
+        // Last snapshot should be untouched
+        const part4 = history[4].parts[0];
+        expect(part4.functionResponse?.response).toEqual({
+            output: '<tree>snapshot 3 (latest)</tree>',
+        });
+    });
+    it('should leave non-snapshot tool responses untouched', () => {
+        history.push({
+            role: 'user',
+            parts: [snapshotResponse('<tree>snapshot A</tree>')],
+        }, {
+            role: 'user',
+            parts: [otherToolResponse('click', 'Clicked button')],
+        }, {
+            role: 'user',
+            parts: [snapshotResponse('<tree>snapshot B (latest)</tree>')],
+        });
+        chat = createMockChat(history);
+        supersedeStaleSnapshots(chat);
+        // click response should be untouched
+        const clickPart = history[1].parts[0];
+        expect(clickPart.functionResponse?.response).toEqual({
+            output: 'Clicked button',
+        });
+    });
+    it('should no-op when all stale snapshots are already superseded', () => {
+        history.push({
+            role: 'user',
+            parts: [snapshotResponse(SNAPSHOT_SUPERSEDED_PLACEHOLDER)],
+        }, {
+            role: 'user',
+            parts: [snapshotResponse('<tree>current snapshot</tree>')],
+        });
+        chat = createMockChat(history);
+        supersedeStaleSnapshots(chat);
+        // Should not call setHistory since nothing changed
+        expect(chat.setHistory).not.toHaveBeenCalled();
+    });
+    it('should handle snapshots in Content entries with multiple parts', () => {
+        history.push({
+            role: 'user',
+            parts: [
+                otherToolResponse('click', 'Clicked'),
+                snapshotResponse('<tree>snapshot in multi-part</tree>'),
+            ],
+        }, {
+            role: 'user',
+            parts: [snapshotResponse('<tree>latest snapshot</tree>')],
+        });
+        chat = createMockChat(history);
+        supersedeStaleSnapshots(chat);
+        expect(chat.setHistory).toHaveBeenCalledTimes(1);
+        // The click response (index 0 of parts) should be untouched
+        const clickPart = history[0].parts[0];
+        expect(clickPart.functionResponse?.response).toEqual({
+            output: 'Clicked',
+        });
+        // The snapshot (index 1 of parts) should be replaced
+        const snapshotPart = history[0].parts[1];
+        expect(snapshotPart.functionResponse?.response).toEqual({
+            output: SNAPSHOT_SUPERSEDED_PLACEHOLDER,
+        });
+        // Latest snapshot untouched
+        const latestPart = history[1].parts[0];
+        expect(latestPart.functionResponse?.response).toEqual({
+            output: '<tree>latest snapshot</tree>',
+        });
+    });
+});
+//# sourceMappingURL=snapshotSuperseder.test.js.map

package/dist/src/agents/browser/snapshotSuperseder.test.js.map

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

package/dist/src/agents/local-executor.d.ts

@@ -73,6 +73,7 @@ export declare class LocalAgentExecutor<TOutput extends z.ZodTypeAny> {
      * @returns A promise that resolves to the agent's final output.
      */
     run(inputs: AgentInputs, signal: AbortSignal): Promise<OutputObject>;
+    private runInternal;
     private tryCompressChat;
     /**
      * Calls the generative model with the current context and tools.
@@ -110,4 +111,12 @@ export declare class LocalAgentExecutor<TOutput extends z.ZodTypeAny> {
     private checkTermination;
     /** Emits an activity event to the configured callback. */
     private emitActivity;
+    /**
+     * Truncates a string to 200 characters in a Unicode-safe way for session summaries.
+     */
+    private getTruncatedSummary;
+    /**
+     * Parses the arguments for a tool call, handling both JSON strings and objects.
+     */
+    private parseToolArguments;
 }