agentram 0.1.2 → 0.1.3

package/README.md

@@ -170,7 +170,7 @@ Run TUI:
 agentram tui
 ```
 
-Supported TUI slash commands:
+Supported TUI slash commands. Plain text only records/retrieves RAM; use `/ask` to call bound models:
 
 ```text
 /help
@@ -385,12 +385,13 @@ agentram_build_coding_orchestration
 agentram_run_coding_orchestration
 ```
 
-TUI slash commands:
+TUI slash commands. Plain text only records/retrieves RAM; use `/ask` to call bound models:
 
 ```text
 /bind-model claude claude-3-5-sonnet-latest role=reviewer api_key_env=ANTHROPIC_API_KEY
 /models
 /orchestrate review CLI orchestration
+/ask xin chào
 ```
 
 Storage:
@@ -844,3 +845,28 @@ Use `.env.example` as the shareable template.
 - Model-based ingestion is best run through daemon/wrapper configuration.
 - Wrapper CLI records command-level events, not deep internal agent tool events.
 - Rich file/tool hooks need direct agent hooks or disciplined MCP calls.
+
+
+### Why TUI May Not Respond Like A Model
+
+Plain text in `agentram tui` records a user message and retrieves RAM context. It does not call paid/local models by default. To get a model response:
+
+1. Put the real API key in an environment variable.
+2. Bind the model using the env var name, not the raw key.
+3. Use `/ask` or `agentram orchestrate --execute`.
+
+Example:
+
+```bash
+set OPENAI_API_KEY=sk-your-key
+agentram tui
+```
+
+Inside TUI:
+
+```text
+/bind-model openai-compatible Agentic --role coder --base-url http://localhost:8000/v1 --api-key-env OPENAI_API_KEY
+/ask xin chào
+```
+
+Do not paste raw API keys into `/bind-model`. `api_key_env` means environment variable name, e.g. `OPENAI_API_KEY`.

package/agentram/cli.py

@@ -33,6 +33,7 @@ SLASH_HELP = """Slash commands:
 /models                       List bound coding models
 /bind-model provider model    Bind model endpoint
 /orchestrate <task>           Build multi-model agent plan
+/ask <prompt>                 Execute bound models and return outputs
 /claude-install [path]        Install .claude commands and agents
 /note <text>                  Save decision note
 /clear                        Clear chat
@@ -213,15 +214,14 @@ def handle_slash_command(context: McpContext, text: str, messages: list[str] | N
         return models_text(context)
     if command == "/bind-model":
         if len(rest) < 2:
-            return "Usage: /bind-model <provider> <model> [role=coder] [base_url=...] [api_key_env=...] [modalities=text,image]"
-        options = {"provider": rest[0], "model": rest[1]}
-        for item in rest[2:]:
-            if "=" in item:
-                key, value = item.split("=", 1)
-                options[key.replace("-", "_")] = value
-        return bind_model_text(context, options)
+            return "Usage: /bind-model <provider> <model> [--role coder] [--base-url URL] [--api-key-env ENV_NAME]"
+        return bind_model_text(context, parse_bind_model_args(rest))
     if command == "/orchestrate":
-        return orchestrate_text(context, raw_rest, execute=False)
+        execute = "--execute" in rest
+        task = raw_rest.replace("--execute", "").strip()
+        return orchestrate_text(context, task, execute=execute)
+    if command == "/ask":
+        return orchestrate_text(context, raw_rest, execute=True)
     if command == "/agent":
         if not rest:
             return "Usage: /agent <memory|planner|reviewer|documenter> <task>"
@@ -350,7 +350,32 @@ def models_text(context: McpContext) -> str:
     return "\n".join(lines)
 
 
+def parse_bind_model_args(parts: list[str]) -> dict[str, object]:
+    options: dict[str, object] = {"provider": parts[0], "model": parts[1]}
+    index = 2
+    while index < len(parts):
+        item = parts[index]
+        if item.startswith("--"):
+            key = item[2:].replace("-", "_")
+            if index + 1 < len(parts) and not parts[index + 1].startswith("--"):
+                options[key] = parts[index + 1]
+                index += 2
+            else:
+                options[key] = True
+                index += 1
+        elif "=" in item:
+            key, value = item.split("=", 1)
+            options[key.replace("-", "_")] = value
+            index += 1
+        else:
+            index += 1
+    return options
+
+
 def bind_model_text(context: McpContext, options: dict[str, object]) -> str:
+    api_key_env = str(options.get("api_key_env", ""))
+    if api_key_env.startswith(("sk-", "gsk_", "sk_")):
+        return "Do not paste raw API key into api_key_env. Set env var first, e.g. OPENAI_API_KEY=sk-..., then use api_key_env=OPENAI_API_KEY."
     modalities_value = str(options.get("modalities", "text"))
     arguments = {
         "id": str(options.get("id", "")) or None,
@@ -505,6 +530,7 @@ def sidebar_lines(context: McpContext) -> list[str]:
         "  /models",
         "  /bind-model claude <model>",
         "  /orchestrate <task>",
+        "  /ask <prompt>",
     ]
 
 
@@ -515,7 +541,7 @@ def trim(text: str, limit: int) -> str:
 def menu_lines() -> list[str]:
     return [
         "1=/init 2=/status 3=/retrieve 4=/goal 5=/set-goal 6=/drift 7=/events 8=/replay 9=/help",
-        "Plain text captures coding request. Claude: /claude-install ., /agents, /agent reviewer <task>",
+        "Plain text saves RAM only. Use /ask <prompt> to call bound models.",
     ]
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentram",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Async, model-agnostic Working RAM for coding agents.",
   "license": "MIT",
   "homepage": "https://github.com/trancongnghia/AGENT_RAM#readme",

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agentram"
-version = "0.1.2"
+version = "0.1.3"
 description = "Async, model-agnostic RAM layer for agentic coding tools."
 readme = "README.md"
 license = "MIT"