@wowok/agent-mcp 2.6.0 → 2.6.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.
Files changed (133) hide show
  1. package/README.md +5 -3
  2. package/dist/extensions/capability-manifest.d.ts +125 -0
  3. package/dist/extensions/capability-manifest.js +594 -0
  4. package/dist/extensions/constraint-registry.d.ts +24 -0
  5. package/dist/extensions/constraint-registry.js +196 -0
  6. package/dist/extensions/index.d.ts +12 -0
  7. package/dist/extensions/index.js +6 -0
  8. package/dist/extensions/metric-registry.d.ts +26 -0
  9. package/dist/extensions/metric-registry.js +257 -0
  10. package/dist/extensions/mode-evaluator.d.ts +15 -0
  11. package/dist/extensions/mode-evaluator.js +170 -0
  12. package/dist/extensions/modes.d.ts +2 -0
  13. package/dist/extensions/modes.js +407 -0
  14. package/dist/extensions/registry.d.ts +48 -0
  15. package/dist/extensions/registry.js +629 -0
  16. package/dist/extensions/types.d.ts +218 -0
  17. package/dist/extensions/types.js +1 -0
  18. package/dist/knowledge/deployment-scanner.d.ts +3 -0
  19. package/dist/knowledge/deployment-scanner.js +64 -3
  20. package/dist/knowledge/guard-risk.d.ts +13 -0
  21. package/dist/knowledge/guard-risk.js +57 -0
  22. package/dist/knowledge/guard-templates.js +278 -0
  23. package/dist/knowledge/machine-templates.js +20 -1
  24. package/dist/knowledge/service-confirm.d.ts +14 -5
  25. package/dist/knowledge/service-confirm.js +116 -8
  26. package/dist/knowledge/tool-constraints.js +6 -2
  27. package/dist/project/deployment-bridge.d.ts +1 -1
  28. package/dist/project/deployment-bridge.js +27 -4
  29. package/dist/project/deployment-doc.d.ts +3 -0
  30. package/dist/project/deployment-doc.js +72 -10
  31. package/dist/project/evaluation.d.ts +2 -0
  32. package/dist/project/evaluation.js +569 -84
  33. package/dist/project/graph-builder.d.ts +4 -1
  34. package/dist/project/graph-builder.js +126 -61
  35. package/dist/project/graph.d.ts +1 -0
  36. package/dist/project/handlers.d.ts +219 -5
  37. package/dist/project/handlers.js +819 -9
  38. package/dist/project/stage-gate.d.ts +4 -0
  39. package/dist/project/stage-gate.js +64 -5
  40. package/dist/project/task-tracker.d.ts +26 -0
  41. package/dist/project/task-tracker.js +78 -0
  42. package/dist/safety/preview.js +16 -0
  43. package/dist/schema/call/allocation.d.ts +16 -16
  44. package/dist/schema/call/base.d.ts +21 -13
  45. package/dist/schema/call/base.js +27 -6
  46. package/dist/schema/call/bridge.d.ts +5 -5
  47. package/dist/schema/call/bridge.js +3 -1
  48. package/dist/schema/call/demand.d.ts +23 -31
  49. package/dist/schema/call/guard.js +1 -1
  50. package/dist/schema/call/machine.d.ts +402 -376
  51. package/dist/schema/call/order.d.ts +149 -228
  52. package/dist/schema/call/order.js +7 -3
  53. package/dist/schema/call/payment.d.ts +183 -3
  54. package/dist/schema/call/payment.js +21 -3
  55. package/dist/schema/call/personal.d.ts +241 -52
  56. package/dist/schema/call/progress.d.ts +53 -61
  57. package/dist/schema/call/progress.js +18 -4
  58. package/dist/schema/call/repository.d.ts +23 -31
  59. package/dist/schema/call/semantic.d.ts +1 -1
  60. package/dist/schema/call/semantic.js +30 -1
  61. package/dist/schema/call/service.d.ts +95 -119
  62. package/dist/schema/call/service.js +22 -1
  63. package/dist/schema/common/index.d.ts +11 -2
  64. package/dist/schema/common/index.js +43 -14
  65. package/dist/schema/local/index.d.ts +32 -35
  66. package/dist/schema/local/index.js +23 -5
  67. package/dist/schema/messenger/index.d.ts +274 -46
  68. package/dist/schema/operations.d.ts +680 -539
  69. package/dist/schema/operations.js +22 -0
  70. package/dist/schema/project/index.d.ts +1796 -80
  71. package/dist/schema/project/index.js +304 -14
  72. package/dist/schema/query/index.d.ts +705 -349
  73. package/dist/schema/query/index.js +164 -31
  74. package/dist/schema/schema-query/index.d.ts +15 -3
  75. package/dist/schema/schema-query/index.js +23 -5
  76. package/dist/schema/utils/node-parser.js +7 -4
  77. package/dist/schema-query/index.d.ts +7 -1
  78. package/dist/schema-query/index.js +204 -4
  79. package/dist/schemas/account_operation.output.json +7 -1
  80. package/dist/schemas/account_operation.schema.json +2 -2
  81. package/dist/schemas/bridge_operation.output.json +6 -0
  82. package/dist/schemas/bridge_operation.schema.json +1 -1
  83. package/dist/schemas/guard-templates.json +379 -0
  84. package/dist/schemas/guard2file.schema.json +1 -1
  85. package/dist/schemas/index.json +1 -1
  86. package/dist/schemas/local_info_operation.output.json +6 -0
  87. package/dist/schemas/local_mark_operation.output.json +7 -1
  88. package/dist/schemas/local_mark_operation.schema.json +1 -1
  89. package/dist/schemas/machineNode2file.schema.json +1 -1
  90. package/dist/schemas/messenger_operation.schema.json +4 -4
  91. package/dist/schemas/onchain_events.output.json +1 -1
  92. package/dist/schemas/onchain_operations.schema.json +348 -296
  93. package/dist/schemas/onchain_operations_allocation.schema.json +34 -25
  94. package/dist/schemas/onchain_operations_arbitration.schema.json +8 -8
  95. package/dist/schemas/onchain_operations_contact.schema.json +8 -8
  96. package/dist/schemas/onchain_operations_demand.schema.json +8 -8
  97. package/dist/schemas/onchain_operations_gen_passport.schema.json +14 -14
  98. package/dist/schemas/onchain_operations_gen_proof.schema.json +2 -2
  99. package/dist/schemas/onchain_operations_guard.schema.json +1 -1
  100. package/dist/schemas/onchain_operations_machine.schema.json +41 -33
  101. package/dist/schemas/onchain_operations_order.schema.json +71 -77
  102. package/dist/schemas/onchain_operations_payment.schema.json +141 -111
  103. package/dist/schemas/onchain_operations_permission.schema.json +2 -2
  104. package/dist/schemas/onchain_operations_personal.schema.json +7 -7
  105. package/dist/schemas/onchain_operations_progress.schema.json +8 -8
  106. package/dist/schemas/onchain_operations_proof.schema.json +7 -7
  107. package/dist/schemas/onchain_operations_repository.schema.json +8 -8
  108. package/dist/schemas/onchain_operations_reward.schema.json +10 -10
  109. package/dist/schemas/onchain_operations_service.schema.json +46 -35
  110. package/dist/schemas/onchain_operations_treasury.schema.json +8 -8
  111. package/dist/schemas/onchain_table_data.output.json +33 -25
  112. package/dist/schemas/onchain_table_data.schema.json +12 -12
  113. package/dist/schemas/project_operation.output.json +1175 -23
  114. package/dist/schemas/project_operation.schema.json +40 -4
  115. package/dist/schemas/query_toolkit.output.json +104 -76
  116. package/dist/schemas/query_toolkit.schema.json +9 -9
  117. package/dist/schemas/schema_query.output.json +7 -3
  118. package/dist/schemas/schema_query.schema.json +17 -3
  119. package/dist/tools/handlers/local.js +20 -5
  120. package/dist/tools/handlers/onchain.js +23 -0
  121. package/dist/tools/handlers/project.js +52 -3
  122. package/dist/tools/handlers/query.js +27 -0
  123. package/dist/tools/handlers/schema-query.js +19 -0
  124. package/dist/tools/handlers/task-status.d.ts +170 -0
  125. package/dist/tools/handlers/task-status.js +55 -0
  126. package/dist/tools/handlers/wip.js +47 -1
  127. package/dist/tools/index.js +211 -7
  128. package/dist/tools/retry.d.ts +8 -0
  129. package/dist/tools/retry.js +85 -0
  130. package/dist/tools/wip-deploy-assist.d.ts +28 -0
  131. package/dist/tools/wip-deploy-assist.js +278 -0
  132. package/package.json +2 -2
  133. package/dist/schemas/guard-node-examples.md +0 -199
