@anweat/dsh-browser 0.1.15 → 0.2.0-rc.1

package/lib/actions/inspect.js

@@ -0,0 +1,35 @@
+/** `inspect` group: captured console and network records. @module dsh-browser/actions/inspect */
+export const INSPECT_ACTIONS = [
+    {
+        name: 'inspect.console',
+        group: 'inspect',
+        summary: 'Read bounded, redacted console records captured since the last target.open with capture=["console"].',
+        notes: 'Records stay in memory and omit console argument objects.',
+        params: {
+            level: { type: 'string', enum: ['debug', 'log', 'info', 'warning', 'error'], description: 'Minimum severity. Defaults to debug.' },
+            limit: { type: 'number', description: 'Newest 1-200 records. Default 100.' },
+            clear: { type: 'boolean', description: 'Clear captured records after reading.' },
+        },
+        approval: 'none', readOnly: true, mutating: false, concurrencySafe: true, timeoutMs: 10_000,
+        examples: [{ args: { level: 'error' } }],
+        async execute(args, ctx) {
+            return ctx.service.consoleMessages({ ...args, session: ctx.session });
+        },
+    },
+    {
+        name: 'inspect.requests',
+        group: 'inspect',
+        summary: 'Read bounded, redacted failed and HTTP 4xx/5xx requests captured since the last target.open with capture=["network"].',
+        notes: 'Request/response bodies and headers are never recorded.',
+        params: {
+            limit: { type: 'number', description: 'Newest 1-200 records. Default 100.' },
+            clear: { type: 'boolean', description: 'Clear captured records after reading.' },
+        },
+        approval: 'none', readOnly: true, mutating: false, concurrencySafe: true, timeoutMs: 10_000,
+        examples: [{ args: {} }],
+        async execute(args, ctx) {
+            return ctx.service.networkRequests({ ...args, session: ctx.session });
+        },
+    },
+];
+//# sourceMappingURL=inspect.js.map

package/lib/actions/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","sourceRoot":"","sources":["../../src/actions/inspect.ts"],"names":[],"mappings":"AAAA,iGAAiG;AAIjG,MAAM,CAAC,MAAM,eAAe,GAAgB;IAC1C;QACE,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,sGAAsG;QAC/G,KAAK,EAAE,2DAA2D;QAClE,MAAM,EAAE;YACN,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,sCAAsC,EAAE;YAClI,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oCAAoC,EAAE;YAC5E,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,uCAAuC,EAAE;SACjF;QACD,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM;QAC3F,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC;QACxC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG;YACrB,OAAO,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAA;QACvE,CAAC;KACF;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,uHAAuH;QAChI,KAAK,EAAE,yDAAyD;QAChE,MAAM,EAAE;YACN,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oCAAoC,EAAE;YAC5E,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,uCAAuC,EAAE;SACjF;QACD,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM;QAC3F,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QACxB,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG;YACrB,OAAO,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAA;QACvE,CAAC;KACF;CACF,CAAA"}

package/lib/actions/observe.d.ts

@@ -0,0 +1,3 @@
+/** `observe` group: read the page, take screenshots. @module dsh-browser/actions/observe */
+import { type ActionDef } from './types.ts';
+export declare const OBSERVE_ACTIONS: ActionDef[];

package/lib/actions/observe.js

