ima2-gen 1.1.13 → 1.1.16

package/node_modules/progrok/node_modules/type-is/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "type-is",
+  "description": "Infer the content-type of a request.",
+  "version": "1.6.18",
+  "contributors": [
+    "Douglas Christopher Wilson <doug@somethingdoug.com>",
+    "Jonathan Ong <me@jongleberry.com> (http://jongleberry.com)"
+  ],
+  "license": "MIT",
+  "repository": "jshttp/type-is",
+  "dependencies": {
+    "media-typer": "0.3.0",
+    "mime-types": "~2.1.24"
+  },
+  "devDependencies": {
+    "eslint": "5.16.0",
+    "eslint-config-standard": "12.0.0",
+    "eslint-plugin-import": "2.17.2",
+    "eslint-plugin-markdown": "1.0.0",
+    "eslint-plugin-node": "8.0.1",
+    "eslint-plugin-promise": "4.1.1",
+    "eslint-plugin-standard": "4.0.0",
+    "mocha": "6.1.4",
+    "nyc": "14.0.0"
+  },
+  "engines": {
+    "node": ">= 0.6"
+  },
+  "files": [
+    "LICENSE",
+    "HISTORY.md",
+    "index.js"
+  ],
+  "scripts": {
+    "lint": "eslint --plugin markdown --ext js,md .",
+    "test": "mocha --reporter spec --check-leaks --bail test/",
+    "test-cov": "nyc --reporter=html --reporter=text npm test",
+    "test-travis": "nyc --reporter=text npm test"
+  },
+  "keywords": [
+    "content",
+    "type",
+    "checking"
+  ]
+}

package/node_modules/progrok/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "progrok",
+  "version": "0.1.0",
+  "description": "Use Grok models for free via OAuth proxy. No API key needed.",
+  "type": "module",
+  "bin": {
+    "progrok": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "LICENSE",
+    "README.md",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "npm run typecheck && tsup && node scripts/copy-public.mjs",
+    "dev": "tsup --watch",
+    "prepublishOnly": "npm run build",
+    "test": "npx tsx --experimental-test-module-mocks --test tests/*.test.ts"
+  },
+  "keywords": [
+    "grok",
+    "xai",
+    "proxy",
+    "oauth",
+    "cli",
+    "openai-compatible"
+  ],
+  "author": "lidge-jun",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lidge-jun/progrok.git"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "commander": "^13.0.0",
+    "express": "^4.21.0",
+    "open": "^10.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "tsup": "^8.4.0",
+    "@types/express": "^4.17.0",
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0"
+  }
+}

package/node_modules/progrok/skills/progrok/SKILL.md

