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

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAQjF,OAAO,EAAE,YAAY,EAAsC,MAAM,sBAAsB,CAAC;AAExF,OAAO,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AAEtF,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAA0B,CAAC;AAC/D,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAA2B,CAAC;AACjE,MAAM,CAAC,MAAM,uBAAuB,GAAG,oBAA6B,CAAC;AAErE,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,8BAA8B,GAAG,YAAY,CAAC,MAAM,CAAC;IACjE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC;IACrC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC,QAAQ,EAAE;CACzD,CAAC,CAAC;AAcH,MAAM,CAAC,MAAM,+BAA+B,GAAG,uBAAuB,CAAC,MAAM,CAAC;IAC7E,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC;IACtC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACtD,CAAC,CAAC;AAGH,4EAA4E;AAC5E,kEAAkE;AAClE,MAAM,uCAAuC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAElF;;;;GAIG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,uBAAuB,CAAC,MAAM,CAAC;IAC/E,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,uBAAuB,CAAC;IACxC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAChC,SAAS,EAAE,CAAC;SACV,MAAM,EAAE;SACR,IAAI,EAAE;SACN,KAAK,CAAC,mBAAmB,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IAC7D,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,uCAAuC,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACpF,CAAC,CAAC;AAiCH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;IAC9C,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;IAC/C,OAAO,EAAE,CAAC;SACR,KAAK,CACL,CAAC,CAAC,MAAM,CAAC;QACR,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;QAC9C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;QAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;QAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;KAC9C,CAAC,CACF;SACA,QAAQ,EAAE;SACV,KAAK,CAAC,SAAS,CAAC;IAClB,MAAM,EAAE,CAAC;SACP,KAAK,CACL,CAAC,CAAC,MAAM,CAAC;QACR,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;QAC9C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;QAC/C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;KAC9C,CAAC,CACF;SACA,QAAQ,EAAE;SACV,KAAK,CAAC,SAAS,CAAC;IAClB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;IACxD,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;CAC5D,CAAC,CAAC;AAyCH,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;IACnD,EAAE,EAAE,oBAAoB;IACxB,gBAAgB,EAAE,8BAA8B;CAChD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;IACpD,EAAE,EAAE,qBAAqB;IACzB,gBAAgB,EAAE,+BAA+B;CACjD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,iBAAiB,CAAC;IACtD,EAAE,EAAE,uBAAuB;IAC3B,gBAAgB,EAAE,iCAAiC;CACnD,CAAC,CAAC;AAEH,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC9C,OAAmB,EACnB,UAAuC,EACvC,IAA6B;IAE7B,IAAI,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzF,MAAM,IAAI,KAAK,CACd,uBAAuB,UAAU,CAAC,EAAE,8BAA8B,UAAU,CAAC,MAAM,GAAG,CACtF,CAAC;IACH,CAAC;IACD,MAAM,SAAS,GAAG,OAAO;SACvB,KAAK,CAAC,uBAAuB,CAAC;SAC9B,WAAW,EAAE;SACb,GAAG,CAAC,CAAC,SAAkB,EAAE,EAAE,CAAC,iCAAiC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;SAC/E,IAAI,CACJ,CAAC,SAAS,EAAE,EAAE,CACb,SAAS,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,IAAI,SAAS,CAAC,SAAS,KAAK,UAAU,CAAC,SAAS,CACvF,CAAC;IACH,IAAI,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACd,wBAAwB,SAAS,CAAC,EAAE,UAAU,UAAU,CAAC,EAAE,+BAA+B,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,SAAS,GAAG,CACtI,CAAC;IACH,CAAC;IACD,OAAO,CAAC,kBAAkB,CAAC,uBAAuB,EAAE,UAAU,CAAC,CAAC;IAChE,OAAO,CAAC,cAAc,CAAC,uBAAuB,EAAE,UAAU,CAAC,EAAE,EAAE,IAAI,EAAE;QACpE,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE;KACtC,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,MAAM,2BAA2B,CAAC,OAAO,CAAC,CAAC;IAC7D,SAAS,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,wBAAwB,CACvC,OAA8C;IAE9C,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QAC9C,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YAC5C,MAAM,IAAI,KAAK,CACd,4BAA4B,OAAO,CAAC,EAAE,iBAAiB,OAAO,CAAC,QAAQ,gBAAgB,OAAO,CAAC,MAAM,CAAC,EAAE,GAAG,CAC3G,CAAC;QACH,CAAC;IACF,CAAC;IACD,OAAO,8BAA8B,CAAC,KAAK,CAAC;QAC3C,GAAG,OAAO,CAAC,MAAM;QACjB,IAAI,EAAE,oBAAoB;QAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC1B,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CACzC,MAAgC;IAEhC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,EAAE,MAAM;QACvC,CAAC,CAAC,MAAM,CAAC,QAAQ;QACjB,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;IACzD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAC/B,+BAA+B,CAAC,KAAK,CAAC;QACrC,IAAI,EAAE,qBAAqB;QAC3B,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,EAAE,EAAE;QACpC,IAAI,EAAE,OAAO,CAAC,EAAE;QAChB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,OAAO,CAAC,EAAE;QACnB,QAAQ,EAAE,MAAM,CAAC,EAAE;QACnB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;QAC9B,IAAI,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC;QAC5C,QAAQ,EAAE,CAAC,UAAU,CAAC;QACtB,OAAO,EAAE,IAAI;KACb,CAAC,CACF,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,sBAAsB,CACrC,OAAmB,EACnB,MAAgC;IAEhC,OAAO,CAAC,kBAAkB,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;IACzD,KAAK,MAAM,OAAO,IAAI,0BAA0B,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1D,OAAO,CAAC,kBAAkB,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;AACF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,8BAA8B,CACnD,OAAmB;IAEnB,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC;QACvD,CAAC,CAAC,MAAM,OAAO,CAAC,KAAK,CAAkD,oBAAoB,CAAC,CAAC,OAAO,EAAE;QACtG,CAAC,CAAC,SAAS,CAAC;IACb,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC;QACrD,CAAC,CAAC,MAAM,OAAO,CAAC,KAAK,CAAsC,mBAAmB,CAAC,CAAC,OAAO,EAAE;QACzF,CAAC,CAAC,SAAS,CAAC;IACb,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,qBAAqB,CAAC;QACzD,CAAC,CAAC,MAAM,OAAO,CAAC,KAAK,CAAsD,qBAAqB,CAAC,CAAC,OAAO,EAAE;QAC3G,CAAC,CAAC,SAAS,CAAC;IACb,IAAI,aAAiC,CAAC;IACtC,IAAI,OAAO,CAAC,UAAU,CAAC,wBAAwB,CAAC,EAAE,CAAC;QAClD,aAAa,GAAG,MAAM,OAAO,CAAC,OAAO,CAAS,wBAAwB,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,KAiBjD;IACA,OAAO,iCAAiC,CAAC,KAAK,CAAC;QAC9C,IAAI,EAAE,uBAAuB;QAC7B,IAAI,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC;QAC7C,QAAQ,EAAE,CAAC,UAAU,CAAC;QACtB,OAAO,EAAE,IAAI;QACb,GAAG,KAAK;KACR,CAAC,CAAC;AACJ,CAAC"}

