@kmlckj/licos-ai-cli 0.0.5 → 0.0.7

package/README.md

@@ -1,12 +1,12 @@
 # @kmlckj/licos-ai-cli
 
-LICOS AI 编码工作区 CLI 工具，提供基于前端技术栈的项目初始化和开发工具链。
+LICOS AI 编码工作区 CLI 工具，提供基于前端、移动端和智能体技术栈的项目初始化和开发工具链。
 
 ## 特性
 
 - 快速初始化: 一键创建预配置的项目模板
 - AI 优先设计: 专为 AI Agent 消费设计，提供清晰的错误信息和自描述能力
-- 多模板支持: 支持 React、Next.js、Vite、Nuxt、Taro、Expo 等多种技术栈
+- 多模板支持: 支持 React、Next.js、Vite、Nuxt、Taro、Expo、LangGraph Agent 等多种技术栈
 - 类型安全: 基于 JSON Schema 的参数校验
 - 命令代理: 统一的 dev/build/start 命令，抹平不同技术栈差异
 
@@ -79,6 +79,7 @@ run = ["bash", "./scripts/start.sh"]
 | `nuxt-vue` | Vue 3 + Nuxt，服务端渲染 |
 | `taro` | 小程序 + H5 跨端 |
 | `expo` | React Native 移动端 |
+| `agent` | Python + LangGraph/LangChain 智能体 |
 | `native-static` | 纯静态 HTML/CSS/JS |
 
 ## 开发模板

package/lib/__templates__/agent/.licos

@@ -0,0 +1,14 @@
+[project]
+entrypoint = "src/main.py"
+requires = ["python-3.12"]
+template = "agent"
+
+[dev]
+build = ["bash", "scripts/setup.sh"]
+run = ["bash", "scripts/http_run.sh", "-p", "<%= port %>"]
+deps = ["git"]
+
+[deploy]
+build = ["bash", "scripts/setup.sh"]
+run = ["bash", "scripts/http_run.sh", "-p", "<%= port %>"]
+deps = ["git"]

package/lib/__templates__/agent/README.md

@@ -0,0 +1,40 @@
+# <%= appName %>
+
+LICOS 智能体项目模板，基于 Python、LangGraph、LangChain 和 `licos-agent-runtime`。
+
+## 目录
+
+```text
+.
+├── .licos
+├── pyproject.toml
+├── scripts/
+└── src/
+    ├── main.py
+    └── agents/
+        └── agent.py
+```
+
+## 本地运行
+
+```bash
+bash scripts/setup.sh
+bash scripts/http_run.sh -p <%= port %>
+```
+
+## HTTP 接口
+
+- `GET /health`
+- `POST /run`
+- `POST /stream_run`
+- `POST /cancel/{run_id}`
+- `POST /node_run/{node_id}`
+- `GET /graph_parameter`
+- `POST /v1/chat/completions`
+
+## 工作区约定
+
+- `LICOS_WORKSPACE_PATH=/workspace`
+- `LICOS_PROJECT_PATH=/workspace/projects`
+- `.licos/` 平台数据目录只允许位于 `/workspace/.licos`
+- 当前项目源码只放在 `/workspace/projects`

package/lib/__templates__/agent/_gitignore

@@ -0,0 +1,13 @@
+.venv/
+venv/
+__pycache__/
+*.py[cod]
+*.log
+.env
+.env.local
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+dist/
+build/
+*.egg-info/

package/lib/__templates__/agent/pyproject.toml

@@ -0,0 +1,13 @@
+[project]
+name = "<%= appName %>"
+version = "0.1.0"
+description = "LICOS LangGraph agent project"
+requires-python = ">=3.12"
+dependencies = [
+    "licos-agent-runtime>=0.1.0",
+]
+
+[tool.uv]
+[[tool.uv.index]]
+url = "https://mirrors.aliyun.com/pypi/simple/"
+default = true

package/lib/__templates__/agent/requirements.txt

@@ -0,0 +1 @@
+licos-agent-runtime>=0.1.0

