@agenticprimitives/collaboration 0.0.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Agentic Trust Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,7 @@
+# @agenticprimitives/collaboration
+
+The portable core of a governed collaboration activity — the **huddle** of spec 378: a call that belongs to a
+Home context, whose admission is decided by the standing the substrate already derives, and whose media a
+provider carries. This package holds the contracts (`HuddleScopeV1`, `HuddleRunV1`, `HuddleParticipantV1`,
+`HuddleEventV1`), the lifecycle reducer, the admission rules as pure functions, and the `MediaProviderPort`
+a provider adapter implements. It knows no provider SDK, no UI, no secrets.

package/dist/huddle.d.ts

@@ -0,0 +1,166 @@
+import type { Address } from '@agenticprimitives/types';
+/** WHERE a huddle belongs. The principal is the agent whose activity it is (a person for a conversation,
+ *  the organization / team / workspace otherwise); `id` narrows within that agent — a conversation id, or
+ *  a DISCUSSION TOPIC's id (`topic`): each topic of each team is its own room, judged by standing at that
+ *  team, so two teams never see each other's huddle and a team's members meet where they already talk. */
+export interface HuddleScopeV1 {
+    kind: 'conversation' | 'topic' | 'org' | 'team' | 'workspace';
+    principal: Address;
+    id?: string;
+}
+/** The scope's stable key — one serving-plane object per key (spec 378 §3). */
+export declare function scopeKey(scope: HuddleScopeV1): string;
+export type HuddleState = 'creating' | 'active' | 'ending' | 'ended';
+export type HuddleRole = 'host' | 'participant';
+export interface HuddleParticipantV1 {
+    /** The human (or service) actually taking part — the authenticated actor. */
+    actor: Address;
+    /** The principal they represent in this huddle, when not themselves. Frozen for the life of the join. */
+    represented?: Address;
+    role: HuddleRole;
+    /** WHY they were admitted: the standing the substrate derived, or an invitation on this run. */
+    admission: {
+        ground: 'steward' | 'member' | 'party' | 'invitation' | 'starter';
+        ref?: string;
+        at: number;
+    };
+    joinedAt?: number;
+    leftAt?: number;
+    removedAt?: number;
+    /** The provider's participant id — a binding for revocation, never an identity. */
+    providerParticipantId?: string;
+}
+export interface HuddleInvitationV1 {
+    invitee: Address;
+    by: Address;
+    at: number;
+    expiresAt: number;
+    /** An invitee with no standing at the scope is an OUTSIDER: admission waits on a steward's approval. */
+    outsider: boolean;
+    approvedBy?: Address;
+}
+export interface HuddleRunV1 {
+    runId: string;
+    scope: HuddleScopeV1;
+    state: HuddleState;
+    startedBy: Address;
+    startedAt: number;
+    endedAt?: number;
+    endedBy?: Address;
+    /** The provider binding — a meeting id, never a credential. A NEW meeting per run (spec 378 §3). */
+    provider?: {
+        kind: 'realtimekit';
+        meetingId: string;
+        deactivatedAt?: number;
+        kickedAt?: number;
+    };
+    participants: HuddleParticipantV1[];
+    invitations: HuddleInvitationV1[];
+    /** The policy revision admission was last judged under — a reference, never a cached verdict. */
+    policyVersion: string;
+    maxDurationMs: number;
+    /** When the room became empty; the object ends the run after the empty-room grace. */
+    emptySince?: number;
+    /** Idempotency: the keys of operations already applied, so a retry is a no-op. */
+    applied: string[];
+}
+export type HuddleEventV1 = {
+    type: 'started';
+    runId: string;
+    scope: HuddleScopeV1;
+    by: Address;
+    at: number;
+    policyVersion: string;
+    maxDurationMs: number;
+    key: string;
+} | {
+    type: 'provider-bound';
+    meetingId: string;
+    at: number;
+    key: string;
+} | {
+    type: 'admitted';
+    participant: Omit<HuddleParticipantV1, 'joinedAt' | 'leftAt' | 'removedAt'>;
+    at: number;
+    key: string;
+} | {
+    type: 'joined';
+    actor: Address;
+    providerParticipantId?: string;
+    at: number;
+    key: string;
+} | {
+    type: 'left';
+    actor: Address;
+    at: number;
+    key: string;
+} | {
+    type: 'removed';
+    actor: Address;
+    by: Address;
+    at: number;
+    key: string;
+} | {
+    type: 'invited';
+    invitation: HuddleInvitationV1;
+    key: string;
+} | {
+    type: 'invitation-approved';
+    invitee: Address;
+    by: Address;
+    at: number;
+    key: string;
+} | {
+    type: 'ending';
+    by: Address;
+    at: number;
+    key: string;
+} | {
+    type: 'provider-deactivated';
+    at: number;
+    key: string;
+} | {
+    type: 'provider-kicked';
+    at: number;
+    key: string;
+} | {
+    type: 'ended';
+    at: number;
+    key: string;
+};
+export type ReduceResult = {
+    ok: true;
+    run: HuddleRunV1;
+} | {
+    ok: false;
+    reason: string;
+};
+/** Apply one event. Illegal transitions are refused, never coerced; a key already applied is a no-op. */
+export declare function applyHuddleEvent(run: HuddleRunV1 | null, e: HuddleEventV1): ReduceResult;
+export type ScopeStanding = 'steward' | 'member' | 'party' | 'none';
+export type HuddleOp = 'start' | 'join' | 'invite' | 'leave' | 'end' | 'removeParticipant' | 'get';
+export type Admission = {
+    ok: true;
+    ground: HuddleParticipantV1['admission']['ground'];
+    ref?: string;
+} | {
+    ok: false;
+    reason: string;
+    parks?: true;
+};
+export declare function admissionFor(op: HuddleOp, input: {
+    run: HuddleRunV1 | null;
+    actor: Address;
+    standing: ScopeStanding;
+    now: number;
+}): Admission;
+/** The room as a listing shows it — who is in it now, never the provider binding's secrets (there are none) and never a credential. */
+export declare function roster(run: HuddleRunV1): Array<{
+    actor: Address;
+    represented?: Address;
+    role: HuddleRole;
+    joined: boolean;
+}>;
+/** Deadlines the serving-plane object arms: the max duration from the start, and the empty-room grace. */
+export declare function nextDeadline(run: HuddleRunV1, emptyGraceMs: number): number | null;
+//# sourceMappingURL=huddle.d.ts.map

