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

package/dist/storage/session-messages.record.descriptor.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Session Messages Storage Record Descriptor
+ *
+ * Multi-participant communication for sessions.
+ *
+ * @example
+ * ```typescript
+ * const messages = await runtime
+ *   .query('storage/record')
+ *   .withId('session.messages')
+ *   .resolve();
+ *
+ * const message = await messages.create({
+ *   sessionId: 'session-123',
+ *   fromParticipant: 'participant-456',
+ *   messageType: 'info',
+ *   content: 'Task completed successfully'
+ * });
+ * ```
+ */
+import * as z from 'zod/v4';
+import type { StorageRecordDescriptorInput } from '@vibesdotdev/storage/schemas/record';
+import type { RecordDraft } from './record-draft.ts';
+export declare const MessageRecordSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    sessionId: z.ZodUUID;
+    fromParticipant: z.ZodString;
+    toParticipant: z.ZodOptional<z.ZodString>;
+    content: z.ZodString;
+    attachments: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            file: "file";
+            knowledge: "knowledge";
+            job: "job";
+            todo: "todo";
+            scratchpad: "scratchpad";
+        }>;
+        id: z.ZodUUID;
+        metadata: z.ZodOptional<z.ZodObject<{
+            displayName: z.ZodOptional<z.ZodString>;
+            fileSize: z.ZodOptional<z.ZodNumber>;
+            mimeType: z.ZodOptional<z.ZodString>;
+            preview: z.ZodOptional<z.ZodString>;
+            custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$loose>>;
+    }, z.core.$strip>>>;
+    metadata: z.ZodDefault<z.ZodObject<{
+        priority: z.ZodOptional<z.ZodEnum<{
+            low: "low";
+            high: "high";
+            normal: "normal";
+            urgent: "urgent";
+        }>>;
+        threadId: z.ZodOptional<z.ZodUUID>;
+        replyToId: z.ZodOptional<z.ZodUUID>;
+        requiresAck: z.ZodOptional<z.ZodBoolean>;
+        todoId: z.ZodOptional<z.ZodUUID>;
+        jobId: z.ZodOptional<z.ZodString>;
+        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>;
+    isRead: z.ZodDefault<z.ZodBoolean>;
+    messageType: z.ZodDefault<z.ZodEnum<{
+        request: "request";
+        info: "info";
+        transfer: "transfer";
+        question: "question";
+        answer: "answer";
+    }>>;
+    createdAt: z.ZodUnion<readonly [z.ZodPipe<z.ZodISODateTime, z.ZodTransform<string, string>>, z.ZodDate]>;
+    readAt: z.ZodNullable<z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodISODateTime, z.ZodTransform<string, string>>, z.ZodDate]>>>;
+}, z.core.$strip>;
+export type MessageRecord = z.infer<typeof MessageRecordSchema>;
+/** The record's `beforeCreate` hook: fills defaults and stamps in place. */
+export declare function messageBeforeCreate(message: RecordDraft<typeof MessageRecordSchema>): void;
+/** The record's `beforeUpdate` hook: fills defaults and stamps in place. */
+export declare function messageBeforeUpdate(message: RecordDraft<typeof MessageRecordSchema>): void;
+export declare const sessionMessagesRecordDescriptor: StorageRecordDescriptorInput;
+export default sessionMessagesRecordDescriptor;
+//# sourceMappingURL=session-messages.record.descriptor.d.ts.map

package/dist/storage/session-messages.record.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-messages.record.descriptor.d.ts","sourceRoot":"","sources":["../../src/storage/session-messages.record.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AACxF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAarD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAK9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,mBAAmB,CAAC,GAAG,IAAI,CAM1F;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,mBAAmB,CAAC,GAAG,IAAI,CAI1F;AAED,eAAO,MAAM,+BAA+B,EAAE,4BA2F7C,CAAC;AAEF,eAAe,+BAA+B,CAAC"}

package/dist/storage/session-messages.record.descriptor.js

