@kosuke-ai/kosuke 1.0.14 → 1.0.16

package/dist/generated/commands/integrations/uploads-create.js

@@ -0,0 +1,64 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/agent-integrations/file-uploads",
+    "command": [
+        "integrations",
+        "uploads",
+        "create"
+    ],
+    "summary": "Reserve the upload of one file for an integration tool that takes files, on the connection a call would run on. The answer is a file reference and a URL: PUT the file to the URL with the headers given, then pass the reference as the file argument of that tool on that connection. `kosuke integrations call --file` does all of it, and is the command to use. A failure answers 200 with isError true, as a call does. 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."
+        }
+    ],
+    "body": {
+        "fields": [
+            {
+                "name": "name",
+                "flag": "name",
+                "kind": "string",
+                "required": true,
+                "description": "The tool the file is for, as the tools list names it."
+            },
+            {
+                "name": "account",
+                "flag": "account",
+                "kind": "string",
+                "required": false,
+                "description": "The connection the call will run on: its short id, its alias or scope:label. Needed when several can run the tool."
+            },
+            {
+                "name": "filename",
+                "flag": "filename",
+                "kind": "string",
+                "required": true,
+                "description": "The file name the vendor receives, without a directory."
+            },
+            {
+                "name": "mimetype",
+                "flag": "mimetype",
+                "kind": "string",
+                "required": true,
+                "description": "The MIME type of the file, such as video/mp4."
+            },
+            {
+                "name": "md5",
+                "flag": "md5",
+                "kind": "string",
+                "required": true,
+                "description": "The MD5 digest of the file, in lowercase hex."
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

package/dist/generated/commands/sensei/fyi-move.js

@@ -0,0 +1,42 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/sensei/fyi/move",
+    "command": [
+        "sensei",
+        "fyi",
+        "move"
+    ],
+    "summary": "Move one conversation's parked FYI messages to needs-reply, so its Event Turn drafts a reply card",
+    "pathParams": [],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "card",
+                "flag": "card",
+                "kind": "string",
+                "required": true,
+                "description": "The FYI digest card the member replied to"
+            },
+            {
+                "name": "connection",
+                "flag": "connection",
+                "kind": "string",
+                "required": true,
+                "description": "The connection of the conversation that needs the member"
+            },
+            {
+                "name": "conversation",
+                "flag": "conversation",
+                "kind": "string",
+                "required": true,
+                "description": "The conversation id, as the fyi_digest event and the card name it"
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

package/dist/generated/commands/user/profile-get.js

@@ -6,7 +6,7 @@ export const operation = {
         "profile",
         "get"
     ],
-    "summary": "Read your account: id, email, name, onboarding state, default model, auto-commit setting and Reply Style.",
+    "summary": "Read your account: id, email, name, onboarding state, default model, auto-commit setting, Reply Style and FYI digest interval.",
     "pathParams": [],
     "query": [],
     "body": null,

package/dist/integrations/file-upload.js

@@ -0,0 +1,153 @@
+import { createHash } from 'node:crypto';
+import { createReadStream } from 'node:fs';
+import { stat } from 'node:fs/promises';
+import { basename, extname } from 'node:path';
+import { Readable } from 'node:stream';
+/**
+ * `kosuke integrations call --file <argument>=<path>`: a local file for a tool's file argument.
+ * The platform reserves the upload and answers a file reference; the file goes straight to the
+ * storage URL it names, never through the platform, so a large video costs the platform nothing.
+ */
+export const FILE_UPLOAD_PATH = '/api/agent-integrations/file-uploads';
+/** The storage takes one PUT of at most 5 GiB. */
+export const MAX_FILE_BYTES = 5 * 1024 ** 3;
+const NAME = /^[A-Za-z_][A-Za-z0-9_-]{0,63}$/;
+const INDEX = /^\d{1,4}$/;
+const UNSAFE = new Set(['__proto__', 'constructor', 'prototype']);
+/** `videoFilePath=./clip.mp4`, or `attachment.0=./a.pdf` for a file inside a list or object. */
+export function parseFileArgument(raw) {
+    const split = raw.indexOf('=');
+    if (split <= 0 || split === raw.length - 1)
+        return null;
+    const at = raw.slice(0, split).split('.');
+    const path = raw.slice(split + 1);
+    if (!NAME.test(at[0]))
+        return null;
+    if (at.some((segment) => UNSAFE.has(segment) || !(NAME.test(segment) || INDEX.test(segment)))) {
+        return null;
+    }
+    return { at, path };
+}
+/** Puts `value` at `at`, making the lists and objects on the way; false when one is in the way. */
+export function setAt(args, at, value) {
+    let parent = args;
+    for (let index = 0; index < at.length; index += 1) {
+        const segment = at[index];
+        const last = index === at.length - 1;
+        const nextIsIndex = !last && INDEX.test(at[index + 1]);
+        if (Array.isArray(parent)) {
+            if (!INDEX.test(segment))
+                return false;
+            const position = Number(segment);
+            if (position > parent.length)
+                return false;
+            if (last) {
+                parent[position] = value;
+                return true;
+            }
+            parent[position] ??= nextIsIndex ? [] : {};
+            const child = parent[position];
+            if (typeof child !== 'object' || child === null)
+                return false;
+            parent = child;
+            continue;
+        }
+        if (INDEX.test(segment))
+            return false;
+        if (last) {
+            parent[segment] = value;
+            return true;
+        }
+        if (!Object.hasOwn(parent, segment))
+            parent[segment] = nextIsIndex ? [] : {};
+        const child = parent[segment];
+        if (typeof child !== 'object' || child === null)
+            return false;
+        if (nextIsIndex !== Array.isArray(child))
+            return false;
+        parent = child;
+    }
+    return false;
+}
+const MIME_TYPES = {
+    '.3gp': 'video/3gpp',
+    '.avi': 'video/x-msvideo',
+    '.flv': 'video/x-flv',
+    '.m4v': 'video/x-m4v',
+    '.mkv': 'video/x-matroska',
+    '.mov': 'video/quicktime',
+    '.mp4': 'video/mp4',
+    '.mpeg': 'video/mpeg',
+    '.mpg': 'video/mpeg',
+    '.webm': 'video/webm',
+    '.wmv': 'video/x-ms-wmv',
+    '.mp3': 'audio/mpeg',
+    '.m4a': 'audio/mp4',
+    '.wav': 'audio/wav',
+    '.ogg': 'audio/ogg',
+    '.srt': 'application/x-subrip',
+    '.vtt': 'text/vtt',
+    '.sbv': 'text/plain',
+    '.ttml': 'application/ttml+xml',
+    '.dfxp': 'application/ttml+xml',
+    '.scc': 'text/plain',
+    '.gif': 'image/gif',
+    '.jpeg': 'image/jpeg',
+    '.jpg': 'image/jpeg',
+    '.png': 'image/png',
+    '.svg': 'image/svg+xml',
+    '.webp': 'image/webp',
+    '.csv': 'text/csv',
+    '.html': 'text/html',
+    '.json': 'application/json',
+    '.md': 'text/markdown',
+    '.txt': 'text/plain',
+    '.xml': 'application/xml',
+    '.pdf': 'application/pdf',
+    '.zip': 'application/zip',
+    '.doc': 'application/msword',
+    '.docx': 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+    '.xls': 'application/vnd.ms-excel',
+    '.xlsx': 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
+    '.ppt': 'application/vnd.ms-powerpoint',
+    '.pptx': 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
+};
+export function mimetypeOf(name) {
+    return MIME_TYPES[extname(name).toLowerCase()] ?? 'application/octet-stream';
+}
+/** The name the vendor receives: the base name, when the platform can take it. */
+export function uploadName(path) {
+    const name = basename(path);
+    return name.length > 0 && name.length <= 255 && !/[/\\\p{Cc}]/u.test(name) ? name : null;
+}
+export async function fileSize(path) {
+    try {
+        const info = await stat(path);
+        return info.isFile() ? info.size : null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function md5Of(path) {
+    const hash = createHash('md5');
+    for await (const chunk of createReadStream(path))
+        hash.update(chunk);
+    return hash.digest('hex');
+}
+/**
+ * One PUT of the whole file. The length is stated because the storage refuses a chunked upload,
+ * and the file is streamed so a large video is never held in memory.
+ */
+export async function putFile(fetch, upload, path, size, mimetype, signal) {
+    const response = await fetch(upload.url, {
+        method: 'PUT',
+        headers: { ...upload.headers, 'content-type': mimetype, 'content-length': String(size) },
+        body: Readable.toWeb(createReadStream(path)),
+        duplex: 'half',
+        redirect: 'error',
+        signal,
+    });
+    await response.body?.cancel().catch(() => undefined);
+    return response.status;
+}

package/openapi.json

@@ -232,6 +232,107 @@
         }
       }
     },
+    "/api/agent-integrations/file-uploads": {
+      "post": {
+        "operationId": "integrationsUploadsCreate",
+        "summary": "Reserve the upload of one file for an integration tool that takes files, on the connection a call would run on. The answer is a file reference and a URL: PUT the file to the URL with the headers given, then pass the reference as the file argument of that tool on that connection. `kosuke integrations call --file` does all of it, and is the command to use. A failure answers 200 with isError true, as a call does. A Connector Token or a browser session is refused.",
+        "tags": ["integrations"],
+        "x-kosuke-command": ["integrations", "uploads", "create"],
+        "x-kosuke-sandbox-token": true,
+        "x-kosuke-cron-token": true,
+        "x-kosuke-sensei-token": true,
+        "parameters": [
+          {
+            "name": "workspace",
+            "in": "query",
+            "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.",
+            "schema": {
+              "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.",
+              "type": "string",
+              "minLength": 1,
+              "maxLength": 100
+            }
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 80,
+                    "description": "The tool the file is for, as the tools list names it."
+                  },
+                  "account": {
+                    "description": "The connection the call will run on: its short id, its alias or scope:label. Needed when several can run the tool.",
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 100
+                  },
+                  "filename": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 255,
+                    "pattern": "^[^/\\\\\\p{Cc}]+$",
+                    "description": "The file name the vendor receives, without a directory."
+                  },
+                  "mimetype": {
+                    "type": "string",
+                    "maxLength": 255,
+                    "pattern": "^[a-z0-9][a-z0-9!#$&^_.+-]*\\/[a-z0-9][a-z0-9!#$&^_.+-]*$",
+                    "description": "The MIME type of the file, such as video/mp4."
+                  },
+                  "md5": {
+                    "type": "string",
+                    "pattern": "^[a-f0-9]{32}$",
+                    "description": "The MD5 digest of the file, in lowercase hex."
+                  }
+                },
+                "required": ["name", "filename", "mimetype", "md5"],
+                "additionalProperties": false
+              }
+            }
+          }
+        },
+        "responses": {
+          "2XX": {
+            "description": "Success envelope",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiSuccess"
+                }
+              }
+            }
+          },
+          "4XX": {
+            "description": "Error envelope",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          },
+          "5XX": {
+            "description": "Error envelope",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/api/agent-integrations/tools": {
       "get": {
         "operationId": "integrationsToolsList",
@@ -20848,6 +20949,72 @@
                             }
                           },
                           "required": ["type", "title", "items"]
