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

package/dist/os-wall/channels.wall.d.ts

@@ -0,0 +1,9 @@
+/**
+ * OS channel primitives used by HQ CLI. hq depends on `@vibesdotdev/os`;
+ * this module is the import seam so HQ command impls do not deep-import
+ * channel internals.
+ */
+export { listChannels, getChannel, persistChannel, registerChannel } from '@vibesdotdev/os/channels/registry';
+export { dispatchHandler } from '@vibesdotdev/os/channels/handlers/index';
+export { ChannelManager } from '@vibesdotdev/os/channels/api';
+//# sourceMappingURL=channels.wall.d.ts.map

package/dist/os-wall/channels.wall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.wall.d.ts","sourceRoot":"","sources":["../../src/os-wall/channels.wall.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACN,YAAY,EACZ,UAAU,EACV,cAAc,EACd,eAAe,EACf,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/os-wall/channels.wall.js

@@ -0,0 +1,9 @@
+/**
+ * OS channel primitives used by HQ CLI. hq depends on `@vibesdotdev/os`;
+ * this module is the import seam so HQ command impls do not deep-import
+ * channel internals.
+ */
+export { listChannels, getChannel, persistChannel, registerChannel } from '@vibesdotdev/os/channels/registry';
+export { dispatchHandler } from '@vibesdotdev/os/channels/handlers/index';
+export { ChannelManager } from '@vibesdotdev/os/channels/api';
+//# sourceMappingURL=channels.wall.js.map

package/dist/os-wall/channels.wall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.wall.js","sourceRoot":"","sources":["../../src/os-wall/channels.wall.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACN,YAAY,EACZ,UAAU,EACV,cAAc,EACd,eAAe,EACf,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/os-wall/surface-store.wall.d.ts

@@ -0,0 +1,3 @@
+/** Dynamic wall: hq must not package-depend on system (system→hq cycle). */
+export declare const listSurfaceNotifications: typeof import("@vibesdotdev/os/surface").listSurfaceNotifications, getSurfaceNotification: typeof import("@vibesdotdev/os/surface").getSurfaceNotification, writeSurfaceNotification: typeof import("@vibesdotdev/os/surface").writeSurfaceNotification, updateSurfaceNotificationArtifact: typeof import("@vibesdotdev/os/surface").updateSurfaceNotificationArtifact, resolveSurfaceNotification: typeof import("@vibesdotdev/os/surface").resolveSurfaceNotification, deleteSurfaceNotification: typeof import("@vibesdotdev/os/surface").deleteSurfaceNotification, SYSTEM_OWNER: import("@vibesdotdev/os/surface").SurfaceOwner;
+//# sourceMappingURL=surface-store.wall.d.ts.map

package/dist/os-wall/surface-store.wall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-store.wall.d.ts","sourceRoot":"","sources":["../../src/os-wall/surface-store.wall.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,eAAO,MACN,wBAAwB,qEACxB,sBAAsB,mEACtB,wBAAwB,qEACxB,iCAAiC,8EACjC,0BAA0B,uEAC1B,yBAAyB,sEACzB,YAAY,gDACoC,CAAC"}

package/dist/os-wall/surface-store.wall.js

@@ -0,0 +1,3 @@
+/** Dynamic wall: hq must not package-depend on system (system→hq cycle). */
+export const { listSurfaceNotifications, getSurfaceNotification, writeSurfaceNotification, updateSurfaceNotificationArtifact, resolveSurfaceNotification, deleteSurfaceNotification, SYSTEM_OWNER } = await import('@vibesdotdev/os/surface/store');
+//# sourceMappingURL=surface-store.wall.js.map

package/dist/os-wall/surface-store.wall.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-store.wall.js","sourceRoot":"","sources":["../../src/os-wall/surface-store.wall.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,MAAM,CAAC,MAAM,EACZ,wBAAwB,EACxB,sBAAsB,EACtB,wBAAwB,EACxB,iCAAiC,EACjC,0BAA0B,EAC1B,yBAAyB,EACzB,YAAY,EACZ,GAAG,MAAM,MAAM,CAAC,+BAA+B,CAAC,CAAC"}

package/dist/runtime-path.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The host's low-level path service, resolved per runtime. One owner:
+ * @vibesdotdev/paths (`runtime-path.accessor.ts`); this module keeps the
+ * package's existing import path.
+ */
+export { getRuntimePath } from '@vibesdotdev/paths';
+//# sourceMappingURL=runtime-path.d.ts.map

package/dist/runtime-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-path.d.ts","sourceRoot":"","sources":["../src/runtime-path.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/runtime-path.js

