@framers/agentos-ext-cloud-flyio 0.1.0 → 0.1.1

package/manifest.json

@@ -2,12 +2,12 @@
   "$schema": "https://agentos.sh/schemas/extension-manifest-v1.json",
   "id": "com.framers.cloud.flyio",
   "name": "Fly.io Cloud Deployment",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Deploy and manage applications on Fly.io using the Machines API. Create apps, launch machines with custom configs, scale instances by count and size, and provision persistent volumes for stateful workloads.",
   "author": {
     "name": "Frame.dev",
     "email": "support@frame.dev",
-    "url": "https://github.com/framersai"
+    "url": "https://github.com/framerslab"
   },
   "license": "MIT",
   "keywords": ["cloud", "flyio", "fly", "deploy", "machines", "edge", "volumes"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/agentos-ext-cloud-flyio",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Fly.io cloud deployment extension — deploy apps, manage machines, scale instances, and create persistent volumes via the Fly Machines API.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -39,26 +39,34 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/framersai/agentos-extensions.git",
+    "url": "git+https://github.com/framerslab/agentos-extensions.git",
     "directory": "registry/curated/cloud/flyio"
   },
   "publishConfig": {
     "access": "public"
   },
   "peerDependencies": {
-    "@framers/agentos": "^0.5.2"
+    "@framers/agentos": ">=0.10.40"
   },
   "devDependencies": {
-    "@framers/agentos": "^0.6.6",
     "@types/node": "^20.12.12",
     "rimraf": "^5.0.7",
     "typescript": "^5.4.5",
-    "vitest": "^1.6.0"
+    "vitest": "^3.2.7",
+    "@framers/agentos": "^0.10.40"
   },
+  "homepage": "https://github.com/framerslab/agentos-extensions/tree/master/registry/curated/cloud/flyio#readme",
+  "bugs": {
+    "url": "https://github.com/framerslab/agentos-extensions/issues"
+  },
+  "files": [
+    "dist",
+    "manifest.json"
+  ],
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
-    "test": "vitest run",
+    "test": "vitest run --passWithNoTests",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
     "clean": "rimraf dist"

package/src/FlyService.ts