@@ -0,0 +1,142 @@
+/**
+ * Session Messages Storage Record Descriptor
+ *
+ * Multi-participant communication for sessions.
+ *
+ * @example
+ * ```typescript
+ * const messages = await runtime
+ *   .query('storage/record')
+ *   .withId('session.messages')
+ *   .resolve();
+ *
+ * const message = await messages.create({
+ *   sessionId: 'session-123',
+ *   fromParticipant: 'participant-456',
+ *   messageType: 'info',
+ *   content: 'Task completed successfully'
+ * });
+ * ```
+ */
+import * as z from 'zod/v4';
+import { MessageTypeSchema, ParticipantMessageSchema } from "../schemas/chatter.js";
+/**
+ * An ISO-8601 instant with any UTC offset, normalized to UTC `Z` at the record
+ * boundary. A row written outside the record API can carry `+00:00`; it must
+ * not fail validation for every update that touches its inbox.
+ */
+const RecordInstantSchema = z.union([
+    z.iso.datetime({ offset: true }).transform((value) => new Date(value).toISOString()),
+    z.date()
+]);
+export const MessageRecordSchema = ParticipantMessageSchema.extend({
+    // `beforeCreate`'s default, applied to rows written outside the record API.
+    messageType: MessageTypeSchema.default('info'),
+    createdAt: RecordInstantSchema,
+    readAt: RecordInstantSchema.optional().nullable()
+});
+/** The record's `beforeCreate` hook: fills defaults and stamps in place. */
+export function messageBeforeCreate(message) {
+    if (!message.messageType)
+        message.messageType = 'info';
+    if (!message.attachments)
+        message.attachments = [];
+    if (!message.metadata)
+        message.metadata = {};
+    if (message.isRead === undefined)
+        message.isRead = false;
+    if (!message.createdAt)
+        message.createdAt = new Date().toISOString();
+}
+/** The record's `beforeUpdate` hook: fills defaults and stamps in place. */
+export function messageBeforeUpdate(message) {
+    if (message.isRead === true && !message.readAt) {
+        message.readAt = new Date().toISOString();
+    }
+}
+export const sessionMessagesRecordDescriptor = {
+    kind: 'storage/record',
+    id: 'session.messages',
+    name: 'Session Messages',
+    description: 'Multi-participant communication for sessions',
+    schema: MessageRecordSchema,
+    tableName: 'participant_messages',
+    primaryKey: 'id',
+    relations: {
+        session: {
+            type: 'belongs_to',
+            target: 'session.sessions',
+            foreignKey: 'sessionId',
+            optional: false,
+            cascadeDelete: true
+        }
+    },
+    indexes: [
+        { name: 'idx_messages_session', fields: ['sessionId'], unique: false },
+        { name: 'idx_messages_from', fields: ['fromParticipant'], unique: false },
+        { name: 'idx_messages_to', fields: ['toParticipant'], unique: false, where: 'toParticipant IS NOT NULL' },
+        { name: 'idx_messages_unread', fields: ['sessionId', 'toParticipant', 'isRead'], unique: false },
+        { name: 'idx_messages_created', fields: ['createdAt'], unique: false }
+    ],
+    migrations: [
+        {
+            version: 1,
+            name: 'Create participant_messages table',
+            up: `
+				CREATE TABLE IF NOT EXISTS participant_messages (
+					id TEXT PRIMARY KEY,
+					session_id TEXT NOT NULL,
+					from_participant TEXT NOT NULL,
+					to_participant TEXT,
+					message_type TEXT NOT NULL DEFAULT 'info',
+					content TEXT NOT NULL,
+					attachments TEXT,
+					metadata TEXT,
+					is_read INTEGER NOT NULL DEFAULT 0,
+					read_at TEXT,
+					created_at TEXT NOT NULL,
+
+					FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
+				);
+
+				CREATE INDEX IF NOT EXISTS idx_messages_session ON participant_messages(session_id);
+				CREATE INDEX IF NOT EXISTS idx_messages_from ON participant_messages(from_participant);
+				CREATE INDEX IF NOT EXISTS idx_messages_to ON participant_messages(to_participant);
+				CREATE INDEX IF NOT EXISTS idx_messages_unread ON participant_messages(session_id, to_participant, is_read);
+				CREATE INDEX IF NOT EXISTS idx_messages_created ON participant_messages(created_at);
+			`,
+            down: `DROP TABLE IF EXISTS participant_messages`
+        }
+    ],
+    version: 1,
+    timestamps: { createdAt: 'createdAt' },
+    autoId: { field: 'id', strategy: 'uuid' },
+    softDelete: false,
+    allowedAdapters: ['storage.localdb', 'storage.cloud-api'],
+    defaultAdapter: 'storage.localdb',
+    adapterConfig: {
+        'storage.localdb': {
+            dbName: 'sessions.db',
+            scope: 'project'
+        },
+        'storage.cloud-api': {
+            ownerApp: 'hq',
+            endpoint: '/api/internal/session/messages',
+            apiPath: '/api/internal/session/messages',
+            idField: 'id'
+        }
+    },
+    scope: 'project',
+    beforeCreate: messageBeforeCreate,
+    beforeUpdate: messageBeforeUpdate,
+    validateOnWrite: true,
+    validateOnRead: false,
+    internal: false,
+    namespace: 'session.messages',
+    versioning: false,
+    audit: false,
+    changeTracking: false,
+    tags: ['session', 'messages', 'communication', 'collaboration']
+};
+export default sessionMessagesRecordDescriptor;
+//# sourceMappingURL=session-messages.record.descriptor.js.map

