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

package/dist/ambient/file-access-ambient-fs.subscription.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-access-ambient-fs.subscription.descriptor.js","sourceRoot":"","sources":["../../src/ambient/file-access-ambient-fs.subscription.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,eAAe,kBAAkB,CAAC;IACjC,IAAI,EAAE,sBAAsB;IAC5B,EAAE,EAAE,iCAAiC;IACrC,IAAI,EAAE,yCAAyC;IAC/C,WAAW,EACV,yHAAyH;IAC1H,KAAK,EAAE,gCAAgC;IACvC,OAAO,EAAE,QAAQ;IACjB,WAAW,EAAE,QAAQ;IACrB,MAAM,EAAE;QACP,MAAM,EAAE,OAAO;KACf;IACD,0GAA0G;IAC1G,oEAAoE;IACpE,EAAE;IACF,sFAAsF;IACtF,kFAAkF;IAClF,8EAA8E;IAC9E,mFAAmF;IACnF,OAAO,EAAE,KAAK;CACd,CAAC,CAAC"}

package/dist/ambient/file-access-ambient.impl.d.ts

@@ -0,0 +1,32 @@
+import type { ToolAfterExecuteEvent } from '@vibesdotdev/tools/schemas/tool-events';
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { ExternalInput, ExternalOutput } from '../tools/unified/schemas.ts';
+import { dedupeKey, resetAmbientDedupe } from './collision-notice.ts';
+export { resetAmbientDedupe };
+/** Collect the file paths a single workspace-fs call touched. */
+declare function pathsFromEvent(event: ToolAfterExecuteEvent): string[];
+interface ExternalToolLike {
+    execute(input: ExternalInput): Promise<ExternalOutput>;
+}
+declare const _default: {
+    handle(payload: unknown): Promise<void>;
+};
+export default _default;
+/**
+ * Claim and render messages addressed to this agent.
+ *
+ * Claiming REMOVES, so a message is delivered exactly once. If rendering
+ * somehow fails after a claim the message is lost rather than repeated — the
+ * right trade for an ephemeral surface writing into a context window.
+ */
+export declare function claimAmbientMessages(runtime: VibesRuntime, sessionId: string, paths: string[], identity: {
+    workspaceRoot?: string;
+}): Promise<string | null>;
+/** Exported for tests — the unused-import guard keeps this honest. */
+export declare const __internals: {
+    pathsFromEvent: typeof pathsFromEvent;
+    dedupeKey: typeof dedupeKey;
+    COLLISION_READ_BUDGET_MS: number;
+};
+export type { ExternalToolLike };
+//# sourceMappingURL=file-access-ambient.impl.d.ts.map

package/dist/ambient/file-access-ambient.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-access-ambient.impl.d.ts","sourceRoot":"","sources":["../../src/ambient/file-access-ambient.impl.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AACpF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAcjF,OAAO,EAAmB,SAAS,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEvF,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAkC9B,iEAAiE;AACjE,iBAAS,cAAc,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,EAAE,CAkB9D;AAED,UAAU,gBAAgB;IACzB,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACvD;;oBASsB,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;;AAD9C,wBAsBE;AAsHF;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACzC,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EAAE,EACf,QAAQ,EAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAClC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUxB;AAED,sEAAsE;AACtE,eAAO,MAAM,WAAW;;;;CAA0D,CAAC;AACnF,YAAY,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/ambient/file-access-ambient.impl.js

