march-cli 0.1.21 → 0.1.23

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 (244) hide show
  1. package/README.md +88 -0
  2. package/README.zh.md +88 -0
  3. package/bin/march.mjs +13 -13
  4. package/package.json +43 -43
  5. package/src/agent/command-exec-tool.mjs +172 -168
  6. package/src/agent/context-stats-tool.mjs +57 -57
  7. package/src/agent/editing/diff-apply.mjs +28 -28
  8. package/src/agent/editing/diff-format.mjs +57 -57
  9. package/src/agent/editing/lsp-report.mjs +69 -69
  10. package/src/agent/file-edit-tool.mjs +262 -262
  11. package/src/agent/file-tools/read-file-tool.mjs +112 -112
  12. package/src/agent/file-tools/read-image-tool.mjs +76 -76
  13. package/src/agent/model-payload-dumper.mjs +208 -208
  14. package/src/agent/pi-session/pi-session-sidecar-failure.mjs +10 -10
  15. package/src/agent/provider/payload-messages.mjs +138 -138
  16. package/src/agent/runner/codex-large-context-guard.mjs +87 -87
  17. package/src/agent/runner/codex-transport-compression.mjs +180 -180
  18. package/src/agent/runner/codex-transport-debug.mjs +113 -113
  19. package/src/agent/runner/codex-websocket-event-debug.mjs +130 -130
  20. package/src/agent/runner/fast-model.mjs +36 -36
  21. package/src/agent/runner/runner-cleanup.mjs +12 -12
  22. package/src/agent/runner/runner-init.mjs +15 -15
  23. package/src/agent/runner/runner-session-state.mjs +40 -40
  24. package/src/agent/runner/runner-utils.mjs +24 -24
  25. package/src/agent/runner.mjs +299 -299
  26. package/src/agent/runtime/ipc/ipc-peer.mjs +99 -99
  27. package/src/agent/runtime/ipc/process-ipc-transport.mjs +16 -16
  28. package/src/agent/runtime/remote-runner-client.mjs +73 -73
  29. package/src/agent/runtime/remote-ui-client.mjs +20 -20
  30. package/src/agent/runtime/runner-ipc-target.mjs +125 -125
  31. package/src/agent/runtime/runner-process-client.mjs +47 -47
  32. package/src/agent/runtime/runner-process-entry.mjs +11 -11
  33. package/src/agent/runtime/runner-process-factory.mjs +108 -108
  34. package/src/agent/runtime/runner-runtime-host.mjs +79 -79
  35. package/src/agent/runtime/runtime-factory.mjs +42 -42
  36. package/src/agent/runtime/runtime-host.mjs +34 -34
  37. package/src/agent/runtime/ui-event-bridge.mjs +95 -95
  38. package/src/agent/screen-tools/list-windows-tool.mjs +39 -39
  39. package/src/agent/screen-tools/screen-tool.mjs +49 -49
  40. package/src/agent/screen-tools/windows-screen.mjs +133 -133
  41. package/src/agent/session/session-auto-name.mjs +41 -41
  42. package/src/agent/session/session-binding.mjs +12 -12
  43. package/src/agent/session/session-options.mjs +47 -47
  44. package/src/agent/tool-names.mjs +1 -1
  45. package/src/agent/tool-result.mjs +3 -3
  46. package/src/agent/tool-summary.mjs +112 -112
  47. package/src/agent/tools.mjs +58 -58
  48. package/src/agent/turn/turn-events.mjs +111 -111
  49. package/src/agent/turn/turn-logging.mjs +30 -30
  50. package/src/agent/turn/turn-runner.mjs +196 -196
  51. package/src/agent/vision-capability.mjs +14 -14
  52. package/src/auth/login-command.mjs +90 -90
  53. package/src/auth/storage.mjs +34 -34
  54. package/src/cli/args.mjs +79 -79
  55. package/src/cli/commands/copy-command.mjs +87 -87
  56. package/src/cli/commands/export-command.mjs +206 -206
  57. package/src/cli/commands/extensions-command.mjs +53 -53
  58. package/src/cli/commands/help-command.mjs +7 -7
  59. package/src/cli/commands/model-command.mjs +141 -141
  60. package/src/cli/commands/paste-image-command.mjs +43 -43
  61. package/src/cli/commands/provider-command.mjs +59 -59
  62. package/src/cli/commands/status-command.mjs +194 -194
  63. package/src/cli/commands/thinking-command.mjs +87 -87
  64. package/src/cli/fallback-ui.mjs +156 -156
  65. package/src/cli/input/attachment-tokens.mjs +20 -20
  66. package/src/cli/input/autocomplete.mjs +74 -106
  67. package/src/cli/input/external-editor.mjs +39 -39
  68. package/src/cli/input/file-search/index.mjs +160 -0
  69. package/src/cli/input/history-store.mjs +35 -35
  70. package/src/cli/input/image-clipboard.mjs +55 -55
  71. package/src/cli/input/keybinding-dispatch.mjs +76 -76
  72. package/src/cli/input/keybindings.mjs +96 -96
  73. package/src/cli/input/mode-state.mjs +43 -43
  74. package/src/cli/input/prompt-templates.mjs +84 -84
  75. package/src/cli/input/select-with-keyboard.mjs +86 -86
  76. package/src/cli/permissions.mjs +103 -103
  77. package/src/cli/repl-commands.mjs +86 -86
  78. package/src/cli/repl-loop.mjs +183 -183
  79. package/src/cli/selector-list.mjs +21 -21
  80. package/src/cli/session/pi-session-switch-command.mjs +41 -41
  81. package/src/cli/session/session-command.mjs +23 -23
  82. package/src/cli/session/session-list-command.mjs +68 -68
  83. package/src/cli/session/session-name-command.mjs +26 -26
  84. package/src/cli/session/session-source-command.mjs +89 -89
  85. package/src/cli/session/session-switch-command.mjs +1 -1
  86. package/src/cli/shell/shell-command.mjs +55 -55
  87. package/src/cli/shell/shell-drawer-controls.mjs +33 -33
  88. package/src/cli/shell/shell-drawer.mjs +192 -192
  89. package/src/cli/shell/shell-split-layout.mjs +70 -70
  90. package/src/cli/slash-commands.mjs +192 -192
  91. package/src/cli/startup/create-runtime-runner.mjs +61 -61
  92. package/src/cli/startup/runtime-close.mjs +23 -23
  93. package/src/cli/startup/startup-banner.mjs +71 -71
  94. package/src/cli/startup/startup-session.mjs +51 -51
  95. package/src/cli/status-line-updater.mjs +75 -75
  96. package/src/cli/tool-output.mjs +9 -9
  97. package/src/cli/tui/editor/external-editor-runner.mjs +24 -24
  98. package/src/cli/tui/input/mouse-selection-controller.mjs +91 -91
  99. package/src/cli/tui/input/mouse-tracking.mjs +20 -20
  100. package/src/cli/tui/layout/main-pane-layout.mjs +47 -47
  101. package/src/cli/tui/layout/safe-render-boundary.mjs +46 -46
  102. package/src/cli/tui/markdown-renderer.mjs +285 -285
  103. package/src/cli/tui/output/scroll-state.mjs +79 -79
  104. package/src/cli/tui/output/text-line-renderer.mjs +50 -50
  105. package/src/cli/tui/output/tool-card-renderer.mjs +59 -59
  106. package/src/cli/tui/output/visible-lines.mjs +8 -8
  107. package/src/cli/tui/output-buffer.mjs +293 -293
  108. package/src/cli/tui/permission-request-ui.mjs +18 -18
  109. package/src/cli/tui/recall-rendering.mjs +25 -25
  110. package/src/cli/tui/render/render-scheduler.mjs +26 -26
  111. package/src/cli/tui/render/stream-delta-buffer.mjs +46 -46
  112. package/src/cli/tui/select/editor-select-list.mjs +111 -111
  113. package/src/cli/tui/selection-screen.mjs +269 -269
  114. package/src/cli/tui/status/retry-status.mjs +72 -72
  115. package/src/cli/tui/status/spinner-status.mjs +42 -42
  116. package/src/cli/tui/status/status-bar.mjs +225 -225
  117. package/src/cli/tui/syntax/highlighting.mjs +260 -260
  118. package/src/cli/tui/syntax/languages.mjs +91 -91
  119. package/src/cli/tui/syntax/tree-sitter/bash.highlights.scm +261 -261
  120. package/src/cli/tui/syntax/tree-sitter/c.highlights.scm +341 -341
  121. package/src/cli/tui/syntax/tree-sitter/cpp.highlights.scm +268 -268
  122. package/src/cli/tui/syntax/tree-sitter/csharp.highlights.scm +577 -577
  123. package/src/cli/tui/syntax/tree-sitter/css.highlights.scm +109 -109
  124. package/src/cli/tui/syntax/tree-sitter/diff.highlights.scm +49 -49
  125. package/src/cli/tui/syntax/tree-sitter/go.highlights.scm +254 -254
  126. package/src/cli/tui/syntax/tree-sitter/html.highlights.scm +13 -13
  127. package/src/cli/tui/syntax/tree-sitter/java.highlights.scm +330 -330
  128. package/src/cli/tui/syntax/tree-sitter/json.highlights.scm +38 -38
  129. package/src/cli/tui/syntax/tree-sitter/php.highlights.scm +203 -203
  130. package/src/cli/tui/syntax/tree-sitter/python.highlights.scm +137 -137
  131. package/src/cli/tui/syntax/tree-sitter/ruby.highlights.scm +309 -309
  132. package/src/cli/tui/syntax/tree-sitter/rust.highlights.scm +531 -531
  133. package/src/cli/tui/syntax/tree-sitter/toml.highlights.scm +39 -39
  134. package/src/cli/tui/syntax/tree-sitter/tsx.highlights.scm +35 -35
  135. package/src/cli/tui/syntax/tree-sitter/typescript.highlights.scm +35 -35
  136. package/src/cli/tui/syntax/tree-sitter/yaml.highlights.scm +99 -99
  137. package/src/cli/tui/tool-rendering.mjs +87 -87
  138. package/src/cli/tui/tui-diff-rendering.mjs +157 -157
  139. package/src/cli/tui/tui-handlers.mjs +111 -111
  140. package/src/cli/tui/tui-input-controller.mjs +61 -61
  141. package/src/cli/tui/ui-theme.mjs +157 -157
  142. package/src/cli/ui.mjs +297 -297
  143. package/src/config/config-json.mjs +84 -84
  144. package/src/config/dotenv.mjs +20 -20
  145. package/src/config/features.mjs +75 -75
  146. package/src/config/loader.mjs +143 -143
  147. package/src/config/settings-command.mjs +97 -97
  148. package/src/context/engine.mjs +198 -198
  149. package/src/context/injections.mjs +26 -26
  150. package/src/context/profiles.mjs +39 -39
  151. package/src/context/project-context.mjs +20 -20
  152. package/src/context/session-status.mjs +17 -17
  153. package/src/context/shell-layers.mjs +23 -23
  154. package/src/context/system-core/base.md +61 -53
  155. package/src/context/system-core/prompts/deepseek-v4-pro.md +3 -3
  156. package/src/context/system-core/prompts/default.md +3 -3
  157. package/src/context/system-core.mjs +35 -35
  158. package/src/debug/logger.mjs +141 -141
  159. package/src/debug/model-context-dumper.mjs +52 -52
  160. package/src/extensions/discovery.mjs +40 -40
  161. package/src/extensions/lifecycle-adapter.mjs +210 -210
  162. package/src/extensions/lifecycle-manifest.mjs +69 -69
  163. package/src/image-gen/index.mjs +7 -7
  164. package/src/image-gen/provider.mjs +231 -231
  165. package/src/image-gen/tool.mjs +84 -84
  166. package/src/lsp/client.mjs +257 -257
  167. package/src/lsp/diagnostic-store.mjs +42 -42
  168. package/src/lsp/diagnostics-format.mjs +72 -72
  169. package/src/lsp/managed-node-server.mjs +99 -99
  170. package/src/lsp/path-match.mjs +10 -10
  171. package/src/lsp/server-definitions.mjs +188 -188
  172. package/src/lsp/servers.mjs +165 -165
  173. package/src/lsp/service.mjs +110 -110
  174. package/src/lsp/status-message.mjs +9 -9
  175. package/src/lsp/typescript-project-resolver.mjs +186 -186
  176. package/src/main.mjs +299 -299
  177. package/src/mcp/client.mjs +195 -195
  178. package/src/mcp/config.mjs +130 -130
  179. package/src/mcp/index.mjs +48 -48
  180. package/src/mcp/tools.mjs +98 -98
  181. package/src/memory/markdown/markdown-delete.mjs +23 -23
  182. package/src/memory/markdown/markdown-format.mjs +128 -128
  183. package/src/memory/markdown/markdown-recall.mjs +28 -28
  184. package/src/memory/markdown/ripgrep.mjs +16 -16
  185. package/src/memory/markdown/sqlite-index.mjs +87 -87
  186. package/src/memory/markdown-store.mjs +286 -286
  187. package/src/memory/markdown-tools.mjs +103 -103
  188. package/src/network/environment.mjs +131 -131
  189. package/src/notification/desktop-notifier.mjs +262 -262
  190. package/src/platform/open-file.mjs +28 -28
  191. package/src/platform/spawn-command.mjs +27 -27
  192. package/src/provider/accept-command.mjs +89 -89
  193. package/src/provider/command.mjs +21 -21
  194. package/src/provider/config-command.mjs +129 -129
  195. package/src/provider/custom-provider.mjs +113 -113
  196. package/src/provider/hosted-tools.mjs +111 -111
  197. package/src/provider/presets.mjs +72 -72
  198. package/src/provider/share-command.mjs +79 -79
  199. package/src/provider/share-payload.mjs +52 -52
  200. package/src/session/attachment-display.mjs +16 -16
  201. package/src/session/attachment-references.mjs +65 -65
  202. package/src/session/attachments.mjs +140 -140
  203. package/src/session/persist.mjs +1 -1
  204. package/src/session/pi-manager.mjs +34 -34
  205. package/src/session/session-utils.mjs +16 -16
  206. package/src/session/sidecar-sync.mjs +19 -19
  207. package/src/session/sidecar.mjs +69 -69
  208. package/src/session/transcript.mjs +83 -83
  209. package/src/session/tree.mjs +42 -42
  210. package/src/shell/cli-runtime.mjs +11 -11
  211. package/src/shell/hints.mjs +12 -12
  212. package/src/shell/node-pty-adapter.mjs +81 -81
  213. package/src/shell/runtime-state.mjs +126 -126
  214. package/src/shell/runtime.mjs +252 -252
  215. package/src/shell/screen-buffer.mjs +136 -136
  216. package/src/shell/tool-read.mjs +74 -74
  217. package/src/shell/tools.mjs +299 -299
  218. package/src/supergrok/actions/image-generate.mjs +60 -60
  219. package/src/supergrok/actions/search.mjs +78 -78
  220. package/src/supergrok/auth.mjs +36 -36
  221. package/src/supergrok/constants.mjs +18 -18
  222. package/src/supergrok/oauth-provider.mjs +278 -278
  223. package/src/supergrok/provider.mjs +35 -35
  224. package/src/supergrok/response.mjs +76 -76
  225. package/src/supergrok/tool.mjs +61 -61
  226. package/src/text/ansi.mjs +3 -3
  227. package/src/web/config-command.mjs +43 -43
  228. package/src/web/fetch.mjs +78 -78
  229. package/src/web/presets.mjs +16 -16
  230. package/src/web/search.mjs +83 -83
  231. package/src/web/tools.mjs +107 -107
  232. package/src/memory/database.mjs +0 -219
  233. package/src/memory/glossary.mjs +0 -124
  234. package/src/memory/graph/graph-cascades.mjs +0 -109
  235. package/src/memory/graph/graph-diagnostics.mjs +0 -73
  236. package/src/memory/graph/graph-path-removal.mjs +0 -50
  237. package/src/memory/graph/graph-path-utils.mjs +0 -17
  238. package/src/memory/graph/graph-primitives.mjs +0 -103
  239. package/src/memory/graph/graph-read.mjs +0 -159
  240. package/src/memory/graph.mjs +0 -282
  241. package/src/memory/search.mjs +0 -142
  242. package/src/memory/snapshot.mjs +0 -86
  243. package/src/memory/system-views.mjs +0 -120
  244. package/src/memory/tools.mjs +0 -282
