actoviq-agent-sdk 0.4.7 → 0.4.8

package/dist/src/browser/actoviqBrowserTools.d.ts

@@ -0,0 +1,80 @@
+import type { AgentToolDefinition, CreateActoviqBrowserUseOptions, LocalMcpServerDefinition } from '../types.js';
+import { ActoviqBrowserSession, type ActoviqBrowserSessionOptions } from './actoviqBrowserSession.js';
+export interface ActoviqBrowserUseToolkit {
+    tools: AgentToolDefinition[];
+    mcpServer: LocalMcpServerDefinition;
+    session: ActoviqBrowserSession;
+}
+export interface ActoviqBrowserSessionLike {
+    navigate(url: string, opts?: {
+        newTab?: boolean;
+    }): Promise<{
+        tabId: string;
+        url: string;
+        title: string;
+    }>;
+    goBack(): Promise<{
+        url: string;
+        title: string;
+    }>;
+    wait(ms: number): Promise<void>;
+    snapshot(opts?: {
+        interactiveOnly?: boolean;
+        maxElements?: number;
+    }): Promise<unknown>;
+    click(target: {
+        index?: number;
+        x?: number;
+        y?: number;
+    }): Promise<{
+        ok: true;
+    }>;
+    type(input: {
+        index: number;
+        text: string;
+        clear?: boolean;
+        submit?: boolean;
+    }): Promise<{
+        ok: true;
+    }>;
+    press(keys: string): Promise<{
+        ok: true;
+    }>;
+    scroll(input: {
+        direction: 'up' | 'down';
+        pages?: number;
+        index?: number;
+    }): Promise<{
+        ok: true;
+    }>;
+    screenshot(opts?: {
+        path?: string;
+        fullPage?: boolean;
+    }): Promise<{
+        path?: string;
+        base64?: string;
+    }>;
+    tabsDetailed(): Promise<unknown>;
+    switchTab(tabId: string): Promise<{
+        ok: true;
+        tabId: string;
+    }>;
+    closeTab(tabId?: string): Promise<{
+        ok: true;
+        closed: string;
+    }>;
+    extract(): Promise<{
+        url: string;
+        title: string;
+        text: string;
+    }>;
+    evaluate?(expression: string): Promise<{
+        result: unknown;
+    }>;
+    close(): Promise<void>;
+}
+export declare function sessionOptionsFromBrowserUse(options?: CreateActoviqBrowserUseOptions): ActoviqBrowserSessionOptions;
+export declare function createActoviqBrowserTools(options?: CreateActoviqBrowserUseOptions): AgentToolDefinition[];
+export declare function createActoviqBrowserUseMcpServer(options?: CreateActoviqBrowserUseOptions): LocalMcpServerDefinition;
+export declare function createActoviqBrowserUseToolkit(options?: CreateActoviqBrowserUseOptions): ActoviqBrowserUseToolkit;
+//# sourceMappingURL=actoviqBrowserTools.d.ts.map

package/dist/src/browser/actoviqBrowserTools.d.ts.map

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

package/dist/src/browser/actoviqBrowserTools.js

