@ccmsg/protocol 1.19.0 → 1.21.0

package/src/schemas.ts

@@ -7,10 +7,10 @@ import {
   AuthChallengeRequest,
   AuthChallengeResponse,
   AuthRecordsFrame,
-  AuthRefreshRequest,
-  AuthRefreshResponse,
-  AuthRefreshTokenRequest,
-  AuthRefreshTokenResponse,
+  AuthExtendRequest,
+  AuthExtendResponse,
+  AuthTokenRefreshRequest,
+  AuthTokenRefreshResponse,
   AuthRegisterRequest,
   AuthRegisterResponse,
   AuthResolveRequest,
@@ -18,7 +18,14 @@ import {
   AuthRotateRequest,
   AuthRotateResponse,
 } from "./common/auth.ts";
-import { HelloRequest, HelloResponse } from "./common/hello.ts";
+import {
+  HelloInstanceRequest,
+  HelloInstanceResponse,
+  HelloSessionRequest,
+  HelloSessionResponse,
+  HelloUserRequest,
+  HelloUserResponse,
+} from "./common/hello.ts";
 import { InstancePingRequest, InstancePingResponse } from "./common/ping.ts";
 import {
   InstanceShutdownRequest,
@@ -49,8 +56,8 @@ import {
   FileFindResponse,
   FileReadRequest,
   FileReadResponse,
-  FileStatBatchRequest,
-  FileStatBatchResponse,
+  FileStatRequest,
+  FileStatResponse,
   FileWriteRequest,
   FileWriteResponse,
 } from "./control/files.ts";
@@ -77,6 +84,7 @@ import {
   LlmUsageReadRequest,
   LlmUsageReadResponse,
 } from "./control/llm.ts";
+import { InstancesFrame } from "./control/instances.ts";
 import { PeersFrame } from "./control/peers.ts";
 import {
   SandboxGrantRequest,
@@ -91,12 +99,12 @@ import {
   SessionDumpWriteResponse,
   SessionEnvReadRequest,
   SessionEnvReadResponse,
-  SessionForkOriginRequest,
-  SessionForkOriginResponse,
+  SessionForkOriginReadRequest,
+  SessionForkOriginReadResponse,
   SessionKillRequest,
   SessionKillResponse,
-  SessionLastLiveRemoveRequest,
-  SessionLastLiveRemoveResponse,
+  SessionForgetRequest,
+  SessionForgetResponse,
   SessionRenameRequest,
   SessionRenameResponse,
   SessionSearchRequest,
@@ -114,8 +122,8 @@ import { TranslateRunRequest, TranslateRunResponse } from "./control/translate.t
 import { InboxFrame, MessageSendRequest, MessageSendResponse } from "./messaging/message.ts";
 import { NotifyFrame, NotifySendRequest, NotifySendResponse } from "./messaging/notify.ts";
 import {
-  SayMarkReadRequest,
-  SayMarkReadResponse,
+  SayUnreadClearRequest,
+  SayUnreadClearResponse,
   SayPostRequest,
   SayPostResponse,
 } from "./messaging/say.ts";
@@ -131,65 +139,70 @@ export interface OpSchemas {
  * what it takes and what it answers. The two are checked against each other:
  * an op in one and not the other is a hole in the contract, not a stage of it. */
 export const OP_SCHEMAS: Record<OpName, OpSchemas> = {
-  hello: { request: HelloRequest, response: HelloResponse },
-  instance_ping: { request: InstancePingRequest, response: InstancePingResponse },
-  instance_shutdown: { request: InstanceShutdownRequest, response: InstanceShutdownResponse },
-  session_stopping: { request: SessionStoppingRequest, response: SessionStoppingResponse },
-  topic_subscribe: { request: TopicSubscribeRequest, response: TopicSubscribeResponse },
-  topic_unsubscribe: { request: TopicUnsubscribeRequest, response: TopicUnsubscribeResponse },
-  auth_challenge: { request: AuthChallengeRequest, response: AuthChallengeResponse },
-  auth_register: { request: AuthRegisterRequest, response: AuthRegisterResponse },
-  auth_assert: { request: AuthAssertRequest, response: AuthAssertResponse },
-  auth_refresh_token: { request: AuthRefreshTokenRequest, response: AuthRefreshTokenResponse },
-  auth_refresh: { request: AuthRefreshRequest, response: AuthRefreshResponse },
-  auth_resolve: { request: AuthResolveRequest, response: AuthResolveResponse },
-  auth_rotate: { request: AuthRotateRequest, response: AuthRotateResponse },
-  message_send: { request: MessageSendRequest, response: MessageSendResponse },
-  say_post: { request: SayPostRequest, response: SayPostResponse },
-  say_mark_read: { request: SayMarkReadRequest, response: SayMarkReadResponse },
-  notify_send: { request: NotifySendRequest, response: NotifySendResponse },
+  "hello.session": { request: HelloSessionRequest, response: HelloSessionResponse },
+  "hello.user": { request: HelloUserRequest, response: HelloUserResponse },
+  "hello.instance": { request: HelloInstanceRequest, response: HelloInstanceResponse },
+  "instance.ping": { request: InstancePingRequest, response: InstancePingResponse },
+  "instance.shutdown": { request: InstanceShutdownRequest, response: InstanceShutdownResponse },
+  "session.stopping": { request: SessionStoppingRequest, response: SessionStoppingResponse },
+  "topic.subscribe": { request: TopicSubscribeRequest, response: TopicSubscribeResponse },
+  "topic.unsubscribe": { request: TopicUnsubscribeRequest, response: TopicUnsubscribeResponse },
+  "auth.challenge": { request: AuthChallengeRequest, response: AuthChallengeResponse },
+  "auth.register": { request: AuthRegisterRequest, response: AuthRegisterResponse },
+  "auth.assert": { request: AuthAssertRequest, response: AuthAssertResponse },
+  "auth.token.refresh": { request: AuthTokenRefreshRequest, response: AuthTokenRefreshResponse },
+  "auth.extend": { request: AuthExtendRequest, response: AuthExtendResponse },
+  "auth.resolve": { request: AuthResolveRequest, response: AuthResolveResponse },
+  "auth.rotate": { request: AuthRotateRequest, response: AuthRotateResponse },
+  "message.send": { request: MessageSendRequest, response: MessageSendResponse },
+  "say.post": { request: SayPostRequest, response: SayPostResponse },
+  "say.unread.clear": { request: SayUnreadClearRequest, response: SayUnreadClearResponse },
+  "notify.send": { request: NotifySendRequest, response: NotifySendResponse },
 
-  session_kill: { request: SessionKillRequest, response: SessionKillResponse },
-  session_rename: { request: SessionRenameRequest, response: SessionRenameResponse },
-  session_env_read: { request: SessionEnvReadRequest, response: SessionEnvReadResponse },
-  session_search: { request: SessionSearchRequest, response: SessionSearchResponse },
-  session_dump_write: { request: SessionDumpWriteRequest, response: SessionDumpWriteResponse },
-  dump_presets_read: { request: DumpPresetsReadRequest, response: DumpPresetsReadResponse },
-  transcript_read: { request: TranscriptReadRequest, response: TranscriptReadResponse },
-  transcript_items_read: {
+  "session.kill": { request: SessionKillRequest, response: SessionKillResponse },
+  "session.rename": { request: SessionRenameRequest, response: SessionRenameResponse },
+  "session.env.read": { request: SessionEnvReadRequest, response: SessionEnvReadResponse },
+  "session.search": { request: SessionSearchRequest, response: SessionSearchResponse },
+  "session.dump.write": { request: SessionDumpWriteRequest, response: SessionDumpWriteResponse },
+  "dump.presets.read": { request: DumpPresetsReadRequest, response: DumpPresetsReadResponse },
+  "transcript.read": { request: TranscriptReadRequest, response: TranscriptReadResponse },
+  "transcript.items.read": {
     request: TranscriptItemsReadRequest,
     response: TranscriptItemsReadResponse,
   },
-  session_fork_origin: { request: SessionForkOriginRequest, response: SessionForkOriginResponse },
-  session_last_live_remove: {
-    request: SessionLastLiveRemoveRequest,
-    response: SessionLastLiveRemoveResponse,
+  "session.fork.origin.read": {
+    request: SessionForkOriginReadRequest,
+    response: SessionForkOriginReadResponse,
+  },
+  "session.forget": {
+    request: SessionForgetRequest,
+    response: SessionForgetResponse,
   },
 
-  dir_list: { request: DirListRequest, response: DirListResponse },
-  file_read: { request: FileReadRequest, response: FileReadResponse },
-  file_write: { request: FileWriteRequest, response: FileWriteResponse },
-  file_create: { request: FileCreateRequest, response: FileCreateResponse },
-  file_edit: { request: FileEditRequest, response: FileEditResponse },
-  file_delete: { request: FileDeleteRequest, response: FileDeleteResponse },
-  file_find: { request: FileFindRequest, response: FileFindResponse },
-  file_stat_batch: { request: FileStatBatchRequest, response: FileStatBatchResponse },
-  dir_tree: { request: DirTreeRequest, response: DirTreeResponse },
+  "dir.list": { request: DirListRequest, response: DirListResponse },
+  "file.read": { request: FileReadRequest, response: FileReadResponse },
+  "file.write": { request: FileWriteRequest, response: FileWriteResponse },
+  "file.create": { request: FileCreateRequest, response: FileCreateResponse },
+  "file.edit": { request: FileEditRequest, response: FileEditResponse },
+  "file.delete": { request: FileDeleteRequest, response: FileDeleteResponse },
+  "file.find": { request: FileFindRequest, response: FileFindResponse },
+  "file.stat": { request: FileStatRequest, response: FileStatResponse },
+  "dir.tree": { request: DirTreeRequest, response: DirTreeResponse },
 
-  launcher_config_read: {
+  "launcher.config.read": {
     request: LauncherConfigReadRequest,
     response: LauncherConfigReadResponse,
   },
-  launcher_run: { request: LauncherRunRequest, response: LauncherRunResponse },
-  sandbox_grant: { request: SandboxGrantRequest, response: SandboxGrantResponse },
-  sandbox_revoke: { request: SandboxRevokeRequest, response: SandboxRevokeResponse },
-  translate_run: { request: TranslateRunRequest, response: TranslateRunResponse },
-  llm_usage_read: { request: LlmUsageReadRequest, response: LlmUsageReadResponse },
-  llm_stats_read: { request: LlmStatsReadRequest, response: LlmStatsReadResponse },
+  "launcher.run": { request: LauncherRunRequest, response: LauncherRunResponse },
+  "sandbox.grant": { request: SandboxGrantRequest, response: SandboxGrantResponse },
+  "sandbox.revoke": { request: SandboxRevokeRequest, response: SandboxRevokeResponse },
+  "translate.run": { request: TranslateRunRequest, response: TranslateRunResponse },
+  "llm.usage.read": { request: LlmUsageReadRequest, response: LlmUsageReadResponse },
+  "llm.stats.read": { request: LlmStatsReadRequest, response: LlmStatsReadResponse },
 
-  kv_read: { request: KvReadRequest, response: KvReadResponse },
-  kv_write: { request: KvWriteRequest, response: KvWriteResponse },
-  kv_delete: { request: KvDeleteRequest, response: KvDeleteResponse },
+  "kv.read": { request: KvReadRequest, response: KvReadResponse },
+  "kv.write": { request: KvWriteRequest, response: KvWriteResponse },
+  "kv.delete": { request: KvDeleteRequest, response: KvDeleteResponse },
 };
 
 /** The frame schema for every topic.
@@ -201,15 +214,16 @@ export const TOPIC_SCHEMAS = {
   inbox: InboxFrame,
   notify: NotifyFrame,
   peers: PeersFrame,
+  instances: InstancesFrame,
   agents: AgentsFrame,
-  session_status: SessionStatusFrame,
+  "session.status": SessionStatusFrame,
   transcript: TranscriptFrame,
-  transcript_items: TranscriptItemsFrame,
-  session_errors: SessionErrorsFrame,
-  llm_requests: LlmRequestsFrame,
-  llm_status: LlmStatusFrame,
+  "transcript.items": TranscriptItemsFrame,
+  "session.errors": SessionErrorsFrame,
+  "llm.requests": LlmRequestsFrame,
+  "llm.status": LlmStatusFrame,
   kv: KvFrame,
-  auth_records: AuthRecordsFrame,
+  "auth.records": AuthRecordsFrame,
 } as const;
 
 const compiled = new WeakMap<TSchema, TypeCheck<TSchema>>();

package/src/session-meta.ts

@@ -3,7 +3,8 @@ import { Type } from "@sinclair/typebox";
 /** The fields that describe where a session lives and what it runs as.
  *
  * Stated once and referenced wherever a session is described: the session names
- * them itself in `hello`, and the instance repeats them on the `peers` topic
+ * them itself in `hello.session`, and the instance repeats them on the `peers`
+ * topic
  * for connected and last-known sessions alike. Which of them are required
  * differs by place — a greeting may leave any of them unsaid — so each place
  * wraps what it needs in `Type.Optional`, but the name and the type of a field