@steventsao/agent-session-core 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @steventsao/agent-session-core
+ *
+ * Shared types and protocol for agent-session.
+ * Used by both client and server packages.
+ */
+export * from './socket-events';
+export * from './types';
+//# 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;;;;;GAKG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**
+ * @steventsao/agent-session-core
+ *
+ * Shared types and protocol for agent-session.
+ * Used by both client and server packages.
+ */
+export * from './socket-events';
+export * from './types';
+//# 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;;;;;GAKG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC"}

package/dist/socket-events.d.ts

@@ -0,0 +1,493 @@
+/**
+ * Centralized WebSocket Events
+ *
+ * Single source of truth for all socket event types used across:
+ * - SessionSocket Durable Object (Cloudflare Worker)
+ * - Client applications (React, etc.)
+ * - E2B sandbox communication
+ */
+import { z } from 'zod';
+export declare const ClientEventType: {
+    readonly INIT: "INIT";
+    readonly PING: "PING";
+    readonly START_SANDBOX: "START_SANDBOX";
+    readonly STOP_SANDBOX: "STOP_SANDBOX";
+    readonly EXEC: "EXEC";
+    readonly AGENT_MESSAGE: "AGENT_MESSAGE";
+    readonly AGENT_STOP: "AGENT_STOP";
+    readonly AGENT_RESET: "AGENT_RESET";
+};
+export type ClientEventType = (typeof ClientEventType)[keyof typeof ClientEventType];
+export declare const ServerEventType: {
+    readonly CONNECTED: "CONNECTED";
+    readonly READY: "READY";
+    readonly PONG: "PONG";
+    readonly SANDBOX_STATUS: "SANDBOX_STATUS";
+    readonly LIFECYCLE: "LIFECYCLE";
+    readonly TERM_DATA: "TERM_DATA";
+    readonly EXEC_COMPLETE: "EXEC_COMPLETE";
+    readonly SYSTEM: "SYSTEM";
+    readonly ERROR: "ERROR";
+    readonly AGENT_STARTED: "AGENT_STARTED";
+    readonly AGENT_MESSAGE: "AGENT_MESSAGE";
+    readonly AGENT_ACTION: "AGENT_ACTION";
+    readonly AGENT_STEP_COMPLETE: "AGENT_STEP_COMPLETE";
+    readonly AGENT_DONE: "AGENT_DONE";
+    readonly AGENT_ERROR: "AGENT_ERROR";
+    readonly AGENT_EVENT: "AGENT_EVENT";
+};
+export type ServerEventType = (typeof ServerEventType)[keyof typeof ServerEventType];
+export declare const SandboxStatus: {
+    readonly IDLE: "idle";
+    readonly BOOTING: "booting";
+    readonly READY: "ready";
+    readonly ERROR: "error";
+};
+export type SandboxStatus = (typeof SandboxStatus)[keyof typeof SandboxStatus];
+/**
+ * Granular lifecycle phases for UI loading states
+ * Common lifecycle events across different app types:
+ * - idle: No sandbox running
+ * - booting: Creating sandbox instance
+ * - environment_ready: Sandbox created, basic environment up
+ * - files_ready: App files synced/loaded (for app builders)
+ * - installing: Installing dependencies
+ * - starting: Starting services (dev server, etc.)
+ * - interaction_ready: Ready for user interaction (agent can respond)
+ * - ready: Fully ready (deprecated alias for interaction_ready)
+ * - error: Something went wrong
+ */
+export declare const SandboxLifecycle: {
+    readonly IDLE: "idle";
+    readonly BOOTING: "booting";
+    readonly ENVIRONMENT_READY: "environment_ready";
+    readonly FILES_READY: "files_ready";
+    readonly INSTALLING: "installing";
+    readonly STARTING: "starting";
+    readonly INTERACTION_READY: "interaction_ready";
+    readonly READY: "ready";
+    readonly ERROR: "error";
+};
+export type SandboxLifecycle = (typeof SandboxLifecycle)[keyof typeof SandboxLifecycle];
+/**
+ * Parse SYSTEM message to SandboxLifecycle phase
+ */
+export declare function parseSystemMessageToLifecycle(msg: string): SandboxLifecycle | null;
+export interface InitEvent {
+    type: 'INIT';
+    userId?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface PingEvent {
+    type: 'PING';
+}
+export interface StartSandboxEvent {
+    type: 'START_SANDBOX';
+    template?: string;
+}
+export interface StopSandboxEvent {
+    type: 'STOP_SANDBOX';
+}
+export interface ExecEvent {
+    type: 'EXEC';
+    cmd: string;
+    cwd?: string;
+}
+export interface AgentMessageClientEvent {
+    type: 'AGENT_MESSAGE';
+    content: string;
+    model?: {
+        id: string;
+        provider?: string;
+    };
+    config?: {
+        temperature?: number;
+        maxTokens?: number;
+    };
+    systemPrompt?: string;
+    agentType?: string;
+}
+export interface AgentStopEvent {
+    type: 'AGENT_STOP';
+}
+export interface AgentResetEvent {
+    type: 'AGENT_RESET';
+}
+export type ClientEvent = InitEvent | PingEvent | StartSandboxEvent | StopSandboxEvent | ExecEvent | AgentMessageClientEvent | AgentStopEvent | AgentResetEvent;
+export interface ConnectedServerEvent {
+    type: 'CONNECTED';
+    clientId: string;
+    sessionId: string;
+}
+export interface ReadyServerEvent {
+    type: 'READY';
+    sandboxId: string | null;
+    sandboxUrl: string | null;
+}
+export interface PongServerEvent {
+    type: 'PONG';
+    timestamp: number;
+}
+export interface SandboxStatusServerEvent {
+    type: 'SANDBOX_STATUS';
+    status: 'idle' | 'booting' | 'ready' | 'error';
+    sandboxId?: string;
+    sandboxUrl?: string;
+    error?: string;
+}
+/**
+ * Lifecycle event - granular phase transitions
+ * Use for loading UI states and progress indicators
+ */
+export interface LifecycleServerEvent {
+    type: 'LIFECYCLE';
+    phase: SandboxLifecycle;
+    message?: string;
+    progress?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface TermDataServerEvent {
+    type: 'TERM_DATA';
+    data: string;
+    stream: 'stdout' | 'stderr';
+}
+export interface ExecCompleteServerEvent {
+    type: 'EXEC_COMPLETE';
+    exitCode: number;
+}
+export interface SystemServerEvent {
+    type: 'SYSTEM';
+    msg: string;
+}
+export interface ErrorServerEvent {
+    type: 'ERROR';
+    msg: string;
+    code?: string;
+}
+export interface AgentStartedServerEvent {
+    type: 'AGENT_STARTED';
+    prompt?: string;
+}
+export interface TextContentBlock {
+    type: 'text';
+    text: string;
+}
+export interface ToolUseContentBlock {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+export interface ToolResultContentBlock {
+    type: 'tool_result';
+    tool_use_id: string;
+    content: string | null;
+    is_error?: boolean;
+}
+export type ContentBlock = TextContentBlock | ToolUseContentBlock | ToolResultContentBlock;
+export interface AgentMessageServerEvent {
+    type: 'AGENT_MESSAGE';
+    message?: {
+        content: ContentBlock[];
+    };
+    subtype?: string;
+    total_cost_usd?: number | null;
+    duration_ms?: number | null;
+    result?: string | null;
+}
+export interface AgentActionServerEvent {
+    type: 'AGENT_ACTION';
+    action: string;
+    id?: string;
+    input?: unknown;
+    status: 'executing' | 'complete' | 'error';
+    result?: string;
+    error?: string;
+}
+export interface AgentStepCompleteServerEvent {
+    type: 'AGENT_STEP_COMPLETE';
+    success?: boolean;
+    cost?: number;
+    duration?: number;
+}
+export interface AgentDoneServerEvent {
+    type: 'AGENT_DONE';
+    exitCode?: number;
+    sessionId?: string;
+}
+export interface AgentErrorServerEvent {
+    type: 'AGENT_ERROR';
+    error: string;
+}
+export interface AgentGenericServerEvent {
+    type: 'AGENT_EVENT';
+    [key: string]: unknown;
+}
+export type ServerEvent = ConnectedServerEvent | ReadyServerEvent | PongServerEvent | SandboxStatusServerEvent | LifecycleServerEvent | TermDataServerEvent | ExecCompleteServerEvent | SystemServerEvent | ErrorServerEvent | AgentStartedServerEvent | AgentMessageServerEvent | AgentActionServerEvent | AgentStepCompleteServerEvent | AgentDoneServerEvent | AgentErrorServerEvent | AgentGenericServerEvent;
+export declare const ToolUseBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"tool_use">;
+    name: z.ZodString;
+    input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: "tool_use";
+    name: string;
+    input?: Record<string, unknown> | undefined;
+}, {
+    type: "tool_use";
+    name: string;
+    input?: Record<string, unknown> | undefined;
+}>;
+export declare const TextBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    type: "text";
+}, {
+    text: string;
+    type: "text";
+}>;
+export declare const ContentBlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"tool_use">;
+    name: z.ZodString;
+    input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    type: "tool_use";
+    name: string;
+    input?: Record<string, unknown> | undefined;
+}, {
+    type: "tool_use";
+    name: string;
+    input?: Record<string, unknown> | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    type: "text";
+}, {
+    text: string;
+    type: "text";
+}>]>;
+export declare const AssistantMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"assistant">;
+    message: z.ZodObject<{
+        content: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"tool_use">;
+            name: z.ZodString;
+            input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            type: "tool_use";
+            name: string;
+            input?: Record<string, unknown> | undefined;
+        }, {
+            type: "tool_use";
+            name: string;
+            input?: Record<string, unknown> | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            text: string;
+            type: "text";
+        }, {
+            text: string;
+            type: "text";
+        }>]>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        content: ({
+            type: "tool_use";
+            name: string;
+            input?: Record<string, unknown> | undefined;
+        } | {
+            text: string;
+            type: "text";
+        })[];
+    }, {
+        content: ({
+            type: "tool_use";
+            name: string;
+            input?: Record<string, unknown> | undefined;
+        } | {
+            text: string;
+            type: "text";
+        })[];
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "assistant";
+    message: {
+        content: ({
+            type: "tool_use";
+            name: string;
+            input?: Record<string, unknown> | undefined;
+        } | {
+            text: string;
+            type: "text";
+        })[];
+    };
+}, {
+    type: "assistant";
+    message: {
+        content: ({
+            type: "tool_use";
+            name: string;
+            input?: Record<string, unknown> | undefined;
+        } | {
+            text: string;
+            type: "text";
+        })[];
+    };
+}>;
+export declare const ResultMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"result">;
+    session_id: z.ZodOptional<z.ZodString>;
+    total_cost_usd: z.ZodOptional<z.ZodNumber>;
+    duration_ms: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "result";
+    session_id?: string | undefined;
+    total_cost_usd?: number | undefined;
+    duration_ms?: number | undefined;
+}, {
+    type: "result";
+    session_id?: string | undefined;
+    total_cost_usd?: number | undefined;
+    duration_ms?: number | undefined;
+}>;
+export declare const ErrorMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    error: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    error: string;
+    type: "error";
+}, {
+    error: string;
+    type: "error";
+}>;
+export declare const SystemMessageSchema: z.ZodObject<{
+    type: z.ZodLiteral<"system">;
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "system";
+    message: string;
+}, {
+    type: "system";
+    message: string;
+}>;
+export declare const AgentOutputMessageSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"assistant">;
+    message: z.ZodObject<{
+        content: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+            type: z.ZodLiteral<"tool_use">;
+            name: z.ZodString;
+            input: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            type: "tool_use";
+            name: string;
+            input?: Record<string, unknown> | undefined;
+        }, {
+            type: "tool_use";
+            name: string;
+            input?: Record<string, unknown> | undefined;
+        }>, z.ZodObject<{
+            type: z.ZodLiteral<"text">;
+            text: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            text: string;
+            type: "text";
+        }, {
+            text: string;
+            type: "text";
+        }>]>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        content: ({
+            type: "tool_use";
+            name: string;
+            input?: Record<string, unknown> | undefined;
+        } | {
+            text: string;
+            type: "text";
+        })[];
+    }, {
+        content: ({
+            type: "tool_use";
+            name: string;
+            input?: Record<string, unknown> | undefined;
+        } | {
+            text: string;
+            type: "text";
+        })[];
+    }>;
+}, "strip", z.ZodTypeAny, {
+    type: "assistant";
+    message: {
+        content: ({
+            type: "tool_use";
+            name: string;
+            input?: Record<string, unknown> | undefined;
+        } | {
+            text: string;
+            type: "text";
+        })[];
+    };
+}, {
+    type: "assistant";
+    message: {
+        content: ({
+            type: "tool_use";
+            name: string;
+            input?: Record<string, unknown> | undefined;
+        } | {
+            text: string;
+            type: "text";
+        })[];
+    };
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"result">;
+    session_id: z.ZodOptional<z.ZodString>;
+    total_cost_usd: z.ZodOptional<z.ZodNumber>;
+    duration_ms: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type: "result";
+    session_id?: string | undefined;
+    total_cost_usd?: number | undefined;
+    duration_ms?: number | undefined;
+}, {
+    type: "result";
+    session_id?: string | undefined;
+    total_cost_usd?: number | undefined;
+    duration_ms?: number | undefined;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"error">;
+    error: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    error: string;
+    type: "error";
+}, {
+    error: string;
+    type: "error";
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"system">;
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "system";
+    message: string;
+}, {
+    type: "system";
+    message: string;
+}>]>;
+export type ToolUseBlock = z.infer<typeof ToolUseBlockSchema>;
+export type TextBlock = z.infer<typeof TextBlockSchema>;
+export type AgentContentBlock = z.infer<typeof ContentBlockSchema>;
+export type AssistantMessage = z.infer<typeof AssistantMessageSchema>;
+export type ResultMessage = z.infer<typeof ResultMessageSchema>;
+export type ErrorMessage = z.infer<typeof ErrorMessageSchema>;
+export type SystemMessage = z.infer<typeof SystemMessageSchema>;
+export type AgentOutputMessage = z.infer<typeof AgentOutputMessageSchema>;
+export declare function parseAgentOutputMessage(line: string): AgentOutputMessage | null;
+export declare function isClientEvent(data: unknown): data is ClientEvent;
+export declare function isServerEvent(data: unknown): data is ServerEvent;
+export declare function parseServerEvent(json: string): ServerEvent | null;
+export declare function parseClientEvent(json: string): ClientEvent | null;
+export type ClientMessage = ClientEvent;
+//# sourceMappingURL=socket-events.d.ts.map

