@kosuke-ai/kosuke 1.0.0 → 1.0.2

package/dist/generated/commands/integrations/execute.js

@@ -0,0 +1,49 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/agent-integrations/execute",
+    "command": [
+        "integrations",
+        "execute"
+    ],
+    "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.",
+    "pathParams": [],
+    "query": [
+        {
+            "name": "workspace",
+            "flag": "workspace",
+            "kind": "string",
+            "required": false,
+            "description": "The workspace the call is made in. Required with an API key, which is refused with 403 when you are not a member of it. An agent credential reaches its own workspace and refuses another. Some integrations require an enabled workspace to be named."
+        }
+    ],
+    "body": {
+        "fields": [
+            {
+                "name": "name",
+                "flag": "name",
+                "kind": "string",
+                "required": true,
+                "description": "The tool to run, as the tools list names it."
+            },
+            {
+                "name": "arguments",
+                "flag": "arguments",
+                "kind": "json",
+                "required": true,
+                "description": "The tool's arguments, as its input schema describes them."
+            },
+            {
+                "name": "account",
+                "flag": "account",
+                "kind": "string",
+                "required": false,
+                "description": "The connection to run on: its short id, its alias such as notion-personal, or scope:label. Needed when several can run the tool."
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

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

@@ -0,0 +1,70 @@
+export const operation = {
+    "method": "get",
+    "path": "/api/agent-integrations/tools",
+    "command": [
+        "integrations",
+        "tools"
+    ],
+    "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.",
+    "pathParams": [],
+    "query": [
+        {
+            "name": "workspace",
+            "flag": "workspace",
+            "kind": "string",
+            "required": false,
+            "description": "The workspace to list for. Required with an API key, which is refused with 403 when you are not a member of it. An agent credential reaches its own workspace and refuses another. Some integrations require an enabled workspace to be named."
+        },
+        {
+            "name": "view",
+            "flag": "view",
+            "kind": "string",
+            "required": false,
+            "description": "overview: the connections per toolkit with tool counts, and the matching tools once toolkit or search is set. summary: tool names and short descriptions, cut at 300. Without it, full definitions cut at a size budget, which is what older clients read.",
+            "choices": [
+                "summary",
+                "overview"
+            ]
+        },
+        {
+            "name": "toolkit",
+            "flag": "toolkit",
+            "kind": "string",
+            "required": false,
+            "description": "Only this toolkit, by slug, such as gmail."
+        },
+        {
+            "name": "search",
+            "flag": "search",
+            "kind": "string",
+            "required": false,
+            "description": "Only tools whose name, description or toolkit contains this text, in any case."
+        },
+        {
+            "name": "name",
+            "flag": "name",
+            "kind": "string",
+            "required": false,
+            "description": "One tool by exact name, with its full input schema. 404 when you are not offered it."
+        },
+        {
+            "name": "account",
+            "flag": "account",
+            "kind": "string",
+            "required": false,
+            "description": "Only one connection: its short id, its alias such as notion-personal, or scope:label. Needed for a name that several connections can run."
+        },
+        {
+            "name": "limit",
+            "flag": "limit",
+            "kind": "integer",
+            "required": false,
+            "description": "With view overview, how many tools to list when toolkit or search is set. 40 by default."
+        }
+    ],
+    "body": null,
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

package/dist/generated/commands/mac/apps.js

@@ -0,0 +1,30 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/devices/mac/apps",
+    "command": [
+        "mac",
+        "apps"
+    ],
+    "summary": "List the apps running on the member's Mac, with each one's name, bundle id, pid and whether it is active. Sensei calls it, and a Chat Session does with --device-id for a device approved for it.",
+    "pathParams": [],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "deviceId",
+                "flag": "device-id",
+                "kind": "string",
+                "required": false,
+                "description": "The device, by the ID `kosuke devices list` prints. A Chat Session names the device it was approved for; Sensei may leave it out for the member’s Mac that is online."
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": [
+        "sandboxToken",
+        "senseiToken"
+    ]
+};

package/dist/generated/commands/mac/ax-tree.js

@@ -0,0 +1,65 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/devices/mac/ax-tree",
+    "command": [
+        "mac",
+        "ax-tree"
+    ],
+    "summary": "Read one window of the member's Mac as its accessibility tree, one line per element with a ref such as e12 for click, type and scroll. Prefer it to a screenshot. Sensei calls it, and a Chat Session does with --device-id for a device approved for it.",
+    "pathParams": [],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "deviceId",
+                "flag": "device-id",
+                "kind": "string",
+                "required": false,
+                "description": "The device, by the ID `kosuke devices list` prints. A Chat Session names the device it was approved for; Sensei may leave it out for the member’s Mac that is online."
+            },
+            {
+                "name": "app",
+                "flag": "app",
+                "kind": "string",
+                "required": false,
+                "description": "The app, by name or bundle id."
+            },
+            {
+                "name": "pid",
+                "flag": "pid",
+                "kind": "integer",
+                "required": false,
+                "description": "The process id, from `kosuke mac windows`."
+            },
+            {
+                "name": "window",
+                "flag": "window",
+                "kind": "string",
+                "required": false,
+                "description": "A substring of the window title."
+            },
+            {
+                "name": "depth",
+                "flag": "depth",
+                "kind": "integer",
+                "required": false,
+                "description": "How deep to walk. 16 by default."
+            },
+            {
+                "name": "max",
+                "flag": "max",
+                "kind": "integer",
+                "required": false,
+                "description": "Most nodes listed. 300 by default."
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": [
+        "sandboxToken",
+        "senseiToken"
+    ]
+};