package/dist/schemas/agent-message.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Agent-to-agent messages.
+ *
+ * The collision notice tells B that A is in the same file. The obvious next
+ * move is "ask A what they're doing" — and until now there was no way to do
+ * that. This is that way.
+ *
+ * THREE PROPERTIES THAT DEFINE THIS SURFACE
+ *
+ * 1. EPHEMERAL. TTL'd, delivered-once, no archive. Durable decisions belong in
+ *    work items and `knowledge`, which are queryable and outlive every session.
+ *    A chat log between agents is neither.
+ *
+ * 2. DELIVERED ON THE TOOL RESULT. An agent reads its messages as a side effect
+ *    of doing its work, never by remembering to poll. Same channel as the
+ *    collision notice, same noise budget: capped, deduped, and SILENT when the
+ *    inbox is empty.
+ *
+ * 3. ADDRESSED BY WHAT YOU KNOW. You rarely know who the other agent IS — you
+ *    know they are in the file you are in. `path` addressing is what makes this
+ *    feel ambient: you reply to a collision without knowing who you are talking
+ *    to.
+ *
+ * NO ENFORCEMENT. A message cannot block, gate, or refuse anything. It is
+ * information arriving at a useful moment.
+ */
+import * as z from 'zod/v4';
+/** Messages live this long, then they are gone. No archive, no inbox debt. */
+export declare const MESSAGE_TTL_MS: number;
+/** Cap on messages surfaced in a single tool result. */
+export declare const MESSAGE_DELIVERY_CAP = 3;
+export declare const MAX_MESSAGE_LENGTH = 500;
+/**
+ * Who a message is for.
+ *
+ * - `session` — a specific agent you already know the id of.
+ * - `path`    — whoever recently touched this file. The ambient one.
+ * - `workspace` — everyone in this workspace. Use sparingly; it is the only
+ *   addressing mode that can wake an agent who was not already involved.
+ */
+export declare const MessageAudienceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"session">;
+    sessionId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"path">;
+    filePath: z.ZodString;
+    workspaceRoot: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"workspace">;
+    workspaceRoot: z.ZodString;
+}, z.core.$strip>], "kind">;
+export type MessageAudience = z.infer<typeof MessageAudienceSchema>;
+export declare const AgentMessageSchema: z.ZodObject<{
+    id: z.ZodString;
+    fromSessionId: z.ZodString;
+    fromMachineId: z.ZodOptional<z.ZodString>;
+    fromMachineName: z.ZodOptional<z.ZodString>;
+    fromWorkItemTitle: z.ZodOptional<z.ZodString>;
+    audience: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"session">;
+        sessionId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"path">;
+        filePath: z.ZodString;
+        workspaceRoot: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"workspace">;
+        workspaceRoot: z.ZodString;
+    }, z.core.$strip>], "kind">;
+    body: z.ZodString;
+    sentAt: z.ZodCoercedDate<unknown>;
+    expiresAt: z.ZodCoercedDate<unknown>;
+}, z.core.$strict>;
+export type AgentMessage = z.infer<typeof AgentMessageSchema>;
+export declare const SendMessageInputSchema: z.ZodObject<{
+    audience: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"session">;
+        sessionId: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"path">;
+        filePath: z.ZodString;
+        workspaceRoot: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"workspace">;
+        workspaceRoot: z.ZodString;
+    }, z.core.$strip>], "kind">;
+    body: z.ZodString;
+}, z.core.$strip>;
+export type SendMessageInput = z.infer<typeof SendMessageInputSchema>;
+/**
+ * Runtime kind `external/message-transport`.
+ *
+ * Descriptor-resolved so a user can point messaging at their own relay.
+ *
+ * Every method is best-effort by contract: an implementation MUST NOT throw and
+ * MUST NOT block an edit. An unreachable gateway degrades to same-machine
+ * messaging, and a fully unreachable transport degrades to silence.
+ */
+export interface MessageTransportImplementation {
+    /** Queue a message for delivery. Returns immediately. */
+    send(message: AgentMessage): void;
+    /**
+     * Claim messages addressed to this agent.
+     *
+     * DELIVERED-ONCE is the transport's job: a claimed message must not be
+     * returned again to the same recipient. Implementations claim-and-remove
+     * rather than read-then-mark, so a crash between the two cannot redeliver
+     * into a context window twice.
+     */
+    claim(input: {
+        sessionId: string;
+        workspaceRoot?: string;
+        filePaths: string[];
+        limit: number;
+    }): Promise<AgentMessage[]>;
+    flush?(): Promise<void>;
+}
+/**
+ * Does this message target this recipient?
+ *
+ * Pure, and shared by every transport so local and remote cannot disagree
+ * about who a message was for.
+ */
+export declare function messageTargets(message: AgentMessage, recipient: {
+    sessionId: string;
+    workspaceRoot?: string;
+    filePaths: string[];
+}, now?: Date): boolean;
+/**
+ * Render claimed messages as ONE line for a tool result.
+ *
+ * Returns null for an empty inbox — silence is the common case and must cost
+ * zero bytes.
+ */
+export declare function formatMessages(messages: AgentMessage[], cap?: number): string | null;
+//# sourceMappingURL=agent-message.d.ts.map

