@deepraxis/sdk 0.1.0-dev.449ac38 → 0.1.0-dev.67c7f3b

package/dist/operations.generated.js

@@ -61,7 +61,7 @@ export const operations = [
         "resource": "agent.agents",
         "method": "create",
         "summary": "Create agent",
-        "description": "Create a reusable agent definition, then pass its returned id to sessions.create to start a conversation. The definition includes model, system prompt, tools, MCP servers and an optional multiagent roster. It is saved as version 1; real updates create new versions. Unlike Anthropic Managed Agents, nonempty skills attachments and custom tool entries return 400; the native skill tool is separate from the skills field. Use tools: [{type: \"agent_toolset_20260401\"}] for built-in tools including codemode, skill and agent; inspect toolsets.list for names and schemas, and keep bash enabled for native additions. To offer only some tools, set default_config: {enabled: false} and list the tools to keep in configs, e.g. tools: [{type: \"agent_toolset_20260401\", default_config: {enabled: false}, configs: [{name: \"codemode\", enabled: true}, {name: \"bash\", enabled: true, permission_policy: {type: \"always_ask\"}}]}]; every tool not listed, including todo_write, enter_plan_mode, ask_user_question and goal_read, follows default_config, and the response echoes it. codemode runs through bash, so enabling codemode while bash is disabled returns 400. Optional mcp_toolset entries pair with mcp_servers. model accepts platform model IDs such as deepseek-flash, not only the Claude IDs in the protocol examples. model.settings.reasoning sets default thinking; other extra model controls return 400. Example: {\"name\":\"helper\",\"model\":{\"id\":\"deepseek-flash\"},\"tools\":[{\"type\":\"agent_toolset_20260401\"}]}.",
+        "description": "Create a reusable agent definition, then pass its returned id to sessions.create to start a conversation. The definition includes model, system prompt, tools, MCP servers and an optional multiagent roster. It is saved as version 1; real updates create new versions. Unlike Anthropic Managed Agents, nonempty skills attachments return 400; the native skill tool is separate from the skills field. Use tools: [{type: \"agent_toolset_20260401\"}] for built-in tools including codemode, skill and agent; inspect toolsets.list for names and schemas, and keep bash enabled for native additions. To offer only some tools, set default_config: {enabled: false} and list the tools to keep in configs, e.g. tools: [{type: \"agent_toolset_20260401\", default_config: {enabled: false}, configs: [{name: \"codemode\", enabled: true}, {name: \"bash\", enabled: true, permission_policy: {type: \"always_ask\"}}]}]; every tool not listed, including todo_write, enter_plan_mode, ask_user_question and goal_read, follows default_config, and the response echoes it. codemode runs through bash, so enabling codemode while bash is disabled returns 400. Optional mcp_toolset entries pair with mcp_servers. model accepts platform model IDs such as deepseek-flash, not only the Claude IDs in the protocol examples. model.settings.reasoning sets default thinking; other extra model controls return 400. Example: {\"name\":\"helper\",\"model\":{\"id\":\"deepseek-flash\"},\"tools\":[{\"type\":\"agent_toolset_20260401\"}]}.",
         "http": "POST",
         "path": "/agent/v1/agents",
         "streaming": "no",
@@ -207,7 +207,7 @@ export const operations = [
         "resource": "agent.agents",
         "method": "update",
         "summary": "Update agent",
-        "description": "Update an agent. Send the current version in the body for optimistic concurrency: a stale version returns 409, and an update that changes nothing keeps the version number. Any real change saves a new version; existing sessions keep the version they were created with. Omitted fields keep their value. multiagent takes null or a coordinator roster; subagent_model keeps its value when omitted and is cleared by null. Archived agents cannot be updated. Unlike Anthropic Managed Agents, nonempty skills attachments and custom tools return 400; use the native skill tool for available runtime skills.",
+        "description": "Update an agent. Send the current version in the body for optimistic concurrency: a stale version returns 409, and an update that changes nothing keeps the version number. Any real change saves a new version; existing sessions keep the version they were created with. Omitted fields keep their value. multiagent takes null or a coordinator roster; subagent_model keeps its value when omitted and is cleared by null. Archived agents cannot be updated. Unlike Anthropic Managed Agents, nonempty skills attachments return 400; use the native skill tool for available runtime skills.",
         "http": "POST",
         "path": "/agent/v1/agents/{agent_id}",
         "streaming": "no",
@@ -353,6 +353,175 @@ export const operations = [
         ],
         "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.\n\nOrdered 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": "delete",
+        "summary": "Delete end-user data",
+        "description": "Delete a host application's end-user data from one service agent after explicit confirmation.\n\nDevelop only. Set confirm to the exact external_user_id; missing or mismatched confirmation returns 400. Returns 202 with a pending task id, not completion. Poll the deletion endpoint. Concurrent requests reuse the unfinished task; retry DELETE after failure to resume it. Tokens are revoked and the user is blocked before a seven-day recovery snapshot is verified. Sessions including child sessions, conversation data, grants and feedback are then removed. A pre-existing block remains; a temporary block is removed on success. Attachment metadata is recorded and File attachments are retained. No charge is introduced by this operation. Example: DELETE /agent/v1/agents/agent_example/end_users/customer_123?confirm=customer_123.",
+        "http": "DELETE",
+        "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": [
+            {
+                "name": "confirm",
+                "type": "string",
+                "required": true,
+                "description": "Must exactly equal the external_user_id path parameter to confirm destructive deletion."
+            }
+        ]
+    },
+    {
+        "resource": "agent.agents.endUsers",
+        "method": "retrieve",
+        "summary": "Get End User",
+        "description": "Inspect one end user and their twenty most recently updated sessions.\n\nUse 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.\n\nMay 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",
+        "method": "retrieveDeletion",
+        "summary": "Get end-user deletion",
+        "description": "Poll the latest deletion task for an end user, including after the user data has been removed.\n\nUse the same agent_id and external_user_id as the confirmed DELETE. Status is pending, snapshotting, deleting, done or failed. Counts are empty until a verified snapshot exists. A failed task remains blocked and resumes when DELETE is retried with matching confirmation. snapshot_key is an operator recovery reference retained for seven days, not a public download URL. End-user credentials, inaccessible or personal agents, and missing tasks return 404. This read does not create a task or charge usage.",
+        "http": "GET",
+        "path": "/agent/v1/agents/{agent_id}/end_users/{external_user_id}/deletion",
+        "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.\n\nRevokes 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.\n\nRemoves 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",
@@ -548,7 +717,7 @@ export const operations = [
         "resource": "agent.computers",
         "method": "connect",
         "summary": "Connect computer",
-        "description": "Resume the computer and issue a sandbox connection.\n\nOwn-face extension: Managed Agents has no persistent Computer connection. Returns the public SDK sandbox_id, envd_access_token and template_id. Archived computers remain accessible; foreign or absent computers return 404. Never cache credentials.",
+        "description": "Resume the computer and issue a sandbox connection.\n\nOwn-face extension: Managed Agents has no persistent Computer connection. Returns the public SDK sandbox_id, envd_access_token and template_id, plus the machine tier the computer is on now (light or heavy) and the lease that keeps it there (lease_id, lease_expires_at; lease_id is null when no lease exists). Keep the lease while the connection stays open: renew it about every 20 seconds (POST .../leases/{lease_id}/renew) and release it on close (DELETE .../leases/{lease_id}). An unrenewed lease simply expires, and the full machine is reclaimed only after that. Archived computers remain accessible; foreign or absent computers return 404. Never cache credentials.",
         "http": "POST",
         "path": "/agent/v1/computers/{computer_id}/connect",
         "streaming": "no",
@@ -609,6 +778,48 @@ export const operations = [
             }
         ]
     },
+    {
+        "resource": "agent.computers.leases",
+        "method": "delete",
+        "summary": "Release computer lease",
+        "description": "Give the lease back when a connection closes so the full machine can be reclaimed without waiting for it to expire.\n\nOwn-face extension. Idempotent: an unknown or already released lease succeeds as well. Foreign or absent computers return 404.",
+        "http": "DELETE",
+        "path": "/agent/v1/computers/{computer_id}/leases/{lease_id}",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "computer_id",
+                "sdkName": "computer_id"
+            },
+            {
+                "name": "lease_id",
+                "sdkName": "lease_id"
+            }
+        ],
+        "query": []
+    },
+    {
+        "resource": "agent.computers.leases.renew",
+        "method": "create",
+        "summary": "Renew computer lease",
+        "description": "Extend the lease a connection holds so the full machine stays in service while the connection is open.\n\nOwn-face extension. A lease that is no longer valid (released, expired, or the computer moved to another machine) returns 409 LEASE_STALE; call connect again for a new connection and lease. Foreign or absent computers return 404.",
+        "http": "POST",
+        "path": "/agent/v1/computers/{computer_id}/leases/{lease_id}/renew",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [
+            {
+                "name": "computer_id",
+                "sdkName": "computer_id"
+            },
+            {
+                "name": "lease_id",
+                "sdkName": "lease_id"
+            }
+        ],
+        "query": []
+    },
     {
         "resource": "agent.deploymentRuns",
         "method": "list",
@@ -1026,6 +1237,41 @@ export const operations = [
         ],
         "query": []
     },
