@framers/agentos-ext-cloud-railway 0.1.0 → 0.1.2

package/manifest.json

@@ -2,16 +2,16 @@
   "$schema": "https://agentos.sh/schemas/extension-manifest-v1.json",
   "id": "com.framers.cloud.railway",
   "name": "Railway Cloud Deployment",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Deploy services to Railway, manage projects and environments, provision database plugins (Postgres, Redis, MySQL, MongoDB), and stream deployment logs via the Railway GraphQL API.",
   "author": {
     "name": "Frame.dev",
     "email": "support@frame.dev",
-    "url": "https://github.com/framersai"
+    "url": "https://github.com/framerslab"
   },
-  "license": "MIT",
+  "license": "Apache-2.0",
   "keywords": ["cloud", "railway", "deploy", "paas", "graphql", "database"],
-  "agentosVersion": "^2.0.0",
+  "agentosVersion": ">=0.10.40",
   "categories": ["tool", "cloud"],
   "platforms": [],
   "sdk": "none",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/agentos-ext-cloud-railway",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Railway cloud deployment extension — deploy services, manage projects, provision databases, and retrieve logs via the Railway GraphQL API.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -35,29 +35,37 @@
       "url": "https://github.com/jddunn"
     }
   ],
-  "license": "MIT",
+  "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "https://github.com/framersai/agentos-extensions.git",
+    "url": "git+https://github.com/framerslab/agentos-extensions.git",
     "directory": "registry/curated/cloud/railway"
   },
   "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.13.40"
   },
+  "homepage": "https://github.com/framerslab/agentos-extensions/tree/master/registry/curated/cloud/railway#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/RailwayService.ts

