@arbium/enterprise-agent-connect-client 0.1.2-dev.d2aa5ca → 0.2.1-dev.7b4e802

package/lib/steps.d.ts

@@ -17,8 +17,10 @@ export declare function choiceValues(connector: {
 export declare const isChosen: (option: ChosenOption | undefined, chosen: Record<string, string>) => boolean;
 /** The choice fields shown: one that `requires` an earlier choice only while it is made. */
 export declare const askedFields: (fields: Field[], values: Record<string, string>) => Field[];
-/** The steps that apply under the chosen options (a step with `option` only while chosen). */
-export declare function chosenSteps(connector: Connector, steps: Step[], values: Record<string, string>): Step[];
+/** The steps that apply under the chosen options (a step with `option` only while chosen)
+ *  and, given `ticked`, the ticked capabilities (a step with `capabilities` only while one of
+ *  them is). */
+export declare function chosenSteps(connector: Connector, steps: Step[], values: Record<string, string>, ticked?: readonly string[]): Step[];
 /** Choices that change the permissions the setup steps ask for: made in step 1, with what
  *  agents may do, so the steps after it already show those permissions. */
 export declare function permissionChoices(connector: Connector): Field[];
@@ -39,6 +41,12 @@ export declare function keyApps(agent: Agent, connectors: Connector[]): Connecto
 export declare function keysUsing(agents: Agent[], connectorId: string): number;
 /** The values a connected app reported for its discover probe, e.g. Jira project keys. */
 export declare function discovered(connector: Connector, checks: Check[] | null): string[];
+/** The same, each with the label to show for it (the value itself when the app gave none),
+ *  e.g. a NetSuite subsidiary's name for its id. */
+export declare function discoveredChoices(connector: Connector, checks: Check[] | null): {
+    value: string;
+    label: string;
+}[];
 /** Parses free-typed list input ("KAN, SAM1") into values. */
 export declare function splitList(raw: string): string[];
 /** Shown under Click through for a step the vendor offers only as commands. */
@@ -211,6 +219,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
                 field: string;
                 value: string;
             };
+            capabilities?: string[];
         }[];
         afterConnect: {
             title: string;
@@ -240,6 +249,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
                 field: string;
                 value: string;
             };
+            capabilities?: string[];
         }[];
         fields: {
             id: string;
@@ -257,6 +267,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
                 field: string;
                 value: string;
             };
+            optional: boolean;
         }[];
         capabilities: {
             id: string;
@@ -340,6 +351,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
             path: string;
             label: string;
             show: string;
+            name?: string;
             match?: {
                 [key: string]: string | number | boolean;
             };
@@ -357,6 +369,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
             path: string;
             label: string;
             show: string;
+            name?: string;
             match?: {
                 [key: string]: string | number | boolean;
             };
@@ -372,6 +385,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
         revoke: string;
         http?: {
             baseUrl: string;
+            allowedHosts?: string[];
             auth: {
                 type: "header";
                 header: string;
@@ -390,6 +404,8 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
                 clientId: string;
                 clientSecret: string;
                 scope?: string;
+                clientAuth?: "body" | "basic";
+                audience?: string;
             } | {
                 type: "query";
                 param: string;
@@ -398,6 +414,9 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
             headers: {
                 [key: string]: string;
             };
+            fieldHeaders: {
+                [key: string]: string;
+            };
             tools: {
                 name: string;
                 description: string;
@@ -497,6 +516,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
         };
         odata?: {
             serviceRoot: string;
+            allowedHosts?: string[];
             version: "2" | "4";
             auth: {
                 type: "header";
@@ -516,6 +536,8 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
                 clientId: string;
                 clientSecret: string;
                 scope?: string;
+                clientAuth?: "body" | "basic";
+                audience?: string;
             } | {
                 type: "query";
                 param: string;
@@ -712,7 +734,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
                 deliveryId: string[];
                 types: {
                     type: string;
-                    same?: [string, string];
+                    since?: string;
                 }[];
             };
         };
@@ -790,6 +812,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
                 field: string;
                 value: string;
             };
+            capabilities?: string[];
         }[];
         afterConnect: {
             title: string;
@@ -819,6 +842,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
                 field: string;
                 value: string;
             };
+            capabilities?: string[];
         }[];
         fields: {
             id: string;
@@ -836,6 +860,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
                 field: string;
                 value: string;
             };
