@kosuke-ai/kosuke 1.0.0 → 1.0.1

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

@@ -0,0 +1,88 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/projects/{projectId}/settings/services",
+    "command": [
+        "projects",
+        "services",
+        "add"
+    ],
+    "summary": "Add a service. A port already used by another service is rejected by the handler.",
+    "pathParams": [
+        "projectId"
+    ],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "directory",
+                "flag": "directory",
+                "kind": "string",
+                "required": false,
+                "description": "Relative path to the service directory within the repository (e.g. \"api\", \"apps/web\"). Defaults to repository root."
+            },
+            {
+                "name": "kind",
+                "flag": "kind",
+                "kind": "string",
+                "required": false,
+                "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.",
+                "choices": [
+                    "process",
+                    "docker-stack"
+                ]
+            },
+            {
+                "name": "endpoints",
+                "flag": "endpoints",
+                "kind": "json",
+                "required": false,
+                "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."
+            },
+            {
+                "name": "startCommand",
+                "flag": "start-command",
+                "kind": "string",
+                "required": true,
+                "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\")."
+            },
+            {
+                "name": "stopCommand",
+                "flag": "stop-command",
+                "kind": "string",
+                "required": false,
+                "description": "Optional command to stop the service (e.g. \"docker compose down\")."
+            },
+            {
+                "name": "after",
+                "flag": "after",
+                "kind": "json",
+                "required": false,
+                "description": "Other service names this service must start after. Ordering is readiness-gated: the service waits until its dependencies are accepting connections."
+            },
+            {
+                "name": "envFiles",
+                "flag": "env-files",
+                "kind": "json",
+                "required": false,
+                "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"
+            },
+            {
+                "name": "name",
+                "flag": "name",
+                "kind": "string",
+                "required": true
+            },
+            {
+                "name": "sortOrder",
+                "flag": "sort-order",
+                "kind": "integer",
+                "required": false
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

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

@@ -0,0 +1,19 @@
+export const operation = {
+    "method": "get",
+    "path": "/api/projects/{projectId}/settings/services",
+    "command": [
+        "projects",
+        "services",
+        "list"
+    ],
+    "summary": "List the project services, in the order they start. Carries no environment variables.",
+    "pathParams": [
+        "projectId"
+    ],
+    "query": [],
+    "body": null,
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

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

@@ -0,0 +1,19 @@
+export const operation = {
+    "method": "delete",
+    "path": "/api/projects/{projectId}/settings/services/{serviceId}",
+    "command": [
+        "projects",
+        "services",
+        "remove"
+    ],
+    "summary": "Remove one service.",
+    "pathParams": [
+        "projectId",
+        "serviceId"
+    ],
+    "query": [],
+    "body": null,
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false
+};

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

@@ -0,0 +1,82 @@
+export const operation = {
+    "method": "patch",
+    "path": "/api/projects/{projectId}/settings/services/{serviceId}",
+    "command": [
+        "projects",
+        "services",
+        "update"
+    ],
+    "summary": "Change one service. Every field is optional; only the ones sent change.",
+    "pathParams": [
+        "projectId",
+        "serviceId"
+    ],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "name",
+                "flag": "name",
+                "kind": "string",
+                "required": false
+            },
+            {
+                "name": "directory",
+                "flag": "directory",
+                "kind": "string",
+                "required": false
+            },
+            {
+                "name": "kind",
+                "flag": "kind",
+                "kind": "string",
+                "required": false,
+                "choices": [
+                    "process",
+                    "docker-stack"
+                ]
+            },
+            {
+                "name": "endpoints",
+                "flag": "endpoints",
+                "kind": "json",
+                "required": false
+            },
+            {
+                "name": "startCommand",
+                "flag": "start-command",
+                "kind": "string",
+                "required": false
+            },
+            {
+                "name": "stopCommand",
+                "flag": "stop-command",
+                "kind": "string",
+                "required": false
+            },
+            {
+                "name": "after",
+                "flag": "after",
+                "kind": "json",
+                "required": false
+            },
+            {
+                "name": "envFiles",
+                "flag": "env-files",
+                "kind": "json",
+                "required": false
+            },
+            {
+                "name": "sortOrder",
+                "flag": "sort-order",
+                "kind": "integer",
+                "required": false
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

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

@@ -0,0 +1,19 @@
+export const operation = {
+    "method": "get",
+    "path": "/api/projects/{projectId}/settings",
+    "command": [
+        "projects",
+        "settings",
+        "get"
+    ],
+    "summary": "Read the project settings: setup commands, services, environment and sandbox size.",
+    "pathParams": [
+        "projectId"
+    ],
+    "query": [],
+    "body": null,
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

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

@@ -0,0 +1,99 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/projects/{projectId}/settings/import",
+    "command": [
+        "projects",
+        "settings",
+        "import"
+    ],
+    "summary": "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.",
+    "pathParams": [
+        "projectId"
+    ],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "hostSetupCommand",
+                "flag": "host-setup-command",
+                "kind": "string",
+                "required": false,
+                "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."
+            },
+            {
+                "name": "setupCommand",
+                "flag": "setup-command",
+                "kind": "string",
+                "required": false,
+                "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."
+            },
+            {
+                "name": "warmupCommand",
+                "flag": "warmup-command",
+                "kind": "string",
+                "required": false,
+                "description": "Shell command that runs inside the sandbox once services are healthy. Typically authenticates and curls heavy routes to warm up compilation cache."
+            },
+            {
+                "name": "agentWorkDir",
+                "flag": "agent-work-dir",
+                "kind": "string",
+                "required": false,
+                "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."
+            },
+            {
+                "name": "sessionBaseBranch",
+                "flag": "session-base-branch",
+                "kind": "string",
+                "required": false,
+                "description": "Git branch new coding sessions branch from (e.g. \"main\"). Null/omitted uses the repository default branch."
+            },
+            {
+                "name": "prTargetBranch",
+                "flag": "pr-target-branch",
+                "kind": "string",
+                "required": false,
+                "description": "Git branch that submitted PRs target (e.g. \"main\"). Null/omitted uses the repository default branch."
+            },
+            {
+                "name": "qaGuide",
+                "flag": "qa-guide",
+                "kind": "string",
+                "required": false,
+                "description": "The Project QA Guide: markdown on how to test this project in a sandbox. automated-qa proposes changes to the session's Assignee, and a member saves it. A sandbox cannot set it."
+            },
+            {
+                "name": "sandboxTier",
+                "flag": "sandbox-tier",
+                "kind": "string",
+                "required": false,
+                "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.",
+                "choices": [
+                    "SMALL",
+                    "MEDIUM",
+                    "LARGE",
+                    "XLARGE"
+                ]
+            },
+            {
+                "name": "services",
+                "flag": "services",
+                "kind": "json",
+                "required": false,
+                "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)."
+            },
+            {
+                "name": "environment",
+                "flag": "environment",
+                "kind": "json",
+                "required": false,
+                "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."
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

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

@@ -0,0 +1,85 @@
+export const operation = {
+    "method": "patch",
+    "path": "/api/projects/{projectId}/settings",
+    "command": [
+        "projects",
+        "settings",
+        "update"
+    ],
+    "summary": "Change setup commands, branches, working directory, sandbox tier or the Project QA Guide.",
+    "pathParams": [
+        "projectId"
+    ],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "hostSetupCommand",
+                "flag": "host-setup-command",
+                "kind": "string",
+                "required": false,
+                "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."
+            },
+            {
+                "name": "setupCommand",
+                "flag": "setup-command",
+                "kind": "string",
+                "required": false,
+                "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."
+            },
+            {
+                "name": "warmupCommand",
+                "flag": "warmup-command",
+                "kind": "string",
+                "required": false,
+                "description": "Shell command that runs inside the sandbox once services are healthy. Typically authenticates and curls heavy routes to warm up compilation cache."
+            },
+            {
+                "name": "agentWorkDir",
+                "flag": "agent-work-dir",
+                "kind": "string",
+                "required": false,
+                "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."
+            },
+            {
+                "name": "sessionBaseBranch",
+                "flag": "session-base-branch",
+                "kind": "string",
+                "required": false,
+                "description": "Git branch new coding sessions branch from (e.g. \"main\"). Null/omitted uses the repository default branch."
+            },
+            {
+                "name": "prTargetBranch",
+                "flag": "pr-target-branch",
+                "kind": "string",
+                "required": false,
+                "description": "Git branch that submitted PRs target (e.g. \"main\"). Null/omitted uses the repository default branch."
+            },
+            {
+                "name": "qaGuide",
+                "flag": "qa-guide",
+                "kind": "string",
+                "required": false,
+                "description": "The Project QA Guide: markdown on how to test this project in a sandbox. automated-qa proposes changes to the session's Assignee, and a member saves it. A sandbox cannot set it."
+            },
+            {
+                "name": "sandboxTier",
+                "flag": "sandbox-tier",
+                "kind": "string",
+                "required": false,
+                "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.",
+                "choices": [
+                    "SMALL",
+                    "MEDIUM",
+                    "LARGE",
+                    "XLARGE"
+                ]
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

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

@@ -0,0 +1,39 @@
+export const operation = {
+    "method": "get",
+    "path": "/api/projects/{projectId}/skills",
+    "command": [
+        "projects",
+        "skills"
+    ],
+    "summary": "List the skills the agent can invoke in this project, for one provider: the project's own, the workspace's and the member's, the plugins', and Kosuke's own skills in the kosuke plugin, which every chat session carries as kosuke:<name>. From a sandbox, sessionId defaults to its own chat session.",
+    "pathParams": [
+        "projectId"
+    ],
+    "query": [
+        {
+            "name": "provider",
+            "flag": "provider",
+            "kind": "string",
+            "required": true,
+            "choices": [
+                "anthropic",
+                "openai",
+                "meta",
+                "google",
+                "xai"
+            ]
+        },
+        {
+            "name": "sessionId",
+            "flag": "session-id",
+            "kind": "string",
+            "required": false,
+            "description": "Prefer that chat session's sandbox when listing live. Silently ignored if it is not this project's."
+        }
+    ],
+    "body": null,
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

package/dist/generated/commands/projects/switch-workflow.js

@@ -0,0 +1,34 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/projects/{projectId}/workflow",
+    "command": [
+        "projects",
+        "switch-workflow"
+    ],
+    "summary": "Switch a project between YOLO mode and Collaboration. YOLO completes every Active and Under Review session and turns Backlog sessions into Backlog items; switching back revives the sessions it closed.",
+    "pathParams": [
+        "projectId"
+    ],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "workflow",
+                "flag": "workflow",
+                "kind": "string",
+                "required": true,
+                "choices": [
+                    "collaboration",
+                    "yolo"
+                ]
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": [
+        "senseiToken"
+    ]
+};

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

@@ -0,0 +1,28 @@
+export const operation = {
+    "method": "patch",
+    "path": "/api/projects/{projectId}",
+    "command": [
+        "projects",
+        "update"
+    ],
+    "summary": "Rename a project.",
+    "pathParams": [
+        "projectId"
+    ],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "name",
+                "flag": "name",
+                "kind": "string",
+                "required": true
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

package/dist/generated/commands/projects/versions.js

@@ -0,0 +1,18 @@
+export const operation = {
+    "method": "get",
+    "path": "/api/projects/{projectId}/versions",
+    "command": [
+        "projects",
+        "versions"
+    ],
+    "summary": "List a YOLO project's Versions, newest first: each passing Turn saved to the default branch, with its commit and, for a Restore, the Version it brought back.",
+    "pathParams": [
+        "projectId"
+    ],
+    "query": [],
+    "body": null,
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

package/dist/generated/commands/sensei/cards-close.js

@@ -0,0 +1,43 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/sensei/cards/close",
+    "command": [
+        "sensei",
+        "cards",
+        "close"
+    ],
+    "summary": "Close your Turn's thread's open card with this key, at the revision you read, with one line on why it no longer asks anything of the member. A thread Kosuke opened that holds nothing of the member's then leaves Needs you and Done. Refused when the card moved, closed or is being sent, or when your Turn stopped.",
+    "pathParams": [],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "key",
+                "flag": "key",
+                "kind": "string",
+                "required": true
+            },
+            {
+                "name": "revision",
+                "flag": "revision",
+                "kind": "integer",
+                "required": true,
+                "description": "The open card's revision you read."
+            },
+            {
+                "name": "reason",
+                "flag": "reason",
+                "kind": "string",
+                "required": true,
+                "description": "One line on why the card no longer asks anything of the member."
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": [
+        "senseiToken"
+    ]
+};

package/dist/generated/commands/sensei/cards-mark-read.js

@@ -0,0 +1,30 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/sensei/cards/mark-read",
+    "command": [
+        "sensei",
+        "cards",
+        "mark-read"
+    ],
+    "summary": "Execute only the stored mark_read action of the card this member approved",
+    "pathParams": [],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "card",
+                "flag": "card",
+                "kind": "string",
+                "required": true,
+                "description": "The card approved by this Turn"
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": [
+        "senseiToken"
+    ]
+};