@politty/valibot 0.5.0 → 0.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (48) hide show
  1. package/README.md +6 -0
  2. package/dist/{argv-parser-NRwUusVy.js → argv-parser-Cz8IED8W.js} +1 -1
  3. package/dist/cli-main-Dt2zFNTU.js +1 -0
  4. package/dist/{cli-main-BcoGh-U_.js → cli-main-prrHozEB.js} +2 -2
  5. package/dist/cli-run-uv2kYRV8.js +1 -0
  6. package/dist/cli.js +1 -1
  7. package/dist/command-BXsTrIgI.js +1 -0
  8. package/dist/{completion-DCl24IUz.js → completion-BHfC_VJz.js} +1 -1
  9. package/dist/completion-CQFm_cbd.js +1 -0
  10. package/dist/completion.d.ts +2 -2
  11. package/dist/completion.js +1 -1
  12. package/dist/docs.d.ts +5 -5
  13. package/dist/docs.js +41 -41
  14. package/dist/dynamic-CpL0yvfn.js +1 -0
  15. package/dist/{dynamic-CmlJ0BBS.js → dynamic-F2u9XV-p.js} +1 -1
  16. package/dist/{field-meta-D9ySul7J.js → field-meta-CEtC5Mir.js} +1 -1
  17. package/dist/import-meta-resolve-DgKm4LYW.js +3 -0
  18. package/dist/index.d.ts +14 -3
  19. package/dist/index.js +1 -1
  20. package/dist/prompt-CNXUBjZA.js +1 -0
  21. package/dist/prompt-clack.d.ts +1 -1
  22. package/dist/prompt-clack.js +1 -1
  23. package/dist/prompt-inquirer.d.ts +1 -1
  24. package/dist/prompt-inquirer.js +1 -1
  25. package/dist/prompt.d.ts +1 -1
  26. package/dist/prompt.js +1 -1
  27. package/dist/{register-AMVOXtkb.js → register-BtPBdvwq.js} +1 -1
  28. package/dist/runner-Bc0bI0Eh.js +33 -0
  29. package/dist/runner-C9Wy5o8a.js +1 -0
  30. package/dist/{schema-C3FuGLp7.js → schema-CmhHwi3R.js} +1 -1
  31. package/dist/schema-extractor-BkbKiMq_.js +1 -0
  32. package/dist/skill.d.ts +1 -1
  33. package/dist/skill.js +1 -1
  34. package/dist/subcommand-router-iqmWGZyU.js +2 -0
  35. package/dist/{types-BvnlWosT.d.ts → types-Dhar1ua6.d.ts} +15 -1
  36. package/dist/{with-completion-command-Cbjaz6M5.js → with-completion-command-B2f3ns8A.js} +2 -2
  37. package/dist/{with-completion-command-B1lRgGGc.d.ts → with-completion-command-CARvhYvv.d.ts} +1 -1
  38. package/package.json +1 -1
  39. package/dist/cli-main-C3zTbAGt.js +0 -1
  40. package/dist/cli-run-TvaqHr70.js +0 -1
  41. package/dist/command-tLHaJHe6.js +0 -1
  42. package/dist/completion-v15TEHvM.js +0 -1
  43. package/dist/dynamic-DExEgytC.js +0 -1
  44. package/dist/prompt-CqmGq1_N.js +0 -1
  45. package/dist/runner-C0Jld3Vg.js +0 -1
  46. package/dist/runner-D0ibMa6Q.js +0 -30
  47. package/dist/schema-extractor-Cfy1t5nw.js +0 -1
  48. package/dist/subcommand-router-DR2KBQAt.js +0 -1
package/dist/prompt.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { F as ExtractedFields, I as ResolvedFieldMeta } from "./types-BvnlWosT.js";
1
+ import { F as ExtractedFields, I as ResolvedFieldMeta } from "./types-Dhar1ua6.js";
2
2
  //#region ../core/src/prompt/types.d.ts
