Skip to main content

Capability API

This page describes the current capability definition helpers.

Why this exists​

Capabilities are declared through small helper functions so the task-domain contract stays explicit.

How it works​

Current capability definition shape:

type CapabilityDefinition<
  TOutput,
  TContext = Record<string, unknown>,
  TRuntime = Record<string, unknown>,
> = {
  name: string;
  description?: string;
  defaultVerify?: Verifier<TOutput>;
  metadata?: Record<string, unknown>;
};

Current helpers:

defineCapability(capability)
createCapabilityRegistry(capabilities)
normalizeVerifyResult(result, source)

Example​

const capabilities = createCapabilityRegistry({
  "browser.extract_hacker_news_top_story": defineCapability({
    name: "browser.extract_hacker_news_top_story",
    defaultVerify(result) {
      return {
        passed: typeof result.title === "string" && result.title.length > 0,
        violations: [],
      };
    },
  }),
});

Notes​

Common confusion

Capability APIs describe task-domain contracts. They do not expose browser methods.