@locusai/shared 0.11.5 → 0.11.7

package/dist/protocol/host-events.d.ts

@@ -0,0 +1,354 @@
+import { z } from "zod";
+export declare const HostEventType: {
+    readonly SESSION_STATE: "session_state";
+    readonly TEXT_DELTA: "text_delta";
+    readonly TOOL_STARTED: "tool_started";
+    readonly TOOL_COMPLETED: "tool_completed";
+    readonly THINKING: "thinking";
+    readonly ERROR: "error";
+    readonly SESSION_LIST: "session_list";
+    readonly SESSION_COMPLETED: "session_completed";
+};
+export type HostEventType = (typeof HostEventType)[keyof typeof HostEventType];
+export declare const HostEventTypeSchema: z.ZodEnum<{
+    readonly SESSION_STATE: "session_state";
+    readonly TEXT_DELTA: "text_delta";
+    readonly TOOL_STARTED: "tool_started";
+    readonly TOOL_COMPLETED: "tool_completed";
+    readonly THINKING: "thinking";
+    readonly ERROR: "error";
+    readonly SESSION_LIST: "session_list";
+    readonly SESSION_COMPLETED: "session_completed";
+}>;
+export declare const TimelineEntryKind: {
+    readonly MESSAGE: "message";
+    readonly TOOL_CALL: "tool_call";
+    readonly STATUS: "status";
+    readonly ERROR: "error";
+    readonly DONE: "done";
+};
+export type TimelineEntryKind = (typeof TimelineEntryKind)[keyof typeof TimelineEntryKind];
+export declare const TimelineEntryKindSchema: z.ZodEnum<{
+    readonly MESSAGE: "message";
+    readonly TOOL_CALL: "tool_call";
+    readonly STATUS: "status";
+    readonly ERROR: "error";
+    readonly DONE: "done";
+}>;
+export declare const TimelineEntrySchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        readonly MESSAGE: "message";
+        readonly TOOL_CALL: "tool_call";
+        readonly STATUS: "status";
+        readonly ERROR: "error";
+        readonly DONE: "done";
+    }>;
+    timestamp: z.ZodNumber;
+    data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, z.core.$strip>;
+export type TimelineEntry = z.infer<typeof TimelineEntrySchema>;
+export declare const SessionStateEventSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"session_state">;
+    payload: z.ZodObject<{
+        sessionId: z.ZodString;
+        status: z.ZodEnum<{
+            readonly IDLE: "idle";
+            readonly STARTING: "starting";
+            readonly RUNNING: "running";
+            readonly STREAMING: "streaming";
+            readonly COMPLETED: "completed";
+            readonly CANCELED: "canceled";
+            readonly INTERRUPTED: "interrupted";
+            readonly FAILED: "failed";
+            readonly RESUMING: "resuming";
+        }>;
+        metadata: z.ZodOptional<z.ZodObject<{
+            sessionId: z.ZodString;
+            status: z.ZodEnum<{
+                readonly IDLE: "idle";
+                readonly STARTING: "starting";
+                readonly RUNNING: "running";
+                readonly STREAMING: "streaming";
+                readonly COMPLETED: "completed";
+                readonly CANCELED: "canceled";
+                readonly INTERRUPTED: "interrupted";
+                readonly FAILED: "failed";
+                readonly RESUMING: "resuming";
+            }>;
+            model: z.ZodOptional<z.ZodString>;
+            createdAt: z.ZodNumber;
+            updatedAt: z.ZodNumber;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        timeline: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                readonly MESSAGE: "message";
+                readonly TOOL_CALL: "tool_call";
+                readonly STATUS: "status";
+                readonly ERROR: "error";
+                readonly DONE: "done";
+            }>;
+            timestamp: z.ZodNumber;
+            data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type SessionStateEvent = z.infer<typeof SessionStateEventSchema>;
+export declare const TextDeltaEventSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"text_delta">;
+    payload: z.ZodObject<{
+        sessionId: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type TextDeltaEvent = z.infer<typeof TextDeltaEventSchema>;
+export declare const ToolStartedEventSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"tool_started">;
+    payload: z.ZodObject<{
+        sessionId: z.ZodString;
+        tool: z.ZodString;
+        toolId: z.ZodOptional<z.ZodString>;
+        parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ToolStartedEvent = z.infer<typeof ToolStartedEventSchema>;
+export declare const ToolCompletedEventSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"tool_completed">;
+    payload: z.ZodObject<{
+        sessionId: z.ZodString;
+        tool: z.ZodString;
+        toolId: z.ZodOptional<z.ZodString>;
+        result: z.ZodOptional<z.ZodUnknown>;
+        duration: z.ZodOptional<z.ZodNumber>;
+        success: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ToolCompletedEvent = z.infer<typeof ToolCompletedEventSchema>;
+export declare const ThinkingEventSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"thinking">;
+    payload: z.ZodObject<{
+        sessionId: z.ZodString;
+        content: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ThinkingEvent = z.infer<typeof ThinkingEventSchema>;
+export declare const ErrorEventSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"error">;
+    payload: z.ZodObject<{
+        sessionId: z.ZodOptional<z.ZodString>;
+        error: z.ZodObject<{
+            code: z.ZodEnum<{
+                readonly CLI_NOT_FOUND: "CLI_NOT_FOUND";
+                readonly AUTH_EXPIRED: "AUTH_EXPIRED";
+                readonly NETWORK_TIMEOUT: "NETWORK_TIMEOUT";
+                readonly CONTEXT_LIMIT: "CONTEXT_LIMIT";
+                readonly MALFORMED_EVENT: "MALFORMED_EVENT";
+                readonly PROCESS_CRASHED: "PROCESS_CRASHED";
+                readonly SESSION_NOT_FOUND: "SESSION_NOT_FOUND";
+                readonly UNKNOWN: "UNKNOWN";
+            }>;
+            message: z.ZodString;
+            details: z.ZodOptional<z.ZodUnknown>;
+            recoverable: z.ZodBoolean;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ErrorEvent = z.infer<typeof ErrorEventSchema>;
+export declare const SessionListEventSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"session_list">;
+    payload: z.ZodObject<{
+        sessions: z.ZodArray<z.ZodObject<{
+            sessionId: z.ZodString;
+            status: z.ZodEnum<{
+                readonly IDLE: "idle";
+                readonly STARTING: "starting";
+                readonly RUNNING: "running";
+                readonly STREAMING: "streaming";
+                readonly COMPLETED: "completed";
+                readonly CANCELED: "canceled";
+                readonly INTERRUPTED: "interrupted";
+                readonly FAILED: "failed";
+                readonly RESUMING: "resuming";
+            }>;
+            model: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+            createdAt: z.ZodNumber;
+            updatedAt: z.ZodNumber;
+            messageCount: z.ZodNumber;
+            toolCount: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type SessionListEvent = z.infer<typeof SessionListEventSchema>;
+export declare const SessionCompletedEventSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"session_completed">;
+    payload: z.ZodObject<{
+        sessionId: z.ZodString;
+        summary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type SessionCompletedEvent = z.infer<typeof SessionCompletedEventSchema>;
+export declare const HostEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"session_state">;
+    payload: z.ZodObject<{
+        sessionId: z.ZodString;
+        status: z.ZodEnum<{
+            readonly IDLE: "idle";
+            readonly STARTING: "starting";
+            readonly RUNNING: "running";
+            readonly STREAMING: "streaming";
+            readonly COMPLETED: "completed";
+            readonly CANCELED: "canceled";
+            readonly INTERRUPTED: "interrupted";
+            readonly FAILED: "failed";
+            readonly RESUMING: "resuming";
+        }>;
+        metadata: z.ZodOptional<z.ZodObject<{
+            sessionId: z.ZodString;
+            status: z.ZodEnum<{
+                readonly IDLE: "idle";
+                readonly STARTING: "starting";
+                readonly RUNNING: "running";
+                readonly STREAMING: "streaming";
+                readonly COMPLETED: "completed";
+                readonly CANCELED: "canceled";
+                readonly INTERRUPTED: "interrupted";
+                readonly FAILED: "failed";
+                readonly RESUMING: "resuming";
+            }>;
+            model: z.ZodOptional<z.ZodString>;
+            createdAt: z.ZodNumber;
+            updatedAt: z.ZodNumber;
+            title: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        timeline: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                readonly MESSAGE: "message";
+                readonly TOOL_CALL: "tool_call";
+                readonly STATUS: "status";
+                readonly ERROR: "error";
+                readonly DONE: "done";
+            }>;
+            timestamp: z.ZodNumber;
+            data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"text_delta">;
+    payload: z.ZodObject<{
+        sessionId: z.ZodString;
+        content: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"tool_started">;
+    payload: z.ZodObject<{
+        sessionId: z.ZodString;
+        tool: z.ZodString;
+        toolId: z.ZodOptional<z.ZodString>;
+        parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"tool_completed">;
+    payload: z.ZodObject<{
+        sessionId: z.ZodString;
+        tool: z.ZodString;
+        toolId: z.ZodOptional<z.ZodString>;
+        result: z.ZodOptional<z.ZodUnknown>;
+        duration: z.ZodOptional<z.ZodNumber>;
+        success: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"thinking">;
+    payload: z.ZodObject<{
+        sessionId: z.ZodString;
+        content: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"error">;
+    payload: z.ZodObject<{
+        sessionId: z.ZodOptional<z.ZodString>;
+        error: z.ZodObject<{
+            code: z.ZodEnum<{
+                readonly CLI_NOT_FOUND: "CLI_NOT_FOUND";
+                readonly AUTH_EXPIRED: "AUTH_EXPIRED";
+                readonly NETWORK_TIMEOUT: "NETWORK_TIMEOUT";
+                readonly CONTEXT_LIMIT: "CONTEXT_LIMIT";
+                readonly MALFORMED_EVENT: "MALFORMED_EVENT";
+                readonly PROCESS_CRASHED: "PROCESS_CRASHED";
+                readonly SESSION_NOT_FOUND: "SESSION_NOT_FOUND";
+                readonly UNKNOWN: "UNKNOWN";
+            }>;
+            message: z.ZodString;
+            details: z.ZodOptional<z.ZodUnknown>;
+            recoverable: z.ZodBoolean;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"session_list">;
+    payload: z.ZodObject<{
+        sessions: z.ZodArray<z.ZodObject<{
+            sessionId: z.ZodString;
+            status: z.ZodEnum<{
+                readonly IDLE: "idle";
+                readonly STARTING: "starting";
+                readonly RUNNING: "running";
+                readonly STREAMING: "streaming";
+                readonly COMPLETED: "completed";
+                readonly CANCELED: "canceled";
+                readonly INTERRUPTED: "interrupted";
+                readonly FAILED: "failed";
+                readonly RESUMING: "resuming";
+            }>;
+            model: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+            createdAt: z.ZodNumber;
+            updatedAt: z.ZodNumber;
+            messageCount: z.ZodNumber;
+            toolCount: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"session_completed">;
+    payload: z.ZodObject<{
+        sessionId: z.ZodString;
+        summary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>], "type">;
+export type HostEvent = z.infer<typeof HostEventSchema>;
+type HostEventPayloadMap = {
+    [HostEventType.SESSION_STATE]: SessionStateEvent["payload"];
+    [HostEventType.TEXT_DELTA]: TextDeltaEvent["payload"];
+    [HostEventType.TOOL_STARTED]: ToolStartedEvent["payload"];
+    [HostEventType.TOOL_COMPLETED]: ToolCompletedEvent["payload"];
+    [HostEventType.THINKING]: ThinkingEvent["payload"];
+    [HostEventType.ERROR]: ErrorEvent["payload"];
+    [HostEventType.SESSION_LIST]: SessionListEvent["payload"];
+    [HostEventType.SESSION_COMPLETED]: SessionCompletedEvent["payload"];
+};
+/**
+ * Create a validated host event message.
+ */
+export declare function createHostEvent<T extends HostEventType>(type: T, payload: HostEventPayloadMap[T]): HostEvent;
+export {};
+//# sourceMappingURL=host-events.d.ts.map

package/dist/protocol/host-events.d.ts.map

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

package/dist/protocol/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./cli-stream";
+export * from "./context";
+export * from "./envelope";
+export * from "./errors";
+export * from "./helpers";
+export * from "./host-events";
+export * from "./session";
+export * from "./ui-intents";
+//# sourceMappingURL=index.d.ts.map

package/dist/protocol/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/protocol/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC"}

package/dist/protocol/session.d.ts

@@ -0,0 +1,97 @@
+import { z } from "zod";
+export declare const SessionStatus: {
+    readonly IDLE: "idle";
+    readonly STARTING: "starting";
+    readonly RUNNING: "running";
+    readonly STREAMING: "streaming";
+    readonly COMPLETED: "completed";
+    readonly CANCELED: "canceled";
+    readonly INTERRUPTED: "interrupted";
+    readonly FAILED: "failed";
+    readonly RESUMING: "resuming";
+};
+export type SessionStatus = (typeof SessionStatus)[keyof typeof SessionStatus];
+export declare const SessionStatusSchema: z.ZodEnum<{
+    readonly IDLE: "idle";
+    readonly STARTING: "starting";
+    readonly RUNNING: "running";
+    readonly STREAMING: "streaming";
+    readonly COMPLETED: "completed";
+    readonly CANCELED: "canceled";
+    readonly INTERRUPTED: "interrupted";
+    readonly FAILED: "failed";
+    readonly RESUMING: "resuming";
+}>;
+export declare const SessionTransitionEvent: {
+    readonly CREATE_SESSION: "create_session";
+    readonly CLI_SPAWNED: "cli_spawned";
+    readonly FIRST_TEXT_DELTA: "first_text_delta";
+    readonly RESULT_RECEIVED: "result_received";
+    readonly USER_STOP: "user_stop";
+    readonly PROCESS_LOST: "process_lost";
+    readonly RESUME: "resume";
+    readonly ERROR: "error";
+};
+export type SessionTransitionEvent = (typeof SessionTransitionEvent)[keyof typeof SessionTransitionEvent];
+export declare const SessionTransitionEventSchema: z.ZodEnum<{
+    readonly CREATE_SESSION: "create_session";
+    readonly CLI_SPAWNED: "cli_spawned";
+    readonly FIRST_TEXT_DELTA: "first_text_delta";
+    readonly RESULT_RECEIVED: "result_received";
+    readonly USER_STOP: "user_stop";
+    readonly PROCESS_LOST: "process_lost";
+    readonly RESUME: "resume";
+    readonly ERROR: "error";
+}>;
+/**
+ * Valid state transitions for the session state machine.
+ * Maps `from → event → to`.
+ */
+export declare const SESSION_TRANSITIONS: ReadonlyArray<{
+    from: SessionStatus;
+    event: SessionTransitionEvent;
+    to: SessionStatus;
+}>;
+/** Terminal states — no transitions out except new session creation. */
+export declare const TERMINAL_STATUSES: ReadonlySet<SessionStatus>;
+export declare const SessionMetadataSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    status: z.ZodEnum<{
+        readonly IDLE: "idle";
+        readonly STARTING: "starting";
+        readonly RUNNING: "running";
+        readonly STREAMING: "streaming";
+        readonly COMPLETED: "completed";
+        readonly CANCELED: "canceled";
+        readonly INTERRUPTED: "interrupted";
+        readonly FAILED: "failed";
+        readonly RESUMING: "resuming";
+    }>;
+    model: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodNumber;
+    updatedAt: z.ZodNumber;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SessionMetadata = z.infer<typeof SessionMetadataSchema>;
+export declare const SessionSummarySchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    status: z.ZodEnum<{
+        readonly IDLE: "idle";
+        readonly STARTING: "starting";
+        readonly RUNNING: "running";
+        readonly STREAMING: "streaming";
+        readonly COMPLETED: "completed";
+        readonly CANCELED: "canceled";
+        readonly INTERRUPTED: "interrupted";
+        readonly FAILED: "failed";
+        readonly RESUMING: "resuming";
+    }>;
+    model: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodNumber;
+    updatedAt: z.ZodNumber;
+    messageCount: z.ZodNumber;
+    toolCount: z.ZodNumber;
+}, z.core.$strip>;
+export type SessionSummary = z.infer<typeof SessionSummarySchema>;
+//# sourceMappingURL=session.d.ts.map

package/dist/protocol/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/protocol/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,aAAa;;;;;;;;;;CAUhB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE/E,eAAO,MAAM,mBAAmB;;;;;;;;;;EAAwB,CAAC;AAMzD,eAAO,MAAM,sBAAsB;;;;;;;;;CASzB,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAChC,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,OAAO,sBAAsB,CAAC,CAAC;AAEvE,eAAO,MAAM,4BAA4B;;;;;;;;;EAAiC,CAAC;AAE3E;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC;IAC9C,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,sBAAsB,CAAC;IAC9B,EAAE,EAAE,aAAa,CAAC;CACnB,CAsFS,CAAC;AAEX,wEAAwE;AACxE,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,aAAa,CAIvD,CAAC;AAMH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;iBAOhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAMpE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;iBAS/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/protocol/ui-intents.d.ts

@@ -0,0 +1,165 @@
+import { z } from "zod";
+export declare const UIIntentType: {
+    readonly SUBMIT_PROMPT: "submit_prompt";
+    readonly STOP_SESSION: "stop_session";
+    readonly RESUME_SESSION: "resume_session";
+    readonly REQUEST_SESSIONS: "request_sessions";
+    readonly REQUEST_SESSION_DETAIL: "request_session_detail";
+    readonly CLEAR_SESSION: "clear_session";
+    readonly WEBVIEW_READY: "webview_ready";
+};
+export type UIIntentType = (typeof UIIntentType)[keyof typeof UIIntentType];
+export declare const UIIntentTypeSchema: z.ZodEnum<{
+    readonly SUBMIT_PROMPT: "submit_prompt";
+    readonly STOP_SESSION: "stop_session";
+    readonly RESUME_SESSION: "resume_session";
+    readonly REQUEST_SESSIONS: "request_sessions";
+    readonly REQUEST_SESSION_DETAIL: "request_session_detail";
+    readonly CLEAR_SESSION: "clear_session";
+    readonly WEBVIEW_READY: "webview_ready";
+}>;
+export declare const SubmitPromptIntentSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"submit_prompt">;
+    payload: z.ZodObject<{
+        text: z.ZodString;
+        context: z.ZodOptional<z.ZodObject<{
+            workspace: z.ZodOptional<z.ZodObject<{
+                rootPath: z.ZodString;
+                name: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            activeFile: z.ZodOptional<z.ZodObject<{
+                filePath: z.ZodString;
+                languageId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            selection: z.ZodOptional<z.ZodObject<{
+                filePath: z.ZodString;
+                languageId: z.ZodOptional<z.ZodString>;
+                startLine: z.ZodNumber;
+                startColumn: z.ZodNumber;
+                endLine: z.ZodNumber;
+                endColumn: z.ZodNumber;
+                text: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type SubmitPromptIntent = z.infer<typeof SubmitPromptIntentSchema>;
+export declare const StopSessionIntentSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"stop_session">;
+    payload: z.ZodObject<{
+        sessionId: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type StopSessionIntent = z.infer<typeof StopSessionIntentSchema>;
+export declare const ResumeSessionIntentSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"resume_session">;
+    payload: z.ZodObject<{
+        sessionId: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ResumeSessionIntent = z.infer<typeof ResumeSessionIntentSchema>;
+export declare const RequestSessionsIntentSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"request_sessions">;
+    payload: z.ZodOptional<z.ZodObject<{}, z.core.$strip>>;
+}, z.core.$strip>;
+export type RequestSessionsIntent = z.infer<typeof RequestSessionsIntentSchema>;
+export declare const RequestSessionDetailIntentSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"request_session_detail">;
+    payload: z.ZodObject<{
+        sessionId: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type RequestSessionDetailIntent = z.infer<typeof RequestSessionDetailIntentSchema>;
+export declare const ClearSessionIntentSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"clear_session">;
+    payload: z.ZodObject<{
+        sessionId: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ClearSessionIntent = z.infer<typeof ClearSessionIntentSchema>;
+export declare const WebviewReadyIntentSchema: z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"webview_ready">;
+    payload: z.ZodOptional<z.ZodObject<{}, z.core.$strip>>;
+}, z.core.$strip>;
+export type WebviewReadyIntent = z.infer<typeof WebviewReadyIntentSchema>;
+export declare const UIIntentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"submit_prompt">;
+    payload: z.ZodObject<{
+        text: z.ZodString;
+        context: z.ZodOptional<z.ZodObject<{
+            workspace: z.ZodOptional<z.ZodObject<{
+                rootPath: z.ZodString;
+                name: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            activeFile: z.ZodOptional<z.ZodObject<{
+                filePath: z.ZodString;
+                languageId: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            selection: z.ZodOptional<z.ZodObject<{
+                filePath: z.ZodString;
+                languageId: z.ZodOptional<z.ZodString>;
+                startLine: z.ZodNumber;
+                startColumn: z.ZodNumber;
+                endLine: z.ZodNumber;
+                endColumn: z.ZodNumber;
+                text: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"stop_session">;
+    payload: z.ZodObject<{
+        sessionId: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"resume_session">;
+    payload: z.ZodObject<{
+        sessionId: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"request_sessions">;
+    payload: z.ZodOptional<z.ZodObject<{}, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"request_session_detail">;
+    payload: z.ZodObject<{
+        sessionId: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"clear_session">;
+    payload: z.ZodObject<{
+        sessionId: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodObject<{
+    protocol: z.ZodLiteral<1>;
+    type: z.ZodLiteral<"webview_ready">;
+    payload: z.ZodOptional<z.ZodObject<{}, z.core.$strip>>;
+}, z.core.$strip>], "type">;
+export type UIIntent = z.infer<typeof UIIntentSchema>;
+type IntentPayloadMap = {
+    [UIIntentType.SUBMIT_PROMPT]: SubmitPromptIntent["payload"];
+    [UIIntentType.STOP_SESSION]: StopSessionIntent["payload"];
+    [UIIntentType.RESUME_SESSION]: ResumeSessionIntent["payload"];
+    [UIIntentType.REQUEST_SESSIONS]: RequestSessionsIntent["payload"];
+    [UIIntentType.REQUEST_SESSION_DETAIL]: RequestSessionDetailIntent["payload"];
+    [UIIntentType.CLEAR_SESSION]: ClearSessionIntent["payload"];
+    [UIIntentType.WEBVIEW_READY]: WebviewReadyIntent["payload"];
+};
+/**
+ * Create a validated UI intent message.
+ */
+export declare function createUIIntent<T extends UIIntentType>(type: T, payload: IntentPayloadMap[T]): UIIntent;
+export {};
+//# sourceMappingURL=ui-intents.d.ts.map

package/dist/protocol/ui-intents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-intents.d.ts","sourceRoot":"","sources":["../../src/protocol/ui-intents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,YAAY;;;;;;;;CAQf,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAE5E,eAAO,MAAM,kBAAkB;;;;;;;;EAAuB,CAAC;AAMvD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;iBAOnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,uBAAuB;;;;;;iBAMlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,yBAAyB;;;;;;iBAMpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,2BAA2B;;;;iBAItC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,gCAAgC;;;;;;iBAM3C,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAC9C,OAAO,gCAAgC,CACxC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;iBAMnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,wBAAwB;;;;iBAInC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAM1E,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAQzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAMtD,KAAK,gBAAgB,GAAG;IACtB,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC,YAAY,CAAC,cAAc,CAAC,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC9D,CAAC,YAAY,CAAC,gBAAgB,CAAC,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAClE,CAAC,YAAY,CAAC,sBAAsB,CAAC,EAAE,0BAA0B,CAAC,SAAS,CAAC,CAAC;IAC7E,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC,YAAY,CAAC,aAAa,CAAC,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;CAC7D,CAAC;AAEF;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,YAAY,EACnD,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC3B,QAAQ,CAMV"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@locusai/shared",
-  "version": "0.11.5",
+  "version": "0.11.7",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./src/index.ts",