package/lib/__templates__/agent/scripts/http_run.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+set -eo pipefail
+
+PROJECT_DIR="${LICOS_PROJECT_PATH:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)}"
+PORT="${PORT:-<%= port %>}"
+HOST="${HOST:-0.0.0.0}"
+
+while [ "$#" -gt 0 ]; do
+  case "$1" in
+    -p|--port)
+      PORT="$2"
+      shift 2
+      ;;
+    --host)
+      HOST="$2"
+      shift 2
+      ;;
+    *)
+      shift
+      ;;
+  esac
+done
+
+cd "$PROJECT_DIR"
+
+export LICOS_PROJECT_PATH="$PROJECT_DIR"
+export AGENT_PROJECT_TYPE="${AGENT_PROJECT_TYPE:-AGENT}"
+
+exec python -m licos_agent_runtime --mode http --host "$HOST" --port "$PORT"

package/lib/__templates__/agent/scripts/local_run.sh

@@ -0,0 +1,12 @@
+#!/bin/bash
+set -eo pipefail
+
+PROJECT_DIR="${LICOS_PROJECT_PATH:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)}"
+INPUT="${1:-{\"messages\":[{\"role\":\"user\",\"content\":\"你好，介绍一下这个智能体项目。\"}]}}"
+
+cd "$PROJECT_DIR"
+
+export LICOS_PROJECT_PATH="$PROJECT_DIR"
+export AGENT_PROJECT_TYPE="${AGENT_PROJECT_TYPE:-AGENT}"
+
+python -m licos_agent_runtime --mode flow --input "$INPUT"

package/lib/__templates__/agent/scripts/pack.sh

@@ -0,0 +1,23 @@
+#!/bin/bash
+set -eo pipefail
+
+PROJECT_DIR="${LICOS_PROJECT_PATH:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)}"
+PACKAGE_NAME="${PACKAGE_NAME:-<%= appName %>.zip}"
+
+cd "$PROJECT_DIR"
+
+rm -f "$PACKAGE_NAME"
+zip -r "$PACKAGE_NAME" . \
+  -x ".venv/*" \
+  -x "venv/*" \
+  -x "__pycache__/*" \
+  -x "*.pyc" \
+  -x ".git/*" \
+  -x ".pytest_cache/*" \
+  -x ".mypy_cache/*" \
+  -x ".ruff_cache/*" \
+  -x "dist/*" \
+  -x "build/*" \
+  -x "*.egg-info/*"
+
+echo "$PROJECT_DIR/$PACKAGE_NAME"

package/lib/__templates__/agent/scripts/setup.sh

@@ -0,0 +1,70 @@
+#!/bin/bash
+set -eo pipefail
+
+PROJECT_DIR="${LICOS_PROJECT_PATH:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)}"
+cd "$PROJECT_DIR"
+
+PIP_ARGS=(--no-cache-dir)
+if python -m pip --help 2>/dev/null | grep -q -- "--break-system-packages"; then
+  PIP_ARGS+=(--break-system-packages)
+fi
+if [ -n "${PIP_TARGET:-}" ]; then
+  PIP_ARGS+=(--target "$PIP_TARGET")
+fi
+
+runtime_available() {
+  python - <<'PY' >/dev/null 2>&1
+import licos_agent_runtime
+PY
+}
+
+has_extra_requirements() {
+  [ -f "requirements.txt" ] && grep -Ev '^[[:space:]]*(#|$|licos-agent-runtime([<>=!~ ].*)?)[[:space:]]*$' requirements.txt >/dev/null 2>&1
+}
+
+install_filtered_requirements() {
+  local tmp_req
+  tmp_req="$(mktemp)"
+  grep -Ev '^[[:space:]]*(#|$|licos-agent-runtime([<>=!~ ].*)?)[[:space:]]*$' requirements.txt > "$tmp_req" || true
+  if [ -s "$tmp_req" ]; then
+    python -m pip install "${PIP_ARGS[@]}" -r "$tmp_req"
+  fi
+  rm -f "$tmp_req"
+}
+
+RUNTIME_SOURCE="${LICOS_AGENT_RUNTIME_SOURCE:-/opt/licos-agent-runtime}"
+if [ -d "$RUNTIME_SOURCE" ]; then
+  echo "[setup] Installing licos-agent-runtime from $RUNTIME_SOURCE"
+  python -m pip install "${PIP_ARGS[@]}" "$RUNTIME_SOURCE"
+  install_filtered_requirements
+  exit 0
+fi
+
+if runtime_available; then
+  if has_extra_requirements; then
+    echo "[setup] licos-agent-runtime already available, installing extra requirements"
+    install_filtered_requirements
+  else
+    echo "[setup] licos-agent-runtime already available, no extra requirements"
+  fi
+  exit 0
+fi
+
+if command -v uv >/dev/null 2>&1 && [ -f "pyproject.toml" ]; then
+  if [ -n "${PIP_TARGET:-}" ]; then
+    echo "[setup] Deploy mode (uv): installing to PIP_TARGET=$PIP_TARGET"
+    uv export --frozen --no-hashes --no-dev | uv pip install --no-cache --target "$PIP_TARGET" -r -
+  else
+    echo "[setup] Dev mode (uv): syncing .venv"
+    if [ -f "uv.lock" ]; then
+      uv sync --frozen || uv sync
+    else
+      uv sync
+    fi
+  fi
+elif [ -f "requirements.txt" ]; then
+  echo "[setup] Fallback mode (pip): installing from requirements.txt"
+  pip install -r requirements.txt
+else
+  echo "[setup] no pyproject.toml or requirements.txt found, skipping install"
+fi

