Skip to content

[agentserver-responses] create azure-ai-agentserver-responses package #45755

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
lusu-msft wants to merge 17 commits into
base: main
Choose a base branch
from
+35,894 −0
Draft

[agentserver-responses] create azure-ai-agentserver-responses package #45755

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
5da12d4
create starlette package (#45754)
lusu-msft Mar 17, 2026
57c63a3
Lusu/response 0317 (#45757)
lusu-msft Mar 17, 2026
df45208
Lusu/response 0317 rename (#45764)
lusu-msft Mar 18, 2026
3d93cf2
response server apis (#45807)
lusu-msft Mar 19, 2026
682afbc
remove old path
lusu-msft Mar 19, 2026
11f7747
add samples
lusu-msft Mar 19, 2026
9d03cf8
update pyproject
lusu-msft Mar 19, 2026
e040678
refining host
lusu-msft Mar 20, 2026
89e351e
refined builders and hosting
lusu-msft Mar 20, 2026
f8c8cec
refined package structur
lusu-msft Mar 20, 2026
ee6ee6b
remove unused code
lusu-msft Mar 20, 2026
d787997
add keep alive
lusu-msft Mar 20, 2026
8559738
fix minors
lusu-msft Mar 20, 2026
6b0bf7c
fix pytests
lusu-msft Mar 20, 2026
490a8ef
add file headers
lusu-msft Mar 20, 2026
d4c2800
add docstring for hosting
lusu-msft Mar 20, 2026
b4b290c
add conftest
lusu-msft Mar 20, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
152 changes: 152 additions & 0 deletions sdk/agentserver/azure-ai-agentserver-responses/Makefile
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,152 @@
# Python TypeSpec Code Generation Tooling
# Targets: generate-models, clean, install-typespec-deps

OUTPUT_DIR ?= azure/ai/agentserver/responses/models/_generated
TYPESPEC_DIR ?= type_spec
OPENAPI_SPEC ?= type_spec/TempTypeSpecFiles/Foundry/openapi3/v1/microsoft-foundry-openapi3.yaml
VALIDATORS_OUTPUT ?= $(OUTPUT_DIR)/_validators.py
ROOT_SCHEMAS ?= CreateResponse
LOCAL_TYPESPEC_PACKAGES := @typespec/compiler @typespec/http @typespec/openapi @typespec/openapi3 @typespec/versioning @typespec/events @typespec/sse @azure-tools/typespec-python @azure-tools/typespec-azure-core @azure-tools/typespec-client-generator-core @azure-tools/openai-typespec
TEMP_OUTPUT_DIR := $(OUTPUT_DIR)/.tmp_codegen
MODEL_PACKAGE_DIR := $(TEMP_OUTPUT_DIR)/azure/ai/agentserver/responses/sdk/models
MODEL_SHIMS_DIR := scripts/generated_shims

.PHONY: generate-models generate-validators generate-contracts clean install-typespec-deps

ifeq ($(OS),Windows_NT)
SHELL := cmd
.SHELLFLAGS := /c
endif

# --------------------------------------------------------------------------
# generate-validators: Generate JSON payload validators from OpenAPI
# --------------------------------------------------------------------------
ifeq ($(OS),Windows_NT)
generate-validators:
@where python >NUL 2>NUL || (echo Error: python is required and was not found on PATH. 1>&2 && exit /b 1)
@if not exist "$(OPENAPI_SPEC)" (echo Error: OpenAPI spec not found at $(OPENAPI_SPEC). 1>&2 && exit /b 1)
@echo Generating payload validators from $(OPENAPI_SPEC)...
python scripts/generate_validators.py --input "$(OPENAPI_SPEC)" --output "$(VALIDATORS_OUTPUT)" --root-schemas "$(ROOT_SCHEMAS)"
@echo Generated validators at $(VALIDATORS_OUTPUT)
else
generate-validators:
@command -v python >/dev/null 2>&1 || { \
echo "Error: python is required and was not found on PATH." >&2; \
exit 1; \
}
@test -f "$(OPENAPI_SPEC)" || { \
echo "Error: OpenAPI spec not found at $(OPENAPI_SPEC)." >&2; \
exit 1; \
}
@echo "Generating payload validators from $(OPENAPI_SPEC)..."
python scripts/generate_validators.py --input "$(OPENAPI_SPEC)" --output "$(VALIDATORS_OUTPUT)" --root-schemas "$(ROOT_SCHEMAS)"
@echo "Generated validators at $(VALIDATORS_OUTPUT)"
endif

# --------------------------------------------------------------------------
# generate-contracts: Generate models + validators artifacts
# --------------------------------------------------------------------------
generate-contracts: generate-models generate-validators

TYPESPEC_OUTPUT_DIR := {cwd}/../$(TEMP_OUTPUT_DIR)

# --------------------------------------------------------------------------
# generate-models: Compile TypeSpec definitions into Python model classes
# --------------------------------------------------------------------------
ifeq ($(OS),Windows_NT)
generate-models:
@where tsp-client >NUL 2>NUL || (echo Error: tsp-client is not installed. 1>&2 && echo Run 'make install-typespec-deps' to install it. 1>&2 && exit /b 1)
@where npm >NUL 2>NUL || (echo Error: npm is required. Install Node.js ^(v18+^) from https://nodejs.org/ 1>&2 && exit /b 1)
@echo Syncing upstream TypeSpec sources...
cd /d $(TYPESPEC_DIR) && tsp-client sync
@echo Installing local TypeSpec compiler dependencies...
npm install --prefix $(TYPESPEC_DIR) --no-save $(LOCAL_TYPESPEC_PACKAGES)
@echo Generating Python models...
@if exist "$(OUTPUT_DIR)" rmdir /s /q "$(OUTPUT_DIR)"
cd /d $(TYPESPEC_DIR) && npx tsp compile . --emit @azure-tools/typespec-python --option "@azure-tools/typespec-python.emitter-output-dir=$(TYPESPEC_OUTPUT_DIR)"
@if not exist "$(MODEL_PACKAGE_DIR)" (echo Error: generated model package was not found. 1>&2 && exit /b 1)
@if not exist "$(OUTPUT_DIR)\sdk" mkdir "$(OUTPUT_DIR)\sdk"
@xcopy /E /I /Y "$(MODEL_PACKAGE_DIR)" "$(OUTPUT_DIR)\sdk\models" >NUL
@if exist "$(OUTPUT_DIR)\sdk\models\aio" rmdir /s /q "$(OUTPUT_DIR)\sdk\models\aio"
@if exist "$(OUTPUT_DIR)\sdk\models\operations" rmdir /s /q "$(OUTPUT_DIR)\sdk\models\operations"
@if exist "$(OUTPUT_DIR)\sdk\models\_client.py" del /q "$(OUTPUT_DIR)\sdk\models\_client.py"
@if exist "$(OUTPUT_DIR)\sdk\models\_configuration.py" del /q "$(OUTPUT_DIR)\sdk\models\_configuration.py"
@if exist "$(OUTPUT_DIR)\sdk\models\_version.py" del /q "$(OUTPUT_DIR)\sdk\models\_version.py"
@copy /Y "$(MODEL_SHIMS_DIR)\sdk_models__init__.py" "$(OUTPUT_DIR)\sdk\models\__init__.py" >NUL
@copy /Y "$(MODEL_SHIMS_DIR)\__init__.py" "$(OUTPUT_DIR)\__init__.py" >NUL
@copy /Y "$(MODEL_SHIMS_DIR)\_enums.py" "$(OUTPUT_DIR)\_enums.py" >NUL
@copy /Y "$(MODEL_SHIMS_DIR)\_models.py" "$(OUTPUT_DIR)\_models.py" >NUL
@copy /Y "$(MODEL_SHIMS_DIR)\_patch.py" "$(OUTPUT_DIR)\_patch.py" >NUL
@if exist "$(TEMP_OUTPUT_DIR)" rmdir /s /q "$(TEMP_OUTPUT_DIR)"
else
generate-models:
@command -v tsp-client >/dev/null 2>&1 || { \
echo "Error: tsp-client is not installed." >&2; \
echo "Run 'make install-typespec-deps' to install it." >&2; \
exit 1; \
}
@command -v npm >/dev/null 2>&1 || { \
echo "Error: npm is required. Install Node.js (v18+) from https://nodejs.org/" >&2; \
exit 1; \
}
@echo "Syncing upstream TypeSpec sources..."
cd $(TYPESPEC_DIR) && tsp-client sync
@echo "Installing local TypeSpec compiler dependencies..."
npm install --prefix $(TYPESPEC_DIR) --no-save $(LOCAL_TYPESPEC_PACKAGES)
@echo "Generating Python models..."
rm -rf $(OUTPUT_DIR)
cd $(TYPESPEC_DIR) && npx tsp compile . --emit @azure-tools/typespec-python --option "@azure-tools/typespec-python.emitter-output-dir=$(TYPESPEC_OUTPUT_DIR)"
@test -d $(MODEL_PACKAGE_DIR) || { \
echo "Error: generated model package was not found." >&2; \
exit 1; \
}
mkdir -p $(OUTPUT_DIR)/sdk
cp -R $(MODEL_PACKAGE_DIR) $(OUTPUT_DIR)/sdk/models
rm -rf $(OUTPUT_DIR)/sdk/models/aio
rm -rf $(OUTPUT_DIR)/sdk/models/operations
rm -f $(OUTPUT_DIR)/sdk/models/_client.py
rm -f $(OUTPUT_DIR)/sdk/models/_configuration.py
rm -f $(OUTPUT_DIR)/sdk/models/_version.py
cp $(MODEL_SHIMS_DIR)/sdk_models__init__.py $(OUTPUT_DIR)/sdk/models/__init__.py
cp $(MODEL_SHIMS_DIR)/__init__.py $(OUTPUT_DIR)/__init__.py
cp $(MODEL_SHIMS_DIR)/_enums.py $(OUTPUT_DIR)/_enums.py
cp $(MODEL_SHIMS_DIR)/_models.py $(OUTPUT_DIR)/_models.py
cp $(MODEL_SHIMS_DIR)/_patch.py $(OUTPUT_DIR)/_patch.py
rm -rf $(TEMP_OUTPUT_DIR)
endif

# --------------------------------------------------------------------------
# clean: Remove all previously generated Python model files
# --------------------------------------------------------------------------
ifeq ($(OS),Windows_NT)
clean:
@if exist "$(OUTPUT_DIR)" rmdir /s /q "$(OUTPUT_DIR)"
else
clean:
rm -rf $(OUTPUT_DIR)
endif

# --------------------------------------------------------------------------
# install-typespec-deps: Install tsp-client CLI and sync TypeSpec sources
# --------------------------------------------------------------------------
ifeq ($(OS),Windows_NT)
install-typespec-deps:
@where node >NUL 2>NUL || (echo Error: Node.js ^(v18+^) is required. Install from https://nodejs.org/ 1>&2 && exit /b 1)
@where npm >NUL 2>NUL || (echo Error: npm is required. Install Node.js ^(v18+^) from https://nodejs.org/ 1>&2 && exit /b 1)
npm install -g @azure-tools/typespec-client-generator-cli
npm install --prefix $(TYPESPEC_DIR) --no-save $(LOCAL_TYPESPEC_PACKAGES)
cd /d $(TYPESPEC_DIR) && tsp-client sync
else
install-typespec-deps:
@command -v node >/dev/null 2>&1 || { \
echo "Error: Node.js (v18+) is required. Install from https://nodejs.org/" >&2; \
exit 1; \
}
@command -v npm >/dev/null 2>&1 || { \
echo "Error: npm is required. Install Node.js (v18+) from https://nodejs.org/" >&2; \
exit 1; \
}
npm install -g @azure-tools/typespec-client-generator-cli
npm install --prefix $(TYPESPEC_DIR) --no-save $(LOCAL_TYPESPEC_PACKAGES)
cd $(TYPESPEC_DIR) && tsp-client sync
endif
Loading
Loading