@@ -0,0 +1,121 @@
+/** `observe` group: read the page, take screenshots. @module dsh-browser/actions/observe */
+import { ActionArgError } from "./types.js";
+import { TARGET_PARAMS } from "./schema.js";
+import { targetOf } from "./shared.js";
+import { ObserveArgError, OBSERVE_SECTIONS } from "../observe.js";
+const OBSERVE_TOPICS = {
+    controls: {
+        summary: 'fields of a controls record',
+        text: [
+            'One record per control: input, select, textarea, button, summary, contenteditable, ARIA widget (role=button, checkbox, ...). Radio inputs sharing a name are ONE record with role radiogroup and options. Open shadow DOM and same-origin iframes are searched.',
+            'Use a record directly: browser_call({action:"act.fill",args:{locator:<record.locator>,text:"..."}}).',
+            'A field that is absent was not observed or does not apply; false always means observed and not so.',
+            '  role, name, type - accessible role and name; type: input type, select-one, select-multiple, textarea, contenteditable.',
+            '  locator - verified on the live page to match this element only; has framePath inside an iframe.',
+            '  ambiguous:true - no unique locator exists. If locator is present it matches `matches` elements and this one is the nth (0-based): add index:nth plus an indexReason, or narrow with observe.read locator.',
+            '  actions - act.* names that can work now; [] when hidden, disabled, or readonly.',
+            '  visible, disabled, readonly, checked (true|false|"mixed"), expanded - states the control has.',
+            '  hasValue - not empty. value appears only with includeValues:true, and never for password, hidden, file, or token-like fields (those carry sensitive:true).',
+            '  options - select: [{value,label,selected,disabled?}], [] means no options; radiogroup: [{label,value,checked,disabled?,locator}].',
+            '  constraints - as declared: required, min, max, step, pattern, minlength, maxlength, accept, multiple.',
+            '  validity - {valid, flags?, validationMessage?} from the browser\'s own constraint validation.',
+            '  source - dom (native element state) or aria (role and aria-* attributes).',
+            'frames lists each iframe searched; a cross-origin or sandboxed one has crossOrigin:true and its content is not observed (act.* can still use its framePath). Closed shadow roots cannot be read.',
+        ].join('\n'),
+    },
+    links: {
+        summary: 'fields of a links record',
+        text: [
+            'One record per a[href] / area[href]: {text, href, locator, visible, target?}. href is absolute. locator is verified unique (role link + name, else the href, id, or testId); same-text links get distinct locators or ambiguous:true as for controls (browser_index({action:"observe.read.controls"})). A secret-looking query value (token, secret, password, session, ...) shows as [redacted] and the link gets no href locator.',
+        ].join('\n'),
+    },
+    tables: {
+        summary: 'fields of a tables record and coverage',
+        text: [
+            'One record per table, or role=table/grid/treegrid element: {name?, locator, headers, rows, totalRows, coverage, reason?, declaredRows?}. rows holds the first maxItems rows as cell text; totalRows is how many rows the DOM holds.',
+            'An empty body is rows:[] and totalRows:0 with its headers: a real empty result, not "not found" (that would be no table record, counts.tables 0).',
+            'coverage:"partial" means the page has more rows than the DOM shows, and reason says why: a virtualized list (aria-rowcount larger than the rendered rows, declaredRows is the declared count) or pagination controls next to the table. Scroll or use the pager (act.*), then observe again. complete only says no such sign was found.',
+        ].join('\n'),
+    },
+    truncation: {
+        summary: 'limits, truncation, and sensitive values',
+        text: [
+            'maxItems caps each section and each table\'s rows; maxBytes caps the whole result (2000-90000). The result is always valid JSON: whole items or rows are dropped from the end, text is cut at a character.',
+            'truncation:{omittedBySection, reason} appears when anything is missing: content counts characters, tableRows counts rows, controls/links/tables count items. counts has how many the page had. No truncation key means nothing was cut.',
+            'To get the rest: raise maxItems/maxBytes, ask for one section, or scope with locator (a form, a table) or region.',
+            'limits (if present) lists what was not covered, such as cross-origin iframes. generation is the page generation at the start of the scan: pass it as expectGeneration to the next act.*.',
+        ].join('\n'),
+    },
+};
+export const OBSERVE_ACTIONS = [
+    {
+        name: 'observe.read',
+        group: 'observe',
+        summary: 'Read the current page: URL, title, readable text; with sections also its controls, links, and tables.',
+        notes: 'Always returns url, title, targetId, generation. Default sections [content] adds text. controls/links/tables give records whose locator you can pass to act.*; a locator is checked unique on the live page. Results are cut at item boundaries to fit maxBytes (truncation lists what is missing).',
+        topics: OBSERVE_TOPICS,
+        params: {
+            sections: { type: 'array', items: { type: 'string', enum: OBSERVE_SECTIONS }, description: 'Any of content (default), controls, links, tables.' },
+            ...TARGET_PARAMS,
+            region: { type: 'object', additionalProperties: false, description: 'Only items that touch this viewport rectangle.', properties: { x: { type: 'number', required: true }, y: { type: 'number', required: true }, width: { type: 'number', required: true }, height: { type: 'number', required: true } } },
+            maxItems: { type: 'number', description: 'Per section, 1-500. Default 50.' },
+            maxBytes: { type: 'number', description: 'Whole result, 2000-90000. Default 24000. Cut at item boundaries; truncation says what is missing.' },
+            includeValues: { type: 'boolean', description: 'Return control values. Never for password, hidden, or token-like fields (hasValue only).' },
+            timeoutMs: { type: 'number', description: 'Wait for the locator, 1-30000 ms.' },
+        },
+        approval: 'none', readOnly: true, mutating: false, concurrencySafe: false, timeoutMs: 30_000,
+        examples: [{ args: {} }, { args: { sections: ['controls'], locator: { role: 'form' } }, note: 'fields of one form' }],
+        async execute(args, ctx) {
+            const plain = ['sections', 'selector', 'locator', 'region', 'maxItems', 'maxBytes', 'includeValues', 'timeoutMs'].every(key => args[key] === undefined);
+            if (plain)
+                return ctx.service.read({ session: ctx.session });
+            try {
+                return await ctx.service.observe({
+                    ...args.sections ? { sections: args.sections } : {},
+                    ...targetOf(args, false) !== undefined ? { target: targetOf(args, false) } : {},
+                    ...args.region ? { region: args.region } : {},
+                    ...args.maxItems !== undefined ? { maxItems: args.maxItems } : {},
+                    ...args.maxBytes !== undefined ? { maxBytes: args.maxBytes } : {},
+                    ...args.includeValues !== undefined ? { includeValues: args.includeValues } : {},
+                    ...args.timeoutMs !== undefined ? { timeoutMs: args.timeoutMs } : {},
+                    session: ctx.session,
+                });
+            }
+            catch (error) {
+                if (error instanceof ObserveArgError)
+                    throw new ActionArgError(error.message);
+                throw error;
+            }
+        },
+    },
+    {
+        name: 'observe.screenshot',
+        group: 'observe',
+        summary: 'Capture the page, a clip region, or one element. Files land inside the configured snapshotDir.',
+        params: {
+            ...TARGET_PARAMS,
+            clip: { type: 'object', additionalProperties: false, properties: {
+                    x: { type: 'number', required: true }, y: { type: 'number', required: true }, width: { type: 'number', required: true }, height: { type: 'number', required: true },
+                } },
+            fullPage: { type: 'boolean', description: 'Capture the full scrollable page. Defaults to true for page screenshots; incompatible with selector/locator.' },
+            format: { type: 'string', enum: ['png', 'jpeg'], description: 'Image format. Defaults from filename or png.' },
+            quality: { type: 'number', description: 'JPEG quality 0-100.' },
+            filename: { type: 'string', description: 'Plain filename ending in .png, .jpg, or .jpeg. Directory traversal and absolute paths are rejected.' },
+        },
+        approval: 'none', readOnly: true, mutating: false, concurrencySafe: false, timeoutMs: 30_000,
+        examples: [{ args: {} }, { args: { locator: { role: 'heading', name: 'Pricing' } }, note: 'element screenshot' }],
+        async execute(args, ctx) {
+            const target = targetOf(args, false);
+            return ctx.service.screenshot({
+                ...target ? { target } : {},
+                ...args.clip ? { clip: args.clip } : {},
+                ...args.fullPage !== undefined ? { fullPage: args.fullPage } : {},
+                ...args.format ? { format: args.format } : {},
+                ...args.quality !== undefined ? { quality: args.quality } : {},
+                ...args.filename ? { filename: args.filename } : {},
+                session: ctx.session,
+            });
+        },
+    },
+];
+//# sourceMappingURL=observe.js.map

