@lunnoa/client 2.1.0 → 2.3.0

package/README.md

@@ -264,7 +264,7 @@ npx @lunnoa/client agents deploy ./agents/triage.ts \
   --url https://lunnoa.example --api-key lna_...
 ```
 
-`defineAction` binds catalogue actions only; toolkit `createAction` is for in-platform apps. See Lunnoa Docs under `guides/develop/client/define`, `runs`, and `cli-deploy`.
+`defineAction` binds catalogue actions only; toolkit `createAction` is for in-platform apps. `defineWorkflow` takes an optional `defineTrigger`. Omit it for Manually Run with no input fields. `runs.start` ignores the trigger and runs the steps only. See Lunnoa Docs under `guides/develop/client/define`, `runs`, and `cli-deploy`.
 
 ### CLI discovery
 
@@ -277,13 +277,14 @@ npx @lunnoa/client tools get http_action_send-request --json
 npx @lunnoa/client apps list --json
 npx @lunnoa/client apps get http --json
 npx @lunnoa/client connections list --app gmail --json
+npx @lunnoa/client ai-connections list --json
 npx @lunnoa/client agents list --json
 npx @lunnoa/client workflows list --json
 npx @lunnoa/client entity-types list --json
 npx @lunnoa/client features --json
 ```
 
-`tools list` is compact (`appId`, `actionId`, name, flags). `tools get` prints `inputConfig` and a `defineAction({ id, appId, input })` sketch. Auth flags and `LUNNOA_URL` / `LUNNOA_API_KEY` / `lunnoa.config` work the same as deploy. The CLI also reads `./.env` (real environment variables win).
+`tools list` is compact (`appId`, `actionId`, name, flags). `tools get` prints `inputConfig` and a `defineAction({ id, appId, input })` sketch. `apps get --json` includes each trigger and a `defineTrigger` sketch. Use `triggers[].triggerId`. Do not invent trigger ids. `ai-connections list --json` prints the model ids each AI connection accepts; use `models[].id` as `defineAgent({ model })`. Auth flags and `LUNNOA_URL` / `LUNNOA_API_KEY` / `lunnoa.config` work the same as deploy. The CLI also reads `./.env` (real environment variables win).
 
 ## Regenerating the API types
 

package/dist/cli.js

