@kosuke-ai/kosuke 1.0.0 → 1.0.2

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

@@ -0,0 +1,41 @@
+export const operation = {
+    "method": "get",
+    "path": "/api/projects/{projectId}/chat-sessions/{sessionId}/messages",
+    "command": [
+        "sessions",
+        "messages"
+    ],
+    "summary": "Read a chat session conversation oldest first: the whole of it, its last limit messages, the page before an olderCursor, or everything from one. messageCount counts the whole conversation. Blocks come summarized: a tool call's input keeps its short fields (inputCompacted), a result over 500 characters its first 500 (resultCompacted), and a subagent its last output entry with outputCount (outputOmitted). sessions message reads one message whole.",
+    "pathParams": [
+        "projectId",
+        "sessionId"
+    ],
+    "query": [
+        {
+            "name": "limit",
+            "flag": "limit",
+            "kind": "integer",
+            "required": false,
+            "description": "Only the newest messages, up to this many. With from, the oldest this many from that message on."
+        },
+        {
+            "name": "before",
+            "flag": "before",
+            "kind": "string",
+            "required": false,
+            "description": "An olderCursor from an earlier read: only the messages older than the oldest message of that read."
+        },
+        {
+            "name": "from",
+            "flag": "from",
+            "kind": "string",
+            "required": false,
+            "description": "An olderCursor from an earlier read: the oldest message of that read and every message after it."
+        }
+    ],
+    "body": null,
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

package/dist/generated/commands/sessions/needs-you.js

@@ -0,0 +1,16 @@
+export const operation = {
+    "method": "get",
+    "path": "/api/chat-sessions/needs-you",
+    "command": [
+        "sessions",
+        "needs-you"
+    ],
+    "summary": "List your own Active and Under Review chat sessions in three groups, as the desktop menu bar shows them: needsYou (a Clarification waiting on you, or a Turn that finished or failed since you last read it), running, and recent. Each item names its project, the reason it is listed and the latest chat job. At most 50 per group, newest activity first; counts gives each group in full. It spans every workspace you belong to; an agent token sees only its own.",
+    "pathParams": [],
+    "query": [],
+    "body": null,
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

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

@@ -0,0 +1,22 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/projects/{projectId}/chat-sessions/{sessionId}/qa-passed/clear",
+    "command": [
+        "sessions",
+        "qa",
+        "clear"
+    ],
+    "summary": "Clear the session's qaPassedSha, so no head counts as passed until QA passes again. The callers of `sessions qa set`, and the running Batch's session for any session of its project.",
+    "pathParams": [
+        "projectId",
+        "sessionId"
+    ],
+    "query": [],
+    "body": null,
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": [
+        "sandboxToken"
+    ]
+};

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