@@ -0,0 +1,231 @@
+import { activeExternalClient } from "./pending-notices.js";
+/**
+ * Ambient file-touch handler.
+ *
+ * Runs after every `workspace-fs` call and does two things:
+ *   1. RECORDS the touch (with machine / workspace / work-item identity).
+ *   2. If another live session recently CHANGED the same file, appends one
+ *      readable line to this tool's own result.
+ *
+ * The tool result IS the subscription. The notice lands in context at exactly
+ * the moment the agent touches the contested file — the only moment it can
+ * change a decision — in every MCP client, over no new transport. It
+ * self-throttles: an idle agent generates no traffic, and no collision means no
+ * tokens.
+ *
+ * TWO INVARIANTS THIS FILE EXISTS TO PROTECT
+ *
+ * 1. NEVER FAIL OR DELAY AN EDIT. Everything here is best-effort and bounded.
+ *    The write is fire-and-forget. The read is time-boxed. Every path is
+ *    wrapped. A thrown error, a slow disk, a missing session — all degrade to
+ *    "no notice", never to a failed or slowed write. The hook bus already
+ *    swallows handler errors, but relying on that alone would still let a slow
+ *    read add latency to every edit, so the budget is enforced here too.
+ *
+ * 2. SILENT WHEN ALONE. A solo agent must pay ZERO added bytes. The result is
+ *    mutated ONLY when a formatter returns a non-empty line for a real peer.
+ *
+ * There is NO ENFORCEMENT here. This handler cannot block, refuse, or delay a
+ * write. It informs. If you are adding a branch that can say "no", it does not
+ * belong in this file.
+ */
+import * as z from 'zod/v4';
+import { FileOperationSchema } from "../storage/file-access.record.descriptor.js";
+import { resolveTouchIdentity } from "../storage/touch-identity.js";
+import { resolveTouchProjection, toProjectedTouch } from "./cloud-touch-projection.impl.js";
+import { resolveMessageTransport } from "./message-transport.impl.js";
+import { MESSAGE_DELIVERY_CAP, formatMessages } from "../schemas/agent-message.js";
+import { canonicalTouchPath } from "../schemas/path-identity.js";
+import { AnnotatableToolResultSchema, appendAmbientLines, ToolAfterExecuteEventSchema, resolveAmbientFileAccessClient, resolveAmbientSessionId } from "./file-access-shared.js";
+import { attempt } from "./attempt.js";
+import { collisionNotice, dedupeKey, resetAmbientDedupe } from "./collision-notice.js";
+export { resetAmbientDedupe };
+/**
+ * Hard ceiling on the collision read.
+ *
+ * `afterExecute` subscribers BLOCK the tool response — there is a standing
+ * 500ms settle budget asserted by
+ * workspace/src/__tests__/platform-tools.integration.test.ts. A
+ * notice is worth single-digit milliseconds and nothing more; past this we
+ * abandon it and let the edit return.
+ */
+const COLLISION_READ_BUDGET_MS = 75;
+/** fs actions that represent a CHANGE worth recording as a collision source. */
+const WRITE_ACTIONS = new Set(['write', 'edit', 'delete']);
+/**
+ * The fs-tool input projection this handler reads: the action plus every
+ * path-bearing field. Anything else the tool carries is not this handler's
+ * contract and is ignored. A `list`/`search` action fails the operation enum,
+ * so untracked actions never reach the touch stream.
+ */
+const FsTouchInputSchema = z.object({
+    action: FileOperationSchema.optional(),
+    path: z.string().min(1).optional().catch(undefined),
+    bulk: z.unknown().optional(),
+    files: z.unknown().optional()
+});
+/** One path-bearing entry of a bulk write/edit payload. */
+const FsTouchPathEntrySchema = z.object({
+    path: z.string().min(1).optional().catch(undefined)
+});
+/** Collect the file paths a single workspace-fs call touched. */
+function pathsFromEvent(event) {
+    const parsed = FsTouchInputSchema.safeParse(event.input);
+    if (!parsed.success)
+        return [];
+    const paths = [];
+    if (parsed.data.path)
+        paths.push(parsed.data.path);
+    // Bulk write/edit carry their own path list; a malformed entry is skipped,
+    // never fatal to its siblings.
+    for (const list of [parsed.data.bulk, parsed.data.files]) {
+        if (!Array.isArray(list))
+            continue;
+        for (const entry of list) {
+            const path = FsTouchPathEntrySchema.safeParse(entry);
+            if (path.success && path.data.path)
+                paths.push(path.data.path);
+        }
+    }
+    return Array.from(new Set(paths));
+}
+export default {
+    async handle(payload) {
+        const parsedEvent = ToolAfterExecuteEventSchema.safeParse(payload);
+        if (!parsedEvent.success)
+            return;
+        const event = parsedEvent.data;
+        if (!event.runtime)
+            return;
+        const parsedInput = FsTouchInputSchema.safeParse(event.input);
+        if (!parsedInput.success)
+            return;
+        const action = parsedInput.data.action;
+        if (!action)
+            return;
+        const paths = pathsFromEvent(event);
+        if (paths.length === 0)
+            return;
+        // The recording is fire-and-forget; the collision check + notice
+        // injection MUST complete before the tool result is sent, otherwise
+        // the notice is lost and the `told` dedupe set is poisoned by a
+        // background promise that runs after the budget expires. The MCP
+        // framework's 500ms settle budget is the real ceiling.
+        await attempt(event.runtime, () => processTouch(event, action, paths));
+    }
+};
+async function processTouch(event, action, paths) {
+    const runtime = event.runtime;
+    const [sessionId, client] = await Promise.all([
+        resolveAmbientSessionId(runtime),
+        resolveAmbientFileAccessClient(runtime)
+    ]);
+    // No session means no identity and no way to exclude self from a read.
+    // Recording an unattributable touch would poison every future collision.
+    if (!sessionId || !client)
+        return;
+    const identityOutcome = await attempt(runtime, () => resolveTouchIdentity(runtime));
+    const identity = identityOutcome.ok ? identityOutcome.value : {};
+    // Canonicalise BEFORE anything compares paths as strings. Two agents
+    // editing one file routinely spell it differently (relative vs absolute);
+    // without this they silently never collide, and the failure is invisible
+    // because "no peer" and "no string match" look identical.
+    const canonicalPaths = paths.map((p) => canonicalTouchPath(p, identity.workspaceRoot));
+    // 1. RECORD locally — fire-and-forget. The edit already happened; nothing
+    // waits. The local record stays authoritative and offline-safe.
+    void Promise.all(canonicalPaths.map((filePath) => attempt(runtime, () => client.trackFileAccess({
+        sessionId,
+        filePath,
+        operation: action,
+        toolName: 'workspace-fs',
+        toolCallId: event.callId,
+        ...identity
+    }))));
+    // 1b. PROJECT outward for cross-machine visibility — batched and debounced
+    // behind a synchronous call, so this costs the edit nothing and is a no-op
+    // when projection is disabled or the machine is offline.
+    void attempt(runtime, async () => {
+        const projection = await resolveTouchProjection(runtime);
+        const now = new Date();
+        projection.project(canonicalPaths.map((filePath) => toProjectedTouch({
+            sessionId,
+            filePath,
+            operation: action,
+            timestamp: now,
+            machineId: identity.machineId,
+            machineName: identity.machineName,
+            participantId: identity.participantId,
+            participantSlug: identity.participantSlug,
+            workspaceRoot: identity.workspaceRoot,
+            gitBranch: identity.gitBranch,
+            workItemId: identity.workItemId,
+            workItemTitle: identity.workItemTitle
+        })));
+    });
+    const owner = activeExternalClient(runtime);
+    if (owner.ambientDeliveryDeferred(sessionId) || !AnnotatableToolResultSchema.safeParse(event.result).success) {
+        owner.rememberDeliveryPaths(sessionId, canonicalPaths);
+        return;
+    }
+    // 2. MESSAGES — claim anything addressed to this agent. Runs on every
+    // tracked action (including reads) so an agent hears from a peer as a side
+    // effect of working, never by remembering to poll.
+    const messageOutcome = await attempt(runtime, () => claimAmbientMessages(runtime, sessionId, canonicalPaths, identity));
+    const messageLine = messageOutcome.ok ? messageOutcome.value : undefined;
+    // 3. NOTICE — only for a real change, and only for the primary path. A bulk
+    // write touching 40 files must not emit 40 lines; that is the noise budget
+    // wearing a different hat.
+    const primary = canonicalPaths[0];
+    if (!WRITE_ACTIONS.has(action) || !primary) {
+        if (messageLine)
+            applyLines(event, { messages: messageLine });
+        return;
+    }
+    // Told ONCE per (session x path x peer); the told set is marked only once
+    // the notice is on the result.
+    const collision = await collisionNotice(runtime, client, {
+        sessionId,
+        filePath: primary,
+        workspaceRoot: identity.workspaceRoot
+    });
+    if (!collision.notice) {
+        if (messageLine)
+            applyLines(event, { messages: messageLine });
+        return;
+    }
+    if (applyLines(event, { notice: collision.notice, messages: messageLine ?? undefined }))
+        collision.markTold();
+}
+/**
+ * THE ONLY MUTATION SITE. Reached only when there is something real to say —
+ * which is what makes a solo agent with an empty inbox byte-for-byte silent.
+ */
+function applyLines(event, lines) {
+    const parsed = AnnotatableToolResultSchema.safeParse(event.result);
+    if (!parsed.success)
+        return false;
+    const result = parsed.data;
+    appendAmbientLines(result, lines);
+    return true;
+}
+/**
+ * Claim and render messages addressed to this agent.
+ *
+ * Claiming REMOVES, so a message is delivered exactly once. If rendering
+ * somehow fails after a claim the message is lost rather than repeated — the
+ * right trade for an ephemeral surface writing into a context window.
+ */
+export async function claimAmbientMessages(runtime, sessionId, paths, identity) {
+    const transport = await resolveMessageTransport(runtime);
+    const claimed = await transport.claim({
+        sessionId,
+        workspaceRoot: identity.workspaceRoot,
+        filePaths: paths,
+        limit: MESSAGE_DELIVERY_CAP
+    });
+    // Empty inbox -> null -> zero added bytes.
+    return formatMessages(claimed, MESSAGE_DELIVERY_CAP);
+}
+/** Exported for tests — the unused-import guard keeps this honest. */
+export const __internals = { pathsFromEvent, dedupeKey, COLLISION_READ_BUDGET_MS };
+//# sourceMappingURL=file-access-ambient.impl.js.map

