Skip to content

Commit 19b097b

Browse files
sanbuphyclaude
andcommitted
README: add 108 missing modules notice with categories
Document the 108 feature-gated modules that are absent from the published source, categorized as: internal code (~70), feature-gated tools (~20), and text/prompt assets (~6). Explain why they cannot be recovered. Co-Authored-By: Claude Opus 4.6 <[email protected]>
1 parent 1b77a70 commit 19b097b

1 file changed

Lines changed: 112 additions & 0 deletions

File tree

README.md

Lines changed: 112 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,118 @@
55
66
---
77

8+
## Missing Modules Notice (108 modules)
9+
10+
> **This source is incomplete.** 108 modules referenced by `feature()`-gated branches are **not included** in the npm package.
11+
> They exist only in Anthropic's internal monorepo and were dead-code-eliminated at compile time.
12+
> They **cannot** be recovered from `cli.js`, `sdk-tools.d.ts`, or any published artifact.
13+
14+
### Anthropic Internal Code (~70 modules, never published)
15+
16+
These modules have no source files anywhere in the npm package. They are internal Anthropic infrastructure.
17+
18+
| Module | Purpose | Feature Gate |
19+
|--------|---------|-------------|
20+
| `daemon/main.js` | Background daemon supervisor | `DAEMON` |
21+
| `daemon/workerRegistry.js` | Daemon worker registry | `DAEMON` |
22+
| `proactive/index.js` | Proactive notification system | `PROACTIVE` |
23+
| `contextCollapse/index.js` | Context collapse service (experimental) | `CONTEXT_COLLAPSE` |
24+
| `contextCollapse/operations.js` | Collapse operations | `CONTEXT_COLLAPSE` |
25+
| `contextCollapse/persist.js` | Collapse persistence | `CONTEXT_COLLAPSE` |
26+
| `skillSearch/featureCheck.js` | Remote skill feature check | `EXPERIMENTAL_SKILL_SEARCH` |
27+
| `skillSearch/remoteSkillLoader.js` | Remote skill loader | `EXPERIMENTAL_SKILL_SEARCH` |
28+
| `skillSearch/remoteSkillState.js` | Remote skill state | `EXPERIMENTAL_SKILL_SEARCH` |
29+
| `skillSearch/telemetry.js` | Skill search telemetry | `EXPERIMENTAL_SKILL_SEARCH` |
30+
| `skillSearch/localSearch.js` | Local skill search | `EXPERIMENTAL_SKILL_SEARCH` |
31+
| `skillSearch/prefetch.js` | Skill prefetch | `EXPERIMENTAL_SKILL_SEARCH` |
32+
| `coordinator/workerAgent.js` | Multi-agent coordinator worker | `COORDINATOR_MODE` |
33+
| `bridge/peerSessions.js` | Bridge peer session management | `BRIDGE_MODE` |
34+
| `assistant/index.js` | Kairos assistant mode | `KAIROS` |
35+
| `assistant/AssistantSessionChooser.js` | Assistant session picker | `KAIROS` |
36+
| `compact/reactiveCompact.js` | Reactive context compaction | `CACHED_MICROCOMPACT` |
37+
| `compact/snipCompact.js` | Snip-based compaction | `HISTORY_SNIP` |
38+
| `compact/snipProjection.js` | Snip projection | `HISTORY_SNIP` |
39+
| `compact/cachedMCConfig.js` | Cached micro-compact config | `CACHED_MICROCOMPACT` |
40+
| `sessionTranscript/sessionTranscript.js` | Session transcript service | `TRANSCRIPT_CLASSIFIER` |
41+
| `commands/agents-platform/index.js` | Internal agents platform | `ant` (internal) |
42+
| `commands/assistant/index.js` | Assistant command | `KAIROS` |
43+
| `commands/buddy/index.js` | Buddy system notifications | `BUDDY` |
44+
| `commands/fork/index.js` | Fork subagent command | `FORK_SUBAGENT` |
45+
| `commands/peers/index.js` | Multi-peer commands | `BRIDGE_MODE` |
46+
| `commands/proactive.js` | Proactive command | `PROACTIVE` |
47+
| `commands/remoteControlServer/index.js` | Remote control server | `DAEMON` + `BRIDGE_MODE` |
48+
| `commands/subscribe-pr.js` | GitHub PR subscription | `KAIROS_GITHUB_WEBHOOKS` |
49+
| `commands/torch.js` | Internal debug tool | `TORCH` |
50+
| `commands/workflows/index.js` | Workflow commands | `WORKFLOW_SCRIPTS` |
51+
| `jobs/classifier.js` | Internal job classifier | `TEMPLATES` |
52+
| `memdir/memoryShapeTelemetry.js` | Memory shape telemetry | `MEMORY_SHAPE_TELEMETRY` |
53+
| `services/sessionTranscript/sessionTranscript.js` | Session transcript | `TRANSCRIPT_CLASSIFIER` |
54+
| `tasks/LocalWorkflowTask/LocalWorkflowTask.js` | Local workflow task | `WORKFLOW_SCRIPTS` |
55+
| `protectedNamespace.js` | Internal namespace guard | `ant` (internal) |
56+
| `protectedNamespace.js` (envUtils) | Protected namespace runtime | `ant` (internal) |
57+
| `coreTypes.generated.js` | Generated core types | `ant` (internal) |
58+
| `devtools.js` | Internal dev tools | `ant` (internal) |
59+
| `attributionHooks.js` | Internal attribution hooks | `COMMIT_ATTRIBUTION` |
60+
| `systemThemeWatcher.js` | System theme watcher | `AUTO_THEME` |
61+
| `udsClient.js` / `udsMessaging.js` | UDS messaging client | `UDS_INBOX` |
62+
| `systemThemeWatcher.js` | Theme watcher | `AUTO_THEME` |
63+
64+
### Feature-Gated Tools (~20 modules, DCE'd from bundle)
65+
66+
These tools have type signatures in `sdk-tools.d.ts` but their implementations were stripped at compile time.
67+
68+
| Tool | Purpose | Feature Gate |
69+
|------|---------|-------------|
70+
| `REPLTool` | Interactive REPL (VM sandbox) | `ant` (internal) |
71+
| `SnipTool` | Context snipping | `HISTORY_SNIP` |
72+
| `SleepTool` | Sleep/delay in agent loop | `PROACTIVE` / `KAIROS` |
73+
| `MonitorTool` | MCP monitoring | `MONITOR_TOOL` |
74+
| `OverflowTestTool` | Overflow testing | `OVERFLOW_TEST_TOOL` |
75+
| `WorkflowTool` | Workflow execution | `WORKFLOW_SCRIPTS` |
76+
| `WebBrowserTool` | Browser automation | `WEB_BROWSER_TOOL` |
77+
| `TerminalCaptureTool` | Terminal capture | `TERMINAL_PANEL` |
78+
| `TungstenTool` | Internal perf monitoring | `ant` (internal) |
79+
| `VerifyPlanExecutionTool` | Plan verification | `CLAUDE_CODE_VERIFY_PLAN` |
80+
| `SendUserFileTool` | Send files to users | `KAIROS` |
81+
| `SubscribePRTool` | GitHub PR subscription | `KAIROS_GITHUB_WEBHOOKS` |
82+
| `SuggestBackgroundPRTool` | Suggest background PRs | `KAIROS` |
83+
| `PushNotificationTool` | Push notifications | `KAIROS` |
84+
| `CtxInspectTool` | Context inspection | `CONTEXT_COLLAPSE` |
85+
| `ListPeersTool` | List active peers | `UDS_INBOX` |
86+
| `DiscoverSkillsTool` | Skill discovery | `EXPERIMENTAL_SKILL_SEARCH` |
87+
88+
### Text/Prompt Assets (~6 files)
89+
90+
These are internal prompt templates and documentation, never published.
91+
92+
| File | Purpose |
93+
|------|---------|
94+
| `yolo-classifier-prompts/auto_mode_system_prompt.txt` | Auto-mode system prompt for classifier |
95+
| `yolo-classifier-prompts/permissions_anthropic.txt` | Anthropic-internal permission prompt |
96+
| `yolo-classifier-prompts/permissions_external.txt` | External user permission prompt |
97+
| `verify/SKILL.md` | Verification skill documentation |
98+
| `verify/examples/cli.md` | CLI verification examples |
99+
| `verify/examples/server.md` | Server verification examples |
100+
101+
### Why They're Missing
102+
103+
```
104+
Anthropic Internal Monorepo Published npm Package
105+
────────────────────────── ─────────────────────
106+
feature('DAEMON') → true ──build──→ feature('DAEMON') → false
107+
↓ ↓
108+
daemon/main.js ← INCLUDED ──bundle─→ daemon/main.js ← DELETED (DCE)
109+
tools/REPLTool ← INCLUDED ──bundle─→ tools/REPLTool ← DELETED (DCE)
110+
proactive/ ← INCLUDED ──bundle─→ (referenced but absent from src/)
111+
```
112+
113+
Bun's `feature()` is a **compile-time intrinsic**:
114+
- Returns `true` in Anthropic's internal build → code is kept in the bundle
115+
- Returns `false` in the published build → code is dead-code-eliminated
116+
- The 108 modules simply do not exist anywhere in the published artifact
117+
118+
---
119+
8120
## Copyright & Disclaimer
9121

10122
```

0 commit comments

Comments
 (0)