@sanity/cli 8.7.0 → 8.9.0

package/dist/services/context.js

@@ -0,0 +1,132 @@
+import { getGlobalCliClient } from '@sanity/cli-core';
+const CONTEXT_API_VERSION = 'v2026-08-25';
+/**
+ * Knowledge-base-scoped methods on `client.context` (imports, builds, jobs)
+ * operate on the client's configured `resource`; collection-level methods
+ * (`client.context.knowledgeBases.*`) are addressed per call and need none.
+ */ async function getContextClient(knowledgeBaseId) {
+    return getGlobalCliClient({
+        apiVersion: CONTEXT_API_VERSION,
+        requireUser: true,
+        ...knowledgeBaseId === undefined ? {} : {
+            resource: {
+                id: knowledgeBaseId,
+                type: 'knowledge-base'
+            }
+        }
+    });
+}
+/**
+ * Create a knowledge base in an organization
+ */ export async function createKnowledgeBase(params) {
+    const client = await getContextClient();
+    return client.context.knowledgeBases.create(params);
+}
+/**
+ * List all knowledge bases in an organization (drains pagination)
+ */ export async function listKnowledgeBases(organizationId) {
+    const client = await getContextClient();
+    const knowledgeBases = [];
+    let cursor;
+    do {
+        const page = await client.context.knowledgeBases.list({
+            cursor,
+            organizationId
+        });
+        knowledgeBases.push(...page.data);
+        cursor = page.nextCursor ?? undefined;
+    }while (cursor !== undefined)
+    return knowledgeBases;
+}
+/**
+ * Get a single knowledge base by ID
+ */ export async function getKnowledgeBase(knowledgeBaseId) {
+    const client = await getContextClient();
+    return client.context.knowledgeBases.get(knowledgeBaseId);
+}
+/**
+ * Update a knowledge base's configuration
+ */ export async function updateKnowledgeBase(knowledgeBaseId, params) {
+    const client = await getContextClient();
+    return client.context.knowledgeBases.edit(knowledgeBaseId, params);
+}
+/**
+ * Delete a knowledge base and its generated content
+ */ export async function deleteKnowledgeBase(knowledgeBaseId) {
+    const client = await getContextClient();
+    await client.context.knowledgeBases.delete(knowledgeBaseId);
+}
+/**
+ * Import content into a knowledge base. File imports are staged and uploaded
+ * to signed storage by the client.
+ */ export async function createImport(knowledgeBaseId, params) {
+    const client = await getContextClient(knowledgeBaseId);
+    return client.context.imports.create(params);
+}
+/**
+ * List all imports for a knowledge base (drains pagination)
+ */ export async function listImports(knowledgeBaseId) {
+    const client = await getContextClient(knowledgeBaseId);
+    const imports = [];
+    let cursor;
+    do {
+        const page = await client.context.imports.list({
+            cursor
+        });
+        imports.push(...page.data);
+        cursor = page.nextCursor ?? undefined;
+    }while (cursor !== undefined)
+    return imports;
+}
+/**
+ * Get a single import by ID
+ */ export async function getImport(knowledgeBaseId, importId) {
+    const client = await getContextClient(knowledgeBaseId);
+    return client.context.imports.get({
+        importId
+    });
+}
+/**
+ * Get a short-lived signed URL for an import's original uploaded bytes
+ */ export async function downloadImport(knowledgeBaseId, importId) {
+    const client = await getContextClient(knowledgeBaseId);
+    return client.context.imports.download({
+        importId
+    });
+}
+/**
+ * Delete an import from a knowledge base
+ */ export async function deleteImport(knowledgeBaseId, importId) {
+    const client = await getContextClient(knowledgeBaseId);
+    await client.context.imports.delete({
+        importId
+    });
+}
+/**
+ * Start a build of a knowledge base
+ */ export async function buildKnowledgeBase(knowledgeBaseId) {
+    const client = await getContextClient(knowledgeBaseId);
+    return client.context.build();
+}
+/**
+ * Cancel the running build of a knowledge base, if any
+ */ export async function cancelKnowledgeBaseBuild(knowledgeBaseId) {
+    const client = await getContextClient(knowledgeBaseId);
+    return client.context.cancelBuild();
+}
+/**
+ * Run an incremental refresh: re-check sources and apply what changed
+ */ export async function refreshKnowledgeBase(knowledgeBaseId) {
+    const client = await getContextClient(knowledgeBaseId);
+    return client.context.refresh();
+}
+/**
+ * Get an async job (build, import) by ID
+ */ export async function getJob(knowledgeBaseId, jobId) {
+    const client = await getContextClient(knowledgeBaseId);
+    return client.context.jobs.get({
+        jobId
+    });
+}
+
+//# sourceMappingURL=context.js.map

