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

package/dist/approval/approval-resolved.job.descriptor.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The job a surface row's update starts (through `approval-resolved.subscription`):
+ * it runs on the Workers consumer, where approval requests wait, and announces an
+ * answered approval row there.
+ */
+declare const _default: {
+    kind: "workers/job";
+    id: string;
+    name: string;
+    description: string;
+    queue: string;
+    dispatch: "background";
+    type: "default";
+    hardware: readonly ["consumer"];
+    schemas: {
+        input: import("zod/v4").ZodObject<{
+            recordId: import("zod/v4").ZodString;
+            recordKind: import("zod/v4").ZodLiteral<"os.surface-notifications">;
+            data: import("zod/v4").ZodObject<{
+                channelId: import("zod/v4").ZodString;
+                status: import("zod/v4").ZodEnum<{
+                    pending: "pending";
+                    approved: "approved";
+                    discarded: "discarded";
+                }>;
+            }, import("zod/v4/core").$loose>;
+        }, import("zod/v4/core").$strip>;
+        output: import("zod/v4").ZodObject<{
+            announced: import("zod/v4").ZodBoolean;
+        }, import("zod/v4/core").$strip>;
+    };
+    tags: string[];
+    enabled: true;
+};
+export default _default;
+//# sourceMappingURL=approval-resolved.job.descriptor.d.ts.map

package/dist/approval/approval-resolved.job.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-resolved.job.descriptor.d.ts","sourceRoot":"","sources":["../../src/approval/approval-resolved.job.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAKH,wBAeG"}

package/dist/approval/approval-resolved.job.descriptor.js

@@ -0,0 +1,24 @@
+/**
+ * The job a surface row's update starts (through `approval-resolved.subscription`):
+ * it runs on the Workers consumer, where approval requests wait, and announces an
+ * answered approval row there.
+ */
+import { createRuntimeAsset } from '@vibesdotdev/kernel';
+import { ApprovalResolvedJobInputSchema, ApprovalResolvedJobOutputSchema, HQ_APPROVAL_RESOLVED_JOB_ID } from "./schemas.js";
+export default createRuntimeAsset({
+    kind: 'workers/job',
+    id: HQ_APPROVAL_RESOLVED_JOB_ID,
+    name: 'Approval answered',
+    description: 'Announce an answered hq-surface approval row to the requests waiting on this Workers consumer',
+    queue: 'hq-approval',
+    dispatch: 'background',
+    type: 'default',
+    hardware: ['consumer'],
+    schemas: {
+        input: ApprovalResolvedJobInputSchema,
+        output: ApprovalResolvedJobOutputSchema
+    },
+    tags: ['hq', 'approval', 'surface'],
+    enabled: true
+});
+//# sourceMappingURL=approval-resolved.job.descriptor.js.map

package/dist/approval/approval-resolved.job.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-resolved.job.descriptor.js","sourceRoot":"","sources":["../../src/approval/approval-resolved.job.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,8BAA8B,EAAE,+BAA+B,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAE5H,eAAe,kBAAkB,CAAC;IACjC,IAAI,EAAE,aAAa;IACnB,EAAE,EAAE,2BAA2B;IAC/B,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,+FAA+F;IAC5G,KAAK,EAAE,aAAa;IACpB,QAAQ,EAAE,YAAqB;IAC/B,IAAI,EAAE,SAAkB;IACxB,QAAQ,EAAE,CAAC,UAAU,CAAU;IAC/B,OAAO,EAAE;QACR,KAAK,EAAE,8BAA8B;QACrC,MAAM,EAAE,+BAA+B;KACvC;IACD,IAAI,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC;IACnC,OAAO,EAAE,IAAI;CACb,CAAC,CAAC"}

package/dist/approval/approval-resolved.job.impl.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Announce an answered approval row on this host's `hq/approval` hook bus. Rows
+ * that are not approval requests, or not yet answered, announce nothing.
+ */
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { JobDescriptor, JobExecutionContext, JobImplementation } from '@vibesdotdev/kernel/kinds';
+import { type ApprovalResolvedJobInput, type ApprovalResolvedJobOutput } from './schemas.ts';
+export default class ApprovalResolvedJob implements JobImplementation<ApprovalResolvedJobInput, ApprovalResolvedJobOutput> {
+    #private;
+    readonly id: string;
+    readonly descriptor: JobDescriptor;
+    readonly type: "default";
+    readonly isolation: "inline";
+    constructor(descriptor: JobDescriptor, context: {
+        runtime: VibesRuntime;
+    });
+    handle(context: JobExecutionContext<ApprovalResolvedJobInput>): Promise<ApprovalResolvedJobOutput>;
+}
+//# sourceMappingURL=approval-resolved.job.impl.d.ts.map

