@wowok/agent-mcp 2.7.1 → 2.7.2
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/dist/config/index.js +1 -1
- package/dist/config/runtime.js +1 -238
- package/dist/customer/customer-advice.js +1 -130
- package/dist/customer/index.js +1 -11
- package/dist/customer/industry-risks.js +1 -438
- package/dist/customer/info-puzzle.js +1 -681
- package/dist/customer/order-monitor.js +1 -328
- package/dist/customer/order-strategy.js +1 -373
- package/dist/customer/post-purchase.js +1 -351
- package/dist/customer/preorder-compare.js +1 -34
- package/dist/customer/reminder-system.js +1 -316
- package/dist/customer/risk-assessment.js +1 -397
- package/dist/customer/types.js +1 -13
- package/dist/customer/user-preferences.js +1 -460
- package/dist/evaluation/arbitration-game.d.ts +9 -2
- package/dist/evaluation/arbitration-game.js +1 -48
- package/dist/evaluation/builtins/demand-match.js +1 -153
- package/dist/evaluation/builtins/index.js +1 -10
- package/dist/evaluation/builtins/service-risk.js +1 -55
- package/dist/evaluation/capability.js +1 -13
- package/dist/evaluation/composer.js +1 -40
- package/dist/evaluation/engine.js +1 -175
- package/dist/evaluation/extract.js +1 -115
- package/dist/evaluation/game-strategy.d.ts +27 -0
- package/dist/evaluation/game-strategy.js +1 -0
- package/dist/evaluation/gap.js +1 -100
- package/dist/evaluation/index.d.ts +1 -0
- package/dist/evaluation/index.js +1 -11
- package/dist/evaluation/node-game.d.ts +31 -3
- package/dist/evaluation/node-game.js +1 -57
- package/dist/evaluation/region.js +1 -36
- package/dist/evaluation/types.d.ts +1 -0
- package/dist/evaluation/types.js +1 -1
- package/dist/evaluation/user-injection.js +1 -27
- package/dist/experience/experience-reuse.js +1 -103
- package/dist/experience/index.js +1 -5
- package/dist/experience/intent-distill.js +1 -83
- package/dist/experience/realtime-feedback.js +1 -94
- package/dist/experience/types.js +1 -1
- package/dist/experience/user-profile.js +1 -171
- package/dist/extensions/business-modules.js +1 -287
- package/dist/extensions/capability-manifest.js +1 -781
- package/dist/extensions/constraint-registry.js +1 -198
- package/dist/extensions/index.js +1 -6
- package/dist/extensions/metric-registry.js +1 -257
- package/dist/extensions/mode-evaluator.js +1 -170
- package/dist/extensions/modes.js +1 -499
- package/dist/extensions/registry.js +1 -717
- package/dist/extensions/types.js +1 -1
- package/dist/harness/auto-escalation.js +1 -68
- package/dist/harness/checkpoint.js +1 -129
- package/dist/harness/index.js +1 -78
- package/dist/harness/plan.js +1 -315
- package/dist/harness/recover.js +1 -139
- package/dist/harness/types.js +1 -1
- package/dist/harness/verify.js +1 -237
- package/dist/index.js +1 -273
- package/dist/intent/enrich.js +1 -67
- package/dist/intent/index.js +1 -60
- package/dist/intent/matcher.js +1 -81
- package/dist/intent/store.js +1 -55
- package/dist/intent/types.js +1 -10
- package/dist/knowledge/acquisition-flywheel.js +1 -192
- package/dist/knowledge/allocation-confirm.js +1 -534
- package/dist/knowledge/allocation-context.js +1 -249
- package/dist/knowledge/allocation-ledger.js +1 -463
- package/dist/knowledge/allocation-puzzle.js +1 -298
- package/dist/knowledge/allocation-risk.js +1 -568
- package/dist/knowledge/allocation-templates.js +1 -970
- package/dist/knowledge/allocation-translation.js +1 -585
- package/dist/knowledge/arb-risk.js +1 -210
- package/dist/knowledge/arbitration-confirm.js +1 -559
- package/dist/knowledge/arbitration-context.js +1 -505
- package/dist/knowledge/arbitration-ledger.js +1 -521
- package/dist/knowledge/arbitration-puzzle.js +1 -304
- package/dist/knowledge/arbitration-risk.js +1 -423
- package/dist/knowledge/arbitration-templates.js +1 -276
- package/dist/knowledge/arbitration-translation.js +1 -487
- package/dist/knowledge/arbitration-trust.js +1 -117
- package/dist/knowledge/audit-rules.js +1 -141
- package/dist/knowledge/bridge-risk.js +1 -263
- package/dist/knowledge/contact-risk.js +1 -200
- package/dist/knowledge/contact-templates.js +1 -60
- package/dist/knowledge/demand-confirm.js +1 -206
- package/dist/knowledge/demand-matching.js +1 -132
- package/dist/knowledge/demand-risk.js +1 -240
- package/dist/knowledge/demand-translation.js +1 -354
- package/dist/knowledge/deployment-scanner.js +1 -823
- package/dist/knowledge/dynamic-pricing.js +1 -87
- package/dist/knowledge/examples-scanner-cli.js +1 -26
- package/dist/knowledge/examples-scanner.js +1 -843
- package/dist/knowledge/flywheel-loop.js +1 -404
- package/dist/knowledge/fund-layer.js +1 -973
- package/dist/knowledge/glossary.js +1 -211
- package/dist/knowledge/guard-confirm.js +1 -406
- package/dist/knowledge/guard-context.js +1 -287
- package/dist/knowledge/guard-design-patterns.js +1 -360
- package/dist/knowledge/guard-ledger.js +1 -260
- package/dist/knowledge/guard-lint.js +1 -670
- package/dist/knowledge/guard-migration.js +1 -228
- package/dist/knowledge/guard-puzzle.js +1 -805
- package/dist/knowledge/guard-render.js +1 -700
- package/dist/knowledge/guard-risk.js +1 -1879
- package/dist/knowledge/guard-submission-prompt.js +1 -171
- package/dist/knowledge/guard-templates.js +1 -1105
- package/dist/knowledge/guard-translation.js +1 -1119
- package/dist/knowledge/index.js +1 -436
- package/dist/knowledge/industry-evolution.js +1 -323
- package/dist/knowledge/industry-generalizer.js +1 -381
- package/dist/knowledge/industry-registry.js +1 -174
- package/dist/knowledge/intent-metrics.d.ts +4 -3
- package/dist/knowledge/intent-metrics.js +1 -566
- package/dist/knowledge/machine-confirm.js +1 -559
- package/dist/knowledge/machine-context.js +1 -833
- package/dist/knowledge/machine-ledger.js +1 -338
- package/dist/knowledge/machine-puzzle.js +1 -494
- package/dist/knowledge/machine-render.js +1 -565
- package/dist/knowledge/machine-risk.js +1 -669
- package/dist/knowledge/machine-templates.js +1 -1597
- package/dist/knowledge/machine-topology.js +1 -234
- package/dist/knowledge/machine-translation.js +1 -513
- package/dist/knowledge/mcp-schema-audit-cli.js +1 -45
- package/dist/knowledge/mcp-schema-audit.js +1 -777
- package/dist/knowledge/onchain-constants.js +1 -35
- package/dist/knowledge/order-confirm.js +1 -573
- package/dist/knowledge/order-context.js +1 -390
- package/dist/knowledge/order-ledger.js +1 -341
- package/dist/knowledge/order-puzzle.js +1 -255
- package/dist/knowledge/order-risk.js +1 -653
- package/dist/knowledge/order-templates.js +1 -368
- package/dist/knowledge/order-translation.js +1 -550
- package/dist/knowledge/overrides-loader.js +1 -65
- package/dist/knowledge/passport-confirm.js +1 -531
- package/dist/knowledge/passport-context.js +1 -306
- package/dist/knowledge/passport-ledger.js +1 -282
- package/dist/knowledge/passport-puzzle.js +1 -333
- package/dist/knowledge/passport-risk.js +1 -450
- package/dist/knowledge/passport-templates.js +1 -568
- package/dist/knowledge/passport-translation.js +1 -516
- package/dist/knowledge/payment-risk.js +1 -249
- package/dist/knowledge/permission-confirm.js +1 -426
- package/dist/knowledge/permission-context.js +1 -224
- package/dist/knowledge/permission-ledger.js +1 -403
- package/dist/knowledge/permission-puzzle.js +1 -173
- package/dist/knowledge/permission-risk.js +1 -411
- package/dist/knowledge/permission-templates.js +1 -234
- package/dist/knowledge/permission-translation.js +1 -350
- package/dist/knowledge/personal-risk.js +1 -212
- package/dist/knowledge/process-model.js +1 -160
- package/dist/knowledge/progress-confirm.js +1 -456
- package/dist/knowledge/progress-context.js +1 -452
- package/dist/knowledge/progress-ledger.js +1 -330
- package/dist/knowledge/progress-puzzle.js +1 -219
- package/dist/knowledge/progress-risk.js +1 -461
- package/dist/knowledge/progress-templates.js +1 -228
- package/dist/knowledge/progress-translation.js +1 -405
- package/dist/knowledge/proof-confirm.js +1 -187
- package/dist/knowledge/proof-risk.js +1 -207
- package/dist/knowledge/proof-translation.js +1 -283
- package/dist/knowledge/registrar-risk.js +1 -217
- package/dist/knowledge/repository-confirm.js +1 -286
- package/dist/knowledge/repository-risk.js +1 -373
- package/dist/knowledge/repository-translation.js +1 -445
- package/dist/knowledge/reputation-rules.js +1 -99
- package/dist/knowledge/resource-risk.js +1 -157
- package/dist/knowledge/reward-confirm.js +1 -526
- package/dist/knowledge/reward-context.js +1 -504
- package/dist/knowledge/reward-ledger.js +1 -502
- package/dist/knowledge/reward-puzzle.js +1 -300
- package/dist/knowledge/reward-risk.js +1 -627
- package/dist/knowledge/reward-templates.js +1 -197
- package/dist/knowledge/reward-translation.js +1 -501
- package/dist/knowledge/safety-rules.js +1 -404
- package/dist/knowledge/scenario-modes.js +1 -321
- package/dist/knowledge/service-confirm.js +1 -807
- package/dist/knowledge/service-context.js +1 -403
- package/dist/knowledge/service-ledger.js +1 -609
- package/dist/knowledge/service-puzzle.js +1 -236
- package/dist/knowledge/service-risk.js +1 -651
- package/dist/knowledge/service-templates.js +1 -456
- package/dist/knowledge/service-translation.js +1 -622
- package/dist/knowledge/template-registry.js +1 -353
- package/dist/knowledge/tool-constraints.js +1 -195
- package/dist/knowledge/tools-reference.js +1 -178
- package/dist/knowledge/treasury-confirm.js +1 -512
- package/dist/knowledge/treasury-context.js +1 -363
- package/dist/knowledge/treasury-ledger.js +1 -300
- package/dist/knowledge/treasury-puzzle.js +1 -216
- package/dist/knowledge/treasury-risk.js +1 -440
- package/dist/knowledge/treasury-templates.js +1 -358
- package/dist/knowledge/treasury-translation.js +1 -498
- package/dist/knowledge/trust-metrics.js +1 -198
- package/dist/knowledge/util-risk.js +1 -135
- package/dist/loop-engineering/aggregate.js +1 -132
- package/dist/loop-engineering/context-collect.js +1 -83
- package/dist/loop-engineering/diagnose.js +1 -273
- package/dist/loop-engineering/improve.js +1 -405
- package/dist/loop-engineering/index.js +1 -4
- package/dist/loop-engineering/pipeline.js +1 -56
- package/dist/mode-market/index.js +1 -3
- package/dist/mode-market/registry.js +1 -124
- package/dist/mode-market/review.js +1 -214
- package/dist/mode-market/submission.js +1 -85
- package/dist/participation/collaborator-interest.d.ts +23 -0
- package/dist/participation/collaborator-interest.js +1 -0
- package/dist/participation/customer-interest.d.ts +25 -0
- package/dist/participation/customer-interest.js +1 -0
- package/dist/participation/merchant-interest.js +1 -100
- package/dist/participation/radar-core.d.ts +13 -3
- package/dist/participation/radar-core.js +1 -269
- package/dist/participation/supplier-interest.d.ts +25 -0
- package/dist/participation/supplier-interest.js +1 -0
- package/dist/persona/analyzer.js +1 -66
- package/dist/persona/bridge.js +1 -86
- package/dist/persona/defaults.js +1 -195
- package/dist/persona/experience-bridge.js +1 -23
- package/dist/persona/index.js +1 -71
- package/dist/persona/model.js +1 -111
- package/dist/persona/store.js +1 -62
- package/dist/persona/types.d.ts +3 -1
- package/dist/persona/types.js +1 -5
- package/dist/project/business-puzzle.js +1 -383
- package/dist/project/context-assembly.js +1 -254
- package/dist/project/deployment-bridge.js +1 -120
- package/dist/project/deployment-doc.js +1 -1126
- package/dist/project/edit-planner.js +1 -1342
- package/dist/project/evaluation.js +1 -2011
- package/dist/project/game-theory.js +1 -177
- package/dist/project/graph-builder.js +1 -656
- package/dist/project/graph.js +1 -340
- package/dist/project/handlers.js +1 -1784
- package/dist/project/index.d.ts +1 -0
- package/dist/project/index.js +1 -301
- package/dist/project/intent-analyzer.js +1 -149
- package/dist/project/machine-nodes.js +1 -36
- package/dist/project/merchant-guide.js +1 -264
- package/dist/project/migration.js +1 -125
- package/dist/project/mode-actions.js +1 -309
- package/dist/project/namespace.js +1 -206
- package/dist/project/participation-radar.js +1 -428
- package/dist/project/pipeline-actions.js +1 -109
- package/dist/project/project-store.js +1 -422
- package/dist/project/query.js +1 -153
- package/dist/project/reverse-mapping.d.ts +34 -0
- package/dist/project/reverse-mapping.js +1 -0
- package/dist/project/risk-aggregator.js +1 -295
- package/dist/project/rollback-policy.js +1 -290
- package/dist/project/semantic-assembler.js +1 -345
- package/dist/project/semantic-graph.js +1 -292
- package/dist/project/stage-gate.js +1 -369
- package/dist/project/substep-trace.js +1 -332
- package/dist/project/task-tracker.js +1 -78
- package/dist/role/derivation.d.ts +18 -0
- package/dist/role/derivation.js +1 -0
- package/dist/role/index.d.ts +5 -0
- package/dist/role/index.js +1 -0
- package/dist/role/model.d.ts +8 -0
- package/dist/role/model.js +1 -0
- package/dist/role/resolution.d.ts +11 -0
- package/dist/role/resolution.js +1 -0
- package/dist/role/types.d.ts +11 -0
- package/dist/role/types.js +1 -0
- package/dist/rules.js +1 -52
- package/dist/safety/confirm-gate.js +1 -88
- package/dist/safety/index.js +1 -3
- package/dist/safety/preview.js +1 -52
- package/dist/schema/call/allocation.js +1 -34
- package/dist/schema/call/arbitration.js +1 -113
- package/dist/schema/call/base.d.ts +15 -15
- package/dist/schema/call/base.js +1 -370
- package/dist/schema/call/bridge-handler.js +1 -265
- package/dist/schema/call/bridge.d.ts +7 -7
- package/dist/schema/call/bridge.js +1 -458
- package/dist/schema/call/contact.js +1 -37
- package/dist/schema/call/demand.js +1 -47
- package/dist/schema/call/guard.js +1 -161
- package/dist/schema/call/handler.js +1 -322
- package/dist/schema/call/index.js +1 -20
- package/dist/schema/call/machine.js +1 -193
- package/dist/schema/call/order.js +1 -35
- package/dist/schema/call/payment.js +1 -37
- package/dist/schema/call/permission-handler.js +1 -54
- package/dist/schema/call/permission.js +1 -105
- package/dist/schema/call/personal.js +1 -78
- package/dist/schema/call/progress.js +1 -47
- package/dist/schema/call/proof.js +1 -33
- package/dist/schema/call/repository.js +1 -77
- package/dist/schema/call/reward.js +1 -30
- package/dist/schema/call/semantic.js +1 -1679
- package/dist/schema/call/service.js +1 -184
- package/dist/schema/call/treasury.js +1 -71
- package/dist/schema/common/index.js +1 -407
- package/dist/schema/config/index.js +1 -68
- package/dist/schema/evaluation/index.d.ts +213 -16
- package/dist/schema/evaluation/index.js +1 -356
- package/dist/schema/index.js +1 -17
- package/dist/schema/intent-radar/index.d.ts +13 -13
- package/dist/schema/intent-radar/index.js +1 -89
- package/dist/schema/local/index.d.ts +21 -21
- package/dist/schema/local/index.js +1 -927
- package/dist/schema/local/wip.js +1 -187
- package/dist/schema/messenger/index.d.ts +7 -7
- package/dist/schema/messenger/index.js +1 -475
- package/dist/schema/operations.d.ts +7 -7
- package/dist/schema/operations.js +1 -520
- package/dist/schema/persona/index.d.ts +54 -54
- package/dist/schema/persona/index.js +1 -148
- package/dist/schema/project/index.d.ts +94 -48
- package/dist/schema/project/index.js +1 -2057
- package/dist/schema/query/index.d.ts +423 -7
- package/dist/schema/query/index.js +1 -1646
- package/dist/schema/schema-query/index.js +1 -104
- package/dist/schema/schema-version.js +1 -76
- package/dist/schema/sync-layer4.js +1 -286
- package/dist/schema/task-status.js +1 -36
- package/dist/schema/trust/index.js +1 -314
- package/dist/schema/utils/guard-parser.js +1 -419
- package/dist/schema/utils/guard-query-utils.js +1 -46
- package/dist/schema/utils/node-parser.js +1 -369
- package/dist/schema/utils/object-type-utils.js +1 -35
- package/dist/schema/utils/permission-index-utils.js +1 -7
- package/dist/schema/utils/permission-machine-check.js +1 -121
- package/dist/schema/utils/skills-recommendation.js +1 -77
- package/dist/schema-query/index.js +1 -810
- package/dist/schemas/account_operation.output.json +5 -2
- package/dist/schemas/bridge_operation.output.json +5 -2
- package/dist/schemas/evaluation_operation.output.json +112 -7
- package/dist/schemas/evaluation_operation.schema.json +93 -6
- package/dist/schemas/index.json +1 -1
- package/dist/schemas/intent_radar.output.json +4 -1
- package/dist/schemas/intent_radar.schema.json +4 -1
- package/dist/schemas/local_info_operation.output.json +5 -2
- package/dist/schemas/local_mark_operation.output.json +5 -2
- package/dist/schemas/messenger_operation.output.json +5 -2
- package/dist/schemas/onchain_events.output.json +5 -2
- package/dist/schemas/onchain_operations.output.json +5 -2
- package/dist/schemas/onchain_operations.schema.json +4 -4
- package/dist/schemas/onchain_operations_allocation.schema.json +1 -1
- package/dist/schemas/onchain_operations_machine.schema.json +2 -2
- package/dist/schemas/onchain_operations_service.schema.json +1 -1
- package/dist/schemas/onchain_table_data.output.json +6 -3
- package/dist/schemas/persona_operation.output.json +4 -1
- package/dist/schemas/persona_operation.schema.json +4 -1
- package/dist/schemas/project_operation.output.json +28 -8
- package/dist/schemas/query_toolkit.output.json +8 -5
- package/dist/schemas/wowok_buildin_info.output.json +132 -0
- package/dist/schemas/wowok_buildin_info.schema.json +14 -0
- package/dist/telemetry/index.js +1 -112
- package/dist/telemetry/redact.js +1 -23
- package/dist/telemetry/storage.js +1 -80
- package/dist/tools/handlers/bridge.js +1 -1
- package/dist/tools/handlers/config.js +1 -74
- package/dist/tools/handlers/evaluation.js +1 -123
- package/dist/tools/handlers/file-export.js +1 -90
- package/dist/tools/handlers/intent-radar.js +1 -76
- package/dist/tools/handlers/local.js +1 -53
- package/dist/tools/handlers/messenger.js +1 -188
- package/dist/tools/handlers/onchain.js +1 -1180
- package/dist/tools/handlers/persona.js +1 -89
- package/dist/tools/handlers/project.js +1 -211
- package/dist/tools/handlers/query.js +1 -434
- package/dist/tools/handlers/schema-query.js +1 -176
- package/dist/tools/handlers/task-status.js +1 -26
- package/dist/tools/handlers/trust.js +1 -380
- package/dist/tools/handlers/wip.js +1 -90
- package/dist/tools/index.js +1 -1382
- package/dist/tools/retry.js +1 -85
- package/dist/tools/rules-hook.js +1 -23
- package/dist/tools/shared.js +1 -130
- package/dist/tools/types.js +1 -1
- package/dist/tools/upgrade-check.d.ts +19 -0
- package/dist/tools/upgrade-check.js +1 -0
- package/dist/tools/wip-deploy-assist.js +1 -306
- package/dist/tools/wrap.js +1 -500
- package/package.json +4 -2
|
@@ -1,810 +1 @@
|
|
|
1
|
-
import { readFileSync, existsSync, writeFileSync, mkdirSync, readdirSync } from "fs";
|
|
2
|
-
import { resolve, join, dirname } from "path";
|
|
3
|
-
import { fileURLToPath } from "url";
|
|
4
|
-
import { TOOLS_REFERENCE, getToolReference, searchToolReference, getToolSequence, } from "../knowledge/tools-reference.js";
|
|
5
|
-
import { GUARD_DESIGN_PATTERNS, getGuardDesignPattern, GUARD_DESIGN_PATTERNS_VERSION, } from "../knowledge/guard-design-patterns.js";
|
|
6
|
-
import { OBJECT_REUSE_RULES, CREATE_VS_MODIFY_PATTERN, IMMUTABILITY_RULES, OPERATION_TYPE_CLASSIFICATION, OPERATION_CLASS_META, NAMING_CONVENTIONS, SAFETY_RULES_VERSION, } from "../knowledge/safety-rules.js";
|
|
7
|
-
import { listTemplates as listRegistryTemplates, getTemplateDetail, instantiateTemplate, getTemplateCounts, TEMPLATE_OBJECT_TYPES, } from "../knowledge/template-registry.js";
|
|
8
|
-
const __filename = fileURLToPath(import.meta.url);
|
|
9
|
-
const __dirname = fileURLToPath(new URL(".", import.meta.url));
|
|
10
|
-
const SCHEMAS_DIR = resolve(__dirname, "../../dist/schemas");
|
|
11
|
-
const GUARD_TEMPLATES_PATH_SCRIPTS = resolve(__dirname, "../../scripts/guard-templates.json");
|
|
12
|
-
const GUARD_TEMPLATES_PATH_DIST = resolve(__dirname, "../../dist/schemas/guard-templates.json");
|
|
13
|
-
const GUARD_TEMPLATES_PATH = existsSync(GUARD_TEMPLATES_PATH_SCRIPTS)
|
|
14
|
-
? GUARD_TEMPLATES_PATH_SCRIPTS
|
|
15
|
-
: GUARD_TEMPLATES_PATH_DIST;
|
|
16
|
-
const EXAMPLES_DIR_SCRIPTS = resolve(__dirname, "../../scripts/examples");
|
|
17
|
-
const EXAMPLES_DIR_DIST = resolve(__dirname, "../examples");
|
|
18
|
-
export const EXAMPLES_DIR = existsSync(EXAMPLES_DIR_SCRIPTS)
|
|
19
|
-
? EXAMPLES_DIR_SCRIPTS
|
|
20
|
-
: EXAMPLES_DIR_DIST;
|
|
21
|
-
const WORKSPACE_TMP_DIR = resolve(process.cwd(), ".trae", "tmp");
|
|
22
|
-
export function areSchemasAvailable() {
|
|
23
|
-
return existsSync(SCHEMAS_DIR) && existsSync(join(SCHEMAS_DIR, "index.json"));
|
|
24
|
-
}
|
|
25
|
-
export function getSchemaIndex() {
|
|
26
|
-
try {
|
|
27
|
-
const indexPath = join(SCHEMAS_DIR, "index.json");
|
|
28
|
-
if (!existsSync(indexPath))
|
|
29
|
-
return null;
|
|
30
|
-
const content = readFileSync(indexPath, "utf-8");
|
|
31
|
-
return JSON.parse(content);
|
|
32
|
-
}
|
|
33
|
-
catch {
|
|
34
|
-
return null;
|
|
35
|
-
}
|
|
36
|
-
}
|
|
37
|
-
export function listSchemas() {
|
|
38
|
-
const index = getSchemaIndex();
|
|
39
|
-
if (!index)
|
|
40
|
-
return [];
|
|
41
|
-
return [
|
|
42
|
-
...(index.tools || []),
|
|
43
|
-
...(index.operations || []),
|
|
44
|
-
];
|
|
45
|
-
}
|
|
46
|
-
export function getSchema(name) {
|
|
47
|
-
try {
|
|
48
|
-
let schemaPath = join(SCHEMAS_DIR, `${name}.schema.json`);
|
|
49
|
-
if (!existsSync(schemaPath)) {
|
|
50
|
-
schemaPath = join(SCHEMAS_DIR, `${name}.json`);
|
|
51
|
-
}
|
|
52
|
-
if (!existsSync(schemaPath)) {
|
|
53
|
-
return null;
|
|
54
|
-
}
|
|
55
|
-
const content = readFileSync(schemaPath, "utf-8");
|
|
56
|
-
const schema = JSON.parse(content);
|
|
57
|
-
return resolveSchemaRefs(schema);
|
|
58
|
-
}
|
|
59
|
-
catch {
|
|
60
|
-
return null;
|
|
61
|
-
}
|
|
62
|
-
}
|
|
63
|
-
export function getOutputSchema(name) {
|
|
64
|
-
try {
|
|
65
|
-
const schemaPath = join(SCHEMAS_DIR, `${name}.output.json`);
|
|
66
|
-
if (!existsSync(schemaPath)) {
|
|
67
|
-
return null;
|
|
68
|
-
}
|
|
69
|
-
const content = readFileSync(schemaPath, "utf-8");
|
|
70
|
-
const schema = JSON.parse(content);
|
|
71
|
-
return resolveSchemaRefs(schema);
|
|
72
|
-
}
|
|
73
|
-
catch {
|
|
74
|
-
return null;
|
|
75
|
-
}
|
|
76
|
-
}
|
|
77
|
-
export function getGuardTemplates(templateName) {
|
|
78
|
-
try {
|
|
79
|
-
if (!existsSync(GUARD_TEMPLATES_PATH)) {
|
|
80
|
-
return null;
|
|
81
|
-
}
|
|
82
|
-
const content = readFileSync(GUARD_TEMPLATES_PATH, "utf-8");
|
|
83
|
-
const catalog = JSON.parse(content);
|
|
84
|
-
if (!templateName) {
|
|
85
|
-
return {
|
|
86
|
-
version: catalog.version,
|
|
87
|
-
description: catalog.description,
|
|
88
|
-
templates: (catalog.templates || []).map((t) => ({
|
|
89
|
-
name: t.name,
|
|
90
|
-
title: t.title,
|
|
91
|
-
description: t.description,
|
|
92
|
-
use_case: t.use_case,
|
|
93
|
-
})),
|
|
94
|
-
query_reference: catalog.query_reference,
|
|
95
|
-
node_return_types: catalog.node_return_types,
|
|
96
|
-
};
|
|
97
|
-
}
|
|
98
|
-
const template = (catalog.templates || []).find((t) => t.name === templateName);
|
|
99
|
-
if (!template) {
|
|
100
|
-
return null;
|
|
101
|
-
}
|
|
102
|
-
return template;
|
|
103
|
-
}
|
|
104
|
-
catch {
|
|
105
|
-
return null;
|
|
106
|
-
}
|
|
107
|
-
}
|
|
108
|
-
export function searchExamples(query) {
|
|
109
|
-
if (!existsSync(EXAMPLES_DIR)) {
|
|
110
|
-
return [];
|
|
111
|
-
}
|
|
112
|
-
let files;
|
|
113
|
-
try {
|
|
114
|
-
files = readdirSync(EXAMPLES_DIR);
|
|
115
|
-
}
|
|
116
|
-
catch {
|
|
117
|
-
return [];
|
|
118
|
-
}
|
|
119
|
-
const lowerQuery = query.toLowerCase().trim();
|
|
120
|
-
if (!lowerQuery) {
|
|
121
|
-
return [];
|
|
122
|
-
}
|
|
123
|
-
const results = [];
|
|
124
|
-
for (const file of files) {
|
|
125
|
-
if (!file.endsWith(".json"))
|
|
126
|
-
continue;
|
|
127
|
-
const filePath = join(EXAMPLES_DIR, file);
|
|
128
|
-
try {
|
|
129
|
-
const content = readFileSync(filePath, "utf-8");
|
|
130
|
-
const example = JSON.parse(content);
|
|
131
|
-
const title = String(example.title ?? "");
|
|
132
|
-
const description = String(example.description ?? "");
|
|
133
|
-
const tags = Array.isArray(example.tags) ? example.tags.map((t) => String(t)) : [];
|
|
134
|
-
const operationType = String(example.operation_type ?? "");
|
|
135
|
-
const industry = String(example.industry ?? "");
|
|
136
|
-
const matchedFields = [];
|
|
137
|
-
if (title.toLowerCase().includes(lowerQuery)) {
|
|
138
|
-
matchedFields.push("title");
|
|
139
|
-
}
|
|
140
|
-
if (description.toLowerCase().includes(lowerQuery)) {
|
|
141
|
-
matchedFields.push("description");
|
|
142
|
-
}
|
|
143
|
-
if (tags.some((t) => t.toLowerCase() === lowerQuery)) {
|
|
144
|
-
matchedFields.push("tags");
|
|
145
|
-
}
|
|
146
|
-
if (operationType && operationType.toLowerCase() === lowerQuery) {
|
|
147
|
-
matchedFields.push("operation_type");
|
|
148
|
-
}
|
|
149
|
-
if (industry && industry.toLowerCase() === lowerQuery) {
|
|
150
|
-
matchedFields.push("industry");
|
|
151
|
-
}
|
|
152
|
-
if (matchedFields.length > 0) {
|
|
153
|
-
results.push({
|
|
154
|
-
file,
|
|
155
|
-
title,
|
|
156
|
-
description,
|
|
157
|
-
tags,
|
|
158
|
-
industry,
|
|
159
|
-
operation_type: operationType,
|
|
160
|
-
verified: example.verified === true,
|
|
161
|
-
score: matchedFields.length,
|
|
162
|
-
matched_fields: matchedFields,
|
|
163
|
-
});
|
|
164
|
-
}
|
|
165
|
-
}
|
|
166
|
-
catch {
|
|
167
|
-
continue;
|
|
168
|
-
}
|
|
169
|
-
}
|
|
170
|
-
results.sort((a, b) => {
|
|
171
|
-
if (b.score !== a.score)
|
|
172
|
-
return b.score - a.score;
|
|
173
|
-
return a.file.localeCompare(b.file);
|
|
174
|
-
});
|
|
175
|
-
return results;
|
|
176
|
-
}
|
|
177
|
-
export function getSchemaField(name, fieldPath) {
|
|
178
|
-
const schema = getSchema(name);
|
|
179
|
-
if (!schema)
|
|
180
|
-
return null;
|
|
181
|
-
const parts = fieldPath.split(".").filter(Boolean);
|
|
182
|
-
let current = schema;
|
|
183
|
-
for (const part of parts) {
|
|
184
|
-
if (!current || typeof current !== "object")
|
|
185
|
-
return null;
|
|
186
|
-
if (current.properties && part in current.properties) {
|
|
187
|
-
current = current.properties[part];
|
|
188
|
-
continue;
|
|
189
|
-
}
|
|
190
|
-
if (current.items && typeof current.items === "object") {
|
|
191
|
-
if (/^\d+$/.test(part)) {
|
|
192
|
-
current = current.items;
|
|
193
|
-
continue;
|
|
194
|
-
}
|
|
195
|
-
if (current.items.properties && part in current.items.properties) {
|
|
196
|
-
current = current.items.properties[part];
|
|
197
|
-
continue;
|
|
198
|
-
}
|
|
199
|
-
}
|
|
200
|
-
if (Array.isArray(current.oneOf) || Array.isArray(current.anyOf)) {
|
|
201
|
-
const variants = current.oneOf ?? current.anyOf;
|
|
202
|
-
for (const v of variants) {
|
|
203
|
-
if (v && typeof v === "object" && v.properties && part in v.properties) {
|
|
204
|
-
current = v.properties[part];
|
|
205
|
-
break;
|
|
206
|
-
}
|
|
207
|
-
}
|
|
208
|
-
continue;
|
|
209
|
-
}
|
|
210
|
-
if (part in current) {
|
|
211
|
-
current = current[part];
|
|
212
|
-
continue;
|
|
213
|
-
}
|
|
214
|
-
return null;
|
|
215
|
-
}
|
|
216
|
-
return current;
|
|
217
|
-
}
|
|
218
|
-
function resolveSchemaRefs(schema, visited = new Set()) {
|
|
219
|
-
if (!schema || typeof schema !== "object") {
|
|
220
|
-
return schema;
|
|
221
|
-
}
|
|
222
|
-
if (Array.isArray(schema)) {
|
|
223
|
-
return schema.map(item => resolveSchemaRefs(item, visited));
|
|
224
|
-
}
|
|
225
|
-
const result = {};
|
|
226
|
-
for (const [key, value] of Object.entries(schema)) {
|
|
227
|
-
if (key === "$ref" && typeof value === "string") {
|
|
228
|
-
if (value.startsWith("#")) {
|
|
229
|
-
result[key] = value;
|
|
230
|
-
}
|
|
231
|
-
else {
|
|
232
|
-
const refSchema = loadRefSchema(value, visited);
|
|
233
|
-
if (refSchema) {
|
|
234
|
-
Object.assign(result, resolveSchemaRefs(refSchema, visited));
|
|
235
|
-
}
|
|
236
|
-
}
|
|
237
|
-
}
|
|
238
|
-
else if (typeof value === "object") {
|
|
239
|
-
result[key] = resolveSchemaRefs(value, visited);
|
|
240
|
-
}
|
|
241
|
-
else {
|
|
242
|
-
result[key] = value;
|
|
243
|
-
}
|
|
244
|
-
}
|
|
245
|
-
return result;
|
|
246
|
-
}
|
|
247
|
-
function loadRefSchema(ref, visited) {
|
|
248
|
-
if (ref.startsWith("#")) {
|
|
249
|
-
return null;
|
|
250
|
-
}
|
|
251
|
-
if (visited.has(ref)) {
|
|
252
|
-
return { description: `Circular reference to ${ref}` };
|
|
253
|
-
}
|
|
254
|
-
visited.add(ref);
|
|
255
|
-
try {
|
|
256
|
-
const refPath = join(SCHEMAS_DIR, ref);
|
|
257
|
-
if (!existsSync(refPath)) {
|
|
258
|
-
return null;
|
|
259
|
-
}
|
|
260
|
-
const content = readFileSync(refPath, "utf-8");
|
|
261
|
-
return JSON.parse(content);
|
|
262
|
-
}
|
|
263
|
-
catch {
|
|
264
|
-
return null;
|
|
265
|
-
}
|
|
266
|
-
}
|
|
267
|
-
export function searchSchemas(query) {
|
|
268
|
-
const allSchemas = listSchemas();
|
|
269
|
-
const lowerQuery = query.toLowerCase();
|
|
270
|
-
return allSchemas.filter(schema => {
|
|
271
|
-
const nameMatch = schema.name.toLowerCase().includes(lowerQuery);
|
|
272
|
-
const titleMatch = schema.title?.toLowerCase().includes(lowerQuery);
|
|
273
|
-
const descMatch = schema.description?.toLowerCase().includes(lowerQuery);
|
|
274
|
-
return nameMatch || titleMatch || descMatch;
|
|
275
|
-
});
|
|
276
|
-
}
|
|
277
|
-
export function listOperations() {
|
|
278
|
-
const index = getSchemaIndex();
|
|
279
|
-
if (!index)
|
|
280
|
-
return [];
|
|
281
|
-
return (index.operations || []).filter(op => op.name.startsWith("onchain_operations_"));
|
|
282
|
-
}
|
|
283
|
-
function writeResponseToFile(data, preferredPath) {
|
|
284
|
-
try {
|
|
285
|
-
let targetPath;
|
|
286
|
-
if (preferredPath) {
|
|
287
|
-
targetPath = resolve(process.cwd(), preferredPath);
|
|
288
|
-
}
|
|
289
|
-
else {
|
|
290
|
-
if (!existsSync(WORKSPACE_TMP_DIR)) {
|
|
291
|
-
mkdirSync(WORKSPACE_TMP_DIR, { recursive: true });
|
|
292
|
-
}
|
|
293
|
-
const timestamp = Date.now();
|
|
294
|
-
targetPath = join(WORKSPACE_TMP_DIR, `schema-${timestamp}.json`);
|
|
295
|
-
}
|
|
296
|
-
const parentDir = dirname(targetPath);
|
|
297
|
-
if (!existsSync(parentDir)) {
|
|
298
|
-
mkdirSync(parentDir, { recursive: true });
|
|
299
|
-
}
|
|
300
|
-
const jsonStr = typeof data === "string" ? data : JSON.stringify(data, null, 2);
|
|
301
|
-
writeFileSync(targetPath, jsonStr, "utf-8");
|
|
302
|
-
return targetPath;
|
|
303
|
-
}
|
|
304
|
-
catch (e) {
|
|
305
|
-
return null;
|
|
306
|
-
}
|
|
307
|
-
}
|
|
308
|
-
export function processSchemaQuery(request) {
|
|
309
|
-
const { action, name, query, field_path, template, output_file, object_type, params } = request;
|
|
310
|
-
if (action === "get_guard_templates") {
|
|
311
|
-
const templates = getGuardTemplates(template);
|
|
312
|
-
if (!templates) {
|
|
313
|
-
return {
|
|
314
|
-
success: false,
|
|
315
|
-
action,
|
|
316
|
-
data: null,
|
|
317
|
-
message: template
|
|
318
|
-
? `Guard template '${template}' not found. Omit 'template' to list all available templates.`
|
|
319
|
-
: "Guard templates file not found. Ensure scripts/guard-templates.json exists.",
|
|
320
|
-
suggestions: [
|
|
321
|
-
"Omit 'template' to list all available templates.",
|
|
322
|
-
"Available template names: signer_verification, progress_node_check, order_owner_verification, service_belonging_check, reward_not_claimed, combined_reward_guard",
|
|
323
|
-
],
|
|
324
|
-
};
|
|
325
|
-
}
|
|
326
|
-
if (output_file) {
|
|
327
|
-
const filePath = writeResponseToFile(templates, output_file);
|
|
328
|
-
if (filePath) {
|
|
329
|
-
return {
|
|
330
|
-
success: true,
|
|
331
|
-
action,
|
|
332
|
-
data: null,
|
|
333
|
-
message: `Guard template${template ? ` '${template}'` : "s"} written to file: ${filePath}`,
|
|
334
|
-
output_file_path: filePath,
|
|
335
|
-
suggestions: [`Use Read tool to open ${filePath}`],
|
|
336
|
-
};
|
|
337
|
-
}
|
|
338
|
-
}
|
|
339
|
-
return {
|
|
340
|
-
success: true,
|
|
341
|
-
action,
|
|
342
|
-
data: templates,
|
|
343
|
-
message: template
|
|
344
|
-
? `Retrieved Guard template: ${template}`
|
|
345
|
-
: `Retrieved ${Array.isArray(templates.templates) ? templates.templates.length : 0} Guard templates`,
|
|
346
|
-
};
|
|
347
|
-
}
|
|
348
|
-
if (action === "get_templates") {
|
|
349
|
-
if (!template) {
|
|
350
|
-
const metas = listRegistryTemplates(object_type);
|
|
351
|
-
const counts = getTemplateCounts();
|
|
352
|
-
const data = {
|
|
353
|
-
total: metas.length,
|
|
354
|
-
filter: object_type ?? null,
|
|
355
|
-
counts_by_object_type: counts,
|
|
356
|
-
templates: metas,
|
|
357
|
-
};
|
|
358
|
-
if (output_file) {
|
|
359
|
-
const filePath = writeResponseToFile(data, output_file);
|
|
360
|
-
if (filePath) {
|
|
361
|
-
return {
|
|
362
|
-
success: true,
|
|
363
|
-
action,
|
|
364
|
-
data: null,
|
|
365
|
-
message: `${metas.length} templates written to file: ${filePath}`,
|
|
366
|
-
output_file_path: filePath,
|
|
367
|
-
suggestions: [`Use Read tool to open ${filePath}`],
|
|
368
|
-
};
|
|
369
|
-
}
|
|
370
|
-
}
|
|
371
|
-
return {
|
|
372
|
-
success: true,
|
|
373
|
-
action,
|
|
374
|
-
data,
|
|
375
|
-
message: `${metas.length} template(s)${object_type ? ` for object_type='${object_type}'` : ""} ` +
|
|
376
|
-
`(total registry: ${Object.values(counts).reduce((a, b) => a + b, 0)} across ${TEMPLATE_OBJECT_TYPES.length} object types). ` +
|
|
377
|
-
`Provide 'template' (id) for full detail; add 'params' (JSON string) to instantiate.`,
|
|
378
|
-
};
|
|
379
|
-
}
|
|
380
|
-
if (!params) {
|
|
381
|
-
const detail = getTemplateDetail(template);
|
|
382
|
-
if (!detail) {
|
|
383
|
-
return {
|
|
384
|
-
success: false,
|
|
385
|
-
action,
|
|
386
|
-
data: null,
|
|
387
|
-
message: `Template '${template}' not found in the unified registry.`,
|
|
388
|
-
suggestions: [
|
|
389
|
-
"Omit 'template' to list all template metadata (id + object_type + parameters).",
|
|
390
|
-
`Filter by object_type: ${TEMPLATE_OBJECT_TYPES.join(", ")}`,
|
|
391
|
-
],
|
|
392
|
-
};
|
|
393
|
-
}
|
|
394
|
-
if (output_file) {
|
|
395
|
-
const filePath = writeResponseToFile(detail, output_file);
|
|
396
|
-
if (filePath) {
|
|
397
|
-
return {
|
|
398
|
-
success: true,
|
|
399
|
-
action,
|
|
400
|
-
data: null,
|
|
401
|
-
message: `Template '${template}' detail written to file: ${filePath}`,
|
|
402
|
-
output_file_path: filePath,
|
|
403
|
-
suggestions: [`Use Read tool to open ${filePath}`],
|
|
404
|
-
};
|
|
405
|
-
}
|
|
406
|
-
}
|
|
407
|
-
return {
|
|
408
|
-
success: true,
|
|
409
|
-
action,
|
|
410
|
-
data: detail,
|
|
411
|
-
message: `Template '${template}' (${detail.object_type}, ${detail.instantiable ? "instantiable" : "guidance-only"}). ` +
|
|
412
|
-
`To instantiate, call again with 'params' = JSON object of the declared parameters.`,
|
|
413
|
-
};
|
|
414
|
-
}
|
|
415
|
-
let parsedParams;
|
|
416
|
-
try {
|
|
417
|
-
const parsed = JSON.parse(params);
|
|
418
|
-
if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
|
|
419
|
-
return {
|
|
420
|
-
success: false,
|
|
421
|
-
action,
|
|
422
|
-
data: null,
|
|
423
|
-
message: `'params' must be a JSON object (e.g. '{"key":"value"}'), got ${Array.isArray(parsed) ? "array" : typeof parsed}.`,
|
|
424
|
-
};
|
|
425
|
-
}
|
|
426
|
-
parsedParams = parsed;
|
|
427
|
-
}
|
|
428
|
-
catch (e) {
|
|
429
|
-
return {
|
|
430
|
-
success: false,
|
|
431
|
-
action,
|
|
432
|
-
data: null,
|
|
433
|
-
message: `Failed to parse 'params' as JSON: ${e instanceof Error ? e.message : String(e)}`,
|
|
434
|
-
suggestions: ["Example: params='{\"whitelist\":[\"0xabc...\"]}'"],
|
|
435
|
-
};
|
|
436
|
-
}
|
|
437
|
-
const result = instantiateTemplate(template, parsedParams);
|
|
438
|
-
if (!result.ok) {
|
|
439
|
-
return {
|
|
440
|
-
success: false,
|
|
441
|
-
action,
|
|
442
|
-
data: result.guidance !== undefined ? { guidance: result.guidance } : null,
|
|
443
|
-
message: `Instantiation failed for '${template}': ${result.error}`,
|
|
444
|
-
suggestions: result.missing_params
|
|
445
|
-
? [`Missing required params: ${result.missing_params.join(", ")}`, "Call with 'template' only (no 'params') to see full parameter declarations."]
|
|
446
|
-
: ["Call with 'template' only (no 'params') to see full parameter declarations."],
|
|
447
|
-
};
|
|
448
|
-
}
|
|
449
|
-
const data = {
|
|
450
|
-
object_type: result.object_type,
|
|
451
|
-
template_id: result.template_id,
|
|
452
|
-
body: result.body,
|
|
453
|
-
...(result.notes ? { notes: result.notes } : {}),
|
|
454
|
-
};
|
|
455
|
-
if (output_file) {
|
|
456
|
-
const filePath = writeResponseToFile(data, output_file);
|
|
457
|
-
if (filePath) {
|
|
458
|
-
return {
|
|
459
|
-
success: true,
|
|
460
|
-
action,
|
|
461
|
-
data: null,
|
|
462
|
-
message: `Instantiated template '${template}' written to file: ${filePath}`,
|
|
463
|
-
output_file_path: filePath,
|
|
464
|
-
suggestions: [`Use Read tool to open ${filePath}`],
|
|
465
|
-
};
|
|
466
|
-
}
|
|
467
|
-
}
|
|
468
|
-
return {
|
|
469
|
-
success: true,
|
|
470
|
-
action,
|
|
471
|
-
data,
|
|
472
|
-
message: `Instantiated '${template}' (${result.object_type}). ` +
|
|
473
|
-
`Review the body against the onchain_operations schema before submitting.`,
|
|
474
|
-
};
|
|
475
|
-
}
|
|
476
|
-
if (action === "search_examples") {
|
|
477
|
-
if (!query) {
|
|
478
|
-
return {
|
|
479
|
-
success: false,
|
|
480
|
-
action,
|
|
481
|
-
data: null,
|
|
482
|
-
message: "Search query is required for 'search_examples' action",
|
|
483
|
-
suggestions: [
|
|
484
|
-
"Provide a 'query' string (e.g. 'rental', 'guard', 'service', 'machine')",
|
|
485
|
-
"Searchable fields: title, description, tags, operation_type, industry",
|
|
486
|
-
],
|
|
487
|
-
};
|
|
488
|
-
}
|
|
489
|
-
const results = searchExamples(query);
|
|
490
|
-
return {
|
|
491
|
-
success: true,
|
|
492
|
-
action,
|
|
493
|
-
data: results,
|
|
494
|
-
message: `Found ${results.length} example(s) matching '${query}'`,
|
|
495
|
-
suggestions: results.length === 0
|
|
496
|
-
? [
|
|
497
|
-
"Try broader terms like 'service', 'machine', 'guard', 'permission'",
|
|
498
|
-
"Try an industry name: 'rental', 'retail', 'general'",
|
|
499
|
-
"Use 'get' action with a schema name to see the full JSON Schema",
|
|
500
|
-
]
|
|
501
|
-
: undefined,
|
|
502
|
-
};
|
|
503
|
-
}
|
|
504
|
-
if (action === "get_tool_reference") {
|
|
505
|
-
if (name) {
|
|
506
|
-
const entry = getToolReference(name);
|
|
507
|
-
if (!entry) {
|
|
508
|
-
return {
|
|
509
|
-
success: false,
|
|
510
|
-
action,
|
|
511
|
-
data: null,
|
|
512
|
-
message: `Tool '${name}' not found in the tool reference.`,
|
|
513
|
-
suggestions: [
|
|
514
|
-
"Omit 'name' to list all tools.",
|
|
515
|
-
`Available tools: ${TOOLS_REFERENCE.map((t) => t.name).join(", ")}`,
|
|
516
|
-
],
|
|
517
|
-
};
|
|
518
|
-
}
|
|
519
|
-
const sequence = getToolSequence(name);
|
|
520
|
-
return {
|
|
521
|
-
success: true,
|
|
522
|
-
action,
|
|
523
|
-
data: { tool: entry, call_sequence: sequence ?? null },
|
|
524
|
-
message: `Retrieved tool reference: ${name}`,
|
|
525
|
-
};
|
|
526
|
-
}
|
|
527
|
-
if (query) {
|
|
528
|
-
const matches = searchToolReference(query);
|
|
529
|
-
return {
|
|
530
|
-
success: true,
|
|
531
|
-
action,
|
|
532
|
-
data: { tools: matches, count: matches.length },
|
|
533
|
-
message: `Found ${matches.length} tool(s) matching '${query}'`,
|
|
534
|
-
suggestions: matches.length === 0
|
|
535
|
-
? ["Try a broader keyword (e.g. 'onchain', 'guard', 'schema'), or omit 'query' to list all tools."]
|
|
536
|
-
: undefined,
|
|
537
|
-
};
|
|
538
|
-
}
|
|
539
|
-
const catalog = TOOLS_REFERENCE.map((t) => ({
|
|
540
|
-
name: t.name,
|
|
541
|
-
summary: t.summary,
|
|
542
|
-
actions: t.actions ?? [],
|
|
543
|
-
notes: t.notes ?? [],
|
|
544
|
-
}));
|
|
545
|
-
return {
|
|
546
|
-
success: true,
|
|
547
|
-
action,
|
|
548
|
-
data: { tools: catalog, count: catalog.length },
|
|
549
|
-
message: `Retrieved reference for ${catalog.length} MCP tools. Pass name='<tool>' for full detail (params, prerequisites, follow-ups).`,
|
|
550
|
-
};
|
|
551
|
-
}
|
|
552
|
-
if (action === "get_guard_design_patterns") {
|
|
553
|
-
if (name) {
|
|
554
|
-
const pattern = getGuardDesignPattern(name);
|
|
555
|
-
if (!pattern) {
|
|
556
|
-
return {
|
|
557
|
-
success: false,
|
|
558
|
-
action,
|
|
559
|
-
data: null,
|
|
560
|
-
message: `Guard design pattern '${name}' not found.`,
|
|
561
|
-
suggestions: [
|
|
562
|
-
"Omit 'name' to list the full catalog.",
|
|
563
|
-
`Available pattern ids: ${GUARD_DESIGN_PATTERNS.map((p) => p.id).join(", ")}`,
|
|
564
|
-
],
|
|
565
|
-
};
|
|
566
|
-
}
|
|
567
|
-
return {
|
|
568
|
-
success: true,
|
|
569
|
-
action,
|
|
570
|
-
data: { pattern },
|
|
571
|
-
message: `Retrieved Guard design pattern: ${name}`,
|
|
572
|
-
};
|
|
573
|
-
}
|
|
574
|
-
if (query) {
|
|
575
|
-
const byHost = GUARD_DESIGN_PATTERNS.filter((p) => p.host === query);
|
|
576
|
-
const matches = byHost.length > 0
|
|
577
|
-
? byHost
|
|
578
|
-
: GUARD_DESIGN_PATTERNS.filter((p) => p.business_requirement.toLowerCase().includes(query.toLowerCase()) ||
|
|
579
|
-
p.logic_summary.toLowerCase().includes(query.toLowerCase()));
|
|
580
|
-
return {
|
|
581
|
-
success: true,
|
|
582
|
-
action,
|
|
583
|
-
data: { patterns: matches, count: matches.length, filtered_by: byHost.length > 0 ? "host" : "keyword" },
|
|
584
|
-
message: `Found ${matches.length} Guard design pattern(s) matching '${query}'`,
|
|
585
|
-
suggestions: matches.length === 0
|
|
586
|
-
? ["Filter by host: service_buy_guard, service_allocator_guard, machine_forward, progress_submission, reward_claim, repository_write, arbitration_usage, arbitration_voting, gen_passport"]
|
|
587
|
-
: undefined,
|
|
588
|
-
};
|
|
589
|
-
}
|
|
590
|
-
const catalog = GUARD_DESIGN_PATTERNS.map((p) => ({
|
|
591
|
-
id: p.id,
|
|
592
|
-
business_requirement: p.business_requirement,
|
|
593
|
-
host: p.host,
|
|
594
|
-
data_source: p.data_source,
|
|
595
|
-
verifier_level: p.verifier_level,
|
|
596
|
-
logic_summary: p.logic_summary,
|
|
597
|
-
key_queries: p.key_queries,
|
|
598
|
-
notes: p.notes ?? [],
|
|
599
|
-
}));
|
|
600
|
-
return {
|
|
601
|
-
success: true,
|
|
602
|
-
action,
|
|
603
|
-
data: { patterns: catalog, count: catalog.length, version: GUARD_DESIGN_PATTERNS_VERSION },
|
|
604
|
-
message: `Retrieved ${catalog.length} Guard design patterns. Pass name='<pattern_id>' for full detail (witness types, mitigated risks, industries).`,
|
|
605
|
-
};
|
|
606
|
-
}
|
|
607
|
-
if (action === "get_safety_rules") {
|
|
608
|
-
return {
|
|
609
|
-
success: true,
|
|
610
|
-
action,
|
|
611
|
-
data: {
|
|
612
|
-
version: SAFETY_RULES_VERSION,
|
|
613
|
-
object_reuse_rules: OBJECT_REUSE_RULES,
|
|
614
|
-
create_vs_modify_pattern: CREATE_VS_MODIFY_PATTERN,
|
|
615
|
-
immutability_rules: IMMUTABILITY_RULES,
|
|
616
|
-
operation_type_classification: OPERATION_TYPE_CLASSIFICATION,
|
|
617
|
-
operation_class_meta: OPERATION_CLASS_META,
|
|
618
|
-
naming_conventions: NAMING_CONVENTIONS,
|
|
619
|
-
},
|
|
620
|
-
message: "Retrieved safety rule tables (reuse / immutability / operation classification / naming). " +
|
|
621
|
-
"Key points: prefer REUSING existing objects (string reference = reuse, object shape = create); " +
|
|
622
|
-
"Machine publish locks nodes/pairs/forwards, Service publish locks machine/order_allocators/arbitrations (sales stays mutable); " +
|
|
623
|
-
"Guard is CREATE-only immutable; on-chain writes require explicit user confirmation.",
|
|
624
|
-
};
|
|
625
|
-
}
|
|
626
|
-
if (!areSchemasAvailable()) {
|
|
627
|
-
return {
|
|
628
|
-
success: false,
|
|
629
|
-
action,
|
|
630
|
-
data: null,
|
|
631
|
-
message: "Schema files are not available. Please run 'npm run generate:schemas' first.",
|
|
632
|
-
suggestions: ["Run 'npm run generate:schemas' to generate schema files", "Ensure the dist/schemas directory exists"],
|
|
633
|
-
};
|
|
634
|
-
}
|
|
635
|
-
switch (action) {
|
|
636
|
-
case "list": {
|
|
637
|
-
const schemas = listSchemas();
|
|
638
|
-
return {
|
|
639
|
-
success: true,
|
|
640
|
-
action,
|
|
641
|
-
data: schemas,
|
|
642
|
-
message: `Found ${schemas.length} available schemas`,
|
|
643
|
-
};
|
|
644
|
-
}
|
|
645
|
-
case "get": {
|
|
646
|
-
if (!name) {
|
|
647
|
-
return {
|
|
648
|
-
success: false,
|
|
649
|
-
action,
|
|
650
|
-
data: null,
|
|
651
|
-
message: "Schema name is required for 'get' action",
|
|
652
|
-
suggestions: ["Provide a schema name", "Use 'list' action to see available schemas"],
|
|
653
|
-
};
|
|
654
|
-
}
|
|
655
|
-
const schema = getSchema(name);
|
|
656
|
-
if (!schema) {
|
|
657
|
-
const suggestions = searchSchemas(name).slice(0, 5);
|
|
658
|
-
return {
|
|
659
|
-
success: false,
|
|
660
|
-
action,
|
|
661
|
-
data: null,
|
|
662
|
-
message: `Schema '${name}' not found`,
|
|
663
|
-
suggestions: suggestions.length > 0
|
|
664
|
-
? suggestions.map(s => `Did you mean: ${s.name}?`)
|
|
665
|
-
: ["Use 'list' action to see available schemas"],
|
|
666
|
-
};
|
|
667
|
-
}
|
|
668
|
-
if (output_file) {
|
|
669
|
-
const filePath = writeResponseToFile(schema, output_file);
|
|
670
|
-
if (filePath) {
|
|
671
|
-
return {
|
|
672
|
-
success: true,
|
|
673
|
-
action,
|
|
674
|
-
data: null,
|
|
675
|
-
message: `Schema '${name}' written to file: ${filePath}`,
|
|
676
|
-
output_file_path: filePath,
|
|
677
|
-
suggestions: [`Use Read tool to open ${filePath}`],
|
|
678
|
-
};
|
|
679
|
-
}
|
|
680
|
-
}
|
|
681
|
-
return {
|
|
682
|
-
success: true,
|
|
683
|
-
action,
|
|
684
|
-
data: schema,
|
|
685
|
-
message: `Retrieved schema: ${name}`,
|
|
686
|
-
};
|
|
687
|
-
}
|
|
688
|
-
case "get_field": {
|
|
689
|
-
if (!name || !field_path) {
|
|
690
|
-
return {
|
|
691
|
-
success: false,
|
|
692
|
-
action,
|
|
693
|
-
data: null,
|
|
694
|
-
message: "Both 'name' and 'field_path' are required for 'get_field' action",
|
|
695
|
-
suggestions: [
|
|
696
|
-
"Example: {action: 'get_field', name: 'onchain_operations_machine', field_path: 'data.node'}",
|
|
697
|
-
"Use 'get' action to retrieve the full schema",
|
|
698
|
-
],
|
|
699
|
-
};
|
|
700
|
-
}
|
|
701
|
-
const fieldSchema = getSchemaField(name, field_path);
|
|
702
|
-
if (!fieldSchema) {
|
|
703
|
-
return {
|
|
704
|
-
success: false,
|
|
705
|
-
action,
|
|
706
|
-
data: null,
|
|
707
|
-
message: `Field path '${field_path}' not found in schema '${name}'`,
|
|
708
|
-
suggestions: [
|
|
709
|
-
"Check the field path (dot-separated, e.g. 'data.node')",
|
|
710
|
-
"Use 'get' action to see the full schema structure",
|
|
711
|
-
],
|
|
712
|
-
};
|
|
713
|
-
}
|
|
714
|
-
return {
|
|
715
|
-
success: true,
|
|
716
|
-
action,
|
|
717
|
-
data: fieldSchema,
|
|
718
|
-
message: `Retrieved field '${field_path}' from schema '${name}'`,
|
|
719
|
-
};
|
|
720
|
-
}
|
|
721
|
-
case "search": {
|
|
722
|
-
if (!query) {
|
|
723
|
-
return {
|
|
724
|
-
success: false,
|
|
725
|
-
action,
|
|
726
|
-
data: null,
|
|
727
|
-
message: "Search query is required for 'search' action",
|
|
728
|
-
};
|
|
729
|
-
}
|
|
730
|
-
const results = searchSchemas(query);
|
|
731
|
-
return {
|
|
732
|
-
success: true,
|
|
733
|
-
action,
|
|
734
|
-
data: results,
|
|
735
|
-
message: `Found ${results.length} schemas matching '${query}'`,
|
|
736
|
-
};
|
|
737
|
-
}
|
|
738
|
-
case "list_operations": {
|
|
739
|
-
const operations = listOperations();
|
|
740
|
-
return {
|
|
741
|
-
success: true,
|
|
742
|
-
action,
|
|
743
|
-
data: operations,
|
|
744
|
-
message: `Found ${operations.length} on-chain operations`,
|
|
745
|
-
};
|
|
746
|
-
}
|
|
747
|
-
case "get_output": {
|
|
748
|
-
if (!name) {
|
|
749
|
-
return {
|
|
750
|
-
success: false,
|
|
751
|
-
action,
|
|
752
|
-
data: null,
|
|
753
|
-
message: "Tool name is required for 'get_output' action",
|
|
754
|
-
suggestions: ["Provide a tool name", "Use 'list' action to see available tools and their outputPath"],
|
|
755
|
-
};
|
|
756
|
-
}
|
|
757
|
-
const schema = getOutputSchema(name);
|
|
758
|
-
if (!schema) {
|
|
759
|
-
const allSchemas = listSchemas();
|
|
760
|
-
const toolExists = allSchemas.find(s => s.name === name);
|
|
761
|
-
if (toolExists) {
|
|
762
|
-
return {
|
|
763
|
-
success: false,
|
|
764
|
-
action,
|
|
765
|
-
data: null,
|
|
766
|
-
message: `Tool '${name}' exists but has no output schema file. The tool may not declare an outputSchema, or the schema file was not generated.`,
|
|
767
|
-
suggestions: [`Use 'get' action with name='${name}' to retrieve its input schema`],
|
|
768
|
-
};
|
|
769
|
-
}
|
|
770
|
-
const suggestions = searchSchemas(name).slice(0, 5);
|
|
771
|
-
return {
|
|
772
|
-
success: false,
|
|
773
|
-
action,
|
|
774
|
-
data: null,
|
|
775
|
-
message: `Tool '${name}' not found`,
|
|
776
|
-
suggestions: suggestions.length > 0
|
|
777
|
-
? suggestions.map(s => `Did you mean: ${s.name}?`)
|
|
778
|
-
: ["Use 'list' action to see available tools"],
|
|
779
|
-
};
|
|
780
|
-
}
|
|
781
|
-
if (output_file) {
|
|
782
|
-
const filePath = writeResponseToFile(schema, output_file);
|
|
783
|
-
if (filePath) {
|
|
784
|
-
return {
|
|
785
|
-
success: true,
|
|
786
|
-
action,
|
|
787
|
-
data: null,
|
|
788
|
-
message: `Output schema '${name}' written to file: ${filePath}`,
|
|
789
|
-
output_file_path: filePath,
|
|
790
|
-
suggestions: [`Use Read tool to open ${filePath}`],
|
|
791
|
-
};
|
|
792
|
-
}
|
|
793
|
-
}
|
|
794
|
-
return {
|
|
795
|
-
success: true,
|
|
796
|
-
action,
|
|
797
|
-
data: schema,
|
|
798
|
-
message: `Retrieved output schema: ${name}`,
|
|
799
|
-
};
|
|
800
|
-
}
|
|
801
|
-
default:
|
|
802
|
-
return {
|
|
803
|
-
success: false,
|
|
804
|
-
action,
|
|
805
|
-
data: null,
|
|
806
|
-
message: `Unknown action: ${action}`,
|
|
807
|
-
suggestions: ["Use 'list', 'get', 'get_field', 'get_output', 'search', 'list_operations', 'get_guard_templates', or 'search_examples'"],
|
|
808
|
-
};
|
|
809
|
-
}
|
|
810
|
-
}
|
|
1
|
+
import{readFileSync,existsSync,writeFileSync,mkdirSync,readdirSync}from'fs';import{resolve,join,dirname}from'path';import{fileURLToPath}from'url';import{TOOLS_REFERENCE,getToolReference,searchToolReference,getToolSequence}from'../knowledge/tools-reference.js';import{GUARD_DESIGN_PATTERNS,getGuardDesignPattern,GUARD_DESIGN_PATTERNS_VERSION}from'../knowledge/guard-design-patterns.js';import{OBJECT_REUSE_RULES,CREATE_VS_MODIFY_PATTERN,IMMUTABILITY_RULES,OPERATION_TYPE_CLASSIFICATION,OPERATION_CLASS_META,NAMING_CONVENTIONS,SAFETY_RULES_VERSION}from'../knowledge/safety-rules.js';import{listTemplates as a295a,getTemplateDetail,instantiateTemplate,getTemplateCounts,TEMPLATE_OBJECT_TYPES}from'../knowledge/template-registry.js';const __filename=fileURLToPath(import.meta.url),__dirname=fileURLToPath(new URL('.',import.meta.url)),SCHEMAS_DIR=resolve(__dirname,'../../dist/schemas'),GUARD_TEMPLATES_PATH_SCRIPTS=resolve(__dirname,'../../scripts/guard-templates.json'),GUARD_TEMPLATES_PATH_DIST=resolve(__dirname,'../../dist/schemas/guard-templates.json'),GUARD_TEMPLATES_PATH=existsSync(GUARD_TEMPLATES_PATH_SCRIPTS)?GUARD_TEMPLATES_PATH_SCRIPTS:GUARD_TEMPLATES_PATH_DIST,EXAMPLES_DIR_SCRIPTS=resolve(__dirname,'../../scripts/examples'),EXAMPLES_DIR_DIST=resolve(__dirname,'../examples');export const EXAMPLES_DIR=existsSync(EXAMPLES_DIR_SCRIPTS)?EXAMPLES_DIR_SCRIPTS:EXAMPLES_DIR_DIST;const WORKSPACE_TMP_DIR=resolve(process['cwd'](),'.trae','tmp');export function areSchemasAvailable(){return existsSync(SCHEMAS_DIR)&&existsSync(join(SCHEMAS_DIR,'index.json'));}export function getSchemaIndex(){try{const a=join(SCHEMAS_DIR,'index.json');if(!existsSync(a))return null;const b=readFileSync(a,'utf-8');return JSON['parse'](b);}catch{return null;}}export function listSchemas(){const a=getSchemaIndex();if(!a)return[];return[...a['tools']||[],...a['operations']||[]];}export function getSchema(a){try{let b=join(SCHEMAS_DIR,a+'.schema.json');!existsSync(b)&&(b=join(SCHEMAS_DIR,a+'.json'));if(!existsSync(b))return null;const c=readFileSync(b,'utf-8'),d=JSON['parse'](c);return resolveSchemaRefs(d);}catch{return null;}}export function getOutputSchema(a){try{const b=join(SCHEMAS_DIR,a+'.output.json');if(!existsSync(b))return null;const c=readFileSync(b,'utf-8'),d=JSON['parse'](c);return resolveSchemaRefs(d);}catch{return null;}}export function getGuardTemplates(a){try{if(!existsSync(GUARD_TEMPLATES_PATH))return null;const b=readFileSync(GUARD_TEMPLATES_PATH,'utf-8'),c=JSON['parse'](b);if(!a)return{'version':c['version'],'description':c['description'],'templates':(c['templates']||[])['map'](e=>({'name':e['name'],'title':e['title'],'description':e['description'],'use_case':e['use_case']})),'query_reference':c['query_reference'],'node_return_types':c['node_return_types']};const d=(c['templates']||[])['find'](e=>e['name']===a);if(!d)return null;return d;}catch{return null;}}export function searchExamples(a){if(!existsSync(EXAMPLES_DIR))return[];let b;try{b=readdirSync(EXAMPLES_DIR);}catch{return[];}const c=a['toLowerCase']()['trim']();if(!c)return[];const d=[];for(const e of b){if(!e['endsWith']('.json'))continue;const f=join(EXAMPLES_DIR,e);try{const g=readFileSync(f,'utf-8'),h=JSON['parse'](g),i=String(h['title']??''),j=String(h['description']??''),k=Array['isArray'](h['tags'])?h['tags']['map'](o=>String(o)):[],l=String(h['operation_type']??''),m=String(h['industry']??''),n=[];i['toLowerCase']()['includes'](c)&&n['push']('title'),j['toLowerCase']()['includes'](c)&&n['push']('description'),k['some'](o=>o['toLowerCase']()===c)&&n['push']('tags'),l&&l['toLowerCase']()===c&&n['push']('operation_type'),m&&m['toLowerCase']()===c&&n['push']('industry'),n['length']>0x0&&d['push']({'file':e,'title':i,'description':j,'tags':k,'industry':m,'operation_type':l,'verified':h['verified']===!![],'score':n['length'],'matched_fields':n});}catch{continue;}}return d['sort']((o,p)=>{if(p['score']!==o['score'])return p['score']-o['score'];return o['file']['localeCompare'](p['file']);}),d;}export function getSchemaField(a,b){const c=getSchema(a);if(!c)return null;const d=b['split']('.')['filter'](Boolean);let e=c;for(const f of d){if(!e||typeof e!=='object')return null;if(e['properties']&&f in e['properties']){e=e['properties'][f];continue;}if(e['items']&&typeof e['items']==='object'){if(/^\d+$/['test'](f)){e=e['items'];continue;}if(e['items']['properties']&&f in e['items']['properties']){e=e['items']['properties'][f];continue;}}if(Array['isArray'](e['oneOf'])||Array['isArray'](e['anyOf'])){const g=e['oneOf']??e['anyOf'];for(const h of g){if(h&&typeof h==='object'&&h['properties']&&f in h['properties']){e=h['properties'][f];break;}}continue;}if(f in e){e=e[f];continue;}return null;}return e;}function resolveSchemaRefs(a,b=new Set()){if(!a||typeof a!=='object')return a;if(Array['isArray'](a))return a['map'](d=>resolveSchemaRefs(d,b));const c={};for(const [d,e]of Object['entries'](a)){if(d==='$ref'&&typeof e==='string'){if(e['startsWith']('#'))c[d]=e;else{const f=loadRefSchema(e,b);f&&Object['assign'](c,resolveSchemaRefs(f,b));}}else typeof e==='object'?c[d]=resolveSchemaRefs(e,b):c[d]=e;}return c;}function loadRefSchema(a,b){if(a['startsWith']('#'))return null;if(b['has'](a))return{'description':'Circular\x20reference\x20to\x20'+a};b['add'](a);try{const c=join(SCHEMAS_DIR,a);if(!existsSync(c))return null;const d=readFileSync(c,'utf-8');return JSON['parse'](d);}catch{return null;}}export function searchSchemas(a){const b=listSchemas(),c=a['toLowerCase']();return b['filter'](d=>{const e=d['name']['toLowerCase']()['includes'](c),f=d['title']?.['toLowerCase']()['includes'](c),g=d['description']?.['toLowerCase']()['includes'](c);return e||f||g;});}export function listOperations(){const a=getSchemaIndex();if(!a)return[];return(a['operations']||[])['filter'](b=>b['name']['startsWith']('onchain_operations_'));}function writeResponseToFile(a,b){try{let c;if(b)c=resolve(process['cwd'](),b);else{!existsSync(WORKSPACE_TMP_DIR)&&mkdirSync(WORKSPACE_TMP_DIR,{'recursive':!![]});const g=Date['now']();c=join(WORKSPACE_TMP_DIR,'schema-'+g+'.json');}const d=dirname(c);!existsSync(d)&&mkdirSync(d,{'recursive':!![]});const f=typeof a==='string'?a:JSON['stringify'](a,null,0x2);return writeFileSync(c,f,'utf-8'),c;}catch(h){return null;}}export function processSchemaQuery(a){const {action:b,name:c,query:d,field_path:f,template:g,output_file:h,object_type:i,params:j}=a;if(b==='get_guard_templates'){const k=getGuardTemplates(g);if(!k)return{'success':![],'action':b,'data':null,'message':g?'Guard\x20template\x20\x27'+g+'\x27\x20not\x20found.\x20Omit\x20\x27template\x27\x20to\x20list\x20all\x20available\x20templates.':'Guard\x20templates\x20file\x20not\x20found.\x20Ensure\x20scripts/guard-templates.json\x20exists.','suggestions':['Omit\x20\x27template\x27\x20to\x20list\x20all\x20available\x20templates.','Available\x20template\x20names:\x20signer_verification,\x20progress_node_check,\x20order_owner_verification,\x20service_belonging_check,\x20reward_not_claimed,\x20combined_reward_guard']};if(h){const l=writeResponseToFile(k,h);if(l)return{'success':!![],'action':b,'data':null,'message':'Guard\x20template'+(g?'\x20\x27'+g+'\x27':'s')+'\x20written\x20to\x20file:\x20'+l,'output_file_path':l,'suggestions':['Use\x20Read\x20tool\x20to\x20open\x20'+l]};}return{'success':!![],'action':b,'data':k,'message':g?'Retrieved\x20Guard\x20template:\x20'+g:'Retrieved\x20'+(Array['isArray'](k['templates'])?k['templates']['length']:0x0)+'\x20Guard\x20templates'};}if(b==='get_templates'){if(!g){const p=a295a(i),q=getTemplateCounts(),r={'total':p['length'],'filter':i??null,'counts_by_object_type':q,'templates':p};if(h){const s=writeResponseToFile(r,h);if(s)return{'success':!![],'action':b,'data':null,'message':p['length']+'\x20templates\x20written\x20to\x20file:\x20'+s,'output_file_path':s,'suggestions':['Use\x20Read\x20tool\x20to\x20open\x20'+s]};}return{'success':!![],'action':b,'data':r,'message':p['length']+'\x20template(s)'+(i?'\x20for\x20object_type=\x27'+i+'\x27':'')+'\x20'+('(total\x20registry:\x20'+Object['values'](q)['reduce']((t,u)=>t+u,0x0)+'\x20across\x20'+TEMPLATE_OBJECT_TYPES['length']+'\x20object\x20types).\x20')+'Provide\x20\x27template\x27\x20(id)\x20for\x20full\x20detail;\x20add\x20\x27params\x27\x20(JSON\x20string)\x20to\x20instantiate.'};}if(!j){const t=getTemplateDetail(g);if(!t)return{'success':![],'action':b,'data':null,'message':'Template\x20\x27'+g+'\x27\x20not\x20found\x20in\x20the\x20unified\x20registry.','suggestions':['Omit\x20\x27template\x27\x20to\x20list\x20all\x20template\x20metadata\x20(id\x20+\x20object_type\x20+\x20parameters).','Filter\x20by\x20object_type:\x20'+TEMPLATE_OBJECT_TYPES['join'](',\x20')]};if(h){const u=writeResponseToFile(t,h);if(u)return{'success':!![],'action':b,'data':null,'message':'Template\x20\x27'+g+'\x27\x20detail\x20written\x20to\x20file:\x20'+u,'output_file_path':u,'suggestions':['Use\x20Read\x20tool\x20to\x20open\x20'+u]};}return{'success':!![],'action':b,'data':t,'message':'Template\x20\x27'+g+'\x27\x20('+t['object_type']+',\x20'+(t['instantiable']?'instantiable':'guidance-only')+').\x20'+'To\x20instantiate,\x20call\x20again\x20with\x20\x27params\x27\x20=\x20JSON\x20object\x20of\x20the\x20declared\x20parameters.'};}let m;try{const v=JSON['parse'](j);if(!v||typeof v!=='object'||Array['isArray'](v))return{'success':![],'action':b,'data':null,'message':'\x27params\x27\x20must\x20be\x20a\x20JSON\x20object\x20(e.g.\x20\x27{\x22key\x22:\x22value\x22}\x27),\x20got\x20'+(Array['isArray'](v)?'array':typeof v)+'.'};m=v;}catch(w){return{'success':![],'action':b,'data':null,'message':'Failed\x20to\x20parse\x20\x27params\x27\x20as\x20JSON:\x20'+(w instanceof Error?w['message']:String(w)),'suggestions':['Example:\x20params=\x27{\x22whitelist\x22:[\x220xabc...\x22]}\x27']};}const n=instantiateTemplate(g,m);if(!n['ok'])return{'success':![],'action':b,'data':n['guidance']!==undefined?{'guidance':n['guidance']}:null,'message':'Instantiation\x20failed\x20for\x20\x27'+g+'\x27:\x20'+n['error'],'suggestions':n['missing_params']?['Missing\x20required\x20params:\x20'+n['missing_params']['join'](',\x20'),'Call\x20with\x20\x27template\x27\x20only\x20(no\x20\x27params\x27)\x20to\x20see\x20full\x20parameter\x20declarations.']:['Call\x20with\x20\x27template\x27\x20only\x20(no\x20\x27params\x27)\x20to\x20see\x20full\x20parameter\x20declarations.']};const o={'object_type':n['object_type'],'template_id':n['template_id'],'body':n['body'],...n['notes']?{'notes':n['notes']}:{}};if(h){const x=writeResponseToFile(o,h);if(x)return{'success':!![],'action':b,'data':null,'message':'Instantiated\x20template\x20\x27'+g+'\x27\x20written\x20to\x20file:\x20'+x,'output_file_path':x,'suggestions':['Use\x20Read\x20tool\x20to\x20open\x20'+x]};}return{'success':!![],'action':b,'data':o,'message':'Instantiated\x20\x27'+g+'\x27\x20('+n['object_type']+').\x20'+'Review\x20the\x20body\x20against\x20the\x20onchain_operations\x20schema\x20before\x20submitting.'};}if(b==='search_examples'){if(!d)return{'success':![],'action':b,'data':null,'message':'Search\x20query\x20is\x20required\x20for\x20\x27search_examples\x27\x20action','suggestions':['Provide\x20a\x20\x27query\x27\x20string\x20(e.g.\x20\x27rental\x27,\x20\x27guard\x27,\x20\x27service\x27,\x20\x27machine\x27)','Searchable\x20fields:\x20title,\x20description,\x20tags,\x20operation_type,\x20industry']};const y=searchExamples(d);return{'success':!![],'action':b,'data':y,'message':'Found\x20'+y['length']+'\x20example(s)\x20matching\x20\x27'+d+'\x27','suggestions':y['length']===0x0?['Try\x20broader\x20terms\x20like\x20\x27service\x27,\x20\x27machine\x27,\x20\x27guard\x27,\x20\x27permission\x27','Try\x20an\x20industry\x20name:\x20\x27rental\x27,\x20\x27retail\x27,\x20\x27general\x27','Use\x20\x27get\x27\x20action\x20with\x20a\x20schema\x20name\x20to\x20see\x20the\x20full\x20JSON\x20Schema']:undefined};}if(b==='get_tool_reference'){if(c){const A=getToolReference(c);if(!A)return{'success':![],'action':b,'data':null,'message':'Tool\x20\x27'+c+'\x27\x20not\x20found\x20in\x20the\x20tool\x20reference.','suggestions':['Omit\x20\x27name\x27\x20to\x20list\x20all\x20tools.','Available\x20tools:\x20'+TOOLS_REFERENCE['map'](C=>C['name'])['join'](',\x20')]};const B=getToolSequence(c);return{'success':!![],'action':b,'data':{'tool':A,'call_sequence':B??null},'message':'Retrieved\x20tool\x20reference:\x20'+c};}if(d){const C=searchToolReference(d);return{'success':!![],'action':b,'data':{'tools':C,'count':C['length']},'message':'Found\x20'+C['length']+'\x20tool(s)\x20matching\x20\x27'+d+'\x27','suggestions':C['length']===0x0?['Try\x20a\x20broader\x20keyword\x20(e.g.\x20\x27onchain\x27,\x20\x27guard\x27,\x20\x27schema\x27),\x20or\x20omit\x20\x27query\x27\x20to\x20list\x20all\x20tools.']:undefined};}const z=TOOLS_REFERENCE['map'](D=>({'name':D['name'],'summary':D['summary'],'actions':D['actions']??[],'notes':D['notes']??[]}));return{'success':!![],'action':b,'data':{'tools':z,'count':z['length']},'message':'Retrieved\x20reference\x20for\x20'+z['length']+'\x20MCP\x20tools.\x20Pass\x20name=\x27<tool>\x27\x20for\x20full\x20detail\x20(params,\x20prerequisites,\x20follow-ups).'};}if(b==='get_guard_design_patterns'){if(c){const E=getGuardDesignPattern(c);if(!E)return{'success':![],'action':b,'data':null,'message':'Guard\x20design\x20pattern\x20\x27'+c+'\x27\x20not\x20found.','suggestions':['Omit\x20\x27name\x27\x20to\x20list\x20the\x20full\x20catalog.','Available\x20pattern\x20ids:\x20'+GUARD_DESIGN_PATTERNS['map'](F=>F['id'])['join'](',\x20')]};return{'success':!![],'action':b,'data':{'pattern':E},'message':'Retrieved\x20Guard\x20design\x20pattern:\x20'+c};}if(d){const F=GUARD_DESIGN_PATTERNS['filter'](H=>H['host']===d),G=F['length']>0x0?F:GUARD_DESIGN_PATTERNS['filter'](H=>H['business_requirement']['toLowerCase']()['includes'](d['toLowerCase']())||H['logic_summary']['toLowerCase']()['includes'](d['toLowerCase']()));return{'success':!![],'action':b,'data':{'patterns':G,'count':G['length'],'filtered_by':F['length']>0x0?'host':'keyword'},'message':'Found\x20'+G['length']+'\x20Guard\x20design\x20pattern(s)\x20matching\x20\x27'+d+'\x27','suggestions':G['length']===0x0?['Filter\x20by\x20host:\x20service_buy_guard,\x20service_allocator_guard,\x20machine_forward,\x20progress_submission,\x20reward_claim,\x20repository_write,\x20arbitration_usage,\x20arbitration_voting,\x20gen_passport']:undefined};}const D=GUARD_DESIGN_PATTERNS['map'](H=>({'id':H['id'],'business_requirement':H['business_requirement'],'host':H['host'],'data_source':H['data_source'],'verifier_level':H['verifier_level'],'logic_summary':H['logic_summary'],'key_queries':H['key_queries'],'notes':H['notes']??[]}));return{'success':!![],'action':b,'data':{'patterns':D,'count':D['length'],'version':GUARD_DESIGN_PATTERNS_VERSION},'message':'Retrieved\x20'+D['length']+'\x20Guard\x20design\x20patterns.\x20Pass\x20name=\x27<pattern_id>\x27\x20for\x20full\x20detail\x20(witness\x20types,\x20mitigated\x20risks,\x20industries).'};}if(b==='get_safety_rules')return{'success':!![],'action':b,'data':{'version':SAFETY_RULES_VERSION,'object_reuse_rules':OBJECT_REUSE_RULES,'create_vs_modify_pattern':CREATE_VS_MODIFY_PATTERN,'immutability_rules':IMMUTABILITY_RULES,'operation_type_classification':OPERATION_TYPE_CLASSIFICATION,'operation_class_meta':OPERATION_CLASS_META,'naming_conventions':NAMING_CONVENTIONS},'message':'Retrieved\x20safety\x20rule\x20tables\x20(reuse\x20/\x20immutability\x20/\x20operation\x20classification\x20/\x20naming).\x20'+'Key\x20points:\x20prefer\x20REUSING\x20existing\x20objects\x20(string\x20reference\x20=\x20reuse,\x20object\x20shape\x20=\x20create);\x20'+'Machine\x20publish\x20locks\x20nodes/pairs/forwards,\x20Service\x20publish\x20locks\x20machine/order_allocators/arbitrations\x20(sales\x20stays\x20mutable);\x20'+'Guard\x20is\x20CREATE-only\x20immutable;\x20on-chain\x20writes\x20require\x20explicit\x20user\x20confirmation.'};if(!areSchemasAvailable())return{'success':![],'action':b,'data':null,'message':'Schema\x20files\x20are\x20not\x20available.\x20Please\x20run\x20\x27npm\x20run\x20generate:schemas\x27\x20first.','suggestions':['Run\x20\x27npm\x20run\x20generate:schemas\x27\x20to\x20generate\x20schema\x20files','Ensure\x20the\x20dist/schemas\x20directory\x20exists']};switch(b){case'list':{const H=listSchemas();return{'success':!![],'action':b,'data':H,'message':'Found\x20'+H['length']+'\x20available\x20schemas'};}case'get':{if(!c)return{'success':![],'action':b,'data':null,'message':'Schema\x20name\x20is\x20required\x20for\x20\x27get\x27\x20action','suggestions':['Provide\x20a\x20schema\x20name','Use\x20\x27list\x27\x20action\x20to\x20see\x20available\x20schemas']};const I=getSchema(c);if(!I){const J=searchSchemas(c)['slice'](0x0,0x5);return{'success':![],'action':b,'data':null,'message':'Schema\x20\x27'+c+'\x27\x20not\x20found','suggestions':J['length']>0x0?J['map'](K=>'Did\x20you\x20mean:\x20'+K['name']+'?'):['Use\x20\x27list\x27\x20action\x20to\x20see\x20available\x20schemas']};}if(h){const K=writeResponseToFile(I,h);if(K)return{'success':!![],'action':b,'data':null,'message':'Schema\x20\x27'+c+'\x27\x20written\x20to\x20file:\x20'+K,'output_file_path':K,'suggestions':['Use\x20Read\x20tool\x20to\x20open\x20'+K]};}return{'success':!![],'action':b,'data':I,'message':'Retrieved\x20schema:\x20'+c};}case'get_field':{if(!c||!f)return{'success':![],'action':b,'data':null,'message':'Both\x20\x27name\x27\x20and\x20\x27field_path\x27\x20are\x20required\x20for\x20\x27get_field\x27\x20action','suggestions':['Example:\x20{action:\x20\x27get_field\x27,\x20name:\x20\x27onchain_operations_machine\x27,\x20field_path:\x20\x27data.node\x27}','Use\x20\x27get\x27\x20action\x20to\x20retrieve\x20the\x20full\x20schema']};const L=getSchemaField(c,f);if(!L)return{'success':![],'action':b,'data':null,'message':'Field\x20path\x20\x27'+f+'\x27\x20not\x20found\x20in\x20schema\x20\x27'+c+'\x27','suggestions':['Check\x20the\x20field\x20path\x20(dot-separated,\x20e.g.\x20\x27data.node\x27)','Use\x20\x27get\x27\x20action\x20to\x20see\x20the\x20full\x20schema\x20structure']};return{'success':!![],'action':b,'data':L,'message':'Retrieved\x20field\x20\x27'+f+'\x27\x20from\x20schema\x20\x27'+c+'\x27'};}case'search':{if(!d)return{'success':![],'action':b,'data':null,'message':'Search\x20query\x20is\x20required\x20for\x20\x27search\x27\x20action'};const M=searchSchemas(d);return{'success':!![],'action':b,'data':M,'message':'Found\x20'+M['length']+'\x20schemas\x20matching\x20\x27'+d+'\x27'};}case'list_operations':{const N=listOperations();return{'success':!![],'action':b,'data':N,'message':'Found\x20'+N['length']+'\x20on-chain\x20operations'};}case'get_output':{if(!c)return{'success':![],'action':b,'data':null,'message':'Tool\x20name\x20is\x20required\x20for\x20\x27get_output\x27\x20action','suggestions':['Provide\x20a\x20tool\x20name','Use\x20\x27list\x27\x20action\x20to\x20see\x20available\x20tools\x20and\x20their\x20outputPath']};const O=getOutputSchema(c);if(!O){const P=listSchemas(),Q=P['find'](S=>S['name']===c);if(Q)return{'success':![],'action':b,'data':null,'message':'Tool\x20\x27'+c+'\x27\x20exists\x20but\x20has\x20no\x20output\x20schema\x20file.\x20The\x20tool\x20may\x20not\x20declare\x20an\x20outputSchema,\x20or\x20the\x20schema\x20file\x20was\x20not\x20generated.','suggestions':['Use\x20\x27get\x27\x20action\x20with\x20name=\x27'+c+'\x27\x20to\x20retrieve\x20its\x20input\x20schema']};const R=searchSchemas(c)['slice'](0x0,0x5);return{'success':![],'action':b,'data':null,'message':'Tool\x20\x27'+c+'\x27\x20not\x20found','suggestions':R['length']>0x0?R['map'](S=>'Did\x20you\x20mean:\x20'+S['name']+'?'):['Use\x20\x27list\x27\x20action\x20to\x20see\x20available\x20tools']};}if(h){const S=writeResponseToFile(O,h);if(S)return{'success':!![],'action':b,'data':null,'message':'Output\x20schema\x20\x27'+c+'\x27\x20written\x20to\x20file:\x20'+S,'output_file_path':S,'suggestions':['Use\x20Read\x20tool\x20to\x20open\x20'+S]};}return{'success':!![],'action':b,'data':O,'message':'Retrieved\x20output\x20schema:\x20'+c};}default:return{'success':![],'action':b,'data':null,'message':'Unknown\x20action:\x20'+b,'suggestions':['Use\x20\x27list\x27,\x20\x27get\x27,\x20\x27get_field\x27,\x20\x27get_output\x27,\x20\x27search\x27,\x20\x27list_operations\x27,\x20\x27get_guard_templates\x27,\x20or\x20\x27search_examples\x27']};}}
|