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

package/dist/src/utils/tool-utils.test.js

@@ -4,83 +4,9 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { expect, describe, it } from 'vitest';
-import { doesToolInvocationMatch, getToolSuggestion, shouldHideToolCall, } from './tool-utils.js';
-import { ReadFileTool, ApprovalMode, CoreToolCallStatus, ASK_USER_DISPLAY_NAME, WRITE_FILE_DISPLAY_NAME, EDIT_DISPLAY_NAME, READ_FILE_DISPLAY_NAME, } from '../index.js';
+import { doesToolInvocationMatch, getToolSuggestion } from './tool-utils.js';
+import { ReadFileTool } from '../index.js';
 import { createMockMessageBus } from '../test-utils/mock-message-bus.js';
-describe('shouldHideToolCall', () => {
-    it.each([
-        {
-            status: CoreToolCallStatus.Scheduled,
-            hasResult: true,
-            shouldHide: true,
-        },
-        {
-            status: CoreToolCallStatus.Executing,
-            hasResult: true,
-            shouldHide: true,
-        },
-        {
-            status: CoreToolCallStatus.AwaitingApproval,
-            hasResult: true,
-            shouldHide: true,
-        },
-        {
-            status: CoreToolCallStatus.Validating,
-            hasResult: true,
-            shouldHide: true,
-        },
-        {
-            status: CoreToolCallStatus.Success,
-            hasResult: true,
-            shouldHide: false,
-        },
-        {
-            status: CoreToolCallStatus.Error,
-            hasResult: false,
-            shouldHide: true,
-        },
-        {
-            status: CoreToolCallStatus.Error,
-            hasResult: true,
-            shouldHide: false,
-        },
-    ])('AskUser: status=$status, hasResult=$hasResult -> hide=$shouldHide', ({ status, hasResult, shouldHide }) => {
-        expect(shouldHideToolCall({
-            displayName: ASK_USER_DISPLAY_NAME,
-            status,
-            hasResultDisplay: hasResult,
-        })).toBe(shouldHide);
-    });
-    it.each([
-        {
-            name: WRITE_FILE_DISPLAY_NAME,
-            mode: ApprovalMode.PLAN,
-            visible: false,
-        },
-        { name: EDIT_DISPLAY_NAME, mode: ApprovalMode.PLAN, visible: false },
-        {
-            name: WRITE_FILE_DISPLAY_NAME,
-            mode: ApprovalMode.DEFAULT,
-            visible: true,
-        },
-        { name: READ_FILE_DISPLAY_NAME, mode: ApprovalMode.PLAN, visible: true },
-    ])('Plan Mode: tool=$name, mode=$mode -> visible=$visible', ({ name, mode, visible }) => {
-        expect(shouldHideToolCall({
-            displayName: name,
-            status: CoreToolCallStatus.Success,
-            approvalMode: mode,
-            hasResultDisplay: true,
-        })).toBe(!visible);
-    });
-    it('hides tool calls with a parentCallId', () => {
-        expect(shouldHideToolCall({
-            displayName: 'any_tool',
-            status: CoreToolCallStatus.Success,
-            hasResultDisplay: true,
-            parentCallId: 'some-parent',
-        })).toBe(true);
-    });
-});
 describe('getToolSuggestion', () => {
     it('should suggest the top N closest tool names for a typo', () => {
         const allToolNames = ['list_files', 'read_file', 'write_file'];

package/dist/src/utils/tool-utils.test.js.map

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

package/dist/src/utils/tool-visibility.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ApprovalMode } from '../policy/types.js';
+import { CoreToolCallStatus, type ToolCall } from '../scheduler/types.js';
+export interface ToolVisibilityContext {
+    /** The internal name of the tool. */
+    name: string;
+    /** The display name of the tool. */
+    displayName?: string;
+    /** The current status of the tool call. */
+    status: CoreToolCallStatus;
+    /** The approval mode active when the tool was called. */
+    approvalMode?: ApprovalMode;
+    /** Whether the tool has produced a result for display (e.g., resultDisplay or liveOutput). */
+    hasResult: boolean;
+    /** The ID of the parent tool call, if any. */
+    parentCallId?: string;
+    /** True if the tool was initiated directly by the user via a slash command. */
+    isClientInitiated?: boolean;
+}
+/**
+ * Maps a core ToolCall to a ToolVisibilityContext.
+ */
+export declare function buildToolVisibilityContext(tc: ToolCall): ToolVisibilityContext;
+/**
+ * Determines if a tool should ever appear as a completed block in the main chat log.
+ */
+export declare function isRenderedInHistory(ctx: ToolVisibilityContext): boolean;
+/**
+ * Determines if a tool belongs in the Awaiting Approval confirmation queue.
+ */
+export declare function belongsInConfirmationQueue(ctx: ToolVisibilityContext): boolean;
+/**
+ * Determines if a tool should be actively rendered in the dynamic ToolGroupMessage UI right now.
+ * This takes into account current execution states and UI settings.
+ */
+export declare function isVisibleInToolGroup(ctx: ToolVisibilityContext, errorVerbosity: 'full' | 'low'): boolean;

package/dist/src/utils/tool-visibility.js

@@ -0,0 +1,111 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ApprovalMode } from '../policy/types.js';
+import { CoreToolCallStatus } from '../scheduler/types.js';
+import { ASK_USER_DISPLAY_NAME, WRITE_FILE_DISPLAY_NAME, EDIT_DISPLAY_NAME, UPDATE_TOPIC_TOOL_NAME, UPDATE_TOPIC_DISPLAY_NAME, } from '../tools/tool-names.js';
+/**
+ * Maps a core ToolCall to a ToolVisibilityContext.
+ */
+export function buildToolVisibilityContext(tc) {
+    let hasResult = false;
+    if (tc.status === CoreToolCallStatus.Success ||
+        tc.status === CoreToolCallStatus.Error ||
+        tc.status === CoreToolCallStatus.Cancelled) {
+        hasResult = !!tc.response.resultDisplay;
+    }
+    else if (tc.status === CoreToolCallStatus.Executing) {
+        hasResult = !!tc.liveOutput;
+    }
+    return {
+        name: tc.request.name,
+        displayName: tc.tool?.displayName ?? tc.request.name,
+        status: tc.status,
+        approvalMode: tc.approvalMode,
+        hasResult,
+        parentCallId: tc.request.parentCallId,
+        isClientInitiated: tc.request.isClientInitiated,
+    };
+}
+/**
+ * Determines if a tool should ever appear as a completed block in the main chat log.
+ */
+export function isRenderedInHistory(ctx) {
+    if (ctx.parentCallId) {
+        return false;
+    }
+    const displayName = ctx.displayName ?? ctx.name;
+    switch (displayName) {
+        case ASK_USER_DISPLAY_NAME:
+            // We only render AskUser in history if it errored with a result or succeeded.
+            // If it errored without a result, it was an internal validation failure.
+            if (ctx.status === CoreToolCallStatus.Error) {
+                return ctx.hasResult;
+            }
+            return ctx.status === CoreToolCallStatus.Success;
+        case WRITE_FILE_DISPLAY_NAME:
+        case EDIT_DISPLAY_NAME:
+            // In Plan Mode, edits are redundant because the plan shows the diffs.
+            return ctx.approvalMode !== ApprovalMode.PLAN;
+        default:
+            return true;
+    }
+}
+/**
+ * Determines if a tool belongs in the Awaiting Approval confirmation queue.
+ */
+export function belongsInConfirmationQueue(ctx) {
+    const displayName = ctx.displayName ?? ctx.name;
+    // Narrative background tools auto-execute and never require confirmation
+    if (ctx.name === UPDATE_TOPIC_TOOL_NAME ||
+        displayName === UPDATE_TOPIC_DISPLAY_NAME) {
+        return false;
+    }
+    // All other standard tools could theoretically require confirmation
+    return true;
+}
+/**
+ * Determines if a tool should be actively rendered in the dynamic ToolGroupMessage UI right now.
+ * This takes into account current execution states and UI settings.
+ */
+export function isVisibleInToolGroup(ctx, errorVerbosity) {
+    const displayName = ctx.displayName ?? ctx.name;
+    // Hide internal errors unless the user explicitly requested full verbosity
+    if (errorVerbosity === 'low' &&
+        ctx.status === CoreToolCallStatus.Error &&
+        !ctx.isClientInitiated) {
+        return false;
+    }
+    // We hide AskUser while it's in progress because it renders in its own modal.
+    // We also hide terminal states that don't meet history rendering criteria (e.g. errors without results).
+    if (displayName === ASK_USER_DISPLAY_NAME) {
+        switch (ctx.status) {
+            case CoreToolCallStatus.Scheduled:
+            case CoreToolCallStatus.Validating:
+            case CoreToolCallStatus.Executing:
+            case CoreToolCallStatus.AwaitingApproval:
+                return false;
+            case CoreToolCallStatus.Error:
+                return ctx.hasResult;
+            case CoreToolCallStatus.Success:
+                return true;
+            default:
+                return false;
+        }
+    }
+    // In Plan Mode, edits are redundant because the plan shows the diffs.
+    if ((displayName === WRITE_FILE_DISPLAY_NAME ||
+        displayName === EDIT_DISPLAY_NAME) &&
+        ctx.approvalMode === ApprovalMode.PLAN) {
+        return false;
+    }
+    // We hide confirming tools from the active group because they render in the
+    // ToolConfirmationQueue at the bottom of the screen instead.
+    if (ctx.status === CoreToolCallStatus.AwaitingApproval) {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=tool-visibility.js.map

package/dist/src/utils/tool-visibility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-visibility.js","sourceRoot":"","sources":["../../../src/utils/tool-visibility.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAiB,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAmBhC;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,EAAY;IAEZ,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IACE,EAAE,CAAC,MAAM,KAAK,kBAAkB,CAAC,OAAO;QACxC,EAAE,CAAC,MAAM,KAAK,kBAAkB,CAAC,KAAK;QACtC,EAAE,CAAC,MAAM,KAAK,kBAAkB,CAAC,SAAS,EAC1C,CAAC;QACD,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;IAC1C,CAAC;SAAM,IAAI,EAAE,CAAC,MAAM,KAAK,kBAAkB,CAAC,SAAS,EAAE,CAAC;QACtD,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC;IAC9B,CAAC;IAED,OAAO;QACL,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI;QACrB,WAAW,EAAE,EAAE,CAAC,IAAI,EAAE,WAAW,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI;QACpD,MAAM,EAAE,EAAE,CAAC,MAAM;QACjB,YAAY,EAAE,EAAE,CAAC,YAAY;QAC7B,SAAS;QACT,YAAY,EAAE,EAAE,CAAC,OAAO,CAAC,YAAY;QACrC,iBAAiB,EAAE,EAAE,CAAC,OAAO,CAAC,iBAAiB;KAChD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAA0B;IAC5D,IAAI,GAAG,CAAC,YAAY,EAAE,CAAC;QACrB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,IAAI,CAAC;IAEhD,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,qBAAqB;YACxB,8EAA8E;YAC9E,yEAAyE;YACzE,IAAI,GAAG,CAAC,MAAM,KAAK,kBAAkB,CAAC,KAAK,EAAE,CAAC;gBAC5C,OAAO,GAAG,CAAC,SAAS,CAAC;YACvB,CAAC;YACD,OAAO,GAAG,CAAC,MAAM,KAAK,kBAAkB,CAAC,OAAO,CAAC;QAEnD,KAAK,uBAAuB,CAAC;QAC7B,KAAK,iBAAiB;YACpB,sEAAsE;YACtE,OAAO,GAAG,CAAC,YAAY,KAAK,YAAY,CAAC,IAAI,CAAC;QAEhD;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CACxC,GAA0B;IAE1B,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,IAAI,CAAC;IAEhD,yEAAyE;IACzE,IACE,GAAG,CAAC,IAAI,KAAK,sBAAsB;QACnC,WAAW,KAAK,yBAAyB,EACzC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,oEAAoE;IACpE,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAA0B,EAC1B,cAA8B;IAE9B,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,IAAI,GAAG,CAAC,IAAI,CAAC;IAEhD,2EAA2E;IAC3E,IACE,cAAc,KAAK,KAAK;QACxB,GAAG,CAAC,MAAM,KAAK,kBAAkB,CAAC,KAAK;QACvC,CAAC,GAAG,CAAC,iBAAiB,EACtB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,8EAA8E;IAC9E,yGAAyG;IACzG,IAAI,WAAW,KAAK,qBAAqB,EAAE,CAAC;QAC1C,QAAQ,GAAG,CAAC,MAAM,EAAE,CAAC;YACnB,KAAK,kBAAkB,CAAC,SAAS,CAAC;YAClC,KAAK,kBAAkB,CAAC,UAAU,CAAC;YACnC,KAAK,kBAAkB,CAAC,SAAS,CAAC;YAClC,KAAK,kBAAkB,CAAC,gBAAgB;gBACtC,OAAO,KAAK,CAAC;YACf,KAAK,kBAAkB,CAAC,KAAK;gBAC3B,OAAO,GAAG,CAAC,SAAS,CAAC;YACvB,KAAK,kBAAkB,CAAC,OAAO;gBAC7B,OAAO,IAAI,CAAC;YACd;gBACE,OAAO,KAAK,CAAC;QACjB,CAAC;IACH,CAAC;IAED,sEAAsE;IACtE,IACE,CAAC,WAAW,KAAK,uBAAuB;QACtC,WAAW,KAAK,iBAAiB,CAAC;QACpC,GAAG,CAAC,YAAY,KAAK,YAAY,CAAC,IAAI,EACtC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,4EAA4E;IAC5E,6DAA6D;IAC7D,IAAI,GAAG,CAAC,MAAM,KAAK,kBAAkB,CAAC,gBAAgB,EAAE,CAAC;QACvD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/utils/tool-visibility.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/utils/tool-visibility.test.js

@@ -0,0 +1,96 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { expect, describe, it } from 'vitest';
+import { isRenderedInHistory, belongsInConfirmationQueue, isVisibleInToolGroup, } from './tool-visibility.js';
+import { CoreToolCallStatus } from '../scheduler/types.js';
+import { ApprovalMode } from '../policy/types.js';
+import { ASK_USER_DISPLAY_NAME, WRITE_FILE_DISPLAY_NAME, EDIT_DISPLAY_NAME, UPDATE_TOPIC_TOOL_NAME, READ_FILE_DISPLAY_NAME, } from '../tools/tool-names.js';
+describe('ToolVisibility Rules', () => {
+    const createCtx = (overrides = {}) => ({
+        name: 'some_tool',
+        displayName: 'Some Tool',
+        status: CoreToolCallStatus.Success,
+        hasResult: true,
+        parentCallId: undefined,
+        isClientInitiated: false,
+        ...overrides,
+    });
+    describe('isRenderedInHistory', () => {
+        it('hides tools with parents', () => {
+            expect(isRenderedInHistory(createCtx({ parentCallId: 'parent-123' }))).toBe(false);
+        });
+        it('hides AskUser errors without results', () => {
+            expect(isRenderedInHistory(createCtx({
+                displayName: ASK_USER_DISPLAY_NAME,
+                status: CoreToolCallStatus.Error,
+                hasResult: false,
+            }))).toBe(false);
+        });
+        it('shows AskUser success', () => {
+            expect(isRenderedInHistory(createCtx({
+                displayName: ASK_USER_DISPLAY_NAME,
+                status: CoreToolCallStatus.Success,
+            }))).toBe(true);
+        });
+        it('hides WriteFile/Edit in Plan Mode', () => {
+            expect(isRenderedInHistory(createCtx({
+                displayName: WRITE_FILE_DISPLAY_NAME,
+                approvalMode: ApprovalMode.PLAN,
+            }))).toBe(false);
+            expect(isRenderedInHistory(createCtx({
+                displayName: EDIT_DISPLAY_NAME,
+                approvalMode: ApprovalMode.PLAN,
+            }))).toBe(false);
+        });
+        it('shows ReadFile in Plan Mode', () => {
+            expect(isRenderedInHistory(createCtx({
+                displayName: READ_FILE_DISPLAY_NAME,
+                approvalMode: ApprovalMode.PLAN,
+            }))).toBe(true);
+        });
+    });
+    describe('belongsInConfirmationQueue', () => {
+        it('returns false for update_topic', () => {
+            expect(belongsInConfirmationQueue(createCtx({ name: UPDATE_TOPIC_TOOL_NAME }))).toBe(false);
+        });
+        it('returns true for standard tools', () => {
+            expect(belongsInConfirmationQueue(createCtx({ name: 'write_file' }))).toBe(true);
+        });
+    });
+    describe('isVisibleInToolGroup', () => {
+        it('shows tools with parents (agent tools)', () => {
+            expect(isVisibleInToolGroup(createCtx({ parentCallId: 'parent-123' }), 'full')).toBe(true);
+        });
+        it('hides WriteFile/Edit in Plan Mode', () => {
+            expect(isVisibleInToolGroup(createCtx({
+                displayName: WRITE_FILE_DISPLAY_NAME,
+                approvalMode: ApprovalMode.PLAN,
+            }), 'full')).toBe(false);
+        });
+        it('hides non-client-initiated errors on low verbosity', () => {
+            expect(isVisibleInToolGroup(createCtx({
+                status: CoreToolCallStatus.Error,
+                isClientInitiated: false,
+            }), 'low')).toBe(false);
+        });
+        it('shows non-client-initiated errors on full verbosity', () => {
+            expect(isVisibleInToolGroup(createCtx({
+                status: CoreToolCallStatus.Error,
+                isClientInitiated: false,
+            }), 'full')).toBe(true);
+        });
+        it('hides confirming tools', () => {
+            expect(isVisibleInToolGroup(createCtx({ status: CoreToolCallStatus.AwaitingApproval }), 'full')).toBe(false);
+        });
+        it('hides AskUser while in progress', () => {
+            expect(isVisibleInToolGroup(createCtx({
+                displayName: ASK_USER_DISPLAY_NAME,
+                status: CoreToolCallStatus.Executing,
+            }), 'full')).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=tool-visibility.test.js.map

package/dist/src/utils/tool-visibility.test.js.map

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

package/dist/src/utils/trust.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare enum TrustLevel {
+    TRUST_FOLDER = "TRUST_FOLDER",
+    TRUST_PARENT = "TRUST_PARENT",
+    DO_NOT_TRUST = "DO_NOT_TRUST"
+}
+export interface TrustResult {
+    isTrusted: boolean | undefined;
+    source: 'ide' | 'file' | 'env' | undefined;
+}
+export interface TrustOptions {
+    path: string;
+    isFolderTrustEnabled: boolean;
+    isHeadless?: boolean;
+}
+export declare function isTrustLevel(value: unknown): value is TrustLevel;
+/**
+ * Checks if a path is trusted based on headless mode, folder trust settings,
+ * IDE context, and local configuration file.
+ */
+export declare function checkPathTrust(options: TrustOptions): TrustResult;
+export interface TrustRule {
+    path: string;
+    trustLevel: TrustLevel;
+}
+export interface TrustedFoldersError {
+    message: string;
+    path: string;
+}
+export interface TrustedFoldersFile {
+    config: Record<string, TrustLevel>;
+    path: string;
+}
+/**
+ * FOR TESTING PURPOSES ONLY.
+ * Clears the real path cache.
+ */
+export declare function clearRealPathCacheForTesting(): void;
+export declare class LoadedTrustedFolders {
+    readonly user: TrustedFoldersFile;
+    readonly errors: TrustedFoldersError[];
+    constructor(user: TrustedFoldersFile, errors: TrustedFoldersError[]);
+    get rules(): TrustRule[];
+    /**
+     * Returns true or false if the path should be "trusted" based on the configuration.
+     *
+     * @param location path
+     * @param config optional config override
+     * @returns boolean if trusted/distrusted, undefined if no rule matches
+     */
+    isPathTrusted(location: string, config?: Record<string, TrustLevel>): boolean | undefined;
+    setValue(folderPath: string, trustLevel: TrustLevel): Promise<void>;
+}
+/**
+ * FOR TESTING PURPOSES ONLY.
+ * Resets the in-memory cache of the trusted folders configuration.
+ */
+export declare function resetTrustedFoldersForTesting(): void;
+export declare function loadTrustedFolders(): LoadedTrustedFolders;
+export declare function saveTrustedFolders(trustedFoldersFile: TrustedFoldersFile): void;