libre-webui 0.24.1 → 0.26.0

package/backend/dist/services/automationSchedulerService.js

@@ -0,0 +1,221 @@
+/*
+ * Libre WebUI
+ * Copyright (C) 2025 Kroonen AI, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at:
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { encryptionService } from './encryptionService.js';
+import { getPersistence } from '../persistence/index.js';
+import { getCoordinator } from '../platform/coordination/service.js';
+import { getDurableJobRuntime } from '../platform/jobs/durableJobRuntime.js';
+import { AUTOMATION_RUN_JOB_TYPE, automationRunIdempotencyScope, chatGenerationIdempotencyScope, } from '../platform/jobs/domainJobContracts.js';
+import automationService from './automationService.js';
+import { nextRunAt } from '../utils/automationSchedule.js';
+import { createLogger } from '../utils/logger.js';
+const logger = createLogger('automation-scheduler');
+const TICK_INTERVAL_MS = 60000;
+const LEASE_KEY = 'automation-scheduler';
+const LEASE_TTL_MS = 55000;
+const DUE_BATCH_LIMIT = 50;
+/** A queued run whose start never materialized is abandoned after this. */
+const STALE_QUEUED_MS = 30 * 60 * 1000;
+class AutomationSchedulerService {
+    constructor() {
+        this.stopped = false;
+    }
+    start() {
+        this.stopped = false;
+        this.scheduleTick();
+    }
+    stop() {
+        this.stopped = true;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = undefined;
+        }
+    }
+    scheduleTick() {
+        if (this.stopped || this.timer)
+            return;
+        this.timer = setTimeout(() => {
+            this.timer = undefined;
+            void this.tick()
+                .catch(error => {
+                logger.warn('Automation scheduler tick failed:', error);
+            })
+                .finally(() => {
+                this.scheduleTick();
+            });
+        }, TICK_INTERVAL_MS);
+        this.timer.unref();
+    }
+    async tick(now = Date.now()) {
+        const lease = await getCoordinator().acquireLease(LEASE_KEY, LEASE_TTL_MS);
+        if (!lease)
+            return { fired: 0, settled: 0 };
+        try {
+            const fired = await this.fireDue(now);
+            const settled = await this.settleRuns(now);
+            // Calendar reminders share the scheduler's coordination lease; the
+            // per-event compare-and-set keeps concurrent sweeps single-fire.
+            try {
+                const { calendarService } = await import('./calendarService.js');
+                await calendarService.sweepReminders(now);
+            }
+            catch (error) {
+                logger.warn('Calendar reminder sweep failed', { error });
+            }
+            // Gallery retention shares the same lease; a no-op unless the
+            // administrator configured GALLERY_RETENTION_DAYS.
+            try {
+                const { default: galleryService } = await import('./galleryService.js');
+                await galleryService.sweepRetention(now);
+            }
+            catch (error) {
+                logger.warn('Gallery retention sweep failed', { error });
+            }
+            // Budget threshold alerts also ride this lease; notification source
+            // keys keep each threshold single-fire per period.
+            try {
+                const { default: costGovernanceService } = await import('./costGovernanceService.js');
+                await costGovernanceService.sweepBudgetAlerts(now);
+            }
+            catch (error) {
+                logger.warn('Budget alert sweep failed', { error });
+            }
+            return { fired, settled };
+        }
+        finally {
+            await lease.release().catch(() => false);
+        }
+    }
+    /**
+     * Fire every automation whose next_run_at has arrived. Missed occurrences
+     * collapse into one run: the overdue slot fires, and the schedule advances
+     * to the next occurrence after now.
+     */
+    async fireDue(now) {
+        const repositories = getPersistence(encryptionService).repositories;
+        const due = await repositories.resources.automations.listDue(now, DUE_BATCH_LIMIT);
+        let fired = 0;
+        for (const automation of due) {
+            const observed = automation.next_run_at;
+            if (observed === null)
+                continue;
+            let next = null;
+            try {
+                next = nextRunAt(JSON.parse(automation.triggers), now);
+            }
+            catch (error) {
+                logger.warn(`Automation ${automation.id} has unreadable triggers:`, error);
+            }
+            // The compare-and-set claims this occurrence; a concurrent tick that
+            // lost the race skips it entirely.
+            const claimed = await repositories.resources.automations.advanceNextRun(automation.id, observed, next, now);
+            if (!claimed)
+                continue;
+            try {
+                const run = await automationService.createRun(automation.id, automation.user_id, observed);
+                await getDurableJobRuntime().service.enqueue({
+                    jobType: AUTOMATION_RUN_JOB_TYPE,
+                    actorUserId: automation.user_id,
+                    idempotencyScope: automationRunIdempotencyScope(automation.id),
+                    idempotencyKey: String(observed),
+                    payload: {
+                        mode: 'encrypted',
+                        value: { runId: run.id, automationId: automation.id },
+                    },
+                    maxAttempts: 3,
+                });
+                fired += 1;
+            }
+            catch (error) {
+                logger.error(`Could not enqueue run for automation ${automation.id}:`, error);
+            }
+        }
+        return fired;
+    }
+    /** Enqueue a manual run outside the schedule (Run now). */
+    async runNow(automationId, userId) {
+        const now = Date.now();
+        const run = await automationService.createRun(automationId, userId, now);
+        await getDurableJobRuntime().service.enqueue({
+            jobType: AUTOMATION_RUN_JOB_TYPE,
+            actorUserId: userId,
+            idempotencyScope: automationRunIdempotencyScope(automationId),
+            idempotencyKey: `manual:${run.id}`,
+            payload: {
+                mode: 'encrypted',
+                value: { runId: run.id, automationId },
+            },
+            maxAttempts: 3,
+        });
+        return run.id;
+    }
+    /**
+     * Settle unfinished runs from the durable job ledger: a run succeeds when
+     * its chat generation job succeeded, fails when either job dead-lettered,
+     * and is abandoned when it never started within the stale window.
+     */
+    async settleRuns(now) {
+        const service = getDurableJobRuntime().service;
+        const runs = await automationService.listUnfinishedRunRecords();
+        let settled = 0;
+        for (const run of runs) {
+            try {
+                if (run.session_id && run.assistant_message_id) {
+                    const chatJob = await service.getByIdempotency(run.user_id, chatGenerationIdempotencyScope(run.session_id), run.assistant_message_id);
+                    if (chatJob?.state === 'succeeded') {
+                        if (await automationService.finalizeRun(run.id, 'succeeded')) {
+                            settled += 1;
+                        }
+                        continue;
+                    }
+                    if (chatJob?.state === 'dead_letter' ||
+                        chatJob?.state === 'cancelled') {
+                        if (await automationService.finalizeRun(run.id, 'failed', chatJob.errorSummary ?? chatJob.state, { userId: run.user_id, automationId: run.automation_id })) {
+                            settled += 1;
+                        }
+                        continue;
+                    }
+                }
+                // Scheduled runs key by their occurrence time, manual runs by id.
+                let runJob = await service.getByIdempotency(run.user_id, automationRunIdempotencyScope(run.automation_id), String(run.scheduled_for));
+                if (!runJob) {
+                    runJob = await service.getByIdempotency(run.user_id, automationRunIdempotencyScope(run.automation_id), `manual:${run.id}`);
+                }
+                if (runJob?.state === 'dead_letter' || runJob?.state === 'cancelled') {
+                    if (await automationService.finalizeRun(run.id, 'failed', runJob.errorSummary ?? runJob.state, { userId: run.user_id, automationId: run.automation_id })) {
+                        settled += 1;
+                    }
+                    continue;
+                }
+                if (run.status === 'queued' && now - run.created_at > STALE_QUEUED_MS) {
+                    if (await automationService.finalizeRun(run.id, 'failed', 'stalled', {
+                        userId: run.user_id,
+                        automationId: run.automation_id,
+                    })) {
+                        settled += 1;
+                    }
+                }
+            }
+            catch (error) {
+                logger.warn(`Could not settle automation run ${run.id}:`, error);
+            }
+        }
+        return settled;
+    }
+}
+const automationSchedulerService = new AutomationSchedulerService();
+export default automationSchedulerService;
+//# sourceMappingURL=automationSchedulerService.js.map

