@mu-agent/mu 0.1.1 → 0.2.1

package/dist/types/profile-browser/page/resolve.d.ts

@@ -0,0 +1,15 @@
+import type { Tab } from "../browser/tabs.js";
+import type { CdpSession } from "../cdp/session.js";
+import type { Ref } from "./refs.js";
+export declare class StaleRefError extends Error {
+    readonly ref: Ref;
+    constructor(ref: Ref, reason: string);
+}
+export interface ResolvedRef {
+    ref: Ref;
+    frameId: string;
+    backendNodeId: number;
+    session: CdpSession;
+    objectId: string;
+}
+export declare function resolveRef(tab: Tab, ref: Ref, signal?: AbortSignal): Promise<ResolvedRef>;

package/dist/types/profile-browser/page/screenshot.d.ts

@@ -0,0 +1,25 @@
+import type { Tab } from "../browser/tabs.js";
+export declare const MAX_SCREENSHOT_WIDTH = 1280;
+export interface Screenshot {
+    data: string;
+    mimeType: "image/jpeg";
+    cssWidth: number;
+    cssHeight: number;
+    scale: number;
+    originX: number;
+    originY: number;
+}
+export type VisionMode = "auto" | "on" | "off";
+export declare function visionEnabled(mode: VisionMode, modelRef: string | undefined): boolean;
+export declare function screenshotHeader(shot: Screenshot): string;
+export declare function captureScreenshot(tab: Tab, options?: {
+    signal?: AbortSignal | undefined;
+    box?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    } | undefined;
+    fullPage?: boolean | undefined;
+    quality?: number | undefined;
+}): Promise<Screenshot>;

package/dist/types/profile-browser/page/secrets.d.ts

@@ -0,0 +1,7 @@
+export declare class SecretRegistry {
+    private readonly values;
+    add(value: string | undefined): void;
+    get size(): number;
+    redact(text: string): string;
+    redactDeep<T>(value: T): T;
+}

package/dist/types/profile-browser/page/settle.d.ts

@@ -0,0 +1,13 @@
+import type { Tab } from "../browser/tabs.js";
+export type SettleMode = "in-page" | "typing" | "navigation";
+export interface SettleResult {
+    ms: number;
+    reason: string;
+    navigated: boolean;
+    changed: boolean;
+}
+export interface SettleWatcher {
+    settle(signal?: AbortSignal): Promise<SettleResult>;
+    dispose(): void;
+}
+export declare function watchSettle(tab: Tab, mode?: SettleMode): SettleWatcher;

package/dist/types/profile-browser/page/snapshot.d.ts

@@ -0,0 +1,9 @@
+import type { Tab } from "../browser/tabs.js";
+import type { PageModel } from "./model.js";
+export interface CaptureOptions {
+    scope?: "viewport" | "full";
+    signal?: AbortSignal | undefined;
+    margin?: number;
+    maxText?: number;
+}
+export declare function capturePage(tab: Tab, options?: CaptureOptions): Promise<PageModel>;

package/dist/types/profile-browser/page/text.d.ts

@@ -0,0 +1,22 @@
+import type { PageModel, PageNode } from "./model.js";
+export declare const READ_PAGE_CHARS = 12000;
+export declare function pageMarkdown(model: PageModel): {
+    markdown: string;
+    scope: string;
+};
+export declare function filterSections(markdown: string, query: string): string;
+export declare function paginate(text: string, offset: number, size?: number): {
+    chunk: string;
+    start: number;
+    end: number;
+    total: number;
+};
+export interface FindMatch {
+    node: PageNode;
+    context: string;
+    position: "in view" | "above" | "below";
+}
+export declare function findNodes(model: PageModel, matcher: (text: string) => boolean, limit: number): {
+    matches: FindMatch[];
+    total: number;
+};

package/dist/types/profile-browser/testing/agent-scenarios.d.ts

