@copado/agentia-cli 0.42.0-alpha.0 → 0.45.0-alpha.0

package/dist/lib/ai-operations.js

@@ -0,0 +1,177 @@
+import { v4 as uuidv4 } from 'uuid';
+import { normalizeAiDialogueId, normalizeAiWorkspaceId, resolveAiCredentials } from './ai-config.js';
+import { AiGateway, AiGatewayError } from './ai-gateway.js';
+import { assistantIdForAgent, buildDialogueName, enrichAiPrompt, validateAiContext, } from './ai-types.js';
+function trimOptional(value) {
+    if (value === undefined)
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length === 0 ? undefined : trimmed;
+}
+function validatePrompt(prompt) {
+    const trimmed = prompt.trim();
+    if (trimmed.length === 0) {
+        throw new Error('AI prompt cannot be empty.');
+    }
+    return prompt;
+}
+function chunkContent(chunk) {
+    return typeof chunk.content === 'string' ? chunk.content : undefined;
+}
+function normalizeFollowup(value) {
+    if (typeof value === 'string' && value.trim().length > 0)
+        return { content: value };
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return undefined;
+    const record = value;
+    for (const candidate of [record.content, record.question, record.text]) {
+        if (typeof candidate === 'string' && candidate.trim().length > 0)
+            return { content: candidate };
+    }
+    return undefined;
+}
+function normalizeLink(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return undefined;
+    const record = value;
+    const link = {};
+    if (typeof record.summary === 'string')
+        link.summary = record.summary;
+    if (typeof record.title === 'string')
+        link.title = record.title;
+    if (typeof record.url === 'string')
+        link.url = record.url;
+    return Object.keys(link).length === 0 ? undefined : link;
+}
+function createStreamSummary() {
+    return {
+        completed: false,
+        content: '',
+        followups: [],
+        links: [],
+        statuses: [],
+        warnings: [],
+    };
+}
+function isCompletionChunk(type) {
+    return type === 'done' || type === 'performance' || type === 'stream_complete';
+}
+function applyMetadataChunk(summary, chunk) {
+    if (chunk.type === 'followup') {
+        const followup = normalizeFollowup(chunk.content);
+        if (followup !== undefined)
+            summary.followups.push(followup);
+        return true;
+    }
+    if (chunk.type === 'link') {
+        const link = normalizeLink(chunk.content);
+        if (link !== undefined)
+            summary.links.push(link);
+        return true;
+    }
+    return chunk.type === 'heartbeat';
+}
+function applyStreamChunk(summary, chunk, callbacks) {
+    const content = chunkContent(chunk);
+    if (isCompletionChunk(chunk.type)) {
+        summary.completed = true;
+        return;
+    }
+    if (applyMetadataChunk(summary, chunk))
+        return;
+    if (chunk.type === 'error')
+        throw new AiGatewayError(content ?? 'AI stream returned an error.');
+    if (chunk.type === 'request_id' && content !== undefined) {
+        summary.gatewayRequestId = content;
+        return;
+    }
+    if (chunk.type === 'status' && content !== undefined) {
+        summary.statuses.push(content);
+        callbacks.onStatus?.(content);
+        return;
+    }
+    if (chunk.type === 'thinking' && content !== undefined) {
+        callbacks.onStatus?.(content);
+        return;
+    }
+    if (chunk.type === 'token' && content !== undefined) {
+        summary.content += content;
+        callbacks.onToken?.(content);
+        return;
+    }
+    if (chunk.type === 'warning' && content !== undefined) {
+        summary.warnings.push(content);
+        callbacks.onWarning?.(content);
+    }
+}
+export async function bootstrapAiDialogue(options) {
+    const assistantId = assistantIdForAgent(options.agent);
+    const dialogueId = trimOptional(options.dialogue);
+    if (dialogueId !== undefined) {
+        const dialogue = await AiGateway.getDialogue(normalizeAiDialogueId(dialogueId), options);
+        return { assistantId, dialogue };
+    }
+    const credentials = resolveAiCredentials(options);
+    let workspace;
+    if (options.workspace !== undefined) {
+        workspace = { id: normalizeAiWorkspaceId(options.workspace) };
+    }
+    else if (credentials.workspaceId === undefined) {
+        workspace = await AiGateway.createWorkspace(options);
+    }
+    else {
+        workspace = { id: credentials.workspaceId };
+    }
+    const dialogue = await AiGateway.createDialogue({
+        assistantId,
+        name: buildDialogueName(options.kind, options.agent),
+        workspaceId: workspace.id,
+    }, options);
+    return { assistantId, dialogue, workspace };
+}
+export async function runAiAsk(options, callbacks = {}) {
+    validateAiContext({
+        component: options.component,
+        sfOrg: options.sfOrg,
+        userStory: options.userStory,
+        workItem: options.workItem,
+    });
+    const prompt = enrichAiPrompt(validatePrompt(options.prompt), {
+        component: trimOptional(options.component),
+        sfOrg: trimOptional(options.sfOrg),
+        userStory: trimOptional(options.userStory),
+        workItem: trimOptional(options.workItem),
+    });
+    const bootstrap = await bootstrapAiDialogue({
+        ...options,
+        kind: 'ask',
+    });
+    const requestId = uuidv4();
+    const summary = createStreamSummary();
+    await AiGateway.sendMessage(bootstrap.dialogue.id, {
+        assistantId: bootstrap.assistantId,
+        'dev_context': null,
+        integrations: null,
+        prompt,
+        'request_id': requestId,
+        'system_prompt': null,
+    }, options, (chunk) => applyStreamChunk(summary, chunk, callbacks));
+    if (!summary.completed) {
+        throw new AiGatewayError('AI stream ended before stream_complete. Response may be incomplete.');
+    }
+    return {
+        agent: options.agent,
+        assistantId: bootstrap.assistantId,
+        completed: summary.completed,
+        content: summary.content,
+        dialogueId: bootstrap.dialogue.id,
+        followups: summary.followups,
+        gatewayRequestId: summary.gatewayRequestId,
+        links: summary.links,
+        requestId,
+        statuses: summary.statuses,
+        warnings: summary.warnings,
+        workspaceId: bootstrap.workspace?.id ?? bootstrap.dialogue.workspaceId ?? bootstrap.dialogue.workspace_id ?? undefined,
+    };
+}
+//# sourceMappingURL=ai-operations.js.map

