fred-sdk 0.1.0__tar.gz

fred_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,59 @@
+Metadata-Version: 2.4
+Name: fred-sdk
+Version: 0.1.0
+Summary: Authoring SDK for Fred agents — graph, ReAct, and team agent primitives.
+Author-email: Thales <noreply@thalesgroup.com>
+License: Apache-2.0
+Project-URL: Homepage, https://fredk8.dev
+Project-URL: Repository, https://github.com/ThalesGroup/fred
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Operating System :: OS Independent
+Requires-Python: <3.13,>=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: fred-core>=1.3.1
+Requires-Dist: fred-portable>=0.1.1
+Requires-Dist: pydantic<3.0.0,>=2.7.0
+Requires-Dist: langchain-core>=0.3.0
+Requires-Dist: langchain>=0.3.0
+Requires-Dist: langgraph>=1.1.3
+Requires-Dist: deepagents>=0.4.11
+Provides-Extra: dev
+Requires-Dist: bandit>=1.8.6; extra == "dev"
+Requires-Dist: basedpyright==1.31.0; extra == "dev"
+Requires-Dist: detect-secrets>=1.5.0; extra == "dev"
+Requires-Dist: pytest>=8.4.2; extra == "dev"
+Requires-Dist: pytest-cov>=6.2.1; extra == "dev"
+Requires-Dist: ruff>=0.12.5; extra == "dev"
+
+# Fred SDK
+
+`fred-sdk` is the authoring SDK for Fred agents. It packages the public
+interfaces used by agent authors (ReAct, graph workflows, team agents, HITL)
+so you can build workflows without wiring platform internals.
+
+Install
+-------
+```bash
+pip install fred-sdk
+```
+
+Quickstart
+----------
+```python
+from fred_sdk import hello_message
+
+print(hello_message("Ada"))
+```
+
+Notes
+-----
+- `fred-sdk` depends on `fred-core` and `fred-portable` and pulls them in
+  automatically.
+- The SDK surface lives in `fred_sdk/__init__.py` for top-level imports.
+
+Resources
+---------
+- Homepage: https://fredk8.dev
+- Repository: https://github.com/ThalesGroup/fred

fred_sdk-0.1.0/README.md

@@ -0,0 +1,30 @@
+# Fred SDK
+
+`fred-sdk` is the authoring SDK for Fred agents. It packages the public
+interfaces used by agent authors (ReAct, graph workflows, team agents, HITL)
+so you can build workflows without wiring platform internals.
+
+Install
+-------
+```bash
+pip install fred-sdk
+```
+
+Quickstart
+----------
+```python
+from fred_sdk import hello_message
+
+print(hello_message("Ada"))
+```
+
+Notes
+-----
+- `fred-sdk` depends on `fred-core` and `fred-portable` and pulls them in
+  automatically.
+- The SDK surface lives in `fred_sdk/__init__.py` for top-level imports.
+
+Resources
+---------
+- Homepage: https://fredk8.dev
+- Repository: https://github.com/ThalesGroup/fred

fred_sdk-0.1.0/fred_sdk/__init__.py