@@ -0,0 +1,7 @@
+/**
+ * The host's low-level path service, resolved per runtime. One owner:
+ * @vibesdotdev/paths (`runtime-path.accessor.ts`); this module keeps the
+ * package's existing import path.
+ */
+export { getRuntimePath } from '@vibesdotdev/paths';
+//# sourceMappingURL=runtime-path.js.map

package/dist/runtime-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-path.js","sourceRoot":"","sources":["../src/runtime-path.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC"}

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

@@ -0,0 +1,48 @@
+/**
+ * Host Guidance Schemas
+ *
+ * Host-specific permission guidance and host health probes are open HQ-owned
+ * kernel kinds (`hq/host-permission-guidance`, `hq/host-health-check`).
+ * Descriptors declare the host platforms they apply to; the permissions and
+ * health commands resolve them with `runtime.query(kind)` at call time and
+ * select the entries whose platforms include the selected host's platform —
+ * no `platform === 'darwin'` branches in the commands. Another host or a user
+ * plugin adds its own entries by registering descriptors, without editing the
+ * commands. Schemas stay loose so descriptors may carry extra data.
+ */
+import * as z from 'zod/v4';
+/**
+ * One permission-guidance entry: what to tell the user and, optionally, how
+ * to open the matching settings page (`command` + fixed `argv`, e.g. the
+ * macOS `open` launcher with an `x-apple.systempreferences:` URL).
+ * Registered under kind `hq/host-permission-guidance`.
+ */
+export declare const HostPermissionGuidanceDescriptorSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"hq/host-permission-guidance">;
+    id: z.ZodString;
+    type: z.ZodString;
+    label: z.ZodString;
+    details: z.ZodString;
+    platforms: z.ZodArray<z.ZodString>;
+    open: z.ZodOptional<z.ZodObject<{
+        command: z.ZodString;
+        argv: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+}, z.core.$loose>;
+/**
+ * One host health probe: when the selected host's platform is listed, the
+ * health command checks that `command` resolves in PATH. `foundMessage` /
+ * `missingMessage` default to `<id> is (not) available`.
+ * Registered under kind `hq/host-health-check`.
+ */
+export declare const HostHealthCheckDescriptorSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"hq/host-health-check">;
+    id: z.ZodString;
+    platforms: z.ZodArray<z.ZodString>;
+    command: z.ZodString;
+    foundMessage: z.ZodOptional<z.ZodString>;
+    missingMessage: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+export type HostPermissionGuidanceDescriptor = z.infer<typeof HostPermissionGuidanceDescriptorSchema>;
+export type HostHealthCheckDescriptor = z.infer<typeof HostHealthCheckDescriptorSchema>;
+//# sourceMappingURL=host-guidance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"host-guidance.d.ts","sourceRoot":"","sources":["../../src/schemas/host-guidance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B;;;;;GAKG;AACH,eAAO,MAAM,sCAAsC;;;;;;;;;;;iBAajD,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B;;;;;;;iBAO1C,CAAC;AAEH,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC;AACtG,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC"}

package/dist/schemas/host-guidance.js

@@ -0,0 +1,48 @@
+/**
+ * Host Guidance Schemas
+ *
+ * Host-specific permission guidance and host health probes are open HQ-owned
+ * kernel kinds (`hq/host-permission-guidance`, `hq/host-health-check`).
+ * Descriptors declare the host platforms they apply to; the permissions and
+ * health commands resolve them with `runtime.query(kind)` at call time and
+ * select the entries whose platforms include the selected host's platform —
+ * no `platform === 'darwin'` branches in the commands. Another host or a user
+ * plugin adds its own entries by registering descriptors, without editing the
+ * commands. Schemas stay loose so descriptors may carry extra data.
+ */
+import * as z from 'zod/v4';
+/**
+ * One permission-guidance entry: what to tell the user and, optionally, how
+ * to open the matching settings page (`command` + fixed `argv`, e.g. the
+ * macOS `open` launcher with an `x-apple.systempreferences:` URL).
+ * Registered under kind `hq/host-permission-guidance`.
+ */
+export const HostPermissionGuidanceDescriptorSchema = z.looseObject({
+    kind: z.literal('hq/host-permission-guidance'),
+    id: z.string().min(1),
+    type: z.string().min(1),
+    label: z.string().min(1),
+    details: z.string().min(1),
+    platforms: z.array(z.string().min(1)).min(1),
+    open: z
+        .object({
+        command: z.string().min(1),
+        argv: z.array(z.string()).default([])
+    })
+        .optional()
+});
+/**
+ * One host health probe: when the selected host's platform is listed, the
+ * health command checks that `command` resolves in PATH. `foundMessage` /
+ * `missingMessage` default to `<id> is (not) available`.
+ * Registered under kind `hq/host-health-check`.
+ */
+export const HostHealthCheckDescriptorSchema = z.looseObject({
+    kind: z.literal('hq/host-health-check'),
+    id: z.string().min(1),
+    platforms: z.array(z.string().min(1)).min(1),
+    command: z.string().min(1),
+    foundMessage: z.string().min(1).optional(),
+    missingMessage: z.string().min(1).optional()
+});
+//# sourceMappingURL=host-guidance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"host-guidance.js","sourceRoot":"","sources":["../../src/schemas/host-guidance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC,CAAC,WAAW,CAAC;IACnE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,6BAA6B,CAAC;IAC9C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5C,IAAI,EAAE,CAAC;SACL,MAAM,CAAC;QACP,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;KACrC,CAAC;SACD,QAAQ,EAAE;CACZ,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,WAAW,CAAC;IAC5D,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC;IACvC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC1C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC5C,CAAC,CAAC"}

