@flowajs/chat-service 0.0.1

package/dist/storage/s3.d.ts

@@ -0,0 +1,29 @@
+import { S3Client } from "@aws-sdk/client-s3";
+import { type Storage } from "./interface.js";
+/**
+ * Env-driven form: chat-service constructs the S3 client with no explicit
+ * config; the AWS SDK resolves credentials, region, and endpoint from its
+ * standard env vars (`AWS_REGION`, `AWS_ENDPOINT_URL_S3`, the
+ * `fromNodeProviderChain` chain, etc.). For S3-compat providers
+ * (Cloudflare R2, Backblaze B2, MinIO, DigitalOcean Spaces, Wasabi,
+ * Hetzner, etc.), set `AWS_ENDPOINT_URL_S3` and `AWS_REGION` in the
+ * environment. For knobs the SDK doesn't expose via env vars (e.g.
+ * `forcePathStyle`, custom retry policy), use the `{ client }`
+ * programmatic form below.
+ */
+export interface S3StorageConfigOptions {
+    bucket: string;
+    prefix?: string;
+}
+/**
+ * Programmatic form: caller hands in a pre-built `S3Client`. Use this
+ * when the deployment needs custom credential minting (OIDC->STS, etc.)
+ * that the default chain does not cover.
+ */
+export interface S3StorageClientOptions {
+    client: S3Client;
+    bucket: string;
+    prefix?: string;
+}
+export declare function createS3Storage(options: S3StorageConfigOptions | S3StorageClientOptions): Storage;
+//# sourceMappingURL=s3.d.ts.map

package/dist/storage/s3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.d.ts","sourceRoot":"","sources":["../../src/storage/s3.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,QAAQ,EACT,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,KAAK,OAAO,EAAwB,MAAM,gBAAgB,CAAC;AAEpE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,sBAAsB,GAAG,sBAAsB,GACvD,OAAO,CAaT"}

package/dist/storage/s3.js

@@ -0,0 +1,109 @@
+import { GetObjectCommand, ListObjectsV2Command, PutObjectCommand, S3Client, } from "@aws-sdk/client-s3";
+import { StorageConflictError } from "./interface.js";
+export function createS3Storage(options) {
+    if ("client" in options) {
+        return makeStorage({
+            client: options.client,
+            bucket: options.bucket,
+            prefix: options.prefix ?? "",
+        });
+    }
+    return makeStorage({
+        client: new S3Client(),
+        bucket: options.bucket,
+        prefix: options.prefix ?? "",
+    });
+}
+function makeStorage({ client, bucket, prefix }) {
+    function fullKey(key) {
+        return prefix + key;
+    }
+    return {
+        prefix,
+        async read(key) {
+            try {
+                const response = await client.send(new GetObjectCommand({ Bucket: bucket, Key: fullKey(key) }));
+                const bytes = await response.Body?.transformToByteArray();
+                return bytes ? Buffer.from(bytes) : null;
+            }
+            catch (error) {
+                if (error.name === "NoSuchKey")
+                    return null;
+                throw error;
+            }
+        },
+        async readText(key) {
+            try {
+                const response = await client.send(new GetObjectCommand({ Bucket: bucket, Key: fullKey(key) }));
+                return (await response.Body?.transformToString()) ?? null;
+            }
+            catch (error) {
+                if (error.name === "NoSuchKey")
+                    return null;
+                throw error;
+            }
+        },
+        async readJson(key) {
+            const text = await this.readText(key);
+            return text ? JSON.parse(text) : null;
+        },
+        async write(key, body) {
+            await client.send(new PutObjectCommand({
+                Bucket: bucket,
+                Key: fullKey(key),
+                Body: body,
+            }));
+        },
+        async writeJson(key, value) {
+            await client.send(new PutObjectCommand({
+                Bucket: bucket,
+                Key: fullKey(key),
+                Body: JSON.stringify(value),
+                ContentType: "application/json",
+            }));
+        },
+        async writeIfAbsent(key, body) {
+            try {
+                await client.send(new PutObjectCommand({
+                    Bucket: bucket,
+                    Key: fullKey(key),
+                    Body: body,
+                    IfNoneMatch: "*",
+                }));
+            }
+            catch (error) {
+                const status = error
+                    .$metadata?.httpStatusCode;
+                if (status === 412) {
+                    throw new StorageConflictError(key);
+                }
+                throw error;
+            }
+        },
+        async exists(key) {
+            const buf = await this.read(key);
+            return buf !== null;
+        },
+        async list(listPrefix) {
+            const out = [];
+            let continuationToken;
+            do {
+                const response = await client.send(new ListObjectsV2Command({
+                    Bucket: bucket,
+                    Prefix: fullKey(listPrefix),
+                    ContinuationToken: continuationToken,
+                }));
+                for (const obj of response.Contents ?? []) {
+                    if (obj.Key) {
+                        out.push(obj.Key.slice(prefix.length));
+                    }
+                }
+                continuationToken = response.IsTruncated
+                    ? response.NextContinuationToken
+                    : undefined;
+            } while (continuationToken);
+            return out.sort();
+        },
+    };
+}
+//# sourceMappingURL=s3.js.map

