@didim365/agent-cli-core 0.3.1 → 0.3.4

package/dist/src/providers/didim/adapter.js

@@ -0,0 +1,346 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * DidimAdapter — extends BaseAdapter for DidimAIStudio REST/SSE API.
+ *
+ * Unlike Claude/OpenAI adapters that wrap SDK clients, this adapter uses
+ * raw fetch for HTTP + ReadableStream-based SSE parsing, because
+ * DidimAIStudio has no official SDK.
+ *
+ * Features:
+ * - Non-streaming: POST /scenario-gateway/v1/invoke
+ * - SSE streaming: POST /scenario-gateway/v1/invoke/sse (or /sse/improved)
+ * - Automatic thread_id management across calls
+ * - Error classification (401 → AuthenticationError, etc.)
+ *
+ * @see docs/00_project/Integration_DidimAIStudio/00_master_plan.md §1.2
+ * @see packages/core/src/providers/didim/converter.ts (pure conversion functions)
+ */
+import { BaseAdapter } from '../baseAdapter.js';
+import { LlmError, LlmErrorType, AuthenticationError, RateLimitError, TimeoutError, ValidationError, } from '../errors.js';
+import { createErrorEvent } from '../events.js';
+import { getDidimEndpoint, buildDidimHeaders, buildDidimRequestBody, parseDidimResponse, convertDidimResponseToLlm, parseDidimSseEvent, convertDidimSseToLlmEvents, } from './converter.js';
+// ============================================================================
+// Capabilities
+// ============================================================================
+/**
+ * Didim capabilities — scenario-based gateway with limited LLM features.
+ *
+ * Enabled:
+ *   supportsStreaming: true — SSE streaming (sse + improved modes)
+ *
+ * Not supported:
+ *   Everything else — DidimAIStudio is a scenario gateway, not a raw LLM API.
+ *   Token counting, tool calls, image I/O, system messages, and thinking
+ *   are all managed server-side within the scenario.
+ */
+const DIDIM_CAPABILITIES = {
+    supportsStreaming: true,
+    supportsToolCalls: false,
+    supportsImageInput: false,
+    supportsImageGeneration: false,
+    supportsEmbedding: false,
+    supportsTokenCount: false,
+    supportsSystemMessage: false,
+    supportsThought: false,
+    maxContextLength: 0,
+    maxOutputTokens: 0,
+};
+// ============================================================================
+// Adapter
+// ============================================================================
+/**
+ * DidimAdapter wraps the DidimAIStudio API behind the BaseAdapter interface.
+ */
+export class DidimAdapter extends BaseAdapter {
+    fetchFn;
+    apiKey;
+    serverAddress;
+    streamMode;
+    providerName = 'didim';
+    capabilities = DIDIM_CAPABILITIES;
+    /** Stored thread_id for conversation continuity. */
+    threadId = null;
+    constructor(config, fetchFn, apiKey, serverAddress, streamMode) {
+        super(config);
+        this.fetchFn = fetchFn;
+        this.apiKey = apiKey;
+        this.serverAddress = serverAddress;
+        this.streamMode = streamMode;
+    }
+    /**
+     * Generate content (non-streaming).
+     * POST /scenario-gateway/v1/invoke
+     */
+    async generateContent(request, _userPromptId, options) {
+        this.validateRequest(request);
+        try {
+            const url = this.buildEndpointUrl();
+            const headers = buildDidimHeaders(this.apiKey, this.threadId);
+            const chatText = this.extractChatText(request);
+            const body = buildDidimRequestBody(chatText, this.threadId);
+            const response = await this.fetchFn(url, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify(body),
+                signal: options?.signal,
+            });
+            if (!response.ok) {
+                throw this.classifyHttpError(response.status, response.statusText);
+            }
+            const rawJson = (await response.json());
+            const parsed = parseDidimResponse(rawJson);
+            // Store thread_id for subsequent calls
+            if (parsed.threadId) {
+                this.threadId = parsed.threadId;
+            }
+            return convertDidimResponseToLlm(parsed, request.model);
+        }
+        catch (error) {
+            this.handleError(error);
+        }
+    }
+    /**
+     * Generate content as a stream of LlmEvents.
+     * POST /scenario-gateway/v1/invoke/sse (or /sse/improved)
+     */
+    generateContentStream(request, _userPromptId, options) {
+        this.validateRequest(request);
+        const fetchFn = this.fetchFn;
+        const streamMode = this.streamMode;
+        const classify = this.classifyHttpError.bind(this);
+        const storeThreadId = (id) => {
+            if (id)
+                this.threadId = id;
+        };
+        // Build request params inside closure to capture current state,
+        // but keep inside generator try block for error classification.
+        const serverAddress = this.serverAddress;
+        const apiKey = this.apiKey;
+        // Read threadId lazily at fetch time to avoid stale capture
+        // when generator is consumed after subsequent calls update threadId.
+        const getThreadId = () => this.threadId;
+        const chatText = this.extractChatText(request);
+        const signal = options?.signal;
+        const buildEndpoint = () => getDidimEndpoint(serverAddress, {
+            streaming: true,
+            streamMode,
+        });
+        async function* streamGenerator() {
+            try {
+                // Build URL inside try so config errors become classified Error events
+                let url;
+                try {
+                    url = buildEndpoint();
+                }
+                catch (e) {
+                    const message = e instanceof Error ? e.message : String(e);
+                    yield createErrorEvent(new ValidationError(`Didim configuration error: ${message}`, {
+                        provider: 'didim',
+                    }), undefined, false);
+                    return;
+                }
+                const currentThreadId = getThreadId();
+                const headers = buildDidimHeaders(apiKey, currentThreadId);
+                const body = buildDidimRequestBody(chatText, currentThreadId);
+                const response = await fetchFn(url, {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify(body),
+                    signal,
+                });
+                if (!response.ok) {
+                    const error = classify(response.status, response.statusText);
+                    yield createErrorEvent(error, error.code, error.isRetryable);
+                    return;
+                }
+                if (!response.body) {
+                    yield createErrorEvent('No response body for SSE stream', undefined, false);
+                    return;
+                }
+                const reader = response.body.getReader();
+                const decoder = new TextDecoder();
+                let buffer = '';
+                let currentEvent = '';
+                const dataLines = [];
+                // Track whether any delta (message_partial) has been emitted.
+                // If so, suppress final_message to prevent duplicate text output.
+                let hasDelta = false;
+                try {
+                    while (true) {
+                        const { done, value } = await reader.read();
+                        if (done)
+                            break;
+                        buffer += decoder.decode(value, { stream: true });
+                        const lines = buffer.split('\n');
+                        // Keep incomplete last line in buffer
+                        buffer = lines.pop() ?? '';
+                        for (const rawLine of lines) {
+                            // Strip trailing \r for CRLF compatibility (SSE spec §9.2.4)
+                            const line = rawLine.endsWith('\r')
+                                ? rawLine.slice(0, -1)
+                                : rawLine;
+                            // SSE spec §9.2.4: field name is everything before first colon.
+                            // A single space after the colon, if present, is stripped.
+                            if (line.startsWith('event:')) {
+                                currentEvent = line.substring(6).replace(/^ /, '').trim();
+                            }
+                            else if (line.startsWith('data:')) {
+                                dataLines.push(line.substring(5).replace(/^ /, ''));
+                            }
+                            else if (line === '' && currentEvent) {
+                                // Empty line = event boundary
+                                // SSE spec: multiple data: lines joined with newline
+                                const currentData = dataLines.join('\n');
+                                const sseEvent = parseDidimSseEvent(currentEvent, currentData, streamMode);
+                                if (sseEvent) {
+                                    // Store thread_id from done events
+                                    if (sseEvent.type === 'done' && sseEvent.threadId) {
+                                        storeThreadId(sseEvent.threadId);
+                                    }
+                                    // Track deltas and suppress final_message when deltas
+                                    // have already been emitted (prevents duplicate output
+                                    // in improved mode where server sends both
+                                    // message_partial deltas AND a final message event).
+                                    if (sseEvent.type === 'delta') {
+                                        hasDelta = true;
+                                    }
+                                    if (sseEvent.type === 'final_message' && hasDelta) {
+                                        // Skip — content already streamed via deltas
+                                    }
+                                    else {
+                                        const llmEvents = convertDidimSseToLlmEvents(sseEvent);
+                                        for (const llmEvent of llmEvents) {
+                                            yield llmEvent;
+                                        }
+                                    }
+                                }
+                                currentEvent = '';
+                                dataLines.length = 0;
+                            }
+                        }
+                    }
+                    // Flush remaining TextDecoder bytes (trailing multi-byte sequence)
+                    const trailing = decoder.decode();
+                    if (trailing) {
+                        buffer += trailing;
+                    }
+                    // Parse any remaining lines in buffer (stream ended without final \n)
+                    if (buffer) {
+                        const remainingLines = buffer.split('\n');
+                        for (const rawLine of remainingLines) {
+                            const line = rawLine.endsWith('\r')
+                                ? rawLine.slice(0, -1)
+                                : rawLine;
+                            if (line.startsWith('event:')) {
+                                currentEvent = line.substring(6).replace(/^ /, '').trim();
+                            }
+                            else if (line.startsWith('data:')) {
+                                dataLines.push(line.substring(5).replace(/^ /, ''));
+                            }
+                        }
+                    }
+                    // Flush remaining event if stream ended without trailing blank line
+                    if (currentEvent && dataLines.length > 0) {
+                        const currentData = dataLines.join('\n');
+                        const sseEvent = parseDidimSseEvent(currentEvent, currentData, streamMode);
+                        if (sseEvent) {
+                            if (sseEvent.type === 'done' && sseEvent.threadId) {
+                                storeThreadId(sseEvent.threadId);
+                            }
+                            const llmEvents = convertDidimSseToLlmEvents(sseEvent);
+                            for (const llmEvent of llmEvents) {
+                                yield llmEvent;
+                            }
+                        }
+                    }
+                }
+                finally {
+                    reader.releaseLock();
+                }
+            }
+            catch (error) {
+                const err = error instanceof Error ? error : new Error(String(error));
+                yield createErrorEvent(err, undefined, false);
+            }
+        }
+        return streamGenerator();
+    }
+    /**
+     * Extract all text parts from the last user message, concatenated.
+     * DidimAIStudio accepts a single `chat` string, not a message array.
+     */
+    extractChatText(request) {
+        // Find the last user message
+        for (let i = request.messages.length - 1; i >= 0; i--) {
+            const msg = request.messages[i];
+            if (msg.role === 'user') {
+                const texts = [];
+                for (const content of msg.content) {
+                    if (content.type === 'text') {
+                        texts.push(content.text);
+                    }
+                }
+                return texts.join('\n');
+            }
+        }
+        return '';
+    }
+    /**
+     * Build endpoint URL with error classification.
+     * Wraps getDidimEndpoint to convert raw Error to ValidationError.
+     */
+    buildEndpointUrl(streaming) {
+        try {
+            return getDidimEndpoint(this.serverAddress, streaming
+                ? {
+                    streaming: true,
+                    streamMode: this.streamMode,
+                }
+                : undefined);
+        }
+        catch (e) {
+            const message = e instanceof Error ? e.message : String(e);
+            throw new ValidationError(`Didim configuration error: ${message}`, {
+                provider: this.providerName,
+            });
+        }
+    }
+    /**
+     * Classify an HTTP status code into a typed LlmError.
+     */
+    classifyHttpError(status, statusText) {
+        const message = `DidimAIStudio API error: ${status} ${statusText ?? ''}`.trim();
+        const opts = {
+            provider: this.providerName,
+            statusCode: status,
+        };
+        if (status === 401 || status === 403) {
+            return new AuthenticationError(message, opts);
+        }
+        if (status === 429) {
+            return new RateLimitError(message, opts);
+        }
+        if (status === 408) {
+            return new TimeoutError(message, opts);
+        }
+        if (status >= 500) {
+            return new LlmError(LlmErrorType.SERVER_ERROR, message, {
+                ...opts,
+                isRetryable: true,
+            });
+        }
+        return new LlmError(LlmErrorType.UNKNOWN, message, opts);
+    }
+    /**
+     * Map common config to provider-specific config.
+     * DidimAIStudio doesn't use standard LLM config params.
+     */
+    mapToProviderConfig(_config) {
+        return {};
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/src/providers/didim/adapter.js.map

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

package/dist/src/providers/didim/bootstrap.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Didim provider bootstrap — registers the DidimAdapter factory
+ * in the ProviderRegistry.
+ *
+ * Uses a has() guard so repeated calls are idempotent (safe for HMR,
+ * test re-initialization, or Agent re-creation).
+ *
+ * Config resolution priority:
+ * 1. AdapterConfig fields (passed from contentGenerator.ts)
+ * 2. Environment variables (DIDIM_API_KEY, DIDIM_SERVER_ADDRESS, DIDIM_STREAM_MODE)
+ *
+ * @see docs/00_project/Integration_DidimAIStudio/00_master_plan.md
+ */
+import { ProviderRegistry } from '../registry.js';
+/**
+ * Register the Didim adapter factory in the provider registry.
+ *
+ * @param registry - Optional registry instance. Defaults to singleton.
+ */
+export declare function bootstrapDidimProvider(registry?: ProviderRegistry): void;

package/dist/src/providers/didim/bootstrap.js

@@ -0,0 +1,47 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Didim provider bootstrap — registers the DidimAdapter factory
+ * in the ProviderRegistry.
+ *
+ * Uses a has() guard so repeated calls are idempotent (safe for HMR,
+ * test re-initialization, or Agent re-creation).
+ *
+ * Config resolution priority:
+ * 1. AdapterConfig fields (passed from contentGenerator.ts)
+ * 2. Environment variables (DIDIM_API_KEY, DIDIM_SERVER_ADDRESS, DIDIM_STREAM_MODE)
+ *
+ * @see docs/00_project/Integration_DidimAIStudio/00_master_plan.md
+ */
+import { ProviderRegistry } from '../registry.js';
+import { DidimAdapter } from './adapter.js';
+import { ValidationError } from '../errors.js';
+/** Valid stream mode values. */
+const VALID_STREAM_MODES = new Set(['sse', 'improved']);
+/**
+ * Register the Didim adapter factory in the provider registry.
+ *
+ * @param registry - Optional registry instance. Defaults to singleton.
+ */
+export function bootstrapDidimProvider(registry) {
+    const reg = registry ?? ProviderRegistry.getInstance();
+    if (reg.has('didim'))
+        return;
+    reg.register('didim', (config) => {
+        const apiKey = config.apiKey || process.env['DIDIM_API_KEY'] || '';
+        const serverAddress = config['serverAddress'] ||
+            process.env['DIDIM_SERVER_ADDRESS'] ||
+            '';
+        const streamModeRaw = config['streamMode'] ||
+            process.env['DIDIM_STREAM_MODE'] ||
+            'sse';
+        if (!VALID_STREAM_MODES.has(streamModeRaw)) {
+            throw new ValidationError(`Invalid DIDIM_STREAM_MODE: "${streamModeRaw}". Must be "sse" or "improved".`, { provider: 'didim' });
+        }
+        return new DidimAdapter(config, globalThis.fetch.bind(globalThis), apiKey, serverAddress, streamModeRaw);
+    });
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/src/providers/didim/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../../../src/providers/didim/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,gCAAgC;AAChC,MAAM,kBAAkB,GAAwB,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;AAE7E;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAA2B;IAChE,MAAM,GAAG,GAAG,QAAQ,IAAI,gBAAgB,CAAC,WAAW,EAAE,CAAC;IACvD,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO;IAE7B,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAqB,EAAE,EAAE;QAC9C,MAAM,MAAM,GACT,MAAM,CAAC,MAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;QAClE,MAAM,aAAa,GAChB,MAAM,CAAC,eAAe,CAAY;YACnC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC;YACnC,EAAE,CAAC;QACL,MAAM,aAAa,GAChB,MAAM,CAAC,YAAY,CAAY;YAChC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;YAChC,KAAK,CAAC;QAER,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,eAAe,CACvB,+BAA+B,aAAa,iCAAiC,EAC7E,EAAE,QAAQ,EAAE,OAAO,EAAE,CACtB,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,YAAY,CACrB,MAAM,EACN,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,EACjC,MAAM,EACN,aAAa,EACb,aAAgC,CACjC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/providers/didim/converter.d.ts

@@ -0,0 +1,133 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * DidimAIStudio converter — pure functions for request/response transformation.
+ *
+ * Converts between the LLM-agnostic types used by the adapter layer and the
+ * DidimAIStudio REST/SSE API format.
+ *
+ * API contract (master plan §1.2 + 06-didiaistudio-plan.md):
+ * - Invoke:   POST {baseUrl}/scenario-gateway/v1/invoke
+ * - SSE:      POST {baseUrl}/scenario-gateway/v1/invoke/sse
+ * - Improved: POST {baseUrl}/scenario-gateway/v1/invoke/sse/improved
+ * - Auth:     Authorization: Bearer {jwt_token}
+ * - Body:     { chat: string, thread_id?: string }
+ * - Response: { response: string, thread_id: string }
+ *
+ * Improved mode event types (OpenAPI spec + 06-plan):
+ * - message_partial:  토큰 스트리밍 (chunk/content/message 필드)
+ * - message_complete: ToolMessage 완료 (message 필드 or process_name)
+ * - message_metadata: 실행 컨텍스트 (langgraph_node, step, model) → 비콘텐츠
+ * - process:          노드 진행 상황 → 비콘텐츠
+ * - message:          최종 완성 응답 → adapter가 delta 이후 중복 억제
+ * - complete/done:    실행 완료 (thread_id, qa_id)
+ * - error:            에러
+ */
+import { type LlmEvent } from '../events.js';
+import type { LlmGenerateResponse } from '../types.js';
+/** SSE stream mode. */
+export type DidimStreamMode = 'sse' | 'improved';
+/** Raw response from the DidimAIStudio invoke endpoint. */
+export interface DidimResponse {
+    response?: unknown;
+    thread_id?: unknown;
+}
+/** Parsed response in application-level types. */
+export interface DidimParsedResponse {
+    content: string;
+    threadId: string | null;
+}
+/**
+ * Intermediate SSE event after parsing, before LlmEvent conversion.
+ *
+ * - delta:         토큰 스트리밍 텍스트 (message_partial, sse message)
+ * - final_message: improved 모드 최종 완성 응답 — adapter가 delta 이후 중복 억제
+ * - done:          스트림 완료 (complete/done 이벤트)
+ * - error:         에러
+ * - metadata:      비콘텐츠 메타데이터 (message_metadata, process, message_complete 중 비텍스트)
+ */
+export type DidimSseEvent = {
+    type: 'delta';
+    text: string;
+} | {
+    type: 'final_message';
+    text: string;
+} | {
+    type: 'done';
+    threadId: string | null;
+} | {
+    type: 'error';
+    message: string;
+} | {
+    type: 'metadata';
+    eventName: string;
+    data: Record<string, unknown>;
+};
+/** Options for endpoint generation. */
+export interface DidimEndpointOptions {
+    streaming?: boolean;
+    streamMode?: DidimStreamMode;
+}
+/**
+ * Normalizes a DidimAIStudio domain by stripping protocol prefixes,
+ * trailing slashes, and path segments. Preserves port numbers.
+ */
+export declare function normalizeDidimDomain(raw: string): string;
+/**
+ * Detects the protocol scheme from a raw domain/URL string.
+ * Returns 'http' if explicitly specified, otherwise defaults to 'https'.
+ *
+ * Supports http:// for local development (e.g., http://localhost:8008).
+ */
+export declare function detectScheme(raw: string): 'http' | 'https';
+/**
+ * Builds the full endpoint URL for a given domain and options.
+ * Preserves http:// protocol when explicitly provided (local dev support).
+ */
+export declare function getDidimEndpoint(domain: string, options?: DidimEndpointOptions): string;
+/**
+ * Builds HTTP headers for a DidimAIStudio request.
+ * Trims threadId before use — whitespace-only values are excluded.
+ */
+export declare function buildDidimHeaders(jwtToken: string, threadId?: string | null): Record<string, string>;
+/**
+ * Builds the JSON request body for a DidimAIStudio request.
+ * Trims threadId before use — whitespace-only values are excluded.
+ */
+export declare function buildDidimRequestBody(chat: string, threadId?: string | null): Record<string, string>;
+/**
+ * Parses a raw DidimAIStudio invoke response into typed application data.
+ */
+export declare function parseDidimResponse(raw: DidimResponse): DidimParsedResponse;
+/**
+ * Parses a single SSE event (event name + data string) into a DidimSseEvent.
+ *
+ * Handles both `sse` and `improved` stream modes with graceful fallback
+ * for malformed input (invalid JSON, unknown events, empty/whitespace keep-alive).
+ *
+ * @returns Parsed event, or `null` for ignored/keep-alive/metadata events.
+ */
+export declare function parseDidimSseEvent(eventName: string, data: string, mode: DidimStreamMode): DidimSseEvent | null;
+/**
+ * Generates a unique response ID for DidimAIStudio responses.
+ * DidimAIStudio does not provide server-side response IDs.
+ */
+export declare function generateDidimResponseId(): string;
+/**
+ * Converts a parsed DidimAIStudio invoke response to an LlmGenerateResponse.
+ */
+export declare function convertDidimResponseToLlm(parsed: DidimParsedResponse, model: string): LlmGenerateResponse;
+/**
+ * Converts a DidimSseEvent to one or more LlmEvents.
+ *
+ * Event mapping:
+ * - delta         → TextDelta
+ * - final_message → TextDelta (adapter suppresses when deltas already emitted)
+ * - done          → Finished + MessageEnd (in order)
+ * - error         → Error
+ * - metadata      → [] (non-content, silently skipped)
+ */
+export declare function convertDidimSseToLlmEvents(event: DidimSseEvent): LlmEvent[];