@vibesdotdev/hq 0.0.0-stage → 1.0.0-rc.2

package/dist/host-guidance/kinds/host-health-check.kind.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `hq/host-health-check` — catalog of host health probes.
+ *
+ * Descriptors are the asset. The health command enumerates them with
+ * `runtime.query('hq/host-health-check')` and probes the entries whose
+ * platforms include the selected host's platform. There is no private probe
+ * Map/array — the runtime is the registry.
+ */
+/**
+ * No default implementation — descriptors are queried as data, not resolved
+ * into instances.
+ */
+declare class HostHealthCheckAsset {
+}
+export declare const hostHealthCheckKind: import("@vibesdotdev/kernel").RuntimeKindDescriptorRecord<HostHealthCheckAsset>;
+export {};
+//# sourceMappingURL=host-health-check.kind.d.ts.map

package/dist/host-guidance/kinds/host-health-check.kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-health-check.kind.d.ts","sourceRoot":"","sources":["../../../src/host-guidance/kinds/host-health-check.kind.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;;GAGG;AACH,cAAM,oBAAoB;CAAG;AAE7B,eAAO,MAAM,mBAAmB,iFAI9B,CAAC"}

package/dist/host-guidance/kinds/host-health-check.kind.js

@@ -0,0 +1,22 @@
+/**
+ * `hq/host-health-check` — catalog of host health probes.
+ *
+ * Descriptors are the asset. The health command enumerates them with
+ * `runtime.query('hq/host-health-check')` and probes the entries whose
+ * platforms include the selected host's platform. There is no private probe
+ * Map/array — the runtime is the registry.
+ */
+import { createRuntimeKind } from '@vibesdotdev/kernel';
+import { HostHealthCheckDescriptorSchema } from "../../schemas/host-guidance.js";
+/**
+ * No default implementation — descriptors are queried as data, not resolved
+ * into instances.
+ */
+class HostHealthCheckAsset {
+}
+export const hostHealthCheckKind = createRuntimeKind({
+    id: 'hq/host-health-check',
+    descriptorSchema: HostHealthCheckDescriptorSchema,
+    defaultImplementation: HostHealthCheckAsset
+});
+//# sourceMappingURL=host-health-check.kind.js.map

package/dist/host-guidance/kinds/host-health-check.kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-health-check.kind.js","sourceRoot":"","sources":["../../../src/host-guidance/kinds/host-health-check.kind.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAC;AAEjF;;;GAGG;AACH,MAAM,oBAAoB;CAAG;AAE7B,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;IACpD,EAAE,EAAE,sBAAsB;IAC1B,gBAAgB,EAAE,+BAA+B;IACjD,qBAAqB,EAAE,oBAAoB;CAC3C,CAAC,CAAC"}

package/dist/host-guidance/kinds/host-permission-guidance.kind.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `hq/host-permission-guidance` — catalog of host permission-guidance entries.
+ *
+ * Descriptors are the asset. The permissions command enumerates them with
+ * `runtime.query('hq/host-permission-guidance')` and keeps the entries whose
+ * platforms include the selected host's platform. There is no private
+ * guidance Map/array — the runtime is the registry.
+ */
+/**
+ * No default implementation — descriptors are queried as data, not resolved
+ * into instances.
+ */
+declare class HostPermissionGuidanceAsset {
+}
+export declare const hostPermissionGuidanceKind: import("@vibesdotdev/kernel").RuntimeKindDescriptorRecord<HostPermissionGuidanceAsset>;
+export {};
+//# sourceMappingURL=host-permission-guidance.kind.d.ts.map

package/dist/host-guidance/kinds/host-permission-guidance.kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-permission-guidance.kind.d.ts","sourceRoot":"","sources":["../../../src/host-guidance/kinds/host-permission-guidance.kind.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH;;;GAGG;AACH,cAAM,2BAA2B;CAAG;AAEpC,eAAO,MAAM,0BAA0B,wFAIrC,CAAC"}

package/dist/host-guidance/kinds/host-permission-guidance.kind.js

