@xemahq/kernel-contracts 0.27.0 → 0.29.0

package/dist/capability/index.d.ts

@@ -1,4 +1,5 @@
 export * from './lib/capability-ref';
+export * from './lib/connector-capability-ref';
 export * from './lib/capability-grant';
 export * from './lib/capability-policy';
 export * from './lib/permission-profile';

package/dist/capability/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/capability/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iBAAiB,CAAC;AAChC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/capability/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iBAAiB,CAAC;AAChC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,cAAc,CAAC"}

package/dist/capability/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./lib/capability-ref"), exports);
+__exportStar(require("./lib/connector-capability-ref"), exports);
 __exportStar(require("./lib/capability-grant"), exports);
 __exportStar(require("./lib/capability-policy"), exports);
 __exportStar(require("./lib/permission-profile"), exports);

package/dist/capability/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/capability/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,yDAAuC;AACvC,0DAAwC;AACxC,2DAAyC;AACzC,iEAA+C;AAC/C,kDAAgC;AAChC,gEAA8C;AAC9C,+CAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/capability/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,iEAA+C;AAC/C,yDAAuC;AACvC,0DAAwC;AACxC,2DAAyC;AACzC,iEAA+C;AAC/C,kDAAgC;AAChC,gEAA8C;AAC9C,+CAA6B"}

package/dist/capability/lib/connector-capability-ref.d.ts

@@ -0,0 +1,11 @@
+import { type CapabilityRef } from './capability-ref';
+export declare const CONNECTOR_CAPABILITY_DOMAIN = "connector";
+export interface ParsedConnectorCapabilityRef {
+    readonly provider: string;
+    readonly verb: string;
+    readonly major: number;
+    readonly raw: CapabilityRef;
+}
+export declare function buildConnectorCapabilityRef(providerSlug: string, verb: string, major?: number): CapabilityRef;
+export declare function parseConnectorCapabilityRef(ref: string): ParsedConnectorCapabilityRef;
+//# sourceMappingURL=connector-capability-ref.d.ts.map

package/dist/capability/lib/connector-capability-ref.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-capability-ref.d.ts","sourceRoot":"","sources":["../../../src/capability/lib/connector-capability-ref.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAGnB,MAAM,kBAAkB,CAAC;AAkB1B,eAAO,MAAM,2BAA2B,cAAc,CAAC;AAOvD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;CAC7B;AAiBD,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,KAAK,SAAI,GACR,aAAa,CAaf;AAeD,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,GACV,4BAA4B,CAoB9B"}

package/dist/capability/lib/connector-capability-ref.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONNECTOR_CAPABILITY_DOMAIN = void 0;
+exports.buildConnectorCapabilityRef = buildConnectorCapabilityRef;
+exports.parseConnectorCapabilityRef = parseConnectorCapabilityRef;
+const capability_ref_1 = require("./capability-ref");
+const errors_1 = require("./errors");
+exports.CONNECTOR_CAPABILITY_DOMAIN = 'connector';
+function buildConnectorCapabilityRef(providerSlug, verb, major = 1) {
+    const raw = (0, capability_ref_1.formatCapabilityRef)({
+        domain: exports.CONNECTOR_CAPABILITY_DOMAIN,
+        verbPath: [providerSlug, verb],
+        major,
+    });
+    parseConnectorCapabilityRef(raw);
+    return raw;
+}
+function parseConnectorCapabilityRef(ref) {
+    const parsed = (0, capability_ref_1.parseCapabilityRef)(ref);
+    if (parsed.domain !== exports.CONNECTOR_CAPABILITY_DOMAIN) {
+        throw new errors_1.CapabilityRefParseError({
+            message: `Connector capability ref "${ref}" must use the "${exports.CONNECTOR_CAPABILITY_DOMAIN}" domain, got "${parsed.domain}".`,
+            raw: ref,
+        });
+    }
+    if (parsed.verbPath.length !== 2) {
+        throw new errors_1.CapabilityRefParseError({
+            message: `Connector capability ref "${ref}" must be exactly "<provider>.<verb>" after the domain (got ${parsed.verbPath.length} segment(s)).`,
+            raw: ref,
+        });
+    }
+    return {
+        provider: parsed.verbPath[0],
+        verb: parsed.verbPath[1],
+        major: parsed.major,
+        raw: parsed.raw,
+    };
+}
+//# sourceMappingURL=connector-capability-ref.js.map

