@octocodeai/octocode-tools-core 16.6.2 → 16.6.3

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 (58) hide show
  1. package/README.md +11 -9
  2. package/dist/direct.js +37 -34
  3. package/dist/github/pullRequestSearch.d.ts +1 -0
  4. package/dist/index.d.ts +6 -4
  5. package/dist/index.js +39 -43
  6. package/dist/oql/adapters/graphProof.d.ts +6 -0
  7. package/dist/oql/adapters/graphView.d.ts +28 -0
  8. package/dist/oql/adapters/resultMap.d.ts +7 -0
  9. package/dist/oql/adapters/runner.d.ts +7 -0
  10. package/dist/oql/index.js +37 -34
  11. package/dist/oql/schema.d.ts +24 -8
  12. package/dist/oql/schemeText.d.ts +12 -11
  13. package/dist/oql/transformers/github/common.d.ts +7 -1
  14. package/dist/oql/types.d.ts +12 -2
  15. package/dist/responses.d.ts +4 -35
  16. package/dist/schema.js +2 -2
  17. package/dist/scheme/pagination.d.ts +51 -0
  18. package/dist/scheme/responseEnvelope.d.ts +67 -1
  19. package/dist/shared/config/index.d.ts +1 -8
  20. package/dist/shared/config/index.js +1 -2
  21. package/dist/shared/credentials/index.d.ts +1 -1
  22. package/dist/shared/credentials/index.js +2 -1
  23. package/dist/shared/credentials/storage.d.ts +0 -2
  24. package/dist/shared/credentials/testing.js +1 -1
  25. package/dist/shared/paths.d.ts +4 -0
  26. package/dist/shared/paths.js +1 -1
  27. package/dist/shared/session/index.js +1 -1
  28. package/dist/tools/directToolCatalog.exec.d.ts +5 -0
  29. package/dist/tools/github_clone_repo/scheme.d.ts +0 -1
  30. package/dist/tools/github_fetch_content/scheme.d.ts +6 -7
  31. package/dist/tools/github_search_code/scheme.d.ts +4 -6
  32. package/dist/tools/github_search_pull_requests/scheme.d.ts +0 -1
  33. package/dist/tools/github_search_repos/execution.d.ts +58 -0
  34. package/dist/tools/github_search_repos/scheme.d.ts +3 -6
  35. package/dist/tools/github_view_repo_structure/scheme.d.ts +0 -1
  36. package/dist/tools/local_binary_inspect/scheme.d.ts +97 -0
  37. package/dist/tools/local_fetch_content/scheme.d.ts +66 -0
  38. package/dist/tools/local_find_files/scheme.d.ts +49 -0
  39. package/dist/tools/local_ripgrep/scheme.d.ts +75 -0
  40. package/dist/tools/local_view_structure/scheme.d.ts +52 -0
  41. package/dist/tools/lsp/semantic_content/scheme.d.ts +8 -8
  42. package/dist/tools/lsp/shared/readiness.d.ts +17 -0
  43. package/dist/tools/package_search/scheme.d.ts +2 -4
  44. package/dist/tools/toolNames.d.ts +1 -0
  45. package/dist/utils/response/bulk.d.ts +1 -0
  46. package/dist/utils/response/groupedFinalizer.d.ts +7 -2
  47. package/package.json +4 -3
  48. package/dist/oql/adapters/v2.d.ts +0 -32
  49. package/dist/oql/v2params.d.ts +0 -22
  50. package/dist/shared/config/defaults.d.ts +0 -14
  51. package/dist/shared/config/loader.d.ts +0 -7
  52. package/dist/shared/config/resolver.d.ts +0 -2
  53. package/dist/shared/config/resolverCache.d.ts +0 -12
  54. package/dist/shared/config/resolverSections.d.ts +0 -10
  55. package/dist/shared/config/runtimeSurface.d.ts +0 -22
  56. package/dist/shared/config/types.d.ts +0 -92
  57. package/dist/shared/config/validator.d.ts +0 -2
  58. package/dist/shared/credentials/envTokens.d.ts +0 -9
package/README.md CHANGED
@@ -288,7 +288,7 @@ Per-project overrides and custom LSP servers live in a workspace `.octocode/` fo
288
288
 