@@ -1,364 +0,0 @@
-// @ts-nocheck
-/**
- * @fileoverview Fly.io Machines API service layer.
- *
- * Wraps the Fly Machines API for app creation, machine management,
- * scaling, and volume provisioning. Uses the GraphQL API for listing
- * apps (organization-scoped) and the Machines REST API for everything else.
- */
-
-// ---------------------------------------------------------------------------
-// Types
-// ---------------------------------------------------------------------------
-
-export interface FlyConfig {
-  /** Fly.io API token (from `flyctl tokens create`) */
-  token: string;
-  /** Machines API base URL (defaults to https://api.machines.dev/v1) */
-  baseUrl?: string;
-  /** GraphQL API base URL for org-level queries (defaults to https://api.fly.io/graphql) */
-  graphqlUrl?: string;
-}
-
-export interface FlyApp {
-  id: string;
-  name: string;
-  organization: string;
-  status: string;
-  hostname: string;
-  createdAt?: string;
-  machines?: FlyMachine[];
-}
-
-export interface FlyMachine {
-  id: string;
-  name: string;
-  state: string;
-  region: string;
-  instanceId: string;
-  privateIp: string;
-  config: FlyMachineConfig;
-  imageRef?: { repository: string; tag: string; digest: string };
-  createdAt: string;
-  updatedAt: string;
-}
-
-export interface FlyMachineConfig {
-  image: string;
-  env?: Record<string, string>;
-  services?: FlyMachineService[];
-  guest?: { cpus: number; cpu_kind: string; memory_mb: number };
-  size?: string;
-  auto_destroy?: boolean;
-  restart?: { policy: string; max_retries?: number };
-  mounts?: Array<{ volume: string; path: string }>;
-}
-
-export interface FlyMachineService {
-  ports: Array<{ port: number; handlers: string[]; force_https?: boolean }>;
-  protocol: string;
-  internal_port: number;
-  autostop?: boolean;
-  autostart?: boolean;
-  min_machines_running?: number;
-}
-
-export interface FlyVolume {
-  id: string;
-  name: string;
-  state: string;
-  sizeGb: number;
-  region: string;
-  encrypted: boolean;
-  createdAt: string;
-  attachedMachineId?: string;
-  attachedAllocId?: string;
-}
-
-// ---------------------------------------------------------------------------
-// Service
-// ---------------------------------------------------------------------------
-
-export class FlyService {
-  private config: FlyConfig;
-  private running = false;
-
-  constructor(config: FlyConfig) {
-    this.config = {
-      ...config,
-      baseUrl: config.baseUrl ?? 'https://api.machines.dev/v1',
-      graphqlUrl: config.graphqlUrl ?? 'https://api.fly.io/graphql',
-    };
-  }
-
-  async initialize(): Promise<void> {
-    // Validate token by listing apps (lightweight org query)
-    const res = await this.gql<{ currentUser: { id: string } }>(`
-      query { currentUser { id email } }
-    `);
-    if (!res.currentUser?.id) {
-      throw new Error('Fly.io auth failed: could not retrieve user');
-    }
-    this.running = true;
-  }
-
-  async shutdown(): Promise<void> {
-    this.running = false;
-  }
-
-  get isRunning(): boolean {
-    return this.running;
-  }
-
-  // ── Apps ─────────────────────────────────────────────────────────────────
-
-  /** Create a new Fly app. */
-  async createApp(name: string, org?: string): Promise<FlyApp> {
-    const body: Record<string, unknown> = {
-      app_name: name,
-      org_slug: org ?? 'personal',
-    };
-
-    const res = await this.fetch('/apps', {
-      method: 'POST',
-      body: JSON.stringify(body),
-    });
-
-    // Machines API returns minimal data on create; fetch full app
-    if (!res.ok) {
-      const text = await res.text();
-      throw new Error(`Fly.io API ${res.status}: ${text.slice(0, 500)}`);
-    }
-
-    return this.getApp(name);
-  }
-
-  /** Get an app by name. */
-  async getApp(appName: string): Promise<FlyApp> {
-    const result = await this.gql<{ app: any }>(`
-      query($name: String!) {
-        app(name: $name) {
-          id
-          name
-          organization { slug }
-          status
-          hostname
-          createdAt
-        }
-      }
-    `, { name: appName });
-
-    const a = result.app;
-    return {
-      id: a.id,
-      name: a.name,
-      organization: a.organization?.slug ?? '',
-      status: a.status ?? 'pending',
-      hostname: a.hostname ?? `${a.name}.fly.dev`,
-      createdAt: a.createdAt,
-    };
-  }
-
-  /** List all apps in the personal org (via GraphQL). */
-  async listApps(): Promise<FlyApp[]> {
-    const result = await this.gql<{ apps: { nodes: any[] } }>(`
-      query {
-        apps {
-          nodes {
-            id
-            name
-            organization { slug }
-            status
-            hostname
-            createdAt
-          }
-        }
-      }
-    `);
-
-    return (result.apps?.nodes ?? []).map((a: any) => ({
-      id: a.id,
-      name: a.name,
-      organization: a.organization?.slug ?? '',
-      status: a.status ?? 'pending',
-      hostname: a.hostname ?? `${a.name}.fly.dev`,
-      createdAt: a.createdAt,
-    }));
-  }
-
-  // ── Machines ─────────────────────────────────────────────────────────────
-
-  /** Create a machine in an app. */
-  async createMachine(appName: string, config: FlyMachineConfig, opts?: {
-    name?: string;
-    region?: string;
-  }): Promise<FlyMachine> {
-    const body: Record<string, unknown> = { config };
-    if (opts?.name) body.name = opts.name;
-    if (opts?.region) body.region = opts.region;
-
-    const res = await this.fetch(`/apps/${encodeURIComponent(appName)}/machines`, {
-      method: 'POST',
-      body: JSON.stringify(body),
-    });
-    const data = await this.json(res);
-    return this.mapMachine(data);
-  }
-
-  /** List all machines in an app. */
-  async listMachines(appName: string): Promise<FlyMachine[]> {
-    const res = await this.fetch(`/apps/${encodeURIComponent(appName)}/machines`);
-    const data = await this.json(res);
-    return (data as any[]).map((m: any) => this.mapMachine(m));
-  }
-
-  /** Stop and destroy a machine. */
-  async destroyMachine(appName: string, machineId: string, force = false): Promise<void> {
-    // Stop first
-    try {
-      await this.fetch(
-        `/apps/${encodeURIComponent(appName)}/machines/${machineId}/stop`,
-        { method: 'POST', body: JSON.stringify({}) },
-      );
-    } catch {
-      // Machine may already be stopped
-    }
-
-    const url = `/apps/${encodeURIComponent(appName)}/machines/${machineId}${force ? '?force=true' : ''}`;
-    const res = await this.fetch(url, { method: 'DELETE' });
-    if (!res.ok && res.status !== 404) {
-      const text = await res.text();
-      throw new Error(`Fly.io API ${res.status}: ${text.slice(0, 500)}`);
-    }
-  }
-
-  /** Update machine config (e.g. to change size/image). */
-  async updateMachine(appName: string, machineId: string, config: Partial<FlyMachineConfig>): Promise<FlyMachine> {
-    const res = await this.fetch(
-      `/apps/${encodeURIComponent(appName)}/machines/${machineId}`,
-      {
-        method: 'POST',
-        body: JSON.stringify({ config }),
-      },
-    );
-    const data = await this.json(res);
-    return this.mapMachine(data);
-  }
-
-  // ── Volumes ──────────────────────────────────────────────────────────────
-
-  /** Create a persistent volume. */
-  async createVolume(appName: string, opts: {
-    name: string;
-    region: string;
-    sizeGb: number;
-    encrypted?: boolean;
-  }): Promise<FlyVolume> {
-    const res = await this.fetch(`/apps/${encodeURIComponent(appName)}/volumes`, {
-      method: 'POST',
-      body: JSON.stringify({
-        name: opts.name,
-        region: opts.region,
-        size_gb: opts.sizeGb,
-        encrypted: opts.encrypted ?? true,
-      }),
-    });
-    const data = await this.json(res);
-    return this.mapVolume(data);
-  }
-
-  /** List volumes for an app. */
-  async listVolumes(appName: string): Promise<FlyVolume[]> {
-    const res = await this.fetch(`/apps/${encodeURIComponent(appName)}/volumes`);
-    const data = await this.json(res);
-    return (data as any[]).map((v: any) => this.mapVolume(v));
-  }
-
-  // ── Helpers ──────────────────────────────────────────────────────────────
-
-  private async fetch(path: string, init?: RequestInit): Promise<Response> {
-    const url = `${this.config.baseUrl}${path}`;
-    return globalThis.fetch(url, {
-      ...init,
-      headers: {
-        'Authorization': `Bearer ${this.config.token}`,
-        'Content-Type': 'application/json',
-        ...(init?.headers as Record<string, string> ?? {}),
-      },
-    });
-  }
-
-  private async json(res: Response): Promise<any> {
-    if (!res.ok) {
-      const text = await res.text();
-      throw new Error(`Fly.io API ${res.status}: ${text.slice(0, 500)}`);
-    }
-    return res.json();
-  }
-
-  private async gql<T = any>(query: string, variables?: Record<string, unknown>): Promise<T> {
-    const res = await globalThis.fetch(this.config.graphqlUrl!, {
-      method: 'POST',
-      headers: {
-        'Authorization': `Bearer ${this.config.token}`,
-        'Content-Type': 'application/json',
-      },
-      body: JSON.stringify({ query, variables }),
-    });
-
-    if (!res.ok) {
-      const text = await res.text();
-      throw new Error(`Fly.io GraphQL ${res.status}: ${text.slice(0, 500)}`);
-    }
-
-    const json = await res.json() as { data?: T; errors?: Array<{ message: string }> };
-
-    if (json.errors && json.errors.length > 0) {
-      throw new Error(`Fly.io GraphQL: ${json.errors.map(e => e.message).join('; ')}`);
-    }
-
-    return json.data as T;
-  }
-
-  private mapMachine(data: any): FlyMachine {
-    return {
-      id: data.id,
-      name: data.name ?? '',
-      state: data.state ?? 'unknown',
-      region: data.region ?? '',
-      instanceId: data.instance_id ?? '',
-      privateIp: data.private_ip ?? '',
-      config: {
-        image: data.config?.image ?? '',
-        env: data.config?.env,
-        services: data.config?.services,
-        guest: data.config?.guest,
-        size: data.config?.size,
-        auto_destroy: data.config?.auto_destroy,
-        restart: data.config?.restart,
-        mounts: data.config?.mounts,
-      },
-      imageRef: data.image_ref ? {
-        repository: data.image_ref.repository ?? '',
-        tag: data.image_ref.tag ?? '',
-        digest: data.image_ref.digest ?? '',
-      } : undefined,
-      createdAt: data.created_at ?? '',
-      updatedAt: data.updated_at ?? '',
-    };
-  }
-
-  private mapVolume(data: any): FlyVolume {
-    return {
-      id: data.id,
-      name: data.name ?? '',
-      state: data.state ?? 'created',
-      sizeGb: data.size_gb ?? 0,
-      region: data.region ?? '',
-      encrypted: data.encrypted ?? true,
-      createdAt: data.created_at ?? '',
-      attachedMachineId: data.attached_machine_id,
-      attachedAllocId: data.attached_alloc_id,
-    };
-  }
-}

