@kosuke-ai/cli 1.0.1-next.5 → 1.0.1-next.6

package/dist/generated/tools/projects/env-vars-add.js

@@ -0,0 +1,50 @@
+import { operation } from '../../commands/projects/env-vars-add.js';
+export const tool = {
+    "name": "projects_env_vars_add",
+    "toolset": "projects",
+    "description": "Add environment variables. The body is a JSON array of { key, value, isSecret? }.",
+    "inputSchema": {
+        "type": "object",
+        "properties": {
+            "projectId": {
+                "type": "string",
+                "description": "Project id."
+            },
+            "body": {
+                "description": "The whole request body.",
+                "minItems": 1,
+                "type": "array",
+                "items": {
+                    "type": "object",
+                    "properties": {
+                        "value": {
+                            "type": "string",
+                            "description": "The environment variable value. Supports {{placeholder}} syntax resolved at sandbox startup. Available placeholders: {{<service_name>.url}} — public HTTPS URL of a service (only for public services). {{<service_name>.url_int}} — internal localhost URL of a service (e.g. http://localhost:3000). "
+                        },
+                        "isSecret": {
+                            "default": false,
+                            "description": "Whether this variable contains sensitive data. Secret values are masked in the UI and encrypted at rest.",
+                            "type": "boolean"
+                        },
+                        "key": {
+                            "type": "string",
+                            "minLength": 1,
+                            "maxLength": 255,
+                            "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
+                        }
+                    },
+                    "required": [
+                        "value",
+                        "key"
+                    ]
+                }
+            }
+        },
+        "required": [
+            "projectId",
+            "body"
+        ],
+        "additionalProperties": false
+    },
+    operation,
+};

package/dist/generated/tools/projects/env-vars-remove.js

@@ -0,0 +1,31 @@
+import { operation } from '../../commands/projects/env-vars-remove.js';
+export const tool = {
+    "name": "projects_env_vars_remove",
+    "toolset": "projects",
+    "description": "Remove environment variables. The body is a JSON array of variable ids.",
+    "inputSchema": {
+        "type": "object",
+        "properties": {
+            "projectId": {
+                "type": "string",
+                "description": "Project id."
+            },
+            "body": {
+                "description": "The whole request body.",
+                "minItems": 1,
+                "type": "array",
+                "items": {
+                    "type": "string",
+                    "format": "uuid",
+                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
+                }
+            }
+        },
+        "required": [
+            "projectId",
+            "body"
+        ],
+        "additionalProperties": false
+    },
+    operation,
+};

package/dist/generated/tools/projects/get.js

@@ -0,0 +1,20 @@
+import { operation } from '../../commands/projects/get.js';
+export const tool = {
+    "name": "projects_get",
+    "toolset": "projects",
+    "description": "Read one project.",
+    "inputSchema": {
+        "type": "object",
+        "properties": {
+            "projectId": {
+                "type": "string",
+                "description": "Project id."
+            }
+        },
+        "required": [
+            "projectId"
+        ],
+        "additionalProperties": false
+    },
+    operation,
+};

package/dist/generated/tools/projects/list.js

@@ -0,0 +1,12 @@
+import { operation } from '../../commands/projects/list.js';
+export const tool = {
+    "name": "projects_list",
+    "toolset": "projects",
+    "description": "List the projects you can reach. With an auth token this spans every workspace you belong to; a browser session sees only its active workspace.",
+    "inputSchema": {
+        "type": "object",
+        "properties": {},
+        "additionalProperties": false
+    },
+    operation,
+};

package/dist/generated/tools/projects/services-add.js

