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

package/dist/hooks/edit-targets.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The files a harness's native tool call writes, read from its hook payload.
+ *
+ * A call is an edit when its tool name is one of the configured edit tools
+ * (`collaboration.editTools`), or when its input carries an `apply_patch`
+ * envelope (`*** Begin Patch`) — Codex sends patches both as its own tool and
+ * through its shell tool. Targets are absolute paths inside the hook's
+ * workspace; a path outside it, or one that climbs with `..`, is not a target.
+ */
+/** The tool call a hook envelope carries. */
+export interface HookToolCall {
+    readonly name: string;
+    readonly input?: unknown;
+}
+/** The file paths an `apply_patch` envelope adds, updates, deletes or moves to. */
+export declare function patchFilePaths(patch: string): string[];
+/**
+ * The files `tool` writes inside `workspace` (the bound workspace), deduplicated; relative paths
+ * resolve against the tool's `cwd` (which may be a nested directory or repository). Empty for a
+ * call that is not an edit.
+ */
+export declare function nativeEditTargets(tool: HookToolCall, cwd: string, workspace: string, editTools: readonly string[]): string[];
+//# sourceMappingURL=edit-targets.d.ts.map

package/dist/hooks/edit-targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-targets.d.ts","sourceRoot":"","sources":["../../src/hooks/edit-targets.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAqBH,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CACzB;AAcD,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAEtD;AAUD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAChC,IAAI,EAAE,YAAY,EAClB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,SAAS,MAAM,EAAE,GAC1B,MAAM,EAAE,CAcV"}

package/dist/hooks/edit-targets.js

@@ -0,0 +1,74 @@
+/**
+ * The files a harness's native tool call writes, read from its hook payload.
+ *
+ * A call is an edit when its tool name is one of the configured edit tools
+ * (`collaboration.editTools`), or when its input carries an `apply_patch`
+ * envelope (`*** Begin Patch`) — Codex sends patches both as its own tool and
+ * through its shell tool. Targets are absolute paths inside the hook's
+ * workspace; a path outside it, or one that climbs with `..`, is not a target.
+ */
+import * as z from 'zod/v4';
+import { canonicalTouchPath, isTouchPathInsideWorkspace } from "../schemas/path-identity.js";
+/** Where an edit tool's input names its file. */
+const PathFieldsSchema = z.looseObject({
+    file_path: z.string().min(1).optional().catch(undefined),
+    path: z.string().min(1).optional().catch(undefined),
+    notebook_path: z.string().min(1).optional().catch(undefined)
+});
+const StringSchema = z.string();
+const ListSchema = z.array(z.unknown());
+const RecordSchema = z.record(z.string(), z.unknown());
+const PATCH_ENVELOPE = '*** Begin Patch';
+const PATCH_FILE_LINE = /^\*\*\* (?:(?:Add|Update|Delete) File|Move to): (.+)$/gm;
+/** How deep a payload is searched for a patch envelope. */
+const PATCH_SEARCH_DEPTH = 3;
+/** Every string in `value` (to a bounded depth) that carries a patch envelope. */
+function patchTexts(value, depth = 0) {
+    const text = StringSchema.safeParse(value);
+    if (text.success)
+        return text.data.includes(PATCH_ENVELOPE) ? [text.data] : [];
+    if (depth >= PATCH_SEARCH_DEPTH)
+        return [];
+    const list = ListSchema.safeParse(value);
+    if (list.success)
+        return list.data.flatMap((entry) => patchTexts(entry, depth + 1));
+    const record = RecordSchema.safeParse(value);
+    if (record.success)
+        return Object.values(record.data).flatMap((entry) => patchTexts(entry, depth + 1));
+    return [];
+}
+/** The file paths an `apply_patch` envelope adds, updates, deletes or moves to. */
+export function patchFilePaths(patch) {
+    return Array.from(patch.matchAll(PATCH_FILE_LINE), (match) => (match[1] ?? '').trim()).filter(Boolean);
+}
+/** `candidate` as an absolute path inside `workspace`, or undefined. */
+/** A candidate path resolved against the tool's cwd, kept when it lies inside the bound workspace. */
+function containedTarget(candidate, cwd, workspace) {
+    if (candidate.split(/[\\/]+/).includes('..'))
+        return undefined;
+    const target = canonicalTouchPath(candidate, cwd);
+    return isTouchPathInsideWorkspace(target, workspace) && target !== canonicalTouchPath(workspace) ? target : undefined;
+}
+/**
+ * The files `tool` writes inside `workspace` (the bound workspace), deduplicated; relative paths
+ * resolve against the tool's `cwd` (which may be a nested directory or repository). Empty for a
+ * call that is not an edit.
+ */
+export function nativeEditTargets(tool, cwd, workspace, editTools) {
+    const patches = patchTexts(tool.input);
+    const named = editTools.includes(tool.name);
+    if (!named && patches.length === 0)
+        return [];
+    const candidates = patches.flatMap(patchFilePaths);
+    if (named) {
+        const fields = PathFieldsSchema.safeParse(tool.input);
+        if (fields.success) {
+            const path = fields.data.file_path ?? fields.data.notebook_path ?? fields.data.path;
+            if (path)
+                candidates.push(path);
+        }
+    }
+    const targets = candidates.flatMap((candidate) => containedTarget(candidate, cwd, workspace) ?? []);
+    return Array.from(new Set(targets));
+}
+//# sourceMappingURL=edit-targets.js.map

