@ashulab/carrier 0.0.0-stage → 0.1.0

package/dist/chat/migrations/meta/0005_snapshot.json

@@ -0,0 +1,334 @@
+{
+  "version": "6",
+  "dialect": "sqlite",
+  "id": "6cb6556e-bc67-49c1-9183-85fa2da88fd8",
+  "prevId": "e9c3e32d-c642-40dd-854c-c7b2eb0a53b7",
+  "tables": {
+    "chat_events": {
+      "name": "chat_events",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "integer",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": true
+        },
+        "sessionId": {
+          "name": "sessionId",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "at": {
+          "name": "at",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "kind": {
+          "name": "kind",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "data": {
+          "name": "data",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        }
+      },
+      "indexes": {
+        "chat_events_session": {
+          "name": "chat_events_session",
+          "columns": [
+            "sessionId",
+            "id"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "chat_events_sessionId_sessions_id_fk": {
+          "name": "chat_events_sessionId_sessions_id_fk",
+          "tableFrom": "chat_events",
+          "tableTo": "sessions",
+          "columnsFrom": [
+            "sessionId"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "chat_turns": {
+      "name": "chat_turns",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "integer",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": true
+        },
+        "sessionId": {
+          "name": "sessionId",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "startedAt": {
+          "name": "startedAt",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "model": {
+          "name": "model",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "outcome": {
+          "name": "outcome",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "durationMs": {
+          "name": "durationMs",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "toolCalls": {
+          "name": "toolCalls",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "usage": {
+          "name": "usage",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        }
+      },
+      "indexes": {
+        "chat_turns_session": {
+          "name": "chat_turns_session",
+          "columns": [
+            "sessionId"
+          ],
+          "isUnique": false
+        }
+      },
+      "foreignKeys": {
+        "chat_turns_sessionId_sessions_id_fk": {
+          "name": "chat_turns_sessionId_sessions_id_fk",
+          "tableFrom": "chat_turns",
+          "tableTo": "sessions",
+          "columnsFrom": [
+            "sessionId"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "no action",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "sessions": {
+      "name": "sessions",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "agent": {
+          "name": "agent",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "harness": {
+          "name": "harness",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "folder": {
+          "name": "folder",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "workspaceKind": {
+          "name": "workspaceKind",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'folder'"
+        },
+        "worktreeBranch": {
+          "name": "worktreeBranch",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "worktreeFrom": {
+          "name": "worktreeFrom",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "worktreeBase": {
+          "name": "worktreeBase",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "worktreePath": {
+          "name": "worktreePath",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "title": {
+          "name": "title",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "options": {
+          "name": "options",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "plan": {
+          "name": "plan",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "nativeId": {
+          "name": "nativeId",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "state": {
+          "name": "state",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": "'idle'"
+        },
+        "pid": {
+          "name": "pid",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "pgid": {
+          "name": "pgid",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "command": {
+          "name": "command",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "createdAt": {
+          "name": "createdAt",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "lastActiveAt": {
+          "name": "lastActiveAt",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "archived": {
+          "name": "archived",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "keptAt": {
+          "name": "keptAt",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    }
+  },
+  "views": {},
+  "enums": {},
+  "_meta": {
+    "schemas": {},
+    "tables": {},
+    "columns": {}
+  },
+  "internal": {
+    "indexes": {}
+  }
+}

package/dist/chat/migrations/meta/_journal.json

@@ -0,0 +1,48 @@
+{
+  "version": "7",
+  "dialect": "sqlite",
+  "entries": [
+    {
+      "idx": 0,
+      "version": "6",
+      "when": 1793147024821,
+      "tag": "0000_lame_quasar",
+      "breakpoints": true
+    },
+    {
+      "idx": 1,
+      "version": "6",
+      "when": 1793147813563,
+      "tag": "0001_quiet_penance",
+      "breakpoints": true
+    },
+    {
+      "idx": 2,
+      "version": "6",
+      "when": 1793148987442,
+      "tag": "0002_slim_ezekiel_stane",
+      "breakpoints": true
+    },
+    {
+      "idx": 3,
+      "version": "6",
+      "when": 1793197685547,
+      "tag": "0003_naive_iron_lad",
+      "breakpoints": true
+    },
+    {
+      "idx": 4,
+      "version": "6",
+      "when": 1793839872276,
+      "tag": "0004_skinny_dakota_north",
+      "breakpoints": true
+    },
+    {
+      "idx": 5,
+      "version": "6",
+      "when": 1793882078864,
+      "tag": "0005_tidy_strong_guy",
+      "breakpoints": true
+    }
+  ]
+}

package/dist/chat/names.js

@@ -0,0 +1,97 @@
+import { lstatSync } from 'node:fs';
+import { basename, join, sep } from 'node:path';
+import { carrierHome } from '../config/default-path.js';
+import { ChatRefused } from './runner.js';
+import { adjectives, places, units } from './words.js';
+import { inspectFolder } from './workspace.js';
+/** Every worktree branch is `carrier/<name>`; a name is the part after this prefix. */
+export const BRANCH_PREFIX = 'carrier/';
+const MAX_NAME = 60;
+const ROLLS = 50;
+/** Why `name` cannot be one, in words, or null when it can: lowercase letters, digits, `-`, `_` and `.`, starting with a letter or a digit, at most 60 characters, and a valid git ref name. */
+export function invalidReason(name) {
+    if (name === '')
+        return 'The name is empty';
+    if (name.length > MAX_NAME)
+        return `The name is longer than ${MAX_NAME} characters`;
+    if (/^[a-z0-9]/.test(name) === false)
+        return 'The name must start with a lowercase letter or a digit';
+    if (/^[a-z0-9._-]+$/.test(name) === false)
+        return 'The name may only have lowercase letters, digits, hyphens, underscores and dots';
+    if (name.includes('..'))
+        return 'The name cannot have two dots in a row';
+    if (name.endsWith('.'))
+        return 'The name cannot end with a dot';
+    if (name.endsWith('.lock'))
+        return 'The name cannot end with .lock';
+    return null;
+}
+/** `<adjective>-<unit>-<place>`, each word picked with `random` (a number in [0, 1), `Math.random` by default). */
+export function generateName(random = Math.random) {
+    const pick = (words) => words[Math.floor(random() * words.length)];
+    return `${pick(adjectives)}-${pick(units)}-${pick(places)}`;
+}
+/** Where every session worktree lives. */
+export const worktreesDir = () => join(carrierHome(), 'chat', 'worktrees');
+/** Where a worktree called `name` of this repository lives: `<CARRIER_HOME>/chat/worktrees/<owner>/<repo>/<name>`, or `local/<folder name>` without a GitHub origin. A path that would lie anywhere else is refused. */
+export function worktreePath(info, name) {
+    const [owner, repo] = info.repo === null ? ['local', basename(info.folder)] : [info.repo.owner, info.repo.name];
+    const path = join(worktreesDir(), owner, repo, name);
+    if (path.startsWith(worktreesDir() + sep) === false)
+        throw new ChatRefused('That worktree would not be inside Carrier\'s worktrees folder');
+    return path;
+}
+/** Whether something is at `path`. Only a path that cannot exist answers false; any other error is not a free name. */
+const exists = (path) => {
+    try {
+        lstatSync(path);
+        return true;
+    }
+    catch (error) {
+        if (['ENOENT', 'ENOTDIR'].includes(error.code ?? ''))
+            return false;
+        throw error;
+    }
+};
+/** What a name is up against in a repository: the three places where `carrier/<name>` must not exist yet. */
+export async function repository(git, folder) {
+    const info = await inspectFolder(git, folder);
+    if (info.git === false)
+        throw new ChatRefused('Worktrees need a git repository');
+    if (info.bare)
+        throw new ChatRefused('Worktrees need a git repository with a working folder, and this one is bare');
+    const has = (branch) => info.branches.some((candidate) => candidate.name === branch);
+    /** Why a valid name is taken, in words, or null when it is free. */
+    const takenBecause = (name) => {
+        if (has(`${BRANCH_PREFIX}${name}`))
+            return `A branch called ${BRANCH_PREFIX}${name} already exists`;
+        if (has(`origin/${BRANCH_PREFIX}${name}`))
+            return `The remote already has a branch called ${BRANCH_PREFIX}${name}`;
+        if (exists(worktreePath(info, name)))
+            return 'A folder for that worktree already exists';
+        return null;
+    };
+    /** A generated name that is free, rolled again while it is taken and never numbered. */
+    const freeName = (random = Math.random) => {
+        for (let roll = 0; roll < ROLLS; roll++) {
+            const name = generateName(random);
+            if (takenBecause(name) === null)
+                return name;
+        }
+        throw new ChatRefused(`Every name that was tried (${ROLLS}) is already taken; type one instead`);
+    };
+    return { info, takenBecause, freeName };
+}
+/** A free name for a worktree of `folder` (already checked, a real path). */
+export async function suggestName(git, folder, random) {
+    return { name: (await repository(git, folder)).freeName(random) };
+}
+/** Whether a name typed for a worktree of `folder` (already checked, a real path) is valid and free, and why not when it is not. */
+export async function checkName(git, folder, name) {
+    const { takenBecause } = await repository(git, folder);
+    const invalid = invalidReason(name);
+    if (invalid !== null)
+        return { valid: false, free: false, reason: invalid };
+    const taken = takenBecause(name);
+    return taken === null ? { valid: true, free: true } : { valid: true, free: false, reason: taken };
+}

package/dist/chat/plan.js

@@ -0,0 +1,21 @@
+import { z } from 'zod';
+import { repoNamePattern } from '../config/schema.js';
+import { projectNamePattern } from './projects.js';
+// Never a leading dash (it would be an option of git) nor whitespace.
+const branch = z.string().min(1).max(1000).regex(/^[^-\s][^\s]*$/);
+const workspace = z.discriminatedUnion('kind', [
+    z.strictObject({ kind: z.literal('folder'), folder: z.string().min(1) }),
+    z.strictObject({ kind: z.literal('repo'), repo: z.string().regex(repoNamePattern) }),
+    z.strictObject({ kind: z.literal('project'), name: z.string().regex(projectNamePattern) }),
+]);
+/** What a new session is before it exists: where it works, which agent, and the first message. The host prepares it when it is sent. */
+export const plan = z
+    .strictObject({
+    workspace,
+    agent: z.string().min(1),
+    options: z.record(z.string(), z.string()).optional(),
+    text: z.string().min(1),
+    branch: branch.optional(),
+    worktree: z.strictObject({ name: z.string().max(1000).optional() }).optional(),
+})
+    .refine((p) => p.workspace.kind !== 'project' || (p.branch === undefined && p.worktree === undefined)); // a project has no commits