Rename Source to Connector

Since we use the term "connections" everywhere else, renamed sources to
connectors

Author: KrisBraun

.changeset/config.json

@@ -14,6 +14,6 @@
   "updateInternalDependencies": "patch",
   "ignore": [
     "@plotday/twist-*",
-    "@plotday/source-*"
+    "@plotday/connector-*"
   ]
 }

.changeset/rename-source-to-connector.md

@@ -0,0 +1,5 @@
+---
+"@plotday/twister": minor
+---
+
+Changed: BREAKING: Renamed Source to Connector across the SDK. The `Source` class is now `Connector`, the `./source` export is now `./connector`, and all `@plotday/source-*` packages are now `@plotday/connector-*`. A deprecated `Source` alias is re-exported for backward compatibility.

AGENTS.md

@@ -4,11 +4,11 @@ This guide helps AI assistants build Plot sources and twists correctly.
 
 ## What Are You Building?
 
-### Building a Source (service integration)
+### Building a Connector (service integration)
 
-Sources are packages that connect to external services (Linear, Slack, Google Calendar, etc.). They extend Source and save data directly via `integrations.saveThread()`.
+Connectors are packages that connect to external services (Linear, Slack, Google Calendar, etc.). They extend Connector and save data directly via `integrations.saveThread()`.
 
-**Start here:** `sources/AGENTS.md` — Complete source development guide with scaffold, patterns, and checklist.
+**Start here:** `connectors/AGENTS.md` — Complete connector development guide with scaffold, patterns, and checklist.
 
 ### Building a Twist (orchestrator)
 
@@ -20,7 +20,7 @@ Twists are the entry point that users install. They declare which tools to use a
 
 All types in `twister/src/` with full JSDoc:
 
-- **Source base**: `twister/src/source.ts`
+- **Connector base**: `twister/src/connector.ts`
 - **Tool base**: `twister/src/tool.ts`
 - **Twist base**: `twister/src/twist.ts`
 - **Built-in tools**: `twister/src/tools/*.ts`
@@ -30,23 +30,23 @@ All types in `twister/src/` with full JSDoc:
 ## Additional Resources
 
 - **Full Documentation**: <https://twist.plot.day>
-- **Building Sources Guide**: `sources/AGENTS.md`
+- **Building Connectors Guide**: `connectors/AGENTS.md`
 - **Runtime Environment**: `twister/docs/RUNTIME.md`
 - **Tools Guide**: `twister/docs/TOOLS_GUIDE.md`
 - **Multi-User Auth**: `twister/docs/MULTI_USER_AUTH.md`
 - **Sync Strategies**: `twister/docs/SYNC_STRATEGIES.md`
-- **Working Source Examples**: `sources/linear/`, `sources/google-calendar/`, `sources/slack/`, `sources/jira/`
+- **Working Connector Examples**: `connectors/linear/`, `connectors/google-calendar/`, `connectors/slack/`, `connectors/jira/`
 
 ## Common Pitfalls
 
 1. **❌ Using instance variables for state** — Use `this.set()`/`this.get()` (state doesn't persist between executions)
 2. **❌ Long-running operations without batching** — Break into chunks with `runTask()` (~1000 requests per execution)
-3. **❌ Passing functions to `this.callback()`** — See `sources/AGENTS.md` for callback serialization pattern
+3. **❌ Passing functions to `this.callback()`** — See `connectors/AGENTS.md` for callback serialization pattern
 4. **❌ Forgetting sync metadata** — Always inject `syncProvider` and `channelId` into `thread.meta`
 5. **❌ Not handling initial vs incremental sync** — Propagate `initialSync` flag from entry point (`onChannelEnabled` → `true`, webhook → `false`) through all batch callbacks. Set `unread: false` and `archived: false` for initial, omit for incremental
 6. **❌ Missing localhost guard in webhooks** — Skip webhook registration when URL contains "localhost"
 7. **❌ Stripping HTML tags locally** — Pass raw HTML with `contentType: "html"` for server-side markdown conversion
 
 ---
 
-**Remember**: When in doubt, check the type definitions in `twister/src/` and study the working examples in `sources/`.
+**Remember**: When in doubt, check the type definitions in `twister/src/` and study the working examples in `connectors/`.

README.md

@@ -14,7 +14,7 @@
 ## Packages
 
 - **[@plotday/twister](./twister)** - Core twist creator package with the `plot` command, and library for building twists and tools
-- **[sources/](./sources)** - Source integrations that sync data from external services (Linear, Slack, Google Calendar, etc.)
+- **[connectors/](./connectors)** - Connector integrations that sync data from external services (Linear, Slack, Google Calendar, etc.)
 - **[twists/](./twists)** - Full source code for several twists
 
 ## Quick Start