tinet-agent-cli 0.1.0.dev36__py3-none-any.whl

taco/commands/aikb.py

@@ -0,0 +1,132 @@
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Any
+
+import typer
+
+from taco.aikb.catalog import load_catalog
+from taco.aikb.parameters import parse_parameters, thaw
+from taco.aikb.service import AikbService
+from taco.core.context import get_cli_context
+from taco.core.errors import TacoError
+from taco.core.output import emit_success, exit_with_error
+
+
+aikb_app = typer.Typer(help="发现并调用开发者中心 AIKB operation")
+operation_app = typer.Typer(help="发现 AIKB operation")
+aikb_app.add_typer(operation_app, name="operation")
+
+
+@operation_app.command("list", help="列出 AIKB operation。")
+def list_operations(
+    ctx: typer.Context,
+    group: str | None = typer.Option(None, "--group", help="按分组筛选。"),
+) -> None:
+    operations = [
+        _summary(item)
+        for item in load_catalog().operations
+        if group is None or item.group == group
+    ]
+    emit_success(ctx, operations, json_default=True)
+
+
+@operation_app.command("search", help="按关键词搜索 AIKB operation。")
+def search(ctx: typer.Context, query: str = typer.Argument(...)) -> None:
+    needle = query.casefold()
+    matches = []
+    for operation in load_catalog().operations:
+        haystack = " ".join(
+            [operation.id, operation.title, operation.description, *operation.keywords]
+        ).casefold()
+        if needle in haystack:
+            matches.append(_summary(operation))
+    emit_success(ctx, matches[:10], json_default=True)
+
+
+@operation_app.command("describe", help="查看 operation 完整契约。")
+def describe(ctx: typer.Context, operation_id: str = typer.Argument(...)) -> None:
+    operation = load_catalog().by_id.get(operation_id)
+    if operation is None:
+        exit_with_error(ctx, _not_found(operation_id), json_default=True)
+    emit_success(
+        ctx,
+        {
+            **_summary(operation),
+            "description": operation.description,
+            "keywords": list(operation.keywords),
+            "http": thaw(operation.http),
+            "response": thaw(operation.response),
+            "risk": thaw(operation.risk),
+            "execution": thaw(operation.execution),
+            "file_input": thaw(operation.file_input),
+            "examples": thaw(operation.examples),
+        },
+        json_default=True,
+    )
+
+
+@aikb_app.command("call", help="校验参数并执行 AIKB operation。")
+def call(
+    ctx: typer.Context,
+    operation_id: str = typer.Argument(...),
+    param: list[str] | None = typer.Option(None, "--param", help="语义参数 key=value，可重复。"),
+    params_file: Path | None = typer.Option(None, "--params-file", help="语义参数 JSON 文件。"),
+    body_file: Path | None = typer.Option(None, "--body-file", help="JSON body 文件。"),
+    file: Path | None = typer.Option(None, "--file", help="需要上传的本地文件。"),
+    yes: bool = typer.Option(False, "--yes", help="确认写或删除操作。"),
+    upload_timeout: float | None = typer.Option(None, "--upload-timeout", min=0.1, help="PUT 上传超时秒数。"),
+) -> None:
+    catalog = load_catalog()
+    operation = catalog.by_id.get(operation_id)
+    if operation is None:
+        exit_with_error(ctx, _not_found(operation_id), json_default=True)
+    if operation.risk["requires_confirmation"] and not yes:
+        exit_with_error(
+            ctx,
+            TacoError(
+                code="AIKB_CONFIRM_REQUIRED",
+                message=f"operation `{operation_id}` 需要显式传入 --yes。",
+                exit_code=2,
+            ),
+            json_default=True,
+        )
+    try:
+        query, body = parse_parameters(
+            operation,
+            params=param,
+            params_file=params_file,
+            body_file=body_file,
+            has_file=file is not None,
+        )
+        result = AikbService().call(
+            operation_id,
+            query=query,
+            body=body,
+            profile=get_cli_context(ctx).profile,
+            file_path=file,
+            upload_timeout=upload_timeout,
+        )
+    except TacoError as error:
+        exit_with_error(ctx, error, json_default=True)
+    emit_success(ctx, result, json_default=True)
+
+
+def _summary(operation) -> dict[str, Any]:
+    return {
+        "id": operation.id,
+        "title": operation.title,
+        "group": operation.group,
+        "method": operation.http["method"],
+        "path": operation.http["path"],
+        "risk": operation.risk["level"],
+    }
+
+
+def _not_found(operation_id: str) -> TacoError:
+    return TacoError(
+        code="AIKB_OPERATION_NOT_FOUND",
+        message=f"未知 AIKB operation：{operation_id}",
+        exit_code=2,
+        hint="请执行 taco aikb operation search 或 list 查找候选接口。",
+    )

