@apify/actors-mcp-server 0.11.7-beta.0 → 0.11.7-beta.10

package/dist/tools/runs/get_actor_run.js

@@ -36,29 +36,6 @@ USAGE:
 USAGE EXAMPLES:
 - user_input: Show details of run y2h7sK3Wc
 - user_input: Wait for run y2h7sK3Wc to finish`;
-/**
- * Shared tool metadata for `get-actor-run` — everything except the `call` handler.
- * Mode-independent. Widget `_meta` lives in the widget variant.
- */
-export const getActorRunMetadata = {
-    type: TOOL_TYPE.INTERNAL,
-    name: HELPER_TOOLS.ACTOR_RUNS_GET,
-    title: 'Get Actor run',
-    description: GET_ACTOR_RUN_DESCRIPTION,
-    // `fixZodSchemaRequired` strips fields with a real `default` from `required` so MCP clients
-    // that read `tools/list` see `waitSecs` as optional (matching its runtime behavior).
-    inputSchema: fixZodSchemaRequired(z.toJSONSchema(getActorRunArgs)),
-    outputSchema: actorRunOutputSchema,
-    ajvValidate: compileSchema(z.toJSONSchema(getActorRunArgs)),
-    paymentRequired: true,
-    annotations: {
-        title: 'Get Actor run',
-        readOnlyHint: true,
-        destructiveHint: false,
-        idempotentHint: true,
-        openWorldHint: false,
-    },
-};
 // -----------------------------------------------------------------------------
 // Response builders
 // -----------------------------------------------------------------------------
@@ -106,7 +83,23 @@ export function buildGetActorRunWidgetResponse(params) {
  * Default mode `get-actor-run` — returns without any widget metadata.
  */
 export const getActorRun = Object.freeze({
-    ...getActorRunMetadata,
+    type: TOOL_TYPE.INTERNAL,
+    name: HELPER_TOOLS.ACTOR_RUNS_GET,
+    title: 'Get Actor run',
+    description: GET_ACTOR_RUN_DESCRIPTION,
+    // `fixZodSchemaRequired` strips fields with a real `default` from `required` so MCP clients
+    // that read `tools/list` see `waitSecs` as optional (matching its runtime behavior).
+    inputSchema: fixZodSchemaRequired(z.toJSONSchema(getActorRunArgs)),
+    outputSchema: actorRunOutputSchema,
+    ajvValidate: compileSchema(z.toJSONSchema(getActorRunArgs)),
+    paymentRequired: true,
+    annotations: {
+        title: 'Get Actor run',
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false,
+    },
     call: async (toolArgs) => {
         const { args, apifyClient: client, apifyToken, progressTracker, mcpSessionId, extra } = toolArgs;
         const parsed = getActorRunArgs.parse(args);

package/dist/tools/runs/get_actor_run.js.map

@@ -1 +1 @@
-{"version":3,"file":"get_actor_run.js","sourceRoot":"","sources":["../../../src/tools/runs/get_actor_run.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"get_actor_run.js","sourceRoot":"","sources":["../../../src/tools/runs/get_actor_run.ts"],"names":[],"mappings":"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"}

package/dist/tools/storage/get_dataset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get_dataset.d.ts","sourceRoot":"","sources":["../../../src/tools/storage/get_dataset.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAenF;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,SAgEd,CAAC"}
+{"version":3,"file":"get_dataset.d.ts","sourceRoot":"","sources":["../../../src/tools/storage/get_dataset.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAenF;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,SAiEd,CAAC"}

package/dist/tools/storage/get_dataset.js

@@ -21,18 +21,19 @@ export const getDataset = Object.freeze({
     name: HELPER_TOOLS.DATASET_GET,
     title: 'Get dataset',
     description: dedent `
-        Get metadata for a dataset (collection of structured data created by an Actor run).
-        The results will include dataset details such as itemCount, fields, and stats.
-        Use fields to understand structure for filtering with ${HELPER_TOOLS.DATASET_GET_ITEMS}.
+        Get metadata for a dataset — a collection of structured data produced by an Actor run.
+        Returns the field list and item counts, not the row data — use ${HELPER_TOOLS.DATASET_GET_ITEMS} for the data, ${HELPER_TOOLS.DATASET_SCHEMA_GET} for inferred field types.
+        Do not use when the user asks to retrieve, show, or get results/data/rows — use ${HELPER_TOOLS.DATASET_GET_ITEMS}.
         stats.inflatedBytes (when present) is the approximate uncompressed byte size — use it with itemCount to pick a safe limit and fields before fetching.
         Note: itemCount updates may be delayed by up to ~5 seconds.
 
         USAGE:
-        - Use when you need dataset metadata to understand its structure before fetching items.
+        - Use when you need dataset metadata: item count, stats, or the field list.
+        - Call this tool alone — do not also call ${HELPER_TOOLS.DATASET_SCHEMA_GET}.
 
         USAGE EXAMPLES:
         - user_input: Show info for dataset xyz123
-        - user_input: What fields does username~my-dataset have?`,
+        - user_input: How many items does dataset xyz123 have?`,
     inputSchema: z.toJSONSchema(getDatasetArgs),
     outputSchema: datasetMetadataOutputSchema,
     ajvValidate: compileSchema(z.toJSONSchema(getDatasetArgs)),

package/dist/tools/storage/get_dataset.js.map

