@psnext/slingcli 2.5.20260727-1 → 2.5.20260731-1

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 (235) hide show
  1. package/bin/sling.js +163 -0
  2. package/node_modules/@aws-sdk/core/dist-cjs/submodules/protocols/index.js +856 -57
  3. package/node_modules/@aws-sdk/core/dist-es/submodules/protocols/index.js +8 -5
  4. package/node_modules/@aws-sdk/core/dist-es/submodules/protocols/json/AwsJsonRpcProtocol.js +1 -1
  5. package/node_modules/@aws-sdk/core/dist-es/submodules/protocols/json/AwsRestJsonProtocol.js +1 -1
  6. package/node_modules/@aws-sdk/core/dist-es/submodules/protocols/json/JsonSettings.js +1 -0
  7. package/node_modules/@aws-sdk/core/dist-es/submodules/protocols/json/{JsonCodec.js → codec-v1/JsonCodec.js} +1 -1
  8. package/node_modules/@aws-sdk/core/dist-es/submodules/protocols/json/codec-v1/JsonSettings.js +1 -0
  9. package/node_modules/@aws-sdk/core/dist-es/submodules/protocols/json/{JsonShapeDeserializer.js → codec-v1/JsonShapeDeserializer.js} +6 -6
  10. package/node_modules/@aws-sdk/core/dist-es/submodules/protocols/json/{JsonShapeSerializer.js → codec-v1/JsonShapeSerializer.js} +3 -3
  11. package/node_modules/@aws-sdk/core/dist-es/submodules/protocols/json/codec-v2/JsonBytesStringAdapter.js +103 -0
  12. package/node_modules/@aws-sdk/core/dist-es/submodules/protocols/json/codec-v2/JsonCodec2.js +20 -0
  13. package/node_modules/@aws-sdk/core/dist-es/submodules/protocols/json/{experimental/BufferJsonShapeDeserializer.js → codec-v2/JsonShapeDeserializer2.js} +38 -18
  14. package/node_modules/@aws-sdk/core/dist-es/submodules/protocols/json/{experimental/ByteJsonShapeSerializer.js → codec-v2/JsonShapeSerializer2.js} +66 -60
  15. package/node_modules/@aws-sdk/core/dist-types/submodules/protocols/index.d.ts +9 -6
  16. package/node_modules/@aws-sdk/core/dist-types/submodules/protocols/json/AwsJson1_0Protocol.d.ts +1 -1
  17. package/node_modules/@aws-sdk/core/dist-types/submodules/protocols/json/AwsJson1_1Protocol.d.ts +1 -1
  18. package/node_modules/@aws-sdk/core/dist-types/submodules/protocols/json/AwsJsonRpcProtocol.d.ts +1 -1
  19. package/node_modules/@aws-sdk/core/dist-types/submodules/protocols/json/AwsRestJsonProtocol.d.ts +1 -1
  20. package/node_modules/@aws-sdk/core/dist-types/submodules/protocols/json/JsonSettings.d.ts +7 -0
  21. package/node_modules/@aws-sdk/core/dist-types/submodules/protocols/json/{JsonCodec.d.ts → codec-v1/JsonCodec.d.ts} +4 -8
  22. package/node_modules/@aws-sdk/core/dist-types/submodules/protocols/json/codec-v1/JsonSettings.d.ts +7 -0
  23. package/node_modules/@aws-sdk/core/dist-types/submodules/protocols/json/{JsonShapeDeserializer.d.ts → codec-v1/JsonShapeDeserializer.d.ts} +3 -2
  24. package/node_modules/@aws-sdk/core/dist-types/submodules/protocols/json/{JsonShapeSerializer.d.ts → codec-v1/JsonShapeSerializer.d.ts} +3 -2
  25. package/node_modules/@aws-sdk/core/dist-types/submodules/protocols/json/codec-v2/JsonBytesStringAdapter.d.ts +51 -0
  26. package/node_modules/@aws-sdk/core/dist-types/submodules/protocols/json/codec-v2/JsonCodec2.d.ts +13 -0
  27. package/node_modules/@aws-sdk/core/dist-types/submodules/protocols/json/{experimental/BufferJsonShapeDeserializer.d.ts → codec-v2/JsonShapeDeserializer2.d.ts} +4 -3
  28. package/node_modules/@aws-sdk/core/dist-types/submodules/protocols/json/{experimental/ByteJsonShapeSerializer.d.ts → codec-v2/JsonShapeSerializer2.d.ts} +19 -16
  29. package/node_modules/@aws-sdk/core/dist-types/ts3.4/api-extractor-type-index.d.ts +4 -7
  30. package/node_modules/@aws-sdk/core/dist-types/ts3.4/index.d.ts +61 -21
  31. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/account-id-endpoint/AccountIdEndpointModeConfigResolver.d.ts +13 -27
  32. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/account-id-endpoint/AccountIdEndpointModeConstants.d.ts +4 -16
  33. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/account-id-endpoint/NodeAccountIdEndpointModeConfigOptions.d.ts +5 -14
  34. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/account-id-endpoint/index.d.ts +16 -5
  35. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/emitWarningIfUnsupportedVersion.d.ts +4 -11
  36. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/index.browser.d.ts +107 -47
  37. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/index.d.ts +112 -39
  38. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/index.native.d.ts +107 -48
  39. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/longPollMiddleware.d.ts +13 -14
  40. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/middleware-host-header/hostHeaderMiddleware.d.ts +25 -35
  41. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/middleware-logger/loggerMiddleware.d.ts +14 -4
  42. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/middleware-recursion-detection/configuration.d.ts +2 -6
  43. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/middleware-recursion-detection/getRecursionDetectionPlugin.browser.d.ts +2 -5
  44. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/middleware-recursion-detection/getRecursionDetectionPlugin.d.ts +2 -5
  45. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/middleware-recursion-detection/recursionDetectionMiddleware.browser.d.ts +2 -6
  46. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/middleware-recursion-detection/recursionDetectionMiddleware.d.ts +2 -10
  47. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/middleware-recursion-detection/recursionDetectionMiddleware.native.d.ts +2 -6
  48. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/middleware-user-agent/check-features.d.ts +16 -20
  49. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/middleware-user-agent/configurations.d.ts +21 -44
  50. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/middleware-user-agent/constants.d.ts +7 -7
  51. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/middleware-user-agent/encode-features.d.ts +2 -5
  52. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/middleware-user-agent/user-agent-middleware.d.ts +18 -18
  53. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/region-config-resolver/awsRegionConfig.d.ts +8 -11
  54. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/region-config-resolver/extensions.d.ts +14 -16
  55. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/region-config-resolver/stsRegionDefaultResolver.browser.d.ts +1 -4
  56. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/region-config-resolver/stsRegionDefaultResolver.d.ts +7 -14
  57. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/region-config-resolver/stsRegionDefaultResolver.native.d.ts +1 -4
  58. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/setCredentialFeature.d.ts +6 -7
  59. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/setFeature.d.ts +6 -12
  60. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/setTokenFeature.d.ts +6 -7
  61. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/util-endpoints/aws.d.ts +2 -2
  62. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/util-endpoints/lib/aws/isVirtualHostableS3Bucket.d.ts +4 -5
  63. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/util-endpoints/lib/aws/parseArn.d.ts +2 -7
  64. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/util-endpoints/lib/aws/partition.d.ts +28 -38
  65. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/util-endpoints/lib/aws/partitions.d.ts +647 -638
  66. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/util-endpoints/lib/isIpAddress.d.ts +1 -1
  67. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/util-endpoints/resolveDefaultAwsRegionalEndpointsConfig.d.ts +29 -56
  68. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/util-endpoints/resolveEndpoint.d.ts +1 -1
  69. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/util-endpoints/types/EndpointError.d.ts +1 -1
  70. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/util-endpoints/types/EndpointRuleObject.d.ts +6 -1
  71. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/util-endpoints/types/ErrorRuleObject.d.ts +1 -1
  72. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/util-endpoints/types/RuleSetObject.d.ts +1 -1
  73. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/util-endpoints/types/TreeRuleObject.d.ts +1 -1
  74. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/util-endpoints/types/shared.d.ts +12 -1
  75. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/util-user-agent-browser/configurations.d.ts +4 -7
  76. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/util-user-agent-browser/createUserAgentStringParsingProvider.d.ts +7 -14
  77. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/util-user-agent-browser/defaultUserAgent.browser.d.ts +7 -2
  78. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/util-user-agent-browser/defaultUserAgent.d.ts +18 -27
  79. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/util-user-agent-browser/defaultUserAgent.native.d.ts +13 -18
  80. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/util-user-agent-node/crt-availability.d.ts +3 -8
  81. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/util-user-agent-node/defaultUserAgent.d.ts +17 -28
  82. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/util-user-agent-node/getRuntimeUserAgentPair.d.ts +2 -6
  83. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/util-user-agent-node/is-crt-available.d.ts +2 -5
  84. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/client/util-user-agent-node/nodeAppIdConfigOptions.d.ts +4 -13
  85. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/httpAuthSchemes/aws_sdk/AwsSdkSigV4ASigner.d.ts +9 -10
  86. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/httpAuthSchemes/aws_sdk/AwsSdkSigV4Signer.d.ts +39 -44
  87. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/httpAuthSchemes/aws_sdk/NODE_AUTH_SCHEME_PREFERENCE_OPTIONS.d.ts +2 -5
  88. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/httpAuthSchemes/aws_sdk/clock-skew-defaults.browser.d.ts +1 -6
  89. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/httpAuthSchemes/aws_sdk/clock-skew-defaults.d.ts +1 -7
  90. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/httpAuthSchemes/aws_sdk/clock-skew-node-config.d.ts +4 -13
  91. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/httpAuthSchemes/aws_sdk/index.d.ts +23 -7
  92. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/httpAuthSchemes/aws_sdk/resolveAwsSdkSigV4AConfig.d.ts +13 -38
  93. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/httpAuthSchemes/aws_sdk/resolveAwsSdkSigV4Config.d.ts +57 -133
  94. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/httpAuthSchemes/index.browser.d.ts +32 -11
  95. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/httpAuthSchemes/index.d.ts +32 -9
  96. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/httpAuthSchemes/utils/getArrayForCommaSeparatedString.d.ts +1 -8
  97. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/httpAuthSchemes/utils/getBearerTokenEnvKey.d.ts +1 -6
  98. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/httpAuthSchemes/utils/getDateHeader.d.ts +2 -8
  99. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/httpAuthSchemes/utils/getSkewCorrectedDate.d.ts +1 -8
  100. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/httpAuthSchemes/utils/getUpdatedSystemClockOffset.d.ts +6 -26
  101. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/httpAuthSchemes/utils/index.d.ts +4 -4
  102. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/httpAuthSchemes/utils/isClockSkewed.d.ts +1 -9
  103. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/ConfigurableSerdeContext.d.ts +5 -8
  104. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/ProtocolLib.d.ts +40 -74
  105. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/UnionSerde.d.ts +9 -24
  106. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/cbor/AwsSmithyRpcV2CborProtocol.d.ts +36 -25
  107. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/coercing-serializers.d.ts +3 -18
  108. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/common.d.ts +5 -2
  109. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/index.d.ts +30 -22
  110. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/json/AwsJson1_0Protocol.d.ts +21 -22
  111. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/json/AwsJson1_1Protocol.d.ts +21 -22
  112. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/json/AwsJsonRpcProtocol.d.ts +49 -29
  113. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/json/AwsRestJsonProtocol.d.ts +49 -36
  114. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/json/JsonSettings.d.ts +4 -0
  115. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/json/awsExpectUnion.d.ts +1 -7
  116. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/json/codec-v1/JsonCodec.d.ts +11 -0
  117. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/json/codec-v1/JsonSettings.d.ts +4 -0
  118. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/json/codec-v1/JsonShapeDeserializer.d.ts +13 -0
  119. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/json/codec-v1/JsonShapeSerializer.d.ts +18 -0
  120. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/json/codec-v2/JsonBytesStringAdapter.d.ts +27 -0
  121. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/json/codec-v2/JsonCodec2.d.ts +9 -0
  122. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/json/codec-v2/JsonShapeDeserializer2.d.ts +15 -0
  123. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/json/codec-v2/JsonShapeSerializer2.d.ts +39 -0
  124. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/json/detectBufferParsing.d.ts +1 -1
  125. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/json/jsonReplacer.d.ts +7 -21
  126. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/json/jsonReviver.d.ts +7 -15
  127. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/json/needsReviver.d.ts +2 -11
  128. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/json/parseJsonBody.d.ts +14 -22
  129. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/query/AwsEc2QueryProtocol.d.ts +18 -27
  130. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/query/AwsQueryProtocol.d.ts +57 -49
  131. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/query/QuerySerializerSettings.d.ts +7 -13
  132. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/query/QueryShapeSerializer.d.ts +21 -16
  133. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/writeKey.d.ts +1 -4
  134. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/xml/AwsRestXmlProtocol.d.ts +47 -31
  135. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/xml/XmlCodec.d.ts +17 -14
  136. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/xml/XmlShapeDeserializer.d.ts +15 -20
  137. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/xml/XmlShapeSerializer.d.ts +21 -21
  138. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/xml/parseXmlBody.d.ts +4 -13
  139. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/xml/simpleFormatXml.d.ts +1 -6
  140. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/util/index.d.ts +3 -3
  141. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/util/util-arn-parser/arn.d.ts +14 -32
  142. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/util/util-format-url/format-url.d.ts +4 -2
  143. package/node_modules/@aws-sdk/core/package.json +3 -3
  144. package/node_modules/@aws-sdk/credential-provider-env/package.json +3 -3
  145. package/node_modules/@aws-sdk/credential-provider-http/node_modules/@smithy/node-http-handler/package.json +2 -2
  146. package/node_modules/@aws-sdk/credential-provider-http/package.json +5 -5
  147. package/node_modules/@aws-sdk/credential-provider-ini/package.json +11 -11
  148. package/node_modules/@aws-sdk/credential-provider-login/package.json +4 -4
  149. package/node_modules/@aws-sdk/credential-provider-node/package.json +9 -9
  150. package/node_modules/@aws-sdk/credential-provider-process/package.json +3 -3
  151. package/node_modules/@aws-sdk/credential-provider-sso/node_modules/@aws-sdk/token-providers/package.json +4 -4
  152. package/node_modules/@aws-sdk/credential-provider-sso/package.json +5 -5
  153. package/node_modules/@aws-sdk/credential-provider-web-identity/package.json +4 -4
  154. package/node_modules/@aws-sdk/eventstream-handler-node/package.json +2 -2
  155. package/node_modules/@aws-sdk/middleware-eventstream/package.json +2 -2
  156. package/node_modules/@aws-sdk/middleware-websocket/package.json +5 -5
  157. package/node_modules/@aws-sdk/nested-clients/dist-cjs/submodules/cognito-identity/index.js +1 -1
  158. package/node_modules/@aws-sdk/nested-clients/dist-cjs/submodules/signin/index.js +1 -1
  159. package/node_modules/@aws-sdk/nested-clients/dist-cjs/submodules/sso/index.js +1 -1
  160. package/node_modules/@aws-sdk/nested-clients/dist-cjs/submodules/sso-oidc/index.js +1 -1
  161. package/node_modules/@aws-sdk/nested-clients/dist-cjs/submodules/sts/index.js +1 -1
  162. package/node_modules/@aws-sdk/nested-clients/node_modules/@smithy/node-http-handler/package.json +2 -2
  163. package/node_modules/@aws-sdk/nested-clients/package.json +6 -6
  164. package/node_modules/@aws-sdk/signature-v4-multi-region/package.json +2 -2
  165. package/node_modules/@earendil-works/pi-coding-agent/docs/compaction.md +14 -9
  166. package/node_modules/@earendil-works/pi-coding-agent/docs/containerization.md +16 -16
  167. package/node_modules/@earendil-works/pi-coding-agent/docs/custom-provider.md +12 -9
  168. package/node_modules/@earendil-works/pi-coding-agent/docs/docs.json +1 -5
  169. package/node_modules/@earendil-works/pi-coding-agent/docs/environment-variables.md +88 -0
  170. package/node_modules/@earendil-works/pi-coding-agent/docs/extensions.md +54 -36
  171. package/node_modules/@earendil-works/pi-coding-agent/docs/index.md +9 -6
  172. package/node_modules/@earendil-works/pi-coding-agent/docs/json.md +5 -1
  173. package/node_modules/@earendil-works/pi-coding-agent/docs/llama-cpp.md +7 -7
  174. package/node_modules/@earendil-works/pi-coding-agent/docs/mcp.md +1 -1
  175. package/node_modules/@earendil-works/pi-coding-agent/docs/models.md +13 -9
  176. package/node_modules/@earendil-works/pi-coding-agent/docs/packages.md +13 -13
  177. package/node_modules/@earendil-works/pi-coding-agent/docs/prompt-templates.md +2 -2
  178. package/node_modules/@earendil-works/pi-coding-agent/docs/quickstart.md +22 -22
  179. package/node_modules/@earendil-works/pi-coding-agent/docs/rpc.md +106 -10
  180. package/node_modules/@earendil-works/pi-coding-agent/docs/sdk.md +1186 -0
  181. package/node_modules/@earendil-works/pi-coding-agent/docs/security.md +4 -4
  182. package/node_modules/@earendil-works/pi-coding-agent/docs/session-format.md +18 -4
  183. package/node_modules/@earendil-works/pi-coding-agent/docs/sessions.md +1 -1
  184. package/node_modules/@earendil-works/pi-coding-agent/docs/settings.md +8 -8
  185. package/node_modules/@earendil-works/pi-coding-agent/docs/shell-aliases.md +1 -1
  186. package/node_modules/@earendil-works/pi-coding-agent/docs/skills.md +6 -6
  187. package/node_modules/@earendil-works/pi-coding-agent/docs/terminal-setup.md +2 -2
  188. package/node_modules/@earendil-works/pi-coding-agent/docs/termux.md +1 -1
  189. package/node_modules/@earendil-works/pi-coding-agent/docs/themes.md +2 -2
  190. package/node_modules/@earendil-works/pi-coding-agent/docs/tmux.md +4 -4
  191. package/node_modules/@earendil-works/pi-coding-agent/docs/usage.md +12 -25
  192. package/node_modules/@earendil-works/pi-coding-agent/docs/windows.md +1 -1
  193. package/node_modules/@smithy/core/dist-cjs/submodules/cbor/index.js +1561 -337
  194. package/node_modules/@smithy/core/dist-es/submodules/cbor/CborCodec.js +4 -205
  195. package/node_modules/@smithy/core/dist-es/submodules/cbor/cbor-encode.js +1 -1
  196. package/node_modules/@smithy/core/dist-es/submodules/cbor/codec-v1/CborShapeDeserializer.js +113 -0
  197. package/node_modules/@smithy/core/dist-es/submodules/cbor/codec-v1/CborShapeSerializer.js +103 -0
  198. package/node_modules/@smithy/core/dist-es/submodules/cbor/codec-v2/CborShapeDeserializer2.js +621 -0
  199. package/node_modules/@smithy/core/dist-es/submodules/cbor/codec-v2/CborShapeSerializer2.js +602 -0
  200. package/node_modules/@smithy/core/dist-es/submodules/cbor/index.js +5 -1
  201. package/node_modules/@smithy/core/dist-types/submodules/cbor/CborCodec.d.ts +5 -27
  202. package/node_modules/@smithy/core/dist-types/submodules/cbor/SmithyRpcV2CborProtocol.d.ts +2 -2
  203. package/node_modules/@smithy/core/dist-types/submodules/cbor/codec-v1/CborShapeDeserializer.d.ts +13 -0
  204. package/node_modules/@smithy/core/dist-types/submodules/cbor/codec-v1/CborShapeSerializer.d.ts +15 -0
  205. package/node_modules/@smithy/core/dist-types/submodules/cbor/codec-v2/CborShapeDeserializer2.d.ts +18 -0
  206. package/node_modules/@smithy/core/dist-types/submodules/cbor/codec-v2/CborShapeSerializer2.d.ts +35 -0
  207. package/node_modules/@smithy/core/dist-types/submodules/cbor/index.d.ts +5 -1
  208. package/node_modules/@smithy/core/dist-types/ts3.4/submodules/cbor/CborCodec.d.ts +5 -27
  209. package/node_modules/@smithy/core/dist-types/ts3.4/submodules/cbor/SmithyRpcV2CborProtocol.d.ts +2 -2
  210. package/node_modules/@smithy/core/dist-types/ts3.4/submodules/cbor/codec-v1/CborShapeDeserializer.d.ts +13 -0
  211. package/node_modules/@smithy/core/dist-types/ts3.4/submodules/cbor/codec-v1/CborShapeSerializer.d.ts +15 -0
  212. package/node_modules/@smithy/core/dist-types/ts3.4/submodules/cbor/codec-v2/CborShapeDeserializer2.d.ts +18 -0
  213. package/node_modules/@smithy/core/dist-types/ts3.4/submodules/cbor/codec-v2/CborShapeSerializer2.d.ts +35 -0
  214. package/node_modules/@smithy/core/dist-types/ts3.4/submodules/cbor/index.d.ts +5 -1
  215. package/node_modules/@smithy/core/package.json +2 -1
  216. package/node_modules/@smithy/credential-provider-imds/package.json +2 -2
  217. package/node_modules/@smithy/fetch-http-handler/package.json +2 -2
  218. package/node_modules/@smithy/signature-v4/package.json +2 -2
  219. package/node_modules/@types/node/README.md +1 -1
  220. package/node_modules/@types/node/crypto.d.ts +1 -1
  221. package/node_modules/@types/node/package.json +2 -2
  222. package/node_modules/brace-expansion/README.md +1 -2
  223. package/node_modules/brace-expansion/dist/commonjs/index.js +30 -4
  224. package/node_modules/brace-expansion/dist/commonjs/index.js.map +1 -1
  225. package/node_modules/brace-expansion/dist/esm/index.js +30 -4
  226. package/node_modules/brace-expansion/dist/esm/index.js.map +1 -1
  227. package/node_modules/brace-expansion/package.json +1 -1
  228. package/package.json +2 -2
  229. package/slingshot/index.js +203 -205
  230. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/json/JsonCodec.d.ts +0 -19
  231. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/json/JsonShapeDeserializer.d.ts +0 -13
  232. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/json/JsonShapeSerializer.d.ts +0 -28
  233. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/json/experimental/BufferJsonShapeDeserializer.d.ts +0 -29
  234. package/node_modules/@aws-sdk/core/dist-types/ts3.4/submodules/protocols/json/experimental/ByteJsonShapeSerializer.d.ts +0 -57
  235. package/node_modules/@earendil-works/pi-coding-agent/docs/providers.md +0 -297