package/dist/lib/ai-operations.js.map

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

package/dist/lib/ai-stream-parser.d.ts

@@ -0,0 +1,12 @@
+import type { AiStreamChunk } from './ai-types.js';
+export declare class AiStreamProtocolError extends Error {
+    constructor(message: string);
+}
+export declare class AiStreamParser {
+    private buffer;
+    private readonly decoder;
+    finish(): AiStreamChunk[];
+    push(chunk: Buffer | string): AiStreamChunk[];
+    private drainCompleteLines;
+    private parseLine;
+}

package/dist/lib/ai-stream-parser.js

@@ -0,0 +1,59 @@
+import { StringDecoder } from 'node:string_decoder';
+export class AiStreamProtocolError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'AiStreamProtocolError';
+    }
+}
+export class AiStreamParser {
+    buffer = '';
+    decoder = new StringDecoder('utf8');
+    finish() {
+        this.buffer += this.decoder.end();
+        const chunks = [];
+        const trailing = this.buffer.trim();
+        this.buffer = '';
+        if (trailing.length > 0) {
+            chunks.push(this.parseLine(trailing));
+        }
+        return chunks;
+    }
+    push(chunk) {
+        this.buffer += typeof chunk === 'string' ? chunk : this.decoder.write(chunk);
+        return this.drainCompleteLines();
+    }
+    drainCompleteLines() {
+        const chunks = [];
+        while (true) {
+            const newlineIndex = this.buffer.search(/\r?\n/u);
+            if (newlineIndex === -1)
+                break;
+            const rawLine = this.buffer.slice(0, newlineIndex);
+            const newlineLength = this.buffer[newlineIndex] === '\r' && this.buffer[newlineIndex + 1] === '\n' ? 2 : 1;
+            this.buffer = this.buffer.slice(newlineIndex + newlineLength);
+            const line = rawLine.trim();
+            if (line.length > 0) {
+                chunks.push(this.parseLine(line));
+            }
+        }
+        return chunks;
+    }
+    parseLine(line) {
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            throw new AiStreamProtocolError(`AI stream returned malformed NDJSON: ${line}`);
+        }
+        if (parsed === null || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            throw new AiStreamProtocolError('AI stream returned a non-object NDJSON record.');
+        }
+        const { type } = parsed;
+        if (typeof type !== 'string' || type.trim().length === 0) {
+            throw new AiStreamProtocolError('AI stream record did not include a type.');
+        }
+        return parsed;
+    }
+}
+//# sourceMappingURL=ai-stream-parser.js.map

