@flamecast/protocol 0.1.1 → 0.2.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export type { Runtime, RuntimeNames, RuntimeConfigFor, RuntimeInstance, RuntimeInfo, SessionContext, SessionEndReason, } from "./runtime.js";
 export type { FileSystemEntry, PermissionRequestEvent, FilesystemSnapshotEvent, FilePreviewEvent, PermissionRespondAction, FsSnapshotAction, FilePreviewAction, SessionHostStartRequest, SessionHostStartResponse, SessionHostHealthResponse, SessionCallbackEvent, PermissionCallbackResponse, } from "./session-host.js";
 export type { AgentSpawn, AgentTemplate, AgentTemplateRuntime, Session, SessionLog, PendingPermission, PendingPermissionOption, FileSystemSnapshot, FilePreview, QueuedPromptResponse, PromptQueueItem, PromptQueueState, CreateSessionBody, RegisterAgentTemplateBody, PromptBody, PermissionResponseBody, WebhookConfig, WebhookEventType, WebhookPayload, } from "./session.js";
-export type { FlamecastStorage, SessionMeta, SessionRuntimeInfo, StoredSession, } from "./storage.js";
+export type { FlamecastStorage, QueuedMessage, SessionMeta, SessionRuntimeInfo, StoredSession, } from "./storage.js";
 export type { WsServerMessage, WsControlMessage, WsEventMessage, WsConnectedMessage, WsErrorMessage, WsPromptAction, WsPermissionRespondAction, WsCancelAction, WsTerminateAction, WsPingAction, WsQueueReorderAction, WsQueueClearAction, WsQueuePauseAction, WsQueueResumeAction, } from "./ws.js";
 export type { RuntimeHostStartSessionRequest, RuntimeHostStartSessionResponse, RuntimeHostSessionStatus, RuntimeHostHealthResponse, RuntimeHostPromptRequest, RuntimeHostPermissionResponse, } from "./runtime-host.js";
 export type { Channel, WsChannelServerMessage, WsChannelControlMessage, WsChannelConnectedMessage, WsSubscribedMessage, WsUnsubscribedMessage, WsChannelEventMessage, WsSessionCreatedMessage, WsSessionTerminatedMessage, WsChannelErrorMessage, WsPongMessage, WsSubscribeAction, WsUnsubscribeAction, WsChannelPromptAction, WsChannelPermissionRespondAction, WsChannelCancelAction, WsChannelTerminateAction, WsChannelQueueReorderAction, WsChannelQueueClearAction, WsChannelQueuePauseAction, WsChannelQueueResumeAction, WsChannelPingAction, } from "./ws-channels.js";

package/dist/session.d.ts

@@ -81,6 +81,10 @@ export interface Session {
     websocketUrl?: string;
     /** Runtime instance name this session is scoped to. */
     runtime?: string;
+    /** Working directory the session was started in. */
+    cwd?: string;
+    /** Human-readable title derived from the first user prompt. */
+    title?: string;
 }
 export interface CreateSessionBody {
     /** Client-generated session ID. If omitted the server generates one. */

package/dist/storage.d.ts

@@ -1,5 +1,18 @@
 import type { RuntimeInstance } from "./runtime.js";
 import type { AgentTemplate, Session, WebhookConfig } from "./session.js";
+/** A message in the global message queue, persisted server-side. */
+export interface QueuedMessage {
+    id: number;
+    sessionId: string | null;
+    text: string;
+    runtime: string;
+    agent: string;
+    agentTemplateId: string | null;
+    directory: string | null;
+    status: "pending" | "sent";
+    createdAt: string;
+    sentAt: string | null;
+}
 /** Durable slice of {@link Session} (everything except runtime-only state). */
 export type SessionMeta = Omit<Session, "fileSystem" | "logs" | "promptQueue">;
 /** Runtime connection info persisted alongside a session for recovery after restart. */
@@ -36,7 +49,7 @@ export interface FlamecastStorage {
         env?: Record<string, string>;
     }): Promise<AgentTemplate | null>;
     createSession(meta: SessionMeta, runtimeInfo?: SessionRuntimeInfo, webhooks?: WebhookConfig[]): Promise<void>;
-    updateSession(id: string, patch: Partial<Pick<SessionMeta, "lastUpdatedAt" | "pendingPermission">>): Promise<void>;
+    updateSession(id: string, patch: Partial<Pick<SessionMeta, "lastUpdatedAt" | "pendingPermission" | "title">>): Promise<void>;
     getSessionMeta(id: string): Promise<SessionMeta | null>;
     getStoredSession(id: string): Promise<StoredSession | null>;
     /** Return all sessions (active + killed), ordered by lastUpdatedAt desc. */
@@ -47,4 +60,10 @@ export interface FlamecastStorage {
     saveRuntimeInstance(instance: RuntimeInstance): Promise<void>;
     listRuntimeInstances(): Promise<RuntimeInstance[]>;
     deleteRuntimeInstance(name: string): Promise<void>;
+    enqueueMessage(message: Omit<QueuedMessage, "id" | "createdAt" | "sentAt" | "status">): Promise<QueuedMessage>;
+    listQueuedMessages(): Promise<QueuedMessage[]>;
+    getNextPendingMessage(sessionId: string): Promise<QueuedMessage | null>;
+    markMessageSent(id: number): Promise<void>;
+    removeMessage(id: number): Promise<void>;
+    clearMessageQueue(): Promise<void>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flamecast/protocol",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "files": [
     "dist"
   ],