ima2-gen 1.1.7 → 1.1.9

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 (229) hide show
  1. package/README.md +56 -27
  2. package/bin/commands/annotate.js +137 -0
  3. package/bin/commands/annotate.ts +118 -0
  4. package/bin/commands/cancel.js +37 -33
  5. package/bin/commands/cancel.ts +45 -0
  6. package/bin/commands/canvas-versions.js +91 -0
  7. package/bin/commands/canvas-versions.ts +80 -0
  8. package/bin/commands/cardnews.js +293 -0
  9. package/bin/commands/cardnews.ts +248 -0
  10. package/bin/commands/comfy.js +63 -0
  11. package/bin/commands/comfy.ts +54 -0
  12. package/bin/commands/config.js +270 -0
  13. package/bin/commands/config.ts +265 -0
  14. package/bin/commands/edit.js +97 -72
  15. package/bin/commands/edit.ts +116 -0
  16. package/bin/commands/gen.js +140 -118
  17. package/bin/commands/gen.ts +176 -0
  18. package/bin/commands/history.js +164 -0
  19. package/bin/commands/history.ts +145 -0
  20. package/bin/commands/ls.js +60 -42
  21. package/bin/commands/ls.ts +60 -0
  22. package/bin/commands/metadata.js +45 -0
  23. package/bin/commands/metadata.ts +36 -0
  24. package/bin/commands/multimode.js +159 -0
  25. package/bin/commands/multimode.ts +146 -0
  26. package/bin/commands/node.js +176 -0
  27. package/bin/commands/node.ts +157 -0
  28. package/bin/commands/observability.js +201 -0
  29. package/bin/commands/observability.ts +176 -0
  30. package/bin/commands/ping.js +26 -20
  31. package/bin/commands/ping.ts +29 -0
  32. package/bin/commands/prompt.js +506 -0
  33. package/bin/commands/prompt.ts +421 -0
  34. package/bin/commands/ps.js +78 -71
  35. package/bin/commands/ps.ts +78 -0
  36. package/bin/commands/session.js +308 -0
  37. package/bin/commands/session.ts +265 -0
  38. package/bin/commands/show.js +75 -40
  39. package/bin/commands/show.ts +69 -0
  40. package/bin/ima2.js +324 -310
  41. package/bin/ima2.ts +444 -0
  42. package/bin/lib/args.js +75 -66
  43. package/bin/lib/args.ts +73 -0
  44. package/bin/lib/browser-id.js +15 -0
  45. package/bin/lib/browser-id.ts +16 -0
  46. package/bin/lib/client.js +91 -83
  47. package/bin/lib/client.ts +109 -0
  48. package/bin/lib/error-hints.js +14 -17
  49. package/bin/lib/error-hints.ts +23 -0
  50. package/bin/lib/files.js +26 -28
  51. package/bin/lib/files.ts +39 -0
  52. package/bin/lib/output.js +44 -42
  53. package/bin/lib/output.ts +58 -0
  54. package/bin/lib/platform.js +60 -56
  55. package/bin/lib/platform.ts +97 -0
  56. package/bin/lib/sse.js +73 -0
  57. package/bin/lib/sse.ts +73 -0
  58. package/bin/lib/star-prompt.js +69 -76
  59. package/bin/lib/star-prompt.ts +97 -0
  60. package/bin/lib/storage-doctor.js +34 -35
  61. package/bin/lib/storage-doctor.ts +38 -0
  62. package/config.js +147 -190
  63. package/config.ts +331 -0
  64. package/docs/API.md +48 -8
  65. package/docs/CLI.md +190 -0
  66. package/docs/FAQ.ko.md +5 -5
  67. package/docs/FAQ.md +5 -5
  68. package/docs/README.ja.md +71 -25
  69. package/docs/README.ko.md +61 -24
  70. package/docs/README.zh-CN.md +73 -27
  71. package/lib/assetLifecycle.js +130 -130
  72. package/lib/assetLifecycle.ts +142 -0
  73. package/lib/canvasVersionStore.js +135 -153
  74. package/lib/canvasVersionStore.ts +181 -0
  75. package/lib/cardNewsGenerator.js +127 -142
  76. package/lib/cardNewsGenerator.ts +162 -0
  77. package/lib/cardNewsJobStore.js +78 -84
  78. package/lib/cardNewsJobStore.ts +107 -0
  79. package/lib/cardNewsManifestStore.js +88 -93
  80. package/lib/cardNewsManifestStore.ts +112 -0
  81. package/lib/cardNewsPlanner.js +157 -152
  82. package/lib/cardNewsPlanner.ts +180 -0
  83. package/lib/cardNewsPlannerClient.js +101 -98
  84. package/lib/cardNewsPlannerClient.ts +114 -0
  85. package/lib/cardNewsPlannerPrompt.js +56 -56
  86. package/lib/cardNewsPlannerPrompt.ts +60 -0
  87. package/lib/cardNewsPlannerSchema.js +231 -223
  88. package/lib/cardNewsPlannerSchema.ts +259 -0
  89. package/lib/cardNewsRoleTemplateStore.js +39 -41
  90. package/lib/cardNewsRoleTemplateStore.ts +47 -0
  91. package/lib/cardNewsTemplateStore.js +171 -175
  92. package/lib/cardNewsTemplateStore.ts +210 -0
  93. package/lib/codexDetect.js +44 -47
  94. package/lib/codexDetect.ts +69 -0
  95. package/lib/comfyBridge.js +164 -184
  96. package/lib/comfyBridge.ts +214 -0
  97. package/lib/db.js +41 -51
  98. package/lib/db.ts +166 -0
  99. package/lib/errorClassify.js +62 -78
  100. package/lib/errorClassify.ts +100 -0
  101. package/lib/generationErrors.js +140 -103
  102. package/lib/generationErrors.ts +125 -0
  103. package/lib/historyList.js +149 -147
  104. package/lib/historyList.ts +164 -0
  105. package/lib/imageMetadata.js +86 -89
  106. package/lib/imageMetadata.ts +111 -0
  107. package/lib/imageMetadataStore.js +46 -51
  108. package/lib/imageMetadataStore.ts +67 -0
  109. package/lib/imageModels.js +38 -45
  110. package/lib/imageModels.ts +52 -0
  111. package/lib/inflight.js +131 -150
  112. package/lib/inflight.ts +204 -0
  113. package/lib/localImportStore.js +105 -0
  114. package/lib/localImportStore.ts +111 -0
  115. package/lib/logger.js +105 -112
  116. package/lib/logger.ts +150 -0
  117. package/lib/nodeStore.js +65 -64
  118. package/lib/nodeStore.ts +81 -0
  119. package/lib/oauthLauncher.js +61 -59
  120. package/lib/oauthLauncher.ts +64 -0
  121. package/lib/oauthNormalize.js +15 -19
  122. package/lib/oauthNormalize.ts +30 -0
  123. package/lib/oauthProxy.js +834 -832
  124. package/lib/oauthProxy.ts +995 -0
  125. package/lib/openDirectory.js +41 -40
  126. package/lib/openDirectory.ts +45 -0
  127. package/lib/pngInfo.js +18 -20
  128. package/lib/pngInfo.ts +26 -0
  129. package/lib/promptImport/curatedSources.js +135 -0
  130. package/lib/promptImport/curatedSources.ts +139 -0
  131. package/lib/promptImport/discoveryRegistry.js +218 -0
  132. package/lib/promptImport/discoveryRegistry.ts +236 -0
  133. package/lib/promptImport/errors.js +10 -10
  134. package/lib/promptImport/errors.ts +18 -0
  135. package/lib/promptImport/githubDiscovery.js +238 -0
  136. package/lib/promptImport/githubDiscovery.ts +248 -0
  137. package/lib/promptImport/githubFolder.js +302 -0
  138. package/lib/promptImport/githubFolder.ts +308 -0
  139. package/lib/promptImport/githubSource.js +194 -171
  140. package/lib/promptImport/githubSource.ts +239 -0
  141. package/lib/promptImport/gptImageHints.js +61 -0
  142. package/lib/promptImport/gptImageHints.ts +68 -0
  143. package/lib/promptImport/parsePromptCandidates.js +110 -112
  144. package/lib/promptImport/parsePromptCandidates.ts +153 -0
  145. package/lib/promptImport/promptIndex.js +230 -0
  146. package/lib/promptImport/promptIndex.ts +248 -0
  147. package/lib/promptImport/rankPromptCandidates.js +52 -0
  148. package/lib/promptImport/rankPromptCandidates.ts +49 -0
  149. package/lib/providerOptions.js +31 -0
  150. package/lib/providerOptions.ts +41 -0
  151. package/lib/referenceImageCompress.js +51 -62
  152. package/lib/referenceImageCompress.ts +75 -0
  153. package/lib/refs.js +93 -81
  154. package/lib/refs.ts +117 -0
  155. package/lib/requestLogger.js +32 -38
  156. package/lib/requestLogger.ts +48 -0
  157. package/lib/responsesImageAdapter.js +351 -0
  158. package/lib/responsesImageAdapter.ts +352 -0
  159. package/lib/runtimePorts.js +71 -73
  160. package/lib/runtimePorts.ts +93 -0
  161. package/lib/sessionStore.js +179 -230
  162. package/lib/sessionStore.ts +272 -0
  163. package/lib/storageMigration.js +247 -245
  164. package/lib/storageMigration.ts +284 -0
  165. package/lib/styleSheet.js +86 -90
  166. package/lib/styleSheet.ts +128 -0
  167. package/lib/systemTrash.js +18 -0
  168. package/lib/systemTrash.ts +20 -0
  169. package/package.json +26 -10
  170. package/routes/annotations.js +76 -79
  171. package/routes/annotations.ts +95 -0
  172. package/routes/canvasVersions.js +50 -54
  173. package/routes/canvasVersions.ts +64 -0
  174. package/routes/cardNews.js +158 -171
  175. package/routes/cardNews.ts +183 -0
  176. package/routes/comfy.js +23 -31
  177. package/routes/comfy.ts +39 -0
  178. package/routes/edit.js +183 -214
  179. package/routes/edit.ts +230 -0
  180. package/routes/generate.js +269 -291
  181. package/routes/generate.ts +309 -0
  182. package/routes/health.js +102 -107
  183. package/routes/health.ts +114 -0
  184. package/routes/history.js +136 -144
  185. package/routes/history.ts +153 -0
  186. package/routes/imageImport.js +33 -0
  187. package/routes/imageImport.ts +33 -0
  188. package/routes/index.js +18 -16
  189. package/routes/index.ts +35 -0
  190. package/routes/metadata.js +60 -64
  191. package/routes/metadata.ts +71 -0
  192. package/routes/multimode.js +228 -263
  193. package/routes/multimode.ts +280 -0
  194. package/routes/nodes.js +378 -424
  195. package/routes/nodes.ts +455 -0
  196. package/routes/promptImport.js +291 -152
  197. package/routes/promptImport.ts +354 -0
  198. package/routes/prompts.js +333 -360
  199. package/routes/prompts.ts +379 -0
  200. package/routes/sessions.js +277 -285
  201. package/routes/sessions.ts +292 -0
  202. package/routes/storage.js +29 -31
  203. package/routes/storage.ts +39 -0
  204. package/server.js +189 -196
  205. package/server.ts +235 -0
  206. package/ui/dist/.vite/manifest.json +101 -0
  207. package/ui/dist/assets/CardNewsWorkspace-BJOCey7Z.js +2 -0
  208. package/ui/dist/assets/NodeCanvas-BZV40eAE.css +1 -0
  209. package/ui/dist/assets/NodeCanvas-C3dzYNsk.js +7 -0
  210. package/ui/dist/assets/PromptImportDialog-Dqu1VpUh.js +2 -0
  211. package/ui/dist/assets/PromptImportDiscoverySection-Dg8T9X0L.js +1 -0
  212. package/ui/dist/assets/PromptImportFolderSection-DBaqsFO4.js +1 -0
  213. package/ui/dist/assets/PromptLibraryPanel-p5QqR97M.js +2 -0
  214. package/ui/dist/assets/SettingsWorkspace-B5bSAZ6u.js +1 -0
  215. package/ui/dist/assets/index-C9cXwiWE.js +25 -0
  216. package/ui/dist/assets/index-CGMIkZXn.css +1 -0
  217. package/ui/dist/assets/index-Cvld7dUZ.js +1 -0
  218. package/ui/dist/index.html +6 -3
  219. package/assets/screenshot.png +0 -0
  220. package/assets/screenshots/classic-generate-light.png +0 -0
  221. package/assets/screenshots/node-graph-branching.png +0 -0
  222. package/assets/screenshots/settings-oauth-generation.png +0 -0
  223. package/assets/screenshots/settings-workspace.png +0 -0
  224. package/assets/screenshots/style-sheet-editor.png +0 -0
  225. package/integrations/comfyui/ima2_gen_bridge/__pycache__/__init__.cpython-313.pyc +0 -0
  226. package/integrations/comfyui/ima2_gen_bridge/__pycache__/nodes.cpython-313.pyc +0 -0
  227. package/ui/dist/assets/index-DARPdT4Q.css +0 -1
  228. package/ui/dist/assets/index-ht80GMq4.js +0 -31
  229. package/ui/dist/assets/index-ht80GMq4.js.map +0 -1