package/lib/actions/observe.js.map

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

package/lib/actions/opencli.d.ts

@@ -0,0 +1,3 @@
+/** `opencli` group: bundled OpenCLI adapters. @module dsh-browser/actions/opencli */
+import type { ActionDef } from './types.ts';
+export declare const OPENCLI_ACTIONS: ActionDef[];

package/lib/actions/opencli.js

@@ -0,0 +1,51 @@
+/** `opencli` group: bundled OpenCLI adapters. @module dsh-browser/actions/opencli */
+export const OPENCLI_ACTIONS = [
+    {
+        name: 'opencli.status',
+        group: 'opencli',
+        summary: 'Run bundled OpenCLI doctor: daemon, extension, profile, and Browser Bridge connectivity.',
+        params: {},
+        approval: 'none', readOnly: true, mutating: false, concurrencySafe: true, timeoutMs: 45_000,
+        examples: [{ args: {} }],
+        async execute(_args, ctx) {
+            const result = await ctx.service.opencliDoctor(ctx.signal);
+            return { code: result.code, timedOut: result.timedOut, output: (result.stdout || result.stderr).slice(0, 20_000) };
+        },
+    },
+    {
+        name: 'opencli.catalog',
+        group: 'opencli',
+        summary: 'Discover bundled OpenCLI adapters through a filtered, capped catalog (command, access class, strategy, args).',
+        notes: 'Use before opencli.run to find exact command names.',
+        params: {
+            query: { type: 'string' }, site: { type: 'string' },
+            access: { type: 'string', enum: ['read', 'write'] },
+            strategy: { type: 'string' }, limit: { type: 'number' },
+        },
+        approval: 'none', readOnly: true, mutating: false, concurrencySafe: true, timeoutMs: 75_000,
+        examples: [{ args: { site: 'reddit', access: 'read', limit: 10 } }],
+        async execute(args, ctx) {
+            const items = await ctx.service.opencliCatalog(args, ctx.signal);
+            return { items: items.map(({ args: itemArgs, ...item }) => ({ ...item, args: itemArgs })) };
+        },
+    },
+    {
+        name: 'opencli.run',
+        group: 'opencli',
+        summary: 'Run any bundled OpenCLI adapter or browser-session command with verbatim argv.',
+        notes: 'Commands may reuse logged-in Chrome state or perform writes, so approval is skipped only in unrestricted mode. Prefer existing read-only actions when available.',
+        params: {
+            args: { type: 'array', required: true, items: { type: 'string' }, description: 'Arguments after opencli, e.g. ["reddit","search","dsh","-f","json"].' },
+            profile: { type: 'string', description: 'Optional OpenCLI profile alias, passed as --profile.' },
+            timeoutMs: { type: 'number' },
+        },
+        approval: 'opencli', readOnly: false, mutating: true, concurrencySafe: false, timeoutMs: 180_000,
+        examples: [{ args: { args: ['reddit', 'search', 'dsh', '-f', 'json'] } }],
+        async execute(args, ctx) {
+            const argv = [...args.profile ? ['--profile', args.profile] : [], ...args.args];
+            const result = await ctx.service.opencli(argv, { timeoutMs: Math.min(Math.max(args.timeoutMs ?? 60_000, 1_000), 120_000), signal: ctx.signal });
+            return { code: result.code, timedOut: result.timedOut, output: (result.stdout || result.stderr).slice(0, 100_000) };
+        },
+    },
+];
+//# sourceMappingURL=opencli.js.map

