@neurocode-ai/core 1.18.8
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/bin/neurocode +199 -0
- package/bunfig.toml +2 -0
- package/drizzle.config.ts +10 -0
- package/package.json +131 -0
- package/schema.json +2071 -0
- package/script/fix-node-pty.ts +28 -0
- package/script/migration.ts +196 -0
- package/src/account/sql.ts +39 -0
- package/src/account.ts +101 -0
- package/src/agent.ts +111 -0
- package/src/aisdk.ts +235 -0
- package/src/background-job.ts +365 -0
- package/src/catalog.ts +301 -0
- package/src/command.ts +64 -0
- package/src/config/agent.ts +25 -0
- package/src/config/attachments.ts +15 -0
- package/src/config/command.ts +12 -0
- package/src/config/compaction.ts +15 -0
- package/src/config/experimental.ts +18 -0
- package/src/config/formatter.ts +12 -0
- package/src/config/lsp.ts +18 -0
- package/src/config/markdown.ts +36 -0
- package/src/config/mcp.ts +48 -0
- package/src/config/plugin/agent.ts +179 -0
- package/src/config/plugin/command.ts +83 -0
- package/src/config/plugin/external.ts +91 -0
- package/src/config/plugin/provider.ts +113 -0
- package/src/config/plugin/reference.ts +70 -0
- package/src/config/plugin/skill.ts +50 -0
- package/src/config/plugin.ts +13 -0
- package/src/config/provider.ts +71 -0
- package/src/config/reference.ts +22 -0
- package/src/config/tool-output.ts +9 -0
- package/src/config/watcher.ts +7 -0
- package/src/config.ts +227 -0
- package/src/control-plane/move-session.ts +148 -0
- package/src/control-plane/workspace.sql.ts +20 -0
- package/src/credential/sql.ts +14 -0
- package/src/credential.ts +138 -0
- package/src/cross-spawn-spawner.ts +507 -0
- package/src/data-migration.sql.ts +6 -0
- package/src/database/database.ts +57 -0
- package/src/database/migration/20260127222353_familiar_lady_ursula.ts +107 -0
- package/src/database/migration/20260211171708_add_project_commands.ts +11 -0
- package/src/database/migration/20260213144116_wakeful_the_professor.ts +23 -0
- package/src/database/migration/20260225215848_workspace.ts +19 -0
- package/src/database/migration/20260227213759_add_session_workspace_id.ts +12 -0
- package/src/database/migration/20260228203230_blue_harpoon.ts +30 -0
- package/src/database/migration/20260303231226_add_workspace_fields.ts +15 -0
- package/src/database/migration/20260309230000_move_org_to_state.ts +15 -0
- package/src/database/migration/20260312043431_session_message_cursor.ts +16 -0
- package/src/database/migration/20260323234822_events.ts +26 -0
- package/src/database/migration/20260410174513_workspace-name.ts +29 -0
- package/src/database/migration/20260413175956_chief_energizer.ts +24 -0
- package/src/database/migration/20260423070820_add_icon_url_override.ts +14 -0
- package/src/database/migration/20260427172553_slow_nightmare.ts +30 -0
- package/src/database/migration/20260428004200_add_session_path.ts +11 -0
- package/src/database/migration/20260501142318_next_venus.ts +12 -0
- package/src/database/migration/20260504145000_add_sync_owner.ts +11 -0
- package/src/database/migration/20260507164347_add_workspace_time.ts +11 -0
- package/src/database/migration/20260510033149_session_usage.ts +56 -0
- package/src/database/migration/20260511000411_data_migration_state.ts +16 -0
- package/src/database/migration/20260511173437_session-metadata.ts +16 -0
- package/src/database/migration/20260601010001_normalize_storage_paths.ts +22 -0
- package/src/database/migration/20260601202201_amazing_prowler.ts +11 -0
- package/src/database/migration/20260602002951_lowly_union_jack.ts +24 -0
- package/src/database/migration/20260602182828_add_project_directories.ts +20 -0
- package/src/database/migration/20260603001617_session_message_projection_indexes.ts +19 -0
- package/src/database/migration/20260603040000_session_message_projection_order.ts +19 -0
- package/src/database/migration/20260603141458_session_input_inbox.ts +25 -0
- package/src/database/migration/20260603160727_jittery_ezekiel_stane.ts +20 -0
- package/src/database/migration/20260604172448_event_sourced_session_input.ts +47 -0
- package/src/database/migration/20260605003541_add_session_context_snapshot.ts +21 -0
- package/src/database/migration/20260605042240_add_context_epoch_agent.ts +11 -0
- package/src/database/migration/20260611035744_credential.ts +25 -0
- package/src/database/migration/20260611192811_lush_chimera.ts +25 -0
- package/src/database/migration/20260612174303_project_dir_strategy.ts +29 -0
- package/src/database/migration/20260622142730_simplify_session_context_epoch.ts +13 -0
- package/src/database/migration/20260622170816_reset_v2_session_state.ts +17 -0
- package/src/database/migration/20260622202450_simplify_session_input.ts +17 -0
- package/src/database/migration.gen.ts +44 -0
- package/src/database/migration.ts +81 -0
- package/src/database/path.ts +91 -0
- package/src/database/schema.gen.ts +274 -0
- package/src/database/schema.sql.ts +10 -0
- package/src/database/sqlite.bun.ts +183 -0
- package/src/database/sqlite.node.ts +178 -0
- package/src/database/sqlite.ts +8 -0
- package/src/effect/app-node-builder.ts +23 -0
- package/src/effect/app-node-platform.ts +18 -0
- package/src/effect/app-node.ts +14 -0
- package/src/effect/dfdf +1 -0
- package/src/effect/keyed-mutex.ts +45 -0
- package/src/effect/layer-node.ts +333 -0
- package/src/effect/memo-map.ts +3 -0
- package/src/effect/runtime.ts +21 -0
- package/src/effect/service-use.ts +43 -0
- package/src/event/sql.ts +25 -0
- package/src/event.ts +638 -0
- package/src/file-mutation.ts +207 -0
- package/src/file.ts +6 -0
- package/src/filesystem/fff.bun.ts +140 -0
- package/src/filesystem/fff.node.ts +138 -0
- package/src/filesystem/ignore.ts +67 -0
- package/src/filesystem/protected.ts +53 -0
- package/src/filesystem/search.ts +239 -0
- package/src/filesystem/watcher.ts +140 -0
- package/src/filesystem.ts +118 -0
- package/src/flag/flag.ts +78 -0
- package/src/fs-util.ts +274 -0
- package/src/git.ts +987 -0
- package/src/github-copilot/README.md +5 -0
- package/src/github-copilot/chat/convert-to-openai-compatible-chat-messages.ts +170 -0
- package/src/github-copilot/chat/get-response-metadata.ts +15 -0
- package/src/github-copilot/chat/map-openai-compatible-finish-reason.ts +19 -0
- package/src/github-copilot/chat/openai-compatible-api-types.ts +64 -0
- package/src/github-copilot/chat/openai-compatible-chat-language-model.ts +815 -0
- package/src/github-copilot/chat/openai-compatible-chat-options.ts +28 -0
- package/src/github-copilot/chat/openai-compatible-metadata-extractor.ts +44 -0
- package/src/github-copilot/chat/openai-compatible-prepare-tools.ts +83 -0
- package/src/github-copilot/copilot-provider.ts +100 -0
- package/src/github-copilot/openai-compatible-error.ts +27 -0
- package/src/github-copilot/responses/convert-to-openai-responses-input.ts +335 -0
- package/src/github-copilot/responses/map-openai-responses-finish-reason.ts +22 -0
- package/src/github-copilot/responses/openai-config.ts +18 -0
- package/src/github-copilot/responses/openai-error.ts +22 -0
- package/src/github-copilot/responses/openai-responses-api-types.ts +214 -0
- package/src/github-copilot/responses/openai-responses-language-model.ts +1770 -0
- package/src/github-copilot/responses/openai-responses-prepare-tools.ts +173 -0
- package/src/github-copilot/responses/openai-responses-settings.ts +1 -0
- package/src/github-copilot/responses/tool/code-interpreter.ts +87 -0
- package/src/github-copilot/responses/tool/file-search.ts +127 -0
- package/src/github-copilot/responses/tool/image-generation.ts +114 -0
- package/src/github-copilot/responses/tool/local-shell.ts +64 -0
- package/src/github-copilot/responses/tool/web-search-preview.ts +103 -0
- package/src/github-copilot/responses/tool/web-search.ts +102 -0
- package/src/global.ts +87 -0
- package/src/id/id.ts +47 -0
- package/src/image/photon.ts +94 -0
- package/src/image.ts +81 -0
- package/src/installation/version.ts +8 -0
- package/src/instruction-context.ts +101 -0
- package/src/integration/connection.ts +12 -0
- package/src/integration.ts +520 -0
- package/src/location-mutation.ts +162 -0
- package/src/location-service-map.ts +18 -0
- package/src/location-services.ts +115 -0
- package/src/location.ts +39 -0
- package/src/markdown.d.ts +4 -0
- package/src/model.ts +41 -0
- package/src/models-dev.ts +260 -0
- package/src/npm-config.ts +40 -0
- package/src/npm.ts +269 -0
- package/src/oauth/page.ts +276 -0
- package/src/observability/logging.ts +71 -0
- package/src/observability/otlp.ts +79 -0
- package/src/observability/shared.ts +1 -0
- package/src/observability.ts +24 -0
- package/src/patch.ts +197 -0
- package/src/permission/saved.ts +79 -0
- package/src/permission/sql.ts +20 -0
- package/src/permission.ts +310 -0
- package/src/plugin/agent.ts +206 -0
- package/src/plugin/command/initialize.txt +65 -0
- package/src/plugin/command/review.txt +100 -0
- package/src/plugin/command.ts +25 -0
- package/src/plugin/host.ts +219 -0
- package/src/plugin/internal.ts +153 -0
- package/src/plugin/layer-map.example.ts +94 -0
- package/src/plugin/models-dev.ts +183 -0
- package/src/plugin/promise.ts +93 -0
- package/src/plugin/provider/alibaba.ts +15 -0
- package/src/plugin/provider/amazon-bedrock.ts +126 -0
- package/src/plugin/provider/anthropic.ts +27 -0
- package/src/plugin/provider/azure.ts +82 -0
- package/src/plugin/provider/cerebras.ts +26 -0
- package/src/plugin/provider/cloudflare-ai-gateway.ts +81 -0
- package/src/plugin/provider/cloudflare-workers-ai.ts +81 -0
- package/src/plugin/provider/cohere.ts +15 -0
- package/src/plugin/provider/deepinfra.ts +15 -0
- package/src/plugin/provider/dynamic.ts +31 -0
- package/src/plugin/provider/gateway.ts +15 -0
- package/src/plugin/provider/github-copilot.ts +52 -0
- package/src/plugin/provider/gitlab.ts +65 -0
- package/src/plugin/provider/google-vertex.ts +173 -0
- package/src/plugin/provider/google.ts +15 -0
- package/src/plugin/provider/groq.ts +15 -0
- package/src/plugin/provider/kilo.ts +21 -0
- package/src/plugin/provider/llmgateway.ts +26 -0
- package/src/plugin/provider/mistral.ts +15 -0
- package/src/plugin/provider/nvidia.ts +22 -0
- package/src/plugin/provider/openai-compatible.ts +17 -0
- package/src/plugin/provider/openai.ts +292 -0
- package/src/plugin/provider/opencode.ts +311 -0
- package/src/plugin/provider/openrouter.ts +36 -0
- package/src/plugin/provider/perplexity.ts +15 -0
- package/src/plugin/provider/sap-ai-core.ts +46 -0
- package/src/plugin/provider/snowflake-cortex.ts +89 -0
- package/src/plugin/provider/togetherai.ts +15 -0
- package/src/plugin/provider/venice.ts +15 -0
- package/src/plugin/provider/vercel.ts +27 -0
- package/src/plugin/provider/xai.ts +22 -0
- package/src/plugin/provider/zenmux.ts +21 -0
- package/src/plugin/provider.ts +71 -0
- package/src/plugin/skill/customize-neurocode.md +452 -0
- package/src/plugin/skill.ts +31 -0
- package/src/plugin/variant.ts +39 -0
- package/src/plugin.ts +167 -0
- package/src/policy.ts +49 -0
- package/src/process.ts +261 -0
- package/src/project/copy-strategies.ts +35 -0
- package/src/project/copy.ts +292 -0
- package/src/project/directories.ts +158 -0
- package/src/project/schema.ts +16 -0
- package/src/project/sql.ts +35 -0
- package/src/project.ts +136 -0
- package/src/provider.ts +25 -0
- package/src/pty/protocol.ts +37 -0
- package/src/pty/pty.bun.ts +26 -0
- package/src/pty/pty.node.ts +29 -0
- package/src/pty/pty.ts +25 -0
- package/src/pty/schema.ts +1 -0
- package/src/pty/ticket.ts +56 -0
- package/src/pty.ts +318 -0
- package/src/public-event-manifest.ts +7 -0
- package/src/question.ts +153 -0
- package/src/reference/guidance.ts +69 -0
- package/src/reference.ts +125 -0
- package/src/repository-cache.ts +259 -0
- package/src/repository.ts +214 -0
- package/src/ripgrep/binary.ts +132 -0
- package/src/ripgrep.ts +281 -0
- package/src/schema.ts +79 -0
- package/src/session/compaction.ts +241 -0
- package/src/session/context-epoch.ts +174 -0
- package/src/session/error.ts +24 -0
- package/src/session/event.ts +2 -0
- package/src/session/execution/local.ts +46 -0
- package/src/session/execution.ts +34 -0
- package/src/session/history.ts +101 -0
- package/src/session/info.ts +50 -0
- package/src/session/input.ts +288 -0
- package/src/session/message-updater.ts +397 -0
- package/src/session/message.ts +2 -0
- package/src/session/projector.ts +458 -0
- package/src/session/prompt.ts +1 -0
- package/src/session/revert.ts +121 -0
- package/src/session/run-coordinator.ts +104 -0
- package/src/session/runner/index.ts +28 -0
- package/src/session/runner/llm.ts +432 -0
- package/src/session/runner/max-steps.ts +16 -0
- package/src/session/runner/model.ts +218 -0
- package/src/session/runner/publish-llm-event.ts +423 -0
- package/src/session/runner/to-llm-message.ts +171 -0
- package/src/session/schema.ts +9 -0
- package/src/session/sql.ts +176 -0
- package/src/session/store.ts +63 -0
- package/src/session/todo.ts +78 -0
- package/src/session.ts +486 -0
- package/src/share/sql.ts +13 -0
- package/src/shell.ts +226 -0
- package/src/skill/discovery.ts +213 -0
- package/src/skill/guidance.ts +76 -0
- package/src/skill.ts +132 -0
- package/src/snapshot.ts +266 -0
- package/src/state.ts +128 -0
- package/src/system-context/builtins.ts +50 -0
- package/src/system-context/index.ts +320 -0
- package/src/system-context/registry.ts +49 -0
- package/src/tool/AGENTS.md +59 -0
- package/src/tool/application-tools.ts +57 -0
- package/src/tool/apply-patch.ts +219 -0
- package/src/tool/bash.ts +207 -0
- package/src/tool/builtins.ts +48 -0
- package/src/tool/edit.ts +223 -0
- package/src/tool/glob.ts +105 -0
- package/src/tool/grep.ts +137 -0
- package/src/tool/http-body.ts +30 -0
- package/src/tool/question.ts +94 -0
- package/src/tool/read-filesystem.ts +366 -0
- package/src/tool/read.ts +117 -0
- package/src/tool/registry.ts +147 -0
- package/src/tool/skill.ts +109 -0
- package/src/tool/todowrite.ts +62 -0
- package/src/tool/tool.ts +162 -0
- package/src/tool/tools.ts +13 -0
- package/src/tool/webfetch.ts +218 -0
- package/src/tool/websearch.ts +260 -0
- package/src/tool/write.ts +101 -0
- package/src/tool-output-store.ts +211 -0
- package/src/util/array.ts +10 -0
- package/src/util/binary.ts +41 -0
- package/src/util/effect-flock.ts +284 -0
- package/src/util/encode.ts +51 -0
- package/src/util/error.ts +70 -0
- package/src/util/flock.ts +358 -0
- package/src/util/glob.ts +34 -0
- package/src/util/hash.ts +11 -0
- package/src/util/identifier.ts +1 -0
- package/src/util/iife.ts +3 -0
- package/src/util/lazy.ts +11 -0
- package/src/util/module.ts +10 -0
- package/src/util/path.ts +37 -0
- package/src/util/retry.ts +42 -0
- package/src/util/slug.ts +74 -0
- package/src/util/token.ts +5 -0
- package/src/util/which.ts +14 -0
- package/src/util/wildcard.ts +14 -0
- package/src/v1/config/agent.ts +89 -0
- package/src/v1/config/attachment.ts +25 -0
- package/src/v1/config/command.ts +13 -0
- package/src/v1/config/config.ts +192 -0
- package/src/v1/config/console-state.ts +16 -0
- package/src/v1/config/error.ts +39 -0
- package/src/v1/config/formatter.ts +13 -0
- package/src/v1/config/layout.ts +6 -0
- package/src/v1/config/lsp.ts +80 -0
- package/src/v1/config/mcp.ts +63 -0
- package/src/v1/config/migrate.ts +254 -0
- package/src/v1/config/permission.ts +50 -0
- package/src/v1/config/plugin.ts +9 -0
- package/src/v1/config/provider-options.ts +227 -0
- package/src/v1/config/provider.ts +121 -0
- package/src/v1/config/server.ts +19 -0
- package/src/v1/config/skills.ts +13 -0
- package/src/v1/permission.ts +33 -0
- package/src/v1/session.ts +68 -0
- package/src/v2-schema.ts +3 -0
- package/src/workspace.ts +6 -0
- package/sst-env.d.ts +10 -0
- package/test/agent.test.ts +131 -0
- package/test/application-tools.test.ts +287 -0
- package/test/background-job.test.ts +106 -0
- package/test/catalog.test.ts +353 -0
- package/test/command.test.ts +56 -0
- package/test/config/agent.test.ts +349 -0
- package/test/config/command.test.ts +83 -0
- package/test/config/config.test.ts +798 -0
- package/test/config/fixtures/plugin/directory-plugin.ts +13 -0
- package/test/config/plugin.test.ts +248 -0
- package/test/config/provider-options.test.ts +224 -0
- package/test/config/provider.test.ts +269 -0
- package/test/config/skill.test.ts +80 -0
- package/test/credential.test.ts +36 -0
- package/test/database-migration.test.ts +644 -0
- package/test/effect/cross-spawn-spawner.test.ts +426 -0
- package/test/effect/keyed-mutex.test.ts +73 -0
- package/test/effect/layer-node/layer-node-types.test.ts +143 -0
- package/test/effect/layer-node/layer-node.test.ts +261 -0
- package/test/effect/layer-node/node-build.test.ts +125 -0
- package/test/effect/observability.test.ts +109 -0
- package/test/event.test.ts +1124 -0
- package/test/file-mutation.test.ts +368 -0
- package/test/filesystem/filesystem.test.ts +387 -0
- package/test/filesystem/ignore.test.ts +10 -0
- package/test/filesystem/search.test.ts +44 -0
- package/test/filesystem/watcher.test.ts +266 -0
- package/test/fixture/effect-flock-worker.ts +60 -0
- package/test/fixture/flock-worker.ts +72 -0
- package/test/fixture/git.ts +49 -0
- package/test/fixture/location.ts +26 -0
- package/test/fixture/tmpdir.ts +25 -0
- package/test/fixtures/recordings/session-runner/openai-chat-streams-text.json +27 -0
- package/test/git.test.ts +164 -0
- package/test/github-copilot/convert-to-copilot-messages.test.ts +523 -0
- package/test/github-copilot/copilot-chat-model.test.ts +592 -0
- package/test/github-copilot/openai-responses-language-model.test.ts +206 -0
- package/test/global.test.ts +16 -0
- package/test/instruction-context.test.ts +323 -0
- package/test/integration.test.ts +349 -0
- package/test/legacy-event-schema.test.ts +16 -0
- package/test/lib/effect.ts +53 -0
- package/test/lib/tool.ts +20 -0
- package/test/location-filesystem.test.ts +69 -0
- package/test/location-layer.test.ts +226 -0
- package/test/location-mutation.test.ts +178 -0
- package/test/location.test.ts +42 -0
- package/test/model.test.ts +23 -0
- package/test/models.test.ts +290 -0
- package/test/move-session.test.ts +235 -0
- package/test/npm-config.test.ts +51 -0
- package/test/npm.test.ts +84 -0
- package/test/oauth-page.test.ts +15 -0
- package/test/patch.test.ts +68 -0
- package/test/permission.test.ts +315 -0
- package/test/plugin/command.test.ts +47 -0
- package/test/plugin/fixture.ts +52 -0
- package/test/plugin/fixtures/config-effect-plugin.ts +15 -0
- package/test/plugin/fixtures/config-promise-plugin.ts +13 -0
- package/test/plugin/fixtures/invalid-plugin.ts +1 -0
- package/test/plugin/fixtures/models-dev.json +14 -0
- package/test/plugin/fixtures/provider-factory.ts +9 -0
- package/test/plugin/host.ts +303 -0
- package/test/plugin/models-dev.test.ts +170 -0
- package/test/plugin/promise.test.ts +67 -0
- package/test/plugin/provider-alibaba.test.ts +92 -0
- package/test/plugin/provider-amazon-bedrock.test.ts +622 -0
- package/test/plugin/provider-anthropic.test.ts +94 -0
- package/test/plugin/provider-azure-cognitive-services.test.ts +199 -0
- package/test/plugin/provider-azure.test.ts +293 -0
- package/test/plugin/provider-cerebras.test.ts +136 -0
- package/test/plugin/provider-cloudflare-ai-gateway.test.ts +426 -0
- package/test/plugin/provider-cloudflare-workers-ai.test.ts +279 -0
- package/test/plugin/provider-cohere.test.ts +123 -0
- package/test/plugin/provider-deepinfra.test.ts +159 -0
- package/test/plugin/provider-dynamic.test.ts +184 -0
- package/test/plugin/provider-gateway.test.ts +115 -0
- package/test/plugin/provider-github-copilot.test.ts +278 -0
- package/test/plugin/provider-gitlab.test.ts +308 -0
- package/test/plugin/provider-google-vertex-anthropic.test.ts +264 -0
- package/test/plugin/provider-google-vertex.test.ts +387 -0
- package/test/plugin/provider-google.test.ts +80 -0
- package/test/plugin/provider-groq.test.ts +121 -0
- package/test/plugin/provider-kilo.test.ts +99 -0
- package/test/plugin/provider-llmgateway.test.ts +80 -0
- package/test/plugin/provider-mistral.test.ts +129 -0
- package/test/plugin/provider-nvidia.test.ts +97 -0
- package/test/plugin/provider-openai-compatible.test.ts +107 -0
- package/test/plugin/provider-openai.test.ts +176 -0
- package/test/plugin/provider-opencode.test.ts +423 -0
- package/test/plugin/provider-openrouter.test.ts +113 -0
- package/test/plugin/provider-perplexity.test.ts +122 -0
- package/test/plugin/provider-sap-ai-core.test.ts +159 -0
- package/test/plugin/provider-snowflake-cortex.test.ts +261 -0
- package/test/plugin/provider-togetherai.test.ts +129 -0
- package/test/plugin/provider-venice.test.ts +115 -0
- package/test/plugin/provider-vercel.test.ts +83 -0
- package/test/plugin/provider-xai.test.ts +125 -0
- package/test/plugin/provider-zenmux.test.ts +110 -0
- package/test/plugin/skill.test.ts +25 -0
- package/test/plugin/variant.test.ts +67 -0
- package/test/plugin.test.ts +71 -0
- package/test/policy.test.ts +85 -0
- package/test/preload.ts +5 -0
- package/test/process/process.test.ts +368 -0
- package/test/project-copy.test.ts +400 -0
- package/test/project-directories.test.ts +61 -0
- package/test/project.test.ts +221 -0
- package/test/provider-mistral.test.ts +282 -0
- package/test/provider-xai-responses.test.ts +32 -0
- package/test/pty/info-schema.test.ts +32 -0
- package/test/pty/protocol.test.ts +27 -0
- package/test/pty/pty-session.test.ts +240 -0
- package/test/pty/ticket.test.ts +62 -0
- package/test/question.test.ts +114 -0
- package/test/reference-guidance.test.ts +76 -0
- package/test/reference.test.ts +78 -0
- package/test/repository-cache.test.ts +153 -0
- package/test/repository.test.ts +71 -0
- package/test/ripgrep.test.ts +65 -0
- package/test/session-compaction.test.ts +27 -0
- package/test/session-create.test.ts +425 -0
- package/test/session-history.test.ts +165 -0
- package/test/session-projector.test.ts +533 -0
- package/test/session-prompt.test.ts +584 -0
- package/test/session-run-coordinator.test.ts +418 -0
- package/test/session-runner-message.test.ts +501 -0
- package/test/session-runner-model.test.ts +347 -0
- package/test/session-runner-recorded.test.ts +193 -0
- package/test/session-runner-tool-events.test.ts +136 -0
- package/test/session-runner-tool-registry.test.ts +452 -0
- package/test/session-runner.test.ts +3365 -0
- package/test/session-todo.test.ts +94 -0
- package/test/session-tool-progress.test.ts +158 -0
- package/test/shared-schema.test.ts +206 -0
- package/test/shell.test.ts +108 -0
- package/test/skill/guidance.test.ts +144 -0
- package/test/skill-discovery.test.ts +165 -0
- package/test/skill.test.ts +125 -0
- package/test/snapshot.test.ts +178 -0
- package/test/state.test.ts +115 -0
- package/test/system-context/builtins.test.ts +129 -0
- package/test/system-context/index.test.ts +307 -0
- package/test/system-context/registry.test.ts +114 -0
- package/test/tool-apply-patch.test.ts +436 -0
- package/test/tool-bash.test.ts +437 -0
- package/test/tool-edit.test.ts +434 -0
- package/test/tool-output-store.test.ts +247 -0
- package/test/tool-question.test.ts +162 -0
- package/test/tool-read-filesystem.test.ts +118 -0
- package/test/tool-read.test.ts +674 -0
- package/test/tool-skill.test.ts +149 -0
- package/test/tool-todowrite.test.ts +125 -0
- package/test/tool-webfetch.test.ts +281 -0
- package/test/tool-websearch.test.ts +316 -0
- package/test/tool-write.test.ts +305 -0
- package/test/util/effect-flock.test.ts +392 -0
- package/test/util/flock.test.ts +428 -0
- package/test/util/which.test.ts +100 -0
- package/tsconfig.json +7 -0
|
@@ -0,0 +1,452 @@
|
|
|
1
|
+
<!--
|
|
2
|
+
Built-in skill. Name and description are registered in code at
|
|
3
|
+
packages/core/src/plugin/skill.ts
|
|
4
|
+
and CUSTOMIZE_NEUROCODE_SKILL_DESCRIPTION). The body below becomes the
|
|
5
|
+
skill's content.
|
|
6
|
+
-->
|
|
7
|
+
|
|
8
|
+
# Customizing neurocode
|
|
9
|
+
|
|
10
|
+
neurocode validates its own config strictly and refuses to start when a field
|
|
11
|
+
is wrong. The shapes below cover the common surface area, but they are a
|
|
12
|
+
**summary, not the source of truth**.
|
|
13
|
+
|
|
14
|
+
## Full schema reference
|
|
15
|
+
|
|
16
|
+
The authoritative list of every config option — with field types, enums,
|
|
17
|
+
defaults, and descriptions — lives in the published JSON Schema:
|
|
18
|
+
|
|
19
|
+
**<https://neurocode.ai/config.json>**
|
|
20
|
+
|
|
21
|
+
If a field is not documented in this skill, or you need to confirm an exact
|
|
22
|
+
shape before writing config, **fetch that URL and read the schema directly**
|
|
23
|
+
rather than guessing. neurocode hard-fails on invalid config, so the cost of a
|
|
24
|
+
wrong shape is a broken startup.
|
|
25
|
+
|
|
26
|
+
Independently, every `neurocode.json` should declare
|
|
27
|
+
`"$schema": "https://neurocode.ai/config.json"` so the user's editor catches
|
|
28
|
+
mistakes as they type.
|
|
29
|
+
|
|
30
|
+
## Applying changes
|
|
31
|
+
|
|
32
|
+
Config is loaded once when neurocode starts and is not hot-reloaded. After
|
|
33
|
+
saving changes to `neurocode.json`, an agent file, a skill, a plugin, or any
|
|
34
|
+
other config-time file, **tell the user to quit and restart neurocode** for
|
|
35
|
+
the changes to take effect. The running session will keep using the
|
|
36
|
+
already-loaded config until then.
|
|
37
|
+
|
|
38
|
+
## Where files live
|
|
39
|
+
|
|
40
|
+
| Scope | Path |
|
|
41
|
+
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
|
|
42
|
+
| Project config | `./neurocode.json`, `./neurocode.jsonc`, or `.neurocode/neurocode.json` (neurocode walks up from the cwd to the worktree root) |
|
|
43
|
+
| Global config | `~/.config/neurocode/neurocode.json` (NOT `~/.neurocode/`) |
|
|
44
|
+
| Project agents | `.neurocode/agent/<name>.md` or `.neurocode/agents/<name>.md` |
|
|
45
|
+
| Global agents | `~/.config/neurocode/agent(s)/<name>.md` |
|
|
46
|
+
| Project commands | `.neurocode/command/<name>.md` or `.neurocode/commands/<name>.md` |
|
|
47
|
+
| Global commands | `~/.config/neurocode/command(s)/<name>.md` |
|
|
48
|
+
| Project skills | `.neurocode/skill(s)/<name>/SKILL.md` |
|
|
49
|
+
| Global skills | `~/.config/neurocode/skill(s)/<name>/SKILL.md` |
|
|
50
|
+
| External skills (auto-loaded) | `~/.claude/skills/<name>/SKILL.md`, `~/.agents/skills/<name>/SKILL.md` |
|
|
51
|
+
|
|
52
|
+
Configs from each scope are deep-merged. Project overrides global. Unknown
|
|
53
|
+
top-level keys in `neurocode.json` are rejected with `ConfigInvalidError`.
|
|
54
|
+
|
|
55
|
+
## neurocode.json
|
|
56
|
+
|
|
57
|
+
Every field is optional.
|
|
58
|
+
|
|
59
|
+
```json
|
|
60
|
+
{
|
|
61
|
+
"$schema": "https://neurocode.ai/config.json",
|
|
62
|
+
"username": "string",
|
|
63
|
+
"model": "provider/model-id",
|
|
64
|
+
"small_model": "provider/model-id",
|
|
65
|
+
"default_agent": "agent-name",
|
|
66
|
+
"shell": "/bin/zsh",
|
|
67
|
+
"logLevel": "DEBUG" | "INFO" | "WARN" | "ERROR",
|
|
68
|
+
"share": "manual" | "auto" | "disabled",
|
|
69
|
+
"autoupdate": true | false | "notify",
|
|
70
|
+
"snapshot": true,
|
|
71
|
+
"instructions": ["AGENTS.md", "docs/style.md"],
|
|
72
|
+
|
|
73
|
+
"skills": {
|
|
74
|
+
"paths": [".neurocode/skills", "/abs/path/to/skills"],
|
|
75
|
+
"urls": ["https://example.com/.well-known/skills/"]
|
|
76
|
+
},
|
|
77
|
+
|
|
78
|
+
"references": {
|
|
79
|
+
"docs": {
|
|
80
|
+
"path": "../docs",
|
|
81
|
+
"description": "Use for product behavior and documentation conventions"
|
|
82
|
+
},
|
|
83
|
+
"sdk": {
|
|
84
|
+
"repository": "owner/sdk",
|
|
85
|
+
"branch": "main",
|
|
86
|
+
"description": "Use for SDK implementation details",
|
|
87
|
+
"hidden": true
|
|
88
|
+
}
|
|
89
|
+
},
|
|
90
|
+
|
|
91
|
+
"agent": {
|
|
92
|
+
"my-agent": {
|
|
93
|
+
"model": "anthropic/claude-sonnet-4-6",
|
|
94
|
+
"mode": "subagent",
|
|
95
|
+
"description": "...",
|
|
96
|
+
"permission": { "edit": "deny" }
|
|
97
|
+
}
|
|
98
|
+
},
|
|
99
|
+
|
|
100
|
+
"command": {
|
|
101
|
+
"deploy": { "description": "...", "template": "..." }
|
|
102
|
+
},
|
|
103
|
+
|
|
104
|
+
"provider": {
|
|
105
|
+
"anthropic": { "options": { "apiKey": "..." } }
|
|
106
|
+
},
|
|
107
|
+
"disabled_providers": ["openai"],
|
|
108
|
+
"enabled_providers": ["anthropic"],
|
|
109
|
+
|
|
110
|
+
"mcp": {
|
|
111
|
+
"playwright": {
|
|
112
|
+
"type": "local",
|
|
113
|
+
"command": ["npx", "-y", "@playwright/mcp"],
|
|
114
|
+
"enabled": true,
|
|
115
|
+
"env": {}
|
|
116
|
+
},
|
|
117
|
+
"remote-thing": {
|
|
118
|
+
"type": "remote",
|
|
119
|
+
"url": "https://...",
|
|
120
|
+
"headers": { "Authorization": "Bearer ..." }
|
|
121
|
+
}
|
|
122
|
+
},
|
|
123
|
+
|
|
124
|
+
"plugin": [
|
|
125
|
+
"neurocode-gemini-auth",
|
|
126
|
+
"neurocode-foo@1.2.3",
|
|
127
|
+
"./local-plugin.ts",
|
|
128
|
+
["neurocode-bar", { "option": "value" }]
|
|
129
|
+
],
|
|
130
|
+
|
|
131
|
+
"permission": {
|
|
132
|
+
"edit": "deny",
|
|
133
|
+
"bash": { "git *": "allow", "*": "ask" }
|
|
134
|
+
},
|
|
135
|
+
|
|
136
|
+
"formatter": false,
|
|
137
|
+
"lsp": false,
|
|
138
|
+
|
|
139
|
+
"experimental": {
|
|
140
|
+
"primary_tools": ["edit"],
|
|
141
|
+
"mcp_timeout": 30000
|
|
142
|
+
},
|
|
143
|
+
|
|
144
|
+
"tool_output": { "max_lines": 200, "max_bytes": 8192 },
|
|
145
|
+
|
|
146
|
+
"compaction": { "auto": true, "tail_turns": 15 }
|
|
147
|
+
}
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
Shape notes worth being explicit about:
|
|
151
|
+
|
|
152
|
+
- `model` always carries a provider prefix: `"anthropic/claude-sonnet-4-6"`.
|
|
153
|
+
- `skills` is an object with `paths` and/or `urls`, not an array.
|
|
154
|
+
- `references` is an object keyed by alias. Each value is a local path, Git repository, or string shorthand.
|
|
155
|
+
- `agent` is an object keyed by agent name, not an array.
|
|
156
|
+
- `command` is an object keyed by command name, not an array.
|
|
157
|
+
- `plugin` is an array of strings or `[name, options]` tuples, not an object.
|
|
158
|
+
- `mcp[name].command` is an array of strings, never a single string. `type` is required.
|
|
159
|
+
- `permission` is either a string action or an object keyed by tool name.
|
|
160
|
+
|
|
161
|
+
## Skills
|
|
162
|
+
|
|
163
|
+
neurocode's skill loader scans for `**/SKILL.md` inside skill directories. The
|
|
164
|
+
file is named `SKILL.md` exactly, and lives in its own folder named after the
|
|
165
|
+
skill:
|
|
166
|
+
|
|
167
|
+
```
|
|
168
|
+
.neurocode/skills/my-skill/SKILL.md
|
|
169
|
+
```
|
|
170
|
+
|
|
171
|
+
Frontmatter:
|
|
172
|
+
|
|
173
|
+
```markdown
|
|
174
|
+
---
|
|
175
|
+
name: my-skill
|
|
176
|
+
description: One sentence covering what this skill does AND when to trigger it. Front-load the literal keywords or filenames the user is likely to say.
|
|
177
|
+
---
|
|
178
|
+
|
|
179
|
+
# My Skill
|
|
180
|
+
|
|
181
|
+
(skill body in markdown: instructions, examples, references)
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
- `name` is required, lowercase hyphen-separated, up to 64 chars, and matches the folder name.
|
|
185
|
+
- `description` is effectively required: skills without one are filtered out and never surfaced to the model. Cover both _what_ the skill does and _when_ to use it. Write in third person ("Use when...", not "I help with..."). Front-load concrete trigger keywords and filenames; gate with "Use ONLY when..." if the skill should stay quiet on adjacent topics.
|
|
186
|
+
- Optional: `license`, `compatibility`, `metadata` (string-string map).
|
|
187
|
+
|
|
188
|
+
Register skills from non-default locations via `skills.paths` (scanned
|
|
189
|
+
recursively for `**/SKILL.md`) and `skills.urls` (each URL serves a list of
|
|
190
|
+
skills).
|
|
191
|
+
|
|
192
|
+
## References
|
|
193
|
+
|
|
194
|
+
References make local directories and Git repositories outside the active
|
|
195
|
+
project available as supporting context. Configure them under `references`,
|
|
196
|
+
keyed by the alias used in `@` autocomplete:
|
|
197
|
+
|
|
198
|
+
```json
|
|
199
|
+
{
|
|
200
|
+
"references": {
|
|
201
|
+
"docs": {
|
|
202
|
+
"path": "../product-docs",
|
|
203
|
+
"description": "Use for product behavior and terminology"
|
|
204
|
+
},
|
|
205
|
+
"effect": {
|
|
206
|
+
"repository": "Effect-TS/effect",
|
|
207
|
+
"branch": "main",
|
|
208
|
+
"description": "Use for Effect implementation details"
|
|
209
|
+
}
|
|
210
|
+
}
|
|
211
|
+
}
|
|
212
|
+
```
|
|
213
|
+
|
|
214
|
+
Local `path` values may be relative to the declaring config, absolute, or use
|
|
215
|
+
`~/`. Git `repository` values accept Git URLs, host/path references, and GitHub
|
|
216
|
+
`owner/repo` shorthand; `branch` is optional. Both forms support optional
|
|
217
|
+
`description` and `hidden` fields.
|
|
218
|
+
|
|
219
|
+
- Only references with a `description` are advertised to agents in system context.
|
|
220
|
+
- `hidden: true` removes a reference from TUI `@` autocomplete only. It remains available to agents and by direct path.
|
|
221
|
+
- Reference directories are automatically allowed through the external-directory boundary; normal read/edit/tool permissions still apply.
|
|
222
|
+
- String shorthand is supported: use `"docs": "../docs"` for local paths or `"effect": "Effect-TS/effect"` for Git repositories.
|
|
223
|
+
|
|
224
|
+
## Agents
|
|
225
|
+
|
|
226
|
+
Two ways to define an agent. Use the file form for anything non-trivial.
|
|
227
|
+
|
|
228
|
+
### Inline (in `neurocode.json`)
|
|
229
|
+
|
|
230
|
+
```json
|
|
231
|
+
{
|
|
232
|
+
"agent": {
|
|
233
|
+
"my-reviewer": {
|
|
234
|
+
"description": "Reviews PRs for style violations.",
|
|
235
|
+
"mode": "subagent",
|
|
236
|
+
"model": "anthropic/claude-sonnet-4-6",
|
|
237
|
+
"permission": { "edit": "deny", "bash": "ask" },
|
|
238
|
+
"prompt": "You are a strict PR reviewer..."
|
|
239
|
+
}
|
|
240
|
+
}
|
|
241
|
+
}
|
|
242
|
+
```
|
|
243
|
+
|
|
244
|
+
### File
|
|
245
|
+
|
|
246
|
+
```
|
|
247
|
+
.neurocode/agent/my-reviewer.md OR .neurocode/agents/my-reviewer.md
|
|
248
|
+
```
|
|
249
|
+
|
|
250
|
+
```markdown
|
|
251
|
+
---
|
|
252
|
+
description: Reviews PRs for style violations.
|
|
253
|
+
mode: subagent
|
|
254
|
+
model: anthropic/claude-sonnet-4-6
|
|
255
|
+
permission:
|
|
256
|
+
edit: deny
|
|
257
|
+
bash: ask
|
|
258
|
+
---
|
|
259
|
+
|
|
260
|
+
You are a strict PR reviewer. Focus on...
|
|
261
|
+
```
|
|
262
|
+
|
|
263
|
+
The file body becomes the agent's `prompt`. Do not also put `prompt:` in the
|
|
264
|
+
frontmatter.
|
|
265
|
+
|
|
266
|
+
`mode` is one of `"primary"`, `"subagent"`, `"all"`.
|
|
267
|
+
|
|
268
|
+
Allowed top-level frontmatter fields: `name, model, variant, description, mode,
|
|
269
|
+
hidden, color, steps, options, permission, disable, temperature, top_p`. Any
|
|
270
|
+
unknown field is silently routed into `options`.
|
|
271
|
+
|
|
272
|
+
To disable a built-in agent: `agent: { build: { disable: true } }`, or in a
|
|
273
|
+
file, `disable: true` in frontmatter.
|
|
274
|
+
|
|
275
|
+
`default_agent` must point to a non-hidden, primary-mode agent.
|
|
276
|
+
|
|
277
|
+
### Built-in agents
|
|
278
|
+
|
|
279
|
+
neurocode ships with `build`, `plan`, `general`, `explore`. Hidden internal agents:
|
|
280
|
+
`compaction`, `title`, `summary`. To override a built-in's fields, define the
|
|
281
|
+
same key in `agent: { <name>: { ... } }`.
|
|
282
|
+
|
|
283
|
+
## Commands
|
|
284
|
+
|
|
285
|
+
neurocode's command loader scans for `**/*.md` inside command directories. The
|
|
286
|
+
file is named after the command, and lives directly inside the `command` folder:
|
|
287
|
+
|
|
288
|
+
```
|
|
289
|
+
.neurocode/command/deploy.md
|
|
290
|
+
```
|
|
291
|
+
|
|
292
|
+
Frontmatter:
|
|
293
|
+
|
|
294
|
+
```markdown
|
|
295
|
+
---
|
|
296
|
+
description: One sentence describing what the command does.
|
|
297
|
+
agent: build
|
|
298
|
+
model: anthropic/claude-sonnet-4-6
|
|
299
|
+
---
|
|
300
|
+
|
|
301
|
+
(command body in markdown: the prompt neurocode runs, with $ARGUMENTS for the user's input)
|
|
302
|
+
```
|
|
303
|
+
|
|
304
|
+
- `template` is the command body — everything below the frontmatter — and is required: it is the prompt neurocode runs when the command is invoked. Do not also put a `template:` key in the frontmatter.
|
|
305
|
+
- `$ARGUMENTS` is replaced with everything the user typed after the command; `$1`, `$2`, … pull individual positional arguments.
|
|
306
|
+
- Optional: `description`, `agent`, `model`, `variant`, `subtask`.
|
|
307
|
+
|
|
308
|
+
## Plugins
|
|
309
|
+
|
|
310
|
+
`plugin:` is an array. Each entry is one of:
|
|
311
|
+
|
|
312
|
+
```json
|
|
313
|
+
"plugin": [
|
|
314
|
+
"neurocode-gemini-auth", // npm spec, latest
|
|
315
|
+
"neurocode-foo@1.2.3", // npm spec, pinned
|
|
316
|
+
"./local-plugin.ts", // file path, relative to the declaring config
|
|
317
|
+
"file:///abs/path/plugin.js", // file URL
|
|
318
|
+
["neurocode-bar", { "key": "val" }] // tuple form with options
|
|
319
|
+
]
|
|
320
|
+
```
|
|
321
|
+
|
|
322
|
+
Auto-discovered plugins (no config entry needed): any `*.ts` or `*.js` file in
|
|
323
|
+
`.neurocode/plugin/` or `.neurocode/plugins/`.
|
|
324
|
+
|
|
325
|
+
A plugin module exports `default` (or any named export) of type
|
|
326
|
+
`Plugin = (input: PluginInput, options?) => Promise<Hooks>`. The export is a
|
|
327
|
+
function, not a plain object literal, and the function returns an object
|
|
328
|
+
(return `{}` if there is nothing to register).
|
|
329
|
+
|
|
330
|
+
```ts
|
|
331
|
+
import type { Plugin } from "@neurocode-ai/plugin"
|
|
332
|
+
|
|
333
|
+
export default (async ({ client, project, directory, $ }) => {
|
|
334
|
+
return {
|
|
335
|
+
config: (cfg) => {
|
|
336
|
+
// cfg is the live merged config; mutate fields here.
|
|
337
|
+
},
|
|
338
|
+
"tool.execute.before": async (input, output) => {
|
|
339
|
+
// mutate output.args before the tool runs
|
|
340
|
+
},
|
|
341
|
+
}
|
|
342
|
+
}) satisfies Plugin
|
|
343
|
+
```
|
|
344
|
+
|
|
345
|
+
Hook surface (mutate `output` in place; return `void`):
|
|
346
|
+
|
|
347
|
+
- `event(input)`: every bus event
|
|
348
|
+
- `config(cfg)`: once on init with the merged config
|
|
349
|
+
- `chat.message`, `chat.params`, `chat.headers`
|
|
350
|
+
- `tool.execute.before`, `tool.execute.after`
|
|
351
|
+
- `tool.definition`
|
|
352
|
+
- `command.execute.before`
|
|
353
|
+
- `shell.env`
|
|
354
|
+
- `permission.ask`
|
|
355
|
+
- `experimental.chat.messages.transform`, `experimental.chat.system.transform`,
|
|
356
|
+
`experimental.session.compacting`, `experimental.compaction.autocontinue`,
|
|
357
|
+
`experimental.text.complete`
|
|
358
|
+
|
|
359
|
+
Special object-shaped (not callbacks): `tool: { my_tool: { ... } }`,
|
|
360
|
+
`auth: { ... }`, `provider: { ... }`.
|
|
361
|
+
|
|
362
|
+
## MCP servers
|
|
363
|
+
|
|
364
|
+
`mcp:` is an object keyed by server name. Each server is discriminated by
|
|
365
|
+
`type`:
|
|
366
|
+
|
|
367
|
+
```json
|
|
368
|
+
{
|
|
369
|
+
"mcp": {
|
|
370
|
+
"playwright": {
|
|
371
|
+
"type": "local",
|
|
372
|
+
"command": ["npx", "-y", "@playwright/mcp"],
|
|
373
|
+
"enabled": true,
|
|
374
|
+
"env": { "BROWSER": "chromium" }
|
|
375
|
+
},
|
|
376
|
+
"github": {
|
|
377
|
+
"type": "remote",
|
|
378
|
+
"url": "https://...",
|
|
379
|
+
"enabled": true,
|
|
380
|
+
"headers": { "Authorization": "Bearer {env:GITHUB_TOKEN}" }
|
|
381
|
+
},
|
|
382
|
+
"old-server": { "enabled": false }
|
|
383
|
+
}
|
|
384
|
+
}
|
|
385
|
+
```
|
|
386
|
+
|
|
387
|
+
`command` is an array of strings. `type` is required. Use `enabled: false` to
|
|
388
|
+
disable a server inherited from a parent config. String values such as header
|
|
389
|
+
tokens support `{env:VAR}` interpolation (and `{file:path}`); the shell-style
|
|
390
|
+
`${VAR}` is not substituted.
|
|
391
|
+
|
|
392
|
+
## Permissions
|
|
393
|
+
|
|
394
|
+
```json
|
|
395
|
+
"permission": {
|
|
396
|
+
"edit": "deny",
|
|
397
|
+
"bash": { "git *": "allow", "rm *": "deny", "*": "ask" },
|
|
398
|
+
"external_directory": { "~/secrets/**": "deny", "*": "allow" }
|
|
399
|
+
}
|
|
400
|
+
```
|
|
401
|
+
|
|
402
|
+
Actions: `"allow"`, `"ask"`, `"deny"`.
|
|
403
|
+
|
|
404
|
+
Per-tool value forms: `"allow"` shorthand (treated as `{"*": "allow"}`), or an
|
|
405
|
+
object `{ pattern: action }`. Within an object, **insertion order matters**.
|
|
406
|
+
neurocode evaluates the LAST matching rule, so put broad rules first and narrow
|
|
407
|
+
rules last.
|
|
408
|
+
|
|
409
|
+
`permission: "allow"` (a string at the top level) is shorthand for "allow
|
|
410
|
+
everything" and is rarely what the user wants.
|
|
411
|
+
|
|
412
|
+
Known permission keys: `read, edit, glob, grep, list, bash, task,
|
|
413
|
+
external_directory, todowrite, question, webfetch, websearch, lsp, doom_loop,
|
|
414
|
+
skill`. Some of these (`todowrite,
|
|
415
|
+
question, webfetch, websearch, doom_loop`) only accept a flat
|
|
416
|
+
action, not a per-pattern object.
|
|
417
|
+
|
|
418
|
+
`external_directory` patterns are filesystem paths (use `~/`, absolute paths,
|
|
419
|
+
or globs like `~/projects/**`).
|
|
420
|
+
|
|
421
|
+
Per-agent `permission:` overrides top-level `permission:`. Plan Mode lives on
|
|
422
|
+
the `plan` agent's permission ruleset (`edit: deny *`).
|
|
423
|
+
|
|
424
|
+
## Escape hatches
|
|
425
|
+
|
|
426
|
+
When a user's config is broken and neurocode won't start, these env vars help:
|
|
427
|
+
|
|
428
|
+
- `NEUROCODE_DISABLE_PROJECT_CONFIG=1`: skip the project's local `neurocode.json`
|
|
429
|
+
and start from globals only. Run from the project directory, neurocode loads,
|
|
430
|
+
the user edits the broken file, then they restart without the flag.
|
|
431
|
+
- `NEUROCODE_CONFIG=/path/to/file.json`: load an additional explicit config.
|
|
432
|
+
- `NEUROCODE_CONFIG_CONTENT='{"$schema":"https://neurocode.ai/config.json"}'`:
|
|
433
|
+
inject inline JSON as a final local-scope merge.
|
|
434
|
+
- `NEUROCODE_DISABLE_DEFAULT_PLUGINS=1`: skip default plugins.
|
|
435
|
+
- `NEUROCODE_PURE=1`: skip external plugins entirely.
|
|
436
|
+
- `NEUROCODE_DISABLE_EXTERNAL_SKILLS=1`,
|
|
437
|
+
`NEUROCODE_DISABLE_CLAUDE_CODE_SKILLS=1`: skip the external skill scans under
|
|
438
|
+
`~/.claude/` and `~/.agents/`.
|
|
439
|
+
|
|
440
|
+
## When proposing edits
|
|
441
|
+
|
|
442
|
+
- Validate against the schema before writing. If you are unsure of a field's
|
|
443
|
+
exact shape, or the field is not covered in this skill, fetch
|
|
444
|
+
`https://neurocode.ai/config.json` and read the schema rather than guessing.
|
|
445
|
+
- Preserve `$schema` and any existing fields the user did not ask to change.
|
|
446
|
+
- For agent, command, skill, and plugin definitions, prefer creating new files
|
|
447
|
+
in the correct location over inlining everything in `neurocode.json`.
|
|
448
|
+
- If the user's existing config is malformed, point them at the env-var escape
|
|
449
|
+
hatches above so they can edit from inside neurocode without breaking their
|
|
450
|
+
session.
|
|
451
|
+
- After saving any config change, remind the user to quit and restart neurocode
|
|
452
|
+
— running sessions keep using the already-loaded config.
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
/// <reference path="../markdown.d.ts" />
|
|
2
|
+
|
|
3
|
+
export * as SkillPlugin from "./skill"
|
|
4
|
+
|
|
5
|
+
import { define } from "./internal"
|
|
6
|
+
import { Effect } from "effect"
|
|
7
|
+
import { AbsolutePath } from "../schema"
|
|
8
|
+
import { SkillV2 } from "../skill"
|
|
9
|
+
import customizeNeurocodeContent from "./skill/customize-neurocode.md" with { type: "text" }
|
|
10
|
+
|
|
11
|
+
export const CustomizeNeurocodeContent = customizeNeurocodeContent
|
|
12
|
+
|
|
13
|
+
export const Plugin = define({
|
|
14
|
+
id: "skill",
|
|
15
|
+
effect: Effect.fn(function* (ctx) {
|
|
16
|
+
yield* ctx.skill.transform((draft) => {
|
|
17
|
+
draft.source(
|
|
18
|
+
SkillV2.EmbeddedSource.make({
|
|
19
|
+
type: "embedded",
|
|
20
|
+
skill: SkillV2.Info.make({
|
|
21
|
+
name: "customize-neurocode",
|
|
22
|
+
description:
|
|
23
|
+
"Use ONLY when the user is editing or creating neurocode's own configuration: neurocode.json, neurocode.jsonc, files under .neurocode/, or files under ~/.config/neurocode/. Also use when creating or fixing neurocode agents, subagents, commands, skills, plugins, MCP servers, or permission rules. Do not use for the user's own application code, or for any project that is not configuring neurocode itself.",
|
|
24
|
+
location: AbsolutePath.make("/builtin/customize-neurocode.md"),
|
|
25
|
+
content: CustomizeNeurocodeContent,
|
|
26
|
+
}),
|
|
27
|
+
}),
|
|
28
|
+
)
|
|
29
|
+
})
|
|
30
|
+
}),
|
|
31
|
+
})
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
export * as VariantPlugin from "./variant"
|
|
2
|
+
|
|
3
|
+
import type { ModelV2Info } from "@neurocode-ai/sdk/v2/types"
|
|
4
|
+
import { Effect } from "effect"
|
|
5
|
+
import { define } from "./internal"
|
|
6
|
+
|
|
7
|
+
export const Plugin = define({
|
|
8
|
+
id: "variant",
|
|
9
|
+
effect: Effect.fn(function* (ctx) {
|
|
10
|
+
yield* ctx.catalog.transform((catalog) => {
|
|
11
|
+
for (const record of catalog.provider.list()) {
|
|
12
|
+
for (const model of record.models.values()) {
|
|
13
|
+
catalog.model.update(model.providerID, model.id, (draft) => {
|
|
14
|
+
const generated = generate(draft)
|
|
15
|
+
if (generated.length === 0) return
|
|
16
|
+
|
|
17
|
+
const explicit = new Map(draft.variants.map((variant) => [variant.id, variant]))
|
|
18
|
+
const generatedIDs = new Set(generated.map((variant) => variant.id))
|
|
19
|
+
draft.variants = [
|
|
20
|
+
...generated.map((variant) => explicit.get(variant.id) ?? variant),
|
|
21
|
+
...draft.variants.filter((variant) => !generatedIDs.has(variant.id)),
|
|
22
|
+
]
|
|
23
|
+
})
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
})
|
|
27
|
+
}),
|
|
28
|
+
})
|
|
29
|
+
|
|
30
|
+
export function generate(model: ModelV2Info): ModelV2Info["variants"] {
|
|
31
|
+
if (model.api.type !== "aisdk" || model.api.package !== "@ai-sdk/openai-compatible") return []
|
|
32
|
+
const ids = `${model.id} ${model.api.id}`.toLowerCase()
|
|
33
|
+
if (!["glm-5.2", "glm-5-2", "glm-5p2"].some((name) => ids.includes(name))) return []
|
|
34
|
+
return ["high", "max"].map((id) => ({
|
|
35
|
+
id,
|
|
36
|
+
headers: {},
|
|
37
|
+
body: { reasoning_effort: id },
|
|
38
|
+
}))
|
|
39
|
+
}
|
package/src/plugin.ts
ADDED
|
@@ -0,0 +1,167 @@
|
|
|
1
|
+
export * as PluginV2 from "./plugin"
|
|
2
|
+
|
|
3
|
+
import { makeLocationNode } from "./effect/app-node"
|
|
4
|
+
import { Context, Deferred, Effect, Exit, Layer, Scope } from "effect"
|
|
5
|
+
import type { Plugin as PluginRuntime } from "@neurocode-ai/plugin/v2/effect"
|
|
6
|
+
import { Plugin } from "@neurocode-ai/schema/plugin"
|
|
7
|
+
import { AgentV2 } from "./agent"
|
|
8
|
+
import { AISDK } from "./aisdk"
|
|
9
|
+
import { Catalog } from "./catalog"
|
|
10
|
+
import { CommandV2 } from "./command"
|
|
11
|
+
import { EventV2 } from "./event"
|
|
12
|
+
import { Integration } from "./integration"
|
|
13
|
+
import { KeyedMutex } from "./effect/keyed-mutex"
|
|
14
|
+
import { PluginHost } from "./plugin/host"
|
|
15
|
+
import { Reference } from "./reference"
|
|
16
|
+
import { SkillV2 } from "./skill"
|
|
17
|
+
import { State } from "./state"
|
|
18
|
+
|
|
19
|
+
export const ID = Plugin.ID
|
|
20
|
+
export type ID = typeof ID.Type
|
|
21
|
+
export const Event = Plugin.Event
|
|
22
|
+
|
|
23
|
+
export interface Interface {
|
|
24
|
+
readonly add: (id: ID, effect: PluginRuntime["effect"]) => Effect.Effect<void>
|
|
25
|
+
readonly remove: (id: ID) => Effect.Effect<void>
|
|
26
|
+
readonly wait: (id: ID) => Effect.Effect<void>
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
export class Service extends Context.Service<Service, Interface>()("@neurocode/v2/Plugin") {}
|
|
30
|
+
|
|
31
|
+
const layer = Layer.effect(
|
|
32
|
+
Service,
|
|
33
|
+
Effect.gen(function* () {
|
|
34
|
+
const events = yield* EventV2.Service
|
|
35
|
+
const locks = KeyedMutex.makeUnsafe<ID>()
|
|
36
|
+
const scope = yield* Scope.make()
|
|
37
|
+
const active = new Map<ID, Scope.Closeable>()
|
|
38
|
+
const loading = new Set<ID>()
|
|
39
|
+
const waiters = new Map<ID, Set<Deferred.Deferred<void>>>()
|
|
40
|
+
const failures = new Map<ID, Exit.Exit<void, never>>()
|
|
41
|
+
let host: Parameters<PluginRuntime["effect"]>[0]
|
|
42
|
+
|
|
43
|
+
const add = Effect.fn("Plugin.add")(function* (id: ID, effect: PluginRuntime["effect"]) {
|
|
44
|
+
if (loading.has(id)) return yield* Effect.die(`Plugin load cycle detected for ${id}`)
|
|
45
|
+
|
|
46
|
+
yield* locks.withLock(id)(
|
|
47
|
+
Effect.sync(() => {
|
|
48
|
+
loading.add(id)
|
|
49
|
+
failures.delete(id)
|
|
50
|
+
}).pipe(
|
|
51
|
+
Effect.andThen(
|
|
52
|
+
State.batch(
|
|
53
|
+
Effect.gen(function* () {
|
|
54
|
+
const existing = active.get(id)
|
|
55
|
+
active.delete(id)
|
|
56
|
+
if (existing) yield* Scope.close(existing, Exit.void).pipe(Effect.ignore)
|
|
57
|
+
|
|
58
|
+
const child = yield* Scope.fork(scope)
|
|
59
|
+
yield* effect(host).pipe(
|
|
60
|
+
Scope.provide(child),
|
|
61
|
+
Effect.withSpan("Plugin.load", { attributes: { "plugin.id": id } }),
|
|
62
|
+
Effect.onExit((exit) => (Exit.isFailure(exit) ? Scope.close(child, exit) : Effect.void)),
|
|
63
|
+
)
|
|
64
|
+
yield* events.publish(Event.Added, { id })
|
|
65
|
+
active.set(id, child)
|
|
66
|
+
yield* Effect.forEach(waiters.get(id) ?? [], (waiter) => Deferred.succeed(waiter, undefined), {
|
|
67
|
+
discard: true,
|
|
68
|
+
})
|
|
69
|
+
waiters.delete(id)
|
|
70
|
+
}),
|
|
71
|
+
),
|
|
72
|
+
),
|
|
73
|
+
Effect.onExit((exit) => {
|
|
74
|
+
if (Exit.isSuccess(exit)) return Effect.void
|
|
75
|
+
failures.set(id, exit)
|
|
76
|
+
return Effect.forEach(waiters.get(id) ?? [], (waiter) => Deferred.done(waiter, exit), {
|
|
77
|
+
discard: true,
|
|
78
|
+
}).pipe(Effect.ensuring(Effect.sync(() => waiters.delete(id))))
|
|
79
|
+
}),
|
|
80
|
+
Effect.ensuring(Effect.sync(() => loading.delete(id))),
|
|
81
|
+
),
|
|
82
|
+
)
|
|
83
|
+
})
|
|
84
|
+
|
|
85
|
+
const remove = Effect.fn("Plugin.remove")(function* (id: ID) {
|
|
86
|
+
if (loading.has(id)) return yield* Effect.die(`Cannot remove plugin ${id} while it is loading`)
|
|
87
|
+
|
|
88
|
+
yield* locks.withLock(id)(
|
|
89
|
+
State.batch(
|
|
90
|
+
Effect.gen(function* () {
|
|
91
|
+
const current = active.get(id)
|
|
92
|
+
active.delete(id)
|
|
93
|
+
failures.delete(id)
|
|
94
|
+
if (current) yield* Scope.close(current, Exit.void).pipe(Effect.ignore)
|
|
95
|
+
}),
|
|
96
|
+
),
|
|
97
|
+
)
|
|
98
|
+
})
|
|
99
|
+
|
|
100
|
+
const wait = Effect.fn("Plugin.wait")(function* (id: ID) {
|
|
101
|
+
const waiter = yield* Deferred.make<void>()
|
|
102
|
+
const pending = yield* locks.withLock(id)(
|
|
103
|
+
Effect.sync(() => {
|
|
104
|
+
if (active.has(id)) return false
|
|
105
|
+
const failure = failures.get(id)
|
|
106
|
+
if (failure) return failure
|
|
107
|
+
const current = waiters.get(id) ?? new Set()
|
|
108
|
+
current.add(waiter)
|
|
109
|
+
waiters.set(id, current)
|
|
110
|
+
return true
|
|
111
|
+
}),
|
|
112
|
+
)
|
|
113
|
+
if (!pending) return
|
|
114
|
+
if (typeof pending !== "boolean") return yield* pending
|
|
115
|
+
yield* Deferred.await(waiter).pipe(
|
|
116
|
+
Effect.ensuring(
|
|
117
|
+
locks.withLock(id)(
|
|
118
|
+
Effect.sync(() => {
|
|
119
|
+
const current = waiters.get(id)
|
|
120
|
+
current?.delete(waiter)
|
|
121
|
+
if (current?.size === 0) waiters.delete(id)
|
|
122
|
+
}),
|
|
123
|
+
),
|
|
124
|
+
),
|
|
125
|
+
)
|
|
126
|
+
})
|
|
127
|
+
|
|
128
|
+
yield* Effect.addFinalizer((exit) =>
|
|
129
|
+
Effect.gen(function* () {
|
|
130
|
+
active.clear()
|
|
131
|
+
yield* State.batch(Scope.close(scope, exit))
|
|
132
|
+
}),
|
|
133
|
+
)
|
|
134
|
+
|
|
135
|
+
const service = Service.of({
|
|
136
|
+
add,
|
|
137
|
+
remove,
|
|
138
|
+
wait,
|
|
139
|
+
})
|
|
140
|
+
host = yield* PluginHost.make(service)
|
|
141
|
+
return service
|
|
142
|
+
}),
|
|
143
|
+
)
|
|
144
|
+
|
|
145
|
+
export const locationLayer = layer.pipe(
|
|
146
|
+
Layer.provideMerge(AgentV2.locationLayer),
|
|
147
|
+
Layer.provideMerge(AISDK.locationLayer),
|
|
148
|
+
Layer.provideMerge(Catalog.locationLayer),
|
|
149
|
+
Layer.provideMerge(CommandV2.locationLayer),
|
|
150
|
+
Layer.provideMerge(Integration.locationLayer),
|
|
151
|
+
Layer.provideMerge(Reference.locationLayer),
|
|
152
|
+
)
|
|
153
|
+
|
|
154
|
+
export const node = makeLocationNode({
|
|
155
|
+
service: Service,
|
|
156
|
+
layer,
|
|
157
|
+
deps: [
|
|
158
|
+
EventV2.node,
|
|
159
|
+
AgentV2.node,
|
|
160
|
+
AISDK.node,
|
|
161
|
+
Catalog.node,
|
|
162
|
+
CommandV2.node,
|
|
163
|
+
Integration.node,
|
|
164
|
+
Reference.node,
|
|
165
|
+
SkillV2.node,
|
|
166
|
+
],
|
|
167
|
+
})
|