@byline/ai 1.9.0

package/dist/execute.js

@@ -0,0 +1,473 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+import { stdSerializers } from 'pino';
+import { z } from 'zod';
+import { instructionSchema } from './@types';
+import { getAiServerConfig } from './config/ai-config';
+import { generateHtml, generateHtmlStreaming, generateStructured, generateStructuredStreaming, generateText, generateTextStreaming, } from './generate';
+import { getLogger } from './lib/logger';
+import { patch, patchStreaming } from './patch';
+const isAbortLikeError = (error) => {
+    if (error == null)
+        return false;
+    // Many libraries throw DOM-style AbortError
+    const anyErr = error;
+    if (anyErr?.name === 'AbortError')
+        return true;
+    // OpenAI Node SDK (responses/streaming + undici) can throw these.
+    if (anyErr?.type === 'APIUserAbortError')
+        return true;
+    // Undici abort error (often surfaces as name ResponseAborted)
+    if (anyErr?.name === 'ResponseAborted')
+        return true;
+    // Some libs only set message text.
+    const message = typeof anyErr?.message === 'string' ? anyErr.message : '';
+    if (message.toLowerCase().includes('aborted'))
+        return true;
+    return false;
+};
+const createEmptyTextStream = () => (async function* () {
+    // intentionally empty
+})();
+const validateInstructionFields = (params) => {
+    const config = getAiServerConfig();
+    const validatedFields = instructionSchema.safeParse(params);
+    if (validatedFields.success === false) {
+        return {
+            ok: false,
+            errorState: {
+                errors: z.flattenError(validatedFields.error).fieldErrors,
+                message: 'Missing fields in instruction form.',
+                status: 'failed',
+            },
+        };
+    }
+    const { prompt, input, provider, model: modelName, sdk, mode } = validatedFields.data;
+    const output = validatedFields.data.output ?? { type: 'structured' };
+    // Validate that the appropriate API key exists for the selected provider
+    let apiKey;
+    switch (provider) {
+        case 'openai':
+            apiKey = config.ai.openai.apiKey;
+            break;
+        case 'google':
+            apiKey = config.ai.google.apiKey;
+            break;
+        case 'anthropic':
+            apiKey = config.ai.anthropic.apiKey;
+            break;
+    }
+    if (apiKey == null || apiKey.length === 0) {
+        return {
+            ok: false,
+            errorState: {
+                errors: { prompt: [], editor: [] },
+                message: `${provider.charAt(0).toUpperCase() + provider.slice(1)} API key is missing on the server.`,
+                status: 'failed',
+            },
+        };
+    }
+    let inputValue = null;
+    if (input.type === 'structured') {
+        try {
+            inputValue = JSON.parse(input.editorJson);
+        }
+        catch {
+            return {
+                ok: false,
+                errorState: {
+                    errors: { editor: ['Editor state must be valid JSON.'] },
+                    message: 'Editor state is invalid JSON.',
+                    status: 'failed',
+                },
+            };
+        }
+    }
+    if (output.type === 'structured' && input.type !== 'structured') {
+        return {
+            ok: false,
+            errorState: {
+                errors: { editor: ['Structured output requires structured editor input.'] },
+                message: 'Structured output requires structured editor input.',
+                status: 'failed',
+            },
+        };
+    }
+    if (input.type === 'text') {
+        inputValue = input.text;
+    }
+    return {
+        ok: true,
+        data: {
+            sdk,
+            mode,
+            apiKey,
+            input: {
+                type: input.type,
+                value: inputValue,
+            },
+            modelName,
+            prompt,
+            provider,
+            output,
+        },
+    };
+};
+export async function executeInstruction(params, options) {
+    const startedAt = Date.now();
+    const withLastRun = (state) => {
+        // console.log('executeInstruction result', state)
+        return { ...state, lastRun: Date.now() - startedAt };
+    };
+    const logger = getLogger();
+    const validated = validateInstructionFields(params);
+    if (validated.ok === false) {
+        return withLastRun(validated.errorState);
+    }
+    const { prompt, input, provider, modelName, sdk, apiKey, output, mode } = validated.data;
+    // Resolve existing content as plain text for use as context in new_with_context / patch modes.
+    const contextText = mode !== 'new'
+        ? input.type === 'structured'
+            ? JSON.stringify(input.value)
+            : String(input.value ?? '')
+        : undefined;
+    try {
+        if (output.type === 'html') {
+            const result = await generateHtml({
+                provider,
+                apiKey,
+                modelName,
+                prompt,
+                sdk,
+                inputText: contextText,
+                signal: options?.signal,
+            });
+            if (result.success) {
+                return withLastRun({
+                    errors: {},
+                    message: result.message,
+                    format: 'html',
+                    html: result.html,
+                    status: 'success',
+                });
+            }
+            return withLastRun({
+                errors: result.errors,
+                message: result.message,
+                status: 'failed',
+            });
+        }
+        if (output.type === 'text') {
+            const result = await generateText({
+                provider,
+                apiKey,
+                modelName,
+                prompt,
+                sdk,
+                inputText: contextText,
+                maxLength: output.maxLength,
+                signal: options?.signal,
+            });
+            if (result.success) {
+                return withLastRun({
+                    errors: {},
+                    message: result.message,
+                    format: 'text',
+                    text: result.text,
+                    status: 'success',
+                });
+            }
+            return withLastRun({
+                errors: result.errors,
+                message: result.message,
+                status: 'failed',
+            });
+        }
+        // output.type === 'structured'
+        if (input.type !== 'structured' || input.value == null) {
+            return withLastRun({
+                errors: { editor: ['Structured output requires structured editor input.'] },
+                message: 'Structured output requires structured editor input.',
+                status: 'failed',
+            });
+        }
+        if (mode === 'patch') {
+            const result = await patch({
+                provider,
+                apiKey,
+                modelName,
+                prompt,
+                sdk,
+                editorState: input.value,
+                signal: options?.signal,
+            });
+            if (result.success) {
+                return withLastRun({
+                    errors: {},
+                    message: result.message,
+                    editor: result.editor,
+                    format: 'lexical',
+                    status: 'success',
+                });
+            }
+            return withLastRun({
+                errors: result.errors,
+                message: result.message,
+                status: 'failed',
+            });
+        }
+        // mode === 'new' or mode === 'new_with_context'
+        const result = await generateStructured({
+            provider,
+            apiKey,
+            modelName,
+            prompt,
+            sdk,
+            inputText: contextText,
+            signal: options?.signal,
+        });
+        if (result.success) {
+            switch (result.format) {
+                case 'html':
+                    return withLastRun({
+                        errors: {},
+                        message: result.message,
+                        format: 'html',
+                        html: result.html,
+                        status: 'success',
+                    });
+                case 'text':
+                    return withLastRun({
+                        errors: {},
+                        message: result.message,
+                        format: 'text',
+                        text: result.text,
+                        status: 'success',
+                    });
+                case 'lexical':
+                    return withLastRun({
+                        errors: {},
+                        message: result.message,
+                        format: 'lexical',
+                        editor: result.editor,
+                        status: 'success',
+                    });
+            }
+        }
+        return withLastRun({
+            errors: result.errors,
+            message: result.message,
+            status: 'failed',
+        });
+    }
+    catch (error) {
+        // Cancellation is expected behavior; do not log at error level.
+        if (isAbortLikeError(error)) {
+            return withLastRun({
+                errors: {},
+                message: 'Cancelled.',
+                status: 'idle',
+            });
+        }
+        logger.error({
+            instruction: {
+                status: 'failed',
+                message: 'error calling instruction action',
+                method: 'instruction',
+                error: stdSerializers.err(error),
+            },
+        });
+        return withLastRun({
+            errors: {},
+            message: 'Failed to complete AI instruction.',
+            status: 'failed',
+        });
+    }
+}
+export function executeInstructionStreaming(params, options) {
+    const startedAt = Date.now();
+    const withLastRun = (state) => {
+        return { ...state, lastRun: Date.now() - startedAt };
+    };
+    const logger = getLogger();
+    const validated = validateInstructionFields(params);
+    if (validated.ok === false) {
+        return {
+            text: createEmptyTextStream(),
+            final: Promise.resolve(withLastRun(validated.errorState)),
+        };
+    }
+    const { prompt, input, provider, modelName, sdk, apiKey, output, mode } = validated.data;
+    // Resolve existing content as plain text for use as context in new_with_context / patch modes.
+    const contextText = mode !== 'new'
+        ? input.type === 'structured'
+            ? JSON.stringify(input.value)
+            : String(input.value ?? '')
+        : undefined;
+    try {
+        let streamResult;
+        if (output.type === 'html') {
+            streamResult = generateHtmlStreaming({
+                provider,
+                apiKey,
+                modelName,
+                prompt,
+                sdk,
+                inputText: contextText,
+                signal: options?.signal,
+            });
+        }
+        else if (output.type === 'text') {
+            streamResult = generateTextStreaming({
+                provider,
+                apiKey,
+                modelName,
+                prompt,
+                sdk,
+                inputText: contextText,
+                maxLength: output.maxLength,
+                signal: options?.signal,
+            });
+        }
+        else {
+            if (input.type !== 'structured' || input.value == null) {
+                return {
+                    text: createEmptyTextStream(),
+                    final: Promise.resolve(withLastRun({
+                        errors: { editor: ['Structured output requires structured editor input.'] },
+                        message: 'Structured output requires structured editor input.',
+                        status: 'failed',
+                    })),
+                };
+            }
+            if (mode === 'patch') {
+                streamResult = patchStreaming({
+                    provider,
+                    apiKey,
+                    modelName,
+                    prompt,
+                    sdk,
+                    editorState: input.value,
+                    signal: options?.signal,
+                });
+            }
+            else {
+                // mode === 'new' or mode === 'new_with_context'
+                streamResult = generateStructuredStreaming({
+                    provider,
+                    apiKey,
+                    modelName,
+                    prompt,
+                    sdk,
+                    inputText: contextText,
+                    signal: options?.signal,
+                });
+            }
+        }
+        const final = (async () => {
+            try {
+                const result = await streamResult.final;
+                if (result.success) {
+                    if ('format' in result) {
+                        switch (result.format) {
+                            case 'html':
+                                return withLastRun({
+                                    errors: {},
+                                    message: result.message,
+                                    format: 'html',
+                                    html: result.html,
+                                    status: 'success',
+                                });
+                            case 'text':
+                                return withLastRun({
+                                    errors: {},
+                                    message: result.message,
+                                    format: 'text',
+                                    text: result.text,
+                                    status: 'success',
+                                });
+                            case 'lexical':
+                                return withLastRun({
+                                    errors: {},
+                                    message: result.message,
+                                    format: 'lexical',
+                                    editor: result.editor,
+                                    status: 'success',
+                                });
+                        }
+                    }
+                    // Patch success (structured patch) returns an editor.
+                    return withLastRun({
+                        errors: {},
+                        message: result.message,
+                        format: 'lexical',
+                        editor: result.editor,
+                        status: 'success',
+                    });
+                }
+                return withLastRun({
+                    errors: result.errors,
+                    message: result.message,
+                    status: 'failed',
+                });
+            }
+            catch (error) {
+                if (isAbortLikeError(error)) {
+                    return withLastRun({
+                        errors: {},
+                        message: 'Cancelled.',
+                        status: 'idle',
+                    });
+                }
+                logger.error({
+                    instruction: {
+                        status: 'failed',
+                        message: 'error calling instruction action',
+                        method: 'instruction-streaming',
+                        error: stdSerializers.err(error),
+                    },
+                });
+                return withLastRun({
+                    errors: {},
+                    message: 'Failed to complete AI instruction.',
+                    status: 'failed',
+                });
+            }
+        })();
+        return { text: streamResult.text, final };
+    }
+    catch (error) {
+        if (isAbortLikeError(error)) {
+            return {
+                text: createEmptyTextStream(),
+                final: Promise.resolve(withLastRun({
+                    errors: {},
+                    message: 'Cancelled.',
+                    status: 'idle',
+                })),
+            };
+        }
+        logger.error({
+            instruction: {
+                status: 'failed',
+                message: 'error calling instruction action',
+                method: 'instruction-streaming',
+                error: stdSerializers.err(error),
+            },
+        });
+        return {
+            text: createEmptyTextStream(),
+            final: Promise.resolve(withLastRun({
+                errors: {},
+                message: 'Failed to complete AI instruction.',
+                status: 'failed',
+            })),
+        };
+    }
+}
+//# sourceMappingURL=execute.js.map