package/dist/services/backends/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Platform-aware service backend selector — delegates to fleet/service-backends.
+ *
+ * The backend impls (launchd/systemd/Task Scheduler) live in
+ * `@vibesdotdev/platform/fleets/service-backends` (L7 deferral,
+ * hq-fleets-experience §X1 item 4). They are the only `launchctl` /
+ * `systemctl` / `schtasks` owner; hq keeps this thin selector so its
+ * `services/registry` facade and CLI stay backend-agnostic.
+ *
+ * `ServiceBackend` is an alias for `FleetServiceBackend` (structurally identical).
+ */
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import { type FleetServiceBackend, type FleetServiceRestartReceipt } from '@vibesdotdev/platform/fleets/service-backends';
+/**
+ * Backwards-compat alias. `FleetServiceBackend` is structurally identical (fleet uses
+ * `FleetServiceDescriptor` which matches `ServiceDescriptor` — same fields, no zod).
+ * Cast is safe: `ServiceDescriptor` from hq has every field fleet expects.
+ */
+export type ServiceBackend = FleetServiceBackend;
+/** What `restart` reports: the pid before and after, and whether it changed. */
+export type ServiceRestartReceipt = FleetServiceRestartReceipt;
+/** The OS service manager the handed runtime's host composes (its declared os). */
+export declare function getServiceBackend(runtime: VibesRuntime): Promise<ServiceBackend>;
+//# sourceMappingURL=index.d.ts.map

package/dist/services/backends/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/backends/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAEN,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,MAAM,+CAA+C,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAEjD,gFAAgF;AAChF,MAAM,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAE/D,mFAAmF;AACnF,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CAEtF"}

package/dist/services/backends/index.js

@@ -0,0 +1,17 @@
+/**
+ * Platform-aware service backend selector — delegates to fleet/service-backends.
+ *
+ * The backend impls (launchd/systemd/Task Scheduler) live in
+ * `@vibesdotdev/platform/fleets/service-backends` (L7 deferral,
+ * hq-fleets-experience §X1 item 4). They are the only `launchctl` /
+ * `systemctl` / `schtasks` owner; hq keeps this thin selector so its
+ * `services/registry` facade and CLI stay backend-agnostic.
+ *
+ * `ServiceBackend` is an alias for `FleetServiceBackend` (structurally identical).
+ */
+import { getFleetServiceBackend } from '@vibesdotdev/platform/fleets/service-backends';
+/** The OS service manager the handed runtime's host composes (its declared os). */
+export async function getServiceBackend(runtime) {
+    return getFleetServiceBackend(runtime);
+}
+//# sourceMappingURL=index.js.map

package/dist/services/backends/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/backends/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACN,sBAAsB,EAGtB,MAAM,+CAA+C,CAAC;AAYvD,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAqB;IAC5D,OAAO,sBAAsB,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC"}

