@soku-ai/cli 0.1.0-alpha.4 → 0.1.0-alpha.6

package/dist/commands/update.js

@@ -0,0 +1,345 @@
+/** `soku update` — keep the CLI and locally installed Soku skills fresh. */
+import { spawn, spawnSync } from 'node:child_process';
+import { closeSync, existsSync, mkdirSync, openSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { configDir, resolveSkillsBaseUrl } from '../config.js';
+import { cyan, dim, emitError, emitSuccess, ExitCode, green, table } from '../output/envelope.js';
+import { checkForUpdate } from '../update-check.js';
+import { agentSkillName, baseDirFor, fetchIndex, installBusinessSkill, installMetaSoku, loadManifest, manifestPath, parseAgents, SOKU_META, } from './skill.js';
+const DEFAULT_AUTO_UPDATE_INTERVAL_HOURS = 24;
+const AUTO_UPDATE_LOCK_TTL_MS = 10 * 60 * 1000;
+function statePath() {
+    return join(configDir(), 'update-state.json');
+}
+function lockPath() {
+    return join(configDir(), 'update.lock');
+}
+function readUpdateState() {
+    try {
+        return JSON.parse(readFileSync(statePath(), 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+function writeUpdateState(state) {
+    const path = statePath();
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(state, null, 2)}\n`, { mode: 0o600 });
+}
+function parseIntervalHours(value) {
+    if (!value)
+        return DEFAULT_AUTO_UPDATE_INTERVAL_HOURS;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : DEFAULT_AUTO_UPDATE_INTERVAL_HOURS;
+}
+export function isAutoUpdateDue(lastRunAt, now, intervalHours) {
+    if (!lastRunAt)
+        return true;
+    const last = Date.parse(lastRunAt);
+    if (!Number.isFinite(last))
+        return true;
+    return now.getTime() - last >= intervalHours * 60 * 60 * 1000;
+}
+async function withUpdateLock(fn) {
+    const path = lockPath();
+    mkdirSync(dirname(path), { recursive: true });
+    try {
+        if (existsSync(path)) {
+            const createdAt = Number(readFileSync(path, 'utf8').split('\n', 1)[0]);
+            if (Number.isFinite(createdAt) && Date.now() - createdAt > AUTO_UPDATE_LOCK_TTL_MS) {
+                rmSync(path, { force: true });
+            }
+        }
+    }
+    catch {
+        // Ignore malformed stale-lock probes; the exclusive open below decides.
+    }
+    let fd;
+    try {
+        fd = openSync(path, 'wx', 0o600);
+    }
+    catch {
+        return null;
+    }
+    try {
+        writeFileSync(fd, `${Date.now()}\n${process.pid}\n`);
+        return await fn();
+    }
+    finally {
+        closeSync(fd);
+        rmSync(path, { force: true });
+    }
+}
+function targetLocation(global) {
+    return global ? 'global' : 'project';
+}
+function discoverInstalledTargets(agentOpt = 'all', scope = 'all') {
+    const agents = parseAgents(agentOpt);
+    const targets = [];
+    for (const agent of agents) {
+        for (const global of [false, true]) {
+            if (scope === 'global' && !global)
+                continue;
+            if (scope === 'project' && global)
+                continue;
+            const baseDir = baseDirFor(agent, global);
+            if (existsSync(manifestPath(baseDir))) {
+                targets.push({ agent, global, baseDir });
+            }
+        }
+    }
+    return targets;
+}
+function fallbackTargets(agentOpt = 'claude', scope = 'global') {
+    const agents = parseAgents(agentOpt);
+    const global = scope !== 'project';
+    return agents.map((agent) => ({ agent, global, baseDir: baseDirFor(agent, global) }));
+}
+function targetsForUpdate(agentOpt, scope) {
+    const installed = discoverInstalledTargets(agentOpt, scope);
+    return installed.length > 0 ? installed : fallbackTargets(agentOpt, scope);
+}
+function indexBySlug(index) {
+    return new Map(index.skills.map((entry) => [entry.slug, entry]));
+}
+export async function updateSkillTarget(target, base, index) {
+    const before = loadManifest(target.baseDir);
+    const slugs = Object.keys(before).filter((slug) => slug !== SOKU_META);
+    const metaUpdated = SOKU_META in before || slugs.length > 0 || existsSync(join(target.baseDir, SOKU_META, 'SKILL.md'));
+    if (metaUpdated)
+        installMetaSoku(target.baseDir);
+    const updated = [];
+    const unchanged = [];
+    const missing = [];
+    if (slugs.length > 0) {
+        const catalog = indexBySlug(index ?? (await fetchIndex(base)));
+        for (const slug of slugs) {
+            const entry = catalog.get(slug);
+            if (!entry) {
+                missing.push(slug);
+                continue;
+            }
+            const current = before[slug];
+            if (current?.sha256 === entry.sha256 && current.version === (entry.version ?? null) && current.source === 'catalog') {
+                unchanged.push(slug);
+                continue;
+            }
+            await installBusinessSkill(target.baseDir, entry, base);
+            updated.push(slug);
+        }
+    }
+    return {
+        agent: target.agent,
+        global: target.global,
+        baseDir: target.baseDir,
+        metaUpdated,
+        updated,
+        unchanged,
+        missing,
+    };
+}
+async function updateSkills(opts) {
+    const targets = targetsForUpdate(opts.agent, opts.scope);
+    const base = resolveSkillsBaseUrl(opts.skillsUrl);
+    const needsCatalog = targets.some((target) => Object.keys(loadManifest(target.baseDir)).some((slug) => slug !== SOKU_META));
+    const index = needsCatalog ? await fetchIndex(base) : undefined;
+    const results = [];
+    for (const target of targets) {
+        results.push(await updateSkillTarget(target, base, index));
+    }
+    return results;
+}
+function skillStatusRows(targets, index) {
+    const catalog = indexBySlug(index);
+    const rows = [];
+    for (const target of targets) {
+        const manifest = loadManifest(target.baseDir);
+        for (const [slug, current] of Object.entries(manifest)) {
+            if (slug === SOKU_META) {
+                rows.push({
+                    agent: target.agent,
+                    location: targetLocation(target.global),
+                    slug: agentSkillName(slug),
+                    current: 'bundled',
+                    latest: 'bundled',
+                    status: 'bundled',
+                });
+                continue;
+            }
+            const entry = catalog.get(slug);
+            rows.push({
+                agent: target.agent,
+                location: targetLocation(target.global),
+                slug: agentSkillName(slug),
+                current: current.version || current.sha256.slice(0, 12),
+                latest: entry?.version || entry?.sha256.slice(0, 12) || '',
+                status: !entry
+                    ? 'missing_from_catalog'
+                    : current.sha256 === entry.sha256 && current.version === (entry.version ?? null) && current.source === 'catalog'
+                        ? 'current'
+                        : 'update_available',
+            });
+        }
+    }
+    return rows;
+}
+function renderSkillUpdateResults(results) {
+    const rows = results.map((result) => ({
+        agent: result.agent,
+        location: targetLocation(result.global),
+        updated: result.updated.length,
+        unchanged: result.unchanged.length,
+        missing: result.missing.length,
+        meta: result.metaUpdated ? 'yes' : 'no',
+        dir: result.baseDir,
+    }));
+    return [
+        `${green('✓')} Soku skills updated`,
+        table(rows, [
+            { key: 'agent', header: 'AGENT' },
+            { key: 'location', header: 'LOCATION' },
+            { key: 'updated', header: 'UPDATED' },
+            { key: 'unchanged', header: 'UNCHANGED' },
+            { key: 'missing', header: 'MISSING' },
+            { key: 'meta', header: 'META' },
+            { key: 'dir', header: 'DIR' },
+        ]),
+    ].join('\n');
+}
+function runNpmCliInstall() {
+    const result = spawnSync('npm', ['i', '-g', '@soku-ai/cli'], { stdio: 'inherit' });
+    if (typeof result.status === 'number')
+        return result.status;
+    return 1;
+}
+function spawnSkillAutoUpdate(entrypoint) {
+    const child = spawn(process.execPath, [entrypoint, 'update', 'skills', '--quiet'], {
+        env: {
+            ...process.env,
+            SOKU_NO_UPDATE_CHECK: '1',
+            SOKU_NO_SKILL_AUTO_UPDATE: '1',
+        },
+        stdio: 'ignore',
+        detached: true,
+    });
+    child.on('error', () => {
+        // Background update is best-effort and must never break the foreground command.
+    });
+    child.unref();
+}
+export async function maybeAutoUpdateSkills() {
+    if (process.env.CI)
+        return;
+    if (process.env.SOKU_NO_UPDATE_CHECK === '1')
+        return;
+    if (process.env.SOKU_NO_SKILL_AUTO_UPDATE === '1')
+        return;
+    if (!process.argv[1])
+        return;
+    const state = readUpdateState();
+    const now = new Date();
+    const interval = parseIntervalHours(process.env.SOKU_UPDATE_INTERVAL_HOURS);
+    if (!isAutoUpdateDue(state.lastSkillAutoUpdateAt, now, interval))
+        return;
+    await withUpdateLock(() => {
+        writeUpdateState({ ...readUpdateState(), lastSkillAutoUpdateAt: now.toISOString() });
+        spawnSkillAutoUpdate(process.argv[1]);
+    });
+}
+export async function maybeAutoUpdateCli() {
+    if (process.env.CI)
+        return;
+    if (process.env.SOKU_NO_UPDATE_CHECK === '1')
+        return;
+    if (process.env.SOKU_AUTO_UPDATE_CLI !== '1')
+        return;
+    const state = readUpdateState();
+    const now = new Date();
+    const interval = parseIntervalHours(process.env.SOKU_UPDATE_INTERVAL_HOURS);
+    if (!isAutoUpdateDue(state.lastCliAutoUpdateAt, now, interval))
+        return;
+    await withUpdateLock(async () => {
+        try {
+            const check = await checkForUpdate();
+            if (check.updateAvailable) {
+                const status = runNpmCliInstall();
+                if (status === 0) {
+                    process.stderr.write(`${dim('Soku CLI auto-updated. Restart your shell or agent session to use the new version.')}\n`);
+                }
+            }
+        }
+        catch {
+            // Advisory only; never block the user's command.
+        }
+        finally {
+            writeUpdateState({ ...readUpdateState(), lastCliAutoUpdateAt: now.toISOString() });
+        }
+    });
+}
+export function registerUpdateCommand(program) {
+    const update = program.command('update').description('Update the Soku CLI and installed Soku skills');
+    update
+        .command('status')
+        .description('Show CLI and installed skill update status')
+        .option('--agent <agent>', 'claude | codex | cursor | all', 'all')
+        .option('--global', 'Only inspect user-level (~) skills directories')
+        .option('--project', 'Only inspect project-level skills directories')
+        .option('--skills-url <url>', 'Override the skill catalog base url')
+        .action(async (opts) => {
+        const scope = opts.global ? 'global' : opts.project ? 'project' : 'all';
+        const targets = discoverInstalledTargets(opts.agent, scope);
+        const [cli, index] = await Promise.all([checkForUpdate(), fetchIndex(resolveSkillsBaseUrl(opts.skillsUrl))]);
+        const payload = { cli, skills: skillStatusRows(targets, index) };
+        emitSuccess(payload, (d) => {
+            const cliLine = d.cli.updateAvailable
+                ? `${d.cli.packageName} ${d.cli.currentVersion} -> ${d.cli.latestVersion}`
+                : `${d.cli.packageName} is current (${d.cli.currentVersion})`;
+            const skillLines = d.skills.length === 0
+                ? dim('(no Soku-managed skills installed)')
+                : table(d.skills.map((row) => ({ ...row })), [
+                    { key: 'agent', header: 'AGENT' },
+                    { key: 'location', header: 'LOCATION' },
+                    { key: 'slug', header: 'SKILL' },
+                    { key: 'current', header: 'CURRENT' },
+                    { key: 'latest', header: 'LATEST' },
+                    { key: 'status', header: 'STATUS' },
+                ]);
+            return [`CLI: ${cliLine}`, '', 'Skills:', skillLines].join('\n');
+        });
+    });
+    update
+        .command('skills')
+        .description('Update installed Soku meta-skill and business skills')
+        .option('--agent <agent>', 'claude | codex | cursor | all', 'all')
+        .option('--global', 'Only update user-level (~) skills directories')
+        .option('--project', 'Only update project-level skills directories')
+        .option('--skills-url <url>', 'Override the skill catalog base url')
+        .option('--quiet', 'Suppress output except errors')
+        .action(async (opts) => {
+        const scope = opts.global ? 'global' : opts.project ? 'project' : 'all';
+        const results = await updateSkills({ agent: opts.agent, scope, skillsUrl: opts.skillsUrl });
+        if (opts.quiet)
+            process.exit(ExitCode.OK);
+        emitSuccess({ results }, (d) => renderSkillUpdateResults(d.results));
+    });
+    update
+        .command('cli')
+        .description('Install the latest @soku-ai/cli from npm')
+        .option('--dry-run', 'Only report what would be installed')
+        .action(async (opts) => {
+        const result = await checkForUpdate();
+        if (!result.updateAvailable || !result.latestVersion) {
+            emitSuccess(result, (d) => `${d.packageName} is up to date (${d.currentVersion}).`);
+        }
+        if (opts.dryRun) {
+            emitSuccess(result, (d) => `${d.packageName} ${d.currentVersion} -> ${d.latestVersion}\n${dim('Run')} ${cyan(d.installCommand)}`);
+        }
+        const status = runNpmCliInstall();
+        if (status !== 0) {
+            emitError('update_failed', `npm install exited with status ${status}`, ExitCode.RUNTIME, result.installCommand);
+        }
+        emitSuccess({ ...result, installed: true }, (d) => `${green('✓')} Installed ${d.packageName} ${d.latestVersion}\n${dim('Restart your shell or agent session to use it.')}`);
+    });
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

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

package/dist/commands/workspace.d.ts

@@ -0,0 +1,4 @@
+/** `soku workspace` — inspect and resolve the active org/brand selection. */
+import { Command } from 'commander';
+export declare function registerWorkspaceCommands(program: Command): void;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/commands/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/commands/workspace.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAE7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAsFnC,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwFhE"}

package/dist/commands/workspace.js

@@ -0,0 +1,132 @@
+/** `soku workspace` — inspect and resolve the active org/brand selection. */
+import { loadConfig, updateConfig } from '../config.js';
+import { apiRequest } from '../http/client.js';
+import { cyan, dim, emitError, emitSuccess, ExitCode, green, table } from '../output/envelope.js';
+import { matchRef } from '../resolve.js';
+function resolveSearchMatch(brands, ref) {
+    const exact = matchRef(brands, ref);
+    if (exact.kind !== 'none')
+        return exact;
+    if (brands.length === 1)
+        return { kind: 'match', item: brands[0] };
+    if (brands.length > 1)
+        return { kind: 'ambiguous', matches: brands };
+    return { kind: 'none' };
+}
+async function searchBrands(query, limit) {
+    const data = await apiRequest(`/api/cli/brands/search?q=${encodeURIComponent(query)}&limit=${encodeURIComponent(String(limit))}`);
+    return data.brands;
+}
+function resolveBrandCandidates(brands, ref) {
+    const res = resolveSearchMatch(brands, ref);
+    if (res.kind === 'match') {
+        return { resolved: true, reason: 'match', brand: res.item, candidates: [res.item] };
+    }
+    if (res.kind === 'ambiguous') {
+        return { resolved: false, reason: 'ambiguous', brand: null, candidates: res.matches };
+    }
+    return { resolved: false, reason: 'not_found', brand: null, candidates: [] };
+}
+function renderBrandCandidates(candidates) {
+    return table(candidates.map((b) => ({
+        name: b.name,
+        slug: b.slug,
+        org: b.org_slug || b.org_name || b.org_id,
+        id: b.id,
+    })), [
+        { key: 'name', header: 'BRAND' },
+        { key: 'slug', header: 'SLUG' },
+        { key: 'org', header: 'ORG' },
+        { key: 'id', header: 'ID' },
+    ]);
+}
+function useResolvedBrand(result, ref) {
+    if (result.resolved && result.brand)
+        return result.brand;
+    if (result.reason === 'not_found') {
+        emitError('not_found', `No accessible brand matching "${ref}".`, ExitCode.NOT_FOUND, 'Run `soku workspace resolve <brand>` to inspect candidates.');
+    }
+    const candidates = result.candidates.map((b) => `${b.slug} (${b.org_slug || b.org_name || b.org_id})`).join(', ');
+    return emitError('ambiguous', `"${ref}" matches ${result.candidates.length} brands.`, ExitCode.USAGE, `Use an exact slug or id: ${candidates}`);
+}
+export function registerWorkspaceCommands(program) {
+    const workspace = program.command('workspace').description('Inspect or set the active Soku workspace');
+    workspace
+        .command('status')
+        .description('Show the active organization and brand')
+        .action(async () => {
+        const cfg = loadConfig();
+        const orgsData = await apiRequest('/api/cli/orgs');
+        const org = cfg.activeOrgId ? orgsData.orgs.find((item) => item.id === cfg.activeOrgId) : undefined;
+        let brand;
+        if (org && cfg.activeBrandId) {
+            const brandsData = await apiRequest(`/api/cli/brands?org_id=${encodeURIComponent(org.id)}`);
+            brand = brandsData.brands.find((item) => item.id === cfg.activeBrandId);
+        }
+        const data = {
+            active_org_id: cfg.activeOrgId ?? null,
+            active_org_name: org?.name ?? null,
+            active_org_slug: org?.slug ?? null,
+            active_brand_id: cfg.activeBrandId ?? null,
+            active_brand_name: brand?.name ?? null,
+            active_brand_slug: brand?.slug ?? null,
+            workspace_ready: Boolean(org && brand),
+        };
+        emitSuccess(data, (d) => {
+            const orgLabel = d.active_org_slug || d.active_org_name || d.active_org_id || '(none)';
+            const brandLabel = d.active_brand_slug || d.active_brand_name || d.active_brand_id || '(none)';
+            const ready = d.workspace_ready ? green('ready') : 'not ready';
+            return [
+                `Workspace: ${ready}`,
+                `Org: ${orgLabel}`,
+                `Brand: ${brandLabel}`,
+                d.workspace_ready
+                    ? dim('Next: soku resources list')
+                    : dim('Next: soku workspace use-brand <brand>'),
+            ].join('\n');
+        });
+    });
+    workspace
+        .command('resolve <brand>')
+        .description('Resolve a brand across all accessible organizations without changing workspace')
+        .option('--limit <n>', 'Maximum candidates to inspect', '20')
+        .action(async (ref, opts) => {
+        const limit = Number(opts.limit);
+        if (!Number.isFinite(limit) || limit < 1) {
+            emitError('usage', '--limit must be a positive number.', ExitCode.USAGE);
+        }
+        const result = resolveBrandCandidates(await searchBrands(ref, limit), ref);
+        emitSuccess(result, (d) => {
+            if (d.resolved && d.brand) {
+                const org = d.brand.org_slug || d.brand.org_name || d.brand.org_id;
+                return [
+                    `${green('✓')} Resolved brand: ${cyan(org)} / ${cyan(d.brand.name)} ${dim(`(${d.brand.id})`)}`,
+                    dim(`Next: soku workspace use-brand ${ref}`),
+                ].join('\n');
+            }
+            if (d.reason === 'not_found')
+                return `${dim('(no accessible brand candidates)')}\n${dim('Try a different brand name or slug.')}`;
+            return [
+                `${dim(`Ambiguous: ${d.candidates.length} candidates`)}`,
+                renderBrandCandidates(d.candidates),
+                dim('Next: rerun with an exact brand slug or id.'),
+            ].join('\n');
+        });
+    });
+    workspace
+        .command('use-brand <brand>')
+        .description('Resolve a brand across all organizations and set org+brand together')
+        .action(async (ref) => {
+        const result = resolveBrandCandidates(await searchBrands(ref, 20), ref);
+        const match = useResolvedBrand(result, ref);
+        updateConfig({ activeOrgId: match.org_id, activeBrandId: match.id });
+        emitSuccess({
+            active_org_id: match.org_id,
+            active_brand_id: match.id,
+            name: match.name,
+            org_name: match.org_name,
+            org_slug: match.org_slug,
+        }, (d) => `${green('✓')} Active workspace: ${cyan(d.org_slug || d.org_name || d.active_org_id)} / ${cyan(d.name)} ${dim(`(${d.active_brand_id})`)}\n  ${dim('Next: soku resources list')}`);
+    });
+}
+//# sourceMappingURL=workspace.js.map

package/dist/commands/workspace.js.map

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

package/dist/config.d.ts

@@ -4,7 +4,7 @@ export interface SokuConfig {
     apiBaseUrl?: string;
     activeOrgId?: string;
     activeBrandId?: string;
-    /** Deprecated and ignored. Skill CDN overrides are environment-only. */
+    /** Deprecated and ignored. Skill catalog overrides are environment-only. */
     skillsBaseUrl?: string;
 }
 export declare function configDir(): string;
@@ -13,6 +13,6 @@ export declare function saveConfig(config: SokuConfig): void;
 export declare function updateConfig(patch: Partial<SokuConfig>): SokuConfig;
 /** Resolution order: --api-base flag (caller passes) → env → production default. */
 export declare function resolveApiBaseUrl(flag?: string): string;
-/** Resolution order: --skills-url flag → env → production CDN. */
+/** Resolution order: --skills-url flag → env → production skill catalog. */
 export declare function resolveSkillsBaseUrl(flag?: string): string;
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAM5E,MAAM,WAAW,UAAU;IACzB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAKD,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAMD,wBAAgB,UAAU,IAAI,UAAU,CAMvC;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAInD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAInE;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED,kEAAkE;AAClE,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAM1D"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAM5E,MAAM,WAAW,UAAU;IACzB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAKD,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAMD,wBAAgB,UAAU,IAAI,UAAU,CAMvC;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAInD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,UAAU,CAInE;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAM1D"}

package/dist/config.js

@@ -3,7 +3,7 @@ import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
 const DEFAULT_API_BASE = 'https://api.soku.ai';
-const DEFAULT_SKILLS_BASE = 'https://cdn.soku.ai/skills';
+const DEFAULT_SKILLS_BASE = 'https://api.soku.ai/api/cli/skills';
 export function configDir() {
     return join(homedir(), '.soku');
 }
@@ -34,7 +34,7 @@ export function resolveApiBaseUrl(flag) {
         process.env.SOKU_API_BASE ||
         DEFAULT_API_BASE).replace(/\/$/, '');
 }
-/** Resolution order: --skills-url flag → env → production CDN. */
+/** Resolution order: --skills-url flag → env → production skill catalog. */
 export function resolveSkillsBaseUrl(flag) {
     return (flag ||
         process.env.SOKU_SKILLS_URL ||

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAWzC,MAAM,gBAAgB,GAAG,qBAAqB,CAAA;AAC9C,MAAM,mBAAmB,GAAG,4BAA4B,CAAA;AAExD,MAAM,UAAU,SAAS;IACvB,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAA;AACjC,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,IAAI,CAAC,SAAS,EAAE,EAAE,aAAa,CAAC,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC,CAAe,CAAA;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAkB;IAC3C,MAAM,IAAI,GAAG,UAAU,EAAE,CAAA;IACzB,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;AACvE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAA0B;IACrD,MAAM,IAAI,GAAG,EAAE,GAAG,UAAU,EAAE,EAAE,GAAG,KAAK,EAAE,CAAA;IAC1C,UAAU,CAAC,IAAI,CAAC,CAAA;IAChB,OAAO,IAAI,CAAA;AACb,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,iBAAiB,CAAC,IAAa;IAC7C,OAAO,CACL,IAAI;QACJ,OAAO,CAAC,GAAG,CAAC,aAAa;QACzB,gBAAgB,CACjB,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;AACtB,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,oBAAoB,CAAC,IAAa;IAChD,OAAO,CACL,IAAI;QACJ,OAAO,CAAC,GAAG,CAAC,eAAe;QAC3B,mBAAmB,CACpB,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;AACtB,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAWzC,MAAM,gBAAgB,GAAG,qBAAqB,CAAA;AAC9C,MAAM,mBAAmB,GAAG,oCAAoC,CAAA;AAEhE,MAAM,UAAU,SAAS;IACvB,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAA;AACjC,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,IAAI,CAAC,SAAS,EAAE,EAAE,aAAa,CAAC,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,EAAE,MAAM,CAAC,CAAe,CAAA;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAkB;IAC3C,MAAM,IAAI,GAAG,UAAU,EAAE,CAAA;IACzB,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC7C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;AACvE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAA0B;IACrD,MAAM,IAAI,GAAG,EAAE,GAAG,UAAU,EAAE,EAAE,GAAG,KAAK,EAAE,CAAA;IAC1C,UAAU,CAAC,IAAI,CAAC,CAAA;IAChB,OAAO,IAAI,CAAA;AACb,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,iBAAiB,CAAC,IAAa;IAC7C,OAAO,CACL,IAAI;QACJ,OAAO,CAAC,GAAG,CAAC,aAAa;QACzB,gBAAgB,CACjB,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;AACtB,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,oBAAoB,CAAC,IAAa;IAChD,OAAO,CACL,IAAI;QACJ,OAAO,CAAC,GAAG,CAAC,eAAe;QAC3B,mBAAmB,CACpB,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;AACtB,CAAC"}

package/dist/generated/capabilities.json

@@ -358,7 +358,7 @@
       "namespace": "ads",
       "action": "query_single_dimension",
       "description": "Primary cached ads analytics query for one dimension; returns column-oriented business metrics, derived metrics, and cg.{slug}.* conversion fan-out.",
-      "long_description": "PRIMARY PATH for cached ads analytics.\n\nPrimary use:\nSingle-dimension reporting over synced Nex business-layer ads data. Use this for daily report KPIs, campaign/ad/adgroup/keyword/search-term/device/country breakdowns, cross-platform-consistent metrics, and mapping-aware derived metrics.\n\nUse when:\n- The analysis has exactly one group-by dimension.\n- The user asks for CPA, CPP, ROAS, Reg Rate, Pur Rate, or cg.{slug}.* metrics.\n- The result should use Nex cached Parquet data and business semantics.\n\nDo not use when:\n- The user needs multiple group-by dimensions. Use query_multi_dimension.\n- The field or segment is not exposed by list_dimensions. Use get_resource_metadata then gaql_search for Google-native exploration.\n- The user needs write or mutation history. Use ads-ops or list_operation_records.\n\nWorkflow:\n1. Call list_ad_accounts if account_id is unknown.\n2. Call list_dimensions to choose a valid dimension, filters, and metrics.\n3. Call list_conversion_groups only if conversion-group fan-out or CPA/ROAS-like metrics are needed.\n4. Call this action with platform, account_id, date_start, date_end, and dimension.\n\nOutput semantics:\n- Returns column-oriented data. Read data.columns.<column>[i], not data.rows.\n- spend_micros and cpc_micros are micros; ctr is a 0-1 ratio.\n- scope_caveat explains aggregation limits for the selected scope.\n- mode=summary returns summary data such as top rows, totals, and p95 where supported.\n- truncated or warning means the agent must mention partial result limits.\n- For id-keyed dimensions (campaign / account / adgroup / ad), dimension_label is the resolved entity name (e.g., adset name for adgroup dimension); falls back to the platform id when the entity record is missing or has no name.",
+      "long_description": "PRIMARY PATH for cached ads analytics.\n\nPrimary use:\nSingle-dimension reporting over synced Nex business-layer ads data. Use this for metrics report KPIs, campaign/ad/adgroup/keyword/search-term/device/country breakdowns, cross-platform-consistent metrics, and mapping-aware derived metrics.\n\nUse when:\n- The analysis has exactly one group-by dimension.\n- The user asks for CPA, CPP, ROAS, Reg Rate, Pur Rate, or cg.{slug}.* metrics.\n- The result should use Nex cached Parquet data and business semantics.\n\nDo not use when:\n- The user needs multiple group-by dimensions. Use query_multi_dimension.\n- The field or segment is not exposed by list_dimensions. Use get_resource_metadata then gaql_search for Google-native exploration.\n- The user needs write or mutation history. Use ads-ops or list_operation_records.\n\nWorkflow:\n1. Call list_ad_accounts if account_id is unknown.\n2. Call list_dimensions to choose a valid dimension, filters, and metrics.\n3. Call list_conversion_groups only if conversion-group fan-out or CPA/ROAS-like metrics are needed.\n4. Call this action with platform, account_id, date_start, date_end, and dimension.\n\nOutput semantics:\n- Returns column-oriented data. Read data.columns.<column>[i], not data.rows.\n- spend_micros and cpc_micros are micros; ctr is a 0-1 ratio.\n- scope_caveat explains aggregation limits for the selected scope.\n- mode=summary returns summary data such as top rows, totals, and p95 where supported.\n- truncated or warning means the agent must mention partial result limits.\n- For id-keyed dimensions (campaign / account / adgroup / ad), dimension_label is the resolved entity name (e.g., adset name for adgroup dimension); falls back to the platform id when the entity record is missing or has no name.",
       "capability_mode": "read",
       "priority": "primary",
       "requires_review": false,

package/dist/http/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/http/client.ts"],"names":[],"mappings":"AAAA;gFACgF;AAMhF,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,6DAA6D;IAC7D,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,wBAAsB,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC,CA6EjG"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/http/client.ts"],"names":[],"mappings":"AAAA;gFACgF;AAMhF,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,6DAA6D;IAC7D,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,wBAAsB,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC,CAkFjG"}