package/dist/huddle.d.ts.map

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

package/dist/huddle.js

@@ -0,0 +1,145 @@
+/** The scope's stable key — one serving-plane object per key (spec 378 §3). */
+export function scopeKey(scope) {
+    return `${scope.kind}:${scope.principal.toLowerCase()}${scope.id ? `:${scope.id}` : ''}`;
+}
+const lc = (a) => a.toLowerCase();
+/** Apply one event. Illegal transitions are refused, never coerced; a key already applied is a no-op. */
+export function applyHuddleEvent(run, e) {
+    if (run && run.applied.includes(e.key))
+        return { ok: true, run };
+    const stamp = (r) => ({ ...r, applied: [...r.applied, e.key].slice(-200) });
+    if (e.type === 'started') {
+        if (run && run.state !== 'ended')
+            return { ok: false, reason: `a huddle is already ${run.state} in this scope` };
+        return { ok: true, run: stamp({ runId: e.runId, scope: e.scope, state: 'creating', startedBy: lc(e.by), startedAt: e.at, participants: [], invitations: [], policyVersion: e.policyVersion, maxDurationMs: e.maxDurationMs, applied: [] }) };
+    }
+    if (!run)
+        return { ok: false, reason: 'no huddle in this scope' };
+    switch (e.type) {
+        case 'provider-bound':
+            if (run.state !== 'creating')
+                return { ok: false, reason: `cannot bind a provider to a run that is ${run.state}` };
+            return { ok: true, run: stamp({ ...run, state: 'active', provider: { kind: 'realtimekit', meetingId: e.meetingId } }) };
+        case 'admitted': {
+            if (run.state !== 'active')
+                return { ok: false, reason: `the huddle is ${run.state} — no admission` };
+            const actor = lc(e.participant.actor);
+            const others = run.participants.filter((p) => lc(p.actor) !== actor);
+            return { ok: true, run: stamp({ ...run, participants: [...others, { ...e.participant, actor }], emptySince: undefined }) };
+        }
+        case 'joined': {
+            if (run.state !== 'active')
+                return { ok: false, reason: `the huddle is ${run.state} — cannot join` };
+            const actor = lc(e.actor);
+            const p = run.participants.find((x) => lc(x.actor) === actor && !x.removedAt);
+            if (!p)
+                return { ok: false, reason: 'joined without admission' };
+            return { ok: true, run: stamp({ ...run, emptySince: undefined, participants: run.participants.map((x) => (x === p ? { ...x, joinedAt: e.at, leftAt: undefined, ...(e.providerParticipantId ? { providerParticipantId: e.providerParticipantId } : {}) } : x)) }) };
+        }
+        case 'left': {
+            const actor = lc(e.actor);
+            const next = run.participants.map((x) => (lc(x.actor) === actor && x.joinedAt && !x.leftAt ? { ...x, leftAt: e.at } : x));
+            const anyone = next.some((x) => x.joinedAt && !x.leftAt && !x.removedAt);
+            return { ok: true, run: stamp({ ...run, participants: next, ...(anyone ? {} : { emptySince: e.at }) }) };
+        }
+        case 'removed': {
+            const actor = lc(e.actor);
+            const next = run.participants.map((x) => (lc(x.actor) === actor && !x.removedAt ? { ...x, removedAt: e.at, leftAt: x.leftAt ?? e.at } : x));
+            const anyone = next.some((x) => x.joinedAt && !x.leftAt && !x.removedAt);
+            return { ok: true, run: stamp({ ...run, participants: next, ...(anyone ? {} : { emptySince: e.at }) }) };
+        }
+        case 'invited': {
+            if (run.state !== 'active')
+                return { ok: false, reason: `the huddle is ${run.state} — no invitations` };
+            const invitee = lc(e.invitation.invitee);
+            const others = run.invitations.filter((i) => lc(i.invitee) !== invitee);
+            return { ok: true, run: stamp({ ...run, invitations: [...others, { ...e.invitation, invitee }] }) };
+        }
+        case 'invitation-approved': {
+            const invitee = lc(e.invitee);
+            if (!run.invitations.some((i) => lc(i.invitee) === invitee))
+                return { ok: false, reason: 'no such invitation' };
+            return { ok: true, run: stamp({ ...run, invitations: run.invitations.map((i) => (lc(i.invitee) === invitee ? { ...i, approvedBy: lc(e.by) } : i)) }) };
+        }
+        case 'ending':
+            if (run.state === 'ended')
+                return { ok: false, reason: 'already ended' };
+            return { ok: true, run: stamp({ ...run, state: 'ending', endedBy: lc(e.by) }) };
+        case 'provider-deactivated':
+            return { ok: true, run: stamp({ ...run, provider: run.provider ? { ...run.provider, deactivatedAt: e.at } : run.provider }) };
+        case 'provider-kicked':
+            return { ok: true, run: stamp({ ...run, provider: run.provider ? { ...run.provider, kickedAt: e.at } : run.provider }) };
+        case 'ended':
+            return { ok: true, run: stamp({ ...run, state: 'ended', endedAt: e.at, participants: run.participants.map((x) => (x.joinedAt && !x.leftAt ? { ...x, leftAt: e.at } : x)) }) };
+        default:
+            return { ok: false, reason: 'unknown event' };
+    }
+}
+export function admissionFor(op, input) {
+    const { run, actor, standing, now } = input;
+    const a = lc(actor);
+    const me = run?.participants.find((p) => lc(p.actor) === a && !p.removedAt);
+    const removed = run?.participants.find((p) => lc(p.actor) === a && p.removedAt);
+    const standingGround = standing === 'steward' ? 'steward' : standing === 'member' ? 'member' : standing === 'party' ? 'party' : null;
+    switch (op) {
+        case 'start':
+            if (standingGround)
+                return { ok: true, ground: 'starter' };
+            return { ok: false, reason: 'only someone who belongs to this scope can start a huddle in it' };
+        case 'get':
+            if (standingGround)
+                return { ok: true, ground: standingGround };
+            return { ok: false, reason: 'nothing here' };
+        case 'join': {
+            if (!run || run.state !== 'active')
+                return { ok: false, reason: 'there is no active huddle here' };
+            if (removed && !me)
+                return { ok: false, reason: 'you were removed from this huddle' };
+            if (standingGround)
+                return { ok: true, ground: standingGround };
+            const inv = run.invitations.find((i) => lc(i.invitee) === a);
+            if (!inv)
+                return { ok: false, reason: 'this huddle is not one you belong to, and no invitation names you' };
+            if (inv.expiresAt <= now)
+                return { ok: false, reason: 'your invitation has expired' };
+            if (inv.outsider && !inv.approvedBy)
+                return { ok: false, reason: 'your invitation is waiting on a steward’s approval', parks: true };
+            return { ok: true, ground: 'invitation', ref: `${inv.by}:${inv.at}` };
+        }
+        case 'invite':
+            if (!run || run.state !== 'active')
+                return { ok: false, reason: 'there is no active huddle to invite to' };
+            if (!me?.joinedAt || me.leftAt)
+                return { ok: false, reason: 'only someone in the huddle can invite to it' };
+            return { ok: true, ground: me.admission.ground };
+        case 'leave':
+            if (!me?.joinedAt || me.leftAt)
+                return { ok: false, reason: 'you are not in this huddle' };
+            return { ok: true, ground: me.admission.ground };
+        case 'end':
+            if (!run || run.state === 'ended')
+                return { ok: false, reason: 'there is no huddle to end' };
+            if (standing === 'steward' || lc(run.startedBy) === a)
+                return { ok: true, ground: standing === 'steward' ? 'steward' : 'starter' };
+            return { ok: false, reason: 'only the person who started it, or a steward of this scope, can end a huddle for everyone' };
+        case 'removeParticipant':
+            if (!run || run.state !== 'active')
+                return { ok: false, reason: 'there is no active huddle' };
+            if (standing === 'steward' || lc(run.startedBy) === a)
+                return { ok: true, ground: standing === 'steward' ? 'steward' : 'starter' };
+            return { ok: false, reason: 'only a steward of this scope, or the person who started it, can remove someone' };
+    }
+}
+/** The room as a listing shows it — who is in it now, never the provider binding's secrets (there are none) and never a credential. */
+export function roster(run) {
+    return run.participants.filter((p) => !p.removedAt).map((p) => ({ actor: p.actor, ...(p.represented ? { represented: p.represented } : {}), role: p.role, joined: !!p.joinedAt && !p.leftAt }));
+}
+/** Deadlines the serving-plane object arms: the max duration from the start, and the empty-room grace. */
+export function nextDeadline(run, emptyGraceMs) {
+    if (run.state === 'ended')
+        return null;
+    const max = run.startedAt + run.maxDurationMs;
+    const empty = run.emptySince !== undefined ? run.emptySince + emptyGraceMs : null;
+    return empty !== null ? Math.min(max, empty) : max;
+}
+//# sourceMappingURL=huddle.js.map