package/dist/capability/lib/connector-capability-ref.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-capability-ref.js","sourceRoot":"","sources":["../../../src/capability/lib/connector-capability-ref.ts"],"names":[],"mappings":";;;AAmDA,kEAiBC;AAeD,kEAsBC;AAzGD,qDAI0B;AAC1B,qCAAmD;AAiBtC,QAAA,2BAA2B,GAAG,WAAW,CAAC;AA6BvD,SAAgB,2BAA2B,CACzC,YAAoB,EACpB,IAAY,EACZ,KAAK,GAAG,CAAC;IAET,MAAM,GAAG,GAAG,IAAA,oCAAmB,EAAC;QAC9B,MAAM,EAAE,mCAA2B;QACnC,QAAQ,EAAE,CAAC,YAAY,EAAE,IAAI,CAAC;QAC9B,KAAK;KACN,CAAC,CAAC;IAMH,2BAA2B,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO,GAAG,CAAC;AACb,CAAC;AAeD,SAAgB,2BAA2B,CACzC,GAAW;IAEX,MAAM,MAAM,GAAG,IAAA,mCAAkB,EAAC,GAAG,CAAC,CAAC;IACvC,IAAI,MAAM,CAAC,MAAM,KAAK,mCAA2B,EAAE,CAAC;QAClD,MAAM,IAAI,gCAAuB,CAAC;YAChC,OAAO,EAAE,6BAA6B,GAAG,mBAAmB,mCAA2B,kBAAkB,MAAM,CAAC,MAAM,IAAI;YAC1H,GAAG,EAAE,GAAG;SACT,CAAC,CAAC;IACL,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,gCAAuB,CAAC;YAChC,OAAO,EAAE,6BAA6B,GAAG,+DAA+D,MAAM,CAAC,QAAQ,CAAC,MAAM,eAAe;YAC7I,GAAG,EAAE,GAAG;SACT,CAAC,CAAC;IACL,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAE;QAC7B,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAE;QACzB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,GAAG,EAAE,MAAM,CAAC,GAAG;KAChB,CAAC;AACJ,CAAC"}

package/dist/output-surface-inspect/index.d.ts

@@ -0,0 +1,3 @@
+export * from './lib/output-surface-inspect';
+export * from './lib/step-schema';
+//# sourceMappingURL=index.d.ts.map

package/dist/output-surface-inspect/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/output-surface-inspect/index.ts"],"names":[],"mappings":"AACA,cAAc,8BAA8B,CAAC;AAE7C,cAAc,mBAAmB,CAAC"}

package/dist/output-surface-inspect/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./lib/output-surface-inspect"), exports);
+__exportStar(require("./lib/step-schema"), exports);
+//# sourceMappingURL=index.js.map

package/dist/output-surface-inspect/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/output-surface-inspect/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,+DAA6C;AAE7C,oDAAkC"}

package/dist/output-surface-inspect/lib/output-surface-inspect.d.ts

