libretto 0.2.0 → 0.2.2

package/dist/shared/llm/types.d.cts

@@ -1,4 +1,4 @@
-import { ZodType, infer } from 'zod';
+import z from 'zod';
 
 type MessageContentPart = {
     type: "text";
@@ -19,16 +19,16 @@ type Message = {
  * recovery agents, and error detection.
  */
 interface LLMClient {
-    generateObject<T extends ZodType>(opts: {
+    generateObject<T extends z.ZodType>(opts: {
         prompt: string;
         schema: T;
         temperature?: number;
-    }): Promise<infer<T>>;
-    generateObjectFromMessages<T extends ZodType>(opts: {
+    }): Promise<z.infer<T>>;
+    generateObjectFromMessages<T extends z.ZodType>(opts: {
         messages: Message[];
         schema: T;
         temperature?: number;
-    }): Promise<infer<T>>;
+    }): Promise<z.infer<T>>;
 }
 
 export type { LLMClient, Message, MessageContentPart };

package/dist/shared/llm/types.d.ts

@@ -1,4 +1,4 @@
-import { ZodType, infer } from 'zod';
+import z from 'zod';
 
 type MessageContentPart = {
     type: "text";
@@ -19,16 +19,16 @@ type Message = {
  * recovery agents, and error detection.
  */
 interface LLMClient {
-    generateObject<T extends ZodType>(opts: {
+    generateObject<T extends z.ZodType>(opts: {
         prompt: string;
         schema: T;
         temperature?: number;
-    }): Promise<infer<T>>;
-    generateObjectFromMessages<T extends ZodType>(opts: {
+    }): Promise<z.infer<T>>;
+    generateObjectFromMessages<T extends z.ZodType>(opts: {
         messages: Message[];
         schema: T;
         temperature?: number;
-    }): Promise<infer<T>>;
+    }): Promise<z.infer<T>>;
 }
 
 export type { LLMClient, Message, MessageContentPart };

package/dist/shared/logger/index.cjs

@@ -20,6 +20,7 @@ var logger_exports = {};
 __export(logger_exports, {
   Logger: () => import_logger.Logger,
   createFileLogSink: () => import_sinks.createFileLogSink,
+  defaultLogger: () => import_logger.defaultLogger,
   jsonlConsoleSink: () => import_sinks.jsonlConsoleSink,
   prettyConsoleSink: () => import_sinks.prettyConsoleSink
 });
@@ -30,6 +31,7 @@ var import_sinks = require("./sinks.js");
 0 && (module.exports = {
   Logger,
   createFileLogSink,
+  defaultLogger,
   jsonlConsoleSink,
   prettyConsoleSink
 });

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

@@ -1,2 +1,2 @@
-export { LogOptions, Logger, LoggerApi, LoggerSink } from './logger.cjs';
+export { LogOptions, Logger, LoggerApi, LoggerSink, MinimalLogger, defaultLogger } from './logger.cjs';
 export { createFileLogSink, jsonlConsoleSink, prettyConsoleSink } from './sinks.cjs';

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

@@ -1,2 +1,2 @@
-export { LogOptions, Logger, LoggerApi, LoggerSink } from './logger.js';
+export { LogOptions, Logger, LoggerApi, LoggerSink, MinimalLogger, defaultLogger } from './logger.js';
 export { createFileLogSink, jsonlConsoleSink, prettyConsoleSink } from './sinks.js';

package/dist/shared/logger/index.js

@@ -1,4 +1,4 @@
-import { Logger } from "./logger.js";
+import { Logger, defaultLogger } from "./logger.js";
 import {
   createFileLogSink,
   prettyConsoleSink,
@@ -7,6 +7,7 @@ import {
 export {
   Logger,
   createFileLogSink,
+  defaultLogger,
   jsonlConsoleSink,
   prettyConsoleSink
 };

package/dist/shared/logger/logger.cjs

@@ -18,12 +18,24 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var logger_exports = {};
 __export(logger_exports, {
-  Logger: () => Logger
+  Logger: () => Logger,
+  defaultLogger: () => defaultLogger
 });
 module.exports = __toCommonJS(logger_exports);
 function generateId() {
   return Math.random().toString(36).substring(2, 15);
 }
+const defaultLogger = {
+  info(event, data) {
+    console.log(`[INFO] ${event}`, data ?? "");
+  },
+  warn(event, data) {
+    console.warn(`[WARN] ${event}`, data ?? "");
+  },
+  error(event, data) {
+    console.error(`[ERROR] ${event}`, data ?? "");
+  }
+};
 const sinkLifecycleState = /* @__PURE__ */ new WeakMap();
 function getSinkLifecycleState(sink) {
   const existingState = sinkLifecycleState.get(sink);
@@ -196,5 +208,6 @@ class Logger {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  Logger
+  Logger,
+  defaultLogger
 });

package/dist/shared/logger/logger.d.cts

@@ -1,6 +1,18 @@
 type LogOptions = {
     timestamp?: Date;
 };
+/**
+ * Minimal logger interface accepted by public-facing runtime functions.
+ * Any logger with info/warn/error methods satisfies this — no need to
+ * implement withScope, withContext, flush, etc.
+ */
+type MinimalLogger = {
+    info: (event: string, data?: Record<string, any>) => void;
+    warn: (event: string, data?: any) => void;
+    error: (event: string, data?: any) => any;
+};
+/** Default console logger used when callers omit the logger option. */
+declare const defaultLogger: MinimalLogger;
 type LoggerApi = {
     log: (event: string, data?: Record<string, any>, options?: LogOptions) => void;
     /**
@@ -67,4 +79,4 @@ declare class Logger implements LoggerApi {
     close(): Promise<void>;
 }
 
-export { type LogOptions, Logger, type LoggerApi, type LoggerSink };
+export { type LogOptions, Logger, type LoggerApi, type LoggerSink, type MinimalLogger, defaultLogger };

package/dist/shared/logger/logger.d.ts

@@ -1,6 +1,18 @@
 type LogOptions = {
     timestamp?: Date;
 };
+/**
+ * Minimal logger interface accepted by public-facing runtime functions.
+ * Any logger with info/warn/error methods satisfies this — no need to
+ * implement withScope, withContext, flush, etc.
+ */
+type MinimalLogger = {
+    info: (event: string, data?: Record<string, any>) => void;
+    warn: (event: string, data?: any) => void;
+    error: (event: string, data?: any) => any;
+};
+/** Default console logger used when callers omit the logger option. */
+declare const defaultLogger: MinimalLogger;
 type LoggerApi = {
     log: (event: string, data?: Record<string, any>, options?: LogOptions) => void;
     /**
@@ -67,4 +79,4 @@ declare class Logger implements LoggerApi {
     close(): Promise<void>;
 }
 
-export { type LogOptions, Logger, type LoggerApi, type LoggerSink };
+export { type LogOptions, Logger, type LoggerApi, type LoggerSink, type MinimalLogger, defaultLogger };

package/dist/shared/logger/logger.js

@@ -1,6 +1,17 @@
 function generateId() {
   return Math.random().toString(36).substring(2, 15);
 }
+const defaultLogger = {
+  info(event, data) {
+    console.log(`[INFO] ${event}`, data ?? "");
+  },
+  warn(event, data) {
+    console.warn(`[WARN] ${event}`, data ?? "");
+  },
+  error(event, data) {
+    console.error(`[ERROR] ${event}`, data ?? "");
+  }
+};
 const sinkLifecycleState = /* @__PURE__ */ new WeakMap();
 function getSinkLifecycleState(sink) {
   const existingState = sinkLifecycleState.get(sink);
@@ -172,5 +183,6 @@ class Logger {
   }
 }
 export {
-  Logger
+  Logger,
+  defaultLogger
 };

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

@@ -15,14 +15,14 @@ declare const SessionStateFileSchema: z.ZodObject<{
     pid: number;
     session: string;
     startedAt: string;
-    status?: "completed" | "failed" | "paused" | "active" | "exited" | undefined;
+    status?: "active" | "paused" | "completed" | "failed" | "exited" | undefined;
 }, {
     version: 1;
     port: number;
     pid: number;
     session: string;
     startedAt: string;
-    status?: "completed" | "failed" | "paused" | "active" | "exited" | undefined;
+    status?: "active" | "paused" | "completed" | "failed" | "exited" | undefined;
 }>;
 type SessionStatus = z.infer<typeof SessionStatusSchema>;
 type SessionStateFile = z.infer<typeof SessionStateFileSchema>;

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

@@ -15,14 +15,14 @@ declare const SessionStateFileSchema: z.ZodObject<{
     pid: number;
     session: string;
     startedAt: string;
-    status?: "completed" | "failed" | "paused" | "active" | "exited" | undefined;
+    status?: "active" | "paused" | "completed" | "failed" | "exited" | undefined;
 }, {
     version: 1;
     port: number;
     pid: number;
     session: string;
     startedAt: string;
-    status?: "completed" | "failed" | "paused" | "active" | "exited" | undefined;
+    status?: "active" | "paused" | "completed" | "failed" | "exited" | undefined;
 }>;
 type SessionStatus = z.infer<typeof SessionStatusSchema>;
 type SessionStateFile = z.infer<typeof SessionStateFileSchema>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libretto",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "AI-powered browser automation library and CLI built on Playwright",
   "license": "MIT",
   "repository": {
@@ -13,7 +13,9 @@
   },
   "files": [
     "dist",
-    "bin"
+    "bin",
+    "scripts",
+    "skill"
   ],
   "bin": {
     "libretto": "./bin/libretto.mjs",
@@ -25,11 +27,6 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
-    "./step": {
-      "types": "./dist/runtime/step/index.d.ts",
-      "import": "./dist/runtime/step/index.js",
-      "require": "./dist/runtime/step/index.cjs"
-    },
     "./logger": {
       "types": "./dist/shared/logger/index.d.ts",
       "import": "./dist/shared/logger/index.js",
@@ -98,7 +95,7 @@
     "build:cli": "tsup --config tsup.cli.config.ts",
     "type-check": "tsc --noEmit",
     "dev": "tsx src/cli/index.ts",
-    "test": "vitest run",
+    "test": "pnpm run build && vitest run",
     "test:watch": "vitest"
   },
   "peerDependencies": {
@@ -108,9 +105,15 @@
     "zod": ">=3.0.0"
   },
   "peerDependenciesMeta": {
-    "@ai-sdk/anthropic": { "optional": true },
-    "@ai-sdk/google-vertex": { "optional": true },
-    "@ai-sdk/openai": { "optional": true }
+    "@ai-sdk/anthropic": {
+      "optional": true
+    },
+    "@ai-sdk/google-vertex": {
+      "optional": true
+    },
+    "@ai-sdk/openai": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@ai-sdk/anthropic": "^3.0.53",
@@ -118,6 +121,7 @@
     "@ai-sdk/openai": "^3.0.39",
     "@types/node": "^25.3.3",
     "@types/yargs": "^17.0.33",
+    "openai": "^6.27.0",
     "tsup": "^8.0.0",
     "tsx": "^4.19.2",
     "typescript": "^5.7.0",

package/scripts/postinstall.mjs

@@ -0,0 +1,48 @@
+import { cpSync, existsSync, lstatSync, mkdirSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+function isDirectory(path) {
+	if (!existsSync(path)) return false;
+	return lstatSync(path).isDirectory();
+}
+
+function log(message) {
+	console.log(`[libretto postinstall] ${message}`);
+}
+
+function main() {
+	const packageDir = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+	const initCwd = process.env.INIT_CWD ? resolve(process.env.INIT_CWD) : null;
+	const installRoot = initCwd ?? process.cwd();
+
+	const sourceSkillDir = join(packageDir, "skill");
+	if (!isDirectory(sourceSkillDir)) {
+		log(`Skipped: source skill directory not found at "${sourceSkillDir}".`);
+		return;
+	}
+
+	const targets = [
+		join(installRoot, ".agents", "skills"),
+		join(installRoot, ".claude", "skills"),
+	];
+
+	for (const skillsRoot of targets) {
+		if (!isDirectory(skillsRoot)) {
+			log(`Skipped: "${skillsRoot}" does not exist.`);
+			continue;
+		}
+
+		const destinationSkillDir = join(skillsRoot, "libretto");
+		mkdirSync(destinationSkillDir, { recursive: true });
+		cpSync(sourceSkillDir, destinationSkillDir, { recursive: true, force: true });
+		log(`Synced skill "libretto" to "${skillsRoot}/libretto".`);
+	}
+}
+
+try {
+	main();
+} catch (error) {
+	const message = error instanceof Error ? error.message : String(error);
+	console.warn(`[libretto postinstall] Warning: ${message}`);
+}