@fastybird/smart-panel-backend 1.0.0-beta.2 → 1.1.0-alpha.0

package/dist/modules/buddy/services/context-planner/buddy-context-scope-resolver.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveConversationSpaceHint = resolveConversationSpaceHint;
+exports.resolveCombinedSpaceIds = resolveCombinedSpaceIds;
+exports.resolveEnergySpaceIds = resolveEnergySpaceIds;
+exports.resolveCurrentStateClauseSpaceIds = resolveCurrentStateClauseSpaceIds;
+exports.resolveCurrentStateSpaceIds = resolveCurrentStateSpaceIds;
+exports.resolveTemporalHomeSpaceIds = resolveTemporalHomeSpaceIds;
+exports.isHistoricalHomeConditionSegment = isHistoricalHomeConditionSegment;
+const buddy_context_language_1 = require("./buddy-context-language");
+const buddy_context_message_analysis_1 = require("./buddy-context-message-analysis");
+const buddy_context_planner_grammar_1 = require("./buddy-context-planner-grammar");
+function resolveConversationSpaceHint(message, conversationSpaceId, explicitSpaceIds = []) {
+    if (buddy_context_planner_grammar_1.WHOLE_HOME_SCOPE_PATTERN.test(message))
+        return undefined;
+    const uniqueExplicitSpaceIds = [...new Set(explicitSpaceIds)];
+    if (uniqueExplicitSpaceIds.length === 1)
+        return uniqueExplicitSpaceIds[0];
+    if (uniqueExplicitSpaceIds.length > 1)
+        return undefined;
+    if (buddy_context_planner_grammar_1.UNSCOPED_AGGREGATE_READ_PATTERN.test(message) && !buddy_context_planner_grammar_1.CONTEXTUAL_SCOPE_PATTERN.test(message))
+        return undefined;
+    if (buddy_context_planner_grammar_1.HOME_INSTALLATION_PATTERN.test(message))
+        return undefined;
+    if ([...buddy_context_planner_grammar_1.BUILT_IN_ACTION_SPACE_NAMES].some((spaceName) => (0, buddy_context_language_1.containsNormalizedPhrase)(message, spaceName))) {
+        return undefined;
+    }
+    return conversationSpaceId ?? undefined;
+}
+function resolveCombinedSpaceIds(message, explicitSpaces, explicitSpaceIds, conversationSpaceId) {
+    if (!conversationSpaceId)
+        return [...explicitSpaceIds];
+    if (!buddy_context_planner_grammar_1.CONTEXTUAL_SCOPE_PATTERN.test(message)) {
+        return [...new Set(explicitSpaceIds.length > 0 ? explicitSpaceIds : [conversationSpaceId])];
+    }
+    const contextualIndex = message.search(buddy_context_planner_grammar_1.CONTEXTUAL_SCOPE_PATTERN);
+    const firstExplicitIndex = (0, buddy_context_language_1.findExplicitSpaceOccurrences)(message, explicitSpaces)
+        .map((occurrence) => occurrence.range.start)
+        .sort((left, right) => left - right)[0];
+    const orderedSpaceIds = firstExplicitIndex === undefined || contextualIndex < firstExplicitIndex
+        ? [conversationSpaceId, ...explicitSpaceIds]
+        : [...explicitSpaceIds, conversationSpaceId];
+    return [...new Set(orderedSpaceIds)];
+}
+function resolveEnergySpaceIds(message, explicitSpaces, conversationSpaceId) {
+    const energyClauses = (0, buddy_context_message_analysis_1.getMessageEnergyReadClauses)(message, explicitSpaces);
+    return [
+        ...new Set(energyClauses.flatMap((clause) => {
+            const clauseWithoutExplicitSpaces = (0, buddy_context_language_1.removeExplicitSpaceOccurrencesForDomain)(clause, explicitSpaces);
+            if (buddy_context_planner_grammar_1.WHOLE_HOME_SCOPE_PATTERN.test(clause) || buddy_context_planner_grammar_1.HOME_INSTALLATION_PATTERN.test(clauseWithoutExplicitSpaces)) {
+                return [undefined];
+            }
+            const directSpaceIds = explicitSpaces
+                .filter((space) => (0, buddy_context_language_1.hasExplicitSpaceOccurrence)(clause, space, explicitSpaces))
+                .map((space) => space.id);
+            const explicitSpaceIds = (0, buddy_context_message_analysis_1.expandConjoinedSpaceIds)(clause, explicitSpaces, directSpaceIds);
+            if (explicitSpaceIds.length > 0)
+                return explicitSpaceIds;
+            if (buddy_context_planner_grammar_1.CONTEXTUAL_SCOPE_PATTERN.test(clause) && conversationSpaceId)
+                return [conversationSpaceId];
+            if ([...buddy_context_planner_grammar_1.BUILT_IN_ACTION_SPACE_NAMES].some((spaceName) => (0, buddy_context_language_1.containsNormalizedPhrase)(clause, spaceName))) {
+                return [];
+            }
+            return [conversationSpaceId];
+        })),
+    ];
+}
+function resolveCurrentStateClauseSpaceIds(clause, explicitSpaces, conversationSpaceId) {
+    const clauseSpaceIds = explicitSpaces
+        .filter((space) => (0, buddy_context_language_1.hasExplicitSpaceOccurrence)(clause, space, explicitSpaces))
+        .map((space) => space.id);
+    if (clauseSpaceIds.length > 0)
+        return clauseSpaceIds;
+    if (buddy_context_planner_grammar_1.CONTEXTUAL_SCOPE_PATTERN.test(clause) && conversationSpaceId)
+        return [conversationSpaceId];
+    const clauseWithoutExplicitSpaces = (0, buddy_context_language_1.removeExplicitSpaceOccurrencesForDomain)(clause, explicitSpaces);
+    if (buddy_context_planner_grammar_1.WHOLE_HOME_SCOPE_PATTERN.test(clauseWithoutExplicitSpaces) ||
+        buddy_context_planner_grammar_1.UNSCOPED_AGGREGATE_READ_PATTERN.test(clause.trim()) ||
+        [...buddy_context_planner_grammar_1.BUILT_IN_ACTION_SPACE_NAMES].some((spaceName) => (0, buddy_context_language_1.containsNormalizedPhrase)(clause, spaceName))) {
+        return [undefined];
+    }
+    return [conversationSpaceId];
+}
+function resolveCurrentStateSpaceIds(message, explicitSpaces, conversationSpaceId, fallbackSpaceIds) {
+    const conjoinedTemporalSpaceIds = new Set((0, buddy_context_message_analysis_1.resolveConjoinedTemporalSpaceIds)(message, explicitSpaces));
+    const currentStateClauses = (0, buddy_context_message_analysis_1.splitPlannerClauses)(message, explicitSpaces)
+        .flatMap((clause) => {
+        const normalizedClause = clause.trim();
+        const isReadPredicate = buddy_context_planner_grammar_1.READ_PATTERN.test(normalizedClause) || buddy_context_planner_grammar_1.PREDICATE_QUESTION_PATTERN.test(normalizedClause);
+        const retrievalClause = buddy_context_planner_grammar_1.ACTION_COMMAND_PATTERN.test(clause) && !isReadPredicate ? ((0, buddy_context_language_1.getActionConditionClause)(clause) ?? '') : clause;
+        const condition = /\b(?:if|when|while)\b/u.exec(retrievalClause);
+        return condition && condition.index > 0
+            ? [retrievalClause.slice(0, condition.index), retrievalClause.slice(condition.index + condition[0].length)]
+            : [retrievalClause];
+    })
+        .filter((clause) => {
+        if ((0, buddy_context_message_analysis_1.hasHistorySignalInClause)(clause) && !buddy_context_planner_grammar_1.CURRENT_STATE_PATTERN.test(clause))
+            return false;
+        if (!buddy_context_planner_grammar_1.CURRENT_STATE_PATTERN.test(clause) &&
+            explicitSpaces.some((space) => conjoinedTemporalSpaceIds.has(space.id) && (0, buddy_context_language_1.hasExplicitSpaceOccurrence)(clause, space, explicitSpaces))) {
+            return false;
+        }
+        const hasHomeSignal = buddy_context_planner_grammar_1.HOME_ENTITY_PATTERN.test(clause) ||
+            buddy_context_planner_grammar_1.HOME_VOCABULARY_PATTERN.test(clause) ||
+            buddy_context_planner_grammar_1.HOME_INSTALLATION_PATTERN.test(clause) ||
+            buddy_context_planner_grammar_1.HOME_STATE_PATTERN.test(clause) ||
+            (0, buddy_context_message_analysis_1.isPowerStateRead)(clause) ||
+            (0, buddy_context_message_analysis_1.isPowerEventStateRead)(clause, explicitSpaces) ||
+            buddy_context_planner_grammar_1.CONTEXTUAL_SCOPE_PATTERN.test(clause) ||
+            ((0, buddy_context_language_1.hasReferencePronoun)((0, buddy_context_language_1.stripContextualScopeReferences)(clause)) &&
+                (buddy_context_planner_grammar_1.CURRENT_STATE_PATTERN.test(clause) ||
+                    buddy_context_planner_grammar_1.GROUNDED_STATE_PATTERN.test(clause) ||
+                    buddy_context_planner_grammar_1.STATE_SIGNAL_PATTERN.test(clause)));
+        const hasNonHomeSignal = (0, buddy_context_message_analysis_1.hasDomainSignalInClause)(clause, buddy_context_planner_grammar_1.WEATHER_PATTERN, buddy_context_planner_grammar_1.WEATHER_ENTITY_NAME_PATTERN) ||
+            (0, buddy_context_message_analysis_1.hasEnergyReadClause)(clause, explicitSpaces) ||
+            (0, buddy_context_message_analysis_1.hasDomainSignalInClause)(clause, buddy_context_planner_grammar_1.SECURITY_PATTERN, buddy_context_planner_grammar_1.SECURITY_ENTITY_NAME_PATTERN) ||
+            buddy_context_planner_grammar_1.UNSUPPORTED_MEASUREMENT_READ_PATTERN.test(clause);
+        const hasExplicitSpace = explicitSpaces.some((space) => (0, buddy_context_language_1.hasExplicitSpaceOccurrence)(clause, space, explicitSpaces));
+        const clauseWithoutExplicitSpaces = explicitSpaces.reduce((result, space) => (0, buddy_context_language_1.removeNormalizedPhrase)(result, (0, buddy_context_language_1.normalize)(space.name)), clause);
+        const hasIndependentHomeSignal = buddy_context_planner_grammar_1.HOME_ENTITY_PATTERN.test(clauseWithoutExplicitSpaces) ||
+            buddy_context_planner_grammar_1.HOME_VOCABULARY_PATTERN.test(clauseWithoutExplicitSpaces) ||
+            buddy_context_planner_grammar_1.HOME_STATE_PATTERN.test(clauseWithoutExplicitSpaces) ||
+            buddy_context_planner_grammar_1.CONTEXTUAL_SCOPE_PATTERN.test(clauseWithoutExplicitSpaces);
+        return (hasHomeSignal &&
+            (!hasNonHomeSignal ||
+                buddy_context_planner_grammar_1.CONTEXTUAL_SCOPE_PATTERN.test(clause) ||
+                (hasExplicitSpace && hasIndependentHomeSignal) ||
+                (hasNonHomeSignal && buddy_context_planner_grammar_1.HOME_ENTITY_PATTERN.test(clauseWithoutExplicitSpaces))));
+    });
+    if (currentStateClauses.length === 0)
+        return undefined;
+    if (currentStateClauses.some((clause) => {
+        const clauseWithoutExplicitSpaces = (0, buddy_context_language_1.removeExplicitSpaceOccurrencesForDomain)(clause, explicitSpaces);
+        return (buddy_context_planner_grammar_1.HOME_INSTALLATION_PATTERN.test(clauseWithoutExplicitSpaces) ||
+            buddy_context_planner_grammar_1.WHOLE_HOME_SCOPE_PATTERN.test(clauseWithoutExplicitSpaces));
+    })) {
+        return [];
+    }
+    const explicitCurrentSpaceIds = (0, buddy_context_message_analysis_1.resolveTemporalExplicitSpaceIds)(currentStateClauses, explicitSpaces, buddy_context_planner_grammar_1.CURRENT_STATE_PATTERN);
+    if (explicitCurrentSpaceIds.length > 0)
+        return explicitCurrentSpaceIds;
+    if (currentStateClauses.some((clause) => buddy_context_planner_grammar_1.CONTEXTUAL_SCOPE_PATTERN.test(clause)) && conversationSpaceId) {
+        return [conversationSpaceId];
+    }
+    if (currentStateClauses.some((clause) => [...buddy_context_planner_grammar_1.BUILT_IN_ACTION_SPACE_NAMES].some((spaceName) => (0, buddy_context_language_1.containsNormalizedPhrase)(clause, spaceName)))) {
+        return [];
+    }
+    if (conversationSpaceId)
+        return [conversationSpaceId];
+    if (explicitSpaces.length === 1)
+        return [explicitSpaces[0].id];
+    return [...fallbackSpaceIds];
+}
+function resolveTemporalHomeSpaceIds(message, explicitSpaces, conversationSpaceId, temporalPattern) {
+    const temporalClauses = (0, buddy_context_message_analysis_1.splitPlannerClauses)(message, explicitSpaces).flatMap((clause) => {
+        const segments = (0, buddy_context_language_1.splitConditionSegments)(clause);
+        const mainHasTemporalSignal = temporalPattern.test(segments[0]);
+        return segments.filter((segment, index) => temporalPattern.test(segment) ||
+            (index > 0 && mainHasTemporalSignal && isHistoricalHomeConditionSegment(segment, explicitSpaces)));
+    });
+    return [
+        ...new Set(temporalClauses.flatMap((clause) => {
+            if (buddy_context_planner_grammar_1.WHOLE_HOME_SCOPE_PATTERN.test(clause))
+                return [undefined];
+            const directSpaceIds = (0, buddy_context_message_analysis_1.resolveTemporalExplicitSpaceIds)([clause], explicitSpaces, temporalPattern);
+            const coordinatedSpaceIds = (0, buddy_context_message_analysis_1.expandCoordinatedTemporalPropertySpaceIds)(message, explicitSpaces, directSpaceIds);
+            const explicitSpaceIds = (0, buddy_context_message_analysis_1.expandConjoinedSpaceIds)(message, explicitSpaces, coordinatedSpaceIds);
+            if (explicitSpaceIds.length > 0)
+                return explicitSpaceIds;
+            if (buddy_context_planner_grammar_1.CONTEXTUAL_SCOPE_PATTERN.test(clause) && conversationSpaceId)
+                return [conversationSpaceId];
+            if ([...buddy_context_planner_grammar_1.BUILT_IN_ACTION_SPACE_NAMES].some((spaceName) => (0, buddy_context_language_1.containsNormalizedPhrase)(clause, spaceName))) {
+                return [];
+            }
+            return [conversationSpaceId];
+        })),
+    ];
+}
+function isHistoricalHomeConditionSegment(clause, explicitSpaces) {
+    return (/\b(?:had|remained|stayed|turned|was|were)\b/u.test(clause) &&
+        (0, buddy_context_message_analysis_1.hasHomeStateReadClause)(clause, explicitSpaces) &&
+        !(0, buddy_context_message_analysis_1.hasDomainSignalInClause)(clause, buddy_context_planner_grammar_1.WEATHER_PATTERN, buddy_context_planner_grammar_1.WEATHER_ENTITY_NAME_PATTERN) &&
+        !(0, buddy_context_message_analysis_1.hasEnergyReadClause)(clause, explicitSpaces) &&
+        !(0, buddy_context_message_analysis_1.hasDomainSignalInClause)(clause, buddy_context_planner_grammar_1.SECURITY_PATTERN, buddy_context_planner_grammar_1.SECURITY_ENTITY_NAME_PATTERN));
+}
+//# sourceMappingURL=buddy-context-scope-resolver.js.map

