Open source Grok Bot alternative, Bring your own agent and subscription: message Claude Code, Codex, Gemini CLI, Cursor, Copilot and 40+ AI agents as bots on your own computer, from iPhone, Mac, Windows, Linux or terminal. Agent-agnostic and free. Also a Muse and Dots alternative. Built in Rust.
Rust acpagent-client-protocolai-agentsai-assistantclaudeclaude-codecodexcoding-agentscursorgeminigemini-cligrok-bot-alternativeiosiphonelinuxmacosmcpopen-sourcerustself-hosted
feat(web): add a user manual to the website
leepokai4f624e5219cd
diff --git a/.agents/skills/after-change/SKILL.md b/.agents/skills/after-change/SKILL.mdindex bf631a99..d4f680a9 100644--- a/.agents/skills/after-change/SKILL.md+++ b/.agents/skills/after-change/SKILL.md@@ -30,7 +30,7 @@ Give every reviewer the same absolute worktree, base commit, owned scope, change| Reviewer | Focus || --- | --- || Correctness | Concrete bugs, regressions, error handling, security, and compatibility with older hosts/clients; consult `docs/reference/compatibility.md`. |-| Completeness | All affected clients, stale documentation, missing behavioral tests, release versions and iOS What's New requirements. |+| Completeness | All affected clients, stale documentation (including the user manual page, `docs/guides/user-docs.md`), missing behavioral tests, release versions and iOS What's New requirements. || Refactor | Responsibility splits, files over ~500 lines, long functions, layer leaks, missed reuse, and applicable language conventions. Only suggestions worth their diff. |Each finding includes file, line when available, severity (`high`, `medium`, `low`), summary, concrete failure scenario (or cost of leaving a refactor), and suggested fix. Empty results are valid. Style preferences alone are not defects.diff --git a/.claude/workflows/after-change.js b/.claude/workflows/after-change.jsindex d5f8a3bf..ef6d2a50 100644--- a/.claude/workflows/after-change.js+++ b/.claude/workflows/after-change.js@@ -71,7 +71,7 @@ const CHECKS = {const REVIEWERS = [{ name: 'correctness', text: 'Lens: correctness: bugs, regressions, broken edge cases, error handling, data loss, security, and compatibility with older clients and hosts (docs/reference/compatibility.md). Report only real defects with a concrete failure scenario; style nits are not findings.' },- { name: 'completeness', text: 'Lens: completeness: every client the change should reach (iPhone, Android, desktop, terminal UI, per CLAUDE.md cross-platform rules), docs made stale by it, missing or weak tests, and the version bump and What\'s New rules. Report only real gaps; style nits are not findings.' },+ { name: 'completeness', text: 'Lens: completeness: every client the change should reach (iPhone, Android, desktop, terminal UI, per CLAUDE.md cross-platform rules), docs made stale by it (the user manual in web/content/docs/ too, for anything users see or do differently: docs/guides/user-docs.md), missing or weak tests, and the version bump and What\'s New rules. Report only real gaps; style nits are not findings.' },{ name: 'refactor', text: 'Lens: refactor (docs/guides/clean-code.md "After every change"): responsibility splits, files past ~500 lines, long functions, layer leaks, missed reuse, language best practices (Swift 6, Rust rust-skills, strict TypeScript, Compose). Only suggestions worth their diff.' },]diff --git a/.githooks/pre-commit b/.githooks/pre-commitindex cd8dca90..b2aa3964 100755--- a/.githooks/pre-commit+++ b/.githooks/pre-commit@@ -51,6 +51,13 @@ if touches '^apps/desktop/'; then(cd "$snapshot/apps/desktop" && npm run typecheck && npm test)fi+if touches '^web/'; then+ staged_copy+ echo "Checking the user manual (pages compile, links and anchors)..."+ ln -s "$repo/web/node_modules" "$snapshot/web/node_modules"+ (cd "$snapshot/web" && npm run check:docs)+fi+for dir in cloud relay discord; doif touches "^(cloud/|relay/|discord/|docs/reference/fixtures/remote-relay-vectors\\.json)"; thenstaged_copydiff --git a/AGENTS.md b/AGENTS.mdindex 69801668..25ad8a92 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -93,4 +93,4 @@ PRs should explain behavior changes, link relevant issues, list validation perfo- CLAUDE.md and AGENTS.md hold only rules an agent needs on every task. Reference material (file structure, naming tables, API details, audits, how-tos) goes in `docs/` as its own file, with a one-line pointer here.- Whenever you edit either file, check its length: past ~100 lines, or a section past a few lines of reference detail, refactor that detail into `docs/` and leave the pointer, without being asked.-- Keep `docs/` current: update the doc in the same change that makes it stale.+- Keep `docs/` current: update the doc in the same change that makes it stale. A change users can see also updates its page of the user manual (`web/content/docs/`): [user docs](docs/guides/user-docs.md).diff --git a/CLAUDE.md b/CLAUDE.mdindex 4a9d564c..2b12f5e4 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -97,4 +97,4 @@ Follow the Conventional Commit and PR rules in [AGENTS.md](AGENTS.md#commit--pul- CLAUDE.md and AGENTS.md hold only rules an agent needs on every task. Reference material (file structure, naming tables, API details, audits, how-tos) goes in `docs/` as its own file, with a one-line pointer here.- Whenever you edit either file, check its length: past ~100 lines, or a section past a few lines of reference detail, refactor that detail into `docs/` and leave the pointer, without being asked.-- Keep `docs/` current: update the doc in the same change that makes it stale.+- Keep `docs/` current: update the doc in the same change that makes it stale. A change users can see also updates its page of the user manual (`web/content/docs/`): [user docs](docs/guides/user-docs.md).diff --git a/README.md b/README.mdindex 11269883..1640e9ba 100644--- a/README.md+++ b/README.md@@ -7,7 +7,7 @@**The open-source Grok Bot alternative.**<br>Your coding agents, as teammates you can message.-[Website](https://www.codync.dev) · [Compare](https://www.codync.dev/compare) · [Launch film](https://youtu.be/QAhyZWpV70U)+[Website](https://www.codync.dev) · [Docs](https://www.codync.dev/docs) · [Compare](https://www.codync.dev/compare) · [Launch film](https://youtu.be/QAhyZWpV70U)[](https://github.com/leepokai/Codync/stargazers)<br><sub>Free, open source, no paid tier. A ⭐ is how others find it.</sub>@@ -134,9 +134,9 @@ The script also installs the desktop app (`codync`, an AppImage, with its `.deskBuilding the desktop app yourself: `cd apps/desktop && npm ci && npm run dev`.-**Linux server / cloud VM** — the host runs headless on any distro (static binary, x86_64 + arm64). Setup, remote access and limitations: [docs/guides/linux-servers.md](docs/guides/linux-servers.md).+**Linux server / cloud VM** — the host runs headless on any distro (static binary, x86_64 + arm64). Setup, remote access and limitations: [Linux servers](https://www.codync.dev/docs/linux-servers) ([contributor notes](docs/guides/linux-servers.md)).-**Remote access** works out of the box through the free Cloudflare relay, end-to-end encrypted; the phone switches to a direct connection on the same network or over Tailscale. Details: [remote relay](docs/reference/remote-relay.md).+**Remote access** works out of the box through the free Cloudflare relay, end-to-end encrypted; the phone switches to a direct connection on the same network or over Tailscale. Details: [Remote access](https://www.codync.dev/docs/remote-access) ([protocol](docs/reference/remote-relay.md)).**Agents** — install and sign in to whichever you use; Codync finds them. Claude Code, Codex and Pi run through their ACP adapters (fetched by `npx`, so Node.js is needed for those).diff --git a/docs/README.md b/docs/README.mdindex 1744f048..9b5d8e46 100644--- a/docs/README.md+++ b/docs/README.md@@ -12,6 +12,7 @@ Source review, a passing build, local integration tests and production acceptanc| Work on the macOS, Linux and Windows desktop app (Electron) | [Desktop app](architecture/desktop-app.md), [desktop styles](guides/desktop-styles.md) || Build, install, restart and run checks | [Development](guides/development.md), [Codync Dev beside production](guides/dev-app.md) || Write or refactor code in any module | [Clean code](guides/clean-code.md) |+| Change something users see or do (keep the codync.dev manual current) | [User docs](guides/user-docs.md) || Change an iPhone or desktop screen or button | [UI conventions](design/ui-conventions.md) || Change the composer | [Composer behavior and checks](guides/composer.md) || Ship app and host updates | [Updates](guides/updates.md), [client and host compatibility](reference/compatibility.md) |diff --git a/docs/guides/clean-code.md b/docs/guides/clean-code.mdindex 117f1957..d69355b6 100644--- a/docs/guides/clean-code.md+++ b/docs/guides/clean-code.md@@ -41,7 +41,7 @@ Rules every change follows, in every part of the repository (host, iOS, desktop,Once a code change works (its tests pass) and before commit, it goes through three stages, in this order:-1. **Review**: three read-only reviewers at once: correctness (bugs, regressions, error handling, security, compatibility with older clients and hosts), completeness (every client the change should reach, stale docs, missing tests, version and What's New rules) and refactor (responsibility splits, files past ~500 lines, long functions, layer leaks, missed reuse, language best practices: Swift 6, Rust `rust-skills`, strict TypeScript, Compose). A verifier then tries to refute each correctness and completeness finding against the code.+1. **Review**: three read-only reviewers at once: correctness (bugs, regressions, error handling, security, compatibility with older clients and hosts), completeness (every client the change should reach, stale docs and the [user manual](user-docs.md) page, missing tests, version and What's New rules) and refactor (responsibility splits, files past ~500 lines, long functions, layer leaks, missed reuse, language best practices: Swift 6, Rust `rust-skills`, strict TypeScript, Compose). A verifier then tries to refute each correctness and completeness finding against the code.2. **Fix and cleanup**, one editor in one pass: the surviving findings at their root cause, the refactors worth their diff, and a cleanup of the change's own lines (dead code, duplication, unclear names, comments that restate the code, unused imports, places an existing helper should be reused); then the affected builds and tests run once.3. **End-to-end test** of the final code: the changed flows on the real apps, minimal or full as CLAUDE.md defines it, each walked once with short bot turns. A failure the change didn't cause is reported as preexisting. A real failure is fixed, and only the fixed flows are walked again.diff --git a/docs/guides/development.md b/docs/guides/development.mdindex 57b1134a..d7e7129b 100644--- a/docs/guides/development.md+++ b/docs/guides/development.md@@ -119,8 +119,9 @@ git config core.hooksPath .githooksIt runs CI's checks for each part a commit touches, so a failure shows up before the push:host and the memory crate (`cargo fmt --all --check`, clippy and `cargo test` for the workspace), desktop, cloudand relay (`npm run typecheck`, `npm test`), the Android app (core and app unit tests, and a Kotlin compile of-the app and its instrumentation tests, with JDK 21), Linux screen helper formatting, and a parse of the macOS-screen helper's Swift sources (on macOS). It checks the staged files only, in a copy under `.git/precommit-snapshot`,+the app and its instrumentation tests, with JDK 21), Linux screen helper formatting, a parse of the macOS+screen helper's Swift sources (on macOS), and the website's user manual (`npm run check:docs` in `web/`: pages+compile, links and anchors resolve). It checks the staged files only, in a copy under `.git/precommit-snapshot`,so other agents' uncommitted edits in the same checkout neither break nor rescue a commit; thehost builds into `host/target/precommit`, and its tests are stopped after 5 minutes so a hungtest fails the commit instead of holding it. The npm checks reuse each package's `node_modules`diff --git a/docs/guides/linux-servers.md b/docs/guides/linux-servers.mdindex 83af8208..22a3eb6e 100644--- a/docs/guides/linux-servers.md+++ b/docs/guides/linux-servers.md@@ -35,11 +35,11 @@ Other commands work the same as on a desktop: `codync-host pair`, `codync-host tThe phone connects over the encrypted device channel. The pairing link lists only **Tailscale** and **private (LAN/VPC)** addresses, plus any you set in `CODYNC_EXTERNAL_URL`; the host never advertises a public IP on its own.- **Tailscale (recommended for VMs):** install Tailscale on the VM and on the phone, then `codync-host pair`. The Tailscale name comes first in the link. You don't need to open port 19222 in the cloud firewall.-- **Cloudflare cloud:** start the host with `CODYNC_CLOUD_URL=https://…` if you run your own Codync cloud. The production cloud isn't live yet (see [environments](environments-and-deployment.md)).+- **Codync relay (on by default):** a release host connects to the production cloud (`https://api.codync.dev`), so a paired phone reaches it from anywhere with nothing to open. `codync-host cloud --disable` turns it off; `CODYNC_CLOUD_URL=https://…` points the host at a cloud you run yourself (see [environments](environments-and-deployment.md)).- **Your own HTTPS reverse proxy:** forward only `/channel` (WebSocket upgrade) at the root of a hostname to the host; don't forward `/api`, `/events`, `/term` or `/oauth`: through a local proxy every request looks like it comes from this computer, so the loopback-only checks no longer protect them. Then set `CODYNC_EXTERNAL_URL=https://codync.example.com` (comma-separated for several) in the host's environment: `systemctl --user edit codync-host`, add `[Service]` and `Environment=CODYNC_EXTERNAL_URL=https://codync.example.com`, then `systemctl --user restart codync-host`. The host advertises those URLs first, in the pairing link and on every connection, so the phone keeps them (a phone keeps only the addresses the host advertises). Under your own supervisor, `CODYNC_EXTERNAL_URL=… codync-host serve --bind 127.0.0.1` keeps the host on loopback behind the proxy. The phone dials `<url>/channel?v=1`. Opening `/channel` in a browser or with `curl` gets `400` (no WebSocket upgrade), and an upgrade without `?v=1` gets `426` `upgradeRequired`: that means the proxy works. A working proxy answers the phone's upgrade with `101`.- **Desktop app over SSH:** the desktop app (macOS or Linux) can attach an SSH computer and tunnel to its loopback API ([Accounts and SSH](accounts-and-ssh.md)). From any terminal: `ssh -L 19222:127.0.0.1:19222 vm`, then `codync-host tui` locally.-The host listens on `0.0.0.0:19222`. The local API (`/api/*`, `/events`, terminals; bearer token) answers **loopback callers only**, so a public address never exposes it. From outside, only `/health` (host id, computer id, version) and the end-to-end encrypted device channel answer, and the channel only serves devices holding this host's pairing keys. Keep 19222 closed in the cloud firewall anyway unless you deliberately pair over a VPN or private network.+The host listens on `0.0.0.0:19222`. The local API (`/api/*`, `/events`, terminals; bearer token) answers **loopback callers only**, so a public address never exposes it. From outside, only `/health` (host id, computer id, version, environment; the binary path and hash and `busy` go to loopback callers only), local routine webhooks (`/hooks/routines/{id}`, which need the routine's key) and the end-to-end encrypted device channel answer, and the channel only serves devices holding this host's pairing keys. Keep 19222 closed in the cloud firewall anyway unless you deliberately pair over a VPN or private network.## Limitations on a headless serverdiff --git a/docs/guides/user-docs.md b/docs/guides/user-docs.mdnew file mode 100644index 00000000..d465ab33--- /dev/null+++ b/docs/guides/user-docs.md@@ -0,0 +1,51 @@+# User manual (codync.dev/docs)++The website has a user manual for people who use Codync: what a bot is, how to set one up, what it can do.+It lives in the site (`web/`): one MDX file per page in `web/content/docs/<slug>.mdx`, the sidebar order and each page's title and+description in `web/app/docs/pages.ts`, the pages' typography in `web/mdx-components.tsx`. The docs in this folder stay the+contributor's reference; the manual says the same things for users.++## Keep it current++A change a user can see or do differently updates the manual page that covers it, in the same change, like any+other doc it makes stale: a new or renamed setting, button, command or flow, a new agent, a changed limit or+number, a new privacy-relevant data flow. Add a page (file plus its `pages.ts` entry) when a feature fits none.+The site deploys `main` to codync.dev and `dev` to a preview, so the manual goes live with the release that ships+the change.++## Pages and their sources++| Page | Covers | Sources |+| --- | --- | --- |+| `getting-started` | Install, pair, first bot | `README.md`, [updates](updates.md), [dev app](dev-app.md) for names only |+| `bots` | Creating, settings, workspaces, hiding, permissions, new session | [bot workspaces](../features/bot-workspaces.md), [conversation runtime](../architecture/conversation-runtime.md) |+| `agents` | Known agents, registry, custom command, Extensions, sign-in, models | [extensions](../features/marketplace.md), `host/src/agent/backends.rs` |+| `conversations` | Messages, files, approval cards, stop, replies, reactions, commands, fresh conversations, notifications | [chat messages](../features/chat-messages.md), [file attachments](../features/file-attachments.md), [context and memory](../features/context-and-memory.md), [notifications](../design/push-and-live-activity.md) |+| `groups` | Group chats | [groups and replies](../features/groups-and-replies.md) |+| `teamwork` | Bots messaging bots, Manage the team | [bot collaboration](../features/bot-collaboration.md) |+| `routines` | Schedules, webhooks, runs | [routines](../features/routines.md) |+| `memory` | Layers, dreaming, the agent's own memory | [context and memory](../features/context-and-memory.md), [bot memory](../design/bot-memory.md) |+| `connectors-and-skills` | MCP connectors, apps, skills | [connector credentials](../features/connector-credentials.md), [extensions](../features/marketplace.md) |+| `agent-fallbacks` | The fallback chain | [agent fallbacks](../features/agent-fallback.md) |+| `computer-use` | Remote screen, computer use | [remote screen](../features/remote-screen.md), [computer use](../features/computer-use.md) |+| `voice` | Calls, dictation, engines and keys | [voice calls](../features/voice-call.md) |+| `remote-access` | Relay, direct routes, pairing, accounts, reverse proxy, SSH computers | [remote protocol](../reference/remote-relay.md), [accounts and SSH](accounts-and-ssh.md) |+| `linux-servers` | Headless install, reaching it, firewall, approvals | [Linux servers](linux-servers.md) |+| `updates` | App and host updates, version mismatch, uninstall | [updates](updates.md), [compatibility](../reference/compatibility.md) |+| `privacy` | What stays on the computer, what Codync's services see, analytics | [analytics](../features/analytics.md), [remote protocol](../reference/remote-relay.md); keep it consistent with the policy page `web/app/privacy/page.tsx` |++## Writing rules++- English only. Plain, short sentences in the second person. Name things the way the apps show them (the bot's+ settings, **Manage the team**), with the real English UI labels in bold; no source paths, type or method names+ unless the reader types them (a CLI command, an environment variable).+- Where the apps differ, say how in each, briefly: **iPhone**, **Desktop**, **Terminal UI**.+- Describe the current release only. Leave out the Android app until it's public, Codync 1.x, products the UI+ was modeled on, multiple computers per account, roadmap and internal investigations.+- Every claim is checkable against the code or a doc above. Numbers and limits are written as the code has them.+ Security guidance (what the relay sees, loopback-only API, reverse-proxy rules) is exact.+- MDX: the page's title (its `#` heading) and description live in `pages.ts`, so the file holds only `##` and+ `###` sections, lists and small tables, no images or components. Never a bare `<`, `{` or `}` in prose: put code,+ paths and placeholders in backticks. Link pages as `/docs/<slug>`, sections as `/docs/<slug>#<heading-id>`.+- Check: in `web/`, `npm run check:docs` (also run by the pre-commit hook) compiles every page and checks that+ every `/docs` link and `#anchor` lands on an existing page and heading; `npm run build` must pass too.diff --git a/docs/reference/compatibility.md b/docs/reference/compatibility.mdindex 1cfd898c..598ef543 100644--- a/docs/reference/compatibility.md+++ b/docs/reference/compatibility.md@@ -2,7 +2,7 @@Clients (iPhone, desktop app on macOS, Linux and Windows, terminal client) and the host update ondifferent schedules: the iPhone app waits for App Review, the desktop app and standalone hosts-update when their owner (or the opt-in automatic updater) installs a release. Any client can+update when their owner (or the automatic updater, on by default for hosts that update themselves) installs a release. Any client canmeet an older or a newer host.## Rulediff --git a/web/app/components/privacy.tsx b/web/app/components/privacy.tsxindex 6a663c7a..099e0142 100644--- a/web/app/components/privacy.tsx+++ b/web/app/components/privacy.tsx@@ -6,7 +6,7 @@ const points = [{icon: HardDrives,title: "Your data stays home",- body: "Bots, transcripts and memory live on your Mac, Windows PC or Linux machine. Agents run there with your own logins. No Codync account, no cloud copy of your files or conversations.",+ body: "Bots, transcripts and memory live on your Mac, Windows PC or Linux machine. Agents run there with your own logins. No account needed, no cloud copy of your files or conversations.",},{icon: WifiHigh,diff --git a/web/app/components/site-chrome.tsx b/web/app/components/site-chrome.tsxindex b4646925..b2940309 100644--- a/web/app/components/site-chrome.tsx+++ b/web/app/components/site-chrome.tsx@@ -6,6 +6,7 @@ import { DISCORD, EMAIL, GITHUB } from "../links";const nav: [href: string, label: string][] = [["/#product", "Product"],+ ["/docs", "Docs"],["/compare", "Compare"],["/#cost", "Pricing"],["/#faq", "FAQ"],@@ -52,6 +53,7 @@ export function SiteHeader() {}const footerLinks: [label: string, href: string][] = [+ ["Docs", "/docs"],["Free AI agent app", "/free-ai-agent-app"],["Claude Code on iPhone", "/claude-code-iphone"],["Codex on iPhone", "/codex-iphone"],diff --git a/web/app/docs/[slug]/page.tsx b/web/app/docs/[slug]/page.tsxnew file mode 100644index 00000000..673021a2--- /dev/null+++ b/web/app/docs/[slug]/page.tsx@@ -0,0 +1,50 @@+import type { Metadata } from "next";+import Link from "next/link";+import { notFound } from "next/navigation";+import { docPages } from "../pages";++type Props = { params: Promise<{ slug: string }> };++/** The page `params` names, with the pages before and after it in the sidebar. */+async function find(params: Props["params"]) {+ const { slug } = await params;+ const index = docPages.findIndex((p) => p.slug === slug);+ if (index < 0) notFound();+ return { page: docPages[index], previous: docPages[index - 1], next: docPages[index + 1] };+}++export function generateStaticParams() {+ return docPages.map(({ slug }) => ({ slug }));+}++export const dynamicParams = false;++export async function generateMetadata({ params }: Props): Promise<Metadata> {+ const { page } = await find(params);+ return { title: page.title, description: page.description, alternates: { canonical: `/docs/${page.slug}` } };+}++export default async function DocPage({ params }: Props) {+ const { page, previous, next } = await find(params);+ const { default: Content } = await import(`@/content/docs/${page.slug}.mdx`);+ return (+ <article>+ <h1 className="text-4xl font-semibold tracking-tighter text-balance text-neutral-50 md:text-5xl">{page.title}</h1>+ <Content />+ <nav aria-label="More docs" className="mt-16 flex justify-between gap-6 border-t border-neutral-800 pt-6 text-sm">+ {previous ? (+ <Link href={`/docs/${previous.slug}`} className="text-neutral-400 transition hover:text-neutral-100">+ ← {previous.title}+ </Link>+ ) : (+ <span />+ )}+ {next ? (+ <Link href={`/docs/${next.slug}`} className="text-right text-neutral-400 transition hover:text-neutral-100">+ {next.title} →+ </Link>+ ) : null}+ </nav>+ </article>+ );+}diff --git a/web/app/docs/docs-nav.tsx b/web/app/docs/docs-nav.tsxnew file mode 100644index 00000000..acc2a273--- /dev/null+++ b/web/app/docs/docs-nav.tsx@@ -0,0 +1,41 @@+"use client";++import Link from "next/link";+import { usePathname } from "next/navigation";+import { docSections } from "./pages";++// The manual's sidebar: sections of pages, the current one marked.+export default function DocsNav() {+ const path = usePathname();+ return (+ <nav aria-label="Docs" className="shrink-0 md:sticky md:top-24 md:w-56 md:self-start">+ <Link href="/docs" className="text-sm font-semibold text-neutral-50">+ Codync docs+ </Link>+ <div className="mt-5 grid grid-cols-2 gap-x-6 gap-y-6 md:grid-cols-1">+ {docSections.map((section) => (+ <div key={section.title}>+ <p className="text-xs font-medium tracking-wide text-neutral-500 uppercase">{section.title}</p>+ <ul className="mt-2 space-y-1">+ {section.pages.map((page) => {+ const href = `/docs/${page.slug}`;+ const current = path === href || path === `${href}/`;+ return (+ <li key={page.slug}>+ <Link+ href={href}+ aria-current={current ? "page" : undefined}+ className={`block py-1 text-sm transition ${current ? "text-neutral-50" : "text-neutral-400 hover:text-neutral-200"}`}+ >+ {page.title}+ </Link>+ </li>+ );+ })}+ </ul>+ </div>+ ))}+ </div>+ </nav>+ );+}diff --git a/web/app/docs/layout.tsx b/web/app/docs/layout.tsxnew file mode 100644index 00000000..f0d59e61--- /dev/null+++ b/web/app/docs/layout.tsx@@ -0,0 +1,16 @@+import { SiteFooter, SiteHeader } from "../components/site-chrome";+import DocsNav from "./docs-nav";++// Every manual page: the site's header and footer around a sidebar of pages and the page itself.+export default function DocsLayout({ children }: { children: React.ReactNode }) {+ return (+ <>+ <SiteHeader />+ <div className="mx-auto flex w-full max-w-6xl flex-1 flex-col gap-10 px-4 py-10 sm:px-6 md:flex-row md:gap-14 md:py-16">+ <DocsNav />+ <main className="min-w-0 flex-1">{children}</main>+ </div>+ <SiteFooter />+ </>+ );+}diff --git a/web/app/docs/page.tsx b/web/app/docs/page.tsxnew file mode 100644index 00000000..8048792e--- /dev/null+++ b/web/app/docs/page.tsx@@ -0,0 +1,38 @@+import type { Metadata } from "next";+import Link from "next/link";+import { docSections } from "./pages";++export const metadata: Metadata = {+ title: "Docs",+ description:+ "How Codync works and how to use it: bots, agents, conversations, group chats, routines, memory, connectors, remote access and privacy.",+ alternates: { canonical: "/docs" },+};++export default function DocsIndex() {+ return (+ <article>+ <h1 className="text-4xl font-semibold tracking-tighter text-neutral-50 md:text-5xl">Codync docs</h1>+ <p className="mt-5 max-w-[38rem] text-lg leading-relaxed text-neutral-400">+ Codync turns the coding agents on your computer into bots you message from your iPhone, your desktop or a+ terminal. This manual explains how bots work and how to set them up.+ </p>+ <div className="mt-12 grid gap-10 sm:grid-cols-2">+ {docSections.map((section) => (+ <section key={section.title}>+ <h2 className="text-xs font-medium tracking-wide text-neutral-500 uppercase">{section.title}</h2>+ <ul className="mt-3 space-y-2">+ {section.pages.map((page) => (+ <li key={page.slug}>+ <Link href={`/docs/${page.slug}`} className="text-neutral-200 underline-offset-4 transition hover:text-white hover:underline">+ {page.title}+ </Link>+ </li>+ ))}+ </ul>+ </section>+ ))}+ </div>+ </article>+ );+}diff --git a/web/app/docs/pages.ts b/web/app/docs/pages.tsnew file mode 100644index 00000000..bf39eb75--- /dev/null+++ b/web/app/docs/pages.ts@@ -0,0 +1,119 @@+// The user manual's pages, in sidebar order: each is content/docs/<slug>.mdx. The title is the page's heading,+// sidebar entry and tab title; the description is its meta description.+export type DocPage = { slug: string; title: string; description: string };++export const docSections: { title: string; pages: DocPage[] }[] = [+ {+ title: "Start",+ pages: [+ {+ slug: "getting-started",+ title: "Getting started",+ description: "Install Codync on your computer, pair your iPhone, create your first bot and send it a message.",+ },+ ],+ },+ {+ title: "Bots",+ pages: [+ {+ slug: "bots",+ title: "Bots",+ description: "What a Codync bot is, how to set one up, and how to organize, reset and delete bots.",+ },+ {+ slug: "agents",+ title: "Agents",+ description: "Which coding agents Codync runs, how it finds them, and how to install, sign in and pick models.",+ },+ {+ slug: "conversations",+ title: "Conversations",+ description:+ "Chatting with a bot: messages and files, approval cards, stopping, replies, reactions, commands, fresh conversations and notifications.",+ },+ {+ slug: "groups",+ title: "Group chats",+ description:+ "Put several bots in one chat. They answer in turn, read each other, and each works in its own session with its own tools.",+ },+ {+ slug: "teamwork",+ title: "Teamwork",+ description:+ "Bots can ask each other for help, hand work off, and, with Manage the team on, create and set up other bots.",+ },+ ],+ },+ {+ title: "What bots can do",+ pages: [+ {+ slug: "routines",+ title: "Routines",+ description:+ "Have a bot do work on a schedule or when a webhook arrives: set it up in the routine editor or by asking the bot.",+ },+ {+ slug: "memory",+ title: "Memory",+ description: "What a bot remembers about you across sessions, how it updates that memory, and what the apps show.",+ },+ {+ slug: "connectors-and-skills",+ title: "Connectors and skills",+ description:+ "Give your bots tools through MCP connectors and reusable instructions through skills, installed once on your computer and switched on per bot.",+ },+ {+ slug: "agent-fallbacks",+ title: "Agent fallbacks",+ description:+ "Give a bot a list of other agents that carry on its work when its own agent runs out of usage, is rate limited, signed out or won't start.",+ },+ {+ slug: "computer-use",+ title: "Computer use and remote screen",+ description: "See and control your computer's screen from your iPhone, and let bots use the apps on your computer.",+ },+ {+ slug: "voice",+ title: "Voice",+ description:+ "Talk to a bot in a hands-free voice call, or dictate into the message box, with on-device speech or OpenAI and Gemini on your own API key.",+ },+ ],+ },+ {+ title: "Your computer",+ pages: [+ {+ slug: "remote-access",+ title: "Remote access",+ description:+ "How your phone reaches your computer: directly over Wi-Fi, Tailscale or your own URL, or through the Codync relay, always end-to-end encrypted.",+ },+ {+ slug: "linux-servers",+ title: "Linux servers",+ description:+ "Run the Codync host on a headless Linux server or cloud VM, pair your phone with it, and reach it from anywhere.",+ },+ {+ slug: "updates",+ title: "Updates",+ description:+ "How the desktop app, the host and the iPhone app update, what happens when the phone and computer versions differ, and how to uninstall Codync.",+ },+ {+ slug: "privacy",+ title: "Privacy",+ description:+ "What stays on your computer, what the Codync relay and push service see, and how usage analytics work and how to turn them off.",+ },+ ],+ },+];++export const docPages: DocPage[] = docSections.flatMap((s) => s.pages);diff --git a/web/app/privacy/page.tsx b/web/app/privacy/page.tsxindex bf6ce6ce..8de27430 100644--- a/web/app/privacy/page.tsx+++ b/web/app/privacy/page.tsx@@ -18,7 +18,7 @@ export default function Privacy() {<Section title="What stays on your devices"><ul className="list-disc pl-5 space-y-2"><li><strong>Bots and conversations</strong> are stored by the Codync host on your computer (in <code>~/.codync</code>). Your phone keeps a cache so the app opens instantly.</li>- <li><strong>Your phone talks to your computer</strong> directly over your local network or Tailscale, or, away from home, through our relay, which only forwards end-to-end encrypted data it can't read.</li>+ <li><strong>Your phone talks to your computer</strong> directly over your local network or Tailscale, or, away from home, through our relay, which only forwards end-to-end encrypted data it can't read. A message you send while your computer is offline waits in the relay, still encrypted for your computer, for up to 24 hours, and is deleted once delivered.</li><li><strong>Agents run with your own logins</strong> (Claude Code, Codex, Cursor and others). Codync never sees or stores their credentials.</li><li><strong>Usage limits</strong> are read locally from the agents installed on your computer. Only percentages reach your phone.</li></ul>@@ -28,13 +28,17 @@ export default function Privacy() {To notify you when a bot needs you or finishes, your computer sends a short alert (the bot's name and a one-line preview) through our push relay, a Cloudflare Worker that forwards it to Apple Push Notification service (iPhone) or Firebase Cloud Messaging (Android). The alert is encrypted for your phone, so the relay and those services carry only generic text, and the relay does not store notifications. Your device token is encrypted into a ticket that only the relay can read; your computer never sees the raw token.</Section>+ <Section title="Routine webhooks">+ A routine can start when another service sends it a webhook at its public address on our relay. These deliveries are not end-to-end encrypted: the relay receives them over HTTPS, can read their content, and keeps each one until your computer collects it, for up to 72 hours. It also stores the routine's key to check signatures. With “Reach from anywhere” off, deliveries no longer reach your computer, but the relay still accepts them at the old public address and keeps them, readable, for up to 72 hours; they run if you turn it back on within that time. To stop them, remove the address from the sender, or delete the routine or replace its key while “Reach from anywhere” is on.+ </Section>+<Section title="Codync account (optional)">You can sign in with Apple or Google to find your computers from any phone. Your account keeps your email address, an account ID, and the names of the phones and computers you connect with it. Codync works without an account.</Section><Section title="Data we collect"><p className="mb-2">- Usage analytics, and, if you sign in, the account data described under Codync account. Analytics are on by default; turn them off on each phone and each computer in Settings (Share usage analytics), and that device stops sending right away.+ Usage analytics; the registration of each computer that uses our relay (its name, platform, device type, Codync version, public keys and when it was last online), with the public keys of the devices allowed to use it; and, if you sign in, the account data described under Codync account. Analytics are on by default; turn them off on each phone and each computer in Settings (Share usage analytics), and that device stops sending right away.</p><ul className="list-disc pl-5 space-y-2"><li><strong>What we record:</strong> which features you use, such as opening the app and its screens, setting up and pairing a device (and whether you allow notifications), creating or deleting a bot, sending a message (with the number of attachments, not the files), starting a routine or a voice call, and installing a connector from the catalog. Each event carries the app version, the platform and the agent and model a bot uses.</li>@@ -51,17 +55,17 @@ export default function Privacy() {<ul className="list-disc pl-5 space-y-2"><li><strong>Apple Push Notification service</strong>: delivers notifications and Live Activity updates on iPhone.</li><li><strong>Google Firebase Cloud Messaging</strong>: delivers notifications and live updates on Android.</li>- <li><strong>Cloudflare Workers</strong>: runs the push relay (nothing stored) and the Codync account service.</li>+ <li><strong>Cloudflare Workers</strong>: runs the push relay (nothing stored), the relay between your phone and your computer (computer registrations, messages waiting for an offline computer, webhook deliveries) and the Codync account service; its TURN service forwards a remote screen session's encrypted video when there's no direct path.</li><li><strong>Clerk</strong>: runs sign-in for the optional Codync account.</li><li><strong>PostHog (US)</strong>: stores the usage analytics described above, unless you turned them off.</li><li><strong>The AI agents you choose</strong>: they run on your computer under their own terms and privacy policies.</li>- <li><strong>OpenAI or Google (optional, voice calls)</strong>: only if you add your own OpenAI or Gemini API key in a call's settings. Your voice then goes from your phone or computer directly to that provider, under your account and its privacy policy, together with the bot's name and description and the chat messages it asks for during the call. The key is stored encrypted on your computer, which uses it only to start calls and list models. Without a key, voice calls use your device's own speech recognition.</li>+ <li><strong>OpenAI or Google (optional, voice)</strong>: only if you add your own OpenAI or Gemini API key for calls or dictation. In a realtime call, your voice goes from your phone or computer directly to that provider, together with the bot's name and description and the chat messages it asks for during the call. In a call's speech mode, and when you dictate a message with the provider, your recording goes to your computer, which sends it to the provider to be transcribed, together with the names of the bots on that computer as spelling hints, and sends the bot's replies to the provider to be read aloud. All of it is under your account and the provider's privacy policy. The key is stored encrypted on your computer and sent only to that provider, never to our relay or services; a realtime call gets a short-lived credential made from it. Without a key, voice uses your device's own speech recognition.</li></ul><p className="mt-2">This policy covers Codync as we publish it. Codync services run by third parties (for example a hosted host or relay) handle your data under their own privacy policies; we don't operate them and receive none of that data.</p></Section><Section title="Data retention">- Everything lives on your devices. Delete a bot to remove its conversation; uninstall the host and delete <code>~/.codync</code> to remove all of it. Deleting the phone app removes its cache. Turning analytics off stops new events from being sent.+ Your bots and conversations live on your devices. Our services keep only these: your account, if you sign in; each computer's registration, the devices allowed to use it and its routines' webhook keys, while the computer is registered; a log of account and access changes (30 days); messages waiting for an offline computer (up to 24 hours); and webhook deliveries waiting for it (up to 72 hours). Delete a bot to remove its conversation; uninstall the host and delete <code>~/.codync</code> to remove all of it. Deleting the phone app removes its cache. Turning analytics off stops new events from being sent.</Section><Section id="delete-account" title="Delete your Codync account">diff --git a/web/app/sitemap.ts b/web/app/sitemap.tsindex 046cd1a3..51abc567 100644--- a/web/app/sitemap.ts+++ b/web/app/sitemap.ts@@ -1,6 +1,7 @@import type { MetadataRoute } from "next";import { rivals } from "./compare/rivals";import { agentPages } from "./agents/agents";+import { docPages } from "./docs/pages";import { SITE } from "./site";export const dynamic = "force-static";@@ -13,6 +14,8 @@ export default function sitemap(): MetadataRoute.Sitemap {["/free-ai-agent-app", 0.9],...agentPages.map((a): [string, number] => [`/${a.slug}`, 0.8]),["/codync-mem", 0.7],+ ["/docs", 0.8],+ ...docPages.map((p): [string, number] => [`/docs/${p.slug}`, 0.6]),["/privacy", 0.2],["/terms", 0.2],];diff --git a/web/content/docs/agent-fallbacks.mdx b/web/content/docs/agent-fallbacks.mdxnew file mode 100644index 00000000..8e7ae60c--- /dev/null+++ b/web/content/docs/agent-fallbacks.mdx@@ -0,0 +1,82 @@+A bot runs on one agent, such as Claude Code. When that agent can't answer, because its usage ran out, it's rate limited or overloaded, it's signed out, or it won't start, the bot can carry on with the next agent in its list. The new agent continues the same turn in the same chat, with the bot's memory, workspace and tools. The bot goes back to its own agent once that one recovers.++Each fallback is another **agent** (for example Claude Code, then Codex, then Gemini CLI). To fall back between one agent's own models, set that in the agent itself (for example Claude Code's `fallbackModel`).++A bot has no fallbacks until you add them.++## Set up fallbacks++Fallbacks live in the bot's **Agent** card, under Model:++- **Desktop app:** click the bot's name at the top of the chat. The **Details** tab shows the Agent card.+- **iPhone:** tap the bot's name at the top of the chat, then **Details**. The Agent card is on the **Details** tab.+- **Terminal UI:** press `e` on the bot and go to the **Fallbacks** field.++In the desktop and iPhone apps:++1. Next to **Fallbacks**, press **+**.+2. In **Add fallback**, choose the **Agent** and its **Model**.+3. Add up to three. Use each row's ⋯ menu to **Move up**, **Move down** or **Remove**.++Each agent can appear once, and the bot's own agent isn't offered. The info button next to Fallbacks explains the feature.++In the terminal UI, ←/→ picks a fallback, space adds the next free agent or changes a fallback's model, `a` changes its agent, `[` and `]` move it, and `x` removes it.++Everything else stays the bot's own whichever agent is answering: its folder, approvals, connectors, skills, computer use and memory, and Fast mode where the fallback's agent has it.++> **Note:** A fallback that runs on an API key instead of a subscription costs money with that provider.++## When a bot moves on++Codync moves on only when the agent returns an error that says it can't answer. The agents retry on their own first, so Codync doesn't ask the same agent again. Each agent is tried at most once per turn.++The agent it leaves then rests: every bot on the computer skips it for a while, so one bot finding Claude Code out of usage spares the others from trying.++| The chat says the agent… | Bots skip it until |+| --- | --- |+| reached its usage limit | the reset time the agent reported (an hour if it gave none) |+| is out of credits | 6 hours have passed |+| is rate limited, or is overloaded | 1, 5, 25, then 60 minutes, growing with failures in a row |+| is signed out | it's signed in again (Codync also looks again after an hour, or after 10 minutes for an agent it doesn't know by name) |+| couldn't start | 5 minutes have passed |+| doesn't have this bot's model | you change the bot's settings (this one is about the bot's setup, so only this bot skips that step) |++A rest also ends early when any turn on that agent finishes normally. **Switch back** ends the rest of the bot's own agent.++These don't move a bot on: you stopping it, the agent refusing, output or step limits, a routine's time limit, or the agent compacting a full context.++Codex currently reports its rate limits and overloads as ordinary reply text, so for Codex only a usage limit moves the bot on.++## What the next agent knows++When a fallback takes a turn over, it hears what it needs before the turn's messages:++- If it hasn't worked in this chat before: a recap of the conversation (the latest summary, the most recent messages and any open plan).+- If it has: a catch-up of what was said since it last answered. Each agent keeps its own session, so coming back resumes it.+- If agents already failed during this turn: which one stopped and why, what each of them did (tool calls, messages, last note), and a reminder to check what's done before redoing any step.++**New session** (in the bot's menu) clears every agent's session, and none of them is told what was said before.++## What the chat shows++- **A switch:** one line where another agent took over, such as "Claude Code reached its usage limit (resets in 2 h). Codex carried on." Click or tap it to see what the new agent was told. In the terminal UI it's a `↪` line; press `o` to unfold it.+- **The way back:** "Back on Claude Code."+- **A signed-out agent:** moving past one also posts that agent's sign-in card. Its **Sign in** button opens the agent's sign-in sheet; once you're signed in, the bot goes back to that agent on its next message.+- **Every agent failed:** a failure notice says how each one is, for example "No agent in this bot's list could answer: Claude Code reached its usage limit (resets in 2 h); Codex …". If one of them was signed out, the turn's messages wait on its sign-in card and go out again once you sign in (messages older than 24 hours aren't resent).+- **No fallbacks yet:** when a bot without fallbacks stops because its agent ran out of usage, was rate limited or was overloaded, the notice offers **Add a fallback**, which opens the Agent card. In the terminal UI, pick the notice and press `A`.++The Agent card shows the state too. While the bot is on a fallback, its first row reads, for example, "Using Codex until Claude Code resets at 3:00 PM", with **Switch back**. The fallback in use is marked **In use**, and a resting agent shows "Usage resets 3:00 PM" or "Resting until 3:00 PM". In the terminal UI, the bot's Details page (`R`) shows the agent in use and the chain.++## Going back++Each turn starts on the first agent in the bot's list that isn't resting. So the bot returns to its own agent on its first turn after the reset, never in the middle of a turn. After you sign in to a signed-out agent, it returns on its next message.++To go back right away, press **Switch back** in the Agent card (`B` on the Details page in the terminal UI). It ends the rest of the bot's own agent and, if the bot is idle, moves it back now.++## Let the bot set its own fallbacks++You can ask a bot to set up its own chain, for example "if you run out of usage, carry on with Codex". It can see which agents are on the computer, whether each is signed in or resting, and their models, and it replaces its list with the one you asked for. A notice in its chat records each change, such as "Fallbacks set: Codex · gpt-5.5, Gemini CLI" or "Fallbacks removed".++The switch **Let the bot change its fallbacks**, under the list, controls this. It's on by default. In the terminal UI it's the **Bot edits** field.++A bot that manages the team can change any bot's fallbacks, and its own only while this switch is on. Either way, bots set agents and models only.diff --git a/web/content/docs/agents.mdx b/web/content/docs/agents.mdxnew file mode 100644index 00000000..d18d2868--- /dev/null+++ b/web/content/docs/agents.mdx@@ -0,0 +1,108 @@+Every bot runs one coding agent on your computer. Codync drives agents through the [Agent Client Protocol](https://agentclientprotocol.com) (ACP), so it can run any agent that speaks it: the ones it knows by name, everything in the official [ACP registry](https://agentclientprotocol.com/registry), and any command you give it. Each bot picks its own agent, and different bots can use different ones.++Codync uses the agents with the accounts they're already signed in to on your computer, such as Claude Code with your Claude plan or Codex with your ChatGPT plan. It never calls a provider's API with your login.++## Agents Codync knows by name++For these agents, Codync knows the command it looks for, how to install it and how to sign in. The agent must be installed on the computer before a bot can use it.++| Agent | Command Codync looks for | Sign in from a terminal |+| --- | --- | --- |+| Claude Code | `claude` | `claude auth login` |+| Codex | `codex` | `codex login --device-auth` |+| Cursor | `cursor-agent` or `agent` | `cursor-agent login` |+| Pi | `pi` | run `pi`, then type `/login` |+| oh-my-pi | `omp` | `omp login` |+| OpenCode | `opencode` | `opencode auth login` |+| Grok Build | `grok` | `grok login --device-auth` |+| Gemini CLI | `gemini` | run `gemini` and sign in with Google |+| GitHub Copilot | `copilot` | `copilot login` |+| Qwen Code | `qwen` | run `qwen`, then type `/auth` |+| Hermes Agent | `hermes` | `hermes acp --setup` to choose a provider and model |+| goose | `goose` | `goose configure` |+| Kimi Code | `kimi` | `kimi login` |+| Factory Droid | `droid` | run `droid` |+| Amp | `amp` | `amp login` |+| Kilo | `kilo` | `kilo auth login` |+| Cline | `cline` | `cline auth` |+| Auggie | `auggie` | `auggie login` |+| Mistral Vibe | `vibe-acp` or `vibe` | `vibe --setup` |+| Kiro CLI | `kiro-cli` | `kiro-cli login` |+| Devin | `devin` | `devin auth login` |+| Qoder CLI | `qodercli` | `qodercli login` |+| CodeBuddy Code | `codebuddy` or `cbc` | run `codebuddy` |+| MiniMax Code | `mcode` | `mcode login` |+| Junie | `junie` | run `junie` |+| Google Antigravity | `agy` | sign in from Codync with **Log in with Google** |+| Cortex Code | `cortex` | run `cortex` and set up a connection |+| Poolside | `pool` | `pool login` |++Signing in to Google Antigravity with `agy` in a terminal doesn't sign in the part Codync runs, so use the sign-in option in Codync's setup sheet for it.++Hermes Agent runs its own `hermes acp` mode, with the provider and model you pick in `hermes acp --setup`. On Windows, Codync also finds it in its install folders (`%LOCALAPPDATA%\hermes\bin`) without a `PATH` change. Hermes and Gemini CLI keep a memory of their own that every bot on them shares; see [Memory](/docs/memory#agents-with-a-memory-of-their-own).++## Other agents from the ACP registry++Codync also lists every other agent in the ACP registry, about 40 more. These need no install: Codync fetches one the first time a bot uses it, through `npx`, `uvx` or a build for your platform, which it keeps in `~/.codync/agents`. Codync refreshes its copy of the registry once a day.++Codync doesn't know these agents' own sign-in commands. If one needs an account, sign in to it on the computer first, or use a sign-in option the agent offers in its setup sheet.++## A custom command++To run an agent that isn't listed, open the bot's settings, set **Agent** to **Custom command** and type the command that starts it in ACP mode, such as `my-agent --acp`. Enter a model ID by hand if you need one.++## How Codync finds installed agents++The host looks for each agent's command on the same `PATH` your login shell uses, plus the usual install folders (Homebrew, `~/.local/bin`, nvm, bun, volta, asdf, mise, pnpm and others). When an installed agent has its own ACP mode, Codync runs it directly. Otherwise it runs the agent's ACP adapter from the registry.++Opening **Extensions** checks again, so an agent you installed or signed in to outside Codync shows up without restarting anything.++## Extensions: install and set up agents++Agents are set up from **Extensions**, which belongs to one computer:++- **Desktop:** **Extensions** at the bottom of the sidebar.+- **iPhone:** tap the account button at the top left of the Bots tab, open **Computers & settings**, and tap the **Extensions** button on the computer.+- **Terminal UI:** press `A`.++The **Agents** section shows each agent's status: **Installed**, **Not installed**, **Not signed in**, **Needs Node.js**, or **Sets up on first use** (registry agents). Select an agent to open its setup sheet. It walks through up to three steps.++### Install++For an agent Codync knows by name, **Install** runs the agent's official installer on the computer. Agents published only on npm (such as Gemini CLI, Cline, Auggie and Kilo) install with npm. The install runs in a terminal on the computer, and you watch it from the device you're on. Where Codync has no installer for your platform, the sheet tells you how to install the agent yourself.++### Node.js++Some agents run through an adapter that needs Node.js, such as Claude Code, Codex and Pi. If the computer has no Node.js, Extensions shows **Add Node.js** and those agents read **Needs Node.js**. Adding it downloads an official Node.js into `~/.codync/node`, used only by Codync's agents. Nothing outside `~/.codync` changes, and a Node.js you install yourself always comes first. On Linux distributions that use musl, such as Alpine, install Node.js yourself.++### Signing in++The **Sign in** step shows whether the agent is signed in on that computer, with **Check again** to ask again. If it isn't, the sheet lists the ways to sign in:++- **Sign in** (agents Codync knows by name): runs the agent's own sign-in command in a terminal on the computer. You type into it from your device, and links open on your device.+- **The agent's own options:** each agent advertises its methods. Some run in a terminal, some open a browser on the computer, and some ask for API keys.+- **Browser sign-in:** opens on the computer itself. If you're away from it, use [Remote screen](/docs/computer-use) to finish there.+- **API keys:** typed into a form and saved encrypted on that computer only. Codync gives them to the agent each time it starts, and the values never leave the computer. **Get a key** links to the provider's page, and **Remove saved keys** deletes them.++You can always sign in yourself in a terminal on the computer instead, using the commands in the table above. Sign in as the same user the host runs as.++For an agent Codync knows by name, the chat also tells you when it needs signing in: if the agent isn't signed in when you create the bot, or a turn fails because it signed out, the chat shows a card with **Sign in**. Once you've signed in, Codync sends your waiting message again. Other agents show their own error in the chat.++## Models and options++In the bot's settings, under **Agent**:++- **Model:** **Default** uses the agent's own default. The list shows the models the agent reports for the computer's sign-in; use the refresh button to load it again. If an agent doesn't report a model list, leave Default or type a model ID.+- **Model options:** some models have their own settings, such as reasoning effort, each with a row and its own Default.+- **Fast mode:** a switch shown when the agent offers it for the model. Claude Code and Codex do. You can also type `/fast` in the chat.++Changing the model starts a new agent session; the chat history stays. Switching the bot to a different agent starts it on that agent's default model.++## The agent for a new bot++There's no separate default-agent setting. A new bot gets Claude Code when Claude Code can run on the computer. Otherwise it gets the first agent Codync knows by name that can. A registry agent is never picked on its own. Change the agent in the bot's settings after you create it.++## When an agent runs out++A bot can have fallback agents that carry on the same turn when its own agent is out of usage, rate limited, signed out or won't start. See [Agent fallbacks](/docs/agent-fallbacks).+diff --git a/web/content/docs/bots.mdx b/web/content/docs/bots.mdxnew file mode 100644index 00000000..ad741ee7--- /dev/null+++ b/web/content/docs/bots.mdx@@ -0,0 +1,107 @@+A bot is a persistent, named teammate that lives on your computer. Each bot runs one coding agent, such as Claude Code or Codex, with its own name, avatar, standing instructions, folder and approval setting. It has one chat that never ends: you come back to the same bot for the same kind of work, the way you'd message a colleague.++You can make as many bots as you like, and they work at the same time. A reviewer, a fixer and a docs writer can each run a different agent in a different folder.++## How a bot runs++The host on your computer runs every bot. A bot's agent starts when you send it a message and keeps its session loaded between messages. After a while without use the agent stops; your next message starts it again and picks up the same session. Your apps only show the bot and send it your messages, so the bot keeps working when you close the app or put your phone away.++## Where to change a bot's settings++- **iPhone:** open the bot's chat and tap its name at the top. **Details** shows its instructions, agent, model and routines; **Settings** shows the rest. Changes save as you edit. You can also touch and hold the bot in the list and choose **Edit profile**.+- **Desktop:** click the bot's name at the top of the chat to open the details panel, with the tabs **Details**, **Memory** and **Settings**. Changes save as you edit. You can also right-click the bot in the sidebar and choose **Edit Profile…**+- **Terminal UI:** select the bot and press `e`. Press Ctrl+S to save, or Esc to drop your changes.++## Profile++- **Avatar:** a character shape and a color.+- **Name:** shown in the bot list, the chat and notifications. If you create a bot without a name, it's called "New Bot" until Codync names it after its first few conversations.+- **Standing instructions:** rules that always apply, such as "Reviews PRs. Never pushes without asking." Put task-specific requests in the chat instead. The bot gets your changes with its next message, and the conversation continues.++You can also ask a bot in its chat to rename itself or change its own instructions. It makes the same change as an edit in its settings, and the chat shows a notice such as "Instructions updated". A name you set, by hand or by asking, ends automatic naming.++## Agent and model++- **Agent:** the coding agent this bot runs, picked from the agents Codync finds on the computer. Choose **Custom command** to run any agent that speaks the Agent Client Protocol (ACP) by its command line. See [Agents](/docs/agents).+- **Model:** **Default** or one of the models the agent lists. Some models have their own options, such as reasoning effort, each with its own row.+- **Fast mode:** shown when the agent offers it for the model (Claude Code and Codex do). Faster replies for more usage.+- **Fallbacks:** other agents that carry on when this one runs out of usage or can't answer. See [Agent fallbacks](/docs/agent-fallbacks).++Changing the agent or the model starts a new agent session. The chat history stays.++## Workspace: its own folder or a project++The **Workspace** setting is the folder the bot starts in.++- **Personal workspace** (the default): a folder of its own inside Codync's data folder, `~/.codync/bots/`. It stays when you rename the bot, change its model, restart the computer or start a new session.+- **Choose project folder…**: an existing folder on the computer, such as a Git repository. The folder picker browses the computer's folders, wherever you are.++Either way, the bot can work in other folders when you ask it to. A workspace isn't a sandbox: the bot can reach whatever its agent's own permissions allow. Several bots working in the same project folder can get in each other's way, and Codync doesn't create separate Git worktrees for them.++Changing the folder starts a new agent session.++## Permissions: Ask me or Approve automatically++The **Permissions** setting decides what happens when the agent asks to run a command, change files or use another tool.++| Setting | What happens |+| --- | --- |+| **Ask me** | An approval card appears in the chat and your iPhone gets a "needs you" notification. The agent waits for your answer. |+| **Approve automatically** | Codync allows each request for you, choosing the agent's "allow once" option when it offers one. |++New bots start on **Approve automatically**. With either setting, your agent's own settings still apply: if Claude Code's permission rules block a tool, it stays blocked. In the terminal UI this field is called **Approvals** (Ask or Auto).++The same setting covers changes a bot makes to other bots with **Manage the team**: under Ask me, each change waits for your Allow.++How approval cards work: [Conversations](/docs/conversations#approval-cards).++## Activity++- **Notifications:** notify you when this bot finishes, fails or needs you. Turn it off to keep the bot quiet.+- **Use the computer:** let this bot see the screen and use the mouse and keyboard. The computer needs Computer access set up first. See [Computer use](/docs/computer-use).+- **Manage the team:** let this bot create bots and change any bot's setup, its own included. Bots it creates can do the same, with no more access than it has: they take its approval setting, connectors and skills, and never get computer use. Only you can turn this on, and it's off by default. See [Teamwork](/docs/teamwork).++## Connectors and skills++The **Connectors** and **Skills** sections list everything installed on the computer, each with a switch. A new bot starts with all of them on; turn off what a bot shouldn't use. A skill a bot writes for itself is on only for that bot until you turn it on for others. See [Connectors and skills](/docs/connectors-and-skills).++## Memory and routines++Each bot keeps a long-term memory across sessions, which you can read on its **Memory** tab. See [Memory](/docs/memory). Routines, which run a bot on a schedule or from a webhook, are on its **Details** tab. See [Routines](/docs/routines).++## Organizing your bots++- **Pin:** pinned bots stay at the top of the list. iPhone: touch and hold the bot. Desktop: right-click it. Terminal UI: `p`.+- **Order:** drag bots into the order you want. The computer keeps the order, so it's the same on every device. iPhone: touch and hold a bot, then drag it. Desktop: drag it, or select it and press Alt+Up or Alt+Down. Terminal UI: `J` and `K`.+- **Hide:** iPhone: touch and hold the bot, then **Hide from list**. Desktop: right-click it, then **Hide from sidebar**. A hidden bot sends no notifications. To bring it back:+ - **iPhone:** tap the account button at the top left of the Bots tab, open **Computers & settings**, and tap the eye button (**Unhide**) beside the bot under **Hidden bots**.+ - **Desktop:** open **Settings → General** and click the eye button (**Unhide**) beside the bot under **Hidden bots**.+ - **Terminal UI:** press Ctrl+K, type `unhide`, and pick **Unhide** followed by the bot's name.+- **Mark as read:** clears a bot's unread badge, from the same menus.++## New session++A bot's chat and its agent's session are two different things. The chat is the permanent record you scroll through. The session is the agent's working context: what the model currently remembers of the conversation.++**New session** starts the agent with a fresh context. The chat history stays where it is, and so do the bot's memory, settings and files. Use it when the agent's context has drifted, or before starting unrelated work.++- **iPhone:** tap the bot's name at the top of the chat, then **New session**.+- **Desktop:** right-click the bot in the sidebar, then **New session**.+- **Terminal UI:** press `S`.++Codync asks you to confirm first. A group chat has no session of its own, so it has no New session.++A new session also starts when you change the bot's agent, model or folder. Codync can also start a fresh conversation on its own when a long conversation needs one; the chat then shows a card with a summary you can edit or skip. See [Fresh conversations](/docs/conversations#fresh-conversations).++## Delete a bot++- **iPhone:** tap the bot's name at the top of the chat, then **Delete bot**, or touch and hold it in the list, then **Delete**.+- **Desktop:** right-click the bot in the sidebar, then **Delete**.+- **Terminal UI:** press `x`.++Confirm with **Delete bot and its conversation**. The bot's chat and settings go away and it leaves any group chats it was in. Files it changed on your computer stay as they are, and so does its personal workspace folder.++## Copy a bot's setup++On the iPhone details sheet or the desktop details panel, **Create template** shows the bot's settings as text you can copy, without its conversation.+diff --git a/web/content/docs/computer-use.mdx b/web/content/docs/computer-use.mdxnew file mode 100644index 00000000..dedf559a--- /dev/null+++ b/web/content/docs/computer-use.mdx@@ -0,0 +1,102 @@+Codync can do two things with your computer's screen:++- **Remote screen:** you see the screen on your iPhone and control it with touch and the keyboard.+- **Use the computer:** a bot opens apps, reads windows, clicks and types, the way you would.++Both run through **Codync Screen**, a small helper on the computer that the desktop app sets up. You can watch a bot work from your phone and take over at any time.++## Set up computer access++Permissions are granted on the computer itself. In the desktop app, open **Settings → Computer access**. It's also a step of the first setup (you can choose **Set up later**), and in the menu bar or tray menu under **Remote screen → Set up computer access…**.++- **macOS:** press **Enable Codync Screen**. If macOS asks, allow Codync to run in the background in Login Items. Then allow **Screen recording** and **Control apps**. In System Settings, look for **Codync Screen**; depending on your macOS version, control is listed under **Accessibility** or **Device Control and Data Access**. Come back to Codync after granting, and let the helper restart if asked.+- **Linux:** press **Choose screen and allow control**. The system's screen-sharing dialog asks you to pick a screen and allow mouse and keyboard access. If Codync Screen restarts, open Computer access again to share the screen once more.+- **Windows:** bots can use apps without extra permissions. Viewing the screen from your phone isn't available on Windows yet.++The iPhone app and the terminal UI show whether access is set up and point you to Computer access on the computer; they can't grant it.++### Turn remote screen on or off++Remote screen is on by default on macOS, and on Linux when a graphical session (Wayland or X11) is running. On a headless Linux server it stays off.++To change it, use the menu bar or tray menu on the computer: **Remote screen → Enable remote screen**. Only the computer itself can switch it on; a phone can't. Codync remembers your choice.++## View and control your screen from the iPhone++Open the screen in either of two ways:++- In a chat, tap the **Computer** button at the top right.+- In **Computers & settings**, tap the **Screen** button on the computer's row.++You have control right away, unless that chat's bot is using the computer at that moment (then you watch first, as described under "Watch a bot work" below). While you have control, bots can still look at the screen, but they can't act until you hand it back.++The buttons along the top:++| Button | What it does |+| --- | --- |+| **Close** | Ends the session and hands control back to the bots |+| **Rotate** | Turns the view, even with rotation lock on (it otherwise follows how you hold the phone) |+| **Keyboard** | Shows the keyboard, with a row of modifier keys |+| **Touch mode** | Switches between trackpad (drag to move the pointer) and direct (tap where you want to click) |+| **Clipboard** | **Send my clipboard** to the computer, or **Copy from computer** |+| **Fit screen** | Appears after you zoom in; zooms back out |+| **Displays** | Appears with more than one display; picks which one you see |+| **Take over** / **Hand back to bots** | Takes control from the bots, or gives it back |++If the computer allows viewing but not control, the screen says "View only" and points you to Computer access on the computer.++### How the screen travels++- Video and input go over WebRTC and stay encrypted between your phone and Codync Screen. The setup messages travel over the same end-to-end encrypted connection as your chats.+- On a direct connection (same Wi-Fi, or Tailscale), Codync uses no STUN or TURN server. On a Mac, the picture is encoded at up to 16 Mbps and 60 fps.+- Through the Codync relay, the stream may be forwarded by Cloudflare's TURN service, which passes along encrypted packets and never sees your screen's content. This needs the computer linked to a signed-in account; otherwise the phone asks you to sign in on the computer. Relayed sessions are encoded at up to 4 Mbps and 30 fps, even if a direct path turns up later.+- Revoking the phone's access or turning off remote screen stops the picture and input.++## Let a bot use the computer++Turn on **Use the computer** for the bot. It's off by default.++- **Desktop app and iPhone:** open the bot's details (click or tap the bot's name at the top of the chat) and find **Use the computer** under **Computer** on the **Details** tab.+- **Terminal UI:** press `e` on the bot and toggle **Use computer**. The form also shows whether computer access is ready.++On macOS and Linux, remote screen must be on for bots to use the computer. On Windows it's always available.++### What a bot can do++With Use the computer on, the bot gets tools to:++- list apps and windows, read what's in a window, and zoom into part of the screen+- open apps+- click, double-click, right-click, drag and scroll+- type text, press keys and shortcuts, set values in fields, and pick menu items+- type one of your saved sign-ins (see below)++On macOS, Windows, and Linux with X11 or Sway, the bot works on apps in the background: your pointer and the app in front stay yours. On macOS, windows on another Space can't be worked on in the background; the bot is told so and can act in the foreground instead.++Bots don't get tools to bring an app to the front, quit apps, read your clipboard, or drive a browser through its automation interface.++### The rules++- **One bot at a time.** Another bot that tries is told the computer is in use.+- **You come first.** While you've taken over from your phone, bots can only look until you hand back control.+- **Approvals still apply.** The bot's Permissions setting and your agent's own approval rules cover each action.++### Watch a bot work++While a bot uses the computer, the **Computer** button in its chat pulses. Tap it to watch: the screen shows "*Bot* is using the computer". Tap **Take over** to take control; from then on the bot can only look. Tap **Hand back to bots** when you're done.++### Platform notes++- **macOS:** bots use Codync Screen's Screen recording and control permissions, so macOS asks for nothing new.+- **Windows:** windows of apps running as administrator are out of reach. Typing saved sign-ins isn't available on Windows yet.+- **Linux with X11 or Sway:** the computer-use tools need libX11, libXi and libxkbcommon.+- **Linux with GNOME, KDE or another Wayland desktop:** bots get a simpler set of tools that take screenshots and click and type on screen positions, using the screen you shared in Computer access.+- **Linux remote screen:** Codync Screen needs glibc 2.39 or later, GStreamer 1.22 or later with the base, good and bad plugins, PipeWire, and xdg-desktop-portal. The install script, Homebrew and `codync-host update` put it next to the host.++## Saved sign-ins++When a bot needs to sign in to a website or app, it can ask you with a card in the chat. Enter **Username or email** and **Password or op:// reference**, then **Save**. You can also add them under **Extensions → Credentials → Sign-ins**.++The bot then types the sign-in into the page itself and never sees the password. Codync types only when the focused page belongs to that site (or one of its subdomains), or the front app has that name, and it types a password only into a password field. Sign-ins are encrypted on the computer like [connector credentials](/docs/connectors-and-skills).++Password prompts in a terminal (such as `sudo` or `ssh`) aren't covered.diff --git a/web/content/docs/connectors-and-skills.mdx b/web/content/docs/connectors-and-skills.mdxnew file mode 100644index 00000000..90d408bc--- /dev/null+++ b/web/content/docs/connectors-and-skills.mdx@@ -0,0 +1,109 @@+Connectors give your bots tools. Each one is an MCP server: GitHub, Linear, Notion, a database, or anything else that speaks the Model Context Protocol. Skills are written instructions a bot follows for a kind of task, such as a release checklist or a house style for reports.++You add both in **Extensions**. They install on the computer, so every bot on that computer can use them, and each bot can turn any of them off.++## Open Extensions++- **Desktop app:** click **Extensions** at the bottom of the sidebar.+- **iPhone:** tap the account button at the top left of the Bots tab, open **Computers & settings**, and tap the Extensions button on the computer's row.+- **Terminal UI:** press `A`, or pick "Extensions: agents, connectors, skills…" from the action list. Tab switches between Agents, Connectors and Skills.++The header names the computer everything installs on. Once you've added something, a count under it ("3 installed", **Connectors & skills**) opens your library, where you can sign in to a connector or remove one.++## Add a connector from the registry++The **Connectors** section starts with a short featured list, then pages through the official MCP Registry. Search by service name, or press **Load more connectors** to see more.++1. Pick a connector. The **Add connector** sheet opens.+2. If it can run more than one way, choose under **Runs**: hosted by the service, or on your computer as a package.+3. Fill in any **Setup** fields it asks for, such as an API key. Keys are saved on that computer only.+4. Press **Add**. Codync installs it, opens the service's sign-in page if it has one, and checks that the connector starts and lists its tools.++A connector with nothing to fill in starts installing as soon as you pick it.++Packages run with their own runtime, which must be installed on the computer: npm packages need Node.js (`npx`), PyPI packages need uv (`uvx`), container images need Docker, and NuGet packages need `dnx`. Codync installs the exact version the registry lists.++MCPB bundles and packages that serve HTTP locally aren't listed. Add those as a custom connector.++If the check fails because a key was wrong, type the correct key in the same sheet and press **Add** again: Codync replaces the connector it just saved with the new values. Pressing **Add** with nothing typed checks the saved connector again, for example after you finished signing in. You can also change a saved key later under **Extensions → Credentials → Saved connections**.++### Sign in to a hosted connector++Some hosted connectors ask you to sign in with your account on that service. The sign-in page opens right after you add it:++- On the iPhone, it opens in the system sign-in sheet.+- In the desktop app, it opens in your browser on the computer.++The tokens stay on the computer and are refreshed when they expire. Until someone signs in, bots don't get the connector, and your library shows a **Sign in** button for it.++Some services don't offer this kind of sign-in (GitHub is one). For those, add the server as a custom connector with its URL and a token header.++## Add a custom connector++Under **Make your own**, choose **Custom connector**, then one of:++- **Command:** a command line that starts an MCP server. It runs on the computer in the bot's project folder, and quotes work like in a shell. Put keys under **Environment**, one `KEY=value` per line.+- **URL:** a hosted MCP server. Add headers under **Headers**, one `Name: value` per line, or leave them empty if the service has you sign in.+- **Config:** paste an MCP config from a README or another app (Claude, Cursor, VS Code), such as an `mcpServers` block. Every server in it is added.++Everything you enter is saved on that computer only.++## Apps through Composio++Composio is in the featured connectors. Add it and sign in to your Composio account; no API key is needed. Your bots can then find and connect apps through Composio's own tools.++If you'd rather use a Composio consumer key, add `https://connect.composio.dev/mcp` as a custom connector with the header `x-consumer-api-key: ck_…`.++## When a bot asks you++A bot can search the registry and ask you to connect something. The request shows up as a card in the chat:++- **Connect a connector:** press **Connect**. The setup and sign-in open as if you'd picked it in Extensions. When it's done, the connector is turned on for that bot and the bot is told.+- **Provide a secret:** the card names the connector and the field the bot needs. Type the value (or a 1Password `op://` reference) and press **Connect**. The value goes to that connector, is saved on the computer, and never appears in the conversation or reaches the bot.++The cards themselves hold no credentials. You can answer them in the iPhone app, the desktop app, or the terminal UI (pick the card and press ↵). A request can be answered for 24 hours; after that, ask the bot for a new one.++## Where credentials are kept++- Keys, headers and sign-in tokens are encrypted in Codync's database on the computer. The encryption key is held by the system: Keychain on macOS, Credential Manager on Windows, and on Linux a Secret Service keyring (such as GNOME Keyring) that is unlocked in your user session.+- Codync never falls back to plain text. If the keyring is locked or missing, you get an error instead.+- Once unlocked, the key stays in the host's memory until the host stops. Locking the keyring afterwards doesn't remove it; stop the host to do that.+- Your phone sends values to the computer over its end-to-end encrypted connection. Lists in the apps show only whether a value is set.+- Bots reach connectors through Codync on the computer, which adds the saved values when the connector runs, so the values aren't handed to the agent. This isn't a sandbox: programs running as your user on that computer, including the agent's own shell commands, aren't kept away from them.+- Credentials don't sync between computers. A copy of Codync's data moved to another machine can't decrypt them, so back up the system keychain along with it.++**Extensions → Credentials** shows where values are stored, lets you replace a connection's saved values (they stay hidden), and connects 1Password: paste a service account token and use `op://vault/item/field` references in any credential field. Give that service account access to one dedicated vault only. The 1Password CLI must be installed on the computer.++## Turn connectors and skills on or off per bot++A connector or skill you add is turned on for every bot, and new bots start with all of them on (without a credential store, as on a [headless Linux server](/docs/linux-servers#limits-on-a-headless-server), new bots start with no connectors). To turn one off for a bot, open the bot's **Settings** tab:++- **Desktop app:** click the bot's name at the top of the chat, then **Settings**.+- **iPhone:** tap the bot's name at the top of the chat, then **Details**, then **Settings**.+- **Terminal UI:** press `e` on the bot, then use the **Connectors** and **Skills** fields (space toggles).++The bot picks up the change on its next turn, in the same conversation.++## Skills++A skill is a folder with a `SKILL.md` file: a name, a line saying when to use it, and the instructions. A bot with a skill on is told its name, its description and where its instructions are, so it can read them when a task calls for it.++- **Install one:** the **Skills** section of Extensions lists Anthropic's published skills. Press **Add**. Click any skill to read its instructions first.+- **Write your own:** under **Make your own**, choose **Your own skill** and fill in **Name**, **When to use it** and **Instructions**.+- **Let a bot write one:** ask a bot to save how it did something as a skill. A bot may also save one on its own after working out a task you're likely to want again. The chat shows "Saved the skill …" or "Updated the skill …". A skill a bot writes is on for that bot only; turn it on for other bots in their settings. A bot can change only the skills it wrote, and you can remove any skill from your library.++### Use a skill with a slash command++Type `/` at the start of a message to see that bot's commands: built-in ones first (such as `/fast` for [Fast mode](/docs/agents), when the bot's agent offers it), then the skills the bot has on. Picking a skill fills in `/<skill id>`; write the rest of your message and send it. The bot is told to read that skill first.++- **Desktop app:** the list floats above the message box. Use ↑ and ↓, then Tab or Return. Escape hides it.+- **iPhone:** the list sits above the message box. Tap a command.+- **Terminal UI:** the list appears over the transcript. Use ↑ and ↓, then Tab or ↵.++Any other `/command` goes to the agent as you typed it, so your agent's own commands keep working. In a [group chat](/docs/groups), the list shows every member's skills, and a skill message reaches each member that has it on.++## Automatic updates++Connectors installed from the registry as packages follow their upstream releases. Codync checks the registry from time to time and again just before the connector starts. When a newer version is published, it switches to it: a running connector keeps going, and the new version applies the next time it starts. If the check fails, the installed version stays, and Codync never moves a connector to an older version.++Custom connectors are never updated automatically.diff --git a/web/content/docs/conversations.mdx b/web/content/docs/conversations.mdxnew file mode 100644index 00000000..c8d147fa--- /dev/null+++ b/web/content/docs/conversations.mdx@@ -0,0 +1,147 @@+Each bot has one chat that keeps going. You send it work, it replies, and everything stays in the same place on every device. This page covers what you can do in a bot's chat. For chats with several bots, see [Group chats](/docs/groups).++## What the chat shows++The chat shows your messages, the bot's messages, approval cards and short notices. A bot's message arrives complete; nothing streams in word by word. A bot can send several messages in one turn.++While the bot works, a line under the last message shows what it's doing and for how long. It reads **Typing…** while the bot writes you a message.++Everything else the agent did (its narration, thinking, tool calls, diffs and plans) is in **Full conversation**:++- **iPhone:** tap the bot's name at the top of the chat, then **Full conversation**. Or touch and hold a bot message, then **Show what it did**.+- **Desktop:** hover a bot message and choose **More message actions**, then **Show what it did**, or right-click the message.+- **Terminal UI:** `t` opens the trace pane, `T` opens it full screen, and `o` shows the last turn's steps.++## Sending messages++Type in the box at the bottom and send.++- **Desktop:** Return sends. Shift-Return or Option/Alt-Return starts a new line.+- **iPhone:** tap the send button. With a hardware keyboard, Return starts a new line and Cmd-Return sends.+- **Terminal UI:** press `i` or Enter to start typing, Enter to send, and Shift-Enter, Alt-Enter or Ctrl+J for a new line.++Each chat keeps its own draft on each device, and the draft comes back when you return to the chat or reopen the app. Drafts aren't synced between devices.++**While the bot works**, the box reads "Queue a message for" followed by the bot's name. Messages you send then show **Queued until this response finishes**, and they reach the agent together as its next turn.++**When the computer is offline**, the iPhone can still take a text message: it shows **Waiting for the computer to come online** and goes out when the computer is back. It waits in the Codync relay, encrypted for your computer, for up to 24 hours; after that it shows **Failed to send**. Tap the cancel button beside it to take it back. A message with files can't wait; its send button stays off until the computer is online.++If a message fails to send, it shows **Failed to send** with buttons to resend or delete it.++## Files++Use the **+** button left of the message box.++- **iPhone:** **Photos**, **Files**, or **Paste** when the clipboard holds an image. Photos are sent as JPEG.+- **Desktop:** pick files, drop them on the box, or paste a copied image or file with Cmd+V (Ctrl+V on Windows and Linux).+- **Terminal UI:** drag a file onto the terminal to paste its path. Backspace in an empty box removes the last file.++A message can be files only. Each file can be up to 100 MB. The files are saved on the computer, in an `uploads` folder in the bot's personal workspace, or in Codync's data folder for a bot that works in a project folder. The agent gets your message with the path of each file and reads them with its own tools.++Bots can send files back when you ask, such as a report or a build. Each one shows as a card with its name and size and a download action:++- **Desktop:** saves through the system Save dialog.+- **iPhone:** opens the share sheet, including Save to Files.+- **Terminal UI:** pick the message (`v`), then `f` saves it to Downloads.++Codync keeps its own copy of each shared file, so it stays downloadable even if the bot later changes or deletes the original. Bots share files only in their own chat, not in group chats or routine runs.++## Approval cards++When a bot's **Permissions** setting is **Ask me** and its agent wants to run a command, change files or use another tool, an approval card appears in the chat. It says what the agent wants ("Wants to run a command", "Wants to change files"…), the computer and folder it runs in, and **Details** with the command or the diff.++The answers come from the agent, usually:++| Answer | Meaning |+| --- | --- |+| **Allow once** | Allow this request. |+| **Always allow** | Allow it and requests like it, as the agent defines that. |+| **Deny** | Refuse this request. |+| **Never** | Refuse it and requests like it, as the agent defines that. |++In the terminal UI, press `y` to allow once, `a` to always allow, `n` to reject, `N` to reject and say why, or `1`…`9` to pick an option.++The agent waits for your answer. If the turn ends before you answer, for example because you stopped it, the card reads **Expired — the agent moved on**.++With **Approve automatically**, no cards appear: Codync allows each request for you. Your agent's own permission rules still apply under either setting. To change the setting, see [Bots](/docs/bots#permissions-ask-me-or-approve-automatically).++## Stopping a turn++- **Desktop and iPhone:** while the bot works and the box is empty, the send button turns into **Stop**.+- **Desktop menu bar or tray menu:** the bot's submenu has **Stop task**.+- **Terminal UI:** press Esc to leave typing, then `s`.++Stop ends the running turn and drops the messages still queued for it, which then read **Not sent — stopped**. The chat shows "Stopped." and no notification is sent.++## Replying to a message++You can reply to any of your messages or any message from the bot. The reply goes in the chat in time order and shows a quote of the message it answers at the top.++- **iPhone:** touch and hold the message, then **Reply**.+- **Desktop:** hover the message and click **Reply**, or right-click it.+- **Terminal UI:** press `r`, move to the message with `j` and `k`, then Enter or `r`. Esc cancels.++While you reply, the box shows the quote above it and reads "Reply…". The bot gets the quoted text with your reply, so it knows what you mean even when that message is from an earlier session.++## Reactions++- **iPhone:** touch and hold a message; the reactions are at the top of the menu.+- **Desktop:** hover a message and click **Add reaction**, or right-click it.+- **Terminal UI:** pick a message (`v`), then `1`…`6`.++The quick reactions are 👍 ❤️ 😂 🎉 👀 ✅. Tap your reaction again to take it back. In a bot's own chat, the bot isn't told about your reactions. Bots react now and then too, and their reactions show with their avatars.++## Commands++Type `/` at the start of a message to see the bot's commands:++- `/fast`: turns [Fast mode](/docs/agents#models-and-options) on or off, when the bot's agent offers it.+- `/` followed by a skill's ID: tells the bot to read that skill first and follow it for this message. The bot's skills are listed after the built-in commands.++Any other `/command` goes to the agent unchanged, so the agent's own commands keep working. New session isn't a command; it's in the bot's menu. See [Bots](/docs/bots#new-session).++## Fresh conversations++When a conversation in a bot's own chat has grown long, Codync may start the agent over with a summary instead of carrying all of it. The chat then shows a card saying why: the conversation is long and has gone quiet, you've been away a while after several summaries, or summarizing no longer frees enough room. Your next message starts the fresh conversation.++**What it carries** unfolds to what the new conversation begins with: the latest summary of the conversation, your last four messages word for word, the bot's last reply and its open plan. The bot can still search the earlier chat. The chat, memory, settings and files stay as they are.++Before your next message, you can:++- **Edit what it carries** (the pencil): change the text in **Edit the handoff** and save.+- **Keep this conversation:** the bot carries on in the same conversation.+- **Terminal UI:** pick the card (`v`), then `o` to show what it carries, `e` to edit it, or `K` to keep the conversation.++Afterwards the card folds into one line that unfolds to what was carried.++## Notifications++Your iPhone gets a notification when a bot:++| Kind | When | Action |+| --- | --- | --- |+| **Response needed** | It's waiting for you, such as on an approval card. | **Review request** |+| **Task complete** | It finished. Sent once, after its last queued message is answered. The text is an excerpt of its final reply. | **Open conversation** |+| **Task failed** | It hit an error or stopped short. | **Open conversation** |++You don't get one when:++- the Codync app on your iPhone is open and connected to the computer,+- the bot's **Notifications** switch is off, or the bot is hidden,+- you stopped the turn yourself.++Routine runs notify you too. A group chat sends one "done" once its bots have finished answering your message.++To turn notifications off on the iPhone, open **Computers & settings** from the account button at the top left of the Bots tab and switch off **Push notifications**. Previews, sounds and Focus follow your iOS settings. The push relay and Apple see only a generic line ("Your task is complete. Open Codync to read the result.") plus routing IDs. The bot's name and the message text are encrypted to your iPhone's key and decrypted on the phone. See [Privacy](/docs/privacy).++### Live Activities++When you send a message from the iPhone, a Live Activity for that bot appears on the Lock Screen and in the Dynamic Island. It shows whether the bot is working, needs you, is done or failed, without the message text. On the Lock Screen, a progress line of four segments in the state's color fills as the task moves: one while your message is sent or queued, two while the bot works, three when it needs you, four once it ends. Turn it off in the **State** tab under **Live Activity**.++## Usage limits++Codync reads usage limits for Claude Code and Codex from their installs on your computer, without signing in anywhere else. To see them:++- **iPhone:** the **State** tab, then **Usage limits**. There's also a Usage widget.+- **Desktop:** the menu bar or tray menu, or **Usage** in the account menu at the bottom of the sidebar.+- **Terminal UI:** press `U`.diff --git a/web/content/docs/getting-started.mdx b/web/content/docs/getting-started.mdxnew file mode 100644index 00000000..b8e27168--- /dev/null+++ b/web/content/docs/getting-started.mdx@@ -0,0 +1,117 @@+Codync has two parts. The **host** (`codync-host`) is a small background service on the computer where your coding agents are installed. It runs the agents and keeps every bot's chat. The **apps** (iPhone, desktop, terminal UI) are windows onto that host. You install Codync on your computer once, pair your phone, and create a bot.++## What you need++- A Mac (Apple silicon or Intel), a Windows PC (x64), or a Linux machine (x86_64 or arm64).+- At least one coding agent on that computer, such as Claude Code or Codex. You can also install one from Codync later. See [Agents](/docs/agents).+- Optional: an iPhone with iOS 18 or later. You can also use only the desktop app or the terminal UI.++Codync is free and open source (Apache-2.0). You pay only your agent's provider, through the plan or key you already use.++## 1. Install Codync on your computer++### macOS++Download [codync-macos.dmg](https://github.com/leepokai/Codync/releases/latest/download/codync-macos.dmg) and drag Codync to Applications. Or install it with Homebrew:++```bash+brew install --cask leepokai/codync/codync+```++Open Codync. The app includes the host and sets it up as a background service the first time it runs. Codync then lives in the menu bar; **Open Codync** opens the chat window.++### Windows++Download [codync-windows-x64.exe](https://github.com/leepokai/Codync/releases/latest/download/codync-windows-x64.exe) and run it. It installs for your user only, and the host starts each time you sign in to Windows. The installer isn't code-signed yet, so SmartScreen asks you to confirm once: choose **More info**, then **Run anyway**.++Codync shows a tray icon. Left-click it to open the chat window, right-click it for the menu. Remote screen isn't available on Windows yet.++### Linux++Run the installer in a terminal:++```bash+curl -fsSL https://raw.githubusercontent.com/leepokai/Codync/main/packaging/install.sh | sh+codync-host install+```++The script installs `codync-host` and, when you run it in a graphical session, the desktop app (`codync`, an AppImage with a menu entry). `codync-host install` runs the host as a systemd user service. Opening the desktop app also does this for you.++You can also install the host with Homebrew (`brew install leepokai/codync/codync-host`), or download the AppImage, `.deb` or `.tar.gz` from [GitHub Releases](https://github.com/leepokai/Codync/releases/latest). On Linux the desktop app doesn't include the host, so install the host too. AppImages need FUSE 2 to start (on Ubuntu: `sudo apt install libfuse2t64`).++### The first launch of the desktop app++The app first asks about an account. Signing in with Apple or Google is optional. Choose **Continue on this Mac** (or **Continue on this computer**) to go on without one. It then offers **Computer access**, which bots need only to use the screen; choose **Set up later** to skip it. See [Computer use](/docs/computer-use).++## Running only the host++For a computer without the desktop app, such as a headless Mac or a server, install the host on its own:++```bash+curl -fsSL https://raw.githubusercontent.com/leepokai/Codync/main/packaging/install.sh | sh -s -- --host-only+# or: brew install leepokai/codync/codync-host+codync-host install+codync-host status+```++`codync-host install` runs the host as a background service (launchd on macOS, systemd on Linux). Re-run the installer to upgrade. To chat from that machine's terminal, run `codync-host tui`. For servers and cloud VMs, see [Linux servers](/docs/linux-servers).++## 2. Install the iPhone app++Get [Codync on the App Store](https://apps.apple.com/app/codync/id6760984418). It's free and needs iOS 18 or later.++Every iPhone release goes through Apple's App Review first, so the App Store version can trail the computer apps. Your computer waits to install an update that needs a newer iPhone app until that version is in the App Store. See [Updates](/docs/updates).++## 3. Pair your iPhone++Pairing connects your phone to your computer with a QR code. No account is needed.++On the computer, show the pairing code:++- **macOS:** click Codync in the menu bar, then **Pair iPhone…**+- **Windows and Linux:** open the tray menu, then **Pair iPhone…**+- **Any desktop app:** Settings → Computers, then the **Pair iPhone** button on the computer.+- **Terminal:** run `codync-host pair`, or press `P` in the terminal UI.++On the iPhone, open Codync and tap **Get started**, then **Continue**, then scan the code. The iPhone Camera app can scan it too. If you can't scan, copy the pairing link on the computer and paste it into the field under the viewfinder. To pair later, tap the account button at the top left of the Bots tab, then **Scan a computer's code**.++A pairing code expires. If pairing fails, show a new code on the computer and scan again.++After pairing, the phone connects directly when it's on the same Wi-Fi or Tailscale network as the computer. Anywhere else it goes through the Codync relay, end-to-end encrypted, while **Reach from anywhere** is on in the computer's Codync settings. See [Remote access](/docs/remote-access).++If you signed in to the same account on the computer and the phone, the phone can also ask the computer for access instead of scanning. The computer then shows the request and a code for you to check. See [Remote access](/docs/remote-access).++## 4. Create your first bot++- **iPhone:** on the Bots tab, tap **+**, then **New bot** (or **Create your first bot** when the list is empty).+- **Desktop:** click **+** at the top of the sidebar, then **New bot**, or press Cmd+N (Ctrl+N on Windows and Linux).+- **Terminal UI:** press `n`.++Pick an avatar and type a name, then create it. The name is optional: a bot without one is called "New Bot" until Codync names it after its first few conversations.++A new bot starts with these defaults, which you can change in its settings:++- **Agent:** Claude Code when it can run on the computer, otherwise the first agent Codync knows that can.+- **Workspace:** a personal folder of its own.+- **Permissions:** Approve automatically.+- **Notifications:** on.+- **Connectors and skills:** every one installed on the computer is turned on (connectors only when the computer's credential store is available; see [Linux servers](/docs/linux-servers#limits-on-a-headless-server)).++> **Note:** New bots approve the agent's tool requests automatically. Your agent's own permission rules still apply. To review each request first, open the bot's settings and set **Permissions** to **Ask me**. See [Bots](/docs/bots#permissions-ask-me-or-approve-automatically).++If the bot's agent isn't signed in, the chat shows a card saying it needs you to sign in before your first message. Tap **Sign in** and follow the steps. See [Agents](/docs/agents#signing-in).++## 5. Send it a message++Open the bot and type in the box at the bottom. It says "Ask" followed by the bot's name. Press Return on the desktop, tap the send button on the iPhone, or press Enter in the terminal UI.++While the bot works, a line under the last message shows what it's doing and for how long. Its reply arrives as a complete message. If it asks for approval, an approval card appears in the chat. Every tool call and step is one tap away in **Full conversation**.++When the bot finishes or needs you, your iPhone gets a notification, unless the Codync app is open on it. See [Conversations](/docs/conversations).++## Next steps++- [Bots](/docs/bots): set up a bot's agent, folder, approvals and more.+- [Agents](/docs/agents): install and sign in to more coding agents.+- [Conversations](/docs/conversations): files, approvals, replies and notifications.+- [Group chats](/docs/groups): put several bots in one room.diff --git a/web/content/docs/groups.mdx b/web/content/docs/groups.mdxnew file mode 100644index 00000000..3127c31d--- /dev/null+++ b/web/content/docs/groups.mdx@@ -0,0 +1,84 @@+A group chat puts several of your bots and you in one conversation. Each member answers in turn, reads what the others said, and does its work with its own agent, folder, tools and approval setting. Use a group when you want bots to discuss a problem, review each other's work, or split a task while you watch.++A group has no agent, folder or session of its own. It's a room for bots you already have.++## Create a group++- **iPhone:** on the Bots screen, tap **+** and choose **New group chat**.+- **Desktop:** click **+** above your bots and choose **New group chat**.+- **Terminal UI:** press `m`.++Pick the bots to add, type a name if you like, and choose **Create**. Without a name, the group is named after its members ("Alice, Bob").++- A group needs at least one bot.+- A group can't contain another group.+- If a group with exactly the same bots already exists, you get that group instead of a second one.++## Edit, remove members, delete++Open the group's settings to change it:++- **iPhone:** tap the group's name at the top of the chat and choose **Edit group**.+- **Desktop:** click the group's name at the top of the chat. The details panel lists the members, with **Add Member** and an X to remove each one.+- **Terminal UI:** select the group and press `e`.++In the editor you can rename the group, add or remove members, and fill in **What this group works on**. Every member reads that line, so use it to say what the room is for.++**Delete group chat** removes the group and its conversation. Its bots stay. If you delete a bot, it leaves every group it was in.++## Who answers++When you send a message, the group runs a round of answers:++1. **Who's asked.** The members you @-mentioned, or whose message you replied to, since your last message. If you mention nobody, or write `@all` or `@everyone`, every member is asked.+2. **One at a time.** Members answer in order, each after the previous one finished, so each can read the replies before its own. Each round starts with a different member, so the same bot doesn't always go first.+3. **Passing.** A member with nothing new to add passes, and nothing appears in the chat. A member can also react to a message and pass, to agree without writing.+4. **More rounds.** If anyone spoke, another round follows, so members can answer each other. A member that @-mentions another brings it into the next round.+5. **The end.** The exchange stops after three rounds, ten replies in all, or a round where every member passes.++Each member's reply is the one message the room sees. Its tool calls, thoughts and approval cards for that turn appear in the group. The member's own chat doesn't show them. Open **Full conversation** to see its steps.++### @-mentions++To ask just one bot, mention it: its full name, its name without spaces, or its first word all work, in any letter case. On the desktop and iPhone, typing `@` in a group suggests its members.++Replying to a member's message counts as mentioning it. To reply, long-press the message on iPhone, use **Reply** below the message on the desktop, or press `r` in the terminal UI.++### Reactions and files++You can react to messages in a group. Members see your reactions on the messages they're shown, and they can react too.++Files you attach in a group are available to every member.++## A busy member answers later++A member may be working somewhere else when the group asks it, for example in its own chat or in another group. The room doesn't wait. It shows:++> Alice is busy in another chat and will answer here when it's done.++and moves on to the next member. When Alice finishes her other work, she answers in the group, after reading what the room said in the meantime. She isn't asked again in later rounds of that exchange.++Her late answer is dropped if you press Stop in the group, remove her from the group, or send a newer message that asks her again (the newer one replaces it). Other new messages in the group, and Stop in Alice's own chat, don't drop it.++If a member fails while answering, the room counts it as a pass and shows the error.++## Stop++Press **Stop** in the group (the send button turns into Stop while members work; `s` in the terminal UI). It ends the current exchange and stops members working in the group.++Sending a new message also ends the running exchange before the next member is asked, and starts a new one with your message.++## What each member remembers++- **One session per bot.** A member answers in the group in the same session as its own chat. It remembers the group conversation when you talk to it one-on-one later, and the other way round. Starting a [new session](/docs/bots#new-session) in a bot's chat also gives it a fresh start in its groups.+- **What it's shown.** On each turn, a member reads the room's messages since it last spoke there, the most recent ones if there are many, plus who's in the room and what the group is for.+- **Private chats.** Members are told not to reveal what you discussed with them one-on-one. That's only an instruction to the agent: the same session holds both conversations.+- **Long-term memory.** In a group, a bot can add to its [memory](/docs/memory) but can't change or remove what's there. Group chats don't feed dreaming, and a bot's history search covers only its own chat.++## Notifications++You get one "done" notification per exchange, from the last member that replied ("Alice in Ship room"), plus one for each late answer. When a member needs your approval, its card appears in the group and you get a "needs you" notification that opens the group.++Voice calls work in groups too: each reply is read with its speaker's name. See [Voice](/docs/voice).++To have bots work together without a shared room, see [Teamwork](/docs/teamwork).diff --git a/web/content/docs/linux-servers.mdx b/web/content/docs/linux-servers.mdxnew file mode 100644index 00000000..5c31a8d8--- /dev/null+++ b/web/content/docs/linux-servers.mdx@@ -0,0 +1,111 @@+The host, `codync-host`, runs on any 64-bit Linux machine, including a home server or a headless cloud VM. It needs no display. Your bots run on that machine, and you message them from the iPhone, from the desktop app on another computer over SSH, or from the terminal UI.++## Requirements++| You need | Why |+| --- | --- |+| x86_64 or arm64 Linux | Release builds exist for both. The distribution doesn't matter: the host is a static binary. |+| `ca-certificates` | For HTTPS. Normal VM images have it. Bare container images need `apt-get install ca-certificates`; without it every command stops with `TLS setup failed: install the ca-certificates package`. |+| systemd | Only for running the host as a background service. Without systemd, run `codync-host serve` under your own supervisor. |+| Node.js (optional) | Claude Code, Codex and Pi run through adapters started with `npx`. Without Node, an agent's setup offers to add Codync's own copy (on glibc distributions; over SSH, run `codync-host node`). On musl distributions such as Alpine, install Node.js yourself. |+| Your agents, signed in | The host runs the agent CLIs installed on this machine with their own logins. Sign in over SSH (`claude`, `codex login`, …) as the same user that runs the host. |++## Install++Run these as the user who owns the agents (not root, unless the agents are root's):++```sh+curl -fsSL https://raw.githubusercontent.com/leepokai/Codync/main/packaging/install.sh | sh -s -- --host-only+# or: brew install leepokai/codync/codync-host+codync-host install # background service; restarts after a crash+sudo loginctl enable-linger "$USER" # keeps it running after you log out of SSH+codync-host status+```++- The script puts `codync-host` in `~/.local/bin` (`/usr/local/bin` as root; set `CODYNC_BIN_DIR` to choose), checks its checksum, and restarts the service when you run it again to upgrade.+- `codync-host install` sets up a systemd user service and saves your current `PATH` into it, so install Node and your agents first. If you add an agent later and the host doesn't find it, run `codync-host install` again.+- Run `codync-host install` from a real login session (an SSH login, not `sudo su user`), or systemd can't reach your user's services.++`--host-only` also works on a Mac without a display.++### Everyday commands++| Command | What it does |+| --- | --- |+| `codync-host status` | Whether the service is installed and running |+| `codync-host pair` | Shows a pairing QR code |+| `codync-host tui` | Opens the terminal UI |+| `codync-host stop` | Stops the service and keeps its setup and data |+| `codync-host uninstall` | Removes the service and keeps your data in `~/.codync` |+| `journalctl --user -u codync-host -f` | Follows the host's log |++## Pair your phone++With the host running, run `codync-host pair` over SSH. It prints a QR code in your terminal. On the iPhone, scan it from the welcome screen or from **Computers & settings → Pair a computer**. If scanning a terminal QR code is awkward, run `codync-host pair --json` and paste the `codync://pair` link into the field under the scanner.++The code works once and expires after 10 minutes. More about pairing and accounts: [Remote access](/docs/remote-access).++## Use the terminal UI++The simplest way is to SSH into the server and run `codync-host tui` there.++To run the terminal UI on your own machine instead, forward the server's port and pass the server's token. The host's API answers only local callers, which the tunnel makes you:++```sh+ssh -N -L 19333:127.0.0.1:19222 your-server &+CODYNC_TOKEN=$(ssh your-server 'cat ~/.codync/token') codync-host tui --url http://127.0.0.1:19333+```++## Use the desktop app over SSH++The desktop app on a Mac or Linux desktop can run the server's bots alongside its own. Open **Settings → Computers**, and under **Over SSH** choose **Add SSH computer**. Fill in the host (an SSH alias or hostname) and, if your SSH config doesn't already set them, the user, port and key. Sign-in must work with a key or ssh-agent: nothing prompts for a password. On the first connection, compare the host key fingerprint with the server's, then choose **Trust and connect**.++From that computer's card you can also show its pairing code, turn the relay on or off, and choose **Add to account** to put the server in your Codync account.++The desktop app on Windows doesn't connect to SSH computers.++## Reach it from your phone++You have three options, and you can combine them:++- **Codync relay (on by default).** The host connects out to the relay, so the phone reaches the server from anywhere with nothing to open or configure.+- **Tailscale (recommended for a direct connection).** Install Tailscale on the server and on the phone, then pair. The pairing code includes the server's Tailscale address. You don't need to open any port in the cloud firewall.+- **Your own HTTPS reverse proxy.** Forward only `/channel` to the host and set `CODYNC_EXTERNAL_URL` with a systemd drop-in. Follow the steps and security rules in [Remote access](/docs/remote-access) exactly.++The pairing code lists only Tailscale and private network addresses, plus any URL you set yourself. The host never advertises the server's public IP.++To keep the server off the relay, run `codync-host cloud --disable`. The phone then needs Tailscale, a private network or your own URL, and devices approved through your account can't connect.++## Firewall++The host listens on port 19222 on every interface. Its API (the one apps on the same computer and SSH tunnels use) answers only callers on the server itself, so a public address doesn't expose it. From the network, the host answers only:++- the end-to-end encrypted channel, which serves only devices you paired or approved;+- a health check that reports the host's version, environment and identifiers (its install path and whether a bot is working are reported only to callers on the server itself);+- local routine webhooks, which need the routine's key.++Keep port 19222 closed in your cloud firewall anyway, unless you deliberately connect over a VPN or private network. Tailscale and the relay don't need it open.++## Approve and manage devices without a desktop app++If the server is in your account, phones ask for access with a 6-digit code. Approve them on the server:++```sh+codync-host access # pending requests, with each device's code+codync-host access approve 123456 # by the code the phone shows, or the request id+codync-host access deny 123456+codync-host devices # devices that can use this computer+codync-host devices revoke <key> # removes one; it disconnects at once+```++## Limits on a headless server++- **Remote screen and computer use need a desktop session.** They turn on only while a graphical session (Wayland or X11) runs, so on a server they stay off and nothing else is affected. On a Linux desktop, the screen helper needs glibc 2.39 or newer and GStreamer 1.22 or newer with the base, good and bad plugins, PipeWire and xdg-desktop-portal. See [Computer use](/docs/computer-use).+- **Saved secrets need a keyring.** Connector credentials, voice API keys and agent API keys are encrypted with a key kept in the Secret Service (for example GNOME Keyring). The host's user needs a session D-Bus and an unlocked Secret Service; without one, saving such a secret fails with an error, and new bots start with no connectors turned on. Codync never falls back to storing them in plain text.+- **No desktop app on the server itself.** The Linux desktop app needs a graphical session. Use the phone, the desktop app on another computer over SSH, or the terminal UI.+- **Keeping the machine awake does nothing.** VMs don't sleep; if the host can't hold off sleep, it only logs a warning.+- **Usage limits** come from the Claude Code and Codex installs on the server, the same as on a desktop.++## Updates++A host installed with the script and run as the background service updates itself: it checks once a day, while no bot is working. Homebrew installs update with `brew upgrade leepokai/codync/codync-host`, followed by `codync-host install`. Commands and details: [Updates](/docs/updates).diff --git a/web/content/docs/memory.mdx b/web/content/docs/memory.mdxnew file mode 100644index 00000000..e563c1d5--- /dev/null+++ b/web/content/docs/memory.mdx@@ -0,0 +1,119 @@+Every bot keeps a long-term memory about you that lasts across sessions: your name, time zone, the people you mention, your lasting preferences. Memory is about you as a person. What a bot learns about a project goes in a note of its own, and into the project's `CLAUDE.md` or `AGENTS.md` only when you ask.++Memory is plain Markdown files on your computer. The bot keeps them up to date itself; you change them by telling the bot.++## Two layers++| Layer | What it holds | Who sees it |+|---|---|---|+| **About you** | Facts every bot should know: your name, time zone, people. | Every bot that uses what your bots share. |+| **This bot** | What this bot learned about you. | Only this bot. |++A bot in its own personal workspace uses **About you** by default; a bot working in a project folder doesn't. Change it with **Use what your bots share** on the bot's **About you** tab (`s` in the terminal UI).++Each layer has two kinds of file:++- **MEMORY.md**: the short version, one fact per line. Every session starts with it in full. It has a size limit, and the app shows how much is in use.+- **Notes**: the detail, one topic per note, in topic folders such as `health/allergies.md`. The bot sees the list of its notes and reads one when its topic comes up.++The files are in `~/.codync/shared-memory/` (About you) and `~/.codync/bots/<bot id>/bot-memory/` (each bot), in your user folder.++## How the bot updates memory++The bot edits its memory files itself, with Codync's built-in memory tools, which work the same with every agent. Claude Code and Codex can also use their own file tools on those folders. Changes go in right away, whatever the bot's approval setting, and nothing about memory shows in the chat.++To change what a bot remembers, tell it in its chat: "Remember that I'm vegetarian", "Forget my old address."++What a bot may change depends on where it's working:++- **In its own chat, answering you:** it can add, change or remove anything. Its MEMORY.md may grow to twice its limit there, so what you ask it to remember is never turned away for lack of room.+- **Everywhere else** (routines, [group chats](/docs/groups), requests from [other bots](/docs/teamwork) and the turns where their answers come back): it can only add lines, within the limit. When MEMORY.md is full, it writes a note instead.++Every change is checked first. Memory can't take in hidden characters, links that carry instructions, planted instructions, passwords, keys, or ID or card numbers. A change that breaks a rule is put back, and the bot is told why.++A bot can also search its memory and its chat history. History search covers only the bot's own chat; group chats it took part in aren't included.++### Forgetting++When a bot removes a fact because you asked it to in its own chat, Codync remembers that you had it forgotten. No bot outside your own chat, and no dreaming, writes it back or learns it again from the same message. If you tell a bot again in its own chat, it can come back.++Earlier versions of the files are kept for 30 days. After that, what you had forgotten is gone from the history too.++### Editing the files yourself++You can also edit the files on the computer with any editor. Codync records the change as yours ("You wrote it"). A line that would fail the checks is kept out of what the bots see.++## What the apps show++Memory is on the bot's **Memory** tab, read-only. To change something, tell the bot.++- **iPhone:** tap the bot's name at the top of the chat, choose **Details**, then **Memory**.+- **Desktop:** click the bot's name at the top of the chat, then the **Memory** tab.+- **Terminal UI:** select the bot and press `M`.++The tab has these sections:++- **About you** and **This bot**: each fact with who wrote it ("You wrote it", "Scout remembered it", "Dreaming") and when, then the layer's **Notes** with their description, size and date. Open a note to read it.+- **Dreams**: what dreaming did, run by run.+- **Claude Code**: Claude Code's own notes, read-only, when you keep its own memory on (see below).++## Dreaming++Between chats, the bot tidies its memory from your own words. This is called dreaming.++- **When:** after five quiet minutes or eight of your messages, sooner after a new session and before Codync compacts a conversation, and once a day to update lines whose date has passed (putting them in the past tense).+- **What:** it reads what you said since its last run, then adds lines to MEMORY.md, takes out lines that went out of date, and adds lines to notes.+- **Only your words:** every change has to quote something you typed yourself. Pasted text, code blocks, quoted or forwarded messages, the bot's replies and other bots don't count. Group chats and bot requests never feed it.+- **Small steps:** at most 10 changes a run, never taking out more than a quarter of the lines. It never removes or rewrites a line you wrote, never brings back something you had a bot forget, and never rewrites a note.+- **Tidying:** when a MEMORY.md is nearly full, dreaming moves detail word for word into notes by topic, your lines too, and leaves one line per topic that points to its note, such as "Allergic to peanuts → health/allergies.md". That way memory doesn't fill up.++Dreaming runs in a session of its own, away from the chat, on the bot's own agent (with Claude Code, on Haiku with no tools), so it counts toward that agent's usage. It waits while your plan's usage is above 75%.++The **Dreams** tab shows each run: added lines in green, taken-out lines in red, and the notes it added to.++## The agent's own memory++Some agents keep a memory of their own, such as Claude Code's auto memory. Codync turns it off for every bot by default, so each bot has one memory and you see all of it here.++Where Codync can switch it, the **This bot** section has a switch named after the agent, such as **Claude Code's own memory** (`m` in the terminal UI). That's available for Claude Code, GitHub Copilot, CodeBuddy Code, and Qwen Code in a bot's personal workspace. Gemini CLI, Hermes Agent, Kilo Code and Kiro have no switch Codync can use.++If you turn it on:++- The bot may remember the same thing twice, and the two memories can disagree after something changes.+- What the bot forgets in Codync stays in the agent's own notes. Codync can't change them.+- Claude Code's notes show read-only in a **Claude Code** section.++Changing the switch restarts the agent, which resumes its session where it can. Switching the bot to another agent turns it off.++### Agents with a memory of their own++Hermes Agent and Gemini CLI keep one memory for all their sessions, and Codync can't turn it off for one bot. For a bot on either, the **This bot** section shows **Hermes Agent's own memory** (or Gemini CLI's) marked **Shared** in place of the switch, and its info button explains what that means:++- **Every bot that runs the agent shares it**, and so does the agent when you use it outside Codync. What one Hermes bot saves there, every other Hermes bot can read.+- **Remembered twice:** a bot may save the same thing in both memories, and the two can disagree.+- **Forgetting** in Codync doesn't remove anything from the agent's memory, and Codync can't show it to you.+- **Turning it off** is only possible in the agent's own settings, where it has one, and then for every session at once. Codync doesn't read those settings, so the row says **Shared** either way.++Where each keeps it:++| Agent | Memory | How to turn it off |+| --- | --- | --- |+| Hermes Agent | `MEMORY.md` and `USER.md` in `~/.hermes/memories` | set `memory.memory_enabled` and `memory.user_profile_enabled` to `false` in `~/.hermes/config.yaml` |+| Gemini CLI | `~/.gemini/GEMINI.md`, which Gemini CLI's own instructions have the model edit | Gemini CLI has no setting for it |++The terminal UI says the same in the memory sheet's note.++## Memory, new sessions and compaction++The bot's chat, its memory and the agent's session are separate things.++- **New session** gives the agent a fresh context. The chat stays in the app, and memory carries over: every new session starts with MEMORY.md in full and the list of notes.+- **During a session,** when memory changes (by this bot, another bot sharing About you, dreaming, or your own edit), the bot gets the new memory with its next message.+- **Compaction:** when a conversation in the bot's own chat gets long, Codync has the agent summarize it to make room. Dreaming runs first, so what you said reaches memory before it's summarized. Afterwards the bot's instructions and memory are applied again. Sometimes Codync starts a fresh conversation with a summary card instead. See [Fresh conversations](/docs/conversations#fresh-conversations).+- If the agent has deleted an old session, the bot starts fresh, and its memory is still there.++## Limits++- Memory search looks for the words you give it, so a fact worded differently won't match.+- Dreaming treats voice transcripts like typed text.+- In your own chat, a bot can still change memory because of something it read along the way, such as a web page or a file. Outside your own chat, it can only add.diff --git a/web/content/docs/privacy.mdx b/web/content/docs/privacy.mdxnew file mode 100644index 00000000..46b74001--- /dev/null+++ b/web/content/docs/privacy.mdx@@ -0,0 +1,80 @@+Codync keeps your work on your computer. The phone and desktop apps are windows onto the host running there. This page lists what stays on your devices, what passes through Codync's services and what they can see, and the usage analytics Codync collects. The [Privacy Policy](/privacy) is the formal statement.++## What stays on your computer++- **Bots, conversations, routines and memory** are kept by the host in `~/.codync` on your computer. Your phone keeps a cache so the app opens quickly.+- **Agents run with their own logins.** Claude Code, Codex and the other agents use the sign-ins you set up on the computer. Your prompts go from the agent to its provider, as they would without Codync.+- **Secrets are encrypted.** Connector credentials, voice API keys and other keys you enter in Codync are stored encrypted on the computer. The encryption key is held by the system's credential store (Keychain on macOS, Secret Service on Linux, Credential Manager on Windows). They're never sent to Codync's cloud.+- **Usage limits are read locally.** The host reads them from the agents installed on the computer: Claude Code's own usage command and status line, and Codex's local session files. Codync doesn't call any provider's API with your agents' logins. To read Claude Code's limits, `codync-host install` routes its status line through `codync-host statusline`; a status line you already had keeps working and is restored when you uninstall.++## The relay++When your phone isn't on the same network as your computer, the connection goes through the Codync relay on Cloudflare. Everything inside it is end-to-end encrypted between your phone and your computer. See [Remote access](/docs/remote-access) for how that works and how to turn the relay off.++**The relay can't read** your messages, files, bot output, approvals, terminals or anything else you send through the encrypted connection.++**The relay does see:**++- that your computer is registered, with its name, platform, device type, Codync version and public keys;+- when your computer and your devices connect, how often, and how much data passes;+- messages you send from the iPhone while the computer is offline, which wait there, encrypted, for up to 24 hours until the computer picks them up;+- if you sign in: your account's email address, the names and platforms of your signed-in devices, and which of them may use which computer. Sign-in itself is handled by Clerk, the sign-in service Codync uses.++The relay can't add a device to your computer. A new device needs either a pairing code shown on the computer or your approval there. The one exception is the setting **Skip the 6-digit check**, which lets any device signed in to your account in without that check.++**Public routine webhooks are the exception to end-to-end encryption.** A service that calls a routine's public URL sends its data to the relay over HTTPS. The relay can read it and keeps the routine's key to check signatures. If you don't want that, use the routine's local URL instead.++**Remote screen** sessions are encrypted between your phone and your computer. When there's no direct path, the video goes through a Cloudflare relay that can't see what's on your screen.++## Push notifications++On the iPhone, a bot can notify you when it needs you, when it's done, or when it failed. Your computer encrypts each notification's text (the bot's name and a short preview) to a key that only your iPhone holds. Codync's push service, a separate Cloudflare Worker, forwards it to Apple's push service with only a generic text such as "Your task is complete. Open Codync to read the result." Your iPhone decrypts the real text on the device. If it can't (for example before you first unlock the phone after a restart), you see the generic text.++- The push service and Apple see the generic text, the encrypted text, and identifiers that say which computer and bot the alert is for (not their names).+- Your phone's push token is wrapped in a ticket that only the push service can open. Your computer never sees the raw token. The push service doesn't store notifications.+- Live Activities on the Lock Screen and in the Dynamic Island get only the bot's status from the computer, never message text.+- No notification is sent while the iPhone app is connected to the computer. Muted and hidden bots don't notify.++To turn notifications off on an iPhone, open **Computers & settings** and turn off **Push notifications**. Each bot's settings have their own notification options.++## Voice++What leaves your device in a voice call or during dictation depends on the engine you pick. Details: [Voice](/docs/voice).++| Engine | Where your voice goes |+| --- | --- |+| On device (the default) | Recognized on your iPhone or Mac with Apple speech. Apple's servers may be used when on-device recognition isn't available for your language. Only the recognized text goes to your computer, as an ordinary message. |+| OpenAI or Gemini, Realtime mode | Straight from your device to the provider. Your computer gives the device a short-lived credential made from your key. The provider also gets the bot's name and description and the chat messages the call reads during the call. |+| OpenAI or Gemini, Speech mode, and dictation with a provider | Your recording goes to your computer over the encrypted connection, and your computer sends it to the provider with your key and the names of the bots on the computer as spelling hints. The provider's spoken replies come back the same way. |++Your provider key stays on your computer, encrypted. It's never sent to the relay or Codync's cloud. Calls with your own key run under your provider account and its privacy policy.++## Usage analytics++Codync records which features you use, to spot bugs sooner and see where people get stuck. Analytics are **on by default**, and nothing asks first. They go to PostHog (US).++**What's recorded:** opening the app and its screens, setting up and pairing (and whether you allow notifications), creating or deleting a bot, sending a message (with the number of attachments, never the files), running a routine or a voice call, and installing a connector. Each event carries the app version, the platform, and the agent and model the bot uses.++**Crashes and errors:** the kind of error and where in Codync's own code it happened. Never the error's message; file paths are cut down to Codync's own files.++**Never recorded:** your messages, prompts, code, files, file names or paths, bot names, credentials, or anything your agents produce.++**Location:** your IP address is used to look up an approximate location (country and city). The IP address itself isn't stored.++**Who it's linked to:** your Codync account when you're signed in; otherwise a random ID made on that device.++Analytics are never sold, never used for ads and never used to track you across other apps and websites. The website, codync.dev, counts page views and download clicks without cookies.++### Turning analytics off++Each phone and each computer has its own switch, **Share usage analytics**. Turning it off stops sending right away and drops anything not sent yet.++- **iPhone:** **Computers & settings → Share usage analytics.**+- **Desktop app:** **Settings → General**, under **Privacy**. This switch belongs to the computer's host, so it also covers the terminal UI on that computer.+- **Terminal UI:** press `^k` and choose **Share usage analytics**.++The info button next to the switch (**About usage analytics…** in the terminal UI) lists the same details. What you do from the phone on a computer, such as sending a message, is recorded by that computer. To stop all of it, turn the switch off on both.++## Removing your data++Delete a bot to remove its conversation. To remove everything from a computer, see "Uninstalling" in [Updates](/docs/updates). On the iPhone, **Start over** in **Computers & settings** signs out and forgets every computer; your computers keep their bots and chats. Deleting the iPhone app removes its cache.diff --git a/web/content/docs/remote-access.mdx b/web/content/docs/remote-access.mdxnew file mode 100644index 00000000..bd8ad4e2--- /dev/null+++ b/web/content/docs/remote-access.mdx@@ -0,0 +1,110 @@+Your bots run on your computer. The iPhone app reaches that computer in one of two ways: **directly** (same Wi-Fi or local network, Tailscale, or an address you publish yourself) or through the **Codync relay**, a service on Cloudflare that passes encrypted traffic between your phone and your computer when they can't see each other. Both routes use the same end-to-end encrypted connection, and the phone picks one on its own.++The desktop app and the terminal UI work differently: they talk to the host on the same computer, or to another computer over SSH. They don't use the relay.++## How the phone picks a route++Each time it connects, the phone first tries the computer's direct addresses. If none answers, it connects through the relay. When your network changes or you return to the app, it tries again, so it moves back to a direct connection when one becomes available.++| Route | When it works | What you set up |+| --- | --- | --- |+| Wi-Fi or local network | Phone and computer are on the same network | Nothing |+| Tailscale | Phone and computer are both on your Tailscale network | Tailscale on both |+| Your own URL | You run an HTTPS reverse proxy in front of the host | See "Your own HTTPS reverse proxy" below |+| Codync relay | Anywhere with internet | Nothing (on by default) |++The host lists its Tailscale and private network addresses, plus any URL you set yourself. It never advertises a public IP address on its own.++## Pairing++Pairing introduces your phone and your computer to each other. The computer shows a one-time code as a QR code; the phone scans it and learns the computer's public keys and addresses. The computer in turn remembers your phone's key. From then on, each side can check that it's talking to the other, on any route.++Show the code on the computer:++- **Desktop app:** open Codync in the menu bar (macOS) or the tray (Windows, Linux) and choose **Pair iPhone…**. You can also open **Settings → Computers** and use the QR code button on the computer's card.+- **Terminal:** run `codync-host pair`. It prints the QR code in the terminal. `codync-host pair --json` prints the link instead.+- **Terminal UI:** press `^k` and choose **Pair a phone…**.++Then, on the iPhone, scan it from the welcome screen, or later from **Computers & settings → Pair a computer** (tap the account button, then **Computers & settings**). You can also paste the `codync://pair` link instead of scanning.++A code works once and expires after 10 minutes. If it has expired, show a new one on the computer. Pairing needs no account and works over any route, including the relay.++## Signing in (optional)++You can sign in with Apple or Google on the iPhone and in the desktop app. Signing in doesn't give any device access by itself. It lets your phone find the computers in your account without scanning a code:++1. On the computer, sign in to the desktop app. The computer joins your account. For an SSH computer, choose **Add to account** on its card in **Settings → Computers**.+2. On the iPhone, sign in with the same account and open **Computers & settings**. Your account's computers are listed there. Tap **Ask for access**. The phone shows a 6-digit code.+3. On the computer, an **Access request** opens with a code. Choose **Approve** only if it matches the code on your phone exactly. If it doesn't, choose **Deny**: someone may be trying to get in.++On a computer without the desktop app, use `codync-host access` to list requests and `codync-host access approve <code>` to approve one.++Comparing the code is what stops anyone who controls the Codync cloud from slipping in their own device. In **Settings → Computers**, **Skip the 6-digit check** lets devices signed in to your account in without it. Leave it off unless you accept the risk the app warns about: anyone who gets into your account, or anyone who compromises Codync's cloud, could then add a device with full control of the computer. Devices paired with a QR code aren't affected by this setting.++Devices approved through your account only work while the computer stays in touch with the Codync cloud. Devices paired with a QR code don't depend on it.++## End-to-end encryption++Everything between your phone and your computer is encrypted on one end and decrypted on the other: messages, files, approvals, bot output, terminals. The relay passes along data it can't read.++- Each connection starts with a fresh key exchange, signed with the keys learned during pairing or approval.+- Only you can add a device to a computer: by showing a pairing code on it, or by approving a request on it. The relay can't add one (unless you turned on **Skip the 6-digit check**).+- A direct connection on your local network is encrypted too. Other devices on that network can still see that your phone is connecting to your computer.++For what the relay does see (such as connection times and sizes), see [Privacy](/docs/privacy).++## Turning the relay off++In the desktop app, open **Settings → Computers** and turn off **Reach from anywhere** on the computer's card. On a computer without the desktop app, run `codync-host cloud --disable` (and `codync-host cloud --enable` to turn it back on). `codync-host cloud` shows the current state.++With the relay off:++- The phone reaches the computer only directly: Wi-Fi, Tailscale or your own URL.+- Devices approved through your account can't connect. Devices paired with a QR code still can.+- Deliveries to public routine webhooks no longer reach the computer. Local ones keep working. The relay still accepts deliveries at the old public URLs and keeps them, readable, for up to 72 hours; they run if you turn the relay back on within that time. To stop them, remove the URL from the sender, or delete the routine or replace its key while the relay is on.++## Your own HTTPS reverse proxy++If you already run a web server with a domain and TLS certificate, you can give the phone its own direct address, such as `https://codync.example.com`.++1. **Forward only `/channel`** to the host (`http://127.0.0.1:19222` by default), at the root of a hostname, with WebSocket upgrades allowed.+2. **Never forward `/api`, `/events`, `/term` or `/oauth`.** The host answers those only to programs on the same computer. A proxy on that computer makes every request it forwards look local, so forwarding them removes that protection.+3. **Set `CODYNC_EXTERNAL_URL`** in the host's environment to the public URL, for example `CODYNC_EXTERNAL_URL=https://codync.example.com`. Separate several with commas. Each must be an `http://` or `https://` URL at the root of a host, with no path, query, user name or password; the host ignores any other entry and logs a warning.+4. **Restart the host.** It reads the variable when it starts.++The phone connects to `<url>/channel?v=1`. To check the proxy, open `<url>/channel` in a browser or with `curl`: a `400` (no WebSocket upgrade) or a `426 upgradeRequired` (an upgrade without `?v=1`) means requests reach the host. The phone's own connection gets `101`.++On Linux, add the variable with a systemd drop-in:++```sh+systemctl --user edit codync-host+# add these two lines, then save:+# [Service]+# Environment=CODYNC_EXTERNAL_URL=https://codync.example.com+systemctl --user restart codync-host+```++If you run the host under your own supervisor instead of the installed service, start it with `CODYNC_EXTERNAL_URL=https://codync.example.com codync-host serve --bind 127.0.0.1`. Binding to `127.0.0.1` keeps the host reachable only through the proxy (and the relay).++The host puts these URLs first in the pairing code and sends its current addresses on every connection, by any route. Paired phones save them on their own the next time they connect, so you don't need to pair again. Pair again only if the phone can't reach the computer at all: none of its saved addresses answers and the relay is off.++## SSH computers in the desktop app++The desktop app on macOS and Linux can also run bots on another computer you reach with SSH, such as a Linux server or a Mac mini. Open **Settings → Computers**, and under **Over SSH** choose **Add SSH computer**. The other computer needs `codync-host` installed. Codync opens an SSH tunnel to that computer's host using your SSH config and keys (or ssh-agent); your keys stay on the computer running the desktop app. On the first connection, check the host key fingerprint, then choose **Trust and connect**.++The SSH tunnel serves only the desktop app. To use that computer from your phone, pair the phone with it directly. Details for servers: [Linux servers](/docs/linux-servers).++## Public routine webhooks++A routine can start when another service (GitHub, a monitoring tool, a script) sends it a webhook. Each webhook routine has a key and two addresses:++- A **public URL** on the Codync relay. Services anywhere can reach it without you opening a port. If your computer is offline, the relay keeps deliveries for up to 72 hours and hands them over when it's back.+- A **local URL** on the computer itself (`http://127.0.0.1:19222/...`).++Webhook deliveries are **not** end-to-end encrypted. The relay receives them over HTTPS, can read their content, and stores the routine's key to check signatures. Your computer checks the key again before anything runs. Turning the relay off doesn't take the public URL down (see [Turning the relay off](#turning-the-relay-off)). Setting up webhook routines: [Routines](/docs/routines).++## Removing a device's access++- **On the computer:** in **Settings → Computers**, the list **Devices that can use** the computer has **Revoke access** for each device. Without the desktop app, use `codync-host devices` to list devices and `codync-host devices revoke <key>` to remove one. The device disconnects right away and has to pair or ask again.+- **On the iPhone:** in **Computers & settings**, remove a paired computer, or revoke this phone's account access to one. The computer keeps its bots and chats.+- **Remove from account** on a computer's card disconnects devices approved through the account. Devices paired with a QR code keep their access.diff --git a/web/content/docs/routines.mdx b/web/content/docs/routines.mdxnew file mode 100644index 00000000..ddafb83d--- /dev/null+++ b/web/content/docs/routines.mdx@@ -0,0 +1,125 @@+A routine is a task a bot does on its own: on a schedule, at a set time, or whenever another service sends it a webhook. Use one for a morning summary, a nightly check of a repository, or a review each time a pull request opens.++Each routine belongs to one bot and runs on your computer, with that bot's agent, folder, tools and approval setting. Its results show up in the bot's chat.++## Find a bot's routines++- **iPhone:** tap the bot's name at the top of the chat and choose **Routines**.+- **Desktop:** click the bot's name at the top of the chat to open its details. Routines are on the **Details** tab.+- **Terminal UI:** select the bot and press `R`.++Each routine shows its name, when it runs (or what it's doing right now), and an on/off switch.++## Create a routine++### By asking the bot++Tell the bot what you want, in its chat:++> I want a routine that summarizes yesterday's commits in ~/code/shop every weekday at 9:00.++The speech-bubble button in the routine list (**Ask the bot for a routine**) puts "I want a routine that " in the message box for you. In the terminal UI, press `c` in the routine list.++The bot saves it with Codync's built-in routine tools; your system's cron isn't involved. It asks only about what's missing or unclear, such as the time zone. It checks that the tools, sign-ins and files the task needs are there, looks at its existing routines so it doesn't make a duplicate, then saves and tells you what it saved: the schedule, time zone, next run and whether it's on. A "Created routine" line appears in the chat; tap it to open the routine.++Ask the bot for what the iPhone and desktop editors don't offer: a one-time run, an interval, events from GitHub, or several triggers on one routine.++### In the routine editor++Choose **+** (**Set up a routine**) in the routine list, or press `n` in the terminal UI.++- **Name** and **Instruction**: what the bot should do each time it runs.+- **When to run**: **Schedule** or **Webhook**.+- **Run settings**: the **Timeout**.++Choose **Create routine** to save it (desktop: ⌘S or Ctrl+S; terminal UI: Ctrl+S). Open a routine from the list to change it, then choose **Save changes**.++For a schedule, pick how often it repeats (**Hourly**, **Daily**, **Weekdays**, **Weekly**, or **Custom** for a five-field cron expression), the time and day, and a **Time zone**. New schedules start as Daily at 09:00 in your device's time zone. Under the fields, the host shows how it read the schedule and the next run.++In the terminal UI you type when it runs: `daily 09:00`, `weekdays 09:00`, `weekly mon 09:00`, `hourly :30`, `every 2h`, a date and time like `2026-11-02 14:30`, a cron expression, or `webhook`. Add a time zone at the end; Tab completes it.++If the bot set up triggers the editor doesn't offer, the editor shows them as **Set by bot** and keeps them until you pick Schedule or Webhook instead.++## Triggers++| Trigger | When it runs | Set up |+|---|---|---|+| Schedule | On a calendar schedule in a time zone you choose, daylight saving included. | Editor or bot |+| Webhook | Each time an authenticated delivery arrives at its URL. | Editor or bot |+| Once | One time, at a date and time in the future. | Bot (or terminal UI) |+| Interval | Every so many seconds, minutes, hours or days, from 1 second to 365 days. | Bot (or terminal UI) |+| Event | When a webhook delivery matches a source and event, such as a pull request opening on GitHub. | Bot |++A routine can have several triggers; it runs when any of them fires.++## Test, pause, delete++- **Test run** (the play button in the editor; `r` in the terminal UI's list) runs the routine now. It does the real task, side effects included, and works on a paused routine. If a retry is waiting, Test run runs it now. The bot doesn't test a routine it just created unless you ask it to.+- **Pause** with the routine's switch (space in the terminal UI). A paused routine has no next run and refuses webhook deliveries. Pausing cancels runs that haven't started; a run already under way can finish.+- **Delete** with the trash button (`x` in the terminal UI). It cancels pending runs. What the routine already posted stays in the chat.++## Where results appear++A run posts in the bot's chat: a line with the routine's name, such as "Routine · Morning summary", then the bot's reply, which is the result. The run's steps are in **Full conversation**. Tap the routine line to open the routine.++- A successful run sends you a notification with its reply.+- If there's nothing to report and the instruction allows silence, the run finishes without a message.+- A run that fails leaves a "Routine could not finish" line and notifies you.+- Replying to a result continues your normal conversation with the bot, with the result quoted.++The routine list also shows what each routine is doing, such as Queued, Running, Resuming after restart, Failed, Interrupted or Retrying at a time.++### How a run works++- **A fresh session.** Each run starts a session of its own. It doesn't see your conversation with the bot, so write instructions that stand on their own.+- **One thing at a time.** A bot runs one routine at a time, and routine runs take turns with your conversation. A message you send during a run waits until the run ends.+- **No backlog.** Runs that came due while the host couldn't run them don't pile up. The routine runs once, then keeps its schedule.+- **Approvals.** If the bot's **Permissions** are **Ask me**, a run that needs approval waits for you on a card in the chat, within its timeout.++## Failed runs and retries++Codync retries a failed run only when retrying can't repeat work:++- **Nothing changed yet.** If the run failed before using any tool that changes things (for example, the agent was rate limited or didn't start), Codync tries again after 1, 5 and 15 minutes. The chat shows an info line like "Trying again in 5 minutes." without a notification.+- **It already acted, ran out of time, or the retries failed.** The failure line notifies you and has a **Try again** button (`F` in the terminal UI) that runs the same work again. Only a routine's latest failure keeps the button.++Pausing or deleting the routine cancels a waiting retry; stopping the bot doesn't. A paused routine isn't retried automatically, and Try again doesn't work on it until you resume it.++If the host stops in the middle of a run (an update, a crash, a restart), the run resumes in its session when it's back, if the agent can reload it. If not, the run is marked interrupted. Either way, check what it already did before retrying anything with side effects.++## Timeouts++Each run has a time limit: one hour unless you change it under **Run settings → Timeout**, from 1 second to 24 hours. A run that goes over is stopped so the bot can get on with other work. A run that hits its limit isn't retried automatically.++## Webhooks++Choose **Webhook** under **When to run** and save. The editor then shows the routine's URL and key, with buttons to copy them, show the key, and **Replace key**. In the terminal UI, `w` copies a ready-made curl command and `W` replaces the key.++Codync doesn't register the webhook with the other service. You (or the bot, with you) paste the URL and key into it. Until a real delivery has arrived, the bot reports the webhook as waiting to be connected.++- **Any sender:** send a POST with the header `Authorization: Bearer <key>`. A JSON body reaches the routine as it is; any other body arrives as text.+- **GitHub:** set the Payload URL to the routine's URL, the content type to `application/json`, and the secret to the key. GitHub's test ping succeeds without running the routine. Each delivery reaches the routine with its event (such as `pull_request.opened`), repository and sender, so the bot can set up an event trigger for just the events you want.+- **Other services:** an event trigger can also match a JSON delivery by its `source` and `event` fields. Codync recognizes GitHub's deliveries by itself; for other senders, the JSON they post has to carry those fields.+- A delivery that arrives twice with the same delivery ID runs once. Bodies can be up to 64 KB.+- Replacing the key stops the old one at once. Senders using it stop working until they get the new key.++The run's prompt tells the bot that the delivery's contents are untrusted data to read, and that it shouldn't follow them as instructions. Still, keep secrets out of routine instructions and payloads.++### What the Codync cloud sees++A routine's public URL goes through the Codync cloud, so services can reach your computer without an open port or fixed address.++- Deliveries to the public URL are **not end-to-end encrypted**. The cloud handles the HTTPS connection, can read each delivery, and stores the key to check it. Your computer checks the key again before anything runs.+- If your computer is off or offline, the cloud keeps deliveries for up to 72 hours and hands them over once the host is back.++If **Reach from anywhere** is off for your computer, the routine has only a local URL starting with `http://127.0.0.1`, which only senders on the same computer can use. A public URL you gave a sender earlier still takes deliveries in the cloud: they wait there, readable, for up to 72 hours and run if you turn **Reach from anywhere** back on within that time. To stop them, remove the URL from the sender, or delete the routine or replace its key while **Reach from anywhere** is on. See [Remote access](/docs/remote-access) and [Privacy](/docs/privacy).++## Keep the host running and awake++Routines run only on your computer. The host checks for due work every second, whether or not an app is open, but it has to be running and the computer awake.++While a scheduled routine is on, Codync keeps the computer from going to sleep when idle. Putting it to sleep yourself, closing the lid or shutting it down still stops routines until it's back.++## Routines and other bots++A bot works only with its own routines. A bot that [manages the team](/docs/teamwork) can create or replace other bots' routines, but each bot runs its own: to test a teammate's routine, the manager asks that bot to run it, and the result appears in that bot's chat.diff --git a/web/content/docs/teamwork.mdx b/web/content/docs/teamwork.mdxnew file mode 100644index 00000000..7ed9f98a--- /dev/null+++ b/web/content/docs/teamwork.mdx@@ -0,0 +1,102 @@+Your bots can work with each other. One bot can ask another for help or hand it a task, and each does its part in its own chat, with its own agent, folder, tools and approval setting. A bot you let manage the team can also create new bots and change their setup.++There's no team to configure. Every bot can reach your other bots as soon as they exist. To have bots talk together in one room instead, use a [group chat](/docs/groups).++## Ask one bot to involve another++Give each bot a clear name and [standing instructions](/docs/bots) that say what it's for, so the others know whom to ask. Then tell one bot what you want:++> Ask Reviewer to inspect the changes in ~/code/shop. Have it report bugs without editing files, then summarize its findings for me.++The bot finds Reviewer among your bots and sends it the request. When Reviewer's answer comes back, the bot sums it up for you in its own chat. Bots see only your visible bots: a bot you hid from the bot list can't be messaged, and neither can a group.++## What you see in the chats++Each exchange shows as one small row that names the other bot. The request text itself stays out of the chat:++- In the sender's chat: **Messaged** with the other bot's avatar and name, for example "Messaged Owen".+- In the recipient's chat: **Message from**, for example "Message from Egan".++Several exchanges in a row with the same bot, in either direction, fold into one row: "3 messages with Owen". Anything else in the chat, such as a message or a card, starts a new row. If an exchange failed, its row shows a warning mark and the name in red.++Tap or click the row to open the conversation between the two bots: a read-only sheet titled with both bots, for example Egan ⇄ Owen. It shows every request and reply between them as bubbles labelled with who wrote them, with the time shown wherever there's a gap. Under one that's still going it says "Waiting for Owen…"; under one that failed it shows what went wrong. In the terminal UI, pick the row with `v` and press `↵`, or click it.++The recipient's tool calls and thinking are in its own **Full conversation**.++## How a message runs++Bots never wait on each other. When one bot messages another:++1. **The request is queued and the sender goes on at once.** It can finish its turn or keep working.+2. **The recipient does the work** in its own chat's session, one thing at a time: a busy recipient finishes what it's doing first.+3. **The answer goes back to the sender**, not to you. It shows in the conversation sheet and in the recipient's **Full conversation**, but not as a message in the recipient's chat.+4. **The sender takes the answer as a new turn of its own** and replies to you in its chat, with the usual "done" notification. Answers that arrive while the sender is busy are taken together in one turn. A request that failed comes back the same way, so the sender can tell you.++Because nobody waits, there's no time limit: the recipient takes as long as the work needs.++## How the recipient works++- **Its own setup.** The recipient works in its own folder, with its own tools, connectors, memory and approval setting. If it needs your approval, the card appears in its chat and you get a "needs you" notification.+- **Only the request.** The sender's conversation isn't copied over, only the request. Bots are told to write requests that stand on their own.+- **It answers the sender.** While it works on a request, the recipient can't message you or other bots. If it needs another bot's help, it says so in its answer.+- **Your words only.** Neither a bot's request nor its answer counts as something you said, so neither is learned as a fact about you. A bot working on another bot's request can add to its [memory](/docs/memory) but can't change or remove what's there.+- **Shared folders.** If two bots work in the same project, tell them who edits which files.+- **Subagents.** Agents that start their own subagents (Claude Code, Codex) keep doing that themselves. Codync doesn't turn those into bots.++In a [group chat](/docs/groups), members don't message each other this way; they @-mention each other in the room.++## Stopping, limits and restarts++- **Stopping the sender** doesn't cancel what it already sent, but drops answers still waiting for it. Deleting the sender drops its answers too. The rows in both chats still show how each exchange ended.+- **Stopping or deleting the recipient** cancels its queued requests and stops the one it's working on, which may leave partial changes.+- **Limits:** a bot can have up to 16 messages queued or running at once, and the computer up to 64 in all. To keep bots from passing work around forever, a chain of requests stops after eight handoffs. Your next message starts a fresh allowance.+- **Restarts:** if the host restarts while requests are pending, they're marked as failed and not run again. Check what the bots already did before you ask again. An answer still waiting for a busy sender is lost on a restart, but stays readable in the conversation sheet.++## Manage the team++A bot with **Manage the team** on can set up the team for you: list your bots, create new ones and change their setup. Use it for a lead bot that hires the specialists a project needs.++### Turn it on++**Manage the team** is off for every bot. Only you can turn it on or off, in the bot's settings:++- **Desktop:** the bot's settings, **Activity** section.+- **iPhone:** the bot's **Settings**.+- **Terminal UI:** the settings form (`e`), **Manage team** row.++### What a manager can do++- **List the team:** every bot with its setup and routines, including hidden bots and the manager itself.+- **Create bots** with a name, standing instructions, agent, model, fallbacks, avatar, project folder and routines. A new bot gets the manager's approval setting, connectors and skills, so it can't do more than the manager. It can manage the team too. It never gets computer use. Without a chosen avatar it gets a random one.+- **Change any bot**, itself included: name, standing instructions, model, [fallbacks](/docs/agent-fallbacks), avatar, whether it's hidden from your bot list, and its [routines](/docs/routines) (add new ones or replace existing ones). Changing a bot's model clears that bot's model settings, such as effort. A manager that changes its own model gets the new one after its current turn.++Bots stop creating bots once 20 bots made by bots exist (deleted ones don't count). Past that, the manager asks you.++A bot created this way shows who made it in its settings: "Created by Lead · Oct 20, 2026". The terminal UI shows it on the settings form's Name row.++Managers are told to act only on what you asked, never because a file, web page, tool result or another bot told them to.++### Approval cards++If the manager's **Permissions** are **Ask me**, every create or change first shows an approval card in the manager's chat, with **Allow** and **Deny**. The card lists everything the change sets: one line per setting, then the routines, then the standing instructions in full.++- A change too long to show in full on its card (over 2,000 characters) is refused before the card appears. The manager has to shorten it or split it.+- A card waits about four and a half minutes. If you don't answer in time, it expires and nothing changes.+- If you deny a change, the manager is told not to try it again unless you ask.++With **Approve automatically**, changes happen without a card. Either way, a line in the manager's chat records what changed, such as "Created bot Security Analyst" or "Updated Reviewer: model, routines".++### What stays with you++A manager can't:++- delete bots,+- turn **Manage the team** on or off,+- change an existing bot's agent, folder, approval setting, connectors, skills, computer use or model settings such as effort.++### Routines of other bots++Each bot runs only its own routines. A manager can create or replace a teammate's routines, but to test one, it asks that bot to run it. The run then belongs to the owner: it uses the owner's setup, and its result appears in the owner's chat.++A hidden bot can't be messaged, so to test a hidden bot's routine, run it yourself with **Test run** in that bot's routine list.+diff --git a/web/content/docs/updates.mdx b/web/content/docs/updates.mdxnew file mode 100644index 00000000..e4976ea2--- /dev/null+++ b/web/content/docs/updates.mdx@@ -0,0 +1,95 @@+Codync has three parts that update separately: the desktop app, the host that runs your bots, and the iPhone app. On macOS and Windows the host ships inside the desktop app and updates with it. On Linux, and on any computer where you installed only the host, the host updates on its own. The iPhone app comes from the App Store.++## The desktop app++The desktop app checks for a new release every day, downloads it, and installs it when you're not using the computer. Both are on by default.++You'll find the update settings in two places:++- **Settings → Updates** in the chat window.+- **Settings → Updates** in the menu bar (macOS) or tray (Windows, Linux) menu.++Both offer the same controls:++| Control | What it does |+| --- | --- |+| **Check for updates** | Checks now. When a release is found, the button reads **Update to** and the version; choose it to download. |+| **Restart to update** | Appears once the release is downloaded. Restarts Codync into the new version. |+| **Automatically check for updates** | The daily check. |+| **Automatically download and install** | Downloads releases on its own and installs them when Codync is idle. |++While a release is available, an **Update** button also appears in the chat window's sidebar. One click downloads it (a ring shows the progress, and Codync stays usable) and restarts into it.++A finished download never quits the app by itself. Automatic installation waits until no Codync window is in front, you haven't used the keyboard or mouse for ten minutes, and no bot is working. A downloaded update also installs when you quit Codync.++On macOS and Windows, updating the app also updates this computer's host: the app stops the host, installs, and starts the new one. If you installed the Mac app with Homebrew, it still updates itself this way.++## The host on its own++On Linux, and on a Mac or server where you installed only `codync-host`, the host updates separately from any app.++- **Installed with the install script** and running as the background service: the host updates itself. It checks once a day while no bot is working, checks that the download is signed, and keeps your data. If the new version doesn't start, it puts the previous one back.+- **Installed with Homebrew:** run `brew upgrade leepokai/codync/codync-host`, then `codync-host install`.+- **Re-running the install script** also upgrades the host and restarts its service.++To check or update by hand:++```sh+codync-host update --check # is there a newer release?+codync-host update # install it now+codync-host update --status # progress of an update+codync-host update --auto off # turn automatic updates off (on to turn them back on)+```++A manual update won't interrupt a bot that's working unless you add `--force`; interrupted bots pick up their sessions again. In the terminal UI, press `^k` and choose **Check for updates**.++## The iPhone app++The iPhone app updates through the App Store. Every iPhone release goes through Apple's App Review first, so the App Store version can be a day or more behind the desktop app and the host. When a newer version is out, a card at the top of the bot list tells you which version is available, with an **Update** button that opens the App Store. You can dismiss it.++Your computer accounts for the review delay: a computer update that needs a newer iPhone app isn't offered to computers until that iPhone version is in the App Store.++## When the phone and computer versions don't match++Each side knows the oldest version of the other side it still works with. When one side is too old, you see a notice above that computer's bots and in place of the message box, and the computer's status reads **Needs update**. Your chats stay safe on the computer, and drafts are kept. Once the older side is updated, the notice goes away on its own.++| Notice | What to do |+| --- | --- |+| **Update this app** | The app you're using is too old for that computer. On the iPhone, **Update Codync** opens the App Store; if the version you need is still in App Store review, the button stays greyed out until it's available. In the desktop app, use the update button on the notice. |+| **Update Codync on** and the computer's name | The computer's host is too old for this app. The notice says how: on a Mac, open Codync there and check for updates; on Linux, run `codync-host update` there. For the computer the desktop app runs on (macOS and Windows), the notice has a button that updates it. |++In the terminal UI, the status line shows **needs update** with the reason, and sending is blocked until you update.++## If an update fails++1. Quit Codync completely (on macOS, **Codync → Quit Codync**, not just the window's close button) and open it again. A downloaded update may finish installing when the old app exits. Check the version in **Settings → Updates**.+2. If it still fails, reinstall the app from the [latest release](https://github.com/leepokai/Codync/releases/latest) and keep your data.++To reinstall the Mac app:++```sh+# 1. Quit Codync, then remove its background host service (your bots and keys stay):+/Applications/Codync.app/Contents/Resources/codync-host uninstall+# 2. Move Codync.app to the Trash, then install the new one from codync-macos.dmg.+# 3. Open Codync. It sets up the host again. If the host stays stopped:+/Applications/Codync.app/Contents/Resources/codync-host install+```++With Homebrew, quit Codync and run `brew reinstall --cask leepokai/codync/codync`. On Linux, replace the app the way you installed it, and update the host with `codync-host update`.++> **Note:** Don't use **Reset all data…**, delete `~/.codync`, or run a cleanup tool to fix an update. Those erase your bots and the computer's identity, and every phone has to pair again.++## Uninstalling++### On a computer++1. Remove the background host service: in the menu bar or tray menu choose **Settings → Uninstall host service**, or run `codync-host uninstall`. This keeps your data.+2. Quit Codync and remove the app the usual way for your system. With Homebrew: `brew uninstall --cask leepokai/codync/codync` for the app, or `brew uninstall leepokai/codync/codync-host` for the host. A host from the install script lives in `~/.local/bin`; delete `codync-host` there (on Linux also `codync-screen` and `cua-driver`).++`~/.codync` (on Windows, `.codync` in your user folder) holds your bots, conversations, routines, memory and the computer's identity. It stays after you uninstall. Delete it to remove all of it.++To erase everything from the desktop app in one step, choose **Settings → Reset all data…** in the menu bar or tray menu. It removes the computer from your account, revokes every paired device, signs you out, uninstalls the host, deletes its data and the app's settings, and restarts Codync at the welcome screen. With Homebrew, `brew uninstall --zap --cask leepokai/codync/codync` also deletes `~/.codync` and the app's settings.++### On the iPhone++In **Computers & settings**, remove a computer, or choose **Start over** to sign out and forget every computer. Deleting the app removes its cache. Your computers keep their bots and chats either way.diff --git a/web/content/docs/voice.mdx b/web/content/docs/voice.mdxnew file mode 100644index 00000000..eceafed2--- /dev/null+++ b/web/content/docs/voice.mdx@@ -0,0 +1,109 @@+You can talk to your bots two ways:++- **Voice call:** a hands-free conversation with a bot or a group chat. You speak, the bot's replies are read aloud.+- **Dictation:** speak into the message box, check the text, then send it yourself.++Both work in the iPhone app and the desktop app. The terminal UI has no microphone, so it has neither, but it shows the notice a call leaves in the chat.++A call doesn't change the bot. It's the same agent on your computer; you're just talking to it instead of typing.++## Start a call++When the message box is empty and the bot isn't working, the send button becomes **Call** (a waveform). Press it.++The call bar floats at the top of the chat, and the chat stays readable and usable underneath. From left to right:++- the bot's avatar: it pulses while the bot speaks, and tapping it then interrupts the reply+- a line of dots that follows your voice while you speak, ripples while the bot speaks, and breathes slowly while it works+- the provider's name, whenever audio leaves your device (see "What goes where" below)+- **Call settings** (the gear), **Mute**, and **End call** (the red ✕)++When the call ends, the chat gets a notice such as "Voice chat · 00:16", in every app.++On the iPhone, the first call asks for Microphone and Speech Recognition access. The call keeps going if you leave Codync for the Home Screen.++## Choose a voice engine++Open **Voice chat** settings from the call bar's gear, or:++- **iPhone:** **Computers & settings → Voice chat → Voice and API keys**.+- **Desktop app:** **Settings → Voice chat**.++Under **Engine**, pick one. The choice is kept on this device and applies from your next call.++| Engine | Needs | How it works |+| --- | --- | --- |+| **On device** (default) | Nothing | Your device turns speech into text and reads replies with the system voice |+| **OpenAI** | Your OpenAI API key, kept on the computer | OpenAI's models hear you and speak |+| **Gemini** | Your Google AI Studio key, kept on the computer | Google's models hear you and speak |++### On device++- You speak in the language set under **Language** (by default, your device's first language).+- A pause ends what you said and sends it as an ordinary message. If the bot is busy, it's queued like any other message. Set the pause under **Send after a pause of** (1 s, 1.5 s or 2.5 s).+- Each reply is read aloud in the language it's written in, skipping code blocks and formatting. Set **Reading speed** to Slower, Normal or Faster. The microphone pauses while a reply is read.+- When the bot asks for approval, the call tells you; answer it in the chat.++In the desktop app, on-device speech is available on macOS only. On Windows and Linux, calls use OpenAI or Gemini; without a key, the call asks you to add one in call settings.++### OpenAI or Gemini++Each provider has two modes, under **Mode**:++- **Realtime:** a live conversation with the provider's realtime model. You can talk over replies.+- **Speech:** the same loop as On device, using the provider's speech-to-text and text-to-speech models instead. What you say is sent when you pause, and replies are read aloud.++In Realtime mode, the voice model works in front of your bot, and the bot still does the work. The voice model passes your requests to the bot as ordinary messages, reads the bot's replies out in shortened form, can tell you what the bot is doing ("what are you working on?") from its status and recent messages, and answers an approval for you once you've said which option. The chat stays the record: only the messages sent to the bot and the bot's replies are saved, and the small talk with the voice model isn't.++Below the key you can pick the **Model** (or, in Speech mode, **Speech to text** and **Text to speech**) and the **Voice**. The default models follow each provider's newest ones. **This month** shows an estimate of the minutes used, counted on each device. The provider bills you; it isn't a bill.++If a provider can't start, or the connection drops mid-call, the call switches to on-device voice without hanging up and says so under the bar. (In the desktop app this happens on macOS, where on-device speech exists.)++## Add your API key++Keys are entered on the computer, never on the phone:++1. In the desktop app on that computer, open **Settings → Voice chat**. For a computer you reach over SSH from the desktop app, use the **Voice chat** button (waveform) on its card in **Settings → Computers & devices**.+2. Pick **OpenAI** or **Gemini** as the engine. Use **Get a key from OpenAI** (or Gemini) if you need one.+3. Paste the key and press **Save**. The computer checks it with the provider and keeps it only if it works; otherwise you see the provider's error.++Once saved, the section shows **Key saved** with **Test key**, **Replace key** and **Remove key**. The iPhone shows whether the computer has a key and can test it, and tells you where to add one if it doesn't.++The key is stored encrypted in Codync's vault on the computer (with the system keychain, as for [connector credentials](/docs/connectors-and-skills)), so one key serves the iPhone and the desktop app. It's never logged and never sent to the relay or to Codync's cloud.++## What goes where++| You use | Your audio | Your key |+| --- | --- | --- |+| On device | Stays on your device. Only the recognized text goes to the computer, as a message. Apple's speech recognition may use Apple's servers when on-device recognition isn't available for your language. | Not needed |+| Realtime | Streams directly between your device and the provider (OpenAI over WebRTC, Gemini over a WebSocket). It doesn't pass through your computer or the relay. | Stays on the computer, which gives your device a short-lived credential for each call |+| Speech mode, or dictation with a provider | Recordings go to your computer over the encrypted connection, and the computer sends them to the provider, with the names of the bots on the computer as spelling hints. The spoken replies come back the same way. | Stays on the computer |++The relay only ever sees encrypted data. Whenever audio leaves your device, the call bar names the provider.++## Dictation++The microphone button (**Dictate**) sits beside the send button. Press it and speak: the words go into the message box, after anything you've already typed. Nothing is sent until you send it.++While it listens, the microphone becomes a recording pill with a stop button, the time, and dots that follow your voice.++### Pick the dictation engine++The small arrow beside the microphone (**Dictation engine**) chooses **On device**, **OpenAI** or **Gemini**. It's kept on this device, separate from the call engine.++- **On device:** words appear as they're recognized, in the language set for calls. On the iPhone, stop keeps what was recognized so far. In the desktop app, dictation keeps listening through pauses until you press stop.+- **OpenAI or Gemini:** Codync first checks that the computer has the provider's key (if not, you get an error before anything is recorded). The pill appears once the microphone is open, so nothing you say is lost. Nothing is typed while you record. When you press stop, the pill shows "Transcribing…" and the text lands in the box when it arrives. It uses the **Speech to text** model from Voice chat settings, and the recording counts toward that provider's minutes this month.++If dictation uses a provider that your calls don't, Voice chat settings show a separate section for it ("For dictation in the message box.") with its key status and speech-to-text model.++Sending a message, starting a call or switching chats drops a dictation that is still recording or transcribing. A call takes the microphone.++In the desktop app on Windows and Linux, the microphone works with OpenAI or Gemini; with On device picked, it tells you on-device speech isn't available there.++### Voice input shortcut (Mac)++In the desktop app on macOS, **Settings → General → System → Voice input shortcut** lets you dictate from any app: **Right ⌘ twice** (the default), **Left ⌘ twice**, or **Off**.++Double-tap the key and dictation starts in the chat window's message box (the top bot's chat when none is open). Tap the key once more to stop and send what you said, once the last words are in. Press the pill's stop instead to keep the words without sending. If the notch island is on (**Settings → General → System → Show in Notch**), dictation goes into the island's message field instead. During a call the shortcut does nothing.++The shortcut needs no Accessibility or Input Monitoring permission, and the app never sees what you type.diff --git a/web/mdx-components.tsx b/web/mdx-components.tsxnew file mode 100644index 00000000..859231b6--- /dev/null+++ b/web/mdx-components.tsx@@ -0,0 +1,51 @@+import type { MDXComponents } from "mdx/types";+import Link from "next/link";++// The user manual's typography (content/docs/*.mdx) in the site's dark palette; the page's title is its h1+// (app/docs/[slug]/page.tsx). Headings carry the ids rehype-slug gives them, so `/docs/bots#new-session` links work.+const components: MDXComponents = {+ h2: ({ children, id }) => (+ <h2 id={id} className="mt-14 scroll-mt-24 text-2xl font-semibold tracking-tight text-balance text-neutral-50">+ {children}+ </h2>+ ),+ h3: ({ children, id }) => (+ <h3 id={id} className="mt-9 scroll-mt-24 text-lg font-semibold text-balance text-neutral-100">+ {children}+ </h3>+ ),+ p: ({ children }) => <p className="mt-5 max-w-[42rem] leading-relaxed text-neutral-400">{children}</p>,+ ul: ({ children }) => <ul className="mt-5 max-w-[42rem] list-disc space-y-2 pl-5 leading-relaxed text-neutral-400 marker:text-neutral-600">{children}</ul>,+ ol: ({ children }) => <ol className="mt-5 max-w-[42rem] list-decimal space-y-2 pl-5 leading-relaxed text-neutral-400 marker:text-neutral-500">{children}</ol>,+ li: ({ children }) => <li className="pl-1 [&>ol]:mt-2 [&>p]:mt-2 [&>ul]:mt-2">{children}</li>,+ strong: ({ children }) => <strong className="font-semibold text-neutral-200">{children}</strong>,+ a: ({ href = "", children }) =>+ href.startsWith("/") || href.startsWith("#") ? (+ <Link href={href} className="text-neutral-100 underline underline-offset-4 hover:text-white">+ {children}+ </Link>+ ) : (+ <a href={href} className="text-neutral-100 underline underline-offset-4 hover:text-white">+ {children}+ </a>+ ),+ code: ({ children }) => <code className="rounded bg-neutral-900 px-1.5 py-0.5 font-mono text-[0.85em] break-words text-neutral-200">{children}</code>,+ pre: ({ children }) => (+ <pre className="mt-5 max-w-[42rem] overflow-x-auto rounded-xl bg-neutral-900 p-4 text-sm leading-relaxed text-neutral-200 [&>code]:bg-transparent [&>code]:p-0">+ {children}+ </pre>+ ),+ blockquote: ({ children }) => <blockquote className="mt-5 max-w-[42rem] border-l-2 border-neutral-600 pl-4 [&>p]:mt-0">{children}</blockquote>,+ table: ({ children }) => (+ <div className="mt-5 max-w-full overflow-x-auto">+ <table className="w-full min-w-[32rem] border-collapse text-left text-sm text-neutral-400">{children}</table>+ </div>+ ),+ th: ({ children }) => <th className="border-b border-neutral-700 py-2 pr-4 font-medium text-neutral-200">{children}</th>,+ td: ({ children }) => <td className="border-b border-neutral-800 py-2 pr-4 align-top">{children}</td>,+ hr: () => <hr className="mt-10 border-neutral-800" />,+};++export function useMDXComponents(): MDXComponents {+ return components;+}diff --git a/web/next.config.ts b/web/next.config.tsindex 1c20344e..35629535 100644--- a/web/next.config.ts+++ b/web/next.config.ts@@ -1,3 +1,4 @@+import createMDX from "@next/mdx";import type { NextConfig } from "next";const nextConfig: NextConfig = {@@ -6,4 +7,10 @@ const nextConfig: NextConfig = {images: { unoptimized: true },};-export default nextConfig;+// The user manual (content/docs/*.mdx): GitHub-flavored Markdown (tables) and linkable headings. Plugins go by+// name so Turbopack can load them.+const withMDX = createMDX({+ options: { remarkPlugins: ["remark-gfm"], rehypePlugins: ["rehype-slug"] },+});++export default withMDX(nextConfig);diff --git a/web/package-lock.json b/web/package-lock.jsonindex f6a321f6..bf85a76c 100644--- a/web/package-lock.json+++ b/web/package-lock.json@@ -8,15 +8,21 @@"name": "website","version": "0.1.0","dependencies": {+ "@mdx-js/loader": "^3.1.1",+ "@next/mdx": "^16.2.1","@phosphor-icons/react": "^2.1.10","framer-motion": "^12.38.0","next": "16.2.1","posthog-js": "1.435.8","react": "19.2.4",- "react-dom": "19.2.4"+ "react-dom": "19.2.4",+ "rehype-slug": "^6.0.0",+ "remark-gfm": "^4.0.1"},"devDependencies": {+ "@mdx-js/mdx": "^3.1.1","@tailwindcss/postcss": "^4",+ "@types/mdx": "^2.0.14","@types/node": "^20","@types/react": "^19","@types/react-dom": "^19",@@ -1024,6 +1030,84 @@"@jridgewell/sourcemap-codec": "^1.4.14"}},+ "node_modules/@mdx-js/loader": {+ "version": "3.1.1",+ "resolved": "https://registry.npmjs.org/@mdx-js/loader/-/loader-3.1.1.tgz",+ "integrity": "sha512-0TTacJyZ9mDmY+VefuthVshaNIyCGZHJG2fMnGaDttCt8HmjUF7SizlHJpaCDoGnN635nK1wpzfpx/Xx5S4WnQ==",+ "license": "MIT",+ "dependencies": {+ "@mdx-js/mdx": "^3.0.0",+ "source-map": "^0.7.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ },+ "peerDependencies": {+ "webpack": ">=5"+ },+ "peerDependenciesMeta": {+ "webpack": {+ "optional": true+ }+ }+ },+ "node_modules/@mdx-js/mdx": {+ "version": "3.1.1",+ "resolved": "https://registry.npmjs.org/@mdx-js/mdx/-/mdx-3.1.1.tgz",+ "integrity": "sha512-f6ZO2ifpwAQIpzGWaBQT2TXxPv6z3RBzQKpVftEWN78Vl/YweF1uwussDx8ECAXVtr3Rs89fKyG9YlzUs9DyGQ==",+ "license": "MIT",+ "dependencies": {+ "@types/estree": "^1.0.0",+ "@types/estree-jsx": "^1.0.0",+ "@types/hast": "^3.0.0",+ "@types/mdx": "^2.0.0",+ "acorn": "^8.0.0",+ "collapse-white-space": "^2.0.0",+ "devlop": "^1.0.0",+ "estree-util-is-identifier-name": "^3.0.0",+ "estree-util-scope": "^1.0.0",+ "estree-walker": "^3.0.0",+ "hast-util-to-jsx-runtime": "^2.0.0",+ "markdown-extensions": "^2.0.0",+ "recma-build-jsx": "^1.0.0",+ "recma-jsx": "^1.0.0",+ "recma-stringify": "^1.0.0",+ "rehype-recma": "^1.0.0",+ "remark-mdx": "^3.0.0",+ "remark-parse": "^11.0.0",+ "remark-rehype": "^11.0.0",+ "source-map": "^0.7.0",+ "unified": "^11.0.0",+ "unist-util-position-from-estree": "^2.0.0",+ "unist-util-stringify-position": "^4.0.0",+ "unist-util-visit": "^5.0.0",+ "vfile": "^6.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/@mdx-js/react": {+ "version": "3.1.1",+ "resolved": "https://registry.npmjs.org/@mdx-js/react/-/react-3.1.1.tgz",+ "integrity": "sha512-f++rKLQgUVYDAtECQ6fn/is15GkEH9+nZPM3MS0RcxVqoTfawHvDlSCH7JbMhAM6uJ32v3eXLvLmLvjGu7PTQw==",+ "license": "MIT",+ "optional": true,+ "peer": true,+ "dependencies": {+ "@types/mdx": "^2.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ },+ "peerDependencies": {+ "@types/react": ">=16",+ "react": ">=16"+ }+ },"node_modules/@napi-rs/wasm-runtime": {"version": "0.2.12","resolved": "https://registry.npmjs.org/@napi-rs/wasm-runtime/-/wasm-runtime-0.2.12.tgz",@@ -1053,6 +1137,27 @@"fast-glob": "3.3.1"}},+ "node_modules/@next/mdx": {+ "version": "16.2.1",+ "resolved": "https://registry.npmjs.org/@next/mdx/-/mdx-16.2.1.tgz",+ "integrity": "sha512-w0YOkOc+WEnsTJ8uxzBOvpe3R+9BnJOxWCE7qcI/62CzJiUEd8JKtF25e3R8cW5BGsKyRW8p4zE2JLyXKa8xdw==",+ "license": "MIT",+ "dependencies": {+ "source-map": "^0.7.0"+ },+ "peerDependencies": {+ "@mdx-js/loader": ">=0.15.0",+ "@mdx-js/react": ">=0.15.0"+ },+ "peerDependenciesMeta": {+ "@mdx-js/loader": {+ "optional": true+ },+ "@mdx-js/react": {+ "optional": true+ }+ }+ },"node_modules/@next/swc-darwin-arm64": {"version": "16.2.1","resolved": "https://registry.npmjs.org/@next/swc-darwin-arm64/-/swc-darwin-arm64-16.2.1.tgz",@@ -1565,13 +1670,39 @@"tslib": "^2.4.0"}},+ "node_modules/@types/debug": {+ "version": "4.1.13",+ "resolved": "https://registry.npmjs.org/@types/debug/-/debug-4.1.13.tgz",+ "integrity": "sha512-KSVgmQmzMwPlmtljOomayoR89W4FynCAi3E8PPs7vmDVPe84hT+vGPKkJfThkmXs0x0jAaa9U8uW8bbfyS2fWw==",+ "license": "MIT",+ "dependencies": {+ "@types/ms": "*"+ }+ },"node_modules/@types/estree": {"version": "1.0.8","resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz","integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==",- "dev": true,"license": "MIT"},+ "node_modules/@types/estree-jsx": {+ "version": "1.0.5",+ "resolved": "https://registry.npmjs.org/@types/estree-jsx/-/estree-jsx-1.0.5.tgz",+ "integrity": "sha512-52CcUVNFyfb1A2ALocQw/Dd1BQFNmSdkuC3BkZ6iqhdMfQz7JWOFRuJFloOzjk+6WijU56m9oKXFAXc7o3Towg==",+ "license": "MIT",+ "dependencies": {+ "@types/estree": "*"+ }+ },+ "node_modules/@types/hast": {+ "version": "3.0.5",+ "resolved": "https://registry.npmjs.org/@types/hast/-/hast-3.0.5.tgz",+ "integrity": "sha512-rp/ezSWaD1m44dPKICGhiskI13nVr7qTloFwDa/IYkhhf5nzwP+zIQcIJh3WIFSBOy/H1PzB40jPjMDksN4F+g==",+ "license": "MIT",+ "dependencies": {+ "@types/unist": "*"+ }+ },"node_modules/@types/json-schema": {"version": "7.0.15","resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz",@@ -1586,6 +1717,27 @@"dev": true,"license": "MIT"},+ "node_modules/@types/mdast": {+ "version": "4.0.4",+ "resolved": "https://registry.npmjs.org/@types/mdast/-/mdast-4.0.4.tgz",+ "integrity": "sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA==",+ "license": "MIT",+ "dependencies": {+ "@types/unist": "*"+ }+ },+ "node_modules/@types/mdx": {+ "version": "2.0.14",+ "resolved": "https://registry.npmjs.org/@types/mdx/-/mdx-2.0.14.tgz",+ "integrity": "sha512-T48PeuJtvLosNTPVhfnIp3i/n3a4g4Bad7YCq5k64D4u7NwDrAotikQ+5+sjtUvBmxCMlbo3dVL+C2dP0rWHzg==",+ "license": "MIT"+ },+ "node_modules/@types/ms": {+ "version": "2.1.0",+ "resolved": "https://registry.npmjs.org/@types/ms/-/ms-2.1.0.tgz",+ "integrity": "sha512-GsCCIZDE/p3i96vtEqx+7dBUGXrc7zeSK3wwPHIaRThS+9OhWIXRqzs4d6k1SVU8g91DrNRWxWUGhp5KXQb2VA==",+ "license": "MIT"+ },"node_modules/@types/node": {"version": "20.19.37","resolved": "https://registry.npmjs.org/@types/node/-/node-20.19.37.tgz",@@ -1623,6 +1775,12 @@"license": "MIT","optional": true},+ "node_modules/@types/unist": {+ "version": "3.0.3",+ "resolved": "https://registry.npmjs.org/@types/unist/-/unist-3.0.3.tgz",+ "integrity": "sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q==",+ "license": "MIT"+ },"node_modules/@typescript-eslint/eslint-plugin": {"version": "8.57.1","resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.57.1.tgz",@@ -1918,6 +2076,12 @@"url": "https://opencollective.com/eslint"}},+ "node_modules/@ungap/structured-clone": {+ "version": "1.4.0",+ "resolved": "https://registry.npmjs.org/@ungap/structured-clone/-/structured-clone-1.4.0.tgz",+ "integrity": "sha512-1mEZtMKPM09vDmQt5y7YvmN2+DFTP7Tg0EWXdic8/C6VRnpb33e4ghisCIE3WZjsE2N8mf+QV1Zqh7ZFYLWInQ==",+ "license": "ISC"+ },"node_modules/@unrs/resolver-binding-android-arm-eabi": {"version": "1.11.1","resolved": "https://registry.npmjs.org/@unrs/resolver-binding-android-arm-eabi/-/resolver-binding-android-arm-eabi-1.11.1.tgz",@@ -2191,7 +2355,6 @@"version": "8.16.0","resolved": "https://registry.npmjs.org/acorn/-/acorn-8.16.0.tgz","integrity": "sha512-UVJyE9MttOsBQIDKw1skb9nAwQuR5wuGD3+82K6JgJlm/Y+KI92oNsMNGZCYdDsVtRHSak0pcV5Dno5+4jh9sw==",- "dev": true,"license": "MIT","bin": {"acorn": "bin/acorn"@@ -2204,7 +2367,6 @@"version": "5.3.2","resolved": "https://registry.npmjs.org/acorn-jsx/-/acorn-jsx-5.3.2.tgz","integrity": "sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==",- "dev": true,"license": "MIT","peerDependencies": {"acorn": "^6.0.0 || ^7.0.0 || ^8.0.0"@@ -2427,6 +2589,15 @@"dev": true,"license": "MIT"},+ "node_modules/astring": {+ "version": "1.9.0",+ "resolved": "https://registry.npmjs.org/astring/-/astring-1.9.0.tgz",+ "integrity": "sha512-LElXdjswlqjWrPpJFg1Fx4wpkOCxj1TDHlSV4PlaRxHGWko024xICaa97ZkMfs6DRKlCguiAI+rbXv5GWwXIkg==",+ "license": "MIT",+ "bin": {+ "astring": "bin/astring"+ }+ },"node_modules/async-function": {"version": "1.0.0","resolved": "https://registry.npmjs.org/async-function/-/async-function-1.0.0.tgz",@@ -2473,6 +2644,16 @@"node": ">= 0.4"}},+ "node_modules/bail": {+ "version": "2.0.2",+ "resolved": "https://registry.npmjs.org/bail/-/bail-2.0.2.tgz",+ "integrity": "sha512-0xO6mYd7JB2YesxDKplafRpsiOzPt9V02ddPCLbY1xYGPOX24NTyN50qnUxgCPcSoYMhKpAuBTjQoRZCAkUDRw==",+ "license": "MIT",+ "funding": {+ "type": "github",+ "url": "https://github.com/sponsors/wooorm"+ }+ },"node_modules/balanced-match": {"version": "1.0.2","resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",@@ -2630,6 +2811,16 @@],"license": "CC-BY-4.0"},+ "node_modules/ccount": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/ccount/-/ccount-2.0.1.tgz",+ "integrity": "sha512-eyrF0jiFpY+3drT6383f1qhkbGsLSifNAjA61IUjZjmLCWjItY6LB9ft9YhoDgwfmclB2zhu51Lc7+95b8NRAg==",+ "license": "MIT",+ "funding": {+ "type": "github",+ "url": "https://github.com/sponsors/wooorm"+ }+ },"node_modules/chalk": {"version": "4.1.2","resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",@@ -2647,12 +2838,62 @@"url": "https://github.com/chalk/chalk?sponsor=1"}},+ "node_modules/character-entities": {+ "version": "2.0.2",+ "resolved": "https://registry.npmjs.org/character-entities/-/character-entities-2.0.2.tgz",+ "integrity": "sha512-shx7oQ0Awen/BRIdkjkvz54PnEEI/EjwXDSIZp86/KKdbafHh1Df/RYGBhn4hbe2+uKC9FnT5UCEdyPz3ai9hQ==",+ "license": "MIT",+ "funding": {+ "type": "github",+ "url": "https://github.com/sponsors/wooorm"+ }+ },+ "node_modules/character-entities-html4": {+ "version": "2.1.0",+ "resolved": "https://registry.npmjs.org/character-entities-html4/-/character-entities-html4-2.1.0.tgz",+ "integrity": "sha512-1v7fgQRj6hnSwFpq1Eu0ynr/CDEw0rXo2B61qXrLNdHZmPKgb7fqS1a2JwF0rISo9q77jDI8VMEHoApn8qDoZA==",+ "license": "MIT",+ "funding": {+ "type": "github",+ "url": "https://github.com/sponsors/wooorm"+ }+ },+ "node_modules/character-entities-legacy": {+ "version": "3.0.0",+ "resolved": "https://registry.npmjs.org/character-entities-legacy/-/character-entities-legacy-3.0.0.tgz",+ "integrity": "sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ==",+ "license": "MIT",+ "funding": {+ "type": "github",+ "url": "https://github.com/sponsors/wooorm"+ }+ },+ "node_modules/character-reference-invalid": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/character-reference-invalid/-/character-reference-invalid-2.0.1.tgz",+ "integrity": "sha512-iBZ4F4wRbyORVsu0jPV7gXkOsGYjGHPmAyv+HiHG8gi5PtC9KI2j1+v8/tlibRvjoWX027ypmG/n0HtO5t7unw==",+ "license": "MIT",+ "funding": {+ "type": "github",+ "url": "https://github.com/sponsors/wooorm"+ }+ },"node_modules/client-only": {"version": "0.0.1","resolved": "https://registry.npmjs.org/client-only/-/client-only-0.0.1.tgz","integrity": "sha512-IV3Ou0jSMzZrd3pZ48nLkT9DA7Ag1pnPzaiQhpW7c3RbcqqzvzzVu+L8gfqMp/8IM2MQtSiqaCxrrcfu8I8rMA==","license": "MIT"},+ "node_modules/collapse-white-space": {+ "version": "2.1.0",+ "resolved": "https://registry.npmjs.org/collapse-white-space/-/collapse-white-space-2.1.0.tgz",+ "integrity": "sha512-loKTxY1zCOuG4j9f6EPnuyyYkf58RnhhWTvRoZEokgB+WbdXehfjFviyOVYkqzEWz1Q5kRiZdBYS5SwxbQYwzw==",+ "license": "MIT",+ "funding": {+ "type": "github",+ "url": "https://github.com/sponsors/wooorm"+ }+ },"node_modules/color-convert": {"version": "2.0.1","resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",@@ -2673,6 +2914,16 @@"dev": true,"license": "MIT"},+ "node_modules/comma-separated-tokens": {+ "version": "2.0.3",+ "resolved": "https://registry.npmjs.org/comma-separated-tokens/-/comma-separated-tokens-2.0.3.tgz",+ "integrity": "sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg==",+ "license": "MIT",+ "funding": {+ "type": "github",+ "url": "https://github.com/sponsors/wooorm"+ }+ },"node_modules/concat-map": {"version": "0.0.1","resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz",@@ -2788,7 +3039,6 @@"version": "4.4.3","resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz","integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",- "dev": true,"license": "MIT","dependencies": {"ms": "^2.1.3"@@ -2802,6 +3052,19 @@}}},+ "node_modules/decode-named-character-reference": {+ "version": "1.3.0",+ "resolved": "https://registry.npmjs.org/decode-named-character-reference/-/decode-named-character-reference-1.3.0.tgz",+ "integrity": "sha512-GtpQYB283KrPp6nRw50q3U9/VfOutZOe103qlN7BPP6Ad27xYnOIWv4lPzo8HCAL+mMZofJ9KEy30fq6MfaK6Q==",+ "license": "MIT",+ "dependencies": {+ "character-entities": "^2.0.0"+ },+ "funding": {+ "type": "github",+ "url": "https://github.com/sponsors/wooorm"+ }+ },"node_modules/deep-is": {"version": "0.1.4","resolved": "https://registry.npmjs.org/deep-is/-/deep-is-0.1.4.tgz",@@ -2845,6 +3108,15 @@"url": "https://github.com/sponsors/ljharb"}},+ "node_modules/dequal": {+ "version": "2.0.3",+ "resolved": "https://registry.npmjs.org/dequal/-/dequal-2.0.3.tgz",+ "integrity": "sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA==",+ "license": "MIT",+ "engines": {+ "node": ">=6"+ }+ },"node_modules/detect-libc": {"version": "2.1.2","resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz",@@ -2855,6 +3127,19 @@"node": ">=8"}},+ "node_modules/devlop": {+ "version": "1.1.0",+ "resolved": "https://registry.npmjs.org/devlop/-/devlop-1.1.0.tgz",+ "integrity": "sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA==",+ "license": "MIT",+ "dependencies": {+ "dequal": "^2.0.0"+ },+ "funding": {+ "type": "github",+ "url": "https://github.com/sponsors/wooorm"+ }+ },"node_modules/doctrine": {"version": "2.1.0","resolved": "https://registry.npmjs.org/doctrine/-/doctrine-2.1.0.tgz",@@ -3098,6 +3383,38 @@"url": "https://github.com/sponsors/ljharb"}},+ "node_modules/esast-util-from-estree": {+ "version": "2.0.0",+ "resolved": "https://registry.npmjs.org/esast-util-from-estree/-/esast-util-from-estree-2.0.0.tgz",+ "integrity": "sha512-4CyanoAudUSBAn5K13H4JhsMH6L9ZP7XbLVe/dKybkxMO7eDyLsT8UHl9TRNrU2Gr9nz+FovfSIjuXWJ81uVwQ==",+ "license": "MIT",+ "dependencies": {+ "@types/estree-jsx": "^1.0.0",+ "devlop": "^1.0.0",+ "estree-util-visit": "^2.0.0",+ "unist-util-position-from-estree": "^2.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/esast-util-from-js": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/esast-util-from-js/-/esast-util-from-js-2.0.1.tgz",+ "integrity": "sha512-8Ja+rNJ0Lt56Pcf3TAmpBZjmx8ZcK5Ts4cAzIOjsjevg9oSXJnl6SUQ2EevU8tv3h6ZLWmoKL5H4fgWvdvfETw==",+ "license": "MIT",+ "dependencies": {+ "@types/estree-jsx": "^1.0.0",+ "acorn": "^8.0.0",+ "esast-util-from-estree": "^2.0.0",+ "vfile-message": "^4.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },"node_modules/escalade": {"version": "3.2.0","resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz",@@ -3541,6 +3858,97 @@"node": ">=4.0"}},+ "node_modules/estree-util-attach-comments": {+ "version": "3.0.0",+ "resolved": "https://registry.npmjs.org/estree-util-attach-comments/-/estree-util-attach-comments-3.0.0.tgz",+ "integrity": "sha512-cKUwm/HUcTDsYh/9FgnuFqpfquUbwIqwKM26BVCGDPVgvaCl/nDCCjUfiLlx6lsEZ3Z4RFxNbOQ60pkaEwFxGw==",+ "license": "MIT",+ "dependencies": {+ "@types/estree": "^1.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/estree-util-build-jsx": {+ "version": "3.0.1",+ "resolved": "https://registry.npmjs.org/estree-util-build-jsx/-/estree-util-build-jsx-3.0.1.tgz",+ "integrity": "sha512-8U5eiL6BTrPxp/CHbs2yMgP8ftMhR5ww1eIKoWRMlqvltHF8fZn5LRDvTKuxD3DUn+shRbLGqXemcP51oFCsGQ==",+ "license": "MIT",+ "dependencies": {+ "@types/estree-jsx": "^1.0.0",+ "devlop": "^1.0.0",+ "estree-util-is-identifier-name": "^3.0.0",+ "estree-walker": "^3.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/estree-util-is-identifier-name": {+ "version": "3.0.0",+ "resolved": "https://registry.npmjs.org/estree-util-is-identifier-name/-/estree-util-is-identifier-name-3.0.0.tgz",+ "integrity": "sha512-hFtqIDZTIUZ9BXLb8y4pYGyk6+wekIivNVTcmvk8NoOh+VeRn5y6cEHzbURrWbfp1fIqdVipilzj+lfaadNZmg==",+ "license": "MIT",+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/estree-util-scope": {+ "version": "1.0.1",+ "resolved": "https://registry.npmjs.org/estree-util-scope/-/estree-util-scope-1.0.1.tgz",+ "integrity": "sha512-B0np3dcdxqILX5e9nEi5/Fr4K7gL4oYFVPV1zRa2e9wRCbQoZZNWOZFYyoInvXUPJXBXjss+QXlWLJChDEHDkA==",+ "license": "MIT",+ "dependencies": {+ "@types/estree": "^1.0.0",+ "devlop": "^1.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/estree-util-to-js": {+ "version": "2.0.0",+ "resolved": "https://registry.npmjs.org/estree-util-to-js/-/estree-util-to-js-2.0.0.tgz",+ "integrity": "sha512-WDF+xj5rRWmD5tj6bIqRi6CkLIXbbNQUcxQHzGysQzvHmdYG2G7p/Tf0J0gpxGgkeMZNTIjT/AoSvC9Xehcgdg==",+ "license": "MIT",+ "dependencies": {+ "@types/estree-jsx": "^1.0.0",+ "astring": "^1.8.0",+ "source-map": "^0.7.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/estree-util-visit": {+ "version": "2.0.0",+ "resolved": "https://registry.npmjs.org/estree-util-visit/-/estree-util-visit-2.0.0.tgz",+ "integrity": "sha512-m5KgiH85xAhhW8Wta0vShLcUvOsh3LLPI2YVwcbio1l7E09NTLL1EyMZFM1OyWowoH0skScNbhOPl4kcBgzTww==",+ "license": "MIT",+ "dependencies": {+ "@types/estree-jsx": "^1.0.0",+ "@types/unist": "^3.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/estree-walker": {+ "version": "3.0.3",+ "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-3.0.3.tgz",+ "integrity": "sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==",+ "license": "MIT",+ "dependencies": {+ "@types/estree": "^1.0.0"+ }+ },"node_modules/esutils": {"version": "2.0.3","resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz",@@ -3551,6 +3959,12 @@"node": ">=0.10.0"}},+ "node_modules/extend": {+ "version": "3.0.2",+ "resolved": "https://registry.npmjs.org/extend/-/extend-3.0.2.tgz",+ "integrity": "sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==",+ "license": "MIT"+ },"node_modules/fast-deep-equal": {"version": "3.1.3","resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",@@ -3856,6 +4270,12 @@"url": "https://github.com/privatenumber/get-tsconfig?sponsor=1"}},+ "node_modules/github-slugger": {+ "version": "2.0.0",+ "resolved": "https://registry.npmjs.org/github-slugger/-/github-slugger-2.0.0.tgz",+ "integrity": "sha512-IaOQ9puYtjrkq7Y0Ygl9KDZnrf/aiUJYUpVf89y8kyaxbRG7Y1SrX/jaumrv81vc61+kiMempujsM3Yw7w5qcw==",+ "license": "ISC"+ },"node_modules/glob-parent": {"version": "6.0.2","resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz",@@ -4013,37 +4433,131 @@"node": ">= 0.4"}},- "node_modules/hermes-estree": {- "version": "0.25.1",- "resolved": "https://registry.npmjs.org/hermes-estree/-/hermes-estree-0.25.1.tgz",- "integrity": "sha512-0wUoCcLp+5Ev5pDW2OriHC2MJCbwLwuRx+gAqMTOkGKJJiBCLjtrvy4PWUGn6MIVefecRpzoOZ/UV6iGdOr+Cw==",- "dev": true,- "license": "MIT"- },- "node_modules/hermes-parser": {- "version": "0.25.1",- "resolved": "https://registry.npmjs.org/hermes-parser/-/hermes-parser-0.25.1.tgz",- "integrity": "sha512-6pEjquH3rqaI6cYAXYPcz9MS4rY6R4ngRgrgfDshRptUZIc3lw0MCIJIGDj9++mfySOuPTHB4nrSW99BCvOPIA==",- "dev": true,+ "node_modules/hast-util-heading-rank": {+ "version": "3.0.0",+ "resolved": "https://registry.npmjs.org/hast-util-heading-rank/-/hast-util-heading-rank-3.0.0.tgz",+ "integrity": "sha512-EJKb8oMUXVHcWZTDepnr+WNbfnXKFNf9duMesmr4S8SXTJBJ9M4Yok08pu9vxdJwdlGRhVumk9mEhkEvKGifwA==","license": "MIT","dependencies": {- "hermes-estree": "0.25.1"+ "@types/hast": "^3.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"}},- "node_modules/ignore": {- "version": "5.3.2",- "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz",- "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==",- "dev": true,- "license": "MIT",- "engines": {- "node": ">= 4"+ "node_modules/hast-util-to-estree": {+ "version": "3.1.3",+ "resolved": "https://registry.npmjs.org/hast-util-to-estree/-/hast-util-to-estree-3.1.3.tgz",+ "integrity": "sha512-48+B/rJWAp0jamNbAAf9M7Uf//UVqAoMmgXhBdxTDJLGKY+LRnZ99qcG+Qjl5HfMpYNzS5v4EAwVEF34LeAj7w==",+ "license": "MIT",+ "dependencies": {+ "@types/estree": "^1.0.0",+ "@types/estree-jsx": "^1.0.0",+ "@types/hast": "^3.0.0",+ "comma-separated-tokens": "^2.0.0",+ "devlop": "^1.0.0",+ "estree-util-attach-comments": "^3.0.0",+ "estree-util-is-identifier-name": "^3.0.0",+ "hast-util-whitespace": "^3.0.0",+ "mdast-util-mdx-expression": "^2.0.0",+ "mdast-util-mdx-jsx": "^3.0.0",+ "mdast-util-mdxjs-esm": "^2.0.0",+ "property-information": "^7.0.0",+ "space-separated-tokens": "^2.0.0",+ "style-to-js": "^1.0.0",+ "unist-util-position": "^5.0.0",+ "zwitch": "^2.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"}},- "node_modules/import-fresh": {- "version": "3.3.1",- "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-3.3.1.tgz",- "integrity": "sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==",+ "node_modules/hast-util-to-jsx-runtime": {+ "version": "2.3.6",+ "resolved": "https://registry.npmjs.org/hast-util-to-jsx-runtime/-/hast-util-to-jsx-runtime-2.3.6.tgz",+ "integrity": "sha512-zl6s8LwNyo1P9uw+XJGvZtdFF1GdAkOg8ujOw+4Pyb76874fLps4ueHXDhXWdk6YHQ6OgUtinliG7RsYvCbbBg==",+ "license": "MIT",+ "dependencies": {+ "@types/estree": "^1.0.0",+ "@types/hast": "^3.0.0",+ "@types/unist": "^3.0.0",+ "comma-separated-tokens": "^2.0.0",+ "devlop": "^1.0.0",+ "estree-util-is-identifier-name": "^3.0.0",+ "hast-util-whitespace": "^3.0.0",+ "mdast-util-mdx-expression": "^2.0.0",+ "mdast-util-mdx-jsx": "^3.0.0",+ "mdast-util-mdxjs-esm": "^2.0.0",+ "property-information": "^7.0.0",+ "space-separated-tokens": "^2.0.0",+ "style-to-js": "^1.0.0",+ "unist-util-position": "^5.0.0",+ "vfile-message": "^4.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/hast-util-to-string": {+ "version": "3.0.1",+ "resolved": "https://registry.npmjs.org/hast-util-to-string/-/hast-util-to-string-3.0.1.tgz",+ "integrity": "sha512-XelQVTDWvqcl3axRfI0xSeoVKzyIFPwsAGSLIsKdJKQMXDYJS4WYrBNF/8J7RdhIcFI2BOHgAifggsvsxp/3+A==",+ "license": "MIT",+ "dependencies": {+ "@types/hast": "^3.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/hast-util-whitespace": {+ "version": "3.0.0",+ "resolved": "https://registry.npmjs.org/hast-util-whitespace/-/hast-util-whitespace-3.0.0.tgz",+ "integrity": "sha512-88JUN06ipLwsnv+dVn+OIYOvAuvBMy/Qoi6O7mQHxdPXpjy+Cd6xRkWwux7DKO+4sYILtLBRIKgsdpS2gQc7qw==",+ "license": "MIT",+ "dependencies": {+ "@types/hast": "^3.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/hermes-estree": {+ "version": "0.25.1",+ "resolved": "https://registry.npmjs.org/hermes-estree/-/hermes-estree-0.25.1.tgz",+ "integrity": "sha512-0wUoCcLp+5Ev5pDW2OriHC2MJCbwLwuRx+gAqMTOkGKJJiBCLjtrvy4PWUGn6MIVefecRpzoOZ/UV6iGdOr+Cw==",+ "dev": true,+ "license": "MIT"+ },+ "node_modules/hermes-parser": {+ "version": "0.25.1",+ "resolved": "https://registry.npmjs.org/hermes-parser/-/hermes-parser-0.25.1.tgz",+ "integrity": "sha512-6pEjquH3rqaI6cYAXYPcz9MS4rY6R4ngRgrgfDshRptUZIc3lw0MCIJIGDj9++mfySOuPTHB4nrSW99BCvOPIA==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "hermes-estree": "0.25.1"+ }+ },+ "node_modules/ignore": {+ "version": "5.3.2",+ "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz",+ "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">= 4"+ }+ },+ "node_modules/import-fresh": {+ "version": "3.3.1",+ "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-3.3.1.tgz",+ "integrity": "sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==","dev": true,"license": "MIT","dependencies": {@@ -4067,6 +4581,12 @@"node": ">=0.8.19"}},+ "node_modules/inline-style-parser": {+ "version": "0.2.7",+ "resolved": "https://registry.npmjs.org/inline-style-parser/-/inline-style-parser-0.2.7.tgz",+ "integrity": "sha512-Nb2ctOyNR8DqQoR0OwRG95uNWIC0C1lCgf5Naz5H6Ji72KZ8OcFZLz2P5sNgwlyoJ8Yif11oMuYs5pBQa86csA==",+ "license": "MIT"+ },"node_modules/internal-slot": {"version": "1.1.0","resolved": "https://registry.npmjs.org/internal-slot/-/internal-slot-1.1.0.tgz",@@ -4082,6 +4602,30 @@"node": ">= 0.4"}},+ "node_modules/is-alphabetical": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/is-alphabetical/-/is-alphabetical-2.0.1.tgz",+ "integrity": "sha512-FWyyY60MeTNyeSRpkM2Iry0G9hpr7/9kD40mD/cGQEuilcZYS4okz8SN2Q6rLCJ8gbCt6fN+rC+6tMGS99LaxQ==",+ "license": "MIT",+ "funding": {+ "type": "github",+ "url": "https://github.com/sponsors/wooorm"+ }+ },+ "node_modules/is-alphanumerical": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/is-alphanumerical/-/is-alphanumerical-2.0.1.tgz",+ "integrity": "sha512-hmbYhX/9MUMF5uh7tOXyK/n0ZvWpad5caBA17GsC6vyuCqaWliRG5K1qS9inmUhEMaOBIW7/whAnSwveW/LtZw==",+ "license": "MIT",+ "dependencies": {+ "is-alphabetical": "^2.0.0",+ "is-decimal": "^2.0.0"+ },+ "funding": {+ "type": "github",+ "url": "https://github.com/sponsors/wooorm"+ }+ },"node_modules/is-array-buffer": {"version": "3.0.5","resolved": "https://registry.npmjs.org/is-array-buffer/-/is-array-buffer-3.0.5.tgz",@@ -4240,6 +4784,16 @@"url": "https://github.com/sponsors/ljharb"}},+ "node_modules/is-decimal": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/is-decimal/-/is-decimal-2.0.1.tgz",+ "integrity": "sha512-AAB9hiomQs5DXWcRB1rqsxGUstbRroFOPPVAomNk/3XHR5JyEZChOyTWe2oayKnsSsr/kcGqF+z6yuH6HHpN0A==",+ "license": "MIT",+ "funding": {+ "type": "github",+ "url": "https://github.com/sponsors/wooorm"+ }+ },"node_modules/is-extglob": {"version": "2.1.1","resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz",@@ -4299,6 +4853,16 @@"node": ">=0.10.0"}},+ "node_modules/is-hexadecimal": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/is-hexadecimal/-/is-hexadecimal-2.0.1.tgz",+ "integrity": "sha512-DgZQp241c8oO6cA1SbTEWiXeoxV42vlcJxgH+B3hi1AiqqKruZR3ZGF8In3fj4+/y/7rHvlOZLZtgJ/4ttYGZg==",+ "license": "MIT",+ "funding": {+ "type": "github",+ "url": "https://github.com/sponsors/wooorm"+ }+ },"node_modules/is-map": {"version": "2.0.3","resolved": "https://registry.npmjs.org/is-map/-/is-map-2.0.3.tgz",@@ -4352,6 +4916,18 @@"url": "https://github.com/sponsors/ljharb"}},+ "node_modules/is-plain-obj": {+ "version": "4.1.0",+ "resolved": "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-4.1.0.tgz",+ "integrity": "sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg==",+ "license": "MIT",+ "engines": {+ "node": ">=12"+ },+ "funding": {+ "url": "https://github.com/sponsors/sindresorhus"+ }+ },"node_modules/is-regex": {"version": "1.2.1","resolved": "https://registry.npmjs.org/is-regex/-/is-regex-1.2.1.tgz",@@ -4950,6 +5526,16 @@"dev": true,"license": "MIT"},+ "node_modules/longest-streak": {+ "version": "3.1.0",+ "resolved": "https://registry.npmjs.org/longest-streak/-/longest-streak-3.1.0.tgz",+ "integrity": "sha512-9Ri+o0JYgehTaVBBDoMqIl8GXtbWg711O3srftcHhZ0dqnETqLaoIK0x17fUw9rFSlK/0NlsKe0Ahhyl5pXE2g==",+ "license": "MIT",+ "funding": {+ "type": "github",+ "url": "https://github.com/sponsors/wooorm"+ }+ },"node_modules/loose-envify": {"version": "1.4.0","resolved": "https://registry.npmjs.org/loose-envify/-/loose-envify-1.4.0.tgz",@@ -4983,26 +5569,1087 @@"@jridgewell/sourcemap-codec": "^1.5.5"}},+ "node_modules/markdown-extensions": {+ "version": "2.0.0",+ "resolved": "https://registry.npmjs.org/markdown-extensions/-/markdown-extensions-2.0.0.tgz",+ "integrity": "sha512-o5vL7aDWatOTX8LzaS1WMoaoxIiLRQJuIKKe2wAw6IeULDHaqbiqiggmx+pKvZDb1Sj+pE46Sn1T7lCqfFtg1Q==",+ "license": "MIT",+ "engines": {+ "node": ">=16"+ },+ "funding": {+ "url": "https://github.com/sponsors/sindresorhus"+ }+ },+ "node_modules/markdown-table": {+ "version": "3.0.4",+ "resolved": "https://registry.npmjs.org/markdown-table/-/markdown-table-3.0.4.tgz",+ "integrity": "sha512-wiYz4+JrLyb/DqW2hkFJxP7Vd7JuTDm77fvbM8VfEQdmSMqcImWeeRbHwZjBjIFki/VaMK2BhFi7oUUZeM5bqw==",+ "license": "MIT",+ "funding": {+ "type": "github",+ "url": "https://github.com/sponsors/wooorm"+ }+ },"node_modules/math-intrinsics": {"version": "1.1.0","resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz","integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==","dev": true,"license": "MIT",- "engines": {- "node": ">= 0.4"+ "engines": {+ "node": ">= 0.4"+ }+ },+ "node_modules/mdast-util-find-and-replace": {+ "version": "3.0.3",+ "resolved": "https://registry.npmjs.org/mdast-util-find-and-replace/-/mdast-util-find-and-replace-3.0.3.tgz",+ "integrity": "sha512-xPgpDNl0/OXHsI7TlaIs22lWnH3KlpvZdXG1ET/m/YT2Hhdkx8lJV4kLphE6l9simyM4KPDFBwas08BgEob6Jw==",+ "license": "MIT",+ "dependencies": {+ "@types/mdast": "^4.0.0",+ "escape-string-regexp": "^5.0.0",+ "unist-util-is": "^6.0.0",+ "unist-util-visit-parents": "^6.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/mdast-util-find-and-replace/node_modules/escape-string-regexp": {+ "version": "5.0.0",+ "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-5.0.0.tgz",+ "integrity": "sha512-/veY75JbMK4j1yjvuUxuVsiS/hr/4iHs9FTT6cgTexxdE0Ly/glccBAkloH/DofkjRbZU3bnoj38mOmhkZ0lHw==",+ "license": "MIT",+ "engines": {+ "node": ">=12"+ },+ "funding": {+ "url": "https://github.com/sponsors/sindresorhus"+ }+ },+ "node_modules/mdast-util-from-markdown": {+ "version": "2.1.0",+ "resolved": "https://registry.npmjs.org/mdast-util-from-markdown/-/mdast-util-from-markdown-2.1.0.tgz",+ "integrity": "sha512-KRLgmPaP2H1ul2bpoJkOS+9pAcDAAj9Nu1mqLnh8NLeJG5tlvj42TH80PIGBpROWlRXLk0lDrWNuZCFy/tsB4A==",+ "license": "MIT",+ "dependencies": {+ "@types/mdast": "^4.0.0",+ "@types/unist": "^3.0.0",+ "decode-named-character-reference": "^1.0.0",+ "devlop": "^1.0.0",+ "mdast-util-to-string": "^4.0.0",+ "micromark": "^4.0.0",+ "micromark-util-decode-numeric-character-reference": "^2.0.0",+ "micromark-util-decode-string": "^2.0.0",+ "micromark-util-normalize-identifier": "^2.0.0",+ "micromark-util-symbol": "^2.0.0",+ "micromark-util-types": "^2.0.0",+ "unist-util-stringify-position": "^4.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/mdast-util-gfm": {+ "version": "3.1.0",+ "resolved": "https://registry.npmjs.org/mdast-util-gfm/-/mdast-util-gfm-3.1.0.tgz",+ "integrity": "sha512-0ulfdQOM3ysHhCJ1p06l0b0VKlhU0wuQs3thxZQagjcjPrlFRqY215uZGHHJan9GEAXd9MbfPjFJz+qMkVR6zQ==",+ "license": "MIT",+ "dependencies": {+ "mdast-util-from-markdown": "^2.0.0",+ "mdast-util-gfm-autolink-literal": "^2.0.0",+ "mdast-util-gfm-footnote": "^2.0.0",+ "mdast-util-gfm-strikethrough": "^2.0.0",+ "mdast-util-gfm-table": "^2.0.0",+ "mdast-util-gfm-task-list-item": "^2.0.0",+ "mdast-util-to-markdown": "^2.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/mdast-util-gfm-autolink-literal": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/mdast-util-gfm-autolink-literal/-/mdast-util-gfm-autolink-literal-2.0.1.tgz",+ "integrity": "sha512-5HVP2MKaP6L+G6YaxPNjuL0BPrq9orG3TsrZ9YXbA3vDw/ACI4MEsnoDpn6ZNm7GnZgtAcONJyPhOP8tNJQavQ==",+ "license": "MIT",+ "dependencies": {+ "@types/mdast": "^4.0.0",+ "ccount": "^2.0.0",+ "devlop": "^1.0.0",+ "mdast-util-find-and-replace": "^3.0.0",+ "micromark-util-character": "^2.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/mdast-util-gfm-footnote": {+ "version": "2.1.0",+ "resolved": "https://registry.npmjs.org/mdast-util-gfm-footnote/-/mdast-util-gfm-footnote-2.1.0.tgz",+ "integrity": "sha512-sqpDWlsHn7Ac9GNZQMeUzPQSMzR6Wv0WKRNvQRg0KqHh02fpTz69Qc1QSseNX29bhz1ROIyNyxExfawVKTm1GQ==",+ "license": "MIT",+ "dependencies": {+ "@types/mdast": "^4.0.0",+ "devlop": "^1.1.0",+ "mdast-util-from-markdown": "^2.0.0",+ "mdast-util-to-markdown": "^2.0.0",+ "micromark-util-normalize-identifier": "^2.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/mdast-util-gfm-strikethrough": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/mdast-util-gfm-strikethrough/-/mdast-util-gfm-strikethrough-2.0.1.tgz",+ "integrity": "sha512-OuJHqvr455pwu2OaOrir7dbzqs4jlWKOtlu9L6GjcIjjQwNyw02VntQsr/Ek6/A13vgnXfUhBekWRUP1OkNivw==",+ "license": "MIT",+ "dependencies": {+ "@types/mdast": "^4.0.0",+ "mdast-util-from-markdown": "^2.0.0",+ "mdast-util-to-markdown": "^2.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/mdast-util-gfm-table": {+ "version": "2.0.0",+ "resolved": "https://registry.npmjs.org/mdast-util-gfm-table/-/mdast-util-gfm-table-2.0.0.tgz",+ "integrity": "sha512-78UEvebzz/rJIxLvE7ZtDd/vIQ0RHv+3Mh5DR96p7cS7HsBhYIICDBCu8csTNWNO6tBWfqXPWekRuj2FNOGOZg==",+ "license": "MIT",+ "dependencies": {+ "@types/mdast": "^4.0.0",+ "devlop": "^1.0.0",+ "markdown-table": "^3.0.0",+ "mdast-util-from-markdown": "^2.0.0",+ "mdast-util-to-markdown": "^2.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/mdast-util-gfm-task-list-item": {+ "version": "2.0.0",+ "resolved": "https://registry.npmjs.org/mdast-util-gfm-task-list-item/-/mdast-util-gfm-task-list-item-2.0.0.tgz",+ "integrity": "sha512-IrtvNvjxC1o06taBAVJznEnkiHxLFTzgonUdy8hzFVeDun0uTjxxrRGVaNFqkU1wJR3RBPEfsxmU6jDWPofrTQ==",+ "license": "MIT",+ "dependencies": {+ "@types/mdast": "^4.0.0",+ "devlop": "^1.0.0",+ "mdast-util-from-markdown": "^2.0.0",+ "mdast-util-to-markdown": "^2.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/mdast-util-mdx": {+ "version": "3.0.0",+ "resolved": "https://registry.npmjs.org/mdast-util-mdx/-/mdast-util-mdx-3.0.0.tgz",+ "integrity": "sha512-JfbYLAW7XnYTTbUsmpu0kdBUVe+yKVJZBItEjwyYJiDJuZ9w4eeaqks4HQO+R7objWgS2ymV60GYpI14Ug554w==",+ "license": "MIT",+ "dependencies": {+ "mdast-util-from-markdown": "^2.0.0",+ "mdast-util-mdx-expression": "^2.0.0",+ "mdast-util-mdx-jsx": "^3.0.0",+ "mdast-util-mdxjs-esm": "^2.0.0",+ "mdast-util-to-markdown": "^2.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/mdast-util-mdx-expression": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/mdast-util-mdx-expression/-/mdast-util-mdx-expression-2.0.1.tgz",+ "integrity": "sha512-J6f+9hUp+ldTZqKRSg7Vw5V6MqjATc+3E4gf3CFNcuZNWD8XdyI6zQ8GqH7f8169MM6P7hMBRDVGnn7oHB9kXQ==",+ "license": "MIT",+ "dependencies": {+ "@types/estree-jsx": "^1.0.0",+ "@types/hast": "^3.0.0",+ "@types/mdast": "^4.0.0",+ "devlop": "^1.0.0",+ "mdast-util-from-markdown": "^2.0.0",+ "mdast-util-to-markdown": "^2.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/mdast-util-mdx-jsx": {+ "version": "3.2.0",+ "resolved": "https://registry.npmjs.org/mdast-util-mdx-jsx/-/mdast-util-mdx-jsx-3.2.0.tgz",+ "integrity": "sha512-lj/z8v0r6ZtsN/cGNNtemmmfoLAFZnjMbNyLzBafjzikOM+glrjNHPlf6lQDOTccj9n5b0PPihEBbhneMyGs1Q==",+ "license": "MIT",+ "dependencies": {+ "@types/estree-jsx": "^1.0.0",+ "@types/hast": "^3.0.0",+ "@types/mdast": "^4.0.0",+ "@types/unist": "^3.0.0",+ "ccount": "^2.0.0",+ "devlop": "^1.1.0",+ "mdast-util-from-markdown": "^2.0.0",+ "mdast-util-to-markdown": "^2.0.0",+ "parse-entities": "^4.0.0",+ "stringify-entities": "^4.0.0",+ "unist-util-stringify-position": "^4.0.0",+ "vfile-message": "^4.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/mdast-util-mdxjs-esm": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/mdast-util-mdxjs-esm/-/mdast-util-mdxjs-esm-2.0.1.tgz",+ "integrity": "sha512-EcmOpxsZ96CvlP03NghtH1EsLtr0n9Tm4lPUJUBccV9RwUOneqSycg19n5HGzCf+10LozMRSObtVr3ee1WoHtg==",+ "license": "MIT",+ "dependencies": {+ "@types/estree-jsx": "^1.0.0",+ "@types/hast": "^3.0.0",+ "@types/mdast": "^4.0.0",+ "devlop": "^1.0.0",+ "mdast-util-from-markdown": "^2.0.0",+ "mdast-util-to-markdown": "^2.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/mdast-util-phrasing": {+ "version": "4.1.0",+ "resolved": "https://registry.npmjs.org/mdast-util-phrasing/-/mdast-util-phrasing-4.1.0.tgz",+ "integrity": "sha512-TqICwyvJJpBwvGAMZjj4J2n0X8QWp21b9l0o7eXyVJ25YNWYbJDVIyD1bZXE6WtV6RmKJVYmQAKWa0zWOABz2w==",+ "license": "MIT",+ "dependencies": {+ "@types/mdast": "^4.0.0",+ "unist-util-is": "^6.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/mdast-util-to-hast": {+ "version": "13.2.1",+ "resolved": "https://registry.npmjs.org/mdast-util-to-hast/-/mdast-util-to-hast-13.2.1.tgz",+ "integrity": "sha512-cctsq2wp5vTsLIcaymblUriiTcZd0CwWtCbLvrOzYCDZoWyMNV8sZ7krj09FSnsiJi3WVsHLM4k6Dq/yaPyCXA==",+ "license": "MIT",+ "dependencies": {+ "@types/hast": "^3.0.0",+ "@types/mdast": "^4.0.0",+ "@ungap/structured-clone": "^1.0.0",+ "devlop": "^1.0.0",+ "micromark-util-sanitize-uri": "^2.0.0",+ "trim-lines": "^3.0.0",+ "unist-util-position": "^5.0.0",+ "unist-util-visit": "^5.0.0",+ "vfile": "^6.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/mdast-util-to-markdown": {+ "version": "2.2.0",+ "resolved": "https://registry.npmjs.org/mdast-util-to-markdown/-/mdast-util-to-markdown-2.2.0.tgz",+ "integrity": "sha512-2Jn/ADrHFFyyniBMi0bncTbJqU78K3/TEYvzvwrWWzD9MYPUa/Gm4r3nOeKFQg/PDM5BsbDYdc8ackW4NTY6NA==",+ "license": "MIT",+ "dependencies": {+ "@types/mdast": "^4.0.0",+ "@types/unist": "^3.0.0",+ "longest-streak": "^3.0.0",+ "mdast-util-phrasing": "^4.0.0",+ "mdast-util-to-string": "^4.0.0",+ "micromark-util-character": "^2.0.0",+ "micromark-util-classify-character": "^2.0.0",+ "micromark-util-decode-string": "^2.0.0",+ "micromark-util-html-tag-name": "^2.0.0",+ "unist-util-visit": "^5.0.0",+ "zwitch": "^2.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/mdast-util-to-string": {+ "version": "4.0.0",+ "resolved": "https://registry.npmjs.org/mdast-util-to-string/-/mdast-util-to-string-4.0.0.tgz",+ "integrity": "sha512-0H44vDimn51F0YwvxSJSm0eCDOJTRlmN0R1yBh4HLj9wiV1Dn0QoXGbvFAWj2hSItVTlCmBF1hqKlIyUBVFLPg==",+ "license": "MIT",+ "dependencies": {+ "@types/mdast": "^4.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/merge2": {+ "version": "1.4.1",+ "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz",+ "integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">= 8"+ }+ },+ "node_modules/micromark": {+ "version": "4.0.3",+ "resolved": "https://registry.npmjs.org/micromark/-/micromark-4.0.3.tgz",+ "integrity": "sha512-oGYfQzHSG5dOMovQcJ3fyTmZlWAWpi0XA0sJwJs+i6OT88o1+Jtw/8z0CmdowSLxGhhFK89rQ/oXph/wN02PNw==",+ "funding": [+ {+ "type": "GitHub Sponsors",+ "url": "https://github.com/sponsors/unifiedjs"+ },+ {+ "type": "OpenCollective",+ "url": "https://opencollective.com/unified"+ }+ ],+ "license": "MIT",+ "dependencies": {+ "@types/debug": "^4.0.0",+ "debug": "^4.0.0",+ "decode-named-character-reference": "^1.0.0",+ "devlop": "^1.0.0",+ "micromark-core-commonmark": "^2.0.0",+ "micromark-factory-space": "^2.0.0",+ "micromark-util-character": "^2.0.0",+ "micromark-util-chunked": "^2.0.0",+ "micromark-util-combine-extensions": "^2.0.0",+ "micromark-util-decode-numeric-character-reference": "^2.0.0",+ "micromark-util-edit-map": "^1.0.0",+ "micromark-util-encode": "^2.0.0",+ "micromark-util-normalize-identifier": "^2.0.0",+ "micromark-util-resolve-all": "^2.0.0",+ "micromark-util-sanitize-uri": "^2.0.0",+ "micromark-util-subtokenize": "^2.0.0",+ "micromark-util-symbol": "^2.0.0",+ "micromark-util-types": "^2.0.0"+ }+ },+ "node_modules/micromark-core-commonmark": {+ "version": "2.0.4",+ "resolved": "https://registry.npmjs.org/micromark-core-commonmark/-/micromark-core-commonmark-2.0.4.tgz",+ "integrity": "sha512-wxEeE8v8XVvOrxn1TZj74qYhAtTQsSqufHVS3uNVyT1MupXxhyaHk8/9xDNPh9BmL77QNDgWTkZ3RsYHB2ry7w==",+ "funding": [+ {+ "type": "GitHub Sponsors",+ "url": "https://github.com/sponsors/unifiedjs"+ },+ {+ "type": "OpenCollective",+ "url": "https://opencollective.com/unified"+ }+ ],+ "license": "MIT",+ "dependencies": {+ "decode-named-character-reference": "^1.0.0",+ "devlop": "^1.0.0",+ "micromark-factory-destination": "^2.0.0",+ "micromark-factory-label": "^2.0.0",+ "micromark-factory-space": "^2.1.0",+ "micromark-factory-title": "^2.0.0",+ "micromark-factory-whitespace": "^2.0.0",+ "micromark-util-character": "^2.0.0",+ "micromark-util-chunked": "^2.0.0",+ "micromark-util-classify-character": "^2.0.0",+ "micromark-util-edit-map": "^1.0.0",+ "micromark-util-html-tag-name": "^2.0.0",+ "micromark-util-normalize-identifier": "^2.0.0",+ "micromark-util-resolve-all": "^2.0.0",+ "micromark-util-subtokenize": "^2.0.0",+ "micromark-util-symbol": "^2.0.0",+ "micromark-util-types": "^2.0.3"+ }+ },+ "node_modules/micromark-extension-gfm": {+ "version": "3.0.0",+ "resolved": "https://registry.npmjs.org/micromark-extension-gfm/-/micromark-extension-gfm-3.0.0.tgz",+ "integrity": "sha512-vsKArQsicm7t0z2GugkCKtZehqUm31oeGBV/KVSorWSy8ZlNAv7ytjFhvaryUiCUJYqs+NoE6AFhpQvBTM6Q4w==",+ "license": "MIT",+ "dependencies": {+ "micromark-extension-gfm-autolink-literal": "^2.0.0",+ "micromark-extension-gfm-footnote": "^2.0.0",+ "micromark-extension-gfm-strikethrough": "^2.0.0",+ "micromark-extension-gfm-table": "^2.0.0",+ "micromark-extension-gfm-tagfilter": "^2.0.0",+ "micromark-extension-gfm-task-list-item": "^2.0.0",+ "micromark-util-combine-extensions": "^2.0.0",+ "micromark-util-types": "^2.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/micromark-extension-gfm-autolink-literal": {+ "version": "2.1.0",+ "resolved": "https://registry.npmjs.org/micromark-extension-gfm-autolink-literal/-/micromark-extension-gfm-autolink-literal-2.1.0.tgz",+ "integrity": "sha512-oOg7knzhicgQ3t4QCjCWgTmfNhvQbDDnJeVu9v81r7NltNCVmhPy1fJRX27pISafdjL+SVc4d3l48Gb6pbRypw==",+ "license": "MIT",+ "dependencies": {+ "micromark-util-character": "^2.0.0",+ "micromark-util-sanitize-uri": "^2.0.0",+ "micromark-util-symbol": "^2.0.0",+ "micromark-util-types": "^2.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/micromark-extension-gfm-footnote": {+ "version": "2.1.0",+ "resolved": "https://registry.npmjs.org/micromark-extension-gfm-footnote/-/micromark-extension-gfm-footnote-2.1.0.tgz",+ "integrity": "sha512-/yPhxI1ntnDNsiHtzLKYnE3vf9JZ6cAisqVDauhp4CEHxlb4uoOTxOCJ+9s51bIB8U1N1FJ1RXOKTIlD5B/gqw==",+ "license": "MIT",+ "dependencies": {+ "devlop": "^1.0.0",+ "micromark-core-commonmark": "^2.0.0",+ "micromark-factory-space": "^2.0.0",+ "micromark-util-character": "^2.0.0",+ "micromark-util-normalize-identifier": "^2.0.0",+ "micromark-util-sanitize-uri": "^2.0.0",+ "micromark-util-symbol": "^2.0.0",+ "micromark-util-types": "^2.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/micromark-extension-gfm-strikethrough": {+ "version": "2.1.0",+ "resolved": "https://registry.npmjs.org/micromark-extension-gfm-strikethrough/-/micromark-extension-gfm-strikethrough-2.1.0.tgz",+ "integrity": "sha512-ADVjpOOkjz1hhkZLlBiYA9cR2Anf8F4HqZUO6e5eDcPQd0Txw5fxLzzxnEkSkfnD0wziSGiv7sYhk/ktvbf1uw==",+ "license": "MIT",+ "dependencies": {+ "devlop": "^1.0.0",+ "micromark-util-chunked": "^2.0.0",+ "micromark-util-classify-character": "^2.0.0",+ "micromark-util-resolve-all": "^2.0.0",+ "micromark-util-symbol": "^2.0.0",+ "micromark-util-types": "^2.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/micromark-extension-gfm-table": {+ "version": "2.1.2",+ "resolved": "https://registry.npmjs.org/micromark-extension-gfm-table/-/micromark-extension-gfm-table-2.1.2.tgz",+ "integrity": "sha512-pRzm4kDTu0MjlmBkxmS9yYhw60nncfcEwu9NNdPFSQEFXS95ZKyIIyTSHu/o3ReBUrLKYEq+7YaXCRn/bPB4MA==",+ "license": "MIT",+ "dependencies": {+ "devlop": "^1.0.0",+ "micromark-factory-space": "^2.0.0",+ "micromark-util-character": "^2.0.0",+ "micromark-util-symbol": "^2.0.0",+ "micromark-util-types": "^2.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/micromark-extension-gfm-tagfilter": {+ "version": "2.0.0",+ "resolved": "https://registry.npmjs.org/micromark-extension-gfm-tagfilter/-/micromark-extension-gfm-tagfilter-2.0.0.tgz",+ "integrity": "sha512-xHlTOmuCSotIA8TW1mDIM6X2O1SiX5P9IuDtqGonFhEK0qgRI4yeC6vMxEV2dgyr2TiD+2PQ10o+cOhdVAcwfg==",+ "license": "MIT",+ "dependencies": {+ "micromark-util-types": "^2.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/micromark-extension-gfm-task-list-item": {+ "version": "2.1.0",+ "resolved": "https://registry.npmjs.org/micromark-extension-gfm-task-list-item/-/micromark-extension-gfm-task-list-item-2.1.0.tgz",+ "integrity": "sha512-qIBZhqxqI6fjLDYFTBIa4eivDMnP+OZqsNwmQ3xNLE4Cxwc+zfQEfbs6tzAo2Hjq+bh6q5F+Z8/cksrLFYWQQw==",+ "license": "MIT",+ "dependencies": {+ "devlop": "^1.0.0",+ "micromark-factory-space": "^2.0.0",+ "micromark-util-character": "^2.0.0",+ "micromark-util-symbol": "^2.0.0",+ "micromark-util-types": "^2.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/micromark-extension-mdx-expression": {+ "version": "3.0.1",+ "resolved": "https://registry.npmjs.org/micromark-extension-mdx-expression/-/micromark-extension-mdx-expression-3.0.1.tgz",+ "integrity": "sha512-dD/ADLJ1AeMvSAKBwO22zG22N4ybhe7kFIZ3LsDI0GlsNr2A3KYxb0LdC1u5rj4Nw+CHKY0RVdnHX8vj8ejm4Q==",+ "funding": [+ {+ "type": "GitHub Sponsors",+ "url": "https://github.com/sponsors/unifiedjs"+ },+ {+ "type": "OpenCollective",+ "url": "https://opencollective.com/unified"+ }+ ],+ "license": "MIT",+ "dependencies": {+ "@types/estree": "^1.0.0",+ "devlop": "^1.0.0",+ "micromark-factory-mdx-expression": "^2.0.0",+ "micromark-factory-space": "^2.0.0",+ "micromark-util-character": "^2.0.0",+ "micromark-util-events-to-acorn": "^2.0.0",+ "micromark-util-symbol": "^2.0.0",+ "micromark-util-types": "^2.0.0"+ }+ },+ "node_modules/micromark-extension-mdx-jsx": {+ "version": "3.0.2",+ "resolved": "https://registry.npmjs.org/micromark-extension-mdx-jsx/-/micromark-extension-mdx-jsx-3.0.2.tgz",+ "integrity": "sha512-e5+q1DjMh62LZAJOnDraSSbDMvGJ8x3cbjygy2qFEi7HCeUT4BDKCvMozPozcD6WmOt6sVvYDNBKhFSz3kjOVQ==",+ "license": "MIT",+ "dependencies": {+ "@types/estree": "^1.0.0",+ "devlop": "^1.0.0",+ "estree-util-is-identifier-name": "^3.0.0",+ "micromark-factory-mdx-expression": "^2.0.0",+ "micromark-factory-space": "^2.0.0",+ "micromark-util-character": "^2.0.0",+ "micromark-util-events-to-acorn": "^2.0.0",+ "micromark-util-symbol": "^2.0.0",+ "micromark-util-types": "^2.0.0",+ "vfile-message": "^4.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/micromark-extension-mdx-md": {+ "version": "2.0.0",+ "resolved": "https://registry.npmjs.org/micromark-extension-mdx-md/-/micromark-extension-mdx-md-2.0.0.tgz",+ "integrity": "sha512-EpAiszsB3blw4Rpba7xTOUptcFeBFi+6PY8VnJ2hhimH+vCQDirWgsMpz7w1XcZE7LVrSAUGb9VJpG9ghlYvYQ==",+ "license": "MIT",+ "dependencies": {+ "micromark-util-types": "^2.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/micromark-extension-mdxjs": {+ "version": "3.0.0",+ "resolved": "https://registry.npmjs.org/micromark-extension-mdxjs/-/micromark-extension-mdxjs-3.0.0.tgz",+ "integrity": "sha512-A873fJfhnJ2siZyUrJ31l34Uqwy4xIFmvPY1oj+Ean5PHcPBYzEsvqvWGaWcfEIr11O5Dlw3p2y0tZWpKHDejQ==",+ "license": "MIT",+ "dependencies": {+ "acorn": "^8.0.0",+ "acorn-jsx": "^5.0.0",+ "micromark-extension-mdx-expression": "^3.0.0",+ "micromark-extension-mdx-jsx": "^3.0.0",+ "micromark-extension-mdx-md": "^2.0.0",+ "micromark-extension-mdxjs-esm": "^3.0.0",+ "micromark-util-combine-extensions": "^2.0.0",+ "micromark-util-types": "^2.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/micromark-extension-mdxjs-esm": {+ "version": "3.0.0",+ "resolved": "https://registry.npmjs.org/micromark-extension-mdxjs-esm/-/micromark-extension-mdxjs-esm-3.0.0.tgz",+ "integrity": "sha512-DJFl4ZqkErRpq/dAPyeWp15tGrcrrJho1hKK5uBS70BCtfrIFg81sqcTVu3Ta+KD1Tk5vAtBNElWxtAa+m8K9A==",+ "license": "MIT",+ "dependencies": {+ "@types/estree": "^1.0.0",+ "devlop": "^1.0.0",+ "micromark-core-commonmark": "^2.0.0",+ "micromark-util-character": "^2.0.0",+ "micromark-util-events-to-acorn": "^2.0.0",+ "micromark-util-symbol": "^2.0.0",+ "micromark-util-types": "^2.0.0",+ "unist-util-position-from-estree": "^2.0.0",+ "vfile-message": "^4.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/micromark-factory-destination": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/micromark-factory-destination/-/micromark-factory-destination-2.0.1.tgz",+ "integrity": "sha512-Xe6rDdJlkmbFRExpTOmRj9N3MaWmbAgdpSrBQvCFqhezUn4AHqJHbaEnfbVYYiexVSs//tqOdY/DxhjdCiJnIA==",+ "funding": [+ {+ "type": "GitHub Sponsors",+ "url": "https://github.com/sponsors/unifiedjs"+ },+ {+ "type": "OpenCollective",+ "url": "https://opencollective.com/unified"+ }+ ],+ "license": "MIT",+ "dependencies": {+ "micromark-util-character": "^2.0.0",+ "micromark-util-symbol": "^2.0.0",+ "micromark-util-types": "^2.0.0"+ }+ },+ "node_modules/micromark-factory-label": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/micromark-factory-label/-/micromark-factory-label-2.0.1.tgz",+ "integrity": "sha512-VFMekyQExqIW7xIChcXn4ok29YE3rnuyveW3wZQWWqF4Nv9Wk5rgJ99KzPvHjkmPXF93FXIbBp6YdW3t71/7Vg==",+ "funding": [+ {+ "type": "GitHub Sponsors",+ "url": "https://github.com/sponsors/unifiedjs"+ },+ {+ "type": "OpenCollective",+ "url": "https://opencollective.com/unified"+ }+ ],+ "license": "MIT",+ "dependencies": {+ "devlop": "^1.0.0",+ "micromark-util-character": "^2.0.0",+ "micromark-util-symbol": "^2.0.0",+ "micromark-util-types": "^2.0.0"+ }+ },+ "node_modules/micromark-factory-mdx-expression": {+ "version": "2.0.3",+ "resolved": "https://registry.npmjs.org/micromark-factory-mdx-expression/-/micromark-factory-mdx-expression-2.0.3.tgz",+ "integrity": "sha512-kQnEtA3vzucU2BkrIa8/VaSAsP+EJ3CKOvhMuJgOEGg9KDC6OAY6nSnNDVRiVNRqj7Y4SlSzcStaH/5jge8JdQ==",+ "funding": [+ {+ "type": "GitHub Sponsors",+ "url": "https://github.com/sponsors/unifiedjs"+ },+ {+ "type": "OpenCollective",+ "url": "https://opencollective.com/unified"+ }+ ],+ "license": "MIT",+ "dependencies": {+ "@types/estree": "^1.0.0",+ "devlop": "^1.0.0",+ "micromark-factory-space": "^2.0.0",+ "micromark-util-character": "^2.0.0",+ "micromark-util-events-to-acorn": "^2.0.0",+ "micromark-util-symbol": "^2.0.0",+ "micromark-util-types": "^2.0.0",+ "unist-util-position-from-estree": "^2.0.0",+ "vfile-message": "^4.0.0"+ }+ },+ "node_modules/micromark-factory-space": {+ "version": "2.1.0",+ "resolved": "https://registry.npmjs.org/micromark-factory-space/-/micromark-factory-space-2.1.0.tgz",+ "integrity": "sha512-fS8hnLIjnjvdQIj39Geug8wWsR0HrYZ43KShKxNfwT7t2LOHo/LbWZEzEaSOjwtjdCsjoE6syHhonEzW0zv0+Q==",+ "funding": [+ {+ "type": "GitHub Sponsors",+ "url": "https://github.com/sponsors/unifiedjs"+ },+ {+ "type": "OpenCollective",+ "url": "https://opencollective.com/unified"+ }+ ],+ "license": "MIT",+ "dependencies": {+ "micromark-util-character": "^2.0.0",+ "micromark-util-types": "^2.0.0"+ }+ },+ "node_modules/micromark-factory-title": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/micromark-factory-title/-/micromark-factory-title-2.0.1.tgz",+ "integrity": "sha512-5bZ+3CjhAd9eChYTHsjy6TGxpOFSKgKKJPJxr293jTbfry2KDoWkhBb6TcPVB4NmzaPhMs1Frm9AZH7OD4Cjzw==",+ "funding": [+ {+ "type": "GitHub Sponsors",+ "url": "https://github.com/sponsors/unifiedjs"+ },+ {+ "type": "OpenCollective",+ "url": "https://opencollective.com/unified"+ }+ ],+ "license": "MIT",+ "dependencies": {+ "micromark-factory-space": "^2.0.0",+ "micromark-util-character": "^2.0.0",+ "micromark-util-symbol": "^2.0.0",+ "micromark-util-types": "^2.0.0"+ }+ },+ "node_modules/micromark-factory-whitespace": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/micromark-factory-whitespace/-/micromark-factory-whitespace-2.0.1.tgz",+ "integrity": "sha512-Ob0nuZ3PKt/n0hORHyvoD9uZhr+Za8sFoP+OnMcnWK5lngSzALgQYKMr9RJVOWLqQYuyn6ulqGWSXdwf6F80lQ==",+ "funding": [+ {+ "type": "GitHub Sponsors",+ "url": "https://github.com/sponsors/unifiedjs"+ },+ {+ "type": "OpenCollective",+ "url": "https://opencollective.com/unified"+ }+ ],+ "license": "MIT",+ "dependencies": {+ "micromark-factory-space": "^2.0.0",+ "micromark-util-character": "^2.0.0",+ "micromark-util-symbol": "^2.0.0",+ "micromark-util-types": "^2.0.0"+ }+ },+ "node_modules/micromark-util-character": {+ "version": "2.1.1",+ "resolved": "https://registry.npmjs.org/micromark-util-character/-/micromark-util-character-2.1.1.tgz",+ "integrity": "sha512-wv8tdUTJ3thSFFFJKtpYKOYiGP2+v96Hvk4Tu8KpCAsTMs6yi+nVmGh1syvSCsaxz45J6Jbw+9DD6g97+NV67Q==",+ "funding": [+ {+ "type": "GitHub Sponsors",+ "url": "https://github.com/sponsors/unifiedjs"+ },+ {+ "type": "OpenCollective",+ "url": "https://opencollective.com/unified"+ }+ ],+ "license": "MIT",+ "dependencies": {+ "micromark-util-symbol": "^2.0.0",+ "micromark-util-types": "^2.0.0"+ }+ },+ "node_modules/micromark-util-chunked": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/micromark-util-chunked/-/micromark-util-chunked-2.0.1.tgz",+ "integrity": "sha512-QUNFEOPELfmvv+4xiNg2sRYeS/P84pTW0TCgP5zc9FpXetHY0ab7SxKyAQCNCc1eK0459uoLI1y5oO5Vc1dbhA==",+ "funding": [+ {+ "type": "GitHub Sponsors",+ "url": "https://github.com/sponsors/unifiedjs"+ },+ {+ "type": "OpenCollective",+ "url": "https://opencollective.com/unified"+ }+ ],+ "license": "MIT",+ "dependencies": {+ "micromark-util-symbol": "^2.0.0"+ }+ },+ "node_modules/micromark-util-classify-character": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/micromark-util-classify-character/-/micromark-util-classify-character-2.0.1.tgz",+ "integrity": "sha512-K0kHzM6afW/MbeWYWLjoHQv1sgg2Q9EccHEDzSkxiP/EaagNzCm7T/WMKZ3rjMbvIpvBiZgwR3dKMygtA4mG1Q==",+ "funding": [+ {+ "type": "GitHub Sponsors",+ "url": "https://github.com/sponsors/unifiedjs"+ },+ {+ "type": "OpenCollective",+ "url": "https://opencollective.com/unified"+ }+ ],+ "license": "MIT",+ "dependencies": {+ "micromark-util-character": "^2.0.0",+ "micromark-util-symbol": "^2.0.0",+ "micromark-util-types": "^2.0.0"+ }+ },+ "node_modules/micromark-util-combine-extensions": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/micromark-util-combine-extensions/-/micromark-util-combine-extensions-2.0.1.tgz",+ "integrity": "sha512-OnAnH8Ujmy59JcyZw8JSbK9cGpdVY44NKgSM7E9Eh7DiLS2E9RNQf0dONaGDzEG9yjEl5hcqeIsj4hfRkLH/Bg==",+ "funding": [+ {+ "type": "GitHub Sponsors",+ "url": "https://github.com/sponsors/unifiedjs"+ },+ {+ "type": "OpenCollective",+ "url": "https://opencollective.com/unified"+ }+ ],+ "license": "MIT",+ "dependencies": {+ "micromark-util-chunked": "^2.0.0",+ "micromark-util-types": "^2.0.0"+ }+ },+ "node_modules/micromark-util-decode-numeric-character-reference": {+ "version": "2.0.2",+ "resolved": "https://registry.npmjs.org/micromark-util-decode-numeric-character-reference/-/micromark-util-decode-numeric-character-reference-2.0.2.tgz",+ "integrity": "sha512-ccUbYk6CwVdkmCQMyr64dXz42EfHGkPQlBj5p7YVGzq8I7CtjXZJrubAYezf7Rp+bjPseiROqe7G6foFd+lEuw==",+ "funding": [+ {+ "type": "GitHub Sponsors",+ "url": "https://github.com/sponsors/unifiedjs"+ },+ {+ "type": "OpenCollective",+ "url": "https://opencollective.com/unified"+ }+ ],+ "license": "MIT",+ "dependencies": {+ "micromark-util-symbol": "^2.0.0"+ }+ },+ "node_modules/micromark-util-decode-string": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/micromark-util-decode-string/-/micromark-util-decode-string-2.0.1.tgz",+ "integrity": "sha512-nDV/77Fj6eH1ynwscYTOsbK7rR//Uj0bZXBwJZRfaLEJ1iGBR6kIfNmlNqaqJf649EP0F3NWNdeJi03elllNUQ==",+ "funding": [+ {+ "type": "GitHub Sponsors",+ "url": "https://github.com/sponsors/unifiedjs"+ },+ {+ "type": "OpenCollective",+ "url": "https://opencollective.com/unified"+ }+ ],+ "license": "MIT",+ "dependencies": {+ "decode-named-character-reference": "^1.0.0",+ "micromark-util-character": "^2.0.0",+ "micromark-util-decode-numeric-character-reference": "^2.0.0",+ "micromark-util-symbol": "^2.0.0"+ }+ },+ "node_modules/micromark-util-edit-map": {+ "version": "1.0.0",+ "resolved": "https://registry.npmjs.org/micromark-util-edit-map/-/micromark-util-edit-map-1.0.0.tgz",+ "integrity": "sha512-Pa2ljlsEL6sVwFaYeyrOLSYbQt73JvGbPOYFq+9AElXiSnfI5Q4465RRZ1sHv7lDjDOnGRDDaqPXqClqWK/q1Q==",+ "funding": [+ {+ "type": "GitHub Sponsors",+ "url": "https://github.com/sponsors/unifiedjs"+ },+ {+ "type": "OpenCollective",+ "url": "https://opencollective.com/unified"+ }+ ],+ "license": "MIT",+ "dependencies": {+ "micromark-util-types": "^2.0.0"+ }+ },+ "node_modules/micromark-util-encode": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/micromark-util-encode/-/micromark-util-encode-2.0.1.tgz",+ "integrity": "sha512-c3cVx2y4KqUnwopcO9b/SCdo2O67LwJJ/UyqGfbigahfegL9myoEFoDYZgkT7f36T0bLrM9hZTAaAyH+PCAXjw==",+ "funding": [+ {+ "type": "GitHub Sponsors",+ "url": "https://github.com/sponsors/unifiedjs"+ },+ {+ "type": "OpenCollective",+ "url": "https://opencollective.com/unified"+ }+ ],+ "license": "MIT"+ },+ "node_modules/micromark-util-events-to-acorn": {+ "version": "2.0.3",+ "resolved": "https://registry.npmjs.org/micromark-util-events-to-acorn/-/micromark-util-events-to-acorn-2.0.3.tgz",+ "integrity": "sha512-jmsiEIiZ1n7X1Rr5k8wVExBQCg5jy4UXVADItHmNk1zkwEVhBuIUKRu3fqv+hs4nxLISi2DQGlqIOGiFxgbfHg==",+ "funding": [+ {+ "type": "GitHub Sponsors",+ "url": "https://github.com/sponsors/unifiedjs"+ },+ {+ "type": "OpenCollective",+ "url": "https://opencollective.com/unified"+ }+ ],+ "license": "MIT",+ "dependencies": {+ "@types/estree": "^1.0.0",+ "@types/unist": "^3.0.0",+ "devlop": "^1.0.0",+ "estree-util-visit": "^2.0.0",+ "micromark-util-symbol": "^2.0.0",+ "micromark-util-types": "^2.0.0",+ "vfile-message": "^4.0.0"+ }+ },+ "node_modules/micromark-util-html-tag-name": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/micromark-util-html-tag-name/-/micromark-util-html-tag-name-2.0.1.tgz",+ "integrity": "sha512-2cNEiYDhCWKI+Gs9T0Tiysk136SnR13hhO8yW6BGNyhOC4qYFnwF1nKfD3HFAIXA5c45RrIG1ub11GiXeYd1xA==",+ "funding": [+ {+ "type": "GitHub Sponsors",+ "url": "https://github.com/sponsors/unifiedjs"+ },+ {+ "type": "OpenCollective",+ "url": "https://opencollective.com/unified"+ }+ ],+ "license": "MIT"+ },+ "node_modules/micromark-util-normalize-identifier": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/micromark-util-normalize-identifier/-/micromark-util-normalize-identifier-2.0.1.tgz",+ "integrity": "sha512-sxPqmo70LyARJs0w2UclACPUUEqltCkJ6PhKdMIDuJ3gSf/Q+/GIe3WKl0Ijb/GyH9lOpUkRAO2wp0GVkLvS9Q==",+ "funding": [+ {+ "type": "GitHub Sponsors",+ "url": "https://github.com/sponsors/unifiedjs"+ },+ {+ "type": "OpenCollective",+ "url": "https://opencollective.com/unified"+ }+ ],+ "license": "MIT",+ "dependencies": {+ "micromark-util-symbol": "^2.0.0"+ }+ },+ "node_modules/micromark-util-resolve-all": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/micromark-util-resolve-all/-/micromark-util-resolve-all-2.0.1.tgz",+ "integrity": "sha512-VdQyxFWFT2/FGJgwQnJYbe1jjQoNTS4RjglmSjTUlpUMa95Htx9NHeYW4rGDJzbjvCsl9eLjMQwGeElsqmzcHg==",+ "funding": [+ {+ "type": "GitHub Sponsors",+ "url": "https://github.com/sponsors/unifiedjs"+ },+ {+ "type": "OpenCollective",+ "url": "https://opencollective.com/unified"+ }+ ],+ "license": "MIT",+ "dependencies": {+ "micromark-util-types": "^2.0.0"+ }+ },+ "node_modules/micromark-util-sanitize-uri": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/micromark-util-sanitize-uri/-/micromark-util-sanitize-uri-2.0.1.tgz",+ "integrity": "sha512-9N9IomZ/YuGGZZmQec1MbgxtlgougxTodVwDzzEouPKo3qFWvymFHWcnDi2vzV1ff6kas9ucW+o3yzJK9YB1AQ==",+ "funding": [+ {+ "type": "GitHub Sponsors",+ "url": "https://github.com/sponsors/unifiedjs"+ },+ {+ "type": "OpenCollective",+ "url": "https://opencollective.com/unified"+ }+ ],+ "license": "MIT",+ "dependencies": {+ "micromark-util-character": "^2.0.0",+ "micromark-util-encode": "^2.0.0",+ "micromark-util-symbol": "^2.0.0"}},- "node_modules/merge2": {- "version": "1.4.1",- "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz",- "integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==",- "dev": true,+ "node_modules/micromark-util-subtokenize": {+ "version": "2.1.0",+ "resolved": "https://registry.npmjs.org/micromark-util-subtokenize/-/micromark-util-subtokenize-2.1.0.tgz",+ "integrity": "sha512-XQLu552iSctvnEcgXw6+Sx75GflAPNED1qx7eBJ+wydBb2KCbRZe+NwvIEEMM83uml1+2WSXpBAcp9IUCgCYWA==",+ "funding": [+ {+ "type": "GitHub Sponsors",+ "url": "https://github.com/sponsors/unifiedjs"+ },+ {+ "type": "OpenCollective",+ "url": "https://opencollective.com/unified"+ }+ ],"license": "MIT",- "engines": {- "node": ">= 8"+ "dependencies": {+ "devlop": "^1.0.0",+ "micromark-util-chunked": "^2.0.0",+ "micromark-util-symbol": "^2.0.0",+ "micromark-util-types": "^2.0.0"}},+ "node_modules/micromark-util-symbol": {+ "version": "2.0.1",+ "resolved": "https://registry.npmjs.org/micromark-util-symbol/-/micromark-util-symbol-2.0.1.tgz",+ "integrity": "sha512-vs5t8Apaud9N28kgCrRUdEed4UJ+wWNvicHLPxCa9ENlYuAY31M0ETy5y1vA33YoNPDFTghEbnh6efaE8h4x0Q==",+ "funding": [+ {+ "type": "GitHub Sponsors",+ "url": "https://github.com/sponsors/unifiedjs"+ },+ {+ "type": "OpenCollective",+ "url": "https://opencollective.com/unified"+ }+ ],+ "license": "MIT"+ },+ "node_modules/micromark-util-types": {+ "version": "2.0.3",+ "resolved": "https://registry.npmjs.org/micromark-util-types/-/micromark-util-types-2.0.3.tgz",+ "integrity": "sha512-oxB2Ik03hI0gv+VNn9tnh1t1YEe9MDPptViAEgfdf3YQHsn0pzGTgCdlSCJXcwhqm8phaEuM7zeEu3QQzVBrPg==",+ "funding": [+ {+ "type": "GitHub Sponsors",+ "url": "https://github.com/sponsors/unifiedjs"+ },+ {+ "type": "OpenCollective",+ "url": "https://opencollective.com/unified"+ }+ ],+ "license": "MIT"+ },"node_modules/micromatch": {"version": "4.0.8","resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz",@@ -5059,7 +6706,6 @@"version": "2.1.3","resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz","integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",- "dev": true,"license": "MIT"},"node_modules/nanoid": {@@ -5414,6 +7060,31 @@"node": ">=6"}},+ "node_modules/parse-entities": {+ "version": "4.0.2",+ "resolved": "https://registry.npmjs.org/parse-entities/-/parse-entities-4.0.2.tgz",+ "integrity": "sha512-GG2AQYWoLgL877gQIKeRPGO1xF9+eG1ujIb5soS5gPvLQ1y2o8FL90w2QWNdf9I361Mpp7726c+lj3U0qK1uGw==",+ "license": "MIT",+ "dependencies": {+ "@types/unist": "^2.0.0",+ "character-entities-legacy": "^3.0.0",+ "character-reference-invalid": "^2.0.0",+ "decode-named-character-reference": "^1.0.0",+ "is-alphanumerical": "^2.0.0",+ "is-decimal": "^2.0.0",+ "is-hexadecimal": "^2.0.0"+ },+ "funding": {+ "type": "github",+ "url": "https://github.com/sponsors/wooorm"+ }+ },+ "node_modules/parse-entities/node_modules/@types/unist": {+ "version": "2.0.11",+ "resolved": "https://registry.npmjs.org/@types/unist/-/unist-2.0.11.tgz",+ "integrity": "sha512-CmBKiL6NNo/OqgmMn95Fk9Whlp2mtvIv+KNpQKN2F4SjvrEesubTRWGYSg+BnWZOnlCaSTU1sMpsBOzgbYhnsA==",+ "license": "MIT"+ },"node_modules/path-exists": {"version": "4.0.0","resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz",@@ -5569,6 +7240,16 @@"react-is": "^16.13.1"}},+ "node_modules/property-information": {+ "version": "7.2.0",+ "resolved": "https://registry.npmjs.org/property-information/-/property-information-7.2.0.tgz",+ "integrity": "sha512-IAtzIB6sUiWaJYrX9smp3V46pBGbBeLFRGdh25kg1334VcBlD8HzhPeNIWQH9zhGmo2itIe25EHt9dQP7G5hmg==",+ "license": "MIT",+ "funding": {+ "type": "github",+ "url": "https://github.com/sponsors/wooorm"+ }+ },"node_modules/punycode": {"version": "2.3.1","resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz",@@ -5634,6 +7315,73 @@"dev": true,"license": "MIT"},+ "node_modules/recma-build-jsx": {+ "version": "1.0.0",+ "resolved": "https://registry.npmjs.org/recma-build-jsx/-/recma-build-jsx-1.0.0.tgz",+ "integrity": "sha512-8GtdyqaBcDfva+GUKDr3nev3VpKAhup1+RvkMvUxURHpW7QyIvk9F5wz7Vzo06CEMSilw6uArgRqhpiUcWp8ew==",+ "license": "MIT",+ "dependencies": {+ "@types/estree": "^1.0.0",+ "estree-util-build-jsx": "^3.0.0",+ "vfile": "^6.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/recma-jsx": {+ "version": "1.0.1",+ "resolved": "https://registry.npmjs.org/recma-jsx/-/recma-jsx-1.0.1.tgz",+ "integrity": "sha512-huSIy7VU2Z5OLv6oFLosQGGDqPqdO1iq6bWNAdhzMxSJP7RAso4fCZ1cKu8j9YHCZf3TPrq4dw3okhrylgcd7w==",+ "license": "MIT",+ "dependencies": {+ "acorn-jsx": "^5.0.0",+ "estree-util-to-js": "^2.0.0",+ "recma-parse": "^1.0.0",+ "recma-stringify": "^1.0.0",+ "unified": "^11.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ },+ "peerDependencies": {+ "acorn": "^6.0.0 || ^7.0.0 || ^8.0.0"+ }+ },+ "node_modules/recma-parse": {+ "version": "1.0.0",+ "resolved": "https://registry.npmjs.org/recma-parse/-/recma-parse-1.0.0.tgz",+ "integrity": "sha512-OYLsIGBB5Y5wjnSnQW6t3Xg7q3fQ7FWbw/vcXtORTnyaSFscOtABg+7Pnz6YZ6c27fG1/aN8CjfwoUEUIdwqWQ==",+ "license": "MIT",+ "dependencies": {+ "@types/estree": "^1.0.0",+ "esast-util-from-js": "^2.0.0",+ "unified": "^11.0.0",+ "vfile": "^6.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/recma-stringify": {+ "version": "1.0.0",+ "resolved": "https://registry.npmjs.org/recma-stringify/-/recma-stringify-1.0.0.tgz",+ "integrity": "sha512-cjwII1MdIIVloKvC9ErQ+OgAtwHBmcZ0Bg4ciz78FtbT8In39aAYbaA7zvxQ61xVMSPE8WxhLwLbhif4Js2C+g==",+ "license": "MIT",+ "dependencies": {+ "@types/estree": "^1.0.0",+ "estree-util-to-js": "^2.0.0",+ "unified": "^11.0.0",+ "vfile": "^6.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },"node_modules/reflect.getprototypeof": {"version": "1.0.10","resolved": "https://registry.npmjs.org/reflect.getprototypeof/-/reflect.getprototypeof-1.0.10.tgz",@@ -5678,6 +7426,118 @@"url": "https://github.com/sponsors/ljharb"}},+ "node_modules/rehype-recma": {+ "version": "1.0.0",+ "resolved": "https://registry.npmjs.org/rehype-recma/-/rehype-recma-1.0.0.tgz",+ "integrity": "sha512-lqA4rGUf1JmacCNWWZx0Wv1dHqMwxzsDWYMTowuplHF3xH0N/MmrZ/G3BDZnzAkRmxDadujCjaKM2hqYdCBOGw==",+ "license": "MIT",+ "dependencies": {+ "@types/estree": "^1.0.0",+ "@types/hast": "^3.0.0",+ "hast-util-to-estree": "^3.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/rehype-slug": {+ "version": "6.0.0",+ "resolved": "https://registry.npmjs.org/rehype-slug/-/rehype-slug-6.0.0.tgz",+ "integrity": "sha512-lWyvf/jwu+oS5+hL5eClVd3hNdmwM1kAC0BUvEGD19pajQMIzcNUd/k9GsfQ+FfECvX+JE+e9/btsKH0EjJT6A==",+ "license": "MIT",+ "dependencies": {+ "@types/hast": "^3.0.0",+ "github-slugger": "^2.0.0",+ "hast-util-heading-rank": "^3.0.0",+ "hast-util-to-string": "^3.0.0",+ "unist-util-visit": "^5.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/remark-gfm": {+ "version": "4.0.1",+ "resolved": "https://registry.npmjs.org/remark-gfm/-/remark-gfm-4.0.1.tgz",+ "integrity": "sha512-1quofZ2RQ9EWdeN34S79+KExV1764+wCUGop5CPL1WGdD0ocPpu91lzPGbwWMECpEpd42kJGQwzRfyov9j4yNg==",+ "license": "MIT",+ "dependencies": {+ "@types/mdast": "^4.0.0",+ "mdast-util-gfm": "^3.0.0",+ "micromark-extension-gfm": "^3.0.0",+ "remark-parse": "^11.0.0",+ "remark-stringify": "^11.0.0",+ "unified": "^11.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/remark-mdx": {+ "version": "3.1.1",+ "resolved": "https://registry.npmjs.org/remark-mdx/-/remark-mdx-3.1.1.tgz",+ "integrity": "sha512-Pjj2IYlUY3+D8x00UJsIOg5BEvfMyeI+2uLPn9VO9Wg4MEtN/VTIq2NEJQfde9PnX15KgtHyl9S0BcTnWrIuWg==",+ "license": "MIT",+ "dependencies": {+ "mdast-util-mdx": "^3.0.0",+ "micromark-extension-mdxjs": "^3.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/remark-parse": {+ "version": "11.0.0",+ "resolved": "https://registry.npmjs.org/remark-parse/-/remark-parse-11.0.0.tgz",+ "integrity": "sha512-FCxlKLNGknS5ba/1lmpYijMUzX2esxW5xQqjWxw2eHFfS2MSdaHVINFmhjo+qN1WhZhNimq0dZATN9pH0IDrpA==",+ "license": "MIT",+ "dependencies": {+ "@types/mdast": "^4.0.0",+ "mdast-util-from-markdown": "^2.0.0",+ "micromark-util-types": "^2.0.0",+ "unified": "^11.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/remark-rehype": {+ "version": "11.1.2",+ "resolved": "https://registry.npmjs.org/remark-rehype/-/remark-rehype-11.1.2.tgz",+ "integrity": "sha512-Dh7l57ianaEoIpzbp0PC9UKAdCSVklD8E5Rpw7ETfbTl3FqcOOgq5q2LVDhgGCkaBv7p24JXikPdvhhmHvKMsw==",+ "license": "MIT",+ "dependencies": {+ "@types/hast": "^3.0.0",+ "@types/mdast": "^4.0.0",+ "mdast-util-to-hast": "^13.0.0",+ "unified": "^11.0.0",+ "vfile": "^6.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/remark-stringify": {+ "version": "11.0.0",+ "resolved": "https://registry.npmjs.org/remark-stringify/-/remark-stringify-11.0.0.tgz",+ "integrity": "sha512-1OSmLd3awB/t8qdoEOMazZkNsfVTeY4fTsgzcQFdXNq8ToTN4ZGwrMnlda4K6smTFKD+GRV6O48i6Z4iKgPPpw==",+ "license": "MIT",+ "dependencies": {+ "@types/mdast": "^4.0.0",+ "mdast-util-to-markdown": "^2.0.0",+ "unified": "^11.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },"node_modules/resolve": {"version": "1.22.11","resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.11.tgz",@@ -6031,6 +7891,15 @@"url": "https://github.com/sponsors/ljharb"}},+ "node_modules/source-map": {+ "version": "0.7.6",+ "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.7.6.tgz",+ "integrity": "sha512-i5uvt8C3ikiWeNZSVZNWcfZPItFQOsYTUAOkcUPGd8DqDy1uOUikjt5dG+uRlwyvR108Fb9DOd4GvXfT0N2/uQ==",+ "license": "BSD-3-Clause",+ "engines": {+ "node": ">= 12"+ }+ },"node_modules/source-map-js": {"version": "1.2.1","resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",@@ -6040,6 +7909,16 @@"node": ">=0.10.0"}},+ "node_modules/space-separated-tokens": {+ "version": "2.0.2",+ "resolved": "https://registry.npmjs.org/space-separated-tokens/-/space-separated-tokens-2.0.2.tgz",+ "integrity": "sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q==",+ "license": "MIT",+ "funding": {+ "type": "github",+ "url": "https://github.com/sponsors/wooorm"+ }+ },"node_modules/stable-hash": {"version": "0.0.5","resolved": "https://registry.npmjs.org/stable-hash/-/stable-hash-0.0.5.tgz",@@ -6174,6 +8053,20 @@"url": "https://github.com/sponsors/ljharb"}},+ "node_modules/stringify-entities": {+ "version": "4.0.4",+ "resolved": "https://registry.npmjs.org/stringify-entities/-/stringify-entities-4.0.4.tgz",+ "integrity": "sha512-IwfBptatlO+QCJUo19AqvrPNqlVMpW9YEL2LIVY+Rpv2qsjCGxaDLNRgeGsQWJhfItebuJhsGSLjaBbNSQ+ieg==",+ "license": "MIT",+ "dependencies": {+ "character-entities-html4": "^2.0.0",+ "character-entities-legacy": "^3.0.0"+ },+ "funding": {+ "type": "github",+ "url": "https://github.com/sponsors/wooorm"+ }+ },"node_modules/strip-bom": {"version": "3.0.0","resolved": "https://registry.npmjs.org/strip-bom/-/strip-bom-3.0.0.tgz",@@ -6197,6 +8090,24 @@"url": "https://github.com/sponsors/sindresorhus"}},+ "node_modules/style-to-js": {+ "version": "1.1.21",+ "resolved": "https://registry.npmjs.org/style-to-js/-/style-to-js-1.1.21.tgz",+ "integrity": "sha512-RjQetxJrrUJLQPHbLku6U/ocGtzyjbJMP9lCNK7Ag0CNh690nSH8woqWH9u16nMjYBAok+i7JO1NP2pOy8IsPQ==",+ "license": "MIT",+ "dependencies": {+ "style-to-object": "1.0.14"+ }+ },+ "node_modules/style-to-object": {+ "version": "1.0.14",+ "resolved": "https://registry.npmjs.org/style-to-object/-/style-to-object-1.0.14.tgz",+ "integrity": "sha512-LIN7rULI0jBscWQYaSswptyderlarFkjQ+t79nzty8tcIAceVomEVlLzH5VP4Cmsv6MtKhs7qaAiwlcp+Mgaxw==",+ "license": "MIT",+ "dependencies": {+ "inline-style-parser": "0.2.7"+ }+ },"node_modules/styled-jsx": {"version": "5.1.6","resolved": "https://registry.npmjs.org/styled-jsx/-/styled-jsx-5.1.6.tgz",@@ -6328,6 +8239,26 @@"node": ">=8.0"}},+ "node_modules/trim-lines": {+ "version": "3.0.1",+ "resolved": "https://registry.npmjs.org/trim-lines/-/trim-lines-3.0.1.tgz",+ "integrity": "sha512-kRj8B+YHZCc9kQYdWfJB2/oUl9rA99qbowYYBtr4ui4mZyAQ2JpvVBd/6U2YloATfqBhBTSMhTpgBHtU0Mf3Rg==",+ "license": "MIT",+ "funding": {+ "type": "github",+ "url": "https://github.com/sponsors/wooorm"+ }+ },+ "node_modules/trough": {+ "version": "2.2.0",+ "resolved": "https://registry.npmjs.org/trough/-/trough-2.2.0.tgz",+ "integrity": "sha512-tmMpK00BjZiUyVyvrBK7knerNgmgvcV/KLVyuma/SC+TQN167GrMRciANTz09+k3zW8L8t60jWO1GpfkZdjTaw==",+ "license": "MIT",+ "funding": {+ "type": "github",+ "url": "https://github.com/sponsors/wooorm"+ }+ },"node_modules/ts-api-utils": {"version": "2.5.0","resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-2.5.0.tgz",@@ -6528,6 +8459,106 @@"dev": true,"license": "MIT"},+ "node_modules/unified": {+ "version": "11.0.5",+ "resolved": "https://registry.npmjs.org/unified/-/unified-11.0.5.tgz",+ "integrity": "sha512-xKvGhPWw3k84Qjh8bI3ZeJjqnyadK+GEFtazSfZv/rKeTkTjOJho6mFqh2SM96iIcZokxiOpg78GazTSg8+KHA==",+ "license": "MIT",+ "dependencies": {+ "@types/unist": "^3.0.0",+ "bail": "^2.0.0",+ "devlop": "^1.0.0",+ "extend": "^3.0.0",+ "is-plain-obj": "^4.0.0",+ "trough": "^2.0.0",+ "vfile": "^6.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/unist-util-is": {+ "version": "6.0.1",+ "resolved": "https://registry.npmjs.org/unist-util-is/-/unist-util-is-6.0.1.tgz",+ "integrity": "sha512-LsiILbtBETkDz8I9p1dQ0uyRUWuaQzd/cuEeS1hoRSyW5E5XGmTzlwY1OrNzzakGowI9Dr/I8HVaw4hTtnxy8g==",+ "license": "MIT",+ "dependencies": {+ "@types/unist": "^3.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/unist-util-position": {+ "version": "5.0.0",+ "resolved": "https://registry.npmjs.org/unist-util-position/-/unist-util-position-5.0.0.tgz",+ "integrity": "sha512-fucsC7HjXvkB5R3kTCO7kUjRdrS0BJt3M/FPxmHMBOm8JQi2BsHAHFsy27E0EolP8rp0NzXsJ+jNPyDWvOJZPA==",+ "license": "MIT",+ "dependencies": {+ "@types/unist": "^3.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/unist-util-position-from-estree": {+ "version": "2.0.0",+ "resolved": "https://registry.npmjs.org/unist-util-position-from-estree/-/unist-util-position-from-estree-2.0.0.tgz",+ "integrity": "sha512-KaFVRjoqLyF6YXCbVLNad/eS4+OfPQQn2yOd7zF/h5T/CSL2v8NpN6a5TPvtbXthAGw5nG+PuTtq+DdIZr+cRQ==",+ "license": "MIT",+ "dependencies": {+ "@types/unist": "^3.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/unist-util-stringify-position": {+ "version": "4.0.0",+ "resolved": "https://registry.npmjs.org/unist-util-stringify-position/-/unist-util-stringify-position-4.0.0.tgz",+ "integrity": "sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ==",+ "license": "MIT",+ "dependencies": {+ "@types/unist": "^3.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/unist-util-visit": {+ "version": "5.1.0",+ "resolved": "https://registry.npmjs.org/unist-util-visit/-/unist-util-visit-5.1.0.tgz",+ "integrity": "sha512-m+vIdyeCOpdr/QeQCu2EzxX/ohgS8KbnPDgFni4dQsfSCtpz8UqDyY5GjRru8PDKuYn7Fq19j1CQ+nJSsGKOzg==",+ "license": "MIT",+ "dependencies": {+ "@types/unist": "^3.0.0",+ "unist-util-is": "^6.0.0",+ "unist-util-visit-parents": "^6.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/unist-util-visit-parents": {+ "version": "6.0.2",+ "resolved": "https://registry.npmjs.org/unist-util-visit-parents/-/unist-util-visit-parents-6.0.2.tgz",+ "integrity": "sha512-goh1s1TBrqSqukSc8wrjwWhL0hiJxgA8m4kFxGlQ+8FYQ3C/m11FcTs4YYem7V664AhHVvgoQLk890Ssdsr2IQ==",+ "license": "MIT",+ "dependencies": {+ "@types/unist": "^3.0.0",+ "unist-util-is": "^6.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },"node_modules/unrs-resolver": {"version": "1.11.1","resolved": "https://registry.npmjs.org/unrs-resolver/-/unrs-resolver-1.11.1.tgz",@@ -6604,6 +8635,34 @@"punycode": "^2.1.0"}},+ "node_modules/vfile": {+ "version": "6.0.3",+ "resolved": "https://registry.npmjs.org/vfile/-/vfile-6.0.3.tgz",+ "integrity": "sha512-KzIbH/9tXat2u30jf+smMwFCsno4wHVdNmzFyL+T/L3UGqqk6JKfVqOFOZEpZSHADH1k40ab6NUIXZq422ov3Q==",+ "license": "MIT",+ "dependencies": {+ "@types/unist": "^3.0.0",+ "vfile-message": "^4.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },+ "node_modules/vfile-message": {+ "version": "4.0.3",+ "resolved": "https://registry.npmjs.org/vfile-message/-/vfile-message-4.0.3.tgz",+ "integrity": "sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw==",+ "license": "MIT",+ "dependencies": {+ "@types/unist": "^3.0.0",+ "unist-util-stringify-position": "^4.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/unified"+ }+ },"node_modules/web-vitals": {"version": "6.2.3","resolved": "https://registry.npmjs.org/web-vitals/-/web-vitals-6.2.3.tgz",@@ -6774,6 +8833,16 @@"peerDependencies": {"zod": "^3.25.0 || ^4.0.0"}+ },+ "node_modules/zwitch": {+ "version": "2.0.4",+ "resolved": "https://registry.npmjs.org/zwitch/-/zwitch-2.0.4.tgz",+ "integrity": "sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A==",+ "license": "MIT",+ "funding": {+ "type": "github",+ "url": "https://github.com/sponsors/wooorm"+ }}}}diff --git a/web/package.json b/web/package.jsonindex ab4aa465..16b1c143 100644--- a/web/package.json+++ b/web/package.json@@ -6,18 +6,25 @@"dev": "next dev","build": "next build","start": "next start",- "lint": "eslint"+ "lint": "eslint",+ "check:docs": "node scripts/check-docs.mjs"},"dependencies": {+ "@mdx-js/loader": "^3.1.1",+ "@next/mdx": "^16.2.1","@phosphor-icons/react": "^2.1.10","framer-motion": "^12.38.0","next": "16.2.1","posthog-js": "1.435.8","react": "19.2.4",- "react-dom": "19.2.4"+ "react-dom": "19.2.4",+ "rehype-slug": "^6.0.0",+ "remark-gfm": "^4.0.1"},"devDependencies": {+ "@mdx-js/mdx": "^3.1.1","@tailwindcss/postcss": "^4",+ "@types/mdx": "^2.0.14","@types/node": "^20","@types/react": "^19","@types/react-dom": "^19",diff --git a/web/public/llms.txt b/web/public/llms.txtindex c1d6a671..1d90f434 100644--- a/web/public/llms.txt+++ b/web/public/llms.txt@@ -28,12 +28,18 @@ Key facts:- [codync-mem](https://www.codync.dev/codync-mem): the open-source Rust crate behind the bots' memory (Markdown files the bot keeps, and the rules for who may change them)- [Source code on GitHub](https://github.com/leepokai/Codync): README, install guide and docs- [Discord](https://discord.gg/KBAX3Qznxh): community, help and feedback-- [Group chats and replies](https://github.com/leepokai/Codync/blob/main/docs/features/groups-and-replies.md)-- [Bot collaboration](https://github.com/leepokai/Codync/blob/main/docs/features/bot-collaboration.md)-- [Agent fallbacks](https://github.com/leepokai/Codync/blob/main/docs/features/agent-fallback.md)-- [SSH computers](https://github.com/leepokai/Codync/blob/main/docs/guides/accounts-and-ssh.md#desktop-computers-approvals-and-ssh)-- [Remote access and relay](https://github.com/leepokai/Codync/blob/main/docs/reference/remote-relay.md)-- [Linux servers](https://github.com/leepokai/Codync/blob/main/docs/guides/linux-servers.md)+- [User manual](https://www.codync.dev/docs): how to set up and use Codync, page by page+- [Getting started](https://www.codync.dev/docs/getting-started)+- [Bots](https://www.codync.dev/docs/bots) and [agents](https://www.codync.dev/docs/agents)+- [Group chats](https://www.codync.dev/docs/groups)+- [Teamwork](https://www.codync.dev/docs/teamwork)+- [Routines](https://www.codync.dev/docs/routines)+- [Memory](https://www.codync.dev/docs/memory)+- [Connectors and skills](https://www.codync.dev/docs/connectors-and-skills)+- [Agent fallbacks](https://www.codync.dev/docs/agent-fallbacks)+- [Remote access](https://www.codync.dev/docs/remote-access): relay, direct connection, pairing, SSH computers+- [Linux servers](https://www.codync.dev/docs/linux-servers)+- [Privacy](https://www.codync.dev/docs/privacy): what stays on your computer and what Codync's services see## Optionaldiff --git a/web/scripts/check-docs.mjs b/web/scripts/check-docs.mjsnew file mode 100644index 00000000..092c9d49--- /dev/null+++ b/web/scripts/check-docs.mjs@@ -0,0 +1,53 @@+// Checks the user manual without a full build: every content/docs/*.mdx page compiles with the site's MDX plugins+// and is listed in app/docs/pages.ts, and every /docs link and #anchor lands on an existing page and heading.+import { compile } from "@mdx-js/mdx";+import { readdir, readFile } from "node:fs/promises";+import rehypeSlug from "rehype-slug";+import remarkGfm from "remark-gfm";++const dir = new URL("../content/docs/", import.meta.url);+const pagesTs = await readFile(new URL("../app/docs/pages.ts", import.meta.url), "utf8");+const listed = new Set([...pagesTs.matchAll(/slug: "([^"]+)"/g)].map((m) => m[1]));+const ids = new Map(); // slug → its heading ids+const links = []; // [slug, href]+const problems = [];++// A rehype plugin that records the page's heading ids and link targets.+const collect = (slug) => () => (tree) => {+ const walk = (node) => {+ if (node.type === "element" && /^h[1-6]$/.test(node.tagName)) ids.get(slug).add(node.properties.id);+ if (node.type === "element" && node.tagName === "a") links.push([slug, String(node.properties.href)]);+ node.children?.forEach(walk);+ };+ walk(tree);+};++for (const file of (await readdir(dir)).filter((f) => f.endsWith(".mdx"))) {+ const slug = file.slice(0, -".mdx".length);+ ids.set(slug, new Set());+ if (!listed.has(slug)) problems.push(`${file}: not listed in app/docs/pages.ts`);+ try {+ await compile(await readFile(new URL(file, dir)), {+ remarkPlugins: [remarkGfm],+ rehypePlugins: [rehypeSlug, collect(slug)],+ });+ } catch (e) {+ problems.push(`${file}: ${e.message}`);+ }+}+for (const slug of listed) if (!ids.has(slug)) problems.push(`app/docs/pages.ts: no content/docs/${slug}.mdx`);++for (const [from, href] of links) {+ const [path, anchor] = href.startsWith("#") ? [`/docs/${from}`, href.slice(1)] : href.split("#");+ if (path !== "/docs" && !path.startsWith("/docs/")) continue;+ const slug = path.replace(/^\/docs\/?/, "").replace(/\/$/, "");+ if (slug === "" && !anchor) continue; // the docs index+ if (!ids.has(slug)) problems.push(`${from}.mdx: ${href} names no page`);+ else if (anchor && !ids.get(slug).has(anchor)) problems.push(`${from}.mdx: ${href} names no heading`);+}++if (problems.length) {+ console.error(problems.join("\n"));+ process.exit(1);+}+console.log(`Docs: ${ids.size} pages and ${links.length} links check out.`);