@vgai/sdk 0.5.4 → 0.5.6

package/package.json

@@ -2,7 +2,7 @@
   "name": "@vgai/sdk",
   "author": "Volter AI, Inc.",
   "license": "Apache-2.0",
-  "version": "0.5.4",
+  "version": "0.5.6",
   "type": "module",
   "repository": {
     "type": "git",
@@ -18,16 +18,19 @@
   "exports": {
     ".": "./src/index.ts",
     "./account": "./src/account.ts",
+    "./build-discipline": "./src/project/build-discipline.ts",
     "./generations": "./src/generations.ts",
     "./mcp-stdio": "./src/mcp/mcp-stdio-server.ts",
     "./project-tool-catalog": "./src/project-tool-catalog.ts",
     "./project-inspection-node": "./src/project/inspection-node.ts",
     "./registry": "./src/registry.ts",
+    "./run-name": "./src/project/run-name.ts",
+    "./session-journal": "./src/project/session-journal.ts",
     "./tools": "./src/tools.ts"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "@vgai/engine": "0.5.4",
+    "@vgai/engine": "0.5.6",
     "playwright": "^1.58.2",
     "zod": "^4.3.6"
   }

package/src/account.ts

@@ -32,6 +32,13 @@ export const AccountSpendPolicySchema = z.object({
     })
     .optional(),
 });
