@opengeni/core 0.28.1 → 2.1.0-canary.0

package/dist/domain/sessions.d.ts

@@ -1,7 +1,8 @@
 import { type Settings } from "@opengeni/config";
-import { SessionSpawnDenial, type AccessGrant, type CreateSessionResponse, type GoalSpec, type FirstPartyMcpToolName, type McpPersonalConnectionDelegation, type Permission, type ReasoningEffort, type ResourceRef, type Session, type SessionSkill, type SessionEvent, SessionMcpApprovalPolicy, type SessionMcpCredentialUpdateInput, type SessionMcpServerMetadata, type SubmittedTimelineAnnotation, type TimelineAnnotation, type UpdateSessionMcpApprovalPolicyResponse, type UpdateSessionToolPolicyRequest, type SessionAuthorizationPort, type SessionToolPolicy, type SessionTurn, type ToolRef, type TurnInitiator, type TurnInitiatorContext, type TurnExecutionPolicyV1, type XaiProviderAccountAuthoritySnapshotV1 } from "@opengeni/contracts";
-import { type CreateSessionMcpServerInput, type Database, type UpdateSessionMcpServerCredentialsInput, type SessionCommandActor } from "@opengeni/db";
+import { SessionSpawnDenial, type AccessGrant, type ComposerDraft, type CreateSessionResponse, type GoalSpec, type FirstPartyMcpToolName, type McpPersonalConnectionDelegation, type McpConnectionAuthoritySelection, type Permission, type PersonalResourceAttachmentIntent, type ReasoningEffort, type ResourceRef, type Session, type SessionCommandReceipt, type SessionSkill, type SessionEvent, SessionMcpApprovalPolicy, type SessionMcpCredentialUpdateInput, type SessionMcpServerMetadata, type SubmittedTimelineAnnotation, type TimelineAnnotation, type UpdateSessionMcpApprovalPolicyResponse, type UpdateSessionToolPolicyRequest, type SessionAuthorizationPort, type SessionToolPolicy, type SessionTurn, type SessionPromptRouting, type SessionGoalSnapshot, type ToolRef, type TurnInitiator, type TurnInitiatorContext, type TurnExecutionPolicyV1, type XaiProviderAccountAuthoritySnapshotV1 } from "@opengeni/contracts";
+import { type CreateSessionMcpServerInput, type Database, type UpdateSessionMcpServerCredentialsInput, type SessionCommandActor, type NewSessionDraftSnapshot } from "@opengeni/db";
 import { type EventBus } from "@opengeni/events";