@@ -1,292 +1,284 @@
1
- import {
2
- createSession,
3
- listSessions,
4
- getSession,
5
- renameSession,
6
- deleteSession,
7
- saveGraph,
8
- getStyleSheet,
9
- setStyleSheet,
10
- setStyleSheetEnabled,
11
- } from "../lib/sessionStore.js";
1
+ import { createSession, listSessions, getSession, renameSession, deleteSession, saveGraph, getStyleSheet, setStyleSheet, setStyleSheetEnabled, } from "../lib/sessionStore.js";
12
2
  import { extractStyleSheet } from "../lib/styleSheet.js";
13
3
  import { logError, logEvent } from "../lib/logger.js";
14
-
15
4
  function safeJsonChars(value) {
16
- try {
17
- return JSON.stringify(value ?? null).length;
18
- } catch {
19
- return 0;
20
- }
21
- }
22
-
23
- export function registerSessionRoutes(app, ctx) {
24
- app.get("/api/sessions", (_req, res) => {
25
- try {
26
- res.json({ sessions: listSessions() });
27
- } catch (err) {
28
- res.status(500).json({ error: { code: "DB_ERROR", message: err.message } });
29
- }
30
- });
31
-
32
- app.post("/api/sessions", (req, res) => {
33
- try {
34
- const title = (req.body?.title || "Untitled").slice(0, 200);
35
- const session = createSession({ title });
36
- logEvent("session", "create", {
37
- sessionId: session.id,
38
- titleChars: session.title.length,
39
- });
40
- res.status(201).json({ session });
41
- } catch (err) {
42
- res.status(500).json({ error: { code: "DB_ERROR", message: err.message } });
43
- }
44
- });
45
-
46
- app.get("/api/sessions/:id", (req, res) => {
47
5
  try {
48
- const session = getSession(req.params.id);
49
- if (!session) {
50
- return res.status(404).json({
51
- error: { code: "SESSION_NOT_FOUND", message: "Session not found" },
52
- });
53
- }
54
- res.json({ session });
55
- } catch (err) {
56
- res.status(500).json({ error: { code: "DB_ERROR", message: err.message } });
6
+ return JSON.stringify(value ?? null).length;
57
7
  }
58
- });
59
-
60
- app.patch("/api/sessions/:id", (req, res) => {
61
- try {
62
- const title = req.body?.title;
63
- if (typeof title !== "string" || !title.trim()) {
64
- return res.status(400).json({
65
- error: { code: "INVALID_TITLE", message: "Title required" },
66
- });
67
- }
68
- const ok = renameSession(req.params.id, title.slice(0, 200));
69
- if (!ok) {
70
- return res.status(404).json({
71
- error: { code: "SESSION_NOT_FOUND", message: "Session not found" },
72
- });
73
- }
74
- logEvent("session", "rename", {
75
- sessionId: req.params.id,
76
- titleChars: title.slice(0, 200).length,
77
- });
78
- res.json({ ok: true });
79
- } catch (err) {
80
- res.status(500).json({ error: { code: "DB_ERROR", message: err.message } });
81
- }
82
- });
83
-
84
- app.delete("/api/sessions/:id", (req, res) => {
85
- try {
86
- const ok = deleteSession(req.params.id);
87
- if (!ok) {
88
- return res.status(404).json({
89
- error: { code: "SESSION_NOT_FOUND", message: "Session not found" },
90
- });
91
- }
92
- logEvent("session", "delete", { sessionId: req.params.id });
93
- res.json({ ok: true });
94
- } catch (err) {
95
- res.status(500).json({ error: { code: "DB_ERROR", message: err.message } });
96
- }
97
- });
98
-
99
- app.get("/api/sessions/:id/style-sheet", (req, res) => {
100
- try {
101
- const data = getStyleSheet(req.params.id);
102
- if (!data) {
103
- return res.status(404).json({
104
- error: { code: "SESSION_NOT_FOUND", message: "Session not found" },
105
- });
106
- }
107
- logEvent("session", "stylesheet_get", {
108
- sessionId: req.params.id,
109
- enabled: data.enabled,
110
- hasSheet: !!data.styleSheet,
111
- sheetChars: safeJsonChars(data.styleSheet),
112
- });
113
- res.json(data);
114
- } catch (err) {
115
- res.status(500).json({ error: { code: "DB_ERROR", message: err.message } });
8
+ catch {
9
+ return 0;
116
10
  }
117
- });
118
-
119
- app.put("/api/sessions/:id/style-sheet", (req, res) => {
120
- try {
121
- const { styleSheet, enabled } = req.body || {};
122
- if (styleSheet !== null && (typeof styleSheet !== "object" || Array.isArray(styleSheet))) {
123
- return res.status(400).json({
124
- error: { code: "INVALID_SHEET", message: "styleSheet must be an object or null" },
125
- });
126
- }
127
- if (enabled !== undefined && typeof enabled !== "boolean") {
128
- return res.status(400).json({
129
- error: { code: "INVALID_ENABLED", message: "enabled must be boolean when provided" },
130
- });
131
- }
132
- const ok = setStyleSheet(req.params.id, styleSheet);
133
- if (!ok) {
134
- return res.status(404).json({
135
- error: { code: "SESSION_NOT_FOUND", message: "Session not found" },
136
- });
137
- }
138
- if (typeof enabled === "boolean") setStyleSheetEnabled(req.params.id, enabled);
139
- logEvent("session", "stylesheet_save", {
140
- sessionId: req.params.id,
141
- enabled: typeof enabled === "boolean" ? enabled : undefined,
142
- hasSheet: !!styleSheet,
143
- sheetChars: safeJsonChars(styleSheet),
144
- });
145
- res.json({ ok: true });
146
- } catch (err) {
147
- res.status(500).json({ error: { code: "DB_ERROR", message: err.message } });
148
- }
149
- });
150
-
151
- app.patch("/api/sessions/:id/style-sheet/enabled", (req, res) => {
152
- try {
153
- const { enabled } = req.body || {};
154
- if (typeof enabled !== "boolean") {
155
- return res.status(400).json({
156
- error: { code: "INVALID_ENABLED", message: "enabled must be boolean" },
157
- });
158
- }
159
- const ok = setStyleSheetEnabled(req.params.id, enabled);
160
- if (!ok) {
161
- return res.status(404).json({
162
- error: { code: "SESSION_NOT_FOUND", message: "Session not found" },
163
- });
164
- }
165
- logEvent("session", "stylesheet_toggle", {
166
- sessionId: req.params.id,
167
- enabled,
168
- });
169
- res.json({ ok: true, enabled });
170
- } catch (err) {
171
- res.status(500).json({ error: { code: "DB_ERROR", message: err.message } });
172
- }
173
- });
174
-
175
- app.post("/api/sessions/:id/style-sheet/extract", async (req, res) => {
176
- try {
177
- if (!ctx.openai) {
178
- return res.status(400).json({
179
- error: {
180
- code: "STYLE_SHEET_NO_KEY",
181
- message: "Style-sheet extraction requires an OpenAI API key. Connect one via setup.",
182
- },
183
- });
184
- }
185
- const { prompt, referenceDataUrl } = req.body || {};
186
- if (typeof prompt !== "string" || !prompt.trim()) {
187
- return res.status(400).json({
188
- error: { code: "STYLE_SHEET_BAD_INPUT", message: "prompt required" },
189
- });
190
- }
191
- if (!getSession(req.params.id)) {
192
- return res.status(404).json({
193
- error: { code: "SESSION_NOT_FOUND", message: "Session not found" },
194
- });
195
- }
196
- logEvent("session", "stylesheet_extract_start", {
197
- sessionId: req.params.id,
198
- promptChars: prompt.length,
199
- hasReference: typeof referenceDataUrl === "string" && referenceDataUrl.length > 0,
200
- });
201
- const sheet = await extractStyleSheet(ctx.openai, {
202
- prompt: prompt.slice(0, 4000),
203
- referenceDataUrl: typeof referenceDataUrl === "string" ? referenceDataUrl : undefined,
204
- });
205
- const persisted = setStyleSheet(req.params.id, sheet);
206
- if (!persisted) {
207
- return res.status(404).json({
208
- error: { code: "SESSION_NOT_FOUND", message: "Session not found" },
209
- });
210
- }
211
- logEvent("session", "stylesheet_extract_done", {
212
- sessionId: req.params.id,
213
- sheetChars: safeJsonChars(sheet),
214
- });
215
- res.json({ styleSheet: sheet });
216
- } catch (err) {
217
- const code = err.code || "STYLE_SHEET_ERROR";
218
- const status =
219
- code === "STYLE_SHEET_NO_KEY" || code === "STYLE_SHEET_BAD_INPUT"
220
- ? 400
221
- : code === "STYLE_SHEET_EMPTY" || code === "STYLE_SHEET_PARSE" || code === "STYLE_SHEET_SHAPE"
222
- ? 422
223
- : 500;
224
- logError("session", "stylesheet_extract_error", err, { sessionId: req.params.id, code });
225
- res.status(status).json({ error: { code, message: err.message } });
226
- }
227
- });
228
-
229
- app.put("/api/sessions/:id/graph", (req, res) => {
230
- try {
231
- const { nodes, edges } = req.body || {};
232
- const rawIfMatch = req.get("If-Match");
233
- if (!Array.isArray(nodes) || !Array.isArray(edges)) {
234
- return res.status(400).json({
235
- error: { code: "INVALID_GRAPH", message: "nodes and edges arrays required" },
236
- });
237
- }
238
- if (!rawIfMatch) {
239
- return res.status(428).json({
240
- error: { code: "GRAPH_VERSION_REQUIRED", message: "If-Match header required" },
241
- });
242
- }
243
- if (nodes.length > 500 || edges.length > 1000) {
244
- return res.status(413).json({
245
- error: {
246
- code: "GRAPH_TOO_LARGE",
247
- message: `Graph too large (max 500 nodes / 1000 edges), got ${nodes.length}/${edges.length}`,
248
- },
249
- });
250
- }
251
- const expectedVersion = Number(String(rawIfMatch).replace(/"/g, ""));
252
- if (!Number.isFinite(expectedVersion)) {
253
- return res.status(400).json({
254
- error: { code: "INVALID_GRAPH_VERSION", message: "If-Match must be a finite integer" },
255
- });
256
- }
257
- const saveId = req.get("X-Ima2-Graph-Save-Id") || null;
258
- const saveReason = req.get("X-Ima2-Graph-Save-Reason") || null;
259
- const tabId = req.get("X-Ima2-Tab-Id") || null;
260
- const result = saveGraph(req.params.id, { nodes, edges, expectedVersion });
261
- logEvent("session", "graph_save", {
262
- sessionId: req.params.id,
263
- saveId,
264
- saveReason,
265
- tabId,
266
- nodes: nodes.length,
267
- edges: edges.length,
268
- graphVersion: result.graphVersion,
269
- });
270
- res.json({ ok: true, nodes: nodes.length, edges: edges.length, graphVersion: result.graphVersion });
271
- } catch (err) {
272
- const code = err.code || "DB_ERROR";
273
- const payload = { error: { code, message: err.message } };
274
- if (typeof err.currentVersion === "number") payload.currentVersion = err.currentVersion;
275
- if (code === "GRAPH_VERSION_CONFLICT") {
276
- logEvent("session", "graph_conflict", {
277
- sessionId: req.params.id,
278
- saveId: req.get("X-Ima2-Graph-Save-Id") || null,
279
- saveReason: req.get("X-Ima2-Graph-Save-Reason") || null,
280
- tabId: req.get("X-Ima2-Tab-Id") || null,
281
- expectedVersion: Number(String(req.get("If-Match") || "").replace(/"/g, "")),
282
- currentVersion: err.currentVersion ?? null,
283
- nodes: Array.isArray(req.body?.nodes) ? req.body.nodes.length : null,
284
- edges: Array.isArray(req.body?.edges) ? req.body.edges.length : null,
285
- });
286
- } else {
287
- logError("session", "graph_error", err, { sessionId: req.params.id, code });
288
- }
289
- res.status(err.status || 500).json(payload);
290
- }
291
- });
11
+ }
12
+ export function registerSessionRoutes(app, ctx) {
13
+ app.get("/api/sessions", (_req, res) => {
14
+ try {
15
+ res.json({ sessions: listSessions() });
16
+ }
17
+ catch (err) {
18
+ res.status(500).json({ error: { code: "DB_ERROR", message: err.message } });
19
+ }
20
+ });
21
+ app.post("/api/sessions", (req, res) => {
22
+ try {
23
+ const title = (req.body?.title || "Untitled").slice(0, 200);
24
+ const session = createSession({ title });
25
+ logEvent("session", "create", {
26
+ sessionId: session.id,
27
+ titleChars: session.title.length,
28
+ });
29
+ res.status(201).json({ session });
30
+ }
31
+ catch (err) {
32
+ res.status(500).json({ error: { code: "DB_ERROR", message: err.message } });
33
+ }
34
+ });
35
+ app.get("/api/sessions/:id", (req, res) => {
36
+ try {
37
+ const session = getSession(req.params.id);
38
+ if (!session) {
39
+ return res.status(404).json({
40
+ error: { code: "SESSION_NOT_FOUND", message: "Session not found" },
41
+ });
42
+ }
43
+ res.json({ session });
44
+ }
45
+ catch (err) {
46
+ res.status(500).json({ error: { code: "DB_ERROR", message: err.message } });
47
+ }
48
+ });
49
+ app.patch("/api/sessions/:id", (req, res) => {
50
+ try {
51
+ const title = req.body?.title;
52
+ if (typeof title !== "string" || !title.trim()) {
53
+ return res.status(400).json({
54
+ error: { code: "INVALID_TITLE", message: "Title required" },
55
+ });
56
+ }
57
+ const ok = renameSession(req.params.id, title.slice(0, 200));
58
+ if (!ok) {
59
+ return res.status(404).json({
60
+ error: { code: "SESSION_NOT_FOUND", message: "Session not found" },
61
+ });
62
+ }
63
+ logEvent("session", "rename", {
64
+ sessionId: req.params.id,
65
+ titleChars: title.slice(0, 200).length,
66
+ });
67
+ res.json({ ok: true });
68
+ }
69
+ catch (err) {
70
+ res.status(500).json({ error: { code: "DB_ERROR", message: err.message } });
71
+ }
72
+ });
73
+ app.delete("/api/sessions/:id", (req, res) => {
74
+ try {
75
+ const ok = deleteSession(req.params.id);
76
+ if (!ok) {
77
+ return res.status(404).json({
78
+ error: { code: "SESSION_NOT_FOUND", message: "Session not found" },
79
+ });
80
+ }
81
+ logEvent("session", "delete", { sessionId: req.params.id });
82
+ res.json({ ok: true });
83
+ }
84
+ catch (err) {
85
+ res.status(500).json({ error: { code: "DB_ERROR", message: err.message } });
86
+ }
87
+ });
88
+ app.get("/api/sessions/:id/style-sheet", (req, res) => {
89
+ try {
90
+ const data = getStyleSheet(req.params.id);
91
+ if (!data) {
92
+ return res.status(404).json({
93
+ error: { code: "SESSION_NOT_FOUND", message: "Session not found" },
94
+ });
95
+ }
96
+ logEvent("session", "stylesheet_get", {
97
+ sessionId: req.params.id,
98
+ enabled: data.enabled,
99
+ hasSheet: !!data.styleSheet,
100
+ sheetChars: safeJsonChars(data.styleSheet),
101
+ });
102
+ res.json(data);
103
+ }
104
+ catch (err) {
105
+ res.status(500).json({ error: { code: "DB_ERROR", message: err.message } });
106
+ }
107
+ });
108
+ app.put("/api/sessions/:id/style-sheet", (req, res) => {
109
+ try {
110
+ const { styleSheet, enabled } = req.body || {};
111
+ if (styleSheet !== null && (typeof styleSheet !== "object" || Array.isArray(styleSheet))) {
112
+ return res.status(400).json({
113
+ error: { code: "INVALID_SHEET", message: "styleSheet must be an object or null" },
114
+ });
115
+ }
116
+ if (enabled !== undefined && typeof enabled !== "boolean") {
117
+ return res.status(400).json({
118
+ error: { code: "INVALID_ENABLED", message: "enabled must be boolean when provided" },
119
+ });
120
+ }
121
+ const ok = setStyleSheet(req.params.id, styleSheet);
122
+ if (!ok) {
123
+ return res.status(404).json({
124
+ error: { code: "SESSION_NOT_FOUND", message: "Session not found" },
125
+ });
126
+ }
127
+ if (typeof enabled === "boolean")
128
+ setStyleSheetEnabled(req.params.id, enabled);
129
+ logEvent("session", "stylesheet_save", {
130
+ sessionId: req.params.id,
131
+ enabled: typeof enabled === "boolean" ? enabled : undefined,
132
+ hasSheet: !!styleSheet,
133
+ sheetChars: safeJsonChars(styleSheet),
134
+ });
135
+ res.json({ ok: true });
136
+ }
137
+ catch (err) {
138
+ res.status(500).json({ error: { code: "DB_ERROR", message: err.message } });
139
+ }
140
+ });
141
+ app.patch("/api/sessions/:id/style-sheet/enabled", (req, res) => {
142
+ try {
143
+ const { enabled } = req.body || {};
144
+ if (typeof enabled !== "boolean") {
145
+ return res.status(400).json({
146
+ error: { code: "INVALID_ENABLED", message: "enabled must be boolean" },
147
+ });
148
+ }
149
+ const ok = setStyleSheetEnabled(req.params.id, enabled);
150
+ if (!ok) {
151
+ return res.status(404).json({
152
+ error: { code: "SESSION_NOT_FOUND", message: "Session not found" },
153
+ });
154
+ }
155
+ logEvent("session", "stylesheet_toggle", {
156
+ sessionId: req.params.id,
157
+ enabled,
158
+ });
159
+ res.json({ ok: true, enabled });
160
+ }
161
+ catch (err) {
162
+ res.status(500).json({ error: { code: "DB_ERROR", message: err.message } });
163
+ }
164
+ });
165
+ app.post("/api/sessions/:id/style-sheet/extract", async (req, res) => {
166
+ try {
167
+ if (!ctx.openai) {
168
+ return res.status(400).json({
169
+ error: {
170
+ code: "STYLE_SHEET_NO_KEY",
171
+ message: "Style-sheet extraction requires an OpenAI API key. Connect one via setup.",
172
+ },
173
+ });
174
+ }
175
+ const { prompt, referenceDataUrl } = req.body || {};
176
+ if (typeof prompt !== "string" || !prompt.trim()) {
177
+ return res.status(400).json({
178
+ error: { code: "STYLE_SHEET_BAD_INPUT", message: "prompt required" },
179
+ });
180
+ }
181
+ if (!getSession(req.params.id)) {
182
+ return res.status(404).json({
183
+ error: { code: "SESSION_NOT_FOUND", message: "Session not found" },
184
+ });
185
+ }
186
+ logEvent("session", "stylesheet_extract_start", {
187
+ sessionId: req.params.id,
188
+ promptChars: prompt.length,
189
+ hasReference: typeof referenceDataUrl === "string" && referenceDataUrl.length > 0,
190
+ });
191
+ const sheet = await extractStyleSheet(ctx.openai, {
192
+ prompt: prompt.slice(0, 4000),
193
+ referenceDataUrl: typeof referenceDataUrl === "string" ? referenceDataUrl : undefined,
194
+ });
195
+ const persisted = setStyleSheet(req.params.id, sheet);
196
+ if (!persisted) {
197
+ return res.status(404).json({
198
+ error: { code: "SESSION_NOT_FOUND", message: "Session not found" },
199
+ });
200
+ }
201
+ logEvent("session", "stylesheet_extract_done", {
202
+ sessionId: req.params.id,
203
+ sheetChars: safeJsonChars(sheet),
204
+ });
205
+ res.json({ styleSheet: sheet });
206
+ }
207
+ catch (err) {
208
+ const code = err.code || "STYLE_SHEET_ERROR";
209
+ const status = code === "STYLE_SHEET_NO_KEY" || code === "STYLE_SHEET_BAD_INPUT"
210
+ ? 400
211
+ : code === "STYLE_SHEET_EMPTY" || code === "STYLE_SHEET_PARSE" || code === "STYLE_SHEET_SHAPE"
212
+ ? 422
213
+ : 500;
214
+ logError("session", "stylesheet_extract_error", err, { sessionId: req.params.id, code });
215
+ res.status(status).json({ error: { code, message: err.message } });
216
+ }
217
+ });
218
+ app.put("/api/sessions/:id/graph", (req, res) => {
219
+ try {
220
+ const { nodes, edges } = req.body || {};
221
+ const rawIfMatch = req.get("If-Match");
222
+ if (!Array.isArray(nodes) || !Array.isArray(edges)) {
223
+ return res.status(400).json({
224
+ error: { code: "INVALID_GRAPH", message: "nodes and edges arrays required" },
225
+ });
226
+ }
227
+ if (!rawIfMatch) {
228
+ return res.status(428).json({
229
+ error: { code: "GRAPH_VERSION_REQUIRED", message: "If-Match header required" },
230
+ });
231
+ }
232
+ if (nodes.length > 500 || edges.length > 1000) {
233
+ return res.status(413).json({
234
+ error: {
235
+ code: "GRAPH_TOO_LARGE",
236
+ message: `Graph too large (max 500 nodes / 1000 edges), got ${nodes.length}/${edges.length}`,
237
+ },
238
+ });
239
+ }
240
+ const expectedVersion = Number(String(rawIfMatch).replace(/"/g, ""));
241
+ if (!Number.isFinite(expectedVersion)) {
242
+ return res.status(400).json({
243
+ error: { code: "INVALID_GRAPH_VERSION", message: "If-Match must be a finite integer" },
244
+ });
245
+ }
246
+ const saveId = req.get("X-Ima2-Graph-Save-Id") || null;
247
+ const saveReason = req.get("X-Ima2-Graph-Save-Reason") || null;
248
+ const tabId = req.get("X-Ima2-Tab-Id") || null;
249
+ const result = saveGraph(req.params.id, { nodes, edges, expectedVersion });
250
+ logEvent("session", "graph_save", {
251
+ sessionId: req.params.id,
252
+ saveId,
253
+ saveReason,
254
+ tabId,
255
+ nodes: nodes.length,
256
+ edges: edges.length,
257
+ graphVersion: result.graphVersion,
258
+ });
259
+ res.json({ ok: true, nodes: nodes.length, edges: edges.length, graphVersion: result.graphVersion });
260
+ }
261
+ catch (err) {
262
+ const code = err.code || "DB_ERROR";
263
+ const payload = { error: { code, message: err.message } };
264
+ if (typeof err.currentVersion === "number")
265
+ payload.currentVersion = err.currentVersion;
266
+ if (code === "GRAPH_VERSION_CONFLICT") {
267
+ logEvent("session", "graph_conflict", {
268
+ sessionId: req.params.id,
269
+ saveId: req.get("X-Ima2-Graph-Save-Id") || null,
270
+ saveReason: req.get("X-Ima2-Graph-Save-Reason") || null,
271
+ tabId: req.get("X-Ima2-Tab-Id") || null,
272
+ expectedVersion: Number(String(req.get("If-Match") || "").replace(/"/g, "")),
273
+ currentVersion: err.currentVersion ?? null,
274
+ nodes: Array.isArray(req.body?.nodes) ? req.body.nodes.length : null,
275
+ edges: Array.isArray(req.body?.edges) ? req.body.edges.length : null,
276
+ });
277
+ }
278
+ else {
279
+ logError("session", "graph_error", err, { sessionId: req.params.id, code });
280
+ }
281
+ res.status(err.status || 500).json(payload);
282
+ }
283
+ });
292
284
  }