@@ -0,0 +1,27 @@
+import { type Credential, type Provider } from "../../ai/index.js";
+import type { PermissionRequest } from "../../core/index.js";
+import { Agent } from "../../sdk/index.js";
+import type { BrowserProfile } from "../index.js";
+import { type FixtureSite } from "./fixture-site.js";
+export interface Scenario {
+    name: string;
+    prompt: (site: FixtureSite) => string;
+    mode: "default" | "autonomous";
+    approve: "allow" | "deny" | ((request: PermissionRequest) => "allow" | "deny");
+}
+export declare const SCENARIOS: Scenario[];
+export declare function withFetch(base: Provider, fetchImpl: typeof fetch): Provider;
+export interface ScenarioRun {
+    text: string;
+    asks: PermissionRequest[];
+    agent: Agent;
+}
+export declare function runScenario(scenario: Scenario, profile: BrowserProfile, site: FixtureSite, provider: Provider, modelRef: string, extra?: {
+    getCredentials?: (provider: string) => Promise<Credential | undefined>;
+}): Promise<ScenarioRun>;
+export declare function replayProvider(name: string, site: FixtureSite): {
+    provider: Provider;
+    model: string;
+    assertExhausted: () => void;
+};
+export declare const replayCredentials: () => Promise<Credential>;

package/dist/types/profile-browser/testing/bench.d.ts

@@ -0,0 +1,19 @@
+import type { BrowserManager } from "../browser/manager.js";
+export interface BenchResult {
+    page: string;
+    p50: number;
+    p95: number;
+    max: number;
+    tokens: number;
+    title: string;
+}
+export declare function benchSnapshots(manager: BrowserManager, urls: Record<string, string>, iterations?: number): Promise<BenchResult[]>;
+export declare function formatBench(results: BenchResult[]): string;
+export interface ActionBench {
+    action: string;
+    p50: number;
+    p95: number;
+    settleP50: number;
+}
+export declare function benchActions(home: string, iterations?: number): Promise<ActionBench[]>;
+export declare function formatActionBench(results: ActionBench[]): string;

package/dist/types/profile-browser/testing/chrome.d.ts

@@ -0,0 +1,12 @@
+import type { CdpConnection } from "../cdp/connection.js";
+export declare const testBrowserPath: string | undefined;
+export declare function describeWithBrowser(name: string, body: () => void): void;
+export declare function tempUserDataDir(): string;
+export interface TestBrowser {
+    connection: CdpConnection;
+    userDataDir: string;
+    pid: number | undefined;
+    wsUrl: string;
+    close: () => Promise<void>;
+}
+export declare function launchTestBrowser(userDataDir?: string): Promise<TestBrowser>;

package/dist/types/profile-browser/testing/fixture-site.d.ts

@@ -0,0 +1,14 @@
+export declare const FIXTURE_DIR: string;
+export interface FixtureSite {
+    origin: string;
+    crossOrigin: string;
+    url: (page: string) => string;
+    submissions: Record<string, unknown>[];
+    signups: {
+        email: string;
+        code: string;
+        verified: boolean;
+    }[];
+    stop: () => void;
+}
+export declare function startFixtureSite(): FixtureSite;

package/dist/types/profile-browser/testing/pdf.d.ts

@@ -0,0 +1 @@
+export declare function minimalPdf(lines: string[]): string;

package/dist/types/profile-browser/testing/wait.d.ts

@@ -0,0 +1 @@
+export declare function until(condition: () => boolean | Promise<boolean>, timeoutMs?: number, label?: string): Promise<void>;

package/dist/types/profile-browser/tools/delegate.d.ts