3
3
  /**
4
4
  * Resolved prompt configuration for a single field
package/dist/prompt.js CHANGED
@@ -1 +1 @@
1
- import"./register-AMVOXtkb.js";import{i as e,n as t,r as n,t as r}from"./prompt-CqmGq1_N.js";export{n as getFieldsToPrompt,t as isInteractive,r as promptMissingArgs,e as resolvePromptConfig};
1
+ import"./register-BtPBdvwq.js";import{i as e,n as t,r as n,t as r}from"./prompt-CNXUBjZA.js";export{n as getFieldsToPrompt,t as isInteractive,r as promptMissingArgs,e as resolvePromptConfig};
@@ -1 +1 @@
1
- import{r as e,s as t}from"./field-meta-D9ySul7J.js";import{safeParse as n}from"valibot";const r=/* @__PURE__ */ new WeakMap;function i(e,t){return t&&r.set(e,t),e}function a(e){return r.get(e)}function o(e){return e}const s=/* @__PURE__ */ new Set([`optional`,`exact_optional`,`nullish`,`undefinedable`]),c=/* @__PURE__ */ new Set([`optional`,`exact_optional`,`nullish`,`undefinedable`,`nullable`,`non_optional`,`non_nullable`,`non_nullish`]);function l(e){let t=e;for(;t.type&&c.has(t.type)&&t.wrapped;)t=t.wrapped;return t}function u(e){let t=l(e),n=h(t.type);return n===`unknown`?d(t)?`boolean`:t.type===`unknown`||t.type===`any`?f(e)??`unknown`:`unknown`:n}function d(e){return e.type===`boolean`?!0:e.type===`literal`?typeof e.literal==`boolean`:e.type!==`union`||!e.options?.length?!1:e.options.every(d)}function f(e){if(Array.isArray(e.pipe))for(let t of e.pipe){if(t.kind===`schema`){let e=h(t.type);if(e!==`unknown`)return e}if(t.kind===`validation`&&m(t))return`number`}if(e.type&&c.has(e.type)&&e.wrapped)return f(e.wrapped)}const p=/* @__PURE__ */ new Set([`integer`,`safe_integer`,`finite`]);function m(e){return e.type?p.has(e.type)?!0:e.type===`multiple_of`&&typeof e.requirement==`number`:!1}function h(e){switch(e){case`string`:case`picklist`:case`enum`:return`string`;case`number`:return`number`;case`boolean`:return`boolean`;case`array`:return`array`;default:return`unknown`}}function g(e){let t=l(o(e)),n=e=>e.length>0&&e.every(e=>typeof e==`string`);if(t.type===`picklist`&&Array.isArray(t.options))return n(t.options)?t.options:void 0;if(t.type===`enum`){let e=Array.isArray(t.options)?t.options:t.enum&&typeof t.enum==`object`?Object.values(t.enum):[];return n(e)?e:void 0}if(t.type===`array`&&t.item)return g(t.item);if(t.type===`union`&&Array.isArray(t.options)){let e=[];for(let n of t.options){let t=o(n);t.type===`literal`&&typeof t.literal==`string`&&e.push(t.literal)}if(e.length===t.options.length&&e.length>0)return e}}function _(e){let t=e;for(;t.type&&c.has(t.type);){if(s.has(t.type))return!1;if(!t.wrapped)break;t=t.wrapped}return!0}function v(e){let t=e;for(;t?.type&&c.has(t.type);){if(t.default!==void 0)return typeof t.default==`function`?t.default():t.default;t=t.wrapped}}function y(e){if(Array.isArray(e.pipe)){let t;for(let n of e.pipe)n.kind===`metadata`&&n.type===`description`&&typeof n.description==`string`&&(t=n.description);if(t!==void 0)return t}if(e.type&&c.has(e.type)&&e.wrapped)return y(e.wrapped)}function b(e){let t;if(e.type&&c.has(e.type)&&e.wrapped&&(t=b(e.wrapped)),Array.isArray(e.pipe))for(let n of e.pipe)n.kind===`metadata`&&n.type===`metadata`&&n.metadata&&(t={...t,...n.metadata});return t}function x(e,t){if(t.has(e))return;t.add(e);let n=a(e);if(n)return n;if(Array.isArray(e.pipe)){for(let n of e.pipe)if(n&&n.kind===`schema`){let e=x(n,t);if(e)return e}}if(e.wrapped)return x(e.wrapped,t)}function S(e){let t=x(e,/* @__PURE__ */ new Set);if(t)return t;let n=b(e);if(n)return n}function C(t,n){let r=o(n);return e(t,{argMeta:S(r),description:y(r),required:_(r),defaultValue:v(r),type:u(r),enumValues:g(r),schema:n})}function w(e){switch(l(o(e)).type){case`strict_object`:return`strict`;case`loose_object`:case`object_with_rest`:return`passthrough`;default:return`strip`}}function T(e){let t=e.entries??{};return Object.entries(t).map(([e,t])=>C(e,t))}function E(e,t){let n=e.entries?.[t];if(!n)return``;let r=l(n);if(r.type===`literal`&&r.literal!==void 0)return String(r.literal);let i=g(r);return i&&i.length===1?i[0]:``}function D(e){let t=e.key??``,n=e.options??[],r=/* @__PURE__ */ new Map,i=[];for(let e of n){let n=o(e),a=[];for(let[e,t]of Object.entries(n.entries??{})){let n=C(e,t);a.push(n),r.has(e)||r.set(e,n)}let s=y(n);i.push({discriminatorValue:E(n,t),fields:a,...s?{description:s}:{}})}let a=y(e);return{fields:Array.from(r.values()),schema:e,schemaType:`discriminatedUnion`,unknownKeysMode:w(e),discriminator:t,variants:i,...a?{description:a}:{}}}function O(e){let t=e.options??[],n=/* @__PURE__ */ new Map,r=[];for(let e of t){let t=j(e);r.push(t);for(let e of t.fields)n.has(e.name)||n.set(e.name,e)}let i=y(e);return{fields:Array.from(n.values()),schema:e,schemaType:`union`,unknownKeysMode:w(e),unionOptions:r,...i?{description:i}:{}}}function k(e){let t=/* @__PURE__ */ new Map;for(let n of e.options??[]){let e=j(n);for(let n of e.fields)t.has(n.name)||t.set(n.name,n)}let n=y(e);return{fields:Array.from(t.values()),schema:e,schemaType:`intersection`,unknownKeysMode:w(e),...n?{description:n}:{}}}const A=/* @__PURE__ */ new WeakMap;function j(e){let t=A.get(e);if(t)return t;let n=l(o(e)),r;switch(n.type){case`object`:case`strict_object`:case`loose_object`:case`object_with_rest`:{let t=y(o(e));r={fields:T(n),schema:e,schemaType:`object`,unknownKeysMode:w(n),...t?{description:t}:{}};break}case`variant`:r={...D(n),schema:e};break;case`union`:r={...O(n),schema:e};break;case`intersect`:r={...k(n),schema:e};break;default:{let t=y(o(e));r={fields:[],schema:e,schemaType:`object`,unknownKeysMode:w(n),...t?{description:t}:{}};break}}return A.set(e,r),r}function M(e,t){return{path:t,message:e.message,code:e.type,received:e.input,expected:e.expected??void 0}}function N(e){if(e.kind!==`schema`||e.path?.length!==1)return;let[t]=e.path;return t?.origin===`key`?String(t.key):void 0}function P(e,t){let n=j(e).fields.find(e=>e.name===t);return n?.positional?`Missing required argument <${t}>`:`Missing required option --${n?.cliName??t}`}function F(e,t){return e.map(e=>{let n=e,r=n.path?.map(e=>String(e.key))??[],i=N(n);return i!==void 0&&n.message===`Invalid key: Expected "${i}" but received undefined`?M({...n,message:P(t,i)},r):M(n,r)})}function I(e,t){let r=n(t,e);return r.success?{success:!0,data:r.output}:{success:!1,errors:F(r.issues,t)}}t({vendor:`valibot`,extractFields:j,resolveFieldMeta:C,getUnknownKeysMode:w,validate:I});export{i as t};
1
+ import{r as e,s as t}from"./field-meta-CEtC5Mir.js";import{safeParse as n}from"valibot";const r=/* @__PURE__ */ new WeakMap;function i(e,t){return t&&r.set(e,t),e}function a(e){return r.get(e)}function o(e){return e}const s=/* @__PURE__ */ new Set([`optional`,`exact_optional`,`nullish`,`undefinedable`]),c=/* @__PURE__ */ new Set([`optional`,`exact_optional`,`nullish`,`undefinedable`,`nullable`,`non_optional`,`non_nullable`,`non_nullish`]);function l(e){let t=e;for(;t.type&&c.has(t.type)&&t.wrapped;)t=t.wrapped;return t}function u(e){let t=l(e),n=h(t.type);return n===`unknown`?d(t)?`boolean`:t.type===`unknown`||t.type===`any`?f(e)??`unknown`:`unknown`:n}function d(e){return e.type===`boolean`?!0:e.type===`literal`?typeof e.literal==`boolean`:e.type!==`union`||!e.options?.length?!1:e.options.every(d)}function f(e){if(Array.isArray(e.pipe))for(let t of e.pipe){if(t.kind===`schema`){let e=h(t.type);if(e!==`unknown`)return e}if(t.kind===`validation`&&m(t))return`number`}if(e.type&&c.has(e.type)&&e.wrapped)return f(e.wrapped)}const p=/* @__PURE__ */ new Set([`integer`,`safe_integer`,`finite`]);function m(e){return e.type?p.has(e.type)?!0:e.type===`multiple_of`&&typeof e.requirement==`number`:!1}function h(e){switch(e){case`string`:case`picklist`:case`enum`:return`string`;case`number`:return`number`;case`boolean`:return`boolean`;case`array`:return`array`;default:return`unknown`}}function g(e){let t=l(o(e)),n=e=>e.length>0&&e.every(e=>typeof e==`string`);if(t.type===`picklist`&&Array.isArray(t.options))return n(t.options)?t.options:void 0;if(t.type===`enum`){let e=Array.isArray(t.options)?t.options:t.enum&&typeof t.enum==`object`?Object.values(t.enum):[];return n(e)?e:void 0}if(t.type===`array`&&t.item)return g(t.item);if(t.type===`union`&&Array.isArray(t.options)){let e=[];for(let n of t.options){let t=o(n);t.type===`literal`&&typeof t.literal==`string`&&e.push(t.literal)}if(e.length===t.options.length&&e.length>0)return e}}function _(e){let t=e;for(;t.type&&c.has(t.type);){if(s.has(t.type))return!1;if(!t.wrapped)break;t=t.wrapped}return!0}function v(e){let t=e;for(;t?.type&&c.has(t.type);){if(t.default!==void 0)return typeof t.default==`function`?t.default():t.default;t=t.wrapped}}function y(e){if(Array.isArray(e.pipe)){let t;for(let n of e.pipe)n.kind===`metadata`&&n.type===`description`&&typeof n.description==`string`&&(t=n.description);if(t!==void 0)return t}if(e.type&&c.has(e.type)&&e.wrapped)return y(e.wrapped)}function b(e){let t;if(e.type&&c.has(e.type)&&e.wrapped&&(t=b(e.wrapped)),Array.isArray(e.pipe))for(let n of e.pipe)n.kind===`metadata`&&n.type===`metadata`&&n.metadata&&(t={...t,...n.metadata});return t}function x(e,t){if(t.has(e))return;t.add(e);let n=a(e);if(n)return n;if(Array.isArray(e.pipe)){for(let n of e.pipe)if(n&&n.kind===`schema`){let e=x(n,t);if(e)return e}}if(e.wrapped)return x(e.wrapped,t)}function S(e){let t=x(e,/* @__PURE__ */ new Set);if(t)return t;let n=b(e);if(n)return n}function C(t,n){let r=o(n);return e(t,{argMeta:S(r),description:y(r),required:_(r),defaultValue:v(r),type:u(r),enumValues:g(r),schema:n})}function w(e){switch(l(o(e)).type){case`strict_object`:return`strict`;case`loose_object`:case`object_with_rest`:return`passthrough`;default:return`strip`}}function T(e){let t=e.entries??{};return Object.entries(t).map(([e,t])=>C(e,t))}function E(e,t){let n=e.entries?.[t];if(!n)return``;let r=l(n);if(r.type===`literal`&&r.literal!==void 0)return String(r.literal);let i=g(r);return i&&i.length===1?i[0]:``}function D(e){let t=e.key??``,n=e.options??[],r=/* @__PURE__ */ new Map,i=[];for(let e of n){let n=o(e),a=[];for(let[e,t]of Object.entries(n.entries??{})){let n=C(e,t);a.push(n),r.has(e)||r.set(e,n)}let s=y(n);i.push({discriminatorValue:E(n,t),fields:a,...s?{description:s}:{}})}let a=y(e);return{fields:Array.from(r.values()),schema:e,schemaType:`discriminatedUnion`,unknownKeysMode:w(e),discriminator:t,variants:i,...a?{description:a}:{}}}function O(e){let t=e.options??[],n=/* @__PURE__ */ new Map,r=[];for(let e of t){let t=j(e);r.push(t);for(let e of t.fields)n.has(e.name)||n.set(e.name,e)}let i=y(e);return{fields:Array.from(n.values()),schema:e,schemaType:`union`,unknownKeysMode:w(e),unionOptions:r,...i?{description:i}:{}}}function k(e){let t=/* @__PURE__ */ new Map;for(let n of e.options??[]){let e=j(n);for(let n of e.fields)t.has(n.name)||t.set(n.name,n)}let n=y(e);return{fields:Array.from(t.values()),schema:e,schemaType:`intersection`,unknownKeysMode:w(e),...n?{description:n}:{}}}const A=/* @__PURE__ */ new WeakMap;function j(e){let t=A.get(e);if(t)return t;let n=l(o(e)),r;switch(n.type){case`object`:case`strict_object`:case`loose_object`:case`object_with_rest`:{let t=y(o(e));r={fields:T(n),schema:e,schemaType:`object`,unknownKeysMode:w(n),...t?{description:t}:{}};break}case`variant`:r={...D(n),schema:e};break;case`union`:r={...O(n),schema:e};break;case`intersect`:r={...k(n),schema:e};break;default:{let t=y(o(e));r={fields:[],schema:e,schemaType:`object`,unknownKeysMode:w(n),...t?{description:t}:{}};break}}return A.set(e,r),r}function M(e,t){return{path:t,message:e.message,code:e.type,received:e.input,expected:e.expected??void 0}}function N(e){if(e.kind!==`schema`||e.path?.length!==1)return;let[t]=e.path;return t?.origin===`key`?String(t.key):void 0}function P(e,t){let n=j(e).fields.find(e=>e.name===t);return n?.positional?`Missing required argument <${t}>`:`Missing required option --${n?.cliName??t}`}function F(e,t){return e.map(e=>{let n=e,r=n.path?.map(e=>String(e.key))??[],i=N(n);return i!==void 0&&n.message===`Invalid key: Expected "${i}" but received undefined`?M({...n,message:P(t,i)},r):M(n,r)})}function I(e,t){let r=n(t,e);return r.success?{success:!0,data:r.output}:{success:!1,errors:F(r.issues,t)}}t({vendor:`valibot`,extractFields:j,resolveFieldMeta:C,getUnknownKeysMode:w,validate:I});export{i as t};
@@ -0,0 +1,33 @@
1
+ import{a as e,i as t,n,o as r,t as i}from"./field-meta-CEtC5Mir.js";import{a,c as o,f as s,l as c,n as l,o as u,p as d,r as f,s as p,t as m}from"./schema-extractor-BkbKiMq_.js";import{t as h}from"./detect-agent-D7KSeWMh.js";import{n as g}from"./compile-cache-6u9hgeWu.js";import{a as _,c as v,f as y,i as ee,l as b,n as te,o as x,r as S,t as C,u as w}from"./subcommand-router-iqmWGZyU.js";import{n as T,r as E,t as D}from"./log-collector-uhRWYT-z.js";import{a as O,i as k}from"./logger-CoeDrmRr.js";import{a as ne,c as re,i as A,n as j,o as M,r as N,t as P}from"./argv-parser-Cz8IED8W.js";import{stripVTControlCharacters as ie}from"node:util";async function ae(e,t,n={}){let r,i,a=n.captureLogs??!1?D():null;a?.start();let o={args:t},s={args:t,error:r},c;n.handleSignals&&(c=async t=>{c&&(process.off(`SIGINT`,c),process.off(`SIGTERM`,c));let r=/* @__PURE__ */ Error(`Process interrupted`);if(s.error=r,e.cleanup)try{await e.cleanup(s)}catch(e){console.error(`Error during signal cleanup:`,e)}if(n.globalCleanup)try{await n.globalCleanup({error:r})}catch(e){console.error(`Error during global signal cleanup:`,e)}a?.stop(),process.stdout.writableNeedDrain&&await new Promise(e=>{let t=setTimeout(()=>{process.stdout.off(`drain`,n),e()},200),n=()=>{clearTimeout(t),e()};process.stdout.once(`drain`,n)}),process.exit(1)},process.on(`SIGINT`,c),process.on(`SIGTERM`,c));try{e.requiredPackages?.length&&await y(e.requiredPackages,t);for(let e of n.packageFields??[])e.requiredPackages?.length&&typeof t==`object`&&t&&e.name in t&&(n.packageDiscriminators?.includes(e.name)||t[e.name]===!0)&&await y(e.requiredPackages,t);e.setup&&await e.setup(o),e.run&&(i=await e.run(t))}catch(e){r=e instanceof Error?e:Error(String(e))}finally{c&&(process.off(`SIGINT`,c),process.off(`SIGTERM`,c))}if(e.cleanup){s.error=r;try{await e.cleanup(s)}catch(e){r||=e instanceof Error?e:Error(String(e))}}a?.stop();let l=n.existingLogs??T(),u=a?.getLogs()??T(),d=E(l,u);return r?{success:!1,error:r,exitCode:1,logs:d}:{success:!0,result:i,exitCode:0,logs:d}}function oe(e){return e<=31||e>=127&&e<=159||e>=768&&e<=879||e>=6832&&e<=6911||e>=7616&&e<=7679||e>=8400&&e<=8447||e>=65056&&e<=65071||e===8203||e>=8204&&e<=8207||e===65279||e>=65024&&e<=65039||e>=917760&&e<=917999}function se(e){return e>=4352&&e<=4447||e>=11904&&e<=12350||e>=12353&&e<=13311||e>=13312&&e<=19903||e>=19968&&e<=40959||e>=40960&&e<=42191||e>=43360&&e<=43391||e>=44032&&e<=55203||e>=63744&&e<=64255||e>=65040&&e<=65049||e>=65072&&e<=65135||e>=65280&&e<=65376||e>=65504&&e<=65510||e>=110592&&e<=110959||e>=127488&&e<=127569||e>=131072&&e<=262141||e>=9728&&e<=10175||e>=126976&&e<=129791}function ce(e){let t=!1,n=!1,r=!1;for(let i of e){let e=i.codePointAt(0);if(e===65039){r=!0;continue}oe(e)||(t=!0,se(e)&&(n=!0))}return t?n||r?2:1:0}const le=(()=>{try{return new Intl.Segmenter(`en`,{granularity:`grapheme`})}catch{return}})();function ue(e){if(e.length===0)return 0;let t=e.includes(`\x1B`)||e.includes(`›`)?ie(e):e,n=0;if(le)for(let{segment:e}of le.segment(t))n+=ce(e);else for(let e of t)n+=ce(e);return n}function F(e){let t=[],n=e.replace(/`([^`]+)`/g,(e,n)=>{let r=t.length;return t.push(k.cyan(n)),`\x00CODE${r}\x00`});return n=n.replace(/\*\*(.+?)\*\*/g,(e,t)=>k.bold(t)),n=n.replace(/__(.+?)__/g,(e,t)=>k.bold(t)),n=n.replace(/\*(.+?)\*/g,(e,t)=>k.italic(t)),n=n.replace(/(?<!\w)_(.+?)_(?!\w)/g,(e,t)=>k.italic(t)),n=n.replace(/\[([^\]]+)\]\(([^)]+)\)/g,(e,t,n)=>`${k.underline(t)} ${k.dim(`(${n})`)}`),n=n.replace(/\x00CODE(\d+)\x00/g,(e,n)=>t[Number(n)]),n}function de(e){return ve(e.split(`
2
+ `)).map(Ce).join(`
3
+
4
+ `)}const fe=/^(#{1,6})\s+(.+)$/,pe=/^(?:---+|\*\*\*+|___+)\s*$/,me=/^>\s?(.*)$/,I=/^-\s+(.+)$/,L=/^(\d+)[.)]\s+(.+)$/,he=/^(`{3,}|~{3,})(\S*)\s*$/,ge=/^\[!(NOTE|TIP|IMPORTANT|WARNING|CAUTION)\]\s*$/,R=/^\|(.+)\|$/,_e=/^\|(\s*:?-+:?\s*\|)+$/;function ve(e){let t=[],n=0;for(;n<e.length;){let r=e[n];if(r.trim()===``){n++;continue}let i=r.match(he);if(i){let r=i[1],a=i[2]??``,o=[];for(n++;n<e.length;){if(e[n].startsWith(r.charAt(0).repeat(r.length))&&e[n].trim()===r.charAt(0).repeat(Math.max(r.length,e[n].trim().length))){n++;break}o.push(e[n]),n++}t.push({type:`code`,lang:a,lines:o});continue}let a=r.match(fe);if(a){t.push({type:`heading`,level:a[1].length,content:a[2]}),n++;continue}if(pe.test(r)){t.push({type:`hr`}),n++;continue}if(me.test(r)){let r=[];for(;n<e.length;){let t=e[n].match(me);if(t)r.push(t[1]),n++;else break}if(r.length>0){let e=r[0].match(ge);if(e){let n=r.slice(1).filter(e=>e!==``);t.push({type:`alert`,alertType:e[1],lines:n});continue}}t.push({type:`blockquote`,lines:r});continue}if(I.test(r)){let r=[];for(;n<e.length;){let t=e[n].match(I);if(t)r.push(t[1]),n++;else break}t.push({type:`ul`,items:r});continue}let o=r.match(L);if(o){let r=Number(o[1]),i=[];for(;n<e.length;){let t=e[n].match(L);if(t)i.push(t[2]),n++;else break}t.push({type:`ol`,items:i,start:r});continue}if(R.test(r)&&n+1<e.length&&_e.test(e[n+1])){let i=ye(r),a=be(e[n+1]);n+=2;let o=[];for(;n<e.length&&R.test(e[n]);)o.push(ye(e[n])),n++;t.push({type:`table`,headers:i,alignments:a,rows:o});continue}let s=[];for(;n<e.length;){let t=e[n];if(t.trim()===``||fe.test(t)||pe.test(t)||me.test(t)||I.test(t)||L.test(t)||he.test(t)||R.test(t)&&n+1<e.length&&_e.test(e[n+1]))break;s.push(t),n++}s.length>0&&t.push({type:`paragraph`,lines:s})}return t}function ye(e){return e.slice(1,-1).split(`|`).map(e=>e.trim())}function be(e){return e.slice(1,-1).split(`|`).map(e=>{let t=e.trim();return t.startsWith(`:`)&&t.endsWith(`:`)?`center`:t.endsWith(`:`)?`right`:`left`})}function xe(e,t,n){let r=ue(e),i=Math.max(0,t-r);if(n===`right`)return` `.repeat(i)+e;if(n===`center`){let t=Math.floor(i/2);return` `.repeat(t)+e+` `.repeat(i-t)}return e+` `.repeat(i)}const Se={NOTE:{icon:`ℹ`,label:`Note`,styleFn:k.cyan},TIP:{icon:`💡`,label:`Tip`,styleFn:k.green},IMPORTANT:{icon:`❗`,label:`Important`,styleFn:k.magenta},WARNING:{icon:`⚠`,label:`Warning`,styleFn:k.yellow},CAUTION:{icon:`🔴`,label:`Caution`,styleFn:k.red}};function Ce(e){switch(e.type){case`heading`:return k.green(k.bold(F(e.content)));case`hr`:return k.dim(`─`.repeat(40));case`blockquote`:{let t=k.dim(`│ `);return e.lines.map(e=>`${t}${F(e)}`).join(`
5
+ `)}case`alert`:{let{icon:t,label:n,styleFn:r}=Se[e.alertType],i=r(k.bold(`│`))+` `,a=`${i}${r(t)} ${r(n)}`;return e.lines.length===0?a:`${a}\n${e.lines.map(e=>`${i}${F(e)}`).join(`
6
+ `)}`}case`ul`:return e.items.map(e=>`${k.dim(`•`)} ${F(e)}`).join(`
7
+ `);case`ol`:{let t=e.start+e.items.length-1,n=String(t).length;return e.items.map((t,r)=>{let i=String(e.start+r).padStart(n,` `);return`${k.dim(`${i}.`)} ${F(t)}`}).join(`
8
+ `)}case`table`:{let t=e.headers.length,n=e.headers.map(e=>F(e)),r=e.rows.map(e=>Array.from({length:t},(t,n)=>F(e[n]??``))),i=n.map((e,t)=>{let n=ue(e),i=r.map(e=>ue(e[t]));return Math.max(n,...i)}),a=k.dim(`│`),o=k.dim(`┌─${i.map(e=>`─`.repeat(e)).join(`─┬─`)}─┐`),s=k.dim(`├─${i.map(e=>`─`.repeat(e)).join(`─┼─`)}─┤`),c=k.dim(`└─${i.map(e=>`─`.repeat(e)).join(`─┴─`)}─┘`);return[o,`${a} ${n.map((t,n)=>k.bold(xe(t,i[n],e.alignments[n]??`left`))).join(` ${a} `)} ${a}`,s,...r.map(t=>{let n=t.map((t,n)=>xe(t,i[n],e.alignments[n]??`left`));return`${a} ${n.join(` ${a} `)} ${a}`}),c].join(`
9
+ `)}case`code`:return e.lines.map(e=>` ${k.yellow(e)}`).join(`
10
+ `);case`paragraph`:return F(e.lines.join(` `))}}const z={help:`Show help`,helpAll:`Show help with all subcommand options`,helpJson:`Show help as JSON`,version:`Show version`};function we(e){return!e.startsWith(`__`)}function B(e){return Object.entries(e).filter(([e])=>we(e))}function Te(e,t){return t?.rootName&&t.commandPath&&t.commandPath.length>0?t.commandPath.join(` `):e.name??`command`}function Ee(e,t){return t?.rootName&&t.commandPath&&t.commandPath.length>0?`${t.rootName} ${t.commandPath.join(` `)}`:e.name??`command`}function De(e,t){let n=[],r=Ee(e,t);n.push(k.commandName(r)),t?.globalExtracted?.fields.length&&n.push(k.placeholder(`[global options]`));let i=f(e);if(i){let t=o(i);p(i).length>0&&n.push(k.placeholder(`[options]`)),e.subCommands&&B(e.subCommands).length>0&&(e.run||e.defaultSubCommand?n.push(k.placeholder(`[command]`)):n.push(k.option(`<command>`)));for(let e of t)e.required?n.push(k.option(`<${e.name}>`)):n.push(k.placeholder(`[${e.name}]`))}else e.subCommands&&B(e.subCommands).length>0&&(e.run||e.defaultSubCommand?n.push(k.placeholder(`[command]`)):n.push(k.option(`<command>`)));return n.join(` `)}function Oe(e,t){let n=`${k.dim(`When`)} ${k.option(e)}=${k.bold(t.discriminatorValue)}:`;return t.description?`${n} ${t.description}`:n}function ke(e,t){return` ${k.bold(`${e.description??`Variant ${t+1}`}:`)}`}function Ae(e,t=0){let n=e.required?k.option(`<${e.name}>`):k.placeholder(`[${e.name}]`),r=e.named?`${n}, ${H(e)}`:n,i=[K(e),e.defaultValue===void 0?void 0:k.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)].filter(Boolean).join(` `);return i?W(r,i,t):`${` `.repeat(t)} ${r}`}function je(e){let t=f(e);if(!t)return``;let n=[];if(t.schemaType===`discriminatedUnion`&&t.discriminator){let e=t.discriminator;n=(t.variants??[]).map(t=>({label:Oe(e,t),fields:t.fields}))}else(t.schemaType===`union`||t.schemaType===`xor`)&&t.unionOptions&&(n=t.unionOptions.map((e,t)=>({label:ke(e,t),fields:e.fields})));let r=n.length>0?m(n):void 0,i=t.fields.filter(e=>e.positional&&(r===void 0||r.has(e.name))).map(e=>Ae(e));for(let e of n){let t=e.fields.filter(e=>e.positional&&!r?.has(e.name));t.length!==0&&i.push(``,e.label,...t.map(e=>Ae(e,1)))}return i.join(`
11
+ `)}function Me(e,t={},r){let i=[],a={help:t.help??z.help,helpAll:t.helpAll??z.helpAll,helpJson:t.helpJson??z.helpJson,version:t.version??z.version},o=f(e),s=o?.fields.some(e=>e.overrideBuiltinAlias===!0&&n(e).includes(`h`))??!1,c=o?.fields.some(e=>e.overrideBuiltinAlias===!0&&n(e).includes(`H`))??!1;if(s?i.push(W(k.option(`--help`),a.help)):i.push(W(`${k.option(`-h`)}, ${k.option(`--help`)}`,a.help)),c?i.push(W(k.option(`--help-all`),a.helpAll)):i.push(W(`${k.option(`-H`)}, ${k.option(`--help-all`)}`,a.helpAll)),i.push(W(k.option(`--help-json`),a.helpJson)),r?.rootVersion&&i.push(W(k.option(`--version`),a.version)),!o)return i.join(`
12
+ `);if(o.schemaType===`discriminatedUnion`&&o.discriminator)return Ne(o,e,i);if(o.schemaType===`union`&&o.unionOptions||o.schemaType===`xor`&&o.unionOptions)return Pe(o,e,i);let l=[],u=o.fields.filter(e=>!e.positional);for(let e of u){let t=H(e),n=K(e);e.defaultValue!==void 0&&(n+=` ${k.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)}`),e.required&&(n+=` ${k.required(`(required)`)}`);let r=U(e.env);r&&(n+=` ${r}`),l.push(W(t,n));let i=V(e);i&&l.push(i)}return l.push(...i),l.join(`
13
+ `)}function V(e,t=0,n=0){return!e.negationDisplay||!e.negationDescription?null:W(k.option(`--${e.negationDisplay}`),`${e.negationDescription} ${k.dim(`(↔ --${e.cliName})`)}`,t,n)}function Ne(e,t,n){let r=[],i=e.discriminator,a=e.variants??[],o=u(e,i);if(o){let t=a.map(e=>e.discriminatorValue).join(`|`),n=`${k.option(`--${i}`)} ${k.placeholder(`<${t}>`)}`,s=e.description??o.description??`Action to perform`;r.push(W(n,s))}let s=m(a,i);for(let t of s){let n=e.fields.find(e=>e.name===t);if(n&&!n.positional){let e=H(n),t=K(n);n.defaultValue!==void 0&&(t+=` ${k.defaultValue(`(default: ${JSON.stringify(n.defaultValue)})`)}`);let i=U(n.env);i&&(t+=` ${i}`),r.push(W(e,t));let a=V(n);a&&r.push(a)}}r.push(...n);for(let e of a){let t=e.fields.filter(e=>e.name!==i&&!s.has(e.name)&&!e.positional),n=b(e.fields.find(e=>e.name===i)?.requiredPackages);if(t.length>0||n){r.push(``),r.push(Oe(i,e)),n&&r.push(Le(n,2));for(let e of t){let t=H(e),n=K(e);e.defaultValue!==void 0&&(n+=` ${k.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)}`),e.required&&(n+=` ${k.required(`(required)`)}`);let i=U(e.env);i&&(n+=` ${i}`),r.push(W(t,n,1));let a=V(e,1);a&&r.push(a)}}}return r.join(`
14
+ `)}function Pe(e,t,n){let r=[],i=e.unionOptions??[],a=m(i);for(let t of a){let n=e.fields.find(e=>e.name===t);if(n&&!n.positional){let e=H(n),t=K(n);n.defaultValue!==void 0&&(t+=` ${k.defaultValue(`(default: ${JSON.stringify(n.defaultValue)})`)}`);let i=U(n.env);i&&(t+=` ${i}`),r.push(W(e,t));let a=V(n);a&&r.push(a)}}r.push(...n);for(let e=0;e<i.length;e++){let t=i[e];if(!t)continue;let n=t.fields.filter(e=>!a.has(e.name)&&!e.positional),o=ke(t,e);if(n.length>0){r.push(``),r.push(o);for(let e of n){let t=H(e),n=K(e);e.defaultValue!==void 0&&(n+=` ${k.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)}`),e.required&&(n+=` ${k.required(`(required)`)}`);let i=U(e.env);i&&(n+=` ${i}`),r.push(W(t,n,1));let a=V(e,1);a&&r.push(a)}}else r.push(``),r.push(o),r.push(` ${k.dim(k.italic(`no options`))}`)}return r.join(`
15
+ `)}function H(e){let t=[];if(e.alias)for(let n of e.alias)n.length===1&&t.push(k.option(`-${n}`));let n=k.option(`--${e.cliName}`);if(e.type!==`boolean`){let t=e.placeholder??e.cliName.toUpperCase();n+=` ${k.placeholder(`<${t}>`)}`}if(t.push(n),e.alias){for(let n of e.alias)if(n.length>1){let r=k.option(`--${n}`);if(e.type!==`boolean`){let t=e.placeholder??e.cliName.toUpperCase();r+=` ${k.placeholder(`<${t}>`)}`}t.push(r)}}let r=t.join(`, `);return e.type===`boolean`&&e.negationDisplay&&!e.negationDescription?`${r} / ${k.option(`--${e.negationDisplay}`)}`:r}function U(e){if(!e)return``;let t=Array.isArray(e)?e:[e];return k.dim(`[env: ${t.join(`, `)}]`)}function Fe(e){return e.replace(/\x1B\[[0-9;]*m/g,``)}function Ie(e,t){let n=Fe(e).length,r=Math.max(0,t-n);return e+` `.repeat(r)}function Le(e,t){if(!e.includes(`
16
+ `))return e;let n=` `.repeat(t);return e.split(`
17
+ `).join(`\n${n}`)}function W(e,t,n=0,r=0){let i=` `.repeat(n),a=Fe(e).length,o=32-n*2+r,s=o+2+n*2,c=Le(t,s);return a>=o?`${i} ${e}\n${` `.repeat(s)}${c}`:`${i} ${Ie(e,o)}${c}`}function Re(e,t=0,n=0){let r=H(e),i=K(e);e.defaultValue!==void 0&&(i+=` ${k.defaultValue(`(default: ${JSON.stringify(e.defaultValue)})`)}`),e.required&&(i+=` ${k.required(`(required)`)}`);let a=U(e.env);return a&&(i+=` ${a}`),W(r,i,t,n)}function ze(e){let t=[];for(let n of e.fields){if(n.positional)continue;t.push(Re(n));let e=V(n);e&&t.push(e)}return t.join(`
18
+ `)}function Be(e,t){let n=[],r=f(e);if(r){let e=r.fields.filter(e=>!e.positional);for(let r of e){let e=H(r),i=K(r);r.defaultValue!==void 0&&(i+=` ${k.defaultValue(`(default: ${JSON.stringify(r.defaultValue)})`)}`);let a=U(r.env);a&&(i+=` ${a}`),n.push(W(e,i,t,2));let o=V(r,t,2);o&&n.push(o)}}return n}function Ve(e,t,n){let r=[];for(let[i,a]of B(e)){let e=v(a),o=t?`${t} ${i}`:i,s=[e?.description,b(e?.requiredPackages)].filter(Boolean).join(`
19
+ `),c=e?.aliases,l=c&&c.length>0?`${o}, ${c.join(`, `)}`:o;if(r.push(W(k.command(l),s,n)),e){let t=Be(e,n+1);r.push(...t);let i=e.subCommands?Object.fromEntries(B(e.subCommands)):void 0;if(i&&Object.keys(i).length>0){let e=Ve(i,o,n);r.push(...e)}}}return r}function G(e,t){let n=[],r=t.context;t.agentHelp&&n.push(de(t.agentHelp));let i=Te(e,r);if(i){let e=k.commandName(i);r?.rootName&&r.commandPath&&r.commandPath.length>0?r.rootVersion?e+=` ${k.version(`(${r.rootName} v${r.rootVersion})`)}`:e+=` ${k.version(`(${r.rootName})`)}`:r?.rootVersion&&(e+=` ${k.version(`v${r.rootVersion}`)}`),n.push(e)}r?.aliasFor&&n.push(k.dim(`Alias for ${k.commandName(r.aliasFor)}`)),e.description&&n.push(e.description),!r?.aliasFor&&e.aliases&&e.aliases.length>0&&n.push(`${k.sectionHeader(`Aliases:`)} ${e.aliases.map(e=>k.command(e)).join(`, `)}`),n.push(`${k.sectionHeader(`Usage:`)} ${De(e,r)}`);let a=je(e);a&&n.push(`${k.sectionHeader(`Arguments:`)}\n${a}`);let o=Me(e,t.descriptions,r);if(o&&n.push(`${k.sectionHeader(`Options:`)}\n${o}`),r?.globalExtracted?.fields.length&&n.push(`${k.sectionHeader(`Global Options:`)}\n${ze(r.globalExtracted)}`),t.showSubcommands!==!1&&e.subCommands&&B(e.subCommands).length>0){let i=r?.commandPath?.join(` `)??``,a=Object.fromEntries(B(e.subCommands));if(t.showSubcommandOptions){let e=Ve(a,i,0);n.push(`${k.sectionHeader(`Commands:`)}\n${e.join(`
20
+ `)}`)}else{let e=[];for(let[t,n]of Object.entries(a)){let r=v(n),a=[r?.description,b(r?.requiredPackages)].filter(Boolean).join(`
21
+ `),o=i?`${i} ${t}`:t,s=r?.aliases,c=s&&s.length>0?`${o}, ${s.join(`, `)}`:o;e.push(W(k.command(c),a))}n.push(`${k.sectionHeader(`Commands:`)}\n${e.join(`
22
+ `)}`)}}if(e.examples&&e.examples.length>0){let t=Ue(e.examples,r);n.push(`${k.sectionHeader(`Examples:`)}\n${t}`)}let s=b(e.requiredPackages);if(s&&n.push(`${k.sectionHeader(`Required packages:`)}\n${s}`),e.notes){let t=de(e.notes).split(`
23
+ `).map(e=>e===``?``:` ${e}`).join(`
24
+ `);n.push(`${k.sectionHeader(`Notes:`)}\n${t}`)}return`\n${n.join(`
25
+
26
+ `)}\n`}function K(e){return[e.description,b(e.requiredPackages)].filter(Boolean).join(`
27
+ `)}function q(e){let t={name:e.name,cliName:e.cliName,positional:e.positional,named:e.named,required:e.required,type:e.type};return e.requiredPackages?.length&&(t.requiredPackages=e.requiredPackages.map(e=>({name:e.name,install:w(e)}))),e.alias&&(t.alias=e.alias),e.description!==void 0&&(t.description=e.description),e.placeholder!==void 0&&(t.placeholder=e.placeholder),e.env!==void 0&&(t.env=e.env),e.defaultValue!==void 0&&(t.defaultValue=e.defaultValue),e.enumValues!==void 0&&(t.enumValues=e.enumValues),e.negation!==void 0&&(t.negation=e.negation),e.negationDisplay!==void 0&&(t.negationDisplay=e.negationDisplay),e.negationDescription!==void 0&&(t.negationDescription=e.negationDescription),t}function He(e,t){let n=Ee(e,t),r=!!t?.globalExtracted?.fields.length,i=e.subCommands&&B(e.subCommands).length>0?e.run?`optional`:`required`:void 0,a=f(e);return{commandName:n,hasGlobalOptions:r,hasOptions:a?p(a).length>0:!1,subcommand:i,positionals:a?o(a).map(e=>({name:e.name,required:e.required})):[]}}function J(e,t={}){let n=t.context,r=n?.commandPath??[],i={help:t.descriptions?.help??z.help,helpAll:t.descriptions?.helpAll??z.helpAll,helpJson:t.descriptions?.helpJson??z.helpJson,...n?.rootVersion?{version:t.descriptions?.version??z.version}:{}},a=f(e),s,c=[],l=[],d,p,h;if(a){if(s=a.schemaType,c=o(a).map(q),a.schemaType===`discriminatedUnion`&&a.discriminator&&a.variants){let e=a.discriminator;d=e;let t=a.variants,n=m(t,e),r=u(a,e),i=a.fields.filter(e=>!e.positional&&n.has(e.name));l=[...r?[{...q({...r,requiredPackages:void 0}),description:a.description??r.description??`Action to perform`}]:[],...i.map(q)],p=t.map(t=>{let r=t.fields.find(t=>t.name===e);return{discriminatorValue:t.discriminatorValue,...r?.requiredPackages?.length?{requiredPackages:q(r).requiredPackages}:{},description:t.description,fields:t.fields.filter(t=>t.name!==e&&!n.has(t.name)).map(q)}})}else if((a.schemaType===`union`||a.schemaType===`xor`)&&a.unionOptions){let e=a.unionOptions,t=m(e);l=a.fields.filter(e=>!e.positional&&t.has(e.name)).map(q),h=e.map(e=>({description:e.description,fields:e.fields.filter(e=>!t.has(e.name)).map(q)}))}else l=a.fields.filter(e=>!e.positional).map(q)}let g=n?.globalExtracted?.fields.length?n.globalExtracted.fields.filter(e=>!e.positional).map(q):void 0,_;if(e.subCommands){let i=B(e.subCommands);i.length>0&&(_=i.map(([i,a])=>{let o=v(a);if(!o)return{name:i,unresolved:!0};let s={commandPath:[...r,i],rootName:n?.rootName??e.name,rootVersion:n?.rootVersion,globalExtracted:n?.globalExtracted};return{name:i,aliases:o.aliases,data:J(o,{descriptions:t.descriptions,context:s})}}))}return{name:e.name??`command`,commandPath:r,rootName:n?.rootName,version:n?.rootVersion,aliasFor:n?.aliasFor,description:e.description,aliases:e.aliases,usage:He(e,n),builtinOptions:i,schemaType:s,positionals:c,options:l,discriminator:d,variants:p,unionOptions:h,globalOptions:g,subcommands:_,examples:e.examples,notes:e.notes,...e.requiredPackages?.length?{requiredPackages:e.requiredPackages.map(e=>({name:e.name,install:w(e),description:e.description}))}:{},agentHelp:t.agentHelp}}function Ue(e,t){let n=[],r=t?.rootName?`${t.rootName} `:``,i=t?.commandPath?.join(` `)??``,a=i?`${r}${i} `:r;for(let t of e){if(n.push(` ${k.dim(t.desc).split(`
28
+ `).join(`
29
+ `)}`),n.push(` ${k.dim(`$`)} ${a}${t.cmd}`),t.output)for(let e of t.output.split(`
30
+ `))n.push(` ${e}`);n.push(``)}return n.length>0&&n[n.length-1]===``&&n.pop(),n.join(`
31
+ `)}var We=class extends Error{constructor(e){super(e),this.name=`PositionalConfigError`}},Ge=class extends Error{constructor(e){super(e),this.name=`ReservedAliasError`}},Ke=class extends Error{constructor(e){super(e),this.name=`DuplicateFieldError`}},qe=class extends Error{constructor(e){super(e),this.name=`DuplicateAliasError`}},Y=class extends Error{constructor(e){super(e),this.name=`CaseVariantCollisionError`}},Je=class extends Error{constructor(e){super(e),this.name=`DuplicateNegationError`}},Ye=class extends Error{constructor(e){super(e),this.name=`ReservedFieldNameError`}},Xe=class extends Error{constructor(e){super(e),this.name=`DefaultSubCommandError`}},Ze=class extends Error{constructor(e){super(e),this.name=`FieldTypeConflictError`}};function Qe(e,t){let n=[],r=/* @__PURE__ */ new Map;for(let i of e.fields)r.has(i.name)&&n.push({commandPath:t,type:`duplicate_field`,message:`Duplicate field name "${i.name}" detected.`,field:i.name}),r.set(i.name,i.name);return n}function $e(e,n){let r=[],i=/* @__PURE__ */ new Map;for(let a of e.fields){let e=t(a.name),o=i.get(e);o&&o!==a.name&&r.push({commandPath:n,type:`case_variant_collision`,message:`Fields "${o}" and "${a.name}" are case variants of each other and would collide.`,field:a.name}),i.set(e,a.name)}return r}function et(e,r){let i=[],a=/* @__PURE__ */ new Map,o=new Set(e.fields.map(e=>e.name)),s=new Set(e.fields.map(e=>e.cliName)),c=(e,t,n)=>{(o.has(e)||s.has(e))&&i.push({commandPath:r,type:`duplicate_alias`,message:`Alias "${e}" for field "${t}" conflicts with existing field name or CLI name "${e}".`,field:t});let c=a.get(e);if(c&&c!==t){let a=n?` (derived camelCase variant)`:``;i.push({commandPath:r,type:`duplicate_alias`,message:`Duplicate alias "${e}"${a} detected. Both "${c}" and "${t}" use the same alias.`,field:t})}a.set(e,t)};for(let r of e.fields){let e=n(r);if(e.length!==0){for(let n of e)if(c(n,r.name,!1),n.length>1&&n.includes(`-`)){let e=t(n);e!==n&&!o.has(e)&&c(e,r.name,!0)}}}return i}function tt(e,r){let i=[],a=/* @__PURE__ */ new Map,o=(e,t,n)=>{a.has(e)||a.set(e,{field:t,kind:n})};for(let r of e.fields){if(o(r.name,r.name,`field name`),r.name.includes(`-`)){let e=t(r.name);e!==r.name&&o(e,r.name,`field name`)}if(r.cliName!==r.name&&o(r.cliName,r.name,`CLI name`),r.cliName.includes(`-`)){let e=t(r.cliName);e!==r.cliName&&o(e,r.name,`CLI name`)}for(let e of n(r))if(o(e,r.name,`alias`),e.length>1&&e.includes(`-`)){let n=t(e);n!==e&&o(n,r.name,`alias`)}if(r.type===`boolean`&&r.negation===!0){let e=`no-${r.cliName}`;o(e,r.name,`default negation`);let n=t(r.cliName),i=`no${n[0]?.toUpperCase()??``}${n.slice(1)}`;i!==e&&o(i,r.name,`default negation`)}}let s=/* @__PURE__ */ new Map,c=(e,t,n)=>{let o=a.get(e);if(o){let a=n?` (derived camelCase variant)`:``,s=o.field===t?`the same field's own ${o.kind} "${e}"`:`${o.kind} "${e}" of field "${o.field}"`;i.push({commandPath:r,type:`duplicate_negation`,message:`Negation "${e}"${a} for field "${t}" conflicts with ${s}.`,field:t})}let c=s.get(e);if(c&&c!==t){let a=n?` (derived camelCase variant)`:``;i.push({commandPath:r,type:`duplicate_negation`,message:`Duplicate negation "${e}"${a} detected. Both "${c}" and "${t}" use the same negation name.`,field:t})}s.set(e,t)};for(let n of e.fields)if(typeof n.negation==`string`&&(c(n.negation,n.name,!1),n.negation.includes(`-`))){let e=t(n.negation);e!==n.negation&&c(e,n.name,!0)}return i}function nt(e,t){let n=[e,...e.variants??[],...e.unionOptions??[]],r=/* @__PURE__ */ new Set;return n.flatMap(e=>rt(e.fields,t)).filter(e=>!r.has(e.message)&&r.add(e.message))}function rt(e,t){let n=[],r=e.filter(e=>e.positional),i=null,a=null;for(let e of r)i!==null&&n.push({commandPath:t,type:`positional_config`,message:`Positional argument "${e.name}" cannot follow array positional argument "${i}".`,field:e.name}),e.type===`array`&&a!==null&&n.push({commandPath:t,type:`positional_config`,message:`Array positional "${e.name}" cannot be used with optional positional "${a}" (ambiguous parsing).`,field:e.name}),a!==null&&e.required&&n.push({commandPath:t,type:`positional_config`,message:`Required positional "${e.name}" cannot follow optional positional "${a}".`,field:e.name}),e.type===`array`&&(i=e.name),e.required||(a=e.name);return n}function it(e,t){let r=[];for(let a of e.fields){if(a.overrideBuiltinAlias!==!0)for(let e of n(a))(e===`h`||e===`H`)&&r.push({commandPath:t,type:`reserved_alias`,message:`Alias "${e}" is reserved for --${e===`h`?`help`:`help-all`}. To override this, set { overrideBuiltinAlias: true } for "${a.name}" and keep the alias where it is currently defined (in alias or hiddenAlias).`,field:a.name});let e=/* @__PURE__ */ new Set([a.cliName,...n(a)]);for(let n of e){if(!i.has(n))continue;let e=n===a.cliName;r.push({commandPath:t,type:`reserved_alias`,message:`${e?`Field "${a.name}"`:`Alias "${n}" for field "${a.name}"`} collides with the built-in --${n} option, which always takes precedence. Rename the field or its alias; this collision cannot be overridden.`,field:a.name})}}return r}function at(e,t){let n=[];for(let r of e.fields)r.name.startsWith(`$`)&&n.push({commandPath:t,type:`reserved_field_name`,message:`Field "${r.name}" starts with "$", which is reserved for framework-injected helpers (e.g. $source).`,field:r.name});return n}function ot(e){let t=Qe(e,[]);if(t.length>0)throw new Ke(`Duplicate field name "${t[0]?.field??`unknown`}" detected. Each field must have a unique name.`)}function st(e){let t=et(e,[]);if(t.length>0){let e=t[0];throw new qe(e.message)}}function ct(e){let t=nt(e,[]);if(t.length>0){let e=t[0];throw new We(e.message)}}function lt(e,t){let n=it(e,[]);if(n.length>0)throw new Ge(n[0].message)}function ut(e){let t=at(e,[]);if(t.length>0){let e=t[0];throw new Ye(e.message)}}function dt(e){let t=tt(e,[]);if(t.length>0){let e=t[0];throw new Je(e.message)}}function ft(e){let t=$e(e,[]);if(t.length>0){let e=t[0];throw new Y(e.message)}}function pt(e,t){if(e.type!==t.type||e.positional!==t.positional)return!1;let n=e.enumValues,r=t.enumValues;if(!n&&!r)return!0;if(!n||!r)return!1;let i=new Set(n),a=new Set(r);if(i.size!==a.size)return!1;for(let e of i)if(!a.has(e))return!1;return!0}function mt(e,n,r){let i=[],a=/* @__PURE__ */ new Map;for(let n of e.fields)a.set(t(n.name),n);for(let e of n.fields){let n=t(e.name),o=a.get(n);if(o){if(o.name!==e.name){i.push({commandPath:r,type:`case_variant_collision`,message:`Global field "${o.name}" and command field "${e.name}" are case variants of each other and would collide.`,field:e.name});continue}pt(o,e)||i.push({commandPath:r,type:`field_type_conflict`,message:`Global field "${o.name}" and command field "${e.name}" share the same name but have different definitions.`,field:e.name})}}return i}function ht(e,t){let n=mt(e,t,[])[0];if(n)throw n.type===`case_variant_collision`?new Y(n.message):new Ze(n.message)}function gt(e,t,n){return[...Qe(e,n),...$e(e,n),...et(e,n),...tt(e,n),...nt(e,n),...it(e,n),...at(e,n)]}function _t(e,t){let n=e,r=[];if(n.defaultSubCommand===void 0)return r;n.run&&r.push({commandPath:t,type:`default_subcommand_conflict`,message:`Command "${n.name}" defines both "run" and "defaultSubCommand". Define only one.`});let i=e.subCommands?Object.keys(e.subCommands):[];return i.includes(n.defaultSubCommand)||r.push({commandPath:t,type:`default_subcommand_not_found`,message:`defaultSubCommand "${n.defaultSubCommand}" does not match any subCommands key of "${n.name}". Registered: ${i.length>0?i.join(`, `):`(none)`}.`,field:n.defaultSubCommand}),r}function vt(e){let t=_t(e,[]);if(t.length>0)throw new Xe(t[0].message)}function yt(e,t){let n=[];if(!e.subCommands)return n;let r=/* @__PURE__ */ new Map;for(let[t]of Object.entries(e.subCommands))r.set(t,t);for(let[i,a]of Object.entries(e.subCommands)){let e=x(a)?a.meta:typeof a==`function`?null:a;if(!e?.aliases)continue;let o=[...t,i];for(let t of e.aliases){if(!/^[a-zA-Z0-9][a-zA-Z0-9_-]*$/.test(t)){n.push({commandPath:o,type:`invalid_alias`,message:`Alias "${t}" is invalid. Aliases must start with an alphanumeric character and contain only alphanumeric characters, hyphens, or underscores.`,field:i});continue}if(t===i){n.push({commandPath:o,type:`duplicate_alias`,message:`Alias "${t}" conflicts with its own name.`,field:i});continue}let e=r.get(t);e?e===i?n.push({commandPath:o,type:`duplicate_alias`,message:`Alias "${t}" is duplicated within the alias list.`,field:i}):n.push({commandPath:o,type:`duplicate_alias`,message:`Alias "${t}" conflicts with existing subcommand or alias "${e}".`,field:i}):r.set(t,i)}}return n}function bt(e,t,n){return e===t?[]:[{commandPath:[...n,e],type:`subcommand_key_name_mismatch`,message:`Subcommand registered as "${e}" but its own name is "${t}".`,field:e}]}async function xt(e,t={}){return St(e,t,!1)}async function St(e,t,n){n||=!!e.requiredPackages?.length;let r=t.commandPath??[e.name],i=[],a=e.subCommands?Object.keys(e.subCommands).length>0:!1,o=t.globalArgs?l(t.globalArgs):void 0;if(e.args){let t=l(e.args);i.push(...gt(t,a,r)),o&&i.push(...mt(o,t,r))}if(i.push(...yt(e,r)),i.push(..._t(e,r)),e.subCommands)for(let[a,o]of Object.entries(e.subCommands)){let e=await S(o,e=>n||!!e.requiredPackages?.length);i.push(...bt(a,e.name,r));let s=await St(e,{commandPath:[...r,a],...t.globalArgs?{globalArgs:t.globalArgs}:{}},n);s.valid||i.push(...s.errors)}return i.length===0?{valid:!0}:{valid:!1,errors:i}}function Ct(e){if(e.length===0)return``;let t=[`Command definition errors:`];for(let n of e){let e=n.commandPath.join(` > `);t.push(` - [${e}] ${n.message}`)}return t.join(`
32
+ `)}function wt(e){let{aliasMap:t=/* @__PURE__ */ new Map,booleanFlags:r=/* @__PURE__ */ new Set,definedNames:i=/* @__PURE__ */ new Set,negationMap:a=/* @__PURE__ */ new Map,defaultNegationDisabledFields:o=/* @__PURE__ */ new Set}=P(e),s=/* @__PURE__ */ new Set;for(let t of e.fields)for(let e of n(t))e.length===1&&s.add(e);return{aliasMap:t,booleanFlags:r,definedNames:i,flagNames:new Set(e.fields.map(e=>e.name)),cliNames:new Set(e.fields.map(e=>e.cliName)),aliases:s,negationMap:a,defaultNegationDisabledFields:o}}function Tt(e,t){let{resolvedName:n,withoutDashes:r,isNegated:i,isCustomNegation:a,isSuppressedNegation:o}=M(e,t);if(o)return{resolvedName:n,withoutDashes:r,isNegated:!1,isGlobal:!1,isSuppressedNegation:o};let s=i&&!a?r.startsWith(`no-`)?r.slice(3):r[2].toLowerCase()+r.slice(3):r;return{resolvedName:n,withoutDashes:r,isNegated:i,isGlobal:t.flagNames.has(n)||t.cliNames.has(r)||t.cliNames.has(s),isSuppressedNegation:!1}}function Et(e,t,n,r,i){return!e.includes(`=`)&&!i.has(t)&&!n&&r!==void 0&&!r.startsWith(`-`)}function X(e,t,n,r,i,a){let o=e[t];return a.push(o),Et(o,n,r,e[t+1],i)?(a.push(e[t+1]),2):1}function Dt(e,t,n){let r=wt(n),i=new Set(t),a=[],o=[],s=0;for(;s<e.length;){let t=e[s];if(t===`--`||Ot.has(t))break;if(!t.startsWith(`-`)&&i.has(t))return{subCommandIndex:s,globalTokensBefore:a,tokensAfterSubcommand:e.slice(s+1),suppressedTokens:o};if(t.startsWith(`--`)){let{resolvedName:n,withoutDashes:i,isNegated:c,isGlobal:l,isSuppressedNegation:u}=Tt(t,r);if(l){s+=X(e,s,n,c,r.booleanFlags,a);continue}if(u){o.push(i),s++;continue}break}if(t.startsWith(`-`)&&t.length>1){let n=t.includes(`=`)?t.slice(1,t.indexOf(`=`)):t.slice(1);if(n.length===1){let t=r.aliasMap.get(n)??n;if(r.aliases.has(n)||r.flagNames.has(t)){s+=X(e,s,t,!1,r.booleanFlags,a);continue}}break}break}return{subCommandIndex:-1,globalTokensBefore:a,tokensAfterSubcommand:[],suppressedTokens:o}}const Ot=/* @__PURE__ */ new Set([`--help`,`-h`,`--help-all`,`-H`,`--help-json`,`--version`]);function kt(e,t,n={}){let r=n.stopOnSuppressedNegation===!0||t?.unknownKeysMode===`strict`,i=t?wt(t):{aliasMap:/* @__PURE__ */ new Map,booleanFlags:/* @__PURE__ */ new Set,definedNames:/* @__PURE__ */ new Set,flagNames:/* @__PURE__ */ new Set,cliNames:/* @__PURE__ */ new Set,aliases:/* @__PURE__ */ new Set,negationMap:/* @__PURE__ */ new Map,defaultNegationDisabledFields:/* @__PURE__ */ new Set};for(let t=0;t<e.length;t++){let n=e[t];if(!n.startsWith(`-`))return t;if(n===`--`||Ot.has(n))return-1;if(n.startsWith(`--`)){let{resolvedName:a,isNegated:o,isGlobal:s,isSuppressedNegation:c}=Tt(n,i);if(s){Et(n,a,o,e[t+1],i.booleanFlags)&&t++;continue}if(c){if(r)return-1;continue}return-1}let a=n.includes(`=`)?n.slice(1,n.indexOf(`=`)):n.slice(1);if(a.length===1){let r=i.aliasMap.get(a)??a;if(i.aliases.has(a)||i.flagNames.has(r)){Et(n,r,!1,e[t+1],i.booleanFlags)&&t++;continue}}return-1}return-1}function At(e,t){let n=kt(e,t);return n>=0?e[n]:void 0}function jt(e,t,r={}){let i=C(t),o=[...i],s=o.length>0;if(s&&e.length>0){if(r.globalExtracted){let t=Dt(e,o,r.globalExtracted);if(t.subCommandIndex>=0){let n=Pt(t.globalTokensBefore,r.globalExtracted);return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:e[t.subCommandIndex],remainingArgs:t.tokensAfterSubcommand,rawArgs:{},positionals:[],rest:[],unknownFlags:t.suppressedTokens,unknownGlobalFlags:t.suppressedTokens,rawGlobalArgs:n}}}else{let t=e[0];if(t&&!t.startsWith(`-`)&&i.has(t))return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:t,remainingArgs:e.slice(1),rawArgs:{},positionals:[],rest:[],unknownFlags:[]}}}let c;t.args&&(c=l(t.args),r.skipValidation||(ot(c),ft(c),st(c),dt(c),ct(c),lt(c,s),ut(c),r.globalExtracted&&ht(r.globalExtracted,c)));let u=e,d,f=[];if(r.globalExtracted){let t=c?a(c):[],n=new Set(t.map(e=>e.name)),{separated:i,globalParsed:o,suppressedTokens:s}=Ft(e,r.globalExtracted,c&&{...c,fields:[...t,...c.fields.filter(e=>!n.has(e.name))]});u=i,d=o,f=s}let p=e.indexOf(`--`),m=p>=0?e.slice(0,p):e,h=c?.fields.some(e=>e.overrideBuiltinAlias===!0&&n(e).includes(`H`))??!1,g=c?.fields.some(e=>e.overrideBuiltinAlias===!0&&n(e).includes(`h`))??!1,_=m.includes(`--help-all`)||!h&&m.includes(`-H`),v=m.includes(`--help-json`),y=!_&&!v&&(m.includes(`--help`)||!g&&m.includes(`-h`)),ee=m.includes(`--version`);if(y||_||v||ee)return{helpRequested:y,helpAllRequested:_,helpJsonRequested:v,versionRequested:ee,subCommand:void 0,remainingArgs:[],rawArgs:{},positionals:[],rest:[],unknownFlags:[],unknownGlobalFlags:f,rawGlobalArgs:d};if(!c){let e=u.indexOf(`--`);return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:void 0,remainingArgs:[],rawArgs:{},positionals:e>=0?u.slice(0,e):u,rest:e>=0?u.slice(e+1):[],unknownFlags:[],unknownGlobalFlags:f,rawGlobalArgs:d}}let b=Mt(c,u,{promptAvailable:r.promptAvailable===!0,inheritedNames:r.inheritedNames??/* @__PURE__ */ new Set});if(!b)return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:void 0,remainingArgs:[],rawArgs:{},positionals:[],rest:[],unknownFlags:[],unknownGlobalFlags:f,extractedFields:c,matchesNoUnionOption:!0,rawGlobalArgs:d};let te=P(b),x=N(u,te),S=j(x,b),w=Z(S,b),T=b.fields.filter(e=>e.named),E=new Set(T.map(e=>e.name)),D=new Set(T.map(e=>e.cliName)),O=/* @__PURE__ */ new Set;for(let e of T)for(let t of n(e))O.add(t);if(r.globalExtracted)for(let e of r.globalExtracted.fields){E.add(e.name),D.add(e.cliName);for(let t of n(e))O.add(t)}let k=[];for(let e of Object.keys(x.options))!E.has(e)&&!D.has(e)&&!O.has(e)&&k.push(e);return{helpRequested:!1,helpAllRequested:!1,helpJsonRequested:!1,versionRequested:!1,subCommand:void 0,remainingArgs:[],rawArgs:S,positionals:x.positionals,rest:x.rest,unknownFlags:k,unknownGlobalFlags:f,extractedFields:c,optionFields:T,positionalSlotFields:A(b,x.options),rawGlobalArgs:d,envFallbackFields:w}}function Mt(e,t,n){let{discriminator:r,variants:i,unionOptions:a}=e;if(r&&i){let n=e=>{let n=j(N(t,P(e)),e);return Z(n,e),n},r=c(e,n);return r===e?i.some(t=>{let r=n({...e,fields:t.fields});return c(e,()=>r)!==e})?void 0:e:r}if(a){let r=a.flatMap(e=>{let r=Mt(e,t,n);return r?[r]:[]}),i=n.promptAvailable?r.filter(e=>Nt(e,t,void 0)):[],o=r.find(e=>Nt(e,t,n.inheritedNames))??(i.length===1?i[0]:void 0);return o&&{...e,fields:o.fields}}return e}function Z(e,t){let n=/* @__PURE__ */ new Set;for(let r of t.fields)if(r.env&&e[r.name]===void 0)for(let t of[r.env].flat()){let i=process.env[t];if(i!==void 0){e[r.name]=re(i,r.type),n.add(r.name);break}}return n}function Nt(e,t,r){let i=N(t,P(e)),a=e.fields.filter(e=>e.named),o=new Set(a.flatMap(e=>[e.name,e.cliName,...n(e)]));if(Object.keys(i.options).some(e=>!o.has(e)))return!1;let s=A(e,i.options),c=i.positionals.length+i.rest.length;if(!s.some(e=>e.type===`array`)&&c>s.length)return!1;let l=j(i,e);return e.fields.some(e=>e.type!==`boolean`&&[l[e.name]].flat().includes(!0))?!1:r===void 0||(Z(l,e),e.fields.every(e=>!e.required||l[e.name]!==void 0||r.has(e.name)))}function Pt(e,t){if(e.length===0)return{};let n=P(t),r=N(e,n);return j(r,t)}function Ft(e,r,i){let a=wt(r),o=new Set(i?.fields.map(e=>e.name)??[]),s=new Set(i?.fields.map(e=>e.cliName)??[]),c=i?P(i):void 0,l=new Set(c?.aliasMap?.keys()??[]),u=new Set(c?.negationMap?.keys()??[]),d=/* @__PURE__ */ new Set;for(let e of i?.fields??[])if(e.type===`boolean`&&e.negation===!0)for(let r of[e.cliName,...n(e)]){let e=`no-${r}`;d.add(e),d.add(t(e))}let f=[],p=[],m=[];for(let t=0;t<e.length;t++){let n=e[t];if(n===`--`){p.push(...e.slice(t));break}if(n.startsWith(`--`)){let{resolvedName:r,withoutDashes:i,isNegated:c,isGlobal:p,isSuppressedNegation:h}=Tt(n,a),g=r,_=o.has(i)||o.has(g)||s.has(i)||s.has(g)||l.has(i)||l.has(g)||u.has(i)||u.has(g)||d.has(i);if(p&&!_){t+=X(e,t,r,c,a.booleanFlags,f)-1;continue}if(h&&!_){m.push(i);continue}}else if(n.startsWith(`-`)&&n.length>1){let r=n.includes(`=`)?n.slice(1,n.indexOf(`=`)):n.slice(1);if(r.length===1){let n=a.aliasMap.get(r)??r;if((a.aliases.has(r)||a.flagNames.has(n))&&!l.has(r)){t+=X(e,t,n,!1,a.booleanFlags,f)-1;continue}}}p.push(n)}return{separated:p,globalParsed:Pt(f,r),suppressedTokens:m}}function It(e,t){return s(t)?d(e,t):r().validate(e,t)}function Lt(e){return e.map(e=>`${e.path.length>0?`${e.path.join(`.`)}: `:``}${e.message}`).join(`
33
+ `)}function Rt(e,t){let n=[];for(let e=0;e<=t.length;e++)n[e]=[e];for(let t=0;t<=e.length;t++)n[0][t]=t;for(let r=1;r<=t.length;r++)for(let i=1;i<=e.length;i++)t.charAt(r-1)===e.charAt(i-1)?n[r][i]=n[r-1][i-1]:n[r][i]=Math.min(n[r-1][i-1]+1,n[r][i-1]+1,n[r-1][i]+1);return n[t.length][e.length]}function zt(e,t){let n=Math.max(2,Math.floor(e.length/2));return t.map(t=>({candidate:t,distance:Rt(e.toLowerCase(),t.toLowerCase())})).filter(({distance:e})=>e<=n).sort((e,t)=>e.distance-t.distance).map(({candidate:e})=>e).slice(0,3)}function Bt(e,t){let n=zt(e.replace(/^-{1,2}/,``),t),r=`${k.warning(`Warning: Unknown option:`)} ${k.bold(e)}`;if(n.length>0){r+=`\n\n${k.info(`Did you mean?`)}`;for(let e of n)r+=`\n ${O.arrow} ${k.option(`--${e}`)}`}return r}function Vt(e,t){return t&&e.stack?`${k.error(`Error:`)} ${e.message}\n\n${k.dim(e.stack)}`:`${k.error(`Error:`)} ${e.message}`}function Q(n){return new Proxy(n,{get(n,r,i){if(typeof r==`string`){if(r in n)return Reflect.get(n,r,i);let a=t(r);if(a!==r&&a in n)return Reflect.get(n,a,i);let o=e(r);if(o!==r&&o in n)return Reflect.get(n,o,i)}return Reflect.get(n,r,i)},has(n,r){if(typeof r==`string`){if(r in n)return!0;let i=t(r);if(i!==r&&i in n)return!0;let a=e(r);if(a!==r&&a in n)return!0}return Reflect.has(n,r)}})}async function Ht(e,t,n){for(let r of t.fields)r.effect&&await r.effect(e[r.name],{name:r.name,args:e,...n!=null&&{globalArgs:n}})}const Ut={log:e=>console.log(e),error:e=>console.error(e),warn:e=>console.warn(e)};function Wt(n,r){Object.defineProperty(n,"$source",{value:n=>r.get(n)??r.get(t(n))??r.get(e(n))??`default`,enumerable:!1})}function Gt(e,t){Object.defineProperty(e,"$invocation",{value:t,enumerable:!1})}function Kt(e,t){Object.defineProperty(e,"$agent",{value:t,enumerable:!1})}function qt(e,t){return e&&(n=>e({...n,agent:t}))}function Jt(e,t){let{agentHelp:n,_agent:r}=e;if(n&&r)return typeof n==`string`?n:n({agent:r,commandPath:t.commandPath??[]})}function Yt(e,t){let n=t.commandPath?.at(-1)??e.name;return t.aliasFor?{name:n,aliasFor:t.aliasFor}:{name:n}}async function Xt(e,t,n={}){let r=en(n),i=h(),a=qt(n.cleanup,i),o=n.captureLogs??!1,s=o?D():null;if(n.setup){s?.start();try{await n.setup({agent:i})}catch(e){let t=e instanceof Error?e:Error(String(e));if(a)try{await a({error:t})}catch{}return s?.stop(),{success:!1,error:t,exitCode:1,logs:s?.getLogs()??T()}}s?.stop()}let c=await $(e,t,{...n,handleSignals:!1,_globalExtracted:r,_globalCleanup:a,_existingLogs:s?.getLogs(),_agent:i});if(a){let e=o?D():null;e?.start();let t={error:c.success?void 0:c.error};try{await a(t)}catch(t){if(c.success){let n=t instanceof Error?t:Error(String(t));return e?.stop(),{success:!1,error:n,exitCode:1,logs:E(c.logs,e?.getLogs()??T())}}}e?.stop();let n=e?.getLogs()??T();if(n.entries.length>0)return{...c,logs:E(c.logs,n)}}return c}function Zt(e,t,n){let r=At(t,n);return!r||!r.startsWith(`__`)?!1:Object.hasOwn(e.subCommands??{},r)}async function Qt(e,t={}){if(t.compileCache!==!1&&g(typeof t.compileCache==`string`?{cacheDir:t.compileCache}:{programName:e.name}),e.runMainHook)try{e.runMainHook(process.argv.slice(2))}catch{}let n=process.argv.slice(2),r;if(t.globalArgs)try{r=l(t.globalArgs)}catch{}let i=t;if(Zt(e,n,r)){let{setup:e,cleanup:n,prompt:r,globalArgs:a,...o}=t;i=o}let a=en(i),o=h(),s=qt(i.cleanup,o);if(i.skipValidation||vt(e),i.onUnknownSubcommand&&!e.run&&!Zt(e,n,r)){let t=C(e);if(t.size>0){let e=kt(n,a,{stopOnSuppressedNegation:a?.unknownKeysMode!==`passthrough`}),r=e>=0?n[e]:void 0;if(r&&!t.has(r)){let t=n.slice(e+1),a=await i.onUnknownSubcommand({commandPath:[],name:r,args:t,precedingArgs:n.slice(0,e)});if(typeof a==`number`)return await $t(),process.exit(a)}}}if(i.setup)try{await i.setup({agent:o})}catch(e){let t=e instanceof Error?e:Error(String(e));if(s)try{await s({error:t})}catch{}process.exit(1)}let c=await $(e,n,{debug:i.debug,captureLogs:i.captureLogs,skipValidation:i.skipValidation,handleSignals:!0,logger:i.logger,globalArgs:i.globalArgs,prompt:i.prompt,onUnknownSubcommand:i.onUnknownSubcommand,agentHelp:i.agentHelp,_globalExtracted:a,_globalCleanup:s,_agent:o,_context:{commandPath:[],rootName:e.name,rootVersion:i.version,globalExtracted:a}});if((i.displayErrors??!0)&&!c.success&&c.error&&(i.logger??Ut).error(Vt(c.error,i.debug??!1)),s){let e={error:c.success?void 0:c.error};try{await s(e)}catch{}}await $t(),process.exit(c.exitCode)}async function $t(){await Promise.all([process.stdout,process.stderr].map(e=>e.writableLength>0?new Promise(t=>e.write(``,()=>t())):Promise.resolve()))}async function $(e,t,n={}){let r=n.logger??Ut,i=n._context??{commandPath:[],rootName:e.name,globalExtracted:n._globalExtracted},a=n.captureLogs??!1?D():null;a?.start();let o=()=>{let e=n._existingLogs??T(),t=a?.getLogs()??T();return E(e,t)};try{n.skipValidation||vt(e);let s=jt(t,e,{skipValidation:n.skipValidation,globalExtracted:n._globalExtracted,promptAvailable:n.prompt!==void 0,inheritedNames:new Set(Object.keys(n._parsedGlobalArgs??{}))}),l={...n._parsedGlobalArgs,...s.rawGlobalArgs},u=i.commandPath??[];if(n.onUnknownSubcommand&&!e.run&&u.length>0){let r=C(e);if(r.size>0){let e=kt(t,n._globalExtracted,{stopOnSuppressedNegation:n._globalExtracted?.unknownKeysMode!==`passthrough`}),i=e>=0?t[e]:void 0;if(i&&!r.has(i)){let r=t.slice(e+1),s=await n.onUnknownSubcommand({commandPath:u,name:i,args:r,precedingArgs:[...n._precedingArgs??[],...t.slice(0,e)]});if(typeof s==`number`){if(a?.stop(),n.handleSignals){if(n._globalCleanup)try{await n._globalCleanup({error:void 0})}catch{}await $t(),process.exit(s)}return s===0?{success:!0,result:void 0,exitCode:0,logs:o()}:{success:!1,error:/* @__PURE__ */ Error(`Plugin "${[...u,i].join(` `)}" exited with code ${s}`),exitCode:s,logs:o()}}}}}if(s.helpRequested||s.helpAllRequested||s.helpJsonRequested){let c=!1,l=te(e),u=C(e);if(l.length>0){let e=At(t,i.globalExtracted);e&&!u.has(e)&&(c=!0)}let d=Jt(n,i);if(s.helpJsonRequested){let t=J(e,{context:i,agentHelp:d});r.log(JSON.stringify(t))}else{let t=G(e,{showSubcommands:n.showSubcommands??!0,showSubcommandOptions:s.helpAllRequested||n.showSubcommandOptions,context:i,agentHelp:d});r.log(t)}if(a?.stop(),c){let e=At(t,i.globalExtracted)??``,n=zt(e,[...u]),r=n.length>0?` Did you mean: ${n.join(`, `)}?`:``;return{success:!1,error:/* @__PURE__ */ Error(`Unknown subcommand: ${e}${r?`.${r}`:``}`),exitCode:2,logs:o()}}return{success:!0,result:void 0,exitCode:0,logs:o()}}if(s.unknownGlobalFlags&&s.unknownGlobalFlags.length>0){let e=i.globalExtracted?.unknownKeysMode??`strip`;if(e===`strict`)return a?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unknown flags: ${s.unknownGlobalFlags.join(`, `)}`),exitCode:2,logs:o()};if(e===`strip`){let e=i.globalExtracted?.fields.map(e=>e.name)??[];for(let t of s.unknownGlobalFlags)r.error(Bt(t,e))}}if(s.versionRequested){let e=i.rootVersion;return e&&r.log(e),a?.stop(),{success:!0,result:void 0,exitCode:0,logs:o()}}if(s.subCommand){let r=n._metadataOnly??!1,c=await _(e,s.subCommand,e=>{if(r)return!0;if(!e.requiredPackages?.length)return!1;let t=e,a=s.remainingArgs;for(;;){let e=jt(a,t,{skipValidation:n.skipValidation,globalExtracted:i.globalExtracted,promptAvailable:!!n.prompt});if(e.helpRequested||e.helpAllRequested||e.helpJsonRequested||e.versionRequested)return r=!0,!0;if(!e.subCommand||!t.subCommands)return!1;let o=Object.hasOwn(t.subCommands,e.subCommand)?e.subCommand:ee(t,e.subCommand)??e.subCommand,s=t.subCommands[o],c=s?v(s):null;if(!c)return!1;t=c,a=e.remainingArgs}});if(c){let e={commandPath:[...i.commandPath??[],s.subCommand],rootName:i.rootName,rootVersion:i.rootVersion,globalExtracted:i.globalExtracted,aliasFor:c.aliasFor};a?.stop();let u=new Set(n._globalExtracted?.unknownKeysMode===`passthrough`?[]:s.unknownGlobalFlags??[]),d=e=>e.startsWith(`--`)&&u.has(ne(e)),f=t.slice(0,t.length-s.remainingArgs.length-1).filter(e=>!d(e));return $(c.command,s.remainingArgs,{...n,_metadataOnly:r,_context:e,_existingLogs:o(),_parsedGlobalArgs:l,_precedingArgs:[...n._precedingArgs??[],...f]})}}let d=s.positionalSlotFields??[],f=d.some(e=>e.type===`array`),p=[...s.positionals,...s.rest],m=f?[]:p.slice(d.length),h=f?[]:s.positionals.slice(d.length);if(s.matchesNoUnionOption)return a?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Arguments match none of the accepted forms. See --help for the accepted forms.`),exitCode:2,logs:o()};if(te(e).length>0&&!s.subCommand&&!e.run&&m.length===0){if(e.defaultSubCommand&&s.unknownFlags.length===0){let r=e.subCommands?.[e.defaultSubCommand];if(r){let c=await S(r),u={commandPath:[...i.commandPath??[],e.defaultSubCommand],rootName:i.rootName,rootVersion:i.rootVersion,globalExtracted:i.globalExtracted};a?.stop();let d=new Set(n._globalExtracted?.unknownKeysMode===`passthrough`?[]:s.unknownGlobalFlags??[]),f=e=>e.startsWith(`--`)&&d.has(ne(e)),p=t.filter(e=>!f(e));return $(c,[],{...n,_context:u,_existingLogs:o(),_parsedGlobalArgs:l,_precedingArgs:[...n._precedingArgs??[],...p]})}}let c=G(e,{showSubcommands:n.showSubcommands??!0,context:i,agentHelp:Jt(n,i)});return r.log(c),a?.stop(),{success:!0,result:void 0,exitCode:0,logs:o()}}if(s.unknownFlags.length>0){let e=s.extractedFields?.unknownKeysMode??`strip`,t=s.optionFields?.map(e=>e.name)??[];if(e===`strict`)return a?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unknown flags: ${s.unknownFlags.join(`, `)}`),exitCode:2,logs:o()};if(e===`strip`)for(let e of s.unknownFlags)r.error(Bt(e,t))}if(m.length>0){let t=C(e);if(t.size>0){let e=h.find(e=>!e.startsWith(`-`)&&!t.has(e));if(e){let n=zt(e,[...t]),r=n.length>0?` Did you mean: ${n.join(`, `)}?`:``;return a?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unknown subcommand: ${e}${r?`.${r}`:``}`),exitCode:2,logs:o()}}}let n=s.extractedFields?.unknownKeysMode??`strip`;if(n===`strict`)return a?.stop(),{success:!1,error:/* @__PURE__ */ Error(`Unexpected positional argument${m.length>1?`s`:``}: ${m.join(`, `)}`),exitCode:2,logs:o()};if(n===`strip`)for(let e of m)(r.warn??r.error)(`Warning: Unexpected positional argument: ${e}`)}let g={},y=e.name===`__complete`,b=new Set(Object.keys(l)),x=/* @__PURE__ */ new Set;if(n.globalArgs&&n._globalExtracted&&!y){for(let e of n._globalExtracted.fields)if(e.env&&l[e.name]===void 0){let t=Array.isArray(e.env)?e.env:[e.env];for(let n of t){let t=process.env[n];if(t!==void 0){l[e.name]=re(t,e.type),x.add(e.name);break}}}if(n.prompt){let e=await n.prompt(l,n._globalExtracted);for(let[t,n]of Object.entries(e))n!==void 0&&(l[t]=n)}let e=It(l,n.globalArgs);if(!e.success)return a?.stop(),{success:!1,error:Error(Lt(e.errors)),exitCode:2,logs:o()};g=e.data}if(!e.args){let t=/* @__PURE__ */ new Map;for(let e of b)t.set(e,`cli`);for(let e of x)t.set(e,`env`);Wt(g,t),Gt(g,Yt(e,i)),Kt(g,n._agent);let r=Q(g);return n._globalExtracted&&!y&&await Ht(r,n._globalExtracted,r),a?.stop(),await ae(e,r,{handleSignals:n.handleSignals,captureLogs:n.captureLogs,existingLogs:o(),globalCleanup:n._globalCleanup,packageDiscriminators:n._globalExtracted?.discriminator?[n._globalExtracted.discriminator]:[],packageFields:y||!n._globalExtracted?void 0:c(n._globalExtracted,()=>g).fields})}let w=s.rawArgs,T=/* @__PURE__ */ new Set;if(n.prompt&&s.extractedFields){let e=await n.prompt(w,s.extractedFields),t={...w};for(let[n,r]of Object.entries(e))r!==void 0&&(t[n]=r,T.add(n));w=t}let E=/* @__PURE__ */ new Set;if(s.extractedFields)for(let e of s.extractedFields.fields)!(Object.hasOwn(s.rawArgs,e.name)||T.has(e.name))&&b.has(e.name)&&Object.hasOwn(g,e.name)&&(w={...w,[e.name]:g[e.name]},E.add(e.name));let D=It(w,e.args);if(!D.success)return a?.stop(),{success:!1,error:Error(Lt(D.errors)),exitCode:2,logs:o()};let O=Q(D.data),k=/* @__PURE__ */ new Map;for(let e of b)k.set(e,`cli`);for(let e of x)k.set(e,`env`);Wt(g,k),Gt(g,Yt(e,i)),Kt(g,n._agent);let A=Q(g);n._globalExtracted&&!y&&await Ht(A,n._globalExtracted,A),s.extractedFields&&!y&&await Ht(O,s.extractedFields,A);let j={...A,...O},M=new Map(k),N=s.envFallbackFields??/* @__PURE__ */ new Set;for(let e of s.extractedFields?.fields??[]){if(E.has(e.name)){M.set(e.name,`cli`);continue}let t=Object.hasOwn(s.rawArgs,e.name)||N.has(e.name);M.set(e.name,t?N.has(e.name)?`env`:`cli`:`default`)}Wt(j,M),Gt(j,Yt(e,i)),Kt(j,n._agent);let P=Q(j);return a?.stop(),await ae(e,P,{handleSignals:n.handleSignals,captureLogs:n.captureLogs,existingLogs:o(),globalCleanup:n._globalCleanup,packageDiscriminators:[s.extractedFields?.discriminator,n._globalExtracted?.discriminator].filter(e=>e!==void 0),packageFields:y?void 0:[...n._globalExtracted?c(n._globalExtracted,()=>g).fields:[],...s.optionFields??[],...s.positionalSlotFields??[]]})}catch(e){let t=e instanceof Error?e:Error(String(e));return a?.stop(),{success:!1,error:t,exitCode:1,logs:o()}}}function en(e){if(!e.globalArgs)return;let t=l(e.globalArgs);if(!e.skipValidation){ot(t),ft(t),st(t),dt(t),lt(t,!0),ut(t);let e=t.fields.filter(e=>e.positional).map(e=>e.name);if(e.length>0)throw Error(`Global options schema must not contain positional arguments. Found: ${e.join(`, `)}`)}return t}export{Ge as C,F as D,J as E,de as O,We as S,G as T,Xe as _,Ct as a,Je as b,ht as c,ot as d,dt as f,Y as g,ut as h,Lt as i,vt as l,lt as m,Qt as n,ft as o,ct as p,Q as r,xt as s,Xt as t,st as u,qe as v,Ye as w,Ze as x,Ke as y};
@@ -0,0 +1 @@
1
+ import{t as e}from"./runner-Bc0bI0Eh.js";export{e as runCommand};
@@ -1 +1 @@
1
- import{d as e,u as t}from"./schema-extractor-Cfy1t5nw.js";const n=t({shell:e.enum([`bash`,`zsh`,`fish`],{description:`Target shell for output formatting`}),args:e.stringArray({positional:!0,description:`Arguments to complete`})});export{n as t};
1
+ import{d as e,u as t}from"./schema-extractor-BkbKiMq_.js";const n=t({shell:e.enum([`bash`,`zsh`,`fish`],{description:`Target shell for output formatting`}),args:e.stringArray({positional:!0,description:`Arguments to complete`})});export{n as t};
@@ -0,0 +1 @@
1
+ import{o as e,r as t}from"./field-meta-CEtC5Mir.js";const n=`__polittyInternalArgs`,r={string(e){return{kind:`string`,optional:!1,meta:e}},optionalString(e){return{kind:`string`,optional:!0,meta:e}},boolean(e){return{kind:`boolean`,optional:!1,defaultValue:!1,meta:e}},enum(e,t){return{kind:`enum`,enumValues:e,optional:!1,meta:t}},optionalEnum(e,t){return{kind:`enum`,enumValues:e,optional:!0,meta:t}},stringArray(e){return{kind:`string-array`,optional:!1,defaultValue:[],meta:e}},optionalStringArray(e){return{kind:`string-array`,optional:!0,meta:e}}};function i(e,t={}){return{[n]:!0,fields:e,unknownKeys:t.unknownKeys??`strip`}}function a(e){return typeof e==`object`&&!!e&&e[n]===!0}const o={string:`string`,boolean:`boolean`,enum:`string`,"string-array":`array`},s=/* @__PURE__ */ new WeakMap;function c(e){let n=s.get(e);if(n)return n;let r={fields:Object.entries(e.fields).map(([e,n])=>t(e,{argMeta:n.meta,description:void 0,required:!n.optional&&n.defaultValue===void 0,defaultValue:n.defaultValue,type:o[n.kind],enumValues:n.enumValues?[...n.enumValues]:void 0,schema:n})),schema:e,schemaType:`object`,unknownKeysMode:e.unknownKeys};return s.set(e,r),r}function l(e){switch(e.kind){case`enum`:return`one of ${(e.enumValues??[]).map(e=>JSON.stringify(e)).join(` | `)}`;case`string-array`:return`array`;default:return e.kind}}function u(e){return e===null?`null`:Array.isArray(e)?`array`:typeof e}function d(e,t,n){return{path:[e],message:`Invalid input: expected ${l(t)}, received ${u(n)}`,code:`invalid_type`,received:n,expected:l(t)}}function f(e,t,n){switch(t.kind){case`string`:return typeof n==`string`?null:d(e,t,n);case`boolean`:return typeof n==`boolean`?null:d(e,t,n);case`enum`:return typeof n!=`string`||!(t.enumValues??[]).includes(n)?{path:[e],message:`Invalid option: expected ${l(t)}`,code:`invalid_value`,received:n,expected:l(t)}:null;case`string-array`:return!Array.isArray(n)||n.some(e=>typeof e!=`string`)?d(e,t,n):null}}function p(e,t){let n=[],r={};for(let[i,a]of Object.entries(t.fields)){let t=e[i];if(t===void 0){a.defaultValue===void 0?a.optional||n.push(d(i,a,void 0)):r[i]=Array.isArray(a.defaultValue)?[...a.defaultValue]:a.defaultValue;continue}let o=f(i,a,t);if(o){n.push(o);continue}r[i]=t}let i=new Set(Object.keys(t.fields)),a=Object.keys(e).filter(e=>!i.has(e));if(a.length>0){if(t.unknownKeys===`strict`)n.push({path:[],message:`Unrecognized key${a.length>1?`s`:``}: ${a.map(e=>JSON.stringify(e)).join(`, `)}`,code:`unrecognized_keys`});else if(t.unknownKeys===`passthrough`)for(let t of a)Object.defineProperty(r,t,{value:e[t],enumerable:!0,writable:!0,configurable:!0})}return n.length>0?{success:!1,errors:n}:{success:!0,data:r}}function m(t){return a(t)?t.unknownKeys:e().getUnknownKeysMode(t)}const h=/* @__PURE__ */ new WeakSet;function g(t){let n=a(t)?c(t):e().extractFields(t);return h.has(n)||(_(n),h.add(n)),n}function _(e){let t=e.variants??[e];for(let n of t)for(let t of n.fields)if(t.requiredPackages?.length&&t.type!==`boolean`&&t.name!==e.discriminator)throw Error(`Invalid requiredPackages for field "${t.name}": requiredPackages can only be used on boolean fields or discriminators.`);for(let t of e.unionOptions??[])_(t)}function v(e){return e.args?g(e.args):null}function y(e,t){let[n,...r]=e,i=/* @__PURE__ */ new Set;for(let e of n?.fields??[])e.name!==t&&r.every(t=>t.fields.some(t=>t.name===e.name&&t.positional===e.positional&&t.named===e.named&&b(t.requiredPackages,e.requiredPackages)))&&i.add(e.name);return i}function b(e,t){return(e?.length??0)===(t?.length??0)&&(e??[]).every((e,n)=>{let r=t?.[n];return e.name===r?.name&&e.install===r.install&&e.from?.toString()===r.from?.toString()})}function x(e){let t=w(e).filter(e=>e.named);return T(e,e=>e.named).map(e=>{let n=t.filter(t=>t.name===e.name),r=[...new Set(n.flatMap(e=>e.alias??[]))],i=[...new Set(n.flatMap(e=>e.hiddenAlias??[]))];return{...e,alias:r.length>0?r:e.alias,hiddenAlias:i.length>0?i:e.hiddenAlias}})}function S(e){return T(e,e=>e.positional)}function C(e){return T(e,e=>!e.positional)}function w(e){let t=e.variants??e.unionOptions??[];return[e.fields,...t.map(e=>e.fields)].flat()}function T(e,t){let n=/* @__PURE__ */ new Map;for(let r of w(e))t(r)&&!n.has(r.name)&&n.set(r.name,r);return[...n.values()]}function E(e,t){let{discriminator:n,variants:r}=e;if(!n||!r){let n=e.unionOptions??[],r=n.map(e=>E(e,t));if(r.every((e,t)=>e===n[t]))return e;let i=r.filter((r,i)=>{let a=t(r),o=n[i];if(o.discriminator&&a[o.discriminator]!==void 0&&r===o)return!1;let s=new Set(r.fields.map(e=>e.name));return!e.fields.some(e=>a[e.name]!==void 0&&!s.has(e.name))});if(!i.length)return e;let a=/* @__PURE__ */ new Map;for(let e of i)for(let t of e.fields){let e=a.get(t.name);e?a.set(t.name,{...e,type:e.type===t.type?e.type:`unknown`,named:e.named||t.named,positional:e.positional||t.positional,alias:[.../* @__PURE__ */ new Set([...e.alias??[],...t.alias??[]])],hiddenAlias:[.../* @__PURE__ */ new Set([...e.hiddenAlias??[],...t.hiddenAlias??[]])]}):a.set(t.name,t)}return{...e,fields:[...a.values()]}}let i=r.map(r=>{let i={...e,fields:r.fields};return{variant:r,fields:i,value:t(i)[n]}});for(let{variant:e,fields:t,value:n}of i)if(n!==void 0&&String(n)===e.discriminatorValue)return t;for(let{variant:e,fields:t,value:n}of i)if(n!==void 0&&e.normalizeDiscriminator&&String(e.normalizeDiscriminator(n))===e.discriminatorValue)return t;return e}function D(e,t){return C(e).find(e=>e.name===t)}export{x as a,S as c,r as d,a as f,m as i,E as l,g as n,D as o,p,v as r,C as s,y as t,i as u};
package/dist/skill.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { L as UnknownKeysMode, a as ArgsSchema, r as AnyCommand } from "./types-BvnlWosT.js";
1
+ import { L as UnknownKeysMode, a as ArgsSchema, r as AnyCommand } from "./types-Dhar1ua6.js";
2
2
  //#region ../core/src/skill/types.d.ts
