@almadar/skills 2.0.5 → 2.3.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.
package/dist/index.d.ts CHANGED
@@ -107,6 +107,44 @@ declare function generateKflowOrbitalFixingSkill(): GeneratedSkill;
107
107
  */
108
108
  declare function generateDomainLanguageSkill(): GeneratedSkill;
109
109
 
110
+ /**
111
+ * Almadar Assistant Skill Generator
112
+ *
113
+ * Generates the almadar-assistant skill: a Q&A assistant that knows
114
+ * about Almadar, Orb, Studio, Services, and the full platform.
115
+ * Used by the website chat widget across all four sites.
116
+ *
117
+ * @packageDocumentation
118
+ */
119
+
120
+ /**
121
+ * Generate the almadar-assistant skill.
122
+ */
123
+ declare function generateAlmadarAssistantSkill(): GeneratedSkill;
124
+
125
+ /**
126
+ * Orb Skill Generator
127
+ *
128
+ * Generates the "orb" skill for .orb program generation.
129
+ * This skill restricts the LLM to atoms and molecules only (no organisms).
130
+ *
131
+ * The 104 standard behaviors demonstrate that atoms + molecules cover every
132
+ * domain (CRUD, dashboards, finance, healthcare, IoT, games, social, education).
133
+ * Organisms are rigid and don't compose well. Molecules compose freely.
134
+ *
135
+ * Used by the Masar pipeline and builder agents for schema generation.
136
+ *
137
+ * @packageDocumentation
138
+ */
139
+
140
+ /**
141
+ * Generate the "orb" skill.
142
+ *
143
+ * Molecule-first pattern vocabulary derived from 104 standard behaviors.
144
+ * No organisms. Atoms and molecules compose to build any UI.
145
+ */
146
+ declare function generateOrbSkill(): GeneratedSkill;
147
+
110
148
  /**
111
149
  * Lean Orbital Skill Generator
112
150
  *
@@ -217,19 +255,20 @@ declare function generateLeanFixingSkill(options?: LeanFixingSkillOptions): stri
217
255
  /**
218
256
  * Skill Generators for Builder Client
219
257
  *
220
- * Re-exports the 5 core skills used by the builder client:
258
+ * Re-exports the 6 core skills used by the builder client:
221
259
  * 1. kflow-orbitals (standard JSON generation with atomic composition)
222
260
  * 2. kflow-orbital-fixing (standard fixing)
223
261
  * 3. kflow-lean-orbitals (lean domain language generation)
224
262
  * 4. kflow-lean-fixing (lean fixing)
225
263
  * 5. domain-language (ODL understanding/summarization)
264
+ * 6. almadar-assistant (company/platform Q&A knowledge assistant)
226
265
  *
227
266
  * @packageDocumentation
228
267
  */
229
268
 
230
269
  /**
231
270
  * Generate all builder client skills.
232
- * These are the 5 skills actually used by the builder UI.
271
+ * These are the 6 skills actually used by the builder UI.
233
272
  */
234
273
  declare function generateAllBuilderSkills(): GeneratedSkill[];
235
274
 
@@ -320,6 +359,24 @@ declare function getOrbitalConnectivitySection(): string;
320
359
  */
321
360
  declare function getRenderUIDesignGuide(): string;
322
361
 
362
+ /**
363
+ * .orb Render-UI Composition Guide
364
+ *
365
+ * Teaches the LLM to compose render-ui trees using ONLY atoms and molecules
366
+ * (plus allowed exceptions: data-list, data-grid, search-input, form-section, meter).
367
+ *
368
+ * Pattern list is derived dynamically from @almadar/patterns registry.
369
+ * No hardcoded pattern lists. When patterns are added/removed from the registry,
370
+ * this guide updates automatically.
371
+ *
372
+ * @packageDocumentation
373
+ */
374
+ /**
375
+ * Get the .orb render-ui composition guide.
376
+ * Uses only atoms/molecules from the registry, reflecting golden behavior patterns.
377
+ */
378
+ declare function getOrbRenderUIGuide(): string;
379
+
323
380
  /**
324
381
  * Theme Variable System Guide
325
382
  *
@@ -741,4 +798,4 @@ type SkillsServiceActions = {
741
798
  */
742
799
  type SkillsServiceContract = ServiceContract<SkillsServiceActions>;
743
800
 