@@ -0,0 +1,226 @@
+export declare enum InspectTargetKind {
+    UserTab = "user-tab",
+    Headless = "headless"
+}
+export declare enum InspectStepKind {
+    Navigate = "navigate",
+    Reload = "reload",
+    Back = "back",
+    Click = "click",
+    Fill = "fill",
+    Type = "type",
+    Select = "select",
+    Press = "press",
+    Hover = "hover",
+    Snapshot = "snapshot",
+    Evaluate = "evaluate",
+    Console = "console",
+    Network = "network",
+    Page = "page",
+    Wait = "wait"
+}
+export declare enum InspectConsoleLevel {
+    Log = "log",
+    Info = "info",
+    Warn = "warn",
+    Error = "error",
+    Debug = "debug"
+}
+export declare const INSPECT_CONSOLE_LEVEL_VALUES: readonly InspectConsoleLevel[];
+export declare enum InspectStepStatus {
+    Ok = "ok",
+    Error = "error",
+    Timeout = "timeout",
+    PageNavigated = "page-navigated",
+    OffDomain = "off-domain",
+    Skipped = "skipped",
+    OutputSurfaceNotOpen = "output-surface-not-open"
+}
+export declare enum InspectUnloadReason {
+    Navigation = "navigation",
+    OffDomain = "off-domain"
+}
+export declare enum InspectBatchStatus {
+    Pending = "pending",
+    Running = "running",
+    Completed = "completed",
+    Failed = "failed"
+}
+export interface InspectElementTarget {
+    ref?: string | undefined;
+    selector?: string | undefined;
+}
+export interface InspectWindowedRead {
+    sinceMs?: number | undefined;
+    sinceCursor?: number | undefined;
+    grep?: string | undefined;
+    limit?: number | undefined;
+}
+export interface InspectNavigateStep {
+    kind: InspectStepKind.Navigate;
+    path: string;
+}
+export interface InspectReloadStep {
+    kind: InspectStepKind.Reload;
+}
+export interface InspectBackStep {
+    kind: InspectStepKind.Back;
+}
+export interface InspectClickStep extends InspectElementTarget {
+    kind: InspectStepKind.Click;
+}
+export interface InspectFillStep extends InspectElementTarget {
+    kind: InspectStepKind.Fill;
+    value: string;
+}
+export interface InspectTypeStep extends InspectElementTarget {
+    kind: InspectStepKind.Type;
+    text: string;
+}
+export interface InspectSelectStep extends InspectElementTarget {
+    kind: InspectStepKind.Select;
+    value: string;
+}
+export interface InspectPressStep extends InspectElementTarget {
+    kind: InspectStepKind.Press;
+    key: string;
+}
+export interface InspectHoverStep extends InspectElementTarget {
+    kind: InspectStepKind.Hover;
+}
+export interface InspectSnapshotStep {
+    kind: InspectStepKind.Snapshot;
+    selector?: string | undefined;
+}
+export interface InspectEvaluateStep {
+    kind: InspectStepKind.Evaluate;
+    expression: string;
+}
+export interface InspectConsoleStep extends InspectWindowedRead {
+    kind: InspectStepKind.Console;
+    levels?: InspectConsoleLevel[] | undefined;
+}
+export interface InspectNetworkStep extends InspectWindowedRead {
+    kind: InspectStepKind.Network;
+    failedOnly?: boolean | undefined;
+}
+export interface InspectPageStep {
+    kind: InspectStepKind.Page;
+}
+export interface InspectWaitStep {
+    kind: InspectStepKind.Wait;
+    ms: number;
+}
+export type InspectStep = InspectNavigateStep | InspectReloadStep | InspectBackStep | InspectClickStep | InspectFillStep | InspectTypeStep | InspectSelectStep | InspectPressStep | InspectHoverStep | InspectSnapshotStep | InspectEvaluateStep | InspectConsoleStep | InspectNetworkStep | InspectPageStep | InspectWaitStep;
+export interface InspectConsoleEntry {
+    readonly level: InspectConsoleLevel;
+    readonly text: string;
+    readonly count: number;
+    readonly firstAt: number;
+    readonly lastAt: number;
+    readonly source: 'console' | 'window.error' | 'unhandledrejection';
+}
+export interface InspectNetworkEntry {
+    readonly url: string;
+    readonly method?: string;
+    readonly status?: number;
+    readonly resourceType: string;
+    readonly startedAt: number;
+    readonly durationMs?: number;
+    readonly transferSize?: number;
+    readonly failed?: boolean;
+    readonly errorText?: string;
+}
+export interface InspectReadResult<TEntry> {
+    readonly entries: readonly TEntry[];
+    readonly collected: number;
+    readonly returned: number;
+    readonly dropped: number;
+    readonly truncated: boolean;
+    readonly cursor: number;
+}
+export interface InspectStepResult {
+    readonly kind: InspectStepKind;
+    readonly status: InspectStepStatus;
+    readonly data?: unknown;
+    readonly error?: string;
+}
+export interface InspectBatchRequest {
+    readonly steps: readonly InspectStep[];
+    readonly target?: InspectTargetKind;
+}
+export interface InspectOutputSurfaceApp {
+    readonly name: string;
+    readonly repoSlug: string;
+    readonly kind: string;
+    readonly status: string;
+    readonly externalUrl?: string;
+}
+export interface InspectOutputSurfaceContext {
+    readonly target: InspectTargetKind;
+    readonly apps: readonly InspectOutputSurfaceApp[];
+    readonly workspaceRoot: string;
+}
+export interface InspectBatchResult {
+    readonly batchId: string;
+    readonly status: InspectBatchStatus;
+    readonly results: readonly InspectStepResult[];
+    readonly note?: string;
+    readonly outputSurfaceContext?: InspectOutputSurfaceContext;
+}
+export declare const XEMA_INSPECT_HELLO: "xema:inspect:hello";
+export declare const XEMA_INSPECT_UNLOADING: "xema:inspect:unloading";
+export declare const XEMA_INSPECT_COMMAND: "xema:inspect:command";
+export declare const XEMA_INSPECT_RESULT: "xema:inspect:result";
+export interface InspectHelloMessage {
+    readonly type: typeof XEMA_INSPECT_HELLO;
+    readonly bridgeInstanceId: string;
+    readonly url: string;
+    readonly title: string;
+}
+export interface InspectUnloadingMessage {
+    readonly type: typeof XEMA_INSPECT_UNLOADING;
+    readonly bridgeInstanceId: string;
+    readonly reason: InspectUnloadReason;
+    readonly targetUrl?: string;
+}
+export interface InspectCommandMessage {
+    readonly type: typeof XEMA_INSPECT_COMMAND;
+    readonly commandId: string;
+    readonly step: InspectStep;
+}
+export interface InspectResultMessage {
+    readonly type: typeof XEMA_INSPECT_RESULT;
+    readonly commandId: string;
+    readonly result: InspectStepResult;
+}
+export declare const XEMA_OUTPUT_SURFACE_READY: "xema:output-surface-ready";
+export declare const XEMA_RUNTIME_ERRORS: "xema:runtime-errors";
+export declare const XEMA_SET_COMMENT_MODE: "xema:set-comment-mode";
+export declare const XEMA_COMMENT: "xema:comment";
+export interface OutputSurfaceRuntimeErrorItem {
+    readonly text: string;
+    readonly count: number;
+    readonly source: 'console' | 'window.error' | 'unhandledrejection';
+}
+export interface OutputSurfaceRuntimeErrorSummary {
+    readonly type: typeof XEMA_RUNTIME_ERRORS;
+    readonly url: string;
+    readonly total: number;
+    readonly top: readonly OutputSurfaceRuntimeErrorItem[];
+}
+export declare const SESSION_OUTPUT_SURFACE_INSPECT_COMMAND_EVENT: "session.output-surface.inspect.command";
+export declare const INSPECT_MAX_STEPS_PER_BATCH = 20;
+export declare const INSPECT_STEP_TIMEOUT_MS = 15000;
+export declare const INSPECT_NAVIGATE_TIMEOUT_MS = 30000;
+export declare const INSPECT_PRESENCE_TTL_MS = 30000;
+export declare const INSPECT_PRESENCE_HEARTBEAT_MS = 10000;
+export declare const INSPECT_BUFFER_MAX_ENTRIES = 500;
+export declare const INSPECT_BUFFER_MAX_BYTES: number;
+export declare const INSPECT_ENTRY_MAX_BYTES: number;
+export declare const INSPECT_EVAL_RESULT_MAX_BYTES: number;
+export declare const INSPECT_BATCH_RESULT_MAX_BYTES: number;
+export declare const INSPECT_READ_DEFAULT_LIMIT = 50;
+export declare const INSPECT_READ_MAX_LIMIT = 200;
+export declare function isInspectNavigationStep(kind: InspectStepKind): boolean;
+//# sourceMappingURL=output-surface-inspect.d.ts.map

