codai-sdk 0.7.0__tar.gz → 0.12.0__tar.gz

{codai_sdk-0.7.0 → codai_sdk-0.12.0}/CHANGELOG.md

@@ -6,6 +6,83 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [0.12.0] - 2026-10-05
+
+### Added
+
+- `client.audio.speech_stream(body)` → `POST /v1/audio/speech/stream` (`codai-tts-ro`, Azure neural TTS with
+  visemes): generator of `{"type": "start"|"audio"|"viseme"|"word"|"done"|"error", ...}`; `audio` events carry the
+  decoded `audio_bytes`. `createSpeechStream` in the parity table.
+- `client.system_one.batch(items, questions, timeout_ms=None, fallback=None)` — the same questions about up to 16
+  states in one call; `system_one.create` documents the new `items`, `timeout_ms` and `fallback` fields and the
+  `fallback_used` response flag.
+- Ephemeral token scope `live` (realtime + audio) accepted by `tokens.create`.
+- `_types.py` regenerated (`SpeechStreamRequest`, `SpeechStreamEvent`, batch fields on `SystemOneRequest` /
+  `SystemOneResponse`).
+
+### Not included
+
+- No realtime (WebSocket) helper: the SDK is zero-dependency and the standard library has no WebSocket client, and
+  `/v1/realtime` is outside the OpenAPI parity contract. Use `tokens.create("live")` and any WebSocket client against
+  `wss://ai.codai.ro/v1/realtime?model=codai-transcribe-live&language=ro&key=<token>` (protocol in the docs,
+  gateway → Embeddings, audio & realtime).
+
+## [0.11.0] - 2026-10-02
+
+### Added
+
+- `client.devices.revoke_self_key()` — `POST /v1/keys/self/revoke`: the calling API key revokes itself (sign out).
+
+## [0.10.0] - 2026-09-29
+
+### Added
+
+- `client.prompts.{list, create, get, update, delete, launch}` — pending prompts (`/v1/prompts/*`):
+  ready-to-paste prompts left for a future chat, with `goal_key` supersede, `not_before` reminders
+  (`prompt.due` notifications) and `launch` into a new session on a device. `launch` is never retried.
+  `_types.py` regenerated (`Prompt`, `PromptCreate`, `PromptPatch`, `PromptCreated`, …).
+
+## [0.9.0] - 2026-09-29
+
+### Added
+
+- `client.sessions.dispatch(session_id, *, device_id=..., text=..., mode="send"|"open", turn_id=..., control_id=...)`
+  keyword form. `mode="open"` hands the session off — the target only opens it (no user turn), and
+  `text`/`turn_id` are dropped. The positional `body` dict still works (keywords override its keys); a
+  `send` without `text` now raises `ValueError` client-side instead of a server `400`.
+- Regenerated `src/codai/_types.py`: `SessionDispatchRequest.mode` (`text` now optional),
+  `SessionDispatchResponse.mode`, `SessionControl.mode` (`'open'` on handoff controls) and
+  `DeviceListItem.online` (seen in the last 2 minutes).
+- `client.images.edit({"prompt": ..., "image": {"b64_json": ..., "mime_type": ...} | [...]})` →
+  `POST /v1/images/edits` (JSON body, 1–14 input images; `mask` unsupported). `editImage` in the
+  parity table; `EditImageBody` / `CoreImageEditRequest` types.
+- `ImagesResult.mime_types` and `ImagesResult.data_region` (`x-codai-data-region`, `eu` | `global`).
+- `generate()` types gain `reference_images`, `aspect_ratio`, `image_size` and the
+  `codai-image-fast` / `codai-image-pro` model ids.
+
+### Changed
+
+- `codai-image` is now `gemini-3.1-flash-image` on the Vertex EU endpoint (2.5 is shut down on
+  2026-10-02 and served as `codai-image`). `cost_micro_usd` is usage-based (≈ $0.074 per default
+  1K image) instead of a flat $0.04. The image request floor timeout is 150 s.
+
+## [0.8.0] - 2026-09-29
+
+### Added
+
+- `client.images.generate({"prompt": ..., "n"?, "size"?, "negative_prompt"?, "model"?})` →
+  `POST /v1/images/generations` (base64 only). Backed by `gemini-2.5-flash-image`; `model`
+  defaults to `codai-image` (`imagen-4` / `imagen-4-fast` are legacy aliases). Flat $0.04 per
+  returned image, reported as `cost_micro_usd`.
+- EXPERIMENTAL, unaudited (HIDE protocol) agent-output signatures — provenance only, never
+  authentication:
+  - `EnvironmentTask.output_signature: Optional[EnvironmentTaskOutputSignature]` plus the
+    `AgentOutputKey` / `AgentOutputVerifyRequest` / `AgentOutputVerifyResult` types
+    (regenerated `src/codai/_types.py`).
+  - `client.verify.agent_output_key()` → `GET /v1/verify/agent-output/key` and
+    `client.verify.agent_output(payload, signature)` → `POST /v1/verify/agent-output`
+    (public; never retried, 503 `signing_disabled` when signing is off).
+
 ## [0.7.0] - 2026-09-27
 
 ### Added

