salesforce-agent 0.2.0__tar.gz

salesforce_agent-0.2.0/LICENSE

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

salesforce_agent-0.2.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include LICENSE
+include README.md
+include requirements.txt
+recursive-include salesforce_agent *.py *.json

salesforce_agent-0.2.0/PKG-INFO

@@ -0,0 +1,215 @@
+Metadata-Version: 2.4
+Name: salesforce-agent
+Version: 0.2.0
+Summary: Salesforce REST/SOQL/Bulk API 2.0 connector + MCP Server + A2A Server for Agentic AI!
+Author-email: Audel Rouhi <knucklessg1@gmail.com>
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Environment :: Console
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Requires-Python: <3.15,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: agent-utilities>=0.48.0
+Requires-Dist: httpx>=0.27.0
+Provides-Extra: mcp
+Requires-Dist: agent-utilities[mcp]>=0.48.0; extra == "mcp"
+Provides-Extra: agent
+Requires-Dist: agent-utilities[agent,logfire]>=0.48.0; extra == "agent"
+Provides-Extra: jwt
+Requires-Dist: cryptography>=42.0.0; extra == "jwt"
+Provides-Extra: all
+Requires-Dist: salesforce-agent[agent,jwt,logfire,mcp]>=0.2.0; extra == "all"
+Provides-Extra: test
+Requires-Dist: pytest-xdist>=3.6.0; extra == "test"
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-asyncio; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Requires-Dist: cryptography>=42.0.0; extra == "test"
+Dynamic: license-file
+
+# Salesforce Agent
+## CLI or API | MCP | Agent
+
+![PyPI - Version](https://img.shields.io/pypi/v/salesforce-agent)
+![MCP Server](https://badge.mcpx.dev?type=server 'MCP Server')
+![PyPI - Downloads](https://img.shields.io/pypi/dd/salesforce-agent)
+![GitHub Repo stars](https://img.shields.io/github/stars/Knuckles-Team/salesforce-agent)
+![PyPI - License](https://img.shields.io/pypi/l/salesforce-agent)
+![GitHub last commit (by committer)](https://img.shields.io/github/last-commit/Knuckles-Team/salesforce-agent)
+![PyPI - Wheel](https://img.shields.io/pypi/wheel/salesforce-agent)
+
+*Version: 0.2.0*
+
+> **Documentation** — Installation, deployment, usage across the API, CLI, and MCP
+> server live on the docs site:
+> <https://knuckles-team.github.io/salesforce-agent/>
+
+## Table of Contents
+
+- [Overview](#overview)
+- [Architecture](#architecture)
+- [Installation](#installation)
+- [MCP Tools](#mcp-tools)
+- [Auth Flows](#auth-flows)
+- [Environment Variables](#environment-variables)
+- [Quick Start](#quick-start)
+- [Deployment](#deployment)
+- [Development](#development)
+- [License](#license)
+
+## Overview
+
+**The Salesforce connector for the agent-utilities fleet** — an owned thin
+httpx wrapper over the Salesforce REST API exposed as a FastMCP server and an
+A2A agent. REST + SOQL/SOSL + Bulk API 2.0 + metadata describe, with safety
+gates designed for autonomous agents.
+
+No `simple-salesforce`: every endpoint is a documented thin call with its
+Salesforce API doc URL cited in the docstring.
+
+## Architecture
+
+```mermaid
+graph TD
+    User([User/A2A]) --> Server[A2A Server / salesforce-agent]
+    Server --> Agent[Pydantic AI Agent]
+    Agent --> MCP[MCP Server / salesforce-mcp]
+    MCP --> Client[Api facade / httpx]
+    Client --> ExternalAPI([Salesforce REST API])
+```
+
+## Installation
+
+```bash
+pip install salesforce-agent            # core client only
+pip install salesforce-agent[mcp]       # + FastMCP server
+pip install salesforce-agent[agent]     # + Pydantic AI A2A agent server
+pip install salesforce-agent[jwt]       # + cryptography for the JWT bearer flow
+pip install salesforce-agent[all]       # everything
+```
+
+Prebuilt Docker image: `knucklessg1/salesforce-agent:latest`.
+
+## MCP Tools
+
+Five consolidated, action-routed tools. Each takes `action` and `params_json`.
+
+| Tool | Actions | Toggle |
+|------|---------|--------|
+| `salesforce_soql` | `query` (auto-pagination via `nextRecordsUrl`, capped), `query_all` (deleted/archived), `explain`, `search` (SOSL) | `SOQLTOOL` |
+| `salesforce_records` | `get` (field selection), `create`, `update`, `upsert` (external id), `delete`*, `composite` (≤25 subrequests), `collections_create`/`collections_update` (≤200 records), `collections_delete`* | `RECORDSTOOL` |
+| `salesforce_describe` | `global`, `sobject` (fields/relationships/picklists), `record_counts`, `limits` (API usage) | `DESCRIBETOOL` |
+| `salesforce_bulk` | `create_job` (insert/update/upsert/`delete`*/`hardDelete`*), `upload` (CSV), `close`, `abort`, `status`, `list_jobs`, `delete_job`, `results` (successful/failed/unprocessed, size-capped) | `BULKTOOL` |
+| `salesforce_admin` | `user_info`, `org_info`, `list_reports`, `run_report` (sync, capped). Listing/running Flows is **out of scope for v1**. | `ADMINTOOL` |
+
+`*` Destructive — blocked unless `SALESFORCE_ALLOW_DESTRUCTIVE=true`.
+
+## Auth Flows
+
+| Flow | Credentials | Notes |
+|------|-------------|-------|
+| OAuth2 client-credentials | consumer key + secret + My Domain URL | default server-to-server flow |
+| OAuth2 refresh-token | refresh token + consumer key | instance URL from token response |
+| OAuth2 JWT bearer | consumer key + username + RSA key | `pip install salesforce-agent[jwt]` |
+| Static access token | token + instance URL | testing / externally managed sessions |
+
+Sandbox orgs: `SALESFORCE_SANDBOX=true` (`test.salesforce.com`). Tokens are
+cached with expiry tracking and refreshed transparently (plus one retry on
+401); secrets are redacted from all errors and logs.
+
+## Environment Variables
+
+| Variable | Default | Purpose |
+|----------|---------|---------|
+| `SALESFORCE_INSTANCE_URL` | — | My Domain instance URL (required for client-credentials and static tokens) |
+| `SALESFORCE_LOGIN_URL` | derived | Override the OAuth login host |
+| `SALESFORCE_SANDBOX` | `False` | Sandbox org (`test.salesforce.com`) |
+| `SALESFORCE_API_VERSION` | `v62.0` | REST API version |
+| `SALESFORCE_AUTH_FLOW` | auto | `client_credentials` / `refresh_token` / `jwt_bearer` / `access_token` |
+| `SALESFORCE_CLIENT_ID` / `SALESFORCE_CLIENT_SECRET` | — | Connected App consumer key/secret |
+| `SALESFORCE_REFRESH_TOKEN` | — | Refresh-token flow credential |
+| `SALESFORCE_JWT_SUBJECT` / `SALESFORCE_JWT_PRIVATE_KEY[_PATH]` / `SALESFORCE_JWT_AUDIENCE` | — | JWT bearer flow |
+| `SALESFORCE_ACCESS_TOKEN` | — | Static access token (testing) |
+| `SALESFORCE_TOKEN_TTL_SECONDS` | `1800` | Cached-token TTL fallback |
+| `SALESFORCE_SSL_VERIFY` | `True` | TLS verification |
+| `SALESFORCE_TIMEOUT` | `30` | HTTP timeout (seconds) |
+| `SALESFORCE_ALLOW_DESTRUCTIVE` | `False` | Gate for all delete paths |
+| `SALESFORCE_MAX_QUERY_RECORDS` | `2000` | Per-call SOQL pagination cap |
+| `SALESFORCE_BULK_RESULTS_MAX_BYTES` | `5000000` | Bulk result download cap |
+| `SALESFORCE_REPORT_MAX_ROWS` | `2000` | Sync report detail-row note (platform cap) |
+| `HOST` / `PORT` / `TRANSPORT` | `0.0.0.0` / `8000` / `stdio` | MCP server bind + transport |
+| `SOQLTOOL` / `RECORDSTOOL` / `DESCRIBETOOL` / `BULKTOOL` / `ADMINTOOL` | `True` | Per-domain tool toggles |
+| `ENABLE_OTEL` / `OTEL_EXPORTER_OTLP_*` | — | Telemetry (OTEL / Langfuse) |
+| `EUNOMIA_TYPE` / `EUNOMIA_POLICY_FILE` / `EUNOMIA_REMOTE_URL` | `none` | MCP authorization middleware |
+| `AUTH_TYPE` | `none` | MCP server auth mode (Docker) |
+
+See `.env.example` for the full annotated list.
+
+## Quick Start
+
+```bash
+pip install salesforce-agent[all]
+cp .env.example .env   # fill in one auth flow
+salesforce-mcp         # stdio MCP server
+```
+
+```python
+from salesforce_agent import Api
+
+api = Api()  # configured from SALESFORCE_* env vars
+rows = api.soql.query("SELECT Id, Name FROM Account", max_records=200)
+api.records.upsert("Account", "External_Id__c", "X-1", {"Name": "Acme"})
+```
+
+Typed tool-input contracts live in
+`salesforce_agent.salesforce_input_models`; typed error envelopes in
+`salesforce_agent.salesforce_response_models`.
+
+## Deployment
+
+```bash
+# MCP server only (port 8000, streamable-http, /health)
+docker compose -f docker/mcp.compose.yml up -d
+
+# MCP server + A2A agent server (agent on port 9020, AG-UI web interface)
+docker compose -f docker/agent.compose.yml up -d
+```
+
+The A2A agent server (`salesforce-agent` console script, `agent_server.py`)
+reads `MCP_URL`, `PROVIDER`, and `MODEL_ID` from the environment. See
+[docs/deployment.md](docs/deployment.md) for transports, reverse proxy, and
+DNS guidance.
+
+See [docs/](docs/index.md) for the full overview, installation, usage, and
+deployment guides; concept registry in [docs/concepts.md](docs/concepts.md)
+(`CONCEPT:SFDC-1.x`).
+
+<!-- BEGIN GENERATED: additional-deployment-options -->
+### Additional Deployment Options
+
+`salesforce-agent` can also run as a **local container** (Docker / Podman / `uv`) or be
+consumed from a **remote deployment**. The
+[Deployment guide](https://knuckles-team.github.io/salesforce-agent/deployment/) has full, copy-paste
+`mcp_config.json` for all four transports — **stdio**, **streamable-http**,
+**local container / uv**, and **remote URL**:
+
+- **Local container / uv** — launch the server from `mcp_config.json` via `uvx`,
+  `docker run`, or `podman run`, or point at a local streamable-http container by `url`.
+- **Remote URL** — connect to a server deployed behind Caddy at
+  `http://salesforce-mcp.arpa/mcp` using the `"url"` key.
+<!-- END GENERATED: additional-deployment-options -->
+
+## Development
+
+```bash
+pip install -e .[all,test]
+pytest                       # mocked httpx suite — no live org required
+pre-commit run --all-files   # must be fully green before committing
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

salesforce_agent-0.2.0/README.md

@@ -0,0 +1,183 @@
+# Salesforce Agent
+## CLI or API | MCP | Agent
+
+![PyPI - Version](https://img.shields.io/pypi/v/salesforce-agent)
+![MCP Server](https://badge.mcpx.dev?type=server 'MCP Server')
+![PyPI - Downloads](https://img.shields.io/pypi/dd/salesforce-agent)
+![GitHub Repo stars](https://img.shields.io/github/stars/Knuckles-Team/salesforce-agent)
+![PyPI - License](https://img.shields.io/pypi/l/salesforce-agent)
+![GitHub last commit (by committer)](https://img.shields.io/github/last-commit/Knuckles-Team/salesforce-agent)
+![PyPI - Wheel](https://img.shields.io/pypi/wheel/salesforce-agent)
+
+*Version: 0.2.0*
+
+> **Documentation** — Installation, deployment, usage across the API, CLI, and MCP
+> server live on the docs site:
+> <https://knuckles-team.github.io/salesforce-agent/>
+
+## Table of Contents
+
+- [Overview](#overview)
+- [Architecture](#architecture)
+- [Installation](#installation)
+- [MCP Tools](#mcp-tools)
+- [Auth Flows](#auth-flows)
+- [Environment Variables](#environment-variables)
+- [Quick Start](#quick-start)
+- [Deployment](#deployment)
+- [Development](#development)
+- [License](#license)
+
+## Overview
+
+**The Salesforce connector for the agent-utilities fleet** — an owned thin
+httpx wrapper over the Salesforce REST API exposed as a FastMCP server and an
+A2A agent. REST + SOQL/SOSL + Bulk API 2.0 + metadata describe, with safety
+gates designed for autonomous agents.
+
+No `simple-salesforce`: every endpoint is a documented thin call with its
+Salesforce API doc URL cited in the docstring.
+
+## Architecture
+
+```mermaid
+graph TD
+    User([User/A2A]) --> Server[A2A Server / salesforce-agent]
+    Server --> Agent[Pydantic AI Agent]
+    Agent --> MCP[MCP Server / salesforce-mcp]
+    MCP --> Client[Api facade / httpx]
+    Client --> ExternalAPI([Salesforce REST API])
+```
+
+## Installation
+
+```bash
+pip install salesforce-agent            # core client only
+pip install salesforce-agent[mcp]       # + FastMCP server
+pip install salesforce-agent[agent]     # + Pydantic AI A2A agent server
+pip install salesforce-agent[jwt]       # + cryptography for the JWT bearer flow
+pip install salesforce-agent[all]       # everything
+```
+
+Prebuilt Docker image: `knucklessg1/salesforce-agent:latest`.
+
+## MCP Tools
+
+Five consolidated, action-routed tools. Each takes `action` and `params_json`.
+
+| Tool | Actions | Toggle |
+|------|---------|--------|
+| `salesforce_soql` | `query` (auto-pagination via `nextRecordsUrl`, capped), `query_all` (deleted/archived), `explain`, `search` (SOSL) | `SOQLTOOL` |
+| `salesforce_records` | `get` (field selection), `create`, `update`, `upsert` (external id), `delete`*, `composite` (≤25 subrequests), `collections_create`/`collections_update` (≤200 records), `collections_delete`* | `RECORDSTOOL` |
+| `salesforce_describe` | `global`, `sobject` (fields/relationships/picklists), `record_counts`, `limits` (API usage) | `DESCRIBETOOL` |
+| `salesforce_bulk` | `create_job` (insert/update/upsert/`delete`*/`hardDelete`*), `upload` (CSV), `close`, `abort`, `status`, `list_jobs`, `delete_job`, `results` (successful/failed/unprocessed, size-capped) | `BULKTOOL` |
+| `salesforce_admin` | `user_info`, `org_info`, `list_reports`, `run_report` (sync, capped). Listing/running Flows is **out of scope for v1**. | `ADMINTOOL` |
+
+`*` Destructive — blocked unless `SALESFORCE_ALLOW_DESTRUCTIVE=true`.
+
+## Auth Flows
+
+| Flow | Credentials | Notes |
+|------|-------------|-------|
+| OAuth2 client-credentials | consumer key + secret + My Domain URL | default server-to-server flow |
+| OAuth2 refresh-token | refresh token + consumer key | instance URL from token response |
+| OAuth2 JWT bearer | consumer key + username + RSA key | `pip install salesforce-agent[jwt]` |
+| Static access token | token + instance URL | testing / externally managed sessions |
+
+Sandbox orgs: `SALESFORCE_SANDBOX=true` (`test.salesforce.com`). Tokens are
+cached with expiry tracking and refreshed transparently (plus one retry on
+401); secrets are redacted from all errors and logs.
+
+## Environment Variables
+
+| Variable | Default | Purpose |
+|----------|---------|---------|
+| `SALESFORCE_INSTANCE_URL` | — | My Domain instance URL (required for client-credentials and static tokens) |
+| `SALESFORCE_LOGIN_URL` | derived | Override the OAuth login host |
+| `SALESFORCE_SANDBOX` | `False` | Sandbox org (`test.salesforce.com`) |
+| `SALESFORCE_API_VERSION` | `v62.0` | REST API version |
+| `SALESFORCE_AUTH_FLOW` | auto | `client_credentials` / `refresh_token` / `jwt_bearer` / `access_token` |
+| `SALESFORCE_CLIENT_ID` / `SALESFORCE_CLIENT_SECRET` | — | Connected App consumer key/secret |
+| `SALESFORCE_REFRESH_TOKEN` | — | Refresh-token flow credential |
+| `SALESFORCE_JWT_SUBJECT` / `SALESFORCE_JWT_PRIVATE_KEY[_PATH]` / `SALESFORCE_JWT_AUDIENCE` | — | JWT bearer flow |
+| `SALESFORCE_ACCESS_TOKEN` | — | Static access token (testing) |
+| `SALESFORCE_TOKEN_TTL_SECONDS` | `1800` | Cached-token TTL fallback |
+| `SALESFORCE_SSL_VERIFY` | `True` | TLS verification |
+| `SALESFORCE_TIMEOUT` | `30` | HTTP timeout (seconds) |
+| `SALESFORCE_ALLOW_DESTRUCTIVE` | `False` | Gate for all delete paths |
+| `SALESFORCE_MAX_QUERY_RECORDS` | `2000` | Per-call SOQL pagination cap |
+| `SALESFORCE_BULK_RESULTS_MAX_BYTES` | `5000000` | Bulk result download cap |
+| `SALESFORCE_REPORT_MAX_ROWS` | `2000` | Sync report detail-row note (platform cap) |
+| `HOST` / `PORT` / `TRANSPORT` | `0.0.0.0` / `8000` / `stdio` | MCP server bind + transport |
+| `SOQLTOOL` / `RECORDSTOOL` / `DESCRIBETOOL` / `BULKTOOL` / `ADMINTOOL` | `True` | Per-domain tool toggles |
+| `ENABLE_OTEL` / `OTEL_EXPORTER_OTLP_*` | — | Telemetry (OTEL / Langfuse) |
+| `EUNOMIA_TYPE` / `EUNOMIA_POLICY_FILE` / `EUNOMIA_REMOTE_URL` | `none` | MCP authorization middleware |
+| `AUTH_TYPE` | `none` | MCP server auth mode (Docker) |
+
+See `.env.example` for the full annotated list.
+
+## Quick Start
+
+```bash
+pip install salesforce-agent[all]
+cp .env.example .env   # fill in one auth flow
+salesforce-mcp         # stdio MCP server
+```
+
+```python
+from salesforce_agent import Api
+
+api = Api()  # configured from SALESFORCE_* env vars
+rows = api.soql.query("SELECT Id, Name FROM Account", max_records=200)
+api.records.upsert("Account", "External_Id__c", "X-1", {"Name": "Acme"})
+```
+
+Typed tool-input contracts live in
+`salesforce_agent.salesforce_input_models`; typed error envelopes in
+`salesforce_agent.salesforce_response_models`.
+
+## Deployment
+
+```bash
+# MCP server only (port 8000, streamable-http, /health)
+docker compose -f docker/mcp.compose.yml up -d
+
+# MCP server + A2A agent server (agent on port 9020, AG-UI web interface)
+docker compose -f docker/agent.compose.yml up -d
+```
+
+The A2A agent server (`salesforce-agent` console script, `agent_server.py`)
+reads `MCP_URL`, `PROVIDER`, and `MODEL_ID` from the environment. See
+[docs/deployment.md](docs/deployment.md) for transports, reverse proxy, and
+DNS guidance.
+
+See [docs/](docs/index.md) for the full overview, installation, usage, and
+deployment guides; concept registry in [docs/concepts.md](docs/concepts.md)
+(`CONCEPT:SFDC-1.x`).
+
+<!-- BEGIN GENERATED: additional-deployment-options -->
+### Additional Deployment Options
+
+`salesforce-agent` can also run as a **local container** (Docker / Podman / `uv`) or be
+consumed from a **remote deployment**. The
+[Deployment guide](https://knuckles-team.github.io/salesforce-agent/deployment/) has full, copy-paste
+`mcp_config.json` for all four transports — **stdio**, **streamable-http**,
+**local container / uv**, and **remote URL**:
+
+- **Local container / uv** — launch the server from `mcp_config.json` via `uvx`,
+  `docker run`, or `podman run`, or point at a local streamable-http container by `url`.
+- **Remote URL** — connect to a server deployed behind Caddy at
+  `http://salesforce-mcp.arpa/mcp` using the `"url"` key.
+<!-- END GENERATED: additional-deployment-options -->
+
+## Development
+
+```bash
+pip install -e .[all,test]
+pytest                       # mocked httpx suite — no live org required
+pre-commit run --all-files   # must be fully green before committing
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

salesforce_agent-0.2.0/pyproject.toml

@@ -0,0 +1,58 @@
+[build-system]
+requires = [ "setuptools>=80.9.0", "wheel",]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "salesforce-agent"
+version = "0.2.0"
+description = "Salesforce REST/SOQL/Bulk API 2.0 connector + MCP Server + A2A Server for Agentic AI!"
+readme = "README.md"
+classifiers = [ "Development Status :: 4 - Beta", "License :: OSI Approved :: MIT License", "Environment :: Console", "Operating System :: POSIX :: Linux", "Programming Language :: Python :: 3",]
+requires-python = ">=3.11, <3.15"
+dependencies = [ "agent-utilities>=0.48.0", "httpx>=0.27.0",]
+[[project.authors]]
+name = "Audel Rouhi"
+email = "knucklessg1@gmail.com"
+
+[project.license]
+text = "MIT"
+
+[project.optional-dependencies]
+mcp = [ "agent-utilities[mcp]>=0.48.0",]
+agent = [ "agent-utilities[agent,logfire]>=0.48.0",]
+jwt = [ "cryptography>=42.0.0",]
+all = [ "salesforce-agent[mcp,agent,jwt,logfire]>=0.2.0",]
+test = [ "pytest-xdist>=3.6.0", "pytest", "pytest-asyncio", "pytest-cov", "cryptography>=42.0.0",]
+
+[project.scripts]
+salesforce-mcp = "salesforce_agent.mcp_server:mcp_server"
+salesforce-agent = "salesforce_agent.agent_server:agent_server"
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.ruff]
+line-length = 88
+target-version = "py310"
+
+[tool.mypy]
+python_version = "3.10"
+ignore_missing_imports = true
+check_untyped_defs = true
+
+[dependency-groups]
+dev = [ "pytest-timeout>=2.4.0",]
+
+[tool.setuptools.package-data]
+salesforce_agent = [ "mcp_config.json", "agent_data/**",]
+
+[tool.ruff.lint]
+select = [ "E", "F", "I", "UP", "B",]
+ignore = [ "E402", "E501", "B008",]
+
+[tool.setuptools.packages.find]
+where = [ ".",]
+include = [ "salesforce_agent*",]
+
+[tool.vulture]
+ignore_names = ["request", "config", "exc_info"]

salesforce_agent-0.2.0/requirements.txt

@@ -0,0 +1,2 @@
+agent-utilities>=0.48.0
+httpx>=0.27.0

salesforce_agent-0.2.0/salesforce_agent/__init__.py

@@ -0,0 +1,69 @@
+"""CONCEPT:ECO-4.0 Unified ecosystem initialization dynamic check."""
+
+import importlib
+import inspect
+from typing import Any
+
+__version__ = "0.2.0"
+__all__: list[str] = []
+
+CORE_MODULES = [
+    "salesforce_agent.salesforce_response_models",
+    "salesforce_agent.salesforce_input_models",
+    "salesforce_agent.auth",
+    "salesforce_agent.api_client",
+]
+OPTIONAL_MODULES = {
+    "salesforce_agent.agent_server": "agent",
+    "salesforce_agent.mcp_server": "mcp",
+}
+
+
+def _expose_members(module):
+    for name, obj in inspect.getmembers(module):
+        if (inspect.isclass(obj) or inspect.isfunction(obj)) and not name.startswith(
+            "_"
+        ):
+            globals()[name] = obj
+            if name not in __all__:
+                __all__.append(name)
+
+
+for module_name in CORE_MODULES:
+    module = importlib.import_module(module_name)
+    _expose_members(module)
+
+_loaded_optional_modules: dict[str, Any] = {}
+
+
+def _import_module_safely(module_name: str):
+    try:
+        return importlib.import_module(module_name)
+    except ImportError:
+        return None
+
+
+def __getattr__(name: str) -> Any:
+    if name == "_MCP_AVAILABLE":
+        mcp_key = next((k for k in OPTIONAL_MODULES if "mcp_server" in k), None)
+        return _import_module_safely(mcp_key) is not None if mcp_key else False
+    if name == "_AGENT_AVAILABLE":
+        agent_key = next((k for k in OPTIONAL_MODULES if "agent_server" in k), None)
+        return _import_module_safely(agent_key) is not None if agent_key else False
+
+    for module_name in OPTIONAL_MODULES:
+        if module_name not in _loaded_optional_modules:
+            module = _import_module_safely(module_name)
+            if module is not None:
+                _loaded_optional_modules[module_name] = module
+                _expose_members(module)
+
+        module = _loaded_optional_modules.get(module_name)
+        if module is not None and hasattr(module, name):
+            return getattr(module, name)
+
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+def __dir__() -> list[str]:
+    return sorted(list(globals().keys()) + __all__)

salesforce_agent-0.2.0/salesforce_agent/__main__.py

@@ -0,0 +1,4 @@
+from salesforce_agent.agent_server import agent_server
+
+if __name__ == "__main__":
+    agent_server()

salesforce_agent-0.2.0/salesforce_agent/agent_server.py

@@ -0,0 +1,77 @@
+"""Pydantic AI A2A agent server for the Salesforce connector."""
+
+import logging
+import os
+import sys
+import warnings
+
+__version__ = "0.2.0"
+
+logging.basicConfig(
+    level=logging.INFO,
+    format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
+)
+logger = logging.getLogger(__name__)
+
+DEFAULT_AGENT_NAME = None
+DEFAULT_AGENT_DESCRIPTION = None
+DEFAULT_AGENT_SYSTEM_PROMPT = None
+
+
+def agent_server():
+    """Start graph-based Pydantic AI agent server."""
+    from agent_utilities import (
+        build_system_prompt_from_workspace,
+        create_agent_parser,
+        create_agent_server,
+        initialize_workspace,
+        load_identity,
+    )
+
+    global DEFAULT_AGENT_NAME, DEFAULT_AGENT_DESCRIPTION, DEFAULT_AGENT_SYSTEM_PROMPT
+    initialize_workspace()
+    meta = load_identity()
+    DEFAULT_AGENT_NAME = os.getenv(
+        "DEFAULT_AGENT_NAME", meta.get("name", "Salesforce Agent")
+    )
+    DEFAULT_AGENT_DESCRIPTION = os.getenv(
+        "AGENT_DESCRIPTION",
+        meta.get("description", "AI agent for Salesforce CRM operations."),
+    )
+    DEFAULT_AGENT_SYSTEM_PROMPT = os.getenv(
+        "AGENT_SYSTEM_PROMPT",
+        meta.get("content") or build_system_prompt_from_workspace(),
+    )
+
+    warnings.filterwarnings("ignore", message=".*urllib3.*")
+    warnings.filterwarnings("ignore", category=DeprecationWarning, module="fastmcp")
+
+    print(f"{DEFAULT_AGENT_NAME} v{__version__}", file=sys.stderr)
+    parser = create_agent_parser()
+    args = parser.parse_args()
+
+    create_agent_server(
+        mcp_url=args.mcp_url,
+        mcp_config=args.mcp_config or "mcp_config.json",
+        host=args.host,
+        port=args.port,
+        provider=args.provider,
+        model_id=args.model_id,
+        router_model=args.model_id,
+        agent_model=args.model_id,
+        base_url=args.base_url,
+        api_key=args.api_key,
+        custom_skills_directory=args.custom_skills_directory,
+        enable_web_ui=args.web,
+        enable_otel=args.otel,
+        otel_endpoint=args.otel_endpoint,
+        otel_headers=args.otel_headers,
+        otel_public_key=args.otel_public_key,
+        otel_secret_key=args.otel_secret_key,
+        otel_protocol=args.otel_protocol,
+        debug=args.debug,
+    )
+
+
+if __name__ == "__main__":
+    agent_server()

salesforce_agent-0.2.0/salesforce_agent/api/__init__.py

@@ -0,0 +1,17 @@
+"""Salesforce REST API resource clients (owned thin httpx wrappers)."""
+
+from salesforce_agent.api.api_client_admin import AdminClient
+from salesforce_agent.api.api_client_base import ApiClientBase
+from salesforce_agent.api.api_client_bulk import BulkClient
+from salesforce_agent.api.api_client_describe import DescribeClient
+from salesforce_agent.api.api_client_query import QueryClient
+from salesforce_agent.api.api_client_records import RecordsClient
+
+__all__ = [
+    "AdminClient",
+    "ApiClientBase",
+    "BulkClient",
+    "DescribeClient",
+    "QueryClient",
+    "RecordsClient",
+]