@@ -0,0 +1,177 @@
+import { z } from 'zod';
+import { tool } from '../runtime/tools.js';
+import { ActoviqBrowserSession, } from './actoviqBrowserSession.js';
+function withPrefix(prefix, suffix) {
+    return prefix?.trim() ? `${prefix}_${suffix}` : `browser_${suffix}`;
+}
+export function sessionOptionsFromBrowserUse(options = {}) {
+    return {
+        headless: options.headless,
+        channel: options.channel,
+        cdpUrl: options.cdpUrl,
+        userDataDir: options.userDataDir,
+        workspaceDir: options.workspaceDir,
+        allowedDomains: options.allowedDomains,
+        defaultTimeoutMs: options.defaultTimeoutMs,
+        viewport: options.viewport,
+    };
+}
+export function createActoviqBrowserTools(options = {}) {
+    const session = options.session ?? new ActoviqBrowserSession(sessionOptionsFromBrowserUse(options));
+    const allowEvaluate = options.allowEvaluate === true;
+    const requiresHostSessionApproval = () => Boolean(options.cdpUrl?.trim() || options.userDataDir?.trim());
+    const tools = [
+        tool({
+            name: withPrefix(options.prefix, 'navigate'),
+            description: 'Open a URL in the controlled browser (Playwright). Prefer this for page automation; use computer_* for OS-level actions.',
+            inputSchema: z.object({
+                url: z.string().url(),
+                newTab: z.boolean().optional(),
+            }),
+            isDestructive: () => false,
+            requiresUserInteraction: requiresHostSessionApproval,
+        }, async ({ url, newTab }) => session.navigate(url, { newTab })),
+        tool({
+            name: withPrefix(options.prefix, 'go_back'),
+            description: 'Navigate the active browser tab back in history.',
+            inputSchema: z.object({}),
+            requiresUserInteraction: requiresHostSessionApproval,
+        }, async () => session.goBack()),
+        tool({
+            name: withPrefix(options.prefix, 'wait'),
+            description: 'Wait briefly for the page to settle before the next browser action.',
+            inputSchema: z.object({
+                ms: z.number().int().min(0).max(60_000).optional(),
+            }),
+            requiresUserInteraction: requiresHostSessionApproval,
+        }, async ({ ms }) => {
+            await session.wait(ms ?? 1000);
+            return { ok: true, ms: ms ?? 1000 };
+        }),
+        tool({
+            name: withPrefix(options.prefix, 'snapshot'),
+            description: 'Capture the current page URL/title and a numbered list of interactive elements. Use element indexes with browser_click / browser_type (browser-use style).',
+            inputSchema: z.object({
+                interactiveOnly: z.boolean().optional(),
+                maxElements: z.number().int().min(1).max(300).optional(),
+            }),
+            isReadOnly: () => true,
+            requiresUserInteraction: requiresHostSessionApproval,
+        }, async (input) => session.snapshot(input)),
+        tool({
+            name: withPrefix(options.prefix, 'click'),
+            description: 'Click an interactive element by snapshot index, or by viewport x/y coordinates.',
+            inputSchema: z.object({
+                index: z.number().int().min(0).optional(),
+                x: z.number().optional(),
+                y: z.number().optional(),
+            }),
+            requiresUserInteraction: requiresHostSessionApproval,
+        }, async (input) => session.click(input)),
+        tool({
+            name: withPrefix(options.prefix, 'type'),
+            description: 'Type into an interactive element identified by browser_snapshot index.',
+            inputSchema: z.object({
+                index: z.number().int().min(0),
+                text: z.string(),
+                clear: z.boolean().optional(),
+                submit: z.boolean().optional(),
+            }),
+            requiresUserInteraction: requiresHostSessionApproval,
+        }, async (input) => session.type(input)),
+        tool({
+            name: withPrefix(options.prefix, 'press'),
+            description: 'Press a key or chord in the active page (Playwright key names, e.g. Enter, Control+a).',
+            inputSchema: z.object({
+                keys: z.string().min(1),
+            }),
+            requiresUserInteraction: requiresHostSessionApproval,
+        }, async ({ keys }) => session.press(keys)),
+        tool({
+            name: withPrefix(options.prefix, 'scroll'),
+            description: 'Scroll the page, or scroll a snapshot element into view.',
+            inputSchema: z.object({
+                direction: z.enum(['up', 'down']).optional(),
+                pages: z.number().int().min(1).max(10).optional(),
+                index: z.number().int().min(0).optional(),
+            }),
+            requiresUserInteraction: requiresHostSessionApproval,
+        }, async (input) => session.scroll({
+            direction: input.direction ?? 'down',
+            pages: input.pages,
+            index: input.index,
+        })),
+        tool({
+            name: withPrefix(options.prefix, 'screenshot'),
+            description: 'Capture a PNG screenshot of the active tab. Provide path to save on disk, otherwise returns base64.',
+            inputSchema: z.object({
+                path: z.string().min(1).optional(),
+                fullPage: z.boolean().optional(),
+            }),
+            isReadOnly: (input) => !input?.path,
+            isDestructive: (input) => Boolean(input?.path),
+            requiresUserInteraction: requiresHostSessionApproval,
+        }, async (input) => session.screenshot(input)),
+        tool({
+            name: withPrefix(options.prefix, 'tabs'),
+            description: 'List open browser tabs (id, url, title, active).',
+            inputSchema: z.object({}),
+            isReadOnly: () => true,
+            requiresUserInteraction: requiresHostSessionApproval,
+        }, async () => ({ tabs: await session.tabsDetailed() })),
+        tool({
+            name: withPrefix(options.prefix, 'switch'),
+            description: 'Switch the active browser tab by id from browser_tabs.',
+            inputSchema: z.object({
+                tabId: z.string().min(1),
+            }),
+            requiresUserInteraction: requiresHostSessionApproval,
+        }, async ({ tabId }) => session.switchTab(tabId)),
+        tool({
+            name: withPrefix(options.prefix, 'close'),
+            description: 'Close a browser tab (defaults to the active tab). Closing the last tab opens a blank one.',
+            inputSchema: z.object({
+                tabId: z.string().min(1).optional(),
+            }),
+            requiresUserInteraction: requiresHostSessionApproval,
+        }, async ({ tabId }) => session.closeTab(tabId)),
+        tool({
+            name: withPrefix(options.prefix, 'extract'),
+            description: 'Extract visible text from the active page (truncated). Prefer snapshot for interactive control.',
+            inputSchema: z.object({}),
+            isReadOnly: () => true,
+            requiresUserInteraction: requiresHostSessionApproval,
+        }, async () => session.extract()),
+    ];
+    if (allowEvaluate && session.evaluate) {
+        tools.push(tool({
+            name: withPrefix(options.prefix, 'evaluate'),
+            description: 'Evaluate a JavaScript expression in the page. Potentially dangerous; only enabled when allowEvaluate is true.',
+            inputSchema: z.object({
+                expression: z.string().min(1),
+            }),
+            isDestructive: () => true,
+            requiresUserInteraction: requiresHostSessionApproval,
+        }, async ({ expression }) => session.evaluate(expression)));
+    }
+    return tools;
+}
+export function createActoviqBrowserUseMcpServer(options = {}) {
+    return {
+        kind: 'local',
+        name: options.serverName ?? 'actoviq-browser-use',
+        prefix: options.prefix ?? 'browser',
+        tools: createActoviqBrowserTools(options),
+    };
+}
+export function createActoviqBrowserUseToolkit(options = {}) {
+    const session = options.session ??
+        new ActoviqBrowserSession(sessionOptionsFromBrowserUse(options));
+    const next = { ...options, session };
+    return {
+        tools: createActoviqBrowserTools(next),
+        mcpServer: createActoviqBrowserUseMcpServer(next),
+        session,
+    };
+}
+//# sourceMappingURL=actoviqBrowserTools.js.map

