@kosuke-ai/kosuke 1.0.12 → 1.0.14

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 1.0.14
+
+- `kosuke devices list` says whether another session or Sensei already uses each device, and `kosuke sensei device-requests list` says it for each pending request.
+- `kosuke tasks create` and `kosuke sessions create` take --branch: the session works on that existing branch.
+
+## 1.0.13
+
+- Update help text: Sensei deletes Backlog sessions, imports into Personal and reuses browser sign-ins in any Turn, whatever started it.
+
 ## 1.0.12
 
 - Add `kosuke user usage get`: what used your AI work, with calendar-day counts by work, repository and model.

package/dist/generated/commands/devices/list.js

@@ -5,7 +5,7 @@ export const operation = {
         "devices",
         "list"
     ],
-    "summary": "From a Chat Session: the devices it may ask for, the workspace's devices and the session member's own Macs, each with its id, kind, whether it is online, the tools it offers and this session's access: none, pending or approved. Pick an online device with the tools the test needs: a workspace device first, and the member's own Mac only when no workspace device fits, whatever the names or past approvals. Request one with `kosuke devices requests create` before any mac command, and use one only when the test truly needs a real Mac.",
+    "summary": "From a Chat Session: the devices it may ask for, the workspace's devices and the session member's own Macs, each with its id, kind, whether it is online, the tools it offers, this session's access: none, pending or approved, and occupied with occupiedBy (session or sensei) when someone else uses it now. Pick an online device with the tools the test needs: a workspace device first, and the member's own Mac only when no workspace device fits, whatever the names or past approvals. Of those, pick a free one, and ask for an occupied one only when no free device fits. Request one with `kosuke devices requests create` before any mac command, and use one only when the test truly needs a real Mac.",
     "pathParams": [],
     "query": [],
     "body": null,

package/dist/generated/commands/integrations/tools-call.js

@@ -7,7 +7,7 @@ export const operation = {
         "call"
     ],
     "hidden": true,
