@limrun/api 0.48.4 → 0.49.0

package/resources/ios-instances-helpers.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IosInstances = void 0;
+const ios_instances_1 = require("./ios-instances.js");
+const path_1 = require("../internal/utils/path.js");
+class IosInstances extends ios_instances_1.IosInstances {
+    /**
+     * List the instance's persisted session artifacts, optionally narrowed to
+     * one kind.
+     */
+    listSessionArtifacts(id, kind, options) {
+        return this._client.get((0, path_1.path) `/v1/ios_instances/${id}/session_artifacts`, {
+            query: kind ? { kind } : undefined,
+            ...options,
+        });
+    }
+    /**
+     * List the instance's persisted session recordings.
+     */
+    listRecordings(id, options) {
+        return this.listSessionArtifacts(id, 'recording', options);
+    }
+    /**
+     * List the instance's persisted app log captures.
+     */
+    listAppLogs(id, options) {
+        return this.listSessionArtifacts(id, 'appLog', options);
+    }
+    /**
+     * List the instance's persisted event log captures.
+     */
+    listEvents(id, options) {
+        return this.listSessionArtifacts(id, 'eventLog', options);
+    }
+}
+exports.IosInstances = IosInstances;
+//# sourceMappingURL=ios-instances-helpers.js.map

package/resources/ios-instances-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ios-instances-helpers.js","sourceRoot":"","sources":["../src/resources/ios-instances-helpers.ts"],"names":[],"mappings":";;;AAAA,sDAAwE;AAIxE,oDAA8C;AAI9C,MAAa,YAAa,SAAQ,4BAAqB;IACrD;;;OAGG;IACH,oBAAoB,CAClB,EAAU,EACV,IAA0B,EAC1B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,qBAAqB,EAAE,oBAAoB,EAAE;YACvE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;YAClC,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,EAAU,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,oBAAoB,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,EAAU,EAAE,OAAwB;QAC9C,OAAO,IAAI,CAAC,oBAAoB,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,EAAU,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,oBAAoB,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;CACF;AApCD,oCAoCC"}

package/resources/ios-instances-helpers.mjs

@@ -0,0 +1,33 @@
+import { IosInstances as GeneratedIosInstances } from "./ios-instances.mjs";
+import { path } from "../internal/utils/path.mjs";
+export class IosInstances extends GeneratedIosInstances {
+    /**
+     * List the instance's persisted session artifacts, optionally narrowed to
+     * one kind.
+     */
+    listSessionArtifacts(id, kind, options) {
+        return this._client.get(path `/v1/ios_instances/${id}/session_artifacts`, {
+            query: kind ? { kind } : undefined,
+            ...options,
+        });
+    }
+    /**
+     * List the instance's persisted session recordings.
+     */
+    listRecordings(id, options) {
+        return this.listSessionArtifacts(id, 'recording', options);
+    }
+    /**
+     * List the instance's persisted app log captures.
+     */
+    listAppLogs(id, options) {
+        return this.listSessionArtifacts(id, 'appLog', options);
+    }
+    /**
+     * List the instance's persisted event log captures.
+     */
+    listEvents(id, options) {
+        return this.listSessionArtifacts(id, 'eventLog', options);
+    }
+}
+//# sourceMappingURL=ios-instances-helpers.mjs.map

package/resources/ios-instances-helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ios-instances-helpers.mjs","sourceRoot":"","sources":["../src/resources/ios-instances-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,IAAI,qBAAqB,EAAE,4BAAwB;AAIxE,OAAO,EAAE,IAAI,EAAE,mCAA+B;AAI9C,MAAM,OAAO,YAAa,SAAQ,qBAAqB;IACrD;;;OAGG;IACH,oBAAoB,CAClB,EAAU,EACV,IAA0B,EAC1B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,qBAAqB,EAAE,oBAAoB,EAAE;YACvE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;YAClC,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,EAAU,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,oBAAoB,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,EAAU,EAAE,OAAwB;QAC9C,OAAO,IAAI,CAAC,oBAAoB,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,EAAU,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,oBAAoB,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;CACF"}

package/resources/session-artifacts.d.mts

