@anweat/dsh-browser 0.1.17 → 0.2.0

package/lib/prompt-limits.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Length caps of the `prompts` overrides. A module of its own (no imports) so the settings panel, which is built
+ * for the browser, can validate against the same numbers the plugin enforces.
+ * @module dsh-browser/prompt-limits
+ */
+/** A `prompts.skill.bodyFile` larger than this many characters is not used. */
+export declare const SKILL_BODY_FILE_LIMIT = 20000;
+/** Length caps (in characters) of each kind of override. A longer value is ignored, not truncated. */
+export declare const PROMPT_LIMITS: {
+    /** A group or action summary: one line of the catalog. */
+    readonly summary: 300;
+    /** The extra guidance of an action or sub-action. */
+    readonly notes: 1000;
+    /** The text of a detail topic (`observe.read.controls`), which is a page of its own. */
+    readonly topicText: 3500;
+    /** A tool description (`prompts.tools.<tool>.description`). */
+    readonly description: 1500;
+    /** The compact guide that replaces the skill pointer at the root. */
+    readonly rootGuide: 1500;
+    /** The deployer's note at the end of the root. */
+    readonly rootNote: 800;
+    /** The hint of one error code. */
+    readonly errorHint: 600;
+    /** The skill's description in the skill list. */
+    readonly skillDescription: 1000;
+    /** Text appended to the skill body. */
+    readonly skillAppend: 4000;
+    /** A `skill.bodyFile` larger than this falls back to the packaged body. */
+    readonly skillBodyFile: 20000;
+};

package/lib/prompt-limits.js

@@ -0,0 +1,31 @@
+/**
+ * Length caps of the `prompts` overrides. A module of its own (no imports) so the settings panel, which is built
+ * for the browser, can validate against the same numbers the plugin enforces.
+ * @module dsh-browser/prompt-limits
+ */
+/** A `prompts.skill.bodyFile` larger than this many characters is not used. */
+export const SKILL_BODY_FILE_LIMIT = 20_000;
+/** Length caps (in characters) of each kind of override. A longer value is ignored, not truncated. */
+export const PROMPT_LIMITS = {
+    /** A group or action summary: one line of the catalog. */
+    summary: 300,
+    /** The extra guidance of an action or sub-action. */
+    notes: 1000,
+    /** The text of a detail topic (`observe.read.controls`), which is a page of its own. */
+    topicText: 3500,
+    /** A tool description (`prompts.tools.<tool>.description`). */
+    description: 1500,
+    /** The compact guide that replaces the skill pointer at the root. */
+    rootGuide: 1500,
+    /** The deployer's note at the end of the root. */
+    rootNote: 800,
+    /** The hint of one error code. */
+    errorHint: 600,
+    /** The skill's description in the skill list. */
+    skillDescription: 1000,
+    /** Text appended to the skill body. */
+    skillAppend: 4000,
+    /** A `skill.bodyFile` larger than this falls back to the packaged body. */
+    skillBodyFile: SKILL_BODY_FILE_LIMIT,
+};
+//# sourceMappingURL=prompt-limits.js.map

package/lib/prompt-limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-limits.js","sourceRoot":"","sources":["../src/prompt-limits.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,+EAA+E;AAC/E,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAA;AAE3C,sGAAsG;AACtG,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,0DAA0D;IAC1D,OAAO,EAAE,GAAG;IACZ,qDAAqD;IACrD,KAAK,EAAE,IAAI;IACX,wFAAwF;IACxF,SAAS,EAAE,IAAI;IACf,+DAA+D;IAC/D,WAAW,EAAE,IAAI;IACjB,qEAAqE;IACrE,SAAS,EAAE,IAAI;IACf,kDAAkD;IAClD,QAAQ,EAAE,GAAG;IACb,kCAAkC;IAClC,SAAS,EAAE,GAAG;IACd,iDAAiD;IACjD,gBAAgB,EAAE,IAAI;IACtB,uCAAuC;IACvC,WAAW,EAAE,IAAI;IACjB,2EAA2E;IAC3E,aAAa,EAAE,qBAAqB;CAC5B,CAAA"}