package/README.md CHANGED
@@ -27,7 +27,7 @@ Docs: [https://github.com/wowok-ai/docs/](https://github.com/wowok-ai/docs/)
27
27
 
28
28
  ### 2. Install WoWok Skills (Recommended)
29
29
 
30
- **Skills significantly reduce the learning curve and usage difficulty of the MCP Server.** They provide structured guidance for AI assistants on complex system building, tool usage, and safety protocols.
30
+ **Skills significantly reduce the learning curve and usage difficulty of the MCP Server.** They provide structured guidance for AI assistants on complex system building, tool usage, and safety protocols. See the [WoWok Skills repository](https://github.com/wowok-ai/skills) for full details.
31
31
 
32
32
  ```bash
33
33
  # Personal (global) — available in all sessions:
@@ -37,10 +37,12 @@ npm install -g @wowok/skills
37
37
  cd your-project
38
38
  wowok-skills init # Claude Code (default)
39
39
  wowok-skills init --target agents # Trae IDE
40
- wowok-skills init --target all # All 6 supported clients
40
+ wowok-skills init --target all # All 10 supported clients
41
41
  ```
42
42
 
43
- **Supported clients:** Claude Code, OpenAI Codex, Trae IDE, CodeBuddy, Cursor, GitHub Copilot.
43
+ **Supported clients:** Claude Code, OpenAI Codex, ChatGPT Desktop (Codex Mode), Trae IDE, CodeBuddy, Cursor, Windsurf, Qoder, Roo Code, GitHub Copilot.
44
+
45
+ > **Note:** The skills package auto-installs and configures the `@wowok/agent-mcp` MCP server. Set `WOWOK_SKILLS_NO_MCP=1` to skip MCP management.
44
46
 
45
47
  #### Available Skills
46
48
 
@@ -0,0 +1,125 @@
1
+ import type { ProjectObjectType } from "../project/namespace.js";
2
+ export type CapabilityModule = "puzzle" | "risk" | "translation" | "templates" | "confirm" | "context" | "ledger" | "schema" | "handler";
3
+ export type CapabilityCategory = "data_model" | "validation" | "lifecycle" | "fund_flow" | "trust" | "workflow" | "communication" | "evidence" | "query";
4
+ export type IndustryAgnostic = "high" | "medium" | "low";
5
+ export interface CapabilityRiskProfile {
6
+ funds_risk: "high" | "medium" | "low";
7
+ trust_risk: "high" | "medium" | "low";
8
+ delivery_risk: "high" | "medium" | "low";
9
+ compliance_risk: "high" | "medium" | "low";
10
+ known_risks: string[];
11
+ }
12
+ export interface CapabilityBenefitProfile {
13
+ automation_level: "high" | "medium" | "low";
14
+ trust_boost: "high" | "medium" | "low";
15
+ efficiency_gain: "high" | "medium" | "low";
16
+ benefits: string[];
17
+ }
18
+ export interface CapabilityConstraints {
19
+ must_pair_with?: string[];
20
+ conflicts_with?: string[];
21
+ max_single_transaction?: number;
22
+ requires_evidence?: boolean;
23
+ other_constraints?: string[];
24
+ }
25
+ export interface CapabilityCard {
26
+ capability_id: string;
27
+ display_name: string;
28
+ description: string;
29
+ object_type: ProjectObjectType;
30
+ module: CapabilityModule;
31
+ category: CapabilityCategory;
32
+ industry_agnostic: IndustryAgnostic;
33
+ config_template: Record<string, unknown>;
34
+ industry_overrides?: Record<string, Record<string, unknown>>;
35
+ observed_in_industries: Record<string, number>;
36
+ success_count: number;
37
+ failure_count: number;
38
+ known_failure_modes: string[];
39
+ depends_on_capabilities?: string[];
40
+ referenced_by_skills?: string[];
41
+ risk_profile?: CapabilityRiskProfile;
42
+ benefit_profile?: CapabilityBenefitProfile;
43
+ constraints?: CapabilityConstraints;
44
+ version: string;
45
+ superseded_by?: string;
46
+ }
47
+ export interface CapabilityGraphEdge {
48
+ from: string;
49
+ to: string;
50
+ edge_kind: "requires" | "optional" | "conflicts";
51
+ phase: "create" | "publish" | "runtime";
52
+ description?: string;
53
+ }
54
+ export interface CapabilityGraph {
55
+ nodes: Map<string, CapabilityCard>;
56
+ edges: CapabilityGraphEdge[];
57
+ }
58
+ export interface MigrationEvaluation {
59
+ feasibility_score: number;
60
+ covered_capabilities: string[];
61
+ missing_capabilities: string[];
62
+ conflicting_capabilities: Array<{
63
+ capability_id: string;
64
+ source_config: unknown;
65
+ target_config: unknown;
66
+ diff_summary: string;
67
+ }>;
68
+ recommendations: string[];
69
+ }
70
+ export interface CoverageReport {
71
+ industry: string;
72
+ declared_count: number;
73
+ expected_count: number;
74
+ coverage_percentage: number;
75
+ missing_capabilities: string[];
76
+ }
77
+ export interface ExperienceUpdate {
78
+ capability_id: string;
79
+ update_type: "config_template" | "industry_overrides" | "known_failure_modes" | "new_card";
80
+ payload: unknown;
81
+ source: string;
82
+ }
83
+ export interface VerificationReport {
84
+ project_id: string;
85
+ industry: string;
86
+ result: "success" | "failure" | "partial";
87
+ capabilities_used: string[];
88
+ failure_reasons?: string[];
89
+ }
90
+ export declare class CapabilityRegistry {
91
+ private static instance;
92
+ private cards;
93
+ private edges;
94
+ private initialized;
95
+ static Instance(): CapabilityRegistry;
96
+ private constructor();
97
+ registerCard(card: CapabilityCard): boolean;
98
+ getCard(capabilityId: string): CapabilityCard | undefined;
99
+ listCards(filter?: {
100
+ objectType?: ProjectObjectType;
101
+ module?: CapabilityModule;
102
+ industryAgnostic?: IndustryAgnostic;
103
+ industry?: string;
104
+ }): CapabilityCard[];
105
+ registerEdge(edge: CapabilityGraphEdge): void;
106
+ getGraph(): CapabilityGraph;
107
+ getDependencies(capabilityId: string): CapabilityCard[];
108
+ getDependents(capabilityId: string): CapabilityCard[];
109
+ getCapabilitiesByIndustry(industry: string): CapabilityCard[];
110
+ getCapabilitiesByObject(objectType: ProjectObjectType): CapabilityCard[];
111
+ evaluateMigration(source: string, target: string): MigrationEvaluation;
112
+ findPurityViolations(): CapabilityCard[];
113
+ recordUsage(capabilityId: string, industry: string): void;
114
+ recordSuccess(capabilityId: string): void;
115
+ recordFailure(capabilityId: string, reason: string): void;
116
+ recordVerificationReport(report: VerificationReport): void;
117
+ getCapabilitiesForExtension(capabilitiesUsed: string[]): CapabilityCard[];
118
+ evaluateExtensionCoverage(industry: string, capabilitiesUsed: string[]): CoverageReport;
119
+ private registerBuiltins;
120
+ private registerBuiltinEdges;
121
+ private computeConfigDiff;
122
+ }
123
+ export declare function getCapabilityRegistry(): CapabilityRegistry;
124
+ export declare const CAPABILITY_MANIFEST_VERSION = 1;
125
+ export declare function recordCapabilitiesUsed(industry: string, capabilitiesUsed: string[]): void;