@coffer-org/server 2.2.2 → 2.3.1

package/dist/entity-schema.js

@@ -161,6 +161,7 @@ export const ThreadMessageSchema = new EntitySchema({
         role: { type: 'text' },
         sender: { type: 'text', nullable: true },
         text: { type: 'text' },
+        attachments: { type: 'text', nullable: true },
         ts: { type: 'integer' },
         reply_to_id: { type: 'text', nullable: true },
     },

package/dist/mcp-tools.d.ts

@@ -16,7 +16,6 @@ export interface McpToolDef {
 }
 export interface RagDeps {
     embeddingApiKey: string;
-    topK: number;
 }
 export declare function formatHits(hits: EmbeddingHit[]): string;
 export declare function resolveRagDeps(): Promise<RagDeps | null>;

package/dist/mcp-tools.js

@@ -16,6 +16,7 @@ import { getLogger } from "./log.js";
 import { writePluginSettings, listSettings } from "./settings-write.js";
 import { ValidationError, NotFoundError } from "./mutate.js";
 const log = getLogger('mcp-tools');
+const DEFAULT_RAG_TOP_K = 5;
 export function formatHits(hits) {
     if (hits.length === 0)
         return 'No matching records.';
@@ -31,10 +32,9 @@ export async function resolveRagDeps() {
     const db = (await getPluginSettings('claude-agent'));
     const enabled = db['rag_enabled'] !== false;
     const embeddingApiKey = (process.env.OPENAI_API_KEY ?? db['openai_api_key'] ?? '');
-    const topK = 5;
     if (!enabled || !embeddingApiKey)
         return null;
-    return { embeddingApiKey, topK };
+    return { embeddingApiKey };
 }
 export async function collectMcpTools(opts = {}) {
     const out = [];
@@ -127,7 +127,7 @@ export async function collectMcpTools(opts = {}) {
         }
     }
     if (opts.rag) {
-        const { embeddingApiKey, topK } = opts.rag;
+        const { embeddingApiKey } = opts.rag;
         out.push({
             server: 'rag',
             bareName: 'search_records',
@@ -139,7 +139,7 @@ export async function collectMcpTools(opts = {}) {
             handler: async (args) => {
                 try {
                     const { vector } = await embedOne(args.query, embeddingApiKey);
-                    const hits = await searchEmbeddings(vector, args.k ?? topK);
+                    const hits = await searchEmbeddings(vector, args.k ?? DEFAULT_RAG_TOP_K);
                     return { content: [{ type: 'text', text: formatHits(hits) }] };
                 }
                 catch (e) {

package/dist/plugin-updates.d.ts

@@ -1,5 +1,7 @@
 import type { PluginAssetRecord } from './plugin-discovery.ts';
-export declare function checkLatestVersion(pkgName: string): Promise<string | null>;
+export declare function checkLatestVersion(pkgName: string, opts?: {
+    force?: boolean;
+}): Promise<string | null>;
 export type UpdateTarget = {
     ok: true;
     packageName: string;

package/dist/plugin-updates.js

@@ -14,12 +14,12 @@ function readCache(raw) {
         return null;
     }
 }
-export async function checkLatestVersion(pkgName) {
+export async function checkLatestVersion(pkgName, opts = {}) {
     const key = stateKey(pkgName);
     let cached = null;
     try {
         cached = readCache(await getPluginState(STATE_PLUGIN, key));
-        if (cached && Date.now() - cached.checkedAt < TTL_MS)
+        if (!opts.force && cached && Date.now() - cached.checkedAt < TTL_MS)
             return cached.latestVersion;
         const res = await fetch(`https://registry.npmjs.org/${pkgName}/latest`, { signal: AbortSignal.timeout(5000) });
         if (!res.ok)

package/dist/plugins-api.d.ts

@@ -15,5 +15,5 @@ export interface PluginListEntry {
     web?: string;
     css?: string;
 }
-export declare function buildPluginListResponse(plugins: PluginManifest[], assets: PluginAssetRecord[], disabled: Set<string>, withUpdates?: boolean): Promise<PluginListEntry[]>;
+export declare function buildPluginListResponse(plugins: PluginManifest[], assets: PluginAssetRecord[], disabled: Set<string>, withUpdates?: boolean, forceUpdates?: boolean): Promise<PluginListEntry[]>;
 export declare function registerPluginsApi(app: FastifyInstance): Promise<void>;

package/dist/plugins-api.js

@@ -5,14 +5,14 @@ import { getPlugins, readDisabled } from "./plugin-runtime.js";
 import { checkLatestVersion } from "./plugin-updates.js";
 const nmRoot = () => join(process.cwd(), 'node_modules');
 const ASSET_KEY = { 'schema.js': 'schema', 'web.js': 'web', 'web.css': 'css' };
-export async function buildPluginListResponse(plugins, assets, disabled, withUpdates = true) {
+export async function buildPluginListResponse(plugins, assets, disabled, withUpdates = true, forceUpdates = false) {
     const assetById = new Map(assets.map((a) => [a.id, a]));
     return Promise.all(plugins.map(async (p) => {
         const a = assetById.get(p.id);
         return {
             id: p.id,
             installedVersion: a?.version ?? p.version,
-            latestVersion: withUpdates && a && !a.local ? await checkLatestVersion(a.packageName) : null,
+            latestVersion: withUpdates && a && !a.local ? await checkLatestVersion(a.packageName, { force: forceUpdates }) : null,
             packageName: a?.packageName ?? null,
             dependsOn: p.dependsOn,
             enabled: !disabled.has(p.id),
@@ -27,15 +27,18 @@ export async function buildPluginListResponse(plugins, assets, disabled, withUpd
 }
 export async function registerPluginsApi(app) {
     app.get('/api/plugins', async (req) => {
-        const withUpdates = req.query.updates === '1';
+        const query = req.query;
+        const withUpdates = query.updates === '1';
+        const forceUpdates = query.refresh === '1';
         const [plugins, assets, disabled] = await Promise.all([getPlugins(), discoverPluginAssets(), readDisabled()]);
-        return buildPluginListResponse(plugins, assets, disabled, withUpdates);
+        return buildPluginListResponse(plugins, assets, disabled, withUpdates, forceUpdates);
     });
-    app.get('/api/runtime', async () => {
+    app.get('/api/runtime', async (req) => {
         const runtime = await discoverRuntime();
         if (!runtime)
             return { installedVersion: null, latestVersion: null };
-        const latestVersion = runtime.local ? null : await checkLatestVersion(runtime.packageName);
+        const forceUpdates = req.query.refresh === '1';
+        const latestVersion = runtime.local ? null : await checkLatestVersion(runtime.packageName, { force: forceUpdates });
         return { installedVersion: runtime.installedVersion, latestVersion };
     });
     app.get('/plugins/:id/:file', async (req, reply) => {

package/dist/thread-store.d.ts

@@ -3,9 +3,16 @@ export interface StoredMsg {
     role: 'user' | 'assistant' | 'reasoning';
     sender: string | null;
     text: string;
+    attachments?: StoredAttachment[];
     ts: number;
     replyToId: string | null;
 }
+export interface StoredAttachment {
+    name: string;
+    mime?: string;
+    size?: number;
+    label?: string;
+}
 export interface ThreadChat {
     chatId: string;
     lastTs: number;
@@ -19,6 +26,7 @@ export declare function putThreadMessage(m: {
     msgId: string;
     role: 'user' | 'assistant' | 'reasoning';
     sender?: string | null;
+    attachments?: StoredAttachment[];
     text: string;
     ts: number;
     replyToId: string | null;

package/dist/thread-store.js

@@ -1,6 +1,27 @@
 import { getEm } from "./db.js";
 function toStored(r) {
-    return { msgId: r.msg_id, role: r.role, sender: r.sender, text: r.text, ts: r.ts, replyToId: r.reply_to_id };
+    let attachments;
+    if (r.attachments) {
+        try {
+            const parsed = JSON.parse(r.attachments);
+            if (Array.isArray(parsed)) {
+                const valid = parsed.filter((v) => typeof v === 'object' && v !== null && typeof v.name === 'string');
+                if (valid.length)
+                    attachments = valid;
+            }
+        }
+        catch {
+        }
+    }
+    return {
+        msgId: r.msg_id,
+        role: r.role,
+        sender: r.sender,
+        text: r.text,
+        ...(attachments ? { attachments } : {}),
+        ts: r.ts,
+        replyToId: r.reply_to_id,
+    };
 }
 export async function getThreadMessage(connector, chatId, msgId) {
     const em = getEm().fork();
@@ -15,6 +36,7 @@ export async function putThreadMessage(m) {
         msg_id: m.msgId,
         role: m.role,
         sender: m.sender ?? null,
+        attachments: m.attachments?.length ? JSON.stringify(m.attachments) : null,
         text: m.text,
         ts: m.ts,
         reply_to_id: m.replyToId,

package/dist/uploads.d.ts

@@ -2,4 +2,14 @@ export declare function uploadsDir(): string;
 export declare function seedAsset(absPath: string): {
     name: string;
 };
+export interface StoredUpload {
+    name: string;
+    mime?: string;
+    size: number;
+}
+export declare function saveUploadBytes(bytes: Uint8Array, opts?: {
+    originalName?: string;
+    mime?: string;
+    maxBytes?: number;
+}): Promise<StoredUpload>;
 export declare function seedAssetPath(metaUrl: string): (rel: string) => string;

package/dist/uploads.js

@@ -1,6 +1,18 @@
 import { copyFileSync, mkdirSync } from 'node:fs';
-import { basename, join } from 'node:path';
+import { writeFile } from 'node:fs/promises';
+import { basename, extname, join } from 'node:path';
+import { randomUUID } from 'node:crypto';
 import { fileURLToPath } from 'node:url';
+const MIME_EXT = {
+    'image/jpeg': '.jpg',
+    'image/png': '.png',
+    'image/gif': '.gif',
+    'image/webp': '.webp',
+    'application/pdf': '.pdf',
+    'text/plain': '.txt',
+    'text/csv': '.csv',
+    'application/json': '.json',
+};
 export function uploadsDir() {
     const dir = process.env.UPLOADS ?? join(process.cwd(), 'data', 'uploads');
     mkdirSync(dir, { recursive: true });
@@ -11,6 +23,17 @@ export function seedAsset(absPath) {
     copyFileSync(absPath, join(uploadsDir(), name));
     return { name };
 }
+export async function saveUploadBytes(bytes, opts = {}) {
+    const maxBytes = opts.maxBytes ?? 25 * 1024 * 1024;
+    if (bytes.byteLength > maxBytes)
+        throw new Error(`upload exceeds ${maxBytes} bytes`);
+    const originalExt = opts.originalName ? extname(basename(opts.originalName)).toLowerCase() : '';
+    const ext = originalExt && /^[.][a-z0-9]{1,10}$/.test(originalExt) ? originalExt : MIME_EXT[opts.mime ?? ''] ?? '';
+    const name = `${randomUUID()}${ext}`;
+    await writeFile(join(uploadsDir(), name), bytes);
+    const mime = opts.mime === 'application/octet-stream' ? undefined : opts.mime;
+    return { name, ...(mime ? { mime } : {}), size: bytes.byteLength };
+}
 export function seedAssetPath(metaUrl) {
     return (rel) => fileURLToPath(new URL(`../../seed/assets/${rel}`, metaUrl));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coffer-org/server",
-  "version": "2.2.2",
+  "version": "2.3.1",
   "type": "module",
   "engines": {
     "node": ">=24"