@1claw/cli 0.37.0 → 0.37.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (173) hide show
  1. package/dist/bundled-templates/registry.yaml +62 -0
  2. package/dist/bundled-templates/templates/agentkit/Dockerfile +28 -0
  3. package/dist/bundled-templates/templates/agentkit/README.md +36 -0
  4. package/dist/bundled-templates/templates/agentkit/agent.py +83 -0
  5. package/dist/bundled-templates/templates/agentkit/entrypoint.sh +34 -0
  6. package/dist/bundled-templates/templates/agentkit/requirements.txt +5 -0
  7. package/dist/bundled-templates/templates/agentkit/template.yaml +24 -0
  8. package/dist/bundled-templates/templates/agno/Dockerfile +28 -0
  9. package/dist/bundled-templates/templates/agno/README.md +36 -0
  10. package/dist/bundled-templates/templates/agno/agent.py +86 -0
  11. package/dist/bundled-templates/templates/agno/entrypoint.sh +34 -0
  12. package/dist/bundled-templates/templates/agno/requirements.txt +2 -0
  13. package/dist/bundled-templates/templates/agno/template.yaml +24 -0
  14. package/dist/bundled-templates/templates/coder/Dockerfile +28 -0
  15. package/dist/bundled-templates/templates/coder/README.md +36 -0
  16. package/dist/bundled-templates/templates/coder/agent.py +119 -0
  17. package/dist/bundled-templates/templates/coder/entrypoint.sh +34 -0
  18. package/dist/bundled-templates/templates/coder/requirements.txt +4 -0
  19. package/dist/bundled-templates/templates/coder/template.yaml +24 -0
  20. package/dist/bundled-templates/templates/crewai/Dockerfile +28 -0
  21. package/dist/bundled-templates/templates/crewai/README.md +29 -0
  22. package/dist/bundled-templates/templates/crewai/agent.py +109 -0
  23. package/dist/bundled-templates/templates/crewai/entrypoint.sh +34 -0
  24. package/dist/bundled-templates/templates/crewai/requirements.txt +3 -0
  25. package/dist/bundled-templates/templates/crewai/template.yaml +24 -0
  26. package/dist/bundled-templates/templates/elizaos/Dockerfile +31 -0
  27. package/dist/bundled-templates/templates/elizaos/README.md +36 -0
  28. package/dist/bundled-templates/templates/elizaos/agent.ts +100 -0
  29. package/dist/bundled-templates/templates/elizaos/entrypoint.sh +34 -0
  30. package/dist/bundled-templates/templates/elizaos/package.json +18 -0
  31. package/dist/bundled-templates/templates/elizaos/template.yaml +25 -0
  32. package/dist/bundled-templates/templates/elizaos/tsconfig.json +12 -0
  33. package/dist/bundled-templates/templates/langchain/Dockerfile +28 -0
  34. package/dist/bundled-templates/templates/langchain/README.md +37 -0
  35. package/dist/bundled-templates/templates/langchain/agent.py +115 -0
  36. package/dist/bundled-templates/templates/langchain/entrypoint.sh +36 -0
  37. package/dist/bundled-templates/templates/langchain/requirements.txt +4 -0
  38. package/dist/bundled-templates/templates/langchain/template.yaml +24 -0
  39. package/dist/bundled-templates/templates/llamaindex/Dockerfile +28 -0
  40. package/dist/bundled-templates/templates/llamaindex/README.md +36 -0
  41. package/dist/bundled-templates/templates/llamaindex/agent.py +97 -0
  42. package/dist/bundled-templates/templates/llamaindex/entrypoint.sh +34 -0
  43. package/dist/bundled-templates/templates/llamaindex/requirements.txt +3 -0
  44. package/dist/bundled-templates/templates/llamaindex/template.yaml +24 -0
  45. package/dist/bundled-templates/templates/mastra/Dockerfile +31 -0
  46. package/dist/bundled-templates/templates/mastra/README.md +31 -0
  47. package/dist/bundled-templates/templates/mastra/agent.ts +112 -0
  48. package/dist/bundled-templates/templates/mastra/entrypoint.sh +34 -0
  49. package/dist/bundled-templates/templates/mastra/package.json +17 -0
  50. package/dist/bundled-templates/templates/mastra/template.yaml +25 -0
  51. package/dist/bundled-templates/templates/mastra/tsconfig.json +12 -0
  52. package/dist/bundled-templates/templates/openai-agents/Dockerfile +28 -0
  53. package/dist/bundled-templates/templates/openai-agents/README.md +29 -0
  54. package/dist/bundled-templates/templates/openai-agents/agent.py +98 -0
  55. package/dist/bundled-templates/templates/openai-agents/entrypoint.sh +34 -0
  56. package/dist/bundled-templates/templates/openai-agents/requirements.txt +3 -0
  57. package/dist/bundled-templates/templates/openai-agents/template.yaml +24 -0
  58. package/dist/bundled-templates/templates/pydantic-ai/Dockerfile +28 -0
  59. package/dist/bundled-templates/templates/pydantic-ai/README.md +36 -0
  60. package/dist/bundled-templates/templates/pydantic-ai/agent.py +110 -0
  61. package/dist/bundled-templates/templates/pydantic-ai/entrypoint.sh +34 -0
  62. package/dist/bundled-templates/templates/pydantic-ai/requirements.txt +2 -0
  63. package/dist/bundled-templates/templates/pydantic-ai/template.yaml +24 -0
  64. package/dist/bundled-templates/templates/smolagents/Dockerfile +28 -0
  65. package/dist/bundled-templates/templates/smolagents/README.md +36 -0
  66. package/dist/bundled-templates/templates/smolagents/agent.py +97 -0
  67. package/dist/bundled-templates/templates/smolagents/entrypoint.sh +34 -0
  68. package/dist/bundled-templates/templates/smolagents/requirements.txt +2 -0
  69. package/dist/bundled-templates/templates/smolagents/template.yaml +24 -0
  70. package/dist/bundled-templates/templates/typescript-sdk/Dockerfile +31 -0
  71. package/dist/bundled-templates/templates/typescript-sdk/README.md +29 -0
  72. package/dist/bundled-templates/templates/typescript-sdk/agent.ts +130 -0
  73. package/dist/bundled-templates/templates/typescript-sdk/entrypoint.sh +34 -0
  74. package/dist/bundled-templates/templates/typescript-sdk/package.json +17 -0
  75. package/dist/bundled-templates/templates/typescript-sdk/template.yaml +25 -0
  76. package/dist/bundled-templates/templates/typescript-sdk/tsconfig.json +12 -0
  77. package/dist/src/commands/init.d.ts.map +1 -1
  78. package/dist/src/commands/init.js +6 -1
  79. package/dist/src/commands/init.js.map +1 -1
  80. package/dist/src/commands/proxy.d.ts.map +1 -1
  81. package/dist/src/commands/proxy.js +4 -0
  82. package/dist/src/commands/proxy.js.map +1 -1
  83. package/dist/src/commands/spawn.d.ts.map +1 -1
  84. package/dist/src/commands/spawn.js +5 -1
  85. package/dist/src/commands/spawn.js.map +1 -1
  86. package/dist/src/lib/module-deprecation.d.ts +8 -0
  87. package/dist/src/lib/module-deprecation.d.ts.map +1 -0
  88. package/dist/src/lib/module-deprecation.js +15 -0
  89. package/dist/src/lib/module-deprecation.js.map +1 -0
  90. package/dist/src/lib/paths.d.ts +5 -4
  91. package/dist/src/lib/paths.d.ts.map +1 -1
  92. package/dist/src/lib/paths.js +27 -13
  93. package/dist/src/lib/paths.js.map +1 -1
  94. package/dist/src/registry.yaml +62 -0
  95. package/dist/src/templates/agentkit/Dockerfile +34 -0
  96. package/dist/src/templates/agentkit/README.md +36 -0
  97. package/dist/src/templates/agentkit/agent.py +83 -0
  98. package/dist/src/templates/agentkit/entrypoint.sh +34 -0
  99. package/dist/src/templates/agentkit/requirements.txt +5 -0
  100. package/dist/src/templates/agentkit/template.yaml +24 -0
  101. package/dist/src/templates/agno/Dockerfile +34 -0
  102. package/dist/src/templates/agno/README.md +36 -0
  103. package/dist/src/templates/agno/agent.py +86 -0
  104. package/dist/src/templates/agno/entrypoint.sh +34 -0
  105. package/dist/src/templates/agno/requirements.txt +2 -0
  106. package/dist/src/templates/agno/template.yaml +24 -0
  107. package/dist/src/templates/coder/Dockerfile +34 -0
  108. package/dist/src/templates/coder/README.md +36 -0
  109. package/dist/src/templates/coder/agent.py +119 -0
  110. package/dist/src/templates/coder/entrypoint.sh +34 -0
  111. package/dist/src/templates/coder/requirements.txt +4 -0
  112. package/dist/src/templates/coder/template.yaml +24 -0
  113. package/dist/src/templates/crewai/Dockerfile +34 -0
  114. package/dist/src/templates/crewai/README.md +29 -0
  115. package/dist/src/templates/crewai/agent.py +109 -0
  116. package/dist/src/templates/crewai/entrypoint.sh +34 -0
  117. package/dist/src/templates/crewai/requirements.txt +3 -0
  118. package/dist/src/templates/crewai/template.yaml +24 -0
  119. package/dist/src/templates/elizaos/Dockerfile +31 -0
  120. package/dist/src/templates/elizaos/README.md +36 -0
  121. package/dist/src/templates/elizaos/agent.ts +100 -0
  122. package/dist/src/templates/elizaos/entrypoint.sh +34 -0
  123. package/dist/src/templates/elizaos/package.json +18 -0
  124. package/dist/src/templates/elizaos/template.yaml +25 -0
  125. package/dist/src/templates/elizaos/tsconfig.json +12 -0
  126. package/dist/src/templates/fetcher.d.ts.map +1 -1
  127. package/dist/src/templates/fetcher.js +34 -15
  128. package/dist/src/templates/fetcher.js.map +1 -1
  129. package/dist/src/templates/langchain/Dockerfile +34 -0
  130. package/dist/src/templates/langchain/README.md +37 -0
  131. package/dist/src/templates/langchain/agent.py +115 -0
  132. package/dist/src/templates/langchain/entrypoint.sh +36 -0
  133. package/dist/src/templates/langchain/requirements.txt +4 -0
  134. package/dist/src/templates/langchain/template.yaml +24 -0
  135. package/dist/src/templates/llamaindex/Dockerfile +34 -0
  136. package/dist/src/templates/llamaindex/README.md +36 -0
  137. package/dist/src/templates/llamaindex/agent.py +97 -0
  138. package/dist/src/templates/llamaindex/entrypoint.sh +34 -0
  139. package/dist/src/templates/llamaindex/requirements.txt +3 -0
  140. package/dist/src/templates/llamaindex/template.yaml +24 -0
  141. package/dist/src/templates/mastra/Dockerfile +31 -0
  142. package/dist/src/templates/mastra/README.md +31 -0
  143. package/dist/src/templates/mastra/agent.ts +112 -0
  144. package/dist/src/templates/mastra/entrypoint.sh +34 -0
  145. package/dist/src/templates/mastra/package.json +17 -0
  146. package/dist/src/templates/mastra/template.yaml +25 -0
  147. package/dist/src/templates/mastra/tsconfig.json +12 -0
  148. package/dist/src/templates/openai-agents/Dockerfile +34 -0
  149. package/dist/src/templates/openai-agents/README.md +29 -0
  150. package/dist/src/templates/openai-agents/agent.py +98 -0
  151. package/dist/src/templates/openai-agents/entrypoint.sh +34 -0
  152. package/dist/src/templates/openai-agents/requirements.txt +3 -0
  153. package/dist/src/templates/openai-agents/template.yaml +24 -0
  154. package/dist/src/templates/pydantic-ai/Dockerfile +34 -0
  155. package/dist/src/templates/pydantic-ai/README.md +36 -0
  156. package/dist/src/templates/pydantic-ai/agent.py +110 -0
  157. package/dist/src/templates/pydantic-ai/entrypoint.sh +34 -0
  158. package/dist/src/templates/pydantic-ai/requirements.txt +2 -0
  159. package/dist/src/templates/pydantic-ai/template.yaml +24 -0
  160. package/dist/src/templates/smolagents/Dockerfile +34 -0
  161. package/dist/src/templates/smolagents/README.md +36 -0
  162. package/dist/src/templates/smolagents/agent.py +97 -0
  163. package/dist/src/templates/smolagents/entrypoint.sh +34 -0
  164. package/dist/src/templates/smolagents/requirements.txt +2 -0
  165. package/dist/src/templates/smolagents/template.yaml +24 -0
  166. package/dist/src/templates/typescript-sdk/Dockerfile +31 -0
  167. package/dist/src/templates/typescript-sdk/README.md +29 -0
  168. package/dist/src/templates/typescript-sdk/agent.ts +130 -0
  169. package/dist/src/templates/typescript-sdk/entrypoint.sh +34 -0
  170. package/dist/src/templates/typescript-sdk/package.json +17 -0
  171. package/dist/src/templates/typescript-sdk/template.yaml +25 -0
  172. package/dist/src/templates/typescript-sdk/tsconfig.json +12 -0
  173. package/package.json +1 -1