package/dist/approval/approval-resolved.job.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-resolved.job.impl.d.ts","sourceRoot":"","sources":["../../src/approval/approval-resolved.job.impl.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACvG,OAAO,EAGN,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAE9B,MAAM,cAAc,CAAC;AAEtB,MAAM,CAAC,OAAO,OAAO,mBAAoB,YAAW,iBAAiB,CAAC,wBAAwB,EAAE,yBAAyB,CAAC;;IACzH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;IACnC,QAAQ,CAAC,SAAS,EAAG,QAAQ,CAAU;gBAG3B,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE;QAAE,OAAO,EAAE,YAAY,CAAA;KAAE;IAMnE,MAAM,CAAC,OAAO,EAAE,mBAAmB,CAAC,wBAAwB,CAAC,GAAG,OAAO,CAAC,yBAAyB,CAAC;CAOxG"}

package/dist/approval/approval-resolved.job.impl.js

@@ -0,0 +1,26 @@
+/**
+ * Announce an answered approval row on this host's `hq/approval` hook bus. Rows
+ * that are not approval requests, or not yet answered, announce nothing.
+ */
+import { ApprovalResolvedJobInputSchema, HQ_APPROVAL_HOOK_NAMESPACE } from "./schemas.js";
+export default class ApprovalResolvedJob {
+    id;
+    descriptor;
+    type = 'default';
+    isolation = 'inline';
+    #runtime;
+    constructor(descriptor, context) {
+        this.id = descriptor.id;
+        this.descriptor = descriptor;
+        this.#runtime = context.runtime;
+    }
+    async handle(context) {
+        const input = ApprovalResolvedJobInputSchema.parse(context.data);
+        const status = input.data.status;
+        if (!input.data.channelId.startsWith('approval-') || status === 'pending')
+            return { announced: false };
+        await this.#runtime.hooks(HQ_APPROVAL_HOOK_NAMESPACE).emit('resolved', { notificationId: input.recordId, status });
+        return { announced: true };
+    }
+}
+//# sourceMappingURL=approval-resolved.job.impl.js.map

package/dist/approval/approval-resolved.job.impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-resolved.job.impl.js","sourceRoot":"","sources":["../../src/approval/approval-resolved.job.impl.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EACN,8BAA8B,EAC9B,0BAA0B,EAI1B,MAAM,cAAc,CAAC;AAEtB,MAAM,CAAC,OAAO,OAAO,mBAAmB;IAC9B,EAAE,CAAS;IACX,UAAU,CAAgB;IAC1B,IAAI,GAAG,SAAkB,CAAC;IAC1B,SAAS,GAAG,QAAiB,CAAC;IAC9B,QAAQ,CAAe;IAEhC,YAAY,UAAyB,EAAE,OAAkC;QACxE,IAAI,CAAC,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,OAAsD;QAClE,MAAM,KAAK,GAAG,8BAA8B,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACjE,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;QACjC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QACvG,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAmB,0BAA0B,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,cAAc,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACrI,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAC5B,CAAC;CACD"}

package/dist/approval/approval-resolved.subscription.descriptor.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Start `hq.approval.resolved` whenever an hq surface row is updated. The update
+ * happens where the person answers (`vibes hq surface resolve`, its own process);
+ * the job runs on the Workers consumer, where the request waits.
+ */
+declare const _default: {
+    kind: "runtime/subscription";
+    id: string;
+    name: string;
+    description: string;
+    event: string;
+    handler: string;
+    handlerType: string;
+    filter: {
+        recordKind: string;
+    };
+    enabled: true;
+    priority: number;
+};
+export default _default;
+//# sourceMappingURL=approval-resolved.subscription.descriptor.d.ts.map

package/dist/approval/approval-resolved.subscription.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-resolved.subscription.descriptor.d.ts","sourceRoot":"","sources":["../../src/approval/approval-resolved.subscription.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;;;;;;;;;;;;;;;AAKH,wBAWG"}

package/dist/approval/approval-resolved.subscription.descriptor.js

