feat(kernel): add preview runtime mode with auto-login and simulated identity

Revert marketplace changes (misunderstanding). Instead, add 'preview' to
RuntimeMode enum and PreviewModeConfigSchema to KernelContextSchema.
This allows the kernel to signal preview mode to the frontend, bypassing
auth screens and simulating an admin identity for demos.

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Author: Copilot

packages/spec/src/cloud/app-store.test.ts

@@ -14,10 +14,6 @@ import {
   InstalledAppSummarySchema,
   ListInstalledAppsRequestSchema,
   ListInstalledAppsResponseSchema,
-  PreviewRequestSchema,
-  PreviewObjectSummarySchema,
-  PreviewViewSummarySchema,
-  PreviewResponseSchema,
 } from './app-store.zod';
 
 describe('ReviewModerationStatusSchema', () => {
@@ -392,180 +388,3 @@ describe('ListInstalledAppsResponseSchema', () => {
     expect(parsed.total).toBe(1);
   });
 });
-
-// ==========================================
-// Preview / Demo Mode Tests
-// ==========================================
-
-describe('PreviewRequestSchema', () => {
-  it('should accept minimal preview request', () => {
-    const request = { listingId: 'listing-001' };
-    const parsed = PreviewRequestSchema.parse(request);
-    expect(parsed.listingId).toBe('listing-001');
-    expect(parsed.version).toBeUndefined();
-    expect(parsed.includeContent).toBeUndefined();
-  });
-
-  it('should accept preview request with specific version and content types', () => {
-    const request = {
-      listingId: 'listing-001',
-      version: '2.0.0',
-      includeContent: ['objects', 'views', 'sample_data'] as const,
-    };
-    const parsed = PreviewRequestSchema.parse(request);
-    expect(parsed.version).toBe('2.0.0');
-    expect(parsed.includeContent).toHaveLength(3);
-    expect(parsed.includeContent).toContain('objects');
-  });
-
-  it('should accept all valid content types', () => {
-    const request = {
-      listingId: 'listing-001',
-      includeContent: ['objects', 'views', 'dashboards', 'flows', 'sample_data', 'navigation'] as const,
-    };
-    const parsed = PreviewRequestSchema.parse(request);
-    expect(parsed.includeContent).toHaveLength(6);
-  });
-
-  it('should reject invalid content type', () => {
-    const request = {
-      listingId: 'listing-001',
-      includeContent: ['invalid_type'],
-    };
-    expect(() => PreviewRequestSchema.parse(request)).toThrow();
-  });
-});
-
-describe('PreviewObjectSummarySchema', () => {
-  it('should accept object summary with fields', () => {
-    const summary = {
-      name: 'lead',
-      label: 'Lead',
-      fieldCount: 3,
-      fields: [
-        { name: 'first_name', label: 'First Name', type: 'text' },
-        { name: 'email', label: 'Email', type: 'text' },
-        { name: 'status', label: 'Status', type: 'select' },
-      ],
-    };
-    const parsed = PreviewObjectSummarySchema.parse(summary);
-    expect(parsed.name).toBe('lead');
-    expect(parsed.fieldCount).toBe(3);
-    expect(parsed.fields).toHaveLength(3);
-  });
-
-  it('should accept object summary without fields', () => {
-    const summary = {
-      name: 'account',
-      label: 'Account',
-      fieldCount: 15,
-    };
-    const parsed = PreviewObjectSummarySchema.parse(summary);
-    expect(parsed.fields).toBeUndefined();
-  });
-});
-
-describe('PreviewViewSummarySchema', () => {
-  it('should accept list view summary', () => {
-    const summary = {
-      name: 'all_leads',
-      label: 'All Leads',
-      type: 'list' as const,
-      objectName: 'lead',
-    };
-    const parsed = PreviewViewSummarySchema.parse(summary);
-    expect(parsed.type).toBe('list');
-  });
-
-  it('should accept form view summary', () => {
-    const summary = {
-      name: 'lead_form',
-      label: 'Lead Form',
-      type: 'form' as const,
-      objectName: 'lead',
-    };
-    const parsed = PreviewViewSummarySchema.parse(summary);
-    expect(parsed.type).toBe('form');
-  });
-
-  it('should reject invalid view type', () => {
-    expect(() => PreviewViewSummarySchema.parse({
-      name: 'test',
-      label: 'Test',
-      type: 'invalid',
-      objectName: 'test',
-    })).toThrow();
-  });
-});
-
-describe('PreviewResponseSchema', () => {
-  it('should accept minimal preview response', () => {
-    const response = {
-      listingId: 'listing-001',
-      name: 'Acme CRM',
-      version: '2.0.0',
-    };
-    const parsed = PreviewResponseSchema.parse(response);
-    expect(parsed.listingId).toBe('listing-001');
-    expect(parsed.objects).toBeUndefined();
-    expect(parsed.views).toBeUndefined();
-  });
-
-  it('should accept full preview response with all content', () => {
-    const response = {
-      listingId: 'listing-001',
-      name: 'Acme CRM',
-      version: '2.0.0',
-      demoUrl: 'https://demo.acme.com/crm',
-      objects: [
-        { name: 'lead', label: 'Lead', fieldCount: 10, fields: [
-          { name: 'first_name', label: 'First Name', type: 'text' },
-        ]},
-        { name: 'account', label: 'Account', fieldCount: 8 },
-      ],
-      views: [
-        { name: 'all_leads', label: 'All Leads', type: 'list' as const, objectName: 'lead' },
-        { name: 'lead_form', label: 'Lead Form', type: 'form' as const, objectName: 'lead' },
-      ],
-      dashboards: [
-        { name: 'sales_overview', label: 'Sales Overview' },
-      ],
-      flows: [
-        { name: 'lead_assignment', label: 'Lead Assignment', type: 'autolaunched' },
-      ],
-      navigation: [
-        { id: 'nav_leads', label: 'Leads', type: 'object' },
-        { id: 'nav_dashboard', label: 'Dashboard', type: 'dashboard' },
-      ],
-      sampleData: {
-        lead: 50,
-        account: 20,
-      },
-      expiresAt: '2025-06-01T12:00:00Z',
-    };
-    const parsed = PreviewResponseSchema.parse(response);
-    expect(parsed.objects).toHaveLength(2);
-    expect(parsed.views).toHaveLength(2);
-    expect(parsed.dashboards).toHaveLength(1);
-    expect(parsed.flows).toHaveLength(1);
-    expect(parsed.navigation).toHaveLength(2);
-    expect(parsed.sampleData?.lead).toBe(50);
-    expect(parsed.demoUrl).toBe('https://demo.acme.com/crm');
-    expect(parsed.expiresAt).toBe('2025-06-01T12:00:00Z');
-  });
-
-  it('should accept preview response with only objects', () => {
-    const response = {
-      listingId: 'listing-001',
-      name: 'Acme Utils',
-      version: '1.0.0',
-      objects: [
-        { name: 'task', label: 'Task', fieldCount: 5 },
-      ],
-    };
-    const parsed = PreviewResponseSchema.parse(response);
-    expect(parsed.objects).toHaveLength(1);
-    expect(parsed.views).toBeUndefined();
-    expect(parsed.dashboards).toBeUndefined();
-  });
-});

