@db3.ai/app 0.1.0-beta.1 → 0.1.0

package/src/ai/index.ts

@@ -1,5 +1,9 @@
 export * from './Ai';
+export type { AIServiceTier } from './contracts/AIServiceTier';
+export { chunkEmbeddingText } from './chunkEmbeddingText';
+export type { EmbeddingTextChunk, EmbeddingTextChunkOptions } from './contracts/EmbeddingTextChunk';
 export * from './AIErrors';
+export * from './AIRequestTrackingError';
 export * from './contracts/AI';
 export * from './AiConversation';
 export * from './AiMessage';
@@ -11,7 +15,7 @@ export * from './AIProviders';
 export * from './AIQuotaDeferredError';
 export * from './AIRateLimiter';
 export * from './Estimates';
-export * from './Models';
+export * from './modelPricing';
 export * from './OpenAIProviderError';
 export * from './ProviderCosts';
 export * from './Agent';
@@ -23,5 +27,8 @@ export * from './agentCitations';
 export * from './OpenAIQuotaRetry';
 export * from './ResponsesProviderCall';
 export { agentConversationTimeline } from './AgentHistory';
-export { tool, webSearchTool, fileSearchTool, imageGenerationTool } from '@openai/agents';
+export { tool, computerTool, type Computer, webSearchTool, fileSearchTool, imageGenerationTool } from '@openai/agents';
 export { INTERRUPTED_TOOL_CALL_MESSAGE, unresolvedToolCallIds } from './toolCallRecovery';
+export type { AIRequestErrorDiagnostics } from './contracts/AIRequestErrorDiagnostics';
+
+export * from './AIProviderAdmission';

package/src/ai/{Models.ts → modelPricing.ts}