package/dist/src/browser/actoviqBrowserTools.js.map

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

package/dist/src/browser/browserSettings.d.ts

@@ -0,0 +1,8 @@
+import type { CreateActoviqBrowserUseOptions } from '../types.js';
+export interface ActoviqBrowserSettings extends CreateActoviqBrowserUseOptions {
+    /** When true, GUI/SDK hosts may auto-attach browser tools. */
+    enabled?: boolean;
+}
+export declare function readActoviqBrowserSettings(raw: Record<string, unknown> | null | undefined): ActoviqBrowserSettings;
+export declare function writeActoviqBrowserSettings(raw: Record<string, unknown>, patch: Partial<ActoviqBrowserSettings>): Record<string, unknown>;
+//# sourceMappingURL=browserSettings.d.ts.map

package/dist/src/browser/browserSettings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserSettings.d.ts","sourceRoot":"","sources":["../../../src/browser/browserSettings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAElE,MAAM,WAAW,sBAAuB,SAAQ,8BAA8B;IAC5E,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAMD,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,sBAAsB,CAsBlH;AAED,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,KAAK,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACrC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBzB"}

package/dist/src/browser/browserSettings.js

@@ -0,0 +1,47 @@
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+export function readActoviqBrowserSettings(raw) {
+    const source = isRecord(raw?.browser) ? raw.browser : {};
+    const allowedDomains = Array.isArray(source.allowedDomains)
+        ? source.allowedDomains.filter((item) => typeof item === 'string' && item.trim().length > 0)
+        : undefined;
+    const channel = source.channel === 'chrome' || source.channel === 'msedge' || source.channel === 'chromium'
+        ? source.channel
+        : undefined;
+    return {
+        enabled: source.enabled === true,
+        headless: typeof source.headless === 'boolean' ? source.headless : undefined,
+        channel,
+        cdpUrl: typeof source.cdpUrl === 'string' ? source.cdpUrl : undefined,
+        userDataDir: typeof source.userDataDir === 'string' ? source.userDataDir : undefined,
+        allowedDomains,
+        defaultTimeoutMs: typeof source.defaultTimeoutMs === 'number' && Number.isFinite(source.defaultTimeoutMs)
+            ? Math.max(1_000, Math.min(180_000, Math.trunc(source.defaultTimeoutMs)))
+            : undefined,
+        allowEvaluate: source.allowEvaluate === true,
+    };
+}
+export function writeActoviqBrowserSettings(raw, patch) {
+    const current = readActoviqBrowserSettings(raw);
+    const next = {
+        ...current,
+        ...patch,
+    };
+    raw.browser = {
+        enabled: next.enabled === true,
+        headless: next.headless !== false,
+        ...(next.channel ? { channel: next.channel } : {}),
+        ...(next.cdpUrl?.trim() ? { cdpUrl: next.cdpUrl.trim() } : {}),
+        ...(next.userDataDir?.trim() ? { userDataDir: next.userDataDir.trim() } : {}),
+        ...(next.allowedDomains && next.allowedDomains.length > 0
+            ? { allowedDomains: next.allowedDomains }
+            : {}),
+        ...(typeof next.defaultTimeoutMs === 'number'
+            ? { defaultTimeoutMs: next.defaultTimeoutMs }
+            : {}),
+        allowEvaluate: next.allowEvaluate === true,
+    };
+    return raw;
+}
+//# sourceMappingURL=browserSettings.js.map