package/lib/actions/opencli.js.map

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

package/lib/actions/registry.d.ts

@@ -0,0 +1,35 @@
+/**
+ * The action registry: the single definition of every model-visible browser
+ * capability. Tool surfaces, approval policy, and exposure rules are all
+ * derived from this list.
+ * @module dsh-browser/actions/registry
+ */
+import { type ActionDef, type ActionGroup, type ActionTraits } from './types.ts';
+export declare const ACTIONS: readonly ActionDef[];
+export declare const GROUP_SUMMARIES: Record<ActionGroup, string>;
+/**
+ * The flags that apply to THIS call. An action with sub-actions takes the flags of the operation the
+ * arguments select; an unknown or missing operation gets the action-level (strictest) flags.
+ */
+export declare function traitsFor(action: ActionDef, args?: unknown): ActionTraits;
+/** Whether any operation of the action is usable in `read-only` mode (decides whether it is listed there at all). */
+export declare function readOnlyCapable(action: ActionDef): boolean;
+/** `automation.develop.save` resolves to the action and its operation; undefined for anything else. */
+export declare function findSubAction(name: unknown): {
+    action: ActionDef;
+    sub: string;
+} | undefined;
+/** `observe.read.controls` resolves to the action and its detail topic; undefined for anything else. */
+export declare function findTopic(name: unknown): {
+    action: ActionDef;
+    topic: string;
+} | undefined;
+export declare function isActionGroup(value: unknown): value is ActionGroup;
+export declare function findAction(name: unknown): ActionDef | undefined;
+export declare function actionsInGroup(group: ActionGroup): ActionDef[];
+/** Tool name for an action on the flat surface: `browser_<group>_<action>` (`browser_crawl` for crawl.crawl). */
+export declare function flatToolName(action: ActionDef): string;
+export declare function findActionByFlatTool(toolName: string): ActionDef | undefined;
+/** The two tools of the indexed surface. */
+export declare const INDEX_TOOL = "browser_index";
+export declare const CALL_TOOL = "browser_call";

