@ignitionai/cogitator 0.5.1 → 0.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (63) hide show
  1. package/CHANGELOG.md +69 -0
  2. package/LICENSE +21 -0
  3. package/README.md +80 -56
  4. package/dist/extensions/index.js +66 -29
  5. package/dist/src/app-updates.js +15 -0
  6. package/dist/src/auth-cli.js +18 -8
  7. package/dist/src/auth-http.js +13 -3
  8. package/dist/src/auth-state.js +41 -6
  9. package/dist/src/board.js +3 -1
  10. package/dist/src/browser-http.js +143 -0
  11. package/dist/src/classic-configuration.js +12 -4
  12. package/dist/src/cli.js +29 -2
  13. package/dist/src/config.js +10 -0
  14. package/dist/src/cron.js +91 -15
  15. package/dist/src/db.js +55 -3
  16. package/dist/src/durable/approvals.js +17 -2
  17. package/dist/src/durable/effect-gateway.js +23 -16
  18. package/dist/src/durable/manager.js +13 -4
  19. package/dist/src/durable/mission-runtime.js +204 -46
  20. package/dist/src/durable/recovery.js +37 -0
  21. package/dist/src/durable/workers.js +22 -14
  22. package/dist/src/execution/confinement.js +2 -1
  23. package/dist/src/execution/worker-supervisor.js +222 -0
  24. package/dist/src/git-import.js +187 -0
  25. package/dist/src/github-login.js +101 -0
  26. package/dist/src/history.js +6 -1
  27. package/dist/src/host-pi.js +9 -6
  28. package/dist/src/json-files.js +7 -4
  29. package/dist/src/machine-metrics.js +49 -0
  30. package/dist/src/machine-types.js +1 -0
  31. package/dist/src/mcp-cli.js +63 -0
  32. package/dist/src/mcp-http.js +164 -0
  33. package/dist/src/mcp-oauth.js +502 -0
  34. package/dist/src/mcp-server.js +6 -136
  35. package/dist/src/mcp-tokens.js +104 -0
  36. package/dist/src/mcp-tools.js +264 -0
  37. package/dist/src/native-auth.js +9 -2
  38. package/dist/src/packages.js +190 -0
  39. package/dist/src/paths.js +1 -0
  40. package/dist/src/pi-child.js +180 -0
  41. package/dist/src/pi-rpc-wrap.js +84 -0
  42. package/dist/src/pool.js +58 -7
  43. package/dist/src/project-setup.js +63 -0
  44. package/dist/src/provider-login.js +72 -13
  45. package/dist/src/reap-orphans.js +138 -0
  46. package/dist/src/registry.js +66 -43
  47. package/dist/src/schemas.js +19 -4
  48. package/dist/src/server-compat.js +173 -0
  49. package/dist/src/server-identity.js +69 -0
  50. package/dist/src/server.js +534 -41
  51. package/dist/src/shared-browser.js +357 -0
  52. package/dist/src/skills-import.js +13 -4
  53. package/dist/src/skills-upload.js +68 -0
  54. package/dist/src/spawner.js +20 -4
  55. package/dist/src/subagents.js +242 -0
  56. package/dist/src/team-queue.js +262 -0
  57. package/package.json +8 -3
  58. package/web/dist/assets/{BrandLogo3D-BvZPXohP.js → BrandLogo3D-CHGXwTbZ.js} +1 -1
  59. package/web/dist/assets/index-DGLkhrE7.css +1 -0
  60. package/web/dist/assets/index-P0WoXBgX.js +84 -0
  61. package/web/dist/index.html +2 -2
  62. package/web/dist/assets/index-7Dyl-4v7.css +0 -1
  63. package/web/dist/assets/index-CdqzcBU-.js +0 -83