package/dist/output-surface-inspect/lib/output-surface-inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-surface-inspect.d.ts","sourceRoot":"","sources":["../../../src/output-surface-inspect/lib/output-surface-inspect.ts"],"names":[],"mappings":"AA4BA,oBAAY,iBAAiB;IAC3B,OAAO,aAAa;IACpB,QAAQ,aAAa;CACtB;AASD,oBAAY,eAAe;IAEzB,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,IAAI,SAAS;IAEb,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,KAAK,UAAU;IACf,KAAK,UAAU;IAEf,QAAQ,aAAa;IACrB,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,IAAI,SAAS;IAEb,IAAI,SAAS;CACd;AAGD,oBAAY,mBAAmB;IAC7B,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;IACf,KAAK,UAAU;CAChB;AAGD,eAAO,MAAM,4BAA4B,EAAE,SAAS,mBAAmB,EACnC,CAAC;AAGrC,oBAAY,iBAAiB;IAC3B,EAAE,OAAO;IACT,KAAK,UAAU;IAEf,OAAO,YAAY;IAEnB,aAAa,mBAAmB;IAOhC,SAAS,eAAe;IAExB,OAAO,YAAY;IAEnB,oBAAoB,4BAA4B;CACjD;AAGD,oBAAY,mBAAmB;IAE7B,UAAU,eAAe;IAKzB,SAAS,eAAe;CACzB;AAGD,oBAAY,kBAAkB;IAC5B,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,MAAM,WAAW;CAClB;AAeD,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAGD,MAAM,WAAW,mBAAmB;IAElC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE7B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEjC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE1B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,eAAe,CAAC,QAAQ,CAAC;IAE/B,IAAI,EAAE,MAAM,CAAC;CACd;AACD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC;CAC9B;AACD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC;CAC5B;AACD,MAAM,WAAW,gBAAiB,SAAQ,oBAAoB;IAC5D,IAAI,EAAE,eAAe,CAAC,KAAK,CAAC;CAC7B;AACD,MAAM,WAAW,eAAgB,SAAQ,oBAAoB;IAC3D,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC;IAE3B,KAAK,EAAE,MAAM,CAAC;CACf;AACD,MAAM,WAAW,eAAgB,SAAQ,oBAAoB;IAC3D,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC;IAE3B,IAAI,EAAE,MAAM,CAAC;CACd;AACD,MAAM,WAAW,iBAAkB,SAAQ,oBAAoB;IAC7D,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC;IAE7B,KAAK,EAAE,MAAM,CAAC;CACf;AACD,MAAM,WAAW,gBAAiB,SAAQ,oBAAoB;IAC5D,IAAI,EAAE,eAAe,CAAC,KAAK,CAAC;IAE5B,GAAG,EAAE,MAAM,CAAC;CACb;AACD,MAAM,WAAW,gBAAiB,SAAQ,oBAAoB;IAC5D,IAAI,EAAE,eAAe,CAAC,KAAK,CAAC;CAC7B;AACD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,eAAe,CAAC,QAAQ,CAAC;IAE/B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AACD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,eAAe,CAAC,QAAQ,CAAC;IAE/B,UAAU,EAAE,MAAM,CAAC;CACpB;AACD,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,IAAI,EAAE,eAAe,CAAC,OAAO,CAAC;IAC9B,MAAM,CAAC,EAAE,mBAAmB,EAAE,GAAG,SAAS,CAAC;CAC5C;AACD,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,IAAI,EAAE,eAAe,CAAC,OAAO,CAAC;IAE9B,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClC;AACD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC;CAC5B;AACD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC;IAE3B,EAAE,EAAE,MAAM,CAAC;CACZ;AAOD,MAAM,MAAM,WAAW,GACnB,mBAAmB,GACnB,iBAAiB,GACjB,eAAe,GACf,gBAAgB,GAChB,eAAe,GACf,eAAe,GACf,iBAAiB,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,mBAAmB,GACnB,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,GAClB,eAAe,GACf,eAAe,CAAC;AAIpB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc,GAAG,oBAAoB,CAAC;CACpE;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAGD,MAAM,WAAW,iBAAiB,CAAC,MAAM;IACvC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAEpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAEnC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAGD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;CACrC;AAOD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAOD,MAAM,WAAW,2BAA2B;IAE1C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAEnC,QAAQ,CAAC,IAAI,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAElD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAGD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAE/C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,oBAAoB,CAAC,EAAE,2BAA2B,CAAC;CAC7D;AAKD,eAAO,MAAM,kBAAkB,EAAG,oBAA6B,CAAC;AAEhE,eAAO,MAAM,sBAAsB,EAAG,wBAAiC,CAAC;AAExE,eAAO,MAAM,oBAAoB,EAAG,sBAA+B,CAAC;AAEpE,eAAO,MAAM,mBAAmB,EAAG,qBAA8B,CAAC;AAElE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,OAAO,kBAAkB,CAAC;IACzC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,OAAO,sBAAsB,CAAC;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAErC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,OAAO,oBAAoB,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,OAAO,mBAAmB,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACpC;AAKD,eAAO,MAAM,yBAAyB,EAAG,2BAAoC,CAAC;AAE9E,eAAO,MAAM,mBAAmB,EAAG,qBAA8B,CAAC;AAElE,eAAO,MAAM,qBAAqB,EAAG,uBAAgC,CAAC;AAEtE,eAAO,MAAM,YAAY,EAAG,cAAuB,CAAC;AAEpD,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc,GAAG,oBAAoB,CAAC;CACpE;AAGD,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,IAAI,EAAE,OAAO,mBAAmB,CAAC;IAC1C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,GAAG,EAAE,SAAS,6BAA6B,EAAE,CAAC;CACxD;AAKD,eAAO,MAAM,4CAA4C,EACvD,wCAAiD,CAAC;AAKpD,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAE9C,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAElD,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAE9C,eAAO,MAAM,6BAA6B,QAAS,CAAC;AAGpD,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,eAAO,MAAM,wBAAwB,QAAa,CAAC;AAEnD,eAAO,MAAM,uBAAuB,QAAW,CAAC;AAEhD,eAAO,MAAM,6BAA6B,QAAW,CAAC;AAEtD,eAAO,MAAM,8BAA8B,QAAY,CAAC;AAExD,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAC7C,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAG1C,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAMtE"}

