@e2edev/e2e 0.9.0 → 0.11.0

package/dist/explore/plan.d.ts

@@ -0,0 +1,74 @@
+/**
+ * The planner: between exploration steps, one structured model call decides
+ * the next charter or finishes the run. It runs as an `agent.extract` step,
+ * so it reads the current screen and the ledger of prior steps the same way
+ * every judgment does, under the same budgets and repair loop.
+ */
+import { z } from 'zod';
+import type { Agent } from '../types.ts';
+import { type ExploreState } from './state.ts';
+/**
+ * A flat object with every field required rather than a union: OpenAI's
+ * strict structured output rejects a schema whose `required` omits a
+ * property, and every provider renders a flat object. Fields the decision
+ * does not use are empty strings. The shape is lenient on purpose: a model
+ * that puts the whole charter into `title` and leaves `instruction` empty
+ * (seen live) has still planned a step, and `repairPlan` derives the missing
+ * field rather than spending the repair round on it.
+ */
+export declare const PLAN_SCHEMA: z.ZodObject<{
+    decision: z.ZodEnum<{
+        finish: "finish";
+        step: "step";
+    }>;
+    title: z.ZodString;
+    instruction: z.ZodString;
+    summary: z.ZodString;
+}, z.core.$strip>;
+type PlanAnswer = z.output<typeof PLAN_SCHEMA>;
+export type PlanDecision = {
+    readonly kind: 'step';
+    readonly title: string;
+    readonly instruction: string;
+} | {
+    readonly kind: 'finish';
+    readonly summary: string;
+};
+/** One configured credential the explorer can sign in with, by name; the password stays out of every prompt. */
+export interface PlanAccount {
+    readonly name: string;
+    readonly username: string;
+}
+export interface PlanRequest {
+    /** The run must end now; the planner is asked for the closing assessment only. */
+    readonly mustFinish: boolean;
+    /** The accounts the explorer can sign in with. */
+    readonly accounts?: readonly PlanAccount[] | undefined;
+    /** Why it must end, in the planner's prompt. */
+    readonly reason?: string | undefined;
+    readonly remainingMs: number;
+    readonly timeoutMs: number;
+}
+/** Asks the model for the next charter or the closing assessment. */
+export declare function planNext(agent: Agent, state: ExploreState, request: PlanRequest): Promise<PlanDecision>;
+/**
+ * The decision, after the repairs live providers' answers have needed. Every
+ * repair the planner makes is here:
+ *
+ * - Digit runs a provider pads a field with (seen live: a title followed by
+ *   hundreds of `1234567890`) are removed; they carry no meaning and would
+ *   otherwise become the charter's tail. The threshold sits past any number a
+ *   charter can mean: phone numbers, order ids, card numbers, and amounts all
+ *   stop short of twenty digits.
+ * - A step with only one of `title` and `instruction` filled has the other
+ *   derived: a charter with no title takes its first clause, a title with no
+ *   charter is the charter.
+ *
+ * Length is not repaired here: the grammar accepts long fields, and the state
+ * clips them to the report's ceilings when the step opens.
+ */
+export declare function repairPlan(answer: PlanAnswer): PlanDecision;
+/** The planner's instruction: the goal, the record so far, the budget, and how to decide. */
+export declare function planInstruction(state: ExploreState, request: PlanRequest): string;
+export {};
+//# sourceMappingURL=plan.d.ts.map

package/dist/explore/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/explore/plan.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAahE;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW;;;;;;;;iBAepB,CAAC;AAEL,KAAK,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,WAAW,CAAC,CAAC;AAE/C,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC/E;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,gHAAgH;AAChH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,kFAAkF;IAClF,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,WAAW,EAAE,GAAG,SAAS,CAAC;IACvD,gDAAgD;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,qEAAqE;AACrE,wBAAsB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAE7G;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,YAAY,CAS3D;AAmBD,6FAA6F;AAC7F,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,CA2DjF"}

package/dist/explore/plan.js

