woozlit 2.3.0 → 2.3.1

package/test/fixture/lsp/fake-lsp-server.js

@@ -1,75 +0,0 @@
-// Simple JSON-RPC 2.0 LSP-like fake server over stdio
-// Implements a minimal LSP handshake and triggers a request upon notification
-
-let nextId = 1
-
-function encode(message) {
-  const json = JSON.stringify(message)
-  const header = `Content-Length: ${Buffer.byteLength(json, "utf8")}\r\n\r\n`
-  return Buffer.concat([Buffer.from(header, "utf8"), Buffer.from(json, "utf8")])
-}
-
-function decodeFrames(buffer) {
-  const results = []
-  let idx
-  while ((idx = buffer.indexOf("\r\n\r\n")) !== -1) {
-    const header = buffer.slice(0, idx).toString("utf8")
-    const m = /Content-Length:\s*(\d+)/i.exec(header)
-    const len = m ? parseInt(m[1], 10) : 0
-    const bodyStart = idx + 4
-    const bodyEnd = bodyStart + len
-    if (buffer.length < bodyEnd) break
-    const body = buffer.slice(bodyStart, bodyEnd).toString("utf8")
-    results.push(body)
-    buffer = buffer.slice(bodyEnd)
-  }
-  return { messages: results, rest: buffer }
-}
-
-let readBuffer = Buffer.alloc(0)
-
-process.stdin.on("data", (chunk) => {
-  readBuffer = Buffer.concat([readBuffer, chunk])
-  const { messages, rest } = decodeFrames(readBuffer)
-  readBuffer = rest
-  for (const m of messages) handle(m)
-})
-
-function send(msg) {
-  process.stdout.write(encode(msg))
-}
-
-function sendRequest(method, params) {
-  const id = nextId++
-  send({ jsonrpc: "2.0", id, method, params })
-  return id
-}
-
-function handle(raw) {
-  let data
-  try {
-    data = JSON.parse(raw)
-  } catch {
-    return
-  }
-  if (data.method === "initialize") {
-    send({ jsonrpc: "2.0", id: data.id, result: { capabilities: {} } })
-    return
-  }
-  if (data.method === "initialized") {
-    return
-  }
-  if (data.method === "workspace/didChangeConfiguration") {
-    return
-  }
-  if (data.method === "test/trigger") {
-    const method = data.params && data.params.method
-    if (method) sendRequest(method, {})
-    return
-  }
-  if (typeof data.id !== "undefined") {
-    // Respond OK to any request from client to keep transport flowing
-    send({ jsonrpc: "2.0", id: data.id, result: null })
-    return
-  }
-}

package/test/fixture/plug-worker.ts