package/dist/ambient/file-access-ambient.impl.js.map

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

package/dist/ambient/file-access-ambient.subscription.descriptor.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Ambient file-touch subscription.
+ *
+ * Re-homes the file-access write path that was orphaned when the fs tools moved
+ * to `workspace-fs` (the old `trackFileAccess` helper in
+ * `workspace` had ZERO call sites and no touch was ever recorded).
+ *
+ * Binding to `tools.tool.afterExecute` with a `toolId` filter — rather than
+ * calling a client from inside the fs tool — means:
+ *   - one handler covers every fs action,
+ *   - no package edge is created (a toolId string is not an import),
+ *   - a future package split cannot orphan it the way the inline call was,
+ *   - and a user can disable or replace it by overriding this descriptor.
+ *
+ * See docs/architecture/AMBIENT-AGENT-AWARENESS.md.
+ */
+declare const _default: {
+    kind: "runtime/subscription";
+    id: string;
+    name: string;
+    description: string;
+    event: string;
+    handler: string;
+    handlerType: string;
+    filter: {
+        toolId: string[];
+    };
+    enabled: true;
+};
+export default _default;
+//# sourceMappingURL=file-access-ambient.subscription.descriptor.d.ts.map

package/dist/ambient/file-access-ambient.subscription.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-access-ambient.subscription.descriptor.d.ts","sourceRoot":"","sources":["../../src/ambient/file-access-ambient.subscription.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;;;;;;;;;;;;;;AAIH,wBAaG"}

