@deepraxis/cli 0.1.1-dev.69cffcf → 0.1.1-dev.78b913a

package/COMMANDS.md

@@ -2,7 +2,7 @@
 
 Generated by `bun run commands`. DO NOT EDIT.
 
-426 HTTP operations; 428 commands including aliases.
+434 HTTP operations; 436 commands including aliases.
 
 Environment: `PRAXIS_ENV=develop|production` (dev package defaults to `develop`; stable package defaults to `production`). No `--env` option.
 
@@ -36,6 +36,13 @@ Handwritten commands: `login`, `logout`, `whoami`, `org list`, `org switch <orga
 | `praxis agent customer auth access-token delete-current` | `agent.agents.customers.auth.accessTokens.deleteCurrent` | DELETE `/agent/v1/agents/{agent_id}/customers/auth/access_tokens/current` | `--agent` |
 | `praxis agent customer auth access-token renew create` | `agent.agents.customers.auth.accessTokens.renew.create` | POST `/agent/v1/agents/{agent_id}/customers/auth/access_tokens/renew` | `--agent` |
 | `praxis agent customer auth grant-code create` | `agent.agents.customers.auth.grantCodes.create` | POST `/agent/v1/agents/{agent_id}/customers/auth/grant_codes` | `--agent`, `--customer-id`, `--param-version`, `--origin`, `--expires-in`, `--max-session-seconds`, `--anonymous-access-token`, `--hosted` |
+| `praxis agent customer block create` | `agent.agents.customers.block.create` | POST `/agent/v1/agents/{agent_id}/customers/{customer_id}/block` | `--agent`, `--customer` |
+| `praxis agent customer delete <customer_id>` | `agent.agents.customers.delete` | DELETE `/agent/v1/agents/{agent_id}/customers/{customer_id}` | `--agent`, `--confirm` |
+| `praxis agent customer get <customer_id>` | `agent.agents.customers.retrieve` | GET `/agent/v1/agents/{agent_id}/customers/{customer_id}` | `--agent` |
+| `praxis agent customer get-deletion <customer_id>` | `agent.agents.customers.retrieveDeletion` | GET `/agent/v1/agents/{agent_id}/customers/{customer_id}/deletion` | `--agent` |
+| `praxis agent customer list` | `agent.agents.customers.list` | GET `/agent/v1/agents/{agent_id}/customers` | `--agent`, `--param-limit`, `--page`, `--q`, `--type`, `--blocked` |
+| `praxis agent customer revoke-token create` | `agent.agents.customers.revokeTokens.create` | POST `/agent/v1/agents/{agent_id}/customers/{customer_id}/revoke_tokens` | `--agent`, `--customer` |
+| `praxis agent customer unblock create` | `agent.agents.customers.unblock.create` | POST `/agent/v1/agents/{agent_id}/customers/{customer_id}/unblock` | `--agent`, `--customer` |
 | `praxis agent deployment archive <deployment_id>` | `agent.deployments.archive` | POST `/agent/v1/deployments/{deployment_id}/archive` |  |
 | `praxis agent deployment create` | `agent.deployments.create` | POST `/agent/v1/deployments` | `--environment-id`, `--name`, `--description`, `--vault-ids` |
 | `praxis agent deployment get <deployment_id>` | `agent.deployments.retrieve` | GET `/agent/v1/deployments/{deployment_id}` |  |
@@ -65,6 +72,7 @@ Handwritten commands: `login`, `logout`, `whoami`, `org list`, `org switch <orga
 | `praxis agent environment list` | `agent.environments.list` | GET `/agent/v1/environments` | `--include-archived`, `--param-limit`, `--page` |
 | `praxis agent environment update <environment_id>` | `agent.environments.update` | POST `/agent/v1/environments/{environment_id}` | `--description`, `--name` |
 | `praxis agent get <agent_id>` | `agent.agents.retrieve` | GET `/agent/v1/agents/{agent_id}` | `--param-version` |
+| `praxis agent get-appearance <agent_id>` | `agent.agents.retrieveAppearance` | GET `/agent/v1/agents/{agent_id}/appearance` |  |
 | `praxis agent list` | `agent.agents.list` | GET `/agent/v1/agents` | `--created-at-gte`, `--created-at-lte`, `--include-archived`, `--param-limit`, `--page`, `--kind` |
 | `praxis agent session archive <session_id>` | `agent.sessions.archive` | POST `/agent/v1/sessions/{session_id}/archive` |  |
 | `praxis agent session background-task get-output <task_id>` | `agent.sessions.backgroundTasks.retrieveOutput` | GET `/agent/v1/sessions/{session_id}/background_tasks/{task_id}/output` | `--session`, `--offset`, `--max-bytes` |

