coreason-workspace-env 2.1.0__py3-none-any.whl

coreason_workspace_env-2.1.0.dist-info/METADATA

@@ -0,0 +1,24 @@
+Metadata-Version: 2.4
+Name: coreason-workspace-env
+Version: 2.1.0
+Summary: Scalable, Async, Multi-Tenant LangGraph Platform
+Author-email: "Gowtham A Rao, MD, PhD" <gowtham.rao@coreason.ai>
+License: Prosperity 3.0
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+License-File: NOTICE.txt
+Requires-Dist: fastapi>=0.100
+Requires-Dist: uvicorn>=0.20
+Requires-Dist: asyncpg>=0.29.0
+Requires-Dist: redis>=5.0
+Requires-Dist: pydantic-settings>=2.0
+Requires-Dist: langgraph>=0.0.10
+Requires-Dist: alembic>=1.13.0
+Requires-Dist: psycopg2-binary>=2.9.0
+Requires-Dist: coreason-manifest>=0.98.0
+Dynamic: license-file
+
+# coreason-workspace-env

coreason_workspace_env-2.1.0.dist-info/RECORD

@@ -0,0 +1,88 @@
+coreason_workspace_env-2.1.0.dist-info/licenses/LICENSE.txt,sha256=2ljChaa11gIExihm27c-5kfrTK9lKQd0DXvYa9xTElM,3125
+coreason_workspace_env-2.1.0.dist-info/licenses/NOTICE.txt,sha256=mO4ACx6ABS-8ShYPEwturUuD8MbW707u4pjbEjeWDy4,612
+src/main.py,sha256=NlRN8a5FNhTLc8nP3nxGcZ_Qrkdw2QxH6S7PYPVWxGU,3085
+src/agents/agent_pm/orchestrator.py,sha256=bRyQ-MZAfRGDshOdYRnSWvVgoXQ1O6PZQYd6HJcO_ek,263
+src/agents/agent_pm/tools/__init__.py,sha256=1IggZs86m6HXVJRRQd-M1yaXf1IvqrP1ysLVBl2C_eg,32
+src/agents/agent_validator/orchestrator.py,sha256=3OSOI9qkZRKRCOxD4gzfCLuNDuvQsOL2QcmiWjqnENg,371
+src/agents/backend_pm/orchestrator.py,sha256=lqX2dYUgkgmBeiO3MU2rri9NFVix3cVvYMEepSJumac,267
+src/agents/backend_pm/tools/__init__.py,sha256=1IggZs86m6HXVJRRQd-M1yaXf1IvqrP1ysLVBl2C_eg,32
+src/agents/context_compressor/orchestrator.py,sha256=oXO8Jxc1IwSDEiykaBBevcQU80GI2UIGOt5Cww18KvU,1796
+src/agents/database_architect/orchestrator.py,sha256=MV1YCTNs1RWHc78wWsoree1uPZf0gomOvi3C5udp8M4,283
+src/agents/database_architect/tools/__init__.py,sha256=1IggZs86m6HXVJRRQd-M1yaXf1IvqrP1ysLVBl2C_eg,32
+src/agents/factory_ceo/orchestrator.py,sha256=iHUZe_0Ill-YPCoOwEHvTcVWp5rcbN3G8Cn4YusUvDs,1856
+src/agents/factory_ceo/tools/__init__.py,sha256=1IggZs86m6HXVJRRQd-M1yaXf1IvqrP1ysLVBl2C_eg,32
+src/agents/fastapi_coder/orchestrator.py,sha256=owW2djt2YaEZbEam3q71knpEtIDzYXuHi7M9X9p3FrU,273
+src/agents/fastapi_coder/tools/__init__.py,sha256=1IggZs86m6HXVJRRQd-M1yaXf1IvqrP1ysLVBl2C_eg,32
+src/agents/frontend_pm/orchestrator.py,sha256=tBSjxTiD4B2VteZeNiipGtZoNxDRLTxQs_MSJ87GYNI,269
+src/agents/frontend_pm/tools/__init__.py,sha256=1IggZs86m6HXVJRRQd-M1yaXf1IvqrP1ysLVBl2C_eg,32
+src/agents/knowledge_archivist/__init__.py,sha256=_xWQV-zQb-zF6WFH65UJHIF2w_xUYRd5nkxVgLEy6Yc,13
+src/agents/knowledge_consultant/__init__.py,sha256=_xWQV-zQb-zF6WFH65UJHIF2w_xUYRd5nkxVgLEy6Yc,13
+src/agents/legacy_deconstructor/__init__.py,sha256=_xWQV-zQb-zF6WFH65UJHIF2w_xUYRd5nkxVgLEy6Yc,13
+src/agents/librarian_pm/__init__.py,sha256=_xWQV-zQb-zF6WFH65UJHIF2w_xUYRd5nkxVgLEy6Yc,13
+src/agents/output_sanitizer/orchestrator.py,sha256=_onupCSg2BsyvTulp2ptVSXiyXuHJQkvXO2O1u7HE-4,1735
+src/agents/prompt_engineer/orchestrator.py,sha256=0fmEBMpaoTmHH6f9uj7gOtBlViCSfxae5Au4_SeTecI,277
+src/agents/prompt_engineer/tools/__init__.py,sha256=1IggZs86m6HXVJRRQd-M1yaXf1IvqrP1ysLVBl2C_eg,32
+src/agents/react_coder/orchestrator.py,sha256=GIP4xvStQepxtTJjTfGSyQiKSTlzjlCk2d-_zau2lSc,269
+src/agents/react_coder/tools/__init__.py,sha256=1IggZs86m6HXVJRRQd-M1yaXf1IvqrP1ysLVBl2C_eg,32
+src/agents/ui_designer/orchestrator.py,sha256=2EKYQMAYG56G2gW-1Mp7jhSvuQW6H_Sna2uSEGfZYNM,269
+src/agents/ui_designer/tools/__init__.py,sha256=1IggZs86m6HXVJRRQd-M1yaXf1IvqrP1ysLVBl2C_eg,32
+src/agents/yaml_compiler/orchestrator.py,sha256=SbkimZDby-CL1gSWUu2Zx4_QTfCRdZNF4RLostmPtN4,1986
+src/agents/yaml_compiler/tools/fs_tools.py,sha256=C-1aIp3Yok2MUDGtIzlEuN7Qypl2wBWukqwXE226pVk,763
+src/api/router.py,sha256=xuhPN5qwi8aRPBNrmoc8RnXESymNEHEWrmkyYl8_xqI,943
+src/api/endpoints/agents.py,sha256=3PuPMmYgvKBtfyx4IfRws0R6mSbte4KzpH4PyJCFbjE,1906
+src/api/endpoints/docs.py,sha256=q-WfE4d1qy8SDWDFxXQIfTT2BECVwoHfK_kMT3upyxg,1451
+src/api/endpoints/mcp.py,sha256=_QNR-1EPQCR3kGHulrdT6lqHOpHKEygKOzWzzbKK6Uw,1088
+src/api/endpoints/projects.py,sha256=FWIUXenvvkRcpNQXqgWP4edI6IK9bXl3RKF6pohKWx0,2363
+src/api/streaming/__init__.py,sha256=k8UUxCTVmqY6YLwPkzg9DgcLP4pcVYKh5BpKHEp8TlE,81
+src/api/streaming/agent_progress.py,sha256=wGYp3PeSTJXsfdLXWB10ElYDADOZEIzI5Y4iEcaGfrQ,1408
+src/api/streaming/crdt.py,sha256=wgcTsADDvuaVO18NaKof5mcIkaE7TBvqrPRJsmTQUnI,735
+src/api/streaming/state_sync.py,sha256=J695lI9zxE8riSZVyp-jXOwQU97YZrsU6MGHlZ68024,1145
+src/api/streaming/tty.py,sha256=NZPLrvi9S3RV87f1gLcAO2m-DABBMslquD6akawbWko,451
+src/cli/main.py,sha256=mM6MriMRQ37LjKUG1TNBbuXM-1mfLTnafMnwKSvzaoI,10436
+src/core/config.py,sha256=sAgtYrUlZxx_qVKPFlxlpdbek9RjbL-rruTGPGMOytA,1151
+src/core/db.py,sha256=IIQ1SmD8XUFJejjybgvyysMNvbhDLqumLrYcy8bkZb4,910
+src/core/fsm_decoder.py,sha256=2W8-s2pbFuca7vkRSQJjmaioMpVrb8I0AMUFrku6mPI,2139
+src/core/mcp_client.py,sha256=UC7AqoyIP_Zm-wpca2izvDKNXO6GTOI9CfIyAYSX6EQ,2534
+src/core/mcp_server.py,sha256=O_6hDrzmAhJV-Ys9Cj8Du1wmj7WrYCyJRQ0Fc5s2l1Q,1852
+src/core/queue.py,sha256=EIlwHJ-xwZkcRC4EUW3RcsETIiYZofEf35cQF56FBcE,1454
+src/core/skill_loader.py,sha256=l0QL9oUCzJYwUI8K40L3TdgPSYS6v_LEOiNf8menMEE,4729
+src/core/skill_registry_schema.py,sha256=aN2LhXpg_kFRmKbpiLAr58F586J-WVfGoZMRCnR-SrE,2685
+src/core/ws_backplane.py,sha256=pjYB0mpn8IzqRyIL99WxdSy6RyhzI1MR0mO15sDyLVA,2817
+src/core/schemas/__init__.py,sha256=Tnrbl-8FTc3dp-36f2LURcRWFqeY9918ZF58C-WN4E8,33
+src/core/schemas/epistemic_firewall.py,sha256=4wla8_AL17dl5ZfudZsKCpV8zo_iGLM6b-C41yWI7vA,419
+src/core/schemas/knowledge_receipt.py,sha256=7wrCKwrbgOS_JwFdHDiZPvdwjsY7K_G4evKaNIFtBfw,1500
+src/core/schemas/legacy_ir.py,sha256=W4f5Jw-KlQS2KEUSBu85rduN3ffJ6-xOo5W-k39NP94,1673
+src/core/security/audit.py,sha256=jrJHqT3ej1YXlupkZxECymQJDZSrD6EOrbWtEB1TbRo,3198
+src/core/security/auth.py,sha256=1YwBXSSnOhPkFjxzneB65Hy23JLm_0f8wlKl03NmmIw,1970
+src/core/security/encryption.py,sha256=X1bDPFoy37wUNT0skhHGsdAbALPuMJ5gXmg2zKOqQLM,2383
+src/core/security/proxy_delegation.py,sha256=oETOwXQT77GlVXFWKEoEiblEgsEEaroutdeA7umvv_g,2792
+src/core/security/vault.py,sha256=TPPsPbxnpyC3hKHQF56X-W-z0DgZQ6zb0FTX5Nu2d6o,3137
+src/core/services/__init__.py,sha256=6gSPIuK7L2wICgQMtije8fLOaVKoYsjO0rsf15PrIEQ,791
+src/core/services/agent_service.py,sha256=VPYUM2wJ9MQSgXw8Kix-TMACcUnGdkPMo-U7K1m-ucM,5617
+src/core/services/docs_service.py,sha256=xkIDEFdXMGzrMYu_G098yg9bWb3nIz9-h76A413g0Q8,2707
+src/core/services/health_service.py,sha256=z-DdlqXtxS0JtvpPJJbNzaHKdr-D9RA0gJ-xw09oH6I,2729
+src/core/services/mcp_service.py,sha256=DDG9mUeVVoGhljkc5_dy2ZN68S294RRm4g53KT1CSMQ,2833
+src/core/services/project_service.py,sha256=HFgSxbod4yZcG9CFDTpTlwS_Hj1QbRR1pzRhpOtoUdc,4942
+src/core/skills/__init__.py,sha256=xInXtWfDTUc92ziBgakwHakCG1yZ43sKcMMfdcCe4As,293
+src/core/skills/context_compressor.py,sha256=e799QXLAidrQhtSszxofGTVveE0WrKeZVj6Ezr4lfh4,747
+src/core/skills/escalate_to_human.py,sha256=waVipc5uWhU-qP8980jsYLdb9DNMpa93My-TjcEjO-M,1103
+src/core/skills/output_sanitizer.py,sha256=pn9XCzNhFrfkAvfLDq87mC8tfYB3i43ljb5iaeY1bUw,510
+src/core/tracing/__init__.py,sha256=a10q4vuT8uUXtwsqfFvj92gFeWZEjRpQxNlHoOlFPXQ,165
+src/core/tracing/callbacks.py,sha256=uI_B7I2788-V3ujqYe5gaWeKoMZFkgh8sl2y7ADR7MM,4607
+src/core/tracing/config.py,sha256=5JOqxcd6BhjSFDmj6BAHnCwjXylOz5lUE_n0UPSRVkI,780
+src/core/tracing/langfuse_bridge.py,sha256=pzmgmgt40CUAvEhnmdLHJCQnb09ChJTyhF1rGE9mERI,5699
+src/core/vfs/crdt_sync.py,sha256=Dc6ixVBzicacedYjTX08H34FYZbUaDQKBg-WonfKiHs,2280
+src/core/vfs/git_backend.py,sha256=fy605r4JjIo4AX7lN3xae7v1YPmPqDiYlWmw2txneO0,3308
+src/core/vfs/terminal_tty.py,sha256=5y35M_jL0U3QvEK2NPeKvfkGsFEkNIIY6_7TazkzTGA,1941
+src/mcp/__init__.py,sha256=W6cgctc1LQKaV-ljq3UXxVRDQiMeFCKRo1POBroOVts,44
+src/mcp/server.py,sha256=w8aXhpNBVNsR2ovB4pT_H6MtUv-uWMXRtygPRJGUOUo,9059
+src/mcp/memory_server/__init__.py,sha256=_xWQV-zQb-zF6WFH65UJHIF2w_xUYRd5nkxVgLEy6Yc,13
+src/mcp/memory_server/server.py,sha256=LgdIDzGYEAsT0jHXIDaS0Uqv-TUCb87cfYs-SBu0ARU,5460
+src/sdk/__init__.py,sha256=bI1NrJS449jhCJMQFd_oK-hoYsz_yfKhWe1nk2PH0GM,288
+src/sdk/client.py,sha256=_32HtCNakb511Uj-PRpb8HYpg4-1vTNUJ_rYCuVvBi0,5363
+src/workers/keda_worker.py,sha256=KKyDUS7PdIpoVsONWA3BXPEoLqCivd1e30v-iKcmP0o,1709
+coreason_workspace_env-2.1.0.dist-info/METADATA,sha256=89Icly0J0QndNNZQgJ0_IaAhOR0PZk2z5rfWLkYZo0k,771
+coreason_workspace_env-2.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+coreason_workspace_env-2.1.0.dist-info/entry_points.txt,sha256=zMu9d9OVdfupl6TJ8Nk9E_SAo_nmA64OSU8vZF3dmAw,52
+coreason_workspace_env-2.1.0.dist-info/top_level.txt,sha256=74rtVfumQlgAPzR5_2CgYN24MB0XARCg0t-gzk6gTrM,4
+coreason_workspace_env-2.1.0.dist-info/RECORD,,

