@aperant/framework 0.8.4 → 0.8.6

package/dist/driver-sdk/errors.d.ts

@@ -0,0 +1,75 @@
+/**
+ * errors.ts — error taxonomy for @aperant/driver-sdk.
+ *
+ * Every driver-layer failure raises one of these classes. The taxonomy
+ * is load-bearing for the resolver + audit log + verification.json's
+ * `meta.fallback_attempts[].reason` field.
+ *
+ * Conventions:
+ *   - Every class sets `.name` to its class identifier so structured
+ *     audit lines can serialize the discriminator without `instanceof`
+ *     gymnastics in cross-realm contexts.
+ *   - Every class extends Error so plain Node consumers can match with
+ *     try/catch.
+ */
+/** A driver manifest violates the structural contract (JSON-Schema). */
+export declare class DriverManifestSchemaError extends Error {
+    readonly name = "DriverManifestSchemaError";
+    /** JSON-pointer paths into the manifest where validation failed. */
+    readonly errors: ReadonlyArray<{
+        path: string;
+        message: string;
+    }>;
+    constructor(message: string, errors?: ReadonlyArray<{
+        path: string;
+        message: string;
+    }>);
+}
+/** A driver's runtime configuration is invalid (missing env, malformed args). */
+export declare class DriverConfigError extends Error {
+    readonly name = "DriverConfigError";
+}
+/** A driver's preflight check failed (missing binary, unreachable service). */
+export declare class DriverPreflightError extends Error {
+    readonly name = "DriverPreflightError";
+    /** Structured list of unsatisfied preflight requirements. */
+    readonly missing: readonly string[];
+    constructor(message: string, missing?: readonly string[]);
+}
+/** A driver verb invocation failed at the transport / RPC layer. */
+export declare class DriverInvocationError extends Error {
+    readonly name = "DriverInvocationError";
+    /** The IDL verb name that was being invoked. */
+    readonly verb: string | undefined;
+    constructor(message: string, verb?: string);
+}
+/** A driver succeeded but evidence capture (screenshot, dom_dump) failed. */
+export declare class DriverEvidenceCaptureError extends Error {
+    readonly name = "DriverEvidenceCaptureError";
+}
+/** A non-first-party driver invocation is blocked by TOFU + policy. */
+export declare class DriverNotApprovedError extends Error {
+    readonly name = "DriverNotApprovedError";
+    readonly driverId: string | undefined;
+    readonly trustTier: string | undefined;
+    constructor(message: string, driverId?: string, trustTier?: string);
+}
+/**
+ * The resolver exhausted its driver chain without satisfying a REQUIRED
+ * capability. Fail-closed — verdict logic must NOT silently turn this
+ * into a `blocked_by_platform` skip (ID-02).
+ */
+export declare class UnsatisfiedRequiredCapabilityError extends Error {
+    readonly name = "UnsatisfiedRequiredCapabilityError";
+    readonly capability: string | undefined;
+    /** Drivers attempted, with the reason each was rejected. */
+    readonly attempts: ReadonlyArray<{
+        driver_id: string;
+        reason: string;
+    }>;
+    constructor(message: string, capability?: string, attempts?: ReadonlyArray<{
+        driver_id: string;
+        reason: string;
+    }>);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/driver-sdk/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/driver-sdk/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,wEAAwE;AACxE,qBAAa,yBAA0B,SAAQ,KAAK;IACnD,SAAkB,IAAI,+BAA8B;IACpD,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;gBACrD,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAM;CAI1F;AAED,iFAAiF;AACjF,qBAAa,iBAAkB,SAAQ,KAAK;IAC3C,SAAkB,IAAI,uBAAsB;CAC5C;AAED,+EAA+E;AAC/E,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,SAAkB,IAAI,0BAAyB;IAC/C,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;gBACvB,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,SAAS,MAAM,EAAO;CAI5D;AAED,oEAAoE;AACpE,qBAAa,qBAAsB,SAAQ,KAAK;IAC/C,SAAkB,IAAI,2BAA0B;IAChD,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;gBACrB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAI1C;AAED,6EAA6E;AAC7E,qBAAa,0BAA2B,SAAQ,KAAK;IACpD,SAAkB,IAAI,gCAA+B;CACrD;AAED,uEAAuE;AACvE,qBAAa,sBAAuB,SAAQ,KAAK;IAChD,SAAkB,IAAI,4BAA2B;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;gBAC1B,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAKlE;AAED;;;;GAIG;AACH,qBAAa,kCAAmC,SAAQ,KAAK;IAC5D,SAAkB,IAAI,wCAAuC;IAC7D,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;IACvC,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;gBAEtE,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,QAAQ,GAAE,aAAa,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAM;CAMpE"}

package/dist/driver-sdk/errors.js

@@ -0,0 +1,80 @@
+/**
+ * errors.ts — error taxonomy for @aperant/driver-sdk.
+ *
+ * Every driver-layer failure raises one of these classes. The taxonomy
+ * is load-bearing for the resolver + audit log + verification.json's
+ * `meta.fallback_attempts[].reason` field.
+ *
+ * Conventions:
+ *   - Every class sets `.name` to its class identifier so structured
+ *     audit lines can serialize the discriminator without `instanceof`
+ *     gymnastics in cross-realm contexts.
+ *   - Every class extends Error so plain Node consumers can match with
+ *     try/catch.
+ */
+/** A driver manifest violates the structural contract (JSON-Schema). */
+export class DriverManifestSchemaError extends Error {
+    name = 'DriverManifestSchemaError';
+    /** JSON-pointer paths into the manifest where validation failed. */
+    errors;
+    constructor(message, errors = []) {
+        super(message);
+        this.errors = errors;
+    }
+}
+/** A driver's runtime configuration is invalid (missing env, malformed args). */
+export class DriverConfigError extends Error {
+    name = 'DriverConfigError';
+}
+/** A driver's preflight check failed (missing binary, unreachable service). */
+export class DriverPreflightError extends Error {
+    name = 'DriverPreflightError';
+    /** Structured list of unsatisfied preflight requirements. */
+    missing;
+    constructor(message, missing = []) {
+        super(message);
+        this.missing = missing;
+    }
+}
+/** A driver verb invocation failed at the transport / RPC layer. */
+export class DriverInvocationError extends Error {
+    name = 'DriverInvocationError';
+    /** The IDL verb name that was being invoked. */
+    verb;
+    constructor(message, verb) {
+        super(message);
+        this.verb = verb;
+    }
+}
+/** A driver succeeded but evidence capture (screenshot, dom_dump) failed. */
+export class DriverEvidenceCaptureError extends Error {
+    name = 'DriverEvidenceCaptureError';
+}
+/** A non-first-party driver invocation is blocked by TOFU + policy. */
+export class DriverNotApprovedError extends Error {
+    name = 'DriverNotApprovedError';
+    driverId;
+    trustTier;
+    constructor(message, driverId, trustTier) {
+        super(message);
+        this.driverId = driverId;
+        this.trustTier = trustTier;
+    }
+}
+/**
+ * The resolver exhausted its driver chain without satisfying a REQUIRED
+ * capability. Fail-closed — verdict logic must NOT silently turn this
+ * into a `blocked_by_platform` skip (ID-02).
+ */
+export class UnsatisfiedRequiredCapabilityError extends Error {
+    name = 'UnsatisfiedRequiredCapabilityError';
+    capability;
+    /** Drivers attempted, with the reason each was rejected. */
+    attempts;
+    constructor(message, capability, attempts = []) {
+        super(message);
+        this.capability = capability;
+        this.attempts = attempts;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/driver-sdk/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/driver-sdk/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,wEAAwE;AACxE,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IACjC,IAAI,GAAG,2BAA2B,CAAA;IACpD,oEAAoE;IAC3D,MAAM,CAAkD;IACjE,YAAY,OAAe,EAAE,SAA2D,EAAE;QACzF,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACrB,CAAC;CACD;AAED,iFAAiF;AACjF,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACzB,IAAI,GAAG,mBAAmB,CAAA;CAC5C;AAED,+EAA+E;AAC/E,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC5B,IAAI,GAAG,sBAAsB,CAAA;IAC/C,6DAA6D;IACpD,OAAO,CAAmB;IACnC,YAAY,OAAe,EAAE,UAA6B,EAAE;QAC3D,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACvB,CAAC;CACD;AAED,oEAAoE;AACpE,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC7B,IAAI,GAAG,uBAAuB,CAAA;IAChD,gDAAgD;IACvC,IAAI,CAAoB;IACjC,YAAY,OAAe,EAAE,IAAa;QACzC,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IACjB,CAAC;CACD;AAED,6EAA6E;AAC7E,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IAClC,IAAI,GAAG,4BAA4B,CAAA;CACrD;AAED,uEAAuE;AACvE,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC9B,IAAI,GAAG,wBAAwB,CAAA;IACxC,QAAQ,CAAoB;IAC5B,SAAS,CAAoB;IACtC,YAAY,OAAe,EAAE,QAAiB,EAAE,SAAkB;QACjE,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC3B,CAAC;CACD;AAED;;;;GAIG;AACH,MAAM,OAAO,kCAAmC,SAAQ,KAAK;IAC1C,IAAI,GAAG,oCAAoC,CAAA;IACpD,UAAU,CAAoB;IACvC,4DAA4D;IACnD,QAAQ,CAAsD;IACvE,YACC,OAAe,EACf,UAAmB,EACnB,WAAiE,EAAE;QAEnE,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;QAC5B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;IACzB,CAAC;CACD"}

package/dist/driver-sdk/idl.d.ts

@@ -0,0 +1,221 @@
+/**
+ * idl.ts — verify-proof IDL v1 verb definitions + arg/return shapes.
+ *
+ * Wire contract per ID-01: workflow prose, the resolver, verification.json,
+ * and third-party drivers all refer to IDL verbs (`click`, `screenshot`,
+ * `assert_visible`, ...) and NEVER to concrete MCP tool names. The mapping
+ * from a verb to a transport (mcp_server_id / local_command / http_endpoint /
+ * builtin) lives in the driver's manifest + driver.mjs, not here.
+ *
+ * Five verb families:
+ *   - lifecycle: launch / teardown
+ *   - interaction: click / type / key / navigate / select / upload_file /
+ *     drag_drop / swipe / switch_context / execute_js / wait_for_event /
+ *     wait_for_idle
+ *   - evidence: screenshot / record_video / capture_logs / dump_state /
+ *     dom_dump
+ *   - assertion: assert_visible / assert_text / assert_output /
+ *     assert_network
+ *   - async: trigger / await_signal
+ */
+/** How a driver locates a UI element. `screen_coord` is last-resort. */
+export type TargetKind = 'aria_role' | 'test_id' | 'css' | 'xpath' | 'screen_coord';
+/** A locator the driver translates into a transport-specific selector. */
+export interface Target {
+    readonly kind: TargetKind;
+    readonly value: string;
+}
+export interface LaunchArgs {
+    readonly entrypoint?: string;
+    readonly env?: Readonly<Record<string, string>>;
+    readonly cwd?: string;
+}
+export interface Handle {
+    readonly handle_id: string;
+}
+export interface TeardownArgs {
+    readonly handle: Handle;
+}
+export interface ClickArgs {
+    readonly target: Target;
+    readonly button?: 'left' | 'right' | 'middle';
+}
+export interface TypeArgs {
+    readonly target: Target;
+    readonly text: string;
+    readonly clear_first?: boolean;
+}
+export interface KeyArgs {
+    readonly target?: Target;
+    readonly key: string;
+}
+export interface NavigateArgs {
+    readonly url: string;
+}
+export interface SelectArgs {
+    readonly target: Target;
+    readonly value: string;
+}
+export interface UploadFileArgs {
+    readonly target: Target;
+    readonly file_path: string;
+}
+export interface DragDropArgs {
+    readonly source: Target;
+    readonly destination: Target;
+}
+export interface SwipeArgs {
+    readonly target: Target;
+    readonly direction: 'up' | 'down' | 'left' | 'right';
+}
+export interface SwitchContextArgs {
+    readonly handle: Handle;
+}
+export interface ExecuteJsArgs {
+    readonly script: string;
+    /** Optional args passed positionally into the script. */
+    readonly args?: readonly unknown[];
+}
+export interface WaitForEventArgs {
+    readonly event: string;
+    readonly timeout_ms?: number;
+}
+export interface WaitForIdleArgs {
+    readonly timeout_ms?: number;
+}
+export interface ScreenshotArgs {
+    readonly target?: Target;
+    readonly output_path: string;
+}
+export interface RecordVideoArgs {
+    readonly duration_seconds: number;
+    readonly fps?: number;
+    readonly output_path: string;
+}
+export interface CaptureLogsArgs {
+    readonly source: 'console' | 'stdout' | 'stderr' | 'all';
+    readonly output_path?: string;
+}
+export interface DumpStateArgs {
+    readonly output_path: string;
+}
+export interface DomDumpArgs {
+    readonly output_path: string;
+}
+export interface AssertVisibleArgs {
+    readonly target: Target;
+}
+export interface AssertTextArgs {
+    readonly target: Target;
+    readonly expected: string;
+    readonly match?: 'exact' | 'contains' | 'regex';
+}
+export interface AssertOutputArgs {
+    readonly source: 'stdout' | 'stderr' | 'console';
+    readonly expected: string;
+    readonly match?: 'exact' | 'contains' | 'regex';
+}
+export interface AssertNetworkArgs {
+    readonly url_pattern: string;
+    readonly method?: string;
+    readonly expected_status?: number;
+}
+export interface TriggerArgs {
+    readonly event: string;
+    readonly payload?: unknown;
+}
+export interface AwaitSignalArgs {
+    readonly signal: string;
+    readonly timeout_ms?: number;
+}
+export interface VerbResult {
+    readonly status: 'success' | 'fail' | 'skip';
+    readonly evidence_paths: readonly string[];
+    readonly duration_ms: number;
+    readonly retry_count: number;
+    readonly error?: string;
+}
+/** Lifecycle verbs. */
+export declare const LIFECYCLE_VERBS: readonly ["launch", "teardown"];
+/** Interaction verbs. */
+export declare const INTERACTION_VERBS: readonly ["click", "type", "key", "navigate", "select", "upload_file", "drag_drop", "swipe", "switch_context", "execute_js", "wait_for_event", "wait_for_idle"];
+/** Evidence verbs. */
+export declare const EVIDENCE_VERBS: readonly ["screenshot", "record_video", "capture_logs", "dump_state", "dom_dump"];
+/** Assertion verbs. */
+export declare const ASSERTION_VERBS: readonly ["assert_visible", "assert_text", "assert_output", "assert_network"];
+/** Async verbs. */
+export declare const ASYNC_VERBS: readonly ["trigger", "await_signal"];
+/** Every IDL v1 verb name, flat array — the canonical list. */
+export declare const IDL_VERB_NAMES: readonly string[];
+/** The union type of every verb name. */
+export type IdlVerbName = (typeof LIFECYCLE_VERBS)[number] | (typeof INTERACTION_VERBS)[number] | (typeof EVIDENCE_VERBS)[number] | (typeof ASSERTION_VERBS)[number] | (typeof ASYNC_VERBS)[number];
+/**
+ * Per-verb arg metadata. `required` lists keys that MUST be present on the
+ * args object; `optional` lists keys that MAY be present. Bundled drivers
+ * and third-party drivers both consume this through validateVerbArgs() so
+ * the SDK is the single source of truth (ID-04).
+ *
+ * Frozen so consumers don't mutate the registry by accident.
+ */
+export declare const IDL_VERB_ARGS: Readonly<Record<string, {
+    readonly required: readonly string[];
+    readonly optional: readonly string[];
+}>>;
+/**
+ * VerbResult return-shape predicate. Drivers MUST return an object with
+ * `status` ∈ {success,fail,skip}, `evidence_paths` (array), `duration_ms`
+ * (number), and `retry_count` (number). The conformance kit + framework
+ * resolver call this to validate runtime return shapes.
+ */
+export declare function isVerbResult(value: unknown): boolean;
+/**
+ * Validate a verb's args object against the IDL_VERB_ARGS registry. Returns
+ * `{valid: true}` when every required key is present; otherwise returns
+ * `{valid: false, missing: [...keys]}` where `missing` includes the keys
+ * that were absent (or `['unknown verb: <name>']` for unknown verbs).
+ */
+export declare function validateVerbArgs(verb: string, args: unknown): {
+    valid: true;
+} | {
+    valid: false;
+    missing: string[];
+};
+/**
+ * Driver-shaped interface — a driver exports a subset of these functions
+ * keyed by IDL verb name. The resolver introspects this surface to validate
+ * `manifest.capabilities[]` matches the runtime exports.
+ *
+ * Every method is async + returns VerbResult. Drivers MAY omit verbs they
+ * don't implement — the manifest's `capabilities[]` array is the source of
+ * truth for what each driver claims.
+ */
+export interface DriverModule {
+    readonly launch?: (args: LaunchArgs) => Promise<VerbResult & {
+        handle?: Handle;
+    }>;
+    readonly teardown?: (args: TeardownArgs) => Promise<VerbResult>;
+    readonly click?: (args: ClickArgs) => Promise<VerbResult>;
+    readonly type?: (args: TypeArgs) => Promise<VerbResult>;
+    readonly key?: (args: KeyArgs) => Promise<VerbResult>;
+    readonly navigate?: (args: NavigateArgs) => Promise<VerbResult>;
+    readonly select?: (args: SelectArgs) => Promise<VerbResult>;
+    readonly upload_file?: (args: UploadFileArgs) => Promise<VerbResult>;
+    readonly drag_drop?: (args: DragDropArgs) => Promise<VerbResult>;
+    readonly swipe?: (args: SwipeArgs) => Promise<VerbResult>;
+    readonly switch_context?: (args: SwitchContextArgs) => Promise<VerbResult>;
+    readonly execute_js?: (args: ExecuteJsArgs) => Promise<VerbResult>;
+    readonly wait_for_event?: (args: WaitForEventArgs) => Promise<VerbResult>;
+    readonly wait_for_idle?: (args: WaitForIdleArgs) => Promise<VerbResult>;
+    readonly screenshot?: (args: ScreenshotArgs) => Promise<VerbResult>;
+    readonly record_video?: (args: RecordVideoArgs) => Promise<VerbResult>;
+    readonly capture_logs?: (args: CaptureLogsArgs) => Promise<VerbResult>;
+    readonly dump_state?: (args: DumpStateArgs) => Promise<VerbResult>;
+    readonly dom_dump?: (args: DomDumpArgs) => Promise<VerbResult>;
+    readonly assert_visible?: (args: AssertVisibleArgs) => Promise<VerbResult>;
+    readonly assert_text?: (args: AssertTextArgs) => Promise<VerbResult>;
+    readonly assert_output?: (args: AssertOutputArgs) => Promise<VerbResult>;
+    readonly assert_network?: (args: AssertNetworkArgs) => Promise<VerbResult>;
+    readonly trigger?: (args: TriggerArgs) => Promise<VerbResult>;
+    readonly await_signal?: (args: AwaitSignalArgs) => Promise<VerbResult>;
+}
+//# sourceMappingURL=idl.d.ts.map

package/dist/driver-sdk/idl.d.ts.map

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

package/dist/driver-sdk/idl.js

@@ -0,0 +1,140 @@
+/**
+ * idl.ts — verify-proof IDL v1 verb definitions + arg/return shapes.
+ *
+ * Wire contract per ID-01: workflow prose, the resolver, verification.json,
+ * and third-party drivers all refer to IDL verbs (`click`, `screenshot`,
+ * `assert_visible`, ...) and NEVER to concrete MCP tool names. The mapping
+ * from a verb to a transport (mcp_server_id / local_command / http_endpoint /
+ * builtin) lives in the driver's manifest + driver.mjs, not here.
+ *
+ * Five verb families:
+ *   - lifecycle: launch / teardown
+ *   - interaction: click / type / key / navigate / select / upload_file /
+ *     drag_drop / swipe / switch_context / execute_js / wait_for_event /
+ *     wait_for_idle
+ *   - evidence: screenshot / record_video / capture_logs / dump_state /
+ *     dom_dump
+ *   - assertion: assert_visible / assert_text / assert_output /
+ *     assert_network
+ *   - async: trigger / await_signal
+ */
+// ---------------------------------------------------------------------------
+// Runtime registry — the verb names IDL v1 ships, by family.
+// ---------------------------------------------------------------------------
+/** Lifecycle verbs. */
+export const LIFECYCLE_VERBS = ['launch', 'teardown'];
+/** Interaction verbs. */
+export const INTERACTION_VERBS = [
+    'click',
+    'type',
+    'key',
+    'navigate',
+    'select',
+    'upload_file',
+    'drag_drop',
+    'swipe',
+    'switch_context',
+    'execute_js',
+    'wait_for_event',
+    'wait_for_idle',
+];
+/** Evidence verbs. */
+export const EVIDENCE_VERBS = [
+    'screenshot',
+    'record_video',
+    'capture_logs',
+    'dump_state',
+    'dom_dump',
+];
+/** Assertion verbs. */
+export const ASSERTION_VERBS = [
+    'assert_visible',
+    'assert_text',
+    'assert_output',
+    'assert_network',
+];
+/** Async verbs. */
+export const ASYNC_VERBS = ['trigger', 'await_signal'];
+/** Every IDL v1 verb name, flat array — the canonical list. */
+export const IDL_VERB_NAMES = [
+    ...LIFECYCLE_VERBS,
+    ...INTERACTION_VERBS,
+    ...EVIDENCE_VERBS,
+    ...ASSERTION_VERBS,
+    ...ASYNC_VERBS,
+];
+/**
+ * Per-verb arg metadata. `required` lists keys that MUST be present on the
+ * args object; `optional` lists keys that MAY be present. Bundled drivers
+ * and third-party drivers both consume this through validateVerbArgs() so
+ * the SDK is the single source of truth (ID-04).
+ *
+ * Frozen so consumers don't mutate the registry by accident.
+ */
+export const IDL_VERB_ARGS = Object.freeze({
+    launch: { required: [], optional: ['entrypoint', 'env', 'cwd'] },
+    teardown: { required: ['handle'], optional: [] },
+    click: { required: ['target'], optional: ['button'] },
+    type: { required: ['target', 'text'], optional: ['clear_first'] },
+    key: { required: ['key'], optional: ['target'] },
+    navigate: { required: ['url'], optional: [] },
+    select: { required: ['target', 'value'], optional: [] },
+    upload_file: { required: ['target', 'file_path'], optional: [] },
+    drag_drop: { required: ['source', 'destination'], optional: [] },
+    swipe: { required: ['target', 'direction'], optional: [] },
+    switch_context: { required: ['handle'], optional: [] },
+    execute_js: { required: ['script'], optional: ['args'] },
+    wait_for_event: { required: ['event'], optional: ['timeout_ms'] },
+    wait_for_idle: { required: [], optional: ['timeout_ms'] },
+    screenshot: { required: ['output_path'], optional: ['target'] },
+    record_video: { required: ['duration_seconds', 'output_path'], optional: ['fps'] },
+    capture_logs: { required: ['source'], optional: ['output_path'] },
+    dump_state: { required: ['output_path'], optional: [] },
+    dom_dump: { required: ['output_path'], optional: [] },
+    assert_visible: { required: ['target'], optional: [] },
+    assert_text: { required: ['target', 'expected'], optional: ['match'] },
+    assert_output: { required: ['source', 'expected'], optional: ['match'] },
+    assert_network: { required: ['url_pattern'], optional: ['method', 'expected_status'] },
+    trigger: { required: ['event'], optional: ['payload'] },
+    await_signal: { required: ['signal'], optional: ['timeout_ms'] },
+});
+/**
+ * VerbResult return-shape predicate. Drivers MUST return an object with
+ * `status` ∈ {success,fail,skip}, `evidence_paths` (array), `duration_ms`
+ * (number), and `retry_count` (number). The conformance kit + framework
+ * resolver call this to validate runtime return shapes.
+ */
+export function isVerbResult(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const v = value;
+    if (v.status !== 'success' && v.status !== 'fail' && v.status !== 'skip')
+        return false;
+    if (!Array.isArray(v.evidence_paths))
+        return false;
+    if (typeof v.duration_ms !== 'number')
+        return false;
+    if (typeof v.retry_count !== 'number')
+        return false;
+    return true;
+}
+/**
+ * Validate a verb's args object against the IDL_VERB_ARGS registry. Returns
+ * `{valid: true}` when every required key is present; otherwise returns
+ * `{valid: false, missing: [...keys]}` where `missing` includes the keys
+ * that were absent (or `['unknown verb: <name>']` for unknown verbs).
+ */
+export function validateVerbArgs(verb, args) {
+    const meta = IDL_VERB_ARGS[verb];
+    if (meta === undefined)
+        return { valid: false, missing: [`unknown verb: ${verb}`] };
+    if (args === null || typeof args !== 'object' || Array.isArray(args)) {
+        return { valid: false, missing: [...meta.required] };
+    }
+    const obj = args;
+    const missing = meta.required.filter((k) => !(k in obj));
+    if (missing.length === 0)
+        return { valid: true };
+    return { valid: false, missing: [...missing] };
+}
+//# sourceMappingURL=idl.js.map

package/dist/driver-sdk/idl.js.map

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

package/dist/driver-sdk/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * driver-sdk — public surface (inlined into @aperant/framework@0.8.5).
+ *
+ * Originally shipped as the standalone `@aperant/driver-sdk` package; the
+ * 0.8.4 publish failed because workspace:* rewrote to an unpublished
+ * 0.1.0 spec, leaving framework consumers with a 404. The 0.8.5 inline
+ * folds 875 LOC of zero-dep SDK into the framework tarball; the
+ * subdirectory boundary is enforced by __tests__/import-direction.test.ts
+ * so re-extraction stays mechanical if/when a real third-party driver
+ * author asks for a standalone install.
+ *
+ * Framework consumers import these symbols via the
+ * `@aperant/framework/driver-sdk` subpath export (declared in
+ * packages/framework/package.json:exports) — Node resolves through the
+ * framework's self-symlinked node_modules to the compiled dist output,
+ * matching how `@aperant/framework/cost`, `./schemas`, `./standalone`
+ * already work. Public surface enumerated in
+ * __tests__/public-api-lock.test.ts.
+ */
+export type { ConformanceCheck, ConformanceReport } from './conformance.js';
+export { runConformanceKit } from './conformance.js';
+export { DriverConfigError, DriverEvidenceCaptureError, DriverInvocationError, DriverManifestSchemaError, DriverNotApprovedError, DriverPreflightError, UnsatisfiedRequiredCapabilityError, } from './errors.js';
+export type { AssertNetworkArgs, AssertOutputArgs, AssertTextArgs, AssertVisibleArgs, AwaitSignalArgs, CaptureLogsArgs, ClickArgs, DomDumpArgs, DragDropArgs, DriverModule, DumpStateArgs, ExecuteJsArgs, Handle, IdlVerbName, KeyArgs, LaunchArgs, NavigateArgs, RecordVideoArgs, ScreenshotArgs, SelectArgs, SwipeArgs, SwitchContextArgs, Target, TargetKind, TeardownArgs, TriggerArgs, TypeArgs, UploadFileArgs, VerbResult, WaitForEventArgs, WaitForIdleArgs, } from './idl.js';
+export { ASSERTION_VERBS, ASYNC_VERBS, EVIDENCE_VERBS, IDL_VERB_ARGS, IDL_VERB_NAMES, INTERACTION_VERBS, isVerbResult, LIFECYCLE_VERBS, validateVerbArgs, } from './idl.js';
+export type { AuditBlock, DriverManifest, Integrity, LocalCommand, NetworkPosture, PreflightCheck, Provenance, Publisher, SandboxProfile, SecurityBlock, Stability, Transport, TrustBlock, TrustTier, } from './manifest.js';
+export type { RetryOptions } from './retry.js';
+export { retryWithBackoff } from './retry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/driver-sdk/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/driver-sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAE3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAEpD,OAAO,EACN,iBAAiB,EACjB,0BAA0B,EAC1B,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,EACtB,oBAAoB,EACpB,kCAAkC,GAClC,MAAM,aAAa,CAAA;AACpB,YAAY,EACX,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,SAAS,EACT,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,aAAa,EACb,MAAM,EACN,WAAW,EACX,OAAO,EACP,UAAU,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,MAAM,EACN,UAAU,EACV,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,eAAe,GACf,MAAM,UAAU,CAAA;AAEjB,OAAO,EACN,eAAe,EACf,WAAW,EACX,cAAc,EACd,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,gBAAgB,GAChB,MAAM,UAAU,CAAA;AAEjB,YAAY,EACX,UAAU,EACV,cAAc,EACd,SAAS,EACT,YAAY,EACZ,cAAc,EACd,cAAc,EACd,UAAU,EACV,SAAS,EACT,cAAc,EACd,aAAa,EACb,SAAS,EACT,SAAS,EACT,UAAU,EACV,SAAS,GACT,MAAM,eAAe,CAAA;AACtB,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA"}

package/dist/driver-sdk/index.js

@@ -0,0 +1,28 @@
+/**
+ * driver-sdk — public surface (inlined into @aperant/framework@0.8.5).
+ *
+ * Originally shipped as the standalone `@aperant/driver-sdk` package; the
+ * 0.8.4 publish failed because workspace:* rewrote to an unpublished
+ * 0.1.0 spec, leaving framework consumers with a 404. The 0.8.5 inline
+ * folds 875 LOC of zero-dep SDK into the framework tarball; the
+ * subdirectory boundary is enforced by __tests__/import-direction.test.ts
+ * so re-extraction stays mechanical if/when a real third-party driver
+ * author asks for a standalone install.
+ *
+ * Framework consumers import these symbols via the
+ * `@aperant/framework/driver-sdk` subpath export (declared in
+ * packages/framework/package.json:exports) — Node resolves through the
+ * framework's self-symlinked node_modules to the compiled dist output,
+ * matching how `@aperant/framework/cost`, `./schemas`, `./standalone`
+ * already work. Public surface enumerated in
+ * __tests__/public-api-lock.test.ts.
+ */
+// conformance.ts — shared driver conformance kit
+export { runConformanceKit } from './conformance.js';
+// errors.ts — error taxonomy
+export { DriverConfigError, DriverEvidenceCaptureError, DriverInvocationError, DriverManifestSchemaError, DriverNotApprovedError, DriverPreflightError, UnsatisfiedRequiredCapabilityError, } from './errors.js';
+// idl.ts — runtime verb name registry + driver interface types + arg validation
+export { ASSERTION_VERBS, ASYNC_VERBS, EVIDENCE_VERBS, IDL_VERB_ARGS, IDL_VERB_NAMES, INTERACTION_VERBS, isVerbResult, LIFECYCLE_VERBS, validateVerbArgs, } from './idl.js';
+// retry.ts — exponential backoff helper
+export { retryWithBackoff } from './retry.js';
+//# sourceMappingURL=index.js.map

package/dist/driver-sdk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/driver-sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,iDAAiD;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACpD,6BAA6B;AAC7B,OAAO,EACN,iBAAiB,EACjB,0BAA0B,EAC1B,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,EACtB,oBAAoB,EACpB,kCAAkC,GAClC,MAAM,aAAa,CAAA;AAkCpB,gFAAgF;AAChF,OAAO,EACN,eAAe,EACf,WAAW,EACX,cAAc,EACd,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,gBAAgB,GAChB,MAAM,UAAU,CAAA;AAmBjB,wCAAwC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA"}