libretto 0.6.27 → 0.6.28

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. package/docs/releasing.md +9 -6
  2. package/package.json +5 -2
  3. package/skills/libretto/SKILL.md +3 -12
  4. package/skills/libretto/references/shipped-source-and-documentation.md +13 -0
  5. package/skills/libretto-readonly/SKILL.md +1 -1
package/docs/releasing.md CHANGED
@@ -66,10 +66,13 @@ The root `scripts/prepare-release.sh` script does the following:
66
66
  1. Checks that the working tree is clean.
67
67
  2. Updates local `main` from `origin/main`.
68
68
  3. Runs `pnpm install --frozen-lockfile`, `pnpm --filter libretto type-check`, and `pnpm --filter libretto test`.
69
- 4. Bumps the version in `packages/libretto/package.json`.
70
- 5. Creates a release branch.
71
- 6. Commits the version bump.
72
- 7. Pushes the branch and opens a PR to `main` with the `release` label.
69
+ 4. Checks whether `packages/affordance` changed since the current Libretto release tag. If it changed, the script runs Affordance type-check/tests and bumps `packages/affordance/package.json` by one patch version when the current Affordance version is already published to npm.
70
+ 5. Bumps the version in `packages/libretto/package.json`.
71
+ 6. Creates a release branch.
72
+ 7. Commits the version bump.
73
+ 8. Pushes the branch and opens a PR to `main` with the `release` label.
74
+
75
+ Affordance is published before Libretto in `.github/workflows/release.yml`. Keeping this automatic patch bump in the release PR prevents Libretto from depending on unpublished Affordance APIs while still avoiding unnecessary Affordance releases when its package contents did not change.
73
76
 
74
77
  Release PRs also run the eval workflow. That workflow records score, duration, token, cost, and tool-call metrics for review. Scores are informational: low scores do not fail the workflow, but setup/runtime failures and zero completed records do.
75
78
 
@@ -80,12 +83,12 @@ After the release PR merges, `.github/workflows/release.yml` runs on `main`.
80
83
  The workflow:
81
84
 
82
85
  1. Reads the version from `packages/libretto/package.json`.
83
- 2. Checks whether that version already exists on npm and in GitHub Releases.
86
+ 2. Checks whether that version already exists on npm and in GitHub Releases. It also checks whether the current `packages/affordance/package.json` version and matching `create-libretto` version already exist on npm.
84
87
  3. Runs install, type-check, and tests for the `libretto` package in a verification job.
85
88
  4. Publishes `affordance` first, then `libretto@X.Y.Z`, then `create-libretto@X.Y.Z` with trusted publishing.
86
89
  5. Creates GitHub release `vX.Y.Z` with generated release notes if it does not already exist.
87
90
 
88
- This makes the workflow safe to re-run after partial failures. For example, if npm publish succeeds but GitHub release creation fails, a re-run will skip npm and only create the missing release.
91
+ This makes the workflow safe to re-run after partial failures. For example, if npm publish succeeds but GitHub release creation fails, a re-run will skip npm and only create the missing release. It also means Affordance can still be published if its version is missing even when the Libretto npm package and GitHub release for the current Libretto version already exist.
89
92
 
90
93
  ## Eval gating on release PRs
91
94
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "libretto",
3
- "version": "0.6.27",
3
+ "version": "0.6.28",
4
4
  "description": "AI-powered browser automation library and CLI built on Playwright",
5
5
  "license": "MIT",
6
6
  "homepage": "https://libretto.sh",
@@ -8,6 +8,9 @@
8
8
  "type": "git",
9
9
  "url": "https://github.com/saffron-health/libretto"
10
10
  },
11
+ "bugs": {
12
+ "url": "https://github.com/saffron-health/libretto/issues"
13
+ },
11
14
  "type": "module",
12
15
  "publishConfig": {
13
16
  "access": "public"
@@ -67,7 +70,7 @@
67
70
  "playwright": "^1.58.2",
68
71
  "tsx": "^4.21.0",
69
72
  "zod": "^4.3.6",
70
- "affordance": "^0.2.0"
73
+ "affordance": "^0.2.1"
71
74
  },