@@ -0,0 +1,111 @@
+import { operation } from '../../commands/projects/services-add.js';
+export const tool = {
+    "name": "projects_services_add",
+    "toolset": "projects",
+    "description": "Add a service. A port already used by another service is rejected by the handler.",
+    "inputSchema": {
+        "type": "object",
+        "properties": {
+            "projectId": {
+                "type": "string",
+                "description": "Project id."
+            },
+            "directory": {
+                "type": "string",
+                "description": "Relative path to the service directory within the repository (e.g. \"api\", \"apps/web\"). Defaults to repository root."
+            },
+            "kind": {
+                "type": "string",
+                "description": "Run mode. \"process\": a plain command supervised directly (apps, workers, Postgres, Redis). \"docker-stack\": a multi-container docker-compose stack (e.g. Supabase) with up/down commands.",
+                "enum": [
+                    "process",
+                    "docker-stack"
+                ]
+            },
+            "endpoints": {
+                "description": "Exposed endpoints. A service has 0..N (0 = background, no port); port/type/frontend/health are per endpoint. List the primary user-facing endpoint FIRST: it answers {{service.url}} and drives the readiness probe.",
+                "default": [],
+                "type": "array",
+                "items": {
+                    "type": "object",
+                    "properties": {
+                        "name": {
+                            "type": "string",
+                            "minLength": 1,
+                            "maxLength": 63,
+                            "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?$",
+                            "description": "Endpoint name, unique within the service (e.g. \"api\", \"studio\"). Lowercase alphanumeric with inner hyphens — non-primary endpoint names become part of the preview host."
+                        },
+                        "port": {
+                            "type": "integer",
+                            "minimum": 1,
+                            "maximum": 65535,
+                            "description": "Port this endpoint listens on."
+                        },
+                        "exposure": {
+                            "default": "internal",
+                            "description": "\"internal\": sandbox-only (no URL). \"public\": browser-reachable URL, not rendered. \"preview\": public URL AND shown in the preview panel.",
+                            "type": "string",
+                            "enum": [
+                                "internal",
+                                "public",
+                                "preview"
+                            ]
+                        },
+                        "healthRoute": {
+                            "description": "HTTP readiness path (e.g. \"/api/health\"), probed with an HTTP GET. Set ONLY on HTTP services. Omit for for non-http services (e.g. datastores like Postgres/Redis/MySQL/Mongo/…). An HTTP probe against their binary wire protocol never succeeds and hangs the unit's boot.",
+                            "type": "string",
+                            "maxLength": 255,
+                            "pattern": "^\\/.*"
+                        }
+                    },
+                    "required": [
+                        "name",
+                        "port"
+                    ]
+                }
+            },
+            "startCommand": {
+                "type": "string",
+                "description": "Shell command to start the service (e.g. \"npm run dev\"). The service MUST bind the first endpoint's port: pass it explicitly via a framework flag (e.g. \"next dev -p 3000\") or inline env for apps that only read process.env.PORT (e.g. \"PORT=3000 npm run dev\"). Steps that need a live dependency (migrations, seeds) belong at the front of this command; they re-run on every restart, so keep them idempotent. This command may span multiple lines — prefer that over a long single-line `&&` chain when there are several steps. For \"docker-stack\" services this is the up command (e.g. \"supabase start\")."
+            },
+            "stopCommand": {
+                "type": "string",
+                "description": "Optional command to stop the service (e.g. \"docker compose down\")."
+            },
+            "after": {
+                "description": "Other service names this service must start after. Ordering is readiness-gated — the service waits until its dependencies are accepting connections.",
+                "default": [],
+                "type": "array",
+                "items": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 100
+                }
+            },
+            "envFiles": {
+                "description": "docker-stack only: paths (relative to `directory`) to write the resolved env into as a `.env` file. Empty defaults to a single `.env`. Example: Supabase needs [\".env\", \"supabase/functions/.env\"] — the root `.env` feeds config.toml's env() interpolation, while supabase/functions/.env is read by the Edge Functions",
+                "default": [],
+                "type": "array",
+                "items": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 255
+                }
+            },
+            "name": {
+                "type": "string"
+            },
+            "sortOrder": {
+                "type": "integer"
+            }
+        },
+        "required": [
+            "projectId",
+            "startCommand",
+            "name"
+        ],
+        "additionalProperties": false
+    },
+    operation,
+};

package/dist/generated/tools/projects/services-list.js

@@ -0,0 +1,20 @@
+import { operation } from '../../commands/projects/services-list.js';
+export const tool = {
+    "name": "projects_services_list",
+    "toolset": "projects",
+    "description": "List the project services, in the order they start. Carries no environment variables.",
+    "inputSchema": {
+        "type": "object",
+        "properties": {
+            "projectId": {
+                "type": "string",
+                "description": "Project id."
+            }
+        },
+        "required": [
+            "projectId"
+        ],
+        "additionalProperties": false
+    },
+    operation,
+};