@@ -0,0 +1,149 @@
+/**
+ * The planner: between exploration steps, one structured model call decides
+ * the next charter or finishes the run. It runs as an `agent.extract` step,
+ * so it reads the current screen and the ledger of prior steps the same way
+ * every judgment does, under the same budgets and repair loop.
+ */
+import { z } from 'zod';
+import { MAX_TITLE_CHARS } from './state.js';
+const MIN_SUMMARY_CHARS = 10;
+/** A title derived from an instruction stops at the first clause or here. */
+const DERIVED_TITLE_CHARS = 80;
+/**
+ * The most the grammar accepts in one field. Well above the report's ceilings,
+ * which the state clips to when the step opens: a model that pours a whole
+ * charter into one field (seen live, past 2000 characters) has still planned
+ * a step, and a rejection would cost a repair round for nothing.
+ */
+const MAX_FIELD_CHARS = 8_000;
+/**
+ * A flat object with every field required rather than a union: OpenAI's
+ * strict structured output rejects a schema whose `required` omits a
+ * property, and every provider renders a flat object. Fields the decision
+ * does not use are empty strings. The shape is lenient on purpose: a model
+ * that puts the whole charter into `title` and leaves `instruction` empty
+ * (seen live) has still planned a step, and `repairPlan` derives the missing
+ * field rather than spending the repair round on it.
+ */
+export const PLAN_SCHEMA = z
+    .object({
+    decision: z.enum(['step', 'finish']),
+    title: z.string().max(MAX_FIELD_CHARS).describe('For a step: the area or flow in a few words. Empty for finish.'),
+    instruction: z.string().max(MAX_FIELD_CHARS).describe('For a step: the concrete charter. Empty for finish.'),
+    summary: z.string().max(MAX_FIELD_CHARS).describe('For finish: the overall assessment. Empty for a step.'),
+})
+    .superRefine((value, context) => {
+    if (value.decision === 'step') {
+        if (`${value.title}${value.instruction}`.trim() === '') {
+            context.addIssue({ code: 'custom', path: ['instruction'], message: 'a step needs a concrete instruction' });
+        }
+    }
+    else if (value.summary.trim().length < MIN_SUMMARY_CHARS) {
+        context.addIssue({ code: 'custom', path: ['summary'], message: 'finishing needs an overall assessment' });
+    }
+});
+/** Asks the model for the next charter or the closing assessment. */
+export async function planNext(agent, state, request) {
+    return repairPlan(await agent.extract(planInstruction(state, request), { schema: PLAN_SCHEMA, timeout: request.timeoutMs }));
+}
+/**
+ * The decision, after the repairs live providers' answers have needed. Every
+ * repair the planner makes is here:
+ *
+ * - Digit runs a provider pads a field with (seen live: a title followed by
+ *   hundreds of `1234567890`) are removed; they carry no meaning and would
+ *   otherwise become the charter's tail. The threshold sits past any number a
+ *   charter can mean: phone numbers, order ids, card numbers, and amounts all
+ *   stop short of twenty digits.
+ * - A step with only one of `title` and `instruction` filled has the other
+ *   derived: a charter with no title takes its first clause, a title with no
+ *   charter is the charter.
+ *
+ * Length is not repaired here: the grammar accepts long fields, and the state
+ * clips them to the report's ceilings when the step opens.
+ */
+export function repairPlan(answer) {
+    if (answer.decision === 'finish')
+        return { kind: 'finish', summary: unpad(answer.summary) };
+    const title = unpad(answer.title);
+    const instruction = unpad(answer.instruction);
+    const charter = instruction === '' ? title : instruction;
+    // A title that stood in for the charter is a heading only while it is short.
+    const longest = instruction === '' ? DERIVED_TITLE_CHARS : MAX_TITLE_CHARS;
+    const heading = title !== '' && title.length <= longest ? title : deriveTitle(charter);
+    return { kind: 'step', title: heading, instruction: charter };
+}
+function unpad(text) {
+    return text.replace(/\s*\d{20,}\s*/g, ' ').trim();
+}
+function deriveTitle(charter) {
+    const clause = charter.split(/[.:;\n]/, 1)[0].trim();
+    const short = clause === '' ? charter : clause;
+    return short.length <= DERIVED_TITLE_CHARS ? short : `${short.slice(0, DERIVED_TITLE_CHARS - 1)}…`;
+}
+const STATUS_MARKS = {
+    passed: 'passed',
+    failed: 'FAILED',
+    blocked: 'blocked',
+    exhausted: 'ended at its limit',
+};
+/** The planner's instruction: the goal, the record so far, the budget, and how to decide. */
+export function planInstruction(state, request) {
+    const used = state.steps.length;
+    const minutesLeft = Math.max(0, Math.round(request.remainingMs / 60_000));
+    const steps = used === 0
+        ? '(none yet: this is the first step)'
+        : state.steps
+            .map((step) => `${step.index}. [${STATUS_MARKS[step.status]}] ${step.title}${step.summary === undefined ? '' : ` — ${step.summary}`}`)
+            .join('\n');
+    const findings = state.findings.length === 0
+        ? '(none yet)'
+        : state.findings.map((finding) => `- [${finding.kind}, severity ${finding.severity}] ${finding.title}`).join('\n');
+    const header = [
+        request.mustFinish
+            ? 'Finish an exploratory test run with your overall assessment.'
+            : 'Plan the next step of an exploratory test run, or finish it.',
+        '',
+        `Goal: ${state.goal}`,
+        `Budget: ${used} of ${state.budgets.maxSteps} steps used, about ${minutesLeft} minute(s) left.`,
+        '',
+        'Steps so far:',
+        steps,
+        '',
+        'Findings so far:',
+        findings,
+        ...(request.accounts === undefined || request.accounts.length === 0
+            ? []
+            : [
+                '',
+                'Accounts the agent can sign in with (it fills the password itself, by name):',
+                ...request.accounts.map((account) => `- ${account.name} (username: ${account.username})`),
+            ]),
+        '',
+    ];
+    if (request.mustFinish) {
+        return [
+            ...header,
+            `The run must end now: ${request.reason ?? 'its budget is spent'}.`,
+            'Respond with {"decision": "finish", "title": "", "instruction": "", "summary": "..."}: the overall assessment in two to five sentences,',
+            'what was explored, the key findings, and your verdict on the goal. Ground it in the steps and findings above.',
+        ].join('\n');
+    }
+    return [
+        ...header,
+        'Decide from the goal, the steps so far, and the current screen:',
+        '- "step": the next exploration charter. "title" names the area or flow in a few words. "instruction" is a concrete,',
+        '  self-contained charter for an agent that sees only the screen and that text: which flow to exercise, what inputs',
+        '  to try, what to check. One flow or screen per step, sized for five to fifteen actions; split anything bigger.',
+        '  Ask the agent to interact, not only to look: submit forms with made-up test data, save and revisit, sign in with',
+        '  the accounts listed above (or made-up credentials when none are configured), act on a non-first item of a list. Prefer breadth: touch the main',
+        '  flows the goal names before drilling deeper into one. Do not re-test an area a passed step already covered, and',
+        '  never plan a step to re-confirm a finding already recorded above. When a step ended at its limit, continue where',
+        '  it stopped or move on. When a step summary mentions something odd that is not among the findings, spend the next',
+        '  step confirming it.',
+        '- "finish": the goal is covered, or nothing new is reachable. "summary" is the overall assessment in two to',
+        '  five sentences: what was explored, the key findings, and your verdict on the goal.',
+        'Respond with every field present: {"decision": "step", "title": "...", "instruction": "...", "summary": ""} or {"decision": "finish", "title": "", "instruction": "", "summary": "..."}.',
+    ].join('\n');
+}
+//# sourceMappingURL=plan.js.map