+                        },
+                        {
+                          "type": "object",
+                          "properties": {
+                            "type": {
+                              "type": "string",
+                              "const": "messages"
+                            },
+                            "caption": {
+                              "type": "string",
+                              "minLength": 1,
+                              "maxLength": 120
+                            },
+                            "rows": {
+                              "minItems": 1,
+                              "maxItems": 12,
+                              "type": "array",
+                              "items": {
+                                "type": "object",
+                                "properties": {
+                                  "network": {
+                                    "type": "string",
+                                    "enum": ["gmail", "slack", "telegram", "whatsapp"]
+                                  },
+                                  "sender": {
+                                    "type": "string",
+                                    "minLength": 1,
+                                    "maxLength": 60
+                                  },
+                                  "subject": {
+                                    "type": "string",
+                                    "minLength": 1,
+                                    "maxLength": 200
+                                  },
+                                  "count": {
+                                    "type": "integer",
+                                    "exclusiveMinimum": 0,
+                                    "maximum": 9007199254740991
+                                  },
+                                  "at": {
+                                    "type": "string",
+                                    "minLength": 1,
+                                    "maxLength": 20
+                                  }
+                                },
+                                "required": ["network", "sender", "subject", "count", "at"]
+                              }
+                            },
+                            "older": {
+                              "type": "object",
+                              "properties": {
+                                "conversations": {
+                                  "type": "integer",
+                                  "exclusiveMinimum": 0,
+                                  "maximum": 9007199254740991
+                                },
+                                "messages": {
+                                  "type": "integer",
+                                  "exclusiveMinimum": 0,
+                                  "maximum": 9007199254740991
+                                }
+                              },
+                              "required": ["conversations", "messages"]
+                            }
+                          },
+                          "required": ["type", "rows"]
                         }
                       ]
                     }