@@ -0,0 +1,70 @@
+/** The kind of a persisted session capture. */
+export type SessionArtifactKind = 'recording' | 'appLog' | 'eventLog' | 'networkLog';
+/**
+ * One persisted session capture of an instance: a video recording, an app log
+ * capture, a coalesced event log, or a HAR network log. Returned by the
+ * director's GET /v1/{ios,android}_instances/{id}/session_artifacts endpoint,
+ * optionally narrowed with its kind query parameter.
+ */
+export interface SessionArtifact {
+    id: string;
+    kind: SessionArtifactKind;
+    /** Bundle id (iOS) or package name (Android) for app log captures. */
+    bundleId?: string;
+    /** Destination tunnel that produced a networkLog artifact. */
+    tunnelId?: string;
+    /** Canonical selectors captured by a networkLog artifact. */
+    selectors?: string[];
+    startedAt?: string;
+    stoppedAt?: string;
+    /** When the artifact is deleted from storage. */
+    expiresAt?: string;
+    sizeBytes?: number;
+    /**
+     * Short-lived presigned GET URL for the raw artifact: MP4 for recordings,
+     * JSONL for app logs and event logs, HAR for network logs.
+     */
+    downloadUrl: string;
+}
+/**
+ * One captured app log line, delivered live by `streamAppLogCapture` and stored
+ * one-per-line in `appLog` artifacts.
+ */
+export interface SessionLogLine {
+    /**
+     * Epoch milliseconds: logcat's own timestamp on Android, receipt time on
+     * iOS. Shares the clock of the recording artifact's `startedAt`, so lines
+     * can be aligned with video playback offsets.
+     */
+    ts: number;
+    line: string;
+}
+export type SessionEventType = 'tap' | 'drag' | 'scroll' | 'key' | 'text' | 'command';
+/**
+ * One coalesced user or agent action, delivered live by `streamEventCapture` and
+ * stored one-per-line in `eventLog` artifacts. The runtime logs semantic
+ * actions, never raw HID frames: a pointer sequence becomes one tap or drag,
+ * scroll and keystroke bursts merge into one event, and typed text is never
+ * included.
+ */
+export interface SessionEvent {
+    /** The action's start in epoch milliseconds, same clock as SessionLogLine. */
+    ts: number;
+    type: SessionEventType;
+    /** Touch point for tap, start point for drag, anchor for scroll. */
+    x?: number;
+    y?: number;
+    /** Drag end point; for scroll they carry the burst's summed deltas instead. */
+    toX?: number;
+    toY?: number;
+    /** Duration of the whole gesture or burst. */
+    durationMs?: number;
+    /** Number of merged actions in a scroll or text burst. */
+    count?: number;
+    /**
+     * Short human-readable label, e.g. "launchApp com.example". Never carries
+     * typed text or request payloads.
+     */
+    summary?: string;
+}
+//# sourceMappingURL=session-artifacts.d.mts.map

package/resources/session-artifacts.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-artifacts.d.mts","sourceRoot":"","sources":["../src/resources/session-artifacts.ts"],"names":[],"mappings":"AAMA,+CAA+C;AAC/C,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC;AAErF;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IAEX,IAAI,EAAE,mBAAmB,CAAC;IAE1B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;AAEtF;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,EAAE,EAAE,MAAM,CAAC;IAEX,IAAI,EAAE,gBAAgB,CAAC;IAEvB,oEAAoE;IACpE,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IAEX,+EAA+E;IAC/E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/resources/session-artifacts.d.ts

@@ -0,0 +1,70 @@
+/** The kind of a persisted session capture. */
+export type SessionArtifactKind = 'recording' | 'appLog' | 'eventLog' | 'networkLog';
+/**
+ * One persisted session capture of an instance: a video recording, an app log
+ * capture, a coalesced event log, or a HAR network log. Returned by the
+ * director's GET /v1/{ios,android}_instances/{id}/session_artifacts endpoint,
+ * optionally narrowed with its kind query parameter.
+ */
+export interface SessionArtifact {
+    id: string;
+    kind: SessionArtifactKind;
+    /** Bundle id (iOS) or package name (Android) for app log captures. */
+    bundleId?: string;
+    /** Destination tunnel that produced a networkLog artifact. */
+    tunnelId?: string;
+    /** Canonical selectors captured by a networkLog artifact. */
+    selectors?: string[];
+    startedAt?: string;
+    stoppedAt?: string;
+    /** When the artifact is deleted from storage. */
+    expiresAt?: string;
+    sizeBytes?: number;
+    /**
+     * Short-lived presigned GET URL for the raw artifact: MP4 for recordings,
+     * JSONL for app logs and event logs, HAR for network logs.
+     */
+    downloadUrl: string;
+}
+/**
+ * One captured app log line, delivered live by `streamAppLogCapture` and stored
+ * one-per-line in `appLog` artifacts.
+ */
+export interface SessionLogLine {
+    /**
+     * Epoch milliseconds: logcat's own timestamp on Android, receipt time on
+     * iOS. Shares the clock of the recording artifact's `startedAt`, so lines
+     * can be aligned with video playback offsets.
+     */
+    ts: number;
+    line: string;
+}
+export type SessionEventType = 'tap' | 'drag' | 'scroll' | 'key' | 'text' | 'command';
+/**
+ * One coalesced user or agent action, delivered live by `streamEventCapture` and
+ * stored one-per-line in `eventLog` artifacts. The runtime logs semantic
+ * actions, never raw HID frames: a pointer sequence becomes one tap or drag,
+ * scroll and keystroke bursts merge into one event, and typed text is never
+ * included.
+ */
+export interface SessionEvent {
+    /** The action's start in epoch milliseconds, same clock as SessionLogLine. */
+    ts: number;
+    type: SessionEventType;
+    /** Touch point for tap, start point for drag, anchor for scroll. */
+    x?: number;
+    y?: number;
+    /** Drag end point; for scroll they carry the burst's summed deltas instead. */
+    toX?: number;
+    toY?: number;
+    /** Duration of the whole gesture or burst. */
+    durationMs?: number;
+    /** Number of merged actions in a scroll or text burst. */
+    count?: number;
+    /**
+     * Short human-readable label, e.g. "launchApp com.example". Never carries
+     * typed text or request payloads.
+     */
+    summary?: string;
+}
+//# sourceMappingURL=session-artifacts.d.ts.map

