@finalai/agent-protocol 0.1.0

package/dist/modules/agent-platform/realtime.mjs

@@ -0,0 +1,185 @@
+import * as z from "zod";
+import { jsonValueSchema } from "../json.mjs";
+import { tolerantStringEnum, tolerantTaggedUnion, WireFallback } from "../tolerance.mjs";
+import { nullableNumber, nullableString } from "./common.mjs";
+import {
+  conversationMessageSchema,
+  conversationSchema,
+  participantSchema,
+  reactionSchema
+} from "./conversations.mjs";
+import { AgentRealtimeKind, ConversationListChange, ParticipantChange } from "./enums.mjs";
+import {
+  acpFrameEventSchema,
+  acpLiveFrameEventSchema,
+  acpLiveResetEventSchema,
+  acpPendingEventSchema,
+  acpPreviewEventSchema,
+  sessionStateEventSchema
+} from "./sessions.mjs";
+const agentRealtimeTopics = {
+  session: (sessionId) => `agent.session:${sessionId}`,
+  conversation: (conversationId) => `conversation:${conversationId}`,
+  userConversations: (userId) => `user.collection:${userId}:conversations`,
+  apiKeyConversations: (principalId) => `api-key.collection:${principalId}:conversations`,
+  apiKeyPending: (principalId) => `api-key.collection:${principalId}:pending`,
+  userPending: (userId) => `user.collection:${userId}:pending`
+};
+var AgentRealtimeFrameType = /* @__PURE__ */ ((AgentRealtimeFrameType2) => {
+  AgentRealtimeFrameType2["Event"] = "event";
+  AgentRealtimeFrameType2["Subscribed"] = "subscribed";
+  AgentRealtimeFrameType2["ResyncRequired"] = "resync_required";
+  AgentRealtimeFrameType2["Error"] = "error";
+  return AgentRealtimeFrameType2;
+})(AgentRealtimeFrameType || {});
+const agentRealtimeEnvelopeSchema = z.object({
+  type: z.literal("event" /* Event */),
+  topic: z.string(),
+  /** Null for events the gateway does not retain; those never advance a replay cursor. */
+  cursor: nullableString(),
+  eventKey: nullableString(),
+  kind: z.string(),
+  payload: jsonValueSchema.nullable().default(null),
+  createdAt: nullableString()
+});
+const agentRealtimeSubscribedFrameSchema = z.object({
+  type: z.literal("subscribed" /* Subscribed */),
+  topic: nullableString(),
+  cursor: nullableString()
+});
+const agentRealtimeResyncFrameSchema = z.object({
+  type: z.literal("resync_required" /* ResyncRequired */),
+  topic: nullableString(),
+  reason: nullableString()
+});
+const agentRealtimeErrorFrameSchema = z.object({
+  type: z.literal("error" /* Error */),
+  topic: nullableString(),
+  code: nullableString(),
+  message: nullableString(),
+  /** Null when the transport does not say; consumers then decide by `code`. */
+  retryable: z.boolean().nullable().default(null)
+});
+const agentRealtimeFrameSchema = tolerantTaggedUnion(
+  [
+    agentRealtimeEnvelopeSchema,
+    agentRealtimeSubscribedFrameSchema,
+    agentRealtimeResyncFrameSchema,
+    agentRealtimeErrorFrameSchema
+  ],
+  z.object({ type: z.string() }).transform((frame) => ({ type: WireFallback.Unrecognized, rawType: frame.type }))
+);
+const messageEventPayloadSchema = z.object({
+  message: conversationMessageSchema
+});
+const messageDeletedPayloadSchema = z.object({
+  conversationId: z.string(),
+  messageId: z.string(),
+  seq: nullableNumber(),
+  deletedAt: nullableString()
+});
+const reactionChangedPayloadSchema = z.object({
+  conversationId: z.string(),
+  messageId: z.string(),
+  emoji: z.string(),
+  participantId: z.string(),
+  added: z.boolean(),
+  /** Reactions on the message after the change; `mine` is always false here. */
+  reactions: z.array(reactionSchema).default([])
+});
+const participantChangedPayloadSchema = z.object({
+  conversationId: z.string(),
+  change: tolerantStringEnum(ParticipantChange),
+  participant: participantSchema
+});
+const conversationUpdatedPayloadSchema = z.object({
+  conversation: conversationSchema
+});
+const conversationReadPayloadSchema = z.object({
+  conversationId: z.string(),
+  participantId: z.string(),
+  lastReadSeq: z.number()
+});
+const conversationTypingPayloadSchema = z.object({
+  conversationId: z.string(),
+  participantId: z.string(),
+  typing: z.boolean(),
+  expiresAt: nullableString()
+});
+const turnStartedPayloadSchema = z.object({
+  conversationId: z.string(),
+  participantId: z.string(),
+  sessionId: z.string(),
+  turnId: z.string(),
+  promptMessageId: nullableString()
+});
+const turnEndedPayloadSchema = z.object({
+  conversationId: z.string(),
+  participantId: z.string(),
+  sessionId: z.string(),
+  turnId: z.string(),
+  stopReason: nullableString()
+});
+const conversationListChangedPayloadSchema = z.object({
+  conversationId: z.string(),
+  change: tolerantStringEnum(ConversationListChange),
+  conversation: conversationSchema.nullable().default(null)
+});
+const agentRealtimeEventSchema = tolerantTaggedUnion(
+  [
+    acpFrameEventSchema.extend({ kind: z.literal(AgentRealtimeKind.AcpFrame) }),
+    acpLiveFrameEventSchema.extend({ kind: z.literal(AgentRealtimeKind.AcpLiveFrame) }),
+    acpLiveResetEventSchema.extend({ kind: z.literal(AgentRealtimeKind.AcpLiveReset) }),
+    acpPreviewEventSchema.extend({ kind: z.literal(AgentRealtimeKind.AcpPreview) }),
+    acpPendingEventSchema.extend({ kind: z.literal(AgentRealtimeKind.AcpPending) }),
+    sessionStateEventSchema.extend({ kind: z.literal(AgentRealtimeKind.SessionState) }),
+    messageEventPayloadSchema.extend({ kind: z.literal(AgentRealtimeKind.MessageCreated) }),
+    messageEventPayloadSchema.extend({ kind: z.literal(AgentRealtimeKind.MessageUpdated) }),
+    messageDeletedPayloadSchema.extend({ kind: z.literal(AgentRealtimeKind.MessageDeleted) }),
+    reactionChangedPayloadSchema.extend({ kind: z.literal(AgentRealtimeKind.ReactionChanged) }),
+    participantChangedPayloadSchema.extend({
+      kind: z.literal(AgentRealtimeKind.ParticipantChanged)
+    }),
+    conversationUpdatedPayloadSchema.extend({
+      kind: z.literal(AgentRealtimeKind.ConversationUpdated)
+    }),
+    conversationReadPayloadSchema.extend({ kind: z.literal(AgentRealtimeKind.ConversationRead) }),
+    conversationTypingPayloadSchema.extend({
+      kind: z.literal(AgentRealtimeKind.ConversationTyping)
+    }),
+    turnStartedPayloadSchema.extend({ kind: z.literal(AgentRealtimeKind.TurnStarted) }),
+    turnEndedPayloadSchema.extend({ kind: z.literal(AgentRealtimeKind.TurnEnded) }),
+    conversationListChangedPayloadSchema.extend({
+      kind: z.literal(AgentRealtimeKind.ConversationListChanged)
+    })
+  ],
+  z.object({ kind: z.string() }).transform((event) => ({ kind: WireFallback.Unrecognized, rawKind: event.kind }))
+);
+const payloadObjectSchema = z.record(z.string(), z.unknown());
+const parseAgentRealtimeEvent = (envelope) => {
+  const fields = payloadObjectSchema.safeParse(envelope.payload).data ?? {};
+  const parsed = agentRealtimeEventSchema.safeParse({ ...fields, kind: envelope.kind });
+  return parsed.success ? parsed.data : { kind: WireFallback.Unrecognized, rawKind: envelope.kind };
+};
+export {
+  AgentRealtimeFrameType,
+  agentRealtimeEnvelopeSchema,
+  agentRealtimeErrorFrameSchema,
+  agentRealtimeEventSchema,
+  agentRealtimeFrameSchema,
+  agentRealtimeResyncFrameSchema,
+  agentRealtimeSubscribedFrameSchema,
+  agentRealtimeTopics,
+  conversationListChangedPayloadSchema,
+  conversationReadPayloadSchema,
+  conversationTypingPayloadSchema,
+  conversationUpdatedPayloadSchema,
+  messageDeletedPayloadSchema,
+  messageEventPayloadSchema,
+  parseAgentRealtimeEvent,
+  participantChangedPayloadSchema,
+  reactionChangedPayloadSchema,
+  turnEndedPayloadSchema,
+  turnStartedPayloadSchema
+};
+//# sourceMappingURL=realtime.mjs.map

