@synap-core/cli 1.7.0 → 1.10.0

package/dist/commands/agent-chat.d.ts

@@ -0,0 +1,47 @@
+/**
+ * synap agent ask / chat
+ *
+ * Hold a REAL conversation with the workspace's deployed Intelligence-Service
+ * agent (the orchestrator / co-founder). Unlike `synap agent run` — which hits
+ * the IS /v1/chat/completions door directly and stores a research entity — this
+ * drives the SAME channel+trigger path the browser uses, so the deployed agent
+ * answers with full workspace context, tools, and governance.
+ *
+ * Verified path (Hub Protocol REST, all under `${podUrl}/api/hub`):
+ *   1. resolve/create a WORKSPACE-scoped THREAD channel
+ *        POST /threads { userId, workspaceId, title, externalSource, externalId }
+ *      channelType defaults to "thread" + scope defaults to "workspace" — this is
+ *      NOT the pod-wide personal channel (`/channels/personal` is pod-scoped).
+ *      A stable externalId dedups, so repeated `agent ask` calls CONTINUE the
+ *      same conversation (multi-turn) unless `--new` forces a fresh thread.
+ *   2. post the user turn + trigger the agent
+ *        POST /threads/:id/messages { role:"user", content, userId, autoRespond:true }
+ *      autoRespond enqueues an A2AI pg-boss job → IS /api/chat/stream (agentType
+ *      "meta" → OrchestratorAgent). The reply is ASYNC.
+ *   3. poll for the assistant reply
+ *        GET /threads/:id/messages  (asc by timestamp)
+ *      The a2ai worker persists the answer as a role="assistant" message. We poll
+ *      until a NEW assistant message (id not seen before the post) appears.
+ */
+export interface AgentAskOpts {
+    message?: string;
+    workspace?: string;
+    thread?: string;
+    agentType?: string;
+    new?: boolean;
+    timeout?: string;
+    json?: boolean;
+    podUrl?: string;
+    apiKey?: string;
+}
+export interface AgentChatOpts {
+    workspace?: string;
+    thread?: string;
+    agentType?: string;
+    new?: boolean;
+    timeout?: string;
+    podUrl?: string;
+    apiKey?: string;
+}
+export declare function agentAsk(opts: AgentAskOpts): Promise<void>;
+export declare function agentChat(opts: AgentChatOpts): Promise<void>;

package/dist/commands/agent-chat.js