package/dist/socket-events.d.ts.map

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

package/dist/socket-events.js

@@ -0,0 +1,203 @@
+/**
+ * Centralized WebSocket Events
+ *
+ * Single source of truth for all socket event types used across:
+ * - SessionSocket Durable Object (Cloudflare Worker)
+ * - Client applications (React, etc.)
+ * - E2B sandbox communication
+ */
+import { z } from 'zod';
+// =============================================================================
+// Client → Server Events (Commands)
+// =============================================================================
+export const ClientEventType = {
+    // Session
+    INIT: 'INIT',
+    PING: 'PING',
+    // Sandbox lifecycle
+    START_SANDBOX: 'START_SANDBOX',
+    STOP_SANDBOX: 'STOP_SANDBOX',
+    // Command execution
+    EXEC: 'EXEC',
+    // Agent
+    AGENT_MESSAGE: 'AGENT_MESSAGE',
+    AGENT_STOP: 'AGENT_STOP',
+    AGENT_RESET: 'AGENT_RESET',
+};
+// =============================================================================
+// Server → Client Events
+// =============================================================================
+export const ServerEventType = {
+    // Connection
+    CONNECTED: 'CONNECTED',
+    READY: 'READY',
+    PONG: 'PONG',
+    // Sandbox status
+    SANDBOX_STATUS: 'SANDBOX_STATUS',
+    // Lifecycle events (granular phases)
+    LIFECYCLE: 'LIFECYCLE',
+    // Terminal
+    TERM_DATA: 'TERM_DATA',
+    EXEC_COMPLETE: 'EXEC_COMPLETE',
+    // System messages
+    SYSTEM: 'SYSTEM',
+    ERROR: 'ERROR',
+    // Agent events
+    AGENT_STARTED: 'AGENT_STARTED',
+    AGENT_MESSAGE: 'AGENT_MESSAGE',
+    AGENT_ACTION: 'AGENT_ACTION',
+    AGENT_STEP_COMPLETE: 'AGENT_STEP_COMPLETE',
+    AGENT_DONE: 'AGENT_DONE',
+    AGENT_ERROR: 'AGENT_ERROR',
+    AGENT_EVENT: 'AGENT_EVENT',
+};
+// =============================================================================
+// Common Enums
+// =============================================================================
+export const SandboxStatus = {
+    IDLE: 'idle',
+    BOOTING: 'booting',
+    READY: 'ready',
+    ERROR: 'error',
+};
+/**
+ * Granular lifecycle phases for UI loading states
+ * Common lifecycle events across different app types:
+ * - idle: No sandbox running
+ * - booting: Creating sandbox instance
+ * - environment_ready: Sandbox created, basic environment up
+ * - files_ready: App files synced/loaded (for app builders)
+ * - installing: Installing dependencies
+ * - starting: Starting services (dev server, etc.)
+ * - interaction_ready: Ready for user interaction (agent can respond)
+ * - ready: Fully ready (deprecated alias for interaction_ready)
+ * - error: Something went wrong
+ */
+export const SandboxLifecycle = {
+    IDLE: 'idle',
+    BOOTING: 'booting',
+    ENVIRONMENT_READY: 'environment_ready',
+    FILES_READY: 'files_ready',
+    INSTALLING: 'installing',
+    STARTING: 'starting',
+    INTERACTION_READY: 'interaction_ready',
+    READY: 'ready', // alias for backwards compat
+    ERROR: 'error',
+};
+/**
+ * Parse SYSTEM message to SandboxLifecycle phase
+ */
+export function parseSystemMessageToLifecycle(msg) {
+    const lowerMsg = msg.toLowerCase();
+    if (lowerMsg.includes('booting'))
+        return SandboxLifecycle.BOOTING;
+    if (lowerMsg.includes('environment ready'))
+        return SandboxLifecycle.ENVIRONMENT_READY;
+    if (lowerMsg.includes('files ready') || lowerMsg.includes('files loaded') || lowerMsg.includes('restored'))
+        return SandboxLifecycle.FILES_READY;
+    if (lowerMsg.includes('installing'))
+        return SandboxLifecycle.INSTALLING;
+    if (lowerMsg.includes('starting'))
+        return SandboxLifecycle.STARTING;
+    if (lowerMsg.includes('interaction ready') || lowerMsg.includes('agent ready'))
+        return SandboxLifecycle.INTERACTION_READY;
+    if (lowerMsg.includes('ready'))
+        return SandboxLifecycle.READY;
+    if (lowerMsg.includes('error'))
+        return SandboxLifecycle.ERROR;
+    return null;
+}
+// =============================================================================
+// Zod Schemas (Runtime Validation)
+// =============================================================================
+export const ToolUseBlockSchema = z.object({
+    type: z.literal('tool_use'),
+    name: z.string(),
+    input: z.record(z.unknown()).optional(),
+});
+export const TextBlockSchema = z.object({
+    type: z.literal('text'),
+    text: z.string(),
+});
+export const ContentBlockSchema = z.discriminatedUnion('type', [
+    ToolUseBlockSchema,
+    TextBlockSchema,
+]);
+export const AssistantMessageSchema = z.object({
+    type: z.literal('assistant'),
+    message: z.object({
+        content: z.array(ContentBlockSchema),
+    }),
+});
+export const ResultMessageSchema = z.object({
+    type: z.literal('result'),
+    session_id: z.string().optional(),
+    total_cost_usd: z.number().optional(),
+    duration_ms: z.number().optional(),
+});
+export const ErrorMessageSchema = z.object({
+    type: z.literal('error'),
+    error: z.string(),
+});
+export const SystemMessageSchema = z.object({
+    type: z.literal('system'),
+    message: z.string(),
+});
+export const AgentOutputMessageSchema = z.discriminatedUnion('type', [
+    AssistantMessageSchema,
+    ResultMessageSchema,
+    ErrorMessageSchema,
+    SystemMessageSchema,
+]);
+export function parseAgentOutputMessage(line) {
+    if (!line.trim())
+        return null;
+    try {
+        const json = JSON.parse(line);
+        const result = AgentOutputMessageSchema.safeParse(json);
+        return result.success ? result.data : null;
+    }
+    catch {
+        return null;
+    }
+}
+// =============================================================================
+// Type Guards
+// =============================================================================
+const CLIENT_EVENT_TYPES = new Set(Object.values(ClientEventType));
+const SERVER_EVENT_TYPES = new Set(Object.values(ServerEventType));
+export function isClientEvent(data) {
+    if (!data || typeof data !== 'object')
+        return false;
+    const maybeEvent = data;
+    return typeof maybeEvent.type === 'string' && CLIENT_EVENT_TYPES.has(maybeEvent.type);
+}
+export function isServerEvent(data) {
+    if (!data || typeof data !== 'object')
+        return false;
+    const maybeEvent = data;
+    return typeof maybeEvent.type === 'string' && SERVER_EVENT_TYPES.has(maybeEvent.type);
+}
+export function parseServerEvent(json) {
+    try {
+        const parsed = JSON.parse(json);
+        if (isServerEvent(parsed))
+            return parsed;
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+export function parseClientEvent(json) {
+    try {
+        const parsed = JSON.parse(json);
+        if (isClientEvent(parsed))
+            return parsed;
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=socket-events.js.map

package/dist/socket-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-events.js","sourceRoot":"","sources":["../src/socket-events.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gFAAgF;AAChF,oCAAoC;AACpC,gFAAgF;AAEhF,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,UAAU;IACV,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IAEZ,oBAAoB;IACpB,aAAa,EAAE,eAAe;IAC9B,YAAY,EAAE,cAAc;IAE5B,oBAAoB;IACpB,IAAI,EAAE,MAAM;IAEZ,QAAQ;IACR,aAAa,EAAE,eAAe;IAC9B,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;CAClB,CAAC;AAIX,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,aAAa;IACb,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IAEZ,iBAAiB;IACjB,cAAc,EAAE,gBAAgB;IAEhC,qCAAqC;IACrC,SAAS,EAAE,WAAW;IAEtB,WAAW;IACX,SAAS,EAAE,WAAW;IACtB,aAAa,EAAE,eAAe;IAE9B,kBAAkB;IAClB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IAEd,eAAe;IACf,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,eAAe;IAC9B,YAAY,EAAE,cAAc;IAC5B,mBAAmB,EAAE,qBAAqB;IAC1C,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,aAAa;CAClB,CAAC;AAIX,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;CACN,CAAC;AAIX;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,iBAAiB,EAAE,mBAAmB;IACtC,WAAW,EAAE,aAAa;IAC1B,UAAU,EAAE,YAAY;IACxB,QAAQ,EAAE,UAAU;IACpB,iBAAiB,EAAE,mBAAmB;IACtC,KAAK,EAAE,OAAO,EAAE,6BAA6B;IAC7C,KAAK,EAAE,OAAO;CACN,CAAC;AAIX;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAAC,GAAW;IACvD,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IACnC,IAAI,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,gBAAgB,CAAC,OAAO,CAAC;IAClE,IAAI,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAAE,OAAO,gBAAgB,CAAC,iBAAiB,CAAC;IACtF,IAAI,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,gBAAgB,CAAC,WAAW,CAAC;IAChJ,IAAI,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,gBAAgB,CAAC,UAAU,CAAC;IACxE,IAAI,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,gBAAgB,CAAC,QAAQ,CAAC;IACpE,IAAI,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC;QAAE,OAAO,gBAAgB,CAAC,iBAAiB,CAAC;IAC1H,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,gBAAgB,CAAC,KAAK,CAAC;IAC9D,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,gBAAgB,CAAC,KAAK,CAAC;IAC9D,OAAO,IAAI,CAAC;AACd,CAAC;AAyND,gFAAgF;AAChF,mCAAmC;AACnC,gFAAgF;AAEhF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC7D,kBAAkB;IAClB,eAAe;CAChB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IAC5B,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC;KACrC,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACzB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IACxB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACzB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACnE,sBAAsB;IACtB,mBAAmB;IACnB,kBAAkB;IAClB,mBAAmB;CACpB,CAAC,CAAC;AAWH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACxD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;AACnE,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;AAEnE,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACpD,MAAM,UAAU,GAAG,IAA0B,CAAC;IAC9C,OAAO,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,IAAI,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAuB,CAAC,CAAC;AAC3G,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACpD,MAAM,UAAU,GAAG,IAA0B,CAAC;IAC9C,OAAO,OAAO,UAAU,CAAC,IAAI,KAAK,QAAQ,IAAI,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,IAAuB,CAAC,CAAC;AAC3G,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,aAAa,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,aAAa,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Shared types for agent-session
+ */
+export interface SocketAttachment {
+    clientId: string;
+    userId?: string;
+    connectedAt: number;
+}
+export interface SessionState {
+    sessionId: string;
+    sandboxId?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Configuration for connecting to agent-session
+ */
+export interface AgentSessionConfig {
+    /** WebSocket URL of the deployed worker */
+    url: string;
+    /** Session ID for this connection */
+    sessionId: string;
+    /** Optional user ID for tracking */
+    userId?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Shared types for agent-session
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@steventsao/agent-session-core",
+  "version": "0.1.0",
+  "description": "Shared types and protocol for agent-session",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "license": "MIT"
+}