package/dist/storage/s3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.js","sourceRoot":"","sources":["../../src/storage/s3.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,gBAAgB,EAChB,QAAQ,GACT,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAgB,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AA6BpE,MAAM,UAAU,eAAe,CAC7B,OAAwD;IAExD,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;QACxB,OAAO,WAAW,CAAC;YACjB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;SAC7B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,WAAW,CAAC;QACjB,MAAM,EAAE,IAAI,QAAQ,EAAE;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;KAC7B,CAAC,CAAC;AACL,CAAC;AAQD,SAAS,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAmB;IAC9D,SAAS,OAAO,CAAC,GAAW;QAC1B,OAAO,MAAM,GAAG,GAAG,CAAC;IACtB,CAAC;IAED,OAAO;QACL,MAAM;QAEN,KAAK,CAAC,IAAI,CAAC,GAAG;YACZ,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAChC,IAAI,gBAAgB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAC5D,CAAC;gBACF,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,oBAAoB,EAAE,CAAC;gBAC1D,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC3C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAK,KAA2B,CAAC,IAAI,KAAK,WAAW;oBAAE,OAAO,IAAI,CAAC;gBACnE,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,GAAG;YAChB,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAChC,IAAI,gBAAgB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAC5D,CAAC;gBACF,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,iBAAiB,EAAE,CAAC,IAAI,IAAI,CAAC;YAC5D,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAK,KAA2B,CAAC,IAAI,KAAK,WAAW;oBAAE,OAAO,IAAI,CAAC;gBACnE,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAED,KAAK,CAAC,QAAQ,CAAI,GAAW;YAC3B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YACtC,OAAO,IAAI,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/C,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI;YACnB,MAAM,MAAM,CAAC,IAAI,CACf,IAAI,gBAAgB,CAAC;gBACnB,MAAM,EAAE,MAAM;gBACd,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC;gBACjB,IAAI,EAAE,IAAI;aACX,CAAC,CACH,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE,KAAK;YACxB,MAAM,MAAM,CAAC,IAAI,CACf,IAAI,gBAAgB,CAAC;gBACnB,MAAM,EAAE,MAAM;gBACd,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC;gBACjB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;gBAC3B,WAAW,EAAE,kBAAkB;aAChC,CAAC,CACH,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI;YAC3B,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,IAAI,CACf,IAAI,gBAAgB,CAAC;oBACnB,MAAM,EAAE,MAAM;oBACd,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC;oBACjB,IAAI,EAAE,IAAI;oBACV,WAAW,EAAE,GAAG;iBACjB,CAAC,CACH,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,MAAM,GAAI,KAAqD;qBAClE,SAAS,EAAE,cAAc,CAAC;gBAC7B,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;oBACnB,MAAM,IAAI,oBAAoB,CAAC,GAAG,CAAC,CAAC;gBACtC,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,GAAG;YACd,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACjC,OAAO,GAAG,KAAK,IAAI,CAAC;QACtB,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,UAAU;YACnB,MAAM,GAAG,GAAa,EAAE,CAAC;YACzB,IAAI,iBAAqC,CAAC;YAC1C,GAAG,CAAC;gBACF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAChC,IAAI,oBAAoB,CAAC;oBACvB,MAAM,EAAE,MAAM;oBACd,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC;oBAC3B,iBAAiB,EAAE,iBAAiB;iBACrC,CAAC,CACH,CAAC;gBACF,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;oBAC1C,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;wBACZ,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;oBACzC,CAAC;gBACH,CAAC;gBACD,iBAAiB,GAAG,QAAQ,CAAC,WAAW;oBACtC,CAAC,CAAC,QAAQ,CAAC,qBAAqB;oBAChC,CAAC,CAAC,SAAS,CAAC;YAChB,CAAC,QAAQ,iBAAiB,EAAE;YAC5B,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/storage-keys.d.ts

