@autono/pinbox-core 0.1.0

package/dist/schema.json

@@ -0,0 +1,403 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "properties": {
+    "text": {
+      "type": "string",
+      "minLength": 1
+    },
+    "kind": {
+      "default": "note",
+      "type": "string",
+      "enum": [
+        "note",
+        "move"
+      ]
+    },
+    "target": {
+      "type": "object",
+      "properties": {
+        "url": {
+          "type": "string"
+        },
+        "selector": {
+          "type": "string"
+        },
+        "tag": {
+          "type": "string"
+        },
+        "rect": {
+          "type": "object",
+          "properties": {
+            "x": {
+              "type": "number"
+            },
+            "y": {
+              "type": "number"
+            },
+            "width": {
+              "type": "number"
+            },
+            "height": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "x",
+            "y",
+            "width",
+            "height"
+          ],
+          "additionalProperties": false
+        },
+        "fixed": {
+          "type": "boolean"
+        },
+        "anchor": {
+          "type": "string"
+        },
+        "source": {
+          "type": "object",
+          "properties": {
+            "file": {
+              "type": "string"
+            },
+            "line": {
+              "type": "number"
+            },
+            "via": {
+              "type": "string",
+              "enum": [
+                "plugin",
+                "framework",
+                "none"
+              ]
+            }
+          },
+          "required": [
+            "file",
+            "via"
+          ],
+          "additionalProperties": false
+        },
+        "context": {
+          "type": "object",
+          "properties": {
+            "classes": {
+              "type": "array",
+              "items": {
+                "type": "string"
+              }
+            },
+            "styles": {
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {
+                "type": "string"
+              }
+            },
+            "aria": {
+              "type": "object",
+              "propertyNames": {
+                "type": "string"
+              },
+              "additionalProperties": {
+                "type": "string"
+              }
+            },
+            "nearbyText": {
+              "type": "string"
+            },
+            "selectedText": {
+              "type": "string"
+            }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+    "move": {
+      "type": "object",
+      "properties": {
+        "from": {
+          "type": "object",
+          "properties": {
+            "x": {
+              "type": "number"
+            },
+            "y": {
+              "type": "number"
+            },
+            "width": {
+              "type": "number"
+            },
+            "height": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "x",
+            "y",
+            "width",
+            "height"
+          ],
+          "additionalProperties": false
+        },
+        "to": {
+          "type": "object",
+          "properties": {
+            "x": {
+              "type": "number"
+            },
+            "y": {
+              "type": "number"
+            },
+            "width": {
+              "type": "number"
+            },
+            "height": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "x",
+            "y",
+            "width",
+            "height"
+          ],
+          "additionalProperties": false
+        }
+      },
+      "required": [
+        "from",
+        "to"
+      ],
+      "additionalProperties": false
+    },
+    "env": {
+      "type": "object",
+      "properties": {
+        "viewport": {
+          "type": "object",
+          "properties": {
+            "w": {
+              "type": "number"
+            },
+            "h": {
+              "type": "number"
+            },
+            "dpr": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "w",
+            "h",
+            "dpr"
+          ],
+          "additionalProperties": false
+        },
+        "browser": {
+          "type": "string"
+        },
+        "os": {
+          "type": "string"
+        },
+        "colorScheme": {
+          "type": "string",
+          "enum": [
+            "light",
+            "dark"
+          ]
+        },
+        "branch": {
+          "type": "string"
+        },
+        "commit": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    },
+    "author": {
+      "type": "object",
+      "properties": {
+        "userId": {
+          "type": "string"
+        },
+        "name": {
+          "type": "string"
+        },
+        "email": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "userId"
+      ],
+      "additionalProperties": false
+    },
+    "agentSession": {
+      "type": "object",
+      "properties": {
+        "agent": {
+          "type": "string"
+        },
+        "key": {
+          "type": "string"
+        },
+        "cwd": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "agent",
+        "key"
+      ],
+      "additionalProperties": false
+    },
+    "attachments": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "kind": {
+            "type": "string",
+            "enum": [
+              "screenshot",
+              "file"
+            ]
+          },
+          "path": {
+            "type": "string"
+          },
+          "url": {
+            "type": "string"
+          },
+          "contentType": {
+            "type": "string"
+          },
+          "width": {
+            "type": "integer",
+            "minimum": -9007199254740991,
+            "maximum": 9007199254740991
+          },
+          "height": {
+            "type": "integer",
+            "minimum": -9007199254740991,
+            "maximum": 9007199254740991
+          }
+        },
+        "required": [
+          "id",
+          "kind"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^pin_[a-z0-9]{10}$"
+    },
+    "schemaVersion": {
+      "type": "number",
+      "const": 1
+    },
+    "status": {
+      "default": "open",
+      "type": "string",
+      "enum": [
+        "open",
+        "resolved"
+      ]
+    },
+    "createdAt": {
+      "type": "string"
+    },
+    "resolution": {
+      "type": "object",
+      "properties": {
+        "by": {
+          "type": "string",
+          "enum": [
+            "human",
+            "agent"
+          ]
+        },
+        "note": {
+          "type": "string"
+        },
+        "commit": {
+          "type": "string"
+        },
+        "at": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "by",
+        "at"
+      ],
+      "additionalProperties": false
+    },
+    "verification": {
+      "type": "object",
+      "properties": {
+        "outcome": {
+          "type": "string",
+          "enum": [
+            "accepted",
+            "reopened"
+          ]
+        },
+        "at": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "outcome",
+        "at"
+      ],
+      "additionalProperties": false
+    },
+    "links": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "connector": {
+            "type": "string"
+          },
+          "ref": {
+            "type": "string"
+          },
+          "url": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "connector",
+          "ref",
+          "url"
+        ],
+        "additionalProperties": false
+      }
+    }
+  },
+  "required": [
+    "text",
+    "kind",
+    "author",
+    "id",
+    "schemaVersion",
+    "status",
+    "createdAt"
+  ],
+  "additionalProperties": false
+}