packages/spec/src/cloud/app-store.zod.ts

@@ -376,139 +376,6 @@ export const ListInstalledAppsResponseSchema = z.object({
   pageSize: z.number().int().min(1),
 });
 
-// ==========================================
-// Preview / Demo Mode (No Login Required)
-// ==========================================
-
-/**
- * Preview Request Schema
- *
- * Allows customers to request a preview of a marketplace listing's content
- * without registration or login. Analogous to Salesforce AppExchange
- * "Test Drive" or Shopify App Store live demo.
- *
- * ## Use Case
- * A marketplace visitor wants to evaluate a package before committing
- * to install. They can browse object definitions, view layouts, sample
- * data, and navigation structure — all without authentication.
- */
-export const PreviewRequestSchema = z.object({
-  /** Listing ID to preview */
-  listingId: z.string().describe('Marketplace listing ID to preview'),
-
-  /** Specific version to preview (defaults to latest) */
-  version: z.string().optional().describe('Version to preview (defaults to latest)'),
-
-  /**
-   * Content types to include in the preview response.
-   * If omitted, returns all content types enabled by the publisher.
-   */
-  includeContent: z.array(z.enum([
-    'objects',       // Object definitions (fields, relationships)
-    'views',         // List and form view definitions
-    'dashboards',    // Dashboard layouts
-    'flows',         // Automation flow definitions
-    'sample_data',   // Seed/demo data
-    'navigation',    // App navigation structure
-  ])).optional()
-    .describe('Content types to include (defaults to all enabled by publisher)'),
-});
-
-/**
- * Preview Object Summary — a read-only snapshot of an object definition
- */
-export const PreviewObjectSummarySchema = z.object({
-  /** Object name (snake_case) */
-  name: z.string().describe('Object machine name'),
-
-  /** Display label */
-  label: z.string().describe('Object display label'),
-
-  /** Number of fields */
-  fieldCount: z.number().int().min(0).describe('Total field count'),
-
-  /** Field summaries (name + type + label) */
-  fields: z.array(z.object({
-    name: z.string().describe('Field machine name'),
-    label: z.string().describe('Field display label'),
-    type: z.string().describe('Field type (text, number, lookup, etc.)'),
-  })).optional().describe('Field summaries'),
-});
-
-/**
- * Preview View Summary — a read-only snapshot of a view definition
- */
-export const PreviewViewSummarySchema = z.object({
-  /** View name */
-  name: z.string().describe('View name'),
-
-  /** Display label */
-  label: z.string().describe('View display label'),
-
-  /** View type (list or form) */
-  type: z.enum(['list', 'form']).describe('View type'),
-
-  /** Target object name */
-  objectName: z.string().describe('Target object name'),
-});
-
-/**
- * Preview Response Schema
- *
- * A read-only snapshot of the package contents for evaluation.
- * No authentication required to receive this response.
- */
-export const PreviewResponseSchema = z.object({
-  /** Listing ID */
-  listingId: z.string().describe('Marketplace listing ID'),
-
-  /** Package display name */
-  name: z.string().describe('Package display name'),
-
-  /** Version being previewed */
-  version: z.string().describe('Version being previewed'),
-
-  /** External demo URL (if available) */
-  demoUrl: z.string().url().optional()
-    .describe('External demo URL for live interactive preview'),
-
-  /** Object definitions included in the package */
-  objects: z.array(PreviewObjectSummarySchema).optional()
-    .describe('Object definitions'),
-
-  /** View definitions included in the package */
-  views: z.array(PreviewViewSummarySchema).optional()
-    .describe('View definitions'),
-
-  /** Dashboard names included in the package */
-  dashboards: z.array(z.object({
-    name: z.string(),
-    label: z.string(),
-  })).optional().describe('Dashboard summaries'),
-
-  /** Flow/automation names included in the package */
-  flows: z.array(z.object({
-    name: z.string(),
-    label: z.string(),
-    type: z.string().describe('Flow type (autolaunched, screen, schedule, etc.)'),
-  })).optional().describe('Automation flow summaries'),
-
-  /** Navigation structure */
-  navigation: z.array(z.object({
-    id: z.string(),
-    label: z.string(),
-    type: z.string().describe('Navigation item type'),
-  })).optional().describe('Navigation structure'),
-
-  /** Sample data record counts by object */
-  sampleData: z.record(z.string(), z.number().int().min(0)).optional()
-    .describe('Sample data record counts keyed by object name'),
-
-  /** Preview session expiration (if applicable) */
-  expiresAt: z.string().datetime().optional()
-    .describe('Preview session expiration timestamp'),
-});
-
 // ==========================================
 // Export Types
 // ==========================================
