@khotan/cli 0.4.0 → 0.6.0

package/dist/khotan.js

@@ -19,7 +19,7 @@ var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 // ../khotan-core/src/version.ts
-var CATALOG_SCHEMA_VERSION = 1, CATALOG_VERSION = "2026-06-18", KHOTAN_ADAPTER_NAME = "khotan", KHOTAN_ADAPTER_VERSION = "0.4.0", SUPPORTED_CATALOG_SCHEMA_VERSIONS;
+var CATALOG_SCHEMA_VERSION = 1, CATALOG_VERSION = "2026-06-23", KHOTAN_ADAPTER_NAME = "khotan", KHOTAN_ADAPTER_VERSION = "0.6.0", SUPPORTED_CATALOG_SCHEMA_VERSIONS;
 var init_version = __esm(() => {
   SUPPORTED_CATALOG_SCHEMA_VERSIONS = [
     CATALOG_SCHEMA_VERSION
@@ -115,6 +115,12 @@ function platformDomain(config) {
   const idArg = idField(resourceParam, `The ${noun} id.`);
   const cap = domain;
   const a = article(noun);
+  const envWriteTargetField = {
+    name: "target",
+    location: "body",
+    type: "string[]",
+    description: "Environments to write, any of: production, preview, development (comma-separated or repeatable). Omit to write all environments."
+  };
   const tool = (suffix) => `khotan_${domain}_${suffix}`;
   const operations = [
     {
@@ -187,6 +193,19 @@ function platformDomain(config) {
       cli: { command: [domain, "redeploy"], summary: `Redeploy ${a} ${noun}`, defaultOutput: "detail" },
       mcp: { tool: { name: tool("redeploy"), title: `Redeploy ${a} ${noun}`, description: `Trigger a new deployment of ${a} ${noun}.` } }
     },
+    {
+      id: `${cap}.source`,
+      kind: "operation",
+      domain,
+      safety: "read",
+      auth: true,
+      title: `Download ${a} ${noun}'s source`,
+      description: `Download the ${noun}'s source files (its subdirectory in the org mono-root repo) as a JSON listing with paths rooted at the ${noun}. Text files come back utf-8, binary files base64.`,
+      input: [idArg],
+      http: { method: "GET", path: `${base}/{${resourceParam}}/source`, operationId: operationIds.source },
+      cli: { command: [domain, "source"], summary: `Download ${a} ${noun}'s source`, defaultOutput: "detail" },
+      mcp: { tool: { name: tool("source"), title: `Download ${a} ${noun}'s source`, description: `Download the ${noun}'s source files as a JSON listing. Text files utf-8, binary base64.` } }
+    },
     {
       id: `${cap}.env.list`,
       kind: "operation",
@@ -207,14 +226,15 @@ function platformDomain(config) {
       safety: "write",
       auth: true,
       title: `Bulk upsert ${noun} environment variables`,
-      description: `Create or update many env vars in one request.`,
+      description: `Create or update many env vars in one request. Writes every environment unless you pass target.`,
       input: [
         idArg,
-        { name: "variables", location: "body", type: "json", required: true, description: "Array of { key, value } to upsert." }
+        { name: "variables", location: "body", type: "json", required: true, description: "Array of { key, value } to upsert." },
+        envWriteTargetField
       ],
       http: { method: "POST", path: `${base}/{${resourceParam}}/env`, operationId: operationIds.envBulkSet, bodyMode: "json" },
       cli: { command: [domain, "env", "bulk-set"], summary: "Bulk upsert env vars" },
-      mcp: { tool: { name: tool("env_bulk_set"), title: "Bulk upsert env vars", description: "Create or update many env vars in one request." } }
+      mcp: { tool: { name: tool("env_bulk_set"), title: "Bulk upsert env vars", description: "Create or update many env vars in one request. Writes every environment unless target is provided." } }
     },
     {
       id: `${cap}.env.reveal`,
@@ -223,8 +243,17 @@ function platformDomain(config) {
       safety: "secret",
       auth: true,
       title: `Reveal one ${noun} environment variable value`,
-      description: `Reveal a single decrypted env var value. Secret-bearing; explicit-only.`,
-      input: [idArg, idField("key", "The env var key to reveal.")],
+      description: `Reveal a single decrypted env var value for one environment. Secret-bearing; explicit-only.`,
+      input: [
+        idArg,
+        idField("key", "The env var key to reveal."),
+        {
+          name: "target",
+          location: "query",
+          type: "string",
+          description: "Environment to read: production, preview, or development. Omit to default to production."
+        }
+      ],
       http: { method: "GET", path: `${base}/{${resourceParam}}/env/{key}`, operationId: operationIds.envReveal },
       cli: { command: [domain, "env", "reveal"], summary: "Reveal one env var value (secret)", defaultOutput: "raw" },
       mcp: { tool: { name: tool("env_reveal"), title: "Reveal one env var value (secret)", description: "Reveal one decrypted env var value. Secret-bearing — returns a credential, not a list." } }
@@ -236,15 +265,16 @@ function platformDomain(config) {
       safety: "write",
       auth: true,
       title: `Set one ${noun} environment variable`,
-      description: `Create or update one env var across all targets.`,
+      description: `Create or update one env var. Writes every environment unless you pass target.`,
       input: [
         idArg,
         idField("key", "The env var key."),
-        { name: "value", location: "body", type: "string", required: true, secret: true, description: "The env var value." }
+        { name: "value", location: "body", type: "string", required: true, secret: true, description: "The env var value." },
+        envWriteTargetField
       ],
       http: { method: "PUT", path: `${base}/{${resourceParam}}/env/{key}`, operationId: operationIds.envSet, bodyMode: "json" },
       cli: { command: [domain, "env", "set"], summary: "Set one env var" },
-      mcp: { tool: { name: tool("env_set"), title: "Set one env var", description: "Create or update one env var across all targets." } }
+      mcp: { tool: { name: tool("env_set"), title: "Set one env var", description: "Create or update one env var. Writes every environment unless target is provided." } }
     },
     {
       id: `${cap}.env.unset`,
@@ -253,11 +283,20 @@ function platformDomain(config) {
       safety: "destructive",
       auth: true,
       title: `Unset one ${noun} environment variable`,
-      description: `Delete one env var across all targets.`,
-      input: [idArg, idField("key", "The env var key to delete.")],
+      description: `Delete one env var. Removes it from every environment unless you pass target.`,
+      input: [
+        idArg,
+        idField("key", "The env var key to delete."),
+        {
+          name: "target",
+          location: "query",
+          type: "string",
+          description: "Environment to remove from: production, preview, or development. Omit to remove from all environments."
+        }
+      ],
       http: { method: "DELETE", path: `${base}/{${resourceParam}}/env/{key}`, operationId: operationIds.envDelete },
       cli: { command: [domain, "env", "unset"], summary: "Unset one env var" },
-      mcp: { tool: { name: tool("env_unset"), title: "Unset one env var", description: "Delete one env var across all targets. Requires confirmation." } }
+      mcp: { tool: { name: tool("env_unset"), title: "Unset one env var", description: "Delete one env var. Removes it from every environment unless target is provided. Requires confirmation." } }
     }
   ];
   const resource = {
@@ -907,6 +946,7 @@ var init_catalog = __esm(() => {
       create: "createApp",
       delete: "deleteApp",
       redeploy: "redeployApp",
+      source: "getAppSource",
       envList: "listAppEnvVars",
       envBulkSet: "bulkUpsertAppEnvVars",
       envReveal: "revealAppEnvVar",
@@ -925,6 +965,7 @@ var init_catalog = __esm(() => {
       create: "createPipeline",
       delete: "deletePipeline",
       redeploy: "redeployPipeline",
+      source: "getPipelineSource",
       envList: "listPipelineEnvVars",
       envBulkSet: "bulkUpsertPipelineEnvVars",
       envReveal: "revealPipelineEnvVar",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@khotan/cli",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "type": "module",
   "description": "Khotan CLI and MCP server: human- and agent-facing adapters over the Khotan /api/v1 surface.",
   "license": "SEE LICENSE IN LICENSE.md",