package/dist/services/context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/services/context.ts"],"sourcesContent":["import {getGlobalCliClient} from '@sanity/cli-core'\nimport {type Context} from '@sanity/client'\n\nconst CONTEXT_API_VERSION = 'v2026-08-25'\n\n/**\n * Knowledge-base-scoped methods on `client.context` (imports, builds, jobs)\n * operate on the client's configured `resource`; collection-level methods\n * (`client.context.knowledgeBases.*`) are addressed per call and need none.\n */\nasync function getContextClient(knowledgeBaseId?: string) {\n  return getGlobalCliClient({\n    apiVersion: CONTEXT_API_VERSION,\n    requireUser: true,\n    ...(knowledgeBaseId === undefined\n      ? {}\n      : {resource: {id: knowledgeBaseId, type: 'knowledge-base' as const}}),\n  })\n}\n\n/**\n * Create a knowledge base in an organization\n */\nexport async function createKnowledgeBase(\n  params: Context.CreateKnowledgeBaseParams,\n): Promise<Context.KnowledgeBase> {\n  const client = await getContextClient()\n  return client.context.knowledgeBases.create(params)\n}\n\n/**\n * List all knowledge bases in an organization (drains pagination)\n */\nexport async function listKnowledgeBases(organizationId: string): Promise<Context.KnowledgeBase[]> {\n  const client = await getContextClient()\n\n  const knowledgeBases: Context.KnowledgeBase[] = []\n  let cursor: string | undefined\n  do {\n    const page = await client.context.knowledgeBases.list({cursor, organizationId})\n    knowledgeBases.push(...page.data)\n    cursor = page.nextCursor ?? undefined\n  } while (cursor !== undefined)\n\n  return knowledgeBases\n}\n\n/**\n * Get a single knowledge base by ID\n */\nexport async function getKnowledgeBase(knowledgeBaseId: string): Promise<Context.KnowledgeBase> {\n  const client = await getContextClient()\n  return client.context.knowledgeBases.get(knowledgeBaseId)\n}\n\n/**\n * Update a knowledge base's configuration\n */\nexport async function updateKnowledgeBase(\n  knowledgeBaseId: string,\n  params: Context.EditKnowledgeBaseParams,\n): Promise<Context.KnowledgeBase> {\n  const client = await getContextClient()\n  return client.context.knowledgeBases.edit(knowledgeBaseId, params)\n}\n\n/**\n * Delete a knowledge base and its generated content\n */\nexport async function deleteKnowledgeBase(knowledgeBaseId: string): Promise<void> {\n  const client = await getContextClient()\n  await client.context.knowledgeBases.delete(knowledgeBaseId)\n}\n\n/**\n * Import content into a knowledge base. File imports are staged and uploaded\n * to signed storage by the client.\n */\nexport async function createImport(\n  knowledgeBaseId: string,\n  params: Context.CreateFileImportParams | Context.CreateImportParams,\n): Promise<Context.JobAccepted> {\n  const client = await getContextClient(knowledgeBaseId)\n  return client.context.imports.create(params)\n}\n\n/**\n * List all imports for a knowledge base (drains pagination)\n */\nexport async function listImports(knowledgeBaseId: string): Promise<Context.Import[]> {\n  const client = await getContextClient(knowledgeBaseId)\n\n  const imports: Context.Import[] = []\n  let cursor: string | undefined\n  do {\n    const page = await client.context.imports.list({cursor})\n    imports.push(...page.data)\n    cursor = page.nextCursor ?? undefined\n  } while (cursor !== undefined)\n\n  return imports\n}\n\n/**\n * Get a single import by ID\n */\nexport async function getImport(\n  knowledgeBaseId: string,\n  importId: string,\n): Promise<Context.ImportDetail> {\n  const client = await getContextClient(knowledgeBaseId)\n  return client.context.imports.get({importId})\n}\n\n/**\n * Get a short-lived signed URL for an import's original uploaded bytes\n */\nexport async function downloadImport(\n  knowledgeBaseId: string,\n  importId: string,\n): Promise<Context.ImportDownloadResponse> {\n  const client = await getContextClient(knowledgeBaseId)\n  return client.context.imports.download({importId})\n}\n\n/**\n * Delete an import from a knowledge base\n */\nexport async function deleteImport(knowledgeBaseId: string, importId: string): Promise<void> {\n  const client = await getContextClient(knowledgeBaseId)\n  await client.context.imports.delete({importId})\n}\n\n/**\n * Start a build of a knowledge base\n */\nexport async function buildKnowledgeBase(knowledgeBaseId: string): Promise<Context.JobAccepted> {\n  const client = await getContextClient(knowledgeBaseId)\n  return client.context.build()\n}\n\n/**\n * Cancel the running build of a knowledge base, if any\n */\nexport async function cancelKnowledgeBaseBuild(\n  knowledgeBaseId: string,\n): Promise<{cancelled: boolean}> {\n  const client = await getContextClient(knowledgeBaseId)\n  return client.context.cancelBuild()\n}\n\n/**\n * Run an incremental refresh: re-check sources and apply what changed\n */\nexport async function refreshKnowledgeBase(\n  knowledgeBaseId: string,\n): Promise<{jobId: string; started: boolean}> {\n  const client = await getContextClient(knowledgeBaseId)\n  return client.context.refresh()\n}\n\n/**\n * Get an async job (build, import) by ID\n */\nexport async function getJob(knowledgeBaseId: string, jobId: string): Promise<Context.Job> {\n  const client = await getContextClient(knowledgeBaseId)\n  return client.context.jobs.get({jobId})\n}\n"],"names":["getGlobalCliClient","CONTEXT_API_VERSION","getContextClient","knowledgeBaseId","apiVersion","requireUser","undefined","resource","id","type","createKnowledgeBase","params","client","context","knowledgeBases","create","listKnowledgeBases","organizationId","cursor","page","list","push","data","nextCursor","getKnowledgeBase","get","updateKnowledgeBase","edit","deleteKnowledgeBase","delete","createImport","imports","listImports","getImport","importId","downloadImport","download","deleteImport","buildKnowledgeBase","build","cancelKnowledgeBaseBuild","cancelBuild","refreshKnowledgeBase","refresh","getJob","jobId","jobs"],"mappings":"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"}

