@better-openclaw/core 1.0.19 → 1.0.21

package/src/deployers/types.ts

@@ -7,7 +7,7 @@
  * registering it in `deployers/index.ts`.
  *
  * Architecture:
- *   Web UI / CLI  -->  API relay (/v1/deploy)  -->  PaaS instance (Dokploy/Coolify)
+ *   Web UI / CLI  -->  API relay (/api/v1/deploy)  -->  PaaS instance (Dokploy/Coolify)
  *
  * The API server acts as a relay to avoid CORS issues when deploying from the
  * browser. The CLI calls the deployer directly (no relay needed).
@@ -33,6 +33,8 @@ export interface DeployInput {
 	envContent: string;
 	/** Optional description */
 	description?: string;
+	/** Optional server ID to deploy to (for PaaS platforms managing multiple servers) */
+	serverId?: string;
 }
 
 /** Step-level status for deploy progress. */
@@ -57,6 +59,16 @@ export interface DeployResult {
 	error?: string;
 }
 
+/** Server available on a PaaS platform. */
+export interface PaasServer {
+	/** Server ID (used as identifier when deploying) */
+	id: string;
+	/** Human-readable server name */
+	name: string;
+	/** Server IP address or hostname */
+	ip?: string;
+}
+
 /** Interface that all PaaS deployers implement. */
 export interface PaasDeployer {
 	/** Human-readable name */
@@ -67,4 +79,176 @@ export interface PaasDeployer {
 	testConnection(target: DeployTarget): Promise<{ ok: boolean; error?: string }>;
 	/** Deploy a compose stack */
 	deploy(input: DeployInput): Promise<DeployResult>;
+	/** List available servers on the PaaS instance (optional — not all providers manage multiple servers) */
+	listServers?(target: DeployTarget): Promise<PaasServer[]>;
+}
+
+export interface ProviderCapabilities {
+	compose: boolean;
+	dockerImage: boolean;
+	volumes: boolean;
+	domains: boolean;
+	secrets: boolean;
+}
+
+export interface DeploymentResult {
+	success: boolean;
+	url?: string;
+	message?: string;
+}
+
+export interface DeploymentProvider {
+	id: string;
+	name: string;
+
+	capabilities: ProviderCapabilities;
+
+	deploy(config: NormalizedApp): Promise<DeploymentResult>;
+
+	createSecret?(key: string, value: string): Promise<void>;
+
+	createDomain?(service: string, domain: string): Promise<void>;
+}
+
+export interface NormalizedApp {
+	name: string;
+	services: NormalizedService[];
+	env: Record<string, string>;
+}
+
+export interface NormalizedService {
+	name: string;
+	image?: string;
+	build?: string;
+	ports?: number[];
+	volumes?: string[];
+	env?: Record<string, string>;
+}
+
+export interface DokployEnvironment {
+	environmentId: string;
+	name: string;
+	description: string;
+	createdAt: string;
+	env: string;
+	projectId: string;
+	isDefault: boolean;
+	applications: DokployApplication[];
+	mariadb: any[];
+	mongo: any[];
+	mysql: any[];
+	postgres: any[];
+	redis: any[];
+	compose: any[];
+	project: Project;
+}
+
+export interface DokployApplication {
+	applicationId: string;
+	name: string;
+	appName: string;
+	description: string;
+	env: string;
+	previewEnv: any;
+	watchPaths: any[];
+	previewBuildArgs: any;
+	previewBuildSecrets: any;
+	previewLabels: any;
+	previewWildcard: any;
+	previewPort: number;
+	previewHttps: boolean;
+	previewPath: string;
+	previewCertificateType: string;
+	previewCustomCertResolver: any;
+	previewLimit: number;
+	isPreviewDeploymentsActive: boolean;
+	previewRequireCollaboratorPermissions: boolean;
+	rollbackActive: boolean;
+	buildArgs: string;
+	buildSecrets: string;
+	memoryReservation: any;
+	memoryLimit: any;
+	cpuReservation: any;
+	cpuLimit: any;
+	title: any;
+	enabled: any;
+	subtitle: any;
+	command: any;
+	args: any;
+	refreshToken: string;
+	sourceType: string;
+	cleanCache: boolean;
+	repository: string;
+	owner: string;
+	branch: string;
+	buildPath: string;
+	triggerType: string;
+	autoDeploy: boolean;
+	gitlabProjectId: any;
+	gitlabRepository: any;
+	gitlabOwner: any;
+	gitlabBranch: any;
+	gitlabBuildPath: string;
+	gitlabPathNamespace: any;
+	giteaRepository: any;
+	giteaOwner: any;
+	giteaBranch: any;
+	giteaBuildPath: string;
+	bitbucketRepository: any;
+	bitbucketRepositorySlug: any;
+	bitbucketOwner: any;
+	bitbucketBranch: any;
+	bitbucketBuildPath: string;
+	username: any;
+	password: any;
+	dockerImage: any;
+	registryUrl: any;
+	customGitUrl: any;
+	customGitBranch: any;
+	customGitBuildPath: any;
+	customGitSSHKeyId: any;
+	enableSubmodules: boolean;
+	dockerfile: any;
+	dockerContextPath: any;
+	dockerBuildStage: any;
+	dropBuildPath: any;
+	healthCheckSwarm: any;
+	restartPolicySwarm: any;
+	placementSwarm: any;
+	updateConfigSwarm: any;
+	rollbackConfigSwarm: any;
+	modeSwarm: any;
+	labelsSwarm: any;
+	networkSwarm: any;
+	stopGracePeriodSwarm: any;
+	endpointSpecSwarm: any;
+	ulimitsSwarm: any;
+	replicas: number;
+	applicationStatus: string;
+	buildType: string;
+	railpackVersion: string;
+	herokuVersion: any;
+	publishDirectory: any;
+	isStaticSpa: any;
+	createEnvFile: boolean;
+	createdAt: string;
+	registryId: any;
+	rollbackRegistryId: any;
+	environmentId: string;
+	githubId: string;
+	gitlabId: any;
+	giteaId: any;
+	bitbucketId: any;
+	serverId: string;
+	buildServerId: any;
+	buildRegistryId: any;
+}
+
+export interface Project {
+	projectId: string;
+	name: string;
+	description: string;
+	createdAt: string;
+	organizationId: string;
+	env: string;
 }

package/src/index.ts

@@ -15,6 +15,7 @@ export type {
 	DeployStep as PaasDeployStep,
 	DeployTarget as PaasDeployTarget,
 	PaasDeployer,
+	PaasServer,
 } from "./deployers/index.js";
 export {
 	CoolifyDeployer,
@@ -29,10 +30,16 @@ export { generate, generateServicesDoc } from "./generate.js";
 export { generateCaddyfile } from "./generators/caddy.js";
 export type { EnvVarGroup } from "./generators/env.js";
 export { generateEnvFiles, getStructuredEnvVars } from "./generators/env.js";
-export { generateGrafanaConfig, generateGrafanaDashboard } from "./generators/grafana.js";
+export {
+	generateGrafanaConfig,
+	generateGrafanaDashboard,
+} from "./generators/grafana.js";
 export { generateHealthCheck } from "./generators/health-check.js";
 export { generateN8nWorkflows } from "./generators/n8n-workflows.js";
-export { generatePostgresInit, getDbRequirements } from "./generators/postgres-init.js";
+export {
+	generatePostgresInit,
+	getDbRequirements,
+} from "./generators/postgres-init.js";
 export { generatePrometheusConfig } from "./generators/prometheus.js";
 export { generateReadme } from "./generators/readme.js";
 export { generateScripts } from "./generators/scripts.js";
@@ -44,12 +51,20 @@ export type {
 } from "./generators/stack-manifest.js";
 export { generateStackManifest } from "./generators/stack-manifest.js";
 // ─── Config Migrations ──────────────────────────────────────────────────────
-export { CURRENT_CONFIG_VERSION, migrateConfig, needsMigration } from "./migrations.js";
+export {
+	CURRENT_CONFIG_VERSION,
+	migrateConfig,
+	needsMigration,
+} from "./migrations.js";
 // ─── Port Scanner ───────────────────────────────────────────────────────────
 export type { PortConflict } from "./port-scanner.js";
 export { formatPortConflicts, scanPortConflicts } from "./port-scanner.js";
 // ─── Presets ────────────────────────────────────────────────────────────────
-export { getAllPresets, getPresetById, presetRegistry } from "./presets/registry.js";
+export {
+	getAllPresets,
+	getPresetById,
+	presetRegistry,
+} from "./presets/registry.js";
 export { resolve } from "./resolver.js";
 export {
 	AddedDependencySchema,

package/src/services/definitions/usesend.ts

@@ -36,28 +36,28 @@ export const usesendDefinition: ServiceDefinition = {
 		},
 		{
 			key: "AWS_ACCESS_KEY",
-			defaultValue: "",
+			defaultValue: "your-aws-access-key",
 			secret: true,
 			description: "AWS access key for SES/SNS",
 			required: true,
 		},
 		{
 			key: "AWS_SECRET_KEY",
-			defaultValue: "",
+			defaultValue: "your-aws-secret-key",
 			secret: true,
 			description: "AWS secret key for SES/SNS",
 			required: true,
 		},
 		{
 			key: "GITHUB_ID",
-			defaultValue: "",
+			defaultValue: "your-github-oauth-client-id",
 			secret: false,
 			description: "GitHub OAuth app client ID",
 			required: true,
 		},
 		{
 			key: "GITHUB_SECRET",
-			defaultValue: "",
+			defaultValue: "your-github-oauth-client-secret",
 			secret: true,
 			description: "GitHub OAuth app client secret",
 			required: true,

package/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["./src/bare-metal-partition.ts","./src/composer.ts","./src/errors.ts","./src/generate.ts","./src/index.ts","./src/migrations.ts","./src/port-scanner.ts","./src/resolver.ts","./src/schema.ts","./src/types.ts","./src/validator.ts","./src/version-manager.ts","./src/deployers/coolify.ts","./src/deployers/dokploy.ts","./src/deployers/index.ts","./src/deployers/strip-host-ports.ts","./src/deployers/types.ts","./src/generators/bare-metal-install.ts","./src/generators/caddy.ts","./src/generators/cloud-init.ts","./src/generators/env.ts","./src/generators/get-shit-done.ts","./src/generators/grafana.ts","./src/generators/health-check.ts","./src/generators/n8n-workflows.ts","./src/generators/native-services.ts","./src/generators/openclaw-install-script.ts","./src/generators/openclaw-json.ts","./src/generators/postgres-init.ts","./src/generators/prometheus.ts","./src/generators/readme.ts","./src/generators/scripts.ts","./src/generators/skills.ts","./src/generators/stack-manifest.ts","./src/generators/traefik.ts","./src/presets/registry.ts","./src/services/registry.ts","./src/services/definitions/anything-llm.ts","./src/services/definitions/appflowy.ts","./src/services/definitions/authentik.ts","./src/services/definitions/beszel.ts","./src/services/definitions/browserless.ts","./src/services/definitions/caddy.ts","./src/services/definitions/cal-com.ts","./src/services/definitions/chromadb.ts","./src/services/definitions/claude-code.ts","./src/services/definitions/code-server.ts","./src/services/definitions/codex.ts","./src/services/definitions/comfyui.ts","./src/services/definitions/convex-dashboard.ts","./src/services/definitions/convex.ts","./src/services/definitions/coolify.ts","./src/services/definitions/crowdsec.ts","./src/services/definitions/desktop-environment.ts","./src/services/definitions/dify.ts","./src/services/definitions/docsgpt.ts","./src/services/definitions/dokploy.ts","./src/services/definitions/dozzle.ts","./src/services/definitions/ffmpeg.ts","./src/services/definitions/flowise.ts","./src/services/definitions/gemini-cli.ts","./src/services/definitions/ghost.ts","./src/services/definitions/gitea.ts","./src/services/definitions/gotify.ts","./src/services/definitions/grafana.ts","./src/services/definitions/headscale.ts","./src/services/definitions/hexstrike.ts","./src/services/definitions/homeassistant.ts","./src/services/definitions/immich.ts","./src/services/definitions/index.ts","./src/services/definitions/jellyfin.ts","./src/services/definitions/jenkins.ts","./src/services/definitions/kimi.ts","./src/services/definitions/lasuite-meet-agents.ts","./src/services/definitions/lasuite-meet-backend.ts","./src/services/definitions/lasuite-meet-frontend.ts","./src/services/definitions/librechat.ts","./src/services/definitions/lightpanda.ts","./src/services/definitions/litellm.ts","./src/services/definitions/livekit.ts","./src/services/definitions/loki.ts","./src/services/definitions/matomo.ts","./src/services/definitions/matrix-synapse.ts","./src/services/definitions/mattermost.ts","./src/services/definitions/meilisearch.ts","./src/services/definitions/milvus.ts","./src/services/definitions/minio.ts","./src/services/definitions/mission-control.ts","./src/services/definitions/mixpost.ts","./src/services/definitions/motion-canvas.ts","./src/services/definitions/n8n.ts","./src/services/definitions/neo4j.ts","./src/services/definitions/nextcloud.ts","./src/services/definitions/nocodb.ts","./src/services/definitions/ntfy.ts","./src/services/definitions/ollama.ts","./src/services/definitions/open-webui.ts","./src/services/definitions/opencode.ts","./src/services/definitions/openpanel.ts","./src/services/definitions/outline.ts","./src/services/definitions/paperless-ngx.ts","./src/services/definitions/pentagi.ts","./src/services/definitions/pentestagent.ts","./src/services/definitions/playwright-server.ts","./src/services/definitions/portainer.ts","./src/services/definitions/postgresql.ts","./src/services/definitions/postiz.ts","./src/services/definitions/prometheus.ts","./src/services/definitions/qdrant.ts","./src/services/definitions/redis.ts","./src/services/definitions/remotion.ts","./src/services/definitions/rocketchat.ts","./src/services/definitions/scrapling.ts","./src/services/definitions/searxng.ts","./src/services/definitions/signoz.ts","./src/services/definitions/solidityguard.ts","./src/services/definitions/stable-diffusion.ts","./src/services/definitions/steel-browser.ts","./src/services/definitions/stream-gateway.ts","./src/services/definitions/supabase.ts","./src/services/definitions/tailscale.ts","./src/services/definitions/temporal.ts","./src/services/definitions/traefik.ts","./src/services/definitions/umami.ts","./src/services/definitions/uptime-kuma.ts","./src/services/definitions/usesend.ts","./src/services/definitions/valkey.ts","./src/services/definitions/vaultwarden.ts","./src/services/definitions/watchtower.ts","./src/services/definitions/weaviate.ts","./src/services/definitions/whisper.ts","./src/services/definitions/xyops.ts","./src/skills/registry.ts","./src/skills/skill-manifest.ts"],"version":"5.9.3"}