@@ -0,0 +1,20 @@
+/**
+ * Start `hq.approval.resolved` whenever an hq surface row is updated. The update
+ * happens where the person answers (`vibes hq surface resolve`, its own process);
+ * the job runs on the Workers consumer, where the request waits.
+ */
+import { createRuntimeAsset } from '@vibesdotdev/kernel';
+import { HQ_APPROVAL_RESOLVED_JOB_ID } from "./schemas.js";
+export default createRuntimeAsset({
+    kind: 'runtime/subscription',
+    id: 'hq.approval.surface-updated',
+    name: 'Approval answered',
+    description: 'Starts hq.approval.resolved when an hq surface notification row is updated',
+    event: 'storage.record.afterUpdate',
+    handler: HQ_APPROVAL_RESOLVED_JOB_ID,
+    handlerType: 'job',
+    filter: { recordKind: 'os.surface-notifications' },
+    enabled: true,
+    priority: 0
+});
+//# sourceMappingURL=approval-resolved.subscription.descriptor.js.map

package/dist/approval/approval-resolved.subscription.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-resolved.subscription.descriptor.js","sourceRoot":"","sources":["../../src/approval/approval-resolved.subscription.descriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAE3D,eAAe,kBAAkB,CAAC;IACjC,IAAI,EAAE,sBAAsB;IAC5B,EAAE,EAAE,6BAA6B;IACjC,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,4EAA4E;IACzF,KAAK,EAAE,4BAA4B;IACnC,OAAO,EAAE,2BAA2B;IACpC,WAAW,EAAE,KAAK;IAClB,MAAM,EAAE,EAAE,UAAU,EAAE,0BAA0B,EAAE;IAClD,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE,CAAC;CACX,CAAC,CAAC"}

package/dist/approval/schemas.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The hq-surface approval channel's shapes: ids, the job the surface-row update
+ * starts, and the in-process event that wakes the waiting request.
+ */
+import * as z from 'zod/v4';
+/** The `tools/approval-channel` id a task's approval policy names. */
+export declare const HQ_SURFACE_APPROVAL_CHANNEL_ID = "hq-surface";
+/** The `workers/job` the surface row's update starts, on the Workers consumer where requests wait. */
+export declare const HQ_APPROVAL_RESOLVED_JOB_ID = "hq.approval.resolved";
+/** The hook namespace the resolve job announces an answer on; waiting requests listen there. */
+export declare const HQ_APPROVAL_HOOK_NAMESPACE = "hq/approval";
+/** The surface channel id an approval request's row is written under: one per request. */
+export declare const approvalSurfaceChannelId: (requestId: string) => string;
+/** What `storage.record.afterUpdate` hands the resolve job for an updated surface row. */
+export declare const ApprovalResolvedJobInputSchema: z.ZodObject<{
+    recordId: z.ZodString;
+    recordKind: z.ZodLiteral<"os.surface-notifications">;
+    data: z.ZodObject<{
+        channelId: z.ZodString;
+        status: z.ZodEnum<{
+            pending: "pending";
+            approved: "approved";
+            discarded: "discarded";
+        }>;
+    }, z.core.$loose>;
+}, z.core.$strip>;
+export type ApprovalResolvedJobInput = z.infer<typeof ApprovalResolvedJobInputSchema>;
+/** The answer to one request, announced on the Workers consumer's hook bus. */
+export declare const ApprovalResolvedEventSchema: z.ZodObject<{
+    notificationId: z.ZodString;
+    status: z.ZodEnum<{
+        approved: "approved";
+        discarded: "discarded";
+    }>;
+}, z.core.$strip>;
+export type ApprovalResolvedEvent = z.infer<typeof ApprovalResolvedEventSchema>;
+export declare const ApprovalResolvedJobOutputSchema: z.ZodObject<{
+    announced: z.ZodBoolean;
+}, z.core.$strip>;
+export type ApprovalResolvedJobOutput = z.infer<typeof ApprovalResolvedJobOutputSchema>;
+/** The `hq/approval` hook namespace's events. */
+export type HqApprovalEvents = {
+    resolved: ApprovalResolvedEvent;
+};
+//# sourceMappingURL=schemas.d.ts.map

package/dist/approval/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/approval/schemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,sEAAsE;AACtE,eAAO,MAAM,8BAA8B,eAAe,CAAC;AAE3D,sGAAsG;AACtG,eAAO,MAAM,2BAA2B,yBAAyB,CAAC;AAElE,gGAAgG;AAChG,eAAO,MAAM,0BAA0B,gBAAgB,CAAC;AAExD,0FAA0F;AAC1F,eAAO,MAAM,wBAAwB,GAAI,WAAW,MAAM,KAAG,MAAiC,CAAC;AAI/F,0FAA0F;AAC1F,eAAO,MAAM,8BAA8B;;;;;;;;;;;iBAIzC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,+EAA+E;AAC/E,eAAO,MAAM,2BAA2B;;;;;;iBAGtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,+BAA+B;;iBAAuC,CAAC;AACpF,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,iDAAiD;AACjD,MAAM,MAAM,gBAAgB,GAAG;IAC9B,QAAQ,EAAE,qBAAqB,CAAC;CAChC,CAAC"}