package/dist/src/browser/browserSettings.js.map

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

package/dist/src/cli/actoviq-react.js

@@ -6,7 +6,7 @@
  * and real-time streaming output. Uses the main terminal buffer for
  * native scrollback.
  */
-import { createAgentSdk, loadJsonConfigFile, loadDefaultActoviqSettings, getLoadedJsonConfig, createActoviqCoreTools, listWorkflows, loadWorkflow, listTeamDefinitions, loadTeamDefinition, cloneTeamDefinition, instantiateTeamDefinition, listTeamAgentLabels, countTeamAgents, createModelTeam, createTeamTool, readTeamPreferences, createManagerTools, buildManagerSystemPrompt, buildUpdateProgressPrompt, formatManagerUpdatePreview, resolveGitHubDigestForUpdate, readManagerConfig, writeManagerConfig, readProjectPlanFile, readProgressFile, managerProgressPath, createProjectIssue, executeProjectIssue, isIssueStatus, isIssueStorageMode, listProjectIssues, listScheduledAutomationTasks, resolveActoviqHome, transitionProjectIssue, WorktreeService, } from 'actoviq-agent-sdk';
+import { createAgentSdk, loadJsonConfigFile, loadDefaultActoviqSettings, getLoadedJsonConfig, createActoviqCoreTools, createManagedPluginRuntime, resolveActoviqSettingsStore, listWorkflows, loadWorkflow, listTeamDefinitions, loadTeamDefinition, cloneTeamDefinition, instantiateTeamDefinition, listTeamAgentLabels, countTeamAgents, createModelTeam, createTeamTool, readTeamPreferences, createManagerTools, buildManagerSystemPrompt, buildUpdateProgressPrompt, formatManagerUpdatePreview, resolveGitHubDigestForUpdate, readManagerConfig, writeManagerConfig, readProjectPlanFile, readProgressFile, managerProgressPath, createProjectIssue, executeProjectIssue, isIssueStatus, isIssueStorageMode, listProjectIssues, listScheduledAutomationTasks, resolveActoviqHome, externalSkillPreferencesToRuntimeOptions, readActoviqExternalSkillPreferences, transitionProjectIssue, WorktreeService, } from 'actoviq-agent-sdk';
 import { readProjectMeta } from '../gui/projectMeta.js';
 import { LegacySurfaceEventPipeline, } from '../surfaces/index.js';
 import { applyTeamRunEvent, createTeamRunViewState, formatTeamRunTreeLines } from '../team/teamRunView.js';
