@almadar/core 10.29.0 → 10.30.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,5 +1,6 @@
1
- import { E as EntityField, a as EntityPersistence, R as RelationConfig } from './pattern-types-JZordBZv.js';
2
- import { T as TraitEventListener, a as TraitReference } from './trait-B_CzfDSi.js';
1
+ import { E as EntityField, a as EntityPersistence, R as RelationConfig } from './pattern-types-CLcOXOmW.js';
2
+ import { T as TraitEventListener, a as TraitReference } from './trait-CwWjkU-1.js';
3
+ import { J as JsonValue } from './json-DOTchoRS.js';
3
4
 
4
5
  /**
5
6
  * Cross-cutting presentation knobs that don't live per orbital
@@ -68,62 +69,6 @@ interface OwnershipOverlayEntry {
68
69
  ownerField: string;
69
70
  }
70
71
 
71
- /**
72
- * JSON primitives — the universal "data crossed a boundary" type.
73
- *
74
- * Every value that arrives over the wire from an LLM (tool-call args),
75
- * from disk (workspace files), or from an HTTP body before
76
- * domain-specific validation is a `JsonValue`. Narrow with a typed
77
- * predicate (`is`-guard) at the boundary; don't widen back to `unknown`.
78
- *
79
- * `JsonObject` and `ToolArgs` are aliases for the common
80
- * `Record<string, JsonValue>` shape. `ToolArgs` is the name the
81
- * agent surface uses for LLM-emitted tool-call arguments; `JsonObject`
82
- * is the general-purpose alias. They are the same type — the alias
83
- * exists so call sites read at the right semantic level.
84
- *
85
- * Why not `Record<string, unknown>`? Two reasons. (1) `unknown` widens
86
- * back to anything, which defeats the purpose of typing the boundary.
87
- * (2) The `@almadar/eslint-plugin/no-record-string-unknown` rule blocks
88
- * the wider form — `JsonValue`-based records are the typed answer.
89
- *
90
- * @packageDocumentation
91
- */
92
- /**
93
- * Recursive JSON value union — every shape JSON can carry.
94
- */
95
- type JsonValue = string | number | boolean | null | JsonValue[] | {
96
- [key: string]: JsonValue;
97
- };
98
- /**
99
- * JSON object — keyed string→JsonValue. The wire form of arbitrary
100
- * structured data. Replaces `Record<string, unknown>` at typed
101
- * boundaries (LLM emits, file reads, HTTP bodies).
102
- */
103
- type JsonObject = {
104
- [key: string]: JsonValue;
105
- };
106
- /**
107
- * LLM tool-call arguments — same shape as `JsonObject`, named for the
108
- * agent-surface call site. Each tool's `execute(args: ToolArgs)`
109
- * receives this and narrows via an `is`-guard predicate before any
110
- * field access.
111
- */
112
- type ToolArgs = JsonObject;
113
- /**
114
- * Type guard: is the given value a JSON primitive (non-array,
115
- * non-object)? Used by walkers that decide whether to recurse.
116
- */
117
- declare function isJsonPrimitive(value: JsonValue): value is string | number | boolean | null;
118
- /**
119
- * Type guard: is the given value a JSON object (non-array, non-null)?
120
- */
121
- declare function isJsonObject(value: JsonValue): value is JsonObject;
122
- /**
123
- * Type guard: is the given value a JSON array?
124
- */
125
- declare function isJsonArray(value: JsonValue): value is JsonValue[];
126
-
127
72
  /**
128
73
  * Recursive JSON Schema. Intentionally narrow — only the keywords V2's
129
74
  * signature → schema generator emits. Custom `x-*` extensions carry
@@ -543,4 +488,4 @@ type FactoryParamValue = string | number | boolean | ReadonlyArray<FactoryParamV
543
488
  readonly [key: string]: FactoryParamValue;
544
489
  };
545
490
 
546
- export { type FactoryCallSite as F, type JsonValue as J, type OwnershipOverlayEntry as O, type PresentationNavItem as P, type RuleOverlay as R, type SchemaFieldType as S, type ToolArgs as T, type FactoryCallSiteParams as a, type FactoryConfigParam as b, type FactoryConfigTier as c, type FactoryEntitySignature as d, type FactoryEventSignature as e, type FactoryExposure as f, type FactoryPageSignature as g, type FactoryParamValue as h, type FactoryProvenance as i, type FactorySignature as j, type FactorySignatureCatalog as k, type FactorySignatureEntityField as l, type FactoryTraitSignature as m, type JsonObject as n, type JsonSchema as o, type JsonSchemaType as p, type PresentationOverlay as q, type RuleOverlayEntry as r, type TraitOverlay as s, type TraitOverlayEntry as t, type TraitOverlayListener as u, isJsonArray as v, isJsonObject as w, isJsonPrimitive as x };
491
+ export type { FactoryCallSite as F, JsonSchema as J, OwnershipOverlayEntry as O, PresentationNavItem as P, RuleOverlay as R, SchemaFieldType as S, TraitOverlay as T, FactoryCallSiteParams as a, FactoryConfigParam as b, FactoryConfigTier as c, FactoryEntitySignature as d, FactoryEventSignature as e, FactoryExposure as f, FactoryPageSignature as g, FactoryParamValue as h, FactoryProvenance as i, FactorySignature as j, FactorySignatureCatalog as k, FactorySignatureEntityField as l, FactoryTraitSignature as m, JsonSchemaType as n, PresentationOverlay as o, RuleOverlayEntry as p, TraitOverlayEntry as q, TraitOverlayListener as r };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@almadar/core",
3
- "version": "10.29.0",
3
+ "version": "10.30.0",
4
4
  "description": "Core schema types and definitions for Almadar",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",