744
- export { type CompositionMetrics, EVAL_CASES, type EvalCase, type EvalResult, type GeneratedSkill, type ProviderComparison, type ScoreBreakdown, type SkillFrontmatter, type SkillsServiceActions, type SkillsServiceContract, analyzeComposition, calculateTotalScore, formatFrontmatter, generateAllBuilderSkills, generateComparisonMatrix, generateDomainLanguageSkill, generateKflowOrbitalFixingSkill, generateKflowOrbitalsSkill, generateLeanFixingSkill$1 as generateLeanFixingSkill, generateLeanFixingSkill as generateLeanFixingSkillFull, generateLeanOrbitalSkill$1 as generateLeanOrbitalSkill, generateLeanOrbitalSkill as generateLeanOrbitalSkillFull, getArchitectureSection, getAssetRefSection, getBannedProps, getBindingContextRules, getBindingsCompact, getBindingsGuide, getCommonErrorsSection, getCommonFixPatternsSection, getCompletionRulesSection, getConnectivityCompact, getContextUsageCompact, getContextUsageSection, getCustomTraitCompact, getCustomTraitSection, getDecompositionChecklist, getDecompositionCompact, getDecompositionSection, getDesignErrorsCompact, getDesignErrorsSection, getEfficiencySection, getFieldTypesCompact, getFixingWorkflowSection, getFlowPatternSection, getFullOrbitalPrompt, getGameAsOrbitalsSection, getGameEntityTemplatesSection, getGamePatternsSection, getGameTraitsSection, getGameTypesSection, getIconLibraryCompact, getIconLibrarySection, getKeyBehaviorsReference, getMinimalTypeReference, getMultiFileSection, getOrbitalConnectivitySection, getOrbitalDecompositionPrompt, getOverGenerationSection, getPatternTypesCompact, getPortableOrbitalOutputSection, getRenderUIDesignGuide, getRenderUIQuickRef, getRequirementsDecomposePrompt, getRequirementsTraitPrompt, getSExprQuickRef, getSchemaUpdateCompact, getSchemaUpdateSection, getSubagentSystemPrompt, getThemeGuide, getUsesImportCompact, getUsesImportSection, getValidationHintsSection, writeAllSkills, writeSkill };
801
+ export { type CompositionMetrics, EVAL_CASES, type EvalCase, type EvalResult, type GeneratedSkill, type ProviderComparison, type ScoreBreakdown, type SkillFrontmatter, type SkillsServiceActions, type SkillsServiceContract, analyzeComposition, calculateTotalScore, formatFrontmatter, generateAllBuilderSkills, generateAlmadarAssistantSkill, generateComparisonMatrix, generateDomainLanguageSkill, generateKflowOrbitalFixingSkill, generateKflowOrbitalsSkill, generateLeanFixingSkill$1 as generateLeanFixingSkill, generateLeanFixingSkill as generateLeanFixingSkillFull, generateLeanOrbitalSkill$1 as generateLeanOrbitalSkill, generateLeanOrbitalSkill as generateLeanOrbitalSkillFull, generateOrbSkill, getArchitectureSection, getAssetRefSection, getBannedProps, getBindingContextRules, getBindingsCompact, getBindingsGuide, getCommonErrorsSection, getCommonFixPatternsSection, getCompletionRulesSection, getConnectivityCompact, getContextUsageCompact, getContextUsageSection, getCustomTraitCompact, getCustomTraitSection, getDecompositionChecklist, getDecompositionCompact, getDecompositionSection, getDesignErrorsCompact, getDesignErrorsSection, getEfficiencySection, getFieldTypesCompact, getFixingWorkflowSection, getFlowPatternSection, getFullOrbitalPrompt, getGameAsOrbitalsSection, getGameEntityTemplatesSection, getGamePatternsSection, getGameTraitsSection, getGameTypesSection, getIconLibraryCompact, getIconLibrarySection, getKeyBehaviorsReference, getMinimalTypeReference, getMultiFileSection, getOrbRenderUIGuide, getOrbitalConnectivitySection, getOrbitalDecompositionPrompt, getOverGenerationSection, getPatternTypesCompact, getPortableOrbitalOutputSection, getRenderUIDesignGuide, getRenderUIQuickRef, getRequirementsDecomposePrompt, getRequirementsTraitPrompt, getSExprQuickRef, getSchemaUpdateCompact, getSchemaUpdateSection, getSubagentSystemPrompt, getThemeGuide, getUsesImportCompact, getUsesImportSection, getValidationHintsSection, writeAllSkills, writeSkill };