@tutorflow/cli 0.3.1 → 0.5.0

package/dist/config.js

@@ -40,28 +40,29 @@ exports.deleteConfig = deleteConfig;
 const fs = __importStar(require("fs/promises"));
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));
-const CONFIG_PATH = path.join(os.homedir(), '.tutorflow', 'config.json');
-async function ensureConfigDir() {
-    const dir = path.dirname(CONFIG_PATH);
-    try {
-        await fs.mkdir(dir, { recursive: true });
-    }
-    catch (error) {
-        // Already exists or permission denied - both OK here
-    }
+/** The file holds an API key: owner read/write only. */
+const CONFIG_FILE_MODE = 0o600;
+const CONFIG_DIR_MODE = 0o700;
+// Resolved per call so tests (and users) can point HOME elsewhere.
+function configPath() {
+    return path.join(os.homedir(), '.tutorflow', 'config.json');
 }
 async function readConfig() {
     try {
-        const content = await fs.readFile(CONFIG_PATH, 'utf-8');
-        return JSON.parse(content);
+        const content = await fs.readFile(configPath(), 'utf-8');
+        const parsed = JSON.parse(content);
+        return parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : {};
     }
-    catch (error) {
+    catch {
         return {};
     }
 }
 async function writeConfig(config) {
-    await ensureConfigDir();
-    await fs.writeFile(CONFIG_PATH, JSON.stringify(config, null, 2));
+    const file = configPath();
+    await fs.mkdir(path.dirname(file), { recursive: true, mode: CONFIG_DIR_MODE });
+    await fs.writeFile(file, JSON.stringify(config, null, 2), { mode: CONFIG_FILE_MODE });
+    // writeFile's mode applies only on creation; tighten files written by 0.x.
+    await fs.chmod(file, CONFIG_FILE_MODE);
 }
 async function updateConfig(updates) {
     const current = await readConfig();
@@ -71,9 +72,9 @@ async function updateConfig(updates) {
 }
 async function deleteConfig() {
     try {
-        await fs.unlink(CONFIG_PATH);
+        await fs.unlink(configPath());
     }
-    catch (error) {
+    catch {
         // Already deleted
     }
 }

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqBA,gCAOC;AAED,kCAGC;AAED,oCAKC;AAED,oCAMC;AAhDD,gDAAkC;AAClC,2CAA6B;AAC7B,uCAAyB;AAQzB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;AAEzE,KAAK,UAAU,eAAe;IAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,qDAAqD;IACvD,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,UAAU;IAC9B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,WAAW,CAAC,MAAe;IAC/C,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AACnE,CAAC;AAEM,KAAK,UAAU,YAAY,CAAC,OAAyB;IAC1D,MAAM,OAAO,GAAG,MAAM,UAAU,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;IAC3C,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,OAAO,CAAC;AACjB,CAAC;AAEM,KAAK,UAAU,YAAY;IAChC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,kBAAkB;IACpB,CAAC;AACH,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsBA,gCAQC;AAED,kCAMC;AAED,oCAKC;AAED,oCAMC;AArDD,gDAAkC;AAClC,2CAA6B;AAC7B,uCAAyB;AAWzB,wDAAwD;AACxD,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAC/B,MAAM,eAAe,GAAG,KAAK,CAAC;AAE9B,mEAAmE;AACnE,SAAS,UAAU;IACjB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;AAC9D,CAAC;AAEM,KAAK,UAAU,UAAU;IAC9B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;QACzD,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5C,OAAO,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,MAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;IACnG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,WAAW,CAAC,MAAe;IAC/C,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;IAC1B,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;IAC/E,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACtF,2EAA2E;IAC3E,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;AACzC,CAAC;AAEM,KAAK,UAAU,YAAY,CAAC,OAAyB;IAC1D,MAAM,OAAO,GAAG,MAAM,UAAU,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;IAC3C,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,OAAO,CAAC;AACjB,CAAC;AAEM,KAAK,UAAU,YAAY;IAChC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,kBAAkB;IACpB,CAAC;AACH,CAAC"}

package/dist/content/context.d.ts

@@ -0,0 +1,26 @@
+import { ApiClient } from '../client';
+/**
+ * Everything a classroom-scoped content command needs: an authenticated
+ * client holding a tf_content_ key, and the classroom to act in.
+ */
+export interface ContentContext {
+    client: ApiClient;
+    classroomId: string;
+}
+/** Authenticated client that refuses deprecated tf_platform_ keys up front. */
+export declare function createContentClient(): Promise<ApiClient>;
+/**
+ * Classroom resolution, first match wins:
+ *   1. --classroom <id>
+ *   2. TUTORFLOW_CLASSROOM_ID
+ *   3. classroomId in ~/.tutorflow/config.json
+ *   4. GET /v1/platform/agent/account → sandboxClassroomId for a test key,
+ *      defaultClassroomId otherwise
+ *   5. GET /v1/content/classrooms when the account route refuses the key
+ *      (a classroom Settings key): the only classroom, or the sandbox one for
+ *      a test key
+ */
+export declare function resolveContentContext(): Promise<ContentContext>;
+export declare function classroomPath(ctx: ContentContext, suffix?: string): string;
+export declare function segment(id: string): string;
+//# sourceMappingURL=context.d.ts.map

package/dist/content/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/content/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAY,MAAM,WAAW,CAAC;AAKhD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAaD,+EAA+E;AAC/E,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,SAAS,CAAC,CAU9D;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,cAAc,CAAC,CAWrE;AA+BD,wBAAgB,aAAa,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,SAAK,GAAG,MAAM,CAEtE;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE1C"}

package/dist/content/context.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createContentClient = createContentClient;
+exports.resolveContentContext = resolveContentContext;
+exports.classroomPath = classroomPath;
+exports.segment = segment;
+const client_1 = require("../client");
+const config_1 = require("../config");
+const keys_1 = require("../utils/keys");
+const runtime_1 = require("../utils/runtime");
+/** Authenticated client that refuses deprecated tf_platform_ keys up front. */
+async function createContentClient() {
+    const client = await client_1.ApiClient.createAuthenticated();
+    if ((0, keys_1.getApiKeyKind)(client.apiKey) === 'platform') {
+        throw new runtime_1.CliError(keys_1.PLATFORM_KEY_MESSAGE, {
+            code: 'EPLATFORMKEY',
+            exitCode: 1,
+            details: { hint: 'tutorflow agent register --name <name> --slug <slug>' },
+        });
+    }
+    return client;
+}
+/**
+ * Classroom resolution, first match wins:
+ *   1. --classroom <id>
+ *   2. TUTORFLOW_CLASSROOM_ID
+ *   3. classroomId in ~/.tutorflow/config.json
+ *   4. GET /v1/platform/agent/account → sandboxClassroomId for a test key,
+ *      defaultClassroomId otherwise
+ *   5. GET /v1/content/classrooms when the account route refuses the key
+ *      (a classroom Settings key): the only classroom, or the sandbox one for
+ *      a test key
+ */
+async function resolveContentContext() {
+    const client = await createContentClient();
+    const pinned = (0, runtime_1.getClassroomOverride)() ?? (0, client_1.envValue)('TUTORFLOW_CLASSROOM_ID') ?? (await (0, config_1.readConfig)()).classroomId;
+    if (pinned)
+        return { client, classroomId: pinned };
+    const isTestKey = (0, keys_1.getApiKeyKind)(client.apiKey) === 'content_test';
+    const fromAccount = await classroomFromAccount(client, isTestKey);
+    if (fromAccount)
+        return { client, classroomId: fromAccount };
+    return { client, classroomId: await classroomFromList(client, isTestKey) };
+}
+async function classroomFromAccount(client, isTestKey) {
+    try {
+        const account = await client.request('GET', '/v1/platform/agent/account');
+        const id = isTestKey ? account.sandboxClassroomId : account.defaultClassroomId;
+        return id ?? undefined;
+    }
+    catch (error) {
+        // Not an agent key (or not a full one): try the classroom list instead.
+        if (error instanceof runtime_1.CliError && /^EHTTP_(401|403)$/.test(error.code))
+            return undefined;
+        throw error;
+    }
+}
+async function classroomFromList(client, isTestKey) {
+    const classrooms = await client.request('GET', '/v1/content/classrooms');
+    const candidates = isTestKey ? classrooms.filter((c) => c.isSandbox) : classrooms;
+    if (candidates.length === 1)
+        return candidates[0].id;
+    const listed = candidates.map((c) => `${c.id} (${c.name ?? 'unnamed'})`).join(', ');
+    throw new runtime_1.CliError(candidates.length === 0
+        ? 'This key reaches no classroom. Check the key with `tutorflow auth whoami`.'
+        : `This key reaches several classrooms; pass --classroom <id> or set TUTORFLOW_CLASSROOM_ID. Classrooms: ${listed}`, { code: 'ECLASSROOM', exitCode: 2 });
+}
+function classroomPath(ctx, suffix = '') {
+    return `/v1/content/classrooms/${encodeURIComponent(ctx.classroomId)}${suffix}`;
+}
+function segment(id) {
+    return encodeURIComponent(id);
+}
+//# sourceMappingURL=context.js.map

package/dist/content/context.js.map

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

package/dist/content/resource.d.ts

@@ -0,0 +1,66 @@
+import { Command } from 'commander';
+import { type ContentContext } from './context';
+import { type GenerationRun } from './runs';
+/**
+ * Builders for the subcommands every classroom resource shares
+ * (list, get, open, delete, generate) so each resource file only declares
+ * what is particular to it.
+ */
+export interface ResourceSpec {
+    /** Path segment under /v1/content/classrooms/{id}, e.g. "courses". */
+    path: string;
+    /** Singular noun for help text and messages, e.g. "course". */
+    noun: string;
+}
+export interface ContentResource {
+    id: string;
+    title?: string | null;
+    name?: string | null;
+    status?: string | null;
+    renderStatus?: string | null;
+    visibility?: string | null;
+    updatedAt?: string | null;
+    createdAt?: string | null;
+    editorUrl?: string | null;
+    publicUrl?: string | null;
+    [key: string]: unknown;
+}
+export interface ListPage<T> {
+    data?: T[];
+    items?: T[];
+    meta?: {
+        hasNextPage?: boolean;
+        nextCursor?: string | null;
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export declare function rowsOf<T>(page: ListPage<T> | T[]): T[];
+/** Text-mode table for any list of classroom resources. */
+export declare function printResourceList(page: ListPage<ContentResource> | ContentResource[]): void;
+export declare function resourcePath(ctx: ContentContext, spec: ResourceSpec, id?: string, suffix?: string): string;
+export declare function addListCommand(parent: Command, spec: ResourceSpec): void;
+export declare function addGetCommand(parent: Command, spec: ResourceSpec): void;
+export declare function addOpenCommand(parent: Command, spec: ResourceSpec): void;
+export declare function addDeleteCommand(parent: Command, spec: ResourceSpec): void;
+/** list + get + open + delete. */
+export declare function addCrudCommands(parent: Command, spec: ResourceSpec): void;
+export interface WaitOptions {
+    wait?: boolean;
+    timeout?: string;
+}
+export declare function addWaitOptions(cmd: Command, defaultTimeoutSeconds?: number): Command;
+export declare function parseTimeout(options: WaitOptions): number;
+export interface GenerateSpec<O> extends ResourceSpec {
+    description: string;
+    promptLabel: string;
+    example: string;
+    /** Adds the resource's own flags. */
+    configure: (cmd: Command) => Command;
+    /** Validates flags and builds the request body; runs before any API call. */
+    buildBody: (prompt: string, options: O) => Record<string, unknown>;
+}
+/** `<resource> generate [prompt]` (alias `create`): POST …/generate → 202 run. */
+export declare function addGenerateCommand<O>(parent: Command, spec: GenerateSpec<O>): void;
+export declare function printFinishedRun(ctx: ContentContext, run: GenerationRun): Promise<void>;
+//# sourceMappingURL=resource.d.ts.map

package/dist/content/resource.d.ts.map

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

package/dist/content/resource.js

@@ -0,0 +1,181 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rowsOf = rowsOf;
+exports.printResourceList = printResourceList;
+exports.resourcePath = resourcePath;
+exports.addListCommand = addListCommand;
+exports.addGetCommand = addGetCommand;
+exports.addOpenCommand = addOpenCommand;
+exports.addDeleteCommand = addDeleteCommand;
+exports.addCrudCommands = addCrudCommands;
+exports.addWaitOptions = addWaitOptions;
+exports.parseTimeout = parseTimeout;
+exports.addGenerateCommand = addGenerateCommand;
+exports.printFinishedRun = printFinishedRun;
+const open_1 = __importDefault(require("open"));
+const output_1 = require("../utils/output");
+const runtime_1 = require("../utils/runtime");
+const args_1 = require("../utils/args");
+const context_1 = require("./context");
+const runs_1 = require("./runs");
+const DEFAULT_PAGE_SIZE = '20';
+function rowsOf(page) {
+    if (Array.isArray(page))
+        return page;
+    return page.data ?? page.items ?? [];
+}
+/** Text-mode table for any list of classroom resources. */
+function printResourceList(page) {
+    if ((0, runtime_1.isJsonMode)()) {
+        (0, output_1.printResult)(page);
+        return;
+    }
+    (0, output_1.printResult)(rowsOf(page).map((row) => ({
+        ID: row.id,
+        Title: row.title ?? row.name ?? 'Untitled',
+        Status: row.status ?? row.renderStatus ?? row.visibility ?? '',
+        Updated: formatDate(row.updatedAt ?? row.createdAt),
+    })));
+    const meta = Array.isArray(page) ? undefined : page.meta;
+    if (meta?.nextCursor)
+        (0, output_1.printStatus)(`More: --cursor ${meta.nextCursor}`);
+    else if (meta?.hasNextPage)
+        (0, output_1.printStatus)('More results: pass --page <n+1>');
+}
+function formatDate(value) {
+    if (!value)
+        return '';
+    const date = new Date(value);
+    return Number.isNaN(date.getTime()) ? value : date.toISOString().slice(0, 10);
+}
+function resourcePath(ctx, spec, id, suffix = '') {
+    return (0, context_1.classroomPath)(ctx, `/${spec.path}${id ? `/${(0, context_1.segment)(id)}` : ''}${suffix}`);
+}
+function addListCommand(parent, spec) {
+    parent
+        .command('list')
+        .description(`List ${spec.noun}s in the classroom`)
+        .option('-l, --limit <number>', 'Items per page (max 100)', DEFAULT_PAGE_SIZE)
+        .option('-p, --page <number>', 'Page number, from 1', '1')
+        .option('-s, --search <text>', 'Search term')
+        .action((0, runtime_1.command)(async (options) => {
+        const limit = (0, args_1.parsePositiveInt)(options.limit, '--limit');
+        const page = (0, args_1.parsePositiveInt)(options.page, '--page');
+        const ctx = await (0, context_1.resolveContentContext)();
+        const qs = new URLSearchParams({ page: String(page), limit: String(limit) });
+        if (options.search)
+            qs.set('search', options.search);
+        const response = await ctx.client.request('GET', `${resourcePath(ctx, spec)}?${qs.toString()}`);
+        printResourceList(response);
+    }));
+}
+function addGetCommand(parent, spec) {
+    parent
+        .command('get <id>')
+        .description(`Fetch one ${spec.noun}`)
+        .action((0, runtime_1.command)(async (id) => {
+        const ctx = await (0, context_1.resolveContentContext)();
+        (0, output_1.printResult)(await ctx.client.request('GET', resourcePath(ctx, spec, id)));
+    }));
+}
+function addOpenCommand(parent, spec) {
+    parent
+        .command('open <id>')
+        .description(`Print the ${spec.noun}'s editor and public URLs; opens one in a browser on a TTY`)
+        .option('--editor', 'Open the classroom editor even when a public page exists')
+        .action((0, runtime_1.command)(async (id, options) => {
+        const ctx = await (0, context_1.resolveContentContext)();
+        const resource = await ctx.client.request('GET', resourcePath(ctx, spec, id));
+        const editorUrl = resource.editorUrl ?? null;
+        const publicUrl = resource.publicUrl ?? null;
+        const target = options.editor ? editorUrl : publicUrl ?? editorUrl;
+        if (!target) {
+            throw new runtime_1.CliError(`No editor or public URL for this ${spec.noun}`, {
+                code: 'ENOPREVIEW',
+                exitCode: 1,
+            });
+        }
+        (0, output_1.printResult)({ id, editorUrl, publicUrl });
+        if ((0, runtime_1.isInteractive)() && !(0, runtime_1.isJsonMode)()) {
+            await (0, open_1.default)(target);
+            (0, output_1.printStatus)('Opening in browser...', 'success');
+        }
+    }));
+}
+function addDeleteCommand(parent, spec) {
+    parent
+        .command('delete <id>')
+        .description(`Delete a ${spec.noun}`)
+        .option('-y, --yes', 'Skip the confirmation prompt (required without a TTY)')
+        .action((0, runtime_1.command)(async (id, options) => {
+        await (0, args_1.confirmOrRequireYes)(options.yes, `Delete ${spec.noun} ${id}?`);
+        const ctx = await (0, context_1.resolveContentContext)();
+        await ctx.client.request('DELETE', resourcePath(ctx, spec, id));
+        (0, output_1.printResult)({ id, deleted: true });
+    }));
+}
+/** list + get + open + delete. */
+function addCrudCommands(parent, spec) {
+    addListCommand(parent, spec);
+    addGetCommand(parent, spec);
+    addOpenCommand(parent, spec);
+    addDeleteCommand(parent, spec);
+}
+function addWaitOptions(cmd, defaultTimeoutSeconds = runs_1.DEFAULT_WAIT_TIMEOUT_SECONDS) {
+    return cmd
+        .option('-w, --wait', 'Wait until the work finishes and print the result')
+        .option('--timeout <seconds>', 'Give up waiting after this many seconds', String(defaultTimeoutSeconds));
+}
+function parseTimeout(options) {
+    return (0, args_1.parseNonNegativeNumber)(options.timeout, '--timeout') ?? runs_1.DEFAULT_WAIT_TIMEOUT_SECONDS;
+}
+/** `<resource> generate [prompt]` (alias `create`): POST …/generate → 202 run. */
+function addGenerateCommand(parent, spec) {
+    const cmd = parent
+        .command('generate')
+        .alias('create')
+        .description(spec.description)
+        .argument('[prompt]', spec.promptLabel);
+    spec.configure(cmd);
+    addWaitOptions(cmd).option('--idempotency-key <key>', 'Idempotency key for safe retries');
+    cmd.action((0, runtime_1.command)(async (prompt, options) => {
+        const text = await (0, args_1.valueOrPrompt)(prompt, `${spec.promptLabel}:`, `Pass a prompt argument: ${spec.example}`);
+        const body = (0, args_1.compact)(spec.buildBody(text, options));
+        const timeoutSeconds = parseTimeout(options);
+        const ctx = await (0, context_1.resolveContentContext)();
+        const accepted = await ctx.client.request('POST', resourcePath(ctx, spec, undefined, '/generate'), body, (0, args_1.idempotencyHeaders)(options.idempotencyKey));
+        if (!options.wait) {
+            (0, output_1.printResult)(accepted);
+            (0, output_1.printStatus)(`Follow it with: tutorflow run wait ${accepted.runId}`);
+            return;
+        }
+        await printFinishedRun(ctx, await (0, runs_1.waitForRun)(ctx, accepted.runId, timeoutSeconds));
+    }));
+}
+async function printFinishedRun(ctx, run) {
+    // The run is done and paid for; a failed follow-up read must not hide it.
+    let resource;
+    try {
+        resource = (await (0, runs_1.fetchRunResource)(ctx, run));
+    }
+    catch (error) {
+        (0, runtime_1.printProgress)(`Run ${run.runId} completed, but reading ${run.resourceId ?? 'its resource'} failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if ((0, runtime_1.isJsonMode)()) {
+        (0, output_1.printResult)({ run, resource: resource ?? null });
+        return;
+    }
+    (0, output_1.printResult)({
+        runId: run.runId,
+        status: run.status,
+        creditsCharged: run.creditsCharged,
+        resourceId: run.resourceId,
+        title: resource?.title,
+        editorUrl: resource?.editorUrl,
+        publicUrl: resource?.publicUrl,
+    });
+}
+//# sourceMappingURL=resource.js.map

package/dist/content/resource.js.map

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

package/dist/content/runs.d.ts

@@ -0,0 +1,51 @@
+import { type ContentContext } from './context';
+export declare const DEFAULT_WAIT_TIMEOUT_SECONDS = 900;
+export declare const DEFAULT_RENDER_TIMEOUT_SECONDS = 1800;
+export type RunState = 'queued' | 'running' | 'completed' | 'failed';
+export type RunKind = 'course' | 'slide' | 'test' | 'module';
+export interface GenerationRun {
+    runId: string;
+    kind?: RunKind;
+    status: RunState;
+    stage?: string | null;
+    progress?: RunProgress | null;
+    resourceId?: string | null;
+    error?: string | null;
+    [key: string]: unknown;
+}
+export interface RunProgress {
+    completed: number;
+    total: number;
+    unit: string;
+}
+/** Path segment of the resource a generation run of each kind produces. */
+export declare const RUN_KIND_PATHS: Record<RunKind, string>;
+interface ResourceRunStep {
+    runId: string;
+    phase: string;
+    stage?: string | null;
+    status?: 'done' | 'failed';
+    message?: string;
+    [key: string]: unknown;
+}
+export interface ResourceRunStatus {
+    active: ResourceRunStep | null;
+    last: ResourceRunStep | null;
+}
+export interface RenderStatus {
+    renderStatus: 'IDLE' | 'RENDERING' | 'COMPLETED' | 'FAILED';
+    renderError?: string | null;
+    progress?: number | null;
+    [key: string]: unknown;
+}
+export declare function waitForRun(ctx: ContentContext, runId: string, timeoutSeconds: number): Promise<GenerationRun>;
+/** Fetch what a completed run produced, or undefined when it names nothing. */
+export declare function fetchRunResource(ctx: ContentContext, run: GenerationRun): Promise<unknown | undefined>;
+/**
+ * Wait for a game or simulation brief/build/revise. The resource run route
+ * reports an `active` step while one runs and the `last` finished one after.
+ */
+export declare function waitForResourceRun(ctx: ContentContext, resourcePath: string, id: string, runId: string | undefined, timeoutSeconds: number): Promise<ResourceRunStatus>;
+export declare function waitForRender(ctx: ContentContext, videoId: string, timeoutSeconds: number): Promise<RenderStatus>;
+export {};
+//# sourceMappingURL=runs.d.ts.map

package/dist/content/runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.d.ts","sourceRoot":"","sources":["../../src/content/runs.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,WAAW,CAAC;AAWxE,eAAO,MAAM,4BAA4B,MAAM,CAAC;AAChD,eAAO,MAAM,8BAA8B,OAAQ,CAAC;AAEpD,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AACrE,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,QAAQ,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,2EAA2E;AAC3E,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAKlD,CAAC;AAEF,UAAU,eAAe;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/B,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC5D,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAuDD,wBAAsB,UAAU,CAC9B,GAAG,EAAE,cAAc,EACnB,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,aAAa,CAAC,CA4BxB;AAaD,+EAA+E;AAC/E,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,aAAa,GACjB,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAM9B;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,cAAc,EACnB,YAAY,EAAE,MAAM,EACpB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAkC5B;AAMD,wBAAsB,aAAa,CACjC,GAAG,EAAE,cAAc,EACnB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,YAAY,CAAC,CA2CvB"}