package/dist/hooks/edit-targets.js.map

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

package/dist/hooks/hook-delivery.d.ts

@@ -0,0 +1,21 @@
+/**
+ * What a harness hook response carries to the participant without polling:
+ * its pending messages, overlap notices, and the self-review nudge.
+ *
+ * `tool.after` counts edits; observable `prompt.submit` and `agent.stop` responses call
+ * `collaborationContext`. It claims the seat's messages through the same
+ * claim-and-remove transport the `workspace-fs` result path uses
+ * (`claimAmbientMessages`), drains the notices the file watcher queued for the
+ * seat's session, and preserves path audience routing from successful native edits. Claiming removes, so each item is delivered once; an
+ * empty inbox and no overlaps add no bytes.
+ */
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import type { ExternalHookEnvelope } from './runtime.ts';
+/** The events whose responses carry collaboration context. */
+export type DeliveryEvent = 'tool.after' | 'prompt.submit' | 'agent.stop';
+/**
+ * The context this hook response injects for `envelope`'s participant, or
+ * undefined when there is nothing to say (no seat, nothing pending).
+ */
+export declare function collaborationContext(runtime: VibesRuntime, envelope: ExternalHookEnvelope, event: DeliveryEvent): Promise<string | undefined>;
+//# sourceMappingURL=hook-delivery.d.ts.map

package/dist/hooks/hook-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-delivery.d.ts","sourceRoot":"","sources":["../../src/hooks/hook-delivery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAA4B,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAUlF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD,8DAA8D;AAC9D,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,eAAe,GAAG,YAAY,CAAC;AAwC1E;;;GAGG;AACH,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,oBAAoB,EAC9B,KAAK,EAAE,aAAa,GAClB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAqB7B"}

package/dist/hooks/hook-delivery.js

