@dxos/plugin-debug 0.12.0-next-73daef452f1464b62efdbca75fb0067c1066f264 → 0.13.0

package/dist/lib/chunk-WeatherSpace.mjs

@@ -0,0 +1,206 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import * as Effect from "effect/Effect";
+import * as SampleSpace from "@dxos/app-toolkit/SampleSpace";
+import { Database, Obj, Ref } from "@dxos/echo";
+import * as Instructions from "@dxos/compute/Instructions";
+import * as Project from "@dxos/compute/Project";
+import { EntityId } from "@dxos/echo/Key";
+import { Outline, Task, TaskSet } from "@dxos/types";
+import { Text } from "@dxos/schema";
+import * as Skill from "@dxos/compute/Skill";
+import * as Template from "@dxos/compute/Template";
+import { trim } from "@dxos/util";
+//#region src/samples/weather/project.ts
+var INSTRUCTIONS$1 = `Build, deploy, configure and test the weather MCP server described by the task \
+list, on your own and in one go: start the first task now, work them in order, and set each one's \
+status as you finish it. Do not stop to ask — nothing in this project needs me.
+
+The task descriptions are the whole specification: one Worker, one tool (\`get_weather\`), one \
+upstream API. There is no design stage. If a step starts to look like architecture, it is the wrong step.
+
+Write the code yourself in one sandbox, driving it through the Sandbox skill \
+(\`org.dxos.skill.sandbox\`). Do not delegate to the coding agent in the sandbox image — it has none \
+of this space's context.
+
+The server is called from a browser, so it must answer CORS preflights and send CORS headers on \
+every response — without them the tool silently never connects. Deploy with \`wrangler deploy --temporary\`. Do not claim the account and never file or repeat the \
+claim URL. The container is not durable, so file the Worker URL and the tool's response on this \
+project in the turn you produce them.
+
+Configure the server by setting its URL on the Weather MCP skill's \`mcpServers\` with the Database \
+skill; that skill is already bound here, so the tool is available on your next turn.
+
+This project needs no Cloudflare login and no API keys. If a step seems to need either, that is the \
+wrong step.`;
+/**
+* The work-stream. It adopts the task set the tasks phase built and binds the Weather MCP skill
+* through `instructions.skills` — the only path a seeded skill reaches a chat by — so the run can
+* configure the server with one update and no enable step.
+*/
+var ProjectPhase = SampleSpace.phase("project", {
+	schemas: [
+		Project.Project,
+		Instructions.Instructions,
+		Outline.Outline,
+		Text.Text
+	],
+	run: ({ tasks, skill }) => Effect.gen(function* () {
+		const instructions = yield* Database.add(Instructions.make({
+			name: "Weather MCP",
+			text: INSTRUCTIONS$1,
+			skills: [Ref.make(skill.skill)],
+			objects: [Ref.make(tasks.taskSet)]
+		}));
+		return {
+			project: yield* Database.add(Project.make({
+				name: "Weather MCP",
+				description: "A one-tool MCP server over the Open-Meteo forecast, deployed as a temporary Cloudflare Worker and called from this chat.",
+				status: "active",
+				instructions: Ref.make(instructions),
+				taskSet: Ref.make(tasks.taskSet)
+			})),
+			instructions
+		};
+	})
+});
+//#endregion
+//#region src/samples/weather/skill.ts
+var INSTRUCTIONS = trim`
+  Carries the weather MCP server this project deploys. Its \`mcpServers\` list starts empty: the
+  Worker URL only exists once the deploy has run, and the run sets it here. A chat with this skill
+  bound connects every listed server at the start of each turn, so the \`get_weather\` tool appears
+  on the turn after the URL is set.
+`;
+/**
+* The skill the deployed server hangs off. Seeded rather than created by the run because a skill is
+* the one place a chat reads MCP servers from, and the project's instructions can bind a seeded
+* object — so configuring the server is one field update, not a skill to author and enable.
+*/
+var WeatherSkill = SampleSpace.phase("skill", {
+	schemas: [Skill.Skill, Text.Text],
+	run: () => Effect.gen(function* () {
+		return { skill: yield* Database.add(Skill.make({
+			key: "org.dxos.skill.weatherMcp",
+			name: "Weather MCP",
+			description: "The weather MCP server deployed by this project.",
+			instructions: Template.make({ source: INSTRUCTIONS }),
+			mcpServers: [],
+			agentCanEnable: true
+		})) };
+	})
+});
+//#endregion
+//#region src/samples/weather/util.ts
+/** Stable reference date so regenerations are reproducible. Override with NOW=2026-05-20 env. */
+var REFERENCE = process.env.NOW ? new Date(process.env.NOW) : /* @__PURE__ */ new Date("2026-05-20T15:00:00Z");
+/** ISO timestamp that many days before {@link REFERENCE}, at an optional UTC hour of that day. */
+var daysAgo = SampleSpace.makeClock(REFERENCE).daysAgo;
+/** The upstream the Worker's one tool wraps; parameterised on coordinates by the tool. */
+var FORECAST_URL = "https://api.open-meteo.com/v1/forecast?latitude=52.52&longitude=13.41&current=temperature_2m,wind_speed_10m&hourly=temperature_2m,relative_humidity_2m,wind_speed_10m";
+//#endregion
+//#region src/samples/weather/tasks.ts
+var STEPS = [
+	{
+		title: "Build the weather MCP Worker",
+		description: `One sandbox for the run. A TypeScript Worker that speaks MCP over Streamable HTTP on one endpoint — \`initialize\`, \`tools/list\` and \`tools/call\` — with exactly one tool, \`get_weather\`, taking \`latitude\` and \`longitude\` and returning the current temperature and wind speed plus the hourly series from ${FORECAST_URL} with those coordinates substituted. The MCP client runs in the browser, so every response must carry CORS headers and an \`OPTIONS\` preflight must answer 204: \`Access-Control-Allow-Origin: *\`, \`Access-Control-Allow-Methods: GET, POST, DELETE, OPTIONS\`, \`Access-Control-Allow-Headers\` covering \`content-type\`, \`accept\`, \`authorization\`, \`mcp-session-id\` and \`mcp-protocol-version\`, and \`Access-Control-Expose-Headers: mcp-session-id\`. No auth, no dependencies beyond wrangler. The client is the MCP TypeScript SDK's Streamable HTTP transport, and it needs more than the three methods: answer every request with \`Content-Type: application/json\` and a JSON-RPC response object at HTTP 200 — an unknown method too, as a JSON-RPC error, never a 4xx; in \`initialize\` echo the \`protocolVersion\` the client sent, with \`capabilities: { tools: {} }\` and a \`serverInfo\`; answer any notification (a message with no \`id\`, such as \`notifications/initialized\`) with 202 and no body, since a client whose notification gets a 4xx never finishes connecting; answer \`GET\` and \`DELETE\` on the endpoint with 405. Return the tool's result as \`{ content: [{ type: 'text', text: <the forecast as JSON> }] }\`. \`--temporary\` needs wrangler 4.102+, which needs Node 22 while the sandbox runs Node 20: install \`wrangler@latest\` and run it as \`npx --yes node@22 node_modules/wrangler/bin/wrangler.js\`.`,
+		estimate: "s"
+	},
+	{
+		title: "Deploy it to a temporary Cloudflare account",
+		description: "`wrangler deploy --temporary` — plain `wrangler deploy` demands a token non-interactively. File the Worker URL on the project. Do not claim the account and do not file or repeat the claim URL: it is a bearer credential, and this run never needs it.",
+		estimate: "xs"
+	},
+	{
+		title: "Configure the server for this space",
+		description: "Set the Worker URL on the Weather MCP skill's `mcpServers` as `{ name: 'weather', url, protocol: 'http' }` through the Database skill's update tool. The skill is already bound to this chat and servers are connected at the start of every turn, so `get_weather` appears on your next turn — no restart.",
+		estimate: "xs"
+	},
+	{
+		title: "Test the tool from this chat",
+		description: "Before calling, check CORS against the deployed URL — `curl -i -X OPTIONS -H \"Origin: http://localhost\" -H \"Access-Control-Request-Method: POST\" -H \"Access-Control-Request-Headers: content-type,mcp-session-id\" <url>` must return the allow headers; a browser client fails its preflight otherwise, and the tool never appears. Then call `get_weather` for Berlin (52.52, 13.41) and file the response on the project. The call has to appear as a tool call in the transcript; a forecast the model produced on its own is a failure, not a pass.",
+		estimate: "xs"
+	}
+];
+/** The four steps, each depending on the one before it. */
+var Tasks = SampleSpace.phase("tasks", {
+	schemas: [TaskSet.TaskSet, Task.Task],
+	run: () => Effect.gen(function* () {
+		const taskSet = yield* Database.add(TaskSet.make({
+			name: "Weather MCP",
+			description: "From an empty sandbox to a weather tool this chat calls."
+		}));
+		const tasks = STEPS.map((step) => Task.make({
+			title: step.title,
+			description: step.description,
+			estimate: step.estimate,
+			status: "todo",
+			history: [{
+				id: EntityId.random(),
+				date: daysAgo(0),
+				event: "created",
+				description: "Filed from the weather MCP template."
+			}]
+		}));
+		yield* SampleSpace.children(taskSet, tasks, (taskSet, refs) => {
+			taskSet.tasks = refs;
+		});
+		for (const [index, task] of tasks.entries()) if (index > 0) {
+			const previous = tasks[index - 1];
+			Obj.update(task, (task) => {
+				task.dependsOn = [Ref.make(previous)];
+			});
+		}
+		return {
+			taskSet,
+			tasks
+		};
+	})
+});
+//#endregion
+//#region src/samples/weather/WeatherSpace.ts
+var WeatherSpace_exports = /* @__PURE__ */ __exportAll({
+	FORECAST_URL: () => FORECAST_URL,
+	make: () => make,
+	makeTemplate: () => makeTemplate
+});
+var phases = {
+	skill: WeatherSkill,
+	tasks: Tasks,
+	project: ProjectPhase
+};
+/**
+* The fastest loop through building an MCP server and using it: one Worker with one tool over the
+* Open-Meteo forecast, four tasks from an empty sandbox to a tool call in this chat, all of them the
+* agent's.
+*
+* It sits between `WorkerSpace` (a deploy with nothing to call) and `StockfishSpace` (an engine, a
+* design stage and a publish step): enough to exercise the whole build → deploy → configure → call
+* path, small enough to run unattended. The account stays temporary and unclaimed, and the server is
+* configured on a seeded skill because a skill is where a chat reads MCP servers from.
+*/
+var make = () => SampleSpace.make({
+	space: {
+		name: "Weather MCP",
+		icon: "sun",
+		hue: "sky"
+	},
+	reference: REFERENCE,
+	phases,
+	build: (phases) => Effect.gen(function* () {
+		const skill = yield* phases.skill();
+		const tasks = yield* phases.tasks();
+		yield* phases.project({
+			tasks,
+			skill
+		});
+	})
+});
+var makeTemplate = () => SampleSpace.makeTemplate({
+	id: "org.dxos.plugin-debug.template.weather",
+	description: "Four tasks an agent runs alone: a one-tool MCP server over a weather API, deployed to a temporary Worker and called from the chat.",
+	definition: make()
+});
+//#endregion
+export { FORECAST_URL as i, make as n, makeTemplate as r, WeatherSpace_exports as t };
+
+//# sourceMappingURL=chunk-WeatherSpace.mjs.map