package/dist/ambient/file-access-ambient.subscription.descriptor.js

@@ -0,0 +1,31 @@
+/**
+ * Ambient file-touch subscription.
+ *
+ * Re-homes the file-access write path that was orphaned when the fs tools moved
+ * to `workspace-fs` (the old `trackFileAccess` helper in
+ * `workspace` had ZERO call sites and no touch was ever recorded).
+ *
+ * Binding to `tools.tool.afterExecute` with a `toolId` filter — rather than
+ * calling a client from inside the fs tool — means:
+ *   - one handler covers every fs action,
+ *   - no package edge is created (a toolId string is not an import),
+ *   - a future package split cannot orphan it the way the inline call was,
+ *   - and a user can disable or replace it by overriding this descriptor.
+ *
+ * See docs/architecture/AMBIENT-AGENT-AWARENESS.md.
+ */
+import { createRuntimeAsset } from '@vibesdotdev/kernel';
+export default createRuntimeAsset({
+    kind: 'runtime/subscription',
+    id: 'external.file-access.ambient',
+    name: 'Ambient File Touch',
+    description: 'Records workspace-fs touches and appends a one-line notice when another live session recently changed the same file',
+    event: 'tools.tool.afterExecute',
+    handler: 'inline',
+    handlerType: 'inline',
+    filter: {
+        toolId: ['workspace-fs']
+    },
+    enabled: true
+});
+//# sourceMappingURL=file-access-ambient.subscription.descriptor.js.map