package/dist/output-surface-inspect/lib/output-surface-inspect.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INSPECT_READ_MAX_LIMIT = exports.INSPECT_READ_DEFAULT_LIMIT = exports.INSPECT_BATCH_RESULT_MAX_BYTES = exports.INSPECT_EVAL_RESULT_MAX_BYTES = exports.INSPECT_ENTRY_MAX_BYTES = exports.INSPECT_BUFFER_MAX_BYTES = exports.INSPECT_BUFFER_MAX_ENTRIES = exports.INSPECT_PRESENCE_HEARTBEAT_MS = exports.INSPECT_PRESENCE_TTL_MS = exports.INSPECT_NAVIGATE_TIMEOUT_MS = exports.INSPECT_STEP_TIMEOUT_MS = exports.INSPECT_MAX_STEPS_PER_BATCH = exports.SESSION_OUTPUT_SURFACE_INSPECT_COMMAND_EVENT = exports.XEMA_COMMENT = exports.XEMA_SET_COMMENT_MODE = exports.XEMA_RUNTIME_ERRORS = exports.XEMA_OUTPUT_SURFACE_READY = exports.XEMA_INSPECT_RESULT = exports.XEMA_INSPECT_COMMAND = exports.XEMA_INSPECT_UNLOADING = exports.XEMA_INSPECT_HELLO = exports.InspectBatchStatus = exports.InspectUnloadReason = exports.InspectStepStatus = exports.INSPECT_CONSOLE_LEVEL_VALUES = exports.InspectConsoleLevel = exports.InspectStepKind = exports.InspectTargetKind = void 0;
+exports.isInspectNavigationStep = isInspectNavigationStep;
+var InspectTargetKind;
+(function (InspectTargetKind) {
+    InspectTargetKind["UserTab"] = "user-tab";
+    InspectTargetKind["Headless"] = "headless";
+})(InspectTargetKind || (exports.InspectTargetKind = InspectTargetKind = {}));
+var InspectStepKind;
+(function (InspectStepKind) {
+    InspectStepKind["Navigate"] = "navigate";
+    InspectStepKind["Reload"] = "reload";
+    InspectStepKind["Back"] = "back";
+    InspectStepKind["Click"] = "click";
+    InspectStepKind["Fill"] = "fill";
+    InspectStepKind["Type"] = "type";
+    InspectStepKind["Select"] = "select";
+    InspectStepKind["Press"] = "press";
+    InspectStepKind["Hover"] = "hover";
+    InspectStepKind["Snapshot"] = "snapshot";
+    InspectStepKind["Evaluate"] = "evaluate";
+    InspectStepKind["Console"] = "console";
+    InspectStepKind["Network"] = "network";
+    InspectStepKind["Page"] = "page";
+    InspectStepKind["Wait"] = "wait";
+})(InspectStepKind || (exports.InspectStepKind = InspectStepKind = {}));
+var InspectConsoleLevel;
+(function (InspectConsoleLevel) {
+    InspectConsoleLevel["Log"] = "log";
+    InspectConsoleLevel["Info"] = "info";
+    InspectConsoleLevel["Warn"] = "warn";
+    InspectConsoleLevel["Error"] = "error";
+    InspectConsoleLevel["Debug"] = "debug";
+})(InspectConsoleLevel || (exports.InspectConsoleLevel = InspectConsoleLevel = {}));
+exports.INSPECT_CONSOLE_LEVEL_VALUES = Object.values(InspectConsoleLevel);
+var InspectStepStatus;
+(function (InspectStepStatus) {
+    InspectStepStatus["Ok"] = "ok";
+    InspectStepStatus["Error"] = "error";
+    InspectStepStatus["Timeout"] = "timeout";
+    InspectStepStatus["PageNavigated"] = "page-navigated";
+    InspectStepStatus["OffDomain"] = "off-domain";
+    InspectStepStatus["Skipped"] = "skipped";
+    InspectStepStatus["OutputSurfaceNotOpen"] = "output-surface-not-open";
+})(InspectStepStatus || (exports.InspectStepStatus = InspectStepStatus = {}));
+var InspectUnloadReason;
+(function (InspectUnloadReason) {
+    InspectUnloadReason["Navigation"] = "navigation";
+    InspectUnloadReason["OffDomain"] = "off-domain";
+})(InspectUnloadReason || (exports.InspectUnloadReason = InspectUnloadReason = {}));
+var InspectBatchStatus;
+(function (InspectBatchStatus) {
+    InspectBatchStatus["Pending"] = "pending";
+    InspectBatchStatus["Running"] = "running";
+    InspectBatchStatus["Completed"] = "completed";
+    InspectBatchStatus["Failed"] = "failed";
+})(InspectBatchStatus || (exports.InspectBatchStatus = InspectBatchStatus = {}));
+exports.XEMA_INSPECT_HELLO = 'xema:inspect:hello';
+exports.XEMA_INSPECT_UNLOADING = 'xema:inspect:unloading';
+exports.XEMA_INSPECT_COMMAND = 'xema:inspect:command';
+exports.XEMA_INSPECT_RESULT = 'xema:inspect:result';
+exports.XEMA_OUTPUT_SURFACE_READY = 'xema:output-surface-ready';
+exports.XEMA_RUNTIME_ERRORS = 'xema:runtime-errors';
+exports.XEMA_SET_COMMENT_MODE = 'xema:set-comment-mode';
+exports.XEMA_COMMENT = 'xema:comment';
+exports.SESSION_OUTPUT_SURFACE_INSPECT_COMMAND_EVENT = 'session.output-surface.inspect.command';
+exports.INSPECT_MAX_STEPS_PER_BATCH = 20;
+exports.INSPECT_STEP_TIMEOUT_MS = 15_000;
+exports.INSPECT_NAVIGATE_TIMEOUT_MS = 30_000;
+exports.INSPECT_PRESENCE_TTL_MS = 30_000;
+exports.INSPECT_PRESENCE_HEARTBEAT_MS = 10_000;
+exports.INSPECT_BUFFER_MAX_ENTRIES = 500;
+exports.INSPECT_BUFFER_MAX_BYTES = 256 * 1024;
+exports.INSPECT_ENTRY_MAX_BYTES = 2 * 1024;
+exports.INSPECT_EVAL_RESULT_MAX_BYTES = 8 * 1024;
+exports.INSPECT_BATCH_RESULT_MAX_BYTES = 32 * 1024;
+exports.INSPECT_READ_DEFAULT_LIMIT = 50;
+exports.INSPECT_READ_MAX_LIMIT = 200;
+function isInspectNavigationStep(kind) {
+    return (kind === InspectStepKind.Navigate ||
+        kind === InspectStepKind.Reload ||
+        kind === InspectStepKind.Back);
+}
+//# sourceMappingURL=output-surface-inspect.js.map

