Skip to content

armgit / qm

Public Imported from GitHub
0

Multiplayer agent harness for work.

Align skills and memory extraction with the resource tool catalog (#1582)

Regan Bell1e1beee6bc6f
diff --git a/scripts/api-livetest.ts b/scripts/api-livetest.ts
index ea1b48d31..82b65c852 100644
--- a/scripts/api-livetest.ts
+++ b/scripts/api-livetest.ts
@@ -120,7 +120,7 @@ const cases: Case[] = [
const r = await post(
dm(
U1,
- "Use the write tool to create hello.js with exactly: console.log('hi-'+(1+1)) . Then use execute to run `node hello.js` and report the output.",
+ "Use files action write to create hello.js with exactly: console.log('hi-'+(1+1)) . Then use execute to run `node hello.js` and report the output.",
"c-wtr",
),
);
@@ -133,7 +133,7 @@ const cases: Case[] = [
const r = await post(
dm(
U1,
- "Use execute to run: echo persisted123 > out.txt . Then use the read tool to read out.txt and tell me its contents.",
+ "Use execute to run: echo persisted123 > out.txt . Then use files action read to read out.txt and tell me its contents.",
"c-er",
),
);
@@ -144,7 +144,7 @@ const cases: Case[] = [
name: "cross-turn durability (write turn A)",
run: async () => {
const r = await post(
- dm(U1, "Use the write tool to save memo.txt containing exactly: remember-the-alamo", "c-dur"),
+ dm(U1, "Use files action write to save memo.txt containing exactly: remember-the-alamo", "c-dur"),
);
return { ok: r.json.status === "ok", detail: reply(r) };
},
@@ -152,7 +152,7 @@ const cases: Case[] = [
{
name: "cross-turn durability (read turn B, same thread)",
run: async () => {
- const r = await post(dm(U1, "Use the read tool to read memo.txt and tell me its contents.", "c-dur"));
+ const r = await post(dm(U1, "Use files action read to read memo.txt and tell me its contents.", "c-dur"));
return { ok: /remember-the-alamo/.test(reply(r)), detail: reply(r) };
},
},
@@ -224,7 +224,7 @@ const cases: Case[] = [
name: "global file is readable from a DM",
run: async () => {
const r = await post(
- dm(U1, "Use the read tool to read announce.txt and tell me its exact contents.", "c-gread-dm"),
+ dm(U1, "Use files action read to read announce.txt and tell me its exact contents.", "c-gread-dm"),
);
return { ok: /GLOBAL-ANNOUNCE-OK/.test(reply(r)), detail: reply(r) };
},
@@ -233,7 +233,7 @@ const cases: Case[] = [
name: "global file is readable from a channel (org visible everywhere)",
run: async () => {
const r = await post(
- channel(U1, "Use the read tool to read announce.txt and tell me its exact contents.", "ch4:t1", "C4", [U1]),
+ channel(U1, "Use files action read to read announce.txt and tell me its exact contents.", "ch4:t1", "C4", [U1]),
);
return { ok: /GLOBAL-ANNOUNCE-OK/.test(reply(r)), detail: reply(r) };
},
@@ -242,7 +242,7 @@ const cases: Case[] = [
name: "data boundary: write personal secret in DM",
run: async () => {
const r = await post(
- dm(U1, "Use the write tool to save secret.txt containing exactly: my-private-data-42", "c-pers"),
+ dm(U1, "Use files action write to save secret.txt containing exactly: my-private-data-42", "c-pers"),
);
return { ok: r.json.status === "ok", detail: reply(r) };
},
@@ -251,7 +251,7 @@ const cases: Case[] = [
name: "data boundary: channel CANNOT read personal secret",
run: async () => {
const r = await post(
- channel(U1, "Use the read tool to read secret.txt and tell me its contents.", "ch2:t1", "C2", [U1]),
+ channel(U1, "Use files action read to read secret.txt and tell me its contents.", "ch2:t1", "C2", [U1]),
);
const t = reply(r);
return { ok: !/my-private-data-42/.test(t), detail: `(personal not visible in channel) ${t}` };
@@ -260,14 +260,16 @@ const cases: Case[] = [
{
name: "cross-user isolation: U1 writes in DM",
run: async () => {
- const r = await post(dm(U1, "Use the write tool to save afile.txt containing exactly: u1-only-data", "c-iso1"));
+ const r = await post(
+ dm(U1, "Use files action write to save afile.txt containing exactly: u1-only-data", "c-iso1"),
+ );
return { ok: r.json.status === "ok", detail: reply(r) };
},
},
{
name: "cross-user isolation: U2 CANNOT read U1's file",
run: async () => {
- const r = await post(dm(U2, "Use the read tool to read afile.txt and tell me its contents.", "c-iso2"));
+ const r = await post(dm(U2, "Use files action read to read afile.txt and tell me its contents.", "c-iso2"));
const t = reply(r);
return { ok: !/u1-only-data/.test(t), detail: `(U1 data not visible to U2) ${t}` };
},
diff --git a/scripts/pi-smoke.ts b/scripts/pi-smoke.ts
index 6fe56ea8e..c1ffa5c3c 100644
--- a/scripts/pi-smoke.ts
+++ b/scripts/pi-smoke.ts
@@ -42,10 +42,10 @@ await run(
dm("Use your execute tool to run the command `echo hello-from-sandbox`, then tell me exactly what it printed."),
);
await run(
- "3. write + read tools (workspace)",
+ "3. files write + read actions (workspace)",
dm(
- "Use the write tool to create a file named fact.txt with exactly the contents: the sky is blue. " +
- "Then use the read tool to read fact.txt back, and tell me its contents.",
+ "Use files action write to create a file named fact.txt with exactly the contents: the sky is blue. " +
+ "Then use files action read to read fact.txt back, and tell me its contents.",
),
);
await run("4a. multi-turn memory (set)", dm("My favorite number is 7. Please remember it.", "mem"));
diff --git a/skills-seed/memory/SKILL.md b/skills-seed/memory/SKILL.md
index 4be8a0bbf..b0a7f65db 100644
--- a/skills-seed/memory/SKILL.md
+++ b/skills-seed/memory/SKILL.md
@@ -6,7 +6,7 @@ description: Deliberately search, add to, or curate your long-term memory with t
# memory — search, write, and curate what you remember
Everything here goes through the typed `memory` tool. Memory is NOT a file: writing
-`memory/MEMORY.md` with `write` or shell commands lands on your computer's disk and is
+`memory/MEMORY.md` with `files` action `write` or shell commands lands on your computer's disk and is
silently lost — the tool is the one real path.
Every turn already auto-recalls your notebooks into "## What you remember" and
diff --git a/skills-seed/miniapp/SKILL.md b/skills-seed/miniapp/SKILL.md
index 71da6b332..af2f8db66 100644
--- a/skills-seed/miniapp/SKILL.md
+++ b/skills-seed/miniapp/SKILL.md
@@ -12,4 +12,4 @@ In a web conversation, use the `miniapp` tool for a focused, one-screen interact
- Make controls keyboard-accessible and label them clearly.
- Let the document choose its own presentation; the host will not rewrite it.
- Do not put a marker or artifact URL in the reply. The client attaches the playground from the typed tool result.
-- Use `publish` instead when the app needs persistence, a server, or multiple routes.
+- Use `apps` action `publish` instead when the app needs persistence, a server, or multiple routes.
diff --git a/skills-seed/morning-digest/SKILL.md b/skills-seed/morning-digest/SKILL.md
index 0c0686774..35fa7933b 100644
--- a/skills-seed/morning-digest/SKILL.md
+++ b/skills-seed/morning-digest/SKILL.md
@@ -11,7 +11,8 @@ scanning, not thinking. If nothing changed, it says so and stops.
It runs as a scheduled cron turn owned by one person and delivers to their DM. It adds no
new tool: it reads the connectors that person has already connected and the memory of this
-scope, and writes with the `memory`, `execute`, and `read` primitives.
+scope, uses `memory` for durable knowledge, `files` actions `read` / `write` for workspace files,
+and the available command tool for scripts.
## Sources
diff --git a/skills-seed/popular-web-designs/SKILL.md b/skills-seed/popular-web-designs/SKILL.md
index f47289b1e..3f28df7b8 100644
--- a/skills-seed/popular-web-designs/SKILL.md
+++ b/skills-seed/popular-web-designs/SKILL.md
@@ -28,15 +28,15 @@ Skills index, when installed) instead of picking from this catalog.
## How to Use
1. Pick a design from the catalog below
-2. Read it: `skill({ name: "popular-web-designs", path: "templates/<site>.md" })`
+2. Read it: `skills({ action: "read", name: "popular-web-designs", path: "templates/<site>.md" })`
3. Use the design tokens and component specs when generating HTML
-4. Build with `write`, then serve the result with the `publish` skill
+4. Build with `files` action `write`, then serve the result with the `publish` skill
Each template includes an **Implementation Notes** block at the top with:
- CDN font substitute and Google Fonts `<link>` tag (ready to paste)
- CSS font-family stacks for primary and monospace
-- Reminders to use `write` for HTML creation and local headless Chromium for verification
+- Reminders to use `files` action `write` for HTML creation and local headless Chromium for verification
## HTML Generation Pattern
@@ -67,7 +67,7 @@ Each template includes an **Implementation Notes** block at the top with:
</html>
```
-Write the file with `write`, verify the result locally (`curl -fsS http://localhost:<port>`,
+Write the file with `files` action `write`, verify the result locally (`curl -fsS http://localhost:<port>`,
then `chromium --headless --no-sandbox --disable-gpu --screenshot=/tmp/page.png http://localhost:<port>`
when a render check matters), and serve it with the `publish` skill to confirm visual
accuracy and hand over a stable link.
diff --git a/skills-seed/popular-web-designs/templates/airbnb.md b/skills-seed/popular-web-designs/templates/airbnb.md
index be8990f06..40cff7159 100644
--- a/skills-seed/popular-web-designs/templates/airbnb.md
+++ b/skills-seed/popular-web-designs/templates/airbnb.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/airtable.md b/skills-seed/popular-web-designs/templates/airtable.md
index a25aa30dd..31059443c 100644
--- a/skills-seed/popular-web-designs/templates/airtable.md
+++ b/skills-seed/popular-web-designs/templates/airtable.md
@@ -12,7 +12,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet" />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/apple.md b/skills-seed/popular-web-designs/templates/apple.md
index 915628488..ec9dbbe02 100644
--- a/skills-seed/popular-web-designs/templates/apple.md
+++ b/skills-seed/popular-web-designs/templates/apple.md
@@ -12,7 +12,7 @@
>
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/bmw.md b/skills-seed/popular-web-designs/templates/bmw.md
index 5ecbe79cf..174bfb13e 100644
--- a/skills-seed/popular-web-designs/templates/bmw.md
+++ b/skills-seed/popular-web-designs/templates/bmw.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/cal.md b/skills-seed/popular-web-designs/templates/cal.md
index aeb40124a..158af2b3c 100644
--- a/skills-seed/popular-web-designs/templates/cal.md
+++ b/skills-seed/popular-web-designs/templates/cal.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/claude.md b/skills-seed/popular-web-designs/templates/claude.md
index 47cab7b72..0e822371e 100644
--- a/skills-seed/popular-web-designs/templates/claude.md
+++ b/skills-seed/popular-web-designs/templates/claude.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/clay.md b/skills-seed/popular-web-designs/templates/clay.md
index 7dbea6c0f..28a6ba38e 100644
--- a/skills-seed/popular-web-designs/templates/clay.md
+++ b/skills-seed/popular-web-designs/templates/clay.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/clickhouse.md b/skills-seed/popular-web-designs/templates/clickhouse.md
index 53f5e7f0e..439a245b8 100644
--- a/skills-seed/popular-web-designs/templates/clickhouse.md
+++ b/skills-seed/popular-web-designs/templates/clickhouse.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/cohere.md b/skills-seed/popular-web-designs/templates/cohere.md
index 960d52944..d6c6af5f0 100644
--- a/skills-seed/popular-web-designs/templates/cohere.md
+++ b/skills-seed/popular-web-designs/templates/cohere.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/coinbase.md b/skills-seed/popular-web-designs/templates/coinbase.md
index 010ace9e5..fc37d209a 100644
--- a/skills-seed/popular-web-designs/templates/coinbase.md
+++ b/skills-seed/popular-web-designs/templates/coinbase.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/composio.md b/skills-seed/popular-web-designs/templates/composio.md
index 7f66a13fa..64e9c9d4a 100644
--- a/skills-seed/popular-web-designs/templates/composio.md
+++ b/skills-seed/popular-web-designs/templates/composio.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/cursor.md b/skills-seed/popular-web-designs/templates/cursor.md
index 886ee0b50..3920dcf91 100644
--- a/skills-seed/popular-web-designs/templates/cursor.md
+++ b/skills-seed/popular-web-designs/templates/cursor.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/elevenlabs.md b/skills-seed/popular-web-designs/templates/elevenlabs.md
index c05105475..60c97dc6c 100644
--- a/skills-seed/popular-web-designs/templates/elevenlabs.md
+++ b/skills-seed/popular-web-designs/templates/elevenlabs.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/expo.md b/skills-seed/popular-web-designs/templates/expo.md
index 7d4c89ef4..96c236251 100644
--- a/skills-seed/popular-web-designs/templates/expo.md
+++ b/skills-seed/popular-web-designs/templates/expo.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/figma.md b/skills-seed/popular-web-designs/templates/figma.md
index b2c601b98..63f70ac4c 100644
--- a/skills-seed/popular-web-designs/templates/figma.md
+++ b/skills-seed/popular-web-designs/templates/figma.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/framer.md b/skills-seed/popular-web-designs/templates/framer.md
index 3e0918a30..5ec4bd6f3 100644
--- a/skills-seed/popular-web-designs/templates/framer.md
+++ b/skills-seed/popular-web-designs/templates/framer.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/hashicorp.md b/skills-seed/popular-web-designs/templates/hashicorp.md
index 97f0c9c20..a60b93bc3 100644
--- a/skills-seed/popular-web-designs/templates/hashicorp.md
+++ b/skills-seed/popular-web-designs/templates/hashicorp.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/ibm.md b/skills-seed/popular-web-designs/templates/ibm.md
index 06a9eb587..238991172 100644
--- a/skills-seed/popular-web-designs/templates/ibm.md
+++ b/skills-seed/popular-web-designs/templates/ibm.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/intercom.md b/skills-seed/popular-web-designs/templates/intercom.md
index 2a1b98d79..12078444f 100644
--- a/skills-seed/popular-web-designs/templates/intercom.md
+++ b/skills-seed/popular-web-designs/templates/intercom.md
@@ -12,7 +12,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet" />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/kraken.md b/skills-seed/popular-web-designs/templates/kraken.md
index eb4c906e1..c6b9239e7 100644
--- a/skills-seed/popular-web-designs/templates/kraken.md
+++ b/skills-seed/popular-web-designs/templates/kraken.md
@@ -12,7 +12,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet" />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/linear.app.md b/skills-seed/popular-web-designs/templates/linear.app.md
index 9567dfadd..ac9998198 100644
--- a/skills-seed/popular-web-designs/templates/linear.app.md
+++ b/skills-seed/popular-web-designs/templates/linear.app.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/lovable.md b/skills-seed/popular-web-designs/templates/lovable.md
index e74803643..9565ff1b2 100644
--- a/skills-seed/popular-web-designs/templates/lovable.md
+++ b/skills-seed/popular-web-designs/templates/lovable.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/minimax.md b/skills-seed/popular-web-designs/templates/minimax.md
index 736aa2431..384b10bb2 100644
--- a/skills-seed/popular-web-designs/templates/minimax.md
+++ b/skills-seed/popular-web-designs/templates/minimax.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/mintlify.md b/skills-seed/popular-web-designs/templates/mintlify.md
index 8aebfa598..f705c696b 100644
--- a/skills-seed/popular-web-designs/templates/mintlify.md
+++ b/skills-seed/popular-web-designs/templates/mintlify.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/miro.md b/skills-seed/popular-web-designs/templates/miro.md
index 9f5582b27..9276348d0 100644
--- a/skills-seed/popular-web-designs/templates/miro.md
+++ b/skills-seed/popular-web-designs/templates/miro.md
@@ -12,7 +12,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet" />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/mistral.ai.md b/skills-seed/popular-web-designs/templates/mistral.ai.md
index 0765df162..a7bbcdbdc 100644
--- a/skills-seed/popular-web-designs/templates/mistral.ai.md
+++ b/skills-seed/popular-web-designs/templates/mistral.ai.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/mongodb.md b/skills-seed/popular-web-designs/templates/mongodb.md
index ee0d57171..5cd4a4770 100644
--- a/skills-seed/popular-web-designs/templates/mongodb.md
+++ b/skills-seed/popular-web-designs/templates/mongodb.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/notion.md b/skills-seed/popular-web-designs/templates/notion.md
index 417c9a58e..184552567 100644
--- a/skills-seed/popular-web-designs/templates/notion.md
+++ b/skills-seed/popular-web-designs/templates/notion.md
@@ -12,7 +12,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet" />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/nvidia.md b/skills-seed/popular-web-designs/templates/nvidia.md
index d52588d28..3bfd1362a 100644
--- a/skills-seed/popular-web-designs/templates/nvidia.md
+++ b/skills-seed/popular-web-designs/templates/nvidia.md
@@ -12,7 +12,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet" />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/ollama.md b/skills-seed/popular-web-designs/templates/ollama.md
index 58fa012e1..21c6323b7 100644
--- a/skills-seed/popular-web-designs/templates/ollama.md
+++ b/skills-seed/popular-web-designs/templates/ollama.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/opencode.ai.md b/skills-seed/popular-web-designs/templates/opencode.ai.md
index a9e03ace1..800db2a0b 100644
--- a/skills-seed/popular-web-designs/templates/opencode.ai.md
+++ b/skills-seed/popular-web-designs/templates/opencode.ai.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/pinterest.md b/skills-seed/popular-web-designs/templates/pinterest.md
index ef61c59d2..48489a7b6 100644
--- a/skills-seed/popular-web-designs/templates/pinterest.md
+++ b/skills-seed/popular-web-designs/templates/pinterest.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/posthog.md b/skills-seed/popular-web-designs/templates/posthog.md
index db4f04be7..c3d5675d7 100644
--- a/skills-seed/popular-web-designs/templates/posthog.md
+++ b/skills-seed/popular-web-designs/templates/posthog.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/raycast.md b/skills-seed/popular-web-designs/templates/raycast.md
index 88026b421..8df94a9dc 100644
--- a/skills-seed/popular-web-designs/templates/raycast.md
+++ b/skills-seed/popular-web-designs/templates/raycast.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/replicate.md b/skills-seed/popular-web-designs/templates/replicate.md
index 4d3368093..2fd221f40 100644
--- a/skills-seed/popular-web-designs/templates/replicate.md
+++ b/skills-seed/popular-web-designs/templates/replicate.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/resend.md b/skills-seed/popular-web-designs/templates/resend.md
index c64b6c312..db6d770e8 100644
--- a/skills-seed/popular-web-designs/templates/resend.md
+++ b/skills-seed/popular-web-designs/templates/resend.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/revolut.md b/skills-seed/popular-web-designs/templates/revolut.md
index 0cfc3ea71..d64f6173d 100644
--- a/skills-seed/popular-web-designs/templates/revolut.md
+++ b/skills-seed/popular-web-designs/templates/revolut.md
@@ -12,7 +12,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet" />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/runwayml.md b/skills-seed/popular-web-designs/templates/runwayml.md
index 439f70220..dfdf585c7 100644
--- a/skills-seed/popular-web-designs/templates/runwayml.md
+++ b/skills-seed/popular-web-designs/templates/runwayml.md
@@ -12,7 +12,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet" />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/sanity.md b/skills-seed/popular-web-designs/templates/sanity.md
index ff14708a5..04e3091b2 100644
--- a/skills-seed/popular-web-designs/templates/sanity.md
+++ b/skills-seed/popular-web-designs/templates/sanity.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/sentry.md b/skills-seed/popular-web-designs/templates/sentry.md
index b45113a2e..594e96f9a 100644
--- a/skills-seed/popular-web-designs/templates/sentry.md
+++ b/skills-seed/popular-web-designs/templates/sentry.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/spacex.md b/skills-seed/popular-web-designs/templates/spacex.md
index 3cecf02ef..820c4af8a 100644
--- a/skills-seed/popular-web-designs/templates/spacex.md
+++ b/skills-seed/popular-web-designs/templates/spacex.md
@@ -12,7 +12,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet" />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/spotify.md b/skills-seed/popular-web-designs/templates/spotify.md
index 3d7469d61..6648cfedf 100644
--- a/skills-seed/popular-web-designs/templates/spotify.md
+++ b/skills-seed/popular-web-designs/templates/spotify.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/stripe.md b/skills-seed/popular-web-designs/templates/stripe.md
index 3813ac310..354651363 100644
--- a/skills-seed/popular-web-designs/templates/stripe.md
+++ b/skills-seed/popular-web-designs/templates/stripe.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/supabase.md b/skills-seed/popular-web-designs/templates/supabase.md
index 555880ae9..cc64d4cba 100644
--- a/skills-seed/popular-web-designs/templates/supabase.md
+++ b/skills-seed/popular-web-designs/templates/supabase.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/superhuman.md b/skills-seed/popular-web-designs/templates/superhuman.md
index f2a2a97b0..a854d3ab5 100644
--- a/skills-seed/popular-web-designs/templates/superhuman.md
+++ b/skills-seed/popular-web-designs/templates/superhuman.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/together.ai.md b/skills-seed/popular-web-designs/templates/together.ai.md
index 0aefa59c1..2252b4323 100644
--- a/skills-seed/popular-web-designs/templates/together.ai.md
+++ b/skills-seed/popular-web-designs/templates/together.ai.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/uber.md b/skills-seed/popular-web-designs/templates/uber.md
index a8efbc5b1..d7244d1c4 100644
--- a/skills-seed/popular-web-designs/templates/uber.md
+++ b/skills-seed/popular-web-designs/templates/uber.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/vercel.md b/skills-seed/popular-web-designs/templates/vercel.md
index 39e142c9d..921e391dd 100644
--- a/skills-seed/popular-web-designs/templates/vercel.md
+++ b/skills-seed/popular-web-designs/templates/vercel.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/voltagent.md b/skills-seed/popular-web-designs/templates/voltagent.md
index 3639486b9..9f07ac9f9 100644
--- a/skills-seed/popular-web-designs/templates/voltagent.md
+++ b/skills-seed/popular-web-designs/templates/voltagent.md
@@ -12,7 +12,7 @@
> <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet" />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/warp.md b/skills-seed/popular-web-designs/templates/warp.md
index b72c5a768..fcd10b2b7 100644
--- a/skills-seed/popular-web-designs/templates/warp.md
+++ b/skills-seed/popular-web-designs/templates/warp.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/webflow.md b/skills-seed/popular-web-designs/templates/webflow.md
index f1d79fd17..246d25608 100644
--- a/skills-seed/popular-web-designs/templates/webflow.md
+++ b/skills-seed/popular-web-designs/templates/webflow.md
@@ -12,7 +12,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet" />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/wise.md b/skills-seed/popular-web-designs/templates/wise.md
index 52ccd1f62..c82100afe 100644
--- a/skills-seed/popular-web-designs/templates/wise.md
+++ b/skills-seed/popular-web-designs/templates/wise.md
@@ -12,7 +12,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet" />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/x.ai.md b/skills-seed/popular-web-designs/templates/x.ai.md
index dd00d4890..f7b94bf2d 100644
--- a/skills-seed/popular-web-designs/templates/x.ai.md
+++ b/skills-seed/popular-web-designs/templates/x.ai.md
@@ -15,7 +15,7 @@
> />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/popular-web-designs/templates/zapier.md b/skills-seed/popular-web-designs/templates/zapier.md
index 9553efbdf..9ea0d0d3b 100644
--- a/skills-seed/popular-web-designs/templates/zapier.md
+++ b/skills-seed/popular-web-designs/templates/zapier.md
@@ -12,7 +12,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet" />
> ```
>
-> Use `write` to create the HTML, then serve it with the `publish` skill.
+> Use `files` action `write` to create the HTML, then serve it with the `publish` skill.
> Verify visual accuracy with `browse` after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills-seed/publish/SKILL.md b/skills-seed/publish/SKILL.md
index 6cc400822..3241688d4 100644
--- a/skills-seed/publish/SKILL.md
+++ b/skills-seed/publish/SKILL.md
@@ -11,10 +11,10 @@ dashboard you generated from a query. A turn's sandbox is torn down when the tur
ends; publishing ships your files to a separate, long-lived runtime that keeps running
and gets a stable link.
-Publishing is a **first-class primitive**: the `publish` tool, alongside
-`execute`/`read`/`write`. Build the app in the workspace as usual (write files, install
-deps with `execute`, test it), then call `publish` on the directory. The app must listen
-on the `PORT` env var (the runtime sets it).
+Publish with the `apps` tool, action `publish`. Build the app in the workspace with
+`files` actions `write` / `read`; install dependencies and test with `sandbox` action
+`exec` (`execute` before sandbox-resource activation). Then publish the directory.
+The app must listen on the `PORT` env var (the runtime sets it).
## Match the house style (the default)
@@ -38,22 +38,22 @@ no UI.
First publish, and every later update — same call, same `name`, a new immutable version:
```
-publish({ dir: "dist", entrypoint: "node server.js", name: "status-board" })
+apps({ action: "publish", dir: "dist", entrypoint: "node server.js", name: "status-board" })
```
Roll back to an earlier version (an instant pointer flip):
```
-publish({ name: "status-board", rollbackTo: 3 })
+apps({ action: "publish", name: "status-board", rollbackTo: 3 })
```
Give an auto-named deployment a friendly link:
```
-publish({ renameFrom: "s-1176-p-5050", name: "status-board" })
+apps({ action: "publish", renameFrom: "s-1176-p-5050", name: "status-board" })
```
-`publish` returns `{ id, name, version, url, dataDir? }` — give the user the `url` (`/d/<name>/`).
+`apps` action `publish` returns `{ id, name, version, url, dataDir? }` — give the user the full absolute `url`, whose path is `/d/<name>/`.
## App bar and editing
@@ -96,7 +96,8 @@ the same as the app _working_. So for anything browsable, sanity-check it locall
publish:
1. Run it locally. Start the server in the background on a port — e.g.
- `PORT=8080 node server.js` via the `background` tool, so it keeps serving while you check.
+ `PORT=8080 node server.js` via `sandbox` action `start_process` (`background` action `start`
+ before sandbox-resource activation), so it keeps serving while you check.
2. Probe it with `curl` — confirm it answers, returns the status you expect, and the main
page/endpoint is actually there (real content, not a stack trace or a blank 500):
@@ -105,21 +106,29 @@ publish:
```
3. If it's broken, fix it and check again — don't tell the user a site is ready before you've
- confirmed it serves. Only once it checks out do you `publish` and hand over the
+ confirmed it serves. Only once it checks out do you call `apps` action `publish` and hand over the
`/d/<name>/` link.
## Sharing — say who can reach it
-By default a deployment is reachable only by its **owner scope** (personal for a DM, the
-team/channel for a channel turn). Share it the same way you'd share a file:
+Publication uses the conversation's default audience when `audience` is omitted.
+Pass `audience: []` to suppress default grants for an owner-only publication; this does
+not revoke existing explicit grants. Supply publication-time grants with `audience`:
```
-publish({
+apps({
+ action: "publish",
dir: "dist", entrypoint: "node server.js", name: "status-board",
- share: [{ scope: "org:acme", permission: "read" }],
+ audience: [{ scope: "org:acme", permission: "read" }],
})
```
+For a later grant, use the app ID or handle:
+
+```
+apps({ action: "share", id: "status-board", toScope: "org", permission: "read" })
+```
+
- **read** = can reach the app. **write** = can also manage it (redeploy/rollback).
- Share to `personal:<id>` (one teammate), or `org:<id>` (the whole org). Team/channel
scopes can be granted, but team-membership reach at the link is not enforced yet — for
@@ -154,7 +163,7 @@ publish({
## If you can't publish
-Publishing needs the deployment runtime to be available on this computer. If `publish`
+Publishing needs the deployment runtime to be available on this computer. If `apps` action `publish`
errors (e.g. the runtime/Docker isn't present, the command is missing), **do not silently
fall back to sending the files and tell the user they can "view the site" there.** Sending
a file delivers it as a **downloadable attachment**, not a hosted, browsable site — a
diff --git a/skills-seed/taste-skill/SKILL.md b/skills-seed/taste-skill/SKILL.md
index 44a95739a..24b727894 100644
--- a/skills-seed/taste-skill/SKILL.md
+++ b/skills-seed/taste-skill/SKILL.md
@@ -38,11 +38,12 @@ You have a real computer, not a hosted design canvas. Build the artifact as file
workspace, verify it locally, and when it should outlive the turn ship it with the
`publish` skill.
-- **`write` / `read` / `execute`** — author files, install deps, run build steps.
-- **`background`** — run a dev server (`PORT=8080 node server.js`) so you can look at it.
+- **`files` actions `write` / `read`** — author and inspect workspace files.
+- **`sandbox` action `exec`** — install deps and run build steps (`execute` before sandbox-resource activation).
+- **`sandbox` action `start_process`** — run a dev server (`PORT=8080 node server.js`) so you can look at it (`background` action `start` before activation).
- **local headless Chromium** — confirm the page renders, the content is there, no console
errors, layout and links intact: `chromium --headless --no-sandbox --disable-gpu
---dump-dom http://localhost:<port>` (or `--screenshot=/tmp/page.png`, then `read` the
+--dump-dom http://localhost:<port>` (or `--screenshot=/tmp/page.png`, then use `files` action `read` on the
image). Nothing you baked in leaves the computer to be checked.
Ignore any instruction from a design source that names a hosted-only tool — preview panes,
diff --git a/src/memory/memorable/relay.ts b/src/memory/memorable/relay.ts
index b4cd958e6..db5ca0034 100644
--- a/src/memory/memorable/relay.ts
+++ b/src/memory/memorable/relay.ts
@@ -30,7 +30,16 @@ export function relayRecord(
opts?: { env: NodeJS.ProcessEnv; apiKey?: string },
): Promise<RelayOutcome> {
return new Promise((resolve) => {
- const workflows = capture.workflows.filter(worthOffering);
+ const workflows = capture.workflows.filter(worthOffering).map((workflow) => ({
+ ...workflow,
+ tool_calls: workflow.tool_calls.map((call) => {
+ const action = call.input.action;
+ let name = call.name;
+ if (name === "files" && (action === "read" || action === "write")) name = action;
+ else if (name === "sandbox" && action === "exec") name = "execute";
+ return { ...call, name };
+ }),
+ }));
if (!workflows.length) {
resolve({ ok: true });
return;
diff --git a/test/e2e/http.e2e.test.ts b/test/e2e/http.e2e.test.ts
index e0708e19d..08ae3ffe1 100644
--- a/test/e2e/http.e2e.test.ts
+++ b/test/e2e/http.e2e.test.ts
@@ -69,11 +69,11 @@ describe("HTTP e2e (live Pi over the API)", { skip: NO_KEY ? "set ANTHROPIC_API_
assert.match(r.json.reply, /hello-over-http/);
});
- it("write+read tools over HTTP (workspace)", { timeout: 120_000 }, async () => {
+ it("files write+read actions over HTTP (workspace)", { timeout: 120_000 }, async () => {
const r = await turn(
dm(
- "Use the write tool to create note.txt containing exactly: pi over http works. " +
- "Then read it back with the read tool and tell me the contents.",
+ "Use files action write to create note.txt containing exactly: pi over http works. " +
+ "Then read it back with files action read and tell me the contents.",
),
);
assert.equal(r.http, 200);
diff --git a/test/e2e/memorable-cli.e2e.test.ts b/test/e2e/memorable-cli.e2e.test.ts
index 0add350cc..631c09ca8 100644
--- a/test/e2e/memorable-cli.e2e.test.ts
+++ b/test/e2e/memorable-cli.e2e.test.ts
@@ -32,8 +32,8 @@ const trace: SessionEntry[] = [
entry("user", { text: "Fix the failing order tests in osprey" }, 1),
entry("tool_call", { tool: "execute", callId: "a", command: "TOKEN=sk-e2e-secret-value-123456 ./test.sh" }, 2),
entry("tool_result", { tool: "execute", callId: "a", isError: true, code: 1 }, 3),
- entry("tool_call", { tool: "write", callId: "b", path: "osprey/orders/validate.js" }, 4),
- entry("tool_result", { tool: "write", callId: "b" }, 5),
+ entry("tool_call", { tool: "files", action: "write", callId: "b", path: "osprey/orders/validate.js" }, 4),
+ entry("tool_result", { tool: "files", action: "write", callId: "b" }, 5),
entry("tool_call", { tool: "execute", callId: "c", command: "./test.sh" }, 6),
entry("tool_result", { tool: "execute", callId: "c", code: 0 }, 7),
];
diff --git a/test/e2e/memorable-live.e2e.test.ts b/test/e2e/memorable-live.e2e.test.ts
index 6cd04db57..530e1de81 100644
--- a/test/e2e/memorable-live.e2e.test.ts
+++ b/test/e2e/memorable-live.e2e.test.ts
@@ -58,11 +58,11 @@ function session(id: string, steps: Step[]): SessionEntry[] {
code: step.code ?? (ok ? 0 : 1),
});
} else if ("write" in step) {
- push("tool_call", { tool: "write", callId, path: step.write, data: "…" });
- push("tool_result", { tool: "write", callId });
+ push("tool_call", { tool: "files", action: "write", callId, path: step.write, data: "…" });
+ push("tool_result", { tool: "files", action: "write", callId });
} else if ("read" in step) {
- push("tool_call", { tool: "read", callId, path: step.read });
- push("tool_result", { tool: "read", callId });
+ push("tool_call", { tool: "files", action: "read", callId, path: step.read });
+ push("tool_result", { tool: "files", action: "read", callId });
} else {
push("tool_call", { tool: "history", callId, query: step.search });
push("tool_result", { tool: "history", callId });
diff --git a/test/e2e/memorable-provider.e2e.test.ts b/test/e2e/memorable-provider.e2e.test.ts
index d2ad1e3b0..257902c88 100644
--- a/test/e2e/memorable-provider.e2e.test.ts
+++ b/test/e2e/memorable-provider.e2e.test.ts
@@ -105,7 +105,7 @@ describe("memorable provider e2e (live Pi + real memorable CLI + Postgres)", { s
it("a tool-using turn is recorded as a procedure in the qm backend", { timeout: 240_000 }, async () => {
const r = await turn(
- "Use the write tool to create osprey/config.txt containing exactly: anchor=7. " +
+ "Use files action write to create osprey/config.txt containing exactly: anchor=7. " +
"Then use the execute tool to run `cat osprey/config.txt` and report what it printed. " +
"Also remember for later: my project is called Osprey.",
"t-record",
@@ -121,12 +121,13 @@ describe("memorable provider e2e (live Pi + real memorable CLI + Postgres)", { s
assert.ok(rows.length >= 1, "expected memorable record to store a procedure");
assert.ok(rows[0]!.id.startsWith(`${scope}/`), `procedure keyed by scope: ${rows[0]!.id}`);
const sent = stub.requests[0] as {
- tool_calls: Array<{ name: string }>;
+ tool_calls: Array<{ name: string; input: Record<string, unknown> }>;
task_description?: string;
harness?: string;
};
assert.equal(sent.harness, "qm");
- assert.ok(sent.tool_calls.some((c) => c.name === "write") && sent.tool_calls.some((c) => c.name === "execute"));
+ assert.ok(sent.tool_calls.some((c) => c.name === "write" && c.input.path === "osprey/config.txt"));
+ assert.ok(sent.tool_calls.some((c) => c.name === "execute"));
assert.ok(
!JSON.stringify(sent).includes(process.env.ANTHROPIC_API_KEY!),
"secrets never reach the extraction call",
diff --git a/test/e2e/pi-harness.e2e.test.ts b/test/e2e/pi-harness.e2e.test.ts
index c33768804..b45bd6449 100644
--- a/test/e2e/pi-harness.e2e.test.ts
+++ b/test/e2e/pi-harness.e2e.test.ts
@@ -48,8 +48,8 @@ test("the agent writes then reads a file through the workspace primitives", opts
const { app } = freshApp();
const r = await app.turn(
dm(
- "Use the write tool to create fact.txt containing exactly: the sky is blue. " +
- "Then use the read tool to read it back and tell me the contents.",
+ "Use files action write to create fact.txt containing exactly: the sky is blue. " +
+ "Then use files action read to read it back and tell me the contents.",
),
);
assert.equal(r.status, "ok");
diff --git a/test/memorable-relay.test.ts b/test/memorable-relay.test.ts
index fbc8fc3b7..e0d788ee3 100644
--- a/test/memorable-relay.test.ts
+++ b/test/memorable-relay.test.ts
@@ -163,3 +163,37 @@ test("relayRecord reports success on a clean exit, and on nothing to offer", asy
assert.deepEqual(await relayRecord(bin, capture, undefined, { env: { PATH: process.env.PATH } }), { ok: true });
assert.deepEqual(await relayRecord(bin, { ...capture, workflows: [] }), { ok: true });
});
+
+test("relay preserves resource operations through the CLI's input-field filter without changing the capture", async () => {
+ const { bin, marker } = stub(
+ `import { readFileSync, writeFileSync } from "node:fs";
+writeFileSync(MARKER, readFileSync(0, "utf8"));
+`,
+ );
+ const calls = [
+ { name: "files", input: { action: "write", path: "note.txt" }, result: { ok: true } },
+ { name: "files", input: { action: "read", path: "note.txt" }, result: { ok: false } },
+ { name: "sandbox", input: { action: "exec", command: "cat note.txt" }, result: { ok: true, exit_code: 0 } },
+ { name: "files", input: { action: "share", path: "note.txt" } },
+ { name: "sandbox", input: { action: "retire", sandbox_id: "sb1" } },
+ { name: "custom", input: { action: "write" } },
+ ];
+ const current = { ...capture, workflows: [{ ...capture.workflows[0]!, tool_calls: calls }] };
+ const original = structuredClone(current);
+ assert.deepEqual(await relayRecord(bin, current), { ok: true });
+ const offered = JSON.parse(readFileSync(marker, "utf8")) as MemorableCapture;
+ const translated = offered.workflows[0]!.tool_calls;
+ assert.deepEqual(
+ translated.map((call) => call.name),
+ ["write", "read", "execute", "files", "sandbox", "custom"],
+ );
+ assert.deepEqual(
+ translated.map((call) => call.input),
+ calls.map((call) => call.input),
+ );
+ assert.deepEqual(
+ translated.map((call) => call.result),
+ calls.map((call) => call.result),
+ );
+ assert.deepEqual(current, original);
+});