opencode-agora 0.4.0 → 0.4.2

package/dist/cli/format.js

@@ -0,0 +1,249 @@
+import { formatNumber } from '../format.js';
+import { getInstallKind, renderPermissionLines } from '../marketplace.js';
+import { COMMANDS } from './commands-meta.js';
+import { renderBanner, renderBox } from '../ui.js';
+function pricingBadge(pricing, style) {
+    if (!pricing)
+        return '';
+    if (pricing.kind === 'free')
+        return ' ' + style.dim('FREE');
+    if (pricing.kind === 'paid')
+        return ' ' + style.accent('PAID');
+    return '';
+}
+export function truncate(value, max) {
+    if (value.length <= max)
+        return value;
+    return value.slice(0, max - 1) + '…';
+}
+export function formatDate(value) {
+    if (!value)
+        return '';
+    const d = new Date(value);
+    if (isNaN(d.getTime()))
+        return value;
+    return d.toLocaleDateString('en-US', { year: 'numeric', month: 'short', day: 'numeric' });
+}
+export function formatItemList(items, style) {
+    const idWidth = Math.max(...items.map((item) => item.id.length));
+    return items
+        .map((item) => {
+        const metrics = item.kind === 'package'
+            ? `${formatNumber(item.installs)} installs · ${formatNumber(item.stars)} ★`
+            : `${formatNumber(item.stars)} ★`;
+        const badge = item.kind === 'package' ? pricingBadge(item.pricing, style) : '';
+        return [
+            `${style.accent(item.id.padEnd(idWidth))}  ${style.dim(metrics)}`,
+            style.dim(item.name) + badge,
+            truncate(item.description, 88),
+            style.dim(`${item.category} · by ${item.author}`)
+        ].join('\n');
+    })
+        .join('\n\n');
+}
+export function formatItemTable(items, style) {
+    const idW = Math.max(4, ...items.map((i) => i.id.length));
+    const nameW = Math.max(4, ...items.map((i) => i.name.length));
+    const starW = 6;
+    const installW = 9;
+    const totalW = idW + 3 + nameW + 3 + starW + 3 + installW + 4;
+    const top = '┌' + '─'.repeat(totalW - 2) + '┐';
+    const bot = '└' + '─'.repeat(totalW - 2) + '┘';
+    const sep = '│';
+    const hdr = sep +
+        ' ' +
+        'id'.padEnd(idW) +
+        ' │ ' +
+        'name'.padEnd(nameW) +
+        ' │ ' +
+        'stars'.padStart(starW) +
+        ' │ ' +
+        'installs'.padStart(installW) +
+        ' │';
+    const rows = items.map((item) => sep +
+        ' ' +
+        style.accent(item.id.padEnd(idW)) +
+        ' │ ' +
+        style.dim(item.name.padEnd(nameW)) +
+        ' │ ' +
+        style.dim(formatNumber(item.stars).padStart(starW)) +
+        ' │ ' +
+        style.dim(formatNumber(item.installs).padStart(installW)) +
+        ' │');
+    return [top, hdr, ...rows, bot].join('\n');
+}
+export function formatItemDetail(item, style) {
+    const badge = item.kind === 'package' ? pricingBadge(item.pricing, style) : '';
+    const lines = [
+        style.bold(item.name) + badge,
+        `${style.dim('id')}        ${style.accent(item.id)}`,
+        `${style.dim('type')}      ${item.kind}`,
+        `${style.dim('category')}  ${item.category}`,
+        `${style.dim('author')}    ${item.author}`,
+        `${style.dim('stars')}     ${formatNumber(item.stars)}`,
+        `${style.dim('install')}   ${getInstallKind(item)}`,
+        '',
+        item.description,
+        '',
+        `${style.dim('tags')}      ${item.tags.join(', ')}`
+    ];
+    if (item.kind === 'package') {
+        lines.splice(5, 0, `${style.dim('version')}   ${item.version}`);
+        lines.push(`${style.dim('installs')}  ${formatNumber(item.installs)}`);
+        if (item.repository)
+            lines.push(`${style.dim('repo')}      ${item.repository}`);
+        if (item.npmPackage)
+            lines.push(`${style.dim('npm')}       ${item.npmPackage}`);
+        if (item.permissions) {
+            const permRows = renderPermissionLines(item.permissions);
+            if (permRows.length > 1) {
+                lines.push('');
+                // First row is "Permissions" label; subsequent rows are the indented values.
+                lines.push(style.dim(permRows[0]));
+                for (const row of permRows.slice(1))
+                    lines.push(row);
+            }
+        }
+    }
+    if (item.kind === 'workflow') {
+        lines.push(`${style.dim('forks')}     ${item.forks}`);
+        if (item.model)
+            lines.push(`${style.dim('model')}     ${item.model}`);
+        lines.push('', style.dim('prompt'), item.prompt);
+    }
+    return lines.join('\n');
+}
+export function formatSavedList(items, style) {
+    return items
+        .map((entry, index) => {
+        if (!entry.item) {
+            return [
+                `${index + 1}. ${style.accent(entry.saved.id)} ${style.dim('[missing]')}`,
+                `   ${style.dim('saved ' + formatDate(entry.saved.savedAt))}`
+            ].join('\n');
+        }
+        return [
+            `${index + 1}. ${style.accent(entry.item.id)} ${style.dim('[' + entry.item.category + ']')}`,
+            `   ${style.dim(entry.item.name)}`,
+            `   ${truncate(entry.item.description, 88)}`,
+            `   ${style.dim('saved ' + formatDate(entry.saved.savedAt))}`
+        ].join('\n');
+    })
+        .join('\n\n');
+}
+export function formatReviewList(reviews, style) {
+    return reviews
+        .map((review, index) => {
+        return [
+            `${index + 1}. ${style.accent(review.itemId)} ${style.dim('[' + review.itemType + ']')}`,
+            `   ${style.dim('rating ' + review.rating + '/5 by ' + review.author)}`,
+            `   ${truncate(review.content, 88)}`
+        ].join('\n');
+    })
+        .join('\n\n');
+}
+export function formatProfileDetail(profile, style) {
+    const lines = [
+        style.bold(profile.displayName),
+        `${style.dim('username')} ${style.accent(profile.username)}`,
+        `${style.dim('packages')} ${formatNumber(profile.packages)}`,
+        `${style.dim('workflows')} ${formatNumber(profile.workflows)}`,
+        `${style.dim('discussions')} ${formatNumber(profile.discussions)}`,
+        `${style.dim('reputation')} ${profile.reputation ?? 0}`
+    ];
+    if (profile.bio)
+        lines.splice(2, 0, `${style.dim('bio')} ${profile.bio}`);
+    if (profile.avatarUrl)
+        lines.push(`${style.dim('avatar')} ${profile.avatarUrl}`);
+    if (profile.joinedAt)
+        lines.push(`${style.dim('joined')} ${formatDate(profile.joinedAt)}`);
+    return lines.join('\n');
+}
+export function formatTutorialList(tutorials, style) {
+    return tutorials
+        .map((tutorial, index) => {
+        return [
+            `${index + 1}. ${style.accent(tutorial.id)} ${style.dim('[' + tutorial.level + ']')}`,
+            `   ${style.dim(tutorial.title)}`,
+            `   ${truncate(tutorial.description, 88)}`,
+            `   ${style.dim(tutorial.duration + ' | ' + tutorial.steps.length + ' steps')}`
+        ].join('\n');
+    })
+        .join('\n\n');
+}
+export function formatTutorialStep(tutorial, stepNumber, style) {
+    const step = tutorial.steps[stepNumber - 1];
+    if (!step) {
+        return [
+            style.bold(tutorial.title),
+            style.dim(`Completed ${tutorial.steps.length}/${tutorial.steps.length} steps.`),
+            'Run agora tutorials for more tutorials.'
+        ].join('\n');
+    }
+    const lines = [
+        style.bold(tutorial.title),
+        `${style.dim('id')} ${style.accent(tutorial.id)}`,
+        `${style.dim('level')} ${tutorial.level}`,
+        `${style.dim('duration')} ${tutorial.duration}`,
+        `${style.dim('step')} ${stepNumber}/${tutorial.steps.length}`,
+        '',
+        step.title || '',
+        step.content || ''
+    ];
+    if (step.code) {
+        lines.push('', style.dim('code:'), step.code);
+    }
+    return lines.join('\n');
+}
+export function welcome(color, trueColor, style, version) {
+    if (!color) {
+        return [
+            '',
+            `agora · Developers' CLI marketplace and community hub · v${version}`,
+            '',
+            '  Search    agora search <query>',
+            '  Browse    agora trending · agora browse <id>',
+            '  Learn     agora tutorials · agora tutorial <id>',
+            '  Install   agora install <id> [--write]',
+            '  Setup     agora init [--mcp] · agora use <workflow>',
+            '  Auth      agora login [--api-url <url>]',
+            ''
+        ].join('\n');
+    }
+    const banner = renderBanner({ color, trueColor });
+    const box = renderBox('Welcome to Agora', [
+        "Developers' CLI marketplace and community hub - type a command, bash or chat:",
+        `v${version} · run \`agora help\` to get started`
+    ], { color, trueColor });
+    const hint = [
+        `${style.dim('Search')}    agora search <query>`,
+        `${style.dim('Browse')}    agora trending · agora browse <id>`,
+        `${style.dim('Learn')}     agora tutorials · agora tutorial <id>`,
+        `${style.dim('Install')}   agora install <id> [--write]`,
+        `${style.dim('Setup')}     agora init [--mcp] · agora use <workflow>`,
+        `${style.dim('Auth')}      agora login [--api-url <url>]`
+    ].join('\n');
+    return `\n${banner}\n\n${box}\n\n${hint}\n`;
+}
+export function header(title, meta, style) {
+    return [style.accent(title), ...meta.map((part) => style.dim(part))].join(style.dim(' · '));
+}
+export function usage(style, version) {
+    const nameWidth = Math.max(...COMMANDS.map((c) => c.name.length));
+    const groups = ['Marketplace', 'Setup', 'Library', 'Learn', 'Community'];
+    const lines = [
+        `${style.accent('agora')}${style.dim(` · Developers' CLI marketplace and community hub · v${version}`)}`,
+        ''
+    ];
+    for (const group of groups) {
+        const groupCmds = COMMANDS.filter((c) => c.group === group);
+        lines.push(style.dim(group));
+        for (const cmd of groupCmds) {
+            lines.push(`  ${style.accent(cmd.name.padEnd(nameWidth))}  ${style.dim(cmd.summary)}`);
+        }
+        lines.push('');
+    }
+    lines.push(style.dim('Run `agora help <command>` for details on any command.'));
+    return lines.join('\n');
+}
+//# sourceMappingURL=format.js.map

