create-absolutejs 0.15.2 → 0.15.4

package/dist/generators/project/scaffoldAgentic.js

@@ -0,0 +1,181 @@
+import { mkdirSync, writeFileSync } from 'fs';
+import { join } from 'path';
+export const agentRuntimeSource = `import {
+	createAgency,
+	createAgentControlPlane,
+	createMemoryAgencyStore,
+	createMemoryAgentControlStore,
+	denyAllPolicy
+} from '@absolutejs/agency'
+import {
+	createAgentRuntime,
+	createMemoryAgentRuntimeStore
+} from '@absolutejs/agent-runtime'
+
+// Memory stores are development defaults. Replace them with durable stores
+// before running more than one process or accepting production actions.
+export const agentControl = createAgentControlPlane({
+	sources: [],
+	store: createMemoryAgentControlStore()
+})
+
+// Intentionally deny-by-default. Replace denyAllPolicy() with your policy
+// decision point only after declaring each action's effects and scopes.
+export const agency = createAgency({
+	control: agentControl,
+	policy: denyAllPolicy(),
+	store: createMemoryAgencyStore()
+})
+
+// Durable run semantics are available from the first commit. The placeholder
+// driver fails closed until the application supplies its model/tool loop.
+export const agentRuntime = createAgentRuntime({
+	store: createMemoryAgentRuntimeStore(),
+	driver: {
+		next: async () => ({
+			type: 'fail',
+			code: 'agent_not_configured',
+			message: 'Configure the agent driver before accepting runs'
+		})
+	},
+	effects: {
+		execute: async () => {
+			throw new Error('Agent effects are not configured')
+		}
+	}
+})
+`;
+export const agentDiscoverySource = `import {
+	ABSOLUTE_AGENT_SCHEMA,
+	createAgentDiscoveryHandler,
+	signAgentDocument,
+	type AgentDiscoveryDocument,
+	type DiscoverySigner
+} from '@absolutejs/agent-discovery'
+
+// Keep this document specific and keyword-rich: registries rank declared
+// capabilities, effects, scopes, interfaces, examples, and publisher trust.
+export const createAgentDocument = ({
+	origin,
+	publishedAt,
+	version
+}: {
+	origin: string
+	publishedAt: string
+	version: string
+}): AgentDiscoveryDocument => ({
+	$schema: ABSOLUTE_AGENT_SCHEMA,
+	id: \`\${origin}/agents/main\`,
+	name: 'Replace with your agent name',
+	description: 'Replace with a precise description of the outcomes this agent delivers.',
+	version,
+	url: origin,
+	publisher: {
+		id: origin,
+		name: 'Replace with your organization',
+		jwksUri: \`\${origin}/.well-known/jwks.json\`
+	},
+	capabilities: [{
+		id: 'status.read',
+		title: 'Read service status',
+		description: 'Returns the public health and readiness status of this agent.',
+		tags: ['status', 'health', 'readiness'],
+		effects: ['read'],
+		approval: 'never'
+	}],
+	interfaces: [{
+		type: 'http',
+		url: \`\${origin}/api/agents/main\`,
+		contentTypes: ['application/json']
+	}],
+	categories: ['replace-with-domain-category'],
+	tags: ['replace-with-user-intent', 'replace-with-outcome'],
+	languages: ['en'],
+	documentationUrl: \`\${origin}/docs/agents/main\`,
+	examples: [{
+		title: 'Check whether the agent is ready',
+		prompt: 'Check the agent service status.',
+		capabilityId: 'status.read'
+	}],
+	createdAt: publishedAt,
+	updatedAt: publishedAt
+})
+
+// Use a KMS/HSM-backed signer in production. Mount the returned fetch handler
+// at the origin root so all well-known, A2A, JSON-LD, agents.txt, and sitemap
+// discovery surfaces are served from one signed descriptor.
+export const createAgentDiscovery = async ({
+	signer,
+	origin,
+	publishedAt,
+	version
+}: {
+	signer: DiscoverySigner
+	origin: string
+	publishedAt: string
+	version: string
+}) =>
+	createAgentDiscoveryHandler({
+		documents: [await signAgentDocument(
+			createAgentDocument({ origin, publishedAt, version }),
+			signer
+		)]
+	})
+`;
+export const agentsGuide = `# Agent execution contract
+
+This project uses the AbsoluteJS provider-neutral agent stack.
+
+- Authenticate agents and bind every delegation to a user with
+  \`@absolutejs/auth\`. Never treat model-provided identity as authenticated.
+- Route every effectful tool through \`agency\` in \`src/backend/agent.ts\`.
+  Approval is exact-input-bound; execution requires a fresh single-use lease.
+- Declare tool effects, scopes, approval policy, idempotency keys,
+  reversibility, destinations, and spend fields in manifest contract 2.
+- Keep raw credentials host-side with \`@absolutejs/secrets\` credential
+  operations. Agents receive operation results, never secret values.
+- Give agents bounded wallet allowances and signed mandates. The host resolves
+  ledger destinations; an agent never supplies the recipient account id.
+- Bind MCP task handles to the authenticated actor on get, update, and cancel.
+- Use \`@absolutejs/execution\` for idempotent effects and its transactional
+  PostgreSQL outbox before handing work to a durable queue.
+- Publish and consume remote agents with \`@absolutejs/a2a\` using A2A 1.0;
+  preserve the authenticated tenant and actor binding at every task boundary.
+- Route outbound HTTP through \`@absolutejs/egress\`. Authorize host, method,
+  resolved public IP, redirects, byte limits, and injected credentials host-side.
+- Store immutable, digest-addressed policy revisions with \`@absolutejs/policy\`
+  and atomically activate only reviewed versions.
+- Publish the signed descriptor in \`src/backend/agent-discovery.ts\` through
+  \`@absolutejs/agent-discovery\`. Keep capabilities, examples, tags, effects,
+  scopes, A2A/MCP interfaces, JSON-LD, agents.txt, and sitemap surfaces current.
+- Run long-lived work through \`@absolutejs/agent-runtime\`; use its leases,
+  checkpoints, timers, budgets, cancellation, and crash-safe effect recovery.
+- Authorize all HTTP/filesystem/process access with expiring
+  \`@absolutejs/agent-sandbox\` grants. There is no ambient agent authority.
+- Preserve instruction/data separation and provenance taints with
+  \`@absolutejs/agent-trust\`; external content never becomes an instruction.
+- Store scoped, expiring, provenance-bearing data with
+  \`@absolutejs/agent-memory\`, and validate writes against memory poisoning.
+- Receive only verified events through \`@absolutejs/agent-inbox\`; durable
+  leases, retries, dead letters, and schedules do not require Redis.
+- Use OpenID AuthZEN AARP for requestable approvals and COAZ mappings for
+  parameter-level MCP authorization. Approval always triggers re-evaluation.
+- Protect operator actions with \`@absolutejs/agent-control\` scopes, a
+  kill-switch-first check, and leased idempotency records.
+- Use \`@absolutejs/sync-bus-pg\` for durable framework channels. Redis is an
+  optional at-most-once fanout adapter, not a source of truth or work queue.
+- Run \`@absolutejs/agent-conformance\` suites for every new action, capability,
+  credential, wallet, egress, execution, control, and task adapter.
+- Use the control plane kill switch for incident response. It blocks new
+  requests, lease issuance, and execution before downstream revocation fans out.
+
+Memory stores are for local development only. Production stores must be
+durable and enforce lease/capability consumption atomically. Apply each
+package's exported PostgreSQL schema in a migration before enabling traffic.
+`;
+export const scaffoldAgentic = ({ backendDirectory, projectName }) => {
+    mkdirSync(backendDirectory, { recursive: true });
+    writeFileSync(join(backendDirectory, 'agent.ts'), agentRuntimeSource);
+    writeFileSync(join(backendDirectory, 'agent-discovery.ts'), agentDiscoverySource);
+    writeFileSync(join(projectName, 'AGENTS.md'), agentsGuide);
+};