@@ -1,19 +0,0 @@
1
- import { Codec, CodecSettings } from "@smithy/types";
2
- import { SerdeContextConfig } from "../ConfigurableSerdeContext";
3
- import { JsonShapeDeserializer } from "./JsonShapeDeserializer";
4
- import { JsonShapeSerializer } from "./JsonShapeSerializer";
5
- /**
6
- * @public
7
- */
8
- export type JsonSettings = CodecSettings & {
9
- jsonName: boolean;
10
- };
11
- /**
12
- * @public
13
- */
14
- export declare class JsonCodec extends SerdeContextConfig implements Codec<string, string> {
15
- readonly settings: JsonSettings;
16
- constructor(settings: JsonSettings);
17
- createSerializer(): JsonShapeSerializer;
18
- createDeserializer(): JsonShapeDeserializer;
19
- }
@@ -1,13 +0,0 @@
1
- import { DocumentType, Schema, ShapeDeserializer } from "@smithy/types";
2
- import { SerdeContextConfig } from "../ConfigurableSerdeContext";
3
- import { JsonSettings } from "./JsonCodec";
4
- /**
5
- * @public
6
- */
7
- export declare class JsonShapeDeserializer extends SerdeContextConfig implements ShapeDeserializer<string> {
8
- readonly settings: JsonSettings;
9
- constructor(settings: JsonSettings);
10
- read(schema: Schema, data: string | Uint8Array | unknown): Promise<any>;
11
- readObject(schema: Schema, data: DocumentType): any;
12
- protected _read(schema: Schema, value: unknown): any;
13
- }
@@ -1,28 +0,0 @@
1
- import { NormalizedSchema } from "@smithy/core/schema";
2
- import { Schema, ShapeSerializer } from "@smithy/types";
3
- import { SerdeContextConfig } from "../ConfigurableSerdeContext";
4
- import { JsonSettings } from "./JsonCodec";
5
- /**
6
- * @public
7
- */
8
- export declare class JsonShapeSerializer extends SerdeContextConfig implements ShapeSerializer<string> {
9
- readonly settings: JsonSettings;
10
- /**
11
- * Write buffer. Reused per value serialization pass.
12
- * In the initial implementation, this is not an incremental buffer.
13
- */
14
- protected buffer: any;
15
- protected useReplacer: boolean;
16
- protected rootSchema: NormalizedSchema | undefined;
17
- constructor(settings: JsonSettings);
18
- write(schema: Schema, value: unknown): void;
19
- flush(): string;
20
- /**
21
- * @internal
22
- */
23
- writeDiscriminatedDocument(schema: Schema, value: unknown): void;
24
- /**
25
- * Order if-statements by likelihood.
26
- */
27
- protected _write(schema: Schema, value: unknown, container?: NormalizedSchema): any;
28
- }
@@ -1,29 +0,0 @@
1
- import { DocumentType, Schema, ShapeDeserializer } from "@smithy/types";
2
- import { SerdeContextConfig } from "../../ConfigurableSerdeContext";
3
- import { JsonSettings } from "../JsonCodec";
4
- /**
5
- * Performance-optimized JSON deserializer.
6
- *
7
- * Skips UTF-8 decoding when the runtime supports JSON.parse(Buffer) (Node 22+).
8
- *
9
- * After JSON.parse, lists, maps, and document containers are mutated in place
10
- * (element values are overwritten with their deserialized form) rather than
11
- * copied into new arrays/objects. Structs allocate a fresh object because
12
- * jsonName traits require key renaming, and building the output object
13
- * incrementally lets V8 assign a stable hidden class rather than
14
- * deoptimizing from repeated property deletion/addition on an existing shape.
15
- *
16
- * In-place mutation is safe here because the parsed tree is locally owned
17
- * after JSON.parse with no external references, so rewriting values avoids
18
- * redundant allocation and GC pressure.
19
- *
20
- * @internal
21
- */
22
- export declare class BufferJsonShapeDeserializer extends SerdeContextConfig implements ShapeDeserializer<string> {
23
- readonly settings: JsonSettings;
24
- constructor(settings: JsonSettings);
25
- read(schema: Schema, data: string | Uint8Array | unknown): Promise<any>;
26
- readObject(schema: Schema, data: DocumentType): any;
27
- protected _read(schema: Schema, value: unknown): any;
28
- private _readStruct;
29
- }
@@ -1,57 +0,0 @@
1
- import { Schema, ShapeSerializer } from "@smithy/types";
2
- import { SerdeContextConfig } from "../../ConfigurableSerdeContext";
3
- import { JsonSettings } from "../JsonCodec";
4
- /**
5
- * Experimental single-pass JSON serializer that writes directly to a Uint8Array buffer.
6
- * Fewer intermediate states as when compared to the initial multi-pass implementation.
7
- *
8
- * @internal
9
- */
10
- export declare class ByteJsonShapeSerializer extends SerdeContextConfig implements ShapeSerializer<Uint8Array> {
11
- readonly settings: JsonSettings;
12
- private json;
13
- private i;
14
- private rootSchema;
15
- constructor(settings: JsonSettings);
16
- write(schema: Schema, value: unknown): void;
17
- /**
18
- * @internal
19
- */
20
- writeDiscriminatedDocument(schema: Schema, value: unknown): void;
21
- /**
22
- * Returns the serialized JSON as a Uint8Array (UTF-8 bytes).
23
- * This is the primary output — pass directly to request.body.
24
- */
25
- flush(): Uint8Array;
26
- private ensure;
27
- /**
28
- * Write a raw ASCII string (no JSON escaping). Used for pre-validated content
29
- * like numeric literals and pre-encoded base64.
30
- */
31
- private writeAscii;
32
- /**
33
- * Write a quoted ASCII string with no escape checking.
34
- * Used for struct member keys (jsonName or model names) which are
35
- * guaranteed to be safe ASCII identifiers. No control chars, quotes,
36
- * backslashes, or non-ASCII.
37
- * Ensures extra room for surrounding structural chars (comma, colon).
38
- */
39
- private writeAsciiQuoted;
40
- /**
41
- * Write a JSON-escaped string including the surrounding quotes.
42
- * Fast-path for ASCII, falls back to TextEncoder for multi-byte.
43
- */
44
- private writeJsonString;
45
- private writeUnicodeEscape;
46
- private static readonly B64;
47
- /**
48
- * Write a Uint8Array as a quoted base64 string directly into the buffer.
49
- * No intermediate JS string, no escape checking (base64 alphabet is safe ASCII).
50
- */
51
- private writeBase64;
52
- private writeValue;
53
- private writeStruct;
54
- private writeList;
55
- private writeMap;
56
- private writeTimestamp;
57
- }
@@ -1,297 +0,0 @@
1
- # Providers
2
-
3
- sling supports subscription-based providers via OAuth and API key providers via environment variables or auth file. Built-in catalogs ship with sling; configured providers may refresh newer catalogs and cache them in `~/.sling/agent/models-store.json` for offline use.
4
-
5
- ## Table of Contents
6
-
7
- - [Subscriptions](#subscriptions)
8
- - [API Keys](#api-keys)
9
- - [Auth File](#auth-file)
10
- - [Cloud Providers](#cloud-providers)
11
- - [llama.cpp](#llamacpp)
12
- - [Custom Providers](#custom-providers)
13
- - [Resolution Order](#resolution-order)
14
-
15
- ## Subscriptions
16
-
17
- Use `/login` in interactive mode, then select a provider:
18
-
19
- - ChatGPT Plus/Pro (Codex)
20
- - Claude Pro/Max
21
- - GitHub Copilot
22
- - xAI (Grok/X subscription)
23
- - Radius
24
-
25
- Use `/logout` to clear credentials. Tokens are stored in `~/.sling/agent/auth.json` and auto-refresh when expired.
26
-
27
- ### OpenAI Codex
28
-
29
- - Requires ChatGPT Plus or Pro subscription
30
- - Officially endorsed by OpenAI: [Codex for OSS](https://developers.openai.com/community/codex-for-oss)
31
-
32
- ### Claude Pro/Max
33
-
34
- Anthropic subscription auth is active for Claude Pro/Max accounts. Third-party harness usage draws from [extra usage](https://claude.ai/settings/usage) and is billed per token, not against Claude plan limits.
35
-
36
- ### GitHub Copilot
37
-
38
- - Press Enter for github.com, or enter your GitHub Enterprise Server domain
39
- - If you get "model not supported", enable it in VS Code: Copilot Chat → model selector → select model → "Enable"
40
-
41
- ### xAI (Grok/X subscription)
42
-
43
- - Run `/login xai`, then select **Use a subscription**
44
- - `XAI_API_KEY` remains available through **Use an API key**
45
-
46
- ### Radius
47
-
48
- Radius is a dynamic `pi-messages` gateway. `/login radius` stores OAuth tokens in `auth.json`; the gateway catalog is refreshed independently and cached in `models-store.json`. Custom Radius gateways can be declared in `models.json` with `"oauth": "radius"` and a gateway `baseUrl`.
49
-
50
- ## API Keys
51
-
52
- ### Environment Variables or Auth File
53
-
54
- Use `/login` in interactive mode and select a provider to store an API key in `auth.json`, or set credentials via environment variable:
55
-
56
- ```bash
57
- export ANTHROPIC_API_KEY=sk-ant-...
58
- pi
59
- ```
60
-
61
- | Provider | Environment Variable | `auth.json` key |
62
- |----------|----------------------|------------------|
63
- | Anthropic | `ANTHROPIC_API_KEY` | `anthropic` |
64
- | Ant Ling | `ANT_LING_API_KEY` | `ant-ling` |
65
- | Azure OpenAI Responses | `AZURE_OPENAI_API_KEY` | `azure-openai-responses` |
66
- | OpenAI | `OPENAI_API_KEY` | `openai` |
67
- | DeepSeek | `DEEPSEEK_API_KEY` | `deepseek` |
68
- | NVIDIA NIM | `NVIDIA_API_KEY` | `nvidia` |
69
- | Google Gemini | `GEMINI_API_KEY` | `google` |
70
- | Amazon Bedrock | `AWS_BEARER_TOKEN_BEDROCK` | `amazon-bedrock` |
71
- | Mistral | `MISTRAL_API_KEY` | `mistral` |
72
- | Groq | `GROQ_API_KEY` | `groq` |
73
- | Cerebras | `CEREBRAS_API_KEY` | `cerebras` |
74
- | Cloudflare AI Gateway | `CLOUDFLARE_API_KEY` (+ `CLOUDFLARE_ACCOUNT_ID`, `CLOUDFLARE_GATEWAY_ID`) | `cloudflare-ai-gateway` |
75
- | Cloudflare Workers AI | `CLOUDFLARE_API_KEY` (+ `CLOUDFLARE_ACCOUNT_ID`) | `cloudflare-workers-ai` |
76
- | xAI | `XAI_API_KEY` | `xai` |
77
- | OpenRouter | `OPENROUTER_API_KEY` | `openrouter` |
78
- | Vercel AI Gateway | `AI_GATEWAY_API_KEY` | `vercel-ai-gateway` |
79
- | ZAI Coding Plan (Global) | `ZAI_API_KEY` | `zai` |
80
- | ZAI Coding Plan (China) | `ZAI_CODING_CN_API_KEY` | `zai-coding-cn` |
81
- | OpenCode Zen | `OPENCODE_API_KEY` | `opencode` |
82
- | OpenCode Go | `OPENCODE_API_KEY` | `opencode-go` |
83
- | Radius | `RADIUS_API_KEY` | `radius` |
84
- | Hugging Face | `HF_TOKEN` | `huggingface` |
85
- | Fireworks | `FIREWORKS_API_KEY` | `fireworks` |
86
- | Together AI | `TOGETHER_API_KEY` | `together` |
87
- | Kimi For Coding | `KIMI_API_KEY` | `kimi-coding` |
88
- | MiniMax | `MINIMAX_API_KEY` | `minimax` |
89
- | MiniMax (China) | `MINIMAX_CN_API_KEY` | `minimax-cn` |
90
- | Xiaomi MiMo | `XIAOMI_API_KEY` | `xiaomi` |
91
- | Xiaomi MiMo Token Plan (China) | `XIAOMI_TOKEN_PLAN_CN_API_KEY` | `xiaomi-token-plan-cn` |
92
- | Xiaomi MiMo Token Plan (Amsterdam) | `XIAOMI_TOKEN_PLAN_AMS_API_KEY` | `xiaomi-token-plan-ams` |
93
- | Xiaomi MiMo Token Plan (Singapore) | `XIAOMI_TOKEN_PLAN_SGP_API_KEY` | `xiaomi-token-plan-sgp` |
94
-
95
- Reference for environment variables and `auth.json` keys: [`const envMap`](https://github.com/earendil-works/pi-mono/blob/main/packages/ai/src/env-api-keys.ts) in [`packages/ai/src/env-api-keys.ts`](https://github.com/earendil-works/pi-mono/blob/main/packages/ai/src/env-api-keys.ts).
96
-
97
- #### Auth File
98
-
99
- Store credentials in `~/.sling/agent/auth.json`:
100
-
101
- ```json
102
- {
103
- "anthropic": { "type": "api_key", "key": "sk-ant-..." },
104
- "ant-ling": { "type": "api_key", "key": "..." },
105
- "openai": { "type": "api_key", "key": "sk-..." },
106
- "deepseek": { "type": "api_key", "key": "sk-..." },
107
- "nvidia": { "type": "api_key", "key": "nvapi-..." },
108
- "google": { "type": "api_key", "key": "..." },
109
- "opencode": { "type": "api_key", "key": "..." },
110
- "opencode-go": { "type": "api_key", "key": "..." },
111
- "together": { "type": "api_key", "key": "..." },
112
- "xiaomi": { "type": "api_key", "key": "..." },
113
- "xiaomi-token-plan-cn": { "type": "api_key", "key": "..." },
114
- "xiaomi-token-plan-ams": { "type": "api_key", "key": "..." },
115
- "xiaomi-token-plan-sgp": { "type": "api_key", "key": "..." }
116
- }
117
- ```
118
-
119
- The file is created with `0600` permissions (user read/write only). Auth file credentials take priority over environment variables.
120
-
121
- API key credentials can also include provider-scoped environment values. These values are used before process environment variables when resolving the credential key, provider/model headers, and provider configuration such as Cloudflare account IDs, Azure OpenAI settings, Vertex project/location, Bedrock settings, `PI_CACHE_RETENTION`, and `HTTP_PROXY`/`HTTPS_PROXY`.
122
-
123
- ```json
124
- {
125
- "cloudflare-ai-gateway": {
126
- "type": "api_key",
127
- "key": "$CLOUDFLARE_API_KEY",
128
- "env": {
129
- "CLOUDFLARE_API_KEY": "...",
130
- "CLOUDFLARE_ACCOUNT_ID": "account-id",
131
- "CLOUDFLARE_GATEWAY_ID": "gateway-id"
132
- }
133
- }
134
- }
135
- ```
136
-
137
- Use this when pi should use different provider settings than the project shell environment.
138
-
139
- ### Key Resolution
140
-
141
- The `key` field supports command execution, environment interpolation, and literals:
142
-
143
- - **Shell command:** `"!command"` at the start executes the whole value as a command and uses stdout (cached for process lifetime)
144
- ```json
145
- { "type": "api_key", "key": "!security find-generic-password -ws 'anthropic'" }
146
- { "type": "api_key", "key": "!op read 'op://vault/item/credential'" }
147
- ```
148
- - **Environment interpolation:** `"$ENV_VAR"` or `"${ENV_VAR}"` uses the value of the named variable. Interpolation works inside larger literals.
149
- ```json
150
- { "type": "api_key", "key": "$MY_ANTHROPIC_KEY" }
151
- { "type": "api_key", "key": "${KEY_PREFIX}_${KEY_SUFFIX}" }
152
- ```
153
- `$FOO_BAR` is the variable `FOO_BAR`; use `${FOO}_BAR` when `BAR` is literal text. Missing environment variables make the value unresolved.
154
- - **Escapes:** `"$$"` emits a literal `"$"`; `"$!"` emits a literal `"!"` without triggering command execution.
155
- ```json
156
- { "type": "api_key", "key": "$$literal-dollar-prefix" }
157
- { "type": "api_key", "key": "$!literal-bang-prefix" }
158
- ```
159
- - **Literal value:** Used directly. Plain uppercase strings such as `MY_API_KEY` are literals; use `$MY_API_KEY` for environment variables.
160
- ```json
161
- { "type": "api_key", "key": "sk-ant-..." }
162
- { "type": "api_key", "key": "public" }
163
- ```
164
-
165
- OAuth credentials are also stored here after `/login` and managed automatically.
166
-
167
- ## Cloud Providers
168
-
169
- ### Azure OpenAI
170
-
171
- ```bash
172
- export AZURE_OPENAI_API_KEY=...
173
- export AZURE_OPENAI_BASE_URL=https://your-resource.ai.azure.com
174
- # also supported: https://your-resource.cognitiveservices.azure.com
175
- # also supported: https://your-resource.openai.azure.com
176
- # root endpoints are auto-normalized to /openai/v1
177
- # or use resource name instead of base URL
178
- export AZURE_OPENAI_RESOURCE_NAME=your-resource
179
-
180
- # Optional
181
- export AZURE_OPENAI_API_VERSION=2024-02-01
182
- export AZURE_OPENAI_DEPLOYMENT_NAME_MAP=gpt-4=my-gpt4,gpt-4o=my-gpt4o
183
- ```
184
-
185
- ### Amazon Bedrock
186
-
187
- Use `/login amazon-bedrock` to store a Bedrock API key, or configure one of the ambient AWS credential sources below:
188
-
189
- ```bash
190
- # Option 1: AWS Profile
191
- export AWS_PROFILE=your-profile
192
-
193
- # Option 2: IAM Keys
194
- export AWS_ACCESS_KEY_ID=AKIA...
195
- export AWS_SECRET_ACCESS_KEY=...
196
-
197
- # Option 3: Bearer Token
198
- export AWS_BEARER_TOKEN_BEDROCK=...
199
-
200
- # Optional region (defaults to us-east-1)
201
- export AWS_REGION=us-west-2
202
- ```
203
-
204
- Also supports ECS task roles (`AWS_CONTAINER_CREDENTIALS_*`) and IRSA (`AWS_WEB_IDENTITY_TOKEN_FILE`).
205
-
206
- ```bash
207
- pi --provider amazon-bedrock --model us.anthropic.claude-sonnet-4-20250514-v1:0
208
- ```
209
-
210
- Prompt caching is enabled automatically for Claude models whose ID contains a recognizable model name (base models and system-defined inference profiles). For application inference profiles (whose ARNs don't contain the model name), set `AWS_BEDROCK_FORCE_CACHE=1` to enable cache points:
211
-
212
- ```bash
213
- export AWS_BEDROCK_FORCE_CACHE=1
214
- pi --provider amazon-bedrock --model arn:aws:bedrock:us-east-1:123456789012:application-inference-profile/abc123
215
- ```
216
-
217
- If you are connecting to a Bedrock API proxy, the following environment variables can be used:
218
-
219
- ```bash
220
- # Set the URL for the Bedrock proxy (standard AWS SDK env var)
221
- export AWS_ENDPOINT_URL_BEDROCK_RUNTIME=https://my.corp.proxy/bedrock
222
-
223
- # Set if your proxy does not require authentication
224
- export AWS_BEDROCK_SKIP_AUTH=1
225
-
226
- # Set if your proxy only supports HTTP/1.1
227
- export AWS_BEDROCK_FORCE_HTTP1=1
228
- ```
229
-
230
- ### Cloudflare AI Gateway
231
-
232
- `CLOUDFLARE_API_KEY` can be set via `/login`. The account ID and gateway slug can be set as environment variables or in the API key credential's `env` object in `auth.json`.
233
-
234
- ```bash
235
- export CLOUDFLARE_API_KEY=... # or use /login
236
- export CLOUDFLARE_ACCOUNT_ID=...
237
- export CLOUDFLARE_GATEWAY_ID=... # create at dash.cloudflare.com → AI → AI Gateway
238
- pi --provider cloudflare-ai-gateway --model "claude-sonnet-4-5"
239
- ```
240
-
241
- Routes to OpenAI, Anthropic, and Workers AI through Cloudflare AI Gateway. Workers AI uses the Unified API (`/compat`) and prefixed model IDs (`workers-ai/@cf/...`). OpenAI uses the OpenAI passthrough route (`/openai`) with native OpenAI model IDs such as `gpt-5.1`. Anthropic uses the Anthropic passthrough route (`/anthropic`) with native Anthropic model IDs such as `claude-sonnet-4-5`.
242
-
243
- AI Gateway authentication uses `CLOUDFLARE_API_KEY` as `cf-aig-authorization`. Upstream authentication can be one of:
244
-
245
- | Mode | Request auth | Upstream auth |
246
- |------|--------------|---------------|
247
- | Workers AI | Cloudflare token only | Cloudflare-native |
248
- | Unified billing | Cloudflare token only | Cloudflare handles upstream auth and deducts credits |
249
- | Stored BYOK | Cloudflare token only | Cloudflare injects provider keys stored in the AI Gateway dashboard |
250
- | Inline BYOK | Cloudflare token plus upstream `Authorization` header | The request supplies the upstream provider key |
251
-
252
- For normal pi usage, prefer unified billing or stored BYOK. Inline BYOK requires configuring an additional upstream `Authorization` header for the Cloudflare AI Gateway provider, for example via a `models.json` provider/model override.
253
-
254
- ### Cloudflare Workers AI
255
-
256
- `CLOUDFLARE_API_KEY` can be set via `/login`. `CLOUDFLARE_ACCOUNT_ID` can be set as an environment variable or in the API key credential's `env` object in `auth.json`.
257
-
258
- ```bash
259
- export CLOUDFLARE_API_KEY=... # or use /login
260
- export CLOUDFLARE_ACCOUNT_ID=...
261
- pi --provider cloudflare-workers-ai --model "@cf/moonshotai/kimi-k2.6"
262
- ```
263
-
264
- Pi automatically sets `x-session-affinity` for [prefix caching](https://developers.cloudflare.com/workers-ai/features/prompt-caching/) discounts.
265
-
266
- ### Google Vertex AI
267
-
268
- Uses Application Default Credentials:
269
-
270
- ```bash
271
- gcloud auth application-default login
272
- export GOOGLE_CLOUD_PROJECT=your-project
273
- export GOOGLE_CLOUD_LOCATION=us-central1
274
- ```
275
-
276
- Or set `GOOGLE_APPLICATION_CREDENTIALS` to a service account key file.
277
-
278
- ## llama.cpp
279
-
280
- Pi supports the llama.cpp router server. Configure it with `/login llama.cpp`, manage loaded models with `/llama`, and select a loaded model with `/model`.
281
-
282
- See [llama.cpp](llama-cpp.md) for server setup, model directory layout, environment variables, and command usage.
283
-
284
- ## Custom Providers
285
-
286
- **Via models.json:** Add Ollama, LM Studio, vLLM, or any provider that speaks a supported API (OpenAI Completions, OpenAI Responses, Anthropic Messages, Google Generative AI). See [models.md](models.md).
287
-
288
- **Via extensions:** For providers that need custom API implementations or OAuth flows, create an extension. See [custom-provider.md](custom-provider.md) and [examples/extensions/custom-provider-gitlab-duo](../examples/extensions/custom-provider-gitlab-duo/).
289
-
290
- ## Resolution Order
291
-
292
- When resolving credentials for a provider:
293
-
294
- 1. CLI `--api-key` flag
295
- 2. `auth.json` entry (API key or OAuth token)
296
- 3. Environment variable
297
- 4. Custom provider keys from `models.json`