@mu-agent/mu 0.2.2 → 0.2.4

package/dist/types/ai/providers/llama-cpp.d.ts

@@ -1,3 +1,3 @@
 import type { ModelInfo, Provider, ProviderModelDiscoveryOptions } from "../types.js";
-export declare function discoverLlamaCppModels(options: ProviderModelDiscoveryOptions): Promise<ModelInfo[]>;
+export declare function discoverLlamaCppModels(options: ProviderModelDiscoveryOptions): Promise<ModelInfo[] | undefined>;
 export declare const llamaCpp: Provider;

package/dist/types/core/compaction.d.ts

@@ -1,4 +1,5 @@
 import { type ModelInfo, type Provider, type StreamOpts, type Usage } from "../ai/index.js";
+import type { CompactionProgress } from "./events.js";
 import type { AgentMessage } from "./messages.js";
 export declare function estimateTextTokens(text: string): number;
 export declare function estimateTokens(messages: AgentMessage[]): number;
@@ -52,6 +53,7 @@ export interface CompactorOptions {
     streamOpts?: StreamOpts;
     contextTokens?: number;
     canContinue?: (usage: Usage) => boolean;
+    onProgress?: (progress: CompactionProgress) => void;
 }
 export declare function compact(messages: AgentMessage[], options: CompactorOptions): Promise<CompactionResult>;
 export declare function applyCompaction(result: CompactionTranscript): AgentMessage[];

package/dist/types/core/events.d.ts

