@aperant/framework 0.8.4 → 0.8.7

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":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,wEAAwE;AACxE,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,cAAc,CAAA;AAEnF,0EAA0E;AAC1E,MAAM,WAAW,MAAM;IACtB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACtB;AAMD,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAC/C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,MAAM;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACvB;AAMD,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;CAC7C;AAED,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAC9B;AAED,MAAM,WAAW,OAAO;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;CACpD;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,yDAAyD;IACzD,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;CAClC;AAED,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC5B;AAMD,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAA;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC5B;AAMD,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,CAAA;CAC/C;AAED,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,CAAA;CAC/C;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CACjC;AAMD,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC5B;AAMD,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,MAAM,CAAA;IAC5C,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACvB;AAMD,uBAAuB;AACvB,eAAO,MAAM,eAAe,iCAAkC,CAAA;AAE9D,yBAAyB;AACzB,eAAO,MAAM,iBAAiB,iKAapB,CAAA;AAEV,sBAAsB;AACtB,eAAO,MAAM,cAAc,mFAMjB,CAAA;AAEV,uBAAuB;AACvB,eAAO,MAAM,eAAe,+EAKlB,CAAA;AAEV,mBAAmB;AACnB,eAAO,MAAM,WAAW,sCAAuC,CAAA;AAE/D,+DAA+D;AAC/D,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAM3C,CAAA;AAED,yCAAyC;AACzC,MAAM,MAAM,WAAW,GACpB,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,GAChC,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,GAClC,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,GAC/B,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,GAChC,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/B;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,QAAQ,CACnC,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC,CA+B7F,CAAA;AAEF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQpD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC/B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,GACX;IAAE,KAAK,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAUvD;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,UAAU,GAAG;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACjF,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAC/D,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IACzD,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IACvD,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAC3D,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IACpE,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAChE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IACzD,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAC1E,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAClE,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IACzE,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IACvE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IACnE,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IACtE,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IACtE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAClE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAC9D,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAC1E,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IACpE,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IACxE,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAC7D,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;CACtE"}

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"}

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

@@ -0,0 +1,93 @@
+/**
+ * manifest.ts — TypeScript shape of a driver manifest.
+ *
+ * Mirrors `packages/framework/src/cli/verify-proof/manifest-schema.json`
+ * (ST03) one-to-one. The JSON Schema is the runtime validator (publish-
+ * time + load-time); this TS type is what third-party driver authors
+ * `import type` to author manifests with intellisense.
+ *
+ * Spec authority: spec.md §ID-03 (trust tiers) + §ID-04 (driver layout).
+ */
+export type TrustTier = 'first_party_signed' | 'community_verified' | 'community_unverified' | 'local_unverified';
+export type Stability = 'experimental' | 'beta' | 'ga';
+export type SandboxProfile = 'read_only' | 'workspace_write' | 'system_write';
+export type NetworkPosture = 'deny' | 'allowlist' | 'allow';
+/** Structured local-command — strings are NEVER accepted (ID-03). */
+export interface LocalCommand {
+    readonly binary: string;
+    readonly args: readonly string[];
+}
+/** Transport — exactly one of the variants. */
+export type Transport = {
+    readonly mcp_server_id: string;
+} | {
+    readonly local_command: LocalCommand;
+} | {
+    readonly http_endpoint: string;
+} | {
+    readonly npm_package: string;
+} | {
+    readonly builtin: true;
+};
+export interface Publisher {
+    readonly name: string;
+    readonly npm_scope?: string;
+    readonly github_org?: string;
+    readonly verified?: boolean;
+}
+export interface Provenance {
+    readonly scheme?: 'sigstore' | 'npm-provenance' | 'gpg' | 'none';
+    readonly identity?: string;
+    readonly signature?: string;
+    readonly certificate?: string;
+}
+export interface Integrity {
+    readonly manifest_sha256?: string;
+    readonly artifact_digest?: string;
+}
+export interface TrustBlock {
+    readonly tier: TrustTier;
+    readonly publisher?: Publisher;
+    readonly provenance?: Provenance;
+    readonly integrity?: Integrity;
+}
+export interface SecurityBlock {
+    readonly sandbox_profile: SandboxProfile;
+    readonly network: NetworkPosture;
+    readonly allowed_executables?: readonly string[];
+    readonly allow_shell?: boolean;
+    readonly requires_user_approval?: boolean;
+}
+export interface AuditBlock {
+    readonly log_invocations: boolean;
+    readonly log_manifest_hash: boolean;
+}
+export interface PreflightCheck {
+    readonly name: string;
+    readonly command?: LocalCommand;
+    readonly required: boolean;
+}
+export interface DriverManifest {
+    readonly driverId: string;
+    readonly version: string;
+    readonly targets: readonly string[];
+    readonly capabilities: readonly string[];
+    readonly evidence_capabilities?: readonly string[];
+    readonly frameworkApiRange: string;
+    readonly requires?: {
+        readonly allOf?: readonly string[];
+        readonly anyOf?: readonly string[];
+    };
+    readonly os?: readonly string[];
+    readonly arch?: readonly string[];
+    readonly container_support?: boolean;
+    readonly conflicts_with?: readonly string[];
+    readonly priority: number;
+    readonly stability: Stability;
+    readonly trust: TrustBlock;
+    readonly security: SecurityBlock;
+    readonly audit?: AuditBlock;
+    readonly preflight?: readonly PreflightCheck[];
+    readonly transport: Transport;
+}
+//# sourceMappingURL=manifest.d.ts.map

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

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