@@ -0,0 +1,87 @@
+/**
+ * What a harness hook response carries to the participant without polling:
+ * its pending messages, overlap notices, and the self-review nudge.
+ *
+ * `tool.after` counts edits; observable `prompt.submit` and `agent.stop` responses call
+ * `collaborationContext`. It claims the seat's messages through the same
+ * claim-and-remove transport the `workspace-fs` result path uses
+ * (`claimAmbientMessages`), drains the notices the file watcher queued for the
+ * seat's session, and preserves path audience routing from successful native edits. Claiming removes, so each item is delivered once; an
+ * empty inbox and no overlaps add no bytes.
+ */
+import { settle, valueFreeFailure } from '@vibesdotdev/kernel';
+import { getLogger } from '@vibesdotdev/logging';
+import { getVibesExternalClient } from "../client/external-client.js";
+import { claimAmbientMessages } from "../ambient/file-access-ambient.impl.js";
+import { readCollaborationSettings } from "../ambient/collaboration-settings.js";
+import { drainPendingBatches } from "../ambient/pending-notices.js";
+import { nativeEditTargets } from "./edit-targets.js";
+import { hookWorkspaceRoot, resolveHookSeat } from "./hook-seat.js";
+import { reviewDueAfterEdits, reviewDueAtStop, selfReviewPrompt } from "./self-review.js";
+import { editsSinceReview, markReviewed, recordEdits } from "./review-state.js";
+/** Run one delivery section; a failure is logged value-free and costs only that section. */
+async function section(runtime, name, run) {
+    const outcome = await settle(run);
+    if (outcome.ok)
+        return outcome.value;
+    getLogger('external.hooks.delivery', runtime).warn('collaboration delivery section failed', {
+        section: name,
+        failure: valueFreeFailure(outcome.cause)
+    });
+    return undefined;
+}
+/** Messages addressed to the seat plus the notices queued for its session. */
+async function inboxLines(runtime, seat) {
+    const client = await getVibesExternalClient(runtime);
+    const claimed = await claimAmbientMessages(runtime, seat.sessionId, client.deliveryPathsFor(seat.sessionId), { workspaceRoot: seat.workspaceRoot });
+    client.clearDeliveryPaths(seat.sessionId);
+    const queued = drainPendingBatches(runtime, seat.sessionId);
+    return [...queued.flatMap((entry) => [entry.messages, entry.notice]), claimed].flatMap((line) => line ?? []);
+}
+/**
+ * The self-review nudge this event calls for, or undefined; delivering it resets the count.
+ * Edits are counted after each tool; the nudge is delivered on the next prompt (the edit cadence)
+ * or at Stop (any edit since the last review): the events whose output every harness shows.
+ */
+async function reviewNudge(runtime, settings, seat, event, edits) {
+    if (event === 'tool.after') {
+        if (edits > 0)
+            await recordEdits(runtime, seat.participantId, edits);
+        return undefined;
+    }
+    const since = await editsSinceReview(runtime, seat.participantId);
+    const due = event === 'prompt.submit' ? reviewDueAfterEdits(settings, since) : reviewDueAtStop(settings, since);
+    if (!due)
+        return undefined;
+    const prompt = await selfReviewPrompt(runtime, settings);
+    await markReviewed(runtime, seat.participantId);
+    return `Self-review (${since} edit${since === 1 ? '' : 's'} since the last review):\n${prompt}`;
+}
+/**
+ * The context this hook response injects for `envelope`'s participant, or
+ * undefined when there is nothing to say (no seat, nothing pending).
+ */
+export async function collaborationContext(runtime, envelope, event) {
+    const settings = await readCollaborationSettings(runtime);
+    const seat = await resolveHookSeat(runtime, envelope);
+    if (!seat)
+        return undefined;
+    const targets = envelope.tool && event === 'tool.after' && !envelope.tool.error
+        ? nativeEditTargets(envelope.tool, envelope.workspacePath, await hookWorkspaceRoot(runtime, envelope), settings.editTools)
+        : [];
+    if (event === 'tool.after' && targets.length > 0) {
+        (await getVibesExternalClient(runtime)).rememberDeliveryPaths(seat.sessionId, targets);
+    }
+    const parts = [];
+    // Messages and notices are claimed only where the answer reaches the agent: a prompt and a stop
+    // (every harness shows those). A tool's after-hook can run detached with its output discarded
+    // (Claude Code's), so claiming there would lose them; an edit's overlap is told before it, by the
+    // tool.before lock guard.
+    if (settings.ambientDelivery && event !== 'tool.after') {
+        parts.push(await section(runtime, 'inbox', async () => (await inboxLines(runtime, seat)).join('\n')));
+    }
+    parts.push(await section(runtime, 'self-review', () => reviewNudge(runtime, settings, seat, event, targets.length)));
+    const text = parts.filter((part) => Boolean(part)).join('\n\n');
+    return text || undefined;
+}
+//# sourceMappingURL=hook-delivery.js.map

package/dist/hooks/hook-delivery.js.map

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

package/dist/hooks/hook-seat.d.ts

