@volter/twin-openai 0.1.1 → 2.0.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@volter/twin-openai",
-  "version": "0.1.1",
-  "description": "Local OpenAI twin \u2014 a faithful, stateful local OpenAI API your real `openai` SDK talks to unmodified. The model is stubbed (deterministic) and embeddings are deterministic pseudo-vectors, but the protocol envelope (chat completions/streaming/tool_calls, the Responses API, embeddings, models, files, batches, moderations, fine-tuning, vector stores) is vendor-faithful. Built on @volter/twin.",
+  "version": "2.0.0",
+  "description": "Local OpenAI twin — a faithful, stateful local OpenAI API your real `openai` SDK talks to unmodified. The model is stubbed (deterministic) and embeddings are deterministic pseudo-vectors, but the protocol envelope (chat completions/streaming/tool_calls, the Responses API, embeddings, models, files, batches, moderations, fine-tuning, vector stores) is vendor-faithful. Built on @volter/world-core.",
   "keywords": [
     "twin",
     "local",
@@ -21,12 +21,14 @@
   "license": "Apache-2.0",
   "files": [
     "src",
+    "defaults",
     "client",
     "test-fixtures",
     "README.md",
     "LICENSE",
     "!**/*.test.ts",
-    "!**/*.test.tsx"
+    "!**/*.test.tsx",
+    "dist"
   ],
   "repository": {
     "type": "git",
@@ -36,27 +38,36 @@
   "homepage": "https://github.com/volter-ai/twin/tree/main/packages/twin/openai#readme",
   "type": "module",
   "exports": {
-    ".": "./src/index.ts"
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    }
   },
   "bin": {
-    "world-openai": "src/cli.ts"
+    "world-openai": "dist/src/cli.js"
   },
   "scripts": {
     "test": "bun test src/*.test.ts",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "build": "node ../../../scripts/publish/build.mjs",
+    "prepack": "node ../../../scripts/publish/prepare-publish.mjs prepack",
+    "postpack": "node ../../../scripts/publish/prepare-publish.mjs postpack"
   },
   "peerDependencies": {
-    "@volter/twin": "0.1.1"
+    "@volter/world-core": "2.0.0"
   },
   "devDependencies": {
-    "@volter/twin": "workspace:*",
-    "@volter/twin-tooling": "workspace:*",
+    "@volter/world-core": "2.0.0",
+    "@volter/world-tooling": "0.1.0",
     "openai": "^4.104.0",
     "@types/bun": "^1.2.20",
     "@types/node": "^24.0.0",
     "typescript": "^5.9.0"
   },
   "engines": {
-    "bun": ">=1.2.0"
+    "node": ">=22.3"
+  },
+  "dependencies": {
+    "@volter/world-ui": "0.1.0"
   }
 }

package/src/cli.ts

@@ -1,26 +1,28 @@
-#!/usr/bin/env bun
-import { keepProcessAlive } from '@volter/twin/lifecycle';
+#!/usr/bin/env node
+import { keepProcessAlive } from '@volter/world-core/lifecycle';
 // world-openai CLI: serve the OpenAI API twin or run conformance. OpenAI is an API-first
-// vendor with no meaningful product UI worth mirroring (ARCHITECTURE.md C1b), so this pack
+// vendor with no meaningful product UI worth mirroring (docs/contributing/architecture.md C1b), so this pack
 // ships no mirror.
-import { hasFlag, optionValue } from '@volter/twin/args';
+import { hasFlag, optionValue } from '@volter/world-core/args';
+import './index.ts'; // the pack registers itself on load (protocol 2)
 import { createOpenAITwinServer } from './openai-server.ts';
 
 const [cmd, ...rest] = process.argv.slice(2);
 const port = Number(optionValue(rest, '--port', '0')) || undefined;
 const root = optionValue(rest, '--root') || undefined;
 const readOnly = hasFlag(rest, '--read-only'); // a twin accepts writes unless started read-only
+const scenario = optionValue(rest, '--scenario') || undefined; // scripted completions (JSON file)
 
 if (cmd === 'serve') {
-  const s = createOpenAITwinServer({ readOnly, ...(root ? { root } : {}), ...(port ? { port } : {}) });
+  const s = await createOpenAITwinServer({ readOnly, ...(root ? { root } : {}), ...(port ? { port } : {}), ...(scenario ? { scenarioPath: scenario } : {}) });
   process.stdout.write(`openai twin (chat/responses/embeddings output is a deterministic stub)${readOnly ? ' [read-only]' : ''} at http://127.0.0.1:${s.port}\n`);
   await keepProcessAlive();
 } else if (cmd === 'conformance') {
-  // dev-only; lazy so the bin runs without @volter/twin-tooling
+  // dev-only; lazy so the bin runs without @volter/world-tooling
   const { checkOpenAIConformance } = await import('./openai-conformance.ts');
   const report = await checkOpenAIConformance({ ...(root ? { root } : {}) });
   process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
   if (!report.ok) process.exitCode = 1;
 } else {
-  process.stdout.write('Usage: world-openai serve|conformance [--port N] [--root DIR] [--read-only]\n');
+  process.stdout.write('Usage: world-openai serve|conformance [--port N] [--root DIR] [--read-only] [--scenario FILE]\n');
 }