taco/commands/app.py

@@ -0,0 +1,151 @@
+from __future__ import annotations
+
+import typer
+
+from taco.core.context import get_cli_context
+from taco.core.errors import TacoError
+from taco.core.output import emit_success, exit_with_error
+from taco.services.app_service import AppService
+
+
+app_app = typer.Typer(help="应用管理")
+template_app = typer.Typer(help="应用模板发现与创建")
+tag_app = typer.Typer(help="应用标签发现")
+app_app.add_typer(template_app, name="template")
+app_app.add_typer(tag_app, name="tag")
+
+
+@app_app.command("list", help="分页列出应用并按名称、模式或标签过滤。")
+def list_apps(
+    ctx: typer.Context,
+    page: int = typer.Option(1, "--page", min=1, help="页码。"),
+    limit: int = typer.Option(20, "--limit", min=1, help="每页数量。"),
+    name: str | None = typer.Option(None, "--name", help="按应用名称过滤。"),
+    mode: str | None = typer.Option(None, "--mode", help="按应用模式过滤。"),
+    tag_ids: list[str] | None = typer.Option(
+        None,
+        "--tag-id",
+        help="按标签 ID 过滤，可重复；多个标签按任一匹配。",
+    ),
+) -> None:
+    cli_context = get_cli_context(ctx)
+    try:
+        result = AppService().list_apps(
+            page=page,
+            limit=limit,
+            name=name,
+            mode=mode,
+            tag_ids=tag_ids or [],
+            profile=cli_context.profile,
+        )
+    except TacoError as error:
+        exit_with_error(ctx, error, json_default=True)
+
+    emit_success(ctx, result, json_default=True)
+
+
+@tag_app.command("list", help="列出应用标签并可按名称关键词过滤。")
+def list_app_tags(
+    ctx: typer.Context,
+    keyword: str | None = typer.Option(
+        None,
+        "--keyword",
+        help="按标签名称关键词过滤。",
+    ),
+) -> None:
+    cli_context = get_cli_context(ctx)
+    try:
+        result = AppService().list_tags(
+            keyword=keyword,
+            profile=cli_context.profile,
+        )
+    except TacoError as error:
+        exit_with_error(ctx, error, json_default=True)
+
+    emit_success(ctx, result, json_default=True)
+
+
+@app_app.command("get", help="按应用 ID 获取详情。")
+def get_app(ctx: typer.Context, app_id: str = typer.Argument(..., help="应用 ID。")) -> None:
+    cli_context = get_cli_context(ctx)
+    try:
+        result = AppService().get_app(app_id, profile=cli_context.profile)
+    except TacoError as error:
+        exit_with_error(ctx, error, json_default=True)
+
+    emit_success(ctx, result, json_default=True)
+
+
+@app_app.command("create", help="创建指定模式的通用应用。")
+def create_app(
+    ctx: typer.Context,
+    name: str = typer.Option(..., "--name", help="应用名称。"),
+    mode: str = typer.Option(..., "--mode", help="应用模式。"),
+) -> None:
+    cli_context = get_cli_context(ctx)
+    try:
+        result = AppService().create_app(
+            name=name,
+            mode=mode,
+            profile=cli_context.profile,
+        )
+    except TacoError as error:
+        exit_with_error(ctx, error, json_default=True)
+
+    emit_success(ctx, result, json_default=True)
+
+
+@template_app.command("list", help="列出当前企业可用的应用模板。")
+def list_app_templates(
+    ctx: typer.Context,
+    language: str | None = typer.Option(
+        None,
+        "--language",
+        help="模板语言；不传时使用账号或平台默认语言。",
+    ),
+) -> None:
+    cli_context = get_cli_context(ctx)
+    try:
+        result = AppService().list_templates(
+            language=language,
+            profile=cli_context.profile,
+        )
+    except TacoError as error:
+        exit_with_error(ctx, error, json_default=True)
+
+    emit_success(ctx, result, json_default=True)
+
+
+@template_app.command("create", help="从应用模板创建远端应用。")
+def create_app_from_template(
+    ctx: typer.Context,
+    template_app_id: str = typer.Argument(..., help="模板应用 ID。"),
+    name: str | None = typer.Option(
+        None,
+        "--name",
+        help="覆盖模板名称；不传时沿用模板原名称。",
+    ),
+    yes: bool = typer.Option(False, "--yes", help="确认创建远端应用。"),
+) -> None:
+    if not yes:
+        exit_with_error(
+            ctx,
+            TacoError(
+                code="APP_TEMPLATE_CREATE_CONFIRM_REQUIRED",
+                message="通过模板创建远端应用前必须显式传入 --yes。",
+                exit_code=2,
+            ),
+            json_default=True,
+        )
+
+    cli_context = get_cli_context(ctx)
+    try:
+        result = AppService().create_app_from_template(
+            template_app_id,
+            name=name,
+            profile=cli_context.profile,
+        )
+    except TacoError as error:
+        exit_with_error(ctx, error, json_default=True)
+
+    emit_success(ctx, result, json_default=True)

