streamtrust 0.2.0 → 0.3.0

package/examples/vercel-ai/reference-app/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "streamtrust-vercel-ai-reference-app",
+  "private": true,
+  "description": "Minimal Next.js + AI SDK chat used as the StreamTrust vercel-ai preset's application under test",
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "next build",
+    "start": "next start"
+  },
+  "dependencies": {
+    "@ai-sdk/openai-compatible": "3.0.68",
+    "@ai-sdk/react": "4.0.141",
+    "ai": "7.0.138",
+    "next": "16.4.3",
+    "react": "19.3.0",
+    "react-dom": "19.3.0"
+  }
+}

package/examples/vercel-ai/setup.mjs

@@ -0,0 +1,27 @@
+import { assertIsolatedCheckout } from './config.mjs';
+import { execFileSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const root = resolve(
+  process.env.STREAMTRUST_VERCEL_AI_ROOT ||
+    fileURLToPath(new URL('./reference-app', import.meta.url)),
+);
+if (Number(process.versions.node.split('.')[0]) < 22)
+  throw new Error('The vercel-ai preset requires Node.js 22+ (AI SDK 7)');
+if (!existsSync(resolve(root, 'package.json')))
+  throw new Error(`No package.json in ${root}`);
+assertIsolatedCheckout(root);
+const run = (cmd, args) =>
+  execFileSync(cmd, args, {
+    cwd: root,
+    stdio: 'inherit',
+    env: { ...process.env, NEXT_TELEMETRY_DISABLED: '1' },
+  });
+// The bundled shrinkwrap pins the fixture; external checkouts retain their own lockfile.
+run('npm', [
+  existsSync(resolve(root, 'npm-shrinkwrap.json')) || existsSync(resolve(root, 'package-lock.json')) ? 'ci' : 'install',
+  '--no-audit',
+  '--no-fund',
+]);
+run('npm', ['run', 'build']);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "streamtrust",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Adapter-driven CI verification for streaming application lifecycle guarantees",
   "type": "module",
   "license": "MIT",
@@ -24,7 +24,18 @@
   "files": [
     "bin/",
     "src/",
-    "examples/",
+    "examples/http.adapter.mjs",
+    "examples/demo-app.mjs",
+    "examples/librechat/*.mjs",
+    "examples/librechat/README.md",
+    "examples/vercel-ai/*.mjs",
+    "examples/vercel-ai/README.md",
+    "examples/vercel-ai/reference-app/package.json",
+    "examples/vercel-ai/reference-app/npm-shrinkwrap.json",
+    "examples/vercel-ai/reference-app/next.config.mjs",
+    "examples/vercel-ai/reference-app/lib/*.js",
+    "examples/vercel-ai/reference-app/app/**/*.js",
+    "examples/vercel-ai/reference-app/app/**/*.jsx",
     "README.md",
     "LICENSE"
   ],

package/src/cli.d.ts

@@ -1 +1,3 @@
 export function main(args: string[]): Promise<number>;
+/** Preset names accepted by `streamtrust init --preset`; `http` is the default. */
+export function presets(): string[];

package/src/cli.js

@@ -1,11 +1,29 @@
 import { fork } from 'node:child_process';
 import { randomUUID } from 'node:crypto';
-import { resolve } from 'node:path';
+import { resolve, join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { mkdir, copyFile, open, unlink, readFile } from 'node:fs/promises';
 import { constants } from 'node:fs';
 import { VERSION, failureReport } from './index.js';
-const HELP = `StreamTrust ${VERSION}\n\nUsage:\n  streamtrust init [directory] [--preset librechat]\n  streamtrust verify --adapter ./streamtrust/adapter.mjs [options]\n\nOptions:\n  --output <directory>    Reports (default: reports/streamtrust)\n  --repetitions <1-1000>   Repetitions per scenario (default: 3)\n  --timeout-ms <integer>  Total run deadline including setup/cleanup (default: 300000)\n  --help                 Show help\n  --version              Show version\n\nExit codes: 0 all pass; 1 failed/unsupported checks; 2 setup, timeout or harness error.\nAdapters execute trusted local code. JavaScript ESM (.mjs) works without dependencies.\n`;
+const EXAMPLES = fileURLToPath(new URL('../examples/', import.meta.url));
+// Explicit source inventory: never copy local builds, dependencies or configuration.
+const PRESETS = {
+  http: [['http.adapter.mjs', 'adapter.mjs'], ['demo-app.mjs', 'demo-app.mjs']],
+  librechat: ['adapter.mjs', 'provider.mjs', 'setup.mjs', 'README.md'].map(
+    (name) => [`librechat/${name}`, name]),
+  'vercel-ai': [
+    'adapter.mjs', 'provider.mjs', 'setup.mjs', 'config.mjs', 'README.md',
+    'reference-app/package.json', 'reference-app/npm-shrinkwrap.json',
+    'reference-app/next.config.mjs', 'reference-app/lib/store.js',
+    'reference-app/app/layout.jsx', 'reference-app/app/page.jsx',
+    'reference-app/app/api/chat/route.js', 'reference-app/app/chat/[id]/chat.jsx',
+    'reference-app/app/chat/[id]/page.jsx',
+  ].map((name) => [`vercel-ai/${name}`, name]),
+};
+export function presets() { return Object.keys(PRESETS); }
+function presetFiles(preset) { return PRESETS[preset]; }
+const HELP = () =>
+  `StreamTrust ${VERSION}\n\nUsage:\n  streamtrust init [directory] [--preset <name>]\n  streamtrust verify --adapter ./streamtrust/adapter.mjs [options]\n\nOptions:\n  --output <directory>    Reports (default: reports/streamtrust)\n  --repetitions <1-1000>   Repetitions per scenario (default: 3)\n  --timeout-ms <integer>  Total run deadline including setup/cleanup (default: 300000)\n  --help                 Show help\n  --version              Show version\n\nPresets: ${presets().join(', ')} (default: http)\n\nExit codes: 0 all pass; 1 failed/unsupported checks; 2 setup, timeout or harness error.\nAdapters execute trusted local code. JavaScript ESM (.mjs) works without dependencies.\n`;
 export async function main(args) {
   let outputDir;
   try {
@@ -14,7 +32,7 @@ export async function main(args) {
       return 0;
     }
     if (!args.length || args.includes('--help')) {
-      console.log(HELP);
+      console.log(HELP());
       return 0;
     }
     if (args[0] === 'init') {
@@ -24,7 +42,10 @@ export async function main(args) {
       if (presetIndex !== -1) {
         preset = initArgs[presetIndex + 1];
         initArgs.splice(presetIndex, 2);
-        if (preset !== 'librechat') throw new Error('Unknown init preset');
+        if (!presets().includes(preset))
+          throw new Error(
+            `Unknown init preset; available: ${presets().join(', ')}`,
+          );
       }
       if (initArgs.length > 1 || initArgs[0]?.startsWith('-'))
         throw new Error('Invalid init arguments');
@@ -33,20 +54,11 @@ export async function main(args) {
       // Exclusive copies preserve existing adapters. No generated config overrides user files.
       const created = [];
       try {
-        for (const [source, target] of preset === 'librechat'
-          ? [
-              ['librechat/adapter.mjs', 'adapter.mjs'],
-              ['librechat/provider.mjs', 'provider.mjs'],
-              ['librechat/setup.mjs', 'setup.mjs'],
-              ['librechat/README.md', 'README.md'],
-            ]
-          : [
-              ['http.adapter.mjs', 'adapter.mjs'],
-              ['demo-app.mjs', 'demo-app.mjs'],
-            ]) {
+        for (const [source, target] of presetFiles(preset)) {
           const destination = resolve(dir, target);
+          await mkdir(dirname(destination), { recursive: true });
           await copyFile(
-            new URL(`../examples/${source}`, import.meta.url),
+            join(EXAMPLES, source),
             destination,
             constants.COPYFILE_EXCL,
           );