@opengeni/core 2.8.0-canary.0 → 2.8.2-canary.0

package/dist/dependencies.d.ts

@@ -1,6 +1,6 @@
 import type { Settings } from "@opengeni/config";
 import type { ConnectionCredentialsPort, Document, DocumentAuthorityKind, GitHubAppApiPort, ScheduledTask, ScheduledTaskTriggerType, SessionAuthorizationPort, TurnInitiator } from "@opengeni/contracts";
-import type { Database } from "@opengeni/db";
+import type { Database, SessionWorkflowWakeDeliveryResult } from "@opengeni/db";
 import type { DocumentServices } from "@opengeni/documents";
 import type { EventBus } from "@opengeni/events";
 import type { Observability } from "@opengeni/observability";
@@ -30,7 +30,9 @@ export type SessionWorkflowClient = {
         workflowId: string;
         wakeRevision: number;
         interruptionRequested?: boolean;
-    }) => Promise<void>;
+        /** Called after transport acceptance, before the fallible durable ACK. */
+        onSignalAccepted?: () => void;
+    }) => Promise<SessionWorkflowWakeDeliveryResult | void>;
     /** Trigger one bounded drain of already-committed workflow-wake revisions. */
     requestSessionWorkflowWakeDispatch: () => Promise<void>;
     signalCodexCapacity?: (input: {

package/dist/domain/github-skill-source.d.ts

@@ -0,0 +1,5 @@
+import type { Settings } from "@opengeni/config";
+import type { GitHubSkillSourceClient } from "./skill-imports.js";
+type GitHubJsonRequest = (path: string, maxBytes: number, label: string) => Promise<unknown>;
+export declare function createGitHubSkillSourceClient(settings: Settings, requestJson?: GitHubJsonRequest): GitHubSkillSourceClient;
+export {};

package/dist/domain/packs.d.ts

@@ -6,9 +6,8 @@ export declare function getCapabilityPack(packId: string): CapabilityPack | null
 export declare function isBuiltInCapabilityPack(packId: string): boolean;
 /**
  * Built-in packs plus the manifests registered for this workspace. Stored
- * manifests were validated at registration time; rows that no longer parse
- * (for example after a contract tightening) are skipped instead of breaking
- * the whole catalog.
+ * manifests retain exact historical bytes. Execution views derive Skill labels
+ * from their files, but malformed content needs explicit repair, not omission.
  */
 export declare function listWorkspaceCapabilityPacks(db: Database, workspaceId: string): Promise<CapabilityPack[]>;
 export declare function resolveCapabilityPack(db: Database, workspaceId: string, packId: string): Promise<CapabilityPack | null>;

package/dist/domain/pr-review.d.ts

@@ -42,6 +42,7 @@ export declare const prReviewAutomationAdapter: {
     }) => {
         initialMessage: string;
         sessionTemplate: {
+            bundledSkillIds?: ("builtin:opengeni-documents" | "builtin:opengeni-presentations" | "builtin:opengeni-projects" | "builtin:opengeni-sites" | "builtin:opengeni-skills" | "builtin:opengeni-spreadsheets" | "builtin:opengeni-video-generation")[] | undefined;
             prompt: string;
             instructions: string | null;
             resources: ({
@@ -68,7 +69,7 @@ export declare const prReviewAutomationAdapter: {
             })[];
             skills: {
                 name: string;
-                description?: string | undefined;
+                description: string;
                 files: {
                     path: string;
                     content: string;

package/dist/domain/remember.d.ts

@@ -2,9 +2,9 @@ import { type RememberLane, type GovernedLearningActivationReceipt, type Remembe
 import { type Database, activateHumanConfirmedLearningDecision, archiveTaskNote, confirmRememberKnowledgeClaim, createTaskNote, getWorkspaceInstructionPolicyBaseline, getWorkspaceKnowledgeChangeProposalSummary, getWorkspaceKnowledgeClaimInitiatingHuman, materializeConfirmedRememberKnowledgeMemory, rebaselineWorkspaceInstructionPolicyKnowledgeProposal } from "@opengeni/db";
 import { createCompanyBrainLearningPolicyRouter } from "./company-brain-governed-writes.js";
 export declare class RememberError extends Error {
-    readonly code: "proposal_unavailable" | "proposal_not_confirmable" | "human_confirmation_unavailable" | "baseline_stale";
+    readonly code: "proposal_unavailable" | "proposal_not_confirmable" | "human_confirmation_unavailable" | "preference_retired" | "baseline_stale";
     readonly name = "RememberError";
-    constructor(code: "proposal_unavailable" | "proposal_not_confirmable" | "human_confirmation_unavailable" | "baseline_stale", message: string);
+    constructor(code: "proposal_unavailable" | "proposal_not_confirmable" | "human_confirmation_unavailable" | "preference_retired" | "baseline_stale", message: string);
 }
 export type RememberRouterOptions = {
     db: Database;

package/dist/domain/sessions.d.ts

@@ -116,6 +116,7 @@ export declare function createAndStartSessionWithOutcome(input: {
     modelContext?: string | null;
     resources: ResourceRef[];
     skills?: SessionSkill[];
+    bundledSkillIds?: import("@opengeni/contracts").BundledSkillId[] | undefined;
     tools: ToolRef[];
     toolPolicy: SessionToolPolicy;
     clientEventId?: string;

package/dist/domain/skill-search.d.ts

@@ -0,0 +1,30 @@
+import type { Settings } from "@opengeni/config";
+import { pinnedFetch } from "@opengeni/network";
+export type PublicSkillSearchInput = Readonly<{
+    query: string;
+    limit?: number;
+    owner?: string;
+}>;
+export type PublicSkillSearchResult = Readonly<{
+    provider: "skills_sh";
+    query: string;
+    items: readonly Readonly<{
+        id: string;
+        name: string;
+        source: string;
+        skillId: string;
+        url: string;
+        installs: number;
+    }>[];
+    nextCursor: null;
+}>;
+export type PublicSkillSearchClient = Readonly<{
+    search(input: PublicSkillSearchInput): Promise<PublicSkillSearchResult>;
+}>;
+export type PublicSkillSearchErrorCode = "invalid_query" | "rate_limited" | "timeout" | "unavailable" | "invalid_response";
+export declare class PublicSkillSearchError extends Error {
+    readonly code: PublicSkillSearchErrorCode;
+    readonly retryAfterSeconds: number | null;
+    constructor(code: PublicSkillSearchErrorCode, message: string, retryAfterSeconds?: number | null);
+}
+export declare function createPublicSkillSearchClient(settings: Settings, fetcher?: typeof pinnedFetch): PublicSkillSearchClient;

package/dist/domain/skills.d.ts

@@ -0,0 +1,73 @@
+import type { SkillFile, SkillInstallInput, SkillRevisionInput, SkillSaveInput } from "@opengeni/contracts";
+import { listSkillRecords, type Database, type SkillReadContext } from "@opengeni/db";
+export { replayPortableSkillInstall } from "@opengeni/db";
+/** Canonical text-only folder; rejects invalid Unicode before PostgreSQL conversion. */
+export declare function validateSkillFiles(files: readonly SkillFile[]): SkillFile[];
+/** Separate from the historical SKILL.md hash, which must never be rewritten. */
+export declare function skillBundleHash(files: readonly SkillFile[]): string;
+export declare const listSkills: typeof listSkillRecords;
+export declare function readSkill(db: Database, context: SkillReadContext, skillId: string, revisionId?: string): Promise<import("@opengeni/contracts").SkillRecord | null>;
+export declare function saveSkill(db: Database, input: SkillSaveInput): Promise<{
+    operationId: string;
+    skillId: string;
+    revisionId: string;
+    outcome: "applied" | "pending" | "preserved";
+    decision?: "rejected" | undefined;
+    pendingReason?: "approval" | "source_finalization" | undefined;
+    skillReview?: {
+        sourceOperationId: string;
+        skillId: string;
+        revisionId: string;
+        expectedRevisionId: string | null;
+        expectedScopeVersion: number;
+    } | undefined;
+    replayed: boolean;
+}>;
+export declare function installSkill(db: Database, input: SkillInstallInput): Promise<{
+    operationId: string;
+    skillId: string;
+    revisionId: string;
+    outcome: "applied" | "pending" | "preserved";
+    decision?: "rejected" | undefined;
+    pendingReason?: "approval" | "source_finalization" | undefined;
+    skillReview?: {
+        sourceOperationId: string;
+        skillId: string;
+        revisionId: string;
+        expectedRevisionId: string | null;
+        expectedScopeVersion: number;
+    } | undefined;
+    replayed: boolean;
+}>;
+export declare function approveSkill(db: Database, input: SkillRevisionInput): Promise<{
+    operationId: string;
+    skillId: string;
+    revisionId: string;
+    outcome: "applied" | "pending" | "preserved";
+    decision?: "rejected" | undefined;
+    pendingReason?: "approval" | "source_finalization" | undefined;
+    skillReview?: {
+        sourceOperationId: string;
+        skillId: string;
+        revisionId: string;
+        expectedRevisionId: string | null;
+        expectedScopeVersion: number;
+    } | undefined;
+    replayed: boolean;
+}>;
+export declare function restoreSkill(db: Database, input: SkillRevisionInput): Promise<{
+    operationId: string;
+    skillId: string;
+    revisionId: string;
+    outcome: "applied" | "pending" | "preserved";
+    decision?: "rejected" | undefined;
+    pendingReason?: "approval" | "source_finalization" | undefined;
+    skillReview?: {
+        sourceOperationId: string;
+        skillId: string;
+        revisionId: string;
+        expectedRevisionId: string | null;
+        expectedScopeVersion: number;
+    } | undefined;
+    replayed: boolean;
+}>;

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./domain/skills.js";
 export * from "./dependencies.js";
 export * from "./workflow-wake-contract.js";
 export * from "./sandbox-types.js";
@@ -14,6 +15,8 @@ export * from "./billing/limits.js";
 export * from "./domain/capabilities.js";
 export * from "./domain/host-mcp-authority-source-admission.js";
 export * from "./domain/skill-imports.js";
+export * from "./domain/skill-search.js";
+export * from "./domain/github-skill-source.js";
 export * from "./domain/environments.js";
 export * from "./rigs/index.js";
 export * from "./domain/packs.js";