package/dist/services/builtin/index.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Builtin OS services — static re-exports of the catalog descriptor modules.
+ *
+ * Canonical discovery is `runtime.query('hq/os-service')` after the HQ plugin
+ * registers. These constants exist for docs and for tests that import
+ * descriptor modules without a full runtime bootstrap. They are NOT a second
+ * live catalog — CLI list/get/register go through the runtime facade below.
+ */
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { OsServiceDescriptor, ServiceDescriptor } from '../schemas/service.ts';
+/** Catalog descriptor for vibes-pm (no resolved command path). */
+export declare const VIBES_PM: OsServiceDescriptor;
+/** Catalog descriptor for vibes-mcp (no resolved command path). */
+export declare const VIBES_MCP: OsServiceDescriptor;
+/** Catalog descriptor for vibes-bridge (no resolved command path). */
+export declare const VIBES_BRIDGE: OsServiceDescriptor;
+/**
+ * Static module references only, for docs/tests that need identity without a
+ * runtime bootstrap. Prefer `listOsServiceDescriptors(runtime)` at runtime.
+ */
+export declare const BUILTIN_SERVICES: readonly [{
+    kind: "hq/os-service";
+    id: string;
+    name: string;
+    args: string[];
+    env: Record<string, string>;
+    keepAlive: boolean;
+    autoStart: boolean;
+    scope: "user" | "system";
+    tags: string[];
+    enabled: boolean;
+    description?: string | undefined;
+    command?: string | undefined;
+    workingDirectory?: string | undefined;
+    label?: string | undefined;
+    hardware?: string[] | undefined;
+}, {
+    kind: "hq/os-service";
+    id: string;
+    name: string;
+    args: string[];
+    env: Record<string, string>;
+    keepAlive: boolean;
+    autoStart: boolean;
+    scope: "user" | "system";
+    tags: string[];
+    enabled: boolean;
+    description?: string | undefined;
+    command?: string | undefined;
+    workingDirectory?: string | undefined;
+    label?: string | undefined;
+    hardware?: string[] | undefined;
+}, {
+    kind: "hq/os-service";
+    id: string;
+    name: string;
+    args: string[];
+    env: Record<string, string>;
+    keepAlive: boolean;
+    autoStart: boolean;
+    scope: "user" | "system";
+    tags: string[];
+    enabled: boolean;
+    description?: string | undefined;
+    command?: string | undefined;
+    workingDirectory?: string | undefined;
+    label?: string | undefined;
+    hardware?: string[] | undefined;
+}];
+/**
+ * Materialise every `hq/os-service` descriptor registered on the runtime, each
+ * with a resolved command path. Throws if the kind is empty (HQ plugin not
+ * registered) — that is a bootstrap error, not an empty catalog.
+ */
+export declare function listBuiltinServices(runtime: VibesRuntime): Promise<Omit<ServiceDescriptor, 'label'>[]>;
+/** Materialise one runtime `hq/os-service` descriptor by id. */
+export declare function getBuiltinService(runtime: VibesRuntime, id: string): Promise<Omit<ServiceDescriptor, 'label'> | undefined>;
+//# sourceMappingURL=index.d.ts.map

package/dist/services/builtin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/builtin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAMzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAMpF,kEAAkE;AAClE,eAAO,MAAM,QAAQ,EAAE,mBAA6B,CAAC;AACrD,mEAAmE;AACnE,eAAO,MAAM,SAAS,EAAE,mBAA8B,CAAC;AACvD,sEAAsE;AACtE,eAAO,MAAM,YAAY,EAAE,mBAAiC,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAA+C,CAAC;AAE7E;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,EAAE,CAAC,CAU5G;AAED,gEAAgE;AAChE,wBAAsB,iBAAiB,CACtC,OAAO,EAAE,YAAY,EACrB,EAAE,EAAE,MAAM,GACR,OAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAIvD"}

package/dist/services/builtin/index.js

@@ -0,0 +1,44 @@
+/**
+ * Builtin OS services — static re-exports of the catalog descriptor modules.
+ *
+ * Canonical discovery is `runtime.query('hq/os-service')` after the HQ plugin
+ * registers. These constants exist for docs and for tests that import
+ * descriptor modules without a full runtime bootstrap. They are NOT a second
+ * live catalog — CLI list/get/register go through the runtime facade below.
+ */
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { getOsServiceDescriptor, listOsServiceDescriptors, materializeServiceDescriptor } from "../registry.js";
+import vibesPm from "../descriptors/vibes-pm.os-service.descriptor.js";
+import vibesMcp from "../descriptors/vibes-mcp.os-service.descriptor.js";
+import vibesBridge from "../descriptors/vibes-bridge.os-service.descriptor.js";
+/** Catalog descriptor for vibes-pm (no resolved command path). */
+export const VIBES_PM = vibesPm;
+/** Catalog descriptor for vibes-mcp (no resolved command path). */
+export const VIBES_MCP = vibesMcp;
+/** Catalog descriptor for vibes-bridge (no resolved command path). */
+export const VIBES_BRIDGE = vibesBridge;
+/**
+ * Static module references only, for docs/tests that need identity without a
+ * runtime bootstrap. Prefer `listOsServiceDescriptors(runtime)` at runtime.
+ */
+export const BUILTIN_SERVICES = [VIBES_PM, VIBES_MCP, VIBES_BRIDGE];
+/**
+ * Materialise every `hq/os-service` descriptor registered on the runtime, each
+ * with a resolved command path. Throws if the kind is empty (HQ plugin not
+ * registered) — that is a bootstrap error, not an empty catalog.
+ */
+export async function listBuiltinServices(runtime) {
+    const catalog = listOsServiceDescriptors(runtime);
+    if (catalog.length === 0) {
+        throw new CapabilityError('listBuiltinServices: no hq/os-service descriptors on the runtime. Register the HQ plugin first.', 'UNAVAILABLE', { reason: 'os-service-catalog-unregistered', retryable: false });
+    }
+    return Promise.all(catalog.map((d) => materializeServiceDescriptor(runtime, d)));
+}
+/** Materialise one runtime `hq/os-service` descriptor by id. */
+export async function getBuiltinService(runtime, id) {
+    const base = getOsServiceDescriptor(runtime, id);
+    if (!base)
+        return undefined;
+    return materializeServiceDescriptor(runtime, base);
+}
+//# sourceMappingURL=index.js.map