package/dist/storage/session-messages.record.descriptor.js.map

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

package/dist/storage/session-participants.record.descriptor.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Session Participants Storage Record Descriptor
+ *
+ * Participant profile management for sessions.
+ *
+ * @example
+ * ```typescript
+ * const participants = await runtime
+ *   .query('storage/record')
+ *   .withId('session.participants')
+ *   .resolve();
+ *
+ * const participant = await participants.create({
+ *   participantId: 'participant-123',
+ *   name: 'Claude Code',
+ *   role: 'agent',
+ *   capabilities: ['code', 'reasoning']
+ * });
+ * ```
+ */
+import * as z from 'zod/v4';
+import type { StorageRecordDescriptorInput } from '@vibesdotdev/storage/schemas/record';
+export declare const ParticipantRecordSchema: z.ZodObject<{
+    participantId: z.ZodString;
+    name: z.ZodString;
+    role: z.ZodOptional<z.ZodString>;
+    capabilities: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    preferences: z.ZodDefault<z.ZodObject<{
+        communicationStyle: z.ZodOptional<z.ZodEnum<{
+            concise: "concise";
+            detailed: "detailed";
+            technical: "technical";
+            casual: "casual";
+        }>>;
+        notifications: z.ZodOptional<z.ZodBoolean>;
+        notificationChannels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        language: z.ZodOptional<z.ZodString>;
+        timezone: z.ZodOptional<z.ZodString>;
+        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>;
+    metadata: z.ZodDefault<z.ZodObject<{
+        avatarUrl: z.ZodOptional<z.ZodURL>;
+        bio: z.ZodOptional<z.ZodString>;
+        organization: z.ZodOptional<z.ZodString>;
+        team: z.ZodOptional<z.ZodString>;
+        slug: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodString>;
+        clientInfo: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            version: z.ZodOptional<z.ZodString>;
+            surface: z.ZodOptional<z.ZodEnum<{
+                cli: "cli";
+                tui: "tui";
+                mcp: "mcp";
+                bridge: "bridge";
+                web: "web";
+                acp: "acp";
+            }>>;
+            externalToolId: z.ZodOptional<z.ZodString>;
+            machineId: z.ZodOptional<z.ZodString>;
+            agentId: z.ZodOptional<z.ZodString>;
+            providerId: z.ZodOptional<z.ZodString>;
+            modelId: z.ZodOptional<z.ZodString>;
+            harnessSessionId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        transport: z.ZodOptional<z.ZodEnum<{
+            http: "http";
+            stdio: "stdio";
+        }>>;
+        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>;
+    createdAt: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodDate]>, z.ZodCoercedDate<string | Date>>;
+    lastSeenAt: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodDate]>, z.ZodCoercedDate<string | Date>>;
+}, z.core.$strip>;
+export type ParticipantRecord = z.infer<typeof ParticipantRecordSchema>;
+export declare const sessionParticipantsRecordDescriptor: StorageRecordDescriptorInput;
+export default sessionParticipantsRecordDescriptor;
+//# sourceMappingURL=session-participants.record.descriptor.d.ts.map

