intent-hub 0.1.0

package/packages/shared/dist/types/domain.d.ts

@@ -0,0 +1,50 @@
+export interface SemanticDomain {
+    id: string;
+    name: string;
+    description?: string;
+    parentId?: string;
+    affectedPaths: string[];
+    relatedDomains: string[];
+}
+export interface DomainLock {
+    domainId: string;
+    intentId: string;
+    userId: string;
+    username: string;
+    acquiredAt: number;
+    expiresAt?: number;
+    status: LockStatus;
+}
+export type LockStatus = 'active' | 'pending' | 'released';
+export interface DomainMap {
+    projectId: string;
+    domains: SemanticDomain[];
+    updatedAt: number;
+}
+export interface Conflict {
+    id: string;
+    domains: string[];
+    intents: string[];
+    users: string[];
+    detectedAt: number;
+    status: ConflictStatus;
+    resolution?: ConflictResolution;
+}
+export type ConflictStatus = 'detected' | 'negotiating' | 'escalated' | 'resolved';
+export interface ConflictResolution {
+    type: 'auto' | 'user';
+    plan: ExecutionPlan;
+    decidedAt: number;
+    decidedBy?: string;
+}
+export interface ExecutionPlan {
+    phases: ExecutionPhase[];
+}
+export interface ExecutionPhase {
+    order: number;
+    intentId: string;
+    userId: string;
+    domains: string[];
+    dependsOn?: string[];
+}
+//# sourceMappingURL=domain.d.ts.map

package/packages/shared/dist/types/domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../src/types/domain.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAE3D,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,CAAC,EAAE,kBAAkB,CAAC;CACjC;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,CAAC;AAEnF,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB"}

package/packages/shared/dist/types/index.d.ts

@@ -0,0 +1,4 @@
+export * from './intent.js';
+export * from './domain.js';
+export * from './message.js';
+//# sourceMappingURL=index.d.ts.map

package/packages/shared/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC"}

package/packages/shared/dist/types/intent.d.ts

@@ -0,0 +1,24 @@
+export interface Intent {
+    id: string;
+    userId: string;
+    username: string;
+    prompt: string;
+    timestamp: number;
+    analysis?: IntentAnalysis;
+    status: IntentStatus;
+}
+export interface IntentAnalysis {
+    domain: string;
+    subdomain?: string;
+    affectedFiles: string[];
+    semanticTags: string[];
+    estimatedScope: 'small' | 'medium' | 'large';
+    dependencies: string[];
+}
+export type IntentStatus = 'pending' | 'analyzing' | 'ready' | 'blocked' | 'negotiating' | 'executing' | 'completed' | 'cancelled';
+export interface IntentSubmission {
+    prompt: string;
+    userId: string;
+    username: string;
+}
+//# sourceMappingURL=intent.d.ts.map

package/packages/shared/dist/types/intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../src/types/intent.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC7C,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,WAAW,GACX,OAAO,GACP,SAAS,GACT,aAAa,GACb,WAAW,GACX,WAAW,GACX,WAAW,CAAC;AAEhB,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/packages/shared/dist/types/message.d.ts

