gencow 0.1.227 → 0.1.228

package/core/index.js

@@ -268,6 +268,21 @@ function createGencowHttpRouteBuilders() {
   };
 }
 
+// ../core/src/search-index-contract.ts
+function buildSearchIndexNames(table, field) {
+  if (!/^[A-Za-z_][A-Za-z0-9_]*$/u.test(table) || !/^[A-Za-z_][A-Za-z0-9_]*$/u.test(field)) {
+    throw new Error("Search index identity contains an invalid identifier");
+  }
+  const identity = `${table}:${field}`;
+  let hash = 0xcbf29ce484222325n;
+  for (const character of identity) {
+    hash ^= BigInt(character.codePointAt(0) ?? 0);
+    hash = BigInt.asUintN(64, hash * 0x100000001b3n);
+  }
+  const prefix = `gencow_search_${hash.toString(16).padStart(16, "0")}`;
+  return { fts: `${prefix}_fts_idx`, trigram: `${prefix}_trgm_idx` };
+}
+
 // ../core/src/document-types.ts
 function normalizeCachePart(value) {
   return value.trim() || "unknown";
@@ -5138,6 +5153,7 @@ export {
   buildRealtimeCtx,
   buildRealtimeQueryScopeHash,
   buildRealtimeQuerySubscriptionKey,
+  buildSearchIndexNames,
   buildWakeAppBootFailedResult,
   buildWakeAppSuccessResult,
   compareUnreadCursors,

package/lib/component-readme.mjs

@@ -325,13 +325,14 @@ const sdkReply = await generateText({
   ai.chat({ messages, tools })             // respond with tool calls`,
   },
   "memory.ts": {
-    title: "🧠 Agent Memory",
+    title: "🧠 Memory Toolkit",
     table: `| Function | Type | Description |
 | :--- | :--- | :--- |
 | \`createMemory()\` | \`factory\` | Compose memory with an extraction model and explicit embedding profile |
-| \`memory.extract()\` | \`function\` | Automatically extract facts from conversations |
-| \`memory.search()\` | \`function\` | Semantic search over related memories |
-| \`memory.buildContext()\` | \`function\` | Compose memory context for agents |`,
+| \`memory.remember()\` | \`function\` | Add raw or extracted durable memory with an idempotency receipt |
+| \`memory.search()\` | \`function\` | Owner/scope-isolated hybrid memory retrieval |
+| \`memory.selectContext()\` | \`function\` | Deterministically select untrusted prompt data within a token budget |
+| \`memory.update()\` / \`forget()\` | \`function\` | Revision-safe correction and privacy deletion |`,
     usage: `\`\`\`typescript
 import { createGencowAI } from "@/gencow/ai";
 import { createMemory, memory, MEMORY_EMBEDDING_PROFILE } from "@/gencow/memory";
@@ -342,17 +343,29 @@ const customMemory = createMemory({
     embeddingProfile: MEMORY_EMBEDDING_PROFILE,
 });
 
-const memCtx = await memory.buildContext(ctx, userId, sessionId, query);
+const receipt = await customMemory.remember(ctx, {
+    namespace: "assistant-memory",
+    scope: { conversation: conversationId },
+    input: [{ role: "user", content: query }],
+    mode: "extract",
+    source: { type: "message", id: messageId, revision: "1" },
+    idempotencyKey: \`memory:\${messageId}:1\`,
+});
+const matches = await customMemory.search(ctx, {
+    namespace: "assistant-memory",
+    scope: { conversation: conversationId },
+    query,
+});
 const reply = await ai.chat({
-    system: memCtx.toSystemPrompt(),
-    messages: [...memCtx.recentMessages, { role: "user", content: query }],
+    messages: [{ role: "user", content: query }],
 });
 \`\`\``,
-    vibePrompt: `Agent Memory API:
+    vibePrompt: `Memory Toolkit API:
   import { memory } from "@/gencow/memory";
   createMemory({ extractionModel, embeddingProfile }) // pure AI SDK composition with explicit model+dimensions
-  memory.buildContext(ctx, userId, sessionId, query)  // memory context
-  memory.extract(ctx, userId, conversation)           // fact extraction`,
+  memory.remember(ctx, input)                          // raw/extract durable memory
+  memory.search(ctx, input)                            // owner/scope hybrid recall
+  memory.selectContext(ctx, input)                     // app-owned prompt data`,
   },
   "analytics.ts": {
     title: "📊 Analytics",

package/lib/db-migration-command-steps.mjs

@@ -63,11 +63,17 @@ export function handleLocalMigrationCommand({
     deps.infoImpl("Pushing schema.ts → database (no migration files)...");
   }
   try {
-    deps.runInServer(
-      "pnpm db:push --force",
-      deps.buildEnv(config),
-      jsonMode ? { infoImpl: () => {}, stdio: "pipe" } : undefined,
-    );
+    const env = deps.buildEnv(config);
+    const childOptions = jsonMode ? { infoImpl: () => {}, stdio: "pipe" } : undefined;
+    if (hasDb) {
+      deps.runInServer("pnpm db:push --force", env, childOptions);
+    } else {
+      // Drizzle Kit cannot attach PGlite's packaged pgvector/pg_trgm modules.
+      // Generate the same desired-state migration, then apply it through the
+      // runtime connection that owns those extensions.
+      deps.runInServer("pnpm db:generate", env, childOptions);
+      deps.runInServer("bun src/local-pglite-migrate.ts", env, childOptions);
+    }
   } catch (error) {
     if (!jsonMode) throw error;
     emitFailure(buildLocalExecutionFailureDiagnostic(correlationId()));

package/lib/init-command.mjs

@@ -259,7 +259,7 @@ ${
   ${CYAN}gencow add sso${RESET}       ${DIM}← Add Google SSO login${RESET}
   ${CYAN}gencow add Agent${RESET}     ${DIM}← Add workflow agent starter${RESET}
   ${CYAN}gencow add RAG${RESET}       ${DIM}← Add RAG component${RESET}
-  ${CYAN}gencow add Memory${RESET}    ${DIM}← Add Agent Memory${RESET}
+  ${CYAN}gencow add Memory${RESET}    ${DIM}← Add Memory Toolkit${RESET}
 `
 }
 `;

package/lib/readme-codegen.mjs

@@ -306,7 +306,8 @@ export function buildAiPrompt(apiObj, namespaces) {
   md += `- Use rerank({ model: createGencowAI().rerankingModel(...) }) or ai.rerank() only after retrieval authorization; do not pass private metadata as provider payload.\n`;
   md += `- createGencowAI().rerankingModel(...) is proxy-only today. Local direct mode with only OPENAI_API_KEY must fail fast for reranking.\n`;
   md += `- The generated reranker starter may use an explicit fallbackModel compatibility path, but strict providerPreference such as azure_cohere must still fail closed on auth/config errors.\n`;
-  md += `- Recommended chat models: gpt-5.4-mini for most apps, gpt-5.4 for Startup/Enterprise highest quality, gpt-5.4-nano for high-volume extraction.\n`;
+  md += `- Use stable virtual profiles for every new hosted chat call: llm/economy for Hobby, llm/balanced for general Startup/Enterprise workloads, llm/quality for maximum quality, and llm/code for tool-using code work.\n`;
+  md += `- Direct chat model IDs are only for local direct-provider development, compatibility, or explicitly verified model-specific capabilities.\n`;
   md += `- Use ai.generateObject() with a Zod schema for structured output. Do not use ai.chat() + JSON.parse().\n`;
   md += `- Install AI with gencow add AI, RAG with gencow add RAG, Memory with gencow add Memory, and durable agents with gencow add Agent.\n`;
   md += `\`\`\`\n\n`;
@@ -315,14 +316,14 @@ export function buildAiPrompt(apiObj, namespaces) {
 
 export function buildAiUsageSection() {
   let md = `---\n\n## AI Usage\n\n`;
-  md += `Gencow supports an Azure-first active chat catalog: gpt-5.4 on Startup/Enterprise, gpt-5.4-mini by default, gpt-5.4-nano for high volume, plus compatibility models gpt-5-mini and gpt-5-nano. Deprecated requests such as \`gpt-5.5\` and \`gpt-4o-mini\` are automatically substituted to the closest supported model before provider execution. Image and embedding models are also controlled by the platform \`model_pricing\` catalog.\n`;
-  md += `\`OPENAI_API_KEY\` is only for local direct/fallback usage. Cloud deployments use the Gencow AI proxy with platform-managed internal credentials and service credits.\n\n`;
+  md += `Gencow recommends stable virtual chat profiles for every new hosted chat call: \`llm/economy\` on Hobby and \`llm/balanced\`, \`llm/quality\`, or \`llm/code\` on Startup/Enterprise. The platform can replace each profile's concrete model without requiring app changes. Direct chat model IDs remain compatibility or model-specific escape hatches, not recommended defaults. Image and embedding models use their dedicated model IDs.\n`;
+  md += `The stable \`llm/*\` profiles are resolved by the hosted Gencow AI proxy. \`OPENAI_API_KEY\` is only for local direct/fallback usage, where code must keep using an OpenAI concrete model ID. Cloud deployments use platform-managed internal credentials and service credits.\n\n`;
   md += `\`\`\`typescript\n`;
   md += `import { generateImage, generateText, rerank } from "ai";\n`;
   md += `import { createGencowAI, ai } from "./ai";\n\n`;
   md += `const gencow = createGencowAI();\n\n`;
   md += `const result = await generateText({\n`;
-  md += `  model: gencow.languageModel("gpt-5.4-mini"),\n`;
+  md += `  model: gencow.languageModel("llm/balanced"),\n`;
   md += `  system: "You are a helpful assistant.",\n`;
   md += `  messages: [{ role: "user", content: "Hello" }],\n`;
   md += `});\n\n`;
@@ -355,12 +356,11 @@ export function buildAiUsageSection() {
   md += `\`\`\`\n\n`;
   md += `| Purpose | Recommended model |\n`;
   md += `|---|---|\n`;
-  md += `| Highest quality / complex reasoning | \`gpt-5.4\` (Startup/Enterprise) |\n`;
-  md += `| Most production chat, coding, and agent tasks | \`gpt-5.4-mini\` |\n`;
-  md += `| High-volume classification and extraction | \`gpt-5.4-nano\` |\n`;
-  md += `| Compatibility replacement for deprecated mini-class models | \`gpt-5-mini\` |\n`;
-  md += `| Compatibility replacement for deprecated nano-class models | \`gpt-5-nano\` |\n`;
-  md += `| Image-to-text / OCR-style extraction | \`gpt-5.4-mini\` or \`gpt-5-mini\` |\n`;
+  md += `| Lowest-cost chat, classification, and extraction | \`llm/economy\` |\n`;
+  md += `| Most production chat and agent tasks | \`llm/balanced\` (Startup/Enterprise) |\n`;
+  md += `| Highest quality / complex reasoning | \`llm/quality\` (Startup/Enterprise) |\n`;
+  md += `| Coding and function tools | \`llm/code\` (Startup/Enterprise) |\n`;
+  md += `| Image-to-text / OCR-style extraction | \`llm/balanced\` |\n`;
   md += `| Image generation | \`gpt-image-2\` or \`gpt-image-1-mini\` |\n\n`;
   md += `Do not wire \`@ai-sdk/openai\` or provider keys directly. Use \`createGencowAI()\` or the \`ai.*\` facade from \`./ai\`.\n\n`;
   md += `\`\`\`typescript\n`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gencow",
-  "version": "0.1.227",
+  "version": "0.1.228",
   "description": "Gencow — AI Backend Engine",
   "type": "module",
   "bin": {
@@ -31,11 +31,15 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
+    "@ai-sdk/openai": "^3.0.0",
+    "@ai-sdk/provider": "^3.0.0",
+    "@ai-sdk/provider-utils": "^4.0.0",
+    "ai": "^6.0.233",
     "@types/node": "^25.9.5",
     "better-auth": "^1.6.23",
     "@gencow/client": "0.2.7",
-    "@gencow/react": "0.2.7",
-    "@gencow/core": "0.1.43"
+    "@gencow/core": "0.1.44",
+    "@gencow/react": "0.2.7"
   },
   "scripts": {
     "prebuild": "pnpm --filter @gencow/migration-contract run build && pnpm --filter @gencow/server run build",