package/dist/schemas/agent-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-message.d.ts","sourceRoot":"","sources":["../../src/schemas/agent-message.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,8EAA8E;AAC9E,eAAO,MAAM,cAAc,QAAiB,CAAC;AAE7C,wDAAwD;AACxD,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;2BAQhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;kBAsBrB,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;iBAGjC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;;;;;;;GAQG;AACH,MAAM,WAAW,8BAA8B;IAC9C,yDAAyD;IACzD,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAElC;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,EAAE;QACZ,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,CAAC;IAE5B,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC7B,OAAO,EAAE,YAAY,EACrB,SAAS,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,EAC7E,GAAG,GAAE,IAAiB,GACpB,OAAO,CAgCT;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,GAAG,SAAuB,GAAG,MAAM,GAAG,IAAI,CAclG"}

package/dist/schemas/agent-message.js

@@ -0,0 +1,131 @@
+/**
+ * Agent-to-agent messages.
+ *
+ * The collision notice tells B that A is in the same file. The obvious next
+ * move is "ask A what they're doing" — and until now there was no way to do
+ * that. This is that way.
+ *
+ * THREE PROPERTIES THAT DEFINE THIS SURFACE
+ *
+ * 1. EPHEMERAL. TTL'd, delivered-once, no archive. Durable decisions belong in
+ *    work items and `knowledge`, which are queryable and outlive every session.
+ *    A chat log between agents is neither.
+ *
+ * 2. DELIVERED ON THE TOOL RESULT. An agent reads its messages as a side effect
+ *    of doing its work, never by remembering to poll. Same channel as the
+ *    collision notice, same noise budget: capped, deduped, and SILENT when the
+ *    inbox is empty.
+ *
+ * 3. ADDRESSED BY WHAT YOU KNOW. You rarely know who the other agent IS — you
+ *    know they are in the file you are in. `path` addressing is what makes this
+ *    feel ambient: you reply to a collision without knowing who you are talking
+ *    to.
+ *
+ * NO ENFORCEMENT. A message cannot block, gate, or refuse anything. It is
+ * information arriving at a useful moment.
+ */
+import * as z from 'zod/v4';
+import { samePath } from "./path-identity.js";
+/** Messages live this long, then they are gone. No archive, no inbox debt. */
+export const MESSAGE_TTL_MS = 30 * 60 * 1000;
+/** Cap on messages surfaced in a single tool result. */
+export const MESSAGE_DELIVERY_CAP = 3;
+export const MAX_MESSAGE_LENGTH = 500;
+/**
+ * Who a message is for.
+ *
+ * - `session` — a specific agent you already know the id of.
+ * - `path`    — whoever recently touched this file. The ambient one.
+ * - `workspace` — everyone in this workspace. Use sparingly; it is the only
+ *   addressing mode that can wake an agent who was not already involved.
+ */
+export const MessageAudienceSchema = z.discriminatedUnion('kind', [
+    z.object({ kind: z.literal('session'), sessionId: z.string().min(1) }),
+    z.object({
+        kind: z.literal('path'),
+        filePath: z.string().min(1),
+        workspaceRoot: z.string().min(1).optional()
+    }),
+    z.object({ kind: z.literal('workspace'), workspaceRoot: z.string().min(1) })
+]);
+export const AgentMessageSchema = z
+    .object({
+    id: z.string().min(1),
+    // Sender identity — enough for the recipient to reply or reach out.
+    fromSessionId: z.string().min(1),
+    fromMachineId: z.string().min(1).optional(),
+    fromMachineName: z.string().min(1).optional(),
+    fromWorkItemTitle: z.string().min(1).optional(),
+    audience: MessageAudienceSchema,
+    /**
+     * The message. Capped hard: this is delivered into another agent's
+     * context window, and an uncapped field is a way to spend someone
+     * else's budget.
+     */
+    body: z.string().min(1).max(MAX_MESSAGE_LENGTH),
+    sentAt: z.coerce.date(),
+    expiresAt: z.coerce.date()
+})
+    .strict();
+export const SendMessageInputSchema = z.object({
+    audience: MessageAudienceSchema,
+    body: z.string().min(1).max(MAX_MESSAGE_LENGTH)
+});
+/**
+ * Does this message target this recipient?
+ *
+ * Pure, and shared by every transport so local and remote cannot disagree
+ * about who a message was for.
+ */
+export function messageTargets(message, recipient, now = new Date()) {
+    // Never deliver to the sender.
+    if (message.fromSessionId === recipient.sessionId)
+        return false;
+    // Read-side expiry, same discipline as the touch stream.
+    if (message.expiresAt.getTime() <= now.getTime())
+        return false;
+    const audience = message.audience;
+    switch (audience.kind) {
+        case 'session':
+            return audience.sessionId === recipient.sessionId;
+        case 'path': {
+            // Compare CANONICAL paths: the sender addressed whatever path it
+            // saw, the recipient touched whatever path it typed, and those are
+            // routinely different spellings of one file.
+            const hit = recipient.filePaths.some((p) => samePath(p, audience.filePath, recipient.workspaceRoot ?? audience.workspaceRoot));
+            if (!hit)
+                return false;
+            // A different worktree is a different file, exactly as with
+            // collisions. Only excludes when both sides declared a workspace.
+            if (audience.workspaceRoot &&
+                recipient.workspaceRoot &&
+                audience.workspaceRoot !== recipient.workspaceRoot) {
+                return false;
+            }
+            return true;
+        }
+        case 'workspace':
+            return !!recipient.workspaceRoot && audience.workspaceRoot === recipient.workspaceRoot;
+    }
+}
+/**
+ * Render claimed messages as ONE line for a tool result.
+ *
+ * Returns null for an empty inbox — silence is the common case and must cost
+ * zero bytes.
+ */
+export function formatMessages(messages, cap = MESSAGE_DELIVERY_CAP) {
+    if (messages.length === 0)
+        return null;
+    const shown = messages.slice(0, cap);
+    const hidden = messages.length - shown.length;
+    const parts = shown.map((m) => {
+        const who = m.fromMachineName
+            ? `${m.fromSessionId.slice(0, 8)} on ${m.fromMachineName}`
+            : m.fromSessionId.slice(0, 8);
+        return `${who}: "${m.body}"`;
+    });
+    const tail = hidden > 0 ? `, and ${hidden} more` : '';
+    return `Message${shown.length === 1 ? '' : 's'} from another agent — ${parts.join(' | ')}${tail}.`;
+}
+//# sourceMappingURL=agent-message.js.map