@@ -472,7 +472,7 @@ var AgentChatClient = class {
 function messageTaskBody(message, options = {}) {
   return {
     messages: [message],
-    ...options.chatMode ? { chatMode: options.chatMode } : {},
+    chatMode: options.chatMode ?? "preview",
     ...options.data ? { data: options.data } : {},
     ...options.piiResolution ? { piiResolution: options.piiResolution } : {}
   };
@@ -541,6 +541,7 @@ var DEFINE_KINDS = {
   connection: "connection",
   aiConnection: "aiConnection",
   action: "action",
+  trigger: "trigger",
   workflow: "workflow",
   agent: "agent",
   entityType: "entityType"
@@ -563,6 +564,40 @@ function resolveActionAppId(action) {
     `Cannot infer appId for action "${id}". Pass appId explicitly.`
   );
 }
+function resolveTriggerAppId(trigger) {
+  if (trigger.appId?.trim()) {
+    return trigger.appId.trim();
+  }
+  const id = trigger.id.trim();
+  const marker = "_trigger_";
+  const markerIndex = id.indexOf(marker);
+  if (markerIndex > 0) {
+    return id.slice(0, markerIndex);
+  }
+  const dot = id.indexOf(".");
+  if (dot > 0) {
+    return id.slice(0, dot);
+  }
+  throw new Error(
+    `Cannot infer appId for trigger "${id}". Pass appId explicitly.`
+  );
+}
+function resolveTriggerId(trigger) {
+  const id = trigger.id.trim();
+  const appId = trigger.appId?.trim();
+  if (appId && id.startsWith(`${appId}.`)) {
+    return id.slice(appId.length + 1);
+  }
+  const marker = "_trigger_";
+  if (id.includes(marker)) {
+    return id;
+  }
+  const dot = id.indexOf(".");
+  if (dot > 0) {
+    return id.slice(dot + 1);
+  }
+  return id;
+}
 function resolveActionId(action) {
   const id = action.id.trim();
   const appId = action.appId?.trim();
@@ -852,6 +887,22 @@ var SsoAuthResource = class {
   }
 };
 
+// src/resources/ai-connections.ts
+var AiConnectionsResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * Lists AI connections the caller can assign to an agent, with the model
+   * ids each connection accepts. Credentials are never included.
+   * Requires `agents:create` (the same permission as agent deploy).
+   */
+  list() {
+    return this.http.get("/api/ai-connections");
+  }
+};
+
 // src/resources/connections.ts
 var ConnectionsResource = class {
   constructor(http) {
@@ -1961,6 +2012,17 @@ var WorkflowAppsResource = class {
 };
 
 // src/resources/workflows.ts
+function triggerToUpsertInput(trigger) {
+  return {
+    triggerId: resolveTriggerId(trigger),
+    appId: resolveTriggerAppId(trigger),
+    ...trigger.connection?.id ? { connectionId: trigger.connection.id } : {},
+    ...trigger.input ? { input: trigger.input } : {},
+    ...trigger.inputs?.length ? { inputs: trigger.inputs } : {},
+    ...trigger.name ? { name: trigger.name } : {},
+    ...trigger.description ? { description: trigger.description } : {}
+  };
+}
 function stepToUpsertInput(step) {
   const use = step.use;
   return {
@@ -1981,6 +2043,7 @@ function workflowDefinitionToUpsert(def) {
     name: def.name,
     description: def.description,
     isActive: def.isActive,
+    ...def.trigger ? { trigger: triggerToUpsertInput(def.trigger) } : {},
     managedByCode: true,
     steps: def.steps.map(stepToUpsertInput)
   };
@@ -2077,6 +2140,8 @@ var LunnoaClient = class {
   variables;
   scorecards;
   connections;
+  /** AI provider connections and the model ids each one accepts. */
+  aiConnections;
   workflowApps;
   discovery;
   constructor(options) {
@@ -2100,6 +2165,7 @@ var LunnoaClient = class {
     this.variables = new VariablesResource(this.http);
     this.scorecards = new ScorecardsResource(this.http);
     this.connections = new ConnectionsResource(this.http);
+    this.aiConnections = new AiConnectionsResource(this.http);
     this.discovery = new DiscoveryResource(this.http);
   }
 };
@@ -2113,6 +2179,7 @@ var GROUPS_WITH_SUBCOMMAND = /* @__PURE__ */ new Set([
   "tools",
   "apps",
   "connections",
+  "ai-connections",
   "skills"
 ]);
 var VALUE_FLAGS = /* @__PURE__ */ new Set([
@@ -2210,6 +2277,7 @@ var USAGE = `Usage:
   npx @lunnoa/client apps get <appId> [--json]
   npx @lunnoa/client connections list [--app <appId>] [--json]
   npx @lunnoa/client connections get <connectionId> [--json]
+  npx @lunnoa/client ai-connections list [--json]
   npx @lunnoa/client agents list [--json]
   npx @lunnoa/client workflows list [--json]
   npx @lunnoa/client entity-types list [--json]
@@ -2239,8 +2307,12 @@ Options:
 Environment: LUNNOA_URL, LUNNOA_API_KEY (also read from ./.env)
 Optional config file: lunnoa.config.ts | .mjs | .js | .json
 
+ai-connections list prints the model ids each AI connection accepts. Use
+models[].id as defineAgent({ model }). connections list is app connections
+(Gmail, HTTP), not model providers.
 tools get prints inputConfig and a defineAction() sketch. tools list is compact;
-run tools get for the schema. An entity-type slug is unique on the deployment
+run tools get for the schema. apps get --json includes triggers and a
+defineTrigger() sketch. Do not invent trigger ids. An entity-type slug is unique on the deployment
 and grants the API key's workspace when the slug is new.
 A slug already granted to other workspaces is not rewritten. Unknown instance attributes are rejected unless
 allowUnknownAttributes is true; use extensions.
@@ -2253,6 +2325,32 @@ function asRecord(value) {
   }
   return void 0;
 }
+function flattenTriggers(apps) {
+  const out = [];
+  for (const app of apps) {
+    const appId = typeof app.id === "string" ? app.id : "";
+    if (!appId) {
+      continue;
+    }
+    const triggers = Array.isArray(app.triggers) ? app.triggers : [];
+    for (const raw of triggers) {
+      const trigger = asRecord(raw);
+      if (!trigger || typeof trigger.id !== "string" || !trigger.id) {
+        continue;
+      }
+      out.push({
+        appId,
+        appName: typeof app.name === "string" ? app.name : appId,
+        triggerId: trigger.id,
+        name: typeof trigger.name === "string" ? trigger.name : trigger.id,
+        description: typeof trigger.description === "string" ? trigger.description : "",
+        needsConnection: typeof trigger.needsConnection === "boolean" ? trigger.needsConnection : Boolean(app.needsConnection),
+        inputConfig: trigger.inputConfig
+      });
+    }
+  }
+  return out;
+}
 function flattenActions(apps) {
   const out = [];
   for (const app of apps) {
@@ -2414,6 +2512,49 @@ function formatDefineActionSnippet(action) {
     "})"
   ].join("\n");
 }
+function formatDefineTriggerSnippet(trigger) {
+  if (trigger.triggerId === "flow-control_trigger_manual") {
+    return [
+      "defineTrigger({",
+      `  id: '${trigger.triggerId}',`,
+      "  // inputs become the Manually Run form (customInputConfig)",
+      "  inputs: [",
+      "    // { id, label, inputType, required }",
+      "  ],",
+      "})"
+    ].join("\n");
+  }
+  const fields = extractInputFields(trigger.inputConfig);
+  const inputBlock = fields.length === 0 ? "    // no inputConfig fields advertised" : fields.map((field) => {
+    const notes = [
+      field.label && field.label !== field.id ? field.label : void 0,
+      field.type,
+      field.required ? "required" : void 0
+    ].filter(Boolean).join(", ");
+    return notes ? `    // ${field.id} \u2014 ${notes}` : `    // ${field.id}`;
+  }).join("\n");
+  return [
+    "defineTrigger({",
+    `  id: '${trigger.triggerId}',`,
+    `  appId: '${trigger.appId}',`,
+    "  input: {",
+    inputBlock,
+    "  },",
+    "})"
+  ].join("\n");
+}
+function triggerDetail(trigger) {
+  return {
+    appId: trigger.appId,
+    triggerId: trigger.triggerId,
+    name: trigger.name,
+    description: trigger.description,
+    needsConnection: trigger.needsConnection,
+    inputFields: extractInputFields(trigger.inputConfig),
+    inputConfig: trigger.inputConfig ?? null,
+    defineTrigger: formatDefineTriggerSnippet(trigger)
+  };
+}
 function actionDetail(action) {
   return {
     ...summarizeAction(action),
@@ -2573,6 +2714,7 @@ async function runAppsGet(client, args) {
     throw new Error(`Unknown app "${appId}". Try: apps list`);
   }
   const actions = flattenActions([app]).map(summarizeAction);
+  const triggers = flattenTriggers([app]).map(triggerDetail);
   const payload = {
     id: app.id,
     name: app.name,
@@ -2581,6 +2723,7 @@ async function runAppsGet(client, args) {
     needsConnection: Boolean(app.needsConnection),
     isPublished: Boolean(app.isPublished),
     actions,
+    triggers,
     connectionTypes: Array.isArray(app.connections) ? app.connections : []
   };
   if (args.json) {
@@ -2601,6 +2744,56 @@ async function runAppsGet(client, args) {
     { key: "availableForAgent", header: "FOR_AGENT" },
     { key: "needsConnection", header: "NEEDS_CONN" }
   ]);
+  if (triggers.length) {
+    console.log("");
+    console.log("triggers:");
+    printTable(
+      triggers.map((trigger) => ({
+        triggerId: trigger.triggerId,
+        name: trigger.name,
+        needsConnection: trigger.needsConnection
+      })),
+      [
+        { key: "triggerId", header: "TRIGGER" },
+        { key: "name", header: "NAME" },
+        { key: "needsConnection", header: "NEEDS_CONN" }
+      ]
+    );
+  }
+}
+async function runAiConnectionsList(client, args) {
+  const connections = await client.aiConnections.list();
+  if (args.json) {
+    printJson(connections);
+    return;
+  }
+  const rows = connections.flatMap((connection) => {
+    if (connection.models.length === 0) {
+      return [
+        {
+          name: connection.name,
+          provider: connection.provider,
+          model: "",
+          isDefault: connection.isDefault,
+          id: connection.id
+        }
+      ];
+    }
+    return connection.models.map((model) => ({
+      name: connection.name,
+      provider: connection.provider,
+      model: model.id,
+      isDefault: connection.isDefault && model.isDefault,
+      id: connection.id
+    }));
+  });
+  printTable(rows, [
+    { key: "name", header: "CONNECTION" },
+    { key: "provider", header: "PROVIDER" },
+    { key: "model", header: "MODEL" },
+    { key: "isDefault", header: "DEFAULT" },
+    { key: "id", header: "ID" }
+  ]);
 }
 async function runConnectionsList(client, args) {
   const connections = await client.connections.list({
@@ -3490,6 +3683,7 @@ var DISCOVERY_SUBCOMMANDS = {
   tools: ["list", "get", "search"],
   apps: ["list", "get"],
   connections: ["list", "get"],
+  "ai-connections": ["list"],
   tables: ["list", "get"],
   features: void 0
 };
@@ -3523,7 +3717,7 @@ ${USAGE}`
 }
 async function runDiscovery(args) {
   const { command, subcommand } = args;
-  if (command === "tools" || command === "apps" || command === "connections" || command === "tables") {
+  if (command === "tools" || command === "apps" || command === "connections" || command === "ai-connections" || command === "tables") {
     assertKnownDiscoveryShape(args);
   }
   if (!isDiscoveryCommand(args)) {
@@ -3558,6 +3752,10 @@ async function runDiscovery(args) {
     await runConnectionsGet(client, args);
     return true;
   }
+  if (command === "ai-connections" && subcommand === "list") {
+    await runAiConnectionsList(client, args);
+    return true;
+  }
   if (command === "agents" && subcommand === "list") {
     await runAgentsList(client, args);
     return true;

package/dist/index.cjs

@@ -468,7 +468,7 @@ var AgentChatClient = class {
 function messageTaskBody(message, options = {}) {
   return {
     messages: [message],
-    ...options.chatMode ? { chatMode: options.chatMode } : {},
+    chatMode: options.chatMode ?? "preview",
     ...options.data ? { data: options.data } : {},
     ...options.piiResolution ? { piiResolution: options.piiResolution } : {}
   };
@@ -537,6 +537,7 @@ var DEFINE_KINDS = {
   connection: "connection",
   aiConnection: "aiConnection",
   action: "action",
+  trigger: "trigger",
   workflow: "workflow",
   agent: "agent",
   entityType: "entityType"
@@ -553,6 +554,25 @@ function defineAction(config) {
   }
   return { kind: DEFINE_KINDS.action, ...config };
 }
+function assertTriggerConfig(config) {
+  if (!config.id?.trim()) {
+    throw new Error("defineTrigger requires id (catalogue trigger id)");
+  }
+  for (const field of config.inputs ?? []) {
+    if (!field?.id?.trim()) {
+      throw new Error("defineTrigger inputs require id");
+    }
+  }
+  if (config.inputs?.length && config.id.trim() !== "flow-control_trigger_manual") {
+    throw new Error(
+      "defineTrigger inputs are only valid on flow-control_trigger_manual"
+    );
+  }
+}
+function defineTrigger(config) {
+  assertTriggerConfig(config);
+  return { kind: DEFINE_KINDS.trigger, ...config };
+}
 function defineWorkflow(config) {
   if (!config.slug?.trim()) {
     throw new Error("defineWorkflow requires slug");
@@ -560,6 +580,9 @@ function defineWorkflow(config) {
   if (!config.steps?.length) {
     throw new Error("defineWorkflow requires at least one step");
   }
+  if (config.trigger) {
+    assertTriggerConfig(config.trigger);
+  }
   return { kind: DEFINE_KINDS.workflow, ...config };
 }
 function defineAgent(config) {
@@ -605,6 +628,40 @@ function resolveActionAppId(action) {
     `Cannot infer appId for action "${id}". Pass appId explicitly.`
   );
 }
+function resolveTriggerAppId(trigger) {
+  if (trigger.appId?.trim()) {
+    return trigger.appId.trim();
+  }
+  const id = trigger.id.trim();
+  const marker = "_trigger_";
+  const markerIndex = id.indexOf(marker);
+  if (markerIndex > 0) {
+    return id.slice(0, markerIndex);
+  }
+  const dot = id.indexOf(".");
+  if (dot > 0) {
+    return id.slice(0, dot);
+  }
+  throw new Error(
+    `Cannot infer appId for trigger "${id}". Pass appId explicitly.`
+  );
+}
+function resolveTriggerId(trigger) {
+  const id = trigger.id.trim();
+  const appId = trigger.appId?.trim();
+  if (appId && id.startsWith(`${appId}.`)) {
+    return id.slice(appId.length + 1);
+  }
+  const marker = "_trigger_";
+  if (id.includes(marker)) {
+    return id;
+  }
+  const dot = id.indexOf(".");
+  if (dot > 0) {
+    return id.slice(dot + 1);
+  }
+  return id;
+}
 function resolveActionId(action) {
   const id = action.id.trim();
   const appId = action.appId?.trim();
@@ -894,6 +951,22 @@ var SsoAuthResource = class {
   }
 };
 
+// src/resources/ai-connections.ts
+var AiConnectionsResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * Lists AI connections the caller can assign to an agent, with the model
+   * ids each connection accepts. Credentials are never included.
+   * Requires `agents:create` (the same permission as agent deploy).
+   */
+  list() {
+    return this.http.get("/api/ai-connections");
+  }
+};
+
 // src/resources/connections.ts
 var ConnectionsResource = class {
   constructor(http) {
@@ -2003,6 +2076,17 @@ var WorkflowAppsResource = class {
 };
 
 // src/resources/workflows.ts
+function triggerToUpsertInput(trigger) {
+  return {
+    triggerId: resolveTriggerId(trigger),
+    appId: resolveTriggerAppId(trigger),
+    ...trigger.connection?.id ? { connectionId: trigger.connection.id } : {},
+    ...trigger.input ? { input: trigger.input } : {},
+    ...trigger.inputs?.length ? { inputs: trigger.inputs } : {},
+    ...trigger.name ? { name: trigger.name } : {},
+    ...trigger.description ? { description: trigger.description } : {}
+  };
+}
 function stepToUpsertInput(step) {
   const use = step.use;
   return {
@@ -2023,6 +2107,7 @@ function workflowDefinitionToUpsert(def) {
     name: def.name,
     description: def.description,
     isActive: def.isActive,
+    ...def.trigger ? { trigger: triggerToUpsertInput(def.trigger) } : {},
     managedByCode: true,
     steps: def.steps.map(stepToUpsertInput)
   };
@@ -2119,6 +2204,8 @@ var LunnoaClient = class {
   variables;
   scorecards;
   connections;
+  /** AI provider connections and the model ids each one accepts. */
+  aiConnections;
   workflowApps;
   discovery;
   constructor(options) {
@@ -2142,6 +2229,7 @@ var LunnoaClient = class {
     this.variables = new VariablesResource(this.http);
     this.scorecards = new ScorecardsResource(this.http);
     this.connections = new ConnectionsResource(this.http);
+    this.aiConnections = new AiConnectionsResource(this.http);
     this.discovery = new DiscoveryResource(this.http);
   }
 };
@@ -2223,6 +2311,7 @@ exports.ActionsResource = ActionsResource;
 exports.AgentChatClient = AgentChatClient;
 exports.AgentChatStream = AgentChatStream;
 exports.AgentsResource = AgentsResource;
+exports.AiConnectionsResource = AiConnectionsResource;
 exports.ApprovalsResource = ApprovalsResource;
 exports.AuthResource = AuthResource;
 exports.ConnectionsResource = ConnectionsResource;
@@ -2257,6 +2346,7 @@ exports.defineAgent = defineAgent;
 exports.defineAiConnection = defineAiConnection;
 exports.defineConnection = defineConnection;
 exports.defineEntityType = defineEntityType;
+exports.defineTrigger = defineTrigger;
 exports.defineWorkflow = defineWorkflow;
 exports.entityTypeDefinitionToUpsert = entityTypeDefinitionToUpsert;
 exports.isBrowserEnvironment = isBrowserEnvironment;
@@ -2267,5 +2357,7 @@ exports.parseSseEvents = parseSseEvents;
 exports.parseSseStream = parseSseStream;
 exports.resolveActionAppId = resolveActionAppId;
 exports.resolveActionId = resolveActionId;
+exports.resolveTriggerAppId = resolveTriggerAppId;
+exports.resolveTriggerId = resolveTriggerId;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map