@deepraxis/cli 0.1.0-dev.45dc412 → 0.1.0-dev.6cb2ca2

package/COMMANDS.md

@@ -2,7 +2,7 @@
 
 Generated by `bun run commands`. DO NOT EDIT.
 
-346 HTTP operations; 348 commands including aliases.
+348 HTTP operations; 350 commands including aliases.
 
 Environment: `PRAXIS_ENV=develop|production` (dev package defaults to `develop`; stable package defaults to `production`). No `--env` option.
 
@@ -69,6 +69,8 @@ Handwritten commands: `login`, `logout`, `whoami`, `org list`, `org switch <orga
 | `praxis agent session resource delete <resource_id>` | `agent.sessions.resources.delete` | DELETE `/agent/v1/sessions/{session_id}/resources/{resource_id}` | `--session`, `--query-session-id` |
 | `praxis agent session resource get <resource_id>` | `agent.sessions.resources.retrieve` | GET `/agent/v1/sessions/{session_id}/resources/{resource_id}` | `--session`, `--query-session-id` |
 | `praxis agent session resource list` | `agent.sessions.resources.list` | GET `/agent/v1/sessions/{session_id}/resources` | `--session`, `--param-limit`, `--page` |
+| `praxis agent session run delete-feedback <run_id>` | `agent.sessions.runs.deleteFeedback` | DELETE `/agent/v1/sessions/{session_id}/runs/{run_id}/feedback` | `--session` |
+| `praxis agent session run feedback create` | `agent.sessions.runs.feedback.create` | POST `/agent/v1/sessions/{session_id}/runs/{run_id}/feedback` | `--session`, `--run`, `--rating`, `--comment` |
 | `praxis agent session thread archive <thread_id>` | `agent.sessions.threads.archive` | POST `/agent/v1/sessions/{session_id}/threads/{thread_id}/archive` | `--session`, `--query-session-id` |
 | `praxis agent session thread event list` | `agent.sessions.threads.events.list` | GET `/agent/v1/sessions/{session_id}/threads/{thread_id}/events` | `--session`, `--thread`, `--query-session-id`, `--param-limit`, `--page` |
 | `praxis agent session thread get <thread_id>` | `agent.sessions.threads.retrieve` | GET `/agent/v1/sessions/{session_id}/threads/{thread_id}` | `--session`, `--query-session-id` |

package/README.md

@@ -7,8 +7,8 @@
 The official command line for [知行云 Praxis](https://deepraxis.com), the cloud where AI agents are built, run and hosted.
 
 [![npm](https://img.shields.io/npm/v/@deepraxis/cli?label=npm&color=2e8555)](https://www.npmjs.com/package/@deepraxis/cli)
-[![Node.js](https://img.shields.io/node/v/@deepraxis/cli?color=2e8555)](https://nodejs.org)
-[![License](https://img.shields.io/badge/license-Apache--2.0-2e8555)](./LICENSE)
+[![Node.js](https://img.shields.io/badge/node-%E2%89%A520-2e8555)](https://nodejs.org)
+[![License](https://img.shields.io/badge/license-Apache--2.0-2e8555)](https://www.apache.org/licenses/LICENSE-2.0)
 
 [Website](https://deepraxis.com) · [Documentation](https://docs.deepraxis.com) · [API reference](https://docs.deepraxis.com/docs/api) · [Console](https://console.deepraxis.com)
 
@@ -20,7 +20,7 @@ The official command line for [知行云 Praxis](https://deepraxis.com), the clo
 npm install -g @deepraxis/cli
 praxis login
 praxis model chat completion create --model deepseek-flash \
-  --data '{"messages":[{"role":"user","content":"Say hello in three languages"}]}'
+  --data '{"messages":[{"role":"user","content":"Hello!"}]}'
 ```
 
 Every operation of the Praxis API is a command: about 350 of them across models, agents,
@@ -57,8 +57,8 @@ npx @deepraxis/cli model list
 ## Sign in
 
 ```sh
-praxis login      # opens the device page; type the code shown in your terminal
-praxis whoami     # who you are, which organization, where the credential is stored
+praxis login    # approve in the browser with the code shown
+praxis whoami   # account, organization, credential storage
 ```
 
 You need a Praxis account; sign up at [deepraxis.com](https://deepraxis.com).
@@ -68,7 +68,7 @@ Belong to several organizations? Every call runs in the active one:
 ```sh
 praxis org list
 praxis org switch <organization_id>
-praxis model list --org <organization_id>   # one call in another organization
+praxis model list --org <organization_id>   # just this call
 ```
 
 For CI and other headless environments, create an API key in the
@@ -86,9 +86,11 @@ export PRAXIS_API_KEY=<your-api-key>
 ```sh
 praxis model list
 praxis model chat completion create --model deepseek-flash \
-  --data '{"messages":[{"role":"user","content":"Write a haiku about the sea"}]}'
-praxis model embedding create --model <embedding-model> --data '{"input":"hello world"}'
-praxis model image generation create --model <image-model> --prompt "a lighthouse at dawn"
+  --data '{"messages":[{"role":"user","content":"A haiku"}]}'
+praxis model embedding create --model <embedding_model> \
+  --data '{"input":"hello world"}'
+praxis model image generation create --model <image_model> \
+  --prompt "a lighthouse at dawn"
 ```
 
 ### Agents
@@ -103,7 +105,10 @@ praxis agent create --data '{
 }'
 praxis agent session create --data '{"agent": "<agent_id>"}'
 praxis agent session event send <session_id> --data '{
