agentmesh-ai 0.4.0 → 0.5.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.
Files changed (101) hide show
  1. package/GUIDE-EN.md +421 -0
  2. package/GUIDE.md +85 -4
  3. package/README.md +91 -8
  4. package/dist/cli/commands/init.d.ts.map +1 -1
  5. package/dist/cli/commands/init.js +29 -2
  6. package/dist/cli/commands/init.js.map +1 -1
  7. package/dist/cli/commands/join.d.ts.map +1 -1
  8. package/dist/cli/commands/join.js +34 -2
  9. package/dist/cli/commands/join.js.map +1 -1
  10. package/dist/cli/commands/status.js +1 -1
  11. package/dist/cli/commands/status.js.map +1 -1
  12. package/dist/cloud/supabase-client.d.ts +14 -1
  13. package/dist/cloud/supabase-client.d.ts.map +1 -1
  14. package/dist/cloud/supabase-client.js +56 -0
  15. package/dist/cloud/supabase-client.js.map +1 -1
  16. package/dist/events/emitter.d.ts +11 -0
  17. package/dist/events/emitter.d.ts.map +1 -0
  18. package/dist/events/emitter.js +81 -0
  19. package/dist/events/emitter.js.map +1 -0
  20. package/dist/events/index.d.ts +3 -0
  21. package/dist/events/index.d.ts.map +1 -0
  22. package/dist/events/index.js +3 -0
  23. package/dist/events/index.js.map +1 -0
  24. package/dist/events/webhook.d.ts +10 -0
  25. package/dist/events/webhook.d.ts.map +1 -0
  26. package/dist/events/webhook.js +153 -0
  27. package/dist/events/webhook.js.map +1 -0
  28. package/dist/federation/index.d.ts +4 -0
  29. package/dist/federation/index.d.ts.map +1 -0
  30. package/dist/federation/index.js +3 -0
  31. package/dist/federation/index.js.map +1 -0
  32. package/dist/federation/link.d.ts +10 -0
  33. package/dist/federation/link.d.ts.map +1 -0
  34. package/dist/federation/link.js +86 -0
  35. package/dist/federation/link.js.map +1 -0
  36. package/dist/federation/reader.d.ts +12 -0
  37. package/dist/federation/reader.d.ts.map +1 -0
  38. package/dist/federation/reader.js +60 -0
  39. package/dist/federation/reader.js.map +1 -0
  40. package/dist/federation/types.d.ts +26 -0
  41. package/dist/federation/types.d.ts.map +1 -0
  42. package/dist/federation/types.js +2 -0
  43. package/dist/federation/types.js.map +1 -0
  44. package/dist/index.d.ts +3 -0
  45. package/dist/index.d.ts.map +1 -1
  46. package/dist/index.js +3 -0
  47. package/dist/index.js.map +1 -1
  48. package/dist/mcp/conversation-tools.d.ts.map +1 -1
  49. package/dist/mcp/conversation-tools.js +6 -5
  50. package/dist/mcp/conversation-tools.js.map +1 -1
  51. package/dist/mcp/index.js +1 -1
  52. package/dist/mcp/index.js.map +1 -1
  53. package/dist/mcp/memory-tools.d.ts.map +1 -1
  54. package/dist/mcp/memory-tools.js +322 -16
  55. package/dist/mcp/memory-tools.js.map +1 -1
  56. package/dist/memory/consolidator.d.ts +14 -6
  57. package/dist/memory/consolidator.d.ts.map +1 -1
  58. package/dist/memory/consolidator.js +47 -0
  59. package/dist/memory/consolidator.js.map +1 -1
  60. package/dist/memory/merge-view.d.ts.map +1 -1
  61. package/dist/memory/merge-view.js +3 -0
  62. package/dist/memory/merge-view.js.map +1 -1
  63. package/dist/memory/scorer.d.ts +28 -0
  64. package/dist/memory/scorer.d.ts.map +1 -0
  65. package/dist/memory/scorer.js +149 -0
  66. package/dist/memory/scorer.js.map +1 -0
  67. package/dist/memory/timeline.d.ts +6 -0
  68. package/dist/memory/timeline.d.ts.map +1 -0
  69. package/dist/memory/timeline.js +85 -0
  70. package/dist/memory/timeline.js.map +1 -0
  71. package/dist/memory/types.d.ts +37 -2
  72. package/dist/memory/types.d.ts.map +1 -1
  73. package/dist/memory/write-utils.d.ts +6 -1
  74. package/dist/memory/write-utils.d.ts.map +1 -1
  75. package/dist/memory/write-utils.js +25 -0
  76. package/dist/memory/write-utils.js.map +1 -1
  77. package/dist/protocol/index.d.ts +25 -0
  78. package/dist/protocol/index.d.ts.map +1 -0
  79. package/dist/protocol/index.js +22 -0
  80. package/dist/protocol/index.js.map +1 -0
  81. package/dist/sdk.d.ts +54 -1
  82. package/dist/sdk.d.ts.map +1 -1
  83. package/dist/sdk.js +107 -2
  84. package/dist/sdk.js.map +1 -1
  85. package/dist/templates/export.d.ts +17 -0
  86. package/dist/templates/export.d.ts.map +1 -0
  87. package/dist/templates/export.js +49 -0
  88. package/dist/templates/export.js.map +1 -0
  89. package/dist/templates/import.d.ts +19 -0
  90. package/dist/templates/import.d.ts.map +1 -0
  91. package/dist/templates/import.js +83 -0
  92. package/dist/templates/import.js.map +1 -0
  93. package/dist/templates/index.d.ts +4 -0
  94. package/dist/templates/index.d.ts.map +1 -0
  95. package/dist/templates/index.js +3 -0
  96. package/dist/templates/index.js.map +1 -0
  97. package/dist/templates/types.d.ts +38 -0
  98. package/dist/templates/types.d.ts.map +1 -0
  99. package/dist/templates/types.js +2 -0
  100. package/dist/templates/types.js.map +1 -0
  101. package/package.json +5 -1
