@wundercorp/provider-sdk

Create compute-provider adapters for AgentVM without modifying the AgentVM API, CLI, dashboard, billing engine, or database model.

Adapters can run:

• Remotely over HTTPS — recommended for customer and third-party adapters.
• In process as a Node package — intended for trusted operator-maintained adapters.

Node adapter

import { defineProviderAdapter } from '@wundercorp/provider-sdk';

export default defineProviderAdapter({
  manifest: {
    id: 'acme-cloud',
    name: 'Acme Cloud',
    apiVersion: '1.0',
    capabilities: ['instances', 'cloud-init', 'ipv4'],
    pricing: 'live',
  },
  create(options) {
    return {
      async catalog({ region }) { /* return normalized regions, images, plans and prices */ },
      async createInstance(request) {},
      async getInstance(providerResourceId, region) {},
      async poweronInstance(providerResourceId, region) {},
      async rebootInstance(providerResourceId, region) {},
      async poweroffInstance(providerResourceId, region) {},
      async deleteInstance(providerResourceId, region) {},
    };
  },
});

HTTPS adapter endpoints

GET  /v1/manifest
POST /v1/catalog
POST /v1/instances/create
POST /v1/instances/get
POST /v1/instances/poweron
POST /v1/instances/reboot
POST /v1/instances/poweroff
POST /v1/instances/delete
POST /v1/usage/reconcile       optional

AgentVM converts every adapter catalog to the same model, selects compatible public products from the provider's base machine offerings, and calculates customer prices from the immutable provider quote plus the configured markup and optional public price floor.