package/dist/generated/commands/mac/browser-connection-check.js

@@ -0,0 +1,69 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/devices/mac/browser-connections",
+    "command": [
+        "mac",
+        "browser-connection-check"
+    ],
+    "summary": "Report what one check of the live page saw for a browser connection, with the revision `mac browser-connections` 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.",
+    "pathParams": [],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "connectionId",
+                "flag": "connection-id",
+                "kind": "string",
+                "required": true,
+                "description": "The connection’s id, as `mac browser-connections` lists it."
+            },
+            {
+                "name": "revision",
+                "flag": "revision",
+                "kind": "integer",
+                "required": true,
+                "description": "The revision `mac browser-connections` answered; a newer one refuses the write."
+            },
+            {
+                "name": "check",
+                "flag": "check",
+                "kind": "string",
+                "required": true,
+                "description": "What the live page showed in the connection’s profile.",
+                "choices": [
+                    "connected",
+                    "signed_out",
+                    "other_account"
+                ]
+            },
+            {
+                "name": "accountName",
+                "flag": "account-name",
+                "kind": "string",
+                "required": false,
+                "description": "With connected: the account's name as the page shows it."
+            },
+            {
+                "name": "accountHandle",
+                "flag": "account-handle",
+                "kind": "string",
+                "required": false,
+                "description": "With connected: the account's handle, such as linkedin.com/in/ada or @ada."
+            },
+            {
+                "name": "foundAccountName",
+                "flag": "found-account-name",
+                "kind": "string",
+                "required": false,
+                "description": "With other_account: the name of the account the page showed instead."
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": [
+        "senseiToken"
+    ]
+};

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

@@ -0,0 +1,30 @@
+export const operation = {
+    "method": "get",
+    "path": "/api/devices/mac/browser-connections",
+    "command": [
+        "mac",
+        "browser-connections"
+    ],
+    "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.",
+    "pathParams": [],
+    "query": [
+        {
+            "name": "site",
+            "flag": "site",
+            "kind": "string",
+            "required": false,
+            "description": "Only this site: linkedin or x.",
+            "choices": [
+                "linkedin",
+                "x"
+            ]
+        }
+    ],
+    "body": null,
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": [
+        "senseiToken"
+    ]
+};

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