@@ -20987,6 +21154,9 @@
                           "messages": {
                             "not": {}
                           },
+                          "messagesDigest": {
+                            "not": {}
+                          },
                           "projectId": {
                             "not": {}
                           },
@@ -21058,6 +21228,9 @@
                           },
                           "messages": {
                             "not": {}
+                          },
+                          "messagesDigest": {
+                            "not": {}
                           }
                         },
                         "required": ["projectId"]
@@ -21081,6 +21254,9 @@
                           "messages": {
                             "not": {}
                           },
+                          "messagesDigest": {
+                            "not": {}
+                          },
                           "projectId": {
                             "not": {}
                           },
@@ -21119,6 +21295,9 @@
                           "messages": {
                             "not": {}
                           },
+                          "messagesDigest": {
+                            "not": {}
+                          },
                           "projectId": {
                             "not": {}
                           },
@@ -21164,6 +21343,9 @@
                             "required": ["connection", "conversation"],
                             "additionalProperties": false
                           },
+                          "messagesDigest": {
+                            "not": {}
+                          },
                           "memory": {
                             "not": {}
                           },
@@ -21189,6 +21371,47 @@
                         "required": ["messages"],
                         "additionalProperties": false
                       },
+                      {
+                        "type": "object",
+                        "properties": {
+                          "nudge": {
+                            "not": {}
+                          },
+                          "job": {
+                            "not": {}
+                          },
+                          "messages": {
+                            "not": {}
+                          },
+                          "messagesDigest": {
+                            "type": "boolean",
+                            "const": true
+                          },
+                          "memory": {
+                            "not": {}
+                          },
+                          "integration": {
+                            "not": {}
+                          },
+                          "projectId": {
+                            "not": {}
+                          },
+                          "sessionId": {
+                            "not": {}
+                          },
+                          "pullRequest": {
+                            "not": {}
+                          },
+                          "cronId": {
+                            "not": {}
+                          },
+                          "deployJobId": {
+                            "not": {}
+                          }
+                        },
+                        "required": ["messagesDigest"],
+                        "additionalProperties": false
+                      },
                       {
                         "type": "object",
                         "properties": {
@@ -21221,6 +21444,9 @@
                           "messages": {
                             "not": {}
                           },
+                          "messagesDigest": {
+                            "not": {}
+                          },
                           "projectId": {
                             "not": {}
                           },
@@ -21290,7 +21516,7 @@
                           },
                           "rows": {
                             "minItems": 1,
-                            "maxItems": 12,
+                            "maxItems": 50,
                             "type": "array",
                             "items": {
                               "type": "object",
@@ -22204,6 +22430,81 @@
         }
       }
     },