@@ -1 +1 @@
-{"version":3,"file":"get_dataset.js","sourceRoot":"","sources":["../../../src/tools/storage/get_dataset.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"get_dataset.js","sourceRoot":"","sources":["../../../src/tools/storage/get_dataset.ts"],"names":[],"mappings":"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"}

package/dist/tools/storage/get_dataset_items.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get_dataset_items.d.ts","sourceRoot":"","sources":["../../../src/tools/storage/get_dataset_items.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AASnF,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C,qGAAqG;AACrG,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAS7D;AAoCD;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,SA4EnB,CAAC"}
+{"version":3,"file":"get_dataset_items.d.ts","sourceRoot":"","sources":["../../../src/tools/storage/get_dataset_items.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AASnF,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C,qGAAqG;AACrG,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAS7D;AAoCD;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,SA0EnB,CAAC"}

package/dist/tools/storage/get_dataset_items.js

@@ -32,7 +32,7 @@ const getDatasetItemsArgs = z.object({
         .int()
         .min(1)
         .optional()
-        .describe(`Maximum number of items to return. Defaults to ${DEFAULT_DATASET_ITEMS_LIMIT}.`),
+        .describe(`Maximum number of items to return. Default is ${DEFAULT_DATASET_ITEMS_LIMIT}.`),
     fields: z
         .string()
         .optional()
@@ -55,18 +55,16 @@ export const getDatasetItems = Object.freeze({
     name: HELPER_TOOLS.DATASET_GET_ITEMS,
     title: 'Get dataset items',
     description: dedent `
-        Retrieve dataset items with pagination, sorting, and field selection.
-        Items can be large; when you only need specific columns, pass fields to reduce response size (use ${HELPER_TOOLS.DATASET_GET} first if you don't know the field names).
-        For nested fields use dot notation (e.g., fields="metadata.url") — the server auto-flattens parent prefixes.
-        Defaults limit to ${DEFAULT_DATASET_ITEMS_LIMIT}. Use clean=true to skip empty items and hidden fields.
-
-        The results will include items along with pagination info (limit, offset) and total count.
+        Get items (rows) from a dataset — the output/results produced by an Actor run.
+        Not metadata or schema — use ${HELPER_TOOLS.DATASET_GET} for counts and the field list, ${HELPER_TOOLS.DATASET_SCHEMA_GET} for a JSON schema from a sample.
+        When the user provides a datasetId and asks to retrieve results, output, data, or rows, call this tool directly — do not call ${HELPER_TOOLS.DATASET_GET} first.
+        Default limit is ${DEFAULT_DATASET_ITEMS_LIMIT}. Use clean=true to skip empty items and hidden fields.
 
         USAGE:
         - Use when you need to read data from a dataset (all items or only selected fields).
 
         USAGE EXAMPLES:
-        - user_input: Get first 20 items from dataset abd123
+        - user_input: Retrieve results from dataset abc123
         - user_input: Get only metadata.url and title from dataset username~my-dataset`,
     inputSchema: z.toJSONSchema(getDatasetItemsArgs),
     outputSchema: datasetItemsOutputSchema,

package/dist/tools/storage/get_dataset_items.js.map

@@ -1 +1 @@
-{"version":3,"file":"get_dataset_items.js","sourceRoot":"","sources":["../../../src/tools/storage/get_dataset_items.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAC5F,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,gCAAgC,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE7G,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,CAAC;AAE9C,qGAAqG;AACrG,MAAM,UAAU,kBAAkB,CAAC,MAAgB;IAC/C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACf,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC3C,CAAC;IACL,CAAC;IACD,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IAC7E,KAAK,EAAE,CAAC;SACH,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACL,mIAAmI,CACtI;IACL,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;IAC7F,KAAK,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,kDAAkD,2BAA2B,GAAG,CAAC;IAC/F,MAAM,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACL,wDAAwD;QACpD,4CAA4C;QAC5C,sGAAsG,CAC7G;IACL,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;IAC/F,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oEAAoE,CAAC;IAC3G,OAAO,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACL,gIAAgI;QAC5H,sGAAsG,CAC7G;CACR,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAc,MAAM,CAAC,MAAM,CAAC;IACpD,IAAI,EAAE,SAAS,CAAC,QAAQ;IACxB,IAAI,EAAE,YAAY,CAAC,iBAAiB;IACpC,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EAAE,MAAM,CAAA;;4GAEqF,YAAY,CAAC,WAAW;;4BAExG,2BAA2B;;;;;;;;;uFASgC;IACnF,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,mBAAmB,CAAoB;IACnE,YAAY,EAAE,wBAAwB;IACtC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC;IAC/D,eAAe,EAAE,IAAI;IACrB,WAAW,EAAE;QACT,KAAK,EAAE,mBAAmB;QAC1B,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB;IACD,IAAI,EAAE,KAAK,EAAE,QAA0B,EAAE,EAAE;;QACvC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,QAAQ,CAAC;QAC3E,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE/C,MAAM,MAAM,GAAG,uBAAuB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,uBAAuB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,OAAO,GACT,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,uBAAuB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAExG,MAAM,cAAc,GAAG,MAAA,MAAM,CAAC,KAAK,mCAAI,2BAA2B,CAAC;QACnE,MAAM,SAAS,GAAG,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACvD,MAAM,CAAC,GAAG,MAAM,aAAa,CACzB,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC;YAChC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,cAAc;YACrB,MAAM;YACN,IAAI;YACJ,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO;SACV,CAAC,CACL,CAAC;QACF,IAAI,CAAC,CAAC,EAAE,CAAC;YACL,OAAO,gBAAgB,CAAC,YAAY,SAAS,cAAc,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,MAAM,GAAG,MAAA,MAAM,CAAC,MAAM,mCAAI,CAAC,CAAC;QAClC,MAAM,eAAe,GAAG,sBAAsB,CAAC,MAAM,qBAAqB,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC;QAC3G,MAAM,iBAAiB,GAAG;YACtB,SAAS;YACT,eAAe;YACf,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM;YACzB,cAAc,EAAE,CAAC,CAAC,KAAK;YACvB,MAAM;YACN,KAAK,EAAE,cAAc;SACxB,CAAC;QAEF,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,gCAAgC,CAAC;YAC3D,SAAS;YACT,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM;YACzB,cAAc,EAAE,CAAC,CAAC,KAAK;YACvB,MAAM;YACN,eAAe,EAAE,cAAc,CAAC,aAAa,EAAE;SAClD,CAAC,CAAC;QACH,OAAO,oBAAoB,CAAC,EAAE,iBAAiB,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,CAAC;IAC3F,CAAC;CACK,CAAC,CAAC"}
+{"version":3,"file":"get_dataset_items.js","sourceRoot":"","sources":["../../../src/tools/storage/get_dataset_items.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAC5F,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,gCAAgC,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE7G,MAAM,CAAC,MAAM,2BAA2B,GAAG,EAAE,CAAC;AAE9C,qGAAqG;AACrG,MAAM,UAAU,kBAAkB,CAAC,MAAgB;IAC/C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACf,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC3C,CAAC;IACL,CAAC;IACD,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sCAAsC,CAAC;IAC7E,KAAK,EAAE,CAAC;SACH,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACL,mIAAmI,CACtI;IACL,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;IAC7F,KAAK,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,iDAAiD,2BAA2B,GAAG,CAAC;IAC9F,MAAM,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACL,wDAAwD;QACpD,4CAA4C;QAC5C,sGAAsG,CAC7G;IACL,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;IAC/F,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oEAAoE,CAAC;IAC3G,OAAO,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACL,gIAAgI;QAC5H,sGAAsG,CAC7G;CACR,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAc,MAAM,CAAC,MAAM,CAAC;IACpD,IAAI,EAAE,SAAS,CAAC,QAAQ;IACxB,IAAI,EAAE,YAAY,CAAC,iBAAiB;IACpC,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EAAE,MAAM,CAAA;;uCAEgB,YAAY,CAAC,WAAW,mCAAmC,YAAY,CAAC,kBAAkB;wIACO,YAAY,CAAC,WAAW;2BACrI,2BAA2B;;;;;;;uFAOiC;IACnF,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,mBAAmB,CAAoB;IACnE,YAAY,EAAE,wBAAwB;IACtC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAC;IAC/D,eAAe,EAAE,IAAI;IACrB,WAAW,EAAE;QACT,KAAK,EAAE,mBAAmB;QAC1B,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB;IACD,IAAI,EAAE,KAAK,EAAE,QAA0B,EAAE,EAAE;;QACvC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,GAAG,QAAQ,CAAC;QAC3E,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAE/C,MAAM,MAAM,GAAG,uBAAuB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,uBAAuB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,OAAO,GACT,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,uBAAuB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAExG,MAAM,cAAc,GAAG,MAAA,MAAM,CAAC,KAAK,mCAAI,2BAA2B,CAAC;QACnE,MAAM,SAAS,GAAG,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACvD,MAAM,CAAC,GAAG,MAAM,aAAa,CACzB,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC;YAChC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,cAAc;YACrB,MAAM;YACN,IAAI;YACJ,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO;SACV,CAAC,CACL,CAAC;QACF,IAAI,CAAC,CAAC,EAAE,CAAC;YACL,OAAO,gBAAgB,CAAC,YAAY,SAAS,cAAc,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,MAAM,GAAG,MAAA,MAAM,CAAC,MAAM,mCAAI,CAAC,CAAC;QAClC,MAAM,eAAe,GAAG,sBAAsB,CAAC,MAAM,qBAAqB,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC;QAC3G,MAAM,iBAAiB,GAAG;YACtB,SAAS;YACT,eAAe;YACf,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM;YACzB,cAAc,EAAE,CAAC,CAAC,KAAK;YACvB,MAAM;YACN,KAAK,EAAE,cAAc;SACxB,CAAC;QAEF,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,gCAAgC,CAAC;YAC3D,SAAS;YACT,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM;YACzB,cAAc,EAAE,CAAC,CAAC,KAAK;YACvB,MAAM;YACN,eAAe,EAAE,cAAc,CAAC,aAAa,EAAE;SAClD,CAAC,CAAC;QACH,OAAO,oBAAoB,CAAC,EAAE,iBAAiB,EAAE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,CAAC;IAC3F,CAAC;CACK,CAAC,CAAC"}

package/dist/tools/storage/get_dataset_list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get_dataset_list.d.ts","sourceRoot":"","sources":["../../../src/tools/storage/get_dataset_list.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AA4BnF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,SAmDlB,CAAC"}
+{"version":3,"file":"get_dataset_list.d.ts","sourceRoot":"","sources":["../../../src/tools/storage/get_dataset_list.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AA4BnF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,SAkDlB,CAAC"}

package/dist/tools/storage/get_dataset_list.js

@@ -8,20 +8,20 @@ import { buildStorageListSummaryNextStep, buildStorageResponse } from './storage
 const getUserDatasetsListArgs = z.object({
     offset: z
         .number()
-        .describe('Number of array elements that should be skipped at the start. The default value is 0.')
+        .describe('Number of array elements that should be skipped at the start. Default is 0.')
         .default(0),
     limit: z
         .number()
         .max(20)
-        .describe('Maximum number of array elements to return. The default value is 10, the maximum is 20.')
+        .describe('Maximum number of array elements to return. Default is 10. Maximum is 20.')
         .default(10),
     desc: z
         .boolean()
-        .describe('If true or 1 then the datasets are sorted by the createdAt field in descending order. Default: sorted in ascending order.')
+        .describe('If true or 1 then the datasets are sorted by the createdAt field in descending order. Default is false (ascending order).')
         .default(false),
     unnamed: z
         .boolean()
-        .describe('If true or 1 then all the datasets are returned. By default only named datasets are returned.')
+        .describe('If true or 1 then all the datasets are returned. Default is false (named datasets only).')
         .default(false),
 });
 /**
@@ -32,12 +32,11 @@ export const getDatasetList = Object.freeze({
     name: HELPER_TOOLS.DATASET_LIST_GET,
     title: 'Get user datasets list',
     description: dedent `
-        List datasets (collections of Actor run data) for the authenticated user.
-        Actor runs automatically produce unnamed datasets (set unnamed=true to include them). Users can also create named datasets.
-
-        The results will include datasets with itemCount, access settings, and usage stats, sorted by createdAt (ascending by default).
+        List the datasets owned by the authenticated user — collections of structured data produced by Actor runs.
+        Returns summaries only, not their contents — use ${HELPER_TOOLS.DATASET_GET} to inspect one from the list.
+        Actor runs automatically produce unnamed datasets (set unnamed=true to include them); users can also create named datasets.
         Each dataset's stats.inflatedBytes is its approximate uncompressed byte size — use it with itemCount to gauge size before fetching.
-        Use limit (max 20), offset, and desc to paginate and sort.
+        Sorted by createdAt (ascending by default); use limit (max 20), offset, and desc to paginate and sort.
 
         USAGE:
         - Use when you need to browse available datasets (named or unnamed) to locate data.

package/dist/tools/storage/get_dataset_list.js.map

@@ -1 +1 @@
-{"version":3,"file":"get_dataset_list.js","sourceRoot":"","sources":["../../../src/tools/storage/get_dataset_list.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,+BAA+B,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE7F,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,MAAM,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,CAAC,uFAAuF,CAAC;SACjG,OAAO,CAAC,CAAC,CAAC;IACf,KAAK,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CAAC,yFAAyF,CAAC;SACnG,OAAO,CAAC,EAAE,CAAC;IAChB,IAAI,EAAE,CAAC;SACF,OAAO,EAAE;SACT,QAAQ,CACL,2HAA2H,CAC9H;SACA,OAAO,CAAC,KAAK,CAAC;IACnB,OAAO,EAAE,CAAC;SACL,OAAO,EAAE;SACT,QAAQ,CAAC,+FAA+F,CAAC;SACzG,OAAO,CAAC,KAAK,CAAC;CACtB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAc,MAAM,CAAC,MAAM,CAAC;IACnD,IAAI,EAAE,SAAS,CAAC,QAAQ;IACxB,IAAI,EAAE,YAAY,CAAC,gBAAgB;IACnC,KAAK,EAAE,wBAAwB;IAC/B,WAAW,EAAE,MAAM,CAAA;;;;;;;;;;;;;4CAaqB;IACxC,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,uBAAuB,CAAoB;IACvE,YAAY,EAAE,uBAAuB;IACrC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,uBAAuB,CAAC,CAAC;IACnE,WAAW,EAAE;QACT,KAAK,EAAE,wBAAwB;QAC/B,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB;IACD,IAAI,EAAE,KAAK,EAAE,QAA0B,EAAE,EAAE;QACvC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;QAC/C,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC;YAC1C,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;SAC1B,CAAC,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,+BAA+B,CAAC;YAC1D,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM;YAC5B,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,IAAI,EAAE,UAAU;YAChB,YAAY,EAAE,YAAY,CAAC,gBAAgB;YAC3C,WAAW,EAAE,OAAO,YAAY,CAAC,WAAW,uDAAuD;SACtG,CAAC,CAAC;QACH,OAAO,oBAAoB,CAAC;YACxB,iBAAiB,EAAE,QAA8C;YACjE,OAAO;YACP,QAAQ;SACX,CAAC,CAAC;IACP,CAAC;CACK,CAAC,CAAC"}
+{"version":3,"file":"get_dataset_list.js","sourceRoot":"","sources":["../../../src/tools/storage/get_dataset_list.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,+BAA+B,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE7F,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,MAAM,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,CAAC,6EAA6E,CAAC;SACvF,OAAO,CAAC,CAAC,CAAC;IACf,KAAK,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CAAC,2EAA2E,CAAC;SACrF,OAAO,CAAC,EAAE,CAAC;IAChB,IAAI,EAAE,CAAC;SACF,OAAO,EAAE;SACT,QAAQ,CACL,2HAA2H,CAC9H;SACA,OAAO,CAAC,KAAK,CAAC;IACnB,OAAO,EAAE,CAAC;SACL,OAAO,EAAE;SACT,QAAQ,CAAC,0FAA0F,CAAC;SACpG,OAAO,CAAC,KAAK,CAAC;CACtB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAc,MAAM,CAAC,MAAM,CAAC;IACnD,IAAI,EAAE,SAAS,CAAC,QAAQ;IACxB,IAAI,EAAE,YAAY,CAAC,gBAAgB;IACnC,KAAK,EAAE,wBAAwB;IAC/B,WAAW,EAAE,MAAM,CAAA;;2DAEoC,YAAY,CAAC,WAAW;;;;;;;;;;4CAUvC;IACxC,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,uBAAuB,CAAoB;IACvE,YAAY,EAAE,uBAAuB;IACrC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,uBAAuB,CAAC,CAAC;IACnE,WAAW,EAAE;QACT,KAAK,EAAE,wBAAwB;QAC/B,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB;IACD,IAAI,EAAE,KAAK,EAAE,QAA0B,EAAE,EAAE;QACvC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;QAC/C,MAAM,MAAM,GAAG,uBAAuB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC;YAC1C,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;SAC1B,CAAC,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,+BAA+B,CAAC;YAC1D,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM;YAC5B,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,IAAI,EAAE,UAAU;YAChB,YAAY,EAAE,YAAY,CAAC,gBAAgB;YAC3C,WAAW,EAAE,OAAO,YAAY,CAAC,WAAW,uDAAuD;SACtG,CAAC,CAAC;QACH,OAAO,oBAAoB,CAAC;YACxB,iBAAiB,EAAE,QAA8C;YACjE,OAAO;YACP,QAAQ;SACX,CAAC,CAAC;IACP,CAAC;CACK,CAAC,CAAC"}

package/dist/tools/storage/get_dataset_schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get_dataset_schema.d.ts","sourceRoot":"","sources":["../../../src/tools/storage/get_dataset_schema.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAkBnF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAiEpB,CAAC"}
+{"version":3,"file":"get_dataset_schema.d.ts","sourceRoot":"","sources":["../../../src/tools/storage/get_dataset_schema.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAkBnF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAmEpB,CAAC"}

package/dist/tools/storage/get_dataset_schema.js

@@ -24,12 +24,14 @@ export const getDatasetSchema = Object.freeze({
     name: HELPER_TOOLS.DATASET_SCHEMA_GET,
     title: 'Get dataset schema',
     description: dedent `
-        Generate a JSON schema from a sample of dataset items.
-        The schema describes the structure of the data and can be used for validation, documentation, or processing.
-        Use this to understand the dataset before fetching many items.
+        Generate a JSON schema inferred from a sample of dataset items — field names and types.
+        Not the full field list, item counts, or stats — use ${HELPER_TOOLS.DATASET_GET} for those.
+        The schema can be used for validation, documentation, or processing.
+
+        Do not use for metadata, stats, or fetching rows — use ${HELPER_TOOLS.DATASET_GET} or ${HELPER_TOOLS.DATASET_GET_ITEMS}.
 
         USAGE:
-        - Use when you need to infer the structure of dataset items for downstream processing or validation.
+        - Use when the user asks for a JSON schema or to infer structure/shape from a sample.
 
         USAGE EXAMPLES:
         - user_input: Generate schema for dataset 34das2 using 10 items

package/dist/tools/storage/get_dataset_schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"get_dataset_schema.js","sourceRoot":"","sources":["../../../src/tools/storage/get_dataset_schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"get_dataset_schema.js","sourceRoot":"","sources":["../../../src/tools/storage/get_dataset_schema.ts"],"names":[],"mappings":"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"}

package/dist/tools/storage/get_key_value_store.js

@@ -9,7 +9,7 @@ import { respondUserError } from '../../utils/mcp.js';
 import { keyValueStoreOutputSchema } from '../structured_output_schemas.js';
 import { buildStorageResponse } from './storage_helpers.js';
 const getKeyValueStoreArgs = z.object({
-    keyValueStoreId: z.string().min(1).describe('Key-value store ID or username~store-name'),
+    keyValueStoreId: z.string().min(1).describe('Key-value store ID or username~store-name.'),
 });
 /**
  * https://docs.apify.com/api/v2/key-value-store-get
@@ -19,8 +19,8 @@ export const getKeyValueStore = Object.freeze({
     name: HELPER_TOOLS.KEY_VALUE_STORE_GET,
     title: 'Get key-value store',
     description: dedent `
-        Get details about a key-value store by ID or username~store-name.
-        The results will include store metadata (ID, name, owner, access settings) and usage statistics.
+        Get metadata for a key-value store — a flexible store for unstructured data or files.
+        Returns store details and usage stats, not its records — use ${HELPER_TOOLS.KEY_VALUE_STORE_KEYS_GET} to list what it holds.
 
         USAGE:
         - Use when you need to inspect a store to locate records or understand its properties.

package/dist/tools/storage/get_key_value_store.js.map

@@ -1 +1 @@
-{"version":3,"file":"get_key_value_store.js","sourceRoot":"","sources":["../../../src/tools/storage/get_key_value_store.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAClG,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,2CAA2C,CAAC;CAC3F,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAc,MAAM,CAAC,MAAM,CAAC;IACrD,IAAI,EAAE,SAAS,CAAC,QAAQ;IACxB,IAAI,EAAE,YAAY,CAAC,mBAAmB;IACtC,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EAAE,MAAM,CAAA;;;;;;;;;mDAS4B;IAC/C,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,oBAAoB,CAAoB;IACpE,YAAY,EAAE,yBAAyB;IACvC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC;IAChE,eAAe,EAAE,IAAI;IACrB,WAAW,EAAE;QACT,KAAK,EAAE,qBAAqB;QAC5B,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB;IACD,IAAI,EAAE,KAAK,EAAE,QAA0B,EAAE,EAAE;;QACvC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,QAAQ,CAAC;QAC3D,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,eAAe,GAAG,kBAAkB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QACnE,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC,GAAG,EAAE,CAAC;QAClE,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,OAAO,gBAAgB,CAAC,oBAAoB,eAAe,cAAc,CAAC,CAAC;QAC/E,CAAC;QACD,MAAM,WAAW,GAAG,MAAM,qBAAqB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACpE,MAAM,KAAK,GAAG,MAAC,OAAO,CAAC,KAA+C,0CAAE,YAAY,CAAC;QACrF,MAAM,OAAO,GAAG,oBAAoB,MAAA,OAAO,CAAC,IAAI,mCAAI,eAAe,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;QAC7H,MAAM,QAAQ,GAAG,OAAO,YAAY,CAAC,wBAAwB,yBAAyB,eAAe,gBAAgB,CAAC;QACtH,OAAO,oBAAoB,CAAC;YACxB,iBAAiB,EAAE,OAA6C;YAChE,OAAO;YACP,QAAQ;YACR,eAAe,EAAE,4BAA4B,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,CAAC;SACzE,CAAC,CAAC;IACP,CAAC;CACK,CAAC,CAAC"}
+{"version":3,"file":"get_key_value_store.js","sourceRoot":"","sources":["../../../src/tools/storage/get_key_value_store.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAClG,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC;CAC5F,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAc,MAAM,CAAC,MAAM,CAAC;IACrD,IAAI,EAAE,SAAS,CAAC,QAAQ;IACxB,IAAI,EAAE,YAAY,CAAC,mBAAmB;IACtC,KAAK,EAAE,qBAAqB;IAC5B,WAAW,EAAE,MAAM,CAAA;;uEAEgD,YAAY,CAAC,wBAAwB;;;;;;;mDAOzD;IAC/C,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,oBAAoB,CAAoB;IACpE,YAAY,EAAE,yBAAyB;IACvC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC;IAChE,eAAe,EAAE,IAAI;IACrB,WAAW,EAAE;QACT,KAAK,EAAE,qBAAqB;QAC5B,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB;IACD,IAAI,EAAE,KAAK,EAAE,QAA0B,EAAE,EAAE;;QACvC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,QAAQ,CAAC;QAC3D,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,eAAe,GAAG,kBAAkB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QACnE,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC,GAAG,EAAE,CAAC;QAClE,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,OAAO,gBAAgB,CAAC,oBAAoB,eAAe,cAAc,CAAC,CAAC;QAC/E,CAAC;QACD,MAAM,WAAW,GAAG,MAAM,qBAAqB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACpE,MAAM,KAAK,GAAG,MAAC,OAAO,CAAC,KAA+C,0CAAE,YAAY,CAAC;QACrF,MAAM,OAAO,GAAG,oBAAoB,MAAA,OAAO,CAAC,IAAI,mCAAI,eAAe,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;QAC7H,MAAM,QAAQ,GAAG,OAAO,YAAY,CAAC,wBAAwB,yBAAyB,eAAe,gBAAgB,CAAC;QACtH,OAAO,oBAAoB,CAAC;YACxB,iBAAiB,EAAE,OAA6C;YAChE,OAAO;YACP,QAAQ;YACR,eAAe,EAAE,4BAA4B,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,CAAC;SACzE,CAAC,CAAC;IACP,CAAC;CACK,CAAC,CAAC"}

package/dist/tools/storage/get_key_value_store_keys.js

@@ -9,12 +9,12 @@ import { respondUserError } from '../../utils/mcp.js';
 import { keyValueStoreKeysOutputSchema } from '../structured_output_schemas.js';
 import { buildKvsKeysSummaryNextStep, buildStorageResponse, catchNotFound } from './storage_helpers.js';
 const getKeyValueStoreKeysArgs = z.object({
-    keyValueStoreId: z.string().min(1).describe('Key-value store ID or username~store-name'),
+    keyValueStoreId: z.string().min(1).describe('Key-value store ID or username~store-name.'),
     exclusiveStartKey: z
         .string()
         .optional()
         .describe('All keys up to this one (including) are skipped from the result.'),
-    limit: z.number().max(10).optional().describe('Number of keys to be returned. Maximum value is 10.'),
+    limit: z.number().max(10).optional().describe('Number of keys to be returned. Maximum is 10.'),
 });
 /**
  * https://docs.apify.com/api/v2/key-value-store-keys-get
@@ -24,8 +24,8 @@ export const getKeyValueStoreKeys = Object.freeze({
     name: HELPER_TOOLS.KEY_VALUE_STORE_KEYS_GET,
     title: 'Get key-value store keys',
     description: dedent `
-        List keys in a key-value store with optional pagination.
-        The results will include keys and basic info about stored values (e.g., size).
+        List the keys in a key-value store — key names and basic info (e.g., size), not their values.
+        Use ${HELPER_TOOLS.KEY_VALUE_STORE_RECORD_GET} to read one.
         Use exclusiveStartKey and limit to paginate.
 
         USAGE:

package/dist/tools/storage/get_key_value_store_keys.js.map

@@ -1 +1 @@
-{"version":3,"file":"get_key_value_store_keys.js","sourceRoot":"","sources":["../../../src/tools/storage/get_key_value_store_keys.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"get_key_value_store_keys.js","sourceRoot":"","sources":["../../../src/tools/storage/get_key_value_store_keys.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAClG,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAExG,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACzF,iBAAiB,EAAE,CAAC;SACf,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kEAAkE,CAAC;IACjF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;CACjG,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAc,MAAM,CAAC,MAAM,CAAC;IACzD,IAAI,EAAE,SAAS,CAAC,QAAQ;IACxB,IAAI,EAAE,YAAY,CAAC,wBAAwB;IAC3C,KAAK,EAAE,0BAA0B;IACjC,WAAW,EAAE,MAAM,CAAA;;cAET,YAAY,CAAC,0BAA0B;;;;;;;;6EAQwB;IACzE,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,wBAAwB,CAAoB;IACxE,YAAY,EAAE,6BAA6B;IAC3C,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,wBAAwB,CAAC,CAAC;IACpE,eAAe,EAAE,IAAI;IACrB,WAAW,EAAE;QACT,KAAK,EAAE,0BAA0B;QACjC,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB;IACD,IAAI,EAAE,KAAK,EAAE,QAA0B,EAAE,EAAE;;QACvC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,QAAQ,CAAC;QAC3D,MAAM,MAAM,GAAG,wBAAwB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,eAAe,GAAG,kBAAkB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,MAAM,aAAa,CAC5B,MAAM;aACD,aAAa,CAAC,eAAe,CAAC;aAC9B,QAAQ,CAAC,EAAE,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CACtF,CAAC;QACF,IAAI,CAAC,IAAI,EAAE,CAAC;YACR,OAAO,gBAAgB,CAAC,oBAAoB,eAAe,cAAc,CAAC,CAAC;QAC/E,CAAC;QACD,MAAM,WAAW,GAAG,MAAM,qBAAqB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACpE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,2BAA2B,CAAC;YACtD,eAAe;YACf,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;YACxB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;YACjD,QAAQ,EAAE,MAAA,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,0CAAE,GAAG;SAC/B,CAAC,CAAC;QACH,OAAO,oBAAoB,CAAC;YACxB,iBAAiB,EAAE,EAAE,eAAe,EAAE,GAAG,IAAI,EAAE;YAC/C,OAAO;YACP,QAAQ;YACR,eAAe,EAAE,4BAA4B,CAAC,WAAW,EAAE,eAAe,CAAC;SAC9E,CAAC,CAAC;IACP,CAAC;CACK,CAAC,CAAC"}

package/dist/tools/storage/get_key_value_store_list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get_key_value_store_list.d.ts","sourceRoot":"","sources":["../../../src/tools/storage/get_key_value_store_list.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AA8BnF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAkDxB,CAAC"}
+{"version":3,"file":"get_key_value_store_list.d.ts","sourceRoot":"","sources":["../../../src/tools/storage/get_key_value_store_list.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AA4BnF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAiDxB,CAAC"}

package/dist/tools/storage/get_key_value_store_list.js

@@ -8,20 +8,20 @@ import { buildStorageListSummaryNextStep, buildStorageResponse } from './storage
 const getUserKeyValueStoresListArgs = z.object({
     offset: z
         .number()
-        .describe('Number of array elements that should be skipped at the start. The default is 0.')
+        .describe('Number of array elements that should be skipped at the start. Default is 0.')
         .default(0),
     limit: z
         .number()
         .max(10)
-        .describe('Maximum number of array elements to return. The default value (and maximum) is 10.')
+        .describe('Maximum number of array elements to return. Default is 10. Maximum is 10.')
         .default(10),
     desc: z
         .boolean()
-        .describe('If true or 1 then the stores are sorted by the createdAt field in descending order. Default: sorted in ascending order.')
+        .describe('If true or 1 then the stores are sorted by the createdAt field in descending order. Default is false (ascending order).')
         .default(false),
     unnamed: z
         .boolean()
-        .describe('If true or 1 then all the stores are returned. By default, only named key-value stores are returned.')
+        .describe('If true or 1 then all the stores are returned. Default is false (named key-value stores only).')
         .default(false),
 });
 /**
@@ -32,11 +32,10 @@ export const getKeyValueStoreList = Object.freeze({
     name: HELPER_TOOLS.KEY_VALUE_STORE_LIST_GET,
     title: 'Get user key-value stores list',
     description: dedent `
-        List key-value stores owned by the authenticated user.
-        Actor runs automatically produce unnamed stores (set unnamed=true to include them). Users can also create named stores.
-
-        The results will include basic info for each store, sorted by createdAt (ascending by default).
-        Use limit, offset, and desc to paginate and sort.
+        List the key-value stores owned by the authenticated user — flexible storage for unstructured data or files.
+        Returns summaries only, not their contents — use ${HELPER_TOOLS.KEY_VALUE_STORE_GET} to inspect one from the list.
+        Actor runs automatically produce unnamed stores (set unnamed=true to include them); users can also create named stores.
+        Sorted by createdAt (ascending by default); use limit, offset, and desc to paginate and sort.
 
         USAGE:
         - Use when you need to browse available key-value stores (named or unnamed).

package/dist/tools/storage/get_key_value_store_list.js.map

@@ -1 +1 @@
-{"version":3,"file":"get_key_value_store_list.js","sourceRoot":"","sources":["../../../src/tools/storage/get_key_value_store_list.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,+BAA+B,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE7F,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,CAAC,iFAAiF,CAAC;SAC3F,OAAO,CAAC,CAAC,CAAC;IACf,KAAK,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CAAC,oFAAoF,CAAC;SAC9F,OAAO,CAAC,EAAE,CAAC;IAChB,IAAI,EAAE,CAAC;SACF,OAAO,EAAE;SACT,QAAQ,CACL,yHAAyH,CAC5H;SACA,OAAO,CAAC,KAAK,CAAC;IACnB,OAAO,EAAE,CAAC;SACL,OAAO,EAAE;SACT,QAAQ,CACL,sGAAsG,CACzG;SACA,OAAO,CAAC,KAAK,CAAC;CACtB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAc,MAAM,CAAC,MAAM,CAAC;IACzD,IAAI,EAAE,SAAS,CAAC,QAAQ;IACxB,IAAI,EAAE,YAAY,CAAC,wBAAwB;IAC3C,KAAK,EAAE,gCAAgC;IACvC,WAAW,EAAE,MAAM,CAAA;;;;;;;;;;;;oDAY6B;IAChD,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,6BAA6B,CAAoB;IAC7E,YAAY,EAAE,uBAAuB;IACrC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,6BAA6B,CAAC,CAAC;IACzE,WAAW,EAAE;QACT,KAAK,EAAE,gCAAgC;QACvC,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB;IACD,IAAI,EAAE,KAAK,EAAE,QAA0B,EAAE,EAAE;QACvC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;QAC/C,MAAM,MAAM,GAAG,6BAA6B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC;YAC9C,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;SAC1B,CAAC,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,+BAA+B,CAAC;YAC1D,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;YAC1B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,kBAAkB;YACxB,YAAY,EAAE,YAAY,CAAC,wBAAwB;YACnD,WAAW,EAAE,OAAO,YAAY,CAAC,mBAAmB,2DAA2D;SAClH,CAAC,CAAC;QACH,OAAO,oBAAoB,CAAC;YACxB,iBAAiB,EAAE,MAA4C;YAC/D,OAAO;YACP,QAAQ;SACX,CAAC,CAAC;IACP,CAAC;CACK,CAAC,CAAC"}
+{"version":3,"file":"get_key_value_store_list.js","sourceRoot":"","sources":["../../../src/tools/storage/get_key_value_store_list.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,+BAA+B,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE7F,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,QAAQ,CAAC,6EAA6E,CAAC;SACvF,OAAO,CAAC,CAAC,CAAC;IACf,KAAK,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CAAC,2EAA2E,CAAC;SACrF,OAAO,CAAC,EAAE,CAAC;IAChB,IAAI,EAAE,CAAC;SACF,OAAO,EAAE;SACT,QAAQ,CACL,yHAAyH,CAC5H;SACA,OAAO,CAAC,KAAK,CAAC;IACnB,OAAO,EAAE,CAAC;SACL,OAAO,EAAE;SACT,QAAQ,CAAC,gGAAgG,CAAC;SAC1G,OAAO,CAAC,KAAK,CAAC;CACtB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAc,MAAM,CAAC,MAAM,CAAC;IACzD,IAAI,EAAE,SAAS,CAAC,QAAQ;IACxB,IAAI,EAAE,YAAY,CAAC,wBAAwB;IAC3C,KAAK,EAAE,gCAAgC;IACvC,WAAW,EAAE,MAAM,CAAA;;2DAEoC,YAAY,CAAC,mBAAmB;;;;;;;;;oDASvC;IAChD,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,6BAA6B,CAAoB;IAC7E,YAAY,EAAE,uBAAuB;IACrC,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,6BAA6B,CAAC,CAAC;IACzE,WAAW,EAAE;QACT,KAAK,EAAE,gCAAgC;QACvC,YAAY,EAAE,IAAI;QAClB,eAAe,EAAE,KAAK;QACtB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,KAAK;KACvB;IACD,IAAI,EAAE,KAAK,EAAE,QAA0B,EAAE,EAAE;QACvC,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;QAC/C,MAAM,MAAM,GAAG,6BAA6B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC;YAC9C,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;SAC1B,CAAC,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,+BAA+B,CAAC;YAC1D,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;YAC1B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,kBAAkB;YACxB,YAAY,EAAE,YAAY,CAAC,wBAAwB;YACnD,WAAW,EAAE,OAAO,YAAY,CAAC,mBAAmB,2DAA2D;SAClH,CAAC,CAAC;QACH,OAAO,oBAAoB,CAAC;YACxB,iBAAiB,EAAE,MAA4C;YAC/D,OAAO;YACP,QAAQ;SACX,CAAC,CAAC;IACP,CAAC;CACK,CAAC,CAAC"}

package/dist/tools/storage/get_key_value_store_record.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get_key_value_store_record.d.ts","sourceRoot":"","sources":["../../../src/tools/storage/get_key_value_store_record.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAcnF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,SA2H1B,CAAC"}
+{"version":3,"file":"get_key_value_store_record.d.ts","sourceRoot":"","sources":["../../../src/tools/storage/get_key_value_store_record.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAmBnF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,SA8H1B,CAAC"}

package/dist/tools/storage/get_key_value_store_record.js

@@ -1,15 +1,15 @@
 import dedent from 'dedent';
 import { z } from 'zod';
-import { HELPER_TOOLS, KV_RECORD_MAX_INLINE_BYTES } from '../../const.js';
+import { HELPER_TOOLS } from '../../const.js';
 import { TOOL_TYPE } from '../../types.js';
 import { compileSchema } from '../../utils/ajv.js';
 import { buildConsoleKeyValueStoreUrl, getConsoleLinkContext } from '../../utils/console_link.js';
 import { computeValueBytes, stripQuoteWrappers } from '../../utils/generic.js';
 import { respondRaw, respondUserError } from '../../utils/mcp.js';
 import { keyValueStoreRecordOutputSchema } from '../structured_output_schemas.js';
-import { buildConsoleLinkContent, buildStorageResponse, normalizeRecordKey } from './storage_helpers.js';
+import { buildBinaryRecordDisposition, buildConsoleLinkContent, buildStorageResponse, normalizeRecordKey, } from './storage_helpers.js';
 const getKeyValueStoreRecordArgs = z.object({
-    keyValueStoreId: z.string().min(1).describe('Key-value store ID or username~store-name'),
+    keyValueStoreId: z.string().min(1).describe('Key-value store ID or username~store-name.'),
     recordKey: z.string().min(1).describe('Key of the record to retrieve.'),
 });
 /**
@@ -20,7 +20,8 @@ export const getKeyValueStoreRecord = Object.freeze({
     name: HELPER_TOOLS.KEY_VALUE_STORE_RECORD_GET,
     title: 'Get key-value store record',
     description: dedent `
-        Get a value stored in a key-value store under a specific key.
+        Get the value stored under a specific key in a key-value store — a single record, not a listing of all keys.
+        Use ${HELPER_TOOLS.KEY_VALUE_STORE_KEYS_GET} first if you don't know the key name.
         The response preserves the original Content-Encoding; most clients handle decompression automatically.
 
         USAGE:
@@ -72,8 +73,10 @@ export const getKeyValueStoreRecord = Object.freeze({
         // structuredContent — so emit a minimal schema-conforming descriptor alongside the block.
         // The Console link (Console UI token sessions) rides as a trailing text block.
         if (Buffer.isBuffer(value)) {
-            // Content-Type is case-insensitive; lowercase so the image/audio checks below don't miss `Image/PNG`.
-            const mimeType = contentType === null || contentType === void 0 ? void 0 : contentType.split(';')[0].trim().toLowerCase();
+            // Normalizes the MIME type (so the image/audio checks below don't miss `Image/PNG`) and
+            // decides inline-vs-link-out at the same MAX_INLINE_BYTES threshold the API-resource proxy uses.
+            const disposition = buildBinaryRecordDisposition(contentType, value);
+            const { mimeType } = disposition;
             const structuredContent = {
                 keyValueStoreId,
                 key: record.key,
@@ -82,7 +85,7 @@ export const getKeyValueStoreRecord = Object.freeze({
                 summary,
             };
             const consoleLinkContent = buildConsoleLinkContent(apifyConsoleUrl);
-            if (value.length > KV_RECORD_MAX_INLINE_BYTES) {
+            if (disposition.kind === 'linkOut') {
                 // base64-inlining a large binary would blow up the context window; return a link instead.
                 const uri = await store.getRecordPublicUrl(recordKey);
                 return respondRaw({
@@ -92,14 +95,14 @@ export const getKeyValueStoreRecord = Object.freeze({
                             type: 'resource_link',
                             uri,
                             name: recordKey,
-                            size: value.length,
+                            size: disposition.bytes,
                             ...(mimeType && { mimeType }),
                         },
                         ...consoleLinkContent,
                     ],
                 });
             }
-            const data = value.toString('base64');
+            const data = disposition.base64;
             if (mimeType === null || mimeType === void 0 ? void 0 : mimeType.startsWith('image/')) {
                 return respondRaw({
                     structuredContent,

package/dist/tools/storage/get_key_value_store_record.js.map

@@ -1 +1 @@
-{"version":3,"file":"get_key_value_store_record.js","sourceRoot":"","sources":["../../../src/tools/storage/get_key_value_store_record.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"get_key_value_store_record.js","sourceRoot":"","sources":["../../../src/tools/storage/get_key_value_store_record.ts"],"names":[],"mappings":"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"}

package/dist/tools/storage/storage_helpers.d.ts

@@ -84,4 +84,31 @@ export declare function buildKvsKeysSummaryNextStep(params: {
     nextStep: string;
 };
 export declare function normalizeRecordKey(key: string): string;
+/**
+ * How to surface a binary key-value-store record value: inline as base64 below
+ * `MAX_INLINE_BYTES`, otherwise link out (inlining a multi-MB blob would blow up the
+ * client's context). `mimeType` is the Content-Type with parameters stripped and lowercased
+ * (`Image/PNG; charset=…` → `image/png`), or `undefined` when no Content-Type was declared.
+ */
+export type BinaryRecordDisposition = {
+    kind: 'inline';
+    mimeType?: string;
+    base64: string;
+} | {
+    kind: 'linkOut';
+    mimeType?: string;
+    bytes: number;
+};
+/**
+ * Base MIME type of a Content-Type header: parameters stripped, lowercased
+ * (`Image/PNG; charset=…` → `image/png`), `undefined` when no header was declared.
+ * Shared by the get-key-value-store-record tool and the API-resource proxy.
+ */
+export declare function parseBaseMimeType(contentType: string | undefined): string | undefined;
+/**
+ * Build the transport disposition for a binary record value: normalize the MIME type, decide
+ * inline-vs-link-out at the byte threshold, base64-encode when inlining. It does NOT mint the
+ * link-out URL — the caller handles `linkOut` by minting its own URL via async calls.
+ */
+export declare function buildBinaryRecordDisposition(contentType: string | undefined, value: Buffer): BinaryRecordDisposition;
 //# sourceMappingURL=storage_helpers.d.ts.map

package/dist/tools/storage/storage_helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage_helpers.d.ts","sourceRoot":"","sources":["../../../src/tools/storage/storage_helpers.ts"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAS7E;AAMD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAE5F;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAG7G;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IACzC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qGAAqG;IACrG,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B,6CAQA;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACvB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CASxC;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,eAAe,EAAE,MAAM,EAAE,CAAC;CAC7B,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAkBxC;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAgBxC;AAWD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD"}
+{"version":3,"file":"storage_helpers.d.ts","sourceRoot":"","sources":["../../../src/tools/storage/storage_helpers.ts"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAS7E;AAMD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAE5F;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAG7G;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IACzC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qGAAqG;IACrG,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B,6CAQA;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACvB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CASxC;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,eAAe,EAAE,MAAM,EAAE,CAAC;CAC7B,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAkBxC;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAChD,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAgBxC;AAWD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAC7B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5D;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAErF;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,uBAAuB,CAMpH"}