larkci 0.2.4 → 0.3.0

package/README.md

@@ -2,6 +2,23 @@
 
 Command-line interface for creating, invoking, and managing [LarkCI](https://getlark.ai) testing workflows.
 
+## Table of Contents
+
+- [Quickstart](#quickstart)
+- [Configuration](#configuration)
+- [CI Pipeline Usage](#ci-pipeline-usage)
+- [Usage](#usage)
+  - [workflows](#commands) — create, get, update, list, archive, invoke
+  - [workflows executions](#workflows-executions-get--get-execution-details) — get, logs, cancel
+  - [workflows repairs](#workflows-repairs-trigger--trigger-a-workflow-repair) — trigger, list, get, cancel, logs
+  - [workflows generations](#workflows-generations-cancel--cancel-a-running-generation) — cancel
+  - [workflows events](#workflows-events-list--list-workflow-events) — list
+  - [workflow-groups](#workflow-groups-create--create-a-workflow-group) — create, list, get, update, delete
+  - [secret-contexts](#secret-contexts-list--list-secret-contexts) — list, get, create, update, delete, delete-key
+  - [Examples](#examples)
+- [Contributing](#contributing)
+- [License](#license)
+
 ## Quickstart
 
 Requires Node.js >= 18.
@@ -30,6 +47,37 @@ Alternatively, pass it inline with the `--api-key` flag (see [Global Options](#g
 
 The CLI also supports a `.env` file in the current directory.
 
+## CI Pipeline Usage
+
+The `--wait` flag makes it easy to use in CI pipelines. The command will block until the workflow completes and exit with a non-zero code on failure.
+
+### GitHub Actions Example
+
+Set the `LARKCI_API_KEY` environment variable in GitHub Actions secrets.
+
+```yaml
+- name: Run LarkCI Tests
+  run: npx -y larkci@latest workflows invoke --all --wait
+  env:
+    LARKCI_API_KEY: ${{ secrets.LARKCI_API_KEY }}
+```
+
+### CircleCI Example
+
+Set the `LARKCI_API_KEY` environment variable in CircleCI.
+
+```yaml
+larkci_tests:
+  docker:
+    - image: cimg/node:lts
+  resource_class: small
+  steps:
+    - run:
+        name: Run LarkCI Tests
+        command: |
+          npx -y larkci@latest workflows invoke --all --wait
+```
+
 ## Usage
 
 ```bash
@@ -52,12 +100,13 @@ larkci [options] <command>
 larkci workflows create --name "login-flow" --description "Test the login process end-to-end"
 ```
 
-| Flag                              | Required | Description                                     | Default      |
-| --------------------------------- | -------- | ----------------------------------------------- | ------------ |
-| `--name <name>`                   | Yes      | Workflow name                                   |              |
-| `--description <description>`     | Yes      | Workflow description                            |              |
-| `--mode <mode>`                   | No       | Execution mode: `ai_driven` or `deterministic`  | `ai_driven`  |
-| `--secret-contexts <contexts...>` | No       | Secret contexts to attach to the workflow       |              |
+| Flag                              | Required | Description                                    | Default     |
+| --------------------------------- | -------- | ---------------------------------------------- | ----------- |
+| `--name <name>`                   | Yes      | Workflow name                                  |             |
+| `--description <description>`     | Yes      | Workflow description                           |             |
+| `--mode <mode>`                   | No       | Execution mode: `ai_driven` or `deterministic` | `ai_driven` |
+| `--secret-contexts <contexts...>` | No       | Secret contexts to attach to the workflow      |             |
+| `--group-id <groupId>`            | No       | Workflow group ID to assign this workflow to   |             |
 
 ```bash
 # Create a deterministic workflow with secret contexts
@@ -68,6 +117,30 @@ larkci workflows create \
   --secret-contexts production staging
 ```
 
+#### `workflows get` — Get workflow details
+
+```bash
+larkci workflows get <workflow_id>
+```
+
+Returns the full workflow resource including status, mode, schedule, and last execution/generation/repair info.
+
+#### `workflows update` — Update a workflow
+
+```bash
+larkci workflows update <workflow_id> --name "new-name" --description "updated description"
+```
+
+| Flag                              | Description                               |
+| --------------------------------- | ----------------------------------------- |
+| `--name <name>`                   | New name for the workflow                 |
+| `--description <description>`     | New description for the workflow          |
+| `--secret-contexts <contexts...>` | Secret contexts to attach                 |
+| `--schedule <cron>`               | Cron schedule for the workflow            |
+| `--group-id <groupId>`            | Workflow group ID (use `null` to ungroup) |
+
+At least one option is required.
+
 #### `workflows archive` — Archive a workflow
 
 ```bash
@@ -90,10 +163,11 @@ Restores an archived workflow so it appears in the list and can be invoked again
 larkci workflows list
 ```
 
-| Flag               | Description                     | Default |
-| ------------------ | ------------------------------- | ------- |
-| `--limit <number>` | Max workflows to return (1–100) | `10`    |
-| `--offset <number>`| Number of workflows to skip     | `0`     |
+| Flag                   | Description                     | Default |
+| ---------------------- | ------------------------------- | ------- |
+| `--limit <number>`     | Max workflows to return (1–100) | `10`    |
+| `--offset <number>`    | Number of workflows to skip     | `0`     |
+| `--group-id <groupId>` | Filter workflows by group ID    |         |
 
 #### `workflows invoke` — Invoke workflows
 
@@ -103,30 +177,27 @@ larkci workflows invoke --all --wait --timeout 300
 
 # Invoke specific workflows and wait
 larkci workflows invoke --workflow-ids wf_abc123 wf_def456 --wait --timeout 300
-```
 
-| Flag                      | Description                                                                      |
-| ------------------------- | -------------------------------------------------------------------------------- |
-| `--workflow-ids <id...>`  | The IDs of the workflows to invoke                                               |
-| `--all`                   | Invoke all workflows                                                             |
-| `--wait`                  | Wait for the execution to finish (successfully or unsuccessfully) before exiting |
-| `--timeout <seconds>`     | Maximum time to wait in seconds (default: 600, requires `--wait`)                |
-| `--verbose`               | Print verbose output (includes logs)                                             |
+# Invoke all workflows in a group by ID
+larkci workflows invoke --group-id wfl_grp_abc123 --wait
 
-Either `--workflow-ids` or `--all` is required.
-
-Exit codes: `0` = success, `1` = workflow failure, `2` = timeout, `3` = unexpected error.
+# Invoke all workflows in a group by name
+larkci workflows invoke --group-name "Checkout Flow" --wait
+```
 
-#### `workflows executions list` — List executions
+| Flag                       | Description                                                                      |
+| -------------------------- | -------------------------------------------------------------------------------- |
+| `--workflow-ids <id...>`   | The IDs of the workflows to invoke                                               |
+| `--all`                    | Invoke all workflows                                                             |
+| `--group-id <groupId>`     | Invoke all workflows in a group (by group ID)                                    |
+| `--group-name <groupName>` | Invoke all workflows in a group (by group name)                                  |
+| `--wait`                   | Wait for the execution to finish (successfully or unsuccessfully) before exiting |
+| `--timeout <seconds>`      | Maximum time to wait in seconds (default: 600, requires `--wait`)                |
+| `--verbose`                | Print verbose output (includes logs)                                             |
 
-```bash
-larkci workflows executions list <workflow_id>
-```
+One of `--workflow-ids`, `--all`, `--group-id`, or `--group-name` is required.
 
-| Flag               | Description                      | Default |
-| ------------------ | -------------------------------- | ------- |
-| `--limit <number>` | Max executions to return (1–100) | `10`    |
-| `--offset <number>`| Number of executions to skip     | `0`     |
+Exit codes: `0` = success, `1` = workflow failure, `2` = timeout, `3` = unexpected error.
 
 #### `workflows executions get` — Get execution details
 
@@ -146,6 +217,107 @@ larkci workflows executions logs <workflow_id> <execution_id>
 larkci workflows executions cancel <workflow_id> <execution_id>
 ```
 
+#### `workflows repairs trigger` — Trigger a workflow repair
+
+```bash
+larkci workflows repairs trigger <workflow_id>
+```
+
+Triggers a repair for a workflow. Returns the repair resource.
+
+#### `workflows repairs list` — List workflow repairs
+
+```bash
+larkci workflows repairs list <workflow_id>
+```
+
+| Flag                | Description                   | Default |
+| ------------------- | ----------------------------- | ------- |
+| `--limit <number>`  | Max repairs to return (1–100) | `10`    |
+| `--offset <number>` | Number of repairs to skip     | `0`     |
+
+#### `workflows repairs get` — Get repair details
+
+```bash
+larkci workflows repairs get <workflow_id> <repair_id>
+```
+
+#### `workflows repairs cancel` — Cancel a running repair
+
+```bash
+larkci workflows repairs cancel <workflow_id> <repair_id>
+```
+
+#### `workflows repairs logs` — Get repair logs
+
+```bash
+larkci workflows repairs logs <workflow_id> <repair_id>
+```
+
+#### `workflows generations cancel` — Cancel a running generation
+
+```bash
+larkci workflows generations cancel <workflow_id> <generation_id>
+```
+
+#### `workflows events list` — List workflow events
+
+```bash
+larkci workflows events list <workflow_id>
+```
+
+| Flag                | Description                  | Default |
+| ------------------- | ---------------------------- | ------- |
+| `--limit <number>`  | Max events to return (1–100) | `10`    |
+| `--offset <number>` | Number of events to skip     | `0`     |
+
+Lists all events (generations, executions, repairs) for a workflow.
+
+#### `workflow-groups create` — Create a workflow group
+
+```bash
+larkci workflow-groups create --name "Checkout Flow"
+```
+
+| Flag            | Required | Description                |
+| --------------- | -------- | -------------------------- |
+| `--name <name>` | Yes      | Name of the workflow group |
+
+#### `workflow-groups list` — List workflow groups
+
+```bash
+larkci workflow-groups list
+```
+
+| Flag                | Description                  | Default |
+| ------------------- | ---------------------------- | ------- |
+| `--limit <number>`  | Max groups to return (1–100) | `10`    |
+| `--offset <number>` | Number of groups to skip     | `0`     |
+
+#### `workflow-groups get` — Get a workflow group
+
+```bash
+larkci workflow-groups get <group_id>
+```
+
+#### `workflow-groups update` — Update a workflow group
+
+```bash
+larkci workflow-groups update <group_id> --name "Updated Name"
+```
+
+| Flag            | Description                     |
+| --------------- | ------------------------------- |
+| `--name <name>` | New name for the workflow group |
+
+#### `workflow-groups delete` — Delete a workflow group
+
+```bash
+larkci workflow-groups delete <group_id>
+```
+
+Workflows in the group become ungrouped.
+
 #### `secret-contexts list` — List secret contexts
 
 ```bash
@@ -168,10 +340,10 @@ Returns the context name and the list of key names stored in it. Does not return
 larkci secret-contexts create --context production --secret username=admin --secret password=s3cret
 ```
 
-| Flag                        | Required | Description                                        |
-| --------------------------- | -------- | -------------------------------------------------- |
-| `--context <name>`          | Yes      | Name of the secret context                         |
-| `--secret <key=value>`      | Yes      | Secret key-value pair (repeat for multiple values) |
+| Flag                   | Required | Description                                        |
+| ---------------------- | -------- | -------------------------------------------------- |
+| `--context <name>`     | Yes      | Name of the secret context                         |
+| `--secret <key=value>` | Yes      | Secret key-value pair (repeat for multiple values) |
 
 ```bash
 # Create a secret context with multiple credentials
@@ -182,6 +354,19 @@ larkci secret-contexts create \
   --secret password=testpass
 ```
 
+#### `secret-contexts update` — Update a key in a secret context
+
+```bash
+larkci secret-contexts update <context> --key <key> --value <value>
+```
+
+| Flag              | Required | Description                 |
+| ----------------- | -------- | --------------------------- |
+| `--key <key>`     | Yes      | The key to create or update |
+| `--value <value>` | Yes      | The new value for the key   |
+
+If the key already exists its value is replaced; if it does not exist it is added.
+
 #### `secret-contexts delete` — Delete a secret context
 
 ```bash
@@ -190,15 +375,32 @@ larkci secret-contexts delete <context>
 
 Permanently deletes a secret context. Workflows referencing it will no longer have access.
 
+#### `secret-contexts delete-key` — Delete a key from a secret context
+
+```bash
+larkci secret-contexts delete-key <context> <key>
+```
+
+Removes a single key-value pair from an existing secret context.
+
 ### Examples
 
 ```bash
 # Create a workflow
 larkci workflows create --name "signup-flow" --description "Test user signup"
 
+# Get workflow details
+larkci workflows get wf_abc123
+
+# Update a workflow
+larkci workflows update wf_abc123 --name "updated-signup-flow" --schedule "0 9 * * *"
+
 # List your workflows
 larkci workflows list --limit 20
 
+# List workflows in a group
+larkci workflows list --group-id grp_abc123
+
 # Archive a workflow
 larkci workflows archive wf_abc123
 
@@ -214,8 +416,11 @@ larkci workflows invoke --workflow-ids wf_abc123 --wait
 # Invoke and wait (up to 5 minutes) with verbose logs
 larkci workflows invoke --workflow-ids wf_abc123 --wait --timeout 300 --verbose
 
-# List recent executions for a workflow
-larkci workflows executions list wf_abc123
+# Invoke all workflows in a group by ID
+larkci workflows invoke --group-id wfl_grp_abc123 --wait
+
+# Invoke all workflows in a group by name
+larkci workflows invoke --group-name "Checkout Flow" --wait
 
 # Check execution status
 larkci workflows executions get wf_abc123 exec_xyz789
@@ -226,53 +431,49 @@ larkci workflows executions logs wf_abc123 exec_xyz789
 # Cancel a running execution
 larkci workflows executions cancel wf_abc123 exec_xyz789
 
+# Trigger a repair
+larkci workflows repairs trigger wf_abc123
+
+# List repairs
+larkci workflows repairs list wf_abc123
+
+# Cancel a generation
+larkci workflows generations cancel wf_abc123 gen_xyz789
+
+# List events
+larkci workflows events list wf_abc123
+
+# Create a workflow group
+larkci workflow-groups create --name "Checkout Flow"
+
+# List workflow groups
+larkci workflow-groups list
+
+# Delete a workflow group
+larkci workflow-groups delete grp_abc123
+
 # Override API key inline
 larkci --api-key sk-test-key workflows invoke --workflow-ids wf_abc123
 
 # Store credentials for a secret context
 larkci secret-contexts create --context production --secret username=admin --secret password=s3cret
 
+# Update a single key in a secret context
+larkci secret-contexts update production --key password --value new-s3cret
+
 # List all secret contexts
 larkci secret-contexts list
 
 # View the keys stored in a secret context
 larkci secret-contexts get production
 
+# Delete a key from a secret context
+larkci secret-contexts delete-key production password
+
 # Delete a secret context
 larkci secret-contexts delete production
 ```
 
-## CI Pipeline Usage
-
-The `--wait` flag makes it easy to use in CI pipelines. The command will block until the workflow completes and exit with a non-zero code on failure.
-
-### GitHub Actions Example
-
-Set the `LARKCI_API_KEY` environment variable in GitHub Actions secrets.
-
-```yaml
-- name: Run LarkCI Tests
-  run: npx -y larkci@latest workflows invoke --all --wait
-  env:
-    LARKCI_API_KEY: ${{ secrets.LARKCI_API_KEY }}
-```
-
-### CircleCI Example
-
-Set the `LARKCI_API_KEY` environment variable in CircleCI.
-
-```yaml
-larkci_tests:
-  docker:
-    - image: cimg/node:lts
-  resource_class: small
-  steps:
-    - run:
-        name: Run LarkCI Tests
-        command: |
-          npx -y larkci@latest workflows invoke --all --wait
-```
-
 ## Contributing
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.

package/dist/api/client.d.ts

@@ -1,5 +1,5 @@
 import type { Config } from "../config.js";
-import type { GetSecretContextResponse, ListSecretContextsResponse, ListWorkflowExecutionsResponse, ListWorkflowsResponse, WorkflowExecutionResource, WorkflowResource } from "./types.js";
+import type { GetSecretContextResponse, ListSecretContextsResponse, ListWorkflowEventsResponse, ListWorkflowGroupsResponse, ListWorkflowRepairsResponse, ListWorkflowsResponse, WorkflowExecutionResource, WorkflowGenerationResource, WorkflowGroupResource, WorkflowRepairResource, WorkflowResource } from "./types.js";
 export declare class TimeoutError extends Error {
     constructor(message: string);
 }
@@ -13,11 +13,21 @@ export declare class LarkCIClient {
     private apiKey;
     constructor(config: Config);
     private request;
+    private buildQueryPath;
     createWorkflow(options: {
         name: string;
         description: string;
         secret_contexts?: string[];
         mode?: "ai_driven" | "deterministic";
+        group_id?: string;
+    }): Promise<WorkflowResource>;
+    getWorkflow(workflowId: string): Promise<WorkflowResource>;
+    updateWorkflow(workflowId: string, options: {
+        name?: string;
+        description?: string;
+        secret_contexts?: string[];
+        schedule?: string | null;
+        group_id?: string | null;
     }): Promise<WorkflowResource>;
     archiveWorkflow(workflowId: string): Promise<WorkflowResource>;
     unarchiveWorkflow(workflowId: string): Promise<WorkflowResource>;
@@ -25,21 +35,45 @@ export declare class LarkCIClient {
     listWorkflows(options?: {
         limit?: number;
         offset?: number;
+        group_id?: string;
     }): Promise<ListWorkflowsResponse>;
-    listWorkflowExecutions(workflowId: string, options?: {
-        limit?: number;
-        offset?: number;
-    }): Promise<ListWorkflowExecutionsResponse>;
     getWorkflowExecution(workflowId: string, executionId: string): Promise<WorkflowExecutionResource>;
     getWorkflowExecutionLogs(workflowId: string, executionId: string): Promise<string[]>;
     cancelWorkflowExecution(workflowId: string, executionId: string): Promise<WorkflowExecutionResource>;
+    cancelWorkflowGeneration(workflowId: string, generationId: string): Promise<WorkflowGenerationResource>;
+    repairWorkflow(workflowId: string): Promise<WorkflowRepairResource>;
+    listWorkflowRepairs(workflowId: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<ListWorkflowRepairsResponse>;
+    getWorkflowRepair(workflowId: string, repairId: string): Promise<WorkflowRepairResource>;
+    cancelWorkflowRepair(workflowId: string, repairId: string): Promise<WorkflowRepairResource>;
+    getWorkflowRepairLogs(workflowId: string, repairId: string): Promise<string[]>;
+    listWorkflowEvents(workflowId: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<ListWorkflowEventsResponse>;
     listSecretContexts(): Promise<ListSecretContextsResponse>;
     getSecretContext(context: string): Promise<GetSecretContextResponse>;
     createSecretContext(options: {
         context: string;
         value: Record<string, string>;
     }): Promise<void>;
+    updateSecretContext(context: string, key: string, value: string): Promise<void>;
     deleteSecretContext(context: string): Promise<void>;
+    deleteSecretContextKey(context: string, key: string): Promise<void>;
+    createWorkflowGroup(options: {
+        name: string;
+    }): Promise<WorkflowGroupResource>;
+    listWorkflowGroups(options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<ListWorkflowGroupsResponse>;
+    getWorkflowGroup(groupId: string): Promise<WorkflowGroupResource>;
+    updateWorkflowGroup(groupId: string, options: {
+        name?: string;
+    }): Promise<WorkflowGroupResource>;
+    deleteWorkflowGroup(groupId: string): Promise<void>;
     pollWorkflowExecution(workflowId: string, executionId: string, options: PollOptions): Promise<WorkflowExecutionResource>;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/api/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,8BAA8B,EAC9B,qBAAqB,EACrB,yBAAyB,EACzB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,CACP,SAAS,EAAE,yBAAyB,EACpC,SAAS,EAAE,MAAM,KACd,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;YAKZ,OAAO;IA2Cf,cAAc,CAAC,OAAO,EAAE;QAC5B,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,EAAE,WAAW,GAAG,eAAe,CAAC;KACtC,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIvB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAO9D,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAOhE,cAAc,CAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,yBAAyB,CAAC;IAQ/B,aAAa,CAAC,OAAO,CAAC,EAAE;QAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAW5B,sBAAsB,CAC1B,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5C,OAAO,CAAC,8BAA8B,CAAC;IAapC,oBAAoB,CACxB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,yBAAyB,CAAC;IAO/B,wBAAwB,CAC5B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC;IAOd,uBAAuB,CAC3B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,yBAAyB,CAAC;IAO/B,kBAAkB,IAAI,OAAO,CAAC,0BAA0B,CAAC;IAIzD,gBAAgB,CACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,wBAAwB,CAAC;IAO9B,mBAAmB,CAAC,OAAO,EAAE;QACjC,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC/B,GAAG,OAAO,CAAC,IAAI,CAAC;IAIX,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnD,qBAAqB,CACzB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,yBAAyB,CAAC;CA+BtC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,0BAA0B,EAC1B,0BAA0B,EAC1B,2BAA2B,EAC3B,qBAAqB,EACrB,yBAAyB,EACzB,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,CACP,SAAS,EAAE,yBAAyB,EACpC,SAAS,EAAE,MAAM,KACd,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;YAKZ,OAAO;IA2CrB,OAAO,CAAC,cAAc;IAchB,cAAc,CAAC,OAAO,EAAE;QAC5B,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,EAAE,WAAW,GAAG,eAAe,CAAC;QACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIvB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAO1D,cAAc,CAClB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,GACA,OAAO,CAAC,gBAAgB,CAAC;IAQtB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAO9D,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAOhE,cAAc,CAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,yBAAyB,CAAC;IAQ/B,aAAa,CAAC,OAAO,CAAC,EAAE;QAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAW5B,oBAAoB,CACxB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,yBAAyB,CAAC;IAO/B,wBAAwB,CAC5B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,EAAE,CAAC;IAOd,uBAAuB,CAC3B,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,yBAAyB,CAAC;IAS/B,wBAAwB,CAC5B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,0BAA0B,CAAC;IAShC,cAAc,CAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,sBAAsB,CAAC;IAO5B,mBAAmB,CACvB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5C,OAAO,CAAC,2BAA2B,CAAC;IAQjC,iBAAiB,CACrB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,sBAAsB,CAAC;IAO5B,oBAAoB,CACxB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,sBAAsB,CAAC;IAO5B,qBAAqB,CACzB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,EAAE,CAAC;IASd,kBAAkB,CACtB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5C,OAAO,CAAC,0BAA0B,CAAC;IAUhC,kBAAkB,IAAI,OAAO,CAAC,0BAA0B,CAAC;IAIzD,gBAAgB,CACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,wBAAwB,CAAC;IAO9B,mBAAmB,CAAC,OAAO,EAAE;QACjC,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC/B,GAAG,OAAO,CAAC,IAAI,CAAC;IAIX,mBAAmB,CACvB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC;IAQV,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnD,sBAAsB,CAC1B,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC;IASV,mBAAmB,CAAC,OAAO,EAAE;QACjC,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAQ5B,kBAAkB,CAAC,OAAO,CAAC,EAAE;QACjC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAQjC,gBAAgB,CACpB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,CAAC;IAO3B,mBAAmB,CACvB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GACzB,OAAO,CAAC,qBAAqB,CAAC;IAQ3B,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASnD,qBAAqB,CACzB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,yBAAyB,CAAC;CA+BtC"}

package/dist/api/client.js

@@ -45,9 +45,25 @@ export class LarkCIClient {
             return undefined;
         return JSON.parse(text);
     }
+    buildQueryPath(basePath, params) {
+        const qs = new URLSearchParams();
+        for (const [key, value] of Object.entries(params)) {
+            if (value !== undefined)
+                qs.set(key, String(value));
+        }
+        const query = qs.toString();
+        return query ? `${basePath}?${query}` : basePath;
+    }
+    // ── Workflows ──────────────────────────────────────────────
     async createWorkflow(options) {
         return this.request("POST", "/workflows", options);
     }
+    async getWorkflow(workflowId) {
+        return this.request("GET", `/workflows/${workflowId}`);
+    }
+    async updateWorkflow(workflowId, options) {
+        return this.request("PUT", `/workflows/${workflowId}`, options);
+    }
     async archiveWorkflow(workflowId) {
         return this.request("POST", `/workflows/${workflowId}/archive`);
     }
@@ -58,27 +74,14 @@ export class LarkCIClient {
         return this.request("POST", `/workflows/${workflowId}/invoke`, {});
     }
     async listWorkflows(options) {
-        const params = new URLSearchParams();
-        if (options?.limit !== undefined)
-            params.set("limit", String(options.limit));
-        if (options?.offset !== undefined)
-            params.set("offset", String(options.offset));
-        const query = params.toString();
-        const path = query ? `/workflows?${query}` : "/workflows";
-        return this.request("GET", path);
-    }
-    async listWorkflowExecutions(workflowId, options) {
-        const params = new URLSearchParams();
-        if (options?.limit !== undefined)
-            params.set("limit", String(options.limit));
-        if (options?.offset !== undefined)
-            params.set("offset", String(options.offset));
-        const query = params.toString();
-        const path = query
-            ? `/workflows/${workflowId}/executions?${query}`
-            : `/workflows/${workflowId}/executions`;
+        const path = this.buildQueryPath("/workflows", {
+            limit: options?.limit,
+            offset: options?.offset,
+            group_id: options?.group_id,
+        });
         return this.request("GET", path);
     }
+    // ── Executions ─────────────────────────────────────────────
     async getWorkflowExecution(workflowId, executionId) {
         return this.request("GET", `/workflows/${workflowId}/executions/${executionId}`);
     }
@@ -88,6 +91,33 @@ export class LarkCIClient {
     async cancelWorkflowExecution(workflowId, executionId) {
         return this.request("POST", `/workflows/${workflowId}/executions/${executionId}/cancel`);
     }
+    // ── Generations ────────────────────────────────────────────
+    async cancelWorkflowGeneration(workflowId, generationId) {
+        return this.request("POST", `/workflows/${workflowId}/generations/${generationId}/cancel`);
+    }
+    // ── Repairs ────────────────────────────────────────────────
+    async repairWorkflow(workflowId) {
+        return this.request("POST", `/workflows/${workflowId}/repair`);
+    }
+    async listWorkflowRepairs(workflowId, options) {
+        const path = this.buildQueryPath(`/workflows/${workflowId}/repairs`, { limit: options?.limit, offset: options?.offset });
+        return this.request("GET", path);
+    }
+    async getWorkflowRepair(workflowId, repairId) {
+        return this.request("GET", `/workflows/${workflowId}/repairs/${repairId}`);
+    }
+    async cancelWorkflowRepair(workflowId, repairId) {
+        return this.request("POST", `/workflows/${workflowId}/repairs/${repairId}/cancel`);
+    }
+    async getWorkflowRepairLogs(workflowId, repairId) {
+        return this.request("GET", `/workflows/${workflowId}/repairs/${repairId}/logs`);
+    }
+    // ── Events ─────────────────────────────────────────────────
+    async listWorkflowEvents(workflowId, options) {
+        const path = this.buildQueryPath(`/workflows/${workflowId}/events`, { limit: options?.limit, offset: options?.offset });
+        return this.request("GET", path);
+    }
+    // ── Secret Contexts ────────────────────────────────────────
     async listSecretContexts() {
         return this.request("GET", "/secret-contexts");
     }
@@ -97,9 +127,36 @@ export class LarkCIClient {
     async createSecretContext(options) {
         await this.request("POST", "/secret-contexts", options);
     }
+    async updateSecretContext(context, key, value) {
+        await this.request("PATCH", `/secret-contexts/${encodeURIComponent(context)}`, { key, value });
+    }
     async deleteSecretContext(context) {
         await this.request("DELETE", `/secret-contexts/${encodeURIComponent(context)}`);
     }
+    async deleteSecretContextKey(context, key) {
+        await this.request("DELETE", `/secret-contexts/${encodeURIComponent(context)}/${encodeURIComponent(key)}`);
+    }
+    // ── Workflow Groups ────────────────────────────────────────
+    async createWorkflowGroup(options) {
+        return this.request("POST", "/workflow-groups", options);
+    }
+    async listWorkflowGroups(options) {
+        const path = this.buildQueryPath("/workflow-groups", {
+            limit: options?.limit,
+            offset: options?.offset,
+        });
+        return this.request("GET", path);
+    }
+    async getWorkflowGroup(groupId) {
+        return this.request("GET", `/workflow-groups/${groupId}`);
+    }
+    async updateWorkflowGroup(groupId, options) {
+        return this.request("PUT", `/workflow-groups/${groupId}`, options);
+    }
+    async deleteWorkflowGroup(groupId) {
+        await this.request("DELETE", `/workflow-groups/${groupId}`);
+    }
+    // ── Polling ────────────────────────────────────────────────
     async pollWorkflowExecution(workflowId, executionId, options) {
         const { timeoutMs, pollIntervalMs, onPoll } = options;
         const startTime = Date.now();