package/dist/generated/tools/projects/services-remove.js

@@ -0,0 +1,25 @@
+import { operation } from '../../commands/projects/services-remove.js';
+export const tool = {
+    "name": "projects_services_remove",
+    "toolset": "projects",
+    "description": "Remove one service.",
+    "inputSchema": {
+        "type": "object",
+        "properties": {
+            "projectId": {
+                "type": "string",
+                "description": "Project id."
+            },
+            "serviceId": {
+                "type": "string",
+                "description": "Service id."
+            }
+        },
+        "required": [
+            "projectId",
+            "serviceId"
+        ],
+        "additionalProperties": false
+    },
+    operation,
+};

package/dist/generated/tools/projects/services-update.js

@@ -0,0 +1,104 @@
+import { operation } from '../../commands/projects/services-update.js';
+export const tool = {
+    "name": "projects_services_update",
+    "toolset": "projects",
+    "description": "Change one service. Every field is optional; only the ones sent change.",
+    "inputSchema": {
+        "type": "object",
+        "properties": {
+            "projectId": {
+                "type": "string",
+                "description": "Project id."
+            },
+            "serviceId": {
+                "type": "string",
+                "description": "Service id."
+            },
+            "name": {
+                "type": "string"
+            },
+            "directory": {
+                "type": "string"
+            },
+            "kind": {
+                "type": "string",
+                "enum": [
+                    "process",
+                    "docker-stack"
+                ]
+            },
+            "endpoints": {
+                "type": "array",
+                "items": {
+                    "type": "object",
+                    "properties": {
+                        "name": {
+                            "type": "string",
+                            "minLength": 1,
+                            "maxLength": 63,
+                            "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?$",
+                            "description": "Endpoint name, unique within the service (e.g. \"api\", \"studio\"). Lowercase alphanumeric with inner hyphens — non-primary endpoint names become part of the preview host."
+                        },
+                        "port": {
+                            "type": "integer",
+                            "minimum": 1,
+                            "maximum": 65535,
+                            "description": "Port this endpoint listens on."
+                        },
+                        "exposure": {
+                            "default": "internal",
+                            "description": "\"internal\": sandbox-only (no URL). \"public\": browser-reachable URL, not rendered. \"preview\": public URL AND shown in the preview panel.",
+                            "type": "string",
+                            "enum": [
+                                "internal",
+                                "public",
+                                "preview"
+                            ]
+                        },
+                        "healthRoute": {
+                            "description": "HTTP readiness path (e.g. \"/api/health\"), probed with an HTTP GET. Set ONLY on HTTP services. Omit for for non-http services (e.g. datastores like Postgres/Redis/MySQL/Mongo/…). An HTTP probe against their binary wire protocol never succeeds and hangs the unit's boot.",
+                            "type": "string",
+                            "maxLength": 255,
+                            "pattern": "^\\/.*"
+                        }
+                    },
+                    "required": [
+                        "name",
+                        "port"
+                    ]
+                }
+            },
+            "startCommand": {
+                "type": "string"
+            },
+            "stopCommand": {
+                "type": "string"
+            },
+            "after": {
+                "type": "array",
+                "items": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 100
+                }
+            },
+            "envFiles": {
+                "type": "array",
+                "items": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 255
+                }
+            },
+            "sortOrder": {
+                "type": "integer"
+            }
+        },
+        "required": [
+            "projectId",
+            "serviceId"
+        ],
+        "additionalProperties": false
+    },
+    operation,
+};

package/dist/generated/tools/projects/settings-get.js

@@ -0,0 +1,20 @@
+import { operation } from '../../commands/projects/settings-get.js';
+export const tool = {
+    "name": "projects_settings_get",
+    "toolset": "projects",
+    "description": "Read the project settings: setup commands, services, environment and sandbox size.",
+    "inputSchema": {
+        "type": "object",
+        "properties": {
+            "projectId": {
+                "type": "string",
+                "description": "Project id."
+            }
+        },
+        "required": [
+            "projectId"
+        ],
+        "additionalProperties": false
+    },
+    operation,
+};

package/dist/generated/tools/projects/settings-import.js

