flatagents 2.2.2__tar.gz → 2.4.0__tar.gz

{flatagents-2.2.2 → flatagents-2.4.0}/MACHINES.md

@@ -72,9 +72,10 @@ Common fields supported by the Python runtime:
 - `provider`, `name` (combined into `provider/name` if needed)
 - `temperature`, `max_tokens`, `top_p`, `top_k`
 - `frequency_penalty`, `presence_penalty`, `seed`
-- `base_url` (passed as `api_base` to LiteLLM)
+- `base_url` (passed as `api_base` to LiteLLM, or Codex base URL for `backend: codex`)
 - `stream` (bool), `stream_options`
-- `backend` ("litellm" | "aisuite")
+- `backend` ("litellm" | "aisuite" | "codex")
+- `oauth` (Codex auth config: `auth_file`, `originator`, `refresh`, `timeout_seconds`, `max_retries`, `token_url`, `client_id`)
 
 ## Python Runtime Behavior
 
@@ -114,6 +115,7 @@ print(result.output, result.content)
 The Python SDK supports:
 - **LiteLLMBackend** (default; `litellm`)
 - **AISuiteBackend** (`aisuite`)
+- **Codex OAuth backend** (`codex`)
 - **LLMBackend** protocol for custom providers
 
 Backend selection order:
@@ -122,6 +124,13 @@ Backend selection order:
 3. `FLATAGENTS_BACKEND` env var ("litellm" or "aisuite")
 4. Auto-detect installed backend (prefers litellm)
 
+Codex is never auto-detected; configure it explicitly via `backend: codex`.
+
+Codex login helper:
+```bash
+python -m flatagents.providers.openai_codex_login --auth-file ~/.pi/agent/auth.json
+```
+
 ## MCP Tooling
 
 `FlatAgent` can call MCP tools when `data.mcp` is configured and a `MCPToolProvider` is supplied. The provider must implement:

