@gravity-rail/cli 0.40.0 → 0.42.0

package/README.md

@@ -680,9 +680,15 @@ pass it as `--expected-generation` to `draft set` or `publish`. Omitting it read
 the current generation just before the write and only detects changes during
 that request sequence. The server's refusal details are preserved.
 
-Use `bundles get --bundle <uuid>` or `bundles install --bundle <uuid>` for direct access
-to an authorized official solution, including one hidden from `bundles list`.
-Private Bundles still require an existing grant or ownership.
+Use `bundles get --bundle <uuid>` or `bundles install --bundle <uuid>` to reach a
+Bundle by UUID without paging `bundles list`. The Bundle must be visible to the
+workspace: it owns the Bundle, or a live grant names it.
+
+`bundles grant --to organization --uuid <org-uuid>` shares a published Bundle with
+its publishing organization. `bundles grant --to global` shares it with every
+workspace and requires a superuser account. A `draft set` file may carry
+`"links": [{"label", "url"}]`, up to ten named `https` links published with the
+Bundle; a file without `links` keeps the draft's current links.
 
 `bundles get -o json` returns one `{ summary, version }` object; `version` is null
 before publication. Revocations also return JSON when requested. Full UUIDs in

package/dist/gr.js

@@ -3205,7 +3205,7 @@ var init_libphonenumber_js = __esm({
   }
 });
 
