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

package/dist/schemas/presence-core.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Presence Schema (Core)
+ * Reusable pattern for tracking "who's connected to X" across different contexts
+ */
+import * as z from 'zod/v4';
+export declare const PresenceStatusSchema: z.ZodEnum<{
+    active: "active";
+    idle: "idle";
+    stale: "stale";
+}>;
+export type PresenceStatus = z.infer<typeof PresenceStatusSchema>;
+export declare const PresenceContextTypeSchema: z.ZodEnum<{
+    session: "session";
+    channel: "channel";
+    document: "document";
+    "work-item": "work-item";
+}>;
+export type PresenceContextType = z.infer<typeof PresenceContextTypeSchema>;
+export declare const PRESENCE_THRESHOLDS: {
+    readonly IDLE_THRESHOLD_MS: 60000;
+    readonly STALE_THRESHOLD_MS: 300000;
+    readonly HEARTBEAT_INTERVAL_MS: 30000;
+};
+export declare const PresenceRecordSchema: <T extends z.ZodTypeAny>(contextTypeEnum: T) => z.ZodObject<{
+    id: z.ZodUUID;
+    contextType: T;
+    contextId: z.ZodUUID;
+    participantId: z.ZodOptional<z.ZodUUID>;
+    connectionId: z.ZodOptional<z.ZodString>;
+    connectedAt: z.ZodISODateTime;
+    lastHeartbeat: z.ZodISODateTime;
+    status: z.ZodEnum<{
+        active: "active";
+        idle: "idle";
+        stale: "stale";
+    }>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export declare const SessionPresenceSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    contextType: z.ZodLiteral<"session">;
+    contextId: z.ZodUUID;
+    participantId: z.ZodOptional<z.ZodUUID>;
+    connectionId: z.ZodOptional<z.ZodString>;
+    connectedAt: z.ZodISODateTime;
+    lastHeartbeat: z.ZodISODateTime;
+    status: z.ZodEnum<{
+        active: "active";
+        idle: "idle";
+        stale: "stale";
+    }>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type SessionPresence = z.infer<typeof SessionPresenceSchema>;
+export declare const WorkItemPresenceSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    contextType: z.ZodLiteral<"work-item">;
+    contextId: z.ZodUUID;
+    participantId: z.ZodOptional<z.ZodUUID>;
+    connectionId: z.ZodOptional<z.ZodString>;
+    connectedAt: z.ZodISODateTime;
+    lastHeartbeat: z.ZodISODateTime;
+    status: z.ZodEnum<{
+        active: "active";
+        idle: "idle";
+        stale: "stale";
+    }>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type WorkItemPresence = z.infer<typeof WorkItemPresenceSchema>;
+export declare const PresenceCreateSchema: z.ZodObject<{
+    contextType: z.ZodEnum<{
+        session: "session";
+        channel: "channel";
+        document: "document";
+        "work-item": "work-item";
+    }>;
+    contextId: z.ZodUUID;
+    participantId: z.ZodOptional<z.ZodUUID>;
+    connectionId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type PresenceCreate = z.infer<typeof PresenceCreateSchema>;
+export declare const HeartbeatInputSchema: z.ZodObject<{
+    connectionId: z.ZodString;
+    contextId: z.ZodOptional<z.ZodUUID>;
+}, z.core.$strip>;
+export type HeartbeatInput = z.infer<typeof HeartbeatInputSchema>;
+export declare function computePresenceStatus(lastHeartbeat: Date | string): PresenceStatus;
+export declare function isActivelyOccupied(presence: {
+    status: PresenceStatus;
+} | null | undefined): boolean;
+//# sourceMappingURL=presence-core.d.ts.map

package/dist/schemas/presence-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence-core.d.ts","sourceRoot":"","sources":["../../src/schemas/presence-core.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,eAAO,MAAM,oBAAoB;;;;EAAsC,CAAC;AACxE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,yBAAyB;;;;;EAA0D,CAAC;AACjG,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,mBAAmB;;;;CAItB,CAAC;AAEX,eAAO,MAAM,oBAAoB,GAAI,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,iBAAiB,CAAC;;;;;;;;;;;;;;iBAW5E,CAAC;AAEJ,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;iBAA6C,CAAC;AAChF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;iBAA+C,CAAC;AACnF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,oBAAoB;;;;;;;;;;;iBAM/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,oBAAoB;;;iBAG/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,IAAI,GAAG,MAAM,GAAG,cAAc,CAYlF;AAED,wBAAgB,kBAAkB,CACjC,QAAQ,EAAE;IAAE,MAAM,EAAE,cAAc,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GACrD,OAAO,CAET"}

package/dist/schemas/presence-core.js

@@ -0,0 +1,53 @@
+/**
+ * Presence Schema (Core)
+ * Reusable pattern for tracking "who's connected to X" across different contexts
+ */
+import * as z from 'zod/v4';
+export const PresenceStatusSchema = z.enum(['active', 'idle', 'stale']);
+export const PresenceContextTypeSchema = z.enum(['session', 'work-item', 'document', 'channel']);
+export const PRESENCE_THRESHOLDS = {
+    IDLE_THRESHOLD_MS: 60_000,
+    STALE_THRESHOLD_MS: 300_000,
+    HEARTBEAT_INTERVAL_MS: 30_000
+};
+export const PresenceRecordSchema = (contextTypeEnum) => z.object({
+    id: z.uuid(),
+    contextType: contextTypeEnum,
+    contextId: z.uuid(),
+    participantId: z.uuid().optional(),
+    connectionId: z.string().optional(),
+    connectedAt: z.iso.datetime(),
+    lastHeartbeat: z.iso.datetime(),
+    status: PresenceStatusSchema,
+    metadata: z.record(z.string(), z.unknown()).optional()
+});
+export const SessionPresenceSchema = PresenceRecordSchema(z.literal('session'));
+export const WorkItemPresenceSchema = PresenceRecordSchema(z.literal('work-item'));
+export const PresenceCreateSchema = z.object({
+    contextType: PresenceContextTypeSchema,
+    contextId: z.uuid(),
+    participantId: z.uuid().optional(),
+    connectionId: z.string().optional(),
+    metadata: z.record(z.string(), z.unknown()).optional()
+});
+export const HeartbeatInputSchema = z.object({
+    connectionId: z.string(),
+    contextId: z.uuid().optional()
+});
+export function computePresenceStatus(lastHeartbeat) {
+    const lastHeartbeatMs = new Date(lastHeartbeat).getTime();
+    const elapsed = Date.now() - lastHeartbeatMs;
+    if (elapsed < PRESENCE_THRESHOLDS.IDLE_THRESHOLD_MS) {
+        return 'active';
+    }
+    else if (elapsed < PRESENCE_THRESHOLDS.STALE_THRESHOLD_MS) {
+        return 'idle';
+    }
+    else {
+        return 'stale';
+    }
+}
+export function isActivelyOccupied(presence) {
+    return presence?.status === 'active' || presence?.status === 'idle';
+}
+//# sourceMappingURL=presence-core.js.map

package/dist/schemas/presence-core.js.map

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

package/dist/schemas/presence.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Session Presence Schema
+ * Tracks active connections to sessions for multi-tab awareness
+ */
+import * as z from 'zod/v4';
+import { PresenceStatusSchema, PRESENCE_THRESHOLDS, computePresenceStatus, isActivelyOccupied } from './presence-core.ts';
+export { PresenceStatusSchema, PRESENCE_THRESHOLDS, computePresenceStatus, isActivelyOccupied };
+export type { PresenceStatus } from './presence-core.ts';
+/**
+ * Session presence record
+ */
+export declare const SessionPresenceSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    contextType: z.ZodLiteral<"session">;
+    contextId: z.ZodUUID;
+    participantId: z.ZodOptional<z.ZodUUID>;
+    connectionId: z.ZodOptional<z.ZodString>;
+    connectedAt: z.ZodISODateTime;
+    lastHeartbeat: z.ZodISODateTime;
+    status: z.ZodEnum<{
+        active: "active";
+        idle: "idle";
+        stale: "stale";
+    }>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type SessionPresence = z.infer<typeof SessionPresenceSchema>;
+/**
+ * Create input for session presence
+ */
+export declare const SessionPresenceCreateSchema: z.ZodObject<{
+    sessionId: z.ZodUUID;
+    participantId: z.ZodOptional<z.ZodUUID>;
+    connectionId: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type SessionPresenceCreate = z.infer<typeof SessionPresenceCreateSchema>;
+/**
+ * Heartbeat input
+ */
+export declare const SessionHeartbeatSchema: z.ZodObject<{
+    connectionId: z.ZodString;
+    contextId: z.ZodOptional<z.ZodUUID>;
+}, z.core.$strip>;
+export type SessionHeartbeat = z.infer<typeof SessionHeartbeatSchema>;
+/**
+ * Presence summary for a session (multiple connections)
+ */
+export declare const SessionPresenceSummarySchema: z.ZodObject<{
+    sessionId: z.ZodUUID;
+    activeCount: z.ZodNumber;
+    idleCount: z.ZodNumber;
+    staleCount: z.ZodNumber;
+    totalCount: z.ZodNumber;
+    isOccupied: z.ZodBoolean;
+    connections: z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+        connectionId: z.ZodOptional<z.ZodString>;
+        participantId: z.ZodOptional<z.ZodUUID>;
+        status: z.ZodEnum<{
+            active: "active";
+            idle: "idle";
+            stale: "stale";
+        }>;
+        lastHeartbeat: z.ZodISODateTime;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SessionPresenceSummary = z.infer<typeof SessionPresenceSummarySchema>;
+//# sourceMappingURL=presence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presence.d.ts","sourceRoot":"","sources":["../../src/schemas/presence.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAEN,oBAAoB,EAEpB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,CAAC;AAChG,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;iBAA4B,CAAC;AAC/D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;iBAKtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;iBAAuB,CAAC;AAC3D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;iBAgBvC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC"}

package/dist/schemas/presence.js

@@ -0,0 +1,44 @@
+/**
+ * Session Presence Schema
+ * Tracks active connections to sessions for multi-tab awareness
+ */
+import * as z from 'zod/v4';
+import { SessionPresenceSchema as BaseSessionPresenceSchema, PresenceStatusSchema, HeartbeatInputSchema, PRESENCE_THRESHOLDS, computePresenceStatus, isActivelyOccupied } from "./presence-core.js";
+// Re-export shared utilities
+export { PresenceStatusSchema, PRESENCE_THRESHOLDS, computePresenceStatus, isActivelyOccupied };
+/**
+ * Session presence record
+ */
+export const SessionPresenceSchema = BaseSessionPresenceSchema;
+/**
+ * Create input for session presence
+ */
+export const SessionPresenceCreateSchema = z.object({
+    sessionId: z.uuid(),
+    participantId: z.uuid().optional(),
+    connectionId: z.string().optional(),
+    metadata: z.record(z.string(), z.unknown()).optional()
+});
+/**
+ * Heartbeat input
+ */
+export const SessionHeartbeatSchema = HeartbeatInputSchema;
+/**
+ * Presence summary for a session (multiple connections)
+ */
+export const SessionPresenceSummarySchema = z.object({
+    sessionId: z.uuid(),
+    activeCount: z.number().int().nonnegative(),
+    idleCount: z.number().int().nonnegative(),
+    staleCount: z.number().int().nonnegative(),
+    totalCount: z.number().int().nonnegative(),
+    isOccupied: z.boolean(),
+    connections: z.array(z.object({
+        id: z.uuid(),
+        connectionId: z.string().optional(),
+        participantId: z.uuid().optional(),
+        status: PresenceStatusSchema,
+        lastHeartbeat: z.iso.datetime()
+    }))
+});
+//# sourceMappingURL=presence.js.map

package/dist/schemas/presence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presence.js","sourceRoot":"","sources":["../../src/schemas/presence.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EACN,qBAAqB,IAAI,yBAAyB,EAClD,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,MAAM,oBAAoB,CAAC;AAE5B,6BAA6B;AAC7B,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,CAAC;AAGhG;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,yBAAyB,CAAC;AAG/D;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE;IACnB,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IAClC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC;AAGH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAG3D;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE;IACnB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACzC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC1C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC1C,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;IACvB,WAAW,EAAE,CAAC,CAAC,KAAK,CACnB,CAAC,CAAC,MAAM,CAAC;QACR,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE;QACZ,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACnC,aAAa,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;QAClC,MAAM,EAAE,oBAAoB;QAC5B,aAAa,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE;KAC/B,CAAC,CACF;CACD,CAAC,CAAC"}

package/dist/schemas/registry-state.d.ts

@@ -0,0 +1,64 @@
+import * as z from 'zod/v4';
+/**
+ * The session TUI's registry state: the `sessions.registry` tui/state key
+ * parses every write with this schema.
+ */
+export declare const SessionsRegistryStateSchema: z.ZodObject<{
+    sessions: z.ZodArray<z.ZodCustom<{
+        id: string;
+        title: string;
+        createdAt: Date;
+        tags: string[];
+        status: "active" | "paused" | "archived";
+        ownerParticipant: string;
+        lastActivityAt: Date;
+        todoCount: number;
+        completedTodoCount: number;
+        scratchpadEntryCount: number;
+        jobCount: number;
+        messageCount: number;
+        assignedParticipant?: string | undefined;
+        ownerParticipantId?: string | undefined;
+        ownerParticipantSlug?: string | undefined;
+        ownerParticipantName?: string | undefined;
+        assignedParticipantId?: string | undefined;
+        assignedParticipantSlug?: string | undefined;
+        assignedParticipantName?: string | undefined;
+        workItemId?: string | undefined;
+        workItemTitle?: string | undefined;
+        workspaceRoot?: string | undefined;
+        gitBranch?: string | undefined;
+        worktree?: string | undefined;
+    }, {
+        id: string;
+        title: string;
+        createdAt: Date;
+        tags: string[];
+        status: "active" | "paused" | "archived";
+        ownerParticipant: string;
+        lastActivityAt: Date;
+        todoCount: number;
+        completedTodoCount: number;
+        scratchpadEntryCount: number;
+        jobCount: number;
+        messageCount: number;
+        assignedParticipant?: string | undefined;
+        ownerParticipantId?: string | undefined;
+        ownerParticipantSlug?: string | undefined;
+        ownerParticipantName?: string | undefined;
+        assignedParticipantId?: string | undefined;
+        assignedParticipantSlug?: string | undefined;
+        assignedParticipantName?: string | undefined;
+        workItemId?: string | undefined;
+        workItemTitle?: string | undefined;
+        workspaceRoot?: string | undefined;
+        gitBranch?: string | undefined;
+        worktree?: string | undefined;
+    }>>;
+    loaded: z.ZodBoolean;
+    loading: z.ZodBoolean;
+    error: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type SessionsRegistryState = z.infer<typeof SessionsRegistryStateSchema>;
+export declare const defaultSessionsRegistryState: SessionsRegistryState;
+//# sourceMappingURL=registry-state.d.ts.map

package/dist/schemas/registry-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-state.d.ts","sourceRoot":"","sources":["../../src/schemas/registry-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAc5B;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAStC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,4BAA4B,EAAE,qBAK1C,CAAC"}

package/dist/schemas/registry-state.js

@@ -0,0 +1,30 @@
+import * as z from 'zod/v4';
+/**
+ * The fields of a session summary the session TUI lists and acts on. The
+ * summaries come from the selected `session/manager`; the state checks these
+ * fields and keeps each summary as the manager listed it.
+ */
+const ListedSessionFieldsSchema = z.looseObject({
+    id: z.string(),
+    title: z.string(),
+    status: z.string()
+});
+/**
+ * The session TUI's registry state: the `sessions.registry` tui/state key
+ * parses every write with this schema.
+ */
+export const SessionsRegistryStateSchema = z.object({
+    sessions: z.array(z.custom((value) => ListedSessionFieldsSchema.safeParse(value).success, {
+        error: 'not a session summary'
+    })),
+    loaded: z.boolean(),
+    loading: z.boolean(),
+    error: z.string().nullable()
+});
+export const defaultSessionsRegistryState = {
+    sessions: [],
+    loaded: false,
+    loading: false,
+    error: null
+};
+//# sourceMappingURL=registry-state.js.map

package/dist/schemas/registry-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-state.js","sourceRoot":"","sources":["../../src/schemas/registry-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B;;;;GAIG;AACH,MAAM,yBAAyB,GAAG,CAAC,CAAC,WAAW,CAAC;IAC/C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,QAAQ,EAAE,CAAC,CAAC,KAAK,CAChB,CAAC,CAAC,MAAM,CAAiB,CAAC,KAAK,EAAE,EAAE,CAAC,yBAAyB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE;QACvF,KAAK,EAAE,uBAAuB;KAC9B,CAAC,CACF;IACD,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;IACnB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,4BAA4B,GAA0B;IAClE,QAAQ,EAAE,EAAE;IACZ,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,KAAK;IACd,KAAK,EAAE,IAAI;CACX,CAAC"}

package/dist/schemas/scratchpad.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Scratchpad Schemas
+ * Temporary storage entity definitions
+ */
+import * as z from 'zod/v4';
+/**
+ * Content type enum
+ */
+export declare const ScratchpadContentTypeSchema: z.ZodEnum<{
+    code: "code";
+    text: "text";
+    json: "json";
+    markdown: "markdown";
+}>;
+export type ScratchpadContentType = z.infer<typeof ScratchpadContentTypeSchema>;
+/**
+ * Auto-detect content type from raw content string.
+ * Priority: json > markdown > code > text
+ */
+export declare function detectContentType(content: string): ScratchpadContentType;
+/**
+ * Scratchpad metadata schema
+ * Typed metadata for scratchpad entries with passthrough for extensibility
+ */
+export declare const ScratchpadMetadataSchema: z.ZodObject<{
+    source: z.ZodOptional<z.ZodString>;
+    version: z.ZodOptional<z.ZodString>;
+    filePath: z.ZodOptional<z.ZodString>;
+    lineRange: z.ZodOptional<z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+    }, z.core.$strip>>;
+    todoId: z.ZodOptional<z.ZodUUID>;
+    custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+export type ScratchpadMetadata = z.infer<typeof ScratchpadMetadataSchema>;
+/**
+ * Complete scratchpad entry entity
+ */
+export declare const ScratchpadEntrySchema: z.ZodObject<{
+    id: z.ZodUUID;
+    sessionId: z.ZodUUID;
+    key: z.ZodString;
+    content: z.ZodString;
+    contentType: z.ZodEnum<{
+        code: "code";
+        text: "text";
+        json: "json";
+        markdown: "markdown";
+    }>;
+    language: z.ZodOptional<z.ZodString>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    metadata: z.ZodDefault<z.ZodObject<{
+        source: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+        filePath: z.ZodOptional<z.ZodString>;
+        lineRange: z.ZodOptional<z.ZodObject<{
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+        }, z.core.$strip>>;
+        todoId: z.ZodOptional<z.ZodUUID>;
+        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>;
+    expiresAt: z.ZodOptional<z.ZodDate>;
+    createdAt: z.ZodDate;
+    updatedAt: z.ZodDate;
+}, z.core.$strip>;
+export type ScratchpadEntry = z.infer<typeof ScratchpadEntrySchema>;
+/**
+ * Scratchpad entry creation input
+ */
+export declare const ScratchpadEntryCreateSchema: z.ZodObject<{
+    metadata: z.ZodOptional<z.ZodDefault<z.ZodObject<{
+        source: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+        filePath: z.ZodOptional<z.ZodString>;
+        lineRange: z.ZodOptional<z.ZodObject<{
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+        }, z.core.$strip>>;
+        todoId: z.ZodOptional<z.ZodUUID>;
+        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>>;
+    key: z.ZodString;
+    tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+    content: z.ZodString;
+    expiresAt: z.ZodOptional<z.ZodOptional<z.ZodDate>>;
+    contentType: z.ZodEnum<{
+        code: "code";
+        text: "text";
+        json: "json";
+        markdown: "markdown";
+    }>;
+    language: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ScratchpadEntryCreate = z.infer<typeof ScratchpadEntryCreateSchema>;
+/**
+ * Scratchpad entry update input
+ */
+export declare const ScratchpadEntryUpdateSchema: z.ZodObject<{
+    metadata: z.ZodOptional<z.ZodDefault<z.ZodObject<{
+        source: z.ZodOptional<z.ZodString>;
+        version: z.ZodOptional<z.ZodString>;
+        filePath: z.ZodOptional<z.ZodString>;
+        lineRange: z.ZodOptional<z.ZodObject<{
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+        }, z.core.$strip>>;
+        todoId: z.ZodOptional<z.ZodUUID>;
+        custom: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$loose>>>;
+    tags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+    content: z.ZodOptional<z.ZodString>;
+    expiresAt: z.ZodOptional<z.ZodOptional<z.ZodDate>>;
+    contentType: z.ZodOptional<z.ZodEnum<{
+        code: "code";
+        text: "text";
+        json: "json";
+        markdown: "markdown";
+    }>>;
+    language: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    updatedAt: z.ZodOptional<z.ZodDate>;
+}, z.core.$strip>;
+export type ScratchpadEntryUpdate = z.infer<typeof ScratchpadEntryUpdateSchema>;
+/**
+ * Scratchpad filters for queries
+ */
+export declare const ScratchpadFiltersSchema: z.ZodObject<{
+    contentType: z.ZodOptional<z.ZodEnum<{
+        code: "code";
+        text: "text";
+        json: "json";
+        markdown: "markdown";
+    }>>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    search: z.ZodOptional<z.ZodString>;
+    expired: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type ScratchpadFilters = z.infer<typeof ScratchpadFiltersSchema>;
+/**
+ * Scratchpad summary (for listings)
+ */
+export declare const ScratchpadSummarySchema: z.ZodObject<{
+    key: z.ZodString;
+    id: z.ZodUUID;
+    createdAt: z.ZodDate;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    updatedAt: z.ZodDate;
+    expiresAt: z.ZodOptional<z.ZodDate>;
+    contentType: z.ZodEnum<{
+        code: "code";
+        text: "text";
+        json: "json";
+        markdown: "markdown";
+    }>;
+    language: z.ZodOptional<z.ZodString>;
+    contentLength: z.ZodNumber;
+    preview: z.ZodString;
+}, z.core.$strip>;
+export type ScratchpadSummary = z.infer<typeof ScratchpadSummarySchema>;
+//# sourceMappingURL=scratchpad.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scratchpad.d.ts","sourceRoot":"","sources":["../../src/schemas/scratchpad.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;EAA+C,CAAC;AACxF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAexE;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;iBAkBnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoBhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;iBAStC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;iBAIrC,CAAC;AAEJ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;iBAOlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;iBAYlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/schemas/scratchpad.js

@@ -0,0 +1,119 @@
+/**
+ * Scratchpad Schemas
+ * Temporary storage entity definitions
+ */
+import * as z from 'zod/v4';
+import { isJsonText } from "./json-text.js";
+/**
+ * Content type enum
+ */
+export const ScratchpadContentTypeSchema = z.enum(['markdown', 'json', 'code', 'text']);
+/**
+ * Auto-detect content type from raw content string.
+ * Priority: json > markdown > code > text
+ */
+export function detectContentType(content) {
+    const trimmed = content.trim();
+    if ((trimmed.startsWith('{') || trimmed.startsWith('[')) && isJsonText(trimmed)) {
+        return 'json';
+    }
+    const mdPatterns = /^#{1,6}\s|^```|\[.+\]\(.+\)|^\*{1,3}[^*]+\*{1,3}|^-{3,}$|^>\s/m;
+    if (mdPatterns.test(trimmed))
+        return 'markdown';
+    const codePatterns = /^(?:import|export|function|class|const|let|var|type|interface|async|def|fn|pub|use|package|#include)\s/m;
+    if (codePatterns.test(trimmed))
+        return 'code';
+    return 'text';
+}
+/**
+ * Scratchpad metadata schema
+ * Typed metadata for scratchpad entries with passthrough for extensibility
+ */
+export const ScratchpadMetadataSchema = z.looseObject({
+    /** Source that created this entry */
+    source: z.string().optional(),
+    /** Version of the tool/agent that created this */
+    version: z.string().optional(),
+    /** File path if entry is related to a specific file */
+    filePath: z.string().optional(),
+    /** Line number range if applicable */
+    lineRange: z
+        .object({
+        start: z.number().int().nonnegative(),
+        end: z.number().int().nonnegative()
+    })
+        .optional(),
+    /** Related TODO ID if applicable */
+    todoId: z.uuid().optional(),
+    /** Custom fields for extension */
+    custom: z.record(z.string(), z.unknown()).optional()
+});
+/**
+ * Complete scratchpad entry entity
+ */
+export const ScratchpadEntrySchema = z.object({
+    id: z.uuid(),
+    sessionId: z.uuid(),
+    // Content
+    key: z.string().min(1).max(200), // Namespace key: "planning/architecture"
+    content: z.string().max(1048576), // 1MB max per entry
+    contentType: ScratchpadContentTypeSchema,
+    language: z.string().max(50).optional(), // For code entries (e.g., "typescript")
+    // Organization
+    tags: z.array(z.string()).default([]),
+    metadata: ScratchpadMetadataSchema.default({}),
+    // Expiration
+    expiresAt: z.date().optional(), // Auto-cleanup old entries
+    // Timestamps
+    createdAt: z.date(),
+    updatedAt: z.date()
+});
+/**
+ * Scratchpad entry creation input
+ */
+export const ScratchpadEntryCreateSchema = ScratchpadEntrySchema.omit({
+    id: true,
+    sessionId: true,
+    createdAt: true,
+    updatedAt: true
+}).partial({
+    tags: true,
+    metadata: true,
+    expiresAt: true
+});
+/**
+ * Scratchpad entry update input
+ */
+export const ScratchpadEntryUpdateSchema = ScratchpadEntrySchema.partial()
+    .omit({ id: true, sessionId: true, key: true, createdAt: true })
+    .extend({
+    updatedAt: z.date().optional()
+});
+/**
+ * Scratchpad filters for queries
+ */
+export const ScratchpadFiltersSchema = z.object({
+    contentType: ScratchpadContentTypeSchema.optional(),
+    tags: z.array(z.string()).optional(),
+    search: z.string().optional(), // FTS search in content
+    expired: z.boolean().optional(), // Include expired entries
+    limit: z.number().int().positive().optional(),
+    offset: z.number().int().nonnegative().optional()
+});
+/**
+ * Scratchpad summary (for listings)
+ */
+export const ScratchpadSummarySchema = ScratchpadEntrySchema.pick({
+    id: true,
+    key: true,
+    contentType: true,
+    language: true,
+    tags: true,
+    expiresAt: true,
+    createdAt: true,
+    updatedAt: true
+}).extend({
+    contentLength: z.number().int().nonnegative(),
+    preview: z.string().max(200) // First 200 chars of content
+});
+//# sourceMappingURL=scratchpad.js.map