@rozek/nanoclaw 1.2.17

package/dist/task-scheduler.js

@@ -0,0 +1,210 @@
+import { CronExpressionParser } from 'cron-parser';
+import fs from 'fs';
+import { ASSISTANT_NAME, SCHEDULER_POLL_INTERVAL, TIMEZONE } from './config.js';
+import { runContainerAgent, writeTasksSnapshot, } from './container-runner.js';
+import { getAllTasks, getDueTasks, getTaskById, logTaskRun, updateTask, updateTaskAfterRun, } from './db.js';
+import { resolveGroupFolderPath } from './group-folder.js';
+import { logger } from './logger.js';
+/**
+ * Compute the next run time for a recurring task, anchored to the
+ * task's scheduled time rather than Date.now() to prevent cumulative
+ * drift on interval-based tasks.
+ *
+ * Co-authored-by: @community-pr-601
+ */
+export function computeNextRun(task) {
+    if (task.schedule_type === 'once')
+        return null;
+    const now = Date.now();
+    if (task.schedule_type === 'cron') {
+        const interval = CronExpressionParser.parse(task.schedule_value, {
+            tz: TIMEZONE,
+        });
+        return interval.next().toISOString();
+    }
+    if (task.schedule_type === 'interval') {
+        const ms = parseInt(task.schedule_value, 10);
+        if (!ms || ms <= 0) {
+            // Guard against malformed interval that would cause an infinite loop
+            logger.warn({ taskId: task.id, value: task.schedule_value }, 'Invalid interval value');
+            return new Date(now + 60_000).toISOString();
+        }
+        // Anchor to the scheduled time, not now, to prevent drift.
+        // Skip past any missed intervals so we always land in the future.
+        let next = new Date(task.next_run).getTime() + ms;
+        while (next <= now) {
+            next += ms;
+        }
+        return new Date(next).toISOString();
+    }
+    return null;
+}
+async function runTask(task, deps) {
+    const startTime = Date.now();
+    let groupDir;
+    try {
+        groupDir = resolveGroupFolderPath(task.group_folder);
+    }
+    catch (err) {
+        const error = err instanceof Error ? err.message : String(err);
+        // Stop retry churn for malformed legacy rows.
+        updateTask(task.id, { status: 'paused' });
+        logger.error({ taskId: task.id, groupFolder: task.group_folder, error }, 'Task has invalid group folder');
+        logTaskRun({
+            task_id: task.id,
+            run_at: new Date().toISOString(),
+            duration_ms: Date.now() - startTime,
+            status: 'error',
+            result: null,
+            error,
+        });
+        return;
+    }
+    fs.mkdirSync(groupDir, { recursive: true });
+    logger.info({ taskId: task.id, group: task.group_folder }, 'Running scheduled task');
+    const groups = deps.registeredGroups();
+    let group = Object.values(groups).find((g) => g.folder === task.group_folder);
+    if (!group) {
+        // Fall back to the first isMain group so that legacy tasks created with
+        // group_folder='main' still run after a web-channel migration.
+        const fallback = Object.values(groups).find((g) => g.isMain === true);
+        if (fallback) {
+            logger.warn({ taskId: task.id, groupFolder: task.group_folder, fallback: fallback.folder }, 'Group not found for task, falling back to main group');
+            group = fallback;
+        }
+        else {
+            logger.error({ taskId: task.id, groupFolder: task.group_folder }, 'Group not found for task');
+            logTaskRun({
+                task_id: task.id,
+                run_at: new Date().toISOString(),
+                duration_ms: Date.now() - startTime,
+                status: 'error',
+                result: null,
+                error: `Group not found: ${task.group_folder}`,
+            });
+            return;
+        }
+    }
+    // Update tasks snapshot for container to read (filtered by group)
+    const isMain = group.isMain === true;
+    const tasks = getAllTasks();
+    writeTasksSnapshot(group.folder, isMain, tasks.map((t) => ({
+        id: t.id,
+        groupFolder: t.group_folder,
+        prompt: t.prompt,
+        schedule_type: t.schedule_type,
+        schedule_value: t.schedule_value,
+        status: t.status,
+        next_run: t.next_run,
+    })));
+    let result = null;
+    let error = null;
+    // For group context mode, use the group's current session
+    const sessions = deps.getSessions();
+    const sessionId = task.context_mode === 'group' ? sessions[task.group_folder] : undefined;
+    // After the task produces a result, close the container promptly.
+    // Tasks are single-turn — no need to wait IDLE_TIMEOUT (30 min) for the
+    // query loop to time out. A short delay handles any final MCP calls.
+    const TASK_CLOSE_DELAY_MS = 10000;
+    let closeTimer = null;
+    const scheduleClose = () => {
+        if (closeTimer)
+            return; // already scheduled
+        closeTimer = setTimeout(() => {
+            logger.debug({ taskId: task.id }, 'Closing task container after result');
+            deps.queue.closeStdin(task.chat_jid);
+        }, TASK_CLOSE_DELAY_MS);
+    };
+    try {
+        const output = await runContainerAgent(group, {
+            prompt: task.prompt,
+            sessionId,
+            groupFolder: group.folder,
+            chatJid: task.chat_jid,
+            isMain,
+            isScheduledTask: true,
+            assistantName: ASSISTANT_NAME,
+        }, (proc, containerName) => deps.onProcess(task.chat_jid, proc, containerName, group.folder), async (streamedOutput) => {
+            if (streamedOutput.result) {
+                result = streamedOutput.result;
+                // Forward result to user (sendMessage handles formatting)
+                await deps.sendMessage(task.chat_jid, streamedOutput.result);
+                scheduleClose();
+            }
+            if (streamedOutput.status === 'success') {
+                deps.queue.notifyIdle(task.chat_jid);
+                scheduleClose(); // Close promptly even when result is null (e.g. IPC-only tasks)
+            }
+            if (streamedOutput.status === 'error') {
+                error = streamedOutput.error || 'Unknown error';
+            }
+        });
+        if (closeTimer)
+            clearTimeout(closeTimer);
+        if (output.status === 'error') {
+            error = output.error || 'Unknown error';
+        }
+        else if (output.result) {
+            // Result was already forwarded to the user via the streaming callback above
+            result = output.result;
+        }
+        logger.info({ taskId: task.id, durationMs: Date.now() - startTime }, 'Task completed');
+    }
+    catch (err) {
+        if (closeTimer)
+            clearTimeout(closeTimer);
+        error = err instanceof Error ? err.message : String(err);
+        logger.error({ taskId: task.id, error }, 'Task failed');
+    }
+    const durationMs = Date.now() - startTime;
+    logTaskRun({
+        task_id: task.id,
+        run_at: new Date().toISOString(),
+        duration_ms: durationMs,
+        status: error ? 'error' : 'success',
+        result,
+        error,
+    });
+    const nextRun = computeNextRun(task);
+    const resultSummary = error
+        ? `Error: ${error}`
+        : result
+            ? result.slice(0, 200)
+            : 'Completed';
+    updateTaskAfterRun(task.id, nextRun, resultSummary);
+}
+let schedulerRunning = false;
+export function startSchedulerLoop(deps) {
+    if (schedulerRunning) {
+        logger.debug('Scheduler loop already running, skipping duplicate start');
+        return;
+    }
+    schedulerRunning = true;
+    logger.info('Scheduler loop started');
+    const loop = async () => {
+        try {
+            const dueTasks = getDueTasks();
+            if (dueTasks.length > 0) {
+                logger.info({ count: dueTasks.length }, 'Found due tasks');
+            }
+            for (const task of dueTasks) {
+                // Re-check task status in case it was paused/cancelled
+                const currentTask = getTaskById(task.id);
+                if (!currentTask || currentTask.status !== 'active') {
+                    continue;
+                }
+                deps.queue.enqueueTask(currentTask.chat_jid, currentTask.id, () => runTask(currentTask, deps));
+            }
+        }
+        catch (err) {
+            logger.error({ err }, 'Error in scheduler loop');
+        }
+        setTimeout(loop, SCHEDULER_POLL_INTERVAL);
+    };
+    loop();
+}
+/** @internal - for tests only. */
+export function _resetSchedulerLoopForTests() {
+    schedulerRunning = false;
+}
+//# sourceMappingURL=task-scheduler.js.map

