march-cli 0.1.23 → 0.1.25

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 (237) hide show
  1. package/README.md +1 -1
  2. package/README.zh.md +1 -1
  3. package/bin/march.mjs +13 -13
  4. package/package.json +49 -43
  5. package/src/agent/command-exec-tool.mjs +172 -172
  6. package/src/agent/context-stats-tool.mjs +57 -57
  7. package/src/agent/editing/cohesion-warning.mjs +57 -0
  8. package/src/agent/editing/diff-apply.mjs +28 -28
  9. package/src/agent/editing/diff-format.mjs +57 -57
  10. package/src/agent/editing/lsp-report.mjs +69 -69
  11. package/src/agent/file-edit-tool.mjs +277 -262
  12. package/src/agent/file-tools/read-file-tool.mjs +112 -112
  13. package/src/agent/file-tools/read-image-tool.mjs +76 -76
  14. package/src/agent/model-payload-dumper.mjs +208 -208
  15. package/src/agent/pi-session/pi-session-sidecar-failure.mjs +10 -10
  16. package/src/agent/provider/payload-messages.mjs +138 -138
  17. package/src/agent/runner/codex-large-context-guard.mjs +87 -87
  18. package/src/agent/runner/codex-transport-compression.mjs +180 -180
  19. package/src/agent/runner/codex-transport-debug.mjs +113 -113
  20. package/src/agent/runner/codex-websocket-event-debug.mjs +130 -130
  21. package/src/agent/runner/fast-model.mjs +36 -36
  22. package/src/agent/runner/runner-cleanup.mjs +12 -12
  23. package/src/agent/runner/runner-init.mjs +15 -15
  24. package/src/agent/runner/runner-session-state.mjs +40 -40
  25. package/src/agent/runner/runner-utils.mjs +24 -24
  26. package/src/agent/runner.mjs +299 -299
  27. package/src/agent/runtime/ipc/ipc-peer.mjs +99 -99
  28. package/src/agent/runtime/ipc/process-ipc-transport.mjs +16 -16
  29. package/src/agent/runtime/remote-runner-client.mjs +73 -73
  30. package/src/agent/runtime/remote-ui-client.mjs +20 -20
  31. package/src/agent/runtime/runner-ipc-target.mjs +125 -125
  32. package/src/agent/runtime/runner-process-client.mjs +47 -47
  33. package/src/agent/runtime/runner-process-entry.mjs +11 -11
  34. package/src/agent/runtime/runner-process-factory.mjs +111 -108
  35. package/src/agent/runtime/runner-runtime-host.mjs +79 -79
  36. package/src/agent/runtime/runtime-factory.mjs +42 -42
  37. package/src/agent/runtime/runtime-host.mjs +34 -34
  38. package/src/agent/runtime/ui-event-bridge.mjs +95 -95
  39. package/src/agent/screen-tools/list-windows-tool.mjs +39 -39
  40. package/src/agent/screen-tools/screen-tool.mjs +49 -49
  41. package/src/agent/screen-tools/windows-screen.mjs +133 -133
  42. package/src/agent/session/session-auto-name.mjs +41 -41
  43. package/src/agent/session/session-binding.mjs +12 -12
  44. package/src/agent/session/session-options.mjs +47 -47
  45. package/src/agent/tool-names.mjs +1 -1
  46. package/src/agent/tool-result.mjs +3 -3
  47. package/src/agent/tool-summary.mjs +112 -112
  48. package/src/agent/tools.mjs +58 -58
  49. package/src/agent/turn/turn-events.mjs +111 -111
  50. package/src/agent/turn/turn-logging.mjs +30 -30
  51. package/src/agent/turn/turn-runner.mjs +196 -196
  52. package/src/agent/vision-capability.mjs +14 -14
  53. package/src/auth/login-command.mjs +90 -90
  54. package/src/auth/storage.mjs +34 -34
  55. package/src/cli/args.mjs +96 -79
  56. package/src/cli/commands/copy-command.mjs +87 -87
  57. package/src/cli/commands/export-command.mjs +206 -206
  58. package/src/cli/commands/extensions-command.mjs +53 -53
  59. package/src/cli/commands/help-command.mjs +7 -7
  60. package/src/cli/commands/model-command.mjs +141 -141
  61. package/src/cli/commands/paste-image-command.mjs +43 -43
  62. package/src/cli/commands/provider-command.mjs +59 -59
  63. package/src/cli/commands/status-command.mjs +196 -194
  64. package/src/cli/commands/thinking-command.mjs +87 -87
  65. package/src/cli/fallback-ui.mjs +156 -156
  66. package/src/cli/input/attachment-tokens.mjs +20 -20
  67. package/src/cli/input/autocomplete.mjs +74 -74
  68. package/src/cli/input/external-editor.mjs +39 -39
  69. package/src/cli/input/file-search/index.mjs +160 -160
  70. package/src/cli/input/history-store.mjs +35 -35
  71. package/src/cli/input/image-clipboard.mjs +55 -55
  72. package/src/cli/input/keybinding-dispatch.mjs +76 -76
  73. package/src/cli/input/keybindings.mjs +96 -96
  74. package/src/cli/input/mode-state.mjs +43 -43
  75. package/src/cli/input/prompt-templates.mjs +84 -84
  76. package/src/cli/input/select-with-keyboard.mjs +86 -86
  77. package/src/cli/permissions.mjs +103 -103
  78. package/src/cli/repl-commands.mjs +86 -86
  79. package/src/cli/repl-loop.mjs +183 -183
  80. package/src/cli/selector-list.mjs +21 -21
  81. package/src/cli/session/pi-session-switch-command.mjs +41 -41
  82. package/src/cli/session/session-command.mjs +23 -23
  83. package/src/cli/session/session-list-command.mjs +68 -68
  84. package/src/cli/session/session-name-command.mjs +26 -26
  85. package/src/cli/session/session-source-command.mjs +89 -89
  86. package/src/cli/session/session-switch-command.mjs +1 -1
  87. package/src/cli/shell/shell-command.mjs +55 -55
  88. package/src/cli/shell/shell-drawer-controls.mjs +33 -33
  89. package/src/cli/shell/shell-drawer.mjs +192 -192
  90. package/src/cli/shell/shell-split-layout.mjs +70 -70
  91. package/src/cli/slash-commands.mjs +192 -192
  92. package/src/cli/startup/create-runtime-runner.mjs +61 -61
  93. package/src/cli/startup/runtime-close.mjs +23 -23
  94. package/src/cli/startup/startup-banner.mjs +71 -71
  95. package/src/cli/startup/startup-session.mjs +51 -51
  96. package/src/cli/status-line-updater.mjs +75 -75
  97. package/src/cli/tool-output.mjs +9 -9
  98. package/src/cli/tui/editor/external-editor-runner.mjs +24 -24
  99. package/src/cli/tui/input/mouse-selection-controller.mjs +91 -91
  100. package/src/cli/tui/input/mouse-tracking.mjs +20 -20
  101. package/src/cli/tui/layout/main-pane-layout.mjs +47 -47
  102. package/src/cli/tui/layout/safe-render-boundary.mjs +46 -46
  103. package/src/cli/tui/markdown-renderer.mjs +285 -285
  104. package/src/cli/tui/output/scroll-state.mjs +79 -79
  105. package/src/cli/tui/output/text-line-renderer.mjs +50 -50
  106. package/src/cli/tui/output/tool-card-renderer.mjs +59 -59
  107. package/src/cli/tui/output/visible-lines.mjs +8 -8
  108. package/src/cli/tui/output-buffer.mjs +293 -293
  109. package/src/cli/tui/permission-request-ui.mjs +18 -18
  110. package/src/cli/tui/recall-rendering.mjs +28 -25
  111. package/src/cli/tui/render/render-scheduler.mjs +26 -26
  112. package/src/cli/tui/render/stream-delta-buffer.mjs +46 -46
  113. package/src/cli/tui/select/editor-select-list.mjs +111 -111
  114. package/src/cli/tui/selection-screen.mjs +269 -269
  115. package/src/cli/tui/status/retry-status.mjs +72 -72
  116. package/src/cli/tui/status/spinner-status.mjs +42 -42
  117. package/src/cli/tui/status/status-bar.mjs +225 -225
  118. package/src/cli/tui/syntax/highlighting.mjs +260 -260
  119. package/src/cli/tui/syntax/languages.mjs +91 -91
  120. package/src/cli/tui/syntax/tree-sitter/bash.highlights.scm +261 -261
  121. package/src/cli/tui/syntax/tree-sitter/c.highlights.scm +341 -341
  122. package/src/cli/tui/syntax/tree-sitter/cpp.highlights.scm +268 -268
  123. package/src/cli/tui/syntax/tree-sitter/csharp.highlights.scm +577 -577
  124. package/src/cli/tui/syntax/tree-sitter/css.highlights.scm +109 -109
  125. package/src/cli/tui/syntax/tree-sitter/diff.highlights.scm +49 -49
  126. package/src/cli/tui/syntax/tree-sitter/go.highlights.scm +254 -254
  127. package/src/cli/tui/syntax/tree-sitter/html.highlights.scm +13 -13
  128. package/src/cli/tui/syntax/tree-sitter/java.highlights.scm +330 -330
  129. package/src/cli/tui/syntax/tree-sitter/json.highlights.scm +38 -38
  130. package/src/cli/tui/syntax/tree-sitter/php.highlights.scm +203 -203
  131. package/src/cli/tui/syntax/tree-sitter/python.highlights.scm +137 -137
  132. package/src/cli/tui/syntax/tree-sitter/ruby.highlights.scm +309 -309
  133. package/src/cli/tui/syntax/tree-sitter/rust.highlights.scm +531 -531
  134. package/src/cli/tui/syntax/tree-sitter/toml.highlights.scm +39 -39
  135. package/src/cli/tui/syntax/tree-sitter/tsx.highlights.scm +35 -35
  136. package/src/cli/tui/syntax/tree-sitter/typescript.highlights.scm +35 -35
  137. package/src/cli/tui/syntax/tree-sitter/yaml.highlights.scm +99 -99
  138. package/src/cli/tui/tool-rendering.mjs +87 -87
  139. package/src/cli/tui/tui-diff-rendering.mjs +157 -157
  140. package/src/cli/tui/tui-handlers.mjs +111 -111
  141. package/src/cli/tui/tui-input-controller.mjs +61 -61
  142. package/src/cli/tui/ui-theme.mjs +157 -157
  143. package/src/cli/ui.mjs +297 -297
  144. package/src/config/config-json.mjs +108 -84
  145. package/src/config/dotenv.mjs +20 -20
  146. package/src/config/features.mjs +75 -75
  147. package/src/config/loader.mjs +156 -143
  148. package/src/config/settings-command.mjs +97 -97
  149. package/src/context/engine.mjs +199 -198
  150. package/src/context/injections.mjs +26 -26
  151. package/src/context/profiles.mjs +39 -39
  152. package/src/context/project-context.mjs +20 -20
  153. package/src/context/session-status.mjs +25 -17
  154. package/src/context/shell-layers.mjs +23 -23
  155. package/src/context/system-core/base.md +50 -50
  156. package/src/context/system-core/prompts/deepseek-v4-pro.md +3 -3
  157. package/src/context/system-core/prompts/default.md +3 -3
  158. package/src/context/system-core.mjs +35 -35
  159. package/src/debug/logger.mjs +141 -141
  160. package/src/debug/model-context-dumper.mjs +52 -52
  161. package/src/extensions/discovery.mjs +40 -40
  162. package/src/extensions/lifecycle-adapter.mjs +210 -210
  163. package/src/extensions/lifecycle-manifest.mjs +69 -69
  164. package/src/image-gen/index.mjs +7 -7
  165. package/src/image-gen/provider.mjs +231 -231
  166. package/src/image-gen/tool.mjs +84 -84
  167. package/src/lsp/client.mjs +257 -257
  168. package/src/lsp/diagnostic-store.mjs +42 -42
  169. package/src/lsp/diagnostics-format.mjs +72 -72
  170. package/src/lsp/managed-node-server.mjs +99 -99
  171. package/src/lsp/path-match.mjs +10 -10
  172. package/src/lsp/server-definitions.mjs +188 -188
  173. package/src/lsp/servers.mjs +165 -165
  174. package/src/lsp/service.mjs +110 -110
  175. package/src/lsp/status-message.mjs +9 -9
  176. package/src/lsp/typescript-project-resolver.mjs +186 -186
  177. package/src/main.mjs +294 -299
  178. package/src/mcp/client.mjs +195 -195
  179. package/src/mcp/config.mjs +130 -130
  180. package/src/mcp/index.mjs +48 -48
  181. package/src/mcp/tools.mjs +98 -98
  182. package/src/memory/command.mjs +120 -0
  183. package/src/memory/markdown/markdown-delete.mjs +23 -23
  184. package/src/memory/markdown/markdown-format.mjs +128 -128
  185. package/src/memory/markdown/markdown-recall.mjs +28 -28
  186. package/src/memory/markdown/ripgrep.mjs +16 -16
  187. package/src/memory/markdown/sqlite-index.mjs +87 -87
  188. package/src/memory/markdown-store.mjs +272 -286
  189. package/src/memory/markdown-tools.mjs +174 -103
  190. package/src/memory/remote/client.mjs +68 -0
  191. package/src/memory/remote/config.mjs +52 -0
  192. package/src/memory/remote/server.mjs +99 -0
  193. package/src/memory/search.mjs +183 -0
  194. package/src/network/environment.mjs +131 -131
  195. package/src/notification/desktop-notifier.mjs +262 -262
  196. package/src/platform/open-file.mjs +28 -28
  197. package/src/platform/spawn-command.mjs +27 -27
  198. package/src/provider/accept-command.mjs +89 -89
  199. package/src/provider/command.mjs +21 -21
  200. package/src/provider/config-command.mjs +129 -129
  201. package/src/provider/custom-provider.mjs +113 -113
  202. package/src/provider/hosted-tools.mjs +111 -111
  203. package/src/provider/presets.mjs +72 -72
  204. package/src/provider/share-command.mjs +79 -79
  205. package/src/provider/share-payload.mjs +52 -52
  206. package/src/session/attachment-display.mjs +16 -16
  207. package/src/session/attachment-references.mjs +65 -65
  208. package/src/session/attachments.mjs +140 -140
  209. package/src/session/persist.mjs +1 -1
  210. package/src/session/pi-manager.mjs +34 -34
  211. package/src/session/session-utils.mjs +16 -16
  212. package/src/session/sidecar-sync.mjs +19 -19
  213. package/src/session/sidecar.mjs +69 -69
  214. package/src/session/transcript.mjs +83 -83
  215. package/src/session/tree.mjs +42 -42
  216. package/src/shell/cli-runtime.mjs +11 -11
  217. package/src/shell/hints.mjs +12 -12
  218. package/src/shell/node-pty-adapter.mjs +81 -81
  219. package/src/shell/runtime-state.mjs +126 -126
  220. package/src/shell/runtime.mjs +252 -252
  221. package/src/shell/screen-buffer.mjs +136 -136
  222. package/src/shell/tool-read.mjs +74 -74
  223. package/src/shell/tools.mjs +299 -299
  224. package/src/supergrok/actions/image-generate.mjs +60 -60
  225. package/src/supergrok/actions/search.mjs +78 -78
  226. package/src/supergrok/auth.mjs +36 -36
  227. package/src/supergrok/constants.mjs +18 -18
  228. package/src/supergrok/oauth-provider.mjs +278 -278
  229. package/src/supergrok/provider.mjs +35 -35
  230. package/src/supergrok/response.mjs +76 -76
  231. package/src/supergrok/tool.mjs +61 -61
  232. package/src/text/ansi.mjs +3 -3
  233. package/src/web/config-command.mjs +43 -43
  234. package/src/web/fetch.mjs +78 -78
  235. package/src/web/presets.mjs +16 -16
  236. package/src/web/search.mjs +83 -83
  237. package/src/web/tools.mjs +107 -107
@@ -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
+ }