@anweat/dsh-browser 0.1.17 → 0.2.0

package/lib/actions/act.js

@@ -0,0 +1,147 @@
+/** `act` group: interact with the page. @module dsh-browser/actions/act */
+import { EXPECT_PARAMS, TARGET_PARAMS } from "./schema.js";
+import { expectOf, targetOf } from "./shared.js";
+const TIMEOUT = { type: 'number', description: 'Target timeout 1-30000 ms.' };
+export const ACT_ACTIONS = [
+    {
+        name: 'act.click',
+        group: 'act',
+        summary: 'Click an element (CSS selector or role/text/label locator); returns the updated page state.',
+        params: { ...TARGET_PARAMS, timeoutMs: TIMEOUT, ...EXPECT_PARAMS },
+        approval: 'interaction', readOnly: false, mutating: true, concurrencySafe: false, timeoutMs: 30_000,
+        examples: [{ args: { locator: { role: 'button', name: 'Search' } } }, { args: { selector: '#submit' } }],
+        async execute(args, ctx) {
+            return ctx.service.click(targetOf(args), { ...expectOf(args), ...args.timeoutMs !== undefined ? { timeoutMs: args.timeoutMs } : {}, session: ctx.session });
+        },
+    },
+    {
+        name: 'act.fill',
+        group: 'act',
+        summary: 'Fill text into an input/textarea (replaces its value); returns the page state.',
+        notes: 'To empty a field use act.clear.',
+        params: { ...TARGET_PARAMS, text: { type: 'string', required: true, description: 'Text to enter.' }, timeoutMs: TIMEOUT, ...EXPECT_PARAMS },
+        approval: 'interaction', readOnly: false, mutating: true, concurrencySafe: false, timeoutMs: 30_000,
+        examples: [{ args: { locator: { label: 'Query' }, text: 'dsh' } }],
+        async execute(args, ctx) {
+            return ctx.service.type(targetOf(args), args.text, { ...expectOf(args), ...args.timeoutMs !== undefined ? { timeoutMs: args.timeoutMs } : {}, session: ctx.session });
+        },
+    },
+    {
+        name: 'act.type',
+        group: 'act',
+        summary: 'Type text key by key into the located element (fires key events); use act.fill to replace a value at once.',
+        notes: 'Appends at the caret. Use it for inputs that react to every keystroke (autocomplete, masked fields). To empty a field use act.clear.',
+        params: { ...TARGET_PARAMS, text: { type: 'string', required: true, description: 'Text to type, 1-10000 characters.' }, delayMs: { type: 'number', description: 'Delay between keys, 0-1000 ms. Default 0.' }, timeoutMs: TIMEOUT, ...EXPECT_PARAMS },
+        approval: 'interaction', readOnly: false, mutating: true, concurrencySafe: false, timeoutMs: 60_000,
+        examples: [{ args: { locator: { role: 'combobox', name: 'City' }, text: 'Ams', delayMs: 50 } }],
+        async execute(args, ctx) {
+            return ctx.service.typeKeys(targetOf(args), args.text, { ...expectOf(args), ...args.delayMs !== undefined ? { delayMs: args.delayMs } : {}, ...args.timeoutMs !== undefined ? { timeoutMs: args.timeoutMs } : {}, session: ctx.session });
+        },
+    },
+    {
+        name: 'act.clear',
+        group: 'act',
+        summary: 'Empty an input/textarea (fires the input event, so controlled fields update); returns the page state.',
+        params: { ...TARGET_PARAMS, timeoutMs: TIMEOUT, ...EXPECT_PARAMS },
+        approval: 'interaction', readOnly: false, mutating: true, concurrencySafe: false, timeoutMs: 30_000,
+        examples: [{ args: { locator: { label: 'Query' } } }],
+        async execute(args, ctx) {
+            return ctx.service.clear(targetOf(args), { ...expectOf(args), ...args.timeoutMs !== undefined ? { timeoutMs: args.timeoutMs } : {}, session: ctx.session });
+        },
+    },
+    {
+        name: 'act.press',
+        group: 'act',
+        summary: 'Press a key globally or on an element (Enter, ArrowDown, Control+Enter).',
+        params: { ...TARGET_PARAMS, key: { type: 'string', required: true, description: 'Playwright key such as Enter, ArrowDown, or Control+Enter.' }, timeoutMs: TIMEOUT, ...EXPECT_PARAMS },
+        approval: 'interaction', readOnly: false, mutating: true, concurrencySafe: false, timeoutMs: 30_000,
+        examples: [{ args: { key: 'Enter' } }],
+        async execute(args, ctx) {
+            return ctx.service.press(targetOf(args, false), args.key, { ...expectOf(args), ...args.timeoutMs !== undefined ? { timeoutMs: args.timeoutMs } : {}, session: ctx.session });
+        },
+    },
+    {
+        name: 'act.select',
+        group: 'act',
+        summary: 'Select one or more option values in a dropdown.',
+        params: { ...TARGET_PARAMS, values: { type: 'array', required: true, items: { type: 'string' }, description: '1-20 option values.' }, timeoutMs: TIMEOUT, ...EXPECT_PARAMS },
+        approval: 'interaction', readOnly: false, mutating: true, concurrencySafe: false, timeoutMs: 30_000,
+        examples: [{ args: { selector: '#country', values: ['NL'] } }],
+        async execute(args, ctx) {
+            return ctx.service.select(targetOf(args), args.values, { ...expectOf(args), ...args.timeoutMs !== undefined ? { timeoutMs: args.timeoutMs } : {}, session: ctx.session });
+        },
+    },
+    {
+        name: 'act.check',
+        group: 'act',
+        summary: 'Check or uncheck a checkbox or radio control.',
+        params: { ...TARGET_PARAMS, checked: { type: 'boolean', description: 'True to check, false to uncheck. Defaults to true.' }, timeoutMs: TIMEOUT, ...EXPECT_PARAMS },
+        approval: 'interaction', readOnly: false, mutating: true, concurrencySafe: false, timeoutMs: 30_000,
+        examples: [{ args: { locator: { role: 'checkbox', name: 'Remember me' }, checked: true } }],
+        async execute(args, ctx) {
+            return ctx.service.check(targetOf(args), args.checked ?? true, { ...expectOf(args), ...args.timeoutMs !== undefined ? { timeoutMs: args.timeoutMs } : {}, session: ctx.session });
+        },
+    },
+    {
+        name: 'act.hover',
+        group: 'act',
+        summary: 'Hover an element (menus, tooltips) and return the updated page state.',
+        params: { ...TARGET_PARAMS, waitMs: { type: 'number', description: 'Settle time after hovering, 0 to the action timeout. Default 300 ms.' }, ...EXPECT_PARAMS },
+        approval: 'interaction', readOnly: false, mutating: false, concurrencySafe: false, timeoutMs: 30_000,
+        examples: [{ args: { selector: '#menu' } }],
+        async execute(args, ctx) {
+            return ctx.service.hover(targetOf(args), { ...expectOf(args), ...args.waitMs !== undefined ? { waitMs: args.waitMs } : {}, session: ctx.session });
+        },
+    },
+    {
+        name: 'act.scroll',
+        group: 'act',
+        summary: 'Scroll the page vertically by deltaY pixels (positive = down) to trigger lazy loading.',
+        params: { deltaY: { type: 'number', description: 'Pixels to scroll; positive scrolls down. Default 2000.' }, ...EXPECT_PARAMS },
+        approval: 'interaction', readOnly: false, mutating: false, concurrencySafe: false, timeoutMs: 20_000,
+        examples: [{ args: { deltaY: 1500 } }],
+        async execute(args, ctx) {
+            return ctx.service.scroll(args.deltaY ?? 2000, { ...expectOf(args), session: ctx.session });
+        },
+    },
+    {
+        name: 'act.upload',
+        group: 'act',
+        summary: 'Set existing local files on an input[type=file]. Paths must be absolute regular files (max 20, 512 MiB total).',
+        notes: 'The action reads the files for upload but never modifies them. Approval shows the requested paths unless automationMode=unrestricted.',
+        params: { ...TARGET_PARAMS, files: { type: 'array', required: true, items: { type: 'string' }, description: '1-20 absolute local file paths, at most 512 MiB total.' }, ...EXPECT_PARAMS },
+        approval: 'upload', readOnly: false, mutating: true, concurrencySafe: false, timeoutMs: 30_000,
+        errors: ['POLICY_DENIED (empty or non-absolute paths)'],
+        examples: [{ args: { selector: 'input[type=file]', files: ['/abs/path/report.pdf'] } }],
+        async execute(args, ctx) {
+            return ctx.service.setFiles(targetOf(args), args.files, { ...expectOf(args), session: ctx.session });
+        },
+    },
+    {
+        name: 'act.wait',
+        group: 'act',
+        summary: 'Wait for exactly one of: an element state, a URL pattern, network idle, or a fixed delay.',
+        params: {
+            ...TARGET_PARAMS,
+            state: { type: 'string', enum: ['visible', 'hidden', 'attached', 'detached'], description: 'Element state. Defaults to visible.' },
+            urlPattern: { type: 'string', description: 'Playwright URL glob to wait for.' },
+            networkIdle: { type: 'boolean', description: 'Set true to wait for networkidle.' },
+            timeMs: { type: 'number', description: 'Fixed delay 0-10000 ms.' },
+            timeoutMs: { type: 'number', description: 'Condition timeout 0-30000 ms. Default 15000.' },
+        },
+        approval: 'none', readOnly: true, mutating: false, concurrencySafe: false, timeoutMs: 35_000,
+        examples: [{ args: { locator: { text: 'Results' } } }, { args: { networkIdle: true } }],
+        async execute(args, ctx) {
+            const target = targetOf(args, false);
+            return ctx.service.wait(target, {
+                ...args.state ? { state: args.state } : {},
+                ...args.urlPattern ? { urlPattern: args.urlPattern } : {},
+                ...args.networkIdle !== undefined ? { networkIdle: args.networkIdle } : {},
+                ...args.timeMs !== undefined ? { timeMs: args.timeMs } : {},
+                ...args.timeoutMs !== undefined ? { timeoutMs: args.timeoutMs } : {},
+                session: ctx.session,
+            });
+        },
+    },
+];
+//# sourceMappingURL=act.js.map