@@ -0,0 +1,151 @@
+export interface BaseMessage {
+    type: string;
+    timestamp: number;
+    messageId: string;
+}
+export interface AgentConnectMessage extends BaseMessage {
+    type: 'agent:connect';
+    payload: {
+        userId: string;
+        username: string;
+        projectPath: string;
+    };
+}
+export interface AgentIntentSubmitMessage extends BaseMessage {
+    type: 'agent:intent:submit';
+    payload: {
+        prompt: string;
+    };
+}
+export interface AgentDecisionMessage extends BaseMessage {
+    type: 'agent:decision';
+    payload: {
+        conflictId: string;
+        choice: string;
+    };
+}
+export interface AgentHeartbeatMessage extends BaseMessage {
+    type: 'agent:heartbeat';
+}
+export type AgentMessage = AgentConnectMessage | AgentIntentSubmitMessage | AgentDecisionMessage | AgentHeartbeatMessage;
+export interface HubConnectedMessage extends BaseMessage {
+    type: 'hub:connected';
+    payload: {
+        sessionId: string;
+        activeLocks: Array<{
+            domainId: string;
+            username: string;
+        }>;
+    };
+}
+export interface HubIntentReceivedMessage extends BaseMessage {
+    type: 'hub:intent:received';
+    payload: {
+        intentId: string;
+    };
+}
+export interface HubIntentAnalyzedMessage extends BaseMessage {
+    type: 'hub:intent:analyzed';
+    payload: {
+        intentId: string;
+        analysis: {
+            domain: string;
+            subdomain?: string;
+            affectedFiles: string[];
+            semanticTags: string[];
+        };
+    };
+}
+export interface HubLockAcquiredMessage extends BaseMessage {
+    type: 'hub:lock:acquired';
+    payload: {
+        intentId: string;
+        domains: string[];
+    };
+}
+export interface HubLockBlockedMessage extends BaseMessage {
+    type: 'hub:lock:blocked';
+    payload: {
+        intentId: string;
+        blockedBy: Array<{
+            domain: string;
+            username: string;
+            intentSummary: string;
+        }>;
+    };
+}
+export interface HubNegotiationStartMessage extends BaseMessage {
+    type: 'hub:negotiation:start';
+    payload: {
+        conflictId: string;
+        participants: string[];
+        domains: string[];
+    };
+}
+export interface HubNegotiationProposalMessage extends BaseMessage {
+    type: 'hub:negotiation:proposal';
+    payload: {
+        conflictId: string;
+        fromUser: string;
+        proposal: string;
+    };
+}
+export interface HubNegotiationResolvedMessage extends BaseMessage {
+    type: 'hub:negotiation:resolved';
+    payload: {
+        conflictId: string;
+        resolution: {
+            type: 'auto' | 'user';
+            summary: string;
+            yourPhase: number;
+        };
+    };
+}
+export interface HubDecisionRequiredMessage extends BaseMessage {
+    type: 'hub:decision:required';
+    payload: {
+        conflictId: string;
+        question: string;
+        options: Array<{
+            id: string;
+            description: string;
+            proposedBy: string;
+        }>;
+    };
+}
+export interface HubErrorMessage extends BaseMessage {
+    type: 'hub:error';
+    payload: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+}
+export type HubMessage = HubConnectedMessage | HubIntentReceivedMessage | HubIntentAnalyzedMessage | HubLockAcquiredMessage | HubLockBlockedMessage | HubNegotiationStartMessage | HubNegotiationProposalMessage | HubNegotiationResolvedMessage | HubDecisionRequiredMessage | HubErrorMessage;
+export interface BroadcastLockUpdateMessage extends BaseMessage {
+    type: 'broadcast:lock:update';
+    payload: {
+        locks: Array<{
+            domainId: string;
+            username: string;
+            intentSummary: string;
+        }>;
+    };
+}
+export interface BroadcastUserJoinedMessage extends BaseMessage {
+    type: 'broadcast:user:joined';
+    payload: {
+        userId: string;
+        username: string;
+    };
+}
+export interface BroadcastUserLeftMessage extends BaseMessage {
+    type: 'broadcast:user:left';
+    payload: {
+        userId: string;
+        username: string;
+    };
+}
+export type BroadcastMessage = BroadcastLockUpdateMessage | BroadcastUserJoinedMessage | BroadcastUserLeftMessage;
+export type Message = AgentMessage | HubMessage | BroadcastMessage;
+//# sourceMappingURL=message.d.ts.map

package/packages/shared/dist/types/message.d.ts.map

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

package/packages/shared/dist/utils/id.d.ts

@@ -0,0 +1,6 @@
+export declare function generateId(): string;
+export declare function generateMessageId(): string;
+export declare function generateIntentId(): string;
+export declare function generateConflictId(): string;
+export declare function generateSessionId(): string;
+//# sourceMappingURL=id.d.ts.map

package/packages/shared/dist/utils/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C"}

package/packages/shared/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './id.js';
+export * from './message.js';
+//# sourceMappingURL=index.d.ts.map

package/packages/shared/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC"}

package/packages/shared/dist/utils/message.d.ts

@@ -0,0 +1,5 @@
+import type { BaseMessage } from '../types/message.js';
+export declare function createMessage<T extends BaseMessage>(type: T['type'], payload: Omit<T, 'type' | 'timestamp' | 'messageId'>): T;
+export declare function parseMessage(data: string): BaseMessage | null;
+export declare function serializeMessage(message: BaseMessage): string;
+//# sourceMappingURL=message.d.ts.map

package/packages/shared/dist/utils/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/utils/message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,wBAAgB,aAAa,CAAC,CAAC,SAAS,WAAW,EACjD,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EACf,OAAO,EAAE,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,WAAW,CAAC,GACnD,CAAC,CAOH;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAU7D;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAE7D"}

package/packages/shared/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@anthropic-for-korea/intent-hub-shared",
+  "version": "0.1.0",
+  "description": "Shared types and utilities for Intent Hub",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target node && tsc --emitDeclarationOnly",
+    "dev": "bun build ./src/index.ts --outdir ./dist --target node --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/anthropic-for-korea/intent-hub.git",
+    "directory": "packages/shared"
+  },
+  "license": "MIT",
+  "keywords": ["intent-hub", "llm", "ai", "coordination"]
+}