package/dist/approval/schemas.js

@@ -0,0 +1,27 @@
+/**
+ * The hq-surface approval channel's shapes: ids, the job the surface-row update
+ * starts, and the in-process event that wakes the waiting request.
+ */
+import * as z from 'zod/v4';
+/** The `tools/approval-channel` id a task's approval policy names. */
+export const HQ_SURFACE_APPROVAL_CHANNEL_ID = 'hq-surface';
+/** The `workers/job` the surface row's update starts, on the Workers consumer where requests wait. */
+export const HQ_APPROVAL_RESOLVED_JOB_ID = 'hq.approval.resolved';
+/** The hook namespace the resolve job announces an answer on; waiting requests listen there. */
+export const HQ_APPROVAL_HOOK_NAMESPACE = 'hq/approval';
+/** The surface channel id an approval request's row is written under: one per request. */
+export const approvalSurfaceChannelId = (requestId) => `approval-${requestId}`;
+const SurfaceStatusSchema = z.enum(['pending', 'approved', 'discarded']);
+/** What `storage.record.afterUpdate` hands the resolve job for an updated surface row. */
+export const ApprovalResolvedJobInputSchema = z.object({
+    recordId: z.string().min(1),
+    recordKind: z.literal('os.surface-notifications'),
+    data: z.looseObject({ channelId: z.string().min(1), status: SurfaceStatusSchema })
+});
+/** The answer to one request, announced on the Workers consumer's hook bus. */
+export const ApprovalResolvedEventSchema = z.object({
+    notificationId: z.string().min(1),
+    status: z.enum(['approved', 'discarded'])
+});
+export const ApprovalResolvedJobOutputSchema = z.object({ announced: z.boolean() });
+//# sourceMappingURL=schemas.js.map

package/dist/approval/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/approval/schemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,sEAAsE;AACtE,MAAM,CAAC,MAAM,8BAA8B,GAAG,YAAY,CAAC;AAE3D,sGAAsG;AACtG,MAAM,CAAC,MAAM,2BAA2B,GAAG,sBAAsB,CAAC;AAElE,gGAAgG;AAChG,MAAM,CAAC,MAAM,0BAA0B,GAAG,aAAa,CAAC;AAExD,0FAA0F;AAC1F,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,SAAiB,EAAU,EAAE,CAAC,YAAY,SAAS,EAAE,CAAC;AAE/F,MAAM,mBAAmB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;AAEzE,0FAA0F;AAC1F,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,0BAA0B,CAAC;IACjD,IAAI,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAClF,CAAC,CAAC;AAGH,+EAA+E;AAC/E,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;CACzC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC"}

package/dist/approval/surface-approval-channel.descriptor.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The hq-surface approval channel: a request becomes an hq surface notification
+ * and a native Approve/Decline dialog on the owning Mac. CLI resolution remains available.
+ */
+declare const _default: {
+    kind: "tools/approval-channel";
+    id: string;
+    name: string;
+    description: string;
+    hardware: string[];
+    enabled: true;
+};
+export default _default;
+//# sourceMappingURL=surface-approval-channel.descriptor.d.ts.map

package/dist/approval/surface-approval-channel.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-approval-channel.descriptor.d.ts","sourceRoot":"","sources":["../../src/approval/surface-approval-channel.descriptor.ts"],"names":[],"mappings":"AAAA;;;GAGG;;;;;;;;;AAKH,wBAQG"}

package/dist/approval/surface-approval-channel.descriptor.js

@@ -0,0 +1,16 @@
+/**
+ * The hq-surface approval channel: a request becomes an hq surface notification
+ * and a native Approve/Decline dialog on the owning Mac. CLI resolution remains available.
+ */
+import { createRuntimeAsset } from '@vibesdotdev/kernel';
+import { HQ_SURFACE_APPROVAL_CHANNEL_ID } from "./schemas.js";
+export default createRuntimeAsset({
+    kind: 'tools/approval-channel',
+    id: HQ_SURFACE_APPROVAL_CHANNEL_ID,
+    name: 'HQ surface approval',
+    description: 'Presents a correlated approval request on the owning Mac; persists the decision in the HQ surface store.',
+    // The surface store and its banner are consumer-host facilities.
+    hardware: ['consumer'],
+    enabled: true
+});
+//# sourceMappingURL=surface-approval-channel.descriptor.js.map