taco/commands/category.py

@@ -0,0 +1,37 @@
+from __future__ import annotations
+
+import typer
+
+from taco.core.context import get_cli_context
+from taco.core.errors import TacoError
+from taco.core.output import emit_success, exit_with_error
+from taco.services.category_service import CategoryService
+
+
+category_app = typer.Typer(help="智能体分类发现")
+
+
+@category_app.command("list", help="列出服务端当前配置的智能体分类树。")
+def list_categories(ctx: typer.Context) -> None:
+    cli_context = get_cli_context(ctx)
+    try:
+        result = CategoryService().list_categories(profile=cli_context.profile)
+    except TacoError as error:
+        exit_with_error(ctx, error, json_default=True)
+    emit_success(ctx, result, json_default=True)
+
+
+@category_app.command("get", help="按 code 获取分类，支持嵌套子分类。")
+def get_category(
+    ctx: typer.Context,
+    code: str = typer.Argument(..., help="分类 code。"),
+) -> None:
+    cli_context = get_cli_context(ctx)
+    try:
+        result = CategoryService().get_category(
+            code,
+            profile=cli_context.profile,
+        )
+    except TacoError as error:
+        exit_with_error(ctx, error, json_default=True)
+    emit_success(ctx, result, json_default=True)

taco/commands/chatflow.py

