@grafana/sigil-sdk-js-core 0.0.0 → 0.7.0

package/dist/exporters/http.js

@@ -0,0 +1,295 @@
+import { canonicalEffectiveVersion, isRecord } from '../utils.js';
+import { userAgent } from '../version.js';
+export class HTTPGenerationExporter {
+    endpoint;
+    headers;
+    constructor(endpoint, headers) {
+        this.endpoint = normalizeHTTPGenerationEndpoint(endpoint);
+        // Resolve the User-Agent like the gRPC exporter: a non-blank caller override
+        // (case-insensitive) wins, otherwise the SDK default. A blank/whitespace
+        // override is dropped so it can't blank out the default.
+        let resolved = userAgent();
+        const rest = {};
+        for (const [key, value] of Object.entries(headers ?? {})) {
+            if (key.toLowerCase() === 'user-agent') {
+                if (value.trim().length > 0) {
+                    resolved = value;
+                }
+                continue;
+            }
+            rest[key] = value;
+        }
+        this.headers = { 'user-agent': resolved, ...rest };
+    }
+    async exportGenerations(request) {
+        const response = await fetch(this.endpoint, {
+            method: 'POST',
+            headers: {
+                'content-type': 'application/json',
+                ...this.headers,
+            },
+            body: JSON.stringify({
+                generations: request.generations.map(mapGenerationToProtoJSON),
+            }),
+        });
+        if (!response.ok) {
+            const responseText = (await response.text()).trim();
+            throw new Error(`http generation export status ${response.status}: ${responseText}`);
+        }
+        const payload = (await response.json());
+        return parseExportGenerationsResponse(payload, request);
+    }
+}
+function parseExportGenerationsResponse(payload, request) {
+    if (!isRecord(payload) || !Array.isArray(payload.results)) {
+        throw new Error('invalid generation export response payload');
+    }
+    const results = payload.results.map((result, index) => {
+        if (!isRecord(result)) {
+            throw new Error('invalid generation export result payload');
+        }
+        const fallbackGenerationID = request.generations[index]?.id ?? '';
+        return {
+            generationId: typeof result.generationId === 'string'
+                ? result.generationId
+                : typeof result.generation_id === 'string'
+                    ? result.generation_id
+                    : fallbackGenerationID,
+            accepted: Boolean(result.accepted),
+            error: typeof result.error === 'string' ? result.error : undefined,
+        };
+    });
+    return { results };
+}
+const HTTP_GENERATION_EXPORT_PATH = '/api/v1/generations:export';
+/** @internal Exported for tests; not part of the public API. */
+export function normalizeHTTPGenerationEndpoint(endpoint) {
+    const trimmed = endpoint.trim();
+    if (trimmed.length === 0) {
+        throw new Error('generation export endpoint is required');
+    }
+    const lowerPrefix = trimmed.slice(0, 8).toLowerCase();
+    const hasScheme = lowerPrefix.startsWith('http://') || lowerPrefix.startsWith('https://');
+    const withScheme = hasScheme ? trimmed : `http://${trimmed}`;
+    let url;
+    try {
+        url = new URL(withScheme);
+    }
+    catch (e) {
+        const detail = e instanceof Error ? e.message : String(e);
+        throw new Error(`parse generation export endpoint "${endpoint}": ${detail}`);
+    }
+    if (url.pathname === '' || url.pathname === '/') {
+        url.pathname = HTTP_GENERATION_EXPORT_PATH;
+    }
+    return url.toString();
+}
+function mapGenerationToProtoJSON(generation) {
+    const proto = {
+        id: generation.id,
+        conversation_id: generation.conversationId ?? '',
+        operation_name: generation.operationName,
+        mode: generation.mode === 'STREAM' ? 'GENERATION_MODE_STREAM' : 'GENERATION_MODE_SYNC',
+        trace_id: generation.traceId ?? '',
+        span_id: generation.spanId ?? '',
+        model: {
+            provider: generation.model.provider,
+            name: generation.model.name,
+        },
+        response_id: generation.responseId ?? '',
+        response_model: generation.responseModel ?? '',
+        system_prompt: generation.systemPrompt ?? '',
+        input: (generation.input ?? []).map(mapMessageToProtoJSON),
+        output: (generation.output ?? []).map(mapMessageToProtoJSON),
+        tools: (generation.tools ?? []).map(mapToolToProtoJSON),
+        usage: mapUsageToProtoJSON(generation.usage),
+        stop_reason: generation.stopReason ?? '',
+        started_at: generation.startedAt.toISOString(),
+        completed_at: generation.completedAt.toISOString(),
+        tags: generation.tags ?? {},
+        metadata: normalizeMetadata(generation.metadata),
+        raw_artifacts: (generation.artifacts ?? []).map(mapArtifactToProtoJSON),
+        call_error: generation.callError ?? '',
+        agent_name: generation.agentName ?? '',
+        agent_version: generation.agentVersion ?? '',
+    };
+    if (generation.maxTokens !== undefined) {
+        proto.max_tokens = toInt64String(generation.maxTokens);
+    }
+    if (generation.temperature !== undefined) {
+        proto.temperature = generation.temperature;
+    }
+    if (generation.topP !== undefined) {
+        proto.top_p = generation.topP;
+    }
+    if (generation.toolChoice !== undefined) {
+        proto.tool_choice = generation.toolChoice;
+    }
+    if (generation.thinkingEnabled !== undefined) {
+        proto.thinking_enabled = generation.thinkingEnabled;
+    }
+    if (generation.parentGenerationIds?.length) {
+        proto.parent_generation_ids = generation.parentGenerationIds;
+    }
+    const effectiveVersion = canonicalEffectiveVersion(generation.effectiveVersion);
+    if (effectiveVersion !== undefined) {
+        proto.effective_version = effectiveVersion;
+    }
+    return proto;
+}
+function mapMessageToProtoJSON(message) {
+    const parts = (message.parts ?? []).map(mapMessagePartToProtoJSON);
+    if (parts.length === 0 && typeof message.content === 'string') {
+        parts.push({ text: message.content });
+    }
+    return {
+        role: toMessageRoleEnum(message.role),
+        name: message.name ?? '',
+        parts,
+    };
+}
+function mapMessagePartToProtoJSON(part) {
+    switch (part.type) {
+        case 'text':
+            return withPartMetadata({
+                text: part.text,
+            }, part.metadata?.providerType);
+        case 'thinking':
+            return withPartMetadata({
+                thinking: part.thinking,
+            }, part.metadata?.providerType);
+        case 'tool_call':
+            return withPartMetadata({
+                tool_call: {
+                    id: part.toolCall.id ?? '',
+                    name: part.toolCall.name,
+                    input_json: toBase64Payload(part.toolCall.inputJSON),
+                },
+            }, part.metadata?.providerType);
+        case 'tool_result':
+            return withPartMetadata({
+                tool_result: {
+                    tool_call_id: part.toolResult.toolCallId ?? '',
+                    name: part.toolResult.name ?? '',
+                    content: part.toolResult.content ?? '',
+                    content_json: toBase64Payload(part.toolResult.contentJSON),
+                    is_error: part.toolResult.isError ?? false,
+                },
+            }, part.metadata?.providerType);
+    }
+}
+function mapToolToProtoJSON(tool) {
+    return {
+        name: tool.name,
+        description: tool.description ?? '',
+        type: tool.type ?? '',
+        input_schema_json: toBase64Payload(tool.inputSchemaJSON),
+    };
+}
+function mapUsageToProtoJSON(usage) {
+    if (usage === undefined) {
+        return undefined;
+    }
+    const inputTokens = usage.inputTokens ?? 0;
+    const outputTokens = usage.outputTokens ?? 0;
+    const totalTokens = usage.totalTokens ?? inputTokens + outputTokens;
+    return {
+        input_tokens: toInt64String(inputTokens),
+        output_tokens: toInt64String(outputTokens),
+        total_tokens: toInt64String(totalTokens),
+        cache_read_input_tokens: toInt64String(usage.cacheReadInputTokens),
+        cache_write_input_tokens: toInt64String(usage.cacheWriteInputTokens),
+        reasoning_tokens: toInt64String(usage.reasoningTokens),
+    };
+}
+function mapArtifactToProtoJSON(artifact) {
+    return {
+        kind: toArtifactKindEnum(artifact.type),
+        name: artifact.name ?? artifact.type,
+        content_type: artifact.mimeType ?? 'application/json',
+        payload: toBase64Payload(artifact.payload),
+        record_id: artifact.recordId ?? '',
+        uri: artifact.uri ?? '',
+    };
+}
+function withPartMetadata(part, providerType) {
+    if (providerType === undefined || providerType.trim().length === 0) {
+        return part;
+    }
+    return {
+        ...part,
+        metadata: {
+            provider_type: providerType,
+        },
+    };
+}
+function normalizeMetadata(metadata) {
+    if (metadata === undefined) {
+        return {};
+    }
+    try {
+        const encoded = JSON.stringify(metadata, (_key, value) => {
+            if (value instanceof Date) {
+                return value.toISOString();
+            }
+            if (typeof value === 'bigint') {
+                return value.toString();
+            }
+            return value;
+        });
+        if (encoded === undefined) {
+            return {};
+        }
+        const decoded = JSON.parse(encoded);
+        if (!isRecord(decoded)) {
+            return {};
+        }
+        return decoded;
+    }
+    catch {
+        return {};
+    }
+}
+function toBase64Payload(value) {
+    if (value === undefined || value.length === 0) {
+        return '';
+    }
+    const bytes = new TextEncoder().encode(value);
+    let binary = '';
+    for (const byte of bytes) {
+        binary += String.fromCharCode(byte);
+    }
+    return btoa(binary);
+}
+function toInt64String(value) {
+    if (value === undefined || Number.isNaN(value) || !Number.isFinite(value)) {
+        return '0';
+    }
+    return Math.trunc(value).toString();
+}
+function toMessageRoleEnum(role) {
+    switch (String(role).trim().toLowerCase()) {
+        case 'assistant':
+            return 'MESSAGE_ROLE_ASSISTANT';
+        case 'tool':
+            return 'MESSAGE_ROLE_TOOL';
+        case 'user':
+        default:
+            return 'MESSAGE_ROLE_USER';
+    }
+}
+function toArtifactKindEnum(kind) {
+    switch (String(kind).trim().toLowerCase()) {
+        case 'request':
+            return 'ARTIFACT_KIND_REQUEST';
+        case 'response':
+            return 'ARTIFACT_KIND_RESPONSE';
+        case 'tools':
+            return 'ARTIFACT_KIND_TOOLS';
+        case 'provider_event':
+            return 'ARTIFACT_KIND_PROVIDER_EVENT';
+        default:
+            return 'ARTIFACT_KIND_UNSPECIFIED';
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/exporters/http.js.map

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

package/dist/hooks.d.ts

@@ -0,0 +1,33 @@
+import type { HookEvaluateRequest, HookEvaluateResponse, HookEvaluation, HooksConfig } from './types.js';
+/**
+ * Thrown by framework adapters when hook evaluation returns `action: 'deny'`.
+ *
+ * The error preserves the rule that triggered the deny and the per-rule
+ * evaluation outcomes so callers can build user-facing error messages.
+ */
+export declare class HookDeniedError extends Error {
+    readonly action: "deny";
+    readonly reason: string;
+    readonly ruleId?: string;
+    readonly evaluations: HookEvaluation[];
+    constructor(reason: string, ruleId?: string, evaluations?: HookEvaluation[]);
+}
+/**
+ * Sends a hook evaluation request to the Sigil API.
+ *
+ * `apiEndpoint` is the Sigil API base URL (without the `/api/v1/...` suffix).
+ * `extraHeaders` is merged into the request — typically the same auth headers
+ * the SDK uses for generation export.
+ *
+ * Returns `{ action: 'allow', evaluations: [] }` when the request fails and
+ * `hooks.failOpen` is true.
+ */
+export declare function evaluateHook(params: {
+    apiEndpoint: string;
+    insecure: boolean;
+    extraHeaders: Record<string, string> | undefined;
+    hooks: HooksConfig;
+    request: HookEvaluateRequest;
+    fetchImpl?: typeof fetch;
+}): Promise<HookEvaluateResponse>;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../js/src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EAEd,WAAW,EAMZ,MAAM,YAAY,CAAC;AAMpB;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,MAAM,EAAG,MAAM,CAAU;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,cAAc,EAAE,CAAC;gBAE3B,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,GAAE,cAAc,EAAO;CAQhF;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACjD,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA2DhC"}