package/dist/approval/surface-approval-channel.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-approval-channel.descriptor.js","sourceRoot":"","sources":["../../src/approval/surface-approval-channel.descriptor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAE9D,eAAe,kBAAkB,CAAC;IACjC,IAAI,EAAE,wBAAwB;IAC9B,EAAE,EAAE,8BAA8B;IAClC,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE,0GAA0G;IACvH,iEAAiE;IACjE,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;CACb,CAAC,CAAC"}

package/dist/approval/surface-approval-channel.impl.d.ts

@@ -0,0 +1,19 @@
+/**
+ * hq-surface approval channel. Each request is written as an hq surface
+ * notification and presents its native review UI. CLI resolution still announces
+ * its answer on this host's `hq/approval` hook bus. The row is read once after subscribing,
+ * so an answer that came first is not missed. A cancelled run stops waiting.
+ */
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { KindContext } from '@vibesdotdev/kernel/schemas/kind';
+import type { RuntimeDescriptor } from '@vibesdotdev/kernel/schemas/descriptor';
+import type { ToolApprovalChannelInterface, ToolApprovalGateOptions } from '@vibesdotdev/tools/agents/approval/channel';
+import type { ToolApprovalDecision, ToolApprovalRequest } from '@vibesdotdev/ai-schemas/agents/approval/types';
+export default class HqSurfaceApprovalChannel implements ToolApprovalChannelInterface {
+    #private;
+    constructor(_descriptor: RuntimeDescriptor, context: KindContext<VibesRuntime>);
+    createRuntime(correlation: Record<string, string>, options?: ToolApprovalGateOptions): {
+        requestApproval(request: ToolApprovalRequest): Promise<ToolApprovalDecision>;
+    };
+}
+//# sourceMappingURL=surface-approval-channel.impl.d.ts.map

package/dist/approval/surface-approval-channel.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-approval-channel.impl.d.ts","sourceRoot":"","sources":["../../src/approval/surface-approval-channel.impl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,KAAK,EAAE,4BAA4B,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACxH,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,+CAA+C,CAAC;AAwD/G,MAAM,CAAC,OAAO,OAAO,wBAAyB,YAAW,4BAA4B;;gBAGxE,WAAW,EAAE,iBAAiB,EAAE,OAAO,EAAE,WAAW,CAAC,YAAY,CAAC;IAI9E,aAAa,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,uBAAuB;iCAGnD,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;;CA2BpF"}

package/dist/approval/surface-approval-channel.impl.js

