create-ragen-app 0.4.0 → 0.5.0

package/dist/llm-provider.js

@@ -3,16 +3,53 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LLM_PROVIDERS = void 0;
 exports.resolveLlmProviderChoice = resolveLlmProviderChoice;
 exports.LLM_PROVIDERS = {
+    openrouter: {
+        label: 'OpenRouter (one key, most models)',
+        apiKeyEnvVar: 'OPENROUTER_API_KEY',
+        // Namespaced upstream, plain here: the model id is what the application
+        // and the catalogue use, and `model` is the upstream's own name. Keeping
+        // the slash out of the key also keeps it out of URLs and log lines.
+        modelName: 'claude-haiku-4-5-openrouter',
+        gatewayProvider: 'openrouter',
+        upstreamModel: 'anthropic/claude-haiku-4.5',
+        embeddings: {
+            modelName: 'text-embedding-3-small-openrouter',
+            upstreamModel: 'openai/text-embedding-3-small',
+            vectorSize: 1536,
+        },
+    },
+    scaleway: {
+        label: 'Scaleway (EU infrastructure)',
+        apiKeyEnvVar: 'SCW_API_KEY',
+        baseUrl: {
+            envVar: 'SCW_API_BASE',
+            prompt: 'Paste your Scaleway Generative APIs base URL (https://api.scaleway.ai/<project-id>/v1)',
+        },
+        // The set Ragen's own demo runs. Both ids already exist in the shipped
+        // route table under `connection: scaleway`, so this writes the same routes
+        // the repository ships rather than inventing names.
+        modelName: 'mistral-small-3.2',
+        gatewayProvider: 'openai-compatible',
+        connection: 'scaleway',
+        upstreamModel: 'mistral-small-3.2-24b-instruct-2506',
+        embeddings: {
+            modelName: 'bge-multilingual-gemma2',
+            upstreamModel: 'bge-multilingual-gemma2',
+            // 3584 is `DEFAULT_VECTOR_SIZE` in rag-core, and it is this model's.
+            // The one Scaleway choice that needs no VECTOR_SIZE override — every
+            // other provider here does, and getting it wrong makes Qdrant reject
+            // every upsert rather than degrade.
+            vectorSize: 3584,
+        },
+    },
     openai: {
         label: 'OpenAI',
         apiKeyEnvVar: 'OPENAI_API_KEY',
         modelName: 'gpt-4o-mini',
-        litellmModel: 'openai/gpt-4o-mini',
         gatewayProvider: 'openai',
         upstreamModel: 'gpt-4o-mini',
         embeddings: {
             modelName: 'text-embedding-3-small',
-            litellmModel: 'openai/text-embedding-3-small',
             upstreamModel: 'text-embedding-3-small',
             vectorSize: 1536,
         },
@@ -21,12 +58,11 @@ exports.LLM_PROVIDERS = {
         label: 'Anthropic',
         apiKeyEnvVar: 'ANTHROPIC_API_KEY',
         // Not "claude-haiku-4-5" — packages/platform-contracts/src/llm/model-catalog.ts
-        // already uses that name for the (commented) Bedrock deployment of the
-        // same model. Two model_list entries sharing a model_name become one
-        // load-balanced pool in LiteLLM, silently mixing direct-Anthropic and
-        // Bedrock traffic under Bedrock's catalog metadata.
+        // already uses that name for the Bedrock deployment of the same model, and
+        // the route table is a map: a second entry under that key would silently
+        // replace the first, so a scaffolded install would take over a catalogue
+        // name it does not own and serve it from a different account.
         modelName: 'claude-haiku-4-5-direct',
-        litellmModel: 'anthropic/claude-haiku-4-5-20251001',
         gatewayProvider: 'anthropic',
         upstreamModel: 'claude-haiku-4-5-20251001',
         // Anthropic ships no embeddings endpoint, so there is nothing to point
@@ -36,16 +72,14 @@ exports.LLM_PROVIDERS = {
         // EmbeddingsUnsupportedError rather than failing inside the AI SDK.
     },
 };
-function resolveLlmProviderChoice(choice, apiKey) {
+function resolveLlmProviderChoice(choice, apiKey, baseUrl) {
     const config = exports.LLM_PROVIDERS[choice];
     const envUpdates = {
         [config.apiKeyEnvVar]: apiKey,
+        ...(config.baseUrl && baseUrl ? { [config.baseUrl.envVar]: baseUrl } : {}),
         DEFAULT_MODEL: config.modelName,
-        // Overrides the manifest's `litellm`, which is the baseline for the one
-        // path that reaches neither branch here: "I'll configure LiteLLM myself".
-        LLM_GATEWAY: 'native',
-        // Not the gateway. This names the pricing namespace `AiUsage` writes
-        // against, where the whole catalogue lives under `litellm`; the provider
+        // The pricing namespace `AiUsage` writes against, where the whole
+        // catalogue lives under `litellm` — not a gateway any more. The provider
         // that actually served a turn is recorded separately as `servedBy`.
         DEFAULT_MODEL_PROVIDER: 'litellm',
         // .env.example ships gemini-2.5-flash here, which needs Vertex
@@ -54,21 +88,15 @@ function resolveLlmProviderChoice(choice, apiKey) {
         // model the user just configured is ever reached.
         REPHRASE_MODEL: config.modelName,
     };
-    const liteLLMEntries = [
-        {
-            modelName: config.modelName,
-            model: config.litellmModel,
-            apiKeyEnvVar: config.apiKeyEnvVar,
-        },
-    ];
-    // Written as well as the route table, and deliberately: `docker compose up`
-    // starts LiteLLM whatever `LLM_GATEWAY` says, so configuring both makes
-    // `LLM_GATEWAY=litellm` a working rollback rather than a broken one.
+    // The route table is the whole configuration now. There is no second place
+    // to keep in step and no flag to roll back to — #1194 removed the proxy path
+    // and the variable that chose it.
     const routes = [
         {
             modelName: config.modelName,
             provider: config.gatewayProvider,
             model: config.upstreamModel,
+            ...(config.connection ? { connection: config.connection } : {}),
         },
     ];
     if (config.embeddings) {
@@ -77,20 +105,15 @@ function resolveLlmProviderChoice(choice, apiKey) {
         // upsert — rag-core's vector contract says so, and its default (3584)
         // belongs to the Scaleway model being replaced here.
         envUpdates.VECTOR_SIZE = String(config.embeddings.vectorSize);
-        liteLLMEntries.push({
-            modelName: config.embeddings.modelName,
-            model: config.embeddings.litellmModel,
-            apiKeyEnvVar: config.apiKeyEnvVar,
-        });
         routes.push({
             modelName: config.embeddings.modelName,
             provider: config.gatewayProvider,
             model: config.embeddings.upstreamModel,
+            ...(config.connection ? { connection: config.connection } : {}),
         });
     }
     return {
         envUpdates,
-        liteLLMEntries,
         routes,
         embeddingsConfigured: Boolean(config.embeddings),
     };

package/dist/llm-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"llm-provider.js","sourceRoot":"","sources":["../src/llm-provider.ts"],"names":[],"mappings":";;;AA2FA,4DAkEC;AAjHY,QAAA,aAAa,GAAiD;IACzE,MAAM,EAAE;QACN,KAAK,EAAE,QAAQ;QACf,YAAY,EAAE,gBAAgB;QAC9B,SAAS,EAAE,aAAa;QACxB,YAAY,EAAE,oBAAoB;QAClC,eAAe,EAAE,QAAQ;QACzB,aAAa,EAAE,aAAa;QAC5B,UAAU,EAAE;YACV,SAAS,EAAE,wBAAwB;YACnC,YAAY,EAAE,+BAA+B;YAC7C,aAAa,EAAE,wBAAwB;YACvC,UAAU,EAAE,IAAI;SACjB;KACF;IACD,SAAS,EAAE;QACT,KAAK,EAAE,WAAW;QAClB,YAAY,EAAE,mBAAmB;QACjC,gFAAgF;QAChF,uEAAuE;QACvE,qEAAqE;QACrE,sEAAsE;QACtE,oDAAoD;QACpD,SAAS,EAAE,yBAAyB;QACpC,YAAY,EAAE,qCAAqC;QACnD,eAAe,EAAE,WAAW;QAC5B,aAAa,EAAE,2BAA2B;QAC1C,uEAAuE;QACvE,qEAAqE;QACrE,sDAAsD;QACtD,kEAAkE;QAClE,oEAAoE;KACrE;CACF,CAAC;AAcF,SAAgB,wBAAwB,CACtC,MAAyB,EACzB,MAAc;IAEd,MAAM,MAAM,GAAG,qBAAa,CAAC,MAAM,CAAC,CAAC;IAErC,MAAM,UAAU,GAA2B;QACzC,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM;QAC7B,aAAa,EAAE,MAAM,CAAC,SAAS;QAC/B,wEAAwE;QACxE,0EAA0E;QAC1E,WAAW,EAAE,QAAQ;QACrB,qEAAqE;QACrE,yEAAyE;QACzE,oEAAoE;QACpE,sBAAsB,EAAE,SAAS;QACjC,+DAA+D;QAC/D,mEAAmE;QACnE,uEAAuE;QACvE,kDAAkD;QAClD,cAAc,EAAE,MAAM,CAAC,SAAS;KACjC,CAAC;IAEF,MAAM,cAAc,GAAwB;QAC1C;YACE,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,KAAK,EAAE,MAAM,CAAC,YAAY;YAC1B,YAAY,EAAE,MAAM,CAAC,YAAY;SAClC;KACF,CAAC;IAEF,4EAA4E;IAC5E,wEAAwE;IACxE,qEAAqE;IACrE,MAAM,MAAM,GAAsB;QAChC;YACE,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,QAAQ,EAAE,MAAM,CAAC,eAAe;YAChC,KAAK,EAAE,MAAM,CAAC,aAAa;SAC5B;KACF,CAAC;IAEF,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,UAAU,CAAC,gBAAgB,GAAG,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC;QAC1D,yEAAyE;QACzE,sEAAsE;QACtE,qDAAqD;QACrD,UAAU,CAAC,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC9D,cAAc,CAAC,IAAI,CAAC;YAClB,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,SAAS;YACtC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,YAAY;YACrC,YAAY,EAAE,MAAM,CAAC,YAAY;SAClC,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC;YACV,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,SAAS;YACtC,QAAQ,EAAE,MAAM,CAAC,eAAe;YAChC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,aAAa;SACvC,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,UAAU;QACV,cAAc;QACd,MAAM;QACN,oBAAoB,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC;KACjD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"llm-provider.js","sourceRoot":"","sources":["../src/llm-provider.ts"],"names":[],"mappings":"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"}

package/dist/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAEzC,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,aAAa,GAAG,mBAAmB,GAAG,iBAAiB,CAAC;AAEpE,eAAO,MAAM,QAAQ,EAAE,aAAa,EAuFnC,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,EAAE,CAEnE"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAEzC,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,aAAa,GAAG,mBAAmB,GAAG,iBAAiB,CAAC;AAEpE,eAAO,MAAM,QAAQ,EAAE,aAAa,EAqDnC,CAAC;AAEF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,EAAE,CAEnE"}

package/dist/manifest.js

@@ -63,40 +63,6 @@ exports.MANIFEST = [
         targets: ['root', 'admin'],
     },
     // --- Local-dev defaults that correct a stale example value ---
-    {
-        // The baseline, and `resolveLlmProviderChoice` overrides it with `native`
-        // whenever a provider key is actually configured — which is both branches
-        // the wizard offers.
-        //
-        // What is left is the third path: "I'll configure LiteLLM myself". That
-        // one writes no route table, and the table shipped in the repository names
-        // Azure, Bedrock, Vertex and Scaleway — providers a fresh install has no
-        // credentials for. Inheriting the `native` default there would make every
-        // model call fail on the first question, so this pins the proxy the manual
-        // guide then tells them to configure.
-        key: 'LLM_GATEWAY',
-        strategy: 'local-default',
-        targets: ['root'],
-        value: 'litellm',
-    },
-    {
-        // Ships commented out, which leaves apps/web sending no Authorization
-        // header while docker-compose.yml starts the proxy *with* a master key
-        // (`${LITELLM_MASTER_KEY:-sk-litellm-dev-key}`) — so every call to the
-        // proxy came back 401 and the model picker silently fell back to a
-        // static list.
-        //
-        // This is deliberately the same literal as the compose default rather
-        // than a generated secret: Compose interpolates `${LITELLM_MASTER_KEY}`
-        // from the shell or a root `.env`, and never from `.env.local`. A
-        // generated value here would land in the app and not in the container,
-        // which is the 401 again with a harder-to-see cause. It is a local-dev
-        // credential on a loopback port; a deployed install sets its own.
-        key: 'LITELLM_MASTER_KEY',
-        strategy: 'local-default',
-        targets: ['root'],
-        value: 'sk-litellm-dev-key',
-    },
     {
         // docker-compose.yml maps Postgres to host port 55432. A native or other
         // Postgres on 5432 would otherwise silently answer instead of the

package/dist/manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AA4GH,4CAEC;AA3FY,QAAA,QAAQ,GAAoB;IACvC,oDAAoD;IACpD,EAAE,GAAG,EAAE,YAAY,EAAE,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE;IACrE,EAAE,GAAG,EAAE,oBAAoB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE;IAC7E;QACE,GAAG,EAAE,0BAA0B;QAC/B,QAAQ,EAAE,iBAAiB;QAC3B,OAAO,EAAE,CAAC,MAAM,CAAC;KAClB;IACD;QACE,GAAG,EAAE,qBAAqB;QAC1B,QAAQ,EAAE,iBAAiB;QAC3B,OAAO,EAAE,CAAC,MAAM,CAAC;KAClB;IACD;QACE,6DAA6D;QAC7D,sEAAsE;QACtE,0DAA0D;QAC1D,GAAG,EAAE,mBAAmB;QACxB,QAAQ,EAAE,iBAAiB;QAC3B,OAAO,EAAE,CAAC,MAAM,CAAC;KAClB;IACD;QACE,GAAG,EAAE,oBAAoB;QACzB,QAAQ,EAAE,iBAAiB;QAC3B,OAAO,EAAE,CAAC,OAAO,CAAC;KACnB;IAED,yDAAyD;IACzD;QACE,yEAAyE;QACzE,mDAAmD;QACnD,oEAAoE;QACpE,0EAA0E;QAC1E,0BAA0B;QAC1B,GAAG,EAAE,qBAAqB;QAC1B,QAAQ,EAAE,iBAAiB;QAC3B,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;KAC3B;IAED,gEAAgE;IAChE;QACE,0EAA0E;QAC1E,0EAA0E;QAC1E,qBAAqB;QACrB,EAAE;QACF,wEAAwE;QACxE,2EAA2E;QAC3E,yEAAyE;QACzE,0EAA0E;QAC1E,2EAA2E;QAC3E,sCAAsC;QACtC,GAAG,EAAE,aAAa;QAClB,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,CAAC,MAAM,CAAC;QACjB,KAAK,EAAE,SAAS;KACjB;IACD;QACE,sEAAsE;QACtE,uEAAuE;QACvE,uEAAuE;QACvE,mEAAmE;QACnE,eAAe;QACf,EAAE;QACF,sEAAsE;QACtE,wEAAwE;QACxE,kEAAkE;QAClE,uEAAuE;QACvE,uEAAuE;QACvE,kEAAkE;QAClE,GAAG,EAAE,oBAAoB;QACzB,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,CAAC,MAAM,CAAC;QACjB,KAAK,EAAE,oBAAoB;KAC5B;IACD;QACE,yEAAyE;QACzE,kEAAkE;QAClE,gEAAgE;QAChE,wEAAwE;QACxE,6EAA6E;QAC7E,0CAA0C;QAC1C,GAAG,EAAE,cAAc;QACnB,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;QAC1B,KAAK,EAAE,qDAAqD;KAC7D;CACF,CAAC;AAEF,SAAgB,gBAAgB,CAAC,MAAiB;IAChD,OAAO,gBAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AACpE,CAAC"}
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AA0EH,4CAEC;AAzDY,QAAA,QAAQ,GAAoB;IACvC,oDAAoD;IACpD,EAAE,GAAG,EAAE,YAAY,EAAE,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE;IACrE,EAAE,GAAG,EAAE,oBAAoB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE;IAC7E;QACE,GAAG,EAAE,0BAA0B;QAC/B,QAAQ,EAAE,iBAAiB;QAC3B,OAAO,EAAE,CAAC,MAAM,CAAC;KAClB;IACD;QACE,GAAG,EAAE,qBAAqB;QAC1B,QAAQ,EAAE,iBAAiB;QAC3B,OAAO,EAAE,CAAC,MAAM,CAAC;KAClB;IACD;QACE,6DAA6D;QAC7D,sEAAsE;QACtE,0DAA0D;QAC1D,GAAG,EAAE,mBAAmB;QACxB,QAAQ,EAAE,iBAAiB;QAC3B,OAAO,EAAE,CAAC,MAAM,CAAC;KAClB;IACD;QACE,GAAG,EAAE,oBAAoB;QACzB,QAAQ,EAAE,iBAAiB;QAC3B,OAAO,EAAE,CAAC,OAAO,CAAC;KACnB;IAED,yDAAyD;IACzD;QACE,yEAAyE;QACzE,mDAAmD;QACnD,oEAAoE;QACpE,0EAA0E;QAC1E,0BAA0B;QAC1B,GAAG,EAAE,qBAAqB;QAC1B,QAAQ,EAAE,iBAAiB;QAC3B,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;KAC3B;IAED,gEAAgE;IAChE;QACE,yEAAyE;QACzE,kEAAkE;QAClE,gEAAgE;QAChE,wEAAwE;QACxE,6EAA6E;QAC7E,0CAA0C;QAC1C,GAAG,EAAE,cAAc;QACnB,QAAQ,EAAE,eAAe;QACzB,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;QAC1B,KAAK,EAAE,qDAAqD;KAC7D;CACF,CAAC;AAEF,SAAgB,gBAAgB,CAAC,MAAiB;IAChD,OAAO,gBAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/manual-setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manual-setup.d.ts","sourceRoot":"","sources":["../src/manual-setup.ts"],"names":[],"mappings":"AAgJA,wBAAgB,0BAA0B,IAAI,MAAM,CAoCnD"}
+{"version":3,"file":"manual-setup.d.ts","sourceRoot":"","sources":["../src/manual-setup.ts"],"names":[],"mappings":"AAkIA,wBAAgB,0BAA0B,IAAI,MAAM,CAsCnD"}

package/dist/manual-setup.js

@@ -16,28 +16,31 @@ function providerSection(choice) {
     const config = llm_provider_1.LLM_PROVIDERS[choice];
     const envLines = [
         `${config.apiKeyEnvVar}=<your ${config.label} key>`,
-        // The wizard writes this, so the guide must too — otherwise following it
-        // by hand produces a proxy install where the wizard produces a direct one.
-        'LLM_GATEWAY=native',
+        // A provider whose endpoint is per-project needs its base URL named here
+        // too, or the key reaches nothing. Scaleway is the one that does.
+        ...(config.baseUrl
+            ? [`${config.baseUrl.envVar}=<https://api.scaleway.ai/<project-id>/v1>`]
+            : []),
+        // Not a gateway selector: `litellm` is the pricing namespace `AiUsage`
+        // writes against, and the provider that actually served a turn is recorded
+        // separately as `servedBy`. The flag that used to sit here went with the
+        // proxy in #1194.
         'DEFAULT_MODEL_PROVIDER=litellm',
         `DEFAULT_MODEL=${config.modelName}`,
         `REPHRASE_MODEL=${config.modelName}`,
     ];
+    const connectionLine = config.connection
+        ? [`    connection: ${config.connection}`]
+        : [];
     const routeLines = [
         `  ${config.modelName}:`,
         `    provider: ${config.gatewayProvider}`,
+        ...connectionLine,
         `    model: ${config.upstreamModel}`,
     ];
-    const yamlLines = [
-        `  - model_name: ${config.modelName}`,
-        '    litellm_params:',
-        `      model: ${config.litellmModel}`,
-        `      api_key: os.environ/${config.apiKeyEnvVar}`,
-    ];
     if (config.embeddings) {
         envLines.push(`EMBEDDINGS_MODEL=${config.embeddings.modelName}`, `VECTOR_SIZE=${config.embeddings.vectorSize}`);
-        yamlLines.push(`  - model_name: ${config.embeddings.modelName}`, '    litellm_params:', `      model: ${config.embeddings.litellmModel}`, `      api_key: os.environ/${config.apiKeyEnvVar}`);
-        routeLines.push(`  ${config.embeddings.modelName}:`, `    provider: ${config.gatewayProvider}`, `    model: ${config.embeddings.upstreamModel}`);
+        routeLines.push(`  ${config.embeddings.modelName}:`, `    provider: ${config.gatewayProvider}`, ...connectionLine, `    model: ${config.embeddings.upstreamModel}`);
     }
     return [
         `### ${config.label}`,
@@ -58,19 +61,6 @@ function providerSection(choice) {
         'The table shipped in the repository routes to Azure, Bedrock, Vertex and',
         'Scaleway. Those entries are not wrong, they are simply not yours.',
         '',
-        `<details><summary>Prefer to run a proxy instead?</summary>`,
-        '',
-        'Set `LLM_GATEWAY=litellm` rather than `native`, leave the route table',
-        'alone, and add this under the existing `model_list:` key in',
-        '`infra/litellm/config.yaml`:',
-        '',
-        '```yaml',
-        ...yamlLines,
-        '```',
-        '',
-        'Then `docker compose restart litellm`.',
-        '',
-        '</details>',
         ...(config.embeddings ? [] : secondProviderForEmbeddings(config.label)),
         '',
     ];
@@ -134,6 +124,8 @@ function manualLlmSetupInstructions() {
         '`.env.local` and the route table. Pick one provider, apply both edits,',
         'and restart the apps.',
         '',
+        ...providerSection('openrouter'),
+        ...providerSection('scaleway'),
         ...providerSection('openai'),
         ...providerSection('anthropic'),
         '## Before you upload anything',

package/dist/manual-setup.js.map

@@ -1 +1 @@
-{"version":3,"file":"manual-setup.js","sourceRoot":"","sources":["../src/manual-setup.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"manual-setup.js","sourceRoot":"","sources":["../src/manual-setup.ts"],"names":[],"mappings":"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"}

package/dist/route-table.d.ts

@@ -7,14 +7,22 @@ export interface RouteTableEntry {
     provider: string;
     /** The upstream's own name for the model, which may differ from the id. */
     model: string;
+    /**
+     * Which credentials an `openai-compatible` route uses, and therefore which
+     * `LLM_<NAME>_*` variables it reads. Omitted for providers with one upstream.
+     * An `openai-compatible` route is not optional about it: resolving one with
+     * no connection throws `MissingCredentialsError` naming "a `connection` on
+     * the route", before any `LLM_*` variable is read. So omitting it scaffolds
+     * an install that refuses to serve the model at all, rather than one that
+     * reaches the wrong upstream.
+     */
+    connection?: string;
 }
 /**
  * The route table for a scaffolded installation.
  *
- * Written **over** the table shipped in the repository rather than beside it,
- * which is the same thing this wizard already does to
- * `infra/litellm/config.yaml`. Two reasons, and the second is the one that
- * decides it:
+ * Written **over** the table shipped in the repository rather than beside it.
+ * Two reasons, and the second is the one that decides it:
  *
  * - The shipped table names Azure, Bedrock, Vertex and Scaleway. A new
  *   installation has credentials for none of them, so every entry in it is a

package/dist/route-table.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route-table.d.ts","sourceRoot":"","sources":["../src/route-table.ts"],"names":[],"mappings":"AAGA,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,kCAAkC,CAAC;AAEhE,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,CAyB5E;AAED,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,SAAS,eAAe,EAAE,GAClC,IAAI,CAEN"}
+{"version":3,"file":"route-table.d.ts","sourceRoot":"","sources":["../src/route-table.ts"],"names":[],"mappings":"AAGA,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,kCAAkC,CAAC;AAEhE,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,CA2B5E;AAED,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,SAAS,eAAe,EAAE,GAClC,IAAI,CAEN"}

package/dist/route-table.js

@@ -10,10 +10,8 @@ exports.ROUTE_TABLE_PATH = 'infra/llm-gateway/routes.yaml';
 /**
  * The route table for a scaffolded installation.
  *
- * Written **over** the table shipped in the repository rather than beside it,
- * which is the same thing this wizard already does to
- * `infra/litellm/config.yaml`. Two reasons, and the second is the one that
- * decides it:
+ * Written **over** the table shipped in the repository rather than beside it.
+ * Two reasons, and the second is the one that decides it:
  *
  * - The shipped table names Azure, Bedrock, Vertex and Scaleway. A new
  *   installation has credentials for none of them, so every entry in it is a
@@ -27,12 +25,14 @@ exports.ROUTE_TABLE_PATH = 'infra/llm-gateway/routes.yaml';
  */
 function renderRouteTable(entries) {
     const routes = entries
-        .map(({ modelName, provider, model }) => `  ${modelName}:\n    provider: ${provider}\n    model: ${model}\n`)
+        .map(({ modelName, provider, model, connection }) => `  ${modelName}:\n    provider: ${provider}\n` +
+        (connection ? `    connection: ${connection}\n` : '') +
+        `    model: ${model}\n`)
         .join('');
     return `# Written by create-ragen-app for this installation.
 #
 # Which upstream serves each model id the application asks for. Ragen calls
-# these providers itself — LLM_GATEWAY=native — with no proxy in the path.
+# these providers itself, with no proxy in the path.
 #
 # This replaced the table shipped in the repository, which routes to Azure,
 # Bedrock, Vertex and Scaleway. Those entries are not wrong, they are simply

package/dist/route-table.js.map

@@ -1 +1 @@
-{"version":3,"file":"route-table.js","sourceRoot":"","sources":["../src/route-table.ts"],"names":[],"mappings":";;;AAiCA,4CAyBC;AAED,0CAKC;AAjED,qCAAwC;AACxC,yCAAiC;AAEjC,iFAAiF;AACpE,QAAA,gBAAgB,GAAG,+BAA+B,CAAC;AAWhE;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,gBAAgB,CAAC,OAAmC;IAClE,MAAM,MAAM,GAAG,OAAO;SACnB,GAAG,CACF,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,CACjC,KAAK,SAAS,oBAAoB,QAAQ,gBAAgB,KAAK,IAAI,CACtE;SACA,IAAI,CAAC,EAAE,CAAC,CAAC;IAEZ,OAAO;;;;;;;;;;;;;;;;EAgBP,MAAM,EAAE,CAAC;AACX,CAAC;AAED,SAAgB,eAAe,CAC7B,SAAiB,EACjB,OAAmC;IAEnC,IAAA,uBAAa,EAAC,IAAA,gBAAI,EAAC,SAAS,EAAE,wBAAgB,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;AAC9E,CAAC"}
+{"version":3,"file":"route-table.js","sourceRoot":"","sources":["../src/route-table.ts"],"names":[],"mappings":";;;AAyCA,4CA2BC;AAED,0CAKC;AA3ED,qCAAwC;AACxC,yCAAiC;AAEjC,iFAAiF;AACpE,QAAA,gBAAgB,GAAG,+BAA+B,CAAC;AAqBhE;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,gBAAgB,CAAC,OAAmC;IAClE,MAAM,MAAM,GAAG,OAAO;SACnB,GAAG,CACF,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,CAC7C,KAAK,SAAS,oBAAoB,QAAQ,IAAI;QAC9C,CAAC,UAAU,CAAC,CAAC,CAAC,mBAAmB,UAAU,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,cAAc,KAAK,IAAI,CAC1B;SACA,IAAI,CAAC,EAAE,CAAC,CAAC;IAEZ,OAAO;;;;;;;;;;;;;;;;EAgBP,MAAM,EAAE,CAAC;AACX,CAAC;AAED,SAAgB,eAAe,CAC7B,SAAiB,EACjB,OAAmC;IAEnC,IAAA,uBAAa,EAAC,IAAA,gBAAI,EAAC,SAAS,EAAE,wBAAgB,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;AAC9E,CAAC"}

package/dist/worker-runtime.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Which engine runs background jobs, and what choosing BullMQ configures.
+ *
+ * Mirrors `WORKER_RUNTIME_SEAM` in `@ragenai/env`. Copied rather than imported
+ * for the reason `storage-provider.ts` gives: this package is published to npm
+ * and `@ragenai/env` is private, so depending on it would make
+ * `npm create ragen-app` unresolvable.
+ */
+export type WorkerRuntimeChoice = 'temporal' | 'bullmq';
+export declare const WORKER_RUNTIME_LABELS: Record<WorkerRuntimeChoice, string>;
+/**
+ * The published Redis port, not the standard one.
+ *
+ * `docker-compose.yml` maps Redis to 56379 for the reason Postgres is on
+ * 55432: a native Redis on 6379 answers instead of the container, and nothing
+ * about the resulting failure names a port.
+ */
+export declare const DEFAULT_REDIS_URL = "redis://localhost:56379";
+/**
+ * What the address prompt starts from — the adapter's own fallback, and what
+ * `.env.example` ships.
+ *
+ * Offered as a prefilled answer rather than written silently: right on a
+ * laptop, wrong everywhere else, and a deployed worker pointing at its own
+ * container connects to nothing and processes nothing with no error to read.
+ * Temporal left the compose file with ADR-44, so this address now names a
+ * server the operator runs — which makes it exactly the value they should see
+ * before it is written.
+ */
+export declare const DEFAULT_TEMPORAL_SERVER_ADDRESS = "localhost:7233";
+/**
+ * A password the operator never has to invent, and that is never the same
+ * twice.
+ *
+ * The dashboard is off unless both credentials are set, so an installer that
+ * left them blank would ship the runtime with no way to see the queues — which
+ * is the thing the Temporal UI used to provide for free. Writing them is the
+ * point.
+ *
+ * **Generated rather than a fixed default.** A password shipped in this
+ * repository is the same password on every install, on a port that exposes
+ * every job's payload; the first person to read the source has it everywhere.
+ * Generating costs the operator nothing — they type nothing either way — and
+ * the value is printed once so it can be put in a password manager.
+ *
+ * Short enough to retype by hand, unlike `generateSecret()`'s 64 hex
+ * characters: this one is read off a terminal and typed into a browser prompt.
+ */
+export declare function generateAdminPassword(): string;
+export declare const DEFAULT_ADMIN_USER = "admin";
+/**
+ * How many documents the worker ingests at once, written explicitly rather
+ * than left to the code's default.
+ *
+ * It matches `DEFAULT_CONCURRENCY` in `@ragenai/jobs-bullmq`, which D2 raised
+ * from 10 to 20 on the strength of the same measurement: twenty documents
+ * uploaded at once took a median of 24.9s each at 10 and 12.3s at 20, the
+ * difference sitting entirely before parsing began rather than in the work.
+ *
+ * **Written anyway, even though it now equals the default.** The number the
+ * operator has to revisit is this one — it is the first thing to lower when a
+ * provider starts rate-limiting — and a default they never see is not a knob
+ * they can find. If the two ever diverge, this line is the install's answer and
+ * the code's is the fallback for everyone else.
+ *
+ * **A constant, not a guess from the machine.** `os.cpus().length` is the
+ * tempting input and it measures the wrong thing: an ingest is almost entirely
+ * waiting — on storage, on the parser, on the embedding provider — so cores
+ * predict nothing about how many can be in flight. A number derived from
+ * hardware would look principled and mean less than this one.
+ *
+ * Written into `.env` rather than applied silently, because the ceiling that
+ * really binds is the model provider's rate limit, and the operator is the
+ * only one who knows it. A value they can see is a value they can raise.
+ */
+export declare const DEFAULT_WORKER_CONCURRENCY = "20";
+export interface WorkerRuntimeAnswers {
+    /** Blank takes `DEFAULT_TEMPORAL_SERVER_ADDRESS`. */
+    temporalServerAddress: string;
+}
+export interface WorkerRuntimeSelection {
+    choice: WorkerRuntimeChoice;
+    envUpdates: Record<string, string>;
+    /** Shown once after the install, when there is something to show. */
+    dashboard?: {
+        user: string;
+        password: string;
+        port: string;
+    };
+}
+/**
+ * **The runtime each variant cannot work without is written here**, not left to
+ * whatever `.env.example` happens to ship. `REDIS_URL` is required under
+ * BullMQ and `TEMPORAL_SERVER_ADDRESS` under Temporal, and since #1224 the
+ * producers refuse to boot without the one their runtime names — so a wizard
+ * that picks the runtime and not its address configures an install that stops
+ * at startup. `create-ragen-app-knows-the-provider-seams.test.ts` holds this to
+ * the seam.
+ */
+export declare function resolveWorkerRuntimeSelection(choice: WorkerRuntimeChoice, answers?: WorkerRuntimeAnswers): WorkerRuntimeSelection;
+//# sourceMappingURL=worker-runtime.d.ts.map

package/dist/worker-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-runtime.d.ts","sourceRoot":"","sources":["../src/worker-runtime.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,QAAQ,CAAC;AAExD,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAIrE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,4BAA4B,CAAC;AAE3D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,+BAA+B,mBAAmB,CAAC;AAEhE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,qEAAqE;IACrE,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,oBAAoB,GAC7B,sBAAsB,CAgCxB"}

package/dist/worker-runtime.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_WORKER_CONCURRENCY = exports.DEFAULT_ADMIN_USER = exports.DEFAULT_TEMPORAL_SERVER_ADDRESS = exports.DEFAULT_REDIS_URL = exports.WORKER_RUNTIME_LABELS = void 0;
+exports.generateAdminPassword = generateAdminPassword;
+exports.resolveWorkerRuntimeSelection = resolveWorkerRuntimeSelection;
+const node_crypto_1 = require("node:crypto");
+exports.WORKER_RUNTIME_LABELS = {
+    bullmq: 'BullMQ — the default. Runs on the Redis this install already has.',
+    temporal: 'Temporal — durable execution, on a server you run yourself (ADR-44).',
+};
+/**
+ * The published Redis port, not the standard one.
+ *
+ * `docker-compose.yml` maps Redis to 56379 for the reason Postgres is on
+ * 55432: a native Redis on 6379 answers instead of the container, and nothing
+ * about the resulting failure names a port.
+ */
+exports.DEFAULT_REDIS_URL = 'redis://localhost:56379';
+/**
+ * What the address prompt starts from — the adapter's own fallback, and what
+ * `.env.example` ships.
+ *
+ * Offered as a prefilled answer rather than written silently: right on a
+ * laptop, wrong everywhere else, and a deployed worker pointing at its own
+ * container connects to nothing and processes nothing with no error to read.
+ * Temporal left the compose file with ADR-44, so this address now names a
+ * server the operator runs — which makes it exactly the value they should see
+ * before it is written.
+ */
+exports.DEFAULT_TEMPORAL_SERVER_ADDRESS = 'localhost:7233';
+/**
+ * A password the operator never has to invent, and that is never the same
+ * twice.
+ *
+ * The dashboard is off unless both credentials are set, so an installer that
+ * left them blank would ship the runtime with no way to see the queues — which
+ * is the thing the Temporal UI used to provide for free. Writing them is the
+ * point.
+ *
+ * **Generated rather than a fixed default.** A password shipped in this
+ * repository is the same password on every install, on a port that exposes
+ * every job's payload; the first person to read the source has it everywhere.
+ * Generating costs the operator nothing — they type nothing either way — and
+ * the value is printed once so it can be put in a password manager.
+ *
+ * Short enough to retype by hand, unlike `generateSecret()`'s 64 hex
+ * characters: this one is read off a terminal and typed into a browser prompt.
+ */
+function generateAdminPassword() {
+    return (0, node_crypto_1.randomBytes)(12).toString('base64url');
+}
+exports.DEFAULT_ADMIN_USER = 'admin';
+/**
+ * How many documents the worker ingests at once, written explicitly rather
+ * than left to the code's default.
+ *
+ * It matches `DEFAULT_CONCURRENCY` in `@ragenai/jobs-bullmq`, which D2 raised
+ * from 10 to 20 on the strength of the same measurement: twenty documents
+ * uploaded at once took a median of 24.9s each at 10 and 12.3s at 20, the
+ * difference sitting entirely before parsing began rather than in the work.
+ *
+ * **Written anyway, even though it now equals the default.** The number the
+ * operator has to revisit is this one — it is the first thing to lower when a
+ * provider starts rate-limiting — and a default they never see is not a knob
+ * they can find. If the two ever diverge, this line is the install's answer and
+ * the code's is the fallback for everyone else.
+ *
+ * **A constant, not a guess from the machine.** `os.cpus().length` is the
+ * tempting input and it measures the wrong thing: an ingest is almost entirely
+ * waiting — on storage, on the parser, on the embedding provider — so cores
+ * predict nothing about how many can be in flight. A number derived from
+ * hardware would look principled and mean less than this one.
+ *
+ * Written into `.env` rather than applied silently, because the ceiling that
+ * really binds is the model provider's rate limit, and the operator is the
+ * only one who knows it. A value they can see is a value they can raise.
+ */
+exports.DEFAULT_WORKER_CONCURRENCY = '20';
+/**
+ * **The runtime each variant cannot work without is written here**, not left to
+ * whatever `.env.example` happens to ship. `REDIS_URL` is required under
+ * BullMQ and `TEMPORAL_SERVER_ADDRESS` under Temporal, and since #1224 the
+ * producers refuse to boot without the one their runtime names — so a wizard
+ * that picks the runtime and not its address configures an install that stops
+ * at startup. `create-ragen-app-knows-the-provider-seams.test.ts` holds this to
+ * the seam.
+ */
+function resolveWorkerRuntimeSelection(choice, answers) {
+    // Only an explicit `temporal` leaves the default. The fallback used to point
+    // the other way, when Temporal was what the compose file ran; now an
+    // unexpected value — a future variant, a mistyped flag — lands on the runtime
+    // this install actually ships, rather than on one that is no longer there.
+    if (choice === 'temporal') {
+        return {
+            choice: 'temporal',
+            envUpdates: {
+                WORKER_RUNTIME: 'temporal',
+                TEMPORAL_SERVER_ADDRESS: answers?.temporalServerAddress.trim() ||
+                    exports.DEFAULT_TEMPORAL_SERVER_ADDRESS,
+            },
+        };
+    }
+    const password = generateAdminPassword();
+    const port = '8090';
+    return {
+        choice: 'bullmq',
+        envUpdates: {
+            WORKER_RUNTIME: 'bullmq',
+            REDIS_URL: exports.DEFAULT_REDIS_URL,
+            WORKER_CONCURRENCY: exports.DEFAULT_WORKER_CONCURRENCY,
+            WORKER_ADMIN_USER: exports.DEFAULT_ADMIN_USER,
+            WORKER_ADMIN_PASSWORD: password,
+            WORKER_ADMIN_PORT: port,
+        },
+        dashboard: { user: exports.DEFAULT_ADMIN_USER, password, port },
+    };
+}
+//# sourceMappingURL=worker-runtime.js.map

package/dist/worker-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-runtime.js","sourceRoot":"","sources":["../src/worker-runtime.ts"],"names":[],"mappings":";;;AA2DA,sDAEC;AAoDD,sEAmCC;AApJD,6CAA0C;AAa7B,QAAA,qBAAqB,GAAwC;IACxE,MAAM,EAAE,mEAAmE;IAC3E,QAAQ,EACN,sEAAsE;CACzE,CAAC;AAEF;;;;;;GAMG;AACU,QAAA,iBAAiB,GAAG,yBAAyB,CAAC;AAE3D;;;;;;;;;;GAUG;AACU,QAAA,+BAA+B,GAAG,gBAAgB,CAAC;AAEhE;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,qBAAqB;IACnC,OAAO,IAAA,yBAAW,EAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC/C,CAAC;AAEY,QAAA,kBAAkB,GAAG,OAAO,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACU,QAAA,0BAA0B,GAAG,IAAI,CAAC;AAc/C;;;;;;;;GAQG;AACH,SAAgB,6BAA6B,CAC3C,MAA2B,EAC3B,OAA8B;IAE9B,6EAA6E;IAC7E,qEAAqE;IACrE,8EAA8E;IAC9E,2EAA2E;IAC3E,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;QAC1B,OAAO;YACL,MAAM,EAAE,UAAU;YAClB,UAAU,EAAE;gBACV,cAAc,EAAE,UAAU;gBAC1B,uBAAuB,EACrB,OAAO,EAAE,qBAAqB,CAAC,IAAI,EAAE;oBACrC,uCAA+B;aAClC;SACF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAC;IACzC,MAAM,IAAI,GAAG,MAAM,CAAC;IAEpB,OAAO;QACL,MAAM,EAAE,QAAQ;QAChB,UAAU,EAAE;YACV,cAAc,EAAE,QAAQ;YACxB,SAAS,EAAE,yBAAiB;YAC5B,kBAAkB,EAAE,kCAA0B;YAC9C,iBAAiB,EAAE,0BAAkB;YACrC,qBAAqB,EAAE,QAAQ;YAC/B,iBAAiB,EAAE,IAAI;SACxB;QACD,SAAS,EAAE,EAAE,IAAI,EAAE,0BAAkB,EAAE,QAAQ,EAAE,IAAI,EAAE;KACxD,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-ragen-app",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "private": false,
   "description": "Scaffold a self-hosted Ragen AI installation with one command",
   "license": "Apache-2.0",