package/dist/storage/session-participants.record.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-participants.record.descriptor.d.ts","sourceRoot":"","sources":["../../src/storage/session-participants.record.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAIxF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,mCAAmC,EAAE,4BA6FjD,CAAC;AAEF,eAAe,mCAAmC,CAAC"}

package/dist/storage/session-participants.record.descriptor.js

@@ -0,0 +1,119 @@
+/**
+ * Session Participants Storage Record Descriptor
+ *
+ * Participant profile management for sessions.
+ *
+ * @example
+ * ```typescript
+ * const participants = await runtime
+ *   .query('storage/record')
+ *   .withId('session.participants')
+ *   .resolve();
+ *
+ * const participant = await participants.create({
+ *   participantId: 'participant-123',
+ *   name: 'Claude Code',
+ *   role: 'agent',
+ *   capabilities: ['code', 'reasoning']
+ * });
+ * ```
+ */
+import * as z from 'zod/v4';
+import { ParticipantProfileSchema } from "../schemas/participant.js";
+export const ParticipantRecordSchema = ParticipantProfileSchema.extend({
+    createdAt: z.union([z.string().datetime(), z.date()]).pipe(z.coerce.date()),
+    lastSeenAt: z.union([z.string().datetime(), z.date()]).pipe(z.coerce.date())
+});
+export const sessionParticipantsRecordDescriptor = {
+    kind: 'storage/record',
+    id: 'session.participants',
+    name: 'Session Participants',
+    description: 'Participant profile management for sessions',
+    schema: ParticipantRecordSchema,
+    tableName: 'participant_profiles',
+    primaryKey: 'participantId',
+    relations: {
+        connections: {
+            type: 'has_many',
+            target: 'session.connections',
+            foreignKey: 'participantId',
+            optional: true,
+            cascadeDelete: false
+        }
+    },
+    indexes: [
+        { name: 'idx_participants_role', fields: ['role'], unique: false, where: 'role IS NOT NULL' },
+        { name: 'idx_participants_last_seen', fields: ['lastSeenAt'], unique: false },
+        // The stable enumeration order (participantId asc) and its keyset cursor
+        // read this index; without it every page sorted the whole directory.
+        { name: 'idx_participants_stable', fields: ['participantId'], unique: false }
+    ],
+    migrations: [
+        {
+            version: 1,
+            name: 'Create participant_profiles table',
+            up: `
+				CREATE TABLE IF NOT EXISTS participant_profiles (
+					participant_id TEXT PRIMARY KEY,
+					name TEXT NOT NULL,
+					role TEXT,
+					capabilities TEXT,
+					preferences TEXT,
+					metadata TEXT,
+					created_at TEXT NOT NULL,
+					updated_at TEXT NOT NULL,
+					last_seen_at TEXT NOT NULL
+				);
+
+				CREATE INDEX IF NOT EXISTS idx_participant_profiles_role ON participant_profiles(role);
+				CREATE INDEX IF NOT EXISTS idx_participant_profiles_last_seen ON participant_profiles(last_seen_at);
+			`,
+            down: `DROP TABLE IF EXISTS participant_profiles`
+        }
+    ],
+    version: 1,
+    timestamps: { createdAt: 'createdAt', updatedAt: 'lastSeenAt' },
+    autoId: false,
+    softDelete: false,
+    allowedAdapters: ['storage.localdb', 'storage.cloud-api'],
+    defaultAdapter: 'storage.localdb',
+    adapterConfig: {
+        'storage.localdb': {
+            dbName: 'sessions.db',
+            scope: 'project'
+        },
+        'storage.cloud-api': {
+            ownerApp: 'hq',
+            endpoint: '/api/internal/session/participants',
+            apiPath: '/api/internal/session/participants',
+            idField: 'participantId'
+        }
+    },
+    scope: 'project',
+    beforeCreate: (participant) => {
+        if (!participant.capabilities)
+            participant.capabilities = [];
+        if (!participant.preferences)
+            participant.preferences = {};
+        if (!participant.metadata)
+            participant.metadata = {};
+        const now = new Date().toISOString();
+        if (!participant.createdAt)
+            participant.createdAt = now;
+        if (!participant.lastSeenAt)
+            participant.lastSeenAt = now;
+    },
+    beforeUpdate: (participant) => {
+        participant.lastSeenAt = new Date().toISOString();
+    },
+    validateOnWrite: true,
+    validateOnRead: false,
+    internal: false,
+    namespace: 'session.participants',
+    versioning: false,
+    audit: false,
+    changeTracking: false,
+    tags: ['session', 'participants', 'identity', 'agents']
+};
+export default sessionParticipantsRecordDescriptor;
+//# sourceMappingURL=session-participants.record.descriptor.js.map