+export const AccountAlertSchema = z.object({
+  id: z.string().min(1),
+  kind: z.enum(['threshold', 'auto_reload_succeeded', 'auto_reload_failed']),
+  message: z.string().min(1),
+  createdAt: z.string().datetime(),
+  readAt: z.string().datetime().optional(),
+});
 export const AccountUserSchema = z.object({
   id: z.string().min(1),
   email: z.string().email(),
@@ -57,13 +64,46 @@ export const AccountOrganizationSchema = z.object({
 export const AccountUsageEntrySchema = z.object({
   id: z.string().min(1),
   occurredAt: z.string().datetime(),
-  kind: z.literal('generation'),
+  kind: z.enum(['inference', 'generation', 'workspace', 'storage', 'relay', 'deployment']),
   provider: z.string().min(1),
   operation: z.string().optional(),
   credits: z.number().nonnegative(),
   state: z.enum(['reserved', 'settled', 'released']),
   externalId: z.string().optional(),
 });
+export const AccountPlanIdSchema = z.enum(['free', 'creator', 'max', 'ultra']);
+export const AccountCatalogSchema = z.object({
+  plans: z.object({
+    free: z.object({
+      name: z.string().min(1),
+      includedCredits: z.number().int().nonnegative(),
+      monthlyPriceUsd: z.number().nonnegative().optional(),
+    }),
+    creator: z.object({
+      name: z.string().min(1),
+      includedCredits: z.number().int().nonnegative(),
+      monthlyPriceUsd: z.number().nonnegative().optional(),
+    }),
+    max: z.object({
+      name: z.string().min(1),
+      includedCredits: z.number().int().nonnegative(),
+      monthlyPriceUsd: z.number().nonnegative().optional(),
+    }),
+    ultra: z.object({
+      name: z.string().min(1),
+      includedCredits: z.number().int().nonnegative(),
+      monthlyPriceUsd: z.number().nonnegative().optional(),
+    }),
+  }),
+  creditPacks: z.record(
+    z.string().min(1),
+    z.object({
+      name: z.string().min(1),
+      credits: z.number().int().positive(),
+      expiresInDays: z.number().int().positive().optional(),
+    }),
+  ),
+});
 export const AccountSnapshotSchema = z.discriminatedUnion('authenticated', [
   z.object({ authenticated: z.literal(false), backend: AccountBackendSchema }),
   z.object({
@@ -74,6 +114,7 @@ export const AccountSnapshotSchema = z.discriminatedUnion('authenticated', [
     plan: AccountPlanSchema,
     credits: AccountCreditsSchema,
     spendPolicy: AccountSpendPolicySchema,
+    alerts: z.array(AccountAlertSchema).max(100).optional(),
     entitlements: z.object({
       generation: z.boolean(),
       dailyJobs: z.number().int().positive().optional(),
@@ -83,7 +124,12 @@ export const AccountSnapshotSchema = z.discriminatedUnion('authenticated', [
 /** Product-facing routes. Provider tools may translate BYOK to their native
  * transport name (`direct`) internally. */
 export const GenerationExecutionRouteSchema = z.enum(['mock', 'managed', 'byok']);
-export const ProviderCredentialIdSchema = z.enum(['fal', 'tripo', 'worldlabs']);
+export const ProviderCredentialIdSchema = z.enum(['fal', 'tripo', 'worldlabs', 'openrouter']);
+export const CodingInferenceSettingsSchema = z.object({
+  enabled: z.boolean(),
+  provider: z.literal('openrouter'),
+  model: z.string().trim().min(1).max(256),
+});
 export const ProviderCredentialSourceSchema = z.enum(['environment', 'system', 'session', 'none']);
 export const ProviderCredentialStatusSchema = z.object({
   provider: ProviderCredentialIdSchema,
@@ -106,21 +152,29 @@ export type AccountBackend = z.infer<typeof AccountBackendSchema>;
 export type AccountPlan = z.infer<typeof AccountPlanSchema>;
 export type AccountCredits = z.infer<typeof AccountCreditsSchema>;
 export type AccountSpendPolicy = z.infer<typeof AccountSpendPolicySchema>;
+export type AccountAlert = z.infer<typeof AccountAlertSchema>;
 export type AccountUser = z.infer<typeof AccountUserSchema>;
 export type AccountOrganization = z.infer<typeof AccountOrganizationSchema>;
 export type AccountOrganizationDomain = z.infer<typeof AccountOrganizationDomainSchema>;
 export type AccountUsageEntry = z.infer<typeof AccountUsageEntrySchema>;
+export type AccountPlanId = z.infer<typeof AccountPlanIdSchema>;
+export type AccountCatalog = z.infer<typeof AccountCatalogSchema>;
 export type AccountSnapshot = z.infer<typeof AccountSnapshotSchema>;
 export type GenerationExecutionRoute = z.infer<typeof GenerationExecutionRouteSchema>;
+export type CodingInferenceSettings = z.infer<typeof CodingInferenceSettingsSchema>;
 export type ProviderCredentialId = z.infer<typeof ProviderCredentialIdSchema>;
 export type ProviderCredentialSource = z.infer<typeof ProviderCredentialSourceSchema>;
 export type ProviderCredentialStatus = z.infer<typeof ProviderCredentialStatusSchema>;
 export type ProviderCredentialTestResult = z.infer<typeof ProviderCredentialTestResultSchema>;
 export type EditorAccountSnapshot = AccountSnapshot & {
+  /** Which identity/payment surface backs this editor session. The in-process
+   * mock value exists only for isolated unit tests. */
+  accountEnvironment: 'test-mock' | 'development-twin' | 'production';
   routes: { mock: true; managed: boolean; byok: boolean; byokProviders: string[] };
   preferredRoute: GenerationExecutionRoute;
   /** Editor-only metadata. Credential values never cross the server boundary. */
   providerCredentials: ProviderCredentialStatus[];
+  codingInference: CodingInferenceSettings;
 };
 export interface GenerationAccountProjection {
   routes: EditorAccountSnapshot['routes'];
@@ -142,6 +196,7 @@ export function generationAccountProjection(
 export const EditorAccountSnapshotSchema: z.ZodType<EditorAccountSnapshot> = z.intersection(
   AccountSnapshotSchema,
   z.object({
+    accountEnvironment: z.enum(['test-mock', 'development-twin', 'production']),
     routes: z.object({
       mock: z.literal(true),
       managed: z.boolean(),
@@ -150,5 +205,6 @@ export const EditorAccountSnapshotSchema: z.ZodType<EditorAccountSnapshot> = z.i
     }),
     preferredRoute: GenerationExecutionRouteSchema,
     providerCredentials: z.array(ProviderCredentialStatusSchema),
+    codingInference: CodingInferenceSettingsSchema,
   }),
 );

package/src/generations.ts

@@ -62,6 +62,9 @@ export const GenerationJobSchema = z.object({
   cancel: GenerationOperationReferenceSchema.optional(),
   accept: GenerationOperationReferenceSchema.optional(),
   acceptedAt: z.string().datetime().optional(),
+  /** Last time a human/agent opened the native result. A later provider
+   * update makes the terminal result unread again without changing status. */
+  readAt: z.string().datetime().optional(),
   provenanceOperationId: z.string().optional(),
   outputPaths: z.array(z.string()).optional(),
 });
@@ -103,6 +106,9 @@ export interface GenerationJobUpdate {
   message?: string;
   billing?: GenerationBilling;
   cancel?: { tool: string; input: unknown };
+  /** `null` withdraws an acceptance action after polling proves that a
+   * successful operation produced no downloadable project output. */
+  accept?: { tool: string; input: unknown } | null;
   accepted?: {
     provenanceOperationId: string;
     outputPaths: string[];