@@ -0,0 +1,221 @@
+# Copyright Thales 2026
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""
+fred-sdk public authoring surface.
+
+Everything an agent author needs is importable directly from this package.
+No submodule paths are required.
+
+ReAct agents
+------------
+    from fred_sdk import ReActAgent, tool, ToolContext, ToolOutput
+
+Graph agents
+------------
+    from fred_sdk import GraphAgent, GraphWorkflow, typed_node, StepResult
+
+Team agents
+-----------
+    from fred_sdk import TeamAgent, AgentSpec
+
+Human-in-the-loop
+-----------------
+    from fred_sdk import HumanInputRequest, HumanChoiceOption
+
+MCP server references
+---------------------
+    from fred_sdk import MCPServerRef, MCP_SERVER_KNOWLEDGE_FLOW_CORPUS
+
+What is NOT exported here (platform internals):
+    - ReActRuntime, GraphRuntime, DeepAgentRuntime  → agentic-backend wiring
+    - ChatModelFactoryPort, RuntimeServices          → platform port interfaces
+    - BoundRuntimeContext, PortableContext           → platform execution context
+    - ReActInput, ReActOutput, ReActMessage          → runtime transport types
+"""
+
+# ---------------------------------------------------------------------------
+# ReAct agent authoring
+# ---------------------------------------------------------------------------
+from fred_sdk.authoring.api import (
+    ArtifactPublicationError,
+    ModelInvocationError,
+    ReActAgent,
+    ResourceFetchError,
+    ResourceNotFoundError,
+    ToolContext,
+    ToolInvocationError,
+    ToolOutput,
+    UIHints,
+    prompt_md,
+    tool,
+    ui_field,
+)
+from fred_sdk.authoring.inspection import inspect_agent
+
+# ---------------------------------------------------------------------------
+# MCP server references
+# ---------------------------------------------------------------------------
+from fred_sdk.authoring.knowledge_flow_mcp import (
+    MCP_SERVER_KNOWLEDGE_FLOW_CORPUS,
+    MCP_SERVER_KNOWLEDGE_FLOW_FS,
+    MCP_SERVER_KNOWLEDGE_FLOW_OPENSEARCH_OPS,
+    MCP_SERVER_KNOWLEDGE_FLOW_STATISTICS,
+    MCP_SERVER_KNOWLEDGE_FLOW_TABULAR,
+    MCPServerRef,
+)
+
+# ---------------------------------------------------------------------------
+# Graph agent authoring
+# ---------------------------------------------------------------------------
+from fred_sdk.graph.authoring.api import (
+    GraphAgent,
+    GraphWorkflow,
+    StepResult,
+    WorkflowNode,
+    choice_step,
+    finalize_step,
+    intent_router_step,
+    model_text_step,
+    structured_model_step,
+    typed_node,
+)
+
+# ---------------------------------------------------------------------------
+# Team / multi-agent authoring
+# ---------------------------------------------------------------------------
+from fred_sdk.graph.authoring.team_api import (
+    AgentSpec,
+    TeamAgent,
+    TeamInput,
+    TeamMemberResult,
+    TeamState,
+)
+
+# ---------------------------------------------------------------------------
+# Shared types visible to agent authors inside node handlers and tool contexts
+# ---------------------------------------------------------------------------
+from fred_sdk.graph.runtime import (
+    GraphExecutionOutput,
+    GraphNodeContext,
+    GraphNodeResult,
+)
+from fred_sdk.contracts.context import (
+    AgentInvocationResult,
+    ArtifactScope,
+    PublishedArtifact,
+    RuntimeContext,
+    ToolContentKind,
+)
+from fred_sdk.contracts.models import (
+    DeepAgentDefinition,
+    FieldSpec,
+    GuardrailDefinition,
+    ReActAgentDefinition,
+    ReActPolicy,
+    ToolApprovalPolicy,
+    ToolRefRequirement,
+)
+from fred_sdk.contracts.runtime import HumanChoiceOption, HumanInputRequest
+
+# ---------------------------------------------------------------------------
+# Resource loading helpers
+# ---------------------------------------------------------------------------
+from fred_sdk.resources import load_agent_prompt_markdown, load_packaged_markdown
+
+# ---------------------------------------------------------------------------
+# Built-in tool references
+# ---------------------------------------------------------------------------
+from fred_sdk.support.builtins import (
+    TOOL_REF_ARTIFACTS_PUBLISH_TEXT,
+    TOOL_REF_GEO_RENDER_POINTS,
+    TOOL_REF_KNOWLEDGE_SEARCH,
+    TOOL_REF_LOGS_QUERY,
+    TOOL_REF_RESOURCES_FETCH_TEXT,
+    TOOL_REF_TRACES_SUMMARIZE_CONVERSATION,
+)
+
+# ---------------------------------------------------------------------------
+# Public surface declaration
+# ---------------------------------------------------------------------------
+__all__ = [
+    # ReAct authoring
+    "ReActAgent",
+    "tool",
+    "ToolContext",
+    "ToolOutput",
+    "UIHints",
+    "ui_field",
+    "prompt_md",
+    "ToolInvocationError",
+    "ModelInvocationError",
+    "ArtifactPublicationError",
+    "ResourceFetchError",
+    "ResourceNotFoundError",
+    "inspect_agent",
+    # MCP server references
+    "MCPServerRef",
+    "MCP_SERVER_KNOWLEDGE_FLOW_CORPUS",
+    "MCP_SERVER_KNOWLEDGE_FLOW_FS",
+    "MCP_SERVER_KNOWLEDGE_FLOW_OPENSEARCH_OPS",
+    "MCP_SERVER_KNOWLEDGE_FLOW_STATISTICS",
+    "MCP_SERVER_KNOWLEDGE_FLOW_TABULAR",
+    # Graph authoring
+    "GraphAgent",
+    "GraphWorkflow",
+    "StepResult",
+    "WorkflowNode",
+    "typed_node",
+    "choice_step",
+    "finalize_step",
+    "intent_router_step",
+    "model_text_step",
+    "structured_model_step",
+    # Team authoring
+    "TeamAgent",
+    "AgentSpec",
+    "TeamInput",
+    "TeamMemberResult",
+    "TeamState",
+    # Shared types authors encounter in node/tool contexts
+    "GraphExecutionOutput",
+    "GraphNodeContext",
+    "GraphNodeResult",
+    "AgentInvocationResult",
+    "ArtifactScope",
+    "PublishedArtifact",
+    "HumanInputRequest",
+    "HumanChoiceOption",
+    # Agent definition metadata and policies (used when subclassing GraphAgent/ReActAgent)
+    "DeepAgentDefinition",
+    "ReActAgentDefinition",
+    "ReActPolicy",
+    "ToolApprovalPolicy",
+    "FieldSpec",
+    "GuardrailDefinition",
+    "ToolRefRequirement",
+    # Request context (language, user, session info visible inside nodes)
+    "RuntimeContext",
+    "ToolContentKind",
+    # Resource helpers
+    "load_agent_prompt_markdown",
+    "load_packaged_markdown",
+    # Built-in tool references
+    "TOOL_REF_ARTIFACTS_PUBLISH_TEXT",
+    "TOOL_REF_GEO_RENDER_POINTS",
+    "TOOL_REF_KNOWLEDGE_SEARCH",
+    "TOOL_REF_LOGS_QUERY",
+    "TOOL_REF_RESOURCES_FETCH_TEXT",
+    "TOOL_REF_TRACES_SUMMARIZE_CONVERSATION",
+]

fred_sdk-0.1.0/fred_sdk/authoring/__init__.py

@@ -0,0 +1,89 @@
+# Copyright Thales 2026
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+"""
+Agent-author-facing v2 authoring surface.
+
+Why this package exists:
+- keep the v2 package root focused on the public facade instead of loose files
+- group the helpers that an agent author reads directly: Python tool authoring,
+  inspection entrypoints, and named MCP server references
+
+Who this package is for:
+- `agent author` means an SDK consumer who defines a new Fred agent, profile,
+  or small Python-authored toolset
+- `Fred developer` means a maintainer of the SDK/runtime itself
+- this package is primarily for the `agent author`
+- Fred developers may read it too, but they should treat it as the public
+  authoring surface, not as the place for runtime internals
+
+How to use it:
+- import `ReActAgent`, `tool`, and related helper types from this package when
+  authoring small v2 agents in Python
+- define tool inputs with normal Python type annotations; `@tool(...)` will
+  usually infer the Pydantic input schema for you from the function signature
+- import `inspect_agent` for non-activating inspection
+- import `MCPServerRef` and `MCP_SERVER_KNOWLEDGE_FLOW_*` constants for
+  author-facing default MCP server declarations
+- if you intentionally want optional Fred-specific shortcuts, access them
+  through `context.helpers` inside a tool
+
+Example:
+- `from fred_sdk.authoring import ReActAgent, tool`
+"""
+
+from .api import (
+    ArtifactPublicationError,
+    ModelInvocationError,
+    ReActAgent,
+    ResourceFetchError,
+    ResourceNotFoundError,
+    ToolContext,
+    ToolInvocationError,
+    ToolOutput,
+    UIHints,
+    prompt_md,
+    tool,
+    ui_field,
+)
+from .inspection import inspect_agent
+from .knowledge_flow_mcp import (
+    MCP_SERVER_KNOWLEDGE_FLOW_CORPUS,
+    MCP_SERVER_KNOWLEDGE_FLOW_FS,
+    MCP_SERVER_KNOWLEDGE_FLOW_OPENSEARCH_OPS,
+    MCP_SERVER_KNOWLEDGE_FLOW_STATISTICS,
+    MCP_SERVER_KNOWLEDGE_FLOW_TABULAR,
+    MCPServerRef,
+)
+
+__all__ = [
+    "ArtifactPublicationError",
+    "MCPServerRef",
+    "ModelInvocationError",
+    "MCP_SERVER_KNOWLEDGE_FLOW_CORPUS",
+    "MCP_SERVER_KNOWLEDGE_FLOW_FS",
+    "MCP_SERVER_KNOWLEDGE_FLOW_OPENSEARCH_OPS",
+    "MCP_SERVER_KNOWLEDGE_FLOW_STATISTICS",
+    "MCP_SERVER_KNOWLEDGE_FLOW_TABULAR",
+    "ReActAgent",
+    "ResourceFetchError",
+    "ResourceNotFoundError",
+    "ToolContext",
+    "ToolInvocationError",
+    "ToolOutput",
+    "UIHints",
+    "inspect_agent",
+    "prompt_md",
+    "tool",
+    "ui_field",
+]