-    "summary": "Run one integration tool. An agent runs it for its own workspace, or on the member’s personal connection when that member started the turn. With an API key, name a workspace you belong to: the call runs only on your own personal connections, and one on a workspace connection is refused. The answer names the connection it ran on, or lists the connections to choose from when the call needs one. A tool failure answers 200 with isError true. Some integrations require an enabled workspace to be named. A Connector Token or a browser session is refused.",
+    "summary": "Run one integration tool. An agent runs it for its own workspace, or on the member’s personal connection in any of their Sensei Turns or a session turn that member started. With an API key, name a workspace you belong to: the call runs only on your own personal connections, and one on a workspace connection is refused. The answer names the connection it ran on, or lists the connections to choose from when the call needs one. A tool failure answers 200 with isError true. Some integrations require an enabled workspace to be named. A Connector Token or a browser session is refused.",
     "pathParams": [],
     "query": [
         {

package/dist/generated/commands/integrations/tools-list.js

@@ -7,7 +7,7 @@ export const operation = {
         "list"
     ],
     "hidden": true,
-    "summary": "List the integration tools you can run now, with the connections that run them. An agent reads its own workspace. With an API key, name a workspace you belong to: it shows that workspace’s connections and your own personal ones. Some integrations require an enabled workspace to be named. A Connector Token or a browser session is refused. Each toolkit is personal or workspace, never both. A personal connection reaches only a Turn its member started (in a workspace chat, only the session's Assignee); a workspace Cron, Deploy Chat, a Turn another member sent and unassigned work reach workspace connections only. In the Personal space the owner's own Turns reach both kinds.",
+    "summary": "List the integration tools you can run now, with the connections that run them. An agent reads its own workspace. With an API key, name a workspace you belong to: it shows that workspace’s connections and your own personal ones. Some integrations require an enabled workspace to be named. A Connector Token or a browser session is refused. Each toolkit is personal or workspace, never both. A personal connection reaches every Sensei Turn of its member, and a session turn its member started (in a workspace chat, only the session's Assignee); a workspace Cron, Deploy Chat, a Turn another member sent and unassigned work reach workspace connections only. In the Personal space the owner's own Turns reach both kinds.",
     "pathParams": [],
     "query": [
         {

package/dist/generated/commands/mac/browser-connections-list.js

@@ -7,7 +7,7 @@ export const operation = {
         "connections",
         "list"
     ],
-    "summary": "List the member's LinkedIn and X browser connections, oldest first: each is one account Sensei may act as, with its id, revision, account (null until Sensei fills it in), device (id, name, removed), profile (id, name), the last check (unchecked, connected, signed_out, other_account) with checkedAt, and connectThreadId, the only thread whose Turn may fill the account in. Pass its device id and profile id to every browser call for it. Only Sensei calls it, in a Turn the member's own message started.",
+    "summary": "List the member's LinkedIn and X browser connections, oldest first: each is one account Sensei may act as, with its id, revision, account (null until Sensei fills it in), device (id, name, removed), profile (id, name), the last check (unchecked, connected, signed_out, other_account) with checkedAt, and connectThreadId, the only thread whose Turn may fill the account in. Pass its device id and profile id to every browser call for it. Only Sensei calls it.",
     "pathParams": [],
     "query": [
         {

package/dist/generated/commands/mac/browser-connections-update.js

@@ -7,7 +7,7 @@ export const operation = {
         "connections",
         "update"
     ],
-    "summary": "Report what one check of the live page saw for a browser connection, with the revision `kosuke mac browser connections list` answered: connected with the account's name and handle, signed_out, or other_account with the name found. The first connected fills the account in, only from a Turn of its connectThreadId (else 403 NOT_CONNECT_THREAD); afterwards the handle must match it (else 409 ACCOUNT_MISMATCH). 409 STALE_REVISION after a newer Connect or Reconnect: read again. 404 once the member disconnected it. Only Sensei calls it, in a Turn the member's own message started.",
+    "summary": "Report what one check of the live page saw for a browser connection, with the revision `kosuke mac browser connections list` answered: connected with the account's name and handle, signed_out, or other_account with the name found. The first connected fills the account in, only from a Turn of its connectThreadId (else 403 NOT_CONNECT_THREAD); afterwards the handle must match it (else 409 ACCOUNT_MISMATCH). 409 STALE_REVISION after a newer Connect or Reconnect: read again. 404 once the member disconnected it. Only Sensei calls it.",
     "pathParams": [],
     "query": [],
     "body": {

package/dist/generated/commands/mac/browser-login.js

@@ -6,7 +6,7 @@ export const operation = {
         "browser",
         "login"
     ],
-    "summary": "Get a site signed in in this Sensei Thread's browser from the member's everyday Chrome: pass the browser call's profile and deviceId, and the site as a bare hostname (twitter.com is x.com; Google's sites are refused). --reuse picks up the sign-in that profile in their Chrome holds by itself, with no tap: only in a Turn the member's own message started, once per site and profile in a Turn, with the profile's exact ID. It never opens Chrome or waits for anyone, and answers opened false and signedIn false with chrome none (their Chrome holds no sign-in for the site, so nothing changed), same (the one this thread's browser already holds) or different (taken into this thread's browser, taken true). Then, unless it answered none or same, open the site with browser and check the account. On SIGN_IN_NEEDS_TAP or UPDATE_REQUIRED, put the sign-in card. A --reuse spends no tap, so it gives no card back. Every tapped mode (`sign-in`, `take`, `waitNew`) needs the member's tap on the sign-in card in this thread; `--forget` and `--reuse` need none. A sign-in takes the sign-in that profile in their Chrome holds when it differs from this thread's, without opening anything, and answers taken true, opened false and signedIn false, since the site has not confirmed it; or else it opens --url, or the site's page, in their Chrome and waits up to 8 minutes for the member to sign in. On LinkedIn and X it answers signedIn true and opened true. On any other site a change of the site's cookies is taken and answered taken true and signedIn false, since a change is not a sign-in, and an end with no change answers taken false; a desktop app too old to watch the site opens it and answers at once, with no taken. Every answer with taken true carries waitNewLeft: while it is above 0 and the site is still signed out, --wait-new (with the same --url), in the same Turn and with no new tap, waits for a newer sign-in, never taking the one taken already, and opens the site only when this Turn has not; once the tap's time has run out it fails with SIGN_IN_WINDOW_ENDED, and no card comes back. After the member's I'm signed in tap, --take takes that site's cookies, never Google's, and answers taken. --forget removes a sign-in this Turn took, a --reuse's included, for an account other than the one expected, and needs no tap. Each tap allows one call: a call without one, or a --wait-new that no take armed, fails with SIGN_IN_NEEDS_TAP. Then open the site with browser and check the account before account-specific work. On DEVICE_OFFLINE, TIMEOUT, SIGN_IN_TIMEOUT and KEYCHAIN_UNAVAILABLE Kosuke gives the member's card back by itself. Fails with SIGN_IN_TIMEOUT when Kosuke saw no new sign-in to LinkedIn or X within 8 minutes, PROFILE_DISCONNECTED for a profile turned off in Settings → Devices, KEYCHAIN_UNAVAILABLE when macOS did not let Kosuke read Chrome's sign-ins, STALE_TURN when the Turn stopped, and UPDATE_REQUIRED on a desktop app too old for it. Only Sensei calls it.",
+    "summary": "Get a site signed in in this Sensei Thread's browser from the member's everyday Chrome: pass the browser call's profile and deviceId, and the site as a bare hostname (twitter.com is x.com; Google's sites are refused). --reuse picks up the sign-in that profile in their Chrome holds by itself, with no tap: once per site and profile in a Turn, with the profile's exact ID. It never opens Chrome or waits for anyone, and answers opened false and signedIn false with chrome none (their Chrome holds no sign-in for the site, so nothing changed), same (the one this thread's browser already holds) or different (taken into this thread's browser, taken true). Then, unless it answered none or same, open the site with browser and check the account. On SIGN_IN_NEEDS_TAP or UPDATE_REQUIRED, put the sign-in card. A --reuse spends no tap, so it gives no card back. Every tapped mode (`sign-in`, `take`, `waitNew`) needs the member's tap on the sign-in card in this thread; `--forget` and `--reuse` need none. A sign-in takes the sign-in that profile in their Chrome holds when it differs from this thread's, without opening anything, and answers taken true, opened false and signedIn false, since the site has not confirmed it; or else it opens --url, or the site's page, in their Chrome and waits up to 8 minutes for the member to sign in. On LinkedIn and X it answers signedIn true and opened true. On any other site a change of the site's cookies is taken and answered taken true and signedIn false, since a change is not a sign-in, and an end with no change answers taken false; a desktop app too old to watch the site opens it and answers at once, with no taken. Every answer with taken true carries waitNewLeft: while it is above 0 and the site is still signed out, --wait-new (with the same --url), in the same Turn and with no new tap, waits for a newer sign-in, never taking the one taken already, and opens the site only when this Turn has not; once the tap's time has run out it fails with SIGN_IN_WINDOW_ENDED, and no card comes back. After the member's I'm signed in tap, --take takes that site's cookies, never Google's, and answers taken. --forget removes a sign-in this Turn took, a --reuse's included, for an account other than the one expected, and needs no tap. Each tap allows one call: a call without one, or a --wait-new that no take armed, fails with SIGN_IN_NEEDS_TAP. Then open the site with browser and check the account before account-specific work. On DEVICE_OFFLINE, TIMEOUT, SIGN_IN_TIMEOUT and KEYCHAIN_UNAVAILABLE Kosuke gives the member's card back by itself. Fails with SIGN_IN_TIMEOUT when Kosuke saw no new sign-in to LinkedIn or X within 8 minutes, PROFILE_DISCONNECTED for a profile turned off in Settings → Devices, KEYCHAIN_UNAVAILABLE when macOS did not let Kosuke read Chrome's sign-ins, STALE_TURN when the Turn stopped, and UPDATE_REQUIRED on a desktop app too old for it. Only Sensei calls it.",
     "pathParams": [],
     "query": [],
     "body": {
@@ -65,7 +65,7 @@ export const operation = {
                 "flag": "reuse",
                 "kind": "boolean",
                 "required": false,
-                "description": "Pick up the site’s sign-in from everyday Chrome by itself, without opening anything and with no tap: in a Turn the member’s own message started, once per site and profile. Name the profile by its exact ID. Answers chrome none, same or different, with taken."
+                "description": "Pick up the site’s sign-in from everyday Chrome by itself, without opening anything and with no tap: once per site and profile in a Turn. Name the profile by its exact ID. Answers chrome none, same or different, with taken."
             }
         ],
         "required": true

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

@@ -5,7 +5,7 @@ export const operation = {
         "projects",
         "create"
     ],
-    "summary": "Connect a GitHub repository as a project in a workspace, or describe what to build to create a YOLO project on a new Kosuke-Org repository. Pass workflow yolo with a repository to import it in YOLO mode, with an optional prompt as its first message. Pass personal instead of orgId to create it in your Personal: your own credential, or your Sensei in a Turn you started. Its first Deploy starts by itself, as the caller's; sessions start once it lands. Imports only a repository your own GitHub Connection can write to: 403 GITHUB_REPOSITORY_ACCESS_REQUIRED otherwise, 401 GITHUB_RECONNECT_REQUIRED when GitHub no longer accepts your connection. Pass workflow yolo or personal only when the member asked for it. Report a chatError; on BRANCH_PROTECTED give its message and do not retry.",
+    "summary": "Connect a GitHub repository as a project in a workspace, or describe what to build to create a YOLO project on a new Kosuke-Org repository. Pass workflow yolo with a repository to import it in YOLO mode, with an optional prompt as its first message. Pass personal instead of orgId to create it in your Personal: your own credential, or your Sensei. Its first Deploy starts by itself, as the caller's; sessions start once it lands. Imports only a repository your own GitHub Connection can write to: 403 GITHUB_REPOSITORY_ACCESS_REQUIRED otherwise, 401 GITHUB_RECONNECT_REQUIRED when GitHub no longer accepts your connection. Pass workflow yolo or personal only when the member asked for it. Report a chatError; on BRANCH_PROTECTED give its message and do not retry.",
     "pathParams": [],
     "query": [],
     "body": {
@@ -60,7 +60,7 @@ export const operation = {
                 "flag": "personal",
                 "kind": "boolean",
                 "required": false,
-                "description": "Create a personal project instead of naming a workspace with orgId. Requires your own credential, or your Sensei in a Turn you started."
+                "description": "Create a personal project instead of naming a workspace with orgId. Requires your own credential, or your Sensei."
             }
         ],
         "required": true

package/dist/generated/commands/sensei/device-requests-list.js

@@ -6,7 +6,7 @@ export const operation = {
         "device-requests",
         "list"
     ],
-    "summary": "List the Device Requests of a Chat Session, oldest first, as you would see them on its cards: id, device, kind, owner, reason, status (pending, approved, declined, expired, withdrawn or closed), who asked and who answered, when, and canApprove, whether you may answer it. A request past its 30 minutes reads expired.",
+    "summary": "List the Device Requests of a Chat Session, oldest first, as you would see them on its cards: id, device, kind, owner, reason, status (pending, approved, declined, expired, withdrawn or closed), who asked and who answered, when, canApprove, whether you may answer it, and occupiedBy, session or sensei when someone else uses the device while it is pending. A request past its 30 minutes reads expired.",
     "pathParams": [],
     "query": [
         {

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

@@ -78,6 +78,13 @@ export const operation = {
                 "kind": "string",
                 "required": false
             },
+            {
+                "name": "branch",
+                "flag": "branch",
+                "kind": "string",
+                "required": false,
+                "description": "An existing branch the session works on: it checks it out, pushes to it and opens its pull request from it. Not the default branch, the Target Branch, or a branch another open session works on. Absent: a new branch. Repository projects only; not with startBranch."
+            },
             {
                 "name": "reason",
                 "flag": "reason",
@@ -186,6 +193,13 @@ export const operation = {
             "kind": "string",
             "required": false
         },
+        {
+            "name": "branch",
+            "flag": "branch",
+            "kind": "string",
+            "required": false,
+            "description": "An existing branch the session works on: it checks it out, pushes to it and opens its pull request from it. Not the default branch, the Target Branch, or a branch another open session works on. Absent: a new branch. Repository projects only; not with startBranch."
+        },
         {
             "name": "reason",
             "flag": "reason",

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

@@ -5,7 +5,7 @@ export const operation = {
         "sessions",
         "delete"
     ],
-    "summary": "Delete a chat session. Sensei deletes only a Backlog ticket, refused with 409 NOT_IN_BACKLOG once it started, and only in a Turn its member started.",
+    "summary": "Delete a chat session. Sensei deletes only a Backlog ticket, refused with 409 NOT_IN_BACKLOG once it started, whatever started the Turn.",
     "pathParams": [
         "projectId",
         "sessionId"

package/dist/generated/commands/tasks/create.js

@@ -64,6 +64,13 @@ export const operation = {
                 "kind": "string",
                 "required": false
             },
+            {
+                "name": "branch",
+                "flag": "branch",
+                "kind": "string",
+                "required": false,
+                "description": "An existing branch the session works on: it checks it out, pushes to it and opens its pull request from it. Not the default branch, the Target Branch, or a branch another open session works on. Absent: a new branch. Repository projects only; not with startBranch."
+            },
             {
                 "name": "reason",
                 "flag": "reason",
@@ -194,6 +201,13 @@ export const operation = {
             "kind": "string",
             "required": false
         },
+        {
+            "name": "branch",
+            "flag": "branch",
+            "kind": "string",
+            "required": false,
+            "description": "An existing branch the session works on: it checks it out, pushes to it and opens its pull request from it. Not the default branch, the Target Branch, or a branch another open session works on. Absent: a new branch. Repository projects only; not with startBranch."
+        },
         {
             "name": "reason",
             "flag": "reason",

package/openapi.json

@@ -143,7 +143,7 @@
     "/api/agent-integrations/execute": {
       "post": {
         "operationId": "integrationsToolsCall",
-        "summary": "Run one integration tool. An agent runs it for its own workspace, or on the member’s personal connection when that member started the turn. With an API key, name a workspace you belong to: the call runs only on your own personal connections, and one on a workspace connection is refused. The answer names the connection it ran on, or lists the connections to choose from when the call needs one. A tool failure answers 200 with isError true. Some integrations require an enabled workspace to be named. A Connector Token or a browser session is refused.",
+        "summary": "Run one integration tool. An agent runs it for its own workspace, or on the member’s personal connection in any of their Sensei Turns or a session turn that member started. With an API key, name a workspace you belong to: the call runs only on your own personal connections, and one on a workspace connection is refused. The answer names the connection it ran on, or lists the connections to choose from when the call needs one. A tool failure answers 200 with isError true. Some integrations require an enabled workspace to be named. A Connector Token or a browser session is refused.",
         "tags": ["integrations"],
         "x-kosuke-command": ["integrations", "tools", "call"],
         "x-kosuke-hidden": true,
@@ -235,7 +235,7 @@
     "/api/agent-integrations/tools": {
       "get": {
         "operationId": "integrationsToolsList",
-        "summary": "List the integration tools you can run now, with the connections that run them. An agent reads its own workspace. With an API key, name a workspace you belong to: it shows that workspace’s connections and your own personal ones. Some integrations require an enabled workspace to be named. A Connector Token or a browser session is refused. Each toolkit is personal or workspace, never both. A personal connection reaches only a Turn its member started (in a workspace chat, only the session's Assignee); a workspace Cron, Deploy Chat, a Turn another member sent and unassigned work reach workspace connections only. In the Personal space the owner's own Turns reach both kinds.",
+        "summary": "List the integration tools you can run now, with the connections that run them. An agent reads its own workspace. With an API key, name a workspace you belong to: it shows that workspace’s connections and your own personal ones. Some integrations require an enabled workspace to be named. A Connector Token or a browser session is refused. Each toolkit is personal or workspace, never both. A personal connection reaches every Sensei Turn of its member, and a session turn its member started (in a workspace chat, only the session's Assignee); a workspace Cron, Deploy Chat, a Turn another member sent and unassigned work reach workspace connections only. In the Personal space the owner's own Turns reach both kinds.",
         "tags": ["integrations"],
         "x-kosuke-command": ["integrations", "tools", "list"],
         "x-kosuke-hidden": true,
@@ -799,7 +799,7 @@
     "/api/devices/available": {
       "get": {
         "operationId": "devicesList",
-        "summary": "From a Chat Session: the devices it may ask for, the workspace's devices and the session member's own Macs, each with its id, kind, whether it is online, the tools it offers and this session's access: none, pending or approved. Pick an online device with the tools the test needs: a workspace device first, and the member's own Mac only when no workspace device fits, whatever the names or past approvals. Request one with `kosuke devices requests create` before any mac command, and use one only when the test truly needs a real Mac.",
+        "summary": "From a Chat Session: the devices it may ask for, the workspace's devices and the session member's own Macs, each with its id, kind, whether it is online, the tools it offers, this session's access: none, pending or approved, and occupied with occupiedBy (session or sensei) when someone else uses it now. Pick an online device with the tools the test needs: a workspace device first, and the member's own Mac only when no workspace device fits, whatever the names or past approvals. Of those, pick a free one, and ask for an occupied one only when no free device fits. Request one with `kosuke devices requests create` before any mac command, and use one only when the test truly needs a real Mac.",
         "tags": ["devices"],
         "x-kosuke-command": ["devices", "list"],
         "x-kosuke-sandbox-token": true,
@@ -1116,7 +1116,7 @@
     "/api/devices/mac/browser-connections": {
       "get": {
         "operationId": "macBrowserConnectionsList",
-        "summary": "List the member's LinkedIn and X browser connections, oldest first: each is one account Sensei may act as, with its id, revision, account (null until Sensei fills it in), device (id, name, removed), profile (id, name), the last check (unchecked, connected, signed_out, other_account) with checkedAt, and connectThreadId, the only thread whose Turn may fill the account in. Pass its device id and profile id to every browser call for it. Only Sensei calls it, in a Turn the member's own message started.",
+        "summary": "List the member's LinkedIn and X browser connections, oldest first: each is one account Sensei may act as, with its id, revision, account (null until Sensei fills it in), device (id, name, removed), profile (id, name), the last check (unchecked, connected, signed_out, other_account) with checkedAt, and connectThreadId, the only thread whose Turn may fill the account in. Pass its device id and profile id to every browser call for it. Only Sensei calls it.",
         "tags": ["mac"],
         "x-kosuke-command": ["mac", "browser", "connections", "list"],
         "x-kosuke-sandbox-token": true,
@@ -1170,7 +1170,7 @@
       },
       "post": {
         "operationId": "macBrowserConnectionsUpdate",
-        "summary": "Report what one check of the live page saw for a browser connection, with the revision `kosuke mac browser connections list` answered: connected with the account's name and handle, signed_out, or other_account with the name found. The first connected fills the account in, only from a Turn of its connectThreadId (else 403 NOT_CONNECT_THREAD); afterwards the handle must match it (else 409 ACCOUNT_MISMATCH). 409 STALE_REVISION after a newer Connect or Reconnect: read again. 404 once the member disconnected it. Only Sensei calls it, in a Turn the member's own message started.",
+        "summary": "Report what one check of the live page saw for a browser connection, with the revision `kosuke mac browser connections list` answered: connected with the account's name and handle, signed_out, or other_account with the name found. The first connected fills the account in, only from a Turn of its connectThreadId (else 403 NOT_CONNECT_THREAD); afterwards the handle must match it (else 409 ACCOUNT_MISMATCH). 409 STALE_REVISION after a newer Connect or Reconnect: read again. 404 once the member disconnected it. Only Sensei calls it.",
         "tags": ["mac"],
         "x-kosuke-command": ["mac", "browser", "connections", "update"],
         "x-kosuke-sandbox-token": true,
@@ -1328,7 +1328,7 @@
     "/api/devices/mac/browser-sign-in": {
       "post": {
         "operationId": "macBrowserLogin",
-        "summary": "Get a site signed in in this Sensei Thread's browser from the member's everyday Chrome: pass the browser call's profile and deviceId, and the site as a bare hostname (twitter.com is x.com; Google's sites are refused). --reuse picks up the sign-in that profile in their Chrome holds by itself, with no tap: only in a Turn the member's own message started, once per site and profile in a Turn, with the profile's exact ID. It never opens Chrome or waits for anyone, and answers opened false and signedIn false with chrome none (their Chrome holds no sign-in for the site, so nothing changed), same (the one this thread's browser already holds) or different (taken into this thread's browser, taken true). Then, unless it answered none or same, open the site with browser and check the account. On SIGN_IN_NEEDS_TAP or UPDATE_REQUIRED, put the sign-in card. A --reuse spends no tap, so it gives no card back. Every tapped mode (`sign-in`, `take`, `waitNew`) needs the member's tap on the sign-in card in this thread; `--forget` and `--reuse` need none. A sign-in takes the sign-in that profile in their Chrome holds when it differs from this thread's, without opening anything, and answers taken true, opened false and signedIn false, since the site has not confirmed it; or else it opens --url, or the site's page, in their Chrome and waits up to 8 minutes for the member to sign in. On LinkedIn and X it answers signedIn true and opened true. On any other site a change of the site's cookies is taken and answered taken true and signedIn false, since a change is not a sign-in, and an end with no change answers taken false; a desktop app too old to watch the site opens it and answers at once, with no taken. Every answer with taken true carries waitNewLeft: while it is above 0 and the site is still signed out, --wait-new (with the same --url), in the same Turn and with no new tap, waits for a newer sign-in, never taking the one taken already, and opens the site only when this Turn has not; once the tap's time has run out it fails with SIGN_IN_WINDOW_ENDED, and no card comes back. After the member's I'm signed in tap, --take takes that site's cookies, never Google's, and answers taken. --forget removes a sign-in this Turn took, a --reuse's included, for an account other than the one expected, and needs no tap. Each tap allows one call: a call without one, or a --wait-new that no take armed, fails with SIGN_IN_NEEDS_TAP. Then open the site with browser and check the account before account-specific work. On DEVICE_OFFLINE, TIMEOUT, SIGN_IN_TIMEOUT and KEYCHAIN_UNAVAILABLE Kosuke gives the member's card back by itself. Fails with SIGN_IN_TIMEOUT when Kosuke saw no new sign-in to LinkedIn or X within 8 minutes, PROFILE_DISCONNECTED for a profile turned off in Settings → Devices, KEYCHAIN_UNAVAILABLE when macOS did not let Kosuke read Chrome's sign-ins, STALE_TURN when the Turn stopped, and UPDATE_REQUIRED on a desktop app too old for it. Only Sensei calls it.",
+        "summary": "Get a site signed in in this Sensei Thread's browser from the member's everyday Chrome: pass the browser call's profile and deviceId, and the site as a bare hostname (twitter.com is x.com; Google's sites are refused). --reuse picks up the sign-in that profile in their Chrome holds by itself, with no tap: once per site and profile in a Turn, with the profile's exact ID. It never opens Chrome or waits for anyone, and answers opened false and signedIn false with chrome none (their Chrome holds no sign-in for the site, so nothing changed), same (the one this thread's browser already holds) or different (taken into this thread's browser, taken true). Then, unless it answered none or same, open the site with browser and check the account. On SIGN_IN_NEEDS_TAP or UPDATE_REQUIRED, put the sign-in card. A --reuse spends no tap, so it gives no card back. Every tapped mode (`sign-in`, `take`, `waitNew`) needs the member's tap on the sign-in card in this thread; `--forget` and `--reuse` need none. A sign-in takes the sign-in that profile in their Chrome holds when it differs from this thread's, without opening anything, and answers taken true, opened false and signedIn false, since the site has not confirmed it; or else it opens --url, or the site's page, in their Chrome and waits up to 8 minutes for the member to sign in. On LinkedIn and X it answers signedIn true and opened true. On any other site a change of the site's cookies is taken and answered taken true and signedIn false, since a change is not a sign-in, and an end with no change answers taken false; a desktop app too old to watch the site opens it and answers at once, with no taken. Every answer with taken true carries waitNewLeft: while it is above 0 and the site is still signed out, --wait-new (with the same --url), in the same Turn and with no new tap, waits for a newer sign-in, never taking the one taken already, and opens the site only when this Turn has not; once the tap's time has run out it fails with SIGN_IN_WINDOW_ENDED, and no card comes back. After the member's I'm signed in tap, --take takes that site's cookies, never Google's, and answers taken. --forget removes a sign-in this Turn took, a --reuse's included, for an account other than the one expected, and needs no tap. Each tap allows one call: a call without one, or a --wait-new that no take armed, fails with SIGN_IN_NEEDS_TAP. Then open the site with browser and check the account before account-specific work. On DEVICE_OFFLINE, TIMEOUT, SIGN_IN_TIMEOUT and KEYCHAIN_UNAVAILABLE Kosuke gives the member's card back by itself. Fails with SIGN_IN_TIMEOUT when Kosuke saw no new sign-in to LinkedIn or X within 8 minutes, PROFILE_DISCONNECTED for a profile turned off in Settings → Devices, KEYCHAIN_UNAVAILABLE when macOS did not let Kosuke read Chrome's sign-ins, STALE_TURN when the Turn stopped, and UPDATE_REQUIRED on a desktop app too old for it. Only Sensei calls it.",
         "tags": ["mac"],
         "x-kosuke-command": ["mac", "browser", "login"],
         "x-kosuke-answer-timeout-ms": 590000,
@@ -1379,7 +1379,7 @@
                     "type": "boolean"
                   },
                   "reuse": {
-                    "description": "Pick up the site’s sign-in from everyday Chrome by itself, without opening anything and with no tap: in a Turn the member’s own message started, once per site and profile. Name the profile by its exact ID. Answers chrome none, same or different, with taken.",
+                    "description": "Pick up the site’s sign-in from everyday Chrome by itself, without opening anything and with no tap: once per site and profile in a Turn. Name the profile by its exact ID. Answers chrome none, same or different, with taken.",
                     "type": "boolean"
                   }
                 },
@@ -8041,6 +8041,12 @@
                     "minLength": 1,
                     "maxLength": 255
                   },
+                  "branch": {
+                    "description": "An existing branch the session works on: it checks it out, pushes to it and opens its pull request from it. Not the default branch, the Target Branch, or a branch another open session works on. Absent: a new branch. Repository projects only; not with startBranch.",
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 255
+                  },
                   "reason": {
                     "description": "Why this session is being filed and what turned it up, in one line. Required from a sandbox or a Cron Run, ignored from anyone else.",
                     "type": "string",
@@ -8123,6 +8129,12 @@
                     "minLength": 1,
                     "maxLength": 255
                   },
+                  "branch": {
+                    "description": "An existing branch the session works on: it checks it out, pushes to it and opens its pull request from it. Not the default branch, the Target Branch, or a branch another open session works on. Absent: a new branch. Repository projects only; not with startBranch.",
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 255
+                  },
                   "reason": {
                     "description": "Why this session is being filed and what turned it up, in one line. Required from a sandbox or a Cron Run, ignored from anyone else.",
                     "type": "string",
@@ -9525,7 +9537,7 @@
       },
       "post": {
         "operationId": "projectsCreate",
-        "summary": "Connect a GitHub repository as a project in a workspace, or describe what to build to create a YOLO project on a new Kosuke-Org repository. Pass workflow yolo with a repository to import it in YOLO mode, with an optional prompt as its first message. Pass personal instead of orgId to create it in your Personal: your own credential, or your Sensei in a Turn you started. Its first Deploy starts by itself, as the caller's; sessions start once it lands. Imports only a repository your own GitHub Connection can write to: 403 GITHUB_REPOSITORY_ACCESS_REQUIRED otherwise, 401 GITHUB_RECONNECT_REQUIRED when GitHub no longer accepts your connection. Pass workflow yolo or personal only when the member asked for it. Report a chatError; on BRANCH_PROTECTED give its message and do not retry.",
+        "summary": "Connect a GitHub repository as a project in a workspace, or describe what to build to create a YOLO project on a new Kosuke-Org repository. Pass workflow yolo with a repository to import it in YOLO mode, with an optional prompt as its first message. Pass personal instead of orgId to create it in your Personal: your own credential, or your Sensei. Its first Deploy starts by itself, as the caller's; sessions start once it lands. Imports only a repository your own GitHub Connection can write to: 403 GITHUB_REPOSITORY_ACCESS_REQUIRED otherwise, 401 GITHUB_RECONNECT_REQUIRED when GitHub no longer accepts your connection. Pass workflow yolo or personal only when the member asked for it. Report a chatError; on BRANCH_PROTECTED give its message and do not retry.",
         "tags": ["projects"],
         "x-kosuke-command": ["projects", "create"],
         "x-kosuke-sandbox-token": true,
@@ -9571,7 +9583,7 @@
                     "minLength": 1
                   },
                   "personal": {
-                    "description": "Create a personal project instead of naming a workspace with orgId. Requires your own credential, or your Sensei in a Turn you started.",
+                    "description": "Create a personal project instead of naming a workspace with orgId. Requires your own credential, or your Sensei.",
                     "type": "boolean",
                     "const": true
                   }
@@ -10835,6 +10847,12 @@
                     "minLength": 1,
                     "maxLength": 255
                   },
+                  "branch": {
+                    "description": "An existing branch the session works on: it checks it out, pushes to it and opens its pull request from it. Not the default branch, the Target Branch, or a branch another open session works on. Absent: a new branch. Repository projects only; not with startBranch.",
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 255
+                  },
                   "reason": {
                     "description": "Why this session is being filed and what turned it up, in one line. Required from a sandbox or a Cron Run, ignored from anyone else.",
                     "type": "string",
@@ -10900,6 +10918,12 @@
                     "minLength": 1,
                     "maxLength": 255
                   },
+                  "branch": {
+                    "description": "An existing branch the session works on: it checks it out, pushes to it and opens its pull request from it. Not the default branch, the Target Branch, or a branch another open session works on. Absent: a new branch. Repository projects only; not with startBranch.",
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 255
+                  },
                   "reason": {
                     "description": "Why this session is being filed and what turned it up, in one line. Required from a sandbox or a Cron Run, ignored from anyone else.",
                     "type": "string",
@@ -11203,7 +11227,7 @@
       },
       "delete": {
         "operationId": "sessionsDelete",
-        "summary": "Delete a chat session. Sensei deletes only a Backlog ticket, refused with 409 NOT_IN_BACKLOG once it started, and only in a Turn its member started.",
+        "summary": "Delete a chat session. Sensei deletes only a Backlog ticket, refused with 409 NOT_IN_BACKLOG once it started, whatever started the Turn.",
         "tags": ["sessions"],
         "x-kosuke-command": ["sessions", "delete"],
         "x-kosuke-sandbox-token": true,
@@ -22053,7 +22077,7 @@
     "/api/sensei/device-requests": {
       "get": {
         "operationId": "senseiDeviceRequestsList",
-        "summary": "List the Device Requests of a Chat Session, oldest first, as you would see them on its cards: id, device, kind, owner, reason, status (pending, approved, declined, expired, withdrawn or closed), who asked and who answered, when, and canApprove, whether you may answer it. A request past its 30 minutes reads expired.",
+        "summary": "List the Device Requests of a Chat Session, oldest first, as you would see them on its cards: id, device, kind, owner, reason, status (pending, approved, declined, expired, withdrawn or closed), who asked and who answered, when, canApprove, whether you may answer it, and occupiedBy, session or sensei when someone else uses the device while it is pending. A request past its 30 minutes reads expired.",
         "tags": ["sensei"],
         "x-kosuke-command": ["sensei", "device-requests", "list"],
         "x-kosuke-sandbox-token": true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kosuke-ai/kosuke",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "description": "Kosuke platform CLI. The client customers install to drive app.kosuke.ai from their own machine.",
   "license": "MIT",
   "repository": {
@@ -40,12 +40,11 @@
     "vitest": "^4.1.12"
   },
   "kosukeRelease": {
-    "sourceCommit": "b2995930d10dddf7aeeccf7a1403deba57fdfa52",
-    "sourceIdentity": "59538ec9149425be5980d4a7714591d8f861932a6b62d0443ae32f2263df00f2",
+    "sourceCommit": "76f5440713c26ece8b7a10148e2756fcda195399",
+    "sourceIdentity": "6d76d9b36ed84006ecffb3cbf97a91c26c66ebf3596e530a3aa342cbb7421ed0",
     "fragments": [
-      "personal-usage-breakdown-xrlge1.json",
-      "usage-breakdown-review-xrlge1.json",
-      "watch-report-tr3ypz.json"
+      "devices-list-occupied-mmw6bi.json",
+      "task-requested-branch.json"
     ]
   }
 }