studiograph 1.3.48-next.21 → 1.3.48-next.211

package/dist/services/cloud-inference-billing.js

@@ -0,0 +1,313 @@
+import { randomUUID } from 'node:crypto';
+import { createAssistantMessageEventStream, } from '@mariozechner/pi-ai';
+const DEFAULT_ESTIMATE_CENTS = 100;
+export function createInferenceUsageSummary() {
+    return {
+        inputTokens: 0,
+        outputTokens: 0,
+        totalTokens: 0,
+        totalCostUsd: 0,
+    };
+}
+export function addInferenceUsage(summary, usage) {
+    if (!usage || typeof usage !== 'object')
+        return;
+    const u = usage;
+    const input = numberOrZero(u.input) + numberOrZero(u.cacheRead) + numberOrZero(u.cacheWrite);
+    const output = numberOrZero(u.output);
+    summary.inputTokens += input;
+    summary.outputTokens += output;
+    summary.totalTokens += numberOrZero(u.totalTokens) || input + output;
+    summary.totalCostUsd += numberOrZero(u.cost?.total);
+}
+export function inferenceUsageToBillableCents(summary) {
+    if (summary.totalCostUsd <= 0)
+        return null;
+    return Math.max(1, Math.ceil(summary.totalCostUsd * 100));
+}
+export function createCloudInferenceBillingClient(env = process.env, fetchFn = fetch) {
+    return new CloudInferenceBillingClient(loadCloudConfig(env), fetchFn);
+}
+export function isStudiographCreditsMode(env = process.env) {
+    return env.STUDIOGRAPH_AI_MODE === 'studiograph_credits';
+}
+export function studiographCreditsModel(env = process.env) {
+    return {
+        id: env.STUDIOGRAPH_CLOUD_MODEL_ID?.trim() || 'studiograph-credits',
+        name: 'Studiograph Credits',
+        api: 'studiograph-cloud-inference',
+        provider: 'studiograph-cloud',
+        baseUrl: trimTrailingSlash(env.STUDIOGRAPH_CLOUD_URL) || '',
+        reasoning: true,
+        input: ['text', 'image'],
+        cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
+        contextWindow: 200000,
+        maxTokens: 8192,
+    };
+}
+export function createCloudInferenceStreamFn(env = process.env, fetchFn = fetch) {
+    const client = new CloudInferenceBillingClient(loadCloudConfig(env), fetchFn);
+    return (_model, context, options) => {
+        return client.streamChat(context, options);
+    };
+}
+export class CloudInferenceBillingClient {
+    loaded;
+    fetchFn;
+    constructor(loaded, fetchFn) {
+        this.loaded = loaded;
+        this.fetchFn = fetchFn;
+    }
+    isConfigured() {
+        return Boolean(this.loaded.config);
+    }
+    isRequired() {
+        return this.loaded.required;
+    }
+    disabledReason() {
+        return this.loaded.disabledReason;
+    }
+    estimateCents() {
+        return this.loaded.config?.estimateCents ?? DEFAULT_ESTIMATE_CENTS;
+    }
+    nextRequestId(prefix = 'chat') {
+        return `sg_${prefix}_${Date.now()}_${randomUUID()}`;
+    }
+    async getAiSettings() {
+        const config = this.requireConfigOrNull();
+        if (!config)
+            return null;
+        return this.requestJson('GET', this.runtimePath(config, '/ai'));
+    }
+    async reserve(input) {
+        const config = this.requireConfigOrNull();
+        if (!config)
+            return null;
+        const response = await this.requestJson('POST', this.runtimePath(config, '/inference-reservations'), {
+            estimatedCents: input.estimatedCents ?? config.estimateCents,
+            provider: input.provider ?? undefined,
+            model: input.model ?? undefined,
+            requestId: input.requestId ?? this.nextRequestId(),
+            description: input.description ?? 'Hosted Studiograph chat inference.',
+        });
+        return response.reservation;
+    }
+    async settle(reservation, input) {
+        const config = this.requireConfigOrNull();
+        if (!config)
+            return;
+        await this.requestJson('POST', this.runtimePath(config, `/inference-reservations/${encodeURIComponent(reservation.id)}/settle`), {
+            actualCents: input.actualCents,
+            inputTokens: input.inputTokens,
+            outputTokens: input.outputTokens,
+            description: input.description,
+        });
+    }
+    async release(reservation, reason) {
+        const config = this.requireConfigOrNull();
+        if (!config)
+            return;
+        await this.requestJson('POST', this.runtimePath(config, `/inference-reservations/${encodeURIComponent(reservation.id)}/release`), { reason });
+    }
+    streamChat(context, options) {
+        const stream = createAssistantMessageEventStream();
+        void this.runStreamChat(stream, context, options);
+        return stream;
+    }
+    requireConfigOrNull() {
+        if (this.loaded.config)
+            return this.loaded.config;
+        if (this.loaded.required) {
+            throw new Error(`Studiograph Cloud billing is required but not configured: ${this.loaded.disabledReason}`);
+        }
+        return null;
+    }
+    runtimePath(config, suffix) {
+        const orgId = encodeURIComponent(config.orgId);
+        const workspaceId = encodeURIComponent(config.workspaceId);
+        return `/api/runtime/orgs/${orgId}/workspaces/${workspaceId}${suffix}`;
+    }
+    async runStreamChat(stream, context, options) {
+        try {
+            const config = this.requireConfigOrNull();
+            if (!config)
+                throw new Error('Studiograph Cloud inference is not configured.');
+            const requestStartedAt = Date.now();
+            const response = await this.fetchFn(`${config.baseUrl}${this.runtimePath(config, '/inference/chat')}`, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${config.token}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    requestId: this.nextRequestId('chat'),
+                    context,
+                    stream: true,
+                    options: sanitizeStreamOptions(options),
+                }),
+                signal: options?.signal,
+            });
+            if (!response.ok) {
+                const json = await response.json().catch(() => ({}));
+                const message = typeof json === 'object' && json && 'error' in json
+                    ? String(json.error)
+                    : `${response.status} ${response.statusText}`;
+                throw new Error(`Studiograph Cloud inference request failed: ${message}`);
+            }
+            const reader = response.body?.getReader();
+            if (!reader)
+                throw new Error('Studiograph Cloud inference response did not include a stream.');
+            const decoder = new TextDecoder();
+            let buffer = '';
+            let firstEventAt = null;
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const frames = buffer.split('\n\n');
+                buffer = frames.pop() ?? '';
+                for (const frame of frames) {
+                    const event = parseSseDataFrame(frame);
+                    if (!event)
+                        continue;
+                    if (!firstEventAt && event.type === 'text_delta') {
+                        firstEventAt = Date.now();
+                        // Keep local latency visibility near the request origin without
+                        // changing the public chat SSE event shape.
+                        console.info(`[cloud-inference] first token received after ${firstEventAt - requestStartedAt}ms`);
+                    }
+                    stream.push(event);
+                }
+            }
+        }
+        catch (err) {
+            stream.push(createLocalErrorEvent(err));
+        }
+    }
+    async requestJson(method, path, body) {
+        const config = this.requireConfigOrNull();
+        if (!config)
+            throw new Error('Studiograph Cloud billing is not configured.');
+        const response = await this.fetchFn(`${config.baseUrl}${path}`, {
+            method,
+            headers: {
+                Authorization: `Bearer ${config.token}`,
+                ...(body ? { 'Content-Type': 'application/json' } : {}),
+            },
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        const json = await response.json().catch(() => ({}));
+        if (!response.ok) {
+            const message = typeof json === 'object' && json && 'error' in json
+                ? String(json.error)
+                : `${response.status} ${response.statusText}`;
+            throw new Error(`Studiograph Cloud billing request failed: ${message}`);
+        }
+        return json;
+    }
+}
+function loadCloudConfig(env) {
+    const required = parseBoolean(env.STUDIOGRAPH_CLOUD_BILLING_REQUIRED);
+    const baseUrl = trimTrailingSlash(env.STUDIOGRAPH_CLOUD_URL);
+    const orgId = env.STUDIOGRAPH_CLOUD_ORG_ID?.trim();
+    const workspaceId = env.STUDIOGRAPH_CLOUD_WORKSPACE_ID?.trim();
+    const token = env.STUDIOGRAPH_CLOUD_TOKEN?.trim();
+    const estimateCents = parsePositiveInt(env.STUDIOGRAPH_CLOUD_INFERENCE_ESTIMATE_CENTS) ?? DEFAULT_ESTIMATE_CENTS;
+    const missing = [
+        !baseUrl ? 'STUDIOGRAPH_CLOUD_URL' : '',
+        !orgId ? 'STUDIOGRAPH_CLOUD_ORG_ID' : '',
+        !workspaceId ? 'STUDIOGRAPH_CLOUD_WORKSPACE_ID' : '',
+        !token ? 'STUDIOGRAPH_CLOUD_TOKEN' : '',
+    ].filter(Boolean);
+    if (missing.length > 0) {
+        return {
+            config: null,
+            required,
+            disabledReason: `missing ${missing.join(', ')}`,
+        };
+    }
+    return {
+        required,
+        disabledReason: null,
+        config: {
+            baseUrl,
+            orgId: orgId,
+            workspaceId: workspaceId,
+            token: token,
+            required,
+            estimateCents,
+        },
+    };
+}
+function trimTrailingSlash(value) {
+    return value?.trim().replace(/\/+$/, '') ?? '';
+}
+function parseBoolean(value) {
+    if (!value)
+        return false;
+    return ['1', 'true', 'yes', 'on'].includes(value.trim().toLowerCase());
+}
+function sanitizeStreamOptions(options) {
+    if (!options)
+        return {};
+    return {
+        temperature: options.temperature,
+        maxTokens: options.maxTokens,
+        reasoning: options.reasoning,
+        thinkingBudgets: options.thinkingBudgets,
+        cacheRetention: options.cacheRetention,
+        sessionId: options.sessionId,
+        metadata: options.metadata,
+    };
+}
+function parseSseDataFrame(frame) {
+    const data = frame
+        .split(/\r?\n/)
+        .filter((line) => line.startsWith('data: '))
+        .map((line) => line.slice('data: '.length))
+        .join('\n');
+    if (!data)
+        return null;
+    try {
+        return JSON.parse(data);
+    }
+    catch {
+        return null;
+    }
+}
+function createLocalErrorEvent(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+        type: 'error',
+        reason: 'error',
+        error: {
+            role: 'assistant',
+            content: [{ type: 'text', text: message }],
+            api: 'studiograph-cloud-inference',
+            provider: 'studiograph-cloud',
+            model: 'studiograph-credits',
+            usage: {
+                input: 0,
+                output: 0,
+                cacheRead: 0,
+                cacheWrite: 0,
+                totalTokens: 0,
+                cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
+            },
+            stopReason: 'error',
+            errorMessage: message,
+            timestamp: Date.now(),
+        },
+    };
+}
+function parsePositiveInt(value) {
+    if (!value)
+        return null;
+    const parsed = Number.parseInt(value, 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : null;
+}
+function numberOrZero(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : 0;
+}
+//# sourceMappingURL=cloud-inference-billing.js.map

package/dist/services/cloud-inference-billing.js.map

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

package/dist/services/comment-service.d.ts

@@ -0,0 +1,97 @@
+import type { AuthUser } from './auth-service.js';
+export type CommentAuthorRole = 'user' | 'agent';
+export interface Comment {
+    commentId: string;
+    repo: string;
+    entryType: string;
+    entryId: string;
+    threadId: string;
+    parentId: string | null;
+    authorUserId: number;
+    authorDisplayName: string;
+    authorRole: CommentAuthorRole;
+    body: string;
+    /** Base64 of the serialized Yjs RelativePosition pair, or null for entry-level threads. */
+    anchorRelpos: string | null;
+    anchorQuote: string | null;
+    mentions: AuthUser[];
+    createdAt: string;
+    updatedAt: string | null;
+    resolvedAt: string | null;
+    resolvedByUserId: number | null;
+    edited: 0 | 1;
+    editHistory: Array<{
+        at: string;
+        body: string;
+    }>;
+    deletedAt: string | null;
+}
+export interface CreateCommentInput {
+    repo: string;
+    entryType: string;
+    entryId: string;
+    authorUserId: number;
+    authorDisplayName: string;
+    authorRole?: CommentAuthorRole;
+    body: string;
+    anchorRelpos?: string | null;
+    anchorQuote?: string | null;
+    mentions?: AuthUser[];
+    /** If provided, this comment is a reply within an existing thread. */
+    parentId?: string | null;
+    threadId?: string | null;
+}
+export interface ListCommentsOpts {
+    repo?: string;
+    entryType?: string;
+    entryId?: string;
+    resolved?: boolean;
+    includeDeleted?: boolean;
+    limit?: number;
+}
+/** Largest comment body the service will accept. Above this the route
+ *  returns 413 — Fastify bodyLimit is the outer 10MB wall, this is the
+ *  per-comment policy ceiling. */
+export declare const MAX_BODY_LENGTH: number;
+export declare const MAX_ANCHOR_RELPOS_LENGTH: number;
+/** Sentinel author_user_id used for agent-authored comments. The auth.db
+ *  users table is AUTOINCREMENT (starts at 1), so id=0 can never collide
+ *  with a real user. */
+export declare const AGENT_AUTHOR_USER_ID = 0;
+/** Thrown by create() when body or anchor_relpos exceeds the ceiling. */
+export declare class CommentTooLargeError extends Error {
+    constructor(message: string);
+}
+/** Thrown by create() when a cell (JSON) anchor is malformed, or when a JSON
+ *  cell anchor is attached to a non-dataset entry (markdown comments only ever
+ *  carry a base64 text relpos or a null entry-level anchor). The route maps it
+ *  to HTTP 400. */
+export declare class InvalidCellAnchorError extends Error {
+    constructor(message: string);
+}
+export declare class CommentService {
+    private db;
+    constructor(workspacePath: string);
+    /**
+     * Idempotent: each migration step is guarded by the recorded
+     * `schema_version` in `meta`. Add a new branch when bumping
+     * `SCHEMA_VERSION`; never edit existing branches.
+     */
+    private runMigrations;
+    create(input: CreateCommentInput): Comment;
+    getById(commentId: string): Comment | null;
+    /** Batch lookup used by the notifications route to enrich each notification
+     *  with its source comment's entry coords. Returns a map keyed by commentId
+     *  so callers can do a single pass. Missing ids are absent from the map. */
+    getByIds(commentIds: string[]): Map<string, Comment>;
+    list(opts?: ListCommentsOpts): Comment[];
+    edit(commentId: string, body: string, editorUserId: number): Comment | null;
+    resolve(commentId: string, resolverUserId: number): Comment | null;
+    reopen(commentId: string): Comment | null;
+    /** Soft-delete: keeps thread continuity, blanks the visible body but
+     *  preserves the original in edit_history so a future audit/restore
+     *  path has something to recover. */
+    softDelete(commentId: string, requesterUserId: number): Comment | null;
+    close(): void;
+    private toComment;
+}