package/lib/actions/act.js.map

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

package/lib/actions/automation.d.ts

@@ -0,0 +1,3 @@
+/** `automation` group: reusable assets and inline recipes. @module dsh-browser/actions/automation */
+import type { ActionDef } from './types.ts';
+export declare const AUTOMATION_ACTIONS: ActionDef[];

package/lib/actions/automation.js

@@ -0,0 +1,356 @@
+/** `automation` group: reusable assets and inline recipes. @module dsh-browser/actions/automation */
+import { ActionArgError, ActionUnavailableError, withOutcome } from "./types.js";
+import { RecipeValidationError, hintFor } from "./errors.js";
+import { normalizePostconditions } from "../automation-v2.js";
+import { executeAutomationAsset, executeDraftInputSets } from "../automation-execution.js";
+import { capJson, recipeOutcome } from "./shared.js";
+/** After the deadline aborts a recipe, how long to wait for its in-flight step to return (a step times out within 30 s). */
+const RECIPE_SETTLE_MS = 40_000;
+const DEVELOP_LIMIT = 100_000;
+/** Wrap an asset-development result: structured when small, truncated JSON text when large. */
+function developmentResult(action, value, asset) {
+    const capped = capJson(value, DEVELOP_LIMIT);
+    return { action, ...asset ? { assetId: asset.id, status: asset.status } : {}, result: capped.value, truncated: capped.truncated };
+}
+export const AUTOMATION_ACTIONS = [
+    {
+        name: 'automation.search',
+        group: 'automation',
+        summary: 'Search reusable browser automations by task keywords and optional domain; compact metadata only.',
+        notes: 'Run this at the start of a task: a verified asset can be run with automation.run instead of re-exploring. Never returns recipe steps or userscript source.',
+        params: {
+            query: { type: 'string', required: true, description: 'Short task description.' },
+            domain: { type: 'string', description: 'Optional target hostname.' },
+            status: { type: 'string', enum: ['active', 'draft', 'archived', 'all'], description: 'Asset lifecycle scope. Defaults to active.' },
+            kind: { type: 'string', enum: ['recipe', 'userscript'], description: 'Optional asset kind.' },
+        },
+        approval: 'none', readOnly: true, mutating: false, concurrencySafe: true, timeoutMs: 10_000,
+        examples: [{ args: { query: 'search issues', domain: 'github.com' } }],
+        async execute(args, ctx) {
+            return { items: ctx.assets?.search(args.query, args.domain, args.status, args.kind) ?? [] };
+        },
+    },
+    {
+        name: 'automation.develop',
+        group: 'automation',
+        summary: 'Get, save, validate, test, convert (v1 to v2), fork (repair copy) or draft_from_journal (explored steps to a v2 draft). Never activates assets.',
+        notes: 'One tool, sub-actions selected by `action`; browser_index({action:"automation.develop.<sub>"}) gives one sub-action\'s full schema. Every save is a new revision; a test is bound to its revision and only the user can activate a tested revision.',
+        params: {
+            action: { type: 'string', required: true, enum: ['get', 'save', 'validate', 'test', 'convert', 'fork', 'draft_from_journal'] },
+            id: { type: 'string', description: 'asset id; omit on save to create' },
+            kind: { type: 'string', enum: ['recipe', 'userscript'], description: 'save' },
+            name: { type: 'string', description: 'save' },
+            description: { type: 'string' },
+            domains: { type: 'array', items: { type: 'string' } },
+            tags: { type: 'array', items: { type: 'string' }, description: 'retrieval keywords' },
+            inputNames: { type: 'array', items: { type: 'string' }, description: 'UserScript input keys' },
+            schemaVersion: { type: 'number', description: '1 or 2; use 2 (omitted: new=1, edit keeps)' },
+            recipe: { type: 'array', items: { ref: 'recipeStep' }, description: '1-25 steps.' },
+            inputSchema: { type: 'array', items: { ref: 'inputSpec' }, description: 'v2 typed inputs.' },
+            outputSchema: { type: 'array', items: { ref: 'outputSpec' }, description: 'v2 named outputs.' },
+            postconditions: { type: 'array', items: { ref: 'postcondition' }, description: 'v2: verified after the steps' },
+            requiredCapabilities: { type: 'array', items: { type: 'string' }, description: 'v2: recorded only' },
+            source: { type: 'string', description: 'UserScript' },
+            url: { type: 'string', description: 'test: inside the draft domains' },
+            inputs: { type: 'object', additionalProperties: true, description: 'test inputs' },
+            inputSets: { type: 'array', items: { type: 'object', additionalProperties: true }, description: 'test: 2-5 input objects, each replayed in a fresh browser context' },
+            fromSeq: { type: 'number', description: 'draft_from_journal: first journal seq (default: the first)' },
+            toSeq: { type: 'number', description: 'draft_from_journal: last journal seq (default: the last)' },
+            exclude: { type: 'array', items: { type: 'number' }, description: 'draft_from_journal: seq to leave out (failed calls and observations are left out already)' },
+            parameters: { type: 'array', items: { type: 'object', additionalProperties: false, properties: { seq: { type: 'number', required: true }, field: { type: 'string', required: true, enum: ['text', 'values', 'url'] }, name: { type: 'string', required: true }, type: { type: 'string', enum: ['string', 'number'] } } }, description: 'draft_from_journal: turn the typed text / chosen option / later opened url of a seq into an input' },
+            extract: { type: 'array', items: { type: 'object', additionalProperties: false, properties: { seq: { type: 'number', required: true }, as: { type: 'string', required: true }, mode: { type: 'string', enum: ['text', 'html', 'links'] }, limit: { type: 'number' }, dedupe: { type: 'boolean' } } }, description: 'draft_from_journal: turn an observe.read seq into a named extract output' },
+            authProfile: { type: 'string' },
+            rulePack: { type: 'string' },
+        },
+        approval: 'asset-develop', readOnly: false, mutating: true, concurrencySafe: false, timeoutMs: 120_000, settleMs: RECIPE_SETTLE_MS,
+        errors: ['VALIDATION_FAILED', 'VALIDATION_MISSING', 'OUTCOME_UNKNOWN'],
+        subActions: {
+            key: 'action',
+            common: ['action', 'id'],
+            items: {
+                get: {
+                    summary: 'Read one asset in full, steps or source included, with its revision, contentHash and test credentials.',
+                    params: ['id'], required: ['id'], hints: { id: 'asset id' }, errors: ['NOT_FOUND'],
+                    traits: { readOnly: true, mutating: false, concurrencySafe: true },
+                },
+                validate: {
+                    summary: 'Static check of a stored draft (no browser): structure, domains, inputs.',
+                    params: ['id'], required: ['id'], hints: { id: 'asset id' }, errors: ['NOT_FOUND', 'INVALID_RECIPE'],
+                    traits: { readOnly: true, mutating: false, concurrencySafe: true },
+                },
+                save: {
+                    summary: 'Create a draft (omit id) or replace a whole draft. Every save is a new revision and clears its test result.',
+                    params: ['id', 'kind', 'name', 'description', 'domains', 'tags', 'inputNames', 'schemaVersion', 'recipe', 'inputSchema', 'outputSchema', 'postconditions', 'requiredCapabilities', 'source'],
+                    required: ['kind', 'name'], hints: { id: 'existing draft to replace; omit to create', kind: '', name: '' }, errors: ['INVALID_RECIPE', 'POLICY_DENIED'],
+                    notes: 'Send every field each time. Use schemaVersion 2: strict `locator` steps (several matches => LOCATOR_AMBIGUOUS, step not run). An active asset cannot be saved over: fork it.',
+                    examples: [{
+                            args: {
+                                action: 'save', kind: 'recipe', schemaVersion: 2, name: 'Search', domains: ['example.com'],
+                                recipe: [
+                                    { type: 'fill', locator: { label: 'Query' }, value: '{{query}}' },
+                                    { type: 'click', locator: { role: 'button', name: 'Search' } },
+                                    { type: 'extract', locator: { css: '#results' }, as: 'results' },
+                                ],
+                                postconditions: [{ output: 'results', nonEmpty: true }],
+                            },
+                        }],
+                },
+                draft_from_journal: {
+                    summary: 'Turn the calls you explored with (this session\'s journal) into a saved v2 draft, with a map back to each call.',
+                    params: ['id', 'name', 'description', 'domains', 'postconditions', 'fromSeq', 'toSeq', 'exclude', 'parameters', 'extract'], required: ['name'],
+                    hints: { id: 'replace the draft of an earlier call; omit to create', name: '', description: '', domains: 'default: hosts the pages had', postconditions: 'checks the result; without them a test cannot pass' },
+                    errors: ['INVALID_ARGS', 'INVALID_RECIPE'],
+                    notes: 'Each browser_call reply has a seq. Failed calls and observe calls are left out; fill/type text, act.select and later target.open become inputs only via `parameters`. `extract` names the observe.read (with a locator) whose text is the result. The reply lists sourceMap (seq to step), unmapped (actions a recipe cannot express: the draft is then incomplete and cannot be activated), pendingDisambiguation, parameterCandidates, suggestedPostconditions and warnings. Then test with inputSets.',
+                    examples: [{ args: { action: 'draft_from_journal', name: 'Keyword search', parameters: [{ seq: 3, field: 'text', name: 'keyword' }], extract: [{ seq: 6, as: 'items', dedupe: true }], postconditions: [{ output: 'items', allowEmpty: true }, { selector: '#status' }] } }],
+                },
+                test: {
+                    summary: 'Replay a draft in a real browser. The result is recorded as a credential bound to the draft\'s current revision and content.',
+                    params: ['id', 'url', 'inputs', 'inputSets', 'authProfile', 'rulePack'], required: ['id', 'url'], hints: { id: 'draft id', url: 'inside the draft domains', inputs: '', inputSets: '2-5 input objects; each runs in a fresh context; all must pass' },
+                    errors: ['VALIDATION_FAILED', 'VALIDATION_MISSING', 'OUTCOME_UNKNOWN', 'LOCATOR_NOT_FOUND', 'LOCATOR_AMBIGUOUS'],
+                    notes: 'A v2 test passes only if an assert step or a postcondition checks the result; otherwise it fails with VALIDATION_MISSING. url must be inside the draft\'s domains. A recipe draft is approved like automation.run_recipe in autonomous mode; a UserScript draft asks.',
+                    examples: [{ args: { action: 'test', id: 'draft-id', url: 'https://example.com/search', inputs: { query: 'dsh' } } }],
+                },
+                convert: {
+                    summary: 'Copy a v1 recipe asset (any status) into a NEW v2 draft; the original is not changed.',
+                    params: ['id'], required: ['id'], hints: { id: 'v1 recipe asset id' }, errors: ['NOT_FOUND', 'INVALID_RECIPE'],
+                    notes: 'The draft records sourceAssetId and sourceRevision. Steps that still take the first match are listed in pendingDisambiguation.',
+                },
+                fork: {
+                    summary: 'Copy any asset, typically an active one that broke, into a NEW editable draft that records sourceAssetId and sourceRevision.',
+                    params: ['id'], required: ['id'], hints: { id: 'asset to copy' }, errors: ['NOT_FOUND', 'POLICY_DENIED'],
+                    notes: 'The source keeps running and is not touched by the draft\'s tests. When the user activates the tested draft, the source is archived.',
+                    examples: [{ args: { action: 'fork', id: 'active-asset-id' } }],
+                },
+            },
+        },
+        examples: [
+            {
+                args: {
+                    action: 'save', kind: 'recipe', schemaVersion: 2, name: 'Search', domains: ['example.com'],
+                    recipe: [
+                        { type: 'fill', locator: { label: 'Query' }, value: '{{query}}' },
+                        { type: 'click', locator: { role: 'button', name: 'Search' } },
+                        { type: 'extract', locator: { css: '#results' }, as: 'results' },
+                    ],
+                    postconditions: [{ output: 'results', nonEmpty: true }],
+                },
+            },
+        ],
+        async execute(args, ctx) {
+            const { assets, development } = ctx;
+            if (!assets || !development)
+                throw new ActionUnavailableError('model automation development is disabled');
+            if (args.action === 'get') {
+                if (!args.id)
+                    throw new Error('automation development get requires id');
+                const asset = development.get(args.id);
+                return developmentResult('get', asset, asset);
+            }
+            if (args.action === 'validate') {
+                if (!args.id)
+                    throw new Error('automation development validate requires id');
+                const asset = development.validate(args.id);
+                return developmentResult('validate', { id: asset.id, kind: asset.kind, status: asset.status, testStatus: asset.testStatus, testMessage: asset.testMessage }, asset);
+            }
+            if (args.action === 'test' && args.inputSets !== undefined) {
+                if (!args.id || !args.url)
+                    throw new Error('automation development test requires id and url');
+                if (args.inputs !== undefined)
+                    throw new ActionArgError('pass either inputs (one run in the session page) or inputSets (2-5 runs, each in a fresh context), not both');
+                const replay = await executeDraftInputSets(ctx.service, assets, args.id, args.url, args.inputSets, {
+                    signal: ctx.signal,
+                    ...args.authProfile ? { authProfile: args.authProfile } : {},
+                    ...args.rulePack ? { rulePack: args.rulePack } : {},
+                    session: ctx.session,
+                });
+                const shown = (entry) => {
+                    const { completedSteps: _steps, outputs: _outputs, evidenceLevel: _level, ...run } = entry.execution;
+                    const capped = capJson(entry.produced, 8_000);
+                    return { set: entry.index + 1, passed: entry.passed, ...run, inputsDigest: entry.inputsDigest, outputs: capped.value, ...capped.truncated ? { outputsTruncated: true } : {} };
+                };
+                const failed = replay.sets.find(entry => !entry.passed);
+                const body = {
+                    action: 'test', assetId: replay.asset.id, status: replay.asset.status,
+                    revision: replay.asset.revision, contentHash: replay.asset.contentHash,
+                    testStatus: replay.asset.testStatus, testMessage: replay.asset.testMessage,
+                    inputSets: replay.planned, setsRun: replay.sets.length,
+                    sets: replay.sets.map(shown),
+                    ...replay.suspect ? { warnings: [{ code: 'PARAMETERIZATION_SUSPECT', sets: replay.identicalOutputs.map(pair => pair.map(index => index + 1)), message: 'different inputs produced identical outputs: the input may not really drive the result. The test still passed; check that the placeholder reaches the page.' }] } : {},
+                    ...failed ? { failedSet: failed.index + 1 } : {},
+                };
+                if (replay.verifierMissing) {
+                    return withOutcome(body, { ok: false, executionStatus: 'completed', error: { code: 'VALIDATION_MISSING', message: replay.verifierMissing.message, hint: hintFor('VALIDATION_MISSING') } });
+                }
+                if (failed)
+                    return withOutcome(body, recipeOutcome(failed.execution));
+                return withOutcome(body, { ok: true, executionStatus: 'completed' });
+            }
+            if (args.action === 'test') {
+                if (!args.id || !args.url)
+                    throw new Error('automation development test requires id and url');
+                const result = await executeAutomationAsset(ctx.service, assets, args.id, args.url, args.inputs, 'draft', {
+                    signal: ctx.signal,
+                    ...args.authProfile ? { authProfile: args.authProfile } : {},
+                    ...args.rulePack ? { rulePack: args.rulePack } : {},
+                    session: ctx.session,
+                });
+                const capped = capJson(result.value, 50_000);
+                // Flat on purpose: executionStatus, validationStatus, completedSteps, failedStep and effects sit next to testStatus.
+                const body = {
+                    action: 'test', assetId: result.asset.id, status: result.asset.status,
+                    revision: result.asset.revision, contentHash: result.asset.contentHash,
+                    testStatus: result.asset.testStatus, testMessage: result.asset.testMessage,
+                    ...result.execution,
+                    result: capped.value, truncated: capped.truncated,
+                };
+                // The steps ran cleanly but nothing verifies the result: a failed test, never an ok:true that says "failed".
+                if (result.verifierMissing) {
+                    return withOutcome(body, {
+                        ok: false, executionStatus: result.execution.executionStatus,
+                        error: { code: 'VALIDATION_MISSING', message: result.verifierMissing.message, hint: hintFor('VALIDATION_MISSING') },
+                    });
+                }
+                return withOutcome(body, recipeOutcome(result.execution));
+            }
+            if (args.action === 'draft_from_journal') {
+                if (!args.name)
+                    throw new ActionArgError('draft_from_journal requires name');
+                const journal = ctx.service.journalFor?.(ctx.session);
+                if (!journal)
+                    throw new ActionUnavailableError('this browser service keeps no exploration journal');
+                const { asset: draft, report } = development.draftFromJournal(journal, {
+                    name: args.name, ...args.id ? { id: args.id } : {},
+                    ...args.description !== undefined ? { description: args.description } : {}, ...args.domains ? { domains: args.domains } : {},
+                    ...args.postconditions ? { postconditions: args.postconditions } : {},
+                    ...args.fromSeq !== undefined ? { fromSeq: args.fromSeq } : {}, ...args.toSeq !== undefined ? { toSeq: args.toSeq } : {},
+                    ...args.exclude ? { exclude: args.exclude } : {}, ...args.parameters ? { parameters: args.parameters } : {}, ...args.extract ? { extract: args.extract } : {},
+                }, ctx.sessionId);
+                return developmentResult('draft_from_journal', {
+                    id: draft.id, status: draft.status, revision: draft.revision, schemaVersion: 2, name: draft.name, testStatus: draft.testStatus, ...report,
+                }, draft);
+            }
+            if (args.action === 'fork') {
+                if (!args.id)
+                    throw new Error('automation development fork requires id');
+                const draft = development.fork(args.id, ctx.sessionId);
+                return developmentResult('fork', {
+                    id: draft.id, status: draft.status, name: draft.name, revision: draft.revision, schemaVersion: draft.schemaVersion ?? 1,
+                    sourceAssetId: draft.sourceAssetId, sourceRevision: draft.sourceRevision, testStatus: draft.testStatus,
+                }, draft);
+            }
+            if (args.action === 'convert') {
+                if (!args.id)
+                    throw new Error('automation development convert requires id');
+                const { draft, conversion } = development.convert(args.id, ctx.sessionId);
+                return developmentResult('convert', {
+                    id: draft.id, status: draft.status, schemaVersion: 2, name: draft.name, revision: draft.revision,
+                    sourceAssetId: draft.sourceAssetId, sourceRevision: draft.sourceRevision, steps: draft.recipe?.length ?? 0,
+                    pendingDisambiguation: conversion.pendingDisambiguation, notes: conversion.notes,
+                }, draft);
+            }
+            if (args.action !== 'save' || !args.kind || !args.name)
+                throw new Error('automation development save requires kind and name');
+            const asset = development.save({
+                ...args.id ? { id: args.id } : {}, kind: args.kind, name: args.name,
+                ...args.description !== undefined ? { description: args.description } : {},
+                ...args.domains ? { domains: args.domains } : {}, ...args.tags ? { tags: args.tags } : {},
+                ...args.inputNames ? { inputNames: args.inputNames } : {}, ...args.recipe ? { recipe: args.recipe } : {},
+                ...args.schemaVersion !== undefined ? { schemaVersion: args.schemaVersion } : {},
+                ...args.inputSchema ? { inputSchema: args.inputSchema } : {}, ...args.outputSchema ? { outputSchema: args.outputSchema } : {},
+                ...args.postconditions ? { postconditions: args.postconditions } : {}, ...args.requiredCapabilities ? { requiredCapabilities: args.requiredCapabilities } : {},
+                ...args.source !== undefined ? { source: args.source } : {},
+            }, ctx.sessionId);
+            const compact = {
+                id: asset.id, kind: asset.kind, status: asset.status, name: asset.name, domains: asset.domains, tags: asset.tags, inputNames: asset.inputNames, revision: asset.revision, testStatus: asset.testStatus,
+                ...asset.schemaVersion === 2 ? { schemaVersion: 2, pendingDisambiguation: asset.pendingDisambiguation?.length ?? 0 } : {},
+            };
+            return developmentResult('save', compact, asset);
+        },
+    },
+    {
+        name: 'automation.run',
+        group: 'automation',
+        summary: 'Run one activated reusable automation by id with declared inputs and a target HTTP(S) URL.',
+        notes: 'Search first. Source and recipe internals stay Host-side.',
+        params: {
+            id: { type: 'string', required: true }, url: { type: 'string', required: true },
+            inputs: { type: 'object', additionalProperties: true, description: 'Declared string inputs used by named recipe placeholders.' },
+            authProfile: { type: 'string' }, rulePack: { type: 'string' },
+        },
+        approval: 'asset-run', readOnly: false, mutating: true, concurrencySafe: false, timeoutMs: 120_000, settleMs: RECIPE_SETTLE_MS,
+        errors: ['VALIDATION_FAILED', 'OUTCOME_UNKNOWN'],
+        examples: [{ args: { id: 'asset-id', url: 'https://example.com/search', inputs: { query: 'dsh' } } }],
+        async execute(args, ctx) {
+            if (!ctx.assets)
+                throw new ActionUnavailableError('automation assets are unavailable');
+            const result = await executeAutomationAsset(ctx.service, ctx.assets, args.id, args.url, args.inputs, 'active', {
+                signal: ctx.signal,
+                ...args.authProfile ? { authProfile: args.authProfile } : {},
+                ...args.rulePack ? { rulePack: args.rulePack } : {},
+                session: ctx.session,
+            });
+            const capped = capJson(result.value, DEVELOP_LIMIT);
+            return withOutcome({ assetId: result.asset.id, kind: result.asset.kind, ...result.execution, result: capped.value, truncated: capped.truncated }, recipeOutcome(result.execution));
+        },
+    },
+    {
+        name: 'automation.run_recipe',
+        group: 'automation',
+        summary: 'Run an inline Playwright recipe (max 25 named steps) on the current page or a given url.',
+        notes: 'Read-only steps (wait, goto, extract, assert, screenshot) run directly; mutating steps are denied in read-only, approved once in standard, and direct in autonomous/unrestricted. Prefer schemaVersion 2 (strict locators, see automation.develop for the step rules).',
+        params: {
+            url: { type: 'string', description: 'Open this URL first; omit only when target.open already established a page.' },
+            authProfile: { type: 'string' },
+            rulePack: { type: 'string' },
+            waitMs: { type: 'number' },
+            steps: { type: 'array', required: true, items: { ref: 'recipeStep' } },
+            schemaVersion: { type: 'number', description: '1 (default): steps use selector and take the first match. 2: steps use locator (strict), goto/clear exist, postconditions apply.' },
+            allowedDomains: { type: 'array', items: { type: 'string' }, description: 'v2 goto may go to these domains (and stay on the starting origin). Default: the starting origin only.' },
+            postconditions: { type: 'array', items: { ref: 'postcondition' }, description: 'v2: what must hold after the steps.' },
+        },
+        approval: 'recipe', readOnly: true, mutating: true, concurrencySafe: false, timeoutMs: 120_000, settleMs: RECIPE_SETTLE_MS,
+        errors: ['VALIDATION_FAILED', 'OUTCOME_UNKNOWN', 'INVALID_RECIPE'],
+        examples: [
+            { args: { url: 'https://example.com/', steps: [{ type: 'extract', selector: 'main', mode: 'text', limit: 5 }] } },
+            { args: { url: 'https://example.com/', schemaVersion: 2, steps: [{ type: 'click', locator: { role: 'link', name: 'More' } }, { type: 'extract', locator: { css: 'main' }, as: 'body' }], postconditions: [{ output: 'body', nonEmpty: true }] }, note: 'v2: strict locators' },
+        ],
+        async execute(args, ctx) {
+            const steps = args.steps;
+            const v2 = args.schemaVersion === 2;
+            if (args.schemaVersion !== undefined && args.schemaVersion !== 1 && !v2)
+                throw new RecipeValidationError('schemaVersion must be 1 or 2');
+            if (!v2 && (args.postconditions || args.allowedDomains))
+                throw new RecipeValidationError('postconditions and allowedDomains need schemaVersion 2');
+            let postconditions;
+            try {
+                postconditions = v2 && args.postconditions ? normalizePostconditions(args.postconditions, steps) : undefined;
+            }
+            catch (error) {
+                throw new RecipeValidationError(error instanceof Error ? error.message : String(error));
+            }
+            try {
+                const { steps: _legacy, ...result } = await ctx.service.recipe(steps, {
+                    signal: ctx.signal,
+                    ...args.url ? { url: args.url } : {},
+                    ...args.waitMs !== undefined ? { waitMs: args.waitMs } : {},
+                    ...args.authProfile ? { authProfile: args.authProfile } : {},
+                    ...args.rulePack ? { rulePack: args.rulePack } : {},
+                    ...v2 ? { schemaVersion: 2, gotoSameOrigin: true, ...args.allowedDomains ? { allowedDomains: args.allowedDomains } : {}, ...postconditions ? { postconditions } : {} } : {},
+                    session: ctx.session,
+                });
+                const outcome = recipeOutcome(result);
+                const where = result.url || args.url;
+                // v2 inline recipes are not offered as reuse candidates (the candidate store normalizes v1 selectors only).
+                if (where && !v2)
+                    ctx.assets?.recordRecipe(where, steps, ctx.sessionId, outcome.ok);
+                return withOutcome(result, outcome);
+            }
+            catch (error) {
+                if (args.url && !v2)
+                    ctx.assets?.recordRecipe(args.url, steps, ctx.sessionId, false);
+                throw error;
+            }
+        },
+    },
+];
+//# sourceMappingURL=automation.js.map