package/lib/__templates__/agent/src/agents/__init__.py

@@ -0,0 +1,3 @@
+from .agent import create_agent
+
+__all__ = ["create_agent"]

package/lib/__templates__/agent/src/agents/agent.py

@@ -0,0 +1,53 @@
+from __future__ import annotations
+
+from typing import Any, TypedDict
+
+from langgraph.graph import END, START, StateGraph
+
+
+class AgentState(TypedDict, total=False):
+    messages: list[Any]
+    input: str
+    content: str
+    output: str
+
+
+def _message_content(message: Any) -> str:
+    if isinstance(message, dict):
+        value = message.get("content") or message.get("text") or ""
+        return str(value)
+    value = getattr(message, "content", None)
+    return str(value) if value is not None else str(message)
+
+
+def _latest_user_text(messages: list[Any]) -> str:
+    for message in reversed(messages):
+        if isinstance(message, dict):
+            role = str(message.get("role") or "").lower()
+            if role in {"user", "human"}:
+                return _message_content(message)
+            continue
+        role = str(getattr(message, "type", "") or getattr(message, "role", "")).lower()
+        if role in {"user", "human"}:
+            return _message_content(message)
+    return _message_content(messages[-1]) if messages else ""
+
+
+def assistant(state: AgentState) -> AgentState:
+    messages = list(state.get("messages") or [])
+    user_text = str(state.get("input") or "").strip() or _latest_user_text(messages)
+    response = (
+        "这是一个 LICOS 智能体模板。"
+        if not user_text
+        else f"这是一个 LICOS 智能体模板，已收到你的输入：{user_text}"
+    )
+    messages.append({"role": "assistant", "content": response})
+    return {"messages": messages, "content": response, "output": response}
+
+
+def create_agent(_ctx: Any = None) -> Any:
+    builder = StateGraph(AgentState)
+    builder.add_node("assistant", assistant)
+    builder.add_edge(START, "assistant")
+    builder.add_edge("assistant", END)
+    return builder.compile()

package/lib/__templates__/agent/src/main.py

@@ -0,0 +1,7 @@
+from licos_agent_runtime.app import app
+
+
+if __name__ == "__main__":
+    from licos_agent_runtime.__main__ import main
+
+    main()

package/lib/__templates__/agent/src/tools/__init__.py

@@ -0,0 +1 @@
+"""Project-local tools can be added here."""

package/lib/__templates__/agent/template.config.js

@@ -0,0 +1,45 @@
+const description = `Agent（智能体项目）：\`licos init \${LICOS_PROJECT_PATH} --template agent\`
+- 适用：Python + LangGraph/LangChain 智能体项目
+- 使用 licos-agent-runtime 提供 /run、/stream_run、/cancel、OpenAI compatible 等运行时接口
+- 项目源码位于 /workspace/projects，平台数据位于 /workspace/.licos`;
+
+const config = {
+  description,
+  paramsSchema: {
+    type: 'object',
+    properties: {
+      appName: {
+        type: 'string',
+        minLength: 1,
+        pattern: '^[a-z0-9-]+$',
+        description: 'Application name (lowercase, alphanumeric and hyphens only)',
+      },
+      port: {
+        type: 'number',
+        default: 5000,
+        minimum: 1024,
+        maximum: 65535,
+        description: 'Development server port',
+      },
+    },
+    required: [],
+    additionalProperties: false,
+  },
+  defaultParams: {
+    appName: 'agent-project',
+    port: 5000,
+  },
+  onBeforeRender: async context => {
+    console.log(`Creating LICOS Agent project: ${context.appName}`);
+    return context;
+  },
+  onAfterRender: async (_context, outputPath) => {
+    console.log(`\nAgent project created at: ${outputPath}`);
+    console.log('\nConfiguration:');
+    console.log('  - Runtime: licos-agent-runtime');
+    console.log('  - Framework: LangGraph + LangChain');
+    console.log(`  - Port: ${_context.port}`);
+  },
+};
+
+export default config;