package/dist/lib/chunk-WeatherSpace.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-WeatherSpace.mjs","names":[],"sources":["../../src/samples/weather/project.ts","../../src/samples/weather/skill.ts","../../src/samples/weather/util.ts","../../src/samples/weather/tasks.ts","../../src/samples/weather/WeatherSpace.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport * as SampleSpace from '@dxos/app-toolkit/SampleSpace';\nimport * as Instructions from '@dxos/compute/Instructions';\nimport * as Project from '@dxos/compute/Project';\nimport { Database, Ref } from '@dxos/echo';\nimport { Text } from '@dxos/schema';\nimport { Outline } from '@dxos/types';\n\nimport { type SkillResult } from './skill.ts';\nimport { type TasksResult } from './tasks.ts';\n\nexport type ProjectInput = { tasks: TasksResult; skill: SkillResult };\n\nexport type ProjectResult = { project: Project.Project; instructions: Instructions.Instructions };\n\nconst INSTRUCTIONS = `Build, deploy, configure and test the weather MCP server described by the task \\\nlist, on your own and in one go: start the first task now, work them in order, and set each one's \\\nstatus as you finish it. Do not stop to ask — nothing in this project needs me.\n\nThe task descriptions are the whole specification: one Worker, one tool (\\`get_weather\\`), one \\\nupstream API. There is no design stage. If a step starts to look like architecture, it is the wrong step.\n\nWrite the code yourself in one sandbox, driving it through the Sandbox skill \\\n(\\`org.dxos.skill.sandbox\\`). Do not delegate to the coding agent in the sandbox image — it has none \\\nof this space's context.\n\nThe server is called from a browser, so it must answer CORS preflights and send CORS headers on \\\nevery response — without them the tool silently never connects. Deploy with \\`wrangler deploy --temporary\\`. Do not claim the account and never file or repeat the \\\nclaim URL. The container is not durable, so file the Worker URL and the tool's response on this \\\nproject in the turn you produce them.\n\nConfigure the server by setting its URL on the Weather MCP skill's \\`mcpServers\\` with the Database \\\nskill; that skill is already bound here, so the tool is available on your next turn.\n\nThis project needs no Cloudflare login and no API keys. If a step seems to need either, that is the \\\nwrong step.`;\n\n/**\n * The work-stream. It adopts the task set the tasks phase built and binds the Weather MCP skill\n * through `instructions.skills` — the only path a seeded skill reaches a chat by — so the run can\n * configure the server with one update and no enable step.\n */\nexport const ProjectPhase: SampleSpace.Phase<ProjectResult, ProjectInput> = SampleSpace.phase('project', {\n  // `Project.make` builds an outline for the project and the instructions' prose is stored as a\n  // Text; a phase has to declare every type it persists or the space cannot register it.\n  schemas: [Project.Project, Instructions.Instructions, Outline.Outline, Text.Text],\n  run: ({ tasks, skill }: ProjectInput) =>\n    Effect.gen(function* () {\n      const instructions = yield* Database.add(\n        Instructions.make({\n          name: 'Weather MCP',\n          text: INSTRUCTIONS,\n          skills: [Ref.make(skill.skill)],\n          objects: [Ref.make(tasks.taskSet)],\n        }),\n      );\n\n      const project = yield* Database.add(\n        Project.make({\n          name: 'Weather MCP',\n          description:\n            'A one-tool MCP server over the Open-Meteo forecast, deployed as a temporary Cloudflare Worker and called from this chat.',\n          status: 'active',\n          instructions: Ref.make(instructions),\n          taskSet: Ref.make(tasks.taskSet),\n        }),\n      );\n\n      return { project, instructions };\n    }),\n});\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport * as SampleSpace from '@dxos/app-toolkit/SampleSpace';\nimport * as Skill from '@dxos/compute/Skill';\nimport * as Template from '@dxos/compute/Template';\nimport { Database } from '@dxos/echo';\nimport { Text } from '@dxos/schema';\nimport { trim } from '@dxos/util';\n\nconst INSTRUCTIONS = trim`\n  Carries the weather MCP server this project deploys. Its \\`mcpServers\\` list starts empty: the\n  Worker URL only exists once the deploy has run, and the run sets it here. A chat with this skill\n  bound connects every listed server at the start of each turn, so the \\`get_weather\\` tool appears\n  on the turn after the URL is set.\n`;\n\nexport type SkillResult = { skill: Skill.Skill };\n\n/**\n * The skill the deployed server hangs off. Seeded rather than created by the run because a skill is\n * the one place a chat reads MCP servers from, and the project's instructions can bind a seeded\n * object — so configuring the server is one field update, not a skill to author and enable.\n */\nexport const WeatherSkill: SampleSpace.Phase<SkillResult> = SampleSpace.phase('skill', {\n  schemas: [Skill.Skill, Text.Text],\n  run: () =>\n    Effect.gen(function* () {\n      const skill = yield* Database.add(\n        Skill.make({\n          key: 'org.dxos.skill.weatherMcp',\n          name: 'Weather MCP',\n          description: 'The weather MCP server deployed by this project.',\n          instructions: Template.make({ source: INSTRUCTIONS }),\n          mcpServers: [],\n          agentCanEnable: true,\n        }),\n      );\n\n      return { skill };\n    }),\n});\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport * as SampleSpace from '@dxos/app-toolkit/SampleSpace';\n\n/** Stable reference date so regenerations are reproducible. Override with NOW=2026-05-20 env. */\nexport const REFERENCE = process.env.NOW ? new Date(process.env.NOW) : new Date('2026-05-20T15:00:00Z');\n\n/**\n * Bound to the same reference the definition declares, so the pure content builders can date their\n * objects without every one of them being an effect.\n */\nexport const clock = SampleSpace.makeClock(REFERENCE);\n\n/** ISO timestamp that many days before {@link REFERENCE}, at an optional UTC hour of that day. */\nexport const daysAgo = clock.daysAgo;\n\n/** The upstream the Worker's one tool wraps; parameterised on coordinates by the tool. */\nexport const FORECAST_URL =\n  'https://api.open-meteo.com/v1/forecast?latitude=52.52&longitude=13.41&current=temperature_2m,wind_speed_10m&hourly=temperature_2m,relative_humidity_2m,wind_speed_10m';\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport * as SampleSpace from '@dxos/app-toolkit/SampleSpace';\nimport { Database, Obj, Ref } from '@dxos/echo';\nimport { EntityId } from '@dxos/echo/Key';\nimport { Task, TaskSet } from '@dxos/types';\n\nimport { FORECAST_URL, daysAgo } from './util.ts';\n\n//\n// Four steps, flat and in order, all the agent's: nothing here needs the reader, so a chat can run\n// the plan end to end on its own. Each depends on the one before it, so a runner working ahead is\n// visibly out of order rather than merely early.\n//\n\ntype TaskSeed = {\n  readonly title: string;\n  readonly description: string;\n  readonly estimate?: Task.Estimate;\n};\n\nconst STEPS: ReadonlyArray<TaskSeed> = [\n  {\n    title: 'Build the weather MCP Worker',\n    description: `One sandbox for the run. A TypeScript Worker that speaks MCP over Streamable HTTP on one endpoint — \\`initialize\\`, \\`tools/list\\` and \\`tools/call\\` — with exactly one tool, \\`get_weather\\`, taking \\`latitude\\` and \\`longitude\\` and returning the current temperature and wind speed plus the hourly series from ${FORECAST_URL} with those coordinates substituted. The MCP client runs in the browser, so every response must carry CORS headers and an \\`OPTIONS\\` preflight must answer 204: \\`Access-Control-Allow-Origin: *\\`, \\`Access-Control-Allow-Methods: GET, POST, DELETE, OPTIONS\\`, \\`Access-Control-Allow-Headers\\` covering \\`content-type\\`, \\`accept\\`, \\`authorization\\`, \\`mcp-session-id\\` and \\`mcp-protocol-version\\`, and \\`Access-Control-Expose-Headers: mcp-session-id\\`. No auth, no dependencies beyond wrangler. The client is the MCP TypeScript SDK's Streamable HTTP transport, and it needs more than the three methods: answer every request with \\`Content-Type: application/json\\` and a JSON-RPC response object at HTTP 200 — an unknown method too, as a JSON-RPC error, never a 4xx; in \\`initialize\\` echo the \\`protocolVersion\\` the client sent, with \\`capabilities: { tools: {} }\\` and a \\`serverInfo\\`; answer any notification (a message with no \\`id\\`, such as \\`notifications/initialized\\`) with 202 and no body, since a client whose notification gets a 4xx never finishes connecting; answer \\`GET\\` and \\`DELETE\\` on the endpoint with 405. Return the tool's result as \\`{ content: [{ type: 'text', text: <the forecast as JSON> }] }\\`. \\`--temporary\\` needs wrangler 4.102+, which needs Node 22 while the sandbox runs Node 20: install \\`wrangler@latest\\` and run it as \\`npx --yes node@22 node_modules/wrangler/bin/wrangler.js\\`.`,\n    estimate: 's',\n  },\n  {\n    title: 'Deploy it to a temporary Cloudflare account',\n    description:\n      '`wrangler deploy --temporary` — plain `wrangler deploy` demands a token non-interactively. File the Worker URL on the project. Do not claim the account and do not file or repeat the claim URL: it is a bearer credential, and this run never needs it.',\n    estimate: 'xs',\n  },\n  {\n    title: 'Configure the server for this space',\n    description:\n      \"Set the Worker URL on the Weather MCP skill's `mcpServers` as `{ name: 'weather', url, protocol: 'http' }` through the Database skill's update tool. The skill is already bound to this chat and servers are connected at the start of every turn, so `get_weather` appears on your next turn — no restart.\",\n    estimate: 'xs',\n  },\n  {\n    title: 'Test the tool from this chat',\n    description:\n      'Before calling, check CORS against the deployed URL — `curl -i -X OPTIONS -H \"Origin: http://localhost\" -H \"Access-Control-Request-Method: POST\" -H \"Access-Control-Request-Headers: content-type,mcp-session-id\" <url>` must return the allow headers; a browser client fails its preflight otherwise, and the tool never appears. Then call `get_weather` for Berlin (52.52, 13.41) and file the response on the project. The call has to appear as a tool call in the transcript; a forecast the model produced on its own is a failure, not a pass.',\n    estimate: 'xs',\n  },\n];\n\nexport type TasksResult = { taskSet: TaskSet.TaskSet; tasks: Task.Task[] };\n\n/** The four steps, each depending on the one before it. */\nexport const Tasks: SampleSpace.Phase<TasksResult> = SampleSpace.phase('tasks', {\n  schemas: [TaskSet.TaskSet, Task.Task],\n  run: () =>\n    Effect.gen(function* () {\n      const taskSet = yield* Database.add(\n        TaskSet.make({\n          name: 'Weather MCP',\n          description: 'From an empty sandbox to a weather tool this chat calls.',\n        }),\n      );\n\n      const tasks = STEPS.map((step) =>\n        Task.make({\n          title: step.title,\n          description: step.description,\n          estimate: step.estimate,\n          status: 'todo',\n          // Task carries no due date; its dates are activity-log lines, so that is where they go.\n          history: [\n            {\n              id: EntityId.random(),\n              date: daysAgo(0),\n              event: 'created' as const,\n              description: 'Filed from the weather MCP template.',\n            },\n          ],\n        }),\n      );\n      yield* SampleSpace.children(taskSet, tasks, (taskSet, refs) => {\n        taskSet.tasks = refs;\n      });\n\n      for (const [index, task] of tasks.entries()) {\n        if (index > 0) {\n          const previous = tasks[index - 1];\n          Obj.update(task, (task) => {\n            task.dependsOn = [Ref.make(previous)];\n          });\n        }\n      }\n\n      return { taskSet, tasks };\n    }),\n});\n","//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Effect from 'effect/Effect';\n\nimport type * as AppCapabilities from '@dxos/app-toolkit/AppCapabilities';\nimport * as SampleSpace from '@dxos/app-toolkit/SampleSpace';\n\nimport { ProjectPhase } from './project.ts';\nimport { WeatherSkill } from './skill.ts';\nimport { Tasks } from './tasks.ts';\nimport { REFERENCE } from './util.ts';\n\nexport { FORECAST_URL } from './util.ts';\n\nconst phases = {\n  skill: WeatherSkill,\n  tasks: Tasks,\n  project: ProjectPhase,\n};\n\n/**\n * The fastest loop through building an MCP server and using it: one Worker with one tool over the\n * Open-Meteo forecast, four tasks from an empty sandbox to a tool call in this chat, all of them the\n * agent's.\n *\n * It sits between `WorkerSpace` (a deploy with nothing to call) and `StockfishSpace` (an engine, a\n * design stage and a publish step): enough to exercise the whole build → deploy → configure → call\n * path, small enough to run unattended. The account stays temporary and unclaimed, and the server is\n * configured on a seeded skill because a skill is where a chat reads MCP servers from.\n */\nexport const make = (): SampleSpace.Definition<typeof phases, void> =>\n  SampleSpace.make({\n    // Reaches a space only where the definition is applied directly (the generator panel, the\n    // archive test): the create-space dialog takes its icon from `space-templates.ts`.\n    space: { name: 'Weather MCP', icon: 'sun', hue: 'sky' },\n    reference: REFERENCE,\n    phases,\n    build: (phases) =>\n      Effect.gen(function* () {\n        const skill = yield* phases.skill();\n        const tasks = yield* phases.tasks();\n        yield* phases.project({ tasks, skill });\n\n        // No root collection: this space seeds no documents — the project, its tasks and the skill\n        // surface through their own containers.\n      }),\n  });\n\nexport const makeTemplate = (): AppCapabilities.SpaceTemplate =>\n  SampleSpace.makeTemplate({\n    id: 'org.dxos.plugin-debug.template.weather',\n    description:\n      'Four tasks an agent runs alone: a one-tool MCP server over a weather API, deployed to a temporary Worker and called from the chat.',\n    definition: make(),\n  });\n"],"mappings":";;;;;;;;;;;;;AAoBA,IAAM,iBAAe;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BrB,IAAa,eAA+D,YAAY,MAAM,WAAW;CAGvG,SAAS;EAAC,QAAQ;EAAS,aAAa;EAAc,QAAQ;EAAS,KAAK;CAAI;CAChF,MAAM,EAAE,OAAO,YACb,OAAO,IAAI,aAAa;EACtB,MAAM,eAAe,OAAO,SAAS,IACnC,aAAa,KAAK;GAChB,MAAM;GACN,MAAM;GACN,QAAQ,CAAC,IAAI,KAAK,MAAM,KAAK,CAAC;GAC9B,SAAS,CAAC,IAAI,KAAK,MAAM,OAAO,CAAC;EACnC,CAAC,CACH;EAaA,OAAO;GAAE,SAAA,OAXc,SAAS,IAC9B,QAAQ,KAAK;IACX,MAAM;IACN,aACE;IACF,QAAQ;IACR,cAAc,IAAI,KAAK,YAAY;IACnC,SAAS,IAAI,KAAK,MAAM,OAAO;GACjC,CAAC,CACH;GAEkB;EAAa;CACjC,CAAC;AACL,CAAC;;;AC9DD,IAAM,eAAe,IAAI;;;;;;;;;;;AAczB,IAAa,eAA+C,YAAY,MAAM,SAAS;CACrF,SAAS,CAAC,MAAM,OAAO,KAAK,IAAI;CAChC,WACE,OAAO,IAAI,aAAa;EAYtB,OAAO,EAAE,OAAA,OAXY,SAAS,IAC5B,MAAM,KAAK;GACT,KAAK;GACL,MAAM;GACN,aAAa;GACb,cAAc,SAAS,KAAK,EAAE,QAAQ,aAAa,CAAC;GACpD,YAAY,CAAC;GACb,gBAAgB;EAClB,CAAC,CACH,EAEe;CACjB,CAAC;AACL,CAAC;;;;ACrCD,IAAa,YAAY,QAAQ,IAAI,MAAM,IAAI,KAAK,QAAQ,IAAI,GAAG,oBAAI,IAAI,KAAK,sBAAsB;;AAStG,IAAa,UAHQ,YAAY,UAAU,SAGpB,CAAA,CAAM;;AAG7B,IAAa,eACX;;;ACKF,IAAM,QAAiC;CACrC;EACE,OAAO;EACP,aAAa,0TAA0T,aAAa;EACpV,UAAU;CACZ;CACA;EACE,OAAO;EACP,aACE;EACF,UAAU;CACZ;CACA;EACE,OAAO;EACP,aACE;EACF,UAAU;CACZ;CACA;EACE,OAAO;EACP,aACE;EACF,UAAU;CACZ;AACF;;AAKA,IAAa,QAAwC,YAAY,MAAM,SAAS;CAC9E,SAAS,CAAC,QAAQ,SAAS,KAAK,IAAI;CACpC,WACE,OAAO,IAAI,aAAa;EACtB,MAAM,UAAU,OAAO,SAAS,IAC9B,QAAQ,KAAK;GACX,MAAM;GACN,aAAa;EACf,CAAC,CACH;EAEA,MAAM,QAAQ,MAAM,KAAK,SACvB,KAAK,KAAK;GACR,OAAO,KAAK;GACZ,aAAa,KAAK;GAClB,UAAU,KAAK;GACf,QAAQ;GAER,SAAS,CACP;IACE,IAAI,SAAS,OAAO;IACpB,MAAM,QAAQ,CAAC;IACf,OAAO;IACP,aAAa;GACf,CACF;EACF,CAAC,CACH;EACA,OAAO,YAAY,SAAS,SAAS,QAAQ,SAAS,SAAS;GAC7D,QAAQ,QAAQ;EAClB,CAAC;EAED,KAAK,MAAM,CAAC,OAAO,SAAS,MAAM,QAAQ,GACxC,IAAI,QAAQ,GAAG;GACb,MAAM,WAAW,MAAM,QAAQ;GAC/B,IAAI,OAAO,OAAO,SAAS;IACzB,KAAK,YAAY,CAAC,IAAI,KAAK,QAAQ,CAAC;GACtC,CAAC;EACH;EAGF,OAAO;GAAE;GAAS;EAAM;CAC1B,CAAC;AACL,CAAC;;;;;;;;AC/ED,IAAM,SAAS;CACb,OAAO;CACP,OAAO;CACP,SAAS;AACX;;;;;;;;;;;AAYA,IAAa,aACX,YAAY,KAAK;CAGf,OAAO;EAAE,MAAM;EAAe,MAAM;EAAO,KAAK;CAAM;CACtD,WAAW;CACX;CACA,QAAQ,WACN,OAAO,IAAI,aAAa;EACtB,MAAM,QAAQ,OAAO,OAAO,MAAM;EAClC,MAAM,QAAQ,OAAO,OAAO,MAAM;EAClC,OAAO,OAAO,QAAQ;GAAE;GAAO;EAAM,CAAC;CAIxC,CAAC;AACL,CAAC;AAEH,IAAa,qBACX,YAAY,aAAa;CACvB,IAAI;CACJ,aACE;CACF,YAAY,KAAK;AACnB,CAAC"}

package/dist/lib/chunk-Wireframe.mjs

@@ -1,11 +1,11 @@
-import "react";
 import { Obj } from "@dxos/echo";
-import { Flex } from "@dxos/react-ui";
+import "react";
 import { mx } from "@dxos/ui-theme";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { JsonHighlighter } from "@dxos/react-ui-syntax-highlighter";
-import { useResizeDetector } from "react-resize-detector";
 import { useAttentionAttributes } from "@dxos/react-ui-attention";
+import * as Layout from "@dxos/react-ui/Layout";
+import { useResizeDetector } from "react-resize-detector";
 //#region src/containers/Wireframe/Wireframe.tsx
 var Wireframe = ({ classNames, label, object }) => {
 	const attentionAttrs = useAttentionAttributes(Obj.getURI(object));
@@ -14,11 +14,11 @@ var Wireframe = ({ classNames, label, object }) => {
 		ref,
 		className: mx("relative grow min-h-96", classNames),
 		...attentionAttrs,
-		children: [/* @__PURE__ */ jsxs(Flex, {
+		children: [/* @__PURE__ */ jsxs(Layout.Flex, {
 			column: true,
 			gap: "sm",
 			classNames: "absolute inset-2 overflow-hidden font-mono",
-			children: [/* @__PURE__ */ jsxs(Flex, {
+			children: [/* @__PURE__ */ jsxs(Layout.Flex, {
 				justify: "between",
 				children: [/* @__PURE__ */ jsx("div", { children: label }), /* @__PURE__ */ jsx("div", { children: `[${width}x${height}]` })]
 			}), object && /* @__PURE__ */ jsx(JsonHighlighter, {
@@ -28,7 +28,7 @@ var Wireframe = ({ classNames, label, object }) => {
 		}), /* @__PURE__ */ jsxs("svg", {
 			width,
 			height,
-			className: "bg-transparent *:text-subdued",
+			className: "bg-transparent *:text-fg-subtle",
 			children: [
 				/* @__PURE__ */ jsx("rect", {
 					x: 0,

package/dist/lib/chunk-Wireframe.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"chunk-Wireframe.mjs","names":[],"sources":["../../src/containers/Wireframe/Wireframe.tsx"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport React from 'react';\nimport { useResizeDetector } from 'react-resize-detector';\n\nimport { Obj } from '@dxos/echo';\nimport { Flex, type ThemedClassName } from '@dxos/react-ui';\nimport { useAttentionAttributes } from '@dxos/react-ui-attention';\nimport { JsonHighlighter } from '@dxos/react-ui-syntax-highlighter';\nimport { mx } from '@dxos/ui-theme';\n\n// TODO(burdon): Create generic container with wireframe mode.\nexport type WireframeProps = ThemedClassName<{\n  object: Obj.Unknown;\n  label?: string;\n}>;\n\n// TODO(burdon): Make focusable and attendable with input.\nexport const Wireframe = ({ classNames, label, object }: WireframeProps) => {\n  const attentionAttrs = useAttentionAttributes(Obj.getURI(object));\n  const { width, height, ref } = useResizeDetector();\n\n  return (\n    <div ref={ref} className={mx('relative grow min-h-96', classNames)} {...attentionAttrs}>\n      <Flex column gap='sm' classNames='absolute inset-2 overflow-hidden font-mono'>\n        <Flex justify='between'>\n          <div>{label}</div>\n          <div>{`[${width}x${height}]`}</div>\n        </Flex>\n        {object && <JsonHighlighter data={object} classNames='text-xs opacity-75 rounded-sm' />}\n      </Flex>\n      <svg width={width} height={height} className='bg-transparent *:text-subdued'>\n        <rect x={0} y={0} width={width} height={height} strokeWidth={1} fill='none' />\n        <line x1={0} y1={0} x2={width} y2={height} strokeWidth={1} />\n        <line x1={0} y1={height} x2={width} y2={0} strokeWidth={1} />\n      </svg>\n    </div>\n  );\n};\n\nWireframe.displayName = 'Wireframe';\n"],"mappings":";;;;;;;;;AAoBA,IAAa,aAAa,EAAE,YAAY,OAAO,aAA6B;CAC1E,MAAM,iBAAiB,uBAAuB,IAAI,OAAO,MAAM,CAAC;CAChE,MAAM,EAAE,OAAO,QAAQ,QAAQ,kBAAkB;CAEjD,OACE,qBAAC,OAAD;EAAU;EAAK,WAAW,GAAG,0BAA0B,UAAU;EAAG,GAAI;EAAxE,UAAA,CACE,qBAAC,MAAD;GAAM,QAAA;GAAO,KAAI;GAAK,YAAW;GAAjC,UAAA,CACE,qBAAC,MAAD;IAAM,SAAQ;IAAd,UAAA,CACE,oBAAC,OAAD,EAAA,UAAM,MAAW,CAAA,GACjB,oBAAC,OAAD,EAAA,UAAM,IAAI,MAAM,GAAG,OAAO,GAAQ,CAAA,CAC9B;GACL,CAAA,GAAA,UAAU,oBAAC,iBAAD;IAAiB,MAAM;IAAQ,YAAW;GAAiC,CAAA,CAClF;EACN,CAAA,GAAA,qBAAC,OAAD;GAAY;GAAe;GAAQ,WAAU;GAA7C,UAAA;IACE,oBAAC,QAAD;KAAM,GAAG;KAAG,GAAG;KAAU;KAAe;KAAQ,aAAa;KAAG,MAAK;IAAQ,CAAA;IAC7E,oBAAC,QAAD;KAAM,IAAI;KAAG,IAAI;KAAG,IAAI;KAAO,IAAI;KAAQ,aAAa;IAAI,CAAA;IAC5D,oBAAC,QAAD;KAAM,IAAI;KAAG,IAAI;KAAQ,IAAI;KAAO,IAAI;KAAG,aAAa;IAAI,CAAA;GACzD;EACF,CAAA,CAAA;;AAET;AAEA,UAAU,cAAc"}
+{"version":3,"file":"chunk-Wireframe.mjs","names":[],"sources":["../../src/containers/Wireframe/Wireframe.tsx"],"sourcesContent":["//\n// Copyright 2024 DXOS.org\n//\n\nimport React from 'react';\nimport { useResizeDetector } from 'react-resize-detector';\n\nimport { Obj } from '@dxos/echo';\nimport { useAttentionAttributes } from '@dxos/react-ui-attention';\nimport { JsonHighlighter } from '@dxos/react-ui-syntax-highlighter';\nimport * as Layout from '@dxos/react-ui/Layout';\nimport type * as Util from '@dxos/react-ui/Util';\nimport { mx } from '@dxos/ui-theme';\n\n// TODO(burdon): Create generic container with wireframe mode.\nexport type WireframeProps = Util.ThemedClassName<{\n  object: Obj.Unknown;\n  label?: string;\n}>;\n\n// TODO(burdon): Make focusable and attendable with input.\nexport const Wireframe = ({ classNames, label, object }: WireframeProps) => {\n  const attentionAttrs = useAttentionAttributes(Obj.getURI(object));\n  const { width, height, ref } = useResizeDetector();\n\n  return (\n    <div ref={ref} className={mx('relative grow min-h-96', classNames)} {...attentionAttrs}>\n      <Layout.Flex column gap='sm' classNames='absolute inset-2 overflow-hidden font-mono'>\n        <Layout.Flex justify='between'>\n          <div>{label}</div>\n          <div>{`[${width}x${height}]`}</div>\n        </Layout.Flex>\n        {object && <JsonHighlighter data={object} classNames='text-xs opacity-75 rounded-sm' />}\n      </Layout.Flex>\n      <svg width={width} height={height} className='bg-transparent *:text-fg-subtle'>\n        <rect x={0} y={0} width={width} height={height} strokeWidth={1} fill='none' />\n        <line x1={0} y1={0} x2={width} y2={height} strokeWidth={1} />\n        <line x1={0} y1={height} x2={width} y2={0} strokeWidth={1} />\n      </svg>\n    </div>\n  );\n};\n\nWireframe.displayName = 'Wireframe';\n"],"mappings":";;;;;;;;;AAqBA,IAAa,aAAa,EAAE,YAAY,OAAO,aAA6B;CAC1E,MAAM,iBAAiB,uBAAuB,IAAI,OAAO,MAAM,CAAC;CAChE,MAAM,EAAE,OAAO,QAAQ,QAAQ,kBAAkB;CAEjD,OACE,qBAAC,OAAD;EAAU;EAAK,WAAW,GAAG,0BAA0B,UAAU;EAAG,GAAI;EAAxE,UAAA,CACE,qBAAC,OAAO,MAAR;GAAa,QAAA;GAAO,KAAI;GAAK,YAAW;GAAxC,UAAA,CACE,qBAAC,OAAO,MAAR;IAAa,SAAQ;IAArB,UAAA,CACE,oBAAC,OAAD,EAAA,UAAM,MAAW,CAAA,GACjB,oBAAC,OAAD,EAAA,UAAM,IAAI,MAAM,GAAG,OAAO,GAAQ,CAAA,CACvB;GACZ,CAAA,GAAA,UAAU,oBAAC,iBAAD;IAAiB,MAAM;IAAQ,YAAW;GAAiC,CAAA,CAC3E;EACb,CAAA,GAAA,qBAAC,OAAD;GAAY;GAAe;GAAQ,WAAU;GAA7C,UAAA;IACE,oBAAC,QAAD;KAAM,GAAG;KAAG,GAAG;KAAU;KAAe;KAAQ,aAAa;KAAG,MAAK;IAAQ,CAAA;IAC7E,oBAAC,QAAD;KAAM,IAAI;KAAG,IAAI;KAAG,IAAI;KAAO,IAAI;KAAQ,aAAa;IAAI,CAAA;IAC5D,oBAAC,QAAD;KAAM,IAAI;KAAG,IAAI;KAAQ,IAAI;KAAO,IAAI;KAAG,aAAa;IAAI,CAAA;GACzD;EACF,CAAA,CAAA;;AAET;AAEA,UAAU,cAAc"}

package/dist/lib/chunk-WorkerSpace.mjs

@@ -0,0 +1,177 @@
+import { t as __exportAll } from "./chunk-rolldown-runtime.mjs";
+import * as Effect from "effect/Effect";
+import * as SampleSpace from "@dxos/app-toolkit/SampleSpace";
+import { Database, Obj, Ref } from "@dxos/echo";
+import * as Instructions from "@dxos/compute/Instructions";
+import * as Project from "@dxos/compute/Project";
+import { EntityId } from "@dxos/echo/Key";
+import { Outline, Task, TaskSet } from "@dxos/types";
+import { Text } from "@dxos/schema";
+//#region src/samples/worker/project.ts
+var INSTRUCTIONS = `Deploy the Worker described by the task list, working the tasks in order and \
+setting each one's status as you finish it: the task list is how I follow this run.
+
+What the Worker does is the whole specification — one fetch handler, JSON out, a greeting and the \
+current UTC time. There is no design stage and nothing to choose. If a step starts to look like \
+architecture, it is the wrong step.
+
+Write the code yourself in one sandbox, driving it through the Sandbox skill \
+(\`org.dxos.skill.sandbox\`). The sandbox image ships a coding agent of its own; do not delegate to \
+it — it has none of this space's context, and its output would land on a container filesystem \
+rather than in this project.
+
+The container is not durable, so file what has to outlive it — the Worker URL, the response body — \
+as artifacts on this project in the turn you produce it, not at the end. The claim URL that the \
+deploy prints is a bearer credential for the account: give it to me directly and file it nowhere.
+
+This project needs no Cloudflare login and no API keys. If a step seems to need either, that is the \
+wrong step.`;
+/**
+* The work-stream. It adopts the task set the tasks phase built (`Project.make` would otherwise
+* create its own empty one), and starts with no artifacts: the URL and the response are what the
+* run produces, and seeding either would name something that does not exist.
+*/
+var ProjectPhase = SampleSpace.phase("project", {
+	schemas: [
+		Project.Project,
+		Instructions.Instructions,
+		Outline.Outline,
+		Text.Text
+	],
+	run: ({ tasks }) => Effect.gen(function* () {
+		const instructions = yield* Database.add(Instructions.make({
+			name: "Hello Worker",
+			text: INSTRUCTIONS,
+			objects: [Ref.make(tasks.taskSet)]
+		}));
+		return {
+			project: yield* Database.add(Project.make({
+				name: "Hello Worker",
+				description: "One Cloudflare Worker that answers with a greeting and the time, deployed from a sandbox with no Cloudflare account.",
+				status: "active",
+				instructions: Ref.make(instructions),
+				taskSet: Ref.make(tasks.taskSet)
+			})),
+			instructions
+		};
+	})
+});
+//#endregion
+//#region src/samples/worker/util.ts
+/** Stable reference date so regenerations are reproducible. Override with NOW=2026-05-20 env. */
+var REFERENCE = process.env.NOW ? new Date(process.env.NOW) : /* @__PURE__ */ new Date("2026-05-20T15:00:00Z");
+/** ISO timestamp that many days before {@link REFERENCE}, at an optional UTC hour of that day. */
+var daysAgo = SampleSpace.makeClock(REFERENCE).daysAgo;
+//#endregion
+//#region src/samples/worker/tasks.ts
+var STEPS = [
+	{
+		title: "Create a sandbox and install wrangler",
+		description: "One sandbox for the whole run — it keeps its filesystem between commands, so a second one pays for node and wrangler again. `--temporary` needs wrangler 4.102 or later and that wrangler needs Node 22, while the sandbox runs Node 20: install `wrangler@latest` explicitly and run its script under a newer node — `npx --yes node@22 node_modules/wrangler/bin/wrangler.js` — since a plain install resolves to the last version that fits Node 20 and has no flag. Creating one and running commands in it belong to the Sandbox skill.",
+		estimate: "s"
+	},
+	{
+		title: "Write the Worker",
+		description: "A TypeScript Worker whose fetch handler answers every request with JSON: a greeting and the current UTC time. No router, no dependencies, no build step beyond wrangler's own.",
+		estimate: "xs"
+	},
+	{
+		title: "Deploy it with no Cloudflare login",
+		description: "`wrangler deploy --temporary` mints a temporary account and prints a Worker URL and a claim URL; plain `wrangler deploy` refuses non-interactively and demands a token, so the flag is not optional. File the Worker URL on the project. The claim URL is a bearer credential — hand it straight to me and file it nowhere.",
+		estimate: "s"
+	},
+	{
+		title: "Fetch the deployed URL and check the response",
+		description: "Fetch it and paste the body into the project. A deploy command that exited zero is not evidence that anything is serving.",
+		estimate: "xs"
+	},
+	{
+		title: "Claim the temporary Cloudflare account",
+		description: "Yours to do: claiming signs the account into yours, which needs a browser the agent does not have. It comes after the last deploy — an agent with no login cannot update a claimed account, and `--temporary` would mint a second one under a different URL. Do it inside the hour; the account expires with the Worker on it.",
+		estimate: "xs",
+		assignee: {
+			role: "user",
+			name: "You"
+		}
+	}
+];
+/** The five steps, each depending on the one before it. */
+var Tasks = SampleSpace.phase("tasks", {
+	schemas: [TaskSet.TaskSet, Task.Task],
+	run: () => Effect.gen(function* () {
+		const taskSet = yield* Database.add(TaskSet.make({
+			name: "Hello Worker",
+			description: "From an empty sandbox to a URL that answers."
+		}));
+		const tasks = STEPS.map((step) => Task.make({
+			title: step.title,
+			description: step.description,
+			estimate: step.estimate,
+			assignee: step.assignee,
+			status: "todo",
+			history: [{
+				id: EntityId.random(),
+				date: daysAgo(0),
+				event: "created",
+				description: "Filed from the worker template."
+			}]
+		}));
+		yield* SampleSpace.children(taskSet, tasks, (taskSet, refs) => {
+			taskSet.tasks = refs;
+		});
+		for (const [index, task] of tasks.entries()) if (index > 0) {
+			const previous = tasks[index - 1];
+			Obj.update(task, (task) => {
+				task.dependsOn = [Ref.make(previous)];
+			});
+		}
+		return {
+			taskSet,
+			tasks
+		};
+	})
+});
+//#endregion
+//#region src/samples/worker/WorkerSpace.ts
+var WorkerSpace_exports = /* @__PURE__ */ __exportAll({
+	make: () => make,
+	makeTemplate: () => makeTemplate
+});
+var phases = {
+	tasks: Tasks,
+	project: ProjectPhase
+};
+/**
+* The smallest thing that still builds and deploys: one Cloudflare Worker returning a greeting and
+* the time, as five tasks from an empty sandbox to a URL that answers.
+*
+* It is the short path through the same ground `StockfishSpace` covers at length. There the work is
+* the engine and the deploy is one stage of five; here the deploy IS the project, so there is no
+* brief to design against, no skill to bind and nothing seeded for the run to point at — a chat
+* that reads the task list has the whole specification.
+*
+* Reachable with no credentials but the reader's own DXOS identity: the first deploy uses wrangler's
+* unauthenticated mode, and the single consent screen is the last task.
+*/
+var make = () => SampleSpace.make({
+	space: {
+		name: "Hello Worker",
+		icon: "rocket-launch",
+		hue: "cyan"
+	},
+	reference: REFERENCE,
+	phases,
+	build: (phases) => Effect.gen(function* () {
+		const tasks = yield* phases.tasks();
+		yield* phases.project({ tasks });
+	})
+});
+var makeTemplate = () => SampleSpace.makeTemplate({
+	id: "org.dxos.plugin-debug.template.worker",
+	description: "Five tasks from an empty sandbox to a Cloudflare Worker that answers, with no account to start.",
+	definition: make()
+});
+//#endregion
+export { make as n, makeTemplate as r, WorkerSpace_exports as t };
+
+//# sourceMappingURL=chunk-WorkerSpace.mjs.map

package/dist/lib/chunk-WorkerSpace.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk-WorkerSpace.mjs","names":[],"sources":["../../src/samples/worker/project.ts","../../src/samples/worker/util.ts","../../src/samples/worker/tasks.ts","../../src/samples/worker/WorkerSpace.ts"],"sourcesContent":["//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport * as SampleSpace from '@dxos/app-toolkit/SampleSpace';\nimport * as Instructions from '@dxos/compute/Instructions';\nimport * as Project from '@dxos/compute/Project';\nimport { Database, Ref } from '@dxos/echo';\nimport { Text } from '@dxos/schema';\nimport { Outline } from '@dxos/types';\n\nimport { type TasksResult } from './tasks.ts';\n\nexport type ProjectInput = { tasks: TasksResult };\n\nexport type ProjectResult = { project: Project.Project; instructions: Instructions.Instructions };\n\nconst INSTRUCTIONS = `Deploy the Worker described by the task list, working the tasks in order and \\\nsetting each one's status as you finish it: the task list is how I follow this run.\n\nWhat the Worker does is the whole specification — one fetch handler, JSON out, a greeting and the \\\ncurrent UTC time. There is no design stage and nothing to choose. If a step starts to look like \\\narchitecture, it is the wrong step.\n\nWrite the code yourself in one sandbox, driving it through the Sandbox skill \\\n(\\`org.dxos.skill.sandbox\\`). The sandbox image ships a coding agent of its own; do not delegate to \\\nit — it has none of this space's context, and its output would land on a container filesystem \\\nrather than in this project.\n\nThe container is not durable, so file what has to outlive it — the Worker URL, the response body — \\\nas artifacts on this project in the turn you produce it, not at the end. The claim URL that the \\\ndeploy prints is a bearer credential for the account: give it to me directly and file it nowhere.\n\nThis project needs no Cloudflare login and no API keys. If a step seems to need either, that is the \\\nwrong step.`;\n\n/**\n * The work-stream. It adopts the task set the tasks phase built (`Project.make` would otherwise\n * create its own empty one), and starts with no artifacts: the URL and the response are what the\n * run produces, and seeding either would name something that does not exist.\n */\nexport const ProjectPhase: SampleSpace.Phase<ProjectResult, ProjectInput> = SampleSpace.phase('project', {\n  // Neither `Outline.Outline` nor `Text.Text` is created here directly: `Project.make` builds an\n  // outline for the project, and the instructions' prose is stored as a Text. A phase has to declare\n  // every type it persists or the space cannot register it.\n  schemas: [Project.Project, Instructions.Instructions, Outline.Outline, Text.Text],\n  run: ({ tasks }: ProjectInput) =>\n    Effect.gen(function* () {\n      const instructions = yield* Database.add(\n        Instructions.make({\n          name: 'Hello Worker',\n          text: INSTRUCTIONS,\n          objects: [Ref.make(tasks.taskSet)],\n        }),\n      );\n\n      const project = yield* Database.add(\n        Project.make({\n          name: 'Hello Worker',\n          description:\n            'One Cloudflare Worker that answers with a greeting and the time, deployed from a sandbox with no Cloudflare account.',\n          status: 'active',\n          instructions: Ref.make(instructions),\n          taskSet: Ref.make(tasks.taskSet),\n        }),\n      );\n\n      return { project, instructions };\n    }),\n});\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport * as SampleSpace from '@dxos/app-toolkit/SampleSpace';\n\n/** Stable reference date so regenerations are reproducible. Override with NOW=2026-05-20 env. */\nexport const REFERENCE = process.env.NOW ? new Date(process.env.NOW) : new Date('2026-05-20T15:00:00Z');\n\n/**\n * Bound to the same reference the definition declares, so the pure content builders can date their\n * objects without every one of them being an effect.\n */\nexport const clock = SampleSpace.makeClock(REFERENCE);\n\n/** ISO timestamp that many days before {@link REFERENCE}, at an optional UTC hour of that day. */\nexport const daysAgo = clock.daysAgo;\n","//\n// Copyright 2026 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport * as SampleSpace from '@dxos/app-toolkit/SampleSpace';\nimport { Database, Obj, Ref } from '@dxos/echo';\nimport { EntityId } from '@dxos/echo/Key';\nimport { Actor, Task, TaskSet } from '@dxos/types';\n\nimport { daysAgo } from './util.ts';\n\n//\n// Five steps, flat and in order.\n//\n// Flat on purpose: the whole run is one afternoon's work, and a tree would imply stages that can be\n// planned against each other. Everything is `todo` — this is a plan to run, not a project caught\n// mid-flight — and each step depends on the one before it, so a runner working ahead is visibly out\n// of order rather than merely early.\n//\n\ntype TaskSeed = {\n  readonly title: string;\n  readonly description: string;\n  readonly estimate?: Task.Estimate;\n  /** Set where the step needs the reader's own hands — here, the one browser consent screen. */\n  readonly assignee?: Actor.Actor;\n};\n\n/**\n * The reader, as an assignee. A template cannot know who they are, so the actor carries the role and\n * a label rather than a Person ref — enough for the row to say the step is not the agent's.\n */\nconst USER: Actor.Actor = { role: 'user', name: 'You' };\n\nconst STEPS: ReadonlyArray<TaskSeed> = [\n  {\n    title: 'Create a sandbox and install wrangler',\n    description:\n      'One sandbox for the whole run — it keeps its filesystem between commands, so a second one pays for node and wrangler again. `--temporary` needs wrangler 4.102 or later and that wrangler needs Node 22, while the sandbox runs Node 20: install `wrangler@latest` explicitly and run its script under a newer node — `npx --yes node@22 node_modules/wrangler/bin/wrangler.js` — since a plain install resolves to the last version that fits Node 20 and has no flag. Creating one and running commands in it belong to the Sandbox skill.',\n    estimate: 's',\n  },\n  {\n    title: 'Write the Worker',\n    description:\n      \"A TypeScript Worker whose fetch handler answers every request with JSON: a greeting and the current UTC time. No router, no dependencies, no build step beyond wrangler's own.\",\n    estimate: 'xs',\n  },\n  {\n    title: 'Deploy it with no Cloudflare login',\n    description:\n      '`wrangler deploy --temporary` mints a temporary account and prints a Worker URL and a claim URL; plain `wrangler deploy` refuses non-interactively and demands a token, so the flag is not optional. File the Worker URL on the project. The claim URL is a bearer credential — hand it straight to me and file it nowhere.',\n    estimate: 's',\n  },\n  {\n    title: 'Fetch the deployed URL and check the response',\n    description:\n      'Fetch it and paste the body into the project. A deploy command that exited zero is not evidence that anything is serving.',\n    estimate: 'xs',\n  },\n  {\n    title: 'Claim the temporary Cloudflare account',\n    description:\n      'Yours to do: claiming signs the account into yours, which needs a browser the agent does not have. It comes after the last deploy — an agent with no login cannot update a claimed account, and `--temporary` would mint a second one under a different URL. Do it inside the hour; the account expires with the Worker on it.',\n    estimate: 'xs',\n    assignee: USER,\n  },\n];\n\nexport type TasksResult = { taskSet: TaskSet.TaskSet; tasks: Task.Task[] };\n\n/** The five steps, each depending on the one before it. */\nexport const Tasks: SampleSpace.Phase<TasksResult> = SampleSpace.phase('tasks', {\n  schemas: [TaskSet.TaskSet, Task.Task],\n  run: () =>\n    Effect.gen(function* () {\n      const taskSet = yield* Database.add(\n        TaskSet.make({\n          name: 'Hello Worker',\n          description: 'From an empty sandbox to a URL that answers.',\n        }),\n      );\n\n      const tasks = STEPS.map((step) =>\n        Task.make({\n          title: step.title,\n          description: step.description,\n          estimate: step.estimate,\n          assignee: step.assignee,\n          status: 'todo',\n          // Task carries no due date; its dates are activity-log lines, so that is where they go.\n          history: [\n            {\n              id: EntityId.random(),\n              date: daysAgo(0),\n              event: 'created' as const,\n              description: 'Filed from the worker template.',\n            },\n          ],\n        }),\n      );\n      yield* SampleSpace.children(taskSet, tasks, (taskSet, refs) => {\n        taskSet.tasks = refs;\n      });\n\n      // Nothing can be deployed before it is written, and nothing claimed before it is deployed.\n      for (const [index, task] of tasks.entries()) {\n        if (index > 0) {\n          const previous = tasks[index - 1];\n          Obj.update(task, (task) => {\n            task.dependsOn = [Ref.make(previous)];\n          });\n        }\n      }\n\n      return { taskSet, tasks };\n    }),\n});\n","//\n// Copyright 2026 DXOS.org\n//\n\n// @import-as-namespace\n\nimport * as Effect from 'effect/Effect';\n\nimport type * as AppCapabilities from '@dxos/app-toolkit/AppCapabilities';\nimport * as SampleSpace from '@dxos/app-toolkit/SampleSpace';\n\nimport { ProjectPhase } from './project.ts';\nimport { Tasks } from './tasks.ts';\nimport { REFERENCE } from './util.ts';\n\nconst phases = {\n  tasks: Tasks,\n  project: ProjectPhase,\n};\n\n/**\n * The smallest thing that still builds and deploys: one Cloudflare Worker returning a greeting and\n * the time, as five tasks from an empty sandbox to a URL that answers.\n *\n * It is the short path through the same ground `StockfishSpace` covers at length. There the work is\n * the engine and the deploy is one stage of five; here the deploy IS the project, so there is no\n * brief to design against, no skill to bind and nothing seeded for the run to point at — a chat\n * that reads the task list has the whole specification.\n *\n * Reachable with no credentials but the reader's own DXOS identity: the first deploy uses wrangler's\n * unauthenticated mode, and the single consent screen is the last task.\n */\nexport const make = (): SampleSpace.Definition<typeof phases, void> =>\n  SampleSpace.make({\n    // Reaches a space only where the definition is applied directly (the generator panel, the\n    // archive test): the create-space dialog takes its icon from `space-templates.ts`, which\n    // overrides every template's by list index. See DESIGN.md §7.\n    space: { name: 'Hello Worker', icon: 'rocket-launch', hue: 'cyan' },\n    reference: REFERENCE,\n    phases,\n    build: (phases) =>\n      Effect.gen(function* () {\n        const tasks = yield* phases.tasks();\n        yield* phases.project({ tasks });\n\n        // No root collection: the root holds collections only, and this space seeds no documents —\n        // the project and its tasks surface through their own containers.\n      }),\n  });\n\nexport const makeTemplate = (): AppCapabilities.SpaceTemplate =>\n  SampleSpace.makeTemplate({\n    id: 'org.dxos.plugin-debug.template.worker',\n    description: 'Five tasks from an empty sandbox to a Cloudflare Worker that answers, with no account to start.',\n    definition: make(),\n  });\n"],"mappings":";;;;;;;;;;AAmBA,IAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;AAwBrB,IAAa,eAA+D,YAAY,MAAM,WAAW;CAIvG,SAAS;EAAC,QAAQ;EAAS,aAAa;EAAc,QAAQ;EAAS,KAAK;CAAI;CAChF,MAAM,EAAE,YACN,OAAO,IAAI,aAAa;EACtB,MAAM,eAAe,OAAO,SAAS,IACnC,aAAa,KAAK;GAChB,MAAM;GACN,MAAM;GACN,SAAS,CAAC,IAAI,KAAK,MAAM,OAAO,CAAC;EACnC,CAAC,CACH;EAaA,OAAO;GAAE,SAAA,OAXc,SAAS,IAC9B,QAAQ,KAAK;IACX,MAAM;IACN,aACE;IACF,QAAQ;IACR,cAAc,IAAI,KAAK,YAAY;IACnC,SAAS,IAAI,KAAK,MAAM,OAAO;GACjC,CAAC,CACH;GAEkB;EAAa;CACjC,CAAC;AACL,CAAC;;;;AChED,IAAa,YAAY,QAAQ,IAAI,MAAM,IAAI,KAAK,QAAQ,IAAI,GAAG,oBAAI,IAAI,KAAK,sBAAsB;;AAStG,IAAa,UAHQ,YAAY,UAAU,SAGpB,CAAA,CAAM;;;ACoB7B,IAAM,QAAiC;CACrC;EACE,OAAO;EACP,aACE;EACF,UAAU;CACZ;CACA;EACE,OAAO;EACP,aACE;EACF,UAAU;CACZ;CACA;EACE,OAAO;EACP,aACE;EACF,UAAU;CACZ;CACA;EACE,OAAO;EACP,aACE;EACF,UAAU;CACZ;CACA;EACE,OAAO;EACP,aACE;EACF,UAAU;EACV,UAAU;GAhCc,MAAM;GAAQ,MAAM;EAgClC;CACZ;AACF;;AAKA,IAAa,QAAwC,YAAY,MAAM,SAAS;CAC9E,SAAS,CAAC,QAAQ,SAAS,KAAK,IAAI;CACpC,WACE,OAAO,IAAI,aAAa;EACtB,MAAM,UAAU,OAAO,SAAS,IAC9B,QAAQ,KAAK;GACX,MAAM;GACN,aAAa;EACf,CAAC,CACH;EAEA,MAAM,QAAQ,MAAM,KAAK,SACvB,KAAK,KAAK;GACR,OAAO,KAAK;GACZ,aAAa,KAAK;GAClB,UAAU,KAAK;GACf,UAAU,KAAK;GACf,QAAQ;GAER,SAAS,CACP;IACE,IAAI,SAAS,OAAO;IACpB,MAAM,QAAQ,CAAC;IACf,OAAO;IACP,aAAa;GACf,CACF;EACF,CAAC,CACH;EACA,OAAO,YAAY,SAAS,SAAS,QAAQ,SAAS,SAAS;GAC7D,QAAQ,QAAQ;EAClB,CAAC;EAGD,KAAK,MAAM,CAAC,OAAO,SAAS,MAAM,QAAQ,GACxC,IAAI,QAAQ,GAAG;GACb,MAAM,WAAW,MAAM,QAAQ;GAC/B,IAAI,OAAO,OAAO,SAAS;IACzB,KAAK,YAAY,CAAC,IAAI,KAAK,QAAQ,CAAC;GACtC,CAAC;EACH;EAGF,OAAO;GAAE;GAAS;EAAM;CAC1B,CAAC;AACL,CAAC;;;;;;;ACvGD,IAAM,SAAS;CACb,OAAO;CACP,SAAS;AACX;;;;;;;;;;;;;AAcA,IAAa,aACX,YAAY,KAAK;CAIf,OAAO;EAAE,MAAM;EAAgB,MAAM;EAAiB,KAAK;CAAO;CAClE,WAAW;CACX;CACA,QAAQ,WACN,OAAO,IAAI,aAAa;EACtB,MAAM,QAAQ,OAAO,OAAO,MAAM;EAClC,OAAO,OAAO,QAAQ,EAAE,MAAM,CAAC;CAIjC,CAAC;AACL,CAAC;AAEH,IAAa,qBACX,YAAY,aAAa;CACvB,IAAI;CACJ,aAAa;CACb,YAAY,KAAK;AACnB,CAAC"}