{codai_sdk-0.7.0 → codai_sdk-0.12.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: codai-sdk
-Version: 0.7.0
+Version: 0.12.0
 Summary: Official Python SDK for the codai AI gateway — chat, messages, responses, streaming, agents, sessions, hosts, tasks, account.
 Project-URL: Homepage, https://codai.ro
 Project-URL: Repository, https://github.com/codai-ro/codai-sdk-python

{codai_sdk-0.7.0 → codai_sdk-0.12.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "codai-sdk"
-version = "0.7.0"
+version = "0.12.0"
 description = "Official Python SDK for the codai AI gateway — chat, messages, responses, streaming, agents, sessions, hosts, tasks, account."
 readme = "README.md"
 license = "MIT"

{codai_sdk-0.7.0 → codai_sdk-0.12.0}/src/codai/__init__.py

@@ -50,12 +50,15 @@ from .resources import (
     Feedback,
     Health,
     Hosts,
+    Images,
+    ImagesResult,
     Messages,
     Models,
     Notifications,
     Orgs,
     PhoneModels,
     Projects,
+    Prompts,
     Receipts,
     Resolve,
     ResolveError,
@@ -67,6 +70,7 @@ from .resources import (
     Tokens,
     Tools,
     Triggers,
+    Verify,
     attestation_statement,
     verify_attestation_with_keys,
     verify_resolve_webhook,
@@ -80,6 +84,7 @@ __all__ = [
     "AgentRunResult",
     "EphemeralToken",
     "HttpClient",
+    "ImagesResult",
     "RequestExtensions",
     "SseFrame",
     "OPERATION_METHODS",
@@ -96,7 +101,7 @@ __all__ = [
     "verify_attestation_with_keys",
     "verify_resolve_webhook",
 ]
-__version__ = "0.7.0"
+__version__ = "0.12.0"
 
 
 class _CallableGroup:
@@ -155,6 +160,7 @@ class Codai:
 
         self.messages = Messages(http)
         self.responses = Responses(http)
+        self.images = Images(http)
         self.audio = Audio(http)
         self.system_one = SystemOne(http)
         self.tokens = Tokens(http)
@@ -168,11 +174,14 @@ class Codai:
         self.orgs = Orgs(http)
         self.projects = Projects(http)
         self.environments = Environments(http)
+        # EXPERIMENTAL (HIDE, unaudited): verify signed agent outputs — provenance only.
+        self.verify = Verify(http)
         self.account = Account(http)
         self.receipt = Receipts(http)
         self.phone_models = PhoneModels(http)
         self.triggers = Triggers(http)
         self.notifications = Notifications(http)
+        self.prompts = Prompts(http)
         # codai Resolve lives on its own host; same key, no X-Codai-* defaults.
         self.resolve = Resolve(
             HttpClient(

{codai_sdk-0.7.0 → codai_sdk-0.12.0}/src/codai/_operations.py

@@ -16,9 +16,12 @@ OPERATION_METHODS: Dict[str, str] = {
     "createMessage": "messages.create",
     # Embeddings & Audio
     "createEmbeddings": "embeddings.create",
+    "createImage": "images.generate",
+    "editImage": "images.edit",
     "createSystemOne": "system_one.create",
     "createTranscription": "audio.transcribe",
     "createSpeech": "audio.speech",
+    "createSpeechStream": "audio.speech_stream",
     "createEphemeralToken": "tokens.create",
     # Models
     "listModels": "models.list",
@@ -64,6 +67,7 @@ OPERATION_METHODS: Dict[str, str] = {
     "listDevices": "devices.list",
     "updateDevice": "devices.update",
     "deleteDevice": "devices.delete",
+    "revokeSelfKey": "devices.revoke_self_key",
     # Hosts
     "listHosts": "hosts.list",
     "streamHost": "hosts.stream",
@@ -112,6 +116,8 @@ OPERATION_METHODS: Dict[str, str] = {
     "listEnvironmentTasks": "environments.tasks.list",
     "createEnvironmentTask": "environments.tasks.create",
     "getEnvironmentTask": "environments.tasks.get",
+    "getAgentOutputKey": "verify.agent_output_key",
+    "verifyAgentOutput": "verify.agent_output",
     "listTriggers": "triggers.list",
     "createTrigger": "triggers.create",
     "updateTrigger": "triggers.update",
@@ -125,6 +131,12 @@ OPERATION_METHODS: Dict[str, str] = {
     "markNotificationsRead": "notifications.mark_read",
     "deleteNotification": "notifications.delete",
     "deleteNotifications": "notifications.delete_many",
+    "listPrompts": "prompts.list",
+    "createPrompt": "prompts.create",
+    "getPrompt": "prompts.get",
+    "updatePrompt": "prompts.update",
+    "deletePrompt": "prompts.delete",
+    "launchPrompt": "prompts.launch",
     # Account
     "getAccount": "account.get",
     "patchAccount": "account.update",
@@ -134,7 +146,9 @@ OPERATION_METHODS: Dict[str, str] = {
 }
 
 # Operations whose SDK method is a generator (SSE-only endpoints).
-STREAMING_OPERATIONS: FrozenSet[str] = frozenset({"streamAgentRun", "streamSession", "streamHost"})
+STREAMING_OPERATIONS: FrozenSet[str] = frozenset(
+    {"streamAgentRun", "streamSession", "streamHost", "createSpeechStream"}
+)
 
 # codai Resolve (``apps/docs/openapi/en/resolve.yaml``) → ``client.resolve.*``.
 RESOLVE_OPERATION_METHODS: Dict[str, str] = {