@@ -0,0 +1,101 @@
+/**
+ * hq-surface approval channel. Each request is written as an hq surface
+ * notification and presents its native review UI. CLI resolution still announces
+ * its answer on this host's `hq/approval` hook bus. The row is read once after subscribing,
+ * so an answer that came first is not missed. A cancelled run stops waiting.
+ */
+import { redactCredentials } from '@vibesdotdev/shared/utils';
+import * as z from 'zod/v4';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { getSurfaceNotification, resolveSurfaceNotification, SYSTEM_OWNER, writeSurfaceNotification } from "../os-wall/surface-store.wall.js";
+import { approvalSurfaceChannelId, HQ_APPROVAL_HOOK_NAMESPACE } from "./schemas.js";
+/** What an agent's `request-approval` call carries; other gated calls carry their own arguments. */
+const RequestedChangeSchema = z.looseObject({
+    action: z.string().min(1).optional(),
+    why: z.string().min(1).optional(),
+    paths: z.array(z.string()).optional(),
+    evidence: z.string().min(1).optional()
+});
+function describe(request, correlation) {
+    const change = RequestedChangeSchema.parse(request.args);
+    const summary = change.action ?? `${request.toolName}: ${request.description ?? 'needs approval'}`;
+    const lines = [
+        `Tool: ${request.toolId}`,
+        request.toolCallId ? `Tool call: ${request.toolCallId}` : undefined,
+        ...Object.entries(correlation).map(([key, value]) => `${key}: ${value}`),
+        `Arguments (credentials redacted): ${redactCredentials(JSON.stringify(request.args))}`,
+        change.why ? `Why: ${redactCredentials(change.why)}` : undefined,
+        change.paths?.length ? `Paths: ${change.paths.join(', ')}` : undefined,
+        change.evidence ? `Evidence: ${redactCredentials(change.evidence)}` : undefined,
+        request.description && change.action ? `Note: ${redactCredentials(request.description)}` : undefined,
+        'Answer with `vibes hq surface resolve <id> --resolution approved|discarded` (ids: `vibes hq surface list`).'
+    ];
+    return { summary: redactCredentials(summary), detail: lines.filter((line) => line !== undefined).join('\n') };
+}
+/** Wait for the answer to one row: the announcement, or the row itself when it was answered first. */
+async function answerOf(runtime, id, signal) {
+    const bus = runtime.hooks(HQ_APPROVAL_HOOK_NAMESPACE);
+    let stop = () => { };
+    const announced = new Promise((resolve, reject) => {
+        const cancel = () => reject(new CapabilityError('The approval request was cancelled.', 'CANCELLED', { reason: 'approval-request-cancelled' }));
+        const off = bus.on('resolved', (event) => {
+            if (event.notificationId === id)
+                resolve(event.status);
+        });
+        signal?.addEventListener('abort', cancel, { once: true });
+        stop = () => {
+            off();
+            signal?.removeEventListener('abort', cancel);
+        };
+        if (signal?.aborted)
+            cancel();
+    });
+    try {
+        const current = await getSurfaceNotification(runtime, SYSTEM_OWNER, id);
+        if (current && current.status !== 'pending')
+            return current.status;
+        return await announced;
+    }
+    finally {
+        stop();
+    }
+}
+export default class HqSurfaceApprovalChannel {
+    #runtime;
+    constructor(_descriptor, context) {
+        this.#runtime = context.runtime;
+    }
+    createRuntime(correlation, options) {
+        const runtime = this.#runtime;
+        return {
+            async requestApproval(request) {
+                const { summary, detail } = describe(request, correlation);
+                const row = await writeSurfaceNotification(runtime, SYSTEM_OWNER, {
+                    channelId: approvalSurfaceChannelId(request.requestId),
+                    scope: 'agent',
+                    summary,
+                    detail,
+                    artifacts: [{ type: 'note', description: 'Approval request', content: { requestId: request.requestId, toolId: request.toolId, toolCallId: request.toolCallId, correlation } }],
+                    actions: []
+                });
+                // Present on the owning machine: system-owned rows never become public cloud links.
+                const { presentSurfaceDecision } = await import('@vibesdotdev/os/surface/decision');
+                const presentation = new AbortController();
+                const signal = options?.signal ? AbortSignal.any([options.signal, presentation.signal]) : presentation.signal;
+                try {
+                    const result = await Promise.race([
+                        answerOf(runtime, row.id, signal).then((answer) => ({ answer, native: false })),
+                        presentSurfaceDecision(runtime, row, { signal }).then((answer) => ({ answer, native: true }))
+                    ]);
+                    if (result.native)
+                        await resolveSurfaceNotification(runtime, SYSTEM_OWNER, row.id, result.answer);
+                    return result.answer === 'approved' ? { approved: true } : { approved: false, reason: 'Declined in hq.' };
+                }
+                finally {
+                    presentation.abort();
+                }
+            }
+        };
+    }
+}
+//# sourceMappingURL=surface-approval-channel.impl.js.map

package/dist/approval/surface-approval-channel.impl.js.map

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

package/dist/cli/app/handoff/hq.app.handoff.descriptor.d.ts

@@ -0,0 +1,40 @@
+declare const _default: {
+    readonly id: "hq.app.handoff";
+    readonly kind: "cli/command";
+    readonly name: "handoff";
+    readonly description: "Stage or clear app handoff metadata on a session";
+    readonly group: "hq.app";
+    readonly options: [{
+        readonly flags: "--app <appId>";
+        readonly description: "Target app ID for staged handoff";
+    }, {
+        readonly flags: "--session <sessionId>";
+        readonly description: "Session ID (defaults to active session)";
+    }, {
+        readonly flags: "--surface <surface>";
+        readonly description: "Surface: studio, bridge, or chat";
+    }, {
+        readonly flags: "--pairing-id <pairingId>";
+        readonly description: "Pairing ID bound to this handoff";
+    }, {
+        readonly flags: "--token-id <tokenId>";
+        readonly description: "Token ID bound to this handoff";
+    }, {
+        readonly flags: "--note <text>";
+        readonly description: "Operator note for this handoff stage";
+    }, {
+        readonly flags: "--clear";
+        readonly description: "Clear staged handoff metadata from the session";
+    }, {
+        readonly flags: "--sync";
+        readonly description: "Push app auth metadata to cloud after mutation";
+    }, {
+        readonly flags: "--json";
+        readonly description: "Output JSON";
+    }];
+    readonly surfaces: ["cli"];
+    readonly hardware: readonly ["consumer"];
+    readonly enabled: true;
+};
+export default _default;
+//# sourceMappingURL=hq.app.handoff.descriptor.d.ts.map