@@ -1,93 +0,0 @@
-import path from "path"
-
-import { createPlugTask, type PlugCtx, type PlugDeps } from "../../src/cli/cmd/plug"
-import { Filesystem } from "../../src/util"
-
-type Msg = {
-  dir: string
-  target: string
-  mod: string
-  global?: boolean
-  force?: boolean
-  globalDir?: string
-  vcs?: string
-  worktree?: string
-  directory?: string
-  holdMs?: number
-}
-
-function sleep(ms: number) {
-  return new Promise<void>((resolve) => {
-    setTimeout(resolve, ms)
-  })
-}
-
-function input() {
-  const raw = process.argv[2]
-  if (!raw) {
-    throw new Error("Missing plug worker input")
-  }
-
-  const msg = JSON.parse(raw) as Partial<Msg>
-  if (!msg.dir || !msg.target || !msg.mod) {
-    throw new Error("Invalid plug worker input")
-  }
-
-  return msg as Msg
-}
-
-function deps(msg: Msg): PlugDeps {
-  return {
-    spinner: () => ({
-      start() {},
-      stop() {},
-    }),
-    log: {
-      error() {},
-      info() {},
-      success() {},
-    },
-    resolve: async () => msg.target,
-    readText: (file) => Filesystem.readText(file),
-    write: async (file, text) => {
-      if (msg.holdMs && msg.holdMs > 0) {
-        await sleep(msg.holdMs)
-      }
-      await Filesystem.write(file, text)
-    },
-    exists: (file) => Filesystem.exists(file),
-    files: (dir, name) => [path.join(dir, `${name}.jsonc`), path.join(dir, `${name}.json`)],
-    global: msg.globalDir ?? path.join(msg.dir, ".global"),
-  }
-}
-
-function ctx(msg: Msg): PlugCtx {
-  return {
-    vcs: msg.vcs ?? "git",
-    worktree: msg.worktree ?? msg.dir,
-    directory: msg.directory ?? msg.dir,
-  }
-}
-
-async function main() {
-  const msg = input()
-  const run = createPlugTask(
-    {
-      mod: msg.mod,
-      global: msg.global,
-      force: msg.force,
-    },
-    deps(msg),
-  )
-
-  const ok = await run(ctx(msg))
-  if (!ok) {
-    throw new Error("Plug task failed")
-  }
-}
-
-await main().catch((err) => {
-  const text = err instanceof Error ? (err.stack ?? err.message) : String(err)
-  process.stderr.write(text)
-  process.exit(1)
-})

package/test/fixture/plugin-meta-worker.ts

@@ -1,19 +0,0 @@
-const raw = process.argv[2]
-if (!raw) throw new Error("Missing worker payload")
-
-const value = JSON.parse(raw)
-if (!value || typeof value !== "object") {
-  throw new Error("Invalid worker payload")
-}
-
-const msg = Object.fromEntries(Object.entries(value))
-if (typeof msg.file !== "string" || typeof msg.spec !== "string" || typeof msg.target !== "string") {
-  throw new Error("Invalid worker payload")
-}
-if (typeof msg.id !== "string") throw new Error("Invalid worker payload")
-
-process.env.WOOZLIT_CODE_PLUGIN_META_FILE = msg.file
-
-const { PluginMeta } = await import("../../src/plugin/meta")
-
-await PluginMeta.touch(msg.spec, msg.target, msg.id)

package/test/fixture/skills/agents-sdk/SKILL.md