package/dist/services/builtin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/services/builtin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAqB,MAAM,qBAAqB,CAAC;AACzE,OAAO,EACN,sBAAsB,EACtB,wBAAwB,EACxB,4BAA4B,EAC5B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,OAAO,MAAM,kDAAkD,CAAC;AACvE,OAAO,QAAQ,MAAM,mDAAmD,CAAC;AACzE,OAAO,WAAW,MAAM,sDAAsD,CAAC;AAE/E,kEAAkE;AAClE,MAAM,CAAC,MAAM,QAAQ,GAAwB,OAAO,CAAC;AACrD,mEAAmE;AACnE,MAAM,CAAC,MAAM,SAAS,GAAwB,QAAQ,CAAC;AACvD,sEAAsE;AACtE,MAAM,CAAC,MAAM,YAAY,GAAwB,WAAW,CAAC;AAE7D;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,YAAY,CAAU,CAAC;AAE7E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAqB;IAC9D,MAAM,OAAO,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,eAAe,CACxB,iGAAiG,EACjG,aAAa,EACb,EAAE,MAAM,EAAE,iCAAiC,EAAE,SAAS,EAAE,KAAK,EAAE,CAC/D,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,4BAA4B,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC;AAED,gEAAgE;AAChE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,OAAqB,EACrB,EAAU;IAEV,MAAM,IAAI,GAAG,sBAAsB,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACjD,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,OAAO,4BAA4B,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACpD,CAAC"}

package/dist/services/descriptors/vibes-bridge.os-service.descriptor.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Builtin OS service — Vibes Desktop (native voice interface + system tray).
+ * Registered as `hq/os-service`; the command path is materialised at use time.
+ */
+import type { OsServiceDescriptor } from '../schemas/service.ts';
+declare const descriptor: OsServiceDescriptor;
+export default descriptor;
+//# sourceMappingURL=vibes-bridge.os-service.descriptor.d.ts.map

package/dist/services/descriptors/vibes-bridge.os-service.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vibes-bridge.os-service.descriptor.d.ts","sourceRoot":"","sources":["../../../src/services/descriptors/vibes-bridge.os-service.descriptor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,QAAA,MAAM,UAAU,EAAE,mBAcjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/services/descriptors/vibes-bridge.os-service.descriptor.js

@@ -0,0 +1,21 @@
+/**
+ * Builtin OS service — Vibes Desktop (native voice interface + system tray).
+ * Registered as `hq/os-service`; the command path is materialised at use time.
+ */
+const descriptor = {
+    kind: 'hq/os-service',
+    id: 'vibes-bridge',
+    name: 'Vibes Desktop',
+    description: 'Native voice interface and system tray app',
+    args: ['bridge', 'start'],
+    env: {},
+    keepAlive: true,
+    // opt-in — not everyone wants the tray app at boot
+    autoStart: false,
+    scope: 'user',
+    tags: ['builtin', 'daemon'],
+    enabled: true,
+    hardware: ['consumer']
+};
+export default descriptor;
+//# sourceMappingURL=vibes-bridge.os-service.descriptor.js.map

