agentlang 0.10.9 → 0.11.0

package/out/runtime/document-retriever.js

@@ -0,0 +1,258 @@
+import { logger } from './logger.js';
+import { AppConfig } from './state.js';
+import { TextChunker } from './embeddings/chunker.js';
+import { OpenAIEmbeddingProvider } from './embeddings/openai.js';
+import { LanceDBVectorStore } from './resolvers/vector/lancedb-store.js';
+import crypto from 'crypto';
+import { readFileSync } from 'fs';
+import { resolve as pathResolve } from 'path';
+const VECTOR_DIMENSION = 1536;
+function usePgvector() {
+    var _a, _b, _c;
+    if (((_a = AppConfig === null || AppConfig === void 0 ? void 0 : AppConfig.vectorStore) === null || _a === void 0 ? void 0 : _a.type) === 'pgvector')
+        return true;
+    if (((_b = AppConfig === null || AppConfig === void 0 ? void 0 : AppConfig.vectorStore) === null || _b === void 0 ? void 0 : _b.type) === 'lancedb')
+        return false;
+    return ((_c = AppConfig === null || AppConfig === void 0 ? void 0 : AppConfig.store) === null || _c === void 0 ? void 0 : _c.type) === 'postgres';
+}
+/**
+ * Local document retriever — embeds documents into pgvector or LanceDB
+ * and retrieves relevant chunks via vector similarity search.
+ */
+class DocumentRetriever {
+    constructor() {
+        this.vectorStore = null;
+        this.embeddingProvider = null;
+        this.chunker = null;
+        this.localChunks = new Map();
+        this.processedDocuments = new Set();
+        this.initialized = false;
+    }
+    async ensureInit() {
+        var _a;
+        if (this.initialized)
+            return;
+        this.chunker = new TextChunker(1000, 200);
+        this.embeddingProvider = new OpenAIEmbeddingProvider({
+            model: 'text-embedding-3-small',
+        });
+        if (!usePgvector()) {
+            const dbPath = ((_a = AppConfig === null || AppConfig === void 0 ? void 0 : AppConfig.vectorStore) === null || _a === void 0 ? void 0 : _a.type) === 'lancedb'
+                ? AppConfig.vectorStore.dbname || './data/document-vectors.lance'
+                : './data/document-vectors.lance';
+            this.vectorStore = new LanceDBVectorStore({
+                moduleName: 'documents',
+                vectorDimension: VECTOR_DIMENSION,
+                dbname: dbPath,
+            });
+            await this.vectorStore.init();
+            logger.info(`[DOCUMENT-RETRIEVER] LanceDB vector store initialized at ${dbPath}`);
+        }
+        else {
+            try {
+                const ag = globalThis.agentlang;
+                if (ag === null || ag === void 0 ? void 0 : ag.rawQuery) {
+                    await ag.rawQuery(`
+            CREATE TABLE IF NOT EXISTS document_local_chunks (
+              id TEXT PRIMARY KEY,
+              content TEXT NOT NULL,
+              document_title TEXT NOT NULL,
+              chunk_index INTEGER NOT NULL,
+              embedding vector(${VECTOR_DIMENSION})
+            )
+          `);
+                    try {
+                        await ag.rawQuery(`
+              CREATE INDEX IF NOT EXISTS idx_document_local_chunks_embedding
+              ON document_local_chunks USING hnsw (embedding vector_cosine_ops)
+            `);
+                    }
+                    catch (_b) {
+                        // Index may already exist or pgvector extension not loaded
+                    }
+                    logger.info('[DOCUMENT-RETRIEVER] pgvector local chunks table initialized');
+                }
+            }
+            catch (err) {
+                logger.warn(`[DOCUMENT-RETRIEVER] Failed to initialize pgvector table: ${err}`);
+            }
+        }
+        this.initialized = true;
+    }
+    async processDocument(title, url) {
+        if (this.processedDocuments.has(title))
+            return;
+        await this.ensureInit();
+        try {
+            let content;
+            if (url.startsWith('http://') || url.startsWith('https://')) {
+                const resp = await fetch(url);
+                if (!resp.ok) {
+                    logger.warn(`[DOCUMENT-RETRIEVER] Failed to fetch "${title}" from ${url}: ${resp.status}`);
+                    return;
+                }
+                content = await resp.text();
+            }
+            else {
+                const filePath = pathResolve(url);
+                try {
+                    content = readFileSync(filePath, 'utf-8');
+                }
+                catch (err) {
+                    logger.warn(`[DOCUMENT-RETRIEVER] Failed to read "${title}" from ${filePath}: ${err}`);
+                    return;
+                }
+            }
+            if (!content || content.trim().length === 0) {
+                logger.debug(`[DOCUMENT-RETRIEVER] Document "${title}" is empty, skipping`);
+                this.processedDocuments.add(title);
+                return;
+            }
+            const chunks = this.chunker.splitText(content);
+            logger.debug(`[DOCUMENT-RETRIEVER] Document "${title}": ${chunks.length} chunks`);
+            if (chunks.length === 0) {
+                this.processedDocuments.add(title);
+                return;
+            }
+            const embeddings = await this.embeddingProvider.embedTexts(chunks);
+            if (usePgvector()) {
+                await this.storePgvectorChunks(title, chunks, embeddings);
+            }
+            else {
+                await this.storeLanceDBChunks(title, chunks, embeddings);
+            }
+            this.processedDocuments.add(title);
+            logger.info(`[DOCUMENT-RETRIEVER] Processed "${title}": ${chunks.length} chunks embedded and stored`);
+        }
+        catch (err) {
+            logger.warn(`[DOCUMENT-RETRIEVER] Error processing "${title}": ${err}`);
+        }
+    }
+    async storePgvectorChunks(title, chunks, embeddings) {
+        const ag = globalThis.agentlang;
+        if (!(ag === null || ag === void 0 ? void 0 : ag.rawQuery))
+            return;
+        for (let i = 0; i < chunks.length; i++) {
+            const id = crypto.randomUUID();
+            const embeddingStr = `[${embeddings[i].join(',')}]`;
+            await ag.rawQuery(`INSERT INTO document_local_chunks (id, content, document_title, chunk_index, embedding)
+         VALUES ($1, $2, $3, $4, $5::vector)
+         ON CONFLICT (id) DO NOTHING`, [id, chunks[i], title, i, embeddingStr]);
+            this.localChunks.set(id, {
+                id,
+                content: chunks[i],
+                documentTitle: title,
+                chunkIndex: i,
+            });
+        }
+    }
+    async storeLanceDBChunks(title, chunks, embeddings) {
+        if (!this.vectorStore)
+            return;
+        for (let i = 0; i < chunks.length; i++) {
+            const id = crypto.randomUUID();
+            await this.vectorStore.addEmbedding({
+                id,
+                embedding: embeddings[i],
+                documentId: title,
+            });
+            this.localChunks.set(id, {
+                id,
+                content: chunks[i],
+                documentTitle: title,
+                chunkIndex: i,
+            });
+        }
+    }
+    async query(queryText, documentTitles, limit = 10) {
+        await this.ensureInit();
+        try {
+            const results = usePgvector()
+                ? await this.queryPgvector(queryText, documentTitles, limit)
+                : await this.queryLanceDB(queryText, documentTitles, limit);
+            if (results.length === 0)
+                return '';
+            return results.map(r => r.content).join('\n\n---\n\n');
+        }
+        catch (err) {
+            logger.debug(`[DOCUMENT-RETRIEVER] Query failed: ${err}`);
+            return '';
+        }
+    }
+    async queryPgvector(queryText, documentTitles, limit = 10) {
+        const ag = globalThis.agentlang;
+        if (!(ag === null || ag === void 0 ? void 0 : ag.rawQuery))
+            return [];
+        const queryEmbedding = await this.embeddingProvider.embedText(queryText);
+        const embeddingStr = `[${queryEmbedding.join(',')}]`;
+        let sql;
+        let params;
+        if (documentTitles && documentTitles.length > 0) {
+            const placeholders = documentTitles.map((_, i) => `$${i + 2}`).join(', ');
+            sql = `SELECT id, content, document_title, 1 - (embedding <=> $1::vector) AS similarity
+             FROM document_local_chunks
+             WHERE document_title IN (${placeholders})
+             ORDER BY embedding <=> $1::vector
+             LIMIT ${limit}`;
+            params = [embeddingStr, ...documentTitles];
+        }
+        else {
+            sql = `SELECT id, content, document_title, 1 - (embedding <=> $1::vector) AS similarity
+             FROM document_local_chunks
+             ORDER BY embedding <=> $1::vector
+             LIMIT ${limit}`;
+            params = [embeddingStr];
+        }
+        const rows = await ag.rawQuery(sql, params);
+        return (rows || []).map((r) => ({
+            id: r.id,
+            content: r.content,
+            similarity: parseFloat(r.similarity) || 0,
+        }));
+    }
+    async queryLanceDB(queryText, documentTitles, limit = 10) {
+        if (!this.vectorStore)
+            return [];
+        const queryEmbedding = await this.embeddingProvider.embedText(queryText);
+        const searchResults = await this.vectorStore.search(queryEmbedding, undefined, undefined, limit);
+        const results = [];
+        for (const sr of searchResults) {
+            const chunk = this.localChunks.get(sr.id);
+            if (!chunk)
+                continue;
+            if (documentTitles && documentTitles.length > 0) {
+                if (!documentTitles.includes(chunk.documentTitle))
+                    continue;
+            }
+            results.push({
+                id: sr.id,
+                content: chunk.content,
+                similarity: 1 - (sr.distance || 0),
+            });
+        }
+        return results.slice(0, limit);
+    }
+    async close() {
+        if (this.vectorStore) {
+            await this.vectorStore.close();
+            this.vectorStore = null;
+        }
+        this.localChunks.clear();
+        this.processedDocuments.clear();
+        this.initialized = false;
+    }
+}
+let retrieverInstance = null;
+export function getDocumentRetriever() {
+    if (!retrieverInstance) {
+        retrieverInstance = new DocumentRetriever();
+    }
+    return retrieverInstance;
+}
+export function resetDocumentRetriever() {
+    if (retrieverInstance) {
+        retrieverInstance.close().catch(() => { });
+        retrieverInstance = null;
+    }
+}
+//# sourceMappingURL=document-retriever.js.map