coreason_workspace_env-2.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

coreason_workspace_env-2.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+coreason = src.cli.main:cli_entry

coreason_workspace_env-2.1.0.dist-info/licenses/LICENSE.txt

@@ -0,0 +1,57 @@
+# The Prosperity Public License 3.0.0
+
+Contributor: CoReason, Inc.
+
+Source Code: https://github.com/CoReason-AI/coreason-workspace-env
+
+## Purpose
+
+This license allows you to use and share this software for noncommercial purposes for free and to try this software for commercial purposes for thirty days.
+
+## Agreement
+
+In order to receive this license, you have to agree to its rules.  Those rules are both obligations under that agreement and conditions to your license.  Don't do anything with this software that triggers a rule you can't or won't follow.
+
+## Notices
+
+Make sure everyone who gets a copy of any part of this software from you, with or without changes, also gets the text of this license and the contributor and source code lines above.
+
+## Commercial Trial
+
+Limit your use of this software for commercial purposes to a thirty-day trial period.  If you use this software for work, your company gets one trial period for all personnel, not one trial per person.
+
+## Contributions Back
+
+Developing feedback, changes, or additions that you contribute back to the contributor on the terms of a standardized public software license such as [the Blue Oak Model License 1.0.0](https://blueoakcouncil.org/license/1.0.0), [the Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0.html), [the MIT license](https://spdx.org/licenses/MIT.html), or [the two-clause BSD license](https://spdx.org/licenses/BSD-2-Clause.html) doesn't count as use for a commercial purpose.
+
+## Personal Uses
+
+Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, doesn't count as use for a commercial purpose.
+
+## Noncommercial Organizations
+
+Use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization, or government institution doesn't count as use for a commercial purpose regardless of the source of funding or obligations resulting from the funding.
+
+## Defense
+
+Don't make any legal claim against anyone accusing this software, with or without changes, alone or with other technology, of infringing any patent.
+
+## Copyright
+
+The contributor licenses you to do everything with this software that would otherwise infringe their copyright in it.
+
+## Patent
+
+The contributor licenses you to do everything with this software that would otherwise infringe any patents they can license or become able to license.
+
+## Reliability
+
+The contributor can't revoke this license.
+
+## Excuse
+
+You're excused for unknowingly breaking [Notices](#notices) if you take all practical steps to comply within thirty days of learning you broke the rule.
+
+## No Liability
+
+***As far as the law allows, this software comes as is, without any warranty or condition, and the contributor won't be liable to anyone for any damages related to this software or this license, under any kind of legal claim.***

coreason_workspace_env-2.1.0.dist-info/licenses/NOTICE.txt

@@ -0,0 +1,8 @@
+Copyright (c) 2026 CoReason, Inc.. All Rights Reserved
+
+This software is licensed under the Prosperity Public License 3.0.0.
+The issuer of the Prosperity Public License for this software is CoReason, Inc..
+
+For a commercial version of this software, please contact us at gowtham.rao@coreason.ai.
+
+GENESIS COMMIT: Initializing repository coreason_gitops per CoReason Clean Room Protocol PIP-001. This repository is established as an independently created De Novo development environment, commencing on 2026-06-11. I, Akshaya M certify that this date is subsequent to my individual Temporal Firewall Date.

coreason_workspace_env-2.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+src

src/agents/agent_pm/orchestrator.py

@@ -0,0 +1,9 @@
+from deepagents import DeepAgent
+
+class AgentPmAgent(DeepAgent):
+    """
+    Placeholder orchestrator stub for agent_pm.
+    LangGraph execution logic will be implemented here.
+    """
+    def __init__(self, **kwargs):
+        super().__init__(**kwargs)

src/agents/agent_pm/tools/__init__.py

@@ -0,0 +1 @@
+# Placeholder for @tool skills

src/agents/agent_validator/orchestrator.py

@@ -0,0 +1,11 @@
+from deepagents import DeepAgent
+
+
+class AgentValidatorAgent(DeepAgent):
+    """
+    Unified deterministic Checker for the CoReason Agent Factory.
+    Validates all factory artifacts against formal validation standards.
+    Operates as a post-build gate in the Maker-Checker-Approver pipeline.
+    """
+    def __init__(self, **kwargs):
+        super().__init__(**kwargs)

src/agents/backend_pm/orchestrator.py

@@ -0,0 +1,9 @@
+from deepagents import DeepAgent
+
+class BackendPmAgent(DeepAgent):
+    """
+    Placeholder orchestrator stub for backend_pm.
+    LangGraph execution logic will be implemented here.
+    """
+    def __init__(self, **kwargs):
+        super().__init__(**kwargs)

src/agents/backend_pm/tools/__init__.py

@@ -0,0 +1 @@
+# Placeholder for @tool skills

src/agents/context_compressor/orchestrator.py

@@ -0,0 +1,48 @@
+import os
+import yaml
+import logging
+from typing import Dict, Any, List
+from langchain_openai import ChatOpenAI
+
+logger = logging.getLogger(__name__)
+
+class ContextCompressorAgent:
+    """
+    Native DeepAgent Harness for the Context Compressor Sub-Agent.
+    """
+    def __init__(self, model_override: str = None):
+        yaml_path = os.path.join(os.path.dirname(__file__), "agent.yaml")
+        with open(yaml_path, "r", encoding="utf-8") as f:
+            self.agent_spec = yaml.safe_load(f)
+            
+        self.llm = ChatOpenAI(
+            model=model_override or "nvidia/nemotron-3-nano-30b-a3b:free",
+            api_key="sovereign-key-placeholder",
+            temperature=0.1 # Very low temperature for strict factual extraction
+        )
+        
+        self.tools = []
+        logger.info(f"Initialized {self.agent_spec.get('name')}")
+
+    def execute(self, raw_payload: str, compression_goal: str, session_id: str) -> str:
+        """
+        Executes the DeepAgent compression.
+        """
+        try:
+            from deepagents import create_deep_agent
+            
+            graph = create_deep_agent(
+                model=self.llm,
+                tools=self.tools,
+                system_prompt=self.agent_spec.get("system_prompt")
+            )
+            
+            config = {"configurable": {"thread_id": session_id}}
+            result = graph.invoke(
+                {"messages": [("user", f"Goal: {compression_goal}\n\nPayload:\n{raw_payload}")]},
+                config=config
+            )
+            return result['messages'][-1].content
+        except ImportError:
+            logger.warning("deepagents package missing, acting as mock execution.")
+            return f"[COMPRESSED DATA for '{compression_goal}']: ... (High signal data extracted) ..."

src/agents/database_architect/orchestrator.py

@@ -0,0 +1,9 @@
+from deepagents import DeepAgent
+
+class DatabaseArchitectAgent(DeepAgent):
+    """
+    Placeholder orchestrator stub for database_architect.
+    LangGraph execution logic will be implemented here.
+    """
+    def __init__(self, **kwargs):
+        super().__init__(**kwargs)

src/agents/database_architect/tools/__init__.py

@@ -0,0 +1 @@
+# Placeholder for @tool skills

src/agents/factory_ceo/orchestrator.py

@@ -0,0 +1,56 @@
+from typing import Any
+import uuid
+from deepagents import DeepAgent
+
+from coreason_manifest.spec.ontology import (
+    EpistemicQuarantineSnapshot,
+    EpistemicProxyState
+)
+from src.core.schemas.epistemic_firewall import LibrarianRoutingState
+
+
+class FactoryCeoAgent(DeepAgent):
+    """
+    Orchestrator for factory_ceo.
+    """
+    def __init__(self, **kwargs):
+        super().__init__(**kwargs)
+
+from src.core.db import get_db_pool
+
+async def epistemic_interceptor_node(state: dict[str, Any]) -> dict[str, Any]:
+    """
+    LangGraph Node that physically intercepts large raw human transcripts
+    BEFORE they enter the factory_ceo's context window.
+    """
+    raw_payload = state.get("raw_transcript")
+    
+    if raw_payload:
+        snapshot = EpistemicQuarantineSnapshot(
+            snapshot_id=str(uuid.uuid7()),
+            raw_payload=raw_payload
+        )
+        
+        # Persist to WORM Postgres table for enterprise statelessness using global pool
+        try:
+            pool = await get_db_pool()
+            async with pool.acquire() as conn:
+                await conn.execute(
+                    "INSERT INTO epistemic_quarantine_snapshots (snapshot_id, raw_payload) VALUES ($1, $2) ON CONFLICT DO NOTHING",
+                    snapshot.snapshot_id, snapshot.raw_payload
+                )
+        except Exception as e:
+            # WORM persistence is mandatory for security compliance. Fail closed.
+            raise RuntimeError(f"Epistemic Interceptor failed to quarantine transcript: {e}")
+        
+        proxy = EpistemicProxyState(
+            proxy_cid=snapshot.snapshot_id,
+            structural_type="HumanTranscript"
+        )
+        
+        return {
+            "raw_transcript": None,
+            "epistemic_proxy": proxy
+        }
+        
+    return {}

src/agents/factory_ceo/tools/__init__.py

@@ -0,0 +1 @@
+# Placeholder for @tool skills

src/agents/fastapi_coder/orchestrator.py

@@ -0,0 +1,9 @@
+from deepagents import DeepAgent
+
+class FastapiCoderAgent(DeepAgent):
+    """
+    Placeholder orchestrator stub for fastapi_coder.
+    LangGraph execution logic will be implemented here.
+    """
+    def __init__(self, **kwargs):
+        super().__init__(**kwargs)

src/agents/fastapi_coder/tools/__init__.py

@@ -0,0 +1 @@
+# Placeholder for @tool skills

src/agents/frontend_pm/orchestrator.py

@@ -0,0 +1,9 @@
+from deepagents import DeepAgent
+
+class FrontendPmAgent(DeepAgent):
+    """
+    Placeholder orchestrator stub for frontend_pm.
+    LangGraph execution logic will be implemented here.
+    """
+    def __init__(self, **kwargs):
+        super().__init__(**kwargs)

src/agents/frontend_pm/tools/__init__.py

@@ -0,0 +1 @@
+# Placeholder for @tool skills

src/agents/knowledge_archivist/__init__.py

@@ -0,0 +1 @@
+# Empty init

src/agents/knowledge_consultant/__init__.py

@@ -0,0 +1 @@
+# Empty init

src/agents/legacy_deconstructor/__init__.py

@@ -0,0 +1 @@
+# Empty init

src/agents/librarian_pm/__init__.py

@@ -0,0 +1 @@
+# Empty init

src/agents/output_sanitizer/orchestrator.py

@@ -0,0 +1,48 @@
+import os
+import yaml
+import logging
+from typing import Dict, Any, List
+from langchain_openai import ChatOpenAI
+
+logger = logging.getLogger(__name__)
+
+class OutputSanitizerAgent:
+    """
+    Native DeepAgent Harness for the Output Sanitizer Sub-Agent.
+    """
+    def __init__(self, model_override: str = None):
+        yaml_path = os.path.join(os.path.dirname(__file__), "agent.yaml")
+        with open(yaml_path, "r", encoding="utf-8") as f:
+            self.agent_spec = yaml.safe_load(f)
+            
+        self.llm = ChatOpenAI(
+            model=model_override or "nvidia/nemotron-3-nano-30b-a3b:free",
+            api_key="sovereign-key-placeholder",
+            temperature=0.0 # Zero temperature for strict deterministic formatting
+        )
+        
+        self.tools = []
+        logger.info(f"Initialized {self.agent_spec.get('name')}")
+
+    def execute(self, raw_output: str, session_id: str) -> str:
+        """
+        Executes the DeepAgent sanitization.
+        """
+        try:
+            from deepagents import create_deep_agent
+            
+            graph = create_deep_agent(
+                model=self.llm,
+                tools=self.tools,
+                system_prompt=self.agent_spec.get("system_prompt")
+            )
+            
+            config = {"configurable": {"thread_id": session_id}}
+            result = graph.invoke(
+                {"messages": [("user", f"Sanitize and format this output:\n\n{raw_output}")]},
+                config=config
+            )
+            return result['messages'][-1].content
+        except ImportError:
+            logger.warning("deepagents package missing, acting as mock execution.")
+            return "| Key | Value |\n|---|---|\n| Status | Cleaned |"

src/agents/prompt_engineer/orchestrator.py

@@ -0,0 +1,9 @@
+from deepagents import DeepAgent
+
+class PromptEngineerAgent(DeepAgent):
+    """
+    Placeholder orchestrator stub for prompt_engineer.
+    LangGraph execution logic will be implemented here.
+    """
+    def __init__(self, **kwargs):
+        super().__init__(**kwargs)

src/agents/prompt_engineer/tools/__init__.py

@@ -0,0 +1 @@
+# Placeholder for @tool skills

src/agents/react_coder/orchestrator.py

@@ -0,0 +1,9 @@
+from deepagents import DeepAgent
+
+class ReactCoderAgent(DeepAgent):
+    """
+    Placeholder orchestrator stub for react_coder.
+    LangGraph execution logic will be implemented here.
+    """
+    def __init__(self, **kwargs):
+        super().__init__(**kwargs)

src/agents/react_coder/tools/__init__.py

@@ -0,0 +1 @@
+# Placeholder for @tool skills

src/agents/ui_designer/orchestrator.py

@@ -0,0 +1,9 @@
+from deepagents import DeepAgent
+
+class UiDesignerAgent(DeepAgent):
+    """
+    Placeholder orchestrator stub for ui_designer.
+    LangGraph execution logic will be implemented here.
+    """
+    def __init__(self, **kwargs):
+        super().__init__(**kwargs)

src/agents/ui_designer/tools/__init__.py

@@ -0,0 +1 @@
+# Placeholder for @tool skills

src/agents/yaml_compiler/orchestrator.py

@@ -0,0 +1,52 @@
+import os
+import yaml
+import logging
+from typing import Dict, Any, List
+from langchain_openai import ChatOpenAI
+from .tools.fs_tools import local_fs_writer, local_fs_reader
+
+logger = logging.getLogger(__name__)
+
+class YAMLCompilerAgent:
+    """
+    Native DeepAgent Harness for the deterministic YAML Compiler.
+    Accepts the fully saturated context and scaffolds the project files.
+    """
+    def __init__(self, model_override: str = None):
+        # Updated to point to the encapsulated agent.yaml
+        yaml_path = os.path.join(os.path.dirname(__file__), "agent.yaml")
+        with open(yaml_path, "r", encoding="utf-8") as f:
+            self.agent_spec = yaml.safe_load(f)
+            
+        self.llm = ChatOpenAI(
+            model=model_override or "nvidia/nemotron-3-nano-30b-a3b:free",
+            api_key="sovereign-key-placeholder",
+            temperature=0.0
+        )
+        
+        # Bound to encapsulated tools
+        self.tools = [local_fs_writer, local_fs_reader]
+        logger.info(f"Initialized {self.agent_spec.get('name')}")
+
+    def execute(self, saturated_context: str, session_id: str) -> str:
+        """
+        Executes the DeepAgent compilation dynamically via LangGraph.
+        """
+        try:
+            from deepagents import create_deep_agent
+            
+            graph = create_deep_agent(
+                model=self.llm,
+                tools=self.tools,
+                system_prompt=self.agent_spec.get("system_prompt")
+            )
+            
+            config = {"configurable": {"thread_id": session_id}}
+            result = graph.invoke(
+                {"messages": [("user", f"Compile these requirements: {saturated_context}")]},
+                config=config
+            )
+            return result['messages'][-1].content
+        except ImportError:
+            logger.warning("deepagents package missing, acting as mock execution.")
+            return "MOCK_SUCCESS: Compiled project.yaml and orchestrator_agent.yaml"

src/agents/yaml_compiler/tools/fs_tools.py

@@ -0,0 +1,22 @@
+import os
+from langchain_core.tools import tool
+
+@tool
+def local_fs_writer(filepath: str, content: str) -> str:
+    """Writes the content string to the exact filepath on the local filesystem."""
+    try:
+        os.makedirs(os.path.dirname(filepath), exist_ok=True)
+        with open(filepath, "w", encoding="utf-8") as f:
+            f.write(content)
+        return f"Successfully wrote to {filepath}"
+    except Exception as e:
+        return f"Error writing to file: {str(e)}"
+
+@tool
+def local_fs_reader(filepath: str) -> str:
+    """Reads the content of a file from the local filesystem."""
+    try:
+        with open(filepath, "r", encoding="utf-8") as f:
+            return f.read()
+    except Exception as e:
+        return f"Error reading file: {str(e)}"

src/api/endpoints/agents.py

@@ -0,0 +1,59 @@
+"""
+REST API — Agents endpoints.
+Thin adapter over src.core.services.agent_service.
+"""
+from typing import Optional
+
+from fastapi import APIRouter, HTTPException
+from pydantic import BaseModel, Field
+
+from src.core.services import agent_service
+
+router = APIRouter()
+
+
+class ExecuteAgentRequest(BaseModel):
+    agent_name: str = Field(..., description="Name of the agent to execute")
+    user_id: str = Field(..., description="User ID for tenant isolation")
+    tenant_id: str = Field(..., description="Tenant ID for sandbox isolation")
+    payload: dict = Field(default_factory=dict, description="Context payload for the agent")
+    session_id: Optional[str] = Field(None, description="Optional session/job ID")
+
+
+@router.get("/")
+async def list_agents():
+    """List all agents across projects."""
+    agents = agent_service.list_agents()
+    return {"agents": agents}
+
+
+@router.get("/{agent_name}")
+async def get_agent(agent_name: str):
+    """Get a specific agent's manifest and metadata."""
+    agent = agent_service.get_agent(agent_name)
+    if not agent:
+        raise HTTPException(status_code=404, detail=f"Agent '{agent_name}' not found")
+    return {"agent": agent}
+
+
+@router.post("/execute")
+async def execute_agent(req: ExecuteAgentRequest):
+    """Trigger a LangGraph execution flow for the specified agent."""
+    agent = agent_service.get_agent(req.agent_name)
+    if not agent:
+        raise HTTPException(status_code=404, detail=f"Agent '{req.agent_name}' not found")
+
+    result = await agent_service.execute_agent(
+        agent_name=req.agent_name,
+        payload=req.payload,
+        user_id=req.user_id,
+        tenant_id=req.tenant_id,
+        session_id=req.session_id,
+    )
+    return result
+
+
+@router.get("/jobs/{job_id}")
+async def get_job_status(job_id: str):
+    """Check the status of an enqueued agent execution."""
+    return agent_service.get_execution_status(job_id)