@kosuke-ai/kosuke 1.0.0 → 1.0.1

package/dist/generated/commands/sessions/qa-set.js

@@ -0,0 +1,33 @@
+export const operation = {
+    "method": "put",
+    "path": "/api/projects/{projectId}/chat-sessions/{sessionId}/qa-passed",
+    "command": [
+        "sessions",
+        "qa",
+        "set"
+    ],
+    "summary": "Record the commit QA passed on as the session's qaPassedSha. A session token may set only its own session. A pull request is done when qaPassedSha equals its head.",
+    "pathParams": [
+        "projectId",
+        "sessionId"
+    ],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "sha",
+                "flag": "sha",
+                "kind": "string",
+                "required": true,
+                "description": "The head commit QA passed on, or was skipped on for a change with nothing to test: `git rev-parse HEAD`."
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": [
+        "sandboxToken"
+    ]
+};

package/dist/generated/commands/sessions/queue-delete.js

@@ -0,0 +1,23 @@
+export const operation = {
+    "method": "delete",
+    "path": "/api/projects/{projectId}/chat-sessions/{sessionId}/queue/{queuedMessageId}",
+    "command": [
+        "sessions",
+        "queue",
+        "delete"
+    ],
+    "summary": "Delete a queued message: your own, or any as a workspace owner or admin.",
+    "pathParams": [
+        "projectId",
+        "sessionId",
+        "queuedMessageId"
+    ],
+    "query": [],
+    "body": null,
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": [
+        "senseiToken"
+    ]
+};

package/dist/generated/commands/sessions/queue-list.js

@@ -0,0 +1,20 @@
+export const operation = {
+    "method": "get",
+    "path": "/api/projects/{projectId}/chat-sessions/{sessionId}/queue",
+    "command": [
+        "sessions",
+        "queue",
+        "list"
+    ],
+    "summary": "List the messages waiting Up next in the session, in the order they will be sent, and whether Up next is paused.",
+    "pathParams": [
+        "projectId",
+        "sessionId"
+    ],
+    "query": [],
+    "body": null,
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

package/dist/generated/commands/sessions/queue-move.js

@@ -0,0 +1,32 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/projects/{projectId}/chat-sessions/{sessionId}/queue/{queuedMessageId}/move",
+    "command": [
+        "sessions",
+        "queue",
+        "move"
+    ],
+    "summary": "Move your own queued message to another place in Up next.",
+    "pathParams": [
+        "projectId",
+        "sessionId",
+        "queuedMessageId"
+    ],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "toIndex",
+                "flag": "to-index",
+                "kind": "integer",
+                "required": true,
+                "description": "Where the message goes, counted from the top."
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

package/dist/generated/commands/sessions/queue-resume.js

@@ -0,0 +1,20 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/projects/{projectId}/chat-sessions/{sessionId}/queue/resume",
+    "command": [
+        "sessions",
+        "queue",
+        "resume"
+    ],
+    "summary": "Resume a session's paused Up next. Its top message is sent as soon as nothing is running.",
+    "pathParams": [
+        "projectId",
+        "sessionId"
+    ],
+    "query": [],
+    "body": null,
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

package/dist/generated/commands/sessions/queue-send.js

@@ -0,0 +1,21 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/projects/{projectId}/chat-sessions/{sessionId}/queue/{queuedMessageId}/send",
+    "command": [
+        "sessions",
+        "queue",
+        "send"
+    ],
+    "summary": "Send your own queued message now as a turn of its own, ahead of the rest of Up next. Only while no turn is running; it resumes a paused Up next.",
+    "pathParams": [
+        "projectId",
+        "sessionId",
+        "queuedMessageId"
+    ],
+    "query": [],
+    "body": null,
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

package/dist/generated/commands/sessions/queue-steer.js

@@ -0,0 +1,21 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/projects/{projectId}/chat-sessions/{sessionId}/queue/{queuedMessageId}/steer",
+    "command": [
+        "sessions",
+        "queue",
+        "steer"
+    ],
+    "summary": "Send your own queued message into your running turn as a steer. The message stays Up next when the turn cannot take it.",
+    "pathParams": [
+        "projectId",
+        "sessionId",
+        "queuedMessageId"
+    ],
+    "query": [],
+    "body": null,
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

package/dist/generated/commands/sessions/queue-update.js

@@ -0,0 +1,57 @@
+export const operation = {
+    "method": "patch",
+    "path": "/api/projects/{projectId}/chat-sessions/{sessionId}/queue/{queuedMessageId}",
+    "command": [
+        "sessions",
+        "queue",
+        "update"
+    ],
+    "summary": "Save an edit to your own queued message, keeping its place in Up next. New files ride along as multipart.",
+    "pathParams": [
+        "projectId",
+        "sessionId",
+        "queuedMessageId"
+    ],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "content",
+                "flag": "content",
+                "kind": "string",
+                "required": true,
+                "description": "The new text of the message."
+            },
+            {
+                "name": "retainedAttachmentIds",
+                "flag": "retained-attachment-ids",
+                "kind": "json",
+                "required": false,
+                "description": "The ids of the files to keep. Omitted keeps them all."
+            }
+        ],
+        "required": true
+    },
+    "multipart": [
+        {
+            "name": "content",
+            "flag": "content",
+            "kind": "string",
+            "required": true,
+            "description": "The new text of the message."
+        },
+        {
+            "name": "retainedAttachmentIds",
+            "flag": "retained-attachment-ids",
+            "kind": "string",
+            "required": false,
+            "description": "JSON-encoded array of the ids of the files to keep."
+        }
+    ],
+    "attachments": {
+        "maxFiles": 10,
+        "maxBytes": 10485760
+    },
+    "anonymous": false,
+    "agents": "all"
+};