package/dist/lib/ai-stream-parser.js.map

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

package/dist/lib/ai-types.d.ts

@@ -0,0 +1,80 @@
+export declare const AI_ASK_AGENTS: readonly ["plan", "build", "test", "release", "operate"];
+export declare const AI_CHAT_AGENTS: readonly ["plan", "build", "test", "release", "operate", "orchestrate"];
+export type AiAskAgent = (typeof AI_ASK_AGENTS)[number];
+export type AiChatAgent = (typeof AI_CHAT_AGENTS)[number];
+export type AiAgent = AiAskAgent | AiChatAgent;
+export type AiAssistantId = 'build' | 'generalist' | 'operate' | 'plan' | 'release' | 'test';
+export type AiContextOptions = {
+    component?: string;
+    sfOrg?: string;
+    userStory?: string;
+    workItem?: string;
+};
+export type AiWorkspace = {
+    [key: string]: unknown;
+    id: string;
+    name?: string;
+};
+export type AiDialogue = {
+    [key: string]: unknown;
+    assistantId?: AiAssistantId;
+    id: string;
+    name?: string;
+    workspace_id?: null | string;
+    workspaceId?: null | string;
+};
+export type AiMessageCreate = {
+    assistantId: AiAssistantId;
+    dev_context?: null | Record<string, unknown>;
+    integrations?: null | Record<string, unknown>;
+    prompt: string;
+    request_id: string;
+    system_prompt?: null | string;
+};
+export type AiFollowup = {
+    content: string;
+};
+export type AiLink = {
+    summary?: string;
+    title?: string;
+    url?: string;
+};
+export type AiAskResult = {
+    agent: AiAgent;
+    assistantId: AiAssistantId;
+    completed: boolean;
+    content: string;
+    dialogueId: string;
+    followups: AiFollowup[];
+    gatewayRequestId?: string;
+    links: AiLink[];
+    requestId: string;
+    statuses: string[];
+    warnings: string[];
+    workspaceId?: string;
+};
+export type AiStreamChunk = {
+    [key: string]: unknown;
+    content?: unknown;
+    type: string;
+};
+export type AiStreamSummary = {
+    completed: boolean;
+    content: string;
+    followups: AiFollowup[];
+    gatewayRequestId?: string;
+    links: AiLink[];
+    statuses: string[];
+    warnings: string[];
+};
+export declare function assistantIdForAgent(agent: AiAgent): AiAssistantId;
+export declare function workspacesEndpoint(): string;
+export declare function workspaceEndpoint(workspaceId: string): string;
+export declare function dialoguesEndpoint(): string;
+export declare function dialogueEndpoint(dialogueId: string): string;
+export declare function dialogueMessagesEndpoint(dialogueId: string): string;
+export declare function buildDialogueName(kind: 'ask' | 'chat', agent: AiAgent): string;
+export declare function enrichAiPrompt(prompt: string, context?: AiContextOptions): string;
+export declare function normalizeAiWorkspace(value: unknown): AiWorkspace;
+export declare function normalizeAiDialogue(value: unknown): AiDialogue;
+export declare function validateAiContext(context: AiContextOptions): void;

package/dist/lib/ai-types.js

