@synap-core/cli 1.7.0 → 1.8.0

package/dist/commands/connectors.js

@@ -0,0 +1,276 @@
+/**
+ * synap connectors — Manage pod connector integrations (Nango-powered)
+ *
+ * Subcommands: list, sync, disconnect, schema
+ * Top-level alias: synap connect [service]
+ */
+import chalk from "chalk";
+import ora from "ora";
+import prompts from "prompts";
+import { exec } from "child_process";
+import { mkdirSync, writeFileSync, existsSync } from "fs";
+import { resolveHubConfig, hubGet, hubPost } from "../lib/hub-client.js";
+import { log } from "../utils/logger.js";
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function openBrowser(url) {
+    const platform = process.platform;
+    let cmd;
+    if (platform === "darwin") {
+        cmd = `open "${url}"`;
+    }
+    else if (platform === "win32") {
+        cmd = `start "" "${url}"`;
+    }
+    else {
+        cmd = `xdg-open "${url}"`;
+    }
+    try {
+        exec(cmd);
+    }
+    catch {
+        // silently ignore — caller already prints the URL
+    }
+}
+async function fetchProviders(cfg, workspaceId) {
+    const params = {};
+    if (workspaceId)
+        params.workspaceId = workspaceId;
+    const res = await hubGet("/connectors/providers", params, cfg);
+    const r = res;
+    return (r.providers ?? []);
+}
+export async function connectorsConnect(service, opts) {
+    let cfg;
+    try {
+        cfg = await resolveHubConfig({ podUrl: opts.podUrl, apiKey: opts.apiKey });
+    }
+    catch (err) {
+        log.error(err.message);
+        process.exit(1);
+    }
+    const workspaceId = opts.workspace ?? cfg.workspaceId;
+    const spinner = ora({ text: "Starting OAuth session…", color: "cyan" }).start();
+    let redirectUrl;
+    try {
+        const body = {};
+        if (service)
+            body.providerId = service;
+        if (workspaceId)
+            body.workspaceId = workspaceId;
+        const res = await hubPost("/connectors/session", body, cfg);
+        const r = res;
+        redirectUrl = String(r.redirectUrl);
+        spinner.stop();
+    }
+    catch (err) {
+        spinner.fail(chalk.red("Failed to start connector session"));
+        log.error(err.message);
+        process.exit(1);
+    }
+    log.heading(`Connect to ${service ?? "external services"}`);
+    console.log();
+    console.log(`  Opening OAuth flow in your browser…`);
+    console.log(`  ${chalk.dim("If it didn't open, paste this URL in your browser:")}`);
+    console.log();
+    console.log(`  ${chalk.underline(chalk.cyan(redirectUrl))}`);
+    console.log();
+    openBrowser(redirectUrl);
+    log.dim(`Once connected, records will import automatically. Run \`synap connectors list\` to check status.`);
+}
+export async function connectorsList(opts) {
+    let cfg;
+    try {
+        cfg = await resolveHubConfig();
+    }
+    catch (err) {
+        log.error(err.message);
+        process.exit(1);
+    }
+    const workspaceId = opts.workspace ?? cfg.workspaceId;
+    const spinner = opts.json ? null : ora({ text: "Fetching connectors…", color: "cyan" }).start();
+    let providers;
+    try {
+        providers = await fetchProviders(cfg, workspaceId);
+        spinner?.stop();
+    }
+    catch (err) {
+        spinner?.fail(chalk.red("Failed to fetch connectors"));
+        log.error(err.message);
+        process.exit(1);
+    }
+    if (opts.json) {
+        console.log(JSON.stringify({ providers }, null, 2));
+        return;
+    }
+    if (providers.length === 0) {
+        log.warn("No connectors configured on this pod.");
+        log.dim(`Set up Nango at ${cfg.podUrl}/admin/settings.`);
+        return;
+    }
+    const connected = providers.filter((p) => p.connected);
+    log.heading(`Connected Services (${connected.length} connected / ${providers.length} total)`);
+    console.log();
+    for (const p of providers) {
+        const dot = p.connected ? chalk.green("●") : chalk.dim("○");
+        const name = p.connected ? chalk.bold(p.displayName) : chalk.dim(p.displayName);
+        const id = chalk.dim(`(${p.provider})`);
+        const connLine = p.connected && p.connectionId ? `  ${chalk.dim(p.connectionId)}` : "";
+        console.log(`  ${dot} ${name} ${id}${connLine}`);
+    }
+    console.log();
+}
+export async function connectorsSync(provider, opts) {
+    let cfg;
+    try {
+        cfg = await resolveHubConfig();
+    }
+    catch (err) {
+        log.error(err.message);
+        process.exit(1);
+    }
+    const workspaceId = opts.workspace ?? cfg.workspaceId;
+    // Find the connectionId
+    let connectionId;
+    try {
+        const providers = await fetchProviders(cfg, workspaceId);
+        const match = providers.find((p) => p.provider === provider || p.id === provider || p.displayName.toLowerCase() === provider.toLowerCase());
+        if (!match || !match.connected) {
+            log.error(`Provider ${chalk.bold(provider)} is not connected. Run: ${chalk.cyan(`synap connect ${provider}`)}`);
+            process.exit(1);
+        }
+        connectionId = match.connectionId;
+    }
+    catch (err) {
+        log.error(err.message);
+        process.exit(1);
+    }
+    const spinner = ora({ text: "Triggering sync…", color: "cyan" }).start();
+    try {
+        await hubPost("/connectors/actions", { connectionId, providerConfigKey: provider, actionName: "sync", input: {} }, cfg);
+        spinner.succeed(chalk.green(`Sync triggered for ${chalk.bold(provider)}. Records will import in the background.`));
+    }
+    catch (err) {
+        const msg = err.message;
+        // Non-200 may mean manual sync not configured — handle gracefully
+        spinner.warn(chalk.yellow(`Sync triggered (manual sync may not be configured for this provider — automatic sync runs on the Nango schedule)`));
+        log.dim(msg);
+    }
+}
+export async function connectorsDisconnect(provider, opts) {
+    let cfg;
+    try {
+        cfg = await resolveHubConfig();
+    }
+    catch (err) {
+        log.error(err.message);
+        process.exit(1);
+    }
+    const workspaceId = opts.workspace ?? cfg.workspaceId;
+    // Find the connectionId
+    let connectionId;
+    try {
+        const providers = await fetchProviders(cfg, workspaceId);
+        const match = providers.find((p) => p.provider === provider || p.id === provider || p.displayName.toLowerCase() === provider.toLowerCase());
+        if (!match || !match.connected) {
+            log.error(`Provider ${chalk.bold(provider)} is not connected.`);
+            process.exit(1);
+        }
+        connectionId = match.connectionId;
+    }
+    catch (err) {
+        log.error(err.message);
+        process.exit(1);
+    }
+    if (!opts.force) {
+        const response = await prompts({
+            type: "confirm",
+            name: "confirmed",
+            message: `Disconnect ${provider}? This will stop syncing but won't delete imported entities.`,
+            initial: false,
+        });
+        if (!response.confirmed) {
+            log.dim("Cancelled.");
+            return;
+        }
+    }
+    const spinner = ora({ text: `Disconnecting ${provider}…`, color: "cyan" }).start();
+    try {
+        await hubPost("/connectors/disconnect", { connectionId, provider }, cfg);
+        spinner.succeed(chalk.green(`Disconnected ${chalk.bold(provider)}. Your imported entities remain intact.`));
+    }
+    catch (err) {
+        spinner.fail(chalk.red(`Failed to disconnect ${provider}`));
+        log.error(err.message);
+        process.exit(1);
+    }
+}
+export async function connectorsSchema(opts) {
+    let cfg;
+    try {
+        cfg = await resolveHubConfig();
+    }
+    catch (err) {
+        log.error(err.message);
+        process.exit(1);
+    }
+    const spinner = opts.json ? null : ora({ text: "Fetching connector schema…", color: "cyan" }).start();
+    let schema;
+    try {
+        schema = await hubGet("/connectors/schema", {}, cfg);
+        spinner?.stop();
+    }
+    catch (err) {
+        spinner?.fail(chalk.red("Failed to fetch connector schema"));
+        log.error(err.message);
+        process.exit(1);
+    }
+    if (opts.json) {
+        console.log(JSON.stringify(schema, null, 2));
+        return;
+    }
+    const s = schema;
+    const md = buildConnectorSchemaMarkdown(s, cfg.podUrl);
+    if (opts.writeContext !== undefined && opts.writeContext !== false) {
+        const outputPath = typeof opts.writeContext === "string" && opts.writeContext.length > 0
+            ? opts.writeContext
+            : ".claude/CONNECTOR_CONTEXT.md";
+        const dir = outputPath.includes("/") ? outputPath.split("/").slice(0, -1).join("/") : ".";
+        if (dir && dir !== "." && !existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        writeFileSync(outputPath, md, "utf-8");
+        log.success(`Context written to ${chalk.underline(outputPath)} — Claude Code will auto-load this in all sessions from this directory`);
+    }
+    else {
+        console.log(md);
+    }
+}
+function buildConnectorSchemaMarkdown(schema, podUrl) {
+    const lines = [
+        `# Synap Connector Reference`,
+        ``,
+        `> Fetched from pod: ${podUrl} — use this context to connect, manage, and query external service integrations.`,
+        ``,
+        `## Supported Providers`,
+    ];
+    const providers = (schema.providers ?? schema.supported ?? []);
+    if (providers.length > 0) {
+        for (const p of providers) {
+            lines.push(``, `### ${p.displayName ?? p.provider ?? p.id}`);
+            if (p.description)
+                lines.push(``, String(p.description));
+            if (p.actions) {
+                lines.push(``, `**Available actions:**`);
+                for (const action of p.actions) {
+                    lines.push(`- \`${action}\``);
+                }
+            }
+        }
+    }
+    else {
+        lines.push(``, `Providers are configured in Nango. Common integrations include:`, `- Google Workspace (gmail, google-calendar, google-drive)`, `- GitHub (github)`, `- Notion (notion)`, `- Linear (linear)`, `- Slack (slack)`, `- HubSpot (hubspot)`);
+    }
+    lines.push(``, `## CLI Commands`, ``, `\`\`\`bash`, `# Connect a service (opens OAuth flow in browser)`, `synap connect [service]`, `synap connect google`, `synap connect github`, ``, `# List all connectors and connection status`, `synap connectors list`, `synap connectors list --json`, ``, `# Trigger a manual sync for a connected provider`, `synap connectors sync <provider>`, ``, `# Disconnect a provider`, `synap connectors disconnect <provider>`, `synap connectors disconnect google --force`, ``, `# Fetch this schema`, `synap connectors schema`, `synap connectors schema --write-context   # writes to .claude/CONNECTOR_CONTEXT.md`, `\`\`\``, ``, `## Hub REST Endpoints`, ``, `| Method | Path | Description |`, `|--------|------|-------------|`, `| GET | /api/hub/connectors/providers | List providers and connection status |`, `| POST | /api/hub/connectors/session | Start OAuth session, get redirectUrl |`, `| POST | /api/hub/connectors/disconnect | Disconnect a provider |`, `| GET | /api/hub/connectors/schema | This schema |`, `| POST | /api/hub/connectors/actions | Trigger a provider action (e.g. sync) |`, ``, `## AI Usage Flow`, ``, `1. Check connected services: \`synap connectors list\``, `2. Connect a new service: \`synap connect <provider>\` — opens OAuth in browser`, `3. Once connected, records import automatically on Nango's schedule`, `4. Trigger immediate import: \`synap connectors sync <provider>\``, `5. Query imported entities: \`synap ask "meeting notes from Google Calendar"\``);
+    return lines.join("\n");
+}
+//# sourceMappingURL=connectors.js.map

package/dist/commands/connectors.js.map

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

package/dist/commands/context.d.ts

@@ -0,0 +1,22 @@
+/**
+ * synap context
+ *
+ * Emit a session-start context summary: recent engineering knowledge,
+ * open proposals, active tasks. Designed for injection into CLAUDE.md or
+ * as JSON for agents to consume at session start.
+ *
+ * Usage:
+ *   synap context                   # markdown output
+ *   synap context --json            # NDJSON (one object per section)
+ *   synap context --repo synap-backend  # filter knowledge by repo tag
+ *   synap context --limit 5         # entries per section (default: 5)
+ */
+export interface ContextOpts {
+    repo?: string;
+    limit?: string;
+    json?: boolean;
+    podUrl?: string;
+    apiKey?: string;
+    workspace?: string;
+}
+export declare function contextSummary(opts: ContextOpts): Promise<void>;

package/dist/commands/context.js

@@ -0,0 +1,151 @@
+/**
+ * synap context
+ *
+ * Emit a session-start context summary: recent engineering knowledge,
+ * open proposals, active tasks. Designed for injection into CLAUDE.md or
+ * as JSON for agents to consume at session start.
+ *
+ * Usage:
+ *   synap context                   # markdown output
+ *   synap context --json            # NDJSON (one object per section)
+ *   synap context --repo synap-backend  # filter knowledge by repo tag
+ *   synap context --limit 5         # entries per section (default: 5)
+ */
+import chalk from "chalk";
+import { log } from "../utils/logger.js";
+import { resolveHubConfig, hubGet } from "../lib/hub-client.js";
+import { getAgentWorkspaceRouting } from "../lib/pod.js";
+async function fetchEntities(cfg, params, workspaceId) {
+    try {
+        if (workspaceId)
+            params.workspaceId = workspaceId;
+        const res = await hubGet("/entities", params, cfg);
+        const items = (res.entities ?? res.items ?? res);
+        return Array.isArray(items) ? items : [];
+    }
+    catch {
+        return [];
+    }
+}
+async function fetchProposals(cfg, workspaceId, limit) {
+    try {
+        const params = { status: "pending", limit };
+        if (workspaceId)
+            params.workspaceId = workspaceId;
+        const res = await hubGet("/proposals", params, cfg);
+        const items = (res.proposals ?? res.items ?? res);
+        return Array.isArray(items) ? items : [];
+    }
+    catch {
+        return [];
+    }
+}
+async function fetchSessions(cfg, workspaceId, limit) {
+    try {
+        const params = { status: "active", limit };
+        if (workspaceId)
+            params.workspaceId = workspaceId;
+        const res = await hubGet("/focus-sessions", params, cfg);
+        const items = (res.sessions ?? res.items ?? res);
+        return Array.isArray(items) ? items : [];
+    }
+    catch {
+        return [];
+    }
+}
+export async function contextSummary(opts) {
+    try {
+        const cfg = await resolveHubConfig(opts);
+        const limit = parseInt(opts.limit ?? "5", 10);
+        // Resolve workspace: explicit > agent routing memory workspace > cfg active
+        const routing = getAgentWorkspaceRouting();
+        const workspaceId = opts.workspace ??
+            routing?.memoryWorkspaceId ??
+            cfg.workspaceId;
+        const [rawKnowledge, proposals, tasks, sessions] = await Promise.all([
+            fetchEntities(cfg, { profileSlug: "knowledge", limit }, workspaceId),
+            fetchProposals(cfg, workspaceId, limit),
+            fetchEntities(cfg, { profileSlug: "task", limit, status: "todo" }, workspaceId),
+            fetchSessions(cfg, workspaceId, limit),
+        ]);
+        // Filter knowledge by repo tag if requested
+        const knowledge = opts.repo
+            ? rawKnowledge.filter((item) => {
+                const tags = (item.properties?.ek_tags ?? []);
+                if (!Array.isArray(tags))
+                    return false;
+                return tags.some((t) => {
+                    const tag = String(t);
+                    return tag === opts.repo || tag === `repo:${opts.repo}`;
+                });
+            })
+            : rawKnowledge;
+        if (opts.json) {
+            console.log(JSON.stringify({ section: "knowledge", items: knowledge }));
+            console.log(JSON.stringify({ section: "proposals", items: proposals }));
+            console.log(JSON.stringify({ section: "tasks", items: tasks }));
+            console.log(JSON.stringify({ section: "sessions", items: sessions }));
+            return;
+        }
+        // ── Markdown output ────────────────────────────────────────────────────
+        // Knowledge
+        console.log(chalk.bold("\n## Engineering Knowledge"));
+        if (knowledge.length === 0) {
+            console.log(chalk.dim("  (none)"));
+        }
+        else {
+            for (const item of knowledge) {
+                const props = (item.properties ?? {});
+                const type = String(props.ek_type ?? "–");
+                const claim = String(props.ek_claim ?? item.name ?? "–");
+                const tags = Array.isArray(props.ek_tags) && props.ek_tags.length > 0
+                    ? chalk.dim(`  [${props.ek_tags.join(", ")}]`)
+                    : "";
+                console.log(`- [${type}] ${claim}${tags}`);
+            }
+        }
+        // Proposals
+        console.log(chalk.bold(`\n## Open Proposals (${proposals.length} pending)`));
+        if (proposals.length === 0) {
+            console.log(chalk.dim("  (none)"));
+        }
+        else {
+            for (const item of proposals) {
+                const title = String(item.title ?? item.name ?? "–");
+                const ws = String(item.workspaceName ?? item.workspace ?? "");
+                const wsPart = ws ? `  — workspace: ${ws}` : "";
+                console.log(`- ${title}${wsPart}`);
+            }
+        }
+        // Tasks
+        console.log(chalk.bold(`\n## Active Tasks (${tasks.length})`));
+        if (tasks.length === 0) {
+            console.log(chalk.dim("  (none)"));
+        }
+        else {
+            for (const item of tasks) {
+                const props = (item.properties ?? {});
+                const name = String(props.task_title ?? item.name ?? "–");
+                console.log(`- ${name}`);
+            }
+        }
+        // Focus sessions
+        console.log(chalk.bold(`\n## Active Focus Sessions (${sessions.length})`));
+        if (sessions.length === 0) {
+            console.log(chalk.dim("  (none)"));
+        }
+        else {
+            for (const s of sessions) {
+                const progress = typeof s.progress === "number" ? ` ${chalk.dim(`[${s.progress}%]`)}` : "";
+                const id = String(s.id ?? "").slice(0, 8);
+                console.log(`- ${chalk.cyan(id)}${progress}  ${String(s.goal ?? "")}`);
+            }
+        }
+        console.log("");
+    }
+    catch (e) {
+        log.error("Error: " + e.message);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/commands/context.js.map

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

package/dist/commands/data-extra.d.ts

@@ -0,0 +1,13 @@
+import { type BaseOpts } from "./data.js";
+export declare function showEntity(id: string, opts: BaseOpts & {
+    workspace?: string;
+}): Promise<void>;
+export declare function listProposals(opts: BaseOpts & {
+    workspace?: string;
+    limit?: string;
+}): Promise<void>;
+export declare function browseEntities(opts: BaseOpts & {
+    workspace?: string;
+    profile?: string;
+    limit?: string;
+}): Promise<void>;

package/dist/commands/data-extra.js

@@ -0,0 +1,161 @@
+import chalk from "chalk";
+import { log } from "../utils/logger.js";
+import { resolveHubConfig, resolveUserId, hubGet } from "../lib/hub-client.js";
+import { parseLimit } from "./data.js";
+// ─── showEntity ───────────────────────────────────────────────────────────────
+// Entity details + its relations in one shot.
+export async function showEntity(id, opts) {
+    try {
+        const cfg = await resolveHubConfig(opts);
+        const userId = await resolveUserId(cfg);
+        const [entityRes, relationsRes] = await Promise.allSettled([
+            hubGet(`/entities/${id}`, { userId }, cfg),
+            hubGet(`/entities/${id}/relations`, { userId, limit: 50 }, cfg),
+        ]);
+        if (entityRes.status === "rejected") {
+            console.error(chalk.red(`Entity not found: ${id}`));
+            process.exit(1);
+        }
+        const entity = entityRes.value;
+        const relData = relationsRes.status === "fulfilled"
+            ? relationsRes.value
+            : {};
+        const relations = (relData.relations ?? relData.items ?? (Array.isArray(relData) ? relData : []));
+        if (opts.json) {
+            console.log(JSON.stringify({ entity, relations }, null, 2));
+            return;
+        }
+        log.heading(String(entity.title ?? id));
+        log.info(`Profile : ${String(entity.profileSlug ?? entity.profile ?? "")}`);
+        log.info(`ID      : ${String(entity.id ?? id)}`);
+        const props = entity.properties;
+        if (props && Object.keys(props).length > 0) {
+            log.blank();
+            log.heading("Properties");
+            for (const [k, v] of Object.entries(props)) {
+                if (v !== null && v !== undefined && v !== "") {
+                    log.info(`${k}: ${String(v)}`);
+                }
+            }
+        }
+        if (relations.length > 0) {
+            log.blank();
+            log.heading(`Relations (${relations.length})`);
+            for (const rel of relations) {
+                const r = rel;
+                const type = String(r.type ?? r.relationType ?? "related");
+                const otherId = String(r.targetEntityId ?? r.sourceEntityId ?? r.entityId ?? "");
+                const otherTitle = String(r.targetTitle ?? r.sourceTitle ?? r.title ?? otherId.slice(0, 8));
+                const direction = r.targetEntityId === id ? "←" : "→";
+                log.info(`${direction} ${chalk.cyan(type)}  ${otherTitle} ${chalk.dim(otherId.slice(0, 8))}`);
+            }
+        }
+        else {
+            log.blank();
+            log.dim("No relations. Link with: synap create relation --source <id> --target <id> --type <type>");
+        }
+    }
+    catch (e) {
+        console.error(chalk.red("Error: " + e.message));
+        process.exit(1);
+    }
+}
+// ─── listProposals ────────────────────────────────────────────────────────────
+// Pending proposals attributed to this agent — the governance inbox.
+export async function listProposals(opts) {
+    try {
+        const cfg = await resolveHubConfig(opts);
+        const limit = parseLimit(opts.limit, 20);
+        const workspaceId = opts.workspace ?? cfg.workspaceId;
+        const res = await hubGet("/proposals", {
+            status: "pending",
+            ...(workspaceId ? { workspaceId } : {}),
+            limit,
+        }, cfg);
+        const proposals = (res.proposals ?? res.items ?? (Array.isArray(res) ? res : []));
+        if (opts.json) {
+            console.log(JSON.stringify({ proposals }, null, 2));
+            return;
+        }
+        if (proposals.length === 0) {
+            log.success("No pending proposals.");
+            return;
+        }
+        log.heading(`${proposals.length} pending proposal${proposals.length !== 1 ? "s" : ""}`);
+        log.blank();
+        for (const p of proposals) {
+            const prop = p;
+            const id = String(prop.id ?? "").slice(0, 8);
+            const action = String(prop.action ?? prop.type ?? "write");
+            const subject = String(prop.subjectType ?? prop.subject ?? "entity");
+            // prefer human-readable summary; fall back to action description
+            const entityTitle = String(prop.entityTitle ?? prop.title ?? "");
+            const summary = String(prop.summary ?? prop.reasoning ?? prop.description ?? "");
+            const label = entityTitle
+                ? `${entityTitle} — ${subject}.${action}`
+                : summary || `${subject}.${action}`;
+            const reviewUrl = prop.reviewUrl ? String(prop.reviewUrl) : null;
+            log.info(`${chalk.yellow("●")} ${label}  ${chalk.dim(id)}`);
+            if (entityTitle && summary)
+                log.dim(`  ${summary.slice(0, 100)}`);
+            if (reviewUrl)
+                log.dim(`  Review: ${reviewUrl}`);
+        }
+    }
+    catch (e) {
+        console.error(chalk.red("Error: " + e.message));
+        process.exit(1);
+    }
+}
+// ─── browseEntities ───────────────────────────────────────────────────────────
+// Paginated entity list — cleaner than `list entities`, shows title + date.
+export async function browseEntities(opts) {
+    try {
+        const cfg = await resolveHubConfig(opts);
+        const userId = await resolveUserId(cfg);
+        const limit = parseLimit(opts.limit, 20);
+        const workspaceId = opts.workspace ?? cfg.workspaceId;
+        const params = { userId, limit };
+        if (workspaceId)
+            params.workspaceId = workspaceId;
+        if (opts.profile)
+            params.profileSlug = opts.profile;
+        const res = await hubGet("/entities", params, cfg);
+        const entities = (res.entities ?? res.items ?? (Array.isArray(res) ? res : []));
+        const total = Number(res.total ?? entities.length);
+        if (opts.json) {
+            console.log(JSON.stringify({ total, entities }, null, 2));
+            return;
+        }
+        if (entities.length === 0) {
+            log.dim("Nothing here yet.");
+            if (opts.profile)
+                log.dim(`  Profile: ${opts.profile} — no entities of this type.`);
+            return;
+        }
+        const scope = workspaceId ? chalk.dim(` [ws: ${workspaceId.slice(0, 8)}…]`) : chalk.dim(" [pod-wide]");
+        const profileFilter = opts.profile ? chalk.dim(` profile: ${opts.profile}`) : "";
+        log.dim(`${total} total${scope}${profileFilter} — showing ${entities.length}:`);
+        log.blank();
+        for (const e of entities) {
+            const entity = e;
+            const title = String(entity.title ?? entity.name ?? entity.id ?? "");
+            const profile = String(entity.profileSlug ?? entity.profile ?? "");
+            const id = String(entity.id ?? "").slice(0, 8);
+            const updatedAt = entity.updatedAt ?? entity.createdAt;
+            const dateStr = updatedAt
+                ? chalk.dim(new Date(String(updatedAt)).toLocaleDateString())
+                : "";
+            log.info(`${title}  ${chalk.dim(`(${profile})`)}  ${chalk.dim(id)}  ${dateStr}`);
+        }
+        if (total > entities.length) {
+            log.blank();
+            log.dim(`Showing ${entities.length} of ${total}. Add --limit ${limit * 2} to see more.`);
+        }
+    }
+    catch (e) {
+        console.error(chalk.red("Error: " + e.message));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=data-extra.js.map