commoncompute 0.2.0__tar.gz → 0.3.1__tar.gz

{commoncompute-0.2.0 → commoncompute-0.3.1}/.gitignore

@@ -3,6 +3,7 @@ node_modules/
 dist/
 coverage/
 .wrangler/
+.wrangler.drifted-backup-*/
 .pytest_cache/
 __pycache__/
 *.pyc

{commoncompute-0.2.0 → commoncompute-0.3.1}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Common Compute, Inc.
+Copyright (c) 2026 Common Compute LLC
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{commoncompute-0.2.0 → commoncompute-0.3.1}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: commoncompute
-Version: 0.2.0
+Version: 0.3.1
 Summary: Official Python SDK for Common Compute — the batch AI bill you shouldn't be paying.
 Project-URL: Homepage, https://commoncompute.ai
 Project-URL: Documentation, https://commoncompute.ai/docs
-Project-URL: Source, https://github.com/Ikaikaalika/commoncomputeai
+Project-URL: Source, https://github.com/commoncompute/sdk
 Project-URL: Changelog, https://commoncompute.ai/changelog
 Author-email: Common Compute <support@commoncompute.ai>
 License: MIT
@@ -44,11 +44,14 @@ for **successful** jobs — each with a verifiable receipt.
 
 ```bash
 pip install commoncompute          # core: httpx + pydantic only
-pip install "commoncompute[cli]"   # + the `cc` command line
-cc login                           # opens the browser — no key to copy-paste
+pip install "commoncompute[cli]"   # + the `commoncompute` command line
+commoncompute login                # opens the browser — no key to copy-paste
 ```
 
-`cc login` (or `commoncompute.connect()` from a script or notebook) opens an
+The command is `commoncompute`. A short `cc` is **not** installed — that name
+belongs to the system C compiler. Want the shorthand? `alias cc="commoncompute"`.
+
+`commoncompute login` (or `commoncompute.connect()` from a script or notebook) opens an
 approval page in your browser; click **Approve** and a fresh API key is saved
 to `~/.config/commoncompute/credentials`, where the SDK finds it automatically.
 Prefer explicit config? `export CC_API_KEY=cc_live_...` works everywhere and
@@ -61,7 +64,8 @@ import commoncompute as cc
 
 client = cc.Client()   # reads CC_API_KEY, or the saved credentials file
 
-job = client.transcription.create("s3://my-bucket/meeting.mp3", timestamps=True)
+job = client.submit("coreml_embed", {"input": ["what is the neural engine?"]},
+                    model_id="bge-base")
 print(job.job_id, job.locked_price_usd, job.eta_seconds)   # price known BEFORE it runs
 
 result = client.result(job)          # waits, downloads, attaches the receipt
@@ -69,7 +73,10 @@ print(result.output)
 print(result.receipt)                # signed proof of what ran, where, for how much
 ```
 
-## Examples
+Prefer the OpenAI-style surface? `client.embeddings.create(input=[...],
+model="bge-base")` returns vectors synchronously.
+
+## Examples — live today
 
 ### 1. OCR / document extraction — vs AWS Textract
 
@@ -78,38 +85,40 @@ job = client.ocr.extract("https://example.com/contracts.pdf", structured=True)
 result = client.result(job)          # blocks + bounding boxes as JSON
 ```
 
-### 2. Transcription in bulk
+### 2. Embeddings in bulk
 
 ```python
-jobs = client.transcription.create_many(
-    [f"s3://recordings/call-{i}.mp3" for i in range(200)],
-    language="en",
+for result in client.submit_many(
+    "coreml_embed",
+    [{"input": chunked(doc)} for doc in corpus],
     max_concurrent=16,
-)
+):
+    save(result.output)              # results stream as they complete
 ```
 
-### 3. Reranking — sharpen RAG retrieval
+### 3. Background removal
 
 ```python
-job = client.rerank("what is the neural engine?", documents, top_n=5)
-top = client.result(job).output
+job = client.images.remove_background("product-shot.png")
 ```
 