@@ -2,15 +2,22 @@ import type { AIModelPricing, AIImageModelPricing, AIRequestCostUsage, AIRequest
 export type { AIModelPricing, AIImageModelPricing, AIRequestCostUsage, AIRequestCostUsageEntry, AIImageRequestCostUsage, AIHostedToolUsage, AIHostedToolCost } from './contracts/Pricing';
 
 /**
- * OpenAI Standard processing prices in USD, verified on 2026-09-11.
+ * OpenAI Standard processing prices in USD, verified on 2026-09-25.
  *
  * Used to estimate request cost at write time; stored historical costs are not
- * recalculated. Excludes regional processing surcharges and other service tiers.
+ * recalculated. Excludes regional processing surcharges. Tier multipliers were verified on 2026-10-08.
  *
  * @see https://developers.openai.com/api/docs/pricing
  */
 export const AI_MODEL_PRICING: Record<string, AIModelPricing> = {
+	// Default lightweight agent model; Standard rates verified on 2026-10-01.
+	'gpt-4.1-mini': {
+		inputUSDPer1M: 0.40,
+		cachedInputUSDPer1M: 0.10,
+		outputUSDPer1M: 1.60,
+	},
 	'gpt-6-astra': {
+		serviceTierMultipliers: { flex: 0.5, fast: 2, priority: 2 },
 		inputUSDPer1M: 10.00,
 		cachedInputUSDPer1M: 1.00,
 		outputUSDPer1M: 50.00,
@@ -19,8 +26,29 @@ export const AI_MODEL_PRICING: Record<string, AIModelPricing> = {
 		longContextInputMultiplier: 2,
 		longContextOutputMultiplier: 1.5,
 	},
+	'gpt-6-sol': {
+		serviceTierMultipliers: { flex: 0.5, fast: 2, priority: 2 },
+		inputUSDPer1M: 2.00,
+		cachedInputUSDPer1M: 0.20,
+		outputUSDPer1M: 10.00,
+		cacheWriteInputMultiplier: 1.25,
+		longContextInputTokenThreshold: 272_000,
+		longContextInputMultiplier: 2,
+		longContextOutputMultiplier: 1.5,
+	},
+	'gpt-6-luna': {
+		serviceTierMultipliers: { flex: 0.5, fast: 2, priority: 2 },
+		inputUSDPer1M: 0.10,
+		cachedInputUSDPer1M: 0.01,
+		outputUSDPer1M: 0.50,
+		cacheWriteInputMultiplier: 1.25,
+		longContextInputTokenThreshold: 272_000,
+		longContextInputMultiplier: 2,
+		longContextOutputMultiplier: 1.5,
+	},
 	// Promotional rates available at least through 2026-11-21; recheck before changing.
 	'gpt-5.6-sol': {
+		serviceTierMultipliers: { flex: 0.5, fast: 2, priority: 2 },
 		inputUSDPer1M: 4.00,
 		cachedInputUSDPer1M: 0.40,
 		outputUSDPer1M: 20.00,
@@ -30,6 +58,7 @@ export const AI_MODEL_PRICING: Record<string, AIModelPricing> = {
 		longContextOutputMultiplier: 1.5,
 	},
 	'gpt-5.6-terra': {
+		serviceTierMultipliers: { flex: 0.5, fast: 2, priority: 2 },
 		inputUSDPer1M: 2.00,
 		cachedInputUSDPer1M: 0.20,
 		outputUSDPer1M: 12.00,
@@ -39,6 +68,7 @@ export const AI_MODEL_PRICING: Record<string, AIModelPricing> = {
 		longContextOutputMultiplier: 1.5,
 	},
 	'gpt-5.6-luna': {
+		serviceTierMultipliers: { flex: 0.5, fast: 2, priority: 2 },
 		inputUSDPer1M: 0.20,
 		cachedInputUSDPer1M: 0.02,
 		outputUSDPer1M: 1.20,
@@ -159,6 +189,9 @@ export function calculateAIRequestCostUSD(
 	const pricing = AI_MODEL_PRICING[canonicalModelName(model)];
 
 	if (!pricing) return null;
+	const tier = usage.serviceTier === undefined ? 'default' : usage.serviceTier;
+	const tierMultiplier = tier === 'default' ? 1 : tier === 'flex' || tier === 'fast' || tier === 'priority' ? pricing.serviceTierMultipliers?.[tier] : undefined;
+	if (tierMultiplier === undefined) return null;
 	if (!validTokenCount(usage.inputTokens)) return null;
 	if (pricing.outputUSDPer1M !== null && !validTokenCount(usage.outputTokens)) return null;
 
@@ -189,7 +222,7 @@ export function calculateAIRequestCostUSD(
 		+ (cachedTokens * cachedInputRate)
 		+ (cacheWriteTokens * cacheWriteInputRate)
 		+ (outputTokens * outputRate)
-	) / TOKENS_PER_PRICING_UNIT;
+	) * tierMultiplier / TOKENS_PER_PRICING_UNIT;
 
 	return Math.round(cost * COST_PRECISION) / COST_PRECISION;
 }
@@ -213,7 +246,7 @@ export function calculateAIRequestEntriesCostUSD(
 	let cost = 0;
 
 	for (const entry of entries) {
-		const entryCost = calculateAIRequestCostUSD(model, entry);
+		const entryCost = calculateAIRequestCostUSD(entry.model ?? model, entry);
 
 		if (entryCost === null) return null;
 

package/src/apps/AppInstallation.ts

@@ -0,0 +1,25 @@
+import { ActiveRecord, type FieldBuilder } from '../db';
+import type { AppDescription, AppInstallationState } from './contracts';
+
+/** Framework-owned record retained after code removal; business tables and migration ledgers stay separate. */
+export class AppInstallation extends ActiveRecord {
+	static override table = 'db3_apps';
+
+	/** Defines durable installation identity, desired state and retained ownership evidence. */
+	static override fields(field: FieldBuilder) {
+		return {
+			id: field.ulid(),
+			appId: field.string({ column: 'app_id', required: true, length: 48, unique: true }),
+			version: field.string({ required: true, length: 64 }),
+			state: field.string({ required: true, length: 24 }),
+			description: field.json<AppDescription>({ required: true }),
+			migrationHashes: field.json<Record<string, string>>({ column: 'migration_hashes', required: true }),
+		};
+	}
+	declare id: string | null;
+	declare appId: string;
+	declare version: string;
+	declare state: AppInstallationState;
+	declare description: AppDescription;
+	declare migrationHashes: Record<string, string>;
+}

package/src/apps/AppRouteError.ts

@@ -0,0 +1,8 @@
+/** Deliberately public HTTP failure from an app route. Other errors remain private to server logs. */
+export class AppRouteError extends Error {
+	/** Creates a safe client-facing error; use only for expected validation and access failures. */
+	constructor(readonly statusCode: 400 | 401 | 403 | 404 | 409 | 503, message: string) {
+		super(message);
+		this.name = 'AppRouteError';
+	}
+}

package/src/apps/AppService.ts

@@ -0,0 +1,30 @@
+import type { ActiveRecordClass } from '../db';
+import type { QueueableJobClass } from '../queue';
+import type { Schedule } from '../scheduler';
+import type { App as HostApp } from '../server/App';
+import type { AppNavigation, AppNavigationContext, AppRoute, AppStartContext } from './contracts';
+
+/** Base for a discovered app's root App.ts. The instance is exposed as app().social, for example. */
+export class AppService {
+	static models: readonly ActiveRecordClass[] = [];
+	static routes: readonly AppRoute<any>[] = [];
+	static jobs: readonly QueueableJobClass[] = [];
+
+	/** Receives the existing host; an installed app never creates a second framework runtime. */
+	constructor(protected readonly host: HostApp) {}
+
+	/** Computes navigation for this viewer. Undefined uses manifest links; null hides the app. Keep viewer data off this shared instance. */
+	async navigation(_context: AppNavigationContext): Promise<AppNavigation | null | undefined> { return undefined; }
+
+	/** Declares recurring work during boot. Delegate to the app's schedule.ts; declarations must be synchronous. */
+	schedule(_schedule: Schedule): void {}
+
+	/** Starts resources after dependencies are ready. Register cleanup immediately using context.defer. */
+	async start(_context: AppStartContext<this>): Promise<void> {}
+
+	/** Runs after migrations on every install or upgrade. Implementations must tolerate retries. */
+	async install(): Promise<void> {}
+
+	/** Checks and releases durable app-specific registrations. Database tables are retained by default. */
+	async uninstall(): Promise<void> {}
+}