commoncompute 0.2.0__tar.gz → 0.3.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: commoncompute
-Version: 0.2.0
+Version: 0.3.0
 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
@@ -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.0}/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.0}/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.0"
 
 from .client import Client, AsyncClient
 from .errors import (

{commoncompute-0.2.0 → commoncompute-0.3.0}/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.0}/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.0}/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)
 
 
@@ -575,7 +584,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.0}/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.0}/pyproject.toml

@@ -42,7 +42,11 @@ Source = "https://github.com/Ikaikaalika/commoncomputeai"
 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]