@@ -1,152 +0,0 @@
----
-name: agents-sdk
-description: Build AI agents on Cloudflare Workers using the Agents SDK. Load when creating stateful agents, durable workflows, real-time WebSocket apps, scheduled tasks, MCP servers, or chat applications. Covers Agent class, state management, callable RPC, Workflows integration, and React hooks.
----
-
-# Cloudflare Agents SDK
-
-**STOP.** Your knowledge of the Agents SDK may be outdated. Prefer retrieval over pre-training for any Agents SDK task.
-
-## Documentation
-
-Fetch current docs from `https://github.com/cloudflare/agents/tree/main/docs` before implementing.
-
-| Topic               | Doc                           | Use for                                        |
-| ------------------- | ----------------------------- | ---------------------------------------------- |
-| Getting started     | `docs/getting-started.md`     | First agent, project setup                     |
-| State               | `docs/state.md`               | `setState`, `validateStateChange`, persistence |
-| Routing             | `docs/routing.md`             | URL patterns, `routeAgentRequest`, `basePath`  |
-| Callable methods    | `docs/callable-methods.md`    | `@callable`, RPC, streaming, timeouts          |
-| Scheduling          | `docs/scheduling.md`          | `schedule()`, `scheduleEvery()`, cron          |
-| Workflows           | `docs/workflows.md`           | `AgentWorkflow`, durable multi-step tasks      |
-| HTTP/WebSockets     | `docs/http-websockets.md`     | Lifecycle hooks, hibernation                   |
-| Email               | `docs/email.md`               | Email routing, secure reply resolver           |
-| MCP client          | `docs/mcp-client.md`          | Connecting to MCP servers                      |
-| MCP server          | `docs/mcp-servers.md`         | Building MCP servers with `McpAgent`           |
-| Client SDK          | `docs/client-sdk.md`          | `useAgent`, `useAgentChat`, React hooks        |
-| Human-in-the-loop   | `docs/human-in-the-loop.md`   | Approval flows, pausing workflows              |
-| Resumable streaming | `docs/resumable-streaming.md` | Stream recovery on disconnect                  |
-
-Cloudflare docs: https://developers.cloudflare.com/agents/
-
-## Capabilities
-
-The Agents SDK provides:
-
-- **Persistent state** - SQLite-backed, auto-synced to clients
-- **Callable RPC** - `@callable()` methods invoked over WebSocket
-- **Scheduling** - One-time, recurring (`scheduleEvery`), and cron tasks
-- **Workflows** - Durable multi-step background processing via `AgentWorkflow`
-- **MCP integration** - Connect to MCP servers or build your own with `McpAgent`
-- **Email handling** - Receive and reply to emails with secure routing
-- **Streaming chat** - `AIChatAgent` with resumable streams
-- **React hooks** - `useAgent`, `useAgentChat` for client apps
-
-## FIRST: Verify Installation
-
-```bash
-npm ls agents  # Should show agents package
-```
-
-If not installed:
-
-```bash
-npm install agents
-```
-
-## Wrangler Configuration
-
-```jsonc
-{
-  "durable_objects": {
-    "bindings": [{ "name": "MyAgent", "class_name": "MyAgent" }],
-  },
-  "migrations": [{ "tag": "v1", "new_sqlite_classes": ["MyAgent"] }],
-}
-```
-
-## Agent Class
-
-```typescript
-import { Agent, routeAgentRequest, callable } from "agents"
-
-type State = { count: number }
-
-export class Counter extends Agent<Env, State> {
-  initialState = { count: 0 }
-
-  // Validation hook - runs before state persists (sync, throwing rejects the update)
-  validateStateChange(nextState: State, source: Connection | "server") {
-    if (nextState.count < 0) throw new Error("Count cannot be negative")
-  }
-
-  // Notification hook - runs after state persists (async, non-blocking)
-  onStateUpdate(state: State, source: Connection | "server") {
-    console.log("State updated:", state)
-  }
-
-  @callable()
-  increment() {
-    this.setState({ count: this.state.count + 1 })
-    return this.state.count
-  }
-}
-
-export default {
-  fetch: (req, env) => routeAgentRequest(req, env) ?? new Response("Not found", { status: 404 }),
-}
-```
-
-## Routing
-
-Requests route to `/agents/{agent-name}/{instance-name}`:
-
-| Class      | URL                        |
-| ---------- | -------------------------- |
-| `Counter`  | `/agents/counter/user-123` |
-| `ChatRoom` | `/agents/chat-room/lobby`  |
-
-Client: `useAgent({ agent: "Counter", name: "user-123" })`
-
-## Core APIs
-
-| Task                | API                                                    |
-| ------------------- | ------------------------------------------------------ |
-| Read state          | `this.state.count`                                     |
-| Write state         | `this.setState({ count: 1 })`                          |
-| SQL query           | `` this.sql`SELECT * FROM users WHERE id = ${id}` ``   |
-| Schedule (delay)    | `await this.schedule(60, "task", payload)`             |
-| Schedule (cron)     | `await this.schedule("0 * * * *", "task", payload)`    |
-| Schedule (interval) | `await this.scheduleEvery(30, "poll")`                 |
-| RPC method          | `@callable() myMethod() { ... }`                       |
-| Streaming RPC       | `@callable({ streaming: true }) stream(res) { ... }`   |
-| Start workflow      | `await this.runWorkflow("ProcessingWorkflow", params)` |
-
-## React Client
-
-```tsx
-import { useAgent } from "agents/react"
-
-function App() {
-  const [state, setLocalState] = useState({ count: 0 })
-
-  const agent = useAgent({
-    agent: "Counter",
-    name: "my-instance",
-    onStateUpdate: (newState) => setLocalState(newState),
-    onIdentity: (name, agentType) => console.log(`Connected to ${name}`),
-  })
-
-  return <button onClick={() => agent.setState({ count: state.count + 1 })}>Count: {state.count}</button>
-}
-```
-
-## References
-
-- **[references/workflows.md](references/workflows.md)** - Durable Workflows integration
-- **[references/callable.md](references/callable.md)** - RPC methods, streaming, timeouts
-- **[references/state-scheduling.md](references/state-scheduling.md)** - State persistence, scheduling
-- **[references/streaming-chat.md](references/streaming-chat.md)** - AIChatAgent, resumable streams
-- **[references/mcp.md](references/mcp.md)** - MCP server integration
-- **[references/email.md](references/email.md)** - Email routing and handling
-- **[references/codemode.md](references/codemode.md)** - Code Mode (experimental)