package/dist/explore/plan.js.map

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

package/dist/explore/reporter.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The exploration summary under the run summary: a `Reporter` whose
+ * `onRunFinished` rows the list reporter prints, so the findings appear where
+ * a reporter's own rows do, and the JSON reporter is left to the report.
+ */
+import type { Reporter, ReporterSummary } from '../types.ts';
+import type { ExploreState } from './state.ts';
+export declare function exploreReporter(state: ExploreState): Reporter;
+/** The rows: what was explored, what was found, one row per finding, and the assessment. */
+export declare function summaryRows(state: ExploreState): ReporterSummary;
+//# sourceMappingURL=reporter.d.ts.map

package/dist/explore/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../src/explore/reporter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,QAAQ,CAK7D;AAED,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,eAAe,CAgChE"}

package/dist/explore/reporter.js

@@ -0,0 +1,54 @@
+/**
+ * The exploration summary under the run summary: a `Reporter` whose
+ * `onRunFinished` rows the list reporter prints, so the findings appear where
+ * a reporter's own rows do, and the JSON reporter is left to the report.
+ */
+export function exploreReporter(state) {
+    return {
+        name: 'explore',
+        onRunFinished: async () => summaryRows(state),
+    };
+}
+/** The rows: what was explored, what was found, one row per finding, and the assessment. */
+export function summaryRows(state) {
+    const counts = { passed: 0, failed: 0, blocked: 0, exhausted: 0 };
+    for (const step of state.steps)
+        counts[step.status] += 1;
+    const parts = [
+        `${counts.passed} passed`,
+        ...(counts.failed > 0 ? [`${counts.failed} failed`] : []),
+        ...(counts.exhausted > 0 ? [`${counts.exhausted} ended at their limit`] : []),
+        ...(counts.blocked > 0 ? [`${counts.blocked} blocked`] : []),
+    ];
+    const issues = state.issues.length;
+    const warnings = state.findings.length - issues;
+    const rows = [
+        {
+            label: 'Explored',
+            text: `${state.steps.length} step${state.steps.length === 1 ? '' : 's'} (${parts.join(', ')}); ended: ${ENDED_TEXT[state.ended]}`,
+        },
+        {
+            label: 'Findings',
+            text: state.findings.length === 0
+                ? 'none'
+                : `${issues} issue${issues === 1 ? '' : 's'}, ${warnings} warning${warnings === 1 ? '' : 's'}`,
+        },
+    ];
+    for (const finding of [...state.findings].toSorted((a, b) => b.severity - a.severity || a.index - b.index)) {
+        rows.push({
+            label: `  S${finding.severity} ${finding.kind}`,
+            text: `${finding.title}${finding.path === undefined ? '' : ` (${finding.path})`}`,
+        });
+    }
+    if (state.summary !== undefined)
+        rows.push({ label: 'Assessment', text: state.summary });
+    return rows;
+}
+const ENDED_TEXT = {
+    finished: 'the agent covered the goal',
+    'step-limit': 'the step limit was reached',
+    time: 'the time budget ran out',
+    stuck: 'steps kept failing',
+    aborted: 'the run was cut short',
+};
+//# sourceMappingURL=reporter.js.map