package/dist/ambient/file-access-ambient.subscription.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-access-ambient.subscription.descriptor.js","sourceRoot":"","sources":["../../src/ambient/file-access-ambient.subscription.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,eAAe,kBAAkB,CAAC;IACjC,IAAI,EAAE,sBAAsB;IAC5B,EAAE,EAAE,8BAA8B;IAClC,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACV,qHAAqH;IACtH,KAAK,EAAE,yBAAyB;IAChC,OAAO,EAAE,QAAQ;IACjB,WAAW,EAAE,QAAQ;IACrB,MAAM,EAAE;QACP,MAAM,EAAE,CAAC,cAAc,CAAC;KACxB;IACD,OAAO,EAAE,IAAI;CACb,CAAC,CAAC"}

package/dist/ambient/file-access-shared.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Ambient file-access handlers' shared reads.
+ *
+ * The tool, filesystem-watcher, and drain handlers each resolve the same
+ * three things — the bound session, the file-access client, and a swappable
+ * implementation — so they read them here instead of carrying their own
+ * copies. Every read validates what it resolves: a resolved value that fails
+ * its schema degrades exactly like an unresolvable one.
+ */
+import * as z from 'zod/v4';
+import type { ToolAfterExecuteEvent } from '@vibesdotdev/tools/schemas/tool-events';
+import type { VibesRuntime } from '@vibesdotdev/kernel';
+import type { FileAccess } from '../schemas/file-access.ts';
+import { type TouchPeer, type WhoElseTouchedInput } from '../schemas/collision.ts';
+import type { TrackFileAccessOptions } from '../client/external-client.ts';
+import { type PendingNotice } from '../schemas/pending-notice.ts';
+/**
+ * The tool-event envelope an ambient handler relies on: an object carrying
+ * the runtime it reads through plus the input it records and the result it
+ * may annotate. The event keeps its identity — validation only proves the
+ * envelope, never clones it.
+ */
+export declare const ToolAfterExecuteEventSchema: z.ZodCustom<ToolAfterExecuteEvent, ToolAfterExecuteEvent>;
+/** The bound session, or the process fallback every ambient handler agrees on. */
+export declare function resolveAmbientSessionId(runtime: VibesRuntime): Promise<string | undefined>;
+/** The file-access client as ambient sees it: record touches, read peers. */
+export interface AmbientFileAccessClient {
+    trackFileAccess(options: TrackFileAccessOptions): Promise<FileAccess>;
+    whoElseTouched(input: WhoElseTouchedInput): Promise<TouchPeer[]>;
+}
+export declare const AmbientFileAccessClientSchema: z.ZodCustom<AmbientFileAccessClient, AmbientFileAccessClient>;
+/** The composed file-access client, or undefined when none resolves. */
+export declare function resolveAmbientFileAccessClient(runtime: VibesRuntime): Promise<AmbientFileAccessClient | undefined>;
+/**
+ * Resolve a swappable implementation, falling back to the built-in default.
+ * A resolved value that fails the implementation's schema falls back too:
+ * the default is the contract, not the absence path.
+ */
+export declare function resolveAmbientImpl<T>(runtime: VibesRuntime, kind: string, schema: z.ZodType<T>, fallback: T): Promise<T>;
+/** A tool result a notice can be written onto: any non-array object. */
+export interface AnnotatableToolResult {
+    notice?: string;
+    messages?: string;
+}
+export declare const AnnotatableToolResultSchema: z.ZodCustom<AnnotatableToolResult, AnnotatableToolResult>;
+/** Preserve lines already on a result when both tool and watcher paths deliver. */
+export declare function appendAmbientLines(result: AnnotatableToolResult, lines: PendingNotice): void;
+//# sourceMappingURL=file-access-shared.d.ts.map