package/lib/prompts.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Deployment overrides of the model-facing text (`prompts` configuration).
+ *
+ * Every sentence the model reads that is guidance rather than contract can be replaced by the
+ * deployer: the two L0 tool descriptions, the root guide, group and action summaries and notes,
+ * error hints, and the `dsh-browser` skill. Names, parameter schemas, error codes, approval
+ * wording and the compliance notice are NOT configurable.
+ *
+ * This module is the one place that knows the shape: it validates a raw `prompts` value into
+ * {@link ResolvedPrompts} (never throwing: bad entries are dropped and reported as diagnostics),
+ * lists the built-in defaults in the same shape ({@link defaultPrompts}, behind `prompts:dump`),
+ * and measures what an override does to the context budget.
+ * @module dsh-browser/prompts
+ */
+import { type ActionGroup } from './actions/types.ts';
+import { CHARS_PER_TOKEN } from './tool-defs.ts';
+import { PROMPT_LIMITS } from './prompt-limits.ts';
+import type { AutomationMode, ExposureOptions } from './freedom.ts';
+export { PROMPT_LIMITS };
+/** Context budgets from the tool-system design (estimated tokens = characters / 3.5, as `measure:tools` counts). */
+export { CHARS_PER_TOKEN };
+export declare const L0_BUDGET_TOKENS = 1500;
+export declare const LAYER_BUDGET_TOKENS = 1000;
+export type PromptDiagnosticCode = 'invalid-type' | 'too-long' | 'unknown-key' | 'unknown-group' | 'unknown-action' | 'unknown-error-code' | 'not-overridable' | 'relative-body-file' | 'body-file' | 'budget-l0' | 'budget-layer';
+export interface PromptDiagnostic {
+    level: 'warn' | 'info';
+    code: PromptDiagnosticCode;
+    /** The configuration key the entry is about, e.g. `actions.act.click.summary`. */
+    key: string;
+    message: string;
+}
+/** One accepted override, by key and length only (the text itself is never echoed back). */
+export interface AppliedPrompt {
+    key: string;
+    length?: number;
+}
+/** The validated, effective overrides. Absent members mean "use the built-in text". */
+export interface ResolvedPrompts {
+    tools: {
+        browser_index?: string;
+        browser_call?: string;
+    };
+    rootGuide?: string;
+    rootNote?: string;
+    groups: Partial<Record<ActionGroup, string>>;
+    /** Keyed by `group.action`, `group.action.sub` or `group.action.topic`; a topic's `notes` is its detail text. */
+    actions: Record<string, {
+        summary?: string;
+        notes?: string;
+    }>;
+    errorHints: Partial<Record<string, string>>;
+    skill: {
+        enabled: boolean;
+        description?: string;
+        bodyFile?: string;
+        append?: string;
+    };
+    applied: AppliedPrompt[];
+    diagnostics: PromptDiagnostic[];
+}
+/** The overrides of nothing: what the plugin uses when `prompts` is not configured. */
+export declare const NO_PROMPTS: ResolvedPrompts;
+/** The error codes whose hint has one fixed text, and so can be replaced. */
+export declare const OVERRIDABLE_ERROR_CODES: readonly string[];
+/**
+ * Validate a raw `prompts` value. Never throws: a malformed or unknown entry is left out and described in
+ * `diagnostics`; everything else still applies.
+ */
+export declare function resolvePrompts(raw: unknown): ResolvedPrompts;
+/** A live view of the configured overrides. `current()` re-reads the config each time, so a change applies to the next call. */
+export interface PromptsSource {
+    current(): ResolvedPrompts;
+}
+/**
+ * Wrap a reader of the raw `prompts` value. The result is cached by the identity of what the reader returns, so
+ * an unchanged config costs nothing per call while a changed one (a volatile reference holds a new snapshot after
+ * every write) is validated again.
+ */
+export declare function promptsSource(read: () => unknown): PromptsSource;
+/** A source that never overrides anything. */
+export declare const NO_PROMPTS_SOURCE: PromptsSource;
+/**
+ * Every overridable text with its built-in value, in the exact structure of the `prompts` configuration. Pasted back
+ * as the configuration it changes nothing (a blank `notes`, `rootNote` or `append` means "none"), which makes it the
+ * starting point for editing: delete what stays default, reword the rest.
+ */
+export declare function defaultPrompts(): Record<string, unknown>;
+/**
+ * The text `prompts:dump` prints and the settings card's "Export default text" shows: {@link defaultPrompts} as JSON,
+ * two-space indented unless `compact`. One function, so the script and the card cannot drift apart.
+ */
+export declare function promptsDumpText(compact?: boolean): string;
+export interface PromptBudget {
+    /** Estimated tokens of the two L0 tools (name + description + parameters, as the host sends them). */
+    l0Tokens: number;
+    l0Budget: number;
+    layerBudget: number;
+    /** The largest browser_index layer (root, a group, an action, a sub-action or a topic). */
+    largestLayer: {
+        name: string;
+        tokens: number;
+    };
+    /** Every layer over the per-layer budget. */
+    overBudget: {
+        name: string;
+        tokens: number;
+    }[];
+}
+export interface BudgetEnvironment {
+    mode: AutomationMode;
+    options: ExposureOptions;
+    enabled: boolean;
+}
+/** Measure the L0 tools and every browser_index layer under these overrides. */
+export declare function measurePromptBudget(prompts: ResolvedPrompts, environment: BudgetEnvironment): PromptBudget;
+export interface PromptsStatus {
+    /** The overrides in force, by key and length. */
+    overrides: AppliedPrompt[];
+    /** Everything ignored or worth a warning, including budget overruns. */
+    diagnostics: PromptDiagnostic[];
+    budget: PromptBudget;
+    skill: {
+        enabled: boolean;
+        body: 'packaged' | 'file';
+        bodyFile?: string;
+    };
+}
+/** What `runtime.status` reports under `prompts`, and the settings panel shows. Reads the live configuration. */
+export declare function describePrompts(config: {
+    prompts?: PromptsSource;
+} & BudgetEnvironment): PromptsStatus;

