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

package/lib/observe.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Structured page observation behind `observe.read` sections.
+ *
+ * The in-page scan (`observe-script.ts`) reads the DOM; this module turns its output into the
+ * model-facing record:
+ *
+ * - every listed element gets a candidate LocatorSpec that was CHECKED against the live page: it matches
+ *   that element and no other (`locator`), or, when no candidate is unique, the best one is returned with
+ *   `ambiguous: true`, how many elements it matches, and the element's position among them (`nth`);
+ * - the whole result is fitted to a byte budget by dropping whole items or text from the end, so the JSON
+ *   is always valid and `truncation` says what was left out.
+ *
+ * A property that was not observed is absent: `false` always means "observed, and not so".
+ * @module dsh-browser/observe
+ */
+import { type BrowserFrameSpec, type BrowserTarget } from './locator.ts';
+export declare const OBSERVE_SECTIONS: readonly ["content", "controls", "links", "tables"];
+export type ObserveSection = typeof OBSERVE_SECTIONS[number];
+export declare const OBSERVE_DEFAULT_ITEMS = 50;
+export declare const OBSERVE_MAX_ITEMS = 500;
+export declare const OBSERVE_DEFAULT_BYTES = 24000;
+export declare const OBSERVE_MIN_BYTES = 2000;
+export declare const OBSERVE_MAX_BYTES = 90000;
+export interface ObserveRegion {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** The arguments of observe.read after validation. */
+export interface ObserveRequest {
+    sections: readonly ObserveSection[];
+    target?: BrowserTarget;
+    region?: ObserveRegion;
+    maxItems: number;
+    maxBytes: number;
+    includeValues: boolean;
+    timeoutMs: number;
+}
+export declare class ObserveArgError extends Error {
+    constructor(message: string);
+}
+/** Check and complete the raw arguments (the registry validated their types already). */
+export declare function normalizeObserve(raw: {
+    sections?: readonly string[];
+    target?: BrowserTarget;
+    region?: ObserveRegion;
+    maxItems?: number;
+    maxBytes?: number;
+    includeValues?: boolean;
+    timeoutMs?: number;
+}): ObserveRequest;
+interface RawCandidate extends Record<string, unknown> {
+}
+interface RawOption {
+    id?: number;
+    value: string;
+    label: string;
+    selected?: boolean;
+    checked?: boolean;
+    disabled?: boolean;
+    cands?: RawCandidate[];
+}
+interface RawControl {
+    id?: number;
+    source: 'dom' | 'aria';
+    path: string[];
+    role?: string;
+    name?: string;
+    type?: string;
+    visible?: boolean;
+    disabled?: boolean;
+    readonly?: boolean;
+    checked?: boolean | 'mixed';
+    expanded?: boolean;
+    hasValue?: boolean;
+    value?: string | string[];
+    sensitive?: boolean;
+    options?: RawOption[];
+    optionsTotal?: number;
+    constraints?: Record<string, unknown>;
+    validity?: {
+        valid: boolean;
+        flags?: string[];
+        validationMessage?: string;
+    };
+    actions: string[];
+    cands?: RawCandidate[];
+}
+interface RawLink {
+    id: number;
+    path: string[];
+    text: string;
+    href: string;
+    visible: boolean;
+    target?: string;
+    cands: RawCandidate[];
+}
+interface RawTable {
+    id: number;
+    path: string[];
+    name?: string;
+    headers: string[];
+    rows: string[][];
+    totalRows: number;
+    declaredRows?: number;
+    coverage: 'complete' | 'partial';
+    reason?: string;
+    cands: RawCandidate[];
+}
+interface RawFrame {
+    framePath: string[];
+    src?: string;
+    url?: string;
+    sameOrigin?: boolean;
+    crossOrigin?: boolean;
+    limitation?: string;
+    skipped?: string;
+}
+export interface RawScan {
+    controls: RawControl[];
+    links: RawLink[];
+    tables: RawTable[];
+    frames: RawFrame[];
+    /** Iframes past the 50th, not listed at all. */
+    framesOmitted?: number;
+    counts: {
+        controls: number;
+        links: number;
+        tables: number;
+    };
+    shadowRoots: number;
+}
+/** Where the scan root sits relative to the page: the iframe selectors that lead to it. */
+interface ScopeBase {
+    framePath: string[];
+    frame?: BrowserFrameSpec;
+}
+declare function scopeBase(target: BrowserTarget | undefined): ScopeBase;
+/** Run the in-page scan on the whole document, or on the one element a strict locator names. */
+export declare function scanPage(page: any, request: ObserveRequest, base: ScopeBase): Promise<RawScan>;
+type Json = Record<string, unknown>;
+export interface ObservedSections {
+    controls?: Json[];
+    links?: Json[];
+    tables?: Json[];
+    frames?: Json[];
+    counts: Json;
+    limits: string[];
+}
+/** Check every candidate on the live page and build the records. */
+export declare function describeScan(page: any, raw: RawScan, request: ObserveRequest, base: ScopeBase): Promise<ObservedSections>;
+export { scopeBase };
+export interface FitInput {
+    /** Everything outside the sections: url, title, targetId, generation, counts, frames, limits. */
+    head: Json;
+    text?: string;
+    controls?: Json[];
+    links?: Json[];
+    tables?: Json[];
+}
+export interface Truncation {
+    omittedBySection: Record<string, number>;
+    reason: string;
+}
+/**
+ * Shrink the sections until the serialized record fits `maxBytes`. The largest section is shaved first,
+ * a step at a time, so the budget ends up shared instead of one section taking all of it. Items and rows
+ * are dropped whole and text is cut at a character, so the JSON stays valid. `found` is how many items
+ * the page had per section before maxItems applied.
+ */
+export declare function fitObservation(input: FitInput, maxBytes: number, found: {
+    controls?: number;
+    links?: number;
+    tables?: number;
+}, maxItems: number): {
+    record: Json;
+    truncation?: Truncation;
+};

package/lib/observe.js

@@ -0,0 +1,368 @@
+/**
+ * Structured page observation behind `observe.read` sections.
+ *
+ * The in-page scan (`observe-script.ts`) reads the DOM; this module turns its output into the
+ * model-facing record:
+ *
+ * - every listed element gets a candidate LocatorSpec that was CHECKED against the live page: it matches
+ *   that element and no other (`locator`), or, when no candidate is unique, the best one is returned with
+ *   `ambiguous: true`, how many elements it matches, and the element's position among them (`nth`);
+ * - the whole result is fitted to a byte budget by dropping whole items or text from the end, so the JSON
+ *   is always valid and `truncation` says what was left out.
+ *
+ * A property that was not observed is absent: `false` always means "observed, and not so".
+ * @module dsh-browser/observe
+ */
+import { OBSERVE_MAX_FRAMES, OBSERVE_MAX_FRAME_DEPTH, OBSERVE_SOURCE, IDENTITY_SOURCE } from "./observe-script.js";
+import { resolveLocator, validateLocatorSpec, withStrictLocator } from "./locator.js";
+export const OBSERVE_SECTIONS = ['content', 'controls', 'links', 'tables'];
+export const OBSERVE_DEFAULT_ITEMS = 50;
+export const OBSERVE_MAX_ITEMS = 500;
+export const OBSERVE_DEFAULT_BYTES = 24_000;
+export const OBSERVE_MIN_BYTES = 2_000;
+export const OBSERVE_MAX_BYTES = 90_000;
+export class ObserveArgError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ObserveArgError';
+    }
+}
+/** Check and complete the raw arguments (the registry validated their types already). */
+export function normalizeObserve(raw) {
+    const sections = [...new Set(raw.sections ?? ['content'])];
+    if (!sections.length)
+        throw new ObserveArgError('sections must list at least one of content, controls, links, tables');
+    for (const section of sections)
+        if (!OBSERVE_SECTIONS.includes(section))
+            throw new ObserveArgError(`unknown section "${section}"; use content, controls, links, or tables`);
+    const maxItems = raw.maxItems ?? OBSERVE_DEFAULT_ITEMS;
+    if (!Number.isInteger(maxItems) || maxItems < 1 || maxItems > OBSERVE_MAX_ITEMS)
+        throw new ObserveArgError(`maxItems must be an integer from 1 to ${OBSERVE_MAX_ITEMS}`);
+    const maxBytes = raw.maxBytes ?? OBSERVE_DEFAULT_BYTES;
+    if (!Number.isInteger(maxBytes) || maxBytes < OBSERVE_MIN_BYTES || maxBytes > OBSERVE_MAX_BYTES)
+        throw new ObserveArgError(`maxBytes must be an integer from ${OBSERVE_MIN_BYTES} to ${OBSERVE_MAX_BYTES}`);
+    const region = raw.region;
+    if (region) {
+        const { x, y, width, height } = region;
+        if (![x, y, width, height].every(Number.isFinite) || width <= 0 || height <= 0)
+            throw new ObserveArgError('region must be {x, y, width, height} in viewport pixels with a positive width and height');
+    }
+    const timeoutMs = raw.timeoutMs ?? 15_000;
+    if (!Number.isFinite(timeoutMs) || timeoutMs < 1 || timeoutMs > 30_000)
+        throw new ObserveArgError('timeoutMs must be between 1 and 30,000 ms');
+    return {
+        sections,
+        ...raw.target !== undefined ? { target: raw.target } : {},
+        ...region ? { region } : {},
+        maxItems, maxBytes, includeValues: raw.includeValues === true, timeoutMs,
+    };
+}
+function scopeBase(target) {
+    if (target === undefined)
+        return { framePath: [] };
+    const spec = validateLocatorSpec(typeof target === 'string' ? { selector: target } : target);
+    if (spec.framePath)
+        return { framePath: [...spec.framePath] };
+    if (spec.frame?.selector)
+        return { framePath: [spec.frame.selector] };
+    if (spec.frame)
+        return { framePath: [], frame: spec.frame };
+    return { framePath: [] };
+}
+/** Run the in-page scan on the whole document, or on the one element a strict locator names. */
+export async function scanPage(page, request, base) {
+    const options = {
+        controls: request.sections.includes('controls'),
+        links: request.sections.includes('links'),
+        tables: request.sections.includes('tables'),
+        maxItems: request.maxItems,
+        includeValues: request.includeValues,
+        ...request.region ? { region: request.region } : {},
+        maxFrameDepth: Math.max(0, OBSERVE_MAX_FRAME_DEPTH - base.framePath.length),
+        maxFrames: OBSERVE_MAX_FRAMES,
+        // A frame addressed by name or url cannot be extended with nested framePath entries.
+        noFrames: base.frame !== undefined,
+    };
+    if (request.target === undefined)
+        return await page.evaluate(`(${OBSERVE_SOURCE})(document, ${JSON.stringify(options)})`);
+    const locator = resolveLocator(page, request.target);
+    // The function text is turned into a real Function so Playwright serializes it as a function, not an expression.
+    const run = new Function('el', 'opts', `return (${OBSERVE_SOURCE})(el, opts)`);
+    return await withStrictLocator(locator, l => l.evaluate(run, options, { timeout: request.timeoutMs }));
+}
+const IDENTITY = new Function('els', `return (${IDENTITY_SOURCE})(els)`);
+function fullSpec(candidate, path, base) {
+    const framePath = [...base.framePath, ...path];
+    return {
+        ...candidate,
+        ...framePath.length ? { framePath } : {},
+        ...base.frame ? { frame: base.frame } : {},
+    };
+}
+/**
+ * Pick the first candidate that matches exactly the element with this number. A candidate matching more
+ * elements is remembered (fewest matches wins) and returned flagged `ambiguous` if no candidate is unique.
+ */
+async function bind(page, id, candidates, path, base) {
+    let best;
+    for (const candidate of candidates ?? []) {
+        let spec;
+        let ids;
+        try {
+            spec = fullSpec(candidate, path, base);
+            ids = await resolveLocator(page, spec).evaluateAll(IDENTITY);
+        }
+        catch {
+            continue;
+        }
+        const at = ids.indexOf(id);
+        if (at < 0)
+            continue;
+        if (ids.length === 1)
+            return { locator: spec };
+        if (!best || ids.length < best.matches)
+            best = { spec, matches: ids.length, nth: at };
+    }
+    return best ? { locator: best.spec, ambiguous: true, matches: best.matches, nth: best.nth } : { ambiguous: true };
+}
+/** Bind with a small pool and a time limit; whatever is not reached in time stays unbound and is reported. */
+async function bindAll(items, job, deadline) {
+    let cursor = 0;
+    let skipped = 0;
+    const worker = async () => {
+        while (cursor < items.length) {
+            const item = items[cursor++];
+            if (Date.now() > deadline) {
+                skipped += 1;
+                continue;
+            }
+            await job(item);
+        }
+    };
+    await Promise.all(Array.from({ length: Math.min(6, items.length) }, worker));
+    return skipped;
+}
+function locatorFields(binding) {
+    return {
+        ...binding.locator ? { locator: binding.locator } : {},
+        ...binding.ambiguous ? { ambiguous: true } : {},
+        ...binding.matches !== undefined ? { matches: binding.matches, nth: binding.nth } : {},
+    };
+}
+/** Check every candidate on the live page and build the records. */
+export async function describeScan(page, raw, request, base) {
+    const deadline = Date.now() + 12_000;
+    let skipped = 0;
+    // `unverified` marks an item whose locator was not checked because the time ran out.
+    const pending = (binding) => binding ? locatorFields(binding) : { unverified: true };
+    const controls = [];
+    if (request.sections.includes('controls')) {
+        const bound = raw.controls.map(control => ({ control, binding: undefined, options: undefined }));
+        skipped += await bindAll(bound, async (entry) => {
+            const { control } = entry;
+            if (control.role === 'radiogroup') {
+                entry.options = [];
+                for (const option of control.options ?? [])
+                    entry.options.push(option.id !== undefined ? await bind(page, option.id, option.cands, control.path, base) : undefined);
+                entry.binding = {};
+            }
+            else if (control.id !== undefined)
+                entry.binding = await bind(page, control.id, control.cands, control.path, base);
+        }, deadline);
+        for (const { control, binding, options: optionBindings } of bound) {
+            const options = control.role === 'radiogroup'
+                ? (control.options ?? []).map((option, index) => ({
+                    label: option.label, value: option.value, checked: option.checked === true, ...option.disabled ? { disabled: true } : {}, ...pending(optionBindings?.[index]),
+                }))
+                : control.options;
+            controls.push({
+                ...control.role ? { role: control.role } : {},
+                ...control.name ? { name: control.name } : {},
+                ...control.type ? { type: control.type } : {},
+                ...control.role === 'radiogroup' ? {} : pending(binding),
+                actions: control.actions,
+                ...control.visible !== undefined ? { visible: control.visible } : {},
+                ...control.disabled !== undefined ? { disabled: control.disabled } : {},
+                ...control.readonly !== undefined ? { readonly: control.readonly } : {},
+                ...control.checked !== undefined ? { checked: control.checked } : {},
+                ...control.expanded !== undefined ? { expanded: control.expanded } : {},
+                ...control.hasValue !== undefined ? { hasValue: control.hasValue } : {},
+                ...control.value !== undefined ? { value: control.value } : {},
+                ...control.sensitive ? { sensitive: true } : {},
+                ...options ? { options } : {},
+                ...control.optionsTotal !== undefined ? { optionsTotal: control.optionsTotal } : {},
+                ...control.constraints ? { constraints: control.constraints } : {},
+                ...control.validity ? { validity: control.validity } : {},
+                source: control.source,
+            });
+        }
+    }
+    const links = [];
+    if (request.sections.includes('links')) {
+        const bound = raw.links.map(link => ({ link, binding: undefined }));
+        skipped += await bindAll(bound, async (entry) => { entry.binding = await bind(page, entry.link.id, entry.link.cands, entry.link.path, base); }, deadline);
+        for (const { link, binding } of bound) {
+            links.push({ text: link.text, href: link.href, ...pending(binding), visible: link.visible, ...link.target ? { target: link.target } : {} });
+        }
+    }
+    const tables = [];
+    if (request.sections.includes('tables')) {
+        const bound = raw.tables.map(table => ({ table, binding: undefined }));
+        skipped += await bindAll(bound, async (entry) => { entry.binding = await bind(page, entry.table.id, entry.table.cands, entry.table.path, base); }, deadline);
+        for (const { table, binding } of bound) {
+            tables.push({
+                ...table.name ? { name: table.name } : {},
+                ...pending(binding),
+                headers: table.headers, rows: table.rows, totalRows: table.totalRows,
+                ...table.declaredRows !== undefined ? { declaredRows: table.declaredRows } : {},
+                coverage: table.coverage,
+                ...table.reason ? { reason: table.reason } : {},
+            });
+        }
+    }
+    const limits = [];
+    if (skipped)
+        limits.push(`locator checking ran out of time: ${skipped} item(s) are listed without a checked locator (unverified: true)`);
+    const crossOrigin = raw.frames.filter(frame => frame.crossOrigin).length;
+    if (crossOrigin)
+        limits.push(`${crossOrigin} cross-origin or sandboxed iframe(s) are listed in frames but their content is not observed; act.* can still reach into one with its framePath if you know the element`);
+    if (raw.frames.some(frame => frame.skipped))
+        limits.push('some iframes were not entered (nesting or count limit)');
+    if (raw.framesOmitted)
+        limits.push(`${raw.framesOmitted} more iframe(s) were neither listed nor entered`);
+    return {
+        ...request.sections.includes('controls') ? { controls } : {},
+        ...request.sections.includes('links') ? { links } : {},
+        ...request.sections.includes('tables') ? { tables } : {},
+        ...raw.frames.length ? { frames: raw.frames.map(frame => ({ ...frame })) } : {},
+        counts: {
+            ...request.sections.includes('controls') ? { controls: raw.counts.controls } : {},
+            ...request.sections.includes('links') ? { links: raw.counts.links } : {},
+            ...request.sections.includes('tables') ? { tables: raw.counts.tables } : {},
+        },
+        limits,
+    };
+}
+export { scopeBase };
+// ---- fitting to a byte budget ---------------------------------------------------------------------
+const bytes = (value) => Buffer.byteLength(JSON.stringify(value));
+const TRUNCATION_RESERVE = 420;
+/** Drop the last characters of a string without splitting a surrogate pair. */
+function cutText(text, drop) {
+    let end = Math.max(0, text.length - drop);
+    if (end > 0 && end < text.length && /[\ud800-\udbff]/.test(text[end - 1]))
+        end -= 1;
+    return text.slice(0, end);
+}
+/**
+ * Shrink the sections until the serialized record fits `maxBytes`. The largest section is shaved first,
+ * a step at a time, so the budget ends up shared instead of one section taking all of it. Items and rows
+ * are dropped whole and text is cut at a character, so the JSON stays valid. `found` is how many items
+ * the page had per section before maxItems applied.
+ */
+export function fitObservation(input, maxBytes, found, maxItems) {
+    let text = input.text;
+    const lists = {
+        frames: Array.isArray(input.head.frames) ? [...input.head.frames] : undefined,
+        controls: input.controls ? [...input.controls] : undefined,
+        links: input.links ? [...input.links] : undefined,
+        tables: input.tables ? input.tables.map(table => ({ ...table, rows: [...table.rows] })) : undefined,
+    };
+    const droppedText = { chars: 0 };
+    const compose = () => ({
+        ...input.head,
+        ...lists.frames ? { frames: lists.frames } : {},
+        ...text !== undefined ? { text } : {},
+        ...lists.controls ? { controls: lists.controls } : {},
+        ...lists.links ? { links: lists.links } : {},
+        ...lists.tables ? { tables: lists.tables } : {},
+    });
+    const byBytes = new Set();
+    const byItems = new Set();
+    for (const name of ['controls', 'links', 'tables']) {
+        const total = found[name];
+        if (lists[name] && total !== undefined && total > lists[name].length)
+            byItems.add(name);
+    }
+    const tableRowsAtItems = (lists.tables ?? []).reduce((sum, table) => sum + Math.max(0, Number(table.totalRows) - table.rows.length), 0);
+    if (tableRowsAtItems > 0)
+        byItems.add('tables');
+    // Room kept for the `truncation` member the caller adds when anything was left out.
+    const budget = maxBytes - TRUNCATION_RESERVE;
+    for (let guard = 0; guard < 2_000; guard += 1) {
+        const total = bytes(compose());
+        if (total <= budget)
+            break;
+        const over = total - budget;
+        // Section sizes, largest first.
+        const sizes = [];
+        if (text !== undefined && text.length > 0)
+            sizes.push({ name: 'content', size: bytes(text) });
+        for (const name of ['controls', 'links', 'tables'])
+            if (lists[name]?.length)
+                sizes.push({ name, size: bytes(lists[name]) });
+        // The frame list is the last thing to give up: it explains what was not covered.
+        if (!sizes.length && lists.frames?.length)
+            sizes.push({ name: 'frames', size: bytes(lists.frames) });
+        if (!sizes.length)
+            break;
+        sizes.sort((a, b) => b.size - a.size);
+        const target = sizes[0];
+        const step = Math.min(over, Math.max(300, Math.ceil(target.size * 0.15)));
+        byBytes.add(target.name);
+        if (target.name === 'content') {
+            const before = text.length;
+            text = cutText(text, step);
+            droppedText.chars += before - text.length;
+            continue;
+        }
+        const list = lists[target.name];
+        let freed = 0;
+        while (freed < step && list.length) {
+            if (target.name === 'tables') {
+                // Rows of the table that has the most go first; a table with no rows left goes whole.
+                const widest = list.reduce((best, table) => table.rows.length > best.rows.length ? table : best, list[0]);
+                const rows = widest.rows;
+                if (rows.length) {
+                    freed += bytes(rows.pop()) + 1;
+                    continue;
+                }
+                const index = list.lastIndexOf(list.reduce((best, table) => bytes(table) > bytes(best) ? table : best, list[list.length - 1]));
+                freed += bytes(list.splice(index, 1)[0]) + 1;
+                continue;
+            }
+            freed += bytes(list.pop()) + 1;
+        }
+    }
+    const record = compose();
+    const omittedBySection = {};
+    if (droppedText.chars > 0)
+        omittedBySection.content = droppedText.chars;
+    for (const name of ['controls', 'links']) {
+        const listed = lists[name];
+        if (listed && found[name] !== undefined && found[name] > listed.length)
+            omittedBySection[name] = found[name] - listed.length;
+    }
+    const framesTotal = Array.isArray(input.head.frames) ? input.head.frames.length : 0;
+    if (lists.frames && lists.frames.length < framesTotal)
+        omittedBySection.frames = framesTotal - lists.frames.length;
+    if (lists.tables) {
+        if (found.tables !== undefined && found.tables > lists.tables.length)
+            omittedBySection.tables = found.tables - lists.tables.length;
+        const rowsOmitted = lists.tables.reduce((sum, table) => sum + Math.max(0, Number(table.totalRows) - table.rows.length), 0);
+        if (rowsOmitted > 0)
+            omittedBySection.tableRows = rowsOmitted;
+    }
+    if (!Object.keys(omittedBySection).length)
+        return { record };
+    const parts = [];
+    const itemSections = [...byItems].filter(name => omittedBySection[name] !== undefined || (name === 'tables' && omittedBySection.tableRows !== undefined));
+    if (itemSections.length)
+        parts.push(`maxItems=${maxItems} reached for ${itemSections.join(', ')}`);
+    const byteSections = [...byBytes].filter(name => omittedBySection[name === 'tables' ? 'tables' : name] !== undefined || (name === 'tables' && omittedBySection.tableRows !== undefined));
+    if (byteSections.length)
+        parts.push(`maxBytes=${maxBytes} reached for ${byteSections.join(', ')}`);
+    const units = 'content counts characters, tableRows counts rows, the others count items';
+    return { record, truncation: { omittedBySection, reason: `${parts.join('; ') || 'output limit reached'} (${units})` } };
+}
+//# sourceMappingURL=observe.js.map