package/dist/cli/app/handoff/hq.app.handoff.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hq.app.handoff.descriptor.d.ts","sourceRoot":"","sources":["../../../../src/cli/app/handoff/hq.app.handoff.descriptor.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,wBAoBG"}

package/dist/cli/app/handoff/hq.app.handoff.descriptor.js

@@ -0,0 +1,23 @@
+import { createRuntimeAsset } from '@vibesdotdev/kernel';
+export default createRuntimeAsset({
+    id: 'hq.app.handoff',
+    kind: 'cli/command',
+    name: 'handoff',
+    description: 'Stage or clear app handoff metadata on a session',
+    group: 'hq.app',
+    options: [
+        { flags: '--app <appId>', description: 'Target app ID for staged handoff' },
+        { flags: '--session <sessionId>', description: 'Session ID (defaults to active session)' },
+        { flags: '--surface <surface>', description: 'Surface: studio, bridge, or chat' },
+        { flags: '--pairing-id <pairingId>', description: 'Pairing ID bound to this handoff' },
+        { flags: '--token-id <tokenId>', description: 'Token ID bound to this handoff' },
+        { flags: '--note <text>', description: 'Operator note for this handoff stage' },
+        { flags: '--clear', description: 'Clear staged handoff metadata from the session' },
+        { flags: '--sync', description: 'Push app auth metadata to cloud after mutation' },
+        { flags: '--json', description: 'Output JSON' }
+    ],
+    surfaces: ['cli'],
+    hardware: ['consumer'],
+    enabled: true
+});
+//# sourceMappingURL=hq.app.handoff.descriptor.js.map

package/dist/cli/app/handoff/hq.app.handoff.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hq.app.handoff.descriptor.js","sourceRoot":"","sources":["../../../../src/cli/app/handoff/hq.app.handoff.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,eAAe,kBAAkB,CAAC;IACjC,EAAE,EAAE,gBAAgB;IACpB,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,kDAAkD;IAC/D,KAAK,EAAE,QAAQ;IACf,OAAO,EAAE;QACR,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,kCAAkC,EAAE;QAC3E,EAAE,KAAK,EAAE,uBAAuB,EAAE,WAAW,EAAE,yCAAyC,EAAE;QAC1F,EAAE,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAE,kCAAkC,EAAE;QACjF,EAAE,KAAK,EAAE,0BAA0B,EAAE,WAAW,EAAE,kCAAkC,EAAE;QACtF,EAAE,KAAK,EAAE,sBAAsB,EAAE,WAAW,EAAE,gCAAgC,EAAE;QAChF,EAAE,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,sCAAsC,EAAE;QAC/E,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,gDAAgD,EAAE;QACnF,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,gDAAgD,EAAE;QAClF,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE;KAC/C;IACD,QAAQ,EAAE,CAAC,KAAK,CAAC;IACjB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;CACb,CAAC,CAAC"}

package/dist/cli/app/handoff/hq.app.handoff.impl.consumer.d.ts

@@ -0,0 +1,7 @@
+import type { CommandOptions } from '@vibesdotdev/cli';
+import type { CommandContext } from '@vibesdotdev/cli';
+declare const _default: import("@vibesdotdev/kernel").RuntimeImplementationWrapper<{
+    execute(inputArgs: CommandOptions, inputOptions: CommandOptions, context: CommandContext): Promise<void>;
+}>;
+export default _default;
+//# sourceMappingURL=hq.app.handoff.impl.consumer.d.ts.map

package/dist/cli/app/handoff/hq.app.handoff.impl.consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hq.app.handoff.impl.consumer.d.ts","sourceRoot":"","sources":["../../../../src/cli/app/handoff/hq.app.handoff.impl.consumer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;;uBA4B5B,cAAc,gBAAgB,cAAc,WAAW,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;;AAJhH,wBAyFG"}

package/dist/cli/app/handoff/hq.app.handoff.impl.consumer.js