package/lib/actions/registry.js

@@ -0,0 +1,89 @@
+/**
+ * The action registry: the single definition of every model-visible browser
+ * capability. Tool surfaces, approval policy, and exposure rules are all
+ * derived from this list.
+ * @module dsh-browser/actions/registry
+ */
+import { ACTION_GROUPS } from "./types.js";
+import { RUNTIME_ACTIONS } from "./runtime.js";
+import { TARGET_ACTIONS } from "./target.js";
+import { OBSERVE_ACTIONS } from "./observe.js";
+import { ACT_ACTIONS } from "./act.js";
+import { INSPECT_ACTIONS } from "./inspect.js";
+import { SCRIPT_ACTIONS } from "./script.js";
+import { AUTOMATION_ACTIONS } from "./automation.js";
+import { CRAWL_ACTIONS } from "./crawl.js";
+import { OPENCLI_ACTIONS } from "./opencli.js";
+export const ACTIONS = [
+    ...RUNTIME_ACTIONS, ...TARGET_ACTIONS, ...OBSERVE_ACTIONS, ...ACT_ACTIONS, ...INSPECT_ACTIONS,
+    ...SCRIPT_ACTIONS, ...AUTOMATION_ACTIONS, ...CRAWL_ACTIONS, ...OPENCLI_ACTIONS,
+];
+const BY_NAME = new Map(ACTIONS.map(action => [action.name, action]));
+export const GROUP_SUMMARIES = {
+    runtime: 'runtime status and Chromium install',
+    target: 'open / close / list this session\'s page',
+    observe: 'read page text, screenshots',
+    act: 'click, fill, type, clear, press, select, check, hover, scroll, upload, wait',
+    inspect: 'captured console and failed-request records',
+    script: 'page JavaScript, built-in scripts, userscripts',
+    automation: 'search/run reusable assets, develop drafts, inline recipes',
+    crawl: 'bounded multi-page crawl',
+    opencli: 'bundled OpenCLI site adapters',
+};
+/**
+ * The flags that apply to THIS call. An action with sub-actions takes the flags of the operation the
+ * arguments select; an unknown or missing operation gets the action-level (strictest) flags.
+ */
+export function traitsFor(action, args) {
+    const base = { readOnly: action.readOnly, mutating: action.mutating, concurrencySafe: action.concurrencySafe };
+    const set = action.subActions;
+    if (!set || !args || typeof args !== 'object')
+        return base;
+    const selected = args[set.key];
+    const sub = typeof selected === 'string' && Object.hasOwn(set.items, selected) ? set.items[selected] : undefined;
+    return sub?.traits ? { ...base, ...sub.traits } : base;
+}
+/** Whether any operation of the action is usable in `read-only` mode (decides whether it is listed there at all). */
+export function readOnlyCapable(action) {
+    return action.readOnly || Object.values(action.subActions?.items ?? {}).some(sub => sub.traits?.readOnly === true);
+}
+/** `automation.develop.save` resolves to the action and its operation; undefined for anything else. */
+export function findSubAction(name) {
+    if (typeof name !== 'string')
+        return undefined;
+    const cut = name.lastIndexOf('.');
+    const action = cut > 0 ? findAction(name.slice(0, cut)) : undefined;
+    const sub = name.slice(cut + 1);
+    return action?.subActions && Object.hasOwn(action.subActions.items, sub) ? { action, sub } : undefined;
+}
+/** `observe.read.controls` resolves to the action and its detail topic; undefined for anything else. */
+export function findTopic(name) {
+    if (typeof name !== 'string')
+        return undefined;
+    const cut = name.lastIndexOf('.');
+    const action = cut > 0 ? findAction(name.slice(0, cut)) : undefined;
+    const topic = name.slice(cut + 1);
+    return action?.topics && Object.hasOwn(action.topics, topic) ? { action, topic } : undefined;
+}
+export function isActionGroup(value) {
+    return typeof value === 'string' && ACTION_GROUPS.includes(value);
+}
+export function findAction(name) {
+    return typeof name === 'string' ? BY_NAME.get(name) : undefined;
+}
+export function actionsInGroup(group) {
+    return ACTIONS.filter(action => action.group === group);
+}
+/** Tool name for an action on the flat surface: `browser_<group>_<action>` (`browser_crawl` for crawl.crawl). */
+export function flatToolName(action) {
+    const [group, name] = action.name.split('.');
+    return group === name ? `browser_${group}` : `browser_${group}_${name}`;
+}
+const BY_FLAT_NAME = new Map(ACTIONS.map(action => [flatToolName(action), action]));
+export function findActionByFlatTool(toolName) {
+    return BY_FLAT_NAME.get(toolName);
+}
+/** The two tools of the indexed surface. */
+export const INDEX_TOOL = 'browser_index';
+export const CALL_TOOL = 'browser_call';
+//# sourceMappingURL=registry.js.map

