@respan/cli 0.2.0

package/dist/commands/prompts/create-version.js

@@ -0,0 +1,44 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../lib/base-command.js';
+class PromptsCreateVersion extends BaseCommand {
+    async run() {
+        const { args, flags } = await this.parse(PromptsCreateVersion);
+        this.globalFlags = flags;
+        try {
+            const client = this.getClient();
+            let messages;
+            try {
+                messages = JSON.parse(flags.messages);
+            }
+            catch {
+                this.error('Invalid JSON for --messages');
+            }
+            // createVersion requires prompt_id, messages (string[]), and model (required)
+            const messagesStr = Array.isArray(messages) ? messages.map((m) => typeof m === 'string' ? m : JSON.stringify(m)) : [String(messages)];
+            const createBody = {
+                prompt_id: args['prompt-id'],
+                messages: messagesStr,
+                model: flags.model || 'gpt-4o',
+            };
+            if (flags.temperature)
+                createBody.temperature = parseFloat(flags.temperature);
+            if (flags['max-tokens'])
+                createBody.max_tokens = flags['max-tokens'];
+            const data = await this.spin('Creating prompt version', () => client.prompts.createVersion(createBody));
+            this.log(JSON.stringify(data, null, 2));
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+}
+PromptsCreateVersion.description = 'Create a new version of a prompt';
+PromptsCreateVersion.args = { 'prompt-id': Args.string({ description: 'Prompt ID', required: true }) };
+PromptsCreateVersion.flags = {
+    ...BaseCommand.baseFlags,
+    messages: Flags.string({ description: 'Messages as JSON array string', required: true }),
+    model: Flags.string({ description: 'Model name' }),
+    temperature: Flags.string({ description: 'Temperature value' }),
+    'max-tokens': Flags.integer({ description: 'Max tokens' }),
+};
+export default PromptsCreateVersion;

package/dist/commands/prompts/create.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../../lib/base-command.js';
+export default class PromptsCreate extends BaseCommand {
+    static description: string;
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/prompts/create.js

@@ -0,0 +1,26 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../lib/base-command.js';
+class PromptsCreate extends BaseCommand {
+    async run() {
+        const { flags } = await this.parse(PromptsCreate);
+        this.globalFlags = flags;
+        try {
+            const client = this.getClient();
+            const body = { name: flags.name };
+            if (flags.description)
+                body.description = flags.description;
+            const data = await this.spin('Creating prompt', () => client.prompts.createPrompt(body));
+            this.log(JSON.stringify(data, null, 2));
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+}
+PromptsCreate.description = 'Create a new prompt';
+PromptsCreate.flags = {
+    ...BaseCommand.baseFlags,
+    name: Flags.string({ description: 'Prompt name', required: true }),
+    description: Flags.string({ description: 'Prompt description' }),
+};
+export default PromptsCreate;

package/dist/commands/prompts/get.d.ts

@@ -0,0 +1,15 @@
+import { BaseCommand } from '../../lib/base-command.js';
+export default class PromptsGet extends BaseCommand {
+    static description: string;
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/prompts/get.js

@@ -0,0 +1,20 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../lib/base-command.js';
+class PromptsGet extends BaseCommand {
+    async run() {
+        const { args, flags } = await this.parse(PromptsGet);
+        this.globalFlags = flags;
+        try {
+            const client = this.getClient();
+            const data = await this.spin('Fetching prompt', () => client.prompts.retrievePrompts({ prompt_id: args.id }));
+            this.log(JSON.stringify(data, null, 2));
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+}
+PromptsGet.description = 'Get a specific prompt';
+PromptsGet.args = { id: Args.string({ description: 'Prompt ID', required: true }) };
+PromptsGet.flags = { ...BaseCommand.baseFlags };
+export default PromptsGet;

package/dist/commands/prompts/list.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../lib/base-command.js';
+export default class PromptsList extends BaseCommand {
+    static description: string;
+    static flags: {
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/prompts/list.js

@@ -0,0 +1,22 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../lib/base-command.js';
+class PromptsList extends BaseCommand {
+    async run() {
+        const { flags } = await this.parse(PromptsList);
+        this.globalFlags = flags;
+        try {
+            const client = this.getClient();
+            const data = await this.spin('Fetching prompts', () => client.prompts.retrievePrompts());
+            this.outputResult(data, ['id', 'name', 'description', 'is_active', 'current_version', 'updated_at']);
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+}
+PromptsList.description = 'List prompts';
+PromptsList.flags = {
+    ...BaseCommand.baseFlags,
+    limit: Flags.integer({ description: 'Number of results per page', default: 50 }),
+};
+export default PromptsList;

package/dist/commands/prompts/update.d.ts

@@ -0,0 +1,17 @@
+import { BaseCommand } from '../../lib/base-command.js';
+export default class PromptsUpdate extends BaseCommand {
+    static description: string;
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/prompts/update.js

@@ -0,0 +1,32 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../lib/base-command.js';
+class PromptsUpdate extends BaseCommand {
+    async run() {
+        const { args, flags } = await this.parse(PromptsUpdate);
+        this.globalFlags = flags;
+        try {
+            const client = this.getClient();
+            const updateBody = {};
+            if (flags.name)
+                updateBody.name = flags.name;
+            if (flags.description)
+                updateBody.description = flags.description;
+            const data = await this.spin('Updating prompt', () => client.prompts.updatePrompt({
+                prompt_id: args.id,
+                body: updateBody,
+            }));
+            this.log(JSON.stringify(data, null, 2));
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+}
+PromptsUpdate.description = 'Update a prompt';
+PromptsUpdate.args = { id: Args.string({ description: 'Prompt ID', required: true }) };
+PromptsUpdate.flags = {
+    ...BaseCommand.baseFlags,
+    name: Flags.string({ description: 'Prompt name' }),
+    description: Flags.string({ description: 'Prompt description' }),
+};
+export default PromptsUpdate;

package/dist/commands/prompts/versions.d.ts

@@ -0,0 +1,15 @@
+import { BaseCommand } from '../../lib/base-command.js';
+export default class PromptsVersions extends BaseCommand {
+    static description: string;
+    static args: {
+        'prompt-id': import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/prompts/versions.js

@@ -0,0 +1,20 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../lib/base-command.js';
+class PromptsVersions extends BaseCommand {
+    async run() {
+        const { args, flags } = await this.parse(PromptsVersions);
+        this.globalFlags = flags;
+        try {
+            const client = this.getClient();
+            const data = await this.spin('Fetching prompt versions', () => client.prompts.retrieveVersions({ prompt_id: args['prompt-id'] }));
+            this.outputResult(data, ['id', 'version', 'is_active', 'created_at']);
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+}
+PromptsVersions.description = 'List versions of a prompt';
+PromptsVersions.args = { 'prompt-id': Args.string({ description: 'Prompt ID', required: true }) };
+PromptsVersions.flags = { ...BaseCommand.baseFlags };
+export default PromptsVersions;

package/dist/commands/traces/get.d.ts

@@ -0,0 +1,15 @@
+import { BaseCommand } from '../../lib/base-command.js';
+export default class TracesGet extends BaseCommand {
+    static description: string;
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/traces/get.js

@@ -0,0 +1,20 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../lib/base-command.js';
+class TracesGet extends BaseCommand {
+    async run() {
+        const { args, flags } = await this.parse(TracesGet);
+        this.globalFlags = flags;
+        try {
+            const client = this.getClient();
+            const data = await this.spin('Fetching trace', () => client.traces.retrieveTrace({ trace_unique_id: args.id }));
+            this.log(JSON.stringify(data, null, 2));
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+}
+TracesGet.description = 'Get a specific trace';
+TracesGet.args = { id: Args.string({ description: 'Trace ID', required: true }) };
+TracesGet.flags = { ...BaseCommand.baseFlags };
+export default TracesGet;

package/dist/commands/traces/list.d.ts

@@ -0,0 +1,19 @@
+import { BaseCommand } from '../../lib/base-command.js';
+export default class TracesList extends BaseCommand {
+    static description: string;
+    static flags: {
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        page: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'sort-by': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'start-time': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'end-time': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        environment: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        filter: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/traces/list.js

@@ -0,0 +1,47 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../lib/base-command.js';
+import { extractPagination, formatPaginationInfo } from '../../lib/pagination.js';
+class TracesList extends BaseCommand {
+    async run() {
+        const { flags } = await this.parse(TracesList);
+        this.globalFlags = flags;
+        try {
+            const client = this.getClient();
+            const params = {
+                page_size: flags.limit,
+                page: flags.page,
+            };
+            if (flags['sort-by'])
+                params.sort_by = flags['sort-by'];
+            if (flags['start-time'])
+                params.start_time = flags['start-time'];
+            if (flags['end-time'])
+                params.end_time = flags['end-time'];
+            if (flags.environment)
+                params.environment = flags.environment;
+            if (flags.filter && flags.filter.length > 0)
+                params.filters = flags.filter;
+            const data = await this.spin('Fetching traces', () => client.traces.list(params));
+            this.outputResult(data, [
+                'trace_unique_id', 'name', 'duration', 'span_count', 'total_cost', 'error_count', 'start_time',
+            ]);
+            const pagination = extractPagination(data, flags.page);
+            this.log(formatPaginationInfo(pagination));
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+}
+TracesList.description = 'List traces';
+TracesList.flags = {
+    ...BaseCommand.baseFlags,
+    limit: Flags.integer({ description: 'Number of results per page', default: 10 }),
+    page: Flags.integer({ description: 'Page number', default: 1 }),
+    'sort-by': Flags.string({ description: 'Sort field', default: '-timestamp' }),
+    'start-time': Flags.string({ description: 'Start time filter (ISO 8601)' }),
+    'end-time': Flags.string({ description: 'End time filter (ISO 8601)' }),
+    environment: Flags.string({ description: 'Environment filter' }),
+    filter: Flags.string({ description: 'Filter expression', multiple: true }),
+};
+export default TracesList;

package/dist/commands/traces/summary.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../../lib/base-command.js';
+export default class TracesSummary extends BaseCommand {
+    static description: string;
+    static flags: {
+        'start-time': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'end-time': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/traces/summary.js

@@ -0,0 +1,23 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../lib/base-command.js';
+class TracesSummary extends BaseCommand {
+    async run() {
+        const { flags } = await this.parse(TracesSummary);
+        this.globalFlags = flags;
+        try {
+            const client = this.getClient();
+            const data = await this.spin('Fetching traces summary', () => client.traces.retrieveTracesSummary({ start_time: flags['start-time'], end_time: flags['end-time'] }));
+            this.log(JSON.stringify(data, null, 2));
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+}
+TracesSummary.description = 'Get a summary of traces for a time range';
+TracesSummary.flags = {
+    ...BaseCommand.baseFlags,
+    'start-time': Flags.string({ description: 'Start time (ISO 8601)', required: true }),
+    'end-time': Flags.string({ description: 'End time (ISO 8601)', required: true }),
+};
+export default TracesSummary;

package/dist/commands/users/create.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../../lib/base-command.js';
+export default class UsersCreate extends BaseCommand {
+    static description: string;
+    static flags: {
+        identifier: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        email: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        metadata: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/users/create.js

@@ -0,0 +1,38 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../lib/base-command.js';
+class UsersCreate extends BaseCommand {
+    async run() {
+        const { flags } = await this.parse(UsersCreate);
+        this.globalFlags = flags;
+        try {
+            const client = this.getClient();
+            const body = { customer_identifier: flags.identifier };
+            if (flags.name)
+                body.name = flags.name;
+            if (flags.email)
+                body.email = flags.email;
+            if (flags.metadata) {
+                try {
+                    body.metadata = JSON.parse(flags.metadata);
+                }
+                catch {
+                    this.error('Invalid JSON for --metadata');
+                }
+            }
+            const data = await this.spin('Creating user', () => client.users.updateUser(body));
+            this.log(JSON.stringify(data, null, 2));
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+}
+UsersCreate.description = 'Create a new user (customer)';
+UsersCreate.flags = {
+    ...BaseCommand.baseFlags,
+    identifier: Flags.string({ description: 'Customer identifier', required: true }),
+    name: Flags.string({ description: 'Customer name' }),
+    email: Flags.string({ description: 'Customer email' }),
+    metadata: Flags.string({ description: 'Metadata as JSON string' }),
+};
+export default UsersCreate;

package/dist/commands/users/get.d.ts

@@ -0,0 +1,15 @@
+import { BaseCommand } from '../../lib/base-command.js';
+export default class UsersGet extends BaseCommand {
+    static description: string;
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/users/get.js

@@ -0,0 +1,20 @@
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../lib/base-command.js';
+class UsersGet extends BaseCommand {
+    async run() {
+        const { args, flags } = await this.parse(UsersGet);
+        this.globalFlags = flags;
+        try {
+            const client = this.getClient();
+            const data = await this.spin('Fetching user', () => client.users.retrieveUser({ customer_identifier: args.id }));
+            this.log(JSON.stringify(data, null, 2));
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+}
+UsersGet.description = 'Get a specific user (customer)';
+UsersGet.args = { id: Args.string({ description: 'Customer identifier', required: true }) };
+UsersGet.flags = { ...BaseCommand.baseFlags };
+export default UsersGet;

package/dist/commands/users/list.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../../lib/base-command.js';
+export default class UsersList extends BaseCommand {
+    static description: string;
+    static flags: {
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        page: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        'sort-by': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        environment: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/users/list.js

@@ -0,0 +1,38 @@
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../lib/base-command.js';
+import { extractPagination, formatPaginationInfo } from '../../lib/pagination.js';
+class UsersList extends BaseCommand {
+    async run() {
+        const { flags } = await this.parse(UsersList);
+        this.globalFlags = flags;
+        try {
+            const client = this.getClient();
+            const params = {
+                page_size: flags.limit,
+                page: flags.page,
+            };
+            if (flags['sort-by'])
+                params.sort_by = flags['sort-by'];
+            if (flags.environment)
+                params.environment = flags.environment;
+            const data = await this.spin('Fetching users', () => client.users.list(params));
+            this.outputResult(data, [
+                'customer_identifier', 'name', 'email', 'number_of_requests', 'total_cost', 'last_active_timeframe',
+            ]);
+            const pagination = extractPagination(data, flags.page);
+            this.log(formatPaginationInfo(pagination));
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+}
+UsersList.description = 'List users (customers)';
+UsersList.flags = {
+    ...BaseCommand.baseFlags,
+    limit: Flags.integer({ description: 'Number of results per page', default: 20 }),
+    page: Flags.integer({ description: 'Page number', default: 1 }),
+    'sort-by': Flags.string({ description: 'Sort field' }),
+    environment: Flags.string({ description: 'Environment filter' }),
+};
+export default UsersList;

package/dist/commands/users/update.d.ts

@@ -0,0 +1,18 @@
+import { BaseCommand } from '../../lib/base-command.js';
+export default class UsersUpdate extends BaseCommand {
+    static description: string;
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        name: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        email: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        metadata: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/users/update.js

@@ -0,0 +1,38 @@
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../lib/base-command.js';
+class UsersUpdate extends BaseCommand {
+    async run() {
+        const { args, flags } = await this.parse(UsersUpdate);
+        this.globalFlags = flags;
+        try {
+            const client = this.getClient();
+            const body = { customer_identifier: args.id };
+            if (flags.name)
+                body.name = flags.name;
+            if (flags.email)
+                body.email = flags.email;
+            if (flags.metadata) {
+                try {
+                    body.metadata = JSON.parse(flags.metadata);
+                }
+                catch {
+                    this.error('Invalid JSON for --metadata');
+                }
+            }
+            const data = await this.spin('Updating user', () => client.users.updateUser(body));
+            this.log(JSON.stringify(data, null, 2));
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+}
+UsersUpdate.description = 'Update a user (customer)';
+UsersUpdate.args = { id: Args.string({ description: 'Customer identifier', required: true }) };
+UsersUpdate.flags = {
+    ...BaseCommand.baseFlags,
+    name: Flags.string({ description: 'Customer name' }),
+    email: Flags.string({ description: 'Customer email' }),
+    metadata: Flags.string({ description: 'Metadata as JSON string' }),
+};
+export default UsersUpdate;

package/dist/commands/whoami.d.ts

@@ -0,0 +1,12 @@
+import { BaseCommand } from '../lib/base-command.js';
+export default class Whoami extends BaseCommand {
+    static description: string;
+    static flags: {
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        csv: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}