package/lib/observe.js.map

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

package/lib/policy-keys.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The keys of the two JSON policy objects, in one place.
+ *
+ * The settings card validates what a person types into the "automation asset policy" and "usage buffer" boxes against
+ * these lists and prints them under the boxes, so a key added to a policy is added here once. This module has no
+ * imports on purpose: the card bundles it for the browser. test/policy-keys.test.ts holds the lists equal to what the
+ * resolvers return and to the Host Config schema.
+ * @module dsh-browser/policy-keys
+ */
+/** Every key of `automationAssets`, in documentation order. */
+export declare const ASSET_POLICY_KEYS: readonly ["enabled", "directory", "persistenceMode", "activationMode", "minSuccessfulRuns", "minDistinctSessions", "successWindowDays", "minSuccessRate", "maxCandidates", "candidateTtlDays", "maxSuggestionsPerDay", "maxDrafts", "maxActiveAssets", "retrievalTopK", "catalogTokenBudget", "modelDevelopmentEnabled", "maxModelDraftWritesPerSession", "maxTestCredentials", "minInputSetsForActivation"];
+export type AssetPolicyKey = typeof ASSET_POLICY_KEYS[number];
+/** The keys of `automationAssets` that are not plain non-negative numbers. */
+export declare const ASSET_POLICY_BOOLEAN_KEYS: readonly AssetPolicyKey[];
+export declare const ASSET_POLICY_STRING_KEYS: readonly AssetPolicyKey[];
+export declare const ASSET_POLICY_ENUMS: Partial<Record<AssetPolicyKey, readonly string[]>>;
+/** Numeric keys with a range the card enforces itself; the resolver would otherwise clamp silently. */
+export declare const ASSET_POLICY_INTEGER_RANGES: Partial<Record<AssetPolicyKey, readonly [number, number]>>;
+/** `usagePolicy`: every key with the inclusive integer range the resolver enforces. */
+export declare const USAGE_POLICY_BOUNDS: {
+    readonly minDelayMs: readonly [0, 60000];
+    readonly maxConcurrency: readonly [1, 8];
+    readonly burst: readonly [1, 20];
+    readonly maxPagesPerRun: readonly [1, 100];
+    readonly maxDepth: readonly [0, 5];
+    readonly retryLimit: readonly [0, 5];
+    readonly backoffBaseMs: readonly [1, 60000];
+    readonly cooldownMs: readonly [100, 300000];
+};
+export declare const USAGE_POLICY_KEYS: (keyof typeof USAGE_POLICY_BOUNDS)[];