3
3
  /**
4
4
  * SKILL.md frontmatter metadata, validated against the Agent Skills
package/dist/skill.js CHANGED
@@ -1,2 +1,2 @@
1
- import"./register-AMVOXtkb.js";import{d as e,n as t,u as n}from"./schema-extractor-Cfy1t5nw.js";import{n as r}from"./command-tLHaJHe6.js";import{a as i,n as a}from"./logger-CoeDrmRr.js";import{copyFileSync as o,existsSync as s,lstatSync as c,mkdirSync as l,mkdtempSync as u,readFileSync as d,readdirSync as f,readlinkSync as p,realpathSync as m,renameSync as ee,rmSync as h,statSync as g,symlinkSync as te,unlinkSync as _}from"node:fs";import{basename as v,dirname as y,isAbsolute as b,join as x,parse as ne,relative as S,resolve as C,sep as w}from"node:path";import{parse as re}from"yaml";const ie=/^[a-z0-9]+(-[a-z0-9]+)*$/;function T(e){return e===null?`null`:Array.isArray(e)?`array`:typeof e}function ae(e){let t=[],n=(n,r)=>{let i=e[n];if(i===void 0){r.required&&t.push({path:[n],message:`Invalid input: expected string, received undefined`});return}if(typeof i!=`string`){t.push({path:[n],message:`Invalid input: expected string, received ${T(i)}`});return}r.min!==void 0&&i.length<r.min&&t.push({path:[n],message:`Too small: expected string to have >=${r.min} characters`}),r.max!==void 0&&i.length>r.max&&t.push({path:[n],message:`Too big: expected string to have <=${r.max} characters`})};n(`name`,{required:!0,min:1,max:64}),typeof e.name==`string`&&!ie.test(e.name)&&t.push({path:[`name`],message:`name must be lowercase alphanumerics separated by single hyphens`}),n(`description`,{required:!0,min:1,max:1024}),n(`license`,{min:1}),n(`compatibility`,{max:500}),n(`allowed-tools`,{});let r=e.metadata;if(r!==void 0){if(typeof r!=`object`||!r||Array.isArray(r))t.push({path:[`metadata`],message:`Invalid input: expected record, received ${T(r)}`});else for(let[e,n]of Object.entries(r))typeof n!=`string`&&t.push({path:[`metadata`,e],message:`Invalid input: expected string, received ${T(n)}`})}return t.length>0?{success:!1,issues:t}:{success:!0,data:{...e}}}const oe=/^\uFEFF?---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)([\s\S]*)$/;function E(e){let t=e.match(oe);if(!t)return{data:{},body:e};let n=t[1],r=t[2];try{let e=re(n);return se(e)?{data:e,body:r}:{data:{},body:r}}catch(e){return{data:{},body:r,parseError:e instanceof Error?e.message:String(e)}}}function se(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=Object.getPrototypeOf(e);return t===Object.prototype||t===null}function ce(e){let{data:t,body:n}=E(e),r=ae(t);return r.success?{frontmatter:r.data,body:n,rawContent:e}:null}const D=`.agents/skills`,O=[`.claude/skills`],k=`politty-cli`;function A(e){if(e.length<1||e.length>64||!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(e))throw Error(`Invalid skill name: ${JSON.stringify(e)}`)}function le(e,t=process.cwd(),n={}){let r=e.frontmatter.name;A(r);let i=n.mode??`symlink`,a=e.frontmatter.metadata?.[`politty-cli`]??null;if(i===`copy`&&a===null)throw Error(`Refusing to install "${e.frontmatter.name}" in copy mode without an ownership stamp. Add metadata.${k}="{package}:{cli}" to the source SKILL.md so subsequent installs can replace the copy in place.`);let o=C(t,D),s=m(e.sourcePath),c=ue(e.sourcePath),u=[x(M(o),r),...O.map(e=>x(M(C(t,e)),r))].find(e=>ye(e,s));if(u!==void 0)throw Error(`Refusing to install "${r}": source ${s} overlaps install destination ${u}. Choose a sourceDir outside .agents/skills/ and any agent-specific slot directory (e.g. .claude/skills/).`);if(i===`symlink`){let e=M(o);j(x(e,r),S(e,c));for(let n of O){let i=M(C(t,n));j(x(i,r),x(S(i,e),r))}}l(o,{recursive:!0});let d=m(o),f=x(d,r);he(f,a),ge({linkTarget:S(d,c),linkPath:f,copyFrom:s,mode:i}),ve(t,r,f,a,i)}function j(e,t){if(b(t))throw Error(`Refusing to write an absolute symlink target at ${e} → ${t}. The skill source and install root appear to live on different filesystem roots (e.g. different Windows drive letters); retry with mode: "copy".`)}function ue(e){let t=C(e),{root:n}=ne(t),r=t.slice(n.length).split(w).filter(e=>e!==``),i=n;for(let[e,t]of r.entries()){let n=x(i,t),a;try{a=c(n)}catch{return x(i,...r.slice(e))}if(a.isSymbolicLink()){if(de(i))return x(i,...r.slice(e));i=m(n)}else i=n}return i}function de(e){return v(e)===`node_modules`||v(e).startsWith(`@`)&&v(y(e))===`node_modules`}function M(e){let t=e,n=[];for(;;)try{let e=m(t);return n.length===0?e:C(e,...n.reverse())}catch{let r=y(t);if(r===t)return e;n.push(t.slice(r.length).replace(/^[/\\]+/,``)),t=r}}function fe(e,t=process.cwd(),n={}){A(e);let r=n.expectedOwnership??null,i=C(t,D,e);for(let n of O)me(C(t,n,e),r,{restrictSymlinkTo:i});me(i,r)}function pe(e,t){let n;try{n=p(e)}catch{return!1}let r=b(n)?n:C(y(e),n);if(r===t)return!0;try{return m(r)===m(t)}catch{return!1}}function me(e,t,n={}){let r;try{r=c(e)}catch(e){if(L(e)&&(e.code===`ENOENT`||e.code===`ENOTDIR`))return;throw e}if(r.isSymbolicLink()){if(n.restrictSymlinkTo!==void 0){pe(e,n.restrictSymlinkTo)&&_(e);return}(t===null||P(e)===t)&&_(e);return}r.isDirectory()&&t!==null&&P(e)===t&&h(e,{recursive:!0,force:!0})}function he(e,t,n={}){let r;try{r=c(e)}catch(e){if(L(e)&&(e.code===`ENOENT`||e.code===`ENOTDIR`))return;throw e}if(r.isSymbolicLink()){if(n.restrictSymlinkTo===void 0||pe(e,n.restrictSymlinkTo)){_(e);return}throw Error(`Refusing to replace symlink at ${e}: it does not route to this CLI's canonical slot (${n.restrictSymlinkTo}). Remove or migrate the foreign symlink before retrying.`)}if(r.isDirectory()&&t!==null&&P(e)===t){h(e,{recursive:!0,force:!0});return}throw Error(`Refusing to replace non-symlink path at ${e}. This looks like a legacy or manual install; remove or migrate it before retrying.`)}function ge(e){let{linkTarget:t,linkPath:n,copyFrom:r,mode:i}=e;if(i===`copy`){_e(r,n);return}j(n,t);try{te(t,n,`dir`)}catch(e){let r=e instanceof Error?e.message:String(e);throw Error(`Failed to symlink ${n} → ${t}: ${r}. If this filesystem does not support symlinks (e.g. Windows without Developer Mode), retry with mode: "copy".`,{cause:e})}}function _e(e,t){let n=u(`${t}.partial-`);try{N(e,n),ee(n,t)}catch(e){try{h(n,{recursive:!0,force:!0})}catch{}throw e}}function N(e,t,n=/* @__PURE__ */ new Set){let r=g(e);if(r.isDirectory()){let r=m(e);if(n.has(r))throw Error(`Refusing to recursively copy cyclic directory symlink at ${e} (resolves to ${r}, already on the copy stack).`);n.add(r);try{l(t,{recursive:!0});for(let r of f(e))N(x(e,r),x(t,r),n)}finally{n.delete(r)}return}r.isFile()&&o(e,t)}function P(e){let t;try{t=d(x(e,`SKILL.md`),`utf-8`)}catch(e){if(L(e)&&(e.code===`ENOENT`||e.code===`ENOTDIR`))return null;throw e}let{data:n}=E(t),r=n.metadata;if(!r||typeof r!=`object`||Array.isArray(r))return null;let i=r[k];return typeof i==`string`?i:null}function F(e,t=process.cwd()){return A(e),s(C(t,D,e,`SKILL.md`))}function I(e,t=process.cwd()){A(e);let n=C(t,D,e,`SKILL.md`),r;try{r=d(n,`utf-8`)}catch(e){if(L(e)&&(e.code===`ENOENT`||e.code===`ENOTDIR`))return null;throw e}let{data:i}=E(r),a=i.metadata;if(!a||typeof a!=`object`||Array.isArray(a))return null;let o=a[k];return typeof o==`string`?o:null}function ve(e,t,n,r,i){for(let a of O){let o=C(e,a);l(o,{recursive:!0});let s=m(o),c=x(s,t);he(c,r,{restrictSymlinkTo:n});let u=m(C(n,`..`));ge({linkTarget:x(S(s,u),t),linkPath:c,copyFrom:n,mode:i})}}function L(e){return e instanceof Error&&typeof e.code==`string`}function ye(e,t){if(e===t)return!0;let n=(e,t)=>{let n=S(t,e);return n===``||n===`.`||!b(n)&&n!==`..`&&!n.startsWith(`..${w}`)};return n(e,t)||n(t,e)}const R=`SKILL.md`;function z(e){let t=[],n=[];try{let r;try{r=g(e)}catch(r){return H(r)&&(r.code===`ENOENT`||r.code===`ENOTDIR`)?n.push({path:e,reason:`missing-source`,message:`Source directory does not exist: ${e}`}):n.push({path:e,reason:`read-failed`,message:`Failed to stat source directory ${e}: ${V(r)}`}),{skills:t,errors:n}}if(!r.isDirectory())return n.push({path:e,reason:`missing-source`,message:`Source path is not a directory: ${e}`}),{skills:t,errors:n};let i=x(e,R),a=xe(i);if(a.kind===`error`)return n.push({path:e,reason:`read-failed`,message:`Failed to check ${i}: ${a.message}`}),{skills:t,errors:n};if(a.kind===`present`)return be(B(e,{enforceParentMatch:!1}),t,n),{skills:t,errors:n};let o=f(e,{withFileTypes:!0});for(let r of o){let i=x(e,r.name),a;try{a=g(i).isDirectory()}catch(e){if(H(e)&&e.code===`ENOENT`&&!r.isSymbolicLink())continue;n.push({path:i,reason:`read-failed`,message:r.isSymbolicLink()?`Dangling symlink at ${i}: ${V(e)}`:`Failed to stat ${i}: ${V(e)}`});continue}if(!a)continue;let o=x(i,R),s=xe(o);if(s.kind===`error`){n.push({path:i,reason:`read-failed`,message:`Failed to check ${o}: ${s.message}`});continue}s.kind!==`absent`&&be(B(i,{enforceParentMatch:!0}),t,n)}}catch(t){n.push({path:e,reason:`read-failed`,message:`Failed to scan ${e}: ${V(t)}`})}return t.sort((e,t)=>e.frontmatter.name<t.frontmatter.name?-1:+(e.frontmatter.name>t.frontmatter.name)),{skills:t,errors:n}}function B(e,t){let n=x(e,R),r;try{r=d(n,`utf-8`)}catch(t){return{path:e,reason:`read-failed`,message:`Failed to read ${n}: ${V(t)}`}}let{data:i,parseError:a}=E(r);if(a!==void 0)return{path:e,reason:`parse-failed`,message:`Invalid SKILL.md frontmatter in ${e}: YAML parse error: ${a}`};let o=ae(i);if(!o.success)return{path:e,reason:`parse-failed`,message:`Invalid SKILL.md frontmatter in ${e}: ${o.issues.map(e=>`${e.path.join(`.`)||`<root>`}: ${e.message}`).join(`; `)}`};if(t.enforceParentMatch){let t=v(e);if(t!==o.data.name)return{path:e,reason:`name-mismatch`,message:`Skill name "${o.data.name}" does not match directory "${t}"`,skillName:o.data.name}}return{frontmatter:o.data,sourcePath:e,rawContent:r}}function be(e,t,n){`frontmatter`in e?t.push(e):n.push(e)}function V(e){return e instanceof Error?e.message:String(e)}function H(e){return e instanceof Error&&typeof e.code==`string`}function xe(e){try{return c(e),{kind:`present`}}catch(e){return H(e)&&e.code===`ENOENT`?{kind:`absent`}:{kind:`error`,message:V(e)}}}function Se(e,t={}){let n=0,r=!1;for(let i of e){if(i.reason===`missing-source`||i.path===t.sourceDir){r=!0,a.warn(`Failed to scan source directory ${i.path}: ${i.message}`);continue}n+=1,a.warn(`Skipping skill at ${i.path}: ${i.message}`)}t.silentStdout||(n>0&&a.info(`${i.warning} Skipped ${n} skill(s) due to scan errors (see warnings above).`),r&&a.info(`${i.warning} Source directory scan failed (see warnings above); subsequent operations may be skipped.`))}function U(e,t){let n=e.errors.some(e=>e.reason===`missing-source`||e.path===t),r=e.errors.length>0&&e.skills.length===0;return n||r}function W(e,t={}){let n=z(e.sourceDir);return Se(n.errors,{...t,sourceDir:e.sourceDir}),n}function Ce(e){let t={description:`Skill names to exclude from sync`};return e.excludeAlias!==void 0&&(t.alias=e.excludeAlias),t}function G(e){let t={description:`Print install paths and modes`};return e.verbose.alias!==void 0&&(t.alias=e.verbose.alias),t}function K(e,t){return!!e[t]}function we(t){function i(e,n){let{skills:r,errors:i}=W(t),o=t.stamp,s=new Set(r.map(e=>e.frontmatter.name)),c=new Set(Pe(o,t.cwd,t.sourceDir)),l=Array.from(new Set(e.exclude)).filter(e=>!s.has(e)&&!c.has(e));if(l.length>0){let e=l.length===1?`Skill`:`Skills`,t=l.map(e=>JSON.stringify(e)).join(`, `);throw Error(`--exclude: ${e} ${t} not found in source directory or among installed skills.\n`+J({source:r,installed:c}))}let u=new Set(e.exclude),d=r.filter(e=>!u.has(e.frontmatter.name)),f=U({skills:r,errors:i},t.sourceDir),p=0;if(!f){let e=new Set(d.map(e=>e.frontmatter.name)),n=/* @__PURE__ */ new Set;for(let e of i)e.path!==t.sourceDir&&(n.add(v(e.path)),e.skillName!==void 0&&n.add(e.skillName));for(let r of c)e.has(r)||u.has(r)||n.has(r)||(X(r,o,t.cwd,t.sourceDir),p+=1)}let m=0;for(let e of d)Y(e,o,t,n),m+=1;if(m===0&&p===0){let e=f?`source directory scan failed; see warnings`:r.length>0&&d.length===0?`all skills excluded`:`no skills bundled`;a.info(`No skills installed (${e}).`)}else a.info(`Sync complete: ${m} installed, ${p} removed.`)}return t.verbose.disabled?r({name:`sync`,description:t.descriptions.sync,args:n({exclude:e.stringArray(Ce(t))},{unknownKeys:t.unknownKeys}),run(e){i(e,K(e,`verbose`))}}):r({name:`sync`,description:t.descriptions.sync,args:n({exclude:e.stringArray(Ce(t)),verbose:e.boolean(G(t))},{unknownKeys:t.unknownKeys}),run(e){i(e,e.verbose)}})}function Te(t){let i={positional:!0,description:`Skill name(s) to install (default: all)`,placeholder:`NAME`};function o(e,n){let r=W(t),i=r.skills,o=t.stamp;if(e.name.length>0){let r=new Set(i.map(e=>e.frontmatter.name)),a=Array.from(new Set(e.name)),s=a.filter(e=>!r.has(e));if(s.length>0){let e=s.length===1?`Skill`:`Skills`,t=s.map(e=>JSON.stringify(e)).join(`, `);throw Error(`${e} ${t} not found in source directory.\n`+J({source:i}))}let c=new Set(a);for(let e of i)c.has(e.frontmatter.name)&&Y(e,o,t,n);return}if(i.length===0){U(r,t.sourceDir)?a.info(`No skills installed (source directory scan failed; see warnings).`):a.info(`No skills found in source directory.`);return}for(let e of i)Y(e,o,t,n)}return t.verbose.disabled?r({name:t.commandNames.add.name,...t.commandNames.add.aliases.length>0?{aliases:t.commandNames.add.aliases}:{},description:t.descriptions.add,args:n({name:e.stringArray(i)},{unknownKeys:t.unknownKeys}),run(e){o(e,K(e,`verbose`))}}):r({name:t.commandNames.add.name,...t.commandNames.add.aliases.length>0?{aliases:t.commandNames.add.aliases}:{},description:t.descriptions.add,args:n({name:e.stringArray(i),verbose:e.boolean(G(t))},{unknownKeys:t.unknownKeys}),run(e){o(e,e.verbose)}})}function Ee(t){return r({name:t.commandNames.remove.name,...t.commandNames.remove.aliases.length>0?{aliases:t.commandNames.remove.aliases}:{},description:t.descriptions.remove,args:n({name:e.optionalString({positional:!0,description:`Skill name to remove (default: all)`,placeholder:`NAME`})},{unknownKeys:t.unknownKeys}),run(e){let n=W(t),r=n.skills,i=t.stamp;if(e.name){if(r.some(t=>t.frontmatter.name===e.name)&&Ae(r,e.name),!X(e.name,i,t.cwd,t.sourceDir)){if(q(e.name,t.cwd))a.info(`${e.name} is installed without a ${k} stamp this CLI recognises; refusing to remove. Remove .agents/skills/${e.name} manually if intended.`);else{let n=new Set(Pe(i,t.cwd,t.sourceDir));a.info(`${e.name} is not installed; nothing to remove.\n`+J({installed:n}))}}return}if(r.length===0){U(n,t.sourceDir)?a.info(`No skills found (source directory scan failed; see warnings); nothing to remove.`):a.info(`No skills found in source directory; nothing to remove.`);return}let o=0;for(let e of r)X(e.frontmatter.name,i,t.cwd,t.sourceDir)&&(o+=1);o===0&&a.info(`No installed skills owned by this CLI; nothing to remove.`)}})}function De(e,t,n,r){let i;try{i=I(e,n)}catch(t){return a.warn(`Failed to read ownership for installed skill ${e}: ${Oe(t)}`),`unreadable`}if(i===t)return`installed`;if(i!==null)return`foreign`;if(!F(e,n)){let t=C(n,D,e);return Q(t)&&Z(t,r)?`missing`:q(e,n)?`unstamped`:`not-installed`}return`unstamped`}function Oe(e){return e instanceof Error?e.message:String(e)}function q(e,t){try{return c(C(t,D,e)),!0}catch{return!1}}function ke(t){function i(e){let n=W(t,{silentStdout:e}),r=n.skills,i=t.stamp;if(e){console.log(JSON.stringify(r.map(e=>({name:e.frontmatter.name,description:e.frontmatter.description,owner:e.frontmatter.metadata?.[`politty-cli`]??null,expectedOwner:i,status:De(e.frontmatter.name,i,t.cwd,t.sourceDir),sourcePath:e.sourcePath}))));return}if(r.length===0){U(n,t.sourceDir)?a.info(`Source directory scan failed; see warnings.`):a.info(`No skills found in source directory.`);return}a.info(`Available skills:`);for(let e of r){let n=De(e.frontmatter.name,i,t.cwd,t.sourceDir);a.info(` ${e.frontmatter.name.padEnd(20)} ${n.padEnd(14)} ${e.frontmatter.description}`)}}return t.json.disabled?r({name:`list`,description:t.descriptions.list,args:n({},{unknownKeys:t.unknownKeys}),run(e){i(K(e,`json`))}}):r({name:`list`,description:t.descriptions.list,args:n({json:e.boolean({description:`Output as JSON`})},{unknownKeys:t.unknownKeys}),run(e){i(e.json)}})}function Ae(e,t){let n=e.find(e=>e.frontmatter.name===t);if(!n){let n=e.map(e=>e.frontmatter.name).join(`, `)||`<none>`;throw Error(`Skill "${t}" not found in source directory. Available: ${n}`)}return n}function J(e){let t=[];return e.source!==void 0&&t.push(` Source: ${e.source.map(e=>e.frontmatter.name).join(`, `)||`<none>`}`),e.installed!==void 0&&t.push(` Installed: ${[...e.installed].sort().join(`, `)||`<none>`}`),t.join(`
1
+ import"./register-BtPBdvwq.js";import{d as e,n as t,u as n}from"./schema-extractor-BkbKiMq_.js";import{n as r}from"./command-BXsTrIgI.js";import{a as i,n as a}from"./logger-CoeDrmRr.js";import{copyFileSync as o,existsSync as s,lstatSync as c,mkdirSync as l,mkdtempSync as u,readFileSync as d,readdirSync as f,readlinkSync as p,realpathSync as m,renameSync as ee,rmSync as h,statSync as g,symlinkSync as te,unlinkSync as _}from"node:fs";import{basename as v,dirname as y,isAbsolute as b,join as x,parse as ne,relative as S,resolve as C,sep as w}from"node:path";import{parse as re}from"yaml";const ie=/^[a-z0-9]+(-[a-z0-9]+)*$/;function T(e){return e===null?`null`:Array.isArray(e)?`array`:typeof e}function ae(e){let t=[],n=(n,r)=>{let i=e[n];if(i===void 0){r.required&&t.push({path:[n],message:`Invalid input: expected string, received undefined`});return}if(typeof i!=`string`){t.push({path:[n],message:`Invalid input: expected string, received ${T(i)}`});return}r.min!==void 0&&i.length<r.min&&t.push({path:[n],message:`Too small: expected string to have >=${r.min} characters`}),r.max!==void 0&&i.length>r.max&&t.push({path:[n],message:`Too big: expected string to have <=${r.max} characters`})};n(`name`,{required:!0,min:1,max:64}),typeof e.name==`string`&&!ie.test(e.name)&&t.push({path:[`name`],message:`name must be lowercase alphanumerics separated by single hyphens`}),n(`description`,{required:!0,min:1,max:1024}),n(`license`,{min:1}),n(`compatibility`,{max:500}),n(`allowed-tools`,{});let r=e.metadata;if(r!==void 0){if(typeof r!=`object`||!r||Array.isArray(r))t.push({path:[`metadata`],message:`Invalid input: expected record, received ${T(r)}`});else for(let[e,n]of Object.entries(r))typeof n!=`string`&&t.push({path:[`metadata`,e],message:`Invalid input: expected string, received ${T(n)}`})}return t.length>0?{success:!1,issues:t}:{success:!0,data:{...e}}}const oe=/^\uFEFF?---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)([\s\S]*)$/;function E(e){let t=e.match(oe);if(!t)return{data:{},body:e};let n=t[1],r=t[2];try{let e=re(n);return se(e)?{data:e,body:r}:{data:{},body:r}}catch(e){return{data:{},body:r,parseError:e instanceof Error?e.message:String(e)}}}function se(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=Object.getPrototypeOf(e);return t===Object.prototype||t===null}function ce(e){let{data:t,body:n}=E(e),r=ae(t);return r.success?{frontmatter:r.data,body:n,rawContent:e}:null}const D=`.agents/skills`,O=[`.claude/skills`],k=`politty-cli`;function A(e){if(e.length<1||e.length>64||!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(e))throw Error(`Invalid skill name: ${JSON.stringify(e)}`)}function le(e,t=process.cwd(),n={}){let r=e.frontmatter.name;A(r);let i=n.mode??`symlink`,a=e.frontmatter.metadata?.[`politty-cli`]??null;if(i===`copy`&&a===null)throw Error(`Refusing to install "${e.frontmatter.name}" in copy mode without an ownership stamp. Add metadata.${k}="{package}:{cli}" to the source SKILL.md so subsequent installs can replace the copy in place.`);let o=C(t,D),s=m(e.sourcePath),c=ue(e.sourcePath),u=[x(M(o),r),...O.map(e=>x(M(C(t,e)),r))].find(e=>ye(e,s));if(u!==void 0)throw Error(`Refusing to install "${r}": source ${s} overlaps install destination ${u}. Choose a sourceDir outside .agents/skills/ and any agent-specific slot directory (e.g. .claude/skills/).`);if(i===`symlink`){let e=M(o);j(x(e,r),S(e,c));for(let n of O){let i=M(C(t,n));j(x(i,r),x(S(i,e),r))}}l(o,{recursive:!0});let d=m(o),f=x(d,r);he(f,a),ge({linkTarget:S(d,c),linkPath:f,copyFrom:s,mode:i}),ve(t,r,f,a,i)}function j(e,t){if(b(t))throw Error(`Refusing to write an absolute symlink target at ${e} → ${t}. The skill source and install root appear to live on different filesystem roots (e.g. different Windows drive letters); retry with mode: "copy".`)}function ue(e){let t=C(e),{root:n}=ne(t),r=t.slice(n.length).split(w).filter(e=>e!==``),i=n;for(let[e,t]of r.entries()){let n=x(i,t),a;try{a=c(n)}catch{return x(i,...r.slice(e))}if(a.isSymbolicLink()){if(de(i))return x(i,...r.slice(e));i=m(n)}else i=n}return i}function de(e){return v(e)===`node_modules`||v(e).startsWith(`@`)&&v(y(e))===`node_modules`}function M(e){let t=e,n=[];for(;;)try{let e=m(t);return n.length===0?e:C(e,...n.reverse())}catch{let r=y(t);if(r===t)return e;n.push(t.slice(r.length).replace(/^[/\\]+/,``)),t=r}}function fe(e,t=process.cwd(),n={}){A(e);let r=n.expectedOwnership??null,i=C(t,D,e);for(let n of O)me(C(t,n,e),r,{restrictSymlinkTo:i});me(i,r)}function pe(e,t){let n;try{n=p(e)}catch{return!1}let r=b(n)?n:C(y(e),n);if(r===t)return!0;try{return m(r)===m(t)}catch{return!1}}function me(e,t,n={}){let r;try{r=c(e)}catch(e){if(L(e)&&(e.code===`ENOENT`||e.code===`ENOTDIR`))return;throw e}if(r.isSymbolicLink()){if(n.restrictSymlinkTo!==void 0){pe(e,n.restrictSymlinkTo)&&_(e);return}(t===null||P(e)===t)&&_(e);return}r.isDirectory()&&t!==null&&P(e)===t&&h(e,{recursive:!0,force:!0})}function he(e,t,n={}){let r;try{r=c(e)}catch(e){if(L(e)&&(e.code===`ENOENT`||e.code===`ENOTDIR`))return;throw e}if(r.isSymbolicLink()){if(n.restrictSymlinkTo===void 0||pe(e,n.restrictSymlinkTo)){_(e);return}throw Error(`Refusing to replace symlink at ${e}: it does not route to this CLI's canonical slot (${n.restrictSymlinkTo}). Remove or migrate the foreign symlink before retrying.`)}if(r.isDirectory()&&t!==null&&P(e)===t){h(e,{recursive:!0,force:!0});return}throw Error(`Refusing to replace non-symlink path at ${e}. This looks like a legacy or manual install; remove or migrate it before retrying.`)}function ge(e){let{linkTarget:t,linkPath:n,copyFrom:r,mode:i}=e;if(i===`copy`){_e(r,n);return}j(n,t);try{te(t,n,`dir`)}catch(e){let r=e instanceof Error?e.message:String(e);throw Error(`Failed to symlink ${n} → ${t}: ${r}. If this filesystem does not support symlinks (e.g. Windows without Developer Mode), retry with mode: "copy".`,{cause:e})}}function _e(e,t){let n=u(`${t}.partial-`);try{N(e,n),ee(n,t)}catch(e){try{h(n,{recursive:!0,force:!0})}catch{}throw e}}function N(e,t,n=/* @__PURE__ */ new Set){let r=g(e);if(r.isDirectory()){let r=m(e);if(n.has(r))throw Error(`Refusing to recursively copy cyclic directory symlink at ${e} (resolves to ${r}, already on the copy stack).`);n.add(r);try{l(t,{recursive:!0});for(let r of f(e))N(x(e,r),x(t,r),n)}finally{n.delete(r)}return}r.isFile()&&o(e,t)}function P(e){let t;try{t=d(x(e,`SKILL.md`),`utf-8`)}catch(e){if(L(e)&&(e.code===`ENOENT`||e.code===`ENOTDIR`))return null;throw e}let{data:n}=E(t),r=n.metadata;if(!r||typeof r!=`object`||Array.isArray(r))return null;let i=r[k];return typeof i==`string`?i:null}function F(e,t=process.cwd()){return A(e),s(C(t,D,e,`SKILL.md`))}function I(e,t=process.cwd()){A(e);let n=C(t,D,e,`SKILL.md`),r;try{r=d(n,`utf-8`)}catch(e){if(L(e)&&(e.code===`ENOENT`||e.code===`ENOTDIR`))return null;throw e}let{data:i}=E(r),a=i.metadata;if(!a||typeof a!=`object`||Array.isArray(a))return null;let o=a[k];return typeof o==`string`?o:null}function ve(e,t,n,r,i){for(let a of O){let o=C(e,a);l(o,{recursive:!0});let s=m(o),c=x(s,t);he(c,r,{restrictSymlinkTo:n});let u=m(C(n,`..`));ge({linkTarget:x(S(s,u),t),linkPath:c,copyFrom:n,mode:i})}}function L(e){return e instanceof Error&&typeof e.code==`string`}function ye(e,t){if(e===t)return!0;let n=(e,t)=>{let n=S(t,e);return n===``||n===`.`||!b(n)&&n!==`..`&&!n.startsWith(`..${w}`)};return n(e,t)||n(t,e)}const R=`SKILL.md`;function z(e){let t=[],n=[];try{let r;try{r=g(e)}catch(r){return H(r)&&(r.code===`ENOENT`||r.code===`ENOTDIR`)?n.push({path:e,reason:`missing-source`,message:`Source directory does not exist: ${e}`}):n.push({path:e,reason:`read-failed`,message:`Failed to stat source directory ${e}: ${V(r)}`}),{skills:t,errors:n}}if(!r.isDirectory())return n.push({path:e,reason:`missing-source`,message:`Source path is not a directory: ${e}`}),{skills:t,errors:n};let i=x(e,R),a=xe(i);if(a.kind===`error`)return n.push({path:e,reason:`read-failed`,message:`Failed to check ${i}: ${a.message}`}),{skills:t,errors:n};if(a.kind===`present`)return be(B(e,{enforceParentMatch:!1}),t,n),{skills:t,errors:n};let o=f(e,{withFileTypes:!0});for(let r of o){let i=x(e,r.name),a;try{a=g(i).isDirectory()}catch(e){if(H(e)&&e.code===`ENOENT`&&!r.isSymbolicLink())continue;n.push({path:i,reason:`read-failed`,message:r.isSymbolicLink()?`Dangling symlink at ${i}: ${V(e)}`:`Failed to stat ${i}: ${V(e)}`});continue}if(!a)continue;let o=x(i,R),s=xe(o);if(s.kind===`error`){n.push({path:i,reason:`read-failed`,message:`Failed to check ${o}: ${s.message}`});continue}s.kind!==`absent`&&be(B(i,{enforceParentMatch:!0}),t,n)}}catch(t){n.push({path:e,reason:`read-failed`,message:`Failed to scan ${e}: ${V(t)}`})}return t.sort((e,t)=>e.frontmatter.name<t.frontmatter.name?-1:+(e.frontmatter.name>t.frontmatter.name)),{skills:t,errors:n}}function B(e,t){let n=x(e,R),r;try{r=d(n,`utf-8`)}catch(t){return{path:e,reason:`read-failed`,message:`Failed to read ${n}: ${V(t)}`}}let{data:i,parseError:a}=E(r);if(a!==void 0)return{path:e,reason:`parse-failed`,message:`Invalid SKILL.md frontmatter in ${e}: YAML parse error: ${a}`};let o=ae(i);if(!o.success)return{path:e,reason:`parse-failed`,message:`Invalid SKILL.md frontmatter in ${e}: ${o.issues.map(e=>`${e.path.join(`.`)||`<root>`}: ${e.message}`).join(`; `)}`};if(t.enforceParentMatch){let t=v(e);if(t!==o.data.name)return{path:e,reason:`name-mismatch`,message:`Skill name "${o.data.name}" does not match directory "${t}"`,skillName:o.data.name}}return{frontmatter:o.data,sourcePath:e,rawContent:r}}function be(e,t,n){`frontmatter`in e?t.push(e):n.push(e)}function V(e){return e instanceof Error?e.message:String(e)}function H(e){return e instanceof Error&&typeof e.code==`string`}function xe(e){try{return c(e),{kind:`present`}}catch(e){return H(e)&&e.code===`ENOENT`?{kind:`absent`}:{kind:`error`,message:V(e)}}}function Se(e,t={}){let n=0,r=!1;for(let i of e){if(i.reason===`missing-source`||i.path===t.sourceDir){r=!0,a.warn(`Failed to scan source directory ${i.path}: ${i.message}`);continue}n+=1,a.warn(`Skipping skill at ${i.path}: ${i.message}`)}t.silentStdout||(n>0&&a.info(`${i.warning} Skipped ${n} skill(s) due to scan errors (see warnings above).`),r&&a.info(`${i.warning} Source directory scan failed (see warnings above); subsequent operations may be skipped.`))}function U(e,t){let n=e.errors.some(e=>e.reason===`missing-source`||e.path===t),r=e.errors.length>0&&e.skills.length===0;return n||r}function W(e,t={}){let n=z(e.sourceDir);return Se(n.errors,{...t,sourceDir:e.sourceDir}),n}function Ce(e){let t={description:`Skill names to exclude from sync`};return e.excludeAlias!==void 0&&(t.alias=e.excludeAlias),t}function G(e){let t={description:`Print install paths and modes`};return e.verbose.alias!==void 0&&(t.alias=e.verbose.alias),t}function K(e,t){return!!e[t]}function we(t){function i(e,n){let{skills:r,errors:i}=W(t),o=t.stamp,s=new Set(r.map(e=>e.frontmatter.name)),c=new Set(Pe(o,t.cwd,t.sourceDir)),l=Array.from(new Set(e.exclude)).filter(e=>!s.has(e)&&!c.has(e));if(l.length>0){let e=l.length===1?`Skill`:`Skills`,t=l.map(e=>JSON.stringify(e)).join(`, `);throw Error(`--exclude: ${e} ${t} not found in source directory or among installed skills.\n`+J({source:r,installed:c}))}let u=new Set(e.exclude),d=r.filter(e=>!u.has(e.frontmatter.name)),f=U({skills:r,errors:i},t.sourceDir),p=0;if(!f){let e=new Set(d.map(e=>e.frontmatter.name)),n=/* @__PURE__ */ new Set;for(let e of i)e.path!==t.sourceDir&&(n.add(v(e.path)),e.skillName!==void 0&&n.add(e.skillName));for(let r of c)e.has(r)||u.has(r)||n.has(r)||(X(r,o,t.cwd,t.sourceDir),p+=1)}let m=0;for(let e of d)Y(e,o,t,n),m+=1;if(m===0&&p===0){let e=f?`source directory scan failed; see warnings`:r.length>0&&d.length===0?`all skills excluded`:`no skills bundled`;a.info(`No skills installed (${e}).`)}else a.info(`Sync complete: ${m} installed, ${p} removed.`)}return t.verbose.disabled?r({name:`sync`,description:t.descriptions.sync,args:n({exclude:e.stringArray(Ce(t))},{unknownKeys:t.unknownKeys}),run(e){i(e,K(e,`verbose`))}}):r({name:`sync`,description:t.descriptions.sync,args:n({exclude:e.stringArray(Ce(t)),verbose:e.boolean(G(t))},{unknownKeys:t.unknownKeys}),run(e){i(e,e.verbose)}})}function Te(t){let i={positional:!0,description:`Skill name(s) to install (default: all)`,placeholder:`NAME`};function o(e,n){let r=W(t),i=r.skills,o=t.stamp;if(e.name.length>0){let r=new Set(i.map(e=>e.frontmatter.name)),a=Array.from(new Set(e.name)),s=a.filter(e=>!r.has(e));if(s.length>0){let e=s.length===1?`Skill`:`Skills`,t=s.map(e=>JSON.stringify(e)).join(`, `);throw Error(`${e} ${t} not found in source directory.\n`+J({source:i}))}let c=new Set(a);for(let e of i)c.has(e.frontmatter.name)&&Y(e,o,t,n);return}if(i.length===0){U(r,t.sourceDir)?a.info(`No skills installed (source directory scan failed; see warnings).`):a.info(`No skills found in source directory.`);return}for(let e of i)Y(e,o,t,n)}return t.verbose.disabled?r({name:t.commandNames.add.name,...t.commandNames.add.aliases.length>0?{aliases:t.commandNames.add.aliases}:{},description:t.descriptions.add,args:n({name:e.stringArray(i)},{unknownKeys:t.unknownKeys}),run(e){o(e,K(e,`verbose`))}}):r({name:t.commandNames.add.name,...t.commandNames.add.aliases.length>0?{aliases:t.commandNames.add.aliases}:{},description:t.descriptions.add,args:n({name:e.stringArray(i),verbose:e.boolean(G(t))},{unknownKeys:t.unknownKeys}),run(e){o(e,e.verbose)}})}function Ee(t){return r({name:t.commandNames.remove.name,...t.commandNames.remove.aliases.length>0?{aliases:t.commandNames.remove.aliases}:{},description:t.descriptions.remove,args:n({name:e.optionalString({positional:!0,description:`Skill name to remove (default: all)`,placeholder:`NAME`})},{unknownKeys:t.unknownKeys}),run(e){let n=W(t),r=n.skills,i=t.stamp;if(e.name){if(r.some(t=>t.frontmatter.name===e.name)&&Ae(r,e.name),!X(e.name,i,t.cwd,t.sourceDir)){if(q(e.name,t.cwd))a.info(`${e.name} is installed without a ${k} stamp this CLI recognises; refusing to remove. Remove .agents/skills/${e.name} manually if intended.`);else{let n=new Set(Pe(i,t.cwd,t.sourceDir));a.info(`${e.name} is not installed; nothing to remove.\n`+J({installed:n}))}}return}if(r.length===0){U(n,t.sourceDir)?a.info(`No skills found (source directory scan failed; see warnings); nothing to remove.`):a.info(`No skills found in source directory; nothing to remove.`);return}let o=0;for(let e of r)X(e.frontmatter.name,i,t.cwd,t.sourceDir)&&(o+=1);o===0&&a.info(`No installed skills owned by this CLI; nothing to remove.`)}})}function De(e,t,n,r){let i;try{i=I(e,n)}catch(t){return a.warn(`Failed to read ownership for installed skill ${e}: ${Oe(t)}`),`unreadable`}if(i===t)return`installed`;if(i!==null)return`foreign`;if(!F(e,n)){let t=C(n,D,e);return Q(t)&&Z(t,r)?`missing`:q(e,n)?`unstamped`:`not-installed`}return`unstamped`}function Oe(e){return e instanceof Error?e.message:String(e)}function q(e,t){try{return c(C(t,D,e)),!0}catch{return!1}}function ke(t){function i(e){let n=W(t,{silentStdout:e}),r=n.skills,i=t.stamp;if(e){console.log(JSON.stringify(r.map(e=>({name:e.frontmatter.name,description:e.frontmatter.description,owner:e.frontmatter.metadata?.[`politty-cli`]??null,expectedOwner:i,status:De(e.frontmatter.name,i,t.cwd,t.sourceDir),sourcePath:e.sourcePath}))));return}if(r.length===0){U(n,t.sourceDir)?a.info(`Source directory scan failed; see warnings.`):a.info(`No skills found in source directory.`);return}a.info(`Available skills:`);for(let e of r){let n=De(e.frontmatter.name,i,t.cwd,t.sourceDir);a.info(` ${e.frontmatter.name.padEnd(20)} ${n.padEnd(14)} ${e.frontmatter.description}`)}}return t.json.disabled?r({name:`list`,description:t.descriptions.list,args:n({},{unknownKeys:t.unknownKeys}),run(e){i(K(e,`json`))}}):r({name:`list`,description:t.descriptions.list,args:n({json:e.boolean({description:`Output as JSON`})},{unknownKeys:t.unknownKeys}),run(e){i(e.json)}})}function Ae(e,t){let n=e.find(e=>e.frontmatter.name===t);if(!n){let n=e.map(e=>e.frontmatter.name).join(`, `)||`<none>`;throw Error(`Skill "${t}" not found in source directory. Available: ${n}`)}return n}function J(e){let t=[];return e.source!==void 0&&t.push(` Source: ${e.source.map(e=>e.frontmatter.name).join(`, `)||`<none>`}`),e.installed!==void 0&&t.push(` Installed: ${[...e.installed].sort().join(`, `)||`<none>`}`),t.join(`
2
2
  `)}function Y(e,t,n,r){let o=e.frontmatter.name,s=n.cwd,c=n.mode,l=e.frontmatter.metadata?.[`politty-cli`]??null;if(l!==t)throw Error(`Refusing to install "${o}": source SKILL.md declares metadata.${k}=${JSON.stringify(l)}, expected ${JSON.stringify(t)}.`);let u=I(o,s);if(u!==null&&u!==t)throw Error(`Refusing to install "${o}": owned by ${JSON.stringify(u)}, not ${JSON.stringify(t)}. Check metadata.${k} in .agents/skills/${o}/SKILL.md.`);let d=C(s,D,o),f=Q(d)&&Z(d,n.sourceDir);if(u===null&&q(o,s)&&!f)throw Error(`Refusing to install "${o}": .agents/skills/${o} exists without a ${k} stamp, so it was not installed by this CLI. Remove it manually (or add the stamp to take ownership) before running "skills add".`);if(le(e,s,c===void 0?{}:{mode:c}),a.info(`${i.success} Installed ${o}`),r){let e=c??`symlink`;a.info(` mode=${e} path=${d}`)}}function X(e,t,n,r){let o=I(e,n);if(o===null)return je(e,n,r)?(a.info(`${i.success} Removed ${e} (broken symlink)`),!0):!1;if(o!==t)throw Error(`Refusing to remove "${e}": owned by ${JSON.stringify(o)}, not ${JSON.stringify(t)}. Check metadata.${k} in .agents/skills/${e}/SKILL.md.`);return fe(e,n,{expectedOwnership:t}),a.info(`${i.success} Removed ${e}`),!0}function je(e,t,n){let r=C(t,D,e);if(!Q(r)||!Z(r,n))return!1;for(let n of O){let i=C(t,n,e);Q(i)&&Ne(i,r)&&_(i)}return _(r),!0}function Z(e,t){let n;try{n=p(e)}catch{return!1}let r=b(n)?n:C(y(e),n),i=Me(C(t)),a=Me(r),o=S(i,a);return!(b(o)||o===`..`||o.startsWith(`..${w}`))}function Me(e){let t=e,n=[];for(;;)try{let e=m(t);return n.length===0?e:C(e,...n.reverse())}catch{let r=y(t);if(r===t)return e;n.push(t.slice(r.length).replace(/^[/\\]+/,``)),t=r}}function Ne(e,t){let n;try{n=p(e)}catch{return!1}let r=b(n)?n:C(y(e),n);if(r===t)return!0;try{return m(r)===m(t)}catch{return!1}}function Q(e){let t;try{t=c(e)}catch{return!1}return t.isSymbolicLink()?!s(e):!1}function Pe(e,t,n){let r=C(t,D),i=[],o;try{o=f(r,{withFileTypes:!0})}catch(e){let t=e.code;return t===`ENOENT`||t===`ENOTDIR`||a.warn(`Failed to enumerate ${r}: ${e instanceof Error?e.message:String(e)}`),i}for(let s of o){if(!s.isDirectory()&&!s.isSymbolicLink()||s.name.length<1||s.name.length>64||!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(s.name))continue;let o;try{o=I(s.name,t)}catch(e){a.warn(`Failed to read ownership for ${s.name}: ${e instanceof Error?e.message:String(e)}`);continue}if(o===e){i.push(s.name);continue}let c=C(r,s.name);o===null&&Q(c)&&Z(c,n)&&i.push(s.name)}return i}const Fe=[`add`,`install`],Ie=[`remove`,`uninstall`],$={skills:`Manage agent skills`,sync:`Remove and reinstall all skills from source`,add:`Install skills from source`,remove:`Remove installed skills`,list:`List available skills from source`},Le=/^[a-zA-Z0-9][a-zA-Z0-9_-]*$/,Re=[`.git`,`package.json`];function ze(e,t){return{sourceDir:e.sourceDir,package:e.package,mode:e.mode,cwd:Ve(e.cwd),excludeAlias:Ue(e.flags?.exclude?.alias),verbose:Ge(e.flags?.verbose,e.globalArgs),json:{disabled:Ke(e.globalArgs,`json`)},commandNames:{add:We(e.commandMap?.add,Fe,`add`),remove:We(e.commandMap?.remove,Ie,`remove`)},unknownKeys:e.unknownKeys??`strip`,descriptionAppend:qe(e.descriptionAppend,t),stamp:`${e.package}:${t}`,descriptions:Be(e.descriptions)}}function Be(e){return{skills:e?.skills??$.skills,sync:e?.sync??$.sync,add:e?.add??$.add,remove:e?.remove??$.remove,list:e?.list??$.list}}function Ve(e){if(e!==void 0)return C(e);let t=process.cwd();return He(t)??t}function He(e){let t=C(e);for(;;){for(let e of Re)if(s(C(t,e)))return t;let e=y(t);if(e===t)return null;t=e}}function Ue(e){if(e!==!1)return typeof e==`string`?e:`x`}function We(e,t,n){let r=e??t;if(r.length===0)throw Error(`SkillCommandOptions.commandMap.${n} must include at least one name.`);let i=r.find(e=>!Le.test(e));if(i!==void 0)throw Error(`SkillCommandOptions.commandMap.${n} contains an invalid entry ${JSON.stringify(i)}. Names/aliases must start with an alphanumeric character and contain only alphanumeric characters, hyphens, or underscores.`);return{name:r[0],aliases:r.slice(1)}}function Ge(e,t){return{alias:e?.alias===!1?void 0:e?.alias??`v`,disabled:Ke(t,`verbose`)}}function Ke(e,n){return e?t(e).fields.some(e=>e.name===n&&e.named&&e.type===`boolean`):!1}function qe(e,t){return e===!1?!1:typeof e==`string`?e:`Manage agent skills with \`${t} skills <add|sync|remove|list>\`.`}const Je=[`parse-failed`,`name-mismatch`,`read-failed`,`missing-source`];function Ye(e,t){if(e.subCommands&&Object.hasOwn(e.subCommands,`skills`))throw Error(`withSkillCommand: command "${e.name}" already defines a "skills" subcommand.`);let n=ze(t,e.name),i=n.commandNames.add.name,a=n.commandNames.remove.name,o=[`sync`,`list`,i,...n.commandNames.add.aliases,a,...n.commandNames.remove.aliases],s=o.find((e,t)=>o.indexOf(e)!==t);if(s)throw Error(`withSkillCommand: commandMap produced duplicate subcommand name/alias "${s}".`);let c=r({name:`skills`,description:n.descriptions.skills,subCommands:{sync:we(n),[i]:Te(n),[a]:Ee(n),list:ke(n)}});return{...e,description:Xe(e.description,n.descriptionAppend),subCommands:{...e.subCommands,skills:c}}}function Xe(e,t){return t===!1||t===``?e:e?e.endsWith(t)?e:`${e}\n\n${t}`:t}export{k as OWNERSHIP_METADATA_KEY,Je as SCAN_ERROR_REASONS,F as hasInstalledSkill,le as installSkill,E as parseFrontmatter,ce as parseSkillMd,I as readInstalledOwnership,z as scanSourceDir,fe as uninstallSkill,Ye as withSkillCommand};
@@ -0,0 +1,2 @@
1
+ import{readFileSync as e,statSync as t}from"node:fs";import{dirname as n,join as r}from"node:path";import{fileURLToPath as i,pathToFileURL as a}from"node:url";const o={npm:`npm install`,pnpm:`pnpm add`,yarn:`yarn add`,bun:`bun add`},s=[[`pnpm-lock.yaml`,`pnpm`],[`bun.lock`,`bun`],[`bun.lockb`,`bun`],[`yarn.lock`,`yarn`],[`package-lock.json`,`npm`],[`npm-shrinkwrap.json`,`npm`]];function c(a){if(a.install!==void 0)return a.install;let c=a.from?new URL(a.from):void 0,l=c?.protocol===`file:`?i(new URL(`.`,c)):process.cwd(),u=`npm`;for(;;){try{let t=JSON.parse(e(r(l,`package.json`),`utf8`));if(typeof t==`object`&&t&&`packageManager`in t&&typeof t.packageManager==`string`){let e=t.packageManager.split(`@`)[0];if(e===`npm`||e===`pnpm`||e===`yarn`||e===`bun`){u=e;break}}}catch{}let i=s.find(([e])=>{try{return t(r(l,e)).isFile()}catch{return!1}});if(i){u=i[1];break}let a=n(l);if(a===l)break;l=a}return`${o[u]} -D ${a.name}`}async function l(e){let{resolve:t}=await import(`./import-meta-resolve-DgKm4LYW.js`),n=e.from?.toString()??a(r(process.cwd(),`package.json`)).href,i;try{i=t(e.name,n)}catch(t){throw t instanceof Error&&`code`in t&&t.code===`ERR_MODULE_NOT_FOUND`&&t.message.startsWith(`Cannot find package '${e.name}' imported from `)?Error(`Package "${e.name}" is required. Install it with: ${c(e)}`,{cause:t}):t}return import(i)}async function u(e,t){for(let n of e??[])(!n.when||n.when(t))&&await l(n)}function d(e){return(e??[]).map(e=>`${e.description?`${e.description}: `:``}Requires ${e.name}; install with: ${c(e)}`).join(`
2
+ `)}const f=`__politty_lazy__`;function p(e){return typeof e==`object`&&!!e&&f in e&&e[f]===!0}function m(e,t){return{[f]:!0,meta:e,load:e.requiredPackages?.length?async()=>(await u(e.requiredPackages?.filter(e=>!e.when),{}),t()):t}}function h(e){return p(e)?e.meta:typeof e==`function`?null:e}async function g(e,t){return p(e)?t?.(e.meta)?e.meta:await e.load():typeof e==`function`?await e():e}async function _(e,t,n){if(!e.subCommands)return;let r=Object.hasOwn(e.subCommands,t)?e.subCommands[t]:void 0;if(r)return{command:await g(r,n),aliasFor:void 0};let i=v(e,t);if(i)return{command:await g(e.subCommands[i],n),aliasFor:i}}function v(e,t){if(e.subCommands){for(let[n,r]of Object.entries(e.subCommands))if(h(r)?.aliases?.includes(t))return n}}function y(e){let t=/* @__PURE__ */ new Set;if(!e.subCommands)return t;for(let[n,r]of Object.entries(e.subCommands)){t.add(n);let e=h(r);if(e?.aliases)for(let n of e.aliases)t.add(n)}return t}function b(e){return e.subCommands?Object.keys(e.subCommands):[]}export{_ as a,h as c,l as d,u as f,v as i,d as l,b as n,p as o,g as r,m as s,y as t,c as u};
@@ -45,6 +45,16 @@ interface SchemaLike<Output = unknown> {
45
45
  /** Infer the output type of a {@link SchemaLike}. */
46
46
  type InferSchemaOutput<S> = S extends SchemaLike ? NonNullable<S["~standard"]["types"]>["output"] : never;
47
47
  //#endregion
48
+ //#region ../core/src/package-requirements.d.ts
49
+ interface PackageRequirement<TArgs = unknown> {
50
+ name: string;
51
+ install?: string | undefined;
52
+ from?: string | URL | undefined;
53
+ description?: string | undefined;
54
+ when?: ((args: TArgs) => boolean) | undefined;
55
+ }
56
+ declare function loadPackage<TModule = unknown>(requirement: Pick<PackageRequirement, "name" | "install" | "from">): Promise<TModule>;
57
+ //#endregion
48
58
  //#region ../core/src/core/dynamic-completion-types.d.ts
49
59
  /**
50
60
  * Types for in-process dynamic value completion.
@@ -294,6 +304,7 @@ type EffectContext = {
294
304
  * Base metadata shared by all argument types
295
305
  */
296
306
  interface BaseArgMeta<TValue = unknown> {
307
+ requiredPackages?: readonly Pick<PackageRequirement, "name" | "install" | "from">[];
297
308
  /** Argument description */
298
309
  description?: string;
299
310
  /**
@@ -534,6 +545,7 @@ interface ArgFn<TSchemaBase extends SchemaLike = SchemaLike> {
534
545
  * Resolved metadata for an argument field
535
546
  */
536
547
  interface ResolvedFieldMeta {
548
+ requiredPackages?: readonly Pick<PackageRequirement, "name" | "install" | "from">[] | undefined;
537
549
  /** Field name (camelCase, as defined in schema) */
538
550
  name: string;
539
551
  /** CLI option name (kebab-case, for command line usage) */
@@ -623,6 +635,7 @@ interface ExtractedFields {
623
635
  /** Variants (for discriminatedUnion) */
624
636
  variants?: Array<{
625
637
  discriminatorValue: string;
638
+ normalizeDiscriminator?: (value: unknown) => unknown;
626
639
  fields: ResolvedFieldMeta[];
627
640
  description?: string;
628
641
  }>;
@@ -839,6 +852,7 @@ interface CommandBase<TArgsSchema extends ArgsSchema | undefined = undefined, TA
839
852
  aliases?: string[] | undefined;
840
853
  /** Argument schema (preserves the original schema type) */
841
854
  args: TArgsSchema;
855
+ requiredPackages?: readonly PackageRequirement<TArgs>[] | undefined;
842
856
  /** Subcommands */
843
857
  subCommands?: SubCommandsRecord | undefined;
844
858
  /** Setup hook */
@@ -1108,4 +1122,4 @@ interface RunResultFailure {
1108
1122
  */
1109
1123
  type RunResult<T = unknown> = RunResultSuccess<T> | RunResultFailure;
1110
1124
  //#endregion
1111
- export { DynamicCompletionCandidate as $, SubCommandsRecord as A, ArgFn as B, RunInvocation as C, RunnableCommand as D, RunResultSuccess as E, ExtractedFields as F, EffectContext as G, CompletionMeta as H, ResolvedFieldMeta as I, ValidateArgMeta as J, PromptMeta as K, UnknownKeysMode as L, LazyCommand as M, isLazyCommand as N, SetupContext as O, lazy as P, CompletionDirectiveMask as Q, toCamelCase as R, RunCommandOptions as S, RunResultFailure as T, CompletionType as U, ArgMeta as V, CustomCompletion as W, ExpandCompletion as X, ExpandCandidate as Y, ResolvedExpandCandidate as Z, LogStream as _, ArgsSchema as a, NonRunnableCommand as b, Command as c, GlobalArgs as d, DynamicCompletionContext as et, GlobalCleanupContext as f, LogLevel as g, LogEntry as h, ArgSource as i, SchemaLike as it, UnknownSubcommandHandler as j, SubCommandValue as k, CommandBase as l, IsEmpty as m, AgentHelpContext as n, DynamicCompletionResult as nt, CleanupContext as o, GlobalSetupContext as p, PromptType as q, AnyCommand as r, InferSchemaOutput as rt, CollectedLogs as s, AgentHelp as t, DynamicCompletionResolver as tt, Example as u, Logger as v, RunResult as w, PromptResolver as x, MainOptions as y, toKebabCase as z };
1125
+ export { DynamicCompletionCandidate as $, SubCommandsRecord as A, ArgFn as B, RunInvocation as C, RunnableCommand as D, RunResultSuccess as E, ExtractedFields as F, EffectContext as G, CompletionMeta as H, ResolvedFieldMeta as I, ValidateArgMeta as J, PromptMeta as K, UnknownKeysMode as L, LazyCommand as M, isLazyCommand as N, SetupContext as O, lazy as P, CompletionDirectiveMask as Q, toCamelCase as R, RunCommandOptions as S, RunResultFailure as T, CompletionType as U, ArgMeta as V, CustomCompletion as W, ExpandCompletion as X, ExpandCandidate as Y, ResolvedExpandCandidate as Z, LogStream as _, ArgsSchema as a, InferSchemaOutput as at, NonRunnableCommand as b, Command as c, GlobalArgs as d, DynamicCompletionContext as et, GlobalCleanupContext as f, LogLevel as g, LogEntry as h, ArgSource as i, loadPackage as it, UnknownSubcommandHandler as j, SubCommandValue as k, CommandBase as l, IsEmpty as m, AgentHelpContext as n, DynamicCompletionResult as nt, CleanupContext as o, SchemaLike as ot, GlobalSetupContext as p, PromptType as q, AnyCommand as r, PackageRequirement as rt, CollectedLogs as s, AgentHelp as t, DynamicCompletionResolver as tt, Example as u, Logger as v, RunResult as w, PromptResolver as x, MainOptions as y, toKebabCase as z };
@@ -1,3 +1,3 @@
1
- import{d as e,u as t}from"./schema-extractor-Cfy1t5nw.js";import{n}from"./command-tLHaJHe6.js";import{s as r}from"./subcommand-router-DR2KBQAt.js";import{t as i}from"./schema-C3FuGLp7.js";import{existsSync as a,readFileSync as o}from"node:fs";import{join as s}from"node:path";import{spawn as c}from"node:child_process";function l(){let e=(process.env.SHELL||``).split(`/`).pop()?.toLowerCase()||``;return e.includes(`bash`)?`bash`:e.includes(`zsh`)?`zsh`:e.includes(`fish`)?`fish`:null}function u(e){return`${process.env.XDG_CACHE_HOME??`${process.env.HOME??``}/.cache`}/${e}`}function d(e,t,n){if(t===`fish`){let t=process.env.XDG_CONFIG_HOME??`${process.env.HOME??``}/.config`;return s(t,`fish`,`completions`,`${e}.fish`)}let r=n??u(e);return s(r,`completion.${t}`)}function f(e){try{if(!a(e))return null;let t=o(e,`utf8`).split(`
1
+ import{d as e,u as t}from"./schema-extractor-BkbKiMq_.js";import{n}from"./command-BXsTrIgI.js";import{s as r}from"./subcommand-router-iqmWGZyU.js";import{t as i}from"./schema-CmhHwi3R.js";import{existsSync as a,readFileSync as o}from"node:fs";import{join as s}from"node:path";import{spawn as c}from"node:child_process";function l(){let e=(process.env.SHELL||``).split(`/`).pop()?.toLowerCase()||``;return e.includes(`bash`)?`bash`:e.includes(`zsh`)?`zsh`:e.includes(`fish`)?`fish`:null}function u(e){return`${process.env.XDG_CACHE_HOME??`${process.env.HOME??``}/.cache`}/${e}`}function d(e,t,n){if(t===`fish`){let t=process.env.XDG_CONFIG_HOME??`${process.env.HOME??``}/.config`;return s(t,`fish`,`completions`,`${e}.fish`)}let r=n??u(e);return s(r,`completion.${t}`)}function f(e){try{if(!a(e))return null;let t=o(e,`utf8`).split(`
2
2
  `,6).join(`
3
- `).match(/^# politty-bin-sig: (\S+)/m);return t?t[1]:null}catch{return null}}function p(e,t){return f(d(e.programName,t,e.cacheDir))!==null}function m(e,t){try{c(process.execPath,[e,`__refresh-completion`,t],{detached:!0,stdio:`ignore`}).unref()}catch{}}const h=t({shell:e.optionalEnum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell type (bash, zsh, or fish)`,placeholder:`SHELL`}),instructions:e.boolean({alias:`i`,description:`Show installation instructions`}),loader:e.boolean({description:`Print just the rc loader snippet (bash/zsh). Add it to ~/.bashrc or ~/.zshrc; it auto-regenerates the cache when the binary changes.`}),install:e.boolean({description:`Write the completion script to its on-disk cache (bash/zsh) or autoload location (fish) instead of printing it.`}),static:e.boolean({description:`Generate the legacy static completion script with command metadata baked in.`}),dispatcher:e.boolean({description:`Generate the runtime dispatcher completion script. This is the default.`}),worker:e.boolean({description:`Generate an internal static worker artifact for dispatcher mode.`})}),g=t({shell:e.enum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell to refresh`,placeholder:`SHELL`}),target:e.optionalString({positional:!0,description:`Existing politty-generated completion file to refresh`,placeholder:`TARGET`}),static:e.boolean({description:`Refresh using the legacy static completion script mode.`}),worker:e.boolean({description:`Refresh an internal static worker completion script.`})}),_=t({shell:e.enum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell worker to locate`,placeholder:`SHELL`})});function v(e,t){let{programName:a,globalArgsSchema:o,cacheDir:s,programVersion:c,bundledWorker:l}=typeof t==`string`?{programName:t}:t??{},u=a??e.name,d={...s!==void 0&&{cacheDir:s},...c!==void 0&&{programVersion:c},...o!==void 0&&{globalArgsSchema:o},...l!==void 0&&{bundledWorker:l}},f={...e};return f.subCommands={...e.subCommands,completion:r(n({name:`completion`,description:`Generate shell completion script`,args:h,run(){}}),()=>import(`./completion-v15TEHvM.js`).then(e=>e.createCompletionCommand(f,a,o,d))),__complete:r(n({name:`__complete`,args:i,run(){}}),()=>import(`./dynamic-DExEgytC.js`).then(e=>e.createDynamicCompleteCommand(f,a,o))),"__refresh-completion":r(n({name:`__refresh-completion`,description:`(internal) Refresh the on-disk completion cache if stale.`,args:g,run(){}}),()=>import(`./completion-v15TEHvM.js`).then(e=>e.createRefreshCompletionCommand(f,u,d))),"__completion-worker-path":r(n({name:`__completion-worker-path`,description:`(internal) Print the bundled completion worker path when available.`,args:_,run(){}}),()=>import(`./completion-v15TEHvM.js`).then(e=>e.createCompletionWorkerPathCommand(u,d)))},f.runMainHook=e=>{y(e,{programName:u,...s!==void 0&&{cacheDir:s}})},f}function y(e,t){if(process.env.POLITTY_NO_COMPLETION_REFRESH)return;let n=e.find(e=>!e.startsWith(`-`));if(n===`__complete`||n===`__refresh-completion`||n===`__completion-worker-path`||n===`completion`)return;let r=l();if(!r)return;let i=process.argv[1];i&&p(t,r)&&m(i,r)}export{d as a,_ as i,h as n,f as o,g as r,l as s,v as t};
3
+ `).match(/^# politty-bin-sig: (\S+)/m);return t?t[1]:null}catch{return null}}function p(e,t){return f(d(e.programName,t,e.cacheDir))!==null}function m(e,t){try{c(process.execPath,[e,`__refresh-completion`,t],{detached:!0,stdio:`ignore`}).unref()}catch{}}const h=t({shell:e.optionalEnum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell type (bash, zsh, or fish)`,placeholder:`SHELL`}),instructions:e.boolean({alias:`i`,description:`Show installation instructions`}),loader:e.boolean({description:`Print just the rc loader snippet (bash/zsh). Add it to ~/.bashrc or ~/.zshrc; it auto-regenerates the cache when the binary changes.`}),install:e.boolean({description:`Write the completion script to its on-disk cache (bash/zsh) or autoload location (fish) instead of printing it.`}),static:e.boolean({description:`Generate the legacy static completion script with command metadata baked in.`}),dispatcher:e.boolean({description:`Generate the runtime dispatcher completion script. This is the default.`}),worker:e.boolean({description:`Generate an internal static worker artifact for dispatcher mode.`})}),g=t({shell:e.enum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell to refresh`,placeholder:`SHELL`}),target:e.optionalString({positional:!0,description:`Existing politty-generated completion file to refresh`,placeholder:`TARGET`}),static:e.boolean({description:`Refresh using the legacy static completion script mode.`}),worker:e.boolean({description:`Refresh an internal static worker completion script.`})}),_=t({shell:e.enum([`bash`,`zsh`,`fish`],{positional:!0,description:`Shell worker to locate`,placeholder:`SHELL`})});function v(e,t){let{programName:a,globalArgsSchema:o,cacheDir:s,programVersion:c,bundledWorker:l}=typeof t==`string`?{programName:t}:t??{},u=a??e.name,d={...s!==void 0&&{cacheDir:s},...c!==void 0&&{programVersion:c},...o!==void 0&&{globalArgsSchema:o},...l!==void 0&&{bundledWorker:l}},f={...e};return f.subCommands={...e.subCommands,completion:r(n({name:`completion`,description:`Generate shell completion script`,args:h,run(){}}),()=>import(`./completion-CQFm_cbd.js`).then(e=>e.createCompletionCommand(f,a,o,d))),__complete:r(n({name:`__complete`,args:i,run(){}}),()=>import(`./dynamic-CpL0yvfn.js`).then(e=>e.createDynamicCompleteCommand(f,a,o))),"__refresh-completion":r(n({name:`__refresh-completion`,description:`(internal) Refresh the on-disk completion cache if stale.`,args:g,run(){}}),()=>import(`./completion-CQFm_cbd.js`).then(e=>e.createRefreshCompletionCommand(f,u,d))),"__completion-worker-path":r(n({name:`__completion-worker-path`,description:`(internal) Print the bundled completion worker path when available.`,args:_,run(){}}),()=>import(`./completion-CQFm_cbd.js`).then(e=>e.createCompletionWorkerPathCommand(u,d)))},f.runMainHook=e=>{y(e,{programName:u,...s!==void 0&&{cacheDir:s}})},f}function y(e,t){if(process.env.POLITTY_NO_COMPLETION_REFRESH)return;let n=e.find(e=>!e.startsWith(`-`));if(n===`__complete`||n===`__refresh-completion`||n===`__completion-worker-path`||n===`completion`)return;let r=l();if(!r)return;let i=process.argv[1];i&&p(t,r)&&m(i,r)}export{d as a,_ as i,h as n,f as o,g as r,l as s,v as t};
@@ -1,4 +1,4 @@
1
- import { L as UnknownKeysMode, V as ArgMeta, Z as ResolvedExpandCandidate, a as ArgsSchema, r as AnyCommand, tt as DynamicCompletionResolver } from "./types-BvnlWosT.js";
1
+ import { L as UnknownKeysMode, V as ArgMeta, Z as ResolvedExpandCandidate, a as ArgsSchema, r as AnyCommand, tt as DynamicCompletionResolver } from "./types-Dhar1ua6.js";
2
2
  //#region ../core/src/adapter/internal-args.d.ts
3
3
  /** Runtime brand distinguishing internal descriptors from library schemas. */
4
4
  declare const INTERNAL_ARGS_BRAND = "__polittyInternalArgs";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@politty/valibot",
3
- "version": "0.5.0",
3
+ "version": "0.5.2",
4
4
  "description": "A lightweight CLI framework inspired by citty with valibot integration for type-safe metadata management",
5
5
  "keywords": [
6
6
  "argument-parser",
@@ -1 +0,0 @@
1
- import{t as e}from"./cli-main-BcoGh-U_.js";export{e as runPolittyCli};
@@ -1 +0,0 @@
1
- import"./register-AMVOXtkb.js";const{runPolittyCli:e}=await import(`./cli-main-C3zTbAGt.js`);await e(`@politty/valibot`);export{};
@@ -1 +0,0 @@
1
- function e(e){return{name:e.name,description:e.description,aliases:e.aliases,args:e.args,subCommands:e.subCommands,defaultSubCommand:e.defaultSubCommand,setup:e.setup,run:e.run,cleanup:e.cleanup,notes:e.notes,examples:e.examples}}function t(){return e}export{e as n,t};
@@ -1 +0,0 @@
1
- import"./with-completion-command-Cbjaz6M5.js";import"./dynamic-CmlJ0BBS.js";import{c as e,n as t,r as n,t as r}from"./completion-DCl24IUz.js";export{r as createCompletionCommand,t as createCompletionWorkerPathCommand,n as createRefreshCompletionCommand,e as generateBundledCompletionWorker};
@@ -1 +0,0 @@
1
- import{t as e}from"./dynamic-CmlJ0BBS.js";export{e as createDynamicCompleteCommand};
@@ -1 +0,0 @@
1
- function e(e){let t=e.prompt;if(!t||t.enabled===!1)return null;let i=t.message??e.description??e.name,a=n(e,t),o=r(e,t,a);return{field:e,type:a===`select`&&!o?`text`:a,message:i,...o&&{choices:o}}}function t(e){return e!==void 0&&e.length>0}function n(e,n){return n.type?n.type===`file`||n.type===`directory`?`text`:n.type:t(n.choices)?`select`:e.completion?.type===`file`||e.completion?.type===`directory`?`text`:t(e.enumValues)?`select`:e.type===`boolean`?`confirm`:`text`}function r(e,n,r){if(t(n.choices))return n.choices.map(e=>typeof e==`string`?{label:e,value:e}:e);if(r===`select`&&t(e.enumValues))return e.enumValues.map(e=>({label:e,value:e}))}function i(t,n){let r=[];for(let i of t){if(n[i.name]!==void 0||i.type===`array`)continue;let t=e(i);t&&r.push(t)}return r}function a(){return!(!process.stdin.isTTY||!process.stdout.isTTY||process.env.CI||process.env.POLITTY_NO_PROMPT)}async function o(e,t,n){if(!(n.interactive??a()))return e;let r=n.adapter,i={...e};return t.schemaType===`discriminatedUnion`&&t.discriminator&&t.variants?await s(r,i,t):t.schemaType===`union`||t.schemaType===`xor`||await l(r,i,t.fields),i}async function s(t,n,r){let{discriminator:i,variants:a}=r;if(!i||!a)return;if(n[i]===void 0){let o=c(r.fields,a,i),s=o?e(o):null;if(s){let e=a.map(e=>e.discriminatorValue).filter(Boolean);e.length>0&&(s.type=`select`,s.choices=e.map(e=>({label:e,value:e}))),await u(t,n,s)}}let o=String(n[i]??``),s=a.find(e=>e.discriminatorValue===o);s&&await l(t,n,s.fields.filter(e=>e.name!==i))}function c(e,t,n){let r=e.find(e=>e.name===n);if(r?.prompt)return r;for(let e of t){let t=e.fields.find(e=>e.name===n);if(t?.prompt)return t}}async function l(e,t,n){let r=i(n,t);for(let n of r)await u(e,t,n)}async function u(e,t,n){let{message:r}=n,i;switch(n.type){case`text`:i=await e.text({message:r,placeholder:n.field.placeholder});break;case`password`:i=await e.password({message:r});break;case`confirm`:i=await e.confirm({message:r});break;case`select`:i=await e.select({message:r,options:n.choices??[]})}if(e.isCancelled(i))throw Error(`Prompt cancelled by user`);t[n.field.name]=i}export{e as i,a as n,i as r,o as t};
@@ -1 +0,0 @@
1
- import{t as e}from"./runner-D0ibMa6Q.js";export{e as runCommand};