package/out/runtime/document-retriever.js.map

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

package/out/runtime/errors/coded-error.d.ts

@@ -0,0 +1,8 @@
+/** Stable bucket for errors without an explicit code. */
+export declare const AL_RUNTIME_UNHANDLED = "AL_RUNTIME_UNHANDLED";
+export type CodedError = Error & {
+    agentlangCode: string;
+};
+export declare function createCodedError(message: string, code: string): CodedError;
+export declare function isCodedError(err: unknown): err is CodedError;
+//# sourceMappingURL=coded-error.d.ts.map

package/out/runtime/errors/coded-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coded-error.d.ts","sourceRoot":"","sources":["../../../src/runtime/errors/coded-error.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAE3D,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAI1E;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,UAAU,CAM5D"}

package/out/runtime/errors/coded-error.js

@@ -0,0 +1,13 @@
+/** Stable bucket for errors without an explicit code. */
+export const AL_RUNTIME_UNHANDLED = 'AL_RUNTIME_UNHANDLED';
+export function createCodedError(message, code) {
+    const e = new Error(message);
+    e.agentlangCode = code;
+    return e;
+}
+export function isCodedError(err) {
+    return (err instanceof Error &&
+        typeof err.agentlangCode === 'string' &&
+        err.agentlangCode.length > 0);
+}
+//# sourceMappingURL=coded-error.js.map

