libretto 0.1.4 → 0.2.0

package/dist/shared/run/api.cjs

@@ -0,0 +1,35 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var api_exports = {};
+__export(api_exports, {
+  DebugPauseSignal: () => import_pause.DebugPauseSignal,
+  debugPause: () => import_pause.debugPause,
+  isDebugPauseSignal: () => import_pause.isDebugPauseSignal,
+  launchBrowser: () => import_browser.launchBrowser
+});
+module.exports = __toCommonJS(api_exports);
+var import_browser = require("./browser.js");
+var import_pause = require("../debug/pause.js");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DebugPauseSignal,
+  debugPause,
+  isDebugPauseSignal,
+  launchBrowser
+});

package/dist/shared/run/api.d.cts

@@ -0,0 +1,3 @@
+export { BrowserSession, LaunchBrowserArgs, launchBrowser } from './browser.cjs';
+export { DebugPauseContext, DebugPauseDetails, DebugPauseSignal, debugPause, isDebugPauseSignal } from '../debug/pause.cjs';
+import 'playwright';

package/dist/shared/run/api.d.ts

@@ -0,0 +1,3 @@
+export { BrowserSession, LaunchBrowserArgs, launchBrowser } from './browser.js';
+export { DebugPauseContext, DebugPauseDetails, DebugPauseSignal, debugPause, isDebugPauseSignal } from '../debug/pause.js';
+import 'playwright';

package/dist/shared/run/api.js

@@ -0,0 +1,12 @@
+import { launchBrowser } from "./browser.js";
+import {
+  debugPause,
+  DebugPauseSignal,
+  isDebugPauseSignal
+} from "../debug/pause.js";
+export {
+  DebugPauseSignal,
+  debugPause,
+  isDebugPauseSignal,
+  launchBrowser
+};

package/dist/shared/run/browser.cjs