@@ -0,0 +1,208 @@
+import { operation } from '../../commands/projects/settings-import.js';
+export const tool = {
+    "name": "projects_settings_import",
+    "toolset": "projects",
+    "description": "Replace the services and environment from a kosuke.config.json document. Cross-service rules (unique ports, after references, one preview endpoint) are checked by the handler, not by the schema.",
+    "inputSchema": {
+        "type": "object",
+        "properties": {
+            "projectId": {
+                "type": "string",
+                "description": "Project id."
+            },
+            "hostSetupCommand": {
+                "type": [
+                    "string",
+                    "null"
+                ],
+                "description": "Shell command that runs once on first deploy (or when its content changes) to provision the host: install runtimes and system packages. Re-runs only when edited."
+            },
+            "setupCommand": {
+                "type": [
+                    "string",
+                    "null"
+                ],
+                "description": "Shell command that runs at repository root on every deploy, strictly BEFORE any service starts. Services from this config (databases included) are not reachable from it. Use it for installing dependencies; run migrations and seeds at the front of the dependent service's startCommand instead."
+            },
+            "warmupCommand": {
+                "type": [
+                    "string",
+                    "null"
+                ],
+                "description": "Shell command that runs inside the sandbox once services are healthy. Typically authenticates and curls heavy routes to warm up compilation cache."
+            },
+            "agentWorkDir": {
+                "type": [
+                    "string",
+                    "null"
+                ],
+                "description": "Relative path from the repository root where the AI agent operates. Useful for monorepos where the agent should work only in a subdirectory (e.g. \"packages/frontend\"). Defaults to repository root."
+            },
+            "sessionBaseBranch": {
+                "type": [
+                    "string",
+                    "null"
+                ],
+                "description": "Git branch new coding sessions branch from (e.g. \"main\"). Null/omitted uses the repository default branch."
+            },
+            "prTargetBranch": {
+                "type": [
+                    "string",
+                    "null"
+                ],
+                "description": "Git branch that submitted PRs target (e.g. \"main\"). Null/omitted uses the repository default branch."
+            },
+            "sandboxTier": {
+                "type": "string",
+                "description": "Sandbox resource tier provisioned for the preview: SMALL, MEDIUM, LARGE, or XLARGE. Omitted leaves the current tier. A first deploy boots on XLARGE (unknown footprint) — measure actual peak usage and set the right-sized tier here so later sandboxes use it.",
+                "enum": [
+                    "SMALL",
+                    "MEDIUM",
+                    "LARGE",
+                    "XLARGE"
+                ]
+            },
+            "services": {
+                "description": "Map of service name → configuration. Everything is a service — apps, workers, databases (Postgres/Redis as \"process\"), and container stacks (Supabase as \"docker-stack\"). Names must be lowercase alphanumeric with inner hyphens (they become DNS labels and systemd unit names).",
+                "default": {},
+                "type": "object",
+                "propertyNames": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 63,
+                    "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?$"
+                },
+                "additionalProperties": {
+                    "type": "object",
+                    "properties": {
+                        "directory": {
+                            "default": ".",
+                            "description": "Relative path to the service directory within the repository (e.g. \"api\", \"apps/web\"). Defaults to repository root.",
+                            "type": "string",
+                            "maxLength": 255
+                        },
+                        "kind": {
+                            "default": "process",
+                            "description": "Run mode. \"process\": a plain command supervised directly (apps, workers, Postgres, Redis). \"docker-stack\": a multi-container docker-compose stack (e.g. Supabase) with up/down commands.",
+                            "type": "string",
+                            "enum": [
+                                "process",
+                                "docker-stack"
+                            ]
+                        },
+                        "endpoints": {
+                            "default": [],
+                            "description": "Exposed endpoints. A service has 0..N (0 = background, no port); port/type/frontend/health are per endpoint. List the primary user-facing endpoint FIRST: it answers {{service.url}} and drives the readiness probe.",
+                            "type": "array",
+                            "items": {
+                                "type": "object",
+                                "properties": {
+                                    "name": {
+                                        "type": "string",
+                                        "minLength": 1,
+                                        "maxLength": 63,
+                                        "pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?$",
+                                        "description": "Endpoint name, unique within the service (e.g. \"api\", \"studio\"). Lowercase alphanumeric with inner hyphens — non-primary endpoint names become part of the preview host."
+                                    },
+                                    "port": {
+                                        "type": "integer",
+                                        "minimum": 1,
+                                        "maximum": 65535,
+                                        "description": "Port this endpoint listens on."
+                                    },
+                                    "exposure": {
+                                        "default": "internal",
+                                        "description": "\"internal\": sandbox-only (no URL). \"public\": browser-reachable URL, not rendered. \"preview\": public URL AND shown in the preview panel.",
+                                        "type": "string",
+                                        "enum": [
+                                            "internal",
+                                            "public",
+                                            "preview"
+                                        ]
+                                    },
+                                    "healthRoute": {
+                                        "description": "HTTP readiness path (e.g. \"/api/health\"), probed with an HTTP GET. Set ONLY on HTTP services. Omit for for non-http services (e.g. datastores like Postgres/Redis/MySQL/Mongo/…). An HTTP probe against their binary wire protocol never succeeds and hangs the unit's boot.",
+                                        "type": "string",
+                                        "maxLength": 255,
+                                        "pattern": "^\\/.*"
+                                    }
+                                },
+                                "required": [
+                                    "name",
+                                    "port"
+                                ]
+                            }
+                        },
+                        "startCommand": {
+                            "type": "string",
+                            "minLength": 1,
+                            "maxLength": 500,
+                            "description": "Shell command to start the service (e.g. \"npm run dev\"). The service MUST bind the first endpoint's port: pass it explicitly via a framework flag (e.g. \"next dev -p 3000\") or inline env for apps that only read process.env.PORT (e.g. \"PORT=3000 npm run dev\"). Steps that need a live dependency (migrations, seeds) belong at the front of this command; they re-run on every restart, so keep them idempotent. This command may span multiple lines — prefer that over a long single-line `&&` chain when there are several steps. For \"docker-stack\" services this is the up command (e.g. \"supabase start\")."
+                        },
+                        "stopCommand": {
+                            "description": "Optional command to stop the service (e.g. \"docker compose down\").",
+                            "type": "string",
+                            "maxLength": 500
+                        },
+                        "after": {
+                            "default": [],
+                            "description": "Other service names this service must start after. Ordering is readiness-gated — the service waits until its dependencies are accepting connections.",
+                            "type": "array",
+                            "items": {
+                                "type": "string",
+                                "minLength": 1,
+                                "maxLength": 100
+                            }
+                        },
+                        "envFiles": {
+                            "default": [],
+                            "description": "docker-stack only: paths (relative to `directory`) to write the resolved env into as a `.env` file. Empty defaults to a single `.env`. Example: Supabase needs [\".env\", \"supabase/functions/.env\"] — the root `.env` feeds config.toml's env() interpolation, while supabase/functions/.env is read by the Edge Functions",
+                            "type": "array",
+                            "items": {
+                                "type": "string",
+                                "minLength": 1,
+                                "maxLength": 255
+                            }
+                        }
+                    },
+                    "required": [
+                        "startCommand"
+                    ]
+                }
+            },
+            "environment": {
+                "description": "Map of environment variable name → value. Injected into all services at startup. Values support service-URL placeholders like {{serviceName.url}} / {{serviceName.url_int}} resolved at sandbox boot.",
+                "default": {},
+                "type": "object",
+                "propertyNames": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 255,
+                    "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
+                },
+                "additionalProperties": {
+                    "type": "object",
+                    "properties": {
+                        "value": {
+                            "type": "string",
+                            "description": "The environment variable value. Supports {{placeholder}} syntax resolved at sandbox startup. Available placeholders: {{<service_name>.url}} — public HTTPS URL of a service (only for public services). {{<service_name>.url_int}} — internal localhost URL of a service (e.g. http://localhost:3000). "
+                        },
+                        "isSecret": {
+                            "default": false,
+                            "description": "Whether this variable contains sensitive data. Secret values are masked in the UI and encrypted at rest.",
+                            "type": "boolean"
+                        }
+                    },
+                    "required": [
+                        "value"
+                    ]
+                }
+            }
+        },
+        "required": [
+            "projectId"
+        ],
+        "additionalProperties": false
+    },
+    operation,
+};