@@ -0,0 +1,228 @@
+---
+name: progrok
+description: "Free Grok API via OAuth proxy. Use when you need xAI Grok models (chat, search, image, video, tts, stt) without an API key. Requires SuperGrok subscription + `progrok login` once."
+metadata:
+  {
+    "triggers": ["grok", "xai", "progrok", "grok-4", "x search", "grok search", "grok image", "grok video", "grok tts", "grok stt"],
+    "requires": { "bins": ["progrok"] }
+  }
+---
+
+# progrok — Free Grok API via OAuth Proxy
+
+## When to Use
+
+- You need to call xAI Grok models (chat, reasoning, search, images, video, audio)
+- No XAI_API_KEY available — use OAuth instead
+- Any task that benefits from real-time X/web search (Grok's native tools)
+- Image/video generation via Grok Imagine
+- Text-to-speech or speech-to-text
+
+## Prerequisites
+
+```bash
+progrok login          # one-time OAuth (browser or --device-code for SSH)
+progrok status         # verify: "Status: Logged in"
+```
+
+## Usage Patterns
+
+### Pattern 1: Direct Proxy (recommended for agents)
+
+```bash
+progrok proxy &
+curl http://127.0.0.1:18645/v1/chat/completions \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer anything" \
+  -d '{"model": "grok-4.3", "messages": [{"role": "user", "content": "Hello"}]}'
+```
+
+### Pattern 2: Responses API with Tools
+
+```bash
+curl http://127.0.0.1:18645/v1/responses \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "grok-4.3",
+    "input": [{"role": "user", "content": "What are people saying about Tesla on X?"}],
+    "tools": [{"type": "x_search"}, {"type": "web_search"}],
+    "stream": true
+  }'
+```
+
+### Pattern 3: Image Generation
+
+```bash
+curl http://127.0.0.1:18645/v1/images/generations \
+  -H "Content-Type: application/json" \
+  -d '{"model": "grok-imagine-image", "prompt": "A futuristic cityscape", "n": 1}'
+```
+
+### Pattern 4: Video Generation (async)
+
+```bash
+# Start
+curl -s http://127.0.0.1:18645/v1/videos/generations \
+  -H "Content-Type: application/json" \
+  -d '{"model": "grok-imagine-video", "prompt": "Ocean waves"}'
+# → {"request_id": "abc-123"}
+
+# Poll
+curl http://127.0.0.1:18645/v1/videos/abc-123
+# → {"status": "pending", "progress": 45}
+# → {"status": "done", "video": {"url": "https://...", "duration": 8}}
+```
+
+### Pattern 5: TTS / STT
+
+```bash
+# Text-to-speech
+curl http://127.0.0.1:18645/v1/tts \
+  -H "Content-Type: application/json" \
+  -d '{"text": "Hello world", "voice_id": "eve", "language": "en"}' -o out.mp3
+
+# Speech-to-text
+curl http://127.0.0.1:18645/v1/stt -F "file=@audio.mp3" -F "language=en"
+```
+
+### Pattern 6: OpenAI SDK / LangChain
+
+```python
+from openai import OpenAI
+client = OpenAI(base_url="http://127.0.0.1:18645/v1", api_key="anything")
+response = client.chat.completions.create(
+    model="grok-4.3",
+    messages=[{"role": "user", "content": "Hello"}],
+)
+```
+
+## API Surface
+
+| Endpoint | Method | Type |
+|----------|--------|------|
+| `/v1/responses` | POST | Streaming — tools, reasoning, citations |
+| `/v1/chat/completions` | POST | Streaming — OpenAI compatible |
+| `/v1/models` | GET | Model list |
+| `/v1/language-models` | GET | Detailed: pricing, aliases, modalities |
+| `/v1/images/generations` | POST | Sync — returns image URL |
+| `/v1/videos/generations` | POST | Async — returns request_id |
+| `/v1/videos/{id}` | GET | Poll — pending/done |
+| `/v1/tts` | POST | Binary audio response |
+| `/v1/stt` | POST | Multipart file upload |
+| `/v1/embeddings` | POST | Text embeddings |
+| Any `/v1/*` | * | Forwarded without filtering |
+
+## Models
+
+### Text Models
+
+| Model | Best For | Input | Reasoning | Structured Output |
+|-------|---------|-------|-----------|:-:|
+| `grok-4.3` (default) | General reasoning, chat, search | text, image | none/low/medium/high (default: low) | ✅ |
+| `grok-4.20-0309-reasoning` | Deep analysis, complex coding | text, image | low/medium/high (default: low) | ✅ |
+| `grok-4.20-0309-non-reasoning` | Fast responses, no thinking | text, image | ❌ disabled | ✅ |
+| `grok-4.20-multi-agent-0309` | Deep research (parallel agents) | text, image | low/medium/high/xhigh → agent count | ✅ |
+| `grok-build-0.1` | Agentic coding | text, image | low/medium/high (default: low) | ❌ |
+
+### Media Models
+
+| Model | Type | Output |
+|-------|------|--------|
+| `grok-imagine-image` | Image gen | URL (sync) |
+| `grok-imagine-image-quality` | HQ image gen | URL (sync) |
+| `grok-imagine-video` | Video gen | URL (async, poll) |
+
+### Reasoning Effort Reference
+
+| Model | `none` | `low` | `medium` | `high` | `xhigh` | Effect |
+|-------|:---:|:---:|:---:|:---:|:---:|--------|
+| grok-4.3 | ✅ | ✅ default | ✅ | ✅ | ❌ | Thinking depth |
+| grok-4.20-reasoning | ❌ | ✅ default | ✅ | ✅ | ❌ | Thinking depth |
+| grok-4.20-non-reasoning | — | — | — | — | — | No reasoning |
+| grok-4.20-multi-agent | ❌ | ✅ 4 agents | ✅ 4 agents | ✅ 16 agents | ✅ 16 agents | Agent count |
+| grok-build-0.1 | ❌ | ✅ default | ✅ | ✅ | ❌ | Thinking depth |
+
+## Multi-Agent Model
+
+`grok-4.20-multi-agent-0309` spawns parallel agents internally.
+
+```bash
+# 4 agents (default, fast)
+curl .../v1/responses -d '{"model":"grok-4.20-multi-agent-0309","reasoning":{"effort":"low"},...}'
+
+# 16 agents (thorough, ~100 web searches)
+curl .../v1/responses -d '{"model":"grok-4.20-multi-agent-0309","reasoning":{"effort":"xhigh"},...}'
+```
+
+| effort | Agents | Searches | Cost | Time |
+|--------|:------:|:--------:|-----:|-----:|
+| low/medium | 4 | ~32 | ~$0.33 | ~38s |
+| high/xhigh | 16 | ~102 | ~$1.05 | ~43s |
+
+Supports: `web_search`, `x_search`, `json_schema` structured output, `function` calling.
+
+Does NOT support: per-agent role/tool/schema definition. Agent orchestration is a black box — you control count only.
+
+## Tools (Responses API)
+
+```json
+{"tools": [
+  {"type": "web_search"},
+  {"type": "x_search"},
+  {"type": "code_interpreter"},
+  {"type": "file_search", "vector_store_ids": ["..."]},
+  {"type": "function", "name": "my_func", "parameters": {...}}
+]}
+```
+
+## Structured Output (JSON Schema)
+
+Force the response into a specific JSON structure:
+
+```bash
+curl http://127.0.0.1:18645/v1/responses \
+  -H "Content-Type: application/json" \
+  -d '{
+    "model": "grok-4.3",
+    "input": [{"role":"user","content":"Latest AI releases"}],
+    "tools": [{"type":"web_search"}],
+    "text": {
+      "format": {
+        "type": "json_schema",
+        "name": "results",
+        "schema": {
+          "type": "object",
+          "properties": {
+            "items": {"type": "array", "items": {"type": "object", "properties": {"name":{"type":"string"},"summary":{"type":"string"}}, "required":["name","summary"]}}
+          },
+          "required": ["items"]
+        },
+        "strict": true
+      }
+    }
+  }'
+```
+
+Works with all models including `grok-4.20-multi-agent-0309`.
+
+## Ports
+
+- Proxy: `127.0.0.1:18645`
+- Chat UI: `127.0.0.1:18646`
+- OAuth callback: `127.0.0.1:56121`
+- Config: `~/.progrok/auth.json`
+
+## Dynamic Metadata
+
+For programmatic access to capabilities, models, and endpoints:
+
+```bash
+progrok capabilities          # human-readable
+progrok capabilities --json   # structured JSON for agents
+```
+
+## Install
+
+```bash
+npm i -g progrok
+```

package/node_modules/proxy-addr/HISTORY.md

@@ -0,0 +1,161 @@
+2.0.7 / 2021-05-31
+==================
+
+  * deps: forwarded@0.2.0
+    - Use `req.socket` over deprecated `req.connection`
+
+2.0.6 / 2020-02-24
+==================
+
+  * deps: ipaddr.js@1.9.1
+
+2.0.5 / 2019-04-16
+==================
+
+  * deps: ipaddr.js@1.9.0
+
+2.0.4 / 2018-07-26
+==================
+
+  * deps: ipaddr.js@1.8.0
+
+2.0.3 / 2018-02-19
+==================
+
+  * deps: ipaddr.js@1.6.0
+
+2.0.2 / 2017-09-24
+==================
+
+  * deps: forwarded@~0.1.2
+    - perf: improve header parsing
+    - perf: reduce overhead when no `X-Forwarded-For` header
+
+2.0.1 / 2017-09-10
+==================
+
+  * deps: forwarded@~0.1.1
+    - Fix trimming leading / trailing OWS
+    - perf: hoist regular expression
+  * deps: ipaddr.js@1.5.2
+
+2.0.0 / 2017-08-08
+==================
+
+  * Drop support for Node.js below 0.10
+
+1.1.5 / 2017-07-25
+==================
+
+  * Fix array argument being altered
+  * deps: ipaddr.js@1.4.0
+
+1.1.4 / 2017-03-24
+==================
+
+  * deps: ipaddr.js@1.3.0
+
+1.1.3 / 2017-01-14
+==================
+
+  * deps: ipaddr.js@1.2.0
+
+1.1.2 / 2016-05-29
+==================
+
+  * deps: ipaddr.js@1.1.1
+    - Fix IPv6-mapped IPv4 validation edge cases
+
+1.1.1 / 2016-05-03
+==================
+
+  * Fix regression matching mixed versions against multiple subnets
+
+1.1.0 / 2016-05-01
+==================
+
+  * Fix accepting various invalid netmasks
+    - IPv4 netmasks must be contingous
+    - IPv6 addresses cannot be used as a netmask
+  * deps: ipaddr.js@1.1.0
+
+1.0.10 / 2015-12-09
+===================
+
+  * deps: ipaddr.js@1.0.5
+    - Fix regression in `isValid` with non-string arguments
+
+1.0.9 / 2015-12-01
+==================
+
+  * deps: ipaddr.js@1.0.4
+    - Fix accepting some invalid IPv6 addresses
+    - Reject CIDRs with negative or overlong masks
+  * perf: enable strict mode
+
+1.0.8 / 2015-05-10
+==================
+
+  * deps: ipaddr.js@1.0.1
+
+1.0.7 / 2015-03-16
+==================
+
+  * deps: ipaddr.js@0.1.9
+    - Fix OOM on certain inputs to `isValid`
+
+1.0.6 / 2015-02-01
+==================
+
+  * deps: ipaddr.js@0.1.8
+
+1.0.5 / 2015-01-08
+==================
+
+  * deps: ipaddr.js@0.1.6
+
+1.0.4 / 2014-11-23
+==================
+
+  * deps: ipaddr.js@0.1.5
+    - Fix edge cases with `isValid`
+
+1.0.3 / 2014-09-21
+==================
+
+  * Use `forwarded` npm module
+
+1.0.2 / 2014-09-18
+==================
+
+  * Fix a global leak when multiple subnets are trusted
+  * Support Node.js 0.6
+  * deps: ipaddr.js@0.1.3
+
+1.0.1 / 2014-06-03
+==================
+
+  * Fix links in npm package
+
+1.0.0 / 2014-05-08
+==================
+
+  * Add `trust` argument to determine proxy trust on
+    * Accepts custom function
+    * Accepts IPv4/IPv6 address(es)
+    * Accepts subnets
+    * Accepts pre-defined names
+  * Add optional `trust` argument to `proxyaddr.all` to
+    stop at first untrusted
+  * Add `proxyaddr.compile` to pre-compile `trust` function
+    to make subsequent calls faster
+
+0.0.1 / 2014-05-04
+==================
+
+  * Fix bad npm publish
+
+0.0.0 / 2014-05-04
+==================
+
+  * Initial release

package/node_modules/proxy-addr/LICENSE

@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) 2014-2016 Douglas Christopher Wilson
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/node_modules/proxy-addr/README.md