package/dist/praxis.js

@@ -451,6 +451,26 @@ current version; omit to apply the update unconditionally.`
       ]
     }
   },
+  {
+    resource: "agent.agents",
+    method: "retrieveAppearance",
+    summary: "Get agent appearance",
+    description: `Read the saved chat appearance of a service agent.
+
+Agent Kit calls this from the page with a customer access token of this agent; your API key and console members can read it too. A token of another agent returns 404. The body is the same as the embed appearance read; a missing appearance returns the agent's own name and avatar only. Responses are private and cacheable for 60 seconds.`,
+    http: "GET",
+    path: "/agent/v1/agents/{agent_id}/appearance",
+    streaming: "no",
+    pagination: false,
+    pathParams: [
+      {
+        name: "agent_id",
+        sdkName: "agent_id",
+        description: "Service agent id from agent creation or listing; with a customer access token, the agent the token was issued for."
+      }
+    ],
+    query: []
+  },
   {
     resource: "agent.agents",
     method: "archive",
@@ -469,6 +489,61 @@ current version; omit to apply the update unconditionally.`
     ],
     query: []
   },
+  {
+    resource: "agent.agents.customers",
+    method: "list",
+    summary: "List customers",
+    description: `List the customers of a service agent, identified and anonymous, most recently seen first.
+
+Call this from your backend with your API key, or from the console. Customers follow Shopify Admin customers (list, retrieve, block, sign-out and data deletion of the people who use your storefront), so that experience applies. The list includes customers who signed in but have not started a session yet, and customers recorded under your own ids by embed tokens before customer sign-in existed; an id first seen that way is identified unless it starts with anon_. Unlike Shopify, a customer can be anonymous: a visitor admitted with the publishable key gets an anon_ id, and when it later signs in with anonymous_access_token it is merged: merged_into names the identified customer, and its sessions count toward that customer. Filter with q (a case-sensitive customer id prefix), type (identified or anonymous) and blocked (true or false). limit is 1 to 100, default 20; reuse next_page with the same filters and limit. A customer access token gets 404. Example: GET /agent/v1/agents/agent_example/customers?type=identified&blocked=false&limit=50.`,
+    http: "GET",
+    path: "/agent/v1/agents/{agent_id}/customers",
+    streaming: "no",
+    pagination: false,
+    pathParams: [
+      {
+        name: "agent_id",
+        sdkName: "agent_id",
+        description: "Active service agent id from agent creation or listing."
+      }
+    ],
+    query: [
+      {
+        name: "limit",
+        type: "integer",
+        required: false,
+        description: "Maximum customers per page, 1 to 100; defaults to 20."
+      },
+      {
+        name: "page",
+        type: "string",
+        required: false,
+        description: "next_page from the previous response with the same q, type, blocked and limit."
+      },
+      {
+        name: "q",
+        type: "string",
+        required: false,
+        description: "Case-sensitive literal prefix of the customer id; omit for all customers."
+      },
+      {
+        name: "type",
+        type: "string",
+        enum: [
+          "identified",
+          "anonymous"
+        ],
+        required: false,
+        description: "Only identified or only anonymous customers; omit for both."
+      },
+      {
+        name: "blocked",
+        type: "boolean",
+        required: false,
+        description: "true for blocked customers only, false for customers who are not blocked; omit for both."
+      }
+    ]
+  },
   {
     resource: "agent.agents.customers.auth.accessTokens",
     method: "create",
@@ -625,6 +700,163 @@ Call this from your backend with your API key after your own login succeeds, the
       ]
     }
   },
+  {
+    resource: "agent.agents.customers",
+    method: "delete",
+    summary: "Delete customer data",
+    description: `Delete a customer's data from one service agent after explicit confirmation.
+
+Develop only. Set confirm to the exact customer id; a missing or different confirm returns 400 naming the value to send. Returns 202 with a pending task id; poll the deletion endpoint. Concurrent requests reuse the unfinished task; retry DELETE after failure to resume it. Tokens are revoked and the customer is blocked before a seven-day recovery snapshot is verified; sessions including child sessions, conversation data, grants and feedback are then removed. A block that existed before stays; a temporary block is removed on success. File attachments are retained. Example: DELETE /agent/v1/agents/agent_example/customers/cus_8f2a91?confirm=cus_8f2a91.`,
+    http: "DELETE",
+    path: "/agent/v1/agents/{agent_id}/customers/{customer_id}",
+    streaming: "no",
+    pagination: false,
+    pathParams: [
+      {
+        name: "agent_id",
+        sdkName: "agent_id",
+        description: "Active service agent id from agent creation or listing."
+      },
+      {
+        name: "customer_id",
+        sdkName: "customer_id",
+        description: "Customer id from customer listing, or your own customer_id."
+      }
+    ],
+    query: [
+      {
+        name: "confirm",
+        type: "string",
+        required: true,
+        description: "Must equal the customer_id path parameter exactly, confirming the destructive deletion."
+      }
+    ]
+  },
+  {
+    resource: "agent.agents.customers",
+    method: "retrieve",
+    summary: "Get customer",
+    description: `Retrieve one customer of a service agent with its twenty most recently updated sessions.
+
+Use the customer id from the list or your own customer_id. An unknown customer returns 404 CUSTOMER_NOT_FOUND, and so does a customer access token. Unlike Shopify, an identified customer's session_count, cost and recent_sessions include the sessions of anonymous customers merged into it; the merged anonymous customer still shows its own sessions and its merged_into.`,
+    http: "GET",
+    path: "/agent/v1/agents/{agent_id}/customers/{customer_id}",
+    streaming: "no",
+    pagination: false,
+    pathParams: [
+      {
+        name: "agent_id",
+        sdkName: "agent_id",
+        description: "Active service agent id from agent creation or listing."
+      },
+      {
+        name: "customer_id",
+        sdkName: "customer_id",
+        description: "Customer id from customer listing, or your own customer_id."
+      }
+    ],
+    query: []
+  },
+  {
+    resource: "agent.agents.customers.block",
+    method: "create",
+    summary: "Block customer",
+    description: `Block a customer and end every sign-in it has on this agent.
+
+Blocks the customer, then ends every live sign-in the way logout does: each access token is revoked and its open event streams close. From then on grant_codes, access_tokens, renew and new sessions for this customer return CUSTOMER_BLOCKED until you unblock it. Idempotent: a repeat keeps the first block time and revokes whatever is still live. If credential revocation fails the request returns 502 and the customer stays blocked; retry to finish. An unknown customer returns 404 CUSTOMER_NOT_FOUND.`,
+    http: "POST",
+    path: "/agent/v1/agents/{agent_id}/customers/{customer_id}/block",
+    streaming: "no",
+    pagination: false,
+    pathParams: [
+      {
+        name: "agent_id",
+        sdkName: "agent_id",
+        description: "Active service agent id from agent creation or listing."
+      },
+      {
+        name: "customer_id",
+        sdkName: "customer_id",
+        description: "Customer id from customer listing, or your own customer_id."
+      }
+    ],
+    query: []
+  },
+  {
+    resource: "agent.agents.customers",
+    method: "retrieveDeletion",
+    summary: "Get customer deletion",
+    description: `Poll the latest deletion task of a customer, including after its data has been removed.
+
+Use the same agent_id and customer id as the confirmed DELETE. Status is pending, snapshotting, deleting, done or failed. Counts are empty until a verified snapshot exists. snapshot_key is an operator recovery reference retained for seven days, not a download URL. A customer access token and a missing task return 404.`,
+    http: "GET",
+    path: "/agent/v1/agents/{agent_id}/customers/{customer_id}/deletion",
+    streaming: "no",
+    pagination: false,
+    pathParams: [
+      {
+        name: "agent_id",
+        sdkName: "agent_id",
+        description: "Active service agent id from agent creation or listing."
+      },
+      {
+        name: "customer_id",
+        sdkName: "customer_id",
+        description: "Customer id from customer listing, or your own customer_id."
+      }
+    ],
+    query: []
+  },
+  {
+    resource: "agent.agents.customers.revokeTokens",
+    method: "create",
+    summary: "Revoke customer tokens",
+    description: `Sign a customer out everywhere without blocking it.
+
+Ends every live sign-in of the customer, revoking each access token and closing its open event streams; the customer can sign in again right away. Returns the number of access tokens this request revoked; a repeat returns 0. Credential revocation failure returns 502; retry to finish. An unknown customer returns 404 CUSTOMER_NOT_FOUND.`,
+    http: "POST",
+    path: "/agent/v1/agents/{agent_id}/customers/{customer_id}/revoke_tokens",
+    streaming: "no",
+    pagination: false,
+    pathParams: [
+      {
+        name: "agent_id",
+        sdkName: "agent_id",
+        description: "Active service agent id from agent creation or listing."
+      },
+      {
+        name: "customer_id",
+        sdkName: "customer_id",
+        description: "Customer id from customer listing, or your own customer_id."
+      }
+    ],
+    query: []
+  },
+  {
+    resource: "agent.agents.customers.unblock",
+    method: "create",
+    summary: "Unblock customer",
+    description: `Allow a blocked customer to sign in and start sessions again.
+
+Idempotent. Access tokens revoked while the customer was blocked stay revoked; sign the customer in again with a new grant code. An unknown customer returns 404 CUSTOMER_NOT_FOUND.`,
+    http: "POST",
+    path: "/agent/v1/agents/{agent_id}/customers/{customer_id}/unblock",
+    streaming: "no",
+    pagination: false,
+    pathParams: [
+      {
+        name: "agent_id",
+        sdkName: "agent_id",
+        description: "Active service agent id from agent creation or listing."
+      },
+      {
+        name: "customer_id",
+        sdkName: "customer_id",
+        description: "Customer id from customer listing, or your own customer_id."
+      }
+    ],
+    query: []
+  },
   {
     resource: "agent.agents.endUsers",
     method: "list",
@@ -18410,6 +18642,110 @@ var unblockEndUser = (options) => (options.client ?? client).post({
   url: "/agent/v1/agents/{agent_id}/end_users/{external_user_id}/unblock",
   ...options
 });
+var listCustomers = (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}/customers",
+  ...options
+});
+var deleteCustomer = (options) => (options.client ?? client).delete({
+  security: [{
+    key: "BearerAuth",
+    scheme: "bearer",
+    type: "http"
+  }, {
+    key: "ApiKeyAuth",
+    name: "X-API-Key",
+    type: "apiKey"
+  }],
+  url: "/agent/v1/agents/{agent_id}/customers/{customer_id}",
+  ...options
+});
+var getCustomer = (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}/customers/{customer_id}",
+  ...options
+});
+var getCustomerDeletion = (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}/customers/{customer_id}/deletion",
+  ...options
+});
+var blockCustomer = (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}/customers/{customer_id}/block",
+  ...options
+});
+var unblockCustomer = (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}/customers/{customer_id}/unblock",
+  ...options
+});
+var revokeCustomerTokens = (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}/customers/{customer_id}/revoke_tokens",
+  ...options
+});
+var getAgentAppearance = (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}/appearance",
+  ...options
+});
 var createCustomerGrantCode = (options) => (options.client ?? client).post({
   security: [{
     key: "BearerAuth",
@@ -24189,6 +24525,19 @@ function createAgent(transport) {
           grantCodes: {
             create: bind(transport, createCustomerGrantCode)
           }
+        },
+        block: {
+          create: bind(transport, blockCustomer)
+        },
+        delete: bind(transport, deleteCustomer),
+        list: bind(transport, listCustomers),
+        retrieve: bind(transport, getCustomer),
+        retrieveDeletion: bind(transport, getCustomerDeletion),
+        revokeTokens: {
+          create: bind(transport, revokeCustomerTokens)
+        },
+        unblock: {
+          create: bind(transport, unblockCustomer)
         }
       },
       endUsers: {
@@ -24208,6 +24557,7 @@ function createAgent(transport) {
       },
       list: bind(transport, agentsList),
       retrieve: bind(transport, agentsRetrieve),
+      retrieveAppearance: bind(transport, getAgentAppearance),
       unarchive: {
         create: bind(transport, unarchiveAgent)
       },
@@ -27041,7 +27391,7 @@ function startProgress(ctx, write = (text) => writeOutput({ stderr: text })) {
 }
 
 // src/main.ts
-var version = "0.1.1-dev.69cffcf";
+var version = "0.1.1-dev.78b913a";
 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.1-dev.69cffcf",
+  "version": "0.1.1-dev.78b913a",
   "type": "module",
   "bin": {
     "praxis": "dist/praxis.js"