@kosuke-ai/kosuke 1.0.64 → 1.0.66
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +9 -0
- package/dist/agent/http.js +0 -5
- package/dist/agent/summary.js +29 -52
- package/dist/commands/agent.js +1 -1
- package/dist/generated/commands/activity/list.js +1 -1
- package/dist/generated/commands/projects/batch-merging-finish.js +1 -1
- package/dist/generated/commands/projects/batch-merging-picks-set.js +1 -1
- package/dist/generated/commands/sensei/cards-set.js +3 -2
- package/dist/generated/commands/sensei/delegates-stop.js +1 -1
- package/dist/generated/commands/sensei/messages-reply.js +1 -1
- package/dist/generated/commands/sensei/messages-send.js +1 -1
- package/dist/generated/commands/sessions/list--all.js +10 -20
- package/dist/generated/commands/sessions/list.js +8 -1
- package/dist/generated/commands/sessions/send.js +1 -1
- package/dist/generated/commands/sessions/steer.js +1 -1
- package/dist/generated/commands/tasks/list--all.js +0 -7
- package/dist/generated/commands/tasks/list--personal.js +0 -7
- package/dist/generated/commands/tasks/list.js +0 -7
- package/openapi.json +37 -57
- package/package.json +4 -4
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,14 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 1.0.66
|
|
4
|
+
|
|
5
|
+
- Remove `--needs-you` and `--viewer` from `sessions list`, and the `needsYouReason` field from its rows: what waits on you is a Sensei card, which `kosuke sensei cards list` lists. An older CLI that still sends them gets the plain list. `agent summary get` no longer prints a Needs You section.
|
|
6
|
+
|
|
7
|
+
## 1.0.65
|
|
8
|
+
|
|
9
|
+
- `kosuke sessions list` takes `--include-merge-agent-runs` to list Merge agent run sessions, which it leaves out by default, and `kosuke sensei messages send` and `reply` describe that a project's Deploy agent can send a message and that a session's, the Merge agent's or a Cron's message gets the member's answer back.
|
|
10
|
+
- Document the new refusals: a Sensei-sent sync is refused with SYNC_OWNED_BY_MERGE_AGENT in Batch and Train modes, a Sensei card with no primary with PRIMARY_REQUIRED, and Kosuke closes a Batch pull request that merged nothing.
|
|
11
|
+
|
|
3
12
|
## 1.0.64
|
|
4
13
|
|
|
5
14
|
- Sensei runs on your workspace's Credentials for a provider you hold no Subscription of, instead of Sensei free, and uses the workspace's Default Model when a thread has no model of its own. Pick the workspace under Sensei workspace in Settings > You > AI Providers. Sensei no longer has Auto: pick a model, and a model at its usage limit waits for its reset or another pick.
|
package/dist/agent/http.js
CHANGED
package/dist/agent/summary.js
CHANGED
|
@@ -2,11 +2,11 @@ import { providers } from '../generated/providers.js';
|
|
|
2
2
|
import { readOverview } from '../integrations/api.js';
|
|
3
3
|
import { createApiClient } from '../runtime/client.js';
|
|
4
4
|
import { isTurnToken } from '../runtime/credentials.js';
|
|
5
|
-
import { HttpError,
|
|
5
|
+
import { HttpError, paginationTotal } from './http.js';
|
|
6
6
|
/**
|
|
7
|
-
* `kosuke agent summary`:
|
|
8
|
-
*
|
|
9
|
-
*
|
|
7
|
+
* `kosuke agent summary`: which providers and integrations are connected and what is
|
|
8
|
+
* New, in a few dozen lines an agent reads at the start of a conversation. What waits
|
|
9
|
+
* on the member is a Sensei card, which `kosuke sensei cards list` reads. Kept to about 1,500 tokens: each list is capped and names the
|
|
10
10
|
* command that reads the rest, and it claims only as many events as the other
|
|
11
11
|
* lines leave room for.
|
|
12
12
|
*/
|
|
@@ -21,7 +21,6 @@ const PROVIDERS_TIMEOUT_MS = 4000;
|
|
|
21
21
|
* platform must cost the digest this section, never the digest.
|
|
22
22
|
*/
|
|
23
23
|
const INTEGRATIONS_TIMEOUT_MS = 3000;
|
|
24
|
-
const NEEDS_YOU_SHOWN = 5;
|
|
25
24
|
/** Connections listed before "and N more"; a member's own seven fit. */
|
|
26
25
|
const INTEGRATIONS_SHOWN = 8;
|
|
27
26
|
/** However much room is left: past this, the digest stops being a glance. */
|
|
@@ -35,18 +34,18 @@ const BUDGET_CHARS = 4500;
|
|
|
35
34
|
const ACTIVITY_FRAME_CHARS = 150;
|
|
36
35
|
// Caps on the words, never on the URL: a clipped URL opens nothing, and a
|
|
37
36
|
// preview origin alone can take most of a line.
|
|
38
|
-
const TITLE_MAX = 90;
|
|
39
37
|
const TEXT_MAX = 140;
|
|
40
38
|
const NAME_MAX = 40;
|
|
41
39
|
/** `/projects/<uuid>/chat-sessions?session=<uuid>`, or a Backlog ticket's path, which is longer. */
|
|
42
40
|
const SESSION_PATH_CHARS = 120;
|
|
43
41
|
/** Room for an origin longer than any the digest has seen, such as a preview's. */
|
|
44
42
|
const ORIGIN_CHARS_MIN = 64;
|
|
43
|
+
/**
|
|
44
|
+
* Reads the covered workspaces before the claim, so their line's length decides how many
|
|
45
|
+
* events fit. A peek of one: it marks nothing seen.
|
|
46
|
+
*/
|
|
45
47
|
// `satisfies`, so a query key the schema renames fails here, not at run time.
|
|
46
|
-
const
|
|
47
|
-
...NEEDS_YOU_FILTER,
|
|
48
|
-
limit: NEEDS_YOU_SHOWN,
|
|
49
|
-
};
|
|
48
|
+
const COVERAGE_QUERY = { unseen: true, limit: 1 };
|
|
50
49
|
const str = (value) => typeof value === 'string' && value.trim() ? value.trim() : null;
|
|
51
50
|
function rows(body) {
|
|
52
51
|
const list = body?.data;
|
|
@@ -63,26 +62,19 @@ function clip(text, max) {
|
|
|
63
62
|
/**
|
|
64
63
|
* The longest an event line can be, so the digest claims only events it has
|
|
65
64
|
* room to print whole. Its session URL starts with the app's origin, which
|
|
66
|
-
* the digest knows only from the API's
|
|
65
|
+
* the digest knows only from the API's.
|
|
67
66
|
*/
|
|
68
|
-
function eventLineMax(apiUrl
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
const url = Math.max(ORIGIN_CHARS_MIN, ...origins) + SESSION_PATH_CHARS;
|
|
67
|
+
function eventLineMax(apiUrl) {
|
|
68
|
+
let origin = 0;
|
|
69
|
+
try {
|
|
70
|
+
origin = new URL(apiUrl).origin.length;
|
|
71
|
+
}
|
|
72
|
+
catch {
|
|
73
|
+
// An unparsable API URL keeps the floor.
|
|
74
|
+
}
|
|
75
|
+
const url = Math.max(ORIGIN_CHARS_MIN, origin) + SESSION_PATH_CHARS;
|
|
78
76
|
return '- [/] '.length + 2 * NAME_MAX + TEXT_MAX + ', '.length + url;
|
|
79
77
|
}
|
|
80
|
-
/** `[workspace/project] title, reason, url`, one line per session. */
|
|
81
|
-
function sessionLine(row) {
|
|
82
|
-
const title = clip(str(row.title) ?? 'Untitled session', TITLE_MAX);
|
|
83
|
-
const reason = str(row.needsYouReason) ?? 'needs you';
|
|
84
|
-
return [`- ${where(row)} ${title}`, reason, str(row.url)].filter(Boolean).join(', ');
|
|
85
|
-
}
|
|
86
78
|
/** `[workspace/project] text: subject, url`, the same words Settings → Activity shows. */
|
|
87
79
|
function eventLine(event) {
|
|
88
80
|
const text = str(event.text) ?? str(event.kind) ?? 'Event';
|
|
@@ -290,8 +282,8 @@ function integrationLine(toolkit, connection) {
|
|
|
290
282
|
return `- ${clip(toolkit, NAME_MAX)}: ${connection.alias}, ${connection.scope}, "${label}", ${identity}`;
|
|
291
283
|
}
|
|
292
284
|
/** Never clipped: a workspace missing here would read as one the digest did not cover. */
|
|
293
|
-
function coverageLine(
|
|
294
|
-
const covered =
|
|
285
|
+
function coverageLine(read) {
|
|
286
|
+
const covered = read?.meta?.workspaces;
|
|
295
287
|
const names = Array.isArray(covered)
|
|
296
288
|
? covered.map((workspace) => str(workspace?.name)).filter((name) => name !== null)
|
|
297
289
|
: [];
|
|
@@ -299,32 +291,18 @@ function coverageLine(sessions) {
|
|
|
299
291
|
}
|
|
300
292
|
/** @internal */
|
|
301
293
|
export function planSummary(options) {
|
|
302
|
-
const {
|
|
294
|
+
const { covered, apiUrl, now, workspace, peek = false } = options;
|
|
303
295
|
const scope = workspace ? ` --workspace ${workspace}` : '';
|
|
304
296
|
const stamp = new Date(now).toISOString().slice(0, 16).replace('T', ' ') + ' UTC';
|
|
305
297
|
const head = [`Sensei summary, ${stamp}, ${apiUrl}`, ''];
|
|
306
|
-
const needing = rows(sessions);
|
|
307
|
-
const needTotal = paginationTotal(sessions) ?? needing.length;
|
|
308
|
-
if (needTotal === 0) {
|
|
309
|
-
head.push('No session needs you.');
|
|
310
|
-
}
|
|
311
|
-
else {
|
|
312
|
-
head.push(`${needTotal} session${needTotal === 1 ? ' needs' : 's need'} you:`);
|
|
313
|
-
const shown = needing.slice(0, NEEDS_YOU_SHOWN);
|
|
314
|
-
head.push(...shown.map(sessionLine));
|
|
315
|
-
if (needTotal > shown.length) {
|
|
316
|
-
head.push(`(and ${needTotal - shown.length} more: kosuke sessions list --needs-you --owners me${scope})`);
|
|
317
|
-
}
|
|
318
|
-
}
|
|
319
|
-
head.push('');
|
|
320
298
|
if (options.providers?.length)
|
|
321
299
|
head.push('Providers:', ...options.providers, '');
|
|
322
300
|
if (options.integrations?.length) {
|
|
323
301
|
head.push('Integrations (`kosuke integrations list` shows their tools):', ...options.integrations, '');
|
|
324
302
|
}
|
|
325
|
-
const coverage = coverageLine(
|
|
303
|
+
const coverage = coverageLine(covered);
|
|
326
304
|
const room = BUDGET_CHARS - head.join('\n').length - coverage.length - ACTIVITY_FRAME_CHARS - scope.length;
|
|
327
|
-
const lineMax = eventLineMax(apiUrl
|
|
305
|
+
const lineMax = eventLineMax(apiUrl);
|
|
328
306
|
const claim = Math.max(0, Math.min(EVENTS_SHOWN, Math.floor(room / (lineMax + 1))));
|
|
329
307
|
return {
|
|
330
308
|
head,
|
|
@@ -368,7 +346,7 @@ export function renderSummary(plan, activity) {
|
|
|
368
346
|
}
|
|
369
347
|
/**
|
|
370
348
|
* The whole digest, or one line saying why not, so the agent reading it
|
|
371
|
-
* knows to query the CLI itself.
|
|
349
|
+
* knows to query the CLI itself. The coverage, the providers and the integrations are read first:
|
|
372
350
|
* their lines decide how many events fit, and the Activity read marks events
|
|
373
351
|
* seen, so a digest that failed after it would lose them.
|
|
374
352
|
*/
|
|
@@ -383,17 +361,16 @@ export async function fetchSummary(options) {
|
|
|
383
361
|
const signal = AbortSignal.timeout(options.timeoutMs ?? SUMMARY_TIMEOUT_MS);
|
|
384
362
|
try {
|
|
385
363
|
const workspace = options.workspace ? { workspace: options.workspace } : {};
|
|
386
|
-
const [
|
|
387
|
-
client.GET('/api/
|
|
388
|
-
params: { query: { ...
|
|
364
|
+
const [coverage, providers, integrations] = await Promise.all([
|
|
365
|
+
client.GET('/api/activity', {
|
|
366
|
+
params: { query: { ...COVERAGE_QUERY, ...workspace } },
|
|
389
367
|
signal,
|
|
390
368
|
}),
|
|
391
369
|
fetchProviders(client, options.workspace, AbortSignal.any([signal, AbortSignal.timeout(PROVIDERS_TIMEOUT_MS)])),
|
|
392
370
|
fetchIntegrations(client, options.workspace, options.apiKey, AbortSignal.any([signal, AbortSignal.timeout(INTEGRATIONS_TIMEOUT_MS)])),
|
|
393
371
|
]);
|
|
394
|
-
const sessions = body(needsYou);
|
|
395
372
|
const plan = planSummary({
|
|
396
|
-
|
|
373
|
+
covered: body(coverage),
|
|
397
374
|
providers,
|
|
398
375
|
integrations,
|
|
399
376
|
apiUrl: options.apiUrl,
|
package/dist/commands/agent.js
CHANGED
|
@@ -5,7 +5,7 @@ export function attachAgentCommands(root, runtime, deps = {}) {
|
|
|
5
5
|
const { fetch, now, stdout = (line) => process.stdout.write(line + '\n') } = deps;
|
|
6
6
|
root.command('agent').description('What an agent reads about your Sensei account.');
|
|
7
7
|
leafAt(root, HAND_WRITTEN.agentSummaryGet.command)
|
|
8
|
-
.description('Print
|
|
8
|
+
.description('Print your connected providers and integrations and your oldest New Activity as a short digest for an agent to read. ' +
|
|
9
9
|
'Marks seen only the events it prints, and none with --peek; the rest stay New.')
|
|
10
10
|
.option('--workspace <id>', 'Only this workspace.')
|
|
11
11
|
.option('--peek', 'Print the events without marking them seen.')
|
|
@@ -48,7 +48,7 @@ export const operation = {
|
|
|
48
48
|
"flag": "kind",
|
|
49
49
|
"kind": "string",
|
|
50
50
|
"required": false,
|
|
51
|
-
"description": "Comma-separated kinds (job_awaiting_response, pr_checks_failed, pr_checks_passed, main_checks_failed, main_checks_passed, pr_merged, branch_behind,
|
|
51
|
+
"description": "Comma-separated kinds (job_awaiting_response, pr_checks_failed, pr_checks_passed, main_checks_failed, main_checks_passed, pr_merged, branch_behind, cron_run_succeeded, cron_run_failed, deployed, recovery_deploy_started, workspace_device_disconnected, session_started, session_message_sent, session_archived, session_deleted, session_assigned, session_status_changed, session_priority_changed, cron_created, cron_updated, cron_deleted, member_invited, member_removed, member_role_changed, integration_custom_tool_saved, integration_custom_tool_enabled, integration_custom_tool_disabled, integration_custom_tool_deleted, integration_custom_tool_restored), or 'change' for every Change and 'action' for every Member Action."
|
|
52
52
|
},
|
|
53
53
|
{
|
|
54
54
|
"name": "limit",
|
|
@@ -6,7 +6,7 @@ export const operation = {
|
|
|
6
6
|
"batch-merging",
|
|
7
7
|
"finish"
|
|
8
8
|
],
|
|
9
|
-
"summary": "The running Batch's own session only: end the Batch with nothing to merge, when it left every pull request out or failed on its own work. The platform starts no Batch for the same ready pull requests for an hour, or until one changes. A Batch whose pull request merges or closes ends on its own.",
|
|
9
|
+
"summary": "The running Batch's own session only: end the Batch with nothing to merge, when it left every pull request out or failed on its own work. The platform starts no Batch for the same ready pull requests for an hour, or until one changes. Kosuke then closes the Batch's pull request with a comment giving the reason, which archives its session. A Batch whose pull request merges or closes ends on its own.",
|
|
10
10
|
"pathParams": [
|
|
11
11
|
"projectId"
|
|
12
12
|
],
|
|
@@ -7,7 +7,7 @@ export const operation = {
|
|
|
7
7
|
"picks",
|
|
8
8
|
"set"
|
|
9
9
|
],
|
|
10
|
-
"summary": "The open Batch's own session only
|
|
10
|
+
"summary": "The open Batch's own session only: replace the list of task pull requests merged into its branch. Their tasks show the Batch while it runs, and stop once it ends. Safe to repeat.",
|
|
11
11
|
"pathParams": [
|
|
12
12
|
"projectId"
|
|
13
13
|
],
|
|
@@ -6,7 +6,7 @@ export const operation = {
|
|
|
6
6
|
"cards",
|
|
7
7
|
"set"
|
|
8
8
|
],
|
|
9
|
-
"summary": "Open a card in your Turn's own thread, or update its open card with that key by passing the revision you read. Refused when the card moved, closed or is being sent, when your Turn stopped, when the session now lives in another thread (SESSION_MOVED), or when an id it names is not in the member's reach.",
|
|
9
|
+
"summary": "Open a card in your Turn's own thread, or update its open card with that key by passing the revision you read. Refused when the card moved, closed or is being sent, when your Turn stopped, when the session now lives in another thread (SESSION_MOVED), when the card has no primary (PRIMARY_REQUIRED: give it a verb, \"Ok\" when nothing follows), or when an id it names is not in the member's reach. The answer's warnings name what a written card misses (QA_REPORT_MISSING: a ready-, merge- or review- card with no qa_report block).",
|
|
10
10
|
"pathParams": [],
|
|
11
11
|
"query": [],
|
|
12
12
|
"body": {
|
|
@@ -68,7 +68,8 @@ export const operation = {
|
|
|
68
68
|
"name": "verb",
|
|
69
69
|
"flag": "verb",
|
|
70
70
|
"kind": "string",
|
|
71
|
-
"required": false
|
|
71
|
+
"required": false,
|
|
72
|
+
"description": "The primary button's label: one short word for what the tap does, such as \"Approve\", \"Fix\" or \"Merge\". Every card has a primary, this verb or one action with tone primary; a card without one is refused (PRIMARY_REQUIRED). When nothing follows the tap, the verb is \"Ok\": an Ok card with no instruction is an acknowledgement, needs no instruction, outcome or request, and its tap only closes the card, sending nothing to Sensei."
|
|
72
73
|
},
|
|
73
74
|
{
|
|
74
75
|
"name": "actions",
|
|
@@ -6,7 +6,7 @@ export const operation = {
|
|
|
6
6
|
"delegates",
|
|
7
7
|
"stop"
|
|
8
8
|
],
|
|
9
|
-
"summary": "Stop one of the member's delegates. A job stays stopped until the member redirects it or you note it
|
|
9
|
+
"summary": "Stop one of the member's delegates. A job stays stopped until the member redirects it or you note it.",
|
|
10
10
|
"pathParams": [
|
|
11
11
|
"delegateId"
|
|
12
12
|
],
|
|
@@ -6,7 +6,7 @@ export const operation = {
|
|
|
6
6
|
"messages",
|
|
7
7
|
"reply"
|
|
8
8
|
],
|
|
9
|
-
"summary": "Pass your member's reply to a
|
|
9
|
+
"summary": "Pass your member's reply to a message card back to the teammate, session or Cron who sent it, when the words are meant for them. It updates the answer that teammate already got for the message, so their answer card quotes the words instead of saying your member replied to their Sensei; a session is woken with the words, and a Cron's next run reads them. messageId is the message's identity and replyId the reply's id, as the reply's note names them. The same words again write nothing. Only the Turn of your member's reply sends one, for the card that reply decided. Refused with 404 when this Turn carries no reply with that replyId to the message with that messageId, and with 409 ANSWER_CHANGED when your member decided the message again since the reply. Answers the answer's id, revision, updated and the sender: memberId, sessionId or cronId, with its name.",
|
|
10
10
|
"pathParams": [],
|
|
11
11
|
"query": [],
|
|
12
12
|
"body": {
|
|
@@ -6,7 +6,7 @@ export const operation = {
|
|
|
6
6
|
"messages",
|
|
7
7
|
"send"
|
|
8
8
|
],
|
|
9
|
-
"summary": "Send a message to a member's Sensei. Any sender can: you, your Sensei, a Cron Run, or a
|
|
9
|
+
"summary": "Send a message to a member's Sensei. Any sender can: you, your Sensei, a Cron Run, a session's agent, or a project's deploy agent; the sender is read from the credential. Their Sensei shows it on a card that says who sent it, with the action that fits, and they are notified as for any card. Name the project with projectId, and optionally the Chat Session (sessionId) or pull request (pullRequest, with projectId) it is about; a sessionId alone names its project. memberId is required: the id a Member mention carries or `kosuke workspaces members list` prints, never a guess between members who share a name. key is a slug such as merge-plan, ticket-<slug> or qa-guide, and text, up to 60,000 characters, is everything the member needs, so it can hold a ticket prompt or a whole Project QA Guide. title, why (one line: why this member), paths (the repository paths it is about) and link (a Sensei path starting with / or an https URL the card opens) are optional. The same key with new text or a new link updates the open card and raises the revision; the same again writes nothing. Pass ifRevision, the revision an earlier send answered, to be refused with MESSAGE_CHANGED when it moved on. When a member sent it, the recipient's approve, edit, reject or reply comes back to the thread it was sent from. Answers id, revision, updated and the recipient: say who it went to. Keys and text by kind: ticket-<slug of the title>, whose text is \"File the ticket <title> in <project>'s Backlog.\" then the reason and the description; start-<slug>, only for an unassigned or the member's own ticket while nothing of theirs builds or waits on them; delete-<slug> with its evidence; merge-<slug> with the merged text and each task's promptRevision; cron-<slug> with its prompt, crontab and projects; merge-plan with each pull request's number, head SHA and action. Before a ticket message, read the open tasks (`tasks list --include-prompt`): send nothing for work a session already covers, and name the Todo task that covers part of it in text. A 400 VALIDATION_ERROR wrote nothing: fix the fields in details and send again with the same key and memberId. Any other refusal is final: send to nobody else instead. An unknown outcome (a timeout, a 5xx) is never sent again. Pass the body with --body or --body-file.",
|
|
10
10
|
"pathParams": [],
|
|
11
11
|
"query": [],
|
|
12
12
|
"body": {
|
|
@@ -8,7 +8,7 @@ export const operation = {
|
|
|
8
8
|
"variant": {
|
|
9
9
|
"scope": "all"
|
|
10
10
|
},
|
|
11
|
-
"summary": "List chat sessions across every workspace you belong to, each with its workspace, project
|
|
11
|
+
"summary": "List chat sessions across every workspace you belong to, each with its workspace, project and URL. q narrows them to titles containing it, ids to the sessions it names. Merge agent run sessions are left out unless includeMergeAgentRuns=true or ids names them. An agent token reads its own workspace only. Each session carries waitingForDeploy: true while it waits for the Deploy to finish, false once the Deploy ends, before its sandbox starts; goAheadSha, the head its open pull request has the go-ahead on; and mergeRule, its Assignee's Merge rule.",
|
|
12
12
|
"pathParams": [],
|
|
13
13
|
"query": [
|
|
14
14
|
{
|
|
@@ -28,6 +28,13 @@ export const operation = {
|
|
|
28
28
|
"required": false,
|
|
29
29
|
"description": "Add prompt to each session: its first user message, cut to the first 4,000 characters (code points), or null when it has none. promptTruncated says whether it was cut."
|
|
30
30
|
},
|
|
31
|
+
{
|
|
32
|
+
"name": "includeMergeAgentRuns",
|
|
33
|
+
"flag": "include-merge-agent-runs",
|
|
34
|
+
"kind": "boolean",
|
|
35
|
+
"required": false,
|
|
36
|
+
"description": "Keep the Merge agent's run sessions (Batches and Merge train runs), which only its panel lists by default."
|
|
37
|
+
},
|
|
31
38
|
{
|
|
32
39
|
"name": "completedSince",
|
|
33
40
|
"flag": "completed-since",
|
|
@@ -69,23 +76,6 @@ export const operation = {
|
|
|
69
76
|
"required": false,
|
|
70
77
|
"description": "Comma-separated session ids, at most 100: only these sessions, under the other filters. Archived ones need includeArchived. Any value that is not an id is rejected."
|
|
71
78
|
},
|
|
72
|
-
{
|
|
73
|
-
"name": "needsYou",
|
|
74
|
-
"flag": "needs-you",
|
|
75
|
-
"kind": "boolean",
|
|
76
|
-
"required": false,
|
|
77
|
-
"description": "Only sessions blocked on a person: at most 100, most severe reason first (checks_failed, turn_failed, awaiting_response, ship_stop, ready_to_merge, review_not_requested, awaiting_approval, conflicts, behind, stale_pr), as on Home. Never paged: meta.pagination.total counts them all, and --workspace or --project narrows the list."
|
|
78
|
-
},
|
|
79
|
-
{
|
|
80
|
-
"name": "viewer",
|
|
81
|
-
"flag": "viewer",
|
|
82
|
-
"kind": "string",
|
|
83
|
-
"required": false,
|
|
84
|
-
"description": "'me' reads Needs You for you, as Home does: your own sessions' reasons, and awaiting_approval on the pull requests that ask you for a review, which --owners then lets through whoever they belong to. Without it every reason is read for the session's Assignee.",
|
|
85
|
-
"choices": [
|
|
86
|
-
"me"
|
|
87
|
-
]
|
|
88
|
-
},
|
|
89
79
|
{
|
|
90
80
|
"name": "status",
|
|
91
81
|
"flag": "status",
|
|
@@ -112,7 +102,7 @@ export const operation = {
|
|
|
112
102
|
"flag": "q",
|
|
113
103
|
"kind": "string",
|
|
114
104
|
"required": false,
|
|
115
|
-
"description": "Sessions whose title contains this text, or App chats whose project name matches (spaces and hyphens are equivalent). Case-insensitive and trimmed. Narrows the count and every page
|
|
105
|
+
"description": "Sessions whose title contains this text, or App chats whose project name matches (spaces and hyphens are equivalent). Case-insensitive and trimmed. Narrows the count and every page."
|
|
116
106
|
},
|
|
117
107
|
{
|
|
118
108
|
"name": "createdBy",
|
|
@@ -137,7 +127,7 @@ export const operation = {
|
|
|
137
127
|
"flag": "limit",
|
|
138
128
|
"kind": "integer",
|
|
139
129
|
"required": false,
|
|
140
|
-
"description": "Page size, 50 by default
|
|
130
|
+
"description": "Page size, 50 by default. Values above 100 are clamped, not rejected."
|
|
141
131
|
},
|
|
142
132
|
{
|
|
143
133
|
"name": "cursor",
|
|
@@ -5,7 +5,7 @@ export const operation = {
|
|
|
5
5
|
"sessions",
|
|
6
6
|
"list"
|
|
7
7
|
],
|
|
8
|
-
"summary": "List chat sessions. Without limit the whole list comes back as data; with it, one page plus meta.pagination. status, priorities and owners are comma-separated strings. Each session carries waitingForDeploy: true while it waits for the Deploy to finish, false once the Deploy ends, before its sandbox starts.",
|
|
8
|
+
"summary": "List chat sessions. Without limit the whole list comes back as data; with it, one page plus meta.pagination. status, priorities and owners are comma-separated strings. Merge agent run sessions are left out unless includeMergeAgentRuns=true. Each session carries waitingForDeploy: true while it waits for the Deploy to finish, false once the Deploy ends, before its sandbox starts.",
|
|
9
9
|
"pathParams": [
|
|
10
10
|
"projectId"
|
|
11
11
|
],
|
|
@@ -120,6 +120,13 @@ export const operation = {
|
|
|
120
120
|
"kind": "boolean",
|
|
121
121
|
"required": false,
|
|
122
122
|
"description": "Add prompt to each session: its first user message, cut to the first 4,000 characters (code points), or null when it has none. promptTruncated says whether it was cut."
|
|
123
|
+
},
|
|
124
|
+
{
|
|
125
|
+
"name": "includeMergeAgentRuns",
|
|
126
|
+
"flag": "include-merge-agent-runs",
|
|
127
|
+
"kind": "boolean",
|
|
128
|
+
"required": false,
|
|
129
|
+
"description": "Keep the Merge agent's run sessions (Batches and Merge train runs), which only its panel lists by default."
|
|
123
130
|
}
|
|
124
131
|
],
|
|
125
132
|
"body": null,
|
|
@@ -5,7 +5,7 @@ export const operation = {
|
|
|
5
5
|
"sessions",
|
|
6
6
|
"send"
|
|
7
7
|
],
|
|
8
|
-
"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. Use it over steer only for attachments, a message that runs a skill, or text over 10,000 characters.",
|
|
8
|
+
"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. Use it over steer only for attachments, a message that runs a skill, or text over 10,000 characters. From Sensei, /kosuke:sync-branch is refused with 409 SYNC_OWNED_BY_MERGE_AGENT when the project is on Batch merging, or on the merge train and the pull request has the go-ahead, unless a member started the Turn: the merge agent syncs those.",
|
|
9
9
|
"pathParams": [
|
|
10
10
|
"projectId",
|
|
11
11
|
"sessionId"
|
|
@@ -5,7 +5,7 @@ export const operation = {
|
|
|
5
5
|
"sessions",
|
|
6
6
|
"steer"
|
|
7
7
|
],
|
|
8
|
-
"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). Use it for plain text up to 10,000 characters; on queued or refused, say where the message is.",
|
|
8
|
+
"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). Use it for plain text up to 10,000 characters; on queued or refused, say where the message is. From Sensei, /kosuke:sync-branch is refused with 409 SYNC_OWNED_BY_MERGE_AGENT when the project is on Batch merging, or on the merge train and the pull request has the go-ahead, unless a member started the Turn: the merge agent syncs those.",
|
|
9
9
|
"pathParams": [
|
|
10
10
|
"projectId",
|
|
11
11
|
"sessionId"
|
|
@@ -105,13 +105,6 @@ export const operation = {
|
|
|
105
105
|
"desc"
|
|
106
106
|
]
|
|
107
107
|
},
|
|
108
|
-
{
|
|
109
|
-
"name": "needsYou",
|
|
110
|
-
"flag": "needs-you",
|
|
111
|
-
"kind": "boolean",
|
|
112
|
-
"required": false,
|
|
113
|
-
"description": "Only tasks whose Chat Session needs the viewer."
|
|
114
|
-
},
|
|
115
108
|
{
|
|
116
109
|
"name": "includePrompt",
|
|
117
110
|
"flag": "include-prompt",
|
|
@@ -106,13 +106,6 @@ export const operation = {
|
|
|
106
106
|
"desc"
|
|
107
107
|
]
|
|
108
108
|
},
|
|
109
|
-
{
|
|
110
|
-
"name": "needsYou",
|
|
111
|
-
"flag": "needs-you",
|
|
112
|
-
"kind": "boolean",
|
|
113
|
-
"required": false,
|
|
114
|
-
"description": "Only tasks whose Chat Session needs the viewer."
|
|
115
|
-
},
|
|
116
109
|
{
|
|
117
110
|
"name": "includePrompt",
|
|
118
111
|
"flag": "include-prompt",
|
|
@@ -104,13 +104,6 @@ export const operation = {
|
|
|
104
104
|
"desc"
|
|
105
105
|
]
|
|
106
106
|
},
|
|
107
|
-
{
|
|
108
|
-
"name": "needsYou",
|
|
109
|
-
"flag": "needs-you",
|
|
110
|
-
"kind": "boolean",
|
|
111
|
-
"required": false,
|
|
112
|
-
"description": "Only tasks whose Chat Session needs the viewer."
|
|
113
|
-
},
|
|
114
107
|
{
|
|
115
108
|
"name": "includePrompt",
|
|
116
109
|
"flag": "include-prompt",
|
package/openapi.json
CHANGED
|
@@ -77,9 +77,9 @@
|
|
|
77
77
|
"name": "kind",
|
|
78
78
|
"in": "query",
|
|
79
79
|
"required": false,
|
|
80
|
-
"description": "Comma-separated kinds (job_awaiting_response, pr_checks_failed, pr_checks_passed, main_checks_failed, main_checks_passed, pr_merged, branch_behind,
|
|
80
|
+
"description": "Comma-separated kinds (job_awaiting_response, pr_checks_failed, pr_checks_passed, main_checks_failed, main_checks_passed, pr_merged, branch_behind, cron_run_succeeded, cron_run_failed, deployed, recovery_deploy_started, workspace_device_disconnected, session_started, session_message_sent, session_archived, session_deleted, session_assigned, session_status_changed, session_priority_changed, cron_created, cron_updated, cron_deleted, member_invited, member_removed, member_role_changed, integration_custom_tool_saved, integration_custom_tool_enabled, integration_custom_tool_disabled, integration_custom_tool_deleted, integration_custom_tool_restored), or 'change' for every Change and 'action' for every Member Action.",
|
|
81
81
|
"schema": {
|
|
82
|
-
"description": "Comma-separated kinds (job_awaiting_response, pr_checks_failed, pr_checks_passed, main_checks_failed, main_checks_passed, pr_merged, branch_behind,
|
|
82
|
+
"description": "Comma-separated kinds (job_awaiting_response, pr_checks_failed, pr_checks_passed, main_checks_failed, main_checks_passed, pr_merged, branch_behind, cron_run_succeeded, cron_run_failed, deployed, recovery_deploy_started, workspace_device_disconnected, session_started, session_message_sent, session_archived, session_deleted, session_assigned, session_status_changed, session_priority_changed, cron_created, cron_updated, cron_deleted, member_invited, member_removed, member_role_changed, integration_custom_tool_saved, integration_custom_tool_enabled, integration_custom_tool_disabled, integration_custom_tool_deleted, integration_custom_tool_restored), or 'change' for every Change and 'action' for every Member Action.",
|
|
83
83
|
"type": "string"
|
|
84
84
|
}
|
|
85
85
|
},
|
|
@@ -550,7 +550,7 @@
|
|
|
550
550
|
"/api/chat-sessions": {
|
|
551
551
|
"get": {
|
|
552
552
|
"operationId": "sessionsListAll",
|
|
553
|
-
"summary": "List chat sessions across every workspace you belong to, each with its workspace, project
|
|
553
|
+
"summary": "List chat sessions across every workspace you belong to, each with its workspace, project and URL. q narrows them to titles containing it, ids to the sessions it names. Merge agent run sessions are left out unless includeMergeAgentRuns=true or ids names them. An agent token reads its own workspace only. Each session carries waitingForDeploy: true while it waits for the Deploy to finish, false once the Deploy ends, before its sandbox starts; goAheadSha, the head its open pull request has the go-ahead on; and mergeRule, its Assignee's Merge rule.",
|
|
554
554
|
"tags": ["sessions"],
|
|
555
555
|
"x-kosuke-command": ["sessions", "list"],
|
|
556
556
|
"x-kosuke-variant": {
|
|
@@ -581,6 +581,16 @@
|
|
|
581
581
|
"type": "boolean"
|
|
582
582
|
}
|
|
583
583
|
},
|
|
584
|
+
{
|
|
585
|
+
"name": "includeMergeAgentRuns",
|
|
586
|
+
"in": "query",
|
|
587
|
+
"required": false,
|
|
588
|
+
"description": "Keep the Merge agent's run sessions (Batches and Merge train runs), which only its panel lists by default.",
|
|
589
|
+
"schema": {
|
|
590
|
+
"description": "Keep the Merge agent's run sessions (Batches and Merge train runs), which only its panel lists by default.",
|
|
591
|
+
"type": "boolean"
|
|
592
|
+
}
|
|
593
|
+
},
|
|
584
594
|
{
|
|
585
595
|
"name": "completedSince",
|
|
586
596
|
"in": "query",
|
|
@@ -643,27 +653,6 @@
|
|
|
643
653
|
"type": "string"
|
|
644
654
|
}
|
|
645
655
|
},
|
|
646
|
-
{
|
|
647
|
-
"name": "needsYou",
|
|
648
|
-
"in": "query",
|
|
649
|
-
"required": false,
|
|
650
|
-
"description": "Only sessions blocked on a person: at most 100, most severe reason first (checks_failed, turn_failed, awaiting_response, ship_stop, ready_to_merge, review_not_requested, awaiting_approval, conflicts, behind, stale_pr), as on Home. Never paged: meta.pagination.total counts them all, and --workspace or --project narrows the list.",
|
|
651
|
-
"schema": {
|
|
652
|
-
"description": "Only sessions blocked on a person: at most 100, most severe reason first (checks_failed, turn_failed, awaiting_response, ship_stop, ready_to_merge, review_not_requested, awaiting_approval, conflicts, behind, stale_pr), as on Home. Never paged: meta.pagination.total counts them all, and --workspace or --project narrows the list.",
|
|
653
|
-
"type": "boolean"
|
|
654
|
-
}
|
|
655
|
-
},
|
|
656
|
-
{
|
|
657
|
-
"name": "viewer",
|
|
658
|
-
"in": "query",
|
|
659
|
-
"required": false,
|
|
660
|
-
"description": "'me' reads Needs You for you, as Home does: your own sessions' reasons, and awaiting_approval on the pull requests that ask you for a review, which --owners then lets through whoever they belong to. Without it every reason is read for the session's Assignee.",
|
|
661
|
-
"schema": {
|
|
662
|
-
"description": "'me' reads Needs You for you, as Home does: your own sessions' reasons, and awaiting_approval on the pull requests that ask you for a review, which --owners then lets through whoever they belong to. Without it every reason is read for the session's Assignee.",
|
|
663
|
-
"type": "string",
|
|
664
|
-
"enum": ["me"]
|
|
665
|
-
}
|
|
666
|
-
},
|
|
667
656
|
{
|
|
668
657
|
"name": "status",
|
|
669
658
|
"in": "query",
|
|
@@ -698,9 +687,9 @@
|
|
|
698
687
|
"name": "q",
|
|
699
688
|
"in": "query",
|
|
700
689
|
"required": false,
|
|
701
|
-
"description": "Sessions whose title contains this text, or App chats whose project name matches (spaces and hyphens are equivalent). Case-insensitive and trimmed. Narrows the count and every page
|
|
690
|
+
"description": "Sessions whose title contains this text, or App chats whose project name matches (spaces and hyphens are equivalent). Case-insensitive and trimmed. Narrows the count and every page.",
|
|
702
691
|
"schema": {
|
|
703
|
-
"description": "Sessions whose title contains this text, or App chats whose project name matches (spaces and hyphens are equivalent). Case-insensitive and trimmed. Narrows the count and every page
|
|
692
|
+
"description": "Sessions whose title contains this text, or App chats whose project name matches (spaces and hyphens are equivalent). Case-insensitive and trimmed. Narrows the count and every page.",
|
|
704
693
|
"type": "string"
|
|
705
694
|
}
|
|
706
695
|
},
|
|
@@ -729,9 +718,9 @@
|
|
|
729
718
|
"name": "limit",
|
|
730
719
|
"in": "query",
|
|
731
720
|
"required": false,
|
|
732
|
-
"description": "Page size, 50 by default
|
|
721
|
+
"description": "Page size, 50 by default. Values above 100 are clamped, not rejected.",
|
|
733
722
|
"schema": {
|
|
734
|
-
"description": "Page size, 50 by default
|
|
723
|
+
"description": "Page size, 50 by default. Values above 100 are clamped, not rejected.",
|
|
735
724
|
"type": "integer",
|
|
736
725
|
"minimum": 1,
|
|
737
726
|
"maximum": 9007199254740991
|
|
@@ -8327,16 +8316,6 @@
|
|
|
8327
8316
|
"enum": ["asc", "desc"]
|
|
8328
8317
|
}
|
|
8329
8318
|
},
|
|
8330
|
-
{
|
|
8331
|
-
"name": "needsYou",
|
|
8332
|
-
"in": "query",
|
|
8333
|
-
"required": false,
|
|
8334
|
-
"description": "Only tasks whose Chat Session needs the viewer.",
|
|
8335
|
-
"schema": {
|
|
8336
|
-
"description": "Only tasks whose Chat Session needs the viewer.",
|
|
8337
|
-
"type": "boolean"
|
|
8338
|
-
}
|
|
8339
|
-
},
|
|
8340
8319
|
{
|
|
8341
8320
|
"name": "includePrompt",
|
|
8342
8321
|
"in": "query",
|
|
@@ -10705,7 +10684,7 @@
|
|
|
10705
10684
|
"/api/projects/{projectId}/batch-merging/finish": {
|
|
10706
10685
|
"post": {
|
|
10707
10686
|
"operationId": "projectsBatchMergingFinish",
|
|
10708
|
-
"summary": "The running Batch's own session only: end the Batch with nothing to merge, when it left every pull request out or failed on its own work. The platform starts no Batch for the same ready pull requests for an hour, or until one changes. A Batch whose pull request merges or closes ends on its own.",
|
|
10687
|
+
"summary": "The running Batch's own session only: end the Batch with nothing to merge, when it left every pull request out or failed on its own work. The platform starts no Batch for the same ready pull requests for an hour, or until one changes. Kosuke then closes the Batch's pull request with a comment giving the reason, which archives its session. A Batch whose pull request merges or closes ends on its own.",
|
|
10709
10688
|
"tags": ["projects"],
|
|
10710
10689
|
"x-kosuke-command": ["projects", "batch-merging", "finish"],
|
|
10711
10690
|
"x-kosuke-sandbox-token": true,
|
|
@@ -10853,7 +10832,7 @@
|
|
|
10853
10832
|
"/api/projects/{projectId}/batch-merging/picks": {
|
|
10854
10833
|
"put": {
|
|
10855
10834
|
"operationId": "projectsBatchMergingPicksSet",
|
|
10856
|
-
"summary": "The open Batch's own session only
|
|
10835
|
+
"summary": "The open Batch's own session only: replace the list of task pull requests merged into its branch. Their tasks show the Batch while it runs, and stop once it ends. Safe to repeat.",
|
|
10857
10836
|
"tags": ["projects"],
|
|
10858
10837
|
"x-kosuke-command": ["projects", "batch-merging", "picks", "set"],
|
|
10859
10838
|
"x-kosuke-sandbox-token": true,
|
|
@@ -11004,7 +10983,7 @@
|
|
|
11004
10983
|
"/api/projects/{projectId}/chat-sessions": {
|
|
11005
10984
|
"get": {
|
|
11006
10985
|
"operationId": "sessionsList",
|
|
11007
|
-
"summary": "List chat sessions. Without limit the whole list comes back as data; with it, one page plus meta.pagination. status, priorities and owners are comma-separated strings. Each session carries waitingForDeploy: true while it waits for the Deploy to finish, false once the Deploy ends, before its sandbox starts.",
|
|
10986
|
+
"summary": "List chat sessions. Without limit the whole list comes back as data; with it, one page plus meta.pagination. status, priorities and owners are comma-separated strings. Merge agent run sessions are left out unless includeMergeAgentRuns=true. Each session carries waitingForDeploy: true while it waits for the Deploy to finish, false once the Deploy ends, before its sandbox starts.",
|
|
11008
10987
|
"tags": ["sessions"],
|
|
11009
10988
|
"x-kosuke-command": ["sessions", "list"],
|
|
11010
10989
|
"x-kosuke-sandbox-token": true,
|
|
@@ -11165,6 +11144,16 @@
|
|
|
11165
11144
|
"description": "Add prompt to each session: its first user message, cut to the first 4,000 characters (code points), or null when it has none. promptTruncated says whether it was cut.",
|
|
11166
11145
|
"type": "boolean"
|
|
11167
11146
|
}
|
|
11147
|
+
},
|
|
11148
|
+
{
|
|
11149
|
+
"name": "includeMergeAgentRuns",
|
|
11150
|
+
"in": "query",
|
|
11151
|
+
"required": false,
|
|
11152
|
+
"description": "Keep the Merge agent's run sessions (Batches and Merge train runs), which only its panel lists by default.",
|
|
11153
|
+
"schema": {
|
|
11154
|
+
"description": "Keep the Merge agent's run sessions (Batches and Merge train runs), which only its panel lists by default.",
|
|
11155
|
+
"type": "boolean"
|
|
11156
|
+
}
|
|
11168
11157
|
}
|
|
11169
11158
|
],
|
|
11170
11159
|
"responses": {
|
|
@@ -12528,7 +12517,7 @@
|
|
|
12528
12517
|
},
|
|
12529
12518
|
"post": {
|
|
12530
12519
|
"operationId": "sessionsSend",
|
|
12531
|
-
"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. Use it over steer only for attachments, a message that runs a skill, or text over 10,000 characters.",
|
|
12520
|
+
"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. Use it over steer only for attachments, a message that runs a skill, or text over 10,000 characters. From Sensei, /kosuke:sync-branch is refused with 409 SYNC_OWNED_BY_MERGE_AGENT when the project is on Batch merging, or on the merge train and the pull request has the go-ahead, unless a member started the Turn: the merge agent syncs those.",
|
|
12532
12521
|
"tags": ["sessions"],
|
|
12533
12522
|
"x-kosuke-command": ["sessions", "send"],
|
|
12534
12523
|
"x-kosuke-attachments": true,
|
|
@@ -16414,7 +16403,7 @@
|
|
|
16414
16403
|
"/api/projects/{projectId}/chat-sessions/{sessionId}/steer": {
|
|
16415
16404
|
"post": {
|
|
16416
16405
|
"operationId": "sessionsSteer",
|
|
16417
|
-
"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). Use it for plain text up to 10,000 characters; on queued or refused, say where the message is.",
|
|
16406
|
+
"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). Use it for plain text up to 10,000 characters; on queued or refused, say where the message is. From Sensei, /kosuke:sync-branch is refused with 409 SYNC_OWNED_BY_MERGE_AGENT when the project is on Batch merging, or on the merge train and the pull request has the go-ahead, unless a member started the Turn: the merge agent syncs those.",
|
|
16418
16407
|
"tags": ["sessions"],
|
|
16419
16408
|
"x-kosuke-command": ["sessions", "steer"],
|
|
16420
16409
|
"x-kosuke-sandbox-token": true,
|
|
@@ -20706,7 +20695,7 @@
|
|
|
20706
20695
|
},
|
|
20707
20696
|
"post": {
|
|
20708
20697
|
"operationId": "senseiCardsSet",
|
|
20709
|
-
"summary": "Open a card in your Turn's own thread, or update its open card with that key by passing the revision you read. Refused when the card moved, closed or is being sent, when your Turn stopped, when the session now lives in another thread (SESSION_MOVED), or when an id it names is not in the member's reach.",
|
|
20698
|
+
"summary": "Open a card in your Turn's own thread, or update its open card with that key by passing the revision you read. Refused when the card moved, closed or is being sent, when your Turn stopped, when the session now lives in another thread (SESSION_MOVED), when the card has no primary (PRIMARY_REQUIRED: give it a verb, \"Ok\" when nothing follows), or when an id it names is not in the member's reach. The answer's warnings name what a written card misses (QA_REPORT_MISSING: a ready-, merge- or review- card with no qa_report block).",
|
|
20710
20699
|
"tags": ["sensei"],
|
|
20711
20700
|
"x-kosuke-command": ["sensei", "cards", "set"],
|
|
20712
20701
|
"x-kosuke-sandbox-token": true,
|
|
@@ -21705,6 +21694,7 @@
|
|
|
21705
21694
|
"additionalProperties": false
|
|
21706
21695
|
},
|
|
21707
21696
|
"verb": {
|
|
21697
|
+
"description": "The primary button's label: one short word for what the tap does, such as \"Approve\", \"Fix\" or \"Merge\". Every card has a primary, this verb or one action with tone primary; a card without one is refused (PRIMARY_REQUIRED). When nothing follows the tap, the verb is \"Ok\": an Ok card with no instruction is an acknowledgement, needs no instruction, outcome or request, and its tap only closes the card, sending nothing to Sensei.",
|
|
21708
21698
|
"type": "string",
|
|
21709
21699
|
"minLength": 1,
|
|
21710
21700
|
"maxLength": 32
|
|
@@ -23022,7 +23012,7 @@
|
|
|
23022
23012
|
"/api/sensei/delegates/{delegateId}/stop": {
|
|
23023
23013
|
"post": {
|
|
23024
23014
|
"operationId": "senseiDelegatesStop",
|
|
23025
|
-
"summary": "Stop one of the member's delegates. A job stays stopped until the member redirects it or you note it
|
|
23015
|
+
"summary": "Stop one of the member's delegates. A job stays stopped until the member redirects it or you note it.",
|
|
23026
23016
|
"tags": ["sensei"],
|
|
23027
23017
|
"x-kosuke-command": ["sensei", "delegates", "stop"],
|
|
23028
23018
|
"x-kosuke-sandbox-token": true,
|
|
@@ -24029,7 +24019,7 @@
|
|
|
24029
24019
|
"/api/sensei/teammate-messages": {
|
|
24030
24020
|
"post": {
|
|
24031
24021
|
"operationId": "senseiMessagesSend",
|
|
24032
|
-
"summary": "Send a message to a member's Sensei. Any sender can: you, your Sensei, a Cron Run, or a
|
|
24022
|
+
"summary": "Send a message to a member's Sensei. Any sender can: you, your Sensei, a Cron Run, a session's agent, or a project's deploy agent; the sender is read from the credential. Their Sensei shows it on a card that says who sent it, with the action that fits, and they are notified as for any card. Name the project with projectId, and optionally the Chat Session (sessionId) or pull request (pullRequest, with projectId) it is about; a sessionId alone names its project. memberId is required: the id a Member mention carries or `kosuke workspaces members list` prints, never a guess between members who share a name. key is a slug such as merge-plan, ticket-<slug> or qa-guide, and text, up to 60,000 characters, is everything the member needs, so it can hold a ticket prompt or a whole Project QA Guide. title, why (one line: why this member), paths (the repository paths it is about) and link (a Sensei path starting with / or an https URL the card opens) are optional. The same key with new text or a new link updates the open card and raises the revision; the same again writes nothing. Pass ifRevision, the revision an earlier send answered, to be refused with MESSAGE_CHANGED when it moved on. When a member sent it, the recipient's approve, edit, reject or reply comes back to the thread it was sent from. Answers id, revision, updated and the recipient: say who it went to. Keys and text by kind: ticket-<slug of the title>, whose text is \"File the ticket <title> in <project>'s Backlog.\" then the reason and the description; start-<slug>, only for an unassigned or the member's own ticket while nothing of theirs builds or waits on them; delete-<slug> with its evidence; merge-<slug> with the merged text and each task's promptRevision; cron-<slug> with its prompt, crontab and projects; merge-plan with each pull request's number, head SHA and action. Before a ticket message, read the open tasks (`tasks list --include-prompt`): send nothing for work a session already covers, and name the Todo task that covers part of it in text. A 400 VALIDATION_ERROR wrote nothing: fix the fields in details and send again with the same key and memberId. Any other refusal is final: send to nobody else instead. An unknown outcome (a timeout, a 5xx) is never sent again. Pass the body with --body or --body-file.",
|
|
24033
24023
|
"tags": ["sensei"],
|
|
24034
24024
|
"x-kosuke-command": ["sensei", "messages", "send"],
|
|
24035
24025
|
"x-kosuke-sandbox-token": true,
|
|
@@ -24153,7 +24143,7 @@
|
|
|
24153
24143
|
"/api/sensei/teammate-messages/reply": {
|
|
24154
24144
|
"post": {
|
|
24155
24145
|
"operationId": "senseiMessagesReply",
|
|
24156
|
-
"summary": "Pass your member's reply to a
|
|
24146
|
+
"summary": "Pass your member's reply to a message card back to the teammate, session or Cron who sent it, when the words are meant for them. It updates the answer that teammate already got for the message, so their answer card quotes the words instead of saying your member replied to their Sensei; a session is woken with the words, and a Cron's next run reads them. messageId is the message's identity and replyId the reply's id, as the reply's note names them. The same words again write nothing. Only the Turn of your member's reply sends one, for the card that reply decided. Refused with 404 when this Turn carries no reply with that replyId to the message with that messageId, and with 409 ANSWER_CHANGED when your member decided the message again since the reply. Answers the answer's id, revision, updated and the sender: memberId, sessionId or cronId, with its name.",
|
|
24157
24147
|
"tags": ["sensei"],
|
|
24158
24148
|
"x-kosuke-command": ["sensei", "messages", "reply"],
|
|
24159
24149
|
"x-kosuke-sandbox-token": true,
|
|
@@ -25416,16 +25406,6 @@
|
|
|
25416
25406
|
"enum": ["asc", "desc"]
|
|
25417
25407
|
}
|
|
25418
25408
|
},
|
|
25419
|
-
{
|
|
25420
|
-
"name": "needsYou",
|
|
25421
|
-
"in": "query",
|
|
25422
|
-
"required": false,
|
|
25423
|
-
"description": "Only tasks whose Chat Session needs the viewer.",
|
|
25424
|
-
"schema": {
|
|
25425
|
-
"description": "Only tasks whose Chat Session needs the viewer.",
|
|
25426
|
-
"type": "boolean"
|
|
25427
|
-
}
|
|
25428
|
-
},
|
|
25429
25409
|
{
|
|
25430
25410
|
"name": "includePrompt",
|
|
25431
25411
|
"in": "query",
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@kosuke-ai/kosuke",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.66",
|
|
4
4
|
"description": "Sensei platform CLI. The client customers install to drive app.kosuke.ai from their own machine.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
@@ -43,10 +43,10 @@
|
|
|
43
43
|
"minimatch": "^11.0.1"
|
|
44
44
|
},
|
|
45
45
|
"kosukeRelease": {
|
|
46
|
-
"sourceCommit": "
|
|
47
|
-
"sourceIdentity": "
|
|
46
|
+
"sourceCommit": "2c5f022a6d8cb955f06f07c742d3596e6abef3bb",
|
|
47
|
+
"sourceIdentity": "b64191c6dae87a4dae05bdec909420b1cf4f90f038249d32e767dc1f276efdda",
|
|
48
48
|
"fragments": [
|
|
49
|
-
"
|
|
49
|
+
"sessions-list-drop-needs-you-8w3kfz.json"
|
|
50
50
|
]
|
|
51
51
|
}
|
|
52
52
|
}
|