@@ -0,0 +1,66 @@
+import { normalizeAiDialogueId, normalizeAiWorkspaceId } from './ai-config.js';
+export const AI_ASK_AGENTS = ['plan', 'build', 'test', 'release', 'operate'];
+export const AI_CHAT_AGENTS = [...AI_ASK_AGENTS, 'orchestrate'];
+export function assistantIdForAgent(agent) {
+    return agent === 'orchestrate' ? 'generalist' : agent;
+}
+export function workspacesEndpoint() {
+    return '/workspaces';
+}
+export function workspaceEndpoint(workspaceId) {
+    return `/workspaces/${normalizeAiWorkspaceId(workspaceId)}`;
+}
+export function dialoguesEndpoint() {
+    return '/dialogues';
+}
+export function dialogueEndpoint(dialogueId) {
+    return `/dialogues/${normalizeAiDialogueId(dialogueId)}`;
+}
+export function dialogueMessagesEndpoint(dialogueId) {
+    return `/dialogues/${normalizeAiDialogueId(dialogueId)}/messages`;
+}
+export function buildDialogueName(kind, agent) {
+    return `cli-${kind}-${agent}`;
+}
+export function enrichAiPrompt(prompt, context = {}) {
+    const lines = [];
+    if (context.userStory !== undefined)
+        lines.push(`- User story: ${context.userStory}`);
+    if (context.sfOrg !== undefined)
+        lines.push(`- Salesforce environment: ${context.sfOrg}`);
+    if (context.component !== undefined)
+        lines.push(`- Component: ${context.component}`);
+    if (context.workItem !== undefined)
+        lines.push(`- Work item: ${context.workItem}`);
+    if (lines.length === 0)
+        return prompt;
+    return `${prompt}\n\n---\nContext:\n${lines.join('\n')}`;
+}
+export function normalizeAiWorkspace(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('AI workspace response was not an object.');
+    }
+    const workspace = value;
+    if (typeof workspace.id !== 'string' || workspace.id.trim().length === 0) {
+        throw new Error('AI workspace response did not include an id.');
+    }
+    return { ...value, id: workspace.id.trim() };
+}
+export function normalizeAiDialogue(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('AI dialogue response was not an object.');
+    }
+    const dialogue = value;
+    if (typeof dialogue.id !== 'string' || dialogue.id.trim().length === 0) {
+        throw new Error('AI dialogue response did not include an id.');
+    }
+    return { ...value, id: dialogue.id.trim() };
+}
+export function validateAiContext(context) {
+    for (const [label, value] of Object.entries(context)) {
+        if (typeof value === 'string' && value.trim().length === 0) {
+            throw new Error(`${label} value cannot be empty.`);
+        }
+    }
+}
+//# sourceMappingURL=ai-types.js.map

package/dist/lib/ai-types.js.map

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

package/dist/lib/auth-config.d.ts

@@ -1,6 +1,12 @@
 import { type CredentialType } from './credential-store.js';
 export declare const COPADO_ACCOUNT_SUMMARY_LOGIN_URL = "https://login.salesforce.com/?startURL=%2Flightning%2Fn%2Fcopado__Account_Summary";
 export type AuthSetResult = {
+    ai?: {
+        domain?: string;
+        gatewayUrl?: string;
+        orgId?: number;
+        workspaceId?: string;
+    };
     baseUrl?: string;
     crt?: {
         domain?: string;
@@ -20,6 +26,11 @@ export type AuthUnsetResult = {
     removed: AuthUnsetCredentialResult[];
 };
 export type ApplyAuthSetInput = {
+    ai?: string;
+    aiDomain?: string;
+    aiGatewayUrl?: string;
+    aiOrg?: number;
+    aiWorkspace?: string;
     cicd?: string;
     crt?: string;
     crtDomain?: string;
@@ -39,6 +50,14 @@ export type CrtAuthStatus = {
     orgId?: null | string;
     set: boolean;
 };
+export type AiAuthStatus = {
+    domain?: null | string;
+    gatewayUrl?: null | string;
+    masked?: string;
+    orgId?: null | string;
+    set: boolean;
+    workspaceId?: null | string;
+};
 export declare class AuthSetError extends Error {
     readonly exitCode: number;
     constructor(message: string, exitCode?: number);
@@ -47,8 +66,10 @@ export declare function formatTerminalHyperlink(label: string, url: string): str
 export declare function formatCicdApiKeyHelp(): string;
 export declare function getCicdAuthStatus(): CicdAuthStatus;
 export declare function getCrtAuthStatus(): CrtAuthStatus;
+export declare function getAiAuthStatus(): AiAuthStatus;
 export declare function isCicdConfigured(): boolean;
 export declare function resolveAuthUnsetTypes(options: {
+    ai?: boolean;
     cicd?: boolean;
     crt?: boolean;
 }): CredentialType[];