package/out/runtime/errors/coded-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coded-error.js","sourceRoot":"","sources":["../../../src/runtime/errors/coded-error.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAI3D,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,IAAY;IAC5D,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO,CAAe,CAAC;IAC3C,CAAC,CAAC,aAAa,GAAG,IAAI,CAAC;IACvB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,OAAO,CACL,GAAG,YAAY,KAAK;QACpB,OAAQ,GAAkB,CAAC,aAAa,KAAK,QAAQ;QACpD,GAAkB,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAC7C,CAAC;AACJ,CAAC"}

package/out/runtime/errors/http-error.d.ts

@@ -0,0 +1,25 @@
+/** Registry of Tier-1 HTTP-facing error codes (documentation / consistency). */
+export declare const AgentlangErrorCodes: {
+    readonly AL_RUNTIME_UNHANDLED: "AL_RUNTIME_UNHANDLED";
+    readonly AL_HTTP_AUTH_REQUIRED: "AL_HTTP_AUTH_REQUIRED";
+    readonly AL_HTTP_HANDLER_EXCEPTION: "AL_HTTP_HANDLER_EXCEPTION";
+};
+/** Replace `{{code}}` and `{{message}}` with runtime values (iterates until stable). */
+export declare function applyErrorMessageTemplate(template: string, code: string, originalMessage: string): string;
+/**
+ * When custom error messages are enabled, append the error to a dedicated
+ * `logs/errors-<DATE>.log` file as a single line: timestamp (added by the logger),
+ * error code, and error message. No-op when custom messages are disabled.
+ */
+export declare function recordCustomError(code: string, message: string): void;
+export declare function getErrorCode(err: unknown): string;
+/**
+ * Resolve the message for an entity-route error from the `agentlang/errorMessage`
+ * system entity. An entity-specific override (`module/Entry`) wins over a universal
+ * (`*`) one for the same code; falls back to `defaultMessage` when neither exists or
+ * when custom messages are disabled.
+ */
+export declare function resolveEntityErrorMessage(moduleName: string, entryName: string, code: string, defaultMessage: string): Promise<string>;
+export declare function httpStatusFromError(err: unknown): number;
+export declare function logEntityRouteError(reason: unknown, agentlangCode: string): void;
+//# sourceMappingURL=http-error.d.ts.map