package/lib/actions/automation.js.map

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

package/lib/actions/crawl.d.ts

@@ -0,0 +1,3 @@
+/** `crawl` group: bounded multi-page traversal. @module dsh-browser/actions/crawl */
+import type { ActionDef } from './types.ts';
+export declare const CRAWL_ACTIONS: ActionDef[];

package/lib/actions/crawl.js

@@ -0,0 +1,28 @@
+/** `crawl` group: bounded multi-page traversal. @module dsh-browser/actions/crawl */
+export const CRAWL_ACTIONS = [
+    {
+        name: 'crawl.crawl',
+        group: 'crawl',
+        summary: 'Crawl a bounded set of HTTP(S) pages under the configured concurrency, burst, page/depth, retry, and cooldown budgets.',
+        notes: 'Read-only and always buffered, even in unrestricted mode. Anonymous (no AuthProfile).',
+        params: {
+            startUrls: { type: 'array', required: true, items: { type: 'string' }, description: '1-5 starting URLs.' },
+            maxPages: { type: 'number', description: 'Page budget, capped by usagePolicy.maxPagesPerRun.' },
+            maxDepth: { type: 'number', description: 'Link depth, capped by usagePolicy.maxDepth.' },
+            sameOrigin: { type: 'boolean', description: 'Only follow links on starting origins. Default true.' },
+            maxCharsPerPage: { type: 'number', description: 'Readable text cap per page, 1000-50000.' },
+        },
+        approval: 'none', readOnly: true, mutating: false, concurrencySafe: false, timeoutMs: 300_000,
+        examples: [{ args: { startUrls: ['https://example.com/'], maxPages: 5, maxDepth: 1 } }],
+        async execute(args, ctx) {
+            return ctx.service.crawl(args.startUrls, {
+                signal: ctx.signal,
+                ...args.maxPages !== undefined ? { maxPages: args.maxPages } : {},
+                ...args.maxDepth !== undefined ? { maxDepth: args.maxDepth } : {},
+                ...args.sameOrigin !== undefined ? { sameOrigin: args.sameOrigin } : {},
+                ...args.maxCharsPerPage !== undefined ? { maxCharsPerPage: args.maxCharsPerPage } : {},
+            });
+        },
+    },
+];
+//# sourceMappingURL=crawl.js.map