package/dist/explore/reporter.js.map

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

package/dist/explore/state.d.ts

@@ -0,0 +1,58 @@
+/**
+ * The record of one exploration: the goal, its budgets, the steps the agent
+ * planned and ran, and the findings it reported. One instance is shared by
+ * the planner, the explorer's finding tool, the exploration body, and the
+ * summary reporter, and its snapshot becomes `run.explore` in the report.
+ * The state is the report boundary: every free text is bounded to the
+ * schema's ceilings here, and nowhere else.
+ */
+import type { ReportExplore, ReportExploreFinding, ReportExploreStep } from '../report/build.ts';
+export interface ExploreBudgets {
+    readonly maxSteps: number;
+    readonly timeoutMs: number;
+}
+/** A finding as the tool reports it; the state assigns identity, position, and time. */
+export type FindingInput = Omit<ReportExploreFinding, 'id' | 'index' | 'step' | 'reportedAt' | 'artifactId'>;
+/** A step as opened: title and charter bounded to the report's ceilings, which is what the step runs with. */
+export type OpenedStep = Pick<ReportExploreStep, 'index' | 'title' | 'instruction'>;
+/** Ceilings mirroring `schema/report-v1.schema.json` `explore`. */
+export declare const MAX_TITLE_CHARS = 200;
+export declare class ExploreState {
+    #private;
+    readonly goal: string;
+    readonly budgets: ExploreBudgets;
+    private readonly now;
+    readonly steps: ReportExploreStep[];
+    readonly findings: ReportExploreFinding[];
+    constructor(goal: string, budgets: ExploreBudgets, now?: () => number);
+    /** Why exploration stopped; `aborted` until `end` says otherwise. */
+    get ended(): ReportExplore['ended'];
+    /** The agent's closing assessment, once it gave one. */
+    get summary(): string | undefined;
+    /** Opens the next step; the index is one-based. */
+    beginStep(title: string, instruction: string): OpenedStep;
+    /** Closes the open step with its outcome. */
+    endStep(status: ReportExploreStep['status'], summary?: string, errorCode?: string): ReportExploreStep;
+    /** Records one finding against the step in progress. */
+    addFinding(input: FindingInput): ReportExploreFinding;
+    /** Attaches the evidence screenshot kept for a finding, by its artifact id. */
+    attachEvidence(id: string, artifactId: string): void;
+    /** Closes the record: why exploration stopped and, when the agent gave one, its closing assessment. */
+    end(ended: ReportExplore['ended'], summary?: string): void;
+    get issues(): readonly ReportExploreFinding[];
+    /**
+     * How many steps in a row made no progress, newest first: failed or blocked
+     * without recording a finding. A failed step that reported a defect did its
+     * job, and a step that ended at its budget is a time-boxed charter, not a
+     * failure; neither breaks the streak nor adds to it.
+     */
+    consecutiveFailures(): number;
+    snapshot(): ReportExplore;
+}
+/**
+ * Trims and bounds free text so the report stays inside the schema's
+ * ceilings. Counted in code points, as the schema counts, so a cut never
+ * splits a surrogate pair.
+ */
+export declare function clip(text: string, max: number): string;
+//# sourceMappingURL=state.d.ts.map

