@pixelbyte-software/pixcode 1.51.1 → 1.51.3

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 (320) hide show
  1. package/CODE_OF_CONDUCT.md +41 -41
  2. package/CONTRIBUTING.md +155 -155
  3. package/LICENSE +718 -718
  4. package/README.de.md +169 -169
  5. package/README.ja.md +167 -167
  6. package/README.ko.md +167 -167
  7. package/README.md +419 -419
  8. package/README.ru.md +169 -169
  9. package/README.tr.md +298 -298
  10. package/README.zh-CN.md +167 -167
  11. package/SECURITY.md +46 -46
  12. package/dist/api-automation.html +110 -110
  13. package/dist/api-docs.html +548 -548
  14. package/dist/assets/{index-DARIZgoD.js → index-17CwxHSZ.js} +185 -185
  15. package/dist/assets/index-B9N-gfOQ.css +32 -0
  16. package/dist/clear-cache.html +85 -85
  17. package/dist/convert-icons.md +52 -52
  18. package/dist/docs.html +308 -308
  19. package/dist/favicon.svg +8 -8
  20. package/dist/features.html +133 -133
  21. package/dist/generate-icons.js +48 -48
  22. package/dist/humans.txt +15 -15
  23. package/dist/icons/codex-white.svg +3 -3
  24. package/dist/icons/codex.svg +3 -3
  25. package/dist/icons/cursor-white.svg +11 -11
  26. package/dist/icons/icon-128x128.svg +9 -9
  27. package/dist/icons/icon-144x144.svg +9 -9
  28. package/dist/icons/icon-152x152.svg +9 -9
  29. package/dist/icons/icon-192x192.svg +9 -9
  30. package/dist/icons/icon-384x384.svg +9 -9
  31. package/dist/icons/icon-512x512.svg +9 -9
  32. package/dist/icons/icon-72x72.svg +9 -9
  33. package/dist/icons/icon-96x96.svg +9 -9
  34. package/dist/icons/icon-template.svg +9 -9
  35. package/dist/icons/qwen-logo.svg +14 -14
  36. package/dist/index.html +59 -59
  37. package/dist/landing.html +268 -268
  38. package/dist/llms-full.txt +119 -119
  39. package/dist/llms.txt +53 -53
  40. package/dist/logo.svg +12 -12
  41. package/dist/manifest.json +60 -60
  42. package/dist/openapi.yaml +1696 -1696
  43. package/dist/orchestration.html +125 -125
  44. package/dist/robots.txt +4 -4
  45. package/dist/site.css +692 -692
  46. package/dist/sitemap.xml +51 -51
  47. package/dist/sw.js +132 -132
  48. package/dist-server/server/cli.js +96 -96
  49. package/dist-server/server/daemon/manager.js +33 -33
  50. package/dist-server/server/daemon-manager.js +64 -64
  51. package/dist-server/server/index.js +125 -4
  52. package/dist-server/server/index.js.map +1 -1
  53. package/dist-server/server/modules/orchestration/a2a/adapters/json-event.adapter.js +84 -0
  54. package/dist-server/server/modules/orchestration/a2a/adapters/json-event.adapter.js.map +1 -0
  55. package/dist-server/server/modules/orchestration/a2a/adapters/json-event.adapter.test.js +43 -0
  56. package/dist-server/server/modules/orchestration/a2a/adapters/json-event.adapter.test.js.map +1 -0
  57. package/dist-server/server/modules/orchestration/hermes/hermes.routes.js +55 -1
  58. package/dist-server/server/modules/orchestration/hermes/hermes.routes.js.map +1 -1
  59. package/dist-server/server/modules/orchestration/index.js +1 -0
  60. package/dist-server/server/modules/orchestration/index.js.map +1 -1
  61. package/dist-server/server/routes/commands.js +25 -25
  62. package/dist-server/server/routes/git.js +17 -17
  63. package/dist-server/server/routes/live-view.js +46 -46
  64. package/dist-server/server/services/hermes-gateway.js +310 -0
  65. package/dist-server/server/services/hermes-gateway.js.map +1 -1
  66. package/dist-server/server/services/public-api-manifest.js +59 -51
  67. package/dist-server/server/services/public-api-manifest.js.map +1 -1
  68. package/package.json +222 -222
  69. package/scripts/fix-node-pty.js +67 -67
  70. package/scripts/github/create-v1.38-issues.mjs +351 -351
  71. package/scripts/github/create-vscode-workbench-issues.mjs +121 -121
  72. package/scripts/hermes/configure-pixcode-mcp.mjs +165 -163
  73. package/scripts/hermes/pixcode-mcp-server.mjs +1009 -958
  74. package/scripts/smoke/changes-panel-layout.mjs +48 -48
  75. package/scripts/smoke/chat-composer-fixed-layout.mjs +55 -55
  76. package/scripts/smoke/chat-message-timeline-order.mjs +41 -41
  77. package/scripts/smoke/chat-realtime-hydration.mjs +44 -44
  78. package/scripts/smoke/chat-session-provider-pools.mjs +35 -35
  79. package/scripts/smoke/chat-session-state.mjs +19 -19
  80. package/scripts/smoke/code-editor-theme.mjs +55 -55
  81. package/scripts/smoke/code-editor-vscode-engine.mjs +91 -91
  82. package/scripts/smoke/command-center-agent-writes.mjs +79 -79
  83. package/scripts/smoke/command-center-non-git.mjs +46 -46
  84. package/scripts/smoke/context-packet.mjs +43 -43
  85. package/scripts/smoke/control-room-ux-redesign.mjs +91 -91
  86. package/scripts/smoke/daemon-entrypoint.mjs +20 -20
  87. package/scripts/smoke/default-landing-routing.mjs +33 -33
  88. package/scripts/smoke/desktop-native-notifications.mjs +30 -30
  89. package/scripts/smoke/desktop-tray-icon.mjs +33 -33
  90. package/scripts/smoke/discord-release-workflow.mjs +24 -24
  91. package/scripts/smoke/git-install-update.mjs +255 -255
  92. package/scripts/smoke/handoff-artifact-protocol.mjs +50 -50
  93. package/scripts/smoke/hermes-api-install.mjs +56 -56
  94. package/scripts/smoke/hermes-gateway-persistence.mjs +104 -104
  95. package/scripts/smoke/hermes-mcp-pixcode-roundtrip.mjs +426 -367
  96. package/scripts/smoke/hermes-rest-chat-api.mjs +162 -162
  97. package/scripts/smoke/hermes-rest-chat-live.mjs +45 -45
  98. package/scripts/smoke/hermes-rest-codex-launch.mjs +209 -209
  99. package/scripts/smoke/hermes-rest-gateway.mjs +79 -70
  100. package/scripts/smoke/hermes-rest-live.mjs +42 -42
  101. package/scripts/smoke/hermes-roundtrip.mjs +167 -167
  102. package/scripts/smoke/hermes-settings-commands.mjs +349 -346
  103. package/scripts/smoke/hermes-smoke-launcher-guard.mjs +34 -34
  104. package/scripts/smoke/live-view-diagnostics.mjs +53 -53
  105. package/scripts/smoke/live-view-environment.mjs +92 -92
  106. package/scripts/smoke/live-view-integration.mjs +450 -450
  107. package/scripts/smoke/mac-desktop-runtime.mjs +37 -37
  108. package/scripts/smoke/mobile-tunnel-guidance.mjs +29 -29
  109. package/scripts/smoke/model-registry.mjs +36 -36
  110. package/scripts/smoke/multi-project-ui.mjs +45 -45
  111. package/scripts/smoke/multi-worker-slots.mjs +42 -42
  112. package/scripts/smoke/notification-center.mjs +87 -87
  113. package/scripts/smoke/notification-inapp-preference.mjs +23 -23
  114. package/scripts/smoke/notification-taxonomy.mjs +58 -58
  115. package/scripts/smoke/orchestration-api.mjs +172 -172
  116. package/scripts/smoke/orchestration-execution-dashboard.mjs +33 -33
  117. package/scripts/smoke/orchestration-live-run.mjs +176 -176
  118. package/scripts/smoke/orchestration-mobile-scroll.mjs +29 -29
  119. package/scripts/smoke/orchestration-model-sync.mjs +30 -30
  120. package/scripts/smoke/orchestration-permission-fallback.mjs +34 -34
  121. package/scripts/smoke/orchestration-runtime-guards.mjs +48 -48
  122. package/scripts/smoke/orchestration-user-facing-output.mjs +25 -25
  123. package/scripts/smoke/permission-policy.mjs +50 -50
  124. package/scripts/smoke/pixcode-workbench-1-48.mjs +167 -164
  125. package/scripts/smoke/provider-models-opencode-live.mjs +66 -66
  126. package/scripts/smoke/provider-rest-api.mjs +124 -124
  127. package/scripts/smoke/provider-selection-status.mjs +52 -52
  128. package/scripts/smoke/run-state-refresh.mjs +52 -52
  129. package/scripts/smoke/runtime-manager.mjs +99 -99
  130. package/scripts/smoke/shell-manual-disconnect.mjs +30 -30
  131. package/scripts/smoke/side-panel-editor-layout.mjs +34 -34
  132. package/scripts/smoke/static-root-routing.mjs +21 -21
  133. package/scripts/smoke/strict-handoff-compact.mjs +60 -60
  134. package/scripts/smoke/taskmaster-config.mjs +24 -24
  135. package/scripts/smoke/taskmaster-execution-telegram.mjs +3 -3
  136. package/scripts/smoke/taskmaster-onboarding.mjs +3 -3
  137. package/scripts/smoke/taskmaster-run-graph.mjs +3 -3
  138. package/scripts/smoke/telegram-control.mjs +242 -242
  139. package/scripts/smoke/tunnel-persistence.mjs +56 -56
  140. package/scripts/smoke/update-issue-progress.mjs +69 -69
  141. package/scripts/smoke/update-ux.mjs +55 -55
  142. package/scripts/smoke/v138-completion.mjs +132 -132
  143. package/scripts/smoke/v138-desktop-release-hardening.mjs +69 -69
  144. package/scripts/smoke/v138-diagnostics.mjs +63 -63
  145. package/scripts/smoke/v138-issue-planner.mjs +33 -33
  146. package/scripts/smoke/v143-remote-control.mjs +76 -76
  147. package/scripts/smoke/v144-production-loop.mjs +47 -47
  148. package/scripts/smoke/v145-platformization.mjs +46 -46
  149. package/scripts/smoke/v146-control-room-ui.mjs +150 -150
  150. package/scripts/smoke/version-modal-autoshow.mjs +29 -29
  151. package/scripts/smoke/vscode-workbench-layout.mjs +63 -63
  152. package/scripts/smoke/vscode-workbench-polish.mjs +461 -436
  153. package/scripts/smoke/workflow-fallback-replay.mjs +56 -56
  154. package/scripts/smoke/workflow-templates.mjs +43 -43
  155. package/scripts/smoke/workflow-trace-timeline.mjs +46 -46
  156. package/scripts/update-git-install.mjs +293 -293
  157. package/server/claude-sdk.js +920 -920
  158. package/server/cli.js +1039 -1039
  159. package/server/constants/config.js +4 -4
  160. package/server/cursor-cli.js +344 -344
  161. package/server/daemon/manager.js +563 -563
  162. package/server/daemon-manager.js +964 -964
  163. package/server/database/db.js +921 -921
  164. package/server/database/json-store.js +197 -197
  165. package/server/gemini-cli.js +550 -550
  166. package/server/gemini-response-handler.js +79 -79
  167. package/server/index.js +131 -3
  168. package/server/load-env.js +35 -35
  169. package/server/middleware/auth.js +175 -175
  170. package/server/modules/orchestration/a2a/adapter-registry.ts +108 -108
  171. package/server/modules/orchestration/a2a/adapters/abstract-a2a.adapter.ts +63 -63
  172. package/server/modules/orchestration/a2a/adapters/claude-code.adapter.ts +286 -286
  173. package/server/modules/orchestration/a2a/adapters/codex.adapter.ts +244 -244
  174. package/server/modules/orchestration/a2a/adapters/cursor.adapter.ts +249 -249
  175. package/server/modules/orchestration/a2a/adapters/gemini.adapter.ts +248 -248
  176. package/server/modules/orchestration/a2a/adapters/json-event.adapter.test.ts +60 -0
  177. package/server/modules/orchestration/a2a/adapters/json-event.adapter.ts +101 -0
  178. package/server/modules/orchestration/a2a/adapters/opencode.adapter.ts +248 -248
  179. package/server/modules/orchestration/a2a/adapters/qwen.adapter.ts +248 -248
  180. package/server/modules/orchestration/a2a/agent-card.ts +55 -55
  181. package/server/modules/orchestration/a2a/routes.ts +590 -590
  182. package/server/modules/orchestration/a2a/task-store.ts +178 -178
  183. package/server/modules/orchestration/a2a/types.ts +126 -126
  184. package/server/modules/orchestration/a2a/validator.ts +113 -113
  185. package/server/modules/orchestration/hermes/hermes.routes.ts +642 -583
  186. package/server/modules/orchestration/index.ts +101 -100
  187. package/server/modules/orchestration/preview/port-watcher.ts +112 -112
  188. package/server/modules/orchestration/preview/preview-proxy.ts +60 -60
  189. package/server/modules/orchestration/preview/types.ts +19 -19
  190. package/server/modules/orchestration/security/permission-policy.ts +401 -401
  191. package/server/modules/orchestration/tasks/orchestration-task-store.ts +41 -41
  192. package/server/modules/orchestration/tasks/orchestration-task.routes.ts +64 -64
  193. package/server/modules/orchestration/tasks/orchestration-task.service.ts +209 -209
  194. package/server/modules/orchestration/tasks/orchestration-task.types.ts +40 -40
  195. package/server/modules/orchestration/tasks/task-run-graph.ts +155 -155
  196. package/server/modules/orchestration/workflows/approval-queue.ts +106 -106
  197. package/server/modules/orchestration/workflows/built-in-workflows.ts +127 -127
  198. package/server/modules/orchestration/workflows/context-packet.ts +186 -186
  199. package/server/modules/orchestration/workflows/handoff-artifact.ts +175 -175
  200. package/server/modules/orchestration/workflows/workflow-fallback-policy.ts +161 -161
  201. package/server/modules/orchestration/workflows/workflow-replay.ts +254 -254
  202. package/server/modules/orchestration/workflows/workflow-runner.ts +2070 -2070
  203. package/server/modules/orchestration/workflows/workflow-store.ts +97 -97
  204. package/server/modules/orchestration/workflows/workflow-templates.ts +272 -272
  205. package/server/modules/orchestration/workflows/workflow-trace.ts +424 -424
  206. package/server/modules/orchestration/workflows/workflow.routes.ts +586 -586
  207. package/server/modules/orchestration/workflows/workflow.types.ts +111 -111
  208. package/server/modules/orchestration/workflows/workspace-target.ts +122 -122
  209. package/server/modules/orchestration/workspace/docker-workspace.ts +136 -136
  210. package/server/modules/orchestration/workspace/path-safety.ts +55 -55
  211. package/server/modules/orchestration/workspace/types.ts +52 -52
  212. package/server/modules/orchestration/workspace/workspace-manager.ts +102 -102
  213. package/server/modules/orchestration/workspace/worktree-workspace.ts +126 -126
  214. package/server/modules/providers/index.ts +2 -2
  215. package/server/modules/providers/list/claude/claude-auth.provider.ts +146 -146
  216. package/server/modules/providers/list/claude/claude-mcp.provider.ts +135 -135
  217. package/server/modules/providers/list/claude/claude-sessions.provider.ts +306 -306
  218. package/server/modules/providers/list/claude/claude.provider.ts +15 -15
  219. package/server/modules/providers/list/codex/codex-auth.provider.ts +117 -117
  220. package/server/modules/providers/list/codex/codex-mcp.provider.ts +135 -135
  221. package/server/modules/providers/list/codex/codex-sessions.provider.ts +319 -319
  222. package/server/modules/providers/list/codex/codex.provider.ts +15 -15
  223. package/server/modules/providers/list/cursor/cursor-auth.provider.ts +147 -147
  224. package/server/modules/providers/list/cursor/cursor-mcp.provider.ts +108 -108
  225. package/server/modules/providers/list/cursor/cursor-sessions.provider.ts +421 -421
  226. package/server/modules/providers/list/cursor/cursor.provider.ts +15 -15
  227. package/server/modules/providers/list/gemini/gemini-auth.provider.ts +173 -173
  228. package/server/modules/providers/list/gemini/gemini-mcp.provider.ts +110 -110
  229. package/server/modules/providers/list/gemini/gemini-sessions.provider.ts +227 -227
  230. package/server/modules/providers/list/gemini/gemini.provider.ts +15 -15
  231. package/server/modules/providers/list/opencode/opencode-auth.provider.ts +131 -131
  232. package/server/modules/providers/list/opencode/opencode-mcp.provider.ts +126 -126
  233. package/server/modules/providers/list/opencode/opencode-sessions.provider.ts +286 -286
  234. package/server/modules/providers/list/opencode/opencode.provider.ts +29 -29
  235. package/server/modules/providers/list/qwen/qwen-auth.provider.ts +146 -146
  236. package/server/modules/providers/list/qwen/qwen-mcp.provider.ts +114 -114
  237. package/server/modules/providers/list/qwen/qwen-sessions.provider.ts +265 -265
  238. package/server/modules/providers/list/qwen/qwen.provider.ts +21 -21
  239. package/server/modules/providers/provider.registry.ts +40 -40
  240. package/server/modules/providers/provider.routes.ts +944 -944
  241. package/server/modules/providers/services/mcp.service.ts +86 -86
  242. package/server/modules/providers/services/provider-auth.service.ts +26 -26
  243. package/server/modules/providers/services/sessions.service.ts +45 -45
  244. package/server/modules/providers/shared/base/abstract.provider.ts +20 -20
  245. package/server/modules/providers/shared/mcp/mcp.provider.ts +151 -151
  246. package/server/modules/providers/shared/provider-configs.ts +142 -142
  247. package/server/modules/providers/tests/mcp.test.ts +293 -293
  248. package/server/openai-codex.js +462 -462
  249. package/server/opencode-cli.js +491 -491
  250. package/server/opencode-response-handler.js +111 -111
  251. package/server/projects.js +3008 -3008
  252. package/server/qwen-code-cli.js +410 -410
  253. package/server/qwen-response-handler.js +73 -73
  254. package/server/routes/agent.js +1435 -1435
  255. package/server/routes/auth.js +159 -159
  256. package/server/routes/codex.js +20 -20
  257. package/server/routes/commands.js +570 -570
  258. package/server/routes/cursor.js +61 -61
  259. package/server/routes/diagnostics.js +41 -41
  260. package/server/routes/gemini.js +25 -25
  261. package/server/routes/git.js +1650 -1650
  262. package/server/routes/live-view.js +411 -411
  263. package/server/routes/mcp-utils.js +13 -13
  264. package/server/routes/messages.js +62 -62
  265. package/server/routes/network.js +125 -125
  266. package/server/routes/platformization.js +212 -212
  267. package/server/routes/plugins.js +320 -320
  268. package/server/routes/production-agent-loop.js +90 -90
  269. package/server/routes/projects.js +917 -917
  270. package/server/routes/public-api.js +34 -34
  271. package/server/routes/qwen.js +27 -27
  272. package/server/routes/remote.js +55 -55
  273. package/server/routes/settings.js +321 -321
  274. package/server/routes/telegram.js +140 -140
  275. package/server/routes/user.js +125 -125
  276. package/server/routes/webhooks.js +63 -63
  277. package/server/services/control-room.js +102 -102
  278. package/server/services/diagnostics.js +165 -165
  279. package/server/services/external-access.js +375 -375
  280. package/server/services/hermes-gateway.js +1562 -1247
  281. package/server/services/hermes-install-jobs.js +729 -729
  282. package/server/services/install-jobs.js +715 -715
  283. package/server/services/live-view.js +956 -956
  284. package/server/services/managed-runtimes.js +493 -493
  285. package/server/services/model-registry.js +144 -144
  286. package/server/services/notification-orchestrator.js +365 -365
  287. package/server/services/notification-taxonomy.js +204 -204
  288. package/server/services/platformization.js +815 -815
  289. package/server/services/production-agent-loop.js +248 -248
  290. package/server/services/provider-cli-versions.js +149 -149
  291. package/server/services/provider-credentials.js +189 -189
  292. package/server/services/provider-models.js +396 -396
  293. package/server/services/public-api-manifest.js +190 -182
  294. package/server/services/remote-connection.js +127 -127
  295. package/server/services/runtime-manager.js +323 -323
  296. package/server/services/startup-update.js +234 -234
  297. package/server/services/telegram/bot.js +331 -331
  298. package/server/services/telegram/control-center.js +979 -979
  299. package/server/services/telegram/telegram-http-client.js +151 -151
  300. package/server/services/telegram/translations.js +340 -340
  301. package/server/services/vapid-keys.js +36 -36
  302. package/server/services/webhooks.js +216 -216
  303. package/server/sessionManager.js +225 -225
  304. package/server/shared/interfaces.ts +54 -54
  305. package/server/shared/types.ts +172 -172
  306. package/server/shared/utils.ts +193 -193
  307. package/server/tsconfig.json +36 -36
  308. package/server/utils/colors.js +21 -21
  309. package/server/utils/commandParser.js +305 -305
  310. package/server/utils/frontmatter.js +18 -18
  311. package/server/utils/gitConfig.js +34 -34
  312. package/server/utils/plugin-loader.js +457 -457
  313. package/server/utils/plugin-process-manager.js +185 -185
  314. package/server/utils/port-access.js +209 -209
  315. package/server/utils/runtime-paths.js +37 -37
  316. package/server/utils/url-detection.js +71 -71
  317. package/server/vite-daemon.js +79 -79
  318. package/shared/modelConstants.js +161 -161
  319. package/shared/networkHosts.js +22 -22
  320. package/dist/assets/index-DMz0zv6T.css +0 -32