package/backend/dist/services/automationSchedulerService.js.map

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

package/backend/dist/services/automationService.d.ts

@@ -0,0 +1,56 @@
+import type { Automation, AutomationNotify, AutomationRun, AutomationStatus } from '../types/index.js';
+import type { StoredAutomationRunRecord } from '../persistence/resourceTypes.js';
+/**
+ * The stored provider column carries the normalized selection as
+ * `providerType` or `providerType:providerId`; null means Auto.
+ */
+export declare const encodeProvider: (providerType?: string, providerId?: string) => string | null;
+export declare const decodeProvider: (value: string | null) => {
+    providerType?: string;
+    providerId?: string;
+};
+export interface AutomationInput {
+    name: string;
+    instructions: string;
+    triggers: unknown;
+    provider?: string;
+    model?: string;
+    notify?: AutomationNotify;
+}
+declare class AutomationService {
+    getAutomations(userId: string): Promise<Automation[]>;
+    getAutomation(automationId: string, userId: string): Promise<Automation | undefined>;
+    /** Owner-blind lookup for the durable job handler and scheduler. */
+    getAutomationRecord(automationId: string): Promise<(Automation & {
+        userId: string;
+    }) | undefined>;
+    createAutomation(input: AutomationInput, userId: string): Promise<Automation>;
+    updateAutomation(automationId: string, input: AutomationInput, userId: string): Promise<Automation | undefined>;
+    private persistAutomation;
+    setAutomationStatus(automationId: string, userId: string, status: AutomationStatus): Promise<Automation | undefined>;
+    deleteAutomation(automationId: string, userId: string): Promise<boolean>;
+    createRun(automationId: string, userId: string, scheduledFor: number): Promise<AutomationRun>;
+    getRunRecord(runId: string, userId: string): Promise<StoredAutomationRunRecord | null>;
+    listRuns(userId: string, options?: {
+        automationId?: string;
+        from?: number;
+        to?: number;
+    }): Promise<AutomationRun[]>;
+    listUnfinishedRunRecords(): Promise<StoredAutomationRunRecord[]>;
+    markRunStarted(runId: string, sessionId: string, assistantMessageId: string): Promise<boolean>;
+    finalizeRun(runId: string, status: 'succeeded' | 'failed', error?: string | null, context?: {
+        userId: string;
+        automationId: string;
+    }): Promise<boolean>;
+    runsSummary(userId: string): Promise<{
+        unseenCount: number;
+        days: {
+            succeeded: number;
+            failed: number;
+        }[];
+    }>;
+    markRunsSeen(userId: string): Promise<number>;
+}
+declare const automationService: AutomationService;
+export default automationService;
+//# sourceMappingURL=automationService.d.ts.map