@@ -0,0 +1,250 @@
+/**
+ * synap agent ask / chat
+ *
+ * Hold a REAL conversation with the workspace's deployed Intelligence-Service
+ * agent (the orchestrator / co-founder). Unlike `synap agent run` — which hits
+ * the IS /v1/chat/completions door directly and stores a research entity — this
+ * drives the SAME channel+trigger path the browser uses, so the deployed agent
+ * answers with full workspace context, tools, and governance.
+ *
+ * Verified path (Hub Protocol REST, all under `${podUrl}/api/hub`):
+ *   1. resolve/create a WORKSPACE-scoped THREAD channel
+ *        POST /threads { userId, workspaceId, title, externalSource, externalId }
+ *      channelType defaults to "thread" + scope defaults to "workspace" — this is
+ *      NOT the pod-wide personal channel (`/channels/personal` is pod-scoped).
+ *      A stable externalId dedups, so repeated `agent ask` calls CONTINUE the
+ *      same conversation (multi-turn) unless `--new` forces a fresh thread.
+ *   2. post the user turn + trigger the agent
+ *        POST /threads/:id/messages { role:"user", content, userId, autoRespond:true }
+ *      autoRespond enqueues an A2AI pg-boss job → IS /api/chat/stream (agentType
+ *      "meta" → OrchestratorAgent). The reply is ASYNC.
+ *   3. poll for the assistant reply
+ *        GET /threads/:id/messages  (asc by timestamp)
+ *      The a2ai worker persists the answer as a role="assistant" message. We poll
+ *      until a NEW assistant message (id not seen before the post) appears.
+ */
+import chalk from "chalk";
+import { createInterface } from "node:readline";
+import { resolveHubConfig, resolveUserId, hubGet, hubPost, renderHubError, } from "../lib/hub-client.js";
+import { unwrapList } from "../lib/unwrapList.js";
+import { log } from "../utils/logger.js";
+// ── Shared helpers ──────────────────────────────────────────────────────────────
+/** Resolve a `--workspace <id|name>` value (or the active lens) to a workspace id. */
+async function resolveWorkspace(cfg, wanted) {
+    // Explicit flag first — accept an id OR a name.
+    if (wanted) {
+        let list = [];
+        try {
+            const res = await hubGet("/workspaces", {}, cfg);
+            list = unwrapList(res, ["workspaces"]);
+        }
+        catch {
+            // If the list door fails, fall through and treat `wanted` as a raw id.
+        }
+        const byId = list.find((w) => String(w.id ?? "") === wanted);
+        if (byId)
+            return String(byId.id);
+        const byName = list.find((w) => String(w.name ?? "").toLowerCase() === wanted.toLowerCase());
+        if (byName)
+            return String(byName.id);
+        // No match by name; assume the caller passed a literal id.
+        return wanted;
+    }
+    // Fall back to the active lens / configured workspace.
+    if (cfg.workspaceId)
+        return cfg.workspaceId;
+    throw new Error("No workspace. Pass --workspace <id|name> or set one with `synap use <workspace>`.");
+}
+/**
+ * Resolve or create the workspace-scoped THREAD channel used for this chat.
+ * Returns its id. A stable externalId keeps the conversation continuous across
+ * invocations; `--new` (or `--thread`) overrides.
+ */
+async function resolveChannel(cfg, userId, workspaceId, opts) {
+    if (opts.thread)
+        return opts.thread;
+    const body = {
+        userId,
+        workspaceId,
+        title: "CLI agent chat",
+    };
+    if (!opts.new) {
+        // Stable per-(user, workspace) key → POST /threads fast-path dedups on it,
+        // so successive calls reuse ONE thread and the agent sees prior turns.
+        body.externalSource = "cli";
+        body.externalId = `agent-chat:${workspaceId}`;
+    }
+    const res = (await hubPost("/threads", body, cfg));
+    if (!res?.id)
+        throw new Error("Failed to resolve chat channel (no id returned).");
+    return res.id;
+}
+/** Fetch all messages in a thread (asc by timestamp). */
+async function fetchMessages(cfg, channelId) {
+    const res = await hubGet(`/threads/${channelId}/messages`, {}, cfg);
+    return unwrapList(res, ["messages"]);
+}
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+/**
+ * Post one user turn and wait for the deployed agent's reply.
+ *
+ * @returns the assistant reply text, or null on timeout.
+ */
+async function sendTurnAndAwaitReply(cfg, channelId, userId, message, agentType, timeoutMs, onWait) {
+    // Snapshot the assistant messages that already exist so we can tell OUR reply
+    // apart from history — the reliable "reply is ready" signal.
+    const before = await fetchMessages(cfg, channelId);
+    const seenAssistant = new Set(before.filter((m) => m.role === "assistant").map((m) => m.id));
+    const postBody = {
+        role: "user",
+        content: message,
+        userId,
+        autoRespond: true,
+    };
+    // agentType is a forward-compat hint: the backend autoRespond door currently
+    // routes every reply to the workspace orchestrator ("meta"). Stored in metadata
+    // so a future selectable-agent door can honor it.
+    if (agentType)
+        postBody.metadata = { requestedAgentType: agentType };
+    const posted = (await hubPost(`/threads/${channelId}/messages`, postBody, cfg));
+    const userMessageId = posted?.messageId ?? "";
+    const deadline = Date.now() + timeoutMs;
+    const intervalMs = 2000;
+    while (Date.now() < deadline) {
+        await sleep(intervalMs);
+        onWait?.();
+        let msgs;
+        try {
+            msgs = await fetchMessages(cfg, channelId);
+        }
+        catch {
+            continue; // transient — keep polling until the deadline
+        }
+        const reply = msgs.find((m) => m.role === "assistant" && !seenAssistant.has(m.id));
+        if (reply)
+            return { reply: reply.content, userMessageId };
+    }
+    return { reply: null, userMessageId };
+}
+function parseTimeout(raw) {
+    const secs = raw ? parseInt(raw, 10) : NaN;
+    return Number.isFinite(secs) && secs > 0 ? secs * 1000 : 90_000;
+}
+const TIMEOUT_HINT = "The agent did not respond in time. The Intelligence Service may be down or " +
+    "still working. Retry, or raise --timeout. Check IS health: `synap status`.";
+// ── agent ask (single-shot) ─────────────────────────────────────────────────────
+export async function agentAsk(opts) {
+    const message = (opts.message ?? "").trim();
+    if (!message) {
+        console.error(chalk.red("Error: a message is required. Usage: synap agent ask \"your message\""));
+        process.exit(1);
+    }
+    try {
+        const cfg = await resolveHubConfig(opts);
+        const userId = await resolveUserId(cfg);
+        const workspaceId = await resolveWorkspace(cfg, opts.workspace);
+        const channelId = await resolveChannel(cfg, userId, workspaceId, opts);
+        const timeoutMs = parseTimeout(opts.timeout);
+        if (!opts.json) {
+            log.dim(`workspace ${workspaceId}  ·  thread ${channelId}`);
+            process.stdout.write(chalk.dim("    waiting for agent"));
+        }
+        const { reply } = await sendTurnAndAwaitReply(cfg, channelId, userId, message, opts.agentType, timeoutMs, () => {
+            if (!opts.json)
+                process.stdout.write(chalk.dim("."));
+        });
+        if (!opts.json)
+            process.stdout.write("\n");
+        if (reply === null) {
+            if (opts.json) {
+                console.log(JSON.stringify({ ok: false, error: "timeout", workspaceId, threadId: channelId }, null, 2));
+            }
+            else {
+                log.error(TIMEOUT_HINT);
+            }
+            process.exit(1);
+        }
+        if (opts.json) {
+            console.log(JSON.stringify({ ok: true, reply, workspaceId, threadId: channelId }, null, 2));
+        }
+        else {
+            log.blank();
+            console.log(chalk.green("  agent") + chalk.dim("  ▸"));
+            console.log(reply.split("\n").map((l) => "  " + l).join("\n"));
+            log.blank();
+        }
+    }
+    catch (e) {
+        if (opts.json) {
+            console.log(JSON.stringify({ ok: false, error: e.message }, null, 2));
+        }
+        else {
+            renderHubError(e);
+        }
+        process.exit(1);
+    }
+}
+// ── agent chat (interactive REPL) ────────────────────────────────────────────────
+export async function agentChat(opts) {
+    let cfg;
+    let userId;
+    let workspaceId;
+    let channelId;
+    const timeoutMs = parseTimeout(opts.timeout);
+    try {
+        cfg = await resolveHubConfig(opts);
+        userId = await resolveUserId(cfg);
+        workspaceId = await resolveWorkspace(cfg, opts.workspace);
+        channelId = await resolveChannel(cfg, userId, workspaceId, opts);
+    }
+    catch (e) {
+        renderHubError(e);
+        process.exit(1);
+        return;
+    }
+    log.heading("Synap agent chat");
+    log.dim(`workspace ${workspaceId}  ·  thread ${channelId}`);
+    log.dim("Type your message and press enter. /exit or Ctrl-D to quit.");
+    log.blank();
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const prompt = () => rl.setPrompt(chalk.cyan("you ▸ "));
+    prompt();
+    rl.prompt();
+    rl.on("line", async (line) => {
+        const message = line.trim();
+        if (!message) {
+            rl.prompt();
+            return;
+        }
+        if (message === "/exit" || message === "/quit") {
+            rl.close();
+            return;
+        }
+        rl.pause();
+        process.stdout.write(chalk.dim("    waiting for agent"));
+        try {
+            const { reply } = await sendTurnAndAwaitReply(cfg, channelId, userId, message, opts.agentType, timeoutMs, () => process.stdout.write(chalk.dim(".")));
+            process.stdout.write("\n");
+            if (reply === null) {
+                log.error(TIMEOUT_HINT);
+            }
+            else {
+                console.log(chalk.green("agent ▸"));
+                console.log(reply.split("\n").map((l) => "  " + l).join("\n"));
+                log.blank();
+            }
+        }
+        catch (e) {
+            process.stdout.write("\n");
+            log.error(e.message);
+        }
+        rl.resume();
+        rl.prompt();
+    });
+    rl.on("close", () => {
+        log.blank();
+        log.dim("Chat ended.");
+        process.exit(0);
+    });
+}
+//# sourceMappingURL=agent-chat.js.map