+    "/api/sensei/fyi/move": {
+      "post": {
+        "operationId": "senseiFyiMove",
+        "summary": "Move one conversation's parked FYI messages to needs-reply, so its Event Turn drafts a reply card",
+        "tags": ["sensei"],
+        "x-kosuke-command": ["sensei", "fyi", "move"],
+        "x-kosuke-sandbox-token": true,
+        "x-kosuke-cron-token": true,
+        "x-kosuke-sensei-token": true,
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "card": {
+                    "type": "string",
+                    "format": "uuid",
+                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+                    "description": "The FYI digest card the member replied to"
+                  },
+                  "connection": {
+                    "type": "string",
+                    "format": "uuid",
+                    "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+                    "description": "The connection of the conversation that needs the member"
+                  },
+                  "conversation": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 512,
+                    "description": "The conversation id, as the fyi_digest event and the card name it"
+                  }
+                },
+                "required": ["card", "connection", "conversation"],
+                "additionalProperties": false
+              }
+            }
+          }
+        },
+        "responses": {
+          "2XX": {
+            "description": "Success envelope",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiSuccess"
+                }
+              }
+            }
+          },
+          "4XX": {
+            "description": "Error envelope",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          },
+          "5XX": {
+            "description": "Error envelope",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/api/sensei/memory": {
       "get": {
         "operationId": "senseiMemoryGet",
@@ -26316,7 +26617,7 @@
     "/api/user/profile": {
       "get": {
         "operationId": "userProfileGet",
-        "summary": "Read your account: id, email, name, onboarding state, default model, auto-commit setting and Reply Style.",
+        "summary": "Read your account: id, email, name, onboarding state, default model, auto-commit setting, Reply Style and FYI digest interval.",
         "tags": ["user"],
         "x-kosuke-command": ["user", "profile", "get"],
         "x-kosuke-sandbox-token": true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kosuke-ai/kosuke",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "description": "Kosuke platform CLI. The client customers install to drive app.kosuke.ai from their own machine.",
   "license": "MIT",
   "repository": {
@@ -40,11 +40,10 @@
     "vitest": "^4.1.12"
   },
   "kosukeRelease": {
-    "sourceCommit": "76f5440713c26ece8b7a10148e2756fcda195399",
-    "sourceIdentity": "6d76d9b36ed84006ecffb3cbf97a91c26c66ebf3596e530a3aa342cbb7421ed0",
+    "sourceCommit": "ab85cf946cdc768b0b0a051ea9a25426f03f56d2",
+    "sourceIdentity": "54461d5b39b8b5ac97df0fa3bf085e169b29ed7454ee8b09efbc26b40b8085ce",
     "fragments": [
-      "devices-list-occupied-mmw6bi.json",
-      "task-requested-branch.json"
+      "sensei-fyi-move.json"
     ]
   }
 }