@@ -527,7 +394,3 @@ export type AppSubscription = z.infer<typeof AppSubscriptionSchema>;
 export type InstalledAppSummary = z.infer<typeof InstalledAppSummarySchema>;
 export type ListInstalledAppsRequest = z.infer<typeof ListInstalledAppsRequestSchema>;
 export type ListInstalledAppsResponse = z.infer<typeof ListInstalledAppsResponseSchema>;
-export type PreviewRequest = z.infer<typeof PreviewRequestSchema>;
-export type PreviewObjectSummary = z.infer<typeof PreviewObjectSummarySchema>;
-export type PreviewViewSummary = z.infer<typeof PreviewViewSummarySchema>;
-export type PreviewResponse = z.infer<typeof PreviewResponseSchema>;

packages/spec/src/cloud/marketplace.test.ts

@@ -167,55 +167,6 @@ describe('MarketplaceListingSchema', () => {
     };
     expect(() => MarketplaceListingSchema.parse(listing)).toThrow();
   });
-
-  it('should accept listing with preview mode enabled', () => {
-    const listing = {
-      id: 'listing-002',
-      packageId: 'com.acme.crm',
-      publisherId: 'pub-001',
-      name: 'Acme CRM',
-      category: 'crm' as const,
-      latestVersion: '1.0.0',
-      preview: {
-        enabled: true,
-        demoUrl: 'https://demo.acme.com/crm',
-        includedContent: ['objects', 'views', 'navigation'],
-        expiresInSeconds: 3600,
-      },
-    };
-    const parsed = MarketplaceListingSchema.parse(listing);
-    expect(parsed.preview?.enabled).toBe(true);
-    expect(parsed.preview?.demoUrl).toBe('https://demo.acme.com/crm');
-    expect(parsed.preview?.includedContent).toHaveLength(3);
-    expect(parsed.preview?.expiresInSeconds).toBe(3600);
-  });
-
-  it('should default preview.enabled to false', () => {
-    const listing = {
-      id: 'listing-003',
-      packageId: 'com.acme.utils',
-      publisherId: 'pub-001',
-      name: 'Acme Utils',
-      category: 'other' as const,
-      latestVersion: '1.0.0',
-      preview: {},
-    };
-    const parsed = MarketplaceListingSchema.parse(listing);
-    expect(parsed.preview?.enabled).toBe(false);
-  });
-
-  it('should accept listing without preview (optional)', () => {
-    const listing = {
-      id: 'listing-004',
-      packageId: 'com.acme.tools',
-      publisherId: 'pub-001',
-      name: 'Acme Tools',
-      category: 'other' as const,
-      latestVersion: '1.0.0',
-    };
-    const parsed = MarketplaceListingSchema.parse(listing);
-    expect(parsed.preview).toBeUndefined();
-  });
 });
 
 describe('PackageSubmissionSchema', () => {