package/out/runtime/errors/http-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-error.d.ts","sourceRoot":"","sources":["../../../src/runtime/errors/http-error.ts"],"names":[],"mappings":"AAiBA,gFAAgF;AAChF,eAAO,MAAM,mBAAmB;;;;CAItB,CAAC;AAKX,wFAAwF;AACxF,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,GACtB,MAAM,CASR;AAMD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CASrE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAmCjD;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC,CAkBjB;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAwDxD;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAOhF"}

package/out/runtime/errors/http-error.js

@@ -0,0 +1,169 @@
+import { AgentCancelledException } from '../modules/ai.js';
+import { lookupCustomErrorMessage } from '../modules/core.js';
+import { BadRequestError, CodeMismatchError, ExpiredCodeError, InvalidParameterError, PasswordResetRequiredError, TooManyRequestsError, UnauthorisedError, UserNotConfirmedError, UserNotFoundError, } from '../defs.js';
+import { errorFileLogger, logger } from '../logger.js';
+import { AppConfig } from '../state.js';
+import { AL_RUNTIME_UNHANDLED, isCodedError } from './coded-error.js';
+/** Registry of Tier-1 HTTP-facing error codes (documentation / consistency). */
+export const AgentlangErrorCodes = {
+    AL_RUNTIME_UNHANDLED,
+    AL_HTTP_AUTH_REQUIRED: 'AL_HTTP_AUTH_REQUIRED',
+    AL_HTTP_HANDLER_EXCEPTION: 'AL_HTTP_HANDLER_EXCEPTION',
+};
+/** `target` value of an override that applies to any entity for a given code. */
+const UNIVERSAL_TARGET = '*';
+/** Replace `{{code}}` and `{{message}}` with runtime values (iterates until stable). */
+export function applyErrorMessageTemplate(template, code, originalMessage) {
+    let out = template;
+    const maxPasses = 10;
+    for (let i = 0; i < maxPasses; i++) {
+        const next = out.replace(/\{\{code\}\}/g, code).replace(/\{\{message\}\}/g, originalMessage);
+        if (next === out)
+            break;
+        out = next;
+    }
+    return out;
+}
+function customMessagesEnabled() {
+    var _a;
+    return ((_a = AppConfig === null || AppConfig === void 0 ? void 0 : AppConfig.customErrorMessages) === null || _a === void 0 ? void 0 : _a.enabled) === true;
+}
+/**
+ * When custom error messages are enabled, append the error to a dedicated
+ * `logs/errors-<DATE>.log` file as a single line: timestamp (added by the logger),
+ * error code, and error message. No-op when custom messages are disabled.
+ */
+export function recordCustomError(code, message) {
+    if (!customMessagesEnabled()) {
+        return;
+    }
+    try {
+        errorFileLogger === null || errorFileLogger === void 0 ? void 0 : errorFileLogger.error(`${code} ${message}`);
+    }
+    catch (e) {
+        logger.warn(`Failed to write error to errors log file: ${e}`);
+    }
+}
+export function getErrorCode(err) {
+    if (isCodedError(err)) {
+        return err.agentlangCode;
+    }
+    if (err instanceof UnauthorisedError) {
+        return err.agentlangCode;
+    }
+    if (err instanceof BadRequestError) {
+        return err.agentlangCode;
+    }
+    if (err instanceof UserNotFoundError) {
+        return err.agentlangCode;
+    }
+    if (err instanceof UserNotConfirmedError) {
+        return err.agentlangCode;
+    }
+    if (err instanceof PasswordResetRequiredError) {
+        return err.agentlangCode;
+    }
+    if (err instanceof TooManyRequestsError) {
+        return err.agentlangCode;
+    }
+    if (err instanceof InvalidParameterError) {
+        return err.agentlangCode;
+    }
+    if (err instanceof ExpiredCodeError) {
+        return err.agentlangCode;
+    }
+    if (err instanceof CodeMismatchError) {
+        return err.agentlangCode;
+    }
+    if (err instanceof AgentCancelledException) {
+        return err.agentlangCode;
+    }
+    return AL_RUNTIME_UNHANDLED;
+}
+/**
+ * Resolve the message for an entity-route error from the `agentlang/errorMessage`
+ * system entity. An entity-specific override (`module/Entry`) wins over a universal
+ * (`*`) one for the same code; falls back to `defaultMessage` when neither exists or
+ * when custom messages are disabled.
+ */
+export async function resolveEntityErrorMessage(moduleName, entryName, code, defaultMessage) {
+    var _a;
+    if (!customMessagesEnabled()) {
+        return defaultMessage;
+    }
+    let template;
+    try {
+        const entityKey = `${moduleName}/${entryName}`;
+        template =
+            (_a = (await lookupCustomErrorMessage(entityKey, code))) !== null && _a !== void 0 ? _a : (await lookupCustomErrorMessage(UNIVERSAL_TARGET, code));
+    }
+    catch (e) {
+        logger.warn(`Failed to resolve custom error message for code ${code}: ${e}`);
+        return defaultMessage;
+    }
+    if (template === undefined) {
+        return defaultMessage;
+    }
+    return applyErrorMessageTemplate(template, code, defaultMessage);
+}
+export function httpStatusFromError(err) {
+    const ec = getErrorCode(err);
+    if (ec === 'AL_DB_UNIQUE_VIOLATION') {
+        return 409;
+    }
+    if (ec === 'AL_DB_FOREIGN_KEY_VIOLATION' ||
+        ec === 'AL_DB_NOT_NULL_VIOLATION' ||
+        ec === 'AL_DB_CHECK_VIOLATION' ||
+        ec === 'AL_DB_INVALID_TYPE' ||
+        ec === 'AL_MOD_TYPE_MISMATCH' ||
+        ec === 'AL_MOD_INVALID_ATTR') {
+        return 400;
+    }
+    if (ec === 'AL_DB_DEADLOCK' ||
+        ec === 'AL_DB_LOCK_WAIT_TIMEOUT' ||
+        ec === 'AL_DB_SERIALIZATION_FAILURE') {
+        return 503;
+    }
+    if (ec === 'AL_DB_SYNTAX_ERROR' || ec === 'AL_DB_QUERY_FAILED') {
+        return 500;
+    }
+    if (err instanceof UserNotFoundError) {
+        return 404;
+    }
+    if (err instanceof UnauthorisedError) {
+        return 401;
+    }
+    if (err instanceof TooManyRequestsError) {
+        return 429;
+    }
+    if (err instanceof BadRequestError || err instanceof InvalidParameterError) {
+        return 400;
+    }
+    if (err instanceof ExpiredCodeError || err instanceof CodeMismatchError) {
+        return 400;
+    }
+    if (err instanceof UserNotConfirmedError || err instanceof PasswordResetRequiredError) {
+        return 403;
+    }
+    if (err instanceof Error && err.message) {
+        if (err.message.includes('temporarily unavailable') ||
+            err.message.includes('service error') ||
+            err.message.includes('configuration error')) {
+            return 503;
+        }
+        if (err.message.includes('contact support')) {
+            return 500;
+        }
+    }
+    return 500;
+}
+export function logEntityRouteError(reason, agentlangCode) {
+    if (reason instanceof Error) {
+        const stack = reason.stack ? `\n${reason.stack}` : '';
+        logger.error(`[${agentlangCode}] ${reason.name}: ${reason.message}${stack}`);
+    }
+    else {
+        logger.error(`[${agentlangCode}] ${String(reason)}`);
+    }
+}
+//# sourceMappingURL=http-error.js.map

