refactor: Improve documentation and simplify dataset default properties assignment

Author: jirispilka

src/tools/structured_output_schemas.ts

@@ -402,7 +402,8 @@ export function buildEnrichedDirectActorOutputSchema(itemProperties: Record<stri
         properties: itemProperties,
     };
     const clone = structuredClone(getActorRunOutputSchema);
-    (clone.properties.storages.properties.datasets.properties.default.properties as Record<string, unknown>).itemsSchema = itemsSchema;
+    const datasetDefaultProps = clone.properties.storages.properties.datasets.properties.default.properties as Record<string, unknown>;
+    datasetDefaultProps.itemsSchema = itemsSchema;
     return clone;
 }
 

src/utils/schema_generation.ts

@@ -21,9 +21,11 @@ export type SchemaGenerationOptions = {
     clean?: boolean;
 };
 
-// Local counterpart to the dataset API's `clean=true` — empty arrays carry no schema info.
-// Strips only empty arrays; keeps null / '' / empty objects so schema inference still sees those fields.
-// Stricter sibling: `cleanEmptyProperties` in `src/tools/common/get_actor_output.ts` also strips nullish and empty strings.
+/**
+ * Local counterpart to the dataset API's `clean=true` — empty arrays carry no schema info.
+ * Strips only empty arrays; keeps null / '' / empty objects so schema inference still sees those fields.
+ * Stricter sibling: `cleanEmptyProperties` in `src/tools/common/get_actor_output.ts` also strips nullish and empty strings.
+ */
 export function cleanEmptyArrays(obj: unknown): unknown {
     if (Array.isArray(obj)) {
         return obj.map(cleanEmptyArrays);