@miaws/miaw 1.18.5 → 1.18.7

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"] }
-  ]
-}

package/test/fixture/tui-environment.tsx

@@ -1,32 +0,0 @@
-/** @jsxImportSource @opentui/solid */
-import {
-  TuiPathsProvider,
-  TuiStartupProvider,
-  TuiTerminalEnvironmentProvider,
-  type TuiPaths,
-} from "@miaw/tui/context/runtime"
-import type { ParentProps } from "solid-js"
-
-export function TestTuiContexts(
-  props: ParentProps<{
-    cwd?: string
-    directory?: string
-    paths?: Partial<TuiPaths>
-  }>,
-) {
-  return (
-    <TuiPathsProvider
-      value={{
-        cwd: props.cwd ?? props.directory ?? "/tmp/miaw/packages/miaw",
-        home: "/tmp/miaw/home",
-        state: "/tmp/miaw/state",
-        worktree: "/tmp/miaw",
-        ...props.paths,
-      }}
-    >
-      <TuiTerminalEnvironmentProvider value={{ platform: "linux" }}>
-        <TuiStartupProvider value={{ skipInitialLoading: false }}>{props.children}</TuiStartupProvider>
-      </TuiTerminalEnvironmentProvider>
-    </TuiPathsProvider>
-  )
-}

package/test/fixture/tui-plugin.ts