package/dist/modules/agent-platform/realtime.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/agent-platform/realtime.ts"],
+  "sourcesContent": ["import * as z from 'zod';\n\nimport { jsonValueSchema } from \"../json.mjs\";\n\nimport { tolerantStringEnum, tolerantTaggedUnion, WireFallback } from \"../tolerance.mjs\";\n\nimport { nullableNumber, nullableString } from \"./common.mjs\";\n\nimport {\n  conversationMessageSchema,\n  conversationSchema,\n  participantSchema,\n  reactionSchema,\n} from \"./conversations.mjs\";\n\nimport { AgentRealtimeKind, ConversationListChange, ParticipantChange } from \"./enums.mjs\";\n\nimport {\n  acpFrameEventSchema,\n  acpLiveFrameEventSchema,\n  acpLiveResetEventSchema,\n  acpPendingEventSchema,\n  acpPreviewEventSchema,\n  sessionStateEventSchema,\n} from \"./sessions.mjs\";\n\n// Realtime topics and events of the agent platform (SPEC 4.2), delivered by\n// websocket-gateway. Every frame a topic subscriber receives is an\n// `agentRealtimeFrameSchema`; an event's `kind` + `payload` parse with\n// `parseAgentRealtimeEvent` into a flat, tagged `AgentRealtimeEvent`.\n\nexport const agentRealtimeTopics = {\n  session: (sessionId: string): string => `agent.session:${sessionId}`,\n  conversation: (conversationId: string): string => `conversation:${conversationId}`,\n  userConversations: (userId: string): string => `user.collection:${userId}:conversations`,\n  apiKeyConversations: (principalId: string): string =>\n    `api-key.collection:${principalId}:conversations`,\n  apiKeyPending: (principalId: string): string => `api-key.collection:${principalId}:pending`,\n  userPending: (userId: string): string => `user.collection:${userId}:pending`,\n};\n\nexport enum AgentRealtimeFrameType {\n  Event = 'event',\n  Subscribed = 'subscribed',\n  ResyncRequired = 'resync_required',\n  Error = 'error',\n}\n\n/** The gateway's realtime event envelope (`@finalai/final-realtime-protocol` event, parsed tolerantly). */\nexport const agentRealtimeEnvelopeSchema = z.object({\n  type: z.literal(AgentRealtimeFrameType.Event),\n  topic: z.string(),\n  /** Null for events the gateway does not retain; those never advance a replay cursor. */\n  cursor: nullableString(),\n  eventKey: nullableString(),\n  kind: z.string(),\n  payload: jsonValueSchema.nullable().default(null),\n  createdAt: nullableString(),\n});\n\nexport type AgentRealtimeEnvelopeIface = z.infer<typeof agentRealtimeEnvelopeSchema>;\n\nexport const agentRealtimeSubscribedFrameSchema = z.object({\n  type: z.literal(AgentRealtimeFrameType.Subscribed),\n  topic: nullableString(),\n  cursor: nullableString(),\n});\n\nexport const agentRealtimeResyncFrameSchema = z.object({\n  type: z.literal(AgentRealtimeFrameType.ResyncRequired),\n  topic: nullableString(),\n  reason: nullableString(),\n});\n\nexport const agentRealtimeErrorFrameSchema = z.object({\n  type: z.literal(AgentRealtimeFrameType.Error),\n  topic: nullableString(),\n  code: nullableString(),\n  message: nullableString(),\n  /** Null when the transport does not say; consumers then decide by `code`. */\n  retryable: z.boolean().nullable().default(null),\n});\n\n/** One frame a topic subscriber receives from a realtime transport. */\nexport const agentRealtimeFrameSchema = tolerantTaggedUnion(\n  [\n    agentRealtimeEnvelopeSchema,\n    agentRealtimeSubscribedFrameSchema,\n    agentRealtimeResyncFrameSchema,\n    agentRealtimeErrorFrameSchema,\n  ],\n  z\n    .object({ type: z.string() })\n    .transform((frame) => ({ type: WireFallback.Unrecognized, rawType: frame.type })),\n);\n\nexport type AgentRealtimeFrame = z.infer<typeof agentRealtimeFrameSchema>;\n\n// Conversation payloads (acp.* and session.state payloads live in sessions.ts).\n\nexport const messageEventPayloadSchema = z.object({\n  message: conversationMessageSchema,\n});\n\nexport const messageDeletedPayloadSchema = z.object({\n  conversationId: z.string(),\n  messageId: z.string(),\n  seq: nullableNumber(),\n  deletedAt: nullableString(),\n});\n\nexport const reactionChangedPayloadSchema = z.object({\n  conversationId: z.string(),\n  messageId: z.string(),\n  emoji: z.string(),\n  participantId: z.string(),\n  added: z.boolean(),\n  /** Reactions on the message after the change; `mine` is always false here. */\n  reactions: z.array(reactionSchema).default([]),\n});\n\nexport const participantChangedPayloadSchema = z.object({\n  conversationId: z.string(),\n  change: tolerantStringEnum(ParticipantChange),\n  participant: participantSchema,\n});\n\nexport const conversationUpdatedPayloadSchema = z.object({\n  conversation: conversationSchema,\n});\n\nexport const conversationReadPayloadSchema = z.object({\n  conversationId: z.string(),\n  participantId: z.string(),\n  lastReadSeq: z.number(),\n});\n\nexport const conversationTypingPayloadSchema = z.object({\n  conversationId: z.string(),\n  participantId: z.string(),\n  typing: z.boolean(),\n  expiresAt: nullableString(),\n});\n\nexport const turnStartedPayloadSchema = z.object({\n  conversationId: z.string(),\n  participantId: z.string(),\n  sessionId: z.string(),\n  turnId: z.string(),\n  promptMessageId: nullableString(),\n});\n\nexport const turnEndedPayloadSchema = z.object({\n  conversationId: z.string(),\n  participantId: z.string(),\n  sessionId: z.string(),\n  turnId: z.string(),\n  stopReason: nullableString(),\n});\n\nexport const conversationListChangedPayloadSchema = z.object({\n  conversationId: z.string(),\n  change: tolerantStringEnum(ConversationListChange),\n  conversation: conversationSchema.nullable().default(null),\n});\n\n/**\n * A realtime event flattened as `{ kind, ...payload }`. Kinds the bundle\n * predates, or payloads it cannot read, become `{ kind: Unrecognized, rawKind }`.\n */\nexport const agentRealtimeEventSchema = tolerantTaggedUnion(\n  [\n    acpFrameEventSchema.extend({ kind: z.literal(AgentRealtimeKind.AcpFrame) }),\n    acpLiveFrameEventSchema.extend({ kind: z.literal(AgentRealtimeKind.AcpLiveFrame) }),\n    acpLiveResetEventSchema.extend({ kind: z.literal(AgentRealtimeKind.AcpLiveReset) }),\n    acpPreviewEventSchema.extend({ kind: z.literal(AgentRealtimeKind.AcpPreview) }),\n    acpPendingEventSchema.extend({ kind: z.literal(AgentRealtimeKind.AcpPending) }),\n    sessionStateEventSchema.extend({ kind: z.literal(AgentRealtimeKind.SessionState) }),\n    messageEventPayloadSchema.extend({ kind: z.literal(AgentRealtimeKind.MessageCreated) }),\n    messageEventPayloadSchema.extend({ kind: z.literal(AgentRealtimeKind.MessageUpdated) }),\n    messageDeletedPayloadSchema.extend({ kind: z.literal(AgentRealtimeKind.MessageDeleted) }),\n    reactionChangedPayloadSchema.extend({ kind: z.literal(AgentRealtimeKind.ReactionChanged) }),\n    participantChangedPayloadSchema.extend({\n      kind: z.literal(AgentRealtimeKind.ParticipantChanged),\n    }),\n    conversationUpdatedPayloadSchema.extend({\n      kind: z.literal(AgentRealtimeKind.ConversationUpdated),\n    }),\n    conversationReadPayloadSchema.extend({ kind: z.literal(AgentRealtimeKind.ConversationRead) }),\n    conversationTypingPayloadSchema.extend({\n      kind: z.literal(AgentRealtimeKind.ConversationTyping),\n    }),\n    turnStartedPayloadSchema.extend({ kind: z.literal(AgentRealtimeKind.TurnStarted) }),\n    turnEndedPayloadSchema.extend({ kind: z.literal(AgentRealtimeKind.TurnEnded) }),\n    conversationListChangedPayloadSchema.extend({\n      kind: z.literal(AgentRealtimeKind.ConversationListChanged),\n    }),\n  ],\n  z\n    .object({ kind: z.string() })\n    .transform((event) => ({ kind: WireFallback.Unrecognized, rawKind: event.kind })),\n);\n\nexport type AgentRealtimeEvent = z.infer<typeof agentRealtimeEventSchema>;\n\nexport type AgentRealtimeEventOf<Kind extends AgentRealtimeKind> = Extract<\n  AgentRealtimeEvent,\n  { kind: Kind }\n>;\n\nconst payloadObjectSchema = z.record(z.string(), z.unknown());\n\n/** Flattens an envelope into a tagged event; never throws. */\nexport const parseAgentRealtimeEvent = (\n  envelope: Pick<AgentRealtimeEnvelopeIface, 'kind' | 'payload'>,\n): AgentRealtimeEvent => {\n  const fields = payloadObjectSchema.safeParse(envelope.payload).data ?? {};\n  const parsed = agentRealtimeEventSchema.safeParse({ ...fields, kind: envelope.kind });\n  return parsed.success ? parsed.data : { kind: WireFallback.Unrecognized, rawKind: envelope.kind };\n};\n"],
+  "mappings": "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",
+  "names": ["AgentRealtimeFrameType"]
+}