@@ -1,415 +0,0 @@
-// @ts-nocheck
-/**
- * @fileoverview Railway GraphQL API service layer.
- *
- * Wraps the Railway GraphQL API v2 for project management, service deployment,
- * database plugin provisioning, and deployment log retrieval.
- */
-
-// ---------------------------------------------------------------------------
-// Types
-// ---------------------------------------------------------------------------
-
-export interface RailwayConfig {
-  /** Railway API token (from https://railway.com/account/tokens) */
-  token: string;
-  /** GraphQL API base URL (defaults to https://backboard.railway.com/graphql/v2) */
-  baseUrl?: string;
-}
-
-export interface RailwayProject {
-  id: string;
-  name: string;
-  description: string;
-  createdAt: string;
-  updatedAt: string;
-  environments: RailwayEnvironment[];
-  services: RailwayService_[];
-}
-
-export interface RailwayEnvironment {
-  id: string;
-  name: string;
-  isEphemeral: boolean;
-}
-
-/** Underscore suffix to avoid clash with the service class name. */
-export interface RailwayService_ {
-  id: string;
-  name: string;
-  projectId: string;
-  createdAt: string;
-  updatedAt: string;
-  icon?: string;
-}
-
-export interface RailwayDeployment {
-  id: string;
-  serviceId: string;
-  environmentId: string;
-  status: string;
-  createdAt: string;
-  url?: string;
-  staticUrl?: string;
-}
-
-export interface RailwayPlugin {
-  id: string;
-  name: string;
-  status: string;
-  friendlyName: string;
-}
-
-export interface RailwayLogEntry {
-  timestamp: string;
-  message: string;
-  severity: string;
-}
-
-// ---------------------------------------------------------------------------
-// Service
-// ---------------------------------------------------------------------------
-
-export class RailwayService {
-  private config: RailwayConfig;
-  private running = false;
-
-  constructor(config: RailwayConfig) {
-    this.config = {
-      ...config,
-      baseUrl: config.baseUrl ?? 'https://backboard.railway.com/graphql/v2',
-    };
-  }
-
-  async initialize(): Promise<void> {
-    // Validate token by fetching current user
-    const result = await this.gql<{ me: { id: string } }>(`query { me { id name email } }`);
-    if (!result.me?.id) {
-      throw new Error('Railway auth failed: could not retrieve user');
-    }
-    this.running = true;
-  }
-
-  async shutdown(): Promise<void> {
-    this.running = false;
-  }
-
-  get isRunning(): boolean {
-    return this.running;
-  }
-
-  // ── Projects ─────────────────────────────────────────────────────────────
-
-  /** List all projects. */
-  async listProjects(): Promise<RailwayProject[]> {
-    const result = await this.gql<{ projects: { edges: Array<{ node: any }> } }>(`
-      query {
-        projects {
-          edges {
-            node {
-              id
-              name
-              description
-              createdAt
-              updatedAt
-              environments {
-                edges { node { id name isEphemeral } }
-              }
-              services {
-                edges { node { id name projectId createdAt updatedAt icon } }
-              }
-            }
-          }
-        }
-      }
-    `);
-
-    return (result.projects?.edges ?? []).map((e: any) => this.mapProject(e.node));
-  }
-
-  /** Get a single project by ID. */
-  async getProject(projectId: string): Promise<RailwayProject> {
-    const result = await this.gql<{ project: any }>(`
-      query($id: String!) {
-        project(id: $id) {
-          id
-          name
-          description
-          createdAt
-          updatedAt
-          environments {
-            edges { node { id name isEphemeral } }
-          }
-          services {
-            edges { node { id name projectId createdAt updatedAt icon } }
-          }
-        }
-      }
-    `, { id: projectId });
-
-    return this.mapProject(result.project);
-  }
-
-  /** Create a new project. */
-  async createProject(name: string, description?: string): Promise<RailwayProject> {
-    const result = await this.gql<{ projectCreate: any }>(`
-      mutation($input: ProjectCreateInput!) {
-        projectCreate(input: $input) {
-          id
-          name
-          description
-          createdAt
-          updatedAt
-          environments {
-            edges { node { id name isEphemeral } }
-          }
-          services {
-            edges { node { id name projectId createdAt updatedAt icon } }
-          }
-        }
-      }
-    `, { input: { name, description: description ?? '' } });
-
-    return this.mapProject(result.projectCreate);
-  }
-
-  // ── Services ─────────────────────────────────────────────────────────────
-
-  /** Create a service in a project from a GitHub repo. */
-  async createService(projectId: string, opts: {
-    name?: string;
-    source?: { repo: string };
-    variables?: Record<string, string>;
-  }): Promise<RailwayService_> {
-    const result = await this.gql<{ serviceCreate: any }>(`
-      mutation($input: ServiceCreateInput!) {
-        serviceCreate(input: $input) {
-          id
-          name
-          projectId
-          createdAt
-          updatedAt
-        }
-      }
-    `, {
-      input: {
-        projectId,
-        name: opts.name,
-        source: opts.source ? { repo: opts.source.repo } : undefined,
-      },
-    });
-
-    const service = result.serviceCreate;
-
-    // Set env variables if provided
-    if (opts.variables && Object.keys(opts.variables).length > 0) {
-      // Get the production environment
-      const project = await this.getProject(projectId);
-      const prodEnv = project.environments.find(e => !e.isEphemeral) ?? project.environments[0];
-      if (prodEnv) {
-        await this.upsertVariables(service.id, prodEnv.id, opts.variables);
-      }
-    }
-
-    return {
-      id: service.id,
-      name: service.name ?? '',
-      projectId: service.projectId ?? projectId,
-      createdAt: service.createdAt ?? '',
-      updatedAt: service.updatedAt ?? '',
-    };
-  }
-
-  /** Trigger a redeployment for a service in a given environment. */
-  async redeployService(serviceId: string, environmentId: string): Promise<RailwayDeployment> {
-    const result = await this.gql<{ serviceInstanceRedeploy: boolean }>(`
-      mutation($serviceId: String!, $environmentId: String!) {
-        serviceInstanceRedeploy(serviceId: $serviceId, environmentId: $environmentId)
-      }
-    `, { serviceId, environmentId });
-
-    // The redeploy mutation returns a boolean; fetch latest deployment
-    return this.getLatestDeployment(serviceId, environmentId);
-  }
-
-  /** Set environment variables for a service instance. */
-  async upsertVariables(serviceId: string, environmentId: string, variables: Record<string, string>): Promise<boolean> {
-    const result = await this.gql<{ variableCollectionUpsert: boolean }>(`
-      mutation($input: VariableCollectionUpsertInput!) {
-        variableCollectionUpsert(input: $input)
-      }
-    `, {
-      input: {
-        serviceId,
-        environmentId,
-        variables,
-      },
-    });
-
-    return result.variableCollectionUpsert ?? false;
-  }
-
-  // ── Plugins (Databases) ──────────────────────────────────────────────────
-
-  /** Create a database plugin in a project. */
-  async createPlugin(projectId: string, plugin: 'postgresql' | 'redis' | 'mysql' | 'mongodb'): Promise<RailwayPlugin> {
-    const result = await this.gql<{ pluginCreate: any }>(`
-      mutation($input: PluginCreateInput!) {
-        pluginCreate(input: $input) {
-          id
-          name
-          status
-          friendlyName
-        }
-      }
-    `, {
-      input: {
-        projectId,
-        name: plugin,
-      },
-    });
-
-    const p = result.pluginCreate;
-    return {
-      id: p.id,
-      name: p.name ?? plugin,
-      status: p.status ?? 'provisioning',
-      friendlyName: p.friendlyName ?? plugin,
-    };
-  }
-
-  // ── Deployments ──────────────────────────────────────────────────────────
-
-  /** Get the latest deployment for a service in an environment. */
-  async getLatestDeployment(serviceId: string, environmentId: string): Promise<RailwayDeployment> {
-    const result = await this.gql<{ deployments: { edges: Array<{ node: any }> } }>(`
-      query($input: DeploymentListInput!) {
-        deployments(input: $input, first: 1) {
-          edges {
-            node {
-              id
-              serviceId
-              environmentId
-              status
-              createdAt
-              staticUrl
-            }
-          }
-        }
-      }
-    `, {
-      input: { serviceId, environmentId },
-    });
-
-    const edge = result.deployments?.edges?.[0];
-    if (!edge) {
-      return {
-        id: '',
-        serviceId,
-        environmentId,
-        status: 'unknown',
-        createdAt: '',
-      };
-    }
-
-    const d = edge.node;
-    return {
-      id: d.id,
-      serviceId: d.serviceId ?? serviceId,
-      environmentId: d.environmentId ?? environmentId,
-      status: d.status ?? 'unknown',
-      createdAt: d.createdAt ?? '',
-      url: d.url,
-      staticUrl: d.staticUrl,
-    };
-  }
-
-  // ── Logs ─────────────────────────────────────────────────────────────────
-
-  /** Get deployment logs. */
-  async getDeploymentLogs(deploymentId: string): Promise<RailwayLogEntry[]> {
-    const result = await this.gql<{ deploymentLogs: any[] }>(`
-      query($deploymentId: String!) {
-        deploymentLogs(deploymentId: $deploymentId) {
-          timestamp
-          message
-          severity
-        }
-      }
-    `, { deploymentId });
-
-    return (result.deploymentLogs ?? []).map((l: any) => ({
-      timestamp: l.timestamp ?? '',
-      message: l.message ?? '',
-      severity: l.severity ?? 'info',
-    }));
-  }
-
-  /** Get build logs for a deployment. */
-  async getBuildLogs(deploymentId: string): Promise<RailwayLogEntry[]> {
-    const result = await this.gql<{ buildLogs: any[] }>(`
-      query($deploymentId: String!) {
-        buildLogs(deploymentId: $deploymentId) {
-          timestamp
-          message
-          severity
-        }
-      }
-    `, { deploymentId });
-
-    return (result.buildLogs ?? []).map((l: any) => ({
-      timestamp: l.timestamp ?? '',
-      message: l.message ?? '',
-      severity: l.severity ?? 'info',
-    }));
-  }
-
-  // ── Helpers ──────────────────────────────────────────────────────────────
-
-  private async gql<T = any>(query: string, variables?: Record<string, unknown>): Promise<T> {
-    const res = await globalThis.fetch(this.config.baseUrl!, {
-      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(`Railway API ${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(`Railway GraphQL: ${json.errors.map(e => e.message).join('; ')}`);
-    }
-
-    return json.data as T;
-  }
-
-  private mapProject(data: any): RailwayProject {
-    return {
-      id: data.id,
-      name: data.name ?? '',
-      description: data.description ?? '',
-      createdAt: data.createdAt ?? '',
-      updatedAt: data.updatedAt ?? '',
-      environments: (data.environments?.edges ?? []).map((e: any) => ({
-        id: e.node.id,
-        name: e.node.name ?? '',
-        isEphemeral: e.node.isEphemeral ?? false,
-      })),
-      services: (data.services?.edges ?? []).map((e: any) => ({
-        id: e.node.id,
-        name: e.node.name ?? '',
-        projectId: e.node.projectId ?? data.id,
-        createdAt: e.node.createdAt ?? '',
-        updatedAt: e.node.updatedAt ?? '',
-        icon: e.node.icon,
-      })),
-    };
-  }
-}

package/src/index.ts

@@ -1,109 +0,0 @@
-// @ts-nocheck
-/**
- * @fileoverview Railway Cloud Extension for AgentOS.
- *
- * Provides 4 tools for deploying services, listing projects, provisioning
- * databases, and retrieving logs via the Railway GraphQL API.
- *
- * @module @framers/agentos-ext-cloud-railway
- */
-
-import { RailwayService } from './RailwayService.js';
-import type { RailwayConfig } from './RailwayService.js';
-import { RailwayDeployServiceTool } from './tools/deployService.js';
-import { RailwayListServicesTool } from './tools/listServices.js';
-import { RailwayAddDatabaseTool } from './tools/addDatabase.js';
-import { RailwayGetLogsTool } from './tools/getLogs.js';
-
-// ---------------------------------------------------------------------------
-// Options
-// ---------------------------------------------------------------------------
-
-export interface RailwayCloudOptions {
-  token?: string;
-  secrets?: Record<string, string>;
-}
-
-// ---------------------------------------------------------------------------
-// Secret Resolution
-// ---------------------------------------------------------------------------
-
-function resolveConfig(opts: RailwayCloudOptions, secrets: Record<string, string>): RailwayConfig {
-  return {
-    token:
-      opts.token ?? secrets['railway.token']
-      ?? process.env.RAILWAY_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 RailwayCloudOptions;
-  const secrets = opts.secrets ?? context.secrets ?? {};
-  const config = resolveConfig(opts, secrets);
-
-  const service = new RailwayService(config);
-
-  const deployServiceTool = new RailwayDeployServiceTool(service);
-  const listServicesTool = new RailwayListServicesTool(service);
-  const addDatabaseTool = new RailwayAddDatabaseTool(service);
-  const getLogsTool = new RailwayGetLogsTool(service);
-
-  return {
-    name: '@framers/agentos-ext-cloud-railway',
-    version: '0.1.0',
-    descriptors: [
-      { id: 'railwayDeployService', kind: 'tool', priority: 40, payload: deployServiceTool },
-      { id: 'railwayListServices', kind: 'tool', priority: 40, payload: listServicesTool },
-      { id: 'railwayAddDatabase', kind: 'tool', priority: 40, payload: addDatabaseTool },
-      { id: 'railwayGetLogs', kind: 'tool', priority: 40, payload: getLogsTool },
-    ],
-    onActivate: async () => {
-      if (!config.token) {
-        throw new Error(
-          'Railway: no API token provided. Set RAILWAY_TOKEN environment variable, '
-          + 'or provide it via secrets["railway.token"].',
-        );
-      }
-      await service.initialize();
-    },
-    onDeactivate: async () => {
-      await service.shutdown();
-    },
-  };
-}
-
-// ---------------------------------------------------------------------------
-// Public exports
-// ---------------------------------------------------------------------------
-
-export { RailwayService } from './RailwayService.js';
-export type { RailwayConfig, RailwayProject, RailwayEnvironment, RailwayService_ as RailwayServiceInfo, RailwayDeployment, RailwayPlugin, RailwayLogEntry } from './RailwayService.js';
-export { RailwayDeployServiceTool } from './tools/deployService.js';
-export { RailwayListServicesTool } from './tools/listServices.js';
-export { RailwayAddDatabaseTool } from './tools/addDatabase.js';
-export { RailwayGetLogsTool } from './tools/getLogs.js';
-
-export default createExtensionPack;

package/src/tools/addDatabase.ts

@@ -1,45 +0,0 @@
-// @ts-nocheck
-/**
- * @fileoverview RailwayAddDatabaseTool — provision a database plugin on Railway.
- */
-
-import type { RailwayService, RailwayPlugin } from '../RailwayService.js';
-
-export interface RailwayAddDatabaseInput {
-  projectId: string;
-  plugin: 'postgresql' | 'redis' | 'mysql' | 'mongodb';
-}
-
-export class RailwayAddDatabaseTool {
-  readonly id = 'railwayAddDatabase';
-  readonly name = 'railwayAddDatabase';
-  readonly displayName = 'Add Railway Database';
-  readonly description = 'Provision a database plugin in a Railway project. Supports PostgreSQL, Redis, MySQL, and MongoDB. The database will be automatically connected to services in the same project via environment variables.';
-  readonly category = 'cloud';
-  readonly version = '0.1.0';
-  readonly hasSideEffects = true;
-
-  readonly inputSchema = {
-    type: 'object' as const,
-    properties: {
-      projectId: { type: 'string', description: 'Railway project ID to add the database to' },
-      plugin: {
-        type: 'string',
-        enum: ['postgresql', 'redis', 'mysql', 'mongodb'],
-        description: 'Database type to provision',
-      },
-    },
-    required: ['projectId', 'plugin'],
-  };
-
-  constructor(private service: RailwayService) {}
-
-  async execute(args: RailwayAddDatabaseInput): Promise<{ success: boolean; data?: RailwayPlugin; error?: string }> {
-    try {
-      const plugin = await this.service.createPlugin(args.projectId, args.plugin);
-      return { success: true, data: plugin };
-    } catch (err: any) {
-      return { success: false, error: err.message };
-    }
-  }
-}