@stndrds/schema 1.0.0-alpha.293 → 1.0.0-alpha.68

package/dist/capabilities.d.mts

@@ -1,146 +0,0 @@
-import { z } from 'zod';
-
-/** Accepted forms of the object identifier every object-scoped capability takes. */
-declare const OBJECT_ID_DESCRIPTION = "Object UUID, kebab-case name (e.g., 'contacts'), or display label (e.g., 'Personne physique'). All three are accepted; UUID is most precise.";
-/** Shared suffix for record `data` inputs that accept `$fromSandboxFile` references for large content. */
-declare const SANDBOX_FILE_DATA_HINT = " For large text content (> a few KB), write it to a sandbox file first and pass {\"$fromSandboxFile\": \"/workspace/<file>\"} as the attribute value \u2014 the server substitutes the file content.";
-/**
- * The LLM-facing filter shape, deliberately looser than its two siblings:
- * `types/filters.ts` (`FilterState`, the canonical TS model — its `quantifier`
- * is omitted here on purpose, agents don't set edge quantifiers) and
- * `validators/view-config.schema.ts` (`filterStateSchema`, the strict capped
- * variant for stored view config). The operator list in the describe text
- * restates `filters/operators.ts` (`OPERATOR_SPECS`) and
- * `filters/normalize-operator.ts` (`SYNONYM_ALIASES`) — those are the source
- * of truth; keep the prose in sync when adding an operator.
- */
-declare const filtersSchema: z.ZodObject<{
-    combinator: z.ZodDefault<z.ZodEnum<{
-        and: "and";
-        or: "or";
-    }>>;
-    rules: z.ZodArray<z.ZodObject<{
-        attribute: z.ZodString;
-        property: z.ZodOptional<z.ZodString>;
-        operator: z.ZodString;
-        value: z.ZodNullable<z.ZodUnknown>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-declare const sortsSchema: z.ZodArray<z.ZodObject<{
-    attribute: z.ZodString;
-    direction: z.ZodEnum<{
-        asc: "asc";
-        desc: "desc";
-    }>;
-}, z.core.$strip>>;
-/**
- * Filter shapes derived from {@link filtersSchema} so the capability schema stays
- * the single source of truth.
- *
- * The *parsed* shape (`z.infer`), deliberately: the runtime holds these after
- * validation, when `combinator` has already been defaulted. What a caller may
- * omit is `z.input`, and that is what {@link CapabilityInput} exposes.
- */
-type FilterStateInput = z.infer<typeof filtersSchema>;
-type FilterRuleInput = FilterStateInput["rules"][number];
-/** How a capability mutates data, which decides whether a rehearsal captures it. */
-type CapabilityKind = "read" | "create" | "update" | "delete";
-/**
- * Every capability a Reflex may call, defined once.
- *
- * Deliberately five entries — the single-record tools whose input the gateway can
- * turn into a faithful `RunEffect`. Excluded on purpose: `get_schema`,
- * `global_search` and `bulk_search`, which are not scoped to one object and so
- * yield no object to grant a permission on; and the `bulk_*` record tools, where
- * one call mutates many records and would be recorded as a single effect, making
- * an effects report understate what happened.
- *
- * `description` is NOT here: the tools compute it per call from their config
- * (`schemaInContext` changes the wording), and `schema-tools-descriptions.test.ts`
- * pins both variants. The name, the kind and the input schema are what must exist
- * exactly once, and they do.
- */
-declare const RECORD_CAPABILITIES: {
-    readonly get_record: {
-        readonly name: "get_record";
-        readonly kind: "read";
-        readonly input: z.ZodObject<{
-            recordId: z.ZodString;
-            fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>;
-    };
-    readonly search_records: {
-        readonly name: "search_records";
-        readonly kind: "read";
-        readonly input: z.ZodObject<{
-            objectId: z.ZodString;
-            _displayLabel: z.ZodOptional<z.ZodString>;
-            query: z.ZodOptional<z.ZodString>;
-            limit: z.ZodOptional<z.ZodNumber>;
-            offset: z.ZodOptional<z.ZodNumber>;
-            fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            filters: z.ZodOptional<z.ZodObject<{
-                combinator: z.ZodDefault<z.ZodEnum<{
-                    and: "and";
-                    or: "or";
-                }>>;
-                rules: z.ZodArray<z.ZodObject<{
-                    attribute: z.ZodString;
-                    property: z.ZodOptional<z.ZodString>;
-                    operator: z.ZodString;
-                    value: z.ZodNullable<z.ZodUnknown>;
-                }, z.core.$strip>>;
-            }, z.core.$strip>>;
-            sorts: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                attribute: z.ZodString;
-                direction: z.ZodEnum<{
-                    asc: "asc";
-                    desc: "desc";
-                }>;
-            }, z.core.$strip>>>;
-        }, z.core.$strip>;
-    };
-    readonly create_record: {
-        readonly name: "create_record";
-        readonly kind: "create";
-        readonly input: z.ZodObject<{
-            objectId: z.ZodString;
-            _displayLabel: z.ZodOptional<z.ZodString>;
-            data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-        }, z.core.$strip>;
-    };
-    readonly update_record: {
-        readonly name: "update_record";
-        readonly kind: "update";
-        readonly input: z.ZodObject<{
-            recordId: z.ZodString;
-            data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-        }, z.core.$strip>;
-    };
-    readonly delete_record: {
-        readonly name: "delete_record";
-        readonly kind: "delete";
-        readonly input: z.ZodObject<{
-            recordId: z.ZodString;
-        }, z.core.$strip>;
-    };
-};
-type RecordCapabilityName = keyof typeof RECORD_CAPABILITIES;
-/**
- * A capability's argument type, inferred from the very schema the runtime
- * validates against.
- *
- * `z.input`, not `z.infer`: these are the arguments a caller supplies, and the
- * two sides differ wherever a field has a `.default()` — `filtersSchema`'s
- * `combinator` is required on the output and optional on the input. Typing
- * arguments with the output side made the SDK demand a `combinator` the runtime
- * would have filled in anyway.
- */
-type CapabilityInput<N extends RecordCapabilityName> = z.input<(typeof RECORD_CAPABILITIES)[N]["input"]>;
-/**
- * The capability → kind projection, derived rather than restated. The reflexes
- * module reads this instead of maintaining its own table (D26/D28).
- */
-declare const RECORD_CAPABILITY_KINDS: Readonly<Record<RecordCapabilityName, CapabilityKind>>;
-
-export { type CapabilityInput, type CapabilityKind, type FilterRuleInput, type FilterStateInput, OBJECT_ID_DESCRIPTION, RECORD_CAPABILITIES, RECORD_CAPABILITY_KINDS, type RecordCapabilityName, SANDBOX_FILE_DATA_HINT, filtersSchema, sortsSchema };

package/dist/capabilities.d.ts

@@ -1,146 +0,0 @@
-import { z } from 'zod';
-
-/** Accepted forms of the object identifier every object-scoped capability takes. */
-declare const OBJECT_ID_DESCRIPTION = "Object UUID, kebab-case name (e.g., 'contacts'), or display label (e.g., 'Personne physique'). All three are accepted; UUID is most precise.";
-/** Shared suffix for record `data` inputs that accept `$fromSandboxFile` references for large content. */
-declare const SANDBOX_FILE_DATA_HINT = " For large text content (> a few KB), write it to a sandbox file first and pass {\"$fromSandboxFile\": \"/workspace/<file>\"} as the attribute value \u2014 the server substitutes the file content.";
-/**
- * The LLM-facing filter shape, deliberately looser than its two siblings:
- * `types/filters.ts` (`FilterState`, the canonical TS model — its `quantifier`
- * is omitted here on purpose, agents don't set edge quantifiers) and
- * `validators/view-config.schema.ts` (`filterStateSchema`, the strict capped
- * variant for stored view config). The operator list in the describe text
- * restates `filters/operators.ts` (`OPERATOR_SPECS`) and
- * `filters/normalize-operator.ts` (`SYNONYM_ALIASES`) — those are the source
- * of truth; keep the prose in sync when adding an operator.
- */
-declare const filtersSchema: z.ZodObject<{
-    combinator: z.ZodDefault<z.ZodEnum<{
-        and: "and";
-        or: "or";
-    }>>;
-    rules: z.ZodArray<z.ZodObject<{
-        attribute: z.ZodString;
-        property: z.ZodOptional<z.ZodString>;
-        operator: z.ZodString;
-        value: z.ZodNullable<z.ZodUnknown>;
-    }, z.core.$strip>>;
-}, z.core.$strip>;
-declare const sortsSchema: z.ZodArray<z.ZodObject<{
-    attribute: z.ZodString;
-    direction: z.ZodEnum<{
-        asc: "asc";
-        desc: "desc";
-    }>;
-}, z.core.$strip>>;
-/**
- * Filter shapes derived from {@link filtersSchema} so the capability schema stays
- * the single source of truth.
- *
- * The *parsed* shape (`z.infer`), deliberately: the runtime holds these after
- * validation, when `combinator` has already been defaulted. What a caller may
- * omit is `z.input`, and that is what {@link CapabilityInput} exposes.
- */
-type FilterStateInput = z.infer<typeof filtersSchema>;
-type FilterRuleInput = FilterStateInput["rules"][number];
-/** How a capability mutates data, which decides whether a rehearsal captures it. */
-type CapabilityKind = "read" | "create" | "update" | "delete";
-/**
- * Every capability a Reflex may call, defined once.
- *
- * Deliberately five entries — the single-record tools whose input the gateway can
- * turn into a faithful `RunEffect`. Excluded on purpose: `get_schema`,
- * `global_search` and `bulk_search`, which are not scoped to one object and so
- * yield no object to grant a permission on; and the `bulk_*` record tools, where
- * one call mutates many records and would be recorded as a single effect, making
- * an effects report understate what happened.
- *
- * `description` is NOT here: the tools compute it per call from their config
- * (`schemaInContext` changes the wording), and `schema-tools-descriptions.test.ts`
- * pins both variants. The name, the kind and the input schema are what must exist
- * exactly once, and they do.
- */
-declare const RECORD_CAPABILITIES: {
-    readonly get_record: {
-        readonly name: "get_record";
-        readonly kind: "read";
-        readonly input: z.ZodObject<{
-            recordId: z.ZodString;
-            fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>;
-    };
-    readonly search_records: {
-        readonly name: "search_records";
-        readonly kind: "read";
-        readonly input: z.ZodObject<{
-            objectId: z.ZodString;
-            _displayLabel: z.ZodOptional<z.ZodString>;
-            query: z.ZodOptional<z.ZodString>;
-            limit: z.ZodOptional<z.ZodNumber>;
-            offset: z.ZodOptional<z.ZodNumber>;
-            fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            filters: z.ZodOptional<z.ZodObject<{
-                combinator: z.ZodDefault<z.ZodEnum<{
-                    and: "and";
-                    or: "or";
-                }>>;
-                rules: z.ZodArray<z.ZodObject<{
-                    attribute: z.ZodString;
-                    property: z.ZodOptional<z.ZodString>;
-                    operator: z.ZodString;
-                    value: z.ZodNullable<z.ZodUnknown>;
-                }, z.core.$strip>>;
-            }, z.core.$strip>>;
-            sorts: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                attribute: z.ZodString;
-                direction: z.ZodEnum<{
-                    asc: "asc";
-                    desc: "desc";
-                }>;
-            }, z.core.$strip>>>;
-        }, z.core.$strip>;
-    };
-    readonly create_record: {
-        readonly name: "create_record";
-        readonly kind: "create";
-        readonly input: z.ZodObject<{
-            objectId: z.ZodString;
-            _displayLabel: z.ZodOptional<z.ZodString>;
-            data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-        }, z.core.$strip>;
-    };
-    readonly update_record: {
-        readonly name: "update_record";
-        readonly kind: "update";
-        readonly input: z.ZodObject<{
-            recordId: z.ZodString;
-            data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
-        }, z.core.$strip>;
-    };
-    readonly delete_record: {
-        readonly name: "delete_record";
-        readonly kind: "delete";
-        readonly input: z.ZodObject<{
-            recordId: z.ZodString;
-        }, z.core.$strip>;
-    };
-};
-type RecordCapabilityName = keyof typeof RECORD_CAPABILITIES;
-/**
- * A capability's argument type, inferred from the very schema the runtime
- * validates against.
- *
- * `z.input`, not `z.infer`: these are the arguments a caller supplies, and the
- * two sides differ wherever a field has a `.default()` — `filtersSchema`'s
- * `combinator` is required on the output and optional on the input. Typing
- * arguments with the output side made the SDK demand a `combinator` the runtime
- * would have filled in anyway.
- */
-type CapabilityInput<N extends RecordCapabilityName> = z.input<(typeof RECORD_CAPABILITIES)[N]["input"]>;
-/**
- * The capability → kind projection, derived rather than restated. The reflexes
- * module reads this instead of maintaining its own table (D26/D28).
- */
-declare const RECORD_CAPABILITY_KINDS: Readonly<Record<RecordCapabilityName, CapabilityKind>>;
-
-export { type CapabilityInput, type CapabilityKind, type FilterRuleInput, type FilterStateInput, OBJECT_ID_DESCRIPTION, RECORD_CAPABILITIES, RECORD_CAPABILITY_KINDS, type RecordCapabilityName, SANDBOX_FILE_DATA_HINT, filtersSchema, sortsSchema };

package/dist/capabilities.js

@@ -1,77 +0,0 @@
-'use strict';
-
-var zod = require('zod');
-
-// src/capabilities.ts
-var OBJECT_ID_DESCRIPTION = "Object UUID, kebab-case name (e.g., 'contacts'), or display label (e.g., 'Personne physique'). All three are accepted; UUID is most precise.";
-var SANDBOX_FILE_DATA_HINT = ' For large text content (> a few KB), write it to a sandbox file first and pass {"$fromSandboxFile": "/workspace/<file>"} as the attribute value \u2014 the server substitutes the file content.';
-var filtersSchema = zod.z.object({
-  combinator: zod.z.enum(["and", "or"]).default("and"),
-  rules: zod.z.array(
-    zod.z.object({
-      attribute: zod.z.string().describe("Attribute name on the object being searched"),
-      property: zod.z.string().optional().describe(
-        "Optional. Only valid when 'attribute' is a relation / document / user attribute declared with .qualifyWith({...}). When set, the rule filters on the named EDGE property (not the linked record) and the operator must be valid for that property's type. See <filter_operators>."
-      ),
-      operator: zod.z.string().describe(
-        "Filter operator (canonical: is, is_not, contains, not_contains, starts_with, ends_with, less_than, greater_than, less_or_equal, greater_or_equal, is_within, on_day_month, any_of, none_of, is_empty, is_not_empty). Short codes (lt, gt, lte, gte, eq, neq, in) are accepted as input and auto-normalized to the canonical names. The valid set depends on the attribute type (or property type when 'property' is set) \u2014 see <filter_operators>."
-      ),
-      value: zod.z.unknown().nullable().describe(
-        "Value matching the attribute (or property) type: scalar for is/contains/less_than/etc (checkbox is: true|false); array (string[]) for any_of/none_of; null for is_empty/is_not_empty; { amount, unit, direction } for is_within; { day, month } for on_day_month."
-      )
-    })
-  )
-});
-var sortsSchema = zod.z.array(
-  zod.z.object({
-    attribute: zod.z.string().describe("Attribute name"),
-    direction: zod.z.enum(["asc", "desc"])
-  })
-);
-var getRecordInput = zod.z.object({
-  recordId: zod.z.string().describe("Record UUID"),
-  fields: zod.z.array(zod.z.string()).optional().describe("Attribute names to return")
-});
-var searchRecordsInput = zod.z.object({
-  objectId: zod.z.string().describe(OBJECT_ID_DESCRIPTION),
-  _displayLabel: zod.z.string().optional().describe("Display label"),
-  query: zod.z.string().optional().describe("Full-text search query (omit to browse/list)"),
-  limit: zod.z.number().optional().describe("Max results per call: 1-1000 (default 20). Paginate via offset for more."),
-  offset: zod.z.number().optional().describe("Skip N records (default 0)"),
-  fields: zod.z.array(zod.z.string()).optional().describe("Attribute names to include in values"),
-  filters: filtersSchema.optional().describe(
-    "Structured filter: { combinator: 'and'|'or', rules: [{attribute, operator, value, property?}] }. Operators are constrained per attribute type \u2014 see <filter_operators>. Use 'property' on a rule to filter on a qualified edge property."
-  ),
-  sorts: sortsSchema.optional().describe("Sorts: [{ attribute, direction: 'asc'|'desc' }]")
-});
-var createRecordInput = zod.z.object({
-  objectId: zod.z.string().describe(OBJECT_ID_DESCRIPTION),
-  _displayLabel: zod.z.string().optional().describe("Display label"),
-  data: zod.z.record(zod.z.string(), zod.z.unknown()).describe(`Record data.${SANDBOX_FILE_DATA_HINT}`)
-});
-var updateRecordInput = zod.z.object({
-  recordId: zod.z.string().describe("Record UUID"),
-  data: zod.z.record(zod.z.string(), zod.z.unknown()).describe(`Fields to update.${SANDBOX_FILE_DATA_HINT}`)
-});
-var deleteRecordInput = zod.z.object({
-  recordId: zod.z.string().describe("Record UUID")
-});
-var RECORD_CAPABILITIES = {
-  get_record: { name: "get_record", kind: "read", input: getRecordInput },
-  search_records: { name: "search_records", kind: "read", input: searchRecordsInput },
-  create_record: { name: "create_record", kind: "create", input: createRecordInput },
-  update_record: { name: "update_record", kind: "update", input: updateRecordInput },
-  delete_record: { name: "delete_record", kind: "delete", input: deleteRecordInput }
-};
-var RECORD_CAPABILITY_KINDS = Object.freeze(
-  Object.fromEntries(
-    Object.values(RECORD_CAPABILITIES).map((capability) => [capability.name, capability.kind])
-  )
-);
-
-exports.OBJECT_ID_DESCRIPTION = OBJECT_ID_DESCRIPTION;
-exports.RECORD_CAPABILITIES = RECORD_CAPABILITIES;
-exports.RECORD_CAPABILITY_KINDS = RECORD_CAPABILITY_KINDS;
-exports.SANDBOX_FILE_DATA_HINT = SANDBOX_FILE_DATA_HINT;
-exports.filtersSchema = filtersSchema;
-exports.sortsSchema = sortsSchema;

package/dist/capabilities.mjs

@@ -1,70 +0,0 @@
-import { z } from 'zod';
-
-// src/capabilities.ts
-var OBJECT_ID_DESCRIPTION = "Object UUID, kebab-case name (e.g., 'contacts'), or display label (e.g., 'Personne physique'). All three are accepted; UUID is most precise.";
-var SANDBOX_FILE_DATA_HINT = ' For large text content (> a few KB), write it to a sandbox file first and pass {"$fromSandboxFile": "/workspace/<file>"} as the attribute value \u2014 the server substitutes the file content.';
-var filtersSchema = z.object({
-  combinator: z.enum(["and", "or"]).default("and"),
-  rules: z.array(
-    z.object({
-      attribute: z.string().describe("Attribute name on the object being searched"),
-      property: z.string().optional().describe(
-        "Optional. Only valid when 'attribute' is a relation / document / user attribute declared with .qualifyWith({...}). When set, the rule filters on the named EDGE property (not the linked record) and the operator must be valid for that property's type. See <filter_operators>."
-      ),
-      operator: z.string().describe(
-        "Filter operator (canonical: is, is_not, contains, not_contains, starts_with, ends_with, less_than, greater_than, less_or_equal, greater_or_equal, is_within, on_day_month, any_of, none_of, is_empty, is_not_empty). Short codes (lt, gt, lte, gte, eq, neq, in) are accepted as input and auto-normalized to the canonical names. The valid set depends on the attribute type (or property type when 'property' is set) \u2014 see <filter_operators>."
-      ),
-      value: z.unknown().nullable().describe(
-        "Value matching the attribute (or property) type: scalar for is/contains/less_than/etc (checkbox is: true|false); array (string[]) for any_of/none_of; null for is_empty/is_not_empty; { amount, unit, direction } for is_within; { day, month } for on_day_month."
-      )
-    })
-  )
-});
-var sortsSchema = z.array(
-  z.object({
-    attribute: z.string().describe("Attribute name"),
-    direction: z.enum(["asc", "desc"])
-  })
-);
-var getRecordInput = z.object({
-  recordId: z.string().describe("Record UUID"),
-  fields: z.array(z.string()).optional().describe("Attribute names to return")
-});
-var searchRecordsInput = z.object({
-  objectId: z.string().describe(OBJECT_ID_DESCRIPTION),
-  _displayLabel: z.string().optional().describe("Display label"),
-  query: z.string().optional().describe("Full-text search query (omit to browse/list)"),
-  limit: z.number().optional().describe("Max results per call: 1-1000 (default 20). Paginate via offset for more."),
-  offset: z.number().optional().describe("Skip N records (default 0)"),
-  fields: z.array(z.string()).optional().describe("Attribute names to include in values"),
-  filters: filtersSchema.optional().describe(
-    "Structured filter: { combinator: 'and'|'or', rules: [{attribute, operator, value, property?}] }. Operators are constrained per attribute type \u2014 see <filter_operators>. Use 'property' on a rule to filter on a qualified edge property."
-  ),
-  sorts: sortsSchema.optional().describe("Sorts: [{ attribute, direction: 'asc'|'desc' }]")
-});
-var createRecordInput = z.object({
-  objectId: z.string().describe(OBJECT_ID_DESCRIPTION),
-  _displayLabel: z.string().optional().describe("Display label"),
-  data: z.record(z.string(), z.unknown()).describe(`Record data.${SANDBOX_FILE_DATA_HINT}`)
-});
-var updateRecordInput = z.object({
-  recordId: z.string().describe("Record UUID"),
-  data: z.record(z.string(), z.unknown()).describe(`Fields to update.${SANDBOX_FILE_DATA_HINT}`)
-});
-var deleteRecordInput = z.object({
-  recordId: z.string().describe("Record UUID")
-});
-var RECORD_CAPABILITIES = {
-  get_record: { name: "get_record", kind: "read", input: getRecordInput },
-  search_records: { name: "search_records", kind: "read", input: searchRecordsInput },
-  create_record: { name: "create_record", kind: "create", input: createRecordInput },
-  update_record: { name: "update_record", kind: "update", input: updateRecordInput },
-  delete_record: { name: "delete_record", kind: "delete", input: deleteRecordInput }
-};
-var RECORD_CAPABILITY_KINDS = Object.freeze(
-  Object.fromEntries(
-    Object.values(RECORD_CAPABILITIES).map((capability) => [capability.name, capability.kind])
-  )
-);
-
-export { OBJECT_ID_DESCRIPTION, RECORD_CAPABILITIES, RECORD_CAPABILITY_KINDS, SANDBOX_FILE_DATA_HINT, filtersSchema, sortsSchema };