package/backend/dist/services/automationService.d.ts.map

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

package/backend/dist/services/automationService.js

@@ -0,0 +1,247 @@
+/*
+ * Libre WebUI
+ * Copyright (C) 2025 Kroonen AI, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at:
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { v4 as uuidv4 } from 'uuid';
+import { encryptionService } from './encryptionService.js';
+import { getPersistence } from '../persistence/index.js';
+import { PersistenceResourceLimitError } from '../persistence/resourceTypes.js';
+import { nextRunAt, validateTriggers } from '../utils/automationSchedule.js';
+import { MAX_AUTOMATION_INSTRUCTIONS_LENGTH, MAX_AUTOMATION_NAME_LENGTH, MAX_AUTOMATIONS_PER_USER, ResourcePolicyError, } from '../utils/resourceLimits.js';
+const RUN_LIST_LIMIT = 500;
+const repositories = () => getPersistence(encryptionService).repositories.resources;
+/**
+ * The stored provider column carries the normalized selection as
+ * `providerType` or `providerType:providerId`; null means Auto.
+ */
+export const encodeProvider = (providerType, providerId) => {
+    if (!providerType)
+        return null;
+    return providerId ? `${providerType}:${providerId}` : providerType;
+};
+export const decodeProvider = (value) => {
+    if (!value)
+        return {};
+    const separator = value.indexOf(':');
+    if (separator === -1)
+        return { providerType: value };
+    return {
+        providerType: value.slice(0, separator),
+        providerId: value.slice(separator + 1),
+    };
+};
+const mapAutomationRow = (row) => ({
+    id: row.id,
+    name: encryptionService.decrypt(row.name),
+    instructions: encryptionService.decrypt(row.instructions),
+    triggers: JSON.parse(row.triggers),
+    ...(row.provider ? { provider: row.provider } : {}),
+    ...(row.model ? { model: row.model } : {}),
+    notify: row.notify,
+    status: row.status,
+    ...(row.next_run_at !== null ? { nextRunAt: row.next_run_at } : {}),
+    ...(row.last_run_at !== null ? { lastRunAt: row.last_run_at } : {}),
+    createdAt: row.created_at,
+    updatedAt: row.updated_at,
+});
+const mapRunRow = (row) => ({
+    id: row.id,
+    automationId: row.automation_id,
+    scheduledFor: row.scheduled_for,
+    ...(row.started_at !== null ? { startedAt: row.started_at } : {}),
+    ...(row.finished_at !== null ? { finishedAt: row.finished_at } : {}),
+    status: row.status,
+    ...(row.session_id !== null ? { sessionId: row.session_id } : {}),
+    ...(row.error !== null ? { error: row.error } : {}),
+    seen: row.seen_at !== null,
+    createdAt: row.created_at,
+});
+class AutomationService {
+    async getAutomations(userId) {
+        const rows = await repositories().automations.listByOwner(userId, MAX_AUTOMATIONS_PER_USER);
+        return rows.map(mapAutomationRow);
+    }
+    async getAutomation(automationId, userId) {
+        const row = await repositories().automations.findByOwner(automationId, userId);
+        return row ? mapAutomationRow(row) : undefined;
+    }
+    /** Owner-blind lookup for the durable job handler and scheduler. */
+    async getAutomationRecord(automationId) {
+        const row = await repositories().automations.findById(automationId);
+        return row ? { ...mapAutomationRow(row), userId: row.user_id } : undefined;
+    }
+    async createAutomation(input, userId) {
+        return this.persistAutomation(input, userId, undefined);
+    }
+    async updateAutomation(automationId, input, userId) {
+        const existing = await repositories().automations.findByOwner(automationId, userId);
+        if (!existing)
+            return undefined;
+        return this.persistAutomation(input, userId, existing);
+    }
+    async persistAutomation(input, userId, existing) {
+        if (!input.name.trim() ||
+            input.name.length > MAX_AUTOMATION_NAME_LENGTH ||
+            !input.instructions.trim() ||
+            input.instructions.length > MAX_AUTOMATION_INSTRUCTIONS_LENGTH) {
+            throw new ResourcePolicyError('Automation name or instructions are missing or exceed the maximum size', 400);
+        }
+        const triggers = validateTriggers(input.triggers);
+        const now = Date.now();
+        const status = (existing?.status ?? 'active');
+        const record = {
+            id: existing?.id ?? uuidv4(),
+            user_id: userId,
+            name: encryptionService.encrypt(input.name.trim()),
+            instructions: encryptionService.encrypt(input.instructions.trim()),
+            triggers: JSON.stringify(triggers),
+            provider: input.provider ?? null,
+            model: input.model ?? null,
+            notify: input.notify === 'off' ? 'off' : 'app',
+            status,
+            // Editing reschedules from now; a paused automation stays dormant.
+            next_run_at: status === 'active' ? nextRunAt(triggers, now) : null,
+            last_run_at: existing?.last_run_at ?? null,
+            created_at: existing?.created_at ?? now,
+            updated_at: now,
+        };
+        try {
+            await repositories().automations.replaceWithLimit(record, MAX_AUTOMATIONS_PER_USER);
+        }
+        catch (error) {
+            if (error instanceof PersistenceResourceLimitError) {
+                throw new ResourcePolicyError(`A user may store at most ${MAX_AUTOMATIONS_PER_USER} automations`, 409);
+            }
+            throw error;
+        }
+        return mapAutomationRow(record);
+    }
+    async setAutomationStatus(automationId, userId, status) {
+        const row = await repositories().automations.findByOwner(automationId, userId);
+        if (!row)
+            return undefined;
+        const now = Date.now();
+        const nextRun = status === 'active'
+            ? nextRunAt(JSON.parse(row.triggers), now)
+            : null;
+        const updated = await repositories().automations.setStatus(automationId, userId, status, nextRun, now);
+        if (!updated)
+            return undefined;
+        return mapAutomationRow({
+            ...row,
+            status,
+            next_run_at: nextRun,
+            updated_at: now,
+        });
+    }
+    async deleteAutomation(automationId, userId) {
+        return repositories().automations.deleteByOwner(automationId, userId);
+    }
+    // ----- runs -----
+    async createRun(automationId, userId, scheduledFor) {
+        const record = {
+            id: uuidv4(),
+            automation_id: automationId,
+            user_id: userId,
+            scheduled_for: scheduledFor,
+            started_at: null,
+            finished_at: null,
+            status: 'queued',
+            session_id: null,
+            assistant_message_id: null,
+            error: null,
+            seen_at: null,
+            created_at: Date.now(),
+        };
+        await repositories().automationRuns.insert(record);
+        return mapRunRow(record);
+    }
+    async getRunRecord(runId, userId) {
+        return repositories().automationRuns.findByOwner(runId, userId);
+    }
+    async listRuns(userId, options = {}) {
+        const rows = await repositories().automationRuns.listByOwner(userId, {
+            ...options,
+            maximum: RUN_LIST_LIMIT,
+        });
+        return rows.map(mapRunRow);
+    }
+    async listUnfinishedRunRecords() {
+        return repositories().automationRuns.listUnfinished(200);
+    }
+    async markRunStarted(runId, sessionId, assistantMessageId) {
+        return repositories().automationRuns.markStarted(runId, sessionId, assistantMessageId, Date.now());
+    }
+    async finalizeRun(runId, status, error = null, context) {
+        const finalized = await repositories().automationRuns.finalize(runId, status, Date.now(), error);
+        if (finalized && status === 'failed' && context) {
+            // Failure awareness must not depend on the automations page being
+            // open; publish an in-app notification unless the automation opted
+            // out of notifications entirely.
+            try {
+                const automation = await this.getAutomationRecord(context.automationId);
+                if (automation && automation.notify !== 'off') {
+                    const { notificationService } = await import('./notificationService.js');
+                    await notificationService.publish({
+                        userId: context.userId,
+                        type: 'automation-failed',
+                        title: `Automation "${automation.name}" failed`,
+                        ...(error ? { body: error } : {}),
+                        href: '/automations',
+                        sourceKey: `automation-run-failed:${runId}`,
+                    });
+                }
+            }
+            catch {
+                // Best effort: the run row already records the failure.
+            }
+        }
+        return finalized;
+    }
+    async runsSummary(userId) {
+        const now = Date.now();
+        const dayMs = 24 * 60 * 60 * 1000;
+        const start = new Date(now);
+        const todayStart = new Date(start.getFullYear(), start.getMonth(), start.getDate()).getTime();
+        const windowStart = todayStart - 29 * dayMs;
+        const [unseenCount, runs] = await Promise.all([
+            repositories().automationRuns.countUnseenFinished(userId),
+            repositories().automationRuns.listByOwner(userId, {
+                from: windowStart,
+                maximum: RUN_LIST_LIMIT,
+            }),
+        ]);
+        const days = Array.from({ length: 30 }, () => ({
+            succeeded: 0,
+            failed: 0,
+        }));
+        for (const run of runs) {
+            const index = Math.floor((run.scheduled_for - windowStart) / dayMs);
+            if (index < 0 || index >= 30)
+                continue;
+            if (run.status === 'succeeded')
+                days[index].succeeded += 1;
+            else if (run.status === 'failed')
+                days[index].failed += 1;
+        }
+        return { unseenCount, days };
+    }
+    async markRunsSeen(userId) {
+        return repositories().automationRuns.markSeenBefore(userId, Date.now());
+    }
+}
+const automationService = new AutomationService();
+export default automationService;
+//# sourceMappingURL=automationService.js.map