{flatagents-2.2.2 → flatagents-2.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flatagents
-Version: 2.2.2
+Version: 2.4.0
 Summary: A lightweight framework for building LLM-powered agents.
 Project-URL: Homepage, https://github.com/memgrafter/flatagents
 Project-URL: Repository, https://github.com/memgrafter/flatagents
@@ -120,6 +120,7 @@ Resolution order: default → named profile → inline overrides → override.
 Built-in backends:
 - **LiteLLMBackend** (default, `litellm`)
 - **AISuiteBackend** (`aisuite`)
+- **Codex OAuth backend** (`codex`)
 
 Selection order:
 1. `backend` argument to `FlatAgent(...)`
@@ -127,6 +128,23 @@ Selection order:
 3. `FLATAGENTS_BACKEND` env var ("litellm" or "aisuite")
 4. Auto-detect installed backend (prefers litellm)
 
+Codex is explicit only (not auto-detected):
+
+```yaml
+model:
+  provider: openai-codex
+  name: gpt-5
+  backend: codex
+  oauth:
+    auth_file: ~/.pi/agent/auth.json
+```
+
+Login helper:
+
+```bash
+python -m flatagents.providers.openai_codex_login --auth-file ~/.pi/agent/auth.json
+```
+
 ## MCP Tools
 
 Configure MCP in `data.mcp` and pass a `MCPToolProvider` implementation. The SDK does not ship a provider; you supply one (e.g., from `aisuite.mcp`). Tool calls are returned in `AgentResponse.tool_calls`.

{flatagents-2.2.2 → flatagents-2.4.0}/README.md

@@ -77,6 +77,7 @@ Resolution order: default → named profile → inline overrides → override.
 Built-in backends:
 - **LiteLLMBackend** (default, `litellm`)
 - **AISuiteBackend** (`aisuite`)
+- **Codex OAuth backend** (`codex`)
 
 Selection order:
 1. `backend` argument to `FlatAgent(...)`
@@ -84,6 +85,23 @@ Selection order:
 3. `FLATAGENTS_BACKEND` env var ("litellm" or "aisuite")
 4. Auto-detect installed backend (prefers litellm)
 
+Codex is explicit only (not auto-detected):
+
+```yaml
+model:
+  provider: openai-codex
+  name: gpt-5
+  backend: codex
+  oauth:
+    auth_file: ~/.pi/agent/auth.json
+```
+
+Login helper:
+
+```bash
+python -m flatagents.providers.openai_codex_login --auth-file ~/.pi/agent/auth.json
+```
+
 ## MCP Tools
 
 Configure MCP in `data.mcp` and pass a `MCPToolProvider` implementation. The SDK does not ship a provider; you supply one (e.g., from `aisuite.mcp`). Tool calls are returned in `AgentResponse.tool_calls`.

{flatagents-2.2.2 → flatagents-2.4.0}/flatagents/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "2.2.2"
+__version__ = "2.4.0"
 
 from .baseagent import (
     # Base agent (abstract, for multi-step agents)
@@ -71,6 +71,14 @@ from .providers import (
     extract_anthropic_rate_limits,
     OpenAIRateLimits,
     extract_openai_rate_limits,
+    CodexAuthError,
+    CodexClient,
+    CodexClientError,
+    CodexHTTPError,
+    CodexOAuthCredential,
+    CodexResult,
+    CodexToolCall,
+    CodexUsage,
 )
 
 __all__ = [
@@ -113,6 +121,14 @@ __all__ = [
     "extract_anthropic_rate_limits",
     "OpenAIRateLimits",
     "extract_openai_rate_limits",
+    "CodexAuthError",
+    "CodexClient",
+    "CodexClientError",
+    "CodexHTTPError",
+    "CodexOAuthCredential",
+    "CodexResult",
+    "CodexToolCall",
+    "CodexUsage",
     # Validation
     "validate_flatagent_config",
     "get_flatagent_schema",

{flatagents-2.2.2 → flatagents-2.4.0}/flatagents/assets/flatagent.d.ts

@@ -46,6 +46,8 @@
  * presence_penalty  - Presence penalty (-2.0 to 2.0)
  * seed              - Random seed for reproducibility
  * base_url          - Custom API base URL (for local models/proxies)
+ * backend           - Runtime backend override (litellm, aisuite, codex)
+ * oauth             - OAuth settings (used by codex backend)
  *
  * MODEL PROFILES:
  * ---------------
@@ -149,7 +151,7 @@
  * The profile field specifies which profile name to use as base.
  */
 
-export const SPEC_VERSION = "2.2.2";
+export const SPEC_VERSION = "2.4.0";
 
 export interface AgentWrapper {
   spec: "flatagent";
@@ -198,6 +200,17 @@ export interface ToolFilter {
   deny?: string[];
 }
 
+export interface OAuthConfig {
+  provider?: "openai-codex" | string;
+  auth_file?: string;
+  refresh?: boolean;
+  originator?: string;
+  timeout_seconds?: number;
+  max_retries?: number;
+  token_url?: string;
+  client_id?: string;
+}
+
 export interface ModelConfig {
   name: string;
   provider?: string;
@@ -209,6 +222,9 @@ export interface ModelConfig {
   presence_penalty?: number;
   seed?: number;
   base_url?: string;
+  backend?: "litellm" | "aisuite" | "codex";
+  api?: string;
+  oauth?: OAuthConfig;
 }
 
 export interface ProfiledModelConfig extends Partial<ModelConfig> {

{flatagents-2.2.2 → flatagents-2.4.0}/flatagents/assets/flatagent.schema.json

@@ -106,6 +106,20 @@
         },
         "base_url": {
           "type": "string"
+        },
+        "backend": {
+          "type": "string",
+          "enum": [
+            "litellm",
+            "aisuite",
+            "codex"
+          ]
+        },
+        "api": {
+          "type": "string"
+        },
+        "oauth": {
+          "$ref": "#/definitions/OAuthConfig"
         }
       },
       "required": [
@@ -113,6 +127,36 @@
       ],
       "additionalProperties": false
     },
+    "OAuthConfig": {
+      "type": "object",
+      "properties": {
+        "provider": {
+          "type": "string"
+        },
+        "auth_file": {
+          "type": "string"
+        },
+        "refresh": {
+          "type": "boolean"
+        },
+        "originator": {
+          "type": "string"
+        },
+        "timeout_seconds": {
+          "type": "number"
+        },
+        "max_retries": {
+          "type": "number"
+        },
+        "token_url": {
+          "type": "string"
+        },
+        "client_id": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    },
     "ProfiledModelConfig": {
       "type": "object",
       "properties": {
@@ -146,6 +190,20 @@
         "base_url": {
           "type": "string"
         },
+        "backend": {
+          "type": "string",
+          "enum": [
+            "litellm",
+            "aisuite",
+            "codex"
+          ]
+        },
+        "api": {
+          "type": "string"
+        },
+        "oauth": {
+          "$ref": "#/definitions/OAuthConfig"
+        },
         "profile": {
           "type": "string"
         }

{flatagents-2.2.2 → flatagents-2.4.0}/flatagents/assets/flatagent.slim.d.ts

@@ -1,4 +1,4 @@
-export const SPEC_VERSION = "2.2.2";
+export const SPEC_VERSION = "2.4.0";
 export interface AgentWrapper {
     spec: "flatagent";
     spec_version: string;
@@ -40,6 +40,16 @@ export interface ToolFilter {
     allow?: string[];
     deny?: string[];
 }
+export interface OAuthConfig {
+    provider?: "openai-codex" | string;
+    auth_file?: string;
+    refresh?: boolean;
+    originator?: string;
+    timeout_seconds?: number;
+    max_retries?: number;
+    token_url?: string;
+    client_id?: string;
+}
 export interface ModelConfig {
     name: string;
     provider?: string;
@@ -51,6 +61,9 @@ export interface ModelConfig {
     presence_penalty?: number;
     seed?: number;
     base_url?: string;
+    backend?: "litellm" | "aisuite" | "codex";
+    api?: string;
+    oauth?: OAuthConfig;
 }
 export interface ProfiledModelConfig extends Partial<ModelConfig> {
     profile: string;

{flatagents-2.2.2 → flatagents-2.4.0}/flatagents/assets/flatagents-runtime.d.ts

@@ -800,7 +800,7 @@ export interface BackendConfig {
     aws_region?: string;
 }
 
-export const SPEC_VERSION = "2.2.2";
+export const SPEC_VERSION = "2.4.0";
 
 export interface SDKRuntimeWrapper {
     spec: "flatagents-runtime";

{flatagents-2.2.2 → flatagents-2.4.0}/flatagents/assets/flatagents-runtime.schema.json

@@ -11,7 +11,7 @@
         },
         "spec_version": {
           "type": "string",
-          "const": "2.2.2"
+          "const": "2.4.0"
         },
         "execution_lock": {
           "$ref": "#/definitions/ExecutionLock"

{flatagents-2.2.2 → flatagents-2.4.0}/flatagents/assets/flatagents-runtime.slim.d.ts

@@ -252,7 +252,7 @@ export interface BackendConfig {
     dynamodb_table?: string;
     aws_region?: string;
 }
-export const SPEC_VERSION = "2.2.2";
+export const SPEC_VERSION = "2.4.0";
 export interface SDKRuntimeWrapper {
     spec: "flatagents-runtime";
     spec_version: typeof SPEC_VERSION;

{flatagents-2.2.2 → flatagents-2.4.0}/flatagents/assets/flatmachine.d.ts

@@ -319,7 +319,7 @@
  * config_hash         - Content-addressed machine config key for cross-SDK resume (v2.1.0)
  */
 
-export const SPEC_VERSION = "2.2.2";
+export const SPEC_VERSION = "2.4.0";
 
 export interface MachineWrapper {
   spec: "flatmachine";

{flatagents-2.2.2 → flatagents-2.4.0}/flatagents/assets/flatmachine.schema.json

@@ -245,6 +245,20 @@
         },
         "base_url": {
           "type": "string"
+        },
+        "backend": {
+          "type": "string",
+          "enum": [
+            "litellm",
+            "aisuite",
+            "codex"
+          ]
+        },
+        "api": {
+          "type": "string"
+        },
+        "oauth": {
+          "$ref": "#/definitions/OAuthConfig"
         }
       },
       "required": [
@@ -252,6 +266,36 @@
       ],
       "additionalProperties": false
     },
+    "OAuthConfig": {
+      "type": "object",
+      "properties": {
+        "provider": {
+          "type": "string"
+        },
+        "auth_file": {
+          "type": "string"
+        },
+        "refresh": {
+          "type": "boolean"
+        },
+        "originator": {
+          "type": "string"
+        },
+        "timeout_seconds": {
+          "type": "number"
+        },
+        "max_retries": {
+          "type": "number"
+        },
+        "token_url": {
+          "type": "string"
+        },
+        "client_id": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
+    },
     "ProfiledModelConfig": {
       "type": "object",
       "properties": {
@@ -285,6 +329,20 @@
         "base_url": {
           "type": "string"
         },
+        "backend": {
+          "type": "string",
+          "enum": [
+            "litellm",
+            "aisuite",
+            "codex"
+          ]
+        },
+        "api": {
+          "type": "string"
+        },
+        "oauth": {
+          "$ref": "#/definitions/OAuthConfig"
+        },
         "profile": {
           "type": "string"
         }

{flatagents-2.2.2 → flatagents-2.4.0}/flatagents/assets/flatmachine.slim.d.ts

@@ -1,4 +1,4 @@
-export const SPEC_VERSION = "2.2.2";
+export const SPEC_VERSION = "2.4.0";
 export interface MachineWrapper {
     spec: "flatmachine";
     spec_version: string;

{flatagents-2.2.2 → flatagents-2.4.0}/flatagents/assets/profiles.d.ts

@@ -106,9 +106,11 @@
  * seed              - Random seed for reproducibility
  * base_url          - Custom base URL for the API (e.g., for local models or proxies)
  * stream            - Enable streaming responses (default: false)
+ * backend           - Runtime backend override (litellm, aisuite, codex)
+ * oauth             - OAuth settings (used by codex backend)
  */
 
-export const SPEC_VERSION = "2.2.2";
+export const SPEC_VERSION = "2.4.0";
 
 export interface ProfilesWrapper {
   spec: "flatprofiles";
@@ -123,6 +125,17 @@ export interface ProfilesData {
   override?: string;
 }
 
+export interface OAuthConfig {
+  provider?: "openai-codex" | string;
+  auth_file?: string;
+  refresh?: boolean;
+  originator?: string;
+  timeout_seconds?: number;
+  max_retries?: number;
+  token_url?: string;
+  client_id?: string;
+}
+
 export interface ModelProfileConfig {
   name: string;
   provider?: string;
@@ -135,6 +148,9 @@ export interface ModelProfileConfig {
   seed?: number;
   base_url?: string;
   stream?: boolean;
+  backend?: "litellm" | "aisuite" | "codex";
+  api?: string;
+  oauth?: OAuthConfig;
 }
 
 export type FlatprofilesConfig = ProfilesWrapper;

{flatagents-2.2.2 → flatagents-2.4.0}/flatagents/assets/profiles.schema.json

@@ -82,12 +82,56 @@
         },
         "stream": {
           "type": "boolean"
+        },
+        "backend": {
+          "type": "string",
+          "enum": [
+            "litellm",
+            "aisuite",
+            "codex"
+          ]
+        },
+        "api": {
+          "type": "string"
+        },
+        "oauth": {
+          "$ref": "#/definitions/OAuthConfig"
         }
       },
       "required": [
         "name"
       ],
       "additionalProperties": false
+    },
+    "OAuthConfig": {
+      "type": "object",
+      "properties": {
+        "provider": {
+          "type": "string"
+        },
+        "auth_file": {
+          "type": "string"
+        },
+        "refresh": {
+          "type": "boolean"
+        },
+        "originator": {
+          "type": "string"
+        },
+        "timeout_seconds": {
+          "type": "number"
+        },
+        "max_retries": {
+          "type": "number"
+        },
+        "token_url": {
+          "type": "string"
+        },
+        "client_id": {
+          "type": "string"
+        }
+      },
+      "additionalProperties": false
     }
   }
 }

{flatagents-2.2.2 → flatagents-2.4.0}/flatagents/assets/profiles.slim.d.ts

@@ -1,4 +1,4 @@
-export const SPEC_VERSION = "2.2.2";
+export const SPEC_VERSION = "2.4.0";
 export interface ProfilesWrapper {
     spec: "flatprofiles";
     spec_version: string;
@@ -10,6 +10,16 @@ export interface ProfilesData {
     default?: string;
     override?: string;
 }
+export interface OAuthConfig {
+    provider?: "openai-codex" | string;
+    auth_file?: string;
+    refresh?: boolean;
+    originator?: string;
+    timeout_seconds?: number;
+    max_retries?: number;
+    token_url?: string;
+    client_id?: string;
+}
 export interface ModelProfileConfig {
     name: string;
     provider?: string;
@@ -22,5 +32,8 @@ export interface ModelProfileConfig {
     seed?: number;
     base_url?: string;
     stream?: boolean;
+    backend?: "litellm" | "aisuite" | "codex";
+    api?: string;
+    oauth?: OAuthConfig;
 }
 export type FlatprofilesConfig = ProfilesWrapper;