@fungi.computer/oyster 0.55.0 → 0.56.0
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.
- package/dist/boot-host-script.js +1 -1
- package/dist/build/candidate-cli.mjs +2 -0
- package/dist/embed-metafiles.js +2 -2
- package/dist/page-script.js +2 -2
- package/dist/platform-skills.generated.d.ts +1 -1
- package/dist/platform-skills.generated.js +1 -1
- package/docs/api/apps.md +5 -5
- package/docs/api/build.md +25 -25
- package/docs/api/host.md +35 -32
- package/package.json +17 -17
|
@@ -10,5 +10,5 @@ export declare const platformSkillFiles: readonly [{
|
|
|
10
10
|
readonly content: "---\nname: fungible-computing\ndescription:\n Change how you work on this Agent's Computer. Edit your standing instructions\n and voice, add a skill of your own, or replace a built-in skill. Use when\n asked to remember a rule for every conversation, change your tone, or teach\n yourself a repeatable task, or install a missing Computer toolchain or agent\n CLI.\n---\n\n# Fungible computing\n\nYour standing instructions and your skills are files on a Computer. You and your\nowner can both change them.\n\n## Computer tools\n\nOn a hosted Fungi Computer, if go, rust or an agent CLI is missing, run\n`fungi-tools install <tool>` through that Computer's exec operation. Select\n`go`, `rust` (for rustc and cargo), `claude`, `codex`, `opencode` or `pi`. Go\nand Rust persist in that Computer's home. Agent CLIs live in a cache that is\ncleared when the Computer sleeps; after a wake their first use reinstalls the\nsame pinned version and prints `installing <tool> (one-time after wake)`. A\nfailed install is an error to report, not a reason to fetch an unpinned\ninstaller. This command does not supply provider keys or sign the CLI in.\nMember-attached machines use their own installed tools.\n\n## Instructions and voice\n\n- `AGENTS.md` on Home holds standing instructions. `SYSTEM.md` on Home holds\n your voice. Both are read at the start of each run, so an edit applies from\n the next run.\n- Together the two files may hold 32,000 bytes. A file over the limit is not\n loaded.\n- Follow them unless they conflict with the instructions the host gave you\n first. They never grant a tool, an approval or access.\n- Your Home prompt section names where they are; read and edit them there.\n- Only a person changes Home, with `/home <name>`. Ask them when no Home is\n available.\n\n## Skills\n\n- A skill is a folder holding a `SKILL.md`. Put your own at\n `.agents/skills/<name>/SKILL.md` on a Computer.\n `.fungi/skills/<name>/SKILL.md` works too and is searched first.\n- `SKILL.md` starts with YAML frontmatter that has a `description`. The `name`\n should match the folder and use lowercase letters, digits and single hyphens,\n at most 64 characters. The prompt shows at most 512 characters of the\n description.\n- Load a skill inside `execute` with\n `return await skill.load({ name: \"skill-name\" });`. Add `file`, relative to\n the returned `baseDirectory`, for a supporting file in the folder.\n- A person can list every skill, and the file each came from, with `/skills`.\n\n## Replace a built-in skill\n\nBuilt-in skills ship with Fungi and are not files on a Computer. To replace one,\nmake a skill with the same name on a Computer, for example\n`.agents/skills/debug-fungi/SKILL.md`. The first skill found with a name wins,\nand a Computer's skills are searched before the built-in ones. Yours is listed,\nand `skill.load` returns yours. Discovery records that yours won.\n";
|
|
11
11
|
}, {
|
|
12
12
|
readonly path: "setup-fungi/SKILL.md";
|
|
13
|
-
readonly content: "---\nname: setup-fungi\ndescription:\n Set yourself up for a new person in your first conversation, or when asked to\n set up Fungi or a project. Interview briefly, then do the setup yourself with\n their approval.\n---\n\n# Set up Fungi for your person\n\n## Goal\n\nWithin a few minutes, be set up for what they actually want: your instructions\nwritten, their project read, and, only if they want it, one App or one schedule.\nFinish with one useful result, not a tour.\n\n## Rules\n\n- Plain words. Say Agent, Computer, App, skill, schedule, Team or Home only at\n the moment you use that thing, with a one-sentence explanation.\n- One new concept per message. Name what you did, never list features.\n- Ask at most 3 cards in total, counting the \"Do it?\" plan and the name offer. A\n card is one `question.ask`; keep each short and specific, and batch a few\n questions into one card. Use options, the recommended one first. Free text is\n always allowed, and an option that lets them type their own answer is fine. Do\n not ask for the person's own name; their account already has it.\n- Propose, then act. Before writing files, cloning, scheduling or opening an\n App, show the `plan` checklist and ask \"Do it?\" with `question.ask` (options\n \"Do it\", \"Change something\", \"Skip\"). Reading needs no approval.\n- Document only what you observe. Every command, path and fact comes from a file\n you read or a command you ran.\n- Suggest only these Apps: Grove, Prints, Inkcap, Bazaar.\n- Skip any step whose tool this host does not give you, and carry on.\n- A build, install or test that fails or times out never ends setup: say what\n failed in one line, carry on, and still make every offer in step 5. A command\n result of `unknown` means it may still be running, so check again before\n calling it failed.\n- When they want to get on with a task, do the task and set up afterwards.\n- Keep prices and credit amounts out of your messages. Only the `setup.finish`\n line in step 5 mentions continuing.\n\n## Steps\n\n1. Understand. Open with one line that acknowledges what they just said. Then\n learn, from that message and at most 1 follow-up card: what they want Fungi\n for; whether there is a project (repo, folder, site, docs); anything that\n repeats (daily, weekly). Done when you can state their goal in a sentence.\n2. Plan. Write a `plan` checklist of at most 4 items, each one concrete thing\n you will do. Ask \"Do it?\". Done when they answer.\n3. Do, item by item, ticking the plan.\n - Instructions. First list your Computer's top folder, never read `AGENTS.md`\n blind. When it is listed, edit it in place; when it is not there yet, your\n Computer is still finishing its first start: carry on with the other items,\n come back to it before step 4, and if it is still missing create it with\n the same headings. Fill its \"About my person\" section (rename it \"About\n <their name>\") with their goal, the preferences they stated and how they\n want updates. Follow its \"Keeping this file up to date\" section from then\n on. Every line answers \"would I get this wrong without it?\". Then introduce\n instructions in one sentence: \"I saved this in my instructions, so I'll\n remember it in every conversation. You can read or edit them from my menu →\n Instructions.\"\n - Project, if any. Get it onto your Computer.\n - A public repo: `git clone` into `/workspace/<repo>`.\n - A private GitHub repo, when the `gitTeam` tool is present: first offer\n \"Connect GitHub\" as a link to the GitHub connector in Team settings. Once\n the repo is granted, run `gitTeam.clone` into `/workspace/<repo>`.\n - Files: ask them to drop the files in Inkcap.\n\n Then crawl it: list the top level; read the README, manifests and\n lockfiles; the build, test, lint and CI config; existing rule files\n (`AGENTS.md`, `CLAUDE.md`, `.cursor/rules`, `.cursorrules`,\n `.github/copilot-instructions.md`); then a few representative source files.\n Write or improve the project's own `AGENTS.md` with exact commands\n (including one test), entry points, boundaries and gotchas. Show the 3 most\n useful lines you learned. Introduce your Computer in one sentence: \"I have\n my own Computer, a private machine where I keep files and run things.\"\n\n - Repeating work, if any. Propose one schedule with a time and time zone.\n Create it from a new conversation named for the job.\n - An App, only when a stated need matches one. Offer its App link.\n - Prints: describe `PRINTS.generateImage` or `PRINTS.generateVideo`, then\n call it; mark a keeper with `PRINTS.setFavorite` on its saved path and\n read them back with `PRINTS.listFavorites`. The library folder is chosen\n by the person in Prints, and no method lets you choose it, so do not\n search for one: if Prints says no library is selected, say so in one line\n and tell them to pick it in Prints.\n4. First result. Do one small real task toward their goal, now. Done when they\n can see its output.\n5. Finish. Do every item below, in order. Do not end your turn before the name\n offer and the dashboard offer have each been asked, failed, or skipped. Even\n if part of setup is blocked, such as an App that is not ready, say so in your\n two lines and still make both offers. An answered card is final: do not ask\n it again in text.\n - Say in two lines what you set up and where to change it.\n - Offer a name, once (required). Ask with `question.ask`: \"Keep <your name>\"\n first, where your name is the one in your instructions (\"Your name is …\"),\n copied verbatim and never guessed, then two names you suggest that fit\n their goal; free text is always allowed. Ask the name only as a\n `question.ask` card, never in plain text. Wait for their pick: call\n `question.ask` without `mode`, never `mode: \"continue\"`, and make no\n dashboard call until they have picked. Ask it at most once in the whole\n conversation, even if you run step 5 again. Once they have picked, whether\n a new name or Keep, the name is settled: never ask it again, not even after\n an empty or interrupted turn; carry on with the dashboard offer. Only when\n they pick a new name, call `await env.self.rename({name})`: the moment they\n pick a new name, your very next call is `await env.self.rename({name})`,\n before any other step. Then say in one line that you are now called that.\n Call it directly and do not look it up first, since a lookup of a tool you\n may not see reads as absent. If `env.self` is missing or the call is\n refused, say nothing about it.\n - Offer \"Add to your dashboard\" (required). Call\n `await env.TOURTOIS.widgets.available({})` and pick at most 2 matching\n widgets from what you did: Grove Inbox, Inkcap Recent Files, Prints Recent\n Outputs. If no widget clearly matches what you did, offer the most\n generally useful one: Inbox first, then Recent Files. Skip the offer only\n when `widgets.available` returns nothing but the launcher. Never say there\n is no dashboard offer before you have called\n `await env.TOURTOIS.widgets.available({})`. Do not use `question.ask` here.\n For each widget, write one plain line first, such as \"I'm adding Inbox to\n your dashboard; approve the card if you want it.\", then call\n `await env.TOURTOIS.layout.get({})` and\n `await env.TOURTOIS.layout.place({ ... })` with its `surfaceId`, `gillId`,\n a size the widget lists, `scope` \"member\" and `basedOn` the revision\n `layout.get` returned. The call makes the Hub show the person an approval\n card to Approve or Deny. The approval card is their choice: wait for it.\n Denied or expired means move on: do not retry or ask again. Pass `params`\n only for the keys the widget lists, with values you know, and pass every\n key the widget lists as required in `params`, for example\n `params: { computer: <id> }`. Never call `layout.place` without them: a\n call missing one is rejected after the person has approved it. When a\n required parameter is a Computer and the Team has exactly one, use it: list\n the Team's Computers and pass that one's id. Skip a widget only when a\n required parameter has no value you can fill, such as zero Computers, or\n more than one with no obvious pick. Never ask a yes or no question before\n `layout.place`: if a widget needs something the person must do first, say\n so in one line and skip that widget. Never place one without that approval,\n and never add one for a person who denied. If `env.TOURTOIS` is missing or\n a call fails, skip it.\n - Delete the \"First conversation\" section from Home `AGENTS.md`.\n - When the `setup.finish` tool is available, say one more line: \"That's you\n set up. To keep going with me, start Pro, or link your wallet if you're a\n holder.\" Then call `setup.finish()` once.\n - When the `setup.finish` tool is absent, stop after the two-line summary:\n that host has no money step, so say nothing about Pro or wallets and call\n nothing.\n\n## Credit\n\n- When the `setup.finish` description says less than $0.15 of credit remains,\n finish the step in hand, then do step 5 without starting a crawl.\n- Reach step 5 only after the first useful result. A hand-off before that leaves\n the person with nothing.\n";
|
|
13
|
+
readonly content: "---\nname: setup-fungi\ndescription:\n Set yourself up for a new person in your first conversation, or when asked to\n set up Fungi or a project. Interview briefly, then do the setup yourself with\n their approval.\n---\n\n# Set up Fungi for your person\n\n## Goal\n\nWithin a few minutes, be set up for what they actually want: your instructions\nwritten, their project read, and, only if they want it, one App or one schedule.\nFinish with one useful result, not a tour.\n\n## Rules\n\n- Plain words. Say Agent, Computer, App, skill, schedule, Team or Home only at\n the moment you use that thing, with a one-sentence explanation.\n- One new concept per message. Name what you did, never list features.\n- Ask at most 3 cards in total, counting the \"Do it?\" plan and the name offer. A\n card is one `question.ask`; keep each short and specific, and batch a few\n questions into one card. Use options, the recommended one first. Free text is\n always allowed, and an option that lets them type their own answer is fine. Do\n not ask for the person's own name; their account already has it.\n- Every decision is a `question.ask` card, including \"Do it?\". Never end a turn\n asking the person to reply with options in text.\n- Propose, then act. Before writing files, cloning, scheduling or opening an\n App, show the `plan` checklist and ask \"Do it?\" with `question.ask` (options\n \"Do it\", \"Change something\", \"Skip\"). Reading needs no approval.\n- Document only what you observe. Every command, path and fact comes from a file\n you read or a command you ran.\n- Suggest only these Apps: Grove, Prints, Inkcap, Bazaar.\n- Skip any step whose tool this host does not give you, and carry on.\n- A build, install or test that fails or times out never ends setup: say what\n failed in one line, carry on, and still make every offer in step 5. A command\n result of `unknown` means it may still be running, so check again before\n calling it failed.\n- When an action fails and says it is not retryable, such as a generation, try\n at most once more with clearly different input (another model, say), never the\n same action again. Then say so in one line, carry on, and finish setup.\n- When they want to get on with a task, do the task and set up afterwards.\n- Keep prices and credit amounts out of your messages. Only the `setup.finish`\n line in step 5 mentions continuing.\n\n## Steps\n\n1. Understand. Open with one line that acknowledges what they just said. Then\n learn, from that message and at most 1 follow-up card: what they want Fungi\n for; whether there is a project (repo, folder, site, docs); anything that\n repeats (daily, weekly). Done when you can state their goal in a sentence.\n2. Plan. Write a `plan` checklist of at most 4 items, each one concrete thing\n you will do. Ask \"Do it?\". Done when they answer.\n3. Do, item by item, ticking the plan.\n - Instructions. First list your Computer's top folder, never read `AGENTS.md`\n blind. When it is listed, edit it in place; when it is not there yet, your\n Computer is still finishing its first start: carry on with the other items,\n come back to it before step 4, and if it is still missing create it with\n the same headings. Fill its \"About my person\" section (rename it \"About\n <their name>\") with their goal, the preferences they stated and how they\n want updates. Follow its \"Keeping this file up to date\" section from then\n on. Every line answers \"would I get this wrong without it?\". Then introduce\n instructions in one sentence: \"I saved this in my instructions, so I'll\n remember it in every conversation. You can read or edit them from my menu →\n Instructions.\"\n - Files you create for them: write several in one `files.patch` of Add File\n blocks rather than one write each, so they approve once. Write files with\n `files.patch` or `files.write`, never shell heredocs inside `execute`,\n whose quoting breaks.\n - Project, if any. Get it onto your Computer.\n - A public repo: `git clone` into `/workspace/<repo>`.\n - A private GitHub repo, when the `gitTeam` tool is present: first offer\n \"Connect GitHub\" as a link to the GitHub connector in Team settings. Once\n the repo is granted, run `gitTeam.clone` into `/workspace/<repo>`.\n - Files: ask them to drop the files in Inkcap.\n\n Then crawl it: list the top level; read the README, manifests and\n lockfiles; the build, test, lint and CI config; existing rule files\n (`AGENTS.md`, `CLAUDE.md`, `.cursor/rules`, `.cursorrules`,\n `.github/copilot-instructions.md`); then a few representative source files.\n Write or improve the project's own `AGENTS.md` with exact commands\n (including one test), entry points, boundaries and gotchas. Show the 3 most\n useful lines you learned. Introduce your Computer in one sentence: \"I have\n my own Computer, a private machine where I keep files and run things.\"\n\n - Repeating work, if any. Propose one schedule with a time and time zone.\n Create it from a new conversation named for the job.\n - An App, only when a stated need matches one. Offer its App link.\n - Prints: describe `PRINTS.generateImage` or `PRINTS.generateVideo`, then\n call it; mark a keeper with `PRINTS.setFavorite` on its saved path and\n read them back with `PRINTS.listFavorites`. The library folder is chosen\n by the person in Prints, and no method lets you choose it, so do not\n search for one: if Prints says no library is selected, say so in one line\n and tell them to pick it in Prints.\n4. First result. Do one small real task toward their goal, now. Done when they\n can see its output.\n5. Finish. Do every item below, in order. Do not end your turn before the name\n offer and the dashboard offer have each been asked, failed, or skipped. Even\n if part of setup is blocked, such as an App that is not ready, say so in your\n two lines and still make both offers. An answered card is final: do not ask\n it again in text.\n - Say in two lines what you set up and where to change it.\n - Offer a name, once (required). Never settle it yourself by saying you keep\n your name: the card is how they keep it. Ask with `question.ask`: \"Keep\n <your name>\" first, where your name is the one in your instructions (\"Your\n name is …\"), copied verbatim and never guessed, then two names you suggest\n that fit their goal; free text is always allowed. Ask the name only as a\n `question.ask` card, never in plain text. Wait for their pick: call\n `question.ask` without `mode`, never `mode: \"continue\"`, and make no\n dashboard call until they have picked. Ask it at most once in the whole\n conversation, even if you run step 5 again. Once they have picked, whether\n a new name or Keep, the name is settled: never ask it again, not even after\n an empty or interrupted turn; carry on with the dashboard offer. Only when\n they pick a new name, call `await env.self.rename({name})`: the moment they\n pick a new name, your very next call is `await env.self.rename({name})`,\n before any other step. Then say in one line that you are now called that.\n Call it directly and do not look it up first, since a lookup of a tool you\n may not see reads as absent. If `env.self` is missing or the call is\n refused, say nothing about it.\n - Offer \"Add to your dashboard\" (required). Call\n `await env.TOURTOIS.widgets.available({})` and pick at most 2 matching\n widgets from what you did: Grove Inbox, Inkcap Recent Files, Prints Recent\n Outputs. If no widget clearly matches what you did, offer the most\n generally useful one: Inbox first, then Recent Files. Skip the offer only\n when `widgets.available` returns nothing but the launcher. Never say there\n is no dashboard offer before you have called\n `await env.TOURTOIS.widgets.available({})`. Do not use `question.ask` here.\n For each widget, write one plain line first, such as \"I'm adding Inbox to\n your dashboard; approve the card if you want it.\", then call\n `await env.TOURTOIS.layout.get({})` and\n `await env.TOURTOIS.layout.place({ ... })` with its `surfaceId`, `gillId`,\n a size the widget lists, `scope` \"member\" and `basedOn` the revision\n `layout.get` returned. The call makes the Hub show the person an approval\n card to Approve or Deny. The approval card is their choice: wait for it.\n Denied or expired means move on: do not retry or ask again. Pass `params`\n only for the keys the widget lists, with values you know, and pass every\n key the widget lists as required in `params`, for example\n `params: { computer: <id> }`. Never call `layout.place` without them: a\n call missing one is rejected after the person has approved it. When a\n required parameter is a Computer and the Team has exactly one, use the id\n from your instructions:\n `params: { computer: <the id from your instructions> }`. Skip a widget\n whose required Computer you cannot fill because the Team has none, or more\n than one. Skip a widget only when a required parameter has no value you can\n fill. Never ask a yes or no question before `layout.place`: if a widget\n needs something the person must do first, say so in one line and skip that\n widget. Never place one without that approval, and never add one for a\n person who denied. If `env.TOURTOIS` is missing or a call fails, skip it.\n - Delete the \"First conversation\" section from Home `AGENTS.md`.\n - When the `setup.finish` tool is available, say one more line: \"That's you\n set up. To keep going with me, start Pro, or link your wallet if you're a\n holder.\" Then call `setup.finish()` once.\n - When the `setup.finish` tool is absent, stop after the two-line summary:\n that host has no money step, so say nothing about Pro or wallets and call\n nothing.\n\n## Credit\n\n- When the `setup.finish` description says less than $0.15 of credit remains,\n finish the step in hand, then do step 5 without starting a crawl.\n- Reach step 5 only after the first useful result. A hand-off before that leaves\n the person with nothing.\n";
|
|
14
14
|
}];
|
|
@@ -15,6 +15,6 @@ export const platformSkillFiles = [
|
|
|
15
15
|
},
|
|
16
16
|
{
|
|
17
17
|
path: "setup-fungi/SKILL.md",
|
|
18
|
-
content: '---\nname: setup-fungi\ndescription:\n Set yourself up for a new person in your first conversation, or when asked to\n set up Fungi or a project. Interview briefly, then do the setup yourself with\n their approval.\n---\n\n# Set up Fungi for your person\n\n## Goal\n\nWithin a few minutes, be set up for what they actually want: your instructions\nwritten, their project read, and, only if they want it, one App or one schedule.\nFinish with one useful result, not a tour.\n\n## Rules\n\n- Plain words. Say Agent, Computer, App, skill, schedule, Team or Home only at\n the moment you use that thing, with a one-sentence explanation.\n- One new concept per message. Name what you did, never list features.\n- Ask at most 3 cards in total, counting the "Do it?" plan and the name offer. A\n card is one `question.ask`; keep each short and specific, and batch a few\n questions into one card. Use options, the recommended one first. Free text is\n always allowed, and an option that lets them type their own answer is fine. Do\n not ask for the person\'s own name; their account already has it.\n- Propose, then act. Before writing files, cloning, scheduling or opening an\n App, show the `plan` checklist and ask "Do it?" with `question.ask` (options\n "Do it", "Change something", "Skip"). Reading needs no approval.\n- Document only what you observe. Every command, path and fact comes from a file\n you read or a command you ran.\n- Suggest only these Apps: Grove, Prints, Inkcap, Bazaar.\n- Skip any step whose tool this host does not give you, and carry on.\n- A build, install or test that fails or times out never ends setup: say what\n failed in one line, carry on, and still make every offer in step 5. A command\n result of `unknown` means it may still be running, so check again before\n calling it failed.\n- When they want to get on with a task, do the task and set up afterwards.\n- Keep prices and credit amounts out of your messages. Only the `setup.finish`\n line in step 5 mentions continuing.\n\n## Steps\n\n1. Understand. Open with one line that acknowledges what they just said. Then\n learn, from that message and at most 1 follow-up card: what they want Fungi\n for; whether there is a project (repo, folder, site, docs); anything that\n repeats (daily, weekly). Done when you can state their goal in a sentence.\n2. Plan. Write a `plan` checklist of at most 4 items, each one concrete thing\n you will do. Ask "Do it?". Done when they answer.\n3. Do, item by item, ticking the plan.\n - Instructions. First list your Computer\'s top folder, never read `AGENTS.md`\n blind. When it is listed, edit it in place; when it is not there yet, your\n Computer is still finishing its first start: carry on with the other items,\n come back to it before step 4, and if it is still missing create it with\n the same headings. Fill its "About my person" section (rename it "About\n <their name>") with their goal, the preferences they stated and how they\n want updates. Follow its "Keeping this file up to date" section from then\n on. Every line answers "would I get this wrong without it?". Then introduce\n instructions in one sentence: "I saved this in my instructions, so I\'ll\n remember it in every conversation. You can read or edit them from my menu →\n Instructions."\n - Project, if any. Get it onto your Computer.\n - A public repo: `git clone` into `/workspace/<repo>`.\n - A private GitHub repo, when the `gitTeam` tool is present: first offer\n "Connect GitHub" as a link to the GitHub connector in Team settings. Once\n the repo is granted, run `gitTeam.clone` into `/workspace/<repo>`.\n - Files: ask them to drop the files in Inkcap.\n\n Then crawl it: list the top level; read the README, manifests and\n lockfiles; the build, test, lint and CI config; existing rule files\n (`AGENTS.md`, `CLAUDE.md`, `.cursor/rules`, `.cursorrules`,\n `.github/copilot-instructions.md`); then a few representative source files.\n Write or improve the project\'s own `AGENTS.md` with exact commands\n (including one test), entry points, boundaries and gotchas. Show the 3 most\n useful lines you learned. Introduce your Computer in one sentence: "I have\n my own Computer, a private machine where I keep files and run things."\n\n - Repeating work, if any. Propose one schedule with a time and time zone.\n Create it from a new conversation named for the job.\n - An App, only when a stated need matches one. Offer its App link.\n - Prints: describe `PRINTS.generateImage` or `PRINTS.generateVideo`, then\n call it; mark a keeper with `PRINTS.setFavorite` on its saved path and\n read them back with `PRINTS.listFavorites`. The library folder is chosen\n by the person in Prints, and no method lets you choose it, so do not\n search for one: if Prints says no library is selected, say so in one line\n and tell them to pick it in Prints.\n4. First result. Do one small real task toward their goal, now. Done when they\n can see its output.\n5. Finish. Do every item below, in order. Do not end your turn before the name\n offer and the dashboard offer have each been asked, failed, or skipped. Even\n if part of setup is blocked, such as an App that is not ready, say so in your\n two lines and still make both offers. An answered card is final: do not ask\n it again in text.\n - Say in two lines what you set up and where to change it.\n - Offer a name, once (required). Ask with `question.ask`: "Keep <your name>"\n first, where your name is the one in your instructions ("Your name is …"),\n copied verbatim and never guessed, then two names you suggest that fit\n their goal; free text is always allowed. Ask the name only as a\n `question.ask` card, never in plain text. Wait for their pick: call\n `question.ask` without `mode`, never `mode: "continue"`, and make no\n dashboard call until they have picked. Ask it at most once in the whole\n conversation, even if you run step 5 again. Once they have picked, whether\n a new name or Keep, the name is settled: never ask it again, not even after\n an empty or interrupted turn; carry on with the dashboard offer. Only when\n they pick a new name, call `await env.self.rename({name})`: the moment they\n pick a new name, your very next call is `await env.self.rename({name})`,\n before any other step. Then say in one line that you are now called that.\n Call it directly and do not look it up first, since a lookup of a tool you\n may not see reads as absent. If `env.self` is missing or the call is\n refused, say nothing about it.\n - Offer "Add to your dashboard" (required). Call\n `await env.TOURTOIS.widgets.available({})` and pick at most 2 matching\n widgets from what you did: Grove Inbox, Inkcap Recent Files, Prints Recent\n Outputs. If no widget clearly matches what you did, offer the most\n generally useful one: Inbox first, then Recent Files. Skip the offer only\n when `widgets.available` returns nothing but the launcher. Never say there\n is no dashboard offer before you have called\n `await env.TOURTOIS.widgets.available({})`. Do not use `question.ask` here.\n For each widget, write one plain line first, such as "I\'m adding Inbox to\n your dashboard; approve the card if you want it.", then call\n `await env.TOURTOIS.layout.get({})` and\n `await env.TOURTOIS.layout.place({ ... })` with its `surfaceId`, `gillId`,\n a size the widget lists, `scope` "member" and `basedOn` the revision\n `layout.get` returned. The call makes the Hub show the person an approval\n card to Approve or Deny. The approval card is their choice: wait for it.\n Denied or expired means move on: do not retry or ask again. Pass `params`\n only for the keys the widget lists, with values you know, and pass every\n key the widget lists as required in `params`, for example\n `params: { computer: <id> }`. Never call `layout.place` without them: a\n call missing one is rejected after the person has approved it. When a\n required parameter is a Computer and the Team has exactly one, use it: list\n the Team\'s Computers and pass that one\'s id. Skip a widget only when a\n required parameter has no value you can fill, such as zero Computers, or\n more than one with no obvious pick. Never ask a yes or no question before\n `layout.place`: if a widget needs something the person must do first, say\n so in one line and skip that widget. Never place one without that approval,\n and never add one for a person who denied. If `env.TOURTOIS` is missing or\n a call fails, skip it.\n - Delete the "First conversation" section from Home `AGENTS.md`.\n - When the `setup.finish` tool is available, say one more line: "That\'s you\n set up. To keep going with me, start Pro, or link your wallet if you\'re a\n holder." Then call `setup.finish()` once.\n - When the `setup.finish` tool is absent, stop after the two-line summary:\n that host has no money step, so say nothing about Pro or wallets and call\n nothing.\n\n## Credit\n\n- When the `setup.finish` description says less than $0.15 of credit remains,\n finish the step in hand, then do step 5 without starting a crawl.\n- Reach step 5 only after the first useful result. A hand-off before that leaves\n the person with nothing.\n',
|
|
18
|
+
content: '---\nname: setup-fungi\ndescription:\n Set yourself up for a new person in your first conversation, or when asked to\n set up Fungi or a project. Interview briefly, then do the setup yourself with\n their approval.\n---\n\n# Set up Fungi for your person\n\n## Goal\n\nWithin a few minutes, be set up for what they actually want: your instructions\nwritten, their project read, and, only if they want it, one App or one schedule.\nFinish with one useful result, not a tour.\n\n## Rules\n\n- Plain words. Say Agent, Computer, App, skill, schedule, Team or Home only at\n the moment you use that thing, with a one-sentence explanation.\n- One new concept per message. Name what you did, never list features.\n- Ask at most 3 cards in total, counting the "Do it?" plan and the name offer. A\n card is one `question.ask`; keep each short and specific, and batch a few\n questions into one card. Use options, the recommended one first. Free text is\n always allowed, and an option that lets them type their own answer is fine. Do\n not ask for the person\'s own name; their account already has it.\n- Every decision is a `question.ask` card, including "Do it?". Never end a turn\n asking the person to reply with options in text.\n- Propose, then act. Before writing files, cloning, scheduling or opening an\n App, show the `plan` checklist and ask "Do it?" with `question.ask` (options\n "Do it", "Change something", "Skip"). Reading needs no approval.\n- Document only what you observe. Every command, path and fact comes from a file\n you read or a command you ran.\n- Suggest only these Apps: Grove, Prints, Inkcap, Bazaar.\n- Skip any step whose tool this host does not give you, and carry on.\n- A build, install or test that fails or times out never ends setup: say what\n failed in one line, carry on, and still make every offer in step 5. A command\n result of `unknown` means it may still be running, so check again before\n calling it failed.\n- When an action fails and says it is not retryable, such as a generation, try\n at most once more with clearly different input (another model, say), never the\n same action again. Then say so in one line, carry on, and finish setup.\n- When they want to get on with a task, do the task and set up afterwards.\n- Keep prices and credit amounts out of your messages. Only the `setup.finish`\n line in step 5 mentions continuing.\n\n## Steps\n\n1. Understand. Open with one line that acknowledges what they just said. Then\n learn, from that message and at most 1 follow-up card: what they want Fungi\n for; whether there is a project (repo, folder, site, docs); anything that\n repeats (daily, weekly). Done when you can state their goal in a sentence.\n2. Plan. Write a `plan` checklist of at most 4 items, each one concrete thing\n you will do. Ask "Do it?". Done when they answer.\n3. Do, item by item, ticking the plan.\n - Instructions. First list your Computer\'s top folder, never read `AGENTS.md`\n blind. When it is listed, edit it in place; when it is not there yet, your\n Computer is still finishing its first start: carry on with the other items,\n come back to it before step 4, and if it is still missing create it with\n the same headings. Fill its "About my person" section (rename it "About\n <their name>") with their goal, the preferences they stated and how they\n want updates. Follow its "Keeping this file up to date" section from then\n on. Every line answers "would I get this wrong without it?". Then introduce\n instructions in one sentence: "I saved this in my instructions, so I\'ll\n remember it in every conversation. You can read or edit them from my menu →\n Instructions."\n - Files you create for them: write several in one `files.patch` of Add File\n blocks rather than one write each, so they approve once. Write files with\n `files.patch` or `files.write`, never shell heredocs inside `execute`,\n whose quoting breaks.\n - Project, if any. Get it onto your Computer.\n - A public repo: `git clone` into `/workspace/<repo>`.\n - A private GitHub repo, when the `gitTeam` tool is present: first offer\n "Connect GitHub" as a link to the GitHub connector in Team settings. Once\n the repo is granted, run `gitTeam.clone` into `/workspace/<repo>`.\n - Files: ask them to drop the files in Inkcap.\n\n Then crawl it: list the top level; read the README, manifests and\n lockfiles; the build, test, lint and CI config; existing rule files\n (`AGENTS.md`, `CLAUDE.md`, `.cursor/rules`, `.cursorrules`,\n `.github/copilot-instructions.md`); then a few representative source files.\n Write or improve the project\'s own `AGENTS.md` with exact commands\n (including one test), entry points, boundaries and gotchas. Show the 3 most\n useful lines you learned. Introduce your Computer in one sentence: "I have\n my own Computer, a private machine where I keep files and run things."\n\n - Repeating work, if any. Propose one schedule with a time and time zone.\n Create it from a new conversation named for the job.\n - An App, only when a stated need matches one. Offer its App link.\n - Prints: describe `PRINTS.generateImage` or `PRINTS.generateVideo`, then\n call it; mark a keeper with `PRINTS.setFavorite` on its saved path and\n read them back with `PRINTS.listFavorites`. The library folder is chosen\n by the person in Prints, and no method lets you choose it, so do not\n search for one: if Prints says no library is selected, say so in one line\n and tell them to pick it in Prints.\n4. First result. Do one small real task toward their goal, now. Done when they\n can see its output.\n5. Finish. Do every item below, in order. Do not end your turn before the name\n offer and the dashboard offer have each been asked, failed, or skipped. Even\n if part of setup is blocked, such as an App that is not ready, say so in your\n two lines and still make both offers. An answered card is final: do not ask\n it again in text.\n - Say in two lines what you set up and where to change it.\n - Offer a name, once (required). Never settle it yourself by saying you keep\n your name: the card is how they keep it. Ask with `question.ask`: "Keep\n <your name>" first, where your name is the one in your instructions ("Your\n name is …"), copied verbatim and never guessed, then two names you suggest\n that fit their goal; free text is always allowed. Ask the name only as a\n `question.ask` card, never in plain text. Wait for their pick: call\n `question.ask` without `mode`, never `mode: "continue"`, and make no\n dashboard call until they have picked. Ask it at most once in the whole\n conversation, even if you run step 5 again. Once they have picked, whether\n a new name or Keep, the name is settled: never ask it again, not even after\n an empty or interrupted turn; carry on with the dashboard offer. Only when\n they pick a new name, call `await env.self.rename({name})`: the moment they\n pick a new name, your very next call is `await env.self.rename({name})`,\n before any other step. Then say in one line that you are now called that.\n Call it directly and do not look it up first, since a lookup of a tool you\n may not see reads as absent. If `env.self` is missing or the call is\n refused, say nothing about it.\n - Offer "Add to your dashboard" (required). Call\n `await env.TOURTOIS.widgets.available({})` and pick at most 2 matching\n widgets from what you did: Grove Inbox, Inkcap Recent Files, Prints Recent\n Outputs. If no widget clearly matches what you did, offer the most\n generally useful one: Inbox first, then Recent Files. Skip the offer only\n when `widgets.available` returns nothing but the launcher. Never say there\n is no dashboard offer before you have called\n `await env.TOURTOIS.widgets.available({})`. Do not use `question.ask` here.\n For each widget, write one plain line first, such as "I\'m adding Inbox to\n your dashboard; approve the card if you want it.", then call\n `await env.TOURTOIS.layout.get({})` and\n `await env.TOURTOIS.layout.place({ ... })` with its `surfaceId`, `gillId`,\n a size the widget lists, `scope` "member" and `basedOn` the revision\n `layout.get` returned. The call makes the Hub show the person an approval\n card to Approve or Deny. The approval card is their choice: wait for it.\n Denied or expired means move on: do not retry or ask again. Pass `params`\n only for the keys the widget lists, with values you know, and pass every\n key the widget lists as required in `params`, for example\n `params: { computer: <id> }`. Never call `layout.place` without them: a\n call missing one is rejected after the person has approved it. When a\n required parameter is a Computer and the Team has exactly one, use the id\n from your instructions:\n `params: { computer: <the id from your instructions> }`. Skip a widget\n whose required Computer you cannot fill because the Team has none, or more\n than one. Skip a widget only when a required parameter has no value you can\n fill. Never ask a yes or no question before `layout.place`: if a widget\n needs something the person must do first, say so in one line and skip that\n widget. Never place one without that approval, and never add one for a\n person who denied. If `env.TOURTOIS` is missing or a call fails, skip it.\n - Delete the "First conversation" section from Home `AGENTS.md`.\n - When the `setup.finish` tool is available, say one more line: "That\'s you\n set up. To keep going with me, start Pro, or link your wallet if you\'re a\n holder." Then call `setup.finish()` once.\n - When the `setup.finish` tool is absent, stop after the two-line summary:\n that host has no money step, so say nothing about Pro or wallets and call\n nothing.\n\n## Credit\n\n- When the `setup.finish` description says less than $0.15 of credit remains,\n finish the step in hand, then do step 5 without starting a crawl.\n- Reach step 5 only after the first useful result. A hand-off before that leaves\n the person with nothing.\n',
|
|
19
19
|
},
|
|
20
20
|
];
|
package/docs/api/apps.md
CHANGED
|
@@ -1840,11 +1840,11 @@ resource authority.
|
|
|
1840
1840
|
|
|
1841
1841
|
#### Parameters
|
|
1842
1842
|
|
|
1843
|
-
| Parameter | Type
|
|
1844
|
-
| ---------- |
|
|
1845
|
-
| `captured` | readonly `object`[]
|
|
1846
|
-
| `method?` | `Readonly`\<\{ `description`: `string`; `input`: \{ \[`key`: `string`\]: \| `null` \| `string` \| `number` \| `false` \| `true` \| AppApiJsonObject \| \{ \[`index`: `number`\]: AppApiJsonValue; `length`: `number`; \}; \}; `output`: \{ \[`key`: `string`\]: \| `null` \| `string` \| `number` \| `false` \| `true` \| AppApiJsonObject \| \{ \[`index`: `number`\]: AppApiJsonValue; `length`: `number`; \}; \}; `effect`: `"read"` \| `"write"` \| `"external"`; `requires`: readonly ( \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"agent.toolPolicy"` \| `"agent.extensions"` \| `"agent.stop"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`)[]; `pending?`: `true`; `hidden?`: `true`; `present?`: `Readonly`\<\{ `verb`: `string`; \}\>; \}\> | `undefined` |
|
|
1847
|
-
| `ceiling?` | `"read"` \| `"write"`
|
|
1843
|
+
| Parameter | Type | Default value |
|
|
1844
|
+
| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |
|
|
1845
|
+
| `captured` | readonly `object`[] | `undefined` |
|
|
1846
|
+
| `method?` | `Readonly`\<\{ `description`: `string`; `input`: \{ \[`key`: `string`\]: \| `null` \| `string` \| `number` \| `false` \| `true` \| AppApiJsonObject \| \{ \[`index`: `number`\]: AppApiJsonValue; `length`: `number`; \}; \}; `output`: \{ \[`key`: `string`\]: \| `null` \| `string` \| `number` \| `false` \| `true` \| AppApiJsonObject \| \{ \[`index`: `number`\]: AppApiJsonValue; `length`: `number`; \}; \}; `effect`: `"read"` \| `"write"` \| `"external"`; `requires`: readonly ( \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"agent.toolPolicy"` \| `"agent.extensions"` \| `"agent.stop"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`)[]; `pending?`: `true`; `hidden?`: `true`; `label?`: `string`; `precheck?`: `string`; `present?`: `Readonly`\<\{ `verb`: `string`; \}\>; \}\> | `undefined` |
|
|
1847
|
+
| `ceiling?` | `"read"` \| `"write"` | `"write"` |
|
|
1848
1848
|
|
|
1849
1849
|
#### Returns
|
|
1850
1850
|
|
package/docs/api/build.md
CHANGED
|
@@ -1679,31 +1679,31 @@ Exact pinned esbuild options shared by local builds and artifact-budget proofs.
|
|
|
1679
1679
|
|
|
1680
1680
|
#### Parameters
|
|
1681
1681
|
|
|
1682
|
-
| Parameter | Type
|
|
1683
|
-
| -------------------------------- |
|
|
1684
|
-
| `source` | [`CapturedSource`](#capturedsource)
|
|
1685
|
-
| `recipe` | \{ `kind?`: `"bundled-html"` \| `"source-html"`; `bundle`: `true`; `entry`: `string`; `format`: `"html"` \| `"assets"` \| `"esm"`; `assets?`: \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \}; `assetBase?`: `string`; `toolchain`: \{ \[`key`: `string`\]: `string`; \}; `maxOutputBytes`: `number`; `platform`: `"neutral"` \| `"browser"`; `backend`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `target`: readonly \[`"es2022"`\]; \}
|
|
1686
|
-
| `recipe.kind?` | `"bundled-html"` \| `"source-html"`
|
|
1687
|
-
| `recipe.bundle` | `true`
|
|
1688
|
-
| `recipe.entry` | `string`
|
|
1689
|
-
| `recipe.format` | `"html"` \| `"assets"` \| `"esm"`
|
|
1690
|
-
| `recipe.assets?` | \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \}
|
|
1691
|
-
| `recipe.assets.maxManifestBytes` | `number`
|
|
1692
|
-
| `recipe.assets.maxObjects` | `number`
|
|
1693
|
-
| `recipe.assets.maxObjectBytes` | `number`
|
|
1694
|
-
| `recipe.assets.maxTotalBytes` | `number`
|
|
1695
|
-
| `recipe.assetBase?` | `string`
|
|
1696
|
-
| `recipe.toolchain` | \{ \[`key`: `string`\]: `string`; \}
|
|
1697
|
-
| `recipe.maxOutputBytes` | `number`
|
|
1698
|
-
| `recipe.platform` | `"neutral"` \| `"browser"`
|
|
1699
|
-
| `recipe.backend` | \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`
|
|
1700
|
-
| `recipe.target` | readonly \[`"es2022"`\]
|
|
1701
|
-
| `emission` | \{ `entryPoints`: (`entry`) => `Record`\<`string`, `string`\>; `outdir`: `string`; `plugins`: `Plugin`[]; `worker`: [`AppBackendOutput`](#appbackendoutput); `declare`: `Promise`\<`Readonly`\<\{ `api?`: `Readonly`\<\{ `methods`: `Readonly`\<`Record`\<`string`, `Readonly`\<\{ `description`: ...; `input`: ...; `output`: ...; `effect`: ...; `requires`: ...; `pending?`: ...; `hidden?`: ...; `present?`: ...; \}\>\>\>; `toolFamily?`: `Readonly`\<\{ `name`: `string`; `list`: `string`; `call`: `string`; \}\>; `events?`: `Readonly`\<`Record`\<`string`, `Readonly`\<...\>\>\>; \}\>; `displayName?`: `string`; `capabilities`: readonly ( \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"agent.toolPolicy"` \| `"agent.extensions"` \| `"agent.stop"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`)[]; `calls?`: readonly `Readonly`\<\{ `appId`: `string`; `methods`: readonly `string`[]; \}\>[]; `guidance?`: `string`; `handlers`: readonly `"file.open"`[]; `receives?`: readonly `"git.push"`[]; `icon?`: `string`; `roles`: readonly (`"files"` \| `"dashboard"` \| `"inbox"` \| `"media"` \| `"sessions"` \| `"terminal"`)[]; `storage?`: readonly `Readonly`\<\{ `key`: `string`; `scopes`: readonly (`"team"` \| `"member"`)[]; `maxBytes`: `number`; \}\>[]; `commands?`: readonly `Readonly`\<\{ `id`: `string`; `title`: `string`; `category`: `string`; `description?`: `string`; `sigil?`: `string`; `projections?`: `Readonly`\<\{ `bindings?`: ...; `agent?`: ...; `help?`: ...; `menu?`: ...; `palette?`: ...; `slash?`: ...; \}\>; \}\>[]; `gills?`: readonly `AppDeclaredGill`[]; `backend?`: `Readonly`\<\{ `bindings`: readonly `Readonly`\<\{ `name`: ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ...; `operations`: readonly ...[]; \}\>[]; `sync?`: `Readonly`\<\{ `method`: `string`; \}\>; \}\>; \}\>\>; \} | - |
|
|
1702
|
-
| `emission.entryPoints` | (`entry`) => `Record`\<`string`, `string`\>
|
|
1703
|
-
| `emission.outdir` | `string`
|
|
1704
|
-
| `emission.plugins` | `Plugin`[]
|
|
1705
|
-
| `emission.worker` | -
|
|
1706
|
-
| `emission.declare` | -
|
|
1682
|
+
| Parameter | Type | Description |
|
|
1683
|
+
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
|
|
1684
|
+
| `source` | [`CapturedSource`](#capturedsource) | - |
|
|
1685
|
+
| `recipe` | \{ `kind?`: `"bundled-html"` \| `"source-html"`; `bundle`: `true`; `entry`: `string`; `format`: `"html"` \| `"assets"` \| `"esm"`; `assets?`: \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \}; `assetBase?`: `string`; `toolchain`: \{ \[`key`: `string`\]: `string`; \}; `maxOutputBytes`: `number`; `platform`: `"neutral"` \| `"browser"`; `backend`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `target`: readonly \[`"es2022"`\]; \} | - |
|
|
1686
|
+
| `recipe.kind?` | `"bundled-html"` \| `"source-html"` | - |
|
|
1687
|
+
| `recipe.bundle` | `true` | - |
|
|
1688
|
+
| `recipe.entry` | `string` | - |
|
|
1689
|
+
| `recipe.format` | `"html"` \| `"assets"` \| `"esm"` | - |
|
|
1690
|
+
| `recipe.assets?` | \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \} | - |
|
|
1691
|
+
| `recipe.assets.maxManifestBytes` | `number` | - |
|
|
1692
|
+
| `recipe.assets.maxObjects` | `number` | - |
|
|
1693
|
+
| `recipe.assets.maxObjectBytes` | `number` | - |
|
|
1694
|
+
| `recipe.assets.maxTotalBytes` | `number` | - |
|
|
1695
|
+
| `recipe.assetBase?` | `string` | - |
|
|
1696
|
+
| `recipe.toolchain` | \{ \[`key`: `string`\]: `string`; \} | - |
|
|
1697
|
+
| `recipe.maxOutputBytes` | `number` | - |
|
|
1698
|
+
| `recipe.platform` | `"neutral"` \| `"browser"` | - |
|
|
1699
|
+
| `recipe.backend` | \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null` | - |
|
|
1700
|
+
| `recipe.target` | readonly \[`"es2022"`\] | - |
|
|
1701
|
+
| `emission` | \{ `entryPoints`: (`entry`) => `Record`\<`string`, `string`\>; `outdir`: `string`; `plugins`: `Plugin`[]; `worker`: [`AppBackendOutput`](#appbackendoutput); `declare`: `Promise`\<`Readonly`\<\{ `api?`: `Readonly`\<\{ `methods`: `Readonly`\<`Record`\<`string`, `Readonly`\<\{ `description`: ...; `input`: ...; `output`: ...; `effect`: ...; `requires`: ...; `pending?`: ...; `hidden?`: ...; `label?`: ...; `precheck?`: ...; `present?`: ...; \}\>\>\>; `toolFamily?`: `Readonly`\<\{ `name`: `string`; `list`: `string`; `call`: `string`; \}\>; `events?`: `Readonly`\<`Record`\<`string`, `Readonly`\<...\>\>\>; \}\>; `displayName?`: `string`; `capabilities`: readonly ( \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"agent.toolPolicy"` \| `"agent.extensions"` \| `"agent.stop"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`)[]; `calls?`: readonly `Readonly`\<\{ `appId`: `string`; `methods`: readonly `string`[]; \}\>[]; `guidance?`: `string`; `handlers`: readonly `"file.open"`[]; `receives?`: readonly `"git.push"`[]; `icon?`: `string`; `roles`: readonly (`"files"` \| `"dashboard"` \| `"inbox"` \| `"media"` \| `"sessions"` \| `"terminal"`)[]; `storage?`: readonly `Readonly`\<\{ `key`: `string`; `scopes`: readonly (`"team"` \| `"member"`)[]; `maxBytes`: `number`; \}\>[]; `commands?`: readonly `Readonly`\<\{ `id`: `string`; `title`: `string`; `category`: `string`; `description?`: `string`; `sigil?`: `string`; `projections?`: `Readonly`\<\{ `bindings?`: ...; `agent?`: ...; `help?`: ...; `menu?`: ...; `palette?`: ...; `slash?`: ...; \}\>; \}\>[]; `gills?`: readonly `AppDeclaredGill`[]; `backend?`: `Readonly`\<\{ `bindings`: readonly `Readonly`\<\{ `name`: ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ...; `operations`: readonly ...[]; \}\>[]; `sync?`: `Readonly`\<\{ `method`: `string`; \}\>; \}\>; \}\>\>; \} | - |
|
|
1702
|
+
| `emission.entryPoints` | (`entry`) => `Record`\<`string`, `string`\> | Entries for the one backend build: the Worker and, if defined, its declaration. |
|
|
1703
|
+
| `emission.outdir` | `string` | - |
|
|
1704
|
+
| `emission.plugins` | `Plugin`[] | - |
|
|
1705
|
+
| `emission.worker` | - |
|
|
1706
|
+
| `emission.declare` | - |
|
|
1707
1707
|
|
|
1708
1708
|
#### Returns
|
|
1709
1709
|
|
package/docs/api/host.md
CHANGED
|
@@ -2102,6 +2102,8 @@ function verifyRelease(
|
|
|
2102
2102
|
requires: readonly ...;
|
|
2103
2103
|
pending?: ... | ...;
|
|
2104
2104
|
hidden?: ... | ...;
|
|
2105
|
+
label?: ... | ...;
|
|
2106
|
+
precheck?: ... | ...;
|
|
2105
2107
|
present?: ... | ...;
|
|
2106
2108
|
}>>>;
|
|
2107
2109
|
toolFamily?: Readonly<{
|
|
@@ -2299,38 +2301,39 @@ readonly `"git.push"`[]; `icon?`: `string`; `roles`: readonly (`"files"` \|
|
|
|
2299
2301
|
`api`: \| `Readonly`\<\{ `methods`: `Readonly`\<`Record`\<`string`,
|
|
2300
2302
|
`Readonly`\<\{ `description`: `string`; `input`: \{ \[`key`: ...\]: ...; \};
|
|
2301
2303
|
`output`: \{ \[`key`: ...\]: ...; \}; `effect`: ... \| ... \| ...; `requires`:
|
|
2302
|
-
readonly ...; `pending?`: ... \| ...; `hidden?`: ... \| ...; `
|
|
2303
|
-
...;
|
|
2304
|
-
`
|
|
2305
|
-
`Readonly`\<\{ `description`: ...;
|
|
2306
|
-
`
|
|
2307
|
-
`Readonly
|
|
2308
|
-
`Readonly`\<...\>;
|
|
2309
|
-
`
|
|
2310
|
-
`"computer.
|
|
2311
|
-
`"agent.
|
|
2312
|
-
`"agent.
|
|
2313
|
-
\| `"agent.
|
|
2314
|
-
`"
|
|
2315
|
-
`"
|
|
2316
|
-
`"
|
|
2317
|
-
`"
|
|
2318
|
-
`"
|
|
2319
|
-
`Readonly`\<\{ `appId`:
|
|
2320
|
-
`
|
|
2321
|
-
readonly `"
|
|
2322
|
-
`
|
|
2323
|
-
`
|
|
2324
|
-
`
|
|
2325
|
-
`
|
|
2326
|
-
`
|
|
2327
|
-
`
|
|
2328
|
-
`
|
|
2329
|
-
`Readonly
|
|
2330
|
-
`
|
|
2331
|
-
`"
|
|
2332
|
-
|
|
2333
|
-
`
|
|
2304
|
+
readonly ...; `pending?`: ... \| ...; `hidden?`: ... \| ...; `label?`: ... \|
|
|
2305
|
+
...; `precheck?`: ... \| ...; `present?`: ... \| ...; \}\>\>\>; `toolFamily?`:
|
|
2306
|
+
`Readonly`\<\{ `name`: `string`; `list`: `string`; `call`: `string`; \}\>;
|
|
2307
|
+
`events?`: `Readonly`\<`Record`\<`string`, `Readonly`\<\{ `description`: ...;
|
|
2308
|
+
`payload`: ...; \}\>\>\>; \}\> \| `null`; `declaration`: \| `Readonly`\<\{
|
|
2309
|
+
`api?`: `Readonly`\<\{ `methods`: `Readonly`\<`Record`\<..., ...\>\>;
|
|
2310
|
+
`toolFamily?`: `Readonly`\<...\>; `events?`: `Readonly`\<...\>; \}\>;
|
|
2311
|
+
`displayName?`: `string`; `capabilities`: readonly ( \| `"computer.list"` \|
|
|
2312
|
+
`"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \|
|
|
2313
|
+
`"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \|
|
|
2314
|
+
`"agent.avatar"` \| `"agent.instructions"` \| `"agent.toolPolicy"` \|
|
|
2315
|
+
`"agent.extensions"` \| `"agent.stop"` \| `"agent.read"` \| `"agent.send"` \|
|
|
2316
|
+
`"llm.generation"` \| `"media.generation"` \| `"media.share"` \|
|
|
2317
|
+
`"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \|
|
|
2318
|
+
`"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \|
|
|
2319
|
+
`"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \|
|
|
2320
|
+
`"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \|
|
|
2321
|
+
`"channels.personal.manage"`)[]; `calls?`: readonly `Readonly`\<\{ `appId`:
|
|
2322
|
+
`string`; `methods`: readonly ...[]; \}\>[]; `guidance?`: `string`; `handlers`:
|
|
2323
|
+
readonly `"file.open"`[]; `receives?`: readonly `"git.push"`[]; `icon?`:
|
|
2324
|
+
`string`; `roles`: readonly (`"files"` \| `"dashboard"` \| `"inbox"` \|
|
|
2325
|
+
`"media"` \| `"sessions"` \| `"terminal"`)[]; `storage?`: readonly
|
|
2326
|
+
`Readonly`\<\{ `key`: `string`; `scopes`: readonly ...[]; `maxBytes`: `number`;
|
|
2327
|
+
\}\>[]; `commands?`: readonly `Readonly`\<\{ `id`: `string`; `title`: `string`;
|
|
2328
|
+
`category`: `string`; `description?`: ... \| ...; `sigil?`: ... \| ...;
|
|
2329
|
+
`projections?`: ... \| ...; \}\>[]; `gills?`: readonly `AppDeclaredGill`[];
|
|
2330
|
+
`backend?`: `Readonly`\<\{ `bindings`: readonly `Readonly`\<...\>[]; `sync?`:
|
|
2331
|
+
`Readonly`\<...\>; \}\>; \}\> \| `null`; `ui`: \| `Readonly`\<\{ `kind`:
|
|
2332
|
+
`"html"`; `artifactRef`: `ArtifactRef`; `digest`: `Sha256Digest`; \}\> \|
|
|
2333
|
+
`Readonly`\<\{ `kind`: `"assets"`; `build`: \{ `format`: `"fungi-assets-v1"`;
|
|
2334
|
+
`base`: `string`; `assets`: readonly `object`[]; \}; \}\> \| `null`; `backend`:
|
|
2335
|
+
\| `Readonly`\<\{ `artifactRef`: `ArtifactRef`; `digest`: `Sha256Digest`; \}\>
|
|
2336
|
+
\| `null`; \}\>\>
|
|
2334
2337
|
|
|
2335
2338
|
---
|
|
2336
2339
|
|