@@ -0,0 +1,98 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var browser_exports = {};
+__export(browser_exports, {
+  launchBrowser: () => launchBrowser
+});
+module.exports = __toCommonJS(browser_exports);
+var import_playwright = require("playwright");
+var import_node_net = require("node:net");
+var import_node_fs = require("node:fs");
+var import_paths = require("../paths/paths.js");
+var import_session_state = require("../state/session-state.js");
+async function pickFreePort() {
+  return await new Promise((resolve, reject) => {
+    const server = (0, import_node_net.createServer)();
+    server.unref();
+    server.on("error", reject);
+    server.listen(0, "127.0.0.1", () => {
+      const addr = server.address();
+      if (addr && typeof addr === "object") {
+        server.close(() => resolve(addr.port));
+        return;
+      }
+      server.close(() => reject(new Error("Failed to resolve debug port")));
+    });
+  });
+}
+async function launchBrowser({
+  sessionName,
+  headless = false,
+  viewport = { width: 1366, height: 768 },
+  storageStatePath
+}) {
+  const debugPort = await pickFreePort();
+  const browser = await import_playwright.chromium.launch({
+    headless,
+    args: [
+      "--disable-blink-features=AutomationControlled",
+      `--remote-debugging-port=${debugPort}`,
+      "--no-focus-on-check"
+    ]
+  });
+  const context = await browser.newContext({
+    viewport,
+    ...storageStatePath ? { storageState: storageStatePath } : {}
+  });
+  const page = await context.newPage();
+  page.setDefaultTimeout(3e4);
+  page.setDefaultNavigationTimeout(45e3);
+  const metadataPath = (0, import_paths.ensureLibrettoSessionStatePath)(sessionName);
+  const existingStateRaw = (0, import_node_fs.existsSync)(metadataPath) ? JSON.parse((0, import_node_fs.readFileSync)(metadataPath, "utf-8")) : void 0;
+  const parsedExistingState = import_session_state.SessionStateFileSchema.safeParse(existingStateRaw);
+  (0, import_node_fs.writeFileSync)(
+    metadataPath,
+    JSON.stringify(
+      {
+        version: parsedExistingState.success ? parsedExistingState.data.version : import_session_state.SESSION_STATE_VERSION,
+        session: sessionName,
+        port: debugPort,
+        pid: process.pid,
+        startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        status: "active"
+      },
+      null,
+      2
+    )
+  );
+  return {
+    browser,
+    context,
+    page,
+    debugPort,
+    metadataPath,
+    close: async () => {
+      await browser.close();
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  launchBrowser
+});

package/dist/shared/run/browser.d.cts

@@ -0,0 +1,22 @@
+import { Browser, BrowserContext, Page } from 'playwright';
+
+type LaunchBrowserArgs = {
+    sessionName: string;
+    headless?: boolean;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    storageStatePath?: string;
+};
+type BrowserSession = {
+    browser: Browser;
+    context: BrowserContext;
+    page: Page;
+    debugPort: number;
+    metadataPath: string;
+    close: () => Promise<void>;
+};
+declare function launchBrowser({ sessionName, headless, viewport, storageStatePath, }: LaunchBrowserArgs): Promise<BrowserSession>;
+
+export { type BrowserSession, type LaunchBrowserArgs, launchBrowser };

package/dist/shared/run/browser.d.ts

@@ -0,0 +1,22 @@
+import { Browser, BrowserContext, Page } from 'playwright';
+
+type LaunchBrowserArgs = {
+    sessionName: string;
+    headless?: boolean;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    storageStatePath?: string;
+};
+type BrowserSession = {
+    browser: Browser;
+    context: BrowserContext;
+    page: Page;
+    debugPort: number;
+    metadataPath: string;
+    close: () => Promise<void>;
+};
+declare function launchBrowser({ sessionName, headless, viewport, storageStatePath, }: LaunchBrowserArgs): Promise<BrowserSession>;
+
+export { type BrowserSession, type LaunchBrowserArgs, launchBrowser };

package/dist/shared/run/browser.js

@@ -0,0 +1,74 @@
+import { chromium } from "playwright";
+import { createServer } from "node:net";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { ensureLibrettoSessionStatePath } from "../paths/paths.js";
+import { SESSION_STATE_VERSION, SessionStateFileSchema } from "../state/session-state.js";
+async function pickFreePort() {
+  return await new Promise((resolve, reject) => {
+    const server = createServer();
+    server.unref();
+    server.on("error", reject);
+    server.listen(0, "127.0.0.1", () => {
+      const addr = server.address();
+      if (addr && typeof addr === "object") {
+        server.close(() => resolve(addr.port));
+        return;
+      }
+      server.close(() => reject(new Error("Failed to resolve debug port")));
+    });
+  });
+}
+async function launchBrowser({
+  sessionName,
+  headless = false,
+  viewport = { width: 1366, height: 768 },
+  storageStatePath
+}) {
+  const debugPort = await pickFreePort();
+  const browser = await chromium.launch({
+    headless,
+    args: [
+      "--disable-blink-features=AutomationControlled",
+      `--remote-debugging-port=${debugPort}`,
+      "--no-focus-on-check"
+    ]
+  });
+  const context = await browser.newContext({
+    viewport,
+    ...storageStatePath ? { storageState: storageStatePath } : {}
+  });
+  const page = await context.newPage();
+  page.setDefaultTimeout(3e4);
+  page.setDefaultNavigationTimeout(45e3);
+  const metadataPath = ensureLibrettoSessionStatePath(sessionName);
+  const existingStateRaw = existsSync(metadataPath) ? JSON.parse(readFileSync(metadataPath, "utf-8")) : void 0;
+  const parsedExistingState = SessionStateFileSchema.safeParse(existingStateRaw);
+  writeFileSync(
+    metadataPath,
+    JSON.stringify(
+      {
+        version: parsedExistingState.success ? parsedExistingState.data.version : SESSION_STATE_VERSION,
+        session: sessionName,
+        port: debugPort,
+        pid: process.pid,
+        startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+        status: "active"
+      },
+      null,
+      2
+    )
+  );
+  return {
+    browser,
+    context,
+    page,
+    debugPort,
+    metadataPath,
+    close: async () => {
+      await browser.close();
+    }
+  };
+}
+export {
+  launchBrowser
+};

package/dist/shared/state/index.cjs

@@ -0,0 +1,38 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var state_exports = {};
+__export(state_exports, {
+  SESSION_STATE_VERSION: () => import_session_state.SESSION_STATE_VERSION,
+  SessionStateFileSchema: () => import_session_state.SessionStateFileSchema,
+  SessionStatusSchema: () => import_session_state.SessionStatusSchema,
+  parseSessionStateContent: () => import_session_state.parseSessionStateContent,
+  parseSessionStateData: () => import_session_state.parseSessionStateData,
+  serializeSessionState: () => import_session_state.serializeSessionState
+});
+module.exports = __toCommonJS(state_exports);
+var import_session_state = require("./session-state.js");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SESSION_STATE_VERSION,
+  SessionStateFileSchema,
+  SessionStatusSchema,
+  parseSessionStateContent,
+  parseSessionStateData,
+  serializeSessionState
+});

