chore: Align server-ai examples with EXAM-SDK-example spec (#1379)

Author: jsonbailey

.github/workflows/server-ai.yml

@@ -25,18 +25,14 @@ jobs:
         with:
           workspace_name: '@launchdarkly/server-sdk-ai'
           workspace_path: packages/sdk/server-ai
-      - name: Build bedrock example
+      - name: Type-check all server-ai examples
         run: |
-          yarn workspaces focus @launchdarkly/hello-ai-bedrock
-          yarn workspace @launchdarkly/hello-ai-bedrock lint
-          yarn workspaces foreach -pR --topological-dev --from '@launchdarkly/hello-ai-bedrock' run build
-      - name: Build OpenAI example
-        run: |
-          yarn workspaces focus @launchdarkly/hello-openai
-          yarn workspace @launchdarkly/hello-openai lint
-          yarn workspaces foreach -pR --topological-dev --from '@launchdarkly/hello-openai' run build
-      - name: Build Vercel AI example
-        run: |
-          yarn workspaces focus @launchdarkly/hello-vercel-ai
-          yarn workspace @launchdarkly/hello-vercel-ai lint
-          yarn workspaces foreach -pR --topological-dev --from '@launchdarkly/hello-vercel-ai' run build
+          set -e
+          for dir in packages/sdk/server-ai/examples/getting-started/*/*/ packages/sdk/server-ai/examples/features/*/; do
+            name=$(node -p "require('./$dir/package.json').name")
+            echo "::group::Type-checking $name ($dir)"
+            yarn workspaces focus "$name"
+            yarn workspaces foreach -A -pR --topological-dev --from "{$name,@launchdarkly/node-server-sdk-otel}" run build
+            (cd "$dir" && npx tsc --noEmit)
+            echo "::endgroup::"
+          done

package.json

@@ -45,16 +45,13 @@
     "packages/sdk/browser",
     "packages/sdk/browser/contract-tests/entity",
     "packages/sdk/server-ai",
-    "packages/sdk/server-ai/examples/bedrock",
-    "packages/sdk/server-ai/examples/chat-judge",
-    "packages/sdk/server-ai/examples/direct-judge",
-    "packages/sdk/server-ai/examples/openai",
-    "packages/sdk/server-ai/examples/managed-agent",
-    "packages/sdk/server-ai/examples/tracked-chat",
-    "packages/sdk/server-ai/examples/chat-observability",
-    "packages/sdk/server-ai/examples/openai-observability",
-    "packages/sdk/server-ai/examples/vercel-ai",
-    "packages/sdk/server-ai/examples/agent-graph-traversal",
+    "packages/sdk/server-ai/examples/getting-started/openai/chat-completions",
+    "packages/sdk/server-ai/examples/getting-started/bedrock/converse",
+    "packages/sdk/server-ai/examples/getting-started/vercel-ai/generate-text",
+    "packages/sdk/server-ai/examples/features/create-model",
+    "packages/sdk/server-ai/examples/features/create-agent",
+    "packages/sdk/server-ai/examples/features/create-agent-graph",
+    "packages/sdk/server-ai/examples/features/create-judge",
     "packages/sdk/combined-browser",
     "packages/sdk/shopify-oxygen",
     "packages/sdk/shopify-oxygen/contract-tests",

packages/sdk/server-ai/examples/README.md

@@ -0,0 +1,33 @@
+# LaunchDarkly AI SDK for JavaScript - Examples
+
+| Package | npm | Docs |
+| --- | --- | --- |
+| [@launchdarkly/server-sdk-ai](https://github.com/launchdarkly/js-core/tree/main/packages/sdk/server-ai) | [![npm](https://img.shields.io/npm/v/@launchdarkly/server-sdk-ai)](https://www.npmjs.com/package/@launchdarkly/server-sdk-ai) | [Reference](https://docs.launchdarkly.com/sdk/ai/nodejs) |
+| [@launchdarkly/server-sdk-ai-openai](https://github.com/launchdarkly/js-core/tree/main/packages/ai-providers/server-ai-openai) | [![npm](https://img.shields.io/npm/v/@launchdarkly/server-sdk-ai-openai)](https://www.npmjs.com/package/@launchdarkly/server-sdk-ai-openai) | [Reference](https://docs.launchdarkly.com/sdk/ai/nodejs) |
+| [@launchdarkly/server-sdk-ai-vercel](https://github.com/launchdarkly/js-core/tree/main/packages/ai-providers/server-ai-vercel) | [![npm](https://img.shields.io/npm/v/@launchdarkly/server-sdk-ai-vercel)](https://www.npmjs.com/package/@launchdarkly/server-sdk-ai-vercel) | [Reference](https://docs.launchdarkly.com/sdk/ai/nodejs) |
+| [@launchdarkly/observability-node](https://www.npmjs.com/package/@launchdarkly/observability-node) | [![npm](https://img.shields.io/npm/v/@launchdarkly/observability-node)](https://www.npmjs.com/package/@launchdarkly/observability-node) | [Reference](https://docs.launchdarkly.com/sdk/observability/nodejs) |
+
+Each example is a self-contained application you can run independently to explore LaunchDarkly's AI APIs hands-on. Pick one that matches your provider or use case, follow the README, and you'll be up and running in minutes.
+
+For more comprehensive instructions, visit the [Quickstart page](https://docs.launchdarkly.com/home/ai-configs/quickstart) or the [Node.js reference guide](https://docs.launchdarkly.com/sdk/ai/nodejs).
+
+## Getting Started
+
+These examples show how to integrate LaunchDarkly AI with different providers.
+
+| Provider | Example | Description |
+| --- | --- | --- |
+| Bedrock | [Converse](getting-started/bedrock/converse/) | `completionConfig` with AWS Bedrock Converse API, metrics tracking |
+| OpenAI | [Chat Completions](getting-started/openai/chat-completions/) | `completionConfig` with OpenAI, automatic metrics tracking |
+| Vercel AI | [generateText](getting-started/vercel-ai/generate-text/) | `completionConfig` with the Vercel AI SDK, metrics tracking |
+
+## Features
+
+These examples demonstrate LaunchDarkly's managed APIs and standalone capabilities.
+
+| Example | Description |
+| --- | --- |
+| [createModel](features/create-model/) | Managed chat, automatic metrics tracking, and judge evaluation |
+| [createAgent](features/create-agent/) | Managed agent, automatic metrics tracking, and judge evaluation |
+| [createAgentGraph](features/create-agent-graph/) | Multi-node agent graph traversal and tracking |
+| [createJudge](features/create-judge/) | Standalone evaluation of AI responses |