@@ -36,6 +36,15 @@ export type StreamDelta = {
 export type AgentEndReason = "done" | "aborted" | "budget" | "maxTurns" | "error";
 export type CompactionTrigger = "manual" | "threshold" | "overflow" | "model-change";
 export type CompactionStage = "clearing-tool-output" | "summarizing" | "installing";
+export interface CompactionProgress {
+    sourceTokens: number;
+    sourceChars: number;
+    summarizedChars: number;
+    request: number;
+    requestChars: number;
+    outputChars: number;
+    expectedOutputChars: number;
+}
 export type AgentEvent = {
     type: "agent_start";
 } | {
@@ -96,6 +105,7 @@ export type AgentEvent = {
     layer: 1 | 2 | 3;
     stage: CompactionStage;
     toolResultsCleared?: number;
+    progress?: CompactionProgress;
 } | {
     type: "compaction_end";
     layer: 1 | 2 | 3;

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

@@ -4,7 +4,7 @@ export type { Command, CommandContext, CommandResult } from "./commands.js";
 export { CommandRegistry } from "./commands.js";
 export type { CompactionPlan, CompactionRequest, CompactionResult, CompactorOptions, ContextState, } from "./compaction.js";
 export { AUTO_COMPACT_THRESHOLD, applyCompaction, CompactionError, compact, compactionSummaryMessage, contextState, DEFAULT_KEEP_RECENT_TOKENS, estimateTextTokens, estimateTokens, formatCarryover, planCompaction, SUMMARY_PROMPT, serializeCompactionMessages, shouldCompact, } from "./compaction.js";
-export type { AgentEndReason, AgentEvent, AgentEventType, CompactionStage, CompactionTrigger, EventSink, StreamDelta, } from "./events.js";
+export type { AgentEndReason, AgentEvent, AgentEventType, CompactionProgress, CompactionStage, CompactionTrigger, EventSink, StreamDelta, } from "./events.js";
 export type { Extension, ExtensionAPI, ExtensionEvent, ExtensionEventFor, ExtensionEventType, InputDirective, LifecycleEvent, LifecycleNotification, ToolCallDirective, ToolCallHookInfo, ToolRenderer, ToolResultDirective, ToolResultHookInfo, } from "./extensions.js";
 export { ExtensionHost } from "./extensions.js";
 export type { AfterToolCallInfo, AgentContext, AgentRunResult, BeforeToolCallInfo, ContextPreparation, LoopConfig, NextTurnDirective, TurnInfo, } from "./loop.js";
@@ -13,7 +13,7 @@ export type { AgentMessage, CustomMessage } from "./messages.js";
 export * from "./messages.js";
 export { customMessage, isCustomMessage, renderCustomMessage, toAiMessages, userMessage, } from "./messages.js";
 export type { MicrocompactionOptions, MicrocompactionResult } from "./microcompaction.js";
-export { IMAGE_TOMBSTONE, MICROCOMPACT_THRESHOLD, microcompact, TOMBSTONE, } from "./microcompaction.js";
+export { IMAGE_TOMBSTONE, MICROCOMPACT_THRESHOLD, microcompact, SUPERSEDE_WITHIN_TURNS, TOMBSTONE, } from "./microcompaction.js";
 export type { PermissionAction, PermissionField, PermissionPreview, PermissionRequest, PermissionRule, PermissionSection, ToolPermissionDetails, } from "./permission.js";
 export { evaluate, permissionPreviewLines } from "./permission.js";
 export type { ManagedProcessHandle, ProcessEvents, Spawner, SpawnRequest, TaskInfo, TaskStatus, } from "./process.js";

package/dist/types/core/microcompaction.d.ts

@@ -7,7 +7,9 @@ export interface MicrocompactionOptions {
     imageRetentionTurns?: number;
     imageBudgetTokens?: number;
     imagesOnly?: boolean;
+    supersedeWithinTurns?: number;
 }
+export declare const SUPERSEDE_WITHIN_TURNS = 2;
 export interface MicrocompactionResult {
     messages: AgentMessage[];
     evicted: number;

package/dist/types/profile-browser/actions/click.d.ts

@@ -16,6 +16,7 @@ export interface ActionResult {
     settle?: string;
     tab?: Tab;
     extra?: string;
+    notices?: string[];
     path?: "mouse" | "js" | "keyboard";
     occludedBy?: Occluder;
     newTab?: TabInfo;

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

@@ -1,6 +1,7 @@
 import type { Tab } from "../browser/tabs.js";
 export declare function normalizeUrl(input: string): string;
 export declare function hostOf(url: string): string;
+export declare function pagePattern(url: string): string;
 export interface NavigationResult {
     settle: string;
     sameDocument: boolean;

package/dist/types/profile-browser/actions/types.d.ts

@@ -7,7 +7,7 @@ export interface Timings {
     screenshotMs: number;
     totalMs: number;
 }
-export type OutcomeKind = "stale-ref" | "occluded" | "no-change" | "navigated" | "new-tab" | "dialog" | "value-mismatch" | "timeout" | "blocked-by-dialog" | "not-interactable" | "error";
+export type OutcomeKind = "stale-ref" | "occluded" | "no-change" | "navigated" | "new-tab" | "dialog" | "value-mismatch" | "timeout" | "blocked-by-dialog" | "not-interactable" | "blocked-host" | "error";
 export interface OutcomeDetails {
     timings: Timings;
     url: string;

package/dist/types/profile-browser/agent/permissions.d.ts

@@ -1,4 +1,4 @@
-import type { PermissionMode, PermissionRule } from "../../core/index.js";
+import { type PermissionMode, type PermissionRule } from "../../core/index.js";
 export declare const SCOPES: {
     readonly observe: "browser:observe";
     readonly navigate: "browser:navigate";
@@ -12,6 +12,12 @@ export declare const SCOPES: {
 };
 export declare const BROWSER_PERMISSION_DEFAULTS: PermissionRule[];
 export declare function hostRules(allowedHosts: string[], blockedHosts: string[]): PermissionRule[];
+export interface HostLists {
+    allowedHosts: string[];
+    blockedHosts: string[];
+}
+export declare function restrictsHosts(lists: HostLists): boolean;
+export declare function hostAllowed(url: string, lists: HostLists): boolean;
 export declare function browserPermissionModes(hosts?: PermissionRule[]): PermissionMode[];
 export declare function rememberedPermissionsPath(home: string): string;
 export declare function loadRememberedPermissions(home: string, onWarning?: (message: string) => void): PermissionRule[];

package/dist/types/profile-browser/browser/lease.d.ts

@@ -0,0 +1,22 @@
+export interface LeaseHolder {
+    pid: number;
+    host: string;
+    token: string;
+    since: string;
+}
+export declare function profileInUseMessage(holder: LeaseHolder, profileName: string): string;
+export declare class ProfileInUseError extends Error {
+    readonly holder: LeaseHolder;
+    constructor(holder: LeaseHolder, profileName: string);
+}
+export declare function liveHolder(userDataDir: string): LeaseHolder | undefined;
+export declare class ProfileLease {
+    readonly userDataDir: string;
+    readonly profileName: string;
+    private readonly token;
+    private timer;
+    constructor(userDataDir: string, profileName: string);
+    acquire(): void;
+    release(): void;
+    private hold;
+}

package/dist/types/profile-browser/browser/manager.d.ts

@@ -4,6 +4,7 @@ import { SecretRegistry } from "../page/secrets.js";
 import { type BrowserLauncher, type ConnectedBrowser } from "./connect.js";
 import { DownloadTracker } from "./downloads.js";
 import type { Size } from "./launch.js";
+import { ProfileLease } from "./lease.js";
 import { Tab, type TabInfo } from "./tabs.js";
 export interface BrowserManagerOptions {
     connect: "managed" | "cdp";
@@ -18,6 +19,7 @@ export interface BrowserManagerOptions {
     keepOpen: boolean;
     launcher?: BrowserLauncher | undefined;
     downloadsDir?: string | undefined;
+    hostAllowed?: ((url: string) => boolean) | undefined;
 }
 export interface BrowserStatus {
     mode: "managed" | "cdp";
@@ -57,6 +59,7 @@ declare class SharedBrowser {
     nextTab: number;
     nextLane: number;
     closingIntentionally: boolean;
+    lease: ProfileLease | undefined;
     product: {
         product: string;
         version: string;
@@ -68,6 +71,7 @@ declare class SharedBrowser {
     readonly downloads: DownloadTracker;
     readonly secrets: SecretRegistry;
     readonly dataflow: DataFlowGuard;
+    readonly blockedLoads: Map<string, string>;
     constructor(downloadsDir: string | undefined);
 }
 export declare class BrowserManager {
@@ -101,6 +105,9 @@ export declare class BrowserManager {
     drainNotices(): string[];
     ensureConnected(signal?: AbortSignal): Promise<CdpConnection>;
     private connect;
+    private guardNewPages;
+    private guardPage;
+    private agentOwned;
     private requireCdpUrl;
     private onDisconnect;
     private tabIdFor;
@@ -112,6 +119,8 @@ export declare class BrowserManager {
     private own;
     private info;
     tabs(): TabInfo[];
+    tabPattern(tabId?: string): string | undefined;
+    userTab(tab: Tab): boolean;
     openedSince(since: number, openerTargetIds: string[]): TabInfo[];
     private attach;
     activeTab(signal?: AbortSignal): Promise<Tab>;

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

@@ -16,6 +16,8 @@ export interface JsDialog {
     message: string;
     defaultPrompt?: string;
 }
+export declare function blockOffHostLoads(session: CdpSession, mainFrameId: () => string, hostAllowed: (url: string) => boolean, onBlocked: (url: string) => void): () => void;
+export declare function enableLoadBlocking(session: CdpSession, signal?: AbortSignal): Promise<unknown>;
 export declare class Tab {
     readonly tabId: string;
     readonly targetId: string;
@@ -36,6 +38,9 @@ export declare class Tab {
     } | undefined;
     lastFingerprint: string | undefined;
     unchangedStreak: number;
+    blockedNavigation: string | undefined;
+    errorPage: boolean;
+    private repeats;
     private readonly offs;
     private constructor();
     static attach(connection: CdpConnection, target: {
@@ -45,7 +50,8 @@ export declare class Tab {
     }, tabId: string, openedByAgent: boolean, signal?: AbortSignal, emulateViewport?: {
         width: number;
         height: number;
-    }): Promise<Tab>;
+    }, hostAllowed?: (url: string) => boolean): Promise<Tab>;
+    countRepeat(documentId: string, key: string): number;
     get detached(): boolean;
     info(active: boolean): TabInfo;
     dispose(): void;

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

@@ -18,4 +18,5 @@ export { BrowserManager };
 export { closeManaged, managedState } from "./browser/connect.js";
 export { discoverBrowser } from "./browser/discover.js";
 export { launchForSignIn } from "./browser/launch.js";
+export { type LeaseHolder, liveHolder, ProfileInUseError, profileInUseMessage, } from "./browser/lease.js";
 export default browserProfile;

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

@@ -35,6 +35,7 @@ export interface PageNode {
     options?: string[];
     optionCount?: number;
     cursorOnly?: boolean;
+    focusable?: boolean;
     form?: {
         post: boolean;
         submit?: boolean;

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

@@ -21,7 +21,6 @@ export interface ObserveOptions {
 export declare function estimateTokens(text: string): number;
 export declare function fingerprintOf(url: string, body: string): string;
 interface HeaderFacts {
-    title: string;
     url: string;
     scrollY?: number;
     pageHeight?: number;
@@ -35,5 +34,6 @@ export declare function renderHeader(facts: HeaderFacts, tabs: {
     count: number;
     active: string;
 }, dialog: JsDialog | undefined): string;
+export declare function pageFacts(title: string, dialog?: JsDialog): string[];
 export declare function observe(manager: BrowserManager, tab: Tab, stopwatch: Stopwatch, signal?: AbortSignal, options?: ObserveOptions): Promise<Observation>;
 export {};

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

@@ -11,9 +11,11 @@ export interface RenderOptions {
     budgetTokens?: number | undefined;
     previous?: Seen | undefined;
     expandLandmarks?: boolean | undefined;
+    preamble?: string[] | undefined;
 }
 export interface RenderedSnapshot {
     text: string;
+    canonical: string;
     refs: Set<string>;
     texts: Set<string>;
     landmarks: Map<string, string>;
@@ -24,4 +26,5 @@ export declare function displayUrl(url: string, pageUrl: string): string;
 export declare function mergeSeen(previous: Seen | undefined, rendered: Seen): Seen;
 export declare function textKey(node: PageNode): string;
 export declare function describeNode(node: PageNode, pageUrl: string): string;
+export declare function fencePageContent(lines: string[]): string;
 export declare function renderSnapshot(model: PageModel, options?: RenderOptions): RenderedSnapshot;

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

@@ -1,9 +1,11 @@
 import type { PageModel, PageNode } from "./model.js";
 export declare const READ_PAGE_CHARS = 12000;
-export declare function pageMarkdown(model: PageModel): {
+export interface PageText {
     markdown: string;
+    full: string;
     scope: string;
-};
+}
+export declare function pageMarkdown(model: PageModel): PageText;
 export declare function filterSections(markdown: string, query: string): string;
 export declare function paginate(text: string, offset: number, size?: number): {
     chunk: string;

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

@@ -3,6 +3,7 @@ export interface FixtureSite {
     origin: string;
     crossOrigin: string;
     url: (page: string) => string;
+    requests: string[];
     submissions: Record<string, unknown>[];
     signups: {
         email: string;

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

@@ -11,7 +11,14 @@ export interface BrowserToolDeps {
     notes?: () => string;
 }
 export declare const observationKey: (slot: number) => string;
+export declare function repeatNudge(tab: Tab, documentId: string, tool: string, key: string): string | undefined;
 export type ActResult = ActionResult;
+export interface HostBlock {
+    result: ActResult;
+    withhold: boolean;
+}
+export declare function enforceHosts(deps: BrowserToolDeps, tab: Tab, signal: AbortSignal): Promise<HostBlock | undefined>;
+export declare function withheldResult(block: HostBlock, tab: Tab, stopwatch: Stopwatch): ToolResult;
 export interface PageActionOptions {
     blockedByDialog?: boolean;
     screenshot?: boolean;
@@ -19,5 +26,7 @@ export interface PageActionOptions {
     subtreeRef?: string;
     detectChange?: boolean;
     tabSwitch?: boolean;
+    leavesPage?: boolean;
+    repeatTool?: string;
 }
 export declare function pageAction(deps: BrowserToolDeps, toolSignal: AbortSignal, act: (tab: Tab, stopwatch: Stopwatch, signal: AbortSignal) => Promise<ActResult>, options?: PageActionOptions): Promise<ToolResult>;

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

@@ -135,6 +135,7 @@ export declare class Agent {
     setPermissions(rules: PermissionRule[]): void;
     addPermissionRule(rule: PermissionRule): void;
     setModel(ref: string | ModelInfo): void;
+    refreshModelInfo(): boolean;
     setThinking(level: ThinkingLevel): void;
     resume(tree: SessionTree): void;
     newSession(sessionId?: string): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mu-agent/mu",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Mu, a general-purpose extensible AI agent platform for the terminal and TypeScript",
   "type": "module",
   "main": "./dist/index.js",
@@ -21,6 +21,7 @@
     "dist/types",
     "README.md",
     "LICENSE",
+    "NOTICE",
     "THIRD_PARTY_LICENSES.txt"
   ],
   "scripts": {
@@ -38,7 +39,7 @@
     "typescript"
   ],
   "author": "Spandan Chavan",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Spandan7724/mu.git",