package/dist/shared/state/index.d.cts

@@ -0,0 +1,2 @@
+export { SESSION_STATE_VERSION, SessionState, SessionStateFile, SessionStateFileSchema, SessionStatus, SessionStatusSchema, parseSessionStateContent, parseSessionStateData, serializeSessionState } from './session-state.cjs';
+import 'zod';

package/dist/shared/state/index.d.ts

@@ -0,0 +1,2 @@
+export { SESSION_STATE_VERSION, SessionState, SessionStateFile, SessionStateFileSchema, SessionStatus, SessionStatusSchema, parseSessionStateContent, parseSessionStateData, serializeSessionState } from './session-state.js';
+import 'zod';

package/dist/shared/state/index.js

@@ -0,0 +1,16 @@
+import {
+  SESSION_STATE_VERSION,
+  SessionStatusSchema,
+  SessionStateFileSchema,
+  parseSessionStateData,
+  parseSessionStateContent,
+  serializeSessionState
+} from "./session-state.js";
+export {
+  SESSION_STATE_VERSION,
+  SessionStateFileSchema,
+  SessionStatusSchema,
+  parseSessionStateContent,
+  parseSessionStateData,
+  serializeSessionState
+};

package/dist/shared/state/session-state.cjs

@@ -0,0 +1,85 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var session_state_exports = {};
+__export(session_state_exports, {
+  SESSION_STATE_VERSION: () => SESSION_STATE_VERSION,
+  SessionStateFileSchema: () => SessionStateFileSchema,
+  SessionStatusSchema: () => SessionStatusSchema,
+  parseSessionStateContent: () => parseSessionStateContent,
+  parseSessionStateData: () => parseSessionStateData,
+  serializeSessionState: () => serializeSessionState
+});
+module.exports = __toCommonJS(session_state_exports);
+var import_zod = require("zod");
+const SESSION_STATE_VERSION = 1;
+const SessionStatusSchema = import_zod.z.enum([
+  "active",
+  "paused",
+  "completed",
+  "failed",
+  "exited"
+]);
+const SessionStateFileSchema = import_zod.z.object({
+  version: import_zod.z.literal(SESSION_STATE_VERSION),
+  port: import_zod.z.number().int().min(0).max(65535),
+  pid: import_zod.z.number().int(),
+  session: import_zod.z.string().min(1),
+  startedAt: import_zod.z.string().datetime({ offset: true }),
+  status: SessionStatusSchema.optional()
+});
+function formatIssues(error) {
+  return error.issues.map((issue) => {
+    const path = issue.path.join(".") || "root";
+    return `${path}: ${issue.message}`;
+  }).join("; ");
+}
+function parseSessionStateData(rawState, source) {
+  const parsed = SessionStateFileSchema.safeParse(rawState);
+  if (!parsed.success) {
+    throw new Error(`Session state at ${source} is invalid: ${formatIssues(parsed.error)}`);
+  }
+  const { version: _version, ...state } = parsed.data;
+  return state;
+}
+function parseSessionStateContent(content, source) {
+  let rawState;
+  try {
+    rawState = JSON.parse(content);
+  } catch (error) {
+    throw new Error(
+      `Session state at ${source} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+  return parseSessionStateData(rawState, source);
+}
+function serializeSessionState(state) {
+  return SessionStateFileSchema.parse({
+    version: SESSION_STATE_VERSION,
+    ...state
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SESSION_STATE_VERSION,
+  SessionStateFileSchema,
+  SessionStatusSchema,
+  parseSessionStateContent,
+  parseSessionStateData,
+  serializeSessionState
+});

package/dist/shared/state/session-state.d.cts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+
+declare const SESSION_STATE_VERSION = 1;
+declare const SessionStatusSchema: z.ZodEnum<["active", "paused", "completed", "failed", "exited"]>;
+declare const SessionStateFileSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    port: z.ZodNumber;
+    pid: z.ZodNumber;
+    session: z.ZodString;
+    startedAt: z.ZodString;
+    status: z.ZodOptional<z.ZodEnum<["active", "paused", "completed", "failed", "exited"]>>;
+}, "strip", z.ZodTypeAny, {
+    version: 1;
+    port: number;
+    pid: number;
+    session: string;
+    startedAt: string;
+    status?: "completed" | "failed" | "paused" | "active" | "exited" | undefined;
+}, {
+    version: 1;
+    port: number;
+    pid: number;
+    session: string;
+    startedAt: string;
+    status?: "completed" | "failed" | "paused" | "active" | "exited" | undefined;
+}>;
+type SessionStatus = z.infer<typeof SessionStatusSchema>;
+type SessionStateFile = z.infer<typeof SessionStateFileSchema>;
+type SessionState = Omit<SessionStateFile, "version">;
+declare function parseSessionStateData(rawState: unknown, source: string): SessionState;
+declare function parseSessionStateContent(content: string, source: string): SessionState;
+declare function serializeSessionState(state: SessionState): SessionStateFile;
+
+export { SESSION_STATE_VERSION, type SessionState, type SessionStateFile, SessionStateFileSchema, type SessionStatus, SessionStatusSchema, parseSessionStateContent, parseSessionStateData, serializeSessionState };

package/dist/shared/state/session-state.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+
+declare const SESSION_STATE_VERSION = 1;
+declare const SessionStatusSchema: z.ZodEnum<["active", "paused", "completed", "failed", "exited"]>;
+declare const SessionStateFileSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    port: z.ZodNumber;
+    pid: z.ZodNumber;
+    session: z.ZodString;
+    startedAt: z.ZodString;
+    status: z.ZodOptional<z.ZodEnum<["active", "paused", "completed", "failed", "exited"]>>;
+}, "strip", z.ZodTypeAny, {
+    version: 1;
+    port: number;
+    pid: number;
+    session: string;
+    startedAt: string;
+    status?: "completed" | "failed" | "paused" | "active" | "exited" | undefined;
+}, {
+    version: 1;
+    port: number;
+    pid: number;
+    session: string;
+    startedAt: string;
+    status?: "completed" | "failed" | "paused" | "active" | "exited" | undefined;
+}>;
+type SessionStatus = z.infer<typeof SessionStatusSchema>;
+type SessionStateFile = z.infer<typeof SessionStateFileSchema>;
+type SessionState = Omit<SessionStateFile, "version">;
+declare function parseSessionStateData(rawState: unknown, source: string): SessionState;
+declare function parseSessionStateContent(content: string, source: string): SessionState;
+declare function serializeSessionState(state: SessionState): SessionStateFile;
+
+export { SESSION_STATE_VERSION, type SessionState, type SessionStateFile, SessionStateFileSchema, type SessionStatus, SessionStatusSchema, parseSessionStateContent, parseSessionStateData, serializeSessionState };

package/dist/shared/state/session-state.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+const SESSION_STATE_VERSION = 1;
+const SessionStatusSchema = z.enum([
+  "active",
+  "paused",
+  "completed",
+  "failed",
+  "exited"
+]);
+const SessionStateFileSchema = z.object({
+  version: z.literal(SESSION_STATE_VERSION),
+  port: z.number().int().min(0).max(65535),
+  pid: z.number().int(),
+  session: z.string().min(1),
+  startedAt: z.string().datetime({ offset: true }),
+  status: SessionStatusSchema.optional()
+});
+function formatIssues(error) {
+  return error.issues.map((issue) => {
+    const path = issue.path.join(".") || "root";
+    return `${path}: ${issue.message}`;
+  }).join("; ");
+}
+function parseSessionStateData(rawState, source) {
+  const parsed = SessionStateFileSchema.safeParse(rawState);
+  if (!parsed.success) {
+    throw new Error(`Session state at ${source} is invalid: ${formatIssues(parsed.error)}`);
+  }
+  const { version: _version, ...state } = parsed.data;
+  return state;
+}
+function parseSessionStateContent(content, source) {
+  let rawState;
+  try {
+    rawState = JSON.parse(content);
+  } catch (error) {
+    throw new Error(
+      `Session state at ${source} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+  return parseSessionStateData(rawState, source);
+}
+function serializeSessionState(state) {
+  return SessionStateFileSchema.parse({
+    version: SESSION_STATE_VERSION,
+    ...state
+  });
+}
+export {
+  SESSION_STATE_VERSION,
+  SessionStateFileSchema,
+  SessionStatusSchema,
+  parseSessionStateContent,
+  parseSessionStateData,
+  serializeSessionState
+};