@peers-app/peers-sdk 0.27.3 → 0.27.4

package/dist/data/orm/types.d.ts

@@ -26,24 +26,33 @@ export interface ITableMetaData {
     versionNumber?: number;
 }
 /**
- * Convert field metadata to the runtime Zod schema the Runtime validates with: table rows and
- * tool arguments.
+ * Convert field metadata to the runtime Zod schema the Runtime validates table rows with.
  *
  * It checks types only: `type`, `isArray`, and `optional`. An object field accepts any object
- * and keeps its keys; nested `fields` and `enumValues` aren't checked, so a row or call from a
- * package built against a newer shape isn't refused. {@link fieldsToShapeSchema} builds the full
- * shape. An optional field refuses `null`: remove empty fields first with
- * {@link withoutEmptyFields}.
+ * and keeps its keys; nested `fields` and `enumValues` aren't checked, so a row from a package
+ * built against a newer shape isn't refused. A tool's arguments are checked with the stricter
+ * {@link fieldsToArgumentsSchema}, and {@link fieldsToShapeSchema} builds the full shape. An
+ * optional field refuses `null`: remove empty fields first with {@link withoutEmptyFields}.
  *
  * @param fields Serializable field definitions.
  * @param codeSchema Optional author schema whose refinements are intersected.
  */
 export declare function fieldsToSchema(fields: IField[], codeSchema?: z.AnyZodObject): z.AnyZodObject;
+/**
+ * Convert a tool's input fields to the Zod schema the Runtime checks its arguments with before
+ * the provider runs. Like {@link fieldsToSchema}, and also: a required field must be present
+ * whatever its type (`any` included), and a field's `enumValues` are enforced. A contract
+ * version's fields don't change once it is stable, so a caller and its provider agree on them.
+ * Nested object `fields` still aren't checked, and keys no field names pass.
+ *
+ * @param fields A tool's input fields.
+ */
+export declare function fieldsToArgumentsSchema(fields: IField[]): z.AnyZodObject;
 /**
  * Convert field metadata to a Zod schema with every shape the IR carries: nested object
  * `fields` and `enumValues`, as well as types. Objects keep keys their `fields` don't list. For
  * describing a tool's arguments to an assistant's model; the Runtime validates with
- * {@link fieldsToSchema}.
+ * {@link fieldsToArgumentsSchema}.
  *
  * @param fields Serializable field definitions.
  */
@@ -72,6 +81,14 @@ export declare function withoutEmptyFields<T>(fields: IField[], value: T): T;
  * @param fields A table definition's fields.
  */
 export declare function comparableTableFields(fields: IField[]): Partial<IField>[];