package/backend/dist/services/automationService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"automationService.js","sourceRoot":"","sources":["../../src/services/automationService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AASpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAKhF,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,EACL,kCAAkC,EAClC,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,cAAc,GAAG,GAAG,CAAC;AAE3B,MAAM,YAAY,GAAG,GAAG,EAAE,CACxB,cAAc,CAAC,iBAAiB,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC;AAE3D;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,YAAqB,EACrB,UAAmB,EACJ,EAAE;IACjB,IAAI,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO,UAAU,CAAC,CAAC,CAAC,GAAG,YAAY,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC;AACrE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,KAAoB,EAC4B,EAAE;IAClD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,SAAS,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;IACrD,OAAO;QACL,YAAY,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC;QACvC,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;KACvC,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,GAA2B,EAAc,EAAE,CAAC,CAAC;IACrE,EAAE,EAAE,GAAG,CAAC,EAAE;IACV,IAAI,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;IACzC,YAAY,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACzD,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAwB;IACzD,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnD,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1C,MAAM,EAAE,GAAG,CAAC,MAA0B;IACtC,MAAM,EAAE,GAAG,CAAC,MAA0B;IACtC,GAAG,CAAC,GAAG,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,GAAG,CAAC,GAAG,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,SAAS,EAAE,GAAG,CAAC,UAAU;IACzB,SAAS,EAAE,GAAG,CAAC,UAAU;CAC1B,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,CAAC,GAA8B,EAAiB,EAAE,CAAC,CAAC;IACpE,EAAE,EAAE,GAAG,CAAC,EAAE;IACV,YAAY,EAAE,GAAG,CAAC,aAAa;IAC/B,YAAY,EAAE,GAAG,CAAC,aAAa;IAC/B,GAAG,CAAC,GAAG,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,GAAG,CAAC,GAAG,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,MAAM,EAAE,GAAG,CAAC,MAA6B;IACzC,GAAG,CAAC,GAAG,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACjE,GAAG,CAAC,GAAG,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnD,IAAI,EAAE,GAAG,CAAC,OAAO,KAAK,IAAI;IAC1B,SAAS,EAAE,GAAG,CAAC,UAAU;CAC1B,CAAC,CAAC;AAWH,MAAM,iBAAiB;IACrB,KAAK,CAAC,cAAc,CAAC,MAAc;QACjC,MAAM,IAAI,GAAG,MAAM,YAAY,EAAE,CAAC,WAAW,CAAC,WAAW,CACvD,MAAM,EACN,wBAAwB,CACzB,CAAC;QACF,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,YAAoB,EACpB,MAAc;QAEd,MAAM,GAAG,GAAG,MAAM,YAAY,EAAE,CAAC,WAAW,CAAC,WAAW,CACtD,YAAY,EACZ,MAAM,CACP,CAAC;QACF,OAAO,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjD,CAAC;IAED,oEAAoE;IACpE,KAAK,CAAC,mBAAmB,CACvB,YAAoB;QAEpB,MAAM,GAAG,GAAG,MAAM,YAAY,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACpE,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7E,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,KAAsB,EACtB,MAAc;QAEd,OAAO,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,YAAoB,EACpB,KAAsB,EACtB,MAAc;QAEd,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC,WAAW,CAAC,WAAW,CAC3D,YAAY,EACZ,MAAM,CACP,CAAC;QACF,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC;QAChC,OAAO,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACzD,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAC7B,KAAsB,EACtB,MAAc,EACd,QAA4C;QAE5C,IACE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;YAClB,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,0BAA0B;YAC9C,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE;YAC1B,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,kCAAkC,EAC9D,CAAC;YACD,MAAM,IAAI,mBAAmB,CAC3B,wEAAwE,EACxE,GAAG,CACJ,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,QAAQ,CAAqB,CAAC;QAClE,MAAM,MAAM,GAA2B;YACrC,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,MAAM,EAAE;YAC5B,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAClD,YAAY,EAAE,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;YAClE,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;YAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;YAChC,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI;YAC1B,MAAM,EAAE,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK;YAC9C,MAAM;YACN,mEAAmE;YACnE,WAAW,EAAE,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI;YAClE,WAAW,EAAE,QAAQ,EAAE,WAAW,IAAI,IAAI;YAC1C,UAAU,EAAE,QAAQ,EAAE,UAAU,IAAI,GAAG;YACvC,UAAU,EAAE,GAAG;SAChB,CAAC;QACF,IAAI,CAAC;YACH,MAAM,YAAY,EAAE,CAAC,WAAW,CAAC,gBAAgB,CAC/C,MAAM,EACN,wBAAwB,CACzB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,6BAA6B,EAAE,CAAC;gBACnD,MAAM,IAAI,mBAAmB,CAC3B,4BAA4B,wBAAwB,cAAc,EAClE,GAAG,CACJ,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QACD,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,YAAoB,EACpB,MAAc,EACd,MAAwB;QAExB,MAAM,GAAG,GAAG,MAAM,YAAY,EAAE,CAAC,WAAW,CAAC,WAAW,CACtD,YAAY,EACZ,MAAM,CACP,CAAC;QACF,IAAI,CAAC,GAAG;YAAE,OAAO,SAAS,CAAC;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GACX,MAAM,KAAK,QAAQ;YACjB,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAwB,EAAE,GAAG,CAAC;YACjE,CAAC,CAAC,IAAI,CAAC;QACX,MAAM,OAAO,GAAG,MAAM,YAAY,EAAE,CAAC,WAAW,CAAC,SAAS,CACxD,YAAY,EACZ,MAAM,EACN,MAAM,EACN,OAAO,EACP,GAAG,CACJ,CAAC;QACF,IAAI,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAC/B,OAAO,gBAAgB,CAAC;YACtB,GAAG,GAAG;YACN,MAAM;YACN,WAAW,EAAE,OAAO;YACpB,UAAU,EAAE,GAAG;SAChB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,YAAoB,EACpB,MAAc;QAEd,OAAO,YAAY,EAAE,CAAC,WAAW,CAAC,aAAa,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACxE,CAAC;IAED,mBAAmB;IAEnB,KAAK,CAAC,SAAS,CACb,YAAoB,EACpB,MAAc,EACd,YAAoB;QAEpB,MAAM,MAAM,GAA8B;YACxC,EAAE,EAAE,MAAM,EAAE;YACZ,aAAa,EAAE,YAAY;YAC3B,OAAO,EAAE,MAAM;YACf,aAAa,EAAE,YAAY;YAC3B,UAAU,EAAE,IAAI;YAChB,WAAW,EAAE,IAAI;YACjB,MAAM,EAAE,QAAQ;YAChB,UAAU,EAAE,IAAI;YAChB,oBAAoB,EAAE,IAAI;YAC1B,KAAK,EAAE,IAAI;YACX,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;SACvB,CAAC;QACF,MAAM,YAAY,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACnD,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,KAAa,EACb,MAAc;QAEd,OAAO,YAAY,EAAE,CAAC,cAAc,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,MAAc,EACd,OAAO,GAA0D,EAAE;QAEnE,MAAM,IAAI,GAAG,MAAM,YAAY,EAAE,CAAC,cAAc,CAAC,WAAW,CAAC,MAAM,EAAE;YACnE,GAAG,OAAO;YACV,OAAO,EAAE,cAAc;SACxB,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,wBAAwB;QAC5B,OAAO,YAAY,EAAE,CAAC,cAAc,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IAC3D,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,KAAa,EACb,SAAiB,EACjB,kBAA0B;QAE1B,OAAO,YAAY,EAAE,CAAC,cAAc,CAAC,WAAW,CAC9C,KAAK,EACL,SAAS,EACT,kBAAkB,EAClB,IAAI,CAAC,GAAG,EAAE,CACX,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,WAAW,CACf,KAAa,EACb,MAA8B,EAC9B,KAAK,GAAkB,IAAI,EAC3B,OAAkD;QAElD,MAAM,SAAS,GAAG,MAAM,YAAY,EAAE,CAAC,cAAc,CAAC,QAAQ,CAC5D,KAAK,EACL,MAAM,EACN,IAAI,CAAC,GAAG,EAAE,EACV,KAAK,CACN,CAAC;QACF,IAAI,SAAS,IAAI,MAAM,KAAK,QAAQ,IAAI,OAAO,EAAE,CAAC;YAChD,kEAAkE;YAClE,mEAAmE;YACnE,iCAAiC;YACjC,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;gBACxE,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;oBAC9C,MAAM,EAAE,mBAAmB,EAAE,GAC3B,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;oBAC3C,MAAM,mBAAmB,CAAC,OAAO,CAAC;wBAChC,MAAM,EAAE,OAAO,CAAC,MAAM;wBACtB,IAAI,EAAE,mBAAmB;wBACzB,KAAK,EAAE,eAAe,UAAU,CAAC,IAAI,UAAU;wBAC/C,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACjC,IAAI,EAAE,cAAc;wBACpB,SAAS,EAAE,yBAAyB,KAAK,EAAE;qBAC5C,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,wDAAwD;YAC1D,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAc;QAI9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QAClC,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,UAAU,GAAG,IAAI,IAAI,CACzB,KAAK,CAAC,WAAW,EAAE,EACnB,KAAK,CAAC,QAAQ,EAAE,EAChB,KAAK,CAAC,OAAO,EAAE,CAChB,CAAC,OAAO,EAAE,CAAC;QACZ,MAAM,WAAW,GAAG,UAAU,GAAG,EAAE,GAAG,KAAK,CAAC;QAC5C,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC5C,YAAY,EAAE,CAAC,cAAc,CAAC,mBAAmB,CAAC,MAAM,CAAC;YACzD,YAAY,EAAE,CAAC,cAAc,CAAC,WAAW,CAAC,MAAM,EAAE;gBAChD,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,cAAc;aACxB,CAAC;SACH,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;YAC7C,SAAS,EAAE,CAAC;YACZ,MAAM,EAAE,CAAC;SACV,CAAC,CAAC,CAAC;QACJ,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,aAAa,GAAG,WAAW,CAAC,GAAG,KAAK,CAAC,CAAC;YACpE,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,EAAE;gBAAE,SAAS;YACvC,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW;gBAAE,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC;iBACtD,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ;gBAAE,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAAc;QAC/B,OAAO,YAAY,EAAE,CAAC,cAAc,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC1E,CAAC;CACF;AAED,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,EAAE,CAAC;AAClD,eAAe,iBAAiB,CAAC"}