@@ -0,0 +1,22 @@
+/**
+ * `hq/host-permission-guidance` — catalog of host permission-guidance entries.
+ *
+ * Descriptors are the asset. The permissions command enumerates them with
+ * `runtime.query('hq/host-permission-guidance')` and keeps the entries whose
+ * platforms include the selected host's platform. There is no private
+ * guidance Map/array — the runtime is the registry.
+ */
+import { createRuntimeKind } from '@vibesdotdev/kernel';
+import { HostPermissionGuidanceDescriptorSchema } from "../../schemas/host-guidance.js";
+/**
+ * No default implementation — descriptors are queried as data, not resolved
+ * into instances.
+ */
+class HostPermissionGuidanceAsset {
+}
+export const hostPermissionGuidanceKind = createRuntimeKind({
+    id: 'hq/host-permission-guidance',
+    descriptorSchema: HostPermissionGuidanceDescriptorSchema,
+    defaultImplementation: HostPermissionGuidanceAsset
+});
+//# sourceMappingURL=host-permission-guidance.kind.js.map

package/dist/host-guidance/kinds/host-permission-guidance.kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-permission-guidance.kind.js","sourceRoot":"","sources":["../../../src/host-guidance/kinds/host-permission-guidance.kind.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,sCAAsC,EAAE,MAAM,gCAAgC,CAAC;AAExF;;;GAGG;AACH,MAAM,2BAA2B;CAAG;AAEpC,MAAM,CAAC,MAAM,0BAA0B,GAAG,iBAAiB,CAAC;IAC3D,EAAE,EAAE,6BAA6B;IACjC,gBAAgB,EAAE,sCAAsC;IACxD,qBAAqB,EAAE,2BAA2B;CAClD,CAAC,CAAC"}

