@deepraxis/cli 0.1.0-dev.c6c496f → 0.1.0-dev.d939e0f

package/COMMANDS.md

@@ -2,7 +2,7 @@
 
 Generated by `bun run commands`. DO NOT EDIT.
 
-352 HTTP operations; 354 commands including aliases.
+358 HTTP operations; 360 commands including aliases.
 
 Environment: `PRAXIS_ENV=develop|production` (dev package defaults to `develop`; stable package defaults to `production`). No `--env` option.
 
@@ -43,6 +43,11 @@ Handwritten commands: `login`, `logout`, `whoami`, `org list`, `org switch <orga
 | `praxis agent embed-token create` | `agent.embedTokens.create` | POST `/agent/v1/embed_tokens` | `--agent`, `--param-version`, `--external-user-id`, `--ttl-seconds`, `--budget-cents`, `--allowed-origins` |
 | `praxis agent embed-token list` | `agent.embedTokens.list` | GET `/agent/v1/embed_tokens` | `--agent-id`, `--external-user-id`, `--param-limit`, `--page` |
 | `praxis agent embed-token revoke create` | `agent.embedTokens.revoke.create` | POST `/agent/v1/embed_tokens/{id}/revoke` | `--embed-token` |
+| `praxis agent end-user block create` | `agent.agents.endUsers.block.create` | POST `/agent/v1/agents/{agent_id}/end_users/{external_user_id}/block` | `--agent`, `--end-user` |
+| `praxis agent end-user get <external_user_id>` | `agent.agents.endUsers.retrieve` | GET `/agent/v1/agents/{agent_id}/end_users/{external_user_id}` | `--agent` |
+| `praxis agent end-user list` | `agent.agents.endUsers.list` | GET `/agent/v1/agents/{agent_id}/end_users` | `--agent`, `--param-limit`, `--page`, `--q` |
+| `praxis agent end-user revoke-token create` | `agent.agents.endUsers.revokeTokens.create` | POST `/agent/v1/agents/{agent_id}/end_users/{external_user_id}/revoke_tokens` | `--agent`, `--end-user` |
+| `praxis agent end-user unblock create` | `agent.agents.endUsers.unblock.create` | POST `/agent/v1/agents/{agent_id}/end_users/{external_user_id}/unblock` | `--agent`, `--end-user` |
 | `praxis agent environment archive <environment_id>` | `agent.environments.archive` | POST `/agent/v1/environments/{environment_id}/archive` |  |
 | `praxis agent environment create` | `agent.environments.create` | POST `/agent/v1/environments` | `--name`, `--description`, `--scope` |
 | `praxis agent environment get <environment_id>` | `agent.environments.retrieve` | GET `/agent/v1/environments/{environment_id}` |  |
@@ -64,7 +69,7 @@ Handwritten commands: `login`, `logout`, `whoami`, `org list`, `org switch <orga
 | `praxis agent session get <session_id>` | `agent.sessions.retrieve` | GET `/agent/v1/sessions/{session_id}` |  |
 | `praxis agent session get-compact <operation_id>` | `agent.sessions.retrieveCompact` | GET `/agent/v1/sessions/{session_id}/compact/{operation_id}` | `--session` |
 | `praxis agent session get-context <session_id>` | `agent.sessions.retrieveContext` | GET `/agent/v1/sessions/{session_id}/context` |  |
-| `praxis agent session list` | `agent.sessions.list` | GET `/agent/v1/sessions` | `--agent-id`, `--agent-version`, `--created-at-gt`, `--created-at-gte`, `--created-at-lt`, `--created-at-lte`, `--deployment-id`, `--include-archived`, `--memory-store-id`, `--order`, `--statuses`, `--param-limit`, `--page` |
+| `praxis agent session list` | `agent.sessions.list` | GET `/agent/v1/sessions` | `--agent-id`, `--agent-version`, `--created-at-gt`, `--created-at-gte`, `--created-at-lt`, `--created-at-lte`, `--deployment-id`, `--include-archived`, `--memory-store-id`, `--order`, `--statuses`, `--param-limit`, `--page`, `--external-user-id`, `--source` |
 | `praxis agent session resource create` | `agent.sessions.resources.create` | POST `/agent/v1/sessions/{session_id}/resources` | `--session`, `--type`, `--file-id`, `--mount-path` |
 | `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` |