@@ -0,0 +1,37 @@
+/**
+ * The participant a harness conversation's hook acts for.
+ *
+ * SessionStart seats the conversation (`ensureHarnessSeat`) and binds its
+ * session; every later hook finds that seat and the session it is bound to.
+ * The seat is the same participant the conversation's MCP connection
+ * resolves, so a lock a hook takes and a lock a `workspace-lock` call takes
+ * have one holder.
+ */
+import type { RuntimeInvokeCaller, RuntimeInvokeWorkspace, VibesRuntime } from '@vibesdotdev/kernel';
+import type { ExternalHookEnvelope } from './runtime.ts';
+/** A seated, session-bound harness conversation. */
+export interface HookSeat {
+    readonly participantId: string;
+    readonly sessionId: string;
+    readonly workspaceRoot: string;
+    /** The caller identity tool calls made for this seat carry. */
+    readonly caller: RuntimeInvokeCaller;
+}
+/**
+ * The workspace a hook acts in: the one the relay bound for this call (`runtime/workspace-path`),
+ * not the tool's cwd, which can sit in a nested directory or repository; the envelope's cwd only
+ * on a host that binds none.
+ */
+export declare function hookWorkspaceRoot(runtime: VibesRuntime, envelope: ExternalHookEnvelope): Promise<string>;
+/**
+ * The envelope's seat and bound session, or null when the conversation has
+ * no seat yet or its seat is bound to no session (nothing to attribute to).
+ */
+export declare function resolveHookSeat(runtime: VibesRuntime, envelope: ExternalHookEnvelope): Promise<HookSeat | null>;
+/**
+ * The workspace a tool call made for `seat` runs against: the seat's session
+ * bound at the host's workspace (`workspace/bind-caller`), or undefined on a
+ * host that binds none.
+ */
+export declare function seatWorkspace(runtime: VibesRuntime, seat: HookSeat): Promise<RuntimeInvokeWorkspace | undefined>;
+//# sourceMappingURL=hook-seat.d.ts.map

package/dist/hooks/hook-seat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-seat.d.ts","sourceRoot":"","sources":["../../src/hooks/hook-seat.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACrG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAWzD,oDAAoD;AACpD,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;CACrC;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAE9G;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACpC,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,oBAAoB,GAC5B,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAsB1B;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,CAItH"}

package/dist/hooks/hook-seat.js

@@ -0,0 +1,59 @@
+/**
+ * The participant a harness conversation's hook acts for.
+ *
+ * SessionStart seats the conversation (`ensureHarnessSeat`) and binds its
+ * session; every later hook finds that seat and the session it is bound to.
+ * The seat is the same participant the conversation's MCP connection
+ * resolves, so a lock a hook takes and a lock a `workspace-lock` call takes
+ * have one holder.
+ */
+/**
+ * The workspace a hook acts in: the one the relay bound for this call (`runtime/workspace-path`),
+ * not the tool's cwd, which can sit in a nested directory or repository; the envelope's cwd only
+ * on a host that binds none.
+ */
+export async function hookWorkspaceRoot(runtime, envelope) {
+    return runtime.hasContext('runtime/workspace-path') ? runtime.context('runtime/workspace-path') : envelope.workspacePath;
+}
+/**
+ * The envelope's seat and bound session, or null when the conversation has
+ * no seat yet or its seat is bound to no session (nothing to attribute to).
+ */
+export async function resolveHookSeat(runtime, envelope) {
+    if (!runtime.hasContext('session/manager'))
+        return null;
+    const manager = await runtime.context('session/manager');
+    const seat = await manager.findHarnessSeat({
+        agentId: envelope.clientId,
+        harnessSessionId: envelope.nativeSessionId
+    });
+    if (!seat)
+        return null;
+    const sessionId = await manager.getParticipantActiveSession(seat.participantId);
+    if (!sessionId)
+        return null;
+    return {
+        participantId: seat.participantId,
+        sessionId,
+        workspaceRoot: await hookWorkspaceRoot(runtime, envelope),
+        caller: {
+            agentId: envelope.clientId,
+            harness: envelope.clientId,
+            harnessSessionId: envelope.nativeSessionId,
+            participantId: seat.participantId,
+            sessionId
+        }
+    };
+}
+/**
+ * The workspace a tool call made for `seat` runs against: the seat's session
+ * bound at the host's workspace (`workspace/bind-caller`), or undefined on a
+ * host that binds none.
+ */
+export async function seatWorkspace(runtime, seat) {
+    if (!runtime.hasContext('workspace/bind-caller'))
+        return undefined;
+    const bind = await runtime.context('workspace/bind-caller');
+    return bind(runtime, seat.sessionId);
+}
+//# sourceMappingURL=hook-seat.js.map