package/dist/task-scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-scheduler.js","sourceRoot":"","sources":["../src/task-scheduler.ts"],"names":[],"mappings":"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"}

package/dist/task-scheduler.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=task-scheduler.test.d.ts.map

package/dist/task-scheduler.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-scheduler.test.d.ts","sourceRoot":"","sources":["../src/task-scheduler.test.ts"],"names":[],"mappings":""}

package/dist/task-scheduler.test.js

@@ -0,0 +1,107 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { _initTestDatabase, createTask, getTaskById } from './db.js';
+import { _resetSchedulerLoopForTests, computeNextRun, startSchedulerLoop, } from './task-scheduler.js';
+describe('task scheduler', () => {
+    beforeEach(() => {
+        _initTestDatabase();
+        _resetSchedulerLoopForTests();
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('pauses due tasks with invalid group folders to prevent retry churn', async () => {
+        createTask({
+            id: 'task-invalid-folder',
+            group_folder: '../../outside',
+            chat_jid: 'bad@g.us',
+            prompt: 'run',
+            schedule_type: 'once',
+            schedule_value: '2026-02-22T00:00:00.000Z',
+            context_mode: 'isolated',
+            next_run: new Date(Date.now() - 60_000).toISOString(),
+            status: 'active',
+            created_at: '2026-02-22T00:00:00.000Z',
+        });
+        const enqueueTask = vi.fn((_groupJid, _taskId, fn) => {
+            void fn();
+        });
+        startSchedulerLoop({
+            registeredGroups: () => ({}),
+            getSessions: () => ({}),
+            queue: { enqueueTask },
+            onProcess: () => { },
+            sendMessage: async () => { },
+        });
+        await vi.advanceTimersByTimeAsync(10);
+        const task = getTaskById('task-invalid-folder');
+        expect(task?.status).toBe('paused');
+    });
+    it('computeNextRun anchors interval tasks to scheduled time to prevent drift', () => {
+        const scheduledTime = new Date(Date.now() - 2000).toISOString(); // 2s ago
+        const task = {
+            id: 'drift-test',
+            group_folder: 'test',
+            chat_jid: 'test@g.us',
+            prompt: 'test',
+            schedule_type: 'interval',
+            schedule_value: '60000', // 1 minute
+            context_mode: 'isolated',
+            next_run: scheduledTime,
+            last_run: null,
+            last_result: null,
+            status: 'active',
+            created_at: '2026-01-01T00:00:00.000Z',
+        };
+        const nextRun = computeNextRun(task);
+        expect(nextRun).not.toBeNull();
+        // Should be anchored to scheduledTime + 60s, NOT Date.now() + 60s
+        const expected = new Date(scheduledTime).getTime() + 60000;
+        expect(new Date(nextRun).getTime()).toBe(expected);
+    });
+    it('computeNextRun returns null for once-tasks', () => {
+        const task = {
+            id: 'once-test',
+            group_folder: 'test',
+            chat_jid: 'test@g.us',
+            prompt: 'test',
+            schedule_type: 'once',
+            schedule_value: '2026-01-01T00:00:00.000Z',
+            context_mode: 'isolated',
+            next_run: new Date(Date.now() - 1000).toISOString(),
+            last_run: null,
+            last_result: null,
+            status: 'active',
+            created_at: '2026-01-01T00:00:00.000Z',
+        };
+        expect(computeNextRun(task)).toBeNull();
+    });
+    it('computeNextRun skips missed intervals without infinite loop', () => {
+        // Task was due 10 intervals ago (missed)
+        const ms = 60000;
+        const missedBy = ms * 10;
+        const scheduledTime = new Date(Date.now() - missedBy).toISOString();
+        const task = {
+            id: 'skip-test',
+            group_folder: 'test',
+            chat_jid: 'test@g.us',
+            prompt: 'test',
+            schedule_type: 'interval',
+            schedule_value: String(ms),
+            context_mode: 'isolated',
+            next_run: scheduledTime,
+            last_run: null,
+            last_result: null,
+            status: 'active',
+            created_at: '2026-01-01T00:00:00.000Z',
+        };
+        const nextRun = computeNextRun(task);
+        expect(nextRun).not.toBeNull();
+        // Must be in the future
+        expect(new Date(nextRun).getTime()).toBeGreaterThan(Date.now());
+        // Must be aligned to the original schedule grid
+        const offset = (new Date(nextRun).getTime() - new Date(scheduledTime).getTime()) % ms;
+        expect(offset).toBe(0);
+    });
+});
+//# sourceMappingURL=task-scheduler.test.js.map

package/dist/task-scheduler.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-scheduler.test.js","sourceRoot":"","sources":["../src/task-scheduler.test.ts"],"names":[],"mappings":"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"}

package/dist/timezone.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Convert a UTC ISO timestamp to a localized display string.
+ * Uses the Intl API (no external dependencies).
+ */
+export declare function formatLocalTime(utcIso: string, timezone: string): string;
+//# sourceMappingURL=timezone.d.ts.map

package/dist/timezone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezone.d.ts","sourceRoot":"","sources":["../src/timezone.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWxE"}

package/dist/timezone.js

@@ -0,0 +1,17 @@
+/**
+ * Convert a UTC ISO timestamp to a localized display string.
+ * Uses the Intl API (no external dependencies).
+ */
+export function formatLocalTime(utcIso, timezone) {
+    const date = new Date(utcIso);
+    return date.toLocaleString('en-US', {
+        timeZone: timezone,
+        year: 'numeric',
+        month: 'short',
+        day: 'numeric',
+        hour: 'numeric',
+        minute: '2-digit',
+        hour12: true,
+    });
+}
+//# sourceMappingURL=timezone.js.map

package/dist/timezone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezone.js","sourceRoot":"","sources":["../src/timezone.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,QAAgB;IAC9D,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,OAAO,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;QAClC,QAAQ,EAAE,QAAQ;QAClB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,OAAO;QACd,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,IAAI;KACb,CAAC,CAAC;AACL,CAAC"}

package/dist/timezone.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=timezone.test.d.ts.map

package/dist/timezone.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezone.test.d.ts","sourceRoot":"","sources":["../src/timezone.test.ts"],"names":[],"mappings":""}

package/dist/timezone.test.js

@@ -0,0 +1,23 @@
+import { describe, it, expect } from 'vitest';
+import { formatLocalTime } from './timezone.js';
+// --- formatLocalTime ---
+describe('formatLocalTime', () => {
+    it('converts UTC to local time display', () => {
+        // 2026-02-04T18:30:00Z in America/New_York (EST, UTC-5) = 1:30 PM
+        const result = formatLocalTime('2026-02-04T18:30:00.000Z', 'America/New_York');
+        expect(result).toContain('1:30');
+        expect(result).toContain('PM');
+        expect(result).toContain('Feb');
+        expect(result).toContain('2026');
+    });
+    it('handles different timezones', () => {
+        // Same UTC time should produce different local times
+        const utc = '2026-06-15T12:00:00.000Z';
+        const ny = formatLocalTime(utc, 'America/New_York');
+        const tokyo = formatLocalTime(utc, 'Asia/Tokyo');
+        // NY is UTC-4 in summer (EDT), Tokyo is UTC+9
+        expect(ny).toContain('8:00');
+        expect(tokyo).toContain('9:00');
+    });
+});
+//# sourceMappingURL=timezone.test.js.map

package/dist/timezone.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezone.test.js","sourceRoot":"","sources":["../src/timezone.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,0BAA0B;AAE1B,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,kEAAkE;QAClE,MAAM,MAAM,GAAG,eAAe,CAC5B,0BAA0B,EAC1B,kBAAkB,CACnB,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,qDAAqD;QACrD,MAAM,GAAG,GAAG,0BAA0B,CAAC;QACvC,MAAM,EAAE,GAAG,eAAe,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;QACpD,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QACjD,8CAA8C;QAC9C,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,78 @@
+export interface AdditionalMount {
+    hostPath: string;
+    containerPath?: string;
+    readonly?: boolean;
+}
+/**
+ * Mount Allowlist - Security configuration for additional mounts
+ * This file should be stored at ~/.config/nanoclaw/mount-allowlist.json
+ * and is NOT mounted into any container, making it tamper-proof from agents.
+ */
+export interface MountAllowlist {
+    allowedRoots: AllowedRoot[];
+    blockedPatterns: string[];
+    nonMainReadOnly: boolean;
+}
+export interface AllowedRoot {
+    path: string;
+    allowReadWrite: boolean;
+    description?: string;
+}
+export interface ContainerConfig {
+    additionalMounts?: AdditionalMount[];
+    timeout?: number;
+}
+export interface RegisteredGroup {
+    name: string;
+    folder: string;
+    trigger: string;
+    added_at: string;
+    containerConfig?: ContainerConfig;
+    requiresTrigger?: boolean;
+    isMain?: boolean;
+}
+export interface NewMessage {
+    id: string;
+    chat_jid: string;
+    sender: string;
+    sender_name: string;
+    content: string;
+    timestamp: string;
+    is_from_me?: boolean;
+    is_bot_message?: boolean;
+}
+export interface ScheduledTask {
+    id: string;
+    group_folder: string;
+    chat_jid: string;
+    prompt: string;
+    schedule_type: 'cron' | 'interval' | 'once';
+    schedule_value: string;
+    context_mode: 'group' | 'isolated';
+    next_run: string | null;
+    last_run: string | null;
+    last_result: string | null;
+    status: 'active' | 'paused' | 'completed';
+    created_at: string;
+}
+export interface TaskRunLog {
+    task_id: string;
+    run_at: string;
+    duration_ms: number;
+    status: 'success' | 'error';
+    result: string | null;
+    error: string | null;
+}
+export interface Channel {
+    name: string;
+    connect(): Promise<void>;
+    sendMessage(jid: string, text: string): Promise<void>;
+    isConnected(): boolean;
+    ownsJid(jid: string): boolean;
+    disconnect(): Promise<void>;
+    setTyping?(jid: string, isTyping: boolean): Promise<void>;
+    syncGroups?(force: boolean): Promise<void>;
+}
+export type OnInboundMessage = (chatJid: string, message: NewMessage) => void;
+export type OnChatMetadata = (chatJid: string, timestamp: string, name?: string, channel?: string, isGroup?: boolean) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/docs/APPLE-CONTAINER-NETWORKING.md

@@ -0,0 +1,90 @@
+# Apple Container Networking Setup (macOS 26)
+
+Apple Container's vmnet networking requires manual configuration for containers to access the internet. Without this, containers can communicate with the host but cannot reach external services (DNS, HTTPS, APIs).
+
+## Quick Setup
+
+Run these two commands (requires `sudo`):
+
+```bash
+# 1. Enable IP forwarding so the host routes container traffic
+sudo sysctl -w net.inet.ip.forwarding=1
+
+# 2. Enable NAT so container traffic gets masqueraded through your internet interface
+echo "nat on en0 from 192.168.64.0/24 to any -> (en0)" | sudo pfctl -ef -
+```
+
+> **Note:** Replace `en0` with your active internet interface. Check with: `route get 8.8.8.8 | grep interface`
+
+## Making It Persistent
+
+These settings reset on reboot. To make them permanent:
+
+**IP Forwarding** — add to `/etc/sysctl.conf`:
+```
+net.inet.ip.forwarding=1
+```
+
+**NAT Rules** — add to `/etc/pf.conf` (before any existing rules):
+```
+nat on en0 from 192.168.64.0/24 to any -> (en0)
+```
+
+Then reload: `sudo pfctl -f /etc/pf.conf`
+
+## IPv6 DNS Issue
+
+By default, DNS resolvers return IPv6 (AAAA) records before IPv4 (A) records. Since our NAT only handles IPv4, Node.js applications inside containers will try IPv6 first and fail.
+
+The container image and runner are configured to prefer IPv4 via:
+```
+NODE_OPTIONS=--dns-result-order=ipv4first
+```
+
+This is set both in the `Dockerfile` and passed via `-e` flag in `container-runner.ts`.
+
+## Verification
+
+```bash
+# Check IP forwarding is enabled
+sysctl net.inet.ip.forwarding
+# Expected: net.inet.ip.forwarding: 1
+
+# Test container internet access
+container run --rm --entrypoint curl nanoclaw-agent:latest \
+  -s4 --connect-timeout 5 -o /dev/null -w "%{http_code}" https://api.anthropic.com
+# Expected: 404
+
+# Check bridge interface (only exists when a container is running)
+ifconfig bridge100
+```
+
+## Troubleshooting
+
+| Symptom | Cause | Fix |
+|---------|-------|-----|
+| `curl: (28) Connection timed out` | IP forwarding disabled | `sudo sysctl -w net.inet.ip.forwarding=1` |
+| HTTP works, HTTPS times out | IPv6 DNS resolution | Add `NODE_OPTIONS=--dns-result-order=ipv4first` |
+| `Could not resolve host` | DNS not forwarded | Check bridge100 exists, verify pfctl NAT rules |
+| Container hangs after output | Missing `process.exit(0)` in agent-runner | Rebuild container image |
+
+## How It Works
+
+```
+Container VM (192.168.64.x)
+    │
+    ├── eth0 → gateway 192.168.64.1
+    │
+bridge100 (192.168.64.1) ← host bridge, created by vmnet when container runs
+    │
+    ├── IP forwarding (sysctl) routes packets from bridge100 → en0
+    │
+    ├── NAT (pfctl) masquerades 192.168.64.0/24 → en0's IP
+    │
+en0 (your WiFi/Ethernet) → Internet
+```
+
+## References
+
+- [apple/container#469](https://github.com/apple/container/issues/469) — No network from container on macOS 26
+- [apple/container#656](https://github.com/apple/container/issues/656) — Cannot access internet URLs during building