@kodycodes/cli 1.18.0 → 1.19.0

package/dist/structured-error.js

@@ -0,0 +1,57 @@
+/**
+ * Agent-facing structured errors for local testing (design 2026-10-13).
+ * Stable `code`, optional `where` / `fix`, and which `target` produced it.
+ */
+export class StructuredCliError extends Error {
+    code;
+    target;
+    where;
+    fix;
+    details;
+    constructor(body) {
+        super(formatStructuredErrorMessage(body));
+        this.name = 'StructuredCliError';
+        this.code = body.code;
+        this.target = body.target;
+        this.where = body.where;
+        this.fix = body.fix;
+        this.details = body.details;
+    }
+    toJSON() {
+        return {
+            code: this.code,
+            message: stripStructuredPrefix(this.message),
+            ...(this.target !== undefined ? { target: this.target } : {}),
+            ...(this.where !== undefined ? { where: this.where } : {}),
+            ...(this.fix !== undefined ? { fix: this.fix } : {}),
+            ...(this.details !== undefined ? { details: this.details } : {}),
+        };
+    }
+}
+export function formatStructuredErrorMessage(body) {
+    const lines = [`[${body.code}] ${body.message}`];
+    if (body.target)
+        lines.push(`target: ${body.target}`);
+    if (body.where)
+        lines.push(`where: ${body.where}`);
+    if (body.fix)
+        lines.push(`fix: ${body.fix}`);
+    return lines.join('\n');
+}
+function stripStructuredPrefix(message) {
+    const match = /^\[([^\]]+)\]\s*/.exec(message);
+    if (!match)
+        return message;
+    return message.slice(match[0].length).split('\n')[0] ?? message;
+}
+export function notImplementedInMock(input) {
+    return new StructuredCliError({
+        code: 'not_implemented_in_mock',
+        message: `The CLI mock does not implement ${input.operation}.`,
+        target: 'mock',
+        fix: input.fix ??
+            `Use \`--target prod\` for this operation, or extend the mock. The mock refuses anything it does not implement rather than faking success.`,
+        details: { operation: input.operation },
+    });
+}
+//# sourceMappingURL=structured-error.js.map

package/dist/structured-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-error.js","sourceRoot":"","sources":["../src/structured-error.ts"],"names":[],"mappings":"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"}

package/dist/target.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Shared `--target prod|mock` for `dev`, `execute`, `invoke`, and `search`.
+ *
+ * Defaults (Kent-approved design 2026-10-13):
+ * - `kody dev` → `mock` (safe iteration; unpublished code never touches real secrets)
+ * - `execute` / `search` (and invoke via execute) → `prod` (preserve existing behavior)
+ *
+ * Override with `--target` or `KODY_TARGET`.
+ */
+export declare const targetEnvVar = "KODY_TARGET";
+export type KodyTarget = 'prod' | 'mock';
+export type TargetAwareCommand = 'dev' | 'execute' | 'search';
+/** Default target when neither flag nor env is set. */
+export declare function defaultTargetFor(command: TargetAwareCommand): KodyTarget;
+/**
+ * Resolve the active target. Precedence: `--target` flag → `KODY_TARGET` → command default.
+ */
+export declare function resolveTarget(input: {
+    command: TargetAwareCommand;
+    flag?: string;
+    env?: NodeJS.ProcessEnv;
+}): KodyTarget;
+export declare function parseTargetFlag(value: string): KodyTarget;
+/** True when this command accepts `--target` / `KODY_TARGET`. */
+export declare function commandAcceptsTarget(command: string): command is TargetAwareCommand;

package/dist/target.js

@@ -0,0 +1,45 @@
+/**
+ * Shared `--target prod|mock` for `dev`, `execute`, `invoke`, and `search`.
+ *
+ * Defaults (Kent-approved design 2026-10-13):
+ * - `kody dev` → `mock` (safe iteration; unpublished code never touches real secrets)
+ * - `execute` / `search` (and invoke via execute) → `prod` (preserve existing behavior)
+ *
+ * Override with `--target` or `KODY_TARGET`.
+ */
+export const targetEnvVar = 'KODY_TARGET';
+/** Default target when neither flag nor env is set. */
+export function defaultTargetFor(command) {
+    switch (command) {
+        case 'dev':
+            return 'mock';
+        case 'execute':
+        case 'search':
+            return 'prod';
+        default: {
+            const exhaustive = command;
+            throw new Error(`Unhandled command for target default: ${String(exhaustive)}`);
+        }
+    }
+}
+/**
+ * Resolve the active target. Precedence: `--target` flag → `KODY_TARGET` → command default.
+ */
+export function resolveTarget(input) {
+    const raw = input.flag ?? input.env?.[targetEnvVar];
+    if (raw === undefined || raw === '') {
+        return defaultTargetFor(input.command);
+    }
+    return parseTargetFlag(raw);
+}
+export function parseTargetFlag(value) {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === 'prod' || normalized === 'mock')
+        return normalized;
+    throw new Error(`\`--target\` must be \`prod\` or \`mock\` (got ${JSON.stringify(value)}). Example: \`kody execute --target mock --local --code '…'\`.`);
+}
+/** True when this command accepts `--target` / `KODY_TARGET`. */
+export function commandAcceptsTarget(command) {
+    return command === 'dev' || command === 'execute' || command === 'search';
+}
+//# sourceMappingURL=target.js.map

package/dist/target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.js","sourceRoot":"","sources":["../src/target.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAA;AAMzC,uDAAuD;AACvD,MAAM,UAAU,gBAAgB,CAAC,OAA2B;IAC3D,QAAQ,OAAO,EAAE,CAAC;QACjB,KAAK,KAAK;YACT,OAAO,MAAM,CAAA;QACd,KAAK,SAAS,CAAC;QACf,KAAK,QAAQ;YACZ,OAAO,MAAM,CAAA;QACd,OAAO,CAAC,CAAC,CAAC;YACT,MAAM,UAAU,GAAU,OAAO,CAAA;YACjC,MAAM,IAAI,KAAK,CAAC,yCAAyC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;QAC/E,CAAC;IACF,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAI7B;IACA,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,CAAA;IACnD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACrC,OAAO,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACvC,CAAC;IACD,OAAO,eAAe,CAAC,GAAG,CAAC,CAAA;AAC5B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa;IAC5C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAC7C,IAAI,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,MAAM;QAAE,OAAO,UAAU,CAAA;IACrE,MAAM,IAAI,KAAK,CACd,kDAAkD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,gEAAgE,CACvI,CAAA;AACF,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,oBAAoB,CAAC,OAAe;IACnD,OAAO,OAAO,KAAK,KAAK,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,QAAQ,CAAA;AAC1E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@kodycodes/cli",
-	"version": "1.18.0",
+	"version": "1.19.0",
 	"description": "Official Kody MCP client CLI: login, secure token storage, search, and execute.",
 	"type": "module",
 	"bin": {