Add camelCase GPT Action aliases: startSession, listTools, listReceipts, listArtifacts, listTerminals, apiHelp, getCapabilities, gateStatus

app.py

@@ -451,6 +451,125 @@ async def get_receipt(receipt_id: str):
     return {"id": row["id"], "kind": row["kind"], "workspace": row["workspace"], "summary": row["summary"], "sha256": row["sha256"], "created_at": row["created_at"], "data": json.loads(row["data_json"])}
 
 
+# ═══════════════════════════════════════════════════════════════
+#  GPT ACTION ALIASES — camelCase routes for GPT Action compatibility
+# ═══════════════════════════════════════════════════════════════
+@app.get("/startSession")
+async def alias_start_session_get(workspace: str = "default", cwd: str = "."):
+    sid = uuid.uuid4().hex[:12]
+    _ws_path(workspace, cwd)
+    now = datetime.now(timezone.utc).isoformat()
+    with DB_LOCK:
+        conn = _db()
+        conn.execute("INSERT INTO sessions VALUES (?,?,?,?,1)", (sid, workspace, cwd, now))
+        conn.commit()
+        conn.close()
+    return {"session_id": sid, "workspace": workspace, "cwd": cwd, "created_at": now}
+
+
+@app.post("/startSession")
+async def alias_start_session_post(req: SessionCreateRequest):
+    return await create_session(req)
+
+
+@app.get("/listTools")
+async def alias_list_tools():
+    return await list_tools()
+
+
+@app.get("/listReceipts")
+async def alias_list_receipts(limit: int = 50):
+    return await get_recent_ledger(limit)
+
+
+@app.get("/listArtifacts")
+async def alias_list_artifacts():
+    artifacts = []
+    if ARTIFACTS_DIR.exists():
+        for d in sorted(ARTIFACTS_DIR.iterdir())[:100]:
+            if d.is_dir():
+                meta_path = d / "meta.json"
+                if meta_path.exists():
+                    meta = json.loads(meta_path.read_text())
+                    artifacts.append(meta)
+    return {"artifacts": artifacts}
+
+
+@app.get("/listTerminals")
+async def alias_list_terminals():
+    with DB_LOCK:
+        conn = _db()
+        rows = conn.execute("SELECT session_id, workspace, cwd, created_at, active FROM sessions ORDER BY created_at DESC LIMIT 50").fetchall()
+        conn.close()
+    return {"terminals": [{"session_id": r["session_id"], "workspace": r["workspace"], "cwd": r["cwd"], "created_at": r["created_at"], "active": bool(r["active"])} for r in rows]}
+
+
+@app.get("/apiHelp")
+async def alias_api_help():
+    return {
+        "service": "Giant GPT Terminal Kernel",
+        "version": "3.1.1",
+        "operations": [
+            {"name": "health", "method": "GET", "path": "/health"},
+            {"name": "startSession", "method": "GET/POST", "path": "/startSession", "params": {"workspace": "string", "cwd": "string"}},
+            {"name": "runTerminal", "method": "POST", "path": "/terminal/run", "body": {"workspace": "string", "command": "string", "timeout_seconds": "int", "cwd": "string"}},
+            {"name": "runPython", "method": "POST", "path": "/python/run", "body": {"workspace": "string", "code": "string", "timeout_seconds": "int"}},
+            {"name": "runSession", "method": "POST", "path": "/session/run", "body": {"session_id": "string", "command": "string"}},
+            {"name": "writeFile", "method": "POST", "path": "/files/write", "body": {"workspace": "string", "path": "string", "content": "string"}},
+            {"name": "readFile", "method": "POST", "path": "/files/read", "body": {"workspace": "string", "path": "string"}},
+            {"name": "listFiles", "method": "POST", "path": "/files/list", "body": {"workspace": "string", "path": "string"}},
+            {"name": "workspaceTree", "method": "GET", "path": "/workspace/tree", "params": {"workspace": "string"}},
+            {"name": "compileArtifact", "method": "POST", "path": "/artifact/compile", "body": {"workspace": "string", "filename": "string", "content": "string"}},
+            {"name": "issueUrl", "method": "POST", "path": "/url/issue", "body": {"workspace": "string", "filename": "string", "content": "string"}},
+            {"name": "learn", "method": "POST", "path": "/learn", "body": {"topic": "string", "content": "string", "utility": "float"}},
+            {"name": "recall", "method": "POST", "path": "/recall", "body": {"query": "string", "limit": "int"}},
+            {"name": "registerTool", "method": "POST", "path": "/tool/register", "body": {"name": "string", "command_template": "string", "mode": "string"}},
+            {"name": "listTools", "method": "GET", "path": "/listTools"},
+            {"name": "invokeTool", "method": "POST", "path": "/tool/{name}", "body": {"workspace": "string", "args": "object"}},
+            {"name": "listReceipts", "method": "GET", "path": "/listReceipts"},
+            {"name": "listArtifacts", "method": "GET", "path": "/listArtifacts"},
+            {"name": "listTerminals", "method": "GET", "path": "/listTerminals"},
+            {"name": "getCapabilities", "method": "GET", "path": "/getCapabilities"},
+            {"name": "gateStatus", "method": "GET", "path": "/gateStatus"},
+            {"name": "getReceipt", "method": "GET", "path": "/receipt/{receipt_id}"},
+        ],
+    }
+
+
+@app.get("/getCapabilities")
+async def alias_get_capabilities():
+    return {
+        "capabilities": [
+            {"name": "terminal", "description": "Execute shell commands in a sandboxed workspace", "methods": ["POST /terminal/run", "POST /session/run"]},
+            {"name": "python", "description": "Execute Python code in a sandboxed workspace", "methods": ["POST /python/run"]},
+            {"name": "filesystem", "description": "Read, write, and list files in workspaces", "methods": ["POST /files/write", "POST /files/read", "POST /files/list", "GET /workspace/tree"]},
+            {"name": "artifacts", "description": "Compile and serve artifact files with stable URLs", "methods": ["POST /artifact/compile", "POST /url/issue", "GET /listArtifacts"]},
+            {"name": "memory", "description": "Store and recall persistent memory entries", "methods": ["POST /learn", "POST /recall"]},
+            {"name": "tools", "description": "Register and invoke dynamic custom tools", "methods": ["POST /tool/register", "GET /listTools", "POST /tool/{name}"]},
+            {"name": "receipts", "description": "SHA-256 hashed receipt ledger for all operations", "methods": ["GET /listReceipts", "GET /receipt/{id}"]},
+            {"name": "sessions", "description": "Create and manage persistent terminal sessions", "methods": ["GET /startSession", "POST /startSession", "GET /listTerminals"]},
+        ],
+        "limits": {
+            "timeout_seconds": 30,
+            "max_file_bytes": 20000000,
+            "max_stdout": 50000,
+        },
+    }
+
+
+@app.get("/gateStatus")
+async def alias_gate_status():
+    return {
+        "gate": "open",
+        "authenticated": True,
+        "rate_limit": "none",
+        "concurrent_sessions": "unlimited",
+        "workspace_isolation": True,
+        "path_traversal_protection": True,
+        "receipt_system": True,
+    }
+
+
 # ═══════════════════════════════════════════════════════════════
 #  STATIC ARTIFACT SERVING (must be last — catches /artifact/* GETs)
 # ═══════════════════════════════════════════════════════════════
@@ -467,6 +586,8 @@ async def root():
         "version": "3.1.1",
         "endpoints": [
             "GET /health",
+            "GET /startSession",
+            "POST /startSession",
             "POST /terminal/run",
             "POST /python/run",
             "POST /session/create",
@@ -481,8 +602,15 @@ async def root():
             "POST /recall",
             "POST /tool/register",
             "GET /tools",
+            "GET /listTools",
             "POST /tool/{name}",
             "GET /ledger/recent",
+            "GET /listReceipts",
+            "GET /listArtifacts",
+            "GET /listTerminals",
+            "GET /apiHelp",
+            "GET /getCapabilities",
+            "GET /gateStatus",
             "GET /receipt/{receipt_id}",
         ],
     }

data/artifacts/5e9873df37b0efcf/meta.json

@@ -0,0 +1,7 @@
+{
+  "filename": "report.md",
+  "content_type": "text/markdown",
+  "workspace": "default",
+  "sha256": "5e9873df37b0efcf",
+  "created_at": "2026-07-27T14:46:31.520382+00:00"
+}

data/artifacts/5e9873df37b0efcf/report.md

@@ -0,0 +1,3 @@
+# Demo Report
+
+Generated by Giant GPT Terminal Kernel.