+            optional: boolean;
         }[];
         capabilities: {
             id: string;
@@ -919,6 +944,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
             path: string;
             label: string;
             show: string;
+            name?: string;
             match?: {
                 [key: string]: string | number | boolean;
             };
@@ -936,6 +962,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
             path: string;
             label: string;
             show: string;
+            name?: string;
             match?: {
                 [key: string]: string | number | boolean;
             };
@@ -951,6 +978,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
         revoke: string;
         http?: {
             baseUrl: string;
+            allowedHosts?: string[];
             auth: {
                 type: "header";
                 header: string;
@@ -969,6 +997,8 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
                 clientId: string;
                 clientSecret: string;
                 scope?: string;
+                clientAuth?: "body" | "basic";
+                audience?: string;
             } | {
                 type: "query";
                 param: string;
@@ -977,6 +1007,9 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
             headers: {
                 [key: string]: string;
             };
+            fieldHeaders: {
+                [key: string]: string;
+            };
             tools: {
                 name: string;
                 description: string;
@@ -1076,6 +1109,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
         };
         odata?: {
             serviceRoot: string;
+            allowedHosts?: string[];
             version: "2" | "4";
             auth: {
                 type: "header";
@@ -1095,6 +1129,8 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
                 clientId: string;
                 clientSecret: string;
                 scope?: string;
+                clientAuth?: "body" | "basic";
+                audience?: string;
             } | {
                 type: "query";
                 param: string;
@@ -1291,7 +1327,7 @@ export declare function newKeySetup(ticked: Connector[], providers: Provider[]):
                 deliveryId: string[];
                 types: {
                     type: string;
-                    same?: [string, string];
+                    since?: string;
                 }[];
             };
         };

package/lib/steps.js

@@ -37,10 +37,13 @@ export const askedFields = (fields, values) => {
     const chosen = choiceValues({ fields }, values);
     return fields.filter((f) => isChosen(f.requires, chosen));
 };
-/** The steps that apply under the chosen options (a step with `option` only while chosen). */
-export function chosenSteps(connector, steps, values) {
+/** The steps that apply under the chosen options (a step with `option` only while chosen)
+ *  and, given `ticked`, the ticked capabilities (a step with `capabilities` only while one of
+ *  them is). */
+export function chosenSteps(connector, steps, values, ticked) {
     const chosen = choiceValues(connector, values);
-    return steps.filter((s) => isChosen(s.option, chosen));
+    return steps.filter((s) => isChosen(s.option, chosen) &&
+        (!ticked || !s.capabilities || s.capabilities.some((c) => ticked.includes(c))));
 }
 /** Choices that change the permissions the setup steps ask for: made in step 1, with what
  *  agents may do, so the steps after it already show those permissions. */
@@ -83,9 +86,15 @@ export function keysUsing(agents, connectorId) {
 }
 /** The values a connected app reported for its discover probe, e.g. Jira project keys. */
 export function discovered(connector, checks) {
+    return discoveredChoices(connector, checks).map((c) => c.value);
+}
+/** The same, each with the label to show for it (the value itself when the app gave none),
+ *  e.g. a NetSuite subsidiary's name for its id. */
+export function discoveredChoices(connector, checks) {
     if (!connector.discover || !checks)
         return [];
-    return checks.find((c) => c.label === connector.discover.label)?.values ?? [];
+    const check = checks.find((c) => c.label === connector.discover.label);
+    return (check?.values ?? []).map((value) => ({ value, label: check?.labels?.[value] ?? value }));
 }
 /** Parses free-typed list input ("KAN, SAM1") into values. */
 export function splitList(raw) {
@@ -505,8 +514,8 @@ const numbered = (ns) => ns.length === 1
     : `steps ${ns.slice(0, -1).join(", ")} and ${ns[ns.length - 1]}`;
 export function appSteps(input) {
     const { connector, connection, health, ceiling, marks } = input;
-    const setup = chosenSteps(connector, connector.setup, input.choices ?? {});
-    const afterConnect = chosenSteps(connector, connector.afterConnect, input.choices ?? {});
+    const setup = chosenSteps(connector, connector.setup, input.choices ?? {}, ceiling);
+    const afterConnect = chosenSteps(connector, connector.afterConnect, input.choices ?? {}, ceiling);
     const on = connection !== null;
     const changed = on && connection.capabilities.join(",") !== ceiling.join(",");
     const before = input.providerReady ? {} : { locked: true };

package/lib/types.d.ts

@@ -47,11 +47,14 @@ export type EventTriggerInput = Body<"setEventTrigger">;
 export type EventRun = S["EventRun"];
 export type ClaudeKey = S["ClaudeKey"];
 export type ClaudeAgent = S["ClaudeAgent"];
+export type InternalApp = S["InternalApp"];
+export type InternalAppSaved = S["InternalAppSaved"];
+export type InternalAppDraft = S["InternalAppDraft"];
 export type Step = Connector["setup"][number];
 export type AgentStep = Provider["addAgent"][number];
 export type Setting = NonNullable<Step["settings"]>[number];
 export type ChosenOption = NonNullable<Step["option"]>;
-/** A connect form field; a provider's may be left empty (`optional`). */
+/** A connect form field; an `optional` one may be left empty. */
 export type Field = Connector["fields"][number] & {
     optional?: boolean;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arbium/enterprise-agent-connect-client",
-  "version": "0.1.2-dev.d2aa5ca",
+  "version": "0.2.1-dev.7b4e802",
   "description": "Typed client for the Agent Connect admin API (v1), and the pure logic admin pages share",
   "type": "module",
   "exports": {