@gajae-code/coding-agent 0.5.4 → 0.6.1

package/dist/types/tools/computer/render.d.ts

@@ -0,0 +1,17 @@
+import type { Component } from "@gajae-code/tui";
+import type { RenderResultOptions } from "../../extensibility/custom-tools/types";
+import type { Theme } from "../../modes/theme/theme";
+import type { ComputerToolDetails } from "../computer";
+export declare function summarizeComputerDetails(details: ComputerToolDetails | undefined, isError: boolean, theme: Theme): string;
+export declare const computerToolRenderer: {
+    renderCall(args: unknown, _options: RenderResultOptions, theme: Theme): Component;
+    renderResult(result: {
+        content: Array<{
+            type: string;
+            text?: string;
+        }>;
+        details?: unknown;
+        isError?: boolean;
+    }, _options: RenderResultOptions, theme: Theme): Component;
+    mergeCallAndResult: boolean;
+};

package/dist/types/tools/computer.d.ts

@@ -0,0 +1,465 @@
+import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@gajae-code/agent-core";
+import * as z from "zod/v4";
+import type { ToolSession } from "./index";
+import type { OutputMeta } from "./output-meta";
+export declare const singleComputerSchema: z.ZodDiscriminatedUnion<readonly [z.ZodObject<{
+    timeout: z.ZodOptional<z.ZodNumber>;
+    include_screenshot: z.ZodOptional<z.ZodBoolean>;
+    action: z.ZodLiteral<"screenshot">;
+}, z.core.$strict>, z.ZodObject<{
+    timeout: z.ZodOptional<z.ZodNumber>;
+    include_screenshot: z.ZodOptional<z.ZodBoolean>;
+    action: z.ZodLiteral<"click">;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    button: z.ZodOptional<z.ZodEnum<{
+        left: "left";
+        middle: "middle";
+        right: "right";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    timeout: z.ZodOptional<z.ZodNumber>;
+    include_screenshot: z.ZodOptional<z.ZodBoolean>;
+    action: z.ZodLiteral<"double_click">;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    button: z.ZodOptional<z.ZodEnum<{
+        left: "left";
+        middle: "middle";
+        right: "right";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    timeout: z.ZodOptional<z.ZodNumber>;
+    include_screenshot: z.ZodOptional<z.ZodBoolean>;
+    action: z.ZodLiteral<"move">;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    button: z.ZodOptional<z.ZodEnum<{
+        left: "left";
+        middle: "middle";
+        right: "right";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    timeout: z.ZodOptional<z.ZodNumber>;
+    include_screenshot: z.ZodOptional<z.ZodBoolean>;
+    action: z.ZodLiteral<"drag">;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    to_x: z.ZodNumber;
+    to_y: z.ZodNumber;
+    button: z.ZodOptional<z.ZodEnum<{
+        left: "left";
+        middle: "middle";
+        right: "right";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    timeout: z.ZodOptional<z.ZodNumber>;
+    include_screenshot: z.ZodOptional<z.ZodBoolean>;
+    action: z.ZodLiteral<"scroll">;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    scroll_x: z.ZodNumber;
+    scroll_y: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    timeout: z.ZodOptional<z.ZodNumber>;
+    include_screenshot: z.ZodOptional<z.ZodBoolean>;
+    action: z.ZodLiteral<"type">;
+    text: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    timeout: z.ZodOptional<z.ZodNumber>;
+    include_screenshot: z.ZodOptional<z.ZodBoolean>;
+    action: z.ZodLiteral<"keypress">;
+    keys: z.ZodArray<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    timeout: z.ZodOptional<z.ZodNumber>;
+    include_screenshot: z.ZodOptional<z.ZodBoolean>;
+    action: z.ZodLiteral<"wait">;
+    ms: z.ZodNumber;
+}, z.core.$strict>], "action">;
+export declare const computerSchema: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<readonly [z.ZodObject<{
+    timeout: z.ZodOptional<z.ZodNumber>;
+    include_screenshot: z.ZodOptional<z.ZodBoolean>;
+    action: z.ZodLiteral<"screenshot">;
+}, z.core.$strict>, z.ZodObject<{
+    timeout: z.ZodOptional<z.ZodNumber>;
+    include_screenshot: z.ZodOptional<z.ZodBoolean>;
+    action: z.ZodLiteral<"click">;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    button: z.ZodOptional<z.ZodEnum<{
+        left: "left";
+        middle: "middle";
+        right: "right";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    timeout: z.ZodOptional<z.ZodNumber>;
+    include_screenshot: z.ZodOptional<z.ZodBoolean>;
+    action: z.ZodLiteral<"double_click">;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    button: z.ZodOptional<z.ZodEnum<{
+        left: "left";
+        middle: "middle";
+        right: "right";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    timeout: z.ZodOptional<z.ZodNumber>;
+    include_screenshot: z.ZodOptional<z.ZodBoolean>;
+    action: z.ZodLiteral<"move">;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    button: z.ZodOptional<z.ZodEnum<{
+        left: "left";
+        middle: "middle";
+        right: "right";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    timeout: z.ZodOptional<z.ZodNumber>;
+    include_screenshot: z.ZodOptional<z.ZodBoolean>;
+    action: z.ZodLiteral<"drag">;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    to_x: z.ZodNumber;
+    to_y: z.ZodNumber;
+    button: z.ZodOptional<z.ZodEnum<{
+        left: "left";
+        middle: "middle";
+        right: "right";
+    }>>;
+}, z.core.$strict>, z.ZodObject<{
+    timeout: z.ZodOptional<z.ZodNumber>;
+    include_screenshot: z.ZodOptional<z.ZodBoolean>;
+    action: z.ZodLiteral<"scroll">;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    scroll_x: z.ZodNumber;
+    scroll_y: z.ZodNumber;
+}, z.core.$strict>, z.ZodObject<{
+    timeout: z.ZodOptional<z.ZodNumber>;
+    include_screenshot: z.ZodOptional<z.ZodBoolean>;
+    action: z.ZodLiteral<"type">;
+    text: z.ZodString;
+}, z.core.$strict>, z.ZodObject<{
+    timeout: z.ZodOptional<z.ZodNumber>;
+    include_screenshot: z.ZodOptional<z.ZodBoolean>;
+    action: z.ZodLiteral<"keypress">;
+    keys: z.ZodArray<z.ZodString>;
+}, z.core.$strict>, z.ZodObject<{
+    timeout: z.ZodOptional<z.ZodNumber>;
+    include_screenshot: z.ZodOptional<z.ZodBoolean>;
+    action: z.ZodLiteral<"wait">;
+    ms: z.ZodNumber;
+}, z.core.$strict>], "action">, z.ZodObject<{
+    timeout: z.ZodOptional<z.ZodNumber>;
+    include_screenshot: z.ZodOptional<z.ZodBoolean>;
+    action: z.ZodLiteral<"batch">;
+    actions: z.ZodArray<z.ZodDiscriminatedUnion<readonly [z.ZodObject<{
+        timeout: z.ZodOptional<z.ZodNumber>;
+        include_screenshot: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"screenshot">;
+    }, z.core.$strict>, z.ZodObject<{
+        timeout: z.ZodOptional<z.ZodNumber>;
+        include_screenshot: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"click">;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        button: z.ZodOptional<z.ZodEnum<{
+            left: "left";
+            middle: "middle";
+            right: "right";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        timeout: z.ZodOptional<z.ZodNumber>;
+        include_screenshot: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"double_click">;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        button: z.ZodOptional<z.ZodEnum<{
+            left: "left";
+            middle: "middle";
+            right: "right";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        timeout: z.ZodOptional<z.ZodNumber>;
+        include_screenshot: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"move">;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        button: z.ZodOptional<z.ZodEnum<{
+            left: "left";
+            middle: "middle";
+            right: "right";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        timeout: z.ZodOptional<z.ZodNumber>;
+        include_screenshot: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"drag">;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        to_x: z.ZodNumber;
+        to_y: z.ZodNumber;
+        button: z.ZodOptional<z.ZodEnum<{
+            left: "left";
+            middle: "middle";
+            right: "right";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        timeout: z.ZodOptional<z.ZodNumber>;
+        include_screenshot: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"scroll">;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        scroll_x: z.ZodNumber;
+        scroll_y: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        timeout: z.ZodOptional<z.ZodNumber>;
+        include_screenshot: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"type">;
+        text: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        timeout: z.ZodOptional<z.ZodNumber>;
+        include_screenshot: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"keypress">;
+        keys: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        timeout: z.ZodOptional<z.ZodNumber>;
+        include_screenshot: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"wait">;
+        ms: z.ZodNumber;
+    }, z.core.$strict>], "action">>;
+}, z.core.$strict>]>;
+export type SingleComputerParams = z.infer<typeof singleComputerSchema>;
+export type ComputerParams = z.infer<typeof computerSchema>;
+export type ComputerActionName = ComputerParams["action"];
+export interface ComputerScreenshotDetails {
+    widthPx: number;
+    heightPx: number;
+    scaleX?: number;
+    scaleY?: number;
+    originX?: number;
+    originY?: number;
+    displayEpoch?: string;
+    captureId?: string;
+    pngBytes?: number;
+    path?: string;
+}
+export interface ComputerToolDetails {
+    action: ComputerActionName;
+    status: "success" | "disabled" | "error";
+    code?: string;
+    message?: string;
+    x?: number;
+    y?: number;
+    toX?: number;
+    toY?: number;
+    scrollX?: number;
+    scrollY?: number;
+    button?: string;
+    keys?: string[];
+    ms?: number;
+    screenshot?: ComputerScreenshotDetails;
+    supervisor?: string;
+    steps?: ComputerToolDetails[];
+    meta?: OutputMeta;
+}
+type NativeController = {
+    screenshot?: () => Promise<NativeScreenshot> | NativeScreenshot;
+    click?: (expectedEpoch: number | undefined, x: number, y: number, button?: string) => void;
+    doubleClick?: (expectedEpoch: number | undefined, x: number, y: number, button?: string) => void;
+    move?: (expectedEpoch: number | undefined, x: number, y: number) => void;
+    drag?: (expectedEpoch: number | undefined, x: number, y: number, toX: number, toY: number, button?: string) => void;
+    scroll?: (expectedEpoch: number | undefined, x: number, y: number, scrollX: number, scrollY: number) => void;
+    type?: (expectedEpoch: number | undefined, text: string) => void;
+    keypress?: (expectedEpoch: number | undefined, keys: string[]) => void;
+    wait?: (expectedEpoch: number | undefined, ms: number) => void;
+};
+type NativeScreenshot = {
+    png?: Uint8Array | Buffer | ArrayBuffer | string;
+    widthPx?: number;
+    heightPx?: number;
+    scaleX?: number;
+    scaleY?: number;
+    originX?: number;
+    originY?: number;
+    displayEpoch?: string;
+    captureId?: string;
+};
+export type ComputerControllerFactory = () => NativeController;
+export declare const COMPUTER_DISABLED_CODE = "COMPUTER_DISABLED";
+export declare function setComputerControllerFactoryForTests(factory: ComputerControllerFactory | undefined): void;
+export declare function setComputerPlatformForTests(platform: NodeJS.Platform | undefined): void;
+export declare function setComputerArchForTests(arch: NodeJS.Architecture | undefined): void;
+export declare function isComputerSupportedPlatform(platform?: NodeJS.Platform, arch?: NodeJS.Architecture): boolean;
+/**
+ * Whether the computer capability is loaded/advertised at all on this platform.
+ * macOS is callable; Linux is listable (support planned); Windows is fully absent.
+ */
+export declare function isComputerLoadablePlatform(platform?: NodeJS.Platform): boolean;
+export declare function isComputerEnabled(session: Pick<ToolSession, "settings">): boolean;
+export declare function isComputerCallable(session: Pick<ToolSession, "settings">, platform?: NodeJS.Platform, arch?: NodeJS.Architecture): boolean;
+export declare class ComputerTool implements AgentTool<typeof computerSchema, ComputerToolDetails> {
+    #private;
+    private readonly session;
+    readonly name = "computer";
+    readonly label = "Computer";
+    readonly loadMode = "discoverable";
+    readonly summary = "Control the macOS desktop (Apple Silicon) with screenshot, pointer, keyboard, scroll, and wait actions; available by default on supported hosts and supervisor-gated";
+    readonly parameters: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<readonly [z.ZodObject<{
+        timeout: z.ZodOptional<z.ZodNumber>;
+        include_screenshot: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"screenshot">;
+    }, z.core.$strict>, z.ZodObject<{
+        timeout: z.ZodOptional<z.ZodNumber>;
+        include_screenshot: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"click">;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        button: z.ZodOptional<z.ZodEnum<{
+            left: "left";
+            middle: "middle";
+            right: "right";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        timeout: z.ZodOptional<z.ZodNumber>;
+        include_screenshot: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"double_click">;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        button: z.ZodOptional<z.ZodEnum<{
+            left: "left";
+            middle: "middle";
+            right: "right";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        timeout: z.ZodOptional<z.ZodNumber>;
+        include_screenshot: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"move">;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        button: z.ZodOptional<z.ZodEnum<{
+            left: "left";
+            middle: "middle";
+            right: "right";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        timeout: z.ZodOptional<z.ZodNumber>;
+        include_screenshot: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"drag">;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        to_x: z.ZodNumber;
+        to_y: z.ZodNumber;
+        button: z.ZodOptional<z.ZodEnum<{
+            left: "left";
+            middle: "middle";
+            right: "right";
+        }>>;
+    }, z.core.$strict>, z.ZodObject<{
+        timeout: z.ZodOptional<z.ZodNumber>;
+        include_screenshot: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"scroll">;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        scroll_x: z.ZodNumber;
+        scroll_y: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+        timeout: z.ZodOptional<z.ZodNumber>;
+        include_screenshot: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"type">;
+        text: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        timeout: z.ZodOptional<z.ZodNumber>;
+        include_screenshot: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"keypress">;
+        keys: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        timeout: z.ZodOptional<z.ZodNumber>;
+        include_screenshot: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"wait">;
+        ms: z.ZodNumber;
+    }, z.core.$strict>], "action">, z.ZodObject<{
+        timeout: z.ZodOptional<z.ZodNumber>;
+        include_screenshot: z.ZodOptional<z.ZodBoolean>;
+        action: z.ZodLiteral<"batch">;
+        actions: z.ZodArray<z.ZodDiscriminatedUnion<readonly [z.ZodObject<{
+            timeout: z.ZodOptional<z.ZodNumber>;
+            include_screenshot: z.ZodOptional<z.ZodBoolean>;
+            action: z.ZodLiteral<"screenshot">;
+        }, z.core.$strict>, z.ZodObject<{
+            timeout: z.ZodOptional<z.ZodNumber>;
+            include_screenshot: z.ZodOptional<z.ZodBoolean>;
+            action: z.ZodLiteral<"click">;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            button: z.ZodOptional<z.ZodEnum<{
+                left: "left";
+                middle: "middle";
+                right: "right";
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            timeout: z.ZodOptional<z.ZodNumber>;
+            include_screenshot: z.ZodOptional<z.ZodBoolean>;
+            action: z.ZodLiteral<"double_click">;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            button: z.ZodOptional<z.ZodEnum<{
+                left: "left";
+                middle: "middle";
+                right: "right";
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            timeout: z.ZodOptional<z.ZodNumber>;
+            include_screenshot: z.ZodOptional<z.ZodBoolean>;
+            action: z.ZodLiteral<"move">;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            button: z.ZodOptional<z.ZodEnum<{
+                left: "left";
+                middle: "middle";
+                right: "right";
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            timeout: z.ZodOptional<z.ZodNumber>;
+            include_screenshot: z.ZodOptional<z.ZodBoolean>;
+            action: z.ZodLiteral<"drag">;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            to_x: z.ZodNumber;
+            to_y: z.ZodNumber;
+            button: z.ZodOptional<z.ZodEnum<{
+                left: "left";
+                middle: "middle";
+                right: "right";
+            }>>;
+        }, z.core.$strict>, z.ZodObject<{
+            timeout: z.ZodOptional<z.ZodNumber>;
+            include_screenshot: z.ZodOptional<z.ZodBoolean>;
+            action: z.ZodLiteral<"scroll">;
+            x: z.ZodNumber;
+            y: z.ZodNumber;
+            scroll_x: z.ZodNumber;
+            scroll_y: z.ZodNumber;
+        }, z.core.$strict>, z.ZodObject<{
+            timeout: z.ZodOptional<z.ZodNumber>;
+            include_screenshot: z.ZodOptional<z.ZodBoolean>;
+            action: z.ZodLiteral<"type">;
+            text: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            timeout: z.ZodOptional<z.ZodNumber>;
+            include_screenshot: z.ZodOptional<z.ZodBoolean>;
+            action: z.ZodLiteral<"keypress">;
+            keys: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            timeout: z.ZodOptional<z.ZodNumber>;
+            include_screenshot: z.ZodOptional<z.ZodBoolean>;
+            action: z.ZodLiteral<"wait">;
+            ms: z.ZodNumber;
+        }, z.core.$strict>], "action">>;
+    }, z.core.$strict>]>;
+    readonly strict = true;
+    constructor(session: ToolSession);
+    static createIf(session: ToolSession): ComputerTool | null;
+    get description(): string;
+    execute(_toolCallId: string, params: ComputerParams, signal?: AbortSignal, _onUpdate?: AgentToolUpdateCallback<ComputerToolDetails>, _ctx?: AgentToolContext): Promise<AgentToolResult<ComputerToolDetails>>;
+}
+export {};

package/dist/types/tools/index.d.ts

@@ -18,6 +18,7 @@ import type { AgentOutputManager } from "../task/output-manager";
 import type { DiscoverableTool, DiscoverableToolSearchIndex } from "../tool-discovery/tool-index";
 import type { EventBus } from "../utils/event-bus";
 import type { WorkspaceTree } from "../workspace-tree";
+import type { BashRestrictionProfile } from "./bash-allowed-prefixes";
 import { type CheckpointState } from "./checkpoint";
 import { type TodoPhase } from "./todo-write";
 export * from "../edit";
@@ -33,6 +34,7 @@ export * from "./bash";
 export * from "./browser";
 export * from "./calculator";
 export * from "./checkpoint";
+export * from "./computer";
 export * from "./cron";
 export * from "./debug";
 export * from "./eval";
@@ -110,6 +112,12 @@ export interface ToolSession {
     assertEvalExecutionAllowed?: () => void;
     /** Track tool-owned eval work so session disposal can await/abort it like direct session eval runs. */
     trackEvalExecution?<T>(execution: Promise<T>, abortController: AbortController): Promise<T>;
+    /** Register a safe request handler that asks a managed foreground bash call to fold into a background job. */
+    registerForegroundBashBackgroundRequestHandler?: (handler: () => void) => () => void;
+    /** Whether a managed foreground bash call is currently foldable into a background job. */
+    hasForegroundBashBackgroundRequestHandler?: () => boolean;
+    /** Request that the active managed foreground bash call fold into a background job, if supported. */
+    requestForegroundBashBackground?: () => boolean;
     /** Get session ID */
     getSessionId?: () => string | null;
     /** Get Hindsight runtime state for this agent session. */
@@ -122,8 +130,12 @@ export interface ToolSession {
     getToolByName?: (name: string) => AgentTool | undefined;
     /** Agent registry for IRC routing across live sessions. */
     agentRegistry?: AgentRegistry;
-    /** Optional restricted bash command prefixes for read-only role agents. */
+    /** Optional restricted bash command prefixes for read-only role agents and constrained modes. */
     bashAllowedPrefixes?: string[];
+    /** Restriction policy for sessions that deliberately expose a narrow bash surface. */
+    bashRestrictionProfile?: BashRestrictionProfile;
+    /** Optional per-session allowlist for tools exposed through search_tool_bm25. */
+    discoverableToolAllowedNames?: readonly string[];
     /** Get artifacts directory for artifact:// URLs */
     getArtifactsDir?: () => string | null;
     /** Get the ArtifactManager backing this session (shared across parent + subagents). */
@@ -155,6 +167,8 @@ export interface ToolSession {
     getGoalModeState?: () => GoalModeState | undefined;
     /** Unattended workflow-gate emitter (present only when unattended mode is negotiated). */
     getWorkflowGateEmitter?: () => WorkflowGateEmitter | undefined;
+    /** Optional per-session restriction for goal tool operations. */
+    goalToolAllowedOps?: readonly ("create" | "get" | "complete" | "resume" | "drop" | "pause")[];
     /** Goal runtime for the active agent session. */
     getGoalRuntime?: () => GoalRuntime | undefined;
     /** Bridge to the connected client (e.g. ACP editor host). Tools should route fs/terminal/permission requests through this when available. */
@@ -254,6 +268,15 @@ export declare function computeEssentialBuiltinNames(settings: Settings): string
  * Hindsight memory helpers are intentionally excluded: memory is a private backend
  * integration, not a public gajae-code tool surface.
  */
+export interface BuiltinCapabilityCatalogEntry {
+    name: string;
+    label: string;
+    summary: string;
+    docsPath: string;
+    callableBuiltin: boolean;
+    defaultEnabled: boolean;
+}
+export declare const BUILTIN_CAPABILITY_CATALOG: readonly BuiltinCapabilityCatalogEntry[];
 export declare const BUILTIN_TOOLS: Record<string, ToolFactory>;
 export declare const HIDDEN_TOOLS: Record<string, ToolFactory>;
 export type ToolName = keyof typeof BUILTIN_TOOLS;

package/dist/types/tools/job.d.ts

@@ -1,6 +1,7 @@
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@gajae-code/agent-core";
 import type { Component } from "@gajae-code/tui";
 import * as z from "zod/v4";
+import { type AsyncJob } from "../async";
 import type { RenderResultOptions } from "../extensibility/custom-tools/types";
 import type { Theme } from "../modes/theme/theme";
 import type { ToolSession } from "./index";
@@ -8,6 +9,7 @@ declare const jobSchema: z.ZodObject<{
     poll: z.ZodOptional<z.ZodArray<z.ZodString>>;
     cancel: z.ZodOptional<z.ZodArray<z.ZodString>>;
     list: z.ZodOptional<z.ZodBoolean>;
+    tail: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 type JobParams = z.infer<typeof jobSchema>;
 interface JobSnapshot {
@@ -20,12 +22,21 @@ interface JobSnapshot {
     errorText?: string;
 }
 type CancelStatus = "cancelled" | "not_found" | "already_completed" | "already_cancelled";
+export interface JobOutputTail {
+    id: string;
+    status: AsyncJob["status"];
+    text: string;
+    startOffset: number;
+    nextOffset: number;
+    truncated: boolean;
+}
 export interface JobToolDetails {
     jobs: JobSnapshot[];
     cancelled?: {
         id: string;
         status: CancelStatus;
     }[];
+    output?: JobOutputTail[];
 }
 export declare class JobTool implements AgentTool<typeof jobSchema, JobToolDetails> {
     #private;
@@ -38,6 +49,7 @@ export declare class JobTool implements AgentTool<typeof jobSchema, JobToolDetai
         poll: z.ZodOptional<z.ZodArray<z.ZodString>>;
         cancel: z.ZodOptional<z.ZodArray<z.ZodString>>;
         list: z.ZodOptional<z.ZodBoolean>;
+        tail: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>;
     readonly strict = true;
     readonly loadMode = "discoverable";
@@ -48,6 +60,7 @@ export declare class JobTool implements AgentTool<typeof jobSchema, JobToolDetai
 interface JobRenderArgs {
     poll?: string[];
     cancel?: string[];
+    tail?: string[];
 }
 export declare const jobToolRenderer: {
     inline: boolean;

package/dist/types/tools/tool-timeouts.d.ts

@@ -22,6 +22,11 @@ export declare const TOOL_TIMEOUTS: {
         readonly min: 1;
         readonly max: 300;
     };
+    readonly computer: {
+        readonly default: 30;
+        readonly min: 1;
+        readonly max: 300;
+    };
     readonly ssh: {
         readonly default: 60;
         readonly min: 1;

package/dist/types/web/search/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * Unified Web Search Tool
  *
- * Single tool supporting Anthropic, Perplexity, Exa, Brave, Jina, Kimi, Gemini, OpenAI code backend, Tavily, Kagi, Z.AI, SearXNG, and Synthetic
+ * Single tool supporting Anthropic, Perplexity, Exa, Brave, Jina, Kimi, Gemini, OpenAI code backend, xAI, Tavily, Kagi, Z.AI, SearXNG, and Synthetic
  * providers with provider-specific parameters exposed conditionally.
  */
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@gajae-code/agent-core";
@@ -24,6 +24,21 @@ export declare const webSearchSchema: z.ZodObject<{
     max_tokens: z.ZodOptional<z.ZodNumber>;
     temperature: z.ZodOptional<z.ZodNumber>;
     num_search_results: z.ZodOptional<z.ZodNumber>;
+    xai_search_mode: z.ZodOptional<z.ZodEnum<{
+        web: "web";
+        web_and_x: "web_and_x";
+        x: "x";
+    }>>;
+    allowed_domains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    excluded_domains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    allowed_x_handles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    excluded_x_handles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    from_date: z.ZodOptional<z.ZodString>;
+    to_date: z.ZodOptional<z.ZodString>;
+    enable_image_understanding: z.ZodOptional<z.ZodBoolean>;
+    enable_image_search: z.ZodOptional<z.ZodBoolean>;
+    enable_video_understanding: z.ZodOptional<z.ZodBoolean>;
+    no_inline_citations: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type SearchToolParams = z.infer<typeof webSearchSchema>;
 export interface SearchQueryParams extends SearchToolParams {
@@ -51,7 +66,7 @@ export declare function runSearchQuery(params: SearchQueryParams, options?: {
 /**
  * Web search tool implementation.
  *
- * Supports Anthropic, Perplexity, Exa, Brave, Jina, Kimi, Gemini, OpenAI code backend, Z.AI, SearXNG, and Synthetic providers with automatic fallback.
+ * Supports Anthropic, Perplexity, Exa, Brave, Jina, Kimi, Gemini, OpenAI code backend, xAI, Z.AI, SearXNG, and Synthetic providers with automatic fallback.
  */
 export declare class WebSearchTool implements AgentTool<typeof webSearchSchema, SearchRenderDetails> {
     #private;
@@ -70,6 +85,21 @@ export declare class WebSearchTool implements AgentTool<typeof webSearchSchema,
         max_tokens: z.ZodOptional<z.ZodNumber>;
         temperature: z.ZodOptional<z.ZodNumber>;
         num_search_results: z.ZodOptional<z.ZodNumber>;
+        xai_search_mode: z.ZodOptional<z.ZodEnum<{
+            web: "web";
+            web_and_x: "web_and_x";
+            x: "x";
+        }>>;
+        allowed_domains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        excluded_domains: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        allowed_x_handles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        excluded_x_handles: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        from_date: z.ZodOptional<z.ZodString>;
+        to_date: z.ZodOptional<z.ZodString>;
+        enable_image_understanding: z.ZodOptional<z.ZodBoolean>;
+        enable_image_search: z.ZodOptional<z.ZodBoolean>;
+        enable_video_understanding: z.ZodOptional<z.ZodBoolean>;
+        no_inline_citations: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strip>;
     readonly strict = true;
     readonly loadMode = "discoverable";