package/dist/storage/session-participants.record.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-participants.record.descriptor.js","sourceRoot":"","sources":["../../src/storage/session-participants.record.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAErE,MAAM,CAAC,MAAM,uBAAuB,GAAG,wBAAwB,CAAC,MAAM,CAAC;IACtE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC3E,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;CAC5E,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,mCAAmC,GAAiC;IAChF,IAAI,EAAE,gBAAgB;IACtB,EAAE,EAAE,sBAAsB;IAC1B,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EAAE,6CAA6C;IAC1D,MAAM,EAAE,uBAAuB;IAC/B,SAAS,EAAE,sBAAsB;IACjC,UAAU,EAAE,eAAe;IAE3B,SAAS,EAAE;QACV,WAAW,EAAE;YACZ,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,qBAAqB;YAC7B,UAAU,EAAE,eAAe;YAC3B,QAAQ,EAAE,IAAI;YACd,aAAa,EAAE,KAAK;SACpB;KACD;IAED,OAAO,EAAE;QACR,EAAE,IAAI,EAAE,uBAAuB,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE;QAC7F,EAAE,IAAI,EAAE,4BAA4B,EAAE,MAAM,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE;QAC7E,yEAAyE;QACzE,qEAAqE;QACrE,EAAE,IAAI,EAAE,yBAAyB,EAAE,MAAM,EAAE,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE;KAC7E;IAED,UAAU,EAAE;QACX;YACC,OAAO,EAAE,CAAC;YACV,IAAI,EAAE,mCAAmC;YACzC,EAAE,EAAE;;;;;;;;;;;;;;;IAeH;YACD,IAAI,EAAE,2CAA2C;SACjD;KACD;IAED,OAAO,EAAE,CAAC;IACV,UAAU,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE;IAC/D,MAAM,EAAE,KAAK;IACb,UAAU,EAAE,KAAK;IAEjB,eAAe,EAAE,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;IACzD,cAAc,EAAE,iBAAiB;IACjC,aAAa,EAAE;QACd,iBAAiB,EAAE;YAClB,MAAM,EAAE,aAAa;YACrB,KAAK,EAAE,SAAS;SAChB;QACD,mBAAmB,EAAE;YACpB,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,oCAAoC;YAC9C,OAAO,EAAE,oCAAoC;YAC7C,OAAO,EAAE,eAAe;SACxB;KACD;IACD,KAAK,EAAE,SAAS;IAEhB,YAAY,EAAE,CAAC,WAAwD,EAAE,EAAE;QAC1E,IAAI,CAAC,WAAW,CAAC,YAAY;YAAE,WAAW,CAAC,YAAY,GAAG,EAAE,CAAC;QAC7D,IAAI,CAAC,WAAW,CAAC,WAAW;YAAE,WAAW,CAAC,WAAW,GAAG,EAAE,CAAC;QAC3D,IAAI,CAAC,WAAW,CAAC,QAAQ;YAAE,WAAW,CAAC,QAAQ,GAAG,EAAE,CAAC;QACrD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,IAAI,CAAC,WAAW,CAAC,SAAS;YAAE,WAAW,CAAC,SAAS,GAAG,GAAG,CAAC;QACxD,IAAI,CAAC,WAAW,CAAC,UAAU;YAAE,WAAW,CAAC,UAAU,GAAG,GAAG,CAAC;IAC3D,CAAC;IAED,YAAY,EAAE,CAAC,WAAwD,EAAE,EAAE;QAC1E,WAAW,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACnD,CAAC;IAED,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,KAAK;IACrB,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,sBAAsB;IACjC,UAAU,EAAE,KAAK;IACjB,KAAK,EAAE,KAAK;IACZ,cAAc,EAAE,KAAK;IACrB,IAAI,EAAE,CAAC,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,QAAQ,CAAC;CACvD,CAAC;AAEF,eAAe,mCAAmC,CAAC"}