package/dist/util/sharedFlags.js

@@ -25,6 +25,30 @@ const OVERRIDE_SUFFIX = ' (overrides CLI configuration)';
         })
     };
 }
+/**
+ * Returns an `--organization` flag definition.
+ *
+ * Locked: flag name (`organization`), `helpValue` (`<id>`), and parse (trims + validates non-empty).
+ */ export function getOrganizationFlag(options) {
+    const { description: baseDescription, helpGroup, semantics, ...rest } = options;
+    const isOverride = semantics === 'override';
+    const description = (baseDescription ?? 'Organization ID to use') + (isOverride ? OVERRIDE_SUFFIX : '');
+    return {
+        organization: Flags.string({
+            description,
+            helpGroup: helpGroup ?? (isOverride ? 'OVERRIDE' : undefined),
+            helpValue: '<id>',
+            ...rest,
+            parse: async (input)=>{
+                const trimmed = input.trim();
+                if (trimmed === '') {
+                    throw new Error('`--organization` cannot be empty if provided');
+                }
+                return trimmed;
+            }
+        })
+    };
+}
 /**
  * Returns a `--dataset` / `-d` flag definition.
  *

package/dist/util/sharedFlags.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/util/sharedFlags.ts"],"sourcesContent":["import {Flags} from '@oclif/core'\n\n/**\n * Controls how the flag relates to CLI configuration:\n *\n * - `'override'` — The command falls back to CLI config (sanity.cli.ts) when the flag is not\n *   provided. The flag description automatically gets an \" (overrides CLI configuration)\" suffix,\n *   and `helpGroup` defaults to `'OVERRIDE'`.\n *\n * - `'specify'` — The command does NOT fall back to CLI config; the flag is simply how the user\n *   provides the value. No suffix is appended, and no default `helpGroup` is set.\n */\ntype FlagSemantics = 'override' | 'specify'\n\n/**\n * Options accepted by the shared flag getters.\n * Locked properties (char, parse, name, helpValue) are excluded to ensure\n * consistent behavior across all commands.\n */\ninterface SharedFlagOptions {\n  /**\n   * Controls description suffix and default helpGroup.\n   * @see {@link FlagSemantics}\n   */\n  semantics: FlagSemantics\n\n  dependsOn?: string[]\n  description?: string\n  env?: string\n  exclusive?: string[]\n  helpGroup?: string\n  hidden?: boolean\n  required?: boolean\n}\n\nconst OVERRIDE_SUFFIX = ' (overrides CLI configuration)'\n\n/**\n * Returns a `--project-id` / `-p` flag definition.\n *\n * Locked: flag name (`project-id`), char (`p`), `helpValue` (`<id>`), and parse (trims + validates non-empty).\n */\nexport function getProjectIdFlag(options: SharedFlagOptions) {\n  const {description: baseDescription, helpGroup, semantics, ...rest} = options\n  const isOverride = semantics === 'override'\n  const description = (baseDescription ?? 'Project ID to use') + (isOverride ? OVERRIDE_SUFFIX : '')\n\n  return {\n    'project-id': Flags.string({\n      description,\n      helpGroup: helpGroup ?? (isOverride ? 'OVERRIDE' : undefined),\n      helpValue: '<id>',\n      ...rest,\n      char: 'p',\n      parse: async (input: string) => {\n        const trimmed = input.trim()\n        if (trimmed === '') {\n          throw new Error('`--project-id` cannot be empty if provided')\n        }\n        return trimmed\n      },\n    }),\n  }\n}\n\n/**\n * Returns a `--dataset` / `-d` flag definition.\n *\n * Locked: flag name (`dataset`), char (`d`), `helpValue` (`<name>`), and parse (trims + validates non-empty).\n */\nexport function getDatasetFlag(options: SharedFlagOptions) {\n  const {description: baseDescription, helpGroup, semantics, ...rest} = options\n  const isOverride = semantics === 'override'\n  const description = (baseDescription ?? 'Dataset to use') + (isOverride ? OVERRIDE_SUFFIX : '')\n\n  return {\n    dataset: Flags.string({\n      description,\n      helpGroup: helpGroup ?? (isOverride ? 'OVERRIDE' : undefined),\n      helpValue: '<name>',\n      ...rest,\n      char: 'd',\n      parse: async (input: string) => {\n        const trimmed = input.trim()\n        if (trimmed === '') {\n          throw new Error('`--dataset` cannot be empty if provided')\n        }\n        return trimmed\n      },\n    }),\n  }\n}\n"],"names":["Flags","OVERRIDE_SUFFIX","getProjectIdFlag","options","description","baseDescription","helpGroup","semantics","rest","isOverride","string","undefined","helpValue","char","parse","input","trimmed","trim","Error","getDatasetFlag","dataset"],"mappings":"AAAA,SAAQA,KAAK,QAAO,cAAa;AAmCjC,MAAMC,kBAAkB;AAExB;;;;CAIC,GACD,OAAO,SAASC,iBAAiBC,OAA0B;IACzD,MAAM,EAACC,aAAaC,eAAe,EAAEC,SAAS,EAAEC,SAAS,EAAE,GAAGC,MAAK,GAAGL;IACtE,MAAMM,aAAaF,cAAc;IACjC,MAAMH,cAAc,AAACC,CAAAA,mBAAmB,mBAAkB,IAAMI,CAAAA,aAAaR,kBAAkB,EAAC;IAEhG,OAAO;QACL,cAAcD,MAAMU,MAAM,CAAC;YACzBN;YACAE,WAAWA,aAAcG,CAAAA,aAAa,aAAaE,SAAQ;YAC3DC,WAAW;YACX,GAAGJ,IAAI;YACPK,MAAM;YACNC,OAAO,OAAOC;gBACZ,MAAMC,UAAUD,MAAME,IAAI;gBAC1B,IAAID,YAAY,IAAI;oBAClB,MAAM,IAAIE,MAAM;gBAClB;gBACA,OAAOF;YACT;QACF;IACF;AACF;AAEA;;;;CAIC,GACD,OAAO,SAASG,eAAehB,OAA0B;IACvD,MAAM,EAACC,aAAaC,eAAe,EAAEC,SAAS,EAAEC,SAAS,EAAE,GAAGC,MAAK,GAAGL;IACtE,MAAMM,aAAaF,cAAc;IACjC,MAAMH,cAAc,AAACC,CAAAA,mBAAmB,gBAAe,IAAMI,CAAAA,aAAaR,kBAAkB,EAAC;IAE7F,OAAO;QACLmB,SAASpB,MAAMU,MAAM,CAAC;YACpBN;YACAE,WAAWA,aAAcG,CAAAA,aAAa,aAAaE,SAAQ;YAC3DC,WAAW;YACX,GAAGJ,IAAI;YACPK,MAAM;YACNC,OAAO,OAAOC;gBACZ,MAAMC,UAAUD,MAAME,IAAI;gBAC1B,IAAID,YAAY,IAAI;oBAClB,MAAM,IAAIE,MAAM;gBAClB;gBACA,OAAOF;YACT;QACF;IACF;AACF"}
+{"version":3,"sources":["../../src/util/sharedFlags.ts"],"sourcesContent":["import {Flags} from '@oclif/core'\n\n/**\n * Controls how the flag relates to CLI configuration:\n *\n * - `'override'` — The command falls back to CLI config (sanity.cli.ts) when the flag is not\n *   provided. The flag description automatically gets an \" (overrides CLI configuration)\" suffix,\n *   and `helpGroup` defaults to `'OVERRIDE'`.\n *\n * - `'specify'` — The command does NOT fall back to CLI config; the flag is simply how the user\n *   provides the value. No suffix is appended, and no default `helpGroup` is set.\n */\ntype FlagSemantics = 'override' | 'specify'\n\n/**\n * Options accepted by the shared flag getters.\n * Locked properties (char, parse, name, helpValue) are excluded to ensure\n * consistent behavior across all commands.\n */\ninterface SharedFlagOptions {\n  /**\n   * Controls description suffix and default helpGroup.\n   * @see {@link FlagSemantics}\n   */\n  semantics: FlagSemantics\n\n  dependsOn?: string[]\n  description?: string\n  env?: string\n  exclusive?: string[]\n  helpGroup?: string\n  hidden?: boolean\n  required?: boolean\n}\n\nconst OVERRIDE_SUFFIX = ' (overrides CLI configuration)'\n\n/**\n * Returns a `--project-id` / `-p` flag definition.\n *\n * Locked: flag name (`project-id`), char (`p`), `helpValue` (`<id>`), and parse (trims + validates non-empty).\n */\nexport function getProjectIdFlag(options: SharedFlagOptions) {\n  const {description: baseDescription, helpGroup, semantics, ...rest} = options\n  const isOverride = semantics === 'override'\n  const description = (baseDescription ?? 'Project ID to use') + (isOverride ? OVERRIDE_SUFFIX : '')\n\n  return {\n    'project-id': Flags.string({\n      description,\n      helpGroup: helpGroup ?? (isOverride ? 'OVERRIDE' : undefined),\n      helpValue: '<id>',\n      ...rest,\n      char: 'p',\n      parse: async (input: string) => {\n        const trimmed = input.trim()\n        if (trimmed === '') {\n          throw new Error('`--project-id` cannot be empty if provided')\n        }\n        return trimmed\n      },\n    }),\n  }\n}\n\n/**\n * Returns an `--organization` flag definition.\n *\n * Locked: flag name (`organization`), `helpValue` (`<id>`), and parse (trims + validates non-empty).\n */\nexport function getOrganizationFlag(options: SharedFlagOptions) {\n  const {description: baseDescription, helpGroup, semantics, ...rest} = options\n  const isOverride = semantics === 'override'\n  const description =\n    (baseDescription ?? 'Organization ID to use') + (isOverride ? OVERRIDE_SUFFIX : '')\n\n  return {\n    organization: Flags.string({\n      description,\n      helpGroup: helpGroup ?? (isOverride ? 'OVERRIDE' : undefined),\n      helpValue: '<id>',\n      ...rest,\n      parse: async (input: string) => {\n        const trimmed = input.trim()\n        if (trimmed === '') {\n          throw new Error('`--organization` cannot be empty if provided')\n        }\n        return trimmed\n      },\n    }),\n  }\n}\n\n/**\n * Returns a `--dataset` / `-d` flag definition.\n *\n * Locked: flag name (`dataset`), char (`d`), `helpValue` (`<name>`), and parse (trims + validates non-empty).\n */\nexport function getDatasetFlag(options: SharedFlagOptions) {\n  const {description: baseDescription, helpGroup, semantics, ...rest} = options\n  const isOverride = semantics === 'override'\n  const description = (baseDescription ?? 'Dataset to use') + (isOverride ? OVERRIDE_SUFFIX : '')\n\n  return {\n    dataset: Flags.string({\n      description,\n      helpGroup: helpGroup ?? (isOverride ? 'OVERRIDE' : undefined),\n      helpValue: '<name>',\n      ...rest,\n      char: 'd',\n      parse: async (input: string) => {\n        const trimmed = input.trim()\n        if (trimmed === '') {\n          throw new Error('`--dataset` cannot be empty if provided')\n        }\n        return trimmed\n      },\n    }),\n  }\n}\n"],"names":["Flags","OVERRIDE_SUFFIX","getProjectIdFlag","options","description","baseDescription","helpGroup","semantics","rest","isOverride","string","undefined","helpValue","char","parse","input","trimmed","trim","Error","getOrganizationFlag","organization","getDatasetFlag","dataset"],"mappings":"AAAA,SAAQA,KAAK,QAAO,cAAa;AAmCjC,MAAMC,kBAAkB;AAExB;;;;CAIC,GACD,OAAO,SAASC,iBAAiBC,OAA0B;IACzD,MAAM,EAACC,aAAaC,eAAe,EAAEC,SAAS,EAAEC,SAAS,EAAE,GAAGC,MAAK,GAAGL;IACtE,MAAMM,aAAaF,cAAc;IACjC,MAAMH,cAAc,AAACC,CAAAA,mBAAmB,mBAAkB,IAAMI,CAAAA,aAAaR,kBAAkB,EAAC;IAEhG,OAAO;QACL,cAAcD,MAAMU,MAAM,CAAC;YACzBN;YACAE,WAAWA,aAAcG,CAAAA,aAAa,aAAaE,SAAQ;YAC3DC,WAAW;YACX,GAAGJ,IAAI;YACPK,MAAM;YACNC,OAAO,OAAOC;gBACZ,MAAMC,UAAUD,MAAME,IAAI;gBAC1B,IAAID,YAAY,IAAI;oBAClB,MAAM,IAAIE,MAAM;gBAClB;gBACA,OAAOF;YACT;QACF;IACF;AACF;AAEA;;;;CAIC,GACD,OAAO,SAASG,oBAAoBhB,OAA0B;IAC5D,MAAM,EAACC,aAAaC,eAAe,EAAEC,SAAS,EAAEC,SAAS,EAAE,GAAGC,MAAK,GAAGL;IACtE,MAAMM,aAAaF,cAAc;IACjC,MAAMH,cACJ,AAACC,CAAAA,mBAAmB,wBAAuB,IAAMI,CAAAA,aAAaR,kBAAkB,EAAC;IAEnF,OAAO;QACLmB,cAAcpB,MAAMU,MAAM,CAAC;YACzBN;YACAE,WAAWA,aAAcG,CAAAA,aAAa,aAAaE,SAAQ;YAC3DC,WAAW;YACX,GAAGJ,IAAI;YACPM,OAAO,OAAOC;gBACZ,MAAMC,UAAUD,MAAME,IAAI;gBAC1B,IAAID,YAAY,IAAI;oBAClB,MAAM,IAAIE,MAAM;gBAClB;gBACA,OAAOF;YACT;QACF;IACF;AACF;AAEA;;;;CAIC,GACD,OAAO,SAASK,eAAelB,OAA0B;IACvD,MAAM,EAACC,aAAaC,eAAe,EAAEC,SAAS,EAAEC,SAAS,EAAE,GAAGC,MAAK,GAAGL;IACtE,MAAMM,aAAaF,cAAc;IACjC,MAAMH,cAAc,AAACC,CAAAA,mBAAmB,gBAAe,IAAMI,CAAAA,aAAaR,kBAAkB,EAAC;IAE7F,OAAO;QACLqB,SAAStB,MAAMU,MAAM,CAAC;YACpBN;YACAE,WAAWA,aAAcG,CAAAA,aAAa,aAAaE,SAAQ;YAC3DC,WAAW;YACX,GAAGJ,IAAI;YACPK,MAAM;YACNC,OAAO,OAAOC;gBACZ,MAAMC,UAAUD,MAAME,IAAI;gBAC1B,IAAID,YAAY,IAAI;oBAClB,MAAM,IAAIE,MAAM;gBAClB;gBACA,OAAOF;YACT;QACF;IACF;AACF"}

package/oclif.config.js

@@ -16,6 +16,7 @@ export default {
   plugins: ['@oclif/plugin-help', '@sanity/runtime-cli', '@sanity/workflow-cli'],
   topics: {
     backups: {description: 'Manage dataset backups'},
+    context: {description: 'Manage Context knowledge bases'},
     cors: {description: 'Manage CORS origins for your project'},
     datasets: {description: 'Manage datasets in your project'},
     docs: {description: 'Browse and search Sanity documentation'},