package/test/fixture/skills/agents-sdk/references/callable.md

@@ -1,92 +0,0 @@
-# Callable Methods
-
-Fetch `docs/callable-methods.md` from `https://github.com/cloudflare/agents/tree/main/docs` for complete documentation.
-
-## Overview
-
-`@callable()` exposes agent methods to clients via WebSocket RPC.
-
-```typescript
-import { Agent, callable } from "agents"
-
-export class MyAgent extends Agent<Env, State> {
-  @callable()
-  async greet(name: string): Promise<string> {
-    return `Hello, ${name}!`
-  }
-
-  @callable()
-  async processData(data: unknown): Promise<Result> {
-    // Long-running work
-    return result
-  }
-}
-```
-
-## Client Usage
-
-```typescript
-// Basic call
-const greeting = await agent.call("greet", ["World"])
-
-// With timeout
-const result = await agent.call("processData", [data], {
-  timeout: 5000, // 5 second timeout
-})
-```
-
-## Streaming Responses
-
-```typescript
-import { Agent, callable, StreamingResponse } from "agents"
-
-export class MyAgent extends Agent<Env, State> {
-  @callable({ streaming: true })
-  async streamResults(stream: StreamingResponse, query: string) {
-    for await (const item of fetchResults(query)) {
-      stream.send(JSON.stringify(item))
-    }
-    stream.close()
-  }
-
-  @callable({ streaming: true })
-  async streamWithError(stream: StreamingResponse) {
-    try {
-      // ... work
-    } catch (error) {
-      stream.error(error.message) // Signal error to client
-      return
-    }
-    stream.close()
-  }
-}
-```
-
-Client with streaming:
-
-```typescript
-await agent.call("streamResults", ["search term"], {
-  stream: {
-    onChunk: (data) => console.log("Chunk:", data),
-    onDone: () => console.log("Complete"),
-    onError: (error) => console.error("Error:", error),
-  },
-})
-```
-
-## Introspection
-
-```typescript
-// Get list of callable methods on an agent
-const methods = await agent.call("getCallableMethods", [])
-// Returns: ["greet", "processData", "streamResults", ...]
-```
-
-## When to Use
-
-| Scenario                             | Use                         |
-| ------------------------------------ | --------------------------- |
-| Browser/mobile calling agent         | `@callable()`               |
-| External service calling agent       | `@callable()`               |
-| Worker calling agent (same codebase) | DO RPC directly             |
-| Agent calling another agent          | `getAgentByName()` + DO RPC |

package/test/fixture/skills/cloudflare/SKILL.md

