Merge branch 'main' into codex/fix-action-ai-context

Author: stefan-ernst

.github/workflows/go.yml

@@ -91,6 +91,11 @@ jobs:
           go-version-file: go.mod
           cache: true
 
+      - name: Set up Node.js
+        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020  # v4.4.0
+        with:
+          node-version-file: '.nvmrc'
+
       - name: Verify handler annotations parse and produce valid OpenAPI 3.0
         run: make openapi-check
         # Fails when swag can't parse an annotation, or when the resulting

Makefile

@@ -127,16 +127,15 @@ ci: ci-go ci-frontend
 
 # Regenerate the OpenAPI v1 spec from handler annotations.
 # Pipeline: swag emits Swagger 2.0 (JSON) -> openapi-convert produces
-# OpenAPI 3.0 yaml/json -> intermediate Swagger 2.0 file is removed.
-# Only api/openapi.{yaml,json} is committed.
+# OpenAPI 3.0 JSON -> intermediate Swagger 2.0 file is removed.
+# Only api/openapi.json is committed.
 openapi:
 	@echo "Regenerating OpenAPI spec..."
 	@$(SWAG) init -g internal/restapi/v1/doc.go -d ./,internal/restapi --parseInternal -o $(OPENAPI_DIR) --outputTypes json -q
 	@go run ./scripts/openapi-convert -in $(OPENAPI_DIR)/swagger.json \
-		-out-yaml $(OPENAPI_DIR)/openapi.yaml \
 		-out-json $(OPENAPI_DIR)/openapi.json
 	@rm -f $(OPENAPI_DIR)/swagger.json
-	@echo "Spec written to $(OPENAPI_DIR)/openapi.{yaml,json}"
+	@echo "Spec written to $(OPENAPI_DIR)/openapi.json"
 
 # Regenerate the public v2 schemas and shared responses from canonical route
 # request, response, media-type, envelope, and success-status metadata.
@@ -145,13 +144,13 @@ openapi-v2:
 
 # Verify that handler annotations parse cleanly under swag and the generated
 # spec is valid OpenAPI 3.0. Does NOT compare against the committed
-# api/openapi.{json,yaml} — that byte-equality check was a continuous source
+# api/openapi.json — that byte-equality check was a continuous source
 # of host-environment-dependent CI noise (swag's output differed between CI
 # and local in ways we couldn't isolate over multiple cycles).
 #
 # The canonical contract test is core-tests/TestAPIOpenAPIContract, which runs
 # the actual server and validates response shapes against the spec. The
-# committed api/openapi.{json,yaml} is best-effort up-to-date; run
+# committed api/openapi.json is best-effort up-to-date; run
 # `make openapi` locally to refresh it (e.g., before a release).
 #
 # This target writes to a tempdir so it doesn't touch the committed spec.
@@ -164,7 +163,6 @@ openapi-check:
 	@tmpdir=$$(mktemp -d) && trap "rm -rf $$tmpdir" EXIT && \
 		$(SWAG) init -g internal/restapi/v1/doc.go -d ./,internal/restapi --parseInternal -o $$tmpdir --outputTypes json -q && \
 		go run ./scripts/openapi-convert -in $$tmpdir/swagger.json \
-			-out-yaml $$tmpdir/openapi.yaml \
 			-out-json $$tmpdir/openapi.json && \
 		echo "OpenAPI spec generates cleanly and validates as OpenAPI 3.0."
 	@$(MAKE) --no-print-directory openapi-v2-check
@@ -174,6 +172,7 @@ openapi-v2-check:
 	@go run ./scripts/openapi-v2-generate -spec api/openapi-v2.json -check
 	@go run ./scripts/openapi-v2-check -spec api/openapi-v2.json
 	@$(MAKE) --no-print-directory openapi-v2-client-smoke
+	@node scripts/check-frontend-v2-fields.mjs
 
 openapi-v2-client-smoke:
 	@tmpdir=$$(mktemp -d /tmp/windshift-v2-client.XXXXXX) && trap 'rm -rf "$$tmpdir"' EXIT && \
@@ -237,7 +236,7 @@ help:
 	@echo "  make clean          - Clean build artifacts"
 	@echo "  make dev-tools      - Install pinned Go tools used by CI"
 	@echo "  make hooks          - Install git pre-commit hook"
-	@echo "  make openapi        - Regenerate api/openapi.{yaml,json} from handler annotations"
+	@echo "  make openapi        - Regenerate api/openapi.json from handler annotations"
 	@echo "  make openapi-v2     - Regenerate typed v2 schemas from canonical route metadata"
 	@echo "  make openapi-v2-client-smoke - Generate and compile a pinned Go v2 client"
 	@echo "  make openapi-check  - Validate v1 generation and v2 route/spec parity (used by hooks/CI)"

api/agent-studio.openapi.yaml

@@ -363,6 +363,9 @@ paths:
               properties:
                 session_id:
                   type: integer
+                history_after_message_id:
+                  type: integer
+                  description: Start a fresh General-chat context after this durable transcript message.
                 message:
                   type: string
       responses:

api/embed.go

@@ -10,11 +10,6 @@ import _ "embed"
 //go:embed openapi.json
 var SpecJSON []byte
 
-// SpecYAML is the OpenAPI 3.0 spec serialized as YAML.
-//
-//go:embed openapi.yaml
-var SpecYAML []byte
-
 // V2SpecJSON is the canonical dual-mount API v2 contract.
 //
 //go:embed openapi-v2.json