@apify/actors-mcp-server 0.11.7-beta.3 → 0.11.7-beta.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (31) hide show
  1. package/dist/tools/actors/search_actors.js +3 -3
  2. package/dist/tools/docs/search_apify_docs.d.ts.map +1 -1
  3. package/dist/tools/docs/search_apify_docs.js +1 -0
  4. package/dist/tools/docs/search_apify_docs.js.map +1 -1
  5. package/dist/tools/storage/get_dataset.d.ts.map +1 -1
  6. package/dist/tools/storage/get_dataset.js +6 -5
  7. package/dist/tools/storage/get_dataset.js.map +1 -1
  8. package/dist/tools/storage/get_dataset_items.d.ts.map +1 -1
  9. package/dist/tools/storage/get_dataset_items.js +6 -8
  10. package/dist/tools/storage/get_dataset_items.js.map +1 -1
  11. package/dist/tools/storage/get_dataset_list.d.ts.map +1 -1
  12. package/dist/tools/storage/get_dataset_list.js +8 -9
  13. package/dist/tools/storage/get_dataset_list.js.map +1 -1
  14. package/dist/tools/storage/get_dataset_schema.d.ts.map +1 -1
  15. package/dist/tools/storage/get_dataset_schema.js +6 -4
  16. package/dist/tools/storage/get_dataset_schema.js.map +1 -1
  17. package/dist/tools/storage/get_key_value_store.js +3 -3
  18. package/dist/tools/storage/get_key_value_store.js.map +1 -1
  19. package/dist/tools/storage/get_key_value_store_keys.js +4 -4
  20. package/dist/tools/storage/get_key_value_store_keys.js.map +1 -1
  21. package/dist/tools/storage/get_key_value_store_list.d.ts.map +1 -1
  22. package/dist/tools/storage/get_key_value_store_list.js +8 -9
  23. package/dist/tools/storage/get_key_value_store_list.js.map +1 -1
  24. package/dist/tools/storage/get_key_value_store_record.d.ts.map +1 -1
  25. package/dist/tools/storage/get_key_value_store_record.js +3 -2
  26. package/dist/tools/storage/get_key_value_store_record.js.map +1 -1
  27. package/dist/tsconfig.tsbuildinfo +1 -1
  28. package/dist/utils/actor_details.d.ts.map +1 -1
  29. package/dist/utils/actor_details.js +10 -3
  30. package/dist/utils/actor_details.js.map +1 -1
  31. package/package.json +1 -1