package/dist/services/descriptors/vibes-bridge.os-service.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vibes-bridge.os-service.descriptor.js","sourceRoot":"","sources":["../../../src/services/descriptors/vibes-bridge.os-service.descriptor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,eAAe;IACrB,EAAE,EAAE,cAAc;IAClB,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,4CAA4C;IACzD,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;IACzB,GAAG,EAAE,EAAE;IACP,SAAS,EAAE,IAAI;IACf,mDAAmD;IACnD,SAAS,EAAE,KAAK;IAChB,KAAK,EAAE,MAAM;IACb,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC3B,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE,CAAC,UAAU,CAAC;CACtB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/services/descriptors/vibes-mcp.os-service.descriptor.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Builtin OS service — Vibes MCP server.
+ * Registered as `hq/os-service`; the command path is materialised at use time.
+ */
+import type { OsServiceDescriptor } from '../schemas/service.ts';
+declare const descriptor: OsServiceDescriptor;
+export default descriptor;
+//# sourceMappingURL=vibes-mcp.os-service.descriptor.d.ts.map

package/dist/services/descriptors/vibes-mcp.os-service.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vibes-mcp.os-service.descriptor.d.ts","sourceRoot":"","sources":["../../../src/services/descriptors/vibes-mcp.os-service.descriptor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,QAAA,MAAM,UAAU,EAAE,mBAajB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/services/descriptors/vibes-mcp.os-service.descriptor.js

@@ -0,0 +1,20 @@
+/**
+ * Builtin OS service — Vibes MCP server.
+ * Registered as `hq/os-service`; the command path is materialised at use time.
+ */
+const descriptor = {
+    kind: 'hq/os-service',
+    id: 'vibes-mcp',
+    name: 'Vibes MCP Server',
+    description: 'Serves the vibes MCP protocol over HTTP',
+    args: ['dev', 'mcp', 'serve'],
+    env: {},
+    keepAlive: true,
+    autoStart: true,
+    scope: 'user',
+    tags: ['builtin', 'daemon'],
+    enabled: true,
+    hardware: ['consumer']
+};
+export default descriptor;
+//# sourceMappingURL=vibes-mcp.os-service.descriptor.js.map

package/dist/services/descriptors/vibes-mcp.os-service.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vibes-mcp.os-service.descriptor.js","sourceRoot":"","sources":["../../../src/services/descriptors/vibes-mcp.os-service.descriptor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,eAAe;IACrB,EAAE,EAAE,WAAW;IACf,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,yCAAyC;IACtD,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC;IAC7B,GAAG,EAAE,EAAE;IACP,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,KAAK,EAAE,MAAM;IACb,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC3B,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE,CAAC,UAAU,CAAC;CACtB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/services/descriptors/vibes-pm.os-service.descriptor.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Builtin OS service — Vibes PM daemon.
+ * Registered as `hq/os-service`; the command path is materialised at use time.
+ */
+import type { OsServiceDescriptor } from '../schemas/service.ts';
+declare const descriptor: OsServiceDescriptor;
+export default descriptor;
+//# sourceMappingURL=vibes-pm.os-service.descriptor.d.ts.map

package/dist/services/descriptors/vibes-pm.os-service.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vibes-pm.os-service.descriptor.d.ts","sourceRoot":"","sources":["../../../src/services/descriptors/vibes-pm.os-service.descriptor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,QAAA,MAAM,UAAU,EAAE,mBAajB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/services/descriptors/vibes-pm.os-service.descriptor.js

@@ -0,0 +1,20 @@
+/**
+ * Builtin OS service — Vibes PM daemon.
+ * Registered as `hq/os-service`; the command path is materialised at use time.
+ */
+const descriptor = {
+    kind: 'hq/os-service',
+    id: 'vibes-pm',
+    name: 'Vibes PM Daemon',
+    description: 'Manages vibes processes and channel scheduling',
+    args: ['pm', 'daemon', 'serve'],
+    env: {},
+    keepAlive: true,
+    autoStart: true,
+    scope: 'user',
+    tags: ['builtin', 'daemon'],
+    enabled: true,
+    hardware: ['consumer']
+};
+export default descriptor;
+//# sourceMappingURL=vibes-pm.os-service.descriptor.js.map