package/resources/session-artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-artifacts.d.ts","sourceRoot":"","sources":["../src/resources/session-artifacts.ts"],"names":[],"mappings":"AAMA,+CAA+C;AAC/C,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC;AAErF;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IAEX,IAAI,EAAE,mBAAmB,CAAC;IAE1B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;AAEtF;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,EAAE,EAAE,MAAM,CAAC;IAEX,IAAI,EAAE,gBAAgB,CAAC;IAEvB,oEAAoE;IACpE,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,CAAC,CAAC,EAAE,MAAM,CAAC;IAEX,+EAA+E;IAC/E,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/resources/session-artifacts.js

@@ -0,0 +1,8 @@
+"use strict";
+// Hand-written: the session-artifact list endpoint is not in the generated
+// OpenAPI surface yet. Shared by the iOS and Android instance helpers.
+// SessionLogLine and SessionEvent mirror pkg/artifacts/contract.go in the
+// limrun repo; the runtimes emit the same JSON over live SSE and into the
+// persisted JSONL artifacts.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=session-artifacts.js.map

package/resources/session-artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-artifacts.js","sourceRoot":"","sources":["../src/resources/session-artifacts.ts"],"names":[],"mappings":";AAAA,2EAA2E;AAC3E,uEAAuE;AACvE,0EAA0E;AAC1E,0EAA0E;AAC1E,6BAA6B"}

package/resources/session-artifacts.mjs

@@ -0,0 +1,7 @@
+// Hand-written: the session-artifact list endpoint is not in the generated
+// OpenAPI surface yet. Shared by the iOS and Android instance helpers.
+// SessionLogLine and SessionEvent mirror pkg/artifacts/contract.go in the
+// limrun repo; the runtimes emit the same JSON over live SSE and into the
+// persisted JSONL artifacts.
+export {};
+//# sourceMappingURL=session-artifacts.mjs.map

package/resources/session-artifacts.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-artifacts.mjs","sourceRoot":"","sources":["../src/resources/session-artifacts.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,uEAAuE;AACvE,0EAA0E;AAC1E,0EAA0E;AAC1E,6BAA6B"}

package/src/client.ts

@@ -28,11 +28,11 @@ import {
 } from './resources/analytics';
 import {
   AndroidInstance,
-  AndroidInstances,
   AndroidInstanceCreateParams,
   AndroidInstanceListParams,
   AndroidInstancesItems,
 } from './resources/android-instances';
+import { AndroidInstances } from './resources/android-instances-helpers';
 import {
   Asset,
   AssetGetOrCreateParams,
@@ -52,9 +52,10 @@ import {
   IosInstance,
   IosInstanceCreateParams,
   IosInstanceListParams,
-  IosInstances,
   IosInstancesItems,
 } from './resources/ios-instances';
+import { IosInstances } from './resources/ios-instances-helpers';
+import { SessionArtifact } from './resources/session-artifacts';
 import { ScopedToken, ScopedTokenCreateParams, ScopedTokens } from './resources/scoped-tokens';
 import {
   XcodeInstance,
@@ -877,6 +878,7 @@ export declare namespace Limrun {
     type IosInstancesItems as IosInstancesItems,
     type IosInstanceCreateParams as IosInstanceCreateParams,
     type IosInstanceListParams as IosInstanceListParams,
+    type SessionArtifact as SessionArtifact,
   };
 
   export {