@opengeni/core 0.3.0 → 0.4.1

package/README.md

@@ -12,3 +12,12 @@ It owns code that is not intrinsically HTTP or Temporal process bootstrapping:
 `@opengeni/api-router` owns the Hono app, middleware, HTTP route adapters, MCP HTTP transport, and API-direct sandbox endpoints. `@opengeni/worker-bundle` owns Temporal worker construction, workflows, activities, and process lifecycle. Both consume `@opengeni/core`; core does not import either app.
 
 The package is used by standalone OpenGeni through those app runners and by embedded hosts that call core directly or mount the API router.
+
+## Scope honesty: engine-core, not domain-core
+
+This package is the **engine core** — the transport-mostly-neutral heart of the
+server, extracted so embedders can mount it. It still carries server-flavored
+dependencies (notably Hono's `HTTPException` as the domain error type and the
+full persistence/runtime closure). It is NOT a pure domain library and does not
+try to be one; if you need OpenGeni without any server runtime, you want the
+REST API + `@opengeni/sdk` instead.

package/dist/index.d.ts

@@ -100,6 +100,7 @@ type SessionWorkflowClient = {
         agentRunUsageIdempotencyKey?: string;
         triggerWorkflowId?: string;
     }) => Promise<void>;
+    check?: () => Promise<void>;
 };
 type DocumentIndexClient = {
     indexDocument: (input: {
@@ -116,6 +117,7 @@ type AppDependencies = {
     documentIndexer?: DocumentIndexClient;
     documentServices?: DocumentServices;
     observability?: Observability;
+    readinessChecks?: Partial<Record<"db" | "nats" | "temporal", () => Promise<void> | void>>;
     githubStateSecret?: string;
     managedAuth?: ManagedAuth | null;
     sandboxClient?: ApiSandboxClient;
@@ -554,6 +556,7 @@ declare function createAndStartSession(input: {
         name: string;
     } | null;
     goal?: GoalSpec | null;
+    instructions?: string | null;
     firstPartyMcpPermissions?: Permission[] | null;
     mcpServers?: CreateSessionMcpServerInput[];
     sessionMcpServers?: SessionMcpServerMetadata[];
@@ -574,6 +577,7 @@ declare function createAndStartSession(input: {
     initialMessage: string;
     title: string | null;
     titleSource: "user" | "agent" | null;
+    instructions: string | null;
     resources: ({
         kind: "repository";
         uri: string;

package/dist/index.js

@@ -2034,6 +2034,7 @@ 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,
@@ -2056,6 +2057,7 @@ 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 } : {},
@@ -2371,6 +2373,10 @@ async function createSessionForRequest(deps, grant, workspaceId, rawPayload) {
     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,