@opengeni/core 0.3.0 → 0.4.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/core",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "OpenGeni framework-agnostic core: the domain, access, and billing layers (neutral access, off-HTTP V2 surface). Behavior-preserving extraction from apps/api — keeps Hono's HTTPException for error throwing (typed-errors cleanup deferred).",
   "license": "Apache-2.0",
   "repository": {
@@ -37,14 +37,14 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@opengeni/codex": "^0.2.1",
-    "@opengeni/config": "^0.2.3",
-    "@opengeni/contracts": "^0.5.0",
-    "@opengeni/db": "^0.3.0",
-    "@opengeni/documents": "^0.2.3",
-    "@opengeni/events": "^0.2.3",
+    "@opengeni/config": "^0.2.5",
+    "@opengeni/contracts": "^0.7.0",
+    "@opengeni/db": "^0.4.1",
+    "@opengeni/documents": "^0.2.5",
+    "@opengeni/events": "^0.2.5",
     "@opengeni/observability": "^0.2.1",
-    "@opengeni/runtime": "^0.2.3",
-    "@opengeni/storage": "^0.2.3",
+    "@opengeni/runtime": "^0.3.1",
+    "@opengeni/storage": "^0.2.5",
     "hono": "^4.12.18"
   },
   "devDependencies": {

package/src/dependencies.ts

@@ -24,6 +24,7 @@ export type SessionWorkflowClient = {
   syncScheduledTask: (input: { task: ScheduledTask }) => Promise<void>;
   deleteScheduledTaskSchedule: (input: { temporalScheduleId: string }) => Promise<void>;
   triggerScheduledTask: (input: { task: ScheduledTask; agentRunUsageIdempotencyKey?: string; triggerWorkflowId?: string }) => Promise<void>;
+  check?: () => Promise<void>;
 };
 
 export type DocumentIndexClient = {
@@ -38,6 +39,7 @@ export type AppDependencies = {
   documentIndexer?: DocumentIndexClient;
   documentServices?: DocumentServices;
   observability?: Observability;
+  readinessChecks?: Partial<Record<"db" | "nats" | "temporal", () => Promise<void> | void>>;
   githubStateSecret?: string;
   managedAuth?: ManagedAuth | null;
   // The API process's OWN agent-loop-free sandbox client (constructed from

package/src/domain/sessions.ts

@@ -232,6 +232,11 @@ export async function createAndStartSession(input: {
   // Names/ids only; the session.created payload never carries variable values.
   environment?: { id: string; name: string } | null;
   goal?: GoalSpec | null;
+  // Per-session agent persona/system instructions (org-visible metadata, not a
+  // secret). Persisted on the session row and composed system-level AFTER the
+  // workspace agentInstructions at turn time; never emitted as a timeline event.
+  // Null/omitted ⇒ the session carries none.
+  instructions?: string | null;
   // Validated against the creating grant before this is called.
   firstPartyMcpPermissions?: Permission[] | null;
   // Encrypted DB rows plus matching safe metadata for create-time per-session
@@ -293,6 +298,7 @@ export async function createAndStartSession(input: {
       sandboxBackend: input.sandboxBackend,
       environmentId: input.environment?.id ?? null,
       firstPartyMcpPermissions: input.firstPartyMcpPermissions ?? null,
+      instructions: input.instructions ?? null,
       parentSessionId: input.parentSessionId ?? null,
       createIdempotencyKey: input.createIdempotencyKey,
       sandboxGroupId: input.sandboxGroupId ?? null,
@@ -315,6 +321,7 @@ export async function createAndStartSession(input: {
     sandboxBackend: input.sandboxBackend,
     environmentId: input.environment?.id ?? null,
     firstPartyMcpPermissions: input.firstPartyMcpPermissions ?? null,
+    instructions: input.instructions ?? null,
     parentSessionId: input.parentSessionId ?? null,
     sandboxGroupId: input.sandboxGroupId ?? null,
     ...(input.sandboxOs ? { sandboxOs: input.sandboxOs } : {}),
@@ -855,6 +862,10 @@ export async function createSessionForRequest(
     metadata: payload.metadata,
     environment: environment ? { id: environment.id, name: environment.name } : null,
     goal: payload.goal ?? null,
+    // Per-session persona instructions (already trimmed/validated by the
+    // contracts schema). Persisted on the row; composed system-level at turn
+    // time. Not surfaced as an event.
+    instructions: payload.instructions ?? null,
     firstPartyMcpPermissions,
     mcpServers: sessionMcpServers.dbServers,
     sessionMcpServers: sessionMcpServers.metadata,