package/dist/cli/format.js.map

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

package/dist/cli/helpers.d.ts

@@ -0,0 +1,95 @@
+import { getAuthState, type ResolvedSavedItem } from '../state.js';
+import type { Tutorial } from '../types.js';
+import type { SourceOptions, SourceResult } from '../live.js';
+import type { CliIo, ParsedArgs, OutputStream } from './flags.js';
+export declare function writeLine(stream: OutputStream, value?: string): void;
+export declare function writeJson(stream: OutputStream, value: unknown): void;
+export declare function usageError(io: CliIo, message: string): number;
+/**
+ * Returns true only when both stdout and stdin are real interactive TTYs AND the
+ * environment supports colour (i.e. not NO_COLOR or TERM=dumb). The gate keeps
+ * the interactive menu away from pipes, CI, and the test harness, all of which
+ * use non-TTY mock streams.
+ */
+export declare function isInteractive(io: CliIo, env: Record<string, string | undefined>): boolean;
+export declare function stringFlag(parsed: ParsedArgs, longName: string, shortName?: string): string | undefined;
+export declare function requiredStringFlag(parsed: ParsedArgs, longName: string, shortName?: string): string | undefined;
+export declare function numberFlag(parsed: ParsedArgs, longName: string, shortName?: string): number | undefined;
+export declare function envString(io: CliIo, name: string): string | undefined;
+export declare function authTokenInput(parsed: ParsedArgs, io: CliIo): string | undefined;
+export declare function detectDataDir(parsed: ParsedArgs, io: CliIo): string;
+export declare function sourceOptions(parsed: ParsedArgs, io: CliIo): Promise<SourceOptions>;
+export declare function writeSourceOptions(parsed: ParsedArgs, io: CliIo): Promise<{
+    ok: true;
+    options: SourceOptions;
+} | {
+    ok: false;
+    error: string;
+}>;
+export declare function readSourceOptions(parsed: ParsedArgs, io: CliIo): Promise<{
+    ok: true;
+    options: SourceOptions;
+} | {
+    ok: false;
+    error: string;
+}>;
+export declare function sourceLabel(result: {
+    source: string;
+}): string;
+export declare function warnFallback<T>(result: SourceResult<T>, io: CliIo): void;
+export declare function sourcePayload<T extends object, TValue>(result: SourceResult<TValue>, payload: T): T & {
+    source: string;
+    apiUrl?: string;
+    fallbackReason?: string;
+};
+export declare function maskToken(token: string): string;
+export declare function formatRelativeExp(exp: number, nowSec: number): string;
+export declare function authStatusPayload(dataDir: string, auth: ReturnType<typeof getAuthState>): {
+    dataDir: string;
+    statePath: string;
+    authenticated: boolean;
+    accessTokenPreview?: string;
+    accessExp?: number;
+    refreshTokenPreview?: string;
+    refreshExp?: number;
+    apiUrl?: string;
+    savedAt?: string;
+};
+export declare function matchesSavedQuery(entry: ResolvedSavedItem, query: string): boolean;
+export declare function tutorialLevelFlag(parsed: ParsedArgs): {
+    ok: true;
+    value: string;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function tutorialStepNumber(parsed: ParsedArgs): {
+    ok: true;
+    value: number;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function tutorialStepPayload(tutorial: Tutorial, stepNumber: number): {
+    stepNumber: number;
+    totalSteps: number;
+    completed: boolean;
+    title?: string;
+    content?: string;
+    code?: string;
+};
+export declare function tagsFlag(parsed: ParsedArgs): string[];
+export declare function promptInput(parsed: ParsedArgs, io: CliIo): string | undefined;
+export declare function contentInput(parsed: ParsedArgs, io: CliIo): string | undefined;
+export declare function itemTypeFlag(parsed: ParsedArgs, itemId: string): 'package' | 'workflow';
+export declare function discussionCategoryFlag(parsed: ParsedArgs): {
+    ok: true;
+    value: string;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function extractSessionId(line: string): string | null;
+export declare function persistChatSession(dataDir: string, sessionId: string): void;
+export declare function loadLastChatSession(dataDir: string): string | undefined;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/cli/helpers.d.ts.map

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

package/dist/cli/helpers.js

@@ -0,0 +1,301 @@
+import process from 'node:process';
+import { existsSync, readFileSync } from 'node:fs';
+import { detectAgoraDataDir, loadAgoraState, getAuthState, getAgoraStatePath, writeAgoraState } from '../state.js';
+import { ensureFreshAccess } from '../auth/refresh.js';
+import { dataRefreshedAt } from '../data.js';
+// ── I/O helpers ──────────────────────────────────────────────────────────────
+export function writeLine(stream, value = '') {
+    stream.write(value.endsWith('\n') ? value : `${value}\n`);
+}
+export function writeJson(stream, value) {
+    writeLine(stream, JSON.stringify(value, null, 2));
+}
+export function usageError(io, message) {
+    writeLine(io.stderr, message);
+    return 1;
+}
+/**
+ * Returns true only when both stdout and stdin are real interactive TTYs AND the
+ * environment supports colour (i.e. not NO_COLOR or TERM=dumb). The gate keeps
+ * the interactive menu away from pipes, CI, and the test harness, all of which
+ * use non-TTY mock streams.
+ */
+export function isInteractive(io, env) {
+    if (env.NO_COLOR != null)
+        return false;
+    if (env.TERM === 'dumb')
+        return false;
+    const stdoutTTY = Boolean(io.stdout.isTTY);
+    const stdinTTY = Boolean(process.stdin.isTTY);
+    return stdoutTTY && stdinTTY;
+}
+// ── Flag helpers ─────────────────────────────────────────────────────────────
+export function stringFlag(parsed, longName, shortName) {
+    const value = parsed.flags[longName] ?? (shortName ? parsed.flags[shortName] : undefined);
+    return typeof value === 'string' ? value : undefined;
+}
+export function requiredStringFlag(parsed, longName, shortName) {
+    const value = stringFlag(parsed, longName, shortName);
+    return value?.trim() || undefined;
+}
+export function numberFlag(parsed, longName, shortName) {
+    const value = stringFlag(parsed, longName, shortName);
+    if (!value)
+        return undefined;
+    const parsedValue = Number(value);
+    return Number.isFinite(parsedValue) ? parsedValue : undefined;
+}
+export function envString(io, name) {
+    const value = io.env?.[name];
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
+export function authTokenInput(parsed, io) {
+    return (requiredStringFlag(parsed, 'token') ||
+        envString(io, 'AGORA_TOKEN') ||
+        envString(io, 'AGORA_API_TOKEN'));
+}
+// ── Options helpers ──────────────────────────────────────────────────────────
+export function detectDataDir(parsed, io) {
+    return detectAgoraDataDir({
+        explicitDir: stringFlag(parsed, 'dataDir'),
+        cwd: io.cwd,
+        env: io.env
+    });
+}
+export async function sourceOptions(parsed, io) {
+    const explicitApiUrl = stringFlag(parsed, 'apiUrl');
+    const envApiUrl = envString(io, 'AGORA_API_URL');
+    const dataDir = detectDataDir(parsed, io);
+    let state = loadAgoraState(dataDir);
+    state = await ensureFreshAccess(state, { dataDir, fetcher: io.fetcher });
+    const storedAuth = getAuthState(state);
+    const storedApiUrl = storedAuth?.apiUrl;
+    const apiUrl = explicitApiUrl || envApiUrl || storedApiUrl || '';
+    const useApi = explicitApiUrl !== undefined ||
+        envApiUrl !== undefined ||
+        storedApiUrl !== undefined ||
+        Boolean(parsed.flags.api) ||
+        Boolean(parsed.flags.live);
+    return {
+        useApi,
+        apiUrl,
+        token: authTokenInput(parsed, io) || storedAuth?.accessToken,
+        fetcher: io.fetcher,
+        timeoutMs: numberFlag(parsed, 'apiTimeout')
+    };
+}
+export async function writeSourceOptions(parsed, io) {
+    const options = await sourceOptions(parsed, io);
+    if (!options.apiUrl) {
+        return {
+            ok: false,
+            error: 'This command requires --api-url, AGORA_API_URL, or an auth login API URL'
+        };
+    }
+    if (!options.token) {
+        return {
+            ok: false,
+            error: 'This command requires --token, AGORA_TOKEN, AGORA_API_TOKEN, or agora auth login'
+        };
+    }
+    return { ok: true, options: { ...options, useApi: true } };
+}
+export async function readSourceOptions(parsed, io) {
+    const options = await sourceOptions(parsed, io);
+    if (!options.apiUrl) {
+        return {
+            ok: false,
+            error: 'This command requires --api-url, AGORA_API_URL, or an auth login API URL'
+        };
+    }
+    return { ok: true, options: { ...options, useApi: true } };
+}
+// ── Source display helpers ──────────────────────────────────────────────────
+export function sourceLabel(result) {
+    return result.source === 'offline'
+        ? `source: offline · refreshed ${dataRefreshedAt}`
+        : `source: ${result.source}`;
+}
+export function warnFallback(result, io) {
+    if (result.fallbackReason) {
+        writeLine(io.stderr, `Warning: API unavailable — using offline data (cached ${dataRefreshedAt})`);
+        writeLine(io.stderr, `  Reason: ${result.fallbackReason}`);
+    }
+}
+export function sourcePayload(result, payload) {
+    return {
+        source: result.source,
+        apiUrl: result.apiUrl,
+        fallbackReason: result.fallbackReason,
+        ...payload
+    };
+}
+// ── Auth display helpers ────────────────────────────────────────────────────
+export function maskToken(token) {
+    const value = token.trim();
+    if (value.length <= 4)
+        return '****';
+    if (value.length <= 8)
+        return `${'*'.repeat(value.length - 4)}${value.slice(-4)}`;
+    return `${value.slice(0, 4)}...${value.slice(-4)}`;
+}
+export function formatRelativeExp(exp, nowSec) {
+    if (exp === 0)
+        return 'unknown';
+    const diff = exp - nowSec;
+    if (diff <= 0)
+        return 'expired';
+    if (diff < 3600)
+        return `${Math.round(diff / 60)}m`;
+    if (diff < 86400)
+        return `${Math.round(diff / 3600)}h`;
+    return `${Math.round(diff / 86400)}d`;
+}
+export function authStatusPayload(dataDir, auth) {
+    return {
+        dataDir,
+        statePath: getAgoraStatePath(dataDir),
+        authenticated: Boolean(auth),
+        accessTokenPreview: auth ? maskToken(auth.accessToken) : undefined,
+        accessExp: auth?.accessExp,
+        refreshTokenPreview: auth?.refreshToken ? maskToken(auth.refreshToken) : undefined,
+        refreshExp: auth?.refreshExp,
+        apiUrl: auth?.apiUrl,
+        savedAt: auth?.savedAt
+    };
+}
+// ── Search helpers ──────────────────────────────────────────────────────────
+export function matchesSavedQuery(entry, query) {
+    if (!query)
+        return true;
+    const searchable = entry.item
+        ? [
+            entry.item.id,
+            entry.item.name,
+            entry.item.description,
+            entry.item.author,
+            entry.item.category,
+            ...entry.item.tags
+        ].join(' ')
+        : entry.saved.id;
+    return searchable.toLowerCase().includes(query);
+}
+// ── Tutorial helpers ────────────────────────────────────────────────────────
+export function tutorialLevelFlag(parsed) {
+    const level = stringFlag(parsed, 'level') || 'all';
+    if (level === 'all' || level === 'beginner' || level === 'intermediate' || level === 'advanced') {
+        return { ok: true, value: level };
+    }
+    return { ok: false, error: 'tutorial level must be beginner, intermediate, advanced, or all' };
+}
+export function tutorialStepNumber(parsed) {
+    const rawStep = parsed.args[1] || stringFlag(parsed, 'step');
+    if (!rawStep)
+        return { ok: true, value: 1 };
+    const step = Number(rawStep);
+    if (!Number.isInteger(step) || step < 1) {
+        return { ok: false, error: 'tutorial step must be a positive integer' };
+    }
+    return { ok: true, value: step };
+}
+export function tutorialStepPayload(tutorial, stepNumber) {
+    const step = tutorial.steps[stepNumber - 1];
+    return {
+        stepNumber,
+        totalSteps: tutorial.steps.length,
+        completed: !step,
+        title: step?.title,
+        content: step?.content,
+        code: step?.code
+    };
+}
+// ── Input helpers ───────────────────────────────────────────────────────────
+export function tagsFlag(parsed) {
+    const value = stringFlag(parsed, 'tags');
+    if (!value)
+        return [];
+    return value
+        .split(',')
+        .map((tag) => tag.trim())
+        .filter(Boolean);
+}
+export function promptInput(parsed, io) {
+    const prompt = stringFlag(parsed, 'prompt');
+    if (prompt)
+        return prompt;
+    const promptFile = stringFlag(parsed, 'promptFile');
+    if (!promptFile)
+        return undefined;
+    if (!existsSync(promptFile)) {
+        usageError(io, `prompt-file not found: ${promptFile}`);
+        return undefined;
+    }
+    return readFileSync(promptFile, 'utf8');
+}
+export function contentInput(parsed, io) {
+    const content = requiredStringFlag(parsed, 'content');
+    if (content)
+        return content;
+    const contentFile = stringFlag(parsed, 'contentFile');
+    if (!contentFile)
+        return undefined;
+    if (!existsSync(contentFile)) {
+        usageError(io, `content-file not found: ${contentFile}`);
+        return undefined;
+    }
+    return readFileSync(contentFile, 'utf8').trim();
+}
+export function itemTypeFlag(parsed, itemId) {
+    const type = stringFlag(parsed, 'type', 't');
+    if (type === 'workflow' || itemId.startsWith('wf-'))
+        return 'workflow';
+    return 'package';
+}
+export function discussionCategoryFlag(parsed) {
+    const category = stringFlag(parsed, 'category', 'c') || 'discussion';
+    if (category === 'question' ||
+        category === 'idea' ||
+        category === 'showcase' ||
+        category === 'discussion') {
+        return { ok: true, value: category };
+    }
+    return {
+        ok: false,
+        error: 'discussion category must be question, idea, showcase, or discussion'
+    };
+}
+// ── Chat helpers ────────────────────────────────────────────────────────────
+export function extractSessionId(line) {
+    try {
+        const ev = JSON.parse(line);
+        if (ev.sessionID && typeof ev.sessionID === 'string')
+            return ev.sessionID;
+    }
+    catch {
+        /* not JSON, skip */
+    }
+    return null;
+}
+export function persistChatSession(dataDir, sessionId) {
+    try {
+        const state = loadAgoraState(dataDir);
+        const updated = {
+            ...state,
+            _meta: { ...(state._meta || {}), lastChatSession: sessionId }
+        };
+        writeAgoraState(dataDir, updated);
+    }
+    catch {
+        // best-effort
+    }
+}
+export function loadLastChatSession(dataDir) {
+    try {
+        const state = loadAgoraState(dataDir);
+        return state._meta?.lastChatSession;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=helpers.js.map