package/dist/hooks/hook-seat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-seat.js","sourceRoot":"","sources":["../../src/hooks/hook-seat.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAuBH;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAqB,EAAE,QAA8B;IAC5F,OAAO,OAAO,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAS,wBAAwB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;AAClI,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACpC,OAAqB,EACrB,QAA8B;IAE9B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,iBAAiB,CAAC;QAAE,OAAO,IAAI,CAAC;IACxD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,CAAqB,iBAAiB,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,eAAe,CAAC;QAC1C,OAAO,EAAE,QAAQ,CAAC,QAAQ;QAC1B,gBAAgB,EAAE,QAAQ,CAAC,eAAe;KAC1C,CAAC,CAAC;IACH,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,2BAA2B,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAChF,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,OAAO;QACN,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,SAAS;QACT,aAAa,EAAE,MAAM,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC;QACzD,MAAM,EAAE;YACP,OAAO,EAAE,QAAQ,CAAC,QAAQ;YAC1B,OAAO,EAAE,QAAQ,CAAC,QAAQ;YAC1B,gBAAgB,EAAE,QAAQ,CAAC,eAAe;YAC1C,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,SAAS;SACT;KACD,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAqB,EAAE,IAAc;IACxE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,uBAAuB,CAAC;QAAE,OAAO,SAAS,CAAC;IACnE,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,CAAsB,uBAAuB,CAAC,CAAC;IACjF,OAAO,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;AACtC,CAAC"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * External Hooks Module Exports.
+ *
+ * Universal provider-neutral hook envelopes and adapter contracts.
+ * Host call execution and continuity projection live under `./consumer/node/hooks`.
+ */
+export { EXTERNAL_HOOK_ADAPTER_KIND, ExternalHookAdapterDescriptorSchema, ExternalHookEnvelopeSchema, ExternalHookToolPayloadSchema, createExternalHookAdapterDescriptor, createExternalHookAdapterLoader } from './runtime.ts';
+export type { ExternalHookAdapter, ExternalHookAdapterDescriptor, ExternalHookAdapterModule, ExternalHookEnvelope, ExternalHookInvocation, ExternalHookRenderResult } from './runtime.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACN,0BAA0B,EAC1B,mCAAmC,EACnC,0BAA0B,EAC1B,6BAA6B,EAC7B,mCAAmC,EACnC,+BAA+B,EAC/B,MAAM,cAAc,CAAC;AACtB,YAAY,EACX,mBAAmB,EACnB,6BAA6B,EAC7B,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,MAAM,cAAc,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1,8 @@
+/**
+ * External Hooks Module Exports.
+ *
+ * Universal provider-neutral hook envelopes and adapter contracts.
+ * Host call execution and continuity projection live under `./consumer/node/hooks`.
+ */
+export { EXTERNAL_HOOK_ADAPTER_KIND, ExternalHookAdapterDescriptorSchema, ExternalHookEnvelopeSchema, ExternalHookToolPayloadSchema, createExternalHookAdapterDescriptor, createExternalHookAdapterLoader } from "./runtime.js";
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACN,0BAA0B,EAC1B,mCAAmC,EACnC,0BAA0B,EAC1B,6BAA6B,EAC7B,mCAAmC,EACnC,+BAA+B,EAC/B,MAAM,cAAc,CAAC"}

package/dist/hooks/native-edit-guard.d.ts

@@ -0,0 +1,25 @@
+/**
+ * PreToolUse for native edit tools: lock every file the edit writes as the
+ * conversation's seat. When another participant holds one, tell the editor (or, with
+ * `nativeEditLockConflict: 'refuse'`, refuse the edit).
+ */
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import { resolveHookSeat } from './hook-seat.ts';
+import { type LockPath, type NativeEditLock } from './native-edit-locks.ts';
+import type { ExternalHookEnvelope } from './runtime.ts';
+/** What the guard decided for one tool call. */
+export interface NativeEditGuard {
+    readonly locks: readonly NativeEditLock[];
+    /** The refusal text when another participant holds a target and conflicts refuse. */
+    readonly blocked?: string;
+    /** The notice text when another participant holds a target and conflicts only notify. */
+    readonly notice?: string;
+}
+/** Test seam: how the seat's locks are taken. */
+export type LockFactory = (runtime: VibesRuntime, seat: NonNullable<Awaited<ReturnType<typeof resolveHookSeat>>>, ttlMs?: number) => Promise<LockPath>;
+/**
+ * The guard for `envelope`'s tool call, or undefined when the call is not a
+ * native edit, locking is off, or the conversation has no seat.
+ */
+export declare function guardNativeEdit(runtime: VibesRuntime, envelope: ExternalHookEnvelope, lockFactory?: LockFactory): Promise<NativeEditGuard | undefined>;
+//# sourceMappingURL=native-edit-guard.d.ts.map

