@getrheo/flow-runtime 1.0.0

package/dist/agentPrompt/index.d.ts

@@ -0,0 +1,72 @@
+import { RheoAgentSelection } from '@getrheo/contracts/dashboard';
+import { FlowManifest } from '@getrheo/contracts/manifest';
+import { ResolvedCanvasEditorGates } from '@getrheo/contracts/canvasEditorGates';
+import { ManifestValidationIssue } from '../validation.js';
+export { BUILDER_RULES_AGENT_BULLETS } from '../flowBuilderRules.js';
+import '@getrheo/contracts';
+import '@getrheo/contracts/layers';
+
+/** Button/back-button action `kind` literals, read straight from the contract schema. */
+declare const buttonActionKinds: () => string[];
+/** Compact capability surface for in-product AI system prompts (runtime, contract-derived). */
+declare const buildCapabilitySurfaceFragment: () => string;
+
+/** One-line JSON examples per layer kind for agent prompts. */
+declare const buildLayerExamplesFragment: () => string;
+
+type CanvasScreenSchemaRulesOpts = {
+    /** flowGenStep uses { done, screen } instead of { screen } envelope. */
+    envelope?: 'screen' | 'flowGenStep';
+};
+declare const buildCanvasScreenSchemaRules: (opts?: CanvasScreenSchemaRulesOpts) => string;
+declare const buildFlowManifestPatchRules: () => string;
+declare const buildDecisionSurfaceRules: () => string;
+/** Rheo Agent full system prompt schema section. */
+declare const buildRheoAgentSchemaRules: () => string;
+
+declare const buildBuilderRulesFragment: () => string;
+
+/**
+ * Styling rules for AI system prompts: models must emit schema fields the sim actually renders.
+ * Buttons use variant defaults unless style.background / style.color override (web + native).
+ */
+declare const buildLayerStylingRules: () => string;
+
+/** AI flow generation step workflow (orchestration — not schema). */
+declare const buildFlowGenWorkflowRules: () => string;
+
+/**
+ * Builds the manifest context block for the Rheo Agent system prompt. When the
+ * canvas has a focused selection, embeds full JSON only for the focused
+ * screens/nodes plus a graph summary for everything else.
+ */
+declare const slimManifestForRheoAgentPrompt: (manifest: FlowManifest, selection?: RheoAgentSelection) => string;
+declare const buildRheoAgentSystemPrompt: (draftManifest: FlowManifest, selection: RheoAgentSelection | undefined, parts: {
+    schemaRules: string;
+    builderRules: string;
+    layerStyling: string;
+    canvasGatesLine?: string;
+    selectionBlock: string;
+}) => string;
+
+type AgentManifestValidationIssue = ManifestValidationIssue | {
+    path: (string | number)[];
+    message: string;
+    code: string;
+    stepId?: string | null;
+};
+type ValidateAgentManifestOutputOpts = {
+    canvasGates?: ResolvedCanvasEditorGates;
+    includeBuilderRules?: boolean;
+};
+type ValidateAgentManifestOutputResult = {
+    ok: true;
+    manifest: FlowManifest;
+} | {
+    ok: false;
+    issues: AgentManifestValidationIssue[];
+};
+declare const validateAgentManifestOutput: (data: unknown, opts?: ValidateAgentManifestOutputOpts) => ValidateAgentManifestOutputResult;
+declare const formatAgentManifestIssues: (issues: AgentManifestValidationIssue[], max?: number) => string;
+
+export { type AgentManifestValidationIssue, type CanvasScreenSchemaRulesOpts, type ValidateAgentManifestOutputOpts, type ValidateAgentManifestOutputResult, buildBuilderRulesFragment, buildCanvasScreenSchemaRules, buildCapabilitySurfaceFragment, buildDecisionSurfaceRules, buildFlowGenWorkflowRules, buildFlowManifestPatchRules, buildLayerExamplesFragment, buildLayerStylingRules, buildRheoAgentSchemaRules, buildRheoAgentSystemPrompt, buttonActionKinds, formatAgentManifestIssues, slimManifestForRheoAgentPrompt, validateAgentManifestOutput };