package/src/index.ts

@@ -1,109 +0,0 @@
-// @ts-nocheck
-/**
- * @fileoverview Fly.io Cloud Extension for AgentOS.
- *
- * Provides 4 tools for deploying apps, listing apps/machines, scaling
- * instances, and creating persistent volumes via the Fly Machines API.
- *
- * @module @framers/agentos-ext-cloud-flyio
- */
-
-import { FlyService } from './FlyService.js';
-import type { FlyConfig } from './FlyService.js';
-import { FlyDeployAppTool } from './tools/deployApp.js';
-import { FlyListAppsTool } from './tools/listApps.js';
-import { FlyScaleAppTool } from './tools/scaleApp.js';
-import { FlyCreateVolumeTool } from './tools/createVolume.js';
-
-// ---------------------------------------------------------------------------
-// Options
-// ---------------------------------------------------------------------------
-
-export interface FlyCloudOptions {
-  token?: string;
-  secrets?: Record<string, string>;
-}
-
-// ---------------------------------------------------------------------------
-// Secret Resolution
-// ---------------------------------------------------------------------------
-
-function resolveConfig(opts: FlyCloudOptions, secrets: Record<string, string>): FlyConfig {
-  return {
-    token:
-      opts.token ?? secrets['fly.token']
-      ?? process.env.FLY_API_TOKEN ?? '',
-  };
-}
-
-// ---------------------------------------------------------------------------
-// Extension Context
-// ---------------------------------------------------------------------------
-
-export interface ExtensionContext {
-  options?: Record<string, unknown>;
-  secrets?: Record<string, string>;
-  getSecret?: (key: string) => string | undefined;
-  logger?: { info: (msg: string) => void };
-}
-
-export interface ExtensionPack {
-  name: string;
-  version: string;
-  descriptors: Array<{ id: string; kind: string; priority?: number; payload: unknown }>;
-  onActivate?: () => Promise<void>;
-  onDeactivate?: () => Promise<void>;
-}
-
-// ---------------------------------------------------------------------------
-// Factory
-// ---------------------------------------------------------------------------
-
-export function createExtensionPack(context: ExtensionContext): ExtensionPack {
-  const opts = (context.options ?? {}) as FlyCloudOptions;
-  const secrets = opts.secrets ?? context.secrets ?? {};
-  const config = resolveConfig(opts, secrets);
-
-  const service = new FlyService(config);
-
-  const deployAppTool = new FlyDeployAppTool(service);
-  const listAppsTool = new FlyListAppsTool(service);
-  const scaleAppTool = new FlyScaleAppTool(service);
-  const createVolumeTool = new FlyCreateVolumeTool(service);
-
-  return {
-    name: '@framers/agentos-ext-cloud-flyio',
-    version: '0.1.0',
-    descriptors: [
-      { id: 'flyDeployApp', kind: 'tool', priority: 40, payload: deployAppTool },
-      { id: 'flyListApps', kind: 'tool', priority: 40, payload: listAppsTool },
-      { id: 'flyScaleApp', kind: 'tool', priority: 40, payload: scaleAppTool },
-      { id: 'flyCreateVolume', kind: 'tool', priority: 40, payload: createVolumeTool },
-    ],
-    onActivate: async () => {
-      if (!config.token) {
-        throw new Error(
-          'Fly.io: no API token provided. Set FLY_API_TOKEN environment variable, '
-          + 'or provide it via secrets["fly.token"].',
-        );
-      }
-      await service.initialize();
-    },
-    onDeactivate: async () => {
-      await service.shutdown();
-    },
-  };
-}
-
-// ---------------------------------------------------------------------------
-// Public exports
-// ---------------------------------------------------------------------------
-
-export { FlyService } from './FlyService.js';
-export type { FlyConfig, FlyApp, FlyMachine, FlyMachineConfig, FlyMachineService, FlyVolume } from './FlyService.js';
-export { FlyDeployAppTool } from './tools/deployApp.js';
-export { FlyListAppsTool } from './tools/listApps.js';
-export { FlyScaleAppTool } from './tools/scaleApp.js';
-export { FlyCreateVolumeTool } from './tools/createVolume.js';
-
-export default createExtensionPack;