package/dist/hooks/native-edit-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-edit-guard.d.ts","sourceRoot":"","sources":["../../src/hooks/native-edit-guard.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EAAqB,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAA8D,KAAK,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxI,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,qFAAqF;IACrF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,yFAAyF;IACzF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,iDAAiD;AACjD,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvJ;;;GAGG;AACH,wBAAsB,eAAe,CACpC,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,oBAAoB,EAC9B,WAAW,GAAE,WAA8B,GACzC,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAatC"}

package/dist/hooks/native-edit-guard.js

@@ -0,0 +1,33 @@
+/**
+ * PreToolUse for native edit tools: lock every file the edit writes as the
+ * conversation's seat. When another participant holds one, tell the editor (or, with
+ * `nativeEditLockConflict: 'refuse'`, refuse the edit).
+ */
+import { readCollaborationSettings } from "../ambient/collaboration-settings.js";
+import { nativeEditTargets } from "./edit-targets.js";
+import { hookWorkspaceRoot, resolveHookSeat } from "./hook-seat.js";
+import { lockNativeEditTargets, lockRefusalReason, workspaceLockFor } from "./native-edit-locks.js";
+/**
+ * The guard for `envelope`'s tool call, or undefined when the call is not a
+ * native edit, locking is off, or the conversation has no seat.
+ */
+export async function guardNativeEdit(runtime, envelope, lockFactory = workspaceLockFor) {
+    const tool = envelope.tool;
+    if (!tool)
+        return undefined;
+    const settings = await readCollaborationSettings(runtime);
+    if (!settings.nativeEditLocks)
+        return undefined;
+    const targets = nativeEditTargets(tool, envelope.workspacePath, await hookWorkspaceRoot(runtime, envelope), settings.editTools);
+    if (targets.length === 0)
+        return undefined;
+    const seat = await resolveHookSeat(runtime, envelope);
+    if (!seat)
+        return undefined;
+    const locks = await lockNativeEditTargets(runtime, seat, targets, await lockFactory(runtime, seat, settings.lockTtlMs));
+    const conflict = lockRefusalReason(locks);
+    if (!conflict)
+        return { locks };
+    return settings.nativeEditLockConflict === 'refuse' ? { locks, blocked: conflict } : { locks, notice: conflict };
+}
+//# sourceMappingURL=native-edit-guard.js.map

package/dist/hooks/native-edit-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-edit-guard.js","sourceRoot":"","sources":["../../src/hooks/native-edit-guard.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,gBAAgB,EAAsC,MAAM,wBAAwB,CAAC;AAexI;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACpC,OAAqB,EACrB,QAA8B,EAC9B,cAA2B,gBAAgB;IAE3C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3B,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,MAAM,QAAQ,GAAG,MAAM,yBAAyB,CAAC,OAAO,CAAC,CAAC;IAC1D,IAAI,CAAC,QAAQ,CAAC,eAAe;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,EAAE,QAAQ,CAAC,aAAa,EAAE,MAAM,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAChI,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3C,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACtD,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,MAAM,KAAK,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACxH,MAAM,QAAQ,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAChC,OAAO,QAAQ,CAAC,sBAAsB,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAClH,CAAC"}