package/out/runtime/errors/http-error.js.map

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

package/out/runtime/excel-resolver.d.ts

@@ -0,0 +1,4 @@
+import { Instance } from './module.js';
+export declare function querySheet(_resolver: any, inst: Instance, _queryAll?: boolean): Promise<Instance[]>;
+export declare function createSheetRow(_resolver: any, inst: Instance): Promise<Instance>;
+//# sourceMappingURL=excel-resolver.d.ts.map

package/out/runtime/excel-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel-resolver.d.ts","sourceRoot":"","sources":["../../src/runtime/excel-resolver.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAgBvC,wBAAsB,UAAU,CAC9B,SAAS,EAAE,GAAG,EACd,IAAI,EAAE,QAAQ,EACd,SAAS,CAAC,EAAE,OAAO,GAClB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAoCrB;AAED,wBAAsB,cAAc,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAiDtF"}

package/out/runtime/excel-resolver.js

@@ -0,0 +1,96 @@
+/**
+ * Excel file resolver - query and create rows in Excel sheets.
+ * Used by entities created from Excel config (agentlang.excel).
+ */
+import { makeInstance, newInstanceAttributes } from './module.js';
+function isUrl(path) {
+    return typeof path === 'string' && /^https?:\/\//i.test(path);
+}
+async function loadWorkbook(excelPath, XLSX) {
+    if (isUrl(excelPath)) {
+        const res = await fetch(excelPath);
+        if (!res.ok)
+            throw new Error(`Failed to fetch: ${res.status} ${res.statusText}`);
+        const buf = await res.arrayBuffer();
+        return XLSX.read(buf, { type: 'arraybuffer' });
+    }
+    return XLSX.readFile(excelPath);
+}
+export async function querySheet(_resolver, inst, _queryAll) {
+    var _a, _b;
+    const filePath = inst.record.getMeta('excel_path');
+    const sheetName = inst.record.getMeta('sheet_name');
+    const excelHeaders = inst.record.getMeta('excel_headers');
+    if (!filePath) {
+        throw new Error('Excel file path is required for querying sheets');
+    }
+    const XLSXModule = await import('xlsx');
+    const XLSX = XLSXModule.default || XLSXModule;
+    const workbook = await loadWorkbook(filePath, XLSX);
+    const sheetNames = workbook.SheetNames || [];
+    const targetSheet = sheetName && sheetNames.includes(sheetName) ? sheetName : sheetNames[0];
+    const ws = workbook.Sheets[targetSheet];
+    const rows = XLSX.utils.sheet_to_json(ws, { raw: false, defval: null });
+    const schema = inst.record.schema;
+    const attrNames = Array.from(schema.keys()).filter(k => !k.startsWith('__') && k !== 'id');
+    const headers = excelHeaders || attrNames;
+    const result = [];
+    for (const row of rows) {
+        const attrs = newInstanceAttributes();
+        for (let i = 0; i < attrNames.length; i++) {
+            const attrName = attrNames[i];
+            const headerKey = (_a = headers[i]) !== null && _a !== void 0 ? _a : attrName;
+            const val = row[headerKey];
+            attrs.set(attrName, val === '' || val === null || val === undefined ? null : val);
+        }
+        const id = (_b = row.id) !== null && _b !== void 0 ? _b : `${filePath}|${targetSheet}|${Date.now()}-${Math.random()}`;
+        attrs.set('id', id);
+        result.push(makeInstance(inst.moduleName, inst.name, attrs));
+    }
+    return result;
+}
+export async function createSheetRow(_resolver, inst) {
+    var _a, _b;
+    const meta = (_a = inst.record) === null || _a === void 0 ? void 0 : _a.meta;
+    if (!meta) {
+        throw new Error('Meta with excel_path and sheet_name is required');
+    }
+    const filePath = meta.get('excel_path');
+    if (!filePath) {
+        throw new Error('excel_path is required in meta');
+    }
+    if (isUrl(filePath)) {
+        throw new Error('createSheetRow requires a local file path; URLs are read-only');
+    }
+    const XLSXModule = await import('xlsx');
+    const XLSX = XLSXModule.default || XLSXModule;
+    const workbook = XLSX.readFile(filePath);
+    const sheetName = meta.get('sheet_name') || workbook.SheetNames[0];
+    const ws = workbook.Sheets[sheetName];
+    if (!ws) {
+        throw new Error(`Sheet not found: ${sheetName}`);
+    }
+    const headerRows = XLSX.utils.sheet_to_json(ws, { header: 1 });
+    const headers = (headerRows[0] || []);
+    const row = {};
+    inst.attributes.forEach((value, key) => {
+        if (!key.startsWith('__')) {
+            row[key] = value != null ? String(value) : '';
+        }
+    });
+    XLSX.utils.sheet_add_json(ws, [row], {
+        skipHeader: true,
+        header: headers.length ? headers : Object.keys(row),
+        origin: -1,
+    });
+    XLSX.writeFile(workbook, filePath);
+    const created = newInstanceAttributes();
+    inst.attributes.forEach((v, k) => {
+        if (!k.startsWith('__'))
+            created.set(k, v);
+    });
+    const id = (_b = inst.attributes.get('id')) !== null && _b !== void 0 ? _b : `${filePath}|${sheetName}|${Date.now()}`;
+    created.set('id', id);
+    return makeInstance(inst.moduleName, inst.name, created);
+}
+//# sourceMappingURL=excel-resolver.js.map

package/out/runtime/excel-resolver.js.map

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

package/out/runtime/excel.d.ts

@@ -0,0 +1,25 @@
+export type ExcelConfigEntry = {
+    url: string;
+    sheet?: string;
+    entityName?: string;
+};
+export type CreateEntityFromExcelResult = {
+    entityName: string;
+    moduleName: string;
+    fqName: string;
+    headers: string[];
+    sheetName: string;
+    filePath: string;
+};
+/**
+ * Create an entity and file resolver from an Excel file at the given path.
+ * Used by config (processExcelConfig) and by the /assetUpload HTTP endpoint.
+ * @param moduleName - Target module for the entity. If omitted, uses Excel module.
+ */
+export declare function createEntityFromExcelFile(filePath: string, options?: {
+    entityName?: string;
+    sheetName?: string;
+    moduleName?: string;
+}): Promise<CreateEntityFromExcelResult>;
+export declare function processExcelConfig(entries: ExcelConfigEntry[], basePath: string): Promise<void>;
+//# sourceMappingURL=excel.d.ts.map