package/lib/actions/registry.js.map

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

package/lib/actions/run.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Action dispatch: validate arguments, check availability, run the executor
+ * under a deadline, and wrap everything in the result envelope.
+ *
+ * Both tool surfaces call {@link runAction}, so the envelope and the error
+ * codes are identical whether the model reaches an action through
+ * `browser_call` or through a flat per-action tool.
+ * @module dsh-browser/actions/run
+ */
+import { type ActionContext, type ActionEnvelope } from './types.ts';
+import { type AutomationMode, type ExposureOptions } from '../freedom.ts';
+/** Serialized-result cap; larger results get their longest strings shortened. */
+export declare const RESULT_CHAR_LIMIT = 100000;
+export interface RunEnvironment {
+    mode: AutomationMode;
+    options: ExposureOptions;
+    enabled: boolean;
+}
+/**
+ * Shorten the longest string fields until the serialized result fits. The
+ * result stays valid JSON; the envelope reports how much text was dropped.
+ */
+export declare function truncateResult(result: Record<string, unknown>, limit?: number): {
+    result: Record<string, unknown>;
+    truncation?: {
+        omitted: number;
+        reason: string;
+    };
+};
+/**
+ * Run one action and return the envelope. Never throws: every failure is a
+ * structured error the model can act on.
+ */
+export declare function runAction(name: unknown, rawArgs: unknown, ctx: ActionContext, env: RunEnvironment): Promise<ActionEnvelope>;