@@ -305,6 +310,7 @@ Handwritten commands: `login`, `logout`, `whoami`, `org list`, `org switch <orga
 | `praxis organization cost list` | `organization.costs.list` | GET `/organization/v1/costs` | `--starting-at`, `--ending-at`, `--bucket-width`, `--time-zone`, `--group-by`, `--page` |
 | `praxis organization event get <id>` | `organization.events.retrieve` | GET `/organization/v1/events/{id}` |  |
 | `praxis organization event list` | `organization.events.list` | GET `/organization/v1/events` | `--starting-at`, `--ending-at`, `--param-limit`, `--page` |
+| `praxis organization feedback count list` | `organization.feedback.counts.list` | GET `/organization/v1/feedback/counts` |  |
 | `praxis organization feedback create` | `organization.feedback.create` | POST `/organization/v1/feedback` | `--message`, `--contact-email`, `--name`, `--url`, `--associated-event-id`, `--title`, `--type`, `--source` |
 | `praxis organization feedback get <id>` | `organization.feedback.retrieve` | GET `/organization/v1/feedback/{id}` |  |
 | `praxis organization feedback list` | `organization.feedback.list` | GET `/organization/v1/feedback` | `--phase`, `--query`, `--param-limit`, `--page` |

package/dist/praxis.js

@@ -369,6 +369,136 @@ current version; omit to apply the update unconditionally.`
     ],
     query: []
   },
