@descix/platform-api 4.0.0 → 5.0.0
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.
- package/package.json +1 -1
- package/src/email/index.js +0 -135
- package/src/index.js +0 -2
- package/src/mcp-tools/cli-verbs.generated.json +2039 -0
- package/src/mcp-tools/cli-verbs.js +31 -0
- package/src/mcp-tools/index.js +3 -0
- package/src/mcp-tools/nativeTools.js +1 -1
- package/src/mcp-tools/setup-playbook.js +1 -1
|
@@ -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);
|
package/src/mcp-tools/index.js
CHANGED
|
@@ -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
|
|
@@ -799,7 +799,7 @@ export const NATIVE_MCP_TOOLS = Object.freeze([
|
|
|
799
799
|
// Read-only; the METERED RAG/agent surface (WS-A3) debits this balance per call.
|
|
800
800
|
// NEVER exposes pricing internals — USD balance figures only.
|
|
801
801
|
name: 'get_credit_balance',
|
|
802
|
-
description: 'Get your platform-wide AI-credits balance in USD. Metered AI calls (RAG chat / agents, e.g. ask_question_to_app and query_knowledge_base) debit this balance. At a $0 balance a free daily credit auto-applies to your first metered call each day, so metered tools are usable without buying anything first (the response reports daily_free_credit_usd and daily_free_credit_available_today). Buy more credits with the descix CLI (`descix credits buy
|
|
802
|
+
description: 'Get your platform-wide AI-credits balance in USD. Metered AI calls (RAG chat / agents, e.g. ask_question_to_app and query_knowledge_base) debit this balance. At a $0 balance a free daily credit auto-applies to your first metered call each day, so metered tools are usable without buying anything first (the response reports daily_free_credit_usd and daily_free_credit_available_today). Buy more credits in the Powch Buy menu or with the descix CLI (`descix credits buy --usd <amount>`). Programmatic purchase: the Powch command create_checkout_session (through execute_remote_command) with purchase_type "ai_credits" and amount_usd (a listed bundle from purchase_catalogue in this response) returns a Stripe Checkout url.',
|
|
803
803
|
mutating: false,
|
|
804
804
|
oauthReadonly: true,
|
|
805
805
|
inputSchema: {
|
|
@@ -109,7 +109,7 @@ const FIRST_CONTACT_SCRIPT = Object.freeze([
|
|
|
109
109
|
// starting contribution/airdrop-eligibility position finishing setup confers. Dollar figures are
|
|
110
110
|
// the current launch values (config-driven server-side: PATRONAGE_SETUP_BONUS_USD /
|
|
111
111
|
// SPONSORED_CREDITS_USER_DAILY_CAP_USD) — named here as the current amounts, not authoritative.
|
|
112
|
-
do: 'Now explain the tokenomics model: metering is the default for platform AI services, exactly like the Claude API itself. RAG calls draw on a shared USD AI-credit balance by actual usage; get_credit_balance shows the balance any time (and whether today\'s free daily credit is still available), and credits can be bought with the descix CLI
|
|
112
|
+
do: 'Now explain the tokenomics model: metering is the default for platform AI services, exactly like the Claude API itself. RAG calls draw on a shared USD AI-credit balance by actual usage; get_credit_balance shows the balance any time (and whether today\'s free daily credit is still available), and credits can be bought in the Powch Buy menu or with the descix CLI (`descix credits buy`). Two distinct things keep first contact free — keep them separate: (1) a ONE-TIME welcome credit (currently $10) is added to your balance when you finish this setup — a grant to explore with, NOT earned and NOT a community token; (2) SEPARATELY, a free daily credit (currently $10/day) auto-applies to your first metered call each day and renews every day. Earning is different again: contributions, disputatio participation, and airdrops can earn community tokens — and finishing setup also gives you a small starting contribution position, so you land already eligible to accrue toward airdrops (claiming a community\'s airdrop still needs that community\'s membership). Setup is where this is explained once — the tools themselves do not nag about cost.',
|
|
113
113
|
}),
|
|
114
114
|
Object.freeze({
|
|
115
115
|
step: 'verify_settlement',
|