package/dist/huddle.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export declare const PACKAGE_NAME = "@agenticprimitives/collaboration";
+export declare const PACKAGE_STATUS = "w1-huddles";
+export declare const SPEC_REF = "specs/378-huddles-governed-calls-in-home.md";
+export { scopeKey, applyHuddleEvent, admissionFor, roster, nextDeadline } from './huddle.js';
+export type { HuddleScopeV1, HuddleState, HuddleRole, HuddleParticipantV1, HuddleInvitationV1, HuddleRunV1, HuddleEventV1, ReduceResult, ScopeStanding, HuddleOp, Admission } from './huddle.js';
+export type { ProviderMeeting, ProviderParticipant, MediaProviderPort, ProviderWebhookEvent } from './media-provider.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,qCAAqC,CAAC;AAC/D,eAAO,MAAM,cAAc,eAAe,CAAC;AAC3C,eAAO,MAAM,QAAQ,gDAAgD,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC7F,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACjM,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export const PACKAGE_NAME = '@agenticprimitives/collaboration';
+export const PACKAGE_STATUS = 'w1-huddles';
+export const SPEC_REF = 'specs/378-huddles-governed-calls-in-home.md';
+export { scopeKey, applyHuddleEvent, admissionFor, roster, nextDeadline } from './huddle.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,kCAAkC,CAAC;AAC/D,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC;AAC3C,MAAM,CAAC,MAAM,QAAQ,GAAG,6CAA6C,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/media-provider.d.ts