package/lib/prompts.js

@@ -0,0 +1,295 @@
+/**
+ * Deployment overrides of the model-facing text (`prompts` configuration).
+ *
+ * Every sentence the model reads that is guidance rather than contract can be replaced by the
+ * deployer: the two L0 tool descriptions, the root guide, group and action summaries and notes,
+ * error hints, and the `dsh-browser` skill. Names, parameter schemas, error codes, approval
+ * wording and the compliance notice are NOT configurable.
+ *
+ * This module is the one place that knows the shape: it validates a raw `prompts` value into
+ * {@link ResolvedPrompts} (never throwing: bad entries are dropped and reported as diagnostics),
+ * lists the built-in defaults in the same shape ({@link defaultPrompts}, behind `prompts:dump`),
+ * and measures what an override does to the context budget.
+ * @module dsh-browser/prompts
+ */
+import path from 'node:path';
+import { ACTIONS, GROUP_SUMMARIES, findAction, findSubAction, findTopic } from "./actions/registry.js";
+import { ACTION_GROUPS, ERROR_CODES } from "./actions/types.js";
+import { DEFAULT_ERROR_HINTS } from "./actions/errors.js";
+import { COMPACT_GUIDE, renderIndex } from "./actions/index-view.js";
+import { CHARS_PER_TOKEN, DEFAULT_CALL_DESCRIPTION, DEFAULT_INDEX_DESCRIPTION, PROMPT_TOOL_NAMES, estimateTokens, indexedToolDefinitions, modelFacingChars } from "./tool-defs.js";
+import { readSkill, loadSkillBodyFile } from "./skill.js";
+import { PROMPT_LIMITS } from "./prompt-limits.js";
+export { PROMPT_LIMITS };
+/** Context budgets from the tool-system design (estimated tokens = characters / 3.5, as `measure:tools` counts). */
+export { CHARS_PER_TOKEN };
+export const L0_BUDGET_TOKENS = 1500;
+export const LAYER_BUDGET_TOKENS = 1000;
+/** The overrides of nothing: what the plugin uses when `prompts` is not configured. */
+export const NO_PROMPTS = Object.freeze({
+    tools: Object.freeze({}), groups: Object.freeze({}), actions: Object.freeze({}), errorHints: Object.freeze({}),
+    skill: Object.freeze({ enabled: true }), applied: Object.freeze([]), diagnostics: Object.freeze([]),
+});
+/** The error codes whose hint has one fixed text, and so can be replaced. */
+export const OVERRIDABLE_ERROR_CODES = Object.keys(DEFAULT_ERROR_HINTS);
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+/**
+ * Validate a raw `prompts` value. Never throws: a malformed or unknown entry is left out and described in
+ * `diagnostics`; everything else still applies.
+ */
+export function resolvePrompts(raw) {
+    if (raw === undefined || raw === null)
+        return NO_PROMPTS;
+    const diagnostics = [];
+    const applied = [];
+    const warn = (code, key, message) => { diagnostics.push({ level: 'warn', code, key, message }); };
+    if (!isRecord(raw)) {
+        warn('invalid-type', 'prompts', 'prompts must be an object; ignored');
+        return { ...NO_PROMPTS, diagnostics };
+    }
+    /** A text override: blank means "use the default"; a wrong type or an over-long value is ignored. */
+    const text = (value, key, limit) => {
+        if (value === undefined || value === null)
+            return undefined;
+        if (typeof value !== 'string') {
+            warn('invalid-type', key, `${key} must be a string; ignored`);
+            return undefined;
+        }
+        if (value.trim() === '')
+            return undefined;
+        if (value.length > limit) {
+            warn('too-long', key, `${key} is ${value.length} characters, over the limit of ${limit}; ignored`);
+            return undefined;
+        }
+        applied.push({ key, length: value.length });
+        return value;
+    };
+    const unknownKeys = (value, allowed, prefix) => {
+        for (const name of Object.keys(value))
+            if (!allowed.includes(name))
+                warn('unknown-key', prefix ? `${prefix}.${name}` : name, `${prefix ? `${prefix}.${name}` : name} is not a prompts key; ignored`);
+    };
+    const section = (value, key) => {
+        if (value === undefined || value === null)
+            return undefined;
+        if (!isRecord(value)) {
+            warn('invalid-type', key, `${key} must be an object; ignored`);
+            return undefined;
+        }
+        return value;
+    };
+    unknownKeys(raw, ['tools', 'rootGuide', 'rootNote', 'groups', 'actions', 'errorHints', 'skill'], '');
+    const tools = {};
+    const toolsRaw = section(raw.tools, 'tools');
+    if (toolsRaw) {
+        unknownKeys(toolsRaw, PROMPT_TOOL_NAMES, 'tools');
+        for (const name of PROMPT_TOOL_NAMES) {
+            const entry = section(toolsRaw[name], `tools.${name}`);
+            if (!entry)
+                continue;
+            unknownKeys(entry, ['description'], `tools.${name}`);
+            const description = text(entry.description, `tools.${name}.description`, PROMPT_LIMITS.description);
+            if (description !== undefined)
+                tools[name] = description;
+        }
+    }
+    const rootGuide = text(raw.rootGuide, 'rootGuide', PROMPT_LIMITS.rootGuide);
+    const rootNote = text(raw.rootNote, 'rootNote', PROMPT_LIMITS.rootNote);
+    const groups = {};
+    const groupsRaw = section(raw.groups, 'groups');
+    if (groupsRaw) {
+        for (const [name, value] of Object.entries(groupsRaw)) {
+            if (!ACTION_GROUPS.includes(name)) {
+                warn('unknown-group', `groups.${name}`, `groups.${name}: no such group (groups: ${ACTION_GROUPS.join(', ')}); ignored`);
+                continue;
+            }
+            const entry = section(value, `groups.${name}`);
+            if (!entry)
+                continue;
+            unknownKeys(entry, ['summary'], `groups.${name}`);
+            const summary = text(entry.summary, `groups.${name}.summary`, PROMPT_LIMITS.summary);
+            if (summary !== undefined)
+                groups[name] = summary;
+        }
+    }
+    const actions = {};
+    const actionsRaw = section(raw.actions, 'actions');
+    if (actionsRaw) {
+        for (const [name, value] of Object.entries(actionsRaw)) {
+            if (!findAction(name) && !findSubAction(name) && !findTopic(name)) {
+                warn('unknown-action', `actions.${name}`, `actions.${name}: no such action, sub-action or detail topic; ignored`);
+                continue;
+            }
+            const entry = section(value, `actions.${name}`);
+            if (!entry)
+                continue;
+            unknownKeys(entry, ['summary', 'notes'], `actions.${name}`);
+            const summary = text(entry.summary, `actions.${name}.summary`, PROMPT_LIMITS.summary);
+            const topicOnly = !findAction(name) && !findSubAction(name);
+            const notes = text(entry.notes, `actions.${name}.notes`, topicOnly ? PROMPT_LIMITS.topicText : PROMPT_LIMITS.notes);
+            if (summary !== undefined || notes !== undefined)
+                actions[name] = { ...summary !== undefined ? { summary } : {}, ...notes !== undefined ? { notes } : {} };
+        }
+    }
+    const errorHints = {};
+    const hintsRaw = section(raw.errorHints, 'errorHints');
+    if (hintsRaw) {
+        for (const [code, value] of Object.entries(hintsRaw)) {
+            if (!ERROR_CODES.includes(code)) {
+                warn('unknown-error-code', `errorHints.${code}`, `errorHints.${code}: not an error code; ignored`);
+                continue;
+            }
+            if (!OVERRIDABLE_ERROR_CODES.includes(code)) {
+                warn('not-overridable', `errorHints.${code}`, `errorHints.${code}: this code has no fixed hint to replace (overridable: ${OVERRIDABLE_ERROR_CODES.join(', ')}); ignored`);
+                continue;
+            }
+            const hint = text(value, `errorHints.${code}`, PROMPT_LIMITS.errorHint);
+            if (hint !== undefined)
+                errorHints[code] = hint;
+        }
+    }
+    const skill = { enabled: true };
+    const skillRaw = section(raw.skill, 'skill');
+    if (skillRaw) {
+        unknownKeys(skillRaw, ['enabled', 'description', 'bodyFile', 'append'], 'skill');
+        if (skillRaw.enabled !== undefined && skillRaw.enabled !== null) {
+            if (typeof skillRaw.enabled !== 'boolean')
+                warn('invalid-type', 'skill.enabled', 'skill.enabled must be true or false; ignored');
+            else {
+                skill.enabled = skillRaw.enabled;
+                if (!skill.enabled)
+                    applied.push({ key: 'skill.enabled' });
+            }
+        }
+        const description = text(skillRaw.description, 'skill.description', PROMPT_LIMITS.skillDescription);
+        if (description !== undefined)
+            skill.description = description;
+        const append = text(skillRaw.append, 'skill.append', PROMPT_LIMITS.skillAppend);
+        if (append !== undefined)
+            skill.append = append;
+        if (skillRaw.bodyFile !== undefined && skillRaw.bodyFile !== null) {
+            if (typeof skillRaw.bodyFile !== 'string')
+                warn('invalid-type', 'skill.bodyFile', 'skill.bodyFile must be a string; ignored');
+            else if (skillRaw.bodyFile.trim() !== '') {
+                if (!path.isAbsolute(skillRaw.bodyFile))
+                    warn('relative-body-file', 'skill.bodyFile', 'skill.bodyFile must be an absolute path; the packaged body is used');
+                else {
+                    skill.bodyFile = skillRaw.bodyFile;
+                    applied.push({ key: 'skill.bodyFile', length: skillRaw.bodyFile.length });
+                }
+            }
+        }
+    }
+    const empty = !Object.keys(tools).length && rootGuide === undefined && rootNote === undefined && !Object.keys(groups).length
+        && !Object.keys(actions).length && !Object.keys(errorHints).length && applied.length === 0;
+    if (empty && diagnostics.length === 0)
+        return NO_PROMPTS;
+    return {
+        tools, ...rootGuide !== undefined ? { rootGuide } : {}, ...rootNote !== undefined ? { rootNote } : {},
+        groups, actions, errorHints, skill, applied, diagnostics,
+    };
+}
+/**
+ * Wrap a reader of the raw `prompts` value. The result is cached by the identity of what the reader returns, so
+ * an unchanged config costs nothing per call while a changed one (a volatile reference holds a new snapshot after
+ * every write) is validated again.
+ */
+export function promptsSource(read) {
+    let last;
+    let resolved;
+    return {
+        current() {
+            const raw = read();
+            if (resolved === undefined || raw !== last) {
+                last = raw;
+                resolved = resolvePrompts(raw);
+            }
+            return resolved;
+        },
+    };
+}
+/** A source that never overrides anything. */
+export const NO_PROMPTS_SOURCE = { current: () => NO_PROMPTS };
+// --- defaults, in the shape of the configuration ---------------------------------------------------------------
+/** The sub-actions and detail topics of an action, as the keys `prompts.actions` addresses them by. */
+function* promptTargets() {
+    for (const action of ACTIONS) {
+        yield { key: action.name, summary: action.summary, notes: action.notes ?? '' };
+        for (const [sub, def] of Object.entries(action.subActions?.items ?? {}))
+            yield { key: `${action.name}.${sub}`, summary: def.summary, notes: def.notes ?? '' };
+        for (const [topic, def] of Object.entries(action.topics ?? {}))
+            yield { key: `${action.name}.${topic}`, summary: def.summary, notes: def.text };
+    }
+}
+/**
+ * Every overridable text with its built-in value, in the exact structure of the `prompts` configuration. Pasted back
+ * as the configuration it changes nothing (a blank `notes`, `rootNote` or `append` means "none"), which makes it the
+ * starting point for editing: delete what stays default, reword the rest.
+ */
+export function defaultPrompts() {
+    const skill = readSkill();
+    return {
+        tools: {
+            browser_index: { description: DEFAULT_INDEX_DESCRIPTION },
+            browser_call: { description: DEFAULT_CALL_DESCRIPTION },
+        },
+        rootGuide: COMPACT_GUIDE,
+        rootNote: '',
+        groups: Object.fromEntries(ACTION_GROUPS.map(group => [group, { summary: GROUP_SUMMARIES[group] }])),
+        actions: Object.fromEntries([...promptTargets()].map(target => [target.key, { summary: target.summary, notes: target.notes }])),
+        errorHints: { ...DEFAULT_ERROR_HINTS },
+        skill: { enabled: true, description: skill.description, bodyFile: '', append: '' },
+    };
+}
+/**
+ * The text `prompts:dump` prints and the settings card's "Export default text" shows: {@link defaultPrompts} as JSON,
+ * two-space indented unless `compact`. One function, so the script and the card cannot drift apart.
+ */
+export function promptsDumpText(compact = false) {
+    return JSON.stringify(defaultPrompts(), null, compact ? 0 : 2);
+}
+// --- budget and status -----------------------------------------------------------------------------------------
+const tokensOf = estimateTokens;
+/** Measure the L0 tools and every browser_index layer under these overrides. */
+export function measurePromptBudget(prompts, environment) {
+    const l0Chars = modelFacingChars(indexedToolDefinitions(prompts.tools));
+    const env = (skillAvailable) => ({ mode: environment.mode, options: environment.options, enabled: environment.enabled, skillAvailable, prompts });
+    const layers = [
+        { name: 'root', tokens: tokensOf(renderIndex({}, env(false)).text.length) },
+        { name: 'root (skill present)', tokens: tokensOf(renderIndex({}, env(true)).text.length) },
+    ];
+    for (const group of ACTION_GROUPS)
+        layers.push({ name: group, tokens: tokensOf(renderIndex({ group }, env(true)).text.length) });
+    for (const target of promptTargets())
+        layers.push({ name: target.key, tokens: tokensOf(renderIndex({ action: target.key }, env(true)).text.length) });
+    const largest = layers.reduce((best, layer) => layer.tokens > best.tokens ? layer : best);
+    return {
+        l0Tokens: tokensOf(l0Chars), l0Budget: L0_BUDGET_TOKENS, layerBudget: LAYER_BUDGET_TOKENS,
+        largestLayer: largest, overBudget: layers.filter(layer => layer.tokens > LAYER_BUDGET_TOKENS),
+    };
+}
+/** What `runtime.status` reports under `prompts`, and the settings panel shows. Reads the live configuration. */
+export function describePrompts(config) {
+    const prompts = config.prompts?.current() ?? NO_PROMPTS;
+    const diagnostics = [...prompts.diagnostics];
+    const budget = measurePromptBudget(prompts, config);
+    if (budget.l0Tokens > L0_BUDGET_TOKENS)
+        diagnostics.push({ level: 'warn', code: 'budget-l0', key: 'tools', message: `the always-on L0 tools are ~${budget.l0Tokens} tokens, over the ${L0_BUDGET_TOKENS} budget` });
+    for (const layer of budget.overBudget)
+        diagnostics.push({ level: 'warn', code: 'budget-layer', key: layer.name, message: `browser_index layer "${layer.name}" is ~${layer.tokens} tokens, over the ${LAYER_BUDGET_TOKENS} per-layer budget` });
+    let body = 'packaged';
+    if (prompts.skill.bodyFile) {
+        const loaded = loadSkillBodyFile(prompts.skill.bodyFile);
+        if (loaded.ok)
+            body = 'file';
+        else
+            diagnostics.push({ level: 'warn', code: 'body-file', key: 'skill.bodyFile', message: `${loaded.reason}; the packaged skill body is used` });
+    }
+    return {
+        overrides: [...prompts.applied], diagnostics, budget,
+        skill: { enabled: prompts.skill.enabled, body, ...prompts.skill.bodyFile ? { bodyFile: prompts.skill.bodyFile } : {} },
+    };
+}
+//# sourceMappingURL=prompts.js.map