+    {
+        "resource": "agent.embed",
+        "method": "retrieveAppearance",
+        "summary": "Read chat appearance",
+        "description": "Load saved appearance for an iframe or Hosted chat page. Supply an end-user embed token as Bearer authorization, or a console-issued publishable key in Praxis-Publishable-Key before anonymous token issuance. The credential selects the agent; identity_number and agent_id query parameters are rejected with 400. Missing appearance returns an empty object. Kit option names retain camelCase. Responses are private and cacheable for 60 seconds. Component hosts configure Kit in their own code instead.",
+        "http": "GET",
+        "path": "/agent/v1/embed/appearance",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [],
+        "query": []
+    },
+    {
+        "resource": "agent.embed.exchange",
+        "method": "create",
+        "summary": "Exchange Hosted Code",
+        "description": "Redeem a single-use hosted link credential for an end-user token.\n\nRead code from the c fragment parameter of hosted_url returned by embed token creation with hosted true, then remove the fragment before exchanging. No Authorization header is required; the code authenticates this request. The code expires after 60 seconds and is consumed atomically on exchange, so concurrent attempts have only one winner. Expired, used and unknown codes return the same 404 body. Keep the token in memory and return to the host website for a fresh link when it expires; exchange cannot refresh it. Requests are IP limited per minute using the anonymous entrypoint budget (default 20). Example body is {\"code\":\"<code from hosted_url>\"}.",
+        "http": "POST",
+        "path": "/agent/v1/embed/exchange",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "code",
+                    "type": "string",
+                    "required": true,
+                    "description": "Single-use credential from the c fragment parameter of hosted_url returned by embed token creation. Valid for 60 seconds."
+                }
+            ]
+        }
+    },
     {
         "resource": "agent.embedTokens",
         "method": "list",
@@ -1067,7 +1313,7 @@ export const operations = [
         "resource": "agent.embedTokens",
         "method": "create",
         "summary": "Create Embed Token",
-        "description": "Issue a short-lived credential on your backend for an end user of a service agent.\n\nRequires an active service agent in your organization with an embed policy. Pins the requested version or the latest version and snapshots the policy environment, vaults and resources; metadata comes from the request. Blocked users cannot receive tokens. Keep your API key on the backend and pass only the returned token to the frontend. Every call creates a new grant; issuance is not idempotent. The hosted field is not supported.",
+        "description": "Issue a short-lived credential on your backend for an end user of a service agent.\n\nRequires an active service agent in your organization with an embed policy. Pins the requested version or the latest version and snapshots the policy environment, vaults and resources; metadata comes from the request. Blocked users cannot receive tokens. Keep your API key on the backend and pass only the returned token to the frontend. Every call creates a new grant; issuance is not idempotent. Set hosted to true to also receive hosted_url; redirect the user there within 60 seconds. The agent must have an identity_number. The URL fragment contains a single-use exchange credential, not the token. Omit hosted or set false for ordinary token issuance.",
         "http": "POST",
         "path": "/agent/v1/embed_tokens",
         "streaming": "no",
@@ -1077,6 +1323,12 @@ export const operations = [
         "body": {
             "required": true,
             "fields": [
+                {
+                    "name": "hosted",
+                    "type": "boolean",
+                    "required": false,
+                    "description": "Set true to also return a hosted chat URL with a single-use credential valid for 60 seconds. Defaults to false; the agent must have an identity_number."
+                },
                 {
                     "name": "agent",
                     "type": "string",
@@ -1136,6 +1388,35 @@ export const operations = [
             ]
         }
     },
+    {
+        "resource": "agent.embedTokens.anonymous",
+        "method": "create",
+        "summary": "Issue anonymous visitor token",
+        "description": "Obtain a short-lived embedding token for a visitor without an account using the agent owner's publishable key.\n\nNo Authorization header is required. Send the browser Origin allowed by the agent policy. Save a returned visitor_secret and reuse it for refreshes; only new visitors receive one. Unknown secrets create new visitors, and extra fields including visitor_id return 400. Issuance uses the key creator's organization membership, the key session budget and the smaller of the policy TTL maximum and 3600 seconds. IP requests are limited per minute (default 20); UTC daily session and spending caps are checked across the key's primary sessions created that day. Token issuance itself does not create a session or charge usage; subsequent sessions bill the host organization. Example body: {\"publishable_key\":\"pk_praxis_example\"}.",
+        "http": "POST",
+        "path": "/agent/v1/embed_tokens/anonymous",
+        "streaming": "no",
+        "pagination": false,
+        "pathParams": [],
+        "query": [],
+        "body": {
+            "required": true,
+            "fields": [
+                {
+                    "name": "publishable_key",
+                    "type": "string",
+                    "required": true,
+                    "description": "Public key created by the service agent owner; safe to include in browser code."
+                },
+                {
+                    "name": "visitor_secret",
+                    "type": "string",
+                    "required": false,
+                    "description": "Secret returned by a previous anonymous issuance for this key. Omit for a new visitor; an unknown secret creates a new visitor."
+                }
+            ]
+        }
+    },
     {
         "resource": "agent.embedTokens.revoke",
         "method": "create",
@@ -1810,7 +2091,7 @@ export const operations = [
         "resource": "agent.sessions.events",
         "method": "list",
         "summary": "List session events",
-        "description": "Read the event history of a session as a page of events, oldest first by default (order=desc for newest first). Use it after sending a message to collect the reply, to find tool calls that wait for approval (session.status_idle with stop_reason requires_action lists their event_ids), or to audit a run; to follow a running session live use sessions.events.stream instead. Filter by types and by a created_at range on processed_at; pages hold at most 100 events (default 20) and next_page continues. A failed run emits session.error before session.status_terminated. Native history also includes user.steer, user.withdraw, system.notification, session.forked, session.goal_changed and session.goal_verification; these are not accepted by the /anthropic/v1 event-type filter.",
+        "description": "Read the event history of a session as a page of events, oldest first by default (order=desc for newest first). Use it after sending a message to collect the reply, to find tool calls that wait for approval or client custom tool results (session.status_idle with stop_reason requires_action lists their event_ids), or to audit a run; to follow a running session live use sessions.events.stream instead. Filter by types and by a created_at range on processed_at; pages hold at most 100 events (default 20) and next_page continues. A failed run emits session.error before session.status_terminated. Native history also includes user.steer, user.withdraw, system.notification, session.forked, session.goal_changed and session.goal_verification; these are not accepted by the /anthropic/v1 event-type filter.",
         "http": "GET",
         "path": "/agent/v1/sessions/{session_id}/events",
         "streaming": "no",
@@ -1881,7 +2162,7 @@ export const operations = [
         "resource": "agent.sessions.events",
         "method": "send",
         "summary": "Send session events",
-        "description": "Send events to a session: user.message (exactly one nonempty text block), user.interrupt, user.tool_confirmation to allow or deny a pending tool call, user.steer to inject a queued user.message into a turn that is still running, and user.withdraw to retract a queued message. The response only acknowledges the inputs; read replies with sessions.events.list or sessions.events.stream. A message sent while the session waits for tool approval is queued (processed_at null) and runs in order after the approval is resolved. Archived sessions reject new messages. To approve, read a pending agent.tool_use or agent.mcp_tool_use event and send {type: \"user.tool_confirmation\", tool_use_id: <that event id>, result: \"allow\"} (or deny); include session_thread_id for a child approval. Native confirmations also accept updated_permissions, answers and annotations, which /anthropic/v1 rejects.",
+        "description": "Attach optional praxis_context={items:[{name,value}]} to user.message for untrusted page context on this turn only (maximum 32 items, 4096 UTF-8 JSON bytes). /anthropic/v1 rejects this field. Send events to a session: user.message (exactly one nonempty text block), user.interrupt, user.tool_confirmation to allow or deny a pending tool call, user.custom_tool_result to return a custom tool result, user.steer to inject a queued user.message into a turn that is still running, and user.withdraw to retract a queued message. The response only acknowledges the inputs; read replies with sessions.events.list or sessions.events.stream. A message sent while the session waits for tool approval is queued (processed_at null) and runs in order after the approval is resolved. Archived sessions reject new messages. To approve, read a pending agent.tool_use or agent.mcp_tool_use event and send {type: \"user.tool_confirmation\", tool_use_id: <that event id>, result: \"allow\"} (or deny); include session_thread_id for a child approval. Native confirmations also accept updated_permissions, answers and annotations, which /anthropic/v1 rejects. Both faces accept user.custom_tool_result with custom_tool_use_id from agent.custom_tool_use.id or the requires_action stop_reason.event_ids. Unlike Anthropic, result content accepts only text blocks (omit it for an empty array). Omitted or null is_error means false. The server routes child calls by id; session_thread_id is rejected in this input. Unknown call ids return 400; duplicate results or calls no longer waiting return 409.",
         "http": "POST",
         "path": "/agent/v1/sessions/{session_id}/events",
         "streaming": "no",