@@ -1,79 +1,79 @@
1
- import { globalConfigJsonPath, readConfigJson } from "../config/config-json.mjs";
2
- import { selectWithKeyboard } from "../cli/input/select-with-keyboard.mjs";
3
- import { cloneProviderForShare, createProviderShareToken, hasApiKey } from "./share-payload.mjs";
4
-
5
- export async function runProviderShareCommand({
6
- homeDir,
7
- providerId,
8
- includeKey = false,
9
- profileOnly = false,
10
- input = process.stdin,
11
- output = process.stdout,
12
- select = selectWithKeyboard,
13
- } = {}) {
14
- if (includeKey && profileOnly) {
15
- output.write("Choose either --include-key or --profile-only, not both.\n");
16
- return 1;
17
- }
18
-
19
- const config = readConfigJson(globalConfigJsonPath(homeDir));
20
- const providers = normalizeProviders(config.providers);
21
- const selectedProviderId = providerId ?? await selectProvider({ providers, input, output, select });
22
- if (!selectedProviderId) {
23
- output.write(Object.keys(providers).length ? "Provider share cancelled.\n" : "No providers configured. Run: march provider --config\n");
24
- return 1;
25
- }
26
-
27
- const provider = providers[selectedProviderId];
28
- if (!provider) {
29
- output.write(`Provider not found: ${selectedProviderId}\n`);
30
- return 1;
31
- }
32
-
33
- const includeApiKey = includeKey || (!profileOnly && await selectShareMode({ input, output, select }));
34
- const sharedProvider = cloneProviderForShare(provider, { includeApiKey });
35
- const token = createProviderShareToken({
36
- providerId: selectedProviderId,
37
- provider: sharedProvider,
38
- mode: includeApiKey ? "full" : "profile-only",
39
- });
40
-
41
- output.write(`Provider: ${selectedProviderId}\n`);
42
- output.write(`Mode: ${includeApiKey ? "Full config, including API key" : "Profile only, without API key"}\n`);
43
- output.write(`API key: ${hasApiKey(sharedProvider) ? "included" : "not included"}\n\n`);
44
- output.write(`march provider accept ${token}\n`);
45
- return 0;
46
- }
47
-
48
- function normalizeProviders(providers) {
49
- return providers && typeof providers === "object" && !Array.isArray(providers) ? providers : {};
50
- }
51
-
52
- async function selectProvider({ providers, input, output, select }) {
53
- const items = Object.entries(providers).map(([id, provider]) => ({
54
- value: id,
55
- label: formatProviderLabel(id, provider),
56
- }));
57
- return await select({ input, output, message: "Choose provider to share", items });
58
- }
59
-
60
- async function selectShareMode({ input, output, select }) {
61
- const mode = await select({
62
- input,
63
- output,
64
- message: "Choose share mode",
65
- items: [
66
- { label: "Full config, including API key", value: "full" },
67
- { label: "Profile only, without API key", value: "profile-only" },
68
- ],
69
- });
70
- return mode === "full";
71
- }
72
-
73
- function formatProviderLabel(id, provider) {
74
- const name = typeof provider?.name === "string" && provider.name ? provider.name : "-";
75
- const type = typeof provider?.type === "string" && provider.type ? provider.type : "unknown";
76
- const modelCount = Array.isArray(provider?.models) ? `${provider.models.length} model${provider.models.length === 1 ? "" : "s"}` : "built-in";
77
- const key = hasApiKey(provider) ? "API key configured" : "no API key";
78
- return `${id} ${name} ${type} ${modelCount} ${key}`;
79
- }
1
+ import { globalConfigJsonPath, readConfigJson } from "../config/config-json.mjs";
2
+ import { selectWithKeyboard } from "../cli/input/select-with-keyboard.mjs";
3
+ import { cloneProviderForShare, createProviderShareToken, hasApiKey } from "./share-payload.mjs";
4
+
5
+ export async function runProviderShareCommand({
6
+ homeDir,
7
+ providerId,
8
+ includeKey = false,
9
+ profileOnly = false,
10
+ input = process.stdin,
11
+ output = process.stdout,
12
+ select = selectWithKeyboard,
13
+ } = {}) {
14
+ if (includeKey && profileOnly) {
15
+ output.write("Choose either --include-key or --profile-only, not both.\n");
16
+ return 1;
17
+ }
18
+
19
+ const config = readConfigJson(globalConfigJsonPath(homeDir));
20
+ const providers = normalizeProviders(config.providers);
21
+ const selectedProviderId = providerId ?? await selectProvider({ providers, input, output, select });
22
+ if (!selectedProviderId) {
23
+ output.write(Object.keys(providers).length ? "Provider share cancelled.\n" : "No providers configured. Run: march provider --config\n");
24
+ return 1;
25
+ }
26
+
27
+ const provider = providers[selectedProviderId];
28
+ if (!provider) {
29
+ output.write(`Provider not found: ${selectedProviderId}\n`);
30
+ return 1;
31
+ }
32
+
33
+ const includeApiKey = includeKey || (!profileOnly && await selectShareMode({ input, output, select }));
34
+ const sharedProvider = cloneProviderForShare(provider, { includeApiKey });
35
+ const token = createProviderShareToken({
36
+ providerId: selectedProviderId,
37
+ provider: sharedProvider,
38
+ mode: includeApiKey ? "full" : "profile-only",
39
+ });
40
+
41
+ output.write(`Provider: ${selectedProviderId}\n`);
42
+ output.write(`Mode: ${includeApiKey ? "Full config, including API key" : "Profile only, without API key"}\n`);
43
+ output.write(`API key: ${hasApiKey(sharedProvider) ? "included" : "not included"}\n\n`);
44
+ output.write(`march provider accept ${token}\n`);
45
+ return 0;
46
+ }
47
+
48
+ function normalizeProviders(providers) {
49
+ return providers && typeof providers === "object" && !Array.isArray(providers) ? providers : {};
50
+ }
51
+
52
+ async function selectProvider({ providers, input, output, select }) {
53
+ const items = Object.entries(providers).map(([id, provider]) => ({
54
+ value: id,
55
+ label: formatProviderLabel(id, provider),
56
+ }));
57
+ return await select({ input, output, message: "Choose provider to share", items });
58
+ }
59
+
60
+ async function selectShareMode({ input, output, select }) {
61
+ const mode = await select({
62
+ input,
63
+ output,
64
+ message: "Choose share mode",
65
+ items: [
66
+ { label: "Full config, including API key", value: "full" },
67
+ { label: "Profile only, without API key", value: "profile-only" },
68
+ ],
69
+ });
70
+ return mode === "full";
71
+ }
72
+
73
+ function formatProviderLabel(id, provider) {
74
+ const name = typeof provider?.name === "string" && provider.name ? provider.name : "-";
75
+ const type = typeof provider?.type === "string" && provider.type ? provider.type : "unknown";
76
+ const modelCount = Array.isArray(provider?.models) ? `${provider.models.length} model${provider.models.length === 1 ? "" : "s"}` : "built-in";
77
+ const key = hasApiKey(provider) ? "API key configured" : "no API key";
78
+ return `${id} ${name} ${type} ${modelCount} ${key}`;
79
+ }
@@ -1,52 +1,52 @@
1
- const KIND = "march.provider.share";
2
- const VERSION = 1;
3
- const PREFIX = "march-provider-v1.";
4
-
5
- export function createProviderShareToken({ providerId, provider, mode }) {
6
- const payload = {
7
- kind: KIND,
8
- version: VERSION,
9
- mode,
10
- containsApiKey: hasApiKey(provider),
11
- providerId,
12
- provider,
13
- };
14
- return `${PREFIX}${Buffer.from(JSON.stringify(payload), "utf8").toString("base64url")}`;
15
- }
16
-
17
- export function parseProviderShareToken(token) {
18
- const text = String(token ?? "").trim();
19
- if (!text.startsWith(PREFIX)) throw new Error(`Provider share token must start with ${PREFIX}`);
20
- let payload;
21
- try {
22
- payload = JSON.parse(Buffer.from(text.slice(PREFIX.length), "base64url").toString("utf8"));
23
- } catch {
24
- throw new Error("Invalid provider share token");
25
- }
26
- validateProviderSharePayload(payload);
27
- return payload;
28
- }
29
-
30
- export function cloneProviderForShare(provider, { includeApiKey }) {
31
- const clone = structuredClone(provider);
32
- if (!includeApiKey && clone.auth && typeof clone.auth === "object" && !Array.isArray(clone.auth)) {
33
- delete clone.auth.apiKey;
34
- }
35
- return clone;
36
- }
37
-
38
- export function hasApiKey(provider) {
39
- return typeof provider?.auth?.apiKey === "string" && provider.auth.apiKey.length > 0;
40
- }
41
-
42
- export function validateProviderSharePayload(payload) {
43
- if (!payload || typeof payload !== "object" || Array.isArray(payload)) throw new Error("Invalid provider share payload");
44
- if (payload.kind !== KIND || payload.version !== VERSION) throw new Error("Unsupported provider share token");
45
- if (typeof payload.providerId !== "string" || !payload.providerId.trim()) throw new Error("Provider share token is missing providerId");
46
- validateProviderProfile(payload.provider);
47
- }
48
-
49
- function validateProviderProfile(provider) {
50
- if (!provider || typeof provider !== "object" || Array.isArray(provider)) throw new Error("Provider share token is missing provider config");
51
- if (typeof provider.type !== "string" || !provider.type.trim()) throw new Error("Provider config is missing type");
52
- }
1
+ const KIND = "march.provider.share";
2
+ const VERSION = 1;
3
+ const PREFIX = "march-provider-v1.";
4
+
5
+ export function createProviderShareToken({ providerId, provider, mode }) {
6
+ const payload = {
7
+ kind: KIND,
8
+ version: VERSION,
9
+ mode,
10
+ containsApiKey: hasApiKey(provider),
11
+ providerId,
12
+ provider,
13
+ };
14
+ return `${PREFIX}${Buffer.from(JSON.stringify(payload), "utf8").toString("base64url")}`;
15
+ }
16
+
17
+ export function parseProviderShareToken(token) {
18
+ const text = String(token ?? "").trim();
19
+ if (!text.startsWith(PREFIX)) throw new Error(`Provider share token must start with ${PREFIX}`);
20
+ let payload;
21
+ try {
22
+ payload = JSON.parse(Buffer.from(text.slice(PREFIX.length), "base64url").toString("utf8"));
23
+ } catch {
24
+ throw new Error("Invalid provider share token");
25
+ }
26
+ validateProviderSharePayload(payload);
27
+ return payload;
28
+ }
29
+
30
+ export function cloneProviderForShare(provider, { includeApiKey }) {
31
+ const clone = structuredClone(provider);
32
+ if (!includeApiKey && clone.auth && typeof clone.auth === "object" && !Array.isArray(clone.auth)) {
33
+ delete clone.auth.apiKey;
34
+ }
35
+ return clone;
36
+ }
37
+
38
+ export function hasApiKey(provider) {
39
+ return typeof provider?.auth?.apiKey === "string" && provider.auth.apiKey.length > 0;
40
+ }
41
+
42
+ export function validateProviderSharePayload(payload) {
43
+ if (!payload || typeof payload !== "object" || Array.isArray(payload)) throw new Error("Invalid provider share payload");
44
+ if (payload.kind !== KIND || payload.version !== VERSION) throw new Error("Unsupported provider share token");
45
+ if (typeof payload.providerId !== "string" || !payload.providerId.trim()) throw new Error("Provider share token is missing providerId");
46
+ validateProviderProfile(payload.provider);
47
+ }
48
+
49
+ function validateProviderProfile(provider) {
50
+ if (!provider || typeof provider !== "object" || Array.isArray(provider)) throw new Error("Provider share token is missing provider config");
51
+ if (typeof provider.type !== "string" || !provider.type.trim()) throw new Error("Provider config is missing type");
52
+ }
@@ -1,16 +1,16 @@
1
- import { basename } from "node:path";
2
-
3
- const ATTACHMENT_MARKER_RE = /@\.march\/attachments\/[^\s"'`<>)]+/g;
4
-
5
- export function formatAttachmentMarkerForDisplay(marker) {
6
- const name = formatAttachmentDisplayName(basename(String(marker || "").replace(/\\/g, "/")) || "image");
7
- return `[image: ${name}]`;
8
- }
9
-
10
- export function formatMessageAttachmentsForDisplay(text) {
11
- return String(text || "").replace(ATTACHMENT_MARKER_RE, (marker) => formatAttachmentMarkerForDisplay(marker));
12
- }
13
-
14
- export function formatAttachmentDisplayName(name) {
15
- return String(name || "image").replace(/^\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}-\d{3}Z_/, "");
16
- }
1
+ import { basename } from "node:path";
2
+
3
+ const ATTACHMENT_MARKER_RE = /@\.march\/attachments\/[^\s"'`<>)]+/g;
4
+
5
+ export function formatAttachmentMarkerForDisplay(marker) {
6
+ const name = formatAttachmentDisplayName(basename(String(marker || "").replace(/\\/g, "/")) || "image");
7
+ return `[image: ${name}]`;
8
+ }
9
+
10
+ export function formatMessageAttachmentsForDisplay(text) {
11
+ return String(text || "").replace(ATTACHMENT_MARKER_RE, (marker) => formatAttachmentMarkerForDisplay(marker));
12
+ }
13
+
14
+ export function formatAttachmentDisplayName(name) {
15
+ return String(name || "image").replace(/^\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}-\d{3}Z_/, "");
16
+ }
@@ -1,65 +1,65 @@
1
- import { existsSync, readFileSync } from "node:fs";
2
- import { extname, join, relative, resolve } from "node:path";
3
- import { getAttachmentRoot, imageExtensionForMime } from "./attachments.mjs";
4
-
5
- const ATTACHMENT_MARKER_RE = /@\.march\/attachments\/[^\s"'`<>)]+/g;
6
-
7
- const IMAGE_MIME_BY_EXT = Object.freeze({
8
- ".gif": "image/gif",
9
- ".jpg": "image/jpeg",
10
- ".jpeg": "image/jpeg",
11
- ".png": "image/png",
12
- ".webp": "image/webp",
13
- });
14
-
15
- export function resolveImageAttachmentReferences({ text, projectMarchDir } = {}) {
16
- if (!text || !projectMarchDir) return { images: [], references: [] };
17
-
18
- const seen = new Set();
19
- const images = [];
20
- const references = [];
21
- for (const marker of String(text).match(ATTACHMENT_MARKER_RE) || []) {
22
- if (seen.has(marker)) continue;
23
- seen.add(marker);
24
-
25
- const relativePath = marker.slice("@.march/".length);
26
- const path = assertInsideAttachmentRoot(join(projectMarchDir, relativePath), projectMarchDir);
27
- if (!existsSync(path)) continue;
28
-
29
- const mimeType = readSupportedAttachmentMimeType(path) ?? mimeTypeForPath(path);
30
- if (!mimeType) continue;
31
-
32
- const data = readFileSync(path).toString("base64");
33
- images.push({ type: "image", mimeType, data });
34
- references.push({ marker, path, mimeType });
35
- }
36
-
37
- return { images, references };
38
- }
39
-
40
- function readSupportedAttachmentMimeType(path) {
41
- const metadataPath = path.replace(/\.[^.\\/]+$/, ".json");
42
- if (!existsSync(metadataPath)) return null;
43
- try {
44
- const metadata = JSON.parse(readFileSync(metadataPath, "utf8"));
45
- if (typeof metadata.mimeType !== "string") return null;
46
- imageExtensionForMime(metadata.mimeType);
47
- return metadata.mimeType;
48
- } catch {
49
- return null;
50
- }
51
- }
52
-
53
- function mimeTypeForPath(path) {
54
- return IMAGE_MIME_BY_EXT[extname(path).toLowerCase()] ?? null;
55
- }
56
-
57
- function assertInsideAttachmentRoot(path, projectMarchDir) {
58
- const root = resolve(getAttachmentRoot(projectMarchDir));
59
- const resolvedPath = resolve(path);
60
- const rel = relative(root, resolvedPath);
61
- if (rel.startsWith("..") || rel === "" || resolve(root, rel) !== resolvedPath) {
62
- throw new Error("attachment marker escaped attachments root");
63
- }
64
- return resolvedPath;
65
- }
1
+ import { existsSync, readFileSync } from "node:fs";
2
+ import { extname, join, relative, resolve } from "node:path";
3
+ import { getAttachmentRoot, imageExtensionForMime } from "./attachments.mjs";
4
+
5
+ const ATTACHMENT_MARKER_RE = /@\.march\/attachments\/[^\s"'`<>)]+/g;
6
+
7
+ const IMAGE_MIME_BY_EXT = Object.freeze({
8
+ ".gif": "image/gif",
9
+ ".jpg": "image/jpeg",
10
+ ".jpeg": "image/jpeg",
11
+ ".png": "image/png",
12
+ ".webp": "image/webp",
13
+ });
14
+
15
+ export function resolveImageAttachmentReferences({ text, projectMarchDir } = {}) {
16
+ if (!text || !projectMarchDir) return { images: [], references: [] };
17
+
18
+ const seen = new Set();
19
+ const images = [];
20
+ const references = [];
21
+ for (const marker of String(text).match(ATTACHMENT_MARKER_RE) || []) {
22
+ if (seen.has(marker)) continue;
23
+ seen.add(marker);
24
+
25
+ const relativePath = marker.slice("@.march/".length);
26
+ const path = assertInsideAttachmentRoot(join(projectMarchDir, relativePath), projectMarchDir);
27
+ if (!existsSync(path)) continue;
28
+
29
+ const mimeType = readSupportedAttachmentMimeType(path) ?? mimeTypeForPath(path);
30
+ if (!mimeType) continue;
31
+
32
+ const data = readFileSync(path).toString("base64");
33
+ images.push({ type: "image", mimeType, data });
34
+ references.push({ marker, path, mimeType });
35
+ }
36
+
37
+ return { images, references };
38
+ }
39
+
40
+ function readSupportedAttachmentMimeType(path) {
41
+ const metadataPath = path.replace(/\.[^.\\/]+$/, ".json");
42
+ if (!existsSync(metadataPath)) return null;
43
+ try {
44
+ const metadata = JSON.parse(readFileSync(metadataPath, "utf8"));
45
+ if (typeof metadata.mimeType !== "string") return null;
46
+ imageExtensionForMime(metadata.mimeType);
47
+ return metadata.mimeType;
48
+ } catch {
49
+ return null;
50
+ }
51
+ }
52
+
53
+ function mimeTypeForPath(path) {
54
+ return IMAGE_MIME_BY_EXT[extname(path).toLowerCase()] ?? null;
55
+ }
56
+
57
+ function assertInsideAttachmentRoot(path, projectMarchDir) {
58
+ const root = resolve(getAttachmentRoot(projectMarchDir));
59
+ const resolvedPath = resolve(path);
60
+ const rel = relative(root, resolvedPath);
61
+ if (rel.startsWith("..") || rel === "" || resolve(root, rel) !== resolvedPath) {
62
+ throw new Error("attachment marker escaped attachments root");
63
+ }
64
+ return resolvedPath;
65
+ }