diff --git a/README.md b/README.md index a852afc..20efda5 100644 --- a/README.md +++ b/README.md @@ -124,7 +124,7 @@ The complete runtime container view — services, databases, queues, and their c 2. Choose your SDK: [Python](https://github.com/AxmeAI/axme-sdk-python) · [TypeScript](https://github.com/AxmeAI/axme-sdk-typescript) · [Go](https://github.com/AxmeAI/axme-sdk-go) · [Java](https://github.com/AxmeAI/axme-sdk-java) · [.NET](https://github.com/AxmeAI/axme-sdk-dotnet) 3. Follow `docs/integration-quickstart.md` for the full onboarding path 4. Example hubs: - - Cloud runnable: [axme-examples/cloud](https://github.com/AxmeAI/axme-examples/tree/main/cloud) + - Cloud runnable: [axme-examples/examples](https://github.com/AxmeAI/axme-examples/tree/main/examples) - Protocol-only: [axme-examples/protocol](https://github.com/AxmeAI/axme-examples/tree/main/protocol) ```bash diff --git a/docs/diagrams/platform/02-container-runtime-c4.png b/docs/diagrams/platform/02-container-runtime-c4.png index adc962e..e94a746 100644 Binary files a/docs/diagrams/platform/02-container-runtime-c4.png and b/docs/diagrams/platform/02-container-runtime-c4.png differ diff --git a/docs/diagrams/platform/02-container-runtime-c4.svg b/docs/diagrams/platform/02-container-runtime-c4.svg index 997c61e..a0bf53b 100644 --- a/docs/diagrams/platform/02-container-runtime-c4.svg +++ b/docs/diagrams/platform/02-container-runtime-c4.svg @@ -1 +1 @@ -Recipient AgentPostgreSQLWorker(Pub/Sub + Cloud Tasks)Agent-Core(Workflow DAG)Auth Service(JWT, OTP)Gateway API(FastAPI, async)MCP Server(AI Assistants)Client/SDKRecipient AgentPostgreSQLWorker(Pub/Sub + Cloud Tasks)Agent-Core(Workflow DAG)Auth Service(JWT, OTP)Gateway API(FastAPI, async)MCP Server(AI Assistants)Client/SDKMCP path (AI assistants via JSON-RPC)Direct API path (SDK/CLI)Async pipeline (Pub/Sub + Cloud Tasks)proxy tool call -> REST API1JSON response -> MCP result2API request3validate x-api-key + Bearer token4auth result5write intent + audit envelope6start or continue workflow7deliver step/intent (SSE/http/poll)8callback/progress9persist state + events10publish intent.created (Pub/Sub)11lifecycle events12persist step state13Cloud Tasks: timeout + reminder jobs14tick due run (scheduled wakeup)15latest status16response/read model17 \ No newline at end of file +Recipient AgentPostgreSQLWorker(Pub/Sub + Cloud Tasks)Agent-Core(Workflow DAG)Auth Service(JWT, OTP)Gateway API(FastAPI, async)MCP Server(AI Assistants)Client/SDKRecipient AgentPostgreSQLWorker(Pub/Sub + Cloud Tasks)Agent-Core(Workflow DAG)Auth Service(JWT, OTP)Gateway API(FastAPI, async)MCP Server(AI Assistants)Client/SDKMCP path (AI assistants via JSON-RPC)Direct API path (SDK/CLI)Async pipeline (Pub/Sub + Cloud Tasks)proxy tool call -> REST API1JSON response -> MCP result2API request3validate x-api-key + Bearer token4auth result5write intent + audit envelope6start or continue workflow7deliver step/intent (SSE/http/poll)8callback/progress9persist state + events10publish intent.created (Pub/Sub)11lifecycle events12persist step state13Cloud Tasks: timeout + reminder jobs14tick due run (scheduled wakeup)15latest status16response/read model17 \ No newline at end of file diff --git a/docs/enterprise-runtime-model-and-placement.md b/docs/enterprise-runtime-model-and-placement.md index c3ce373..40607e4 100644 --- a/docs/enterprise-runtime-model-and-placement.md +++ b/docs/enterprise-runtime-model-and-placement.md @@ -140,4 +140,4 @@ Temporary compatibility behavior: - `docs/public-api-families-d6-enterprise-governance.md` - `docs/enterprise-scoped-credentials-migration-note.md` - `docs/openapi/gateway.track-f-sprint1.v1.json` -- `axp-spec/schemas/public_api/` +- `axme-spec/schemas/public_api/` diff --git a/docs/public-api-families-d6-enterprise-governance.md b/docs/public-api-families-d6-enterprise-governance.md index c305216..8dcaa71 100644 --- a/docs/public-api-families-d6-enterprise-governance.md +++ b/docs/public-api-families-d6-enterprise-governance.md @@ -30,8 +30,8 @@ Use this guide with: - `docs/openapi/gateway.v1.json` (current canonical public operation surface) - `docs/openapi/gateway.track-f-sprint1.v1.json` (historical phased snapshot) -- `axp-spec/schemas/public_api/*.json` (canonical schema contracts; current repository path remains `axme-spec` during transition) -- `axp-spec/docs/public-api-schema-index.md` (schema-to-operation mapping; current repository path remains `axme-spec` during transition) +- `axme-spec/schemas/public_api/*.json` (canonical schema contracts; current repository path remains `axme-spec` during transition) +- `axme-spec/docs/public-api-schema-index.md` (schema-to-operation mapping; current repository path remains `axme-spec` during transition) - `docs/public-api-auth.md` - `docs/supported-limits-and-error-model.md` - `docs/enterprise-runtime-model-and-placement.md` @@ -126,8 +126,8 @@ Enterprise operation groups currently published on `gateway.v1.json`: Canonical schema files for these families are published in: -- `axp-spec/schemas/public_api/` (current repository path remains `axme-spec` during transition) -- `axp-spec/docs/public-api-schema-index.md` (authoritative mapping by operation; current repository path remains `axme-spec` during transition) +- `axme-spec/schemas/public_api/` (current repository path remains `axme-spec` during transition) +- `axme-spec/docs/public-api-schema-index.md` (authoritative mapping by operation; current repository path remains `axme-spec` during transition) Primary schema groups in this batch: @@ -153,7 +153,7 @@ Schema disposition notes: - `POST /v1/usage/rollups/daily`, `GET /v1/portal/enterprise/*`, and `GET /v1/portal/personal/*` are currently OpenAPI-exposed operational surfaces. - `GET /v1/deliveries-operations` and `POST /v1/deliveries/reconcile` are currently OpenAPI-exposed delivery operations surfaces. -- As of this snapshot, there are no dedicated `axp-spec/schemas/public_api/api.usage.rollups.daily.*`, `api.portal.enterprise.*`, `api.portal.personal.*`, or `api.deliveries.operations.*` files. +- As of this snapshot, there are no dedicated `axme-spec/schemas/public_api/api.usage.rollups.daily.*`, `api.portal.enterprise.*`, `api.portal.personal.*`, or `api.deliveries.operations.*` files. - These surfaces require explicit disposition in parity tracking: - either add canonical `public_api` schema artifacts, - or document them as gateway-operational endpoints outside canonical `public_api` family scope.