package/dist/sessions-CJdMBH3C.d.ts

@@ -0,0 +1,47 @@
+import { f as SessionRef } from "./schema-BOTmn5SM.js";
+import { z } from "zod";
+import { Database } from "bun:sqlite";
+//#region src/trailer.d.ts
+/** Unique pin ids named by resolution trailers, in order of appearance. */
+declare function parseTrailers(message: string): string[];
+//#endregion
+//#region src/sessions.d.ts
+declare const SessionSchema: z.ZodObject<{
+  id: z.ZodString;
+  agent: z.ZodString;
+  key: z.ZodString;
+  cwd: z.ZodOptional<z.ZodString>;
+  registeredAt: z.ZodString;
+  lastSeenAt: z.ZodString;
+  endedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type Session = z.infer<typeof SessionSchema>;
+interface SessionStore {
+  register(ref: SessionRef): Session;
+  get(id: string): Session | null;
+  findByRef(ref: Pick<SessionRef, "agent" | "key">): Session | null;
+  active(): Session | null;
+  list(): Session[];
+  touch(id: string): void;
+  end(id: string): void;
+}
+declare class SqliteSessionStore implements SessionStore {
+  private readonly insert;
+  private readonly update;
+  private readonly selectById;
+  private readonly selectByRef;
+  private readonly selectActive;
+  private readonly selectAll;
+  constructor(db: Database);
+  register(ref: SessionRef): Session;
+  get(id: string): Session | null;
+  findByRef(ref: Pick<SessionRef, "agent" | "key">): Session | null;
+  active(): Session | null;
+  list(): Session[];
+  touch(id: string): void;
+  end(id: string): void;
+  private write;
+  private mustGet;
+}
+//#endregion
+export { parseTrailers as a, SqliteSessionStore as i, SessionSchema as n, SessionStore as r, Session as t };

package/dist/sessions-DrCVTMfI.js

@@ -0,0 +1,129 @@
+import { z } from "zod";
+//#region src/id.ts
+const ALPHABET = "abcdefghijklmnopqrstuvwxyz0123456789";
+function newId(prefix) {
+	const bytes = /* @__PURE__ */ new Uint8Array(10);
+	crypto.getRandomValues(bytes);
+	let out = "";
+	for (const b of bytes) out += ALPHABET[b % 36];
+	return `${prefix}_${out}`;
+}
+//#endregion
+//#region src/store-errors.ts
+/** The addressed row does not exist. Mapped to 404 / `E_NOT_FOUND` by the hub. */
+var NotFoundError = class extends Error {};
+/** The write conflicts with current state (e.g. resolving an already-resolved pin). 409 / `E_CONFLICT`. */
+var ConflictError = class extends Error {};
+//#endregion
+//#region src/trailer.ts
+const TRAILER = /\b(?:fixes|resolves|closes):?\s+(?:pin\s+)?(pin_[a-z0-9]{10})\b/gi;
+/** Unique pin ids named by resolution trailers, in order of appearance. */
+function parseTrailers(message) {
+	const ids = [];
+	for (const match of message.matchAll(TRAILER)) {
+		const id = match[1];
+		if (id !== void 0 && !ids.includes(id)) ids.push(id);
+	}
+	return ids;
+}
+//#endregion
+//#region src/sessions.ts
+const SessionSchema = z.object({
+	id: z.string().regex(/^ses_[a-z0-9]{10}$/),
+	agent: z.string(),
+	key: z.string(),
+	cwd: z.string().optional(),
+	registeredAt: z.string(),
+	lastSeenAt: z.string(),
+	endedAt: z.string().optional()
+});
+var JsonRow = class {
+	json;
+};
+function parseSession(json) {
+	return SessionSchema.parse(JSON.parse(json));
+}
+var SqliteSessionStore = class {
+	insert;
+	update;
+	selectById;
+	selectByRef;
+	selectActive;
+	selectAll;
+	constructor(db) {
+		this.insert = db.query(`INSERT INTO sessions (id, agent, key, cwd, registered_at, last_seen_at, ended_at, json)
+       VALUES (?, ?, ?, ?, ?, ?, NULL, ?)`);
+		this.update = db.query("UPDATE sessions SET cwd = ?, last_seen_at = ?, ended_at = ?, json = ? WHERE id = ?");
+		this.selectById = db.query("SELECT json FROM sessions WHERE id = ?").as(JsonRow);
+		this.selectByRef = db.query("SELECT json FROM sessions WHERE agent = ? AND key = ?").as(JsonRow);
+		this.selectActive = db.query(`SELECT json FROM sessions WHERE ended_at IS NULL
+         ORDER BY last_seen_at DESC, rowid DESC LIMIT 1`).as(JsonRow);
+		this.selectAll = db.query("SELECT json FROM sessions ORDER BY last_seen_at DESC, rowid DESC").as(JsonRow);
+	}
+	register(ref) {
+		const now = (/* @__PURE__ */ new Date()).toISOString();
+		const existing = this.findByRef(ref);
+		if (existing) {
+			const cwd = ref.cwd ?? existing.cwd;
+			const session = SessionSchema.parse({
+				id: existing.id,
+				agent: existing.agent,
+				key: existing.key,
+				...cwd !== void 0 ? { cwd } : {},
+				registeredAt: existing.registeredAt,
+				lastSeenAt: now
+			});
+			this.write(session);
+			return session;
+		}
+		const session = SessionSchema.parse({
+			id: newId("ses"),
+			agent: ref.agent,
+			key: ref.key,
+			...ref.cwd !== void 0 ? { cwd: ref.cwd } : {},
+			registeredAt: now,
+			lastSeenAt: now
+		});
+		this.insert.run(session.id, session.agent, session.key, session.cwd ?? null, session.registeredAt, session.lastSeenAt, JSON.stringify(session));
+		return session;
+	}
+	get(id) {
+		const row = this.selectById.get(id);
+		return row ? parseSession(row.json) : null;
+	}
+	findByRef(ref) {
+		const row = this.selectByRef.get(ref.agent, ref.key);
+		return row ? parseSession(row.json) : null;
+	}
+	active() {
+		const row = this.selectActive.get();
+		return row ? parseSession(row.json) : null;
+	}
+	list() {
+		return this.selectAll.all().map((r) => parseSession(r.json));
+	}
+	touch(id) {
+		const session = this.mustGet(id);
+		this.write({
+			...session,
+			lastSeenAt: (/* @__PURE__ */ new Date()).toISOString()
+		});
+	}
+	end(id) {
+		const session = this.mustGet(id);
+		this.write({
+			...session,
+			endedAt: (/* @__PURE__ */ new Date()).toISOString()
+		});
+	}
+	write(session) {
+		this.update.run(session.cwd ?? null, session.lastSeenAt, session.endedAt ?? null, JSON.stringify(session), session.id);
+	}
+	mustGet(id) {
+		const session = this.get(id);
+		if (!session) throw new NotFoundError(`session not found: ${id}`);
+		return session;
+	}
+};
+//#endregion
+export { NotFoundError as a, ConflictError as i, SqliteSessionStore as n, newId as o, parseTrailers as r, SessionSchema as t };

package/dist/sessions.d.ts

@@ -0,0 +1,2 @@
+import { a as parseTrailers, i as SqliteSessionStore, n as SessionSchema, r as SessionStore, t as Session } from "./sessions-CJdMBH3C.js";
+export { Session, SessionSchema, SessionStore, SqliteSessionStore, parseTrailers };

package/dist/sessions.js

@@ -0,0 +1,2 @@
+import { n as SqliteSessionStore, r as parseTrailers, t as SessionSchema } from "./sessions-DrCVTMfI.js";
+export { SessionSchema, SqliteSessionStore, parseTrailers };

package/dist/store-DHbwWu93.d.ts

@@ -0,0 +1,105 @@
+import { a as Pin, f as SessionRef, m as ThreadMessage, o as PinInput, r as Link, t as Attachment } from "./schema-BOTmn5SM.js";
+import { r as SessionStore } from "./sessions-CJdMBH3C.js";
+//#region src/store-errors.d.ts
+/** The addressed row does not exist. Mapped to 404 / `E_NOT_FOUND` by the hub. */
+declare class NotFoundError extends Error {}
+/** The write conflicts with current state (e.g. resolving an already-resolved pin). 409 / `E_CONFLICT`. */
+declare class ConflictError extends Error {}
+//#endregion
+//#region src/store.d.ts
+type StoredEvent = {
+  seq: number;
+  type: "pin.created" | "pin.resolved" | "thread.message" | "pin.verified" | "pin.linked";
+  at: string;
+  payload: unknown;
+};
+interface PinStore {
+  /** Assigns id/status/createdAt, merges env, appends pin.created. */
+  createPin(input: PinInput, env: {
+    branch?: string;
+    commit?: string;
+  }): Pin;
+  getPin(id: string): Pin | null;
+  /** Newest first. */
+  listPins(filter?: {
+    status?: "open" | "resolved";
+  }): Pin[];
+  /** @throws NotFoundError — additive opts param (attachments, origin) */
+  addThreadMessage(pinId: string, role: "human" | "agent" | "mirror", text: string, opts?: {
+    origin?: string;
+    attachments?: Attachment[];
+  }): ThreadMessage;
+  getThread(pinId: string): ThreadMessage[];
+  /** @throws NotFoundError @throws ConflictError — the trailing commit param is additive */
+  resolvePin(id: string, by: "human" | "agent", note?: string, commit?: string): Pin;
+  /** Inbound-poll deadline. @throws NotFoundError */
+  setDueAt(id: string, at: string | null): void;
+  /** due_at IS NOT NULL AND due_at <= at, oldest deadline first. */
+  pinsDueBefore(at: string): Pin[];
+  eventsAfter(seq: number): StoredEvent[];
+  summary(): {
+    open: number;
+    resolved: number;
+    lastEventSeq: number;
+  };
+  close(): void;
+  subscribe(listener: (event: StoredEvent) => void): () => void;
+  readonly sessions: SessionStore;
+  readonly deliveries: DeliveryStore;
+  /** Persists the routing binding into pin.agentSession. No event. @throws NotFoundError */
+  bindSession(pinId: string, ref: SessionRef): Pin;
+  verifyPin(id: string, outcome: "accepted" | "reopened"): Pin;
+  searchPins(query: string): Pin[];
+  readonly cursors: CursorStore;
+  addLink(pinId: string, link: Link): Pin;
+  readonly links: LinkStore;
+}
+type DeliveryStatus = "pending" | "delivered" | "failed" | "skipped";
+type DeliveryRow = {
+  id: number;
+  eventSeq: number;
+  sessionId: string | null;
+  adapter: string;
+  status: DeliveryStatus;
+  attempts: number;
+  dueAt: string | null;
+  lastError: string | null;
+  updatedAt: string;
+};
+interface DeliveryStore {
+  enqueue(row: {
+    eventSeq: number;
+    sessionId: string | null;
+    adapter: string;
+    dueAt: string | null;
+    status?: "pending" | "skipped";
+  }): DeliveryRow;
+  due(now: string): DeliveryRow[];
+  pendingForSession(sessionId: string): DeliveryRow[];
+  unassigned(): DeliveryRow[];
+  assign(id: number, sessionId: string): void;
+  markDelivered(id: number): void;
+  markFailed(id: number, error: string, retryAt: string | null): void;
+  lastEventSeq(): number;
+}
+interface CursorStore {
+  get(consumerId: string): number;
+  set(consumerId: string, lastSeq: number): void;
+}
+interface LinkStore {
+  forPin(pinId: string): Link[];
+  all(): {
+    pinId: string;
+    link: Link;
+    lastSyncedAt: string | null;
+  }[];
+  markSynced(pinId: string, link: Pick<Link, "connector" | "ref">, at: string): void;
+}
+type Migration = {
+  version: number;
+  ddl: string;
+};
+declare const MIGRATIONS: Migration[];
+declare function openStore(path: string): PinStore;
+//#endregion
+export { LinkStore as a, PinStore as c, ConflictError as d, NotFoundError as f, DeliveryStore as i, StoredEvent as l, DeliveryRow as n, MIGRATIONS as o, DeliveryStatus as r, Migration as s, CursorStore as t, openStore as u };