package/dist/execute.js.map

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

package/dist/generate.d.ts

@@ -0,0 +1,64 @@
+/**
+ * This Source Code is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * Copyright (c) Infonomic Company Limited
+ */
+import type { Provider, Sdk } from './@types';
+export interface GenerateOptions {
+    provider: Provider;
+    apiKey: string;
+    modelName: string;
+    prompt: string;
+    sdk: Sdk;
+    inputText?: string;
+    signal?: AbortSignal;
+}
+export type GenerateResult = {
+    success: true;
+    format: 'lexical';
+    editor: any;
+    message: string;
+} | {
+    success: true;
+    format: 'html';
+    html: string;
+    message: string;
+} | {
+    success: true;
+    format: 'text';
+    text: string;
+    message: string;
+};
+export type GenerateStreamingResult = {
+    text: AsyncIterable<string>;
+    final: Promise<GenerateResult | GenerateError>;
+};
+export interface GenerateError {
+    success: false;
+    message: string;
+    errors: Record<string, string[]>;
+}
+export interface GenerateTextOptions extends GenerateOptions {
+    maxLength?: number;
+}
+/**
+ * Generates a new Lexical document from scratch based on a user prompt.
+ * Uses the documentSchema to ensure the AI generates valid Lexical JSON
+ * with proper structure including headings, paragraphs, lists, etc.
+ */
+export declare function generateStructured(options: GenerateOptions): Promise<GenerateResult | GenerateError>;
+/**
+ * Streams a Lexical document generation.
+ */
+export declare function generateStructuredStreaming(options: GenerateOptions): GenerateStreamingResult;
+export declare function generateHtml(options: GenerateOptions): Promise<Extract<GenerateResult, {
+    format: 'html';
+}> | GenerateError>;
+export declare function generateHtmlStreaming(options: GenerateOptions): GenerateStreamingResult;
+export declare function generateText(options: GenerateTextOptions): Promise<Extract<GenerateResult, {
+    format: 'text';
+}> | GenerateError>;
+export declare function generateTextStreaming(options: GenerateTextOptions): GenerateStreamingResult;
+//# sourceMappingURL=generate.d.ts.map

package/dist/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+BH,OAAO,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAM7C,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,QAAQ,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,GAAG,CAAA;IACR,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,MAAM,MAAM,cAAc,GACtB;IACE,OAAO,EAAE,IAAI,CAAA;IACb,MAAM,EAAE,SAAS,CAAA;IACjB,MAAM,EAAE,GAAG,CAAA;IACX,OAAO,EAAE,MAAM,CAAA;CAChB,GACD;IACE,OAAO,EAAE,IAAI,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB,GACD;IACE,OAAO,EAAE,IAAI,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAEL,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC3B,KAAK,EAAE,OAAO,CAAC,cAAc,GAAG,aAAa,CAAC,CAAA;CAC/C,CAAA;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,KAAK,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAoED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,GAAG,aAAa,CAAC,CAczC;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,eAAe,GAAG,uBAAuB,CAwB7F;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,aAAa,CAAC,CA2BtE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,uBAAuB,CAsCvF;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,aAAa,CAAC,CAoCtE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,mBAAmB,GAAG,uBAAuB,CA0C3F"}