package/dist/output-surface-inspect/lib/output-surface-inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-surface-inspect.js","sourceRoot":"","sources":["../../../src/output-surface-inspect/lib/output-surface-inspect.ts"],"names":[],"mappings":";;;AAoaA,0DAMC;AA9YD,IAAY,iBAGX;AAHD,WAAY,iBAAiB;IAC3B,yCAAoB,CAAA;IACpB,0CAAqB,CAAA;AACvB,CAAC,EAHW,iBAAiB,iCAAjB,iBAAiB,QAG5B;AASD,IAAY,eAoBX;AApBD,WAAY,eAAe;IAEzB,wCAAqB,CAAA;IACrB,oCAAiB,CAAA;IACjB,gCAAa,CAAA;IAEb,kCAAe,CAAA;IACf,gCAAa,CAAA;IACb,gCAAa,CAAA;IACb,oCAAiB,CAAA;IACjB,kCAAe,CAAA;IACf,kCAAe,CAAA;IAEf,wCAAqB,CAAA;IACrB,wCAAqB,CAAA;IACrB,sCAAmB,CAAA;IACnB,sCAAmB,CAAA;IACnB,gCAAa,CAAA;IAEb,gCAAa,CAAA;AACf,CAAC,EApBW,eAAe,+BAAf,eAAe,QAoB1B;AAGD,IAAY,mBAMX;AAND,WAAY,mBAAmB;IAC7B,kCAAW,CAAA;IACX,oCAAa,CAAA;IACb,oCAAa,CAAA;IACb,sCAAe,CAAA;IACf,sCAAe,CAAA;AACjB,CAAC,EANW,mBAAmB,mCAAnB,mBAAmB,QAM9B;AAGY,QAAA,4BAA4B,GACvC,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAGrC,IAAY,iBAkBX;AAlBD,WAAY,iBAAiB;IAC3B,8BAAS,CAAA;IACT,oCAAe,CAAA;IAEf,wCAAmB,CAAA;IAEnB,qDAAgC,CAAA;IAOhC,6CAAwB,CAAA;IAExB,wCAAmB,CAAA;IAEnB,qEAAgD,CAAA;AAClD,CAAC,EAlBW,iBAAiB,iCAAjB,iBAAiB,QAkB5B;AAGD,IAAY,mBAQX;AARD,WAAY,mBAAmB;IAE7B,gDAAyB,CAAA;IAKzB,+CAAwB,CAAA;AAC1B,CAAC,EARW,mBAAmB,mCAAnB,mBAAmB,QAQ9B;AAGD,IAAY,kBAKX;AALD,WAAY,kBAAkB;IAC5B,yCAAmB,CAAA;IACnB,yCAAmB,CAAA;IACnB,6CAAuB,CAAA;IACvB,uCAAiB,CAAA;AACnB,CAAC,EALW,kBAAkB,kCAAlB,kBAAkB,QAK7B;AAoNY,QAAA,kBAAkB,GAAG,oBAA6B,CAAC;AAEnD,QAAA,sBAAsB,GAAG,wBAAiC,CAAC;AAE3D,QAAA,oBAAoB,GAAG,sBAA+B,CAAC;AAEvD,QAAA,mBAAmB,GAAG,qBAA8B,CAAC;AAgCrD,QAAA,yBAAyB,GAAG,2BAAoC,CAAC;AAEjE,QAAA,mBAAmB,GAAG,qBAA8B,CAAC;AAErD,QAAA,qBAAqB,GAAG,uBAAgC,CAAC;AAEzD,QAAA,YAAY,GAAG,cAAuB,CAAC;AAqBvC,QAAA,4CAA4C,GACvD,wCAAiD,CAAC;AAKvC,QAAA,2BAA2B,GAAG,EAAE,CAAC;AAEjC,QAAA,uBAAuB,GAAG,MAAM,CAAC;AAEjC,QAAA,2BAA2B,GAAG,MAAM,CAAC;AAErC,QAAA,uBAAuB,GAAG,MAAM,CAAC;AAEjC,QAAA,6BAA6B,GAAG,MAAM,CAAC;AAGvC,QAAA,0BAA0B,GAAG,GAAG,CAAC;AACjC,QAAA,wBAAwB,GAAG,GAAG,GAAG,IAAI,CAAC;AAEtC,QAAA,uBAAuB,GAAG,CAAC,GAAG,IAAI,CAAC;AAEnC,QAAA,6BAA6B,GAAG,CAAC,GAAG,IAAI,CAAC;AAEzC,QAAA,8BAA8B,GAAG,EAAE,GAAG,IAAI,CAAC;AAE3C,QAAA,0BAA0B,GAAG,EAAE,CAAC;AAChC,QAAA,sBAAsB,GAAG,GAAG,CAAC;AAG1C,SAAgB,uBAAuB,CAAC,IAAqB;IAC3D,OAAO,CACL,IAAI,KAAK,eAAe,CAAC,QAAQ;QACjC,IAAI,KAAK,eAAe,CAAC,MAAM;QAC/B,IAAI,KAAK,eAAe,CAAC,IAAI,CAC9B,CAAC;AACJ,CAAC"}