package/dist/explore/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/explore/state.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEjG,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,wFAAwF;AACxF,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,OAAO,GAAG,MAAM,GAAG,YAAY,GAAG,YAAY,CAAC,CAAC;AAE7G,8GAA8G;AAC9G,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,iBAAiB,EAAE,OAAO,GAAG,OAAO,GAAG,aAAa,CAAC,CAAC;AAEpF,mEAAmE;AACnE,eAAO,MAAM,eAAe,MAAM,CAAC;AAanC,qBAAa,YAAY;;IAQrB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,OAAO,EAAE,cAAc;IAChC,OAAO,CAAC,QAAQ,CAAC,GAAG;IATtB,QAAQ,CAAC,KAAK,EAAE,iBAAiB,EAAE,CAAM;IACzC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,EAAE,CAAM;IAK/C,YACW,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,EACf,GAAG,GAAE,MAAM,MAAiB,EAC3C;IAEJ,qEAAqE;IACrE,IAAI,KAAK,IAAI,aAAa,CAAC,OAAO,CAAC,CAElC;IAED,wDAAwD;IACxD,IAAI,OAAO,IAAI,MAAM,GAAG,SAAS,CAEhC;IAED,mDAAmD;IACnD,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,UAAU,CAWxD;IAED,6CAA6C;IAC7C,OAAO,CAAC,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAgBpG;IAED,wDAAwD;IACxD,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,oBAAoB,CAiBpD;IAED,+EAA+E;IAC/E,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAInD;IAED,uGAAuG;IACvG,GAAG,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAGzD;IAED,IAAI,MAAM,IAAI,SAAS,oBAAoB,EAAE,CAE5C;IAED;;;;;OAKG;IACH,mBAAmB,IAAI,MAAM,CAU5B;IAED,QAAQ,IAAI,aAAa,CASxB;CACF;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAItD"}

package/dist/explore/state.js