package/src/tools/createVolume.ts

@@ -1,53 +0,0 @@
-// @ts-nocheck
-/**
- * @fileoverview FlyCreateVolumeTool — create a persistent volume on Fly.io.
- */
-
-import type { FlyService, FlyVolume } from '../FlyService.js';
-
-export interface FlyCreateVolumeInput {
-  appName: string;
-  name: string;
-  region: string;
-  sizeGb: number;
-  encrypted?: boolean;
-}
-
-export class FlyCreateVolumeTool {
-  readonly id = 'flyCreateVolume';
-  readonly name = 'flyCreateVolume';
-  readonly displayName = 'Create Fly.io Volume';
-  readonly description = 'Create a persistent volume for a Fly.io app. Volumes persist data across machine restarts and redeployments. Must be in the same region as the machine that mounts it. Encrypted by default.';
-  readonly category = 'cloud';
-  readonly version = '0.1.0';
-  readonly hasSideEffects = true;
-
-  readonly inputSchema = {
-    type: 'object' as const,
-    properties: {
-      appName: { type: 'string', description: 'Name of the Fly app to create the volume in' },
-      name: { type: 'string', description: 'Volume name (used in mount config, e.g. "data", "postgres_data")' },
-      region: { type: 'string', description: 'Region for the volume (must match the machine region, e.g. "iad", "lax", "cdg")' },
-      sizeGb: { type: 'number', description: 'Volume size in GB (minimum: 1)' },
-      encrypted: { type: 'boolean', description: 'Whether the volume should be encrypted (default: true)' },
-    },
-    required: ['appName', 'name', 'region', 'sizeGb'],
-  };
-
-  constructor(private service: FlyService) {}
-
-  async execute(args: FlyCreateVolumeInput): Promise<{ success: boolean; data?: FlyVolume; error?: string }> {
-    try {
-      const volume = await this.service.createVolume(args.appName, {
-        name: args.name,
-        region: args.region,
-        sizeGb: args.sizeGb,
-        encrypted: args.encrypted,
-      });
-
-      return { success: true, data: volume };
-    } catch (err: any) {
-      return { success: false, error: err.message };
-    }
-  }
-}

