Merge branch 'main' into copilot/update-ai-chat-api-protocol

Author: hotlong

CHANGELOG.md

@@ -7,6 +7,35 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+- **Discovery Schema — `ServiceStatus` enum & `handlerReady` field** — Added `'registered'`
+  status to `ServiceInfoSchema` to distinguish routes that are declared in the dispatcher
+  table but whose HTTP handler has not been verified. Added optional `handlerReady` boolean
+  field (omitted = unverified/unknown) so clients can filter handler-ready services before
+  displaying endpoints when the value is explicitly `true`.
+- **Discovery Schema — `RouteHealthReportSchema`** — New schema for automated route/handler
+  coverage reporting at startup. Includes per-route health entries (`pass`, `fail`, `missing`,
+  `skip`) and summary counters.
+- **Dispatcher Schema — `DispatcherErrorCode` & `DispatcherErrorResponseSchema`** — Semantic
+  error codes (`404`/`405`/`501`/`503`) with machine-readable `type` field
+  (`ROUTE_NOT_FOUND`, `METHOD_NOT_ALLOWED`, `NOT_IMPLEMENTED`, `SERVICE_UNAVAILABLE`) and
+  developer-facing `hint` strings.
+- **Dispatcher Schema — `/health` route** — Added health endpoint to `DEFAULT_DISPATCHER_ROUTES`.
+- **REST API Plugin — `handlerStatus` field** — Added `handlerStatus` (`implemented`, `stub`,
+  `planned`) to `RestApiEndpointSchema` to track handler implementation readiness.
+- **REST API Plugin — `RouteCoverageReportSchema`** — Schema for adapter-generated coverage
+  reports listing every declared endpoint and its implementation status.
+- `ai` v6 as a dependency of `@objectstack/spec` for type re-exports
+
+### Removed
+- **Removed `value` field from data API responses** — The `findData` protocol
+  implementation no longer returns the deprecated `value` field alongside `records`.
+  Only `records` is returned, matching the `FindDataResponseSchema` spec. All
+  downstream consumers (Studio, app-host example, tests) updated to use `records`
+  exclusively. OData-specific responses (`ODataResponseSchema`) retain `value` per
+  the OData v4 standard — protocol-to-OData adaptation is handled in the HTTP
+  dispatch layer.
+
 ### Changed
 - **AI Chat Protocol Aligned with Vercel AI SDK** — Removed custom AI chat protocol
   types and Zod schemas (`AIMessage`, `AIToolCall`, `AIStreamEvent`,
@@ -32,6 +61,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Conversation services serialize/deserialize `ModelMessage` union to flat DB columns
   - All 158 service-ai tests updated and passing
 
+### Fixed
+- **Runtime Dispatcher — semantic error differentiation** — `HttpDispatcher.dispatch()` now
+  returns typed 404 (`ROUTE_NOT_FOUND`) with diagnostic info instead of bare `{ handled: false }`.
+  Added `routeNotFound()` (404) helper method.
+- **Runtime Dispatcher — `/health` handler** — Added health endpoint returning `status`,
+  `timestamp`, `version`, and `uptime`.
+- **Runtime Dispatcher — `handlerReady` in discovery** — `getDiscoveryInfo()` now emits
+  `handlerReady: true` for services with confirmed handlers and `handlerReady: false` for
+  unavailable services.
+- **Dispatcher Plugin — semantic 404** — `sendResult()` now returns `ROUTE_NOT_FOUND` error
+  type with a hint pointing to the discovery endpoint. Added `/health` handler registration.
+- **Studio — handler-ready filtering** — `useApiDiscovery()` now checks both `enabled` and
+  `handlerReady` (or `status === 'available' | 'degraded'` for backward compatibility) before
+  displaying service endpoints in the UI.
+
 ### Removed
 - `AiChatRequestSchema` / `AiChatResponseSchema` Zod schemas from
   `@objectstack/spec/api` — the AI chat wire protocol now uses Vercel AI SDK's

apps/studio/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @objectstack/studio
 
+## Unreleased
+
+### Minor Changes
+
+- Add collapsible right-side AI Chat floating panel (VS Code Copilot Chat style).
+
+  - New `AiChatPanel` component: fixed right-side panel with 48px collapsed edge
+    button and 380px expanded view. Supports stream chat via Vercel AI SDK
+    `useChat` hook connected to `/api/v1/ai/chat`.
+  - New `use-ai-chat-panel` hook: manages panel visibility toggle, keyboard
+    shortcut (`Ctrl+Shift+I` / `Cmd+Shift+I`), and message history persistence
+    to localStorage.
+  - Added `ai` and `@ai-sdk/react` dependencies for Vercel Data Stream Protocol
+    integration.
+
 ## 4.0.0
 
 ### Patch Changes
@@ -48,6 +63,15 @@
 
 ### Fixes
 
+- **Vercel deployment: Fix `functions` pattern validation error**
+  - The `functions` key in `vercel.json` referenced `api/index.js` — a build artifact created by
+    `bundle-api.mjs` — which does not exist in the source tree. Vercel CLI validates patterns against
+    source files before the build runs, producing the error:
+    `The pattern "api/index.js" defined in "functions" doesn't match any Serverless Functions`.
+  - Removed `functions` from `vercel.json` and moved the memory/maxDuration settings to an inline
+    `export const config` in `server/index.ts`. This is the standard Vercel per-function configuration
+    mechanism and is bundled into `api/index.js` by esbuild.
+
 - **Vercel deployment: Fix `@vercel/node@3` runtime error**
   - Removed the `functions.runtime` config from `vercel.json` — the `runtime` field is only for custom/community runtimes, not Node.js. Vercel auto-detects the pre-bundled `api/index.js` as a Node.js serverless function.
 

apps/studio/ROADMAP.md

@@ -58,7 +58,7 @@
 | # | Task | Details |
 |---|------|---------|
 | 0.1 | **Add URL Router** | Integrate TanStack Router or React Router. Map views to URL paths: `/:package/objects/:name`, `/:package/metadata/:type/:name`, `/packages`, `/settings`. Enable browser back/forward and deep linking. |
-| 0.2 | **Centralize response normalization** | Create `src/lib/api-utils.ts` with `normalizeRecords()`, `normalizeMetadata()`. Remove inline `.records || .value || .data` from all components. |
+| 0.2 | **~~Centralize response normalization~~** | ✅ Done — `value` field removed from protocol implementation. All components now use `records` directly (spec-compliant). |
 | 0.3 | **Wire plugin sidebar groups** | Replace hardcoded `PROTOCOL_GROUPS` in `app-sidebar.tsx` with plugin-contributed `useSidebarGroups()`. |
 | 0.4 | **Clean dead code** | Remove stale `types.ts`, empty `app/dashboard/` directory. |
 | 0.5 | **Add React Testing Library** | Set up component test infrastructure. Write baseline tests for `ObjectDataTable`, `ObjectDataForm`, `AppSidebar`, Plugin system. Target: 50% component coverage. |

apps/studio/package.json

@@ -17,6 +17,7 @@
     "preview": "vite preview"
   },
   "dependencies": {
+    "@ai-sdk/react": "^3.0.144",
     "@hono/node-server": "^1.19.11",
     "@objectstack/client": "workspace:*",
     "@objectstack/client-react": "workspace:*",
@@ -47,6 +48,7 @@
     "@radix-ui/react-tabs": "^1.1.13",
     "@radix-ui/react-toast": "^1.2.15",
     "@radix-ui/react-tooltip": "^1.2.8",
+    "ai": "^6.0.142",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "hono": "^4.12.9",

apps/studio/scripts/bundle-api.mjs

@@ -37,11 +37,11 @@ await build({
   platform: 'node',
   format: 'esm',
   target: 'es2020',
-  outfile: 'api/index.js',
+  outfile: 'dist/api/index.js',
   sourcemap: true,
   external: EXTERNAL,
   // Silence warnings about optional/unused require() calls in knex drivers
   logOverride: { 'require-resolve-not-external': 'silent' },
 });
 
-console.log('[bundle-api] Bundled server/index.ts → api/index.js');
+console.log('[bundle-api] Bundled server/index.ts → dist/api/index.js');

apps/studio/server/index.ts

@@ -235,3 +235,15 @@ app.all('*', async (c) => {
 });
 
 export default handle(app);
+
+/**
+ * Vercel per-function configuration.
+ *
+ * Picked up by the @vercel/node runtime from the deployed api/index.js bundle.
+ * Replaces the top-level "functions" key in vercel.json so there is no
+ * pre-build file-pattern validation against a not-yet-bundled artifact.
+ */
+export const config = {
+    memory: 1024,
+    maxDuration: 60,
+};

apps/studio/src/App.tsx

@@ -11,6 +11,7 @@ import { DeveloperOverview } from './components/DeveloperOverview';
 import { PackageManager } from './components/PackageManager';
 import { ApiConsolePage } from './components/ApiConsolePage';
 import { Toaster } from "@/components/ui/toaster"
+import { AiChatPanel } from "@/components/AiChatPanel"
 import { getApiBaseUrl, config } from './lib/config';
 import { PluginRegistryProvider, PluginHost } from './plugins';
 import { builtInPlugins } from './plugins/built-in';
@@ -142,6 +143,7 @@ export default function App() {
           </div>
         </main>
         <Toaster />
+        <AiChatPanel />
       </SidebarProvider>
       </ErrorBoundary>
       </PluginRegistryProvider>