package/dist/schemas/agent-message.js.map

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

package/dist/schemas/agent-roster.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Portable account-wide roster contracts.
+ *
+ * One row represents one live agent session, not an installed agent definition
+ * and not a file touch. Provider/model are nullable because an external harness
+ * may not report them yet; the keys remain present so consumers never have to
+ * guess whether the field was omitted accidentally.
+ */
+import * as z from 'zod/v4';
+export declare const AgentSessionAnnouncementSchema: z.ZodObject<{
+    agentId: z.ZodString;
+    providerId: z.ZodNullable<z.ZodString>;
+    modelId: z.ZodNullable<z.ZodString>;
+    sessionId: z.ZodString;
+    sessionStartedAt: z.ZodCoercedDate<unknown>;
+    observedAt: z.ZodCoercedDate<unknown>;
+    participantId: z.ZodOptional<z.ZodString>;
+    participantSlug: z.ZodOptional<z.ZodString>;
+    runtimeEnvironment: z.ZodOptional<z.ZodString>;
+    machineId: z.ZodOptional<z.ZodString>;
+    machineName: z.ZodOptional<z.ZodString>;
+    workspaceRoot: z.ZodOptional<z.ZodString>;
+    gitBranch: z.ZodOptional<z.ZodString>;
+    workItemId: z.ZodOptional<z.ZodString>;
+    workItemTitle: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type AgentSessionAnnouncement = z.infer<typeof AgentSessionAnnouncementSchema>;
+export declare const AccountAgentRosterResponseSchema: z.ZodObject<{
+    agents: z.ZodArray<z.ZodObject<{
+        agentId: z.ZodString;
+        providerId: z.ZodNullable<z.ZodString>;
+        modelId: z.ZodNullable<z.ZodString>;
+        sessionId: z.ZodString;
+        sessionStartedAt: z.ZodCoercedDate<unknown>;
+        observedAt: z.ZodCoercedDate<unknown>;
+        participantId: z.ZodOptional<z.ZodString>;
+        participantSlug: z.ZodOptional<z.ZodString>;
+        runtimeEnvironment: z.ZodOptional<z.ZodString>;
+        machineId: z.ZodOptional<z.ZodString>;
+        machineName: z.ZodOptional<z.ZodString>;
+        workspaceRoot: z.ZodOptional<z.ZodString>;
+        gitBranch: z.ZodOptional<z.ZodString>;
+        workItemId: z.ZodOptional<z.ZodString>;
+        workItemTitle: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type AccountAgentRosterResponse = z.infer<typeof AccountAgentRosterResponseSchema>;
+/** Exact cross-provider wire keys; used by privacy/contract tests. */
+export declare const AGENT_SESSION_ANNOUNCEMENT_KEYS: readonly ["agentId", "providerId", "modelId", "sessionId", "sessionStartedAt", "observedAt", "participantId", "participantSlug", "runtimeEnvironment", "machineId", "machineName", "workspaceRoot", "gitBranch", "workItemId", "workItemTitle"];
+//# sourceMappingURL=agent-roster.d.ts.map

package/dist/schemas/agent-roster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-roster.d.ts","sourceRoot":"","sources":["../../src/schemas/agent-roster.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;kBAkBjC,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;kBAInC,CAAC;AAEX,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F,sEAAsE;AACtE,eAAO,MAAM,+BAA+B,iPAgBlC,CAAC"}

package/dist/schemas/agent-roster.js

@@ -0,0 +1,52 @@
+/**
+ * Portable account-wide roster contracts.
+ *
+ * One row represents one live agent session, not an installed agent definition
+ * and not a file touch. Provider/model are nullable because an external harness
+ * may not report them yet; the keys remain present so consumers never have to
+ * guess whether the field was omitted accidentally.
+ */
+import * as z from 'zod/v4';
+export const AgentSessionAnnouncementSchema = z
+    .object({
+    agentId: z.string().trim().min(1).max(200),
+    providerId: z.string().trim().min(1).max(200).nullable(),
+    modelId: z.string().trim().min(1).max(300).nullable(),
+    sessionId: z.string().trim().min(1).max(200),
+    sessionStartedAt: z.coerce.date(),
+    observedAt: z.coerce.date(),
+    participantId: z.string().trim().min(1).max(200).optional(),
+    participantSlug: z.string().trim().min(1).max(100).optional(),
+    runtimeEnvironment: z.string().trim().min(1).max(200).optional(),
+    machineId: z.string().trim().min(1).max(200).optional(),
+    machineName: z.string().trim().min(1).max(200).optional(),
+    workspaceRoot: z.string().trim().min(1).max(1024).optional(),
+    gitBranch: z.string().trim().min(1).max(300).optional(),
+    workItemId: z.string().trim().min(1).max(200).optional(),
+    workItemTitle: z.string().trim().min(1).max(300).optional()
+})
+    .strict();
+export const AccountAgentRosterResponseSchema = z
+    .object({
+    agents: z.array(AgentSessionAnnouncementSchema)
+})
+    .strict();
+/** Exact cross-provider wire keys; used by privacy/contract tests. */
+export const AGENT_SESSION_ANNOUNCEMENT_KEYS = [
+    'agentId',
+    'providerId',
+    'modelId',
+    'sessionId',
+    'sessionStartedAt',
+    'observedAt',
+    'participantId',
+    'participantSlug',
+    'runtimeEnvironment',
+    'machineId',
+    'machineName',
+    'workspaceRoot',
+    'gitBranch',
+    'workItemId',
+    'workItemTitle'
+];
+//# sourceMappingURL=agent-roster.js.map

package/dist/schemas/agent-roster.js.map

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

package/dist/schemas/collision.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Ambient collision schemas.
+ *
+ * A "collision" is the intersection that justifies telling an agent about
+ * another agent: the SAME file, in the SAME workspace, touched by a DIFFERENT
+ * live session, inside the recency window.
+ *
+ * The noise budget lives here, in the schema layer, deliberately. It is a
+ * property of what a collision IS — not a presentation choice a formatter is
+ * free to reinterpret. See docs/architecture/AMBIENT-AGENT-AWARENESS.md.
+ */
+import * as z from 'zod/v4';
+/**
+ * Default recency window: a touch older than this is invisible to the
+ * collision read even if the row is still on disk.
+ *
+ * Expiry is READ-SIDE on purpose. Nothing here depends on a sweep job running,
+ * so a machine that never runs one still reports honest, current information.
+ */
+export declare const DEFAULT_RECENCY_WINDOW_MS: number;
+/** Default cap on peers named in a single notice before eliding the rest. */
+export declare const DEFAULT_PEER_CAP = 3;
+/**
+ * Another session's recent touch of a path this session is now touching.
+ */
+export declare const TouchPeerSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    machineId: z.ZodOptional<z.ZodString>;
+    machineName: z.ZodOptional<z.ZodString>;
+    participantId: z.ZodOptional<z.ZodString>;
+    participantSlug: z.ZodOptional<z.ZodString>;
+    workspaceRoot: z.ZodOptional<z.ZodString>;
+    gitBranch: z.ZodOptional<z.ZodString>;
+    workItemId: z.ZodOptional<z.ZodString>;
+    workItemTitle: z.ZodOptional<z.ZodString>;
+    operation: z.ZodEnum<{
+        read: "read";
+        write: "write";
+        delete: "delete";
+        edit: "edit";
+    }>;
+    filePath: z.ZodString;
+    timestamp: z.ZodCoercedDate<unknown>;
+    ageMs: z.ZodNumber;
+    origin: z.ZodDefault<z.ZodEnum<{
+        local: "local";
+        remote: "remote";
+    }>>;
+}, z.core.$strip>;
+export type TouchPeer = z.infer<typeof TouchPeerSchema>;
+/**
+ * Query for "who else touched this path recently".
+ */
+export declare const WhoElseTouchedInputSchema: z.ZodObject<{
+    filePath: z.ZodString;
+    workspaceRoot: z.ZodOptional<z.ZodString>;
+    excludeSessionId: z.ZodString;
+    since: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type WhoElseTouchedInput = z.input<typeof WhoElseTouchedInputSchema>;
+/**
+ * Context handed to a `external/collision-filter` implementation.
+ */
+export interface CollisionFilterContext {
+    /** The querying session id. */
+    sessionId: string;
+    /** The querying session's workspace root, when known. */
+    workspaceRoot?: string;
+    /** Oldest touch considered live. */
+    since: Date;
+    /** Evaluation time, injected so filters are testable and deterministic. */
+    now: Date;
+}
+/**
+ * Runtime kind `external/collision-filter`.
+ *
+ * Decides which candidate touches are worth telling the agent about. Swap this
+ * to widen to directory-level, narrow to same-symbol, or apply a house policy —
+ * without forking the touch stream.
+ *
+ * A filter may only REMOVE or REORDER candidates. It must not fabricate a peer,
+ * and it must not be the thing that makes a solo agent noisy.
+ */
+export interface CollisionFilterImplementation {
+    filter(candidates: TouchPeer[], context: CollisionFilterContext): TouchPeer[];
+}
+/** A resolved value is a collision filter when it carries the filter entrypoint. */
+export declare const CollisionFilterSchema: z.ZodCustom<CollisionFilterImplementation, CollisionFilterImplementation>;
+/**
+ * Runtime kind `external/notice-formatter`.
+ *
+ * Renders the peers into the single line appended to a tool result. Returning
+ * `null` means "say nothing" and MUST be honored — silence is a valid render.
+ */
+export interface NoticeFormatterImplementation {
+    format(peers: TouchPeer[], context: NoticeFormatterContext): string | null;
+}
+/** A resolved value is a notice formatter when it carries the format entrypoint. */
+export declare const NoticeFormatterSchema: z.ZodCustom<NoticeFormatterImplementation, NoticeFormatterImplementation>;
+export interface NoticeFormatterContext {
+    /** The path that triggered the notice. */
+    filePath: string;
+    /** Max peers to name before eliding into "and N others". */
+    cap: number;
+    /** Evaluation time. */
+    now: Date;
+}
+//# sourceMappingURL=collision.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collision.d.ts","sourceRoot":"","sources":["../../src/schemas/collision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,QAAiB,CAAC;AAExD,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;iBAoB1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;iBAepC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,KAAK,EAAE,IAAI,CAAC;IACZ,2EAA2E;IAC3E,GAAG,EAAE,IAAI,CAAC;CACV;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,6BAA6B;IAC7C,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,sBAAsB,GAAG,SAAS,EAAE,CAAC;CAC9E;AAED,oFAAoF;AACpF,eAAO,MAAM,qBAAqB,2EAEjC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,6BAA6B;IAC7C,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,sBAAsB,GAAG,MAAM,GAAG,IAAI,CAAC;CAC3E;AAED,oFAAoF;AACpF,eAAO,MAAM,qBAAqB,2EAEjC,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACtC,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAC;IACZ,uBAAuB;IACvB,GAAG,EAAE,IAAI,CAAC;CACV"}

package/dist/schemas/collision.js

@@ -0,0 +1,71 @@
+/**
+ * Ambient collision schemas.
+ *
+ * A "collision" is the intersection that justifies telling an agent about
+ * another agent: the SAME file, in the SAME workspace, touched by a DIFFERENT
+ * live session, inside the recency window.
+ *
+ * The noise budget lives here, in the schema layer, deliberately. It is a
+ * property of what a collision IS — not a presentation choice a formatter is
+ * free to reinterpret. See docs/architecture/AMBIENT-AGENT-AWARENESS.md.
+ */
+import * as z from 'zod/v4';
+import { FileOperationSchema } from "../storage/file-access.record.descriptor.js";
+/**
+ * Default recency window: a touch older than this is invisible to the
+ * collision read even if the row is still on disk.
+ *
+ * Expiry is READ-SIDE on purpose. Nothing here depends on a sweep job running,
+ * so a machine that never runs one still reports honest, current information.
+ */
+export const DEFAULT_RECENCY_WINDOW_MS = 30 * 60 * 1000; // 30 minutes
+/** Default cap on peers named in a single notice before eliding the rest. */
+export const DEFAULT_PEER_CAP = 3;
+/**
+ * Another session's recent touch of a path this session is now touching.
+ */
+export const TouchPeerSchema = z.object({
+    sessionId: z.string().min(1),
+    machineId: z.string().min(1).optional(),
+    machineName: z.string().min(1).optional(),
+    participantId: z.string().min(1).optional(),
+    participantSlug: z.string().min(1).optional(),
+    workspaceRoot: z.string().min(1).optional(),
+    gitBranch: z.string().min(1).optional(),
+    workItemId: z.string().min(1).optional(),
+    workItemTitle: z.string().min(1).optional(),
+    operation: FileOperationSchema,
+    filePath: z.string().min(1),
+    timestamp: z.coerce.date(),
+    /** Age at read time, so a formatter never has to know "now". */
+    ageMs: z.number().int().nonnegative(),
+    /**
+     * Where this peer was observed. `remote` rows arrive from the cloud
+     * projection (M3) and are merged with local rows by the same filter.
+     */
+    origin: z.enum(['local', 'remote']).default('local')
+});
+/**
+ * Query for "who else touched this path recently".
+ */
+export const WhoElseTouchedInputSchema = z.object({
+    filePath: z.string().min(1),
+    /**
+     * The querying session's workspace root. When present, peers in a
+     * DIFFERENT workspace are excluded: two worktrees of one repo share a path
+     * but are not colliding. When absent, workspace cannot be compared and is
+     * not used to exclude — a degraded read stays useful.
+     */
+    workspaceRoot: z.string().min(1).optional(),
+    /** The querying session, always excluded from its own results. */
+    excludeSessionId: z.string().min(1),
+    /** Oldest touch considered live. Defaults to now - DEFAULT_RECENCY_WINDOW_MS. */
+    since: z.coerce.date().optional(),
+    /** Max peers returned (distinct sessions), post-filter. */
+    limit: z.number().int().positive().max(50).default(DEFAULT_PEER_CAP)
+});
+/** A resolved value is a collision filter when it carries the filter entrypoint. */
+export const CollisionFilterSchema = z.custom((value) => value instanceof Object && 'filter' in value && Object(value).filter instanceof Function);
+/** A resolved value is a notice formatter when it carries the format entrypoint. */
+export const NoticeFormatterSchema = z.custom((value) => value instanceof Object && 'format' in value && Object(value).format instanceof Function);
+//# sourceMappingURL=collision.js.map

package/dist/schemas/collision.js.map

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