@@ -0,0 +1,33 @@
+import { type Storage } from "./storage/interface.js";
+/** Percent-encode a DOI for storage keys (matches Python's urllib.parse.quote(doi, safe='')). */
+export declare function encodeDoi(doi: string): string;
+export declare function loadQueryResult(storage: Storage, variantId: string): Promise<{
+    dois: string[];
+} | null>;
+export declare function loadAggregate(storage: Storage, variantId: string): Promise<unknown>;
+export declare function loadExtraction(storage: Storage, variantId: string, doi: string): Promise<unknown>;
+export declare function loadMarkdown(storage: Storage, doi: string): Promise<string | null>;
+export declare function loadPaperMetadata(storage: Storage, doi: string): Promise<Record<string, unknown> | null>;
+export declare function auditLogKey(variantId: string, sessionId: string): string;
+/**
+ * An edit draft as it lives in storage: the bare artifact JSON, plus its
+ * version number parsed from the object key.
+ */
+export interface EditDraft {
+    version: number;
+    /** The artifact JSON body as written, verbatim. */
+    artifactText: string;
+}
+/**
+ * List all edit draft versions for a (variant, category), sorted by version
+ * number ascending. Returns empty array if no drafts exist.
+ */
+export declare function listEditDrafts(storage: Storage, variantId: string, category: string): Promise<EditDraft[]>;
+/**
+ * Write an edit draft version with atomic create-only semantics. If the
+ * target version key already exists (concurrent writer beat us), increment
+ * the version and retry up to `maxRetries` times. The returned version may
+ * therefore be higher than `intendedVersion`.
+ */
+export declare function writeEditDraft(storage: Storage, variantId: string, category: string, artifactText: string, intendedVersion: number, maxRetries?: number): Promise<number>;
+//# sourceMappingURL=storage-keys.d.ts.map

package/dist/storage-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-keys.d.ts","sourceRoot":"","sources":["../src/storage-keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAwB,MAAM,wBAAwB,CAAC;AAE5E,iGAAiG;AACjG,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK7C;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAAC,CAIpC;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAElB;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAExB;AAED,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAEzC;AAMD,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAExE;AAMD;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;CACtB;AAMD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,SAAS,EAAE,CAAC,CAmBtB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACvB,UAAU,SAAI,GACb,OAAO,CAAC,MAAM,CAAC,CAkBjB"}

package/dist/storage-keys.js