package/dist/services/descriptors/vibes-pm.os-service.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vibes-pm.os-service.descriptor.js","sourceRoot":"","sources":["../../../src/services/descriptors/vibes-pm.os-service.descriptor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,UAAU,GAAwB;IACvC,IAAI,EAAE,eAAe;IACrB,EAAE,EAAE,UAAU;IACd,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,gDAAgD;IAC7D,IAAI,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC;IAC/B,GAAG,EAAE,EAAE;IACP,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;IACf,KAAK,EAAE,MAAM;IACb,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC3B,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE,CAAC,UAAU,CAAC;CACtB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/services/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * OS Services — Boot-persistent daemon registration
+ *
+ * Supports macOS launchd and Linux systemd. Catalog identity is the
+ * `hq/os-service` runtime kind — query the runtime, never a private array.
+ */
+export type { ServiceScope, OsServiceDescriptor, ServiceDescriptor, ServiceStatus } from './schemas/service.ts';
+export { ServiceScopeSchema, OsServiceDescriptorSchema, ServiceDescriptorSchema, ServiceStatusSchema } from './schemas/service.ts';
+export { osServiceKind } from './kinds/os-service.kind.ts';
+export { registerService, unregisterService, startService, stopService, restartService, getServiceStatus, getServiceLogs, isServiceRegistered, listOsServiceDescriptors, getOsServiceDescriptor, materializeServiceDescriptor } from './registry.ts';
+export { VIBES_PM, VIBES_MCP, VIBES_BRIDGE, BUILTIN_SERVICES, listBuiltinServices, getBuiltinService } from './builtin/index.ts';
+export { getServiceBackend } from './backends/index.ts';
+export type { ServiceBackend, ServiceRestartReceipt } from './backends/index.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EACX,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,kBAAkB,EAClB,yBAAyB,EACzB,uBAAuB,EACvB,mBAAmB,EACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EACN,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,4BAA4B,EAC5B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACN,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/services/index.js

@@ -0,0 +1,12 @@
+/**
+ * OS Services — Boot-persistent daemon registration
+ *
+ * Supports macOS launchd and Linux systemd. Catalog identity is the
+ * `hq/os-service` runtime kind — query the runtime, never a private array.
+ */
+export { ServiceScopeSchema, OsServiceDescriptorSchema, ServiceDescriptorSchema, ServiceStatusSchema } from "./schemas/service.js";
+export { osServiceKind } from "./kinds/os-service.kind.js";
+export { registerService, unregisterService, startService, stopService, restartService, getServiceStatus, getServiceLogs, isServiceRegistered, listOsServiceDescriptors, getOsServiceDescriptor, materializeServiceDescriptor } from "./registry.js";
+export { VIBES_PM, VIBES_MCP, VIBES_BRIDGE, BUILTIN_SERVICES, listBuiltinServices, getBuiltinService } from "./builtin/index.js";
+export { getServiceBackend } from "./backends/index.js";
+//# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,EACN,kBAAkB,EAClB,yBAAyB,EACzB,uBAAuB,EACvB,mBAAmB,EACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EACN,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,4BAA4B,EAC5B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACN,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/services/kinds/os-service.kind.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `hq/os-service` — catalog of OS-boot-persistent vibes daemons.
+ *
+ * Descriptors are the asset (like `backup/target`). Lifecycle (register /
+ * start / stop / status) materialises a concrete command path, then delegates
+ * to the fleet service-backends. There is no private service Map/array — the
+ * runtime is the registry. Enumerate with:
+ *   runtime.query('hq/os-service').descriptors()
+ *   runtime.query('hq/os-service').withId(id)
+ */
+/**
+ * No default implementation — descriptors are queried as data, not resolved
+ * into instances.
+ */
+declare class OsServiceDescriptorAsset {
+}
+export declare const osServiceKind: import("@vibesdotdev/kernel").RuntimeKindDescriptorRecord<OsServiceDescriptorAsset>;
+export {};
+//# sourceMappingURL=os-service.kind.d.ts.map

package/dist/services/kinds/os-service.kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"os-service.kind.d.ts","sourceRoot":"","sources":["../../../src/services/kinds/os-service.kind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;;GAGG;AACH,cAAM,wBAAwB;CAAG;AAEjC,eAAO,MAAM,aAAa,qFAIxB,CAAC"}

package/dist/services/kinds/os-service.kind.js

@@ -0,0 +1,24 @@
+/**
+ * `hq/os-service` — catalog of OS-boot-persistent vibes daemons.
+ *
+ * Descriptors are the asset (like `backup/target`). Lifecycle (register /
+ * start / stop / status) materialises a concrete command path, then delegates
+ * to the fleet service-backends. There is no private service Map/array — the
+ * runtime is the registry. Enumerate with:
+ *   runtime.query('hq/os-service').descriptors()
+ *   runtime.query('hq/os-service').withId(id)
+ */
+import { createRuntimeKind } from '@vibesdotdev/kernel';
+import { OsServiceDescriptorSchema } from "../schemas/service.js";
+/**
+ * No default implementation — descriptors are queried as data, not resolved
+ * into instances.
+ */
+class OsServiceDescriptorAsset {
+}
+export const osServiceKind = createRuntimeKind({
+    id: 'hq/os-service',
+    descriptorSchema: OsServiceDescriptorSchema,
+    defaultImplementation: OsServiceDescriptorAsset
+});
+//# sourceMappingURL=os-service.kind.js.map

