create-absolutejs 0.15.2 → 0.15.3

package/dist/commands/formatProject.js

@@ -2,13 +2,15 @@ import { exit } from 'process';
 import { spinner } from '@clack/prompts';
 import { $ } from 'bun';
 import { green, red } from 'picocolors';
-import { formatCommands, formatNoInstallCommands } from '../utils/commandMaps';
+import { formatCommands } from '../utils/commandMaps';
 export const formatProject = async ({ projectName, packageManager, installDependenciesNow }) => {
+    // A no-install scaffold must be fully offline and must not assume a global
+    // formatter. Templates are already formatted in the published package.
+    if (!installDependenciesNow)
+        return;
     const spin = spinner();
     try {
-        const fmt = installDependenciesNow
-            ? formatCommands[packageManager]
-            : formatNoInstallCommands[packageManager];
+        const fmt = formatCommands[packageManager];
         spin.start('Formatting files…');
         const [bin, ...args] = fmt.split(' ');
         await $ `${bin} ${args}`.cwd(projectName).quiet();

package/dist/generators/configurations/generatePackageJson.d.ts

@@ -1,8 +1,8 @@
 import type { CreateConfiguration } from '../../types';
-type CreatePackageJsonProps = Pick<CreateConfiguration, 'authOption' | 'useTailwind' | 'databaseEngine' | 'databaseHost' | 'plugins' | 'orm' | 'frontendDirectories' | 'codeQualityTool'> & {
+type CreatePackageJsonProps = Pick<CreateConfiguration, 'authOption' | 'agentic' | 'useTailwind' | 'databaseEngine' | 'databaseHost' | 'plugins' | 'orm' | 'frontendDirectories' | 'codeQualityTool'> & {
     projectName: string;
     latest: boolean;
     repositoryUrl: string | undefined;
 };
-export declare const createPackageJson: ({ projectName, authOption, plugins, databaseEngine, orm, databaseHost, useTailwind, latest, frontendDirectories, codeQualityTool, repositoryUrl }: CreatePackageJsonProps) => Promise<void>;
+export declare const createPackageJson: ({ agentic, projectName, authOption, plugins, databaseEngine, orm, databaseHost, useTailwind, latest, frontendDirectories, codeQualityTool, repositoryUrl }: CreatePackageJsonProps) => Promise<void>;
 export {};

package/dist/generators/configurations/generatePackageJson.js

@@ -16,7 +16,7 @@ const dbClientCommands = {
     postgresql: 'psql -h localhost -U user -d database',
     singlestore: 'singlestore -u root -ppassword -D database'
 };
-export const createPackageJson = async ({ projectName, authOption, plugins, databaseEngine, orm, databaseHost, useTailwind, latest, frontendDirectories, codeQualityTool, repositoryUrl }) => {
+export const createPackageJson = async ({ agentic, projectName, authOption, plugins, databaseEngine, orm, databaseHost, useTailwind, latest, frontendDirectories, codeQualityTool, repositoryUrl }) => {
     const flags = computeFlags(frontendDirectories);
     const isLocal = !databaseHost || databaseHost === 'none';
     /* ── Collect all package names that need versions ─────────── */
@@ -28,6 +28,27 @@ export const createPackageJson = async ({ projectName, authOption, plugins, data
         packageNames.add(dep.value);
     if (authOption === 'abs')
         packageNames.add(absoluteAuthPlugin.value);
+    if (agentic) {
+        packageNames.add('@absolutejs/a2a');
+        packageNames.add('@absolutejs/agency');
+        packageNames.add('@absolutejs/agent-conformance');
+        packageNames.add('@absolutejs/agent-discovery');
+        packageNames.add('@absolutejs/agent-inbox');
+        packageNames.add('@absolutejs/agent-memory');
+        packageNames.add('@absolutejs/agent-runtime');
+        packageNames.add('@absolutejs/agent-sandbox');
+        packageNames.add('@absolutejs/agent-trust');
+        packageNames.add('@absolutejs/agent-control');
+        packageNames.add('@absolutejs/auth');
+        packageNames.add('@absolutejs/egress');
+        packageNames.add('@absolutejs/execution');
+        packageNames.add('@absolutejs/manifest');
+        packageNames.add('@absolutejs/mcp');
+        packageNames.add('@absolutejs/policy');
+        packageNames.add('@absolutejs/secrets');
+        packageNames.add('@absolutejs/sync-bus-pg');
+        packageNames.add('@absolutejs/wallet');
+    }
     for (const pluginValue of plugins) {
         const meta = availablePlugins.find((p) => p.value === pluginValue);
         if (meta)
@@ -122,6 +143,31 @@ export const createPackageJson = async ({ projectName, authOption, plugins, data
     if (authOption === 'abs') {
         dependencies[absoluteAuthPlugin.value] = resolveVersion(absoluteAuthPlugin.value, absoluteAuthPlugin.latestVersion);
     }
+    if (agentic) {
+        for (const name of [
+            '@absolutejs/a2a',
+            '@absolutejs/agency',
+            '@absolutejs/agent-discovery',
+            '@absolutejs/agent-inbox',
+            '@absolutejs/agent-memory',
+            '@absolutejs/agent-runtime',
+            '@absolutejs/agent-sandbox',
+            '@absolutejs/agent-trust',
+            '@absolutejs/agent-control',
+            '@absolutejs/auth',
+            '@absolutejs/egress',
+            '@absolutejs/execution',
+            '@absolutejs/manifest',
+            '@absolutejs/mcp',
+            '@absolutejs/policy',
+            '@absolutejs/secrets',
+            '@absolutejs/sync-bus-pg',
+            '@absolutejs/wallet'
+        ]) {
+            dependencies[name] = resolveVersion(name, versions[name]);
+        }
+        devDependencies['@absolutejs/agent-conformance'] = resolveVersion('@absolutejs/agent-conformance', versions['@absolutejs/agent-conformance']);
+    }
     for (const pluginValue of plugins) {
         const meta = availablePlugins.find((p) => p.value === pluginValue);
         if (!meta)

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

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

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/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,
@@ -53,6 +55,8 @@ export const scaffold = async ({ response: { projectName, codeQualityTool, initi
         publicDirectory: 'public',
         tailwind
     });
+    if (agentic)
+        scaffoldAgentic({ backendDirectory, projectName });
     let dockerFreshInstall = false;
     if (databaseDirectory !== undefined &&
         databaseEngine !== 'none' &&

package/dist/types.d.ts

@@ -43,6 +43,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,

package/dist/versions.d.ts

@@ -4,8 +4,26 @@
  * Run `bun run check-versions` to compare against latest npm versions.
  */
 export declare const versions: {
-    readonly '@absolutejs/absolute': "0.19.0-beta.1081";
-    readonly '@absolutejs/auth': "0.22.7";
+    readonly '@absolutejs/absolute': "0.19.0-beta.1099";
+    readonly '@absolutejs/a2a': "0.1.0";
+    readonly '@absolutejs/agency': "0.4.0";
+    readonly '@absolutejs/agent-conformance': "0.3.0";
+    readonly '@absolutejs/agent-discovery': "0.1.0";
+    readonly '@absolutejs/agent-inbox': "0.1.0";
+    readonly '@absolutejs/agent-memory': "0.1.0";
+    readonly '@absolutejs/agent-runtime': "0.1.0";
+    readonly '@absolutejs/agent-sandbox': "0.1.0";
+    readonly '@absolutejs/agent-trust': "0.1.0";
+    readonly '@absolutejs/agent-control': "0.1.0";
+    readonly '@absolutejs/auth': "0.54.9";
+    readonly '@absolutejs/egress': "0.1.0";
+    readonly '@absolutejs/execution': "0.2.0";
+    readonly '@absolutejs/manifest': "0.3.0";
+    readonly '@absolutejs/mcp': "0.9.0";
+    readonly '@absolutejs/policy': "0.2.0";
+    readonly '@absolutejs/secrets': "0.7.0";
+    readonly '@absolutejs/sync-bus-pg': "0.2.0";
+    readonly '@absolutejs/wallet': "0.3.0";
     readonly '@angular/common': "21.2.0";
     readonly '@angular/compiler': "21.2.0";
     readonly '@angular/compiler-cli': "21.2.0";
@@ -18,7 +36,7 @@ export declare const versions: {
     readonly '@elysiajs/static': "1.4.7";
     readonly '@elysiajs/swagger': "1.3.1";
     readonly '@eslint/compat': "2.0.2";
-    readonly '@eslint/js': "10.0.1";
+    readonly '@eslint/js': "9.39.2";
     readonly '@libsql/client': "0.17.0";
     readonly '@neondatabase/serverless': "1.0.2";
     readonly '@planetscale/database': "1.19.0";
@@ -33,7 +51,7 @@ export declare const versions: {
     readonly elysia: "1.4.28";
     readonly 'elysia-rate-limit': "4.5.0";
     readonly 'elysia-scoped-state': "0.1.1";
-    readonly eslint: "10.0.0";
+    readonly eslint: "9.39.2";
     readonly 'eslint-plugin-absolute': "0.11.13";
     readonly 'eslint-plugin-import': "2.32.0";
     readonly 'eslint-plugin-jsx-a11y': "6.10.2";

package/dist/versions.js

@@ -5,8 +5,26 @@
  */
 export const versions = {
     /* ── Core ─────────────────────────────────────────────── */
-    '@absolutejs/absolute': '0.19.0-beta.1081',
-    '@absolutejs/auth': '0.22.7',
+    '@absolutejs/absolute': '0.19.0-beta.1099',
+    '@absolutejs/a2a': '0.1.0',
+    '@absolutejs/agency': '0.4.0',
+    '@absolutejs/agent-conformance': '0.3.0',
+    '@absolutejs/agent-discovery': '0.1.0',
+    '@absolutejs/agent-inbox': '0.1.0',
+    '@absolutejs/agent-memory': '0.1.0',
+    '@absolutejs/agent-runtime': '0.1.0',
+    '@absolutejs/agent-sandbox': '0.1.0',
+    '@absolutejs/agent-trust': '0.1.0',
+    '@absolutejs/agent-control': '0.1.0',
+    '@absolutejs/auth': '0.54.9',
+    '@absolutejs/egress': '0.1.0',
+    '@absolutejs/execution': '0.2.0',
+    '@absolutejs/manifest': '0.3.0',
+    '@absolutejs/mcp': '0.9.0',
+    '@absolutejs/policy': '0.2.0',
+    '@absolutejs/secrets': '0.7.0',
+    '@absolutejs/sync-bus-pg': '0.2.0',
+    '@absolutejs/wallet': '0.3.0',
     /* ── Angular ─────────────────────────────────────────── */
     '@angular/common': '21.2.0',
     '@angular/compiler': '21.2.0',
@@ -22,7 +40,7 @@ export const versions = {
     '@elysiajs/swagger': '1.3.1',
     /* ── ESLint + Prettier ────────────────────────────────── */
     '@eslint/compat': '2.0.2',
-    '@eslint/js': '10.0.1',
+    '@eslint/js': '9.39.2',
     /* ── Database Hosts ───────────────────────────────────── */
     '@libsql/client': '0.17.0',
     '@neondatabase/serverless': '1.0.2',
@@ -42,7 +60,7 @@ export const versions = {
     elysia: '1.4.28',
     'elysia-rate-limit': '4.5.0',
     'elysia-scoped-state': '0.1.1',
-    eslint: '10.0.0',
+    eslint: '9.39.2',
     'eslint-plugin-absolute': '0.11.13',
     'eslint-plugin-import': '2.32.0',
     /* ── ESLint React ─────────────────────────────────────── */

package/package.json

@@ -54,5 +54,5 @@
 		"typecheck": "bun run tsc --noEmit"
 	},
 	"type": "module",
-	"version": "0.15.2"
+	"version": "0.15.3"
 }