@shardworks/nexus-core 0.1.12 → 0.1.14

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 (41) hide show
  1. package/dist/bundle.d.ts +7 -7
  2. package/dist/bundle.d.ts.map +1 -1
  3. package/dist/bundle.js +28 -39
  4. package/dist/bundle.js.map +1 -1
  5. package/dist/guild-config.d.ts +11 -15
  6. package/dist/guild-config.d.ts.map +1 -1
  7. package/dist/guild-config.js +3 -3
  8. package/dist/guild-config.js.map +1 -1
  9. package/dist/index.d.ts +1 -1
  10. package/dist/index.d.ts.map +1 -1
  11. package/dist/index.js +1 -1
  12. package/dist/index.js.map +1 -1
  13. package/dist/init-guild.d.ts.map +1 -1
  14. package/dist/init-guild.js +15 -3
  15. package/dist/init-guild.js.map +1 -1
  16. package/dist/install-tool.d.ts +6 -9
  17. package/dist/install-tool.d.ts.map +1 -1
  18. package/dist/install-tool.js +27 -36
  19. package/dist/install-tool.js.map +1 -1
  20. package/dist/instantiate.d.ts.map +1 -1
  21. package/dist/instantiate.js +7 -9
  22. package/dist/instantiate.js.map +1 -1
  23. package/dist/preconditions.d.ts +11 -15
  24. package/dist/preconditions.d.ts.map +1 -1
  25. package/dist/preconditions.js +16 -16
  26. package/dist/preconditions.js.map +1 -1
  27. package/dist/rehydrate.d.ts +1 -1
  28. package/dist/rehydrate.d.ts.map +1 -1
  29. package/dist/rehydrate.js +14 -14
  30. package/dist/rehydrate.js.map +1 -1
  31. package/dist/remove-tool.d.ts +2 -3
  32. package/dist/remove-tool.d.ts.map +1 -1
  33. package/dist/remove-tool.js +13 -19
  34. package/dist/remove-tool.js.map +1 -1
  35. package/dist/{implement.d.ts → tool.d.ts} +16 -16
  36. package/dist/tool.d.ts.map +1 -0
  37. package/dist/{implement.js → tool.js} +8 -8
  38. package/dist/tool.js.map +1 -0
  39. package/package.json +1 -1
  40. package/dist/implement.d.ts.map +0 -1
  41. package/dist/implement.js.map +0 -1
@@ -3,13 +3,13 @@ import path from 'node:path';
3
3
  import { execFileSync } from 'node:child_process';
4
4
  import { readGuildConfig, writeGuildConfig } from "./guild-config.js";
5
5
  const DIR_MAP = {
6
- implements: 'implements',
6
+ tools: 'tools',
7
7
  engines: 'engines',
8
8
  curricula: 'training/curricula',
9
9
  temperaments: 'training/temperaments',
10
10
  };
11
11
  /** The registries in guild.json that can contain tools, in search order. */
12
- const REGISTRIES = ['implements', 'engines', 'curricula', 'temperaments'];
12
+ const REGISTRIES = ['tools', 'engines', 'curricula', 'temperaments'];
13
13
  function git(args, cwd) {
14
14
  execFileSync('git', args, { cwd, stdio: 'pipe' });
15
15
  }
@@ -42,7 +42,6 @@ export function removeTool(opts) {
42
42
  throw new Error(`Tool "${name}" not found in guild.json.`);
43
43
  }
44
44
  const entry = config[foundCategory][name];
45
- const slot = 'slot' in entry ? entry.slot : '';
46
45
  // Clean up npm-installed packages from node_modules
47
46
  const packageName = getPackageName(entry);
48
47
  const upstream = 'upstream' in entry ? entry.upstream : null;
@@ -74,31 +73,26 @@ export function removeTool(opts) {
74
73
  }
75
74
  }
76
75
  }
77
- // Remove on-disk directory (the specific slot)
76
+ // Remove on-disk directory
78
77
  const parentDir = DIR_MAP[foundCategory];
79
- const toolDir = path.join(home, parentDir, name, slot);
80
- const toolParent = path.join(home, parentDir, name);
78
+ const toolDir = path.join(home, parentDir, name);
81
79
  if (fs.existsSync(toolDir)) {
82
80
  fs.rmSync(toolDir, { recursive: true });
83
81
  }
84
- // Remove the parent name directory if now empty
85
- if (fs.existsSync(toolParent) && fs.readdirSync(toolParent).length === 0) {
86
- fs.rmdirSync(toolParent);
87
- }
88
82
  // Deregister from guild.json
89
83
  delete config[foundCategory][name];