package/dist/generators/project/scaffoldBackend.d.ts

@@ -2,6 +2,7 @@ import { CreateConfiguration } from '../../types';
 type ScaffoldBackendProps = Pick<CreateConfiguration, 'assetsDirectory' | 'absProviders' | 'authOption' | 'buildDirectory' | 'databaseEngine' | 'databaseHost' | 'frontendDirectories' | 'orm' | 'plugins' | 'tailwind'> & {
     backendDirectory: string;
     publicDirectory: string;
+    typesDirectory: string;
 };
-export declare const scaffoldBackend: ({ assetsDirectory, authOption, absProviders, backendDirectory, buildDirectory, databaseEngine, databaseHost, frontendDirectories, orm, plugins, publicDirectory, tailwind }: ScaffoldBackendProps) => void;
+export declare const scaffoldBackend: ({ assetsDirectory, authOption, absProviders, backendDirectory, buildDirectory, databaseEngine, databaseHost, frontendDirectories, orm, plugins, publicDirectory, tailwind, typesDirectory }: ScaffoldBackendProps) => void;
 export {};

package/dist/generators/project/scaffoldBackend.js

@@ -1,8 +1,8 @@
 import { mkdirSync, writeFileSync } from 'fs';
 import { join } from 'path';
-import { generateAbsoluteAuthConfig } from './generateAbsoluteAuthConfig';
+import { generateAbsoluteAuthConfig, generateSessionUserType } from './generateAbsoluteAuthConfig';
 import { generateServerFile } from './generateServer';
