@getmonoceros/workbench 1.25.0 → 1.26.0

package/bundled-components/services/mailpit/component.yml

@@ -0,0 +1,17 @@
+id: mailpit
+category: service
+displayName: Mailpit
+description: 'SMTP catcher for local dev — apps send mail to it and nothing leaves the machine. SMTP on `mailpit:1025`; web UI + API on 8025 (reach via `monoceros tunnel <name> mailpit:8025`).'
+service:
+  image: axllent/mailpit:latest
+  defaultPort: 1025
+  healthcheck:
+    # Mailpit ships its own readiness probe in the image — no curl/wget needed.
+    test: [CMD, /mailpit, readyz]
+    interval: 15s
+    timeout: 5s
+    retries: 5
+  connectionEnv:
+    URL: smtp://${host}:${port}
+    HOST: ${host}
+    PORT: ${port}

package/bundled-components/services/mongodb/component.yml

@@ -0,0 +1,36 @@
+id: mongodb
+category: service
+displayName: MongoDB
+description: 'MongoDB with seeded dev credentials and a readiness healthcheck. Reachable in-container as host `mongodb`.'
+service:
+  image: mongo:8
+  defaultPort: 27017
+  dataMount: /data/db
+  healthcheck:
+    test: [CMD, mongosh, --quiet, --eval, 'db.adminCommand({ ping: 1 }).ok']
+    interval: 10s
+    timeout: 5s
+    retries: 5
+  vscodeExtensions: [mongodb.mongodb-vscode]
+  client:
+    npm: [mongosh]
+  connectionEnv:
+    URL: mongodb://${MONGO_INITDB_ROOT_USERNAME}:${MONGO_INITDB_ROOT_PASSWORD}@${host}:${port}/${MONGO_INITDB_DATABASE}?authSource=admin
+    HOST: ${host}
+    PORT: ${port}
+    USER: ${MONGO_INITDB_ROOT_USERNAME}
+    PASSWORD: ${MONGO_INITDB_ROOT_PASSWORD}
+    DB: ${MONGO_INITDB_DATABASE}
+options:
+  MONGO_INITDB_ROOT_USERNAME:
+    type: string
+    default: monoceros
+    surface: env
+  MONGO_INITDB_ROOT_PASSWORD:
+    type: string
+    default: monoceros
+    surface: env
+  MONGO_INITDB_DATABASE:
+    type: string
+    default: monoceros
+    surface: env

package/bundled-components/services/mysql/component.yml

@@ -22,6 +22,8 @@ service:
     timeout: 5s
     retries: 5
   vscodeExtensions: [cweijan.vscode-database-client2]
+  client:
+    apt: [default-mysql-client]
   connectionEnv:
     URL: mysql://root:${MYSQL_ROOT_PASSWORD}@${host}:${port}/${MYSQL_DATABASE}
     HOST: ${host}

package/bundled-components/services/pgvector/component.yml

@@ -0,0 +1,36 @@
+id: pgvector
+category: service
+displayName: pgvector (PostgreSQL + vectors)
+description: 'PostgreSQL with the pgvector extension for embeddings / vector search — a drop-in Postgres. Reachable in-container as host `pgvector`. Enable the extension once with `CREATE EXTENSION vector;` (or in your migration).'
+service:
+  image: pgvector/pgvector:pg18
+  defaultPort: 5432
+  dataMount: /var/lib/postgresql
+  healthcheck:
+    test: [CMD, pg_isready, -U, '${POSTGRES_USER}', -d, '${POSTGRES_DB}']
+    interval: 10s
+    timeout: 5s
+    retries: 5
+  vscodeExtensions: [cweijan.vscode-database-client2]
+  client:
+    apt: [postgresql-client]
+  connectionEnv:
+    URL: postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@${host}:${port}/${POSTGRES_DB}
+    HOST: ${host}
+    PORT: ${port}
+    USER: ${POSTGRES_USER}
+    PASSWORD: ${POSTGRES_PASSWORD}
+    DB: ${POSTGRES_DB}
+options:
+  POSTGRES_USER:
+    type: string
+    default: monoceros
+    surface: env
+  POSTGRES_PASSWORD:
+    type: string
+    default: monoceros
+    surface: env
+  POSTGRES_DB:
+    type: string
+    default: monoceros
+    surface: env

package/bundled-components/services/postgres/component.yml

@@ -12,6 +12,8 @@ service:
     timeout: 5s
     retries: 5
   vscodeExtensions: [cweijan.vscode-database-client2]
+  client:
+    apt: [postgresql-client]
   connectionEnv:
     URL: postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@${host}:${port}/${POSTGRES_DB}
     HOST: ${host}

package/bundled-components/services/redis/component.yml

@@ -12,6 +12,8 @@ service:
     timeout: 5s
     retries: 5
   vscodeExtensions: [cweijan.vscode-database-client2]
+  client:
+    apt: [redis-tools]
   connectionEnv:
     URL: redis://${host}:${port}
     HOST: ${host}

package/bundled-components/services/rustfs/component.yml