@@ -0,0 +1,83 @@
1
+ /**
2
+ * Import a template into a team's shared memory.
3
+ */
4
+ import { cloudWriteMemory } from '../cloud/supabase-client.js';
5
+ import { getSupabaseClient } from '../cloud/supabase-client.js';
6
+ /**
7
+ * Import template memories into a team.
8
+ * Each memory is written as 'auto' status under a system agent.
9
+ */
10
+ export async function importTemplate(teamId, agentId, agentRole, agentTool, template) {
11
+ let imported = 0;
12
+ let skipped = 0;
13
+ const errors = [];
14
+ for (const mem of template.memories) {
15
+ try {
16
+ const result = await cloudWriteMemory(teamId, agentId, agentRole, agentTool, {
17
+ topic: mem.topic,
18
+ content: mem.content,
19
+ tags: [...mem.tags, `template:${template.name}`],
20
+ category: mem.category,
21
+ summary: mem.summary,
22
+ status: mem.status ?? 'auto',
23
+ references: mem.references,
24
+ });
25
+ if (result.success) {
26
+ imported++;
27
+ }
28
+ else if (result.blocked) {
29
+ skipped++;
30
+ }
31
+ else {
32
+ errors.push(`"${mem.topic}": ${result.reason}`);
33
+ }
34
+ }
35
+ catch (err) {
36
+ errors.push(`"${mem.topic}": ${err.message}`);
37
+ }
38
+ }
39
+ return { imported, skipped, errors };
40
+ }
41
+ /**
42
+ * Save a template to the cloud template library.
43
+ * The teamId parameter is the authenticated caller — never trust template.author_team_id.
44
+ */
45
+ export async function saveTemplateToCloud(template, teamId) {
46
+ const supabase = getSupabaseClient();
47
+ const verifiedTeamId = teamId ?? template.author_team_id;
48
+ const { data, error } = await supabase
49
+ .from('team_templates')
50
+ .insert({
51
+ team_id: verifiedTeamId,
52
+ name: template.name,
53
+ description: template.description,
54
+ tags: template.tags,
55
+ content: template,
56
+ public: template.public,
57
+ })
58
+ .select('id')
59
+ .single();
60
+ if (error)
61
+ throw new Error(`Failed to save template: ${error.message}`);
62
+ return data.id;
63
+ }
64
+ /** List public templates, optionally filtered by tags. */
65
+ export async function listPublicTemplates(tags) {
66
+ const supabase = getSupabaseClient();
67
+ let query = supabase
68
+ .from('team_templates')
69
+ .select('*')
70
+ .eq('public', true)
71
+ .order('downloads', { ascending: false })
72
+ .limit(20);
73
+ if (tags && tags.length > 0) {
74
+ query = query.overlaps('tags', tags);
75
+ }
76
+ const { data } = await query;
77
+ return (data ?? []).map(row => ({
78
+ ...row.content,
79
+ id: row.id,
80
+ downloads: row.downloads,
81
+ }));
82
+ }
83
+ //# sourceMappingURL=import.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"import.js","sourceRoot":"","sources":["../../src/templates/import.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ export type { TeamTemplate, TemplateMemory, TemplateAgentRole } from './types.js';
2
+ export { exportTemplate, type ExportOptions } from './export.js';
3
+ export { importTemplate, saveTemplateToCloud, listPublicTemplates, type ImportResult } from './import.js';
4
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC"}
@@ -0,0 +1,3 @@
1
+ export { exportTemplate } from './export.js';
2
+ export { importTemplate, saveTemplateToCloud, listPublicTemplates } from './import.js';
3
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAsB,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,mBAAmB,EAAqB,MAAM,aAAa,CAAC"}
@@ -0,0 +1,38 @@
1
+ /**
2
+ * Team template types — reusable knowledge packs.
3
+ */
4
+ import type { MemoryCategory, MemoryStatus, AgentCapability } from '../memory/types.js';
5
+ /** A reusable template of team knowledge. */
6
+ export interface TeamTemplate {
7
+ id?: string;
8
+ name: string;
9
+ description: string;
10
+ author_team_id?: string;
11
+ version: string;
12
+ tags: string[];
13
+ /** Memory entries to import. */
14
+ memories: TemplateMemory[];
15
+ /** Suggested agent roles with capabilities. */
16
+ agent_roles?: TemplateAgentRole[];
17
+ /** Metadata. */
18
+ public: boolean;
19
+ downloads?: number;
20
+ created_at?: string;
21
+ }
22
+ /** A memory entry within a template. */
23
+ export interface TemplateMemory {
24
+ topic: string;
25
+ content: string;
26
+ tags: string[];
27
+ category: MemoryCategory;
28
+ summary?: string;
29
+ status?: MemoryStatus;
30
+ references?: string[];
31
+ }
32
+ /** A suggested agent role within a template. */
33
+ export interface TemplateAgentRole {
34
+ role: string;
35
+ tool?: string;
36
+ capabilities?: AgentCapability[];
37
+ }
38
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/templates/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAExF,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IAEf,gCAAgC;IAChC,QAAQ,EAAE,cAAc,EAAE,CAAC;IAE3B,+CAA+C;IAC/C,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAElC,gBAAgB;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wCAAwC;AACxC,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,gDAAgD;AAChD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;CAClC"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/templates/types.ts"],"names":[],"mappings":""}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "agentmesh-ai",
3
- "version": "0.4.0",
3
+ "version": "0.5.0",
4
4
  "description": "Let your AI agents share knowledge and talk to each other",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -21,6 +21,10 @@
21
21
  "./mcp": {
22
22
  "types": "./dist/mcp/index.d.ts",
23
23
  "default": "./dist/mcp/index.js"
24
+ },
25
+ "./protocol": {
26
+ "types": "./dist/protocol/index.d.ts",
27
+ "default": "./dist/protocol/index.js"
24
28
  }
25
29
  },
26
30
  "scripts": {