package/dist/ambient/file-access-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-access-shared.d.ts","sourceRoot":"","sources":["../../src/ambient/file-access-shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AACpF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EACN,KAAK,SAAS,EACd,KAAK,mBAAmB,EACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAIvF;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,2DAEvC,CAAC;AAEF,kFAAkF;AAClF,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAUhG;AAED,6EAA6E;AAC7E,MAAM,WAAW,uBAAuB;IACvC,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACtE,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;CACjE;AAED,eAAO,MAAM,6BAA6B,+DAOzC,CAAC;AAEF,wEAAwE;AACxE,wBAAsB,8BAA8B,CACnD,OAAO,EAAE,YAAY,GACnB,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CAO9C;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACzC,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EACpB,QAAQ,EAAE,CAAC,GACT,OAAO,CAAC,CAAC,CAAC,CAKZ;AAED,wEAAwE;AACxE,MAAM,WAAW,qBAAqB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,2BAA2B,2DAEvC,CAAC;AAEF,mFAAmF;AACnF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,qBAAqB,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAG5F"}

package/dist/ambient/file-access-shared.js

@@ -0,0 +1,59 @@
+/**
+ * Ambient file-access handlers' shared reads.
+ *
+ * The tool, filesystem-watcher, and drain handlers each resolve the same
+ * three things — the bound session, the file-access client, and a swappable
+ * implementation — so they read them here instead of carrying their own
+ * copies. Every read validates what it resolves: a resolved value that fails
+ * its schema degrades exactly like an unresolvable one.
+ */
+import * as z from 'zod/v4';
+import {} from "../schemas/collision.js";
+import { PendingNoticeSchema } from "../schemas/pending-notice.js";
+import { getAmbientSessionId } from "./pending-notices.js";
+import { attempt } from "./attempt.js";
+/**
+ * The tool-event envelope an ambient handler relies on: an object carrying
+ * the runtime it reads through plus the input it records and the result it
+ * may annotate. The event keeps its identity — validation only proves the
+ * envelope, never clones it.
+ */
+export const ToolAfterExecuteEventSchema = z.custom((value) => value instanceof Object && 'runtime' in value && 'input' in value && 'result' in value);
+/** The bound session, or the process fallback every ambient handler agrees on. */
+export async function resolveAmbientSessionId(runtime) {
+    const outcome = await attempt(runtime, async () => {
+        const manager = await runtime.context('session/manager');
+        const id = manager?.activeSessionId ?? manager?.id;
+        return id !== undefined && id.length > 0 ? id : undefined;
+    });
+    const bound = outcome.ok ? outcome.value : undefined;
+    return getAmbientSessionId(runtime, bound);
+}
+export const AmbientFileAccessClientSchema = z.custom((value) => value instanceof Object &&
+    'trackFileAccess' in value &&
+    Object(value).trackFileAccess instanceof Function &&
+    'whoElseTouched' in value &&
+    Object(value).whoElseTouched instanceof Function);
+/** The composed file-access client, or undefined when none resolves. */
+export async function resolveAmbientFileAccessClient(runtime) {
+    const outcome = await attempt(runtime, async () => AmbientFileAccessClientSchema.parse(await runtime.query('runtime/client').withId('external').resolve()));
+    return outcome.ok ? outcome.value : undefined;
+}
+/**
+ * Resolve a swappable implementation, falling back to the built-in default.
+ * A resolved value that fails the implementation's schema falls back too:
+ * the default is the contract, not the absence path.
+ */
+export async function resolveAmbientImpl(runtime, kind, schema, fallback) {
+    const outcome = await attempt(runtime, async () => schema.parse(await runtime.query(kind).resolve()));
+    return outcome.ok ? outcome.value : fallback;
+}
+export const AnnotatableToolResultSchema = z.custom((value) => value instanceof Object && !Array.isArray(value) && !(value instanceof Function) && PendingNoticeSchema.safeParse(value).success);
+/** Preserve lines already on a result when both tool and watcher paths deliver. */
+export function appendAmbientLines(result, lines) {
+    if (lines.notice)
+        result.notice = [result.notice, lines.notice].filter(Boolean).join('\n');
+    if (lines.messages)
+        result.messages = [result.messages, lines.messages].filter(Boolean).join('\n');
+}
+//# sourceMappingURL=file-access-shared.js.map