package/dist/commands/agent-chat.js.map

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

package/dist/commands/agent-run.d.ts

@@ -0,0 +1,47 @@
+/**
+ * synap agent run / schedule / tick
+ *
+ * The CLI is a thin trigger. The IS handles all reasoning and tool execution
+ * server-side via MCP. The CLI's responsibilities are:
+ *   1. Resolve which agent (and its pod/workspace) to use
+ *   2. Send the goal to IS /v1/chat/completions
+ *   3. Store the final output as a `research` entity on the pod
+ *   4. Display the result
+ *
+ * Schedules are stored as `task` entities on the pod (not local files) so they
+ * are visible in pod-admin and shareable across machines.
+ * `synap agent tick` reads due schedules from the pod and fires them.
+ * Wire it to the pod server's crontab for autonomous execution.
+ */
+type Persona = "researcher" | "assistant" | "developer";
+export interface RunOpts {
+    goal: string;
+    persona?: Persona;
+    model?: string;
+    workspace?: string;
+    maxTokens?: number;
+    dryRun?: boolean;
+    podUrl?: string;
+    apiKey?: string;
+}
+export interface ScheduleOpts {
+    goal?: string;
+    name?: string;
+    persona?: Persona;
+    model?: string;
+    workspace?: string;
+    every?: "hourly" | "daily" | "weekly";
+    list?: boolean;
+    remove?: string;
+    runNow?: boolean;
+    podUrl?: string;
+    apiKey?: string;
+}
+export declare function agentRun(opts: RunOpts): Promise<void>;
+export declare function agentSchedule(opts: ScheduleOpts): Promise<void>;
+export declare function agentTick(opts: {
+    dryRun?: boolean;
+    podUrl?: string;
+    apiKey?: string;
+}): Promise<void>;
+export {};

