@pellux/goodvibes-sdk 0.25.10 → 0.25.12

package/dist/_internal/platform/channels/builtin/homeassistant.js

@@ -0,0 +1,391 @@
+import { resolveSecretInput } from '../../config/secret-refs.js';
+import { HomeAssistantIntegration } from '../../integrations/homeassistant.js';
+export const HOME_ASSISTANT_SURFACE = 'homeassistant';
+export const HOME_ASSISTANT_WEBHOOK_PATH = '/webhook/homeassistant';
+export const HOME_ASSISTANT_DEFAULT_EVENT_TYPE = 'goodvibes_message';
+const HOME_ASSISTANT_TOKEN_ENV = [
+    'HOMEASSISTANT_ACCESS_TOKEN',
+    'HOME_ASSISTANT_ACCESS_TOKEN',
+    'HA_ACCESS_TOKEN',
+];
+const HOME_ASSISTANT_URL_ENV = [
+    'HOMEASSISTANT_URL',
+    'HOME_ASSISTANT_URL',
+    'HA_URL',
+];
+const HOME_ASSISTANT_WEBHOOK_SECRET_ENV = [
+    'HOMEASSISTANT_WEBHOOK_SECRET',
+    'HOME_ASSISTANT_WEBHOOK_SECRET',
+    'HA_GOODVIBES_WEBHOOK_SECRET',
+];
+export function listHomeAssistantOperatorActions() {
+    const surface = HOME_ASSISTANT_SURFACE;
+    return [
+        action(surface, 'homeassistant-manifest', 'Home Assistant manifest', 'Return the daemon/device contract consumed by the Home Assistant integration.'),
+        action(surface, 'homeassistant-status', 'Check Home Assistant', 'Check configured Home Assistant API reachability and token posture.'),
+        action(surface, 'homeassistant-list-states', 'List Home Assistant states', 'List current Home Assistant entity states with optional domain filtering.'),
+        action(surface, 'homeassistant-get-state', 'Get Home Assistant state', 'Read a single Home Assistant entity state.', {
+            type: 'object',
+            properties: { entityId: { type: 'string' } },
+            required: ['entityId'],
+        }),
+        action(surface, 'homeassistant-list-services', 'List Home Assistant services', 'List callable Home Assistant service actions.'),
+        action(surface, 'homeassistant-call-service', 'Call Home Assistant service', 'Call a Home Assistant service action such as light.turn_on.', {
+            type: 'object',
+            properties: {
+                domain: { type: 'string' },
+                service: { type: 'string' },
+                serviceData: { type: 'object', additionalProperties: true },
+                returnResponse: { type: 'boolean' },
+            },
+            required: ['domain', 'service'],
+            additionalProperties: true,
+        }, true),
+        action(surface, 'homeassistant-fire-event', 'Fire Home Assistant event', 'Fire an event on the Home Assistant event bus.', {
+            type: 'object',
+            properties: {
+                eventType: { type: 'string' },
+                eventData: { type: 'object', additionalProperties: true },
+            },
+            required: ['eventType'],
+            additionalProperties: true,
+        }, true),
+        action(surface, 'homeassistant-render-template', 'Render Home Assistant template', 'Render a Home Assistant template through the configured instance.', {
+            type: 'object',
+            properties: {
+                template: { type: 'string' },
+                variables: { type: 'object', additionalProperties: true },
+            },
+            required: ['template'],
+            additionalProperties: true,
+        }),
+        action(surface, 'homeassistant-publish-goodvibes-event', 'Publish GoodVibes event', 'Publish a GoodVibes message event into Home Assistant.', {
+            type: 'object',
+            properties: {
+                title: { type: 'string' },
+                body: { type: 'string' },
+                status: { type: 'string' },
+                metadata: { type: 'object', additionalProperties: true },
+            },
+            required: ['body'],
+            additionalProperties: true,
+        }),
+    ];
+}
+export function listHomeAssistantTools() {
+    const surface = HOME_ASSISTANT_SURFACE;
+    return [
+        tool(surface, 'homeassistant:manifest', 'homeassistant_manifest', 'Return the Home Assistant integration manifest and daemon endpoint contract.', ['homeassistant-manifest']),
+        tool(surface, 'homeassistant:status', 'homeassistant_status', 'Check Home Assistant API reachability and token posture.', ['homeassistant-status']),
+        tool(surface, 'homeassistant:states', 'homeassistant_states', 'List Home Assistant entity states.', ['homeassistant-list-states'], {
+            type: 'object',
+            properties: {
+                domain: { type: 'string' },
+                query: { type: 'string' },
+                limit: { type: 'number' },
+            },
+            additionalProperties: false,
+        }),
+        tool(surface, 'homeassistant:state', 'homeassistant_state', 'Read one Home Assistant entity state.', ['homeassistant-get-state'], {
+            type: 'object',
+            properties: { entityId: { type: 'string' } },
+            required: ['entityId'],
+            additionalProperties: false,
+        }),
+        tool(surface, 'homeassistant:services', 'homeassistant_services', 'List callable Home Assistant service actions.', ['homeassistant-list-services']),
+        tool(surface, 'homeassistant:call_service', 'homeassistant_call_service', 'Call a Home Assistant service action.', ['homeassistant-call-service'], {
+            type: 'object',
+            properties: {
+                domain: { type: 'string' },
+                service: { type: 'string' },
+                serviceData: { type: 'object', additionalProperties: true },
+                returnResponse: { type: 'boolean' },
+            },
+            required: ['domain', 'service'],
+            additionalProperties: true,
+        }),
+        tool(surface, 'homeassistant:fire_event', 'homeassistant_fire_event', 'Fire an event on the Home Assistant event bus.', ['homeassistant-fire-event'], {
+            type: 'object',
+            properties: {
+                eventType: { type: 'string' },
+                eventData: { type: 'object', additionalProperties: true },
+            },
+            required: ['eventType'],
+            additionalProperties: true,
+        }),
+        tool(surface, 'homeassistant:render_template', 'homeassistant_render_template', 'Render a Home Assistant template.', ['homeassistant-render-template'], {
+            type: 'object',
+            properties: {
+                template: { type: 'string' },
+                variables: { type: 'object', additionalProperties: true },
+            },
+            required: ['template'],
+            additionalProperties: true,
+        }),
+    ];
+}
+export async function runHomeAssistantOperatorAction(context, actionId, input) {
+    switch (actionId) {
+        case 'homeassistant-manifest':
+            return { handled: true, result: buildHomeAssistantManifest(context.deps) };
+        case 'homeassistant-status':
+            return { handled: true, result: await checkHomeAssistantStatus(context.deps) };
+        case 'homeassistant-list-states':
+            return { handled: true, result: await listHomeAssistantStates(context.deps, input) };
+        case 'homeassistant-get-state':
+            return { handled: true, result: await getHomeAssistantState(context.deps, input) };
+        case 'homeassistant-list-services':
+            return { handled: true, result: await listHomeAssistantServices(context.deps) };
+        case 'homeassistant-call-service':
+            return { handled: true, result: await callHomeAssistantService(context.deps, input) };
+        case 'homeassistant-fire-event':
+            return { handled: true, result: await fireHomeAssistantEvent(context.deps, input) };
+        case 'homeassistant-render-template':
+            return { handled: true, result: await renderHomeAssistantTemplate(context.deps, input) };
+        case 'homeassistant-publish-goodvibes-event':
+            return { handled: true, result: await publishGoodVibesEvent(context.deps, input) };
+        default:
+            return { handled: false, result: null };
+    }
+}
+export function buildHomeAssistantManifest(deps) {
+    const baseUrl = firstNonEmpty(String(deps.configManager.get('controlPlane.baseUrl') ?? ''), String(deps.configManager.get('web.publicBaseUrl') ?? '')) ?? '';
+    const eventType = String(deps.configManager.get('surfaces.homeassistant.eventType') ?? HOME_ASSISTANT_DEFAULT_EVENT_TYPE);
+    const deviceId = String(deps.configManager.get('surfaces.homeassistant.deviceId') ?? 'goodvibes-daemon') || 'goodvibes-daemon';
+    return {
+        protocolVersion: 1,
+        surface: HOME_ASSISTANT_SURFACE,
+        label: 'Home Assistant',
+        device: {
+            identifiers: [`goodvibes:${deviceId}`],
+            manufacturer: 'GoodVibes',
+            model: 'GoodVibes Daemon',
+            name: String(deps.configManager.get('surfaces.homeassistant.deviceName') ?? 'GoodVibes Daemon') || 'GoodVibes Daemon',
+        },
+        daemon: {
+            baseUrl,
+            auth: 'bearer',
+            endpoints: {
+                setup: '/api/channels/setup/homeassistant',
+                account: '/api/channels/accounts/homeassistant',
+                capabilities: '/api/channels/capabilities/homeassistant',
+                tools: '/api/channels/tools/homeassistant',
+                agentTools: '/api/channels/agent-tools/homeassistant',
+                actions: '/api/channels/actions/homeassistant',
+                directory: '/api/channels/directory/homeassistant',
+                resolveTarget: '/api/channels/targets/homeassistant/resolve',
+                webhook: HOME_ASSISTANT_WEBHOOK_PATH,
+                conversation: '/api/homeassistant/conversation',
+                conversationStream: '/api/homeassistant/conversation/stream',
+                conversationCancel: '/api/homeassistant/conversation/cancel',
+                health: '/api/homeassistant/health',
+                eventStream: '/api/control-plane/events',
+            },
+        },
+        capabilities: [
+            'conversation-ingress',
+            'agent-task-ingress',
+            'daemon-tool-catalog',
+            'daemon-agent-tools',
+            'session-binding',
+            'conversation-submit-wait',
+            'conversation-stream',
+            'conversation-cancel',
+            'stable-correlation',
+            'remote-session-ttl',
+            'homeassistant-state-read',
+            'homeassistant-service-call',
+            'homeassistant-event-delivery',
+            'control-plane-events',
+        ],
+        events: {
+            outboundEventType: eventType,
+            inboundWebhookPath: HOME_ASSISTANT_WEBHOOK_PATH,
+            inboundSecretHeaders: ['x-goodvibes-homeassistant-secret', 'authorization'],
+        },
+        recommendedServices: [
+            { name: 'goodvibes.prompt', target: 'config_entry', description: 'Submit a normal prompt to the daemon.' },
+            { name: 'goodvibes.run_agent', target: 'config_entry', description: 'Run an agent task through the daemon.' },
+            { name: 'goodvibes.cancel', target: 'config_entry', description: 'Cancel an active run or agent by id.' },
+            { name: 'goodvibes.status', target: 'config_entry', description: 'Inspect daemon, session, or agent status.' },
+        ],
+        metadata: {
+            configKeys: [
+                'surfaces.homeassistant.enabled',
+                'surfaces.homeassistant.instanceUrl',
+                'surfaces.homeassistant.accessToken',
+                'surfaces.homeassistant.webhookSecret',
+                'surfaces.homeassistant.eventType',
+                'surfaces.homeassistant.remoteSessionTtlMs',
+            ],
+            remoteSessionTtlMs: Number(deps.configManager.get('surfaces.homeassistant.remoteSessionTtlMs') ?? 20 * 60_000),
+        },
+    };
+}
+export async function createHomeAssistantClient(deps) {
+    const baseUrl = resolveHomeAssistantBaseUrl(deps.configManager, deps.serviceRegistry);
+    if (!baseUrl) {
+        throw new Error('Home Assistant instance URL is not configured.');
+    }
+    const accessToken = await resolveHomeAssistantAccessToken(deps);
+    return new HomeAssistantIntegration({
+        baseUrl,
+        accessToken: accessToken ?? undefined,
+    });
+}
+export function resolveHomeAssistantBaseUrl(configManager, serviceRegistry) {
+    return firstNonEmpty(String(configManager.get('surfaces.homeassistant.instanceUrl') ?? ''), serviceRegistry?.get('homeassistant')?.baseUrl, ...HOME_ASSISTANT_URL_ENV.map((key) => process.env[key])) ?? null;
+}
+export async function resolveHomeAssistantAccessToken(deps) {
+    return await deps.serviceRegistry?.resolveSecret('homeassistant', 'primary')
+        || await resolveConfiguredSecret(deps, deps.configManager.get('surfaces.homeassistant.accessToken'))
+        || firstNonEmpty(...HOME_ASSISTANT_TOKEN_ENV.map((key) => process.env[key]))
+        || null;
+}
+export async function resolveHomeAssistantWebhookSecret(deps) {
+    return await deps.serviceRegistry?.resolveSecret('homeassistant', 'signingSecret')
+        || await resolveConfiguredSecret(deps, deps.configManager.get('surfaces.homeassistant.webhookSecret'))
+        || firstNonEmpty(...HOME_ASSISTANT_WEBHOOK_SECRET_ENV.map((key) => process.env[key]))
+        || null;
+}
+async function checkHomeAssistantStatus(deps) {
+    const baseUrl = resolveHomeAssistantBaseUrl(deps.configManager, deps.serviceRegistry);
+    const token = await resolveHomeAssistantAccessToken(deps);
+    if (!baseUrl)
+        return { ok: false, configured: false, error: 'Home Assistant instance URL is not configured.' };
+    const client = new HomeAssistantIntegration({ baseUrl, accessToken: token ?? undefined });
+    try {
+        const api = await client.getApiStatus();
+        return {
+            ok: true,
+            configured: Boolean(token),
+            baseUrl,
+            api,
+        };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            configured: Boolean(token),
+            baseUrl,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+async function listHomeAssistantStates(deps, input) {
+    const states = await (await createHomeAssistantClient(deps)).listStates();
+    const domain = readString(input?.domain)?.replace(/\.$/, '');
+    const query = readString(input?.query)?.toLowerCase();
+    const limit = clampLimit(input?.limit, 100, 500);
+    const filtered = states.filter((state) => {
+        if (domain && !state.entity_id.startsWith(`${domain}.`))
+            return false;
+        if (!query)
+            return true;
+        return state.entity_id.toLowerCase().includes(query)
+            || state.state.toLowerCase().includes(query)
+            || JSON.stringify(state.attributes ?? {}).toLowerCase().includes(query);
+    }).slice(0, limit);
+    return { ok: true, total: states.length, returned: filtered.length, states: filtered };
+}
+async function getHomeAssistantState(deps, input) {
+    const entityId = readString(input?.entityId ?? input?.entity_id);
+    if (!entityId)
+        return { ok: false, error: 'entityId is required.' };
+    const state = await (await createHomeAssistantClient(deps)).getState(entityId);
+    return state ? { ok: true, state } : { ok: false, error: `No Home Assistant state found for ${entityId}.` };
+}
+async function listHomeAssistantServices(deps) {
+    const services = await (await createHomeAssistantClient(deps)).listServices();
+    return { ok: true, services };
+}
+async function callHomeAssistantService(deps, input) {
+    const domain = readString(input?.domain);
+    const service = readString(input?.service);
+    if (!domain || !service)
+        return { ok: false, error: 'domain and service are required.' };
+    const serviceData = readRecord(input?.serviceData ?? input?.service_data);
+    const result = await (await createHomeAssistantClient(deps)).callService({
+        domain,
+        service,
+        ...(serviceData ? { serviceData } : {}),
+        ...(typeof input?.returnResponse === 'boolean' ? { returnResponse: input.returnResponse } : {}),
+    });
+    return { ok: true, result };
+}
+async function fireHomeAssistantEvent(deps, input) {
+    const eventType = readString(input?.eventType ?? input?.event_type);
+    if (!eventType)
+        return { ok: false, error: 'eventType is required.' };
+    const result = await (await createHomeAssistantClient(deps)).fireEvent(eventType, readRecord(input?.eventData ?? input?.event_data) ?? {});
+    return { ok: true, result };
+}
+async function renderHomeAssistantTemplate(deps, input) {
+    const template = readString(input?.template);
+    if (!template)
+        return { ok: false, error: 'template is required.' };
+    const rendered = await (await createHomeAssistantClient(deps)).renderTemplate(template, readRecord(input?.variables) ?? undefined);
+    return { ok: true, rendered };
+}
+async function publishGoodVibesEvent(deps, input) {
+    const body = readString(input?.body ?? input?.message ?? input?.text);
+    if (!body)
+        return { ok: false, error: 'body is required.' };
+    const eventType = readString(input?.eventType ?? input?.event_type)
+        ?? String(deps.configManager.get('surfaces.homeassistant.eventType') || HOME_ASSISTANT_DEFAULT_EVENT_TYPE);
+    const result = await (await createHomeAssistantClient(deps)).publishGoodVibesEvent(eventType, {
+        type: readString(input?.type) ?? 'message',
+        body,
+        title: readString(input?.title),
+        status: readString(input?.status),
+        metadata: readRecord(input?.metadata) ?? {},
+    });
+    return { ok: true, eventType, result };
+}
+async function resolveConfiguredSecret(deps, value) {
+    return resolveSecretInput(value, {
+        resolveLocalSecret: deps.secretsManager ? (key) => deps.secretsManager.get(key) : undefined,
+        homeDirectory: deps.secretsManager?.getGlobalHome?.() ?? undefined,
+    });
+}
+function action(surface, id, label, description, inputSchema, dangerous = false) {
+    return {
+        id,
+        surface,
+        label,
+        description,
+        dangerous,
+        ...(inputSchema ? { inputSchema } : {}),
+        metadata: { provider: 'homeassistant' },
+    };
+}
+function tool(surface, id, name, description, actionIds, inputSchema = { type: 'object', additionalProperties: false }) {
+    return {
+        id,
+        surface,
+        name,
+        description,
+        actionIds,
+        inputSchema,
+        metadata: { provider: 'homeassistant' },
+    };
+}
+function firstNonEmpty(...values) {
+    for (const value of values) {
+        if (typeof value === 'string' && value.trim().length > 0)
+            return value.trim();
+    }
+    return undefined;
+}
+function readString(value) {
+    return typeof value === 'string' && value.trim().length > 0 ? value.trim() : undefined;
+}
+function readRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function clampLimit(value, fallback, max) {
+    const parsed = typeof value === 'number' ? value : typeof value === 'string' ? Number(value) : fallback;
+    return Math.max(1, Math.min(max, Number.isFinite(parsed) ? Math.trunc(parsed) : fallback));
+}

package/dist/_internal/platform/channels/builtin/plugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/channels/builtin/plugins.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/channels/builtin/plugins.ts"],"names":[],"mappings":"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"}

package/dist/_internal/platform/channels/builtin/plugins.js

@@ -1,4 +1,4 @@
-import { handleBlueBubblesSurfaceWebhook, handleDiscordSurfaceWebhook, handleGenericWebhookSurface, handleGoogleChatSurfaceWebhook, handleIMessageSurfaceWebhook, handleMSTeamsSurfaceWebhook, handleMattermostSurfaceWebhook, handleMatrixSurfaceWebhook, handleNtfySurfaceWebhook, handleSignalSurfaceWebhook, handleSlackSurfaceWebhook, handleTelegramSurfaceWebhook, handleWhatsAppSurfaceWebhook, } from '../../adapters/index.js';
+import { handleBlueBubblesSurfaceWebhook, handleDiscordSurfaceWebhook, handleGenericWebhookSurface, handleGoogleChatSurfaceWebhook, handleHomeAssistantSurfaceWebhook, handleIMessageSurfaceWebhook, handleMSTeamsSurfaceWebhook, handleMattermostSurfaceWebhook, handleMatrixSurfaceWebhook, handleNtfySurfaceWebhook, handleSignalSurfaceWebhook, handleSlackSurfaceWebhook, handleTelegramSurfaceWebhook, handleWhatsAppSurfaceWebhook, } from '../../adapters/index.js';
 export function registerBuiltinChannelPlugins(context) {
     context.deps.channelPlugins.register({
         id: 'surface:tui',
@@ -185,6 +185,7 @@ export function registerBuiltinChannelPlugins(context) {
         lookupDirectory: async (query, options) => context.lookupRouteDirectory('webhook', query, options),
     });
     registerRouterBackedPlugin(context, 'telegram', 'Telegram', ['ingress', 'egress', 'threaded_reply', 'interactive_actions', 'account_lifecycle', 'target_resolution', 'agent_tools'], '/webhook/telegram', handleTelegramSurfaceWebhook);
+    registerRouterBackedPlugin(context, 'homeassistant', 'Home Assistant', ['ingress', 'egress', 'threaded_reply', 'interactive_actions', 'session_binding', 'account_lifecycle', 'target_resolution', 'agent_tools'], '/webhook/homeassistant', handleHomeAssistantSurfaceWebhook);
     registerRouterBackedPlugin(context, 'google-chat', 'Google Chat', ['ingress', 'egress', 'threaded_reply', 'interactive_actions', 'account_lifecycle', 'target_resolution', 'agent_tools'], '/webhook/google-chat', handleGoogleChatSurfaceWebhook);
     registerRouterBackedPlugin(context, 'signal', 'Signal', ['ingress', 'egress', 'account_lifecycle', 'target_resolution', 'agent_tools'], '/webhook/signal', handleSignalSurfaceWebhook);
     registerRouterBackedPlugin(context, 'whatsapp', 'WhatsApp', ['ingress', 'egress', 'interactive_actions', 'account_lifecycle', 'target_resolution', 'agent_tools'], '/webhook/whatsapp', handleWhatsAppSurfaceWebhook);

package/dist/_internal/platform/channels/builtin/presentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"presentation.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/channels/builtin/presentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEvE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,mBAAmB,CAmChF;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAiCtE"}
+{"version":3,"file":"presentation.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/channels/builtin/presentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEvE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,mBAAmB,CAqChF;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAmCtE"}

package/dist/_internal/platform/channels/builtin/presentation.js

@@ -27,6 +27,8 @@ export function renderBuiltinPolicy(surface) {
             return { ...base, reasoningVisibility: 'suppress', format: 'plain', supportsThreads: false, maxChunkChars: 1_600 };
         case 'webhook':
             return { ...base, reasoningVisibility: 'private', format: 'json', supportsThreads: false, maxChunkChars: 12_000 };
+        case 'homeassistant':
+            return { ...base, reasoningVisibility: 'summary', format: 'json', supportsThreads: true, maxChunkChars: 8_000 };
         case 'signal':
         case 'whatsapp':
         case 'imessage':
@@ -48,6 +50,8 @@ export function surfaceLabelForBuiltin(surface) {
             return 'ntfy';
         case 'webhook':
             return 'Generic webhook';
+        case 'homeassistant':
+            return 'Home Assistant';
         case 'telegram':
             return 'Telegram';
         case 'google-chat':

package/dist/_internal/platform/channels/builtin/rendering.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rendering.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/channels/builtin/rendering.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAE7D,UAAU,uBAAuB;IAC/B,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,qBAAqB,EAAE,CAAC;IACzE,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAClH;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAwB9B;AAED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,cAAc,GACtB,SAAS,IAAI,EAAE,CA0BjB"}
+{"version":3,"file":"rendering.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/channels/builtin/rendering.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAE7D,UAAU,uBAAuB;IAC/B,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,QAAQ,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,qBAAqB,EAAE,CAAC;IACzE,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAClH;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CA+B9B;AAED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,cAAc,GACtB,SAAS,IAAI,EAAE,CA0BjB"}

package/dist/_internal/platform/channels/builtin/rendering.js

@@ -8,9 +8,16 @@ export async function renderBuiltinChannelEvent(context, surface, request) {
         jobId: binding?.jobId ?? request.routeId ?? `channel:${surface}`,
         runId: binding?.runId ?? request.agentId ?? request.sessionId ?? `${surface}:${Date.now()}`,
         ...(request.agentId ? { agentId: request.agentId } : {}),
+        ...(request.sessionId ? { sessionId: request.sessionId } : {}),
         status: renderStatus(request),
         includeLinks: request.phase !== 'progress',
         ...(binding ? { binding: toDeliveryRouteBinding(binding) } : {}),
+        metadata: {
+            phase: request.phase,
+            pending: request.pending ?? {},
+            renderMetadata: request.metadata,
+            eventKinds: request.events.map((event) => event.kind),
+        },
     });
     return {
         delivered: true,

package/dist/_internal/platform/channels/builtin/setup-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup-schema.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/channels/builtin/setup-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,kBAAkB,EAClB,cAAc,EACf,MAAM,aAAa,CAAC;AAMrB,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,GAAG,kBAAkB,CA6cjF"}
+{"version":3,"file":"setup-schema.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/channels/builtin/setup-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,kBAAkB,EAClB,cAAc,EACf,MAAM,aAAa,CAAC;AAUrB,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,GAAG,kBAAkB,CAigBjF"}

package/dist/_internal/platform/channels/builtin/setup-schema.js

@@ -1,4 +1,5 @@
 import { CHANNEL_SETUP_VERSION, DEFAULT_SECRET_BACKENDS, } from './shared.js';
+import { HOME_ASSISTANT_DEFAULT_EVENT_TYPE, HOME_ASSISTANT_WEBHOOK_PATH, } from './homeassistant.js';
 export function getBuiltinSetupSchema(surface) {
     switch (surface) {
         case 'tui':
@@ -167,6 +168,58 @@ export function getBuiltinSetupSchema(surface) {
                 ],
                 metadata: {},
             };
+        case 'homeassistant':
+            return {
+                surface,
+                version: CHANNEL_SETUP_VERSION,
+                label: 'Home Assistant',
+                setupMode: 'bridge',
+                description: 'Home Assistant is a daemon/device surface with signed inbound callbacks, daemon event delivery, and Home Assistant REST-backed tools.',
+                fields: [
+                    setupField('enabled', 'Enabled', 'boolean', false, { configKey: 'surfaces.homeassistant.enabled', defaultValue: false }),
+                    setupField('instanceUrl', 'Instance URL', 'url', false, { configKey: 'surfaces.homeassistant.instanceUrl', placeholder: 'http://homeassistant.local:8123' }),
+                    setupField('accessToken', 'Long-lived access token', 'secret', false, { configKey: 'surfaces.homeassistant.accessToken', secretTargetId: 'primary' }),
+                    setupField('webhookSecret', 'Webhook secret', 'secret', true, { configKey: 'surfaces.homeassistant.webhookSecret', secretTargetId: 'signingSecret' }),
+                    setupField('defaultConversationId', 'Default conversation id', 'string', false, { configKey: 'surfaces.homeassistant.defaultConversationId', defaultValue: 'goodvibes' }),
+                    setupField('deviceId', 'Device id', 'string', false, { configKey: 'surfaces.homeassistant.deviceId', defaultValue: 'goodvibes-daemon' }),
+                    setupField('deviceName', 'Device name', 'string', false, { configKey: 'surfaces.homeassistant.deviceName', defaultValue: 'GoodVibes Daemon' }),
+                    setupField('eventType', 'Event type', 'string', false, { configKey: 'surfaces.homeassistant.eventType', defaultValue: HOME_ASSISTANT_DEFAULT_EVENT_TYPE }),
+                    setupField('remoteSessionTtlMs', 'Remote session idle TTL', 'number', false, { configKey: 'surfaces.homeassistant.remoteSessionTtlMs', defaultValue: 20 * 60_000 }),
+                ],
+                secretTargets: [
+                    secretTarget(surface, 'primary', 'Long-lived access token', false, 'Used by GoodVibes to read Home Assistant states, call services, render templates, and fire events.', {
+                        serviceName: 'homeassistant',
+                        serviceField: 'primary',
+                        envKeys: ['HOMEASSISTANT_ACCESS_TOKEN', 'HOME_ASSISTANT_ACCESS_TOKEN', 'HA_ACCESS_TOKEN'],
+                        configKeys: ['surfaces.homeassistant.accessToken'],
+                    }),
+                    secretTarget(surface, 'signingSecret', 'Webhook secret', true, 'Used to verify Home Assistant-originated callbacks before daemon auth is evaluated.', {
+                        serviceName: 'homeassistant',
+                        serviceField: 'signingSecret',
+                        envKeys: ['HOMEASSISTANT_WEBHOOK_SECRET', 'HOME_ASSISTANT_WEBHOOK_SECRET', 'HA_GOODVIBES_WEBHOOK_SECRET'],
+                        configKeys: ['surfaces.homeassistant.webhookSecret'],
+                    }),
+                ],
+                externalSteps: [
+                    'Create the Home Assistant custom integration with config_flow enabled and a single config entry for this daemon.',
+                    'Configure the integration with the daemon base URL and operator bearer token.',
+                    'Use /api/homeassistant/conversation for Assist conversation agents that need a final reply in the request/response cycle.',
+                    'Use /api/homeassistant/conversation/stream when the integration wants progress events before the final response.',
+                    `Send Home Assistant-originated prompts to ${HOME_ASSISTANT_WEBHOOK_PATH} with x-goodvibes-homeassistant-secret or Authorization: Bearer <webhookSecret>.`,
+                    'Subscribe the Home Assistant integration to the configured GoodVibes event type to update entities and service-call responses.',
+                    'Use the channel tool catalog endpoints to expose daemon tools and agent tools as Home Assistant service actions.',
+                ],
+                metadata: {
+                    protocolVersion: 1,
+                    webhookPath: HOME_ASSISTANT_WEBHOOK_PATH,
+                    conversationPath: '/api/homeassistant/conversation',
+                    conversationStreamPath: '/api/homeassistant/conversation/stream',
+                    conversationCancelPath: '/api/homeassistant/conversation/cancel',
+                    eventTypeDefault: HOME_ASSISTANT_DEFAULT_EVENT_TYPE,
+                    remoteSessionTtlMsDefault: 20 * 60_000,
+                    manifestAction: 'homeassistant-manifest',
+                },
+            };
         case 'telegram':
             return {
                 surface,

package/dist/_internal/platform/channels/builtin/shared.d.ts

@@ -10,7 +10,7 @@ import type { ChannelPolicyManager } from '../policy-manager.js';
 import type { ChannelPluginRegistry } from '../plugin-registry.js';
 import type { ChannelProviderRuntimeManager } from '../provider-runtime.js';
 import type { RouteBindingManager } from '../route-manager.js';
-export type ManagedSurface = 'slack' | 'discord' | 'ntfy' | 'webhook' | 'telegram' | 'google-chat' | 'signal' | 'whatsapp' | 'imessage' | 'msteams' | 'bluebubbles' | 'mattermost' | 'matrix';
+export type ManagedSurface = 'slack' | 'discord' | 'ntfy' | 'webhook' | 'homeassistant' | 'telegram' | 'google-chat' | 'signal' | 'whatsapp' | 'imessage' | 'msteams' | 'bluebubbles' | 'mattermost' | 'matrix';
 export interface BuiltinChannelRuntimeDeps {
     readonly configManager: ConfigManager;
     readonly secretsManager: SecretsManager;

package/dist/_internal/platform/channels/builtin/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/channels/builtin/shared.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/channels/builtin/shared.ts"],"names":[],"mappings":"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"}

package/dist/_internal/platform/channels/builtin/shared.js

@@ -20,6 +20,8 @@ export function configSectionForSurface(surface) {
             return 'ntfy';
         case 'webhook':
             return 'webhook';
+        case 'homeassistant':
+            return 'homeassistant';
         case 'telegram':
             return 'telegram';
         case 'google-chat':

package/dist/_internal/platform/channels/builtin/surfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"surfaces.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/channels/builtin/surfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7E,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,cAAc,GAAG,sBAAsB,GAAG,IAAI,CAE/F;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,IAAI,cAAc,CAcnF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,yBAAyB,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAE/G;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAI1E;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOlG;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOlG;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOpG;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAO9F"}
+{"version":3,"file":"surfaces.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/channels/builtin/surfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7E,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,cAAc,GAAG,sBAAsB,GAAG,IAAI,CAE/F;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,IAAI,cAAc,CAenF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,yBAAyB,EAAE,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAE/G;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAI1E;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOlG;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOlG;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOpG;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAO9F"}

package/dist/_internal/platform/channels/builtin/surfaces.js

@@ -7,6 +7,7 @@ export function isManagedSurface(surface) {
         || surface === 'discord'
         || surface === 'ntfy'
         || surface === 'webhook'
+        || surface === 'homeassistant'
         || surface === 'telegram'
         || surface === 'google-chat'
         || surface === 'signal'

package/dist/_internal/platform/channels/builtin/targets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/channels/builtin/targets.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACrB,4BAA4B,EAE5B,qBAAqB,EACrB,cAAc,EACd,2BAA2B,EAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7E,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;CAC1C;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAsCvC;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,2BAA2B,GACpC,qBAAqB,GAAG,IAAI,CA0E9B;AAED,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,2BAA2B,GACpC,uBAAuB,CAUzB;AAED,wBAAsB,0CAA0C,CAC9D,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,SAAS,qBAAqB,EAAE,CAAC,CAe3C;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAIjF;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAWlC;AAED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAkSlC"}
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../../../../../src/_internal/platform/channels/builtin/targets.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACrB,4BAA4B,EAE5B,qBAAqB,EACrB,cAAc,EACd,2BAA2B,EAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7E,UAAU,oBAAoB;IAC5B,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;CAC1C;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAsCvC;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,2BAA2B,GACpC,qBAAqB,GAAG,IAAI,CA0E9B;AAED,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,2BAA2B,GACpC,uBAAuB,CAUzB;AAED,wBAAsB,0CAA0C,CAC9D,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,SAAS,qBAAqB,EAAE,CAAC,CAe3C;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAIjF;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAWlC;AAED,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,oBAAoB,EAC7B,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,4BAA4B,GACrC,OAAO,CAAC,qBAAqB,EAAE,CAAC,CA2TlC"}

package/dist/_internal/platform/channels/builtin/targets.js

@@ -298,6 +298,30 @@ export async function lookupBuiltinProviderDirectory(context, surface, query, op
                 metadata: { provider: 'ntfy', baseUrl: context.deps.configManager.get('surfaces.ntfy.baseUrl') },
             }], needle, limit);
     }
+    if (surface === 'homeassistant') {
+        const conversationId = surfaces.homeassistant.defaultConversationId || surfaces.homeassistant.deviceId || 'goodvibes';
+        const candidates = [{
+                id: conversationId,
+                surface,
+                kind: 'service',
+                label: surfaces.homeassistant.deviceName || 'GoodVibes Daemon',
+                handle: conversationId,
+                groupId: conversationId,
+                isGroupConversation: false,
+                searchText: [
+                    conversationId,
+                    surfaces.homeassistant.deviceId,
+                    surfaces.homeassistant.deviceName,
+                    surfaces.homeassistant.instanceUrl,
+                ].filter(Boolean).join(' '),
+                metadata: {
+                    provider: 'homeassistant',
+                    instanceUrl: surfaces.homeassistant.instanceUrl,
+                    eventType: surfaces.homeassistant.eventType,
+                },
+            }];
+        return filterProviderDirectory(candidates, needle, limit);
+    }
     if (surface === 'telegram') {
         const candidates = [];
         if (surfaces.telegram.defaultChatId) {