package/dist/storage/session-presence.record.descriptor.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Session Presence Storage Record Descriptor
+ *
+ * Active connection tracking for multi-tab awareness.
+ *
+ * @example
+ * ```typescript
+ * const presence = await runtime
+ *   .query('storage/record')
+ *   .withId('session.presence')
+ *   .resolve();
+ *
+ * const record = await presence.create({
+ *   sessionId: 'session-123',
+ *   participantId: 'participant-456',
+ *   connectionId: 'conn-789',
+ *   status: 'active'
+ * });
+ * ```
+ */
+import * as z from 'zod/v4';
+import type { StorageRecordDescriptorInput } from '@vibesdotdev/storage/schemas/record';
+import type { RecordDraft } from './record-draft.ts';
+export declare const PresenceRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    contextType: z.ZodLiteral<"session">;
+    contextId: z.ZodString;
+    participantId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    connectionId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    connectedAt: z.ZodUnion<readonly [z.ZodString, z.ZodDate]>;
+    lastHeartbeat: z.ZodUnion<readonly [z.ZodString, z.ZodDate]>;
+    status: z.ZodEnum<{
+        active: "active";
+        idle: "idle";
+        stale: "stale";
+    }>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type PresenceRecord = z.infer<typeof PresenceRecordSchema>;
+export declare function presenceBeforeUpdate(presence: RecordDraft<typeof PresenceRecordSchema>): void;
+export declare const sessionPresenceRecordDescriptor: StorageRecordDescriptorInput;
+export default sessionPresenceRecordDescriptor;
+//# sourceMappingURL=session-presence.record.descriptor.d.ts.map

package/dist/storage/session-presence.record.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-presence.record.descriptor.d.ts","sourceRoot":"","sources":["../../src/storage/session-presence.record.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AACxF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;iBAU/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,WAAW,CAAC,OAAO,oBAAoB,CAAC,GAAG,IAAI,CAE7F;AAED,eAAO,MAAM,+BAA+B,EAAE,4BA4G7C,CAAC;AAEF,eAAe,+BAA+B,CAAC"}

package/dist/storage/session-presence.record.descriptor.js

