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

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,
+};

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

@@ -0,0 +1,72 @@
+import { operation } from '../../commands/projects/settings-update.js';
+export const tool = {
+    "name": "projects_settings_update",
+    "toolset": "projects",
+    "description": "Change setup commands, branches, working directory or sandbox tier.",
+    "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"
+                ]
+            }
+        },
+        "required": [
+            "projectId"
+        ],
+        "additionalProperties": false
+    },
+    operation,
+};

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

@@ -0,0 +1,32 @@
+import { operation } from '../../commands/projects/skills.js';
+export const tool = {
+    "name": "projects_skills",
+    "toolset": "projects",
+    "description": "List the skills the agent can invoke in this project, for one provider.",
+    "inputSchema": {
+        "type": "object",
+        "properties": {
+            "projectId": {
+                "type": "string",
+                "description": "Project id."
+            },
+            "provider": {
+                "type": "string",
+                "enum": [
+                    "anthropic",
+                    "openai"
+                ]
+            },
+            "sessionId": {
+                "type": "string",
+                "description": "Prefer that chat session's sandbox when listing live. Silently ignored if it is not this project's."
+            }
+        },
+        "required": [
+            "projectId",
+            "provider"
+        ],
+        "additionalProperties": false
+    },
+    operation,
+};

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

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

package/dist/generated/tools/sessions/activate.js

@@ -0,0 +1,25 @@
+import { operation } from '../../commands/sessions/activate.js';
+export const tool = {
+    "name": "sessions_activate",
+    "toolset": "sessions",
+    "description": "Start a backlog session: claim a sandbox and run its saved prompt as the first turn.",
+    "inputSchema": {
+        "type": "object",
+        "properties": {
+            "projectId": {
+                "type": "string",
+                "description": "Project id."
+            },
+            "sessionId": {
+                "type": "string",
+                "description": "Session id."
+            }
+        },
+        "required": [
+            "projectId",
+            "sessionId"
+        ],
+        "additionalProperties": false
+    },
+    operation,
+};

package/dist/generated/tools/sessions/artifacts-get.js

@@ -0,0 +1,30 @@
+import { operation } from '../../commands/sessions/artifacts-get.js';
+export const tool = {
+    "name": "sessions_artifacts_get",
+    "toolset": "sessions",
+    "description": "Read one artifact of the session: a markdown or html one carries its body, an image or a video a presigned url, its media type and its size.",
+    "inputSchema": {
+        "type": "object",
+        "properties": {
+            "projectId": {
+                "type": "string",
+                "description": "Project id."
+            },
+            "sessionId": {
+                "type": "string",
+                "description": "Session id."
+            },
+            "artifactId": {
+                "type": "string",
+                "description": "Artifact id."
+            }
+        },
+        "required": [
+            "projectId",
+            "sessionId",
+            "artifactId"
+        ],
+        "additionalProperties": false
+    },
+    operation,
+};

package/dist/generated/tools/sessions/artifacts-list.js

@@ -0,0 +1,25 @@
+import { operation } from '../../commands/sessions/artifacts-list.js';
+export const tool = {
+    "name": "sessions_artifacts_list",
+    "toolset": "sessions",
+    "description": "List the session's artifacts, most recently changed first. Rows only: a body or a file url comes from reading one.",
+    "inputSchema": {
+        "type": "object",
+        "properties": {
+            "projectId": {
+                "type": "string",
+                "description": "Project id."
+            },
+            "sessionId": {
+                "type": "string",
+                "description": "Session id."
+            }
+        },
+        "required": [
+            "projectId",
+            "sessionId"
+        ],
+        "additionalProperties": false
+    },
+    operation,
+};

package/dist/generated/tools/sessions/checklist-generate.js

@@ -0,0 +1,25 @@
+import { operation } from '../../commands/sessions/checklist-generate.js';
+export const tool = {
+    "name": "sessions_checklist_generate",
+    "toolset": "sessions",
+    "description": "Generate testing checklist items from the branch's changes on GitHub.",
+    "inputSchema": {
+        "type": "object",
+        "properties": {
+            "projectId": {
+                "type": "string",
+                "description": "Project id."
+            },
+            "sessionId": {
+                "type": "string",
+                "description": "Session id."
+            }
+        },
+        "required": [
+            "projectId",
+            "sessionId"
+        ],
+        "additionalProperties": false
+    },
+    operation,
+};

package/dist/generated/tools/sessions/checklist-get.js

