@circuitwall/jarela 0.14.0 → 1.0.0

package/.next/standalone/.next/server/chunks/4631.js

@@ -134,29 +134,36 @@ function stripDeadline(args) {
 /** Exposed for the tests. */ const __DEFAULT_DEADLINE_MS = (/* unused pure expression or super */ null && (DEFAULT_DEADLINE_MS));
 
 ;// ./lib/tools/registry.ts
-// Tool registry.
-//
-// Each built-in tool module registers its own tools at module load with
-// two orthogonal axes:
-//
-//   * category   — topical group ("Memory", "Files", "Mail", …) used by
-//                  the Agent editor sidebar to organise tools for users.
-//   * capability — safety class ("read" | "write" | "execute") used by
-//                  the future per-capability approval gate, UI badges,
-//                  and the ADR-0037 output validator. See ADR-0038.
-//
-// lib/tools/index.ts only needs to side-effect-import the modules
-// (see ./builtins.ts) — there is no central map listing every tool by
-// name. Adding a new built-in tool now requires touching exactly two
-// files: the tool file itself, and an `import "./<name>";` line in
-// builtins.ts.
-//
-// External tools (loaded from JARELA_TOOLS_DIR at runtime) use the same
-// category vocabulary but are not stored in this registry — see
-// ./external.ts. MCP tools default to category "MCP". Both default to
-// capability "execute" until manifest-level overrides land (ADR-0038
-// follow-up).
-
+/**
+ * Tool registry.
+ *
+ * Each built-in tool module registers its own tools at module load with
+ * two orthogonal axes:
+ *
+ *   - category   — topical group ("Memory", "Files", "Mail", …) used by
+ *                  the Agent editor sidebar to organise tools for users.
+ *   - capability — safety class ("read" | "write" | "execute") used by
+ *                  the future per-capability approval gate, UI badges,
+ *                  and the ADR-0037 output validator. See ADR-0038.
+ *
+ * `lib/tools/index.ts` only needs to side-effect-import the modules
+ * (see ./builtins.ts) — there is no central map listing every tool by
+ * name. Adding a new built-in tool now requires touching exactly two
+ * files: the tool file itself, and an `import "./<name>";` line in
+ * builtins.ts.
+ *
+ * External tools (loaded from JARELA_TOOLS_DIR at runtime) use the same
+ * category vocabulary but are not stored in this registry — see
+ * ./external.ts. MCP tools default to category "MCP". Both default to
+ * capability "execute" until manifest-level overrides land (ADR-0038
+ * follow-up).
+ *
+ * Public surface (per `package.json#exports`): `ToolCategory`,
+ * `Capability`, `ToolGroup`, `BuiltinCategory`, `registerTools`.
+ * Everything else (`registeredTools` / `registeredNames` /
+ * `registeredCategory` / etc.) is `@internal` — used only by the in-tree
+ * runtime, not part of the plugin contract.
+ */ 
 // Category → group mapping. "Work" collapses corporate-auth tools under
 // one header in the Agent editor; everything else is a top-level category.
 const CATEGORY_GROUPS = {
@@ -203,22 +210,22 @@ const REGISTRY = new Map();
     }
     return wrapped;
 }
-/** All registered built-in tools, in registration order. */ function registeredTools() {
+/** @internal — all registered built-in tools, in registration order. */ function registeredTools() {
     return Array.from(REGISTRY.values(), (e)=>e.tool);
 }
-/** Names of all registered built-in tools — used for collision checks. */ function registeredNames() {
+/** @internal — names of all registered built-in tools, used for collision checks. */ function registeredNames() {
     return new Set(REGISTRY.keys());
 }
-function registeredCategory(name) {
+/** @internal */ function registeredCategory(name) {
     return REGISTRY.get(name)?.category;
 }
-function registeredCapability(name) {
+/** @internal */ function registeredCapability(name) {
     return REGISTRY.get(name)?.capability;
 }
-function registeredGroup(name) {
+/** @internal */ function registeredGroup(name) {
     return REGISTRY.get(name)?.group;
 }
-/** Test-only: clear the registry between cases. */ function _resetRegistry() {
+/** @internal — test-only: clear the registry between cases. */ function _resetRegistry() {
     REGISTRY.clear();
 }