hap-cli 0.5.0__py3-none-any.whl

hap_cli/commands/node_cmd.py

@@ -0,0 +1,538 @@
+"""CLI commands for workflow node management."""
+
+import json
+
+import click
+
+from hap_cli.context import pass_context
+from hap_cli.core import flow_node as node_mod
+from hap_cli.utils.formatting import output_json, output_table
+
+
+NODE_TYPES_HELP = (
+    "Node type: 0=Start, 1=Branch, 2=BranchItem, 3=Fill, 4=Approval, "
+    "5=CC, 6=Action(data), 7=Search(single), 8=WebHook, 9=Formula, "
+    "10=Message, 11=Email, 12=Delay, 13=GetMoreRecord(multi/batch), "
+    "14=Code, 15=Link, 16=SubProcess, 17=Push, 18=File, 19=Template, "
+    "20=PBP, 21=JSONParse, 22=Auth, 25=API, 26=ApprovalProcess, "
+    "27=Notice, 28=Snapshot, 29=Loop, 31=AIGC, 32=Plugin, 33=Agent"
+)
+
+ACTION_ID_HELP = (
+    "Action ID for data nodes: "
+    "1=AddRecord, 2=EditRecord, 3=DeleteRecord, 5=CreateRecord, "
+    "6=RefreshSingle, 20=Relation, "
+    "400=FromWorksheet, 401=FromRecord, 402=FromAdd, "
+    "406=WorksheetFind, 407=BatchFind, "
+    "412=BatchUpdate, 413=BatchDelete, 415=RefreshMultiple, "
+    "421=RecordUpdate, 422=RecordDelete"
+)
+
+
+@click.group()
+def node():
+    """Workflow node management."""
+    pass
+
+
+@node.command("list")
+@click.argument("process_id")
+@pass_context
+def node_list(ctx, process_id):
+    """List all nodes in a workflow."""
+    try:
+        session = ctx.get_session()
+        data = node_mod.get_nodes(session, process_id)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@node.command("get")
+@click.argument("process_id")
+@click.argument("node_id")
+@click.option("--type", "node_type", default=0, type=int, help=NODE_TYPES_HELP)
+@pass_context
+def node_get(ctx, process_id, node_id, node_type):
+    """Get node detail/configuration."""
+    try:
+        session = ctx.get_session()
+        data = node_mod.get_node_detail(session, process_id, node_id, node_type)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@node.command("add")
+@click.argument("process_id")
+@click.option("--type", "node_type", required=True, type=int, help=NODE_TYPES_HELP)
+@click.option("--name", "-n", default="", help="Node name")
+@click.option("--after", "select_node_id", default="", help="Insert after this node ID")
+@click.option("--action-id", "-a", default="", help=ACTION_ID_HELP)
+@pass_context
+def node_add(ctx, process_id, node_type, name, select_node_id, action_id):
+    """Add a node to a workflow."""
+    try:
+        session = ctx.get_session()
+        data = node_mod.add_node(
+            session, process_id, node_type,
+            name=name, select_node_id=select_node_id,
+            action_id=action_id,
+        )
+        ctx.output(data, lambda d: click.echo(f"Node added: {d}"))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@node.command("delete")
+@click.argument("process_id")
+@click.argument("node_id")
+@click.option("--yes", "-y", is_flag=True, help="Skip confirmation")
+@pass_context
+def node_delete(ctx, process_id, node_id, yes):
+    """Delete a node from a workflow."""
+    try:
+        if not yes:
+            click.confirm(f"Delete node {node_id}?", abort=True)
+        session = ctx.get_session()
+        data = node_mod.delete_node(session, process_id, node_id)
+        ctx.output(data, lambda d: click.echo("Node deleted."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@node.command("rename")
+@click.argument("process_id")
+@click.argument("node_id")
+@click.option("--name", "-n", required=True, help="New node name")
+@pass_context
+def node_rename(ctx, process_id, node_id, name):
+    """Rename a node."""
+    try:
+        session = ctx.get_session()
+        data = node_mod.update_node_name(session, process_id, node_id, name)
+        ctx.output(data, lambda d: click.echo("Node renamed."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@node.command("desc")
+@click.argument("process_id")
+@click.argument("node_id")
+@click.option("--desc", "-d", default="", help="Node description")
+@click.option("--alias", "-a", default="", help="Node alias")
+@pass_context
+def node_desc(ctx, process_id, node_id, desc, alias):
+    """Update node description/alias."""
+    try:
+        session = ctx.get_session()
+        data = node_mod.update_node_desc(session, process_id, node_id, desc, alias)
+        ctx.output(data, lambda d: click.echo("Node description updated."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@node.command("save")
+@click.argument("process_id")
+@click.argument("node_id")
+@click.option("--type", "node_type", required=True, type=int, help=NODE_TYPES_HELP)
+@click.option("--config", "-c", required=True, help="JSON config string for the node")
+@click.option("--name", "-n", default="", help="Node name")
+@pass_context
+def node_save(ctx, process_id, node_id, node_type, config, name):
+    """Save full node configuration (JSON string).
+
+    The config JSON varies by node type. Use 'node get' to see current config.
+    """
+    try:
+        session = ctx.get_session()
+        config_dict = json.loads(config)
+        data = node_mod.save_node(
+            session, process_id, node_id, node_type, config_dict, name=name,
+        )
+        ctx.output(data, lambda d: click.echo("Node config saved."))
+    except json.JSONDecodeError as e:
+        ctx.handle_error(click.UsageError(f"Invalid JSON: {e}"))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@node.command("test-code")
+@click.argument("process_id")
+@click.argument("node_id")
+@click.option("--code", "-c", required=True, help="Code to test")
+@click.option("--input", "-i", "input_json", default="", help="Input data JSON: [{name,value,type}]")
+@pass_context
+def node_test_code(ctx, process_id, node_id, code, input_json):
+    """Test a code block node."""
+    try:
+        session = ctx.get_session()
+        input_data = json.loads(input_json) if input_json else None
+        data = node_mod.test_code(session, process_id, node_id, code, input_data)
+        ctx.output(data, lambda d: output_json(d))
+    except json.JSONDecodeError as e:
+        ctx.handle_error(click.UsageError(f"Invalid JSON: {e}"))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@node.command("test-webhook")
+@click.argument("process_id")
+@click.argument("node_id")
+@click.option("--url", "-u", required=True, help="Target URL")
+@click.option("--method", "-m", default="POST", help="HTTP method")
+@click.option("--body", "-b", default="", help="Request body (JSON string)")
+@click.option("--headers", "-H", default="", help="Headers JSON: [{name,value}]")
+@click.option("--content-type", default="application/json", help="Content-Type")
+@pass_context
+def node_test_webhook(ctx, process_id, node_id, url, method, body, headers, content_type):
+    """Test a WebHook node."""
+    try:
+        session = ctx.get_session()
+        headers_list = json.loads(headers) if headers else None
+        data = node_mod.test_webhook(
+            session, process_id, node_id, url,
+            method=method, body=body, headers=headers_list,
+            content_type=content_type,
+        )
+        ctx.output(data, lambda d: output_json(d))
+    except json.JSONDecodeError as e:
+        ctx.handle_error(click.UsageError(f"Invalid JSON: {e}"))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@node.command("test-ai")
+@click.argument("process_id")
+@click.argument("node_id")
+@click.option("--prompt", "-p", required=True, help="User prompt")
+@click.option("--model", "-m", default="", help="AI model name")
+@click.option("--system", "-s", default="", help="System message")
+@click.option("--temperature", "-t", default=0.7, type=float, help="Temperature 0-1")
+@pass_context
+def node_test_ai(ctx, process_id, node_id, prompt, model, system, temperature):
+    """Test an AI text generation node."""
+    try:
+        session = ctx.get_session()
+        data = node_mod.test_aigc(
+            session, process_id, node_id, prompt,
+            model=model, system_message=system, temperature=temperature,
+        )
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@node.command("form-property")
+@click.argument("process_id")
+@click.argument("node_id")
+@pass_context
+def node_form_property(ctx, process_id, node_id):
+    """Get node form properties."""
+    try:
+        session = ctx.get_session()
+        data = node_mod.get_node_form_property(session, process_id, node_id)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@node.command("sub-processes")
+@click.argument("process_id")
+@pass_context
+def node_sub_processes(ctx, process_id):
+    """List available sub-processes."""
+    try:
+        session = ctx.get_session()
+        data = node_mod.get_sub_process_list(session, process_id)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@node.command("json-to-controls")
+@click.option("--json-str", "-j", required=True, help="JSON string to convert")
+@pass_context
+def node_json_to_controls(ctx, json_str):
+    """Convert JSON to workflow controls."""
+    try:
+        session = ctx.get_session()
+        data = node_mod.json_to_controls(session, json_str)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@node.command("code-templates")
+@click.option("--keyword", "-k", default="", help="Search keyword")
+@click.option("--page-size", "-n", default=50, help="Items per page")
+@click.option("--page", "-p", default=1, help="Page number")
+@pass_context
+def node_code_templates(ctx, keyword, page_size, page):
+    """List code templates."""
+    try:
+        session = ctx.get_session()
+        data = node_mod.get_code_template_list(
+            session, keyword=keyword, page_index=page, page_size=page_size,
+        )
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@node.command("create-code-template")
+@click.option("--name", "-n", required=True, help="Template name")
+@click.option("--code", "-c", required=True, help="Template code")
+@pass_context
+def node_create_code_template(ctx, name, code):
+    """Create a code template."""
+    try:
+        session = ctx.get_session()
+        data = node_mod.create_code_template(session, name, code)
+        ctx.output(data, lambda d: click.echo(f"Template created: {d}"))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+# ── Data Processing Node Commands ────────────────────────────────────────
+
+
+@node.command("save-action")
+@click.argument("process_id")
+@click.argument("node_id")
+@click.option("--action-id", "-a", required=True, help=(
+    "Action: 1=AddRecord, 2=EditRecord, 3=DeleteRecord, "
+    "5=CreateRecord, 6=RefreshSingle, 20=Relation"))
+@click.option("--app-id", required=True, help="Target worksheet ID")
+@click.option("--fields", "-f", default="", help="Field mapping JSON: [{fieldId,type,fieldValue}]")
+@click.option("--name", "-n", default="", help="Node name")
+@click.option("--select-node-id", "-s", default="", help="Source data node ID")
+@click.option("--condition", default="", help="Filter conditions JSON")
+@click.option("--sorts", default="", help="Sort rules JSON")
+@pass_context
+def node_save_action(ctx, process_id, node_id, action_id, app_id, fields,
+                     name, select_node_id, condition, sorts):
+    """Configure a data ACTION node (add/edit/delete record).
+
+    \b
+    Examples:
+      # Add record node
+      hap-cli node save-action PID NID -a 1 --app-id WSID \\
+        -f '[{"fieldId":"c001","type":2,"fieldValue":"hello"}]'
+      # Edit record node
+      hap-cli node save-action PID NID -a 2 --app-id WSID -s SOURCE_NID \\
+        -f '[{"fieldId":"c001","type":2,"fieldValue":"updated"}]'
+      # Delete record node
+      hap-cli node save-action PID NID -a 3 --app-id WSID -s SOURCE_NID
+    """
+    try:
+        session = ctx.get_session()
+        fields_list = json.loads(fields) if fields else None
+        cond_list = json.loads(condition) if condition else None
+        sorts_list = json.loads(sorts) if sorts else None
+        data = node_mod.save_action_node(
+            session, process_id, node_id, action_id, app_id,
+            fields=fields_list, name=name, select_node_id=select_node_id,
+            operate_condition=cond_list, sorts=sorts_list,
+        )
+        ctx.output(data, lambda d: click.echo("Action node saved."))
+    except json.JSONDecodeError as e:
+        ctx.handle_error(click.UsageError(f"Invalid JSON: {e}"))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@node.command("save-search")
+@click.argument("process_id")
+@click.argument("node_id")
+@click.option("--action-id", "-a", required=True, help=(
+    "Search type: 406=WorksheetFind, 407=BatchFind, "
+    "420=RecordLinkFind, 421=RecordUpdate, 422=RecordDelete"))
+@click.option("--app-id", default="", help="Target worksheet ID (for 406)")
+@click.option("--fields", "-f", default="", help="Return fields JSON")
+@click.option("--name", "-n", default="", help="Node name")
+@click.option("--select-node-id", "-s", default="", help="Source node ID (for 407)")
+@click.option("--condition", default="", help="Query conditions JSON")
+@click.option("--sorts", default="", help="Sort rules JSON")
+@click.option("--random", is_flag=True, help="Pick random record")
+@click.option("--not-found", "execute_type", default=0, type=int,
+              help="When not found: 0=abort, 1=create new, 2=continue")
+@pass_context
+def node_save_search(ctx, process_id, node_id, action_id, app_id, fields,
+                     name, select_node_id, condition, sorts, random, execute_type):
+    """Configure a SEARCH node (get single record).
+
+    \b
+    Examples:
+      # Find a record from worksheet by condition
+      hap-cli node save-search PID NID -a 406 --app-id WSID \\
+        --condition '[{"fieldId":"c001","conditionId":"1","value":["test"]}]'
+      # Find from multi-record node
+      hap-cli node save-search PID NID -a 407 -s MULTI_NODE_ID
+      # Find and update
+      hap-cli node save-search PID NID -a 421 --app-id WSID \\
+        -f '[{"fieldId":"c002","type":2,"fieldValue":"new val"}]'
+      # Find and delete
+      hap-cli node save-search PID NID -a 422 --app-id WSID
+    """
+    try:
+        session = ctx.get_session()
+        fields_list = json.loads(fields) if fields else None
+        cond_list = json.loads(condition) if condition else None
+        sorts_list = json.loads(sorts) if sorts else None
+        data = node_mod.save_search_node(
+            session, process_id, node_id, action_id,
+            app_id=app_id, fields=fields_list, name=name,
+            select_node_id=select_node_id, operate_condition=cond_list,
+            sorts=sorts_list, random=random, execute_type=execute_type,
+        )
+        ctx.output(data, lambda d: click.echo("Search node saved."))
+    except json.JSONDecodeError as e:
+        ctx.handle_error(click.UsageError(f"Invalid JSON: {e}"))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@node.command("save-get-more")
+@click.argument("process_id")
+@click.argument("node_id")
+@click.option("--action-id", "-a", required=True, help=(
+    "Type: 400=FromWorksheet, 401=FromRecord, 402=FromAdd, "
+    "403=FromArray, 412=BatchUpdate, 413=BatchDelete, 415=RefreshMultiple"))
+@click.option("--app-id", default="", help="Target worksheet ID (for 400/412/413)")
+@click.option("--fields", "-f", default="", help="Field mapping JSON")
+@click.option("--name", "-n", default="", help="Node name")
+@click.option("--select-node-id", "-s", default="", help="Source node ID (for 401)")
+@click.option("--condition", default="", help="Filter conditions JSON")
+@click.option("--sorts", default="", help="Sort rules JSON")
+@click.option("--limit", "limit_json", default="", help="Record limit JSON: {fieldValue, fieldNodeId}")
+@click.option("--random", is_flag=True, help="Pick random records")
+@pass_context
+def node_save_get_more(ctx, process_id, node_id, action_id, app_id, fields,
+                       name, select_node_id, condition, sorts, limit_json, random):
+    """Configure a GET_MORE_RECORD node (multi-record/batch ops).
+
+    \b
+    Examples:
+      # Get multiple records from worksheet
+      hap-cli node save-get-more PID NID -a 400 --app-id WSID \\
+        --condition '[{"fieldId":"c001","conditionId":"12","value":["100"]}]'
+      # Get related records from a record
+      hap-cli node save-get-more PID NID -a 401 -s SOURCE_NID
+      # Batch update records
+      hap-cli node save-get-more PID NID -a 412 --app-id WSID \\
+        -f '[{"fieldId":"c001","type":2,"fieldValue":"batch val"}]'
+      # Batch delete records
+      hap-cli node save-get-more PID NID -a 413 --app-id WSID
+    """
+    try:
+        session = ctx.get_session()
+        fields_list = json.loads(fields) if fields else None
+        cond_list = json.loads(condition) if condition else None
+        sorts_list = json.loads(sorts) if sorts else None
+        limit_dict = json.loads(limit_json) if limit_json else None
+        data = node_mod.save_get_more_record_node(
+            session, process_id, node_id, action_id,
+            app_id=app_id, fields=fields_list, name=name,
+            select_node_id=select_node_id, operate_condition=cond_list,
+            sorts=sorts_list, number_field_value=limit_dict, random=random,
+        )
+        ctx.output(data, lambda d: click.echo("GetMoreRecord node saved."))
+    except json.JSONDecodeError as e:
+        ctx.handle_error(click.UsageError(f"Invalid JSON: {e}"))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@node.command("controls")
+@click.argument("process_id")
+@click.argument("node_id")
+@click.option("--app-id", required=True, help="Worksheet ID to get controls for")
+@click.option("--action-id", "-a", default="", help="Action context")
+@pass_context
+def node_controls(ctx, process_id, node_id, app_id, action_id):
+    """Get worksheet fields/controls available for node configuration.
+
+    Use this to discover field IDs before configuring data processing nodes.
+    """
+    try:
+        session = ctx.get_session()
+        data = node_mod.get_app_template_controls(
+            session, process_id, node_id, app_id, action_id=action_id,
+        )
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@node.command("types")
+@pass_context
+def node_types(ctx):
+    """Show all available node types and action IDs."""
+    types_table = [
+        ["Type", "ID", "Description"],
+        ["START", "0", "Start event"],
+        ["BRANCH", "1", "Conditional branch"],
+        ["BRANCH_ITEM", "2", "Branch item"],
+        ["FILL", "3", "Fill-in form"],
+        ["APPROVAL", "4", "Approval task"],
+        ["CC", "5", "CC notification"],
+        ["ACTION", "6", "Data processing (add/edit/delete record)"],
+        ["SEARCH", "7", "Get single record"],
+        ["WEBHOOK", "8", "HTTP request"],
+        ["FORMULA", "9", "Formula/calculation"],
+        ["MESSAGE", "10", "SMS notification"],
+        ["EMAIL", "11", "Email"],
+        ["DELAY", "12", "Delay/timer"],
+        ["GET_MORE_RECORD", "13", "Get multiple records / batch ops"],
+        ["CODE", "14", "Code block"],
+        ["LINK", "15", "Get link"],
+        ["SUB_PROCESS", "16", "Sub-process"],
+        ["PUSH", "17", "UI push notification"],
+        ["FILE", "18", "File/print"],
+        ["TEMPLATE", "19", "Template message"],
+        ["PBP", "20", "Packaged Business Process"],
+        ["JSON_PARSE", "21", "JSON parser"],
+        ["AUTHENTICATION", "22", "Authentication"],
+        ["API_PACKAGE", "24", "API package"],
+        ["API", "25", "Integrated API call"],
+        ["APPROVAL_PROCESS", "26", "Initiate approval"],
+        ["NOTICE", "27", "Notice"],
+        ["SNAPSHOT", "28", "Snapshot"],
+        ["LOOP", "29", "Loop"],
+        ["RETURN", "30", "Return"],
+        ["AIGC", "31", "AI text generation"],
+        ["PLUGIN", "32", "Plugin"],
+        ["AGENT", "33", "AI Agent"],
+    ]
+    if ctx.json_mode:
+        from hap_cli.utils.formatting import output_json as _oj
+        _oj({t[0]: int(t[1]) for t in types_table[1:]})
+    else:
+        cols = types_table[0]
+        click.echo("\n=== Node Types ===")
+        output_table([dict(zip(cols, r)) for r in types_table[1:]], cols)
+
+        actions_table = [
+            ["Action", "ID", "Node Type", "Description"],
+            ["ADD_RECORD", "1", "6(ACTION)", "Add single record"],
+            ["EDIT_RECORD", "2", "6(ACTION)", "Edit single record"],
+            ["DELETE_RECORD", "3", "6(ACTION)", "Delete single record"],
+            ["CREATE_RECORD", "5", "6(ACTION)", "Create record"],
+            ["REFRESH_SINGLE", "6", "6(ACTION)", "Refresh single record data"],
+            ["RELATION", "20", "6(ACTION)", "Get related record"],
+            ["WORKSHEET_FIND", "406", "7(SEARCH)", "Find one from worksheet"],
+            ["BATCH_FIND", "407", "7(SEARCH)", "Find one from multi-records"],
+            ["RECORD_LINK_FIND", "420", "7(SEARCH)", "Find via record link"],
+            ["RECORD_UPDATE", "421", "7(SEARCH)", "Find and update"],
+            ["RECORD_DELETE", "422", "7(SEARCH)", "Find and delete"],
+            ["FROM_WORKSHEET", "400", "13(GET_MORE)", "Get multi from worksheet"],
+            ["FROM_RECORD", "401", "13(GET_MORE)", "Get multi from record relation"],
+            ["FROM_ADD", "402", "13(GET_MORE)", "Get multi from add node"],
+            ["BATCH_UPDATE", "412", "13(GET_MORE)", "Batch update records"],
+            ["BATCH_DELETE", "413", "13(GET_MORE)", "Batch delete records"],
+            ["REFRESH_MULTIPLE", "415", "13(GET_MORE)", "Refresh multiple records"],
+        ]
+        acols = actions_table[0]
+        click.echo("\n=== Action IDs (for data processing) ===")
+        output_table([dict(zip(acols, r)) for r in actions_table[1:]], acols)

hap_cli/commands/optionset_cmd.py

@@ -0,0 +1,99 @@
+"""CLI commands for option set management."""
+
+import json
+
+import click
+
+from hap_cli.context import pass_context
+from hap_cli.core import optionset as optionset_mod
+from hap_cli.utils.formatting import output_json, output_table
+
+
+@click.group()
+def optionset():
+    """Option set management."""
+    pass
+
+
+@optionset.command("list")
+@click.argument("app_id")
+@pass_context
+def optionset_list(ctx, app_id):
+    """List option set collections for an application."""
+    try:
+        session = ctx.get_session()
+        data = optionset_mod.get_collections(session, app_id)
+        ctx.output(
+            data,
+            lambda d: output_table(
+                d if isinstance(d, list) else [],
+                ["collectId", "name"],
+                ["Collection ID", "Name"],
+            ),
+        )
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@optionset.command("get")
+@click.argument("collect_id")
+@pass_context
+def optionset_get(ctx, collect_id):
+    """Get option set collection detail."""
+    try:
+        session = ctx.get_session()
+        data = optionset_mod.get_collection(session, collect_id)
+        ctx.output(data, lambda d: output_json(d))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@optionset.command("save")
+@click.option("--app-id", required=True, help="Application ID")
+@click.option("--name", "-n", required=True, help="Collection name")
+@click.option("--options", "-o", required=True, help="Options as JSON string")
+@click.option("--collect-id", default="", help="Collection ID (for update)")
+@pass_context
+def optionset_save(ctx, app_id, name, options, collect_id):
+    """Create or update an option set collection."""
+    try:
+        session = ctx.get_session()
+        opts = json.loads(options)
+        data = optionset_mod.save_collection(
+            session, app_id, name, opts, collect_id,
+        )
+        ctx.output(data, lambda d: click.echo(f"Collection saved: {d}"))
+    except json.JSONDecodeError:
+        ctx.handle_error(ValueError("Invalid JSON for --options"))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@optionset.command("delete")
+@click.argument("collect_id")
+@click.option("--yes", "-y", is_flag=True, help="Skip confirmation")
+@pass_context
+def optionset_delete(ctx, collect_id, yes):
+    """Delete an option set collection."""
+    try:
+        if not yes:
+            click.confirm(f"Delete collection {collect_id}?", abort=True)
+        session = ctx.get_session()
+        data = optionset_mod.delete_collection(session, collect_id)
+        ctx.output(data, lambda d: click.echo("Collection deleted."))
+    except Exception as e:
+        ctx.handle_error(e)
+
+
+@optionset.command("move")
+@click.argument("collect_id")
+@click.argument("new_app_id")
+@pass_context
+def optionset_move(ctx, collect_id, new_app_id):
+    """Move an option set collection to another application."""
+    try:
+        session = ctx.get_session()
+        data = optionset_mod.move_collection(session, collect_id, new_app_id)
+        ctx.output(data, lambda d: click.echo("Collection moved."))
+    except Exception as e:
+        ctx.handle_error(e)