Capabilities: Discover What Your Praxa Agent Can Do

import { PraxaClient } from "@praxa/sdk";
import type { CapabilityRequirement } from "@praxa/sdk";

const client = new PraxaClient({
  baseUrl: process.env.PRAXA_BASE_URL!,
  accessToken: async () => process.env.PRAXA_ACCESS_TOKEN!,
});

// Describe what you need — the gateway matches against registered capabilities
const requirement: CapabilityRequirement = {
  actionFamily: "search",
  purpose:      "web search and summarization",
  targetType:   "webpage",
};

const capabilities = await client.searchCapabilities(requirement);

for (const cap of capabilities) {
  console.log(cap.capabilityId, cap.kind, cap.healthState);
}

import type { CapabilityManifest } from "@praxa/sdk";

type CapabilityManifest = Readonly<{
  readonly capabilityId: string;  // stable unique identifier for this capability
  readonly kind: "api" | "mcp" | "a2a_agent" | "browser" | "device" | "skill" | "human";
  readonly version: string;       // semantic version of the capability contract
  readonly contractHash: string;  // sha-256 hex digest of the capability contract
  readonly healthState: "healthy" | "degraded" | "unavailable" | "quarantined";
}>;

const healthy = capabilities.filter(cap => cap.healthState === "healthy");

if (healthy.length === 0) {
  throw new Error("No healthy capabilities matched the requirement.");
}

console.log(`${healthy.length} healthy capabilities available.`);

// You describe the goal — the agent handles capability selection
const mission = await client.createMission(
  {
    goalSpec: {
      task: "Search the web for recent TypeScript 5.5 release notes and summarise the key changes",
    },
    resourceBudget: {
      maximumSteps: 8,
      maximumToolCalls: 4,
      maximumElapsedMs: 60_000,
      maximumParallelism: 1,
    },
  },
  crypto.randomUUID(),
);