@@ -0,0 +1,23 @@
+export interface CodingRun {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+export type CodingRunner = (argv: string[], options: {
+    cwd: string;
+    signal: AbortSignal;
+    onLine?: (line: string) => void;
+}) => Promise<CodingRun>;
+export declare const spawnCodingAgent: CodingRunner;
+export interface DelegateDeps {
+    command: string[];
+    workspace: string;
+    model: () => string | undefined;
+    pageText?: (text: string) => string | undefined;
+    run?: CodingRunner;
+}
+export declare function delegateTool(deps: DelegateDeps): import("../../sdk/index.js").Tool<{
+    task: string;
+    access?: "read" | "edit" | "full" | undefined;
+    directory?: string | undefined;
+}>;

package/dist/types/profile-browser/tools/files.d.ts

@@ -0,0 +1,3 @@
+import type { AnyTool } from "../../core/index.js";
+export declare function pathPattern(root: string, path: unknown): string;
+export declare function fileTools(root: string): AnyTool[];

package/dist/types/profile-browser/tools/gate.d.ts

@@ -0,0 +1,8 @@
+import type { ToolPermissionDetails } from "../../core/index.js";
+import type { BrowserToolDeps } from "./shared.js";
+export declare function navigationLeak(deps: BrowserToolDeps, url: string): string | undefined;
+export declare function shareDetails(url: string, leak: string): ToolPermissionDetails;
+export declare function scopeFor(deps: BrowserToolDeps, tool: string, args: Record<string, unknown>): string;
+export declare function activatedRef(args: Record<string, unknown>): string | undefined;
+export declare function retryKey(tool: string, args: Record<string, unknown>): string;
+export declare function detailsFor(deps: BrowserToolDeps, tool: string, args: Record<string, unknown>): Promise<ToolPermissionDetails>;

package/dist/types/profile-browser/tools/interact.d.ts

@@ -0,0 +1,86 @@
+import { type BrowserToolDeps } from "./shared.js";
+export declare function interactionTools(deps: BrowserToolDeps): {
+    click: import("../../sdk/index.js").Tool<{
+        ref: string;
+        button?: "left" | "right" | "middle" | undefined;
+        double?: boolean | undefined;
+        modifiers?: ("Alt" | "Control" | "Meta" | "Shift")[] | undefined;
+        commit?: boolean | undefined;
+        reason?: string | undefined;
+    }>;
+    type: import("../../sdk/index.js").Tool<{
+        ref: string;
+        text: string;
+        clear?: boolean | undefined;
+        submit?: boolean | undefined;
+        keystrokes?: boolean | undefined;
+        commit?: boolean | undefined;
+        reason?: string | undefined;
+    }>;
+    fill: import("../../sdk/index.js").Tool<{
+        fields: {
+            ref: string;
+            value: string | boolean | string[];
+        }[];
+        submitRef?: string | undefined;
+        commit?: boolean | undefined;
+        reason?: string | undefined;
+    }>;
+    select: import("../../sdk/index.js").Tool<{
+        ref: string;
+        options: string[];
+        commit?: boolean | undefined;
+        reason?: string | undefined;
+    }>;
+    press: import("../../sdk/index.js").Tool<{
+        keys: string;
+        ref?: string | undefined;
+        commit?: boolean | undefined;
+        reason?: string | undefined;
+    }>;
+    scroll: import("../../sdk/index.js").Tool<{
+        direction?: "left" | "right" | "up" | "down" | undefined;
+        to?: "top" | "bottom" | undefined;
+        amount?: number | "page" | "half" | undefined;
+        ref?: string | undefined;
+    }>;
+    hover: import("../../sdk/index.js").Tool<{
+        ref: string;
+    }>;
+    drag: import("../../sdk/index.js").Tool<{
+        from: string | {
+            x: number;
+            y: number;
+        };
+        to: string | {
+            x: number;
+            y: number;
+        };
+    }>;
+    upload: import("../../sdk/index.js").Tool<{
+        ref: string;
+        paths: string[];
+    }>;
+    dialog: import("../../sdk/index.js").Tool<{
+        action: "accept" | "dismiss";
+        text?: string | undefined;
+    }>;
+    wait: import("../../sdk/index.js").Tool<{
+        text?: string | undefined;
+        gone?: boolean | undefined;
+        seconds?: number | undefined;
+    }>;
+    evaluate: import("../../sdk/index.js").Tool<{
+        function: string;
+        ref?: string | undefined;
+    }>;
+    clickXy: import("../../sdk/index.js").Tool<{
+        x: number;
+        y: number;
+        button?: "left" | "right" | "middle" | undefined;
+        double?: boolean | undefined;
+        commit?: boolean | undefined;
+        reason?: string | undefined;
+    }>;
+    downloads: import("../../sdk/index.js").Tool<Record<string, never>>;
+};

package/dist/types/profile-browser/tools/navigate.d.ts

@@ -0,0 +1,5 @@
+import { type BrowserToolDeps } from "./shared.js";
+export declare function navigateTool(deps: BrowserToolDeps): import("../../sdk/index.js").Tool<{
+    url: string;
+    newTab?: boolean | undefined;
+}>;

package/dist/types/profile-browser/tools/observe.d.ts

@@ -0,0 +1,18 @@
+import { type BrowserToolDeps } from "./shared.js";
+export declare function snapshotTool(deps: BrowserToolDeps): import("../../sdk/index.js").Tool<{
+    scope?: "viewport" | "full" | undefined;
+    ref?: string | undefined;
+}>;
+export declare function screenshotTool(deps: BrowserToolDeps): import("../../sdk/index.js").Tool<{
+    ref?: string | undefined;
+    fullPage?: boolean | undefined;
+}>;
+export declare function readPageTool(deps: BrowserToolDeps): import("../../sdk/index.js").Tool<{
+    query?: string | undefined;
+    offset?: number | undefined;
+}>;
+export declare function findTool(deps: BrowserToolDeps): import("../../sdk/index.js").Tool<{
+    text?: string | undefined;
+    regex?: string | undefined;
+    limit?: number | undefined;
+}>;

package/dist/types/profile-browser/tools/shared.d.ts

@@ -0,0 +1,23 @@
+import type { ToolResult } from "../../core/index.js";
+import type { ActionResult } from "../actions/click.js";
+import { Stopwatch } from "../actions/types.js";
+import type { BrowserManager } from "../browser/manager.js";
+import type { Tab } from "../browser/tabs.js";
+import type { ResolvedBrowserOptions } from "../config.js";
+export interface BrowserToolDeps {
+    browser: BrowserManager;
+    config: ResolvedBrowserOptions;
+    vision: () => boolean;
+    notes?: () => string;
+}
+export declare const observationKey: (slot: number) => string;
+export type ActResult = ActionResult;
+export interface PageActionOptions {
+    blockedByDialog?: boolean;
+    screenshot?: boolean;
+    scope?: "viewport" | "full";
+    subtreeRef?: string;
+    detectChange?: boolean;
+    tabSwitch?: boolean;
+}
+export declare function pageAction(deps: BrowserToolDeps, toolSignal: AbortSignal, act: (tab: Tab, stopwatch: Stopwatch, signal: AbortSignal) => Promise<ActResult>, options?: PageActionOptions): Promise<ToolResult>;

package/dist/types/profile-browser/tools/tabs.d.ts

@@ -0,0 +1,8 @@
+import type { TabInfo } from "../browser/tabs.js";
+import { type BrowserToolDeps } from "./shared.js";
+export declare function formatTabs(tabs: TabInfo[]): string;
+export declare function tabsTool(deps: BrowserToolDeps): import("../../sdk/index.js").Tool<{
+    action: "close" | "open" | "list" | "switch";
+    url?: string | undefined;
+    tabId?: string | undefined;
+}>;

package/dist/types/profile-coding/index.d.ts

@@ -1,8 +1,8 @@
 import { ProcessManager, type Profile } from "../core/index.js";
+import { TodoStore } from "../sdk/index.js";
 import { InstructionLoader, type InstructionSettings } from "./context.js";
 import { FileState } from "./state.js";
 import { bashTool } from "./tools/bash.js";
-import { TodoStore } from "./tools/todo.js";
 export interface CodingProfileOptions {
     root?: string;
     spawn?: Parameters<typeof bashTool>[0]["spawn"];
@@ -19,6 +19,8 @@ export interface CodingProfile extends Profile {
     instructions: InstructionLoader;
 }
 export declare function codingProfile(options?: CodingProfileOptions): Promise<CodingProfile>;
+export type { TodoItem } from "../sdk/index.js";
+export { renderTodos, TodoStore, todoTool } from "../sdk/index.js";
 export type { GitRunner, ShadowCheckpointOptions } from "./checkpoint.js";
 export { gitConfigNullDevice, ShadowCheckpointProvider } from "./checkpoint.js";
 export { codingEnvironment, contextMessages, DEFAULT_INSTRUCTION_FALLBACKS, DEFAULT_PROJECT_ROOT_MARKERS, discoverContextFiles, environmentMessage, type InstructionDiagnostic, InstructionLoader, type InstructionLoaderOptions, type InstructionSettings, type InstructionSnapshot, type InstructionSource, } from "./context.js";
@@ -30,6 +32,4 @@ export { FileState } from "./state.js";
 export { bashTool } from "./tools/bash.js";
 export { editTool, lsTool, readTool, resolveInRoot, writeTool } from "./tools/files.js";
 export { shellSpawner, taskTools } from "./tools/tasks.js";
-export type { TodoItem } from "./tools/todo.js";
-export { renderTodos, TodoStore, todoTool } from "./tools/todo.js";
 export { MAX_OUTPUT_CHARS, truncateOutput, withNotice } from "./truncate.js";

package/dist/types/sdk/agent.d.ts

@@ -78,6 +78,7 @@ export interface ChildAgentOptions {
     permissions?: PermissionRule[];
     budget?: Budget;
     inheritContext?: boolean;
+    refreshContext?: AgentOptions["refreshContext"];
 }
 export declare class Agent {
     private readonly options;

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

@@ -31,6 +31,8 @@ export { defaultSkillRoots, discoverSkills, loadSkill, skillListing, skillsExten
 export { STRUCTURED_OUTPUT_TOOL, structuredOutputPrompt, structuredOutputTool, } from "./structured-output.js";
 export type { SubagentDetails, SubagentExtensionOptions, SubagentKind, SubagentProgressUpdate, } from "./subagents.js";
 export { subagentsExtension } from "./subagents.js";
+export type { TodoItem } from "./todo.js";
+export { renderTodos, TodoStore, todoTool } from "./todo.js";
 export type { ToolDefinition, ToolResult } from "./tool.js";
 export { tool } from "./tool.js";
 export type { MarkdownTranscript, TranscriptMarkdownOptions, } from "./transcript-markdown.js";

package/dist/types/sdk/subagents.d.ts

@@ -31,6 +31,7 @@ export interface SubagentProgressUpdate {
 }
 interface SubagentExtensionBaseOptions {
     parent: () => Agent;
+    taskSession?: ProfileSubagents["taskSession"];
     excludeTools?: readonly string[];
     searchModel?: (parent: Agent) => ModelInfo | undefined;
     counselModel?: (parent: Agent) => ModelInfo | undefined;

package/dist/types/{profile-coding/tools → sdk}/todo.d.ts

@@ -8,9 +8,9 @@ export declare class TodoStore {
     all(): TodoItem[];
 }
 export declare function renderTodos(items: TodoItem[]): string;
-export declare function todoTool(store: TodoStore): import("../../sdk/index.js").Tool<{
+export declare function todoTool(store: TodoStore): import("../core/index.js").Tool<{
     items: {
         content: string;
-        status: "pending" | "in_progress" | "completed";
+        status: "completed" | "pending" | "in_progress";
     }[];
 }>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mu-agent/mu",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "Mu, a general-purpose extensible AI agent platform for the terminal and TypeScript",
   "type": "module",
   "main": "./dist/index.js",
@@ -64,6 +64,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
+    "@mu/profile-browser": "workspace:*",
     "@mu/profile-coding": "workspace:*",
     "@mu/tui": "workspace:*",
     "mu": "workspace:*",