@myagentroam/protocol 0.9.69 → 0.9.71

package/dist/direct-transfer.js

@@ -9,7 +9,6 @@ const resourceIdentifierSchema = z.string().trim().min(1).max(512);
 const relativePathSchema = z.string().min(1).max(4096);
 const safeIntegerSchema = z.number().int().min(0).max(Number.MAX_SAFE_INTEGER);
 const timestampSchema = z.number().int().positive();
-const sha256Schema = z.string().regex(/^[a-f0-9]{64}$/u);
 const fingerprintSchema = z.string().regex(/^sha-256(?: [A-F0-9]{2}(?::[A-F0-9]{2}){31})$/u);
 const sdpSchema = z
     .string()
@@ -18,10 +17,11 @@ const sdpSchema = z
 const candidateSchema = z.string().min(1).max(4096);
 export const workspaceDirectTransferCapabilitySchema = z
     .object({
-    apiVersion: z.literal(1),
-    probe: z.boolean(),
+    apiVersion: z.union([z.literal(2), z.literal(3)]),
+    transport: z.boolean(),
     upload: z.boolean(),
     download: z.boolean(),
+    range: z.boolean(),
     gitCommitBlob: z.boolean(),
     maxChunkBytes: z
         .number()
@@ -30,9 +30,8 @@ export const workspaceDirectTransferCapabilitySchema = z
         .max(1024 * 1024)
 })
     .strict();
-export const directTransferPurposeSchema = z.enum(['PROBE', 'TRANSFER']);
+export const directTransferPurposeSchema = z.enum(['TRANSPORT', 'TRANSFER']);
 export const directTransferDirectionSchema = z.enum(['UPLOAD', 'DOWNLOAD']);
-export const directTransferProbeResultSchema = z.enum(['DIRECT_AVAILABLE', 'RELAY_ONLY', 'STALE']);
 const workspaceFileResourceSchema = z
     .object({
     kind: z.literal('WORKSPACE_FILE'),
@@ -55,13 +54,16 @@ export const directTransferResourceSchema = z.discriminatedUnion('kind', [
     workspaceFileResourceSchema,
     gitCommitBlobResourceSchema
 ]);
-export const directTransferDescriptorSchema = z
+const directTransferDescriptorBaseSchema = z
     .object({
-    direction: directTransferDirectionSchema,
     resource: directTransferResourceSchema,
     fileName: z.string().trim().min(1).max(512),
-    size: safeIntegerSchema,
-    sha256: sha256Schema,
+    size: safeIntegerSchema
+})
+    .strict();
+const directUploadDescriptorSchema = directTransferDescriptorBaseSchema
+    .extend({
+    direction: z.literal('UPLOAD'),
     overwrite: z.boolean().optional(),
     resumeOffset: safeIntegerSchema.optional(),
     composerAttachment: z
@@ -80,20 +82,41 @@ export const directTransferDescriptorSchema = z
             path: ['resumeOffset'],
             message: 'resume offset cannot exceed the file size'
         });
-    if (descriptor.direction === 'DOWNLOAD' && descriptor.overwrite !== undefined)
-        context.addIssue({
-            code: 'custom',
-            path: ['overwrite'],
-            message: 'download descriptors cannot request overwrite'
-        });
     if (descriptor.composerAttachment !== undefined &&
-        (descriptor.direction !== 'UPLOAD' || descriptor.resource.kind !== 'WORKSPACE_FILE'))
+        descriptor.resource.kind !== 'WORKSPACE_FILE')
         context.addIssue({
             code: 'custom',
             path: ['composerAttachment'],
             message: 'composer attachments are supported only for Workspace uploads'
         });
 });