package/backend/dist/services/builtinToolsService.d.ts

@@ -0,0 +1,20 @@
+import type { AuthzActor } from './authorizationService.js';
+import type { EffectiveTool } from '../types/tools.js';
+export interface BuiltinToolContext {
+    actor: AuthzActor;
+    sessionId?: string;
+    signal?: AbortSignal;
+    /** Assistant-profile bindings scoping this turn, when a persona binds them. */
+    skillIds?: readonly string[];
+    collectionIds?: readonly string[];
+}
+export interface BuiltinToolResult {
+    text: string;
+    isError: boolean;
+    truncated: boolean;
+}
+export declare const BUILTIN_TOOL_NAMES: readonly string[];
+/** The builtin tools available to this actor, optionally filtered by name. */
+export declare function effectiveBuiltinTools(context: BuiltinToolContext, names?: readonly string[]): Promise<EffectiveTool[]>;
+export declare function executeBuiltinTool(name: string, args: Record<string, unknown>, context: BuiltinToolContext): Promise<BuiltinToolResult>;
+//# sourceMappingURL=builtinToolsService.d.ts.map

package/backend/dist/services/builtinToolsService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtinToolsService.d.ts","sourceRoot":"","sources":["../../src/services/builtinToolsService.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAgCvD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB;AA6pBD,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAE/C,CAAC;AAEF,8EAA8E;AAC9E,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,kBAAkB,EAC3B,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GACxB,OAAO,CAAC,aAAa,EAAE,CAAC,CAmB1B;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAiB5B"}