package/lib/policy-keys.js

@@ -0,0 +1,34 @@
+/**
+ * The keys of the two JSON policy objects, in one place.
+ *
+ * The settings card validates what a person types into the "automation asset policy" and "usage buffer" boxes against
+ * these lists and prints them under the boxes, so a key added to a policy is added here once. This module has no
+ * imports on purpose: the card bundles it for the browser. test/policy-keys.test.ts holds the lists equal to what the
+ * resolvers return and to the Host Config schema.
+ * @module dsh-browser/policy-keys
+ */
+/** Every key of `automationAssets`, in documentation order. */
+export const ASSET_POLICY_KEYS = [
+    'enabled', 'directory', 'persistenceMode', 'activationMode', 'minSuccessfulRuns', 'minDistinctSessions',
+    'successWindowDays', 'minSuccessRate', 'maxCandidates', 'candidateTtlDays', 'maxSuggestionsPerDay',
+    'maxDrafts', 'maxActiveAssets', 'retrievalTopK', 'catalogTokenBudget',
+    'modelDevelopmentEnabled', 'maxModelDraftWritesPerSession', 'maxTestCredentials', 'minInputSetsForActivation',
+];
+/** The keys of `automationAssets` that are not plain non-negative numbers. */
+export const ASSET_POLICY_BOOLEAN_KEYS = ['enabled', 'modelDevelopmentEnabled'];
+export const ASSET_POLICY_STRING_KEYS = ['directory'];
+export const ASSET_POLICY_ENUMS = {
+    persistenceMode: ['off', 'manual', 'suggest', 'auto-draft'],
+    activationMode: ['manual', 'auto-tested'],
+};
+/** Numeric keys with a range the card enforces itself; the resolver would otherwise clamp silently. */
+export const ASSET_POLICY_INTEGER_RANGES = {
+    minInputSetsForActivation: [1, 5],
+};
+/** `usagePolicy`: every key with the inclusive integer range the resolver enforces. */
+export const USAGE_POLICY_BOUNDS = {
+    minDelayMs: [0, 60_000], maxConcurrency: [1, 8], burst: [1, 20], maxPagesPerRun: [1, 100],
+    maxDepth: [0, 5], retryLimit: [0, 5], backoffBaseMs: [1, 60_000], cooldownMs: [100, 300_000],
+};
+export const USAGE_POLICY_KEYS = Object.keys(USAGE_POLICY_BOUNDS);
+//# sourceMappingURL=policy-keys.js.map