289
289
  ## Authentication Methods
290
290
 
291
- GitHub-backed tools require authentication. Any one method is enough. Full details: [Authentication Setup](https://github.com/bgauryy/octocode/blob/main/docs/AUTHENTICATION.md).
291
+ GitHub-backed tools require authentication. Any one method is enough. Full details: [Authentication Setup](https://github.com/bgauryy/octocode/blob/main/docs/CONFIGURATION.md).
292
292
 
293
293
  ### Option 1: Octocode CLI (Recommended)
294
294
 
@@ -333,7 +333,7 @@ Create a token at [github.com/settings/tokens](https://github.com/settings/token
333
333
  - **Schema validation** runs before any tool executes; untrusted input size and shape are bounded.
334
334
  - **Credentials.** GitHub auth via env tokens, AES-256-GCM-encrypted on-disk OAuth, or the `gh` CLI; tokens are never logged.
335
335
 
336
- **Full security model, pipeline, and threat coverage: [SECURITY.md](https://github.com/bgauryy/octocode/blob/main/docs/SECURITY.md).** Related: [Authentication](https://github.com/bgauryy/octocode/blob/main/docs/AUTHENTICATION.md) · [Configuration](https://github.com/bgauryy/octocode/blob/main/docs/CONFIGURATION.md) · [Credentials](https://github.com/bgauryy/octocode/blob/main/docs/AUTHENTICATION.md#credential-architecture-api)
336
+ **Full security model, pipeline, and threat coverage: [SECURITY.md](https://github.com/bgauryy/octocode/blob/main/docs/SECURITY.md).** Related: [Authentication](https://github.com/bgauryy/octocode/blob/main/docs/CONFIGURATION.md) · [Configuration](https://github.com/bgauryy/octocode/blob/main/docs/CONFIGURATION.md) · [Credentials](https://github.com/bgauryy/octocode/blob/main/docs/CONFIGURATION.md#github-token)
337
337
 
338
338
  ---
339
339
 
@@ -355,9 +355,9 @@ Four code-intelligence axes; three are native to the Rust engine and need no ext
355
355
  ## Skills
356
356
 
357
357
  > [Agent Skills](https://agentskills.io/what-are-skills) are a lightweight, open format for extending AI agent capabilities.
358
- > Browse and install on [**skills.sh/bgauryy/octocode-mcp**](https://www.skills.sh/bgauryy/octocode-mcp) · Skills index: [skills/README.md](https://github.com/bgauryy/octocode/blob/main/skills/README.md)
358
+ > Browse and install on [**skills.sh/bgauryy/octocode-mcp**](https://www.skills.sh/bgauryy/octocode-mcp)
359
359
 
360
- These are the skills the Octocode team itself uses to build Octocode. **8 skills** live under [`skills/`](https://github.com/bgauryy/octocode/tree/main/skills); the table mirrors the [Skills Index](https://github.com/bgauryy/octocode/blob/main/skills/README.md). ⭐ **[Research](https://www.skills.sh/bgauryy/octocode-mcp/octocode-research)** is the recommended starting skill for technical research, code work, reviews, refactors, and repeated evidence loops.
360
+ These are the skills the Octocode team itself uses to build Octocode. **9 skills** live under [`skills/`](https://github.com/bgauryy/octocode/tree/main/skills); the table below is the full index. ⭐ **[Research](https://www.skills.sh/bgauryy/octocode-mcp/octocode-research)** is the recommended starting skill for technical research, code work, reviews, refactors, and repeated evidence loops.
361
361
 
362
362
  Each skill folder includes a human README with purpose, features, workflow, developer notes, and `npx octocode skill` installation. `SKILL.md` stays the compact agent-facing router.
363
363
 
@@ -374,7 +374,7 @@ npx octocode skill --install-all # install every o
374
374
  npx octocode skill --help # read live flags
375
375
  ```
376
376
 
377
- Platforms: `common` (default, `~/.agents/skills`), `cursor` (`~/.cursor/skills`), `claude` (`~/.claude/skills` and `~/.claude-desktop/skills`), `codex` (`~/.agents/skills`), `opencode` (`~/.config/opencode/skills`), `pi` (`~/.pi/agent/skills`), `copilot` (`~/.copilot/skills`), `gemini` (`~/.gemini/skills`), `all` · Modes: `symlink` (default), `copy`, `hybrid` · full platform table and bulk installs: [Skills Guide](https://github.com/bgauryy/octocode/blob/main/docs/SKILLS_GUIDE.md)
377
+ Platforms: `common` (default, `~/.agents/skills`), `cursor` (`~/.cursor/skills`), `claude` (`~/.claude/skills` and `~/.claude-desktop/skills`), `codex` (`~/.agents/skills`), `opencode` (`~/.config/opencode/skills`), `pi` (`~/.pi/agent/skills`), `copilot` (`~/.copilot/skills`), `gemini` (`~/.gemini/skills`), `all` · Modes: `symlink` (default), `copy`, `hybrid`
378
378
 
379
379
  | Skill | Directory | Install with `npx octocode` | Use it when |
380
380
  |-------|-----------|-----------------------------|-------------|
@@ -386,6 +386,7 @@ Platforms: `common` (default, `~/.agents/skills`), `cursor` (`~/.cursor/skills`)
386
386
  | [**Skills**](https://www.skills.sh/bgauryy/octocode-mcp/octocode-skills) | `octocode-skills/` | `npx octocode skill --name octocode-skills` | You are working on Agent Skills themselves. |
387
387
  | [**Awareness**](https://www.skills.sh/bgauryy/octocode-mcp/octocode-awareness) | `octocode-awareness/` | `npx octocode skill --name octocode-awareness` | You need memory, file locks, handoffs, or verify-before-conclude in a shared repo. |
388
388
  | [**Stats**](https://www.skills.sh/bgauryy/octocode-mcp/octocode-stats) | `octocode-stats/` | `npx octocode skill --name octocode-stats` | You want to visualize Octocode usage, savings, cache hits, errors, or rate limits. |
389
+ | [**Prompt Optimizer**](https://github.com/bgauryy/octocode/tree/main/skills/octocode-prompt-optimizer) | `octocode-prompt-optimizer/` | `npx octocode skill --name octocode-prompt-optimizer` | You want to optimize, strengthen, or shorten a prompt, `SKILL.md`, or `AGENTS.md`. |
389
390
 
390
391
  ---
391
392
 
@@ -428,6 +429,7 @@ client → sanitize inputs (Rust) → run tool (GitHub / FS / LSP) → sanitize
428
429
  | [`packages/octocode-mcp`](https://github.com/bgauryy/octocode/tree/main/packages/octocode-mcp) | `@octocodeai/mcp` | MCP server (stdio) that registers the tool catalog for AI assistants. |
429
430
  | [`packages/octocode-tools-core`](https://github.com/bgauryy/octocode/tree/main/packages/octocode-tools-core) | `@octocodeai/octocode-tools-core` | Shared tool core: implementations, GitHub client, credentials and token resolution, session, pagination, security bridge. |
430
431
  | [`packages/octocode-engine`](https://github.com/bgauryy/octocode/tree/main/packages/octocode-engine) | `@octocodeai/octocode-engine` | Rust/napi native engine: security scanning, minification, signatures, structural AST, ripgrep/diff/YAML, LSP. |
432
+ | [`packages/octocode-config`](https://github.com/bgauryy/octocode/tree/main/packages/octocode-config) | `@octocodeai/config` | Zero-dep env + config loader: `getOctocodeHome`, `.env` parsing, `.octocoderc` reading. Single source used by every package and skill. |
431
433
  | [`packages/octocode-vscode`](https://github.com/bgauryy/octocode/tree/main/packages/octocode-vscode) | `octocode-mcp-vscode` | VS Code extension: GitHub OAuth + multi-editor MCP install. |
432
434
 
433
435
  ---
@@ -438,14 +440,14 @@ Website: **[octocode.ai](https://octocode.ai)** · Product docs: **[github.com/b
438
440
 
439
441
  | Area | Docs |
440
442
  |---|---|
441
- | MCP server | [Octocode MCP Server](https://github.com/bgauryy/octocode/blob/main/docs/OCTOCODE_MCP.md) · [Configuration](https://github.com/bgauryy/octocode/blob/main/docs/CONFIGURATION.md) · [Authentication](https://github.com/bgauryy/octocode/blob/main/docs/AUTHENTICATION.md) |
443
+ | MCP server | [Octocode MCP Server](https://github.com/bgauryy/octocode/blob/main/docs/OCTOCODE_MCP.md) · [Configuration](https://github.com/bgauryy/octocode/blob/main/docs/CONFIGURATION.md) · [Authentication](https://github.com/bgauryy/octocode/blob/main/docs/CONFIGURATION.md) |
442
444
  | Tools and workflows | [Octocode Tools Reference](https://github.com/bgauryy/octocode/blob/main/docs/OCTOCODE_TOOLS.md) · [Octocode Research Skill](https://github.com/bgauryy/octocode/tree/main/skills/octocode-research) · [Search Guide](https://github.com/bgauryy/octocode/blob/main/docs/context/SEARCH_GUIDE.md) |
443
445
  | CLI and query language | [Octocode CLI Guide](https://github.com/bgauryy/octocode/blob/main/docs/OCTOCODE_CLI.md) · [Octocode Query Language](https://github.com/bgauryy/octocode/blob/main/docs/OCTOCODE_QUERY_LANGUAGE.md) · [OQL Research Graph Flow](https://github.com/bgauryy/octocode/blob/main/docs/context/OQL_RESEARCH_GRAPH_FLOW.md) |
444
- | Agent harness and skills | [Octocode Pi package](https://github.com/bgauryy/octocode/blob/main/packages/octocode-pi-extension/README.md) · [Skills Guide](https://github.com/bgauryy/octocode/blob/main/docs/SKILLS_GUIDE.md) · [Skills Index](https://github.com/bgauryy/octocode/blob/main/skills/README.md) |
446
+ | Agent harness and skills | [Octocode Pi package](https://github.com/bgauryy/octocode/blob/main/packages/octocode-pi-extension/README.md) · [Skills](https://github.com/bgauryy/octocode/tree/main/skills) |
445
447
  | Pi | [Pi package README](https://github.com/bgauryy/octocode/blob/main/packages/octocode-pi-extension/README.md) · [Pi APPEND_SYSTEM starter](https://github.com/bgauryy/octocode/blob/main/packages/octocode-pi-extension/docs/PI/APPEND_SYSTEM.md) |
446
- | Development and security | [Development Guide](https://github.com/bgauryy/octocode/blob/main/docs/DEVELOPMENT_GUIDE.md) · [Security Model](https://github.com/bgauryy/octocode/blob/main/docs/SECURITY.md) · [LSP Server Lifecycle](https://github.com/bgauryy/octocode/blob/main/docs/LSP_SERVER_LIFECYCLE.md) |
448
+ | Development and security | [Security Model](https://github.com/bgauryy/octocode/blob/main/docs/SECURITY.md) · [LSP Server Lifecycle](https://github.com/bgauryy/octocode/blob/main/docs/LSP_SERVER_LIFECYCLE.md) |
447
449
  | Benchmarks and evals | [Benchmark Summary](https://github.com/bgauryy/octocode/blob/main/packages/octocode-benchmark/BENCHMARK.md) · [Unified CLI/Tool/OQL Eval](https://github.com/bgauryy/octocode/blob/main/packages/octocode-benchmark/benchmark/octocode/README.md) · [Benchmark Runbook](https://github.com/bgauryy/octocode/blob/main/packages/octocode-benchmark/recipes/agent-benchmark-runbook.md) · [Support Matrix](https://github.com/bgauryy/octocode/blob/main/docs/LSP_SERVER_LIFECYCLE.md#full-format-support-matrix) |
448
- | Shared internals | [Credentials Architecture](https://github.com/bgauryy/octocode/blob/main/docs/AUTHENTICATION.md#credential-architecture-api) · [Session Persistence](https://github.com/bgauryy/octocode/blob/main/docs/OCTOCODE_MCP.md#session-persistence) |
450
+ | Shared internals | [Credentials Architecture](https://github.com/bgauryy/octocode/blob/main/docs/CONFIGURATION.md#github-token) · [Session Persistence](https://github.com/bgauryy/octocode/blob/main/docs/OCTOCODE_MCP.md#session-persistence) |
449
451
 
450
452
  ---
451
453