package/dist/generated/commands/sessions/runtime-command.js

@@ -0,0 +1,39 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/projects/{projectId}/chat-sessions/{sessionId}/runtime-commands",
+    "command": [
+        "sessions",
+        "runtime-command"
+    ],
+    "summary": "Run a runtime command on the agent session: clear starts a fresh conversation, compact summarizes it, with optional focus instructions. Queued Up next while a turn or another command is running. Compact waits for the sandbox and can take a minute.",
+    "pathParams": [
+        "projectId",
+        "sessionId"
+    ],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "command",
+                "flag": "command",
+                "kind": "string",
+                "required": true,
+                "choices": [
+                    "clear",
+                    "compact"
+                ]
+            },
+            {
+                "name": "instructions",
+                "flag": "instructions",
+                "kind": "string",
+                "required": false
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

package/dist/generated/commands/sessions/search.js

@@ -0,0 +1,24 @@
+export const operation = {
+    "method": "get",
+    "path": "/api/chat-sessions/search",
+    "command": [
+        "sessions",
+        "search"
+    ],
+    "summary": "Search chat sessions by title across every workspace you belong to. An agent token searches its own workspace, or its own project when no member stands behind it.",
+    "pathParams": [],
+    "query": [
+        {
+            "name": "q",
+            "flag": "q",
+            "kind": "string",
+            "required": false,
+            "description": "Search text, trimmed. Empty or absent returns the most recent sessions."
+        }
+    ],
+    "body": null,
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

package/dist/generated/commands/sessions/send.js

@@ -0,0 +1,138 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/projects/{projectId}/chat-sessions/{sessionId}/jobs/chat",
+    "command": [
+        "sessions",
+        "send"
+    ],
+    "summary": "Send a message: starts a turn, or waits Up next while one is running. To steer the running turn with it, steer the Queued Message it becomes. Attachments ride along as multipart.",
+    "pathParams": [
+        "projectId",
+        "sessionId"
+    ],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "content",
+                "flag": "content",
+                "kind": "string",
+                "required": true
+            },
+            {
+                "name": "model",
+                "flag": "model",
+                "kind": "string",
+                "required": false
+            },
+            {
+                "name": "auto",
+                "flag": "auto",
+                "kind": "boolean",
+                "required": false,
+                "description": "True puts the session on Auto from this Turn: Kosuke picks its Model and Provider. False takes it off, with model or the session's own. Absent keeps the session as it is."
+            },
+            {
+                "name": "kosukeFree",
+                "flag": "kosuke-free",
+                "kind": "boolean",
+                "required": false,
+                "description": "true runs this Turn and the session on Kosuke free; false takes the session off it. Refused with kosuke_free_off, kosuke_free_paused, kosuke_free_spent or kosuke_free_unavailable before anything runs."
+            },
+            {
+                "name": "previewContext",
+                "flag": "preview-context",
+                "kind": "json",
+                "required": false
+            },
+            {
+                "name": "diffCommentsContext",
+                "flag": "diff-comments-context",
+                "kind": "json",
+                "required": false
+            },
+            {
+                "name": "retryFailedJobId",
+                "flag": "retry-failed-job-id",
+                "kind": "string",
+                "required": false
+            },
+            {
+                "name": "runningJobId",
+                "flag": "running-job-id",
+                "kind": "string",
+                "required": false,
+                "description": "The job the sender saw running. If it was stopped by the time the message lands, the message is refused with JOB_STOPPED instead of starting a turn."
+            }
+        ],
+        "required": true
+    },
+    "multipart": [
+        {
+            "name": "content",
+            "flag": "content",
+            "kind": "string",
+            "required": false,
+            "description": "The message. May be empty only when diffCommentsContext or attachments carry it."
+        },
+        {
+            "name": "model",
+            "flag": "model",
+            "kind": "string",
+            "required": false
+        },
+        {
+            "name": "auto",
+            "flag": "auto",
+            "kind": "string",
+            "required": false,
+            "description": "As the JSON body's auto.",
+            "choices": [
+                "true",
+                "false"
+            ]
+        },
+        {
+            "name": "kosukeFree",
+            "flag": "kosuke-free",
+            "kind": "string",
+            "required": false,
+            "choices": [
+                "true",
+                "false"
+            ]
+        },
+        {
+            "name": "previewContext",
+            "flag": "preview-context",
+            "kind": "string",
+            "required": false,
+            "description": "JSON-encoded { frontendName, path }."
+        },
+        {
+            "name": "diffCommentsContext",
+            "flag": "diff-comments-context",
+            "kind": "string",
+            "required": false,
+            "description": "JSON-encoded array of diff comments."
+        },
+        {
+            "name": "retryFailedJobId",
+            "flag": "retry-failed-job-id",
+            "kind": "string",
+            "required": false
+        },
+        {
+            "name": "runningJobId",
+            "flag": "running-job-id",
+            "kind": "string",
+            "required": false
+        }
+    ],
+    "attachments": {
+        "maxFiles": 10,
+        "maxBytes": 10485760
+    },
+    "anonymous": false,
+    "agents": "all"
+};