@@ -0,0 +1,42 @@
+export interface ProviderMeeting {
+    meetingId: string;
+}
+export interface ProviderParticipant {
+    participantId: string;
+    /** The credential the browser SDK joins with. Returned ONCE to the participating browser; never stored,
+     *  never logged, never placed where a model could read it (spec 378 §0.2). */
+    authToken: string;
+}
+export interface MediaProviderPort {
+    createMeeting(input: {
+        title: string;
+        scopeKey: string;
+        runId: string;
+    }): Promise<ProviderMeeting>;
+    addParticipant(input: {
+        meetingId: string;
+        displayName: string;
+        role: 'host' | 'participant';
+        correlationId: string;
+    }): Promise<ProviderParticipant>;
+    removeParticipant(input: {
+        meetingId: string;
+        participantId: string;
+    }): Promise<void>;
+    endSession(input: {
+        meetingId: string;
+    }): Promise<void>;
+    deactivateMeeting(input: {
+        meetingId: string;
+    }): Promise<void>;
+}
+/** A provider webhook, verified by the adapter before it reaches the object: the event, the meeting, and
+ *  the participant's correlation id when the event names one. */
+export interface ProviderWebhookEvent {
+    event: 'meeting.started' | 'meeting.ended' | 'meeting.participantJoined' | 'meeting.participantLeft' | string;
+    meetingId: string;
+    participantId?: string;
+    correlationId?: string;
+    at: number;
+}
+//# sourceMappingURL=media-provider.d.ts.map