@@ -0,0 +1,107 @@
+import * as z from 'zod/v4';
+import { JsonObjectSchema } from '@vibesdotdev/kernel/schemas/json';
+import { writeStdoutLine } from '@vibesdotdev/cli/output';
+import { parseCliArguments, parseCliOptions } from "../../schemas/input.js";
+import { createRuntimeImplementation } from '@vibesdotdev/kernel';
+import { getTokenById, listAppPairings } from "../../../app/auth/service.consumer.js";
+import { syncOsAppAuth } from "../../../app/auth/cloud-sync.consumer.js";
+/** Minimal session manager interface needed for handoff operations */
+import { writeJson } from '@vibesdotdev/cli/output';
+async function resolveSession(manager, sessionId) {
+    if (sessionId) {
+        const explicit = await manager.getSession(sessionId);
+        if (!explicit)
+            throw new Error(`Session not found: ${sessionId}`);
+        return explicit;
+    }
+    const active = await manager.getActiveSession();
+    if (!active)
+        throw new Error('No active session. Pass --session <sessionId>.');
+    return active;
+}
+export default createRuntimeImplementation({
+    id: 'hq.app.handoff',
+    kind: 'cli/command',
+    implementation: {
+        async execute(inputArgs, inputOptions, context) {
+            const _args = parseCliArguments(inputArgs);
+            const opts = parseCliOptions(inputOptions);
+            const options = opts;
+            const asJson = options.json;
+            const shouldClear = options.clear;
+            const shouldSync = options.sync;
+            const { runtime } = context;
+            const manager = await runtime.context('session/manager');
+            if (!manager)
+                throw new Error('Session manager context is unavailable.');
+            const session = await resolveSession(manager, options.session);
+            const currentMetadata = session.metadata ?? {};
+            const currentCustom = JsonObjectSchema.parse(currentMetadata.custom ?? {});
+            if (shouldClear) {
+                delete currentCustom.osAppHandoff;
+                await manager.updateSession(session.id, {
+                    metadata: {
+                        ...currentMetadata,
+                        custom: currentCustom
+                    }
+                });
+                if (asJson) {
+                    await writeJson(runtime, { action: 'cleared', sessionId: session.id });
+                    return;
+                }
+                await writeStdoutLine(context.runtime, `Cleared osAppHandoff metadata for session ${session.id}`);
+                return;
+            }
+            const appId = options.app;
+            if (!appId)
+                throw new Error('Missing required option: --app <appId>');
+            const tokenId = options.tokenId;
+            if (tokenId) {
+                const token = await getTokenById(runtime, tokenId);
+                if (!token || token.revokedAt)
+                    throw new Error(`Token is not active: ${tokenId}`);
+            }
+            const pairingId = options.pairingId;
+            if (pairingId) {
+                const pairings = await listAppPairings(runtime, appId);
+                if (!pairings.find((pairing) => pairing.id === pairingId)) {
+                    throw new Error(`Pairing not found for app ${appId}: ${pairingId}`);
+                }
+            }
+            const surface = z.enum(['studio', 'bridge', 'chat']).parse(options.surface ?? 'studio');
+            const staged = {
+                appId,
+                surface,
+                pairingId: pairingId ?? null,
+                tokenId: tokenId ?? null,
+                note: options.note ?? null,
+                status: 'staged',
+                stagedAt: new Date().toISOString(),
+                stagedByHost: (runtime.localEnvironment.getHostname?.() ?? (() => { throw new Error('The selected host declares no hostname'); })())
+            };
+            await manager.updateSession(session.id, {
+                metadata: {
+                    ...currentMetadata,
+                    custom: {
+                        ...currentCustom,
+                        osAppHandoff: staged
+                    }
+                }
+            });
+            const sync = shouldSync ? await syncOsAppAuth(runtime, 'push') : null;
+            if (asJson) {
+                await writeJson(runtime, { action: 'staged', sessionId: session.id, handoff: staged, sync });
+                return;
+            }
+            await writeStdoutLine(context.runtime, `Staged ${surface} handoff for session ${session.id} to app ${appId}`);
+            if (pairingId)
+                await writeStdoutLine(context.runtime, `Pairing: ${pairingId}`);
+            if (tokenId)
+                await writeStdoutLine(context.runtime, `Token: ${tokenId}`);
+            if (sync) {
+                await writeStdoutLine(context.runtime, `Synced ${sync.bridgeId}: ${sync.pushed} pushed, ${sync.errors} errors`);
+            }
+        }
+    }
+});
+//# sourceMappingURL=hq.app.handoff.impl.consumer.js.map