-### 4. Translation
+Also live: speech synthesis, image classification/detection/pose, barcode
+reading, HEIC conversion — plus the generic `client.submit(workload_id,
+payload)` for anything marked **live** in
+[the catalog](https://commoncompute.ai/workloads).
 
-```python
-job = client.translate(catalog_descriptions, target_lang="de")
-```
+### In preview
 
-### 5. Background removal
+`client.translate(...)` and `client.video.transcode(...)` run on preview
+capacity — functional, not yet GA.
 
-```python
-job = client.images.remove_background("product-shot.png")
-```
+### Not live yet
 
-Also available: `client.video.transcode(...)`, `client.build.ios_test(...)`,
-`client.images.generate(...)`, `client.embeddings.create(...)`, and the
-generic `client.submit(workload_id, payload)` for anything in
+`client.transcription.*`, `client.rerank(...)`, `client.images.generate(...)`,
+`client.chat.*`, and `client.build.ios_test(...)` target workloads still
+marked *coming soon*: the API refuses them with a clear
+`workload_not_available` error (HTTP 409) rather than queueing a job that
+won't run. They activate automatically as those lanes go live — watch
 [the catalog](https://commoncompute.ai/workloads).
 
 ## Price before execution, hard caps, dry runs
@@ -183,48 +192,59 @@ raw request/response dicts instead of typed `Job`/`TaskResult` objects.
 
 ## CLI
 
-`pip install "commoncompute[cli]"` installs the `cc` command.
+`pip install "commoncompute[cli]"` installs the `commoncompute` command.
+
+> **Why not a short `cc`?** Because `cc` is the Unix C compiler
+> (`/usr/bin/cc`). Shipping a binary by that name puts it ahead of the real
+> compiler on `PATH` for anyone whose Python bin directory sorts first, and
+> every build that shells out to `cc` then fails with a CLI usage error
+> instead of compiling. So `commoncompute` is the only command installed. If
+> you want the shorthand, opt in yourself:
+>
+> ```bash
+> alias cc="commoncompute"     # add to ~/.zshrc or ~/.bashrc
+> ```
 
 ```bash
-cc login                              # stores the key locally
-cc quote vision_ocr --units 5         # price + ETA, no execution
-cc submit coreml_embed --payload '{"input":["hi"]}' --wait
-cc jobs list
-cc jobs get <id>
-cc balance
-cc receipts export --format csv --out receipts.csv
+commoncompute login                              # stores the key locally
+commoncompute quote vision_ocr --units 5         # price + ETA, no execution
+commoncompute submit coreml_embed --payload '{"input":["hi"]}' --wait
+commoncompute jobs list
+commoncompute jobs get <id>
+commoncompute balance
+commoncompute receipts export --format csv --out receipts.csv
 ```
 
 ### Commands
 
 | Command | What it does |
 |---------|--------------|
-| `cc login` / `cc logout` | Store / remove the API key (browser approval, or `--api-key`) |
-| `cc whoami` | Show the account behind the current key |
-| `cc balance` | Current workspace balance |
-| `cc usage` | Spend + call-count rollups over a date range (`--start`, `--end`, `--group-by`) |
-| `cc spend` | Total spend over the last `--days` N, grouped by workload |
-| `cc tier` | Current volume tier and the next threshold |
-| `cc workloads` | List available workloads |
-| `cc models` | List models (`--workload` to filter) |
-| `cc quote` | Price + ETA for a workload without submitting (`--units`, `--priority`, `--model`) |
-| `cc submit` | Submit one job (`--payload/-f`, `--model`, `--priority`, `--wait`, `--timeout`) |
-| `cc submit-many` | Submit a JSONL file of payloads; stream one result per line as NDJSON (`--input/-i`, `--max-concurrent`, `--no-wait`) |
-| `cc chat` | One-shot chat message to a model (`--model`, `--stream/--no-stream`) |
-| `cc embed` | Embed a single string (prints the vector length) |
-| `cc playground` | Open the web playground |
-| `cc jobs list` | Recent submissions, newest first (`--limit/-n`) |
-| `cc jobs get <id>` | Fetch one job |
-| `cc jobs wait <id>` | Poll a job to a terminal state (`--timeout/-t`) |
-| `cc jobs events <id>` | Event timeline for a job |
-| `cc jobs download <id>` | Download a job's result (`--out/-o`, else stdout) |
-| `cc keys list` / `create` / `revoke` | Manage API keys |
-| `cc receipts list` | Receipts for completed jobs (`--limit/-n`) |
-| `cc receipts get <id>` | Signed receipt for a single job |
-| `cc receipts export` | Export receipts as CSV or JSON (`--format/-f`, `--out/-o`, `--limit/-n`) |
-| `cc config path` / `show` / `set` / `unset` | Inspect and edit local settings (see below) |
-
-`cc --version` (or `-V`) prints the version. Every read command that renders a
+| `commoncompute login` / `commoncompute logout` | Store / remove the API key (browser approval, or `--api-key`) |
+| `commoncompute whoami` | Show the account behind the current key |
+| `commoncompute balance` | Current workspace balance |
+| `commoncompute usage` | Spend + call-count rollups over a date range (`--start`, `--end`, `--group-by`) |
+| `commoncompute spend` | Total spend over the last `--days` N, grouped by workload |
+| `commoncompute tier` | Current volume tier and the next threshold |
+| `commoncompute workloads` | List available workloads |
+| `commoncompute models` | List models (`--workload` to filter) |
+| `commoncompute quote` | Price + ETA for a workload without submitting (`--units`, `--priority`, `--model`) |
+| `commoncompute submit` | Submit one job (`--payload/-f`, `--model`, `--priority`, `--wait`, `--timeout`) |
+| `commoncompute submit-many` | Submit a JSONL file of payloads; stream one result per line as NDJSON (`--input/-i`, `--max-concurrent`, `--no-wait`) |
+| `commoncompute chat` | One-shot chat message to a model (`--model`, `--stream/--no-stream`) |
+| `commoncompute embed` | Embed a single string (prints the vector length) |
+| `commoncompute playground` | Open the web playground |
+| `commoncompute jobs list` | Recent submissions, newest first (`--limit/-n`) |
+| `commoncompute jobs get <id>` | Fetch one job |
+| `commoncompute jobs wait <id>` | Poll a job to a terminal state (`--timeout/-t`) |
+| `commoncompute jobs events <id>` | Event timeline for a job |
+| `commoncompute jobs download <id>` | Download a job's result (`--out/-o`, else stdout) |
+| `commoncompute keys list` / `create` / `revoke` | Manage API keys |
+| `commoncompute receipts list` | Receipts for completed jobs (`--limit/-n`) |
+| `commoncompute receipts get <id>` | Signed receipt for a single job |
+| `commoncompute receipts export` | Export receipts as CSV or JSON (`--format/-f`, `--out/-o`, `--limit/-n`) |
+| `commoncompute config path` / `show` / `set` / `unset` | Inspect and edit local settings (see below) |
+
+`commoncompute --version` (or `-V`) prints the version. Every read command that renders a
 table also accepts **`--json`** for plain, ANSI-free machine-readable output —
 `whoami`, `balance`, `usage`, `spend`, `tier`, `workloads`, `models`, `quote`,
 `submit`, `jobs list/get/wait/events`, `keys list`, and `receipts list`.
@@ -234,20 +254,20 @@ table also accepts **`--json`** for plain, ANSI-free machine-readable output —
 Typer ships completion for bash, zsh, fish, and PowerShell:
 
 ```bash
-cc --install-completion        # install for the current shell
-cc --show-completion           # print the script to inspect or customise
+commoncompute --install-completion        # install for the current shell
+commoncompute --show-completion           # print the script to inspect or customise
 ```
 
 ### Exit codes
 
-Scripts can branch on `cc`'s exit status:
+Scripts can branch on `commoncompute`'s exit status:
 
 | Code | Meaning |
 |------|---------|
 | `0` | Success |
 | `1` | API or runtime error (network, server, bad request) |
 | `2` | Usage error — missing/invalid arguments, or no credentials found |
-| `3` | The job reached a **failed** terminal state (`failed` / `dead_letter` / `cancelled`) — `cc jobs wait` and `cc submit --wait` only |
+| `3` | The job reached a **failed** terminal state (`failed` / `dead_letter` / `cancelled`) — `commoncompute jobs wait` and `commoncompute submit --wait` only |
 
 ## Migrating from OpenAI (optional)
 
@@ -316,14 +336,14 @@ Environment variables take precedence over both files at runtime:
 Inspect and edit the local config from the CLI:
 
 ```bash
-cc config path                        # print the config directory
-cc config show                        # settings + active credential source (key masked)
-cc config set base_url https://api.commoncompute.ai
-cc config set org my-workspace
-cc config unset org
+commoncompute config path                        # print the config directory
+commoncompute config show                        # settings + active credential source (key masked)
+commoncompute config set base_url https://api.commoncompute.ai
+commoncompute config set org my-workspace
+commoncompute config unset org
 ```
 
-Env vars still win at runtime — `cc config set` writes the file, but
+Env vars still win at runtime — `commoncompute config set` writes the file, but
 `CC_BASE_URL` / `CC_ORG` override it for a given process.
 
 Python 3.9+. Core dependencies: `httpx`, `pydantic`. MIT license.

{commoncompute-0.2.0 → commoncompute-0.3.1}/README.md

@@ -9,11 +9,14 @@ for **successful** jobs — each with a verifiable receipt.
 
 ```bash
 pip install commoncompute          # core: httpx + pydantic only
-pip install "commoncompute[cli]"   # + the `cc` command line
-cc login                           # opens the browser — no key to copy-paste
+pip install "commoncompute[cli]"   # + the `commoncompute` command line
+commoncompute login                # opens the browser — no key to copy-paste
 ```
 
-`cc login` (or `commoncompute.connect()` from a script or notebook) opens an
+The command is `commoncompute`. A short `cc` is **not** installed — that name
+belongs to the system C compiler. Want the shorthand? `alias cc="commoncompute"`.
+
+`commoncompute login` (or `commoncompute.connect()` from a script or notebook) opens an
 approval page in your browser; click **Approve** and a fresh API key is saved
 to `~/.config/commoncompute/credentials`, where the SDK finds it automatically.
 Prefer explicit config? `export CC_API_KEY=cc_live_...` works everywhere and
@@ -26,7 +29,8 @@ import commoncompute as cc
 
 client = cc.Client()   # reads CC_API_KEY, or the saved credentials file
 
-job = client.transcription.create("s3://my-bucket/meeting.mp3", timestamps=True)
+job = client.submit("coreml_embed", {"input": ["what is the neural engine?"]},
+                    model_id="bge-base")
 print(job.job_id, job.locked_price_usd, job.eta_seconds)   # price known BEFORE it runs
 
 result = client.result(job)          # waits, downloads, attaches the receipt
@@ -34,7 +38,10 @@ print(result.output)
 print(result.receipt)                # signed proof of what ran, where, for how much
 ```
 
-## Examples
+Prefer the OpenAI-style surface? `client.embeddings.create(input=[...],
+model="bge-base")` returns vectors synchronously.
+
+## Examples — live today
 
 ### 1. OCR / document extraction — vs AWS Textract
 
@@ -43,38 +50,40 @@ job = client.ocr.extract("https://example.com/contracts.pdf", structured=True)
 result = client.result(job)          # blocks + bounding boxes as JSON
 ```
 
-### 2. Transcription in bulk
+### 2. Embeddings in bulk
 
 ```python
-jobs = client.transcription.create_many(
-    [f"s3://recordings/call-{i}.mp3" for i in range(200)],
-    language="en",
+for result in client.submit_many(
+    "coreml_embed",
+    [{"input": chunked(doc)} for doc in corpus],
     max_concurrent=16,
-)
+):
+    save(result.output)              # results stream as they complete
 ```
 
-### 3. Reranking — sharpen RAG retrieval
+### 3. Background removal
 
 ```python
-job = client.rerank("what is the neural engine?", documents, top_n=5)
-top = client.result(job).output
+job = client.images.remove_background("product-shot.png")
 ```
 
-### 4. Translation
+Also live: speech synthesis, image classification/detection/pose, barcode
+reading, HEIC conversion — plus the generic `client.submit(workload_id,
+payload)` for anything marked **live** in
+[the catalog](https://commoncompute.ai/workloads).
 
-```python
-job = client.translate(catalog_descriptions, target_lang="de")
-```
+### In preview
 
-### 5. Background removal
+`client.translate(...)` and `client.video.transcode(...)` run on preview
+capacity — functional, not yet GA.
 
-```python
-job = client.images.remove_background("product-shot.png")
-```
+### Not live yet
 
-Also available: `client.video.transcode(...)`, `client.build.ios_test(...)`,
-`client.images.generate(...)`, `client.embeddings.create(...)`, and the
-generic `client.submit(workload_id, payload)` for anything in
+`client.transcription.*`, `client.rerank(...)`, `client.images.generate(...)`,
+`client.chat.*`, and `client.build.ios_test(...)` target workloads still
+marked *coming soon*: the API refuses them with a clear
+`workload_not_available` error (HTTP 409) rather than queueing a job that
+won't run. They activate automatically as those lanes go live — watch
 [the catalog](https://commoncompute.ai/workloads).
 
 ## Price before execution, hard caps, dry runs
@@ -148,48 +157,59 @@ raw request/response dicts instead of typed `Job`/`TaskResult` objects.
 
 ## CLI
 
-`pip install "commoncompute[cli]"` installs the `cc` command.
+`pip install "commoncompute[cli]"` installs the `commoncompute` command.
+
+> **Why not a short `cc`?** Because `cc` is the Unix C compiler
+> (`/usr/bin/cc`). Shipping a binary by that name puts it ahead of the real
+> compiler on `PATH` for anyone whose Python bin directory sorts first, and
+> every build that shells out to `cc` then fails with a CLI usage error
+> instead of compiling. So `commoncompute` is the only command installed. If
+> you want the shorthand, opt in yourself:
+>
+> ```bash
+> alias cc="commoncompute"     # add to ~/.zshrc or ~/.bashrc
+> ```
 
 ```bash
-cc login                              # stores the key locally
-cc quote vision_ocr --units 5         # price + ETA, no execution
-cc submit coreml_embed --payload '{"input":["hi"]}' --wait
-cc jobs list
-cc jobs get <id>
-cc balance
-cc receipts export --format csv --out receipts.csv
+commoncompute login                              # stores the key locally
+commoncompute quote vision_ocr --units 5         # price + ETA, no execution
+commoncompute submit coreml_embed --payload '{"input":["hi"]}' --wait
+commoncompute jobs list
+commoncompute jobs get <id>
+commoncompute balance
+commoncompute receipts export --format csv --out receipts.csv
 ```
 
 ### Commands
 
 | Command | What it does |
 |---------|--------------|
-| `cc login` / `cc logout` | Store / remove the API key (browser approval, or `--api-key`) |
-| `cc whoami` | Show the account behind the current key |
-| `cc balance` | Current workspace balance |
-| `cc usage` | Spend + call-count rollups over a date range (`--start`, `--end`, `--group-by`) |
-| `cc spend` | Total spend over the last `--days` N, grouped by workload |
-| `cc tier` | Current volume tier and the next threshold |
-| `cc workloads` | List available workloads |
-| `cc models` | List models (`--workload` to filter) |
-| `cc quote` | Price + ETA for a workload without submitting (`--units`, `--priority`, `--model`) |
-| `cc submit` | Submit one job (`--payload/-f`, `--model`, `--priority`, `--wait`, `--timeout`) |
-| `cc submit-many` | Submit a JSONL file of payloads; stream one result per line as NDJSON (`--input/-i`, `--max-concurrent`, `--no-wait`) |
-| `cc chat` | One-shot chat message to a model (`--model`, `--stream/--no-stream`) |
-| `cc embed` | Embed a single string (prints the vector length) |
-| `cc playground` | Open the web playground |
-| `cc jobs list` | Recent submissions, newest first (`--limit/-n`) |
-| `cc jobs get <id>` | Fetch one job |
-| `cc jobs wait <id>` | Poll a job to a terminal state (`--timeout/-t`) |
-| `cc jobs events <id>` | Event timeline for a job |
-| `cc jobs download <id>` | Download a job's result (`--out/-o`, else stdout) |
-| `cc keys list` / `create` / `revoke` | Manage API keys |
-| `cc receipts list` | Receipts for completed jobs (`--limit/-n`) |
-| `cc receipts get <id>` | Signed receipt for a single job |
-| `cc receipts export` | Export receipts as CSV or JSON (`--format/-f`, `--out/-o`, `--limit/-n`) |
-| `cc config path` / `show` / `set` / `unset` | Inspect and edit local settings (see below) |
-
-`cc --version` (or `-V`) prints the version. Every read command that renders a
+| `commoncompute login` / `commoncompute logout` | Store / remove the API key (browser approval, or `--api-key`) |
+| `commoncompute whoami` | Show the account behind the current key |
+| `commoncompute balance` | Current workspace balance |
+| `commoncompute usage` | Spend + call-count rollups over a date range (`--start`, `--end`, `--group-by`) |
+| `commoncompute spend` | Total spend over the last `--days` N, grouped by workload |
+| `commoncompute tier` | Current volume tier and the next threshold |
+| `commoncompute workloads` | List available workloads |
+| `commoncompute models` | List models (`--workload` to filter) |
+| `commoncompute quote` | Price + ETA for a workload without submitting (`--units`, `--priority`, `--model`) |
+| `commoncompute submit` | Submit one job (`--payload/-f`, `--model`, `--priority`, `--wait`, `--timeout`) |
+| `commoncompute submit-many` | Submit a JSONL file of payloads; stream one result per line as NDJSON (`--input/-i`, `--max-concurrent`, `--no-wait`) |
+| `commoncompute chat` | One-shot chat message to a model (`--model`, `--stream/--no-stream`) |
+| `commoncompute embed` | Embed a single string (prints the vector length) |
+| `commoncompute playground` | Open the web playground |
+| `commoncompute jobs list` | Recent submissions, newest first (`--limit/-n`) |
+| `commoncompute jobs get <id>` | Fetch one job |
+| `commoncompute jobs wait <id>` | Poll a job to a terminal state (`--timeout/-t`) |
+| `commoncompute jobs events <id>` | Event timeline for a job |
+| `commoncompute jobs download <id>` | Download a job's result (`--out/-o`, else stdout) |
+| `commoncompute keys list` / `create` / `revoke` | Manage API keys |
+| `commoncompute receipts list` | Receipts for completed jobs (`--limit/-n`) |
+| `commoncompute receipts get <id>` | Signed receipt for a single job |
+| `commoncompute receipts export` | Export receipts as CSV or JSON (`--format/-f`, `--out/-o`, `--limit/-n`) |
+| `commoncompute config path` / `show` / `set` / `unset` | Inspect and edit local settings (see below) |
+
+`commoncompute --version` (or `-V`) prints the version. Every read command that renders a
 table also accepts **`--json`** for plain, ANSI-free machine-readable output —
 `whoami`, `balance`, `usage`, `spend`, `tier`, `workloads`, `models`, `quote`,
 `submit`, `jobs list/get/wait/events`, `keys list`, and `receipts list`.
@@ -199,20 +219,20 @@ table also accepts **`--json`** for plain, ANSI-free machine-readable output —
 Typer ships completion for bash, zsh, fish, and PowerShell:
 
 ```bash
-cc --install-completion        # install for the current shell
-cc --show-completion           # print the script to inspect or customise
+commoncompute --install-completion        # install for the current shell
+commoncompute --show-completion           # print the script to inspect or customise
 ```
 
 ### Exit codes
 
-Scripts can branch on `cc`'s exit status:
+Scripts can branch on `commoncompute`'s exit status:
 
 | Code | Meaning |
 |------|---------|
 | `0` | Success |
 | `1` | API or runtime error (network, server, bad request) |
 | `2` | Usage error — missing/invalid arguments, or no credentials found |
-| `3` | The job reached a **failed** terminal state (`failed` / `dead_letter` / `cancelled`) — `cc jobs wait` and `cc submit --wait` only |
+| `3` | The job reached a **failed** terminal state (`failed` / `dead_letter` / `cancelled`) — `commoncompute jobs wait` and `commoncompute submit --wait` only |
 
 ## Migrating from OpenAI (optional)
 
@@ -281,14 +301,14 @@ Environment variables take precedence over both files at runtime:
 Inspect and edit the local config from the CLI:
 
 ```bash
-cc config path                        # print the config directory
-cc config show                        # settings + active credential source (key masked)
-cc config set base_url https://api.commoncompute.ai
-cc config set org my-workspace
-cc config unset org
+commoncompute config path                        # print the config directory
+commoncompute config show                        # settings + active credential source (key masked)
+commoncompute config set base_url https://api.commoncompute.ai
+commoncompute config set org my-workspace
+commoncompute config unset org
 ```
 
-Env vars still win at runtime — `cc config set` writes the file, but
+Env vars still win at runtime — `commoncompute config set` writes the file, but
 `CC_BASE_URL` / `CC_ORG` override it for a given process.
 
 Python 3.9+. Core dependencies: `httpx`, `pydantic`. MIT license.

{commoncompute-0.2.0 → commoncompute-0.3.1}/commoncompute/__init__.py

@@ -11,33 +11,26 @@ Quickstart::
     client = cc.Client(api_key="cc_live_...")
     print(client.balance())
 
-    # OpenAI-compatible chat
-    reply = client.chat.create(
-        model="qwen-2.5-7b",
-        messages=[{"role": "user", "content": "hi"}],
-    )
-    print(reply["choices"][0]["message"]["content"])
-
-    # Native job submission
+    # Native job submission (embeddings — live today)
     job = client.jobs.submit(
         workload_id="coreml_embed",
         payload={"input": ["hello world"]},
     )
     result = client.jobs.wait(job["id"])
 
-Streaming chat::
+    # OpenAI-compatible embeddings
+    vectors = client.embeddings.create(input=["hello world"], model="bge-base")
 
-    for chunk in client.chat.stream(model="qwen-2.5-7b",
-                                    messages=[{"role": "user", "content": "hi"}]):
-        delta = chunk["choices"][0].get("delta", {}).get("content", "")
-        print(delta, end="", flush=True)
+`client.chat.*` targets LLM workloads that are still marked *coming soon*
+in the catalog — the API declines them with `workload_not_available`
+(HTTP 409) until they go live. See https://commoncompute.ai/workloads.
 """
 
 # MUST come before any submodule imports — _transport.py reads
 # `commoncompute.__version__` at import time for the User-Agent header,
 # and the previous ordering (`__version__` defined at the bottom) made
 # every clean install of the SDK fail with a circular ImportError.
-__version__ = "0.2.0"
+__version__ = "0.3.1"
 
 from .client import Client, AsyncClient
 from .errors import (

{commoncompute-0.2.0 → commoncompute-0.3.1}/commoncompute/_async_client.py

@@ -278,8 +278,10 @@ class _KeysAsync:
     async def list(self) -> list[dict[str, Any]]:
         return (await self._t.request("GET", "/v1/me/keys")).get("keys", [])
 
-    async def create(self, *, name: str, mode: str = "live", scopes: "Optional[Sequence[str]]" = None) -> dict[str, Any]:
+    async def create(self, *, name: str, mode: str = "live", scopes: "Optional[Sequence[str]]" = None, password: "Optional[str]" = None) -> dict[str, Any]:
         body: dict[str, Any] = {"name": name, "mode": mode}
+        if password:
+            body["password"] = password
         if scopes:
             body["scopes"] = scopes
         return await self._t.request("POST", "/v1/me/keys", json_body=body)

{commoncompute-0.2.0 → commoncompute-0.3.1}/commoncompute/_config.py

@@ -1,6 +1,7 @@
 """Shared credential + config resolution for the SDK, CLI, and connect().
 
-One module owns where keys and settings live, so ``Client()``, ``cc login``,
+One module owns where keys and settings live, so ``Client()``,
+``commoncompute login``,
 and ``commoncompute.connect()`` can never disagree again.
 
 Canonical location (respects ``$CC_CONFIG_DIR``)::
@@ -30,7 +31,7 @@ import os
 from pathlib import Path
 from typing import Dict, Mapping, Optional, Tuple
 
-#: Settings keys `cc config set` accepts (everything else is rejected).
+#: Settings keys `commoncompute config set` accepts (everything else is rejected).
 SETTINGS_KEYS = ("base_url", "org")
 
 

{commoncompute-0.2.0 → commoncompute-0.3.1}/commoncompute/_generated_workloads.py

@@ -1,7 +1,10 @@
-# @generated by packages/workloads/codegen/emit-sdk-workloads.ts — DO NOT EDIT.
-# Regenerate:  npx tsx packages/workloads/codegen/emit-sdk-workloads.ts
-# Source of truth: packages/workloads (the shared catalog). CI fails if this
-# file drifts from the catalog (see tests/unit/workloads-parity.test.ts).
+# @generated from Common Compute's internal workload catalog — DO NOT EDIT.
+#
+# This file is emitted by an internal codegen step and is not regenerable from
+# this repository. Edits here will be overwritten; the catalog is the source of
+# truth and drift is caught before release.
+#
+# Contains workload IDs and image-name routing heuristics only.
 from __future__ import annotations
 
 # Every workload id in the catalog. Used to decide whether a jobDefinition head

{commoncompute-0.2.0 → commoncompute-0.3.1}/commoncompute/_transport.py

@@ -143,13 +143,13 @@ class _BaseTransport:
         if not resolved_key:
             raise CommonComputeError(
                 "No API key. Run commoncompute.connect() (opens the browser, "
-                "no copy-paste) or `cc login` from a terminal — or pass "
+                "no copy-paste) or `commoncompute login` from a terminal — or pass "
                 "api_key=... / set CC_API_KEY.",
                 status_code=None,
                 code="missing_api_key",
             )
         self._api_key = resolved_key
-        # base_url / org: explicit arg → env → `cc config set` settings → default.
+        # base_url / org: explicit arg → env → `commoncompute config set` settings → default.
         settings = _config.load_settings()
         self._base_url = (
             base_url

{commoncompute-0.2.0 → commoncompute-0.3.1}/commoncompute/aws_batch.py

@@ -103,11 +103,10 @@ def _to_iso(ms: Optional[int]) -> Optional[str]:
 # Heuristic: anything containing one of these workload ids gets routed
 # directly. Otherwise we default to ``coreml_embed`` (the most common
 # batch workload migrated from AWS Batch + bge-* embeddings pipelines).
-# Workload identity comes from the generated catalog mirror so this shim
-# resolves jobDefinitions identically to the wire shim (apps/aws-shim) and the
-# Node SDK. The previous hand-maintained set had drifted to 12 of the catalog's
-# 24 workloads. Regenerate with:
-#   npx tsx packages/workloads/codegen/emit-sdk-workloads.ts
+# Workload identity comes from the generated catalog mirror
+# (``_generated_workloads.py``) so this shim resolves jobDefinitions
+# identically to the server side and to the Node SDK, instead of drifting
+# from a hand-maintained list.
 from ._generated_workloads import IMAGE_PATTERNS as _IMAGE_PATTERN_SOURCES
 from ._generated_workloads import KNOWN_WORKLOAD_IDS as _KNOWN_WORKLOADS
 
@@ -403,7 +402,7 @@ class BatchClient:
         """Mirror AWS describe_jobs — returns ``{"jobs": [...]}``.
 
         Just-submitted jobs may not be queryable for ~100ms while the
-        underlying D1 row propagates across the worker's read replicas.
+        underlying row propagates across the backing datastore's read replicas.
         We absorb a single 404 by retrying once after 250ms, which is
         enough to mask the eventual-consistency window in practice."""
         out: list[dict[str, Any]] = []

{commoncompute-0.2.0 → commoncompute-0.3.1}/commoncompute/cli.py

@@ -1,6 +1,10 @@
-"""`cc` command-line interface.
+"""`commoncompute` command-line interface.
+
+Installed as ``commoncompute`` via the pyproject entry point. A short ``cc``
+alias is deliberately not installed — it would shadow the Unix C compiler
+(``/usr/bin/cc``) and break builds that invoke it. Add
+``alias cc="commoncompute"`` to your shell rc if you want the shorthand.
 
-Installed as ``cc`` and ``commoncompute`` via the pyproject entry point.
 Uses Typer for argparsing + Rich for pretty output. Reads credentials
 from (in order): ``--api-key`` flag, ``CC_API_KEY`` env var, the canonical
 credentials file at ``~/.config/commoncompute/credentials``, then the
@@ -11,7 +15,8 @@ Exit codes:
     1  API / runtime error
     2  usage error / missing credentials
     3  a job reached a *failed* terminal state (failed / dead_letter /
-       cancelled) while waiting — ``cc jobs wait`` and ``cc submit --wait``
+       cancelled) while waiting — ``commoncompute jobs wait`` and
+       ``commoncompute submit --wait``
 """
 
 from __future__ import annotations
@@ -31,7 +36,7 @@ try:
     from rich.panel import Panel
 except ImportError:  # CLI deps are the [cli] extra, not core deps
     print(
-        "The `cc` CLI needs the cli extra: pip install \"commoncompute[cli]\"",
+        "The `commoncompute` CLI needs the cli extra: pip install \"commoncompute[cli]\"",
         file=sys.stderr,
     )
     raise SystemExit(2)
@@ -41,7 +46,7 @@ from .client import Client
 from .errors import CommonComputeError
 
 app = typer.Typer(
-    name="cc",
+    name="commoncompute",
     add_completion=True,
     no_args_is_help=True,
     help="Common Compute CLI — submit jobs, check spend, manage keys.",
@@ -63,7 +68,7 @@ err_console = Console(stderr=True, style="red")
 def _version_callback(value: bool) -> None:
     if value:
         from . import __version__
-        print(f"cc {__version__}")
+        print(f"commoncompute {__version__}")
         raise typer.Exit()
 
 
@@ -92,7 +97,9 @@ def _load_api_key(override: Optional[str] = None) -> Optional[str]:
 def _client(api_key: Optional[str] = None) -> Client:
     key = _load_api_key(api_key)
     if not key:
-        err_console.print("No API key found. Run [bold]cc login[/bold] or set [bold]CC_API_KEY[/bold].")
+        err_console.print(
+            "No API key found. Run [bold]commoncompute login[/bold] or set [bold]CC_API_KEY[/bold]."
+        )
         raise typer.Exit(2)
     try:
         return Client(api_key=key)
@@ -159,7 +166,7 @@ def logout() -> None:
         console.print("Nothing to remove.")
 
 
-# ─── cc config ──────────────────────────────────────────────────────────
+# ─── commoncompute config ───────────────────────────────────────────────
 # Plain print() (not rich) on purpose: the output is meant for shells and
 # scripts, and rich's 80-col soft-wrap would mangle long paths.
 
@@ -182,7 +189,7 @@ def config_show() -> None:
     if key:
         print(f"api key:     {key[:8]}…  (from {source})")
     else:
-        print("api key:     (none found — run `cc login`)")
+        print("api key:     (none found — run `commoncompute login`)")
 
 
 @config_app.command("set")
@@ -407,8 +414,10 @@ def estimate(
     model: Optional[str] = typer.Option(None, "--model", "-m"),
     as_json: bool = typer.Option(False, "--json", help="Raw JSON output."),
 ) -> None:
-    """Deprecated alias for `cc quote` (kept for back-compat)."""
-    err_console.print("`cc estimate` is deprecated; use `cc quote` instead.")
+    """Deprecated alias for `commoncompute quote` (kept for back-compat)."""
+    err_console.print(
+        "`commoncompute estimate` is deprecated; use `commoncompute quote` instead."
+    )
     quote(workload=workload, units=units, priority=priority, model=model, as_json=as_json)
 
 
@@ -426,10 +435,46 @@ def _wait_job(client: Client, job_id: str, timeout: float, *, quiet: bool):
         return client.wait(job_id, timeout=timeout, on_progress=_tick)
 
 
+def _parse_payload_arg(payload: str) -> object:
+    """Resolve --payload: @- (stdin), @path or bare path (file), or inline JSON.
+
+    The help has always said "path to JSON payload file", but the code only
+    honoured that with an @ prefix — a bare path fell through to json.loads()
+    and died with a raw JSONDecodeError traceback. Accept the documented
+    form, keep both @ forms, and turn every failure into a clean CLI error.
+    """
+    try:
+        if payload == "@-":
+            return json.load(sys.stdin)
+        if payload.startswith("@"):
+            return json.loads(Path(payload[1:]).read_text())
+        p = Path(payload)
+        if p.exists():
+            return json.loads(p.read_text())
+        # Not a file on disk — treat as inline JSON. A path-like string that
+        # simply doesn't exist gets a hint instead of a JSON parse error.
+        try:
+            return json.loads(payload)
+        except json.JSONDecodeError:
+            if payload.endswith(".json") or "/" in payload:
+                err_console.print(f"[red]Error:[/red] payload file not found: {payload}")
+            else:
+                err_console.print(f"[red]Error:[/red] --payload is not a file, not valid inline JSON: {payload!r}")
+            raise typer.Exit(2)
+    except typer.Exit:
+        raise
+    except json.JSONDecodeError as e:
+        err_console.print(f"[red]Error:[/red] invalid JSON in payload ({e.msg} at line {e.lineno}, column {e.colno})")
+        raise typer.Exit(2)
+    except OSError as e:
+        err_console.print(f"[red]Error:[/red] cannot read payload: {e}")
+        raise typer.Exit(2)
+
+
 @app.command()
 def submit(
     workload: str = typer.Argument(..., help="Workload id."),
-    payload: Optional[str] = typer.Option(None, "--payload", "-f", help="Path to JSON payload file, or @- for stdin."),
+    payload: Optional[str] = typer.Option(None, "--payload", "-f", help="Path to a JSON payload file, @- for stdin, or an inline JSON string."),
     model: Optional[str] = typer.Option(None, "--model", "-m"),
     priority: str = typer.Option("standard", "--priority", "-p"),
     wait: bool = typer.Option(False, "--wait", help="Block until the job finishes."),
@@ -439,12 +484,7 @@ def submit(
     """Submit a native Common Compute job."""
     body: object = None
     if payload:
-        if payload == "@-":
-            body = json.load(sys.stdin)
-        elif payload.startswith("@"):
-            body = json.loads(Path(payload[1:]).read_text())
-        else:
-            body = json.loads(payload)
+        body = _parse_payload_arg(payload)
     c = _client()
     try:
         job = c.jobs.submit(workload, payload=body, model_id=model, priority=priority)
@@ -575,7 +615,7 @@ def jobs_status(
     task_id: str,
     as_json: bool = typer.Option(False, "--json", help="Raw JSON output (no ANSI)."),
 ) -> None:
-    """Alias for `cc jobs get`."""
+    """Alias for `commoncompute jobs get`."""
     jobs_get(task_id=task_id, as_json=as_json)
 
 

{commoncompute-0.2.0 → commoncompute-0.3.1}/commoncompute/client.py

@@ -263,10 +263,28 @@ class _KeysSync:
     def list(self) -> list[dict[str, Any]]:
         return self._t.request("GET", "/v1/me/keys").get("keys", [])
 
-    def create(self, *, name: str, mode: str = "live", scopes: "Optional[Sequence[str]]" = None) -> dict[str, Any]:
+    def create(
+        self,
+        *,
+        name: str,
+        mode: str = "live",
+        scopes: "Optional[Sequence[str]]" = None,
+        password: "Optional[str]" = None,
+    ) -> dict[str, Any]:
+        """Create an API key.
+
+        Requires a signed-in *session* plus the account password. An API key
+        cannot create another API key (the server returns 403
+        ``api_key_cannot_mint``) — otherwise revoking a leaked key would not
+        revoke the keys it had spawned. Since this SDK normally authenticates
+        with an API key, most callers should create keys in the dashboard at
+        /app/api-keys instead.
+        """
         body: dict[str, Any] = {"name": name, "mode": mode}
         if scopes:
             body["scopes"] = scopes
+        if password:
+            body["password"] = password
         return self._t.request("POST", "/v1/me/keys", json_body=body)
 
     def revoke(self, key_id: str) -> None:

{commoncompute-0.2.0 → commoncompute-0.3.1}/commoncompute/connect.py

@@ -125,5 +125,6 @@ def connect(
                 )
 
 
-# `cc.login()` reads naturally next to the CLI's `cc login`.
+# `cc.login()` (import commoncompute as cc) reads naturally next to the
+# CLI's `commoncompute login`.
 login = connect

{commoncompute-0.2.0 → commoncompute-0.3.1}/commoncompute/tasks.py

@@ -27,12 +27,31 @@ from .models import Job, Quote, Receipt, TaskResult
 
 FileInput = Union[str, Path, bytes, io.BufferedReader]
 
+# Schemes recognised as "this is a URI, not a local path". Only https:// can
+# actually be fetched: the provider's download gate hard-rejects every other
+# scheme (TrustedDownload.swift — "only https"), and http:// specifically is
+# refused because a job input must not travel in the clear.
+#
+# The others stay in this tuple ON PURPOSE. Dropping them would make an s3://
+# URI fall through to the local-path branch and raise a confusing
+# "No such file: s3://bucket/key"; keeping them lets _file_payload reject the
+# scheme by name, at submit time, instead of the job dispatching and failing
+# on someone's Mac minutes later (2026-08-01 audit — the SDKs documented all
+# five schemes and only one ever worked).
 _URI_SCHEMES = ("http://", "https://", "s3://", "r2://", "gs://")
+_FETCHABLE_URI_SCHEMES = ("https://",)
 
 
 def _file_payload(f: FileInput, *, allowed_suffixes: Optional[Sequence[str]] = None) -> dict:
     """Normalise a file input into the job-payload contract."""
     if isinstance(f, str) and f.startswith(_URI_SCHEMES):
+        if not f.startswith(_FETCHABLE_URI_SCHEMES):
+            scheme = f.split("://", 1)[0]
+            raise UnsupportedFormatError(
+                f"{scheme}:// inputs are not supported — providers can only fetch https:// URLs. "
+                f"Pass a local path (the file is uploaded for you) or a presigned https:// URL.",
+                code="unsupported_input_scheme",
+            )
         return {"input_uri": f}
     if isinstance(f, (str, Path)):
         p = Path(f)
@@ -367,6 +386,14 @@ class Video(_TaskBase):
         max_spend_usd: Optional[float] = None,
         dry_run: bool = False,
     ) -> Union[Job, Quote]:
+        """Transcode a video with VideoToolbox hardware encoders.
+
+        ``output_format`` selects the codec (``"h264"`` / ``"hevc"`` /
+        ``"prores"``); ``codec=`` overrides it if both are given.
+        ``resolution`` is not yet implemented server-side — a job that sets
+        it fails fast with a clear error instead of silently encoding at
+        the source's native size.
+        """
         workload_id, payload, units, model_id = _transcode_request(
             input, output_format, resolution=resolution, codec=codec, output_minutes=output_minutes,
         )

{commoncompute-0.2.0 → commoncompute-0.3.1}/pyproject.toml

@@ -38,11 +38,15 @@ dependencies = [
 [project.urls]
 Homepage = "https://commoncompute.ai"
 Documentation = "https://commoncompute.ai/docs"
-Source = "https://github.com/Ikaikaalika/commoncomputeai"
+Source = "https://github.com/commoncompute/sdk"
 Changelog = "https://commoncompute.ai/changelog"
 
 [project.scripts]
-cc = "commoncompute.cli:app"
+# `commoncompute` is the only installed command. A short `cc` alias is
+# deliberately NOT shipped: it shadows the Unix C compiler (/usr/bin/cc), so
+# installing it into a PATH-early location silently breaks any build that
+# invokes `cc`. Users who want the shorthand opt in themselves with
+# `alias cc="commoncompute"`.
 commoncompute = "commoncompute.cli:app"
 
 [project.optional-dependencies]