-  "events": [{"type": "user.message", "content": [{"type": "text", "text": "List the files in your home directory"}]}]
+  "events": [{
+    "type": "user.message",
+    "content": [{"type": "text", "text": "What can you do?"}]
+  }]
 }'
 praxis agent session event stream --session <session_id>
 ```
@@ -112,23 +117,24 @@ praxis agent session event stream --session <session_id>
 
 ```sh
 praxis sandbox create --template-id base
-praxis sandbox command run <sandbox_id> --cmd "python3 -c 'print(6 * 7)'"
+praxis sandbox command run <sandbox_id> \
+  --cmd "python3 -c 'print(6 * 7)'"
 praxis sandbox delete <sandbox_id> --yes
 ```
 
 ### Search, data and automation
 
 ```sh
-praxis search create --query "latest Cloudflare Workers announcements" --max-results 5
+praxis search create --query "AI agent frameworks" --max-results 5
 praxis database create --name notes
 praxis automation run create --data '{
-  "source": "export default async (input: { n: number }) => ({ answer: input.n + 1 })",
+  "source": "export default async (i) => ({ answer: i.n + 1 })",
   "language": "ts", "input": {"n": 41}, "wait": 30
 }'
 ```
 
 Browse everything with `praxis --help`, `praxis <domain> --help`, or the full
-[command reference](./COMMANDS.md) in the package.
+[command reference](https://unpkg.com/@deepraxis/cli/COMMANDS.md) that ships in the package.
 
 ## How commands work
 
@@ -170,8 +176,8 @@ The CLI writes its own skill file: the general rules plus one line per command,
 the API contract.
 
 ```sh
-praxis skill --install ~/.claude/skills     # writes praxis-cli/SKILL.md
-praxis skill > SKILL.md                      # or print it anywhere
+praxis skill --install ~/.claude/skills   # praxis-cli/SKILL.md
+praxis skill > SKILL.md                    # or print it
 ```
 
 After that, an agent such as Claude Code can drive every Praxis capability through the CLI and
@@ -200,7 +206,7 @@ Linux. Without a keychain they are written to `~/.praxis/cli/<env>.json` with mo
 ## Resources
 
 - [Documentation](https://docs.deepraxis.com) and [API reference](https://docs.deepraxis.com/docs/api)
-- [Command reference](./COMMANDS.md)
+- [Command reference](https://unpkg.com/@deepraxis/cli/COMMANDS.md)
 - TypeScript SDK: [`@deepraxis/sdk`](https://www.npmjs.com/package/@deepraxis/sdk), the same API as code
 - Already using the OpenAI or Anthropic SDK? Point its `baseURL` at
   `https://api.deepraxis.com/openai/v1` or the Anthropic-compatible endpoint, as the
@@ -208,7 +214,7 @@ Linux. Without a keychain they are written to `~/.praxis/cli/<env>.json` with mo
 
 ## License
 
-[Apache-2.0](./LICENSE). Copyright 2026 南京深度实践人工智能科技有限公司 (Deepractice).
+[Apache-2.0](https://www.apache.org/licenses/LICENSE-2.0). Copyright 2026 南京深度实践人工智能科技有限公司 (Deepractice).
 
 "Praxis", "知行云" and "Deepraxis" are trademarks of Deepractice; the license does not grant
 rights to use them.

package/dist/praxis.js

@@ -2159,6 +2159,73 @@ Available only on /agent/v1. Use the message_id field from own-face events, not
       }
     ]
   },