@@ -0,0 +1,76 @@
+import { StorageConflictError } from "./storage/interface.js";
+/** Percent-encode a DOI for storage keys (matches Python's urllib.parse.quote(doi, safe='')). */
+export function encodeDoi(doi) {
+    return encodeURIComponent(doi).replace(/[!'()*]/g, (c) => `%${c.charCodeAt(0).toString(16).toUpperCase()}`);
+}
+export async function loadQueryResult(storage, variantId) {
+    return storage.readJson(`assessments/${variantId}/query.json`);
+}
+export async function loadAggregate(storage, variantId) {
+    return storage.readJson(`assessments/${variantId}/aggregation.json`);
+}
+export async function loadExtraction(storage, variantId, doi) {
+    return storage.readJson(`assessments/${variantId}/extractions/${encodeDoi(doi)}.json`);
+}
+export async function loadMarkdown(storage, doi) {
+    return storage.readText(`papers/${encodeDoi(doi)}/markdown.md`);
+}
+export async function loadPaperMetadata(storage, doi) {
+    return storage.readJson(`papers/${encodeDoi(doi)}/metadata.json`);
+}
+// ---------------------------------------------------------------------------
+// Audit log keys
+// ---------------------------------------------------------------------------
+export function auditLogKey(variantId, sessionId) {
+    return `chat-sessions/${variantId}/${sessionId}.json`;
+}
+function editDraftPrefix(variantId, category) {
+    return `edit-drafts/${variantId}/${category}/artifact-v`;
+}
+/**
+ * List all edit draft versions for a (variant, category), sorted by version
+ * number ascending. Returns empty array if no drafts exist.
+ */
+export async function listEditDrafts(storage, variantId, category) {
+    const prefix = editDraftPrefix(variantId, category);
+    const keys = (await storage.list(prefix))
+        .filter((k) => k.startsWith(prefix) && k.endsWith(".json"))
+        .sort((a, b) => {
+        const vA = parseInt(a.slice(prefix.length, -5), 10);
+        const vB = parseInt(b.slice(prefix.length, -5), 10);
+        return vA - vB;
+    });
+    const drafts = await Promise.all(keys.map(async (key) => {
+        const artifactText = await storage.readText(key);
+        if (artifactText === null)
+            return null;
+        const version = parseInt(key.slice(prefix.length, -5), 10);
+        return { version, artifactText };
+    }));
+    return drafts.filter((d) => d !== null);
+}
+/**
+ * Write an edit draft version with atomic create-only semantics. If the
+ * target version key already exists (concurrent writer beat us), increment
+ * the version and retry up to `maxRetries` times. The returned version may
+ * therefore be higher than `intendedVersion`.
+ */
+export async function writeEditDraft(storage, variantId, category, artifactText, intendedVersion, maxRetries = 3) {
+    let version = intendedVersion;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        const key = `${editDraftPrefix(variantId, category)}${version}.json`;
+        try {
+            await storage.writeIfAbsent(key, artifactText);
+            return version;
+        }
+        catch (error) {
+            if (error instanceof StorageConflictError && attempt < maxRetries) {
+                version++;
+                continue;
+            }
+            throw error;
+        }
+    }
+    throw new Error(`Failed to write edit draft after ${maxRetries + 1} attempts`);
+}
+//# sourceMappingURL=storage-keys.js.map

package/dist/storage-keys.js.map

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

package/dist/telemetry.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Telemetry helpers. Pure — no side effects at module load.
+ * The SDK is bootstrapped in instrumentation.ts (loaded via --import);
+ * if it hasn't run, metrics.getMeter() returns a no-op meter.
+ */
+export declare function recordTokenUsage({ model, tokenType, count, }: {
+    model: string;
+    tokenType: "input" | "output";
+    count: number;
+}): void;
+export interface ToolMetricsContext {
+    /** Provider name (`anthropic`, `aws.bedrock`, `gcp.gemini`, `openai`). */
+    providerName: string;
+}
+/**
+ * Wrap a tool's `execute` with duration instrumentation. The provider name
+ * is parameterized so each provider self-labels its own metrics.
+ */
+export declare function withToolMetrics<Args, Result>(context: ToolMetricsContext, name: string, execute: (args: Args) => Promise<Result>): (args: Args) => Promise<Result>;
+export type ValidationRule = "paper_id_duplicate" | "paper_id_unknown_in_mapping" | "claim_paper_missing" | "claims_not_contiguous" | "claims_group_order" | "cite_unknown_paper_id" | "cite_missing_quote" | "cite_quote_mismatch";
+export declare function recordValidationError(rule: ValidationRule): void;
+export declare function recordToolValidationFailure(tool: "str_replace" | "insert" | "write"): void;
+export declare function recordStorageWriteFailure(): void;
+export declare function recordCachedInputTokens({ model, type, count, }: {
+    model: string;
+    type: "read" | "write";
+    count: number;
+}): void;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAsBH,wBAAgB,gBAAgB,CAAC,EAC/B,KAAK,EACL,SAAS,EACT,KAAK,GACN,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,IAAI,CAKP;AAsBD,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAC;CACtB;AAYD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAC1C,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,GACvC,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CA2BjC;AAcD,MAAM,MAAM,cAAc,GACtB,oBAAoB,GACpB,6BAA6B,GAC7B,qBAAqB,GACrB,uBAAuB,GACvB,oBAAoB,GACpB,uBAAuB,GACvB,oBAAoB,GACpB,qBAAqB,CAAC;AAE1B,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAEhE;AAUD,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,aAAa,GAAG,QAAQ,GAAG,OAAO,GACvC,IAAI,CAEN;AAUD,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAcD,wBAAgB,uBAAuB,CAAC,EACtC,KAAK,EACL,IAAI,EACJ,KAAK,GACN,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,IAAI,CAKP"}

package/dist/telemetry.js

@@ -0,0 +1,116 @@
+/**
+ * Telemetry helpers. Pure — no side effects at module load.
+ * The SDK is bootstrapped in instrumentation.ts (loaded via --import);
+ * if it hasn't run, metrics.getMeter() returns a no-op meter.
+ */
+import { metrics } from "@opentelemetry/api";
+const meter = metrics.getMeter("chat-service");
+// ---------------------------------------------------------------------------
+// Token usage histogram
+// https://opentelemetry.io/docs/specs/semconv/gen-ai/gen-ai-metrics/
+// ---------------------------------------------------------------------------
+const tokenHistogram = meter.createHistogram("gen_ai.client.token.usage", {
+    description: "Number of input and output tokens used",
+    unit: "{token}",
+    advice: {
+        explicitBucketBoundaries: [
+            1, 4, 16, 64, 256, 1024, 4096, 16384, 65536, 262144, 1048576, 4194304,
+            16777216, 67108864,
+        ],
+    },
+});
+export function recordTokenUsage({ model, tokenType, count, }) {
+    tokenHistogram.record(count, {
+        "gen_ai.token.type": tokenType,
+        "gen_ai.response.model": model,
+    });
+}
+// ---------------------------------------------------------------------------
+// Tool-execution duration histogram
+// Reuses the shared operation-duration histogram with
+// gen_ai.operation.name="execute_tool" per OTel GenAI semconv.
+// ---------------------------------------------------------------------------
+const operationDurationHistogram = meter.createHistogram("gen_ai.client.operation.duration", {
+    description: "GenAI operation duration.",
+    unit: "s",
+    advice: {
+        explicitBucketBoundaries: [
+            0.01, 0.02, 0.04, 0.08, 0.16, 0.32, 0.64, 1.28, 2.56, 5.12, 10.24,
+            20.48, 40.96, 81.92,
+        ],
+    },
+});
+// Tools in chat.ts signal curator-visible failures by returning
+// `{ error: "..." }` or `{ is_error: true }` rather than throwing.
+function isToolErrorResult(result) {
+    if (result === null || typeof result !== "object" || Array.isArray(result)) {
+        return false;
+    }
+    const r = result;
+    return Boolean(r.error) || r.is_error === true;
+}
+/**
+ * Wrap a tool's `execute` with duration instrumentation. The provider name
+ * is parameterized so each provider self-labels its own metrics.
+ */
+export function withToolMetrics(context, name, execute) {
+    const baseAttrs = {
+        "gen_ai.operation.name": "execute_tool",
+        "gen_ai.provider.name": context.providerName,
+        "gen_ai.tool.name": name,
+    };
+    return async (args) => {
+        const start = performance.now();
+        try {
+            const result = await execute(args);
+            const duration = (performance.now() - start) / 1000;
+            operationDurationHistogram.record(duration, isToolErrorResult(result)
+                ? { ...baseAttrs, "error.type": "tool_error" }
+                : baseAttrs);
+            return result;
+        }
+        catch (err) {
+            const duration = (performance.now() - start) / 1000;
+            operationDurationHistogram.record(duration, {
+                ...baseAttrs,
+                "error.type": "exception",
+            });
+            throw err;
+        }
+    };
+}
+// ---------------------------------------------------------------------------
+// Validation + storage failure counters
+// ---------------------------------------------------------------------------
+const validationErrorCounter = meter.createCounter("chat_validation_errors_total", {
+    description: "Count of individual rule violations found by validateArtifactContent",
+});
+export function recordValidationError(rule) {
+    validationErrorCounter.add(1, { rule });
+}
+const toolValidationFailureCounter = meter.createCounter("chat_tool_validation_failures_total", {
+    description: "Count of tool invocations rejected by validateAndCommit (parse, schema, or content-validation errors)",
+});
+export function recordToolValidationFailure(tool) {
+    toolValidationFailureCounter.add(1, { tool });
+}
+const storageWriteFailureCounter = meter.createCounter("chat_storage_write_failures_total", {
+    description: "Count of writeEditDraft failures that terminated the chat stream with an error",
+});
+export function recordStorageWriteFailure() {
+    storageWriteFailureCounter.add(1);
+}
+// ---------------------------------------------------------------------------
+// Cached-input-tokens counter
+// ---------------------------------------------------------------------------
+const cachedInputTokensCounter = meter.createCounter("gen_ai.client.token.cached_input", {
+    description: "Input tokens served from / written to provider prompt cache",
+    unit: "{token}",
+});
+export function recordCachedInputTokens({ model, type, count, }) {
+    cachedInputTokensCounter.add(count, {
+        "gen_ai.cache.type": type,
+        "gen_ai.response.model": model,
+    });
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

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

package/dist/yaml.d.ts

@@ -0,0 +1,42 @@
+/** YAML serialization for artifact editing — eliminates JSON escaping issues. */
+import type { Artifact } from "./artifact.js";
+type Bbox = {
+    page: number;
+    top: number;
+    left: number;
+    bottom: number;
+    right: number;
+};
+export type BboxCache = Map<string, Bbox[]>;
+/** Extract (paperId, quote) → bboxes lookup from an artifact JSON string. */
+export declare function buildBboxCache(jsonStr: string): BboxCache;
+/** Reattach cached bboxes to citations with matching (paperId, quote). Generic
+ *  over the artifact type so deployment-specific fields survive the rebuild. */
+export declare function reattachBboxes<T extends Artifact>(artifact: T, cache: BboxCache): T;
+/** Convert an artifact JSON string to YAML, stripping bboxes from claim citations. */
+export declare function artifactToYaml(jsonStr: string): string;
+/** Parse a YAML artifact string back to a JS object. */
+export declare function parseArtifactYaml(yamlStr: string): unknown;
+/** Add 1-indexed line numbers to YAML for display. */
+export declare function addLineNumbers(yamlStr: string): string;
+/**
+ * Extract a line range from YAML and return with line numbers.
+ * Uses 1-indexed lines; end=-1 means end of file.
+ */
+export declare function viewRange(yamlStr: string, start: number, end: number): string;
+/**
+ * Find lines containing a literal substring. Returns matches with one line
+ * of context either side; adjacent or overlapping blocks are merged and
+ * separated by "--".
+ */
+export declare function searchArtifact(yamlStr: string, pattern: string): {
+    output: string;
+    count: number;
+};
+/**
+ * Insert text after a specific line number (1-indexed).
+ * Line 0 means insert at the beginning.
+ */
+export declare function insertAtLine(yamlStr: string, insertLine: number, insertText: string): string;
+export {};
+//# sourceMappingURL=yaml.d.ts.map

package/dist/yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.d.ts","sourceRoot":"","sources":["../src/yaml.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAGjF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAM9C,KAAK,IAAI,GAAG;IACV,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAM5C,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAWzD;AAED;gFACgF;AAChF,wBAAgB,cAAc,CAAC,CAAC,SAAS,QAAQ,EAC/C,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,SAAS,GACf,CAAC,CAWH;AAMD,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAatD;AAED,wDAAwD;AACxD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE1D;AAMD,sDAAsD;AACtD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAS7E;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA0BnC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR"}

package/dist/yaml.js

@@ -0,0 +1,121 @@
+/** YAML serialization for artifact editing — eliminates JSON escaping issues. */
+import yaml from "yaml";
+function cacheKey(paperId, quote) {
+    return `${paperId}\n${quote}`;
+}
+/** Extract (paperId, quote) → bboxes lookup from an artifact JSON string. */
+export function buildBboxCache(jsonStr) {
+    const cache = new Map();
+    const art = JSON.parse(jsonStr);
+    for (const claim of art.claims ?? []) {
+        for (const citation of claim.citations ?? []) {
+            if (citation.bboxes?.length) {
+                cache.set(cacheKey(claim.paper_id, citation.quote), citation.bboxes);
+            }
+        }
+    }
+    return cache;
+}
+/** Reattach cached bboxes to citations with matching (paperId, quote). Generic
+ *  over the artifact type so deployment-specific fields survive the rebuild. */
+export function reattachBboxes(artifact, cache) {
+    return {
+        ...artifact,
+        claims: artifact.claims.map((claim) => ({
+            ...claim,
+            citations: claim.citations.map((citation) => {
+                const bboxes = cache.get(cacheKey(claim.paper_id, citation.quote));
+                return bboxes ? { ...citation, bboxes } : citation;
+            }),
+        })),
+    };
+}
+// ---------------------------------------------------------------------------
+// YAML serialization
+// ---------------------------------------------------------------------------
+/** Convert an artifact JSON string to YAML, stripping bboxes from claim citations. */
+export function artifactToYaml(jsonStr) {
+    const art = JSON.parse(jsonStr);
+    if (Array.isArray(art.claims)) {
+        art.claims = art.claims.map((claim) => {
+            const citations = Array.isArray(claim.citations)
+                ? claim.citations.map(({ bboxes: _bboxes, ...rest }) => rest)
+                : claim.citations;
+            return { ...claim, citations };
+        });
+    }
+    return yaml.stringify(art, { lineWidth: 0 });
+}
+/** Parse a YAML artifact string back to a JS object. */
+export function parseArtifactYaml(yamlStr) {
+    return yaml.parse(yamlStr);
+}
+// ---------------------------------------------------------------------------
+// Line-numbered display (mirrors Claude's text editor tool)
+// ---------------------------------------------------------------------------
+/** Add 1-indexed line numbers to YAML for display. */
+export function addLineNumbers(yamlStr) {
+    const lines = yamlStr.split("\n");
+    const width = String(lines.length).length;
+    return lines
+        .map((line, i) => `${String(i + 1).padStart(width)}\t${line}`)
+        .join("\n");
+}
+/**
+ * Extract a line range from YAML and return with line numbers.
+ * Uses 1-indexed lines; end=-1 means end of file.
+ */
+export function viewRange(yamlStr, start, end) {
+    const lines = yamlStr.split("\n");
+    const s = Math.max(1, start);
+    const e = end === -1 ? lines.length : Math.min(end, lines.length);
+    const width = String(e).length;
+    return lines
+        .slice(s - 1, e)
+        .map((line, i) => `${String(s + i).padStart(width)}\t${line}`)
+        .join("\n");
+}
+/**
+ * Find lines containing a literal substring. Returns matches with one line
+ * of context either side; adjacent or overlapping blocks are merged and
+ * separated by "--".
+ */
+export function searchArtifact(yamlStr, pattern) {
+    if (!pattern)
+        return { output: "", count: 0 };
+    const lines = yamlStr.split("\n");
+    const hits = [];
+    for (let i = 0; i < lines.length; i++) {
+        if (lines[i]?.includes(pattern))
+            hits.push(i);
+    }
+    if (hits.length === 0)
+        return { output: "", count: 0 };
+    const ranges = [];
+    for (const i of hits) {
+        const start = Math.max(0, i - 1);
+        const end = Math.min(lines.length - 1, i + 1);
+        const last = ranges[ranges.length - 1];
+        if (last && start <= last[1] + 1)
+            last[1] = Math.max(last[1], end);
+        else
+            ranges.push([start, end]);
+    }
+    const width = String(lines.length).length;
+    const blocks = ranges.map(([s, e]) => lines
+        .slice(s, e + 1)
+        .map((line, i) => `${String(s + 1 + i).padStart(width)}\t${line}`)
+        .join("\n"));
+    return { output: blocks.join("\n--\n"), count: hits.length };
+}
+/**
+ * Insert text after a specific line number (1-indexed).
+ * Line 0 means insert at the beginning.
+ */
+export function insertAtLine(yamlStr, insertLine, insertText) {
+    const lines = yamlStr.split("\n");
+    const idx = Math.max(0, Math.min(insertLine, lines.length));
+    lines.splice(idx, 0, ...insertText.split("\n"));
+    return lines.join("\n");
+}
+//# sourceMappingURL=yaml.js.map

package/dist/yaml.js.map

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