first recipe: extract textcontent from output

src/wf_mcp/broker/service/builtins.py

@@ -7,6 +7,7 @@ from wf_authoring import extract_field, filter_items, filter_items_present, firs
 from wf_authoring import first_item_maybe, first_item_or_none, is_empty, last_item
 from wf_authoring import last_item_or_none, length, node, pick_key, pick_path
 from wf_authoring import project_fields, rename_fields, runtime_error, truthy
+from wf_authoring import extract_text_content
 from wf_core.runtime.ops.merges import DEFAULT_REDUCER_DEFINITIONS
 
 from wf_platform import (
@@ -26,6 +27,9 @@ BUILTIN_CONNECTION_ID = "wf.std"
 MCP_SOURCE_ID = "wf.mcp"
 """Reserved source id for future workflow-safe MCP utility node specs."""
 
+RECIPE_SOURCE_ID = "wf.recipes"
+"""Internal source id for first-party composed workflow recipes."""
+
 
 AUTHORING_STD_SPECS: tuple[NodeSpec[Any, Any], ...] = (
     coalesce,
@@ -52,16 +56,36 @@ AUTHORING_STD_SPECS: tuple[NodeSpec[Any, Any], ...] = (
 """Existing authoring ops that are also exposed through the workflow stdlib."""
 
 
-def builtin_specs() -> dict[str, NodeSpec[Any, Any]]:
-    """Return built-in NodeSpecs available to raw broker workflow plans."""
-    specs = [
-        node(spec, name=spec.name.removeprefix("authoring."))
-        for spec in AUTHORING_STD_SPECS
+RECIPE_SPECS: tuple[NodeSpec[Any, Any], ...] = (extract_text_content,)
+"""Composed first-party recipes exposed as capabilities."""
+
+
+def _qualified_specs(
+    source_id: str,
+    specs: tuple[NodeSpec[Any, Any], ...],
+) -> dict[str, NodeSpec[Any, Any]]:
+    """Return specs with authoring names rewritten under one source id."""
+    local_specs = [
+        node(spec, name=spec.name.removeprefix("authoring.")) for spec in specs
     ]
-    qualified_specs = [qualify_spec(BUILTIN_CONNECTION_ID, spec) for spec in specs]
+    qualified_specs = [qualify_spec(source_id, spec) for spec in local_specs]
     return {spec.name: spec for spec in qualified_specs}
 
 
+def builtin_specs() -> dict[str, NodeSpec[Any, Any]]:
+    """Return primitive built-in NodeSpecs available to raw broker workflow plans."""
+    return _qualified_specs(BUILTIN_CONNECTION_ID, AUTHORING_STD_SPECS)
+
+
+def recipe_specs() -> dict[str, NodeSpec[Any, Any]]:
+    """Return composed first-party recipe specs.
+
+    Recipes are wrapper-node subgraphs today. They are useful workflow-facing
+    capabilities, but parent runs do not yet see their child graph frames.
+    """
+    return _qualified_specs(RECIPE_SOURCE_ID, RECIPE_SPECS)
+
+
 def builtin_reducers() -> dict[str, ReducerSpec]:
     """Return built-in reducers owned by the workflow standard library."""
     return {
@@ -94,4 +118,16 @@ def builtin_sources() -> dict[str, CapabilitySource]:
             permissions=SourcePermissions(safe_for_workflow=True),
             description="Workflow standard-library nodes.",
         ),
+        RECIPE_SOURCE_ID: CapabilitySource(
+            id=RECIPE_SOURCE_ID,
+            kind="system",
+            capabilities=CapabilityBuckets(node_specs=recipe_specs()),
+            visibility=SourceVisibility(
+                planner=True,
+                mcp_client=True,
+                admin_dashboard=True,
+            ),
+            permissions=SourcePermissions(safe_for_workflow=True),
+            description="First-party workflow recipes composed from standard nodes.",
+        ),
     }