package/dist/modules/agent-platform/sandboxes.d.mts

@@ -0,0 +1,203 @@
+import * as z from 'zod';
+import { WireFallback } from "../tolerance.mjs";
+export declare enum ConversationSandboxKind {
+    Computer = "computer",
+    Device = "device",
+    Other = "other"
+}
+export declare enum ConversationSandboxStatus {
+    Pending = "pending",
+    Starting = "starting",
+    Running = "running",
+    Parked = "parked",
+    Ended = "ended",
+    Failed = "failed"
+}
+export declare enum SandboxAccessLevel {
+    Read = "read",
+    Execute = "execute",
+    Write = "write"
+}
+export declare enum SandboxEntryKind {
+    File = "file",
+    Directory = "directory",
+    Symlink = "symlink",
+    Other = "other"
+}
+export declare enum SandboxFileEncoding {
+    Utf8 = "utf8",
+    Base64 = "base64"
+}
+export declare enum SandboxPreviewKind {
+    Image = "image",
+    Url = "url"
+}
+export declare const conversationSandboxSchema: z.ZodObject<{
+    bindingId: z.ZodString;
+    target: z.ZodString;
+    provider: z.ZodString;
+    kind: z.ZodUnion<readonly [z.ZodEnum<typeof ConversationSandboxKind>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<WireFallback, unknown>>]>;
+    status: z.ZodUnion<readonly [z.ZodEnum<typeof ConversationSandboxStatus>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<WireFallback, unknown>>]>;
+    access: z.ZodUnion<readonly [z.ZodEnum<typeof SandboxAccessLevel>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<WireFallback, unknown>>]>;
+    capabilities: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    agentParticipantIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    previewAvailable: z.ZodDefault<z.ZodBoolean>;
+    filesAvailable: z.ZodOptional<z.ZodBoolean>;
+    canEdit: z.ZodOptional<z.ZodBoolean>;
+    canControlScreen: z.ZodOptional<z.ZodBoolean>;
+    canWake: z.ZodDefault<z.ZodBoolean>;
+    updatedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type ConversationSandboxIface = z.infer<typeof conversationSandboxSchema>;
+export declare const conversationSandboxListSchema: z.ZodObject<{
+    sandboxes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        bindingId: z.ZodString;
+        target: z.ZodString;
+        provider: z.ZodString;
+        kind: z.ZodUnion<readonly [z.ZodEnum<typeof ConversationSandboxKind>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<WireFallback, unknown>>]>;
+        status: z.ZodUnion<readonly [z.ZodEnum<typeof ConversationSandboxStatus>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<WireFallback, unknown>>]>;
+        access: z.ZodUnion<readonly [z.ZodEnum<typeof SandboxAccessLevel>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<WireFallback, unknown>>]>;
+        capabilities: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        agentParticipantIds: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        previewAvailable: z.ZodDefault<z.ZodBoolean>;
+        filesAvailable: z.ZodOptional<z.ZodBoolean>;
+        canEdit: z.ZodOptional<z.ZodBoolean>;
+        canControlScreen: z.ZodOptional<z.ZodBoolean>;
+        canWake: z.ZodDefault<z.ZodBoolean>;
+        updatedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const sandboxDirEntrySchema: z.ZodObject<{
+    name: z.ZodString;
+    path: z.ZodString;
+    kind: z.ZodUnion<readonly [z.ZodEnum<typeof SandboxEntryKind>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<WireFallback, unknown>>]>;
+    size: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+export type SandboxDirEntryIface = z.infer<typeof sandboxDirEntrySchema>;
+/** `GET …/sandboxes/:bindingId/files?path=`: one directory, directories first. */
+export declare const sandboxDirectorySchema: z.ZodObject<{
+    snapshot: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        capturedAt: z.ZodString;
+    }, z.core.$strip>>>;
+    bindingId: z.ZodString;
+    path: z.ZodString;
+    root: z.ZodString;
+    entries: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        path: z.ZodString;
+        kind: z.ZodUnion<readonly [z.ZodEnum<typeof SandboxEntryKind>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<WireFallback, unknown>>]>;
+        size: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>>>;
+    truncated: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type SandboxDirectoryIface = z.infer<typeof sandboxDirectorySchema>;
+export declare const sandboxPathSchema: z.ZodObject<{
+    snapshot: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        capturedAt: z.ZodString;
+    }, z.core.$strip>>>;
+    bindingId: z.ZodString;
+    root: z.ZodString;
+    path: z.ZodString;
+    exists: z.ZodBoolean;
+    kind: z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<typeof SandboxEntryKind>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<WireFallback, unknown>>]>>;
+    size: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    modifiedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type SandboxPathIface = z.infer<typeof sandboxPathSchema>;
+export declare const sandboxSearchSchema: z.ZodObject<{
+    snapshot: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        capturedAt: z.ZodString;
+    }, z.core.$strip>>>;
+    bindingId: z.ZodString;
+    path: z.ZodString;
+    root: z.ZodString;
+    entries: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        path: z.ZodString;
+        kind: z.ZodUnion<readonly [z.ZodEnum<typeof SandboxEntryKind>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<WireFallback, unknown>>]>;
+        size: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    }, z.core.$strip>>>;
+    truncated: z.ZodDefault<z.ZodBoolean>;
+    query: z.ZodString;
+}, z.core.$strip>;
+export type SandboxSearchIface = z.infer<typeof sandboxSearchSchema>;
+export declare const sandboxSearchQuerySchema: z.ZodObject<{
+    path: z.ZodOptional<z.ZodString>;
+    query: z.ZodString;
+    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>;
+/** `GET …/sandboxes/:bindingId/file?path=&offset=&length=`: one byte range of a file. */
+export declare const sandboxFileSchema: z.ZodObject<{
+    snapshot: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        id: z.ZodString;
+        capturedAt: z.ZodString;
+    }, z.core.$strip>>>;
+    bindingId: z.ZodString;
+    path: z.ZodString;
+    size: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    offset: z.ZodDefault<z.ZodNumber>;
+    length: z.ZodDefault<z.ZodNumber>;
+    truncated: z.ZodDefault<z.ZodBoolean>;
+    encoding: z.ZodUnion<readonly [z.ZodEnum<typeof SandboxFileEncoding>, z.ZodPipe<z.ZodUnknown, z.ZodTransform<WireFallback, unknown>>]>;
+    content: z.ZodDefault<z.ZodString>;
+    modifiedAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type SandboxFileIface = z.infer<typeof sandboxFileSchema>;
+/** `GET …/sandboxes/:bindingId/preview`: a short-lived look at the screen. */
+export declare const sandboxPreviewSchema: z.ZodUnion<readonly [z.ZodObject<{
+    kind: z.ZodLiteral<SandboxPreviewKind.Url>;
+    url: z.ZodString;
+    token: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    expiresAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<SandboxPreviewKind.Image>;
+    contentType: z.ZodString;
+    dataBase64: z.ZodString;
+    expiresAt: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>, z.ZodPipe<z.ZodObject<{
+    kind: z.ZodString;
+}, z.core.$strip>, z.ZodTransform<{
+    kind: WireFallback;
+    rawKind: string;
+}, {
+    kind: string;
+}>>]>;
+export type SandboxPreviewType = z.infer<typeof sandboxPreviewSchema>;
+export declare const SANDBOX_FILE_MAX_LENGTH: number;
+export declare const sandboxFilesQuerySchema: z.ZodObject<{
+    snapshotId: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare const sandboxFileQuerySchema: z.ZodObject<{
+    snapshotId: z.ZodOptional<z.ZodString>;
+    path: z.ZodString;
+    offset: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    length: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strict>;
+/** Raw file bytes, with optional HTTP Range; never starts a sleeping sandbox. */
+export declare const sandboxFileContentQuerySchema: z.ZodObject<{
+    snapshotId: z.ZodOptional<z.ZodString>;
+    path: z.ZodString;
+    download: z.ZodOptional<z.ZodCodec<z.ZodString, z.ZodBoolean>>;
+}, z.core.$strict>;
+export declare const sandboxEditorSessionSchema: z.ZodObject<{
+    id: z.ZodString;
+    authorizationId: z.ZodString;
+    workingDirectory: z.ZodString;
+    url: z.ZodString;
+    expiresAt: z.ZodString;
+    authentication: z.ZodObject<{
+        url: z.ZodString;
+        fields: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type SandboxEditorSessionIface = z.infer<typeof sandboxEditorSessionSchema>;
+export declare const sandboxEditorAuthorizationSchema: z.ZodObject<{
+    authorizationId: z.ZodString;
+}, z.core.$strict>;
+export declare const sandboxPreviewOptionsSchema: z.ZodObject<{
+    viewOnly: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;

package/dist/modules/agent-platform/sandboxes.mjs

@@ -0,0 +1,186 @@
+import * as z from "zod";
+import { tolerantStringEnum, tolerantTaggedUnion, WireFallback } from "../tolerance.mjs";
+import { nullableNumber, nullableString } from "./common.mjs";
+var ConversationSandboxKind = /* @__PURE__ */ ((ConversationSandboxKind2) => {
+  ConversationSandboxKind2["Computer"] = "computer";
+  ConversationSandboxKind2["Device"] = "device";
+  ConversationSandboxKind2["Other"] = "other";
+  return ConversationSandboxKind2;
+})(ConversationSandboxKind || {});
+var ConversationSandboxStatus = /* @__PURE__ */ ((ConversationSandboxStatus2) => {
+  ConversationSandboxStatus2["Pending"] = "pending";
+  ConversationSandboxStatus2["Starting"] = "starting";
+  ConversationSandboxStatus2["Running"] = "running";
+  ConversationSandboxStatus2["Parked"] = "parked";
+  ConversationSandboxStatus2["Ended"] = "ended";
+  ConversationSandboxStatus2["Failed"] = "failed";
+  return ConversationSandboxStatus2;
+})(ConversationSandboxStatus || {});
+var SandboxAccessLevel = /* @__PURE__ */ ((SandboxAccessLevel2) => {
+  SandboxAccessLevel2["Read"] = "read";
+  SandboxAccessLevel2["Execute"] = "execute";
+  SandboxAccessLevel2["Write"] = "write";
+  return SandboxAccessLevel2;
+})(SandboxAccessLevel || {});
+var SandboxEntryKind = /* @__PURE__ */ ((SandboxEntryKind2) => {
+  SandboxEntryKind2["File"] = "file";
+  SandboxEntryKind2["Directory"] = "directory";
+  SandboxEntryKind2["Symlink"] = "symlink";
+  SandboxEntryKind2["Other"] = "other";
+  return SandboxEntryKind2;
+})(SandboxEntryKind || {});
+var SandboxFileEncoding = /* @__PURE__ */ ((SandboxFileEncoding2) => {
+  SandboxFileEncoding2["Utf8"] = "utf8";
+  SandboxFileEncoding2["Base64"] = "base64";
+  return SandboxFileEncoding2;
+})(SandboxFileEncoding || {});
+var SandboxPreviewKind = /* @__PURE__ */ ((SandboxPreviewKind2) => {
+  SandboxPreviewKind2["Image"] = "image";
+  SandboxPreviewKind2["Url"] = "url";
+  return SandboxPreviewKind2;
+})(SandboxPreviewKind || {});
+const conversationSandboxSchema = z.object({
+  bindingId: z.string(),
+  /** The manifest's target name (`computer`). */
+  target: z.string(),
+  /** Provider reference text (`package:@finalai/final-agent-provider/sandboxes/computer`). */
+  provider: z.string(),
+  kind: tolerantStringEnum(ConversationSandboxKind),
+  status: tolerantStringEnum(ConversationSandboxStatus),
+  access: tolerantStringEnum(SandboxAccessLevel),
+  /** What the agents' manifests bind to it (`files`, `process`, `computerUse`, `screen`, …). */
+  capabilities: z.array(z.string()).default([]),
+  /** Agent participants whose sessions use it. */
+  agentParticipantIds: z.array(z.string()).default([]),
+  /** A screen preview can be requested now (running, and a provider that may serve one). */
+  previewAvailable: z.boolean().default(false),
+  /** A live or saved workspace can be read without waking the sandbox. */
+  filesAvailable: z.boolean().optional(),
+  /** Authorized editor access through the provider, while this sandbox runs. */
+  canEdit: z.boolean().optional(),
+  canControlScreen: z.boolean().optional(),
+  /** The viewer may wake it (`POST …/wake`): conversation owners and admins. */
+  canWake: z.boolean().default(false),
+  updatedAt: nullableString()
+});
+const conversationSandboxListSchema = z.object({
+  sandboxes: z.array(conversationSandboxSchema).default([])
+});
+const sandboxDirEntrySchema = z.object({
+  name: z.string(),
+  path: z.string(),
+  kind: tolerantStringEnum(SandboxEntryKind),
+  size: nullableNumber()
+});
+const fileSnapshotSchema = z.object({ id: z.string(), capturedAt: z.string() }).nullable().optional();
+const sandboxDirectorySchema = z.object({
+  snapshot: fileSnapshotSchema,
+  bindingId: z.string(),
+  path: z.string(),
+  /** The workspace root every path is confined to. */
+  root: z.string(),
+  entries: z.array(sandboxDirEntrySchema).default([]),
+  /** More entries exist than were returned. */
+  truncated: z.boolean().default(false)
+});
+const sandboxPathSchema = z.object({
+  snapshot: fileSnapshotSchema,
+  bindingId: z.string(),
+  root: z.string(),
+  path: z.string(),
+  exists: z.boolean(),
+  kind: tolerantStringEnum(SandboxEntryKind).nullable(),
+  size: nullableNumber(),
+  modifiedAt: nullableString()
+});
+const sandboxSearchSchema = sandboxDirectorySchema.extend({ query: z.string() });
+const sandboxSearchQuerySchema = z.strictObject({
+  path: z.string().max(4096).optional(),
+  query: z.string().trim().min(2).max(256),
+  limit: z.coerce.number().int().positive().max(200).optional()
+});
+const sandboxFileSchema = z.object({
+  snapshot: fileSnapshotSchema,
+  bindingId: z.string(),
+  path: z.string(),
+  size: nullableNumber(),
+  offset: z.number().default(0),
+  /** Bytes returned. */
+  length: z.number().default(0),
+  /** Bytes remain after this range. */
+  truncated: z.boolean().default(false),
+  encoding: tolerantStringEnum(SandboxFileEncoding),
+  content: z.string().default(""),
+  modifiedAt: nullableString()
+});
+const sandboxPreviewSchema = tolerantTaggedUnion(
+  [
+    z.object({
+      kind: z.literal("url" /* Url */),
+      /** A view-only remote-screen URL; `token` authorizes it when not embedded. */
+      url: z.string(),
+      token: nullableString(),
+      expiresAt: nullableString()
+    }),
+    z.object({
+      kind: z.literal("image" /* Image */),
+      contentType: z.string(),
+      dataBase64: z.string(),
+      expiresAt: nullableString()
+    })
+  ],
+  z.object({ kind: z.string() }).transform((preview) => ({ kind: WireFallback.Unrecognized, rawKind: preview.kind }))
+);
+const SANDBOX_FILE_MAX_LENGTH = 1024 * 1024;
+const sandboxFilesQuerySchema = z.strictObject({
+  snapshotId: z.string().min(1).max(512).optional(),
+  path: z.string().max(4096).optional()
+});
+const sandboxFileQuerySchema = z.strictObject({
+  snapshotId: z.string().min(1).max(512).optional(),
+  path: z.string().min(1).max(4096),
+  offset: z.coerce.number().int().nonnegative().optional(),
+  length: z.coerce.number().int().positive().max(SANDBOX_FILE_MAX_LENGTH).optional()
+});
+const sandboxFileContentQuerySchema = z.strictObject({
+  snapshotId: z.string().min(1).max(512).optional(),
+  path: z.string().min(1).max(4096),
+  download: z.stringbool({ truthy: ["true"], falsy: ["false"] }).optional()
+});
+const sandboxEditorSessionSchema = z.object({
+  id: z.string(),
+  authorizationId: z.string(),
+  workingDirectory: z.string(),
+  url: z.string(),
+  expiresAt: z.string(),
+  authentication: z.object({ url: z.string(), fields: z.record(z.string(), z.string()) })
+});
+const sandboxEditorAuthorizationSchema = z.strictObject({
+  authorizationId: z.string().min(1).max(256)
+});
+const sandboxPreviewOptionsSchema = z.object({ viewOnly: z.boolean().default(true) });
+export {
+  ConversationSandboxKind,
+  ConversationSandboxStatus,
+  SANDBOX_FILE_MAX_LENGTH,
+  SandboxAccessLevel,
+  SandboxEntryKind,
+  SandboxFileEncoding,
+  SandboxPreviewKind,
+  conversationSandboxListSchema,
+  conversationSandboxSchema,
+  sandboxDirEntrySchema,
+  sandboxDirectorySchema,
+  sandboxEditorAuthorizationSchema,
+  sandboxEditorSessionSchema,
+  sandboxFileContentQuerySchema,
+  sandboxFileQuerySchema,
+  sandboxFileSchema,
+  sandboxFilesQuerySchema,
+  sandboxPathSchema,
+  sandboxPreviewOptionsSchema,
+  sandboxPreviewSchema,
+  sandboxSearchQuerySchema,
+  sandboxSearchSchema
+};
+//# sourceMappingURL=sandboxes.mjs.map

package/dist/modules/agent-platform/sandboxes.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/agent-platform/sandboxes.ts"],
+  "sourcesContent": ["import * as z from 'zod';\n\nimport { tolerantStringEnum, tolerantTaggedUnion, WireFallback } from \"../tolerance.mjs\";\n\nimport { nullableNumber, nullableString } from \"./common.mjs\";\n\n// A conversation's sandboxes (the computer tile): `/api/v1/conversations/:id/sandboxes`.\n// Read-only for members; nothing here starts a parked sandbox except `wake`.\n\nexport enum ConversationSandboxKind {\n  Computer = 'computer',\n  Device = 'device',\n  Other = 'other',\n}\n\nexport enum ConversationSandboxStatus {\n  Pending = 'pending',\n  Starting = 'starting',\n  Running = 'running',\n  Parked = 'parked',\n  Ended = 'ended',\n  Failed = 'failed',\n}\n\nexport enum SandboxAccessLevel {\n  Read = 'read',\n  // Runs processes without writing files.\n  Execute = 'execute',\n  Write = 'write',\n}\n\nexport enum SandboxEntryKind {\n  File = 'file',\n  Directory = 'directory',\n  Symlink = 'symlink',\n  Other = 'other',\n}\n\nexport enum SandboxFileEncoding {\n  Utf8 = 'utf8',\n  Base64 = 'base64',\n}\n\nexport enum SandboxPreviewKind {\n  Image = 'image',\n  Url = 'url',\n}\n\nexport const conversationSandboxSchema = z.object({\n  bindingId: z.string(),\n  /** The manifest's target name (`computer`). */\n  target: z.string(),\n  /** Provider reference text (`package:@finalai/final-agent-provider/sandboxes/computer`). */\n  provider: z.string(),\n  kind: tolerantStringEnum(ConversationSandboxKind),\n  status: tolerantStringEnum(ConversationSandboxStatus),\n  access: tolerantStringEnum(SandboxAccessLevel),\n  /** What the agents' manifests bind to it (`files`, `process`, `computerUse`, `screen`, \u2026). */\n  capabilities: z.array(z.string()).default([]),\n  /** Agent participants whose sessions use it. */\n  agentParticipantIds: z.array(z.string()).default([]),\n  /** A screen preview can be requested now (running, and a provider that may serve one). */\n  previewAvailable: z.boolean().default(false),\n  /** A live or saved workspace can be read without waking the sandbox. */\n  filesAvailable: z.boolean().optional(),\n  /** Authorized editor access through the provider, while this sandbox runs. */\n  canEdit: z.boolean().optional(),\n  canControlScreen: z.boolean().optional(),\n  /** The viewer may wake it (`POST \u2026/wake`): conversation owners and admins. */\n  canWake: z.boolean().default(false),\n  updatedAt: nullableString(),\n});\n\nexport type ConversationSandboxIface = z.infer<typeof conversationSandboxSchema>;\n\nexport const conversationSandboxListSchema = z.object({\n  sandboxes: z.array(conversationSandboxSchema).default([]),\n});\n\nexport const sandboxDirEntrySchema = z.object({\n  name: z.string(),\n  path: z.string(),\n  kind: tolerantStringEnum(SandboxEntryKind),\n  size: nullableNumber(),\n});\n\nexport type SandboxDirEntryIface = z.infer<typeof sandboxDirEntrySchema>;\n\nconst fileSnapshotSchema = z\n  .object({ id: z.string(), capturedAt: z.string() })\n  .nullable()\n  .optional();\n\n/** `GET \u2026/sandboxes/:bindingId/files?path=`: one directory, directories first. */\nexport const sandboxDirectorySchema = z.object({\n  snapshot: fileSnapshotSchema,\n  bindingId: z.string(),\n  path: z.string(),\n  /** The workspace root every path is confined to. */\n  root: z.string(),\n  entries: z.array(sandboxDirEntrySchema).default([]),\n  /** More entries exist than were returned. */\n  truncated: z.boolean().default(false),\n});\n\nexport type SandboxDirectoryIface = z.infer<typeof sandboxDirectorySchema>;\n\nexport const sandboxPathSchema = z.object({\n  snapshot: fileSnapshotSchema,\n  bindingId: z.string(),\n  root: z.string(),\n  path: z.string(),\n  exists: z.boolean(),\n  kind: tolerantStringEnum(SandboxEntryKind).nullable(),\n  size: nullableNumber(),\n  modifiedAt: nullableString(),\n});\n\nexport type SandboxPathIface = z.infer<typeof sandboxPathSchema>;\n\nexport const sandboxSearchSchema = sandboxDirectorySchema.extend({ query: z.string() });\n\nexport type SandboxSearchIface = z.infer<typeof sandboxSearchSchema>;\n\nexport const sandboxSearchQuerySchema = z.strictObject({\n  path: z.string().max(4096).optional(),\n  query: z.string().trim().min(2).max(256),\n  limit: z.coerce.number().int().positive().max(200).optional(),\n});\n\n/** `GET \u2026/sandboxes/:bindingId/file?path=&offset=&length=`: one byte range of a file. */\nexport const sandboxFileSchema = z.object({\n  snapshot: fileSnapshotSchema,\n  bindingId: z.string(),\n  path: z.string(),\n  size: nullableNumber(),\n  offset: z.number().default(0),\n  /** Bytes returned. */\n  length: z.number().default(0),\n  /** Bytes remain after this range. */\n  truncated: z.boolean().default(false),\n  encoding: tolerantStringEnum(SandboxFileEncoding),\n  content: z.string().default(''),\n  modifiedAt: nullableString(),\n});\n\nexport type SandboxFileIface = z.infer<typeof sandboxFileSchema>;\n\n/** `GET \u2026/sandboxes/:bindingId/preview`: a short-lived look at the screen. */\nexport const sandboxPreviewSchema = tolerantTaggedUnion(\n  [\n    z.object({\n      kind: z.literal(SandboxPreviewKind.Url),\n      /** A view-only remote-screen URL; `token` authorizes it when not embedded. */\n      url: z.string(),\n      token: nullableString(),\n      expiresAt: nullableString(),\n    }),\n    z.object({\n      kind: z.literal(SandboxPreviewKind.Image),\n      contentType: z.string(),\n      dataBase64: z.string(),\n      expiresAt: nullableString(),\n    }),\n  ],\n  z\n    .object({ kind: z.string() })\n    .transform((preview) => ({ kind: WireFallback.Unrecognized, rawKind: preview.kind })),\n);\n\nexport type SandboxPreviewType = z.infer<typeof sandboxPreviewSchema>;\n\n// Client-to-server requests.\n\nexport const SANDBOX_FILE_MAX_LENGTH = 1024 * 1024;\n\nexport const sandboxFilesQuerySchema = z.strictObject({\n  snapshotId: z.string().min(1).max(512).optional(),\n  path: z.string().max(4096).optional(),\n});\n\nexport const sandboxFileQuerySchema = z.strictObject({\n  snapshotId: z.string().min(1).max(512).optional(),\n  path: z.string().min(1).max(4096),\n  offset: z.coerce.number().int().nonnegative().optional(),\n  length: z.coerce.number().int().positive().max(SANDBOX_FILE_MAX_LENGTH).optional(),\n});\n\n/** Raw file bytes, with optional HTTP Range; never starts a sleeping sandbox. */\nexport const sandboxFileContentQuerySchema = z.strictObject({\n  snapshotId: z.string().min(1).max(512).optional(),\n  path: z.string().min(1).max(4096),\n  download: z.stringbool({ truthy: ['true'], falsy: ['false'] }).optional(),\n});\n\nexport const sandboxEditorSessionSchema = z.object({\n  id: z.string(),\n  authorizationId: z.string(),\n  workingDirectory: z.string(),\n  url: z.string(),\n  expiresAt: z.string(),\n  authentication: z.object({ url: z.string(), fields: z.record(z.string(), z.string()) }),\n});\n\nexport type SandboxEditorSessionIface = z.infer<typeof sandboxEditorSessionSchema>;\n\nexport const sandboxEditorAuthorizationSchema = z.strictObject({\n  authorizationId: z.string().min(1).max(256),\n});\n\nexport const sandboxPreviewOptionsSchema = z.object({ viewOnly: z.boolean().default(true) });\n"],
+  "mappings": "AAAA,YAAY,OAAO;AAEnB,SAAS,oBAAoB,qBAAqB,oBAAoB;AAEtE,SAAS,gBAAgB,sBAAsB;AAKxC,IAAK,0BAAL,kBAAKA,6BAAL;AACL,EAAAA,yBAAA,cAAW;AACX,EAAAA,yBAAA,YAAS;AACT,EAAAA,yBAAA,WAAQ;AAHE,SAAAA;AAAA,GAAA;AAML,IAAK,4BAAL,kBAAKC,+BAAL;AACL,EAAAA,2BAAA,aAAU;AACV,EAAAA,2BAAA,cAAW;AACX,EAAAA,2BAAA,aAAU;AACV,EAAAA,2BAAA,YAAS;AACT,EAAAA,2BAAA,WAAQ;AACR,EAAAA,2BAAA,YAAS;AANC,SAAAA;AAAA,GAAA;AASL,IAAK,qBAAL,kBAAKC,wBAAL;AACL,EAAAA,oBAAA,UAAO;AAEP,EAAAA,oBAAA,aAAU;AACV,EAAAA,oBAAA,WAAQ;AAJE,SAAAA;AAAA,GAAA;AAOL,IAAK,mBAAL,kBAAKC,sBAAL;AACL,EAAAA,kBAAA,UAAO;AACP,EAAAA,kBAAA,eAAY;AACZ,EAAAA,kBAAA,aAAU;AACV,EAAAA,kBAAA,WAAQ;AAJE,SAAAA;AAAA,GAAA;AAOL,IAAK,sBAAL,kBAAKC,yBAAL;AACL,EAAAA,qBAAA,UAAO;AACP,EAAAA,qBAAA,YAAS;AAFC,SAAAA;AAAA,GAAA;AAKL,IAAK,qBAAL,kBAAKC,wBAAL;AACL,EAAAA,oBAAA,WAAQ;AACR,EAAAA,oBAAA,SAAM;AAFI,SAAAA;AAAA,GAAA;AAKL,MAAM,4BAA4B,EAAE,OAAO;AAAA,EAChD,WAAW,EAAE,OAAO;AAAA;AAAA,EAEpB,QAAQ,EAAE,OAAO;AAAA;AAAA,EAEjB,UAAU,EAAE,OAAO;AAAA,EACnB,MAAM,mBAAmB,uBAAuB;AAAA,EAChD,QAAQ,mBAAmB,yBAAyB;AAAA,EACpD,QAAQ,mBAAmB,kBAAkB;AAAA;AAAA,EAE7C,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;AAAA;AAAA,EAE5C,qBAAqB,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;AAAA;AAAA,EAEnD,kBAAkB,EAAE,QAAQ,EAAE,QAAQ,KAAK;AAAA;AAAA,EAE3C,gBAAgB,EAAE,QAAQ,EAAE,SAAS;AAAA;AAAA,EAErC,SAAS,EAAE,QAAQ,EAAE,SAAS;AAAA,EAC9B,kBAAkB,EAAE,QAAQ,EAAE,SAAS;AAAA;AAAA,EAEvC,SAAS,EAAE,QAAQ,EAAE,QAAQ,KAAK;AAAA,EAClC,WAAW,eAAe;AAC5B,CAAC;AAIM,MAAM,gCAAgC,EAAE,OAAO;AAAA,EACpD,WAAW,EAAE,MAAM,yBAAyB,EAAE,QAAQ,CAAC,CAAC;AAC1D,CAAC;AAEM,MAAM,wBAAwB,EAAE,OAAO;AAAA,EAC5C,MAAM,EAAE,OAAO;AAAA,EACf,MAAM,EAAE,OAAO;AAAA,EACf,MAAM,mBAAmB,gBAAgB;AAAA,EACzC,MAAM,eAAe;AACvB,CAAC;AAID,MAAM,qBAAqB,EACxB,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,YAAY,EAAE,OAAO,EAAE,CAAC,EACjD,SAAS,EACT,SAAS;AAGL,MAAM,yBAAyB,EAAE,OAAO;AAAA,EAC7C,UAAU;AAAA,EACV,WAAW,EAAE,OAAO;AAAA,EACpB,MAAM,EAAE,OAAO;AAAA;AAAA,EAEf,MAAM,EAAE,OAAO;AAAA,EACf,SAAS,EAAE,MAAM,qBAAqB,EAAE,QAAQ,CAAC,CAAC;AAAA;AAAA,EAElD,WAAW,EAAE,QAAQ,EAAE,QAAQ,KAAK;AACtC,CAAC;AAIM,MAAM,oBAAoB,EAAE,OAAO;AAAA,EACxC,UAAU;AAAA,EACV,WAAW,EAAE,OAAO;AAAA,EACpB,MAAM,EAAE,OAAO;AAAA,EACf,MAAM,EAAE,OAAO;AAAA,EACf,QAAQ,EAAE,QAAQ;AAAA,EAClB,MAAM,mBAAmB,gBAAgB,EAAE,SAAS;AAAA,EACpD,MAAM,eAAe;AAAA,EACrB,YAAY,eAAe;AAC7B,CAAC;AAIM,MAAM,sBAAsB,uBAAuB,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAI/E,MAAM,2BAA2B,EAAE,aAAa;AAAA,EACrD,MAAM,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,SAAS;AAAA,EACpC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EACvC,OAAO,EAAE,OAAO,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,GAAG,EAAE,SAAS;AAC9D,CAAC;AAGM,MAAM,oBAAoB,EAAE,OAAO;AAAA,EACxC,UAAU;AAAA,EACV,WAAW,EAAE,OAAO;AAAA,EACpB,MAAM,EAAE,OAAO;AAAA,EACf,MAAM,eAAe;AAAA,EACrB,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC;AAAA;AAAA,EAE5B,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC;AAAA;AAAA,EAE5B,WAAW,EAAE,QAAQ,EAAE,QAAQ,KAAK;AAAA,EACpC,UAAU,mBAAmB,mBAAmB;AAAA,EAChD,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE;AAAA,EAC9B,YAAY,eAAe;AAC7B,CAAC;AAKM,MAAM,uBAAuB;AAAA,EAClC;AAAA,IACE,EAAE,OAAO;AAAA,MACP,MAAM,EAAE,QAAQ,eAAsB;AAAA;AAAA,MAEtC,KAAK,EAAE,OAAO;AAAA,MACd,OAAO,eAAe;AAAA,MACtB,WAAW,eAAe;AAAA,IAC5B,CAAC;AAAA,IACD,EAAE,OAAO;AAAA,MACP,MAAM,EAAE,QAAQ,mBAAwB;AAAA,MACxC,aAAa,EAAE,OAAO;AAAA,MACtB,YAAY,EAAE,OAAO;AAAA,MACrB,WAAW,eAAe;AAAA,IAC5B,CAAC;AAAA,EACH;AAAA,EACA,EACG,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAC3B,UAAU,CAAC,aAAa,EAAE,MAAM,aAAa,cAAc,SAAS,QAAQ,KAAK,EAAE;AACxF;AAMO,MAAM,0BAA0B,OAAO;AAEvC,MAAM,0BAA0B,EAAE,aAAa;AAAA,EACpD,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS;AAAA,EAChD,MAAM,EAAE,OAAO,EAAE,IAAI,IAAI,EAAE,SAAS;AACtC,CAAC;AAEM,MAAM,yBAAyB,EAAE,aAAa;AAAA,EACnD,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS;AAAA,EAChD,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,IAAI;AAAA,EAChC,QAAQ,EAAE,OAAO,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS;AAAA,EACvD,QAAQ,EAAE,OAAO,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,uBAAuB,EAAE,SAAS;AACnF,CAAC;AAGM,MAAM,gCAAgC,EAAE,aAAa;AAAA,EAC1D,YAAY,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS;AAAA,EAChD,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,IAAI;AAAA,EAChC,UAAU,EAAE,WAAW,EAAE,QAAQ,CAAC,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,EAAE,SAAS;AAC1E,CAAC;AAEM,MAAM,6BAA6B,EAAE,OAAO;AAAA,EACjD,IAAI,EAAE,OAAO;AAAA,EACb,iBAAiB,EAAE,OAAO;AAAA,EAC1B,kBAAkB,EAAE,OAAO;AAAA,EAC3B,KAAK,EAAE,OAAO;AAAA,EACd,WAAW,EAAE,OAAO;AAAA,EACpB,gBAAgB,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,QAAQ,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC;AACxF,CAAC;AAIM,MAAM,mCAAmC,EAAE,aAAa;AAAA,EAC7D,iBAAiB,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAC5C,CAAC;AAEM,MAAM,8BAA8B,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,IAAI,EAAE,CAAC;",
+  "names": ["ConversationSandboxKind", "ConversationSandboxStatus", "SandboxAccessLevel", "SandboxEntryKind", "SandboxFileEncoding", "SandboxPreviewKind"]
+}