@@ -1,355 +0,0 @@
-import { createMiawClient } from "@miaw/sdk/v2"
-import { RGBA, type CliRenderer } from "@opentui/core"
-import type { HostPluginApi } from "@miaw/tui/plugin/slots"
-import { createTuiResolvedConfig } from "./tui-runtime"
-
-type Count = {
-  event_add: number
-  event_drop: number
-  route_add: number
-  route_drop: number
-  command_add: number
-  command_drop: number
-}
-
-type AttentionOpts = Partial<Omit<HostPluginApi["attention"], "soundboard">> & {
-  soundboard?: Partial<HostPluginApi["attention"]["soundboard"]>
-}
-
-function themeCurrent(): HostPluginApi["theme"]["current"] {
-  const a = RGBA.fromInts(0, 120, 240)
-  const b = RGBA.fromInts(120, 120, 120)
-  const c = RGBA.fromInts(230, 230, 230)
-  const d = RGBA.fromInts(120, 30, 30)
-  const e = RGBA.fromInts(140, 100, 40)
-  const f = RGBA.fromInts(20, 140, 80)
-  const g = RGBA.fromInts(20, 80, 160)
-  const h = RGBA.fromInts(40, 40, 40)
-  const i = RGBA.fromInts(60, 60, 60)
-  const j = RGBA.fromInts(80, 80, 80)
-  return {
-    primary: a,
-    secondary: b,
-    accent: a,
-    error: d,
-    warning: e,
-    success: f,
-    info: g,
-    text: c,
-    textMuted: b,
-    selectedListItemText: h,
-    background: h,
-    backgroundPanel: h,
-    backgroundElement: i,
-    backgroundMenu: i,
-    border: j,
-    borderActive: c,
-    borderSubtle: i,
-    diffAdded: f,
-    diffRemoved: d,
-    diffContext: b,
-    diffHunkHeader: b,
-    diffHighlightAdded: f,
-    diffHighlightRemoved: d,
-    diffAddedBg: h,
-    diffRemovedBg: h,
-    diffContextBg: h,
-    diffLineNumber: b,
-    diffAddedLineNumberBg: h,
-    diffRemovedLineNumberBg: h,
-    markdownText: c,
-    markdownHeading: c,
-    markdownLink: a,
-    markdownLinkText: g,
-    markdownCode: f,
-    markdownBlockQuote: e,
-    markdownEmph: e,
-    markdownStrong: c,
-    markdownHorizontalRule: b,
-    markdownListItem: a,
-    markdownListEnumeration: g,
-    markdownImage: a,
-    markdownImageText: g,
-    markdownCodeBlock: c,
-    syntaxComment: b,
-    syntaxKeyword: a,
-    syntaxFunction: g,
-    syntaxVariable: c,
-    syntaxString: f,
-    syntaxNumber: e,
-    syntaxType: a,
-    syntaxOperator: a,
-    syntaxPunctuation: c,
-    thinkingOpacity: 0.6,
-  }
-}
-
-type Opts = {
-  client?: HostPluginApi["client"] | (() => HostPluginApi["client"])
-  renderer?: HostPluginApi["renderer"]
-  attention?: AttentionOpts
-  event?: HostPluginApi["event"]
-  mode?: HostPluginApi["mode"]
-  count?: Count
-  keymap?: HostPluginApi["keymap"]
-  tuiConfig?: Partial<HostPluginApi["tuiConfig"]>
-  app?: Partial<HostPluginApi["app"]>
-  state?: {
-    ready?: HostPluginApi["state"]["ready"]
-    config?: HostPluginApi["state"]["config"]
-    provider?: HostPluginApi["state"]["provider"]
-    path?: HostPluginApi["state"]["path"]
-    vcs?: HostPluginApi["state"]["vcs"]
-    session?: Partial<HostPluginApi["state"]["session"]>
-    part?: HostPluginApi["state"]["part"]
-    lsp?: HostPluginApi["state"]["lsp"]
-    mcp?: HostPluginApi["state"]["mcp"]
-  }
-  theme?: {
-    selected?: string
-    has?: HostPluginApi["theme"]["has"]
-    set?: HostPluginApi["theme"]["set"]
-    install?: HostPluginApi["theme"]["install"]
-    mode?: HostPluginApi["theme"]["mode"]
-    ready?: boolean
-    current?: HostPluginApi["theme"]["current"]
-  }
-}
-
-function tuiConfig(input?: Partial<HostPluginApi["tuiConfig"]>): HostPluginApi["tuiConfig"] {
-  return {
-    ...createTuiResolvedConfig(),
-    ...input,
-  }
-}
-
-export function createTuiPluginApi(opts: Opts = {}): HostPluginApi {
-  const kv: Record<string, unknown> = {}
-  const count = opts.count
-  const ctrl = new AbortController()
-  const own = createMiawClient({
-    baseUrl: "http://localhost:4096",
-  })
-  const fallback = () => own
-  const read =
-    typeof opts.client === "function"
-      ? opts.client
-      : opts.client
-        ? () => opts.client as HostPluginApi["client"]
-        : fallback
-  const client = () => read()
-  let depth = 0
-  let size: "medium" | "large" | "xlarge" = "medium"
-  const has = opts.theme?.has ?? (() => false)
-  let selected = opts.theme?.selected ?? "miaw"
-  const set =
-    opts.theme?.set ??
-    ((name: string) => {
-      if (!has(name)) return false
-      selected = name
-      return true
-    })
-  const renderer: CliRenderer = opts.renderer ?? {
-    ...Object.create(null),
-    once(this: CliRenderer) {
-      return this
-    },
-  }
-  const keymap =
-    opts.keymap ??
-    ({
-      acquireResource(_key: symbol, setup: () => () => void) {
-        const dispose = setup()
-        return () => {
-          dispose()
-        }
-      },
-      registerLayer() {
-        if (count) count.command_add += 1
-        return () => {
-          if (!count) return
-          count.command_drop += 1
-        }
-      },
-      runCommand() {
-        return { ok: true } as const
-      },
-    } as unknown as HostPluginApi["keymap"])
-
-  function kvGet(name: string): unknown
-  function kvGet<Value>(name: string, fallback: Value): Value
-  function kvGet(name: string, fallback?: unknown) {
-    const value = kv[name]
-    if (value === undefined) return fallback
-    return value
-  }
-
-  return {
-    app: {
-      get version() {
-        return opts.app?.version ?? "0.0.0-test"
-      },
-    },
-    attention: {
-      async notify(input) {
-        return opts.attention?.notify?.(input) ?? { ok: false, notification: false, sound: false }
-      },
-      soundboard: {
-        registerPack: (pack) => opts.attention?.soundboard?.registerPack?.(pack) ?? (() => {}),
-        activate: (id, options) => opts.attention?.soundboard?.activate?.(id, options) ?? false,
-        current: () => opts.attention?.soundboard?.current?.() ?? "miaw.default",
-        list: () => opts.attention?.soundboard?.list?.() ?? [],
-      },
-    },
-    keys: {
-      formatSequence: () => "",
-      formatBindings: () => undefined,
-    },
-    get client() {
-      return client()
-    },
-    event: opts.event ?? {
-      on: () => {
-        if (count) count.event_add += 1
-        return () => {
-          if (!count) return
-          count.event_drop += 1
-        }
-      },
-    },
-    renderer,
-    slots: {
-      register: () => "fixture-slot",
-    },
-    plugins: {
-      list: () => [],
-      activate: async () => false,
-      deactivate: async () => false,
-      add: async () => false,
-      install: async () => ({
-        ok: false,
-        message: "not implemented in fixture",
-      }),
-    },
-    lifecycle: {
-      signal: ctrl.signal,
-      onDispose() {
-        return () => {}
-      },
-    },
-    keymap,
-    mode: opts.mode ?? {
-      current: () => "base",
-      push: () => () => {},
-    },
-    route: {
-      register: () => {
-        if (count) count.route_add += 1
-        return () => {
-          if (!count) return
-          count.route_drop += 1
-        }
-      },
-      navigate: () => {},
-      get current() {
-        return { name: "home" }
-      },
-    },
-    ui: {
-      Dialog: () => null,
-      DialogAlert: () => null,
-      DialogConfirm: () => null,
-      DialogPrompt: () => null,
-      DialogSelect: () => null,
-      Slot: () => null,
-      Prompt: () => null,
-      toast: () => {},
-      dialog: {
-        replace: () => {
-          depth = 1
-        },
-        clear: () => {
-          depth = 0
-          size = "medium"
-        },
-        setSize: (next) => {
-          size = next
-        },
-        get size() {
-          return size
-        },
-        get depth() {
-          return depth
-        },
-        get open() {
-          return depth > 0
-        },
-      },
-    },
-    tuiConfig: tuiConfig(opts.tuiConfig),
-    kv: {
-      get: kvGet,
-      set(name, value) {
-        kv[name] = value
-      },
-      get ready() {
-        return true
-      },
-    },
-    state: {
-      get ready() {
-        return opts.state?.ready ?? true
-      },
-      get config() {
-        return opts.state?.config ?? {}
-      },
-      get provider() {
-        return opts.state?.provider ?? []
-      },
-      get path() {
-        return opts.state?.path ?? { home: "", state: "", config: "", worktree: "", directory: "" }
-      },
-      get vcs() {
-        return opts.state?.vcs
-      },
-      session: {
-        count: opts.state?.session?.count ?? (() => 0),
-        get: opts.state?.session?.get ?? (() => undefined),
-        diff: opts.state?.session?.diff ?? (() => []),
-        todo: opts.state?.session?.todo ?? (() => []),
-        messages: opts.state?.session?.messages ?? (() => []),
-        status: opts.state?.session?.status ?? (() => undefined),
-        permission: opts.state?.session?.permission ?? (() => []),
-        question: opts.state?.session?.question ?? (() => []),
-      },
-      part: opts.state?.part ?? (() => []),
-      lsp: opts.state?.lsp ?? (() => []),
-      mcp: opts.state?.mcp ?? (() => []),
-    },
-    theme: {
-      get current() {
-        return opts.theme?.current ?? themeCurrent()
-      },
-      get selected() {
-        return selected
-      },
-      has(name) {
-        return has(name)
-      },
-      set(name) {
-        return set(name)
-      },
-      async install(file) {
-        if (opts.theme?.install) return opts.theme.install(file)
-        throw new Error("base theme.install should not run")
-      },
-      mode() {
-        if (opts.theme?.mode) return opts.theme.mode()
-        return "dark"
-      },
-      get ready() {
-        return opts.theme?.ready ?? true
-      },
-    },
-  }
-}