package/dist/ambient/file-access-shared.js.map

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

package/dist/ambient/message-transport.impl.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Default `external/message-transport`.
+ *
+ * Two legs, one contract:
+ *  - LOCAL  — `external.agent_messages` in SQLite. Authoritative, offline-safe,
+ *             covers same-machine cross-session messaging.
+ *  - REMOTE — the declared `hq` service's ambient endpoint. Covers cross-machine.
+ *
+ * `claim()` reads both concurrently. A remote failure degrades to same-machine
+ * messaging; a total failure degrades to silence. Neither ever throws, because
+ * this runs on the fs hot path behind the same budget as the collision notice.
+ *
+ * DELIVERED-ONCE is implemented as CLAIM-AND-REMOVE on both legs — delete the
+ * local row, and let the server delete the remote key as it serves it. A
+ * read-then-mark design can redeliver into a context window if the process dies
+ * in between, which is the one failure mode this surface must not have.
+ */
+import { type VibesRuntime } from '@vibesdotdev/kernel';
+import { type AgentMessage, type MessageTransportImplementation } from '../schemas/agent-message.ts';
+export declare class DefaultMessageTransport implements MessageTransportImplementation {
+    private readonly runtime;
+    private pending;
+    private inFlight;
+    constructor(runtime: VibesRuntime);
+    private record;
+    /** Log an opportunistic claim-side failure the claim degrades past. */
+    private noteClaimIssue;
+    send(message: AgentMessage): void;
+    flush(): Promise<void>;
+    claim(input: {
+        sessionId: string;
+        workspaceRoot?: string;
+        filePaths: string[];
+        limit: number;
+    }): Promise<AgentMessage[]>;
+    private claimLocal;
+    private claimRemote;
+}
+/**
+ * Resolve the configured transport, falling back to the built-in default.
+ * A host that composes no transport gets the default; a transport that fails
+ * to load fails the resolution, so an explicit send reports it instead of
+ * silently going nowhere.
+ */
+export declare function resolveMessageTransport(runtime: VibesRuntime): Promise<MessageTransportImplementation>;
+export default DefaultMessageTransport;
+//# sourceMappingURL=message-transport.impl.d.ts.map

package/dist/ambient/message-transport.impl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-transport.impl.d.ts","sourceRoot":"","sources":["../../src/ambient/message-transport.impl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EAMN,KAAK,YAAY,EACjB,MAAM,qBAAqB,CAAC;AAO7B,OAAO,EAGN,KAAK,YAAY,EACjB,KAAK,8BAA8B,EACnC,MAAM,6BAA6B,CAAC;AA6GrC,qBAAa,uBAAwB,YAAW,8BAA8B;IAIjE,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,QAAQ,CAA8B;gBAEjB,OAAO,EAAE,YAAY;YAEpC,MAAM;IAkBpB,uEAAuE;IACvE,OAAO,CAAC,cAAc;IAOtB,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAiB3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2CtB,KAAK,CAAC,KAAK,EAAE;QAClB,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;YAiCb,UAAU;YAoDV,WAAW;CA6BzB;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC5C,OAAO,EAAE,YAAY,GACnB,OAAO,CAAC,8BAA8B,CAAC,CAQzC;AAED,eAAe,uBAAuB,CAAC"}