72
75
  "scripts": {
73
76
  "sync:mirrors": "node ../dev-tools/scripts/sync-mirrors.mjs",
package/skills/libretto/SKILL.md CHANGED
@@ -4,7 +4,7 @@ description: "Browser automation CLI for building, maintaining, and running brow
4
4
  license: MIT
5
5
  metadata:
6
6
  author: saffron-health
7
- version: "0.6.27"
7
+ version: "0.6.28"
8
8
  ---
9
9
 
10
10
  ## How Libretto Works
@@ -15,17 +15,7 @@ metadata:
15
15
 
16
16
  ## Shipped Source & Documentation
17
17
 
18
- The npm package includes `src/` (full TypeScript source) and `docs/` for deeper understanding of internals and design decisions. Read these when you need implementation context beyond what this skill file covers. Resolve paths from the package root (e.g. `node_modules/libretto/`).
19
-
20
- Full documentation is published at [libretto.sh](https://libretto.sh). Available pages:
21
-
22
- - Get started: [quickstart](https://libretto.sh/docs/get-started/quickstart), [first workflow](https://libretto.sh/docs/get-started/first-workflow), [deploying](https://libretto.sh/docs/get-started/deploying)
23
- - Fundamentals: [core concepts](https://libretto.sh/docs/understand-libretto/core-concepts), [how workflow generation works](https://libretto.sh/docs/understand-libretto/how-workflow-generation-works), [automation and bot detection](https://libretto.sh/docs/understand-libretto/automation-and-bot-detection), [website authentication](https://libretto.sh/docs/understand-libretto/website-authentication)
24
- - Workflow guides: [one-shot generation](https://libretto.sh/docs/guides/one-shot-workflow-generation), [interactive building](https://libretto.sh/docs/guides/interactive-workflow-building), [debugging workflows](https://libretto.sh/docs/guides/debugging-workflows), [convert to network requests](https://libretto.sh/docs/guides/convert-to-network-requests)
25
- - CLI reference: [open and connect](https://libretto.sh/docs/reference/cli/open-and-connect), [sessions](https://libretto.sh/docs/reference/cli/sessions), [profiles](https://libretto.sh/docs/reference/cli/profiles), [snapshot](https://libretto.sh/docs/reference/cli/snapshot), [exec](https://libretto.sh/docs/reference/cli/exec), [run and resume](https://libretto.sh/docs/reference/cli/run-and-resume), [session logs](https://libretto.sh/docs/reference/cli/session-logs), [pages](https://libretto.sh/docs/reference/cli/pages)
26
- - Library API: [workflow](https://libretto.sh/docs/reference/runtime/workflow), [network requests](https://libretto.sh/docs/reference/runtime/network-requests), [file downloads](https://libretto.sh/docs/reference/runtime/file-downloads)
27
- - Libretto Cloud Hosting: [overview](https://libretto.sh/docs/libretto-cloud-hosting/overview), [authentication](https://libretto.sh/docs/libretto-cloud-hosting/authentication), [deployments](https://libretto.sh/docs/libretto-cloud-hosting/deployments), [stealth](https://libretto.sh/docs/libretto-cloud-hosting/stealth)
28
- - Alternative providers: [overview](https://libretto.sh/docs/alternative-providers/overview), [Kernel](https://libretto.sh/docs/alternative-providers/kernel), [Browserbase](https://libretto.sh/docs/alternative-providers/browserbase), [Steel](https://libretto.sh/docs/alternative-providers/steel), [GCP](https://libretto.sh/docs/alternative-providers/gcp), [AWS](https://libretto.sh/docs/alternative-providers/aws)
18
+ Read `references/shipped-source-and-documentation.md` for shipped source details, published documentation links, and implementation context beyond what this skill file covers.
29
19
 
30
20
  ## Default Integration Approach
31
21
 
@@ -48,6 +38,7 @@ Prefer to enter sites at a user-facing URL (homepage, login, etc.) on the first
48
38
  - Use the package manager convention for the target project. The examples use `npx libretto`; pnpm, yarn, and bun projects should use their equivalent package-manager execution form.
49
39
  - Use `npx libretto setup` for first-time workspace onboarding. It installs Chromium and syncs skills.
50
40
  - Use `npx libretto status` to inspect open sessions without triggering setup.
41
+ - Use `npx libretto update` to upgrade the project-local Libretto package. Use `npx libretto update --dry-run` to preview the package-manager command first.
51
42
 
52
43
  ## Experiments
53
44
 
package/skills/libretto/references/shipped-source-and-documentation.md ADDED
@@ -0,0 +1,13 @@
1
+ # Shipped Source & Documentation
2
+
3
+ The npm package includes `src/` (full TypeScript source) and `docs/` for deeper understanding of internals and design decisions. Resolve paths from the package root, such as `node_modules/libretto/`.
4
+
5
+ Full documentation is published at [libretto.sh](https://libretto.sh). Available pages:
6
+
7
+ - Get started: [quickstart](https://libretto.sh/docs/get-started/quickstart), [first workflow](https://libretto.sh/docs/get-started/first-workflow), [deploying](https://libretto.sh/docs/get-started/deploying)
8
+ - Fundamentals: [core concepts](https://libretto.sh/docs/understand-libretto/core-concepts), [how workflow generation works](https://libretto.sh/docs/understand-libretto/how-workflow-generation-works), [automation and bot detection](https://libretto.sh/docs/understand-libretto/automation-and-bot-detection), [website authentication](https://libretto.sh/docs/understand-libretto/website-authentication)
9
+ - Workflow guides: [one-shot generation](https://libretto.sh/docs/guides/one-shot-workflow-generation), [interactive building](https://libretto.sh/docs/guides/interactive-workflow-building), [debugging workflows](https://libretto.sh/docs/guides/debugging-workflows), [convert to network requests](https://libretto.sh/docs/guides/convert-to-network-requests)
10
+ - CLI reference: [open and connect](https://libretto.sh/docs/reference/cli/open-and-connect), [sessions](https://libretto.sh/docs/reference/cli/sessions), [profiles](https://libretto.sh/docs/reference/cli/profiles), [snapshot](https://libretto.sh/docs/reference/cli/snapshot), [exec](https://libretto.sh/docs/reference/cli/exec), [run and resume](https://libretto.sh/docs/reference/cli/run-and-resume), [session logs](https://libretto.sh/docs/reference/cli/session-logs), [pages](https://libretto.sh/docs/reference/cli/pages)
11
+ - Library API: [workflow](https://libretto.sh/docs/reference/runtime/workflow), [network requests](https://libretto.sh/docs/reference/runtime/network-requests), [file downloads](https://libretto.sh/docs/reference/runtime/file-downloads)
12
+ - Libretto Cloud Hosting: [overview](https://libretto.sh/docs/libretto-cloud-hosting/overview), [authentication](https://libretto.sh/docs/libretto-cloud-hosting/authentication), [deployments](https://libretto.sh/docs/libretto-cloud-hosting/deployments), [stealth](https://libretto.sh/docs/libretto-cloud-hosting/stealth)
13
+ - Alternative providers: [overview](https://libretto.sh/docs/alternative-providers/overview), [Kernel](https://libretto.sh/docs/alternative-providers/kernel), [Browserbase](https://libretto.sh/docs/alternative-providers/browserbase), [Steel](https://libretto.sh/docs/alternative-providers/steel), [GCP](https://libretto.sh/docs/alternative-providers/gcp), [AWS](https://libretto.sh/docs/alternative-providers/aws)
package/skills/libretto-readonly/SKILL.md CHANGED
@@ -4,7 +4,7 @@ description: "Read-only Libretto workflow for diagnosing live browser state with
4
4
  license: MIT
5
5
  metadata:
6
6
  author: saffron-health
7
- version: "0.6.27"
7
+ version: "0.6.28"
8
8
  ---
9
9
 
10
10
  ## How Libretto Read-Only Works