package/packages/shared/src/index.ts

@@ -0,0 +1,2 @@
+export * from './types/index.js';
+export * from './utils/index.js';

package/packages/shared/src/types/domain.ts

@@ -0,0 +1,57 @@
+export interface SemanticDomain {
+  id: string;
+  name: string;
+  description?: string;
+  parentId?: string;
+  affectedPaths: string[];
+  relatedDomains: string[];
+}
+
+export interface DomainLock {
+  domainId: string;
+  intentId: string;
+  userId: string;
+  username: string;
+  acquiredAt: number;
+  expiresAt?: number;
+  status: LockStatus;
+}
+
+export type LockStatus = 'active' | 'pending' | 'released';
+
+export interface DomainMap {
+  projectId: string;
+  domains: SemanticDomain[];
+  updatedAt: number;
+}
+
+export interface Conflict {
+  id: string;
+  domains: string[];
+  intents: string[];
+  users: string[];
+  detectedAt: number;
+  status: ConflictStatus;
+  resolution?: ConflictResolution;
+}
+
+export type ConflictStatus = 'detected' | 'negotiating' | 'escalated' | 'resolved';
+
+export interface ConflictResolution {
+  type: 'auto' | 'user';
+  plan: ExecutionPlan;
+  decidedAt: number;
+  decidedBy?: string;
+}
+
+export interface ExecutionPlan {
+  phases: ExecutionPhase[];
+}
+
+export interface ExecutionPhase {
+  order: number;
+  intentId: string;
+  userId: string;
+  domains: string[];
+  dependsOn?: string[];
+}

package/packages/shared/src/types/index.ts

@@ -0,0 +1,3 @@
+export * from './intent.js';
+export * from './domain.js';
+export * from './message.js';

package/packages/shared/src/types/intent.ts

@@ -0,0 +1,34 @@
+export interface Intent {
+  id: string;
+  userId: string;
+  username: string;
+  prompt: string;
+  timestamp: number;
+  analysis?: IntentAnalysis;
+  status: IntentStatus;
+}
+
+export interface IntentAnalysis {
+  domain: string;
+  subdomain?: string;
+  affectedFiles: string[];
+  semanticTags: string[];
+  estimatedScope: 'small' | 'medium' | 'large';
+  dependencies: string[];
+}
+
+export type IntentStatus = 
+  | 'pending'
+  | 'analyzing'
+  | 'ready'
+  | 'blocked'
+  | 'negotiating'
+  | 'executing'
+  | 'completed'
+  | 'cancelled';
+
+export interface IntentSubmission {
+  prompt: string;
+  userId: string;
+  username: string;
+}

package/packages/shared/src/types/message.ts

