@deepraxis/cli 0.1.0-dev.06cf3b8 → 0.1.0-dev.13103a0

package/COMMANDS.md

@@ -2,7 +2,7 @@
 
 Generated by `bun run commands`. DO NOT EDIT.
 
-363 HTTP operations; 365 commands including aliases.
+365 HTTP operations; 367 commands including aliases.
 
 Environment: `PRAXIS_ENV=develop|production` (dev package defaults to `develop`; stable package defaults to `production`). No `--env` option.
 

package/dist/praxis.js

@@ -183,6 +183,17 @@ across all toolsets allowed.`
           type: "object",
           required: false,
           description: "Praxis extension: switchable model ids on /agent/v1 only. The default model must be included. When omitted, only the default model is selectable."
+        },
+        {
+          name: "preset",
+          type: "string",
+          enum: [
+            "minimal",
+            "data-editor",
+            "full"
+          ],
+          required: false,
+          description: "Optional tool preset. minimal enables read, glob, grep and ask_user_question; data-editor also enables write and edit; full uses the default toolset with always_allow. Explicit tools override matching preset entries. codemode requires bash and is absent from data-editor."
         }
       ]
     }
@@ -348,6 +359,17 @@ current version; omit to apply the update unconditionally.`
           type: "object",
           required: false,
           description: "Praxis extension: switchable model ids on /agent/v1 only. The default model must be included. When omitted, only the default model is selectable."
+        },
+        {
+          name: "preset",
+          type: "string",
+          enum: [
+            "minimal",
+            "data-editor",
+            "full"
+          ],
+          required: false,
+          description: "Optional tool preset. minimal enables read, glob, grep and ask_user_question; data-editor also enables write and edit; full uses the default toolset with always_allow. Explicit tools override matching preset entries. codemode requires bash and is absent from data-editor."
         }
       ]
     }
@@ -552,6 +574,23 @@ Removes the user from the blocklist; previously revoked tokens stay revoked. Ide
     ],
     query: []
   },
+  {
+    resource: "agent.agents.unarchive",
+    method: "create",
+    summary: "Unarchive Agent",
+    description: "Restore an archived agent without creating a configuration version. Already active agents are unchanged. Missing or inaccessible agents return 404. Use the returned agent id to create new sessions.",
+    http: "POST",
+    path: "/agent/v1/agents/{agent_id}/unarchive",
+    streaming: "no",
+    pagination: false,
+    pathParams: [
+      {
+        name: "agent_id",
+        sdkName: "agent_id"
+      }
+    ],
+    query: []
+  },
   {
     resource: "agent.agents.versions",
     method: "list",
@@ -1921,6 +1960,23 @@ offsets ("+08:00") and unknown names return 400. Never stored in
       ]
     }
   },
+  {
+    resource: "agent.sessions",
+    method: "delete",
+    summary: "Delete session",
+    description: "Delete an idle or terminated session and its event history after saving a deletion snapshot. Supply the session id from creation or listing. Running sessions return 409 INVALID_STATE: interrupt first or wait until idle or terminated. Afterwards retrieval and event listing return 404 and lists omit the session. Example: DELETE /agent/v1/sessions/sesn_example.",
+    http: "DELETE",
+    path: "/agent/v1/sessions/{session_id}",
+    streaming: "no",
+    pagination: false,
+    pathParams: [
+      {
+        name: "session_id",
+        sdkName: "session_id"
+      }
+    ],
+    query: []
+  },
   {
     resource: "agent.sessions",
     method: "retrieve",
@@ -3435,6 +3491,27 @@ Own-face extension. Use a readable session and a run_id from its events. Each su
     ],
     query: []
   },