+  {
+    resource: "agent.agents.endUsers",
+    method: "list",
+    summary: "List End Users",
+    description: `List users who have sessions or token issuance history on a service agent.
+
+Ordered by last_active_at and external_user_id descending. q is a case-sensitive literal prefix, including underscores. limit is 1–100, default 20. Reuse next_page with the same organization, agent, q and limit. Preemptively blocked users without history do not appear. End-user credentials and inaccessible or personal agents return 404.`,
+    http: "GET",
+    path: "/agent/v1/agents/{agent_id}/end_users",
+    streaming: "no",
+    pagination: false,
+    pathParams: [
+      {
+        name: "agent_id",
+        sdkName: "agent_id"
+      }
+    ],
+    query: [
+      {
+        name: "limit",
+        type: "integer",
+        required: false,
+        description: "Maximum users per page; defaults to 20."
+      },
+      {
+        name: "page",
+        type: "string",
+        required: false,
+        description: "next_page from the previous response with the same agent, q and limit."
+      },
+      {
+        name: "q",
+        type: "string",
+        required: false,
+        description: "Case-sensitive literal prefix of external_user_id; omit or use an empty string for all users."
+      }
+    ]
+  },
+  {
+    resource: "agent.agents.endUsers",
+    method: "retrieve",
+    summary: "Get End User",
+    description: `Inspect one end user and their twenty most recently updated sessions.
+
+Use external_user_id from listing or your host application. Users without session or issuance history return 404, including preemptively blocked users. End-user credentials and inaccessible or personal agents return 404.`,
+    http: "GET",
+    path: "/agent/v1/agents/{agent_id}/end_users/{external_user_id}",
+    streaming: "no",
+    pagination: false,
+    pathParams: [
+      {
+        name: "agent_id",
+        sdkName: "agent_id"
+      },
+      {
+        name: "external_user_id",
+        sdkName: "external_user_id"
+      }
+    ],
+    query: []
+  },
+  {
+    resource: "agent.agents.endUsers.block",
+    method: "create",
+    summary: "Block End User",
+    description: `Block token issuance and session creation, then revoke existing tokens for an end user.
+
+May block a user before any history exists; timestamps are then null and counts and cost are zero. Requires an embed policy, otherwise returns 409 with setup guidance. Deduplicates the policy blocklist and retains its 1000-user maximum. If revocation returns 502, the user remains blocked; retry to finish revocation. Repeats keep the user blocked and revoke any remaining grants. End-user credentials and inaccessible or personal agents return 404.`,
+    http: "POST",
+    path: "/agent/v1/agents/{agent_id}/end_users/{external_user_id}/block",
+    streaming: "no",
+    pagination: false,
+    pathParams: [
+      {
+        name: "agent_id",
+        sdkName: "agent_id"
+      },
+      {
+        name: "external_user_id",
+        sdkName: "external_user_id"
+      }
+    ],
+    query: []
+  },
+  {
+    resource: "agent.agents.endUsers.revokeTokens",
+    method: "create",
+    summary: "Revoke End User Tokens",
+    description: `Revoke all issued tokens for an end user and terminate their open embed streams.
+
+Revokes credentials before marking grants revoked. Upstream failure returns 502 without changing grant revocation timestamps. Returns the count of newly revoked grants; a repeat without new grants returns zero. Does not block future issuance. End-user credentials and inaccessible or personal agents return 404.`,
+    http: "POST",
+    path: "/agent/v1/agents/{agent_id}/end_users/{external_user_id}/revoke_tokens",
+    streaming: "no",
+    pagination: false,
+    pathParams: [
+      {
+        name: "agent_id",
+        sdkName: "agent_id"
+      },
+      {
+        name: "external_user_id",
+        sdkName: "external_user_id"
+      }
+    ],
+    query: []
+  },
+  {
+    resource: "agent.agents.endUsers.unblock",
+    method: "create",
+    summary: "Unblock End User",
+    description: `Allow an end user to receive new tokens and create new sessions again.
+
+Removes the user from the blocklist; previously revoked tokens stay revoked. Idempotent. Requires an embed policy, otherwise returns 409 with setup guidance. Returns null timestamps and zero counts and cost when no session or issuance history exists. End-user credentials and inaccessible or personal agents return 404.`,
+    http: "POST",
+    path: "/agent/v1/agents/{agent_id}/end_users/{external_user_id}/unblock",
+    streaming: "no",
+    pagination: false,
+    pathParams: [
+      {
+        name: "agent_id",
+        sdkName: "agent_id"
+      },
+      {
+        name: "external_user_id",
+        sdkName: "external_user_id"
+      }
+    ],
+    query: []
+  },
   {
     resource: "agent.agents.versions",
     method: "list",
@@ -1492,6 +1622,25 @@ owning account only.`
         type: "string",
         required: false,
         description: "Opaque pagination cursor: pass the next_page value of the previous response unchanged. Omit it for the first page. A cursor from a different query or a malformed one returns 400."
+      },
+      {
+        name: "external_user_id",
+        type: "string",
+        required: false,
+        description: "Filter by an exact end-user identifier (1–128 characters: A-Z, a-z, 0-9, underscore, dot, colon, at sign or hyphen). Keep this filter unchanged when following page."
+      },
+      {
+        name: "source",
+        type: "string",
+        enum: [
+          "kit",
+          "iframe",
+          "hosted",
+          "api",
+          "automation"
+        ],
+        required: false,
+        description: "Filter by session origin: kit, iframe, hosted, api or automation. Keep this filter unchanged when following page."
       }
     ]
   },
@@ -11680,15 +11829,8 @@ for more details.`
       {
         name: "phase",
         type: "string",
-        enum: [
-          "open",
-          "awaiting_customer",
-          "in_progress",
-          "resolved",
-          "closed"
-        ],
         required: false,
-        description: "Only feedback in this phase: open, awaiting_customer, in_progress, resolved or closed; see the phase field of a feedback for what each means."
+        description: "Only feedback in these phases: a comma-separated list of open, awaiting_customer, in_progress, resolved or closed, for example open,in_progress; see the phase field of a feedback for what each means."
       },
       {
         name: "query",
@@ -11798,6 +11940,18 @@ for more details.`
       ]
     }
   },
+  {
+    resource: "organization.feedback.counts",
+    method: "list",
+    summary: "Count your organization's feedback by phase",
+    description: "How many of your organization's feedback are in each phase, for status tabs. Counts never include another organization's feedback.",
+    http: "GET",
+    path: "/organization/v1/feedback/counts",
+    streaming: "no",
+    pagination: false,
+    pathParams: [],
+    query: []
+  },
   {
     resource: "organization.feedback",
     method: "retrieve",
@@ -15132,6 +15286,71 @@ var setRunFeedback = (options) => (options.client ?? client).post({
     ...options.headers
   }
 });
+var listEndUsers = (options) => (options.client ?? client).get({
+  security: [{
+    key: "BearerAuth",
+    scheme: "bearer",
+    type: "http"
+  }, {
+    key: "ApiKeyAuth",
+    name: "X-API-Key",
+    type: "apiKey"
+  }],
+  url: "/agent/v1/agents/{agent_id}/end_users",
+  ...options
+});
+var getEndUser = (options) => (options.client ?? client).get({
+  security: [{
+    key: "BearerAuth",
+    scheme: "bearer",
+    type: "http"
+  }, {
+    key: "ApiKeyAuth",
+    name: "X-API-Key",
+    type: "apiKey"
+  }],
+  url: "/agent/v1/agents/{agent_id}/end_users/{external_user_id}",
+  ...options
+});
+var revokeEndUserTokens = (options) => (options.client ?? client).post({
+  security: [{
+    key: "BearerAuth",
+    scheme: "bearer",
+    type: "http"
+  }, {
+    key: "ApiKeyAuth",
+    name: "X-API-Key",
+    type: "apiKey"
+  }],
+  url: "/agent/v1/agents/{agent_id}/end_users/{external_user_id}/revoke_tokens",
+  ...options
+});
+var blockEndUser = (options) => (options.client ?? client).post({
+  security: [{
+    key: "BearerAuth",
+    scheme: "bearer",
+    type: "http"
+  }, {
+    key: "ApiKeyAuth",
+    name: "X-API-Key",
+    type: "apiKey"
+  }],
+  url: "/agent/v1/agents/{agent_id}/end_users/{external_user_id}/block",
+  ...options
+});
+var unblockEndUser = (options) => (options.client ?? client).post({
+  security: [{
+    key: "BearerAuth",
+    scheme: "bearer",
+    type: "http"
+  }, {
+    key: "ApiKeyAuth",
+    name: "X-API-Key",
+    type: "apiKey"
+  }],
+  url: "/agent/v1/agents/{agent_id}/end_users/{external_user_id}/unblock",
+  ...options
+});
 var listEmbedTokens = (options) => (options?.client ?? client).get({
   security: [{
     key: "BearerAuth",
@@ -16211,6 +16430,19 @@ var createOrganizationFeedback = (options) => (options.client ?? client).post({
     ...options.headers
   }
 });
+var getOrganizationFeedbackCounts = (options) => (options?.client ?? client).get({
+  security: [{
+    key: "BearerAuth",
+    scheme: "bearer",
+    type: "http"
+  }, {
+    key: "ApiKeyAuth",
+    name: "X-API-Key",
+    type: "apiKey"
+  }],
+  url: "/organization/v1/feedback/counts",
+  ...options
+});
 var getOrganizationFeedback = (options) => (options.client ?? client).get({
   security: [{
     key: "BearerAuth",
@@ -20006,6 +20238,19 @@ function createAgent(transport) {
     agents: {
       archive: bind(transport, agentsArchive),
       create: bind(transport, agentsCreate),
+      endUsers: {
+        block: {
+          create: bind(transport, blockEndUser)
+        },
+        list: bind(transport, listEndUsers),
+        retrieve: bind(transport, getEndUser),
+        revokeTokens: {
+          create: bind(transport, revokeEndUserTokens)
+        },
+        unblock: {
+          create: bind(transport, unblockEndUser)
+        }
+      },
       list: bind(transport, agentsList),
       retrieve: bind(transport, agentsRetrieve),
       update: bind(transport, agentsUpdate),
@@ -20569,6 +20814,9 @@ function createOrganization(transport) {
       retrieve: bind(transport, getOrganizationEvent)
     },
     feedback: {
+      counts: {
+        list: bind(transport, getOrganizationFeedbackCounts)
+      },
       create: bind(transport, createOrganizationFeedback),
       list: bind(transport, listOrganizationFeedback),
       messages: {
@@ -22765,7 +23013,7 @@ function startProgress(ctx, write = (text) => writeOutput({ stderr: text })) {
 }
 
 // src/main.ts
-var version = "0.1.0-dev.c6c496f";
+var version = "0.1.0-dev.d939e0f";
 var commands = commandTree(operations);
 var manual = [["login"], ["logout"], ["whoami"], ["org", "list"], ["org", "switch"], ["api"], ["skill"]];
 function route(argv) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepraxis/cli",
-  "version": "0.1.0-dev.c6c496f",
+  "version": "0.1.0-dev.d939e0f",
   "type": "module",
   "bin": {
     "praxis": "dist/praxis.js"