package/dist/modules/buddy/services/context-planner/buddy-context-scope-resolver.js.map

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

package/dist/modules/buddy/services/heartbeat.service.d.ts

@@ -1,11 +1,13 @@
-import { OnApplicationBootstrap, OnModuleDestroy } from '@nestjs/common';
+import { OnModuleDestroy } from '@nestjs/common';
 import { SchedulerRegistry } from '@nestjs/schedule';
 import { ConfigService } from '../../config/services/config.service';
+import { BaseManagedExtensionService } from '../../extensions/services/base-managed-extension.service';
+import { ConfigChangeResult } from '../../extensions/services/managed-extension-service.interface';
 import { SpacesService } from '../../spaces/services/spaces.service';
 import { BuddyContextService } from './buddy-context.service';
 import { HeartbeatEvaluator } from './heartbeat.types';
 import { SuggestionEngineService } from './suggestion-engine.service';
-export declare class HeartbeatService implements OnApplicationBootstrap, OnModuleDestroy {
+export declare class HeartbeatService extends BaseManagedExtensionService implements OnModuleDestroy {
     private readonly schedulerRegistry;
     private readonly configService;
     private readonly spacesService;
@@ -14,11 +16,22 @@ export declare class HeartbeatService implements OnApplicationBootstrap, OnModul
     private readonly logger;
     private readonly evaluators;
     private running;
+    private runningSince;
+    private intervalId;
+    private scheduledIntervalMs;
+    readonly owner: {
+        readonly kind: "module";
+        readonly type: "buddy-module";
+    };
+    readonly serviceId = "heartbeat";
     constructor(schedulerRegistry: SchedulerRegistry, configService: ConfigService, spacesService: SpacesService, contextService: BuddyContextService, suggestionEngine: SuggestionEngineService);
-    onApplicationBootstrap(): void;
-    onModuleDestroy(): void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    onModuleDestroy(): Promise<void>;
     registerEvaluator(evaluator: HeartbeatEvaluator): void;
     runCycle(): Promise<void>;
+    isHealthy(): Promise<boolean>;
+    onConfigChanged(): Promise<ConfigChangeResult>;
     private evaluateSpace;
     private isBuddyEnabled;
     private getIntervalMs;

package/dist/modules/buddy/services/heartbeat.service.js

@@ -15,14 +15,16 @@ const schedule_1 = require("@nestjs/schedule");
 const logger_1 = require("../../../common/logger");
 const http_utils_1 = require("../../../common/utils/http.utils");
 const config_service_1 = require("../../config/services/config.service");
+const base_managed_extension_service_1 = require("../../extensions/services/base-managed-extension.service");
 const spaces_service_1 = require("../../spaces/services/spaces.service");
 const buddy_constants_1 = require("../buddy.constants");
 const buddy_context_service_1 = require("./buddy-context.service");
 const suggestion_engine_service_1 = require("./suggestion-engine.service");
 const HEARTBEAT_INTERVAL_NAME = 'buddyHeartbeat';
 const EVALUATOR_TIMEOUT_MS = 10_000;
-let HeartbeatService = class HeartbeatService {
+let HeartbeatService = class HeartbeatService extends base_managed_extension_service_1.BaseManagedExtensionService {
     constructor(schedulerRegistry, configService, spacesService, contextService, suggestionEngine) {
+        super();
         this.schedulerRegistry = schedulerRegistry;
         this.configService = configService;
         this.spacesService = spacesService;
@@ -31,22 +33,77 @@ let HeartbeatService = class HeartbeatService {
         this.logger = (0, logger_1.createExtensionLogger)(buddy_constants_1.BUDDY_MODULE_NAME, 'HeartbeatService');
         this.evaluators = [];
         this.running = false;
+        this.runningSince = null;
+        this.intervalId = null;
+        this.scheduledIntervalMs = null;
+        this.owner = { kind: 'module', type: buddy_constants_1.BUDDY_MODULE_NAME };
+        this.serviceId = 'heartbeat';
     }
-    onApplicationBootstrap() {
-        const intervalMs = this.getIntervalMs();
-        const intervalId = setInterval(() => void this.runCycle(), intervalMs);
-        if (typeof intervalId === 'object' && 'unref' in intervalId) {
-            intervalId.unref();
-        }
-        this.schedulerRegistry.addInterval(HEARTBEAT_INTERVAL_NAME, intervalId);
-        this.logger.log(`Heartbeat started with interval=${intervalMs}ms`);
+    async start() {
+        await this.withLock(async () => {
+            await Promise.resolve();
+            if (this.state === 'started') {
+                return;
+            }
+            this.state = 'starting';
+            const intervalMs = this.getIntervalMs();
+            let intervalId = null;
+            try {
+                if (this.schedulerRegistry.doesExist('interval', HEARTBEAT_INTERVAL_NAME)) {
+                    this.schedulerRegistry.deleteInterval(HEARTBEAT_INTERVAL_NAME);
+                }
+                intervalId = setInterval(() => void this.runCycle(), intervalMs);
+                if (typeof intervalId === 'object' && 'unref' in intervalId) {
+                    intervalId.unref();
+                }
+                this.schedulerRegistry.addInterval(HEARTBEAT_INTERVAL_NAME, intervalId);
+                this.intervalId = intervalId;
+                this.scheduledIntervalMs = intervalMs;
+                this.state = 'started';
+                this.logger.log(`Heartbeat started with interval=${intervalMs}ms`);
+            }
+            catch (error) {
+                if (intervalId) {
+                    clearInterval(intervalId);
+                }
+                this.intervalId = null;
+                this.scheduledIntervalMs = null;
+                this.state = 'error';
+                throw error;
+            }
+        });
     }
-    onModuleDestroy() {
-        try {
-            this.schedulerRegistry.deleteInterval(HEARTBEAT_INTERVAL_NAME);
-        }
-        catch {
-        }
+    async stop() {
+        await this.withLock(async () => {
+            await Promise.resolve();
+            if (this.state === 'stopped' && this.intervalId === null) {
+                return;
+            }
+            this.state = 'stopping';
+            try {
+                if (this.schedulerRegistry.doesExist('interval', HEARTBEAT_INTERVAL_NAME)) {
+                    this.schedulerRegistry.deleteInterval(HEARTBEAT_INTERVAL_NAME);
+                }
+                else if (this.intervalId) {
+                    clearInterval(this.intervalId);
+                }
+            }
+            catch (error) {
+                this.logger.warn(`Failed to remove heartbeat interval: ${error instanceof Error ? error.message : String(error)}`);
+                if (this.intervalId) {
+                    clearInterval(this.intervalId);
+                }
+            }
+            finally {
+                this.intervalId = null;
+                this.scheduledIntervalMs = null;
+                this.state = 'stopped';
+                this.logger.log('Heartbeat stopped');
+            }
+        });
+    }
+    async onModuleDestroy() {
+        await this.stop();
     }
     registerEvaluator(evaluator) {
         this.evaluators.push(evaluator);
@@ -65,6 +122,7 @@ let HeartbeatService = class HeartbeatService {
         }
         this.running = true;
         const startTime = Date.now();
+        this.runningSince = startTime;
         try {
             const spaces = await this.spacesService.findAll();
             const enabledSpaces = spaces.filter((s) => s.suggestionsEnabled === true);
@@ -92,8 +150,20 @@ let HeartbeatService = class HeartbeatService {
         }
         finally {
             this.running = false;
+            this.runningSince = null;
         }
     }
+    isHealthy() {
+        const schedulerHasInterval = this.schedulerRegistry.doesExist('interval', HEARTBEAT_INTERVAL_NAME);
+        const cycleIsWithinBound = this.runningSince === null || Date.now() - this.runningSince <= buddy_constants_1.HEARTBEAT_MAX_CYCLE_MS;
+        return Promise.resolve(this.state === 'started' && schedulerHasInterval && cycleIsWithinBound);
+    }
+    onConfigChanged() {
+        const intervalMs = this.getIntervalMs();
+        return Promise.resolve({
+            restartRequired: this.state === 'started' && this.scheduledIntervalMs !== intervalMs,
+        });
+    }
     async evaluateSpace(spaceId) {
         const context = await this.contextService.buildContext(spaceId);
         const results = [];

package/dist/modules/buddy/services/heartbeat.service.js.map

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

package/dist/modules/buddy/services/home-context-tool-provider.service.d.ts

@@ -0,0 +1,165 @@
+import { z } from 'zod';
+import { ChannelCategory, DataTypeType, PropertyCategory } from '../../devices/devices.constants';
+import { HomeCurrentStateQueryService } from '../../home-context/services/home-current-state-query.service';
+import { HomeSearchQueryService } from '../../home-context/services/home-search-query.service';
+import { LlmToolCall, ToolDefinition, ToolExecutionContext, ToolExecutionResult } from '../../tools/platforms/tool-provider.platform';
+import { BaseToolProviderService } from '../../tools/services/base-tool-provider.service';
+import { ShortIdMappingService } from '../../tools/services/short-id-mapping.service';
+export declare const BUDDY_HOME_READ_TOOLS_PROVIDER = "buddy-home-read-tools";
+export declare const SEARCH_HOME_TOOL_NAME = "search_home";
+export declare const QUERY_HOME_STATE_TOOL_NAME = "query_home_state";
+export declare const BUDDY_CURRENT_STATE_MAX_EVIDENCE_ROWS = 20;
+export declare const searchHomeToolInputSchema: z.ZodObject<{
+    query: z.ZodString;
+    kinds: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        space: "space";
+        device: "device";
+        property: "property";
+        scene: "scene";
+    }>>>;
+    space_id: z.ZodOptional<z.ZodString>;
+    categories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    candidate_capability: z.ZodOptional<z.ZodEnum<{
+        read: "read";
+        write: "write";
+        trigger: "trigger";
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const queryHomeStateToolInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    operation: z.ZodLiteral<"rows">;
+    predicate: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        operator: z.ZodEnum<{
+            eq: "eq";
+            ne: "ne";
+        }>;
+        value: z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>;
+    }, z.core.$strict>, z.ZodObject<{
+        operator: z.ZodEnum<{
+            eq: "eq";
+            ne: "ne";
+        }>;
+        value: z.ZodNumber;
+        unit: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        operator: z.ZodEnum<{
+            gt: "gt";
+            gte: "gte";
+            lt: "lt";
+            lte: "lte";
+        }>;
+        value: z.ZodNumber;
+        unit: z.ZodString;
+    }, z.core.$strict>]>>;
+    space_id: z.ZodOptional<z.ZodString>;
+    channel_categories: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof ChannelCategory>>>;
+    property_categories: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof PropertyCategory>>>;
+    data_types: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof DataTypeType>>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    operation: z.ZodLiteral<"any">;
+    predicate: z.ZodUnion<readonly [z.ZodObject<{
+        operator: z.ZodEnum<{
+            eq: "eq";
+            ne: "ne";
+        }>;
+        value: z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>;
+    }, z.core.$strict>, z.ZodObject<{
+        operator: z.ZodEnum<{
+            eq: "eq";
+            ne: "ne";
+        }>;
+        value: z.ZodNumber;
+        unit: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        operator: z.ZodEnum<{
+            gt: "gt";
+            gte: "gte";
+            lt: "lt";
+            lte: "lte";
+        }>;
+        value: z.ZodNumber;
+        unit: z.ZodString;
+    }, z.core.$strict>]>;
+    space_id: z.ZodOptional<z.ZodString>;
+    channel_categories: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof ChannelCategory>>>;
+    property_categories: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof PropertyCategory>>>;
+    data_types: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof DataTypeType>>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    operation: z.ZodLiteral<"all">;
+    predicate: z.ZodUnion<readonly [z.ZodObject<{
+        operator: z.ZodEnum<{
+            eq: "eq";
+            ne: "ne";
+        }>;
+        value: z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>;
+    }, z.core.$strict>, z.ZodObject<{
+        operator: z.ZodEnum<{
+            eq: "eq";
+            ne: "ne";
+        }>;
+        value: z.ZodNumber;
+        unit: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        operator: z.ZodEnum<{
+            gt: "gt";
+            gte: "gte";
+            lt: "lt";
+            lte: "lte";
+        }>;
+        value: z.ZodNumber;
+        unit: z.ZodString;
+    }, z.core.$strict>]>;
+    space_id: z.ZodOptional<z.ZodString>;
+    channel_categories: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof ChannelCategory>>>;
+    property_categories: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof PropertyCategory>>>;
+    data_types: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof DataTypeType>>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+    operation: z.ZodLiteral<"count_matches">;
+    predicate: z.ZodUnion<readonly [z.ZodObject<{
+        operator: z.ZodEnum<{
+            eq: "eq";
+            ne: "ne";
+        }>;
+        value: z.ZodUnion<readonly [z.ZodString, z.ZodBoolean]>;
+    }, z.core.$strict>, z.ZodObject<{
+        operator: z.ZodEnum<{
+            eq: "eq";
+            ne: "ne";
+        }>;
+        value: z.ZodNumber;
+        unit: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        operator: z.ZodEnum<{
+            gt: "gt";
+            gte: "gte";
+            lt: "lt";
+            lte: "lte";
+        }>;
+        value: z.ZodNumber;
+        unit: z.ZodString;
+    }, z.core.$strict>]>;
+    space_id: z.ZodOptional<z.ZodString>;
+    channel_categories: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof ChannelCategory>>>;
+    property_categories: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof PropertyCategory>>>;
+    data_types: z.ZodOptional<z.ZodArray<z.ZodEnum<typeof DataTypeType>>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>], "operation">;
+export declare class HomeContextToolProviderService extends BaseToolProviderService {
+    private readonly homeSearch;
+    private readonly currentState;
+    private readonly shortIdMapping;
+    protected readonly logger: import("../../../common/logger").ExtensionLoggerService;
+    constructor(homeSearch: HomeSearchQueryService, currentState: HomeCurrentStateQueryService, shortIdMapping: ShortIdMappingService);
+    getType(): string;
+    getToolDefinitions(): ToolDefinition[];
+    protected handleToolCall(toolCall: LlmToolCall, context: ToolExecutionContext): Promise<ToolExecutionResult | null>;
+    private searchHome;
+    private queryHomeState;
+    private invalidArguments;
+    private resolveSpaceId;
+    private mapExpectedError;
+}