@@ -0,0 +1,25 @@
+import { operation } from '../../commands/sessions/checklist-get.js';
+export const tool = {
+    "name": "sessions_checklist_get",
+    "toolset": "sessions",
+    "description": "Read the testing checklist of a chat session.",
+    "inputSchema": {
+        "type": "object",
+        "properties": {
+            "projectId": {
+                "type": "string",
+                "description": "Project id."
+            },
+            "sessionId": {
+                "type": "string",
+                "description": "Session id."
+            }
+        },
+        "required": [
+            "projectId",
+            "sessionId"
+        ],
+        "additionalProperties": false
+    },
+    operation,
+};

package/dist/generated/tools/sessions/comments-add.js

@@ -0,0 +1,53 @@
+import { operation } from '../../commands/sessions/comments-add.js';
+export const tool = {
+    "name": "sessions_comments_add",
+    "toolset": "sessions",
+    "description": "Leave a review comment on a range of lines in the diff.",
+    "inputSchema": {
+        "type": "object",
+        "properties": {
+            "projectId": {
+                "type": "string",
+                "description": "Project id."
+            },
+            "sessionId": {
+                "type": "string",
+                "description": "Session id."
+            },
+            "filePath": {
+                "type": "string"
+            },
+            "side": {
+                "type": "string",
+                "enum": [
+                    "old",
+                    "new"
+                ]
+            },
+            "startLineNumber": {
+                "type": "integer"
+            },
+            "endLineNumber": {
+                "type": "integer"
+            },
+            "body": {
+                "type": "string"
+            },
+            "lineSnapshot": {
+                "type": "string"
+            }
+        },
+        "required": [
+            "projectId",
+            "sessionId",
+            "filePath",
+            "side",
+            "startLineNumber",
+            "endLineNumber",
+            "body",
+            "lineSnapshot"
+        ],
+        "additionalProperties": false
+    },
+    operation,
+};

package/dist/generated/tools/sessions/comments-delete.js

@@ -0,0 +1,30 @@
+import { operation } from '../../commands/sessions/comments-delete.js';
+export const tool = {
+    "name": "sessions_comments_delete",
+    "toolset": "sessions",
+    "description": "Delete your own comment.",
+    "inputSchema": {
+        "type": "object",
+        "properties": {
+            "projectId": {
+                "type": "string",
+                "description": "Project id."
+            },
+            "sessionId": {
+                "type": "string",
+                "description": "Session id."
+            },
+            "commentId": {
+                "type": "string",
+                "description": "Comment id."
+            }
+        },
+        "required": [
+            "projectId",
+            "sessionId",
+            "commentId"
+        ],
+        "additionalProperties": false
+    },
+    operation,
+};

package/dist/generated/tools/sessions/comments-list.js

@@ -0,0 +1,25 @@
+import { operation } from '../../commands/sessions/comments-list.js';
+export const tool = {
+    "name": "sessions_comments_list",
+    "toolset": "sessions",
+    "description": "List the review comments left on the diff.",
+    "inputSchema": {
+        "type": "object",
+        "properties": {
+            "projectId": {
+                "type": "string",
+                "description": "Project id."
+            },
+            "sessionId": {
+                "type": "string",
+                "description": "Session id."
+            }
+        },
+        "required": [
+            "projectId",
+            "sessionId"
+        ],
+        "additionalProperties": false
+    },
+    operation,
+};

package/dist/generated/tools/sessions/comments-update.js

@@ -0,0 +1,62 @@
+import { operation } from '../../commands/sessions/comments-update.js';
+export const tool = {
+    "name": "sessions_comments_update",
+    "toolset": "sessions",
+    "description": "Edit the body of your own comment, or resolve or reopen any comment. One of the two per call.",
+    "inputSchema": {
+        "type": "object",
+        "properties": {
+            "projectId": {
+                "type": "string",
+                "description": "Project id."
+            },
+            "sessionId": {
+                "type": "string",
+                "description": "Session id."
+            },
+            "commentId": {
+                "type": "string",
+                "description": "Comment id."
+            },
+            "body": {
+                "description": "The whole request body.",
+                "anyOf": [
+                    {
+                        "type": "object",
+                        "properties": {
+                            "body": {
+                                "type": "string",
+                                "minLength": 1,
+                                "maxLength": 4000
+                            }
+                        },
+                        "required": [
+                            "body"
+                        ],
+                        "additionalProperties": false
+                    },
+                    {
+                        "type": "object",
+                        "properties": {
+                            "resolved": {
+                                "type": "boolean"
+                            }
+                        },
+                        "required": [
+                            "resolved"
+                        ],
+                        "additionalProperties": false
+                    }
+                ]
+            }
+        },
+        "required": [
+            "projectId",
+            "sessionId",
+            "commentId",
+            "body"
+        ],
+        "additionalProperties": false
+    },
+    operation,
+};