package/src/tools/deployApp.ts

@@ -1,104 +0,0 @@
-// @ts-nocheck
-/**
- * @fileoverview FlyDeployAppTool — deploy an app on Fly.io by creating a machine with a config.
- */
-
-import type { FlyService, FlyMachine, FlyMachineConfig, FlyApp } from '../FlyService.js';
-
-export interface FlyDeployAppInput {
-  appName: string;
-  image: string;
-  region?: string;
-  cpus?: number;
-  cpuKind?: string;
-  memoryMb?: number;
-  env?: Record<string, string>;
-  internalPort?: number;
-  autoDestroy?: boolean;
-  createApp?: boolean;
-  org?: string;
-}
-
-export class FlyDeployAppTool {
-  readonly id = 'flyDeployApp';
-  readonly name = 'flyDeployApp';
-  readonly displayName = 'Deploy Fly.io App';
-  readonly description = 'Deploy an application on Fly.io by creating a machine with a Docker image. Creates the app first if it does not exist. Configure CPU, memory, region, environment variables, and exposed ports.';
-  readonly category = 'cloud';
-  readonly version = '0.1.0';
-  readonly hasSideEffects = true;
-
-  readonly inputSchema = {
-    type: 'object' as const,
-    properties: {
-      appName: { type: 'string', description: 'Fly app name (e.g. "my-web-app")' },
-      image: { type: 'string', description: 'Docker image to deploy (e.g. "registry.fly.io/my-app:latest" or "nginx:alpine")' },
-      region: { type: 'string', description: 'Fly region code (e.g. "iad", "lax", "cdg", "nrt"). Defaults to closest.' },
-      cpus: { type: 'number', description: 'Number of CPUs (default: 1)' },
-      cpuKind: { type: 'string', enum: ['shared', 'performance'], description: 'CPU type (default: shared)' },
-      memoryMb: { type: 'number', description: 'Memory in MB (default: 256)' },
-      env: { type: 'object', description: 'Environment variables (key-value pairs)' },
-      internalPort: { type: 'number', description: 'Internal port the app listens on (default: 8080)' },
-      autoDestroy: { type: 'boolean', description: 'Automatically destroy the machine when it exits (default: false)' },
-      createApp: { type: 'boolean', description: 'Create the app if it does not exist (default: true)' },
-      org: { type: 'string', description: 'Fly organization slug (default: "personal")' },
-    },
-    required: ['appName', 'image'],
-  };
-
-  constructor(private service: FlyService) {}
-
-  async execute(args: FlyDeployAppInput): Promise<{ success: boolean; data?: { app: FlyApp; machine: FlyMachine }; error?: string }> {
-    try {
-      // Create app if needed
-      const shouldCreate = args.createApp !== false;
-      let app: FlyApp;
-
-      try {
-        app = await this.service.getApp(args.appName);
-      } catch {
-        if (!shouldCreate) {
-          return { success: false, error: `App "${args.appName}" not found. Set createApp to true to create it.` };
-        }
-        app = await this.service.createApp(args.appName, args.org);
-      }
-
-      // Build machine config
-      const port = args.internalPort ?? 8080;
-      const config: FlyMachineConfig = {
-        image: args.image,
-        env: args.env,
-        guest: {
-          cpus: args.cpus ?? 1,
-          cpu_kind: args.cpuKind ?? 'shared',
-          memory_mb: args.memoryMb ?? 256,
-        },
-        auto_destroy: args.autoDestroy ?? false,
-        services: [
-          {
-            ports: [
-              { port: 80, handlers: ['http'], force_https: true },
-              { port: 443, handlers: ['http', 'tls'] },
-            ],
-            protocol: 'tcp',
-            internal_port: port,
-            autostart: true,
-            autostop: true,
-            min_machines_running: 0,
-          },
-        ],
-      };
-
-      const machine = await this.service.createMachine(args.appName, config, {
-        region: args.region,
-      });
-
-      return {
-        success: true,
-        data: { app, machine },
-      };
-    } catch (err: any) {
-      return { success: false, error: err.message };
-    }
-  }
-}