@@ -0,0 +1,139 @@
+# proxy-addr
+
+[![NPM Version][npm-version-image]][npm-url]
+[![NPM Downloads][npm-downloads-image]][npm-url]
+[![Node.js Version][node-image]][node-url]
+[![Build Status][ci-image]][ci-url]
+[![Test Coverage][coveralls-image]][coveralls-url]
+
+Determine address of proxied request
+
+## Install
+
+This is a [Node.js](https://nodejs.org/en/) module available through the
+[npm registry](https://www.npmjs.com/). Installation is done using the
+[`npm install` command](https://docs.npmjs.com/getting-started/installing-npm-packages-locally):
+
+```sh
+$ npm install proxy-addr
+```
+
+## API
+
+```js
+var proxyaddr = require('proxy-addr')
+```
+
+### proxyaddr(req, trust)
+
+Return the address of the request, using the given `trust` parameter.
+
+The `trust` argument is a function that returns `true` if you trust
+the address, `false` if you don't. The closest untrusted address is
+returned.
+
+```js
+proxyaddr(req, function (addr) { return addr === '127.0.0.1' })
+proxyaddr(req, function (addr, i) { return i < 1 })
+```
+
+The `trust` arugment may also be a single IP address string or an
+array of trusted addresses, as plain IP addresses, CIDR-formatted
+strings, or IP/netmask strings.
+
+```js
+proxyaddr(req, '127.0.0.1')
+proxyaddr(req, ['127.0.0.0/8', '10.0.0.0/8'])
+proxyaddr(req, ['127.0.0.0/255.0.0.0', '192.168.0.0/255.255.0.0'])
+```
+
+This module also supports IPv6. Your IPv6 addresses will be normalized
+automatically (i.e. `fe80::00ed:1` equals `fe80:0:0:0:0:0:ed:1`).
+
+```js
+proxyaddr(req, '::1')
+proxyaddr(req, ['::1/128', 'fe80::/10'])
+```
+
+This module will automatically work with IPv4-mapped IPv6 addresses
+as well to support node.js in IPv6-only mode. This means that you do
+not have to specify both `::ffff:a00:1` and `10.0.0.1`.
+
+As a convenience, this module also takes certain pre-defined names
+in addition to IP addresses, which expand into IP addresses:
+
+```js
+proxyaddr(req, 'loopback')
+proxyaddr(req, ['loopback', 'fc00:ac:1ab5:fff::1/64'])
+```
+
+  * `loopback`: IPv4 and IPv6 loopback addresses (like `::1` and
+    `127.0.0.1`).
+  * `linklocal`: IPv4 and IPv6 link-local addresses (like
+    `fe80::1:1:1:1` and `169.254.0.1`).
+  * `uniquelocal`: IPv4 private addresses and IPv6 unique-local
+    addresses (like `fc00:ac:1ab5:fff::1` and `192.168.0.1`).
+
+When `trust` is specified as a function, it will be called for each
+address to determine if it is a trusted address. The function is
+given two arguments: `addr` and `i`, where `addr` is a string of
+the address to check and `i` is a number that represents the distance
+from the socket address.
+
+### proxyaddr.all(req, [trust])
+
+Return all the addresses of the request, optionally stopping at the
+first untrusted. This array is ordered from closest to furthest
+(i.e. `arr[0] === req.connection.remoteAddress`).
+
+```js
+proxyaddr.all(req)
+```
+
+The optional `trust` argument takes the same arguments as `trust`
+does in `proxyaddr(req, trust)`.
+
+```js
+proxyaddr.all(req, 'loopback')
+```
+
+### proxyaddr.compile(val)
+
+Compiles argument `val` into a `trust` function. This function takes
+the same arguments as `trust` does in `proxyaddr(req, trust)` and
+returns a function suitable for `proxyaddr(req, trust)`.
+
+```js
+var trust = proxyaddr.compile('loopback')
+var addr = proxyaddr(req, trust)
+```
+
+This function is meant to be optimized for use against every request.
+It is recommend to compile a trust function up-front for the trusted
+configuration and pass that to `proxyaddr(req, trust)` for each request.
+
+## Testing
+
+```sh
+$ npm test
+```
+
+## Benchmarks
+
+```sh
+$ npm run-script bench
+```
+
+## License
+
+[MIT](LICENSE)
+
+[ci-image]: https://badgen.net/github/checks/jshttp/proxy-addr/master?label=ci
+[ci-url]: https://github.com/jshttp/proxy-addr/actions?query=workflow%3Aci
+[coveralls-image]: https://badgen.net/coveralls/c/github/jshttp/proxy-addr/master
+[coveralls-url]: https://coveralls.io/r/jshttp/proxy-addr?branch=master
+[node-image]: https://badgen.net/npm/node/proxy-addr
+[node-url]: https://nodejs.org/en/download
+[npm-downloads-image]: https://badgen.net/npm/dm/proxy-addr
+[npm-url]: https://npmjs.org/package/proxy-addr
+[npm-version-image]: https://badgen.net/npm/v/proxy-addr