@copado/agentia-cli 0.43.0-alpha.0 → 0.46.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(undefined, 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-terminal-renderer.d.ts

@@ -0,0 +1,17 @@
+export type AiTerminalRenderOptions = {
+    colors?: boolean;
+};
+export type AiTerminalMessageKind = 'status' | 'warning';
+export declare function streamSupportsColor(stream: NodeJS.WritableStream): boolean;
+export declare function formatAiTerminalMessage(message: string, kind: AiTerminalMessageKind, options?: AiTerminalRenderOptions): string;
+export declare function renderMarkdownLine(line: string, options?: AiTerminalRenderOptions): string;
+export declare function renderMarkdown(text: string, options?: AiTerminalRenderOptions): string;
+export declare class StreamingMarkdownRenderer {
+    private readonly options;
+    private buffer;
+    private wrote;
+    constructor(options?: AiTerminalRenderOptions);
+    finish(stream: NodeJS.WritableStream): void;
+    write(stream: NodeJS.WritableStream, token: string): void;
+    wroteOutput(): boolean;
+}

package/dist/lib/ai-terminal-renderer.js

@@ -0,0 +1,83 @@
+const ANSI = {
+    bold: '\u001B[1m',
+    cyan: '\u001B[36m',
+    dim: '\u001B[2m',
+    reset: '\u001B[0m',
+    yellow: '\u001B[33m',
+};
+function style(value, code, options) {
+    return options.colors === true ? `${code}${value}${ANSI.reset}` : value;
+}
+function inlineMarkdown(value, options) {
+    return value
+        .replaceAll(/`([^`]+)`/gu, (_match, content) => style(content, ANSI.yellow, options))
+        .replaceAll(/\*\*([^*]+)\*\*/gu, (_match, content) => style(content, ANSI.bold, options));
+}
+function renderFence(line, options) {
+    const language = line.replace(/^```/u, '').trim();
+    const label = language.length > 0 ? `code: ${language}` : 'code';
+    return style(`--- ${label} ---`, ANSI.dim, options);
+}
+export function streamSupportsColor(stream) {
+    return Boolean(stream.isTTY && process.env.NO_COLOR === undefined);
+}
+export function formatAiTerminalMessage(message, kind, options = {}) {
+    const trimmed = message.trim();
+    if (kind === 'warning')
+        return `${style('!', ANSI.yellow, options)} ${style(trimmed, ANSI.yellow, options)}`;
+    return `${style('>', ANSI.cyan, options)} ${style(trimmed, ANSI.dim, options)}`;
+}
+export function renderMarkdownLine(line, options = {}) {
+    const trimmed = line.trim();
+    if (trimmed.length === 0)
+        return '';
+    if (trimmed.startsWith('```'))
+        return renderFence(trimmed, options);
+    if (/^---+$/u.test(trimmed))
+        return style('────────────────────────────────────────', ANSI.dim, options);
+    const heading = /^(#{1,6})\s+(.+)$/u.exec(trimmed);
+    if (heading !== null) {
+        const level = heading[1].length;
+        const marker = level <= 2 ? '◆' : '◇';
+        return style(`${marker} ${inlineMarkdown(heading[2], options)}`, level <= 2 ? ANSI.bold : ANSI.cyan, options);
+    }
+    const bullet = /^[-*]\s+(.+)$/u.exec(trimmed);
+    if (bullet !== null)
+        return `  • ${inlineMarkdown(bullet[1], options)}`;
+    const numbered = /^(\d+\.)\s+(.+)$/u.exec(trimmed);
+    if (numbered !== null)
+        return `  ${style(numbered[1], ANSI.cyan, options)} ${inlineMarkdown(numbered[2], options)}`;
+    return inlineMarkdown(line, options);
+}
+export function renderMarkdown(text, options = {}) {
+    const lines = text.split('\n').map((line) => renderMarkdownLine(line, options));
+    return lines.join('\n');
+}
+export class StreamingMarkdownRenderer {
+    options;
+    buffer = '';
+    wrote = false;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    finish(stream) {
+        if (this.buffer.length > 0) {
+            stream.write(`${renderMarkdownLine(this.buffer, this.options)}\n`);
+            this.buffer = '';
+            this.wrote = true;
+        }
+    }
+    write(stream, token) {
+        this.buffer += token;
+        const lines = this.buffer.split('\n');
+        this.buffer = lines.pop() ?? '';
+        for (const line of lines) {
+            stream.write(`${renderMarkdownLine(line, this.options)}\n`);
+            this.wrote = true;
+        }
+    }
+    wroteOutput() {
+        return this.wrote || this.buffer.length > 0;
+    }
+}
+//# sourceMappingURL=ai-terminal-renderer.js.map

package/dist/lib/ai-terminal-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-terminal-renderer.js","sourceRoot":"","sources":["../../src/lib/ai-terminal-renderer.ts"],"names":[],"mappings":"AAMA,MAAM,IAAI,GAAG;IACX,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,WAAW;IAChB,KAAK,EAAE,WAAW;IAClB,MAAM,EAAE,YAAY;CACrB,CAAA;AAED,SAAS,KAAK,CAAC,KAAa,EAAE,IAAY,EAAE,OAAgC;IAC1E,OAAO,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAA;AACzE,CAAC;AAED,SAAS,cAAc,CAAC,KAAa,EAAE,OAAgC;IACrE,OAAO,KAAK;SACT,UAAU,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,OAAe,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SAC5F,UAAU,CAAC,mBAAmB,EAAE,CAAC,MAAM,EAAE,OAAe,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;AACrG,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,OAAgC;IACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IACjD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,CAAC,CAAC,MAAM,CAAA;IAChE,OAAO,KAAK,CAAC,OAAO,KAAK,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;AACrD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAA6B;IAC/D,OAAO,OAAO,CAAE,MAA4B,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAA;AAC3F,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,OAAe,EACf,IAA2B,EAC3B,UAAmC,EAAE;IAErC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAA;IAC9B,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAA;IAC5G,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,CAAA;AACjF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,UAAmC,EAAE;IACpF,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IAE3B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IACnC,IAAI,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IACnE,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC,0CAA0C,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;IAExG,MAAM,OAAO,GAAG,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAClD,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;QAC/B,MAAM,MAAM,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;QACrC,OAAO,KAAK,CAAC,GAAG,MAAM,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAC/G,CAAC;IAED,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC7C,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,CAAA;IAEvE,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAClD,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,KAAK,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,CAAA;IAEnH,OAAO,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;AACtC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,UAAmC,EAAE;IAChF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;IAC/E,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC;AAED,MAAM,OAAO,yBAAyB;IAIA;IAH5B,MAAM,GAAG,EAAE,CAAA;IACX,KAAK,GAAG,KAAK,CAAA;IAErB,YAAoC,UAAmC,EAAE;QAArC,YAAO,GAAP,OAAO,CAA8B;IAAG,CAAC;IAEtE,MAAM,CAAC,MAA6B;QACzC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,CAAC,KAAK,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;YAClE,IAAI,CAAC,MAAM,GAAG,EAAE,CAAA;YAChB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACnB,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,MAA6B,EAAE,KAAa;QACvD,IAAI,CAAC,MAAM,IAAI,KAAK,CAAA;QACpB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACrC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAA;QAE/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,CAAC,KAAK,CAAC,GAAG,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;YAC3D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACnB,CAAC;IACH,CAAC;IAEM,WAAW;QAChB,OAAO,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAA;IAC7C,CAAC;CACF"}

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

@@ -0,0 +1,127 @@
+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 declare const AI_WORKSPACE_CAPABILITIES: readonly ["AgentFramework", "Artifacts", "CRTKnowledge", "CustomKnowledge", "DeepResearch", "EssentialsKnowledge", "LongTermMemory", "Mermaid", "MetadataFormatKnowledge", "Mindmap", "OtherKnowledge", "Reasoning", "SourceFormatKnowledge", "STEM", "TabularData", "WebSearch"];
+export declare const AI_WORKSPACE_MEMBER_PERMISSIONS: readonly ["Access", "Manage"];
+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 AiWorkspaceCapability = (typeof AI_WORKSPACE_CAPABILITIES)[number];
+export type AiWorkspaceMemberPermission = (typeof AI_WORKSPACE_MEMBER_PERMISSIONS)[number];
+export type AiContextOptions = {
+    component?: string;
+    sfOrg?: string;
+    userStory?: string;
+    workItem?: string;
+};
+export type AiWorkspace = {
+    [key: string]: unknown;
+    capabilities?: AiWorkspaceCapability[];
+    description?: string;
+    id: string;
+    members?: AiWorkspaceMember[];
+    name?: string;
+    organization_id?: number;
+};
+export type AiWorkspaceSummary = {
+    [key: string]: unknown;
+    description?: string;
+    id: string;
+    name?: string;
+    organization_id?: number;
+};
+export type AiWorkspaceMember = {
+    [key: string]: unknown;
+    id: string;
+    permission?: AiWorkspaceMemberPermission;
+    user_id?: number;
+};
+export type AiOrganizationQuota = {
+    limit: number;
+    usage: number;
+};
+export type AiWorkspaceCreate = {
+    capabilities?: AiWorkspaceCapability[];
+    description?: string;
+    name: string;
+};
+export type AiWorkspaceUpdate = {
+    capabilities?: AiWorkspaceCapability[];
+    default_dataset_id?: null | string;
+    description?: null | string;
+    name?: null | string;
+};
+export type AiWorkspaceMemberCreate = {
+    permission: AiWorkspaceMemberPermission;
+    user_id: number;
+};
+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 workspaceMembersEndpoint(workspaceId: string): string;
+export declare function quotaEndpoint(): 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 normalizeAiWorkspaceSummary(value: unknown): AiWorkspaceSummary;
+export declare function normalizeAiWorkspaceList(value: unknown): AiWorkspaceSummary[];
+export declare function normalizeAiWorkspaceMember(value: unknown): AiWorkspaceMember;
+export declare function normalizeAiOrganizationQuota(value: unknown): AiOrganizationQuota;
+export declare function normalizeAiDialogue(value: unknown): AiDialogue;
+export declare function validateAiContext(context: AiContextOptions): void;
+export declare function normalizeAiDatasetId(value: string): string;

package/dist/lib/ai-types.js

@@ -0,0 +1,133 @@
+import { normalizeAiDialogueId, normalizeAiUuid, 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 const AI_WORKSPACE_CAPABILITIES = [
+    'AgentFramework',
+    'Artifacts',
+    'CRTKnowledge',
+    'CustomKnowledge',
+    'DeepResearch',
+    'EssentialsKnowledge',
+    'LongTermMemory',
+    'Mermaid',
+    'MetadataFormatKnowledge',
+    'Mindmap',
+    'OtherKnowledge',
+    'Reasoning',
+    'SourceFormatKnowledge',
+    'STEM',
+    'TabularData',
+    'WebSearch',
+];
+export const AI_WORKSPACE_MEMBER_PERMISSIONS = ['Access', 'Manage'];
+export function assistantIdForAgent(agent) {
+    return agent === 'orchestrate' ? 'generalist' : agent;
+}
+export function workspacesEndpoint() {
+    return '/workspaces';
+}
+export function workspaceEndpoint(workspaceId) {
+    return `/workspaces/${normalizeAiWorkspaceId(workspaceId)}`;
+}
+export function workspaceMembersEndpoint(workspaceId) {
+    return `${workspaceEndpoint(workspaceId)}/members`;
+}
+export function quotaEndpoint() {
+    return '/quota';
+}
+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.');
+    }
+    const normalized = { ...value, id: workspace.id.trim() };
+    if (Array.isArray(workspace.members)) {
+        normalized.members = workspace.members.map((member) => normalizeAiWorkspaceMember(member));
+    }
+    return normalized;
+}
+export function normalizeAiWorkspaceSummary(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('AI workspace summary response was not an object.');
+    }
+    const workspace = value;
+    if (typeof workspace.id !== 'string' || workspace.id.trim().length === 0) {
+        throw new Error('AI workspace summary response did not include an id.');
+    }
+    return { ...value, id: workspace.id.trim() };
+}
+export function normalizeAiWorkspaceList(value) {
+    if (!Array.isArray(value))
+        throw new Error('AI workspace list response was not an array.');
+    return value.map((workspace) => normalizeAiWorkspaceSummary(workspace));
+}
+export function normalizeAiWorkspaceMember(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('AI workspace member response was not an object.');
+    }
+    const member = value;
+    if (typeof member.id !== 'string' || member.id.trim().length === 0) {
+        throw new Error('AI workspace member response did not include an id.');
+    }
+    return { ...value, id: member.id.trim() };
+}
+export function normalizeAiOrganizationQuota(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('AI quota response was not an object.');
+    }
+    const quota = value;
+    if (typeof quota.usage !== 'number' || typeof quota.limit !== 'number') {
+        throw new TypeError('AI quota response did not include numeric usage and limit.');
+    }
+    return { limit: quota.limit, usage: quota.usage };
+}
+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.`);
+        }
+    }
+}
+export function normalizeAiDatasetId(value) {
+    return normalizeAiUuid(value, 'AI default dataset ID');
+}
+//# 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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"}