@putdotio/cli 1.2.1 → 1.2.3

package/README.md

@@ -44,7 +44,7 @@ curl -fsSL https://raw.githubusercontent.com/putdotio/putio-cli/main/install.sh
 npm install --global @putdotio/cli
 ```
 
-Node `24.14+`
+Node `>=24.14 <25`
 
 Verify:
 
@@ -73,7 +73,7 @@ If `putio` is not installed, follow the install instructions in the repository R
 https://github.com/putdotio/putio-cli/blob/main/README.md
 
 After install, run:
-putio describe
+putio describe --output json
 putio auth status --profile devs-fe-auto --output json
 
 If auth is missing, start login with:
@@ -96,7 +96,7 @@ Rules:
 Inspect the live contract:
 
 ```bash
-putio describe
+putio describe --output json
 ```
 
 Link your account:

package/dist/bin.mjs

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
-import { A as CliOutputLive, F as CliRuntime, I as CliRuntimeLive, L as translate, M as isStructuredOutputMode, N as renderJson, O as CliSdkLive, P as CliConfigLive, R as version, a as searchCommand, c as brandCommand, g as CliStateLive, i as filesCommand, j as detectOutputModeFromArgv, k as CliOutput, l as versionCommand, n as whoamiCommand, o as eventsCommand, r as transfersCommand, s as downloadLinksCommand, t as describeCli, u as makeAuthCommand } from "./metadata-B7hMX4g9.mjs";
+import { A as CliSdkLive, B as translate, F as renderJson, I as writeOutput, L as CliConfigLive, M as CliOutputLive, N as detectOutputModeFromArgv, P as isStructuredOutputMode, R as CliRuntime, V as version, a as searchCommand, c as brandCommand, d as getOption, f as outputOption, i as filesCommand, j as CliOutput, l as versionCommand, n as whoamiCommand, o as eventsCommand, r as transfersCommand, s as downloadLinksCommand, t as describeCli, u as makeAuthCommand, v as CliStateLive, z as CliRuntimeLive } from "./metadata-CSXfRQuw.mjs";
 import { Cause, Console, Effect, Layer, Result } from "effect";
 import { CliError, Command } from "effect/unstable/cli";
 import { NodeRuntime, NodeServices } from "@effect/platform-node";
 //#region src/cli.ts
 const authCommand = makeAuthCommand();
-const describeCommand = Command.make("describe", {}, () => Console.log(renderJson(describeCli())));
+const describeCommand = Command.make("describe", { output: outputOption }, ({ output }) => writeOutput(describeCli(), getOption(output), renderJson));
 const command = Command.make("putio", {}, () => Console.log(translate("cli.root.help"))).pipe(Command.withSubcommands([
 	describeCommand,
 	brandCommand,
@@ -107,13 +107,24 @@ const executableName = (value) => {
 	const normalized = value.replaceAll("\\", "/");
 	return normalized.slice(normalized.lastIndexOf("/") + 1).toLowerCase();
 };
+const isNodeExecutable = (value) => {
+	const name = executableName(value);
+	return name === "node" || name === "node.exe";
+};
+const isPutioExecutable = (value) => {
+	const name = executableName(value);
+	return name === "putio" || name === "putio.exe" || name === "bin.mjs";
+};
+const stripLeadingPutioExecutables = (args) => {
+	let start = 0;
+	while (isPutioExecutable(args[start] ?? "")) start++;
+	return args.slice(start);
+};
 const commandArgsFromArgv = (args) => {
 	const [first] = args;
 	if (first === void 0) return args;
-	const firstName = executableName(first);
-	if (firstName === "node" || firstName === "node.exe") return args.slice(2);
-	if (firstName === "putio" || firstName === "putio.exe" || firstName === "bin.mjs") return args.slice(1);
-	return args;
+	if (isNodeExecutable(first)) return stripLeadingPutioExecutables(args.slice(2));
+	return stripLeadingPutioExecutables(args);
 };
 function runCli(args) {
 	const run = Command.runWith(command, { version });

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { C as loadPersistedState, D as useProfile, E as savePersistedState, S as listProfiles, T as resolveAuthState, _ as PutioCliConfigSchema, b as clearPersistedState, d as AuthProfileListSchema, f as AuthProfileSummarySchema, g as CliStateLive, h as CliState, m as AuthStatusSchema, p as AuthStateError, t as describeCli, v as PutioCliProfileConfigSchema, w as removeProfile, x as getAuthStatus, y as ResolvedAuthStateSchema } from "./metadata-B7hMX4g9.mjs";
+import { C as getAuthStatus, D as resolveAuthState, E as removeProfile, O as savePersistedState, S as clearPersistedState, T as loadPersistedState, _ as CliState, b as PutioCliProfileConfigSchema, g as AuthStatusSchema, h as AuthStateError, k as useProfile, m as AuthProfileSummarySchema, p as AuthProfileListSchema, t as describeCli, v as CliStateLive, w as listProfiles, x as ResolvedAuthStateSchema, y as PutioCliConfigSchema } from "./metadata-CSXfRQuw.mjs";
 export { AuthProfileListSchema, AuthProfileSummarySchema, AuthStateError, AuthStatusSchema, CliState, CliStateLive, PutioCliConfigSchema, PutioCliProfileConfigSchema, ResolvedAuthStateSchema, clearPersistedState, describeCli, getAuthStatus, listProfiles, loadPersistedState, removeProfile, resolveAuthState, savePersistedState, useProfile };

package/dist/{metadata-B7hMX4g9.mjs → metadata-CSXfRQuw.mjs}

@@ -13,7 +13,7 @@ import * as FileSystem from "effect/FileSystem";
 import { PlatformError, SystemError } from "effect/PlatformError";
 //#region package.json
 var name = "@putdotio/cli";
-var version = "1.2.1";
+var version = "1.2.3";
 //#endregion
 //#region src/i18n/translate.ts
 const resources = { en: { translation: {
@@ -372,100 +372,6 @@ const createTranslator = (locale = "en") => {
 };
 const translate = createTranslator();
 //#endregion
-//#region src/internal/agent-dx.ts
-const AgentDxCategoryNameSchema = Schema.Literals([
-	"machineReadableOutput",
-	"rawPayloadInput",
-	"schemaIntrospection",
-	"contextWindowDiscipline",
-	"inputHardening",
-	"safetyRails",
-	"agentKnowledgePackaging"
-]);
-const AgentDxDimensionSchema = Schema.Struct({
-	maxScore: Schema.Literal(3),
-	name: AgentDxCategoryNameSchema,
-	score: Schema.Number,
-	summary: Schema.String
-});
-const AgentDxScorecardSchema = Schema.Struct({
-	dimensions: Schema.Array(AgentDxDimensionSchema),
-	maxScore: Schema.Literal(21),
-	provenance: Schema.Literal("metadata-derived"),
-	summary: Schema.String,
-	totalScore: Schema.Number
-});
-const commandHasFlag = (command, flagName) => command.input.flags.some((flag) => flag.name === flagName);
-const cursorReadCommands = [
-	"files list",
-	"files search",
-	"search",
-	"transfers list"
-];
-const streamingReadCommands = [...cursorReadCommands, "transfers watch"];
-const scoreAgentDx = (input) => {
-	const writeCommands = input.commands.filter((command) => command.kind === "write");
-	const readCommands = input.commands.filter((command) => command.kind === "read");
-	const dimensions = [
-		{
-			maxScore: 3,
-			name: "machineReadableOutput",
-			score: input.output.defaultNonInteractive === "json" && input.output.supported.includes("json") && input.output.supported.includes("ndjson") ? 3 : input.output.supported.includes("json") ? 2 : 1,
-			summary: "Structured JSON is the non-interactive default, and NDJSON is available for streaming read flows."
-		},
-		{
-			maxScore: 3,
-			name: "rawPayloadInput",
-			score: writeCommands.length > 0 && writeCommands.every((command) => command.capabilities.rawJsonInput && command.input.json !== void 0) ? 3 : writeCommands.some((command) => command.capabilities.rawJsonInput) ? 2 : 0,
-			summary: "Every mutating command accepts raw --json input and advertises its payload contract in describe."
-		},
-		{
-			maxScore: 3,
-			name: "schemaIntrospection",
-			score: input.commands.every((command) => command.purpose.length > 0 && Array.isArray(command.input.flags) && (!command.capabilities.rawJsonInput || command.input.json !== void 0)) ? 3 : 2,
-			summary: "Describe exposes command purpose, flags, defaults, choices, capabilities, and raw JSON shapes."
-		},
-		{
-			maxScore: 3,
-			name: "contextWindowDiscipline",
-			score: readCommands.every((command) => command.capabilities.fieldSelection) && cursorReadCommands.every((commandName) => {
-				const command = input.commands.find((candidate) => candidate.command === commandName);
-				return command !== void 0 && command.capabilities.streaming && commandHasFlag(command, "page-all");
-			}) && streamingReadCommands.every((commandName) => {
-				const command = input.commands.find((candidate) => candidate.command === commandName);
-				return command !== void 0 && command.capabilities.streaming;
-			}) ? 3 : 2,
-			summary: "Read commands support field filtering broadly, and cursor-backed reads plus watch flows expose streaming-friendly output."
-		},
-		{
-			maxScore: 3,
-			name: "inputHardening",
-			score: input.commands.some((command) => command.input.flags.some((flag) => flag.name === "fields" && flag.description?.includes("rejects") === true)) && writeCommands.some((command) => command.input.json?.kind === "object" && command.input.json.rules) ? 2 : 1,
-			summary: "The CLI rejects malformed selectors and unsafe identifier-like inputs before API calls, though there is still room to deepen the boundary model."
-		},
-		{
-			maxScore: 3,
-			name: "safetyRails",
-			score: writeCommands.every((command) => command.capabilities.dryRun) ? 2 : 1,
-			summary: "Mutating commands offer dry-run planning across the surface, but the CLI does not yet add stronger confirmation or policy layers beyond that."
-		},
-		{
-			maxScore: 3,
-			name: "agentKnowledgePackaging",
-			score: input.hasConsumerSkill ? 2 : 0,
-			summary: "The repo ships a dedicated consumer skill with progressive disclosure references, even though it is still a single skill rather than a broader skill library."
-		}
-	];
-	const totalScore = dimensions.reduce((total, dimension) => total + dimension.score, 0);
-	return {
-		dimensions: [...dimensions],
-		maxScore: 21,
-		provenance: "metadata-derived",
-		summary: "This score is derived from described command metadata and documented agent surfaces, not from a full runtime conformance audit.",
-		totalScore
-	};
-};
-//#endregion
 //#region src/internal/constants.ts
 const PUTIO_CLI_APP_ID = "8993";
 //#endregion
@@ -3853,7 +3759,7 @@ const commandCatalog = decodeCommandSpecs([
 			streaming: false
 		},
 		command: "describe",
-		input: { flags: [] },
+		input: { flags: [outputFlag()] },
 		kind: "utility",
 		purpose: translate("cli.metadata.describe")
 	},
@@ -3876,8 +3782,25 @@ const PersistedProfileShapeSchema = Schema.Struct({
 	api_base_url: ConfigStringFieldSchema,
 	auth_token: ConfigStringFieldSchema
 });
+const SupportedOutputModeSchema = Schema.Literals([
+	"json",
+	"text",
+	"ndjson"
+]);
+const AutomationContractSchema = Schema.Struct({
+	consumerSkillLibrary: Schema.Boolean,
+	defaultNonInteractiveOutput: Schema.Literal("json"),
+	dryRunForWrites: Schema.Boolean,
+	fieldSelectionForReads: Schema.Boolean,
+	rawJsonInputForWrites: Schema.Boolean,
+	schemaIntrospection: Schema.Boolean,
+	secretRedaction: Schema.Boolean,
+	streamingReadCommands: Schema.Array(NonEmptyStringSchema),
+	supportedOutputModes: Schema.Array(SupportedOutputModeSchema),
+	untrustedTextAnnotations: Schema.Boolean
+});
 const CliMetadataSchema = Schema.Struct({
-	agentDx: AgentDxScorecardSchema,
+	automation: AutomationContractSchema,
 	auth: Schema.Struct({
 		apiBaseUrlEnv: NonEmptyStringSchema,
 		envPrecedence: Schema.Array(NonEmptyStringSchema),
@@ -3905,25 +3828,28 @@ const CliMetadataSchema = Schema.Struct({
 	version: NonEmptyStringSchema
 });
 const decodeCliMetadata = Schema.decodeUnknownSync(CliMetadataSchema);
+const makeAutomationContract = () => {
+	const readCommands = commandCatalog.filter((command) => command.kind === "read");
+	const writeCommands = commandCatalog.filter((command) => command.kind === "write");
+	return {
+		consumerSkillLibrary: true,
+		defaultNonInteractiveOutput: "json",
+		dryRunForWrites: writeCommands.every((command) => command.capabilities.dryRun),
+		fieldSelectionForReads: readCommands.every((command) => command.capabilities.fieldSelection),
+		rawJsonInputForWrites: writeCommands.every((command) => command.capabilities.rawJsonInput),
+		schemaIntrospection: true,
+		secretRedaction: true,
+		streamingReadCommands: commandCatalog.filter((command) => command.capabilities.streaming).map((command) => command.command),
+		supportedOutputModes: [
+			"json",
+			"text",
+			"ndjson"
+		],
+		untrustedTextAnnotations: true
+	};
+};
 const describeCli = () => decodeCliMetadata({
-	agentDx: scoreAgentDx({
-		commands: commandCatalog,
-		hasConsumerSkill: true,
-		output: {
-			defaultInteractive: "text",
-			defaultNonInteractive: "json",
-			internalRenderers: [
-				"json",
-				"terminal",
-				"ndjson"
-			],
-			supported: [
-				"json",
-				"text",
-				"ndjson"
-			]
-		}
-	}),
+	automation: makeAutomationContract(),
 	auth: {
 		apiBaseUrlEnv: ENV_API_BASE_URL,
 		envPrecedence: [ENV_CLI_TOKEN],
@@ -3982,4 +3908,4 @@ const describeCli = () => decodeCliMetadata({
 	version
 });
 //#endregion
-export { CliOutputLive as A, loadPersistedState as C, useProfile as D, savePersistedState as E, CliRuntime as F, CliRuntimeLive as I, translate as L, isStructuredOutputMode as M, renderJson as N, CliSdkLive as O, CliConfigLive as P, version as R, listProfiles as S, resolveAuthState as T, PutioCliConfigSchema as _, searchCommand as a, clearPersistedState as b, brandCommand as c, AuthProfileListSchema as d, AuthProfileSummarySchema as f, CliStateLive as g, CliState as h, filesCommand as i, detectOutputModeFromArgv as j, CliOutput as k, versionCommand as l, AuthStatusSchema as m, whoamiCommand as n, eventsCommand as o, AuthStateError as p, transfersCommand as r, downloadLinksCommand as s, describeCli as t, makeAuthCommand as u, PutioCliProfileConfigSchema as v, removeProfile as w, getAuthStatus as x, ResolvedAuthStateSchema as y };
+export { CliSdkLive as A, translate as B, getAuthStatus as C, resolveAuthState as D, removeProfile as E, renderJson as F, writeOutput as I, CliConfigLive as L, CliOutputLive as M, detectOutputModeFromArgv as N, savePersistedState as O, isStructuredOutputMode as P, CliRuntime as R, clearPersistedState as S, loadPersistedState as T, version as V, CliState as _, searchCommand as a, PutioCliProfileConfigSchema as b, brandCommand as c, getOption as d, outputOption as f, AuthStatusSchema as g, AuthStateError as h, filesCommand as i, CliOutput as j, useProfile as k, versionCommand as l, AuthProfileSummarySchema as m, whoamiCommand as n, eventsCommand as o, AuthProfileListSchema as p, transfersCommand as r, downloadLinksCommand as s, describeCli as t, makeAuthCommand as u, CliStateLive as v, listProfiles as w, ResolvedAuthStateSchema as x, PutioCliConfigSchema as y, CliRuntimeLive as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@putdotio/cli",
-  "version": "1.2.1",
+  "version": "1.2.3",
   "description": "Agent-first CLI for the put.io API.",
   "homepage": "https://github.com/putdotio/putio-cli#readme",
   "bugs": {
@@ -34,7 +34,7 @@
     "check": "vp check .",
     "coverage": "vp test --coverage",
     "dev": "vp pack --watch",
-    "prepare": "./scripts/prepare-effect.sh",
+    "prepare": "node ./scripts/prepare-effect.mts",
     "prepack": "vp pack",
     "smoke:pack": "node ./scripts/smoke-packed-install.mts",
     "test": "vp test",