@peers-app/peers-sdk 0.25.21 → 0.26.1

package/dist/data/tools.d.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import type { DataContext } from "../context/data-context";
+export { isToolCatalogPatch, toolCatalogContractDescriptiveFields, toolCatalogIdentityFields, toolCatalogPatch, toolCatalogPatchFields, toolCatalogSupplementalFields, } from "./tool-catalog-fields";
 /** Shape of a tool input, output, or config schema. */
 export declare enum IOSchemaType {
     none = "none",
@@ -62,6 +63,12 @@ export type IOSchema = z.infer<typeof ioSchema>;
 /** Zod schema for a persisted {@link ITool} row. */
 export declare const toolSchema: z.ZodObject<{
     toolId: z.ZodEffects<z.ZodString, string, string>;
+    contractId: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    contractVersion: z.ZodOptional<z.ZodNumber>;
+    toolName: z.ZodOptional<z.ZodString>;
+    catalogIdentity: z.ZodOptional<z.ZodEnum<["deterministic", "legacy-alias"]>>;
+    catalogState: z.ZodOptional<z.ZodEnum<["resolved", "unresolved", "quarantined"]>>;
+    catalogReason: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
     usageDescription: z.ZodString;
     detailedDescription: z.ZodOptional<z.ZodString>;
@@ -225,7 +232,6 @@ export declare const toolSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     code: string;
     name: string;
-    toolId: string;
     usageDescription: string;
     inputSchema: {
         type: IOSchemaType;
@@ -251,7 +257,13 @@ export declare const toolSchema: z.ZodObject<{
             subType?: string | undefined;
         }[];
     };
-    detailedDescription?: string | undefined;
+    toolId: string;
+    contractId?: string | undefined;
+    contractVersion?: number | undefined;
+    toolName?: string | undefined;
+    catalogIdentity?: "deterministic" | "legacy-alias" | undefined;
+    catalogState?: "resolved" | "unresolved" | "quarantined" | undefined;
+    catalogReason?: string | undefined;
     configSchema?: {
         type: IOSchemaType;
         fields: {
@@ -264,15 +276,15 @@ export declare const toolSchema: z.ZodObject<{
             subType?: string | undefined;
         }[];
     } | undefined;
-    codeRepository?: string | undefined;
     isAssistantRunner?: boolean | undefined;
+    detailedDescription?: string | undefined;
+    codeRepository?: string | undefined;
     packageId?: string | undefined;
     authorityPropagation?: "preserve" | "cap" | undefined;
     accessLevel?: number | undefined;
     remoteAccessLevel?: number | undefined;
 }, {
     name: string;
-    toolId: string;
     usageDescription: string;
     inputSchema: {
         type: IOSchemaType;
@@ -298,8 +310,14 @@ export declare const toolSchema: z.ZodObject<{
             subType?: string | undefined;
         }[] | undefined;
     };
+    toolId: string;
     code?: string | undefined;
-    detailedDescription?: string | undefined;
+    contractId?: string | undefined;
+    contractVersion?: number | undefined;
+    toolName?: string | undefined;
+    catalogIdentity?: "deterministic" | "legacy-alias" | undefined;
+    catalogState?: "resolved" | "unresolved" | "quarantined" | undefined;
+    catalogReason?: string | undefined;
     configSchema?: {
         type: IOSchemaType;
         fields?: {
@@ -312,8 +330,9 @@ export declare const toolSchema: z.ZodObject<{
             subType?: string | undefined;
         }[] | undefined;
     } | undefined;
-    codeRepository?: string | undefined;
     isAssistantRunner?: boolean | undefined;
+    detailedDescription?: string | undefined;
+    codeRepository?: string | undefined;
     packageId?: string | undefined;
     authorityPropagation?: "preserve" | "cap" | undefined;
     accessLevel?: number | undefined;
@@ -321,7 +340,10 @@ export declare const toolSchema: z.ZodObject<{
 }>;
 /** A tool definition stored in the Tools table. */
 export type ITool = z.infer<typeof toolSchema>;
-/** Runnable tool: persisted metadata plus the in-memory implementation. */
+/**
+ * Historical tool instance shape used by older packages.
+ * @deprecated Use IContractToolImplementation with a contract resolver.
+ */
 export interface IToolInstance {
     tool: ITool;
     toolFn: (...args: any[]) => any;
@@ -336,7 +358,6 @@ export interface IToolInstance {
 export declare function Tools(dataContext?: DataContext): import("..").Table<{
     code: string;
     name: string;
-    toolId: string;
     usageDescription: string;
     inputSchema: {
         type: IOSchemaType;
@@ -362,7 +383,13 @@ export declare function Tools(dataContext?: DataContext): import("..").Table<{
             subType?: string | undefined;
         }[];
     };
-    detailedDescription?: string | undefined;
+    toolId: string;
+    contractId?: string | undefined;
+    contractVersion?: number | undefined;
+    toolName?: string | undefined;
+    catalogIdentity?: "deterministic" | "legacy-alias" | undefined;
+    catalogState?: "resolved" | "unresolved" | "quarantined" | undefined;
+    catalogReason?: string | undefined;
     configSchema?: {
         type: IOSchemaType;
         fields: {
@@ -375,8 +402,9 @@ export declare function Tools(dataContext?: DataContext): import("..").Table<{
             subType?: string | undefined;
         }[];
     } | undefined;
-    codeRepository?: string | undefined;
     isAssistantRunner?: boolean | undefined;
+    detailedDescription?: string | undefined;
+    codeRepository?: string | undefined;
     packageId?: string | undefined;
     authorityPropagation?: "preserve" | "cap" | undefined;
     accessLevel?: number | undefined;

package/dist/data/tools.js

@@ -1,14 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toolSchema = exports.ioSchema = exports.IOSchemaType = void 0;
+exports.toolSchema = exports.ioSchema = exports.IOSchemaType = exports.toolCatalogSupplementalFields = exports.toolCatalogPatchFields = exports.toolCatalogPatch = exports.toolCatalogIdentityFields = exports.toolCatalogContractDescriptiveFields = exports.isToolCatalogPatch = void 0;
 exports.Tools = Tools;
 const zod_1 = require("zod");
 const user_context_singleton_1 = require("../context/user-context-singleton");
+const tool_catalog_identity_1 = require("../contracts/tool-catalog-identity");
 const field_type_1 = require("../types/field-type");
 const zod_types_1 = require("../types/zod-types");
 const access_level_1 = require("./access-level");
 const table_definitions_system_1 = require("./orm/table-definitions.system");
 const types_1 = require("./orm/types");
+var tool_catalog_fields_1 = require("./tool-catalog-fields");
+Object.defineProperty(exports, "isToolCatalogPatch", { enumerable: true, get: function () { return tool_catalog_fields_1.isToolCatalogPatch; } });
+Object.defineProperty(exports, "toolCatalogContractDescriptiveFields", { enumerable: true, get: function () { return tool_catalog_fields_1.toolCatalogContractDescriptiveFields; } });
+Object.defineProperty(exports, "toolCatalogIdentityFields", { enumerable: true, get: function () { return tool_catalog_fields_1.toolCatalogIdentityFields; } });
+Object.defineProperty(exports, "toolCatalogPatch", { enumerable: true, get: function () { return tool_catalog_fields_1.toolCatalogPatch; } });
+Object.defineProperty(exports, "toolCatalogPatchFields", { enumerable: true, get: function () { return tool_catalog_fields_1.toolCatalogPatchFields; } });
+Object.defineProperty(exports, "toolCatalogSupplementalFields", { enumerable: true, get: function () { return tool_catalog_fields_1.toolCatalogSupplementalFields; } });
 /** Shape of a tool input, output, or config schema. */
 var IOSchemaType;
 (function (IOSchemaType) {
@@ -23,7 +31,13 @@ exports.ioSchema = zod_1.z.object({
 });
 /** Zod schema for a persisted {@link ITool} row. */
 exports.toolSchema = zod_1.z.object({
-    toolId: zod_types_1.zodPeerId,
+    toolId: zod_1.z.string().refine(tool_catalog_identity_1.isCatalogToolId, "Invalid tool ID"),
+    contractId: zod_1.z.string().refine(tool_catalog_identity_1.isCatalogContractId, "Invalid catalog contract ID").optional(),
+    contractVersion: zod_1.z.number().int().positive().max(Number.MAX_SAFE_INTEGER).optional(),
+    toolName: zod_1.z.string().optional(),
+    catalogIdentity: zod_1.z.enum(["deterministic", "legacy-alias"]).optional(),
+    catalogState: zod_1.z.enum(["resolved", "unresolved", "quarantined"]).optional(),
+    catalogReason: zod_1.z.string().optional(),
     name: zod_1.z.string().describe("The name of the tool"),
     usageDescription: zod_1.z
         .string()
@@ -37,17 +51,22 @@ exports.toolSchema = zod_1.z.object({
     configSchema: exports.ioSchema
         .optional()
         .describe("The schema of any configuration values that the tool may need"),
-    code: zod_1.z.string().default("").describe("The code that implements the tool"),
+    code: zod_1.z
+        .string()
+        .default("")
+        .describe("Historical tool source; this runtime never writes or executes it"),
     codeRepository: zod_1.z
         .string()
         .optional()
-        .describe("The repository where the code for the tool is stored"),
+        .describe("Historical source repository; this runtime never writes or executes it"),
     // TODO versioning somehow, maybe a git tag or branch
     isAssistantRunner: zod_1.z
         .boolean()
         .optional()
         .describe("Whether this tool is a model that can be used to run an assistant"),
-    packageId: zod_types_1.zodPeerId.optional().describe("The package that installed this tool, if any"),
+    packageId: zod_types_1.zodPeerId
+        .optional()
+        .describe("Historical package provenance; not ownership, availability or permission"),
     authorityPropagation: zod_1.z
         .enum(["cap", "preserve"])
         .optional()
@@ -65,12 +84,16 @@ exports.toolSchema = zod_1.z.object({
 });
 const metaData = {
     name: "Tools",
-    description: "Tools that can be used by assistants.",
+    description: "Permanent public contract tool catalog and preserved legacy tools.",
     primaryKeyName: "toolId",
     fields: (0, types_1.schemaToFields)(exports.toolSchema),
     iconClassName: "bi bi-tools",
-    indexes: [{ fields: ["name"] }, { fields: ["isAssistantRunner"] }],
-    versionNumber: 1,
+    indexes: [
+        { fields: ["name"] },
+        { fields: ["isAssistantRunner"] },
+        { fields: ["contractId", "contractVersion", "toolName"] },
+    ],
+    versionNumber: 2,
 };
 (0, table_definitions_system_1.registerSystemTableDefinition)(metaData, exports.toolSchema);
 /**

package/dist/data/workflow-logs.d.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import type { DataContext } from "../context/data-context";
+/** Persisted execution logs and tool results for one workflow. */
 export declare const workflowLogSchema: z.ZodObject<{
     workflowLogId: z.ZodEffects<z.ZodString, string, string>;
     workflowRunId: z.ZodEffects<z.ZodString, string, string>;
@@ -52,8 +53,8 @@ export declare const workflowLogSchema: z.ZodObject<{
     contextId: string;
     logText: string;
     toolId?: string | undefined;
-    result?: string | undefined;
     logDT?: Date | undefined;
+    result?: string | undefined;
     instruction?: {
         markdown?: string | undefined;
         onError?: string | undefined;
@@ -65,7 +66,9 @@ export declare const workflowLogSchema: z.ZodObject<{
     resultObject?: any[] | z.objectInputType<{}, z.ZodAny, "strip"> | undefined;
     isError?: boolean | undefined;
 }>;
+/** A persisted workflow execution log record. */
 export type IWorkflowLog = z.infer<typeof workflowLogSchema>;
+/** Read or write workflow logs in the specified context. */
 export declare function WorkflowLogs(dataContext?: DataContext): import("..").Table<{
     workflowRunId: string;
     workflowLogId: string;
@@ -85,7 +88,8 @@ export declare function WorkflowLogs(dataContext?: DataContext): import("..").Ta
     resultObject?: any[] | z.objectOutputType<{}, z.ZodAny, "strip"> | undefined;
     isError?: boolean | undefined;
 }>;
-export declare const getLogger: (workflowRunId: string, contextId: string) => (logData: string | Omit<Partial<IWorkflowLog>, "workflowRunId" | "workflowLogId">) => Promise<{
+/** Bind a logger to its run and owning context, independent of the active group. */
+export declare const getLogger: (workflowRunId: string, contextId: string, dataContext?: DataContext) => (logData: string | Omit<Partial<IWorkflowLog>, "workflowRunId" | "workflowLogId">) => Promise<{
     workflowRunId: string;
     workflowLogId: string;
     contextId: string;

package/dist/data/workflow-logs.js

@@ -9,6 +9,7 @@ const zod_types_1 = require("../types/zod-types");
 const utils_1 = require("../utils");
 const table_definitions_system_1 = require("./orm/table-definitions.system");
 const types_1 = require("./orm/types");
+/** Persisted execution logs and tool results for one workflow. */
 exports.workflowLogSchema = zod_1.z.object({
     workflowLogId: zod_types_1.zodPeerId,
     workflowRunId: zod_types_1.zodPeerId.describe("The workflow run that this log entry is associated with"),
@@ -39,22 +40,24 @@ const metaData = {
     localOnly: true,
 };
 (0, table_definitions_system_1.registerSystemTableDefinition)(metaData, exports.workflowLogSchema);
+/** Read or write workflow logs in the specified context. */
 function WorkflowLogs(dataContext) {
     return (0, user_context_singleton_1.getTableContainer)(dataContext).getTable(metaData, exports.workflowLogSchema);
 }
-const getLogger = (workflowRunId, contextId) => {
+/** Bind a logger to its run and owning context, independent of the active group. */
+const getLogger = (workflowRunId, contextId, dataContext) => {
     return async (logData) => {
         try {
             let logRecord;
             if (typeof logData === "string") {
-                logRecord = WorkflowLogs().initRecord({
+                logRecord = WorkflowLogs(dataContext).initRecord({
                     workflowRunId,
                     workflowLogId: (0, utils_1.newid)(),
                     logText: logData,
                 });
             }
             else {
-                logRecord = WorkflowLogs().initRecord({
+                logRecord = WorkflowLogs(dataContext).initRecord({
                     workflowRunId,
                     workflowLogId: (0, utils_1.newid)(),
                     ...logData,
@@ -63,7 +66,7 @@ const getLogger = (workflowRunId, contextId) => {
             logRecord.workflowRunId = workflowRunId;
             logRecord.logText = logRecord.logText || "";
             logRecord.contextId = contextId;
-            return await WorkflowLogs().insert(logRecord);
+            return await WorkflowLogs(dataContext).insert(logRecord);
         }
         catch (err) {
             // console.error(`Error recording log for assistant run - assistantId: ${assistantId}, messageId: ${messageId}, logData: ${logData}`, err);
@@ -73,4 +76,3 @@ const getLogger = (workflowRunId, contextId) => {
     };
 };
 exports.getLogger = getLogger;
-// export type IWorkflowLogger = ReturnType<typeof getLogger>;

package/dist/data/workflow-runs.d.ts

@@ -33,7 +33,6 @@ export declare const workflowRunSchema: z.ZodObject<{
     defaultAssistantId: z.ZodEffects<z.ZodString, string, string>;
 }, "strip", z.ZodTypeAny, {
     createdAt: Date;
-    workflowRunId: string;
     defaultAssistantId: string;
     instructions: {
         markdown?: string | undefined;
@@ -41,12 +40,13 @@ export declare const workflowRunSchema: z.ZodObject<{
         directCallToolId?: string | undefined;
         subWorkflowId?: string | undefined;
     }[];
-    parentMessageId: string;
-    currentInstructionIndex: number;
-    instructionResults: any[];
     vars: {} & {
         [k: string]: any;
     };
+    workflowRunId: string;
+    parentMessageId: string;
+    currentInstructionIndex: number;
+    instructionResults: any[];
     workflowId?: string | undefined;
     scheduleDT?: Date | undefined;
     inErrorState?: boolean | undefined;
@@ -54,8 +54,8 @@ export declare const workflowRunSchema: z.ZodObject<{
     completedAt?: Date | undefined;
     parentWorkflowRunId?: string | undefined;
 }, {
-    workflowRunId: string;
     defaultAssistantId: string;
+    workflowRunId: string;
     parentMessageId: string;
     createdAt?: Date | undefined;
     workflowId?: string | undefined;
@@ -65,13 +65,13 @@ export declare const workflowRunSchema: z.ZodObject<{
         directCallToolId?: string | undefined;
         subWorkflowId?: string | undefined;
     }[] | undefined;
+    vars?: z.objectInputType<{}, z.ZodAny, "strip"> | undefined;
     scheduleDT?: Date | undefined;
     currentInstructionIndex?: number | undefined;
     instructionResults?: any[] | undefined;
     inErrorState?: boolean | undefined;
     startedAt?: Date | undefined;
     completedAt?: Date | undefined;
-    vars?: z.objectInputType<{}, z.ZodAny, "strip"> | undefined;
     parentWorkflowRunId?: string | undefined;
 }>;
 export type IWorkflowRun = z.infer<typeof workflowRunSchema>;

package/dist/index.d.ts

@@ -38,8 +38,6 @@ export * from "./peers-ui/peers-ui.types";
 export * from "./rpc-types";
 export * from "./serial-json";
 export * from "./system-ids";
-export * from "./tools";
-export * as tools from "./tools";
 export * from "./types/app-nav";
 export * from "./types/assistant-runner-args";
 export * from "./types/field-type";

package/dist/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.tools = exports.workflowLogSchema = exports.WorkflowLogs = exports.getLogger = exports.orm = exports.data = void 0;
+exports.workflowLogSchema = exports.WorkflowLogs = exports.getLogger = exports.orm = exports.data = void 0;
 __exportStar(require("./context"), exports);
 __exportStar(require("./contracts"), exports);
 __exportStar(require("./data"), exports);
@@ -59,8 +59,6 @@ __exportStar(require("./peers-ui/peers-ui.types"), exports);
 __exportStar(require("./rpc-types"), exports);
 __exportStar(require("./serial-json"), exports);
 __exportStar(require("./system-ids"), exports);
-__exportStar(require("./tools"), exports);
-exports.tools = require("./tools");
 __exportStar(require("./types/app-nav"), exports);
 __exportStar(require("./types/assistant-runner-args"), exports);
 __exportStar(require("./types/field-type"), exports);

package/dist/package-loader/contract-package-loader.d.ts

@@ -1,18 +1,27 @@
 import type { DataContext } from "../context/data-context";
-import type { ContractRegistry } from "../contracts/registry";
+import { ContractRegistry } from "../contracts/registry";
 import type { IPackageDefinitionResult } from "../contracts/types";
 /**
  * Installs a contract-based package into a DataContext.
  *
  * Handles packages that export an `IPackageDefinitionResult` from `definePackage()`.
- * Registers contracts in the provided ContractRegistry, saves tools/assistants/workflows
- * with the `packageId` from the definition set, and registers table definitions.
+ * Materializes catalog identities and supplemental metadata, publishes contract providers,
+ * saves package assistants and registers table definitions after successful preparation.
  *
  * When a contract version was previously frozen (promoted to stable), the
  * installer preserves its stable status rather than re-registering it as dev.
+ * Without `opts.registry` or the context's PackageLoader registry, catalog rows
+ * are still written but no provider is published.
  */
 export declare function installContractPackage(dataContext: DataContext, packageDefinition: IPackageDefinitionResult, opts?: {
+    /** Registry to publish into; defaults to the context's PackageLoader registry. */
     registry?: ContractRegistry;
+    /** Complete fallible loader bookkeeping before provider publication. */
+    prepare?: () => Promise<void>;
+    /** Publish in-memory loader state in the same serialized activation turn. */
+    onActivated?: () => void;
+    /** Reject a load invalidated by unload, including after asynchronous preparation. */
+    assertCurrent?: () => void;
 }): Promise<void>;
 /**
  * Attempts to extract an `IPackageDefinitionResult` from a bundle's module exports.

package/dist/package-loader/contract-package-loader.js

@@ -4,68 +4,72 @@ exports.installContractPackage = installContractPackage;
 exports.extractPackageDefinition = extractPackageDefinition;
 exports.hasPackageDefinition = hasPackageDefinition;
 exports.finalizeContractsForPromotion = finalizeContractsForPromotion;
-const tools_1 = require("../data/tools");
-const tools_2 = require("../tools");
+const registry_1 = require("../contracts/registry");
+const tool_catalog_1 = require("../contracts/tool-catalog");
 /**
  * Installs a contract-based package into a DataContext.
  *
  * Handles packages that export an `IPackageDefinitionResult` from `definePackage()`.
- * Registers contracts in the provided ContractRegistry, saves tools/assistants/workflows
- * with the `packageId` from the definition set, and registers table definitions.
+ * Materializes catalog identities and supplemental metadata, publishes contract providers,
+ * saves package assistants and registers table definitions after successful preparation.
  *
  * When a contract version was previously frozen (promoted to stable), the
  * installer preserves its stable status rather than re-registering it as dev.
+ * Without `opts.registry` or the context's PackageLoader registry, catalog rows
+ * are still written but no provider is published.
  */
 async function installContractPackage(dataContext, packageDefinition, opts) {
     const { packageId } = packageDefinition;
-    const registry = opts?.registry;
-    const registrations = registry
-        ? packageDefinition.contracts.map((contract) => {
-            const key = `${contract.contractId}@${contract.version}`;
-            const alsoImpl = packageDefinition.alsoImplements.get(key) ?? [];
-            // If the contract is already frozen in the registry, re-register as
-            // stable instead of dev to preserve immutability.
-            const existing = registry.getDefinition(contract.contractId, contract.version);
-            let effectiveContract = contract;
-            if (existing && !existing.devTag && contract.devTag === "dev") {
-                effectiveContract = { ...contract, devTag: undefined };
+    const sharedRegistry = opts?.registry ?? dataContext.packageLoader?.contractRegistry;
+    // Without a context registry, providers go to a throwaway registry (none are
+    // published, as before) whose catalog is disposed with this call.
+    const registry = sharedRegistry ?? new registry_1.ContractRegistry();
+    const registrations = packageDefinition.contracts.map((contract) => {
+        const key = `${contract.contractId}@${contract.version}`;
+        const existing = registry.getDefinition(contract.contractId, contract.version);
+        const definition = existing && !existing.devTag && contract.devTag === "dev"
+            ? { ...contract, devTag: undefined }
+            : contract;
+        return { definition, alsoImplements: packageDefinition.alsoImplements.get(key) ?? [] };
+    });
+    const catalog = registry.toolCatalog ?? new tool_catalog_1.ToolCatalog(dataContext, registry);
+    const prepare = async () => {
+        opts?.assertCurrent?.();
+        // Install assistants with packageId
+        const { Assistants } = await Promise.resolve().then(() => require("../data/assistants"));
+        for (const assistant of packageDefinition.assistants) {
+            const assistantWithPackageId = { ...assistant, packageId };
+            await Assistants(dataContext).save(assistantWithPackageId);
+        }
+        await opts?.prepare?.();
+    };
+    const activate = () => {
+        opts?.assertCurrent?.();
+        // Publish table definitions in the guarded activation turn, after the
+        // coordinator's final catalog writes. Preparation must leave live tables alone.
+        if (packageDefinition.tableDefinitions.length) {
+            dataContext.tableContainer.registerTableDefinitions(packageDefinition.tableDefinitions, {
+                overwrite: true,
+            });
+        }
+        // Activate the new provider only after all fallible package-owned persistence
+        // has succeeded, so a failed update leaves the previous provider routable.
+        {
+            const result = registry.replaceBatch(packageId, registrations);
+            if (!result.valid) {
+                throw new Error(`Atomic contract registration failed for package ${packageId}: ${result.errors
+                    .map((error) => error.message)
+                    .join("; ")}`);
             }
-            return { definition: effectiveContract, alsoImplements: alsoImpl };
-        })
-        : undefined;
-    const validation = registrations ? registry?.validateBatch(packageId, registrations) : undefined;
-    if (validation && !validation.valid) {
-        throw new Error(`Atomic contract registration failed for package ${packageId}: ${validation.errors
-            .map((error) => error.message)
-            .join("; ")}`);
-    }
-    // Install tool instances with packageId
-    for (const toolInstance of packageDefinition.toolInstances) {
-        (0, tools_2.registerTool)(toolInstance);
-        const toolWithPackageId = { ...toolInstance.tool, packageId };
-        await (0, tools_1.Tools)(dataContext).save(toolWithPackageId);
-    }
-    // Install table definitions
-    for (const tableDefinition of packageDefinition.tableDefinitions) {
-        dataContext.tableContainer.registerTableDefinition(tableDefinition, {
-            overwrite: true,
-        });
-    }
-    // Install assistants with packageId
-    const { Assistants } = await Promise.resolve().then(() => require("../data/assistants"));
-    for (const assistant of packageDefinition.assistants) {
-        const assistantWithPackageId = { ...assistant, packageId };
-        await Assistants(dataContext).save(assistantWithPackageId);
-    }
-    // Activate the new provider only after all fallible package-owned persistence
-    // has succeeded, so a failed update leaves the previous provider routable.
-    if (registry && registrations) {
-        const result = registry.replaceBatch(packageId, registrations);
-        if (!result.valid) {
-            throw new Error(`Atomic contract registration failed for package ${packageId}: ${result.errors
-                .map((error) => error.message)
-                .join("; ")}`);
         }
+        opts?.onActivated?.();
+    };
+    try {
+        await catalog.publish(packageId, registrations, prepare, activate, packageDefinition.toolMetadata ?? []);
+    }
+    finally {
+        if (!sharedRegistry)
+            await catalog.dispose();
     }
 }
 /**

package/dist/package-loader/contract-package-loader.test.d.ts

@@ -1 +1 @@
-export {};
+import "../index";