package/dist/output-surface-inspect/lib/step-schema.d.ts

@@ -0,0 +1,64 @@
+import { z } from 'zod';
+import { InspectConsoleLevel, InspectStepKind } from './output-surface-inspect';
+export declare const InspectStepSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<InspectStepKind.Navigate>;
+    path: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<InspectStepKind.Reload>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<InspectStepKind.Back>;
+}, z.core.$strip>, z.ZodObject<{
+    ref: z.ZodOptional<z.ZodString>;
+    selector: z.ZodOptional<z.ZodString>;
+    kind: z.ZodLiteral<InspectStepKind.Click>;
+}, z.core.$strip>, z.ZodObject<{
+    value: z.ZodString;
+    ref: z.ZodOptional<z.ZodString>;
+    selector: z.ZodOptional<z.ZodString>;
+    kind: z.ZodLiteral<InspectStepKind.Fill>;
+}, z.core.$strip>, z.ZodObject<{
+    text: z.ZodString;
+    ref: z.ZodOptional<z.ZodString>;
+    selector: z.ZodOptional<z.ZodString>;
+    kind: z.ZodLiteral<InspectStepKind.Type>;
+}, z.core.$strip>, z.ZodObject<{
+    value: z.ZodString;
+    ref: z.ZodOptional<z.ZodString>;
+    selector: z.ZodOptional<z.ZodString>;
+    kind: z.ZodLiteral<InspectStepKind.Select>;
+}, z.core.$strip>, z.ZodObject<{
+    key: z.ZodString;
+    ref: z.ZodOptional<z.ZodString>;
+    selector: z.ZodOptional<z.ZodString>;
+    kind: z.ZodLiteral<InspectStepKind.Press>;
+}, z.core.$strip>, z.ZodObject<{
+    ref: z.ZodOptional<z.ZodString>;
+    selector: z.ZodOptional<z.ZodString>;
+    kind: z.ZodLiteral<InspectStepKind.Hover>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<InspectStepKind.Snapshot>;
+    selector: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<InspectStepKind.Evaluate>;
+    expression: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    levels: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof InspectConsoleLevel>>>;
+    sinceMs: z.ZodOptional<z.ZodNumber>;
+    sinceCursor: z.ZodOptional<z.ZodNumber>;
+    grep: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodLiteral<InspectStepKind.Console>;
+}, z.core.$strip>, z.ZodObject<{
+    failedOnly: z.ZodOptional<z.ZodBoolean>;
+    sinceMs: z.ZodOptional<z.ZodNumber>;
+    sinceCursor: z.ZodOptional<z.ZodNumber>;
+    grep: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodLiteral<InspectStepKind.Network>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<InspectStepKind.Page>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<InspectStepKind.Wait>;
+    ms: z.ZodNumber;
+}, z.core.$strip>], "kind">;
+//# sourceMappingURL=step-schema.d.ts.map