package/dist/hooks/native-edit-locks.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Native edits become workspace locks.
+ *
+ * Before a harness's native edit runs, its hook takes (or renews — a same-holder
+ * lock refreshes its lease) a `workspace-lock` lease on every path the edit
+ * writes, as the conversation's seat. A path another participant holds
+ * refuses the edit and names the holder and the way to ask for the path.
+ * The lock goes through the `workspace-lock` tool, the lock owner's client;
+ * this module never reads the lock registry.
+ */
+import * as z from 'zod/v4';
+import { type ValueFreeFailure, type VibesRuntime } from '@vibesdotdev/kernel';
+import { type HookSeat } from './hook-seat.ts';
+/** The `workspace-lock` answer fields a lock decision reads. */
+declare const LockAnswerSchema: z.ZodObject<{
+    path: z.ZodOptional<z.ZodString>;
+    locked: z.ZodOptional<z.ZodBoolean>;
+    reason: z.ZodOptional<z.ZodString>;
+    holder: z.ZodOptional<z.ZodObject<{
+        sessionId: z.ZodOptional<z.ZodString>;
+        participantId: z.ZodOptional<z.ZodString>;
+        agentId: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>;
+}, z.core.$loose>;
+/** One path's lock outcome. */
+export type NativeEditLock = {
+    readonly path: string;
+    readonly status: 'held';
+} | {
+    readonly path: string;
+    readonly status: 'refused';
+    readonly holder: string;
+    readonly reason?: string;
+} | {
+    readonly path: string;
+    readonly status: 'unavailable';
+    readonly reason?: string;
+    readonly failure?: ValueFreeFailure;
+};
+/** Takes one lock as the seat; the default goes through `workspace-lock`. */
+export type LockPath = (path: string) => Promise<z.input<typeof LockAnswerSchema>>;
+/** A lock call through the `workspace-lock` tool, as `seat`. */
+export declare function workspaceLockFor(runtime: VibesRuntime, seat: HookSeat, ttlMs?: number): Promise<LockPath>;
+/**
+ * Lock every target for the seat. A refusal by another holder is `refused`;
+ * a lock the owner could not decide (no workspace bound, registry
+ * unavailable, path outside the root) is `unavailable` and never refuses the
+ * edit — the lease is the owner's call, not a guess here.
+ */
+export declare function lockNativeEditTargets(runtime: VibesRuntime, seat: HookSeat, targets: readonly string[], lock: LockPath): Promise<NativeEditLock[]>;
+/** The refusal a harness shows for refused paths, or undefined when none was refused. */
+export declare function lockRefusalReason(outcomes: readonly NativeEditLock[]): string | undefined;
+export {};
+//# sourceMappingURL=native-edit-locks.d.ts.map

package/dist/hooks/native-edit-locks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-edit-locks.d.ts","sourceRoot":"","sources":["../../src/hooks/native-edit-locks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAA4B,KAAK,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAIzG,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI9D,gEAAgE;AAChE,QAAA,MAAM,gBAAgB;;;;;;;;;iBAWpB,CAAC;AAEH,+BAA+B;AAC/B,MAAM,MAAM,cAAc,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACxG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAE5H,6EAA6E;AAC7E,MAAM,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC;AAEnF,gEAAgE;AAChE,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAc/G;AAUD;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAC1C,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,IAAI,EAAE,QAAQ,GACZ,OAAO,CAAC,cAAc,EAAE,CAAC,CAuB3B;AAED,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,GAAG,SAAS,CAUzF"}

package/dist/hooks/native-edit-locks.js

@@ -0,0 +1,98 @@
+/**
+ * Native edits become workspace locks.
+ *
+ * Before a harness's native edit runs, its hook takes (or renews — a same-holder
+ * lock refreshes its lease) a `workspace-lock` lease on every path the edit
+ * writes, as the conversation's seat. A path another participant holds
+ * refuses the edit and names the holder and the way to ask for the path.
+ * The lock goes through the `workspace-lock` tool, the lock owner's client;
+ * this module never reads the lock registry.
+ */
+import * as z from 'zod/v4';
+import { settle, valueFreeFailure } from '@vibesdotdev/kernel';
+import { getLogger } from '@vibesdotdev/logging';
+import { invokeTool } from '@vibesdotdev/tools/execution/invoke';
+import { seatWorkspace } from "./hook-seat.js";
+const WORKSPACE_LOCK_TOOL_ID = 'workspace-lock';
+/** The `workspace-lock` answer fields a lock decision reads. */
+const LockAnswerSchema = z.looseObject({
+    path: z.string().optional(),
+    locked: z.boolean().optional(),
+    reason: z.string().optional(),
+    holder: z
+        .looseObject({
+        sessionId: z.string().optional(),
+        participantId: z.string().optional(),
+        agentId: z.string().optional()
+    })
+        .optional()
+});
+/** A lock call through the `workspace-lock` tool, as `seat`. */
+export async function workspaceLockFor(runtime, seat, ttlMs) {
+    const workspace = await seatWorkspace(runtime, seat);
+    return async (path) => {
+        // Tool input crosses the JSON wire check: an unset lease window is an absent
+        // key, never `ttlMs: undefined` (not a JSON value, so the check refuses it).
+        const input = ttlMs === undefined ? { action: 'lock', path } : { action: 'lock', path, ttlMs };
+        const ctx = {
+            callId: `external-hook-lock-${crypto.randomUUID()}`,
+            logger: getLogger('external.hooks.locks', runtime),
+            caller: seat.caller
+        };
+        if (workspace)
+            ctx.workspace = workspace;
+        return LockAnswerSchema.parse(await invokeTool({ runtime, toolId: WORKSPACE_LOCK_TOOL_ID, input, ctx }));
+    };
+}
+/** Whether a lock answer names a holder other than the seat. */
+function foreignHolder(answer, seat) {
+    if (answer.locked !== false || !answer.holder)
+        return undefined;
+    const holder = answer.holder;
+    if (holder.participantId === seat.participantId)
+        return undefined;
+    return holder.participantId ?? holder.agentId ?? holder.sessionId ?? 'another participant';
+}
+/**
+ * Lock every target for the seat. A refusal by another holder is `refused`;
+ * a lock the owner could not decide (no workspace bound, registry
+ * unavailable, path outside the root) is `unavailable` and never refuses the
+ * edit — the lease is the owner's call, not a guess here.
+ */
+export async function lockNativeEditTargets(runtime, seat, targets, lock) {
+    const outcomes = [];
+    for (const path of targets) {
+        const outcome = await settle(async () => LockAnswerSchema.parse(await lock(path)));
+        if (outcome.ok) {
+            const answer = outcome.value;
+            if (answer.locked === true) {
+                outcomes.push({ path, status: 'held' });
+                continue;
+            }
+            const holder = foreignHolder(answer, seat);
+            outcomes.push(holder
+                ? { path, status: 'refused', holder, reason: answer.reason }
+                : { path, status: 'unavailable', reason: answer.reason });
+        }
+        else {
+            const failure = valueFreeFailure(outcome.cause);
+            getLogger('external.hooks.locks', runtime).warn('native edit lock undecided', { failure });
+            outcomes.push({ path, status: 'unavailable', failure });
+        }
+    }
+    return outcomes;
+}
+/** The refusal a harness shows for refused paths, or undefined when none was refused. */
+export function lockRefusalReason(outcomes) {
+    const refused = outcomes.flatMap((outcome) => (outcome.status === 'refused' ? [outcome] : []));
+    const [first] = refused;
+    if (!first)
+        return undefined;
+    const lines = refused.map((outcome) => `${outcome.path} is locked by ${outcome.holder}`);
+    return [
+        `Edit refused: ${lines.join('; ')}.`,
+        `Ask the holder for it with workspace-lock {"action":"request","path":"${first.path}"}, ` +
+            'message them with session-collaborate, or work on another file.'
+    ].join(' ');
+}
+//# sourceMappingURL=native-edit-locks.js.map

package/dist/hooks/native-edit-locks.js.map

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

package/dist/hooks/resolve-event.d.ts

@@ -0,0 +1,13 @@
+import * as z from 'zod/v4';
+import { type HookEvent } from '../plugins/schemas/manifest.ts';
+/**
+ * Accept semantic lifecycle ids and the host-native labels installed scripts
+ * historically passed (`SessionStart`, `PreCompact`, …).
+ */
+export declare function resolveHookLifecycleEvent(event: string, nativeEventMap?: Readonly<Record<string, HookEvent>>): HookEvent | undefined;
+export declare function formatValidHookEvents(nativeEventMap?: Readonly<Record<string, HookEvent>>): string;
+/** The `--output` option as a command receives it: a string when given, anything else is absent. */
+export declare const HookOutputOptionSchema: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+/** `json` and `native` as named; every other value (or none) is `text`. */
+export declare function resolveHookOutputFormat(output: string | undefined): 'text' | 'json' | 'native';
+//# sourceMappingURL=resolve-event.d.ts.map

package/dist/hooks/resolve-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-event.d.ts","sourceRoot":"","sources":["../../src/hooks/resolve-event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAEN,KAAK,SAAS,EACd,MAAM,gCAAgC,CAAC;AAExC;;;GAGG;AACH,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,GAClD,SAAS,GAAG,SAAS,CAOvB;AAED,wBAAgB,qBAAqB,CACpC,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,GAClD,MAAM,CAIR;AAED,oGAAoG;AACpG,eAAO,MAAM,sBAAsB,wCAAyC,CAAC;AAE7E,2EAA2E;AAC3E,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAI9F"}