@@ -0,0 +1,110 @@
1
+ """
2
+ Pydantic AI agent pre-wired with 1Claw MCP for secrets and signing.
3
+
4
+ LLM calls are routed through Shroud when ONECLAW_LLM_VIA_SHROUD is set.
5
+ The container never sees raw API keys — they are injected by the host daemon.
6
+ """
7
+
8
+ import os
9
+ import asyncio
10
+ from dataclasses import dataclass
11
+ from flask import Flask, request, jsonify
12
+ from pydantic_ai import Agent, RunContext
13
+ from pydantic_ai.models.openai import OpenAIModel
14
+ from pydantic_ai.providers.openai import OpenAIProvider
15
+
16
+ app = Flask(__name__)
17
+
18
+ SHROUD_URL = os.environ.get("ONECLAW_SHROUD_URL", "https://shroud.1claw.xyz")
19
+ LLM_VIA_SHROUD = os.environ.get("ONECLAW_LLM_VIA_SHROUD", "").lower() == "true"
20
+ MODEL = os.environ.get("ONECLAW_SHROUD_MODEL", "gpt-4o-mini")
21
+
22
+
23
+ @dataclass
24
+ class AgentDeps:
25
+ agent_id: str
26
+
27
+
28
+ def create_agent() -> Agent | None:
29
+ """Build the Pydantic AI agent. Returns None if no LLM."""
30
+ if not LLM_VIA_SHROUD:
31
+ return None
32
+
33
+ model = OpenAIModel(
34
+ MODEL,
35
+ provider=OpenAIProvider(
36
+ base_url=f"{SHROUD_URL}/v1",
37
+ api_key="shroud-injected",
38
+ ),
39
+ )
40
+
41
+ pydantic_agent = Agent(
42
+ model,
43
+ system_prompt=(
44
+ "You are a helpful AI agent running inside a secure 1Claw container. "
45
+ "You have access to tools for greeting and inspecting the environment."
46
+ ),
47
+ deps_type=AgentDeps,
48
+ )
49
+
50
+ @pydantic_agent.tool
51
+ async def hello_world(ctx: RunContext[AgentDeps], name: str) -> str:
52
+ """Say hello to someone."""
53
+ return f"Hello, {name}! I'm a Pydantic AI agent (agent: {ctx.deps.agent_id})."
54
+
55
+ @pydantic_agent.tool
56
+ async def list_env_vars(ctx: RunContext[AgentDeps]) -> str:
57
+ """List 1Claw-related environment variables (values redacted)."""
58
+ prefix = "ONECLAW_"
59
+ vars_list = [k for k in sorted(os.environ) if k.startswith(prefix)]
60
+ return "\n".join(f" {k}=***" for k in vars_list) if vars_list else "No ONECLAW_* vars set."
61
+
62
+ return pydantic_agent
63
+
64
+
65
+ agent = create_agent()
66
+
67
+
68
+ @app.route("/health")
69
+ def health():
70
+ return jsonify({"status": "ok", "framework": "pydantic-ai", "llm_wired": LLM_VIA_SHROUD})
71
+
72
+
73
+ @app.route("/chat", methods=["POST"])
74
+ def chat():
75
+ data = request.get_json(silent=True) or {}
76
+ message = data.get("message", "").strip()
77
+ if not message:
78
+ return jsonify({"error": "No message provided"}), 400
79
+
80
+ if not agent:
81
+ return jsonify({
82
+ "response": "No LLM configured. Use --llm-api-key or enable Token Billing.",
83
+ "framework": "pydantic-ai",
84
+ })
85
+
86
+ try:
87
+ deps = AgentDeps(agent_id=os.environ.get("ONECLAW_AGENT_ID", "unknown"))
88
+ result = asyncio.run(agent.run(message, deps=deps))
89
+ return jsonify({"response": result.output, "framework": "pydantic-ai"})
90
+ except Exception as e:
91
+ return jsonify({"error": str(e)}), 500
92
+
93
+
94
+ @app.route("/")
95
+ def index():
96
+ return """<!DOCTYPE html>
97
+ <html><head><title>1Claw Pydantic AI Agent</title></head>
98
+ <body style="font-family:system-ui;max-width:600px;margin:40px auto;padding:0 20px">
99
+ <h1>1Claw Pydantic AI Agent</h1>
100
+ <p>Send messages via <code>POST /chat</code> with <code>{"message": "..."}</code></p>
101
+ <p>Health: <a href="/health">/health</a></p>
102
+ <p style="color:#666;font-size:0.9em">
103
+ Credentials stay in the host daemon — this container never sees secret values.
104
+ </p></body></html>"""
105
+
106
+
107
+ if __name__ == "__main__":
108
+ port = int(os.environ.get("CHAT_UI_PORT", "3000"))
109
+ print(f"Pydantic AI agent listening on http://0.0.0.0:{port}")
110
+ app.run(host="0.0.0.0", port=port)
@@ -0,0 +1,34 @@
1
+ #!/bin/sh
2
+ set -e
3
+
4
+ DAEMON_SOCKET="${ONECLAW_DAEMON_SOCKET:-/run/1claw/daemon.sock}"
5
+ CHAT_UI_PORT="${CHAT_UI_PORT:-3000}"
6
+
7
+ echo "─────────────────────────────────────────────"
8
+ echo " 1Claw Pydantic AI Agent"
9
+ echo " Framework: pydantic-ai"
10
+ echo " Agent ID: ${ONECLAW_AGENT_ID:-not set}"
11
+
12
+ if [ -S "$DAEMON_SOCKET" ]; then
13
+ echo " Mode: ${ONECLAW_MODE:-cloud} (daemon socket)"
14
+ echo " Socket: $DAEMON_SOCKET"
15
+ else
16
+ echo " Mode: standalone (no daemon socket)"
17
+ fi
18
+ echo "─────────────────────────────────────────────"
19
+
20
+ if [ "$ONECLAW_LLM_VIA_SHROUD" = "true" ]; then
21
+ export OPENAI_BASE_URL="${ONECLAW_SHROUD_URL}/v1"
22
+ echo "LLM routed through Shroud: ${ONECLAW_SHROUD_PROVIDER}/${ONECLAW_SHROUD_MODEL}"
23
+ fi
24
+
25
+ if [ -S "$DAEMON_SOCKET" ]; then
26
+ if command -v 1claw-mcp >/dev/null 2>&1; then
27
+ ONECLAW_LOCAL_VAULT=true ONECLAW_DAEMON_SOCKET="$DAEMON_SOCKET" \
28
+ 1claw-mcp --local 2>/tmp/mcp.log &
29
+ echo "MCP server started in background."
30
+ fi
31
+ fi
32
+
33
+ echo "Ready: http://0.0.0.0:${CHAT_UI_PORT}"
34
+ exec python agent.py
@@ -0,0 +1,2 @@
1
+ pydantic-ai>=0.2.0
2
+ flask>=3.0.0
@@ -0,0 +1,24 @@
1
+ name: pydantic-ai
2
+ display_name: "Pydantic AI"
3
+ version: 1.0.0
4
+ description: "Type-safe Python agent with structured output"
5
+ author: 1Claw
6
+ language: python
7
+ homepage: https://ai.pydantic.dev
8
+
9
+ docker:
10
+ base_image: python:3.12-slim
11
+ context_files:
12
+ - Dockerfile
13
+ - requirements.txt
14
+ - agent.py
15
+ - entrypoint.sh
16
+ env:
17
+ ONECLAW_FRAMEWORK: pydantic-ai
18
+ health_endpoint: /health
19
+ health_port: 3000
20
+
21
+ post_spawn_message: |
22
+ Edit agent.py to define your typed tools and result models.
23
+ Your 1Claw MCP server is available at the daemon socket.
24
+ LLM calls are routed through Shroud for inspection and redaction.
@@ -0,0 +1,34 @@
1
+ FROM python:3.12-slim
2
+
3
+ RUN apt-get update && apt-get install -y --no-install-recommends \
4
+ curl tini && \
5
+ rm -rf /var/lib/apt/lists/*
6
+
7
+ WORKDIR /app
8
+
9
+ COPY requirements.txt .
10
+ RUN pip install --no-cache-dir -r requirements.txt
11
+
12
+ RUN pip install --no-cache-dir 1claw-mcp 2>/dev/null || \
13
+ (apt-get update && apt-get install -y --no-install-recommends nodejs npm && \
14
+ npm install -g @1claw/mcp@latest && \
15
+ rm -rf /var/lib/apt/lists/*) || \
16
+ echo "WARN: 1claw-mcp install deferred to runtime"
17
+
18
+ COPY agent.py .
19
+ COPY entrypoint.sh .
20
+ RUN chmod +x entrypoint.sh
21
+
22
+ RUN mkdir -p /run/1claw
23
+
24
+ ENV NODE_ENV=production
25
+ ENV ONECLAW_DAEMON_SOCKET=/run/1claw/daemon.sock
26
+ ENV ONECLAW_FRAMEWORK=smolagents
27
+
28
+ EXPOSE 3000
29
+
30
+ HEALTHCHECK --interval=10s --timeout=3s --start-period=10s --retries=5 \
31
+ CMD curl -sf http://localhost:3000/health || exit 1
32
+
33
+ ENTRYPOINT ["tini", "--"]
34
+ CMD ["./entrypoint.sh"]
@@ -0,0 +1,36 @@
1
+ # HuggingFace smolagents Template
2
+
3
+ A Python agent using [smolagents](https://huggingface.co/docs/smolagents) — HuggingFace's lightweight agent framework — with 1Claw MCP for secrets management.
4
+
5
+ ## Quick start
6
+
7
+ ```bash
8
+ 1claw spawn smolagents
9
+ ```
10
+
11
+ Or with your own API key:
12
+
13
+ ```bash
14
+ 1claw spawn smolagents --llm-api-key sk-...
15
+ ```
16
+
17
+ ## What's included
18
+
19
+ - **agent.py** — CodeAgent with example tools (hello_world, list_env_vars)
20
+ - **Flask server** on port 3000 with `/chat` and `/health` endpoints
21
+ - **Shroud integration** — LLM calls are routed through Shroud for inspection
22
+ - **MCP server** — started automatically for tool access to 1Claw vault
23
+
24
+ ## Customizing
25
+
26
+ Edit `agent.py` to add custom tools, switch to `ToolCallingAgent`, or
27
+ use HuggingFace Hub models directly. smolagents supports both code-based
28
+ and tool-calling agent patterns.
29
+
30
+ ## LLM authentication
31
+
32
+ The template supports three methods (configured at spawn time):
33
+
34
+ 1. **BYOK** — `1claw spawn smolagents --llm-api-key sk-...`
35
+ 2. **Token Billing** — enable in Dashboard, no key needed
36
+ 3. **Anthropic WIF** — OIDC federation for Anthropic models
@@ -0,0 +1,97 @@
1
+ """
2
+ HuggingFace smolagents agent pre-wired with 1Claw MCP for secrets and signing.
3
+
4
+ LLM calls are routed through Shroud when ONECLAW_LLM_VIA_SHROUD is set.
5
+ The container never sees raw API keys — they are injected by the host daemon.
6
+ """
7
+
8
+ import os
9
+ from flask import Flask, request, jsonify
10
+ from smolagents import CodeAgent, tool, OpenAIServerModel
11
+
12
+ app = Flask(__name__)
13
+
14
+ SHROUD_URL = os.environ.get("ONECLAW_SHROUD_URL", "https://shroud.1claw.xyz")
15
+ LLM_VIA_SHROUD = os.environ.get("ONECLAW_LLM_VIA_SHROUD", "").lower() == "true"
16
+ MODEL = os.environ.get("ONECLAW_SHROUD_MODEL", "gpt-4o-mini")
17
+
18
+
19
+ @tool
20
+ def hello_world(name: str) -> str:
21
+ """Say hello to someone.
22
+ Args:
23
+ name: the person to greet
24
+ """
25
+ return f"Hello, {name}! I'm a smolagents agent running inside 1Claw."
26
+
27
+
28
+ @tool
29
+ def list_env_vars() -> str:
30
+ """List 1Claw-related environment variables (values redacted)."""
31
+ prefix = "ONECLAW_"
32
+ vars_list = [k for k in sorted(os.environ) if k.startswith(prefix)]
33
+ return "\n".join(f" {k}=***" for k in vars_list) if vars_list else "No ONECLAW_* vars set."
34
+
35
+
36
+ def create_agent():
37
+ """Build the smolagents CodeAgent. Returns None if no LLM."""
38
+ if not LLM_VIA_SHROUD:
39
+ return None
40
+
41
+ model = OpenAIServerModel(
42
+ model_id=MODEL,
43
+ api_base=f"{SHROUD_URL}/v1",
44
+ api_key="shroud-injected",
45
+ )
46
+
47
+ return CodeAgent(
48
+ tools=[hello_world, list_env_vars],
49
+ model=model,
50
+ )
51
+
52
+
53
+ agent = create_agent()
54
+
55
+
56
+ @app.route("/health")
57
+ def health():
58
+ return jsonify({"status": "ok", "framework": "smolagents", "llm_wired": LLM_VIA_SHROUD})
59
+
60
+
61
+ @app.route("/chat", methods=["POST"])
62
+ def chat():
63
+ data = request.get_json(silent=True) or {}
64
+ message = data.get("message", "").strip()
65
+ if not message:
66
+ return jsonify({"error": "No message provided"}), 400
67
+
68
+ if not agent:
69
+ return jsonify({
70
+ "response": "No LLM configured. Use --llm-api-key or enable Token Billing.",
71
+ "framework": "smolagents",
72
+ })
73
+
74
+ try:
75
+ result = agent.run(message)
76
+ return jsonify({"response": str(result), "framework": "smolagents"})
77
+ except Exception as e:
78
+ return jsonify({"error": str(e)}), 500
79
+
80
+
81
+ @app.route("/")
82
+ def index():
83
+ return """<!DOCTYPE html>
84
+ <html><head><title>1Claw smolagents Agent</title></head>
85
+ <body style="font-family:system-ui;max-width:600px;margin:40px auto;padding:0 20px">
86
+ <h1>1Claw HuggingFace smolagents</h1>
87
+ <p>Send messages via <code>POST /chat</code> with <code>{"message": "..."}</code></p>
88
+ <p>Health: <a href="/health">/health</a></p>
89
+ <p style="color:#666;font-size:0.9em">
90
+ Credentials stay in the host daemon — this container never sees secret values.
91
+ </p></body></html>"""
92
+
93
+
94
+ if __name__ == "__main__":
95
+ port = int(os.environ.get("CHAT_UI_PORT", "3000"))
96
+ print(f"smolagents agent listening on http://0.0.0.0:{port}")
97
+ app.run(host="0.0.0.0", port=port)
@@ -0,0 +1,34 @@
1
+ #!/bin/sh
2
+ set -e
3
+
4
+ DAEMON_SOCKET="${ONECLAW_DAEMON_SOCKET:-/run/1claw/daemon.sock}"
5
+ CHAT_UI_PORT="${CHAT_UI_PORT:-3000}"
6
+
7
+ echo "─────────────────────────────────────────────"
8
+ echo " 1Claw smolagents Agent"
9
+ echo " Framework: smolagents"
10
+ echo " Agent ID: ${ONECLAW_AGENT_ID:-not set}"
11
+
12
+ if [ -S "$DAEMON_SOCKET" ]; then
13
+ echo " Mode: ${ONECLAW_MODE:-cloud} (daemon socket)"
14
+ echo " Socket: $DAEMON_SOCKET"
15
+ else
16
+ echo " Mode: standalone (no daemon socket)"
17
+ fi
18
+ echo "─────────────────────────────────────────────"
19
+
20
+ if [ "$ONECLAW_LLM_VIA_SHROUD" = "true" ]; then
21
+ export OPENAI_BASE_URL="${ONECLAW_SHROUD_URL}/v1"
22
+ echo "LLM routed through Shroud: ${ONECLAW_SHROUD_PROVIDER}/${ONECLAW_SHROUD_MODEL}"
23
+ fi
24
+
25
+ if [ -S "$DAEMON_SOCKET" ]; then
26
+ if command -v 1claw-mcp >/dev/null 2>&1; then
27
+ ONECLAW_LOCAL_VAULT=true ONECLAW_DAEMON_SOCKET="$DAEMON_SOCKET" \
28
+ 1claw-mcp --local 2>/tmp/mcp.log &
29
+ echo "MCP server started in background."
30
+ fi
31
+ fi
32
+
33
+ echo "Ready: http://0.0.0.0:${CHAT_UI_PORT}"
34
+ exec python agent.py
@@ -0,0 +1,2 @@
1
+ smolagents>=1.0.0
2
+ flask>=3.0.0
@@ -0,0 +1,24 @@
1
+ name: smolagents
2
+ display_name: "HuggingFace smolagents"
3
+ version: 1.0.0
4
+ description: "HuggingFace lightweight agents with 1Claw secrets"
5
+ author: 1Claw
6
+ language: python
7
+ homepage: https://huggingface.co/docs/smolagents
8
+
9
+ docker:
10
+ base_image: python:3.12-slim
11
+ context_files:
12
+ - Dockerfile
13
+ - requirements.txt
14
+ - agent.py
15
+ - entrypoint.sh
16
+ env:
17
+ ONECLAW_FRAMEWORK: smolagents
18
+ health_endpoint: /health
19
+ health_port: 3000
20
+
21
+ post_spawn_message: |
22
+ Edit agent.py to add custom tools and change the agent type.
23
+ Your 1Claw MCP server is available at the daemon socket.
24
+ LLM calls are routed through Shroud for inspection and redaction.
@@ -0,0 +1,31 @@
1
+ FROM node:22-slim
2
+
3
+ RUN apt-get update && apt-get install -y --no-install-recommends \
4
+ curl tini && \
5
+ rm -rf /var/lib/apt/lists/*
6
+
7
+ WORKDIR /app
8
+
9
+ COPY package.json tsconfig.json ./
10
+ RUN npm install --omit=dev 2>/dev/null || npm install
11
+
12
+ RUN npm install -g @1claw/mcp@latest 2>/dev/null || \
13
+ echo "WARN: @1claw/mcp install deferred to runtime"
14
+
15
+ COPY agent.ts .
16
+ COPY entrypoint.sh .
17
+ RUN chmod +x entrypoint.sh
18
+
19
+ RUN mkdir -p /run/1claw
20
+
21
+ ENV NODE_ENV=production
22
+ ENV ONECLAW_DAEMON_SOCKET=/run/1claw/daemon.sock
23
+ ENV ONECLAW_FRAMEWORK=typescript-sdk
24
+
25
+ EXPOSE 3000
26
+
27
+ HEALTHCHECK --interval=10s --timeout=3s --start-period=10s --retries=5 \
28
+ CMD curl -sf http://localhost:3000/health || exit 1
29
+
30
+ ENTRYPOINT ["tini", "--"]
31
+ CMD ["./entrypoint.sh"]
@@ -0,0 +1,29 @@
1
+ # 1Claw TypeScript SDK Agent Template
2
+
3
+ Plain TypeScript agent using [@1claw/sdk](https://www.npmjs.com/package/@1claw/sdk) for vault access, multi-chain signing, and Vercel AI SDK for LLM interaction through Shroud.
4
+
5
+ ## Quick start
6
+
7
+ ```bash
8
+ 1claw spawn typescript-sdk --agent-key ocv_YOUR_KEY
9
+ ```
10
+
11
+ ## What's included
12
+
13
+ - `agent.ts` — TypeScript agent with `@1claw/sdk` client, AI SDK tool calling, and `/chat` + `/health` endpoints
14
+ - `Dockerfile` — Node 22 slim image with `@1claw/mcp` for vault access
15
+ - `entrypoint.sh` — Daemon socket detection, Shroud wiring, MCP server startup
16
+
17
+ ## LLM authentication
18
+
19
+ ```bash
20
+ # Bring your own key (stored in vault, routed through Shroud)
21
+ 1claw spawn typescript-sdk --agent-key ocv_YOUR_KEY --llm-api-key sk-...
22
+
23
+ # Use 1Claw Token Billing (no provider key needed)
24
+ 1claw spawn typescript-sdk --agent-key ocv_YOUR_KEY
25
+ ```
26
+
27
+ ## Customization
28
+
29
+ Edit `agent.ts` to add tools, integrate with your own services, or use additional @1claw/sdk features like `signIntent()`, `submitTransaction()`, or `leaseBankrKey()`.
@@ -0,0 +1,130 @@
1
+ /**
2
+ * Plain TypeScript agent using @1claw/sdk for vault access and signing,
3
+ * with Vercel AI SDK for LLM interaction through Shroud.
4
+ *
5
+ * LLM calls are routed through Shroud when ONECLAW_LLM_VIA_SHROUD is set.
6
+ * The container never sees raw API keys — they are injected by the host daemon.
7
+ */
8
+
9
+ import { createServer } from "node:http";
10
+ import { OneclawClient } from "@1claw/sdk";
11
+ import { createOpenAI } from "@ai-sdk/openai";
12
+ import { generateText, tool } from "ai";
13
+ import { z } from "zod";
14
+
15
+ const SHROUD_URL = process.env.ONECLAW_SHROUD_URL ?? "https://shroud.1claw.xyz";
16
+ const LLM_VIA_SHROUD = process.env.ONECLAW_LLM_VIA_SHROUD === "true";
17
+ const MODEL = process.env.ONECLAW_SHROUD_MODEL ?? "gpt-4o-mini";
18
+ const PORT = parseInt(process.env.CHAT_UI_PORT ?? "3000", 10);
19
+
20
+ const conversationHistory: { role: "user" | "assistant"; content: string }[] = [];
21
+
22
+ const claw = new OneclawClient({
23
+ apiKey: process.env.ONECLAW_AGENT_API_KEY,
24
+ agentId: process.env.ONECLAW_AGENT_ID,
25
+ baseUrl: process.env.ONECLAW_BASE_URL ?? "https://api.1claw.xyz",
26
+ });
27
+
28
+ const openai = LLM_VIA_SHROUD
29
+ ? createOpenAI({ baseURL: `${SHROUD_URL}/v1`, apiKey: "shroud-injected" })
30
+ : null;
31
+
32
+ const listSecretsTool = tool({
33
+ description: "List secrets in the 1Claw vault (names only, no values)",
34
+ parameters: z.object({ prefix: z.string().optional().describe("Path prefix filter") }),
35
+ execute: async ({ prefix }) => {
36
+ try {
37
+ const vaultId = process.env.ONECLAW_VAULT_ID;
38
+ if (!vaultId) return "No vault configured.";
39
+ const resp = await claw.secrets.list(vaultId, prefix);
40
+ const secrets = (resp as any).data?.secrets ?? [];
41
+ return secrets.length
42
+ ? secrets.map((s: any) => ` ${s.path} (${s.type ?? "generic"})`).join("\n")
43
+ : "No secrets found.";
44
+ } catch (e: any) {
45
+ return `Error: ${e.message}`;
46
+ }
47
+ },
48
+ });
49
+
50
+ const envTool = tool({
51
+ description: "List 1Claw-related environment variables (values redacted)",
52
+ parameters: z.object({}),
53
+ execute: async () => {
54
+ const vars = Object.keys(process.env)
55
+ .filter((k) => k.startsWith("ONECLAW_"))
56
+ .sort()
57
+ .map((k) => ` ${k}=***`);
58
+ return vars.length ? vars.join("\n") : "No ONECLAW_* vars set.";
59
+ },
60
+ });
61
+
62
+ async function handleChat(message: string): Promise<string> {
63
+ if (!openai) {
64
+ return "No LLM configured. Use --llm-api-key or enable Token Billing.";
65
+ }
66
+
67
+ conversationHistory.push({ role: "user", content: message });
68
+
69
+ const { text } = await generateText({
70
+ model: openai(MODEL),
71
+ system:
72
+ "You are a helpful AI agent running inside a secure 1Claw container. " +
73
+ "You have access to the 1Claw SDK for vault secrets and multi-chain signing. " +
74
+ "Be helpful and concise.",
75
+ messages: conversationHistory,
76
+ tools: { listSecrets: listSecretsTool, env: envTool },
77
+ });
78
+
79
+ conversationHistory.push({ role: "assistant", content: text });
80
+ return text;
81
+ }
82
+
83
+ const server = createServer(async (req, res) => {
84
+ if (req.url === "/health" && req.method === "GET") {
85
+ res.writeHead(200, { "Content-Type": "application/json" });
86
+ res.end(
87
+ JSON.stringify({ status: "ok", framework: "typescript-sdk", llm_wired: LLM_VIA_SHROUD }),
88
+ );
89
+ return;
90
+ }
91
+
92
+ if (req.url === "/chat" && req.method === "POST") {
93
+ const chunks: Buffer[] = [];
94
+ for await (const chunk of req) chunks.push(chunk as Buffer);
95
+ const body = JSON.parse(Buffer.concat(chunks).toString());
96
+ const message = (body.message ?? "").trim();
97
+
98
+ if (!message) {
99
+ res.writeHead(400, { "Content-Type": "application/json" });
100
+ res.end(JSON.stringify({ error: "No message provided" }));
101
+ return;
102
+ }
103
+
104
+ try {
105
+ const response = await handleChat(message);
106
+ res.writeHead(200, { "Content-Type": "application/json" });
107
+ res.end(JSON.stringify({ response, framework: "typescript-sdk" }));
108
+ } catch (e: any) {
109
+ res.writeHead(500, { "Content-Type": "application/json" });
110
+ res.end(JSON.stringify({ error: e.message }));
111
+ }
112
+ return;
113
+ }
114
+
115
+ res.writeHead(200, { "Content-Type": "text/html" });
116
+ res.end(`<!DOCTYPE html>
117
+ <html><head><title>1Claw TypeScript Agent</title></head>
118
+ <body style="font-family:system-ui;max-width:600px;margin:40px auto;padding:0 20px">
119
+ <h1>1Claw TypeScript Agent</h1>
120
+ <p>Send messages via <code>POST /chat</code> with <code>{"message": "..."}</code></p>
121
+ <p>Health: <a href="/health">/health</a></p>
122
+ <p style="color:#666;font-size:0.9em">
123
+ Uses @1claw/sdk for vault access and multi-chain signing.
124
+ Credentials stay in the host daemon — this container never sees secret values.
125
+ </p></body></html>`);
126
+ });
127
+
128
+ server.listen(PORT, "0.0.0.0", () => {
129
+ console.log(`TypeScript SDK agent listening on http://0.0.0.0:${PORT}`);
130
+ });
@@ -0,0 +1,34 @@
1
+ #!/bin/sh
2
+ set -e
3
+
4
+ DAEMON_SOCKET="${ONECLAW_DAEMON_SOCKET:-/run/1claw/daemon.sock}"
5
+ CHAT_UI_PORT="${CHAT_UI_PORT:-3000}"
6
+
7
+ echo "─────────────────────────────────────────────"
8
+ echo " 1Claw TypeScript SDK Agent"
9
+ echo " Framework: @1claw/sdk (TypeScript)"
10
+ echo " Agent ID: ${ONECLAW_AGENT_ID:-not set}"
11
+
12
+ if [ -S "$DAEMON_SOCKET" ]; then
13
+ echo " Mode: ${ONECLAW_MODE:-cloud} (daemon socket)"
14
+ echo " Socket: $DAEMON_SOCKET"
15
+ else
16
+ echo " Mode: standalone (no daemon socket)"
17
+ fi
18
+ echo "─────────────────────────────────────────────"
19
+
20
+ if [ "$ONECLAW_LLM_VIA_SHROUD" = "true" ]; then
21
+ export OPENAI_BASE_URL="${ONECLAW_SHROUD_URL}/v1"
22
+ echo "LLM routed through Shroud: ${ONECLAW_SHROUD_PROVIDER}/${ONECLAW_SHROUD_MODEL}"
23
+ fi
24
+
25
+ if [ -S "$DAEMON_SOCKET" ]; then
26
+ if command -v 1claw-mcp >/dev/null 2>&1; then
27
+ ONECLAW_LOCAL_VAULT=true ONECLAW_DAEMON_SOCKET="$DAEMON_SOCKET" \
28
+ 1claw-mcp --local 2>/tmp/mcp.log &
29
+ echo "MCP server started in background."
30
+ fi
31
+ fi
32
+
33
+ echo "Ready: http://0.0.0.0:${CHAT_UI_PORT}"
34
+ exec npx tsx agent.ts
@@ -0,0 +1,17 @@
1
+ {
2
+ "name": "1claw-typescript-agent",
3
+ "version": "1.0.0",
4
+ "private": true,
5
+ "type": "module",
6
+ "scripts": {
7
+ "start": "tsx agent.ts",
8
+ "dev": "tsx watch agent.ts"
9
+ },
10
+ "dependencies": {
11
+ "@1claw/sdk": "latest",
12
+ "@ai-sdk/openai": "^1.0.0",
13
+ "ai": "^4.0.0",
14
+ "tsx": "^4.19.0",
15
+ "typescript": "^5.7.0"
16
+ }
17
+ }
@@ -0,0 +1,25 @@
1
+ name: typescript-sdk
2
+ display_name: "TypeScript SDK"
3
+ version: 1.0.0
4
+ description: "Plain TypeScript agent using @1claw/sdk with Shroud LLM routing"
5
+ author: 1Claw
6
+ language: node
7
+ homepage: https://docs.1claw.xyz
8
+
9
+ docker:
10
+ base_image: node:22-slim
11
+ context_files:
12
+ - Dockerfile
13
+ - package.json
14
+ - tsconfig.json
15
+ - agent.ts
16
+ - entrypoint.sh
17
+ env:
18
+ ONECLAW_FRAMEWORK: typescript-sdk
19
+ health_endpoint: /health
20
+ health_port: 3000
21
+
22
+ post_spawn_message: |
23
+ Edit agent.ts to customize your TypeScript agent.
24
+ The @1claw/sdk client is pre-configured for vault access and signing.
25
+ LLM calls are routed through Shroud for inspection and redaction.