@bendyline/gezel-mcp 1.1.1 → 1.2.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.
package/dist/index.d.ts CHANGED
@@ -20,7 +20,7 @@ export { BranchPrioritizedPulls, PullWithHeadRef, prioritizePullsForCurrentBranc
20
20
  * whose names come from the applied type's manifest, not from this frozen
21
21
  * contract. Registration guards them against colliding with these names.
22
22
  */
23
- declare const ALWAYS_REGISTERED_TOOLS: readonly ["search_memory", "save_memory", "list_memories", "list_dir", "read_file", "read_files", "stat", "write_file", "append_to_file", "replace_in_file", "replace_lines", "apply_patch", "insert_at_marker", "delete_path", "make_dir", "rename", "copy_artifact_to_workspace", "validate", "npm_install", "list_package_scripts", "run_package_script", "run_npx", "run_nodejs_script", "derive_file", "list_packages", "run_playwright_script", "list_artifacts", "read_artifact", "write_artifact", "grep_artifact", "browser_find_page_element", "list_documents", "read_document", "write_document", "delete_document", "search_documents", "list_gezels", "create_gezel", "list_gilde", "list_project_types", "apply_project_type", "start_project_from_type", "export_ai_app", "import_ai_app", "ensure_gezel", "update_gezel", "message_gezel", "ask_gezel", "ask_specialist", "delegate_developer", "consult_developer", "delegate_designer", "consult_designer", "delegate_reviewer", "consult_reviewer", "delegate_planner", "consult_planner", "delegate_researcher", "consult_researcher", "delegate_builder", "consult_builder", "delegate_writer", "consult_writer", "delegate_image_generator", "consult_image_generator", "delegate_voorman", "consult_voorman", "delegate_meester", "consult_meester", "ask_user_question", "list_projects", "start_project", "fetch_repo", "fetch_diff", "update_project", "list_project_gezels", "add_gezel_to_project", "remove_gezel_from_project", "list_suggested_work", "enable_suggested_work", "disable_suggested_work", "list_tasks", "get_task", "create_task", "start_plan", "update_task", "set_outcomes", "verify_outcome", "add_verification_step", "spawn_task_instances", "list_task_children", "set_task_status", "activate_task", "assign_task", "add_task_step", "advance_task_step", "read_task_notes", "write_task_note", "search_history", "search_sessions", "how_do_i", "render_image", "generate_image", "describe_image", "read_image_metadata", "generate_video", "transcribe_audio", "synthesize_speech", "fetch_url", "web_search", "wikipedia_search", "wikipedia_read", "search", "grep_files", "find_files", "diff_files", "read_image_as_base64", "outline_file", "find_symbol", "read_symbol", "find_references", "map_repo", "search_code", "file_review", "list_file_issues", "get_file_issue", "set_file_issue_status", "security_scan", "security_overview", "scan_findings", "map_attack_surface", "list_dependencies", "trace_taint", "search_docs", "read_doc_as_markdown", "search_images", "find_similar_images", "describe_folder", "find_entity", "list_entity_mentions", "list_archive", "extract_archive", "run_git", "list_scripts", "run_installed_script", "get_script_run", "list_craftbooks", "suggest_craftbook", "invoke_craftbook", "import_skill", "craftbook_read", "craftbook_write", "craftbook_add_step", "set_step_deliverable", "craftbook_remove_step", "craftbook_reorder_steps", "craftbook_set_entry", "craftbook_update", "export_task_craftbook", "github_pr_list", "github_pr_view", "github_pr_files", "github_pr_file", "github_pr_diff", "github_pr_comments", "github_pr_comment", "github_pr_create", "github_workflow_runs", "github_check_status"];
23
+ declare const ALWAYS_REGISTERED_TOOLS: readonly ["search_memory", "save_memory", "list_memories", "list_dir", "read_file", "read_files", "stat", "write_file", "append_to_file", "replace_in_file", "replace_lines", "apply_patch", "insert_at_marker", "delete_path", "make_dir", "rename", "copy_artifact_to_workspace", "validate", "npm_install", "list_package_scripts", "run_package_script", "run_npx", "run_nodejs_script", "derive_file", "list_packages", "run_playwright_script", "list_artifacts", "read_artifact", "read_artifacts", "write_artifact", "grep_artifact", "browser_find_page_element", "list_documents", "read_document", "write_document", "delete_document", "search_documents", "list_gezels", "create_gezel", "list_gilde", "list_project_types", "apply_project_type", "start_project_from_type", "export_ai_app", "import_ai_app", "ensure_gezel", "update_gezel", "message_gezel", "ask_gezel", "ask_specialist", "delegate_developer", "consult_developer", "delegate_designer", "consult_designer", "delegate_reviewer", "consult_reviewer", "delegate_planner", "consult_planner", "delegate_researcher", "consult_researcher", "delegate_builder", "consult_builder", "delegate_writer", "consult_writer", "delegate_image_generator", "consult_image_generator", "delegate_voorman", "consult_voorman", "delegate_meester", "consult_meester", "ask_user_question", "list_projects", "start_project", "fetch_repo", "fetch_diff", "update_project", "list_project_gezels", "add_gezel_to_project", "remove_gezel_from_project", "list_suggested_work", "enable_suggested_work", "disable_suggested_work", "list_tasks", "get_task", "create_task", "start_plan", "update_task", "set_outcomes", "verify_outcome", "add_verification_step", "spawn_task_instances", "list_task_children", "set_task_status", "manage_task", "activate_task", "assign_task", "add_task_step", "advance_task_step", "read_task_notes", "write_task_note", "search_history", "search_sessions", "how_do_i", "render_image", "generate_image", "describe_image", "read_image_metadata", "generate_video", "transcribe_audio", "synthesize_speech", "fetch_url", "web_search", "wikipedia_search", "wikimedia_image_search", "wikipedia_read", "search", "grep_files", "find_files", "diff_files", "read_image_as_base64", "outline_file", "find_symbol", "read_symbol", "find_references", "map_repo", "search_code", "file_review", "list_file_issues", "get_file_issue", "set_file_issue_status", "security_scan", "security_overview", "scan_findings", "map_attack_surface", "list_dependencies", "trace_taint", "search_docs", "read_doc_as_markdown", "search_images", "find_similar_images", "describe_folder", "find_entity", "list_entity_mentions", "list_archive", "extract_archive", "run_git", "list_scripts", "run_installed_script", "get_script_run", "list_craftbooks", "suggest_craftbook", "invoke_craftbook", "import_skill", "craftbook_read", "craftbook_write", "craftbook_add_step", "set_step_deliverable", "craftbook_remove_step", "craftbook_reorder_steps", "craftbook_set_entry", "craftbook_update", "export_task_craftbook", "github_pr_list", "github_pr_view", "github_pr_files", "github_pr_file", "github_pr_diff", "github_pr_comments", "github_pr_comment", "github_pr_create", "github_workflow_runs", "github_check_status"];
24
24
  /**
25
25
  * Tools registered only when their feature or session-context gate is set
26
26
  * in the env. Keep contextual/compatibility tools here so inventory users
@@ -369,14 +369,28 @@ declare function validateFile(path: string, content: FileContent): ValidateResul
369
369
  */
370
370
  declare function formatValidateResult(result: ValidateResult): string;
371
371
 
372
+ /**
373
+ * Set to `1` on the MCP child when the security policy's External services
374
+ * switch is on. See {@link unavailableToolsForPlatform}.
375
+ */
376
+ declare const SCRIPT_NETWORK_ALLOWED_ENV = "GEZEL_SCRIPT_NETWORK_ALLOWED";
372
377
  /**
373
378
  * Mirror the service's executable Linux probe at MCP registration time.
374
379
  * Finding systemd-run is not enough: this checks that the user manager really
375
380
  * applies RestrictAddressFamilies and rejects an AF_INET socket.
376
381
  */
377
382
  declare function canUseLinuxSystemdDenyNet(): boolean;
383
+ /**
384
+ * The deny-net tools this host cannot offer. Without an enforceable network
385
+ * boundary (Windows; Linux without the probed systemd manager) they are
386
+ * withheld — unless `networkAllowed`: when the policy already lets gezellen
387
+ * reach the network, the boundary has nothing left to protect, and the
388
+ * service runs these scripts without it. Where a boundary exists it is always
389
+ * applied, so script egress stays behind the mediated web tools there.
390
+ */
378
391
  declare function unavailableToolsForPlatform(platform: NodeJS.Platform, options?: {
379
392
  linuxSystemdAvailable?: boolean;
393
+ networkAllowed?: boolean;
380
394
  }): readonly string[];
381
395
 
382
- export { ALWAYS_REGISTERED_TOOLS, type AlwaysRegisteredToolName, BUILTIN_TOOL_NAMES, CANONICAL_TOOL_NAMES, CONDITIONALLY_REGISTERED_TOOLS, type CanonicalToolName, type CanonicalToolRegistryEntry, type ConditionallyRegisteredToolName, type FileContent, LEGACY_SPELLING_BY_CANONICAL, LEGACY_TOOL_NAMES, type LegacyToolName, RENAMED_TOOLS, RESERVED_TOOL_NAMES, TOOL_NAME_TOMBSTONES, TOOL_REGISTRY, type ToolNameTombstone, type ToolRegistrationGate, type ValidateCheck, type ValidateResult, canUseLinuxSystemdDenyNet, canonicalToolName, formatValidateResult, normalizeToolNameSpelling, resolveToolNameSpelling, unavailableToolsForPlatform, validateFile };
396
+ export { ALWAYS_REGISTERED_TOOLS, type AlwaysRegisteredToolName, BUILTIN_TOOL_NAMES, CANONICAL_TOOL_NAMES, CONDITIONALLY_REGISTERED_TOOLS, type CanonicalToolName, type CanonicalToolRegistryEntry, type ConditionallyRegisteredToolName, type FileContent, LEGACY_SPELLING_BY_CANONICAL, LEGACY_TOOL_NAMES, type LegacyToolName, RENAMED_TOOLS, RESERVED_TOOL_NAMES, SCRIPT_NETWORK_ALLOWED_ENV, TOOL_NAME_TOMBSTONES, TOOL_REGISTRY, type ToolNameTombstone, type ToolRegistrationGate, type ValidateCheck, type ValidateResult, canUseLinuxSystemdDenyNet, canonicalToolName, formatValidateResult, normalizeToolNameSpelling, resolveToolNameSpelling, unavailableToolsForPlatform, validateFile };
package/dist/index.js CHANGED
@@ -35,6 +35,7 @@ var ALWAYS_REGISTERED_TOOLS = [
35
35
  // Artifacts (project-scoped)
36
36
  "list_artifacts",
37
37
  "read_artifact",
38
+ "read_artifacts",
38
39
  "write_artifact",
39
40
  "grep_artifact",
40
41
  "browser_find_page_element",
@@ -107,6 +108,7 @@ var ALWAYS_REGISTERED_TOOLS = [
107
108
  "spawn_task_instances",
108
109
  "list_task_children",
109
110
  "set_task_status",
111
+ "manage_task",
110
112
  "activate_task",
111
113
  "assign_task",
112
114
  "add_task_step",
@@ -132,6 +134,7 @@ var ALWAYS_REGISTERED_TOOLS = [
132
134
  "fetch_url",
133
135
  "web_search",
134
136
  "wikipedia_search",
137
+ "wikimedia_image_search",
135
138
  "wikipedia_read",
136
139
  // Search / files
137
140
  "search",
@@ -993,6 +996,7 @@ function validateImage(path, content) {
993
996
  // src/platform-tool-availability.ts
994
997
  import { spawnSync } from "child_process";
995
998
  var DENY_NET_TOOLS = ["run_nodejs_script", "derive_file"];
999
+ var SCRIPT_NETWORK_ALLOWED_ENV = "GEZEL_SCRIPT_NETWORK_ALLOWED";
996
1000
  var linuxSystemdProbe;
997
1001
  function canUseLinuxSystemdDenyNet() {
998
1002
  if (process.platform !== "linux") return false;
@@ -1025,6 +1029,7 @@ function unavailableToolsForPlatform(platform, options = {}) {
1025
1029
  if (platform === "linux" && (options.linuxSystemdAvailable ?? canUseLinuxSystemdDenyNet())) {
1026
1030
  return [];
1027
1031
  }
1032
+ if (options.networkAllowed) return [];
1028
1033
  return DENY_NET_TOOLS;
1029
1034
  }
1030
1035
 
@@ -1041,6 +1046,7 @@ export {
1041
1046
  LEGACY_TOOL_NAMES,
1042
1047
  RENAMED_TOOLS,
1043
1048
  RESERVED_TOOL_NAMES,
1049
+ SCRIPT_NETWORK_ALLOWED_ENV,
1044
1050
  TOOL_NAME_TOMBSTONES,
1045
1051
  TOOL_REGISTRY,
1046
1052
  canUseLinuxSystemdDenyNet,
@@ -11,6 +11,7 @@ async function loadBuiltinToolContracts() {
11
11
  "GEZEL_MCP_NO_MAIN",
12
12
  "GEZEL_MCP_SCHEMA_LINT",
13
13
  "GEZEL_MCP_ALLOW",
14
+ "GEZEL_MCP_AUTHORIZED_TOOLS",
14
15
  "GEZEL_MCP_EXCLUDE",
15
16
  "GEZEL_MCP_LEGACY_TOOLS",
16
17
  "GEZEL_MCP_TOOL_NAMING",
@@ -26,6 +27,7 @@ async function loadBuiltinToolContracts() {
26
27
  process.env.GEZEL_MCP_NO_MAIN = "1";
27
28
  process.env.GEZEL_MCP_SCHEMA_LINT = "1";
28
29
  delete process.env.GEZEL_MCP_ALLOW;
30
+ delete process.env.GEZEL_MCP_AUTHORIZED_TOOLS;
29
31
  delete process.env.GEZEL_MCP_EXCLUDE;
30
32
  delete process.env.GEZEL_MCP_LEGACY_TOOLS;
31
33
  delete process.env.GEZEL_MCP_TOOL_NAMING;
package/dist/server.d.ts CHANGED
@@ -1,25 +1,5 @@
1
1
  import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
2
 
3
- /**
4
- * Gezel MCP Server
5
- *
6
- * A stdio-based MCP server that gives Copilot agents access to Gezel's
7
- * memory system, workspace files, artifacts, and project tools. Spawned by
8
- * the ChatManager as a local MCP server for each chat session.
9
- *
10
- * Configuration is passed via environment variables:
11
- * GEZEL_BASE_URL — daemon base URL (http(s)://127.0.0.1:<port>)
12
- * GEZEL_TOKEN — bearer token for the daemon API
13
- * GEZEL_CERT_PATH — path to the daemon's runtime/cert.pem (under its GEZEL_HOME; default ~/.gezel/runtime) when it serves HTTPS
14
- * GEZEL_AGENT_ID — the agent this session belongs to
15
- * GEZEL_PROJECT_ID — the project context
16
- * GEZEL_SESSION_ID — the chat session this subprocess serves
17
- * GEZEL_HOME — path to ~/.gezel (for direct memory access)
18
- * GEZEL_ROLE_BASED_NAME_ONLY_MODE — 1/0 naming presentation inherited by new tasks
19
- * GEZEL_CRAFTBOOK_ID — explicit craftbook-editor context (loads step surgery)
20
- * GEZEL_MCP_LEGACY_TOOLS=1 — expose compatibility aliases during migration
21
- */
22
-
23
3
  declare const server: McpServer;
24
4
 
25
5
  export { server };