@ahmadposten/talos-wire 0.1.0

package/dist/index.cjs

@@ -0,0 +1,371 @@
+'use strict';
+
+var z = require('zod');
+var cuid2 = require('@paralleldrive/cuid2');
+
+function _interopNamespaceDefault(e) {
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var z__namespace = /*#__PURE__*/_interopNamespaceDefault(z);
+
+const sessionRoleSchema = z__namespace.enum(["user", "agent"]);
+const sessionTextEventSchema = z__namespace.object({
+  t: z__namespace.literal("text"),
+  text: z__namespace.string(),
+  thinking: z__namespace.boolean().optional()
+});
+const sessionServiceMessageEventSchema = z__namespace.object({
+  t: z__namespace.literal("service"),
+  text: z__namespace.string()
+});
+const sessionToolCallStartEventSchema = z__namespace.object({
+  t: z__namespace.literal("tool-call-start"),
+  call: z__namespace.string(),
+  name: z__namespace.string(),
+  title: z__namespace.string(),
+  description: z__namespace.string(),
+  args: z__namespace.record(z__namespace.string(), z__namespace.unknown())
+});
+const sessionToolCallEndEventSchema = z__namespace.object({
+  t: z__namespace.literal("tool-call-end"),
+  call: z__namespace.string(),
+  // The tool's own output. Optional for back-compat: older CLIs send only
+  // `call`, and clients must keep treating a missing result as "no output".
+  // Without this the protocol drops every result — which silently broke the
+  // todo panel, since TaskCreate reports the task id only in its result.
+  result: z__namespace.unknown().optional(),
+  isError: z__namespace.boolean().optional()
+});
+const sessionFileEventSchema = z__namespace.object({
+  t: z__namespace.literal("file"),
+  ref: z__namespace.string(),
+  name: z__namespace.string(),
+  size: z__namespace.number(),
+  mimeType: z__namespace.string().optional(),
+  image: z__namespace.object({
+    width: z__namespace.number(),
+    height: z__namespace.number(),
+    thumbhash: z__namespace.string()
+  }).optional()
+});
+const sessionTurnStartEventSchema = z__namespace.object({
+  t: z__namespace.literal("turn-start")
+});
+const sessionStartEventSchema = z__namespace.object({
+  t: z__namespace.literal("start"),
+  title: z__namespace.string().optional()
+});
+const sessionTurnEndStatusSchema = z__namespace.enum(["completed", "failed", "cancelled"]);
+const sessionTurnEndEventSchema = z__namespace.object({
+  t: z__namespace.literal("turn-end"),
+  status: sessionTurnEndStatusSchema
+});
+const sessionStopEventSchema = z__namespace.object({
+  t: z__namespace.literal("stop")
+});
+const sessionEventSchema = z__namespace.discriminatedUnion("t", [
+  sessionTextEventSchema,
+  sessionServiceMessageEventSchema,
+  sessionToolCallStartEventSchema,
+  sessionToolCallEndEventSchema,
+  sessionFileEventSchema,
+  sessionTurnStartEventSchema,
+  sessionStartEventSchema,
+  sessionTurnEndEventSchema,
+  sessionStopEventSchema
+]);
+const sessionEnvelopeSchema = z__namespace.object({
+  id: z__namespace.string(),
+  time: z__namespace.number(),
+  role: sessionRoleSchema,
+  turn: z__namespace.string().optional(),
+  subagent: z__namespace.string().refine((value) => cuid2.isCuid(value), {
+    message: "subagent must be a cuid2 value"
+  }).optional(),
+  // Underlying agent-protocol message id (e.g. Claude's `uuid` in the
+  // session JSONL). Set on text-bearing envelopes so the app can let
+  // users pick a precise rewind point for session fork / duplicate.
+  claudeUuid: z__namespace.string().min(1).optional(),
+  // Codex app-server item id for this envelope. Used as the precise
+  // rollback point for Codex thread duplicate/fork-from-message.
+  codexItemId: z__namespace.string().min(1).optional(),
+  ev: sessionEventSchema
+}).superRefine((envelope, ctx) => {
+  if (envelope.ev.t === "service" && envelope.role !== "agent") {
+    ctx.addIssue({
+      code: z__namespace.ZodIssueCode.custom,
+      message: 'service events must use role "agent"',
+      path: ["role"]
+    });
+  }
+  if ((envelope.ev.t === "start" || envelope.ev.t === "stop") && envelope.role !== "agent") {
+    ctx.addIssue({
+      code: z__namespace.ZodIssueCode.custom,
+      message: `${envelope.ev.t} events must use role "agent"`,
+      path: ["role"]
+    });
+  }
+});
+function createEnvelope(role, ev, opts = {}) {
+  return sessionEnvelopeSchema.parse({
+    id: opts.id ?? cuid2.createId(),
+    time: opts.time ?? Date.now(),
+    role,
+    ...opts.turn ? { turn: opts.turn } : {},
+    ...opts.subagent ? { subagent: opts.subagent } : {},
+    ...opts.claudeUuid ? { claudeUuid: opts.claudeUuid } : {},
+    ...opts.codexItemId ? { codexItemId: opts.codexItemId } : {},
+    ev
+  });
+}
+
+const MessageMetaSchema = z__namespace.object({
+  sentFrom: z__namespace.string().optional(),
+  permissionMode: z__namespace.enum(["default", "acceptEdits", "bypassPermissions", "plan", "read-only", "safe-yolo", "yolo"]).optional(),
+  model: z__namespace.string().nullable().optional(),
+  fallbackModel: z__namespace.string().nullable().optional(),
+  customSystemPrompt: z__namespace.string().nullable().optional(),
+  appendSystemPrompt: z__namespace.string().nullable().optional(),
+  allowedTools: z__namespace.array(z__namespace.string()).nullable().optional(),
+  disallowedTools: z__namespace.array(z__namespace.string()).nullable().optional(),
+  effort: z__namespace.string().nullable().optional(),
+  displayText: z__namespace.string().optional()
+});
+
+const UserMessageSchema = z__namespace.object({
+  role: z__namespace.literal("user"),
+  content: z__namespace.object({
+    type: z__namespace.literal("text"),
+    text: z__namespace.string()
+  }),
+  localKey: z__namespace.string().optional(),
+  meta: MessageMetaSchema.optional()
+});
+const AgentMessageSchema = z__namespace.object({
+  role: z__namespace.literal("agent"),
+  content: z__namespace.object({
+    type: z__namespace.string()
+  }).passthrough(),
+  meta: MessageMetaSchema.optional()
+});
+const LegacyMessageContentSchema = z__namespace.discriminatedUnion("role", [UserMessageSchema, AgentMessageSchema]);
+
+const SessionMessageContentSchema = z__namespace.object({
+  c: z__namespace.string(),
+  t: z__namespace.literal("encrypted")
+});
+const SessionMessageSchema = z__namespace.object({
+  id: z__namespace.string(),
+  seq: z__namespace.number(),
+  localId: z__namespace.string().nullish(),
+  content: SessionMessageContentSchema,
+  createdAt: z__namespace.number(),
+  updatedAt: z__namespace.number()
+});
+const SessionProtocolMessageSchema = z__namespace.object({
+  role: z__namespace.literal("session"),
+  content: sessionEnvelopeSchema,
+  meta: MessageMetaSchema.optional()
+});
+const MessageContentSchema = z__namespace.discriminatedUnion("role", [
+  UserMessageSchema,
+  AgentMessageSchema,
+  SessionProtocolMessageSchema
+]);
+const VersionedEncryptedValueSchema = z__namespace.object({
+  version: z__namespace.number(),
+  value: z__namespace.string()
+});
+const VersionedNullableEncryptedValueSchema = z__namespace.object({
+  version: z__namespace.number(),
+  value: z__namespace.string().nullable()
+});
+const UpdateNewMessageBodySchema = z__namespace.object({
+  t: z__namespace.literal("new-message"),
+  sid: z__namespace.string(),
+  message: SessionMessageSchema
+});
+const UpdateSessionBodySchema = z__namespace.object({
+  t: z__namespace.literal("update-session"),
+  id: z__namespace.string(),
+  metadata: VersionedEncryptedValueSchema.nullish(),
+  agentState: VersionedNullableEncryptedValueSchema.nullish()
+});
+const VersionedMachineEncryptedValueSchema = z__namespace.object({
+  version: z__namespace.number(),
+  value: z__namespace.string()
+});
+const UpdateMachineBodySchema = z__namespace.object({
+  t: z__namespace.literal("update-machine"),
+  machineId: z__namespace.string(),
+  metadata: VersionedMachineEncryptedValueSchema.nullish(),
+  daemonState: VersionedMachineEncryptedValueSchema.nullish(),
+  active: z__namespace.boolean().optional(),
+  activeAt: z__namespace.number().optional()
+});
+const CoreUpdateBodySchema = z__namespace.discriminatedUnion("t", [
+  UpdateNewMessageBodySchema,
+  UpdateSessionBodySchema,
+  UpdateMachineBodySchema
+]);
+const CoreUpdateContainerSchema = z__namespace.object({
+  id: z__namespace.string(),
+  seq: z__namespace.number(),
+  body: CoreUpdateBodySchema,
+  createdAt: z__namespace.number()
+});
+const ApiMessageSchema = SessionMessageSchema;
+const ApiUpdateNewMessageSchema = UpdateNewMessageBodySchema;
+const ApiUpdateSessionStateSchema = UpdateSessionBodySchema;
+const ApiUpdateMachineStateSchema = UpdateMachineBodySchema;
+const UpdateBodySchema = UpdateNewMessageBodySchema;
+const UpdateSchema = CoreUpdateContainerSchema;
+
+const VoiceConversationGrantedSchema = z__namespace.object({
+  allowed: z__namespace.literal(true),
+  conversationToken: z__namespace.string(),
+  conversationId: z__namespace.string(),
+  agentId: z__namespace.string(),
+  elevenUserId: z__namespace.string(),
+  usedSeconds: z__namespace.number(),
+  limitSeconds: z__namespace.number()
+});
+const VoiceConversationDeniedSchema = z__namespace.object({
+  allowed: z__namespace.literal(false),
+  reason: z__namespace.enum(["voice_hard_limit_reached", "subscription_required", "voice_conversation_limit_reached"]),
+  usedSeconds: z__namespace.number(),
+  limitSeconds: z__namespace.number(),
+  agentId: z__namespace.string()
+});
+const VoiceConversationResponseSchema = z__namespace.discriminatedUnion("allowed", [
+  VoiceConversationGrantedSchema,
+  VoiceConversationDeniedSchema
+]);
+const VoiceUsageResponseSchema = z__namespace.object({
+  usedSeconds: z__namespace.number(),
+  limitSeconds: z__namespace.number(),
+  conversationCount: z__namespace.number(),
+  conversationLimit: z__namespace.number(),
+  elevenUserId: z__namespace.string()
+});
+
+const encryptionContexts = {
+  content: "Happy EnCoder",
+  analytics: "Happy Coder",
+  blobs: "Happy Blobs",
+  serverTokens: "happy-server-tokens"
+};
+const legacyServerBanner = "Welcome to Happy Server!";
+const authenticationContexts = {
+  persistent: "handy",
+  github: "github-happy"
+};
+const rpcMethods = {
+  spawnSession: "spawn-happy-session",
+  resumeSession: "resume-happy-session"
+};
+const legacyInstallation = {
+  accountLinkPrefix: "happy:///account?",
+  homeDirectory: ".happy",
+  homeEnvironment: "HAPPY_HOME_DIR",
+  serverEnvironment: "HAPPY_SERVER_URL",
+  webappEnvironment: "HAPPY_WEBAPP_URL",
+  defaultServerUrl: "https://api.happy.ahposten.com",
+  defaultWebappUrl: "https://app.happy.engineering"
+};
+const metadataAliases = {
+  happyCliVersion: "talosCliVersion",
+  happyHomeDir: "talosHomeDir",
+  happyLibDir: "talosLibDir",
+  happyToolsDir: "talosToolsDir",
+  requiresHappyAgentAuth: "requiresTalosAgentAuth",
+  happyAgentAuthenticated: "talosAgentAuthenticated"
+};
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function normalizeMetadata(value) {
+  if (!isRecord(value)) return value;
+  const result = { ...value };
+  for (const [oldKey, key] of Object.entries(metadataAliases)) {
+    if (result[key] === void 0 && result[oldKey] !== void 0) result[key] = result[oldKey];
+    delete result[oldKey];
+  }
+  if (isRecord(result.resumeSupport)) result.resumeSupport = normalizeMetadata(result.resumeSupport);
+  if (result.shutdownSource === "happy-app") result.shutdownSource = "talos-app";
+  if (result.shutdownSource === "happy-cli") result.shutdownSource = "talos-cli";
+  return result;
+}
+function toWireMetadata(value) {
+  if (!isRecord(value)) return value;
+  const result = { ...value };
+  for (const [oldKey, key] of Object.entries(metadataAliases)) {
+    if (result[key] !== void 0) result[oldKey] = result[key];
+  }
+  if (isRecord(result.resumeSupport)) result.resumeSupport = toWireMetadata(result.resumeSupport);
+  if (result.shutdownSource === "talos-app") result.shutdownSource = "happy-app";
+  if (result.shutdownSource === "talos-cli") result.shutdownSource = "happy-cli";
+  return result;
+}
+
+exports.AgentMessageSchema = AgentMessageSchema;
+exports.ApiMessageSchema = ApiMessageSchema;
+exports.ApiUpdateMachineStateSchema = ApiUpdateMachineStateSchema;
+exports.ApiUpdateNewMessageSchema = ApiUpdateNewMessageSchema;
+exports.ApiUpdateSessionStateSchema = ApiUpdateSessionStateSchema;
+exports.CoreUpdateBodySchema = CoreUpdateBodySchema;
+exports.CoreUpdateContainerSchema = CoreUpdateContainerSchema;
+exports.LegacyMessageContentSchema = LegacyMessageContentSchema;
+exports.MessageContentSchema = MessageContentSchema;
+exports.MessageMetaSchema = MessageMetaSchema;
+exports.SessionMessageContentSchema = SessionMessageContentSchema;
+exports.SessionMessageSchema = SessionMessageSchema;
+exports.SessionProtocolMessageSchema = SessionProtocolMessageSchema;
+exports.UpdateBodySchema = UpdateBodySchema;
+exports.UpdateMachineBodySchema = UpdateMachineBodySchema;
+exports.UpdateNewMessageBodySchema = UpdateNewMessageBodySchema;
+exports.UpdateSchema = UpdateSchema;
+exports.UpdateSessionBodySchema = UpdateSessionBodySchema;
+exports.UserMessageSchema = UserMessageSchema;
+exports.VersionedEncryptedValueSchema = VersionedEncryptedValueSchema;
+exports.VersionedMachineEncryptedValueSchema = VersionedMachineEncryptedValueSchema;
+exports.VersionedNullableEncryptedValueSchema = VersionedNullableEncryptedValueSchema;
+exports.VoiceConversationDeniedSchema = VoiceConversationDeniedSchema;
+exports.VoiceConversationGrantedSchema = VoiceConversationGrantedSchema;
+exports.VoiceConversationResponseSchema = VoiceConversationResponseSchema;
+exports.VoiceUsageResponseSchema = VoiceUsageResponseSchema;
+exports.authenticationContexts = authenticationContexts;
+exports.createEnvelope = createEnvelope;
+exports.encryptionContexts = encryptionContexts;
+exports.legacyInstallation = legacyInstallation;
+exports.legacyServerBanner = legacyServerBanner;
+exports.normalizeMetadata = normalizeMetadata;
+exports.rpcMethods = rpcMethods;
+exports.sessionEnvelopeSchema = sessionEnvelopeSchema;
+exports.sessionEventSchema = sessionEventSchema;
+exports.sessionFileEventSchema = sessionFileEventSchema;
+exports.sessionRoleSchema = sessionRoleSchema;
+exports.sessionServiceMessageEventSchema = sessionServiceMessageEventSchema;
+exports.sessionStartEventSchema = sessionStartEventSchema;
+exports.sessionStopEventSchema = sessionStopEventSchema;
+exports.sessionTextEventSchema = sessionTextEventSchema;
+exports.sessionToolCallEndEventSchema = sessionToolCallEndEventSchema;
+exports.sessionToolCallStartEventSchema = sessionToolCallStartEventSchema;
+exports.sessionTurnEndEventSchema = sessionTurnEndEventSchema;
+exports.sessionTurnEndStatusSchema = sessionTurnEndStatusSchema;
+exports.sessionTurnStartEventSchema = sessionTurnStartEventSchema;
+exports.toWireMetadata = toWireMetadata;