+  {
+    resource: "application.workers.versions.assets",
+    method: "retrieveManifest",
+    summary: "Get version asset manifest",
+    description: "Read the retained asset paths, content hashes and byte sizes of a version for publication planning. This read creates no session or version. A version without assets returns an empty manifest; unavailable artifacts and foreign resources return 404.",
+    http: "GET",
+    path: "/application/v1/workers/{worker_id}/versions/{version_id}/assets/manifest",
+    streaming: "no",
+    pagination: false,
+    pathParams: [
+      {
+        name: "worker_id",
+        sdkName: "worker_id"
+      },
+      {
+        name: "version_id",
+        sdkName: "version_id"
+      }
+    ],
+    query: []
+  },
   {
     resource: "automation.actions",
     method: "list",
@@ -15429,6 +15506,19 @@ var createClient = (config = {}) => {
 var client = createClient(createConfig({ baseUrl: "https://api.deepraxis.com" }));
 
 // ../../packages/sdk/typescript/src/generated/sdk.gen.ts
+var unarchiveAgent = (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}/unarchive",
+  ...options
+});
 var deleteRunFeedback = (options) => (options.client ?? client).delete({
   security: [{
     key: "BearerAuth",
@@ -17028,7 +17118,7 @@ var runSandboxCommand = (options) => (options.client ?? client).post({
     ...options.headers
   }
 });
-var agentsList = (options) => (options?.client ?? client).get({
+var sessionsDelete = (options) => (options.client ?? client).delete({
   security: [{
     key: "BearerAuth",
     scheme: "bearer",
@@ -17038,10 +17128,10 @@ var agentsList = (options) => (options?.client ?? client).get({
     name: "X-API-Key",
     type: "apiKey"
   }],
-  url: "/agent/v1/agents",
+  url: "/agent/v1/sessions/{session_id}",
   ...options
 });
-var agentsCreate = (options) => (options.client ?? client).post({
+var sessionsRetrieve = (options) => (options.client ?? client).get({
   security: [{
     key: "BearerAuth",
     scheme: "bearer",
@@ -17051,14 +17141,27 @@ var agentsCreate = (options) => (options.client ?? client).post({
     name: "X-API-Key",
     type: "apiKey"
   }],
-  url: "/agent/v1/agents",
+  url: "/agent/v1/sessions/{session_id}",
+  ...options
+});
+var sessionsUpdate = (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}",
   ...options,
   headers: {
     "Content-Type": "application/json",
     ...options.headers
   }
 });
-var agentsRetrieve = (options) => (options.client ?? client).get({
+var agentsList = (options) => (options?.client ?? client).get({
   security: [{
     key: "BearerAuth",
     scheme: "bearer",
@@ -17068,10 +17171,10 @@ var agentsRetrieve = (options) => (options.client ?? client).get({
     name: "X-API-Key",
     type: "apiKey"
   }],
-  url: "/agent/v1/agents/{agent_id}",
+  url: "/agent/v1/agents",
   ...options
 });
-var agentsUpdate = (options) => (options.client ?? client).post({
+var agentsCreate = (options) => (options.client ?? client).post({
   security: [{
     key: "BearerAuth",
     scheme: "bearer",
@@ -17081,14 +17184,14 @@ var agentsUpdate = (options) => (options.client ?? client).post({
     name: "X-API-Key",
     type: "apiKey"
   }],
-  url: "/agent/v1/agents/{agent_id}",
+  url: "/agent/v1/agents",
   ...options,
   headers: {
     "Content-Type": "application/json",
     ...options.headers
   }
 });
-var agentsArchive = (options) => (options.client ?? client).post({
+var agentsRetrieve = (options) => (options.client ?? client).get({
   security: [{
     key: "BearerAuth",
     scheme: "bearer",
@@ -17098,10 +17201,10 @@ var agentsArchive = (options) => (options.client ?? client).post({
     name: "X-API-Key",
     type: "apiKey"
   }],
-  url: "/agent/v1/agents/{agent_id}/archive",
+  url: "/agent/v1/agents/{agent_id}",
   ...options
 });
-var agentsVersionsList = (options) => (options.client ?? client).get({
+var agentsUpdate = (options) => (options.client ?? client).post({
   security: [{
     key: "BearerAuth",
     scheme: "bearer",
@@ -17111,10 +17214,14 @@ var agentsVersionsList = (options) => (options.client ?? client).get({
     name: "X-API-Key",
     type: "apiKey"
   }],
-  url: "/agent/v1/agents/{agent_id}/versions",
-  ...options
+  url: "/agent/v1/agents/{agent_id}",
+  ...options,
+  headers: {
+    "Content-Type": "application/json",
+    ...options.headers
+  }
 });
-var sessionsList = (options) => (options?.client ?? client).get({
+var agentsArchive = (options) => (options.client ?? client).post({
   security: [{
     key: "BearerAuth",
     scheme: "bearer",
@@ -17124,10 +17231,10 @@ var sessionsList = (options) => (options?.client ?? client).get({
     name: "X-API-Key",
     type: "apiKey"
   }],
-  url: "/agent/v1/sessions",
+  url: "/agent/v1/agents/{agent_id}/archive",
   ...options
 });
-var sessionsCreate = (options) => (options.client ?? client).post({
+var agentsVersionsList = (options) => (options.client ?? client).get({
   security: [{
     key: "BearerAuth",
     scheme: "bearer",
@@ -17137,14 +17244,10 @@ var sessionsCreate = (options) => (options.client ?? client).post({
     name: "X-API-Key",
     type: "apiKey"
   }],
-  url: "/agent/v1/sessions",
-  ...options,
-  headers: {
-    "Content-Type": "application/json",
-    ...options.headers
-  }
+  url: "/agent/v1/agents/{agent_id}/versions",
+  ...options
 });
-var sessionsRetrieve = (options) => (options.client ?? client).get({
+var sessionsList = (options) => (options?.client ?? client).get({
   security: [{
     key: "BearerAuth",
     scheme: "bearer",
@@ -17154,10 +17257,10 @@ var sessionsRetrieve = (options) => (options.client ?? client).get({
     name: "X-API-Key",
     type: "apiKey"
   }],
-  url: "/agent/v1/sessions/{session_id}",
+  url: "/agent/v1/sessions",
   ...options
 });
-var sessionsUpdate = (options) => (options.client ?? client).post({
+var sessionsCreate = (options) => (options.client ?? client).post({
   security: [{
     key: "BearerAuth",
     scheme: "bearer",
@@ -17167,7 +17270,7 @@ var sessionsUpdate = (options) => (options.client ?? client).post({
     name: "X-API-Key",
     type: "apiKey"
   }],
-  url: "/agent/v1/sessions/{session_id}",
+  url: "/agent/v1/sessions",
   ...options,
   headers: {
     "Content-Type": "application/json",
@@ -17668,6 +17771,15 @@ var applicationCreateVersion = (options) => (options.client ?? client).post({
     ...options.headers
   }
 });
+var applicationGetVersionAssetManifest = (options) => (options.client ?? client).get({
+  security: [{
+    key: "application-bearerAuth",
+    scheme: "bearer",
+    type: "http"
+  }],
+  url: "/application/v1/workers/{worker_id}/versions/{version_id}/assets/manifest",
+  ...options
+});
 var applicationGetVersion = (options) => (options.client ?? client).get({
   security: [{
     key: "application-bearerAuth",
@@ -20505,6 +20617,9 @@ function createAgent(transport) {
       },
       list: bind(transport, agentsList),
       retrieve: bind(transport, agentsRetrieve),
+      unarchive: {
+        create: bind(transport, unarchiveAgent)
+      },
       update: bind(transport, agentsUpdate),
       versions: {
         list: bind(transport, agentsVersionsList)
@@ -20585,6 +20700,7 @@ function createAgent(transport) {
         list: bind(transport, listSessionCompactions)
       },
       create: bind(transport, sessionsCreate),
+      delete: bind(transport, sessionsDelete),
       events: {
         list: bind(transport, sessionsEventsList),
         send: bind(transport, sessionsEventsSend),
@@ -20666,6 +20782,9 @@ function createApplication(transport) {
       },
       update: bind(transport, applicationUpdateWorker),
       versions: {
+        assets: {
+          retrieveManifest: bind(transport, applicationGetVersionAssetManifest)
+        },
         create: bind(transport, applicationCreateVersion),
         list: bindPage(transport, applicationListVersions),
         retrieve: bind(transport, applicationGetVersion)
@@ -21616,6 +21735,10 @@ function base64(bytes) {
   return btoa(chunks.join(""));
 }
 async function publish(client2, input) {
+  const rolloutFields = ["gradual", "gradualRollout", "gradual_rollout", "canary", "rollout", "percentage", "percent", "traffic", "traffic_percentage", "strategy", "versions"];
+  if (Object.keys(input).some((key) => rolloutFields.includes(key) || /percentage|percent|canary|gradual|rollout|灰度/i.test(key))) {
+    throw new PraxisError({ code: "INVALID_PARAMS", message: '平台不支持灰度 (gradual rollout is not supported). Roll back with praxis.application.workers.deployments.create({ path: { worker_id }, body: { strategy: "percentage", versions: [{ version_id: previousVersionId, percentage: 100 }] } }); the previous version artifacts must still be retained.' });
+  }
   const timeout = input.timeout_ms ?? 120000;
   if (!Number.isFinite(timeout) || timeout < 0)
     throw new RangeError("timeout_ms must be non-negative and finite");
@@ -21634,7 +21757,7 @@ async function publish(client2, input) {
   const files = Object.entries(input.files);
   if (files.length > 1e5)
     throw new PraxisError({ code: "LIMIT_EXCEEDED", message: "At most 100000 asset paths can be published" });
-  const manifest = {};
+  let manifest = {};
   const contents = new Map;
   for (const [path2, content] of files) {
     const normalized = path2.startsWith("/") ? path2 : `/${path2}`;
@@ -21643,8 +21766,8 @@ async function publish(client2, input) {
     const bytes = typeof content === "string" ? new TextEncoder().encode(content) : new Uint8Array(content);
     if (bytes.length > FILE_BYTES)
       throw new PraxisError({ code: "LIMIT_EXCEEDED", message: `Asset ${normalized} exceeds 25 MiB` });
-    const digest = new Uint8Array(await crypto.subtle.digest("SHA-256", bytes));
-    const hash = Array.from(digest.subarray(0, 16), (byte) => byte.toString(16).padStart(2, "0")).join("");
+    const digest2 = new Uint8Array(await crypto.subtle.digest("SHA-256", bytes));
+    const hash = Array.from(digest2.subarray(0, 16), (byte) => byte.toString(16).padStart(2, "0")).join("");
     manifest[normalized] = { hash, size: bytes.length };
     contents.set(hash, bytes);
   }
@@ -21657,9 +21780,60 @@ async function publish(client2, input) {
     }
   }
   const created = !worker;
+  if (!worker && input.dryRun)
+    throw new PraxisError({ code: "NOT_FOUND", message: "请先创建应用 (create the application before dryRun)" });
   worker ??= await workers.create({ body: { name: input.name, subdomain: { enabled: true } } });
   const path = { worker_id: worker.id };
+  let currentVersion;
+  let currentDeployment;
+  let previous = {};
+  if (worker.praxis?.current_deployment_id) {
+    currentDeployment = await workers.deployments.retrieve({ path: { ...path, deployment_id: worker.praxis.current_deployment_id } });
+    const active = currentDeployment.versions[0];
+    if (!active)
+      throw new PraxisError({ code: "INVALID_RESPONSE", message: "Current deployment has no version" });
+    currentVersion = await workers.versions.retrieve({ path: { ...path, version_id: active.version_id } });
+    previous = (await workers.versions.assets.retrieveManifest({ path: { ...path, version_id: active.version_id } })).manifest;
+  }
+  manifest = {
+    ...Object.fromEntries(Object.entries(previous).filter(([key]) => input.keepExisting || Object.hasOwn(manifest, key))),
+    ...manifest
+  };
+  if (Object.keys(manifest).length > 1e5)
+    throw new PraxisError({ code: "LIMIT_EXCEEDED", message: "At most 100000 asset paths can be published" });
+  const added = Object.keys(manifest).filter((key) => !Object.hasOwn(previous, key));
+  const changed = Object.keys(manifest).filter((key) => previous[key] && (previous[key].hash !== manifest[key].hash || previous[key].size !== manifest[key].size));
+  const removed = Object.keys(previous).filter((key) => !Object.hasOwn(manifest, key));
+  const digest = new Uint8Array(await crypto.subtle.digest("SHA-256", new TextEncoder().encode(JSON.stringify(manifest))));
+  const manifestHash = Array.from(digest, (byte) => byte.toString(16).padStart(2, "0")).join("");
+  const staticOnly = !["main", "bindings", "compatibility_date", "compatibility_flags", "assets_config"].some((key) => Object.hasOwn(input, key));
+  const unchanged = staticOnly && !!currentVersion && manifestHash === currentVersion.praxis.assets_manifest?.manifest_hash;
+  const hashes = new Set(Object.values(manifest).map((entry) => entry.hash));
+  const currentResult = {
+    url: worker.subdomain.url,
+    worker_id: worker.id,
+    version_id: currentVersion?.id ?? null,
+    deployment_id: currentDeployment?.id ?? null,
+    status: currentDeployment?.praxis.status ?? "draft",
+    created,
+    ...currentVersion ? { version: currentVersion } : {},
+    unchanged,
+    uploaded: 0,
+    reused: hashes.size
+  };
+  if (unchanged && !input.dryRun)
+    return currentResult;
   const session = await workers.assetsUploadSession.create({ path, body: { manifest } });
+  if (input.dryRun) {
+    const missing = new Set(session.buckets.flat());
+    if ([...missing].some((hash) => !hashes.has(hash)))
+      throw new PraxisError({ code: "INVALID_RESPONSE", message: "Upload session requested an unknown hash" });
+    return {
+      ...currentResult,
+      reused: hashes.size - missing.size,
+      plan: { added, changed, removed, upload_hashes: missing.size, existing_hashes: hashes.size - missing.size }
+    };
+  }
   let jwt = session.buckets.length ? null : session.jwt;
   const uploaded = new Set;
   for (const bucket of session.buckets) {
@@ -21730,7 +21904,7 @@ async function publish(client2, input) {
     status: deployment.praxis.status,
     created,
     uploaded: uploaded.size,
-    reused: contents.size - uploaded.size
+    reused: hashes.size - uploaded.size
   };
 }
 
@@ -23280,7 +23454,7 @@ function startProgress(ctx, write = (text) => writeOutput({ stderr: text })) {
 }
 
 // src/main.ts
-var version = "0.1.0-dev.06cf3b8";
+var version = "0.1.0-dev.13103a0";
 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.06cf3b8",
+  "version": "0.1.0-dev.13103a0",
   "type": "module",
   "bin": {
     "praxis": "dist/praxis.js"