+const directDownloadDescriptorSchema = directTransferDescriptorBaseSchema
+    .extend({
+    direction: z.literal('DOWNLOAD'),
+    revision: z.string().trim().min(1).max(512),
+    range: z
+        .object({
+        offset: safeIntegerSchema,
+        length: safeIntegerSchema
+    })
+        .strict()
+        .optional()
+})
+    .strict()
+    .superRefine((descriptor, context) => {
+    if (descriptor.range !== undefined &&
+        (descriptor.range.length === 0 ||
+            descriptor.range.offset + descriptor.range.length > descriptor.size))
+        context.addIssue({
+            code: 'custom',
+            path: ['range'],
+            message: 'download range must be non-empty and fit within the file size'
+        });
+});
+export const directTransferDescriptorSchema = z.union([
+    directUploadDescriptorSchema,
+    directDownloadDescriptorSchema
+]);
 const directPrepareBaseSchema = z
     .object({
     type: z.literal('direct.prepare'),
@@ -103,10 +126,11 @@ const directPrepareBaseSchema = z
 })
     .strict();
 export const directPrepareRequestSchema = z.discriminatedUnion('purpose', [
-    directPrepareBaseSchema.extend({ purpose: z.literal('PROBE') }).strict(),
+    directPrepareBaseSchema.extend({ purpose: z.literal('TRANSPORT') }).strict(),
     directPrepareBaseSchema
         .extend({
         purpose: z.literal('TRANSFER'),
+        transportSessionId: identifierSchema,
         transfer: directTransferDescriptorSchema
     })
         .strict()
@@ -151,8 +175,7 @@ export const directBrowserMessageSchema = z.union([
     directSessionIdentitySchema
         .extend({
         type: z.literal('direct.complete'),
-        size: safeIntegerSchema,
-        sha256: sha256Schema
+        size: safeIntegerSchema
     })
         .strict(),
     directSessionIdentitySchema
@@ -172,6 +195,7 @@ export const directServerMessageSchema = z.discriminatedUnion('type', [
         nodeGeneration: identifierSchema,
         purpose: directTransferPurposeSchema,
         expiresAt: timestampSchema,
+        transportSessionId: identifierSchema.optional(),
         resumeOffset: safeIntegerSchema.optional()
     })
         .strict(),
@@ -186,13 +210,6 @@ export const directServerMessageSchema = z.discriminatedUnion('type', [
         expiresAt: timestampSchema
     })
         .strict(),
-    directSessionIdentitySchema
-        .extend({
-        type: z.literal('direct.probe-result'),
-        result: z.enum(['DIRECT_AVAILABLE', 'RELAY_ONLY']),
-        routingHint: z.string().min(8).max(512).optional()
-    })
-        .strict(),
     directSessionIdentitySchema
         .extend({
         type: z.literal('direct.heartbeat'),
@@ -209,8 +226,7 @@ export const directServerMessageSchema = z.discriminatedUnion('type', [
     directSessionIdentitySchema
         .extend({
         type: z.literal('direct.complete'),
-        size: safeIntegerSchema,
-        sha256: sha256Schema
+        size: safeIntegerSchema
     })
         .strict(),
     directSessionIdentitySchema
@@ -229,16 +245,28 @@ export const directServerMessageSchema = z.discriminatedUnion('type', [
     })
         .strict()
 ]);
-export const directNodeCommandSchema = z.discriminatedUnion('type', [
+export const directNodeCommandSchema = z.union([
     z
         .object({
         type: z.literal('direct.prepare'),
         directSessionId: identifierSchema,
         workbenchConnectionId: identifierSchema,
         nodeGeneration: identifierSchema,
-        purpose: directTransferPurposeSchema,
+        purpose: z.literal('TRANSPORT'),
+        expiresAt: timestampSchema,
+        userAuthorization: z.unknown()
+    })
+        .strict(),
+    z
+        .object({
+        type: z.literal('direct.prepare'),
+        directSessionId: identifierSchema,
+        transportSessionId: identifierSchema,
+        workbenchConnectionId: identifierSchema,
+        nodeGeneration: identifierSchema,
+        purpose: z.literal('TRANSFER'),
         expiresAt: timestampSchema,
-        transfer: directTransferDescriptorSchema.optional(),
+        transfer: directTransferDescriptorSchema,
         userAuthorization: z.unknown()
     })
         .strict(),
@@ -248,6 +276,7 @@ export const directNodeCommandSchema = z.discriminatedUnion('type', [
     directSessionIdentitySchema
         .extend({
         type: z.literal('direct.grant'),
+        transportSessionId: identifierSchema,
         grant: z.string().min(32).max(4096),
         browserFingerprint: fingerprintSchema,
         nodeFingerprint: fingerprintSchema,
@@ -255,7 +284,9 @@ export const directNodeCommandSchema = z.discriminatedUnion('type', [
         expiresAt: timestampSchema
     })
         .strict(),
-    directSessionIdentitySchema.extend({ type: z.literal('direct.heartbeat') }).strict(),
+    directSessionIdentitySchema
+        .extend({ type: z.literal('direct.heartbeat'), expiresAt: timestampSchema })
+        .strict(),
     directSessionIdentitySchema
         .extend({
         type: z.literal('direct.cancel'),
@@ -268,13 +299,6 @@ export const directNodeEventSchema = z.discriminatedUnion('type', [
         .extend({ type: z.literal('direct.signal'), signal: directSignalSchema })
         .strict(),
     directSessionIdentitySchema.extend({ type: z.literal('direct.connected') }).strict(),
-    directSessionIdentitySchema
-        .extend({
-        type: z.literal('direct.probe-result'),
-        result: z.enum(['DIRECT_AVAILABLE', 'RELAY_ONLY']),
-        routingHint: z.string().min(8).max(512).optional()
-    })
-        .strict(),
     directSessionIdentitySchema
         .extend({
         type: z.literal('direct.opened'),
@@ -284,8 +308,7 @@ export const directNodeEventSchema = z.discriminatedUnion('type', [
     directSessionIdentitySchema
         .extend({
         type: z.literal('direct.complete'),
-        size: safeIntegerSchema,
-        sha256: sha256Schema
+        size: safeIntegerSchema
     })
         .strict(),
     directSessionIdentitySchema
@@ -312,8 +335,7 @@ export const directDataAckFrameSchema = z
 export const directDataCompleteFrameSchema = z
     .object({
     type: z.literal('COMPLETE'),
-    size: safeIntegerSchema,
-    sha256: sha256Schema
+    size: safeIntegerSchema
 })
     .strict();
 export const directDataErrorFrameSchema = z

package/dist/enterprise.d.ts

@@ -224,9 +224,9 @@ export declare const auditEventSchema: z.ZodObject<{
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodNull]>>>;
 }, "strict", z.ZodTypeAny, {
     id: string;
-    result: "SUCCESS" | "DENIED" | "FAILED";
     eventType: string;
     occurredAt: number;
+    result: "SUCCESS" | "DENIED" | "FAILED";
     authenticationMethod: "PASSWORD" | "OAUTH2" | "SYSTEM";
     workspaceId?: string | null | undefined;
     requestId?: string | null | undefined;
@@ -250,9 +250,9 @@ export declare const auditEventSchema: z.ZodObject<{
     metadata?: Record<string, string | number | boolean | null> | undefined;
 }, {
     id: string;
-    result: "SUCCESS" | "DENIED" | "FAILED";
     eventType: string;
     occurredAt: number;
+    result: "SUCCESS" | "DENIED" | "FAILED";
     authenticationMethod: "PASSWORD" | "OAUTH2" | "SYSTEM";
     workspaceId?: string | null | undefined;
     requestId?: string | null | undefined;
@@ -357,9 +357,9 @@ export declare const auditEventDetailSchema: z.ZodObject<{
     }>>;
 }, "strict", z.ZodTypeAny, {
     id: string;
-    result: "SUCCESS" | "DENIED" | "FAILED";
     eventType: string;
     occurredAt: number;
+    result: "SUCCESS" | "DENIED" | "FAILED";
     authenticationMethod: "PASSWORD" | "OAUTH2" | "SYSTEM";
     workspaceId?: string | null | undefined;
     requestId?: string | null | undefined;
@@ -389,9 +389,9 @@ export declare const auditEventDetailSchema: z.ZodObject<{
     } | undefined;
 }, {
     id: string;
-    result: "SUCCESS" | "DENIED" | "FAILED";
     eventType: string;
     occurredAt: number;
+    result: "SUCCESS" | "DENIED" | "FAILED";
     authenticationMethod: "PASSWORD" | "OAUTH2" | "SYSTEM";
     workspaceId?: string | null | undefined;
     requestId?: string | null | undefined;