package/dist/media-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-provider.d.ts","sourceRoot":"","sources":["../src/media-provider.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,eAAe;IAAG,SAAS,EAAE,MAAM,CAAA;CAAE;AAEtD,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB;kFAC8E;IAC9E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACnG,cAAc,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACrJ,iBAAiB,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtF,UAAU,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,iBAAiB,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE;AAED;iEACiE;AACjE,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,iBAAiB,GAAG,eAAe,GAAG,2BAA2B,GAAG,yBAAyB,GAAG,MAAM,CAAC;IAC9G,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;CACZ"}

package/dist/media-provider.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=media-provider.js.map

package/dist/media-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-provider.js","sourceRoot":"","sources":["../src/media-provider.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@agenticprimitives/collaboration",
+  "version": "0.0.0-alpha.1",
+  "description": "Governed collaboration activities (spec 378 huddles): scope, run, participant and lifecycle contracts, admission rules as pure functions, and the media-provider port. No provider SDK, no UI.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "LICENSE",
+    "dist",
+    "spec.md",
+    "README.md"
+  ],
+  "devDependencies": {
+    "vitest": "^4.1.8"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agentictrustlabs/agenticprimitives.git",
+    "directory": "packages/collaboration"
+  },
+  "license": "MIT",
+  "keywords": [
+    "agentic",
+    "primitives",
+    "collaboration",
+    "huddle",
+    "realtime"
+  ],
+  "dependencies": {
+    "@agenticprimitives/types": "1.0.0-alpha.22"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:unit": "vitest run test/unit --passWithNoTests",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  }
+}

package/spec.md

@@ -0,0 +1,4 @@
+# @agenticprimitives/collaboration — spec pointer
+
+The architect-of-record is [spec 378 — Huddles: a governed call inside a Home context](../../specs/378-huddles-governed-calls-in-home.md).
+This package is its portable core: contracts, the lifecycle reducer, admission rules, the media-provider port.