package/dist/host-guidance/registry.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Host guidance catalog — thin facade over the runtime.
+ *
+ * Catalog identity comes from the runtime (`hq/host-permission-guidance` and
+ * `hq/host-health-check` descriptors); there is no private Map or static
+ * builtin array. Enumerate with:
+ *   runtime.query('hq/host-permission-guidance').descriptors()
+ *   runtime.query('hq/host-health-check').descriptors()
+ */
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { HostHealthCheckDescriptor, HostPermissionGuidanceDescriptor } from '../schemas/host-guidance.ts';
+/** Enumerate registered `hq/host-permission-guidance` descriptors ([] when unregistered). */
+export declare function listHostPermissionGuidance(runtime: VibesRuntime): HostPermissionGuidanceDescriptor[];
+/** Enumerate registered `hq/host-health-check` descriptors ([] when unregistered). */
+export declare function listHostHealthChecks(runtime: VibesRuntime): HostHealthCheckDescriptor[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/host-guidance/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/host-guidance/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EACX,yBAAyB,EACzB,gCAAgC,EAChC,MAAM,6BAA6B,CAAC;AAKrC,6FAA6F;AAC7F,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,YAAY,GAAG,gCAAgC,EAAE,CAGpG;AAED,sFAAsF;AACtF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,yBAAyB,EAAE,CAGvF"}

package/dist/host-guidance/registry.js

@@ -0,0 +1,24 @@
+/**
+ * Host guidance catalog — thin facade over the runtime.
+ *
+ * Catalog identity comes from the runtime (`hq/host-permission-guidance` and
+ * `hq/host-health-check` descriptors); there is no private Map or static
+ * builtin array. Enumerate with:
+ *   runtime.query('hq/host-permission-guidance').descriptors()
+ *   runtime.query('hq/host-health-check').descriptors()
+ */
+const GUIDANCE_KIND = 'hq/host-permission-guidance';
+const HEALTH_KIND = 'hq/host-health-check';
+/** Enumerate registered `hq/host-permission-guidance` descriptors ([] when unregistered). */
+export function listHostPermissionGuidance(runtime) {
+    if (!runtime.hasKind(GUIDANCE_KIND))
+        return [];
+    return runtime.query(GUIDANCE_KIND).descriptors();
+}
+/** Enumerate registered `hq/host-health-check` descriptors ([] when unregistered). */
+export function listHostHealthChecks(runtime) {
+    if (!runtime.hasKind(HEALTH_KIND))
+        return [];
+    return runtime.query(HEALTH_KIND).descriptors();
+}
+//# sourceMappingURL=registry.js.map

package/dist/host-guidance/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/host-guidance/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,MAAM,aAAa,GAAG,6BAAsC,CAAC;AAC7D,MAAM,WAAW,GAAG,sBAA+B,CAAC;AAEpD,6FAA6F;AAC7F,MAAM,UAAU,0BAA0B,CAAC,OAAqB;IAC/D,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC;QAAE,OAAO,EAAE,CAAC;IAC/C,OAAO,OAAO,CAAC,KAAK,CAA4C,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;AAC9F,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,oBAAoB,CAAC,OAAqB;IACzD,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7C,OAAO,OAAO,CAAC,KAAK,CAAqC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;AACrF,CAAC"}

package/dist/hq.cloud.plugin.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("@vibesdotdev/kernel").RuntimePlugin;
+export default _default;
+//# sourceMappingURL=hq.cloud.plugin.d.ts.map

package/dist/hq.cloud.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hq.cloud.plugin.d.ts","sourceRoot":"","sources":["../src/hq.cloud.plugin.ts"],"names":[],"mappings":";AAyBA,wBAsBG"}

package/dist/hq.cloud.plugin.js

@@ -0,0 +1,40 @@
+/**
+ * Cloud-safe HQ plugin.
+ *
+ * Web/worker surfaces need HQ-owned cloud descriptors, but must not import
+ * the full native HQ CLI plugin because its loaders target consumer hardware.
+ */
+import { createRuntimePlugin, loader } from '@vibesdotdev/kernel';
+import appletsToolPlugin from '@vibesdotdev/applets/cloud.plugin';
+import { heartbeatEventSourceDescriptor, continuationEventSourceDescriptor } from "./agent-events/descriptors.js";
+import osFrictionSignalsRecordDescriptor from "./friction/friction-signals.record.descriptor.js";
+import osFrictionDispositionsRecordDescriptor from "./friction/friction-dispositions.record.descriptor.js";
+// The `hq.surfaces` user-flow topic used to be registered by hq-web's own app
+// plugin, which no runtime outside that app composes — so the page shipped as
+// bytes and was reachable from nowhere. It lives with its `parent: 'hq'`
+// siblings now. Registered on BOTH hq plugins because cloud web surfaces load
+// this one and would otherwise lose a topic they serve today.
+import hqSurfacesDocsDescriptor from "./docs/hq.surfaces.docs.descriptor.js";
+import frictionClient from "./client/friction.client.descriptor.js";
+import frictionSignalRecordedEvent from "./friction/signal-recorded.event.descriptor.js";
+import hqFrictionConfig from "./config/hq-friction.config.descriptor.js";
+export default createRuntimePlugin({
+    id: 'hq',
+    name: 'HQ Module',
+    description: 'Cloud-safe HQ descriptors for web and worker surfaces',
+    descriptors: [
+        frictionClient,
+        heartbeatEventSourceDescriptor,
+        continuationEventSourceDescriptor,
+        osFrictionSignalsRecordDescriptor,
+        osFrictionDispositionsRecordDescriptor,
+        frictionSignalRecordedEvent,
+        hqFrictionConfig,
+        hqSurfacesDocsDescriptor
+    ],
+    onRegister: runtime => runtime.registerPlugin(appletsToolPlugin),
+    loaders: [
+        loader('friction', { kind: 'runtime/client', scope: 'cloud' }, () => import('./client/friction/index.js'))
+    ]
+});
+//# sourceMappingURL=hq.cloud.plugin.js.map

package/dist/hq.cloud.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hq.cloud.plugin.js","sourceRoot":"","sources":["../src/hq.cloud.plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,iBAAiB,MAAM,mCAAmC,CAAC;AAElE,OAAO,EACN,8BAA8B,EAC9B,iCAAiC,EACjC,MAAM,+BAA+B,CAAC;AACvC,OAAO,iCAAiC,MAAM,kDAAkD,CAAC;AACjG,OAAO,sCAAsC,MAAM,uDAAuD,CAAC;AAC3G,8EAA8E;AAC9E,8EAA8E;AAC9E,yEAAyE;AACzE,8EAA8E;AAC9E,8DAA8D;AAC9D,OAAO,wBAAwB,MAAM,uCAAuC,CAAC;AAC7E,OAAO,cAAc,MAAM,wCAAwC,CAAC;AACpE,OAAO,2BAA2B,MAAM,gDAAgD,CAAC;AACzF,OAAO,gBAAgB,MAAM,2CAA2C,CAAC;AAEzE,eAAe,mBAAmB,CAAC;IAClC,EAAE,EAAE,IAAI;IACR,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,uDAAuD;IACpE,WAAW,EAAE;QACZ,cAAc;QACd,8BAA8B;QAC9B,iCAAiC;QACjC,iCAAiC;QACjC,sCAAsC;QACtC,2BAA2B;QAC3B,gBAAgB;QAChB,wBAAwB;KACxB;IACD,UAAU,EAAE,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC;IAChE,OAAO,EAAE;QACR,MAAM,CACL,UAAU,EACV,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,EAAE,EAC1C,GAAG,EAAE,CAAC,MAAM,CAAC,4BAA4B,CAAC,CAC1C;KACD;CACD,CAAC,CAAC"}

package/dist/hq.consumer.plugin.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("@vibesdotdev/kernel").RuntimePlugin;
+export default _default;
+//# sourceMappingURL=hq.consumer.plugin.d.ts.map

package/dist/hq.consumer.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hq.consumer.plugin.d.ts","sourceRoot":"","sources":["../src/hq.consumer.plugin.ts"],"names":[],"mappings":";AAIA,wBAUG"}

package/dist/hq.consumer.plugin.js

@@ -0,0 +1,15 @@
+/** Native host additions; compose alongside the universal HQ plugin. */
+import { createRuntimePlugin, loader } from '@vibesdotdev/kernel';
+import appletsToolPlugin from '@vibesdotdev/applets/consumer.plugin';
+export default createRuntimePlugin({
+    id: 'hq.consumer',
+    name: 'HQ consumer capabilities',
+    dependencies: ['hq'],
+    onRegister: runtime => runtime.registerPlugin(appletsToolPlugin),
+    loaders: [
+        loader('hq-surface', { kind: 'tools/approval-channel', scope: 'consumer' }, () => import('./approval/surface-approval-channel.impl.js')),
+        loader('hq', { kind: 'runtime/client', scope: 'consumer' }, () => import('./client/index.js')),
+        loader('friction', { kind: 'runtime/client', scope: 'consumer' }, () => import('./client/friction/index.js'))
+    ]
+});
+//# sourceMappingURL=hq.consumer.plugin.js.map

package/dist/hq.consumer.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hq.consumer.plugin.js","sourceRoot":"","sources":["../src/hq.consumer.plugin.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,iBAAiB,MAAM,sCAAsC,CAAC;AAErE,eAAe,mBAAmB,CAAC;IAClC,EAAE,EAAE,aAAa;IACjB,IAAI,EAAE,0BAA0B;IAChC,YAAY,EAAE,CAAC,IAAI,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC;IAChE,OAAO,EAAE;QACR,MAAM,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,wBAAwB,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,6CAA6C,CAAC,CAAC;QACxI,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;QAC9F,MAAM,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,4BAA4B,CAAC,CAAC;KAC7G;CACD,CAAC,CAAC"}

package/dist/hq.plugin.d.ts

@@ -0,0 +1,9 @@
+/**
+ * HQ Plugin
+ *
+ * Agent-ops surface: channels, surface notifications, app auth, dashboard,
+ * setup, friction signal-store. Universal descriptor and job composition.
+ */
+declare const defaultExport: import("@vibesdotdev/kernel").RuntimePlugin;
+export default defaultExport;
+//# sourceMappingURL=hq.plugin.d.ts.map

package/dist/hq.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hq.plugin.d.ts","sourceRoot":"","sources":["../src/hq.plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+DH,QAAA,MAAM,aAAa,6CAqDjB,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/hq.plugin.js

@@ -0,0 +1,99 @@
+/**
+ * HQ Plugin
+ *
+ * Agent-ops surface: channels, surface notifications, app auth, dashboard,
+ * setup, friction signal-store. Universal descriptor and job composition.
+ */
+import { createRuntimePlugin, loader } from '@vibesdotdev/kernel';
+// Runtime client descriptors
+import hqClient from "./client/hq.client.descriptor.js";
+import hqFrictionClient from "./client/friction.client.descriptor.js";
+// Auth record descriptors
+import hqAppAuthTokens from "./app/auth/hq.app-auth-tokens.record.descriptor.js";
+import hqAppAuthPairings from "./app/auth/hq.app-auth-pairings.record.descriptor.js";
+import hqAppAuthMachine from "./app/auth/hq.app-auth-machine.record.descriptor.js";
+// Channel + surface record/logging descriptors now live in @vibesdotdev/os
+// and are composed via its os.plugin (see os/src/os.plugin.ts).
+// OS-service catalog — `hq/os-service` kind + builtin daemon descriptors.
+// The runtime is the registry; no private BUILTIN_SERVICES array.
+import { osServiceKind } from "./services/kinds/os-service.kind.js";
+import vibesPmService from "./services/descriptors/vibes-pm.os-service.descriptor.js";
+import vibesMcpService from "./services/descriptors/vibes-mcp.os-service.descriptor.js";
+import vibesBridgeService from "./services/descriptors/vibes-bridge.os-service.descriptor.js";
+// Host guidance — `hq/host-permission-guidance` + `hq/host-health-check`
+// kinds and the builtin macOS descriptors. Data only: the universal plugin
+// stays scope-pure, and another host or user plugin extends by registering
+// its own descriptors.
+import { hostPermissionGuidanceKind } from "./host-guidance/kinds/host-permission-guidance.kind.js";
+import { hostHealthCheckKind } from "./host-guidance/kinds/host-health-check.kind.js";
+import macosAccessibilityGuidance from "./host-guidance/descriptors/accessibility.host-permission-guidance.descriptor.js";
+import macosDiskGuidance from "./host-guidance/descriptors/disk.host-permission-guidance.descriptor.js";
+import macosMicrophoneGuidance from "./host-guidance/descriptors/microphone.host-permission-guidance.descriptor.js";
+import homebrewHealthCheck from "./host-guidance/descriptors/homebrew.host-health-check.descriptor.js";
+// Friction loop — signal-store half (gate half moved to @vibesdotdev/kernel/authz)
+import hqFrictionSignalsRecord from "./friction/friction-signals.record.descriptor.js";
+import hqFrictionDispositionsRecord from "./friction/friction-dispositions.record.descriptor.js";
+import hqFrictionCluster from "./friction/jobs/friction-clusters.job.descriptor.js";
+import hqFrictionSignalRecordedEvent from "./friction/signal-recorded.event.descriptor.js";
+import hqFrictionConfig from "./config/hq-friction.config.descriptor.js";
+// Sync bridge
+import appAuthSyncBridge from "./app/sync/hq.app-auth.sync-bridge.descriptor.js";
+// Presence event-source descriptors
+import { heartbeatEventSourceDescriptor, continuationEventSourceDescriptor } from "./agent-events/descriptors.js";
+import hqMachinesDocsDescriptor from "./docs/hq.machines.docs.descriptor.js";
+import hqSessionsDocsDescriptor from "./docs/hq.sessions.docs.descriptor.js";
+import hqTerminalDocsDescriptor from "./docs/hq.terminal.docs.descriptor.js";
+import hqSurfacesDocsDescriptor from "./docs/hq.surfaces.docs.descriptor.js";
+// Approval: the hq-surface channel and the job that announces an answered request
+import hqSurfaceApprovalChannel from "./approval/surface-approval-channel.descriptor.js";
+import hqApprovalResolvedJob from "./approval/approval-resolved.job.descriptor.js";
+import hqApprovalSurfaceUpdated from "./approval/approval-resolved.subscription.descriptor.js";
+import hqApprovalResolvedEvent from "./approval/approval-resolved.event.descriptor.js";
+// Hoisted const: tsc rewriteRelativeImportExtensions does not rewrite `.ts` specifiers inside `export default <expr>` (TS 6.0.3).
+const defaultExport = createRuntimePlugin({
+    id: 'hq',
+    name: 'HQ Module',
+    description: 'Agent-ops surface: channels, surface notifications, app auth, dashboard, setup, friction signal-store',
+    kinds: [osServiceKind, hostPermissionGuidanceKind, hostHealthCheckKind],
+    descriptors: [
+        // OS-service catalog (queried via runtime.query('hq/os-service'))
+        vibesPmService,
+        vibesMcpService,
+        vibesBridgeService,
+        // Host guidance catalog (queried via runtime.query at call time)
+        macosAccessibilityGuidance,
+        macosDiskGuidance,
+        macosMicrophoneGuidance,
+        homebrewHealthCheck,
+        appAuthSyncBridge,
+        hqClient,
+        hqFrictionClient,
+        hqAppAuthTokens,
+        hqAppAuthPairings,
+        hqAppAuthMachine,
+        hqFrictionSignalsRecord,
+        hqFrictionDispositionsRecord,
+        hqFrictionCluster,
+        hqFrictionSignalRecordedEvent,
+        hqFrictionConfig,
+        // Presence event-source descriptors
+        heartbeatEventSourceDescriptor,
+        continuationEventSourceDescriptor,
+        // Docs topics
+        hqMachinesDocsDescriptor,
+        hqSessionsDocsDescriptor,
+        hqTerminalDocsDescriptor,
+        hqSurfacesDocsDescriptor,
+        // Approval
+        hqSurfaceApprovalChannel,
+        hqApprovalResolvedJob,
+        hqApprovalSurfaceUpdated,
+        hqApprovalResolvedEvent
+    ],
+    loaders: [
+        loader('hq.friction.cluster', { kind: 'workers/job' }, () => import('./friction/jobs/friction-clusters.job.impl.js')),
+        loader('hq.approval.resolved', { kind: 'workers/job' }, () => import('./approval/approval-resolved.job.impl.js')),
+    ]
+});
+export default defaultExport;
+//# sourceMappingURL=hq.plugin.js.map

package/dist/hq.plugin.js.map

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

package/dist/installers/builtin/ai-runtimes/installer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * AI Runtimes Installer
+ *
+ * Installs native AI runtimes: MLX, faster-whisper, llama-cpp, diffusers.
+ * Python packages are installed in conda/venv (never system Python).
+ */
+import type { Installer } from '@vibesdotdev/config/setup/installers';
+interface RuntimeDefinition {
+    id: string;
+    name: string;
+    description: string;
+    pythonPackages: string[];
+    systemDeps?: string[];
+    platforms: string[];
+    minMemory?: number;
+}
+declare const RUNTIMES: RuntimeDefinition[];
+export declare const aiRuntimeInstallers: Installer<unknown>[];
+export { RUNTIMES };
+export type { RuntimeDefinition };
+//# sourceMappingURL=installer.d.ts.map

package/dist/installers/builtin/ai-runtimes/installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../../../src/installers/builtin/ai-runtimes/installer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAwD,MAAM,sCAAsC,CAAC;AAQ5H,UAAU,iBAAiB;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,QAAA,MAAM,QAAQ,EAAE,iBAAiB,EAmEhC,CAAC;AAuMF,eAAO,MAAM,mBAAmB,sBAAuC,CAAC;AAExE,OAAO,EAAE,QAAQ,EAAE,CAAC;AACpB,YAAY,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/installers/builtin/ai-runtimes/installer.js

@@ -0,0 +1,244 @@
+/**
+ * AI Runtimes Installer
+ *
+ * Installs native AI runtimes: MLX, faster-whisper, llama-cpp, diffusers.
+ * Python packages are installed in conda/venv (never system Python).
+ */
+import { runCapture } from '@vibesdotdev/kernel/execution';
+import { getRuntimePath } from "../../../runtime-path.js";
+import { runInherit } from "../../../utils/exec.js";
+import { fileExists } from "../../../utils/fs.js";
+import { detectPlatform } from "../../core/platform.js";
+import { createInstallerResult } from "../../core/installer-result.js";
+import { installerRuntime } from "../../core/installer-runtime.js";
+const RUNTIMES = [
+    {
+        id: 'mlx',
+        name: 'MLX Runtime',
+        description: 'Apple Silicon optimized ML runtime for LLMs and Whisper',
+        pythonPackages: ['mlx', 'mlx-lm', 'mlx-whisper'],
+        platforms: ['darwin-arm64'],
+        minMemory: 8
+    },
+    {
+        id: 'mlx-vlm',
+        name: 'MLX Vision Models',
+        description: 'MLX vision and multimodal model support',
+        pythonPackages: ['mlx-vlm'],
+        platforms: ['darwin-arm64'],
+        minMemory: 16
+    },
+    {
+        id: 'faster-whisper',
+        name: 'Faster Whisper',
+        description: 'CTranslate2-based Whisper (fast, CUDA support)',
+        pythonPackages: ['faster-whisper'],
+        systemDeps: ['ffmpeg'],
+        platforms: ['darwin-arm64', 'darwin-x64', 'linux-x64', 'win32-x64'],
+        minMemory: 4
+    },
+    {
+        id: 'llama-cpp',
+        name: 'llama.cpp',
+        description: 'Cross-platform LLM inference in C++',
+        pythonPackages: ['llama-cpp-python'],
+        platforms: ['darwin-arm64', 'darwin-x64', 'linux-x64', 'win32-x64'],
+        minMemory: 8
+    },
+    {
+        id: 'diffusers',
+        name: 'Diffusers',
+        description: 'HuggingFace Diffusers for image generation',
+        pythonPackages: ['diffusers', 'transformers', 'accelerate', 'safetensors'],
+        systemDeps: ['ffmpeg'],
+        platforms: ['darwin-arm64', 'darwin-x64', 'linux-x64'],
+        minMemory: 16
+    },
+    {
+        id: 'transformers',
+        name: 'Transformers',
+        description: 'HuggingFace Transformers for NLP and vision',
+        pythonPackages: ['transformers', 'tokenizers', 'safetensors'],
+        platforms: ['darwin-arm64', 'darwin-x64', 'linux-x64', 'win32-x64'],
+        minMemory: 8
+    },
+    {
+        id: 'sentence-transformers',
+        name: 'Sentence Transformers',
+        description: 'Embedding models for semantic search',
+        pythonPackages: ['sentence-transformers'],
+        platforms: ['darwin-arm64', 'darwin-x64', 'linux-x64', 'win32-x64'],
+        minMemory: 4
+    },
+    {
+        id: 'audiocraft',
+        name: 'AudioCraft',
+        description: "Meta's audio generation (MusicGen, AudioGen)",
+        pythonPackages: ['audiocraft'],
+        platforms: ['darwin-arm64', 'darwin-x64', 'linux-x64'],
+        minMemory: 16
+    }
+];
+async function detectPythonEnv(runtime, vibesHome) {
+    const p = await getRuntimePath(runtime);
+    // Check for active conda
+    const condaPrefix = runtime.getEnv('CONDA_PREFIX');
+    if (condaPrefix) {
+        return {
+            type: 'conda',
+            path: condaPrefix,
+            python: p.join(condaPrefix, 'bin', 'python'),
+            pip: p.join(condaPrefix, 'bin', 'pip'),
+            name: runtime.getEnv('CONDA_DEFAULT_ENV')
+        };
+    }
+    // Check for active venv
+    const virtualEnv = runtime.getEnv('VIRTUAL_ENV');
+    if (virtualEnv) {
+        return {
+            type: 'venv',
+            path: virtualEnv,
+            python: p.join(virtualEnv, 'bin', 'python'),
+            pip: p.join(virtualEnv, 'bin', 'pip'),
+            name: virtualEnv.split('/').pop()
+        };
+    }
+    // Check for vibes-managed venv
+    const vibesVenv = p.join(vibesHome, 'venv');
+    if (await fileExists(runtime, p.join(vibesVenv, 'pyvenv.cfg'))) {
+        return {
+            type: 'venv',
+            path: vibesVenv,
+            python: p.join(vibesVenv, 'bin', 'python'),
+            pip: p.join(vibesVenv, 'bin', 'pip'),
+            name: 'vibes'
+        };
+    }
+    return null;
+}
+async function createVibesVenv(runtime, vibesHome) {
+    const p = await getRuntimePath(runtime);
+    const vibesVenv = p.join(vibesHome, 'venv');
+    const exitCode = await runInherit(runtime, 'python3', ['-m', 'venv', vibesVenv], {
+        envMode: 'inherit',
+        inheritReason: 'creating a virtualenv needs the host python and PATH'
+    });
+    if (exitCode !== 0) {
+        throw new Error('Failed to create virtual environment');
+    }
+    return {
+        type: 'venv',
+        path: vibesVenv,
+        python: p.join(vibesVenv, 'bin', 'python'),
+        pip: p.join(vibesVenv, 'bin', 'pip'),
+        name: 'vibes'
+    };
+}
+// Installer Factory
+function createRuntimeInstaller(runtime) {
+    const metadata = {
+        id: `ai-runtime-${runtime.id}`,
+        name: runtime.name,
+        version: '1.0.0',
+        description: runtime.description,
+        category: 'ai',
+        hardware: 'consumer',
+        dependencies: [],
+        defaultEnabled: true,
+        tags: [
+            'group:ai-runtimes', 'ai', 'python', runtime.id,
+            ...runtime.platforms.map(platform => `platform:${platform}`),
+            'hq-category:ai-runtimes',
+            ...runtime.platforms.map(platform => `hq-platform:${platform}`)
+        ]
+    };
+    return {
+        metadata,
+        async isInstalled(context) {
+            const hostRuntime = installerRuntime(context);
+            // Installed when the managed environment already carries this runtime's packages.
+            const env = await detectPythonEnv(hostRuntime, context.vibesHome);
+            if (!env)
+                return false;
+            const probe = await runCapture(hostRuntime, env.pip, ['show', ...runtime.pythonPackages], {
+                envMode: 'inherit',
+                inheritReason: 'a pip show probe runs in the managed venv environment'
+            });
+            return probe.exitCode === 0;
+        },
+        async install(context) {
+            const { ui, options, logger } = context;
+            const hostRuntime = installerRuntime(context);
+            if (options.dryRun) {
+                ui?.info?.(`[dry-run] Would install ${runtime.name}`);
+                return createInstallerResult(metadata, { success: true, skipped: ['Dry run'], dryRun: true });
+            }
+            // Get or create Python environment
+            let env = await detectPythonEnv(hostRuntime, context.vibesHome);
+            if (!env) {
+                if (options.interactive) {
+                    ui?.info?.(`No Python virtual environment detected. Creating one under ${context.vibesHome}...`);
+                }
+                env = await createVibesVenv(hostRuntime, context.vibesHome);
+            }
+            // Install system dependencies if needed
+            if (runtime.systemDeps && runtime.systemDeps.length > 0) {
+                ui?.info?.(`Installing system dependencies: ${runtime.systemDeps.join(', ')}`);
+                if (detectPlatform(hostRuntime).startsWith('darwin-')) {
+                    const exitCode = await runInherit(hostRuntime, 'brew', ['install', ...runtime.systemDeps], {
+                        envMode: 'inherit',
+                        inheritReason: 'installing system packages needs the host PATH and Homebrew environment'
+                    });
+                    if (exitCode !== 0) {
+                        return createInstallerResult(metadata, { success: false, error: 'Failed to install system dependencies. Please install Homebrew first.', skipped: [] });
+                    }
+                }
+                else if (detectPlatform(hostRuntime).startsWith('linux-')) {
+                    await runInherit(hostRuntime, 'sudo', ['apt-get', 'install', '-y', ...runtime.systemDeps], {
+                        envMode: 'inherit',
+                        inheritReason: 'installing system packages needs the host environment'
+                    });
+                }
+            }
+            // Install Python packages
+            ui?.info?.(`Installing ${runtime.name} packages...`);
+            logger.info(`Installing packages: ${runtime.pythonPackages.join(', ')}`);
+            const installExitCode = await runInherit(hostRuntime, env.pip, [
+                'install',
+                '--no-warn-script-location',
+                '-U',
+                ...runtime.pythonPackages
+            ], {
+                envMode: 'inherit',
+                inheritReason: 'installing python packages needs the venv environment'
+            });
+            if (installExitCode !== 0) {
+                return createInstallerResult(metadata, { success: false, error: `pip install failed with exit code ${installExitCode}`, skipped: [] });
+            }
+            ui?.success?.(`Installed ${runtime.name} successfully`);
+            return createInstallerResult(metadata, { success: true, skipped: [] });
+        },
+        async uninstall(context) {
+            if (context.options.dryRun)
+                return createInstallerResult(metadata, { success: true, skipped: ['Dry run'], dryRun: true });
+            const hostRuntime = installerRuntime(context);
+            const env = await detectPythonEnv(hostRuntime, context.vibesHome);
+            if (!env) {
+                return createInstallerResult(metadata, { success: false, error: 'No Python environment found', skipped: [] });
+            }
+            context.ui?.info?.(`Uninstalling ${runtime.name}...`);
+            const exitCode = await runInherit(hostRuntime, env.pip, ['uninstall', '-y', ...runtime.pythonPackages], {
+                envMode: 'inherit',
+                inheritReason: 'uninstalling python packages needs the venv environment'
+            });
+            if (exitCode !== 0) {
+                return createInstallerResult(metadata, { success: false, error: `pip uninstall failed with exit code ${exitCode}`, skipped: [] });
+            }
+            return createInstallerResult(metadata, { success: true, skipped: [] });
+        }
+    };
+}
+// Exports
+export const aiRuntimeInstallers = RUNTIMES.map(createRuntimeInstaller);
+export { RUNTIMES };
+//# sourceMappingURL=installer.js.map