package/dist/api-docs.html CHANGED
@@ -1,548 +1,548 @@
1
- <!DOCTYPE html>
2
- <html lang="en">
3
- <head>
4
- <meta charset="UTF-8" />
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
6
- <title>Pixcode — API Documentation</title>
7
- <meta name="description" content="REST API reference for Pixcode — the multi-CLI web UI for Claude Code, Cursor, Codex, Gemini, Qwen, and OpenCode." />
8
- <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
9
- <link rel="icon" type="image/png" href="/favicon.png" />
10
- <style>
11
- :root {
12
- --bg: #0b0d10;
13
- --bg-soft: #11151b;
14
- --bg-card: #161b22;
15
- --border: #232a33;
16
- --fg: #e6edf3;
17
- --fg-muted: #8b949e;
18
- --primary: #2563eb;
19
- --primary-hover: #1d4ed8;
20
- --accent: #10b981;
21
- --warn: #f59e0b;
22
- --code-bg: #05080d;
23
- }
24
- @media (prefers-color-scheme: light) {
25
- :root {
26
- --bg: #ffffff;
27
- --bg-soft: #f6f8fa;
28
- --bg-card: #ffffff;
29
- --border: #d0d7de;
30
- --fg: #1f2328;
31
- --fg-muted: #656d76;
32
- --code-bg: #f6f8fa;
33
- }
34
- }
35
-
36
- * { box-sizing: border-box; }
37
- html, body { margin: 0; padding: 0; }
38
- body {
39
- background: var(--bg);
40
- color: var(--fg);
41
- font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Inter, sans-serif;
42
- min-height: 100vh;
43
- }
44
-
45
- /* ── Top bar ─────────────────────────────────────────────────── */
46
- .topbar {
47
- position: sticky; top: 0; z-index: 50;
48
- display: flex; align-items: center; gap: 12px;
49
- padding: 10px 16px;
50
- background: var(--bg-soft);
51
- border-bottom: 1px solid var(--border);
52
- backdrop-filter: blur(8px);
53
- }
54
- .topbar-brand {
55
- display: flex; align-items: center; gap: 10px;
56
- font-weight: 700; font-size: 15px; letter-spacing: -0.01em;
57
- color: var(--fg); text-decoration: none;
58
- }
59
- .topbar-brand img { width: 24px; height: 24px; border-radius: 6px; }
60
- .topbar-brand .badge {
61
- font-size: 10px; font-weight: 600;
62
- padding: 2px 6px; border-radius: 4px;
63
- background: var(--primary); color: white;
64
- letter-spacing: 0.04em; text-transform: uppercase;
65
- }
66
- .topbar-spacer { flex: 1; }
67
- .topbar-actions { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; }
68
- .topbar select, .topbar a.btn, .topbar button.btn {
69
- height: 32px;
70
- padding: 0 12px;
71
- border-radius: 6px;
72
- border: 1px solid var(--border);
73
- background: var(--bg-card);
74
- color: var(--fg);
75
- font-size: 13px;
76
- cursor: pointer;
77
- text-decoration: none;
78
- display: inline-flex; align-items: center; gap: 6px;
79
- }
80
- .topbar a.btn:hover, .topbar button.btn:hover { border-color: var(--primary); }
81
- .topbar a.btn.primary, .topbar button.btn.primary {
82
- background: var(--primary); border-color: var(--primary); color: white;
83
- }
84
- .topbar a.btn.primary:hover { background: var(--primary-hover); border-color: var(--primary-hover); }
85
-
86
- /* ── API key bar ──────────────────────────────────────────────── */
87
- .apikey-bar {
88
- display: flex; align-items: center; gap: 10px;
89
- padding: 10px 16px;
90
- background: var(--bg-card);
91
- border-bottom: 1px solid var(--border);
92
- flex-wrap: wrap;
93
- }
94
- .apikey-bar label {
95
- font-size: 12px; font-weight: 600; color: var(--fg-muted);
96
- letter-spacing: 0.02em; text-transform: uppercase;
97
- }
98
- .apikey-bar input {
99
- flex: 1; min-width: 220px;
100
- height: 34px; padding: 0 12px;
101
- background: var(--bg-soft);
102
- border: 1px solid var(--border);
103
- border-radius: 6px;
104
- color: var(--fg);
105
- font-family: 'SF Mono', ui-monospace, monospace;
106
- font-size: 13px;
107
- }
108
- .apikey-bar input:focus { outline: none; border-color: var(--primary); }
109
- .apikey-bar .hint { font-size: 12px; color: var(--fg-muted); }
110
- .apikey-bar .status {
111
- font-size: 11px; padding: 3px 8px; border-radius: 999px;
112
- background: var(--bg-soft); color: var(--fg-muted);
113
- border: 1px solid var(--border);
114
- }
115
- .apikey-bar .status.ok { color: var(--accent); border-color: var(--accent); }
116
-
117
- /* ── Quick guide ──────────────────────────────────────────────── */
118
- .quick-guide {
119
- display: grid;
120
- grid-template-columns: minmax(0, 1fr) minmax(260px, 420px);
121
- gap: 14px;
122
- padding: 14px 16px;
123
- background:
124
- radial-gradient(circle at top left, color-mix(in srgb, var(--primary) 16%, transparent), transparent 38%),
125
- var(--bg-soft);
126
- border-bottom: 1px solid var(--border);
127
- }
128
- .quick-guide h2 {
129
- margin: 0 0 6px;
130
- font-size: 15px;
131
- letter-spacing: -0.01em;
132
- }
133
- .quick-guide p {
134
- margin: 0;
135
- color: var(--fg-muted);
136
- font-size: 13px;
137
- line-height: 1.55;
138
- }
139
- .guide-grid {
140
- display: grid;
141
- grid-template-columns: repeat(3, minmax(0, 1fr));
142
- gap: 8px;
143
- margin-top: 10px;
144
- }
145
- .guide-card {
146
- border: 1px solid var(--border);
147
- border-radius: 10px;
148
- background: color-mix(in srgb, var(--bg-card) 86%, transparent);
149
- padding: 10px;
150
- min-width: 0;
151
- }
152
- .guide-card strong {
153
- display: block;
154
- font-size: 12px;
155
- margin-bottom: 5px;
156
- }
157
- .guide-card code {
158
- display: block;
159
- overflow: hidden;
160
- text-overflow: ellipsis;
161
- white-space: nowrap;
162
- color: var(--accent);
163
- font-family: 'SF Mono', ui-monospace, monospace;
164
- font-size: 11px;
165
- }
166
- .curl-box {
167
- margin: 0;
168
- overflow: auto;
169
- border: 1px solid var(--border);
170
- border-radius: 10px;
171
- background: var(--code-bg);
172
- color: var(--fg);
173
- padding: 12px;
174
- font-family: 'SF Mono', ui-monospace, monospace;
175
- font-size: 11px;
176
- line-height: 1.5;
177
- }
178
-
179
- /* ── Scalar host ──────────────────────────────────────────────── */
180
- #scalar-host { min-height: calc(100vh - 130px); }
181
-
182
- /* ── Mobile tweaks ────────────────────────────────────────────── */
183
- @media (max-width: 640px) {
184
- .topbar { padding: 8px 10px; gap: 8px; }
185
- .topbar-brand .subtitle { display: none; }
186
- .topbar-actions a.btn span:not(.icon) { display: none; }
187
- .apikey-bar { padding: 8px 10px; }
188
- .apikey-bar .hint { display: none; }
189
- .quick-guide { grid-template-columns: 1fr; padding: 12px 10px; }
190
- .guide-grid { grid-template-columns: 1fr; }
191
- }
192
-
193
- /* ── Loading state ────────────────────────────────────────────── */
194
- .loader {
195
- display: flex; align-items: center; justify-content: center;
196
- height: calc(100vh - 130px);
197
- color: var(--fg-muted);
198
- font-size: 14px;
199
- gap: 10px;
200
- }
201
- .loader .spinner {
202
- width: 18px; height: 18px;
203
- border: 2px solid var(--border);
204
- border-top-color: var(--primary);
205
- border-radius: 50%;
206
- animation: spin 0.8s linear infinite;
207
- }
208
- @keyframes spin { to { transform: rotate(360deg); } }
209
- </style>
210
- </head>
211
- <body>
212
-
213
- <header class="topbar">
214
- <a href="/" class="topbar-brand">
215
- <img src="/logo.svg" alt="Pixcode" />
216
- <span data-i18n="title">Pixcode API</span>
217
- <span class="badge" data-i18n="badge">v1.36</span>
218
- </a>
219
- <div class="topbar-spacer"></div>
220
- <div class="topbar-actions">
221
- <select id="lang-select" aria-label="Language" title="Language">
222
- <option value="en">English</option>
223
- <option value="tr">Türkçe</option>
224
- <option value="de">Deutsch</option>
225
- <option value="it">Italiano</option>
226
- <option value="ja">日本語</option>
227
- <option value="ko">한국어</option>
228
- <option value="ru">Русский</option>
229
- <option value="zh-CN">中文</option>
230
- </select>
231
- <a href="/openapi.yaml" class="btn" download>
232
- <span class="icon" aria-hidden="true">⬇</span><span data-i18n="downloadSpec">Download spec</span>
233
- </a>
234
- <a href="/" class="btn primary">
235
- <span class="icon" aria-hidden="true">←</span><span data-i18n="backToApp">Back to app</span>
236
- </a>
237
- </div>
238
- </header>
239
-
240
- <div class="apikey-bar">
241
- <label for="api-key-input" data-i18n="apiKey.label">API key</label>
242
- <input
243
- id="api-key-input"
244
- type="password"
245
- placeholder="ck_..."
246
- autocomplete="off"
247
- spellcheck="false"
248
- />
249
- <span id="api-key-status" class="status" data-i18n="apiKey.notSet">Not set</span>
250
- <span class="hint" data-i18n="apiKey.hint">Generate one under Settings → API. Stored locally only.</span>
251
- </div>
252
-
253
- <section class="quick-guide" aria-labelledby="quick-guide-title">
254
- <div>
255
- <h2 id="quick-guide-title" data-i18n="guide.title">Orchestration API quick start</h2>
256
- <p data-i18n="guide.body">
257
- Use role-based metadata to preview, run, stream, and cancel multi-agent work modes. Instructions and model ids are optional; omit model to use CLI settings.
258
- </p>
259
- <div class="guide-grid" aria-label="Orchestration endpoints">
260
- <div class="guide-card">
261
- <strong data-i18n="guide.preview">Preview DAG</strong>
262
- <code>POST /api/orchestration/workflows/{id}/preview</code>
263
- </div>
264
- <div class="guide-card">
265
- <strong data-i18n="guide.run">Start run</strong>
266
- <code>POST /api/orchestration/workflows/{id}/runs</code>
267
- </div>
268
- <div class="guide-card">
269
- <strong data-i18n="guide.stream">Stream run</strong>
270
- <code>GET /api/orchestration/workflows/runs/{runId}/events</code>
271
- </div>
272
- <div class="guide-card">
273
- <strong data-i18n="guide.context">Execution context</strong>
274
- <code>GET /api/orchestration/workflows/context</code>
275
- </div>
276
- </div>
277
- </div>
278
- <pre class="curl-box"><code data-i18n="guide.curl">curl -H "Authorization: Bearer px_..." \
279
- -H "content-type: application/json" \
280
- -d '{"metadata":{"agents":[{"adapterId":"codex","role":"frontend"},{"adapterId":"codex","role":"backend"},{"adapterId":"codex","role":"review"}]}}' \
281
- /api/orchestration/workflows/agent_team/preview</code></pre>
282
- </section>
283
-
284
- <div id="scalar-host">
285
- <div class="loader">
286
- <div class="spinner"></div>
287
- <span data-i18n="loading">Loading API reference…</span>
288
- </div>
289
- </div>
290
-
291
- <script>
292
- // ── i18n: UI chrome only (the OpenAPI spec itself stays in English) ──
293
- // OpenAPI specs are conventionally English (industry standard). The UI
294
- // labels above DO change with the language picker — endpoint descriptions
295
- // do not. Future work: x-translations extension on each operation.
296
- const I18N = {
297
- en: {
298
- title: 'Pixcode API',
299
- badge: 'v1.36',
300
- downloadSpec: 'Download spec',
301
- backToApp: 'Back to app',
302
- 'apiKey.label': 'API key',
303
- 'apiKey.notSet': 'Not set',
304
- 'apiKey.set': 'Saved',
305
- 'apiKey.hint': 'Generate one under Settings → API. Stored locally only.',
306
- 'guide.title': 'Orchestration API quick start',
307
- 'guide.body': 'Use role-based metadata to preview, run, stream, and cancel multi-agent work modes. Instructions and model ids are optional; omit model to use CLI settings.',
308
- 'guide.preview': 'Preview DAG',
309
- 'guide.run': 'Start run',
310
- 'guide.stream': 'Stream run',
311
- 'guide.context': 'Execution context',
312
- 'guide.curl': 'curl -H "Authorization: Bearer px_..." \\\n -H "content-type: application/json" \\\n -d \'{"metadata":{"agents":[{"adapterId":"codex","role":"frontend"},{"adapterId":"codex","role":"backend"},{"adapterId":"codex","role":"review"}]}}\' \\\n /api/orchestration/workflows/agent_team/preview',
313
- loading: 'Loading API reference…',
314
- },
315
- tr: {
316
- title: 'Pixcode API',
317
- badge: 'v1.36',
318
- downloadSpec: 'Spec\'i indir',
319
- backToApp: 'Uygulamaya dön',
320
- 'apiKey.label': 'API anahtarı',
321
- 'apiKey.notSet': 'Boş',
322
- 'apiKey.set': 'Kaydedildi',
323
- 'apiKey.hint': 'Ayarlar → API\'den oluşturun. Sadece bu cihazda saklanır.',
324
- 'guide.title': 'Orkestrasyon API hızlı başlangıç',
325
- 'guide.body': 'Çok ajanlı çalışma modlarını rol tabanlı metadata ile önizleyin, başlatın, izleyin ve iptal edin. Instruction ve model id opsiyoneldir; model verilmezse CLI ayarları kullanılır.',
326
- 'guide.preview': 'DAG önizle',
327
- 'guide.run': 'Run başlat',
328
- 'guide.stream': 'Run izle',
329
- 'guide.context': 'Çalışma bağlamı',
330
- 'guide.curl': 'curl -H "Authorization: Bearer px_..." \\\n -H "content-type: application/json" \\\n -d \'{"metadata":{"agents":[{"adapterId":"codex","role":"frontend"},{"adapterId":"codex","role":"backend"},{"adapterId":"codex","role":"review"}]}}\' \\\n /api/orchestration/workflows/agent_team/preview',
331
- loading: 'API referansı yükleniyor…',
332
- },
333
- de: {
334
- title: 'Pixcode API',
335
- badge: 'v1.36',
336
- downloadSpec: 'Spezifikation laden',
337
- backToApp: 'Zurück zur App',
338
- 'apiKey.label': 'API-Schlüssel',
339
- 'apiKey.notSet': 'Nicht gesetzt',
340
- 'apiKey.set': 'Gespeichert',
341
- 'apiKey.hint': 'Unter Einstellungen → API erstellen. Nur lokal gespeichert.',
342
- 'guide.title': 'Orchestrierungs-API Schnellstart',
343
- 'guide.body': 'Verwenden Sie rollenbasierte Metadaten, um Multi-Agent-Arbeitsmodi vorzuschauen, zu starten, zu streamen und abzubrechen. Instructions und Model-IDs sind optional; ohne Model werden CLI-Einstellungen genutzt.',
344
- 'guide.preview': 'DAG-Vorschau',
345
- 'guide.run': 'Run starten',
346
- 'guide.stream': 'Run streamen',
347
- 'guide.context': 'Ausführungskontext',
348
- 'guide.curl': 'curl -H "Authorization: Bearer px_..." \\\n -H "content-type: application/json" \\\n -d \'{"metadata":{"agents":[{"adapterId":"codex","role":"frontend"},{"adapterId":"codex","role":"backend"},{"adapterId":"codex","role":"review"}]}}\' \\\n /api/orchestration/workflows/agent_team/preview',
349
- loading: 'API-Referenz wird geladen…',
350
- },
351
- it: {
352
- title: 'Pixcode API',
353
- badge: 'v1.36',
354
- downloadSpec: 'Scarica specifica',
355
- backToApp: "Torna all'app",
356
- 'apiKey.label': 'Chiave API',
357
- 'apiKey.notSet': 'Non impostata',
358
- 'apiKey.set': 'Salvata',
359
- 'apiKey.hint': 'Generala in Impostazioni → API. Memorizzata solo localmente.',
360
- 'guide.title': 'Avvio rapido API di orchestrazione',
361
- 'guide.body': 'Usa metadata basati sui ruoli per visualizzare, avviare, seguire e annullare modalità multi-agente. Instruction e model id sono opzionali; senza model si usano le impostazioni CLI.',
362
- 'guide.preview': 'Anteprima DAG',
363
- 'guide.run': 'Avvia run',
364
- 'guide.stream': 'Stream run',
365
- 'guide.context': 'Contesto di esecuzione',
366
- 'guide.curl': 'curl -H "Authorization: Bearer px_..." \\\n -H "content-type: application/json" \\\n -d \'{"metadata":{"agents":[{"adapterId":"codex","role":"frontend"},{"adapterId":"codex","role":"backend"},{"adapterId":"codex","role":"review"}]}}\' \\\n /api/orchestration/workflows/agent_team/preview',
367
- loading: 'Caricamento riferimento API…',
368
- },
369
- ja: {
370
- title: 'Pixcode API',
371
- badge: 'v1.36',
372
- downloadSpec: '仕様をダウンロード',
373
- backToApp: 'アプリに戻る',
374
- 'apiKey.label': 'API キー',
375
- 'apiKey.notSet': '未設定',
376
- 'apiKey.set': '保存済み',
377
- 'apiKey.hint': '設定 → API で生成してください。このデバイスのみに保存されます。',
378
- 'guide.title': 'オーケストレーション API クイックスタート',
379
- 'guide.body': 'ロールベースのメタデータでマルチエージェントの実行モードをプレビュー、開始、ストリーム、キャンセルできます。instruction と model id は任意で、model を省略すると CLI 設定を使います。',
380
- 'guide.preview': 'DAG をプレビュー',
381
- 'guide.run': 'Run を開始',
382
- 'guide.stream': 'Run をストリーム',
383
- 'guide.context': '実行コンテキスト',
384
- 'guide.curl': 'curl -H "Authorization: Bearer px_..." \\\n -H "content-type: application/json" \\\n -d \'{"metadata":{"agents":[{"adapterId":"codex","role":"frontend"},{"adapterId":"codex","role":"backend"},{"adapterId":"codex","role":"review"}]}}\' \\\n /api/orchestration/workflows/agent_team/preview',
385
- loading: 'API リファレンスを読み込み中…',
386
- },
387
- ko: {
388
- title: 'Pixcode API',
389
- badge: 'v1.36',
390
- downloadSpec: '스펙 다운로드',
391
- backToApp: '앱으로 돌아가기',
392
- 'apiKey.label': 'API 키',
393
- 'apiKey.notSet': '미설정',
394
- 'apiKey.set': '저장됨',
395
- 'apiKey.hint': '설정 → API에서 생성하세요. 이 기기에만 저장됩니다.',
396
- 'guide.title': '오케스트레이션 API 빠른 시작',
397
- 'guide.body': '역할 기반 metadata로 멀티 에이전트 작업 모드를 미리보기, 시작, 스트리밍, 취소할 수 있습니다. instruction과 model id는 선택 사항이며, model을 생략하면 CLI 설정을 사용합니다.',
398
- 'guide.preview': 'DAG 미리보기',
399
- 'guide.run': 'Run 시작',
400
- 'guide.stream': 'Run 스트림',
401
- 'guide.context': '실행 컨텍스트',
402
- 'guide.curl': 'curl -H "Authorization: Bearer px_..." \\\n -H "content-type: application/json" \\\n -d \'{"metadata":{"agents":[{"adapterId":"codex","role":"frontend"},{"adapterId":"codex","role":"backend"},{"adapterId":"codex","role":"review"}]}}\' \\\n /api/orchestration/workflows/agent_team/preview',
403
- loading: 'API 참조 로드 중…',
404
- },
405
- ru: {
406
- title: 'Pixcode API',
407
- badge: 'v1.36',
408
- downloadSpec: 'Скачать спецификацию',
409
- backToApp: 'Вернуться в приложение',
410
- 'apiKey.label': 'API-ключ',
411
- 'apiKey.notSet': 'Не задан',
412
- 'apiKey.set': 'Сохранён',
413
- 'apiKey.hint': 'Создайте в Настройки → API. Хранится только локально.',
414
- 'guide.title': 'Быстрый старт API оркестрации',
415
- 'guide.body': 'Используйте role-based metadata, чтобы предварительно просматривать, запускать, стримить и отменять multi-agent work modes. instruction и model id необязательны; без model используются настройки CLI.',
416
- 'guide.preview': 'Просмотр DAG',
417
- 'guide.run': 'Запустить run',
418
- 'guide.stream': 'Стрим run',
419
- 'guide.context': 'Контекст выполнения',
420
- 'guide.curl': 'curl -H "Authorization: Bearer px_..." \\\n -H "content-type: application/json" \\\n -d \'{"metadata":{"agents":[{"adapterId":"codex","role":"frontend"},{"adapterId":"codex","role":"backend"},{"adapterId":"codex","role":"review"}]}}\' \\\n /api/orchestration/workflows/agent_team/preview',
421
- loading: 'Загрузка справочника API…',
422
- },
423
- 'zh-CN': {
424
- title: 'Pixcode API',
425
- badge: 'v1.36',
426
- downloadSpec: '下载规范',
427
- backToApp: '返回应用',
428
- 'apiKey.label': 'API 密钥',
429
- 'apiKey.notSet': '未设置',
430
- 'apiKey.set': '已保存',
431
- 'apiKey.hint': '在 设置 → API 生成。仅本地存储。',
432
- 'guide.title': '编排 API 快速开始',
433
- 'guide.body': '使用基于角色的 metadata 预览、启动、流式跟踪和取消多代理工作模式。instruction 和 model id 都是可选字段；省略 model 时使用 CLI 设置。',
434
- 'guide.preview': '预览 DAG',
435
- 'guide.run': '启动 run',
436
- 'guide.stream': '流式 run',
437
- 'guide.context': '执行上下文',
438
- 'guide.curl': 'curl -H "Authorization: Bearer px_..." \\\n -H "content-type: application/json" \\\n -d \'{"metadata":{"agents":[{"adapterId":"codex","role":"frontend"},{"adapterId":"codex","role":"backend"},{"adapterId":"codex","role":"review"}]}}\' \\\n /api/orchestration/workflows/agent_team/preview',
439
- loading: '正在加载 API 参考…',
440
- },
441
- };
442
-
443
- function detectLang() {
444
- const stored = localStorage.getItem('pixcode-api-docs-lang');
445
- if (stored && I18N[stored]) return stored;
446
- const navLang = (navigator.language || 'en').toLowerCase();
447
- if (navLang.startsWith('zh')) return 'zh-CN';
448
- const short = navLang.split('-')[0];
449
- return I18N[short] ? short : 'en';
450
- }
451
-
452
- function applyI18n(lang) {
453
- const dict = I18N[lang] || I18N.en;
454
- document.documentElement.lang = lang;
455
- document.querySelectorAll('[data-i18n]').forEach((el) => {
456
- const key = el.getAttribute('data-i18n');
457
- if (dict[key]) el.textContent = dict[key];
458
- });
459
- }
460
-
461
- // ── API key persistence + Scalar prefill ──────────────────────────
462
- const apiKeyInput = document.getElementById('api-key-input');
463
- const apiKeyStatus = document.getElementById('api-key-status');
464
- const STORAGE_KEY = 'pixcode-api-docs-key';
465
-
466
- function setStatus(set) {
467
- const lang = document.documentElement.lang || 'en';
468
- const dict = I18N[lang] || I18N.en;
469
- apiKeyStatus.textContent = set ? dict['apiKey.set'] : dict['apiKey.notSet'];
470
- apiKeyStatus.classList.toggle('ok', set);
471
- }
472
-
473
- // Restore on load.
474
- const savedKey = localStorage.getItem(STORAGE_KEY) || '';
475
- if (savedKey) {
476
- apiKeyInput.value = savedKey;
477
- setStatus(true);
478
- } else {
479
- setStatus(false);
480
- }
481
-
482
- apiKeyInput.addEventListener('input', () => {
483
- const v = apiKeyInput.value.trim();
484
- if (v) {
485
- localStorage.setItem(STORAGE_KEY, v);
486
- setStatus(true);
487
- } else {
488
- localStorage.removeItem(STORAGE_KEY);
489
- setStatus(false);
490
- }
491
- // Re-render Scalar so the new key is prefilled in "Try it" panels.
492
- renderScalar();
493
- });
494
-
495
- // ── Language picker ───────────────────────────────────────────────
496
- const langSelect = document.getElementById('lang-select');
497
- langSelect.value = detectLang();
498
- applyI18n(langSelect.value);
499
- langSelect.addEventListener('change', () => {
500
- localStorage.setItem('pixcode-api-docs-lang', langSelect.value);
501
- applyI18n(langSelect.value);
502
- setStatus(Boolean(localStorage.getItem(STORAGE_KEY)));
503
- });
504
-
505
- // ── Scalar mount ──────────────────────────────────────────────────
506
- // Scalar API Reference: lightweight, modern, mobile-friendly, built-in
507
- // try-it panel with auth header support. Loaded from CDN as a single
508
- // global; no build step required.
509
- function getCurrentApiKey() {
510
- return apiKeyInput.value.trim();
511
- }
512
-
513
- function renderScalar() {
514
- if (!window.Scalar || typeof window.Scalar.createApiReference !== 'function') return;
515
- const host = document.getElementById('scalar-host');
516
- host.innerHTML = '';
517
- window.Scalar.createApiReference(host, {
518
- url: '/openapi.yaml',
519
- theme: 'default',
520
- darkMode: window.matchMedia('(prefers-color-scheme: dark)').matches,
521
- hideClientButton: true,
522
- hideDarkModeToggle: false,
523
- authentication: getCurrentApiKey()
524
- ? {
525
- preferredSecurityScheme: 'bearerAuth',
526
- http: { bearer: { token: getCurrentApiKey() } },
527
- }
528
- : undefined,
529
- defaultHttpClient: { targetKey: 'shell', clientKey: 'curl' },
530
- // Pixcode's app shell uses absolute /api paths against the same host;
531
- // Scalar's "Try it" sends to the OpenAPI `servers[0]`. We override to
532
- // the document origin so the user doesn't need to pick a server.
533
- servers: [{ url: window.location.origin }],
534
- });
535
- }
536
-
537
- const scalarScript = document.createElement('script');
538
- scalarScript.src = 'https://cdn.jsdelivr.net/npm/@scalar/api-reference@1';
539
- scalarScript.onload = renderScalar;
540
- scalarScript.onerror = () => {
541
- document.getElementById('scalar-host').innerHTML =
542
- '<div class="loader"><span>⚠ Scalar CDN unreachable. <a href="/openapi.yaml" style="color:var(--primary)">Download the OpenAPI spec</a> and load it in your own viewer.</span></div>';
543
- };
544
- document.head.appendChild(scalarScript);
545
- </script>
546
-
547
- </body>
548
- </html>
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8" />
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0, viewport-fit=cover" />
6
+ <title>Pixcode — API Documentation</title>
7
+ <meta name="description" content="REST API reference for Pixcode — the multi-CLI web UI for Claude Code, Cursor, Codex, Gemini, Qwen, and OpenCode." />
8
+ <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
9
+ <link rel="icon" type="image/png" href="/favicon.png" />
10
+ <style>
11
+ :root {
12
+ --bg: #0b0d10;
13
+ --bg-soft: #11151b;
14
+ --bg-card: #161b22;
15
+ --border: #232a33;
16
+ --fg: #e6edf3;
17
+ --fg-muted: #8b949e;
18
+ --primary: #2563eb;
19
+ --primary-hover: #1d4ed8;
20
+ --accent: #10b981;
21
+ --warn: #f59e0b;
22
+ --code-bg: #05080d;
23
+ }
24
+ @media (prefers-color-scheme: light) {
25
+ :root {
26
+ --bg: #ffffff;
27
+ --bg-soft: #f6f8fa;
28
+ --bg-card: #ffffff;
29
+ --border: #d0d7de;
30
+ --fg: #1f2328;
31
+ --fg-muted: #656d76;
32
+ --code-bg: #f6f8fa;
33
+ }
34
+ }
35
+
36
+ * { box-sizing: border-box; }
37
+ html, body { margin: 0; padding: 0; }
38
+ body {
39
+ background: var(--bg);
40
+ color: var(--fg);
41
+ font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Inter, sans-serif;
42
+ min-height: 100vh;
43
+ }
44
+
45
+ /* ── Top bar ─────────────────────────────────────────────────── */
46
+ .topbar {
47
+ position: sticky; top: 0; z-index: 50;
48
+ display: flex; align-items: center; gap: 12px;
49
+ padding: 10px 16px;
50
+ background: var(--bg-soft);
51
+ border-bottom: 1px solid var(--border);
52
+ backdrop-filter: blur(8px);
53
+ }
54
+ .topbar-brand {
55
+ display: flex; align-items: center; gap: 10px;
56
+ font-weight: 700; font-size: 15px; letter-spacing: -0.01em;
57
+ color: var(--fg); text-decoration: none;
58
+ }
59
+ .topbar-brand img { width: 24px; height: 24px; border-radius: 6px; }
60
+ .topbar-brand .badge {
61
+ font-size: 10px; font-weight: 600;
62
+ padding: 2px 6px; border-radius: 4px;
63
+ background: var(--primary); color: white;
64
+ letter-spacing: 0.04em; text-transform: uppercase;
65
+ }
66
+ .topbar-spacer { flex: 1; }
67
+ .topbar-actions { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; }
68
+ .topbar select, .topbar a.btn, .topbar button.btn {
69
+ height: 32px;
70
+ padding: 0 12px;
71
+ border-radius: 6px;
72
+ border: 1px solid var(--border);
73
+ background: var(--bg-card);
74
+ color: var(--fg);
75
+ font-size: 13px;
76
+ cursor: pointer;
77
+ text-decoration: none;
78
+ display: inline-flex; align-items: center; gap: 6px;
79
+ }
80
+ .topbar a.btn:hover, .topbar button.btn:hover { border-color: var(--primary); }
81
+ .topbar a.btn.primary, .topbar button.btn.primary {
82
+ background: var(--primary); border-color: var(--primary); color: white;
83
+ }
84
+ .topbar a.btn.primary:hover { background: var(--primary-hover); border-color: var(--primary-hover); }
85
+
86
+ /* ── API key bar ──────────────────────────────────────────────── */
87
+ .apikey-bar {
88
+ display: flex; align-items: center; gap: 10px;
89
+ padding: 10px 16px;
90
+ background: var(--bg-card);
91
+ border-bottom: 1px solid var(--border);
92
+ flex-wrap: wrap;
93
+ }
94
+ .apikey-bar label {
95
+ font-size: 12px; font-weight: 600; color: var(--fg-muted);
96
+ letter-spacing: 0.02em; text-transform: uppercase;
97
+ }
98
+ .apikey-bar input {
99
+ flex: 1; min-width: 220px;
100
+ height: 34px; padding: 0 12px;
101
+ background: var(--bg-soft);
102
+ border: 1px solid var(--border);
103
+ border-radius: 6px;
104
+ color: var(--fg);
105
+ font-family: 'SF Mono', ui-monospace, monospace;
106
+ font-size: 13px;
107
+ }
108
+ .apikey-bar input:focus { outline: none; border-color: var(--primary); }
109
+ .apikey-bar .hint { font-size: 12px; color: var(--fg-muted); }
110
+ .apikey-bar .status {
111
+ font-size: 11px; padding: 3px 8px; border-radius: 999px;
112
+ background: var(--bg-soft); color: var(--fg-muted);
113
+ border: 1px solid var(--border);
114
+ }
115
+ .apikey-bar .status.ok { color: var(--accent); border-color: var(--accent); }
116
+
117
+ /* ── Quick guide ──────────────────────────────────────────────── */
118
+ .quick-guide {
119
+ display: grid;
120
+ grid-template-columns: minmax(0, 1fr) minmax(260px, 420px);
121
+ gap: 14px;
122
+ padding: 14px 16px;
123
+ background:
124
+ radial-gradient(circle at top left, color-mix(in srgb, var(--primary) 16%, transparent), transparent 38%),
125
+ var(--bg-soft);
126
+ border-bottom: 1px solid var(--border);
127
+ }
128
+ .quick-guide h2 {
129
+ margin: 0 0 6px;
130
+ font-size: 15px;
131
+ letter-spacing: -0.01em;
132
+ }
133
+ .quick-guide p {
134
+ margin: 0;
135
+ color: var(--fg-muted);
136
+ font-size: 13px;
137
+ line-height: 1.55;
138
+ }
139
+ .guide-grid {
140
+ display: grid;
141
+ grid-template-columns: repeat(3, minmax(0, 1fr));
142
+ gap: 8px;
143
+ margin-top: 10px;
144
+ }
145
+ .guide-card {
146
+ border: 1px solid var(--border);
147
+ border-radius: 10px;
148
+ background: color-mix(in srgb, var(--bg-card) 86%, transparent);
149
+ padding: 10px;
150
+ min-width: 0;
151
+ }
152
+ .guide-card strong {
153
+ display: block;
154
+ font-size: 12px;
155
+ margin-bottom: 5px;
156
+ }
157
+ .guide-card code {
158
+ display: block;
159
+ overflow: hidden;
160
+ text-overflow: ellipsis;
161
+ white-space: nowrap;
162
+ color: var(--accent);
163
+ font-family: 'SF Mono', ui-monospace, monospace;
164
+ font-size: 11px;
165
+ }
166
+ .curl-box {
167
+ margin: 0;
168
+ overflow: auto;
169
+ border: 1px solid var(--border);
170
+ border-radius: 10px;
171
+ background: var(--code-bg);
172
+ color: var(--fg);
173
+ padding: 12px;
174
+ font-family: 'SF Mono', ui-monospace, monospace;
175
+ font-size: 11px;
176
+ line-height: 1.5;
177
+ }
178
+
179
+ /* ── Scalar host ──────────────────────────────────────────────── */
180
+ #scalar-host { min-height: calc(100vh - 130px); }
181
+
182
+ /* ── Mobile tweaks ────────────────────────────────────────────── */
183
+ @media (max-width: 640px) {
184
+ .topbar { padding: 8px 10px; gap: 8px; }
185
+ .topbar-brand .subtitle { display: none; }
186
+ .topbar-actions a.btn span:not(.icon) { display: none; }
187
+ .apikey-bar { padding: 8px 10px; }
188
+ .apikey-bar .hint { display: none; }
189
+ .quick-guide { grid-template-columns: 1fr; padding: 12px 10px; }
190
+ .guide-grid { grid-template-columns: 1fr; }
191
+ }
192
+
193
+ /* ── Loading state ────────────────────────────────────────────── */
194
+ .loader {
195
+ display: flex; align-items: center; justify-content: center;
196
+ height: calc(100vh - 130px);
197
+ color: var(--fg-muted);
198
+ font-size: 14px;
199
+ gap: 10px;
200
+ }
201
+ .loader .spinner {
202
+ width: 18px; height: 18px;
203
+ border: 2px solid var(--border);
204
+ border-top-color: var(--primary);
205
+ border-radius: 50%;
206
+ animation: spin 0.8s linear infinite;
207
+ }
208
+ @keyframes spin { to { transform: rotate(360deg); } }
209
+ </style>
210
+ </head>
211
+ <body>
212
+
213
+ <header class="topbar">
214
+ <a href="/" class="topbar-brand">
215
+ <img src="/logo.svg" alt="Pixcode" />
216
+ <span data-i18n="title">Pixcode API</span>
217
+ <span class="badge" data-i18n="badge">v1.36</span>
218
+ </a>
219
+ <div class="topbar-spacer"></div>
220
+ <div class="topbar-actions">
221
+ <select id="lang-select" aria-label="Language" title="Language">
222
+ <option value="en">English</option>
223
+ <option value="tr">Türkçe</option>
224
+ <option value="de">Deutsch</option>
225
+ <option value="it">Italiano</option>
226
+ <option value="ja">日本語</option>
227
+ <option value="ko">한국어</option>
228
+ <option value="ru">Русский</option>
229
+ <option value="zh-CN">中文</option>
230
+ </select>
231
+ <a href="/openapi.yaml" class="btn" download>
232
+ <span class="icon" aria-hidden="true">⬇</span><span data-i18n="downloadSpec">Download spec</span>
233
+ </a>
234
+ <a href="/" class="btn primary">
235
+ <span class="icon" aria-hidden="true">←</span><span data-i18n="backToApp">Back to app</span>
236
+ </a>
237
+ </div>
238
+ </header>
239
+
240
+ <div class="apikey-bar">
241
+ <label for="api-key-input" data-i18n="apiKey.label">API key</label>
242
+ <input
243
+ id="api-key-input"
244
+ type="password"
245
+ placeholder="ck_..."
246
+ autocomplete="off"
247
+ spellcheck="false"
248
+ />
249
+ <span id="api-key-status" class="status" data-i18n="apiKey.notSet">Not set</span>
250
+ <span class="hint" data-i18n="apiKey.hint">Generate one under Settings → API. Stored locally only.</span>
251
+ </div>
252
+
253
+ <section class="quick-guide" aria-labelledby="quick-guide-title">
254
+ <div>
255
+ <h2 id="quick-guide-title" data-i18n="guide.title">Orchestration API quick start</h2>
256
+ <p data-i18n="guide.body">
257
+ Use role-based metadata to preview, run, stream, and cancel multi-agent work modes. Instructions and model ids are optional; omit model to use CLI settings.
258
+ </p>
259
+ <div class="guide-grid" aria-label="Orchestration endpoints">
260
+ <div class="guide-card">
261
+ <strong data-i18n="guide.preview">Preview DAG</strong>
262
+ <code>POST /api/orchestration/workflows/{id}/preview</code>
263
+ </div>
264
+ <div class="guide-card">
265
+ <strong data-i18n="guide.run">Start run</strong>
266
+ <code>POST /api/orchestration/workflows/{id}/runs</code>
267
+ </div>
268
+ <div class="guide-card">
269
+ <strong data-i18n="guide.stream">Stream run</strong>
270
+ <code>GET /api/orchestration/workflows/runs/{runId}/events</code>
271
+ </div>
272
+ <div class="guide-card">
273
+ <strong data-i18n="guide.context">Execution context</strong>
274
+ <code>GET /api/orchestration/workflows/context</code>
275
+ </div>
276
+ </div>
277
+ </div>
278
+ <pre class="curl-box"><code data-i18n="guide.curl">curl -H "Authorization: Bearer px_..." \
279
+ -H "content-type: application/json" \
280
+ -d '{"metadata":{"agents":[{"adapterId":"codex","role":"frontend"},{"adapterId":"codex","role":"backend"},{"adapterId":"codex","role":"review"}]}}' \
281
+ /api/orchestration/workflows/agent_team/preview</code></pre>
282
+ </section>
283
+
284
+ <div id="scalar-host">
285
+ <div class="loader">
286
+ <div class="spinner"></div>
287
+ <span data-i18n="loading">Loading API reference…</span>
288
+ </div>
289
+ </div>
290
+
291
+ <script>
292
+ // ── i18n: UI chrome only (the OpenAPI spec itself stays in English) ──
293
+ // OpenAPI specs are conventionally English (industry standard). The UI
294
+ // labels above DO change with the language picker — endpoint descriptions
295
+ // do not. Future work: x-translations extension on each operation.
296
+ const I18N = {
297
+ en: {
298
+ title: 'Pixcode API',
299
+ badge: 'v1.36',
300
+ downloadSpec: 'Download spec',
301
+ backToApp: 'Back to app',
302
+ 'apiKey.label': 'API key',
303
+ 'apiKey.notSet': 'Not set',
304
+ 'apiKey.set': 'Saved',
305
+ 'apiKey.hint': 'Generate one under Settings → API. Stored locally only.',
306
+ 'guide.title': 'Orchestration API quick start',
307
+ 'guide.body': 'Use role-based metadata to preview, run, stream, and cancel multi-agent work modes. Instructions and model ids are optional; omit model to use CLI settings.',
308
+ 'guide.preview': 'Preview DAG',
309
+ 'guide.run': 'Start run',
310
+ 'guide.stream': 'Stream run',
311
+ 'guide.context': 'Execution context',
312
+ 'guide.curl': 'curl -H "Authorization: Bearer px_..." \\\n -H "content-type: application/json" \\\n -d \'{"metadata":{"agents":[{"adapterId":"codex","role":"frontend"},{"adapterId":"codex","role":"backend"},{"adapterId":"codex","role":"review"}]}}\' \\\n /api/orchestration/workflows/agent_team/preview',
313
+ loading: 'Loading API reference…',
314
+ },
315
+ tr: {
316
+ title: 'Pixcode API',
317
+ badge: 'v1.36',
318
+ downloadSpec: 'Spec\'i indir',
319
+ backToApp: 'Uygulamaya dön',
320
+ 'apiKey.label': 'API anahtarı',
321
+ 'apiKey.notSet': 'Boş',
322
+ 'apiKey.set': 'Kaydedildi',
323
+ 'apiKey.hint': 'Ayarlar → API\'den oluşturun. Sadece bu cihazda saklanır.',
324
+ 'guide.title': 'Orkestrasyon API hızlı başlangıç',
325
+ 'guide.body': 'Çok ajanlı çalışma modlarını rol tabanlı metadata ile önizleyin, başlatın, izleyin ve iptal edin. Instruction ve model id opsiyoneldir; model verilmezse CLI ayarları kullanılır.',
326
+ 'guide.preview': 'DAG önizle',
327
+ 'guide.run': 'Run başlat',
328
+ 'guide.stream': 'Run izle',
329
+ 'guide.context': 'Çalışma bağlamı',
330
+ 'guide.curl': 'curl -H "Authorization: Bearer px_..." \\\n -H "content-type: application/json" \\\n -d \'{"metadata":{"agents":[{"adapterId":"codex","role":"frontend"},{"adapterId":"codex","role":"backend"},{"adapterId":"codex","role":"review"}]}}\' \\\n /api/orchestration/workflows/agent_team/preview',
331
+ loading: 'API referansı yükleniyor…',
332
+ },
333
+ de: {
334
+ title: 'Pixcode API',
335
+ badge: 'v1.36',
336
+ downloadSpec: 'Spezifikation laden',
337
+ backToApp: 'Zurück zur App',
338
+ 'apiKey.label': 'API-Schlüssel',
339
+ 'apiKey.notSet': 'Nicht gesetzt',
340
+ 'apiKey.set': 'Gespeichert',
341
+ 'apiKey.hint': 'Unter Einstellungen → API erstellen. Nur lokal gespeichert.',
342
+ 'guide.title': 'Orchestrierungs-API Schnellstart',
343
+ 'guide.body': 'Verwenden Sie rollenbasierte Metadaten, um Multi-Agent-Arbeitsmodi vorzuschauen, zu starten, zu streamen und abzubrechen. Instructions und Model-IDs sind optional; ohne Model werden CLI-Einstellungen genutzt.',
344
+ 'guide.preview': 'DAG-Vorschau',
345
+ 'guide.run': 'Run starten',
346
+ 'guide.stream': 'Run streamen',
347
+ 'guide.context': 'Ausführungskontext',
348
+ 'guide.curl': 'curl -H "Authorization: Bearer px_..." \\\n -H "content-type: application/json" \\\n -d \'{"metadata":{"agents":[{"adapterId":"codex","role":"frontend"},{"adapterId":"codex","role":"backend"},{"adapterId":"codex","role":"review"}]}}\' \\\n /api/orchestration/workflows/agent_team/preview',
349
+ loading: 'API-Referenz wird geladen…',
350
+ },
351
+ it: {
352
+ title: 'Pixcode API',
353
+ badge: 'v1.36',
354
+ downloadSpec: 'Scarica specifica',
355
+ backToApp: "Torna all'app",
356
+ 'apiKey.label': 'Chiave API',
357
+ 'apiKey.notSet': 'Non impostata',
358
+ 'apiKey.set': 'Salvata',
359
+ 'apiKey.hint': 'Generala in Impostazioni → API. Memorizzata solo localmente.',
360
+ 'guide.title': 'Avvio rapido API di orchestrazione',
361
+ 'guide.body': 'Usa metadata basati sui ruoli per visualizzare, avviare, seguire e annullare modalità multi-agente. Instruction e model id sono opzionali; senza model si usano le impostazioni CLI.',
362
+ 'guide.preview': 'Anteprima DAG',
363
+ 'guide.run': 'Avvia run',
364
+ 'guide.stream': 'Stream run',
365
+ 'guide.context': 'Contesto di esecuzione',
366
+ 'guide.curl': 'curl -H "Authorization: Bearer px_..." \\\n -H "content-type: application/json" \\\n -d \'{"metadata":{"agents":[{"adapterId":"codex","role":"frontend"},{"adapterId":"codex","role":"backend"},{"adapterId":"codex","role":"review"}]}}\' \\\n /api/orchestration/workflows/agent_team/preview',
367
+ loading: 'Caricamento riferimento API…',
368
+ },
369
+ ja: {
370
+ title: 'Pixcode API',
371
+ badge: 'v1.36',
372
+ downloadSpec: '仕様をダウンロード',
373
+ backToApp: 'アプリに戻る',
374
+ 'apiKey.label': 'API キー',
375
+ 'apiKey.notSet': '未設定',
376
+ 'apiKey.set': '保存済み',
377
+ 'apiKey.hint': '設定 → API で生成してください。このデバイスのみに保存されます。',
378
+ 'guide.title': 'オーケストレーション API クイックスタート',
379
+ 'guide.body': 'ロールベースのメタデータでマルチエージェントの実行モードをプレビュー、開始、ストリーム、キャンセルできます。instruction と model id は任意で、model を省略すると CLI 設定を使います。',
380
+ 'guide.preview': 'DAG をプレビュー',
381
+ 'guide.run': 'Run を開始',
382
+ 'guide.stream': 'Run をストリーム',
383
+ 'guide.context': '実行コンテキスト',
384
+ 'guide.curl': 'curl -H "Authorization: Bearer px_..." \\\n -H "content-type: application/json" \\\n -d \'{"metadata":{"agents":[{"adapterId":"codex","role":"frontend"},{"adapterId":"codex","role":"backend"},{"adapterId":"codex","role":"review"}]}}\' \\\n /api/orchestration/workflows/agent_team/preview',
385
+ loading: 'API リファレンスを読み込み中…',
386
+ },
387
+ ko: {
388
+ title: 'Pixcode API',
389
+ badge: 'v1.36',
390
+ downloadSpec: '스펙 다운로드',
391
+ backToApp: '앱으로 돌아가기',
392
+ 'apiKey.label': 'API 키',
393
+ 'apiKey.notSet': '미설정',
394
+ 'apiKey.set': '저장됨',
395
+ 'apiKey.hint': '설정 → API에서 생성하세요. 이 기기에만 저장됩니다.',
396
+ 'guide.title': '오케스트레이션 API 빠른 시작',
397
+ 'guide.body': '역할 기반 metadata로 멀티 에이전트 작업 모드를 미리보기, 시작, 스트리밍, 취소할 수 있습니다. instruction과 model id는 선택 사항이며, model을 생략하면 CLI 설정을 사용합니다.',
398
+ 'guide.preview': 'DAG 미리보기',
399
+ 'guide.run': 'Run 시작',
400
+ 'guide.stream': 'Run 스트림',
401
+ 'guide.context': '실행 컨텍스트',
402
+ 'guide.curl': 'curl -H "Authorization: Bearer px_..." \\\n -H "content-type: application/json" \\\n -d \'{"metadata":{"agents":[{"adapterId":"codex","role":"frontend"},{"adapterId":"codex","role":"backend"},{"adapterId":"codex","role":"review"}]}}\' \\\n /api/orchestration/workflows/agent_team/preview',
403
+ loading: 'API 참조 로드 중…',
404
+ },
405
+ ru: {
406
+ title: 'Pixcode API',
407
+ badge: 'v1.36',
408
+ downloadSpec: 'Скачать спецификацию',
409
+ backToApp: 'Вернуться в приложение',
410
+ 'apiKey.label': 'API-ключ',
411
+ 'apiKey.notSet': 'Не задан',
412
+ 'apiKey.set': 'Сохранён',
413
+ 'apiKey.hint': 'Создайте в Настройки → API. Хранится только локально.',
414
+ 'guide.title': 'Быстрый старт API оркестрации',
415
+ 'guide.body': 'Используйте role-based metadata, чтобы предварительно просматривать, запускать, стримить и отменять multi-agent work modes. instruction и model id необязательны; без model используются настройки CLI.',
416
+ 'guide.preview': 'Просмотр DAG',
417
+ 'guide.run': 'Запустить run',
418
+ 'guide.stream': 'Стрим run',
419
+ 'guide.context': 'Контекст выполнения',
420
+ 'guide.curl': 'curl -H "Authorization: Bearer px_..." \\\n -H "content-type: application/json" \\\n -d \'{"metadata":{"agents":[{"adapterId":"codex","role":"frontend"},{"adapterId":"codex","role":"backend"},{"adapterId":"codex","role":"review"}]}}\' \\\n /api/orchestration/workflows/agent_team/preview',
421
+ loading: 'Загрузка справочника API…',
422
+ },
423
+ 'zh-CN': {
424
+ title: 'Pixcode API',
425
+ badge: 'v1.36',
426
+ downloadSpec: '下载规范',
427
+ backToApp: '返回应用',
428
+ 'apiKey.label': 'API 密钥',
429
+ 'apiKey.notSet': '未设置',
430
+ 'apiKey.set': '已保存',
431
+ 'apiKey.hint': '在 设置 → API 生成。仅本地存储。',
432
+ 'guide.title': '编排 API 快速开始',
433
+ 'guide.body': '使用基于角色的 metadata 预览、启动、流式跟踪和取消多代理工作模式。instruction 和 model id 都是可选字段；省略 model 时使用 CLI 设置。',
434
+ 'guide.preview': '预览 DAG',
435
+ 'guide.run': '启动 run',
436
+ 'guide.stream': '流式 run',
437
+ 'guide.context': '执行上下文',
438
+ 'guide.curl': 'curl -H "Authorization: Bearer px_..." \\\n -H "content-type: application/json" \\\n -d \'{"metadata":{"agents":[{"adapterId":"codex","role":"frontend"},{"adapterId":"codex","role":"backend"},{"adapterId":"codex","role":"review"}]}}\' \\\n /api/orchestration/workflows/agent_team/preview',
439
+ loading: '正在加载 API 参考…',
440
+ },
441
+ };
442
+
443
+ function detectLang() {
444
+ const stored = localStorage.getItem('pixcode-api-docs-lang');
445
+ if (stored && I18N[stored]) return stored;
446
+ const navLang = (navigator.language || 'en').toLowerCase();
447
+ if (navLang.startsWith('zh')) return 'zh-CN';
448
+ const short = navLang.split('-')[0];
449
+ return I18N[short] ? short : 'en';
450
+ }
451
+
452
+ function applyI18n(lang) {
453
+ const dict = I18N[lang] || I18N.en;
454
+ document.documentElement.lang = lang;
455
+ document.querySelectorAll('[data-i18n]').forEach((el) => {
456
+ const key = el.getAttribute('data-i18n');
457
+ if (dict[key]) el.textContent = dict[key];
458
+ });
459
+ }
460
+
461
+ // ── API key persistence + Scalar prefill ──────────────────────────
462
+ const apiKeyInput = document.getElementById('api-key-input');
463
+ const apiKeyStatus = document.getElementById('api-key-status');
464
+ const STORAGE_KEY = 'pixcode-api-docs-key';
465
+
466
+ function setStatus(set) {
467
+ const lang = document.documentElement.lang || 'en';
468
+ const dict = I18N[lang] || I18N.en;
469
+ apiKeyStatus.textContent = set ? dict['apiKey.set'] : dict['apiKey.notSet'];
470
+ apiKeyStatus.classList.toggle('ok', set);
471
+ }
472
+
473
+ // Restore on load.
474
+ const savedKey = localStorage.getItem(STORAGE_KEY) || '';
475
+ if (savedKey) {
476
+ apiKeyInput.value = savedKey;
477
+ setStatus(true);
478
+ } else {
479
+ setStatus(false);
480
+ }
481
+
482
+ apiKeyInput.addEventListener('input', () => {
483
+ const v = apiKeyInput.value.trim();
484
+ if (v) {
485
+ localStorage.setItem(STORAGE_KEY, v);
486
+ setStatus(true);
487
+ } else {
488
+ localStorage.removeItem(STORAGE_KEY);
489
+ setStatus(false);
490
+ }
491
+ // Re-render Scalar so the new key is prefilled in "Try it" panels.
492
+ renderScalar();
493
+ });
494
+
495
+ // ── Language picker ───────────────────────────────────────────────
496
+ const langSelect = document.getElementById('lang-select');
497
+ langSelect.value = detectLang();
498
+ applyI18n(langSelect.value);
499
+ langSelect.addEventListener('change', () => {
500
+ localStorage.setItem('pixcode-api-docs-lang', langSelect.value);
501
+ applyI18n(langSelect.value);
502
+ setStatus(Boolean(localStorage.getItem(STORAGE_KEY)));
503
+ });
504
+
505
+ // ── Scalar mount ──────────────────────────────────────────────────
506
+ // Scalar API Reference: lightweight, modern, mobile-friendly, built-in
507
+ // try-it panel with auth header support. Loaded from CDN as a single
508
+ // global; no build step required.
509
+ function getCurrentApiKey() {
510
+ return apiKeyInput.value.trim();
511
+ }
512
+
513
+ function renderScalar() {
514
+ if (!window.Scalar || typeof window.Scalar.createApiReference !== 'function') return;
515
+ const host = document.getElementById('scalar-host');
516
+ host.innerHTML = '';
517
+ window.Scalar.createApiReference(host, {
518
+ url: '/openapi.yaml',
519
+ theme: 'default',
520
+ darkMode: window.matchMedia('(prefers-color-scheme: dark)').matches,
521
+ hideClientButton: true,
522
+ hideDarkModeToggle: false,
523
+ authentication: getCurrentApiKey()
524
+ ? {
525
+ preferredSecurityScheme: 'bearerAuth',
526
+ http: { bearer: { token: getCurrentApiKey() } },
527
+ }
528
+ : undefined,
529
+ defaultHttpClient: { targetKey: 'shell', clientKey: 'curl' },
530
+ // Pixcode's app shell uses absolute /api paths against the same host;
531
+ // Scalar's "Try it" sends to the OpenAPI `servers[0]`. We override to
532
+ // the document origin so the user doesn't need to pick a server.
533
+ servers: [{ url: window.location.origin }],
534
+ });
535
+ }
536
+
537
+ const scalarScript = document.createElement('script');
538
+ scalarScript.src = 'https://cdn.jsdelivr.net/npm/@scalar/api-reference@1';
539
+ scalarScript.onload = renderScalar;
540
+ scalarScript.onerror = () => {
541
+ document.getElementById('scalar-host').innerHTML =
542
+ '<div class="loader"><span>⚠ Scalar CDN unreachable. <a href="/openapi.yaml" style="color:var(--primary)">Download the OpenAPI spec</a> and load it in your own viewer.</span></div>';
543
+ };
544
+ document.head.appendChild(scalarScript);
545
+ </script>
546
+
547
+ </body>
548
+ </html>