-export const scaffoldBackend = ({ assetsDirectory, authOption, absProviders, backendDirectory, buildDirectory, databaseEngine, databaseHost, frontendDirectories, orm, plugins, publicDirectory, tailwind }) => {
+export const scaffoldBackend = ({ assetsDirectory, authOption, absProviders, backendDirectory, buildDirectory, databaseEngine, databaseHost, frontendDirectories, orm, plugins, publicDirectory, tailwind, typesDirectory }) => {
     generateServerFile({
         assetsDirectory,
         authOption,
@@ -21,5 +21,13 @@ export const scaffoldBackend = ({ assetsDirectory, authOption, absProviders, bac
         const hasDatabase = databaseEngine !== undefined && databaseEngine !== 'none';
         const absoluteAuthConfig = generateAbsoluteAuthConfig(absProviders, hasDatabase);
         writeFileSync(join(backendDirectory, 'utils', 'absoluteAuthConfig.ts'), absoluteAuthConfig, 'utf-8');
+        /* The auth config and the example page both import `User` from
+           types/databaseTypes, which scaffoldDatabase only writes when there is
+           a database. Without one, emit the session user shape on its own so the
+           auth scaffold still type-checks. */
+        if (!hasDatabase) {
+            mkdirSync(typesDirectory, { recursive: true });
+            writeFileSync(join(typesDirectory, 'databaseTypes.ts'), generateSessionUserType(), 'utf-8');
+        }
     }
 };

package/dist/generators/project/scaffoldFrontends.js

@@ -40,6 +40,7 @@ export const scaffoldFrontends = ({ frontendDirectory, assetsDirectory, absProvi
                     absProviders,
                     assetsDirectory,
                     authOption,
+                    directory,
                     editBasePath,
                     frontends,
                     includeExamples,
@@ -56,6 +57,7 @@ export const scaffoldFrontends = ({ frontendDirectory, assetsDirectory, absProvi
                     absProviders,
                     assetsDirectory,
                     authOption,
+                    directory,
                     editBasePath,
                     frontends,
                     includeExamples,
@@ -72,6 +74,7 @@ export const scaffoldFrontends = ({ frontendDirectory, assetsDirectory, absProvi
                     absProviders,
                     assetsDirectory,
                     authOption,
+                    directory,
                     editBasePath,
                     frontends,
                     includeExamples,
@@ -88,6 +91,7 @@ export const scaffoldFrontends = ({ frontendDirectory, assetsDirectory, absProvi
                     absProviders,
                     assetsDirectory,
                     authOption,
+                    directory,
                     editBasePath,
                     frontends,
                     includeExamples,
@@ -104,6 +108,7 @@ export const scaffoldFrontends = ({ frontendDirectory, assetsDirectory, absProvi
                     absProviders,
                     assetsDirectory,
                     authOption,
+                    directory,
                     editBasePath,
                     frontends,
                     includeExamples,
@@ -121,6 +126,7 @@ export const scaffoldFrontends = ({ frontendDirectory, assetsDirectory, absProvi
                     absProviders,
                     assetsDirectory,
                     authOption,
+                    directory,
                     editBasePath,
                     frontends,
                     includeExamples,

package/dist/generators/react/generateReactComponents.d.ts

@@ -2,5 +2,5 @@ import { ProviderOption } from '@absolutejs/auth';
 import { AuthOption, Frontend } from '../../types';
 export declare const generateAppComponent: (frontends: Frontend[], editBasePath: string) => string;
 export declare const generateDropdownComponent: (frontends: Frontend[]) => string;
-export declare const generateReactExamplePage: (authOption: AuthOption, includeExamples: boolean) => string;
+export declare const generateReactExamplePage: (authOption: AuthOption, includeExamples: boolean, reactDirectory: string) => string;
 export declare const generateSignInComponent: (absProviders: ProviderOption[] | undefined) => string;

package/dist/generators/react/generateReactComponents.js

@@ -73,10 +73,14 @@ export const generateDropdownComponent = (frontends) => {
 );
 `;
 };
-export const generateReactExamplePage = (authOption, includeExamples) => {
+/* Pages live at `src/frontend/<reactDirectory>/pages`, but `reactDirectory` is
+   empty when React is the only frontend, which moves the page one level up. */
+const buildDatabaseTypesPath = (reactDirectory) => `${reactDirectory ? '../../../' : '../../'}types/databaseTypes`;
+export const generateReactExamplePage = (authOption, includeExamples, reactDirectory) => {
+    const databaseTypesPath = buildDatabaseTypesPath(reactDirectory);
     if (!includeExamples) {
         const authImports = authOption === 'abs'
-            ? `import type { User } from '../../../types/databaseTypes';\nimport type { ProviderConfiguration } from '@absolutejs/auth';\n`
+            ? `import type { User } from '${databaseTypesPath}';\nimport type { ProviderConfiguration } from '@absolutejs/auth';\n`
             : '';
         const authProps = authOption === 'abs'
             ? '\n\tuser: User | null;\n\tproviderConfiguration: ProviderConfiguration | undefined;'
@@ -146,7 +150,7 @@ export const ReactExample = ({ cssPath }: ReactExampleProps) => (
         : `<Dropdown />`;
     const closing = authOption === 'abs' ? `};` : `);`;
     return `
-${authOption === 'abs' ? `import type { User } from '../../../types/databaseTypes';\nimport { extractPropFromIdentity } from '@absolutejs/auth';\nimport type { ProviderConfiguration } from '@absolutejs/auth';` : ''}
+${authOption === 'abs' ? `import type { User } from '${databaseTypesPath}';\nimport { extractPropFromIdentity } from '@absolutejs/auth';\nimport type { ProviderConfiguration } from '@absolutejs/auth';` : ''}
 import { App } from '../components/App';
 import { Dropdown } from '../components/Dropdown';
 import { Head } from '../components/Head';

package/dist/generators/react/scaffoldReact.d.ts

@@ -1,2 +1,2 @@
 import { ScaffoldFrontendProps } from '../../types';
-export declare const scaffoldReact: ({ authOption, editBasePath, includeExamples, targetDirectory, templatesDirectory, frontends, projectAssetsDirectory, absProviders, stylesIndexesDirectory }: ScaffoldFrontendProps) => void;
+export declare const scaffoldReact: ({ authOption, directory, editBasePath, includeExamples, targetDirectory, templatesDirectory, frontends, projectAssetsDirectory, absProviders, stylesIndexesDirectory }: ScaffoldFrontendProps) => void;

package/dist/generators/react/scaffoldReact.js

@@ -1,20 +1,25 @@
 import { copyFileSync, cpSync, mkdirSync, writeFileSync } from 'fs';
-import { join } from 'path';
+import { basename, join } from 'path';
 import { generateMarkupCSS } from '../project/generateMarkupCSS';
 import { generateAppComponent, generateDropdownComponent, generateReactExamplePage, generateSignInComponent } from './generateReactComponents';
-export const scaffoldReact = ({ authOption, editBasePath, includeExamples, targetDirectory, templatesDirectory, frontends, projectAssetsDirectory, absProviders, stylesIndexesDirectory }) => {
+export const scaffoldReact = ({ authOption, directory, editBasePath, includeExamples, targetDirectory, templatesDirectory, frontends, projectAssetsDirectory, absProviders, stylesIndexesDirectory }) => {
     if (!includeExamples) {
         mkdirSync(join(targetDirectory, 'components'), { recursive: true });
         copyFileSync(join(templatesDirectory, 'react', 'components', 'Head.tsx'), join(targetDirectory, 'components', 'Head.tsx'));
         mkdirSync(join(targetDirectory, 'pages'), { recursive: true });
-        writeFileSync(join(targetDirectory, 'pages', 'ReactExample.tsx'), generateReactExamplePage(authOption, false), 'utf-8');
+        writeFileSync(join(targetDirectory, 'pages', 'ReactExample.tsx'), generateReactExamplePage(authOption, false, directory), 'utf-8');
         writeFileSync(join(stylesIndexesDirectory, 'react-example.css'), `@import url('../reset.css');`, 'utf-8');
         return;
     }
     mkdirSync(join(projectAssetsDirectory, 'svg'), { recursive: true });
     copyFileSync(join(templatesDirectory, 'assets', 'svg', 'react.svg'), join(projectAssetsDirectory, 'svg', 'react.svg'));
     copyFileSync(join(templatesDirectory, 'assets', 'svg', 'google-logo.svg'), join(projectAssetsDirectory, 'svg', 'google-logo.svg'));
+    /* `OAuthLink` is only rendered by the generated `SignIn` component, and it
+       types its provider against `citra`, which only ships as a transitive
+       dependency of `@absolutejs/auth`. Without Absolute Auth the import cannot
+       resolve, so the component is left out entirely. */
     cpSync(join(templatesDirectory, 'react'), targetDirectory, {
+        filter: (source) => authOption === 'abs' || basename(source) !== 'OAuthLink.tsx',
         recursive: true
     });
     const appComponent = generateAppComponent(frontends, editBasePath);
@@ -25,7 +30,7 @@ export const scaffoldReact = ({ authOption, editBasePath, includeExamples, targe
         const signInComponent = generateSignInComponent(absProviders);
         writeFileSync(join(targetDirectory, 'components', 'SignIn.tsx'), signInComponent, 'utf-8');
     }
-    const pageComponent = generateReactExamplePage(authOption, true);
+    const pageComponent = generateReactExamplePage(authOption, true, directory);
     mkdirSync(join(targetDirectory, 'pages'), { recursive: true });
     writeFileSync(join(targetDirectory, 'pages', 'ReactExample.tsx'), pageComponent, 'utf-8');
     const cssOutputFile = join(stylesIndexesDirectory, 'react-example.css');

package/dist/messages.d.ts

@@ -10,5 +10,5 @@ type DebugMessageProps = {
     response: CreateConfiguration;
     packageManager: string;
 };
-export declare const getDebugMessage: ({ response: { projectName, codeQualityTool, directoryConfig, useTailwind, tailwind, frontends, includeExamples, useHTMLScripts, frontendDirectories, buildDirectory, assetsDirectory, databaseEngine, databaseHost, databaseDirectory, orm, authOption, plugins, initializeGitNow, installDependenciesNow }, packageManager }: DebugMessageProps) => string;
+export declare const getDebugMessage: ({ response: { agentic, projectName, codeQualityTool, directoryConfig, useTailwind, tailwind, frontends, includeExamples, useHTMLScripts, frontendDirectories, buildDirectory, assetsDirectory, databaseEngine, databaseHost, databaseDirectory, orm, authOption, plugins, initializeGitNow, installDependenciesNow }, packageManager }: DebugMessageProps) => string;
 export {};

package/dist/messages.js

@@ -12,6 +12,7 @@ Options:
   ${cyan('--debug, -d')}                     Display a summary of the project configuration after creation
 
   ${cyan('--abs-provider')}                  A provider for Absolute-Auth (eg. 'google', 'github', 'discord') the full list is available at https://absolutejs.com/documentation/absolute-auth   
+  ${cyan('--agentic')}                       Add provider-neutral agent auth, actions, MCP, wallet, credential, and conformance scaffolding
   ${cyan('--angular')}                       Include an Angular frontend
   ${cyan('--angular-dir')} ${dim(cyan('<directory>'))}       Specify the directory for and use the Angular frontend
   ${cyan('--assets')} ${dim(cyan('<directory>'))}            Directory name for your static assets
@@ -49,7 +50,7 @@ export const getOutroMessage = ({ projectName, packageManager, installDependenci
     `${cyan('cd')} ${projectName}\n` +
     `${installDependenciesNow ? '' : `${cyan(`${packageManager} install`)}\n`}` +
     `${cyan(`${packageManager} dev`)}`; // TODO: Some package managers need run
-export const getDebugMessage = ({ response: { projectName, codeQualityTool, directoryConfig, useTailwind, tailwind, frontends, includeExamples, useHTMLScripts, frontendDirectories, buildDirectory, assetsDirectory, databaseEngine, databaseHost, databaseDirectory, orm, authOption, plugins, initializeGitNow, installDependenciesNow }, packageManager }) => {
+export const getDebugMessage = ({ response: { agentic, projectName, codeQualityTool, directoryConfig, useTailwind, tailwind, frontends, includeExamples, useHTMLScripts, frontendDirectories, buildDirectory, assetsDirectory, databaseEngine, databaseHost, databaseDirectory, orm, authOption, plugins, initializeGitNow, installDependenciesNow }, packageManager }) => {
     const htmlScriptingValue = useHTMLScripts
         ? blueBright('TypeScript')
         : dim('None');
@@ -63,6 +64,7 @@ export const getDebugMessage = ({ response: { projectName, codeQualityTool, dire
     /* prettier-ignore */
     const lines = [
         ['Project Name', projectName],
+        ['Agent-first Stack', agentic ? green('Yes') : dim('No')],
         ['Package Manager', packageManager],
         ['Config Type', isCustomConfig ? green('Custom') : dim('Default')],
         ['Linting', codeQualityTool === 'eslint+prettier' ? 'ESLint + Prettier' : 'Biome'],

package/dist/prompt.js

@@ -1,4 +1,5 @@
 import { getAuthOption } from './questions/authOption';
+import { getAgentic } from './questions/agentic';
 import { getCodeQualityTool } from './questions/codeQualityTool';
 import { getConfigurationType } from './questions/configurationType';
 import { getDatabaseEngine } from './questions/databaseEngine';
@@ -18,11 +19,14 @@ import { getUseTailwind } from './questions/useTailwind';
 import { orPrompt } from './utils/interactive';
 export const prompt = async (argumentConfiguration) => {
     // 1. Project name
-    const projectName = argumentConfiguration.projectName ?? (await orPrompt('a project name', getProjectName));
+    const projectName = argumentConfiguration.projectName ??
+        (await orPrompt('a project name', getProjectName));
     // 2. Linting/formatting tool
-    const codeQualityTool = argumentConfiguration.codeQualityTool ?? (await orPrompt('--eslint+prettier/--biome', getCodeQualityTool));
+    const codeQualityTool = argumentConfiguration.codeQualityTool ??
+        (await orPrompt('--eslint+prettier/--biome', getCodeQualityTool));
     // 3. Tailwind support?
-    const useTailwind = argumentConfiguration.useTailwind ?? (await orPrompt('--tailwind/--no-tailwind', getUseTailwind));
+    const useTailwind = argumentConfiguration.useTailwind ??
+        (await orPrompt('--tailwind/--no-tailwind', getUseTailwind));
     // 4. Frontend(s)
     const frontends = argumentConfiguration.frontends?.filter((frontend) => frontend !== undefined) ?? (await orPrompt('--react/--vue/--svelte/…', getFrontends));
     // 5. HTML scripting option (if HTML was selected)
@@ -31,18 +35,22 @@ export const prompt = async (argumentConfiguration) => {
             (await orPrompt('--html-scripts/--no-html-scripts', getHtmlScriptingOption)))
         : false;
     // 5b. Include example pages/components, or generate a bare skeleton
-    const includeExamples = argumentConfiguration.includeExamples ?? (await orPrompt('--examples/--no-examples', getIncludeExamples));
+    const includeExamples = argumentConfiguration.includeExamples ??
+        (await orPrompt('--examples/--no-examples', getIncludeExamples));
     // 6. Database engine
-    const databaseEngine = argumentConfiguration.databaseEngine ?? (await orPrompt('--db', getDatabaseEngine));
+    const databaseEngine = argumentConfiguration.databaseEngine ??
+        (await orPrompt('--db', getDatabaseEngine));
     // 7. Database host
     const databaseHost = argumentConfiguration.databaseHost ??
         (await orPrompt('--db-host', () => getDatabaseHost(databaseEngine)));
     // 8. ORM choice
     const orm = databaseEngine !== undefined && databaseEngine !== 'none'
-        ? (argumentConfiguration.orm ?? (await orPrompt('--orm', () => getORM(databaseEngine))))
+        ? (argumentConfiguration.orm ??
+            (await orPrompt('--orm', () => getORM(databaseEngine))))
         : undefined;
     // 9. Configuration type
-    let directoryConfig = argumentConfiguration.directoryConfig ?? (await orPrompt('--directory', getConfigurationType));
+    let directoryConfig = argumentConfiguration.directoryConfig ??
+        (await orPrompt('--directory', getConfigurationType));
     // 10. Directory configurations
     const { buildDirectory, assetsDirectory, tailwind, databaseDirectory } = await getDirectoryConfiguration({
         argumentConfiguration,
@@ -56,11 +64,16 @@ export const prompt = async (argumentConfiguration) => {
     if (argumentConfiguration.frontendDirectories !== undefined)
         directoryConfig = 'custom';
     // 12. Auth provider
-    const authOption = argumentConfiguration.authOption ?? (await orPrompt('--auth', getAuthOption));
+    const authOption = argumentConfiguration.authOption ??
+        (await orPrompt('--auth', getAuthOption));
+    // 12b. Agent-first action/auth/MCP/wallet/credential stack
+    const agentic = argumentConfiguration.agentic ??
+        (await orPrompt('--agentic/--no-agentic', getAgentic));
     // 13. Additional plugins
     const plugins = argumentConfiguration.plugins?.filter((plugin) => plugin !== undefined) ?? (await orPrompt('--plugin', getPlugins));
     // 14. Initialize Git repository
-    const initializeGitNow = argumentConfiguration.initializeGitNow ?? (await orPrompt('--git/--no-git', getInitializeGit));
+    const initializeGitNow = argumentConfiguration.initializeGitNow ??
+        (await orPrompt('--git/--no-git', getInitializeGit));
     // 14b. Optionally connect the new project to GitHub
     const resolveGithubLink = async () => {
         if (!initializeGitNow) {
@@ -84,6 +97,7 @@ export const prompt = async (argumentConfiguration) => {
     const installDependenciesNow = argumentConfiguration.installDependenciesNow ??
         (await orPrompt('--install/--no-install', getInstallDependencies));
     const values = {
+        agentic,
         absProviders: argumentConfiguration.absProviders?.filter((provider) => provider !== undefined),
         assetsDirectory,
         authOption,

package/dist/questions/agentic.d.ts

@@ -0,0 +1 @@
+export declare const getAgentic: () => Promise<boolean>;

package/dist/questions/agentic.js

@@ -0,0 +1,11 @@
+import { confirm, isCancel } from '@clack/prompts';
+import { abort } from '../utils/abort';
+export const getAgentic = async () => {
+    const agentic = await confirm({
+        initialValue: false,
+        message: 'Add the agent-first stack (auth, actions, MCP, wallet, credentials, and conformance)?'
+    });
+    if (isCancel(agentic))
+        abort();
+    return agentic;
+};

package/dist/scaffold.d.ts

@@ -5,7 +5,7 @@ type ScaffoldProps = {
     latest: boolean;
     envVariables: string[] | undefined;
 };
-export declare const scaffold: ({ response: { projectName, codeQualityTool, initializeGitNow, githubLink, githubRepoUrl, githubVisibility, databaseEngine, databaseHost, useHTMLScripts, useTailwind, databaseDirectory, absProviders, includeExamples, orm, frontends, plugins, authOption, buildDirectory, assetsDirectory, tailwind, installDependenciesNow, frontendDirectories }, latest, envVariables, packageManager }: ScaffoldProps) => Promise<{
+export declare const scaffold: ({ response: { agentic, projectName, codeQualityTool, initializeGitNow, githubLink, githubRepoUrl, githubVisibility, databaseEngine, databaseHost, useHTMLScripts, useTailwind, databaseDirectory, absProviders, includeExamples, orm, frontends, plugins, authOption, buildDirectory, assetsDirectory, tailwind, installDependenciesNow, frontendDirectories }, latest, envVariables, packageManager }: ScaffoldProps) => Promise<{
     dockerFreshInstall: boolean;
 }>;
 export {};

package/dist/scaffold.js

@@ -10,7 +10,8 @@ import { scaffoldConfigurationFiles } from './generators/configurations/scaffold
 import { scaffoldDatabase } from './generators/db/scaffoldDatabase';
 import { scaffoldBackend } from './generators/project/scaffoldBackend';
 import { scaffoldFrontends } from './generators/project/scaffoldFrontends';
-export const scaffold = async ({ response: { projectName, codeQualityTool, initializeGitNow, githubLink, githubRepoUrl, githubVisibility, databaseEngine, databaseHost, useHTMLScripts, useTailwind, databaseDirectory, absProviders, includeExamples, orm, frontends, plugins, authOption, buildDirectory, assetsDirectory, tailwind, installDependenciesNow, frontendDirectories }, latest, envVariables, packageManager }) => {
+import { scaffoldAgentic } from './generators/project/scaffoldAgentic';
+export const scaffold = async ({ response: { agentic, projectName, codeQualityTool, initializeGitNow, githubLink, githubRepoUrl, githubVisibility, databaseEngine, databaseHost, useHTMLScripts, useTailwind, databaseDirectory, absProviders, includeExamples, orm, frontends, plugins, authOption, buildDirectory, assetsDirectory, tailwind, installDependenciesNow, frontendDirectories }, latest, envVariables, packageManager }) => {
     const __dirname = dirname(fileURLToPath(import.meta.url));
     const templatesDirectory = join(__dirname, '/templates');
     const { frontendDirectory, backendDirectory, projectAssetsDirectory, typesDirectory } = initalizeRoot(projectName, templatesDirectory);
@@ -27,6 +28,7 @@ export const scaffold = async ({ response: { projectName, codeQualityTool, initi
         templatesDirectory
     });
     await createPackageJson({
+        agentic,
         authOption,
         codeQualityTool,
         databaseEngine,
@@ -51,8 +53,11 @@ export const scaffold = async ({ response: { projectName, codeQualityTool, initi
         orm,
         plugins,
         publicDirectory: 'public',
-        tailwind
+        tailwind,
+        typesDirectory
     });
+    if (agentic)
+        scaffoldAgentic({ backendDirectory, projectName });
     let dockerFreshInstall = false;
     if (databaseDirectory !== undefined &&
         databaseEngine !== 'none' &&

package/dist/types.d.ts

@@ -4,6 +4,9 @@ export type ScaffoldFrontendProps = {
     absProviders: ProviderOption[] | undefined;
     assetsDirectory: string;
     authOption: AuthOption;
+    /** Frontend's directory under `src/frontend`; empty when it is the only
+     *  frontend and no directory was configured for it. */
+    directory: string;
     editBasePath: string;
     includeExamples: boolean;
     targetDirectory: string;
@@ -43,6 +46,7 @@ export type TailwindConfig = {
 } | undefined;
 export type GithubLinkOption = 'existing' | 'create' | 'skip';
 export type CreateConfiguration = {
+    agentic: boolean;
     absProviders: ProviderOption[] | undefined;
     assetsDirectory: string;
     authOption: AuthOption;

package/dist/utils/parseCommandLineOptions.js

@@ -12,6 +12,7 @@ export const parseCommandLineOptions = () => {
         args: argv.slice(DEFAULT_ARG_LENGTH),
         options: {
             'abs-provider': { multiple: true, type: 'string' },
+            agentic: { type: 'boolean' },
             angular: { type: 'boolean' },
             'angular-dir': { type: 'string' },
             assets: { type: 'string' },
@@ -131,7 +132,9 @@ export const parseCommandLineOptions = () => {
         ? values.directory
         : // --skip defaults every prompted axis (headless callers hang on
             // missing ones).
-            (values.skip ? 'default' : undefined);
+            values.skip
+                ? 'default'
+                : undefined;
     if (values.directory !== undefined && directoryConfig === undefined) {
         errors.push(`Invalid directory configuration: "${values.directory}". Expected: [ ${availableDirectoryConfigurations.join(', ')} ]`);
     }
@@ -222,7 +225,8 @@ export const parseCommandLineOptions = () => {
     let tailwind = hasTailwindFiles
         ? { input: values['tailwind-input'], output: values['tailwind-output'] }
         : undefined;
-    const useTailwind = values.tailwind ?? (hasTailwindFiles ? true : undefined);
+    const useTailwind = values.tailwind ??
+        (hasTailwindFiles ? true : values.skip ? false : undefined);
     if (useTailwind === false && hasTailwindFiles) {
         console.warn('Warning: Tailwind CSS input/output files are specified but Tailwind is disabled.');
         tailwind = undefined;
@@ -250,6 +254,7 @@ export const parseCommandLineOptions = () => {
         ? repoVisibility
         : undefined;
     const argumentConfiguration = {
+        agentic: values.agentic ?? (values.skip ? false : undefined),
         absProviders: absProviders.length ? absProviders : undefined,
         assetsDirectory: values.assets,
         authOption,
@@ -260,15 +265,19 @@ export const parseCommandLineOptions = () => {
         databaseHost,
         directoryConfig,
         frontendDirectories,
-        frontends: selectedFrontends.length ? selectedFrontends : undefined,
+        frontends: selectedFrontends.length
+            ? selectedFrontends
+            : values.skip
+                ? []
+                : undefined,
         githubLink: isGithubLinkOption(values.github)
             ? values.github
             : undefined,
         githubRepoUrl: normalizeRepoInput(values.repo)?.httpsUrl,
         githubVisibility,
         includeExamples,
-        initializeGitNow: values.git,
-        installDependenciesNow: values.install,
+        initializeGitNow: values.git ?? (values.skip ? false : undefined),
+        installDependenciesNow: values.install ?? (values.skip ? false : undefined),
         orm,
         plugins,
         projectName,