@kybernesis/artifacts 0.1.1 → 0.1.2

package/dist/extension/instructions.md

@@ -2,6 +2,8 @@
 
 When the answer is something the person will look at more than once, or is too big for a chat reply, make an artifact instead of writing it out: a report, a dashboard, a tracker, a plan, a comparison, an explainer. A short answer stays a short answer in the chat.
 
+An artifact is how a page reaches people. KYBER Studio, the phone app and Buzz show it as a card they open, and in a Buzz channel everyone in that channel can open it. So when someone asks you to send, share or show them a page or document you made, such as an HTML file, a brief or a report, make it an artifact (give its path when it is already a file you wrote, such as one under /workspace) or update the one you made before. Do not try to upload or attach the file through a chat tool: those run on another machine and cannot reach the files you write while you work.
+
 - One artifact per thing. When the person asks for a change, update the same artifact; do not make a second one. Use list to find it again in a later conversation.
 - HTML is one self-contained page. Put the CSS and any script inline and write the data into the page. Nothing outside the page loads: no external scripts, fonts, images or requests.
 - Use plain, semantic HTML (headings, tables, lists, sections) so the app's own styles fit it. Keep colours to black, white and greys unless a chart needs to tell series apart.

package/dist/extension/tools/create.mjs

@@ -9,7 +9,7 @@ import { contentFrom, forModel, requireDisk, result } from "../lib/shared.mjs";
 import { defineTool } from "eve/tools";
 import { z } from "zod";
 var create_default = defineTool({
-	description: "Make an artifact: a page the person keeps and comes back to, such as a report, a dashboard, a tracker, a plan or an explainer. It shows as a card in the person's chat (KYBER Studio, the phone app, Buzz) with an Open button. Give either `content` (the whole page) or `path` (a file in your sandbox). HTML is one self-contained file: inline CSS and script, data written into the page, no external scripts, fonts, images or network calls (they are blocked). To change an artifact later, use update with its id instead of making a new one.",
+	description: "Make an artifact: a page the person keeps and comes back to, such as a report, a dashboard, a tracker, a plan or an explainer. It shows as a card in the person's chat (KYBER Studio, the phone app, Buzz) with an Open button, and in a Buzz channel everyone there can open it. This is also how to send someone a page or document you already wrote to a file: pass its `path`, since chat uploads cannot reach your sandbox. Give either `content` (the whole page) or `path` (a file in your sandbox). HTML is one self-contained file: inline CSS and script, data written into the page, no external scripts, fonts, images or network calls (they are blocked). To change an artifact later, use update with its id instead of making a new one.",
 	inputSchema: z.object({
 		title: z.string().describe("A short name for the page, in the person's words, e.g. \"Website, last 7 days\"."),
 		content: z.string().optional().describe("The whole page: one HTML document, or markdown when format is markdown."),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kybernesis/artifacts",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Artifacts for eve agents: pages an agent makes for a person (reports, dashboards, trackers) that KYBER Studio and the phone draw inline, stored on the agent's own machine.",
   "license": "Apache-2.0",
   "type": "module",