Skip to content

Built for people who want to own their automations. Join the waitlist for an invite.

← All guides

Platform efficiency

Official Kody guide

Kody meters unique Dynamic Worker days so Cloudflare isolate cost is visible by surface. This page states that cost model once. Package README and AGENTS.md files do not repeat it.

Unique worker days

Cloudflare bills unique Dynamic Worker isolates (a worker id) per UTC day. Kody records that unit as the unique_worker_days / dynamic_worker_day meter.

  • The first use of a given worker id on a UTC day counts once for that user.
  • Repeating the same worker id on the same UTC day does not add another day.
  • Worker identity follows the module graph for that run: the same published graph reuses one isolate; a different graph is a different isolate.

Each plan includes a monthly unique-worker-day allotment. Public-ladder overage uses the published unique-worker-day rate on Pricing. Account usage (/account/usage and usageGet) reports the meter with what counts.

Surfaces

The same meter is tagged with the surface that minted the isolate:

SurfaceTypical mint
executeAd hoc MCP / capability execute
jobPackage-owned scheduled or jobRunNow work
package_exportA saved-package export invocation
workflowA Cloudflare Workflow run
subscriptionA package subscription handler
app_fetch / app_realtimeA package app HTTP or websocket isolate
retriever / webhookSearch retrievers and inbound webhooks

Saved packages, jobs, and other durable surfaces reuse a stable isolate when the published module graph stays the same. Ad hoc execute identity follows the module graph of that execute run.

Choosing a surface

Search first, then pick the smallest durable home that matches the work:

  • A built-in capability or an existing saved-package export, called from execute or another package.
  • A saved package when the behavior will be reused, scheduled, tested, or evolved — see Package lifecycle and Package authoring.
  • A workflow for durable multi-step or deferred work.

execute is the exploration and composition surface. Durable named behavior lives in a package so later runs share that package's module graph.

Related

Working with an agent? This guide is also plain markdown at /guides/platform-efficiency.md, or load it over MCP with search({ entity: 'platform_efficiency:guide' }).