+  {
+    resource: "agent.sessions.runs",
+    method: "deleteFeedback",
+    summary: "Delete Run Feedback",
+    description: `Remove the rating and comment for a run.
+
+Own-face extension. Use the session id from session creation or listing and the run_id from its events. Requires a readable session and a run belonging to it. Idempotent; returns 204 even when no feedback exists. End users can delete feedback only for their own sessions. Does not delete the run or messages, enter model context, or start another run.`,
+    http: "DELETE",
+    path: "/agent/v1/sessions/{session_id}/runs/{run_id}/feedback",
+    streaming: "no",
+    pagination: false,
+    pathParams: [
+      {
+        name: "session_id",
+        sdkName: "session_id"
+      },
+      {
+        name: "run_id",
+        sdkName: "run_id"
+      }
+    ],
+    query: []
+  },
+  {
+    resource: "agent.sessions.runs.feedback",
+    method: "create",
+    summary: "Set Run Feedback",
+    description: `Submit thumbs up or thumbs down for a run, with an optional comment.
+
+Own-face extension. Use a readable session and a run_id from its events. Each submission replaces the previous rating and comment; omitted or null comment clears it, while created_at is preserved. Comments allow at most 2000 Unicode characters. End users can submit only for their own sessions. Feedback never enters model context or starts a run. For example, submit {"rating":"positive","comment":"Helpful"}. POST follows Managed Agents resource update conventions; the resource remains unique per session and run.`,
+    http: "POST",
+    path: "/agent/v1/sessions/{session_id}/runs/{run_id}/feedback",
+    streaming: "no",
+    pagination: false,
+    pathParams: [
+      {
+        name: "session_id",
+        sdkName: "session_id"
+      },
+      {
+        name: "run_id",
+        sdkName: "run_id"
+      }
+    ],
+    query: [],
+    body: {
+      required: true,
+      fields: [
+        {
+          name: "rating",
+          type: "string",
+          enum: [
+            "positive",
+            "negative"
+          ],
+          required: true,
+          description: "positive means thumbs up; negative means thumbs down for this run."
+        },
+        {
+          name: "comment",
+          type: "string",
+          required: false,
+          description: "Optional comment, at most 2000 Unicode characters. Omit or send null to clear the previous comment."
+        }
+      ]
+    }
+  },
   {
     resource: "agent.sessions.threads",
     method: "list",
@@ -14897,6 +14964,36 @@ var createClient = (config = {}) => {
 var client = createClient(createConfig({ baseUrl: "https://api.deepraxis.com" }));
 
 // ../../packages/sdk/typescript/src/generated/sdk.gen.ts
+var deleteRunFeedback = (options) => (options.client ?? client).delete({
+  security: [{
+    key: "BearerAuth",
+    scheme: "bearer",
+    type: "http"
+  }, {
+    key: "ApiKeyAuth",
+    name: "X-API-Key",
+    type: "apiKey"
+  }],
+  url: "/agent/v1/sessions/{session_id}/runs/{run_id}/feedback",
+  ...options
+});
+var setRunFeedback = (options) => (options.client ?? client).post({
+  security: [{
+    key: "BearerAuth",
+    scheme: "bearer",
+    type: "http"
+  }, {
+    key: "ApiKeyAuth",
+    name: "X-API-Key",
+    type: "apiKey"
+  }],
+  url: "/agent/v1/sessions/{session_id}/runs/{run_id}/feedback",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
+});
 var listEmbedTokens = (options) => (options?.client ?? client).get({
   security: [{
     key: "BearerAuth",
@@ -19798,6 +19895,12 @@ function createAgent(transport) {
       retrieve: bind(transport, sessionsRetrieve),
       retrieveCompact: bind(transport, getSessionCompaction),
       retrieveContext: bind(transport, getSessionContext),
+      runs: {
+        deleteFeedback: bind(transport, deleteRunFeedback),
+        feedback: {
+          create: bind(transport, setRunFeedback)
+        }
+      },
       threads: {
         archive: bind(transport, aliasOperation(sessionsThreadsArchive, { query: { session_id: "query_session_id" } })),
         events: {
@@ -22462,7 +22565,7 @@ function startProgress(ctx, write = (text) => writeOutput({ stderr: text })) {
 }
 
 // src/main.ts
-var version = "0.1.0-dev.45dc412";
+var version = "0.1.0-dev.6cb2ca2";
 var commands = commandTree(operations);
 var manual = [["login"], ["logout"], ["whoami"], ["org", "list"], ["org", "switch"], ["api"], ["skill"]];
 function route(argv) {

package/package.json

@@ -1,23 +1,15 @@
 {
   "name": "@deepraxis/cli",
-  "version": "0.1.0-dev.45dc412",
+  "version": "0.1.0-dev.6cb2ca2",
   "type": "module",
   "bin": {
     "praxis": "dist/praxis.js"
   },
   "description": "The official command line for Praxis (知行云): models, agents, sandboxes, search and data from one terminal.",
   "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Deepraxis/Praxis.git",
-    "directory": "apps/cli"
-  },
   "engines": {
     "node": ">=20"
   },
-  "publishConfig": {
-    "access": "public"
-  },
   "files": [
     "dist",
     "README.md",
@@ -36,5 +28,8 @@
     "ai-agents",
     "claude-code"
   ],
-  "author": "Deepractice"
+  "author": "Deepractice",
+  "publishConfig": {
+    "access": "public"
+  }
 }