@@ -0,0 +1,36 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/devices/mac/browser-profiles",
+    "command": [
+        "mac",
+        "browser-profiles"
+    ],
+    "summary": "List Chrome profile IDs and display names on the member's Mac, including the default choice and device ID/name, with access allowed or off on every profile (off: turned off in Settings → Devices, never to be used). With --site, a bare host (Google's sites answer BAD_ARGS), it names the site and whether Kosuke watches it, and every allowed profile carries chromeSignIn: candidate when that profile in their Chrome holds a live cookie for the site (the sign-in cookie for LinkedIn and X), none when it holds none, unknown when it could not be read. An off profile carries none. A candidate is not a sign-in: check the account by browsing. Discovery reads cookie presence only, never a value, never the Keychain, and no history, and opens no browser. An older desktop app answers without access and chromeSignIn: read that as unknown. Only Sensei calls it.",
+    "pathParams": [],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "deviceId",
+                "flag": "device-id",
+                "kind": "string",
+                "required": false,
+                "description": "The Mac ID returned by browser-profiles. An unavailable Mac fails without choosing another."
+            },
+            {
+                "name": "site",
+                "flag": "site",
+                "kind": "string",
+                "required": false,
+                "description": "A bare host, such as linkedin.com. With it each allowed profile says whether your Chrome holds a candidate sign-in for that site."
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": [
+        "senseiToken"
+    ]
+};

package/dist/generated/commands/mac/browser-sign-in.js

@@ -0,0 +1,79 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/devices/mac/browser-sign-in",
+    "command": [
+        "mac",
+        "browser-sign-in"
+    ],
+    "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.",
+    "pathParams": [],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "deviceId",
+                "flag": "device-id",
+                "kind": "string",
+                "required": false,
+                "description": "The Mac ID returned by browser-profiles. An unavailable Mac fails without choosing another."
+            },
+            {
+                "name": "profile",
+                "flag": "profile",
+                "kind": "string",
+                "required": true,
+                "description": "A Chrome profile directory ID or exact, unambiguous display name from browser-profiles."
+            },
+            {
+                "name": "site",
+                "flag": "site",
+                "kind": "string",
+                "required": true,
+                "description": "The site, as a bare hostname such as linkedin.com. twitter.com is x.com. Google’s sites are refused."
+            },
+            {
+                "name": "take",
+                "flag": "take",
+                "kind": "boolean",
+                "required": false,
+                "description": "Take the site’s sign-in from everyday Chrome now, without opening anything: after the member’s “I’m signed in” or “Continue as” tap."
+            },
+            {
+                "name": "forget",
+                "flag": "forget",
+                "kind": "boolean",
+                "required": false,
+                "description": "Remove the site’s sign-in that this Turn took from this thread’s browser, for an account other than the expected one. Needs no tap."
+            },
+            {
+                "name": "url",
+                "flag": "url",
+                "kind": "string",
+                "required": false,
+                "description": "For a site other than LinkedIn and X: the https page on that site to open, the one that showed the sign-in wall in Sensei’s browser, whether a login page or the page the sign-in form appeared on. It may be on a subdomain; the take still covers only the site’s registrable domain. Its home page by default. Never with take or forget, which open no page."
+            },
+            {
+                "name": "waitNew",
+                "flag": "wait-new",
+                "kind": "boolean",
+                "required": false,
+                "description": "Any site: wait for a newer sign-in after a sign-in call or a follow-up took the site’s sign-in (taken true) and left the site signed out, in the same Turn and with no new tap, while that answer’s waitNewLeft is above 0. Never takes the sign-in taken already, and opens the site, or url, in everyday Chrome only when this Turn has not."
+            },
+            {
+                "name": "reuse",
+                "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."
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "answerTimeoutMs": 590000,
+    "anonymous": false,
+    "agents": [
+        "senseiToken"
+    ]
+};

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

@@ -0,0 +1,44 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/devices/mac/browser",
+    "command": [
+        "mac",
+        "browser"
+    ],
+    "summary": "Run agent-browser commands in order, in one headless Google Chrome session on the member's Mac signed in with their cookies, for sites that need their sign-in. On updated desktops each Sensei Thread has its own browser, so threads browse at once, and it closes when the Turn ends, so page state does not carry over to the next Turn; past the Mac's cap on open browsers, with none idle, a call answers BROWSER_LIMIT. Select a Chrome profile by directory ID or exact unambiguous name, and pin its Mac with deviceId. Updated desktops return profile ID/name; the platform returns device ID/name. Unknown or removed profiles fail without fallback, and a profile the member turned off in Settings → Devices fails with PROFILE_DISCONNECTED. Older desktops require an update for explicit selection, and share one browser per profile under the Mac lock. Answers each command's output, the recording's lasting link as recording.url (the recording is posted in the chat too), and the paths of files it downloaded to ~/Downloads. Only Sensei calls it.",
+    "pathParams": [],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "deviceId",
+                "flag": "device-id",
+                "kind": "string",
+                "required": false,
+                "description": "The Mac ID returned by browser-profiles. An unavailable Mac fails without choosing another."
+            },
+            {
+                "name": "profile",
+                "flag": "profile",
+                "kind": "string",
+                "required": false,
+                "description": "A Chrome profile directory ID or exact, unambiguous display name from browser-profiles."
+            },
+            {
+                "name": "cmds",
+                "flag": "cmd",
+                "kind": "string",
+                "required": true,
+                "description": "agent-browser commands, run in order in one session.",
+                "repeated": true
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": [
+        "senseiToken"
+    ]
+};

