@almadar/core 8.4.0 → 8.5.1

package/dist/factory/index.d.ts

@@ -70,6 +70,41 @@ interface OwnershipOverlayEntry {
     ownerField: string;
 }
 
+/**
+ * Recursive JSON value — the shape any JSON document can hold. Used by
+ * `JsonSchema.default` (which carries an arbitrary JSON literal) and
+ * `JsonSchema.enum` (closed set of leaf values). Recursive structural
+ * type with no `unknown` anywhere: every nested value is itself a
+ * `JsonValue`.
+ */
+type JsonValue = string | number | boolean | null | ReadonlyArray<JsonValue> | Readonly<{
+    [key: string]: JsonValue;
+}>;
+/**
+ * Recursive JSON Schema. Intentionally narrow — only the keywords V2's
+ * signature → schema generator emits. Custom `x-*` extensions carry
+ * descriptive metadata (synonyms, label) that doesn't shape validation
+ * but stays in the schema for prompt rendering / studio UIs.
+ */
+interface JsonSchema {
+    type?: JsonSchemaType | ReadonlyArray<JsonSchemaType>;
+    description?: string;
+    properties?: Readonly<{
+        [key: string]: JsonSchema;
+    }>;
+    required?: ReadonlyArray<string>;
+    additionalProperties?: boolean | JsonSchema;
+    items?: JsonSchema;
+    enum?: ReadonlyArray<string | number | boolean>;
+    oneOf?: ReadonlyArray<JsonSchema>;
+    anyOf?: ReadonlyArray<JsonSchema>;
+    default?: JsonValue;
+    /** Knob's `@synonyms` from the source `.lolo`. */
+    'x-synonyms'?: string;
+    /** Knob's `@label` from the source `.lolo`. */
+    'x-label'?: string;
+}
+type JsonSchemaType = 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object' | 'null';
 /**
  * OrbitalSchema field type tags. The factory-signature extractor lifts
  * these directly from the resolved `.orb`; consumers narrow further at
@@ -201,6 +236,27 @@ interface FactorySignature {
     emittedEvents: ReadonlyArray<string>;
     /** Union of all `traits[].listenedEvents`. */
     listenedEvents: ReadonlyArray<string>;
+    /**
+     * JSON Schema for the orbital's `AnalysisOrbitalParams` shape. Walks
+     * `traitOverrides.<TraitName>.config.<knob>` with the exact type
+     * (string/number/boolean/array/object) lifted from each knob's
+     * declaration, `enum` from `enumValues`, recursive `items` for array
+     * slots, recursive `properties` for struct slots. Every level carries
+     * `additionalProperties: false` so the LLM cannot emit unknown trait
+     * names, invented knob keys, or out-of-set enum values.
+     *
+     * Pre-computed at signature extraction time by
+     * `tools/almadar-pattern-sync/src/std-ts/signatures/`. V2 tool-calling
+     * (`@almadar-io/agent`'s coordinator + per-orbital subagent) feeds this
+     * directly to OpenAI's `tool.parameters` with `strict: true` — the
+     * LLM is physically constrained by the schema instead of relying on
+     * post-hoc validation.
+     *
+     * Optional for backward compatibility: signatures emitted by older
+     * pattern-sync versions don't carry it, in which case V2 tools fall
+     * back to a loose schema + post-hoc validation.
+     */
+    paramsSchema?: JsonSchema;
 }
 /**
  * Aggregate catalog written to
@@ -406,4 +462,4 @@ interface FactoryCallPlanState {
  */
 declare function applyFactoryCallPlanMutation(state: FactoryCallPlanState, m: FactoryCallPlanMutation): FactoryCallPlanState;
 