@@ -1,211 +0,0 @@
----
-name: cloudflare
-description: Comprehensive Cloudflare platform skill covering Workers, Pages, storage (KV, D1, R2), AI (Workers AI, Vectorize, Agents SDK), networking (Tunnel, Spectrum), security (WAF, DDoS), and infrastructure-as-code (Terraform, Pulumi). Use for any Cloudflare development task.
-references:
-  - workers
-  - pages
-  - d1
-  - durable-objects
-  - workers-ai
----
-
-# Cloudflare Platform Skill
-
-Consolidated skill for building on the Cloudflare platform. Use decision trees below to find the right product, then load detailed references.
-
-## Quick Decision Trees
-
-### "I need to run code"
-
-```
-Need to run code?
-├─ Serverless functions at the edge → workers/
-├─ Full-stack web app with Git deploys → pages/
-├─ Stateful coordination/real-time → durable-objects/
-├─ Long-running multi-step jobs → workflows/
-├─ Run containers → containers/
-├─ Multi-tenant (customers deploy code) → workers-for-platforms/
-├─ Scheduled tasks (cron) → cron-triggers/
-├─ Lightweight edge logic (modify HTTP) → snippets/
-├─ Process Worker execution events (logs/observability) → tail-workers/
-└─ Optimize latency to backend infrastructure → smart-placement/
-```
-
-### "I need to store data"
-
-```
-Need storage?
-├─ Key-value (config, sessions, cache) → kv/
-├─ Relational SQL → d1/ (SQLite) or hyperdrive/ (existing Postgres/MySQL)
-├─ Object/file storage (S3-compatible) → r2/
-├─ Message queue (async processing) → queues/
-├─ Vector embeddings (AI/semantic search) → vectorize/
-├─ Strongly-consistent per-entity state → durable-objects/ (DO storage)
-├─ Secrets management → secrets-store/
-├─ Streaming ETL to R2 → pipelines/
-└─ Persistent cache (long-term retention) → cache-reserve/
-```
-
-### "I need AI/ML"
-
-```
-Need AI?
-├─ Run inference (LLMs, embeddings, images) → workers-ai/
-├─ Vector database for RAG/search → vectorize/
-├─ Build stateful AI agents → agents-sdk/
-├─ Gateway for any AI provider (caching, routing) → ai-gateway/
-└─ AI-powered search widget → ai-search/
-```
-
-### "I need networking/connectivity"
-
-```
-Need networking?
-├─ Expose local service to internet → tunnel/
-├─ TCP/UDP proxy (non-HTTP) → spectrum/
-├─ WebRTC TURN server → turn/
-├─ Private network connectivity → network-interconnect/
-├─ Optimize routing → argo-smart-routing/
-├─ Optimize latency to backend (not user) → smart-placement/
-└─ Real-time video/audio → realtimekit/ or realtime-sfu/
-```
-
-### "I need security"
-
-```
-Need security?
-├─ Web Application Firewall → waf/
-├─ DDoS protection → ddos/
-├─ Bot detection/management → bot-management/
-├─ API protection → api-shield/
-├─ CAPTCHA alternative → turnstile/
-└─ Credential leak detection → waf/ (managed ruleset)
-```
-
-### "I need media/content"
-
-```
-Need media?
-├─ Image optimization/transformation → images/
-├─ Video streaming/encoding → stream/
-├─ Browser automation/screenshots → browser-rendering/
-└─ Third-party script management → zaraz/
-```
-
-### "I need infrastructure-as-code"
-
-```
-Need IaC? → pulumi/ (Pulumi), terraform/ (Terraform), or api/ (REST API)
-```
-
-## Product Index
-
-### Compute & Runtime
-
-| Product               | Reference                           |
-| --------------------- | ----------------------------------- |
-| Workers               | `references/workers/`               |
-| Pages                 | `references/pages/`                 |
-| Pages Functions       | `references/pages-functions/`       |
-| Durable Objects       | `references/durable-objects/`       |
-| Workflows             | `references/workflows/`             |
-| Containers            | `references/containers/`            |
-| Workers for Platforms | `references/workers-for-platforms/` |
-| Cron Triggers         | `references/cron-triggers/`         |
-| Tail Workers          | `references/tail-workers/`          |
-| Snippets              | `references/snippets/`              |
-| Smart Placement       | `references/smart-placement/`       |
-
-### Storage & Data
-
-| Product         | Reference                     |
-| --------------- | ----------------------------- |
-| KV              | `references/kv/`              |
-| D1              | `references/d1/`              |
-| R2              | `references/r2/`              |
-| Queues          | `references/queues/`          |
-| Hyperdrive      | `references/hyperdrive/`      |
-| DO Storage      | `references/do-storage/`      |
-| Secrets Store   | `references/secrets-store/`   |
-| Pipelines       | `references/pipelines/`       |
-| R2 Data Catalog | `references/r2-data-catalog/` |
-| R2 SQL          | `references/r2-sql/`          |
-
-### AI & Machine Learning
-
-| Product    | Reference                |
-| ---------- | ------------------------ |
-| Workers AI | `references/workers-ai/` |
-| Vectorize  | `references/vectorize/`  |
-| Agents SDK | `references/agents-sdk/` |
-| AI Gateway | `references/ai-gateway/` |
-| AI Search  | `references/ai-search/`  |
-
-### Networking & Connectivity
-
-| Product              | Reference                          |
-| -------------------- | ---------------------------------- |
-| Tunnel               | `references/tunnel/`               |
-| Spectrum             | `references/spectrum/`             |
-| TURN                 | `references/turn/`                 |
-| Network Interconnect | `references/network-interconnect/` |
-| Argo Smart Routing   | `references/argo-smart-routing/`   |
-| Workers VPC          | `references/workers-vpc/`          |
-
-### Security
-
-| Product         | Reference                    |
-| --------------- | ---------------------------- |
-| WAF             | `references/waf/`            |
-| DDoS Protection | `references/ddos/`           |
-| Bot Management  | `references/bot-management/` |
-| API Shield      | `references/api-shield/`     |
-| Turnstile       | `references/turnstile/`      |
-
-### Media & Content
-
-| Product           | Reference                       |
-| ----------------- | ------------------------------- |
-| Images            | `references/images/`            |
-| Stream            | `references/stream/`            |
-| Browser Rendering | `references/browser-rendering/` |
-| Zaraz             | `references/zaraz/`             |
-
-### Real-Time Communication
-
-| Product      | Reference                  |
-| ------------ | -------------------------- |
-| RealtimeKit  | `references/realtimekit/`  |
-| Realtime SFU | `references/realtime-sfu/` |
-
-### Developer Tools
-
-| Product            | Reference                        |
-| ------------------ | -------------------------------- |
-| Wrangler           | `references/wrangler/`           |
-| Miniflare          | `references/miniflare/`          |
-| C3                 | `references/c3/`                 |
-| Observability      | `references/observability/`      |
-| Analytics Engine   | `references/analytics-engine/`   |
-| Web Analytics      | `references/web-analytics/`      |
-| Sandbox            | `references/sandbox/`            |
-| Workerd            | `references/workerd/`            |
-| Workers Playground | `references/workers-playground/` |
-
-### Infrastructure as Code
-
-| Product   | Reference               |
-| --------- | ----------------------- |
-| Pulumi    | `references/pulumi/`    |
-| Terraform | `references/terraform/` |
-| API       | `references/api/`       |
-
-### Other Services
-
-| Product       | Reference                   |
-| ------------- | --------------------------- |
-| Email Routing | `references/email-routing/` |
-| Email Workers | `references/email-workers/` |
-| Static Assets | `references/static-assets/` |
-| Bindings      | `references/bindings/`      |
-| Cache Reserve | `references/cache-reserve/` |

package/test/fixture/skills/index.json

@@ -1,6 +0,0 @@
-{
-  "skills": [
-    { "name": "agents-sdk", "description": "Cloudflare Agents SDK", "files": ["SKILL.md", "references/callable.md"] },
-    { "name": "cloudflare", "description": "Cloudflare Platform Skill", "files": ["SKILL.md"] }
-  ]
-}