@@ -21,6 +21,8 @@ if (hasVersionFlag(process.argv.slice(2))) {
 const WORK_DIR = path.resolve(process.argv[2] ?? process.cwd());
 const CONFIG_PATH = process.argv[3] ?? path.join(resolveActoviqHome(), 'settings.json');
 const DEFAULT_PERMISSION_MODE = 'bypassPermissions';
+const MANAGED_PLUGIN_FINAL_CLOSE_ATTEMPTS = 2;
+const MANAGED_PLUGIN_FINAL_CLOSE_TIMEOUT_MS = 35_000;
 const PERMISSION_MODES = new Set([
     'default',
     'acceptEdits',
@@ -114,12 +116,42 @@ function resultLine(isErr, dur, output) {
     process.stdout.write(`${ok}${C.r}${C.d}${d} ${o}${C.r}\n`);
 }
 // ═══════════════════════════════════════════════════════════════════════
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+async function closeManagedPluginsForExit(close) {
+    const failures = [];
+    for (let attempt = 1; attempt <= MANAGED_PLUGIN_FINAL_CLOSE_ATTEMPTS; attempt += 1) {
+        let timer;
+        try {
+            await Promise.race([
+                close(),
+                new Promise((_, reject) => {
+                    timer = setTimeout(() => {
+                        reject(new Error(`managed plugin cleanup timed out after ${MANAGED_PLUGIN_FINAL_CLOSE_TIMEOUT_MS}ms`));
+                    }, MANAGED_PLUGIN_FINAL_CLOSE_TIMEOUT_MS);
+                }),
+            ]);
+            return;
+        }
+        catch (error) {
+            failures.push(error);
+            process.stderr.write(`[actoviq-react] warning: managed plugin cleanup attempt ${attempt}/` +
+                `${MANAGED_PLUGIN_FINAL_CLOSE_ATTEMPTS} failed: ${errorMessage(error)}\n`);
+        }
+        finally {
+            if (timer)
+                clearTimeout(timer);
+        }
+    }
+    throw new AggregateError(failures, 'Managed plugin cleanup failed after bounded retries; an external sandbox may remain active and billing may continue.');
+}
 async function main() {
     // Header
     const w = process.stdout.columns || 80;
     process.stdout.write(`\n${C.c}${C.b}╭${'─'.repeat(Math.min(w - 2, 60))}╮${C.r}\n`);
     process.stdout.write(`${C.c}│${C.r}  dir     : ${C.y}${WORK_DIR.slice(0, 45)}${C.r}\n`);
-    const tools = createActoviqCoreTools({ cwd: WORK_DIR });
+    const coreTools = createActoviqCoreTools({ cwd: WORK_DIR });
     const userSuppliedConfig = Boolean(process.argv[3]);
     try {
         if (userSuppliedConfig)
@@ -144,16 +176,65 @@ async function main() {
             process.stderr.write(`${C.y}⚠ Default settings load failed: ${msg}${C.r}\n`);
         }
     }
+    const managedPluginRuntime = await resolveActoviqSettingsStore({
+        configPath: CONFIG_PATH,
+    }).then(store => createManagedPluginRuntime(store.raw, {
+        cwd: WORK_DIR,
+    })).catch(() => ({
+        tools: [],
+        enabledPluginIds: [],
+        close: async () => undefined,
+    }));
+    const tools = [...new Map([...coreTools, ...managedPluginRuntime.tools].map(tool => [tool.name, tool])).values()];
+    const externalSkillPreferences = await readActoviqExternalSkillPreferences({
+        actoviqHomeDir: resolveActoviqHome(),
+        workDir: WORK_DIR,
+    });
+    let pendingToolApproval = null;
+    const approver = async (context) => {
+        if (!process.stdin.isTTY) {
+            return {
+                behavior: 'deny',
+                reason: 'Interactive approval requires a TTY.',
+            };
+        }
+        if (pendingToolApproval) {
+            return {
+                behavior: 'deny',
+                reason: 'Another tool approval is already pending.',
+            };
+        }
+        let input = '';
+        try {
+            input = JSON.stringify(context.input);
+        }
+        catch {
+            input = '[unserializable input]';
+        }
+        process.stdout.write(`\n${C.y}Approval required:${C.r} ${C.b}${context.publicName}${C.r}\n` +
+            `${C.d}${context.reason}${input ? `\n${input.slice(0, 500)}` : ''}${C.r}\n` +
+            'Allow this tool once? [y/N] ');
+        return await new Promise(resolve => {
+            pendingToolApproval = { resolve };
+        });
+    };
     const sdk = await createAgentSdk({
         workDir: WORK_DIR,
         tools,
         permissionMode: DEFAULT_PERMISSION_MODE,
+        approver,
+        externalSkills: externalSkillPreferencesToRuntimeOptions(externalSkillPreferences),
     });
     const toolMetadata = await sdk.listToolMetadata();
     let session = await sdk.createSession({
         title: path.basename(WORK_DIR),
         permissionMode: DEFAULT_PERMISSION_MODE,
     });
+    await session.setPermissionContext({
+        mode: session.permissionContext.mode ?? DEFAULT_PERMISSION_MODE,
+        permissions: session.permissionContext.permissions,
+        approver,
+    });
     process.stdout.write(`${C.c}│${C.r}  model   : ${C.y}${session.model}${C.r}\n`);
     process.stdout.write(`${C.c}│${C.r}  tools   : ${C.y}${toolMetadata.length} tools loaded${C.r}\n`);
     process.stdout.write(`${C.c}│${C.r}  keys    : Tab=complete  ↑↓=history  Ctrl+C=abort${C.r}\n`);
@@ -199,6 +280,11 @@ async function main() {
         const existing = managers[0];
         if (existing) {
             managerSession = await sdk.resumeSession(existing.id, { permissionMode: DEFAULT_PERMISSION_MODE });
+            await managerSession.setPermissionContext({
+                mode: managerSession.permissionContext.mode ?? DEFAULT_PERMISSION_MODE,
+                permissions: managerSession.permissionContext.permissions,
+                approver,
+            });
             return managerSession;
         }
         managerSession = await sdk.createSession({
@@ -206,6 +292,11 @@ async function main() {
             metadata: { __actoviqKind: 'manager' },
             permissionMode: DEFAULT_PERMISSION_MODE,
         });
+        await managerSession.setPermissionContext({
+            mode: managerSession.permissionContext.mode ?? DEFAULT_PERMISSION_MODE,
+            permissions: managerSession.permissionContext.permissions,
+            approver,
+        });
         return managerSession;
     }
     // ── Process message ────────────────────────────────────────────
@@ -255,6 +346,7 @@ async function main() {
                     await session.setPermissionContext({
                         mode: requested,
                         permissions: state.permissions,
+                        approver,
                     });
                     process.stdout.write(`${C.g}Permission mode set to ${C.y}${requested}${C.r}\n\n`);
                     return;
@@ -285,6 +377,11 @@ async function main() {
                         return;
                     }
                     session = await sdk.resumeSession(sessionId);
+                    await session.setPermissionContext({
+                        mode: session.permissionContext.mode ?? DEFAULT_PERMISSION_MODE,
+                        permissions: session.permissionContext.permissions,
+                        approver,
+                    });
                     process.stdout.write(`${C.g}Resumed ${session.id}: ${session.title} (${session.model})${C.r}\n\n`);
                     return;
                 }
@@ -766,6 +863,7 @@ async function main() {
                                 systemPrompt: buildManagerSystemPrompt(WORK_DIR, cfg),
                                 tools: managerTools,
                                 signal: abortCtrl.signal,
+                                approver,
                                 ...(cfg.model ? { model: cfg.model } : {}),
                                 __actoviqUseDefaultTools: false,
                                 __actoviqAllowedTools: managerTools.map(tool => tool.name),
@@ -817,6 +915,7 @@ async function main() {
             signal: abortCtrl.signal,
             model: session.model,
             permissionMode: session.permissionContext.mode ?? DEFAULT_PERMISSION_MODE,
+            approver,
             // Attached team is only exposed to the main agent when autoInvoke is on;
             // otherwise attach is a selection and /team ask stays the manual path.
             ...(activeTeamTool && teamPrefs.autoInvoke ? { tools: [activeTeamTool] } : {}),
@@ -904,8 +1003,17 @@ async function main() {
         if (shuttingDown)
             return;
         shuttingDown = true;
+        let exitCode = code;
         if (ccT)
             clearTimeout(ccT);
+        if (pendingToolApproval) {
+            const approval = pendingToolApproval;
+            pendingToolApproval = null;
+            approval.resolve({
+                behavior: 'deny',
+                reason: 'The interactive session is shutting down.',
+            });
+        }
         abortCtrl?.abort();
         if (process.stdin.isTTY)
             process.stdin.setRawMode(false);
@@ -913,17 +1021,36 @@ async function main() {
         if (closeReadline)
             rl.close();
         process.stdout.write(`\n${C.d}Goodbye.${C.r}\n`);
+        try {
+            await closeManagedPluginsForExit(managedPluginRuntime.close);
+        }
+        catch (error) {
+            exitCode = 1;
+            process.stderr.write(`[actoviq-react] ERROR: ${errorMessage(error)} ` +
+                'Check E2B/Playwright resources manually before assuming billing has stopped.\n');
+        }
         try {
             await sdk.close();
         }
-        catch { }
-        process.exit(code);
+        catch (error) {
+            exitCode = 1;
+            process.stderr.write(`[actoviq-react] ERROR: SDK cleanup failed: ${errorMessage(error)}\n`);
+        }
+        process.exit(exitCode);
     }
     readline.emitKeypressEvents(process.stdin);
     if (process.stdin.isTTY)
         process.stdin.setRawMode(true);
     process.stdin.on('keypress', (_ch, key) => {
         if (key?.name === 'c' && key?.ctrl) {
+            if (pendingToolApproval) {
+                const approval = pendingToolApproval;
+                pendingToolApproval = null;
+                approval.resolve({
+                    behavior: 'deny',
+                    reason: 'The user interrupted the approval prompt.',
+                });
+            }
             cc++;
             if (cc >= 2) {
                 void shutdown(0);
@@ -945,6 +1072,19 @@ async function main() {
     rl.prompt();
     rl.on('line', async (line) => {
         const queued = line.trim();
+        if (pendingToolApproval) {
+            const approval = pendingToolApproval;
+            pendingToolApproval = null;
+            const allowed = /^(?:y|yes)$/i.test(queued);
+            approval.resolve({
+                behavior: allowed ? 'allow' : 'deny',
+                reason: allowed
+                    ? 'The user approved this tool once.'
+                    : 'The user denied this tool.',
+            });
+            process.stdout.write(`${allowed ? `${C.g}Allowed` : `${C.y}Denied`}.${C.r}\n`);
+            return;
+        }
         if (abortCtrl) {
             if (!queued) {
                 rl.prompt();