-// ../sdk/dist/chunk-ZTUOB4V2.js
+// ../sdk/dist/chunk-JTOMGNUO.js
 function resourceWorkflowsPath(wid, ...segments) {
   const tail = segments.map((segment) => encodeURIComponent(String(segment))).join("/");
   const base = `w/${encodeURIComponent(wid)}/resource-workflows`;
@@ -4053,7 +4053,7 @@ function bindWorkflowsMethods(target, workflows, workflowNotes, voice, superviso
   target.getWorkflowActivity = workflows.getWorkflowActivity.bind(workflows);
   target.getWorkflowsActivityBatch = workflows.getWorkflowsActivityBatch.bind(workflows);
   target.getWorkflowDiagram = workflows.getWorkflowDiagram.bind(workflows);
-  target.getWorkflowThumbnailUrl = workflows.getWorkflowThumbnailUrl.bind(workflows);
+  target.getWorkflowOutline = workflows.getWorkflowOutline.bind(workflows);
   target.createWorkflow = workflows.createWorkflow.bind(workflows);
   target.updateWorkflow = workflows.updateWorkflow.bind(workflows);
   target.getWorkflowDeletionPreview = workflows.getWorkflowDeletionPreview.bind(workflows);
@@ -4524,7 +4524,8 @@ function bindResourceWorkflowsMethods(target, resourceWorkflows) {
 }
 function bindBundlesMethods(target, bundles, resourceWorkflows) {
   bindResourceWorkflowsMethods(target, resourceWorkflows);
-  target.getSolutionRelease = bundles.getSolutionRelease.bind(bundles);
+  target.listPublicBundles = bundles.listPublicBundles.bind(bundles);
+  target.getPublicBundle = bundles.getPublicBundle.bind(bundles);
   target.updateBundle = bundles.updateBundle.bind(bundles);
   target.listBundleInstallations = bundles.listBundleInstallations.bind(bundles);
   target.listBundles = bundles.listBundles.bind(bundles);
@@ -4703,8 +4704,8 @@ function getRevisionState(workflow, revision) {
   };
 }
 var AbilitiesApi, ResourceWorkflowsApi, BundlesApi, InstallationsApi, AccessGrantsApi, AgentTasksApi, AgentsApi, AIModelsApi, ApiKeysApi, AppsApi, AssignmentsApi, VoiceApi, AuthApi, BuildersApi, CalendarsApi, CallsApi, CELApi, ChatsApi, ConfluenceApi, CustomToolkitsApi, DataTypesApi, DiscordBotsApi, SlackAppsApi, EventsApi, FeaturesApi, FhirConnectionsApi, InboundFaxStatus, DocumoFaxApi, HealthieApi, FilesApi, InboxesApi, InquiriesApi, AppConnectionsApi, McpServersApi, MemberImportValidationError, MembersApi, MondayIntegrationApi, NotificationRulesApi, OperatorApi, OrgApi, OAuthConnectionsApi, OAuthApi, PhoneNumbersApi, PronunciationsApi, PromptsApi, PersonasApi, QueriesApi, QualificationsApi, ReportsApi, RoutingRulesApi, SalesforceApi, ConnectionSyncApi, HubspotApi, SitesApi, SubscriptionsApi, SupportRequestsApi, CustomersApi, ResellersApi, SupervisorsApi, TasksApi, TemplatesApi, ToolkitsApi, JourneysApi, WorkflowsApi, WorkflowNotesApi, EventRuleObjectType, EventRuleEventType, EventRuleActionType, DriverMode, MEMBER_RELATIONSHIP_KINDS, WorkspaceInvitationsApi, WorkspacesApi, DashboardsApi, DevicesApi, TeamsAppsApi, ExperimentsApi, PatientSyncConnectionsApi, ActivityApi, MotdApi, InterventionRequestsApi, MetricsApi, ProjectsApi, TrackedLinksApi, WORKSPACE_METHOD_NAMES, WORKSPACE_METHOD_NAME_SET, GravityRailClient, WIDGET_SLUGS, CHAT_TYPES, BUILTIN_ASSISTANT_CHAT_TYPES, MEMBER_AGENT_CHAT_TYPES, ActivityGrain, ActivityGroupBy, ActivityOpenItemOrder, ActivityWindowBasis;
-var init_chunk_ZTUOB4V2 = __esm({
-  "../sdk/dist/chunk-ZTUOB4V2.js"() {
+var init_chunk_JTOMGNUO = __esm({
+  "../sdk/dist/chunk-JTOMGNUO.js"() {
     init_chunk_67QXTQVL();
     init_libphonenumber_js();
     AbilitiesApi = class extends BaseApiClient {
@@ -4812,11 +4813,15 @@ var init_chunk_ZTUOB4V2 = __esm({
       }
     };
     BundlesApi = class extends BaseApiClient {
-      /** Official solution metadata, independent of the default workspace Library. */
-      async getSolutionRelease(slug) {
-        return this.fetch(`solutions/${encodeURIComponent(slug)}`);
+      /** Bundles shared with everyone. Needs no session. */
+      async listPublicBundles(params) {
+        return this.fetch(`bundles/public${pageQuery(params)}`);
       }
-      /** Read an authorized Bundle by UUID, including official solutions hidden from discovery. */
+      /** The outline of one Bundle shared with everyone. Needs no session; 404 otherwise. */
+      async getPublicBundle(bundleUuid2) {
+        return this.fetch(`bundles/${encodeURIComponent(bundleUuid2)}/public`);
+      }
+      /** Read an authorized Bundle by UUID. */
       async getBundle(wid, bundleUuid2) {
         return this.fetch(bundlesPath(wid, bundleUuid2));
       }
@@ -4901,9 +4906,9 @@ var init_chunk_ZTUOB4V2 = __esm({
         return this.fetch(bundlesPath(wid, bundleUuid2, "grants"));
       }
       /**
-       * Share throughout the publisher's organization with organization-admin authority.
-       * Workspace-specific and global author grants are refused. Official public
-       * solutions use the separate staff approval API.
+       * Share throughout the publisher's organization with organization-admin authority,
+       * or with everyone (`granteeType: "global"`) as a superuser. Workspace-specific
+       * grants are refused.
        */
       async grantBundle(wid, bundleUuid2, data) {
         return this.fetch(bundlesPath(wid, bundleUuid2, "grants"), {
@@ -13038,15 +13043,11 @@ var init_chunk_ZTUOB4V2 = __esm({
         return this.fetch(`w/${wid}/workflows/${id}/diagram${query}`);
       }
       /**
-       * Get workflow thumbnail URL.
-       * For cross-domain setups, returns a same-origin proxy URL to ensure cookies are sent.
-       * For same-origin setups, returns the direct API URL.
+       * The outline a Workflow's diagram is drawn from: its active Tasks, its
+       * start Task, the moves between Tasks and its Ability types.
        */
-      getWorkflowThumbnailUrl(wid, id) {
-        if (this.isCrossDomain) {
-          return `/api/v2/w/${wid}/workflows/${id}/thumbnail`;
-        }
-        return `${this.baseUrl}/api/v2/w/${wid}/workflows/${id}/thumbnail`;
+      async getWorkflowOutline(wid, id) {
+        return this.fetch(`w/${wid}/workflows/${id}/outline`);
       }
       /** Create a new workflow in a workspace. */
       async createWorkflow(wid, workflow) {
@@ -15673,11 +15674,11 @@ var init_chunk_ZTUOB4V2 = __esm({
       "getWorkflowDeletionPreview",
       "getWorkflowDiagram",
       "getWorkflowNotes",
+      "getWorkflowOutline",
       "getWorkflowRevision",
       "getWorkflowRevisions",
       "getWorkflowTaskAssignmentStats",
       "getWorkflowTemplates",
-      "getWorkflowThumbnailUrl",
       "getWorkflows",
       "getWorkflowsActivityBatch",
       "getWorkspace",
@@ -16305,7 +16306,8 @@ var init_chunk_ZTUOB4V2 = __esm({
       updateBundle;
       listBundleInstallations;
       // Bundles API
-      getSolutionRelease;
+      listPublicBundles;
+      getPublicBundle;
       listBundles;
       listBundleWorkflowCandidates;
       createBundle;
@@ -16671,7 +16673,7 @@ var init_chunk_ZTUOB4V2 = __esm({
       getWorkflowActivity;
       getWorkflowsActivityBatch;
       getWorkflowDiagram;
-      getWorkflowThumbnailUrl;
+      getWorkflowOutline;
       createWorkflow;
       updateWorkflow;
       getWorkflowDeletionPreview;
@@ -17391,7 +17393,7 @@ var init_chunk_6KPGCPGW = __esm({
 var SEARCHABLE_EVENT_RULE_SOURCE_FIELDS, ActivityEventType, EntityKind;
 var init_dist = __esm({
   "../sdk/dist/index.js"() {
-    init_chunk_ZTUOB4V2();
+    init_chunk_JTOMGNUO();
     init_chunk_72SWNLVD();
     init_chunk_6KPGCPGW();
     init_chunk_67QXTQVL();
@@ -29404,6 +29406,23 @@ async function readBindings(hctx) {
   }
   return payload;
 }
+var CREATE_INBOX_ARG = {
+  name: "create-inbox",
+  description: "Comma-separated Inbox slot keys to fill by creating an Inbox (one per installation, named for the Bundle; needs inboxes:write)"
+};
+async function readSlotTargets(hctx) {
+  const bindings = await readBindings(hctx);
+  const keys = (optionalString(hctx.args, "create-inbox") ?? "").split(",").map((key) => key.trim()).filter(Boolean);
+  if (keys.length === 0) return bindings;
+  const merged = { ...bindings };
+  for (const key of keys) {
+    if (merged[key]) {
+      throw new CLIError(`--create-inbox "${key}" is also set in --bindings; choose one`);
+    }
+    merged[key] = { kind: "new_inbox" };
+  }
+  return merged;
+}
 async function guardConflict(run, hint2) {
   try {
     return await run();
@@ -29477,18 +29496,20 @@ var installationCommands = [
       {
         name: "bindings",
         description: "Path to a JSON object mapping slot keys to targets"
-      }
+      },
+      CREATE_INBOX_ARG
     ],
     examples: [
       "gr bundles install -w $WID --bundle <bundle-uuid> --allow-write",
-      "gr bundles install -w $WID --bundle <bundle-uuid> --bindings bindings.json --allow-write"
+      "gr bundles install -w $WID --bundle <bundle-uuid> --bindings bindings.json --allow-write",
+      "gr bundles install -w $WID --bundle <bundle-uuid> --create-inbox program.inbox --allow-write"
     ],
     handler: async (hctx) => {
       const bundle = requireBundleUuid(hctx);
       const summary = await getBundleSummary(hctx, bundle);
       const version = summary.publishedVersion;
       if (version == null) throw new CLIError("Publish the Bundle before installing it");
-      const bindings = await readBindings(hctx);
+      const bindings = await readSlotTargets(hctx);
       const result2 = await guardConflict(
         () => client(hctx).installBundle(hctx.workspace, bundle, {
           version,
@@ -29603,6 +29624,7 @@ var installationCommands = [
         name: "bindings",
         description: "Path to a JSON object mapping new slot keys to targets"
       },
+      CREATE_INBOX_ARG,
       { name: "preview", description: "Show what would change and write nothing", isFlag: true }
     ],
     examples: [
@@ -29619,7 +29641,7 @@ var installationCommands = [
         );
         return;
       }
-      const bindings = await readBindings(hctx);
+      const bindings = await readSlotTargets(hctx);
       const result2 = await guardConflict(
         () => client(hctx).upgradeInstallation(hctx.workspace, uuid, {
           toVersion: to,
@@ -29661,17 +29683,17 @@ var installationCommands = [
       INSTALLATION_ARG,
       {
         name: "bindings",
-        description: "Path to a JSON object mapping slot keys to targets",
-        required: true
-      }
+        description: "Path to a JSON object mapping slot keys to targets"
+      },
+      CREATE_INBOX_ARG
     ],
     examples: [
       "gr bundles bind -w $WID --installation <installation-uuid> --bindings bindings.json --allow-write"
     ],
     handler: async (hctx) => {
-      const bindings = await readBindings(hctx);
+      const bindings = await readSlotTargets(hctx);
       if (!bindings || Object.keys(bindings).length === 0) {
-        throw new CLIError("--bindings must name at least one slot");
+        throw new CLIError("--bindings or --create-inbox must name at least one slot");
       }
       const result2 = await guardConflict(
         () => client(hctx).bindInstallationSlots(hctx.workspace, installationUuid(hctx), {
@@ -29760,6 +29782,18 @@ function parseDraftItems(payload) {
   });
   return items;
 }
+function parseDraftLinks(payload) {
+  const links = payload.links;
+  if (links === void 0) return void 0;
+  if (!Array.isArray(links)) throw new CLIError('"links" must be an array');
+  links.forEach((link, index) => {
+    const record2 = link;
+    if (typeof record2 !== "object" || record2 === null || typeof record2.label !== "string" || typeof record2.url !== "string") {
+      throw new CLIError(`links[${index}] needs string "label" and "url"`);
+    }
+  });
+  return links;
+}
 async function currentGeneration(hctx, uuid) {
   const expected2 = optionalNumber(hctx.args, "expected-generation");
   if (expected2 !== void 0) {
@@ -29835,6 +29869,14 @@ Draft generation: ${version.draftGeneration}
     hctx.ctx,
     ITEM_COLUMNS
   );
+  if (version.links?.length) {
+    process.stdout.write(
+      `
+Links:
+${version.links.map((link) => `  ${link.label}: ${link.url}`).join("\n")}
+`
+    );
+  }
   if (version.releaseNotes) {
     process.stdout.write(`
 Release notes:
@@ -30004,7 +30046,7 @@ var bundlesDomain = {
     },
     {
       path: ["bundles", "draft", "set"],
-      description: 'Replace draft items from {"items": [...]}; use --expected-generation from draft get to protect edits.',
+      description: 'Replace draft items from {"items": [...]}; an optional "links": [{"label", "url"}] replaces the draft links. Use --expected-generation from draft get to protect edits.',
       requiresWorkspace: true,
       mutates: true,
       args: [BUNDLE_ARG, GENERATION_ARG],
@@ -30013,11 +30055,13 @@ var bundlesDomain = {
       ],
       handler: async (hctx) => {
         const items = parseDraftItems(hctx.data);
+        const links = parseDraftLinks(hctx.data);
         const uuid = bundleUuid(hctx);
         const expectedGeneration = await currentGeneration(hctx, uuid);
         const result2 = await client2(hctx).replaceBundleDraft(hctx.workspace, uuid, {
           expectedGeneration,
-          items
+          items,
+          ...links ? { links } : {}
         });
         writeVersionDetail(hctx, result2);
       }
@@ -30066,28 +30110,30 @@ var bundlesDomain = {
     },
     {
       path: ["bundles", "grant"],
-      description: "Share a published Bundle within its organization with full source visibility",
+      description: "Share a published Bundle with its organization, or with everyone as a superuser",
       requiresWorkspace: true,
       mutates: true,
       args: [
         BUNDLE_ARG,
         ...sharingArgs.filter((arg) => arg.name !== "disclosure").map(
-          (arg) => arg.name === "to" ? { ...arg, description: "organization (publishing organization only)" } : arg.name === "uuid" ? { ...arg, description: "Publishing organization UUID", required: true } : arg
+          (arg) => arg.name === "to" ? {
+            ...arg,
+            description: "organization (publishing organization only) | global (everyone; superuser only)"
+          } : arg.name === "uuid" ? {
+            ...arg,
+            description: "Publishing organization UUID (omit with --to global)"
+          } : arg
         )
       ],
       examples: [
-        "gr bundles grant -w $WID --allow-write --bundle <bundle-uuid> --to organization --uuid <org-uuid>"
+        "gr bundles grant -w $WID --allow-write --bundle <bundle-uuid> --to organization --uuid <org-uuid>",
+        "gr bundles grant -w $WID --allow-write --bundle <bundle-uuid> --to global"
       ],
       handler: async (hctx) => {
-        if (requireString(hctx.args, "to") === "global") {
-          throw new CLIError(
-            "Bundle sharing is organization-only; official solution approval uses the staff catalog command"
-          );
-        }
         const request = sharingRequest(hctx.args, "full");
-        if (request.granteeType !== "organization") {
+        if (request.granteeType === "workspace") {
           throw new CLIError(
-            "Share Bundles with their organization, then install per workspace"
+            "Share Bundles with their organization or with everyone, then install per workspace"
           );
         }
         const bundleRequest = {
@@ -46036,7 +46082,7 @@ init_concierge_api();
 
 // package.json
 var package_default = {
-  version: "0.40.0"};
+  version: "0.42.0"};
 
 // src/gr.ts
 var VERSION = package_default.version;