package/dist/generated/commands/sessions/steer.js

@@ -0,0 +1,36 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/projects/{projectId}/chat-sessions/{sessionId}/steer",
+    "command": [
+        "sessions",
+        "steer"
+    ],
+    "summary": "Send a message and steer it into your running turn. Answers delivery steer, queued (the turn could not take it), job (no turn was running) or refused (the turn was stopped).",
+    "pathParams": [
+        "projectId",
+        "sessionId"
+    ],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "content",
+                "flag": "content",
+                "kind": "string",
+                "required": true
+            },
+            {
+                "name": "runningJobId",
+                "flag": "running-job-id",
+                "kind": "string",
+                "required": false,
+                "description": "The turn the sender meant to steer. Without it the latest turn stands in. A stopped turn answers delivery refused and nothing is sent."
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

package/dist/generated/commands/sessions/sync.js

@@ -0,0 +1,37 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/projects/{projectId}/chat-sessions/{sessionId}/sync",
+    "command": [
+        "sessions",
+        "sync"
+    ],
+    "summary": "Merge the Target Branch, or the open pull request's base, into the session's branch on GitHub, like GitHub's Update branch, and refresh its sandbox. Without an open pull request, uses the project Target Branch, then its default branch. Starts no turn: outcome agent needs /kosuke:sync-branch; pending means GitHub accepted the merge and completion is queued. Poll statusJobId for refreshed or refresh_failed. Failed status includes recovery: retry for a transient refresh failure, observe while GitHub is unconfirmed, repair for an explicit agent repair after a confirmed merge, or stale when the branch or pull request changed. Retrying completion never requests another merge.",
+    "pathParams": [
+        "projectId",
+        "sessionId"
+    ],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "completion",
+                "flag": "completion",
+                "kind": "json",
+                "required": false,
+                "description": "Retry only the observation and sandbox refresh returned by a previous Sync. Never requests another merge."
+            },
+            {
+                "name": "statusJobId",
+                "flag": "status-job-id",
+                "kind": "string",
+                "required": false,
+                "description": "Read the completion job status without requesting a merge or refresh."
+            }
+        ],
+        "required": false
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