@@ -0,0 +1,141 @@
+/**
+ * Session Presence Storage Record Descriptor
+ *
+ * Active connection tracking for multi-tab awareness.
+ *
+ * @example
+ * ```typescript
+ * const presence = await runtime
+ *   .query('storage/record')
+ *   .withId('session.presence')
+ *   .resolve();
+ *
+ * const record = await presence.create({
+ *   sessionId: 'session-123',
+ *   participantId: 'participant-456',
+ *   connectionId: 'conn-789',
+ *   status: 'active'
+ * });
+ * ```
+ */
+import * as z from 'zod/v4';
+import { PresenceStatusSchema } from "../schemas/presence.js";
+export const PresenceRecordSchema = z.object({
+    id: z.string().uuid(),
+    contextType: z.literal('session'),
+    contextId: z.string().uuid(),
+    participantId: z.string().uuid().optional().nullable(),
+    connectionId: z.string().optional().nullable(),
+    connectedAt: z.union([z.string().datetime(), z.date()]),
+    lastHeartbeat: z.union([z.string().datetime(), z.date()]),
+    status: PresenceStatusSchema,
+    metadata: z.record(z.string(), z.unknown()).optional()
+});
+export function presenceBeforeUpdate(presence) {
+    presence.lastHeartbeat = new Date().toISOString();
+}
+export const sessionPresenceRecordDescriptor = {
+    kind: 'storage/record',
+    id: 'session.presence',
+    name: 'Session Presence',
+    description: 'Active connection tracking for multi-tab awareness',
+    schema: PresenceRecordSchema,
+    tableName: 'session_presence',
+    primaryKey: 'id',
+    // Age the live projection by its heartbeat, not connection age. Storage's
+    // generic retention job enforces this policy; a live heartbeat renews it.
+    retention: {
+        maxAgeDays: 1,
+        ageField: 'lastHeartbeat',
+        reason: 'Presence readers measure freshness in minutes. One day without a ' +
+            'heartbeat expires stale projections without aging out live connections.'
+    },
+    relations: {
+        session: {
+            type: 'belongs_to',
+            target: 'session.sessions',
+            foreignKey: 'contextId',
+            optional: false,
+            cascadeDelete: true
+        }
+    },
+    indexes: [
+        { name: 'idx_presence_session', fields: ['contextId'], unique: false },
+        {
+            name: 'idx_presence_participant',
+            fields: ['participantId'],
+            unique: false,
+            where: 'participantId IS NOT NULL'
+        },
+        {
+            name: 'idx_presence_connection',
+            fields: ['connectionId'],
+            unique: false,
+            where: 'connectionId IS NOT NULL'
+        },
+        { name: 'idx_presence_status', fields: ['status'], unique: false },
+        { name: 'idx_presence_heartbeat', fields: ['lastHeartbeat'], unique: false }
+    ],
+    migrations: [
+        {
+            version: 1,
+            name: 'Create session_presence table',
+            up: `
+				CREATE TABLE IF NOT EXISTS session_presence (
+					id TEXT PRIMARY KEY,
+					session_id TEXT NOT NULL,
+					participant_id TEXT,
+					connection_id TEXT,
+					connected_at TEXT NOT NULL,
+					last_heartbeat TEXT NOT NULL,
+					status TEXT NOT NULL DEFAULT 'active',
+					metadata TEXT,
+
+					FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
+				);
+
+				CREATE INDEX IF NOT EXISTS idx_presence_session ON session_presence(session_id);
+				CREATE INDEX IF NOT EXISTS idx_presence_participant ON session_presence(participant_id);
+				CREATE INDEX IF NOT EXISTS idx_presence_connection ON session_presence(connection_id);
+				CREATE INDEX IF NOT EXISTS idx_presence_status ON session_presence(status);
+				CREATE INDEX IF NOT EXISTS idx_presence_heartbeat ON session_presence(last_heartbeat);
+			`,
+            down: `DROP TABLE IF EXISTS session_presence`
+        }
+    ],
+    version: 1,
+    timestamps: { createdAt: 'connectedAt', updatedAt: 'lastHeartbeat' },
+    autoId: { field: 'id', strategy: 'uuid' },
+    softDelete: false,
+    allowedAdapters: ['storage.localdb'],
+    defaultAdapter: 'storage.localdb',
+    adapterConfig: {
+        'storage.localdb': {
+            dbName: 'sessions.db',
+            scope: 'project'
+        }
+    },
+    scope: 'project',
+    beforeCreate: (presence) => {
+        if (!presence.status)
+            presence.status = 'active';
+        if (!presence.metadata)
+            presence.metadata = {};
+        const now = new Date().toISOString();
+        if (!presence.connectedAt)
+            presence.connectedAt = now;
+        if (!presence.lastHeartbeat)
+            presence.lastHeartbeat = now;
+    },
+    beforeUpdate: presenceBeforeUpdate,
+    validateOnWrite: true,
+    validateOnRead: false,
+    internal: false,
+    namespace: 'session.presence',
+    versioning: false,
+    audit: false,
+    changeTracking: false,
+    tags: ['session', 'presence', 'connections', 'multiplayer']
+};
+export default sessionPresenceRecordDescriptor;
+//# sourceMappingURL=session-presence.record.descriptor.js.map

package/dist/storage/session-presence.record.descriptor.js.map

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