package/dist/driver-sdk/manifest.js

@@ -0,0 +1,12 @@
+/**
+ * manifest.ts — TypeScript shape of a driver manifest.
+ *
+ * Mirrors `packages/framework/src/cli/verify-proof/manifest-schema.json`
+ * (ST03) one-to-one. The JSON Schema is the runtime validator (publish-
+ * time + load-time); this TS type is what third-party driver authors
+ * `import type` to author manifests with intellisense.
+ *
+ * Spec authority: spec.md §ID-03 (trust tiers) + §ID-04 (driver layout).
+ */
+export {};
+//# sourceMappingURL=manifest.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/driver-sdk/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

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

@@ -0,0 +1,33 @@
+/**
+ * retry.ts — exponential backoff helper with abort signal.
+ *
+ * Used by driver implementations that want to retry transient transport
+ * failures (DriverInvocationError) before giving up. Pure, dependency-free.
+ */
+export interface RetryOptions {
+    /** Total maximum attempts including the first. Default 3. */
+    readonly max_attempts?: number;
+    /** Initial delay in ms before the second attempt. Default 100. */
+    readonly base_delay_ms?: number;
+    /** Cap each delay at this many ms. Default 5000. */
+    readonly max_delay_ms?: number;
+    /**
+     * Multiplier applied to delay after each failed attempt. Default 2 →
+     * 100ms, 200ms, 400ms, 800ms, …
+     */
+    readonly multiplier?: number;
+    /** Optional AbortSignal — abort short-circuits the retry loop. */
+    readonly signal?: AbortSignal;
+    /**
+     * Optional predicate. When provided, only retry when shouldRetry(err) is
+     * true; otherwise re-throw immediately. Default: retry every error.
+     */
+    readonly shouldRetry?: (err: unknown) => boolean;
+}
+/**
+ * Run `fn` with exponential backoff. Returns the result of the first
+ * successful call. If every attempt fails (or the signal aborts), throws
+ * the last error.
+ */
+export declare function retryWithBackoff<T>(fn: () => Promise<T>, opts?: RetryOptions): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/driver-sdk/retry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,oDAAoD;IACpD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAA;CAChD;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACvC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,GAAE,YAAiB,GACrB,OAAO,CAAC,CAAC,CAAC,CAqCZ"}