@@ -0,0 +1,28 @@
+id: rustfs
+category: service
+displayName: RustFS
+description: 'S3-compatible object storage (MinIO-compatible API). S3 API on `rustfs:9000`; web console on 9001 (enable with `RUSTFS_CONSOLE_ENABLE=true`, reach via `monoceros tunnel <name> rustfs:9001`).'
+service:
+  image: rustfs/rustfs:latest
+  defaultPort: 9000
+  dataMount: /data
+  healthcheck:
+    test: [CMD, curl, -f, 'http://localhost:9000/minio/health/live']
+    interval: 10s
+    timeout: 5s
+    retries: 5
+  connectionEnv:
+    URL: http://${host}:${port}
+    HOST: ${host}
+    PORT: ${port}
+    ACCESS_KEY: ${RUSTFS_ACCESS_KEY}
+    SECRET_KEY: ${RUSTFS_SECRET_KEY}
+options:
+  RUSTFS_ACCESS_KEY:
+    type: string
+    default: rustfsadmin
+    surface: env
+  RUSTFS_SECRET_KEY:
+    type: string
+    default: rustfsadmin
+    surface: env

package/dist/bin.js

@@ -740,6 +740,19 @@ var init_descriptor = __esm({
        *   HOST: ${host}
        */
       connectionEnv: z2.record(z2.string(), z2.string()).optional(),
+      /**
+       * CLI client tool(s) for this service, installed into the WORKSPACE
+       * container at apply so the dev/agent can use them (the service runs in its
+       * own container; the workspace has no client otherwise). `apt` packages are
+       * merged into the workspace's apt-packages feature (build-time, cached);
+       * `npm` packages are installed globally in post-create (guarded, so it's a
+       * no-op once present). E.g. postgres → apt `postgresql-client` (`psql`),
+       * mongodb → npm `mongosh`. See ADR 0020.
+       */
+      client: z2.object({
+        apt: z2.array(z2.string()).optional(),
+        npm: z2.array(z2.string()).optional()
+      }).optional(),
       vscodeExtensions: z2.array(z2.string()).optional()
     });
     PersistentHomeFileSchema = z2.object({
@@ -2208,7 +2221,7 @@ function curatedServiceEnvDefaults(name) {
 function serviceConnectionEnv(services) {
   const env = {};
   for (const svc of services) {
-    const conn = svc.connectionEnv;
+    const conn = svc.connectionEnv ?? SERVICE_CATALOG[svc.name]?.connectionEnv;
     if (!conn || Object.keys(conn).length === 0) continue;
     const prefix = svc.name.replace(/[^A-Za-z0-9]+/g, "_").toUpperCase();
     const host = svc.name;
@@ -2224,6 +2237,24 @@ function serviceConnectionEnv(services) {
   }
   return env;
 }
+function serviceClientAptPackages(services) {
+  const pkgs = /* @__PURE__ */ new Set();
+  for (const svc of services) {
+    for (const pkg of SERVICE_CATALOG[svc.name]?.client?.apt ?? []) {
+      pkgs.add(pkg);
+    }
+  }
+  return [...pkgs].sort();
+}
+function serviceClientNpmPackages(services) {
+  const pkgs = /* @__PURE__ */ new Set();
+  for (const svc of services) {
+    for (const pkg of SERVICE_CATALOG[svc.name]?.client?.npm ?? []) {
+      pkgs.add(pkg);
+    }
+  }
+  return [...pkgs].sort();
+}
 function deriveServiceName(image) {
   const lastSegment = image.split("/").pop() ?? image;
   const noTag = lastSegment.split("@")[0].split(":")[0];
@@ -2283,7 +2314,8 @@ var init_catalog = __esm({
           ...svc.dataMount ? { dataMount: svc.dataMount } : {},
           defaultPort: svc.defaultPort,
           ...svc.vscodeExtensions ? { vscodeExtensions: svc.vscodeExtensions } : {},
-          ...svc.connectionEnv ? { connectionEnv: svc.connectionEnv } : {}
+          ...svc.connectionEnv ? { connectionEnv: svc.connectionEnv } : {},
+          ...svc.client ? { client: svc.client } : {}
         };
         return [key, entry2];
       })
@@ -2800,10 +2832,16 @@ function resolveFeatures(opts) {
       persistentHomeFiles: []
     });
   }
-  if (opts.aptPackages && opts.aptPackages.length > 0) {
+  const aptPackages = [
+    .../* @__PURE__ */ new Set([
+      ...opts.aptPackages ?? [],
+      ...serviceClientAptPackages(opts.services)
+    ])
+  ].sort();
+  if (aptPackages.length > 0) {
     resolved.push({
       devcontainerKey: "ghcr.io/devcontainers-contrib/features/apt-packages:1",
-      options: { packages: opts.aptPackages.join(",") },
+      options: { packages: aptPackages.join(",") },
       persistentHomePaths: [],
       persistentHomeFiles: []
     });
@@ -3197,6 +3235,18 @@ function buildPostCreateScript(opts) {
     "  pnpm install",
     "fi"
   ];
+  const clientNpm = serviceClientNpmPackages(opts.services);
+  if (clientNpm.length > 0) {
+    lines.push(
+      "",
+      "# CLI clients for the curated services (global npm installs)."
+    );
+    for (const pkg of clientNpm) {
+      lines.push(
+        `command -v ${pkg} >/dev/null 2>&1 || npm install -g --no-audit --no-fund ${pkg}`
+      );
+    }
+  }
   if (opts.installUrls && opts.installUrls.length > 0) {
     lines.push(
       "",
@@ -7260,7 +7310,7 @@ var CLI_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    CLI_VERSION = true ? "1.25.0" : "dev";
+    CLI_VERSION = true ? "1.26.0" : "dev";
   }
 });