-export { type CallSiteDiff, type FactoryCallPlanMutation, type FactoryCallPlanState, type FactoryCallSite, type FactoryCallSiteParams, type FactoryConfigParam, type FactoryEntitySignature, type FactoryPageSignature, type FactoryParamValue, type FactorySignature, type FactorySignatureCatalog, type FactorySignatureEntityField, type FactoryTraitSignature, type OrbitalCallInput, type OwnershipOverlayEntry, type PresentationNavItem, type PresentationOverlay, type RuleOverlay, type RuleOverlayEntry, type SchemaFieldType, type TraitOverlay, type TraitOverlayEntry, type TraitOverlayListener, type TranslationBinding, type TranslationResult, type TranslationWarning, applyFactoryCallPlanMutation, diffFactoryCalls, translateOverlaysToParams };
+export { type CallSiteDiff, type FactoryCallPlanMutation, type FactoryCallPlanState, type FactoryCallSite, type FactoryCallSiteParams, type FactoryConfigParam, type FactoryEntitySignature, type FactoryPageSignature, type FactoryParamValue, type FactorySignature, type FactorySignatureCatalog, type FactorySignatureEntityField, type FactoryTraitSignature, type JsonSchema, type JsonSchemaType, type JsonValue, type OrbitalCallInput, type OwnershipOverlayEntry, type PresentationNavItem, type PresentationOverlay, type RuleOverlay, type RuleOverlayEntry, type SchemaFieldType, type TraitOverlay, type TraitOverlayEntry, type TraitOverlayListener, type TranslationBinding, type TranslationResult, type TranslationWarning, applyFactoryCallPlanMutation, diffFactoryCalls, translateOverlaysToParams };

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { A as AgentEffect, a as AnimationDef, b as AnimationDefInput, c as Anima
 export { C as CORE_BINDINGS, a as CoreBinding, E as EvalContext, b as EventPayload, c as EventPayloadValue, d as Expression, e as ExpressionInput, f as ExpressionSchema, L as LogMeta, P as ParsedBinding, S as SExpr, g as SExprAtom, h as SExprAtomSchema, i as SExprInput, j as SExprSchema, k as collectBindings, l as getArgs, m as getOperator, n as isBinding, o as isSExpr, p as isSExprAtom, q as isSExprCall, r as isValidBinding, s as parseBinding, t as sexpr, w as walkSExpr } from './expression-BVRFm0sV.js';
 import { ResolvedIR, ResolvedEntity, ResolvedPage, ResolvedTrait, ChangesetValue, SchemaChange, CategorizedRemovals, PageContentReduction, SemanticSchemaChange } from './types/index.js';
 export { AgentCodeSearchResult, AgentCompactResult, AgentCompactStrategy, AgentContext, AgentGenerateOptions, AgentMemoryCategory, AgentMemoryRecord, AppSummary, AssetLoadStatus, BINDING_CONTEXT_RULES, BINDING_DOCS, BINDING_ROOTS, BindingContext, BindingRoot, BindingSchema, BridgeHealth, BusEvent, BusEventListener, BusEventSource, ChangeAuthor, ChangeSetDocument, ChangeSummary, CheckStatus, ContextExtensions, CreateFlow, DEFAULT_INTERACTION_MODELS, DeleteFlow, EditFlow, EffectTrace, EventEmit, EventKey, EventListen, EventLogEntry, GitHubLink, HistoryMeta, InteractionModel, InteractionModelInput, InteractionModelSchema, LazyService, ListInteraction, OrbitalVerificationAPI, PatternTypeSchema, PersistActionName, ResolvedEntityBinding, ResolvedField, ResolvedNavigation, ResolvedPattern, ResolvedSection, ResolvedSectionEvent, ResolvedTraitBinding, ResolvedTraitDataEntity, ResolvedTraitEvent, ResolvedTraitGuard, ResolvedTraitListener, ResolvedTraitState, ResolvedTraitTick, ResolvedTraitTransition, ResolvedTraitUIBinding, SaveOptions, SaveResult, SemanticChangeKind, ServerResponseTrace, ServiceAction, ServiceActionName, ServiceContract, ServiceEvents, SnapshotDocument, StatsView, StoreContract, StoreFilter, StoreFilterOp, TraitFieldRef, TraitFieldRefSchema, TraitStateSnapshot, TransitionFrom, TransitionTrace, Unsubscribe, ValidationDocument, ValidationIssue, ValidationMeta, ValidationResults, VerificationCheck, VerificationSnapshot, VerificationSummary, ViewFlow, createEmptyResolvedPage, createEmptyResolvedTrait, createLazyService, createResolvedField, createTypedEventBus, getAllPatternTypes, getBindingExamples, getInteractionModelForDomain, inferTsType, isResolvedIR, isTraitFieldRef, toBindingRoot, validateBindingInContext } from './types/index.js';
-export { CallSiteDiff, FactoryCallPlanMutation, FactoryCallPlanState, FactoryCallSite, FactoryCallSiteParams, FactoryConfigParam, FactoryEntitySignature, FactoryPageSignature, FactoryParamValue, FactorySignature, FactorySignatureCatalog, FactorySignatureEntityField, FactoryTraitSignature, OrbitalCallInput, OwnershipOverlayEntry, PresentationNavItem, PresentationOverlay, RuleOverlay, RuleOverlayEntry, SchemaFieldType, TraitOverlay, TraitOverlayEntry, TraitOverlayListener, TranslationBinding, TranslationResult, TranslationWarning, applyFactoryCallPlanMutation, diffFactoryCalls, translateOverlaysToParams } from './factory/index.js';
+export { CallSiteDiff, FactoryCallPlanMutation, FactoryCallPlanState, FactoryCallSite, FactoryCallSiteParams, FactoryConfigParam, FactoryEntitySignature, FactoryPageSignature, FactoryParamValue, FactorySignature, FactorySignatureCatalog, FactorySignatureEntityField, FactoryTraitSignature, JsonSchema, JsonSchemaType, JsonValue, OrbitalCallInput, OwnershipOverlayEntry, PresentationNavItem, PresentationOverlay, RuleOverlay, RuleOverlayEntry, SchemaFieldType, TraitOverlay, TraitOverlayEntry, TraitOverlayListener, TranslationBinding, TranslationResult, TranslationWarning, applyFactoryCallPlanMutation, diffFactoryCalls, translateOverlaysToParams } from './factory/index.js';
 export { C as ComposeBehaviorsInput, a as ComposeBehaviorsResult, E as EventWiringEntry, L as LayoutStrategy, b as applyEventWiring, c as composeBehaviors, d as detectLayoutStrategy } from './compose-behaviors-TSp2c_dn.js';
 export { PATTERN_TYPES, PatternConfig, PatternType, isValidPatternType } from '@almadar/patterns';
 export { BFSNode, BFSPathNode, EdgeWalkTransition, GraphTransition, GuardPayload, ReplayStep, ReplayTransition, StateEdge, WalkStep, buildEdgeCoveringWalk, buildGuardPayloads, buildReplayPaths, buildStateGraph, collectReachableStates, extractPayloadFieldRef, walkStatePairs } from './state-machine/index.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/core",
-  "version": "8.4.0",
+  "version": "8.5.1",
   "description": "Core schema types and definitions for Almadar",
   "type": "module",
   "main": "./dist/index.js",