package/dist/generated/commands/sessions/title-generate.js

@@ -0,0 +1,29 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/projects/{projectId}/chat-sessions/{sessionId}/title/generate",
+    "command": [
+        "sessions",
+        "title-generate"
+    ],
+    "summary": "Generate a title for a backlog session from the prompt text given as content. The title is returned, not saved.",
+    "pathParams": [
+        "projectId",
+        "sessionId"
+    ],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "content",
+                "flag": "content",
+                "kind": "string",
+                "required": true
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

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

@@ -0,0 +1,118 @@
+export const operation = {
+    "method": "put",
+    "path": "/api/projects/{projectId}/chat-sessions/{sessionId}",
+    "command": [
+        "sessions",
+        "update"
+    ],
+    "summary": "Change title, status, model, Auto, Assignee, priority, Sandbox size (sandboxSize) or App stack (appStack). Which changes are legal depends on the current status; the handler decides. sandboxSize and appStack change only while the session is in the Backlog: once it started they are fixed, and 409 SANDBOX_SETTINGS_LOCKED refuses them.",
+    "pathParams": [
+        "projectId",
+        "sessionId"
+    ],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "startBranch",
+                "flag": "start-branch",
+                "kind": "string",
+                "required": false
+            },
+            {
+                "name": "title",
+                "flag": "title",
+                "kind": "string",
+                "required": false
+            },
+            {
+                "name": "status",
+                "flag": "status",
+                "kind": "string",
+                "required": false,
+                "choices": [
+                    "backlog",
+                    "active",
+                    "under-review",
+                    "archived",
+                    "completed"
+                ]
+            },
+            {
+                "name": "model",
+                "flag": "model",
+                "kind": "string",
+                "required": false
+            },
+            {
+                "name": "auto",
+                "flag": "auto",
+                "kind": "boolean",
+                "required": false,
+                "description": "True puts the session on Auto, from its next Turn. False takes it off; send it with model when choosing a Model. Absent leaves it as it is."
+            },
+            {
+                "name": "kosukeFree",
+                "flag": "kosuke-free",
+                "kind": "boolean",
+                "required": false,
+                "description": "true runs the session on Kosuke free, on the serving source's model; false, or picking any other model, takes it off. Refused for a session no member is assigned to and for one the workspace pays for."
+            },
+            {
+                "name": "nextTurn",
+                "flag": "next-turn",
+                "kind": "json",
+                "required": false,
+                "description": "Active or Under review only: the Model, Auto, or {kosukeFree:true} in personal scope, the session's next Turn runs on, whether or not a Turn is running now. The next Turn applies it once and clears it. null, or the Model and Auto state the session already has, clears it. Send it on its own."
+            },
+            {
+                "name": "ownerId",
+                "flag": "owner-id",
+                "kind": "string",
+                "required": false
+            },
+            {
+                "name": "priority",
+                "flag": "priority",
+                "kind": "string",
+                "required": false,
+                "choices": [
+                    "urgent",
+                    "high",
+                    "medium",
+                    "low",
+                    "none"
+                ]
+            },
+            {
+                "name": "sandboxSize",
+                "flag": "sandbox-size",
+                "kind": "string",
+                "required": false,
+                "description": "The session's Sandbox size: small (2 CPU, 4 GB), medium (4 CPU, 8 GB), large (8 CPU, 16 GB) or xlarge (16 CPU, 32 GB). Absent boots the project's size. Fixed once the session starts.",
+                "choices": [
+                    "small",
+                    "medium",
+                    "large",
+                    "xlarge"
+                ]
+            },
+            {
+                "name": "appStack",
+                "flag": "app-stack",
+                "kind": "string",
+                "required": false,
+                "description": "start (default) runs the project's services when the sandbox boots. skip boots setup and the agent only; a member or the session's agent starts the services later with sessions app-stack-start. Fixed once the session starts.",
+                "choices": [
+                    "start",
+                    "skip"
+                ]
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};