@descix/platform-api 4.0.0 → 4.0.1

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.
@@ -0,0 +1,31 @@
1
+ /**
2
+ * @descix/platform-api/mcp-tools — the CLI VERB LIST (eabadir/DeSciXCloud#20, option B).
3
+ *
4
+ * cli-verbs.generated.json is GENERATED from the live commander tree of
5
+ * @descix/cli bin/descix.js by `npm run generate:cli-verbs` in descix-cli — never hand-edit it.
6
+ * One entry per runnable verb, sorted by verbPath:
7
+ * { verbPath, description, arguments[{name, required, variadic, description}],
8
+ * options[{flags, description, required}], runbookAnchor }
9
+ * runbookAnchor is the app-developer runbook heading anchor ('#_5-run-it-locally-descix-serve')
10
+ * declared beside the verb's definition, or null when the runbook has no section for it.
11
+ * descix-cli/tests/cli-verbs-generated.test.js fails when this file is stale or an anchor names
12
+ * no runbook heading. Consumer: DeSciX_Cloud tell_me_how (the cli_verbs section).
13
+ *
14
+ * RUNBOOK_URL is the ONE spelling of the published app-developer runbook page; a runbookAnchor is a
15
+ * fragment of it (RUNBOOK_URL + runbookAnchor is the section link). descix-cli/tests/
16
+ * runbook-url-owner.test.js fails when templates/agent-claude.md spells the page differently.
17
+ */
18
+ import VERBS from './cli-verbs.generated.json' with { type: 'json' };
19
+
20
+ function deepFreeze(value) {
21
+ if (value && typeof value === 'object') {
22
+ for (const v of Object.values(value)) deepFreeze(v);
23
+ Object.freeze(value);
24
+ }
25
+ return value;
26
+ }
27
+
28
+ export const RUNBOOK_URL = 'https://descix.net/prod/daita-docs/site/app-sdk/app-developer-runbook.html';
29
+
30
+ /** @type {ReadonlyArray<{verbPath: string, description: string, arguments: object[], options: object[], runbookAnchor: string|null}>} */
31
+ export const CLI_VERBS = deepFreeze(VERBS);
@@ -43,6 +43,9 @@ export {
43
43
  PLATFORM_BASICS_SUMMARY,
44
44
  PLATFORM_BASICS_DOC,
45
45
  } from './platform-basics.js';
46
+ // eabadir/DeSciXCloud#20 (option B) — the CLI verb list, GENERATED from the live commander tree
47
+ // of @descix/cli (descix-cli: npm run generate:cli-verbs). Cloud tell_me_how consumes it.
48
+ export { CLI_VERBS, RUNBOOK_URL } from './cli-verbs.js';
46
49
  // ws-chat-multimodal-image-attach — THE canonical media-on-a-chat-turn contract: kinds, MIME
47
50
  // vocabulary, byte policy, normalize(partial)->bag, and the ONE provider-block encoder. Both
48
51
  // the Cloud chat pipeline and the advertised nativeTools schema consume this; nobody