package/lib/__templates__/expo/server/package.json

@@ -10,7 +10,7 @@
     "lint": "tsc --noEmit"
   },
   "dependencies": {
-    "@kmlckj/licos-platform-sdk": "0.4.0",
+    "@kmlckj/licos-platform-sdk": "0.5.0",
     "@supabase/supabase-js": "2.95.3",
     "cors": "^2.8.5",
     "dayjs": "^1.11.19",

package/lib/__templates__/nextjs/package.json

@@ -11,7 +11,7 @@
     "ts-check": "tsc -p tsconfig.json"
   },
   "dependencies": {
-    "@kmlckj/licos-platform-sdk": "0.4.0",
+    "@kmlckj/licos-platform-sdk": "0.5.0",
     "@aws-sdk/client-s3": "^3.958.0",
     "@aws-sdk/lib-storage": "^3.958.0",
     "@hookform/resolvers": "^5.2.2",

package/lib/__templates__/nuxt-vue/package.json

@@ -12,7 +12,7 @@
     "start": "bash ./scripts/start.sh"
   },
   "dependencies": {
-    "@kmlckj/licos-platform-sdk": "0.4.0",
+    "@kmlckj/licos-platform-sdk": "0.5.0",
     "@nuxt/image": "^1.8.1",
     "nuxt": "^4.3.1",
     "tailwind-merge": "^2.6.0",

package/lib/__templates__/taro/server/package.json

@@ -11,7 +11,7 @@
     "start:prod": "node dist/main"
   },
   "dependencies": {
-    "@kmlckj/licos-platform-sdk": "0.4.0",
+    "@kmlckj/licos-platform-sdk": "0.5.0",
     "@aws-sdk/client-s3": "^3.958.0",
     "@aws-sdk/lib-storage": "^3.958.0",
     "@nestjs/common": "^10.4.15",

package/lib/__templates__/templates.json

@@ -1,6 +1,31 @@
 {
   "$schema": "https://json-schema.org/draft-07/schema",
   "templates": [
+    {
+      "name": "agent",
+      "description": "Agent（智能体项目）：`licos init ${LICOS_PROJECT_PATH} --template agent`\n- 适用：Python + LangGraph/LangChain 智能体项目\n- 使用 licos-agent-runtime 提供 /run、/stream_run、/cancel、OpenAI compatible 等运行时接口\n- 项目源码位于 /workspace/projects，平台数据位于 /workspace/.licos",
+      "location": "./agent",
+      "paramsSchema": {
+        "type": "object",
+        "properties": {
+          "appName": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^[a-z0-9-]+$",
+            "description": "Application name (lowercase, alphanumeric and hyphens only)"
+          },
+          "port": {
+            "type": "number",
+            "default": 5000,
+            "minimum": 1024,
+            "maximum": 65535,
+            "description": "Development server port"
+          }
+        },
+        "required": [],
+        "additionalProperties": false
+      }
+    },
     {
       "name": "expo",
       "description": "Expo template for React Native applications",

package/lib/__templates__/vite/package.json

@@ -11,7 +11,7 @@
     "ts-check": "tsc -p tsconfig.json"
   },
   "dependencies": {
-    "@kmlckj/licos-platform-sdk": "0.4.0",
+    "@kmlckj/licos-platform-sdk": "0.5.0",
     "@supabase/supabase-js": "2.95.3",
     "dotenv": "^17.2.3",
     "express": "^4.21.2"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kmlckj/licos-ai-cli",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "LICOS AI coding workspace CLI - project template engine and dev tools",
   "license": "MIT",
   "author": "kmlckj",