@@ -0,0 +1,183 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+import typer
+
+from taco.commands.workflow import (
+    apply_workflow,
+    publish_workflow,
+    run_workflow,
+    stop_workflow,
+    validate_workflow,
+    _cleanup_workflow_temporary,
+    _commit_workflow_yaml,
+    _prepare_workflow_output,
+    _stage_workflow_yaml,
+)
+from taco.core.assets import load_json_asset
+from taco.core.context import get_cli_context
+from taco.core.errors import TacoError
+from taco.core.output import emit_success, exit_with_error
+from taco.services.workflow_service import WorkflowService
+
+
+chatflow_app = typer.Typer(help="Chatflow（advanced-chat）本地 DSL 工具")
+
+
+@chatflow_app.command("create", help="创建远端 Chatflow 并初始化本地 YAML DSL。")
+def create_chatflow(
+    ctx: typer.Context,
+    name: str = typer.Option(..., "--name", help="Chatflow 名称。"),
+    description: str = typer.Option(
+        ...,
+        "--description",
+        help="Chatflow 描述。",
+    ),
+    output: Path = typer.Option(
+        ...,
+        "--output",
+        help="本地 Chatflow YAML 输出路径。",
+    ),
+    yes: bool = typer.Option(False, "--yes", help="确认创建远端 Chatflow。"),
+    overwrite: bool = typer.Option(
+        False,
+        "--overwrite",
+        help="允许覆盖已存在的本地 Chatflow YAML。",
+    ),
+) -> None:
+    if not yes:
+        exit_with_error(
+            ctx,
+            TacoError(
+                code="CHATFLOW_CREATE_CONFIRM_REQUIRED",
+                message="创建远端 Chatflow 前必须显式传入 --yes。",
+                exit_code=2,
+            ),
+            json_default=True,
+        )
+
+    cli_context = get_cli_context(ctx)
+    temporary: Path | None = None
+    try:
+        _prepare_workflow_output(output, overwrite=overwrite)
+        chatflow = load_json_asset("examples", "chatflow-basic")
+        chatflow["name"] = name
+        chatflow["description"] = description
+        temporary = _stage_workflow_yaml(output, chatflow)
+        app = WorkflowService().create_workflow_app(
+            name,
+            description,
+            profile=cli_context.profile,
+            mode="advanced-chat",
+        )
+        app_id = app.get("id")
+        if not isinstance(app_id, str) or not app_id.strip():
+            raise TacoError(
+                code="WORKFLOW_CREATE_RESPONSE_INVALID",
+                message="创建 Chatflow 的响应缺少有效应用 ID。",
+                exit_code=4,
+            )
+        _commit_workflow_yaml(
+            temporary,
+            output,
+            overwrite=overwrite,
+            app_id=app_id,
+        )
+    except TacoError as error:
+        exit_with_error(ctx, error, json_default=True)
+    finally:
+        _cleanup_workflow_temporary(temporary)
+
+    emit_success(
+        ctx,
+        {
+            "app_id": app_id,
+            "name": app.get("name") if isinstance(app.get("name"), str) else name,
+            "mode": "advanced-chat",
+            "path": str(output),
+        },
+        json_default=True,
+    )
+
+
+@chatflow_app.command("validate", help="校验 YAML DSL 并本地编译为 Dify graph。")
+def validate_chatflow(
+    ctx: typer.Context,
+    file: Path = typer.Option(
+        ...,
+        "-f",
+        "--file",
+        help="本地 Chatflow YAML 文件。",
+    ),
+) -> None:
+    validate_workflow(ctx, file=file)
+
+
+@chatflow_app.command("apply", help="预览或同步本地 Chatflow graph 到远端 draft。")
+def apply_chatflow(
+    ctx: typer.Context,
+    app_id: str = typer.Argument(..., help="应用 ID。"),
+    file: Path = typer.Option(
+        ...,
+        "-f",
+        "--file",
+        help="本地 Chatflow YAML 文件。",
+    ),
+    dry_run: bool = typer.Option(
+        False,
+        "--dry-run",
+        help="仅预览变更，不写入远端。",
+    ),
+    yes: bool = typer.Option(False, "--yes", help="确认同步 draft。"),
+) -> None:
+    apply_workflow(ctx, app_id=app_id, file=file, dry_run=dry_run, yes=yes)
+
+
+@chatflow_app.command("run", help="通过 SSE 调试远端 Chatflow draft。")
+def run_chatflow(
+    ctx: typer.Context,
+    app_id: str = typer.Argument(..., help="应用 ID。"),
+    inputs_file: Path | None = typer.Option(
+        None,
+        "--inputs-file",
+        help="Chatflow inputs JSON 对象文件。",
+    ),
+    query: str | None = typer.Option(
+        None,
+        "--query",
+        help="用户问题（advanced-chat draft run）。",
+    ),
+    stream_events: bool = typer.Option(
+        False,
+        "--stream-events",
+        help="实时输出 NDJSON 事件，便于获取 task_id。",
+    ),
+) -> None:
+    run_workflow(
+        ctx,
+        app_id=app_id,
+        inputs_file=inputs_file,
+        query=query,
+        stream_events=stream_events,
+    )
+
+
+@chatflow_app.command("stop", help="使用 task_id 停止 Chatflow draft 调试任务。")
+def stop_chatflow(
+    ctx: typer.Context,
+    app_id: str = typer.Argument(..., help="应用 ID。"),
+    task_id: str = typer.Option(..., "--task-id", help="SSE 返回的任务 ID。"),
+) -> None:
+    stop_workflow(ctx, app_id=app_id, task_id=task_id)
+
+
+@chatflow_app.command("publish", help="发布当前 Chatflow draft。")
+def publish_chatflow(
+    ctx: typer.Context,
+    app_id: str = typer.Argument(..., help="应用 ID。"),
+    title: str | None = typer.Option(None, "--title", help="发布版本名称。"),
+    notes: str | None = typer.Option(None, "--notes", help="发布说明。"),
+    yes: bool = typer.Option(False, "--yes", help="确认发布 Chatflow。"),
+) -> None:
+    publish_workflow(ctx, app_id=app_id, title=title, notes=notes, yes=yes)