+/**
+ * The scalar values an enum, a native enum, a literal, or a union of them allows; undefined for
+ * anything else.
+ *
+ * @internal
+ * @param schema A field's Zod schema, unwrapped to its value type.
+ */
+export declare function zodEnumValues(schema: z.ZodTypeAny): (string | number | boolean)[] | undefined;
 /**
  * Convert a Zod object schema to serializable field metadata.
  *

package/dist/data/orm/types.js

@@ -1,39 +1,52 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.fieldsToSchema = fieldsToSchema;
+exports.fieldsToArgumentsSchema = fieldsToArgumentsSchema;
 exports.fieldsToShapeSchema = fieldsToShapeSchema;
 exports.withoutEmptyFields = withoutEmptyFields;
 exports.comparableTableFields = comparableTableFields;
+exports.zodEnumValues = zodEnumValues;
 exports.schemaToFields = schemaToFields;
 const zod_1 = require("zod");
 const field_type_1 = require("../../types/field-type");
 const utils_1 = require("../../utils");
 /**
- * Convert field metadata to the runtime Zod schema the Runtime validates with: table rows and
- * tool arguments.
+ * Convert field metadata to the runtime Zod schema the Runtime validates table rows with.
  *
  * It checks types only: `type`, `isArray`, and `optional`. An object field accepts any object
- * and keeps its keys; nested `fields` and `enumValues` aren't checked, so a row or call from a
- * package built against a newer shape isn't refused. {@link fieldsToShapeSchema} builds the full
- * shape. An optional field refuses `null`: remove empty fields first with
- * {@link withoutEmptyFields}.
+ * and keeps its keys; nested `fields` and `enumValues` aren't checked, so a row from a package
+ * built against a newer shape isn't refused. A tool's arguments are checked with the stricter
+ * {@link fieldsToArgumentsSchema}, and {@link fieldsToShapeSchema} builds the full shape. An
+ * optional field refuses `null`: remove empty fields first with {@link withoutEmptyFields}.
  *
  * @param fields Serializable field definitions.
  * @param codeSchema Optional author schema whose refinements are intersected.
  */
 function fieldsToSchema(fields, codeSchema) {
-    return buildFieldsSchema(fields, false, codeSchema);
+    return buildFieldsSchema(fields, "rows", codeSchema);
+}
+/**
+ * Convert a tool's input fields to the Zod schema the Runtime checks its arguments with before
+ * the provider runs. Like {@link fieldsToSchema}, and also: a required field must be present
+ * whatever its type (`any` included), and a field's `enumValues` are enforced. A contract
+ * version's fields don't change once it is stable, so a caller and its provider agree on them.
+ * Nested object `fields` still aren't checked, and keys no field names pass.
+ *
+ * @param fields A tool's input fields.
+ */
+function fieldsToArgumentsSchema(fields) {
+    return buildFieldsSchema(fields, "arguments");
 }
 /**
  * Convert field metadata to a Zod schema with every shape the IR carries: nested object
  * `fields` and `enumValues`, as well as types. Objects keep keys their `fields` don't list. For
  * describing a tool's arguments to an assistant's model; the Runtime validates with
- * {@link fieldsToSchema}.
+ * {@link fieldsToArgumentsSchema}.
  *
  * @param fields Serializable field definitions.
  */
 function fieldsToShapeSchema(fields) {
-    return buildFieldsSchema(fields, true);
+    return buildFieldsSchema(fields, "shapes");
 }
 function enumSchema(values) {
     if (values.every((value) => typeof value === "string")) {
@@ -44,8 +57,8 @@ function enumSchema(values) {
         ? literals[0]
         : zod_1.z.union(literals);
 }
-function fieldValueSchema(field, shapes, open) {
-    if (shapes && field.enumValues?.length) {
+function fieldValueSchema(field, mode, open) {
+    if (mode !== "rows" && field.enumValues?.length) {
         return enumSchema(field.enumValues);
     }
     switch (field.type) {
@@ -63,7 +76,9 @@ function fieldValueSchema(field, shapes, open) {
         case "Date":
             return zod_1.z.date();
         case "object": {
-            const object = shapes && field.fields ? buildFieldsSchema(field.fields, true) : zod_1.z.object({});
+            const object = mode === "shapes" && field.fields
+                ? buildFieldsSchema(field.fields, "shapes")
+                : zod_1.z.object({});
             // An author schema intersected with this one parses the value itself; two parses of
             // one object can't be merged, so only an open object keeps its keys.
             return open ? object.passthrough() : object;
@@ -72,12 +87,12 @@ function fieldValueSchema(field, shapes, open) {
             return zod_1.z.any();
     }
 }
-function buildFieldsSchema(fields, shapes, codeSchema) {
+function buildFieldsSchema(fields, mode, codeSchema) {
     let argsSchema = zod_1.z.object({});
     for (const field of fields) {
         const { name, description, isArray, defaultValue, optional } = field;
         const shapeField = codeSchema?.shape?.[name];
-        let propertyType = fieldValueSchema(field, shapes, !shapeField);
+        let propertyType = fieldValueSchema(field, mode, !shapeField);
         if (isArray) {
             propertyType = propertyType.array();
         }
@@ -87,6 +102,11 @@ function buildFieldsSchema(fields, shapes, codeSchema) {
         if (defaultValue !== undefined) {
             propertyType = propertyType.default(defaultValue);
         }
+        else if (mode !== "rows" && !optional) {
+            // `z.any()` accepts a missing value; a required argument must be there, and a model
+            // describing it must see it listed as required.
+            propertyType = propertyType.refine((value) => value !== undefined, { message: "Required" });
+        }
         propertyType = propertyType.describe(description ?? "");
         if (shapeField) {
             propertyType = zod_1.z.intersection(propertyType, shapeField);
@@ -189,6 +209,42 @@ function comparableTableFields(fields) {
         return comparable;
     });
 }
+/**
+ * The scalar values an enum, a native enum, a literal, or a union of them allows; undefined for
+ * anything else.
+ *
+ * @internal
+ * @param schema A field's Zod schema, unwrapped to its value type.
+ */
+function zodEnumValues(schema) {
+    const def = schema._def;
+    switch (def.typeName) {
+        case "ZodEnum":
+            return [...def.values];
+        case "ZodNativeEnum": {
+            // A numeric TypeScript enum maps each value back to its name too; skip those keys.
+            const values = def.values;
+            return Object.keys(values)
+                .filter((key) => typeof values[values[key]] !== "number")
+                .map((key) => values[key]);
+        }
+        case "ZodLiteral":
+            return ["string", "number", "boolean"].includes(typeof def.value) ? [def.value] : undefined;
+        case "ZodUnion": {
+            const values = [];
+            for (const option of def.options) {
+                const optionValues = zodEnumValues(option);
+                if (!optionValues) {
+                    return undefined;
+                }
+                values.push(...optionValues);
+            }
+            return values;
+        }
+        default:
+            return undefined;
+    }
+}
 /**
  * Convert a Zod object schema to serializable field metadata.
  *
@@ -199,26 +255,30 @@ function schemaToFields(schema) {
     for (const name of Object.keys(schema.shape)) {
         const field = schema.shape[name];
         let type = field_type_1.FieldType.any;
+        let valueSchema = field;
+        let nullable = false;
+        let enumElements = true;
         let _def = field._def;
         let isArray;
         let brandedFieldType;
         while (true) {
             if (_def.typeName === "ZodArray") {
+                if (isArray)
+                    enumElements = false;
                 isArray = true;
             }
+            if (isArray && (_def.typeName === "ZodOptional" || _def.typeName === "ZodDefault"))
+                enumElements = false;
             if (_def._fieldType) {
                 brandedFieldType = _def._fieldType;
             }
-            if (_def.innerType) {
-                _def = _def.innerType._def;
-                continue;
-            }
-            if (_def.schema) {
-                _def = _def.schema._def;
-                continue;
+            if (_def.typeName === "ZodNullable") {
+                nullable = true;
             }
-            if (_def.type) {
-                _def = _def.type._def;
+            const inner = _def.innerType ?? _def.schema ?? _def.type;
+            if (inner) {
+                valueSchema = inner;
+                _def = inner._def;
                 continue;
             }
             break;
@@ -255,7 +315,20 @@ function schemaToFields(schema) {
         const optional = field._def.typeName === "ZodOptional" || undefined;
         const description = field._def.description;
         const defaultValue = field._def.defaultValue;
-        const newField = { name, type, isArray, optional, description, defaultValue };
+        // The type stays as it was (an enum is `any`) so stable contract shapes don't change. A
+        // nullable enum also allows null, which a list of values can't say. The same is true of
+        // optional/defaulted elements and nested arrays: enumValues describes each immediate element.
+        const values = nullable || !enumElements ? undefined : zodEnumValues(valueSchema);
+        const enumValues = values?.length ? [...new Set(values)] : undefined;
+        const newField = {
+            name,
+            type,
+            isArray,
+            optional,
+            description,
+            defaultValue,
+            enumValues,
+        };
         Object.keys(newField).forEach((k) => {
             // @ts-expect-error
             if (newField[k] === undefined)

package/dist/define/manifest.js

@@ -49,36 +49,6 @@ function literalType(schema) {
         return field_type_1.FieldType.boolean;
     return undefined;
 }
-/** The scalar values an enum, a literal, or a union of them allows; undefined for anything else. */
-function enumValuesOf(schema) {
-    const def = schema._def;
-    switch (def.typeName) {
-        case "ZodEnum":
-            return [...def.values];
-        case "ZodNativeEnum": {
-            // A numeric TypeScript enum maps each value back to its name too; skip those keys.
-            const values = def.values;
-            return Object.keys(values)
-                .filter((key) => typeof values[values[key]] !== "number")
-                .map((key) => values[key]);
-        }
-        case "ZodLiteral":
-            return ["string", "number", "boolean"].includes(typeof def.value) ? [def.value] : undefined;
-        case "ZodUnion": {
-            const values = [];
-            for (const option of def.options) {
-                const optionValues = enumValuesOf(option);
-                if (!optionValues) {
-                    return undefined;
-                }
-                values.push(...optionValues);
-            }
-            return values;
-        }
-        default:
-            return undefined;
-    }
-}
 /**
  * What a field's schema says beyond its type: an object's own fields and the values an enum or
  * literal allows. Walks the wrappers `schemaToFields` walks, into one array's elements, and
@@ -153,7 +123,7 @@ function fieldDetails(schema, shape, input, depth, path, event = false, wholeVal
             ? eventFields(current, depth + 1, path)
             : irFields(current, input, depth + 1, path);
     }
-    const values = enumValuesOf(current);
+    const values = (0, types_1.zodEnumValues)(current);
     if (!emptyElement && values?.length && values.every((value) => (0, isolated_artifact_1.enumValueFits)(value, type))) {
         details.enumValues = [...new Set(values)];
     }
@@ -190,8 +160,10 @@ function irField(schema, schemaField, input, depth, path, wholeValue = false) {
     const generated = (0, generated_field_1.generatedFieldMetadata)(schema);
     if (generated)
         return { name: schemaField.name, ...generated.shape };
-    const literal = schemaField.type === field_type_1.FieldType.any ? literalType(schema) : undefined;
-    const field = literal ? { ...schemaField, type: literal } : schemaField;
+    // The IR records enum values itself (fieldDetails), only where they fit the field's type.
+    const { enumValues: _enumValues, ...plainField } = schemaField;
+    const literal = plainField.type === field_type_1.FieldType.any ? literalType(schema) : undefined;
+    const field = literal ? { ...plainField, type: literal } : plainField;
     const { defaultValue: _default, ...rest } = field;
     const result = typeof _default === "function" ? rest : field;
     const details = fieldDetails(schema, field, input, depth, path, false, wholeValue);
@@ -500,7 +472,7 @@ function eventFields(schema, depth = 1, parent = "") {
         const generated = (0, generated_field_1.generatedFieldMetadata)(schema.shape[field.name]);
         if (generated)
             return { name: field.name, ...generated.shape };
-        const { type: _type, optional: _optional, isArray: _array, defaultValue, ...metadata } = field;
+        const { type: _type, optional: _optional, isArray: _array, defaultValue, enumValues: _enumValues, ...metadata } = field;
         const shape = eventValueShape(schema.shape[field.name]);
         const path = parent ? `${parent}.${field.name}` : field.name;
         return {

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

@@ -9,6 +9,7 @@ const contract_resolvers_1 = require("../contracts/contract-resolvers");
 const contract_transport_1 = require("../contracts/contract-transport");
 const registry_1 = require("../contracts/registry");
 const remote_contract_transport_1 = require("../contracts/remote-contract-transport");
+const tool_arguments_1 = require("../contracts/tool-arguments");
 const tool_catalog_1 = require("../contracts/tool-catalog");
 const files_1 = require("../data/files");
 const package_version_resolver_1 = require("../data/package-version-resolver");
@@ -412,7 +413,7 @@ class PackageLoader {
                 (0, contract_resolvers_1.getContractResolver)(implementation.contractId, implementation.version, providerPackageId, this.dataContext) !== resolver)
                 throw new contract_provider_router_1.RetiredContractProviderEndpointError(guardedEndpoint);
         };
-        const endpoint = (0, contract_proxy_1.createContractProviderEndpoint)(this.guardResolutionTools(localResolution, request, assertProviderCurrent), {
+        const endpoint = (0, contract_proxy_1.createContractProviderEndpoint)(this.guardResolutionTools(localResolution, request, assertProviderCurrent, providerPackageId), {
             dispatchTool: (target, args, context) => this.dispatchToolFromProvider(providerPackageId, target, args, context),
             context: request.context,
             notify: (notification) => request.notify({
@@ -435,29 +436,33 @@ class PackageLoader {
         };
         return guardedEndpoint;
     }
-    guardResolutionTools(resolution, request, assertProviderCurrent) {
-        const guard = (instances) => instances &&
-            Object.fromEntries(Object.entries(instances).map(([name, instance]) => [
-                name,
-                {
-                    ...instance,
-                    // The dispatcher awaits authorization before calling toolFn. Check again
-                    // here so those awaits cannot retain old code. Once provider code has
-                    // started, its nested action errors must not request a router replay.
-                    toolFn: async (...args) => {
-                        await this.toolCatalog.assertTargetUsable({
-                            contractId: request.contractId,
-                            version: request.version,
-                            toolName: name,
-                        });
-                        assertProviderCurrent();
-                        return instance.toolFn(...args);
-                    },
-                },
-            ]));
+    guardResolutionTools(resolution, request, assertProviderCurrent, providerPackageId) {
+        // The version the caller asked for: each run's arguments are checked against its tools.
+        const definition = (providerPackageId &&
+            this.contractRegistry.getProviderDefinition(request.contractId, request.version, providerPackageId)) ||
+            this.contractRegistry.getDefinition(request.contractId, request.version);
         return {
             ...resolution,
-            tools: guard(resolution.tools),
+            invokeTool: async (name, args) => {
+                // Authorization may await; retire old code before checking its schema or running it.
+                // Nested action errors after this point must not request a router replay.
+                await this.toolCatalog.assertTargetUsable({
+                    contractId: request.contractId,
+                    version: request.version,
+                    toolName: name,
+                });
+                assertProviderCurrent();
+                const tool = resolution.tools?.[name];
+                if (!tool)
+                    throw new Error(`Contract ${request.contractId} does not provide tool '${name}'`);
+                const member = definition?.tools.find((tool) => tool.name === name);
+                if (definition && !member)
+                    throw new Error(`Contract ${request.contractId} does not declare tool '${name}'`);
+                const inputFields = member?.inputFields ?? tool.tool.inputSchema?.fields;
+                if (inputFields?.length)
+                    (0, tool_arguments_1.checkToolArguments)(inputFields, args[0], name);
+                return tool.toolFn(...args);
+            },
         };
     }
     /**

package/dist/system-ids.d.ts

@@ -71,6 +71,11 @@ export declare const networkControlContractId = "00ms1yb50yj9w5qbytl69qfht";
  * provide status and relay tools, while Electron also implements local updates.
  */
 export declare const appUpdatesContractId = "00mvczoafequsatpfjaj3r4g8";
+/**
+ * Contract id for **System Sync Check**: the daily check that finds changes another device has
+ * and this one is missing. `countChanges` is remotely callable by group Readers.
+ */
+export declare const syncCheckContractId = "00mvrnfgmc14ea0ktkr86vjd2";
 /**
  * Contract id for the local-only tool-access approval control surface.
  * Not available over device-to-device connections.

package/dist/system-ids.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.hostShellContractId = exports.packagesContractId = exports.desktopToolsContractId = exports.hostToolsContractId = exports.toolCatalogContractId = exports.schedulerToolIds = exports.schedulerContractId = exports.contractCatalogToolIds = exports.contractCatalogContractId = exports.httpToolIds = exports.httpContractId = exports.localFoldersToolIds = exports.localFoldersContractId = exports.identityToolIds = exports.identityContractId = exports.invitesToolIds = exports.invitesContractId = exports.toolAccessControlToolIds = exports.toolAccessControlContractId = exports.appUpdatesContractId = exports.networkControlContractId = exports.networkDiagnosticsContractId = exports.deviceOperationsContractId = exports.logsContractId = exports.peersSystemPackageId = exports.peersCoreRevokedPublishPublicKeys = exports.peersCorePublishPublicKey = exports.peersCorePackageRepoUrl = exports.peersCorePackageId = exports.createGroupToolId = exports.queryDatabaseToolId = exports.runWorkflowToolId = exports.defaultSendMessageToolId = exports.defaultAssistantRunnerToolId = exports.adminAssistantId = exports.openCodeAssistantId = exports.defaultAssistantId = exports.peersRootUserId = void 0;
+exports.hostShellContractId = exports.packagesContractId = exports.desktopToolsContractId = exports.hostToolsContractId = exports.toolCatalogContractId = exports.schedulerToolIds = exports.schedulerContractId = exports.contractCatalogToolIds = exports.contractCatalogContractId = exports.httpToolIds = exports.httpContractId = exports.localFoldersToolIds = exports.localFoldersContractId = exports.identityToolIds = exports.identityContractId = exports.invitesToolIds = exports.invitesContractId = exports.toolAccessControlToolIds = exports.toolAccessControlContractId = exports.syncCheckContractId = exports.appUpdatesContractId = exports.networkControlContractId = exports.networkDiagnosticsContractId = exports.deviceOperationsContractId = exports.logsContractId = exports.peersSystemPackageId = exports.peersCoreRevokedPublishPublicKeys = exports.peersCorePublishPublicKey = exports.peersCorePackageRepoUrl = exports.peersCorePackageId = exports.createGroupToolId = exports.queryDatabaseToolId = exports.runWorkflowToolId = exports.defaultSendMessageToolId = exports.defaultAssistantRunnerToolId = exports.adminAssistantId = exports.openCodeAssistantId = exports.defaultAssistantId = exports.peersRootUserId = void 0;
 /** Stable user ID that owns built-in Peers system records. */
 exports.peersRootUserId = "000peers0user000000000001";
 /** Default assistant used when no user-selected assistant is available. */
@@ -78,6 +78,11 @@ exports.networkControlContractId = "00ms1yb50yj9w5qbytl69qfht";
  * provide status and relay tools, while Electron also implements local updates.
  */
 exports.appUpdatesContractId = "00mvczoafequsatpfjaj3r4g8";
+/**
+ * Contract id for **System Sync Check**: the daily check that finds changes another device has
+ * and this one is missing. `countChanges` is remotely callable by group Readers.
+ */
+exports.syncCheckContractId = "00mvrnfgmc14ea0ktkr86vjd2";
 /**
  * Contract id for the local-only tool-access approval control surface.
  * Not available over device-to-device connections.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@peers-app/peers-sdk",
-  "version": "0.27.3",
+  "version": "0.27.4",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/peers-app/peers-sdk.git"
@@ -16,7 +16,9 @@
     "dist",
     "define",
     "testing",
-    "bin"
+    "bin",
+    "!dist/**/*.test.*",
+    "!dist/**/__tests__"
   ],
   "publishConfig": {
     "access": "public"

package/dist/context/user-context-identity.test.d.ts

@@ -1 +0,0 @@
-import "../identity/user-row-change";