package/lib/prompts.js.map

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

package/lib/skill.d.ts

@@ -0,0 +1,100 @@
+/**
+ * The bundled `dsh-browser` skill: usage guidance for the browser tools.
+ *
+ * The skill is registered with the Host's skill registry when that service
+ * exists. It must never be a hard dependency of the plugin: Cordis 4.0.4 treats
+ * every declared `inject` as required, so a missing `skills` service would hang
+ * the whole plugin. The plugin therefore asks for it through a scoped
+ * `ctx.inject(['skills'], …)` and works the same without it.
+ * @module dsh-browser/skill
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { PromptsSource } from './prompts.ts';
+import { SKILL_BODY_FILE_LIMIT } from './prompt-limits.ts';
+export declare const SKILL_NAME = "dsh-browser";
+/** `assets/skills/dsh-browser/`, resolved next to `src/` or the built `lib/`. */
+export declare const SKILL_DIR: string;
+/** Parse `name` and `description` out of a SKILL.md and return the body without the front matter. */
+export declare function parseSkillFile(raw: string): {
+    name: string;
+    description: string;
+    body: string;
+};
+export declare function readSkill(dir?: string): {
+    name: string;
+    description: string;
+    body: string;
+};
+export { SKILL_BODY_FILE_LIMIT };
+/**
+ * Read a replacement skill body. A leading front matter block is dropped (the name and description come from the
+ * packaged file or `prompts.skill.description`). Never throws: a missing, unreadable, empty or oversized file is
+ * reported as a reason, and the caller falls back to the packaged body.
+ */
+export declare function loadSkillBodyFile(file: string): {
+    ok: true;
+    body: string;
+} | {
+    ok: false;
+    reason: string;
+};
+/** What the skill says right now: the packaged file with the `prompts.skill` overrides applied. */
+export declare function currentSkill(dir?: string, prompts?: PromptsSource): {
+    name: string;
+    description: string;
+    body: string;
+};
+/**
+ * A provider object shaped like the Host's `SkillProvider` (declared locally to avoid a build-time dependency).
+ * It reads the packaged file and the `prompts.skill` overrides on every call, so it is never stale.
+ */
+export declare function createSkillProvider(dir?: string, prompts?: PromptsSource): {
+    name: string;
+    list: () => Promise<{
+        name: string;
+        description: string;
+        invocation: {
+            modelInvocable: boolean;
+            userInvocable: boolean;
+        };
+        provider: string;
+        source: string;
+        resourceBase: {
+            kind: "directory";
+            path: string;
+        };
+        rank: number;
+        locator: string;
+    }[]>;
+    get: () => Promise<{
+        name: string;
+        description: string;
+        invocation: {
+            modelInvocable: boolean;
+            userInvocable: boolean;
+        };
+        provider: string;
+        source: string;
+        resourceBase: {
+            kind: "directory";
+            path: string;
+        };
+        content: string;
+    }>;
+};
+export interface SkillRegistration {
+    /** Whether the skill is registered with the Host right now (false without a skill service, or when disabled). */
+    isAvailable: () => boolean;
+    /**
+     * Bring the registration in line with the current `prompts.skill`: register or withdraw the provider when `enabled`
+     * changed, and tell the Host (`invalidate()`) when the description, body file or appended text changed. Cheap; the
+     * tools call it on every use, which is how a config edit reaches the skill without a restart.
+     */
+    refresh: () => void;
+}
+/**
+ * Register the skill when the Host provides a skill registry, and track whether
+ * it is registered so the index can fall back to its compact guide otherwise.
+ * With `prompts.skill.enabled=false` nothing is registered.
+ */
+export declare function registerSkillWhenAvailable(ctx: Context, dir?: string, prompts?: PromptsSource): SkillRegistration;