@tool-bridge/server 0.1.1 → 0.3.0

package/dist/railway-CEK4GLRQ.js

@@ -0,0 +1,452 @@
+import {
+  createProviderPlugin,
+  guardedFetch,
+  requireApiKey,
+  upstreamError
+} from "./chunk-CSJEZHQO.js";
+import "./chunk-K7FVSFUX.js";
+import {
+  TBError,
+  external_exports
+} from "./chunk-JLTYA2B3.js";
+import "./chunk-MLKGABMK.js";
+
+// ../plugins/src/railway/api.ts
+var SERVICE = "railway";
+var GRAPHQL_URL = "https://backboard.railway.com/graphql/v2";
+var DEFAULT_DEPLOYMENT_LIMIT = 20;
+var DEFAULT_LOG_LIMIT = 500;
+function record(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+function text(value) {
+  if (typeof value !== "string") return void 0;
+  const trimmed = value.trim();
+  return trimmed === "" ? void 0 : trimmed;
+}
+function compact(input) {
+  return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== void 0));
+}
+function responseError(message) {
+  return new TBError("unavailable", message, { retryable: true });
+}
+function required(value, field) {
+  const result = text(value);
+  if (result === void 0) throw new TBError("invalid_argument", `${field} \u662F\u5FC5\u586B\u7684`);
+  return result;
+}
+function errorMessages(payload) {
+  const errors = record(payload)?.errors;
+  if (!Array.isArray(errors)) return void 0;
+  const messages = errors.map((error) => text(record(error)?.message)).filter((message) => message !== void 0);
+  return messages.length > 0 ? messages.join("; ") : void 0;
+}
+function errorText(payload, status) {
+  const body = record(payload);
+  return errorMessages(payload) ?? text(body?.message) ?? text(body?.error) ?? text(body?.detail) ?? text(body?.title) ?? `Railway \u8FD4\u56DE HTTP ${status}`;
+}
+async function graphql(ctx, query, variables) {
+  const response = await guardedFetch(GRAPHQL_URL, {
+    method: "POST",
+    headers: {
+      "accept": "application/json",
+      "authorization": `Bearer ${requireApiKey(ctx, SERVICE)}`,
+      "content-type": "application/json"
+    },
+    body: JSON.stringify(variables === void 0 ? { query } : { query, variables })
+  });
+  const body = await response.text();
+  let payload;
+  if (body.trim() !== "") {
+    try {
+      payload = JSON.parse(body);
+    } catch {
+      if (response.ok) throw responseError("Railway \u8FD4\u56DE\u4E86\u975E JSON \u54CD\u5E94");
+    }
+  }
+  if (!response.ok) throw upstreamError(response.status, errorText(payload, response.status));
+  const envelope = record(payload);
+  if (envelope === void 0) throw responseError("Railway GraphQL \u54CD\u5E94\u4E0D\u662F\u5BF9\u8C61");
+  const failure = errorMessages(envelope);
+  if (failure !== void 0) throw new TBError("invalid_argument", failure);
+  const data = record(envelope.data);
+  if (data === void 0) throw responseError("Railway GraphQL \u54CD\u5E94\u7F3A data");
+  return data;
+}
+function nodes(value) {
+  const edges = record(value)?.edges;
+  if (!Array.isArray(edges)) return [];
+  return edges.flatMap((edge) => {
+    const node = record(record(edge)?.node);
+    return node === void 0 ? [] : [node];
+  });
+}
+function requireValue(value, message) {
+  if (value === void 0 || value === null) throw responseError(message);
+  return value;
+}
+function workspaceId(ctx) {
+  return text(ctx.config?.workspaceId);
+}
+var PROJECT_FIELDS = "id name description createdAt updatedAt";
+var DEPLOYMENT_FIELDS = "id status createdAt url staticUrl";
+async function listProjects(_input, ctx) {
+  const workspace = workspaceId(ctx);
+  const data = workspace === void 0 ? await graphql(ctx, `query projects {
+        projects {
+          edges { node { ${PROJECT_FIELDS} } }
+        }
+      }`) : await graphql(ctx, `query workspaceProjects($workspaceId: String!) {
+        projects(workspaceId: $workspaceId) {
+          edges { node { ${PROJECT_FIELDS} } }
+        }
+      }`, { workspaceId: workspace });
+  return { projects: nodes(data.projects) };
+}
+async function getProject(input, ctx) {
+  const data = await graphql(ctx, `query project($id: String!) {
+      project(id: $id) {
+        id
+        name
+        description
+        createdAt
+        services { edges { node { id name icon } } }
+        environments { edges { node { id name } } }
+      }
+    }`, { id: required(input.projectId, "projectId") });
+  const project = requireValue(record(data.project), "Railway \u6CA1\u6709\u8FD4\u56DE project");
+  return {
+    project: compact({
+      id: project.id,
+      name: project.name,
+      // 上游把缺席的 description 显式归一成 null(出参声明里它是 nullable 的)。
+      description: project.description ?? null,
+      createdAt: project.createdAt,
+      services: nodes(project.services),
+      environments: nodes(project.environments)
+    })
+  };
+}
+async function getServiceInstance(input, ctx) {
+  const data = await graphql(ctx, `query serviceInstance($serviceId: String!, $environmentId: String!) {
+      serviceInstance(serviceId: $serviceId, environmentId: $environmentId) {
+        id
+        serviceName
+        startCommand
+        buildCommand
+        rootDirectory
+        healthcheckPath
+        region
+        numReplicas
+        restartPolicyType
+        restartPolicyMaxRetries
+        latestDeployment { ${DEPLOYMENT_FIELDS} }
+      }
+    }`, {
+    serviceId: required(input.serviceId, "serviceId"),
+    environmentId: required(input.environmentId, "environmentId")
+  });
+  return {
+    serviceInstance: requireValue(record(data.serviceInstance), "Railway \u6CA1\u6709\u8FD4\u56DE serviceInstance")
+  };
+}
+async function listDeployments(input, ctx) {
+  const data = await graphql(ctx, `query deployments($input: DeploymentListInput!, $first: Int) {
+      deployments(input: $input, first: $first) {
+        edges { node { ${DEPLOYMENT_FIELDS} } }
+      }
+    }`, {
+    input: {
+      projectId: required(input.projectId, "projectId"),
+      serviceId: required(input.serviceId, "serviceId"),
+      environmentId: required(input.environmentId, "environmentId")
+    },
+    first: input.limit ?? DEFAULT_DEPLOYMENT_LIMIT
+  });
+  return { deployments: nodes(data.deployments) };
+}
+async function getDeployment(input, ctx) {
+  const data = await graphql(ctx, `query deployment($id: String!) {
+      deployment(id: $id) {
+        ${DEPLOYMENT_FIELDS} meta canRedeploy canRollback
+      }
+    }`, { id: required(input.deploymentId, "deploymentId") });
+  return { deployment: requireValue(record(data.deployment), "Railway \u6CA1\u6709\u8FD4\u56DE deployment") };
+}
+async function getDeploymentLogs(input, ctx) {
+  const data = await graphql(ctx, `query deploymentLogs(
+      $deploymentId: String!
+      $limit: Int
+      $filter: String
+      $startDate: DateTime
+      $endDate: DateTime
+    ) {
+      deploymentLogs(
+        deploymentId: $deploymentId
+        limit: $limit
+        filter: $filter
+        startDate: $startDate
+        endDate: $endDate
+      ) {
+        timestamp message severity
+      }
+    }`, compact({
+    deploymentId: required(input.deploymentId, "deploymentId"),
+    limit: input.limit ?? DEFAULT_LOG_LIMIT,
+    filter: text(input.filter),
+    startDate: text(input.startDate),
+    endDate: text(input.endDate)
+  }));
+  return { logs: Array.isArray(data.deploymentLogs) ? data.deploymentLogs : [] };
+}
+async function deployService(input, ctx) {
+  const data = await graphql(
+    ctx,
+    `mutation serviceInstanceDeployV2($serviceId: String!, $environmentId: String!, $commitSha: String) {
+      serviceInstanceDeployV2(serviceId: $serviceId, environmentId: $environmentId, commitSha: $commitSha)
+    }`,
+    compact({
+      serviceId: required(input.serviceId, "serviceId"),
+      environmentId: required(input.environmentId, "environmentId"),
+      commitSha: text(input.commitSha)
+    })
+  );
+  return {
+    deploymentId: requireValue(data.serviceInstanceDeployV2, "Railway \u6CA1\u6709\u8FD4\u56DE deployment id")
+  };
+}
+async function upsertVariable(input, ctx) {
+  const data = await graphql(ctx, `mutation variableUpsert($input: VariableUpsertInput!) {
+      variableUpsert(input: $input)
+    }`, {
+    input: compact({
+      projectId: required(input.projectId, "projectId"),
+      environmentId: required(input.environmentId, "environmentId"),
+      serviceId: text(input.serviceId),
+      name: required(input.name, "name"),
+      // 变量值不透明:空串与前后空白都要原样写进去。
+      value: input.value,
+      skipDeploys: input.skipDeploys
+    })
+  });
+  return { updated: requireValue(data.variableUpsert, "Railway \u6CA1\u6709\u8FD4\u56DE\u53D8\u91CF\u66F4\u65B0\u7ED3\u679C") };
+}
+async function rollbackDeployment(input, ctx) {
+  const data = await graphql(ctx, `mutation deploymentRollback($id: String!) {
+      deploymentRollback(id: $id) { ${DEPLOYMENT_FIELDS} }
+    }`, { id: required(input.deploymentId, "deploymentId") });
+  return { deployment: requireValue(record(data.deploymentRollback), "Railway \u6CA1\u6709\u8FD4\u56DE\u56DE\u6EDA\u540E\u7684 deployment") };
+}
+
+// ../plugins/src/railway/schema.ts
+var listProjectsInput = external_exports.strictObject({}).describe("Input for listing Railway projects.");
+var listProjectsOutput = external_exports.strictObject({
+  projects: external_exports.array(external_exports.strictObject({
+    id: external_exports.string().min(1).describe("Railway project ID."),
+    name: external_exports.string().min(1).describe("Project name."),
+    description: external_exports.string().describe("Project description.").nullable().optional(),
+    createdAt: external_exports.iso.datetime({ offset: true }).describe("When the project was created.").optional(),
+    updatedAt: external_exports.iso.datetime({ offset: true }).describe("When the project was last updated.").optional()
+  }).describe("A Railway project.")).describe("Railway projects.").optional()
+}).describe("Railway projects available to the token.");
+var getProjectInput = external_exports.strictObject({
+  projectId: external_exports.string().min(1).describe("Railway project ID.").optional()
+}).describe("Input for retrieving a Railway project.");
+var getProjectOutput = external_exports.strictObject({
+  project: external_exports.strictObject({
+    id: external_exports.string().min(1).describe("Railway project ID."),
+    name: external_exports.string().min(1).describe("Project name."),
+    description: external_exports.string().describe("Project description.").nullable().optional(),
+    createdAt: external_exports.iso.datetime({ offset: true }).describe("When the project was created.").optional(),
+    services: external_exports.array(external_exports.strictObject({
+      id: external_exports.string().min(1).describe("Railway service ID."),
+      name: external_exports.string().min(1).describe("Service name."),
+      icon: external_exports.string().describe("Service icon URL or identifier.").nullable().optional()
+    }).describe("A Railway service.")).describe("Services in the project."),
+    environments: external_exports.array(external_exports.strictObject({
+      id: external_exports.string().min(1).describe("Railway environment ID.").optional(),
+      name: external_exports.string().min(1).describe("Environment name.").optional()
+    }).describe("A Railway environment.")).describe("Environments in the project.")
+  }).describe("Railway project details.").optional()
+}).describe("A Railway project with related resources.");
+var getServiceInstanceInput = external_exports.strictObject({
+  serviceId: external_exports.string().min(1).describe("Railway service ID.").optional(),
+  environmentId: external_exports.string().min(1).describe("Railway environment ID.").optional()
+}).describe("Input for retrieving a Railway service instance.");
+var getServiceInstanceOutput = external_exports.strictObject({
+  serviceInstance: external_exports.looseObject({
+    id: external_exports.string().min(1).describe("Railway service instance ID."),
+    serviceName: external_exports.string().min(1).describe("Service name."),
+    startCommand: external_exports.string().describe("Configured start command.").nullable().optional(),
+    buildCommand: external_exports.string().describe("Configured build command.").nullable().optional(),
+    rootDirectory: external_exports.string().describe("Configured repository root directory.").nullable().optional(),
+    healthcheckPath: external_exports.string().describe("Configured health check path.").nullable().optional(),
+    region: external_exports.string().describe("Deployment region.").nullable().optional(),
+    numReplicas: external_exports.int().describe("Configured replica count.").nullable().optional(),
+    restartPolicyType: external_exports.string().describe("Restart policy type.").nullable().optional(),
+    restartPolicyMaxRetries: external_exports.int().describe("Maximum restart attempts.").nullable().optional(),
+    latestDeployment: external_exports.strictObject({
+      id: external_exports.string().min(1).describe("Railway deployment ID."),
+      status: external_exports.string().min(1).describe("Current Railway deployment status."),
+      createdAt: external_exports.iso.datetime({ offset: true }).describe("When the deployment was created.").optional(),
+      url: external_exports.string().describe("Deployment URL.").nullable().optional(),
+      staticUrl: external_exports.string().describe("Static deployment URL.").nullable().optional()
+    }).describe("A Railway deployment.").nullable().optional()
+  }).describe("A Railway service instance.").optional()
+}).describe("Railway service instance configuration.");
+var listDeploymentsInput = external_exports.strictObject({
+  projectId: external_exports.string().min(1).describe("Railway project ID."),
+  serviceId: external_exports.string().min(1).describe("Railway service ID."),
+  environmentId: external_exports.string().min(1).describe("Railway environment ID."),
+  limit: external_exports.int().min(1).max(100).default(20).describe("Maximum number of deployments to return.").optional()
+}).describe("Filters for Railway deployments.");
+var listDeploymentsOutput = external_exports.strictObject({
+  deployments: external_exports.array(external_exports.strictObject({
+    id: external_exports.string().min(1).describe("Railway deployment ID."),
+    status: external_exports.string().min(1).describe("Current Railway deployment status."),
+    createdAt: external_exports.iso.datetime({ offset: true }).describe("When the deployment was created.").optional(),
+    url: external_exports.string().describe("Deployment URL.").nullable().optional(),
+    staticUrl: external_exports.string().describe("Static deployment URL.").nullable().optional()
+  }).describe("A Railway deployment.")).describe("Railway deployments ordered by the provider.").optional()
+}).describe("Recent Railway deployments.");
+var getDeploymentInput = external_exports.strictObject({
+  deploymentId: external_exports.string().min(1).describe("Railway deployment ID.").optional()
+}).describe("Input for retrieving a Railway deployment.");
+var getDeploymentOutput = external_exports.strictObject({
+  deployment: external_exports.strictObject({
+    id: external_exports.string().min(1).describe("Railway deployment ID."),
+    status: external_exports.string().min(1).describe("Current Railway deployment status."),
+    createdAt: external_exports.iso.datetime({ offset: true }).describe("When the deployment was created.").optional(),
+    url: external_exports.string().describe("Deployment URL.").nullable().optional(),
+    staticUrl: external_exports.string().describe("Static deployment URL.").nullable().optional(),
+    canRedeploy: external_exports.boolean().describe("Whether Railway allows this deployment to be redeployed.").optional(),
+    canRollback: external_exports.boolean().describe("Whether Railway allows a rollback to this deployment.").optional(),
+    meta: external_exports.looseObject({}).describe("Provider-defined deployment metadata.").nullable().optional()
+  }).describe("Detailed Railway deployment information.").optional()
+}).describe("A Railway deployment.");
+var getDeploymentLogsInput = external_exports.strictObject({
+  deploymentId: external_exports.string().min(1).describe("Railway deployment ID."),
+  limit: external_exports.int().min(1).max(5e3).default(500).describe("Maximum number of log entries to return.").optional(),
+  filter: external_exports.string().min(1).describe("Railway log filter expression.").optional(),
+  startDate: external_exports.iso.datetime({ offset: true }).describe("Start of the log time range.").optional(),
+  endDate: external_exports.iso.datetime({ offset: true }).describe("End of the log time range.").optional()
+}).describe("Filters for Railway deployment logs.");
+var getDeploymentLogsOutput = external_exports.strictObject({
+  logs: external_exports.array(external_exports.strictObject({
+    timestamp: external_exports.string().min(1).describe("Provider timestamp for the log entry."),
+    message: external_exports.string().describe("Log message."),
+    severity: external_exports.string().describe("Log severity.").nullable().optional()
+  }).describe("A Railway runtime log entry.")).describe("Railway runtime log entries.").optional()
+}).describe("Runtime log entries for a Railway deployment.");
+var deployServiceInput = external_exports.strictObject({
+  serviceId: external_exports.string().min(1).describe("Railway service ID."),
+  environmentId: external_exports.string().min(1).describe("Railway environment ID."),
+  commitSha: external_exports.string().min(1).describe("Commit SHA from the repository connected to the Railway service.").optional()
+}).describe("Input for deploying a Railway service.");
+var deployServiceOutput = external_exports.strictObject({
+  deploymentId: external_exports.string().min(1).describe("Railway deployment ID.").optional()
+}).describe("The triggered Railway deployment.");
+var upsertVariableInput = external_exports.strictObject({
+  projectId: external_exports.string().min(1).describe("Railway project ID."),
+  serviceId: external_exports.string().min(1).describe("Railway service ID.").optional(),
+  environmentId: external_exports.string().min(1).describe("Railway environment ID."),
+  name: external_exports.string().min(1).max(255).regex(new RegExp("^[A-Za-z_][A-Za-z0-9_]*$")).describe("Variable name."),
+  value: external_exports.string().describe("Variable value. This may contain a Railway variable reference."),
+  skipDeploys: external_exports.boolean().describe("Do not automatically redeploy after updating the variable.").optional()
+}).describe("Input for creating or updating a Railway variable.");
+var upsertVariableOutput = external_exports.strictObject({
+  updated: external_exports.boolean().describe("Whether Railway accepted the variable update.").optional()
+}).describe("Result of updating a Railway variable.");
+var rollbackDeploymentInput = external_exports.strictObject({
+  deploymentId: external_exports.string().min(1).describe("Rollback-capable Railway deployment ID.").optional()
+}).describe("Input for rolling back a Railway deployment.");
+var rollbackDeploymentOutput = external_exports.strictObject({
+  deployment: external_exports.strictObject({
+    id: external_exports.string().min(1).describe("Railway deployment ID."),
+    status: external_exports.string().min(1).describe("Current Railway deployment status."),
+    createdAt: external_exports.iso.datetime({ offset: true }).describe("When the deployment was created.").optional(),
+    url: external_exports.string().describe("Deployment URL.").nullable().optional(),
+    staticUrl: external_exports.string().describe("Static deployment URL.").nullable().optional()
+  }).describe("A Railway deployment.").optional()
+}).describe("The Railway deployment created by the rollback.");
+var railwayActions = {
+  list_projects: {
+    description: "List Railway projects available to the configured account or workspace token.",
+    effect: "read",
+    inputSchema: listProjectsInput,
+    outputSchema: external_exports.toJSONSchema(listProjectsOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_project: {
+    description: "Get a Railway project together with its services and environments.",
+    effect: "read",
+    inputSchema: getProjectInput,
+    outputSchema: external_exports.toJSONSchema(getProjectOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_service_instance: {
+    description: "Get Railway service configuration and its latest deployment in one environment.",
+    effect: "read",
+    inputSchema: getServiceInstanceInput,
+    outputSchema: external_exports.toJSONSchema(getServiceInstanceOutput, { io: "output", unrepresentable: "any" })
+  },
+  list_deployments: {
+    description: "List recent Railway deployments for a service and environment.",
+    effect: "read",
+    inputSchema: listDeploymentsInput,
+    outputSchema: external_exports.toJSONSchema(listDeploymentsOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_deployment: {
+    description: "Get one Railway deployment and its redeploy and rollback capabilities.",
+    effect: "read",
+    inputSchema: getDeploymentInput,
+    outputSchema: external_exports.toJSONSchema(getDeploymentOutput, { io: "output", unrepresentable: "any" })
+  },
+  get_deployment_logs: {
+    description: "Read runtime logs for a Railway deployment with optional text and time filters.",
+    effect: "read",
+    inputSchema: getDeploymentLogsInput,
+    outputSchema: external_exports.toJSONSchema(getDeploymentLogsOutput, { io: "output", unrepresentable: "any" })
+  },
+  deploy_service: {
+    description: "Trigger a Railway deployment for a service, optionally at a specific connected-repository commit.",
+    effect: "write",
+    inputSchema: deployServiceInput,
+    outputSchema: external_exports.toJSONSchema(deployServiceOutput, { io: "output", unrepresentable: "any" })
+  },
+  upsert_variable: {
+    description: "Create or update one Railway variable for an environment or service.",
+    effect: "write",
+    inputSchema: upsertVariableInput,
+    outputSchema: external_exports.toJSONSchema(upsertVariableOutput, { io: "output", unrepresentable: "any" })
+  },
+  rollback_deployment: {
+    description: "Roll a Railway service back to a deployment that Railway marks as rollback-capable.",
+    effect: "write",
+    inputSchema: rollbackDeploymentInput,
+    outputSchema: external_exports.toJSONSchema(rollbackDeploymentOutput, { io: "output", unrepresentable: "any" })
+  }
+};
+
+// ../plugins/src/railway/index.ts
+function createRailwayPlugin() {
+  return createProviderPlugin({
+    description: "Railway",
+    credentialProbe: "list_projects",
+    actions: railwayActions,
+    handlers: {
+      list_projects: listProjects,
+      get_project: getProject,
+      get_service_instance: getServiceInstance,
+      list_deployments: listDeployments,
+      get_deployment: getDeployment,
+      get_deployment_logs: getDeploymentLogs,
+      deploy_service: deployService,
+      upsert_variable: upsertVariable,
+      rollback_deployment: rollbackDeployment
+    }
+  });
+}
+var railway_default = createRailwayPlugin();
+export {
+  createRailwayPlugin,
+  railway_default as default
+};