90
- // Clean up role references for implements
91
- if (foundCategory === 'implements') {
92
- // Remove from baseImplements
93
- const baseIdx = config.baseImplements.indexOf(name);
84
+ // Clean up role references for tools
85
+ if (foundCategory === 'tools') {
86
+ // Remove from baseTools
87
+ const baseIdx = config.baseTools.indexOf(name);
94
88
  if (baseIdx !== -1) {
95
- config.baseImplements.splice(baseIdx, 1);
89
+ config.baseTools.splice(baseIdx, 1);
96
90
  }
97
- // Remove from all role implement lists
91
+ // Remove from all role tool lists
98
92
  for (const role of Object.values(config.roles)) {
99
- const roleIdx = role.implements.indexOf(name);
93
+ const roleIdx = role.tools.indexOf(name);
100
94
  if (roleIdx !== -1) {
101
- role.implements.splice(roleIdx, 1);
95
+ role.tools.splice(roleIdx, 1);
102
96
  }
103
97
  }
104
98
  }
@@ -106,6 +100,6 @@ export function removeTool(opts) {
106
100
  // Commit
107
101
  git(['add', '-A'], home);
108
102
  git(['commit', '-m', `Remove ${foundCategory.slice(0, -1)} ${name}`], home);
109
- return { category: foundCategory, name, slot, removedFrom: toolDir };
103
+ return { category: foundCategory, name, removedFrom: toolDir };
110
104
  }
111
105
  //# sourceMappingURL=remove-tool.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"remove-tool.js","sourceRoot":"","sources":["../src/remove-tool.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"remove-tool.js","sourceRoot":"","sources":["../src/remove-tool.ts"],"names":[],"mappings":"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"}
@@ -1,16 +1,16 @@
1
1
  /**
2
- * Implement SDK — the primary authoring interface for module-based implements.
2
+ * Tool SDK — the primary authoring interface for module-based tools.
3
3
  *
4
- * Use `implement()` to define a typed implement with Zod parameter schemas.
4
+ * Use `tool()` to define a typed tool with Zod parameter schemas.
5
5
  * The returned definition is what the MCP engine imports and registers as a tool,
6
6
  * what the CLI uses to auto-generate subcommands, and what engines import directly.
7
7
  *
8
8
  * @example
9
9
  * ```typescript
10
- * import { implement } from '@shardworks/nexus-core';
10
+ * import { tool } from '@shardworks/nexus-core';
11
11
  * import { z } from 'zod';
12
12
  *
13
- * export default implement({
13
+ * export default tool({
14
14
  * description: 'Look up an anima by name',
15
15
  * params: {
16
16
  * name: z.string().describe('Anima name'),
@@ -25,31 +25,31 @@
25
25
  import { z } from 'zod';
26
26
  type ZodShape = Record<string, z.ZodType>;
27
27
  /**
28
- * Framework-provided context injected into every implement handler call.
29
- * The implement author doesn't construct this — the framework (MCP engine, CLI,
28
+ * Framework-provided context injected into every tool handler call.
29
+ * The tool author doesn't construct this — the framework (MCP engine, CLI,
30
30
  * or calling engine) provides it.
31
31
  */
32
- export interface ImplementContext {
32
+ export interface ToolContext {
33
33
  /** Absolute path to the guild root. */
34
34
  home: string;
35
35
  }
36
36
  /**
37
- * A fully-defined implement — the return type of `implement()`.
37
+ * A fully-defined tool — the return type of `tool()`.
38
38
  *
39
39
  * The MCP engine uses `.params.shape` to register the tool's input schema,
40
40
  * `.description` for the tool description, and `.handler` to execute calls.
41
41
  * The CLI uses `.params` to auto-generate Commander options.
42
42
  * Engines call `.handler` directly.
43
43
  */
44
- export interface ImplementDefinition<TShape extends ZodShape = ZodShape> {
44
+ export interface ToolDefinition<TShape extends ZodShape = ZodShape> {
45
45
  readonly description: string;
46
46
  readonly params: z.ZodObject<TShape>;
47
- readonly handler: (params: z.infer<z.ZodObject<TShape>>, context: ImplementContext) => unknown | Promise<unknown>;
47
+ readonly handler: (params: z.infer<z.ZodObject<TShape>>, context: ToolContext) => unknown | Promise<unknown>;
48
48
  }
49
49
  /**
50
- * Define a Nexus implement.
50
+ * Define a Nexus tool.
51
51
  *
52
- * This is the primary SDK entry point for module-based implements. Pass a
52
+ * This is the primary SDK entry point for module-based tools. Pass a
53
53
  * description, a params object of Zod schemas, and a handler function.
54
54
  * The framework handles the rest — MCP registration, CLI generation, validation.
55
55
  *
@@ -60,10 +60,10 @@ export interface ImplementDefinition<TShape extends ZodShape = ZodShape> {
60
60
  * Return any JSON-serializable value. The MCP engine wraps it as tool output;
61
61
  * the CLI prints it; engines use it directly.
62
62
  */
63
- export declare function implement<TShape extends ZodShape>(def: {
63
+ export declare function tool<TShape extends ZodShape>(def: {
64
64
  description: string;
65
65
  params: TShape;
66
- handler: (params: z.infer<z.ZodObject<TShape>>, context: ImplementContext) => unknown | Promise<unknown>;
67
- }): ImplementDefinition<TShape>;
66
+ handler: (params: z.infer<z.ZodObject<TShape>>, context: ToolContext) => unknown | Promise<unknown>;
67
+ }): ToolDefinition<TShape>;
68
68
  export {};
69
- //# sourceMappingURL=implement.d.ts.map
69
+ //# sourceMappingURL=tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;AAE1C;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc,CAAC,MAAM,SAAS,QAAQ,GAAG,QAAQ;IAChE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,CAChB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EACpC,OAAO,EAAE,WAAW,KACjB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,MAAM,SAAS,QAAQ,EAAE,GAAG,EAAE;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,CACP,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EACpC,OAAO,EAAE,WAAW,KACjB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC,GAAG,cAAc,CAAC,MAAM,CAAC,CAMzB"}
@@ -1,16 +1,16 @@
1
1
  /**
2
- * Implement SDK — the primary authoring interface for module-based implements.
2
+ * Tool SDK — the primary authoring interface for module-based tools.
3
3
  *
4
- * Use `implement()` to define a typed implement with Zod parameter schemas.
4
+ * Use `tool()` to define a typed tool with Zod parameter schemas.
5
5
  * The returned definition is what the MCP engine imports and registers as a tool,
6
6
  * what the CLI uses to auto-generate subcommands, and what engines import directly.
7
7
  *
8
8
  * @example
9
9
  * ```typescript
10
- * import { implement } from '@shardworks/nexus-core';
10
+ * import { tool } from '@shardworks/nexus-core';
11
11
  * import { z } from 'zod';
12
12
  *
13
- * export default implement({
13
+ * export default tool({
14
14
  * description: 'Look up an anima by name',
15
15
  * params: {
16
16
  * name: z.string().describe('Anima name'),
@@ -24,9 +24,9 @@
24
24
  */
25
25
  import { z } from 'zod';
26
26
  /**
27
- * Define a Nexus implement.
27
+ * Define a Nexus tool.
28
28
  *
29
- * This is the primary SDK entry point for module-based implements. Pass a
29
+ * This is the primary SDK entry point for module-based tools. Pass a
30
30
  * description, a params object of Zod schemas, and a handler function.
31
31
  * The framework handles the rest — MCP registration, CLI generation, validation.
32
32
  *
@@ -37,11 +37,11 @@ import { z } from 'zod';
37
37
  * Return any JSON-serializable value. The MCP engine wraps it as tool output;
38
38
  * the CLI prints it; engines use it directly.
39
39
  */
40
- export function implement(def) {
40
+ export function tool(def) {
41
41
  return {
42
42
  description: def.description,
43
43
  params: z.object(def.params),
44
44
  handler: def.handler,
45
45
  };
46
46
  }
47
- //# sourceMappingURL=implement.js.map
47
+ //# sourceMappingURL=tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool.js","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiCxB;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,IAAI,CAA0B,GAO7C;IACC,OAAO;QACL,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;QAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;KACrB,CAAC;AACJ,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@shardworks/nexus-core",
3
- "version": "0.1.12",
3
+ "version": "0.1.14",
4
4
  "license": "ISC",
5
5
  "repository": {
6
6
  "type": "git",
@@ -1 +0,0 @@
1
- {"version":3,"file":"implement.d.ts","sourceRoot":"","sources":["../src/implement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;AAE1C;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB,CAAC,MAAM,SAAS,QAAQ,GAAG,QAAQ;IACrE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,CAChB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EACpC,OAAO,EAAE,gBAAgB,KACtB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,MAAM,SAAS,QAAQ,EAAE,GAAG,EAAE;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,CACP,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EACpC,OAAO,EAAE,gBAAgB,KACtB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACjC,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAM9B"}
@@ -1 +0,0 @@
1
- {"version":3,"file":"implement.js","sourceRoot":"","sources":["../src/implement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiCxB;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,SAAS,CAA0B,GAOlD;IACC,OAAO;QACL,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC;QAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;KACrB,CAAC;AACJ,CAAC"}