@@ -0,0 +1,188 @@
+export interface BaseMessage {
+  type: string;
+  timestamp: number;
+  messageId: string;
+}
+
+export interface AgentConnectMessage extends BaseMessage {
+  type: 'agent:connect';
+  payload: {
+    userId: string;
+    username: string;
+    projectPath: string;
+  };
+}
+
+export interface AgentIntentSubmitMessage extends BaseMessage {
+  type: 'agent:intent:submit';
+  payload: {
+    prompt: string;
+  };
+}
+
+export interface AgentDecisionMessage extends BaseMessage {
+  type: 'agent:decision';
+  payload: {
+    conflictId: string;
+    choice: string;
+  };
+}
+
+export interface AgentHeartbeatMessage extends BaseMessage {
+  type: 'agent:heartbeat';
+}
+
+export type AgentMessage = 
+  | AgentConnectMessage
+  | AgentIntentSubmitMessage
+  | AgentDecisionMessage
+  | AgentHeartbeatMessage;
+
+export interface HubConnectedMessage extends BaseMessage {
+  type: 'hub:connected';
+  payload: {
+    sessionId: string;
+    activeLocks: Array<{
+      domainId: string;
+      username: string;
+    }>;
+  };
+}
+
+export interface HubIntentReceivedMessage extends BaseMessage {
+  type: 'hub:intent:received';
+  payload: {
+    intentId: string;
+  };
+}
+
+export interface HubIntentAnalyzedMessage extends BaseMessage {
+  type: 'hub:intent:analyzed';
+  payload: {
+    intentId: string;
+    analysis: {
+      domain: string;
+      subdomain?: string;
+      affectedFiles: string[];
+      semanticTags: string[];
+    };
+  };
+}
+
+export interface HubLockAcquiredMessage extends BaseMessage {
+  type: 'hub:lock:acquired';
+  payload: {
+    intentId: string;
+    domains: string[];
+  };
+}
+
+export interface HubLockBlockedMessage extends BaseMessage {
+  type: 'hub:lock:blocked';
+  payload: {
+    intentId: string;
+    blockedBy: Array<{
+      domain: string;
+      username: string;
+      intentSummary: string;
+    }>;
+  };
+}
+
+export interface HubNegotiationStartMessage extends BaseMessage {
+  type: 'hub:negotiation:start';
+  payload: {
+    conflictId: string;
+    participants: string[];
+    domains: string[];
+  };
+}
+
+export interface HubNegotiationProposalMessage extends BaseMessage {
+  type: 'hub:negotiation:proposal';
+  payload: {
+    conflictId: string;
+    fromUser: string;
+    proposal: string;
+  };
+}
+
+export interface HubNegotiationResolvedMessage extends BaseMessage {
+  type: 'hub:negotiation:resolved';
+  payload: {
+    conflictId: string;
+    resolution: {
+      type: 'auto' | 'user';
+      summary: string;
+      yourPhase: number;
+    };
+  };
+}
+
+export interface HubDecisionRequiredMessage extends BaseMessage {
+  type: 'hub:decision:required';
+  payload: {
+    conflictId: string;
+    question: string;
+    options: Array<{
+      id: string;
+      description: string;
+      proposedBy: string;
+    }>;
+  };
+}
+
+export interface HubErrorMessage extends BaseMessage {
+  type: 'hub:error';
+  payload: {
+    code: string;
+    message: string;
+    details?: unknown;
+  };
+}
+
+export type HubMessage = 
+  | HubConnectedMessage
+  | HubIntentReceivedMessage
+  | HubIntentAnalyzedMessage
+  | HubLockAcquiredMessage
+  | HubLockBlockedMessage
+  | HubNegotiationStartMessage
+  | HubNegotiationProposalMessage
+  | HubNegotiationResolvedMessage
+  | HubDecisionRequiredMessage
+  | HubErrorMessage;
+
+export interface BroadcastLockUpdateMessage extends BaseMessage {
+  type: 'broadcast:lock:update';
+  payload: {
+    locks: Array<{
+      domainId: string;
+      username: string;
+      intentSummary: string;
+    }>;
+  };
+}
+
+export interface BroadcastUserJoinedMessage extends BaseMessage {
+  type: 'broadcast:user:joined';
+  payload: {
+    userId: string;
+    username: string;
+  };
+}
+
+export interface BroadcastUserLeftMessage extends BaseMessage {
+  type: 'broadcast:user:left';
+  payload: {
+    userId: string;
+    username: string;
+  };
+}
+
+export type BroadcastMessage = 
+  | BroadcastLockUpdateMessage
+  | BroadcastUserJoinedMessage
+  | BroadcastUserLeftMessage;
+
+export type Message = AgentMessage | HubMessage | BroadcastMessage;

package/packages/shared/src/utils/id.ts

@@ -0,0 +1,21 @@
+import { randomUUID } from 'crypto';
+
+export function generateId(): string {
+  return randomUUID();
+}
+
+export function generateMessageId(): string {
+  return `msg_${randomUUID()}`;
+}
+
+export function generateIntentId(): string {
+  return `int_${randomUUID()}`;
+}
+
+export function generateConflictId(): string {
+  return `cnf_${randomUUID()}`;
+}
+
+export function generateSessionId(): string {
+  return `ses_${randomUUID()}`;
+}

package/packages/shared/src/utils/index.ts

@@ -0,0 +1,2 @@
+export * from './id.js';
+export * from './message.js';

package/packages/shared/src/utils/message.ts

@@ -0,0 +1,30 @@
+import type { BaseMessage } from '../types/message.js';
+import { generateMessageId } from './id.js';
+
+export function createMessage<T extends BaseMessage>(
+  type: T['type'],
+  payload: Omit<T, 'type' | 'timestamp' | 'messageId'>
+): T {
+  return {
+    type,
+    timestamp: Date.now(),
+    messageId: generateMessageId(),
+    ...payload,
+  } as T;
+}
+
+export function parseMessage(data: string): BaseMessage | null {
+  try {
+    const parsed = JSON.parse(data);
+    if (typeof parsed.type === 'string' && typeof parsed.timestamp === 'number') {
+      return parsed as BaseMessage;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+export function serializeMessage(message: BaseMessage): string {
+  return JSON.stringify(message);
+}

package/packages/shared/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}