@@ -0,0 +1,147 @@
+/**
+ * The record of one exploration: the goal, its budgets, the steps the agent
+ * planned and ran, and the findings it reported. One instance is shared by
+ * the planner, the explorer's finding tool, the exploration body, and the
+ * summary reporter, and its snapshot becomes `run.explore` in the report.
+ * The state is the report boundary: every free text is bounded to the
+ * schema's ceilings here, and nowhere else.
+ */
+import { timestamp, uuidv7 } from '../internal/ids.js';
+/** Ceilings mirroring `schema/report-v1.schema.json` `explore`. */
+export const MAX_TITLE_CHARS = 200;
+const MAX_INSTRUCTION_CHARS = 2_000;
+const MAX_SUMMARY_CHARS = 4_000;
+const MAX_DETAIL_CHARS = 2_000;
+const MAX_REPRODUCTION_STEPS = 20;
+const MAX_REPRODUCTION_CHARS = 500;
+const MAX_PATH_CHARS = 2_048;
+export class ExploreState {
+    goal;
+    budgets;
+    now;
+    steps = [];
+    findings = [];
+    #ended = 'aborted';
+    #summary;
+    #open;
+    constructor(goal, budgets, now = Date.now) {
+        this.goal = goal;
+        this.budgets = budgets;
+        this.now = now;
+    }
+    /** Why exploration stopped; `aborted` until `end` says otherwise. */
+    get ended() {
+        return this.#ended;
+    }
+    /** The agent's closing assessment, once it gave one. */
+    get summary() {
+        return this.#summary;
+    }
+    /** Opens the next step; the index is one-based. */
+    beginStep(title, instruction) {
+        if (this.#open !== undefined)
+            throw new Error(`exploration step ${this.#open.index} is still open`);
+        this.#open = {
+            index: this.steps.length + 1,
+            title: clip(title, MAX_TITLE_CHARS),
+            instruction: clip(instruction, MAX_INSTRUCTION_CHARS),
+            startedAt: timestamp(new Date(this.now())),
+            startedMs: this.now(),
+        };
+        const { index, title: heading, instruction: charter } = this.#open;
+        return { index, title: heading, instruction: charter };
+    }
+    /** Closes the open step with its outcome. */
+    endStep(status, summary, errorCode) {
+        const open = this.#open;
+        if (open === undefined)
+            throw new Error('no exploration step is open');
+        this.#open = undefined;
+        const step = {
+            index: open.index,
+            title: open.title,
+            instruction: open.instruction,
+            status,
+            ...(summary === undefined || summary === '' ? {} : { summary: clip(summary, MAX_SUMMARY_CHARS) }),
+            ...(errorCode === undefined ? {} : { errorCode }),
+            startedAt: open.startedAt,
+            durationMs: Math.max(0, this.now() - open.startedMs),
+        };
+        this.steps.push(step);
+        return step;
+    }
+    /** Records one finding against the step in progress. */
+    addFinding(input) {
+        const finding = {
+            id: uuidv7(this.now()),
+            index: this.findings.length,
+            ...(this.#open === undefined ? {} : { step: this.#open.index }),
+            kind: input.kind,
+            severity: input.severity,
+            title: clip(input.title, MAX_TITLE_CHARS),
+            expected: clip(input.expected, MAX_DETAIL_CHARS),
+            actual: clip(input.actual, MAX_DETAIL_CHARS),
+            reproduction: input.reproduction.slice(0, MAX_REPRODUCTION_STEPS).map((entry) => clip(entry, MAX_REPRODUCTION_CHARS)),
+            ...(input.path === undefined ? {} : { path: clip(input.path, MAX_PATH_CHARS) }),
+            ...(input.observationRevision === undefined ? {} : { observationRevision: input.observationRevision }),
+            reportedAt: timestamp(new Date(this.now())),
+        };
+        this.findings.push(finding);
+        return finding;
+    }
+    /** Attaches the evidence screenshot kept for a finding, by its artifact id. */
+    attachEvidence(id, artifactId) {
+        const index = this.findings.findIndex((finding) => finding.id === id);
+        if (index === -1)
+            return;
+        this.findings[index] = { ...this.findings[index], artifactId };
+    }
+    /** Closes the record: why exploration stopped and, when the agent gave one, its closing assessment. */
+    end(ended, summary) {
+        this.#ended = ended;
+        this.#summary = summary === undefined || summary.trim() === '' ? undefined : clip(summary, MAX_SUMMARY_CHARS);
+    }
+    get issues() {
+        return this.findings.filter((finding) => finding.kind === 'issue');
+    }
+    /**
+     * How many steps in a row made no progress, newest first: failed or blocked
+     * without recording a finding. A failed step that reported a defect did its
+     * job, and a step that ended at its budget is a time-boxed charter, not a
+     * failure; neither breaks the streak nor adds to it.
+     */
+    consecutiveFailures() {
+        const productive = new Set(this.findings.map((finding) => finding.step));
+        let count = 0;
+        for (let index = this.steps.length - 1; index >= 0; index -= 1) {
+            const step = this.steps[index];
+            if (step.status === 'passed')
+                break;
+            if (step.status === 'exhausted' || productive.has(step.index))
+                continue;
+            count += 1;
+        }
+        return count;
+    }
+    snapshot() {
+        return {
+            goal: this.goal,
+            budgets: { maxSteps: this.budgets.maxSteps, timeoutMs: this.budgets.timeoutMs },
+            ended: this.#ended,
+            ...(this.#summary === undefined ? {} : { summary: this.#summary }),
+            steps: [...this.steps],
+            findings: [...this.findings],
+        };
+    }
+}
+/**
+ * Trims and bounds free text so the report stays inside the schema's
+ * ceilings. Counted in code points, as the schema counts, so a cut never
+ * splits a surrogate pair.
+ */
+export function clip(text, max) {
+    const trimmed = text.trim();
+    const points = Array.from(trimmed);
+    return points.length <= max ? trimmed : `${points.slice(0, max - 1).join('')}…`;
+}
+//# sourceMappingURL=state.js.map

package/dist/explore/state.js.map

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

package/dist/internal/atomic-write.d.ts

@@ -11,7 +11,7 @@ export interface AtomicWriteOptions {
     readonly mode?: number;
 }
 /** Writes `content` to `filePath` atomically; a failed write leaves no temporary file behind. */
-export declare function writeFileAtomic(filePath: string, content: string, options?: AtomicWriteOptions): Promise<void>;
+export declare function writeFileAtomic(filePath: string, content: string | Uint8Array, options?: AtomicWriteOptions): Promise<void>;
 /** The synchronous twin, for a store that is read and written from synchronous code. */
 export declare function writeFileAtomicSync(filePath: string, content: string, options?: AtomicWriteOptions): void;
 //# sourceMappingURL=atomic-write.d.ts.map

package/dist/internal/atomic-write.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"atomic-write.d.ts","sourceRoot":"","sources":["../../src/internal/atomic-write.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,kBAAkB;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD,iGAAiG;AACjG,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,IAAI,CAa7G"}
+{"version":3,"file":"atomic-write.d.ts","sourceRoot":"","sources":["../../src/internal/atomic-write.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,kBAAkB;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD,iGAAiG;AACjG,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,UAAU,EAC5B,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,IAAI,CAa7G"}

package/dist/internal/atomic-write.js.map

@@ -1 +1 @@
-{"version":3,"file":"atomic-write.js","sourceRoot":"","sources":["../../src/internal/atomic-write.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAO7D,SAAS,aAAa,CAAC,QAAgB;IACrC,OAAO,GAAG,QAAQ,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;AAC7D,CAAC;AAED,iGAAiG;AACjG,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,OAAe,EACf,OAAO,GAAuB,EAAE;IAEhC,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9E,MAAM,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,OAAe,EAAE,OAAO,GAAuB,EAAE;IACrG,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,CAAC;QACH,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5E,UAAU,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC;YACH,UAAU,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,+DAA+D;QACjE,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"atomic-write.js","sourceRoot":"","sources":["../../src/internal/atomic-write.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAO7D,SAAS,aAAa,CAAC,QAAgB;IACrC,OAAO,GAAG,QAAQ,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;AAC7D,CAAC;AAED,iGAAiG;AACjG,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,OAA4B,EAC5B,OAAO,GAAuB,EAAE;IAEhC,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9E,MAAM,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,OAAe,EAAE,OAAO,GAAuB,EAAE;IACrG,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,CAAC;QACH,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC5E,UAAU,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC;YACH,UAAU,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,+DAA+D;QACjE,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/internal/package-version.d.ts

@@ -3,4 +3,6 @@
  * caller's module URL, falling back when the package cannot be resolved.
  */
 export declare function packageVersion(fromUrl: string, specifier: string, fallback: string): string;
+/** Reads a JSON file through require resolution relative to the caller's module URL, or undefined when absent. */
+export declare function readJson(fromUrl: string, specifier: string): unknown;
 //# sourceMappingURL=package-version.d.ts.map

package/dist/internal/package-version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package-version.d.ts","sourceRoot":"","sources":["../../src/internal/package-version.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM3F"}
+{"version":3,"file":"package-version.d.ts","sourceRoot":"","sources":["../../src/internal/package-version.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM3F;AAED,kHAAkH;AAClH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAMpE"}

package/dist/internal/package-version.js

@@ -11,4 +11,13 @@ export function packageVersion(fromUrl, specifier, fallback) {
         return fallback;
     }
 }
+/** Reads a JSON file through require resolution relative to the caller's module URL, or undefined when absent. */
+export function readJson(fromUrl, specifier) {
+    try {
+        return createRequire(fromUrl)(specifier);
+    }
+    catch {
+        return undefined;
+    }
+}
 //# sourceMappingURL=package-version.js.map

package/dist/internal/package-version.js.map

@@ -1 +1 @@
-{"version":3,"file":"package-version.js","sourceRoot":"","sources":["../../src/internal/package-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,SAAiB,EAAE,QAAgB;IACjF,IAAI,CAAC;QACH,OAAQ,aAAa,CAAC,OAAO,CAAC,CAAC,SAAS,CAAyB,CAAC,OAAO,CAAC;IAC5E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC"}
+{"version":3,"file":"package-version.js","sourceRoot":"","sources":["../../src/internal/package-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,SAAiB,EAAE,QAAgB;IACjF,IAAI,CAAC;QACH,OAAQ,aAAa,CAAC,OAAO,CAAC,CAAC,SAAS,CAAyB,CAAC,OAAO,CAAC;IAC5E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC;AAED,kHAAkH;AAClH,MAAM,UAAU,QAAQ,CAAC,OAAe,EAAE,SAAiB;IACzD,IAAI,CAAC;QACH,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC,SAAS,CAAY,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/internal/redact.d.ts

@@ -1,9 +1,10 @@
 /** Runner-side secret redaction. */
 /**
- * Builds a redactor replacing every exact registered secret value with its
- * stable secret name.
+ * Builds a redactor replacing every registered secret value, in each form the
+ * value takes in text the runner writes or rewrites, with its stable secret
+ * name.
  *
- * Longer values are substituted first, so a secret that contains another secret
+ * Longer forms are substituted first, so a secret that contains another secret
  * is not left half-rewritten.
  */
 export declare function createRedactor(secrets: Iterable<readonly [string, string]>): (text: string) => string;
@@ -23,11 +24,18 @@ export declare class SecretLedger {
      * captures, and an earlier value that stopped redacting would leak there.
      */
     private readonly values;
-    private redactor;
+    private compiled;
     constructor(initial?: Iterable<readonly [string, string]>);
     /** Registers one resolved value; earlier values for the name keep redacting. */
     register(name: string, value: string): void;
     /** Bound so it can be handed out as a plain function. */
     readonly redact: (text: string) => string;
+    /**
+     * Whether any registered value, in any of its forms, occurs in `bytes`.
+     * The check for content that is not text and so cannot be rewritten: what
+     * holds a secret has to be withheld instead.
+     */
+    appearsIn(bytes: Uint8Array): boolean;
+    private compile;
 }
 //# sourceMappingURL=redact.d.ts.map