@breadstone/archipel-mcp 0.0.53 → 0.0.54

package/data/packages/platform-intelligence/index.md

@@ -35,6 +35,84 @@ export class AppModule {}
 
 ---
 
+## Reusable Prompts
+
+Use `intelligencePrompt()` to keep a prompt's identity, version, schemas,
+instructions, messages, and execution requirements in one pure definition.
+Bind already prepared feature data with `.with(...)` and execute the resulting
+invocation through the NestJS `IntelligencePromptExecutor`.
+
+For a guided first implementation, see
+[Intelligence Prompts Warm-up](/guides/intelligence-prompts-warm-up).
+
+```typescript
+import { Injectable } from '@nestjs/common';
+import { z } from 'zod';
+import {
+  intelligencePrompt,
+  IntelligencePromptExecutor,
+} from '@breadstone/archipel-platform-intelligence';
+
+const DuplicateDetectionPrompt = intelligencePrompt({
+  name: 'crm.duplicate-detection',
+  version: 1,
+  mode: 'object',
+  inputSchema: z.object({
+    sourceId: z.number().int(),
+    candidateIds: z.array(z.number().int()),
+  }),
+  outputSchema: z.object({
+    scores: z.array(z.object({
+      id: z.number().int(),
+      score: z.number().min(0).max(100),
+    })),
+  }),
+  system: () => [
+    'Score duplicate candidates using only the supplied fields.',
+    'Do not infer facts from missing data.',
+  ],
+  messages: ({ input }) => [
+    { role: 'user', content: JSON.stringify(input) },
+  ],
+  execution: {
+    options: { temperature: 0, maxOutputTokens: 800 },
+    model: { strategy: 'automatic' },
+    requiredCapabilities: ['structuredOutput'],
+  },
+});
+
+export function duplicateDetectionPrompt(sourceId: number, candidateIds: ReadonlyArray<number>) {
+  return DuplicateDetectionPrompt.with({ sourceId, candidateIds });
+}
+
+@Injectable()
+export class DuplicateDetectionService {
+  public constructor(private readonly prompts: IntelligencePromptExecutor) {}
+
+  public async score(sourceId: number, candidateIds: ReadonlyArray<number>) {
+    const execution = await this.prompts.execute(
+      duplicateDetectionPrompt(sourceId, candidateIds),
+    );
+
+    return execution.output.scores;
+  }
+}
+```
+
+The schemas use the AI SDK `FlexibleSchema` contract. Object mode requires an
+output schema and uses AI SDK 7 `Output.object()`; text mode has no output
+schema and returns a string. Input and completed object output are validated at
+runtime.
+
+Native AI SDK settings work with the default policy. Applications that declare
+provider-neutral quality, reasoning, latency, preferred models, or fixed model
+identifiers register an `IntelligencePromptPolicyPort` adapter through
+`IntelligenceModule.register({ promptPolicyAdapter })`. Execution results
+contain requested and effective policy, provider, model, usage, reasoning, and
+invocation metadata for application-owned billing and auditing.
+
+---
+
 ## Realtime Voice
 
 Archipel owns the upstream provider WebSocket and exposes normalized audio,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@breadstone/archipel-mcp",
-  "version": "0.0.53",
+  "version": "0.0.54",
   "description": "MCP server providing Archipel platform knowledge - documentation, query patterns, and coding conventions - to AI development tools.",
   "type": "commonjs",
   "main": "./src/main.js",