@@ -0,0 +1,242 @@
1
+ import { entriesFromLines } from "./history.js";
2
+ import { constants, realpathSync, closeSync, fstatSync, openSync, readSync, readdirSync, statSync } from "node:fs";
3
+ import { basename, dirname, join } from "node:path";
4
+ /** Au-delà de cette inactivité, un enfant « en cours » est traité comme inconnu (process tué). */
5
+ export const MAX_AGE_MS = 60 * 60 * 1000;
6
+ /** Nombre d'enfants listés au maximum (les plus récents). */
7
+ export const MAX_SUBAGENTS = 20;
8
+ const HEAD_WINDOWS = [64 * 1024, 1024 * 1024];
9
+ const TAIL_BYTES = 65_536;
10
+ const HEADER_BYTES = 16 * 1024;
11
+ /** Les positions et tailles sont en octets, avant tout décodage UTF-8. */
12
+ function readWindow(fd, position, length) {
13
+ const buffer = Buffer.alloc(length);
14
+ let bytes = 0;
15
+ while (bytes < length) {
16
+ const count = readSync(fd, buffer, bytes, length - bytes, position + bytes);
17
+ if (!count)
18
+ break;
19
+ bytes += count;
20
+ }
21
+ return buffer.subarray(0, bytes).toString("utf8");
22
+ }
23
+ /** Répertoire des journaux enfants pour une session parente donnée. */
24
+ export function tasksDirFor(sessionFile) {
25
+ return join(dirname(sessionFile), basename(sessionFile).replace(/\.jsonl$/, ""), "tasks");
26
+ }
27
+ /** Identifiant de session porté par l'en-tête du journal parent, null si illisible. */
28
+ export function parentSessionIdOf(sessionFile) {
29
+ let fd;
30
+ try {
31
+ fd = openSync(sessionFile, "r");
32
+ const stat = fstatSync(fd);
33
+ if (!stat.isFile())
34
+ return null;
35
+ const header = parseLines(readWindow(fd, 0, Math.min(stat.size, HEADER_BYTES)).split("\n")[0] ?? "")[0];
36
+ return header?.type === "session" && typeof header.id === "string" && header.id ? header.id : null;
37
+ }
38
+ catch {
39
+ return null;
40
+ }
41
+ finally {
42
+ if (fd !== undefined)
43
+ closeSync(fd);
44
+ }
45
+ }
46
+ function parseLines(raw) {
47
+ const out = [];
48
+ for (const line of raw.split("\n")) {
49
+ if (!line.trim())
50
+ continue;
51
+ try {
52
+ const entry = JSON.parse(line);
53
+ if (entry && typeof entry === "object" && !Array.isArray(entry))
54
+ out.push(entry);
55
+ }
56
+ catch {
57
+ // ligne tronquée (bornes head/tail) ou corrompue : ignorée
58
+ }
59
+ }
60
+ return out;
61
+ }
62
+ function textOf(content) {
63
+ if (typeof content === "string")
64
+ return content;
65
+ if (!Array.isArray(content))
66
+ return null;
67
+ const text = content
68
+ .filter((part) => Boolean(part) && part.type === "text" && typeof part.text === "string")
69
+ .map((part) => part.text)
70
+ .join(" ")
71
+ .trim();
72
+ return text || null;
73
+ }
74
+ /** Statut déduit de la dernière entrée significative du journal. */
75
+ export function statusOfEntries(entries) {
76
+ for (let i = entries.length - 1; i >= 0; i--) {
77
+ const entry = entries[i];
78
+ const message = entry.message;
79
+ if (!message?.role)
80
+ continue;
81
+ if (message.role === "toolResult")
82
+ return "working"; // l'agent va reprendre après l'outil
83
+ if (message.role === "user")
84
+ return "working";
85
+ if (message.role !== "assistant")
86
+ continue;
87
+ if (message.stopReason === "error")
88
+ return "unknown";
89
+ return message.stopReason === "toolUse" ? "working" : "done";
90
+ }
91
+ return "unknown";
92
+ }
93
+ /** Lecture bornée d'un journal enfant : en-tête (id, modèle, consigne) + queue (statut). */
94
+ export function readSubagent(file, expectedParentId) {
95
+ let headEntries;
96
+ let tail;
97
+ let mtimeMs;
98
+ let fd;
99
+ try {
100
+ fd = openSync(file, "r");
101
+ const stat = fstatSync(fd);
102
+ if (!stat.isFile())
103
+ return null;
104
+ const { size } = stat;
105
+ mtimeMs = stat.mtimeMs;
106
+ // Le préambule système d'un enfant pèse ~120 Kio : on élargit la fenêtre jusqu'à la
107
+ // première consigne utilisateur, bornée à 1 Mio (au-delà, libellé laissé vide).
108
+ headEntries = [];
109
+ for (const window of HEAD_WINDOWS) {
110
+ headEntries = parseLines(readWindow(fd, 0, Math.min(size, window)));
111
+ if (size <= window || headEntries.some((entry) => entry.message?.role === "user"))
112
+ break;
113
+ }
114
+ const offset = Math.max(0, size - TAIL_BYTES);
115
+ tail = readWindow(fd, Math.max(0, offset - 1), Math.min(size, TAIL_BYTES + (offset > 0 ? 1 : 0)));
116
+ // Si la fenêtre commence au milieu d'une entrée, seule sa suite est ignorée.
117
+ if (offset > 0) {
118
+ const newline = tail.indexOf("\n");
119
+ tail = newline < 0 ? "" : tail.slice(newline + 1);
120
+ }
121
+ }
122
+ catch {
123
+ return null;
124
+ }
125
+ finally {
126
+ if (fd !== undefined)
127
+ closeSync(fd);
128
+ }
129
+ const header = headEntries[0];
130
+ if (header?.type !== "session" || typeof header.id !== "string" || !header.id)
131
+ return null;
132
+ if (expectedParentId !== undefined && header.parentSession !== expectedParentId)
133
+ return null;
134
+ const modelChange = headEntries.find((entry) => entry.type === "model_change");
135
+ const firstUser = headEntries.find((entry) => {
136
+ const message = entry.message;
137
+ return message?.role === "user";
138
+ });
139
+ const label = firstUser ? textOf(firstUser.message.content) : null;
140
+ const status = statusOfEntries(parseLines(tail));
141
+ return {
142
+ id: header.id,
143
+ label: label ? label.split("\n")[0].slice(0, 120) : null,
144
+ model: modelChange?.provider && modelChange.modelId ? `${modelChange.provider}/${modelChange.modelId}` : null,
145
+ status: status === "working" && Date.now() - mtimeMs > MAX_AGE_MS ? "unknown" : status,
146
+ started_at: typeof header.timestamp === "string" ? header.timestamp : null,
147
+ };
148
+ }
149
+ /**
150
+ * Sous-agents d'une conversation. `live: false` ⇔ la conversation n'a pas de session pi
151
+ * (rien à inspecter) ; un répertoire absent ou vide est un état normal → `live: true, []`.
152
+ */
153
+ export function listSubagents(sessionFile) {
154
+ if (!sessionFile)
155
+ return { live: false, subagents: [] };
156
+ const parentId = parentSessionIdOf(sessionFile);
157
+ if (!parentId)
158
+ return { live: false, subagents: [] };
159
+ const dir = tasksDirFor(sessionFile);
160
+ let files;
161
+ try {
162
+ files = readdirSync(dir, { withFileTypes: true })
163
+ .filter((entry) => entry.isFile() && entry.name.endsWith(".jsonl"))
164
+ .flatMap((entry) => {
165
+ const file = join(dir, entry.name);
166
+ try {
167
+ return [{ file, mtimeMs: statSync(file).mtimeMs }];
168
+ }
169
+ catch {
170
+ return []; // Un journal supprimé pendant le rafraîchissement n'interrompt pas la liste.
171
+ }
172
+ })
173
+ .sort((a, b) => b.mtimeMs - a.mtimeMs)
174
+ .slice(0, MAX_SUBAGENTS);
175
+ }
176
+ catch {
177
+ return { live: true, subagents: [] };
178
+ }
179
+ const subagents = [];
180
+ for (const { file } of files) {
181
+ // Le répertoire est dérivé du nom de la session parente ; le lien déclaré dans
182
+ // l'enfant est revérifié pour qu'un dossier recyclé ne fuite pas vers une autre
183
+ // conversation.
184
+ const view = readSubagent(file, parentId);
185
+ if (view)
186
+ subagents.push(view);
187
+ }
188
+ return { live: true, subagents };
189
+ }
190
+ /** Resolve by verified session id, never a client-supplied path; read a bounded snapshot on one fd. */
191
+ export function readSubagentTranscript(sessionFile, id) {
192
+ if (!sessionFile || !id || id.length > 200)
193
+ return null;
194
+ const parentId = parentSessionIdOf(sessionFile);
195
+ if (!parentId)
196
+ return null;
197
+ const dir = tasksDirFor(sessionFile);
198
+ try {
199
+ const expected = join(realpathSync(dirname(sessionFile)), basename(sessionFile).replace(/\.jsonl$/, ""), "tasks");
200
+ if (realpathSync(dir) !== expected)
201
+ return null;
202
+ const files = readdirSync(dir, { withFileTypes: true }).filter(e => e.isFile() && e.name.endsWith(".jsonl")).slice(0, 500);
203
+ for (const file of files) {
204
+ let fd;
205
+ try {
206
+ const path = join(dir, file.name);
207
+ fd = openSync(path, constants.O_RDONLY | constants.O_NOFOLLOW);
208
+ const stat = fstatSync(fd);
209
+ if (!stat.isFile())
210
+ continue;
211
+ const header = parseLines(readWindow(fd, 0, Math.min(stat.size, HEADER_BYTES)).split("\n")[0] ?? "")[0];
212
+ if (header?.type !== "session" || header.id !== id || header.parentSession !== parentId)
213
+ continue;
214
+ const cap = 4 * 1024 * 1024;
215
+ const offset = Math.max(0, stat.size - cap);
216
+ let raw = readWindow(fd, offset, Math.min(stat.size, cap));
217
+ if (offset)
218
+ raw = raw.slice(raw.indexOf("\n") + 1);
219
+ const all = entriesFromLines(raw.split("\n"), 100_000);
220
+ const head = parseLines(readWindow(fd, 0, Math.min(stat.size, HEAD_WINDOWS[1])));
221
+ const model = head.find(e => e.type === "model_change");
222
+ const user = head.find(e => e.message?.role === "user");
223
+ const label = textOf(user?.message?.content);
224
+ const status = statusOfEntries(parseLines(raw));
225
+ const subagent = {
226
+ id, label: label ? label.split("\n")[0].slice(0, 120) : null,
227
+ model: typeof model?.provider === "string" && typeof model.modelId === "string" ? `${model.provider}/${model.modelId}` : null,
228
+ status: status === "working" && Date.now() - stat.mtimeMs > MAX_AGE_MS ? "unknown" : status,
229
+ started_at: typeof header.timestamp === "string" ? header.timestamp : null,
230
+ };
231
+ return { subagent, entries: all.slice(-300), truncated: offset > 0 || all.length > 300 };
232
+ }
233
+ catch { /* a changing or unreadable journal is unavailable */ }
234
+ finally {
235
+ if (fd !== undefined)
236
+ closeSync(fd);
237
+ }
238
+ }
239
+ }
240
+ catch { /* no valid child directory */ }
241
+ return null;
242
+ }
@@ -0,0 +1,262 @@
1
+ import { randomUUID } from "node:crypto";
2
+ /**
3
+ * Files durables (pi-openbot lot 2, prototype Q1). Module ajouté AU-DESSUS du pool :
4
+ * il n'utilise que l'API publique de PiPool (prompt, onEvent) et un `ensure`
5
+ * fourni par l'appelant (Spawner.ensure en production). pool.ts n'est pas modifié.
6
+ *
7
+ * Invariant : un élément `delivering` trouvé au démarrage devient `interrupted`
8
+ * et n'est JAMAIS rejoué (architecture.md §échecs, invariant 2).
9
+ */
10
+ export const DEFAULT_HOP_LIMIT = 4;
11
+ /** Délai sans progrès (battement de vie / agent encore actif), pas une durée totale de tour. */
12
+ export const DEFAULT_STALL_MS = 15 * 60_000;
13
+ export class QueueError extends Error {
14
+ code;
15
+ constructor(message, code) {
16
+ super(message);
17
+ this.code = code;
18
+ }
19
+ }
20
+ export function ensureLane(db, conversationId, kind = "chat") {
21
+ const found = db.prepare("SELECT id FROM lane WHERE conversation_id = ? AND kind = ?").get(conversationId, kind);
22
+ if (found)
23
+ return found.id;
24
+ const id = randomUUID();
25
+ db.prepare("INSERT INTO lane (id, conversation_id, kind) VALUES (?, ?, ?)").run(id, conversationId, kind);
26
+ return id;
27
+ }
28
+ /** Images d'un item de file : JSON en base, `null` quand il n'y en a pas. */
29
+ function serializeImages(images) {
30
+ return images?.length ? JSON.stringify(images) : null;
31
+ }
32
+ function parseImages(raw) {
33
+ if (!raw)
34
+ return undefined;
35
+ try {
36
+ const parsed = JSON.parse(raw);
37
+ return Array.isArray(parsed) ? parsed : undefined;
38
+ }
39
+ catch {
40
+ return undefined;
41
+ }
42
+ }
43
+ /** Ajoute un élément en file. Même idempotency_key → même élément, aucun doublon. */
44
+ export function enqueue(db, input) {
45
+ const hop = input.hop ?? 0;
46
+ if (hop > (input.hopLimit ?? DEFAULT_HOP_LIMIT))
47
+ throw new QueueError(`hop ${hop} > limite`, "hop_limit");
48
+ return db.transaction(() => {
49
+ const laneId = ensureLane(db, input.conversationId, input.kind);
50
+ if (input.idempotencyKey) {
51
+ const dup = db.prepare("SELECT id, lane_id FROM queue_item WHERE lane_id = ? AND idempotency_key = ?").get(laneId, input.idempotencyKey);
52
+ if (dup)
53
+ return { id: dup.id, laneId: dup.lane_id, created: false };
54
+ }
55
+ const { next } = db.prepare("SELECT COALESCE(MAX(seq), 0) + 1 AS next FROM queue_item WHERE lane_id = ?").get(laneId);
56
+ const id = randomUUID();
57
+ db.prepare(`INSERT INTO queue_item (id, lane_id, seq, body, images, from_agent_id, chain_id, hop, idempotency_key)
58
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, laneId, next, input.body, serializeImages(input.images), input.fromAgentId ?? null, input.chainId ?? null, hop, input.idempotencyKey ?? null);
59
+ return { id, laneId, created: true };
60
+ })();
61
+ }
62
+ /** À appeler une fois au démarrage de l'hôte, avant tout dispatch (comme recoverConfigurations). */
63
+ export function recoverInterrupted(db) {
64
+ // Un item `delivering` n'est jamais rejoué (invariant 2) : ses images ne resserviront pas, on les libère.
65
+ return db.prepare(`UPDATE queue_item SET status = 'interrupted', finished_at = datetime('now'),
66
+ error = 'host restarted during delivery', images = NULL WHERE status = 'delivering'`).run().changes;
67
+ }
68
+ export function setLanePaused(db, laneId, paused) {
69
+ if (!db.prepare("UPDATE lane SET paused = ? WHERE id = ?").run(paused ? 1 : 0, laneId).changes)
70
+ throw new QueueError("lane inconnue", "not_found");
71
+ }
72
+ export function cancelItem(db, itemId) {
73
+ if (!db.prepare("UPDATE queue_item SET status = 'cancelled', finished_at = datetime('now'), images = NULL WHERE id = ? AND status = 'queued'").run(itemId).changes)
74
+ throw new QueueError("élément absent ou plus en file", "conflict");
75
+ }
76
+ export function listItems(db, laneId) {
77
+ return db.prepare("SELECT * FROM queue_item WHERE lane_id = ? ORDER BY seq").all(laneId);
78
+ }
79
+ export function listQueuedLaneIds(db) {
80
+ return db.prepare("SELECT DISTINCT lane_id AS id FROM queue_item WHERE status = 'queued'").all().map((row) => row.id);
81
+ }
82
+ export function laneIsPaused(db, laneId) {
83
+ const row = db.prepare("SELECT paused FROM lane WHERE id = ?").get(laneId);
84
+ return Boolean(row?.paused);
85
+ }
86
+ export function laneIsDelivering(db, laneId) {
87
+ return Boolean(db.prepare("SELECT 1 FROM queue_item WHERE lane_id = ? AND status = 'delivering'").get(laneId));
88
+ }
89
+ export function kickQueuedLanes(db, dispatcher) {
90
+ for (const id of listQueuedLaneIds(db))
91
+ void dispatcher.kick(id);
92
+ }
93
+ /** Livre une lane élément par élément, dans l'ordre de seq. Une seule boucle par lane. */
94
+ export class LaneDispatcher {
95
+ opts;
96
+ running = new Map();
97
+ current = new Map();
98
+ prompted = new Set();
99
+ promptWaiters = new Map();
100
+ constructor(opts) {
101
+ this.opts = opts;
102
+ }
103
+ /** Élément en cours de livraison pour une conversation (contexte hop/chain des outils team_*). */
104
+ currentItem(conversationId) { return this.current.get(conversationId); }
105
+ /** Persiste les images sur l'item de file : la base est la seule source de vérité (survit au restart). */
106
+ attachImages(itemId, images) {
107
+ const payload = serializeImages(images);
108
+ if (!payload)
109
+ return;
110
+ // Un item déjà terminal ne sera plus livré : ne pas y laisser un JSON d'images qui ne serait jamais lu.
111
+ this.opts.db.prepare("UPDATE queue_item SET images = ? WHERE id = ? AND status IN ('queued','delivering')").run(payload, itemId);
112
+ }
113
+ waitUntilPrompted(itemId) {
114
+ if (this.prompted.has(itemId))
115
+ return Promise.resolve();
116
+ const row = this.opts.db.prepare("SELECT status FROM queue_item WHERE id = ?").get(itemId);
117
+ if (row && row.status !== "queued" && row.status !== "delivering") {
118
+ this.markPrompted(itemId);
119
+ return Promise.resolve();
120
+ }
121
+ return new Promise((resolve) => {
122
+ const list = this.promptWaiters.get(itemId) ?? [];
123
+ list.push(resolve);
124
+ this.promptWaiters.set(itemId, list);
125
+ });
126
+ }
127
+ kick(laneId) {
128
+ const existing = this.running.get(laneId);
129
+ if (existing)
130
+ return existing.then(() => this.kick(laneId));
131
+ const loop = this.loop(laneId).finally(() => this.running.delete(laneId));
132
+ this.running.set(laneId, loop);
133
+ return loop;
134
+ }
135
+ waitUntilSettled(convId) {
136
+ const stallMs = this.opts.settleTimeoutMs ?? DEFAULT_STALL_MS;
137
+ return new Promise((resolve, reject) => {
138
+ let timer;
139
+ let finished = false;
140
+ const finish = (error) => {
141
+ if (finished)
142
+ return;
143
+ finished = true;
144
+ if (timer !== undefined)
145
+ clearTimeout(timer);
146
+ unsub();
147
+ if (error !== undefined)
148
+ reject(error instanceof Error ? error : new Error(String(error)));
149
+ else
150
+ resolve();
151
+ };
152
+ const arm = () => {
153
+ if (finished)
154
+ return;
155
+ if (timer !== undefined)
156
+ clearTimeout(timer);
157
+ timer = setTimeout(() => {
158
+ finish(new Error(`agent stalled (${stallMs}ms without progress)`));
159
+ }, stallMs);
160
+ };
161
+ const unsub = this.opts.pool.onEvent((id, event) => {
162
+ if (id !== convId)
163
+ return;
164
+ if (event?.type === "agent_settled")
165
+ finish();
166
+ else
167
+ arm();
168
+ });
169
+ arm();
170
+ });
171
+ }
172
+ markPrompted(itemId) {
173
+ this.prompted.add(itemId);
174
+ const waiters = this.promptWaiters.get(itemId);
175
+ if (!waiters)
176
+ return;
177
+ this.promptWaiters.delete(itemId);
178
+ for (const waiter of waiters)
179
+ waiter();
180
+ }
181
+ async loop(laneId) {
182
+ const { db, pool } = this.opts;
183
+ for (;;) {
184
+ const lane = db.prepare("SELECT conversation_id, paused FROM lane WHERE id = ?").get(laneId);
185
+ if (!lane || lane.paused)
186
+ return;
187
+ const item = db.prepare("SELECT * FROM queue_item WHERE lane_id = ? AND status = 'queued' ORDER BY seq LIMIT 1").get(laneId);
188
+ if (!item)
189
+ return;
190
+ const claimed = db.prepare("UPDATE queue_item SET status = 'delivering', started_at = datetime('now') WHERE id = ? AND status = 'queued'").run(item.id).changes;
191
+ if (!claimed)
192
+ continue;
193
+ const convId = lane.conversation_id;
194
+ this.current.set(convId, item);
195
+ try {
196
+ await this.opts.ensure(convId);
197
+ const settled = this.waitUntilSettled(convId);
198
+ settled.catch(() => undefined);
199
+ const result = await pool.prompt(convId, item.body, parseImages(item.images));
200
+ this.markPrompted(item.id);
201
+ await settled;
202
+ // Le pool a mis le message dans sa file mémoire (tour UI en cours) : attendre le tour suivant.
203
+ if (result?.disposition === "queued")
204
+ await this.waitUntilSettled(convId);
205
+ // Images libérées à l'état terminal : elles ne resserviront pas (#31).
206
+ db.prepare("UPDATE queue_item SET status = 'done', finished_at = datetime('now'), images = NULL WHERE id = ?").run(item.id);
207
+ }
208
+ catch (error) {
209
+ db.prepare("UPDATE queue_item SET status = 'failed', finished_at = datetime('now'), error = ?, images = NULL WHERE id = ?").run(String(error), item.id);
210
+ }
211
+ finally {
212
+ this.markPrompted(item.id);
213
+ this.prompted.delete(item.id);
214
+ this.current.delete(convId);
215
+ }
216
+ }
217
+ }
218
+ }
219
+ /**
220
+ * Persiste un message dans `queue_item` puis lance le dispatcher.
221
+ * Si la lane est libre, attend que `pool.prompt` ait été appelé (contrat HTTP historique).
222
+ * Si une livraison est déjà en cours, retourne dès l'enqueue — plus de file mémoire du pool.
223
+ */
224
+ export async function submitToLane(db, dispatcher, input, images) {
225
+ const result = enqueue(db, images?.length ? { ...input, images } : input);
226
+ // Doublon idempotent : les images n'ont pas été écrites par l'enqueue, on complète l'item existant.
227
+ if (images?.length && !result.created)
228
+ dispatcher.attachImages(result.id, images);
229
+ const paused = laneIsPaused(db, result.laneId);
230
+ const busy = laneIsDelivering(db, result.laneId);
231
+ const kicked = dispatcher.kick(result.laneId);
232
+ if (result.created && !paused && !busy) {
233
+ await dispatcher.waitUntilPrompted(result.id);
234
+ const row = db.prepare("SELECT status, error FROM queue_item WHERE id = ?").get(result.id);
235
+ if (row?.status === "failed")
236
+ throw new Error(row.error ?? "livraison échouée");
237
+ }
238
+ else
239
+ void kicked.catch(() => undefined);
240
+ return result;
241
+ }
242
+ export function hopContext(dispatcher, fromConversationId) {
243
+ const current = fromConversationId ? dispatcher.currentItem(fromConversationId) : undefined;
244
+ if (!current)
245
+ return { hop: 0, chainId: null };
246
+ return { hop: current.hop + 1, chainId: current.chain_id ?? current.id };
247
+ }
248
+ /**
249
+ * Hop du prochain relais (handoff) : dernier élément delivering/done de la lane,
250
+ * pas seulement l'élément encore en cours — agent_end arrive souvent après agent_settled.
251
+ */
252
+ export function originHop(db, conversationId, kind = "chat") {
253
+ if (!conversationId)
254
+ return { hop: 0, chainId: null };
255
+ const lane = db.prepare("SELECT id FROM lane WHERE conversation_id = ? AND kind = ?").get(conversationId, kind);
256
+ if (!lane)
257
+ return { hop: 0, chainId: null };
258
+ const item = db.prepare("SELECT id, chain_id, hop FROM queue_item WHERE lane_id = ? AND status IN ('delivering', 'done') ORDER BY seq DESC LIMIT 1").get(lane.id);
259
+ if (!item)
260
+ return { hop: 0, chainId: null };
261
+ return { hop: item.hop + 1, chainId: item.chain_id ?? item.id };
262
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ignitionai/cogitator",
3
- "version": "0.5.1",
3
+ "version": "0.5.2",
4
4
  "description": "A web control panel for pi: composable agents, workspaces, interactive conversations, and scheduled tasks. A pi package.",
5
5
  "type": "module",
6
6
  "keywords": [
@@ -29,7 +29,8 @@
29
29
  "dist/src",
30
30
  "dist/extensions",
31
31
  "web/dist",
32
- "README.md"
32
+ "README.md",
33
+ "CHANGELOG.md"
33
34
  ],
34
35
  "scripts": {
35
36
  "build": "npm run typecheck && vite build web && tsc",
@@ -46,7 +47,8 @@
46
47
  "extensions": [
47
48
  "./dist/extensions/index.js"
48
49
  ],
49
- "image": "https://raw.githubusercontent.com/IgnitionAI/cogitator/dev/web/public/icon.png"
50
+ "image": "https://raw.githubusercontent.com/IgnitionAI/cogitator/dev/docs/images/bots.jpg",
51
+ "changelogPath": "./CHANGELOG.md"
50
52
  },
51
53
  "peerDependencies": {
52
54
  "@earendil-works/pi-ai": "*",
@@ -61,7 +63,9 @@
61
63
  "better-auth": "1.7.7",
62
64
  "better-sqlite3": "^12.11.1",
63
65
  "cron-parser": "^5.10.1",
66
+ "playwright-core": "1.65.0",
64
67
  "three": "^0.181.2",
68
+ "ws": "8.22.1",
65
69
  "zod": "^4.6.5"
66
70
  },
67
71
  "devDependencies": {
@@ -73,6 +77,7 @@
73
77
  "@types/react": "^19.3.0",
74
78
  "@types/react-dom": "^19.3.0",
75
79
  "@types/three": "^0.186.0",
80
+ "@types/ws": "8.18.2",
76
81
  "@vitejs/plugin-react": "^6.1.2",
77
82
  "react": "^19.3.0",
78
83
  "react-dom": "^19.3.0",