package/lib/policy-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-keys.js","sourceRoot":"","sources":["../src/policy-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,+DAA+D;AAC/D,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,qBAAqB;IACvG,mBAAmB,EAAE,gBAAgB,EAAE,eAAe,EAAE,kBAAkB,EAAE,sBAAsB;IAClG,WAAW,EAAE,iBAAiB,EAAE,eAAe,EAAE,oBAAoB;IACrE,yBAAyB,EAAE,+BAA+B,EAAE,oBAAoB,EAAE,2BAA2B;CACrG,CAAA;AAIV,8EAA8E;AAC9E,MAAM,CAAC,MAAM,yBAAyB,GAA8B,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAA;AAC1G,MAAM,CAAC,MAAM,wBAAwB,GAA8B,CAAC,WAAW,CAAC,CAAA;AAChF,MAAM,CAAC,MAAM,kBAAkB,GAAuD;IACpF,eAAe,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,CAAC;IAC3D,cAAc,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC;CAC1C,CAAA;AACD,uGAAuG;AACvG,MAAM,CAAC,MAAM,2BAA2B,GAA+D;IACrG,yBAAyB,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;CAClC,CAAA;AAED,uFAAuF;AACvF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC;IACzF,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC;CAChC,CAAA;AAE9D,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAyC,CAAA"}