package/dist/commands/agent-run.js

@@ -0,0 +1,301 @@
+/**
+ * synap agent run / schedule / tick
+ *
+ * The CLI is a thin trigger. The IS handles all reasoning and tool execution
+ * server-side via MCP. The CLI's responsibilities are:
+ *   1. Resolve which agent (and its pod/workspace) to use
+ *   2. Send the goal to IS /v1/chat/completions
+ *   3. Store the final output as a `research` entity on the pod
+ *   4. Display the result
+ *
+ * Schedules are stored as `task` entities on the pod (not local files) so they
+ * are visible in pod-admin and shareable across machines.
+ * `synap agent tick` reads due schedules from the pod and fires them.
+ * Wire it to the pod server's crontab for autonomous execution.
+ */
+import chalk from "chalk";
+import ora from "ora";
+import { resolveHubConfig, hubGet, hubPost, hubPatch } from "../lib/hub-client.js";
+import { unwrapList } from "../lib/unwrapList.js";
+import { log } from "../utils/logger.js";
+// ── Persona system prompts ────────────────────────────────────────────────────
+// Injected as the system message. The IS handles tool use via MCP.
+const PERSONAS = {
+    researcher: "You are a research agent. Investigate the given goal thoroughly using all available tools " +
+        "(web search, URL fetch, memory recall, entity search). Capture findings as you go. " +
+        "When you have a complete synthesis, produce a clear final answer.",
+    assistant: "You are a helpful assistant. Complete the given task using all available tools. " +
+        "Produce a clear, actionable final answer.",
+    developer: "You are a software engineering agent. Analyze the task, recall relevant knowledge, " +
+        "reason carefully, and produce a technical conclusion or recommendation.",
+};
+async function callIS(podUrl, apiKey, model, messages, maxTokens) {
+    const res = await fetch(`${podUrl}/v1/chat/completions`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({ model, messages, max_tokens: maxTokens }),
+        signal: AbortSignal.timeout(180_000),
+    });
+    if (!res.ok) {
+        const body = await res.text().catch(() => "");
+        throw new Error(`IS error (HTTP ${res.status}): ${body.slice(0, 300)}`);
+    }
+    return res.json();
+}
+async function storeResearch(title, content, tags, cfg) {
+    const res = await hubPost("/entities", {
+        userId: cfg.userId,
+        workspaceId: cfg.workspaceId,
+        profileSlug: "research",
+        name: title,
+        properties: { summary: content, tags, status: "concluded" },
+    }, cfg);
+    return res.id;
+}
+// ── Schedule helpers ──────────────────────────────────────────────────────────
+const INTERVAL_MS = {
+    hourly: 60 * 60 * 1000,
+    daily: 24 * 60 * 60 * 1000,
+    weekly: 7 * 24 * 60 * 60 * 1000,
+};
+async function listScheduleEntities(cfg) {
+    const res = await hubGet("/entities", { q: "[agent-sched]", workspaceId: cfg.workspaceId, limit: "50" }, cfg);
+    const entities = unwrapList(res, ["entities"]);
+    return entities.filter((e) => e.name?.startsWith("[agent-sched]"));
+}
+// ── Public: agentRun ──────────────────────────────────────────────────────────
+export async function agentRun(opts) {
+    const goal = opts.goal?.trim();
+    if (!goal) {
+        log.error("--goal is required.");
+        log.dim('Example: synap agent run --goal "Research RAG architectures"');
+        process.exit(1);
+    }
+    const persona = opts.persona ?? "researcher";
+    const model = opts.model ?? "synap/balanced";
+    const maxTokens = opts.maxTokens ?? 4000;
+    let cfg;
+    try {
+        cfg = await resolveHubConfig({ podUrl: opts.podUrl, apiKey: opts.apiKey });
+    }
+    catch (err) {
+        log.error(err.message);
+        log.dim("Run `synap pods add` to configure a pod, or pass --pod-url and --api-key.");
+        process.exit(1);
+    }
+    const workspaceId = opts.workspace ?? cfg.workspaceId;
+    const runCfg = { ...cfg, workspaceId };
+    if (opts.dryRun) {
+        log.heading("Agent run — dry run");
+        console.log();
+        console.log(`  ${chalk.dim("goal")}       ${chalk.bold(goal)}`);
+        console.log(`  ${chalk.dim("persona")}    ${chalk.cyan(persona)}`);
+        console.log(`  ${chalk.dim("model")}      ${chalk.cyan(model)}`);
+        console.log(`  ${chalk.dim("pod")}        ${chalk.underline(cfg.podUrl)}`);
+        console.log(`  ${chalk.dim("workspace")}  ${workspaceId ? chalk.underline(workspaceId) : chalk.yellow("none — entities will be pod-global")}`);
+        console.log();
+        log.dim(`Will POST to: ${cfg.podUrl}/v1/chat/completions`);
+        log.dim("Remove --dry-run to execute.");
+        return;
+    }
+    log.heading(`Agent run — ${chalk.bold(persona)}`);
+    log.dim(`Goal: ${goal}`);
+    log.dim(`Model: ${model}  ·  Pod: ${cfg.podUrl}`);
+    console.log();
+    const spinner = ora({ text: "Calling IS…", color: "cyan" }).start();
+    const start = Date.now();
+    let response;
+    try {
+        response = await callIS(cfg.podUrl, cfg.apiKey, model, [
+            { role: "system", content: PERSONAS[persona] },
+            { role: "user", content: goal },
+        ], maxTokens);
+    }
+    catch (err) {
+        const msg = err.message;
+        spinner.fail(chalk.red("IS call failed"));
+        console.log();
+        log.error(msg);
+        if (msg.includes("403") && msg.toLowerCase().includes("scope")) {
+            log.warn("Your CLI key is missing a required scope.");
+            log.dim("Fix: run  synap connect  to rotate your key with the updated scope list.");
+            log.dim("Or in pod-admin → Trust & Keys, delete your CLI key and reconnect.");
+        }
+        else if (msg.includes("IS error")) {
+            log.dim(`Verify the IS is running: curl ${cfg.podUrl}/v1/models -H "Authorization: Bearer <key>"`);
+        }
+        process.exit(1);
+    }
+    const content = response.choices?.[0]?.message?.content ?? "";
+    const elapsed = ((Date.now() - start) / 1000).toFixed(1);
+    spinner.text = "Storing result…";
+    let entityId;
+    try {
+        entityId = await storeResearch(`Agent run: ${goal.slice(0, 80)}`, content, ["agent-run", persona], runCfg);
+    }
+    catch {
+        // storage failure is non-fatal — still display the result
+    }
+    spinner.succeed(chalk.green(`Done · ${elapsed}s`));
+    console.log();
+    if (entityId) {
+        log.success(`Research stored → ${chalk.underline(`${cfg.podUrl}/admin/entities/${entityId}`)}`);
+        console.log();
+    }
+    if (content) {
+        log.heading("Result");
+        console.log(chalk.white(content.trim()));
+        console.log();
+    }
+}
+// ── Public: agentSchedule ─────────────────────────────────────────────────────
+export async function agentSchedule(opts) {
+    let cfg;
+    try {
+        cfg = await resolveHubConfig({ podUrl: opts.podUrl, apiKey: opts.apiKey });
+    }
+    catch (err) {
+        log.error(err.message);
+        process.exit(1);
+    }
+    // List
+    if (opts.list) {
+        const schedules = await listScheduleEntities(cfg);
+        if (schedules.length === 0) {
+            log.warn("No schedules found on this pod/workspace.");
+            log.dim("Add one: synap agent schedule --goal '...' --name <name> --every daily");
+            return;
+        }
+        log.heading(`Agent schedules (${schedules.length})`);
+        for (const s of schedules) {
+            const p = s.properties;
+            const badge = p.enabled ? chalk.green("●") : chalk.red("○");
+            const last = p.lastRunAt ? `last ran ${new Date(p.lastRunAt).toLocaleString()}` : "never ran";
+            const next = new Date(p.nextRunAt).toLocaleString();
+            console.log(`  ${badge} ${chalk.bold(s.name.replace("[agent-sched] ", "").padEnd(24))} ${chalk.cyan(p.interval.padEnd(8))} ${chalk.dim(last)}`);
+            console.log(`       next: ${chalk.dim(next)}  |  goal: ${chalk.dim(p.goal.slice(0, 70))}`);
+        }
+        console.log();
+        log.dim("Run due schedules now: synap agent tick");
+        log.dim("Crontab (daily at 09:00):  0 9 * * *  synap agent tick");
+        return;
+    }
+    // Remove
+    if (opts.remove) {
+        const schedules = await listScheduleEntities(cfg);
+        const target = schedules.find((s) => s.name === `[agent-sched] ${opts.remove}` || s.name === opts.remove);
+        if (!target) {
+            log.error(`No schedule named "${opts.remove}" found.`);
+            process.exit(1);
+        }
+        // Disable it (soft delete — PATCH enabled=false)
+        await hubPatch(`/entities/${target.id}`, { properties: { ...target.properties, enabled: false } }, cfg);
+        log.info(`Disabled schedule: ${chalk.bold(opts.remove)}`);
+        return;
+    }
+    // Add
+    const { goal, name, every } = opts;
+    if (!goal?.trim() || !name?.trim() || !every) {
+        log.error("Required: --goal, --name, --every (hourly|daily|weekly)");
+        log.dim('Example: synap agent schedule --goal "Research AI news" --name daily-ai --every daily');
+        process.exit(1);
+    }
+    const existing = await listScheduleEntities(cfg).catch(() => []);
+    if (existing.find((s) => s.name === `[agent-sched] ${name}`)) {
+        log.error(`A schedule named "${name}" already exists.`);
+        log.dim(`Remove it first: synap agent schedule --remove ${name}`);
+        process.exit(1);
+    }
+    const now = new Date().toISOString();
+    await hubPost("/entities", {
+        userId: cfg.userId,
+        workspaceId: cfg.workspaceId,
+        profileSlug: "task",
+        name: `[agent-sched] ${name}`,
+        properties: {
+            goal: goal.trim(),
+            persona: opts.persona ?? "researcher",
+            model: opts.model ?? "synap/balanced",
+            interval: every,
+            intervalMs: INTERVAL_MS[every],
+            nextRunAt: now,
+            enabled: true,
+            createdAt: now,
+        },
+    }, cfg);
+    log.info(`Schedule created: ${chalk.bold(name)} — runs ${chalk.cyan(every)}`);
+    console.log();
+    const cron = every === "hourly" ? "0 * * * *" : every === "daily" ? "0 9 * * *" : "0 9 * * 1";
+    log.dim(`Add to pod server crontab:  ${cron}  synap agent tick`);
+    if (opts.runNow) {
+        console.log();
+        await agentRun({
+            goal: goal.trim(),
+            persona: opts.persona,
+            model: opts.model,
+            workspace: opts.workspace ?? cfg.workspaceId,
+            podUrl: opts.podUrl,
+            apiKey: opts.apiKey,
+        });
+    }
+}
+// ── Public: agentTick ─────────────────────────────────────────────────────────
+export async function agentTick(opts) {
+    let cfg;
+    try {
+        cfg = await resolveHubConfig({ podUrl: opts.podUrl, apiKey: opts.apiKey });
+    }
+    catch (err) {
+        log.error(err.message);
+        process.exit(1);
+    }
+    const schedules = await listScheduleEntities(cfg).catch(() => []);
+    const enabled = schedules.filter((s) => s.properties.enabled);
+    if (enabled.length === 0) {
+        log.dim("No enabled schedules on this pod.");
+        return;
+    }
+    const now = Date.now();
+    const due = enabled.filter((s) => {
+        const next = new Date(s.properties.nextRunAt).getTime();
+        return now >= next;
+    });
+    if (due.length === 0) {
+        const next = enabled
+            .map((s) => new Date(s.properties.nextRunAt).getTime())
+            .sort((a, b) => a - b)[0];
+        log.dim(`No schedules due. Next: ${new Date(next).toLocaleString()}`);
+        return;
+    }
+    log.heading(`Ticking ${due.length} due schedule(s)`);
+    for (const s of due) {
+        const p = s.properties;
+        log.info(`Running: ${chalk.bold(s.name.replace("[agent-sched] ", ""))}`);
+        if (opts.dryRun) {
+            log.dim(`  [dry-run] goal: ${p.goal.slice(0, 70)}`);
+            continue;
+        }
+        try {
+            await agentRun({
+                goal: p.goal,
+                persona: p.persona,
+                model: p.model,
+                workspace: cfg.workspaceId,
+                podUrl: opts.podUrl,
+                apiKey: opts.apiKey,
+            });
+            const nextRunAt = new Date(now + p.intervalMs).toISOString();
+            await hubPatch(`/entities/${s.id}`, { properties: { ...p, lastRunAt: new Date(now).toISOString(), nextRunAt } }, cfg).catch(() => {
+                // non-fatal — schedule ran, just couldn't update nextRunAt
+                log.dim(`  Warning: could not update nextRunAt for "${s.name}" on the pod.`);
+            });
+        }
+        catch (err) {
+            log.error(`Schedule "${s.name}" failed: ${err.message}`);
+        }
+    }
+}
+//# sourceMappingURL=agent-run.js.map