package/dist/output-surface-inspect/lib/step-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-schema.d.ts","sourceRoot":"","sources":["../../../src/output-surface-inspect/lib/step-schema.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAoBhF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BA6D5B,CAAC"}

package/dist/output-surface-inspect/lib/step-schema.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InspectStepSchema = void 0;
+const zod_1 = require("zod");
+const output_surface_inspect_1 = require("./output-surface-inspect");
+const elementTargetShape = {
+    ref: zod_1.z.string().min(1).max(200).optional(),
+    selector: zod_1.z.string().min(1).max(2000).optional(),
+};
+const windowedReadShape = {
+    sinceMs: zod_1.z.number().int().positive().max(600_000).optional(),
+    sinceCursor: zod_1.z.number().int().nonnegative().optional(),
+    grep: zod_1.z.string().min(1).max(400).optional(),
+    limit: zod_1.z.number().int().positive().optional(),
+};
+exports.InspectStepSchema = zod_1.z.discriminatedUnion('kind', [
+    zod_1.z.object({
+        kind: zod_1.z.literal(output_surface_inspect_1.InspectStepKind.Navigate),
+        path: zod_1.z.string().min(1).max(2000),
+    }),
+    zod_1.z.object({ kind: zod_1.z.literal(output_surface_inspect_1.InspectStepKind.Reload) }),
+    zod_1.z.object({ kind: zod_1.z.literal(output_surface_inspect_1.InspectStepKind.Back) }),
+    zod_1.z.object({ kind: zod_1.z.literal(output_surface_inspect_1.InspectStepKind.Click), ...elementTargetShape }),
+    zod_1.z.object({
+        kind: zod_1.z.literal(output_surface_inspect_1.InspectStepKind.Fill),
+        ...elementTargetShape,
+        value: zod_1.z.string().max(20_000),
+    }),
+    zod_1.z.object({
+        kind: zod_1.z.literal(output_surface_inspect_1.InspectStepKind.Type),
+        ...elementTargetShape,
+        text: zod_1.z.string().max(20_000),
+    }),
+    zod_1.z.object({
+        kind: zod_1.z.literal(output_surface_inspect_1.InspectStepKind.Select),
+        ...elementTargetShape,
+        value: zod_1.z.string().max(2000),
+    }),
+    zod_1.z.object({
+        kind: zod_1.z.literal(output_surface_inspect_1.InspectStepKind.Press),
+        ...elementTargetShape,
+        key: zod_1.z.string().min(1).max(40),
+    }),
+    zod_1.z.object({ kind: zod_1.z.literal(output_surface_inspect_1.InspectStepKind.Hover), ...elementTargetShape }),
+    zod_1.z.object({
+        kind: zod_1.z.literal(output_surface_inspect_1.InspectStepKind.Snapshot),
+        selector: zod_1.z.string().min(1).max(2000).optional(),
+    }),
+    zod_1.z.object({
+        kind: zod_1.z.literal(output_surface_inspect_1.InspectStepKind.Evaluate),
+        expression: zod_1.z.string().min(1).max(20_000),
+    }),
+    zod_1.z.object({
+        kind: zod_1.z.literal(output_surface_inspect_1.InspectStepKind.Console),
+        ...windowedReadShape,
+        levels: zod_1.z.array(zod_1.z.enum(output_surface_inspect_1.InspectConsoleLevel)).min(1).optional(),
+    }),
+    zod_1.z.object({
+        kind: zod_1.z.literal(output_surface_inspect_1.InspectStepKind.Network),
+        ...windowedReadShape,
+        failedOnly: zod_1.z.boolean().optional(),
+    }),
+    zod_1.z.object({ kind: zod_1.z.literal(output_surface_inspect_1.InspectStepKind.Page) }),
+    zod_1.z.object({
+        kind: zod_1.z.literal(output_surface_inspect_1.InspectStepKind.Wait),
+        ms: zod_1.z.number().int().positive().max(60_000),
+    }),
+]);
+const _schemaToType = (s) => s;
+const _typeToSchema = (s) => s;
+void _schemaToType;
+void _typeToSchema;
+//# sourceMappingURL=step-schema.js.map

package/dist/output-surface-inspect/lib/step-schema.js.map

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

package/dist/output-surface-inspect/runtime/index.d.ts

@@ -0,0 +1,2 @@
+export * from '../lib/output-surface-inspect';
+//# sourceMappingURL=index.d.ts.map

package/dist/output-surface-inspect/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/output-surface-inspect/runtime/index.ts"],"names":[],"mappings":"AAMA,cAAc,+BAA+B,CAAC"}

package/dist/output-surface-inspect/runtime/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("../lib/output-surface-inspect"), exports);
+//# sourceMappingURL=index.js.map

package/dist/output-surface-inspect/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/output-surface-inspect/runtime/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAMA,gEAA8C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xemahq/kernel-contracts",
-  "version": "0.27.0",
+  "version": "0.29.0",
   "description": "Consolidated Xema OS kernel wire contracts — pure types + zod schemas for the kernel protocol surfaces. One package, one npm scope, wildcard per-surface subpath exports. No framework/runtime deps.",
   "license": "Apache-2.0",
   "author": "Neuralchowder Inc. <developer@xema.dev> (https://xema.dev)",