package/dist/services/kinds/os-service.kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"os-service.kind.js","sourceRoot":"","sources":["../../../src/services/kinds/os-service.kind.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAElE;;;GAGG;AACH,MAAM,wBAAwB;CAAG;AAEjC,MAAM,CAAC,MAAM,aAAa,GAAG,iBAAiB,CAAC;IAC9C,EAAE,EAAE,eAAe;IACnB,gBAAgB,EAAE,yBAAyB;IAC3C,qBAAqB,EAAE,wBAAwB;CAC/C,CAAC,CAAC"}

package/dist/services/registry.d.ts

@@ -0,0 +1,45 @@
+/**
+ * OS service lifecycle — thin facade over the platform backend.
+ *
+ * Catalog identity comes from the runtime (`hq/os-service` descriptors); there
+ * is no private Map or static builtin array. Enumerate with:
+ *   runtime.query('hq/os-service').descriptors()
+ *   runtime.query('hq/os-service').withId(id)
+ *
+ * The backend install needs a resolved absolute `command`. A catalog entry that
+ * names none runs the host's own Vibes CLI: the self-spawn argv the runtime's
+ * host declared (`runtime/host-command`), resolved at use time from the runtime
+ * the caller was handed, never at module load and never guessed from an env
+ * variable or an install path. A host that declared no re-entry refuses.
+ */
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import { type ServiceRestartReceipt } from './backends/index.ts';
+import { type OsServiceDescriptor, type ServiceDescriptor, type ServiceStatus } from './schemas/service.ts';
+/** Enumerate registered `hq/os-service` catalog descriptors from the runtime. */
+export declare function listOsServiceDescriptors(runtime: VibesRuntime): OsServiceDescriptor[];
+/** Lookup one catalog descriptor by id (undefined if unknown). */
+export declare function getOsServiceDescriptor(runtime: VibesRuntime, id: string): OsServiceDescriptor | undefined;
+/**
+ * Materialise a catalog descriptor (or inline install shape) into a backend
+ * `ServiceDescriptor` with an absolute command path.
+ */
+export declare function materializeServiceDescriptor(runtime: VibesRuntime, idOrDescriptor: string | Omit<ServiceDescriptor, 'label'> | OsServiceDescriptor): Promise<ServiceDescriptor>;
+/** What `registerService` did: the service it registered and the OS service manager (backend id) that holds it. */
+export interface ServiceRegistrationReceipt {
+    readonly id: string;
+    readonly manager: string;
+}
+export declare function registerService(runtime: VibesRuntime, idOrDescriptor: string | Omit<ServiceDescriptor, 'label'> | OsServiceDescriptor): Promise<ServiceRegistrationReceipt>;
+export declare function unregisterService(runtime: VibesRuntime, idOrDescriptor: string | Omit<ServiceDescriptor, 'label'> | OsServiceDescriptor): Promise<void>;
+export declare function startService(runtime: VibesRuntime, idOrDescriptor: string | Omit<ServiceDescriptor, 'label'> | OsServiceDescriptor): Promise<void>;
+export declare function stopService(runtime: VibesRuntime, idOrDescriptor: string | Omit<ServiceDescriptor, 'label'> | OsServiceDescriptor): Promise<void>;
+/**
+ * Restart a registered service in place (`launchctl kickstart -k` on macOS,
+ * `systemctl --user restart` on Linux). The receipt carries the pid before and
+ * after; `replaced` is false when the OS did not hand out a new main pid.
+ */
+export declare function restartService(runtime: VibesRuntime, idOrDescriptor: string | Omit<ServiceDescriptor, 'label'> | OsServiceDescriptor): Promise<ServiceRestartReceipt>;
+export declare function getServiceStatus(runtime: VibesRuntime, idOrDescriptor: string | Omit<ServiceDescriptor, 'label'> | OsServiceDescriptor): Promise<ServiceStatus>;
+export declare function getServiceLogs(runtime: VibesRuntime, idOrDescriptor: string | Omit<ServiceDescriptor, 'label'> | OsServiceDescriptor, lines?: number): Promise<string>;
+export declare function isServiceRegistered(runtime: VibesRuntime, idOrDescriptor: string | Omit<ServiceDescriptor, 'label'> | OsServiceDescriptor): Promise<boolean>;
+//# sourceMappingURL=registry.d.ts.map