package/dist/generated/commands/mac/click.js

@@ -0,0 +1,72 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/devices/mac/click",
+    "command": [
+        "mac",
+        "click"
+    ],
+    "summary": "Click in a window of the member's Mac, on an element ref from ax-tree or at x and y in window coordinates, without bringing the window forward. Answers the method used. Sensei calls it, and a Chat Session does with --device-id for a device approved for it.",
+    "pathParams": [],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "deviceId",
+                "flag": "device-id",
+                "kind": "string",
+                "required": false,
+                "description": "The device, by the ID `kosuke devices list` prints. A Chat Session names the device it was approved for; Sensei may leave it out for the member’s Mac that is online."
+            },
+            {
+                "name": "app",
+                "flag": "app",
+                "kind": "string",
+                "required": false,
+                "description": "The app, by name or bundle id."
+            },
+            {
+                "name": "pid",
+                "flag": "pid",
+                "kind": "integer",
+                "required": false,
+                "description": "The process id, from `kosuke mac windows`."
+            },
+            {
+                "name": "window",
+                "flag": "window",
+                "kind": "string",
+                "required": false,
+                "description": "A substring of the window title."
+            },
+            {
+                "name": "ref",
+                "flag": "ref",
+                "kind": "string",
+                "required": false,
+                "description": "An element ref from `kosuke mac ax-tree`, such as e12."
+            },
+            {
+                "name": "x",
+                "flag": "x",
+                "kind": "number",
+                "required": false,
+                "description": "Window x, with y, when there is no ref."
+            },
+            {
+                "name": "y",
+                "flag": "y",
+                "kind": "number",
+                "required": false,
+                "description": "Window y, with x, when there is no ref."
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": [
+        "sandboxToken",
+        "senseiToken"
+    ]
+};

package/dist/generated/commands/mac/file-delete.js

@@ -0,0 +1,37 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/devices/mac/file-delete",
+    "command": [
+        "mac",
+        "file-delete"
+    ],
+    "summary": "Move a file on the member's Mac to the Trash. Sensei calls it, and a Chat Session does with --device-id for a device approved for it.",
+    "pathParams": [],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "deviceId",
+                "flag": "device-id",
+                "kind": "string",
+                "required": false,
+                "description": "The device, by the ID `kosuke devices list` prints. A Chat Session names the device it was approved for; Sensei may leave it out for the member’s Mac that is online."
+            },
+            {
+                "name": "path",
+                "flag": "path",
+                "kind": "string",
+                "required": true,
+                "description": "Moved to the Trash."
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": [
+        "sandboxToken",
+        "senseiToken"
+    ]
+};

package/dist/generated/commands/mac/file-list.js

@@ -0,0 +1,37 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/devices/mac/file-list",
+    "command": [
+        "mac",
+        "file-list"
+    ],
+    "summary": "List a folder on the member's Mac, with each entry's name, kind, size and modification time. Sensei calls it, and a Chat Session does with --device-id for a device approved for it.",
+    "pathParams": [],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "deviceId",
+                "flag": "device-id",
+                "kind": "string",
+                "required": false,
+                "description": "The device, by the ID `kosuke devices list` prints. A Chat Session names the device it was approved for; Sensei may leave it out for the member’s Mac that is online."
+            },
+            {
+                "name": "path",
+                "flag": "path",
+                "kind": "string",
+                "required": true,
+                "description": "A path on the Mac. ~ is the member’s home."
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": [
+        "sandboxToken",
+        "senseiToken"
+    ]
+};