+import { type AccessGrantAuthorization } from "../access/index.js";
 import type { AcceptSessionUserMessageDependencies, ApiRouteDeps, SessionWorkflowClient } from "../dependencies.js";
 /** Transport-neutral typed denial raised only after its audit row committed. */
 export declare class SessionSpawnDeniedError extends Error {
@@ -75,10 +76,11 @@ export declare function createAndStartSessionWithOutcome(input: {
     beforeCreateCommit?: (tx: Database, sessionId: string) => Promise<void>;
     accountId: string;
     workspaceId: string;
+    visibility?: "user_private" | "workspace_shared";
     initialMessage: string;
     /** Create the session shell without an initial user event/agent turn. */
     deferInitialTurn?: boolean;
-    turnInstructions?: string | null;
+    modelContext?: string | null;
     resources: ResourceRef[];
     skills?: SessionSkill[];
     tools: ToolRef[];
@@ -111,6 +113,7 @@ export declare function createAndStartSessionWithOutcome(input: {
     mcpServers?: CreateSessionMcpServerInput[];
     sessionMcpServers?: SessionMcpServerMetadata[];
     personalConnectionDelegations?: McpPersonalConnectionDelegation[];
+    initialPersonalResourceAttachmentIntent?: PersonalResourceAttachmentIntent | null;
     xaiProviderAccountAuthoritySnapshot?: XaiProviderAccountAuthoritySnapshotV1;
     parentSessionId?: string | null;
     createIdempotencyKey?: string | null;
@@ -120,10 +123,25 @@ export declare function createAndStartSessionWithOutcome(input: {
         sandboxId: string;
         settings: Settings;
         workingDir?: string | null;
+        resourceSubjectId?: string | null;
     } | null;
     consumeNewSessionDraft?: {
         subjectId: string;
         expectedRevision: number;
+        expectedSnapshot: NewSessionDraftSnapshot;
+        acceptedSelection: {
+            channelId: string | null;
+            targetSandboxId: string | null;
+            workingDir: string | null;
+        };
+    } | null;
+    rememberNewSessionSelection?: {
+        subjectId: string;
+        acceptedSelection: {
+            channelId: string | null;
+            targetSandboxId: string | null;
+            workingDir: string | null;
+        };
     } | null;
     maxNestedAgentDepthOverride?: number | null;
     allowNestedAgentDepthIncrease?: boolean;
@@ -175,8 +193,6 @@ export declare function assertSessionAllowsProductModel(session: Pick<Session, "
  */
 export declare function assertWorkspaceModelPolicyAllows(db: Database, settings: Settings, workspaceId: string, model: string | null | undefined): Promise<void>;
 export declare function requireQueuedTurnForApi(db: Database, workspaceId: string, sessionId: string, turnId: string): Promise<SessionTurn>;
-export declare function reasoningEffortForSession(metadata: Record<string, unknown>, fallback: Settings["openaiReasoningEffort"]): Settings["openaiReasoningEffort"];
-export declare function latencyModeForSession(metadata: Record<string, unknown>, fallback?: "standard" | "priority" | "fast"): "standard" | "priority" | "fast";
 /**
  * Appends a `user.message` to an existing session and enqueues the resulting
  * turn, merging requested resources/tools into the session and waking the
@@ -194,7 +210,7 @@ export declare function postUserMessageTurn(input: {
     sessionId: string;
     text: string;
     annotations?: TimelineAnnotation[];
-    turnInstructions?: string | null;
+    modelContext?: string | null;
     resources: ResourceRef[];
     model?: string | null;
     reasoningEffort?: Settings["openaiReasoningEffort"] | null;
@@ -202,6 +218,7 @@ export declare function postUserMessageTurn(input: {
     clientEventId?: string;
     mcpCredentialUpdates?: UpdateSessionMcpServerCredentialsInput[];
     personalConnectionDelegations?: McpPersonalConnectionDelegation[];
+    personalResourceAttachment?: PersonalResourceAttachmentIntent;
     delivery?: "send" | "steer";
     origin?: "human" | "operator";
     actor?: string;
@@ -216,6 +233,9 @@ export declare function postUserMessageTurn(input: {
 }): Promise<{
     accepted: SessionEvent;
     turn: SessionTurn;
+    draft: ComposerDraft | null;
+    receipt: SessionCommandReceipt;
+    routing: SessionPromptRouting;
     interruptionCount: number;
     replay: boolean;
 }>;
@@ -228,11 +248,17 @@ export declare function postUserMessageTurn(input: {
  * trusted immediate parent, while explicit arrays (including []) win. A
  * top-level create with omitted tools applies workspace-default capability MCPs.
  */
-export declare function createSessionForRequestWithOutcome(deps: ApiRouteDeps, grant: AccessGrant, workspaceId: string, rawPayload: unknown): Promise<CreateSessionRequestOutcome>;
+export declare function resolveChildGoalFromAcceptedSnapshot(goal: GoalSpec, parentGoalSnapshot: SessionGoalSnapshot): GoalSpec;
+export declare function resolveSessionCreateVisibility(input: {
+    requestedVisibility: "private" | "workspace";
+    visibilityProvided: boolean;
+    parentVisibility: "user_private" | "workspace_shared" | null;
+}): "user_private" | "workspace_shared";
+export declare function createSessionForRequestWithOutcome(deps: ApiRouteDeps, grant: AccessGrant, workspaceId: string, rawPayload: unknown, authorization?: AccessGrantAuthorization): Promise<CreateSessionRequestOutcome>;
 /** @internal Fixed public projection; the committed session outcome remains authoritative. */
 export declare function reportSessionUsageRecordingFailure(_error: unknown): void;
 /** Backward-compatible entity-returning request path for REST and core callers. */
-export declare function createSessionForRequest(deps: ApiRouteDeps, grant: AccessGrant, workspaceId: string, rawPayload: unknown): Promise<CreateSessionResponse>;
+export declare function createSessionForRequest(deps: ApiRouteDeps, grant: AccessGrant, workspaceId: string, rawPayload: unknown, authorization?: AccessGrantAuthorization): Promise<CreateSessionResponse>;
 /**
  * Full accept-user-message flow shared by the `user.message` branch of
  * `POST /sessions/:id/events` and the first-party MCP `session_send_message`
@@ -243,20 +269,26 @@ export declare function createSessionForRequest(deps: ApiRouteDeps, grant: Acces
 export declare function acceptSessionUserMessageWithOutcome(deps: AcceptSessionUserMessageDependencies, grant: AccessGrant, workspaceId: string, sessionId: string, input: {
     text: string;
     annotations?: SubmittedTimelineAnnotation[];
-    turnInstructions?: string | null;
+    modelContext?: string | null;
     resources?: ResourceRef[];
     model?: string | null;
     reasoningEffort?: ReasoningEffort | null;
     latencyMode?: "standard" | "priority" | "fast" | null;
     clientEventId?: string;
     mcpCredentialUpdates?: SessionMcpCredentialUpdateInput[];
+    connectionAuthorities?: McpConnectionAuthoritySelection[];
     delivery?: "send" | "steer";
     origin?: "human" | "operator";
     controlEtag?: string | null;
     expectedDraftRevision?: number | null;
+    personalResourceAttachment?: PersonalResourceAttachmentIntent;
+    authorization?: AccessGrantAuthorization;
 }): Promise<{
     accepted: SessionEvent;
     turn: SessionTurn;
+    draft: ComposerDraft | null;
+    receipt: SessionCommandReceipt;
+    routing: SessionPromptRouting;
     interruptionCount: number;
     replay: boolean;
 }>;
@@ -264,6 +296,8 @@ export declare function acceptSessionUserMessageWithOutcome(deps: AcceptSessionU
 export declare function acceptSessionUserMessage(deps: Parameters<typeof acceptSessionUserMessageWithOutcome>[0], grant: Parameters<typeof acceptSessionUserMessageWithOutcome>[1], workspaceId: Parameters<typeof acceptSessionUserMessageWithOutcome>[2], sessionId: Parameters<typeof acceptSessionUserMessageWithOutcome>[3], input: Parameters<typeof acceptSessionUserMessageWithOutcome>[4]): Promise<{
     accepted: SessionEvent;
     turn: SessionTurn;
+    receipt: SessionCommandReceipt;
+    routing: SessionPromptRouting;
     interruptionCount: number;
     replay: boolean;
 }>;

package/dist/editable-artifact-live/application.d.ts

@@ -4,9 +4,13 @@ import type { EditableArtifactLiveSession, EditableArtifactLiveServer, OpenEdita
 import type { EditableArtifactLiveTicket } from "./types.js";
 export type EditableArtifactLiveCompatibilityRequest = Readonly<{
     artifact: EditableArtifact;
-    protocolVersion: number;
+    modality: EditableArtifactModality;
+    liveProtocolVersion: number;
     kernelVersion: string;
     modelSchemaVersion: number;
+    snapshotVersion: number;
+    commandProtocolVersion: number;
+    committedTransactionProtocolVersion: number;
 }>;
 /** A client/runtime protocol tuple cannot be served by the loaded kernel. */
 export declare class EditableArtifactCompatibilityError extends Error {
@@ -41,9 +45,13 @@ export type ReadEditableArtifactApplicationInput = Readonly<{
     artifactId: EditableArtifactId;
 }>;
 export type MintEditableArtifactApplicationTicketInput = ReadEditableArtifactApplicationInput & Readonly<{
-    protocolVersion: number;
+    modality: EditableArtifactModality;
+    liveProtocolVersion: number;
     kernelVersion: string;
     modelSchemaVersion: number;
+    snapshotVersion: number;
+    commandProtocolVersion: number;
+    committedTransactionProtocolVersion: number;
     allowEdit: boolean;
 }>;
 /** Exact application seam used by standalone API and embedding hosts. */

package/dist/editable-artifact-live/ports.d.ts

@@ -21,7 +21,6 @@ export type EditableArtifactLiveBootstrapRead = Readonly<{
     scope: EditableArtifactScope;
     artifactId: EditableArtifactId;
     resume: EditableArtifactLiveResume;
-    protocolVersion: number;
 }>;
 export type EditableArtifactLiveTransactionPage = Readonly<{
     transactions: readonly EditableArtifactLiveCommittedTransaction[];

package/dist/editable-artifact-live/server.d.ts

@@ -4,7 +4,6 @@ import { type EditableArtifactActor, type EditableArtifactId, type EditableArtif
 import type { EditableArtifactLiveAuthorizationInvalidationPort, EditableArtifactLiveClockPort, EditableArtifactLiveHintPort, EditableArtifactLiveReadPort, EditableArtifactLiveSchedulerPort, EditableArtifactLiveServerDependencies, EditableArtifactLiveSinkPort, EditableArtifactLiveTicketStorePort, EditableArtifactLiveTokenPort } from "./ports.js";
 import { type EditableArtifactLiveAppliedClientFrame, type EditableArtifactLiveClose, type EditableArtifactLiveCloseReason, type EditableArtifactLiveMutationReceipt, type EditableArtifactLiveResume, type EditableArtifactLiveTicket } from "./types.js";
 export type EditableArtifactLiveServerOptions = Readonly<{
-    protocolVersion?: number;
     ticketTtlMs?: number;
     maxClientFrameBytes?: number;
     maxOutboundFrameBytes?: number;

package/dist/editable-artifact-live/ticket.d.ts

@@ -8,7 +8,6 @@ export type EditableArtifactLiveTicketAuthorityDependencies = Readonly<{
     tokens: EditableArtifactLiveTokenPort;
     clock: EditableArtifactLiveClockPort;
     ttlMs?: number;
-    protocolVersion?: number;
 }>;
 export declare class EditableArtifactLiveTicketAuthority {
     private readonly dependencies;

package/dist/editable-artifact-live/types.d.ts

@@ -1,5 +1,5 @@
 import type { EditableArtifactActor, EditableArtifactCausalFrontier, EditableArtifactClientTransactionId, EditableArtifactContentHash, EditableArtifactId, EditableArtifactModality, EditableArtifactRequestHash, EditableArtifactScope, EditableArtifactStateHash, EditableArtifactTransactionId } from "../domain/editable-artifacts/types.js";
-export declare const EDITABLE_ARTIFACT_LIVE_PROTOCOL_VERSION = 1;
+export declare const EDITABLE_ARTIFACT_LIVE_PROTOCOL_VERSION: 2;
 export type EditableArtifactLiveTicket = Readonly<{
     artifactId: EditableArtifactId;
     modality: EditableArtifactModality;
@@ -34,6 +34,7 @@ export type EditableArtifactLiveSnapshot = (EditableArtifactLiveSnapshotCommon &
     modality: "spreadsheet";
     causalFrontier: EditableArtifactCausalFrontier;
     operationProtocolVersion: number;
+    snapshotVersion: number;
 }>) | (EditableArtifactLiveSnapshotCommon & Readonly<{
     modality: "document" | "presentation";
     nativeRevision: number;
@@ -82,7 +83,7 @@ type EditableArtifactLiveResumeCommon = Readonly<{
     requireSnapshot: boolean;
 }>;
 export type EditableArtifactLiveResume = (EditableArtifactLiveResumeCommon & Readonly<{
-    modality?: "spreadsheet";
+    modality: "spreadsheet";
     localCausalFrontier: EditableArtifactCausalFrontier;
 }>) | (EditableArtifactLiveResumeCommon & Readonly<{
     modality: "document" | "presentation";
@@ -121,6 +122,8 @@ export type EditableArtifactLiveServerFrame = Readonly<{
 }> & (Readonly<{
     modality: "spreadsheet";
     causalFrontier: EditableArtifactCausalFrontier;
+    operationProtocolVersion: number;
+    snapshotVersion: number;
 }> | Readonly<{
     modality: "document" | "presentation";
     nativeRevision: number;

package/dist/editable-artifact-live.js

@@ -25,8 +25,8 @@ import {
   encodeEditableArtifactLiveOpenWireFrame,
   encodeEditableArtifactLiveServerWireFrame,
   inspectEditableArtifactLiveWireEnvelope
-} from "./chunk-NYPMQ7NO.js";
-import "./chunk-JJU6I5XD.js";
+} from "./chunk-ZYCNLYGH.js";
+import "./chunk-VCZFFEPB.js";
 export {
   EDITABLE_ARTIFACT_HINT_MAX_BYTES,
   EDITABLE_ARTIFACT_HINT_SUBJECT_PREFIX,

package/dist/editable-artifacts.js

@@ -21,11 +21,10 @@ import {
   editableArtifactStorePortFromPostgres,
   validateEditableArtifactMaterializationJob,
   validateEditableArtifactPinnedVersion
-} from "./chunk-6WKPWE5S.js";
+} from "./chunk-H7X52RI2.js";
 import {
   EDITABLE_ARTIFACT_COMPACTION_BYTE_THRESHOLD,
   EDITABLE_ARTIFACT_COMPACTION_TRANSACTION_THRESHOLD,
-  EDITABLE_ARTIFACT_INTENT_PROTOCOL_VERSION,
   EDITABLE_ARTIFACT_MAX_COMMAND_BYTES_PER_TRANSACTION,
   EDITABLE_ARTIFACT_MAX_COMMITTED_TRANSACTION_BYTES,
   EDITABLE_ARTIFACT_MAX_COMMIT_ATTEMPTS,
@@ -87,13 +86,12 @@ import {
   mergeCausalFrontiers,
   ogatxEditableArtifactMutationIntentCodec,
   validateEditableArtifactActor
-} from "./chunk-JJU6I5XD.js";
+} from "./chunk-VCZFFEPB.js";
 export {
   EDITABLE_ARTIFACT_COMPACTION_BYTE_THRESHOLD,
   EDITABLE_ARTIFACT_COMPACTION_TRANSACTION_THRESHOLD,
   EDITABLE_ARTIFACT_EXPORT_MAX_DOWNLOAD_BYTES,
   EDITABLE_ARTIFACT_EXPORT_MAX_OPTIONS_BYTES,
-  EDITABLE_ARTIFACT_INTENT_PROTOCOL_VERSION,
   EDITABLE_ARTIFACT_MAX_COMMAND_BYTES_PER_TRANSACTION,
   EDITABLE_ARTIFACT_MAX_COMMITTED_TRANSACTION_BYTES,
   EDITABLE_ARTIFACT_MAX_COMMIT_ATTEMPTS,

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export * from "./managed-session.js";
 export * from "./transcription.js";
 export * from "./sandbox/fleet.js";
 export * from "./sandbox/routing.js";
+export * from "./sandbox/runtime-settings.js";
 export * from "./access/index.js";
 export * from "./session-authorization.js";
 export * from "./billing/limits.js";
@@ -14,24 +15,35 @@ export * from "./domain/skill-imports.js";
 export * from "./domain/environments.js";
 export * from "./rigs/index.js";
 export * from "./domain/packs.js";
+export * from "./domain/automations.js";
+export * from "./domain/pr-review.js";
 export * from "./domain/personal-connection-delegations.js";
 export * from "./domain/resources.js";
+export * from "./domain/github-repository-bindings.js";
 export * from "./domain/session-tool-policy.js";
 export * from "./domain/scheduled-tasks.js";
 export * from "./domain/sessions.js";
 export * from "./domain/insights.js";
 export * from "./domain/memory-slack-publication.js";
 export * from "./domain/memory-slack-delivery.js";
-export * from "./domain/durable-learning-slack-publication.js";
+export * from "./domain/governed-learning-slack-publication.js";
 export * from "./domain/slack-publication-secret-safety.js";
 export * from "./domain/company-profile-durable-learning-adapter.js";
+export * from "./domain/company-profile-agent-admin.js";
+export * from "./domain/company-brain-governed-writes.js";
+export * from "./domain/governed-learning-evaluator.js";
+export * from "./domain/governed-learning-activation.js";
+export * from "./domain/remember.js";
 export * from "./domain/slack-bot.js";
 export * from "./domain/conversation-integrations.js";
 export * from "./domain/fiken.js";
 export * from "./domain/workspace-members.js";
 export * from "./domain/video-generation.js";
 export * from "./domain/video-generation-capabilities.js";
+export * from "./domain/organization-membership-lifecycle.js";
 export * from "./application/new-session-drafts.js";
 export * from "./application/session-commands.js";
+export * from "./application/session-tenancy.js";
+export * from "./application/user-resource-grants.js";
 export * from "./editable-artifact-live.js";
 export * from "./editable-artifacts.js";