@@ -34,7 +34,7 @@ export const searchActorsBaseArgsSchema = z.object({
34
34
  - The goal is to find Actors that specifically handle the platform and data type the user mentioned
35
35
 
36
36
  Examples:
37
- ✅ "Instagram posts", "Twitter", "Amazon products", "weather", "news articles"
37
+ ✅ "Instagram posts", "Twitter", "Amazon products", "TikTok comments"
38
38
  ✅ "" (empty) — returns the most popular Actors store-wide
39
39
  ❌ "Instagram posts profiles comments hashtags reels stories followers..." (too long)
40
40
  ❌ "top popular actors", "best scrapers", "trending" — ranking words aren't Actor keywords; pass "" instead
@@ -63,8 +63,8 @@ Use this tool when user wants to:
63
63
  - Browse existing solutions (e.g., "Show me scrapers for news sites")
64
64
  - Learn about MCP servers or AI agents available in the Store
65
65
 
66
- Do NOT use this tool when user wants immediate data retrieval - use apify/rag-web-browser instead for getting actual data right now.
67
- IMPORTANT: There is a high chance that a relevant Actor already exists in the Apify Store so find it first before considering alternative solutions!
66
+ Do NOT use this tool when user wants immediate data retrieval (time words like "today", "latest", "recent", "current", "now", or "get/fetch data right now") — use apify/rag-web-browser instead.
67
+ IMPORTANT: When the user is looking for scraping tools or Actors, prefer searching the Store first — a relevant Actor often already exists. Do not use Store search as a substitute for immediate data retrieval.
68
68
 
69
69
  Usage:
70
70
  - Prefer broad, generic keywords - use just the platform name (e.g. "Instagram" instead of "Instagram scraper").
@@ -1 +1 @@
1
- {"version":3,"file":"search_apify_docs.d.ts","sourceRoot":"","sources":["../../../src/tools/docs/search_apify_docs.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAmEnF,eAAO,MAAM,eAAe,EAAE,SAiEnB,CAAC"}
1
+ {"version":3,"file":"search_apify_docs.d.ts","sourceRoot":"","sources":["../../../src/tools/docs/search_apify_docs.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAoB,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAoEnF,eAAO,MAAM,eAAe,EAAE,SAiEnB,CAAC"}
@@ -20,6 +20,7 @@ function buildDocSourceDescription() {
20
20
  function buildToolDescription() {
21
21
  const sources = DOCS_SOURCES.map((idx) => `• docSource="${idx.id}" - ${idx.label}:\n ${idx.description}`).join('\n\n');
22
22
  return `Search Apify and Crawlee documentation using full-text search.
23
+ Do not also call ${HELPER_TOOLS.STORE_SEARCH} unless the user asks to find Actors in the Apify store.
23
24
 
24
25
  You must explicitly select which documentation source to search using the docSource parameter:
25
26
 
@@ -1 +1 @@
1
- {"version":3,"file":"search_apify_docs.js","sourceRoot":"","sources":["../../../src/tools/docs/search_apify_docs.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"search_apify_docs.js","sourceRoot":"","sources":["../../../src/tools/docs/search_apify_docs.ts"],"names":[],"mappings":"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"}
@@ -1 +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"}
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,SAiEd,CAAC"}
@@ -21,18 +21,19 @@ export const getDataset = Object.freeze({
21
21
  name: HELPER_TOOLS.DATASET_GET,
22
22
  title: 'Get dataset',
23
23
  description: dedent `
24
- Get metadata for a dataset (collection of structured data created by an Actor run).
25
- The results will include dataset details such as itemCount, fields, and stats.
26
- Use fields to understand structure for filtering with ${HELPER_TOOLS.DATASET_GET_ITEMS}.
24
+ Get metadata for a dataset — a collection of structured data produced by an Actor run.
25
+ 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.
26
+ Do not use when the user asks to retrieve, show, or get results/data/rows — use ${HELPER_TOOLS.DATASET_GET_ITEMS}.
27
27
  stats.inflatedBytes (when present) is the approximate uncompressed byte size — use it with itemCount to pick a safe limit and fields before fetching.
28
28
  Note: itemCount updates may be delayed by up to ~5 seconds.
29
29
 
30
30
  USAGE:
31
- - Use when you need dataset metadata to understand its structure before fetching items.
31
+ - Use when you need dataset metadata: item count, stats, or the field list.
32
+ - Call this tool alone — do not also call ${HELPER_TOOLS.DATASET_SCHEMA_GET}.
32
33
 
33
34
  USAGE EXAMPLES:
34
35
  - user_input: Show info for dataset xyz123
35
- - user_input: What fields does username~my-dataset have?`,
36
+ - user_input: How many items does dataset xyz123 have?`,
36
37
  inputSchema: z.toJSONSchema(getDatasetArgs),
37
38
  outputSchema: datasetMetadataOutputSchema,
38
39
  ajvValidate: compileSchema(z.toJSONSchema(getDatasetArgs)),
@@ -1 +1 @@
1
- {"version":3,"file":"get_dataset.js","sourceRoot":"","sources":["../../../src/tools/storage/get_dataset.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"get_dataset.js","sourceRoot":"","sources":["../../../src/tools/storage/get_dataset.ts"],"names":[],"mappings":"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"}
@@ -1 +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"}
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,SA0EnB,CAAC"}
@@ -32,7 +32,7 @@ const getDatasetItemsArgs = z.object({
32
32
  .int()
33
33
  .min(1)
34
34
  .optional()
35
- .describe(`Maximum number of items to return. Defaults to ${DEFAULT_DATASET_ITEMS_LIMIT}.`),
35
+ .describe(`Maximum number of items to return. Default is ${DEFAULT_DATASET_ITEMS_LIMIT}.`),
36
36
  fields: z
37
37
  .string()
38
38
  .optional()
@@ -55,18 +55,16 @@ export const getDatasetItems = Object.freeze({
55
55
  name: HELPER_TOOLS.DATASET_GET_ITEMS,
56
56
  title: 'Get dataset items',
57
57
  description: dedent `
58
- Retrieve dataset items with pagination, sorting, and field selection.
59
- 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).
60
- For nested fields use dot notation (e.g., fields="metadata.url") — the server auto-flattens parent prefixes.
61
- Defaults limit to ${DEFAULT_DATASET_ITEMS_LIMIT}. Use clean=true to skip empty items and hidden fields.
62
-
63
- The results will include items along with pagination info (limit, offset) and total count.
58
+ Get items (rows) from a dataset — the output/results produced by an Actor run.
59
+ 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.
60
+ 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.
61
+ Default limit is ${DEFAULT_DATASET_ITEMS_LIMIT}. Use clean=true to skip empty items and hidden fields.
64
62
 
65
63
  USAGE:
66
64
  - Use when you need to read data from a dataset (all items or only selected fields).
67
65
 
68
66
  USAGE EXAMPLES:
69
- - user_input: Get first 20 items from dataset abd123
67
+ - user_input: Retrieve results from dataset abc123
70
68
  - user_input: Get only metadata.url and title from dataset username~my-dataset`,
71
69
  inputSchema: z.toJSONSchema(getDatasetItemsArgs),
72
70
  outputSchema: datasetItemsOutputSchema,
@@ -1 +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"}
1
+ {"version":3,"file":"get_dataset_items.js","sourceRoot":"","sources":["../../../src/tools/storage/get_dataset_items.ts"],"names":[],"mappings":"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"}
@@ -1 +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"}
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,SAkDlB,CAAC"}
@@ -8,20 +8,20 @@ import { buildStorageListSummaryNextStep, buildStorageResponse } from './storage
8
8
  const getUserDatasetsListArgs = z.object({
9
9
  offset: z
10
10
  .number()
11
- .describe('Number of array elements that should be skipped at the start. The default value is 0.')
11
+ .describe('Number of array elements that should be skipped at the start. Default is 0.')
12
12
  .default(0),
13
13
  limit: z
14
14
  .number()
15
15
  .max(20)
16
- .describe('Maximum number of array elements to return. The default value is 10, the maximum is 20.')
16
+ .describe('Maximum number of array elements to return. Default is 10. Maximum is 20.')
17
17
  .default(10),
18
18
  desc: z
19
19
  .boolean()
20
- .describe('If true or 1 then the datasets are sorted by the createdAt field in descending order. Default: sorted in ascending order.')
20
+ .describe('If true or 1 then the datasets are sorted by the createdAt field in descending order. Default is false (ascending order).')
21
21
  .default(false),
22
22
  unnamed: z
23
23
  .boolean()
24
- .describe('If true or 1 then all the datasets are returned. By default only named datasets are returned.')
24
+ .describe('If true or 1 then all the datasets are returned. Default is false (named datasets only).')
25
25
  .default(false),
26
26
  });
27
27
  /**
@@ -32,12 +32,11 @@ export const getDatasetList = Object.freeze({
32
32
  name: HELPER_TOOLS.DATASET_LIST_GET,
33
33
  title: 'Get user datasets list',
34
34
  description: dedent `
35
- List datasets (collections of Actor run data) for the authenticated user.
36
- Actor runs automatically produce unnamed datasets (set unnamed=true to include them). Users can also create named datasets.
37
-
38
- The results will include datasets with itemCount, access settings, and usage stats, sorted by createdAt (ascending by default).
35
+ List the datasets owned by the authenticated user — collections of structured data produced by Actor runs.
36
+ Returns summaries only, not their contents — use ${HELPER_TOOLS.DATASET_GET} to inspect one from the list.
37
+ Actor runs automatically produce unnamed datasets (set unnamed=true to include them); users can also create named datasets.
39
38
  Each dataset's stats.inflatedBytes is its approximate uncompressed byte size — use it with itemCount to gauge size before fetching.
40
- Use limit (max 20), offset, and desc to paginate and sort.
39
+ Sorted by createdAt (ascending by default); use limit (max 20), offset, and desc to paginate and sort.
41
40
 
42
41
  USAGE:
43
42
  - Use when you need to browse available datasets (named or unnamed) to locate data.
@@ -1 +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"}
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,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"}
@@ -1 +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"}
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,SAmEpB,CAAC"}
@@ -24,12 +24,14 @@ export const getDatasetSchema = Object.freeze({
24
24
  name: HELPER_TOOLS.DATASET_SCHEMA_GET,
25
25
  title: 'Get dataset schema',
26
26
  description: dedent `
27
- Generate a JSON schema from a sample of dataset items.
28
- The schema describes the structure of the data and can be used for validation, documentation, or processing.
29
- Use this to understand the dataset before fetching many items.
27
+ Generate a JSON schema inferred from a sample of dataset items — field names and types.
28
+ Not the full field list, item counts, or stats — use ${HELPER_TOOLS.DATASET_GET} for those.
29
+ The schema can be used for validation, documentation, or processing.
30
+
31
+ Do not use for metadata, stats, or fetching rows — use ${HELPER_TOOLS.DATASET_GET} or ${HELPER_TOOLS.DATASET_GET_ITEMS}.
30
32
 
31
33
  USAGE:
32
- - Use when you need to infer the structure of dataset items for downstream processing or validation.
34
+ - Use when the user asks for a JSON schema or to infer structure/shape from a sample.
33
35
 
34
36
  USAGE EXAMPLES:
35
37
  - user_input: Generate schema for dataset 34das2 using 10 items
@@ -1 +1 @@
1
- {"version":3,"file":"get_dataset_schema.js","sourceRoot":"","sources":["../../../src/tools/storage/get_dataset_schema.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"get_dataset_schema.js","sourceRoot":"","sources":["../../../src/tools/storage/get_dataset_schema.ts"],"names":[],"mappings":"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"}
@@ -9,7 +9,7 @@ import { respondUserError } from '../../utils/mcp.js';
9
9
  import { keyValueStoreOutputSchema } from '../structured_output_schemas.js';
10
10
  import { buildStorageResponse } from './storage_helpers.js';
11
11
  const getKeyValueStoreArgs = z.object({
12
- keyValueStoreId: z.string().min(1).describe('Key-value store ID or username~store-name'),
12
+ keyValueStoreId: z.string().min(1).describe('Key-value store ID or username~store-name.'),
13
13
  });
14
14
  /**
15
15
  * https://docs.apify.com/api/v2/key-value-store-get
@@ -19,8 +19,8 @@ export const getKeyValueStore = Object.freeze({
19
19
  name: HELPER_TOOLS.KEY_VALUE_STORE_GET,
20
20
  title: 'Get key-value store',
21
21
  description: dedent `
22
- Get details about a key-value store by ID or username~store-name.
23
- The results will include store metadata (ID, name, owner, access settings) and usage statistics.
22
+ Get metadata for a key-value store — a flexible store for unstructured data or files.
23
+ Returns store details and usage stats, not its records — use ${HELPER_TOOLS.KEY_VALUE_STORE_KEYS_GET} to list what it holds.
24
24
 
25
25
  USAGE:
26
26
  - Use when you need to inspect a store to locate records or understand its properties.
@@ -1 +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"}
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,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"}
@@ -9,12 +9,12 @@ import { respondUserError } from '../../utils/mcp.js';
9
9
  import { keyValueStoreKeysOutputSchema } from '../structured_output_schemas.js';
10
10
  import { buildKvsKeysSummaryNextStep, buildStorageResponse, catchNotFound } from './storage_helpers.js';
11
11
  const getKeyValueStoreKeysArgs = z.object({
12
- keyValueStoreId: z.string().min(1).describe('Key-value store ID or username~store-name'),
12
+ keyValueStoreId: z.string().min(1).describe('Key-value store ID or username~store-name.'),
13
13
  exclusiveStartKey: z
14
14
  .string()
15
15
  .optional()
16
16
  .describe('All keys up to this one (including) are skipped from the result.'),
17
- limit: z.number().max(10).optional().describe('Number of keys to be returned. Maximum value is 10.'),
17
+ limit: z.number().max(10).optional().describe('Number of keys to be returned. Maximum is 10.'),
18
18
  });
19
19
  /**
20
20
  * https://docs.apify.com/api/v2/key-value-store-keys-get
@@ -24,8 +24,8 @@ export const getKeyValueStoreKeys = Object.freeze({
24
24
  name: HELPER_TOOLS.KEY_VALUE_STORE_KEYS_GET,
25
25
  title: 'Get key-value store keys',
26
26
  description: dedent `
27
- List keys in a key-value store with optional pagination.
28
- The results will include keys and basic info about stored values (e.g., size).
27
+ List the keys in a key-value store — key names and basic info (e.g., size), not their values.
28
+ Use ${HELPER_TOOLS.KEY_VALUE_STORE_RECORD_GET} to read one.
29
29
  Use exclusiveStartKey and limit to paginate.
30
30
 
31
31
  USAGE:
@@ -1 +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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"}
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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"}
@@ -1 +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"}
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;AA4BnF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAiDxB,CAAC"}
@@ -8,20 +8,20 @@ import { buildStorageListSummaryNextStep, buildStorageResponse } from './storage
8
8
  const getUserKeyValueStoresListArgs = z.object({
9
9
  offset: z
10
10
  .number()
11
- .describe('Number of array elements that should be skipped at the start. The default is 0.')
11
+ .describe('Number of array elements that should be skipped at the start. Default is 0.')
12
12
  .default(0),
13
13
  limit: z
14
14
  .number()
15
15
  .max(10)
16
- .describe('Maximum number of array elements to return. The default value (and maximum) is 10.')
16
+ .describe('Maximum number of array elements to return. Default is 10. Maximum is 10.')
17
17
  .default(10),
18
18
  desc: z
19
19
  .boolean()
20
- .describe('If true or 1 then the stores are sorted by the createdAt field in descending order. Default: sorted in ascending order.')
20
+ .describe('If true or 1 then the stores are sorted by the createdAt field in descending order. Default is false (ascending order).')
21
21
  .default(false),
22
22
  unnamed: z
23
23
  .boolean()
24
- .describe('If true or 1 then all the stores are returned. By default, only named key-value stores are returned.')
24
+ .describe('If true or 1 then all the stores are returned. Default is false (named key-value stores only).')
25
25
  .default(false),
26
26
  });
27
27
  /**
@@ -32,11 +32,10 @@ export const getKeyValueStoreList = Object.freeze({
32
32
  name: HELPER_TOOLS.KEY_VALUE_STORE_LIST_GET,
33
33
  title: 'Get user key-value stores list',
34
34
  description: dedent `
35
- List key-value stores owned by the authenticated user.
36
- Actor runs automatically produce unnamed stores (set unnamed=true to include them). Users can also create named stores.
37
-
38
- The results will include basic info for each store, sorted by createdAt (ascending by default).
39
- Use limit, offset, and desc to paginate and sort.
35
+ List the key-value stores owned by the authenticated user — flexible storage for unstructured data or files.
36
+ Returns summaries only, not their contents — use ${HELPER_TOOLS.KEY_VALUE_STORE_GET} to inspect one from the list.
37
+ Actor runs automatically produce unnamed stores (set unnamed=true to include them); users can also create named stores.
38
+ Sorted by createdAt (ascending by default); use limit, offset, and desc to paginate and sort.
40
39
 
41
40
  USAGE:
42
41
  - Use when you need to browse available key-value stores (named or unnamed).
@@ -1 +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"}
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,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"}
@@ -1 +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;AAmBnF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,SA6H1B,CAAC"}
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;AAmBnF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,SA8H1B,CAAC"}
@@ -9,7 +9,7 @@ import { respondRaw, respondUserError } from '../../utils/mcp.js';
9
9
  import { keyValueStoreRecordOutputSchema } from '../structured_output_schemas.js';
10
10
  import { buildBinaryRecordDisposition, buildConsoleLinkContent, buildStorageResponse, normalizeRecordKey, } from './storage_helpers.js';
11
11
  const getKeyValueStoreRecordArgs = z.object({
12
- keyValueStoreId: z.string().min(1).describe('Key-value store ID or username~store-name'),
12
+ keyValueStoreId: z.string().min(1).describe('Key-value store ID or username~store-name.'),
13
13
  recordKey: z.string().min(1).describe('Key of the record to retrieve.'),
14
14
  });
15
15
  /**
@@ -20,7 +20,8 @@ export const getKeyValueStoreRecord = Object.freeze({
20
20
  name: HELPER_TOOLS.KEY_VALUE_STORE_RECORD_GET,
21
21
  title: 'Get key-value store record',
22
22
  description: dedent `
23
- Get a value stored in a key-value store under a specific key.
23
+ Get the value stored under a specific key in a key-value store — a single record, not a listing of all keys.
24
+ Use ${HELPER_TOOLS.KEY_VALUE_STORE_KEYS_GET} first if you don't know the key name.
24
25
  The response preserves the original Content-Encoding; most clients handle decompression automatically.
25
26
 
26
27
  USAGE:
@@ -1 +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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"}
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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"}