chatwire 0.4.0__tar.gz → 0.4.2__tar.gz

{chatwire-0.4.0/chatwire.egg-info → chatwire-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chatwire
-Version: 0.4.0
+Version: 0.4.2
 Summary: macOS chat-relay bridge: iMessage <-> Telegram, web UI, and pluggable integrations
 Author: Allen Bina
 License: MIT License

{chatwire-0.4.0 → chatwire-0.4.2}/_version.py

@@ -9,4 +9,4 @@ Format: PEP 440-flavored semver. Pre-1.0 dev builds carry a `-dev` suffix
 which the update-check JS treats as "skip the check" (no point pinging
 GitHub when you cloned from main).
 """
-__version__ = "0.4.0"
+__version__ = "0.4.2"

{chatwire-0.4.0 → chatwire-0.4.2/chatwire.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chatwire
-Version: 0.4.0
+Version: 0.4.2
 Summary: macOS chat-relay bridge: iMessage <-> Telegram, web UI, and pluggable integrations
 Author: Allen Bina
 License: MIT License

{chatwire-0.4.0 → chatwire-0.4.2}/chatwire.egg-info/SOURCES.txt

@@ -42,6 +42,14 @@ web/static/themes/default.css
 web/templates/_contact.html
 web/templates/_conversation.html
 web/templates/_conversations.html
+web/templates/_history_page.html
+web/templates/_messages.html
 web/templates/_settings.html
 web/templates/_whitelist_rows.html
-web/templates/index.html
+web/templates/index.html
+web/templates/wizard/_done.html
+web/templates/wizard/_identity.html
+web/templates/wizard/_permissions.html
+web/templates/wizard/_telegram.html
+web/templates/wizard/_whitelist.html
+web/templates/wizard/index.html

{chatwire-0.4.0 → chatwire-0.4.2}/pyproject.toml

@@ -100,7 +100,7 @@ include = ["integrations*", "migrations*", "web*", "templates*"]
 [tool.setuptools.package-data]
 # Web UI ships its templates and static assets inline so a wheel install
 # can serve the UI without the source tree alongside.
-web = ["templates/*.html", "static/**/*"]
+web = ["templates/**/*.html", "static/**/*"]
 # launchd plist templates rendered by `chatwire install-agents`. The CLI
 # resolves them relative to its own __file__, so they need to ship in the
 # wheel (not just the sdist) for a pipx install to work.

{chatwire-0.4.0 → chatwire-0.4.2}/web/main.py

@@ -192,7 +192,8 @@ LEFT JOIN handle h ON m.handle_id = h.ROWID
 JOIN chat_message_join cmj ON cmj.message_id = m.ROWID
 JOIN chat c ON c.ROWID = cmj.chat_id
 WHERE h.id IN ({placeholders}) AND c.style = 45
-ORDER BY m.date DESC
+  {cursor_clause}
+ORDER BY m.date DESC, m.ROWID DESC
 LIMIT ?
 """
 
@@ -207,7 +208,7 @@ WHERE maj.message_id = ?
 # per row so the UI can label "from Alice" above each bubble (group members
 # are only distinguishable by handle_id). Outgoing group rows have handle_id
 # NULL, so sender_handle is empty for those — the UI renders them as "me".
-HISTORY_GROUP_SQL = """
+HISTORY_GROUP_SQL_TEMPLATE = """
 SELECT
     m.ROWID AS rowid,
     m.is_from_me AS is_from_me,
@@ -224,7 +225,8 @@ LEFT JOIN handle h ON m.handle_id = h.ROWID
 JOIN chat_message_join cmj ON cmj.message_id = m.ROWID
 JOIN chat c ON c.ROWID = cmj.chat_id
 WHERE c.guid = ?
-ORDER BY m.date DESC
+  {cursor_clause}
+ORDER BY m.date DESC, m.ROWID DESC
 LIMIT ?
 """
 
@@ -453,13 +455,36 @@ def _group_info(guid: str) -> dict:
     return {"name": name, "members": int(row["members"] or 0)}
 
 
-def history_for(handle: str) -> list[dict]:
+def history_for(
+    handle: str, before: tuple[int, int] | None = None
+) -> tuple[list[dict], bool]:
+    """Most-recent HISTORY_LIMIT messages for a 1:1, oldest-first for render.
+
+    `before` is an optional `(date, rowid)` cursor \u2014 return messages strictly
+    older than that point. Used by the load-older paging endpoint.
+
+    Fetches `HISTORY_LIMIT + 1` rows so we can tell whether more pages exist
+    without an extra round-trip; the extra row is dropped. Returns
+    `(msgs, has_more)`.
+    """
     handles = _handles_for_canonical(handle)
     placeholders = ",".join("?" * len(handles))
-    sql = HISTORY_SQL_TEMPLATE.format(placeholders=placeholders)
+    if before is None:
+        sql = HISTORY_SQL_TEMPLATE.format(
+            placeholders=placeholders, cursor_clause=""
+        )
+        params = (*handles, HISTORY_LIMIT + 1)
+    else:
+        sql = HISTORY_SQL_TEMPLATE.format(
+            placeholders=placeholders,
+            cursor_clause="AND (m.date, m.ROWID) < (?, ?)",
+        )
+        params = (*handles, before[0], before[1], HISTORY_LIMIT + 1)
     conn = _snapshot()
     try:
-        rows = conn.execute(sql, (*handles, HISTORY_LIMIT)).fetchall()
+        rows = conn.execute(sql, params).fetchall()
+        has_more = len(rows) > HISTORY_LIMIT
+        rows = rows[:HISTORY_LIMIT]
         atts_by_msg: dict[int, list[dict]] = defaultdict(list)
         for r in rows:
             if not r["has_attachments"]:
@@ -489,6 +514,7 @@ def history_for(handle: str) -> list[dict]:
         body = (r["text"] or "").replace("\ufffc", "").strip()
         entry = {
             "rowid": r["rowid"],
+            "date": int(r["date"] or 0),
             "from_me": bool(r["is_from_me"]),
             "ts": _ts(r["date"]),
             "text": body,
@@ -497,19 +523,36 @@ def history_for(handle: str) -> list[dict]:
         if entry["from_me"]:
             entry.update(_delivery_status(r))
         out.append(entry)
-    return out
+    return out, has_more
 
 
-def history_for_group(guid: str) -> list[dict]:
+def history_for_group(
+    guid: str, before: tuple[int, int] | None = None
+) -> tuple[list[dict], bool]:
     """Message history for a single group chat, oldest-first for render.
 
     Adds sender_handle/sender_name to every entry so the UI can label
     incoming bubbles with the group member's name; outgoing rows keep the
     existing delivery fields.
+
+    `before` is an optional `(date, rowid)` cursor — return messages strictly
+    older than that point. Used by the load-older paging endpoint. Returns
+    `(msgs, has_more)`; one extra row is fetched and dropped to compute the
+    has-more flag without an extra round-trip.
     """
+    if before is None:
+        sql = HISTORY_GROUP_SQL_TEMPLATE.format(cursor_clause="")
+        params = (guid, HISTORY_LIMIT + 1)
+    else:
+        sql = HISTORY_GROUP_SQL_TEMPLATE.format(
+            cursor_clause="AND (m.date, m.ROWID) < (?, ?)",
+        )
+        params = (guid, before[0], before[1], HISTORY_LIMIT + 1)
     conn = _snapshot()
     try:
-        rows = conn.execute(HISTORY_GROUP_SQL, (guid, HISTORY_LIMIT)).fetchall()
+        rows = conn.execute(sql, params).fetchall()
+        has_more = len(rows) > HISTORY_LIMIT
+        rows = rows[:HISTORY_LIMIT]
         atts_by_msg: dict[int, list[dict]] = defaultdict(list)
         for r in rows:
             if not r["has_attachments"]:
@@ -538,6 +581,7 @@ def history_for_group(guid: str) -> list[dict]:
         sender = r["sender_handle"] or ""
         entry = {
             "rowid": r["rowid"],
+            "date": int(r["date"] or 0),
             "from_me": bool(r["is_from_me"]),
             "ts": _ts(r["date"]),
             "text": body,
@@ -548,7 +592,7 @@ def history_for_group(guid: str) -> list[dict]:
         if entry["from_me"]:
             entry.update(_delivery_status(r))
         out.append(entry)
-    return out
+    return out, has_more
 
 
 def _cap_class_for(cap: str) -> str:
@@ -750,6 +794,27 @@ async def conversations(request: Request):
     return templates.TemplateResponse(request, "_conversations.html", {"convos": convos})
 
 
+def _paging_meta(
+    msgs: list[dict], has_more: bool, handle: str, chat: str,
+) -> dict:
+    """Render `next_url` for the load-older trigger when more pages exist.
+
+    `msgs` is oldest-first as rendered. The cursor for the next page is the
+    (date, rowid) of the *oldest* message currently in the page — `msgs[0]`."""
+    if not has_more or not msgs:
+        return {"has_more": False, "next_url": ""}
+    first = msgs[0]
+    if chat:
+        from urllib.parse import quote
+        url = (f"/history?chat={quote(chat, safe='')}"
+               f"&before_date={first['date']}&before_rowid={first['rowid']}")
+    else:
+        from urllib.parse import quote
+        url = (f"/history?handle={quote(handle, safe='')}"
+               f"&before_date={first['date']}&before_rowid={first['rowid']}")
+    return {"has_more": True, "next_url": url}
+
+
 @app.get("/conversation", response_class=HTMLResponse)
 async def conversation(request: Request, handle: str = "", chat: str = ""):
     """Render a conversation. Exactly one of `handle` (1:1) or `chat`
@@ -757,29 +822,64 @@ async def conversation(request: Request, handle: str = "", chat: str = ""):
     if chat:
         if chat not in wl_all_groups():
             raise HTTPException(403, "group not in whitelist")
-        msgs = await asyncio.to_thread(history_for_group, chat)
+        msgs, has_more = await asyncio.to_thread(history_for_group, chat)
         info = await asyncio.to_thread(_group_info, chat)
-        return templates.TemplateResponse(request, "_conversation.html", {
+        ctx = {
             "handle": "",
             "chat": chat,
             "name": info["name"],
             "subtitle": f"{info['members']} members" if info["members"] else "group chat",
             "is_group": True,
             "msgs": msgs,
-        })
+        }
+        ctx.update(_paging_meta(msgs, has_more, "", chat))
+        return templates.TemplateResponse(request, "_conversation.html", ctx)
     if not handle:
         raise HTTPException(400, "missing handle or chat")
     if handle.lower() not in relay_handles():
         raise HTTPException(403, "handle not in relay scope")
-    msgs = await asyncio.to_thread(history_for, handle)
-    return templates.TemplateResponse(request, "_conversation.html", {
+    msgs, has_more = await asyncio.to_thread(history_for, handle)
+    ctx = {
         "handle": handle,
         "chat": "",
         "name": _name(handle),
         "subtitle": handle,
         "is_group": False,
         "msgs": msgs,
-    })
+    }
+    ctx.update(_paging_meta(msgs, has_more, handle, ""))
+    return templates.TemplateResponse(request, "_conversation.html", ctx)
+
+
+@app.get("/history", response_class=HTMLResponse)
+async def history(
+    request: Request,
+    handle: str = "",
+    chat: str = "",
+    before_date: int = 0,
+    before_rowid: int = 0,
+):
+    """Older-message page for an open conversation. Returns the bubble
+    fragment (oldest-first) plus a fresh load-older trigger if there are
+    more pages still. Same authz as `/conversation`."""
+    if before_date <= 0 or before_rowid <= 0:
+        raise HTTPException(400, "missing or invalid cursor")
+    cursor = (before_date, before_rowid)
+    if chat:
+        if chat not in wl_all_groups():
+            raise HTTPException(403, "group not in whitelist")
+        msgs, has_more = await asyncio.to_thread(history_for_group, chat, cursor)
+        ctx = {"is_group": True, "msgs": msgs}
+        ctx.update(_paging_meta(msgs, has_more, "", chat))
+        return templates.TemplateResponse(request, "_history_page.html", ctx)
+    if not handle:
+        raise HTTPException(400, "missing handle or chat")
+    if handle.lower() not in relay_handles():
+        raise HTTPException(403, "handle not in relay scope")
+    msgs, has_more = await asyncio.to_thread(history_for, handle, cursor)
+    ctx = {"is_group": False, "msgs": msgs}
+    ctx.update(_paging_meta(msgs, has_more, handle, ""))
+    return templates.TemplateResponse(request, "_history_page.html", ctx)
 
 
 async def _send_via_ctx_or_direct(

{chatwire-0.4.0 → chatwire-0.4.2}/web/static/style.css

@@ -368,6 +368,13 @@ body { display: grid; grid-template-columns: 320px 1fr; }
 
 .messages { flex: 1; overflow-y: auto; padding: 24px 20px; display: flex; flex-direction: column; gap: 4px; }
 .messages > .msg:first-child { margin-top: auto; }  /* push pinned to bottom when few msgs */
+.load-older {
+  align-self: center;
+  padding: 8px 0 4px;
+  font-size: 18px;
+  color: var(--app-color-text-faint);
+  flex-shrink: 0;
+}
 .msg { display: flex; flex-direction: column; max-width: 70%; }
 .msg.me { align-self: flex-end; align-items: flex-end; }
 .msg.them { align-self: flex-start; align-items: flex-start; }

{chatwire-0.4.0 → chatwire-0.4.2}/web/templates/_conversation.html

@@ -27,46 +27,15 @@
   </header>
 
   <div class="messages" id="messages">
-    {% for m in msgs %}
-    <div class="msg {{ 'me' if m.from_me else 'them' }}{% if m.from_me and m.service == 'SMS' %} sms{% endif %}">
-      {% if is_group and not m.from_me and m.sender_name %}
-        <div class="sender">{{ m.sender_name }}</div>
-      {% endif %}
-      {% for a in m.attachments %}
-        {% if not a.ready %}
-          <div class="attach pending">
-            <sl-spinner></sl-spinner>
-            <span>syncing attachment…</span>
-          </div>
-        {% elif a.kind == 'image' %}
-          <a class="media" href="/attachment?path={{ a.path | urlencode }}" target="_blank">
-            <img src="/attachment?path={{ a.path | urlencode }}&size=thumb" alt="{{ a.name }}" loading="lazy">
-          </a>
-        {% elif a.kind == 'video' %}
-          <video class="media" controls preload="metadata"
-                 src="/attachment?path={{ a.path | urlencode }}"
-                 onerror="this.outerHTML = '<a class=&quot;bubble file-link&quot; href=&quot;/attachment?path={{ a.path | urlencode }}&quot; target=&quot;_blank&quot;>🎬 {{ a.name }}</a>'"></video>
-        {% elif a.kind == 'audio' %}
-          <audio class="media" controls preload="none" src="/attachment?path={{ a.path | urlencode }}"></audio>
-        {% else %}
-          <a class="bubble file-link" href="/attachment?path={{ a.path | urlencode }}" target="_blank">📎 {{ a.name }}</a>
-        {% endif %}
-      {% endfor %}
-      {% if m.text %}<div class="bubble"><div class="text">{{ m.text }}</div></div>{% endif %}
-      <div class="ts">
-        {{ m.ts }}
-        {% if m.from_me and m.status and m.status != 'delivered' %}
-          {% if m.status == 'failed' %}
-            <sl-badge class="delivery" variant="danger" pill title="{{ m.hint }}">{{ m.label }}</sl-badge>
-          {% elif m.status == 'sent' %}
-            <sl-badge class="delivery" variant="neutral" pill title="{{ m.hint }}">sent</sl-badge>
-          {% else %}
-            <sl-badge class="delivery" variant="warning" pill pulse title="{{ m.hint }}">{{ m.label }}</sl-badge>
-          {% endif %}
-        {% endif %}
-      </div>
+    {% if has_more %}
+    <div class="load-older"
+         hx-get="{{ next_url }}"
+         hx-trigger="intersect once"
+         hx-swap="outerHTML">
+      <sl-spinner></sl-spinner>
     </div>
-    {% endfor %}
+    {% endif %}
+    {% include "_messages.html" %}
   </div>
 
   <div id="send-banner" class="send-banner" hidden></div>
@@ -226,6 +195,26 @@
   (function() {
     const m = document.getElementById('messages');
     if (m) m.scrollTop = m.scrollHeight;
+
+    // Scroll-anchor preservation around load-older swaps. When the trigger
+    // is replaced with a page of older bubbles + a fresh trigger, content
+    // grows above the user's view; we capture distance-from-bottom before
+    // the swap and restore it after so the user stays anchored on the
+    // message they were reading instead of being kicked to the new top.
+    if (m) {
+      let anchor = null;
+      m.addEventListener('htmx:beforeSwap', (e) => {
+        const t = e.detail && e.detail.target;
+        if (!t || !t.classList || !t.classList.contains('load-older')) return;
+        anchor = m.scrollHeight - m.scrollTop;
+      });
+      m.addEventListener('htmx:afterSwap', () => {
+        if (anchor === null) return;
+        m.scrollTop = m.scrollHeight - anchor;
+        anchor = null;
+      });
+    }
+
     const mainEl = document.getElementById('main');
     {% if is_group %}
     mainEl.dataset.chat = '{{ chat }}';

chatwire-0.4.2/web/templates/_history_page.html

@@ -0,0 +1,13 @@
+{# Response to GET /history. Replaces the load-older trigger in-place
+   (hx-swap=outerHTML) with: a new trigger for the next page (if any), then
+   the page of older messages (oldest-first). The conversation's #messages
+   container handles scroll-anchor preservation around this swap. #}
+{% if has_more %}
+<div class="load-older"
+     hx-get="{{ next_url }}"
+     hx-trigger="intersect once"
+     hx-swap="outerHTML">
+  <sl-spinner></sl-spinner>
+</div>
+{% endif %}
+{% include "_messages.html" %}

chatwire-0.4.2/web/templates/_messages.html

@@ -0,0 +1,43 @@
+{# Message bubble loop. Shared by _conversation.html (initial render) and
+   _history_page.html (load-older paging). Expects `msgs` (list, oldest-first)
+   and `is_group` (bool). #}
+{% for m in msgs %}
+<div class="msg {{ 'me' if m.from_me else 'them' }}{% if m.from_me and m.service == 'SMS' %} sms{% endif %}">
+  {% if is_group and not m.from_me and m.sender_name %}
+    <div class="sender">{{ m.sender_name }}</div>
+  {% endif %}
+  {% for a in m.attachments %}
+    {% if not a.ready %}
+      <div class="attach pending">
+        <sl-spinner></sl-spinner>
+        <span>syncing attachment…</span>
+      </div>
+    {% elif a.kind == 'image' %}
+      <a class="media" href="/attachment?path={{ a.path | urlencode }}" target="_blank">
+        <img src="/attachment?path={{ a.path | urlencode }}&size=thumb" alt="{{ a.name }}" loading="lazy">
+      </a>
+    {% elif a.kind == 'video' %}
+      <video class="media" controls preload="metadata"
+             src="/attachment?path={{ a.path | urlencode }}"
+             onerror="this.outerHTML = '<a class=&quot;bubble file-link&quot; href=&quot;/attachment?path={{ a.path | urlencode }}&quot; target=&quot;_blank&quot;>🎬 {{ a.name }}</a>'"></video>
+    {% elif a.kind == 'audio' %}
+      <audio class="media" controls preload="none" src="/attachment?path={{ a.path | urlencode }}"></audio>
+    {% else %}
+      <a class="bubble file-link" href="/attachment?path={{ a.path | urlencode }}" target="_blank">📎 {{ a.name }}</a>
+    {% endif %}
+  {% endfor %}
+  {% if m.text %}<div class="bubble"><div class="text">{{ m.text }}</div></div>{% endif %}
+  <div class="ts">
+    {{ m.ts }}
+    {% if m.from_me and m.status and m.status != 'delivered' %}
+      {% if m.status == 'failed' %}
+        <sl-badge class="delivery" variant="danger" pill title="{{ m.hint }}">{{ m.label }}</sl-badge>
+      {% elif m.status == 'sent' %}
+        <sl-badge class="delivery" variant="neutral" pill title="{{ m.hint }}">sent</sl-badge>
+      {% else %}
+        <sl-badge class="delivery" variant="warning" pill pulse title="{{ m.hint }}">{{ m.label }}</sl-badge>
+      {% endif %}
+    {% endif %}
+  </div>
+</div>
+{% endfor %}

chatwire-0.4.2/web/templates/wizard/_done.html

@@ -0,0 +1,35 @@
+<section class="wizard-step">
+  <h2>Setup complete</h2>
+  <p class="lead">
+    Configuration saved to <code>~/.chatwire/config.json</code>
+    (chmod 600). The bridge agents need a restart to pick up new env vars.
+  </p>
+
+  <div class="wizard-restart">
+    <h3>Restart the agents</h3>
+    <p>From a terminal on this Mac:</p>
+    <pre><code>launchctl kickstart -k gui/$(id -u)/dev.chatwire.bridge
+launchctl kickstart -k gui/$(id -u)/dev.chatwire.web</code></pre>
+    <p>
+      <small>If you installed with a different label prefix, substitute that.
+      <code>chatwire doctor</code> lists the currently-loaded labels.</small>
+    </p>
+  </div>
+
+  <div class="wizard-restart">
+    <h3>What's next</h3>
+    <ul>
+      <li><a href="/">Open the main UI</a> — by the time you click, the web agent's restart will be visible (the page reloads itself).</li>
+      <li><a href="/setup?step=permissions">Re-run any wizard step</a> if you want to tweak settings.</li>
+      <li>Tail logs: <code>chatwire logs -f</code></li>
+    </ul>
+  </div>
+
+  <div class="wizard-actions">
+    <sl-button type="button"
+               hx-get="/setup/step/whitelist"
+               hx-target="#wizard"
+               hx-swap="innerHTML">← Back</sl-button>
+    <sl-button variant="primary" href="/">Open the bridge →</sl-button>
+  </div>
+</section>

chatwire-0.4.2/web/templates/wizard/_identity.html

@@ -0,0 +1,49 @@
+<section class="wizard-step">
+  <h2>Step 2 — your iMessage handles</h2>
+  <p class="lead">
+    Pick which handles are <em>you</em>. The bridge uses these to filter
+    out your own messages from the relay (otherwise replies you send from
+    one device would echo back as inbound).
+  </p>
+
+  <form hx-post="/setup/save/identity"
+        hx-target="#wizard"
+        hx-swap="innerHTML">
+    {% if all_candidates %}
+    <ul class="self-picks">
+      {% for h in all_candidates %}
+      <li>
+        <label>
+          <input type="checkbox" name="self" value="{{ h }}"
+                 {% if h in configured %}checked{% endif %}>
+          <code>{{ h }}</code>
+          {% if h in detected and h not in configured %}<small>(detected)</small>{% endif %}
+          {% if h in configured and h not in detected %}<small>(configured)</small>{% endif %}
+        </label>
+      </li>
+      {% endfor %}
+    </ul>
+    {% else %}
+    <p class="wizard-hint">
+      No accounts detected in <code>chat.db</code> yet. If Messages.app has
+      never run on this Mac, sign in first, send a test message, then come
+      back.
+    </p>
+    {% endif %}
+
+    <label class="wizard-field">
+      <span>Add another handle</span>
+      <sl-input name="extra" placeholder="+15551234567 or you@icloud.com"></sl-input>
+      <small>Comma- or space-separated. Used if your account doesn't appear
+      above for some reason (e.g. shared-account quirks).</small>
+    </label>
+
+    <div class="wizard-actions">
+      <sl-button type="button"
+                 hx-get="/setup/step/permissions"
+                 hx-target="#wizard"
+                 hx-swap="innerHTML">← Back</sl-button>
+      <sl-button type="submit" variant="primary">Save and continue →</sl-button>
+    </div>
+  </form>
+</section>

chatwire-0.4.2/web/templates/wizard/_permissions.html

@@ -0,0 +1,66 @@
+<section class="wizard-step">
+  <h2>Step 1 — macOS permissions</h2>
+  <p class="lead">
+    The bridge needs two macOS privacy grants. Both are tied to the
+    python.org Python binary at
+    <code>/Library/Frameworks/Python.framework/Versions/3.14/Resources/Python.app</code>
+    (your install path may vary). Apple does not allow these to be granted
+    by an installer — you'll click through System Settings yourself.
+  </p>
+
+  <div class="probe-row">
+    <div class="probe-name">
+      <strong>Full Disk Access</strong>
+      <small>required to read <code>~/Library/Messages/chat.db</code></small>
+    </div>
+    <div class="probe-status probe-{{ fda.status }}">
+      {% if fda.status == "ok" %}✓ {{ fda.detail }}
+      {% else %}✗ {{ fda.detail }}{% endif %}
+    </div>
+    <div class="probe-action">
+      <sl-button href="x-apple.systempreferences:com.apple.preference.security?Privacy_AllFiles">
+        Open Settings
+      </sl-button>
+    </div>
+  </div>
+
+  <div class="probe-row">
+    <div class="probe-name">
+      <strong>Automation → Messages</strong>
+      <small>required to send via AppleScript</small>
+    </div>
+    <div class="probe-status probe-{{ automation.status }}">
+      {% if automation.status == "ok" %}✓ {{ automation.detail }}
+      {% else %}✗ {{ automation.detail }}{% endif %}
+    </div>
+    <div class="probe-action">
+      <sl-button href="x-apple.systempreferences:com.apple.preference.security?Privacy_Automation">
+        Open Settings
+      </sl-button>
+    </div>
+  </div>
+
+  <div class="wizard-actions">
+    <sl-button type="button"
+               hx-post="/setup/check/permissions"
+               hx-target="#wizard"
+               hx-swap="innerHTML">
+      Re-check
+    </sl-button>
+    <sl-button type="button"
+               variant="primary"
+               {% if fda.status != "ok" or automation.status != "ok" %}disabled{% endif %}
+               hx-get="/setup/step/identity"
+               hx-target="#wizard"
+               hx-swap="innerHTML">
+      Next →
+    </sl-button>
+  </div>
+
+  {% if fda.status != "ok" or automation.status != "ok" %}
+  <p class="wizard-hint">
+    Both grants must show ✓ before you can advance. After granting, click
+    Re-check.
+  </p>
+  {% endif %}
+</section>

chatwire-0.4.2/web/templates/wizard/_telegram.html

@@ -0,0 +1,60 @@
+<section class="wizard-step">
+  <h2>Step 3 — Telegram bot</h2>
+  <p class="lead">
+    Telegram is the default integration. Skip it (leave blank) if you only
+    want the web UI.
+  </p>
+
+  <details class="wizard-howto">
+    <summary>How to get a bot token</summary>
+    <ol>
+      <li>Open Telegram, message <a href="https://t.me/BotFather" target="_blank" rel="noopener">@BotFather</a>.</li>
+      <li>Send <code>/newbot</code>. Pick a name and a username (must end in <code>bot</code>).</li>
+      <li>BotFather replies with a token like <code>123456:ABC-DEF...</code>. Paste it below.</li>
+      <li>Message <a href="https://t.me/userinfobot" target="_blank" rel="noopener">@userinfobot</a> to get
+        your numeric user ID. That goes in the second field.</li>
+    </ol>
+  </details>
+
+  <form hx-post="/setup/save/telegram"
+        hx-target="#wizard"
+        hx-swap="innerHTML">
+    <label class="wizard-field">
+      <span>Bot token</span>
+      <sl-input name="token" id="tg-token"
+                placeholder="123456:ABC-DEF..."
+                value="{{ token }}"
+                autocomplete="off"
+                spellcheck="false"></sl-input>
+    </label>
+
+    <label class="wizard-field">
+      <span>Your Telegram user IDs (comma-separated)</span>
+      <sl-input name="allowed_user_ids"
+                placeholder="123456789"
+                value="{{ allowed_user_ids }}"
+                autocomplete="off"
+                spellcheck="false"></sl-input>
+      <small>Only these users can talk to the bot. The bridge ignores everyone else.</small>
+    </label>
+
+    <div class="probe-row">
+      <sl-button type="button"
+                 hx-post="/setup/test/telegram"
+                 hx-include="#tg-token"
+                 hx-target="#tg-test-result"
+                 hx-swap="innerHTML">
+        Test token
+      </sl-button>
+      <span id="tg-test-result" class="probe-status"></span>
+    </div>
+
+    <div class="wizard-actions">
+      <sl-button type="button"
+                 hx-get="/setup/step/identity"
+                 hx-target="#wizard"
+                 hx-swap="innerHTML">← Back</sl-button>
+      <sl-button type="submit" variant="primary">Save and continue →</sl-button>
+    </div>
+  </form>
+</section>

chatwire-0.4.2/web/templates/wizard/_whitelist.html

@@ -0,0 +1,26 @@
+<section class="wizard-step">
+  <h2>Step 4 — Whitelist</h2>
+  <p class="lead">
+    Pick whose messages should be relayed. Anyone not on this list is
+    ignored — their messages stay in Messages.app on your Mac and never
+    reach Telegram or the web UI. You can change this any time later from
+    Settings.
+  </p>
+
+  <div hx-get="/settings"
+       hx-trigger="load"
+       hx-swap="outerHTML">
+    <p class="loading">loading whitelist…</p>
+  </div>
+
+  <div class="wizard-actions">
+    <sl-button type="button"
+               hx-get="/setup/step/telegram"
+               hx-target="#wizard"
+               hx-swap="innerHTML">← Back</sl-button>
+    <sl-button type="button" variant="primary"
+               hx-get="/setup/step/done"
+               hx-target="#wizard"
+               hx-swap="innerHTML">Continue →</sl-button>
+  </div>
+</section>

chatwire-0.4.2/web/templates/wizard/index.html

@@ -0,0 +1,44 @@
+<!doctype html>
+<html lang="en" data-theme="default">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
+  <title>iMessage bridge — setup</title>
+  <link rel="icon" type="image/svg+xml" href="/static/favicon.svg">
+  <!-- Shoelace component library — pinned, see docs/THEME_REDESIGN_PLAN.md. -->
+  <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@shoelace-style/shoelace@2.18.0/cdn/themes/light.css">
+  <script type="module" src="https://cdn.jsdelivr.net/npm/@shoelace-style/shoelace@2.18.0/cdn/shoelace-autoloader.js"></script>
+  <link rel="stylesheet" href="/static/themes/_bridge.css">
+  <link rel="stylesheet" href="/static/themes/default.css">
+  <link rel="stylesheet" href="/static/style.css">
+  <script src="https://unpkg.com/htmx.org@1.9.10" defer></script>
+</head>
+<body class="wizard-body">
+  <div class="wizard-shell">
+    <aside class="wizard-nav">
+      <h1>Setup</h1>
+      <ol>
+        {% for s in steps %}
+        <li class="{% if s == step %}active{% endif %} {% if loop.index0 < step_index %}done{% endif %}">
+          <a href="/setup?step={{ s }}"
+             hx-get="/setup/step/{{ s }}"
+             hx-target="#wizard"
+             hx-swap="innerHTML">
+            <span class="num">{% if loop.index0 < step_index %}✓{% else %}{{ loop.index }}{% endif %}</span>
+            <span class="label">{{ step_titles[s] }}</span>
+          </a>
+        </li>
+        {% endfor %}
+      </ol>
+      <p class="wizard-foot">
+        Once configured, the main UI is at
+        <a href="/">/</a>.
+      </p>
+    </aside>
+
+    <main id="wizard" class="wizard-main">
+      {% include "wizard/_" + step + ".html" %}
+    </main>
+  </div>
+</body>
+</html>