@cognidesk/http 0.0.3-dev.7 → 0.0.3-dev.9

package/README.md

@@ -7,7 +7,7 @@
 [![SDK License](https://img.shields.io/badge/SDK-Apache--2.0-purple.svg)](LICENSES/Apache-2.0.txt)
 [![Studio License](https://img.shields.io/badge/Studio-source--available-slate.svg)](LICENSES/Cognidesk-Studio-Source-Available-License.txt)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)
-[![Node.js](https://img.shields.io/badge/Node.js-18+-green.svg)](https://nodejs.org/)
+[![Node.js](https://img.shields.io/badge/Node.js-24+-green.svg)](https://nodejs.org/)
 
 [Documentation](https://cognidesk.cognilabz.com) · [Quick Start](https://cognidesk.cognilabz.com/getting-started/quick-start/) · [Examples](https://cognidesk.cognilabz.com/examples/) · [API Reference](https://cognidesk.cognilabz.com/api-reference/)
 
@@ -41,7 +41,7 @@ const agent = createAgent("support", {
 const runtime = createRuntime({
   storage: createSqliteStorage({ filename: "data.sqlite" }),
   agent,
-  models,
+  models, // See the Quick Start for createModelSet configuration.
 });
 ```
 
@@ -66,32 +66,58 @@ const runtime = createRuntime({
 | `@cognidesk/ui` | Prebuilt UI components |
 | `@cognidesk/storage` | Storage adapters |
 | `@cognidesk/otel` | OpenTelemetry instrumentation |
-| `@cognidesk/voice-openai` | OpenAI Realtime voice adapter |
+| `@cognidesk/integrations` | External Provider Integrations with category/provider subpaths, such as `@cognidesk/integrations/email/gmail`, `@cognidesk/integrations/voice/openai`, and `@cognidesk/integrations/voice/elevenlabs` |
 | `@cognidesk/voice-websocket` | Voice WebSocket adapter |
 | `@cognidesk/journey-index-json` | JSON-based journey index |
 
 ## Quick start
 
 ```bash
-pnpm add @cognidesk/core @cognidesk/http @cognidesk/storage @libsql/client
+pnpm add @cognidesk/core @cognidesk/http @cognidesk/model @cognidesk/storage @libsql/client @ai-sdk/openai zod
 ```
 
 Read the full [Quick Start guide →](https://cognidesk.cognilabz.com/getting-started/quick-start/)
 
 ## Demo
 
-Run the flight support demo:
+Repository development uses Node.js 24 and the pinned pnpm version from
+`package.json`:
+
+```bash
+corepack enable
+pnpm install
+```
+
+Run the flight support demo locally:
+
+```bash
+cp apps/flight-demo/config.openrouter.example.json apps/flight-demo/config.json
+export OPENROUTER_KEY=sk-or-...
+pnpm --filter @cognidesk/flight-demo ingest:knowledge
+pnpm demo
+```
+
+Open `http://localhost:5173` for the demo frontend,
+`http://localhost:8787/api` for the API, and `http://localhost:3000` for
+Cognidesk Studio. The default local Studio login is
+`admin@local.cognidesk.dev` / `cognidesk-studio-admin`.
+
+Docker uses the same config and model credentials:
 
 ```bash
 docker compose up --build
 ```
 
-Open `http://localhost:5173` for the frontend, `http://localhost:8787/api` for the API.
+Use the OpenTelemetry compose file when you want Grafana, Tempo, Prometheus,
+Loki, and Promtail:
+
+```bash
+docker compose -f docker-compose.otel.yml up --build
+```
 
 ## Development
 
 ```bash
-pnpm install
 pnpm check
 ```
 

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ChannelEventActor, ChannelEventActorType, NormalizedChannelPayloadInput, HandleChannelEventInput, ChannelEventEnvelopeInput, ChannelEventIdentity, ConversationChannelInput, ChannelEventKind, ChannelEventNature, ChannelEventDirection, ChannelEventIntent, ChannelEventSourceEvidence, CreateRuntimeConversationInput, ConversationRecord, HandleChannelEventResult, HandleUserMessageInput, HandleUserMessageResult, SubmitWidgetInput, RuntimeEvent, CustomRuntimeEventDefinition, JourneyEventDefinition, EmitJourneyEventResult, EmitIntermediateMessageInput, EmitGeneratedPreambleInput, CompactConversationInput, CompactConversationResult, RequestHandoffInput, ResumeConversationInput, ResolveChannelOutputInput, ResolveChannelOutputResult, StartVoiceConversationInput, StartVoiceResult, StartVoiceSegmentInput, ReplayConversationInput, ReplayConversationResult, RuntimeSnapshot, CognideskRuntime, VoiceSocketMetadata } from '@cognidesk/core';
+import { ChannelEventActor, ChannelEventActorType, NormalizedChannelPayloadInput, HandleChannelEventInput, ChannelEventEnvelopeInput, ChannelEventIdentity, ConversationChannelInput, ChannelEventKind, ChannelEventNature, ChannelEventDirection, ChannelEventIntent, ChannelEventSourceEvidence, CreateRuntimeConversationInput, ConversationRecord, ListRuntimeConversationsOptions, HandleChannelEventResult, HandleUserMessageInput, HandleUserMessageResult, SubmitWidgetInput, RuntimeEvent, CustomRuntimeEventDefinition, JourneyEventDefinition, EmitJourneyEventResult, EmitIntermediateMessageInput, EmitGeneratedPreambleInput, CompactConversationInput, CompactConversationResult, RequestHandoffInput, ResumeConversationInput, ResolveChannelOutputInput, ResolveChannelOutputResult, StartVoiceConversationInput, StartVoiceResult, StartVoiceSegmentInput, ReplayConversationInput, ReplayConversationResult, RuntimeSnapshot, CognideskRuntime, VoiceSocketMetadata } from '@cognidesk/core';
 export { ChannelEventActor, ChannelEventActorType, ChannelEventBindingOutcome, ChannelEventDirection, ChannelEventEnvelope, ChannelEventEnvelopeInput, ChannelEventHandlingDisposition, ChannelEventIdentity, ChannelEventIntakeResult, ChannelEventIntakeStatus, ChannelEventIntent, ChannelEventKind, ChannelEventNature, ChannelEventSourceEvidence, ChannelEventSourceType, ChannelOutputDeliveryMode, ChannelOutputIntent, ChannelOutputIntentInput, ChannelOutputIntentKind, ChannelOutputResolution, ChannelOutputResolutionDecision, ChannelOutputResolutionOutcome, ChannelOutputResolutionPayload, ChannelOutputResolutionStatus, ChannelSourceEvidence, HandleChannelEventInput, HandleChannelEventResult, NormalizedChannelPayload, NormalizedChannelPayloadInput, ResolveChannelOutputInput, ResolveChannelOutputResult } from '@cognidesk/core';
 
 type ChannelEventActorInput = ChannelEventActor | ChannelEventActorType;
@@ -112,6 +112,7 @@ declare function createChannelHandoffReviewEventInput<TPayload = NormalizedChann
 
 interface CognideskHttpRuntime {
     createConversation(input: CreateRuntimeConversationInput): Promise<ConversationRecord>;
+    listConversations?(input?: ListRuntimeConversationsOptions): Promise<ConversationRecord[]>;
     handleChannelEvent?(input: HandleChannelEventInput): Promise<HandleChannelEventResult>;
     handleUserMessage(input: HandleUserMessageInput): Promise<HandleUserMessageResult>;
     submitWidget?(input: SubmitWidgetInput): Promise<RuntimeEvent>;

package/dist/index.js

@@ -109,10 +109,10 @@ function stripBasePath(pathname, basePath) {
   if (!pathname.startsWith(`${basePath}/`)) return null;
   return pathname.slice(basePath.length);
 }
-function parseOptionalInteger(value) {
+function parseOptionalInteger(value, name = "after") {
   if (value === null || value === "") return void 0;
   if (!/^(0|[1-9]\d*)$/.test(value)) {
-    throw new HttpInputError("after must be a non-negative integer.");
+    throw new HttpInputError(`${name} must be a non-negative integer.`);
   }
   return Number(value);
 }
@@ -760,6 +760,30 @@ function createCognideskHttpHandler(options) {
         }
         const authorizationResponse = await authorizeRequest(options, { request, url, path }, responseOptions);
         if (authorizationResponse) return authorizationResponse;
+        if (request.method === "GET" && path === "/conversations") {
+          if (!options.runtime.listConversations) return json({ error: "Conversation listing is not supported by this runtime" }, 501, responseOptions);
+          const limit = parseOptionalInteger(url.searchParams.get("limit"), "limit");
+          const agentId = optionalSearchString(url.searchParams, "agentId");
+          const beforeUpdatedAt = optionalSearchString(url.searchParams, "beforeUpdatedAt") ?? optionalSearchString(url.searchParams, "before");
+          const afterUpdatedAt = optionalSearchString(url.searchParams, "afterUpdatedAt") ?? optionalSearchString(url.searchParams, "after");
+          const beforeId = optionalSearchString(url.searchParams, "beforeId");
+          const afterId = optionalSearchString(url.searchParams, "afterId");
+          if (beforeId && !beforeUpdatedAt || beforeUpdatedAt && beforeId === void 0 && url.searchParams.has("beforeId")) {
+            throw new HttpInputError("beforeUpdatedAt and beforeId must be provided together.");
+          }
+          if (afterId && !afterUpdatedAt || afterUpdatedAt && afterId === void 0 && url.searchParams.has("afterId")) {
+            throw new HttpInputError("afterUpdatedAt and afterId must be provided together.");
+          }
+          const conversations = await options.runtime.listConversations({
+            ...agentId ? { agentId } : {},
+            ...beforeUpdatedAt && beforeId ? { before: { updatedAt: beforeUpdatedAt, id: beforeId } } : {},
+            ...afterUpdatedAt && afterId ? { after: { updatedAt: afterUpdatedAt, id: afterId } } : {},
+            ...beforeUpdatedAt && !beforeId ? { beforeUpdatedAt } : {},
+            ...afterUpdatedAt && !afterId ? { afterUpdatedAt } : {},
+            ...limit !== void 0 ? { limit } : {}
+          });
+          return json({ conversations }, 200, responseOptions);
+        }
         if (request.method === "POST" && path === "/conversations") {
           const body = await readObject(request);
           const agentId = optionalString(body, "agentId") ?? options.agentId;
@@ -1040,6 +1064,12 @@ function createCognideskHttpHandler(options) {
     }
   };
 }
+function optionalSearchString(params, key) {
+  const value = params.get(key);
+  if (value === null) return void 0;
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : void 0;
+}
 export {
   createChannelEventInput,
   createChannelEventRequestBody,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cognidesk/http",
-  "version": "0.0.3-dev.7",
+  "version": "0.0.3-dev.9",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
@@ -18,7 +18,7 @@
     "lint": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@cognidesk/core": "0.0.3-dev.7"
+    "@cognidesk/core": "0.0.3-dev.9"
   },
   "devDependencies": {
     "tsup": "^8.5.0",